whoami7 - Manager
:
/
proc
/
self
/
root
/
home
/
kckglobal
/
public_html
/
portal
/
vendor
/
phpstan
/
phpstan
/
Upload File:
files >> //proc/self/root/home/kckglobal/public_html/portal/vendor/phpstan/phpstan/phpstan.phar
#!/usr/bin/env php <?php Phar::mapPhar('phpstan.phar'); require 'phar://phpstan.phar/bin/phpstan'; __HALT_COMPILER(); ?> �� 1 src/Dependency/ExportedNode/ExportedClassNode.phpS ^�gS o� 0 src/Dependency/ExportedNode/ExportedEnumNode.php� ^�g� ��Vt� 5 src/Dependency/ExportedNode/ExportedInterfaceNode.php ^�g }�A� 9 src/Dependency/ExportedNode/ExportedClassConstantNode.phpU ^�gU �a�%� 5 src/Dependency/ExportedNode/ExportedParameterNode.php� ^�g� ��Ȥ 4 src/Dependency/ExportedNode/ExportedFunctionNode.php� ^�g� 6u�� 5 src/Dependency/ExportedNode/ExportedAttributeNode.php ^�g 0�7� 2 src/Dependency/ExportedNode/ExportedMethodNode.php� ^�g� B��� : src/Dependency/ExportedNode/ExportedClassConstantsNode.php� ^�g� ��)8� 1 src/Dependency/ExportedNode/ExportedTraitNode.php9 ^�g9 U)�פ : src/Dependency/ExportedNode/ExportedTraitUseAdaptation.phpF ^�gF �)� 4 src/Dependency/ExportedNode/ExportedEnumCaseNode.php� ^�g� ��� 6 src/Dependency/ExportedNode/ExportedPropertiesNode.php$ ^�g$ 2�l٤ 2 src/Dependency/ExportedNode/ExportedPhpDocNode.php) ^�g) ����� # src/Dependency/RootExportedNode.php� ^�g� ]65� % src/Dependency/DependencyResolver.phpM� ^�gM� w͖1� ' src/Dependency/ExportedNodeResolver.php. ^�g. b?c�� src/Dependency/ExportedNode.phpa ^�ga V�N� & src/Dependency/ExportedNodeFetcher.php� ^�g� �*^� & src/Dependency/ExportedNodeVisitor.php ^�g �Y� # src/Dependency/NodeDependencies.php� ^�g� ���W� src/autoloadFunctions.php� ^�g� �Ѥ src/Analyser/StatementResult.php� ^�g� .�:� ! src/Analyser/ExpressionResult.phpU ^�gU ���� + src/Analyser/DirectInternalScopeFactory.php� ^�g� [�1Ф " src/Analyser/NodeScopeResolver.phpz ^�gz u��� # src/Analyser/EndStatementResult.phpi ^�gi >��� ' src/Analyser/NullsafeOperatorHelper.php� ^�g� �� �� src/Analyser/FileAnalyser.php A ^�g A e~ j� src/Analyser/InternalError.phpx ^�gx �m&x� # src/Analyser/StatementExitPoint.phpq ^�gq �I�� , src/Analyser/ConditionalExpressionHolder.php� ^�g� �p7 � src/Analyser/ImpurePoint.php� ^�g� X'癤 src/Analyser/Error.php� ^�g� 4�� src/Analyser/SpecifiedTypes.php^ ^�g^ �Z=�� src/Analyser/OutOfClassScope.php� ^�g� �# � , src/Analyser/LocalIgnoresProcessorResult.php9 ^�g9 � n�� ! src/Analyser/StatementContext.php� ^�g� �_�8� / src/Analyser/ResultCache/ResultCacheClearer.phpK ^�gK ���u� 5 src/Analyser/ResultCache/ResultCacheProcessResult.phpw ^�gw �v�� / src/Analyser/ResultCache/ResultCacheManager.phpў ^�gў �Hu�� 6 src/Analyser/ResultCache/ResultCacheManagerFactory.php� ^�g� C��� ( src/Analyser/ResultCache/ResultCache.php� ^�g� egˤ src/Analyser/MutatingScope.php�\ ^�g�\ 8��� src/Analyser/FinalizerResult.phpL ^�gL ���K� # src/Analyser/FileAnalyserResult.php� ^�g� ��2�� ) src/Analyser/LazyInternalScopeFactory.php� ^�g� �9i� src/Analyser/TypeSpecifier.php~ ^�g~ #�ߤ % src/Analyser/RuleErrorTransformer.php! ^�g! �~��� % src/Analyser/ExpressionTypeHolder.php� ^�g� �*�-� % src/Analyser/TypeSpecifierFactory.php= ^�g= �yO�� src/Analyser/ScopeFactory.php ^�g C��� ! src/Analyser/ConstantResolver.php�+ ^�g�+ ��31� src/Analyser/Analyser.phpP ^�gP ����� % src/Analyser/InternalScopeFactory.php� ^�g� ϤƷ� & src/Analyser/LocalIgnoresProcessor.php� ^�g� DWY� % src/Analyser/ProcessClosureResult.php� ^�g� ��1� " src/Analyser/ExpressionContext.php� ^�g� n,�a� $ src/Analyser/ArgumentsNormalizer.php� ^�g� l � , src/Analyser/TypeSpecifierAwareExtension.php� ^�g� ���Q� ( src/Analyser/AnalyserResultFinalizer.php@% ^�g@% �ʨ�� src/Analyser/ScopeContext.php� ^�g� ���*� src/Analyser/ThrowPoint.php� ^�g� '#e�� src/Analyser/NameScope.phpc ^�gc ���� 6 src/Analyser/EnsuredNonNullabilityResultExpression.phpp ^�gp YC�Z� src/Analyser/Scope.php� ^�g� �]{� ( src/Analyser/ConstantResolverFactory.php? ^�g? ��)&� 9 src/Analyser/Ignore/IgnoredErrorHelperProcessedResult.php ^�g 4�8C� 0 src/Analyser/Ignore/IgnoredErrorHelperResult.php�( ^�g�( @q7� , src/Analyser/Ignore/IgnoreParseException.php� ^�g� ��툤 $ src/Analyser/Ignore/IgnoredError.php4 ^�g4 �-�"� * src/Analyser/Ignore/IgnoredErrorHelper.php ^�g �@�F� # src/Analyser/Ignore/IgnoreLexer.phpy ^�gy 0?=6� src/Analyser/AnalyserResult.php� ^�g� H�e�� , src/Analyser/EnsuredNonNullabilityResult.phpW ^�gW {=m� % src/Analyser/TypeSpecifierContext.php ^�g �EE� + src/Analyser/UndefinedVariableException.php; ^�g; ��!� ) src/Analyser/RicherScopeGetTypeHelper.php" ^�g" ����� " src/Diagnose/DiagnoseExtension.php� ^�g� ���פ ) src/Diagnose/PHPStanDiagnoseExtension.php� ^�g� ���� ? src/Rules/TooWideTypehints/TooWideClosureReturnTypehintRule.php� ^�g� i �Ф B src/Rules/TooWideTypehints/TooWideFunctionParameterOutTypeRule.php� ^�g� g���� 6 src/Rules/TooWideTypehints/TooWidePropertyTypeRule.php� ^�g� �;'� E src/Rules/TooWideTypehints/TooWideArrowFunctionReturnTypehintRule.php� ^�g� ] W� @ src/Rules/TooWideTypehints/TooWideFunctionReturnTypehintRule.php� ^�g� ��Ĕ� > src/Rules/TooWideTypehints/TooWideMethodReturnTypehintRule.phpM ^�gM ��hݤ ; src/Rules/TooWideTypehints/TooWideParameterOutTypeCheck.php? ^�g? o �|� @ src/Rules/TooWideTypehints/TooWideMethodParameterOutTypeRule.php� ^�g� ͉�� src/Rules/RuleLevelHelper.phpMB ^�gMB x�RG� src/Rules/TipRuleError.php� ^�g� ��|� . src/Rules/EnumCases/EnumCaseAttributesRule.php ^�g 8]�*� + src/Rules/UnusedFunctionParametersCheck.php� ^�g� ʐ�Ԥ 2 src/Rules/Traits/ConflictingTraitConstantsRule.php�# ^�g�# $Pפ * src/Rules/Traits/ConstantsInTraitsRule.php* ^�g* ��٤ . src/Rules/Traits/TraitDeclarationCollector.php[ ^�g[ ��놤 & src/Rules/Traits/TraitUseCollector.php� ^�g� ��8� ) src/Rules/Traits/NotAnalysedTraitRule.php� ^�g� x^�*� 1 src/Rules/Regexp/RegularExpressionPatternRule.php� ^�g� �$� 1 src/Rules/Regexp/RegularExpressionQuotingRule.php� ^�g� �]pĤ ' src/Rules/Missing/MissingReturnRule.phpp ^�gp ��6� # src/Rules/Api/ApiStaticCallRule.php� ^�g� ����� src/Rules/Api/ApiRuleHelper.phph ^�gh ��1J� ( src/Rules/Api/ApiClassImplementsRule.php+ ^�g+ ��Y�� ( src/Rules/Api/ApiClassConstFetchRule.phpf ^�gf �_2z� ' src/Rules/Api/ApiInstanceofTypeRule.php< ^�g< ����� & src/Rules/Api/ApiInstantiationRule.php� ^�g� �ױ� 5 src/Rules/Api/NodeConnectingVisitorAttributesRule.php� ^�g� `�b� & src/Rules/Api/BcUncoveredInterface.php� ^�g� �� ٤ ) src/Rules/Api/ApiInterfaceExtendsRule.php) ^�g) z�6ݤ # src/Rules/Api/ApiInstanceofRule.php[ ^�g[ �jlZ� 4 src/Rules/Api/RuntimeReflectionInstantiationRule.php: ^�g: Mh%� 7 src/Rules/Api/PhpStanNamespaceIn3rdPartyPackageRule.php� ^�g� ����� % src/Rules/Api/GetTemplateTypeRule.php� ^�g� ��� % src/Rules/Api/ApiClassExtendsRule.php� ^�g� �R� ! src/Rules/Api/ApiTraitUseRule.php� ^�g� �L� # src/Rules/Api/ApiMethodCallRule.php> ^�g> +`|�� / src/Rules/Api/RuntimeReflectionFunctionRule.php ^�g �U � & src/Rules/Debug/DumpPhpDocTypeRule.php* ^�g* zB� src/Rules/Debug/DumpTypeRule.php� ^�g� ��Ӥ " src/Rules/Debug/DebugScopeRule.phpH ^�gH �� �� " src/Rules/Debug/FileAssertRule.php� ^�g� ~��� src/Rules/Rule.php� ^�g� Y�ړ� " src/Rules/MissingTypehintCheck.php� ^�g� r�c�� ( src/Rules/Playground/MethodNeverRule.phpw ^�gw �]r� ( src/Rules/Playground/NeverRuleHelper.php� ^�g� @��.� - src/Rules/Playground/NotAnalysedTraitRule.php� ^�g� �Zʆ� & src/Rules/Playground/NoPhpCodeRule.phpV ^�gV :E Ԥ * src/Rules/Playground/FunctionNeverRule.phpU ^�gU ��{٤ src/Rules/ClassNameNodePair.php ^�g �$hͤ - src/Rules/Generators/YieldInGeneratorRule.php" ^�g" }! �� & src/Rules/Generators/YieldTypeRule.phpU ^�gU �b� * src/Rules/Generators/YieldFromTypeRule.php" ^�g" �Q�Ҥ ' src/Rules/DateTimeInstantiationRule.php/ ^�g/ �+^� src/Rules/ClassNameCheck.php� ^�g� ��cH� / src/Rules/Namespaces/ExistingNamesInUseRule.phph ^�gh I��� 4 src/Rules/Namespaces/ExistingNamesInGroupUseRule.php� ^�g� 6�� $ src/Rules/Generics/VarianceCheck.php, ^�g, %��6� - src/Rules/Generics/MethodTemplateTypeRule.php) ^�g) �<;� , src/Rules/Generics/ClassTemplateTypeRule.php� ^�g� �訤 + src/Rules/Generics/EnumTemplateTypeRule.php ^�g ���� - src/Rules/Generics/InterfaceAncestorsRule.php� ^�g� =ps�� , src/Rules/Generics/GenericAncestorsCheck.phpB ^�gB o?�� 0 src/Rules/Generics/MethodTagTemplateTypeRule.phpt ^�gt ӛ:� 1 src/Rules/Generics/CrossCheckInterfacesHelper.php ^�g ��Ԥ 0 src/Rules/Generics/InterfaceTemplateTypeRule.php� ^�g� a1�� ) src/Rules/Generics/ClassAncestorsRule.php� ^�g� xM7I� 1 src/Rules/Generics/MethodTagTemplateTypeCheck.php� ^�g� ��� / src/Rules/Generics/FunctionTemplateTypeRule.php� ^�g� faI,� % src/Rules/Generics/UsedTraitsRule.php� ^�g� [�� � 4 src/Rules/Generics/FunctionSignatureVarianceRule.php� ^�g� jr2� ( src/Rules/Generics/EnumAncestorsRule.phpn ^�gn �ۻ� ( src/Rules/Generics/TemplateTypeCheck.php�& ^�g�& �K�=� 5 src/Rules/Generics/MethodTagTemplateTypeTraitRule.php+ ^�g+ +�\�� - src/Rules/Generics/GenericObjectTypeCheck.php ^�g �-~ˤ , src/Rules/Generics/TraitTemplateTypeRule.phpZ ^�gZ �3� 2 src/Rules/Generics/MethodSignatureVarianceRule.php ^�g � + src/Rules/Generics/PropertyVarianceRule.php� ^�g� �?�� ) src/Rules/FunctionCallParametersCheck.php�d ^�g�d �e�� * src/Rules/RuleLevelHelperAcceptsResult.php� ^�g� z�J � src/Rules/DeadCode/NoopRule.php� ^�g� �� 9 src/Rules/DeadCode/MethodWithoutImpurePointsCollector.php� ^�g� ����� E src/Rules/DeadCode/CallToFunctionStatementWithoutImpurePointsRule.php� ^�g� |�� H src/Rules/DeadCode/CallToConstructorStatementWithoutImpurePointsRule.php� ^�g� �B�� 0 src/Rules/DeadCode/UnusedPrivateConstantRule.phpT ^�gT �8K� 4 src/Rules/DeadCode/PossiblyPureFuncCallCollector.php� ^�g� +fY� 6 src/Rules/DeadCode/PossiblyPureMethodCallCollector.php� ^�g� ˒ �� / src/Rules/DeadCode/UnreachableStatementRule.php� ^�g� !� 6 src/Rules/DeadCode/PossiblyPureStaticCallCollector.php� ^�g� �j�� 0 src/Rules/DeadCode/UnusedPrivatePropertyRule.phpC! ^�gC! 5��0� C src/Rules/DeadCode/CallToMethodStatementWithoutImpurePointsRule.phph ^�gh �ʩ� I src/Rules/DeadCode/CallToStaticMethodStatementWithoutImpurePointsRule.php� ^�g� �u�� % src/Rules/DeadCode/BetterNoopRule.phpK ^�gK ���\� . src/Rules/DeadCode/UnusedPrivateMethodRule.php� ^�g� 2�� > src/Rules/DeadCode/ConstructorWithoutImpurePointsCollector.php ^�g �e��� / src/Rules/DeadCode/PossiblyPureNewCollector.php3 ^�g3 ��٤ ; src/Rules/DeadCode/FunctionWithoutImpurePointsCollector.php ^�g i�� ! src/Rules/IdentifierRuleError.php� ^�g� MT3� 5 src/Rules/Methods/MethodVisibilityInInterfaceRule.php? ^�g? ���� + src/Rules/Methods/StaticMethodCallCheck.php�' ^�g�' _�P� ; src/Rules/Methods/LazyAlwaysUsedMethodExtensionProvider.php� ^�g� ���ܤ 4 src/Rules/Methods/ExistingClassesInTypehintsRule.php� ^�g� j 3 � % src/Rules/Methods/CallMethodsRule.php ^�g �Wb�� 7 src/Rules/Methods/AlwaysUsedMethodExtensionProvider.php) ^�g) ���E� 6 src/Rules/Methods/IllegalConstructorMethodCallRule.php� ^�g� �x<� , src/Rules/Methods/FinalPrivateMethodRule.php ^�g �'ߙ� + src/Rules/Methods/CallStaticMethodsRule.php� ^�g� ��ӆ� 6 src/Rules/Methods/IllegalConstructorStaticCallRule.php� ^�g� %g�� * src/Rules/Methods/OverridingMethodRule.php�? ^�g�? 瑎^� ) src/Rules/Methods/MethodSignatureRule.php. ^�g. ��)[� : src/Rules/Methods/AbstractMethodInNonAbstractClassRule.phpS ^�gS �� 5 src/Rules/Methods/MethodParameterComparisonHelper.php�8 ^�g�8 ��?� 2 src/Rules/Methods/MissingMethodSelfOutTypeRule.phpM ^�gM p~� : src/Rules/Methods/IncompatibleDefaultParameterTypeRule.php ^�g ��� : src/Rules/Methods/MissingMagicSerializationMethodsRule.php ^�g )�� * src/Rules/Methods/MethodAttributesRule.php ^�g � U9� G src/Rules/Methods/CallToStaticMethodStatementWithoutSideEffectsRule.phpI ^�gI �� � ( src/Rules/Methods/MethodCallableRule.php ^�g ^�oN� 8 src/Rules/Methods/CallPrivateMethodThroughStaticRule.php� ^�g� 1y �� / src/Rules/Methods/AbstractPrivateMethodRule.php� ^�g� ~)��� . src/Rules/Methods/StaticMethodCallableRule.php< ^�g< ��n� 5 src/Rules/Methods/MissingMethodImplementationRule.php� ^�g� }�Ť , src/Rules/Methods/NullsafeMethodCallRule.phpp ^�gp �u(Ť / src/Rules/Methods/ConsistentConstructorRule.php6 ^�g6 �>�Ф / src/Rules/Methods/ConstructorReturnTypeRule.php� ^�g� :m��� 8 src/Rules/Methods/MissingMethodParameterTypehintRule.php� ^�g� �@�b� % src/Rules/Methods/MethodCallCheck.php� ^�g� � �� 5 src/Rules/Methods/MissingMethodReturnTypehintRule.php ^�g g7�� F src/Rules/Methods/CallToConstructorStatementWithoutSideEffectsRule.php� ^�g� цꑤ = src/Rules/Methods/DirectAlwaysUsedMethodExtensionProvider.php ^�g �A�� A src/Rules/Methods/CallToMethodStatementWithoutSideEffectsRule.php� ^�g� >[Ф / src/Rules/Methods/AlwaysUsedMethodExtension.phpK ^�gK �G�e� $ src/Rules/Methods/ReturnTypeRule.php� ^�g� �Dۊ� + src/Rules/Types/InvalidTypesInUnionRule.phpL ^�gL K��0� src/Rules/FoundTypeResult.php� ^�g� h[g� * src/Rules/Arrays/AllowedArrayKeysTypes.php{ ^�g{ ~�mB� $ src/Rules/Arrays/DeadForeachRule.php ^�g A�Ȥ . src/Rules/Arrays/UnpackIterableInArrayRule.php� ^�g� r���� - src/Rules/Arrays/OffsetAccessAssignOpRule.php� ^�g� ,7(� / src/Rules/Arrays/OffsetAccessAssignmentRule.php� ^�g� :� �� 4 src/Rules/Arrays/OffsetAccessValueAssignmentRule.php ^�g U�V� . src/Rules/Arrays/InvalidKeyInArrayItemRule.php� ^�g� >Zf�� ' src/Rules/Arrays/ArrayUnpackingRule.phpg ^�gg ��⩤ ' src/Rules/Arrays/EmptyArrayItemRule.php: ^�g: �Yr:� + src/Rules/Arrays/ArrayDestructuringRule.phpZ ^�gZ �1s� 2 src/Rules/Arrays/InvalidKeyInArrayDimFetchRule.php ^�g M� * src/Rules/Arrays/IterableInForeachRule.phpB ^�gB pz��� . src/Rules/Arrays/AppendedArrayItemTypeRule.php� ^�g� �ģ�� : src/Rules/Arrays/NonexistentOffsetInArrayDimFetchCheck.php ^�g y��� 5 src/Rules/Arrays/DuplicateKeysInLiteralArraysRule.phpi ^�gi �P�� 9 src/Rules/Arrays/OffsetAccessWithoutDimForReadingRule.php� ^�g� �?� 9 src/Rules/Arrays/NonexistentOffsetInArrayDimFetchRule.php� ^�g� r}{o� - src/Rules/Arrays/AppendedArrayKeyTypeRule.php� ^�g� ��e� ' src/Rules/PhpDoc/FunctionAssertRule.php� ^�g� �U ֤ D src/Rules/PhpDoc/IncompatibleParamImmediatelyInvokedCallableRule.php� ^�g� �U� 1 src/Rules/PhpDoc/InvalidThrowsPhpDocValueRule.php� ^�g� �#�� / src/Rules/PhpDoc/IncompatiblePhpDocTypeRule.phpc. ^�gc. )A�3� 4 src/Rules/PhpDoc/MethodConditionalReturnTypeRule.php� ^�g� !̷ܤ 0 src/Rules/PhpDoc/IncompatibleSelfOutTypeRule.phpd ^�gd ��O� 4 src/Rules/PhpDoc/ConditionalReturnTypeRuleHelper.php� ^�g� yƐ� 9 src/Rules/PhpDoc/RequireImplementsDefinitionTraitRule.php� ^�g� q��f� 9 src/Rules/PhpDoc/RequireImplementsDefinitionClassRule.php� ^�g� �[�� 6 src/Rules/PhpDoc/RequireExtendsDefinitionTraitRule.php ^�g FC�=� . src/Rules/PhpDoc/InvalidPhpDocTagValueRule.php ^�g �A� - src/Rules/PhpDoc/InvalidPHPStanDocTagRule.php� ^�g� �aB� . src/Rules/PhpDoc/GenericCallableRuleHelper.php� ^�g� �� % src/Rules/PhpDoc/AssertRuleHelper.php�% ^�g�% v�Z� 2 src/Rules/PhpDoc/WrongVariableNameInVarTagRule.php�6 ^�g�6 l�a� + src/Rules/PhpDoc/UnresolvableTypeHelper.phpE ^�gE � �u� % src/Rules/PhpDoc/MethodAssertRule.php� ^�g� �χ� ( src/Rules/PhpDoc/RequireExtendsCheck.phpD ^�gD �5� ) src/Rules/PhpDoc/VarTagTypeRuleHelper.php/# ^�g/# �= � < src/Rules/PhpDoc/IncompatibleClassConstantPhpDocTypeRule.php ^�g j逘� 0 src/Rules/PhpDoc/InvalidPhpDocVarTagTypeRule.php ^�g Q�գ� % src/Rules/PhpDoc/PhpDocLineHelper.php: ^�g: 6�}� 7 src/Rules/PhpDoc/IncompatiblePropertyPhpDocTypeRule.php ^�g ��ޤ 6 src/Rules/PhpDoc/FunctionConditionalReturnTypeRule.php� ^�g� ���F� 6 src/Rules/PhpDoc/RequireExtendsDefinitionClassRule.php0 ^�g0 �B�F� 4 src/Rules/PhpDoc/VarTagChangedExpressionTypeRule.phph ^�gh �ˊ� src/Rules/Registry.php' ^�g' ��� " src/Rules/Cast/InvalidCastRule.php� ^�g� (��y� 2 src/Rules/Cast/InvalidPartOfEncapsedStringRule.php� ^�g� �<�� src/Rules/Cast/EchoRule.php� ^�g� ��v� src/Rules/Cast/PrintRule.phpY ^�gY Qf�¤ src/Rules/Cast/UnsetCastRule.php ^�g �|Ҥ src/Rules/NullsafeCheck.php� ^�g� �ì�� ! src/Rules/Names/UsedNamesRule.php� ^�g� v�� src/Rules/LineRuleError.php� ^�g� �[%7� src/Rules/AttributesCheck.phpl ^�gl ��F[� ' src/Rules/ClassCaseSensitivityCheck.php� ^�g� �P�� src/Rules/MetadataRuleError.php� ^�g� ��h� 6 src/Rules/Operators/InvalidComparisonOperationRule.php ^�g �� 2 src/Rules/Operators/InvalidIncDecOperationRule.php� ^�g� n)iĤ 1 src/Rules/Operators/InvalidUnaryOperationRule.php� ^�g� ��U`� 2 src/Rules/Operators/InvalidBinaryOperationRule.php# ^�g# '8�P� , src/Rules/Operators/InvalidAssignVarRule.php ^�g ��[�� % src/Rules/FunctionDefinitionCheck.php�f ^�g�f ��UҤ % src/Rules/FunctionReturnTypeCheck.phpP ^�gP Ȯ��� src/Rules/RuleErrorBuilder.php� ^�g� ��/� = src/Rules/Comparison/TernaryOperatorConstantConditionRule.php� ^�g� 2< � 9 src/Rules/Comparison/WhileLoopAlwaysTrueConditionRule.php� ^�g� x�8c� 4 src/Rules/Comparison/ConstantLooseComparisonRule.php� ^�g� Du Ӥ @ src/Rules/Comparison/ImpossibleCheckTypeStaticMethodCallRule.php� ^�g� S��� 7 src/Rules/Comparison/BooleanOrConstantConditionRule.php� ^�g� k�b� 0 src/Rules/Comparison/IfConstantConditionRule.php� ^�g� �E�W� = src/Rules/Comparison/StrictComparisonOfDifferentTypesRule.php= ^�g= ;��&� 2 src/Rules/Comparison/UnreachableIfBranchesRule.php ^�g cI�K� 7 src/Rules/Comparison/UsageOfVoidMatchExpressionRule.php" ^�g" ���� , src/Rules/Comparison/MatchExpressionRule.php> ^�g> �Y(@� 8 src/Rules/Comparison/LogicalXorConstantConditionRule.php ^�g ��I� : src/Rules/Comparison/ImpossibleCheckTypeMethodCallRule.php� ^�g� {��� G src/Rules/Comparison/NumberComparisonOperatorsConstantConditionRule.phpp ^�gp ,� � 8 src/Rules/Comparison/BooleanNotConstantConditionRule.php� ^�g� ��Y]� : src/Rules/Comparison/WhileLoopAlwaysFalseConditionRule.php2 ^�g2 �P4�� 9 src/Rules/Comparison/DoWhileLoopConstantConditionRule.php� ^�g� E�b� 9 src/Rules/Comparison/UnreachableTernaryElseBranchRule.php� ^�g� �^� 2 src/Rules/Comparison/ImpossibleCheckTypeHelper.php"F ^�g"F E�xǤ 4 src/Rules/Comparison/ElseIfConstantConditionRule.php� ^�g� ��� 4 src/Rules/Comparison/ConstantConditionRuleHelper.php� ^�g� k��� 8 src/Rules/Comparison/BooleanAndConstantConditionRule.php� ^�g� ��� < src/Rules/Comparison/ImpossibleCheckTypeFunctionCallRule.php� ^�g� 8|�Ф src/Rules/IssetCheck.php/ ^�g/ �c쑤 src/Rules/RuleError.php� ^�g� t@�Ф src/Rules/DirectRegistry.php% ^�g% ��u� % src/Rules/ClassForbiddenNameCheck.php� ^�g� �=s� = src/Rules/Functions/ExistingClassesInClosureTypehintsRule.php\ ^�g\ �(�l� 6 src/Rules/Functions/ExistingClassesInTypehintsRule.php� ^�g� ���Τ 5 src/Rules/Functions/CallToNonExistentFunctionRule.php' ^�g' ���.� 8 src/Rules/Functions/DuplicateFunctionDeclarationRule.php� ^�g� 7ҭ� . src/Rules/Functions/FunctionAttributesRule.php ^�g ��� 3 src/Rules/Functions/ArrowFunctionReturnTypeRule.php� ^�g� \�M� + src/Rules/Functions/ParamAttributesRule.php� ^�g� g�$Ϥ C src/Rules/Functions/IncompatibleClosureDefaultParameterTypeRule.php� ^�g� W�)�� < src/Rules/Functions/MissingFunctionParameterTypehintRule.php� ^�g� �{�� ? src/Rules/Functions/InvalidLexicalVariablesInClosureUseRule.php� ^�g� d�u�� C src/Rules/Functions/ExistingClassesInArrowFunctionTypehintsRule.php� ^�g� �U�$� ) src/Rules/Functions/CallCallablesRule.phpP ^�gP ��� / src/Rules/Functions/ReturnNullsafeByRefRule.phpZ ^�gZ �ן�� $ src/Rules/Functions/PrintfHelper.php@ ^�g@ ���� - src/Rules/Functions/UnusedClosureUsesRule.php� ^�g� ���M� , src/Rules/Functions/PrintfParametersRule.phps ^�gs �G� - src/Rules/Functions/ClosureReturnTypeRule.php@ ^�g@ f��n� < src/Rules/Functions/IncompatibleDefaultParameterTypeRule.php� ^�g� �ƈ�� 1 src/Rules/Functions/PrintfArrayParametersRule.php� ^�g� ۤ 4 src/Rules/Functions/CallToFunctionParametersRule.php� ^�g� -�l� E src/Rules/Functions/CallToFunctionStatementWithoutSideEffectsRule.phpH ^�gH �'�>� < src/Rules/Functions/ImplodeParameterCastableToStringRule.php� ^�g� ����� I src/Rules/Functions/IncompatibleArrowFunctionDefaultParameterTypeRule.php� ^�g� �D�� ) src/Rules/Functions/InnerFunctionRule.phpe ^�ge E��l� ( src/Rules/Functions/CallUserFuncRule.php� ^�g� �K� , src/Rules/Functions/DefineParametersRule.php� ^�g� x�� � + src/Rules/Functions/ImplodeFunctionRule.php ^�g C�R�� 5 src/Rules/Functions/ParameterCastableToStringRule.php� ^�g� ��鸤 , src/Rules/Functions/FunctionCallableRule.php� ^�g� � �֤ < src/Rules/Functions/ArrowFunctionReturnNullsafeByRefRule.php� ^�g� 6 � � / src/Rules/Functions/RandomIntParametersRule.php� ^�g� ����� 9 src/Rules/Functions/MissingFunctionReturnTypehintRule.php ^�g �8�:� 6 src/Rules/Functions/UselessFunctionReturnValueRule.php� ^�g� h�5� 9 src/Rules/Functions/SortParameterCastableToStringRule.php ^�g 2%l{� / src/Rules/Functions/RedefinedParametersRule.php� ^�g� 4�� ' src/Rules/Functions/ArrayValuesRule.phpT ^�gT ��.� ' src/Rules/Functions/ArrayFilterRule.php� ^�g� ;.�Ӥ 9 src/Rules/Functions/VariadicParametersDeclarationRule.php2 ^�g2 �k�� - src/Rules/Functions/ClosureAttributesRule.php ^�g 7f�9� 3 src/Rules/Functions/ArrowFunctionAttributesRule.php ^�g m�0� & src/Rules/Functions/ReturnTypeRule.php( ^�g( t$7Ϥ 1 src/Rules/Properties/PropertyReflectionFinder.php� ^�g� ��� 7 src/Rules/Properties/ReadingWriteOnlyPropertiesRule.php� ^�g� ��@�� 4 src/Rules/Properties/MissingPropertyTypehintRule.phpB ^�gB �H�� 0 src/Rules/Properties/FoundPropertyReflection.php0 ^�g0 _HĤ B src/Rules/Properties/DefaultValueTypesAssignedToPropertiesRule.php) ^�g) ��[�� B src/Rules/Properties/MissingReadOnlyByPhpDocPropertyAssignRule.php� ^�g� �ź� ; src/Rules/Properties/ReadOnlyByPhpDocPropertyAssignRule.php� ^�g� �z�� 3 src/Rules/Properties/ReadOnlyPropertyAssignRule.php� ^�g� �S� > src/Rules/Properties/ReadOnlyByPhpDocPropertyAssignRefRule.phpx ^�gx �1�� ? src/Rules/Properties/AccessPrivatePropertyThroughStaticRule.php= ^�g= ��uɤ 2 src/Rules/Properties/NullsafePropertyFetchRule.php ^�g �:̑� 5 src/Rules/Properties/ReadWritePropertiesExtension.php� ^�g� ���� / src/Rules/Properties/OverridingPropertyRule.php� ^�g� �" ؤ 8 src/Rules/Properties/WritingToReadOnlyPropertiesRule.php� ^�g� �8Ġ� 5 src/Rules/Properties/ReadOnlyByPhpDocPropertyRule.php� ^�g� �۫G� C src/Rules/Properties/DirectReadWritePropertiesExtensionProvider.phph ^�gh � e*� 5 src/Rules/Properties/AccessPropertiesInAssignRule.php� ^�g� )��� / src/Rules/Properties/PropertyAttributesRule.php ^�g r��7� : src/Rules/Properties/MissingReadOnlyPropertyAssignRule.phpO ^�gO m��y� 3 src/Rules/Properties/AccessStaticPropertiesRule.phpE" ^�gE" 1u�� 8 src/Rules/Properties/ExistingClassesInPropertiesRule.php� ^�g� �yt�� = src/Rules/Properties/ReadWritePropertiesExtensionProvider.php. ^�g. _���� 2 src/Rules/Properties/PropertiesInInterfaceRule.php� ^�g� �Z鎤 - src/Rules/Properties/ReadOnlyPropertyRule.php� ^�g� �8��� + src/Rules/Properties/PropertyDescriptor.php� ^�g� �OVQ� 6 src/Rules/Properties/ReadOnlyPropertyAssignRefRule.php< ^�g< ���� - src/Rules/Properties/AccessPropertiesRule.php6 ^�g6 ���٤ 8 src/Rules/Properties/InvalidCallablePropertyTypeRule.php� ^�g� ��h� 6 src/Rules/Properties/TypesAssignedToPropertiesRule.php ^�g � >>� 2 src/Rules/Properties/UninitializedPropertyRule.php� ^�g� :UpФ A src/Rules/Properties/LazyReadWritePropertiesExtensionProvider.php ^�g �Á� ; src/Rules/Properties/AccessStaticPropertiesInAssignRule.php ^�g �.ڤ $ src/Rules/RuleErrors/RuleError41.php� ^�g� y{z�� $ src/Rules/RuleErrors/RuleError87.php{ ^�g{ �oY� $ src/Rules/RuleErrors/RuleError45.phpM ^�gM ��;�� $ src/Rules/RuleErrors/RuleError85.php� ^�g� �@9� $ src/Rules/RuleErrors/RuleError53.phpp ^�gp J�*� $ src/Rules/RuleErrors/RuleError55.php ^�g �t�i� % src/Rules/RuleErrors/RuleError115.php ^�g �� |� $ src/Rules/RuleErrors/RuleError15.php ^�g �� �� $ src/Rules/RuleErrors/RuleError21.php� ^�g� R#x�� % src/Rules/RuleErrors/RuleError107.php� ^�g� U)��� $ src/Rules/RuleErrors/RuleError29.php< ^�g< F��� $ src/Rules/RuleErrors/RuleError91.php� ^�g� � �*� $ src/Rules/RuleErrors/RuleError69.php� ^�g� R%�� $ src/Rules/RuleErrors/RuleError19.php� ^�g� .~�U� $ src/Rules/RuleErrors/RuleError83.php" ^�g" ��S� $ src/Rules/RuleErrors/RuleError57.php� ^�g� c�� � $ src/Rules/RuleErrors/RuleError73.phpQ ^�gQ U�q<� # src/Rules/RuleErrors/RuleError9.php ^�g q&�� $ src/Rules/RuleErrors/RuleError75.php� ^�g� 䎀� $ src/Rules/RuleErrors/RuleError61.php ^�g ��yY� $ src/Rules/RuleErrors/RuleError17.php4 ^�g4 ȹ� $ src/Rules/RuleErrors/RuleError51.php� ^�g� �0�� % src/Rules/RuleErrors/RuleError123.php� ^�g� ��� $ src/Rules/RuleErrors/RuleError99.php3 ^�g3 ?��� % src/Rules/RuleErrors/RuleError111.php< ^�g< g0!:� $ src/Rules/RuleErrors/RuleError77.php� ^�g� �FTФ $ src/Rules/RuleErrors/RuleError35.php� ^�g� h��"� % src/Rules/RuleErrors/RuleError109.php� ^�g� ��6:� $ src/Rules/RuleErrors/RuleError23.php; ^�g; �[D�� $ src/Rules/RuleErrors/RuleError43.php� ^�g� ��W� $ src/Rules/RuleErrors/RuleError93.php| ^�g| �J � $ src/Rules/RuleErrors/RuleError39.phpL ^�gL �� �� % src/Rules/RuleErrors/RuleError121.php ^�g 2� ܤ % src/Rules/RuleErrors/RuleError127.php ^�g �V`L� $ src/Rules/RuleErrors/RuleError47.php� ^�g� ��1� % src/Rules/RuleErrors/RuleError119.php_ ^�g_ y��� % src/Rules/RuleErrors/RuleError105.php5 ^�g5 �b0�� $ src/Rules/RuleErrors/RuleError25.php� ^�g� -�$Ť $ src/Rules/RuleErrors/RuleError49.php ^�g +ݫ`� $ src/Rules/RuleErrors/RuleError37.php� ^�g� �b �� $ src/Rules/RuleErrors/RuleError33.phpE ^�gE � �M� % src/Rules/RuleErrors/RuleError125.php` ^�g` ��+�� # src/Rules/RuleErrors/RuleError1.phpa ^�ga �i�~� $ src/Rules/RuleErrors/RuleError89.php# ^�g# �l�-� # src/Rules/RuleErrors/RuleError7.phph ^�gh <O.ɤ $ src/Rules/RuleErrors/RuleError63.php� ^�g� iL �� % src/Rules/RuleErrors/RuleError113.phpX ^�gX kOȜ� $ src/Rules/RuleErrors/RuleError59.phpt ^�gt �� $ src/Rules/RuleErrors/RuleError67.phpP ^�gP �Զߤ % src/Rules/RuleErrors/RuleError117.php� ^�g� �d>� # src/Rules/RuleErrors/RuleError3.php ^�g ��``� $ src/Rules/RuleErrors/RuleError79.phpX ^�gX Y *�� $ src/Rules/RuleErrors/RuleError65.php� ^�g� ��<� $ src/Rules/RuleErrors/RuleError95.php* ^�g* �&�J� $ src/Rules/RuleErrors/RuleError81.phpt ^�gt ȃ�e� % src/Rules/RuleErrors/RuleError101.php� ^�g� �ޮx� % src/Rules/RuleErrors/RuleError103.php� ^�g� ���� $ src/Rules/RuleErrors/RuleError11.php� ^�g� �3�J� # src/Rules/RuleErrors/RuleError5.php� ^�g� k��*� $ src/Rules/RuleErrors/RuleError31.php� ^�g� ��ȵ� $ src/Rules/RuleErrors/RuleError27.php� ^�g� �G:� $ src/Rules/RuleErrors/RuleError97.php� ^�g� �B� $ src/Rules/RuleErrors/RuleError13.phpj ^�gj ���Ť $ src/Rules/RuleErrors/RuleError71.php� ^�g� Ⳡ�� + src/Rules/Whitespace/FileWhitespaceRule.php_ ^�g_ Cô� 9 src/Rules/Constants/AlwaysUsedClassConstantsExtension.php� ^�g� ޡr� 8 src/Rules/Constants/ValueAssignedToClassConstantRule.php� ^�g� ��Y� $ src/Rules/Constants/ConstantRule.php� ^�g� o^ک� 0 src/Rules/Constants/MagicConstantContextRule.phpv ^�gv ɺ�� . src/Rules/Constants/OverridingConstantRule.php ^�g Z�k� 4 src/Rules/Constants/NativeTypedClassConstantRule.php ^�g x�L� E src/Rules/Constants/LazyAlwaysUsedClassConstantsExtensionProvider.php! ^�g! �j�� ) src/Rules/Constants/FinalConstantRule.php� ^�g� a2��� A src/Rules/Constants/AlwaysUsedClassConstantsExtensionProvider.phpE ^�gE R��?� 5 src/Rules/Constants/DynamicClassConstantFetchRule.php� ^�g� 0�a�� 8 src/Rules/Constants/MissingClassConstantTypehintRule.phpE ^�gE ��ݤ 0 src/Rules/Constants/ClassAsClassConstantRule.php} ^�g} ���� src/Rules/LazyRegistry.php ^�g oϒ� ) src/Rules/Ignore/IgnoreParseErrorRule.phpB ^�gB b�-� - src/Rules/Keywords/DeclareStrictTypesRule.php� ^�g� �[�B� , src/Rules/Keywords/RequireFileExistsRule.php ^�g �(�� . src/Rules/Keywords/ContinueBreakInLoopRule.php� ^�g� �0�r� # src/Rules/NonIgnorableRuleError.php� ^�g� 6�y̤ : src/Rules/Exceptions/OverwrittenExitPointByFinallyRule.php$ ^�g$ ��9}� * src/Rules/Exceptions/ThrowExprTypeRule.phpV ^�gV M(K� 5 src/Rules/Exceptions/DefaultExceptionTypeResolver.php� ^�g� u��_� C src/Rules/Exceptions/ThrowsVoidMethodWithExplicitThrowPointRule.php� ^�g� /�zh� 3 src/Rules/Exceptions/TooWideMethodThrowTypeRule.php� ^�g� �_~� D src/Rules/Exceptions/MissingCheckedExceptionInFunctionThrowsRule.php} ^�g} � 煤 5 src/Rules/Exceptions/CaughtExceptionExistenceRule.php ^�g ~�w)� = src/Rules/Exceptions/MissingCheckedExceptionInThrowsCheck.php� ^�g� �~��� . src/Rules/Exceptions/ExceptionTypeResolver.php� ^�g� �s�� E src/Rules/Exceptions/ThrowsVoidFunctionWithExplicitThrowPointRule.php� ^�g� ӗ�� . src/Rules/Exceptions/NoncapturingCatchRule.php ^�g $��� , src/Rules/Exceptions/ThrowExpressionRule.php� ^�g� �]�� 7 src/Rules/Exceptions/CatchWithUnthrownExceptionRule.phpT ^�gT �X�� . src/Rules/Exceptions/TooWideThrowTypeCheck.php� ^�g� � VѤ B src/Rules/Exceptions/MissingCheckedExceptionInMethodThrowsRule.php� ^�g� g� � 5 src/Rules/Exceptions/TooWideFunctionThrowTypeRule.phpZ ^�gZ Sڱ�� ( src/Rules/Variables/NullCoalesceRule.php� ^�g� 1�T[� ! src/Rules/Variables/EmptyRule.phpU ^�gU ��eR� + src/Rules/Variables/DefinedVariableRule.php� ^�g� ��^ɤ % src/Rules/Variables/ThrowTypeRule.phpQ ^�gQ ���O� ! src/Rules/Variables/UnsetRule.php� ^�g� S�Y5� ! src/Rules/Variables/IssetRule.php� ^�g� �� 4 src/Rules/Variables/ParameterOutAssignedTypeRule.php� ^�g� �@�� , src/Rules/Variables/CompactVariablesRule.php� ^�g� ���A� 8 src/Rules/Variables/ParameterOutExecutionEndTypeRule.php� ^�g� jt�� + src/Rules/Variables/VariableCloningRule.php� ^�g� ��-� ! src/Rules/Pure/PureMethodRule.php ^�g ۅ�� # src/Rules/Pure/PureFunctionRule.php� ^�g� �=� � & src/Rules/Pure/FunctionPurityCheck.php� ^�g� ��� � src/Rules/FileRuleError.php� ^�g� !�v� , src/Rules/ParameterCastableToStringCheck.phpj ^�gj � L� # src/Rules/Classes/MethodTagRule.php� ^�g� �F��� + src/Rules/Classes/RequireImplementsRule.php� ^�g� ���ʤ ( src/Rules/Classes/RequireExtendsRule.php� ^�g� ә�i� 9 src/Rules/Classes/ExistingClassesInEnumImplementsRule.php� ^�g� aV� * src/Rules/Classes/LocalTypeAliasesRule.php� ^�g� U�G}� $ src/Rules/Classes/MethodTagCheck.phpH/ ^�gH/ }��9� ) src/Rules/Classes/AllowedSubTypesRule.php ^�g 7�D� 3 src/Rules/Classes/ExistingClassInInstanceOfRule.php� ^�g� @�.�� ; src/Rules/Classes/ExistingClassesInInterfaceExtendsRule.php ^�g '2�1� / src/Rules/Classes/InstantiationCallableRule.php� ^�g� ݦ�� < src/Rules/Classes/AccessPrivateConstantThroughStaticRule.php� ^�g� ⌵� . src/Rules/Classes/DuplicateDeclarationRule.php� ^�g� / �� - src/Rules/Classes/TraitAttributeClassRule.phpP ^�gP �E\w� 1 src/Rules/Classes/ExistingClassInTraitUseRule.php� ^�g� BկԤ src/Rules/Classes/MixinCheck.php� ^�g� ��߫� ' src/Rules/Classes/ClassConstantRule.php� ^�g� ��`ä . src/Rules/Classes/ImpossibleInstanceOfRule.php� ^�g� wO� ' src/Rules/Classes/MixinTraitUseRule.php� ^�g� �~�� / src/Rules/Classes/LocalTypeTraitAliasesRule.php� ^�g� �{ج� % src/Rules/Classes/PropertyTagRule.php� ^�g� �?� + src/Rules/Classes/LocalTypeAliasesCheck.php6; ^�g6; (��u� ) src/Rules/Classes/ClassAttributesRule.phpR ^�gR �c�x� 1 src/Rules/Classes/ClassConstantAttributesRule.php$ ^�g$ � �p� & src/Rules/Classes/PropertyTagCheck.php\' ^�g\' �9� # src/Rules/Classes/NewStaticRule.php� ^�g� O��� 5 src/Rules/Classes/ExistingClassInClassExtendsRule.php+ ^�g+ "Pw-� 3 src/Rules/Classes/DuplicateClassDeclarationRule.php ^�g 1=L�� ' src/Rules/Classes/InstantiationRule.php $ ^�g $ �f�X� + src/Rules/Classes/MethodTagTraitUseRule.php� ^�g� )D� src/Rules/Classes/MixinRule.php� ^�g� c��� $ src/Rules/Classes/EnumSanityRule.php^ ^�g^ ��8� 3 src/Rules/Classes/InvalidPromotedPropertiesRule.php ^�g cؕ�� * src/Rules/Classes/PropertyTagTraitRule.php� ^�g� ���� $ src/Rules/Classes/MixinTraitRule.phpw ^�gw ���� - src/Rules/Classes/PropertyTagTraitUseRule.php ^�g w�bv� ( src/Rules/Classes/MethodTagTraitRule.php� ^�g� jy�K� : src/Rules/Classes/ExistingClassesInClassImplementsRule.php5 ^�g5 ^�.�� 5 src/Rules/Classes/UnusedConstructorParametersRule.php� ^�g� ��� 2 src/Rules/Classes/LocalTypeTraitUseAliasesRule.php ^�g �_v� 0 src/Rules/Classes/NonClassAttributeClassRule.phpf ^�gf -�Y�� ' src/Rules/Classes/ReadOnlyClassRule.php� ^�g� �iB� , src/Reflection/MethodPrototypeReflection.php� ^�g� # �@� 2 src/Reflection/MethodsClassReflectionExtension.php: ^�g: GgN�� T src/Reflection/RequireExtension/RequireExtendsPropertiesClassReflectionExtension.phpl ^�gl >���� Q src/Reflection/RequireExtension/RequireExtendsMethodsClassReflectionExtension.phpF ^�gF ���ޤ ' src/Reflection/BrokerAwareExtension.php ^�g �J�� - src/Reflection/ParametersAcceptorSelector.php�� ^�g�� ��і� 4 src/Reflection/WrappedExtendedPropertyReflection.php7 ^�g7 �]�� : src/Reflection/AllowedSubTypesClassReflectionExtension.php� ^�g� Ulb�� ) src/Reflection/InitializerExprContext.php ^�g �"�� $ src/Reflection/PassedByReference.php% ^�g% �B�� $ src/Reflection/NamespaceAnswerer.php� ^�g� \�w� % src/Reflection/InaccessibleMethod.php* ^�g* C�� % src/Reflection/PropertyReflection.phpW ^�gW <�zW� 9 src/Reflection/MissingPropertyFromReflectionException.php} ^�g} �D�$� A src/Reflection/ReflectionProvider/MemoizingReflectionProvider.php� ^�g� T)�r� = src/Reflection/ReflectionProvider/DummyReflectionProvider.php� ^�g� 1��"� F src/Reflection/ReflectionProvider/SetterReflectionProviderProvider.phpa ^�ga �3�� D src/Reflection/ReflectionProvider/LazyReflectionProviderProvider.php` ^�g` � � @ src/Reflection/ReflectionProvider/ReflectionProviderProvider.php� ^�g� � F src/Reflection/ReflectionProvider/DirectReflectionProviderProvider.phpP ^�gP �n̪� ? src/Reflection/ReflectionProvider/ReflectionProviderFactory.phpS ^�gS G+�� src/Reflection/Assertions.php� ^�g� kXƤ - src/Reflection/ResolvedPropertyReflection.phpK ^�gK ^�p� . src/Reflection/InitializerExprTypeResolver.phpx[ ^�gx[ �1�Ѥ + src/Reflection/ExtendedMethodReflection.phpI ^�gI �X\�� ( src/Reflection/ClassMemberReflection.phpd ^�gd Y3�٤ # src/Reflection/MethodReflection.php� ^�g� �u�*� % src/Reflection/ConstantReflection.php| ^�g| , = � 9 src/Reflection/MissingConstantFromReflectionException.php| ^�g| �'ʤ * src/Reflection/ResolvedFunctionVariant.php� ^�g� li'Ԥ , src/Reflection/FunctionReflectionFactory.phpE ^�gE ��t�� 2 src/Reflection/AdditionalConstructorsExtension.php� ^�g� W<� , src/Reflection/TrivialParametersAcceptor.phpF ^�gF .?Rg� 6 src/Reflection/ResolvedFunctionVariantWithCallable.php� ^�g� ��Ӥ , src/Reflection/ClassMemberAccessAnswerer.phpt ^�gt �J� I src/Reflection/Annotations/AnnotationsMethodsClassReflectionExtension.php ^�g %�� � L src/Reflection/Annotations/AnnotationsPropertiesClassReflectionExtension.phpm ^�gm U�a� ; src/Reflection/Annotations/AnnotationPropertyReflection.phpk ^�gk EۡԤ 9 src/Reflection/Annotations/AnnotationMethodReflection.php� ^�g� ol㿤 C src/Reflection/Annotations/AnnotationsMethodParameterReflection.php. ^�g. ��� % src/Reflection/ParametersAcceptor.phpI ^�gI 6U�� " src/Reflection/FunctionVariant.php1 ^�g1 $y�פ 2 src/Reflection/WrappedExtendedMethodReflection.php4 ^�g4 u>�G� 3 src/Reflection/Dummy/DummyConstructorReflection.php ^�g ��w� 0 src/Reflection/Dummy/DummyPropertyReflection.phpO ^�gO v�E�� 4 src/Reflection/Dummy/ChangedTypeMethodReflection.php ^�g 0*�� . src/Reflection/Dummy/DummyMethodReflection.php� ^�g� 2gV� 0 src/Reflection/Dummy/DummyConstantReflection.phpu ^�gu ��A�� 6 src/Reflection/Dummy/ChangedTypePropertyReflection.php� ^�g� m�� D src/Reflection/BetterReflection/SourceLocator/FetchedNodesResult.php' ^�g' �Q� M src/Reflection/BetterReflection/SourceLocator/SkipClassAliasSourceLocator.php� ^�g� s��Ф @ src/Reflection/BetterReflection/SourceLocator/CachingVisitor.php� ^�g� c$fV� X src/Reflection/BetterReflection/SourceLocator/OptimizedDirectorySourceLocatorFactory.phpi ^�gi ���� R src/Reflection/BetterReflection/SourceLocator/PhpVersionBlacklistSourceLocator.php� ^�g� ��� @ src/Reflection/BetterReflection/SourceLocator/PhpFileCleaner.php�" ^�g�" �`� Q src/Reflection/BetterReflection/SourceLocator/OptimizedDirectorySourceLocator.php�4 ^�g�4 ��=� = src/Reflection/BetterReflection/SourceLocator/FetchedNode.php ^�g ���� T src/Reflection/BetterReflection/SourceLocator/NewOptimizedDirectorySourceLocator.php ^�g Rp}� B src/Reflection/BetterReflection/SourceLocator/FileNodesFetcher.php� ^�g� jn̤ ` src/Reflection/BetterReflection/SourceLocator/ComposerJsonAndInstalledJsonSourceLocatorMaker.php�* ^�g�* �^#� \ src/Reflection/BetterReflection/SourceLocator/OptimizedSingleFileSourceLocatorRepository.php� ^�g� ?B�� G src/Reflection/BetterReflection/SourceLocator/AutoloadSourceLocator.phpo6 ^�go6 ��%z� Y src/Reflection/BetterReflection/SourceLocator/OptimizedSingleFileSourceLocatorFactory.php ^�g i��� O src/Reflection/BetterReflection/SourceLocator/OptimizedPsrAutoloaderLocator.php� ^�g� [bB� P src/Reflection/BetterReflection/SourceLocator/AutoloadFunctionsSourceLocator.php� ^�g� ��[H� [ src/Reflection/BetterReflection/SourceLocator/OptimizedDirectorySourceLocatorRepository.php� ^�g� bĥ� V src/Reflection/BetterReflection/SourceLocator/OptimizedPsrAutoloaderLocatorFactory.phps ^�gs ǣ/`� K src/Reflection/BetterReflection/SourceLocator/FileReadTrapStreamWrapper.php) ^�g) �q|�� N src/Reflection/BetterReflection/SourceLocator/ReflectionClassSourceLocator.phpL ^�gL ��+?� P src/Reflection/BetterReflection/SourceLocator/RewriteClassAliasSourceLocator.php� ^�g� �,��� R src/Reflection/BetterReflection/SourceLocator/OptimizedSingleFileSourceLocator.php%% ^�g%% K��!� @ src/Reflection/BetterReflection/Reflector/MemoizingReflector.php� ^�g� �'b� C src/Reflection/BetterReflection/BetterReflectionProviderFactory.php# ^�g# �)y� < src/Reflection/BetterReflection/BetterReflectionProvider.php#T ^�g#T &��ڤ S src/Reflection/BetterReflection/SourceStubber/PhpStormStubsSourceStubberFactory.php� ^�g� �Ԋ�� P src/Reflection/BetterReflection/SourceStubber/ReflectionSourceStubberFactory.php� ^�g� h���� H src/Reflection/BetterReflection/BetterReflectionSourceLocatorFactory.phpm ^�gm �Bd� " src/Reflection/ClassNameHelper.php ^�g '_ɤ 3 src/Reflection/ReflectionProviderStaticAccessor.php� ^�g� 2� H� % src/Reflection/ConstructorsHelper.php� ^�g� (Q�� 0 src/Reflection/ParametersAcceptorWithPhpDocs.php ^�g O�$E� . src/Reflection/Mixin/MixinMethodReflection.php4 ^�g4 �#]� = src/Reflection/Mixin/MixinMethodsClassReflectionExtension.php: ^�g: jV�ޤ @ src/Reflection/Mixin/MixinPropertiesClassReflectionExtension.php� ^�g� D^�פ * src/Reflection/ClassConstantReflection.php\ ^�g\ \�JN� " src/Reflection/ClassReflection.phpz� ^�gz� 5y:� , src/Reflection/WrapperPropertyReflection.php� ^�g� �6�@� - src/Reflection/ExtendedPropertyReflection.php ^�g S��� ; src/Reflection/Type/UnresolvedMethodPrototypeReflection.php� ^�g� ��C.� D src/Reflection/Type/UnionTypeUnresolvedMethodPrototypeReflection.php� ^�g� 0SФ : src/Reflection/Type/IntersectionTypePropertyReflection.phpn ^�gn �T��� G src/Reflection/Type/CalledOnTypeUnresolvedMethodPrototypeReflection.php? ^�g? �c�N� M src/Reflection/Type/IntersectionTypeUnresolvedPropertyPrototypeReflection.php� ^�g� �Cy̤ 3 src/Reflection/Type/UnionTypePropertyReflection.phpp ^�gp �/�~� K src/Reflection/Type/IntersectionTypeUnresolvedMethodPrototypeReflection.php� ^�g� �'¤ E src/Reflection/Type/CallbackUnresolvedPropertyPrototypeReflection.phph ^�gh -�3� C src/Reflection/Type/CallbackUnresolvedMethodPrototypeReflection.php. ^�g. �e�g� F src/Reflection/Type/UnionTypeUnresolvedPropertyPrototypeReflection.php� ^�g� ]�U_� = src/Reflection/Type/UnresolvedPropertyPrototypeReflection.php� ^�g� ��T`� 1 src/Reflection/Type/UnionTypeMethodReflection.phpT ^�gT �?e�� I src/Reflection/Type/CalledOnTypeUnresolvedPropertyPrototypeReflection.phpc ^�gc D耤 8 src/Reflection/Type/IntersectionTypeMethodReflection.php� ^�g� ��� 5 src/Reflection/Constant/RuntimeConstantReflection.php� ^�g� `@ � - src/Reflection/FunctionVariantWithPhpDocs.php ^�g �� � 6 src/Reflection/ResolvedFunctionVariantWithOriginal.php) ^�g) &U��� % src/Reflection/ConstantNameHelper.php� ^�g� �B�� % src/Reflection/FunctionReflection.php� ^�g� ����� % src/Reflection/EnumCaseReflection.php� ^�g� � K�� + src/Reflection/GlobalConstantReflection.php� ^�g� v�Zʤ 4 src/Reflection/GenericParametersAcceptorResolver.phpE ^�gE ��=� - src/Reflection/Callables/SimpleThrowPoint.php� ^�g� �kC� . src/Reflection/Callables/SimpleImpurePoint.php ^�g � �n� 7 src/Reflection/Callables/CallableParametersAcceptor.php� ^�g� �"R� 4 src/Reflection/Callables/FunctionCallableVariant.phpt ^�gt �,N1� / src/Reflection/Php/SimpleXMLElementProperty.php� ^�g� �� �� @ src/Reflection/Php/EnumUnresolvedPropertyPrototypeReflection.php� ^�g� ��'7� 3 src/Reflection/Php/UniversalObjectCrateProperty.phpJ ^�gJ t?��� , src/Reflection/Php/PhpPropertyReflection.php� ^�g� v��� - src/Reflection/Php/PhpParameterReflection.phpz ^�gz �f� � ; src/Reflection/Php/PhpParameterFromParserNodeReflection.phpH ^�gH ��^@� 8 src/Reflection/Php/PhpMethodFromParserNodeReflection.php� ^�g� 6��f� 0 src/Reflection/Php/DummyParameterWithPhpDocs.php� ^�g� ��j-� , src/Reflection/Php/PhpFunctionReflection.php. ^�g. -�Jդ * src/Reflection/Php/PhpMethodReflection.phpxF ^�gxF ��ྤ D src/Reflection/Php/UniversalObjectCratesClassReflectionExtension.php� ^�g� N �N� 2 src/Reflection/Php/PhpClassReflectionExtension.php6� ^�g6� '1��� . src/Reflection/Php/BuiltinMethodReflection.php ^�g ��l� B src/Reflection/Php/EnumAllowedSubTypesClassReflectionExtension.php ^�g � �� % src/Reflection/Php/DummyParameter.php ^�g �X�B� 2 src/Reflection/Php/ClosureCallMethodReflection.php� ^�g� �YƢ� 6 src/Reflection/Php/Soap/SoapClientMethodReflection.phpF ^�gF i� E src/Reflection/Php/Soap/SoapClientMethodsClassReflectionExtension.php� ^�g� +���� - src/Reflection/Php/ExitFunctionReflection.php� ^�g� ��V� - src/Reflection/Php/EnumPropertyReflection.php� ^�g� T���� 1 src/Reflection/Php/PhpMethodReflectionFactory.php� ^�g� �� 4 src/Reflection/Php/NativeBuiltinMethodReflection.php� ^�g� *��K� : src/Reflection/Php/PhpFunctionFromParserNodeReflection.php�, ^�g�, T"Ȥ E src/Reflection/Php/ClosureCallUnresolvedMethodPrototypeReflection.php~ ^�g~ �K�r� 0 src/Reflection/Php/EnumCasesMethodReflection.phpS ^�gS Aw)�� + src/Reflection/ResolvedMethodReflection.php= ^�g= ���� + src/Reflection/PhpVersionStaticAccessor.phpk ^�gk q��?� 5 src/Reflection/PropertiesClassReflectionExtension.phpS ^�gS -=�[� 1 src/Reflection/ParameterReflectionWithPhpDocs.php� ^�g� �y��� 7 src/Reflection/MissingMethodFromReflectionException.phpv ^�gv Cz�b� 3 src/Reflection/ClassReflectionExtensionRegistry.php� ^�g� {�#� @ src/Reflection/SignatureMap/NativeFunctionReflectionProvider.php� ^�g� 7�֥� 4 src/Reflection/SignatureMap/SignatureMapProvider.php� ^�g� X �7� 1 src/Reflection/SignatureMap/FunctionSignature.php� ^�g� �� � 2 src/Reflection/SignatureMap/SignatureMapParser.php� ^�g� ��'/� 2 src/Reflection/SignatureMap/ParameterSignature.php? ^�g? �ᷤ 8 src/Reflection/SignatureMap/Php8SignatureMapProvider.php�N ^�g�N `M�u� < src/Reflection/SignatureMap/FunctionSignatureMapProvider.php ' ^�g ' �vRp� ; src/Reflection/SignatureMap/SignatureMapProviderFactory.phpR ^�gR %ڏ�� 3 src/Reflection/Native/NativeParameterReflection.php� ^�g� at�ʤ 2 src/Reflection/Native/NativeFunctionReflection.php� ^�g� U��R� 0 src/Reflection/Native/NativeMethodReflection.php ^�g A� >� > src/Reflection/Native/NativeParameterWithPhpDocsReflection.php� ^�g� �5� O src/Reflection/PHPStan/NativeReflectionEnumReturnDynamicReturnTypeExtension.php� ^�g� ���G� % src/Reflection/ReflectionProvider.php� ^�g� ��r!� & src/Reflection/ParameterReflection.php� ^�g� �`}1� 5 src/Reflection/CallableFunctionVariantWithPhpDocs.php� ^�g� 4*Zޤ src/File/FileExcluderFactory.phpK ^�gK �[� . src/File/ParentDirectoryRelativePathHelper.php� ^�g� �Bh�� # src/File/FileExcluderRawFactory.php� ^�g� ) f�� src/File/FileMonitorResult.php� ^�g� �.� src/File/FileExcluder.php^ ^�g^ �:UH� # src/File/NullRelativePathHelper.php� ^�g� z�� ' src/File/CouldNotWriteFileException.php� ^�g� � �� src/File/RelativePathHelper.php� ^�g� ��+l� $ src/File/FuzzyRelativePathHelper.phpP ^�gP � & src/File/CouldNotReadFileException.php� ^�g� x1g� 3 src/File/SystemAgnosticSimpleRelativePathHelper.php� ^�g� ���ͤ src/File/FileMonitor.php� ^�g� 9,*� src/File/FileFinderResult.phpZ ^�gZ �{� src/File/FileFinder.php� ^�g� '2� � " src/File/PathNotFoundException.php� ^�g� OJ5�� src/File/FileWriter.php� ^�g� R���� % src/File/SimpleRelativePathHelper.php. ^�g. �cq� src/File/FileHelper.php� ^�g� ��KG� src/File/FileReader.php ^�g BW�ͤ src/debugScope.php� ^�g� � �� src/TrinaryLogic.php� ^�g� �3*� src/Cache/CacheItem.php8 ^�g8 O�IW� src/Cache/CacheStorage.php0 ^�g0 � ��� src/Cache/MemoryCacheStorage.phpO ^�gO �kB� src/Cache/Cache.phpg ^�gg ��`� src/Cache/FileCacheStorage.phpO ^�gO 'r�� src/Internal/SprintfHelper.php� ^�g� � 6�� * src/Internal/DirectoryCreatorException.php8 ^�g8 �~� ! src/Internal/DirectoryCreator.php� ^�g� z�y�� 4 src/Internal/ContainerDynamicReturnTypeExtension.php) ^�g) ��wC� # src/Internal/CombinationsHelper.php ^�g {�ou� src/Internal/ComposerHelper.php ^�g Q:'8� src/Internal/BytesHelper.php� ^�g� �e| � src/dumpType.phpA ^�gA � � � ) src/Parallel/ProcessTimedOutException.php� ^�g� �ߤ src/Parallel/Process.php� ^�g� R`k � ! src/Parallel/ParallelAnalyser.php�1 ^�g�1 F$*�� src/Parallel/ProcessPool.phpj ^�gj /�� src/Parallel/Schedule.php� ^�g� ��� src/Parallel/Scheduler.php� ^�g� ���� ' src/Command/ClearResultCacheCommand.php ^�g pL�&� $ src/Command/Symfony/SymfonyStyle.php� ^�g� _� � % src/Command/Symfony/SymfonyOutput.php ^�g "c�פ src/Command/AnalyserRunner.php ^�g �]��� src/Command/CommandHelper.phpP� ^�gP� �ņ� src/Command/Output.php� ^�g� �9�� 3 src/Command/ErrorFormatter/GitlabErrorFormatter.php5 ^�g5 �}��� 7 src/Command/ErrorFormatter/CheckstyleErrorFormatter.php ^�g =�4� 2 src/Command/ErrorFormatter/TableErrorFormatter.phpP ^�gP і��� - src/Command/ErrorFormatter/ErrorFormatter.php� ^�g� �s�̤ 3 src/Command/ErrorFormatter/GithubErrorFormatter.phph ^�gh �VԤ 9 src/Command/ErrorFormatter/BaselineNeonErrorFormatter.php� ^�g� +�A[� 8 src/Command/ErrorFormatter/BaselinePhpErrorFormatter.phpP ^�gP ��g]� 2 src/Command/ErrorFormatter/JunitErrorFormatter.php ^�g �U�+� 0 src/Command/ErrorFormatter/RawErrorFormatter.phpj ^�gj ��� 5 src/Command/ErrorFormatter/TeamcityErrorFormatter.php ^�g K�.� 1 src/Command/ErrorFormatter/JsonErrorFormatter.phpR ^�gR H\� 7 src/Command/ErrorFormatter/CiDetectedErrorFormatter.php� ^�g� GQ�C� / src/Command/InceptionNotSuccessfulException.php� ^�g� �_� src/Command/fixer-phar.pubkey ^�g u䪤 src/Command/AnalyseCommand.php�| ^�g�| ���C� src/Command/InceptionResult.php[ ^�g[ !G� " src/Command/ErrorsConsoleStyle.php� ^�g� �`_L� src/Command/DiagnoseCommand.php? ^�g? �� � + src/Command/IgnoredRegexValidatorResult.php� ^�g� �3�?� src/Command/AnalysisResult.phpc ^�gc ��$e� " src/Command/FixerWorkerCommand.phpo> ^�go> /�K�� % src/Command/DumpParametersCommand.php� ^�g� �:��� src/Command/WorkerCommand.php~& ^�g~& C�<�� src/Command/FixerApplication.php4U ^�g4U �t#w� % src/Command/FixerProcessException.php� ^�g� ��H}� " src/Command/AnalyseApplication.php�$ ^�g�$ Gx�� % src/Command/IgnoredRegexValidator.php� ^�g� ��m� src/Command/OutputStyle.php� ^�g� �>g� src/AnalysedCodeException.php� ^�g� iqE^� " src/Collectors/RegistryFactory.php ^�g �wʤ src/Collectors/CollectedData.phpZ ^�gZ na� src/Collectors/Registry.phpv ^�gv (��� src/Collectors/Collector.php ^�g ���;� ' src/Process/ProcessCrashedException.php� ^�g� &�Ф src/Process/ProcessHelper.phpY ^�gY �&�� ( src/Process/ProcessCanceledException.php� ^�g� w@X�� src/Process/CpuCoreCounter.php� ^�g� �!�u� src/Process/ProcessPromise.phpz ^�gz ���G� " src/Parser/TryCatchTypeVisitor.php� ^�g� �K>�� src/Parser/Parser.php� ^�g� �_8�� src/Parser/SimpleParser.php� ^�g� Fa �� % src/Parser/DeclarePositionVisitor.php� ^�g� �mA�� src/Parser/CleaningParser.php� ^�g� �ԱD� src/Parser/ClosureArgVisitor.php� ^�g� g��ˤ / src/Parser/MagicConstantParamDefaultVisitor.php ^�g ��Bä " src/Parser/ArrayFindArgVisitor.php ^�g ̲?�� - src/Parser/TypeTraverserInstanceofVisitor.php( ^�g( �Q�F� + src/Parser/NewAssignedToPropertyVisitor.php� ^�g� �X� � / src/Parser/ImmediatelyInvokedClosureVisitor.php ^�g Ňo�� src/Parser/CleaningVisitor.php\ ^�g\ ���H� * src/Parser/FunctionCallStatementFinder.php� ^�g� �Jy�� $ src/Parser/ParserErrorsException.php� ^�g� ��<)� 4 src/Parser/RemoveUnusedCodeByPhpVersionIdVisitor.phpS ^�gS ��SL� & src/Parser/ClosureBindToVarVisitor.php� ^�g� �B� � # src/Parser/LastConditionVisitor.php� ^�g� �o�� & src/Parser/ArrowFunctionArgVisitor.php� ^�g� ���Ǥ ! src/Parser/PhpParserDecorator.php� ^�g� #�ߤ % src/Parser/ParentStmtTypesVisitor.phpn ^�gn &ܤ ! src/Parser/ArrayMapArgVisitor.php� ^�g� ,z츤 $ src/Parser/AnonymousClassVisitor.phpf ^�gf ,G�� % src/Parser/TraitCollectingVisitor.php� ^�g� }4(Ĥ $ src/Parser/ClosureBindArgVisitor.php ^�g `�i� $ src/Parser/ArrayFilterArgVisitor.php� ^�g� Nh�5� src/Parser/CachedParser.php� ^�g� 64l�� " src/Parser/ArrayWalkArgVisitor.php� ^�g� +F�� src/Parser/LexerFactory.php� ^�g� $�B9� # src/Parser/CurlSetOptArgVisitor.php� ^�g� �Ac� src/Parser/PathRoutingParser.php� ^�g� '�\K� src/Parser/RichParser.php�4 ^�g�4 d�R�� src/ShouldNotHappenException.php ^�g ��� src/Testing/TestCase.neon� ^�g� ;,!� , src/Testing/TestCaseSourceLocatorFactory.phpi ^�gi ���� src/Testing/PHPStanTestCase.php!% ^�g!% zQ�� src/Testing/RuleTestCase.phpO ^�gO ��I�� % src/Testing/TypeInferenceTestCase.php5 ^�g5 �m"� src/Testing/LevelsTestCase.php ^�g .C� src/Testing/functions.php� ^�g� �-c� & src/Testing/ErrorFormatterTestCase.php; ^�g; '"�^� 0 src/PhpDoc/TypeNodeResolverExtensionRegistry.php� ^�g� u� � ! src/PhpDoc/PhpDocNodeResolver.php�h ^�g�h �Jcͤ src/PhpDoc/Tag/ParamOutTag.php ^�g ~m;� $ src/PhpDoc/Tag/RequireExtendsTag.phpc ^�gc H�D�� % src/PhpDoc/Tag/MethodTagParameter.php ^�g �<a8� src/PhpDoc/Tag/MixinTag.phpZ ^�gZ i��Τ % src/PhpDoc/Tag/AssertTagParameter.php� ^�g� ��� src/PhpDoc/Tag/PropertyTag.php� ^�g� � � src/PhpDoc/Tag/ExtendsTag.php\ ^�g\ 5Y!�� src/PhpDoc/Tag/VarTag.php ^�g Ʃ�(� % src/PhpDoc/Tag/TypeAliasImportTag.php8 ^�g8 �Atw� & src/PhpDoc/Tag/ParamClosureThisTag.php+ ^�g+ ֨�� src/PhpDoc/Tag/TypedTag.php� ^�g� �*�4� src/PhpDoc/Tag/ParamTag.php� ^�g� 9�]�� src/PhpDoc/Tag/UsesTag.phpY ^�gY �{02� ! src/PhpDoc/Tag/SelfOutTypeTag.php ^�g � �� ' src/PhpDoc/Tag/RequireImplementsTag.phpf ^�gf | �� src/PhpDoc/Tag/ReturnTag.php[ ^�g[ �n�֤ src/PhpDoc/Tag/DeprecatedTag.phpc ^�gc �V� src/PhpDoc/Tag/ThrowsTag.php[ ^�g[ �* � src/PhpDoc/Tag/AssertTag.php� ^�g� ��3� src/PhpDoc/Tag/MethodTag.php ^�g ��� src/PhpDoc/Tag/TemplateTag.phpb ^�gb a��� src/PhpDoc/Tag/ImplementsTag.php_ ^�g_ %A�;� src/PhpDoc/Tag/TypeAliasTag.php? ^�g? ��� # src/PhpDoc/PhpDocStringResolver.php� ^�g� ;�ܤ ' src/PhpDoc/DefaultStubFilesProvider.php� ^�g� P�ۤ > src/PhpDoc/DirectTypeNodeResolverExtensionRegistryProvider.php& ^�g& � N� 8 src/PhpDoc/TypeNodeResolverExtensionRegistryProvider.php� ^�g� p:(�� ! src/PhpDoc/StubPhpDocProvider.phpF2 ^�gF2 8)g� src/PhpDoc/StubValidator.php�7 ^�g�7 喚0� $ src/PhpDoc/ConstExprNodeResolver.php ^�g �c � * src/PhpDoc/CountableStubFilesExtension.php$ ^�g$ s�UV� ! src/PhpDoc/TypeStringResolver.php� ^�g� ��j� / src/PhpDoc/ReflectionEnumStubFilesExtension.php* ^�g* ��� ( src/PhpDoc/TypeNodeResolverExtension.php ^�g �)� - src/PhpDoc/TypeNodeResolverAwareExtension.php� ^�g� N�,s� - src/PhpDoc/JsonValidateStubFilesExtension.php. ^�g. 4-�ݤ < src/PhpDoc/LazyTypeNodeResolverExtensionRegistryProvider.php� ^�g� �� src/PhpDoc/PhpDocBlock.php�/ ^�g�/ �k� src/PhpDoc/StubFilesProvider.php� ^�g� ��%� 4 src/PhpDoc/NameScopeAlreadyBeingCreatedException.php� ^�g� /�/� - src/PhpDoc/SocketSelectStubFilesExtension.php^ ^�g^ �D�ˤ ! src/PhpDoc/StubFilesExtension.phpt ^�gt �R��� 5 src/PhpDoc/TypeNodeResolverExtensionAwareRegistry.phpq ^�gq QA� " src/PhpDoc/ResolvedPhpDocBlock.phpę ^�gę GD�*� ( src/PhpDoc/PhpDocInheritanceResolver.php� ^�g� 6d�դ ' src/PhpDoc/StubSourceLocatorFactory.php3 ^�g3 ���ͤ % src/PhpDoc/ConstExprParserFactory.php� ^�g� �פ src/PhpDoc/TypeNodeResolver.phpD� ^�gD� � � 6 src/DependencyInjection/DerivativeContainerFactory.phpD ^�gD �Cŏ� 8 src/DependencyInjection/InvalidExcludePathsException.php' ^�g' �Ԕ~� / src/DependencyInjection/ProjectConfigHelper.php� ^�g� ;7�� % src/DependencyInjection/Container.php� ^�g� ؋�R� , src/DependencyInjection/ContainerFactory.php]; ^�g]; �9 Τ O src/DependencyInjection/Reflection/ClassReflectionExtensionRegistryProvider.php ^�g �r�� S src/DependencyInjection/Reflection/LazyClassReflectionExtensionRegistryProvider.php, ^�g, ��b� . src/DependencyInjection/BleedingEdgeToggle.php� ^�g� 7�a�� 9 src/DependencyInjection/ValidateExcludePathsExtension.phpw ^�gw %_}� ) src/DependencyInjection/LoaderFactory.php, ^�g, �S<� 4 src/DependencyInjection/ConditionalTagsExtension.php� ^�g� m��#� . src/DependencyInjection/MemoizingContainer.php ^�g ��mr� 0 src/DependencyInjection/Nette/NetteContainer.php ^�g 3�k� * src/DependencyInjection/RulesExtension.php ^�g xO�� @ src/DependencyInjection/InvalidIgnoredErrorPatternsException.php/ ^�g/ �6�� B src/DependencyInjection/Type/DynamicThrowTypeExtensionProvider.php� ^�g� �p�դ O src/DependencyInjection/Type/LazyDynamicReturnTypeExtensionRegistryProvider.php! ^�g! ;-j�� P src/DependencyInjection/Type/OperatorTypeSpecifyingExtensionRegistryProvider.php ^�g ��s)� F src/DependencyInjection/Type/LazyParameterOutTypeExtensionProvider.php[ ^�g[ ��j4� F src/DependencyInjection/Type/LazyDynamicThrowTypeExtensionProvider.php[ ^�g[ ��*Ǥ F src/DependencyInjection/Type/ParameterClosureTypeExtensionProvider.php� ^�g� I{� K src/DependencyInjection/Type/DynamicReturnTypeExtensionRegistryProvider.php ^�g ;r�� T src/DependencyInjection/Type/LazyExpressionTypeResolverExtensionRegistryProvider.php� ^�g� �Rפ T src/DependencyInjection/Type/LazyOperatorTypeSpecifyingExtensionRegistryProvider.php ^�g �e('� J src/DependencyInjection/Type/LazyParameterClosureTypeExtensionProvider.php{ ^�g{ � ä P src/DependencyInjection/Type/ExpressionTypeResolverExtensionRegistryProvider.php ^�g �楤 B src/DependencyInjection/Type/ParameterOutTypeExtensionProvider.php� ^�g� ����� 5 src/DependencyInjection/ParametersSchemaExtension.php� ^�g� ªC�� ( src/DependencyInjection/Configurator.php ^�g ���W� & src/DependencyInjection/NeonLoader.php� ^�g� �.k� ' src/DependencyInjection/NeonAdapter.php� ^�g� ~�{� : src/DependencyInjection/ValidateIgnoredErrorsExtension.php! ^�g! R�Y� - src/DependencyInjection/Neon/OptionalPath.php ^�g `G�Ť ; src/DependencyInjection/DuplicateIncludedFilesException.phpp ^�gp ;i� 6 src/DependencyInjection/ParameterNotFoundException.phpP ^�gP D� # src/Type/ObjectWithoutClassType.php� ^�g� �X�@� src/Type/BenevolentUnionType.php ^�g D�fr� src/Type/NullType.phpo) ^�go) �,�@� src/Type/Type.php0 ^�g0 �$F� $ src/Type/Generic/TemplateTypeMap.php_ ^�g_ �T� . src/Type/Generic/TemplateGenericObjectType.php� ^�g� ��"� , src/Type/Generic/TemplateObjectShapeType.php� ^�g� � �b� * src/Type/Generic/TemplateTypeReference.php� ^�g� B�8�� & src/Type/Generic/TemplateMixedType.phph ^�gh ��o� 0 src/Type/Generic/TemplateConstantIntegerType.php� ^�g� GA8դ & src/Type/Generic/GenericObjectType.php�6 ^�g�6 _�'Ф - src/Type/Generic/TemplateIntersectionType.php� ^�g� � �� 2 src/Type/Generic/TemplateTypeParameterStrategy.php� ^�g� (�}� + src/Type/Generic/GenericClassStringType.php� ^�g� �{� 1 src/Type/Generic/TemplateTypeArgumentStrategy.php� ^�g� f�y� & src/Type/Generic/TemplateUnionType.php- ^�g- `�mh� ' src/Type/Generic/TemplateStringType.phpV ^�gV 6yI/� & src/Type/Generic/GenericStaticType.php�% ^�g�% ���]� ( src/Type/Generic/TemplateTypeFactory.php" ^�g" l�Ar� ) src/Type/Generic/TypeProjectionHelper.phps ^�gs H^�1� & src/Type/Generic/TemplateArrayType.php| ^�g| `�� ( src/Type/Generic/TemplateIntegerType.php[ ^�g[ �˝L� ) src/Type/Generic/TemplateTypeVariance.php ^�g ��K� . src/Type/Generic/TemplateConstantArrayType.php� ^�g� (�\&� & src/Type/Generic/TemplateFloatType.phpQ ^�gQ $Z��� ! src/Type/Generic/TemplateType.php| ^�g| ��r/� ( src/Type/Generic/TemplateBooleanType.php[ ^�g[ �� ) src/Type/Generic/TemplateTypeStrategy.php< ^�g< Uzܤ & src/Type/Generic/TemplateTypeScope.php ^�g ��G�� , src/Type/Generic/TemplateTypeVarianceMap.php� ^�g� $�.� 0 src/Type/Generic/TemplateBenevolentUnionType.phpE ^�gE ��֤ & src/Type/Generic/TemplateTypeTrait.php0 ^�g0 �$y� ' src/Type/Generic/TemplateTypeHelper.php� ^�g� /�%� / src/Type/Generic/TemplateConstantStringType.php� ^�g� �+T� ' src/Type/Generic/TemplateObjectType.php ^�g ��8� 3 src/Type/Generic/TemplateObjectWithoutClassType.php, ^�g, �<��� , src/Type/Generic/TemplateStrictMixedType.php� ^�g� ��A� & src/Type/Generic/TemplateKeyOfType.php{ ^�g{ �f � , src/Type/FunctionTypeSpecifyingExtension.php ^�g g\�P� src/Type/KeyOfType.php& ^�g& s�٤ src/Type/TypeTraverser.php* ^�g* pI��� src/Type/ExponentiateHelper.php ^�g ��M� * src/Type/MethodTypeSpecifyingExtension.php' ^�g' T\0e� ' src/Type/Helper/GetTemplateTypeType.php� ^�g� �� � src/Type/OffsetAccessType.php� ^�g� <�� src/Type/UnionTypeHelper.php~ ^�g~ �"o� src/Type/ClosureTypeFactory.phpl ^�gl ?��ݤ 4 src/Type/ExpressionTypeResolverExtensionRegistry.php' ^�g' yn� src/Type/NeverType.php�6 ^�g�6 ��&�� src/Type/ObjectType.php�� ^�g�� �� � src/Type/ConstantTypeHelper.php ^�g �D㫤 src/Type/ConstantType.php| ^�g| ��>G� * src/Type/Traits/FalseyBooleanTypeTrait.php ^�g 4�k1� % src/Type/Traits/NonArrayTypeTrait.php� ^�g� ݄#� 0 src/Type/Traits/UndecidedComparisonTypeTrait.php ^�g ��n� - src/Type/Traits/UndecidedBooleanTypeTrait.php� ^�g� ȷ�� 6 src/Type/Traits/ConstantNumericComparisonTypeTrait.php) ^�g) 5���� * src/Type/Traits/NonRemoveableTypeTrait.php� ^�g� 4�i8� + src/Type/Traits/LateResolvableTypeTrait.php�= ^�g�= ��: � + src/Type/Traits/ConstantScalarTypeTrait.php6 ^�g6 z;r1� ' src/Type/Traits/NonGenericTypeTrait.php� ^�g� ��ށ� * src/Type/Traits/MaybeCallableTypeTrait.php� ^�g� ��� - src/Type/Traits/NonGeneralizableTypeTrait.php� ^�g� f�7ݤ ' src/Type/Traits/MaybeArrayTypeTrait.php� ^�g� ��{� 8 src/Type/Traits/UndecidedComparisonCompoundTypeTrait.php� ^�g� ��� 2 src/Type/Traits/MaybeOffsetAccessibleTypeTrait.phpx ^�gx �� # src/Type/Traits/ObjectTypeTrait.php{ ^�g{ s>0� ( src/Type/Traits/MaybeObjectTypeTrait.php ^�g �2{� & src/Type/Traits/NonObjectTypeTrait.phpu ^�gu B�� ( src/Type/Traits/NonCallableTypeTrait.php� ^�g� զ�[� * src/Type/Traits/MaybeIterableTypeTrait.phpI ^�gI �� * src/Type/Traits/TruthyBooleanTypeTrait.php ^�g ��� � ( src/Type/Traits/NonIterableTypeTrait.php ^�g �. |� 0 src/Type/Traits/NonOffsetAccessibleTypeTrait.php� ^�g� ��� 0 src/Type/MethodParameterClosureTypeExtension.phps ^�gs �MҌ� src/Type/TypeResult.php� ^�g� ��(� , src/Type/DirectTypeAliasResolverProvider.php ^�g �)�� src/Type/NewObjectType.php6 ^�g6 ��� � src/Type/IntegerType.php� ^�g� �� src/Type/VoidType.php� ^�g� ʃl¤ , src/Type/ExpressionTypeResolverExtension.phpI ^�gI C8�� src/Type/IntegerRangeType.phpc\ ^�gc\ �Y�]� . src/Type/DynamicFunctionThrowTypeExtension.phpl ^�gl +���� " src/Type/JustNullableTypeTrait.php2 ^�g2 OchG� ( src/Type/GenericTypeVariableResolver.php� ^�g� 0?� * src/Type/LazyTypeAliasResolverProvider.php ^�g c�k�� src/Type/TypeAliasResolver.php4 ^�g4 Л�� ' src/Type/NonexistentParentClassType.php� ^�g� �z� src/Type/ClosureType.php�a ^�g�a �F;�� " src/Type/NonAcceptingNeverType.php� ^�g� �E3� src/Type/CallableType.phpgS ^�ggS �* �� src/Type/ResourceType.phpw ^�gw ���� src/Type/VerbosityLevel.phpu ^�gu �S�� src/Type/ClassStringType.phpM ^�gM ��� & src/Type/TypeAliasResolverProvider.php� ^�g� ��!n� src/Type/StaticType.php^ ^�g^ �ID� $ src/Type/UsefulTypeAliasResolver.php� ^�g� �п� 1 src/Type/CircularTypeAliasDefinitionException.php� ^�g� ű�ä src/Type/RecursionGuard.php� ^�g� }��O� 3 src/Type/DynamicStaticMethodReturnTypeExtension.php� ^�g� ��CѤ $ src/Type/Enum/EnumCaseObjectType.php� ^�g� ��M� , src/Type/MethodParameterOutTypeExtension.php� ^�g� � �� src/Type/UnionType.phpʴ ^�gʴ ��kr� 4 src/Type/OperatorTypeSpecifyingExtensionRegistry.php ^�g ��4�� & src/Type/SimultaneousTypeTraverser.php� ^�g� ,� դ src/Type/BitwiseFlagHelper.php� ^�g� �*-{� 2 src/Type/StaticMethodParameterOutTypeExtension.php� ^�g� �� src/Type/LateResolvableType.php� ^�g� � 1�� src/Type/ErrorType.php� ^�g� X�ä src/Type/TypeAlias.phpi ^�gi 9� � ) src/Type/Regex/RegexNonCapturingGroup.phpm ^�gm ��%D� % src/Type/Regex/RegexAstWalkResult.php� ^�g� ��iڤ ( src/Type/Regex/RegexExpressionHelper.php� ^�g� �(�Ϥ ' src/Type/Regex/RegexGroupWalkResult.php� ^�g� c� � & src/Type/Regex/RegexCapturingGroup.php� ^�g� �+-ڤ # src/Type/Regex/RegexAlternation.php� ^�g� ^ m�� # src/Type/Regex/RegexGroupParser.php�T ^�g�T *�$� src/Type/MixedType.php8� ^�g8� �� * src/Type/ObjectShapePropertyReflection.php� ^�g� �c�� src/Type/StringType.phpI! ^�gI! G �\� - src/Type/DynamicMethodReturnTypeExtension.php� ^�g� C�$� src/Type/IntersectionType.php�� ^�g�� ���� . src/Type/FunctionParameterOutTypeExtension.php� ^�g� �$%¤ ( src/Type/Constant/ConstantStringType.php�K ^�g�K �)� + src/Type/Constant/OversizedArrayBuilder.php� ^�g� vj�'� ) src/Type/Constant/ConstantBooleanType.php� ^�g� ��� . src/Type/Constant/ConstantArrayTypeBuilder.php�0 ^�g�0 ��K�� 0 src/Type/Constant/ConstantArrayTypeAndMethod.php� ^�g� �.�� ' src/Type/Constant/ConstantArrayType.php�� ^�g�� �P��� ) src/Type/Constant/ConstantIntegerType.php ^�g j��� ' src/Type/Constant/ConstantFloatType.php� ^�g� B���� 2 src/Type/Constant/ConstantScalarToBooleanTrait.php ^�g &��� src/Type/FileTypeMapper.php4� ^�g4� �:릤 6 src/Type/StaticMethodParameterClosureTypeExtension.php� ^�g� c�}B� src/Type/IterableType.php�= ^�g�= �e�� src/Type/GeneralizePrecision.php ^�g 0�"?� src/Type/ValueOfType.php� ^�g� E���� src/Type/StrictMixedType.phpu/ ^�gu/ �ֹ�� 0 src/Type/StaticMethodTypeSpecifyingExtension.phpG ^�gG z��;� src/Type/StaticTypeFactory.php� ^�g� �e��� src/Type/TypeUtils.php~2 ^�g~2 &, � 8 src/Type/StringAlwaysAcceptingObjectWithToStringType.php� ^�g� Y� 9� src/Type/ArrayType.php a ^�g a ���ߤ ( src/Type/ParserNodeTypeToPHPStanType.php� ^�g� �2��� , src/Type/OperatorTypeSpecifyingExtension.php� ^�g� � tF� src/Type/BooleanType.php� ^�g� D]� " src/Type/LooseComparisonHelper.php� ^�g� 9�ͤ ; src/Type/Php/ReplaceFunctionsDynamicReturnTypeExtension.php~ ^�g~ kN� / src/Type/Php/PowFunctionReturnTypeExtension.php{ ^�g{ �_ڤ 6 src/Type/Php/ArrayChunkFunctionReturnTypeExtension.phpi ^�gi y��� 6 src/Type/Php/ArrayShiftFunctionReturnTypeExtension.php� ^�g� 5�l� 5 src/Type/Php/MicrotimeFunctionReturnTypeExtension.php� ^�g� ���¤ 4 src/Type/Php/MbStrlenFunctionReturnTypeExtension.php� ^�g� �^Yܤ 0 src/Type/Php/DsMapDynamicReturnTypeExtension.php: ^�g: ̢��� 2 src/Type/Php/StrlenFunctionReturnTypeExtension.php� ^�g� S] � ; src/Type/Php/JsonThrowOnErrorDynamicReturnTypeExtension.php� ^�g� -�ۤ 6 src/Type/Php/ArraySliceFunctionReturnTypeExtension.phpy ^�gy �X � = src/Type/Php/ArrayIntersectKeyFunctionReturnTypeExtension.php� ^�g� �mB� > src/Type/Php/ClosureFromCallableDynamicReturnTypeExtension.php~ ^�g~ {s$�� 8 src/Type/Php/OpenSslEncryptParameterOutTypeExtension.php ^�g �U�� C src/Type/Php/ReflectionClassIsSubclassOfTypeSpecifyingExtension.php� ^�g� ,��Ф 7 src/Type/Php/ArrayColumnFunctionReturnTypeExtension.php ^�g I[�Ф @ src/Type/Php/MbSubstituteCharacterDynamicReturnTypeExtension.php\ ^�g\ �)� 6 src/Type/Php/ClosureBindDynamicReturnTypeExtension.php� ^�g� ]�� � 3 src/Type/Php/PregMatchParameterOutTypeExtension.phph ^�gh H ��� ; src/Type/Php/IteratorToArrayFunctionReturnTypeExtension.phpa ^�ga mUBɤ / src/Type/Php/MbFunctionsReturnTypeExtension.php ^�g `�,� > src/Type/Php/ArrayValuesFunctionDynamicReturnTypeExtension.php@ ^�g@ E�"?� 5 src/Type/Php/CountFunctionTypeSpecifyingExtension.php� ^�g� b�Q�� 3 src/Type/Php/ImplodeFunctionReturnTypeExtension.php� ^�g� �TJ � 2 src/Type/Php/MinMaxFunctionReturnTypeExtension.php ^�g w��l� 1 src/Type/Php/CountFunctionReturnTypeExtension.php� ^�g� j.m�� / src/Type/Php/FilterFunctionReturnTypeHelper.php4B ^�g4B >B� 4 src/Type/Php/ArrayNextDynamicReturnTypeExtension.php� ^�g� * E� A src/Type/Php/GetParentClassDynamicFunctionReturnTypeExtension.php� ^�g� �#hŤ ) src/Type/Php/AssertThrowTypeExtension.php$ ^�g$ M��� A src/Type/Php/SimpleXMLElementClassPropertyReflectionExtension.php� ^�g� ?@� > src/Type/Php/ArraySearchFunctionDynamicReturnTypeExtension.php& ^�g& O� � : src/Type/Php/GetDefinedVarsFunctionReturnTypeExtension.php� ^�g� �{�� : src/Type/Php/CtypeDigitFunctionTypeSpecifyingExtension.php� ^�g� ��W � ' src/Type/Php/RegexArrayShapeMatcher.php�D ^�g�D ��� 6 src/Type/Php/AbsFunctionDynamicReturnTypeExtension.php� ^�g� ��D� 5 src/Type/Php/ArrayFindFunctionReturnTypeExtension.php3 ^�g3 �S�� 7 src/Type/Php/IsArrayFunctionTypeSpecifyingExtension.php� ^�g� �$Ұ� 6 src/Type/Php/FilterInputDynamicReturnTypeExtension.php� ^�g� ^(�Ȥ 1 src/Type/Php/XMLReaderOpenReturnTypeExtension.php� ^�g� �h� ; src/Type/Php/NonEmptyStringFunctionsReturnTypeExtension.php ^�g cQK�� : src/Type/Php/ExplodeFunctionDynamicReturnTypeExtension.php� ^�g� f�*�� @ src/Type/Php/ReflectionPropertyConstructorThrowTypeExtension.php� ^�g� ��� ' src/Type/Php/JsonThrowTypeExtension.phpN ^�gN D+�2� 2 src/Type/Php/StrPadFunctionReturnTypeExtension.php) ^�g) �ap� 2 src/Type/Php/DateTimeModifyReturnTypeExtension.php9 ^�g9 �w�� src/Type/Php/ConstantHelper.phpZ ^�gZ t�9� = src/Type/Php/ReflectionClassConstructorThrowTypeExtension.php& ^�g& �9��� 6 src/Type/Php/PregFilterFunctionReturnTypeExtension.php� ^�g� ���|� / src/Type/Php/StatDynamicReturnTypeExtension.phpn ^�gn ڤPD� 5 src/Type/Php/StrtotimeFunctionReturnTypeExtension.php� ^�g� 1�)S� 3 src/Type/Php/CompactFunctionReturnTypeExtension.phpt ^�gt b�j� ) src/Type/Php/IntdivThrowTypeExtension.phpg ^�gg C��� ? src/Type/Php/NumberFormatFunctionDynamicReturnTypeExtension.php ^�g � vQ� 5 src/Type/Php/StrRepeatFunctionReturnTypeExtension.php� ^�g� h��m� 6 src/Type/Php/BcMathStringOrNullReturnTypeExtension.phpj( ^�gj( WY<Y� 3 src/Type/Php/DateTimeDynamicReturnTypeExtension.php; ^�g; 0��0� 9 src/Type/Php/DateTimeCreateDynamicReturnTypeExtension.php. ^�g. �(1[� 3 src/Type/Php/IsAFunctionTypeSpecifyingExtension.php6 ^�g6 r��ä 4 src/Type/Php/StrSplitFunctionReturnTypeExtension.php� ^�g� *��� 7 src/Type/Php/TrimFunctionDynamicReturnTypeExtension.php� ^�g� �v�� : src/Type/Php/DateIntervalConstructorThrowTypeExtension.php� ^�g� �P47� 9 src/Type/Php/ArrayFillKeysFunctionReturnTypeExtension.phpF ^�gF C�l � : src/Type/Php/HighlightStringDynamicReturnTypeExtension.php ^�g �k8�� B src/Type/Php/TypeSpecifyingFunctionsDynamicReturnTypeExtension.php/ ^�g/ ⩏�� 8 src/Type/Php/ArrayCombineFunctionReturnTypeExtension.php^ ^�g^ ��¤ 1 src/Type/Php/RangeFunctionReturnTypeExtension.php5 ^�g5 � �� 1 src/Type/Php/LtrimFunctionReturnTypeExtension.php[ ^�g[ IL�ɤ 4 src/Type/Php/PregSplitDynamicReturnTypeExtension.phps ^�gs ��� 9 src/Type/Php/ArgumentBasedFunctionReturnTypeExtension.php ^�g �x�� 5 src/Type/Php/StrContainingTypeSpecifyingExtension.phpv ^�gv �T�� A src/Type/Php/VersionCompareFunctionDynamicReturnTypeExtension.php� ^�g� �� � ? src/Type/Php/Base64DecodeDynamicFunctionReturnTypeExtension.php� ^�g� gR� A src/Type/Php/ReflectionGetAttributesMethodReturnTypeExtension.php� ^�g� -rJ� 8 src/Type/Php/ArrayReverseFunctionReturnTypeExtension.php� ^�g� ��"ˤ 5 src/Type/Php/RandomIntFunctionReturnTypeExtension.php� ^�g� 4+� 7 src/Type/Php/ArrayFilterFunctionReturnTypeExtension.php ^�g o�v�� 4 src/Type/Php/StrCaseFunctionsReturnTypeExtension.php� ^�g� ]�0� ; src/Type/Php/ClassExistsFunctionTypeSpecifyingExtension.php� ^�g� � j� 8 src/Type/Php/ArrayKeyFirstDynamicReturnTypeExtension.php� ^�g� �y�Z� 9 src/Type/Php/FilterVarArrayDynamicReturnTypeExtension.php� ^�g� Gv�� @ src/Type/Php/ReflectionFunctionConstructorThrowTypeExtension.phpj ^�gj ���2� 7 src/Type/Php/DateIntervalDynamicReturnTypeExtension.php� ^�g� qM>� 4 src/Type/Php/ArrayPopFunctionReturnTypeExtension.php� ^�g� ��Ƥ 6 src/Type/Php/DateFormatFunctionReturnTypeExtension.php� ^�g� ¥Cs� ; src/Type/Php/ArraySumFunctionDynamicReturnTypeExtension.php� ^�g� �VN�� 7 src/Type/Php/ArrayCurrentDynamicReturnTypeExtension.php� ^�g� 7���� 4 src/Type/Php/MbFunctionsReturnTypeExtensionTrait.php� ^�g� o% 9� 7 src/Type/Php/ArrayKeyLastDynamicReturnTypeExtension.php� ^�g� �?y�� : src/Type/Php/DioStatDynamicFunctionReturnTypeExtension.php� ^�g� �� � 1 src/Type/Php/PregMatchTypeSpecifyingExtension.php4 ^�g4 �iK� 7 src/Type/Php/InArrayFunctionTypeSpecifyingExtension.phpt ^�gt � �J� 4 src/Type/Php/FilterVarDynamicReturnTypeExtension.php� ^�g� 7��!� 7 src/Type/Php/SetTypeFunctionTypeSpecifyingExtension.php; ^�g; G� � 9 src/Type/Php/SscanfFunctionDynamicReturnTypeExtension.phpg ^�gg n�s� 3 src/Type/Php/ArrayKeyDynamicReturnTypeExtension.php� ^�g� *1�=� 4 src/Type/Php/DateFormatMethodReturnTypeExtension.php& ^�g& �9Ӥ 4 src/Type/Php/MethodExistsTypeSpecifyingExtension.php� ^�g� ̓�9� ? src/Type/Php/SimpleXMLElementAsXMLMethodReturnTypeExtension.php; ^�g; OX-� 8 src/Type/Php/ClosureBindToDynamicReturnTypeExtension.php� ^�g� ���� : src/Type/Php/DateTimeZoneConstructorThrowTypeExtension.php� ^�g� z�Z� 1 src/Type/Php/RoundFunctionReturnTypeExtension.php� ^�g� �Mcw� : src/Type/Php/IsIterableFunctionTypeSpecifyingExtension.php. ^�g. R�3�� ? src/Type/Php/GettimeofdayDynamicFunctionReturnTypeExtension.phpJ ^�gJ �R>� A src/Type/Php/StrIncrementDecrementFunctionReturnTypeExtension.php� ^�g� ��*Z� 6 src/Type/Php/DefineConstantTypeSpecifyingExtension.php� ^�g� �^�� > src/Type/Php/SimpleXMLElementConstructorThrowTypeExtension.phpw ^�gw t�Zˤ 5 src/Type/Php/ArrayFlipFunctionReturnTypeExtension.php ^�g V�Q� > src/Type/Php/FunctionExistsFunctionTypeSpecifyingExtension.phpA ^�gA � � � 7 src/Type/Php/DateTimeModifyMethodThrowTypeExtension.php� ^�g� ��1-� > src/Type/Php/ReflectionMethodConstructorThrowTypeExtension.php} ^�g} �*Τ 2 src/Type/Php/StrTokFunctionReturnTypeExtension.php� ^�g� �"r� 1 src/Type/Php/HashFunctionsReturnTypeExtension.php@ ^�g@ ��"D� 5 src/Type/Php/ArrayRandFunctionReturnTypeExtension.php! ^�g! �`� 6 src/Type/Php/DateTimeConstructorThrowTypeExtension.php ^�g �� 4 src/Type/Php/ArrayFilterFunctionReturnTypeHelper.php1 ^�g1 ! �K� 4 src/Type/Php/DateTimeSubMethodThrowTypeExtension.php ^�g � �դ 9 src/Type/Php/GetCalledClassDynamicReturnTypeExtension.php� ^�g� ��*� 0 src/Type/Php/DateFunctionReturnTypeExtension.php� ^�g� �DԤ ; src/Type/Php/PathinfoFunctionDynamicReturnTypeExtension.php ^�g U�� 6 src/Type/Php/PropertyExistsTypeSpecifyingExtension.php ^�g �/m�� 7 src/Type/Php/TriggerErrorDynamicReturnTypeExtension.php� ^�g� �q��� 8 src/Type/Php/PregReplaceCallbackClosureTypeExtension.php� ^�g� �� �� < src/Type/Php/IsSubclassOfFunctionTypeSpecifyingExtension.php� ^�g� ��� 3 src/Type/Php/GettypeFunctionReturnTypeExtension.phpF ^�gF 1�Ŗ� 5 src/Type/Php/DsMapDynamicMethodThrowTypeExtension.php� ^�g� � fS� > src/Type/Php/ArrayChangeKeyCaseFunctionReturnTypeExtension.php� ^�g� y-l� 8 src/Type/Php/GetDebugTypeFunctionReturnTypeExtension.php� ^�g� �L��� : src/Type/Php/IsCallableFunctionTypeSpecifyingExtension.php� ^�g� {`�֤ * src/Type/Php/IniGetReturnTypeExtension.php� ^�g� �W�N� ; src/Type/Php/ArraySearchFunctionTypeSpecifyingExtension.phpH ^�gH ��kԤ : src/Type/Php/SprintfFunctionDynamicReturnTypeExtension.php�0 ^�g�0 ���A� 6 src/Type/Php/AssertFunctionTypeSpecifyingExtension.php� ^�g� &�f�� 4 src/Type/Php/ArrayMapFunctionReturnTypeExtension.phpm ^�gm va� ? src/Type/Php/BackedEnumFromMethodDynamicReturnTypeExtension.phpz ^�gz ��� � @ src/Type/Php/ArrayPointerFunctionsDynamicReturnTypeExtension.php� ^�g� u�C� 7 src/Type/Php/ArrayReduceFunctionReturnTypeExtension.php� ^�g� ��{u� ? src/Type/Php/StrWordCountFunctionDynamicReturnTypeExtension.php$ ^�g$ ��|4� 1 src/Type/Php/SubstrDynamicReturnTypeExtension.phpo ^�go �f�ڤ = src/Type/Php/ArrayMergeFunctionDynamicReturnTypeExtension.php� ^�g� l�Ӥ 9 src/Type/Php/DatePeriodConstructorReturnTypeExtension.php$ ^�g$ �mFܤ 8 src/Type/Php/ArrayFindKeyFunctionReturnTypeExtension.php+ ^�g+ *��"� ? src/Type/Php/SimpleXMLElementXpathMethodReturnTypeExtension.php� ^�g� Y?/�� > src/Type/Php/CurlGetinfoFunctionDynamicReturnTypeExtension.php� ^�g� �x�!� 8 src/Type/Php/ArrayReplaceFunctionReturnTypeExtension.php� ^�g� ,�#�� > src/Type/Php/ArrayKeyExistsFunctionTypeSpecifyingExtension.phpf ^�gf ����� 7 src/Type/Php/ArraySpliceFunctionReturnTypeExtension.php� ^�g� �n� 7 src/Type/Php/DefinedConstantTypeSpecifyingExtension.php� ^�g� Ӱ�� 4 src/Type/Php/ConstantFunctionReturnTypeExtension.php ^�g �� Ԥ ; src/Type/Php/ClassImplementsFunctionReturnTypeExtension.php{ ^�g{ �c%w� ; src/Type/Php/ParseUrlFunctionDynamicReturnTypeExtension.php� ^�g� �Ή� = src/Type/Php/MbConvertEncodingFunctionReturnTypeExtension.php� ^�g� � ��� 8 src/Type/Php/StrvalFamilyFunctionReturnTypeExtension.php� ^�g� ��а� 2 src/Type/Php/HrtimeFunctionReturnTypeExtension.php� ^�g� ��� 3 src/Type/Php/GetClassDynamicReturnTypeExtension.php% ^�g% wϡ�� - src/Type/Php/DateFunctionReturnTypeHelper.php� ^�g� c�� 5 src/Type/Php/ArrayFillFunctionReturnTypeExtension.php) ^�g) �b�� - src/Type/Php/ThrowableReturnTypeExtension.php� ^�g� s��� < src/Type/Php/ArrayKeysFunctionDynamicReturnTypeExtension.php: ^�g: 0 ~� 2 src/Type/Php/ParseStrParameterOutTypeExtension.php� ^�g� �Ǭ� 0 src/Type/Php/IsAFunctionTypeSpecifyingHelper.php ^�g 2ζ� src/Type/SubtractableType.php� ^�g� ���� / src/Type/DynamicReturnTypeExtensionRegistry.php� ^�g� �n&�� src/Type/CompoundType.php ^�g U���� src/Type/TypeWithClassName.php\ ^�g\ '��ܤ src/Type/CallableTypeHelper.php� ^�g� "T�ʤ src/Type/TypeCombinator.php�� ^�g�� M]� src/Type/ConstantScalarType.php� ^�g� )Y� / src/Type/DynamicFunctionReturnTypeExtension.php~ ^�g~ ���� src/Type/FloatType.php� ^�g� j:�� src/Type/TypehintHelper.php@% ^�g@% /Rb�� src/Type/IsSuperTypeOfResult.phpV ^�gV �0\� ( src/Type/Accessory/NonEmptyArrayType.php�+ ^�g�+ ��դ 3 src/Type/Accessory/AccessoryLowercaseStringType.phpo$ ^�go$ ����� ) src/Type/Accessory/HasOffsetValueType.php-5 ^�g-5 |�2� 3 src/Type/Accessory/AccessoryUppercaseStringType.phpo$ ^�go$ ��o � 1 src/Type/Accessory/AccessoryLiteralStringType.php�$ ^�g�$ d �T� ) src/Type/Accessory/OversizedArrayType.phpk* ^�gk* T%aӤ $ src/Type/Accessory/AccessoryType.php� ^�g� ;ʠ� - src/Type/Accessory/AccessoryArrayListType.php10 ^�g10 ��4�� $ src/Type/Accessory/HasOffsetType.phpO, ^�gO, �) 9� 2 src/Type/Accessory/AccessoryNonFalsyStringType.php'$ ^�g'$ �!f� 1 src/Type/Accessory/AccessoryNumericStringType.phpA% ^�gA% ���c� & src/Type/Accessory/HasPropertyType.php� ^�g� Ȩ`�� $ src/Type/Accessory/HasMethodType.php ^�g ��ǚ� 2 src/Type/Accessory/AccessoryNonEmptyStringType.php�% ^�g�% �[4� src/Type/ThisType.php? ^�g? w�-� src/Type/ObjectShapeType.php�G ^�g�G �a�� ' src/Type/CircularTypeAliasErrorType.php� ^�g� [}��� 2 src/Type/DynamicStaticMethodThrowTypeExtension.php� ^�g� � �� 2 src/Type/FunctionParameterClosureTypeExtension.php� ^�g� _��� ( src/Type/ConditionalTypeForParameter.php� ^�g� ���Τ src/Type/AcceptsResult.php� ^�g� x|�w� src/Type/ConditionalType.php� ^�g� ��� , src/Type/DynamicMethodThrowTypeExtension.phpg ^�gg �ޭ^� % src/Broker/ClassNotFoundException.php� ^�g� �^zߤ ( src/Broker/FunctionNotFoundException.php� ^�g� r� �� ( src/Broker/ConstantNotFoundException.php� ^�g� �cH� src/Broker/Broker.php ^�g &��� ( src/Broker/ClassAutoloadingException.php� ^�g� !u�V� ' src/Broker/AnonymousClassNameHelper.php� ^�g� k�0<� src/Broker/BrokerFactory.php� ^�g� 6QΗ� src/Php/PhpVersion.php+" ^�g+" P\�� $ src/Php/PhpVersionFactoryFactory.php� ^�g� p��� src/Php/PhpVersionFactory.php� ^�g� ^ �Ф src/Node/NoopExpressionNode.php� ^�g� ���5� src/Node/InClosureNode.php) ^�g) �{9S� src/Node/ReturnStatement.php ^�g �쏿� src/Node/InTraitNode.phpy ^�gy �@� src/Node/IssetExpr.php� ^�g� -�n� # src/Node/MatchExpressionArmBody.php3 ^�g3 ƶ3� src/Node/MatchExpressionArm.php� ^�g� �t� % src/Node/UnreachableStatementNode.php ^�g ���� src/Node/ClassPropertiesNode.phpY@ ^�gY@ ��ɤ src/Node/AnonymousClassNode.php� ^�g� bɫ�� , src/Node/VarTagChangedExpressionTypeNode.php� ^�g� �4/�� src/Node/InFunctionNode.php� ^�g� �_� � % src/Node/StaticMethodCallableNode.php; ^�g; )3E0� src/Node/VirtualNode.php� ^�g� �@�Ϥ src/Node/InClassMethodNode.php� ^�g� �ܤ src/Node/ClassMethodsNode.php� ^�g� j�W� # src/Node/Property/PropertyWrite.php ^�g }�� " src/Node/Property/PropertyRead.php ^�g W� �� $ src/Node/Property/PropertyAssign.phpr ^�gr � � ( src/Node/MatchExpressionArmCondition.php� ^�g� & +�� src/Node/ExecutionEndNode.php ^�g �7�6� src/Node/BooleanOrNode.php� ^�g� *�k� $ src/Node/ClassStatementsGatherer.php�# ^�g�# ��� src/Node/BooleanAndNode.php� ^�g� 7�cJ� src/Node/ClassPropertyNode.php� ^�g� ���2� src/Node/MatchExpressionNode.php ^�g �ذ0� ) src/Node/FunctionReturnStatementsNode.php� ^�g� �4�� ! src/Node/FunctionCallableNode.php ^�g ;�� % src/Node/DoWhileLoopConditionNode.php< ^�g< �{ o� src/Node/PropertyAssignNode.phpN ^�gN � J� src/Node/Printer/Printer.php� ^�g� �$��� src/Node/Printer/ExprPrinter.php� ^�g� WԝΤ $ src/Node/Printer/NodeTypePrinter.php� ^�g� ��w9� " src/Node/FinallyExitPointsNode.php ^�g @�q{� ! src/Node/ReturnStatementsNode.phpo ^�go �7��� & src/Node/InstantiationCallableNode.php ^�g ~��#� , src/Node/Expr/PropertyInitializationExpr.php� ^�g� l�֤ ( src/Node/Expr/GetIterableKeyTypeExpr.php� ^�g� Wm2B� & src/Node/Expr/AlwaysRememberedExpr.php. ^�g. w~(�� ' src/Node/Expr/ExistingArrayDimFetch.php2 ^�g2 �� * src/Node/Expr/OriginalPropertyTypeExpr.php� ^�g� �� � 0 src/Node/Expr/SetExistingOffsetValueTypeExpr.php� ^�g� f�6�� * src/Node/Expr/GetIterableValueTypeExpr.php� ^�g� � &� ( src/Node/Expr/SetOffsetValueTypeExpr.php� ^�g� ��6�� src/Node/Expr/TypeExpr.php� ^�g� �gä 4 src/Node/Expr/ParameterVariableOriginalValueExpr.php� ^�g� DH� ( src/Node/Expr/GetOffsetValueTypeExpr.php4 ^�g4 �%7� ! src/Node/Expr/UnsetOffsetExpr.php& ^�g& W�c� src/Node/CollectedDataNode.php� ^�g� �ß� ( src/Node/Constant/ClassConstantFetch.phpi ^�gi ���� src/Node/LiteralArrayNode.php~ ^�g~ 9�/r� + src/Node/CatchWithUnthrownExceptionNode.php ^�g ���G� src/Node/MethodCallableNode.php� ^�g� �o�o� src/Node/ClassConstantsNode.php� ^�g� "�hä src/Node/InvalidateExprNode.php� ^�g� �� �� src/Node/FileNode.phpP ^�gP �Q�� src/Node/LiteralArrayItem.phpg ^�gg %k� src/Node/VariableAssignNode.php� ^�g� �� � ( src/Node/ClosureReturnStatementsNode.php� ^�g� �\��� src/Node/InForeachNode.php� ^�g� Sq�G� src/Node/InArrowFunctionNode.phpW ^�gW ��E<� src/Node/Method/MethodCall.php ^�g �[��� # src/Node/BreaklessWhileLoopNode.php� ^�g� �F� ' src/Node/MethodReturnStatementsNode.php� ^�g� �cˌ� src/Node/ClassMethod.phpO ^�gO -e(7� src/Node/InClassNode.php2 ^�g2 b� X� + src/Classes/ForbiddenClassNameExtension.phpL ^�gL }�ж� conf/config.levelmax.neon! ^�g! � h� conf/config.level2.neon� ^�g� ��<� conf/config.level7.neonY ^�gY ^b�Z� conf/config.level6.neon� ^�g� ?��~� conf/config.level8.neonD ^�gD s�Jc� conf/parametersSchema.neon� ^�g� ��9A� conf/config.level4.neon�- ^�g�- 'ϟ � conf/config.level9.neonH ^�gH �u�� conf/config.level1.neon� ^�g� �?�$� conf/config.level3.neonF ^�gF ��D~� conf/config.level5.neonB ^�gB ��O'� conf/config.neon�� ^�g�� �� conf/config.level0.neonp+ ^�gp+ U�f(� conf/bleedingEdge.neon� ^�g� ��D� conf/config.stubValidator.neon- ^�g- ��k� $ resources/functionMap_php80delta.php�i ^�g�i P�� resources/RegexGrammar.pp� ^�g� �7?y� $ resources/functionMap_php83delta.php� ^�g� *��K� $ resources/functionMap_php84delta.php ^�g W� � resources/functionMetadata.php[ ^�g[ >I� $ resources/functionMap_php74delta.php5 ^�g5 � ��� 1 resources/functionMap_php80delta_bleedingEdge.php� ^�g� ��W� $ resources/functionMap_php82delta.php� ^�g� �)F� resources/functionMap.php�v ^�g�v ���� & resources/functionMap_bleedingEdge.phpHL ^�gHL �=�F� $ resources/functionMap_php81delta.php� ^�g� ��¤ preload.phpF� ^�gF� "d]�� vendor/autoload.php ^�g ��n� - vendor/ondrejmirtes/better-reflection/LICENSE6 ^�g6 Ww� � C vendor/ondrejmirtes/better-reflection/src/Identifier/Identifier.php� ^�g� qb!�� X vendor/ondrejmirtes/better-reflection/src/Identifier/Exception/InvalidIdentifierName.phpe ^�ge �ZJ� G vendor/ondrejmirtes/better-reflection/src/Identifier/IdentifierType.php� ^�g� ��lޤ W vendor/ondrejmirtes/better-reflection/src/SourceLocator/Located/EvaledLocatedSource.php4 ^�g4 {rj� Z vendor/ondrejmirtes/better-reflection/src/SourceLocator/Located/AnonymousLocatedSource.phpt ^�gt �m � Q vendor/ondrejmirtes/better-reflection/src/SourceLocator/Located/LocatedSource.php ^�g SΤ Y vendor/ondrejmirtes/better-reflection/src/SourceLocator/Located/InternalLocatedSource.php ^�g ��z�� V vendor/ondrejmirtes/better-reflection/src/SourceLocator/Located/AliasLocatedSource.phpO ^�gO ����� G vendor/ondrejmirtes/better-reflection/src/SourceLocator/Ast/Locator.php( ^�g( ���a� U vendor/ondrejmirtes/better-reflection/src/SourceLocator/Ast/FindReflectionsInTree.php0 ^�g0 d �� [ vendor/ondrejmirtes/better-reflection/src/SourceLocator/Ast/Exception/ParseToAstFailure.php� ^�g� J�:�� V vendor/ondrejmirtes/better-reflection/src/SourceLocator/Ast/Parser/MemoizingParser.php� ^�g� g� �� ^ vendor/ondrejmirtes/better-reflection/src/SourceLocator/Ast/Strategy/AstConversionStrategy.php� ^�g� �Ϝ� Y vendor/ondrejmirtes/better-reflection/src/SourceLocator/Ast/Strategy/NodeToReflection.php� ^�g� |~�� \ vendor/ondrejmirtes/better-reflection/src/SourceLocator/Exception/NoAnonymousClassOnLine.php ^�g �\� V vendor/ondrejmirtes/better-reflection/src/SourceLocator/Exception/NotInternalClass.php� ^�g� �zׯ� [ vendor/ondrejmirtes/better-reflection/src/SourceLocator/Exception/TwoClosuresOnSameLine.phpr ^�gr �� Ӥ i vendor/ondrejmirtes/better-reflection/src/SourceLocator/Exception/EvaledAnonymousClassCannotBeLocated.php3 ^�g3 �6Ǯ� U vendor/ondrejmirtes/better-reflection/src/SourceLocator/Exception/InvalidFileInfo.php+ ^�g+ J"�� Y vendor/ondrejmirtes/better-reflection/src/SourceLocator/Exception/InvalidFileLocation.php� ^�g� ����� U vendor/ondrejmirtes/better-reflection/src/SourceLocator/Exception/NoClosureOnLine.phpp ^�gp ��G� W vendor/ondrejmirtes/better-reflection/src/SourceLocator/Exception/FunctionUndefined.phpV ^�gV N0� � V vendor/ondrejmirtes/better-reflection/src/SourceLocator/Exception/InvalidDirectory.php� ^�g� �d�T� c vendor/ondrejmirtes/better-reflection/src/SourceLocator/Exception/TwoAnonymousClassesOnSameLine.php� ^�g� M/��� b vendor/ondrejmirtes/better-reflection/src/SourceLocator/Exception/EvaledClosureCannotBeLocated.php$ ^�g$ d�Ϥ G vendor/ondrejmirtes/better-reflection/src/SourceLocator/FileChecker.php� ^�g� )��M� X vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/SingleFileSourceLocator.phpT ^�gT zE{G� W vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/AggregateSourceLocator.php ^�g �H��� X vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/EvaledCodeSourceLocator.php� ^�g� W��v� p vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/AutoloadSourceLocator/FileReadTrapStreamWrapper.php~ ^�g~ ��J`� Z vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/FileIteratorSourceLocator.php ^�g ʑqW� ^ vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/Composer/PsrAutoloaderLocator.php� ^�g� X4 m� | vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/Composer/Factory/MakeLocatorForComposerJsonAndInstalledJson.phpo ^�go :��� e vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/Composer/Factory/Exception/Exception.php� ^�g� �Z�\� o vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/Composer/Factory/Exception/MissingComposerJson.php� ^�g� �T_ʤ p vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/Composer/Factory/Exception/MissingInstalledJson.php� ^�g� ��"o� m vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/Composer/Factory/Exception/FailedToParseJson.php� ^�g� '�<�� s vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/Composer/Factory/Exception/InvalidProjectDirectory.php� ^�g� �!4l� l vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/Composer/Factory/MakeLocatorForComposerJson.php ^�g ��L+� m vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/Composer/Factory/MakeLocatorForInstalledJson.php� ^�g� �#@� a vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/Composer/Psr/Exception/Exception.php� ^�g� �� l vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/Composer/Psr/Exception/InvalidPrefixMapping.phps ^�gs � Y vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/Composer/Psr/Psr4Mapping.php ^�g ���� b vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/Composer/Psr/PsrAutoloaderMapping.phpv ^�gv ��'֤ Y vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/Composer/Psr/Psr0Mapping.phpG ^�gG �'�e� Y vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/PhpInternalSourceLocator.php2 ^�g2 ��� T vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/StringSourceLocator.php1 ^�g1 <>�٤ Y vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/DirectoriesSourceLocator.php� ^�g� 8QvY� V vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/AutoloadSourceLocator.php�. ^�g�. ��yS� U vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/ClosureSourceLocator.php} ^�g} M$�Ф V vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/ComposerSourceLocator.php� ^�g� �Ҥ V vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/AbstractSourceLocator.php= ^�g= �*��� W vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/MemoizingSourceLocator.php� ^�g� _��ۤ N vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/SourceLocator.php+ ^�g+ C�=� b vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/AnonymousClassObjectSourceLocator.phpD ^�gD �Nw� W vendor/ondrejmirtes/better-reflection/src/SourceLocator/SourceStubber/SourceStubber.php� ^�g� �ϭ� m vendor/ondrejmirtes/better-reflection/src/SourceLocator/SourceStubber/Exception/CouldNotFindPhpStormStubs.php0 ^�g0 ��~�� a vendor/ondrejmirtes/better-reflection/src/SourceLocator/SourceStubber/ReflectionSourceStubber.php(z ^�g(z ��Bw� f vendor/ondrejmirtes/better-reflection/src/SourceLocator/SourceStubber/PhpStormStubs/CachingVisitor.phpt ^�gt ���� d vendor/ondrejmirtes/better-reflection/src/SourceLocator/SourceStubber/PhpStormStubsSourceStubber.php�| ^�g�| ��ɤ R vendor/ondrejmirtes/better-reflection/src/SourceLocator/SourceStubber/StubData.php� ^�g� ��$դ ` vendor/ondrejmirtes/better-reflection/src/SourceLocator/SourceStubber/AggregateSourceStubber.php ^�g ��)�� G vendor/ondrejmirtes/better-reflection/src/Reflection/ReflectionType.phpV ^�gV = �a� L vendor/ondrejmirtes/better-reflection/src/Reflection/ReflectionAttribute.php� ^�g� ��Ĥ \ vendor/ondrejmirtes/better-reflection/src/Reflection/Attribute/ReflectionAttributeHelper.php3 ^�g3 K� �� O vendor/ondrejmirtes/better-reflection/src/Reflection/Adapter/ReflectionType.php� ^�g� Rc/F� T vendor/ondrejmirtes/better-reflection/src/Reflection/Adapter/ReflectionAttribute.php ^�g �C,�� Y vendor/ondrejmirtes/better-reflection/src/Reflection/Adapter/ReflectionEnumBackedCase.php� ^�g� �M C� O vendor/ondrejmirtes/better-reflection/src/Reflection/Adapter/ReflectionEnum.phpSK ^�gSK ��W�� [ vendor/ondrejmirtes/better-reflection/src/Reflection/Adapter/ReflectionIntersectionType.php1 ^�g1 �{w�� T vendor/ondrejmirtes/better-reflection/src/Reflection/Adapter/ReflectionParameter.phpt# ^�gt# �.��� P vendor/ondrejmirtes/better-reflection/src/Reflection/Adapter/ReflectionClass.php!U ^�g!U ��>X� X vendor/ondrejmirtes/better-reflection/src/Reflection/Adapter/ReflectionClassConstant.phph ^�gh ̬!� Q vendor/ondrejmirtes/better-reflection/src/Reflection/Adapter/ReflectionMethod.phpV- ^�gV- S <� W vendor/ondrejmirtes/better-reflection/src/Reflection/Adapter/ReflectionEnumUnitCase.php� ^�g� 1?�~� S vendor/ondrejmirtes/better-reflection/src/Reflection/Adapter/ReflectionFunction.php\" ^�g\" �Ma�� Y vendor/ondrejmirtes/better-reflection/src/Reflection/Adapter/Exception/NotImplemented.php� ^�g� IRe� T vendor/ondrejmirtes/better-reflection/src/Reflection/Adapter/ReflectionUnionType.php ^�g |��� X vendor/ondrejmirtes/better-reflection/src/Reflection/Adapter/FakeReflectionAttribute.php� ^�g� �r � Q vendor/ondrejmirtes/better-reflection/src/Reflection/Adapter/ReflectionObject.phprG ^�grG ��e�� T vendor/ondrejmirtes/better-reflection/src/Reflection/Adapter/ReflectionNamedType.php� ^�g� ��SN� S vendor/ondrejmirtes/better-reflection/src/Reflection/Adapter/ReflectionProperty.php ^�g ���u� [ vendor/ondrejmirtes/better-reflection/src/Reflection/Adapter/ReflectionAttributeFactory.php6 ^�g6 ��� C vendor/ondrejmirtes/better-reflection/src/Reflection/Reflection.php� ^�g� RuK� G vendor/ondrejmirtes/better-reflection/src/Reflection/ReflectionEnum.phpj ^�gj 2�� S vendor/ondrejmirtes/better-reflection/src/Reflection/ReflectionIntersectionType.php� ^�g� ����� T vendor/ondrejmirtes/better-reflection/src/Reflection/Annotation/AnnotationHelper.php2 ^�g2 i� ˤ K vendor/ondrejmirtes/better-reflection/src/Reflection/ReflectionEnumCase.php� ^�g� =�'� L vendor/ondrejmirtes/better-reflection/src/Reflection/ReflectionParameter.php?E ^�g?E � �I� H vendor/ondrejmirtes/better-reflection/src/Reflection/ReflectionClass.php�� ^�g�� � Z� P vendor/ondrejmirtes/better-reflection/src/Reflection/ReflectionClassConstant.php�) ^�g�) a xפ I vendor/ondrejmirtes/better-reflection/src/Reflection/ReflectionMethod.php�= ^�g�= ��<7� K vendor/ondrejmirtes/better-reflection/src/Reflection/ReflectionFunction.php� ^�g� �CԤ N vendor/ondrejmirtes/better-reflection/src/Reflection/Exception/NotAnObject.php� ^�g� � T vendor/ondrejmirtes/better-reflection/src/Reflection/Exception/CircularReference.phpm ^�gm "� V vendor/ondrejmirtes/better-reflection/src/Reflection/Exception/PropertyIsNotStatic.php[ ^�g[ ��� Z vendor/ondrejmirtes/better-reflection/src/Reflection/Exception/MethodPrototypeNotFound.php� ^�g� 2�7V� W vendor/ondrejmirtes/better-reflection/src/Reflection/Exception/PropertyDoesNotExist.php] ^�g] /7i[� S vendor/ondrejmirtes/better-reflection/src/Reflection/Exception/NoObjectProvided.php ^�g �/�� W vendor/ondrejmirtes/better-reflection/src/Reflection/Exception/FunctionDoesNotExist.php{ ^�g{ ��c�� V vendor/ondrejmirtes/better-reflection/src/Reflection/Exception/CodeLocationMissing.php ^�g ���� V vendor/ondrejmirtes/better-reflection/src/Reflection/Exception/InvalidConstantNode.php ^�g � [ vendor/ondrejmirtes/better-reflection/src/Reflection/Exception/ObjectNotInstanceOfClass.phpx ^�gx ��w� K vendor/ondrejmirtes/better-reflection/src/Reflection/Exception/NoParent.php� ^�g� �ߤ T vendor/ondrejmirtes/better-reflection/src/Reflection/Exception/ClassDoesNotExist.php� ^�g� ��n� _ vendor/ondrejmirtes/better-reflection/src/Reflection/Exception/InvalidArrowFunctionBodyNode.php, ^�g, �pJͤ Z vendor/ondrejmirtes/better-reflection/src/Reflection/Exception/InvalidDefaultValueType.php� ^�g� �udB� ` vendor/ondrejmirtes/better-reflection/src/Reflection/StringCast/ReflectionPropertyStringCast.phpJ ^�gJ ��/�� ` vendor/ondrejmirtes/better-reflection/src/Reflection/StringCast/ReflectionFunctionStringCast.php ^�g F[3�� a vendor/ondrejmirtes/better-reflection/src/Reflection/StringCast/ReflectionParameterStringCast.phpe ^�ge *�� ` vendor/ondrejmirtes/better-reflection/src/Reflection/StringCast/ReflectionConstantStringCast.php� ^�g� p���� a vendor/ondrejmirtes/better-reflection/src/Reflection/StringCast/ReflectionAttributeStringCast.phpW ^�gW h��W� ] vendor/ondrejmirtes/better-reflection/src/Reflection/StringCast/ReflectionClassStringCast.php(# ^�g(# �U��� \ vendor/ondrejmirtes/better-reflection/src/Reflection/StringCast/ReflectionTypeStringCast.php: ^�g: l1τ� e vendor/ondrejmirtes/better-reflection/src/Reflection/StringCast/ReflectionClassConstantStringCast.php� ^�g� m��4� ^ vendor/ondrejmirtes/better-reflection/src/Reflection/StringCast/ReflectionMethodStringCast.phpy ^�gy ��+� ` vendor/ondrejmirtes/better-reflection/src/Reflection/StringCast/ReflectionEnumCaseStringCast.php ^�g �2^�� L vendor/ondrejmirtes/better-reflection/src/Reflection/ReflectionUnionType.php� ^�g� ��<z� I vendor/ondrejmirtes/better-reflection/src/Reflection/ReflectionObject.php�6 ^�g�6 PB�e� L vendor/ondrejmirtes/better-reflection/src/Reflection/ReflectionNamedType.php. ^�g. �\ڤ S vendor/ondrejmirtes/better-reflection/src/Reflection/ReflectionFunctionAbstract.phpj< ^�gj< ��L�� V vendor/ondrejmirtes/better-reflection/src/Reflection/Support/AlreadyVisitedClasses.php] ^�g] %0�� K vendor/ondrejmirtes/better-reflection/src/Reflection/ReflectionProperty.php"K ^�g"K ��]�� K vendor/ondrejmirtes/better-reflection/src/Reflection/ReflectionConstant.php�' ^�g�' � � I vendor/ondrejmirtes/better-reflection/src/Reflector/ConstantReflector.php� ^�g� ��$E� I vendor/ondrejmirtes/better-reflection/src/Reflector/FunctionReflector.php� ^�g� a�8Ҥ H vendor/ondrejmirtes/better-reflection/src/Reflector/DefaultReflector.php ^�g ��� T vendor/ondrejmirtes/better-reflection/src/Reflector/Exception/IdentifierNotFound.phpL ^�gL ޤ'� A vendor/ondrejmirtes/better-reflection/src/Reflector/Reflector.php ^�g b�y�� F vendor/ondrejmirtes/better-reflection/src/Reflector/ClassReflector.php� ^�g� �E� H vendor/ondrejmirtes/better-reflection/src/Util/ClassExistenceChecker.php{ ^�g{ ���J� G vendor/ondrejmirtes/better-reflection/src/Util/FindReflectionOnLine.php� ^�g� P5�ˤ L vendor/ondrejmirtes/better-reflection/src/Util/CalculateReflectionColumn.php� ^�g� 5�_�� K vendor/ondrejmirtes/better-reflection/src/Util/Exception/NoNodePosition.php� ^�g� $��� P vendor/ondrejmirtes/better-reflection/src/Util/Exception/InvalidNodePosition.phpV ^�gV >U�ݤ F vendor/ondrejmirtes/better-reflection/src/Util/ConstantNodeChecker.php� ^�g� ߸�C� = vendor/ondrejmirtes/better-reflection/src/Util/FileHelper.phpf ^�gf AuL� D vendor/ondrejmirtes/better-reflection/src/Util/GetLastDocComment.php� ^�g� ��t� H vendor/ondrejmirtes/better-reflection/src/NodeCompiler/CompiledValue.php� ^�g� _���� X vendor/ondrejmirtes/better-reflection/src/NodeCompiler/Exception/UnableToCompileNode.php� ^�g� vNҺ� M vendor/ondrejmirtes/better-reflection/src/NodeCompiler/CompileNodeToValue.php�3 ^�g�3 ���T� J vendor/ondrejmirtes/better-reflection/src/NodeCompiler/CompilerContext.php_ ^�g_ Z��W� > vendor/ondrejmirtes/better-reflection/src/BetterReflection.php ^�g JSo3� 3 vendor/ondrejmirtes/better-reflection/renovate.json� ^�g� ��{�� vendor/react/stream/LICENSEu ^�gu �{�� vendor/react/stream/src/Util.php� ^�g� �Z�פ 0 vendor/react/stream/src/DuplexResourceStream.php� ^�g� �S� + vendor/react/stream/src/CompositeStream.phph ^�gh ,s�� 1 vendor/react/stream/src/DuplexStreamInterface.php� ^�g� �{�� 2 vendor/react/stream/src/WritableResourceStream.php ^�g �P�� ) vendor/react/stream/src/ThroughStream.php� ^�g� G��b� 2 vendor/react/stream/src/ReadableResourceStream.php� ^�g� ��kr� 3 vendor/react/stream/src/WritableStreamInterface.php�9 ^�g�9 ��� � 3 vendor/react/stream/src/ReadableStreamInterface.php�7 ^�g�7 �)/�� vendor/react/event-loop/LICENSEu ^�gu �{�� ) vendor/react/event-loop/src/ExtEvLoop.php� ^�g� tT�� - vendor/react/event-loop/src/LoopInterface.php�K ^�g�K ݰ�n� / vendor/react/event-loop/src/ExtLibeventLoop.php�! ^�g�! ,�>� 4 vendor/react/event-loop/src/Tick/FutureTickQueue.php� ^�g� byAO� $ vendor/react/event-loop/src/Loop.php9 ^�g9 k�fO� . vendor/react/event-loop/src/TimerInterface.php� ^�g� ��®� 0 vendor/react/event-loop/src/StreamSelectLoop.php/ ^�g/ &�� , vendor/react/event-loop/src/ExtLibevLoop.php� ^�g� i�o$� + vendor/react/event-loop/src/Timer/Timer.php6 ^�g6 !h�Ȥ , vendor/react/event-loop/src/Timer/Timers.php� ^�g� )��@� . vendor/react/event-loop/src/SignalsHandler.php+ ^�g+ 힂Ӥ ) vendor/react/event-loop/src/ExtUvLoop.php�# ^�g�# �9�ʤ ' vendor/react/event-loop/src/Factory.php< ^�g< 8~<Ԥ , vendor/react/event-loop/src/ExtEventLoop.php� ^�g� '�, � vendor/react/http/LICENSEu ^�gu �{�� $ vendor/react/http/src/HttpServer.php�< ^�g�< 4 �2� vendor/react/http/src/Server.phpF ^�gF �k�Ǥ ' vendor/react/http/src/Client/Client.php� ^�g� +U�t� % vendor/react/http/src/Message/Uri.phpL% ^�gL% ���� / vendor/react/http/src/Message/ServerRequest.php/ ^�g/ �.M � ) vendor/react/http/src/Message/Request.php" ^�g" B1�g� 3 vendor/react/http/src/Message/ResponseException.php� ^�g� �x{¤ * vendor/react/http/src/Message/Response.php}9 ^�g}9 ̴� $ vendor/react/http/src/Io/IniUtil.phps ^�gs ��� , vendor/react/http/src/Io/AbstractMessage.php� ^�g� s�֤ " vendor/react/http/src/Io/Clock.php� ^�g� � �D� , vendor/react/http/src/Io/MultipartParser.php($ ^�g($ /t�� , vendor/react/http/src/Io/AbstractRequest.php� ^�g� �^+�� / vendor/react/http/src/Io/ClientRequestState.php- ^�g- ��� , vendor/react/http/src/Io/EmptyBodyStream.phpH ^�gH �'�� - vendor/react/http/src/Io/MiddlewareRunner.php� ^�g� �q � ) vendor/react/http/src/Io/BufferedBody.php� ^�g� �I� 0 vendor/react/http/src/Io/RequestHeaderParser.php ^�g ;�*̤ 0 vendor/react/http/src/Io/ClientRequestStream.php) ^�g) $��� # vendor/react/http/src/Io/Sender.php� ^�g� d�Ǥ ) vendor/react/http/src/Io/UploadedFile.php� ^�g� W�yJ� ( vendor/react/http/src/Io/Transaction.php�, ^�g�, �6>k� , vendor/react/http/src/Io/StreamingServer.phpQH ^�gQH � � + vendor/react/http/src/Io/ChunkedEncoder.phpQ ^�gQ ��� � 2 vendor/react/http/src/Io/CloseProtectionStream.php6 ^�g6 ;�B � + vendor/react/http/src/Io/HttpBodyStream.php� ^�g� F��� 4 vendor/react/http/src/Io/ClientConnectionManager.php� ^�g� F��� . vendor/react/http/src/Io/PauseBufferStream.php ^�g �:�� + vendor/react/http/src/Io/ChunkedDecoder.php/ ^�g/ TǏy� / vendor/react/http/src/Io/ReadableBodyStream.php ^�g �4ͤ 0 vendor/react/http/src/Io/LengthLimitedStream.php ^�g f& �� ! vendor/react/http/src/Browser.phpN| ^�gN| 7��i� @ vendor/react/http/src/Middleware/RequestBodyBufferMiddleware.php3 ^�g3 &�OL� @ vendor/react/http/src/Middleware/RequestBodyParserMiddleware.php^ ^�g^ ��ڲ� F vendor/react/http/src/Middleware/LimitConcurrentRequestsMiddleware.php� ^�g� K�<&� ? vendor/react/http/src/Middleware/StreamingRequestMiddleware.php/ ^�g/ @}f;� vendor/react/http/PATCHES.txt� ^�g� !=�y� vendor/react/async/LICENSE^ ^�g^ yT � , vendor/react/async/src/functions_include.php� ^�g� ���� $ vendor/react/async/src/functions.php�B ^�g�B BO�[� vendor/react/dns/LICENSEu ^�gu �{�� 0 vendor/react/dns/src/Query/ExecutorInterface.php� ^�g� A�S�� + vendor/react/dns/src/Query/CoopExecutor.php� ^�g� ���`� , vendor/react/dns/src/Query/RetryExecutor.phpK ^�gK -C0Ȥ $ vendor/react/dns/src/Query/Query.php ^�g >w* � 4 vendor/react/dns/src/Query/CancellationException.phpv ^�gv � ��� 9 vendor/react/dns/src/Query/SelectiveTransportExecutor.php ^�g Y=C^� 3 vendor/react/dns/src/Query/TcpTransportExecutor.php�6 ^�g�6 ~Ė�� . vendor/react/dns/src/Query/TimeoutExecutor.php ^�g � � / vendor/react/dns/src/Query/TimeoutException.phpj ^�gj >�� 0 vendor/react/dns/src/Query/HostsFileExecutor.php� ^�g� ���\� . vendor/react/dns/src/Query/CachingExecutor.phpU ^�gU I�� 3 vendor/react/dns/src/Query/UdpTransportExecutor.phph! ^�gh! ��ֹ� / vendor/react/dns/src/Query/FallbackExecutor.php� ^�g� Ļg.� 0 vendor/react/dns/src/RecordNotFoundException.phpk ^�gk �K��� * vendor/react/dns/src/Resolver/Resolver.php ^�g [�� 3 vendor/react/dns/src/Resolver/ResolverInterface.php� ^�g� K�ɤ ) vendor/react/dns/src/Resolver/Factory.php� ^�g� �S:� & vendor/react/dns/src/Model/Message.php� ^�g� a Hפ % vendor/react/dns/src/Model/Record.php� ^�g� ��W!� ( vendor/react/dns/src/Protocol/Parser.php, ^�g, ��M� . vendor/react/dns/src/Protocol/BinaryDumper.phpQ ^�gQ 'n!�� + vendor/react/dns/src/BadServerException.phpf ^�gf ��ä ) vendor/react/dns/src/Config/HostsFile.php� ^�g� ���,� & vendor/react/dns/src/Config/Config.phpK ^�gK �[�?� vendor/react/promise/LICENSEg ^�gg �F� - vendor/react/promise/src/PromiseInterface.phpm ^�gm 3ԇ � 5 vendor/react/promise/src/Internal/RejectedPromise.php� ^�g� ��¢� 7 vendor/react/promise/src/Internal/CancellationQueue.php' ^�g' %u�� 6 vendor/react/promise/src/Internal/FulfilledPromise.phpT ^�gT ?�� % vendor/react/promise/src/Deferred.php% ^�g% �ά٤ 9 vendor/react/promise/src/Exception/CompositeException.phpt ^�gt |�� � 6 vendor/react/promise/src/Exception/LengthException.phpq ^�gq nW� . vendor/react/promise/src/functions_include.php� ^�g� o f� $ vendor/react/promise/src/Promise.php#( ^�g#( ���$� & vendor/react/promise/src/functions.php�, ^�g�, m � vendor/react/cache/LICENSEu ^�gu �{�� % vendor/react/cache/src/ArrayCache.php_ ^�g_ ��i�� ) vendor/react/cache/src/CacheInterface.php0 ^�g0 ��D � " vendor/react/child-process/LICENSEu ^�gu �{�� * vendor/react/child-process/src/Process.php�: ^�g�: OG� vendor/react/socket/LICENSEu ^�gu �{�� $ vendor/react/socket/src/FdServer.php ^�g Ƶk� + vendor/react/socket/src/SecureConnector.phpJ ^�gJ �Kۤ " vendor/react/socket/src/Server.php� ^�g� 6<;#� & vendor/react/socket/src/UnixServer.php� ^�g� ׇƤ * vendor/react/socket/src/LimitingServer.php� ^�g� r�dd� , vendor/react/socket/src/StreamEncryption.php� ^�g� � �j� : vendor/react/socket/src/HappyEyeBallsConnectionBuilder.php�- ^�g�- )��S� - vendor/react/socket/src/FixedUriConnector.php< ^�g< ��G� ) vendor/react/socket/src/UnixConnector.php� ^�g� u�h� + vendor/react/socket/src/ServerInterface.php� ^�g� ��� 2 vendor/react/socket/src/HappyEyeBallsConnector.php� ^�g� ǐ��� . vendor/react/socket/src/ConnectorInterface.php= ^�g= 8 �C� ( vendor/react/socket/src/SecureServer.php ^�g �j@~� / vendor/react/socket/src/ConnectionInterface.phpm ^�gm �2'^� ( vendor/react/socket/src/TcpConnector.php ^�g �� ( vendor/react/socket/src/DnsConnector.php� ^�g� �jiX� , vendor/react/socket/src/TimeoutConnector.phpa ^�ga Q�,�� ( vendor/react/socket/src/SocketServer.php�" ^�g�" �� � % vendor/react/socket/src/TcpServer.php�" ^�g�" C�}�� % vendor/react/socket/src/Connector.php� ^�g� � �+� & vendor/react/socket/src/Connection.php� ^�g� գS� 8 vendor/nette/di/src/DI/Definitions/ServiceDefinition.phpi ^�gi �3o� 9 vendor/nette/di/src/DI/Definitions/AccessorDefinition.php$ ^�g$ ��O� 0 vendor/nette/di/src/DI/Definitions/Statement.php� ^�g� �$�p� 1 vendor/nette/di/src/DI/Definitions/Definition.php' ^�g' � ,� 8 vendor/nette/di/src/DI/Definitions/LocatorDefinition.phpu ^�gu g�c7� 8 vendor/nette/di/src/DI/Definitions/FactoryDefinition.phpG# ^�gG# L�7�� 9 vendor/nette/di/src/DI/Definitions/ImportedDefinition.php ^�g *a�]� 0 vendor/nette/di/src/DI/Definitions/Reference.php� ^�g� ̬KK� # vendor/nette/di/src/DI/Compiler.php�% ^�g�% �w�D� # vendor/nette/di/src/DI/Resolver.php�b ^�g�b ��5�� , vendor/nette/di/src/DI/DependencyChecker.php ^�g ��qg� $ vendor/nette/di/src/DI/Container.php:, ^�g:, \ ��� % vendor/nette/di/src/DI/exceptions.php6 ^�g6 4�-� , vendor/nette/di/src/DI/Attributes/Inject.php! ^�g! r~no� + vendor/nette/di/src/DI/DynamicParameter.phpo ^�go Pv�� + vendor/nette/di/src/DI/ContainerBuilder.php�+ ^�g�+ �K7�� , vendor/nette/di/src/DI/CompilerExtension.php� ^�g� ݀� � * vendor/nette/di/src/DI/ContainerLoader.phpL ^�gL # Q� ' vendor/nette/di/src/DI/PhpGenerator.php� ^�g� 4$Vh� 5 vendor/nette/di/src/DI/Extensions/InjectExtension.php� ^�g� F�� 1 vendor/nette/di/src/DI/Extensions/DIExtension.php9 ^�g9 �׃� 8 vendor/nette/di/src/DI/Extensions/DecoratorExtension.phpg ^�gg C��f� 2 vendor/nette/di/src/DI/Extensions/PhpExtension.php� ^�g� T<네 6 vendor/nette/di/src/DI/Extensions/DefinitionSchema.phpo ^�go ��u)� 8 vendor/nette/di/src/DI/Extensions/ConstantsExtension.php� ^�g� �ZyP� 7 vendor/nette/di/src/DI/Extensions/ServicesExtension.php ^�g � �U� 9 vendor/nette/di/src/DI/Extensions/ExtensionsExtension.php ^�g �u I� 5 vendor/nette/di/src/DI/Extensions/SearchExtension.php� ^�g� u��� 9 vendor/nette/di/src/DI/Extensions/ParametersExtension.php{ ^�g{ y>�� " vendor/nette/di/src/DI/Helpers.php�# ^�g�# ��<�� % vendor/nette/di/src/DI/Autowiring.phpc ^�gc ��|x� ) vendor/nette/di/src/DI/Config/Adapter.php� ^�g� <� � ( vendor/nette/di/src/DI/Config/Loader.php4 ^�g4 ܧ�� 5 vendor/nette/di/src/DI/Config/Adapters/PhpAdapter.php� ^�g� �y�ܤ 6 vendor/nette/di/src/DI/Config/Adapters/NeonAdapter.php� ^�g� Fz��� ) vendor/nette/di/src/DI/Config/Helpers.php% ^�g% L��*� % vendor/nette/di/src/compatibility.php� ^�g� �'Dh� 6 vendor/nette/di/src/Bridges/DITracy/ContainerPanel.phpi ^�gi {�� F vendor/nette/di/src/Bridges/DITracy/templates/ContainerPanel.tab.phtml� ^�g� >F�-� H vendor/nette/di/src/Bridges/DITracy/templates/ContainerPanel.panel.phtml� ^�g� ]띦� vendor/nette/di/PATCHES.txt� ^�g� ���� @ vendor/nette/bootstrap/src/Bootstrap/Extensions/PhpExtension.phpQ ^�gQ ��㘤 F vendor/nette/bootstrap/src/Bootstrap/Extensions/ConstantsExtension.php) ^�g) �9�f� 5 vendor/nette/bootstrap/src/Bootstrap/Configurator.php, ^�g, �m � + vendor/nette/bootstrap/src/Configurator.php� ^�g� +�)5� ( vendor/nette/finder/src/Utils/Finder.php�* ^�g�* ��3� vendor/nette/utils/ncs.xml� ^�g� � � & vendor/nette/utils/src/SmartObject.php ^�g I��� % vendor/nette/utils/src/Utils/Type.php� ^�g� � � ' vendor/nette/utils/src/Utils/Random.php� ^�g� 6v4� + vendor/nette/utils/src/Utils/Reflection.php{7 ^�g{7 }�� ) vendor/nette/utils/src/Utils/Callback.php� ^�g� ��`� % vendor/nette/utils/src/Utils/Html.php�Z ^�g�Z ��WϤ + vendor/nette/utils/src/Utils/exceptions.php� ^�g� 8 ̷� , vendor/nette/utils/src/Utils/ObjectMixin.php ^�g �+9 � * vendor/nette/utils/src/Utils/ArrayHash.phpN ^�gN *�5� & vendor/nette/utils/src/Utils/Image.php�` ^�g�` �{� * vendor/nette/utils/src/Utils/ArrayList.php� ^�g� E�� ' vendor/nette/utils/src/Utils/Floats.phpm ^�gm 2D�� ) vendor/nette/utils/src/Utils/DateTime.php_ ^�g_ j\�� % vendor/nette/utils/src/Utils/Json.php� ^�g� �3�[� * vendor/nette/utils/src/Utils/Paginator.php� ^�g� �J5� . vendor/nette/utils/src/Utils/ObjectHelpers.phpF ^�gF �&[� + vendor/nette/utils/src/Utils/Validators.php�+ ^�g�+ ���9� ( vendor/nette/utils/src/Utils/Helpers.php� ^�g� ��� + vendor/nette/utils/src/Utils/FileSystem.php� ^�g� �l��� ( vendor/nette/utils/src/Utils/Strings.phpqQ ^�gqQ u�2#� ' vendor/nette/utils/src/Utils/Arrays.php�1 ^�g�1 S�r� ) vendor/nette/utils/src/HtmlStringable.phpl ^�gl �@x� % vendor/nette/utils/src/exceptions.php� ^�g� �*B�� 4 vendor/nette/utils/src/Iterators/CachingIterator.php� ^�g� ��b� + vendor/nette/utils/src/Iterators/Mapper.php� ^�g� O�g*� ( vendor/nette/utils/src/compatibility.php ^�g <���� % vendor/nette/utils/src/Translator.php� ^�g� �N�� & vendor/nette/utils/src/StaticClass.php� ^�g� ��~U� vendor/nette/utils/ncs.php8 ^�g8 �u��� * vendor/nette/schema/src/Schema/Context.php� ^�g� �b�&� 6 vendor/nette/schema/src/Schema/ValidationException.php� ^�g� �H�H� 3 vendor/nette/schema/src/Schema/DynamicParameter.php� ^�g� ���F� , vendor/nette/schema/src/Schema/Processor.php ^�g � � � * vendor/nette/schema/src/Schema/Message.php� ^�g� M(B�� ) vendor/nette/schema/src/Schema/Expect.php� ^�g� zT}� ) vendor/nette/schema/src/Schema/Schema.phpy ^�gy ��;�� * vendor/nette/schema/src/Schema/Helpers.php ^�g ��V� 0 vendor/nette/schema/src/Schema/Elements/Type.php� ^�g� ^�� 5 vendor/nette/schema/src/Schema/Elements/Structure.php� ^�g� h�&� 1 vendor/nette/schema/src/Schema/Elements/AnyOf.phpV ^�gV ���� 0 vendor/nette/schema/src/Schema/Elements/Base.php� ^�g� ��n� 9 vendor/nette/robot-loader/src/RobotLoader/RobotLoader.php�@ ^�g�@ �7ȫ� 4 vendor/nette/php-generator/src/PhpGenerator/Type.phpX ^�gX � � 9 vendor/nette/php-generator/src/PhpGenerator/Attribute.php_ ^�g_ �_� 8 vendor/nette/php-generator/src/PhpGenerator/EnumCase.php� ^�g� AE�?� : vendor/nette/php-generator/src/PhpGenerator/PhpLiteral.php� ^�g� ��e� E vendor/nette/php-generator/src/PhpGenerator/Traits/AttributeAware.php� ^�g� �㤾� C vendor/nette/php-generator/src/PhpGenerator/Traits/CommentAware.php� ^�g� ���� F vendor/nette/php-generator/src/PhpGenerator/Traits/VisibilityAware.php< ^�g< �� � C vendor/nette/php-generator/src/PhpGenerator/Traits/FunctionLike.php0 ^�g0 �v\� @ vendor/nette/php-generator/src/PhpGenerator/Traits/NameAware.php� ^�g� �}Fb� 7 vendor/nette/php-generator/src/PhpGenerator/Closure.php� ^�g� H��7� 8 vendor/nette/php-generator/src/PhpGenerator/TraitUse.php� ^�g� ��3�� A vendor/nette/php-generator/src/PhpGenerator/PromotedParameter.php� ^�g� ���ܤ 6 vendor/nette/php-generator/src/PhpGenerator/Method.php� ^�g� @�-� 9 vendor/nette/php-generator/src/PhpGenerator/Extractor.php > ^�g > Ϡ�g� 8 vendor/nette/php-generator/src/PhpGenerator/Constant.php� ^�g� /D)� 7 vendor/nette/php-generator/src/PhpGenerator/Printer.php[4 ^�g[4 �3��� 9 vendor/nette/php-generator/src/PhpGenerator/Parameter.php+ ^�g+ ��Ba� 8 vendor/nette/php-generator/src/PhpGenerator/Property.php� ^�g� 7�ؤ : vendor/nette/php-generator/src/PhpGenerator/PsrPrinter.php� ^�g� 6<\1� < vendor/nette/php-generator/src/PhpGenerator/PhpNamespace.phpC' ^�gC' ��h� 7 vendor/nette/php-generator/src/PhpGenerator/Literal.php ^�g �� b� > vendor/nette/php-generator/src/PhpGenerator/GlobalFunction.php� ^�g� �g��� 6 vendor/nette/php-generator/src/PhpGenerator/Dumper.php8# ^�g8# � �$� 7 vendor/nette/php-generator/src/PhpGenerator/Factory.php�3 ^�g�3 ���� 7 vendor/nette/php-generator/src/PhpGenerator/PhpFile.php� ^�g� ���d� 7 vendor/nette/php-generator/src/PhpGenerator/Helpers.php� ^�g� M��� 9 vendor/nette/php-generator/src/PhpGenerator/ClassType.phpF; ^�gF; -� " vendor/nette/php-generator/ncs.php' ^�g' �'%Ĥ % vendor/nette/neon/src/Neon/Parser.php�! ^�g�! ��g�� ( vendor/nette/neon/src/Neon/Exception.php7 ^�g7 �Q�q� % vendor/nette/neon/src/Neon/Entity.php� ^�g� )N��� $ vendor/nette/neon/src/Neon/Token.php} ^�g} ��ݤ # vendor/nette/neon/src/Neon/Node.php� ^�g� ��Q� & vendor/nette/neon/src/Neon/Decoder.php� ^�g� _�� & vendor/nette/neon/src/Neon/Encoder.phph ^�gh �S@� $ vendor/nette/neon/src/Neon/Lexer.php ^�g P� � * vendor/nette/neon/src/Neon/TokenStream.php. ^�g. O!Ɓ� # vendor/nette/neon/src/Neon/Neon.php� ^�g� a��� ( vendor/nette/neon/src/Neon/Traverser.phpj ^�gj ��Ƥ 3 vendor/nette/neon/src/Neon/Node/EntityChainNode.php ^�g ��0� 2 vendor/nette/neon/src/Neon/Node/BlockArrayNode.php� ^�g� �9�� 1 vendor/nette/neon/src/Neon/Node/ArrayItemNode.php� ^�g� Cr� � / vendor/nette/neon/src/Neon/Node/LiteralNode.phpE ^�gE .'�9� 3 vendor/nette/neon/src/Neon/Node/InlineArrayNode.php_ ^�g_ 9G��� - vendor/nette/neon/src/Neon/Node/ArrayNode.php� ^�g� �W� . vendor/nette/neon/src/Neon/Node/StringNode.php� ^�g� �l�<� . vendor/nette/neon/src/Neon/Node/EntityNode.phpY ^�gY L �)� vendor/nette/neon/bin/neon-lintK ^�gK ? �� vendor/nette/neon/PATCHES.txt� ^�g� 0��O� $ vendor/hoa/consistency/Exception.php� ^�g� �m�X� " vendor/hoa/consistency/Prelude.php ^�g Y`�i� $ vendor/hoa/consistency/Xcallable.phpt ^�gt t�� & vendor/hoa/consistency/Consistency.php~ ^�g~ ���f� % vendor/hoa/consistency/Autoloader.phpa ^�ga ��� " vendor/hoa/consistency/PATCHES.txt� ^�g� oV?� ' vendor/hoa/file/Temporary/ReadWrite.php�" ^�g�" ���� " vendor/hoa/file/Temporary/Read.phpm ^�gm ��3� ' vendor/hoa/file/Temporary/Temporary.php� ^�g� 0�9� # vendor/hoa/file/Temporary/Write.php ^�g F6��� vendor/hoa/file/Finder.php%D ^�g%D ��ސ� vendor/hoa/file/Link/Link.phpR ^�gR �M�� " vendor/hoa/file/Link/ReadWrite.php�" ^�g�" ��ͤ vendor/hoa/file/Link/Read.phpP ^�gP �X<6� vendor/hoa/file/Link/Write.php� ^�g� �G � vendor/hoa/file/SplFileInfo.php ^�g �RK� vendor/hoa/file/File.php�% ^�g�% W � vendor/hoa/file/ReadWrite.php�" ^�g�" ��� vendor/hoa/file/Watcher.php� ^�g� ċv�� vendor/hoa/file/Generic.php44 ^�g44 W\/� vendor/hoa/file/Read.phpA ^�gA ��$� ' vendor/hoa/file/Exception/Exception.php� ^�g� U墕� . vendor/hoa/file/Exception/FileDoesNotExist.php� ^�g� K�i�� vendor/hoa/file/Write.php ^�g ��0M� vendor/hoa/file/Directory.php� ^�g� �V� � vendor/hoa/file/PATCHES.txt� ^�g� ���)� vendor/hoa/visitor/Visit.php� ^�g� ��5� vendor/hoa/visitor/Element.php� ^�g� �e�b� vendor/hoa/regex/Grammar.pp ^�g A L�� vendor/hoa/regex/Exception.php� ^�g� ��� & vendor/hoa/regex/Visitor/Isotropic.php>$ ^�g>$ CId;� . vendor/hoa/compiler/Documentation/En/Index.xyl�� ^�g�� �d/� . vendor/hoa/compiler/Documentation/Fr/Index.xylt� ^�gt� �E� + vendor/hoa/compiler/Exception/Exception.php ^�g �?��� . vendor/hoa/compiler/Exception/IllegalToken.php� ^�g� EW �� & vendor/hoa/compiler/Exception/Rule.php� ^�g� 5�<@� = vendor/hoa/compiler/Exception/FinalStateHasNotBeenReached.php� ^�g� �bsϤ 1 vendor/hoa/compiler/Exception/UnexpectedToken.php� ^�g� ��/�� ' vendor/hoa/compiler/Exception/Lexer.php� ^�g� ���� 3 vendor/hoa/compiler/Exception/UnrecognizedToken.php� ^�g� wؤ $ vendor/hoa/compiler/Visitor/Dump.php? ^�g? L�护 vendor/hoa/compiler/Ll1.php`k ^�g`k �P�� vendor/hoa/compiler/PATCHES.txt; ^�g; �Ts�� vendor/hoa/compiler/Bin/Pp.php� ^�g� %�� " vendor/hoa/compiler/Llk/Parser.php Q ^�g Q �J�(� $ vendor/hoa/compiler/Llk/TreeNode.php ^�g IC\ۤ ! vendor/hoa/compiler/Llk/Lexer.php� ^�g� |�O� vendor/hoa/compiler/Llk/Llk.php�. ^�g�. �&�� + vendor/hoa/compiler/Llk/Sampler/Sampler.php� ^�g� k�<*� - vendor/hoa/compiler/Llk/Sampler/Exception.php� ^�g� ��k� , vendor/hoa/compiler/Llk/Sampler/Coverage.php{F ^�g{F � CC� 5 vendor/hoa/compiler/Llk/Sampler/BoundedExhaustive.php�& ^�g�& U�o� + vendor/hoa/compiler/Llk/Sampler/Uniform.php�" ^�g�" ��� ) vendor/hoa/compiler/Llk/Rule/Analyzer.php"4 ^�g"4 ��xF� & vendor/hoa/compiler/Llk/Rule/Ekzit.phpo ^�go V�|� % vendor/hoa/compiler/Llk/Rule/Rule.php" ^�g" �hg7� & vendor/hoa/compiler/Llk/Rule/Token.php= ^�g= �i�/� . vendor/hoa/compiler/Llk/Rule/Concatenation.phpz ^�gz _oP� ' vendor/hoa/compiler/Llk/Rule/Choice.phpe ^�ge �Oᙤ + vendor/hoa/compiler/Llk/Rule/Invocation.phpL ^�gL ��ᙤ + vendor/hoa/compiler/Llk/Rule/Repetition.php� ^�g� T1&� & vendor/hoa/compiler/Llk/Rule/Entry.phph ^�gh ��+ͤ vendor/hoa/compiler/Llk/Llk.pp� ^�g� Gr�� vendor/hoa/math/Util.phpY ^�gY �c] � vendor/hoa/math/Arithmetic.pp� ^�g� ��٤ vendor/hoa/math/Context.php ^�g J/��� - vendor/hoa/math/Exception/UnknownVariable.php� ^�g� ��*� ' vendor/hoa/math/Exception/Exception.php� ^�g� � ��� - vendor/hoa/math/Exception/UnknownFunction.php� ^�g� �䒤 - vendor/hoa/math/Exception/UnknownConstant.php� ^�g� �q��� 4 vendor/hoa/math/Exception/AlreadyDefinedConstant.php� ^�g� ��=�� - vendor/hoa/math/Combinatorics/Permutation.php ^�g sY�7� * vendor/hoa/math/Combinatorics/Counting.php ^�g sY�7� 9 vendor/hoa/math/Combinatorics/Combination/Combination.php� ^�g� �K� > vendor/hoa/math/Combinatorics/Combination/CartesianProduct.php� ^�g� ��� 3 vendor/hoa/math/Combinatorics/Combination/Gamma.php? ^�g? ���ʤ - vendor/hoa/math/Combinatorics/Arrangement.php ^�g sY�7� + vendor/hoa/math/Combinatorics/FiniteSet.php ^�g sY�7� # vendor/hoa/math/Sampler/Sampler.php! ^�g! �M�� " vendor/hoa/math/Sampler/Random.php� ^�g� P� %� & vendor/hoa/math/Visitor/Arithmetic.phpG' ^�gG' -�}ڤ vendor/hoa/math/Bin/Calc.php� ^�g� �&�~� vendor/hoa/event/Bucket.phpD ^�gD 4u�*� vendor/hoa/event/Listenable.php� ^�g� �GO� vendor/hoa/event/Exception.php� ^�g� � �=� vendor/hoa/event/Listens.php� ^�g� �#v� vendor/hoa/event/Listener.php� ^�g� ���ݤ vendor/hoa/event/Event.php ^�g G�ṳ vendor/hoa/event/Source.php_ ^�g_ �� vendor/hoa/stream/Bucket.php� ^�g� e�� vendor/hoa/stream/Exception.php� ^�g� e3��� vendor/hoa/stream/Context.phpe ^�ge lp� ' vendor/hoa/stream/IStream/Touchable.php� ^�g� -6�� & vendor/hoa/stream/IStream/Lockable.phph ^�gh ��� & vendor/hoa/stream/IStream/Pathable.phps ^�gs I 7� ! vendor/hoa/stream/IStream/Out.php� ^�g� �ǟΤ ' vendor/hoa/stream/IStream/Pointable.php ^�g �gq� & vendor/hoa/stream/IStream/Statable.php� ^�g� i��� vendor/hoa/stream/IStream/In.phpn ^�gn �T � $ vendor/hoa/stream/IStream/Stream.php� ^�g� g�� ( vendor/hoa/stream/IStream/Bufferable.php� ^�g� Y�q� ( vendor/hoa/stream/IStream/Structural.php ^�g ��q~� & vendor/hoa/stream/Filter/Exception.php� ^�g� � � " vendor/hoa/stream/Filter/Basic.php� ^�g� ��x� # vendor/hoa/stream/Filter/Filter.php� ^�g� Y&�:� ) vendor/hoa/stream/Filter/LateComputed.phpc ^�gc 4�G� + vendor/hoa/stream/Wrapper/IWrapper/File.php� ^�g� ݉=�� - vendor/hoa/stream/Wrapper/IWrapper/Stream.php0( ^�g0( _��S� / vendor/hoa/stream/Wrapper/IWrapper/IWrapper.php� ^�g� �?�� ' vendor/hoa/stream/Wrapper/Exception.php� ^�g� Xe� % vendor/hoa/stream/Wrapper/Wrapper.php� ^�g� �L�Q� vendor/hoa/stream/Stream.php�A ^�g�A ]��� vendor/hoa/stream/Composite.php� ^�g� �¯~� vendor/hoa/stream/PATCHES.txt� ^�g� �aQ� " vendor/hoa/exception/Exception.phpO ^�gO � � vendor/hoa/exception/Error.phpH ^�gH *b�&� vendor/hoa/exception/Idle.php� ^�g� ��=� vendor/hoa/exception/Group.phpZ ^�gZ �f�$� vendor/hoa/exception/PATCHES.txt� ^�g� �`on� vendor/hoa/ustring/Exception.php� ^�g� P��R� vendor/hoa/ustring/Search.php ^�g �� � vendor/hoa/ustring/Ustring.php�e ^�g�e ���� - vendor/hoa/ustring/Documentation/En/Index.xyl h ^�g h ��v� - vendor/hoa/ustring/Documentation/Fr/Index.xylEn ^�gEn �Fp� # vendor/hoa/ustring/Bin/Fromcode.php� ^�g� ;�m� ! vendor/hoa/ustring/Bin/Tocode.php� ^�g� ���� ! vendor/hoa/protocol/Exception.php� ^�g� 6��\� vendor/hoa/protocol/Wrapper.php&F ^�g&F [ ZC� vendor/hoa/protocol/Protocol.php ^�g �H�� $ vendor/hoa/protocol/Node/Library.php� ^�g� ��7� ! vendor/hoa/protocol/Node/Node.php�& ^�g�& ��z� vendor/hoa/protocol/PATCHES.txt� ^�g� ���P� # vendor/hoa/protocol/Bin/Resolve.php� ^�g� A��M� vendor/hoa/zformat/Exception.php� ^�g� N�f� & vendor/hoa/zformat/Parameterizable.php� ^�g� �Kn� vendor/hoa/zformat/Parameter.phpG ^�gG ��?�� # vendor/hoa/iterator/SplFileInfo.phph ^�gh �o�l� ( vendor/hoa/iterator/IteratorIterator.phpv ^�gv iÃ#� ! vendor/hoa/iterator/Exception.php� ^�g� �>�T� vendor/hoa/iterator/Multiple.php� ^�g� �� � vendor/hoa/iterator/NoRewind.phpf ^�gf 7Z/}� " vendor/hoa/iterator/Lookbehind.php4 ^�g4 �*4� vendor/hoa/iterator/Infinite.phpf ^�gf � �*� vendor/hoa/iterator/Iterator.php� ^�g� �"�� vendor/hoa/iterator/Glob.phpV ^�gV �ǻ�� ) vendor/hoa/iterator/RegularExpression.php�! ^�g�! ^Iu�� vendor/hoa/iterator/Outer.phpf ^�gf � vendor/hoa/iterator/Mock.phpX ^�gX |!� ) vendor/hoa/iterator/CallbackGenerator.php� ^�g� 6H�9� vendor/hoa/iterator/Filter.phpg ^�gg iһ� & vendor/hoa/iterator/CallbackFilter.php~ ^�g~ �L �� ! vendor/hoa/iterator/Aggregate.phpv ^�gv ��ˤ * vendor/hoa/iterator/Recursive/Iterator.php� ^�g� ���s� 3 vendor/hoa/iterator/Recursive/RegularExpression.php� ^�g� lֲ� & vendor/hoa/iterator/Recursive/Mock.phpo ^�go ���w� ( vendor/hoa/iterator/Recursive/Filter.php� ^�g� ��҅� 0 vendor/hoa/iterator/Recursive/CallbackFilter.php� ^�g� �� �� + vendor/hoa/iterator/Recursive/Recursive.php� ^�g� Zr �� + vendor/hoa/iterator/Recursive/Directory.php� ^�g� 6�FY� % vendor/hoa/iterator/Recursive/Map.php| ^�g| PX:� vendor/hoa/iterator/Buffer.php� ^�g� �Mtʤ ! vendor/hoa/iterator/Directory.php ^�g ��~� vendor/hoa/iterator/Counter.php� ^�g� �6՟� vendor/hoa/iterator/Seekable.phpq ^�gq ���פ vendor/hoa/iterator/Map.phpV ^�gV ���w� % vendor/hoa/iterator/Demultiplexer.php� ^�g� : �+� " vendor/hoa/iterator/FileSystem.php� ^�g� ��� vendor/hoa/iterator/PATCHES.txt� ^�g� ���2� vendor/hoa/iterator/Limit.phpZ ^�gZ �!x#� ! vendor/hoa/iterator/Lookahead.phpq ^�gq ��_�� vendor/hoa/iterator/Repeater.php5 ^�g5 �q�� vendor/hoa/iterator/Append.php^ ^�g^ ��{F� vendor/psr/log/LICENSE= ^�g= p��O� ' vendor/psr/log/src/LoggerAwareTrait.php� ^�g� A5(�� & vendor/psr/log/src/LoggerInterface.php ^�g ̌e� vendor/psr/log/src/LogLevel.phpL ^�gL � ܤ " vendor/psr/log/src/LoggerTrait.phpL ^�gL � Z� ! vendor/psr/log/src/NullLogger.php� ^�g� �Y~J� / vendor/psr/log/src/InvalidArgumentException.phps ^�gs ��kǤ + vendor/psr/log/src/LoggerAwareInterface.php< ^�g< �U�G� % vendor/psr/log/src/AbstractLogger.php� ^�g� t]��� vendor/psr/container/LICENSEy ^�gy �O�p� 8 vendor/psr/container/src/ContainerExceptionInterface.php� ^�g� N!bS� / vendor/psr/container/src/ContainerInterface.php" ^�g" ���� 7 vendor/psr/container/src/NotFoundExceptionInterface.php� ^�g� �>�q� vendor/psr/http-message/LICENSE= ^�g= ��� 1 vendor/psr/http-message/src/ResponseInterface.phpU ^�gU h �� , vendor/psr/http-message/src/UriInterface.php�1 ^�g�1 0E�� 6 vendor/psr/http-message/src/ServerRequestInterface.php�' ^�g�' |� 0 vendor/psr/http-message/src/RequestInterface.php ^�g H]Zf� 0 vendor/psr/http-message/src/MessageInterface.phpR ^�gR (���� 5 vendor/psr/http-message/src/UploadedFileInterface.phpp ^�gp ' �.� / vendor/psr/http-message/src/StreamInterface.php� ^�g� �:)9� vendor/composer/LICENSE. ^�g. �� ! vendor/composer/autoload_real.php� ^�g� �D5�� % vendor/composer/InstalledVersions.phpPB ^�gPB )|�� vendor/composer/installed.php�� ^�g�� �&E� " vendor/composer/autoload_files.phpw ^�gw )�� ! vendor/composer/autoload_psr4.php� ^�g� -��`� & vendor/composer/xdebug-handler/LICENSE) ^�g) #�;^� . vendor/composer/xdebug-handler/src/Process.phpn ^�gn �5k� - vendor/composer/xdebug-handler/src/Status.phpe ^�ge u�G� 4 vendor/composer/xdebug-handler/src/XdebugHandler.php}T ^�g}T �PBv� 0 vendor/composer/xdebug-handler/src/PhpConfig.php� ^�g� !�� ' vendor/composer/autoload_namespaces.php� ^�g� �/t� vendor/composer/pcre/LICENSE ^�g hg�^� 3 vendor/composer/pcre/src/MatchWithOffsetsResult.php� ^�g� ���� ( vendor/composer/pcre/src/MatchResult.php ^�g =g�� + vendor/composer/pcre/src/MatchAllResult.php� ^�g� ��C� 6 vendor/composer/pcre/src/MatchAllWithOffsetsResult.php� ^�g� �,� � " vendor/composer/pcre/src/Regex.php� ^�g� ��� 4 vendor/composer/pcre/src/MatchStrictGroupsResult.php ^�g "��x� * vendor/composer/pcre/src/ReplaceResult.php� ^�g� �w� * vendor/composer/pcre/src/PcreException.php ^�g ��N�� 9 vendor/composer/pcre/src/UnexpectedNullMatchException.php ^�g 64X� 7 vendor/composer/pcre/src/MatchAllStrictGroupsResult.php� ^�g� LN��� ! vendor/composer/pcre/src/Preg.phpUE ^�gUE �_��� G vendor/composer/pcre/src/PHPStan/PregMatchParameterOutTypeExtension.php? ^�g? ���� ? vendor/composer/pcre/src/PHPStan/UnsafeStrictGroupsCallRule.phpa ^�ga �t� < vendor/composer/pcre/src/PHPStan/InvalidRegexPatternRule.php= ^�g= > G� 3 vendor/composer/pcre/src/PHPStan/PregMatchFlags.phpd ^�gd �I;� E vendor/composer/pcre/src/PHPStan/PregMatchTypeSpecifyingExtension.php� ^�g� � gĤ L vendor/composer/pcre/src/PHPStan/PregReplaceCallbackClosureTypeExtension.php� ^�g� �Z�� # vendor/composer/pcre/extension.neonF ^�gF �Dȑ� vendor/composer/semver/LICENSE ^�g Bh� ( vendor/composer/semver/src/Intervals.php�N ^�g�N @�]� , vendor/composer/semver/src/VersionParser.php�T ^�g�T N�]� % vendor/composer/semver/src/Semver.phpT ^�gT ��,�� = vendor/composer/semver/src/Constraint/ConstraintInterface.php� ^�g� �̾� / vendor/composer/semver/src/Constraint/Bound.phpE ^�gE hȣ�� = vendor/composer/semver/src/Constraint/MatchNoneConstraint.php� ^�g� �^�|� < vendor/composer/semver/src/Constraint/MatchAllConstraint.php� ^�g� p0�Ȥ 4 vendor/composer/semver/src/Constraint/Constraint.php�0 ^�g�0 �GA� 9 vendor/composer/semver/src/Constraint/MultiConstraint.php@# ^�g@# ?��� / vendor/composer/semver/src/CompilingMatcher.php) ^�g) ��� � ' vendor/composer/semver/src/Interval.php� ^�g� �za�� ) vendor/composer/semver/src/Comparator.phpb ^�gb 75 ߤ # vendor/composer/autoload_static.php�L ^�g�L �[�� vendor/composer/ClassLoader.php�? ^�g�? 2@ u� ! vendor/composer/ca-bundle/LICENSE ^�g *!^`� ( vendor/composer/ca-bundle/res/cacert.pemz� ^�gz� %�O� * vendor/composer/ca-bundle/src/CaBundle.php�+ ^�g�+ u�� % vendor/composer/ca-bundle/PATCHES.txt� ^�g� rbmW� % vendor/composer/autoload_classmap.php�� ^�g�� �!Ѝ� vendor/clue/ndjson-react/LICENSE: ^�g: �DiG� ( vendor/clue/ndjson-react/src/Decoder.php� ^�g� i���� ( vendor/clue/ndjson-react/src/Encoder.php� ^�g� y< !� . vendor/ondram/ci-detector/src/TrinaryLogic.php? ^�g? �Y.� B vendor/ondram/ci-detector/src/Exception/CiNotDetectedException.php� ^�g� �zJ� 1 vendor/ondram/ci-detector/src/Ci/AwsCodeBuild.php� ^�g� \ʣ�� - vendor/ondram/ci-detector/src/Ci/Codeship.php ^�g `�ލ� 2 vendor/ondram/ci-detector/src/Ci/GitHubActions.php ^�g L�鼤 2 vendor/ondram/ci-detector/src/Ci/Continuousphp.phpi ^�gi {#�� + vendor/ondram/ci-detector/src/Ci/Circle.php� ^�g� |�7Ѥ 7 vendor/ondram/ci-detector/src/Ci/BitbucketPipelines.php� ^�g� U� � + vendor/ondram/ci-detector/src/Ci/GitLab.php ^�g �o� + vendor/ondram/ci-detector/src/Ci/Travis.php� ^�g� aTߤ * vendor/ondram/ci-detector/src/Ci/Buddy.php ^�g ��i� 0 vendor/ondram/ci-detector/src/Ci/CiInterface.php� ^�g� �� - vendor/ondram/ci-detector/src/Ci/TeamCity.php� ^�g� I��#� * vendor/ondram/ci-detector/src/Ci/Drone.php2 ^�g2 ��Y � / vendor/ondram/ci-detector/src/Ci/AbstractCi.php� ^�g� �?� , vendor/ondram/ci-detector/src/Ci/Jenkins.php� ^�g� � n� + vendor/ondram/ci-detector/src/Ci/Bamboo.php8 ^�g8 T��Ϥ , vendor/ondram/ci-detector/src/Ci/Wercker.php. ^�g. ��fϤ - vendor/ondram/ci-detector/src/Ci/AppVeyor.php� ^�g� � , vendor/ondram/ci-detector/src/CiDetector.php� ^�g� �"��� % vendor/ondram/ci-detector/src/Env.php� ^�g� G�cE� " vendor/evenement/evenement/LICENSE ^�g �{I=� 8 vendor/evenement/evenement/src/EventEmitterInterface.php� ^�g� ��Ϥ / vendor/evenement/evenement/src/EventEmitter.phpr ^�gr �� � 4 vendor/evenement/evenement/src/EventEmitterTrait.phpY ^�gY ]�v� : vendor/fidry/cpu-core-counter/src/Finder/CpuCoreFinder.php ^�g ֑+M� @ vendor/fidry/cpu-core-counter/src/Finder/LscpuPhysicalFinder.phpx ^�gx uc�� ? vendor/fidry/cpu-core-counter/src/Finder/LscpuLogicalFinder.phpM ^�gM �ҽ�� > vendor/fidry/cpu-core-counter/src/Finder/_NProcessorFinder.php� ^�g� @e�&� C vendor/fidry/cpu-core-counter/src/Finder/CmiCmdletLogicalFinder.php� ^�g� _���� < vendor/fidry/cpu-core-counter/src/Finder/HwLogicalFinder.phpv ^�gv L�}/� ? vendor/fidry/cpu-core-counter/src/Finder/DummyCpuCoreFinder.phpA ^�gA � �_� = vendor/fidry/cpu-core-counter/src/Finder/HwPhysicalFinder.phpz ^�gz �&)Q� = vendor/fidry/cpu-core-counter/src/Finder/NProcessorFinder.php� ^�g� �l�ʤ ? vendor/fidry/cpu-core-counter/src/Finder/WmicPhysicalFinder.php� ^�g� ,ѱ� A vendor/fidry/cpu-core-counter/src/Finder/OnlyOnOSFamilyFinder.php� ^�g� K���� A vendor/fidry/cpu-core-counter/src/Finder/SkipOnOSFamilyFinder.php� ^�g� ��ƺ� ; vendor/fidry/cpu-core-counter/src/Finder/FinderRegistry.php� ^�g� ��4F� > vendor/fidry/cpu-core-counter/src/Finder/WmicLogicalFinder.php� ^�g� ;� D vendor/fidry/cpu-core-counter/src/Finder/CmiCmdletPhysicalFinder.php� ^�g� OHl� : vendor/fidry/cpu-core-counter/src/Finder/CpuInfoFinder.php ^�g �="� C vendor/fidry/cpu-core-counter/src/Finder/OnlyInPowerShellFinder.php� ^�g� � � 8 vendor/fidry/cpu-core-counter/src/Finder/NProcFinder.php ^�g �̈r� > vendor/fidry/cpu-core-counter/src/Finder/EnvVariableFinder.php� ^�g� �Z9� > vendor/fidry/cpu-core-counter/src/Finder/NullCpuCoreFinder.php� ^�g� !U��� @ vendor/fidry/cpu-core-counter/src/Finder/ProcOpenBasedFinder.php� ^�g� �.�o� I vendor/fidry/cpu-core-counter/src/Finder/WindowsRegistryLogicalFinder.phpx ^�gx ��� ; vendor/fidry/cpu-core-counter/src/ParallelisationResult.php� ^�g� �U�Z� = vendor/fidry/cpu-core-counter/src/NumberOfCpuCoreNotFound.php$ ^�g$ ��ۖ� 4 vendor/fidry/cpu-core-counter/src/CpuCoreCounter.php�! ^�g�! 6.�� ? vendor/fidry/cpu-core-counter/src/Executor/ProcOpenExecutor.php� ^�g� yBTդ > vendor/fidry/cpu-core-counter/src/Executor/ProcessExecutor.php� ^�g� �pL� / vendor/fidry/cpu-core-counter/src/Diagnoser.php{ ^�g{ ��HO� - vendor/fidry/cpu-core-counter/bin/execute.phpk ^�gk :��|� + vendor/fidry/cpu-core-counter/bin/trace.phpB ^�gB K�枤 . vendor/fidry/cpu-core-counter/bin/diagnose.php� ^�g� �Ƥ vendor/nikic/php-parser/LICENSE� ^�g� ��*� 0 vendor/nikic/php-parser/lib/PhpParser/Parser.php� ^�g� �C2Ӥ 6 vendor/nikic/php-parser/lib/PhpParser/NodeAbstract.php~ ^�g~ [�W{� 6 vendor/nikic/php-parser/lib/PhpParser/Builder/Use_.php� ^�g� ixL� : vendor/nikic/php-parser/lib/PhpParser/Builder/EnumCase.php. ^�g. �(��� 8 vendor/nikic/php-parser/lib/PhpParser/Builder/Class_.php� ^�g� ��� ; vendor/nikic/php-parser/lib/PhpParser/Builder/Function_.php1 ^�g1 (�jL� = vendor/nikic/php-parser/lib/PhpParser/Builder/Declaration.php� ^�g� ?{� D vendor/nikic/php-parser/lib/PhpParser/Builder/TraitUseAdaptation.phpb ^�gb �a��� < vendor/nikic/php-parser/lib/PhpParser/Builder/Interface_.php� ^�g� w�� � < vendor/nikic/php-parser/lib/PhpParser/Builder/ClassConst.php� ^�g� ż�0� : vendor/nikic/php-parser/lib/PhpParser/Builder/TraitUse.php/ ^�g/ G��� < vendor/nikic/php-parser/lib/PhpParser/Builder/Namespace_.php% ^�g% ����� 8 vendor/nikic/php-parser/lib/PhpParser/Builder/Method.php{ ^�g{ a,;#� > vendor/nikic/php-parser/lib/PhpParser/Builder/FunctionLike.php� ^�g� ��� 7 vendor/nikic/php-parser/lib/PhpParser/Builder/Param.php[ ^�g[ \�P5� : vendor/nikic/php-parser/lib/PhpParser/Builder/Property.php< ^�g< L�� 8 vendor/nikic/php-parser/lib/PhpParser/Builder/Trait_.php� ^�g� ��6ۤ 7 vendor/nikic/php-parser/lib/PhpParser/Builder/Enum_.phpg ^�gg koä / vendor/nikic/php-parser/lib/PhpParser/Error.php� ^�g� %b&� 7 vendor/nikic/php-parser/lib/PhpParser/ParserFactory.phpD ^�gD �S�� 8 vendor/nikic/php-parser/lib/PhpParser/ParserAbstract.php� ^�g� ��� � ; vendor/nikic/php-parser/lib/PhpParser/Internal/DiffElem.php/ ^�g/ ���� > vendor/nikic/php-parser/lib/PhpParser/Internal/TokenStream.php�# ^�g�# *tY � 9 vendor/nikic/php-parser/lib/PhpParser/Internal/Differ.php ^�g �'>;� L vendor/nikic/php-parser/lib/PhpParser/Internal/PrintableNewAnonClassNode.phpz ^�gz 56Z� 7 vendor/nikic/php-parser/lib/PhpParser/NodeTraverser.php�' ^�g�' ���k� . vendor/nikic/php-parser/lib/PhpParser/Node.php� ^�g� eȊԤ 5 vendor/nikic/php-parser/lib/PhpParser/JsonDecoder.phpD ^�gD �C�D� 4 vendor/nikic/php-parser/lib/PhpParser/NodeFinder.php� ^�g� �v��� 9 vendor/nikic/php-parser/lib/PhpParser/Parser/Multiple.php� ^�g� ��FR� 7 vendor/nikic/php-parser/lib/PhpParser/Parser/Tokens.php ^�g y��\� 5 vendor/nikic/php-parser/lib/PhpParser/Parser/Php7.php�T ^�g�T ���H� 5 vendor/nikic/php-parser/lib/PhpParser/Parser/Php5.php�+ ^�g�+ P��Ĥ @ vendor/nikic/php-parser/lib/PhpParser/PrettyPrinter/Standard.phpӤ ^�gӤ w��� / vendor/nikic/php-parser/lib/PhpParser/Lexer.php&[ ^�g&[ "�� 1 vendor/nikic/php-parser/lib/PhpParser/Comment.php� ^�g� �i�� = vendor/nikic/php-parser/lib/PhpParser/NodeVisitorAbstract.php� ^�g� 8��� F vendor/nikic/php-parser/lib/PhpParser/ConstExprEvaluationException.phpW ^�gW �"� 5 vendor/nikic/php-parser/lib/PhpParser/Comment/Doc.phph ^�gh �y��� @ vendor/nikic/php-parser/lib/PhpParser/NodeTraverserInterface.php� ^�g� J��� 6 vendor/nikic/php-parser/lib/PhpParser/ErrorHandler.php2 ^�g2 L� A vendor/nikic/php-parser/lib/PhpParser/ErrorHandler/Collecting.php| ^�g| ���� ? vendor/nikic/php-parser/lib/PhpParser/ErrorHandler/Throwing.phpn ^�gn �ZAM� 4 vendor/nikic/php-parser/lib/PhpParser/NodeDumper.phpV ^�gV ��� 8 vendor/nikic/php-parser/lib/PhpParser/BuilderHelpers.php�% ^�g�% 'p� 5 vendor/nikic/php-parser/lib/PhpParser/NameContext.php�% ^�g�% |m �� 8 vendor/nikic/php-parser/lib/PhpParser/BuilderFactory.php�, ^�g�, ��O�� I vendor/nikic/php-parser/lib/PhpParser/NodeVisitor/FirstFindingVisitor.php� ^�g� ��+� B vendor/nikic/php-parser/lib/PhpParser/NodeVisitor/NameResolver.php�& ^�g�& �6��� D vendor/nikic/php-parser/lib/PhpParser/NodeVisitor/FindingVisitor.phpl ^�gl �=*�� M vendor/nikic/php-parser/lib/PhpParser/NodeVisitor/ParentConnectingVisitor.php] ^�g] �� � K vendor/nikic/php-parser/lib/PhpParser/NodeVisitor/NodeConnectingVisitor.phpt ^�gt �k�ڤ D vendor/nikic/php-parser/lib/PhpParser/NodeVisitor/CloningVisitor.php� ^�g� ��!F� 8 vendor/nikic/php-parser/lib/PhpParser/Node/Attribute.php@ ^�g@ �`� @ vendor/nikic/php-parser/lib/PhpParser/Node/VarLikeIdentifier.php ^�g T�.� 9 vendor/nikic/php-parser/lib/PhpParser/Node/Identifier.php� ^�g� �m�{� 3 vendor/nikic/php-parser/lib/PhpParser/Node/Name.php ^�g V�5�� 5 vendor/nikic/php-parser/lib/PhpParser/Node/Scalar.phps ^�gs uQ�� = vendor/nikic/php-parser/lib/PhpParser/Node/Scalar/DNumber.php ^�g �^�T� > vendor/nikic/php-parser/lib/PhpParser/Node/Scalar/Encapsed.php� ^�g� �d� D vendor/nikic/php-parser/lib/PhpParser/Node/Scalar/MagicConst/Dir.php= ^�g= )�G�� G vendor/nikic/php-parser/lib/PhpParser/Node/Scalar/MagicConst/Class_.phpD ^�gD +0 �� J vendor/nikic/php-parser/lib/PhpParser/Node/Scalar/MagicConst/Function_.phpM ^�gM �fA�� E vendor/nikic/php-parser/lib/PhpParser/Node/Scalar/MagicConst/File.php@ ^�g@ �g¤ K vendor/nikic/php-parser/lib/PhpParser/Node/Scalar/MagicConst/Namespace_.phpP ^�gP �t� G vendor/nikic/php-parser/lib/PhpParser/Node/Scalar/MagicConst/Method.phpF ^�gF ��3� G vendor/nikic/php-parser/lib/PhpParser/Node/Scalar/MagicConst/Trait_.phpD ^�gD C���� E vendor/nikic/php-parser/lib/PhpParser/Node/Scalar/MagicConst/Line.php@ ^�g@ �&Q&� = vendor/nikic/php-parser/lib/PhpParser/Node/Scalar/LNumber.phpi ^�gi ��1�� = vendor/nikic/php-parser/lib/PhpParser/Node/Scalar/String_.phpY ^�gY ��28� H vendor/nikic/php-parser/lib/PhpParser/Node/Scalar/EncapsedStringPart.php� ^�g� �՝� @ vendor/nikic/php-parser/lib/PhpParser/Node/Scalar/MagicConst.phpS ^�gS ix� 3 vendor/nikic/php-parser/lib/PhpParser/Node/Stmt.php� ^�g� �Et1� = vendor/nikic/php-parser/lib/PhpParser/Node/AttributeGroup.php� ^�g� UP�R� 8 vendor/nikic/php-parser/lib/PhpParser/Node/UnionType.php� ^�g� ���� ; vendor/nikic/php-parser/lib/PhpParser/Node/NullableType.php� ^�g� �{�� ; vendor/nikic/php-parser/lib/PhpParser/Node/FunctionLike.php� ^�g� �,O� > vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BitwiseNot.php� ^�g� +2�8� : vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Assign.php ^�g � =� < vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignOp.php� ^�g� @��ˤ < vendor/nikic/php-parser/lib/PhpParser/Node/Expr/CallLike.php ^�g �p Ф < vendor/nikic/php-parser/lib/PhpParser/Node/Expr/FuncCall.php0 ^�g0 ,fS� = vendor/nikic/php-parser/lib/PhpParser/Node/Expr/ArrayItem.phpi ^�gi �nT� 8 vendor/nikic/php-parser/lib/PhpParser/Node/Expr/New_.phpx ^�gx P�� : vendor/nikic/php-parser/lib/PhpParser/Node/Expr/PreInc.php{ ^�g{ ��� : vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Empty_.php~ ^�g~ ۵�� ; vendor/nikic/php-parser/lib/PhpParser/Node/Expr/PostInc.php~ ^�g~ �4�Q� A vendor/nikic/php-parser/lib/PhpParser/Node/Expr/ErrorSuppress.php� ^�g� j�77� : vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Yield_.phpN ^�gN ��oP� > vendor/nikic/php-parser/lib/PhpParser/Node/Expr/UnaryMinus.php� ^�g� 9���� : vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Isset_.php ^�g �i�x� = vendor/nikic/php-parser/lib/PhpParser/Node/Expr/UnaryPlus.php� ^�g� �'( � = vendor/nikic/php-parser/lib/PhpParser/Node/Expr/ShellExec.php� ^�g� ���g� 9 vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Eval_.php{ ^�g{ ~��� 9 vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Exit_.php� ^�g� ��� C vendor/nikic/php-parser/lib/PhpParser/Node/Expr/ClassConstFetch.php� ^�g� Aʤ 9 vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Error.php� ^�g� ��2� : vendor/nikic/php-parser/lib/PhpParser/Node/Expr/PreDec.php{ ^�g{ Ly0�� : vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Print_.php~ ^�g~ �?(� 9 vendor/nikic/php-parser/lib/PhpParser/Node/Expr/List_.php� ^�g� *�I� > vendor/nikic/php-parser/lib/PhpParser/Node/Expr/MethodCall.php< ^�g< 8��� > vendor/nikic/php-parser/lib/PhpParser/Node/Expr/StaticCall.phpJ ^�gJ �� � E vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/NotEqual.php= ^�g= 5p�6� F vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/LogicalOr.php? ^�g? d�;x� G vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/BooleanAnd.phpA ^�gA ��(� G vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/LogicalXor.phpB ^�gB �G�p� F vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/Spaceship.php@ ^�g@ �� � @ vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/Mul.php2 ^�g2 �i�a� B vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/Minus.php6 ^�g6 �߉� F vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/BooleanOr.php? ^�g? � 72� F vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/BitwiseOr.php> ^�g> Η�0� G vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/ShiftRight.phpA ^�gA �rL0� I vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/NotIdentical.phpF ^�gF ���1� @ vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/Pow.php3 ^�g3 �9�V� D vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/Greater.php: ^�g: ����� D vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/Smaller.php: ^�g: K��� E vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/Coalesce.php= ^�g= �:��� K vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/GreaterOrEqual.phpI ^�gI ���K� G vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/BitwiseAnd.php@ ^�g@ �LK � F vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/Identical.php@ ^�g@ �.?� C vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/Concat.php8 ^�g8 " ɼ� G vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/LogicalAnd.phpB ^�gB �ا�� B vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/Equal.php7 ^�g7 (���� K vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/SmallerOrEqual.phpI ^�gI #��t� A vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/Plus.php4 ^�g4 ~i1� G vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/BitwiseXor.php@ ^�g@ �ݞ�� @ vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/Mod.php2 ^�g2 1��� @ vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/Div.php2 ^�g2 ̒�_� F vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/ShiftLeft.php? ^�g? э��� A vendor/nikic/php-parser/lib/PhpParser/Node/Expr/PropertyFetch.php� ^�g� �DG� ; vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Closure.php� ^�g� <�/5� : vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Throw_.php� ^�g� �ճŤ = vendor/nikic/php-parser/lib/PhpParser/Node/Expr/YieldFrom.php� ^�g� i$��� A vendor/nikic/php-parser/lib/PhpParser/Node/Expr/ArrowFunction.phph ^�gh Ll^Ť > vendor/nikic/php-parser/lib/PhpParser/Node/Expr/ClosureUse.phpw ^�gw p��� A vendor/nikic/php-parser/lib/PhpParser/Node/Expr/ArrayDimFetch.php> ^�g> 0� < vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp.php_ ^�g_ �4A� = vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignRef.php8 ^�g8 ��) � : vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Match_.php� ^�g� x �,� > vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Cast/Bool_.php� ^�g� d��� ? vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Cast/Unset_.php� ^�g� @��� ? vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Cast/Double.php� ^�g� kO#ͤ @ vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Cast/String_.php� ^�g� m��3� @ vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Cast/Object_.php� ^�g� `��̤ = vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Cast/Int_.php� ^�g� ��o=� ? vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Cast/Array_.php� ^�g� 8)J]� I vendor/nikic/php-parser/lib/PhpParser/Node/Expr/NullsafePropertyFetch.php� ^�g� ��Ĥ 8 vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Cast.php1 ^�g1 ��k� ; vendor/nikic/php-parser/lib/PhpParser/Node/Expr/PostDec.php~ ^�g~ ���J� ? vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Instanceof_.phpI ^�gI �>lפ < vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Variable.php� ^�g� %6`�� @ vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignOp/Mul.php� ^�g� U#`ɤ B vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignOp/Minus.php� ^�g� U��� F vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignOp/BitwiseOr.php� ^�g� .��� G vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignOp/ShiftRight.php� ^�g� 7F�� @ vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignOp/Pow.php� ^�g� �|�� E vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignOp/Coalesce.php� ^�g� Q � G vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignOp/BitwiseAnd.php� ^�g� �x� C vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignOp/Concat.php� ^�g� ����� A vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignOp/Plus.php� ^�g� �B� G vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignOp/BitwiseXor.php� ^�g� ( f�� @ vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignOp/Mod.php� ^�g� ǒ߿� @ vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignOp/Div.php� ^�g� c��� F vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignOp/ShiftLeft.php� ^�g� wú� < vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Include_.php� ^�g� O�J�� G vendor/nikic/php-parser/lib/PhpParser/Node/Expr/StaticPropertyFetch.php ^�g ��M � : vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Clone_.php{ ^�g{ �Y�� : vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Array_.php( ^�g( 93�'� > vendor/nikic/php-parser/lib/PhpParser/Node/Expr/ConstFetch.php� ^�g� �l � F vendor/nikic/php-parser/lib/PhpParser/Node/Expr/NullsafeMethodCall.phpS ^�gS �3�ͤ ; vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Ternary.php� ^�g� ��H� > vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BooleanNot.php� ^�g� �$�� 4 vendor/nikic/php-parser/lib/PhpParser/Node/Param.phps ^�gs b��N� 8 vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Use_.php\ ^�g\ �,�� = vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/ClassLike.php ^�g >��7� 7 vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/If_.php* ^�g* �� < vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/EnumCase.php� ^�g� �_:Ǥ ; vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Global_.php� ^�g� ��¤ 9 vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Else_.php� ^�g� wC�� < vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Declare_.phpw ^�gw � ,� < vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Finally_.php� ^�g� �YƤ < vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/TryCatch.php* ^�g* � �� : vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Class_.phpr ^�gr �� = vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/StaticVar.php� ^�g� $�Uq� > vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/InlineHTML.php� ^�g� �i�� = vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Function_.php ^�g ܄�h� 7 vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Do_.php2 ^�g2 ��?�� : vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Unset_.php� ^�g� �c%� B vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/DeclareDeclare.php� ^�g� �ץ1� : vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Catch_.phpe ^�ge �#>�� ; vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Static_.php� ^�g� ��J}� F vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/TraitUseAdaptation.php ^�g !<�� : vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Throw_.php� ^�g� ��� > vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Expression.php� ^�g� +[�� 7 vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Nop.php0 ^�g0 cL �� 9 vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Echo_.php� ^�g� �+�� > vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Interface_.php� ^�g� x�R� Q vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/TraitUseAdaptation/Precedence.phpJ ^�gJ :`�� L vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/TraitUseAdaptation/Alias.php1 ^�g1 �Q9� > vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/ClassConst.php� ^�g� ��GU� @ vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/HaltCompiler.php� ^�g� � )� : vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/While_.php5 ^�g5 �^?�� < vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/TraitUse.php� ^�g� �QM� > vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Namespace_.php� ^�g� FHod� ; vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/ElseIf_.php9 ^�g9 �t�� 9 vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Label.php� ^�g� ��yh� ; vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Switch_.php% ^�g% ߩ'� < vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/GroupUse.php ^�g ���!� 9 vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Case_.php\ ^�g\ �XEu� : vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/UseUse.phpa ^�ga 9�5� : vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Break_.php� ^�g� � � � 9 vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Goto_.php� ^�g� ci��� < vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Property.php� ^�g� �/ � : vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Trait_.php ^�g �p�/� 9 vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Enum_.phpB ^�gB �~�Ȥ : vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Const_.php� ^�g� F=eL� ; vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Return_.php� ^�g� �:� 8 vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/For_.php. ^�g. c�W� = vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Continue_.php� ^�g� �U�� < vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Foreach_.php_ ^�g_ �h�� D vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/PropertyProperty.php� ^�g� �n��� ? vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/ClassMethod.phpx ^�gx ��5� ? vendor/nikic/php-parser/lib/PhpParser/Node/IntersectionType.php� ^�g� aD�� : vendor/nikic/php-parser/lib/PhpParser/Node/ComplexType.phpC ^�gC � �y� 5 vendor/nikic/php-parser/lib/PhpParser/Node/Const_.php� ^�g� ��<Ѥ 3 vendor/nikic/php-parser/lib/PhpParser/Node/Expr.php� ^�g� :���� B vendor/nikic/php-parser/lib/PhpParser/Node/VariadicPlaceholder.php� ^�g� ��E � 7 vendor/nikic/php-parser/lib/PhpParser/Node/MatchArm.php� ^�g� j,q� 2 vendor/nikic/php-parser/lib/PhpParser/Node/Arg.php9 ^�g9 �[��� B vendor/nikic/php-parser/lib/PhpParser/Node/Name/FullyQualified.php� ^�g� !�� � < vendor/nikic/php-parser/lib/PhpParser/Node/Name/Relative.php� ^�g� ħ�J� K vendor/nikic/php-parser/lib/PhpParser/Lexer/TokenEmulator/TokenEmulator.phpm ^�gm m�zG� S vendor/nikic/php-parser/lib/PhpParser/Lexer/TokenEmulator/NullsafeTokenEmulator.php� ^�g� x�,�� O vendor/nikic/php-parser/lib/PhpParser/Lexer/TokenEmulator/EnumTokenEmulator.php� ^�g� %�d� [ vendor/nikic/php-parser/lib/PhpParser/Lexer/TokenEmulator/ReadonlyFunctionTokenEmulator.php� ^�g� �pX�� M vendor/nikic/php-parser/lib/PhpParser/Lexer/TokenEmulator/ReverseEmulator.php ^�g �p�L� M vendor/nikic/php-parser/lib/PhpParser/Lexer/TokenEmulator/FnTokenEmulator.php� ^�g� ���K� S vendor/nikic/php-parser/lib/PhpParser/Lexer/TokenEmulator/ReadonlyTokenEmulator.php[ ^�g[ �_'�� ] vendor/nikic/php-parser/lib/PhpParser/Lexer/TokenEmulator/NumericLiteralSeparatorEmulator.phpe ^�ge NeV� P vendor/nikic/php-parser/lib/PhpParser/Lexer/TokenEmulator/MatchTokenEmulator.php� ^�g� �6~%� W vendor/nikic/php-parser/lib/PhpParser/Lexer/TokenEmulator/FlexibleDocStringEmulator.php} ^�g} �N� � W vendor/nikic/php-parser/lib/PhpParser/Lexer/TokenEmulator/CoaleseEqualTokenEmulator.php ^�g �V&z� M vendor/nikic/php-parser/lib/PhpParser/Lexer/TokenEmulator/KeywordEmulator.php� ^�g� �I� S vendor/nikic/php-parser/lib/PhpParser/Lexer/TokenEmulator/ExplicitOctalEmulator.php� ^�g� �<fB� O vendor/nikic/php-parser/lib/PhpParser/Lexer/TokenEmulator/AttributeEmulator.php� ^�g� *�3� 9 vendor/nikic/php-parser/lib/PhpParser/Lexer/Emulative.php�" ^�g�" LQ�c� ? vendor/nikic/php-parser/lib/PhpParser/PrettyPrinterAbstract.php� ^�g� � �� 5 vendor/nikic/php-parser/lib/PhpParser/NodeVisitor.php� ^�g� Y��� < vendor/nikic/php-parser/lib/PhpParser/ConstExprEvaluator.phpv% ^�gv% ��� 1 vendor/nikic/php-parser/lib/PhpParser/Builder.php� ^�g� �� 4 vendor/jetbrains/phpstorm-stubs/enchant/enchant.stub�) ^�g�) �R�� . vendor/jetbrains/phpstorm-stubs/grpc/grpc.stub�Y ^�g�Y X�K٤ 0 vendor/jetbrains/phpstorm-stubs/mysql/mysql.stub| ^�g| �0{� 0 vendor/jetbrains/phpstorm-stubs/uuid/uuid_c.stub� ^�g� }��j� 2 vendor/jetbrains/phpstorm-stubs/phpdbg/phpdbg.stubg ^�gg AȾO� 3 vendor/jetbrains/phpstorm-stubs/ftp/Connection.stubG ^�gG ��!� , vendor/jetbrains/phpstorm-stubs/ftp/ftp.stub�i ^�g�i �y("� . vendor/jetbrains/phpstorm-stubs/oci8/oci8.stub�o ^�g�o h!p�� 0 vendor/jetbrains/phpstorm-stubs/oci8/oci8v3.stubE9 ^�gE9 � � 2 vendor/jetbrains/phpstorm-stubs/mcrypt/mcrypt.stub�_ ^�g�_ iXV�� < vendor/jetbrains/phpstorm-stubs/libvirt-php/libvirt-php.stub�9 ^�g�9 ��:`� , vendor/jetbrains/phpstorm-stubs/dio/dio.stub�% ^�g�% �'�&� . vendor/jetbrains/phpstorm-stubs/dio/dio_d.stub� ^�g� C � 2 vendor/jetbrains/phpstorm-stubs/docker-compose.ymlZ ^�gZ zN�q� ' vendor/jetbrains/phpstorm-stubs/LICENSEW, ^�gW, M��̤ . vendor/jetbrains/phpstorm-stubs/ssh2/ssh2.stub�Z ^�g�Z ��o� . vendor/jetbrains/phpstorm-stubs/wddx/wddx.stub� ^�g� [L� 8 vendor/jetbrains/phpstorm-stubs/winbinder/winbinder.stubx� ^�gx� �:�� , vendor/jetbrains/phpstorm-stubs/FFI/FFI.stub�M ^�g�M �t�� 4 vendor/jetbrains/phpstorm-stubs/sqlite3/sqlite3.stub�f ^�g�f ��Խ� 0 vendor/jetbrains/phpstorm-stubs/geoip/geoip.stub$ ^�g$ 6 �� . vendor/jetbrains/phpstorm-stubs/yaml/yaml.stubh ^�gh �{�Ȥ 6 vendor/jetbrains/phpstorm-stubs/libevent/libevent.stub"Y ^�g"Y �0� * vendor/jetbrains/phpstorm-stubs/Ev/Ev.stub�� ^�g�� ���r� 8 vendor/jetbrains/phpstorm-stubs/blackfire/blackfire.stubH ^�gH Z�4� 4 vendor/jetbrains/phpstorm-stubs/rpminfo/rpminfo.stub- ^�g- ���� . vendor/jetbrains/phpstorm-stubs/tidy/tidy.stubL� ^�gL� �דN� , vendor/jetbrains/phpstorm-stubs/ast/ast.stub [ ^�g [ ��nΤ 6 vendor/jetbrains/phpstorm-stubs/mbstring/mbstring.stub� ^�g� K �M� 8 vendor/jetbrains/phpstorm-stubs/mapscript/mapscript.stub�� ^�g�� {�|K� 4 vendor/jetbrains/phpstorm-stubs/sockets/sockets.stub= ^�g= `p�� 6 vendor/jetbrains/phpstorm-stubs/wincache/wincache.stuba ^�ga �Ѓ � , vendor/jetbrains/phpstorm-stubs/dom/dom.stuby ^�gy �9�� . vendor/jetbrains/phpstorm-stubs/dom/dom_n.stub� ^�g� ��~� . vendor/jetbrains/phpstorm-stubs/dom/dom_c.stub�_ ^�g�_ ���� , vendor/jetbrains/phpstorm-stubs/SPL/SPL.stub� ^�g� h� � . vendor/jetbrains/phpstorm-stubs/SPL/SPL_f.stubm ^�gm �O:ä / vendor/jetbrains/phpstorm-stubs/SPL/SPL_c1.stub ? ^�g ? L�� 3 vendor/jetbrains/phpstorm-stubs/swoole/aliases.stubX ^�gX ��ᕤ 5 vendor/jetbrains/phpstorm-stubs/swoole/constants.stub�A ^�g�A @�y�� 5 vendor/jetbrains/phpstorm-stubs/swoole/functions.stub8" ^�g8" 6|�� 8 vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Event.stub� ^�g� �w��� < vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Coroutine.stub� ^�g� N�ˤ ? vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Server/Event.stub� ^�g� ��4� > vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Server/Port.stub� ^�g� _{�� @ vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Server/Packet.stub� ^�g� +� �� > vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Server/Task.stub� ^�g� eZ<u� E vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Server/PipeMessage.stub� ^�g� v�D� D vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Server/TaskResult.stub� ^�g� K��� D vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Server/StatusInfo.stub� ^�g� �.��� : vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Process.stub� ^�g� 8<ڋ� 8 vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Error.stubR ^�gR ��T� > vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Http/Server.stub` ^�g` Y�� @ vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Http/Response.stub� ^�g� ��c�� ? vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Http/Request.stub� ^�g� ��],� 9 vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Client.stub ^�g ���Ѥ C vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Client/Exception.stubh ^�gh ���;� F vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Connection/Iterator.stub� ^�g� fo�Ƥ 8 vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Table.stub� ^�g� Ƃwդ A vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Http2/Response.stub ^�g i� @ vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Http2/Request.stub� ^�g� ��H1� < vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Exception.stubZ ^�gZ ���� C vendor/jetbrains/phpstorm-stubs/swoole/Swoole/WebSocket/Server.stub� ^�g� �!Af� G vendor/jetbrains/phpstorm-stubs/swoole/Swoole/WebSocket/CloseFrame.stub� ^�g� �%��� B vendor/jetbrains/phpstorm-stubs/swoole/Swoole/WebSocket/Frame.stub ^�g D� � ? vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Process/Pool.stub� ^�g� L4!� D vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Coroutine/Channel.stub ^�g �O�h� H vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Coroutine/Http/Client.stub) ^�g) g&� R vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Coroutine/Http/Client/Exception.stubw ^�gw ��� H vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Coroutine/Http/Server.stub ^�g �y�*� C vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Coroutine/Client.stub� ^�g� p�ծ� M vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Coroutine/Socket/Exception.stubr ^�gr -| �� D vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Coroutine/Context.stub� ^�g� ���� I vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Coroutine/Http2/Client.stubo ^�go ��G>� S vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Coroutine/Http2/Client/Exception.stubx ^�gx P � C vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Coroutine/System.stub� ^�g� S�Aۤ B vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Coroutine/Redis.stub�m ^�g�m �%T�� C vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Coroutine/Socket.stuba ^�ga �M��� L vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Coroutine/MySQL/Statement.stub� ^�g� �5�� L vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Coroutine/MySQL/Exception.stubq ^�gq Q�ï� B vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Coroutine/MySQL.stub< ^�g< �&� � E vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Coroutine/Iterator.stub� ^�g� 4;� F vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Coroutine/Scheduler.stub� ^�g� �9��� K vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Coroutine/Curl/Exception.stubp ^�gp {�_Ԥ 9 vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Server.stubq& ^�gq& ��EĤ : vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Runtime.stub ^�g ��� 8 vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Timer.stub{ ^�g{ ��U�� A vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Timer/Iterator.stub� ^�g� g8'� @ vendor/jetbrains/phpstorm-stubs/swoole/Swoole/ExitException.stub ^�g �� _� ? vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Redis/Server.stub� ^�g� �?�� 7 vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Lock.stub ^�g �.�n� 9 vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Atomic.stub� ^�g� �eKͤ > vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Atomic/Long.stub� ^�g� � ��� 8 vendor/jetbrains/phpstorm-stubs/couchbase/couchbase.stub�� ^�g�� �C Ƥ : vendor/jetbrains/phpstorm-stubs/com_dotnet/com_dotnet.stubf/ ^�gf/ �b� 2 vendor/jetbrains/phpstorm-stubs/crypto/crypto.stub1? ^�g1? ګפ 2 vendor/jetbrains/phpstorm-stubs/SaxonC/SaxonC.stubl� ^�gl� �# �� , vendor/jetbrains/phpstorm-stubs/pam/pam.stub ^�g s]7� 2 vendor/jetbrains/phpstorm-stubs/pcntl/pcntl_c.stub� ^�g� zEh� 0 vendor/jetbrains/phpstorm-stubs/pcntl/pcntl.stubYX ^�gYX ۖ<Ȥ 2 vendor/jetbrains/phpstorm-stubs/filter/filter.stub�; ^�g�; v2֬� 7 vendor/jetbrains/phpstorm-stubs/tokenizer/PhpToken.stub� ^�g� &��� 8 vendor/jetbrains/phpstorm-stubs/tokenizer/tokenizer.stub� ^�g� �&� . vendor/jetbrains/phpstorm-stubs/zstd/zstd.stub ^�g �L�V� 6 vendor/jetbrains/phpstorm-stubs/simdjson/simdjson.stub/ ^�g/ �P^� B vendor/jetbrains/phpstorm-stubs/intl/IntlDatePatternGenerator.stub ^�g $��J� . vendor/jetbrains/phpstorm-stubs/intl/intl.stub.} ^�g.} �P��� 2 vendor/jetbrains/phpstorm-stubs/intl/IntlChar.stubL/ ^�gL/ ��]t� 2 vendor/jetbrains/phpstorm-stubs/xmlrpc/xmlrpc.stub� ^�g� ���� : vendor/jetbrains/phpstorm-stubs/LuaSandbox/LuaSandbox.stubE ^�gE ��� . vendor/jetbrains/phpstorm-stubs/Phar/Phar.stub(� ^�g(� ��6K� 4 vendor/jetbrains/phpstorm-stubs/PhpStormStubsMap.php"� ^�g"� � nJ� ? vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionFiber.stub� ^�g� *a�� @ vendor/jetbrains/phpstorm-stubs/Reflection/PropertyHookType.stub3 ^�g3 ��F� : vendor/jetbrains/phpstorm-stubs/Reflection/Reflection.stub� ^�g� �C� G vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionClassConstant.stub4 ^�g4 ���|� F vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionEnumUnitCase.stub� ^�g� E;�� @ vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionObject.stub� ^�g� 0��� G vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionZendExtension.stub� ^�g� b{`� J vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionFunctionAbstract.stubh( ^�gh( ��#� C vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionExtension.stub2 ^�g2 �~� B vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionConstant.stub� ^�g� ���|� C vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionReference.stub� ^�g� ؆�5� C vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionNamedType.stubp ^�gp ' � � C vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionParameter.stub�' ^�g�' �E�O� C vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionException.stub� ^�g� �#5�� B vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionFunction.stub� ^�g� b��� H vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionEnumBackedCase.stubP ^�gP �g�� > vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionType.stub� ^�g� � �R� > vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionEnum.stub� ^�g� ��N� C vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionGenerator.stubL ^�gL +�K�� 9 vendor/jetbrains/phpstorm-stubs/Reflection/Reflector.stub� ^�g� �T�� ? vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionClass.stub�\ ^�g�\ ۆ�$� J vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionIntersectionType.stub� ^�g� 6�c8� C vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionAttribute.stub� ^�g� ז�� B vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionProperty.stuba. ^�ga. � -�� C vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionUnionType.stub ^�g ��˜� @ vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionMethod.stubU* ^�gU* ����� 2 vendor/jetbrains/phpstorm-stubs/apache/apache.stub- ^�g- ��L�� ? vendor/jetbrains/phpstorm-stubs/meta/attributes/Deprecated.stub� ^�g� ��k^� = vendor/jetbrains/phpstorm-stubs/meta/attributes/Language.stub� ^�g� �MJ�� > vendor/jetbrains/phpstorm-stubs/meta/attributes/Immutable.stub� ^�g� �a'�� C vendor/jetbrains/phpstorm-stubs/meta/attributes/ExpectedValues.stub� ^�g� ђ~�� P vendor/jetbrains/phpstorm-stubs/meta/attributes/internal/ReturnTypeContract.stubh ^�gh �< x� [ vendor/jetbrains/phpstorm-stubs/meta/attributes/internal/PhpStormStubsElementAvailable.stub� ^�g� e3� T vendor/jetbrains/phpstorm-stubs/meta/attributes/internal/LanguageLevelTypeAware.stubo ^�go ��%�� K vendor/jetbrains/phpstorm-stubs/meta/attributes/internal/TentativeType.stub� ^�g� ()�� 9 vendor/jetbrains/phpstorm-stubs/meta/attributes/Pure.stub� ^�g� ;Ś�� = vendor/jetbrains/phpstorm-stubs/meta/attributes/NoReturn.stub� ^�g� �4��� @ vendor/jetbrains/phpstorm-stubs/meta/attributes/ObjectShape.stub� ^�g� �k p� ? vendor/jetbrains/phpstorm-stubs/meta/attributes/ArrayShape.stubV ^�gV O7�� 4 vendor/jetbrains/phpstorm-stubs/SplType/SplType.stub� ^�g� �o��� . vendor/jetbrains/phpstorm-stubs/pcov/pcov.stub ^�g \�X�� + vendor/jetbrains/phpstorm-stubs/qodana.yaml ^�g 'JX;� / vendor/jetbrains/phpstorm-stubs/regex/ereg.stubz ^�gz =c�P� 6 vendor/jetbrains/phpstorm-stubs/mqseries/mqseries.stub�� ^�g�� 1%� 4 vendor/jetbrains/phpstorm-stubs/imagick/imagick.stubm� ^�gm� �~�� , vendor/jetbrains/phpstorm-stubs/rrd/rrd.stub 0 ^�g 0 ��Τ 2 vendor/jetbrains/phpstorm-stubs/xcache/xcache.stub� ^�g� �^�)� 8 vendor/jetbrains/phpstorm-stubs/standard/standard_9.stub�� ^�g�� /c;/� > vendor/jetbrains/phpstorm-stubs/standard/_standard_manual.stub) ^�g) �ػD� 8 vendor/jetbrains/phpstorm-stubs/standard/standard_7.stub� ^�g� .�Ť 8 vendor/jetbrains/phpstorm-stubs/standard/standard_2.stub"� ^�g"� -�Qʤ 8 vendor/jetbrains/phpstorm-stubs/standard/standard_5.stubÄ ^�gÄ � 4� 8 vendor/jetbrains/phpstorm-stubs/standard/standard_0.stub$� ^�g$� ��>�� 8 vendor/jetbrains/phpstorm-stubs/standard/standard_3.stubyy ^�gyy n�N� 8 vendor/jetbrains/phpstorm-stubs/standard/standard_4.stub�� ^�g�� g�R�� 8 vendor/jetbrains/phpstorm-stubs/standard/standard_1.stubl� ^�gl� �� O� 9 vendor/jetbrains/phpstorm-stubs/standard/standard_10.stub� ^�g� @�G� > vendor/jetbrains/phpstorm-stubs/standard/standard_defines.stub � ^�g � ~�۞� 6 vendor/jetbrains/phpstorm-stubs/standard/password.stub' ^�g' �O�u� 4 vendor/jetbrains/phpstorm-stubs/standard/_types.stub�H ^�g�H �� W� 8 vendor/jetbrains/phpstorm-stubs/standard/standard_6.stub�� ^�g�� b�Q� 8 vendor/jetbrains/phpstorm-stubs/standard/standard_8.stub� ^�g� �=N�� 3 vendor/jetbrains/phpstorm-stubs/standard/basic.stub�, ^�g�, ND� 2 vendor/jetbrains/phpstorm-stubs/brotli/brotli.stub� ^�g� p<5ʤ 6 vendor/jetbrains/phpstorm-stubs/readline/readline.stubC ^�gC c�� 8 vendor/jetbrains/phpstorm-stubs/aerospike/aerospike.stub24 ^�g24 ٸe� 4 vendor/jetbrains/phpstorm-stubs/aerospike/Bytes.stub ^�g ��ʍ� 0 vendor/jetbrains/phpstorm-stubs/zend/zend_d.stub ^�g �-|j� 0 vendor/jetbrains/phpstorm-stubs/zend/zend_f.stub. ^�g. 6��x� . vendor/jetbrains/phpstorm-stubs/zend/zend.stub�X ^�g�X ��B � : vendor/jetbrains/phpstorm-stubs/libsodium/libsodium_d.stub@ ^�g@ �+�Ƥ 8 vendor/jetbrains/phpstorm-stubs/libsodium/libsodium.stube< ^�ge< �`-� : vendor/jetbrains/phpstorm-stubs/libsodium/libsodium_f.stub� ^�g� �ړ+� 2 vendor/jetbrains/phpstorm-stubs/sqlsrv/sqlsrv.stub~� ^�g~� ��i� . vendor/jetbrains/phpstorm-stubs/fann/fann.stubh� ^�gh� ��a*� 6 vendor/jetbrains/phpstorm-stubs/fileinfo/fileinfo.stubr! ^�gr! WY1� , vendor/jetbrains/phpstorm-stubs/svn/svn.stubl� ^�gl� � R� 0 vendor/jetbrains/phpstorm-stubs/xdiff/xdiff.stub"( ^�g"( ���� 8 vendor/jetbrains/phpstorm-stubs/redis/RedisSentinel.stub� ^�g� z �A� 7 vendor/jetbrains/phpstorm-stubs/redis/RedisCluster.stub,� ^�g,� ��IU� 5 vendor/jetbrains/phpstorm-stubs/redis/RedisArray.stubL ^�gL f�L� 0 vendor/jetbrains/phpstorm-stubs/redis/Redis.stub�� ^�g�� *��Y� 0 vendor/jetbrains/phpstorm-stubs/event/event.stub�� ^�g�� �zI� : vendor/jetbrains/phpstorm-stubs/solr/Utils/SolrObject.stub ^�g �t �� 9 vendor/jetbrains/phpstorm-stubs/solr/Utils/SolrUtils.stub� ^�g� ��O� F vendor/jetbrains/phpstorm-stubs/solr/Queries/SolrCollapseFunction.stub� ^�g� E � ; vendor/jetbrains/phpstorm-stubs/solr/Queries/SolrQuery.stubs> ^�gs> ��� A vendor/jetbrains/phpstorm-stubs/solr/Queries/SolrDisMaxQuery.stub- ^�g- I!�� < vendor/jetbrains/phpstorm-stubs/solr/Queries/SolrParams.stub� ^�g� (�D� F vendor/jetbrains/phpstorm-stubs/solr/Queries/SolrModifiableParams.stubk ^�gk %��� G vendor/jetbrains/phpstorm-stubs/solr/Responses/SolrGenericResponse.stub+ ^�g+ ����� E vendor/jetbrains/phpstorm-stubs/solr/Responses/SolrQueryResponse.stub ^�g �ɤ @ vendor/jetbrains/phpstorm-stubs/solr/Responses/SolrResponse.stub� ^�g� /I�%� F vendor/jetbrains/phpstorm-stubs/solr/Responses/SolrUpdateResponse.stub% ^�g% >H�٤ D vendor/jetbrains/phpstorm-stubs/solr/Responses/SolrPingResponse.stub� ^�g� ޡ�ޤ 3 vendor/jetbrains/phpstorm-stubs/solr/constants.stubD ^�gD �� c� 3 vendor/jetbrains/phpstorm-stubs/solr/functions.stub� ^�g� A�A� @ vendor/jetbrains/phpstorm-stubs/solr/Documents/SolrDocument.stub�/ ^�g�/ �F&�� E vendor/jetbrains/phpstorm-stubs/solr/Documents/SolrInputDocument.stub�& ^�g�& ?J �� E vendor/jetbrains/phpstorm-stubs/solr/Documents/SolrDocumentField.stub ^�g \� B vendor/jetbrains/phpstorm-stubs/solr/Exceptions/SolrException.stub� ^�g� & � Q vendor/jetbrains/phpstorm-stubs/solr/Exceptions/SolrIllegalArgumentException.stub� ^�g� )�4� H vendor/jetbrains/phpstorm-stubs/solr/Exceptions/SolrServerException.stuby ^�gy C�$�� H vendor/jetbrains/phpstorm-stubs/solr/Exceptions/SolrClientException.stubs ^�gs �GP � R vendor/jetbrains/phpstorm-stubs/solr/Exceptions/SolrIllegalOperationException.stub� ^�g� -N%�� [ vendor/jetbrains/phpstorm-stubs/solr/Exceptions/SolrMissingMandatoryParameterException.stub� ^�g� ��n�� 4 vendor/jetbrains/phpstorm-stubs/solr/SolrClient.stub�M ^�g�M C|��� 8 vendor/jetbrains/phpstorm-stubs/xlswriter/xlswriter.stub'> ^�g'> ��@�� 0 vendor/jetbrains/phpstorm-stubs/mssql/mssql.stub6M ^�g6M �W˟� 8 vendor/jetbrains/phpstorm-stubs/SimpleXML/SimpleXML.stubQL ^�gQL �O�� . vendor/jetbrains/phpstorm-stubs/snmp/snmp.stub� ^�g� ���� 0 vendor/jetbrains/phpstorm-stubs/relay/Event.stub� ^�g� �,7A� 2 vendor/jetbrains/phpstorm-stubs/relay/KeyType.stub� ^�g� �ۼ�� 0 vendor/jetbrains/phpstorm-stubs/relay/Relay.stub; ^�g; �� 0 vendor/jetbrains/phpstorm-stubs/relay/Table.stubr ^�gr G�ͤ 4 vendor/jetbrains/phpstorm-stubs/relay/Exception.stubc ^�gc r��!� 2 vendor/jetbrains/phpstorm-stubs/relay/Cluster.stub�? ^�g�? ��_p� 3 vendor/jetbrains/phpstorm-stubs/relay/Sentinel.stub� ^�g� �&vY� 1 vendor/jetbrains/phpstorm-stubs/relay/Events.stub� ^�g� ��)� @ vendor/jetbrains/phpstorm-stubs/opentelemetry/opentelemetry.stubP ^�gP ���� 0 vendor/jetbrains/phpstorm-stubs/Core/Core_c.stubԋ ^�gԋ �6�� . vendor/jetbrains/phpstorm-stubs/Core/Core.stub_� ^�g_� R���� 0 vendor/jetbrains/phpstorm-stubs/Core/Core_d.stub $ ^�g $ Zy�� < vendor/jetbrains/phpstorm-stubs/elastic_apm/elastic_apm.stub�~ ^�g�~ ���� . vendor/jetbrains/phpstorm-stubs/hash/hash.stub�E ^�g�E �̠�� , vendor/jetbrains/phpstorm-stubs/fpm/fpm.stub� ^�g� �B�� , vendor/jetbrains/phpstorm-stubs/lzf/lzf.stub� ^�g� ���Ƥ 2 vendor/jetbrains/phpstorm-stubs/mysqli/mysqli.stub2� ^�g2� ?� �� 2 vendor/jetbrains/phpstorm-stubs/cubrid/cubrid.stubt� ^�gt� �� ~� 4 vendor/jetbrains/phpstorm-stubs/ncurses/ncurses.stub� ^�g� *�֩� , vendor/jetbrains/phpstorm-stubs/zmq/zmq.stubzu ^�gzu ��Z� 8 vendor/jetbrains/phpstorm-stubs/interbase/interbase.stub�� ^�g�� ���� 5 vendor/jetbrains/phpstorm-stubs/sybase/sybase_ct.stub7 ^�g7 #��!� 6 vendor/jetbrains/phpstorm-stubs/igbinary/igbinary.stub� ^�g� o/�� 2 vendor/jetbrains/phpstorm-stubs/pspell/pspell.stubq. ^�gq. �0\� 4 vendor/jetbrains/phpstorm-stubs/pspell/pspell_c.stub ^�g R�� � + vendor/jetbrains/phpstorm-stubs/runTests.sh` ^�g` �Rz1� 6 vendor/jetbrains/phpstorm-stubs/pthreads/pthreads.stub�H ^�g�H �>9�� 4 vendor/jetbrains/phpstorm-stubs/sysvmsg/sysvmsg.stub�& ^�g�& ��jΤ : vendor/jetbrains/phpstorm-stubs/couchbase_v2/toplevel.stubW ^�gW a->� ; vendor/jetbrains/phpstorm-stubs/couchbase_v2/couchbase.stub�� ^�g�� d�z � . vendor/jetbrains/phpstorm-stubs/v8js/v8js.stub ^�g �U�9� / vendor/jetbrains/phpstorm-stubs/http/http3.stub]� ^�g]� ���<� . vendor/jetbrains/phpstorm-stubs/http/http.stub�� ^�g�� ���� . vendor/jetbrains/phpstorm-stubs/ming/ming.stubr" ^�gr" 2�: � R vendor/jetbrains/phpstorm-stubs/simple_kafka_client/SimpleKafkaClient/Message.stub� ^�g� k� ^ vendor/jetbrains/phpstorm-stubs/simple_kafka_client/SimpleKafkaClient/Metadata/Collection.stub ^�g ���� ] vendor/jetbrains/phpstorm-stubs/simple_kafka_client/SimpleKafkaClient/Metadata/Partition.stub� ^�g� �g� Z vendor/jetbrains/phpstorm-stubs/simple_kafka_client/SimpleKafkaClient/Metadata/Broker.stub9 ^�g9 �uo`� Y vendor/jetbrains/phpstorm-stubs/simple_kafka_client/SimpleKafkaClient/Metadata/Topic.stubS ^�gS \�� ^ vendor/jetbrains/phpstorm-stubs/simple_kafka_client/SimpleKafkaClient/KafkaErrorException.stub� ^�g� �i',� S vendor/jetbrains/phpstorm-stubs/simple_kafka_client/SimpleKafkaClient/Producer.stub� ^�g� И�� T vendor/jetbrains/phpstorm-stubs/simple_kafka_client/SimpleKafkaClient/Exception.stubd ^�gd �Y�v� S vendor/jetbrains/phpstorm-stubs/simple_kafka_client/SimpleKafkaClient/Consumer.stubW ^�gW ����� S vendor/jetbrains/phpstorm-stubs/simple_kafka_client/SimpleKafkaClient/Metadata.stub9 ^�g9 !�a� Y vendor/jetbrains/phpstorm-stubs/simple_kafka_client/SimpleKafkaClient/TopicPartition.stub& ^�g& �>�~� X vendor/jetbrains/phpstorm-stubs/simple_kafka_client/SimpleKafkaClient/Configuration.stubx ^�gx ռv�� P vendor/jetbrains/phpstorm-stubs/simple_kafka_client/SimpleKafkaClient/Topic.stub� ^�g� � � � J vendor/jetbrains/phpstorm-stubs/simple_kafka_client/SimpleKafkaClient.stub� ^�g� �!��� B vendor/jetbrains/phpstorm-stubs/simple_kafka_client/functions.stub� ^�g� B�Q�� 2 vendor/jetbrains/phpstorm-stubs/random/random.stub� ^�g� ^�5� . vendor/jetbrains/phpstorm-stubs/geos/geos.stub�A ^�g�A � �U� . vendor/jetbrains/phpstorm-stubs/date/date.stub+� ^�g+� �s�� 0 vendor/jetbrains/phpstorm-stubs/date/date_c.stub ^�g ?Ao�� 0 vendor/jetbrains/phpstorm-stubs/date/date_d.stub" ^�g" ��e�� 4 vendor/jetbrains/phpstorm-stubs/sysvsem/sysvsem.stub� ^�g� zX� 0 vendor/jetbrains/phpstorm-stubs/iconv/iconv.stub�5 ^�g�5 1�+G� . vendor/jetbrains/phpstorm-stubs/pcre/pcre.stubzP ^�gzP ��Y�� . vendor/jetbrains/phpstorm-stubs/judy/judy.stubF" ^�gF" q��3� 8 vendor/jetbrains/phpstorm-stubs/ZendCache/ZendCache.stub ^�g �ab� 4 vendor/jetbrains/phpstorm-stubs/leveldb/LevelDB.stub� ^�g� ;��� . vendor/jetbrains/phpstorm-stubs/exif/exif.stub� ^�g� 0 Ѥ 1 vendor/jetbrains/phpstorm-stubs/svm/SVMModel.stub� ^�g� ��p� , vendor/jetbrains/phpstorm-stubs/svm/SVM.stub� ^�g� ��g� . vendor/jetbrains/phpstorm-stubs/amqp/amqp.stub3� ^�g3� {� 4 vendor/jetbrains/phpstorm-stubs/suhosin/suhosin.stub� ^�g� � �Q� 6 vendor/jetbrains/phpstorm-stubs/memcache/memcache.stub$R ^�g$R U��*� . vendor/jetbrains/phpstorm-stubs/odbc/odbc.stub�y ^�g�y ���� : vendor/jetbrains/phpstorm-stubs/frankenphp/frankenphp.stub� ^�g� x���� 2 vendor/jetbrains/phpstorm-stubs/sodium/sodium.stub�� ^�g�� � �D� 2 vendor/jetbrains/phpstorm-stubs/xhprof/xhprof.stub� ^�g� �g"դ . vendor/jetbrains/phpstorm-stubs/sync/sync.stubi7 ^�gi7 VB�� 4 vendor/jetbrains/phpstorm-stubs/gearman/gearman.stub� ^�g� ଉ�� . vendor/jetbrains/phpstorm-stubs/zlib/zlib.stub�K ^�g�K �Z�Ԥ 9 vendor/jetbrains/phpstorm-stubs/Zend OPcache/OPcache.stubm ^�gm �I�m� 4 vendor/jetbrains/phpstorm-stubs/gmagick/gmagick.stub�j ^�g�j Y\� � > vendor/jetbrains/phpstorm-stubs/win32service/win32service.stubEc ^�gEc �R�ۤ B vendor/jetbrains/phpstorm-stubs/uploadprogress/uploadprogress.stub ^�g �r� 8 vendor/jetbrains/phpstorm-stubs/zookeeper/zookeeper.stub") ^�g") ޛ� 0 vendor/jetbrains/phpstorm-stubs/curl/curl_d.stubN ^�gN r.W?� . vendor/jetbrains/phpstorm-stubs/curl/curl.stubs ^�gs ���� 8 vendor/jetbrains/phpstorm-stubs/curl/CURLStringFile.stub� ^�g� @b� 2 vendor/jetbrains/phpstorm-stubs/pgsql/pgsql_c.stub� ^�g� ��� 0 vendor/jetbrains/phpstorm-stubs/pgsql/pgsql.stubs ^�gs � Tj� 2 vendor/jetbrains/phpstorm-stubs/xdebug/xdebug.stub�3 ^�g�3 ^Ȥ 4 vendor/jetbrains/phpstorm-stubs/rdkafka/RdKafka.stubq ^�gq �;�Ҥ 6 vendor/jetbrains/phpstorm-stubs/rdkafka/constants.stub�# ^�g�# � ��� 6 vendor/jetbrains/phpstorm-stubs/rdkafka/functions.stub ^�g ��� < vendor/jetbrains/phpstorm-stubs/rdkafka/RdKafka/Message.stubr ^�gr b��W� H vendor/jetbrains/phpstorm-stubs/rdkafka/RdKafka/Metadata/Collection.stub� ^�g� �L�� G vendor/jetbrains/phpstorm-stubs/rdkafka/RdKafka/Metadata/Partition.stub� ^�g� �� D vendor/jetbrains/phpstorm-stubs/rdkafka/RdKafka/Metadata/Broker.stub� ^�g� IQuR� C vendor/jetbrains/phpstorm-stubs/rdkafka/RdKafka/Metadata/Topic.stub ^�g ��c� G vendor/jetbrains/phpstorm-stubs/rdkafka/RdKafka/KafkaConsumerTopic.stub ^�g �C�٤ 9 vendor/jetbrains/phpstorm-stubs/rdkafka/RdKafka/Conf.stubq ^�gq ���8� B vendor/jetbrains/phpstorm-stubs/rdkafka/RdKafka/ProducerTopic.stuba ^�ga �� � H vendor/jetbrains/phpstorm-stubs/rdkafka/RdKafka/KafkaErrorException.stub� ^�g� Q��� = vendor/jetbrains/phpstorm-stubs/rdkafka/RdKafka/Producer.stub9 ^�g9 �߲ � > vendor/jetbrains/phpstorm-stubs/rdkafka/RdKafka/Exception.stubA ^�gA D/Q�� > vendor/jetbrains/phpstorm-stubs/rdkafka/RdKafka/TopicConf.stub ^�g �x�� = vendor/jetbrains/phpstorm-stubs/rdkafka/RdKafka/Consumer.stub� ^�g� �T�Y� = vendor/jetbrains/phpstorm-stubs/rdkafka/RdKafka/Metadata.stub� ^�g� ��ώ� B vendor/jetbrains/phpstorm-stubs/rdkafka/RdKafka/KafkaConsumer.stubq ^�gq F�!� C vendor/jetbrains/phpstorm-stubs/rdkafka/RdKafka/TopicPartition.stub! ^�g! �9<� : vendor/jetbrains/phpstorm-stubs/rdkafka/RdKafka/Topic.stub{ ^�g{ �t{=� B vendor/jetbrains/phpstorm-stubs/rdkafka/RdKafka/ConsumerTopic.stub ^�g � �>� : vendor/jetbrains/phpstorm-stubs/rdkafka/RdKafka/Queue.stub� ^�g� ��hh� 4 vendor/jetbrains/phpstorm-stubs/gettext/gettext.stub\ ^�g\ f�� 4 vendor/jetbrains/phpstorm-stubs/ibm_db2/ibm_db2.stub�� ^�g�� �̯� . vendor/jetbrains/phpstorm-stubs/json/json.stub�4 ^�g�4 �tA� 0 vendor/jetbrains/phpstorm-stubs/posix/posix.stubTk ^�gTk d� �� 4 vendor/jetbrains/phpstorm-stubs/sysvshm/sysvshm.stub> ^�g> �� � / vendor/jetbrains/phpstorm-stubs/Inspections.xml� ^�g� wl� 2 vendor/jetbrains/phpstorm-stubs/radius/radius.stub�G ^�g�G �4g�� 8 vendor/jetbrains/phpstorm-stubs/memcached/memcached.stub�� ^�g�� H@�� 4 vendor/jetbrains/phpstorm-stubs/inotify/inotify.stubN ^�gN n��� 0 vendor/jetbrains/phpstorm-stubs/shmop/shmop.stub� ^�g� �2ɤ 2 vendor/jetbrains/phpstorm-stubs/expect/expect.stub� ^�g� I�.Ȥ , vendor/jetbrains/phpstorm-stubs/lua/lua.stub< ^�g< � � 0 vendor/jetbrains/phpstorm-stubs/xxtea/xxtea.stub� ^�g� �$nڤ 8 vendor/jetbrains/phpstorm-stubs/mailparse/mailparse.stubw ^�gw �r� , vendor/jetbrains/phpstorm-stubs/eio/eio.stubfy ^�gfy �� 2 vendor/jetbrains/phpstorm-stubs/mongodb/Query.stub� ^�g� �ԶǤ < vendor/jetbrains/phpstorm-stubs/mongodb/CursorInterface.stub� ^�g� �� � 7 vendor/jetbrains/phpstorm-stubs/mongodb/WriteError.stub` ^�g` __K�� 8 vendor/jetbrains/phpstorm-stubs/mongodb/WriteResult.stubd ^�gd ݚ�� 4 vendor/jetbrains/phpstorm-stubs/mongodb/Command.stub� ^�g� �d� 4 vendor/jetbrains/phpstorm-stubs/mongodb/Manager.stub�* ^�g�* �dk�� ; vendor/jetbrains/phpstorm-stubs/mongodb/ReadPreference.stubD ^�gD ϣ��� = vendor/jetbrains/phpstorm-stubs/mongodb/ClientEncryption.stubf ^�gf 8DZ9� 6 vendor/jetbrains/phpstorm-stubs/mongodb/BulkWrite.stub� ^�g� ��#Z� U vendor/jetbrains/phpstorm-stubs/mongodb/Monitoring/ServerHeartbeatSucceededEvent.stubU ^�gU �2y{� I vendor/jetbrains/phpstorm-stubs/mongodb/Monitoring/CommandSubscriber.stub� ^�g� ;O�� M vendor/jetbrains/phpstorm-stubs/mongodb/Monitoring/CommandSucceededEvent.stub� ^�g� ��u� J vendor/jetbrains/phpstorm-stubs/mongodb/Monitoring/CommandFailedEvent.stub� ^�g� c됒� E vendor/jetbrains/phpstorm-stubs/mongodb/Monitoring/LogSubscriber.stub� ^�g� n̅� F vendor/jetbrains/phpstorm-stubs/mongodb/Monitoring/SDAMSubscriber.stub� ^�g� Ɛ� B vendor/jetbrains/phpstorm-stubs/mongodb/Monitoring/Subscriber.stub� ^�g� �� J vendor/jetbrains/phpstorm-stubs/mongodb/Monitoring/ServerChangedEvent.stub� ^�g� �p� K vendor/jetbrains/phpstorm-stubs/mongodb/Monitoring/CommandStartedEvent.stub ^�g T��� R vendor/jetbrains/phpstorm-stubs/mongodb/Monitoring/ServerHeartbeatFailedEvent.stub] ^�g] �5��� S vendor/jetbrains/phpstorm-stubs/mongodb/Monitoring/ServerHeartbeatStartedEvent.stubx ^�gx �x�� L vendor/jetbrains/phpstorm-stubs/mongodb/Monitoring/TopologyChangedEvent.stub� ^�g� e4��� I vendor/jetbrains/phpstorm-stubs/mongodb/Monitoring/ServerClosedEvent.stubr ^�gr :��S� A vendor/jetbrains/phpstorm-stubs/mongodb/Monitoring/functions.stubu ^�gu ƽg� K vendor/jetbrains/phpstorm-stubs/mongodb/Monitoring/TopologyClosedEvent.stub� ^�g� �89�� J vendor/jetbrains/phpstorm-stubs/mongodb/Monitoring/ServerOpeningEvent.stubv ^�gv �6�2� L vendor/jetbrains/phpstorm-stubs/mongodb/Monitoring/TopologyOpeningEvent.stub� ^�g� Y�Wu� @ vendor/jetbrains/phpstorm-stubs/mongodb/TopologyDescription.stub� ^�g� �, � 5 vendor/jetbrains/phpstorm-stubs/mongodb/CursorId.stubw ^�gw �:?� 8 vendor/jetbrains/phpstorm-stubs/mongodb/BSON/Binary.stub� ^�g� ?��� E vendor/jetbrains/phpstorm-stubs/mongodb/BSON/Decimal128Interface.stub8 ^�g8 �L=p� 8 vendor/jetbrains/phpstorm-stubs/mongodb/BSON/MaxKey.stub� ^�g� ��W� 8 vendor/jetbrains/phpstorm-stubs/mongodb/BSON/Symbol.stub/ ^�g/ R���� A vendor/jetbrains/phpstorm-stubs/mongodb/BSON/MinKeyInterface.stub ^�g G�u�� = vendor/jetbrains/phpstorm-stubs/mongodb/BSON/Persistable.stub� ^�g� !t�� = vendor/jetbrains/phpstorm-stubs/mongodb/BSON/UTCDateTime.stubN ^�gN d�� � A vendor/jetbrains/phpstorm-stubs/mongodb/BSON/BinaryInterface.stub� ^�g� �0>F� A vendor/jetbrains/phpstorm-stubs/mongodb/BSON/MaxKeyInterface.stub ^�g ���#� E vendor/jetbrains/phpstorm-stubs/mongodb/BSON/JavascriptInterface.stub� ^�g� ]O؇� : vendor/jetbrains/phpstorm-stubs/mongodb/BSON/Document.stub� ^�g� hb�T� ; vendor/jetbrains/phpstorm-stubs/mongodb/BSON/Timestamp.stubq ^�gq g�H� @ vendor/jetbrains/phpstorm-stubs/mongodb/BSON/RegexInterface.stube ^�ge ���m� = vendor/jetbrains/phpstorm-stubs/mongodb/BSON/PackedArray.stub� ^�g� ���פ D vendor/jetbrains/phpstorm-stubs/mongodb/BSON/TimestampInterface.stub� ^�g� E �p� 6 vendor/jetbrains/phpstorm-stubs/mongodb/BSON/Type.stub� ^�g� 'J�-� : vendor/jetbrains/phpstorm-stubs/mongodb/BSON/ObjectId.stub� ^�g� �tl?� > vendor/jetbrains/phpstorm-stubs/mongodb/BSON/Serializable.stub� ^�g� @}��� ; vendor/jetbrains/phpstorm-stubs/mongodb/BSON/DBPointer.stub� ^�g� ��7� @ vendor/jetbrains/phpstorm-stubs/mongodb/BSON/Unserializable.stub� ^�g� "t�_� 8 vendor/jetbrains/phpstorm-stubs/mongodb/BSON/MinKey.stub� ^�g� ��� ; vendor/jetbrains/phpstorm-stubs/mongodb/BSON/functions.stub^ ^�g^ 9�� C vendor/jetbrains/phpstorm-stubs/mongodb/BSON/ObjectIdInterface.stub� ^�g� C_�� F vendor/jetbrains/phpstorm-stubs/mongodb/BSON/UTCDateTimeInterface.stub+ ^�g+ 2,�� ; vendor/jetbrains/phpstorm-stubs/mongodb/BSON/Undefined.stubO ^�gO U���� 7 vendor/jetbrains/phpstorm-stubs/mongodb/BSON/Regex.stubV ^�gV u�k� : vendor/jetbrains/phpstorm-stubs/mongodb/BSON/Iterator.stub� ^�g� �� < vendor/jetbrains/phpstorm-stubs/mongodb/BSON/Decimal128.stub ^�g �W�Ϥ < vendor/jetbrains/phpstorm-stubs/mongodb/BSON/Javascript.stub� ^�g� #�<Ѥ 7 vendor/jetbrains/phpstorm-stubs/mongodb/BSON/Int64.stubO ^�gO ���$� O vendor/jetbrains/phpstorm-stubs/mongodb/Exception/InvalidArgumentException.stubS ^�gS 5k�:� O vendor/jetbrains/phpstorm-stubs/mongodb/Exception/UnexpectedValueException.stubj ^�gj �Mm� N vendor/jetbrains/phpstorm-stubs/mongodb/Exception/AuthenticationException.stub5 ^�g5 K�� E vendor/jetbrains/phpstorm-stubs/mongodb/Exception/WriteException.stub� ^�g� G��g� E vendor/jetbrains/phpstorm-stubs/mongodb/Exception/LogicException.stub ^�g Z�Ť L vendor/jetbrains/phpstorm-stubs/mongodb/Exception/WriteConcernException.stuby ^�gy ���� G vendor/jetbrains/phpstorm-stubs/mongodb/Exception/RuntimeException.stubF ^�gF �E��� @ vendor/jetbrains/phpstorm-stubs/mongodb/Exception/Exception.stub: ^�g: M �� G vendor/jetbrains/phpstorm-stubs/mongodb/Exception/CommandException.stub ^�g K��*� J vendor/jetbrains/phpstorm-stubs/mongodb/Exception/EncryptionException.stub, ^�g, �5�� I vendor/jetbrains/phpstorm-stubs/mongodb/Exception/BulkWriteException.stub ^�g ���� M vendor/jetbrains/phpstorm-stubs/mongodb/Exception/SSLConnectionException.stub2 ^�g2 ��� J vendor/jetbrains/phpstorm-stubs/mongodb/Exception/ConnectionException.stubG ^�gG Al�� Q vendor/jetbrains/phpstorm-stubs/mongodb/Exception/ConnectionTimeoutException.stubd ^�gd � -;� P vendor/jetbrains/phpstorm-stubs/mongodb/Exception/ExecutionTimeoutException.stubH ^�gH A� � F vendor/jetbrains/phpstorm-stubs/mongodb/Exception/ServerException.stub� ^�g� ��`� 3 vendor/jetbrains/phpstorm-stubs/mongodb/Server.stub�' ^�g�' ;�d� > vendor/jetbrains/phpstorm-stubs/mongodb/WriteConcernError.stub ^�g �V�Z� 6 vendor/jetbrains/phpstorm-stubs/mongodb/ServerApi.stub� ^�g� ���֤ 3 vendor/jetbrains/phpstorm-stubs/mongodb/Cursor.stub� ^�g� �H� 4 vendor/jetbrains/phpstorm-stubs/mongodb/Session.stubT ^�gT ڸ7�� > vendor/jetbrains/phpstorm-stubs/mongodb/ServerDescription.stub� ^�g� .���� 8 vendor/jetbrains/phpstorm-stubs/mongodb/ReadConcern.stub ^�g w���� 9 vendor/jetbrains/phpstorm-stubs/mongodb/WriteConcern.stubE ^�gE S�� 4 vendor/jetbrains/phpstorm-stubs/mongodb/mongodb.stubF ^�gF �.��� 0 vendor/jetbrains/phpstorm-stubs/gnupg/gnupg.stubZI ^�gZI �� 3� 6 vendor/jetbrains/phpstorm-stubs/calendar/calendar.stub�& ^�g�& �fxݤ 0 vendor/jetbrains/phpstorm-stubs/mongo/mongo.stub�� ^�g�� ;n�� 4 vendor/jetbrains/phpstorm-stubs/ldap/Connection.stubH ^�gH � � . vendor/jetbrains/phpstorm-stubs/ldap/ldap.stub�� ^�g�� ��� 5 vendor/jetbrains/phpstorm-stubs/ldap/ResultEntry.stubI ^�gI Px�_� 0 vendor/jetbrains/phpstorm-stubs/ldap/Result.stubD ^�gD ��vZ� , vendor/jetbrains/phpstorm-stubs/xml/xml.stub�Z ^�g�Z ��]!� 1 vendor/jetbrains/phpstorm-stubs/Parle/RLexer.stub� ^�g� w��� 9 vendor/jetbrains/phpstorm-stubs/Parle/LexerException.stubw ^�gw ^Ut�� 0 vendor/jetbrains/phpstorm-stubs/Parle/Lexer.stub* ^�g* ;� �� 2 vendor/jetbrains/phpstorm-stubs/Parle/RParser.stub� ^�g� �ɥФ 1 vendor/jetbrains/phpstorm-stubs/Parle/Parser.stub, ^�g, ���� 0 vendor/jetbrains/phpstorm-stubs/Parle/Token.stub� ^�g� N���� 4 vendor/jetbrains/phpstorm-stubs/Parle/ErrorInfo.stubA ^�gA �� : vendor/jetbrains/phpstorm-stubs/Parle/ParserException.stubx ^�gx L�� 0 vendor/jetbrains/phpstorm-stubs/Parle/Stack.stubA ^�gA .>o_� 8 vendor/jetbrains/phpstorm-stubs/cassandra/cassandra.stub ^�g 3��Ԥ ; vendor/jetbrains/phpstorm-stubs/session/SessionHandler.stub[( ^�g[( m�f � 4 vendor/jetbrains/phpstorm-stubs/session/session.stubiG ^�giG ���ޤ 4 vendor/jetbrains/phpstorm-stubs/meminfo/meminfo.stub� ^�g� �rbɤ 0 vendor/jetbrains/phpstorm-stubs/oauth/oauth.stubb ^�gb ��bp� 2 vendor/jetbrains/phpstorm-stubs/bcmath/bcmath.stub�# ^�g�# ��b� 2 vendor/jetbrains/phpstorm-stubs/pdflib/PDFlib.stub/T ^�g/T 5% K� ? vendor/jetbrains/phpstorm-stubs/superglobals/_superglobals.stub ^�g Fe��� 8 vendor/jetbrains/phpstorm-stubs/xmlwriter/xmlwriter.stub�� ^�g�� O�< � . vendor/jetbrains/phpstorm-stubs/apcu/apcu.stub[n ^�g[n F��� * vendor/jetbrains/phpstorm-stubs/pq/pq.stub�+ ^�g�+ ��� 0 vendor/jetbrains/phpstorm-stubs/soap/soap_n.stub� ^�g� u�� . vendor/jetbrains/phpstorm-stubs/soap/soap.stubG� ^�gG� ��Z� Q vendor/jetbrains/phpstorm-stubs/parallel/parallel/Channel/Error/IllegalValue.stubk ^�gk ��� N vendor/jetbrains/phpstorm-stubs/parallel/parallel/Channel/Error/Existence.stubh ^�gh ��yä K vendor/jetbrains/phpstorm-stubs/parallel/parallel/Channel/Error/Closed.stube ^�ge ��z � D vendor/jetbrains/phpstorm-stubs/parallel/parallel/Channel/Error.stubK ^�gK ��%� ; vendor/jetbrains/phpstorm-stubs/parallel/parallel/Sync.stub� ^�g� 4�R�� > vendor/jetbrains/phpstorm-stubs/parallel/parallel/Channel.stub( ^�g( ��&� < vendor/jetbrains/phpstorm-stubs/parallel/parallel/Error.stub: ^�g: {��� = vendor/jetbrains/phpstorm-stubs/parallel/parallel/Future.stub` ^�g` .?Dä N vendor/jetbrains/phpstorm-stubs/parallel/parallel/Sync/Error/IllegalValue.stube ^�ge > w� A vendor/jetbrains/phpstorm-stubs/parallel/parallel/Sync/Error.stubH ^�gH ��b� K vendor/jetbrains/phpstorm-stubs/parallel/parallel/Events/Error/Timeout.stubd ^�gd �J�6� M vendor/jetbrains/phpstorm-stubs/parallel/parallel/Events/Error/Existence.stubf ^�gf �R�b� C vendor/jetbrains/phpstorm-stubs/parallel/parallel/Events/Event.stub� ^�g� ̀�8� C vendor/jetbrains/phpstorm-stubs/parallel/parallel/Events/Error.stubJ ^�gJ �ž�� I vendor/jetbrains/phpstorm-stubs/parallel/parallel/Events/Event/Error.stubP ^�gP ��R�� H vendor/jetbrains/phpstorm-stubs/parallel/parallel/Events/Event/Type.stub. ^�g. ϞZ>� C vendor/jetbrains/phpstorm-stubs/parallel/parallel/Events/Input.stub0 ^�g0 �>�� V vendor/jetbrains/phpstorm-stubs/parallel/parallel/Events/Input/Error/IllegalValue.stubu ^�gu i���� S vendor/jetbrains/phpstorm-stubs/parallel/parallel/Events/Input/Error/Existence.stubr ^�gr ��7o� I vendor/jetbrains/phpstorm-stubs/parallel/parallel/Events/Input/Error.stubP ^�gP ?��� > vendor/jetbrains/phpstorm-stubs/parallel/parallel/Runtime.stub� ^�g� 0��ˤ U vendor/jetbrains/phpstorm-stubs/parallel/parallel/Runtime/Error/IllegalParameter.stubo ^�go #��� N vendor/jetbrains/phpstorm-stubs/parallel/parallel/Runtime/Error/Bootstrap.stubh ^�gh U<H�� R vendor/jetbrains/phpstorm-stubs/parallel/parallel/Runtime/Error/IllegalReturn.stubl ^�gl $� W vendor/jetbrains/phpstorm-stubs/parallel/parallel/Runtime/Error/IllegalInstruction.stubq ^�gq Z�G�� K vendor/jetbrains/phpstorm-stubs/parallel/parallel/Runtime/Error/Closed.stube ^�ge �pp� K vendor/jetbrains/phpstorm-stubs/parallel/parallel/Runtime/Error/Killed.stube ^�ge �7ۑ� T vendor/jetbrains/phpstorm-stubs/parallel/parallel/Runtime/Error/IllegalFunction.stubn ^�gn �� �� T vendor/jetbrains/phpstorm-stubs/parallel/parallel/Runtime/Error/IllegalVariable.stubn ^�gn �[� D vendor/jetbrains/phpstorm-stubs/parallel/parallel/Runtime/Error.stubK ^�gK ����� O vendor/jetbrains/phpstorm-stubs/parallel/parallel/Runtime/Type/Unavailable.stub> ^�g> �^��� Q vendor/jetbrains/phpstorm-stubs/parallel/parallel/Runtime/Object/Unavailable.stub@ ^�g@ :�Ǧ� M vendor/jetbrains/phpstorm-stubs/parallel/parallel/Future/Error/Cancelled.stub_ ^�g_ �� �� J vendor/jetbrains/phpstorm-stubs/parallel/parallel/Future/Error/Killed.stub\ ^�g\ �< � K vendor/jetbrains/phpstorm-stubs/parallel/parallel/Future/Error/Foreign.stub] ^�g] } � C vendor/jetbrains/phpstorm-stubs/parallel/parallel/Future/Error.stubJ ^�gJ �b�� = vendor/jetbrains/phpstorm-stubs/parallel/parallel/Events.stub� ^�g� ��ܤ 6 vendor/jetbrains/phpstorm-stubs/parallel/parallel.stub ^�g � z� 0 vendor/jetbrains/phpstorm-stubs/stomp/stomp.stubA" ^�gA" !K�� , vendor/jetbrains/phpstorm-stubs/bz2/bz2.stubq ^�gq �4 �� > vendor/jetbrains/phpstorm-stubs/ZendDebugger/ZendDebugger.stub ^�g w�!� * vendor/jetbrains/phpstorm-stubs/ds/ds.stub� ^�g� �R�E� 0 vendor/jetbrains/phpstorm-stubs/ctype/ctype.stubR ^�gR P��� * vendor/jetbrains/phpstorm-stubs/uv/UV.stub ^�g �h< � 4 vendor/jetbrains/phpstorm-stubs/uv/uv_functions.stub�f ^�g�f ��t�� @ vendor/jetbrains/phpstorm-stubs/mysql_xdevapi/mysql_xdevapi.stub�� ^�g�� ^�� , vendor/jetbrains/phpstorm-stubs/yar/yar.stub ^�g ���ۤ 6 vendor/jetbrains/phpstorm-stubs/newrelic/newrelic.stub� ^�g� ��Ϥ� 8 vendor/jetbrains/phpstorm-stubs/xmlreader/xmlreader.stubsD ^�gsD +{ˤ , vendor/jetbrains/phpstorm-stubs/xsl/xsl.stub; ^�g; $��Ȥ , vendor/jetbrains/phpstorm-stubs/gmp/gmp.stub�u ^�g�u �O � , vendor/jetbrains/phpstorm-stubs/PDO/PDO.stubcG ^�gcG K&sʤ * vendor/jetbrains/phpstorm-stubs/gd/gd.stub� ^�g� ��� . vendor/jetbrains/phpstorm-stubs/gd/GdFont.stub3 ^�g3 `I=� 4 vendor/jetbrains/phpstorm-stubs/openssl/openssl.stub�� ^�g�� ���Ф 3 vendor/jetbrains/phpstorm-stubs/dba/Connection.stubG ^�gG o�@3� , vendor/jetbrains/phpstorm-stubs/dba/dba.stubE0 ^�gE0 �Nԣ� , vendor/jetbrains/phpstorm-stubs/zip/zip.stub � ^�g � �C9�� 2 vendor/jetbrains/phpstorm-stubs/SQLite/SQLite.stubl� ^�gl� L� + vendor/jetbrains/phpstorm-stubs/PATCHES.txtE ^�gE ��ZΤ 2 vendor/jetbrains/phpstorm-stubs/ffmpeg/ffmpeg.stub� ^�g� g%� 6 vendor/jetbrains/phpstorm-stubs/yaf/yaf_namespace.stub^[ ^�g^[ v�D� , vendor/jetbrains/phpstorm-stubs/yaf/yaf.stub�` ^�g�` ��k�� 4 vendor/jetbrains/phpstorm-stubs/imap/Connection.stubH ^�gH F�?�� . vendor/jetbrains/phpstorm-stubs/imap/imap.stub;� ^�g;� �Е�� 8 vendor/jetbrains/phpstorm-stubs/ZendUtils/ZendUtils.stub8 ^�g8 �܌� 9 vendor/jetbrains/phpstorm-stubs/snappy/snappy/snappy.stub ^�g �� 2 vendor/jetbrains/phpstorm-stubs/recode/recode.stub� ^�g� �O� @ vendor/jetbrains/phpstorm-stubs/mosquitto-php/mosquitto-php.stubq5 ^�gq5 H�^�� 4 vendor/jetbrains/phpstorm-stubs/decimal/decimal.stub<< ^�g<< z�y� 4 vendor/jetbrains/phpstorm-stubs/msgpack/msgpack.stubX ^�gX 2d\�� 0 vendor/jetbrains/phpstorm-stubs/stats/stats.stub"H ^�g"H ��e� . vendor/jetbrains/phpstorm-stubs/uopz/uopz.stub�& ^�g�& -#�� 2 vendor/jetbrains/phpstorm-stubs/libxml/libxml.stub�$ ^�g�$ �V9�� , vendor/jetbrains/phpstorm-stubs/rar/rar.stub�_ ^�g�_ EQ`� vendor/symfony/console/LICENSE, ^�g, ���U� ! vendor/symfony/console/Cursor.php? ^�g? �5o � + vendor/symfony/console/Helper/TableCell.php ^�g �X!ʤ 6 vendor/symfony/console/Helper/DebugFormatterHelper.php\ ^�g\ �)�Ф / vendor/symfony/console/Helper/ProcessHelper.php� ^�g� Qyk� 2 vendor/symfony/console/Helper/DescriptorHelper.php� ^�g� 4v�Τ ' vendor/symfony/console/Helper/Table.phps ^�gs ��]� , vendor/symfony/console/Helper/TableStyle.php�0 ^�g�0 �� �� 0 vendor/symfony/console/Helper/TableCellStyle.phpd ^�gd &B�h� ( vendor/symfony/console/Helper/Helper.php� ^�g� � s>� 2 vendor/symfony/console/Helper/InputAwareHelper.php! ^�g! ��f� 0 vendor/symfony/console/Helper/TableSeparator.php% ^�g% ��� 0 vendor/symfony/console/Helper/QuestionHelper.php�L ^�g�L ��y� + vendor/symfony/console/Helper/TableRows.phpV ^�gV Դ�� ( vendor/symfony/console/Helper/Dumper.phpX ^�gX x!s�� 3 vendor/symfony/console/Helper/ProgressIndicator.php� ^�g� |�9R� + vendor/symfony/console/Helper/HelperSet.phpE ^�gE 0j� 7 vendor/symfony/console/Helper/SymfonyQuestionHelper.phpG ^�gG �^,� - vendor/symfony/console/Helper/ProgressBar.phpOH ^�gOH 9~�W� 1 vendor/symfony/console/Helper/HelperInterface.php^ ^�g^ \�� 1 vendor/symfony/console/Helper/FormatterHelper.php� ^�g� w�H� . vendor/symfony/console/Attribute/AsCommand.phpN ^�gN ��)�� ; vendor/symfony/console/Completion/CompletionSuggestions.phpn ^�gn �Ϥ 5 vendor/symfony/console/Completion/CompletionInput.php[ ^�g[ qc�� 0 vendor/symfony/console/Completion/Suggestion.php� ^�g� m��n� A vendor/symfony/console/Completion/Output/BashCompletionOutput.php ^�g ��,�� F vendor/symfony/console/Completion/Output/CompletionOutputInterface.php� ^�g� �;_¤ < vendor/symfony/console/Descriptor/ApplicationDescription.php% ^�g% &g��� 9 vendor/symfony/console/Descriptor/DescriptorInterface.phpQ ^�gQ 6V|� 0 vendor/symfony/console/Descriptor/Descriptor.php ^�g ��� 4 vendor/symfony/console/Descriptor/JsonDescriptor.php� ^�g� Rrb�� 8 vendor/symfony/console/Descriptor/MarkdownDescriptor.phpk ^�gk �wlz� 3 vendor/symfony/console/Descriptor/XmlDescriptor.php.' ^�g.' ��ᠤ 4 vendor/symfony/console/Descriptor/TextDescriptor.php2 ^�g2 ���d� 2 vendor/symfony/console/Event/ConsoleErrorEvent.php" ^�g" ���Ҥ - vendor/symfony/console/Event/ConsoleEvent.php� ^�g� �| � 4 vendor/symfony/console/Event/ConsoleCommandEvent.php= ^�g= ^�'� 3 vendor/symfony/console/Event/ConsoleSignalEvent.php� ^�g� ��JN� 6 vendor/symfony/console/Event/ConsoleTerminateEvent.phpj ^�gj l�� 0 vendor/symfony/console/Resources/completion.bash� ^�g� �z(� 4 vendor/symfony/console/Resources/bin/hiddeninput.exe $ ^�g $ ���v� 2 vendor/symfony/console/CI/GithubActionReporter.php# ^�g# �xe� > vendor/symfony/console/Formatter/OutputFormatterStyleStack.php+ ^�g+ ��w�� 9 vendor/symfony/console/Formatter/OutputFormatterStyle.php� ^�g� ���L� 4 vendor/symfony/console/Formatter/OutputFormatter.php� ^�g� 2ʰդ F vendor/symfony/console/Formatter/WrappableOutputFormatterInterface.php� ^�g� �깤 = vendor/symfony/console/Formatter/OutputFormatterInterface.phpD ^�gD úM� 8 vendor/symfony/console/Formatter/NullOutputFormatter.phpo ^�go �\� B vendor/symfony/console/Formatter/OutputFormatterStyleInterface.phpi ^�gi ��ä = vendor/symfony/console/Formatter/NullOutputFormatterStyle.php� ^�g� C�qä & vendor/symfony/console/Application.php� ^�g� ��`� 3 vendor/symfony/console/SingleCommandApplication.php9 ^�g9 �+� ( vendor/symfony/console/ConsoleEvents.php� ^�g� RI� . vendor/symfony/console/Command/ListCommand.php ^�g L��ڤ 8 vendor/symfony/console/Command/DumpCompletionCommand.php� ^�g� ��>�� . vendor/symfony/console/Command/LazyCommand.phpF ^�gF �0� * vendor/symfony/console/Command/Command.php�P ^�g�P ��� 2 vendor/symfony/console/Command/CompleteCommand.php� ^�g� �/�n� 0 vendor/symfony/console/Command/LockableTrait.php$ ^�g$ �C� = vendor/symfony/console/Command/SignalableCommandInterface.php� ^�g� 1�S� . vendor/symfony/console/Command/HelpCommand.php ^�g /A�¤ ? vendor/symfony/console/Exception/NamespaceNotFoundException.php� ^�g� ��~~� = vendor/symfony/console/Exception/CommandNotFoundException.php� ^�g� �E�Q� = vendor/symfony/console/Exception/InvalidArgumentException.php� ^�g� ��{� ; vendor/symfony/console/Exception/InvalidOptionException.php ^�g ���� 5 vendor/symfony/console/Exception/RuntimeException.php� ^�g� ���� 3 vendor/symfony/console/Exception/LogicException.php� ^�g� �<� : vendor/symfony/console/Exception/MissingInputException.php ^�g �óĤ 7 vendor/symfony/console/Exception/ExceptionInterface.php� ^�g� �v� 8 vendor/symfony/console/Question/ConfirmationQuestion.php) ^�g) +{�]� , vendor/symfony/console/Question/Question.php~ ^�g~ �}d�� 2 vendor/symfony/console/Question/ChoiceQuestion.php� ^�g� ;x$Ĥ - vendor/symfony/console/Style/SymfonyStyle.php�9 ^�g�9 �;��� / vendor/symfony/console/Style/StyleInterface.phpR ^�gR ��T� , vendor/symfony/console/Style/OutputStyle.phpL ^�gL �2�n� / vendor/symfony/console/Logger/ConsoleLogger.php� ^�g� � vendor/symfony/console/Color.phpZ ^�gZ �CM֤ D vendor/symfony/console/DependencyInjection/AddConsoleCommandPass.php� ^�g� �r � 8 vendor/symfony/console/SignalRegistry/SignalRegistry.phpD ^�gD �p��� = vendor/symfony/console/CommandLoader/FactoryCommandLoader.phpe ^�ge ��t�� ? vendor/symfony/console/CommandLoader/ContainerCommandLoader.php ^�g �/�Ĥ ? vendor/symfony/console/CommandLoader/CommandLoaderInterface.php� ^�g� �O�p� 0 vendor/symfony/console/Output/BufferedOutput.phpc ^�gc ���� . vendor/symfony/console/Output/StreamOutput.php� ^�g� ��,�� ( vendor/symfony/console/Output/Output.phpg ^�gg d��� 6 vendor/symfony/console/Output/ConsoleSectionOutput.php� ^�g� ��� / vendor/symfony/console/Output/ConsoleOutput.php) ^�g) X�k�� , vendor/symfony/console/Output/NullOutput.php8 ^�g8 ��)� 8 vendor/symfony/console/Output/ConsoleOutputInterface.php1 ^�g1 /CL�� 1 vendor/symfony/console/Output/OutputInterface.phpt ^�gt ۜgt� 5 vendor/symfony/console/Output/TrimmedBufferOutput.phpo ^�go Ʉ� + vendor/symfony/console/Input/ArrayInput.php� ^�g� oct� . vendor/symfony/console/Input/InputArgument.php� ^�g� �:B�� * vendor/symfony/console/Input/ArgvInput.php�0 ^�g�0 |j�#� 0 vendor/symfony/console/Input/InputDefinition.phpT. ^�gT. �mY)� & vendor/symfony/console/Input/Input.php= ^�g= K�鞤 , vendor/symfony/console/Input/InputOption.php` ^�g` �v� 9 vendor/symfony/console/Input/StreamableInputInterface.phpz ^�gz �;��� 4 vendor/symfony/console/Input/InputAwareInterface.phpL ^�gL ��z� / vendor/symfony/console/Input/InputInterface.php� ^�g� ��|� , vendor/symfony/console/Input/StringInput.php� ^�g� k$�<� # vendor/symfony/console/Terminal.phpm ^�gm 7��� - vendor/symfony/console/Tester/TesterTrait.php� ^�g� B��|� 9 vendor/symfony/console/Tester/CommandCompletionTester.phpL ^�gL õr^� 3 vendor/symfony/console/Tester/ApplicationTester.php� ^�g� /B�c� @ vendor/symfony/console/Tester/Constraint/CommandIsSuccessful.php� ^�g� ���� / vendor/symfony/console/Tester/CommandTester.phpJ ^�gJ �0 � 6 vendor/symfony/console/EventListener/ErrorListener.php^ ^�g^ �C 1� % vendor/symfony/polyfill-php73/LICENSE, ^�g, � ��� ? vendor/symfony/polyfill-php73/Resources/stubs/JsonException.phpE ^�gE 8S�� ' vendor/symfony/polyfill-php73/Php73.phpb ^�gb J�<� + vendor/symfony/polyfill-php73/bootstrap.php� ^�g� ��|� vendor/symfony/process/LICENSE, ^�g, ���U� & vendor/symfony/process/InputStream.php� ^�g� µ�֤ + vendor/symfony/process/ExecutableFinder.php� ^�g� G�F� " vendor/symfony/process/Process.php�� ^�g�� �v.,� ' vendor/symfony/process/ProcessUtils.php\ ^�g\ SRґ� = vendor/symfony/process/Exception/ProcessSignaledException.php� ^�g� ��� ; vendor/symfony/process/Exception/ProcessFailedException.phpI ^�gI ��� = vendor/symfony/process/Exception/ProcessTimedOutException.php| ^�g| _*.�� = vendor/symfony/process/Exception/InvalidArgumentException.php ^�g �-{� 5 vendor/symfony/process/Exception/RuntimeException.php� ^�g� �x�פ 3 vendor/symfony/process/Exception/LogicException.php� ^�g� {&�� 7 vendor/symfony/process/Exception/ExceptionInterface.php� ^�g� 3�z�� - vendor/symfony/process/Pipes/WindowsPipes.phpo ^�go D'}ݤ / vendor/symfony/process/Pipes/PipesInterface.php� ^�g� ��l� * vendor/symfony/process/Pipes/UnixPipes.php� ^�g� oW��� . vendor/symfony/process/Pipes/AbstractPipes.php� ^�g� ?�[� . vendor/symfony/process/PhpExecutableFinder.phpa ^�ga �� % vendor/symfony/process/PhpProcess.php� ^�g� m]�m� vendor/symfony/finder/Finder.php�X ^�g�X c��ˤ vendor/symfony/finder/LICENSE, ^�g, ���U� % vendor/symfony/finder/SplFileInfo.php, ^�g, ��6� vendor/symfony/finder/Glob.phpJ ^�gJ ��P� 9 vendor/symfony/finder/Exception/AccessDeniedException.php� ^�g� dsZU� > vendor/symfony/finder/Exception/DirectoryNotFoundException.php� ^�g� ��(� 5 vendor/symfony/finder/Comparator/NumberComparator.php ^�g b�� 3 vendor/symfony/finder/Comparator/DateComparator.php� ^�g� d�M� / vendor/symfony/finder/Comparator/Comparator.php� ^�g� R9��� : vendor/symfony/finder/Iterator/SizeRangeFilterIterator.php� ^�g� �� = vendor/symfony/finder/Iterator/MultiplePcreFilterIterator.php� ^�g� ���4� A vendor/symfony/finder/Iterator/ExcludeDirectoryFilterIterator.php� ^�g� Ԫ�Ϥ < vendor/symfony/finder/Iterator/FilecontentFilterIterator.php� ^�g� 5��� 9 vendor/symfony/finder/Iterator/FilenameFilterIterator.php� ^�g� �e��� 7 vendor/symfony/finder/Iterator/CustomFilterIterator.php3 ^�g3 "��J� : vendor/symfony/finder/Iterator/DateRangeFilterIterator.php� ^�g� פ / vendor/symfony/finder/Iterator/LazyIterator.php� ^�g� c�ߤ 5 vendor/symfony/finder/Iterator/PathFilterIterator.php� ^�g� B��p� 9 vendor/symfony/finder/Iterator/FileTypeFilterIterator.php� ^�g� e�� ; vendor/symfony/finder/Iterator/VcsIgnoredFilterIterator.php� ^�g� ��е� = vendor/symfony/finder/Iterator/RecursiveDirectoryIterator.php� ^�g� ��)̤ 3 vendor/symfony/finder/Iterator/SortableIterator.phpj ^�gj iH�[� ; vendor/symfony/finder/Iterator/DepthRangeFilterIterator.php� ^�g� �;�ܤ # vendor/symfony/finder/Gitignore.php% ^�g% ���� , vendor/symfony/deprecation-contracts/LICENSE, ^�g, K� 1 vendor/symfony/deprecation-contracts/function.php2 ^�g2 D�~� 5 vendor/symfony/polyfill-intl-grapheme/bootstrap80.phpg ^�gg ��E{� - vendor/symfony/polyfill-intl-grapheme/LICENSE, ^�g, �� H� 2 vendor/symfony/polyfill-intl-grapheme/Grapheme.php8& ^�g8& � �I� 3 vendor/symfony/polyfill-intl-grapheme/bootstrap.php� ^�g� ��� / vendor/symfony/string/AbstractUnicodeString.phpai ^�gai �� vendor/symfony/string/LICENSE, ^�g, զ_Ϥ $ vendor/symfony/string/ByteString.php�< ^�g�< �R!ˤ < vendor/symfony/string/Resources/data/wcswidth_table_zero.php� ^�g� �iG� < vendor/symfony/string/Resources/data/wcswidth_table_wide.php ^�g �i�� - vendor/symfony/string/Resources/functions.phpp ^�gp ���� . vendor/symfony/string/Slugger/AsciiSlugger.php3 ^�g3 \ ζ� 2 vendor/symfony/string/Slugger/SluggerInterface.php� ^�g� �P�3� < vendor/symfony/string/Exception/InvalidArgumentException.php� ^�g� ���M� 4 vendor/symfony/string/Exception/RuntimeException.php� ^�g� ��@� 6 vendor/symfony/string/Exception/ExceptionInterface.phpc ^�gc 6�J�� ) vendor/symfony/string/CodePointString.php� ^�g� �̢e� ( vendor/symfony/string/AbstractString.php�O ^�g�O H��� 4 vendor/symfony/string/Inflector/EnglishInflector.php�B ^�g�B q�� 3 vendor/symfony/string/Inflector/FrenchInflector.php$ ^�g$ ~Y� 6 vendor/symfony/string/Inflector/InflectorInterface.phpV ^�gV N��Τ $ vendor/symfony/string/LazyString.phpr ^�gr e��R� ' vendor/symfony/string/UnicodeString.php�2 ^�g�2 v,��� - vendor/symfony/polyfill-ctype/bootstrap80.phph ^�gh %�v� % vendor/symfony/polyfill-ctype/LICENSE, ^�g, � ��� ' vendor/symfony/polyfill-ctype/Ctype.php� ^�g� ���� + vendor/symfony/polyfill-ctype/bootstrap.php, ^�g, ro�Ф 0 vendor/symfony/polyfill-mbstring/bootstrap80.php' ^�g' L#\M� ( vendor/symfony/polyfill-mbstring/LICENSE, ^�g, �� H� B vendor/symfony/polyfill-mbstring/Resources/unidata/caseFolding.phpa ^�ga �|ⳤ @ vendor/symfony/polyfill-mbstring/Resources/unidata/lowerCase.php�_ ^�g�_ ���d� F vendor/symfony/polyfill-mbstring/Resources/unidata/titleCaseRegexp.php9 ^�g9 >|zK� @ vendor/symfony/polyfill-mbstring/Resources/unidata/upperCase.php�f ^�g�f �P�� - vendor/symfony/polyfill-mbstring/Mbstring.phpJ� ^�gJ� ��Ů� . vendor/symfony/polyfill-mbstring/bootstrap.php! ^�g! ���d� % vendor/symfony/polyfill-php80/LICENSE, ^�g, K� ' vendor/symfony/polyfill-php80/Php80.php� ^�g� cH��� ; vendor/symfony/polyfill-php80/Resources/stubs/Attribute.php� ^�g� MK�<� < vendor/symfony/polyfill-php80/Resources/stubs/Stringable.php� ^�g� t]\ڤ E vendor/symfony/polyfill-php80/Resources/stubs/UnhandledMatchError.phpG ^�gG ֈ+� : vendor/symfony/polyfill-php80/Resources/stubs/PhpToken.phpw ^�gw =7T8� < vendor/symfony/polyfill-php80/Resources/stubs/ValueError.php> ^�g> g��� * vendor/symfony/polyfill-php80/PhpToken.php� ^�g� ]f� + vendor/symfony/polyfill-php80/bootstrap.php� ^�g� �.Ĥ % vendor/symfony/polyfill-php74/LICENSE, ^�g, զ_Ϥ ' vendor/symfony/polyfill-php74/Php74.php� ^�g� AV܀� + vendor/symfony/polyfill-php74/bootstrap.php% ^�g% �� � % vendor/symfony/polyfill-php81/LICENSE, ^�g, 0�� @ vendor/symfony/polyfill-php81/Resources/stubs/CURLStringFile.php� ^�g� ��JT� F vendor/symfony/polyfill-php81/Resources/stubs/ReturnTypeWillChange.php� ^�g� 5�+� ' vendor/symfony/polyfill-php81/Php81.php� ^�g� ��$� + vendor/symfony/polyfill-php81/bootstrap.php� ^�g� <P� 7 vendor/symfony/polyfill-intl-normalizer/bootstrap80.php� ^�g� �,�� / vendor/symfony/polyfill-intl-normalizer/LICENSE, ^�g, �� H� 6 vendor/symfony/polyfill-intl-normalizer/Normalizer.phpd% ^�gd% u��� L vendor/symfony/polyfill-intl-normalizer/Resources/unidata/combiningClass.phpD5 ^�gD5 ��� � T vendor/symfony/polyfill-intl-normalizer/Resources/unidata/canonicalDecomposition.php{� ^�g{� �je�� R vendor/symfony/polyfill-intl-normalizer/Resources/unidata/canonicalComposition.php�D ^�g�D '�CԤ X vendor/symfony/polyfill-intl-normalizer/Resources/unidata/compatibilityDecomposition.phpo ^�go c�,�� F vendor/symfony/polyfill-intl-normalizer/Resources/stubs/Normalizer.php� ^�g� ���%� 5 vendor/symfony/polyfill-intl-normalizer/bootstrap.php� ^�g� #p� � ( vendor/symfony/service-contracts/LICENSE, ^�g, � ��� 7 vendor/symfony/service-contracts/Attribute/Required.php� ^�g� �5� @ vendor/symfony/service-contracts/Attribute/SubscribedService.php: ^�g: �o�� ; vendor/symfony/service-contracts/ServiceSubscriberTrait.php� ^�g� ��9 � 3 vendor/symfony/service-contracts/ResetInterface.php� ^�g� s��Ҥ = vendor/symfony/service-contracts/ServiceProviderInterface.php� ^�g� �t� ? vendor/symfony/service-contracts/ServiceSubscriberInterface.php� ^�g� S�h� 8 vendor/symfony/service-contracts/ServiceLocatorTrait.php ^�g U�+>� $ vendor/phpstan/phpdoc-parser/LICENSE. ^�g. �-� 2 vendor/phpstan/phpdoc-parser/src/Ast/Attribute.php9 ^�g9 ���� P vendor/phpstan/phpdoc-parser/src/Ast/ConstExpr/QuoteAwareConstExprStringNode.phpP ^�gP �� ]� E vendor/phpstan/phpdoc-parser/src/Ast/ConstExpr/ConstExprFalseNode.php= ^�g= P1w1� E vendor/phpstan/phpdoc-parser/src/Ast/ConstExpr/ConstExprFloatNode.php� ^�g� �� I vendor/phpstan/phpdoc-parser/src/Ast/ConstExpr/ConstExprArrayItemNode.php ^�g 4�|ͤ @ vendor/phpstan/phpdoc-parser/src/Ast/ConstExpr/ConstExprNode.php� ^�g� 0��K� E vendor/phpstan/phpdoc-parser/src/Ast/ConstExpr/ConstExprArrayNode.phpF ^�gF D��� A vendor/phpstan/phpdoc-parser/src/Ast/ConstExpr/ConstFetchNode.php� ^�g� �[e� G vendor/phpstan/phpdoc-parser/src/Ast/ConstExpr/ConstExprIntegerNode.php� ^�g� ҳ��� D vendor/phpstan/phpdoc-parser/src/Ast/ConstExpr/ConstExprTrueNode.php; ^�g; �ĉE� N vendor/phpstan/phpdoc-parser/src/Ast/ConstExpr/DoctrineConstExprStringNode.phpu ^�gu �,wѤ F vendor/phpstan/phpdoc-parser/src/Ast/ConstExpr/ConstExprStringNode.php� ^�g� č �� D vendor/phpstan/phpdoc-parser/src/Ast/ConstExpr/ConstExprNullNode.php; ^�g; �g �� 6 vendor/phpstan/phpdoc-parser/src/Ast/NodeTraverser.php�* ^�g�* �B,�� - vendor/phpstan/phpdoc-parser/src/Ast/Node.phpw ^�gw ?S; � < vendor/phpstan/phpdoc-parser/src/Ast/AbstractNodeVisitor.php� ^�g� �/�� = vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/PhpDocTagNode.php( ^�g( Xr�� F vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/DeprecatedTagValueNode.php ^�g 2��w� U vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/ParamLaterInvokedCallableTagValueNode.php� ^�g� Oؼ�� : vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/PhpDocNode.php65 ^�g65 �}nz� I vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/Doctrine/DoctrineArgument.php� ^�g� LM*� J vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/Doctrine/DoctrineArrayItem.phpL ^�gL �0B� K vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/Doctrine/DoctrineAnnotation.php� ^�g� (�Tͤ F vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/Doctrine/DoctrineArray.phpT ^�gT |�m�� M vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/Doctrine/DoctrineTagValueNode.php� ^�g� ^�� J vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/RequireExtendsTagValueNode.php� ^�g� B'�� D vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/PropertyTagValueNode.php- ^�g- Y�?Ť F vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/ImplementsTagValueNode.php� ^�g� ?��� C vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/ExtendsTagValueNode.php� ^�g� uE此 B vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/ReturnTagValueNode.php� ^�g� �H� @ vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/UsesTagValueNode.php� ^�g� ���� > vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/PhpDocTextNode.php� ^�g� ��N� [ vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/ParamImmediatelyInvokedCallableTagValueNode.php� ^�g� 5S� D vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/ParamOutTagValueNode.php2 ^�g2 m� I vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/TypelessParamTagValueNode.php ^�g ���<� H vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/AssertTagMethodValueNode.php� ^�g� �Ěd� C vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/SelfOutTagValueNode.php� ^�g� ��2K� K vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/MethodTagValueParameterNode.php3 ^�g3 �뉤 B vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/MethodTagValueNode.php� ^�g� 4�>ˤ M vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/RequireImplementsTagValueNode.php� ^�g� �:Eˤ C vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/GenericTagValueNode.php� ^�g� �&�� B vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/AssertTagValueNode.phpp ^�gp �>䍤 E vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/TypeAliasTagValueNode.phpw ^�gw 6&"!� L vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/ParamClosureThisTagValueNode.php: ^�g: ��ę� A vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/MixinTagValueNode.php� ^�g� a��� B vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/ThrowsTagValueNode.php� ^�g� ��6�� K vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/TypeAliasImportTagValueNode.php� ^�g� pк� C vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/InvalidTagValueNode.php� ^�g� >��N� B vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/PhpDocTagValueNode.php� ^�g� ��9e� V vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/PureUnlessCallableIsImpureTagValueNode.php� ^�g� Z t� ? vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/VarTagValueNode.phpB ^�gB kN�-� ? vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/PhpDocChildNode.php� ^�g� ���� A vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/ParamTagValueNode.php� ^�g� ����� J vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/AssertTagPropertyValueNode.php� ^�g� �P�o� D vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/TemplateTagValueNode.php: ^�g: U��� H vendor/phpstan/phpdoc-parser/src/Ast/Type/ArrayShapeUnsealedTypeNode.php! ^�g! ��� < vendor/phpstan/phpdoc-parser/src/Ast/Type/ArrayShapeNode.php$ ^�g$ ��̤ > vendor/phpstan/phpdoc-parser/src/Ast/Type/NullableTypeNode.php� ^�g� K6�ˤ = vendor/phpstan/phpdoc-parser/src/Ast/Type/InvalidTypeNode.phpS ^�gS ���� ; vendor/phpstan/phpdoc-parser/src/Ast/Type/UnionTypeNode.php? ^�g? T�� = vendor/phpstan/phpdoc-parser/src/Ast/Type/GenericTypeNode.phpR ^�gR q�`� ; vendor/phpstan/phpdoc-parser/src/Ast/Type/ConstTypeNode.php ^�g !�.ߤ A vendor/phpstan/phpdoc-parser/src/Ast/Type/ObjectShapeItemNode.php ^�g ��� > vendor/phpstan/phpdoc-parser/src/Ast/Type/CallableTypeNode.php� ^�g� /,|� : vendor/phpstan/phpdoc-parser/src/Ast/Type/ThisTypeNode.php( ^�g( +�� M vendor/phpstan/phpdoc-parser/src/Ast/Type/ConditionalTypeForParameterNode.phpA ^�gA >a��� A vendor/phpstan/phpdoc-parser/src/Ast/Type/ConditionalTypeNode.phpN ^�gN ��@� B vendor/phpstan/phpdoc-parser/src/Ast/Type/OffsetAccessTypeNode.php_ ^�g_ H �Ǥ ; vendor/phpstan/phpdoc-parser/src/Ast/Type/ArrayTypeNode.php� ^�g� �Ξ�� B vendor/phpstan/phpdoc-parser/src/Ast/Type/IntersectionTypeNode.phpF ^�gF 7�6� @ vendor/phpstan/phpdoc-parser/src/Ast/Type/ArrayShapeItemNode.php� ^�g� �ԯ� = vendor/phpstan/phpdoc-parser/src/Ast/Type/ObjectShapeNode.phpM ^�gM ͥR�� @ vendor/phpstan/phpdoc-parser/src/Ast/Type/IdentifierTypeNode.php� ^�g� F �� G vendor/phpstan/phpdoc-parser/src/Ast/Type/CallableTypeParameterNode.php� ^�g� \6�� 6 vendor/phpstan/phpdoc-parser/src/Ast/Type/TypeNode.php� ^�g� �]�ˤ C vendor/phpstan/phpdoc-parser/src/Ast/NodeVisitor/CloningVisitor.php� ^�g� �d��� 7 vendor/phpstan/phpdoc-parser/src/Ast/NodeAttributes.php� ^�g� �YXT� 4 vendor/phpstan/phpdoc-parser/src/Ast/NodeVisitor.php� ^�g� o���� ; vendor/phpstan/phpdoc-parser/src/Parser/StringUnescaper.php> ^�g> +t�9� ; vendor/phpstan/phpdoc-parser/src/Parser/ParserException.phpg ^�gg u/g�� 6 vendor/phpstan/phpdoc-parser/src/Parser/TypeParser.php�� ^�g�� ��Yդ 8 vendor/phpstan/phpdoc-parser/src/Parser/PhpDocParser.phpY� ^�gY� �=�ߤ ; vendor/phpstan/phpdoc-parser/src/Parser/ConstExprParser.php<' ^�g<' ��t� 9 vendor/phpstan/phpdoc-parser/src/Parser/TokenIterator.php�# ^�g�# G#�|� 5 vendor/phpstan/phpdoc-parser/src/Printer/DiffElem.php� ^�g� �Z6� 4 vendor/phpstan/phpdoc-parser/src/Printer/Printer.phpj� ^�gj� i1�M� 3 vendor/phpstan/phpdoc-parser/src/Printer/Differ.php� ^�g� R�ǀ� 0 vendor/phpstan/phpdoc-parser/src/Lexer/Lexer.php� ^�g� �g�� " vendor/phpstan/php-8-stubs/LICENSE/ ^�g/ #�Ȥ + vendor/phpstan/php-8-stubs/Php8StubsMap.php�� ^�g�� *4 ڤ ( vendor/phpstan/php-8-stubs/stubs/LICENSE� ^�g� ���V� L vendor/phpstan/php-8-stubs/stubs/ext/enchant/enchant_broker_dict_exists.stubZ ^�gZ G;פ E vendor/phpstan/php-8-stubs/stubs/ext/enchant/enchant_broker_free.stubY ^�gY ��}� N vendor/phpstan/php-8-stubs/stubs/ext/enchant/enchant_broker_set_dict_path.stub{ ^�g{ ���O� B vendor/phpstan/php-8-stubs/stubs/ext/enchant/enchant_dict_add.stubY ^�gY 'W\� C vendor/phpstan/php-8-stubs/stubs/ext/enchant/EnchantDictionary.stub) ^�g) u.=^� E vendor/phpstan/php-8-stubs/stubs/ext/enchant/enchant_broker_init.stub@ ^�g@ ��:� N vendor/phpstan/php-8-stubs/stubs/ext/enchant/enchant_broker_get_dict_path.stubu ^�gu x� k� J vendor/phpstan/php-8-stubs/stubs/ext/enchant/enchant_broker_free_dict.stubf ^�gf � � � M vendor/phpstan/php-8-stubs/stubs/ext/enchant/enchant_dict_add_to_session.stubd ^�gd ���Y� Q vendor/phpstan/php-8-stubs/stubs/ext/enchant/enchant_broker_request_pwl_dict.stubx ^�gx {*N7� G vendor/phpstan/php-8-stubs/stubs/ext/enchant/enchant_dict_is_added.stub^ ^�g^ 8�<� L vendor/phpstan/php-8-stubs/stubs/ext/enchant/enchant_dict_is_in_session.stub� ^�g� ���T� J vendor/phpstan/php-8-stubs/stubs/ext/enchant/enchant_broker_get_error.stubS ^�gS �;�Ӥ ? vendor/phpstan/php-8-stubs/stubs/ext/enchant/EnchantBroker.stubG ^�gG !���� N vendor/phpstan/php-8-stubs/stubs/ext/enchant/enchant_dict_add_to_personal.stub� ^�g� ��ʹ� J vendor/phpstan/php-8-stubs/stubs/ext/enchant/enchant_dict_quick_check.stub� ^�g� rA�� M vendor/phpstan/php-8-stubs/stubs/ext/enchant/enchant_broker_request_dict.stubo ^�go �$_ � G vendor/phpstan/php-8-stubs/stubs/ext/enchant/enchant_dict_describe.stubh ^�gh �j}� K vendor/phpstan/php-8-stubs/stubs/ext/enchant/enchant_broker_list_dicts.stubd ^�gd l�SԤ F vendor/phpstan/php-8-stubs/stubs/ext/enchant/enchant_dict_suggest.stubu ^�gu ���4� H vendor/phpstan/php-8-stubs/stubs/ext/enchant/enchant_dict_get_error.stubY ^�gY iJ� M vendor/phpstan/php-8-stubs/stubs/ext/enchant/enchant_broker_set_ordering.stubm ^�gm ��� I vendor/phpstan/php-8-stubs/stubs/ext/enchant/enchant_broker_describe.stubb ^�gb � �� P vendor/phpstan/php-8-stubs/stubs/ext/enchant/enchant_dict_store_replacement.stub~ ^�g~ EJvU� D vendor/phpstan/php-8-stubs/stubs/ext/enchant/enchant_dict_check.stub[ ^�g[ ���u� = vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_ssl_connect.stub* ^�g* kv��� 6 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_pasv.stub� ^�g� a��~� 8 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_nb_get.stubU ^�gU ����� < vendor/phpstan/php-8-stubs/stubs/ext/ftp/FTP/Connection.stubv ^�gv ;p��� 7 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_rmdir.stub� ^�g� ��� 6 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_mdtm.stub� ^�g� @ԅ� 6 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_site.stub� ^�g� �� 9 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_connect.stub ^�g ` �q� 9 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_systype.stub� ^�g� ���n� 6 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_size.stub� ^�g� 'E� 5 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_pwd.stub� ^�g� �vEF� 5 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_get.stubK ^�gK �ŧ� = vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_nb_continue.stub� ^�g� c� Ǥ 9 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_nb_fget.stubq ^�gq �BE� 6 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_fput.stubm ^�gm 3y� � 7 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_close.stub� ^�g� ƅ�V� 8 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_nb_put.stub[ ^�g[ dC#T� 6 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_exec.stub� ^�g� �XB`� 7 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_chmod.stub� ^�g� o��G� 5 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_raw.stub� ^�g� �.Z�� 6 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_quit.stub� ^�g� �_�� 9 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_nb_fput.stubq ^�gq �� 6 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_mlsd.stub ^�g ٬�Ԥ 5 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_put.stubK ^�gK &�ۤ 6 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_fget.stubm ^�gm �~F� 8 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_delete.stub� ^�g� �_9� 7 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_nlist.stub ^�g ��]� < vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_set_option.stub ^�g �^�e� 7 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_alloc.stub ^�g *��� 7 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_login.stub� ^�g� ��B"� < vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_get_option.stub� ^�g� W�U!� 7 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_chdir.stub� ^�g� 0 e�� 9 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_rawlist.stub@ ^�g@ �_� 8 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_rename.stub� ^�g� �^❤ 7 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_mkdir.stub� ^�g� Ե1� 8 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_append.stub/ ^�g/ ��w� 6 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_cdup.stub� ^�g� "���� C vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_set_prefetch_lob.stub� ^�g� �� <� = vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocisavelobfile.stuby ^�gy S�p� ; vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_lob_tell.stub: ^�g: y�K� 9 vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_cancel.stubS ^�gS ���� @ vendor/phpstan/php-8-stubs/stubs/ext/oci8/ociwritelobtofile.stub� ^�g� �ѯ� > vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocidefinebyname.stub� ^�g� ���� D vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_collection_assign.stubZ ^�gZ ���� 7 vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocierror.stub� ^�g� ��__� 9 vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_commit.stubU ^�gU ��&Ф ? vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_fetch_object.stub� ^�g� VLWͤ < vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_fetch_row.stub] ^�g] Һ�ޤ : vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocicolltrim.stub� ^�g� ���� 7 vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocifetch.stubx ^�gx � � I vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_collection_element_get.stubp ^�gp �� � I vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_get_implicit_resultset.stub{ ^�g{ �� � ? vendor/phpstan/php-8-stubs/stubs/ext/oci8/ociserverversion.stub� ^�g� ��h� ; vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_lob_save.stubT ^�gT �yD*� ; vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_lob_read.stubJ ^�gJ ���� ; vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_rollback.stubW ^�gW UD�]� < vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocicolumntype.stub� ^�g� �F �� ? vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocifreestatement.stub� ^�g� e� �� H vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_set_client_identifier.stubw ^�gw �s��� > vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_new_connect.stub� ^�g� �qH�� ; vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_lob_seek.stub^ ^�g^ �5ݤ D vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_collection_append.stub[ ^�g[ ���� = vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_lob_rewind.stub7 ^�g7 T6R�� 5 vendor/phpstan/php-8-stubs/stubs/ext/oci8/OCILob.stub< ^�g< ��Ĥ 9 vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocicollmax.stubz ^�gz ���,� 8 vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_error.stub� ^�g� �Y��� H vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_register_taf_callback.stuby ^�gy �N �� = vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_field_type.stubw ^�gw ��G � : vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocirollback.stub� ^�g� � ��� : vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_execute.stubw ^�gw �Hj�� A vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_field_type_raw.stubt ^�gt +��k� ? vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocistatementtype.stub� ^�g� a�Å� : vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_lob_eof.stub4 ^�g4 D,�n� ; vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocifetchinto.stub� ^�g� %��� ; vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_lob_copy.stubX ^�gX ۅњ� ; vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_lob_size.stub: ^�g: !0:� @ vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocipasswordchange.stub� ^�g� ��� 9 vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocinumcols.stub~ ^�g~ NY��� > vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_free_cursor.stuby ^�gy s��Q� = vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_num_fields.stubV ^�gV �Tw�� B vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_free_descriptor.stub< ^�g< # �� 8 vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocinlogon.stub� ^�g� d \� L vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_collection_element_assign.stubo ^�go �AÀ� = vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_lob_export.stubs ^�gs �H>�� = vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_set_action.stubi ^�gi Dà֤ > vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_set_edition.stub; ^�g; ?r��� J vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_unregister_taf_callback.stubf ^�gf ��Ƥ 8 vendor/phpstan/php-8-stubs/stubs/ext/oci8/ociplogon.stub� ^�g� ���<� = vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_new_cursor.stubq ^�gq � �ʤ A vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocisetbufferinglob.stubG ^�gG PD0Ф B vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_set_client_info.stubw ^�gw ��J8� 7 vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocilogon.stub� ^�g� {�c2� ; vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_lob_load.stub= ^�g= ���� : vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_connect.stub� ^�g� b]m� = vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocicolumnscale.stub� ^�g� E�F�� 8 vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_parse.stuby ^�gy ���ä = vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_lob_import.stubI ^�gI 95�֤ < vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_fetch_all.stub� ^�g� (�?1� < vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_lob_erase.stube ^�ge ��� A vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_free_statement.stub[ ^�g[ +�6+� = vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_lob_append.stubE ^�gE �Ғ<� 8 vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocicommit.stub| ^�g| ���Ҥ < vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocicollappend.stub� ^�g� 15��� @ vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_field_is_null.stubn ^�gn ��J�� ? vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_lob_truncate.stubJ ^�gJ �� B vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_field_precision.stubu ^�gu � ڙ� B vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_password_change.stub� ^�g� �P ? vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocinewcollection.stub� ^�g� ���� 9 vendor/phpstan/php-8-stubs/stubs/ext/oci8/ociloadlob.stubi ^�gi #e�=� ? vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocicolumntyperaw.stub� ^�g� �Huä : vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocicollsize.stub| ^�g| ���� < vendor/phpstan/php-8-stubs/stubs/ext/oci8/OCICollection.stub ^�g �qX]� A vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocicolumnprecision.stub� ^�g� �/m� < vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocicolumnsize.stub� ^�g� 0�� : vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocirowcount.stub� ^�g� ԧ��� A vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_new_descriptor.stub| ^�g| C"� 9 vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocisavelob.stub� ^�g� %y<� 8 vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_fetch.stubR ^�gR �&�դ C vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_set_db_operation.stubo ^�go ,}b� A vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocigetbufferinglob.stub; ^�g; �d�Ȥ ? vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocinewdescriptor.stub� ^�g� �ʆH� 7 vendor/phpstan/php-8-stubs/stubs/ext/oci8/ociparse.stub� ^�g� ��W[� : vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocifreedesc.stubi ^�gi tD(� ? vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_set_prefetch.stubd ^�gd ק� @ vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocifetchstatement.stub� ^�g� �ex� 8 vendor/phpstan/php-8-stubs/stubs/ext/oci8/ociresult.stub� ^�g� �M�;� > vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_fetch_assoc.stub_ ^�g_ ��i�� 8 vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocilogoff.stub| ^�g| Ĭ0y� B vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_collection_size.stubO ^�gO X���� 8 vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocicancel.stubz ^�gz V_��� @ vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocifreecollection.stub} ^�g} ~�a� B vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_free_collection.stubJ ^�gJ �M|y� < vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocifreecursor.stub� ^�g� `Y�'� A vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_collection_max.stubN ^�gN p��o� 8 vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_close.stubU ^�gU '^N� A vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_new_collection.stub� ^�g� �4� � > vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocicolumnisnull.stub� ^�g� �ׄ� < vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_lob_flush.stubE ^�gE ��ţ� < vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_lob_write.stub^ ^�g^ 8k�� A vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_client_version.stub1 ^�g1 �� = vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_field_size.stubp ^�gp H3�Τ ; vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_num_rows.stubZ ^�gZ � Ƥ ? vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_bind_by_name.stub� ^�g� �Z� A vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_statement_type.stubc ^�gc i�%H� ; vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_pconnect.stub� ^�g� ��+v� > vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_fetch_array.stub� ^�g� �Q�� > vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_field_scale.stubq ^�gq ���� ? vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_lob_is_equal.stubI ^�gI S�Y� < vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocicolumnname.stub� ^�g� ���:� E vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_bind_array_by_name.stub� ^�g� �^$� 9 vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_result.stubh ^�gh G�%Ȥ = vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_field_name.stubs ^�gs ��%ɤ 9 vendor/phpstan/php-8-stubs/stubs/ext/oci8/ociexecute.stub� ^�g� u� B vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_collection_trim.stubT ^�gT +�S� @ vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocicollassignelem.stub� ^�g� KV� A vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_define_by_name.stub� ^�g� ^�٬� < vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocibindbyname.stub� ^�g� �ܸt� = vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocisetprefetch.stub� ^�g� �9�� C vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_set_call_timeout.stubm ^�gm ��2� ; vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocinewcursor.stub� ^�g� t�գ� B vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_set_module_name.stubl ^�gl ��og� A vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_server_version.stube ^�ge ����� = vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocicollgetelem.stub� ^�g� �"�� ? vendor/phpstan/php-8-stubs/stubs/ext/sqlite3/SQLite3Result.stub. ^�g. � � = vendor/phpstan/php-8-stubs/stubs/ext/sqlite3/SQLite3Stmt.stub� ^�g� ��LȤ B vendor/phpstan/php-8-stubs/stubs/ext/sqlite3/SQLite3Exception.stubk ^�gk �*�Y� 9 vendor/phpstan/php-8-stubs/stubs/ext/sqlite3/SQLite3.stub�9 ^�g�9 =�7� G vendor/phpstan/php-8-stubs/stubs/ext/opcache/opcache_jit_blacklist.stubT ^�gT �ֹ� K vendor/phpstan/php-8-stubs/stubs/ext/opcache/opcache_get_configuration.stubT ^�gT z��� D vendor/phpstan/php-8-stubs/stubs/ext/opcache/opcache_get_status.stubi ^�gi Z�H"� F vendor/phpstan/php-8-stubs/stubs/ext/opcache/opcache_compile_file.stubA ^�gA :ÑҤ D vendor/phpstan/php-8-stubs/stubs/ext/opcache/opcache_invalidate.stubT ^�gT �1� J vendor/phpstan/php-8-stubs/stubs/ext/opcache/opcache_is_script_cached.stubE ^�gE d�%� ? vendor/phpstan/php-8-stubs/stubs/ext/opcache/opcache_reset.stubL ^�gL u���� < vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy_get_html.stub; ^�g; g�5 � < vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy_is_xhtml.stub5 ^�g5 �>0� @ vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy_clean_repair.stub9 ^�g9 c�]�� > vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy_get_config.stub? ^�g? ��=� < vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy_get_body.stub; ^�g; )�� > vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy_get_output.stub9 ^�g9 ��J� : vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy_is_xml.stub3 ^�g3 ���դ 3 vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy.stubY ^�gY q���� ? vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy_get_release.stub/ ^�g/ [�6G� ? vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy_get_opt_doc.stubj ^�gj �-�� A vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy_repair_string.stub� ^�g� �c� � : vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy_getopt.stubN ^�gN �\T-� @ vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy_access_count.stub8 ^�g8 ���� @ vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy_get_html_ver.stub8 ^�g8 ���� ? vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy_error_count.stub7 ^�g7 Å�@� A vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy_warning_count.stub9 ^�g9 ��� < vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy_get_root.stub; ^�g; I�� ? vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy_repair_file.stub� ^�g� 絲�� @ vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy_parse_string.stub� ^�g� f�*H� < vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy_get_head.stub; ^�g; �{`�� D vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy_get_error_buffer.stubE ^�gE &�+� 7 vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidyNode.stub� ^�g� �Ѳޤ > vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy_parse_file.stub� ^�g� �_xN� @ vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy_config_count.stub8 ^�g8 ��ŗ� > vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy_get_status.stub6 ^�g6 7�31� < vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy_diagnose.stub5 ^�g5 ���¤ 9 vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_chr.stubS ^�gS �9�,� : vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_ereg.stubr ^�gr +�d� @ vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_strimwidth.stub� ^�g� c�G� < vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_strstr.stub� ^�g� �B��� < vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_strpos.stubv ^�gv ���B� = vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_stristr.stub� ^�g� ���3� ; vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_eregi.stubs ^�gs ��� < vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_substr.stubq ^�gq ���W� > vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_language.stubi ^�gi �q�� ? vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_send_mail.stub� ^�g� ���A� F vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_ereg_search_regs.stub~ ^�g~ �j��� J vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_encode_numericentity.stub} ^�g} iܛ� C vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_eregi_replace.stub� ^�g� %7��� B vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_ereg_replace.stub� ^�g� D�� F vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_encoding_aliases.stubX ^�gX �Z� H vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_ereg_search_getpos.stub1 ^�g1 �]5�� < vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_strcut.stubq ^�gq ��P� D vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_regex_encoding.stuba ^�ga b%�K� E vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_ereg_search_pos.stub} ^�g} ��Aߤ A vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_http_output.stubJ ^�gJ T�.� I vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_preferred_mime_name.stubK ^�gK &�Yj� ; vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_rtrim.stub| ^�g| ��@� = vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_ucfirst.stubb ^�gb S~ ۤ J vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_decode_numericentity.stubj ^�gj 3䍤 A vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_ereg_search.stub[ ^�g[ �W<¤ @ vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_strtolower.stubT ^�gT <x�5� > vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_strrichr.stub� ^�g� R��� B vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_convert_case.stuba ^�ga �7).� B vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_convert_kana.stubk ^�gk yQI~� ? vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_str_split.stubc ^�gc >�nW� ? vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_parse_str.stub] ^�g] '��&� F vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_convert_encoding.stub� ^�g� �)Jv� D vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_list_encodings.stub/ ^�g/ �f-�� ; vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_split.stubs ^�gs � � E vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_detect_encoding.stub� ^�g� ���E� @ vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_strtoupper.stubT ^�gT ����� = vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_lcfirst.stubb ^�gb �UO� D vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_check_encoding.stubg ^�gg ��P� < vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_strlen.stubM ^�gM *�j� J vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_substitute_character.stubk ^�gk 5s�Ϥ G vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_convert_variables.stub� ^�g� }Z�� K vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_ereg_replace_callback.stub� ^�g� ��� � H vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_ereg_search_setpos.stub= ^�g= ��d^� F vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_ereg_search_init.stubp ^�gp S �_� B vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_detect_order.stubk ^�gk ���V� > vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_strwidth.stubO ^�gO �*� ; vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_ltrim.stub| ^�g| �o᪤ G vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_regex_set_options.stubJ ^�gJ Rޘ� D vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_output_handler.stubK ^�gK ��i0� @ vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_http_input.stubc ^�gc ��G� > vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_strripos.stubx ^�gx ȴ��� 9 vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_ord.stubP ^�gP _��� = vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_strrchr.stub� ^�g� �铤 : vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_trim.stub{ ^�g{ � � ; vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_scrub.stubO ^�gO (RR�� G vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_internal_encoding.stubP ^�gP {� � B vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_substr_count.stube ^�ge ���J� G vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_decode_mimeheader.stubA ^�gA �� = vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_strrpos.stubw ^�gw b�i� = vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_stripos.stubw ^�gw ���n� G vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_encode_mimeheader.stub� ^�g� �e�#� I vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_ereg_search_getregs.stubQ ^�gQ �W�� > vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_get_info.stub/ ^�g/ bߗ � @ vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_ereg_match.stubb ^�gb ^��� = vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_str_pad.stub� ^�g� �2� D vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_getsockname.stub� ^�g� �PI2� D vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_create_pair.stub� ^�g� � �l� = vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_recv.stub} ^�g} �>� > vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_write.stub` ^�g` �)��� D vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_clear_error.stubF ^�gF _�{Z� ? vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_listen.stubK ^�gK �%l�� > vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_close.stub8 ^�g8 ���� Q vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_wsaprotocol_info_release.stubK ^�gK �攘� ? vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_atmark.stubh ^�gh �%|� B vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_set_block.stub< ^�g< �<!� C vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_last_error.stubK ^�gK �� A vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_strerror.stub= ^�g= '�Њ� @ vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_connect.stub^ ^�g^ [��`� C vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_get_option.stubx ^�gx ]�I�� ? vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_getopt.stub� ^�g� t�zV� F vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_create_listen.stub� ^�g� �7�� P vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_wsaprotocol_info_export.stubt ^�gt �Pv�� H vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_addrinfo_lookup.stub� ^�g� �\ur� A vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_shutdown.stubf ^�gf ����� ? vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_accept.stubB ^�gB j�դ A vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_recvfrom.stub� ^�g� �4!ˤ ? vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_sendto.stub� ^�g� 6��q� P vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_wsaprotocol_info_import.stubS ^�gS � �� I vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_addrinfo_explain.stuba ^�ga J� N� I vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_addrinfo_connect.stubR ^�gR ~HG�� D vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_getpeername.stub� ^�g� �x�� = vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_read.stubi ^�gi �qb� ? vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_create.stubX ^�gX R �O� = vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_bind.stubW ^�gW %�� C vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_set_option.stub� ^�g� �� 8 vendor/phpstan/php-8-stubs/stubs/ext/sockets/Socket.stub@ ^�g@ R�o� F vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_import_stream.stub` ^�g` �R7Ť C vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_cmsg_space.stubQ ^�gQ \�դ @ vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_recvmsg.stub` ^�g` ۓ��� = vendor/phpstan/php-8-stubs/stubs/ext/sockets/AddressInfo.stub# ^�g# AA � E vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_set_nonblock.stub? ^�g? ܟ0H� = vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_send.stubc ^�gc N.[4� F vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_export_stream.stubX ^�gX ��hP� ? vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_setopt.stub� ^�g� ĉ � ? vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_select.stub� ^�g� ZOޤ @ vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_sendmsg.stub_ ^�g_ �qp � F vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_addrinfo_bind.stubO ^�gO �I�� 5 vendor/phpstan/php-8-stubs/stubs/ext/dom/DOMText.stub� ^�g� 8葰� F vendor/phpstan/php-8-stubs/stubs/ext/dom/DOMProcessingInstruction.stub� ^�g� �B�Ȥ : vendor/phpstan/php-8-stubs/stubs/ext/dom/DOMException.stub7 ^�g7 wH�� 9 vendor/phpstan/php-8-stubs/stubs/ext/dom/DOMNotation.stub. ^�g. �c� > vendor/phpstan/php-8-stubs/stubs/ext/dom/DOMNameSpaceNode.stub ^�g P�Hۤ ; vendor/phpstan/php-8-stubs/stubs/ext/dom/DOMParentNode.stubA ^�gA ��� @ vendor/phpstan/php-8-stubs/stubs/ext/dom/DOMEntityReference.stubo ^�go *��� : vendor/phpstan/php-8-stubs/stubs/ext/dom/DOMChildNode.stubI ^�gI heL� 9 vendor/phpstan/php-8-stubs/stubs/ext/dom/DOMDocument.stub� ^�g� 㖑� > vendor/phpstan/php-8-stubs/stubs/ext/dom/DOMCharacterData.stub$ ^�g$ !�2� 5 vendor/phpstan/php-8-stubs/stubs/ext/dom/DOMNode.stub� ^�g� q�'� B vendor/phpstan/php-8-stubs/stubs/ext/dom/dom_import_simplexml.stubK ^�gK �E�� 9 vendor/phpstan/php-8-stubs/stubs/ext/dom/DOMNodeList.stubC ^�gC �GQ� 8 vendor/phpstan/php-8-stubs/stubs/ext/dom/DOMComment.stubu ^�gu p=1�� 8 vendor/phpstan/php-8-stubs/stubs/ext/dom/DOMElement.stub� ^�g� ��s�� = vendor/phpstan/php-8-stubs/stubs/ext/dom/DOMNamedNodeMap.stub� ^�g� ���� = vendor/phpstan/php-8-stubs/stubs/ext/dom/DOMCdataSection.stubl ^�gl �� � ? vendor/phpstan/php-8-stubs/stubs/ext/dom/DOMImplementation.stub. ^�g. ��Z� = vendor/phpstan/php-8-stubs/stubs/ext/dom/DOMDocumentType.stubT ^�gT oW=� 6 vendor/phpstan/php-8-stubs/stubs/ext/dom/DOMXPath.stub ^�g ��I� A vendor/phpstan/php-8-stubs/stubs/ext/dom/DOMDocumentFragment.stub7 ^�g7 ��Τ 7 vendor/phpstan/php-8-stubs/stubs/ext/dom/DOMEntity.stub, ^�g, �v��� = vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/HTMLElement.stubS ^�gS �d7z� 6 vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/Text.stub� ^�g� A 8 vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/Entity.stub< ^�g< }]�l� B vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/DocumentFragment.stub� ^�g� \+@m� : vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/NodeList.stub� ^�g� ) �� > vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/NamedNodeMap.stub% ^�g% C (� = vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/XMLDocument.stub� ^�g� �R� � > vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/DocumentType.stub( ^�g( ��(y� : vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/Document.stub� ^�g� ={�� 9 vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/Comment.stub� ^�g� Ӝ� 6 vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/Node.stub' ^�g' HRvפ ? vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/NamespaceInfo.stubC ^�gC �\*x� ; vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/TokenList.stub� ^�g� ͵�Ȥ ? vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/CharacterData.stub+ ^�g+ ����� : vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/Notation.stub� ^�g� g��L� @ vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/Implementation.stub� ^�g� ����� G vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/ProcessingInstruction.stub� ^�g� M�iH� < vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/ParentNode.stuby ^�gy ��cq� 9 vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/Element.stub� ^�g� %��ܤ @ vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/HTMLCollection.stub7 ^�g7 h�+Z� A vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/EntityReference.stubT ^�gT �n݁� A vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/DtdNamedNodeMap.stubU ^�gU �d� � B vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/import_simplexml.stubi ^�gi *E� 7 vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/XPath.stub� ^�g� � � > vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/CDATASection.stubQ ^�gQ �fƤ ; vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/ChildNode.stub ^�g ��Ť > vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/HTMLDocument.stub� ^�g� �q�� B vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/AdjacentPosition.stub� ^�g� б+�� 6 vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/Attr.stub= ^�g= ��e� 5 vendor/phpstan/php-8-stubs/stubs/ext/dom/DOMAttr.stub� ^�g� ����� @ vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant_imp.stubE ^�gE 2�6W� P vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant_date_from_timestamp.stubJ ^�gJ �z�� @ vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant_xor.stubE ^�gE ؏+�� G vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/com_print_typeinfo.stub� ^�g� �?o� < vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant.stub� ^�g� 4b@p� @ vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant_and.stubE ^�gE {wq� J vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/com_get_active_object.stub\ ^�g\ �) ˤ E vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant_get_type.stub= ^�g= �N�D� @ vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant_cat.stubE ^�gE j� @ vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant_not.stub8 ^�g8 F��� @ vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant_mul.stubE ^�gE 5�[� 8 vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/com.stub� ^�g� K�ϯ� E vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant_set_type.stubI ^�gI kjo�� C vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/com_event_sink.stub{ ^�g{ B0ԅ� @ vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant_div.stubE ^�gE ��� @ vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant_fix.stub8 ^�g8 ��F�� @ vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant_set.stubi ^�gi � � E vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/COMPersistHelper.stub� ^�g� ��찤 A vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant_idiv.stubF ^�gF h�� D vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/com_create_guid.stub4 ^�g4 �\B#� @ vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant_add.stubE ^�gE �'Z5� @ vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant_cmp.stubx ^�gx �?�� @ vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant_int.stub8 ^�g8 (?^�� @ vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant_eqv.stubE ^�gE ��=� ? vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant_or.stubD ^�gD �S�� B vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant_round.stubJ ^�gJ �.�� @ vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant_pow.stubE ^�gE �Wg� E vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/com_message_pump.stubJ ^�gJ ���� ; vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/dotnet.stub� ^�g� ��`*� E vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/com_load_typelib.stub[ ^�g[ g���� A vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant_cast.stubI ^�gI *� H vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/com_safearray_proxy.stubC ^�gC ��j� B vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/com_exception.stub? ^�g? P�f� @ vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant_mod.stubE ^�gE Y�� @ vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant_abs.stub8 ^�g8 <��դ @ vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant_neg.stub8 ^�g8 ox�� @ vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant_sub.stubE ^�gE �Ag3� N vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant_date_to_timestamp.stubG ^�gG �뾤 > vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_wstopsig.stub; ^�g; �tu� C vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_async_signals.stubD ^�gD �>�8� D vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_setcpuaffinity.stubn ^�gn �~=Ƥ @ vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_wifstopped.stub8 ^�g8 p��� A vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_sigprocmask.stub� ^�g� v��� A vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_getpriority.stub| ^�g| ��� ; vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_forkx.stub[ ^�g[ 1��ߤ > vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_wtermsig.stub; ^�g; L�Q� H vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_signal_get_handler.stubV ^�gV ���%� B vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_wifcontinued.stubQ ^�gQ h���� : vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_exec.stub[ ^�g[ ���ʤ A vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_wexitstatus.stub> ^�g> Ӑ !� > vendor/phpstan/php-8-stubs/stubs/ext/pcntl/Pcntl/QosClass.stub� ^�g� i�tV� B vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_setqos_class.stubt ^�gt Db�� A vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_wifsignaled.stub@ ^�g@ � � ; vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_setns.stub� ^�g� � G� ; vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_errno.stubJ ^�gJ 6��~� ? vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_wifexited.stubE ^�gE �4 5� B vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_sigtimedwait.stub� ^�g� i� A vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_sigwaitinfo.stub� ^�g� �" O� < vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_getcpu.stubY ^�gY 2��� B vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_getqos_class.stub| ^�g| ���%� : vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_fork.stubH ^�gH ���Ҥ < vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_signal.stub� ^�g� ��� D vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_getcpuaffinity.stub� ^�g� �I n� = vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_unshare.stubH ^�gH ��k5� E vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_signal_dispatch.stub2 ^�g2 :"�� > vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_strerror.stubC ^�gC f�V�� A vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_setpriority.stub� ^�g� �9��� = vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_waitpid.stub� ^�g� A�� D vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_get_last_error.stub0 ^�g0 �h1� < vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_waitid.stub ^�g ܸ� � ; vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_rfork.stubl ^�gl � �� : vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_wait.stub� ^�g� t��M� ; vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_alarm.stub3 ^�g3 u��>� ; vendor/phpstan/php-8-stubs/stubs/ext/filter/filter_var.stubj ^�gj �c��� A vendor/phpstan/php-8-stubs/stubs/ext/filter/filter_var_array.stub� ^�g� +{K� : vendor/phpstan/php-8-stubs/stubs/ext/filter/filter_id.stub7 ^�g7 ��� = vendor/phpstan/php-8-stubs/stubs/ext/filter/filter_input.stub{ ^�g{ �`@8� < vendor/phpstan/php-8-stubs/stubs/ext/filter/filter_list.stub@ ^�g@ �� V� ? vendor/phpstan/php-8-stubs/stubs/ext/filter/filter_has_var.stubn ^�gn ��u`� C vendor/phpstan/php-8-stubs/stubs/ext/filter/filter_input_array.stub� ^�g� K�x� > vendor/phpstan/php-8-stubs/stubs/ext/tokenizer/token_name.stub0 ^�g0 �$E� < vendor/phpstan/php-8-stubs/stubs/ext/tokenizer/PhpToken.stub ^�g +n��� A vendor/phpstan/php-8-stubs/stubs/ext/tokenizer/token_get_all.stubi ^�gi �8L+� G vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_in_daylight_time.stubL ^�gL ���� < vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_get_id.stubI ^�gI �A� O vendor/phpstan/php-8-stubs/stubs/ext/intl/transliterator_create_from_rules.stub� ^�g� w��4� D vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_create_default.stub; ^�g; �9B � D vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_get_windows_id.stubn ^�gn {$ŋ� = vendor/phpstan/php-8-stubs/stubs/ext/intl/locale_compose.stubA ^�gA ~`�Ф = vendor/phpstan/php-8-stubs/stubs/ext/intl/collator_asort.stubp ^�gp �^�R� ? vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_set_time.stubV ^�gV s��� C vendor/phpstan/php-8-stubs/stubs/ext/intl/converter/UConverter.stub(1 ^�g(1 ���� < vendor/phpstan/php-8-stubs/stubs/ext/intl/collator_sort.stubo ^�go Ǎ��� ? vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_get_time.stubK ^�gK � ] � C vendor/phpstan/php-8-stubs/stubs/ext/intl/msgfmt_parse_message.stub ^�g A��� J vendor/phpstan/php-8-stubs/stubs/ext/intl/locale_get_display_language.stubm ^�gm �� D vendor/phpstan/php-8-stubs/stubs/ext/intl/normalizer/Normalizer.stub� ^�g� ��h�� E vendor/phpstan/php-8-stubs/stubs/ext/intl/datefmt_get_error_code.stubO ^�gO 4�.�� D vendor/phpstan/php-8-stubs/stubs/ext/intl/transliterator_create.stub� ^�g� w%�� I vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_get_actual_maximum.stub_ ^�g_ '�zy� @ vendor/phpstan/php-8-stubs/stubs/ext/intl/locale_get_region.stub? ^�g? �� � ? vendor/phpstan/php-8-stubs/stubs/ext/intl/collator_compare.stube ^�ge <=R� ; vendor/phpstan/php-8-stubs/stubs/ext/intl/locale_parse.stub9 ^�g9 p���� > vendor/phpstan/php-8-stubs/stubs/ext/intl/grapheme_strpos.stubb ^�gb 9hⓤ G vendor/phpstan/php-8-stubs/stubs/ext/intl/msgfmt_get_error_message.stubS ^�gS VY� O vendor/phpstan/php-8-stubs/stubs/ext/intl/resourcebundle_get_error_message.stubV ^�gV ��6� H vendor/phpstan/php-8-stubs/stubs/ext/intl/locale_get_display_script.stubk ^�gk ��dk� C vendor/phpstan/php-8-stubs/stubs/ext/intl/datefmt_get_datetype.stubS ^�gS �y � O vendor/phpstan/php-8-stubs/stubs/ext/intl/intlgregcal_get_gregorian_change.stub^ ^�g^ ��dƤ K vendor/phpstan/php-8-stubs/stubs/ext/intl/collator_sort_with_sort_keys.stubY ^�gY $�r_� ? vendor/phpstan/php-8-stubs/stubs/ext/intl/grapheme_extract.stub� ^�g� �恤 A vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_get_locale.stubY ^�gY ��� � D vendor/phpstan/php-8-stubs/stubs/ext/intl/collator_set_strength.stub� ^�g� �Іp� : vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_get.stubP ^�gP @D� � @ vendor/phpstan/php-8-stubs/stubs/ext/intl/locale_get_script.stub? ^�g? �Fʿ� > vendor/phpstan/php-8-stubs/stubs/ext/intl/grapheme_strstr.stubp ^�gp (�5�� C vendor/phpstan/php-8-stubs/stubs/ext/intl/normalizer_normalize.stubx ^�gx �'�� J vendor/phpstan/php-8-stubs/stubs/ext/intl/intlgregcal_create_instance.stub� ^�g� i�oM� I vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_from_date_time_zone.stubX ^�gX �t�E� U vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_set_minimal_days_in_first_week.stub� ^�g� M=�� A vendor/phpstan/php-8-stubs/stubs/ext/intl/datefmt_get_locale.stubt ^�gt �:LԤ A vendor/phpstan/php-8-stubs/stubs/ext/intl/grapheme_str_split.stubf ^�gf �-sq� < vendor/phpstan/php-8-stubs/stubs/ext/intl/msgfmt_create.stubg ^�gg ��b� B vendor/phpstan/php-8-stubs/stubs/ext/intl/intl_get_error_code.stub< ^�g< Q�/� = vendor/phpstan/php-8-stubs/stubs/ext/intl/datefmt_format.stub� ^�g� ��4�� G vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_get_error_message.stubT ^�gT y�� K vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_get_greatest_minimum.stuba ^�ga ��1z� I vendor/phpstan/php-8-stubs/stubs/ext/intl/locale_get_display_variant.stubl ^�gl 2�T[� D vendor/phpstan/php-8-stubs/stubs/ext/intl/resourcebundle_create.stub� ^�g� k�� < vendor/phpstan/php-8-stubs/stubs/ext/intl/numfmt_format.stub� ^�g� �C�Z� ; vendor/phpstan/php-8-stubs/stubs/ext/intl/numfmt_parse.stub� ^�g� ��Ҥ A vendor/phpstan/php-8-stubs/stubs/ext/intl/resourcebundle_get.stub2 ^�g2 O�> � C vendor/phpstan/php-8-stubs/stubs/ext/intl/datefmt_get_timetype.stubS ^�gS `�P� C vendor/phpstan/php-8-stubs/stubs/ext/intl/datefmt_set_timezone.stubJ ^�gJ ��݆� > vendor/phpstan/php-8-stubs/stubs/ext/intl/grapheme_strlen.stubS ^�gS � 4� C vendor/phpstan/php-8-stubs/stubs/ext/intl/resourcebundle_count.stubG ^�gG ���� A vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_is_lenient.stubF ^�gF sFLq� @ vendor/phpstan/php-8-stubs/stubs/ext/intl/numfmt_set_symbol.stube ^�ge I�٤ B vendor/phpstan/php-8-stubs/stubs/ext/intl/datefmt_set_lenient.stub\ ^�g\ n*w� A vendor/phpstan/php-8-stubs/stubs/ext/intl/numfmt_get_pattern.stubR ^�gR K��� F vendor/phpstan/php-8-stubs/stubs/ext/intl/locale_get_all_variants.stubD ^�gD �l� N vendor/phpstan/php-8-stubs/stubs/ext/intl/breakiterator/IntlBreakIterator.stubL ^�gL p Wq� W vendor/phpstan/php-8-stubs/stubs/ext/intl/breakiterator/IntlRuleBasedBreakIterator.stub� ^�g� f�,� W vendor/phpstan/php-8-stubs/stubs/ext/intl/breakiterator/IntlCodePointBreakIterator.stub� ^�g� ?�� N vendor/phpstan/php-8-stubs/stubs/ext/intl/breakiterator/IntlPartsIterator.stub@ ^�g@ �m6� O vendor/phpstan/php-8-stubs/stubs/ext/intl/normalizer_get_raw_decomposition.stub� ^�g� �½�� T vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_set_repeated_wall_time_option.stub� ^�g� ^`l� @ vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_get_offset.stub� ^�g� qs(ɤ ; vendor/phpstan/php-8-stubs/stubs/ext/intl/idn_to_ascii.stub� ^�g� 3H�� L vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_get_available_locales.stubR ^�gR *�e?� R vendor/phpstan/php-8-stubs/stubs/ext/intl/dateformat/IntlDatePatternGenerator.stubN ^�gN ޒ�!� K vendor/phpstan/php-8-stubs/stubs/ext/intl/dateformat/IntlDateFormatter.stub� ^�g� �~a4� D vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_get_raw_offset.stubH ^�gH ��D�� = vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_get_gmt.stub4 ^�g4 ��� E vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_get_error_code.stubO ^�gO ,%室 G vendor/phpstan/php-8-stubs/stubs/ext/intl/numfmt_get_error_message.stubR ^�gR ���� C vendor/phpstan/php-8-stubs/stubs/ext/intl/datefmt_set_calendar.stubp ^�gp W)�`� I vendor/phpstan/php-8-stubs/stubs/ext/intl/collator_get_error_message.stubP ^�gP �]�#� H vendor/phpstan/php-8-stubs/stubs/ext/intl/locale_get_display_region.stubk ^�gk ��+_� : vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_add.stubW ^�gW y�;z� K vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_get_day_of_week_type.stube ^�ge 2��� F vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_get_display_name.stub� ^�g� �hW�� C vendor/phpstan/php-8-stubs/stubs/ext/intl/numfmt_get_attribute.stubg ^�gg �{�� G vendor/phpstan/php-8-stubs/stubs/ext/intl/normalizer_is_normalized.stubc ^�gc |��� G vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_field_difference.stubo ^�go ?�� = vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_is_set.stubN ^�gN i��=� F vendor/phpstan/php-8-stubs/stubs/ext/intl/transliterator_list_ids.stubR ^�gR ."9� F vendor/phpstan/php-8-stubs/stubs/ext/intl/locale_get_display_name.stubi ^�gi ��8դ U vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_get_minimal_days_in_first_week.stub_ ^�g_ F@�� < vendor/phpstan/php-8-stubs/stubs/ext/intl/locale_lookup.stub� ^�g� rq�� ? vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_get_type.stubF ^�gF |��� D vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_get_time_zone.stubX ^�gX �C��� ? vendor/phpstan/php-8-stubs/stubs/ext/intl/grapheme_strrpos.stubc ^�gc D��Ҥ B vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_set_lenient.stub� ^�g� ��\�� D vendor/phpstan/php-8-stubs/stubs/ext/intl/collator_get_sort_key.stub[ ^�g[ �K�� G vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_to_date_time_zone.stub[ ^�g[ �}K� E vendor/phpstan/php-8-stubs/stubs/ext/intl/collator_get_attribute.stubY ^�gY 'C $� G vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_is_equivalent_to.stubb ^�gb �qr�� > vendor/phpstan/php-8-stubs/stubs/ext/intl/intl_is_failure.stub: ^�g: {y�� E vendor/phpstan/php-8-stubs/stubs/ext/intl/intl_get_error_message.stub5 ^�g5 �C;$� D vendor/phpstan/php-8-stubs/stubs/ext/intl/locale_filter_matches.stubr ^�gr �� � A vendor/phpstan/php-8-stubs/stubs/ext/intl/msgfmt_get_pattern.stubS ^�gS u��� H vendor/phpstan/php-8-stubs/stubs/ext/intl/datefmt_get_error_message.stubU ^�gU ��Do� E vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_get_dst_savings.stubI ^�gI C�ತ L vendor/phpstan/php-8-stubs/stubs/ext/intl/transliterator_create_inverse.stube ^�ge ~�1K� F vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_create_time_zone.stubP ^�gP {�Ф D vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_get_error_code.stubN ^�gN �U � < vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_clear.stub� ^�g� �V�ʤ E vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_from_date_time.stubo ^�go �J�K� J vendor/phpstan/php-8-stubs/stubs/ext/intl/locale_get_primary_language.stubI ^�gI @~�� < vendor/phpstan/php-8-stubs/stubs/ext/intl/msgfmt_format.stub] ^�g] X/_�� @ vendor/phpstan/php-8-stubs/stubs/ext/intl/numfmt_get_locale.stubq ^�gq J���� I vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_get_tz_data_version.stub? ^�g? KU^>� < vendor/phpstan/php-8-stubs/stubs/ext/intl/datefmt_parse.stub� ^�g� ���7� F vendor/phpstan/php-8-stubs/stubs/ext/intl/locale_accept_from_http.stubJ ^�gJ g�� D vendor/phpstan/php-8-stubs/stubs/ext/intl/msgfmt_get_error_code.stubM ^�gM wυ�� A vendor/phpstan/php-8-stubs/stubs/ext/intl/datefmt_is_lenient.stubL ^�gL G��Ԥ L vendor/phpstan/php-8-stubs/stubs/ext/intl/resourcebundle/ResourceBundle.stubh ^�gh �+�� E vendor/phpstan/php-8-stubs/stubs/ext/intl/numfmt_format_currency.stubw ^�gw �M�d� < vendor/phpstan/php-8-stubs/stubs/ext/intl/locale/Locale.stubo ^�go �� D vendor/phpstan/php-8-stubs/stubs/ext/intl/timezone/IntlTimeZone.stub ^�g �W��� ; vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_roll.stubr ^�gr ��Fe� F vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_get_canonical_id.stub� ^�g� ��7�� O vendor/phpstan/php-8-stubs/stubs/ext/intl/transliterator_get_error_message.stubd ^�gd "K�� H vendor/phpstan/php-8-stubs/stubs/ext/intl/numfmt_get_text_attribute.stubi ^�gi ��� G vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_get_equivalent_id.stub\ ^�g\ ��5� ; vendor/phpstan/php-8-stubs/stubs/ext/intl/msgfmt_parse.stubs ^�gs �خ0� D vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_set_time_zone.stub� ^�g� � �� @ vendor/phpstan/php-8-stubs/stubs/ext/intl/numfmt_get_symbol.stub^ ^�g^ ��A�� < vendor/phpstan/php-8-stubs/stubs/ext/intl/numfmt_create.stubz ^�gz 5ڈt� B vendor/phpstan/php-8-stubs/stubs/ext/intl/common/IntlIterator.stubi ^�gi �X�A� @ vendor/phpstan/php-8-stubs/stubs/ext/intl/msgfmt_get_locale.stubL ^�gL + ��� @ vendor/phpstan/php-8-stubs/stubs/ext/intl/collator/Collator.stubF ^�gF �CT{� C vendor/phpstan/php-8-stubs/stubs/ext/intl/numfmt_set_attribute.stubn ^�gn XR� = vendor/phpstan/php-8-stubs/stubs/ext/intl/uchar/IntlChar.stubJ� ^�gJ� D� � L vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_set_first_day_of_week.stub� ^�g� �t�� F vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_create_instance.stub� ^�g� �<|� A vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_get_unknown.stub8 ^�g8 ��� F vendor/phpstan/php-8-stubs/stubs/ext/intl/datefmt_get_timezone_id.stubY ^�gY �k�� @ vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_get_region.stubH ^�gH W_̤ H vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_get_least_maximum.stub^ ^�g^ �R�v� B vendor/phpstan/php-8-stubs/stubs/ext/intl/locale_canonicalize.stubA ^�gA � �:� A vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_get_iana_id.stub| ^�g| ��`� J vendor/phpstan/php-8-stubs/stubs/ext/intl/datefmt_get_calendar_object.stubi ^�gi V*+}� @ vendor/phpstan/php-8-stubs/stubs/ext/intl/grapheme_strripos.stubd ^�gd =�'� : vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_set.stub� ^�g� &ʵC� B vendor/phpstan/php-8-stubs/stubs/ext/intl/collator_get_locale.stubT ^�gT /<�� M vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_get_weekend_transition.stubg ^�gg �w�r� = vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_equals.stubX ^�gX �e�W� C vendor/phpstan/php-8-stubs/stubs/ext/intl/datefmt_get_timezone.stub] ^�g] ^�=�� > vendor/phpstan/php-8-stubs/stubs/ext/intl/intl_error_name.stub< ^�g< vz1� G vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_use_daylight_time.stubL ^�gL ��Ҥ K vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_get_id_for_windows_id.stubk ^�gk R-��� A vendor/phpstan/php-8-stubs/stubs/ext/intl/locale_get_default.stub> ^�g> F�P�� : vendor/phpstan/php-8-stubs/stubs/ext/intl/idn_to_utf8.stub� ^�g� �Ju� B vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_get_maximum.stubX ^�gX �{� A vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_is_weekend.stub` ^�g` ��c)� M vendor/phpstan/php-8-stubs/stubs/ext/intl/calendar/IntlGregorianCalendar.stub� ^�g� �`�T� D vendor/phpstan/php-8-stubs/stubs/ext/intl/calendar/IntlCalendar.stub�F ^�g�F 8+��� T vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_get_repeated_wall_time_option.stubX ^�gX ��� L vendor/phpstan/php-8-stubs/stubs/ext/intl/transliterator_get_error_code.stub^ ^�g^ �*`� H vendor/phpstan/php-8-stubs/stubs/ext/intl/formatter/NumberFormatter.stub�\ ^�g�\ ��Ҥ = vendor/phpstan/php-8-stubs/stubs/ext/intl/datefmt_create.stubc ^�gc /�u� L vendor/phpstan/php-8-stubs/stubs/ext/intl/resourcebundle_get_error_code.stubP ^�gP �9�e� F vendor/phpstan/php-8-stubs/stubs/ext/intl/collator_get_error_code.stubJ ^�gJ �.�Ȥ D vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_has_same_rules.stubf ^�gf ��� � < vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_after.stubW ^�gW ��U� C vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_to_date_time.stubS ^�gS !=r� < vendor/phpstan/php-8-stubs/stubs/ext/intl/IntlException.stubT ^�gT c�� D vendor/phpstan/php-8-stubs/stubs/ext/intl/numfmt_get_error_code.stubL ^�gL ���$� I vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_get_actual_minimum.stub_ ^�g_ %B�@� S vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_get_skipped_wall_time_option.stubW ^�gW ��y� ? vendor/phpstan/php-8-stubs/stubs/ext/intl/grapheme_stripos.stubc ^�gc �� � B vendor/phpstan/php-8-stubs/stubs/ext/intl/datefmt_set_pattern.stub^ ^�g^ C-� H vendor/phpstan/php-8-stubs/stubs/ext/intl/spoofchecker/Spoofchecker.stub� ^�g� �d�a� A vendor/phpstan/php-8-stubs/stubs/ext/intl/msgfmt_set_pattern.stub\ ^�g\ �� � H vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_get_error_message.stubU ^�gU �� I vendor/phpstan/php-8-stubs/stubs/ext/intl/msgformat/MessageFormatter.stub� ^�g� �L��� B vendor/phpstan/php-8-stubs/stubs/ext/intl/locale_get_keywords.stuba ^�ga Ϲ�n� C vendor/phpstan/php-8-stubs/stubs/ext/intl/datefmt_get_calendar.stubS ^�gS {э�� H vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_create_enumeration.stub� ^�g� ���5� H vendor/phpstan/php-8-stubs/stubs/ext/intl/numfmt_set_text_attribute.stubp ^�gp �a� > vendor/phpstan/php-8-stubs/stubs/ext/intl/collator_create.stubO ^�gO �`� D vendor/phpstan/php-8-stubs/stubs/ext/intl/msgfmt_format_message.stubh ^�gh ��� ? vendor/phpstan/php-8-stubs/stubs/ext/intl/grapheme_stristr.stubq ^�gq ԺU� L vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_get_first_day_of_week.stubV ^�gV �PC̤ @ vendor/phpstan/php-8-stubs/stubs/ext/intl/datefmt_localtime.stub� ^�g� ��eƤ B vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_get_minimum.stubX ^�gX B�(� D vendor/phpstan/php-8-stubs/stubs/ext/intl/collator_get_strength.stubB ^�gB ��4[� O vendor/phpstan/php-8-stubs/stubs/ext/intl/intlgregcal_set_gregorian_change.stubo ^�go <�}� E vendor/phpstan/php-8-stubs/stubs/ext/intl/resourcebundle_locales.stub_ ^�g_ O_}�� L vendor/phpstan/php-8-stubs/stubs/ext/intl/transliterator/Transliterator.stub� ^�g� ��� K vendor/phpstan/php-8-stubs/stubs/ext/intl/transliterator_transliterate.stub� ^�g� !n�r� = vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_before.stubX ^�gX �3�T� D vendor/phpstan/php-8-stubs/stubs/ext/intl/datefmt_format_object.stub� ^�g� �2w� > vendor/phpstan/php-8-stubs/stubs/ext/intl/grapheme_substr.stubd ^�gd ����� B vendor/phpstan/php-8-stubs/stubs/ext/intl/datefmt_get_pattern.stubU ^�gU �S�X� U vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_create_time_zone_id_enumeration.stub� ^�g� �:� S vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_set_skipped_wall_time_option.stub� ^�g� �J��� A vendor/phpstan/php-8-stubs/stubs/ext/intl/numfmt_set_pattern.stub[ ^�g[ ��$դ G vendor/phpstan/php-8-stubs/stubs/ext/intl/intlgregcal_is_leap_year.stub` ^�g` ���� > vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_get_now.stub- ^�g- �Z�2� A vendor/phpstan/php-8-stubs/stubs/ext/intl/locale_set_default.stub� ^�g� =d�� D vendor/phpstan/php-8-stubs/stubs/ext/intl/numfmt_parse_currency.stub� ^�g� ���ˤ J vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_count_equivalent_ids.stub^ ^�g^ $'� E vendor/phpstan/php-8-stubs/stubs/ext/intl/collator_set_attribute.stub` ^�g` ���� T vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_get_keyword_values_for_locale.stub� ^�g� �� � 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/assert.stubx ^�gx ͢Mo� C vendor/phpstan/php-8-stubs/stubs/ext/standard/set_include_path.stubI ^�gI ���� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/feof.stubG ^�gG =�m�� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/str_increment.stubK ^�gK t��� C vendor/phpstan/php-8-stubs/stubs/ext/standard/convert_uudecode.stubC ^�gC 6�b�� > vendor/phpstan/php-8-stubs/stubs/ext/standard/show_source.stubr ^�gr v��6� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/crypt.stubN ^�gN �7�� M vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_context_get_default.stub_ ^�g_ �ؤ 6 vendor/phpstan/php-8-stubs/stubs/ext/standard/pos.stubJ ^�gJ ��� = vendor/phpstan/php-8-stubs/stubs/ext/standard/array_rand.stubM ^�gM �BQ� N vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_resolve_include_path.stubP ^�gP 'F^� = vendor/phpstan/php-8-stubs/stubs/ext/standard/strtoupper.stub7 ^�g7 9Z+�� = vendor/phpstan/php-8-stubs/stubs/ext/standard/getlastmod.stub, ^�g, ��Ӥ C vendor/phpstan/php-8-stubs/stubs/ext/standard/dns_check_record.stub� ^�g� ��� C vendor/phpstan/php-8-stubs/stubs/ext/standard/disk_total_space.stubE ^�gE Bx�̤ = vendor/phpstan/php-8-stubs/stubs/ext/standard/array_keys.stub� ^�g� �b� M vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_context_set_options.stub ^�g �'hĤ < vendor/phpstan/php-8-stubs/stubs/ext/standard/metaphone.stubf ^�gf ���Ф > vendor/phpstan/php-8-stubs/stubs/ext/standard/is_readable.stub8 ^�g8 [K�z� H vendor/phpstan/php-8-stubs/stubs/ext/standard/memory_get_peak_usage.stubI ^�gI )�*� G vendor/phpstan/php-8-stubs/stubs/ext/standard/sapi_windows_cp_conv.stubv ^�gv �I]�� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/rawurldecode.stub9 ^�g9 6��� = vendor/phpstan/php-8-stubs/stubs/ext/standard/phpversion.stubH ^�gH �L��� < vendor/phpstan/php-8-stubs/stubs/ext/standard/parse_str.stubZ ^�gZ ȇPI� : vendor/phpstan/php-8-stubs/stubs/ext/standard/strpbrk.stubN ^�gN ��Kݤ Q vendor/phpstan/php-8-stubs/stubs/ext/standard/http_get_last_response_headers.stubN ^�gN =��Ĥ < vendor/phpstan/php-8-stubs/stubs/ext/standard/iptcparse.stubV ^�gV �ה� B vendor/phpstan/php-8-stubs/stubs/ext/standard/debug_zval_dump.stubJ ^�gJ d5͉� < vendor/phpstan/php-8-stubs/stubs/ext/standard/fileowner.stub; ^�g; �Oh� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/rawurlencode.stub9 ^�g9 ��� D vendor/phpstan/php-8-stubs/stubs/ext/standard/socket_get_status.stubx ^�gx �դ P vendor/phpstan/php-8-stubs/stubs/ext/standard/sapi_windows_set_ctrl_handler.stub^ ^�g^ ��|�� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/str_contains.stubI ^�gI i:3ˤ @ vendor/phpstan/php-8-stubs/stubs/ext/standard/getservbyport.stubk ^�gk F�W� > vendor/phpstan/php-8-stubs/stubs/ext/standard/array_shift.stub6 ^�g6 �0S�� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/rewind.stubI ^�gI �BӐ� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/range.stub ^�g j%�>� C vendor/phpstan/php-8-stubs/stubs/ext/standard/array_diff_assoc.stubL ^�gL �B��� A vendor/phpstan/php-8-stubs/stubs/ext/standard/parse_ini_file.stub� ^�g� � e� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/gettimeofday.stub] ^�g] �q;?� : vendor/phpstan/php-8-stubs/stubs/ext/standard/fnmatch.stubi ^�gi � �b� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/lchown.stubU ^�gU �Y�� : vendor/phpstan/php-8-stubs/stubs/ext/standard/ucwords.stubX ^�gX �|�Τ 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/mkdir.stub� ^�g� � � E vendor/phpstan/php-8-stubs/stubs/ext/standard/move_uploaded_file.stubG ^�gG U�*� I vendor/phpstan/php-8-stubs/stubs/ext/standard/__PHP_Incomplete_Class.stub^ ^�g^ LG8H� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/is_countable.stub5 ^�g5 ���s� < vendor/phpstan/php-8-stubs/stubs/ext/standard/is_object.stub2 ^�g2 ��*j� < vendor/phpstan/php-8-stubs/stubs/ext/standard/rewinddir.stub` ^�g` ��=�� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/ob_get_flush.stub1 ^�g1 x� �� A vendor/phpstan/php-8-stubs/stubs/ext/standard/escapeshellcmd.stub< ^�g< E-_�� F vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_get_contents.stub� ^�g� �0$� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/wordwrap.stubz ^�gz c�Eb� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/pathinfo.stubk ^�gk �6[Ĥ ? vendor/phpstan/php-8-stubs/stubs/ext/standard/is_writeable.stubS ^�gS ���� J vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_register_wrapper.stub� ^�g� ��E� : vendor/phpstan/php-8-stubs/stubs/ext/standard/ucfirst.stub4 ^�g4 �� ܤ I vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_set_read_buffer.stubc ^�gc ��m�� A vendor/phpstan/php-8-stubs/stubs/ext/standard/array_diff_key.stubJ ^�gJ �=+� B vendor/phpstan/php-8-stubs/stubs/ext/standard/php_user_filter.stub� ^�g� b�@k� = vendor/phpstan/php-8-stubs/stubs/ext/standard/pfsockopen.stub� ^�g� {[�h� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/ob_start.stubr ^�gr }<��� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/array_product.stub; ^�g; �q�-� : vendor/phpstan/php-8-stubs/stubs/ext/standard/long2ip.stub� ^�g� ��Q�� O vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_bucket_make_writeable.stub' ^�g' P��Τ 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/octdec.stub< ^�g< �9� B vendor/phpstan/php-8-stubs/stubs/ext/standard/disk_free_space.stubD ^�gD ,�T�� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/base64_encode.stubI ^�gI ��� : vendor/phpstan/php-8-stubs/stubs/ext/standard/stristr.stubi ^�gi O�z�� : vendor/phpstan/php-8-stubs/stubs/ext/standard/str_pad.stubz ^�gz e��!� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/array_reverse.stubT ^�gT ¼)0� = vendor/phpstan/php-8-stubs/stubs/ext/standard/getrandmax.stubB ^�gB la� : vendor/phpstan/php-8-stubs/stubs/ext/standard/fputcsv.stub ^�g ^@"� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/getcwd.stub2 ^�g2 �88Ǥ ; vendor/phpstan/php-8-stubs/stubs/ext/standard/ob_flush.stub% ^�g% ��$E� < vendor/phpstan/php-8-stubs/stubs/ext/standard/filectime.stub; ^�g; �3�� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/next.stub6 ^�g6 �U�P� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/fflush.stubI ^�gI d$_`� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/getmypid.stub* ^�g* �o4� 6 vendor/phpstan/php-8-stubs/stubs/ext/standard/abs.stub@ ^�g@ D_fӤ > vendor/phpstan/php-8-stubs/stubs/ext/standard/chunk_split.stubf ^�gf �-j�� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/filetype.stub= ^�g= L� M vendor/phpstan/php-8-stubs/stubs/ext/standard/get_html_translation_table.stub� ^�g� ��i� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/floor.stub1 ^�g1 op�Z� C vendor/phpstan/php-8-stubs/stubs/ext/standard/parse_ini_string.stub� ^�g� ��t� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/ksort.stub� ^�g� U��f� < vendor/phpstan/php-8-stubs/stubs/ext/standard/str_rot13.stub6 ^�g6 谛;� K vendor/phpstan/php-8-stubs/stubs/ext/standard/unregister_tick_function.stubG ^�gG �{5� > vendor/phpstan/php-8-stubs/stubs/ext/standard/is_writable.stub8 ^�g8 �b��� < vendor/phpstan/php-8-stubs/stubs/ext/standard/microtime.stubo ^�go oĕ� F vendor/phpstan/php-8-stubs/stubs/ext/standard/realpath_cache_size.stub/ ^�g/ z�l� H vendor/phpstan/php-8-stubs/stubs/ext/standard/array_intersect_assoc.stubQ ^�gQ ³�L� I vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_socket_get_name.stubo ^�go QQ� H vendor/phpstan/php-8-stubs/stubs/ext/standard/array_change_key_case.stubW ^�gW ��Q � : vendor/phpstan/php-8-stubs/stubs/ext/standard/is_file.stub4 ^�g4 �J�� J vendor/phpstan/php-8-stubs/stubs/ext/standard/quoted_printable_decode.stub^ ^�g^ n��� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/getservbyname.stubg ^�gg ���� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/is_dir.stub3 ^�g3 �� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/exec.stub� ^�g� 6���� : vendor/phpstan/php-8-stubs/stubs/ext/standard/print_r.stub� ^�g� �"�N� : vendor/phpstan/php-8-stubs/stubs/ext/standard/ini_set.stub� ^�g� �P� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/mt_getrandmax.stub) ^�g) �ag� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/mt_srand.stub� ^�g� '��� < vendor/phpstan/php-8-stubs/stubs/ext/standard/urlencode.stub6 ^�g6 �z�e� I vendor/phpstan/php-8-stubs/stubs/ext/standard/getimagesizefromstring.stub� ^�g� ��y�� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/fscanf.stub� ^�g� t�[ � = vendor/phpstan/php-8-stubs/stubs/ext/standard/str_repeat.stubC ^�gC �+�� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/mail.stub� ^�g� fc 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/prev.stub6 ^�g6 ���l� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/usleep.stub4 ^�g4 � � 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/ltrim.stubX ^�gX ��;-� : vendor/phpstan/php-8-stubs/stubs/ext/standard/sprintf.stub^ ^�g^ ��S�� G vendor/phpstan/php-8-stubs/stubs/ext/standard/call_user_func_array.stubQ ^�gQ +�w� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/expm1.stub- ^�g- �Bf�� B vendor/phpstan/php-8-stubs/stubs/ext/standard/set_file_buffer.stub� ^�g� ��OK� < vendor/phpstan/php-8-stubs/stubs/ext/standard/setlocale.stub� ^�g� � Ib� B vendor/phpstan/php-8-stubs/stubs/ext/standard/str_starts_with.stubL ^�gL ��Y� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/array_splice.stubr ^�gr Ý�5� C vendor/phpstan/php-8-stubs/stubs/ext/standard/sys_get_temp_dir.stub6 ^�g6 �Qq� = vendor/phpstan/php-8-stubs/stubs/ext/standard/array_diff.stubF ^�gF �C��� M vendor/phpstan/php-8-stubs/stubs/ext/standard/sapi_windows_vt100_support.stub� ^�g� ���?� A vendor/phpstan/php-8-stubs/stubs/ext/standard/dns_get_record.stub ^�g a[�8� G vendor/phpstan/php-8-stubs/stubs/ext/standard/array_intersect_ukey.stubk ^�gk �|��� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/asort.stub� ^�g� �U�!� A vendor/phpstan/php-8-stubs/stubs/ext/standard/array_key_last.stubB ^�gB �s7�� > vendor/phpstan/php-8-stubs/stubs/ext/standard/levenshtein.stub� ^�g� ���� 6 vendor/phpstan/php-8-stubs/stubs/ext/standard/exp.stub+ ^�g+ ���ۤ < vendor/phpstan/php-8-stubs/stubs/ext/standard/filegroup.stub; ^�g; �4�� A vendor/phpstan/php-8-stubs/stubs/ext/standard/set_time_limit.stubk ^�gk ,�mz� = vendor/phpstan/php-8-stubs/stubs/ext/standard/dns_get_mx.stub� ^�g� %�� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/strnatcasecmp.stubI ^�gI A_'� F vendor/phpstan/php-8-stubs/stubs/ext/standard/array_intersect_key.stubO ^�gO �釤 = vendor/phpstan/php-8-stubs/stubs/ext/standard/array_find.stubY ^�gY �n<� 6 vendor/phpstan/php-8-stubs/stubs/ext/standard/ord.stub0 ^�g0 2�a/� : vendor/phpstan/php-8-stubs/stubs/ext/standard/is_bool.stub0 ^�g0 ��� � @ vendor/phpstan/php-8-stubs/stubs/ext/standard/array_replace.stubO ^�gO |�7c� : vendor/phpstan/php-8-stubs/stubs/ext/standard/strrchr.stub� ^�g� � v� > vendor/phpstan/php-8-stubs/stubs/ext/standard/ini_get_all.stubu ^�gu ��̤ ? vendor/phpstan/php-8-stubs/stubs/ext/standard/array_column.stubv ^�gv %�� > vendor/phpstan/php-8-stubs/stubs/ext/standard/get_browser.stub� ^�g� /.� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/setrawcookie.stub� ^�g� $� < vendor/phpstan/php-8-stubs/stubs/ext/standard/is_scalar.stub2 ^�g2 2��m� = vendor/phpstan/php-8-stubs/stubs/ext/standard/getmyinode.stub, ^�g, ��$h� < vendor/phpstan/php-8-stubs/stubs/ext/standard/array_all.stubW ^�gW ���¤ 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/fclose.stubI ^�gI p|� � : vendor/phpstan/php-8-stubs/stubs/ext/standard/dirname.stubC ^�gC !j�Ф : vendor/phpstan/php-8-stubs/stubs/ext/standard/natsort.stub} ^�g} *#��� : vendor/phpstan/php-8-stubs/stubs/ext/standard/settype.stub= ^�g= ��� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/file.stub� ^�g� ���K� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/is_nan.stub- ^�g- #"� H vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_bucket_prepend.stub� ^�g� �q�m� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/array_values.stubT ^�gT ���� = vendor/phpstan/php-8-stubs/stubs/ext/standard/array_walk.stub� ^�g� �Z��� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/chgrp.stubE ^�gE ��* � : vendor/phpstan/php-8-stubs/stubs/ext/standard/getmxrr.stub� ^�g� �~�ߤ > vendor/phpstan/php-8-stubs/stubs/ext/standard/array_merge.stub9 ^�g9 ��d� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/getmygid.stub* ^�g* �5� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/substr.stubU ^�gU �E#� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/decoct.stub- ^�g- �� +� F vendor/phpstan/php-8-stubs/stubs/ext/standard/sapi_windows_cp_set.stube ^�ge Nv�[� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/uksort.stub� ^�g� DĄ�� < vendor/phpstan/php-8-stubs/stubs/ext/standard/str_split.stubd ^�gd ���ͤ = vendor/phpstan/php-8-stubs/stubs/ext/standard/var_export.stubL ^�gL �k\}� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/chmod.stubK ^�gK �� � @ vendor/phpstan/php-8-stubs/stubs/ext/standard/ob_get_length.stub/ ^�g/ � ם� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/is_executable.stub: ^�g: H�p� J vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_set_write_buffer.stubd ^�gd �� E vendor/phpstan/php-8-stubs/stubs/ext/standard/net_get_interfaces.stub� ^�g� ��t1� : vendor/phpstan/php-8-stubs/stubs/ext/standard/scandir.stub� ^�g� ��:� : vendor/phpstan/php-8-stubs/stubs/ext/standard/is_link.stub4 ^�g4 ���� B vendor/phpstan/php-8-stubs/stubs/ext/standard/array_intersect.stubK ^�gK ��]� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/chroot.stubt ^�gt ��� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/similar_text.stubw ^�gw ��<� < vendor/phpstan/php-8-stubs/stubs/ext/standard/parse_url.stub� ^�g� �s�+� G vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_socket_client.stub1 ^�g1 �s�x� I vendor/phpstan/php-8-stubs/stubs/ext/standard/register_tick_function.stub\ ^�g\ �n (� : vendor/phpstan/php-8-stubs/stubs/ext/standard/implode.stubS ^�gS q?V� A vendor/phpstan/php-8-stubs/stubs/ext/standard/gethostbynamel.stubY ^�gY ���{� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/sqrt.stub, ^�g, ����� B vendor/phpstan/php-8-stubs/stubs/ext/standard/password_verify.stubJ ^�gJ ��� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/strtok.stubP ^�gP �GL�� F vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_set_blocking.stubd ^�gd ���u� B vendor/phpstan/php-8-stubs/stubs/ext/standard/array_multisort.stub� ^�g� n�la� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/stripcslashes.stub: ^�g: �N_X� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/fseek.stubl ^�gl ����� G vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_socket_sendto.stub� ^�g� ��g�� D vendor/phpstan/php-8-stubs/stubs/ext/standard/ob_implicit_flush.stubA ^�gA �� = vendor/phpstan/php-8-stubs/stubs/ext/standard/shell_exec.stubC ^�gC ��W�� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/join.stubf ^�gf ��a)� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/dechex.stub- ^�g- �U� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/log1p.stub- ^�g- �`9� : vendor/phpstan/php-8-stubs/stubs/ext/standard/tempnam.stubM ^�gM >{�$� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/fdiv.stub: ^�g: �]�� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/getopt.stub� ^�g� ���� A vendor/phpstan/php-8-stubs/stubs/ext/standard/call_user_func.stubN ^�gN ���� < vendor/phpstan/php-8-stubs/stubs/ext/standard/is_string.stub2 ^�g2 x� 6 vendor/phpstan/php-8-stubs/stubs/ext/standard/tan.stub+ ^�g+ *>BZ� > vendor/phpstan/php-8-stubs/stubs/ext/standard/array_chunk.stub_ ^�g_ Z��Ǥ E vendor/phpstan/php-8-stubs/stubs/ext/standard/array_udiff_uassoc.stubi ^�gi BJ�Ӥ G vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_socket_accept.stub� ^�g� �(�_� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/arsort.stub� ^�g� ��D� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/hebrev.stubP ^�gP J=I� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/array_reduce.stuba ^�ga �A� B vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_is_local.stubY ^�gY I(Ѥ 6 vendor/phpstan/php-8-stubs/stubs/ext/standard/key.stub> ^�g> {�ܠ� C vendor/phpstan/php-8-stubs/stubs/ext/standard/get_include_path.stub5 ^�g5 h��a� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/decbin.stub- ^�g- �!K�� L vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_context_set_params.stub� ^�g� �9 <� C vendor/phpstan/php-8-stubs/stubs/ext/standard/convert_uuencode.stubN ^�gN ���~� J vendor/phpstan/php-8-stubs/stubs/ext/standard/sapi_windows_cp_is_utf8.stub4 ^�g4 V�Ћ� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/uasort.stub� ^�g� VnH�� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/fputs.stub� ^�g� '� r� A vendor/phpstan/php-8-stubs/stubs/ext/standard/error_get_last.stubD ^�gD U1̤ C vendor/phpstan/php-8-stubs/stubs/ext/standard/htmlspecialchars.stub� ^�g� �W֤ @ vendor/phpstan/php-8-stubs/stubs/ext/standard/number_format.stub� ^�g� �4�� C vendor/phpstan/php-8-stubs/stubs/ext/standard/is_uploaded_file.stub= ^�g= Էr2� I vendor/phpstan/php-8-stubs/stubs/ext/standard/array_intersect_uassoc.stubm ^�gm =:|� < vendor/phpstan/php-8-stubs/stubs/ext/standard/fdatasync.stub] ^�g] ��@�� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/fopen.stub� ^�g� ��� A vendor/phpstan/php-8-stubs/stubs/ext/standard/substr_compare.stub� ^�g� �ИG� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/fstat.stubb ^�gb h7� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/count.stubR ^�gR G�� � ? vendor/phpstan/php-8-stubs/stubs/ext/standard/stripslashes.stub9 ^�g9 ��m� > vendor/phpstan/php-8-stubs/stubs/ext/standard/is_infinite.stub2 ^�g2 �k�o� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/log10.stub- ^�g- n��ɤ : vendor/phpstan/php-8-stubs/stubs/ext/standard/readdir.stubf ^�gf ��97� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/intdiv.stub6 ^�g6 ]�aФ 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/asinh.stub- ^�g- ��ޤ < vendor/phpstan/php-8-stubs/stubs/ext/standard/getrusage.stubn ^�gn ���<� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_select.stubO ^�gO ��ݤ : vendor/phpstan/php-8-stubs/stubs/ext/standard/strrpos.stubZ ^�gZ G} � 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/hypot.stub5 ^�g5 �(4� B vendor/phpstan/php-8-stubs/stubs/ext/standard/proc_get_status.stubh ^�gh _l]� F vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_get_wrappers.stubH ^�gH ���!� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/pack.stubW ^�gW 1��ݤ = vendor/phpstan/php-8-stubs/stubs/ext/standard/checkdnsrr.stubk ^�gk �� < vendor/phpstan/php-8-stubs/stubs/ext/standard/filemtime.stub; ^�g; �S��� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/str_ireplace.stub� ^�g� Y�9� I vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_socket_shutdown.stuby ^�gy �"� � = vendor/phpstan/php-8-stubs/stubs/ext/standard/proc_close.stubN ^�gN ��מ� D vendor/phpstan/php-8-stubs/stubs/ext/standard/array_diff_uassoc.stubh ^�gh ����� C vendor/phpstan/php-8-stubs/stubs/ext/standard/time_sleep_until.stub= ^�g= h��E� < vendor/phpstan/php-8-stubs/stubs/ext/standard/fsockopen.stub� ^�g� /� A� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/str_ends_with.stubJ ^�gJ ��JO� = vendor/phpstan/php-8-stubs/stubs/ext/standard/strip_tags.stub_ ^�g_ ��f� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/rename.stubq ^�gq ��� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/hrtime.stuba ^�ga ��2 � 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/rtrim.stubX ^�gX t1�5� < vendor/phpstan/php-8-stubs/stubs/ext/standard/proc_open.stub ^�g �� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/diskfreespace.stub` ^�g` �k�K� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/flush.stub" ^�g" �E� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/sort.stub� ^�g� ( vY� H vendor/phpstan/php-8-stubs/stubs/ext/standard/array_merge_recursive.stubC ^�gC ��<� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/sleep.stub- ^�g- �3cL� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/realpath.stub9 ^�g9 /'~� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/round.stub ^�g p|mq� < vendor/phpstan/php-8-stubs/stubs/ext/standard/ftruncate.stubW ^�gW ӌӣ� : vendor/phpstan/php-8-stubs/stubs/ext/standard/phpinfo.stub� ^�g� �ߒ�� J vendor/phpstan/php-8-stubs/stubs/ext/standard/array_uintersect_uassoc.stubn ^�gn ���� J vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_wrapper_register.stub� ^�g� K$� = vendor/phpstan/php-8-stubs/stubs/ext/standard/array_fill.stubR ^�gR ��ˤ : vendor/phpstan/php-8-stubs/stubs/ext/standard/openlog.stub� ^�g� &�r`� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/array_filter.stuba ^�ga ����� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/md5_file.stubS ^�gS �&�ۤ ? vendor/phpstan/php-8-stubs/stubs/ext/standard/headers_sent.stub� ^�g� ��H� 6 vendor/phpstan/php-8-stubs/stubs/ext/standard/chr.stub0 ^�g0 �4n� : vendor/phpstan/php-8-stubs/stubs/ext/standard/ip2long.stub3 ^�g3 ��� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/substr_count.stubn ^�gn �H� J vendor/phpstan/php-8-stubs/stubs/ext/standard/quoted_printable_encode.stubD ^�gD 0� ,� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/chop.stubk ^�gk �� �� E vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_get_filters.stubG ^�gG 4, `� A vendor/phpstan/php-8-stubs/stubs/ext/standard/highlight_file.stubX ^�gX �H:�� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/crc32.stub= ^�g= �@� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/hexdec.stub: ^�g: AT� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/pclose.stubH ^�gH =t��� : vendor/phpstan/php-8-stubs/stubs/ext/standard/explode.stub� ^�g� Ҥ(M� B vendor/phpstan/php-8-stubs/stubs/ext/standard/ob_get_contents.stub4 ^�g4 p>R� E vendor/phpstan/php-8-stubs/stubs/ext/standard/request_parse_body.stub� ^�g� ��[+� H vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_filter_prepend.stub� ^�g� �)�� > vendor/phpstan/php-8-stubs/stubs/ext/standard/is_resource.stub4 ^�g4 �U� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/filesize.stub: ^�g: ���� < vendor/phpstan/php-8-stubs/stubs/ext/standard/array_map.stubZ ^�gZ Kc�ܤ @ vendor/phpstan/php-8-stubs/stubs/ext/standard/gethostbyname.stub< ^�g< �?N� H vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_copy_to_stream.stub� ^�g� ��?K� : vendor/phpstan/php-8-stubs/stubs/ext/standard/rad2deg.stub/ ^�g/ �dO-� > vendor/phpstan/php-8-stubs/stubs/ext/standard/utf8_decode.stub8 ^�g8 �{�,� > vendor/phpstan/php-8-stubs/stubs/ext/standard/count_chars.stubz ^�gz 7�n�� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/array_unique.stubP ^�gP |3J�� < vendor/phpstan/php-8-stubs/stubs/ext/standard/array_pop.stub4 ^�g4 �mߤ > vendor/phpstan/php-8-stubs/stubs/ext/standard/str_shuffle.stub8 ^�g8 7j�� I vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_wrapper_restore.stubC ^�gC �Ae�� A vendor/phpstan/php-8-stubs/stubs/ext/standard/proc_terminate.stube ^�ge �uO�� A vendor/phpstan/php-8-stubs/stubs/ext/standard/substr_replace.stub� ^�g� [[�� < vendor/phpstan/php-8-stubs/stubs/ext/standard/array_any.stubW ^�gW ��D� : vendor/phpstan/php-8-stubs/stubs/ext/standard/lcfirst.stub4 ^�g4 ,�� B vendor/phpstan/php-8-stubs/stubs/ext/standard/version_compare.stub ^�g Z5g�� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/stat.stubO ^�gO ,�`� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/getimagesize.stub� ^�g� ��� C vendor/phpstan/php-8-stubs/stubs/ext/standard/array_key_exists.stub] ^�g] �^2�� 6 vendor/phpstan/php-8-stubs/stubs/ext/standard/pow.stubG ^�gG \�4Ϥ E vendor/phpstan/php-8-stubs/stubs/ext/standard/connection_aborted.stub. ^�g. 7���� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/lstat.stubP ^�gP ����� = vendor/phpstan/php-8-stubs/stubs/ext/standard/key_exists.stubv ^�gv @)�;� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/get_meta_tags.stubx ^�gx ��Rp� > vendor/phpstan/php-8-stubs/stubs/ext/standard/array_udiff.stubb ^�gb ���K� < vendor/phpstan/php-8-stubs/stubs/ext/standard/doubleval.stubJ ^�gJ g�(�� E vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_socket_pair.stub� ^�g� Xy� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/sha1.stubT ^�gT �� ¤ E vendor/phpstan/php-8-stubs/stubs/ext/standard/http_response_code.stubI ^�gI y�g � E vendor/phpstan/php-8-stubs/stubs/ext/standard/html_entity_decode.stub ^�g R��{� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/readfile.stub� ^�g� ���� : vendor/phpstan/php-8-stubs/stubs/ext/standard/stripos.stubZ ^�gZ BSAѤ J vendor/phpstan/php-8-stubs/stubs/ext/standard/array_replace_recursive.stubY ^�gY �>Y� < vendor/phpstan/php-8-stubs/stubs/ext/standard/php_uname.stub: ^�g: ����� < vendor/phpstan/php-8-stubs/stubs/ext/standard/inet_ntop.stubU ^�gU �Yt٤ 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/strval.stub1 ^�g1 ���� : vendor/phpstan/php-8-stubs/stubs/ext/standard/opendir.stub� ^�g� �#`r� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/ob_get_clean.stub1 ^�g1 �z�դ > vendor/phpstan/php-8-stubs/stubs/ext/standard/nl_langinfo.stubN ^�gN �<n� B vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_get_line.stub| ^�g| ����� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/acosh.stub- ^�g- �3�� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/lchgrp.stubF ^�gF a;�� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/atan2.stub5 ^�g5 zA�� 6 vendor/phpstan/php-8-stubs/stubs/ext/standard/log.stub> ^�g> ��G�� > vendor/phpstan/php-8-stubs/stubs/ext/standard/get_headers.stub� ^�g� �CC� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/ob_get_level.stub( ^�g( y,�� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/ob_end_clean.stub) ^�g) "�?E� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/strrev.stub3 ^�g3 ��� A vendor/phpstan/php-8-stubs/stubs/ext/standard/sys_getloadavg.stubg ^�gg {�dv� A vendor/phpstan/php-8-stubs/stubs/ext/standard/str_word_count.stub� ^�g� �w}� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/getenv.stubv ^�gv �q �� < vendor/phpstan/php-8-stubs/stubs/ext/standard/array_pad.stubN ^�gN �{~ � ; vendor/phpstan/php-8-stubs/stubs/ext/standard/var_dump.stubO ^�gO �}�� F vendor/phpstan/php-8-stubs/stubs/ext/standard/sapi_windows_cp_get.stub@ ^�g@ ��9�� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/system.stubo ^�go 7қ� C vendor/phpstan/php-8-stubs/stubs/ext/standard/ob_list_handlers.stubE ^�gE DT e� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/rsort.stub� ^�g� 1>\E� : vendor/phpstan/php-8-stubs/stubs/ext/standard/vprintf.stub@ ^�g@ �^ A� = vendor/phpstan/php-8-stubs/stubs/ext/standard/is_integer.stubH ^�gH �� �� = vendor/phpstan/php-8-stubs/stubs/ext/standard/str_getcsv.stub� ^�g� :7 � @ vendor/phpstan/php-8-stubs/stubs/ext/standard/base64_decode.stubV ^�gV 5lQ� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/copy.stubo ^�go K�=� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/strptime.stub� ^�g� ��~� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/uniqid.stub| ^�g| =7�� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/unlink.stubi ^�gi �� Ȥ < vendor/phpstan/php-8-stubs/stubs/ext/standard/lcg_value.stub3 ^�g3 r�*� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/constant.stubJ ^�gJ k�,�� F vendor/phpstan/php-8-stubs/stubs/ext/standard/php_ini_loaded_file.stub8 ^�g8 �0 � : vendor/phpstan/php-8-stubs/stubs/ext/standard/is_long.stubE ^�gE H��� < vendor/phpstan/php-8-stubs/stubs/ext/standard/is_double.stubI ^�gI �� : vendor/phpstan/php-8-stubs/stubs/ext/standard/tmpfile.stub< ^�g< �?�� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/sscanf.stubs ^�gs ]��� = vendor/phpstan/php-8-stubs/stubs/ext/standard/strtolower.stub7 ^�g7 ���� G vendor/phpstan/php-8-stubs/stubs/ext/standard/php_strip_whitespace.stubC ^�gC ��%`� < vendor/phpstan/php-8-stubs/stubs/ext/standard/is_finite.stub0 ^�g0 ��Ar� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/fsync.stubY ^�gY + � � : vendor/phpstan/php-8-stubs/stubs/ext/standard/ini_get.stub: ^�g: ��� < vendor/phpstan/php-8-stubs/stubs/ext/standard/serialize.stub4 ^�g4 ��פ ; vendor/phpstan/php-8-stubs/stubs/ext/standard/linkinfo.stub6 ^�g6 ��ݍ� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/floatval.stub2 ^�g2 �2�� D vendor/phpstan/php-8-stubs/stubs/ext/standard/password_get_info.stubc ^�gc ��� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/ceil.stub0 ^�g0 R �>� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/strstr.stubh ^�gh �<�� 5 vendor/phpstan/php-8-stubs/stubs/ext/standard/pi.stub ^�g _loͤ 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/reset.stub7 ^�g7 ��?_� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/closelog.stube ^�ge I��� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/StreamBucket.stub ^�g "i7� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/array_is_list.stubG ^�gG �8� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/ob_clean.stub% ^�g% M��Ҥ : vendor/phpstan/php-8-stubs/stubs/ext/standard/fgetcsv.stub� ^�g� �(�'� M vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_context_get_options.stubx ^�gx ໄ�� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/strripos.stub[ ^�g[ ��Ҥ 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/header.stubp ^�gp 7^��� = vendor/phpstan/php-8-stubs/stubs/ext/standard/array_push.stubS ^�gS ^�;� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/acos.stub, ^�g, t� A vendor/phpstan/php-8-stubs/stubs/ext/standard/escapeshellarg.stub8 ^�g8 � �ܤ 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/ftell.stubM ^�gM T�4�� : vendor/phpstan/php-8-stubs/stubs/ext/standard/strcoll.stubJ ^�gJ ��0�� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_isatty.stubP ^�gP �k��� A vendor/phpstan/php-8-stubs/stubs/ext/standard/getprotobyname.stub_ ^�g_ q��� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/vsprintf.stubD ^�gD ?c�� G vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_filter_remove.stube ^�ge 8m%� : vendor/phpstan/php-8-stubs/stubs/ext/standard/strcspn.stubk ^�gk ��~� C vendor/phpstan/php-8-stubs/stubs/ext/standard/http_build_query.stub� ^�g� �� � : vendor/phpstan/php-8-stubs/stubs/ext/standard/compact.stub� ^�g� z��ؤ J vendor/phpstan/php-8-stubs/stubs/ext/standard/image_type_to_extension.stube ^�ge ��c�� I vendor/phpstan/php-8-stubs/stubs/ext/standard/output_add_rewrite_var.stubN ^�gN ]��4� J vendor/phpstan/php-8-stubs/stubs/ext/standard/htmlspecialchars_decode.stub� ^�g� ��+�� > vendor/phpstan/php-8-stubs/stubs/ext/standard/file_exists.stub8 ^�g8 ^��,� 6 vendor/phpstan/php-8-stubs/stubs/ext/standard/dir.stubs ^�gs �?�� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/trim.stubW ^�gW ���+� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/getmyuid.stub; ^�g; �4G � L vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_context_get_params.stubr ^�gr �t��� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/bindec.stub= ^�g= kXa� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/printf.stubB ^�gB �(� > vendor/phpstan/php-8-stubs/stubs/ext/standard/array_slice.stubt ^�gt �� I vendor/phpstan/php-8-stubs/stubs/ext/standard/array_uintersect_assoc.stubm ^�gm M)w�� C vendor/phpstan/php-8-stubs/stubs/ext/standard/highlight_string.stub� ^�g� �kb�� < vendor/phpstan/php-8-stubs/stubs/ext/standard/proc_nice.stubD ^�gD ���� = vendor/phpstan/php-8-stubs/stubs/ext/standard/phpcredits.stub� ^�g� �� 6 vendor/phpstan/php-8-stubs/stubs/ext/standard/cos.stub+ ^�g+ �YF*� H vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_set_chunk_size.stubi ^�gi ��@)� D vendor/phpstan/php-8-stubs/stubs/ext/standard/ignore_user_abort.stubA ^�gA ����� A vendor/phpstan/php-8-stubs/stubs/ext/standard/AssertionError.stub@ ^�g@ �6�¤ A vendor/phpstan/php-8-stubs/stubs/ext/standard/array_find_key.stub] ^�g] x�#�� L vendor/phpstan/php-8-stubs/stubs/ext/standard/output_reset_rewrite_vars.stub6 ^�g6 ��� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/asin.stub, ^�g, +�9� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/syslog.stub� ^�g� ���x� S vendor/phpstan/php-8-stubs/stubs/ext/standard/sapi_windows_generate_ctrl_event.stubU ^�gU `��� : vendor/phpstan/php-8-stubs/stubs/ext/standard/shuffle.stub} ^�g} ʓc~� > vendor/phpstan/php-8-stubs/stubs/ext/standard/is_iterable.stub4 ^�g4 8ŝ�� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/header_remove.stub> ^�g> �}��� < vendor/phpstan/php-8-stubs/stubs/ext/standard/iptcembed.stubm ^�gm �/�*� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/in_array.stubY ^�gY (1�ä S vendor/phpstan/php-8-stubs/stubs/ext/standard/http_clear_last_response_headers.stubN ^�gN A#�� : vendor/phpstan/php-8-stubs/stubs/ext/standard/boolval.stub0 ^�g0 #�A� E vendor/phpstan/php-8-stubs/stubs/ext/standard/socket_set_timeout.stub� ^�g� U�R� < vendor/phpstan/php-8-stubs/stubs/ext/standard/inet_pton.stubU ^�gU ɔ� � D vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_bucket_new.stub ^�g 6놞� < vendor/phpstan/php-8-stubs/stubs/ext/standard/fileinode.stub; ^�g; l6"M� D vendor/phpstan/php-8-stubs/stubs/ext/standard/array_udiff_assoc.stubh ^�gh ��Pj� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/headers_list.stubA ^�gA �gŤ @ vendor/phpstan/php-8-stubs/stubs/ext/standard/ob_get_status.stub[ ^�g[ ӁW&� < vendor/phpstan/php-8-stubs/stubs/ext/standard/error_log.stub� ^�g� -���� > vendor/phpstan/php-8-stubs/stubs/ext/standard/is_callable.stub� ^�g� ��(� < vendor/phpstan/php-8-stubs/stubs/ext/standard/quotemeta.stub6 ^�g6 ��V � ? vendor/phpstan/php-8-stubs/stubs/ext/standard/base_convert.stubT ^�gT Y!t�� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/chown.stubD ^�gD s��� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/strtr.stubZ ^�gZ <���� < vendor/phpstan/php-8-stubs/stubs/ext/standard/fpassthru.stubK ^�gK ����� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/unpack.stub� ^�g� S}T٤ 6 vendor/phpstan/php-8-stubs/stubs/ext/standard/end.stub5 ^�g5 ��e� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/passthru.stub� ^�g� O ^� < vendor/phpstan/php-8-stubs/stubs/ext/standard/fileatime.stubL ^�gL �|�� 6 vendor/phpstan/php-8-stubs/stubs/ext/standard/sin.stub+ ^�g+ �֊�� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/sinh.stub, ^�g, ��+.� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/array_combine.stubE ^�gE �c�`� E vendor/phpstan/php-8-stubs/stubs/ext/standard/realpath_cache_get.stubG ^�gG ֧ �� > vendor/phpstan/php-8-stubs/stubs/ext/standard/addcslashes.stubL ^�gL a�q� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/password_hash.stubh ^�gh ��4Y� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/fgets.stube ^�ge �π2� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/atan.stub, ^�g, ��ͤ F vendor/phpstan/php-8-stubs/stubs/ext/standard/socket_set_blocking.stub� ^�g� �@~� H vendor/phpstan/php-8-stubs/stubs/ext/standard/php_ini_scanned_files.stub: ^�g: W�e� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/link.stub= ^�g= ��� : vendor/phpstan/php-8-stubs/stubs/ext/standard/fprintf.stubk ^�gk �U� � : vendor/phpstan/php-8-stubs/stubs/ext/standard/deg2rad.stub/ ^�g/ C~�� > vendor/phpstan/php-8-stubs/stubs/ext/standard/get_cfg_var.stubD ^�gD A��� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/srand.stub� ^�g� v N�� H vendor/phpstan/php-8-stubs/stubs/ext/standard/password_needs_rehash.stubj ^�gj 7�O� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/RoundingMode.stub� ^�g� �t�� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/tanh.stub, ^�g, ��ש� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/vfprintf.stubi ^�gi �Aɤ J vendor/phpstan/php-8-stubs/stubs/ext/standard/memory_reset_peak_usage.stubE ^�gE �4?� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/php_sapi_name.stub2 ^�g2 ���Y� > vendor/phpstan/php-8-stubs/stubs/ext/standard/natcasesort.stub� ^�g� A��i� H vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_context_create.stubq ^�gq R�5R� F vendor/phpstan/php-8-stubs/stubs/ext/standard/forward_static_call.stubS ^�gS ����� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/strchr.stub} ^�g} ��F� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/ftok.stubf ^�gf /�'� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/fmod.stub: ^�g: "-� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/random_bytes.stubE ^�gE O� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/fwrite.stubq ^�gq ���� L vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_wrapper_unregister.stubF ^�gF �y� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/popen.stubW ^�gW �o�.� : vendor/phpstan/php-8-stubs/stubs/ext/standard/is_null.stub0 ^�g0 �E8�� < vendor/phpstan/php-8-stubs/stubs/ext/standard/Directory.stub� ^�g� t�w]� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/nl2br.stubJ ^�gJ ;WtB� B vendor/phpstan/php-8-stubs/stubs/ext/standard/array_diff_ukey.stubf ^�gf �7� � ; vendor/phpstan/php-8-stubs/stubs/ext/standard/readlink.stubv ^�gv HP��� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/array_unshift.stubH ^�gH b��`� I vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_socket_recvfrom.stub� ^�g� Uq5$� : vendor/phpstan/php-8-stubs/stubs/ext/standard/hex2bin.stub: ^�g: @Q\1� : vendor/phpstan/php-8-stubs/stubs/ext/standard/extract.stub| ^�g| ���f� M vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_context_set_default.stubW ^�gW �D � C vendor/phpstan/php-8-stubs/stubs/ext/standard/get_current_user.stub6 ^�g6 �R� : vendor/phpstan/php-8-stubs/stubs/ext/standard/mt_rand.stubI ^�gI �:� B vendor/phpstan/php-8-stubs/stubs/ext/standard/array_fill_keys.stubF ^�gF ��m�� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/krsort.stub� ^�g� �bK� K vendor/phpstan/php-8-stubs/stubs/ext/standard/header_register_callback.stubY ^�gY �q&� > vendor/phpstan/php-8-stubs/stubs/ext/standard/gethostname.stub[ ^�g[ 1)��� A vendor/phpstan/php-8-stubs/stubs/ext/standard/time_nanosleep.stuby ^�gy �0� < vendor/phpstan/php-8-stubs/stubs/ext/standard/sha1_file.stubT ^�gT dEW"� G vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_supports_lock.stubW ^�gW x �Ĥ 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/rmdir.stubi ^�gi pO#� G vendor/phpstan/php-8-stubs/stubs/ext/standard/array_walk_recursive.stub� ^�g� �c2� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/array_search.stubi ^�gi a� i� B vendor/phpstan/php-8-stubs/stubs/ext/standard/array_key_first.stubC ^�gC Hrʷ� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/chdir.stub3 ^�g3 {RQ� D vendor/phpstan/php-8-stubs/stubs/ext/standard/file_get_contents.stub� ^�g� �ј7� L vendor/phpstan/php-8-stubs/stubs/ext/standard/forward_static_call_array.stubV ^�gV �q;�� N vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_socket_enable_crypto.stub� ^�g� |�j"� A vendor/phpstan/php-8-stubs/stubs/ext/standard/clearstatcache.stubk ^�gk ��?� H vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_get_transports.stubJ ^�gJ ���Ǥ G vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_get_meta_data.stub\ ^�g\ �.>(� = vendor/phpstan/php-8-stubs/stubs/ext/standard/localeconv.stub? ^�g? {� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/strspn.stubj ^�gj �x�� = vendor/phpstan/php-8-stubs/stubs/ext/standard/addslashes.stub7 ^�g7 PYӛ� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/fpow.stubi ^�gi �v� M vendor/phpstan/php-8-stubs/stubs/ext/standard/register_shutdown_function.stub� ^�g� J��K� A vendor/phpstan/php-8-stubs/stubs/ext/standard/password_algos.stub, ^�g, פ 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/fread.stub] ^�g] �kO�� = vendor/phpstan/php-8-stubs/stubs/ext/standard/is_numeric.stub3 ^�g3 ��r�� E vendor/phpstan/php-8-stubs/stubs/ext/standard/array_count_values.stubi ^�gi r�Ze� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/intval.stub> ^�g> �Y� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/putenv.stubH ^�gH �+�V� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/cosh.stub, ^�g, g�e� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/fgetc.stubP ^�gP ̳kh� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/touch.stubi ^�gi �A� : vendor/phpstan/php-8-stubs/stubs/ext/standard/symlink.stub@ ^�g@ �/j� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/strpos.stubY ^�gY ��O?� > vendor/phpstan/php-8-stubs/stubs/ext/standard/ini_restore.stub6 ^�g6 ik� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/closedir.stub_ ^�g_ DyJ�� : vendor/phpstan/php-8-stubs/stubs/ext/standard/bin2hex.stubC ^�gC �Fۤ E vendor/phpstan/php-8-stubs/stubs/ext/standard/ini_parse_quantity.stubP ^�gP 3 �� < vendor/phpstan/php-8-stubs/stubs/ext/standard/fileperms.stub; ^�g; �F �� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/str_decrement.stubK ^�gK z�R�� C vendor/phpstan/php-8-stubs/stubs/ext/standard/memory_get_usage.stubD ^�gD E�N�� D vendor/phpstan/php-8-stubs/stubs/ext/standard/connection_status.stub- ^�g- n�� � : vendor/phpstan/php-8-stubs/stubs/ext/standard/soundex.stubD ^�gD +/�D� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/glob.stubo ^�go ���Ѥ 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/sizeof.stubg ^�gg D��� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/htmlentities.stub] ^�g] R�i~� G vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_filter_append.stub� ^�g� �;��� G vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_socket_server.stub- ^�g- g��Y� < vendor/phpstan/php-8-stubs/stubs/ext/standard/setcookie.stub� ^�g� N~��� A vendor/phpstan/php-8-stubs/stubs/ext/standard/assert_options.stubO ^�gO }��d� < vendor/phpstan/php-8-stubs/stubs/ext/standard/strnatcmp.stubE ^�gE h�L�� < vendor/phpstan/php-8-stubs/stubs/ext/standard/ini_alter.stub� ^�g� g}�٤ @ vendor/phpstan/php-8-stubs/stubs/ext/standard/gethostbyaddr.stubC ^�gC ��� D vendor/phpstan/php-8-stubs/stubs/ext/standard/file_put_contents.stub� ^�g� ����� C vendor/phpstan/php-8-stubs/stubs/ext/standard/getprotobynumber.stubc ^�gc ��� > vendor/phpstan/php-8-stubs/stubs/ext/standard/unserialize.stubJ ^�gJ ��ɒ� < vendor/phpstan/php-8-stubs/stubs/ext/standard/urldecode.stub6 ^�g6 q�v� : vendor/phpstan/php-8-stubs/stubs/ext/standard/current.stub8 ^�g8 �Nr� 6 vendor/phpstan/php-8-stubs/stubs/ext/standard/min.stub? ^�g? ��Ԥ 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/atanh.stub- ^�g- ��OY� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/umask.stub2 ^�g2 &� M� 6 vendor/phpstan/php-8-stubs/stubs/ext/standard/md5.stubR ^�gR ���)� : vendor/phpstan/php-8-stubs/stubs/ext/standard/gettype.stubF ^�gF �_�� G vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_bucket_append.stub� ^�g� k��� = vendor/phpstan/php-8-stubs/stubs/ext/standard/random_int.stub8 ^�g8 ��#s� 6 vendor/phpstan/php-8-stubs/stubs/ext/standard/max.stub? ^�g? ����� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/ob_end_flush.stub) ^�g) ���Ҥ ; vendor/phpstan/php-8-stubs/stubs/ext/standard/is_array.stub1 ^�g1 ��曤 > vendor/phpstan/php-8-stubs/stubs/ext/standard/str_replace.stub� ^�g� ���� J vendor/phpstan/php-8-stubs/stubs/ext/standard/image_type_to_mime_type.stubS ^�gS �1{Τ I vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_filter_register.stubU ^�gU -n�� L vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_context_set_option.stub� ^�g� �K� � 5 vendor/phpstan/php-8-stubs/stubs/ext/standard/dl.stub9 ^�g9 -U~�� < vendor/phpstan/php-8-stubs/stubs/ext/standard/array_sum.stub7 ^�g7 �̮�� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/usort.stub� ^�g� ���� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/is_int.stub/ ^�g/ �^�� A vendor/phpstan/php-8-stubs/stubs/ext/standard/get_debug_type.stub9 ^�g9 �1&D� C vendor/phpstan/php-8-stubs/stubs/ext/standard/error_clear_last.stub- ^�g- sq�8� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/basename.stubH ^�gH ]aפ = vendor/phpstan/php-8-stubs/stubs/ext/standard/array_flip.stuba ^�ga %菤 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/rand.stubF ^�gF � ��� > vendor/phpstan/php-8-stubs/stubs/ext/standard/utf8_encode.stub8 ^�g8 _�?� E vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_set_timeout.stub� ^�g� �iه� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/flock.stub� ^�g� )-&� B vendor/phpstan/php-8-stubs/stubs/ext/standard/config_get_hash.stubS ^�gS �V+� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/is_float.stub1 ^�g1 ��ʛ� C vendor/phpstan/php-8-stubs/stubs/ext/standard/array_uintersect.stubg ^�gg Vś� N vendor/phpstan/php-8-stubs/stubs/ext/readline/readline_callback_read_char.stub8 ^�g8 ~qe� I vendor/phpstan/php-8-stubs/stubs/ext/readline/readline_clear_history.stub3 ^�g3 $� T vendor/phpstan/php-8-stubs/stubs/ext/readline/readline_callback_handler_install.stub ^�g ��7#� E vendor/phpstan/php-8-stubs/stubs/ext/readline/readline_redisplay.stub/ ^�g/ ��''� H vendor/phpstan/php-8-stubs/stubs/ext/readline/readline_list_history.stubc ^�gc �%� ; vendor/phpstan/php-8-stubs/stubs/ext/readline/readline.stube ^�ge %��ؤ G vendor/phpstan/php-8-stubs/stubs/ext/readline/readline_add_history.stub? ^�g? fՁ�� S vendor/phpstan/php-8-stubs/stubs/ext/readline/readline_callback_handler_remove.stub= ^�g= ���y� I vendor/phpstan/php-8-stubs/stubs/ext/readline/readline_write_history.stubK ^�gK @�bR� H vendor/phpstan/php-8-stubs/stubs/ext/readline/readline_read_history.stubQ ^�gQ $7�Ф @ vendor/phpstan/php-8-stubs/stubs/ext/readline/readline_info.stub� ^�g� G��� O vendor/phpstan/php-8-stubs/stubs/ext/readline/readline_completion_function.stubK ^�gK qR�� G vendor/phpstan/php-8-stubs/stubs/ext/readline/readline_on_new_line.stubI ^�gI t�ȸ� = vendor/phpstan/php-8-stubs/stubs/ext/pdo_pgsql/Pdo/Pgsql.stub[ ^�g[ } 3$� A vendor/phpstan/php-8-stubs/stubs/ext/pdo_pgsql/PDO_PGSql_Ext.stubg ^�gg ���� 1 vendor/phpstan/php-8-stubs/stubs/ext/pdo/PDO.stubbZ ^�gbZ - 0�� 4 vendor/phpstan/php-8-stubs/stubs/ext/pdo/PDORow.stub ^�g Ӫ!2� : vendor/phpstan/php-8-stubs/stubs/ext/pdo/PDOException.stubZ ^�gZ ��4� 9 vendor/phpstan/php-8-stubs/stubs/ext/pdo/pdo_drivers.stub@ ^�g@ �C�� : vendor/phpstan/php-8-stubs/stubs/ext/pdo/PDOStatement.stubK ^�gK �xҤ 8 vendor/phpstan/php-8-stubs/stubs/ext/fileinfo/finfo.stub> ^�g> ��� ? vendor/phpstan/php-8-stubs/stubs/ext/fileinfo/finfo_buffer.stub� ^�g� 6 rH� = vendor/phpstan/php-8-stubs/stubs/ext/fileinfo/finfo_file.stub� ^�g� �vz�� > vendor/phpstan/php-8-stubs/stubs/ext/fileinfo/finfo_close.stub� ^�g� ޠ�8� D vendor/phpstan/php-8-stubs/stubs/ext/fileinfo/mime_content_type.stubk ^�gk �}.� = vendor/phpstan/php-8-stubs/stubs/ext/fileinfo/finfo_open.stub ^�g <*�� B vendor/phpstan/php-8-stubs/stubs/ext/fileinfo/finfo_set_flags.stub ^�g +�6%� C vendor/phpstan/php-8-stubs/stubs/ext/pdo_firebird/Pdo/Firebird.stub� ^�g� �A_g� : vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmpgetnext.stub� ^�g� ��3� I vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmp_set_oid_output_format.stub� ^�g� �:`M� 8 vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmp3_set.stub3 ^�g3 �x�� < vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmp3_getnext.stub ^�g Z�ݤ F vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmp_get_valueretrieval.stub3 ^�g3 K Z� C vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmp_set_quick_print.stub� ^�g� �{� > vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmp3_real_walk.stub ^�g �C`� 9 vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmp3_walk.stub ^�g �'|M� 7 vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmpwalk.stub� ^�g� R�S� 6 vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmpget.stub� ^�g� �Wޤ F vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmp_set_valueretrieval.stub� ^�g� ���ޤ 8 vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmp2_get.stub� ^�g� �K�� < vendor/phpstan/php-8-stubs/stubs/ext/snmp/SNMPException.stub9 ^�g9 �=w � B vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmp_set_enum_print.stub� ^�g� i ��� I vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmp_set_oid_numeric_print.stub� ^�g� �j�Τ > vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmp2_real_walk.stub� ^�g� }���� 6 vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmpset.stub� ^�g� ���� < vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmp_read_mib.stub: ^�g: n�U� 8 vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmp2_set.stub� ^�g� "��a� ; vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmprealwalk.stub� ^�g� h�Ƥ 8 vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmp3_get.stub ^�g -�!L� < vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmp2_getnext.stub� ^�g� D |� 9 vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmp2_walk.stub� ^�g� �uڤ : vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmpwalkoid.stub� ^�g� J�A̤ C vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmp_get_quick_print.stub1 ^�g1 �:� 3 vendor/phpstan/php-8-stubs/stubs/ext/snmp/SNMP.stub� ^�g� }|$� : vendor/phpstan/php-8-stubs/stubs/ext/hash/hash_update.stub� ^�g� d8�� 8 vendor/phpstan/php-8-stubs/stubs/ext/hash/hash_file.stub ^�g T��5� : vendor/phpstan/php-8-stubs/stubs/ext/hash/hash_equals.stubQ ^�gQ ݍ�� 8 vendor/phpstan/php-8-stubs/stubs/ext/hash/hash_init.stub� ^�g� ��P8� : vendor/phpstan/php-8-stubs/stubs/ext/hash/mhash_count.stub' ^�g' v � � : vendor/phpstan/php-8-stubs/stubs/ext/hash/hash_pbkdf2.stub_ ^�g_ D��Ѥ 8 vendor/phpstan/php-8-stubs/stubs/ext/hash/hash_copy.stubC ^�gC ��j� 8 vendor/phpstan/php-8-stubs/stubs/ext/hash/hash_hmac.stube ^�ge �Z饤 ? vendor/phpstan/php-8-stubs/stubs/ext/hash/mhash_keygen_s2k.stubk ^�gk ڣ� A vendor/phpstan/php-8-stubs/stubs/ext/hash/hash_update_stream.stub} ^�g} �W�Z� 9 vendor/phpstan/php-8-stubs/stubs/ext/hash/hash_final.stubT ^�gT +�i�� 4 vendor/phpstan/php-8-stubs/stubs/ext/hash/mhash.stubV ^�gV � `� 8 vendor/phpstan/php-8-stubs/stubs/ext/hash/hash_hkdf.stubx ^�gx ���� 9 vendor/phpstan/php-8-stubs/stubs/ext/hash/hash_algos.stubU ^�gU ���7� ? vendor/phpstan/php-8-stubs/stubs/ext/hash/hash_update_file.stub� ^�g� ��\�� B vendor/phpstan/php-8-stubs/stubs/ext/hash/mhash_get_hash_name.stubA ^�gA 3n� > vendor/phpstan/php-8-stubs/stubs/ext/hash/hash_hmac_algos.stubZ ^�gZ �MU� 3 vendor/phpstan/php-8-stubs/stubs/ext/hash/hash.stub* ^�g* ���N� C vendor/phpstan/php-8-stubs/stubs/ext/hash/mhash_get_block_size.stubS ^�gS x�� : vendor/phpstan/php-8-stubs/stubs/ext/hash/HashContext.stub ^�g ��� = vendor/phpstan/php-8-stubs/stubs/ext/hash/hash_hmac_file.stubt ^�gt m��� I vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_get_warnings.stubd ^�gd \�'� B vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_error_list.stubT ^�gT �6GQ� E vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_attr_get.stubW ^�gW �}>� 7 vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli.stub2 ^�g2 �a�q� J vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_get_server_version.stubC ^�gC "�� A vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_data_seek.stubP ^�gP �}�K� K vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_send_long_data.stubl ^�gl �r� D vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_get_warnings.stubO ^�gO ��|� C vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_change_user.stubt ^�gt <C�<� B vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_reset.stubE ^�gE o��Ϥ B vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_fetch.stubF ^�gF ���z� B vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_close.stub� ^�g� �x� E vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_num_rows.stubU ^�gU ��I�� I vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_release_savepoint.stubX ^�gX ��֮� @ vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_num_rows.stubH ^�gH �P��� J vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_character_set_name.stubF ^�gF �6ě� E vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_connect_error.stub4 ^�g4 x� B vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_num_fields.stubC ^�gC s�>� @ vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_sqlstate.stub< ^�g< A��4� ? vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_prepare.stub] ^�g] ��ڤ D vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_execute.stub� ^�g� &�2Ԥ E vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_sql_exception.stub� ^�g� �.�� ? vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_set_opt.stub� ^�g� ��=� > vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_report.stub� ^�g� pͦ�� E vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_warning_count.stub> ^�g> Y!�%� D vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_fetch_fields.stub^ ^�g^ ���� B vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_real_query.stubK ^�gK ��l� D vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_more_results.stub> ^�g> ��y� E vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_fetch_lengths.stube ^�ge �{ܧ� > vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_result.stub% ^�g% X� o� H vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_reap_async_query.stubq ^�gq �K� � C vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_set_charset.stubN ^�gN =�'6� ? vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_connect.stub� ^�g� �p�� D vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_real_connect.stub� ^�g� o�� F vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_insert_id.stubO ^�gO ��9� C vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_multi_query.stubL ^�gL R�� = vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_close.stub� ^�g� ��ޤ B vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_field_tell.stubC ^�gC ��`� > vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_commit.stub^ ^�g^ J���� E vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_affected_rows.stubE ^�gE ��� G vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_get_client_info.stubK ^�gK 2��ܤ = vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_query.stub} ^�g} �v�� B vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_autocommit.stubJ ^�gJ >6�� H vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_bind_result.stub\ ^�g\ ��f[� G vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_get_server_info.stubC ^�gC �6 � G vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_get_result.stubz ^�gz Z�}�� H vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_get_client_stats.stubL ^�gL ��� � ? vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_ssl_set.stubY ^�gY �OY�� L vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_get_connection_stats.stub~ ^�g~ v� D vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_fetch_object.stub� ^�g� 'U� C vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_field_count.stub< ^�g< �FGV� J vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_fetch_field_direct.stub` ^�g` ��g`� A vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_fetch_all.stub� ^�g� JD{E� G vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_get_links_stats.stubK ^�gK s@�-� ? vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_options.stubn ^�gn ���� < vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_kill.stubG ^�gG /BI� B vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_errno.stubD ^�gD �2v6� H vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_field_count.stubJ ^�gJ �K�� ? vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_warning.stub� ^�g� @`�<� G vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_bind_param.stubj ^�gj uX̬� < vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_init.stub1 ^�g1 xfέ� C vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_get_charset.stubG ^�gG ��wޤ H vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_param_count.stubJ ^�gJ ܌�F� L vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_result_metadata.stub_ ^�g_ 퀞٤ E vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_get_host_info.stubA ^�gA ���`� J vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_affected_rows.stubS ^�gS ���M� C vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_next_result.stub= ^�g= �Ol�� A vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_init.stubI ^�gI -1*�� G vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_error_list.stubb ^�gb Ig�� E vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_attr_set.stubd ^�gd ��[� < vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stat.stub> ^�g> ۑ� H vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_free_result.stubK ^�gK ��,� F vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_data_seek.stubV ^�gV Vq�T� A vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_savepoint.stubI ^�gI ��� C vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_fetch_assoc.stubh ^�gh [k��� > vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_driver.stubG ^�gG �Ai� I vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_more_results.stubl ^�gl #���� C vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_fetch_array.stub� ^�g� ��؇� C vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_fetch_field.stubM ^�gM � щ� D vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_prepare.stubV ^�gV ��`�� C vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_free_result.stubE ^�gE @� �� ? vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_refresh.stubE ^�gE ��٤ J vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_real_escape_string.stubV ^�gV <1�� B vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_error.stubG ^�gG }�*�� E vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_sqlstate.stubJ ^�gJ �}�K� A vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_insert_id.stubA ^�gA ƙs � < vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt.stub8 ^�g8 r�d� @ vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_rollback.stub` ^�g` ��� D vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_store_result.stub] ^�g] �q��� H vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_next_result.stubK ^�gK '�4�� E vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_escape_string.stuby ^�gy ��0�� B vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_use_result.stubL ^�gL �˞ � ? vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_execute.stub� ^�g� ��=c� = vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_debug.stub� ^�g� +�� E vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_execute_query.stub� ^�g� (i�ۤ D vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_fetch_column.stub ^�g ��^E� I vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_begin_transaction.stubi ^�gi �w�Ф A vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_select_db.stubM ^�gM �[� = vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_errno.stub6 ^�g6 ��깤 < vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_poll.stub� ^�g� ��e�� G vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_dump_debug_info.stubA ^�gA +�UG� E vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_connect_errno.stub0 ^�g0 S�>�� J vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_get_client_version.stub5 ^�g5 � DC� B vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_field_seek.stub� ^�g� ��l� < vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_ping.stub6 ^�g6 DF�v� A vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_thread_id.stub: ^�g: ��YX� F vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_get_proto_info.stub? ^�g? 0�!� A vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_fetch_row.stubf ^�gf �D�g� C vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_thread_safe.stub/ ^�g/ �G�Ĥ < vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_info.stub9 ^�g9 nm� = vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_error.stub9 ^�g9 H`�� I vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_store_result.stubL ^�gL 繽i� = vendor/phpstan/php-8-stubs/stubs/ext/pspell/pspell_check.stub� ^�g� ��8Ϥ G vendor/phpstan/php-8-stubs/stubs/ext/pspell/pspell_config_dict_dir.stub� ^�g� �tX�� H vendor/phpstan/php-8-stubs/stubs/ext/pspell/pspell_config_save_repl.stub� ^�g� �F� C vendor/phpstan/php-8-stubs/stubs/ext/pspell/pspell_config_mode.stub� ^�g� �A2a� I vendor/phpstan/php-8-stubs/stubs/ext/pspell/pspell_store_replacement.stub� ^�g� ���� D vendor/phpstan/php-8-stubs/stubs/ext/pspell/pspell_new_personal.stub| ^�g| ��p|� C vendor/phpstan/php-8-stubs/stubs/ext/pspell/pspell_config_repl.stub� ^�g� �S,� B vendor/phpstan/php-8-stubs/stubs/ext/pspell/PSpell/Dictionary.stuby ^�gy � S� > vendor/phpstan/php-8-stubs/stubs/ext/pspell/PSpell/Config.stubu ^�gu F�F� ; vendor/phpstan/php-8-stubs/stubs/ext/pspell/pspell_new.stubh ^�gh � �?� E vendor/phpstan/php-8-stubs/stubs/ext/pspell/pspell_config_create.stub, ^�g, ��(� B vendor/phpstan/php-8-stubs/stubs/ext/pspell/pspell_new_config.stub� ^�g� ���� G vendor/phpstan/php-8-stubs/stubs/ext/pspell/pspell_config_personal.stub� ^�g� �0 ۤ J vendor/phpstan/php-8-stubs/stubs/ext/pspell/pspell_config_runtogether.stub� ^�g� w��� E vendor/phpstan/php-8-stubs/stubs/ext/pspell/pspell_clear_session.stub� ^�g� o�Τ G vendor/phpstan/php-8-stubs/stubs/ext/pspell/pspell_config_data_dir.stub� ^�g� �j<_� E vendor/phpstan/php-8-stubs/stubs/ext/pspell/pspell_config_ignore.stub� ^�g� `�S � E vendor/phpstan/php-8-stubs/stubs/ext/pspell/pspell_save_wordlist.stub� ^�g� [WO�� F vendor/phpstan/php-8-stubs/stubs/ext/pspell/pspell_add_to_session.stub� ^�g� �(� ? vendor/phpstan/php-8-stubs/stubs/ext/pspell/pspell_suggest.stub ^�g |��� G vendor/phpstan/php-8-stubs/stubs/ext/pspell/pspell_add_to_personal.stub� ^�g� z&�y� : vendor/phpstan/php-8-stubs/stubs/ext/sysvmsg/msg_send.stub� ^�g� ,���� B vendor/phpstan/php-8-stubs/stubs/ext/sysvmsg/msg_remove_queue.stubE ^�gE ���� B vendor/phpstan/php-8-stubs/stubs/ext/sysvmsg/msg_queue_exists.stub5 ^�g5 z�l� @ vendor/phpstan/php-8-stubs/stubs/ext/sysvmsg/msg_stat_queue.stubJ ^�gJ ��~�� B vendor/phpstan/php-8-stubs/stubs/ext/sysvmsg/SysvMessageQueue.stubJ ^�gJ [�6M� = vendor/phpstan/php-8-stubs/stubs/ext/sysvmsg/msg_receive.stub" ^�g" s- � ? vendor/phpstan/php-8-stubs/stubs/ext/sysvmsg/msg_set_queue.stubO ^�gO ޕ�>� ? vendor/phpstan/php-8-stubs/stubs/ext/sysvmsg/msg_get_queue.stub^ ^�g^ �+u.� C vendor/phpstan/php-8-stubs/stubs/ext/pdo_sqlite/PDO_SQLite_Ext.stub� ^�g� �W � ? vendor/phpstan/php-8-stubs/stubs/ext/pdo_sqlite/Pdo/Sqlite.stubm ^�gm �� �� ; vendor/phpstan/php-8-stubs/stubs/ext/random/getrandmax.stubS ^�gS �~Rw� > vendor/phpstan/php-8-stubs/stubs/ext/random/mt_getrandmax.stub: ^�g: ��g� 9 vendor/phpstan/php-8-stubs/stubs/ext/random/mt_srand.stub� ^�g� d���� : vendor/phpstan/php-8-stubs/stubs/ext/random/lcg_value.stub8 ^�g8 ���� 6 vendor/phpstan/php-8-stubs/stubs/ext/random/srand.stub� ^�g� �6x<� = vendor/phpstan/php-8-stubs/stubs/ext/random/random_bytes.stubZ ^�gZ T�P � C vendor/phpstan/php-8-stubs/stubs/ext/random/Random/RandomError.stubn ^�gn �wY� > vendor/phpstan/php-8-stubs/stubs/ext/random/Random/Engine.stubh ^�gh �*� H vendor/phpstan/php-8-stubs/stubs/ext/random/Random/CryptoSafeEngine.stuba ^�ga ��?� H vendor/phpstan/php-8-stubs/stubs/ext/random/Random/IntervalBoundary.stubE ^�gE ���I� B vendor/phpstan/php-8-stubs/stubs/ext/random/Random/Randomizer.stub� ^�g� �e]� G vendor/phpstan/php-8-stubs/stubs/ext/random/Random/RandomException.stubv ^�gv a�� F vendor/phpstan/php-8-stubs/stubs/ext/random/Random/Engine/Mt19937.stub� ^�g� �� Q vendor/phpstan/php-8-stubs/stubs/ext/random/Random/Engine/Xoshiro256StarStar.stub" ^�g" n !� R vendor/phpstan/php-8-stubs/stubs/ext/random/Random/Engine/PcgOneseq128XslRr64.stub� ^�g� �|l!� E vendor/phpstan/php-8-stubs/stubs/ext/random/Random/Engine/Secure.stub ^�g ǥk� O vendor/phpstan/php-8-stubs/stubs/ext/random/Random/BrokenRandomEngineError.stub� ^�g� ��i� 8 vendor/phpstan/php-8-stubs/stubs/ext/random/mt_rand.stubZ ^�gZ ݐ�^� ; vendor/phpstan/php-8-stubs/stubs/ext/random/random_int.stubI ^�gI ��Y� 5 vendor/phpstan/php-8-stubs/stubs/ext/random/rand.stubW ^�gW 4!��� I vendor/phpstan/php-8-stubs/stubs/ext/simplexml/simplexml_load_string.stub� ^�g� �s,� D vendor/phpstan/php-8-stubs/stubs/ext/simplexml/SimpleXMLElement.stub� ^�g� ��� E vendor/phpstan/php-8-stubs/stubs/ext/simplexml/SimpleXMLIterator.stub= ^�g= �� G vendor/phpstan/php-8-stubs/stubs/ext/simplexml/simplexml_load_file.stub� ^�g� ��� H vendor/phpstan/php-8-stubs/stubs/ext/simplexml/simplexml_import_dom.stub# ^�g# �u�֤ = vendor/phpstan/php-8-stubs/stubs/ext/date/DateRangeError.stubb ^�gb �(u� D vendor/phpstan/php-8-stubs/stubs/ext/date/date_create_immutable.stub ^�g ��� H vendor/phpstan/php-8-stubs/stubs/ext/date/timezone_identifiers_list.stub� ^�g� ���� @ vendor/phpstan/php-8-stubs/stubs/ext/date/date_timezone_get.stubW ^�gW �� |� C vendor/phpstan/php-8-stubs/stubs/ext/date/timezone_version_get.stub3 ^�g3 a1nj� 3 vendor/phpstan/php-8-stubs/stubs/ext/date/date.stubI ^�gI ��Y�� C vendor/phpstan/php-8-stubs/stubs/ext/date/date_get_last_errors.stubO ^�gO ֩[�� C vendor/phpstan/php-8-stubs/stubs/ext/date/date_interval_format.stubX ^�gX �D� < vendor/phpstan/php-8-stubs/stubs/ext/date/DateException.stuba ^�ga �f� > vendor/phpstan/php-8-stubs/stubs/ext/date/DateObjectError.stubc ^�gc �G�\� L vendor/phpstan/php-8-stubs/stubs/ext/date/DateInvalidOperationException.stubu ^�gu +`�� J vendor/phpstan/php-8-stubs/stubs/ext/date/timezone_abbreviations_list.stubP ^�gP P�69� A vendor/phpstan/php-8-stubs/stubs/ext/date/date_timestamp_get.stubH ^�gH /�a=� : vendor/phpstan/php-8-stubs/stubs/ext/date/date_modify.stubV ^�gV {U� : vendor/phpstan/php-8-stubs/stubs/ext/date/date_create.stubl ^�gl /�� S vendor/phpstan/php-8-stubs/stubs/ext/date/DateMalformedIntervalStringException.stub| ^�g| o�ȗ� 9 vendor/phpstan/php-8-stubs/stubs/ext/date/gmstrftime.stubU ^�gU ~�_q� H vendor/phpstan/php-8-stubs/stubs/ext/date/date_default_timezone_set.stubH ^�gH `�e� G vendor/phpstan/php-8-stubs/stubs/ext/date/timezone_transitions_get.stub� ^�g� � �� 9 vendor/phpstan/php-8-stubs/stubs/ext/date/date_parse.stubO ^�gO %��-� K vendor/phpstan/php-8-stubs/stubs/ext/date/DateInvalidTimeZoneException.stubt ^�gt �~�M� ; vendor/phpstan/php-8-stubs/stubs/ext/date/DateTimeZone.stuba ^�ga �Ʋ� @ vendor/phpstan/php-8-stubs/stubs/ext/date/timezone_name_get.stubE ^�gE J�� 4 vendor/phpstan/php-8-stubs/stubs/ext/date/idate.stubM ^�gM 1�8� ; vendor/phpstan/php-8-stubs/stubs/ext/date/DateInterval.stub ^�g f�� F vendor/phpstan/php-8-stubs/stubs/ext/date/timezone_name_from_abbr.stubn ^�gn ���� 5 vendor/phpstan/php-8-stubs/stubs/ext/date/mktime.stub� ^�g� �qd� @ vendor/phpstan/php-8-stubs/stubs/ext/date/DateTimeInterface.stub� ^�g� �� < vendor/phpstan/php-8-stubs/stubs/ext/date/date_sun_info.stubs ^�gs &)�� < vendor/phpstan/php-8-stubs/stubs/ext/date/date_time_set.stub ^�g r��@� 6 vendor/phpstan/php-8-stubs/stubs/ext/date/getdate.stubR ^�gR ]Tp<� ; vendor/phpstan/php-8-stubs/stubs/ext/date/date_sunrise.stub� ^�g� ˠ�� K vendor/phpstan/php-8-stubs/stubs/ext/date/DateMalformedStringException.stubt ^�gt tk�w� < vendor/phpstan/php-8-stubs/stubs/ext/date/date_date_set.stuba ^�ga �i&� 7 vendor/phpstan/php-8-stubs/stubs/ext/date/date_add.stubT ^�gT 57f � 8 vendor/phpstan/php-8-stubs/stubs/ext/date/strtotime.stuby ^�gy �I�Ѥ 8 vendor/phpstan/php-8-stubs/stubs/ext/date/checkdate.stubE ^�gE ��&� 7 vendor/phpstan/php-8-stubs/stubs/ext/date/DateTime.stub ^�g ��Ҥ 7 vendor/phpstan/php-8-stubs/stubs/ext/date/date_sub.stubT ^�gT q}�� 3 vendor/phpstan/php-8-stubs/stubs/ext/date/time.stub ^�g e��� E vendor/phpstan/php-8-stubs/stubs/ext/date/date_parse_from_format.stubk ^�gk M�Yu� 8 vendor/phpstan/php-8-stubs/stubs/ext/date/date_diff.stub� ^�g� S�~�� 8 vendor/phpstan/php-8-stubs/stubs/ext/date/localtime.stubo ^�go #v�� D vendor/phpstan/php-8-stubs/stubs/ext/date/timezone_location_get.stube ^�ge :��¤ F vendor/phpstan/php-8-stubs/stubs/ext/date/date_create_from_format.stub� ^�g� 4 �� 7 vendor/phpstan/php-8-stubs/stubs/ext/date/gmmktime.stub� ^�g� �� 9 vendor/phpstan/php-8-stubs/stubs/ext/date/DatePeriod.stub� ^�g� @#�Z� > vendor/phpstan/php-8-stubs/stubs/ext/date/date_offset_get.stubE ^�gE �Z)�� H vendor/phpstan/php-8-stubs/stubs/ext/date/date_default_timezone_get.stub8 ^�g8 H�6� @ vendor/phpstan/php-8-stubs/stubs/ext/date/date_timezone_set.stub] ^�g] ���(� 8 vendor/phpstan/php-8-stubs/stubs/ext/date/DateError.stubY ^�gY �� A vendor/phpstan/php-8-stubs/stubs/ext/date/date_timestamp_set.stubU ^�gU %��=� 7 vendor/phpstan/php-8-stubs/stubs/ext/date/strftime.stubS ^�gS ���t� @ vendor/phpstan/php-8-stubs/stubs/ext/date/DateTimeImmutable.stub ^�g _�s1� 5 vendor/phpstan/php-8-stubs/stubs/ext/date/gmdate.stubK ^�gK e�� T vendor/phpstan/php-8-stubs/stubs/ext/date/date_interval_create_from_date_string.stuba ^�ga a׀ � P vendor/phpstan/php-8-stubs/stubs/ext/date/date_create_immutable_from_format.stub� ^�g� ���h� : vendor/phpstan/php-8-stubs/stubs/ext/date/date_format.stubT ^�gT q(%Ӥ : vendor/phpstan/php-8-stubs/stubs/ext/date/date_sunset.stub� ^�g� `�qg� < vendor/phpstan/php-8-stubs/stubs/ext/date/timezone_open.stubI ^�gI �.� Q vendor/phpstan/php-8-stubs/stubs/ext/date/DateMalformedPeriodStringException.stubz ^�gz �& T� ? vendor/phpstan/php-8-stubs/stubs/ext/date/date_isodate_set.stubm ^�gm �wl� B vendor/phpstan/php-8-stubs/stubs/ext/date/timezone_offset_get.stubb ^�gb � � = vendor/phpstan/php-8-stubs/stubs/ext/sysvsem/sem_acquire.stub] ^�g] ��g�� < vendor/phpstan/php-8-stubs/stubs/ext/sysvsem/sem_remove.stub@ ^�g@ ���!� = vendor/phpstan/php-8-stubs/stubs/ext/sysvsem/sem_release.stubA ^�gA $)�"� 9 vendor/phpstan/php-8-stubs/stubs/ext/sysvsem/sem_get.stub� ^�g� k� � ? vendor/phpstan/php-8-stubs/stubs/ext/sysvsem/SysvSemaphore.stubG ^�gG �|W�� = vendor/phpstan/php-8-stubs/stubs/ext/pdo_mysql/Pdo/Mysql.stub� ^�g� ��� 5 vendor/phpstan/php-8-stubs/stubs/ext/iconv/iconv.stubd ^�gd �zޱ� B vendor/phpstan/php-8-stubs/stubs/ext/iconv/iconv_set_encoding.stubM ^�gM �۱�� A vendor/phpstan/php-8-stubs/stubs/ext/iconv/iconv_mime_encode.stubr ^�gr x� �� < vendor/phpstan/php-8-stubs/stubs/ext/iconv/iconv_strlen.stubx ^�gx ���� B vendor/phpstan/php-8-stubs/stubs/ext/iconv/iconv_get_encoding.stubh ^�gh ���W� < vendor/phpstan/php-8-stubs/stubs/ext/iconv/iconv_strpos.stuby ^�gy �2h*� < vendor/phpstan/php-8-stubs/stubs/ext/iconv/iconv_substr.stub{ ^�g{ '��6� = vendor/phpstan/php-8-stubs/stubs/ext/iconv/iconv_strrpos.stubi ^�gi a2� A vendor/phpstan/php-8-stubs/stubs/ext/iconv/iconv_mime_decode.stubm ^�gm ��:� I vendor/phpstan/php-8-stubs/stubs/ext/iconv/iconv_mime_decode_headers.stub� ^�g� z\믤 = vendor/phpstan/php-8-stubs/stubs/ext/pcre/preg_match_all.stub� ^�g� �x�^� 9 vendor/phpstan/php-8-stubs/stubs/ext/pcre/preg_quote.stubO ^�gO ��-�� 9 vendor/phpstan/php-8-stubs/stubs/ext/pcre/preg_match.stub� ^�g� � �+� 8 vendor/phpstan/php-8-stubs/stubs/ext/pcre/preg_grep.stubZ ^�gZ ���� 9 vendor/phpstan/php-8-stubs/stubs/ext/pcre/preg_split.stub� ^�g� }�X� J vendor/phpstan/php-8-stubs/stubs/ext/pcre/preg_replace_callback_array.stub� ^�g� �?3� : vendor/phpstan/php-8-stubs/stubs/ext/pcre/preg_filter.stub� ^�g� `F�H� > vendor/phpstan/php-8-stubs/stubs/ext/pcre/preg_last_error.stub+ ^�g+ 9{j � B vendor/phpstan/php-8-stubs/stubs/ext/pcre/preg_last_error_msg.stub2 ^�g2 �t�K� ; vendor/phpstan/php-8-stubs/stubs/ext/pcre/preg_replace.stub� ^�g� ��<� D vendor/phpstan/php-8-stubs/stubs/ext/pcre/preg_replace_callback.stub� ^�g� ό�Ѥ ; vendor/phpstan/php-8-stubs/stubs/ext/exif/exif_tagname.stub] ^�g] J�)f� = vendor/phpstan/php-8-stubs/stubs/ext/exif/exif_imagetype.stub@ ^�g@ �vY� = vendor/phpstan/php-8-stubs/stubs/ext/exif/exif_thumbnail.stub� ^�g� �-)� = vendor/phpstan/php-8-stubs/stubs/ext/exif/exif_read_data.stub� ^�g� �~�&� ; vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_columns.stub� ^�g� D�l�� ? vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_foreignkeys.stub� ^�g� �?�� : vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_tables.stub� ^�g� ����� ? vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_primarykeys.stub5 ^�g5 !a��� C vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_tableprivileges.stub ^�g �H� ? vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_field_scale.stub� ^�g� b�V� K vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_connection_string_quote.stubW ^�gW ��A٤ < vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_rollback.stub� ^�g� �N �� D vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_procedurecolumns.stubC ^�gC ѳc�� > vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_autocommit.stubb ^�gb �(I�� R vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_connection_string_should_quote.stub\ ^�g\ �q� 9 vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_close.stub� ^�g� X`N � > vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_statistics.stubk ^�gk �f[�� ? vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_fetch_array.stub� ^�g� %��\� > vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_field_name.stub� ^�g� ��� > vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_procedures.stubi ^�gi 9�G,� ? vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_next_result.stub ^�g m�K�� > vendor/phpstan/php-8-stubs/stubs/ext/odbc/Odbc/Connection.stubq ^�gq �W�k� : vendor/phpstan/php-8-stubs/stubs/ext/odbc/Odbc/Result.stubm ^�gm ܕ>b� O vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_connection_string_is_quoted.stubs ^�gs Pip� > vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_field_type.stub� ^�g� Yi� < vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_num_rows.stub� ^�g� PȤ = vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_field_num.stub� ^�g� ��p�� 6 vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_do.stub ^�g ���� = vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_field_len.stub� ^�g� �^e� : vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_cursor.stub� ^�g� ��l�� ? vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_free_result.stub� ^�g� �x�D� = vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_close_all.stubM ^�gM �]j&� D vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_columnprivileges.stub_ ^�g_ �Q7� < vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_pconnect.stubh ^�gh �S�j� C vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_field_precision.stub ^�g �P�ؤ > vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_num_fields.stub� ^�g� �:}f� ; vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_binmode.stub� ^�g� 9V��� ? vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_data_source.stub� ^�g� �.� > vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_result_all.stub ^�g �l�z� = vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_setoption.stub ^�g �p1�� @ vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_fetch_object.stubF ^�gF �\�h� = vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_fetch_row.stub� ^�g� �)� 8 vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_exec.stub� ^�g� �Jڮ� : vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_result.stub� ^�g� n|� 9 vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_error.stub� ^�g� �{� � ? vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_gettypeinfo.stub� ^�g� Q �� ; vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_connect.stubf ^�gf ��� ; vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_prepare.stub� ^�g� ��㈤ ? vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_longreadlen.stub� ^�g� ���� < vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_errormsg.stub� ^�g� Oi�}� B vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_specialcolumns.stub� ^�g� g`g5� : vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_commit.stub� ^�g� |OC� ; vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_execute.stub� ^�g� �_e� > vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_fetch_into.stubK ^�gK �5�5� [ vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_aead_chacha20poly1305_keygen.stubI ^�gI <zJ�� U vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_kx_server_session_keys.stubx ^�gx % d� [ vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_core_ristretto255_scalar_sub.stubn ^�gn K��m� E vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_stream.stubZ ^�gZ �*'� e vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_pwhash_scryptsalsa208sha256_str_verify.stubo ^�go �0_�� _ vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_core_ristretto255_is_valid_point.stube ^�ge 18�� P vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_sign_seed_keypair.stubJ ^�gJ �y@�� ` vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_aead_chacha20poly1305_ietf_keygen.stubN ^�gN u���� V vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_stream_xchacha20_xor_ic.stub� ^�g� ��:8� J vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_generichash.stub� ^�g� ���פ b vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_core_ristretto255_scalar_complement.stubj ^�gj y� F� L vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_box_publickey.stubJ ^�gJ В�3� I vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_pwhash_str.stube ^�ge s� � ? vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_memzero.stub: ^�g: � �� T vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_aead_aes256gcm_keygen.stubB ^�gB T�E%� ^ vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_core_ristretto255_scalar_invert.stubf ^�gf �w�� > vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_memcmp.stubI ^�gI +H � O vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_shorthash_keygen.stub= ^�g= �]N̤ P vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_pwhash_str_verify.stubZ ^�gZ �9�� U vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_aead_aes256gcm_decrypt.stub� ^�g� �ཤ K vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_kx_secretkey.stubI ^�gI g�S}� b vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_secretstream_xchacha20poly1305_push.stub� ^�g� �a�u� S vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_sign_verify_detached.stubu ^�gu "�R� [ vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_scalarmult_ristretto255_base.stubc ^�gc -ُ~� b vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_aead_xchacha20poly1305_ietf_decrypt.stub� ^�g� h\L� g vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_secretstream_xchacha20poly1305_init_push.stub_ ^�g_ 7$m%� E vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_pwhash.stub� ^�g� �/�� g vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_box_keypair_from_secretkey_and_publickey.stub{ ^�g{ =�~Ƥ G vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_box_open.stubn ^�gn {A�� M vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_secretbox_open.stubo ^�go 0�7(� M vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_sign_publickey.stubK ^�gK |O� � P vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_generichash_final.stub{ ^�g{ ;�� U vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_aead_aegis128l_decrypt.stub� ^�g� �X᧤ N vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_scalarmult_base.stub� ^�g� YL�!� T vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_core_ristretto255_add.stub� ^�g� \�gۤ ^ vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_core_ristretto255_scalar_reduce.stubf ^�gf �D� � U vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_kx_client_session_keys.stubm ^�gm �#,� H vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_sign_open.stubf ^�gf ��Y\� ? vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_bin2hex.stub; ^�g; [,� ? vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_compare.stubJ ^�gJ (�gI� Z vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_pwhash_scryptsalsa208sha256.stub� ^�g� �o�� B vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_base642bin.stub\ ^�g\ �GΒ� J vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_auth_keygen.stub8 ^�g8 `@Q� \ vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_sign_ed25519_sk_to_curve25519.stub\ ^�g\ ��!,� K vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_kx_publickey.stubI ^�gI �7M[� [ vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_box_publickey_from_secretkey.stub[ ^�g[ `�ȧ� J vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_box_keypair.stub8 ^�g8 �dډ� = vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_unpad.stubJ ^�gJ ��� H vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_shorthash.stubY ^�gY xˁ� Z vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_aead_aes256gcm_is_available.stubh ^�gh <�� Z vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_core_ristretto255_from_hash.stubb ^�gb �ฤ [ vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_core_ristretto255_scalar_add.stubn ^�gn 3>�m� K vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_sign_keypair.stub9 ^�g9 ��ۥ� c vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_secretstream_xchacha20poly1305_rekey.stub] ^�g] 9�� L vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_stream_keygen.stub: ^�g: /s�פ N vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_kx_seed_keypair.stubH ^�gH �ƍr� V vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_pwhash_str_needs_rehash.stub� ^�g� q{WD� ^ vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_core_ristretto255_scalar_negate.stubf ^�gf U�Ĥ T vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_aead_aegis256_decrypt.stub� ^�g� ���� B vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_bin2base64.stubm ^�gm f��ߤ S vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_aead_aegis256_keygen.stubR ^�gR '0X�� O vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_box_seed_keypair.stubI ^�gI ]�M� \ vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_sign_ed25519_pk_to_curve25519.stub\ ^�g\ �A�� V vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_stream_xchacha20_keygen.stubU ^�gU ë� ^ vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_core_ristretto255_scalar_random.stub] ^�g] fz �� L vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_sign_detached.stub] ^�g] � U� g vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_secretstream_xchacha20poly1305_init_pull.stubp ^�gp "�n� @ vendor/phpstan/php-8-stubs/stubs/ext/sodium/SodiumException.stub4 ^�g4 ���\� H vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_secretbox.stuba ^�ga �n�� B vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_box.stub` ^�g` ��!� I vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_scalarmult.stubR ^�gR +�(� a vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_aead_xchacha20poly1305_ietf_keygen.stubO ^�gO ��6� V vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_scalarmult_ristretto255.stub� ^�g� Wh � R vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_kdf_derive_from_key.stub� ^�g� "a�Τ ? vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_hex2bin.stubP ^�gP $�54� O vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_generichash_init.stub| ^�g| UD8s� d vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_secretstream_xchacha20poly1305_keygen.stub� ^�g� ��� I vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_kdf_keygen.stub7 ^�g7 ��IǤ M vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_sign_secretkey.stubK ^�gK ���*� T vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_core_ristretto255_sub.stubg ^�gg �o:� I vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_stream_xor.stubb ^�gb [�� � ; vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_add.stubH ^�gH ���E� ; vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_pad.stubH ^�gH �ZO[� b vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_secretstream_xchacha20poly1305_pull.stub� ^�g� �l� U vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_aead_aes256gcm_encrypt.stub� ^�g� �r O vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_stream_xchacha20.stub� ^�g� ��z� W vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_core_ristretto255_random.stubV ^�gV ���z� h vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_sign_keypair_from_secretkey_and_publickey.stub| ^�g| ��2ڤ J vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_auth_verify.stub_ ^�g_ �W�#� T vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_aead_aegis256_encrypt.stub� ^�g� m�� L vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_box_secretkey.stubJ ^�gJ Q�� \ vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_sign_publickey_from_secretkey.stub\ ^�g\ (�� ^ vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_pwhash_scryptsalsa208sha256_str.stubz ^�gz g���� A vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_increment.stub< ^�g< �<Dޤ G vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_box_seal.stubX ^�gX 1Hˤ S vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_stream_xchacha20_xor.stub} ^�g} �kU�� \ vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_aead_chacha20poly1305_decrypt.stub� ^�g� y�'o� C vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_sign.stubT ^�gT ��;�� U vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_aead_aegis128l_encrypt.stub� ^�g� �ځ� \ vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_aead_chacha20poly1305_encrypt.stub� ^�g� 'v� a vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_aead_chacha20poly1305_ietf_decrypt.stub� ^�g� T�mӤ a vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_aead_chacha20poly1305_ietf_encrypt.stub� ^�g� ��J�� C vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_auth.stubT ^�gT �VȮ� I vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_kx_keypair.stub7 ^�g7 ;&��� L vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_box_seal_open.stubd ^�gd ��g� O vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_secretbox_keygen.stub= ^�g= �o� Q vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_generichash_keygen.stub? ^�g? ��<n� T vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_aead_aegis128l_keygen.stubS ^�gS M� �� b vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_aead_xchacha20poly1305_ietf_encrypt.stub� ^�g� �s� [ vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_core_ristretto255_scalar_mul.stubn ^�gn >� a� Q vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_generichash_update.stub� ^�g� �V�ˤ = vendor/phpstan/php-8-stubs/stubs/ext/zlib/InflateContext.stubH ^�gH �I�� ; vendor/phpstan/php-8-stubs/stubs/ext/zlib/deflate_init.stub\ ^�g\ �<� 8 vendor/phpstan/php-8-stubs/stubs/ext/zlib/gzinflate.stubO ^�gO �6ޤ 9 vendor/phpstan/php-8-stubs/stubs/ext/zlib/gzpassthru.stubd ^�gd �j�Ҥ 7 vendor/phpstan/php-8-stubs/stubs/ext/zlib/gzdecode.stubN ^�gN ]�x� C vendor/phpstan/php-8-stubs/stubs/ext/zlib/inflate_get_read_len.stubH ^�gH 8��� 9 vendor/phpstan/php-8-stubs/stubs/ext/zlib/gzcompress.stubs ^�gs e�ֆ� 6 vendor/phpstan/php-8-stubs/stubs/ext/zlib/gzclose.stub_ ^�g_ ��c� = vendor/phpstan/php-8-stubs/stubs/ext/zlib/DeflateContext.stub& ^�g& �Ǭ�� 4 vendor/phpstan/php-8-stubs/stubs/ext/zlib/gzeof.stub[ ^�g[ 9:l^� 5 vendor/phpstan/php-8-stubs/stubs/ext/zlib/gzopen.stubt ^�gt � 6� 8 vendor/phpstan/php-8-stubs/stubs/ext/zlib/gzdeflate.stubn ^�gn {e�q� A vendor/phpstan/php-8-stubs/stubs/ext/zlib/inflate_get_status.stubF ^�gF MsO� 5 vendor/phpstan/php-8-stubs/stubs/ext/zlib/gztell.stubb ^�gb ]��g� 7 vendor/phpstan/php-8-stubs/stubs/ext/zlib/gzencode.stubn ^�gn �D9~� : vendor/phpstan/php-8-stubs/stubs/ext/zlib/inflate_add.stuby ^�gy ��u� : vendor/phpstan/php-8-stubs/stubs/ext/zlib/zlib_decode.stubQ ^�gQ ���B� 5 vendor/phpstan/php-8-stubs/stubs/ext/zlib/gzgetc.stube ^�ge �Z� 5 vendor/phpstan/php-8-stubs/stubs/ext/zlib/gzputs.stub� ^�g� �d� 5 vendor/phpstan/php-8-stubs/stubs/ext/zlib/gzread.stubr ^�gr ����� C vendor/phpstan/php-8-stubs/stubs/ext/zlib/zlib_get_coding_type.stub9 ^�g9 s )� : vendor/phpstan/php-8-stubs/stubs/ext/zlib/zlib_encode.stub\ ^�g\ dI��� 5 vendor/phpstan/php-8-stubs/stubs/ext/zlib/gzgets.stubz ^�gz �El�� ; vendor/phpstan/php-8-stubs/stubs/ext/zlib/inflate_init.stub\ ^�g\ -��Ǥ 7 vendor/phpstan/php-8-stubs/stubs/ext/zlib/gzrewind.stub` ^�g` ~d]� ; vendor/phpstan/php-8-stubs/stubs/ext/zlib/ob_gzhandler.stubI ^�gI F0� 9 vendor/phpstan/php-8-stubs/stubs/ext/zlib/readgzfile.stubW ^�gW 1<3� : vendor/phpstan/php-8-stubs/stubs/ext/zlib/deflate_add.stuby ^�gy ��9� 6 vendor/phpstan/php-8-stubs/stubs/ext/zlib/gzwrite.stub� ^�g� D��� 5 vendor/phpstan/php-8-stubs/stubs/ext/zlib/gzfile.stubl ^�gl ۥ��� 5 vendor/phpstan/php-8-stubs/stubs/ext/zlib/gzseek.stub� ^�g� F��� ; vendor/phpstan/php-8-stubs/stubs/ext/zlib/gzuncompress.stubR ^�gR �;nx� = vendor/phpstan/php-8-stubs/stubs/ext/pdo_dblib/Pdo/Dblib.stubQ ^�gQ �M-u� D vendor/phpstan/php-8-stubs/stubs/ext/reflection/ReflectionFiber.stub� ^�g� ��� E vendor/phpstan/php-8-stubs/stubs/ext/reflection/PropertyHookType.stubg ^�gg �`פ ? vendor/phpstan/php-8-stubs/stubs/ext/reflection/Reflection.stub� ^�g� ����� L vendor/phpstan/php-8-stubs/stubs/ext/reflection/ReflectionClassConstant.stub. ^�g. I � � K vendor/phpstan/php-8-stubs/stubs/ext/reflection/ReflectionEnumUnitCase.stub~ ^�g~ �D�%� E vendor/phpstan/php-8-stubs/stubs/ext/reflection/ReflectionObject.stubw ^�gw ���� L vendor/phpstan/php-8-stubs/stubs/ext/reflection/ReflectionZendExtension.stub� ^�g� ��� O vendor/phpstan/php-8-stubs/stubs/ext/reflection/ReflectionFunctionAbstract.stub� ^�g� ��|Ҥ H vendor/phpstan/php-8-stubs/stubs/ext/reflection/ReflectionExtension.stub� ^�g� T1��� G vendor/phpstan/php-8-stubs/stubs/ext/reflection/ReflectionConstant.stub ^�g �$K� H vendor/phpstan/php-8-stubs/stubs/ext/reflection/ReflectionReference.stubb ^�gb ^��8� H vendor/phpstan/php-8-stubs/stubs/ext/reflection/ReflectionNamedType.stub ^�g L��Q� H vendor/phpstan/php-8-stubs/stubs/ext/reflection/ReflectionParameter.stub ^�g �Q*6� H vendor/phpstan/php-8-stubs/stubs/ext/reflection/ReflectionException.stubZ ^�gZ �&��� G vendor/phpstan/php-8-stubs/stubs/ext/reflection/ReflectionFunction.stub� ^�g� D��n� M vendor/phpstan/php-8-stubs/stubs/ext/reflection/ReflectionEnumBackedCase.stub� ^�g� ^��h� C vendor/phpstan/php-8-stubs/stubs/ext/reflection/ReflectionType.stub� ^�g� 9� C vendor/phpstan/php-8-stubs/stubs/ext/reflection/ReflectionEnum.stub4 ^�g4 q6�Ϥ H vendor/phpstan/php-8-stubs/stubs/ext/reflection/ReflectionGenerator.stub� ^�g� Q��� > vendor/phpstan/php-8-stubs/stubs/ext/reflection/Reflector.stub3 ^�g3 ����� D vendor/phpstan/php-8-stubs/stubs/ext/reflection/ReflectionClass.stubG$ ^�gG$ �Ҹդ O vendor/phpstan/php-8-stubs/stubs/ext/reflection/ReflectionIntersectionType.stub� ^�g� �o�Q� H vendor/phpstan/php-8-stubs/stubs/ext/reflection/ReflectionAttribute.stub� ^�g� :�� G vendor/phpstan/php-8-stubs/stubs/ext/reflection/ReflectionProperty.stub" ^�g" G�� H vendor/phpstan/php-8-stubs/stubs/ext/reflection/ReflectionUnionType.stubo ^�go ���� E vendor/phpstan/php-8-stubs/stubs/ext/reflection/ReflectionMethod.stub� ^�g� �6��� 9 vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_errno.stub9 ^�g9 � �� @ vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_setopt_array.stubQ ^�gQ x�gL� : vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_escape.stub� ^�g� ���� ? vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_multi_close.stubK ^�gK D�$)� 9 vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_close.stub: ^�g: �09q� B vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_multi_strerror.stubB ^�gB �� ? vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_multi_errno.stubJ ^�gJ �h� : vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_setopt.stubV ^�gV b��� B vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_share_strerror.stubB ^�gB m��2� 9 vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_error.stub< ^�g< >ti� : vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_upkeep.stub� ^�g� ��j� 9 vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_reset.stubA ^�gA u��L� ? vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_copy_handle.stubM ^�gM � �� 8 vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_exec.stubG ^�gG ��a�� > vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_multi_init.stub8 ^�g8 ��5Ƥ C vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_multi_info_read.stub� ^�g� �Ԃ� < vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_strerror.stub< ^�g< ó�q� > vendor/phpstan/php-8-stubs/stubs/ext/curl/CurlMultiHandle.stub' ^�g' `�f`� ; vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_version.stubG ^�gG �_F�� 9 vendor/phpstan/php-8-stubs/stubs/ext/curl/CurlHandle.stubD ^�gD � �� D vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_multi_add_handle.stubd ^�gd 8QA:� ? vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_share_close.stubK ^�gK >�n�� 8 vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_init.stubF ^�gF B4��� > vendor/phpstan/php-8-stubs/stubs/ext/curl/CurlShareHandle.stub' ^�g' 4\4�� 9 vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_pause.stubv ^�gv � i;� @ vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_multi_select.stuba ^�ga `x�� < vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_unescape.stubU ^�gU �� @ vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_multi_setopt.stubg ^�gg ��}ˤ ? vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_share_errno.stubJ ^�gJ �� u� G vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_multi_remove_handle.stubg ^�gg ��m� > vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_multi_exec.stub{ ^�g{ I�J� ; vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_getinfo.stubR ^�gR 3���� ? vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_file_create.stub~ ^�g~ 1�$j� = vendor/phpstan/php-8-stubs/stubs/ext/curl/CURLStringFile.stub� ^�g� '��V� > vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_share_init.stub8 ^�g8 Z�Hɤ 7 vendor/phpstan/php-8-stubs/stubs/ext/curl/CURLFile.stub ^�g n�7B� @ vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_share_setopt.stubg ^�gg ���� D vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_multi_getcontent.stubH ^�gH �8� : vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_lo_read.stub� ^�g� dO �� D vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_setclientencoding.stub� ^�g� |��� ? vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_connect_poll.stub� ^�g� 34�� ? vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_send_execute.stub ^�g ��R� > vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_last_notice.stub ^�g �WnX� F vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_set_client_encoding.stub) ^�g) �H�)� 9 vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_delete.stub[ ^�g[ H�_%� B vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_client_encoding.stub� ^�g� 9� � ? vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_query_params.stub� ^�g� ��F� < vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_copy_from.stubd ^�gd d�Sf� > vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_result_seek.stub� ^�g� Ƽ�I� < vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_fieldsize.stub ^�g 8�bx� 9 vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_loread.stub" ^�g" B� p� 9 vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_select.stub� ^�g� ]KJ� : vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_lo_tell.stub� ^�g� �N��� A vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_escape_literal.stub@ ^�g@ ��yȤ = vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_field_name.stub� ^�g� ��a� ; vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_loimport.stub ^�g `� � ? vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_escape_bytea.stub0 ^�g0 Wm�I� @ vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_consume_input.stub� ^�g� �Ee� B vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_change_password.stub� ^�g� -9�[� > vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_fieldprtlen.stub� ^�g� � ʤ : vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_options.stub� ^�g� wfS� F vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_set_error_verbosity.stub+ ^�g+ �#��� : vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_connect.stub ^�g ��� B vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_connection_busy.stub� ^�g� �Q��� < vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_cmdtuples.stub ^�g ;� � : vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_numrows.stub� ^�g� ��x� ; vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_fieldnum.stub ^�g �ogǤ ? vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_send_prepare.stub ^�g \*��� ? vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_put_copy_end.stubp ^�gp �ܳפ = vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_field_type.stub� ^�g� D1� � D vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_connection_status.stub� ^�g� �y�;� 8 vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_query.stubC ^�gC >�[� 9 vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_loopen.stub� ^�g� �o�<� D vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_send_query_params.stub ^�g 7�/�� = vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_freeresult.stub ^�g �ע� < vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_lo_unlink.stub- ^�g- [VNg� : vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_convert.stube ^�ge %˯ � > vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_fetch_array.stubY ^�gY �myƤ ; vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_locreate.stub� ^�g� ��:"� @ vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_result_status.stub ^�g 4J� = vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_send_query.stub� ^�g� ��kl� ? vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_field_prtlen.stub� ^�g� �'4�� ; vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_lo_close.stub� ^�g� �Y%$� C vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_parameter_status.stub@ ^�g@ ϧ�ݤ : vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_prepare.stubw ^�gw �t� ; vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_lo_write.stub� ^�g� � u� A vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_unescape_bytea.stub> ^�g> �} T� ? vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_fetch_object.stubi ^�gi p�,ؤ : vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_copy_to.stub� ^�g� �@�� 9 vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_dbname.stub� ^�g� �)^6� > vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_lo_truncate.stub� ^�g� �@I�� @ vendor/phpstan/php-8-stubs/stubs/ext/pgsql/PgSql/Connection.stubx ^�gx Z@ 1� < vendor/phpstan/php-8-stubs/stubs/ext/pgsql/PgSql/Result.stubt ^�gt K }�� 9 vendor/phpstan/php-8-stubs/stubs/ext/pgsql/PgSql/Lob.stubq ^�gq ��� ; vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_end_copy.stub� ^�g� ng�� 9 vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_socket.stub� ^�g� �Г�� : vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_lo_seek.stub� ^�g� W�� ? vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_result_error.stub� ^�g� �a�&� < vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_field_num.stub� ^�g� � 8,� : vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_version.stub ^�g � !�� ? vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_errormessage.stub0 ^�g0 �z� E vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_transaction_status.stub� ^�g� 3�� � A vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_field_type_oid.stub� ^�g� mRk� < vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_loreadall.stub� ^�g� e��4� O vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_set_error_context_visibility.stub� ^�g� z�뇤 < vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_fieldtype.stub ^�g ��v�� < vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_meta_data.stub[ ^�g[ ���� : vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_untrace.stub/ ^�g/ � A vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_clientencoding.stub> ^�g> �b�� @ vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_escape_string.stub2 ^�g2 �I� 9 vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_update.stuby ^�gy ����� > vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_lo_read_all.stub� ^�g� pH�@� 9 vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_insert.stubx ^�gx �1�(� 8 vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_flush.stub� ^�g� '[� ; vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_last_oid.stub� ^�g� S��b� 7 vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_host.stub� ^�g� ݤpm� ; vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_num_rows.stub� ^�g� }�h7� 7 vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_port.stub� ^�g� �� Ƥ ; vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_put_line.stub ^�g �Ƥ < vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_fetch_row.stubS ^�gS V�n�� < vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_fieldname.stub ^�g ���t� < vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_lo_create.stubh ^�gh 8�.� H vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_set_chunked_rows_size.stub� ^�g� j/� 6 vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_jit.stub� ^�g� f�� : vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_loclose.stub� ^�g� ę� 7 vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_ping.stub� ^�g� �G� 9 vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_result.stub� ^�g� �\�� @ vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_affected_rows.stub� ^�g� �h+� = vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_last_error.stub� ^�g� �A�D� C vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_connection_reset.stub� ^�g� �M�W� : vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_execute.stub� ^�g� ^w�� @ vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_put_copy_data.stubg ^�gg g��� > vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_free_result.stub� ^�g� ��D� > vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_fieldisnull.stub� ^�g� �y� � = vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_field_size.stub� ^�g� ��¤ : vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_get_pid.stub� ^�g� gr � ; vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_loexport.stub ^�g <��?� > vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_field_table.stub ^�g ��F� < vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_numfields.stub ^�g ��X� D vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_escape_identifier.stubF ^�gF ;�l^� : vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_lo_open.stub� ^�g� H�T� 7 vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_exec.stubX ^�gX ���R� ? vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_fetch_result.stub ^�g ��.� = vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_num_fields.stub� ^�g� ��� D vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_fetch_all_columns.stub ^�g ��E� = vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_get_notify.stub: ^�g: �%��� > vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_fetch_assoc.stub) ^�g) Dl灤 8 vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_trace.stub� ^�g� �%��� 6 vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_tty.stub� ^�g� M �ݤ 8 vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_close.stub) ^�g) jI� > vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_socket_poll.stub� ^�g� @�{�� = vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_getlastoid.stub ^�g { � @ vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_field_is_null.stub� ^�g� �6��� < vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_lo_import.stub� ^�g� ̮�� = vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_get_result.stub� ^�g� <�Y� < vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_fetch_all.stub ^�g �14�� ; vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_pconnect.stub� ^�g� B��Ĥ E vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_result_memory_size.stuby ^�gy ��ڤ ; vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_lounlink.stubw ^�gw � � ? vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_cancel_query.stub� ^�g� )�2T� < vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_lo_export.stub� ^�g� ���� : vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_lowrite.stub> ^�g> ITe� E vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_result_error_field.stub ^�g �~Z�� 9 vendor/phpstan/php-8-stubs/stubs/ext/gettext/gettext.stub5 ^�g5 R9ג� I vendor/phpstan/php-8-stubs/stubs/ext/gettext/bind_textdomain_codeset.stubC ^�gC E�މ� : vendor/phpstan/php-8-stubs/stubs/ext/gettext/ngettext.stubh ^�gh ��ٵ� ; vendor/phpstan/php-8-stubs/stubs/ext/gettext/dngettext.stub� ^�g� �O�� 3 vendor/phpstan/php-8-stubs/stubs/ext/gettext/_.stubE ^�gE hﳀ� < vendor/phpstan/php-8-stubs/stubs/ext/gettext/textdomain.stub� ^�g� �Ǖ� ; vendor/phpstan/php-8-stubs/stubs/ext/gettext/dcgettext.stubV ^�gV r-�T� < vendor/phpstan/php-8-stubs/stubs/ext/gettext/dcngettext.stub� ^�g� ����� : vendor/phpstan/php-8-stubs/stubs/ext/gettext/dgettext.stubF ^�gF �;�� @ vendor/phpstan/php-8-stubs/stubs/ext/gettext/bindtextdomain.stub� ^�g� ��h�� B vendor/phpstan/php-8-stubs/stubs/ext/json/json_last_error_msg.stub2 ^�g2 �� � ? vendor/phpstan/php-8-stubs/stubs/ext/json/JsonSerializable.stub� ^�g� a�H�� < vendor/phpstan/php-8-stubs/stubs/ext/json/json_validate.stubi ^�gi ���� < vendor/phpstan/php-8-stubs/stubs/ext/json/JsonException.stub2 ^�g2 P�'� > vendor/phpstan/php-8-stubs/stubs/ext/json/json_last_error.stub+ ^�g+ ߏ,Ӥ : vendor/phpstan/php-8-stubs/stubs/ext/json/json_encode.stub� ^�g� �x褤 : vendor/phpstan/php-8-stubs/stubs/ext/json/json_decode.stubr ^�gr h)� : vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_kill.stube ^�ge ��n1� < vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_setsid.stub; ^�g; ��:|� < vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_mkfifo.stub^ ^�g^ y��� ? vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_fpathconf.stub� ^�g� �<�&� < vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_getgid.stub/ ^�g/ fI�E� ; vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_uname.stubM ^�gM "hr�� = vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_seteuid.stubJ ^�gJ wp�p� = vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_setegid.stubK ^�gK ��rK� ; vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_times.stubF ^�gF �_�v� < vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_getuid.stub( ^�g( ��0�� @ vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_initgroups.stubc ^�gc �YW�� = vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_getppid.stub) ^�g) ���֤ < vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_setgid.stub6 ^�g6 h�t�� < vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_getpid.stub( ^�g( ���!� > vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_getgrnam.stubU ^�gU ��"y� = vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_ctermid.stubF ^�gF QoM� = vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_setpgid.stubW ^�gW ��%N� > vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_getpwnam.stubY ^�gY k8�P� ; vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_errno.stubJ ^�gJ ���Ǥ ? vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_getrlimit.stub ^�g +�� = vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_getpgid.stubR ^�gR �4e� = vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_getegid.stub) ^�g) �&D�� > vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_getgrgid.stubV ^�gV ��)�� > vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_getpwuid.stubU ^�gU �;ߖ� = vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_geteuid.stub) ^�g) Pޘ%� < vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_setuid.stub5 ^�g5 ��>� < vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_access.stubP ^�gP i �� = vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_getpgrp.stub0 ^�g0 x���� = vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_eaccess.stubo ^�go T�k'� D vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_get_last_error.stub7 ^�g7 C��7� ; vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_mknod.stub} ^�g} 4 � < vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_isatty.stube ^�ge �N�� > vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_strerror.stub< ^�g< ��.�� > vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_pathconf.stubm ^�gm �Lb+� > vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_getlogin.stubO ^�gO ^dH� < vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_getsid.stubW ^�gW �x�x� = vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_sysconf.stubM ^�gM ��X� < vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_getcwd.stub1 ^�g1 ��I[� ? vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_setrlimit.stubx ^�gx hp � = vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_ttyname.stubu ^�gu ���Q� ? vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_getgroups.stubg ^�gg ��fK� = vendor/phpstan/php-8-stubs/stubs/ext/sysvshm/shm_has_var.stubH ^�gH 9���� @ vendor/phpstan/php-8-stubs/stubs/ext/sysvshm/shm_remove_var.stubK ^�gK �)q� B vendor/phpstan/php-8-stubs/stubs/ext/sysvshm/SysvSharedMemory.stubJ ^�gJ I�_+� < vendor/phpstan/php-8-stubs/stubs/ext/sysvshm/shm_detach.stub= ^�g= :Pā� < vendor/phpstan/php-8-stubs/stubs/ext/sysvshm/shm_remove.stub= ^�g= B E� < vendor/phpstan/php-8-stubs/stubs/ext/sysvshm/shm_attach.stubn ^�gn I!� = vendor/phpstan/php-8-stubs/stubs/ext/sysvshm/shm_get_var.stubI ^�gI ���u� = vendor/phpstan/php-8-stubs/stubs/ext/sysvshm/shm_put_var.stubV ^�gV ¾� � C vendor/phpstan/php-8-stubs/stubs/ext/spl/RecursiveTreeIterator.stubV ^�gV 41�?� D vendor/phpstan/php-8-stubs/stubs/ext/spl/CallbackFilterIterator.stub� ^�g� � �� ; vendor/phpstan/php-8-stubs/stubs/ext/spl/EmptyIterator.stubj ^�gj Gځݤ F vendor/phpstan/php-8-stubs/stubs/ext/spl/InvalidArgumentException.stubS ^�gS �W�� 8 vendor/phpstan/php-8-stubs/stubs/ext/spl/class_uses.stub� ^�g� C��� 8 vendor/phpstan/php-8-stubs/stubs/ext/spl/SplMinHeap.stub� ^�g� �] �� > vendor/phpstan/php-8-stubs/stubs/ext/spl/MultipleIterator.stubi ^�gi cX䌤 F vendor/phpstan/php-8-stubs/stubs/ext/spl/UnexpectedValueException.stubU ^�gU � �h� > vendor/phpstan/php-8-stubs/stubs/ext/spl/NoRewindIterator.stub� ^�g� �Km�� D vendor/phpstan/php-8-stubs/stubs/ext/spl/BadMethodCallException.stub[ ^�g[ ���&� = vendor/phpstan/php-8-stubs/stubs/ext/spl/LengthException.stubJ ^�gJ 2��?� ? vendor/phpstan/php-8-stubs/stubs/ext/spl/DirectoryIterator.stub! ^�g! i�EC� D vendor/phpstan/php-8-stubs/stubs/ext/spl/RecursiveRegexIterator.stub� ^�g� �6�&� < vendor/phpstan/php-8-stubs/stubs/ext/spl/ParentIterator.stub7 ^�g7 ��ml� = vendor/phpstan/php-8-stubs/stubs/ext/spl/CachingIterator.stub� ^�g� ��� @ vendor/phpstan/php-8-stubs/stubs/ext/spl/UnderflowException.stubO ^�gO ��A�� ; vendor/phpstan/php-8-stubs/stubs/ext/spl/ArrayIterator.stub� ^�g� u�P� E vendor/phpstan/php-8-stubs/stubs/ext/spl/spl_autoload_extensions.stubU ^�gU c ��� < vendor/phpstan/php-8-stubs/stubs/ext/spl/LogicException.stubc ^�gc U�;� ? vendor/phpstan/php-8-stubs/stubs/ext/spl/SplTempFileObject.stub� ^�g� ��hv� E vendor/phpstan/php-8-stubs/stubs/ext/spl/RecursiveFilterIterator.stub� ^�g� � � : vendor/phpstan/php-8-stubs/stubs/ext/spl/GlobIterator.stubc ^�gc ���� < vendor/phpstan/php-8-stubs/stubs/ext/spl/FilterIterator.stub� ^�g� ��Ź� > vendor/phpstan/php-8-stubs/stubs/ext/spl/RuntimeException.stubF ^�gF �G�� D vendor/phpstan/php-8-stubs/stubs/ext/spl/RecursiveArrayIterator.stubq ^�gq Z)#ޤ ? vendor/phpstan/php-8-stubs/stubs/ext/spl/OverflowException.stubN ^�gN ���Ƥ 9 vendor/phpstan/php-8-stubs/stubs/ext/spl/SplFileInfo.stub� ^�g� ���Y� 6 vendor/phpstan/php-8-stubs/stubs/ext/spl/SplStack.stub7 ^�g7 >��� M vendor/phpstan/php-8-stubs/stubs/ext/spl/RecursiveCallbackFilterIterator.stub ^�g :ir&� ? vendor/phpstan/php-8-stubs/stubs/ext/spl/spl_autoload_call.stub; ^�g; {ń"� H vendor/phpstan/php-8-stubs/stubs/ext/spl/RecursiveDirectoryIterator.stub� ^�g� �t6� > vendor/phpstan/php-8-stubs/stubs/ext/spl/SplPriorityQueue.stub� ^�g� x��^� > vendor/phpstan/php-8-stubs/stubs/ext/spl/IteratorIterator.stub, ^�g, �h絤 < vendor/phpstan/php-8-stubs/stubs/ext/spl/iterator_count.stub� ^�g� S4�� 5 vendor/phpstan/php-8-stubs/stubs/ext/spl/SplHeap.stubZ ^�gZ 4Y`�� A vendor/phpstan/php-8-stubs/stubs/ext/spl/SplDoublyLinkedList.stubr ^�gr ��� 9 vendor/phpstan/php-8-stubs/stubs/ext/spl/spl_classes.stub@ ^�g@ �n;� F vendor/phpstan/php-8-stubs/stubs/ext/spl/BadFunctionCallException.stubS ^�gS 7}Ҥ 9 vendor/phpstan/php-8-stubs/stubs/ext/spl/SplObserver.stub� ^�g� �MƵ� ? vendor/phpstan/php-8-stubs/stubs/ext/spl/iterator_to_array.stub� ^�g� :6Yؤ ; vendor/phpstan/php-8-stubs/stubs/ext/spl/OuterIterator.stub� ^�g� = =� > vendor/phpstan/php-8-stubs/stubs/ext/spl/InfiniteIterator.stub� ^�g� 3VH� = vendor/phpstan/php-8-stubs/stubs/ext/spl/DomainException.stubJ ^�gJ �|HR� D vendor/phpstan/php-8-stubs/stubs/ext/spl/spl_autoload_functions.stub4 ^�g4 mp�i� < vendor/phpstan/php-8-stubs/stubs/ext/spl/RangeException.stubK ^�gK �7gͤ ; vendor/phpstan/php-8-stubs/stubs/ext/spl/RegexIterator.stub� ^�g� �1�� B vendor/phpstan/php-8-stubs/stubs/ext/spl/OutOfBoundsException.stubQ ^�gQ $ �"� F vendor/phpstan/php-8-stubs/stubs/ext/spl/RecursiveCachingIterator.stub� ^�g� ��)�� ? vendor/phpstan/php-8-stubs/stubs/ext/spl/RecursiveIterator.stub ^�g ���ۤ 8 vendor/phpstan/php-8-stubs/stubs/ext/spl/SplSubject.stubj ^�gj �r�Ϥ 9 vendor/phpstan/php-8-stubs/stubs/ext/spl/ArrayObject.stub] ^�g] ��_�� 6 vendor/phpstan/php-8-stubs/stubs/ext/spl/SplQueue.stub� ^�g� t�V�� : vendor/phpstan/php-8-stubs/stubs/ext/spl/spl_autoload.stubW ^�gW 5��=� ; vendor/phpstan/php-8-stubs/stubs/ext/spl/SplFixedArray.stub� ^�g� }1�m� ; vendor/phpstan/php-8-stubs/stubs/ext/spl/class_parents.stub� ^�g� �LwH� > vendor/phpstan/php-8-stubs/stubs/ext/spl/class_implements.stub� ^�g� qNl@� < vendor/phpstan/php-8-stubs/stubs/ext/spl/iterator_apply.stubi ^�gi ���� 8 vendor/phpstan/php-8-stubs/stubs/ext/spl/SplMaxHeap.stub� ^�g� C�0� = vendor/phpstan/php-8-stubs/stubs/ext/spl/spl_object_hash.stub< ^�g< x~��� A vendor/phpstan/php-8-stubs/stubs/ext/spl/OutOfRangeException.stubN ^�gN �"�8� ; vendor/phpstan/php-8-stubs/stubs/ext/spl/LimitIterator.stub� ^�g� ���� > vendor/phpstan/php-8-stubs/stubs/ext/spl/SeekableIterator.stub� ^�g� �֤ G vendor/phpstan/php-8-stubs/stubs/ext/spl/RecursiveIteratorIterator.stub� ^�g� _T�q� C vendor/phpstan/php-8-stubs/stubs/ext/spl/spl_autoload_register.stubw ^�gw �n�{� < vendor/phpstan/php-8-stubs/stubs/ext/spl/AppendIterator.stub� ^�g� YT��� ; vendor/phpstan/php-8-stubs/stubs/ext/spl/spl_object_id.stub7 ^�g7 [ 3� E vendor/phpstan/php-8-stubs/stubs/ext/spl/spl_autoload_unregister.stubF ^�gF ���W� ; vendor/phpstan/php-8-stubs/stubs/ext/spl/SplFileObject.stub� ^�g� �� z� > vendor/phpstan/php-8-stubs/stubs/ext/spl/SplObjectStorage.stubX ^�gX ��ɤ @ vendor/phpstan/php-8-stubs/stubs/ext/spl/FilesystemIterator.stubI ^�gI �$� : vendor/phpstan/php-8-stubs/stubs/ext/shmop/shmop_read.stubN ^�gN �R Τ : vendor/phpstan/php-8-stubs/stubs/ext/shmop/shmop_size.stub3 ^�g3 ���� ; vendor/phpstan/php-8-stubs/stubs/ext/shmop/shmop_write.stubO ^�gO ME&� < vendor/phpstan/php-8-stubs/stubs/ext/shmop/shmop_delete.stub6 ^�g6 ���[� : vendor/phpstan/php-8-stubs/stubs/ext/shmop/shmop_open.stubb ^�gb ��:� ; vendor/phpstan/php-8-stubs/stubs/ext/shmop/shmop_close.stubH ^�gH 1e�%� 5 vendor/phpstan/php-8-stubs/stubs/ext/shmop/Shmop.stub? ^�g? �f+� = vendor/phpstan/php-8-stubs/stubs/ext/calendar/juliantojd.stubE ^�gE � �� = vendor/phpstan/php-8-stubs/stubs/ext/calendar/jewishtojd.stubE ^�gE �� D vendor/phpstan/php-8-stubs/stubs/ext/calendar/cal_days_in_month.stubs ^�gs V� @ vendor/phpstan/php-8-stubs/stubs/ext/calendar/jdtogregorian.stub; ^�g; �� � > vendor/phpstan/php-8-stubs/stubs/ext/calendar/jdmonthname.stubD ^�gD ��t�� > vendor/phpstan/php-8-stubs/stubs/ext/calendar/cal_from_jd.stub^ ^�g^ x�ա� ; vendor/phpstan/php-8-stubs/stubs/ext/calendar/cal_info.stubO ^�gO Vf��� > vendor/phpstan/php-8-stubs/stubs/ext/calendar/jddayofweek.stubX ^�gX b��� = vendor/phpstan/php-8-stubs/stubs/ext/calendar/jdtofrench.stub8 ^�g8 �d�V� > vendor/phpstan/php-8-stubs/stubs/ext/calendar/easter_days.stubX ^�gX �TX2� = vendor/phpstan/php-8-stubs/stubs/ext/calendar/jdtojulian.stub8 ^�g8 ��ݝ� = vendor/phpstan/php-8-stubs/stubs/ext/calendar/jdtojewish.stub^ ^�g^ zA��� ; vendor/phpstan/php-8-stubs/stubs/ext/calendar/jdtounix.stub3 ^�g3 �)&�� ; vendor/phpstan/php-8-stubs/stubs/ext/calendar/unixtojd.stub@ ^�g@ �bv�� = vendor/phpstan/php-8-stubs/stubs/ext/calendar/frenchtojd.stubE ^�gE � �� > vendor/phpstan/php-8-stubs/stubs/ext/calendar/easter_date.stubX ^�gX �M�� @ vendor/phpstan/php-8-stubs/stubs/ext/calendar/gregoriantojd.stubH ^�gH %g^�� < vendor/phpstan/php-8-stubs/stubs/ext/calendar/cal_to_jd.stubS ^�gS o�Y�� < vendor/phpstan/php-8-stubs/stubs/ext/phar/PharException.stubT ^�gT �v�O� 3 vendor/phpstan/php-8-stubs/stubs/ext/phar/Phar.stube+ ^�ge+ V��פ 7 vendor/phpstan/php-8-stubs/stubs/ext/phar/PharData.stub.( ^�g.( 2�T/� ; vendor/phpstan/php-8-stubs/stubs/ext/phar/PharFileInfo.stub� ^�g� !yi� B vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_next_attribute.stub ^�g 75\<� ? vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_mod_del_ext.stub9 ^�g9 ���� C vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_first_reference.stub ^�g �3>�� < vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_bind_ext.stub[ ^�g[ �̖�� A vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_count_entries.stub� ^�g� �7D�� B vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_get_attributes.stub; ^�g; \4�y� > vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_next_entry.stub ^�g $�9�� B vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_connect_wallet.stub� ^�g� �5D� C vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_parse_reference.stub� ^�g� H�Τ : vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_delete.stub� ^�g� p Q�� @ vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_modify_batch.stub/ ^�g/ g � > vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_set_option.stub1 ^�g1 h6M�� C vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_set_rebind_proc.stub� ^�g� ��f � ? vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_first_entry.stub ^�g �S� � ? vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_exop_passwd.stub� ^�g� ��%0� : vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_escape.stubc ^�gc D[Gt� C vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_first_attribute.stub ^�g ��6 � : vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_unbind.stub� ^�g� s�ɤ = vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_exop_sync.stubL ^�gL )�/ � ; vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_connect.stub� ^�g� ��Ť : vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_search.stubp ^�gp Z[Hդ B vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_next_reference.stub ^�g �my� > vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_get_option.stub1 ^�g1 � �0� @ vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_exop_refresh.stub) ^�g) ����� ; vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_mod_add.stub ^�g oQv � = vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_start_tls.stub� ^�g� �g� > vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_parse_exop.stub) ^�g) a"�� ; vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_add_ext.stub1 ^�g1 )��f� 9 vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_errno.stub� ^�g� ���;� 9 vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_close.stub� ^�g� �6j� ? vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_t61_to_8859.stubY ^�gY � � C vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_mod_replace_ext.stubA ^�gA �/ � 9 vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_error.stub� ^�g� lM�� ? vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_get_entries.stub> ^�g> �(|� ? vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_mod_replace.stub ^�g =q㧤 @ vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_parse_result.stub ^�g X�C�� ; vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_err2str.stub5 ^�g5 :3ސ� 8 vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_bind.stub� ^�g� ʸ� 8 vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_read.stubz ^�gz �~3� 7 vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_add.stub ^�g �b�S� > vendor/phpstan/php-8-stubs/stubs/ext/ldap/LDAP/Connection.stubw ^�gw ;ըѤ ? vendor/phpstan/php-8-stubs/stubs/ext/ldap/LDAP/ResultEntry.stubx ^�gx oq�(� : vendor/phpstan/php-8-stubs/stubs/ext/ldap/LDAP/Result.stubs ^�gs �A7=� > vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_explode_dn.stubf ^�gf �&"� ? vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_exop_whoami.stub� ^�g� *��� D vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_count_references.stub� ^�g� R'� > vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_get_values.stub� ^�g� D�`� ? vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_free_result.stub� ^�g� �M�[� > vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_rename_ext.stub� ^�g� 4le�� : vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_modify.stubG ^�gG ҙ8�� : vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_dn2ufn.stub: ^�g: b��Ť ? vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_8859_to_t61.stubB ^�gB �-A� 8 vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_exop.stub� ^�g� �ҝT� : vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_rename.stub� ^�g� ��;� ; vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_compare.stub; ^�g; �|?٤ 8 vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_list.stubl ^�gl e�%�� > vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_delete_ext.stub ^�g �~�w� ; vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_mod_del.stub ^�g �6�L� : vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_get_dn.stub� ^�g� �}�0� B vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_get_values_len.stubm ^�gm .)�ͤ = vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_sasl_bind.stub! ^�g! �й� ? vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_mod_add_ext.stub9 ^�g9 �}� K vendor/phpstan/php-8-stubs/stubs/ext/xml/xml_set_notation_decl_handler.stub� ^�g� �� 7 vendor/phpstan/php-8-stubs/stubs/ext/xml/XMLParser.stub! ^�g! �; A� > vendor/phpstan/php-8-stubs/stubs/ext/xml/xml_error_string.stub? ^�g? wK� H vendor/phpstan/php-8-stubs/stubs/ext/xml/xml_get_current_byte_index.stubH ^�gH qF� P vendor/phpstan/php-8-stubs/stubs/ext/xml/xml_set_end_namespace_decl_handler.stub� ^�g� Շ-{� Q vendor/phpstan/php-8-stubs/stubs/ext/xml/xml_set_external_entity_ref_handler.stub� ^�g� ���q� I vendor/phpstan/php-8-stubs/stubs/ext/xml/xml_get_current_line_number.stubI ^�gI �<� � ? vendor/phpstan/php-8-stubs/stubs/ext/xml/xml_parser_create.stubn ^�gn k�P� @ vendor/phpstan/php-8-stubs/stubs/ext/xml/xml_get_error_code.stub@ ^�g@ m��:� L vendor/phpstan/php-8-stubs/stubs/ext/xml/xml_set_character_data_handler.stub� ^�g� ��b� R vendor/phpstan/php-8-stubs/stubs/ext/xml/xml_set_unparsed_entity_decl_handler.stub� ^�g� ||�ߤ < vendor/phpstan/php-8-stubs/stubs/ext/xml/xml_set_object.stub� ^�g� j���� E vendor/phpstan/php-8-stubs/stubs/ext/xml/xml_set_element_handler.stub ^�g ��;a� = vendor/phpstan/php-8-stubs/stubs/ext/xml/xml_parser_free.stub> ^�g> �X9ޤ R vendor/phpstan/php-8-stubs/stubs/ext/xml/xml_set_start_namespace_decl_handler.stub� ^�g� � �"� C vendor/phpstan/php-8-stubs/stubs/ext/xml/xml_parser_get_option.stub� ^�g� �=�t� 7 vendor/phpstan/php-8-stubs/stubs/ext/xml/xml_parse.stub] ^�g] �N� E vendor/phpstan/php-8-stubs/stubs/ext/xml/xml_set_default_handler.stub{ ^�g{ �� C vendor/phpstan/php-8-stubs/stubs/ext/xml/xml_parse_into_struct.stube ^�ge �G�� K vendor/phpstan/php-8-stubs/stubs/ext/xml/xml_get_current_column_number.stubK ^�gK �VJ� T vendor/phpstan/php-8-stubs/stubs/ext/xml/xml_set_processing_instruction_handler.stub� ^�g� �{NQ� B vendor/phpstan/php-8-stubs/stubs/ext/xml/xml_parser_create_ns.stubh ^�gh ����� C vendor/phpstan/php-8-stubs/stubs/ext/xml/xml_parser_set_option.stub ^�g I\x�� @ vendor/phpstan/php-8-stubs/stubs/ext/session/session_encode.stub3 ^�g3 o�4� @ vendor/phpstan/php-8-stubs/stubs/ext/session/session_status.stub* ^�g* Qe��� < vendor/phpstan/php-8-stubs/stubs/ext/session/session_gc.stub, ^�g, ���� K vendor/phpstan/php-8-stubs/stubs/ext/session/session_get_cookie_params.stubN ^�gN :\a� > vendor/phpstan/php-8-stubs/stubs/ext/session/session_name.stubg ^�gg C;� A vendor/phpstan/php-8-stubs/stubs/ext/session/session_destroy.stub, ^�g, �N� @ vendor/phpstan/php-8-stubs/stubs/ext/session/session_decode.stub7 ^�g7 ��쭤 C vendor/phpstan/php-8-stubs/stubs/ext/session/session_save_path.stubJ ^�gJ .�Z� E vendor/phpstan/php-8-stubs/stubs/ext/session/session_write_close.stub0 ^�g0 �H8� F vendor/phpstan/php-8-stubs/stubs/ext/session/session_cache_expire.stubH ^�gH ���� I vendor/phpstan/php-8-stubs/stubs/ext/session/SessionHandlerInterface.stub� ^�g� �&)� @ vendor/phpstan/php-8-stubs/stubs/ext/session/SessionHandler.stub� ^�g� �� � @ vendor/phpstan/php-8-stubs/stubs/ext/session/session_commit.stubM ^�gM n =�� ? vendor/phpstan/php-8-stubs/stubs/ext/session/session_unset.stub* ^�g* P%� ? vendor/phpstan/php-8-stubs/stubs/ext/session/session_reset.stub* ^�g* �l� X vendor/phpstan/php-8-stubs/stubs/ext/session/SessionUpdateTimestampHandlerInterface.stub+ ^�g+ ��B�� G vendor/phpstan/php-8-stubs/stubs/ext/session/session_cache_limiter.stubO ^�gO ��V� D vendor/phpstan/php-8-stubs/stubs/ext/session/SessionIdInterface.stub� ^�g� bᣤ < vendor/phpstan/php-8-stubs/stubs/ext/session/session_id.stubA ^�gA ? vendor/phpstan/php-8-stubs/stubs/ext/session/session_abort.stub* ^�g* ]��Ĥ G vendor/phpstan/php-8-stubs/stubs/ext/session/session_regenerate_id.stubR ^�gR Mch� K vendor/phpstan/php-8-stubs/stubs/ext/session/session_set_cookie_params.stub� ^�g� ��4�� J vendor/phpstan/php-8-stubs/stubs/ext/session/session_set_save_handler.stub� ^�g� _��Ӥ K vendor/phpstan/php-8-stubs/stubs/ext/session/session_register_shutdown.stub6 ^�g6 ��KS� E vendor/phpstan/php-8-stubs/stubs/ext/session/session_module_name.stubN ^�gN r��Q� ? vendor/phpstan/php-8-stubs/stubs/ext/session/session_start.stub= ^�g= 1�T� C vendor/phpstan/php-8-stubs/stubs/ext/session/session_create_id.stubI ^�gI )i� 6 vendor/phpstan/php-8-stubs/stubs/ext/bcmath/bcsub.stubR ^�gR rjD� 6 vendor/phpstan/php-8-stubs/stubs/ext/bcmath/bcmul.stubR ^�gR f=��� 8 vendor/phpstan/php-8-stubs/stubs/ext/bcmath/bcfloor.stubU ^�gU ��� > vendor/phpstan/php-8-stubs/stubs/ext/bcmath/BcMath/Number.stub6 ^�g6 ��]�� 7 vendor/phpstan/php-8-stubs/stubs/ext/bcmath/bcceil.stubT ^�gT ��� � 6 vendor/phpstan/php-8-stubs/stubs/ext/bcmath/bcpow.stubU ^�gU z�ä 7 vendor/phpstan/php-8-stubs/stubs/ext/bcmath/bcsqrt.stubD ^�gD �=�M� 8 vendor/phpstan/php-8-stubs/stubs/ext/bcmath/bcscale.stub5 ^�g5 ��<� 6 vendor/phpstan/php-8-stubs/stubs/ext/bcmath/bcmod.stubR ^�gR 5��P� 7 vendor/phpstan/php-8-stubs/stubs/ext/bcmath/bccomp.stubP ^�gP t�� � 6 vendor/phpstan/php-8-stubs/stubs/ext/bcmath/bcadd.stubt ^�gt ˯� � 9 vendor/phpstan/php-8-stubs/stubs/ext/bcmath/bcdivmod.stub� ^�g� �c78� 9 vendor/phpstan/php-8-stubs/stubs/ext/bcmath/bcpowmod.stubi ^�gi "�?5� 8 vendor/phpstan/php-8-stubs/stubs/ext/bcmath/bcround.stub� ^�g� ���� 6 vendor/phpstan/php-8-stubs/stubs/ext/bcmath/bcdiv.stubR ^�gR � �� J vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_end_document.stubE ^�gE Fku� K vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_write_element.stubm ^�gm � � I vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_start_cdata.stubD ^�gD Q܋2� I vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_open_memory.stub> ^�g> ۽ �� L vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_end_dtd_entity.stubG ^�gG &m% � F vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_open_uri.stubh ^�gh �s�� H vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_set_indent.stubQ ^�gQ � bH� O vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_set_indent_string.stub_ ^�g_ _�p�� = vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/XMLWriter.stub: ^�g: TX � E vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_end_dtd.stub@ ^�g@ U��|� F vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_start_pi.stubQ ^�gQ �C��� K vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_start_element.stubT ^�gT �,�d� N vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_write_element_ns.stub� ^�g� ��#� K vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_start_comment.stubF ^�gF b�~o� K vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_write_comment.stubW ^�gW d� � P vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_write_attribute_ns.stub� ^�g� ���V� O vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_write_dtd_attlist.stubi ^�gi "h��� G vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_write_raw.stubS ^�gS �k�ˤ F vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_write_pi.stubb ^�gb �V�� G vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_write_dtd.stub� ^�g� ��o� G vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_end_cdata.stubB ^�gB ��W@� M vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_write_attribute.stube ^�ge ���Ϥ P vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_start_attribute_ns.stub~ ^�g~ ���z� M vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_start_attribute.stubV ^�gV +�$U� O vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_start_dtd_attlist.stubX ^�gX ��� K vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_output_memory.stub\ ^�g\ �<-5� L vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_start_document.stub� ^�g� .wӤ M vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_end_dtd_attlist.stubH ^�gH YJ.� I vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_end_element.stubD ^�gD � K vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_end_attribute.stubF ^�gF �� � N vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_start_dtd_entity.stubf ^�gf ��d�� N vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_start_element_ns.stub| ^�g| �ǚ>� N vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_write_dtd_entity.stub� ^�g� td+ʤ D vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_end_pi.stub? ^�g? C��0� C vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_flush.stubX ^�gX n�Ť I vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_write_cdata.stubU ^�gU �� � I vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_end_comment.stubD ^�gD �V M vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_end_dtd_element.stubH ^�gH JHz� B vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_text.stubN ^�gN R=kޤ N vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_full_end_element.stubI ^�gI � `\� G vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_start_dtd.stub� ^�g� �xN`� O vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_start_dtd_element.stuba ^�ga �&ht� O vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_write_dtd_element.stubi ^�gi �� � ; vendor/phpstan/php-8-stubs/stubs/ext/ffi/FFI/Exception.stub: ^�g: ڧ��� 7 vendor/phpstan/php-8-stubs/stubs/ext/ffi/FFI/CType.stubF+ ^�gF+ ��x� 7 vendor/phpstan/php-8-stubs/stubs/ext/ffi/FFI/CData.stub- ^�g- ���� A vendor/phpstan/php-8-stubs/stubs/ext/ffi/FFI/ParserException.stubN ^�gN 2q 0� 1 vendor/phpstan/php-8-stubs/stubs/ext/ffi/FFI.stub� ^�g� �Cg� 6 vendor/phpstan/php-8-stubs/stubs/ext/soap/SoapVar.stub� ^�g� T�|l� < vendor/phpstan/php-8-stubs/stubs/ext/soap/is_soap_fault.stub7 ^�g7 �ת*� 9 vendor/phpstan/php-8-stubs/stubs/ext/soap/SoapClient.stubB ^�gB �B<� 8 vendor/phpstan/php-8-stubs/stubs/ext/soap/SoapFault.stub ^�g ��1� 7 vendor/phpstan/php-8-stubs/stubs/ext/soap/Soap/Sdl.stubp ^�gp ��Wͤ 7 vendor/phpstan/php-8-stubs/stubs/ext/soap/Soap/Url.stubp ^�gp R{� 9 vendor/phpstan/php-8-stubs/stubs/ext/soap/SoapServer.stub& ^�g& �}Zn� 9 vendor/phpstan/php-8-stubs/stubs/ext/soap/SoapHeader.stub� ^�g� ��V� E vendor/phpstan/php-8-stubs/stubs/ext/soap/use_soap_error_handler.stubh ^�gh īd� 8 vendor/phpstan/php-8-stubs/stubs/ext/soap/SoapParam.stubb ^�gb �d>� 5 vendor/phpstan/php-8-stubs/stubs/ext/bz2/bzflush.stubf ^�gf ���� 5 vendor/phpstan/php-8-stubs/stubs/ext/bz2/bzerrno.stub� ^�g� ��-+� 4 vendor/phpstan/php-8-stubs/stubs/ext/bz2/bzopen.stub� ^�g� ��DӤ 8 vendor/phpstan/php-8-stubs/stubs/ext/bz2/bzcompress.stubd ^�gd ?Qmu� : vendor/phpstan/php-8-stubs/stubs/ext/bz2/bzdecompress.stub` ^�g` ��V� 5 vendor/phpstan/php-8-stubs/stubs/ext/bz2/bzwrite.stub� ^�g� 1�]� 5 vendor/phpstan/php-8-stubs/stubs/ext/bz2/bzclose.stubf ^�gf �\�m� 4 vendor/phpstan/php-8-stubs/stubs/ext/bz2/bzread.stub] ^�g] ѤC� 6 vendor/phpstan/php-8-stubs/stubs/ext/bz2/bzerrstr.stub� ^�g� W��Ǥ 5 vendor/phpstan/php-8-stubs/stubs/ext/bz2/bzerror.stub� ^�g� ��� ; vendor/phpstan/php-8-stubs/stubs/ext/ctype/ctype_cntrl.stub3 ^�g3 ���Ҥ ; vendor/phpstan/php-8-stubs/stubs/ext/ctype/ctype_alnum.stubU ^�gU =4c7� ; vendor/phpstan/php-8-stubs/stubs/ext/ctype/ctype_lower.stub3 ^�g3 ���̤ ; vendor/phpstan/php-8-stubs/stubs/ext/ctype/ctype_print.stub3 ^�g3 Ë�&� ; vendor/phpstan/php-8-stubs/stubs/ext/ctype/ctype_alpha.stub3 ^�g3 ���� ; vendor/phpstan/php-8-stubs/stubs/ext/ctype/ctype_graph.stub3 ^�g3 _�r�� ; vendor/phpstan/php-8-stubs/stubs/ext/ctype/ctype_digit.stub3 ^�g3 ��簤 ; vendor/phpstan/php-8-stubs/stubs/ext/ctype/ctype_space.stub3 ^�g3 ��6 � ; vendor/phpstan/php-8-stubs/stubs/ext/ctype/ctype_punct.stub3 ^�g3 !��^� ; vendor/phpstan/php-8-stubs/stubs/ext/ctype/ctype_upper.stub3 ^�g3 �mM� < vendor/phpstan/php-8-stubs/stubs/ext/ctype/ctype_xdigit.stub4 ^�g4 �u�� = vendor/phpstan/php-8-stubs/stubs/ext/xmlreader/XMLReader.stub�' ^�g�' t�=y� ; vendor/phpstan/php-8-stubs/stubs/ext/pdo_odbc/Pdo/Odbc.stubB ^�gB � j�� ; vendor/phpstan/php-8-stubs/stubs/ext/xsl/XSLTProcessor.stub� ^�g� _Y�� 8 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_setbit.stubP ^�gP +� � 6 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_root.stubC ^�gC F���� 6 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_init.stubC ^�gC '¿J� 9 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_hamdist.stubS ^�gS 0)�"� 5 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_add.stubP ^�gP �<� 4 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_or.stubO ^�gO N4� 8 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_import.stubw ^�gw [�Y�� : vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_popcount.stub< ^�g< =��5� 5 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_abs.stub8 ^�g8 ܕp�� 5 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_sub.stubP ^�gP �Ai�� 5 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_gcd.stubP ^�gP �6�� 7 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_scan0.stubF ^�gF H V� 8 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_intval.stub: ^�g: �Z�� 7 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_scan1.stubF ^�gF 6��� 8 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_clrbit.stub< ^�g< � -ؤ = vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_random_bits.stub5 ^�g5 ����� = vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_random_seed.stubA ^�gA �8� 7 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_div_q.stubw ^�gw �w�� > vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_random_range.stubW ^�gW �-�� 7 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_div_r.stubw ^�gw lo9?� ; vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_nextprime.stub> ^�g> �� 9 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_rootrem.stub^ ^�g^ s�e`� 6 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_sqrt.stub9 ^�g9 2�H�� < vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_prob_prime.stubU ^�gU ��Y� 8 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_jacobi.stubR ^�gR ��j� 6 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_powm.stubn ^�gn zR�� 6 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_sign.stub8 ^�g8 ��}�� 5 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_and.stubP ^�gP cmΒ� : vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_divexact.stubU ^�gU ���j� : vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_binomial.stubC ^�gC �� �� 6 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_fact.stub9 ^�g9 �B烤 ; vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_kronecker.stubU ^�gU �#¤ 8 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_export.stub� ^�g� t��� 5 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_div.stub� ^�g� �> }� 8 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_div_qr.stub� ^�g� � *� 5 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_neg.stub8 ^�g8 ��� 5 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_lcm.stubP ^�gP �Z�%� 8 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_invert.stubY ^�gY ^ �� 1 vendor/phpstan/php-8-stubs/stubs/ext/gmp/GMP.stub< ^�g< ��(� 5 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_mod.stubP ^�gP P�Z� 5 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_pow.stubG ^�gG ���� @ vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_perfect_square.stubC ^�gC eE*0� 8 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_strval.stubM ^�gM �O-�� ? vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_perfect_power.stubB ^�gB �IqΤ 9 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_testbit.stubH ^�gH aO�X� 9 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_sqrtrem.stubT ^�gT �^�� 5 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_xor.stubP ^�gP ɐm� : vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_legendre.stubT ^�gT ���N� 8 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_gcdext.stubk ^�gk ~�?0� 5 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_mul.stubP ^�gP �F�F� 5 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_com.stub8 ^�g8 S�Դ� 5 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_cmp.stubO ^�gO Ѓ�� > vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecolorclosest.stub] ^�g] x�p � 6 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagechar.stub� ^�g� �څ� ; vendor/phpstan/php-8-stubs/stubs/ext/gd/imagerectangle.stubj ^�gj ~C7� C vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecolorresolvealpha.stubn ^�gn 1�hV� 5 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagepng.stub� ^�g� XGC � : vendor/phpstan/php-8-stubs/stubs/ext/gd/imageloadfont.stub� ^�g� "t禤 ; vendor/phpstan/php-8-stubs/stubs/ext/gd/imageantialias.stubH ^�gH YT�� A vendor/phpstan/php-8-stubs/stubs/ext/gd/imagefilledrectangle.stubp ^�gp Vd�0� 4 vendor/phpstan/php-8-stubs/stubs/ext/gd/GdImage.stubA ^�gA _n ¤ > vendor/phpstan/php-8-stubs/stubs/ext/gd/imagefilltoborder.stubl ^�gl �yb� 6 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagewebp.stub� ^�g� %�b� > vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecreatefromgd.stubH ^�gH ��7r� @ vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecreatefromwbmp.stubQ ^�gQ � � 6 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagefill.stubQ ^�gQ d�� � B vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecreatefromstring.stubH ^�gH ��c�� ? vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecopymergegray.stub� ^�g� 0cX� ; vendor/phpstan/php-8-stubs/stubs/ext/gd/imageinterlace.stubP ^�gP ;�� ? vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecreatefromxbm.stubP ^�gP ��W� 6 vendor/phpstan/php-8-stubs/stubs/ext/gd/imageline.stube ^�ge ���x� : vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecolorset.stub ^�g \y�.� > vendor/phpstan/php-8-stubs/stubs/ext/gd/imagesetthickness.stubM ^�gM �݉� 9 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagedestroy.stub? ^�g? ݪ�� = vendor/phpstan/php-8-stubs/stubs/ext/gd/imagepalettecopy.stubI ^�gI ��\4� B vendor/phpstan/php-8-stubs/stubs/ext/gd/imagegetinterpolation.stub@ ^�g@ �W"u� : vendor/phpstan/php-8-stubs/stubs/ext/gd/imagestringup.stub ^�g E��� 5 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagearc.stub� ^�g� ]s�F� = vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecolorstotal.stub; ^�g; ��Fp� ; vendor/phpstan/php-8-stubs/stubs/ext/gd/imagefilledarc.stub� ^�g� � �/� < vendor/phpstan/php-8-stubs/stubs/ext/gd/imagegrabwindow.stubm ^�gm p���� D vendor/phpstan/php-8-stubs/stubs/ext/gd/imagetruecolortopalette.stubb ^�gb ��� : vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecropauto.stub� ^�g� ��-� 7 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagetypes.stub& ^�g& o �J� = vendor/phpstan/php-8-stubs/stubs/ext/gd/imageistruecolor.stub< ^�g< �@f� 5 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagexbm.stubm ^�gm �/n�� 9 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagettfbbox.stub� ^�g� �dQ� 8 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagefttext.stub� ^�g� �^ � 6 vendor/phpstan/php-8-stubs/stubs/ext/gd/imageflip.stub@ ^�g@ k-Z � = vendor/phpstan/php-8-stubs/stubs/ext/gd/imagelayereffect.stubI ^�gI f^�� 7 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagescale.stub~ ^�g~ F2|>� @ vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecolorsforindex.stubc ^�gc ��O?� ? vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecreatefromxpm.stub\ ^�g\ �:q�� : vendor/phpstan/php-8-stubs/stubs/ext/gd/imagesetpixel.stubU ^�gU BiW � 9 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagettftext.stub� ^�g� �*j� 6 vendor/phpstan/php-8-stubs/stubs/ext/gd/imageavif.stub� ^�g� J(a�� B vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecolortransparent.stubT ^�gT ���Ϥ 8 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagestring.stub� ^�g� �@� < vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecolormatch.stubN ^�gN �}LǤ A vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecolorexactalpha.stubl ^�gl ����� ? vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecreatefrombmp.stub\ ^�g\ �D�E� ? vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecreatefromgif.stubI ^�gI i�k7� 8 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecreate.stubI ^�gI �$��� C vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecreatefromgd2part.stubv ^�gv H��� 9 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagepolygon.stubu ^�gu �C��� A vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecreatetruecolor.stubR ^�gR ��ޤ C vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecolorclosestalpha.stubn ^�gn P��� B vendor/phpstan/php-8-stubs/stubs/ext/gd/imagesetinterpolation.stubc ^�gc $m��� 9 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagesettile.stubH ^�gH ���̤ 8 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagefilter.stub~ ^�g~ ��|&� 5 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagegd2.stub ^�g ��fa� 8 vendor/phpstan/php-8-stubs/stubs/ext/gd/imageaffine.stube ^�ge �� � @ vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecreatefromwebp.stube ^�ge Y �� 4 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagesy.stub2 ^�g2 iJ䫤 9 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecolorat.stubM ^�gM F&��� 9 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagegetclip.stubP ^�gP r�Bդ ? vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecopyresampled.stub� ^�g� u8�� 5 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagebmp.stub� ^�g� x��+� 3 vendor/phpstan/php-8-stubs/stubs/ext/gd/GdFont.stubb ^�gb ��+<� D vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecolorallocatealpha.stubu ^�gu �X�� 8 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecharup.stub� ^�g� ���ڤ 9 vendor/phpstan/php-8-stubs/stubs/ext/gd/imageellipse.stub{ ^�g{ ��:� 6 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagejpeg.stub� ^�g� Qf��� D vendor/phpstan/php-8-stubs/stubs/ext/gd/imageaffinematrixconcat.stubp ^�gp �I.4� ; vendor/phpstan/php-8-stubs/stubs/ext/gd/imagefontwidth.stub� ^�g� �d~Ҥ 4 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagesx.stub2 ^�g2 (QhŤ : vendor/phpstan/php-8-stubs/stubs/ext/gd/imagesetbrush.stubJ ^�gJ s>� D vendor/phpstan/php-8-stubs/stubs/ext/gd/imagepalettetotruecolor.stubC ^�gC �I� 6 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecopy.stub� ^�g� ���o� ? vendor/phpstan/php-8-stubs/stubs/ext/gd/imagealphablending.stubL ^�gL �c�� > vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecolorresolve.stub] ^�g] ��#ޤ = vendor/phpstan/php-8-stubs/stubs/ext/gd/imageconvolution.stubj ^�gj $��ݤ ? vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecreatefromtga.stubc ^�gc 6>�&� > vendor/phpstan/php-8-stubs/stubs/ext/gd/imagegammacorrect.stubf ^�gf �t�� ; vendor/phpstan/php-8-stubs/stubs/ext/gd/imagesavealpha.stubH ^�gH F�[�� ? vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecreatefromgd2.stubI ^�gI ���.� < vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecolorexact.stub[ ^�g[ ���� < vendor/phpstan/php-8-stubs/stubs/ext/gd/imagedashedline.stubk ^�gk V�?� A vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecolordeallocate.stubL ^�gL �Gڤ 6 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecrop.stubQ ^�gQ � �� < vendor/phpstan/php-8-stubs/stubs/ext/gd/imagefontheight.stub� ^�g� PjKK� 4 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagegd.stubI ^�gI �9�v� = vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecopyresized.stub� ^�g� �bKܤ 6 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagewbmp.stub� ^�g� U?��� < vendor/phpstan/php-8-stubs/stubs/ext/gd/imageresolution.stub� ^�g� )�� : vendor/phpstan/php-8-stubs/stubs/ext/gd/imagesetstyle.stubG ^�gG �]��� ? vendor/phpstan/php-8-stubs/stubs/ext/gd/imagefilledpolygon.stub{ ^�g{ )��E� A vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecolorclosesthwb.stub` ^�g` -�خ� = vendor/phpstan/php-8-stubs/stubs/ext/gd/imageopenpolygon.stuby ^�gy ޅL�� @ vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecreatefromavif.stub� ^�g� �K��� ? vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecreatefrompng.stubc ^�gc ���� ? vendor/phpstan/php-8-stubs/stubs/ext/gd/imagefilledellipse.stub� ^�g� �7!ܤ ? vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecolorallocate.stubd ^�gd �պ�� 5 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagegif.stubk ^�gk � 9 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagesetclip.stub\ ^�g\ ��� 8 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagerotate.stubU ^�gU �N�v� 8 vendor/phpstan/php-8-stubs/stubs/ext/gd/imageftbbox.stub� ^�g� ���M� 4 vendor/phpstan/php-8-stubs/stubs/ext/gd/gd_info.stub< ^�g< ՙG�� A vendor/phpstan/php-8-stubs/stubs/ext/gd/imageaffinematrixget.stub� ^�g� �{9� ; vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecopymerge.stub� ^�g� 2�\>� @ vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecreatefromjpeg.stub] ^�g] �x�� < vendor/phpstan/php-8-stubs/stubs/ext/gd/imagegrabscreen.stub6 ^�g6 c�O� R vendor/phpstan/php-8-stubs/stubs/ext/openssl/OpenSSLCertificateSigningRequest.stub8 ^�g8 w�mW� O vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_pkcs12_export_to_file.stub ^�g 4�b�� I vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_csr_get_subject.stub� ^�g� +�s� G vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_pkcs7_encrypt.stub ^�g h+ !� C vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_x509_free.stuba ^�ga .MIԤ D vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_x509_parse.stub� ^�g� �%� � I vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_private_encrypt.stub� ^�g� �Z� M vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_x509_export_to_file.stub� ^�g� C m� D vendor/phpstan/php-8-stubs/stubs/ext/openssl/OpenSSLCertificate.stubL ^�gL LYZ�� D vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_cms_verify.stub( ^�g( ���ۤ K vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_x509_checkpurpose.stub� ^�g� ����� G vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_get_publickey.stub� ^�g� ��U� H vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_public_encrypt.stub� ^�g� ���'� F vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_error_string.stub9 ^�g9 7�G1� M vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_random_pseudo_bytes.stub ^�g %Kp%� E vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_cms_decrypt.stub4 ^�g4 �Cz� E vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_spki_export.stubD ^�gD ]��Ȥ G vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_password_hash.stub� ^�g� �lz3� D vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_pkcs7_sign.stubD ^�gD �%�� B vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_csr_sign.stub� ^�g� ���ä E vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_spki_verify.stub< ^�g< �N� @ vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_pbkdf2.stub� ^�g� s�� E vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_pkey_export.stub� ^�g� �Oky� A vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_csr_new.stub� ^�g� a^A�� E vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_pkcs12_read.stub� ^�g� ��� P vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_x509_check_private_key.stub� ^�g� L�� J vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_x509_fingerprint.stub� ^�g� A�� A vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_decrypt.stub~ ^�g~ 8 � H vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_get_md_methods.stub` ^�g` I��� F vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_pkcs7_verify.stub ^�g ��դ D vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_csr_export.stub� ^�g� �i��� C vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_pkey_free.stub[ ^�g[ [j��� H vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_get_privatekey.stub� ^�g� Nd��� L vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_csr_get_public_key.stub� ^�g� O�XϤ F vendor/phpstan/php-8-stubs/stubs/ext/openssl/OpenSSLAsymmetricKey.stub, ^�g, {Ք�� > vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_open.stub� ^�g� 1̽t� G vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_pkcs7_decrypt.stub ^�g .�ͤ L vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_csr_export_to_file.stub� ^�g� ;�!s� E vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_cms_encrypt.stubV ^�gV ��0Τ M vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_pkey_export_to_file.stub� ^�g� �w�#� @ vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_digest.stubq ^�gq ~Ւ�� C vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_x509_read.stubj ^�gj b({e� L vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_get_cert_locations.stubO ^�gO �?� A vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_encrypt.stub� ^�g� l�S8� J vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_cipher_iv_length.stubM ^�gM ~� @ vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_verify.stub� ^�g� 8o� E vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_x509_verify.stub� ^�g� kM� I vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_private_decrypt.stub� ^�g� �{�� I vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_get_curve_names.stubj ^�gj �⡤ B vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_free_key.stubz ^�gz \҅� I vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_pkey_get_public.stub� ^�g� ��`� B vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_pkey_new.stubZ ^�gZ N�� E vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_pkey_derive.stub ^�g I�G� I vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_password_verify.stub� ^�g� B;�(� D vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_pkcs7_read.stubm ^�gm ��z� B vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_spki_new.stub� ^�g� ].�� L vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_get_cipher_methods.stubd ^�gd ��$� H vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_dh_compute_key.stubq ^�gq 6�� H vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_public_decrypt.stub� ^�g� ���� G vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_pkcs12_export.stub ^�g =I�W� J vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_pkey_get_private.stub� ^�g� ��*o� > vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_seal.stub� ^�g� ��K�� J vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_pkey_get_details.stubm ^�gm D��� B vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_cms_sign.stub] ^�g] Y�h8� B vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_cms_read.stubu ^�gu (��o� E vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_x509_export.stub� ^�g� [�� K vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_cipher_key_length.stub_ ^�g_ H�� > vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_sign.stub� ^�g� ���Ȥ O vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_spki_export_challenge.stubN ^�gN ���� 8 vendor/phpstan/php-8-stubs/stubs/ext/dba/dba_exists.stubK ^�gK �l � < vendor/phpstan/php-8-stubs/stubs/ext/dba/Dba/Connection.stubv ^�gv h�+�� 8 vendor/phpstan/php-8-stubs/stubs/ext/dba/dba_delete.stubK ^�gK mj�,� 7 vendor/phpstan/php-8-stubs/stubs/ext/dba/dba_close.stub� ^�g� ٻ��� 6 vendor/phpstan/php-8-stubs/stubs/ext/dba/dba_sync.stub� ^�g� �[�� 7 vendor/phpstan/php-8-stubs/stubs/ext/dba/dba_popen.stub� ^�g� �% ޤ : vendor/phpstan/php-8-stubs/stubs/ext/dba/dba_handlers.stubX ^�gX N�+b� 8 vendor/phpstan/php-8-stubs/stubs/ext/dba/dba_insert.stubx ^�gx 9#$�� 7 vendor/phpstan/php-8-stubs/stubs/ext/dba/dba_fetch.stub� ^�g� ��Iؤ 6 vendor/phpstan/php-8-stubs/stubs/ext/dba/dba_open.stubk ^�gk �f� : vendor/phpstan/php-8-stubs/stubs/ext/dba/dba_firstkey.stub� ^�g� ���� 9 vendor/phpstan/php-8-stubs/stubs/ext/dba/dba_nextkey.stub� ^�g� �T�̤ 9 vendor/phpstan/php-8-stubs/stubs/ext/dba/dba_replace.stub{ ^�g{ ��B� ; vendor/phpstan/php-8-stubs/stubs/ext/dba/dba_key_split.stubG ^�gG �P�� 6 vendor/phpstan/php-8-stubs/stubs/ext/dba/dba_list.stub& ^�g& �� : vendor/phpstan/php-8-stubs/stubs/ext/dba/dba_optimize.stub� ^�g� R��� < vendor/phpstan/php-8-stubs/stubs/ext/zip/zip_entry_name.stubr ^�gr ��ES� @ vendor/phpstan/php-8-stubs/stubs/ext/zip/zip_entry_filesize.stubs ^�gs y�r� F vendor/phpstan/php-8-stubs/stubs/ext/zip/zip_entry_compressedsize.stuby ^�gy �N� < vendor/phpstan/php-8-stubs/stubs/ext/zip/zip_entry_open.stub� ^�g� �Sy� 7 vendor/phpstan/php-8-stubs/stubs/ext/zip/zip_close.stubY ^�gY b��$� 6 vendor/phpstan/php-8-stubs/stubs/ext/zip/zip_read.stubl ^�gl �J�� I vendor/phpstan/php-8-stubs/stubs/ext/zip/zip_entry_compressionmethod.stub ^�g |�䆤 8 vendor/phpstan/php-8-stubs/stubs/ext/zip/ZipArchive.stub� ^�g� �� < vendor/phpstan/php-8-stubs/stubs/ext/zip/zip_entry_read.stub� ^�g� �/��� = vendor/phpstan/php-8-stubs/stubs/ext/zip/zip_entry_close.stubk ^�gk j��5� 6 vendor/phpstan/php-8-stubs/stubs/ext/zip/zip_open.stub� ^�g� �C�>� 9 vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_check.stub� ^�g� �?8� : vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_setacl.stub ^�g �9v� = vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_mail_copy.stub ^�g �t�� ; vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_is_open.stubP ^�gP ��z� B vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_listsubscribed.stub9 ^�g9 �?9:� = vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_fetchbody.stub ^�g �$� > vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_num_recent.stub� ^�g� E�67� < vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_listscan.stub ^�g !I�ۤ = vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_mail_move.stub ^�g �)Ԥ @ vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_getmailboxes.stub ^�g ��Ӥ > vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_bodystruct.stub ^�g � Z�� > vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_headerinfo.stubC ^�gC }V�@� : vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_errors.stub/ ^�g/ �r��� 8 vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_scan.stubO ^�gO ^BeM� B vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_mailboxmsginfo.stub� ^�g� 28�� ; vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_expunge.stub ^�g Ρ�� H vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_rfc822_parse_headers.stubp ^�gp �ó� A vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_utf8_to_mutf7.stub\ ^�g\ ��h� 7 vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_uid.stub� ^�g� �*�� A vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_deletemailbox.stub� ^�g� �*ɧ� B vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_fetchstructure.stub ^�g ��`� : vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_search.stub- ^�g- R-<j� ; vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_num_msg.stub� ^�g� b�1� = vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_get_quota.stubI ^�gI R�<� ? vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_listmailbox.stub3 ^�g3 h��k� 8 vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_mail.stub� ^�g� c�p|� 9 vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_msgno.stub� ^�g� ^7.� = vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_set_quota.stub� ^�g� �� �� = vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_subscribe.stub� ^�g� -�f�� : vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_base64.stub> ^�g> �T'� ; vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_timeout.stubQ ^�gQ ϔnФ A vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_mutf7_to_utf8.stubE ^�gE �:ܤ B vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_clearflag_full.stub� ^�g� �cڤ @ vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_setflag_full.stub� ^�g� q�hA� : vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_delete.stubr ^�gr ǖ{� 8 vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_body.stub� ^�g� ���� ? vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_unsubscribe.stub� ^�g� '�{J� ? vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_utf7_decode.stubC ^�gC ��b5� H vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_rfc822_parse_adrlist.stub_ ^�g_ ��c� F vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_mime_header_decode.stubP ^�gP plr� 8 vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_utf8.stubA ^�gA � t� > vendor/phpstan/php-8-stubs/stubs/ext/imap/IMAP/Connection.stubw ^�gw ̑^f� > vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_last_error.stub4 ^�g4 ��� 8 vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_lsub.stub� ^�g� � ݤ 8 vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_ping.stub� ^�g� I@�@� 8 vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_sort.stub} ^�g} �-?ܤ ? vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_scanmailbox.stub] ^�g] ?��� < vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_undelete.stubx ^�gx ��>$� B vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_fetch_overview.stub ^�g �+�� : vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_getacl.stub� ^�g� ��k� = vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_fetchtext.stub- ^�g- �er�� 8 vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_list.stub� ^�g� REȤ : vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_append.stubU ^�gU ��(^� 8 vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_open.stub� ^�g� �D�� A vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_createmailbox.stub� ^�g� # �%� : vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_status.stub ^�g (%2�� < vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_savebody.stubu ^�gu Q��p� : vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_qprint.stub> ^�g> ���� ? vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_utf7_encode.stub= ^�g= N� � ? vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_fetchheader.stub ^�g ��� : vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_alerts.stub/ ^�g/ ���� : vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_rename.stub ^�g � X֤ H vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_rfc822_write_address.stubq ^�gq �ٹ� A vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_getsubscribed.stub ^�g � 9 vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_close.stub- ^�g- J��]� @ vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_mail_compose.stubT ^�gT �0�� : vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_thread.stub� ^�g� v��W� A vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_get_quotaroot.stub� ^�g� �ž� A vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_renamemailbox.stub� ^�g� ��8P� : vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_create.stub ^�g �e6� ; vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_headers.stub� ^�g� a �� : vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_binary.stub> ^�g> �s� 8 vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_8bit.stub< ^�g< ��W� 6 vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_gc.stub ^�g !װ� = vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_fetchmime.stub ^�g �"��� : vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_reopen.stub ^�g 7:o�� K vendor/phpstan/php-8-stubs/stubs/ext/libxml/libxml_set_streams_context.stub_ ^�g_ p�u+� M vendor/phpstan/php-8-stubs/stubs/ext/libxml/libxml_disable_entity_loader.stub` ^�g` ���� < vendor/phpstan/php-8-stubs/stubs/ext/libxml/LibXMLError.stub? ^�g? ��� F vendor/phpstan/php-8-stubs/stubs/ext/libxml/libxml_get_last_error.stub@ ^�g@ ��)� R vendor/phpstan/php-8-stubs/stubs/ext/libxml/libxml_get_external_entity_loader.stubT ^�gT a�A� R vendor/phpstan/php-8-stubs/stubs/ext/libxml/libxml_set_external_entity_loader.stubZ ^�gZ f�rl� D vendor/phpstan/php-8-stubs/stubs/ext/libxml/libxml_clear_errors.stub0 ^�g0 '���� B vendor/phpstan/php-8-stubs/stubs/ext/libxml/libxml_get_errors.stub/ ^�g/ � �� K vendor/phpstan/php-8-stubs/stubs/ext/libxml/libxml_use_internal_errors.stubO ^�gO n�u8� = vendor/phpstan/php-8-stubs/stubs/sapi/phpdbg/phpdbg_exec.stub> ^�g> �e� ? vendor/phpstan/php-8-stubs/stubs/sapi/phpdbg/phpdbg_prompt.stub8 ^�g8 5�S�� C vendor/phpstan/php-8-stubs/stubs/sapi/phpdbg/phpdbg_break_next.stubP ^�gP �dL,� > vendor/phpstan/php-8-stubs/stubs/sapi/phpdbg/phpdbg_color.stubD ^�gD ψ� G vendor/phpstan/php-8-stubs/stubs/sapi/phpdbg/phpdbg_get_executable.stubF ^�gF ��)F� > vendor/phpstan/php-8-stubs/stubs/sapi/phpdbg/phpdbg_clear.stub) ^�g) jw��� E vendor/phpstan/php-8-stubs/stubs/sapi/phpdbg/phpdbg_break_method.stubM ^�gM J� G vendor/phpstan/php-8-stubs/stubs/sapi/phpdbg/phpdbg_break_function.stubB ^�gB {�&�� B vendor/phpstan/php-8-stubs/stubs/sapi/phpdbg/phpdbg_end_oplog.stubB ^�gB o�q� D vendor/phpstan/php-8-stubs/stubs/sapi/phpdbg/phpdbg_start_oplog.stub/ ^�g/ )�N� C vendor/phpstan/php-8-stubs/stubs/sapi/phpdbg/phpdbg_break_file.stubE ^�gE r;�c� E vendor/phpstan/php-8-stubs/stubs/sapi/cli/apache_request_headers.stub4 ^�g4 DhH:� D vendor/phpstan/php-8-stubs/stubs/sapi/cli/cli_get_process_title.stub5 ^�g5 |�}p� < vendor/phpstan/php-8-stubs/stubs/sapi/cli/getallheaders.stub+ ^�g+ ���B� F vendor/phpstan/php-8-stubs/stubs/sapi/cli/apache_response_headers.stub5 ^�g5 ���� D vendor/phpstan/php-8-stubs/stubs/sapi/cli/cli_set_process_title.stub? ^�g? <k�m� I vendor/phpstan/php-8-stubs/stubs/sapi/fpm/fpm/apache_request_headers.stub4 ^�g4 DhH:� A vendor/phpstan/php-8-stubs/stubs/sapi/fpm/fpm/fpm_get_status.stub2 ^�g2 ��� � I vendor/phpstan/php-8-stubs/stubs/sapi/fpm/fpm/fastcgi_finish_request.stubU ^�gU Rr��� @ vendor/phpstan/php-8-stubs/stubs/sapi/fpm/fpm/getallheaders.stubP ^�gP ��(�� K vendor/phpstan/php-8-stubs/stubs/sapi/litespeed/apache_request_headers.stub\ ^�g\ �8� M vendor/phpstan/php-8-stubs/stubs/sapi/litespeed/litespeed_finish_request.stub5 ^�g5 g�R,� O vendor/phpstan/php-8-stubs/stubs/sapi/litespeed/litespeed_response_headers.stub> ^�g> ��j�� B vendor/phpstan/php-8-stubs/stubs/sapi/litespeed/getallheaders.stubS ^�gS ��g� N vendor/phpstan/php-8-stubs/stubs/sapi/litespeed/litespeed_request_headers.stubY ^�gY �4S� G vendor/phpstan/php-8-stubs/stubs/sapi/litespeed/apache_get_modules.stub0 ^�g0 ��7Ҥ L vendor/phpstan/php-8-stubs/stubs/sapi/litespeed/apache_response_headers.stubd ^�gd ��cL� P vendor/phpstan/php-8-stubs/stubs/sapi/apache2handler/apache_request_headers.stub4 ^�g4 DhH:� E vendor/phpstan/php-8-stubs/stubs/sapi/apache2handler/apache_note.stub] ^�g] 7��d� G vendor/phpstan/php-8-stubs/stubs/sapi/apache2handler/apache_setenv.stubd ^�gd K�ݤ K vendor/phpstan/php-8-stubs/stubs/sapi/apache2handler/apache_lookup_uri.stubh ^�gh kz-� A vendor/phpstan/php-8-stubs/stubs/sapi/apache2handler/virtual.stub/ ^�g/ {X�Ӥ L vendor/phpstan/php-8-stubs/stubs/sapi/apache2handler/apache_get_version.stub7 ^�g7 >��֤ G vendor/phpstan/php-8-stubs/stubs/sapi/apache2handler/getallheaders.stubP ^�gP ��(�� L vendor/phpstan/php-8-stubs/stubs/sapi/apache2handler/apache_get_modules.stub0 ^�g0 ��7Ҥ Q vendor/phpstan/php-8-stubs/stubs/sapi/apache2handler/apache_response_headers.stub5 ^�g5 ���� G vendor/phpstan/php-8-stubs/stubs/sapi/apache2handler/apache_getenv.stub] ^�g] �]3� E vendor/phpstan/php-8-stubs/stubs/sapi/cgi/apache_request_headers.stub4 ^�g4 DhH:� E vendor/phpstan/php-8-stubs/stubs/sapi/cgi/apache_child_terminate.stubU ^�gU �� Ϥ < vendor/phpstan/php-8-stubs/stubs/sapi/cgi/getallheaders.stubP ^�gP ��(�� F vendor/phpstan/php-8-stubs/stubs/sapi/cgi/apache_response_headers.stub5 ^�g5 ���� = vendor/phpstan/php-8-stubs/stubs/Zend/ArgumentCountError.stub7 ^�g7 �f-� B vendor/phpstan/php-8-stubs/stubs/Zend/get_declared_interfaces.stubL ^�gL u� 5� @ vendor/phpstan/php-8-stubs/stubs/Zend/get_defined_functions.stubg ^�gg ^&� / vendor/phpstan/php-8-stubs/stubs/Zend/is_a.stub� ^�g� ��ߤ 9 vendor/phpstan/php-8-stubs/stubs/Zend/is_subclass_of.stub� ^�g� ��1� C vendor/phpstan/php-8-stubs/stubs/Zend/ClosedGeneratorException.stub= ^�g= kQ�� 4 vendor/phpstan/php-8-stubs/stubs/Zend/TypeError.stub* ^�g* ��֤ 8 vendor/phpstan/php-8-stubs/stubs/Zend/WeakReference.stub� ^�g� qq�� 5 vendor/phpstan/php-8-stubs/stubs/Zend/ParseError.stub2 ^�g2 �!� 5 vendor/phpstan/php-8-stubs/stubs/Zend/Deprecated.stub_ ^�g_ ��� 5 vendor/phpstan/php-8-stubs/stubs/Zend/user_error.stub ^�g <�Y� 3 vendor/phpstan/php-8-stubs/stubs/Zend/stdClass.stubJ ^�gJ "� _� < vendor/phpstan/php-8-stubs/stubs/Zend/IteratorAggregate.stub� ^�g� ��-E� 2 vendor/phpstan/php-8-stubs/stubs/Zend/WeakMap.stubD ^�gD -��� 9 vendor/phpstan/php-8-stubs/stubs/Zend/zend_thread_id.stubI ^�gI 0� o� 0 vendor/phpstan/php-8-stubs/stubs/Zend/Error.stub ^�g �e��� 6 vendor/phpstan/php-8-stubs/stubs/Zend/strncasecmp.stubT ^�gT *�b � D vendor/phpstan/php-8-stubs/stubs/Zend/RequestParseBodyException.stubO ^�gO �Z4_� ? vendor/phpstan/php-8-stubs/stubs/Zend/get_declared_classes.stubI ^�gI �\��� 2 vendor/phpstan/php-8-stubs/stubs/Zend/strncmp.stubP ^�gP �)�� 4 vendor/phpstan/php-8-stubs/stubs/Zend/Countable.stub} ^�g} �ҿ�� 7 vendor/phpstan/php-8-stubs/stubs/Zend/class_exists.stubM ^�gM �*CF� > vendor/phpstan/php-8-stubs/stubs/Zend/DivisionByZeroError.stub> ^�g> �8դ 6 vendor/phpstan/php-8-stubs/stubs/Zend/class_alias.stub[ ^�g[ ���Ĥ A vendor/phpstan/php-8-stubs/stubs/Zend/AllowDynamicProperties.stub� ^�g� ��]%� 6 vendor/phpstan/php-8-stubs/stubs/Zend/Traversable.stubC ^�gC �ł�� 5 vendor/phpstan/php-8-stubs/stubs/Zend/BackedEnum.stub� ^�g� H��+� 1 vendor/phpstan/php-8-stubs/stubs/Zend/define.stub� ^�g� ���n� 8 vendor/phpstan/php-8-stubs/stubs/Zend/get_resources.stub? ^�g? P2鮤 2 vendor/phpstan/php-8-stubs/stubs/Zend/defined.stub9 ^�g9 n�*b� ; vendor/phpstan/php-8-stubs/stubs/Zend/get_defined_vars.stubE ^�gE �[m� : vendor/phpstan/php-8-stubs/stubs/Zend/get_object_vars.stub; ^�g; 2�zc� 6 vendor/phpstan/php-8-stubs/stubs/Zend/ArrayAccess.stub5 ^�g5 &+��� 5 vendor/phpstan/php-8-stubs/stubs/Zend/FiberError.stubp ^�gp �U3� 8 vendor/phpstan/php-8-stubs/stubs/Zend/trigger_error.stub� ^�g� ;��c� 6 vendor/phpstan/php-8-stubs/stubs/Zend/enum_exists.stub\ ^�g\ ԩ� � 5 vendor/phpstan/php-8-stubs/stubs/Zend/ValueError.stub+ ^�g+ �&Ȳ� 4 vendor/phpstan/php-8-stubs/stubs/Zend/get_class.stub@ ^�g@ A�p�� 5 vendor/phpstan/php-8-stubs/stubs/Zend/gc_disable.stub' ^�g' ���� 4 vendor/phpstan/php-8-stubs/stubs/Zend/Exception.stubd ^�gd �?[i� @ vendor/phpstan/php-8-stubs/stubs/Zend/set_exception_handler.stubg ^�gg #\%� < vendor/phpstan/php-8-stubs/stubs/Zend/get_class_methods.stubd ^�gd �]S� ; vendor/phpstan/php-8-stubs/stubs/Zend/interface_exists.stubU ^�gU ��y� 5 vendor/phpstan/php-8-stubs/stubs/Zend/Stringable.stubJ ^�gJ }ވ�� @ vendor/phpstan/php-8-stubs/stubs/Zend/restore_error_handler.stub ^�g $P%)� @ vendor/phpstan/php-8-stubs/stubs/Zend/get_defined_constants.stubb ^�gb ��Vɤ = vendor/phpstan/php-8-stubs/stubs/Zend/SensitiveParameter.stub� ^�g� ��Q� B vendor/phpstan/php-8-stubs/stubs/Zend/get_mangled_object_vars.stubC ^�gC ��� ? vendor/phpstan/php-8-stubs/stubs/Zend/ReturnTypeWillChange.stubk ^�gk �Y�� : vendor/phpstan/php-8-stubs/stubs/Zend/ArithmeticError.stub0 ^�g0 �ڏ� 4 vendor/phpstan/php-8-stubs/stubs/Zend/gc_status.stub> ^�g> 0O�� 7 vendor/phpstan/php-8-stubs/stubs/Zend/func_get_arg.stub7 ^�g7 �� � : vendor/phpstan/php-8-stubs/stubs/Zend/property_exists.stub{ ^�g{ �y� > vendor/phpstan/php-8-stubs/stubs/Zend/get_declared_traits.stubH ^�gH {8� � : vendor/phpstan/php-8-stubs/stubs/Zend/function_exists.stub< ^�g< $m�� 9 vendor/phpstan/php-8-stubs/stubs/Zend/ErrorException.stub ^�g � m� 8 vendor/phpstan/php-8-stubs/stubs/Zend/method_exists.stubw ^�gw _�ڟ� 5 vendor/phpstan/php-8-stubs/stubs/Zend/strcasecmp.stubF ^�gF ���X� 8 vendor/phpstan/php-8-stubs/stubs/Zend/func_num_args.stub) ^�g) O�Ph� 1 vendor/phpstan/php-8-stubs/stubs/Zend/strlen.stub0 ^�g0 <�� 2 vendor/phpstan/php-8-stubs/stubs/Zend/Closure.stub� ^�g� ɵ(� ; vendor/phpstan/php-8-stubs/stubs/Zend/extension_loaded.stub> ^�g> 2[놤 D vendor/phpstan/php-8-stubs/stubs/Zend/restore_exception_handler.stub� ^�g� ��Ҥ 8 vendor/phpstan/php-8-stubs/stubs/Zend/gc_mem_caches.stub0 ^�g0 ���c� 1 vendor/phpstan/php-8-stubs/stubs/Zend/strcmp.stubB ^�gB ���0� 7 vendor/phpstan/php-8-stubs/stubs/Zend/Serializable.stub� ^�g� ��i� : vendor/phpstan/php-8-stubs/stubs/Zend/debug_backtrace.stub� ^�g� w�|z� B vendor/phpstan/php-8-stubs/stubs/Zend/SensitiveParameterValue.stub ^�g CzO� : vendor/phpstan/php-8-stubs/stubs/Zend/error_reporting.stubC ^�gC AT�p� 7 vendor/phpstan/php-8-stubs/stubs/Zend/zend_version.stubM ^�gM ��吤 ; vendor/phpstan/php-8-stubs/stubs/Zend/get_called_class.stub/ ^�g/ �歉� 0 vendor/phpstan/php-8-stubs/stubs/Zend/Fiber.stub ^�g ��m� 4 vendor/phpstan/php-8-stubs/stubs/Zend/Generator.stub: ^�g: ���� ; vendor/phpstan/php-8-stubs/stubs/Zend/InternalIterator.stub� ^�g� � }� 7 vendor/phpstan/php-8-stubs/stubs/Zend/CompileError.stub- ^�g- � �� = vendor/phpstan/php-8-stubs/stubs/Zend/get_included_files.stubG ^�gG ��T � @ vendor/phpstan/php-8-stubs/stubs/Zend/get_loaded_extensions.stubg ^�gg �O6�� 8 vendor/phpstan/php-8-stubs/stubs/Zend/func_get_args.stub+ ^�g+ ��6�� 5 vendor/phpstan/php-8-stubs/stubs/Zend/gc_enabled.stub' ^�g' r}�� = vendor/phpstan/php-8-stubs/stubs/Zend/get_required_files.stubU ^�gU Ln� @ vendor/phpstan/php-8-stubs/stubs/Zend/debug_print_backtrace.stubR ^�gR ���L� ; vendor/phpstan/php-8-stubs/stubs/Zend/get_parent_class.stub] ^�g] ��� 9 vendor/phpstan/php-8-stubs/stubs/Zend/get_class_vars.stubP ^�gP �u�� > vendor/phpstan/php-8-stubs/stubs/Zend/UnhandledMatchError.stub4 ^�g4 -�A� 3 vendor/phpstan/php-8-stubs/stubs/Zend/Iterator.stub ^�g ]燤 3 vendor/phpstan/php-8-stubs/stubs/Zend/Override.stub� ^�g� ~}�Ϥ 4 vendor/phpstan/php-8-stubs/stubs/Zend/Throwable.stubo ^�go �x� < vendor/phpstan/php-8-stubs/stubs/Zend/get_resource_type.stubZ ^�gZ (��ˤ : vendor/phpstan/php-8-stubs/stubs/Zend/get_resource_id.stubU ^�gU �\ ߤ < vendor/phpstan/php-8-stubs/stubs/Zend/gc_collect_cycles.stub- ^�g- �W� 3 vendor/phpstan/php-8-stubs/stubs/Zend/UnitEnum.stuby ^�gy wGuפ 4 vendor/phpstan/php-8-stubs/stubs/Zend/gc_enable.stub& ^�g& V��/� > vendor/phpstan/php-8-stubs/stubs/Zend/get_extension_funcs.stub_ ^�g_ ��!S� 7 vendor/phpstan/php-8-stubs/stubs/Zend/trait_exists.stubM ^�gM �ϐ8� < vendor/phpstan/php-8-stubs/stubs/Zend/set_error_handler.stub~ ^�g~ �S�Q� 4 vendor/phpstan/php-8-stubs/stubs/Zend/Attribute.stub� ^�g� �{�� $ vendor/fig/http-message-util/LICENSE= ^�g= ��?� 8 vendor/fig/http-message-util/src/StatusCodeInterface.phpy ^�gy 3�� ; vendor/fig/http-message-util/src/RequestMethodInterface.php� ^�g� q���� bin/phpstan ^�g �{� stubs/dom.stubM ^�gM M =� stubs/mysqli.stubX ^�gX � FV� stubs/WeakReference.stub` ^�g` �`�� " stubs/ReflectionClassConstant.stub� ^�g� D�xd� stubs/date.stub ^�g �fa� stubs/iterable.stub�# ^�g�# �)k � stubs/Countable.stubd ^�gd �䞤 stubs/ibm_db2.stub ^�g �c�Ҥ % stubs/ReflectionFunctionAbstract.stub ^�g V�cȤ stubs/typeCheckingFunctions.stub^ ^�g^ U5 ¤ stubs/zip.stub4 ^�g4 ��#� stubs/runtime/Attribute.php9 ^�g9 Qۊ�� % stubs/runtime/ReflectionAttribute.php� ^�g� �="� , stubs/runtime/ReflectionIntersectionType.php ^�g ���;� stubs/runtime/Enum/UnitEnum.php� ^�g� � � / stubs/runtime/Enum/ReflectionEnumBackedCase.php� ^�g� ;7y� % stubs/runtime/Enum/ReflectionEnum.php� ^�g� ��mG� - stubs/runtime/Enum/ReflectionEnumUnitCase.php� ^�g� ��� ! stubs/runtime/Enum/BackedEnum.php ^�g ��M� % stubs/runtime/ReflectionUnionType.php� ^�g� �D=� stubs/Exception.stub- ^�g- W� m� stubs/ImagickPixel.stubp ^�gp +��� stubs/ReflectionParameter.stub� ^�g� �5�Τ stubs/json_validate.stub� ^�g� �v�R� stubs/ReflectionEnum.stubh ^�gh ݠFߤ stubs/ArrayObject.stub ^�g ��jM� stubs/arrayFunctions.stub� ^�g� ~�� stubs/core.stub�" ^�g�" >��� stubs/spl.stub/ ^�g/ ��� stubs/socket_select_php8.stub� ^�g� ��٤ stubs/ReflectionClass.stub ^�g ��ڤ stubs/ReflectionAttribute.stub ^�g q���� stubs/ext-ds.stubw8 ^�gw8 &�� stubs/SplObjectStorage.stub� ^�g� �+�q� stubs/PDOStatement.stub� ^�g� ���� ! stubs/bleedingEdge/Countable.stubo ^�go �U� stubs/bleedingEdge/Rule.stub� ^�g� ߤ � stubs/socket_select.stub� ^�g� f/�� stubs/ReflectionProperty.stub� ^�g� Xڛڤ stubs/ReflectionMethod.stub� ^�g� �ä� <?php declare (strict_types=1); namespace PHPStan\Dependency\ExportedNode; use JsonSerializable; use PHPStan\Dependency\ExportedNode; use PHPStan\Dependency\RootExportedNode; use PHPStan\ShouldNotHappenException; use ReturnTypeWillChange; use function array_map; use function count; final class ExportedClassNode implements RootExportedNode, JsonSerializable { /** * @var string */ private $name; /** * @var ?ExportedPhpDocNode */ private $phpDoc; /** * @var bool */ private $abstract; /** * @var bool */ private $final; /** * @var ?string */ private $extends; /** * @var string[] */ private $implements; /** * @var string[] */ private $usedTraits; /** * @var ExportedTraitUseAdaptation[] */ private $traitUseAdaptations; /** * @var ExportedNode[] */ private $statements; /** * @var ExportedAttributeNode[] */ private $attributes; /** * @param string[] $implements * @param string[] $usedTraits * @param ExportedTraitUseAdaptation[] $traitUseAdaptations * @param ExportedNode[] $statements * @param ExportedAttributeNode[] $attributes */ public function __construct(string $name, ?\PHPStan\Dependency\ExportedNode\ExportedPhpDocNode $phpDoc, bool $abstract, bool $final, ?string $extends, array $implements, array $usedTraits, array $traitUseAdaptations, array $statements, array $attributes) { $this->name = $name; $this->phpDoc = $phpDoc; $this->abstract = $abstract; $this->final = $final; $this->extends = $extends; $this->implements = $implements; $this->usedTraits = $usedTraits; $this->traitUseAdaptations = $traitUseAdaptations; $this->statements = $statements; $this->attributes = $attributes; } public function equals(ExportedNode $node) : bool { if (!$node instanceof self) { return \false; } if ($this->phpDoc === null) { if ($node->phpDoc !== null) { return \false; } } elseif ($node->phpDoc !== null) { if (!$this->phpDoc->equals($node->phpDoc)) { return \false; } } else { return \false; } if (count($this->attributes) !== count($node->attributes)) { return \false; } foreach ($this->attributes as $i => $attribute) { if (!$attribute->equals($node->attributes[$i])) { return \false; } } if (count($this->traitUseAdaptations) !== count($node->traitUseAdaptations)) { return \false; } foreach ($this->traitUseAdaptations as $i => $ourTraitUseAdaptation) { $theirTraitUseAdaptation = $node->traitUseAdaptations[$i]; if (!$ourTraitUseAdaptation->equals($theirTraitUseAdaptation)) { return \false; } } if (count($this->statements) !== count($node->statements)) { return \false; } foreach ($this->statements as $i => $statement) { if ($statement->equals($node->statements[$i])) { continue; } return \false; } return $this->name === $node->name && $this->abstract === $node->abstract && $this->final === $node->final && $this->extends === $node->extends && $this->implements === $node->implements && $this->usedTraits === $node->usedTraits; } /** * @param mixed[] $properties * @return self */ public static function __set_state(array $properties) : ExportedNode { return new self($properties['name'], $properties['phpDoc'], $properties['abstract'], $properties['final'], $properties['extends'], $properties['implements'], $properties['usedTraits'], $properties['traitUseAdaptations'], $properties['statements'], $properties['attributes']); } /** * @return mixed */ #[\ReturnTypeWillChange] public function jsonSerialize() { return ['type' => self::class, 'data' => ['name' => $this->name, 'phpDoc' => $this->phpDoc, 'abstract' => $this->abstract, 'final' => $this->final, 'extends' => $this->extends, 'implements' => $this->implements, 'usedTraits' => $this->usedTraits, 'traitUseAdaptations' => $this->traitUseAdaptations, 'statements' => $this->statements, 'attributes' => $this->attributes]]; } /** * @param mixed[] $data * @return self */ public static function decode(array $data) : ExportedNode { return new self($data['name'], $data['phpDoc'] !== null ? \PHPStan\Dependency\ExportedNode\ExportedPhpDocNode::decode($data['phpDoc']['data']) : null, $data['abstract'], $data['final'], $data['extends'], $data['implements'], $data['usedTraits'], array_map(static function (array $traitUseAdaptationData) : \PHPStan\Dependency\ExportedNode\ExportedTraitUseAdaptation { if ($traitUseAdaptationData['type'] !== \PHPStan\Dependency\ExportedNode\ExportedTraitUseAdaptation::class) { throw new ShouldNotHappenException(); } return \PHPStan\Dependency\ExportedNode\ExportedTraitUseAdaptation::decode($traitUseAdaptationData['data']); }, $data['traitUseAdaptations']), array_map(static function (array $node) : ExportedNode { $nodeType = $node['type']; return $nodeType::decode($node['data']); }, $data['statements']), array_map(static function (array $attributeData) : \PHPStan\Dependency\ExportedNode\ExportedAttributeNode { if ($attributeData['type'] !== \PHPStan\Dependency\ExportedNode\ExportedAttributeNode::class) { throw new ShouldNotHappenException(); } return \PHPStan\Dependency\ExportedNode\ExportedAttributeNode::decode($attributeData['data']); }, $data['attributes'])); } /** * @return self::TYPE_CLASS */ public function getType() : string { return self::TYPE_CLASS; } public function getName() : string { return $this->name; } } <?php declare (strict_types=1); namespace PHPStan\Dependency\ExportedNode; use JsonSerializable; use PHPStan\Dependency\ExportedNode; use PHPStan\Dependency\RootExportedNode; use PHPStan\ShouldNotHappenException; use ReturnTypeWillChange; use function array_map; use function count; final class ExportedEnumNode implements RootExportedNode, JsonSerializable { /** * @var string */ private $name; /** * @var ?string */ private $scalarType; /** * @var ?ExportedPhpDocNode */ private $phpDoc; /** * @var string[] */ private $implements; /** * @var ExportedNode[] */ private $statements; /** * @var ExportedAttributeNode[] */ private $attributes; /** * @param string[] $implements * @param ExportedNode[] $statements * @param ExportedAttributeNode[] $attributes */ public function __construct(string $name, ?string $scalarType, ?\PHPStan\Dependency\ExportedNode\ExportedPhpDocNode $phpDoc, array $implements, array $statements, array $attributes) { $this->name = $name; $this->scalarType = $scalarType; $this->phpDoc = $phpDoc; $this->implements = $implements; $this->statements = $statements; $this->attributes = $attributes; } public function equals(ExportedNode $node) : bool { if (!$node instanceof self) { return \false; } if ($this->phpDoc === null) { if ($node->phpDoc !== null) { return \false; } } elseif ($node->phpDoc !== null) { if (!$this->phpDoc->equals($node->phpDoc)) { return \false; } } else { return \false; } if (count($this->statements) !== count($node->statements)) { return \false; } foreach ($this->statements as $i => $statement) { if ($statement->equals($node->statements[$i])) { continue; } return \false; } if (count($this->attributes) !== count($node->attributes)) { return \false; } foreach ($this->attributes as $i => $attribute) { if (!$attribute->equals($node->attributes[$i])) { return \false; } } return $this->name === $node->name && $this->scalarType === $node->scalarType && $this->implements === $node->implements; } /** * @param mixed[] $properties * @return self */ public static function __set_state(array $properties) : ExportedNode { return new self($properties['name'], $properties['scalarType'], $properties['phpDoc'], $properties['implements'], $properties['statements'], $properties['attributes']); } /** * @return mixed */ #[\ReturnTypeWillChange] public function jsonSerialize() { return ['type' => self::class, 'data' => ['name' => $this->name, 'scalarType' => $this->scalarType, 'phpDoc' => $this->phpDoc, 'implements' => $this->implements, 'statements' => $this->statements, 'attributes' => $this->attributes]]; } /** * @param mixed[] $data * @return self */ public static function decode(array $data) : ExportedNode { return new self($data['name'], $data['scalarType'], $data['phpDoc'] !== null ? \PHPStan\Dependency\ExportedNode\ExportedPhpDocNode::decode($data['phpDoc']['data']) : null, $data['implements'], array_map(static function (array $node) : ExportedNode { $nodeType = $node['type']; return $nodeType::decode($node['data']); }, $data['statements']), array_map(static function (array $attributeData) : \PHPStan\Dependency\ExportedNode\ExportedAttributeNode { if ($attributeData['type'] !== \PHPStan\Dependency\ExportedNode\ExportedAttributeNode::class) { throw new ShouldNotHappenException(); } return \PHPStan\Dependency\ExportedNode\ExportedAttributeNode::decode($attributeData['data']); }, $data['attributes'])); } /** * @return self::TYPE_ENUM */ public function getType() : string { return self::TYPE_ENUM; } public function getName() : string { return $this->name; } } <?php declare (strict_types=1); namespace PHPStan\Dependency\ExportedNode; use JsonSerializable; use PHPStan\Dependency\ExportedNode; use PHPStan\Dependency\RootExportedNode; use ReturnTypeWillChange; use function array_map; use function count; final class ExportedInterfaceNode implements RootExportedNode, JsonSerializable { /** * @var string */ private $name; /** * @var ?ExportedPhpDocNode */ private $phpDoc; /** * @var string[] */ private $extends; /** * @var ExportedNode[] */ private $statements; /** * @param string[] $extends * @param ExportedNode[] $statements */ public function __construct(string $name, ?\PHPStan\Dependency\ExportedNode\ExportedPhpDocNode $phpDoc, array $extends, array $statements) { $this->name = $name; $this->phpDoc = $phpDoc; $this->extends = $extends; $this->statements = $statements; } public function equals(ExportedNode $node) : bool { if (!$node instanceof self) { return \false; } if ($this->phpDoc === null) { if ($node->phpDoc !== null) { return \false; } } elseif ($node->phpDoc !== null) { if (!$this->phpDoc->equals($node->phpDoc)) { return \false; } } else { return \false; } if (count($this->statements) !== count($node->statements)) { return \false; } foreach ($this->statements as $i => $statement) { if ($statement->equals($node->statements[$i])) { continue; } return \false; } return $this->name === $node->name && $this->extends === $node->extends; } /** * @param mixed[] $properties * @return self */ public static function __set_state(array $properties) : ExportedNode { return new self($properties['name'], $properties['phpDoc'], $properties['extends'], $properties['statements']); } /** * @return mixed */ #[\ReturnTypeWillChange] public function jsonSerialize() { return ['type' => self::class, 'data' => ['name' => $this->name, 'phpDoc' => $this->phpDoc, 'extends' => $this->extends, 'statements' => $this->statements]]; } /** * @param mixed[] $data * @return self */ public static function decode(array $data) : ExportedNode { return new self($data['name'], $data['phpDoc'] !== null ? \PHPStan\Dependency\ExportedNode\ExportedPhpDocNode::decode($data['phpDoc']['data']) : null, $data['extends'], array_map(static function (array $node) : ExportedNode { $nodeType = $node['type']; return $nodeType::decode($node['data']); }, $data['statements'])); } /** * @return self::TYPE_INTERFACE */ public function getType() : string { return self::TYPE_INTERFACE; } public function getName() : string { return $this->name; } } <?php declare (strict_types=1); namespace PHPStan\Dependency\ExportedNode; use JsonSerializable; use PHPStan\Dependency\ExportedNode; use PHPStan\ShouldNotHappenException; use ReturnTypeWillChange; use function array_map; use function count; final class ExportedClassConstantNode implements ExportedNode, JsonSerializable { /** * @var string */ private $name; /** * @var string */ private $value; /** * @var ExportedAttributeNode[] */ private $attributes; /** * @param ExportedAttributeNode[] $attributes */ public function __construct(string $name, string $value, array $attributes) { $this->name = $name; $this->value = $value; $this->attributes = $attributes; } public function equals(ExportedNode $node) : bool { if (!$node instanceof self) { return \false; } if (count($this->attributes) !== count($node->attributes)) { return \false; } foreach ($this->attributes as $i => $attribute) { if (!$attribute->equals($node->attributes[$i])) { return \false; } } return $this->name === $node->name && $this->value === $node->value; } /** * @param mixed[] $properties * @return self */ public static function __set_state(array $properties) : ExportedNode { return new self($properties['name'], $properties['value'], $properties['attributes']); } /** * @param mixed[] $data * @return self */ public static function decode(array $data) : ExportedNode { return new self($data['name'], $data['value'], array_map(static function (array $attributeData) : \PHPStan\Dependency\ExportedNode\ExportedAttributeNode { if ($attributeData['type'] !== \PHPStan\Dependency\ExportedNode\ExportedAttributeNode::class) { throw new ShouldNotHappenException(); } return \PHPStan\Dependency\ExportedNode\ExportedAttributeNode::decode($attributeData['data']); }, $data['attributes'])); } /** * @return mixed */ #[\ReturnTypeWillChange] public function jsonSerialize() { return ['type' => self::class, 'data' => ['name' => $this->name, 'value' => $this->value, 'attributes' => $this->attributes]]; } } <?php declare (strict_types=1); namespace PHPStan\Dependency\ExportedNode; use JsonSerializable; use PHPStan\Dependency\ExportedNode; use PHPStan\ShouldNotHappenException; use ReturnTypeWillChange; use function array_map; use function count; final class ExportedParameterNode implements ExportedNode, JsonSerializable { /** * @var string */ private $name; /** * @var ?string */ private $type; /** * @var bool */ private $byRef; /** * @var bool */ private $variadic; /** * @var bool */ private $hasDefault; /** * @var ExportedAttributeNode[] */ private $attributes; /** * @param ExportedAttributeNode[] $attributes */ public function __construct(string $name, ?string $type, bool $byRef, bool $variadic, bool $hasDefault, array $attributes) { $this->name = $name; $this->type = $type; $this->byRef = $byRef; $this->variadic = $variadic; $this->hasDefault = $hasDefault; $this->attributes = $attributes; } public function equals(ExportedNode $node) : bool { if (!$node instanceof self) { return \false; } if (count($this->attributes) !== count($node->attributes)) { return \false; } foreach ($this->attributes as $i => $attribute) { if (!$attribute->equals($node->attributes[$i])) { return \false; } } return $this->name === $node->name && $this->type === $node->type && $this->byRef === $node->byRef && $this->variadic === $node->variadic && $this->hasDefault === $node->hasDefault; } /** * @param mixed[] $properties * @return self */ public static function __set_state(array $properties) : ExportedNode { return new self($properties['name'], $properties['type'], $properties['byRef'], $properties['variadic'], $properties['hasDefault'], $properties['attributes']); } /** * @return mixed */ #[\ReturnTypeWillChange] public function jsonSerialize() { return ['type' => self::class, 'data' => ['name' => $this->name, 'type' => $this->type, 'byRef' => $this->byRef, 'variadic' => $this->variadic, 'hasDefault' => $this->hasDefault, 'attributes' => $this->attributes]]; } /** * @param mixed[] $data * @return self */ public static function decode(array $data) : ExportedNode { return new self($data['name'], $data['type'], $data['byRef'], $data['variadic'], $data['hasDefault'], array_map(static function (array $attributeData) : \PHPStan\Dependency\ExportedNode\ExportedAttributeNode { if ($attributeData['type'] !== \PHPStan\Dependency\ExportedNode\ExportedAttributeNode::class) { throw new ShouldNotHappenException(); } return \PHPStan\Dependency\ExportedNode\ExportedAttributeNode::decode($attributeData['data']); }, $data['attributes'])); } } <?php declare (strict_types=1); namespace PHPStan\Dependency\ExportedNode; use JsonSerializable; use PHPStan\Dependency\ExportedNode; use PHPStan\Dependency\RootExportedNode; use PHPStan\ShouldNotHappenException; use ReturnTypeWillChange; use function array_map; use function count; final class ExportedFunctionNode implements RootExportedNode, JsonSerializable { /** * @var string */ private $name; /** * @var ?ExportedPhpDocNode */ private $phpDoc; /** * @var bool */ private $byRef; /** * @var ?string */ private $returnType; /** * @var ExportedParameterNode[] */ private $parameters; /** * @var ExportedAttributeNode[] */ private $attributes; /** * @param ExportedParameterNode[] $parameters * @param ExportedAttributeNode[] $attributes */ public function __construct(string $name, ?\PHPStan\Dependency\ExportedNode\ExportedPhpDocNode $phpDoc, bool $byRef, ?string $returnType, array $parameters, array $attributes) { $this->name = $name; $this->phpDoc = $phpDoc; $this->byRef = $byRef; $this->returnType = $returnType; $this->parameters = $parameters; $this->attributes = $attributes; } public function equals(ExportedNode $node) : bool { if (!$node instanceof self) { return \false; } if (count($this->parameters) !== count($node->parameters)) { return \false; } foreach ($this->parameters as $i => $ourParameter) { $theirParameter = $node->parameters[$i]; if (!$ourParameter->equals($theirParameter)) { return \false; } } if ($this->phpDoc === null) { if ($node->phpDoc !== null) { return \false; } } elseif ($node->phpDoc !== null) { if (!$this->phpDoc->equals($node->phpDoc)) { return \false; } } else { return \false; } if (count($this->attributes) !== count($node->attributes)) { return \false; } foreach ($this->attributes as $i => $attribute) { if (!$attribute->equals($node->attributes[$i])) { return \false; } } return $this->name === $node->name && $this->byRef === $node->byRef && $this->returnType === $node->returnType; } /** * @param mixed[] $properties * @return self */ public static function __set_state(array $properties) : ExportedNode { return new self($properties['name'], $properties['phpDoc'], $properties['byRef'], $properties['returnType'], $properties['parameters'], $properties['attributes']); } /** * @return mixed */ #[\ReturnTypeWillChange] public function jsonSerialize() { return ['type' => self::class, 'data' => ['name' => $this->name, 'phpDoc' => $this->phpDoc, 'byRef' => $this->byRef, 'returnType' => $this->returnType, 'parameters' => $this->parameters, 'attributes' => $this->attributes]]; } /** * @param mixed[] $data * @return self */ public static function decode(array $data) : ExportedNode { return new self($data['name'], $data['phpDoc'] !== null ? \PHPStan\Dependency\ExportedNode\ExportedPhpDocNode::decode($data['phpDoc']['data']) : null, $data['byRef'], $data['returnType'], array_map(static function (array $parameterData) : \PHPStan\Dependency\ExportedNode\ExportedParameterNode { if ($parameterData['type'] !== \PHPStan\Dependency\ExportedNode\ExportedParameterNode::class) { throw new ShouldNotHappenException(); } return \PHPStan\Dependency\ExportedNode\ExportedParameterNode::decode($parameterData['data']); }, $data['parameters']), array_map(static function (array $attributeData) : \PHPStan\Dependency\ExportedNode\ExportedAttributeNode { if ($attributeData['type'] !== \PHPStan\Dependency\ExportedNode\ExportedAttributeNode::class) { throw new ShouldNotHappenException(); } return \PHPStan\Dependency\ExportedNode\ExportedAttributeNode::decode($attributeData['data']); }, $data['attributes'])); } /** * @return self::TYPE_FUNCTION */ public function getType() : string { return self::TYPE_FUNCTION; } public function getName() : string { return $this->name; } } <?php declare (strict_types=1); namespace PHPStan\Dependency\ExportedNode; use JsonSerializable; use PHPStan\Dependency\ExportedNode; use ReturnTypeWillChange; use function count; final class ExportedAttributeNode implements ExportedNode, JsonSerializable { /** * @var string */ private $name; /** * @var array<int|string, string> */ private $args; /** * @param array<int|string, string> $args argument name or index(string|int) => value expression (string) */ public function __construct(string $name, array $args) { $this->name = $name; $this->args = $args; } public function equals(ExportedNode $node) : bool { if (!$node instanceof self) { return \false; } if ($this->name !== $node->name) { return \false; } if (count($this->args) !== count($node->args)) { return \false; } foreach ($this->args as $argName => $argValue) { if (!isset($node->args[$argName]) || $argValue !== $node->args[$argName]) { return \false; } } return \true; } /** * @param mixed[] $properties * @return self */ public static function __set_state(array $properties) : ExportedNode { return new self($properties['name'], $properties['args']); } /** * @return mixed */ #[\ReturnTypeWillChange] public function jsonSerialize() { return ['type' => self::class, 'data' => ['name' => $this->name, 'args' => $this->args]]; } /** * @param mixed[] $data * @return self */ public static function decode(array $data) : ExportedNode { return new self($data['name'], $data['args']); } } <?php declare (strict_types=1); namespace PHPStan\Dependency\ExportedNode; use JsonSerializable; use PHPStan\Dependency\ExportedNode; use PHPStan\ShouldNotHappenException; use ReturnTypeWillChange; use function array_map; use function count; final class ExportedMethodNode implements ExportedNode, JsonSerializable { /** * @var string */ private $name; /** * @var ?ExportedPhpDocNode */ private $phpDoc; /** * @var bool */ private $byRef; /** * @var bool */ private $public; /** * @var bool */ private $private; /** * @var bool */ private $abstract; /** * @var bool */ private $final; /** * @var bool */ private $static; /** * @var ?string */ private $returnType; /** * @var ExportedParameterNode[] */ private $parameters; /** * @var ExportedAttributeNode[] */ private $attributes; /** * @param ExportedParameterNode[] $parameters * @param ExportedAttributeNode[] $attributes */ public function __construct(string $name, ?\PHPStan\Dependency\ExportedNode\ExportedPhpDocNode $phpDoc, bool $byRef, bool $public, bool $private, bool $abstract, bool $final, bool $static, ?string $returnType, array $parameters, array $attributes) { $this->name = $name; $this->phpDoc = $phpDoc; $this->byRef = $byRef; $this->public = $public; $this->private = $private; $this->abstract = $abstract; $this->final = $final; $this->static = $static; $this->returnType = $returnType; $this->parameters = $parameters; $this->attributes = $attributes; } public function equals(ExportedNode $node) : bool { if (!$node instanceof self) { return \false; } if (count($this->parameters) !== count($node->parameters)) { return \false; } foreach ($this->parameters as $i => $ourParameter) { $theirParameter = $node->parameters[$i]; if (!$ourParameter->equals($theirParameter)) { return \false; } } if ($this->phpDoc === null) { if ($node->phpDoc !== null) { return \false; } } elseif ($node->phpDoc !== null) { if (!$this->phpDoc->equals($node->phpDoc)) { return \false; } } else { return \false; } if (count($this->attributes) !== count($node->attributes)) { return \false; } foreach ($this->attributes as $i => $attribute) { if (!$attribute->equals($node->attributes[$i])) { return \false; } } return $this->name === $node->name && $this->byRef === $node->byRef && $this->public === $node->public && $this->private === $node->private && $this->abstract === $node->abstract && $this->final === $node->final && $this->static === $node->static && $this->returnType === $node->returnType; } /** * @param mixed[] $properties * @return self */ public static function __set_state(array $properties) : ExportedNode { return new self($properties['name'], $properties['phpDoc'], $properties['byRef'], $properties['public'], $properties['private'], $properties['abstract'], $properties['final'], $properties['static'], $properties['returnType'], $properties['parameters'], $properties['attributes']); } /** * @return mixed */ #[\ReturnTypeWillChange] public function jsonSerialize() { return ['type' => self::class, 'data' => ['name' => $this->name, 'phpDoc' => $this->phpDoc, 'byRef' => $this->byRef, 'public' => $this->public, 'private' => $this->private, 'abstract' => $this->abstract, 'final' => $this->final, 'static' => $this->static, 'returnType' => $this->returnType, 'parameters' => $this->parameters, 'attributes' => $this->attributes]]; } /** * @param mixed[] $data * @return self */ public static function decode(array $data) : ExportedNode { return new self($data['name'], $data['phpDoc'] !== null ? \PHPStan\Dependency\ExportedNode\ExportedPhpDocNode::decode($data['phpDoc']['data']) : null, $data['byRef'], $data['public'], $data['private'], $data['abstract'], $data['final'], $data['static'], $data['returnType'], array_map(static function (array $parameterData) : \PHPStan\Dependency\ExportedNode\ExportedParameterNode { if ($parameterData['type'] !== \PHPStan\Dependency\ExportedNode\ExportedParameterNode::class) { throw new ShouldNotHappenException(); } return \PHPStan\Dependency\ExportedNode\ExportedParameterNode::decode($parameterData['data']); }, $data['parameters']), array_map(static function (array $attributeData) : \PHPStan\Dependency\ExportedNode\ExportedAttributeNode { if ($attributeData['type'] !== \PHPStan\Dependency\ExportedNode\ExportedAttributeNode::class) { throw new ShouldNotHappenException(); } return \PHPStan\Dependency\ExportedNode\ExportedAttributeNode::decode($attributeData['data']); }, $data['attributes'])); } } <?php declare (strict_types=1); namespace PHPStan\Dependency\ExportedNode; use JsonSerializable; use PHPStan\Dependency\ExportedNode; use PHPStan\ShouldNotHappenException; use ReturnTypeWillChange; use function array_map; use function count; final class ExportedClassConstantsNode implements ExportedNode, JsonSerializable { /** * @var ExportedClassConstantNode[] */ private $constants; /** * @var bool */ private $public; /** * @var bool */ private $private; /** * @var bool */ private $final; /** * @var ?ExportedPhpDocNode */ private $phpDoc; /** * @param ExportedClassConstantNode[] $constants */ public function __construct(array $constants, bool $public, bool $private, bool $final, ?\PHPStan\Dependency\ExportedNode\ExportedPhpDocNode $phpDoc) { $this->constants = $constants; $this->public = $public; $this->private = $private; $this->final = $final; $this->phpDoc = $phpDoc; } public function equals(ExportedNode $node) : bool { if (!$node instanceof self) { return \false; } if ($this->phpDoc === null) { if ($node->phpDoc !== null) { return \false; } } elseif ($node->phpDoc !== null) { if (!$this->phpDoc->equals($node->phpDoc)) { return \false; } } else { return \false; } if (count($this->constants) !== count($node->constants)) { return \false; } foreach ($this->constants as $i => $constant) { if (!$constant->equals($node->constants[$i])) { return \false; } } return $this->public === $node->public && $this->private === $node->private && $this->final === $node->final; } /** * @param mixed[] $properties * @return self */ public static function __set_state(array $properties) : ExportedNode { return new self($properties['constants'], $properties['public'], $properties['private'], $properties['final'], $properties['phpDoc']); } /** * @param mixed[] $data * @return self */ public static function decode(array $data) : ExportedNode { return new self(array_map(static function (array $constantData) : \PHPStan\Dependency\ExportedNode\ExportedClassConstantNode { if ($constantData['type'] !== \PHPStan\Dependency\ExportedNode\ExportedClassConstantNode::class) { throw new ShouldNotHappenException(); } return \PHPStan\Dependency\ExportedNode\ExportedClassConstantNode::decode($constantData['data']); }, $data['constants']), $data['public'], $data['private'], $data['final'], $data['phpDoc'] !== null ? \PHPStan\Dependency\ExportedNode\ExportedPhpDocNode::decode($data['phpDoc']['data']) : null); } /** * @return mixed */ #[\ReturnTypeWillChange] public function jsonSerialize() { return ['type' => self::class, 'data' => ['constants' => $this->constants, 'public' => $this->public, 'private' => $this->private, 'final' => $this->final, 'phpDoc' => $this->phpDoc]]; } } <?php declare (strict_types=1); namespace PHPStan\Dependency\ExportedNode; use JsonSerializable; use PHPStan\Dependency\ExportedNode; use PHPStan\Dependency\RootExportedNode; use ReturnTypeWillChange; final class ExportedTraitNode implements RootExportedNode, JsonSerializable { /** * @var string */ private $traitName; public function __construct(string $traitName) { $this->traitName = $traitName; } public function equals(ExportedNode $node) : bool { return \false; } /** * @param mixed[] $properties * @return self */ public static function __set_state(array $properties) : ExportedNode { return new self($properties['traitName']); } /** * @param mixed[] $data * @return self */ public static function decode(array $data) : ExportedNode { return new self($data['traitName']); } /** * @return mixed */ #[\ReturnTypeWillChange] public function jsonSerialize() { return ['type' => self::class, 'data' => ['traitName' => $this->traitName]]; } /** * @return self::TYPE_TRAIT */ public function getType() : string { return self::TYPE_TRAIT; } public function getName() : string { return $this->traitName; } } <?php declare (strict_types=1); namespace PHPStan\Dependency\ExportedNode; use JsonSerializable; use PHPStan\Dependency\ExportedNode; use ReturnTypeWillChange; final class ExportedTraitUseAdaptation implements ExportedNode, JsonSerializable { /** * @var ?string */ private $traitName; /** * @var string */ private $method; /** * @var ?int */ private $newModifier; /** * @var ?string */ private $newName; /** * @var string[]|null */ private $insteadOfs; /** * @param string[]|null $insteadOfs */ private function __construct(?string $traitName, string $method, ?int $newModifier, ?string $newName, ?array $insteadOfs) { $this->traitName = $traitName; $this->method = $method; $this->newModifier = $newModifier; $this->newName = $newName; $this->insteadOfs = $insteadOfs; } public static function createAlias(?string $traitName, string $method, ?int $newModifier, ?string $newName) : self { return new self($traitName, $method, $newModifier, $newName, null); } /** * @param string[] $insteadOfs */ public static function createPrecedence(?string $traitName, string $method, array $insteadOfs) : self { return new self($traitName, $method, null, null, $insteadOfs); } public function equals(ExportedNode $node) : bool { if (!$node instanceof self) { return \false; } return $this->traitName === $node->traitName && $this->method === $node->method && $this->newModifier === $node->newModifier && $this->newName === $node->newName && $this->insteadOfs === $node->insteadOfs; } /** * @param mixed[] $properties * @return self */ public static function __set_state(array $properties) : ExportedNode { return new self($properties['traitName'], $properties['method'], $properties['newModifier'], $properties['newName'], $properties['insteadOfs']); } /** * @param mixed[] $data * @return self */ public static function decode(array $data) : ExportedNode { return new self($data['traitName'], $data['method'], $data['newModifier'], $data['newName'], $data['insteadOfs']); } /** * @return mixed */ #[\ReturnTypeWillChange] public function jsonSerialize() { return ['type' => self::class, 'data' => ['traitName' => $this->traitName, 'method' => $this->method, 'newModifier' => $this->newModifier, 'newName' => $this->newName, 'insteadOfs' => $this->insteadOfs]]; } } <?php declare (strict_types=1); namespace PHPStan\Dependency\ExportedNode; use JsonSerializable; use PHPStan\Dependency\ExportedNode; use ReturnTypeWillChange; final class ExportedEnumCaseNode implements ExportedNode, JsonSerializable { /** * @var string */ private $name; /** * @var ?string */ private $value; /** * @var ?ExportedPhpDocNode */ private $phpDoc; public function __construct(string $name, ?string $value, ?\PHPStan\Dependency\ExportedNode\ExportedPhpDocNode $phpDoc) { $this->name = $name; $this->value = $value; $this->phpDoc = $phpDoc; } public function equals(ExportedNode $node) : bool { if (!$node instanceof self) { return \false; } if ($this->phpDoc === null) { if ($node->phpDoc !== null) { return \false; } } elseif ($node->phpDoc !== null) { if (!$this->phpDoc->equals($node->phpDoc)) { return \false; } } else { return \false; } return $this->name === $node->name && $this->value === $node->value; } /** * @param mixed[] $properties * @return self */ public static function __set_state(array $properties) : ExportedNode { return new self($properties['name'], $properties['value'], $properties['phpDoc']); } /** * @param mixed[] $data * @return self */ public static function decode(array $data) : ExportedNode { return new self($data['name'], $data['value'], $data['phpDoc'] !== null ? \PHPStan\Dependency\ExportedNode\ExportedPhpDocNode::decode($data['phpDoc']['data']) : null); } /** * @return mixed */ #[\ReturnTypeWillChange] public function jsonSerialize() { return ['type' => self::class, 'data' => ['name' => $this->name, 'value' => $this->value, 'phpDoc' => $this->phpDoc]]; } } <?php declare (strict_types=1); namespace PHPStan\Dependency\ExportedNode; use JsonSerializable; use PHPStan\Dependency\ExportedNode; use PHPStan\ShouldNotHappenException; use ReturnTypeWillChange; use function array_map; use function count; final class ExportedPropertiesNode implements JsonSerializable, ExportedNode { /** * @var string[] */ private $names; /** * @var ?ExportedPhpDocNode */ private $phpDoc; /** * @var ?string */ private $type; /** * @var bool */ private $public; /** * @var bool */ private $private; /** * @var bool */ private $static; /** * @var bool */ private $readonly; /** * @var ExportedAttributeNode[] */ private $attributes; /** * @param string[] $names * @param ExportedAttributeNode[] $attributes */ public function __construct(array $names, ?\PHPStan\Dependency\ExportedNode\ExportedPhpDocNode $phpDoc, ?string $type, bool $public, bool $private, bool $static, bool $readonly, array $attributes) { $this->names = $names; $this->phpDoc = $phpDoc; $this->type = $type; $this->public = $public; $this->private = $private; $this->static = $static; $this->readonly = $readonly; $this->attributes = $attributes; } public function equals(ExportedNode $node) : bool { if (!$node instanceof self) { return \false; } if ($this->phpDoc === null) { if ($node->phpDoc !== null) { return \false; } } elseif ($node->phpDoc !== null) { if (!$this->phpDoc->equals($node->phpDoc)) { return \false; } } else { return \false; } if (count($this->names) !== count($node->names)) { return \false; } foreach ($this->names as $i => $name) { if ($name !== $node->names[$i]) { return \false; } } if (count($this->attributes) !== count($node->attributes)) { return \false; } foreach ($this->attributes as $i => $attribute) { if (!$attribute->equals($node->attributes[$i])) { return \false; } } return $this->type === $node->type && $this->public === $node->public && $this->private === $node->private && $this->static === $node->static && $this->readonly === $node->readonly; } /** * @param mixed[] $properties * @return self */ public static function __set_state(array $properties) : ExportedNode { return new self($properties['names'], $properties['phpDoc'], $properties['type'], $properties['public'], $properties['private'], $properties['static'], $properties['readonly'], $properties['attributes']); } /** * @param mixed[] $data * @return self */ public static function decode(array $data) : ExportedNode { return new self($data['names'], $data['phpDoc'] !== null ? \PHPStan\Dependency\ExportedNode\ExportedPhpDocNode::decode($data['phpDoc']['data']) : null, $data['type'], $data['public'], $data['private'], $data['static'], $data['readonly'], array_map(static function (array $attributeData) : \PHPStan\Dependency\ExportedNode\ExportedAttributeNode { if ($attributeData['type'] !== \PHPStan\Dependency\ExportedNode\ExportedAttributeNode::class) { throw new ShouldNotHappenException(); } return \PHPStan\Dependency\ExportedNode\ExportedAttributeNode::decode($attributeData['data']); }, $data['attributes'])); } /** * @return mixed */ #[\ReturnTypeWillChange] public function jsonSerialize() { return ['type' => self::class, 'data' => ['names' => $this->names, 'phpDoc' => $this->phpDoc, 'type' => $this->type, 'public' => $this->public, 'private' => $this->private, 'static' => $this->static, 'readonly' => $this->readonly, 'attributes' => $this->attributes]]; } } <?php declare (strict_types=1); namespace PHPStan\Dependency\ExportedNode; use JsonSerializable; use PHPStan\Dependency\ExportedNode; use ReturnTypeWillChange; final class ExportedPhpDocNode implements ExportedNode, JsonSerializable { /** * @var string */ private $phpDocString; /** * @var ?string */ private $namespace; /** * @var array<string, string> */ private $uses; /** * @var array<string, string> */ private $constUses; /** * @param array<string, string> $uses alias(string) => fullName(string) * @param array<string, string> $constUses alias(string) => fullName(string) */ public function __construct(string $phpDocString, ?string $namespace, array $uses, array $constUses) { $this->phpDocString = $phpDocString; $this->namespace = $namespace; $this->uses = $uses; $this->constUses = $constUses; } public function equals(ExportedNode $node) : bool { if (!$node instanceof self) { return \false; } return $this->phpDocString === $node->phpDocString && $this->namespace === $node->namespace && $this->uses === $node->uses && $this->constUses === $node->constUses; } /** * @return mixed */ #[\ReturnTypeWillChange] public function jsonSerialize() { return ['type' => self::class, 'data' => ['phpDocString' => $this->phpDocString, 'namespace' => $this->namespace, 'uses' => $this->uses, 'constUses' => $this->constUses]]; } /** * @param mixed[] $properties * @return self */ public static function __set_state(array $properties) : ExportedNode { return new self($properties['phpDocString'], $properties['namespace'], $properties['uses'], $properties['constUses'] ?? []); } /** * @param mixed[] $data * @return self */ public static function decode(array $data) : ExportedNode { return new self($data['phpDocString'], $data['namespace'], $data['uses'], $data['constUses'] ?? []); } } <?php declare (strict_types=1); namespace PHPStan\Dependency; interface RootExportedNode extends \PHPStan\Dependency\ExportedNode { public const TYPE_CLASS = 'class'; public const TYPE_INTERFACE = 'interface'; public const TYPE_ENUM = 'enum'; public const TYPE_TRAIT = 'trait'; public const TYPE_FUNCTION = 'function'; /** @return self::TYPE_* */ public function getType() : string; public function getName() : string; } <?php declare (strict_types=1); namespace PHPStan\Dependency; use PhpParser\Node; use PhpParser\Node\Expr\Array_; use PhpParser\Node\Expr\ArrayDimFetch; use PhpParser\Node\Expr\Closure; use PhpParser\Node\Name; use PhpParser\Node\Stmt\Foreach_; use PHPStan\Analyser\Scope; use PHPStan\Broker\ClassNotFoundException; use PHPStan\Broker\FunctionNotFoundException; use PHPStan\File\FileHelper; use PHPStan\Node\ClassPropertyNode; use PHPStan\Node\InClassMethodNode; use PHPStan\Node\InFunctionNode; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\ParameterReflectionWithPhpDocs; use PHPStan\Reflection\ParametersAcceptorWithPhpDocs; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Type\ClosureType; use PHPStan\Type\FileTypeMapper; use PHPStan\Type\ParserNodeTypeToPHPStanType; use PHPStan\Type\Type; use function array_merge; use function count; final class DependencyResolver { /** * @var FileHelper */ private $fileHelper; /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var ExportedNodeResolver */ private $exportedNodeResolver; /** * @var FileTypeMapper */ private $fileTypeMapper; public function __construct(FileHelper $fileHelper, ReflectionProvider $reflectionProvider, \PHPStan\Dependency\ExportedNodeResolver $exportedNodeResolver, FileTypeMapper $fileTypeMapper) { $this->fileHelper = $fileHelper; $this->reflectionProvider = $reflectionProvider; $this->exportedNodeResolver = $exportedNodeResolver; $this->fileTypeMapper = $fileTypeMapper; } public function resolveDependencies(Node $node, Scope $scope) : \PHPStan\Dependency\NodeDependencies { $dependenciesReflections = []; if ($node instanceof Node\Stmt\Class_) { if ($node->namespacedName !== null) { $this->addClassToDependencies($node->namespacedName->toString(), $dependenciesReflections); } if ($node->extends !== null) { $this->addClassToDependencies($node->extends->toString(), $dependenciesReflections); } foreach ($node->implements as $className) { $this->addClassToDependencies($className->toString(), $dependenciesReflections); } } elseif ($node instanceof Node\Stmt\Interface_) { if ($node->namespacedName !== null) { $this->addClassToDependencies($node->namespacedName->toString(), $dependenciesReflections); } foreach ($node->extends as $className) { $this->addClassToDependencies($className->toString(), $dependenciesReflections); } } elseif ($node instanceof Node\Stmt\Enum_) { if ($node->namespacedName !== null) { $this->addClassToDependencies($node->namespacedName->toString(), $dependenciesReflections); } foreach ($node->implements as $className) { $this->addClassToDependencies($className->toString(), $dependenciesReflections); } } elseif ($node instanceof InClassMethodNode) { $nativeMethod = $node->getMethodReflection(); $this->extractThrowType($nativeMethod->getThrowType(), $dependenciesReflections); $this->extractFromParametersAcceptor($nativeMethod, $dependenciesReflections); foreach ($nativeMethod->getAsserts()->getAll() as $assertTag) { foreach ($assertTag->getType()->getReferencedClasses() as $referencedClass) { $this->addClassToDependencies($referencedClass, $dependenciesReflections); } foreach ($assertTag->getOriginalType()->getReferencedClasses() as $referencedClass) { $this->addClassToDependencies($referencedClass, $dependenciesReflections); } } if ($nativeMethod->getSelfOutType() !== null) { foreach ($nativeMethod->getSelfOutType()->getReferencedClasses() as $referencedClass) { $this->addClassToDependencies($referencedClass, $dependenciesReflections); } } } elseif ($node instanceof ClassPropertyNode) { $nativeTypeNode = $node->getNativeType(); if ($nativeTypeNode !== null) { $nativeType = ParserNodeTypeToPHPStanType::resolve($nativeTypeNode, $node->getClassReflection()); foreach ($nativeType->getReferencedClasses() as $referencedClass) { $this->addClassToDependencies($referencedClass, $dependenciesReflections); } } $phpDocType = $node->getPhpDocType(); if ($phpDocType !== null) { foreach ($phpDocType->getReferencedClasses() as $referencedClass) { $this->addClassToDependencies($referencedClass, $dependenciesReflections); } } } elseif ($node instanceof InFunctionNode) { $functionReflection = $node->getFunctionReflection(); $this->extractThrowType($functionReflection->getThrowType(), $dependenciesReflections); $this->extractFromParametersAcceptor($functionReflection, $dependenciesReflections); foreach ($functionReflection->getAsserts()->getAll() as $assertTag) { foreach ($assertTag->getType()->getReferencedClasses() as $referencedClass) { $this->addClassToDependencies($referencedClass, $dependenciesReflections); } foreach ($assertTag->getOriginalType()->getReferencedClasses() as $referencedClass) { $this->addClassToDependencies($referencedClass, $dependenciesReflections); } } } elseif ($node instanceof Closure || $node instanceof Node\Expr\ArrowFunction) { $closureType = $scope->getType($node); if ($closureType instanceof ClosureType) { foreach ($closureType->getParameters() as $parameter) { $referencedClasses = $parameter->getType()->getReferencedClasses(); foreach ($referencedClasses as $referencedClass) { $this->addClassToDependencies($referencedClass, $dependenciesReflections); } } $returnTypeReferencedClasses = $closureType->getReturnType()->getReferencedClasses(); foreach ($returnTypeReferencedClasses as $referencedClass) { $this->addClassToDependencies($referencedClass, $dependenciesReflections); } } } elseif ($node instanceof Node\Expr\FuncCall) { $functionName = $node->name; if ($functionName instanceof Node\Name) { try { $functionReflection = $this->getFunctionReflection($functionName, $scope); $dependenciesReflections[] = $functionReflection; foreach ($functionReflection->getVariants() as $functionVariant) { foreach ($functionVariant->getParameters() as $parameter) { if ($parameter->getOutType() !== null) { foreach ($parameter->getOutType()->getReferencedClasses() as $referencedClass) { $this->addClassToDependencies($referencedClass, $dependenciesReflections); } } if ($parameter->getClosureThisType() === null) { continue; } foreach ($parameter->getClosureThisType()->getReferencedClasses() as $referencedClass) { $this->addClassToDependencies($referencedClass, $dependenciesReflections); } } } foreach ($functionReflection->getAsserts()->getAll() as $assertTag) { foreach ($assertTag->getType()->getReferencedClasses() as $referencedClass) { $this->addClassToDependencies($referencedClass, $dependenciesReflections); } foreach ($assertTag->getOriginalType()->getReferencedClasses() as $referencedClass) { $this->addClassToDependencies($referencedClass, $dependenciesReflections); } } } catch (FunctionNotFoundException $e) { // pass } } else { $calledType = $scope->getType($functionName); if ($calledType->isCallable()->yes()) { $variants = $calledType->getCallableParametersAcceptors($scope); foreach ($variants as $variant) { $referencedClasses = $variant->getReturnType()->getReferencedClasses(); foreach ($referencedClasses as $referencedClass) { $this->addClassToDependencies($referencedClass, $dependenciesReflections); } foreach ($variant->getParameters() as $parameter) { if (!$parameter instanceof ParameterReflectionWithPhpDocs) { continue; } if ($parameter->getOutType() !== null) { foreach ($parameter->getOutType()->getReferencedClasses() as $referencedClass) { $this->addClassToDependencies($referencedClass, $dependenciesReflections); } } if ($parameter->getClosureThisType() === null) { continue; } foreach ($parameter->getClosureThisType()->getReferencedClasses() as $referencedClass) { $this->addClassToDependencies($referencedClass, $dependenciesReflections); } } } } } $returnType = $scope->getType($node); foreach ($returnType->getReferencedClasses() as $referencedClass) { $this->addClassToDependencies($referencedClass, $dependenciesReflections); } } elseif ($node instanceof Node\Expr\MethodCall) { $calledOnType = $scope->getType($node->var); $classNames = $calledOnType->getReferencedClasses(); foreach ($classNames as $className) { $this->addClassToDependencies($className, $dependenciesReflections); } $returnType = $scope->getType($node); foreach ($returnType->getReferencedClasses() as $referencedClass) { $this->addClassToDependencies($referencedClass, $dependenciesReflections); } if ($node->name instanceof Node\Identifier) { $methodReflection = $scope->getMethodReflection($calledOnType, $node->name->toString()); if ($methodReflection !== null) { $this->addClassToDependencies($methodReflection->getDeclaringClass()->getName(), $dependenciesReflections); foreach ($methodReflection->getVariants() as $methodVariant) { foreach ($methodVariant->getParameters() as $parameter) { if ($parameter->getOutType() !== null) { foreach ($parameter->getOutType()->getReferencedClasses() as $referencedClass) { $this->addClassToDependencies($referencedClass, $dependenciesReflections); } } if ($parameter->getClosureThisType() === null) { continue; } foreach ($parameter->getClosureThisType()->getReferencedClasses() as $referencedClass) { $this->addClassToDependencies($referencedClass, $dependenciesReflections); } } } foreach ($methodReflection->getAsserts()->getAll() as $assertTag) { foreach ($assertTag->getType()->getReferencedClasses() as $referencedClass) { $this->addClassToDependencies($referencedClass, $dependenciesReflections); } foreach ($assertTag->getOriginalType()->getReferencedClasses() as $referencedClass) { $this->addClassToDependencies($referencedClass, $dependenciesReflections); } } if ($methodReflection->getSelfOutType() !== null) { foreach ($methodReflection->getSelfOutType()->getReferencedClasses() as $referencedClass) { $this->addClassToDependencies($referencedClass, $dependenciesReflections); } } } } } elseif ($node instanceof Node\Expr\PropertyFetch) { $fetchedOnType = $scope->getType($node->var); $classNames = $fetchedOnType->getReferencedClasses(); foreach ($classNames as $className) { $this->addClassToDependencies($className, $dependenciesReflections); } $propertyType = $scope->getType($node); foreach ($propertyType->getReferencedClasses() as $referencedClass) { $this->addClassToDependencies($referencedClass, $dependenciesReflections); } if ($node->name instanceof Node\Identifier) { $propertyReflection = $scope->getPropertyReflection($fetchedOnType, $node->name->toString()); if ($propertyReflection !== null) { $this->addClassToDependencies($propertyReflection->getDeclaringClass()->getName(), $dependenciesReflections); } } } elseif ($node instanceof Node\Expr\StaticCall) { if ($node->class instanceof Node\Name) { $this->addClassToDependencies($scope->resolveName($node->class), $dependenciesReflections); } else { foreach ($scope->getType($node->class)->getReferencedClasses() as $referencedClass) { $this->addClassToDependencies($referencedClass, $dependenciesReflections); } } $returnType = $scope->getType($node); foreach ($returnType->getReferencedClasses() as $referencedClass) { $this->addClassToDependencies($referencedClass, $dependenciesReflections); } if ($node->name instanceof Node\Identifier) { if ($node->class instanceof Node\Name) { $className = $scope->resolveName($node->class); if ($this->reflectionProvider->hasClass($className)) { $methodClassReflection = $this->reflectionProvider->getClass($className); if ($methodClassReflection->hasMethod($node->name->toString())) { $methodReflection = $methodClassReflection->getMethod($node->name->toString(), $scope); $this->addClassToDependencies($methodReflection->getDeclaringClass()->getName(), $dependenciesReflections); foreach ($methodReflection->getVariants() as $methodVariant) { foreach ($methodVariant->getParameters() as $parameter) { if ($parameter->getOutType() !== null) { foreach ($parameter->getOutType()->getReferencedClasses() as $referencedClass) { $this->addClassToDependencies($referencedClass, $dependenciesReflections); } } if ($parameter->getClosureThisType() === null) { continue; } foreach ($parameter->getClosureThisType()->getReferencedClasses() as $referencedClass) { $this->addClassToDependencies($referencedClass, $dependenciesReflections); } } } } } } else { $methodReflection = $scope->getMethodReflection($scope->getType($node->class), $node->name->toString()); if ($methodReflection !== null) { $this->addClassToDependencies($methodReflection->getDeclaringClass()->getName(), $dependenciesReflections); foreach ($methodReflection->getVariants() as $methodVariant) { foreach ($methodVariant->getParameters() as $parameter) { if ($parameter->getOutType() !== null) { foreach ($parameter->getOutType()->getReferencedClasses() as $referencedClass) { $this->addClassToDependencies($referencedClass, $dependenciesReflections); } } if ($parameter->getClosureThisType() === null) { continue; } foreach ($parameter->getClosureThisType()->getReferencedClasses() as $referencedClass) { $this->addClassToDependencies($referencedClass, $dependenciesReflections); } } } } } } } elseif ($node instanceof Node\Expr\ClassConstFetch) { if ($node->class instanceof Node\Name) { $this->addClassToDependencies($scope->resolveName($node->class), $dependenciesReflections); } else { foreach ($scope->getType($node->class)->getReferencedClasses() as $referencedClass) { $this->addClassToDependencies($referencedClass, $dependenciesReflections); } } $returnType = $scope->getType($node); foreach ($returnType->getReferencedClasses() as $referencedClass) { $this->addClassToDependencies($referencedClass, $dependenciesReflections); } if ($node->name instanceof Node\Identifier && $node->name->toLowerString() !== 'class') { if ($node->class instanceof Node\Name) { $className = $scope->resolveName($node->class); if ($this->reflectionProvider->hasClass($className)) { $constantClassReflection = $this->reflectionProvider->getClass($className); if ($constantClassReflection->hasConstant($node->name->toString())) { $constantReflection = $constantClassReflection->getConstant($node->name->toString()); $this->addClassToDependencies($constantReflection->getDeclaringClass()->getName(), $dependenciesReflections); } } } else { $constantReflection = $scope->getConstantReflection($scope->getType($node->class), $node->name->toString()); if ($constantReflection !== null) { $this->addClassToDependencies($constantReflection->getDeclaringClass()->getName(), $dependenciesReflections); } } } } elseif ($node instanceof Node\Expr\StaticPropertyFetch) { if ($node->class instanceof Node\Name) { $this->addClassToDependencies($scope->resolveName($node->class), $dependenciesReflections); } else { foreach ($scope->getType($node->class)->getReferencedClasses() as $referencedClass) { $this->addClassToDependencies($referencedClass, $dependenciesReflections); } } $returnType = $scope->getType($node); foreach ($returnType->getReferencedClasses() as $referencedClass) { $this->addClassToDependencies($referencedClass, $dependenciesReflections); } if ($node->name instanceof Node\Identifier) { if ($node->class instanceof Node\Name) { $className = $scope->resolveName($node->class); if ($this->reflectionProvider->hasClass($className)) { $propertyClassReflection = $this->reflectionProvider->getClass($className); if ($propertyClassReflection->hasProperty($node->name->toString())) { $propertyReflection = $propertyClassReflection->getProperty($node->name->toString(), $scope); $this->addClassToDependencies($propertyReflection->getDeclaringClass()->getName(), $dependenciesReflections); } } } else { $propertyReflection = $scope->getPropertyReflection($scope->getType($node->class), $node->name->toString()); if ($propertyReflection !== null) { $this->addClassToDependencies($propertyReflection->getDeclaringClass()->getName(), $dependenciesReflections); } } } } elseif ($node instanceof Node\Expr\New_ && $node->class instanceof Node\Name) { $this->addClassToDependencies($scope->resolveName($node->class), $dependenciesReflections); } elseif ($node instanceof Node\Stmt\Trait_ && $node->namespacedName !== null) { try { $classReflection = $this->reflectionProvider->getClass($node->namespacedName->toString()); foreach ($classReflection->getRequireImplementsTags() as $implementsTag) { foreach ($implementsTag->getType()->getReferencedClasses() as $referencedClass) { if (!$this->reflectionProvider->hasClass($referencedClass)) { continue; } $this->addClassToDependencies($referencedClass, $dependenciesReflections); } } } catch (ClassNotFoundException $e) { // pass } } elseif ($node instanceof Node\Stmt\TraitUse) { foreach ($node->traits as $traitName) { $this->addClassToDependencies($traitName->toString(), $dependenciesReflections); } $docComment = $node->getDocComment(); if ($docComment !== null) { $usesTags = $this->fileTypeMapper->getResolvedPhpDoc($scope->getFile(), $scope->isInClass() ? $scope->getClassReflection()->getName() : null, $scope->isInTrait() ? $scope->getTraitReflection()->getName() : null, null, $docComment->getText())->getUsesTags(); foreach ($usesTags as $usesTag) { foreach ($usesTag->getType()->getReferencedClasses() as $referencedClass) { $this->addClassToDependencies($referencedClass, $dependenciesReflections); } } } } elseif ($node instanceof Node\Expr\Instanceof_) { if ($node->class instanceof Name) { $this->addClassToDependencies($scope->resolveName($node->class), $dependenciesReflections); } } elseif ($node instanceof Node\Stmt\Catch_) { foreach ($node->types as $type) { $this->addClassToDependencies($scope->resolveName($type), $dependenciesReflections); } } elseif ($node instanceof ArrayDimFetch && $node->dim !== null) { $varType = $scope->getType($node->var); $dimType = $scope->getType($node->dim); foreach ($varType->getOffsetValueType($dimType)->getReferencedClasses() as $referencedClass) { $this->addClassToDependencies($referencedClass, $dependenciesReflections); } } elseif ($node instanceof Foreach_) { $exprType = $scope->getType($node->expr); if ($node->keyVar !== null) { foreach ($scope->getIterableKeyType($exprType)->getReferencedClasses() as $referencedClass) { $this->addClassToDependencies($referencedClass, $dependenciesReflections); } } foreach ($scope->getIterableValueType($exprType)->getReferencedClasses() as $referencedClass) { $this->addClassToDependencies($referencedClass, $dependenciesReflections); } } elseif ($node instanceof Array_ && $this->considerArrayForCallableTest($scope, $node)) { $arrayType = $scope->getType($node); if (!$arrayType->isCallable()->no()) { foreach ($arrayType->getCallableParametersAcceptors($scope) as $variant) { $referencedClasses = $variant->getReturnType()->getReferencedClasses(); foreach ($referencedClasses as $referencedClass) { $this->addClassToDependencies($referencedClass, $dependenciesReflections); } } } } return new \PHPStan\Dependency\NodeDependencies($this->fileHelper, $dependenciesReflections, $this->exportedNodeResolver->resolve($scope->getFile(), $node)); } private function considerArrayForCallableTest(Scope $scope, Array_ $arrayNode) : bool { $items = $arrayNode->items; if (count($items) !== 2) { return \false; } if ($items[0] === null) { return \false; } $itemType = $scope->getType($items[0]->value); return $itemType->isClassStringType()->yes(); } /** * @param array<int, ClassReflection|FunctionReflection> $dependenciesReflections */ private function addClassToDependencies(string $className, array &$dependenciesReflections) : void { try { $classReflection = $this->reflectionProvider->getClass($className); } catch (ClassNotFoundException $e) { return; } do { $dependenciesReflections[] = $classReflection; foreach ($classReflection->getInterfaces() as $interface) { $dependenciesReflections[] = $interface; } foreach ($classReflection->getTraits() as $trait) { $dependenciesReflections[] = $trait; } foreach ($classReflection->getResolvedMixinTypes() as $mixinType) { foreach ($mixinType->getReferencedClasses() as $referencedClass) { if (!$this->reflectionProvider->hasClass($referencedClass)) { continue; } $dependenciesReflections[] = $this->reflectionProvider->getClass($referencedClass); } } foreach ($classReflection->getRequireExtendsTags() as $extendsTag) { foreach ($extendsTag->getType()->getReferencedClasses() as $referencedClass) { if (!$this->reflectionProvider->hasClass($referencedClass)) { continue; } $dependenciesReflections[] = $this->reflectionProvider->getClass($referencedClass); } } foreach ($classReflection->getTemplateTags() as $templateTag) { foreach ($templateTag->getBound()->getReferencedClasses() as $referencedClass) { if (!$this->reflectionProvider->hasClass($referencedClass)) { continue; } $dependenciesReflections[] = $this->reflectionProvider->getClass($referencedClass); } $default = $templateTag->getDefault(); if ($default === null) { continue; } foreach ($default->getReferencedClasses() as $referencedClass) { if (!$this->reflectionProvider->hasClass($referencedClass)) { continue; } $dependenciesReflections[] = $this->reflectionProvider->getClass($referencedClass); } } foreach ($classReflection->getPropertyTags() as $propertyTag) { if ($propertyTag->isReadable()) { foreach ($propertyTag->getReadableType()->getReferencedClasses() as $referencedClass) { if (!$this->reflectionProvider->hasClass($referencedClass)) { continue; } $dependenciesReflections[] = $this->reflectionProvider->getClass($referencedClass); } } if (!$propertyTag->isWritable()) { continue; } foreach ($propertyTag->getWritableType()->getReferencedClasses() as $referencedClass) { if (!$this->reflectionProvider->hasClass($referencedClass)) { continue; } $dependenciesReflections[] = $this->reflectionProvider->getClass($referencedClass); } } foreach ($classReflection->getMethodTags() as $methodTag) { foreach ($methodTag->getReturnType()->getReferencedClasses() as $referencedClass) { if (!$this->reflectionProvider->hasClass($referencedClass)) { continue; } $dependenciesReflections[] = $this->reflectionProvider->getClass($referencedClass); } foreach ($methodTag->getParameters() as $parameter) { foreach ($parameter->getType()->getReferencedClasses() as $referencedClass) { if (!$this->reflectionProvider->hasClass($referencedClass)) { continue; } $dependenciesReflections[] = $this->reflectionProvider->getClass($referencedClass); } if ($parameter->getDefaultValue() === null) { continue; } foreach ($parameter->getDefaultValue()->getReferencedClasses() as $referencedClass) { if (!$this->reflectionProvider->hasClass($referencedClass)) { continue; } $dependenciesReflections[] = $this->reflectionProvider->getClass($referencedClass); } } } foreach ($classReflection->getExtendsTags() as $extendsTag) { foreach ($extendsTag->getType()->getReferencedClasses() as $referencedClass) { if (!$this->reflectionProvider->hasClass($referencedClass)) { continue; } $dependenciesReflections[] = $this->reflectionProvider->getClass($referencedClass); } } foreach ($classReflection->getImplementsTags() as $implementsTag) { foreach ($implementsTag->getType()->getReferencedClasses() as $referencedClass) { if (!$this->reflectionProvider->hasClass($referencedClass)) { continue; } $dependenciesReflections[] = $this->reflectionProvider->getClass($referencedClass); } } $phpDoc = $classReflection->getResolvedPhpDoc(); if ($phpDoc !== null) { foreach ($phpDoc->getTypeAliasImportTags() as $importTag) { $dependenciesReflections[] = $this->reflectionProvider->getClass($importTag->getImportedFrom()); } } $classReflection = $classReflection->getParentClass(); } while ($classReflection !== null); } private function getFunctionReflection(Node\Name $nameNode, ?Scope $scope) : FunctionReflection { return $this->reflectionProvider->getFunction($nameNode, $scope); } /** * @param array<ClassReflection|FunctionReflection> $dependenciesReflections */ private function extractFromParametersAcceptor(ParametersAcceptorWithPhpDocs $parametersAcceptor, array &$dependenciesReflections) : void { foreach ($parametersAcceptor->getParameters() as $parameter) { $referencedClasses = array_merge($parameter->getNativeType()->getReferencedClasses(), $parameter->getPhpDocType()->getReferencedClasses()); foreach ($referencedClasses as $referencedClass) { $this->addClassToDependencies($referencedClass, $dependenciesReflections); } if ($parameter->getOutType() !== null) { foreach ($parameter->getOutType()->getReferencedClasses() as $referencedClass) { $this->addClassToDependencies($referencedClass, $dependenciesReflections); } } if ($parameter->getClosureThisType() === null) { continue; } foreach ($parameter->getClosureThisType()->getReferencedClasses() as $referencedClass) { $this->addClassToDependencies($referencedClass, $dependenciesReflections); } } $returnTypeReferencedClasses = array_merge($parametersAcceptor->getNativeReturnType()->getReferencedClasses(), $parametersAcceptor->getPhpDocReturnType()->getReferencedClasses()); foreach ($returnTypeReferencedClasses as $referencedClass) { $this->addClassToDependencies($referencedClass, $dependenciesReflections); } } /** * @param array<ClassReflection|FunctionReflection> $dependenciesReflections */ private function extractThrowType(?Type $throwType, array &$dependenciesReflections) : void { if ($throwType === null) { return; } foreach ($throwType->getReferencedClasses() as $referencedClass) { $this->addClassToDependencies($referencedClass, $dependenciesReflections); } } } <?php declare (strict_types=1); namespace PHPStan\Dependency; use PhpParser\Node; use PhpParser\Node\Name; use PhpParser\Node\Stmt\Class_; use PhpParser\Node\Stmt\ClassMethod; use PhpParser\Node\Stmt\Function_; use PHPStan\Dependency\ExportedNode\ExportedAttributeNode; use PHPStan\Dependency\ExportedNode\ExportedClassConstantNode; use PHPStan\Dependency\ExportedNode\ExportedClassConstantsNode; use PHPStan\Dependency\ExportedNode\ExportedClassNode; use PHPStan\Dependency\ExportedNode\ExportedEnumCaseNode; use PHPStan\Dependency\ExportedNode\ExportedEnumNode; use PHPStan\Dependency\ExportedNode\ExportedFunctionNode; use PHPStan\Dependency\ExportedNode\ExportedInterfaceNode; use PHPStan\Dependency\ExportedNode\ExportedMethodNode; use PHPStan\Dependency\ExportedNode\ExportedParameterNode; use PHPStan\Dependency\ExportedNode\ExportedPhpDocNode; use PHPStan\Dependency\ExportedNode\ExportedPropertiesNode; use PHPStan\Dependency\ExportedNode\ExportedTraitNode; use PHPStan\Dependency\ExportedNode\ExportedTraitUseAdaptation; use PHPStan\Node\Printer\ExprPrinter; use PHPStan\Node\Printer\NodeTypePrinter; use PHPStan\ShouldNotHappenException; use PHPStan\Type\FileTypeMapper; use function array_map; use function is_string; final class ExportedNodeResolver { /** * @var FileTypeMapper */ private $fileTypeMapper; /** * @var ExprPrinter */ private $exprPrinter; public function __construct(FileTypeMapper $fileTypeMapper, ExprPrinter $exprPrinter) { $this->fileTypeMapper = $fileTypeMapper; $this->exprPrinter = $exprPrinter; } public function resolve(string $fileName, Node $node) : ?\PHPStan\Dependency\RootExportedNode { if ($node instanceof Class_ && isset($node->namespacedName)) { $docComment = $node->getDocComment(); $extendsName = null; if ($node->extends !== null) { $extendsName = $node->extends->toString(); } $implementsNames = []; foreach ($node->implements as $className) { $implementsNames[] = $className->toString(); } $usedTraits = []; $adaptations = []; foreach ($node->getTraitUses() as $traitUse) { foreach ($traitUse->traits as $usedTraitName) { $usedTraits[] = $usedTraitName->toString(); } foreach ($traitUse->adaptations as $adaptation) { $adaptations[] = $adaptation; } } $className = $node->namespacedName->toString(); return new ExportedClassNode($className, $this->exportPhpDocNode($fileName, $className, null, $docComment !== null ? $docComment->getText() : null), $node->isAbstract(), $node->isFinal(), $extendsName, $implementsNames, $usedTraits, array_map(static function (Node\Stmt\TraitUseAdaptation $adaptation) : ExportedTraitUseAdaptation { if ($adaptation instanceof Node\Stmt\TraitUseAdaptation\Alias) { return ExportedTraitUseAdaptation::createAlias($adaptation->trait !== null ? $adaptation->trait->toString() : null, $adaptation->method->toString(), $adaptation->newModifier, $adaptation->newName !== null ? $adaptation->newName->toString() : null); } if ($adaptation instanceof Node\Stmt\TraitUseAdaptation\Precedence) { return ExportedTraitUseAdaptation::createPrecedence($adaptation->trait !== null ? $adaptation->trait->toString() : null, $adaptation->method->toString(), array_map(static function (Name $name) : string { return $name->toString(); }, $adaptation->insteadof)); } throw new ShouldNotHappenException(); }, $adaptations), $this->exportClassStatements($node->stmts, $fileName, $className), $this->exportAttributeNodes($node->attrGroups)); } if ($node instanceof Node\Stmt\Interface_ && isset($node->namespacedName)) { $extendsNames = array_map(static function (Name $name) : string { return (string) $name; }, $node->extends); $docComment = $node->getDocComment(); $interfaceName = $node->namespacedName->toString(); return new ExportedInterfaceNode($interfaceName, $this->exportPhpDocNode($fileName, $interfaceName, null, $docComment !== null ? $docComment->getText() : null), $extendsNames, $this->exportClassStatements($node->stmts, $fileName, $interfaceName)); } if ($node instanceof Node\Stmt\Enum_ && $node->namespacedName !== null) { $implementsNames = array_map(static function (Name $name) : string { return (string) $name; }, $node->implements); $docComment = $node->getDocComment(); $enumName = $node->namespacedName->toString(); $scalarType = null; if ($node->scalarType !== null) { $scalarType = $node->scalarType->toString(); } return new ExportedEnumNode($enumName, $scalarType, $this->exportPhpDocNode($fileName, $enumName, null, $docComment !== null ? $docComment->getText() : null), $implementsNames, $this->exportClassStatements($node->stmts, $fileName, $enumName), $this->exportAttributeNodes($node->attrGroups)); } if ($node instanceof Node\Stmt\Trait_ && isset($node->namespacedName)) { return new ExportedTraitNode($node->namespacedName->toString()); } if ($node instanceof Function_) { $functionName = $node->name->name; if (isset($node->namespacedName)) { $functionName = (string) $node->namespacedName; } $docComment = $node->getDocComment(); return new ExportedFunctionNode($functionName, $this->exportPhpDocNode($fileName, null, $functionName, $docComment !== null ? $docComment->getText() : null), $node->byRef, NodeTypePrinter::printType($node->returnType), $this->exportParameterNodes($node->params), $this->exportAttributeNodes($node->attrGroups)); } return null; } /** * @param Node\Param[] $params * @return ExportedParameterNode[] */ private function exportParameterNodes(array $params) : array { $nodes = []; foreach ($params as $param) { if (!$param->var instanceof Node\Expr\Variable || !is_string($param->var->name)) { throw new ShouldNotHappenException(); } $type = $param->type; if ($type !== null && $param->default instanceof Node\Expr\ConstFetch && $param->default->name->toLowerString() === 'null') { if ($type instanceof Node\UnionType) { $innerTypes = $type->types; $innerTypes[] = new Name('null'); $type = new Node\UnionType($innerTypes); } elseif ($type instanceof Node\Identifier || $type instanceof Name) { $type = new Node\NullableType($type); } } $nodes[] = new ExportedParameterNode($param->var->name, NodeTypePrinter::printType($type), $param->byRef, $param->variadic, $param->default !== null, $this->exportAttributeNodes($param->attrGroups)); } return $nodes; } private function exportPhpDocNode(string $file, ?string $className, ?string $functionName, ?string $text) : ?ExportedPhpDocNode { if ($text === null) { return null; } $resolvedPhpDocBlock = $this->fileTypeMapper->getResolvedPhpDoc($file, $className, null, $functionName, $text); $nameScope = $resolvedPhpDocBlock->getNullableNameScope(); if ($nameScope === null) { return null; } return new ExportedPhpDocNode($text, $nameScope->getNamespace(), $nameScope->getUses(), $nameScope->getConstUses()); } /** * @param Node\Stmt[] $statements * @return ExportedNode[] */ private function exportClassStatements(array $statements, string $fileName, string $namespacedName) : array { $exportedNodes = []; foreach ($statements as $statement) { $exportedNode = $this->exportClassStatement($statement, $fileName, $namespacedName); if ($exportedNode === null) { continue; } $exportedNodes[] = $exportedNode; } return $exportedNodes; } private function exportClassStatement(Node\Stmt $node, string $fileName, string $namespacedName) : ?\PHPStan\Dependency\ExportedNode { if ($node instanceof ClassMethod) { if ($node->isAbstract() || $node->isFinal() || !$node->isPrivate()) { $methodName = $node->name->toString(); $docComment = $node->getDocComment(); return new ExportedMethodNode($methodName, $this->exportPhpDocNode($fileName, $namespacedName, $methodName, $docComment !== null ? $docComment->getText() : null), $node->byRef, $node->isPublic(), $node->isPrivate(), $node->isAbstract(), $node->isFinal(), $node->isStatic(), NodeTypePrinter::printType($node->returnType), $this->exportParameterNodes($node->params), $this->exportAttributeNodes($node->attrGroups)); } } if ($node instanceof Node\Stmt\Property) { if ($node->isPrivate()) { return null; } $docComment = $node->getDocComment(); return new ExportedPropertiesNode(array_map(static function (Node\Stmt\PropertyProperty $prop) : string { return $prop->name->toString(); }, $node->props), $this->exportPhpDocNode($fileName, $namespacedName, null, $docComment !== null ? $docComment->getText() : null), NodeTypePrinter::printType($node->type), $node->isPublic(), $node->isPrivate(), $node->isStatic(), $node->isReadonly(), $this->exportAttributeNodes($node->attrGroups)); } if ($node instanceof Node\Stmt\ClassConst) { if ($node->isPrivate()) { return null; } $docComment = $node->getDocComment(); $constants = []; foreach ($node->consts as $const) { $constants[] = new ExportedClassConstantNode($const->name->toString(), $this->exprPrinter->printExpr($const->value), $this->exportAttributeNodes($node->attrGroups)); } return new ExportedClassConstantsNode($constants, $node->isPublic(), $node->isPrivate(), $node->isFinal(), $this->exportPhpDocNode($fileName, $namespacedName, null, $docComment !== null ? $docComment->getText() : null)); } if ($node instanceof Node\Stmt\EnumCase) { $docComment = $node->getDocComment(); return new ExportedEnumCaseNode($node->name->toString(), $node->expr !== null ? $this->exprPrinter->printExpr($node->expr) : null, $this->exportPhpDocNode($fileName, $namespacedName, null, $docComment !== null ? $docComment->getText() : null)); } return null; } /** * @param Node\AttributeGroup[] $attributeGroups * @return ExportedAttributeNode[] */ private function exportAttributeNodes(array $attributeGroups) : array { $nodes = []; foreach ($attributeGroups as $attributeGroup) { foreach ($attributeGroup->attrs as $attribute) { $args = []; foreach ($attribute->args as $i => $arg) { $args[$arg->name->name ?? $i] = $this->exprPrinter->printExpr($arg->value); } $nodes[] = new ExportedAttributeNode($attribute->name->toString(), $args); } } return $nodes; } } <?php declare (strict_types=1); namespace PHPStan\Dependency; interface ExportedNode { public function equals(self $node) : bool; /** * @param mixed[] $properties */ public static function __set_state(array $properties) : self; /** * @param mixed[] $data */ public static function decode(array $data) : self; } <?php declare (strict_types=1); namespace PHPStan\Dependency; use PhpParser\NodeTraverser; use PHPStan\Parser\Parser; use PHPStan\Parser\ParserErrorsException; final class ExportedNodeFetcher { /** * @var Parser */ private $parser; /** * @var ExportedNodeVisitor */ private $visitor; public function __construct(Parser $parser, \PHPStan\Dependency\ExportedNodeVisitor $visitor) { $this->parser = $parser; $this->visitor = $visitor; } /** * @return RootExportedNode[] */ public function fetchNodes(string $fileName) : array { $nodeTraverser = new NodeTraverser(); $nodeTraverser->addVisitor($this->visitor); try { $ast = $this->parser->parseFile($fileName); } catch (ParserErrorsException $e) { return []; } $this->visitor->reset($fileName); $nodeTraverser->traverse($ast); return $this->visitor->getExportedNodes(); } } <?php declare (strict_types=1); namespace PHPStan\Dependency; use PhpParser\Node; use PhpParser\NodeTraverser; use PhpParser\NodeVisitorAbstract; use PHPStan\ShouldNotHappenException; final class ExportedNodeVisitor extends NodeVisitorAbstract { /** * @var ExportedNodeResolver */ private $exportedNodeResolver; /** * @var ?string */ private $fileName = null; /** @var RootExportedNode[] */ private $currentNodes = []; /** * ExportedNodeVisitor constructor. * */ public function __construct(\PHPStan\Dependency\ExportedNodeResolver $exportedNodeResolver) { $this->exportedNodeResolver = $exportedNodeResolver; } public function reset(string $fileName) : void { $this->fileName = $fileName; $this->currentNodes = []; } /** * @return RootExportedNode[] */ public function getExportedNodes() : array { return $this->currentNodes; } public function enterNode(Node $node) : ?int { if ($this->fileName === null) { throw new ShouldNotHappenException(); } $exportedNode = $this->exportedNodeResolver->resolve($this->fileName, $node); if ($exportedNode !== null) { $this->currentNodes[] = $exportedNode; } if ($node instanceof Node\Stmt\ClassMethod || $node instanceof Node\Stmt\Function_ || $node instanceof Node\Stmt\Trait_) { return NodeTraverser::DONT_TRAVERSE_CHILDREN; } return null; } } <?php declare (strict_types=1); namespace PHPStan\Dependency; use PHPStan\File\FileHelper; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\FunctionReflection; use function array_values; final class NodeDependencies { /** * @var FileHelper */ private $fileHelper; /** * @var array<int, ClassReflection|FunctionReflection> */ private $reflections; /** * @var ?RootExportedNode */ private $exportedNode; /** * @param array<int, ClassReflection|FunctionReflection> $reflections */ public function __construct(FileHelper $fileHelper, array $reflections, ?\PHPStan\Dependency\RootExportedNode $exportedNode) { $this->fileHelper = $fileHelper; $this->reflections = $reflections; $this->exportedNode = $exportedNode; } /** * @param array<string, true> $analysedFiles * @return string[] */ public function getFileDependencies(string $currentFile, array $analysedFiles) : array { $dependencies = []; foreach ($this->reflections as $dependencyReflection) { $dependencyFile = $dependencyReflection->getFileName(); if ($dependencyFile === null) { continue; } $dependencyFile = $this->fileHelper->normalizePath($dependencyFile); if ($currentFile === $dependencyFile) { continue; } if (!isset($analysedFiles[$dependencyFile])) { continue; } $dependencies[$dependencyFile] = $dependencyFile; } return array_values($dependencies); } public function getExportedNode() : ?\PHPStan\Dependency\RootExportedNode { return $this->exportedNode; } } <?php declare (strict_types=1); namespace PHPStan; /** * @return array<int, callable(string): void> */ function autoloadFunctions() : array { return $GLOBALS['__phpstanAutoloadFunctions'] ?? []; } <?php declare (strict_types=1); namespace PHPStan\Analyser; use PhpParser\Node\Scalar\LNumber; use PhpParser\Node\Stmt; /** * @api * @final */ class StatementResult { /** * @var MutatingScope */ private $scope; /** * @var bool */ private $hasYield; /** * @var bool */ private $isAlwaysTerminating; /** * @var StatementExitPoint[] */ private $exitPoints; /** * @var ThrowPoint[] */ private $throwPoints; /** * @var ImpurePoint[] */ private $impurePoints; /** * @var EndStatementResult[] */ private $endStatements; /** * @param StatementExitPoint[] $exitPoints * @param ThrowPoint[] $throwPoints * @param ImpurePoint[] $impurePoints * @param EndStatementResult[] $endStatements */ public function __construct(\PHPStan\Analyser\MutatingScope $scope, bool $hasYield, bool $isAlwaysTerminating, array $exitPoints, array $throwPoints, array $impurePoints, array $endStatements = []) { $this->scope = $scope; $this->hasYield = $hasYield; $this->isAlwaysTerminating = $isAlwaysTerminating; $this->exitPoints = $exitPoints; $this->throwPoints = $throwPoints; $this->impurePoints = $impurePoints; $this->endStatements = $endStatements; } public function getScope() : \PHPStan\Analyser\MutatingScope { return $this->scope; } public function hasYield() : bool { return $this->hasYield; } public function isAlwaysTerminating() : bool { return $this->isAlwaysTerminating; } public function filterOutLoopExitPoints() : self { if (!$this->isAlwaysTerminating) { return $this; } foreach ($this->exitPoints as $exitPoint) { $statement = $exitPoint->getStatement(); if (!$statement instanceof Stmt\Break_ && !$statement instanceof Stmt\Continue_) { continue; } $num = $statement->num; if (!$num instanceof LNumber) { return new self($this->scope, $this->hasYield, \false, $this->exitPoints, $this->throwPoints, $this->impurePoints); } if ($num->value !== 1) { continue; } return new self($this->scope, $this->hasYield, \false, $this->exitPoints, $this->throwPoints, $this->impurePoints); } return $this; } /** * @return StatementExitPoint[] */ public function getExitPoints() : array { return $this->exitPoints; } /** * @param class-string<Stmt\Continue_>|class-string<Stmt\Break_> $stmtClass * @return StatementExitPoint[] */ public function getExitPointsByType(string $stmtClass) : array { $exitPoints = []; foreach ($this->exitPoints as $exitPoint) { $statement = $exitPoint->getStatement(); if (!$statement instanceof $stmtClass) { continue; } $value = $statement->num; if ($value === null) { $exitPoints[] = $exitPoint; continue; } if (!$value instanceof LNumber) { $exitPoints[] = $exitPoint; continue; } $value = $value->value; if ($value !== 1) { continue; } $exitPoints[] = $exitPoint; } return $exitPoints; } /** * @return StatementExitPoint[] */ public function getExitPointsForOuterLoop() : array { $exitPoints = []; foreach ($this->exitPoints as $exitPoint) { $statement = $exitPoint->getStatement(); if (!$statement instanceof Stmt\Continue_ && !$statement instanceof Stmt\Break_) { $exitPoints[] = $exitPoint; continue; } if ($statement->num === null) { continue; } if (!$statement->num instanceof LNumber) { continue; } $value = $statement->num->value; if ($value === 1) { continue; } $newNode = null; if ($value > 2) { $newNode = new LNumber($value - 1); } if ($statement instanceof Stmt\Continue_) { $newStatement = new Stmt\Continue_($newNode); } else { $newStatement = new Stmt\Break_($newNode); } $exitPoints[] = new \PHPStan\Analyser\StatementExitPoint($newStatement, $exitPoint->getScope()); } return $exitPoints; } /** * @return ThrowPoint[] */ public function getThrowPoints() : array { return $this->throwPoints; } /** * @return ImpurePoint[] */ public function getImpurePoints() : array { return $this->impurePoints; } /** * Top-level StatementResult represents the state of the code * at the end of control flow statements like If_ or TryCatch. * * It shows how Scope etc. looks like after If_ no matter * which code branch was executed. * * For If_, "end statements" contain the state of the code * at the end of each branch - if, elseifs, else, including the last * statement node in each branch. * * For nested ifs, end statements try to contain the last non-control flow * statement like Return_ or Throw_, instead of If_, TryCatch, or Foreach_. * * @return EndStatementResult[] */ public function getEndStatements() : array { return $this->endStatements; } } <?php declare (strict_types=1); namespace PHPStan\Analyser; final class ExpressionResult { /** * @var MutatingScope */ private $scope; /** * @var bool */ private $hasYield; /** * @var ThrowPoint[] */ private $throwPoints; /** * @var ImpurePoint[] */ private $impurePoints; /** @var (callable(): MutatingScope)|null */ private $truthyScopeCallback; /** * @var ?MutatingScope */ private $truthyScope = null; /** @var (callable(): MutatingScope)|null */ private $falseyScopeCallback; /** * @var ?MutatingScope */ private $falseyScope = null; /** * @param ThrowPoint[] $throwPoints * @param ImpurePoint[] $impurePoints * @param (callable(): MutatingScope)|null $truthyScopeCallback * @param (callable(): MutatingScope)|null $falseyScopeCallback */ public function __construct(\PHPStan\Analyser\MutatingScope $scope, bool $hasYield, array $throwPoints, array $impurePoints, ?callable $truthyScopeCallback = null, ?callable $falseyScopeCallback = null) { $this->scope = $scope; $this->hasYield = $hasYield; $this->throwPoints = $throwPoints; $this->impurePoints = $impurePoints; $this->truthyScopeCallback = $truthyScopeCallback; $this->falseyScopeCallback = $falseyScopeCallback; } public function getScope() : \PHPStan\Analyser\MutatingScope { return $this->scope; } public function hasYield() : bool { return $this->hasYield; } /** * @return ThrowPoint[] */ public function getThrowPoints() : array { return $this->throwPoints; } /** * @return ImpurePoint[] */ public function getImpurePoints() : array { return $this->impurePoints; } public function getTruthyScope() : \PHPStan\Analyser\MutatingScope { if ($this->truthyScopeCallback === null) { return $this->scope; } if ($this->truthyScope !== null) { return $this->truthyScope; } $callback = $this->truthyScopeCallback; $this->truthyScope = $callback(); return $this->truthyScope; } public function getFalseyScope() : \PHPStan\Analyser\MutatingScope { if ($this->falseyScopeCallback === null) { return $this->scope; } if ($this->falseyScope !== null) { return $this->falseyScope; } $callback = $this->falseyScopeCallback; $this->falseyScope = $callback(); return $this->falseyScope; } } <?php declare (strict_types=1); namespace PHPStan\Analyser; use PHPStan\DependencyInjection\Type\DynamicReturnTypeExtensionRegistryProvider; use PHPStan\DependencyInjection\Type\ExpressionTypeResolverExtensionRegistryProvider; use PHPStan\Node\Printer\ExprPrinter; use PHPStan\Parser\Parser; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\InitializerExprTypeResolver; use PHPStan\Reflection\MethodReflection; use PHPStan\Reflection\ParameterReflection; use PHPStan\Reflection\ParametersAcceptor; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\Properties\PropertyReflectionFinder; use PHPStan\ShouldNotHappenException; use function is_a; final class DirectInternalScopeFactory implements \PHPStan\Analyser\InternalScopeFactory { /** * @var class-string */ private $scopeClass; /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var InitializerExprTypeResolver */ private $initializerExprTypeResolver; /** * @var DynamicReturnTypeExtensionRegistryProvider */ private $dynamicReturnTypeExtensionRegistryProvider; /** * @var ExpressionTypeResolverExtensionRegistryProvider */ private $expressionTypeResolverExtensionRegistryProvider; /** * @var ExprPrinter */ private $exprPrinter; /** * @var TypeSpecifier */ private $typeSpecifier; /** * @var PropertyReflectionFinder */ private $propertyReflectionFinder; /** * @var Parser */ private $parser; /** * @var NodeScopeResolver */ private $nodeScopeResolver; /** * @var RicherScopeGetTypeHelper */ private $richerScopeGetTypeHelper; /** * @var PhpVersion */ private $phpVersion; /** * @var bool */ private $explicitMixedInUnknownGenericNew; /** * @var bool */ private $explicitMixedForGlobalVariables; /** * @var ConstantResolver */ private $constantResolver; /** * @param class-string $scopeClass */ public function __construct(string $scopeClass, ReflectionProvider $reflectionProvider, InitializerExprTypeResolver $initializerExprTypeResolver, DynamicReturnTypeExtensionRegistryProvider $dynamicReturnTypeExtensionRegistryProvider, ExpressionTypeResolverExtensionRegistryProvider $expressionTypeResolverExtensionRegistryProvider, ExprPrinter $exprPrinter, \PHPStan\Analyser\TypeSpecifier $typeSpecifier, PropertyReflectionFinder $propertyReflectionFinder, Parser $parser, \PHPStan\Analyser\NodeScopeResolver $nodeScopeResolver, \PHPStan\Analyser\RicherScopeGetTypeHelper $richerScopeGetTypeHelper, PhpVersion $phpVersion, bool $explicitMixedInUnknownGenericNew, bool $explicitMixedForGlobalVariables, \PHPStan\Analyser\ConstantResolver $constantResolver) { $this->scopeClass = $scopeClass; $this->reflectionProvider = $reflectionProvider; $this->initializerExprTypeResolver = $initializerExprTypeResolver; $this->dynamicReturnTypeExtensionRegistryProvider = $dynamicReturnTypeExtensionRegistryProvider; $this->expressionTypeResolverExtensionRegistryProvider = $expressionTypeResolverExtensionRegistryProvider; $this->exprPrinter = $exprPrinter; $this->typeSpecifier = $typeSpecifier; $this->propertyReflectionFinder = $propertyReflectionFinder; $this->parser = $parser; $this->nodeScopeResolver = $nodeScopeResolver; $this->richerScopeGetTypeHelper = $richerScopeGetTypeHelper; $this->phpVersion = $phpVersion; $this->explicitMixedInUnknownGenericNew = $explicitMixedInUnknownGenericNew; $this->explicitMixedForGlobalVariables = $explicitMixedForGlobalVariables; $this->constantResolver = $constantResolver; } /** * @param array<string, ExpressionTypeHolder> $expressionTypes * @param array<string, ExpressionTypeHolder> $nativeExpressionTypes * @param array<string, ConditionalExpressionHolder[]> $conditionalExpressions * @param list<array{FunctionReflection|MethodReflection|null, ParameterReflection|null}> $inFunctionCallsStack * @param array<string, true> $currentlyAssignedExpressions * @param array<string, true> $currentlyAllowedUndefinedExpressions * @param FunctionReflection|MethodReflection|null $function */ public function create(\PHPStan\Analyser\ScopeContext $context, bool $declareStrictTypes = \false, $function = null, ?string $namespace = null, array $expressionTypes = [], array $nativeExpressionTypes = [], array $conditionalExpressions = [], array $inClosureBindScopeClasses = [], ?ParametersAcceptor $anonymousFunctionReflection = null, bool $inFirstLevelStatement = \true, array $currentlyAssignedExpressions = [], array $currentlyAllowedUndefinedExpressions = [], array $inFunctionCallsStack = [], bool $afterExtractCall = \false, ?\PHPStan\Analyser\Scope $parentScope = null, bool $nativeTypesPromoted = \false) : \PHPStan\Analyser\MutatingScope { $scopeClass = $this->scopeClass; if (!is_a($scopeClass, \PHPStan\Analyser\MutatingScope::class, \true)) { throw new ShouldNotHappenException(); } return new $scopeClass($this, $this->reflectionProvider, $this->initializerExprTypeResolver, $this->dynamicReturnTypeExtensionRegistryProvider->getRegistry(), $this->expressionTypeResolverExtensionRegistryProvider->getRegistry(), $this->exprPrinter, $this->typeSpecifier, $this->propertyReflectionFinder, $this->parser, $this->nodeScopeResolver, $this->richerScopeGetTypeHelper, $this->constantResolver, $context, $this->phpVersion, $declareStrictTypes, $function, $namespace, $expressionTypes, $nativeExpressionTypes, $conditionalExpressions, $inClosureBindScopeClasses, $anonymousFunctionReflection, $inFirstLevelStatement, $currentlyAssignedExpressions, $currentlyAllowedUndefinedExpressions, $inFunctionCallsStack, $afterExtractCall, $parentScope, $nativeTypesPromoted, $this->explicitMixedInUnknownGenericNew, $this->explicitMixedForGlobalVariables); } } <?php declare (strict_types=1); namespace PHPStan\Analyser; use ArrayAccess; use Closure; use DivisionByZeroError; use PhpParser\Comment\Doc; use PhpParser\Node; use PhpParser\Node\Arg; use PhpParser\Node\AttributeGroup; use PhpParser\Node\Expr; use PhpParser\Node\Expr\Array_; use PhpParser\Node\Expr\ArrayDimFetch; use PhpParser\Node\Expr\ArrayItem; use PhpParser\Node\Expr\Assign; use PhpParser\Node\Expr\AssignRef; use PhpParser\Node\Expr\BinaryOp; use PhpParser\Node\Expr\BinaryOp\BooleanAnd; use PhpParser\Node\Expr\BinaryOp\BooleanOr; use PhpParser\Node\Expr\BinaryOp\Coalesce; use PhpParser\Node\Expr\BooleanNot; use PhpParser\Node\Expr\CallLike; use PhpParser\Node\Expr\Cast; use PhpParser\Node\Expr\ConstFetch; use PhpParser\Node\Expr\ErrorSuppress; use PhpParser\Node\Expr\Exit_; use PhpParser\Node\Expr\FuncCall; use PhpParser\Node\Expr\Instanceof_; use PhpParser\Node\Expr\List_; use PhpParser\Node\Expr\MethodCall; use PhpParser\Node\Expr\New_; use PhpParser\Node\Expr\PropertyFetch; use PhpParser\Node\Expr\StaticCall; use PhpParser\Node\Expr\StaticPropertyFetch; use PhpParser\Node\Expr\Ternary; use PhpParser\Node\Expr\Variable; use PhpParser\Node\Name; use PhpParser\Node\Stmt\Break_; use PhpParser\Node\Stmt\Class_; use PhpParser\Node\Stmt\Continue_; use PhpParser\Node\Stmt\Do_; use PhpParser\Node\Stmt\Echo_; use PhpParser\Node\Stmt\For_; use PhpParser\Node\Stmt\Foreach_; use PhpParser\Node\Stmt\If_; use PhpParser\Node\Stmt\InlineHTML; use PhpParser\Node\Stmt\Return_; use PhpParser\Node\Stmt\Static_; use PhpParser\Node\Stmt\Switch_; use PhpParser\Node\Stmt\Throw_; use PhpParser\Node\Stmt\TryCatch; use PhpParser\Node\Stmt\Unset_; use PhpParser\Node\Stmt\While_; use PhpParser\NodeFinder; use PhpParser\NodeTraverser; use PhpParser\NodeVisitor\CloningVisitor; use PhpParser\NodeVisitorAbstract; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionClass; use PHPStan\BetterReflection\Reflection\ReflectionEnum; use PHPStan\BetterReflection\Reflector\Reflector; use PHPStan\BetterReflection\SourceLocator\Ast\Strategy\NodeToReflection; use PHPStan\BetterReflection\SourceLocator\Located\LocatedSource; use PHPStan\DependencyInjection\Reflection\ClassReflectionExtensionRegistryProvider; use PHPStan\DependencyInjection\Type\DynamicThrowTypeExtensionProvider; use PHPStan\DependencyInjection\Type\ParameterClosureTypeExtensionProvider; use PHPStan\DependencyInjection\Type\ParameterOutTypeExtensionProvider; use PHPStan\File\FileHelper; use PHPStan\File\FileReader; use PHPStan\Node\BooleanAndNode; use PHPStan\Node\BooleanOrNode; use PHPStan\Node\BreaklessWhileLoopNode; use PHPStan\Node\CatchWithUnthrownExceptionNode; use PHPStan\Node\ClassConstantsNode; use PHPStan\Node\ClassMethodsNode; use PHPStan\Node\ClassPropertiesNode; use PHPStan\Node\ClassPropertyNode; use PHPStan\Node\ClassStatementsGatherer; use PHPStan\Node\ClosureReturnStatementsNode; use PHPStan\Node\DoWhileLoopConditionNode; use PHPStan\Node\ExecutionEndNode; use PHPStan\Node\Expr\AlwaysRememberedExpr; use PHPStan\Node\Expr\ExistingArrayDimFetch; use PHPStan\Node\Expr\GetIterableKeyTypeExpr; use PHPStan\Node\Expr\GetIterableValueTypeExpr; use PHPStan\Node\Expr\GetOffsetValueTypeExpr; use PHPStan\Node\Expr\OriginalPropertyTypeExpr; use PHPStan\Node\Expr\PropertyInitializationExpr; use PHPStan\Node\Expr\SetExistingOffsetValueTypeExpr; use PHPStan\Node\Expr\SetOffsetValueTypeExpr; use PHPStan\Node\Expr\TypeExpr; use PHPStan\Node\Expr\UnsetOffsetExpr; use PHPStan\Node\FinallyExitPointsNode; use PHPStan\Node\FunctionCallableNode; use PHPStan\Node\FunctionReturnStatementsNode; use PHPStan\Node\InArrowFunctionNode; use PHPStan\Node\InClassMethodNode; use PHPStan\Node\InClassNode; use PHPStan\Node\InClosureNode; use PHPStan\Node\InForeachNode; use PHPStan\Node\InFunctionNode; use PHPStan\Node\InstantiationCallableNode; use PHPStan\Node\InTraitNode; use PHPStan\Node\InvalidateExprNode; use PHPStan\Node\LiteralArrayItem; use PHPStan\Node\LiteralArrayNode; use PHPStan\Node\MatchExpressionArm; use PHPStan\Node\MatchExpressionArmBody; use PHPStan\Node\MatchExpressionArmCondition; use PHPStan\Node\MatchExpressionNode; use PHPStan\Node\MethodCallableNode; use PHPStan\Node\MethodReturnStatementsNode; use PHPStan\Node\NoopExpressionNode; use PHPStan\Node\PropertyAssignNode; use PHPStan\Node\ReturnStatement; use PHPStan\Node\StaticMethodCallableNode; use PHPStan\Node\UnreachableStatementNode; use PHPStan\Node\VariableAssignNode; use PHPStan\Node\VarTagChangedExpressionTypeNode; use PHPStan\Parser\ArrowFunctionArgVisitor; use PHPStan\Parser\ClosureArgVisitor; use PHPStan\Parser\ImmediatelyInvokedClosureVisitor; use PHPStan\Parser\Parser; use PHPStan\Php\PhpVersion; use PHPStan\PhpDoc\PhpDocInheritanceResolver; use PHPStan\PhpDoc\ResolvedPhpDocBlock; use PHPStan\PhpDoc\StubPhpDocProvider; use PHPStan\PhpDoc\Tag\VarTag; use PHPStan\Reflection\Assertions; use PHPStan\Reflection\Callables\CallableParametersAcceptor; use PHPStan\Reflection\Callables\SimpleImpurePoint; use PHPStan\Reflection\Callables\SimpleThrowPoint; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\InitializerExprTypeResolver; use PHPStan\Reflection\MethodReflection; use PHPStan\Reflection\Native\NativeMethodReflection; use PHPStan\Reflection\Native\NativeParameterReflection; use PHPStan\Reflection\ParameterReflection; use PHPStan\Reflection\ParameterReflectionWithPhpDocs; use PHPStan\Reflection\ParametersAcceptor; use PHPStan\Reflection\ParametersAcceptorSelector; use PHPStan\Reflection\ParametersAcceptorWithPhpDocs; use PHPStan\Reflection\Php\PhpFunctionFromParserNodeReflection; use PHPStan\Reflection\Php\PhpMethodFromParserNodeReflection; use PHPStan\Reflection\Php\PhpMethodReflection; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Reflection\SignatureMap\SignatureMapProvider; use PHPStan\Rules\Properties\ReadWritePropertiesExtensionProvider; use PHPStan\ShouldNotHappenException; use PHPStan\TrinaryLogic; use PHPStan\Type\Accessory\AccessoryArrayListType; use PHPStan\Type\Accessory\NonEmptyArrayType; use PHPStan\Type\ArrayType; use PHPStan\Type\ClosureType; use PHPStan\Type\Constant\ConstantArrayType; use PHPStan\Type\Constant\ConstantArrayTypeBuilder; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\ErrorType; use PHPStan\Type\FileTypeMapper; use PHPStan\Type\GeneralizePrecision; use PHPStan\Type\Generic\TemplateTypeHelper; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\Generic\TemplateTypeVariance; use PHPStan\Type\Generic\TemplateTypeVarianceMap; use PHPStan\Type\IntegerType; use PHPStan\Type\IntersectionType; use PHPStan\Type\MixedType; use PHPStan\Type\NeverType; use PHPStan\Type\NullType; use PHPStan\Type\ObjectType; use PHPStan\Type\ObjectWithoutClassType; use PHPStan\Type\ResourceType; use PHPStan\Type\StaticType; use PHPStan\Type\StaticTypeFactory; use PHPStan\Type\StringType; use PHPStan\Type\ThisType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\TypeTraverser; use PHPStan\Type\TypeUtils; use PHPStan\Type\UnionType; use ReflectionProperty; use Throwable; use Traversable; use TypeError; use UnhandledMatchError; use function array_fill_keys; use function array_filter; use function array_key_exists; use function array_key_last; use function array_keys; use function array_map; use function array_merge; use function array_pop; use function array_reverse; use function array_slice; use function array_values; use function base64_decode; use function count; use function in_array; use function is_array; use function is_int; use function is_string; use function ksort; use function sprintf; use function str_starts_with; use function strtolower; use function trim; use const PHP_VERSION_ID; use const SORT_NUMERIC; final class NodeScopeResolver { /** * @readonly * @var ReflectionProvider */ private $reflectionProvider; /** * @readonly * @var InitializerExprTypeResolver */ private $initializerExprTypeResolver; /** * @readonly * @var Reflector */ private $reflector; /** * @readonly * @var ClassReflectionExtensionRegistryProvider */ private $classReflectionExtensionRegistryProvider; /** * @readonly * @var ParameterOutTypeExtensionProvider */ private $parameterOutTypeExtensionProvider; /** * @readonly * @var Parser */ private $parser; /** * @readonly * @var FileTypeMapper */ private $fileTypeMapper; /** * @readonly * @var StubPhpDocProvider */ private $stubPhpDocProvider; /** * @readonly * @var PhpVersion */ private $phpVersion; /** * @readonly * @var SignatureMapProvider */ private $signatureMapProvider; /** * @readonly * @var PhpDocInheritanceResolver */ private $phpDocInheritanceResolver; /** * @readonly * @var FileHelper */ private $fileHelper; /** * @readonly * @var TypeSpecifier */ private $typeSpecifier; /** * @readonly * @var DynamicThrowTypeExtensionProvider */ private $dynamicThrowTypeExtensionProvider; /** * @readonly * @var ReadWritePropertiesExtensionProvider */ private $readWritePropertiesExtensionProvider; /** * @readonly * @var ParameterClosureTypeExtensionProvider */ private $parameterClosureTypeExtensionProvider; /** * @readonly * @var ScopeFactory */ private $scopeFactory; /** * @readonly * @var bool */ private $polluteScopeWithLoopInitialAssignments; /** * @readonly * @var bool */ private $polluteScopeWithAlwaysIterableForeach; /** * @readonly * @var string[][] */ private $earlyTerminatingMethodCalls; /** * @readonly * @var array<int, string> */ private $earlyTerminatingFunctionCalls; /** * @readonly * @var string[] */ private $universalObjectCratesClasses; /** * @readonly * @var bool */ private $implicitThrows; /** * @readonly * @var bool */ private $treatPhpDocTypesAsCertain; /** * @readonly * @var bool */ private $detectDeadTypeInMultiCatch; /** * @readonly * @var bool */ private $paramOutType; /** * @readonly * @var bool */ private $preciseMissingReturn; /** * @readonly * @var bool */ private $explicitThrow; private const LOOP_SCOPE_ITERATIONS = 3; private const GENERALIZE_AFTER_ITERATION = 1; /** @var bool[] filePath(string) => bool(true) */ private $analysedFiles = []; /** @var array<string, true> */ private $earlyTerminatingMethodNames; /** @var array<string, true> */ private $calledMethodStack = []; /** @var array<string, MutatingScope|null> */ private $calledMethodResults = []; /** * @param string[][] $earlyTerminatingMethodCalls className(string) => methods(string[]) * @param array<int, string> $earlyTerminatingFunctionCalls * @param string[] $universalObjectCratesClasses */ public function __construct(ReflectionProvider $reflectionProvider, InitializerExprTypeResolver $initializerExprTypeResolver, Reflector $reflector, ClassReflectionExtensionRegistryProvider $classReflectionExtensionRegistryProvider, ParameterOutTypeExtensionProvider $parameterOutTypeExtensionProvider, Parser $parser, FileTypeMapper $fileTypeMapper, StubPhpDocProvider $stubPhpDocProvider, PhpVersion $phpVersion, SignatureMapProvider $signatureMapProvider, PhpDocInheritanceResolver $phpDocInheritanceResolver, FileHelper $fileHelper, \PHPStan\Analyser\TypeSpecifier $typeSpecifier, DynamicThrowTypeExtensionProvider $dynamicThrowTypeExtensionProvider, ReadWritePropertiesExtensionProvider $readWritePropertiesExtensionProvider, ParameterClosureTypeExtensionProvider $parameterClosureTypeExtensionProvider, \PHPStan\Analyser\ScopeFactory $scopeFactory, bool $polluteScopeWithLoopInitialAssignments, bool $polluteScopeWithAlwaysIterableForeach, array $earlyTerminatingMethodCalls, array $earlyTerminatingFunctionCalls, array $universalObjectCratesClasses, bool $implicitThrows, bool $treatPhpDocTypesAsCertain, bool $detectDeadTypeInMultiCatch, bool $paramOutType, bool $preciseMissingReturn, bool $explicitThrow) { $this->reflectionProvider = $reflectionProvider; $this->initializerExprTypeResolver = $initializerExprTypeResolver; $this->reflector = $reflector; $this->classReflectionExtensionRegistryProvider = $classReflectionExtensionRegistryProvider; $this->parameterOutTypeExtensionProvider = $parameterOutTypeExtensionProvider; $this->parser = $parser; $this->fileTypeMapper = $fileTypeMapper; $this->stubPhpDocProvider = $stubPhpDocProvider; $this->phpVersion = $phpVersion; $this->signatureMapProvider = $signatureMapProvider; $this->phpDocInheritanceResolver = $phpDocInheritanceResolver; $this->fileHelper = $fileHelper; $this->typeSpecifier = $typeSpecifier; $this->dynamicThrowTypeExtensionProvider = $dynamicThrowTypeExtensionProvider; $this->readWritePropertiesExtensionProvider = $readWritePropertiesExtensionProvider; $this->parameterClosureTypeExtensionProvider = $parameterClosureTypeExtensionProvider; $this->scopeFactory = $scopeFactory; $this->polluteScopeWithLoopInitialAssignments = $polluteScopeWithLoopInitialAssignments; $this->polluteScopeWithAlwaysIterableForeach = $polluteScopeWithAlwaysIterableForeach; $this->earlyTerminatingMethodCalls = $earlyTerminatingMethodCalls; $this->earlyTerminatingFunctionCalls = $earlyTerminatingFunctionCalls; $this->universalObjectCratesClasses = $universalObjectCratesClasses; $this->implicitThrows = $implicitThrows; $this->treatPhpDocTypesAsCertain = $treatPhpDocTypesAsCertain; $this->detectDeadTypeInMultiCatch = $detectDeadTypeInMultiCatch; $this->paramOutType = $paramOutType; $this->preciseMissingReturn = $preciseMissingReturn; $this->explicitThrow = $explicitThrow; $earlyTerminatingMethodNames = []; foreach ($this->earlyTerminatingMethodCalls as $methodNames) { foreach ($methodNames as $methodName) { $earlyTerminatingMethodNames[strtolower($methodName)] = \true; } } $this->earlyTerminatingMethodNames = $earlyTerminatingMethodNames; } /** * @api * @param string[] $files */ public function setAnalysedFiles(array $files) : void { $this->analysedFiles = array_fill_keys($files, \true); } /** * @api * @param Node[] $nodes * @param callable(Node $node, Scope $scope): void $nodeCallback */ public function processNodes(array $nodes, \PHPStan\Analyser\MutatingScope $scope, callable $nodeCallback) : void { $alreadyTerminated = \false; foreach ($nodes as $i => $node) { if (!$node instanceof Node\Stmt || $alreadyTerminated && !($node instanceof Node\Stmt\Function_ || $node instanceof Node\Stmt\ClassLike)) { continue; } $statementResult = $this->processStmtNode($node, $scope, $nodeCallback, \PHPStan\Analyser\StatementContext::createTopLevel()); $scope = $statementResult->getScope(); if ($alreadyTerminated || !$statementResult->isAlwaysTerminating()) { continue; } $alreadyTerminated = \true; $nextStmt = $this->getFirstUnreachableNode(array_slice($nodes, $i + 1), \true); if (!$nextStmt instanceof Node\Stmt) { continue; } $nodeCallback(new UnreachableStatementNode($nextStmt), $scope); } } /** * @api * @param Node\Stmt[] $stmts * @param callable(Node $node, Scope $scope): void $nodeCallback */ public function processStmtNodes(Node $parentNode, array $stmts, \PHPStan\Analyser\MutatingScope $scope, callable $nodeCallback, ?\PHPStan\Analyser\StatementContext $context = null) : \PHPStan\Analyser\StatementResult { if ($context === null) { $context = \PHPStan\Analyser\StatementContext::createTopLevel(); } $exitPoints = []; $throwPoints = []; $impurePoints = []; $alreadyTerminated = \false; $hasYield = \false; $stmtCount = count($stmts); $shouldCheckLastStatement = $parentNode instanceof Node\Stmt\Function_ || $parentNode instanceof Node\Stmt\ClassMethod || $parentNode instanceof Expr\Closure; foreach ($stmts as $i => $stmt) { if ($alreadyTerminated && !($stmt instanceof Node\Stmt\Function_ || $stmt instanceof Node\Stmt\ClassLike)) { continue; } $isLast = $i === $stmtCount - 1; $statementResult = $this->processStmtNode($stmt, $scope, $nodeCallback, $context); $scope = $statementResult->getScope(); $hasYield = $hasYield || $statementResult->hasYield(); if ($shouldCheckLastStatement && $isLast) { /** @var Node\Stmt\Function_|Node\Stmt\ClassMethod|Expr\Closure $parentNode */ $parentNode = $parentNode; $endStatements = $statementResult->getEndStatements(); if ($this->preciseMissingReturn && count($endStatements) > 0) { foreach ($endStatements as $endStatement) { $endStatementResult = $endStatement->getResult(); $nodeCallback(new ExecutionEndNode($endStatement->getStatement(), new \PHPStan\Analyser\StatementResult($endStatementResult->getScope(), $hasYield, $endStatementResult->isAlwaysTerminating(), $endStatementResult->getExitPoints(), $endStatementResult->getThrowPoints(), $endStatementResult->getImpurePoints()), $parentNode->returnType !== null), $endStatementResult->getScope()); } } else { $nodeCallback(new ExecutionEndNode($stmt, new \PHPStan\Analyser\StatementResult($scope, $hasYield, $statementResult->isAlwaysTerminating(), $statementResult->getExitPoints(), $statementResult->getThrowPoints(), $statementResult->getImpurePoints()), $parentNode->returnType !== null), $scope); } } $exitPoints = array_merge($exitPoints, $statementResult->getExitPoints()); $throwPoints = array_merge($throwPoints, $statementResult->getThrowPoints()); $impurePoints = array_merge($impurePoints, $statementResult->getImpurePoints()); if ($alreadyTerminated || !$statementResult->isAlwaysTerminating()) { continue; } $alreadyTerminated = \true; $nextStmt = $this->getFirstUnreachableNode(array_slice($stmts, $i + 1), $parentNode instanceof Node\Stmt\Namespace_); if ($nextStmt === null) { continue; } $nodeCallback(new UnreachableStatementNode($nextStmt), $scope); } $statementResult = new \PHPStan\Analyser\StatementResult($scope, $hasYield, $alreadyTerminated, $exitPoints, $throwPoints, $impurePoints); if ($stmtCount === 0 && $shouldCheckLastStatement) { /** @var Node\Stmt\Function_|Node\Stmt\ClassMethod|Expr\Closure $parentNode */ $parentNode = $parentNode; $returnTypeNode = $parentNode->returnType; if ($parentNode instanceof Expr\Closure) { $parentNode = new Node\Stmt\Expression($parentNode, $parentNode->getAttributes()); } $nodeCallback(new ExecutionEndNode($parentNode, $statementResult, $returnTypeNode !== null), $scope); } return $statementResult; } /** * @param callable(Node $node, Scope $scope): void $nodeCallback */ private function processStmtNode(Node\Stmt $stmt, \PHPStan\Analyser\MutatingScope $scope, callable $nodeCallback, \PHPStan\Analyser\StatementContext $context) : \PHPStan\Analyser\StatementResult { if (!$stmt instanceof Static_ && !$stmt instanceof Foreach_ && !$stmt instanceof Node\Stmt\Global_ && !$stmt instanceof Node\Stmt\Property && !$stmt instanceof Node\Stmt\PropertyProperty && !$stmt instanceof Node\Stmt\ClassConst && !$stmt instanceof Node\Stmt\Const_) { $scope = $this->processStmtVarAnnotation($scope, $stmt, null, $nodeCallback); } if ($stmt instanceof Node\Stmt\ClassMethod) { if (!$scope->isInClass()) { throw new ShouldNotHappenException(); } if ($scope->isInTrait() && $scope->getClassReflection()->hasNativeMethod($stmt->name->toString())) { $methodReflection = $scope->getClassReflection()->getNativeMethod($stmt->name->toString()); if ($methodReflection instanceof NativeMethodReflection) { return new \PHPStan\Analyser\StatementResult($scope, \false, \false, [], [], []); } if ($methodReflection instanceof PhpMethodReflection) { $declaringTrait = $methodReflection->getDeclaringTrait(); if ($declaringTrait === null || $declaringTrait->getName() !== $scope->getTraitReflection()->getName()) { return new \PHPStan\Analyser\StatementResult($scope, \false, \false, [], [], []); } } } } $stmtScope = $scope; if ($stmt instanceof Throw_ || $stmt instanceof Return_) { $stmtScope = $this->processStmtVarAnnotation($scope, $stmt, $stmt->expr, $nodeCallback); } $nodeCallback($stmt, $stmtScope); $overridingThrowPoints = $this->getOverridingThrowPoints($stmt, $scope); if ($stmt instanceof Node\Stmt\Declare_) { $hasYield = \false; $throwPoints = []; $impurePoints = []; $alwaysTerminating = \false; $exitPoints = []; foreach ($stmt->declares as $declare) { $nodeCallback($declare, $scope); $nodeCallback($declare->value, $scope); if ($declare->key->name !== 'strict_types' || !$declare->value instanceof Node\Scalar\LNumber || $declare->value->value !== 1) { continue; } $scope = $scope->enterDeclareStrictTypes(); } if ($stmt->stmts !== null) { $result = $this->processStmtNodes($stmt, $stmt->stmts, $scope, $nodeCallback, $context); $scope = $result->getScope(); $hasYield = $result->hasYield(); $throwPoints = $result->getThrowPoints(); $impurePoints = $result->getImpurePoints(); $alwaysTerminating = $result->isAlwaysTerminating(); $exitPoints = $result->getExitPoints(); } return new \PHPStan\Analyser\StatementResult($scope, $hasYield, $alwaysTerminating, $exitPoints, $throwPoints, $impurePoints); } elseif ($stmt instanceof Node\Stmt\Function_) { $hasYield = \false; $throwPoints = []; $impurePoints = []; $this->processAttributeGroups($stmt, $stmt->attrGroups, $scope, $nodeCallback); [$templateTypeMap, $phpDocParameterTypes, $phpDocImmediatelyInvokedCallableParameters, $phpDocClosureThisTypeParameters, $phpDocReturnType, $phpDocThrowType, $deprecatedDescription, $isDeprecated, $isInternal, $isFinal, $isPure, $acceptsNamedArguments, , $phpDocComment, $asserts, , $phpDocParameterOutTypes] = $this->getPhpDocs($scope, $stmt); foreach ($stmt->params as $param) { $this->processParamNode($stmt, $param, $scope, $nodeCallback); } if ($stmt->returnType !== null) { $nodeCallback($stmt->returnType, $scope); } $functionScope = $scope->enterFunction($stmt, $templateTypeMap, $phpDocParameterTypes, $phpDocReturnType, $phpDocThrowType, $deprecatedDescription, $isDeprecated, $isInternal, $isFinal, $isPure, $acceptsNamedArguments, $asserts, $phpDocComment, $phpDocParameterOutTypes, $phpDocImmediatelyInvokedCallableParameters, $phpDocClosureThisTypeParameters); $functionReflection = $functionScope->getFunction(); if (!$functionReflection instanceof PhpFunctionFromParserNodeReflection) { throw new ShouldNotHappenException(); } $nodeCallback(new InFunctionNode($functionReflection, $stmt), $functionScope); $gatheredReturnStatements = []; $gatheredYieldStatements = []; $executionEnds = []; $functionImpurePoints = []; $statementResult = $this->processStmtNodes($stmt, $stmt->stmts, $functionScope, static function (Node $node, \PHPStan\Analyser\Scope $scope) use($nodeCallback, $functionScope, &$gatheredReturnStatements, &$gatheredYieldStatements, &$executionEnds, &$functionImpurePoints) : void { $nodeCallback($node, $scope); if ($scope->getFunction() !== $functionScope->getFunction()) { return; } if ($scope->isInAnonymousFunction()) { return; } if ($node instanceof PropertyAssignNode) { $functionImpurePoints[] = new \PHPStan\Analyser\ImpurePoint($scope, $node, 'propertyAssign', 'property assignment', \true); return; } if ($node instanceof ExecutionEndNode) { $executionEnds[] = $node; return; } if ($node instanceof Expr\Yield_ || $node instanceof Expr\YieldFrom) { $gatheredYieldStatements[] = $node; } if (!$node instanceof Return_) { return; } $gatheredReturnStatements[] = new ReturnStatement($scope, $node); }, \PHPStan\Analyser\StatementContext::createTopLevel()); $nodeCallback(new FunctionReturnStatementsNode($stmt, $gatheredReturnStatements, $gatheredYieldStatements, $statementResult, $executionEnds, array_merge($statementResult->getImpurePoints(), $functionImpurePoints), $functionReflection), $functionScope); } elseif ($stmt instanceof Node\Stmt\ClassMethod) { $hasYield = \false; $throwPoints = []; $impurePoints = []; $this->processAttributeGroups($stmt, $stmt->attrGroups, $scope, $nodeCallback); [$templateTypeMap, $phpDocParameterTypes, $phpDocImmediatelyInvokedCallableParameters, $phpDocClosureThisTypeParameters, $phpDocReturnType, $phpDocThrowType, $deprecatedDescription, $isDeprecated, $isInternal, $isFinal, $isPure, $acceptsNamedArguments, , $phpDocComment, $asserts, $selfOutType, $phpDocParameterOutTypes] = $this->getPhpDocs($scope, $stmt); foreach ($stmt->params as $param) { $this->processParamNode($stmt, $param, $scope, $nodeCallback); } if ($stmt->returnType !== null) { $nodeCallback($stmt->returnType, $scope); } $isFromTrait = $stmt->getAttribute('originalTraitMethodName') === '__construct'; $isConstructor = $isFromTrait || $stmt->name->toLowerString() === '__construct'; $methodScope = $scope->enterClassMethod($stmt, $templateTypeMap, $phpDocParameterTypes, $phpDocReturnType, $phpDocThrowType, $deprecatedDescription, $isDeprecated, $isInternal, $isFinal, $isPure, $acceptsNamedArguments, $asserts, $selfOutType, $phpDocComment, $phpDocParameterOutTypes, $phpDocImmediatelyInvokedCallableParameters, $phpDocClosureThisTypeParameters, $isConstructor); if (!$scope->isInClass()) { throw new ShouldNotHappenException(); } if ($isConstructor) { foreach ($stmt->params as $param) { if ($param->flags === 0) { continue; } if (!$param->var instanceof Variable || !is_string($param->var->name)) { throw new ShouldNotHappenException(); } $phpDoc = null; if ($param->getDocComment() !== null) { $phpDoc = $param->getDocComment()->getText(); } $nodeCallback(new ClassPropertyNode($param->var->name, $param->flags, $param->type, null, $phpDoc, $phpDocParameterTypes[$param->var->name] ?? null, \true, $isFromTrait, $param, \false, $scope->isInTrait(), $scope->getClassReflection()->isReadOnly(), \false, $scope->getClassReflection()), $methodScope); $methodScope = $methodScope->assignExpression(new PropertyInitializationExpr($param->var->name), new MixedType(), new MixedType()); } } if ($stmt->getAttribute('virtual', \false) === \false) { $methodReflection = $methodScope->getFunction(); if (!$methodReflection instanceof PhpMethodFromParserNodeReflection) { throw new ShouldNotHappenException(); } $nodeCallback(new InClassMethodNode($scope->getClassReflection(), $methodReflection, $stmt), $methodScope); } if ($stmt->stmts !== null) { $gatheredReturnStatements = []; $gatheredYieldStatements = []; $executionEnds = []; $methodImpurePoints = []; $statementResult = $this->processStmtNodes($stmt, $stmt->stmts, $methodScope, static function (Node $node, \PHPStan\Analyser\Scope $scope) use($nodeCallback, $methodScope, &$gatheredReturnStatements, &$gatheredYieldStatements, &$executionEnds, &$methodImpurePoints) : void { $nodeCallback($node, $scope); if ($scope->getFunction() !== $methodScope->getFunction()) { return; } if ($scope->isInAnonymousFunction()) { return; } if ($node instanceof PropertyAssignNode) { if ($node->getPropertyFetch() instanceof Expr\PropertyFetch && $scope->getFunction() instanceof PhpMethodFromParserNodeReflection && $scope->getFunction()->getDeclaringClass()->hasConstructor() && $scope->getFunction()->getDeclaringClass()->getConstructor()->getName() === $scope->getFunction()->getName() && TypeUtils::findThisType($scope->getType($node->getPropertyFetch()->var)) !== null) { return; } $methodImpurePoints[] = new \PHPStan\Analyser\ImpurePoint($scope, $node, 'propertyAssign', 'property assignment', \true); return; } if ($node instanceof ExecutionEndNode) { $executionEnds[] = $node; return; } if ($node instanceof Expr\Yield_ || $node instanceof Expr\YieldFrom) { $gatheredYieldStatements[] = $node; } if (!$node instanceof Return_) { return; } $gatheredReturnStatements[] = new ReturnStatement($scope, $node); }, \PHPStan\Analyser\StatementContext::createTopLevel()); $classReflection = $scope->getClassReflection(); $methodReflection = $methodScope->getFunction(); if (!$methodReflection instanceof PhpMethodFromParserNodeReflection) { throw new ShouldNotHappenException(); } $nodeCallback(new MethodReturnStatementsNode($stmt, $gatheredReturnStatements, $gatheredYieldStatements, $statementResult, $executionEnds, array_merge($statementResult->getImpurePoints(), $methodImpurePoints), $classReflection, $methodReflection), $methodScope); } } elseif ($stmt instanceof Echo_) { $hasYield = \false; $throwPoints = []; foreach ($stmt->exprs as $echoExpr) { $result = $this->processExprNode($stmt, $echoExpr, $scope, $nodeCallback, \PHPStan\Analyser\ExpressionContext::createDeep()); $throwPoints = array_merge($throwPoints, $result->getThrowPoints()); $scope = $result->getScope(); $hasYield = $hasYield || $result->hasYield(); } $throwPoints = $overridingThrowPoints ?? $throwPoints; $impurePoints = [new \PHPStan\Analyser\ImpurePoint($scope, $stmt, 'echo', 'echo', \true)]; } elseif ($stmt instanceof Return_) { if ($stmt->expr !== null) { $result = $this->processExprNode($stmt, $stmt->expr, $scope, $nodeCallback, \PHPStan\Analyser\ExpressionContext::createDeep()); $throwPoints = $result->getThrowPoints(); $impurePoints = $result->getImpurePoints(); $scope = $result->getScope(); $hasYield = $result->hasYield(); } else { $hasYield = \false; $throwPoints = []; $impurePoints = []; } return new \PHPStan\Analyser\StatementResult($scope, $hasYield, \true, [new \PHPStan\Analyser\StatementExitPoint($stmt, $scope)], $overridingThrowPoints ?? $throwPoints, $impurePoints); } elseif ($stmt instanceof Continue_ || $stmt instanceof Break_) { if ($stmt->num !== null) { $result = $this->processExprNode($stmt, $stmt->num, $scope, $nodeCallback, \PHPStan\Analyser\ExpressionContext::createDeep()); $scope = $result->getScope(); $hasYield = $result->hasYield(); $throwPoints = $result->getThrowPoints(); $impurePoints = $result->getImpurePoints(); } else { $hasYield = \false; $throwPoints = []; $impurePoints = []; } return new \PHPStan\Analyser\StatementResult($scope, $hasYield, \true, [new \PHPStan\Analyser\StatementExitPoint($stmt, $scope)], $overridingThrowPoints ?? $throwPoints, $impurePoints); } elseif ($stmt instanceof Node\Stmt\Expression) { $earlyTerminationExpr = $this->findEarlyTerminatingExpr($stmt->expr, $scope); $hasAssign = \false; $currentScope = $scope; $result = $this->processExprNode($stmt, $stmt->expr, $scope, static function (Node $node, \PHPStan\Analyser\Scope $scope) use($nodeCallback, $currentScope, &$hasAssign) : void { $nodeCallback($node, $scope); if ($scope->getAnonymousFunctionReflection() !== $currentScope->getAnonymousFunctionReflection()) { return; } if ($scope->getFunction() !== $currentScope->getFunction()) { return; } if (!$node instanceof VariableAssignNode && !$node instanceof PropertyAssignNode) { return; } $hasAssign = \true; }, \PHPStan\Analyser\ExpressionContext::createTopLevel()); $throwPoints = array_filter($result->getThrowPoints(), static function ($throwPoint) { return $throwPoint->isExplicit(); }); if (count($result->getImpurePoints()) === 0 && count($throwPoints) === 0 && !$stmt->expr instanceof Expr\PostInc && !$stmt->expr instanceof Expr\PreInc && !$stmt->expr instanceof Expr\PostDec && !$stmt->expr instanceof Expr\PreDec) { $nodeCallback(new NoopExpressionNode($stmt->expr, $hasAssign), $scope); } $scope = $result->getScope(); $scope = $scope->filterBySpecifiedTypes($this->typeSpecifier->specifyTypesInCondition($scope, $stmt->expr, \PHPStan\Analyser\TypeSpecifierContext::createNull())); $hasYield = $result->hasYield(); $throwPoints = $result->getThrowPoints(); $impurePoints = $result->getImpurePoints(); if ($earlyTerminationExpr !== null) { return new \PHPStan\Analyser\StatementResult($scope, $hasYield, \true, [new \PHPStan\Analyser\StatementExitPoint($stmt, $scope)], $overridingThrowPoints ?? $throwPoints, $impurePoints); } return new \PHPStan\Analyser\StatementResult($scope, $hasYield, \false, [], $overridingThrowPoints ?? $throwPoints, $impurePoints); } elseif ($stmt instanceof Node\Stmt\Namespace_) { if ($stmt->name !== null) { $scope = $scope->enterNamespace($stmt->name->toString()); } $scope = $this->processStmtNodes($stmt, $stmt->stmts, $scope, $nodeCallback, $context)->getScope(); $hasYield = \false; $throwPoints = []; $impurePoints = []; } elseif ($stmt instanceof Node\Stmt\Trait_) { return new \PHPStan\Analyser\StatementResult($scope, \false, \false, [], [], []); } elseif ($stmt instanceof Node\Stmt\ClassLike) { if (!$context->isTopLevel()) { return new \PHPStan\Analyser\StatementResult($scope, \false, \false, [], [], []); } $hasYield = \false; $throwPoints = []; $impurePoints = []; if (isset($stmt->namespacedName)) { $classReflection = $this->getCurrentClassReflection($stmt, $stmt->namespacedName->toString(), $scope); $classScope = $scope->enterClass($classReflection); $nodeCallback(new InClassNode($stmt, $classReflection), $classScope); } elseif ($stmt instanceof Class_) { if ($stmt->name === null) { throw new ShouldNotHappenException(); } if (!$stmt->isAnonymous()) { $classReflection = $this->reflectionProvider->getClass($stmt->name->toString()); } else { $classReflection = $this->reflectionProvider->getAnonymousClassReflection($stmt, $scope); } $classScope = $scope->enterClass($classReflection); $nodeCallback(new InClassNode($stmt, $classReflection), $classScope); } else { throw new ShouldNotHappenException(); } $classStatementsGatherer = new ClassStatementsGatherer($classReflection, $nodeCallback); $this->processAttributeGroups($stmt, $stmt->attrGroups, $classScope, $classStatementsGatherer); $this->processStmtNodes($stmt, $stmt->stmts, $classScope, $classStatementsGatherer, $context); $nodeCallback(new ClassPropertiesNode($stmt, $this->readWritePropertiesExtensionProvider, $classStatementsGatherer->getProperties(), $classStatementsGatherer->getPropertyUsages(), $classStatementsGatherer->getMethodCalls(), $classStatementsGatherer->getReturnStatementsNodes(), $classStatementsGatherer->getPropertyAssigns(), $classReflection), $classScope); $nodeCallback(new ClassMethodsNode($stmt, $classStatementsGatherer->getMethods(), $classStatementsGatherer->getMethodCalls(), $classReflection), $classScope); $nodeCallback(new ClassConstantsNode($stmt, $classStatementsGatherer->getConstants(), $classStatementsGatherer->getConstantFetches(), $classReflection), $classScope); $classReflection->evictPrivateSymbols(); $this->calledMethodResults = []; } elseif ($stmt instanceof Node\Stmt\Property) { $hasYield = \false; $throwPoints = []; $impurePoints = []; $this->processAttributeGroups($stmt, $stmt->attrGroups, $scope, $nodeCallback); foreach ($stmt->props as $prop) { $nodeCallback($prop, $scope); if ($prop->default !== null) { $this->processExprNode($stmt, $prop->default, $scope, $nodeCallback, \PHPStan\Analyser\ExpressionContext::createDeep()); } [, , , , , , , , , , , , $isReadOnly, $docComment, , , , $varTags, $isAllowedPrivateMutation] = $this->getPhpDocs($scope, $stmt); if (!$scope->isInClass()) { throw new ShouldNotHappenException(); } $propertyName = $prop->name->toString(); $phpDocType = null; if (isset($varTags[0]) && count($varTags) === 1) { $phpDocType = $varTags[0]->getType(); } elseif (isset($varTags[$propertyName])) { $phpDocType = $varTags[$propertyName]->getType(); } $nodeCallback(new ClassPropertyNode($propertyName, $stmt->flags, $stmt->type, $prop->default, $docComment, $phpDocType, \false, \false, $prop, $isReadOnly, $scope->isInTrait(), $scope->getClassReflection()->isReadOnly(), $isAllowedPrivateMutation, $scope->getClassReflection()), $scope); } if ($stmt->type !== null) { $nodeCallback($stmt->type, $scope); } } elseif ($stmt instanceof Throw_) { $result = $this->processExprNode($stmt, $stmt->expr, $scope, $nodeCallback, \PHPStan\Analyser\ExpressionContext::createDeep()); $throwPoints = $result->getThrowPoints(); $throwPoints[] = \PHPStan\Analyser\ThrowPoint::createExplicit($result->getScope(), $scope->getType($stmt->expr), $stmt, \false); $impurePoints = $result->getImpurePoints(); return new \PHPStan\Analyser\StatementResult($result->getScope(), $result->hasYield(), \true, [new \PHPStan\Analyser\StatementExitPoint($stmt, $scope)], $throwPoints, $impurePoints); } elseif ($stmt instanceof If_) { $conditionType = ($this->treatPhpDocTypesAsCertain ? $scope->getType($stmt->cond) : $scope->getNativeType($stmt->cond))->toBoolean(); $ifAlwaysTrue = $conditionType->isTrue()->yes(); $condResult = $this->processExprNode($stmt, $stmt->cond, $scope, $nodeCallback, \PHPStan\Analyser\ExpressionContext::createDeep()); $exitPoints = []; $throwPoints = $overridingThrowPoints ?? $condResult->getThrowPoints(); $impurePoints = $condResult->getImpurePoints(); $endStatements = []; $finalScope = null; $alwaysTerminating = \true; $hasYield = $condResult->hasYield(); $branchScopeStatementResult = $this->processStmtNodes($stmt, $stmt->stmts, $condResult->getTruthyScope(), $nodeCallback, $context); if (!$conditionType instanceof ConstantBooleanType || $conditionType->getValue()) { $exitPoints = $branchScopeStatementResult->getExitPoints(); $throwPoints = array_merge($throwPoints, $branchScopeStatementResult->getThrowPoints()); $impurePoints = array_merge($impurePoints, $branchScopeStatementResult->getImpurePoints()); $branchScope = $branchScopeStatementResult->getScope(); $finalScope = $branchScopeStatementResult->isAlwaysTerminating() ? null : $branchScope; $alwaysTerminating = $branchScopeStatementResult->isAlwaysTerminating(); if (count($branchScopeStatementResult->getEndStatements()) > 0) { $endStatements = array_merge($endStatements, $branchScopeStatementResult->getEndStatements()); } elseif (count($stmt->stmts) > 0) { $endStatements[] = new \PHPStan\Analyser\EndStatementResult($stmt->stmts[count($stmt->stmts) - 1], $branchScopeStatementResult); } else { $endStatements[] = new \PHPStan\Analyser\EndStatementResult($stmt, $branchScopeStatementResult); } $hasYield = $branchScopeStatementResult->hasYield() || $hasYield; } $scope = $condResult->getFalseyScope(); $lastElseIfConditionIsTrue = \false; $condScope = $scope; foreach ($stmt->elseifs as $elseif) { $nodeCallback($elseif, $scope); $elseIfConditionType = ($this->treatPhpDocTypesAsCertain ? $condScope->getType($elseif->cond) : $scope->getNativeType($elseif->cond))->toBoolean(); $condResult = $this->processExprNode($stmt, $elseif->cond, $condScope, $nodeCallback, \PHPStan\Analyser\ExpressionContext::createDeep()); $throwPoints = array_merge($throwPoints, $condResult->getThrowPoints()); $impurePoints = array_merge($impurePoints, $condResult->getImpurePoints()); $condScope = $condResult->getScope(); $branchScopeStatementResult = $this->processStmtNodes($elseif, $elseif->stmts, $condResult->getTruthyScope(), $nodeCallback, $context); if (!$ifAlwaysTrue && (!$lastElseIfConditionIsTrue && (!$elseIfConditionType instanceof ConstantBooleanType || $elseIfConditionType->getValue()))) { $exitPoints = array_merge($exitPoints, $branchScopeStatementResult->getExitPoints()); $throwPoints = array_merge($throwPoints, $branchScopeStatementResult->getThrowPoints()); $impurePoints = array_merge($impurePoints, $branchScopeStatementResult->getImpurePoints()); $branchScope = $branchScopeStatementResult->getScope(); $finalScope = $branchScopeStatementResult->isAlwaysTerminating() ? $finalScope : $branchScope->mergeWith($finalScope); $alwaysTerminating = $alwaysTerminating && $branchScopeStatementResult->isAlwaysTerminating(); if (count($branchScopeStatementResult->getEndStatements()) > 0) { $endStatements = array_merge($endStatements, $branchScopeStatementResult->getEndStatements()); } elseif (count($elseif->stmts) > 0) { $endStatements[] = new \PHPStan\Analyser\EndStatementResult($elseif->stmts[count($elseif->stmts) - 1], $branchScopeStatementResult); } else { $endStatements[] = new \PHPStan\Analyser\EndStatementResult($elseif, $branchScopeStatementResult); } $hasYield = $hasYield || $branchScopeStatementResult->hasYield(); } if ($elseIfConditionType->isTrue()->yes()) { $lastElseIfConditionIsTrue = \true; } $condScope = $condScope->filterByFalseyValue($elseif->cond); $scope = $condScope; } if ($stmt->else === null) { if (!$ifAlwaysTrue && !$lastElseIfConditionIsTrue) { $finalScope = $scope->mergeWith($finalScope); $alwaysTerminating = \false; } } else { $nodeCallback($stmt->else, $scope); $branchScopeStatementResult = $this->processStmtNodes($stmt->else, $stmt->else->stmts, $scope, $nodeCallback, $context); if (!$ifAlwaysTrue && !$lastElseIfConditionIsTrue) { $exitPoints = array_merge($exitPoints, $branchScopeStatementResult->getExitPoints()); $throwPoints = array_merge($throwPoints, $branchScopeStatementResult->getThrowPoints()); $impurePoints = array_merge($impurePoints, $branchScopeStatementResult->getImpurePoints()); $branchScope = $branchScopeStatementResult->getScope(); $finalScope = $branchScopeStatementResult->isAlwaysTerminating() ? $finalScope : $branchScope->mergeWith($finalScope); $alwaysTerminating = $alwaysTerminating && $branchScopeStatementResult->isAlwaysTerminating(); if (count($branchScopeStatementResult->getEndStatements()) > 0) { $endStatements = array_merge($endStatements, $branchScopeStatementResult->getEndStatements()); } elseif (count($stmt->else->stmts) > 0) { $endStatements[] = new \PHPStan\Analyser\EndStatementResult($stmt->else->stmts[count($stmt->else->stmts) - 1], $branchScopeStatementResult); } else { $endStatements[] = new \PHPStan\Analyser\EndStatementResult($stmt->else, $branchScopeStatementResult); } $hasYield = $hasYield || $branchScopeStatementResult->hasYield(); } } if ($finalScope === null) { $finalScope = $scope; } if ($stmt->else === null && !$ifAlwaysTrue && !$lastElseIfConditionIsTrue) { $endStatements[] = new \PHPStan\Analyser\EndStatementResult($stmt, new \PHPStan\Analyser\StatementResult($finalScope, $hasYield, $alwaysTerminating, $exitPoints, $throwPoints, $impurePoints)); } return new \PHPStan\Analyser\StatementResult($finalScope, $hasYield, $alwaysTerminating, $exitPoints, $throwPoints, $impurePoints, $endStatements); } elseif ($stmt instanceof Node\Stmt\TraitUse) { $hasYield = \false; $throwPoints = []; $impurePoints = []; $this->processTraitUse($stmt, $scope, $nodeCallback); } elseif ($stmt instanceof Foreach_) { $condResult = $this->processExprNode($stmt, $stmt->expr, $scope, $nodeCallback, \PHPStan\Analyser\ExpressionContext::createDeep()); $throwPoints = $overridingThrowPoints ?? $condResult->getThrowPoints(); $impurePoints = $condResult->getImpurePoints(); $scope = $condResult->getScope(); $arrayComparisonExpr = new BinaryOp\NotIdentical($stmt->expr, new Array_([])); if ($stmt->expr instanceof Variable && is_string($stmt->expr->name)) { $scope = $this->processVarAnnotation($scope, [$stmt->expr->name], $stmt); } $nodeCallback(new InForeachNode($stmt), $scope); $originalScope = $scope; $bodyScope = $scope; if ($context->isTopLevel()) { $originalScope = $this->polluteScopeWithAlwaysIterableForeach ? $scope->filterByTruthyValue($arrayComparisonExpr) : $scope; $bodyScope = $this->enterForeach($originalScope, $originalScope, $stmt); $count = 0; do { $prevScope = $bodyScope; $bodyScope = $bodyScope->mergeWith($this->polluteScopeWithAlwaysIterableForeach ? $scope->filterByTruthyValue($arrayComparisonExpr) : $scope); $bodyScope = $this->enterForeach($bodyScope, $originalScope, $stmt); $bodyScopeResult = $this->processStmtNodes($stmt, $stmt->stmts, $bodyScope, static function () : void { }, $context->enterDeep())->filterOutLoopExitPoints(); $bodyScope = $bodyScopeResult->getScope(); foreach ($bodyScopeResult->getExitPointsByType(Continue_::class) as $continueExitPoint) { $bodyScope = $bodyScope->mergeWith($continueExitPoint->getScope()); } if ($bodyScope->equals($prevScope)) { break; } if ($count >= self::GENERALIZE_AFTER_ITERATION) { $bodyScope = $prevScope->generalizeWith($bodyScope); } $count++; } while ($count < self::LOOP_SCOPE_ITERATIONS); } $bodyScope = $bodyScope->mergeWith($this->polluteScopeWithAlwaysIterableForeach ? $scope->filterByTruthyValue($arrayComparisonExpr) : $scope); $bodyScope = $this->enterForeach($bodyScope, $originalScope, $stmt); $finalScopeResult = $this->processStmtNodes($stmt, $stmt->stmts, $bodyScope, $nodeCallback, $context)->filterOutLoopExitPoints(); $finalScope = $finalScopeResult->getScope(); foreach ($finalScopeResult->getExitPointsByType(Continue_::class) as $continueExitPoint) { $finalScope = $continueExitPoint->getScope()->mergeWith($finalScope); } foreach ($finalScopeResult->getExitPointsByType(Break_::class) as $breakExitPoint) { $finalScope = $breakExitPoint->getScope()->mergeWith($finalScope); } $exprType = $scope->getType($stmt->expr); $isIterableAtLeastOnce = $exprType->isIterableAtLeastOnce(); if ($exprType->isIterable()->no() || $isIterableAtLeastOnce->maybe()) { $finalScope = $finalScope->mergeWith($scope->filterByTruthyValue(new BooleanOr(new BinaryOp\Identical($stmt->expr, new Array_([])), new FuncCall(new Name\FullyQualified('is_object'), [new Arg($stmt->expr)])))); } elseif ($isIterableAtLeastOnce->no() || $finalScopeResult->isAlwaysTerminating()) { $finalScope = $scope; } elseif (!$this->polluteScopeWithAlwaysIterableForeach) { $finalScope = $scope->processAlwaysIterableForeachScopeWithoutPollute($finalScope); // get types from finalScope, but don't create new variables } if (!$isIterableAtLeastOnce->no()) { $throwPoints = array_merge($throwPoints, $finalScopeResult->getThrowPoints()); $impurePoints = array_merge($impurePoints, $finalScopeResult->getImpurePoints()); } if (!(new ObjectType(Traversable::class))->isSuperTypeOf($scope->getType($stmt->expr))->no()) { $throwPoints[] = \PHPStan\Analyser\ThrowPoint::createImplicit($scope, $stmt->expr); } return new \PHPStan\Analyser\StatementResult($finalScope, $finalScopeResult->hasYield() || $condResult->hasYield(), $isIterableAtLeastOnce->yes() && $finalScopeResult->isAlwaysTerminating(), $finalScopeResult->getExitPointsForOuterLoop(), $throwPoints, $impurePoints); } elseif ($stmt instanceof While_) { $condResult = $this->processExprNode($stmt, $stmt->cond, $scope, static function () : void { }, \PHPStan\Analyser\ExpressionContext::createDeep()); $bodyScope = $condResult->getTruthyScope(); if ($context->isTopLevel()) { $count = 0; do { $prevScope = $bodyScope; $bodyScope = $bodyScope->mergeWith($scope); $bodyScope = $this->processExprNode($stmt, $stmt->cond, $bodyScope, static function () : void { }, \PHPStan\Analyser\ExpressionContext::createDeep())->getTruthyScope(); $bodyScopeResult = $this->processStmtNodes($stmt, $stmt->stmts, $bodyScope, static function () : void { }, $context->enterDeep())->filterOutLoopExitPoints(); $bodyScope = $bodyScopeResult->getScope(); foreach ($bodyScopeResult->getExitPointsByType(Continue_::class) as $continueExitPoint) { $bodyScope = $bodyScope->mergeWith($continueExitPoint->getScope()); } if ($bodyScope->equals($prevScope)) { break; } if ($count >= self::GENERALIZE_AFTER_ITERATION) { $bodyScope = $prevScope->generalizeWith($bodyScope); } $count++; } while ($count < self::LOOP_SCOPE_ITERATIONS); } $bodyScope = $bodyScope->mergeWith($scope); $bodyScopeMaybeRan = $bodyScope; $bodyScope = $this->processExprNode($stmt, $stmt->cond, $bodyScope, $nodeCallback, \PHPStan\Analyser\ExpressionContext::createDeep())->getTruthyScope(); $finalScopeResult = $this->processStmtNodes($stmt, $stmt->stmts, $bodyScope, $nodeCallback, $context)->filterOutLoopExitPoints(); $finalScope = $finalScopeResult->getScope()->filterByFalseyValue($stmt->cond); $condBooleanType = ($this->treatPhpDocTypesAsCertain ? $bodyScopeMaybeRan->getType($stmt->cond) : $bodyScopeMaybeRan->getNativeType($stmt->cond))->toBoolean(); $alwaysIterates = $condBooleanType->isTrue()->yes() && $context->isTopLevel(); $neverIterates = $condBooleanType->isFalse()->yes() && $context->isTopLevel(); if (!$alwaysIterates) { foreach ($finalScopeResult->getExitPointsByType(Continue_::class) as $continueExitPoint) { $finalScope = $finalScope->mergeWith($continueExitPoint->getScope()); } } $breakExitPoints = $finalScopeResult->getExitPointsByType(Break_::class); foreach ($breakExitPoints as $breakExitPoint) { $finalScope = $finalScope->mergeWith($breakExitPoint->getScope()); } $beforeCondBooleanType = ($this->treatPhpDocTypesAsCertain ? $scope->getType($stmt->cond) : $scope->getNativeType($stmt->cond))->toBoolean(); $isIterableAtLeastOnce = $beforeCondBooleanType->isTrue()->yes(); $nodeCallback(new BreaklessWhileLoopNode($stmt, $finalScopeResult->getExitPoints()), $bodyScopeMaybeRan); if ($alwaysIterates) { $isAlwaysTerminating = count($finalScopeResult->getExitPointsByType(Break_::class)) === 0; } elseif ($isIterableAtLeastOnce) { $isAlwaysTerminating = $finalScopeResult->isAlwaysTerminating(); } else { $isAlwaysTerminating = \false; } $condScope = $condResult->getFalseyScope(); if (!$isIterableAtLeastOnce) { if (!$this->polluteScopeWithLoopInitialAssignments) { $condScope = $condScope->mergeWith($scope); } $finalScope = $finalScope->mergeWith($condScope); } $throwPoints = $overridingThrowPoints ?? $condResult->getThrowPoints(); $impurePoints = $condResult->getImpurePoints(); if (!$neverIterates) { $throwPoints = array_merge($throwPoints, $finalScopeResult->getThrowPoints()); $impurePoints = array_merge($impurePoints, $finalScopeResult->getImpurePoints()); } return new \PHPStan\Analyser\StatementResult($finalScope, $finalScopeResult->hasYield() || $condResult->hasYield(), $isAlwaysTerminating, $finalScopeResult->getExitPointsForOuterLoop(), $throwPoints, $impurePoints); } elseif ($stmt instanceof Do_) { $finalScope = null; $bodyScope = $scope; $count = 0; $hasYield = \false; $throwPoints = []; $impurePoints = []; if ($context->isTopLevel()) { do { $prevScope = $bodyScope; $bodyScope = $bodyScope->mergeWith($scope); $bodyScopeResult = $this->processStmtNodes($stmt, $stmt->stmts, $bodyScope, static function () : void { }, $context->enterDeep())->filterOutLoopExitPoints(); $alwaysTerminating = $bodyScopeResult->isAlwaysTerminating(); $bodyScope = $bodyScopeResult->getScope(); foreach ($bodyScopeResult->getExitPointsByType(Continue_::class) as $continueExitPoint) { $bodyScope = $bodyScope->mergeWith($continueExitPoint->getScope()); } $finalScope = $alwaysTerminating ? $finalScope : $bodyScope->mergeWith($finalScope); foreach ($bodyScopeResult->getExitPointsByType(Break_::class) as $breakExitPoint) { $finalScope = $breakExitPoint->getScope()->mergeWith($finalScope); } $bodyScope = $this->processExprNode($stmt, $stmt->cond, $bodyScope, static function () : void { }, \PHPStan\Analyser\ExpressionContext::createDeep())->getTruthyScope(); if ($bodyScope->equals($prevScope)) { break; } if ($count >= self::GENERALIZE_AFTER_ITERATION) { $bodyScope = $prevScope->generalizeWith($bodyScope); } $count++; } while ($count < self::LOOP_SCOPE_ITERATIONS); $bodyScope = $bodyScope->mergeWith($scope); } $bodyScopeResult = $this->processStmtNodes($stmt, $stmt->stmts, $bodyScope, $nodeCallback, $context)->filterOutLoopExitPoints(); $bodyScope = $bodyScopeResult->getScope(); foreach ($bodyScopeResult->getExitPointsByType(Continue_::class) as $continueExitPoint) { $bodyScope = $bodyScope->mergeWith($continueExitPoint->getScope()); } $condBooleanType = ($this->treatPhpDocTypesAsCertain ? $bodyScope->getType($stmt->cond) : $bodyScope->getNativeType($stmt->cond))->toBoolean(); $alwaysIterates = $condBooleanType->isTrue()->yes() && $context->isTopLevel(); $nodeCallback(new DoWhileLoopConditionNode($stmt->cond, $bodyScopeResult->getExitPoints()), $bodyScope); if ($alwaysIterates) { $alwaysTerminating = count($bodyScopeResult->getExitPointsByType(Break_::class)) === 0; } else { $alwaysTerminating = $bodyScopeResult->isAlwaysTerminating(); } $finalScope = $alwaysTerminating ? $finalScope : $bodyScope->mergeWith($finalScope); if ($finalScope === null) { $finalScope = $scope; } if (!$alwaysTerminating) { $condResult = $this->processExprNode($stmt, $stmt->cond, $bodyScope, $nodeCallback, \PHPStan\Analyser\ExpressionContext::createDeep()); $hasYield = $condResult->hasYield(); $throwPoints = $condResult->getThrowPoints(); $impurePoints = $condResult->getImpurePoints(); $finalScope = $condResult->getFalseyScope(); } else { $this->processExprNode($stmt, $stmt->cond, $bodyScope, $nodeCallback, \PHPStan\Analyser\ExpressionContext::createDeep()); } foreach ($bodyScopeResult->getExitPointsByType(Break_::class) as $breakExitPoint) { $finalScope = $breakExitPoint->getScope()->mergeWith($finalScope); } return new \PHPStan\Analyser\StatementResult($finalScope, $bodyScopeResult->hasYield() || $hasYield, $alwaysTerminating, $bodyScopeResult->getExitPointsForOuterLoop(), array_merge($throwPoints, $bodyScopeResult->getThrowPoints()), array_merge($impurePoints, $bodyScopeResult->getImpurePoints())); } elseif ($stmt instanceof For_) { $initScope = $scope; $hasYield = \false; $throwPoints = []; $impurePoints = []; foreach ($stmt->init as $initExpr) { $initResult = $this->processExprNode($stmt, $initExpr, $initScope, $nodeCallback, \PHPStan\Analyser\ExpressionContext::createTopLevel()); $initScope = $initResult->getScope(); $hasYield = $hasYield || $initResult->hasYield(); $throwPoints = array_merge($throwPoints, $initResult->getThrowPoints()); $impurePoints = array_merge($impurePoints, $initResult->getImpurePoints()); } $bodyScope = $initScope; $isIterableAtLeastOnce = TrinaryLogic::createYes(); $lastCondExpr = $stmt->cond[count($stmt->cond) - 1] ?? null; foreach ($stmt->cond as $condExpr) { $condResult = $this->processExprNode($stmt, $condExpr, $bodyScope, static function () : void { }, \PHPStan\Analyser\ExpressionContext::createDeep()); $initScope = $condResult->getScope(); $condResultScope = $condResult->getScope(); if ($condExpr === $lastCondExpr) { $condTruthiness = ($this->treatPhpDocTypesAsCertain ? $condResultScope->getType($condExpr) : $condResultScope->getNativeType($condExpr))->toBoolean(); $isIterableAtLeastOnce = $isIterableAtLeastOnce->and($condTruthiness->isTrue()); } $hasYield = $hasYield || $condResult->hasYield(); $throwPoints = array_merge($throwPoints, $condResult->getThrowPoints()); $impurePoints = array_merge($impurePoints, $condResult->getImpurePoints()); $bodyScope = $condResult->getTruthyScope(); } if ($context->isTopLevel()) { $count = 0; do { $prevScope = $bodyScope; $bodyScope = $bodyScope->mergeWith($initScope); if ($lastCondExpr !== null) { $bodyScope = $this->processExprNode($stmt, $lastCondExpr, $bodyScope, static function () : void { }, \PHPStan\Analyser\ExpressionContext::createDeep())->getTruthyScope(); } $bodyScopeResult = $this->processStmtNodes($stmt, $stmt->stmts, $bodyScope, static function () : void { }, $context->enterDeep())->filterOutLoopExitPoints(); $bodyScope = $bodyScopeResult->getScope(); foreach ($bodyScopeResult->getExitPointsByType(Continue_::class) as $continueExitPoint) { $bodyScope = $bodyScope->mergeWith($continueExitPoint->getScope()); } foreach ($stmt->loop as $loopExpr) { $exprResult = $this->processExprNode($stmt, $loopExpr, $bodyScope, static function () : void { }, \PHPStan\Analyser\ExpressionContext::createTopLevel()); $bodyScope = $exprResult->getScope(); $hasYield = $hasYield || $exprResult->hasYield(); $throwPoints = array_merge($throwPoints, $exprResult->getThrowPoints()); $impurePoints = array_merge($impurePoints, $exprResult->getImpurePoints()); } if ($bodyScope->equals($prevScope)) { break; } if ($count >= self::GENERALIZE_AFTER_ITERATION) { $bodyScope = $prevScope->generalizeWith($bodyScope); } $count++; } while ($count < self::LOOP_SCOPE_ITERATIONS); } $bodyScope = $bodyScope->mergeWith($initScope); $alwaysIterates = TrinaryLogic::createFromBoolean($context->isTopLevel()); if ($lastCondExpr !== null) { $alwaysIterates = $alwaysIterates->and($bodyScope->getType($lastCondExpr)->toBoolean()->isTrue()); $bodyScope = $this->processExprNode($stmt, $lastCondExpr, $bodyScope, $nodeCallback, \PHPStan\Analyser\ExpressionContext::createDeep())->getTruthyScope(); } $finalScopeResult = $this->processStmtNodes($stmt, $stmt->stmts, $bodyScope, $nodeCallback, $context)->filterOutLoopExitPoints(); $finalScope = $finalScopeResult->getScope(); foreach ($finalScopeResult->getExitPointsByType(Continue_::class) as $continueExitPoint) { $finalScope = $continueExitPoint->getScope()->mergeWith($finalScope); } $loopScope = $finalScope; foreach ($stmt->loop as $loopExpr) { $loopScope = $this->processExprNode($stmt, $loopExpr, $loopScope, $nodeCallback, \PHPStan\Analyser\ExpressionContext::createTopLevel())->getScope(); } $finalScope = $finalScope->generalizeWith($loopScope); if ($lastCondExpr !== null) { $finalScope = $finalScope->filterByFalseyValue($lastCondExpr); } foreach ($finalScopeResult->getExitPointsByType(Break_::class) as $breakExitPoint) { $finalScope = $breakExitPoint->getScope()->mergeWith($finalScope); } if ($isIterableAtLeastOnce->no() || $finalScopeResult->isAlwaysTerminating()) { if ($this->polluteScopeWithLoopInitialAssignments) { $finalScope = $initScope; } else { $finalScope = $scope; } } elseif ($isIterableAtLeastOnce->maybe()) { if ($this->polluteScopeWithLoopInitialAssignments) { $finalScope = $finalScope->mergeWith($initScope); } else { $finalScope = $finalScope->mergeWith($scope); } } else { if (!$this->polluteScopeWithLoopInitialAssignments) { $finalScope = $finalScope->mergeWith($scope); } } if ($alwaysIterates->yes()) { $isAlwaysTerminating = count($finalScopeResult->getExitPointsByType(Break_::class)) === 0; } elseif ($isIterableAtLeastOnce->yes()) { $isAlwaysTerminating = $finalScopeResult->isAlwaysTerminating(); } else { $isAlwaysTerminating = \false; } return new \PHPStan\Analyser\StatementResult($finalScope, $finalScopeResult->hasYield() || $hasYield, $isAlwaysTerminating, $finalScopeResult->getExitPointsForOuterLoop(), array_merge($throwPoints, $finalScopeResult->getThrowPoints()), array_merge($impurePoints, $finalScopeResult->getImpurePoints())); } elseif ($stmt instanceof Switch_) { $condResult = $this->processExprNode($stmt, $stmt->cond, $scope, $nodeCallback, \PHPStan\Analyser\ExpressionContext::createDeep()); $scope = $condResult->getScope(); $scopeForBranches = $scope; $finalScope = null; $prevScope = null; $hasDefaultCase = \false; $alwaysTerminating = \true; $hasYield = $condResult->hasYield(); $exitPointsForOuterLoop = []; $throwPoints = $condResult->getThrowPoints(); $impurePoints = $condResult->getImpurePoints(); foreach ($stmt->cases as $caseNode) { if ($caseNode->cond !== null) { $condExpr = new BinaryOp\Equal($stmt->cond, $caseNode->cond); $caseResult = $this->processExprNode($stmt, $caseNode->cond, $scopeForBranches, $nodeCallback, \PHPStan\Analyser\ExpressionContext::createDeep()); $scopeForBranches = $caseResult->getScope(); $hasYield = $hasYield || $caseResult->hasYield(); $throwPoints = array_merge($throwPoints, $caseResult->getThrowPoints()); $impurePoints = array_merge($impurePoints, $caseResult->getImpurePoints()); $branchScope = $caseResult->getTruthyScope()->filterByTruthyValue($condExpr); } else { $hasDefaultCase = \true; $branchScope = $scopeForBranches; } $branchScope = $branchScope->mergeWith($prevScope); $branchScopeResult = $this->processStmtNodes($caseNode, $caseNode->stmts, $branchScope, $nodeCallback, $context); $branchScope = $branchScopeResult->getScope(); $branchFinalScopeResult = $branchScopeResult->filterOutLoopExitPoints(); $hasYield = $hasYield || $branchFinalScopeResult->hasYield(); foreach ($branchScopeResult->getExitPointsByType(Break_::class) as $breakExitPoint) { $alwaysTerminating = \false; $finalScope = $breakExitPoint->getScope()->mergeWith($finalScope); } foreach ($branchScopeResult->getExitPointsByType(Continue_::class) as $continueExitPoint) { $finalScope = $continueExitPoint->getScope()->mergeWith($finalScope); } $exitPointsForOuterLoop = array_merge($exitPointsForOuterLoop, $branchFinalScopeResult->getExitPointsForOuterLoop()); $throwPoints = array_merge($throwPoints, $branchFinalScopeResult->getThrowPoints()); $impurePoints = array_merge($impurePoints, $branchFinalScopeResult->getImpurePoints()); if ($branchScopeResult->isAlwaysTerminating()) { $alwaysTerminating = $alwaysTerminating && $branchFinalScopeResult->isAlwaysTerminating(); $prevScope = null; if (isset($condExpr)) { $scopeForBranches = $scopeForBranches->filterByFalseyValue($condExpr); } if (!$branchFinalScopeResult->isAlwaysTerminating()) { $finalScope = $branchScope->mergeWith($finalScope); } } else { $prevScope = $branchScope; } } $exhaustive = $scopeForBranches->getType($stmt->cond) instanceof NeverType; if (!$hasDefaultCase && !$exhaustive) { $alwaysTerminating = \false; } if ($prevScope !== null && isset($branchFinalScopeResult)) { $finalScope = $prevScope->mergeWith($finalScope); $alwaysTerminating = $alwaysTerminating && $branchFinalScopeResult->isAlwaysTerminating(); } if (!$hasDefaultCase && !$exhaustive || $finalScope === null) { $finalScope = $scope->mergeWith($finalScope); } return new \PHPStan\Analyser\StatementResult($finalScope, $hasYield, $alwaysTerminating, $exitPointsForOuterLoop, $throwPoints, $impurePoints); } elseif ($stmt instanceof TryCatch) { $branchScopeResult = $this->processStmtNodes($stmt, $stmt->stmts, $scope, $nodeCallback, $context); $branchScope = $branchScopeResult->getScope(); $finalScope = $branchScopeResult->isAlwaysTerminating() ? null : $branchScope; $exitPoints = []; $finallyExitPoints = []; $alwaysTerminating = $branchScopeResult->isAlwaysTerminating(); $hasYield = $branchScopeResult->hasYield(); if ($stmt->finally !== null) { $finallyScope = $branchScope; } else { $finallyScope = null; } foreach ($branchScopeResult->getExitPoints() as $exitPoint) { $finallyExitPoints[] = $exitPoint; if ($exitPoint->getStatement() instanceof Throw_) { continue; } if ($finallyScope !== null) { $finallyScope = $finallyScope->mergeWith($exitPoint->getScope()); } $exitPoints[] = $exitPoint; } $throwPoints = $branchScopeResult->getThrowPoints(); $impurePoints = $branchScopeResult->getImpurePoints(); $throwPointsForLater = []; $pastCatchTypes = new NeverType(); foreach ($stmt->catches as $catchNode) { $nodeCallback($catchNode, $scope); $originalCatchTypes = array_map(static function (Name $name) : Type { return new ObjectType($name->toString()); }, $catchNode->types); $catchTypes = array_map(static function (Type $type) use($pastCatchTypes) : Type { return TypeCombinator::remove($type, $pastCatchTypes); }, $originalCatchTypes); $originalCatchType = TypeCombinator::union(...$originalCatchTypes); $catchType = TypeCombinator::union(...$catchTypes); $pastCatchTypes = TypeCombinator::union($pastCatchTypes, $originalCatchType); $matchingThrowPoints = []; $matchingCatchTypes = array_fill_keys(array_keys($originalCatchTypes), \false); // throwable matches all foreach ($originalCatchTypes as $catchTypeIndex => $catchTypeItem) { if (!$catchTypeItem->isSuperTypeOf(new ObjectType(Throwable::class))->yes()) { continue; } foreach ($throwPoints as $throwPointIndex => $throwPoint) { $matchingThrowPoints[$throwPointIndex] = $throwPoint; $matchingCatchTypes[$catchTypeIndex] = \true; } } // explicit only $onlyExplicitIsThrow = \true; if (count($matchingThrowPoints) === 0) { foreach ($throwPoints as $throwPointIndex => $throwPoint) { foreach ($catchTypes as $catchTypeIndex => $catchTypeItem) { if ($catchTypeItem->isSuperTypeOf($throwPoint->getType())->no()) { continue; } $matchingCatchTypes[$catchTypeIndex] = \true; if (!$throwPoint->isExplicit()) { continue; } $throwNode = $throwPoint->getNode(); if (!$throwNode instanceof Throw_ && !$throwNode instanceof Expr\Throw_ && !($throwNode instanceof Node\Stmt\Expression && $throwNode->expr instanceof Expr\Throw_)) { $onlyExplicitIsThrow = \false; } $matchingThrowPoints[$throwPointIndex] = $throwPoint; } } } // implicit only if (count($matchingThrowPoints) === 0 || $this->explicitThrow && $onlyExplicitIsThrow) { foreach ($throwPoints as $throwPointIndex => $throwPoint) { if ($throwPoint->isExplicit()) { continue; } foreach ($catchTypes as $catchTypeIndex => $catchTypeItem) { if ($catchTypeItem->isSuperTypeOf($throwPoint->getType())->no()) { continue; } $matchingThrowPoints[$throwPointIndex] = $throwPoint; } } } // include previously removed throw points if (count($matchingThrowPoints) === 0) { if ($originalCatchType->isSuperTypeOf(new ObjectType(Throwable::class))->yes()) { foreach ($branchScopeResult->getThrowPoints() as $originalThrowPoint) { if (!$originalThrowPoint->canContainAnyThrowable()) { continue; } $matchingThrowPoints[] = $originalThrowPoint; $matchingCatchTypes = array_fill_keys(array_keys($originalCatchTypes), \true); } } } // emit error if ($this->detectDeadTypeInMultiCatch) { foreach ($matchingCatchTypes as $catchTypeIndex => $matched) { if ($matched) { continue; } $nodeCallback(new CatchWithUnthrownExceptionNode($catchNode, $catchTypes[$catchTypeIndex], $originalCatchTypes[$catchTypeIndex]), $scope); } } if (count($matchingThrowPoints) === 0) { if (!$this->detectDeadTypeInMultiCatch) { $nodeCallback(new CatchWithUnthrownExceptionNode($catchNode, $catchType, $originalCatchType), $scope); } continue; } // recompute throw points $newThrowPoints = []; foreach ($throwPoints as $throwPoint) { $newThrowPoint = $throwPoint->subtractCatchType($originalCatchType); if ($newThrowPoint->getType() instanceof NeverType) { continue; } $newThrowPoints[] = $newThrowPoint; } $throwPoints = $newThrowPoints; $catchScope = null; foreach ($matchingThrowPoints as $matchingThrowPoint) { if ($catchScope === null) { $catchScope = $matchingThrowPoint->getScope(); } else { $catchScope = $catchScope->mergeWith($matchingThrowPoint->getScope()); } } $variableName = null; if ($catchNode->var !== null) { if (!is_string($catchNode->var->name)) { throw new ShouldNotHappenException(); } $variableName = $catchNode->var->name; } $catchScopeResult = $this->processStmtNodes($catchNode, $catchNode->stmts, $catchScope->enterCatchType($catchType, $variableName), $nodeCallback, $context); $catchScopeForFinally = $catchScopeResult->getScope(); $finalScope = $catchScopeResult->isAlwaysTerminating() ? $finalScope : $catchScopeResult->getScope()->mergeWith($finalScope); $alwaysTerminating = $alwaysTerminating && $catchScopeResult->isAlwaysTerminating(); $hasYield = $hasYield || $catchScopeResult->hasYield(); $catchThrowPoints = $catchScopeResult->getThrowPoints(); $impurePoints = array_merge($impurePoints, $catchScopeResult->getImpurePoints()); $throwPointsForLater = array_merge($throwPointsForLater, $catchThrowPoints); if ($finallyScope !== null) { $finallyScope = $finallyScope->mergeWith($catchScopeForFinally); } foreach ($catchScopeResult->getExitPoints() as $exitPoint) { $finallyExitPoints[] = $exitPoint; if ($exitPoint->getStatement() instanceof Throw_) { continue; } if ($finallyScope !== null) { $finallyScope = $finallyScope->mergeWith($exitPoint->getScope()); } $exitPoints[] = $exitPoint; } foreach ($catchThrowPoints as $catchThrowPoint) { if ($finallyScope === null) { continue; } $finallyScope = $finallyScope->mergeWith($catchThrowPoint->getScope()); } } if ($finalScope === null) { $finalScope = $scope; } foreach ($throwPoints as $throwPoint) { if ($finallyScope === null) { continue; } $finallyScope = $finallyScope->mergeWith($throwPoint->getScope()); } if ($finallyScope !== null && $stmt->finally !== null) { $originalFinallyScope = $finallyScope; $finallyResult = $this->processStmtNodes($stmt->finally, $stmt->finally->stmts, $finallyScope, $nodeCallback, $context); $alwaysTerminating = $alwaysTerminating || $finallyResult->isAlwaysTerminating(); $hasYield = $hasYield || $finallyResult->hasYield(); $throwPointsForLater = array_merge($throwPointsForLater, $finallyResult->getThrowPoints()); $impurePoints = array_merge($impurePoints, $finallyResult->getImpurePoints()); $finallyScope = $finallyResult->getScope(); $finalScope = $finallyResult->isAlwaysTerminating() ? $finalScope : $finalScope->processFinallyScope($finallyScope, $originalFinallyScope); if (count($finallyResult->getExitPoints()) > 0) { $nodeCallback(new FinallyExitPointsNode($finallyResult->getExitPoints(), $finallyExitPoints), $scope); } $exitPoints = array_merge($exitPoints, $finallyResult->getExitPoints()); } return new \PHPStan\Analyser\StatementResult($finalScope, $hasYield, $alwaysTerminating, $exitPoints, array_merge($throwPoints, $throwPointsForLater), $impurePoints); } elseif ($stmt instanceof Unset_) { $hasYield = \false; $throwPoints = []; $impurePoints = []; foreach ($stmt->vars as $var) { $scope = $this->lookForSetAllowedUndefinedExpressions($scope, $var); $exprResult = $this->processExprNode($stmt, $var, $scope, $nodeCallback, \PHPStan\Analyser\ExpressionContext::createDeep()); $scope = $exprResult->getScope(); $scope = $this->lookForUnsetAllowedUndefinedExpressions($scope, $var); $hasYield = $hasYield || $exprResult->hasYield(); $throwPoints = array_merge($throwPoints, $exprResult->getThrowPoints()); $impurePoints = array_merge($impurePoints, $exprResult->getImpurePoints()); if ($var instanceof ArrayDimFetch && $var->dim !== null) { $cloningTraverser = new NodeTraverser(); $cloningTraverser->addVisitor(new CloningVisitor()); /** @var Expr $clonedVar */ [$clonedVar] = $cloningTraverser->traverse([$var->var]); $traverser = new NodeTraverser(); $traverser->addVisitor(new class extends NodeVisitorAbstract { public function leaveNode(Node $node) : ?ExistingArrayDimFetch { if (!$node instanceof ArrayDimFetch || $node->dim === null) { return null; } return new ExistingArrayDimFetch($node->var, $node->dim); } }); /** @var Expr $clonedVar */ [$clonedVar] = $traverser->traverse([$clonedVar]); $scope = $this->processAssignVar($scope, $stmt, $clonedVar, new UnsetOffsetExpr($var->var, $var->dim), static function (Node $node, \PHPStan\Analyser\Scope $scope) use($nodeCallback) : void { if (!$node instanceof PropertyAssignNode && !$node instanceof VariableAssignNode) { return; } $nodeCallback($node, $scope); }, \PHPStan\Analyser\ExpressionContext::createDeep(), static function (\PHPStan\Analyser\MutatingScope $scope) : \PHPStan\Analyser\ExpressionResult { return new \PHPStan\Analyser\ExpressionResult($scope, \false, [], []); }, \false)->getScope(); } elseif ($var instanceof PropertyFetch) { $scope = $scope->invalidateExpression($var); $impurePoints[] = new \PHPStan\Analyser\ImpurePoint($scope, $var, 'propertyUnset', 'property unset', \true); } else { $scope = $scope->invalidateExpression($var); } } } elseif ($stmt instanceof Node\Stmt\Use_) { $hasYield = \false; $throwPoints = []; $impurePoints = []; foreach ($stmt->uses as $use) { $nodeCallback($use, $scope); } } elseif ($stmt instanceof Node\Stmt\Global_) { $hasYield = \false; $throwPoints = []; $impurePoints = [new \PHPStan\Analyser\ImpurePoint($scope, $stmt, 'global', 'global variable', \true)]; $vars = []; foreach ($stmt->vars as $var) { if (!$var instanceof Variable) { throw new ShouldNotHappenException(); } $scope = $this->lookForSetAllowedUndefinedExpressions($scope, $var); $varResult = $this->processExprNode($stmt, $var, $scope, $nodeCallback, \PHPStan\Analyser\ExpressionContext::createDeep()); $impurePoints = array_merge($impurePoints, $varResult->getImpurePoints()); $scope = $this->lookForUnsetAllowedUndefinedExpressions($scope, $var); if (!is_string($var->name)) { continue; } $scope = $scope->assignVariable($var->name, new MixedType(), new MixedType()); $vars[] = $var->name; } $scope = $this->processVarAnnotation($scope, $vars, $stmt); } elseif ($stmt instanceof Static_) { $hasYield = \false; $throwPoints = []; $impurePoints = [new \PHPStan\Analyser\ImpurePoint($scope, $stmt, 'static', 'static variable', \true)]; $vars = []; foreach ($stmt->vars as $var) { if (!is_string($var->var->name)) { throw new ShouldNotHappenException(); } if ($var->default !== null) { $defaultExprResult = $this->processExprNode($stmt, $var->default, $scope, $nodeCallback, \PHPStan\Analyser\ExpressionContext::createDeep()); $impurePoints = array_merge($impurePoints, $defaultExprResult->getImpurePoints()); } $scope = $scope->enterExpressionAssign($var->var); $varResult = $this->processExprNode($stmt, $var->var, $scope, $nodeCallback, \PHPStan\Analyser\ExpressionContext::createDeep()); $impurePoints = array_merge($impurePoints, $varResult->getImpurePoints()); $scope = $scope->exitExpressionAssign($var->var); $scope = $scope->assignVariable($var->var->name, new MixedType(), new MixedType()); $vars[] = $var->var->name; } $scope = $this->processVarAnnotation($scope, $vars, $stmt); } elseif ($stmt instanceof Node\Stmt\Const_) { $hasYield = \false; $throwPoints = []; $impurePoints = []; foreach ($stmt->consts as $const) { $nodeCallback($const, $scope); $constResult = $this->processExprNode($stmt, $const->value, $scope, $nodeCallback, \PHPStan\Analyser\ExpressionContext::createDeep()); $impurePoints = array_merge($impurePoints, $constResult->getImpurePoints()); if ($const->namespacedName !== null) { $constantName = new Name\FullyQualified($const->namespacedName->toString()); } else { if ($const->name->toString() === '') { throw new ShouldNotHappenException('Constant cannot have a empty name'); } $constantName = new Name\FullyQualified($const->name->toString()); } $scope = $scope->assignExpression(new ConstFetch($constantName), $scope->getType($const->value), $scope->getNativeType($const->value)); } } elseif ($stmt instanceof Node\Stmt\ClassConst) { $hasYield = \false; $throwPoints = []; $impurePoints = []; $this->processAttributeGroups($stmt, $stmt->attrGroups, $scope, $nodeCallback); foreach ($stmt->consts as $const) { $nodeCallback($const, $scope); $constResult = $this->processExprNode($stmt, $const->value, $scope, $nodeCallback, \PHPStan\Analyser\ExpressionContext::createDeep()); $impurePoints = array_merge($impurePoints, $constResult->getImpurePoints()); if ($scope->getClassReflection() === null) { throw new ShouldNotHappenException(); } $scope = $scope->assignExpression(new Expr\ClassConstFetch(new Name\FullyQualified($scope->getClassReflection()->getName()), $const->name), $scope->getType($const->value), $scope->getNativeType($const->value)); } } elseif ($stmt instanceof Node\Stmt\EnumCase) { $hasYield = \false; $throwPoints = []; $this->processAttributeGroups($stmt, $stmt->attrGroups, $scope, $nodeCallback); $impurePoints = []; if ($stmt->expr !== null) { $exprResult = $this->processExprNode($stmt, $stmt->expr, $scope, $nodeCallback, \PHPStan\Analyser\ExpressionContext::createDeep()); $impurePoints = $exprResult->getImpurePoints(); } } elseif ($stmt instanceof InlineHTML) { $hasYield = \false; $throwPoints = []; $impurePoints = [new \PHPStan\Analyser\ImpurePoint($scope, $stmt, 'betweenPhpTags', 'output between PHP opening and closing tags', \true)]; } elseif ($stmt instanceof Node\Stmt\Nop) { $hasYield = \false; $throwPoints = $overridingThrowPoints ?? []; $impurePoints = []; } elseif ($stmt instanceof Node\Stmt\GroupUse) { $hasYield = \false; $throwPoints = []; foreach ($stmt->uses as $use) { $nodeCallback($use, $scope); } $impurePoints = []; } else { $hasYield = \false; $throwPoints = $overridingThrowPoints ?? []; $impurePoints = []; } return new \PHPStan\Analyser\StatementResult($scope, $hasYield, \false, [], $throwPoints, $impurePoints); } /** * @return ThrowPoint[]|null */ private function getOverridingThrowPoints(Node\Stmt $statement, \PHPStan\Analyser\MutatingScope $scope) : ?array { foreach ($statement->getComments() as $comment) { if (!$comment instanceof Doc) { continue; } $function = $scope->getFunction(); $resolvedPhpDoc = $this->fileTypeMapper->getResolvedPhpDoc($scope->getFile(), $scope->isInClass() ? $scope->getClassReflection()->getName() : null, $scope->isInTrait() ? $scope->getTraitReflection()->getName() : null, $function !== null ? $function->getName() : null, $comment->getText()); $throwsTag = $resolvedPhpDoc->getThrowsTag(); if ($throwsTag !== null) { $throwsType = $throwsTag->getType(); if ($throwsType->isVoid()->yes()) { return []; } return [\PHPStan\Analyser\ThrowPoint::createExplicit($scope, $throwsType, $statement, \false)]; } } return null; } private function getCurrentClassReflection(Node\Stmt\ClassLike $stmt, string $className, \PHPStan\Analyser\Scope $scope) : ClassReflection { if (!$this->reflectionProvider->hasClass($className)) { return $this->createAstClassReflection($stmt, $className, $scope); } $defaultClassReflection = $this->reflectionProvider->getClass($className); if ($defaultClassReflection->getFileName() !== $scope->getFile()) { return $this->createAstClassReflection($stmt, $className, $scope); } $startLine = $defaultClassReflection->getNativeReflection()->getStartLine(); if ($startLine !== $stmt->getStartLine()) { return $this->createAstClassReflection($stmt, $className, $scope); } return $defaultClassReflection; } private function createAstClassReflection(Node\Stmt\ClassLike $stmt, string $className, \PHPStan\Analyser\Scope $scope) : ClassReflection { $nodeToReflection = new NodeToReflection(); $betterReflectionClass = $nodeToReflection->__invoke($this->reflector, $stmt, new LocatedSource(FileReader::read($scope->getFile()), $className, $scope->getFile()), $scope->getNamespace() !== null ? new Node\Stmt\Namespace_(new Name($scope->getNamespace())) : null); if (!$betterReflectionClass instanceof \PHPStan\BetterReflection\Reflection\ReflectionClass) { throw new ShouldNotHappenException(); } $enumAdapter = base64_decode('UEhQU3RhblxCZXR0ZXJSZWZsZWN0aW9uXFJlZmxlY3Rpb25cQWRhcHRlclxSZWZsZWN0aW9uRW51bQ==', \true); return new ClassReflection($this->reflectionProvider, $this->initializerExprTypeResolver, $this->fileTypeMapper, $this->stubPhpDocProvider, $this->phpDocInheritanceResolver, $this->phpVersion, $this->signatureMapProvider, $this->classReflectionExtensionRegistryProvider->getRegistry()->getPropertiesClassReflectionExtensions(), $this->classReflectionExtensionRegistryProvider->getRegistry()->getMethodsClassReflectionExtensions(), $this->classReflectionExtensionRegistryProvider->getRegistry()->getAllowedSubTypesClassReflectionExtensions(), $this->classReflectionExtensionRegistryProvider->getRegistry()->getRequireExtendsPropertyClassReflectionExtension(), $this->classReflectionExtensionRegistryProvider->getRegistry()->getRequireExtendsMethodsClassReflectionExtension(), $betterReflectionClass->getName(), $betterReflectionClass instanceof ReflectionEnum && PHP_VERSION_ID >= 80000 ? new $enumAdapter($betterReflectionClass) : new ReflectionClass($betterReflectionClass), null, null, null, $this->universalObjectCratesClasses, sprintf('%s:%d', $scope->getFile(), $stmt->getStartLine())); } private function lookForSetAllowedUndefinedExpressions(\PHPStan\Analyser\MutatingScope $scope, Expr $expr) : \PHPStan\Analyser\MutatingScope { return $this->lookForExpressionCallback($scope, $expr, static function (\PHPStan\Analyser\MutatingScope $scope, Expr $expr) : \PHPStan\Analyser\MutatingScope { return $scope->setAllowedUndefinedExpression($expr); }); } private function lookForUnsetAllowedUndefinedExpressions(\PHPStan\Analyser\MutatingScope $scope, Expr $expr) : \PHPStan\Analyser\MutatingScope { return $this->lookForExpressionCallback($scope, $expr, static function (\PHPStan\Analyser\MutatingScope $scope, Expr $expr) : \PHPStan\Analyser\MutatingScope { return $scope->unsetAllowedUndefinedExpression($expr); }); } /** * @param Closure(MutatingScope $scope, Expr $expr): MutatingScope $callback */ private function lookForExpressionCallback(\PHPStan\Analyser\MutatingScope $scope, Expr $expr, Closure $callback) : \PHPStan\Analyser\MutatingScope { if (!$expr instanceof ArrayDimFetch || $expr->dim !== null) { $scope = $callback($scope, $expr); } if ($expr instanceof ArrayDimFetch) { $scope = $this->lookForExpressionCallback($scope, $expr->var, $callback); } elseif ($expr instanceof PropertyFetch || $expr instanceof Expr\NullsafePropertyFetch) { $scope = $this->lookForExpressionCallback($scope, $expr->var, $callback); } elseif ($expr instanceof StaticPropertyFetch && $expr->class instanceof Expr) { $scope = $this->lookForExpressionCallback($scope, $expr->class, $callback); } elseif ($expr instanceof Array_ || $expr instanceof List_) { foreach ($expr->items as $item) { if ($item === null) { continue; } $scope = $this->lookForExpressionCallback($scope, $item->value, $callback); } } return $scope; } private function ensureShallowNonNullability(\PHPStan\Analyser\MutatingScope $scope, \PHPStan\Analyser\Scope $originalScope, Expr $exprToSpecify) : \PHPStan\Analyser\EnsuredNonNullabilityResult { $exprType = $scope->getType($exprToSpecify); $isNull = $exprType->isNull(); if ($isNull->yes()) { return new \PHPStan\Analyser\EnsuredNonNullabilityResult($scope, []); } // keep certainty $certainty = TrinaryLogic::createYes(); $hasExpressionType = $originalScope->hasExpressionType($exprToSpecify); if (!$hasExpressionType->no()) { $certainty = $hasExpressionType; } $exprTypeWithoutNull = TypeCombinator::removeNull($exprType); if ($exprType->equals($exprTypeWithoutNull)) { $originalExprType = $originalScope->getType($exprToSpecify); if (!$originalExprType->equals($exprTypeWithoutNull)) { $originalNativeType = $originalScope->getNativeType($exprToSpecify); return new \PHPStan\Analyser\EnsuredNonNullabilityResult($scope, [new \PHPStan\Analyser\EnsuredNonNullabilityResultExpression($exprToSpecify, $originalExprType, $originalNativeType, $certainty)]); } return new \PHPStan\Analyser\EnsuredNonNullabilityResult($scope, []); } $nativeType = $scope->getNativeType($exprToSpecify); $scope = $scope->specifyExpressionType($exprToSpecify, $exprTypeWithoutNull, TypeCombinator::removeNull($nativeType)); return new \PHPStan\Analyser\EnsuredNonNullabilityResult($scope, [new \PHPStan\Analyser\EnsuredNonNullabilityResultExpression($exprToSpecify, $exprType, $nativeType, $certainty)]); } private function ensureNonNullability(\PHPStan\Analyser\MutatingScope $scope, Expr $expr) : \PHPStan\Analyser\EnsuredNonNullabilityResult { $specifiedExpressions = []; $originalScope = $scope; $scope = $this->lookForExpressionCallback($scope, $expr, function ($scope, $expr) use(&$specifiedExpressions, $originalScope) { $result = $this->ensureShallowNonNullability($scope, $originalScope, $expr); foreach ($result->getSpecifiedExpressions() as $specifiedExpression) { $specifiedExpressions[] = $specifiedExpression; } return $result->getScope(); }); return new \PHPStan\Analyser\EnsuredNonNullabilityResult($scope, $specifiedExpressions); } /** * @param EnsuredNonNullabilityResultExpression[] $specifiedExpressions */ private function revertNonNullability(\PHPStan\Analyser\MutatingScope $scope, array $specifiedExpressions) : \PHPStan\Analyser\MutatingScope { foreach ($specifiedExpressions as $specifiedExpressionResult) { $scope = $scope->specifyExpressionType($specifiedExpressionResult->getExpression(), $specifiedExpressionResult->getOriginalType(), $specifiedExpressionResult->getOriginalNativeType(), $specifiedExpressionResult->getCertainty()); } return $scope; } private function findEarlyTerminatingExpr(Expr $expr, \PHPStan\Analyser\Scope $scope) : ?Expr { if (($expr instanceof MethodCall || $expr instanceof Expr\StaticCall) && $expr->name instanceof Node\Identifier) { if (array_key_exists($expr->name->toLowerString(), $this->earlyTerminatingMethodNames)) { if ($expr instanceof MethodCall) { $methodCalledOnType = $scope->getType($expr->var); } else { if ($expr->class instanceof Name) { $methodCalledOnType = $scope->resolveTypeByName($expr->class); } else { $methodCalledOnType = $scope->getType($expr->class); } } foreach ($methodCalledOnType->getObjectClassNames() as $referencedClass) { if (!$this->reflectionProvider->hasClass($referencedClass)) { continue; } $classReflection = $this->reflectionProvider->getClass($referencedClass); foreach (array_merge([$referencedClass], $classReflection->getParentClassesNames(), $classReflection->getNativeReflection()->getInterfaceNames()) as $className) { if (!isset($this->earlyTerminatingMethodCalls[$className])) { continue; } if (in_array((string) $expr->name, $this->earlyTerminatingMethodCalls[$className], \true)) { return $expr; } } } } } if ($expr instanceof FuncCall && $expr->name instanceof Name) { if (in_array((string) $expr->name, $this->earlyTerminatingFunctionCalls, \true)) { return $expr; } } if ($expr instanceof Expr\Exit_ || $expr instanceof Expr\Throw_) { return $expr; } $exprType = $scope->getType($expr); if ($exprType instanceof NeverType && $exprType->isExplicit()) { return $expr; } return null; } /** * @param callable(Node $node, Scope $scope): void $nodeCallback */ public function processExprNode(Node\Stmt $stmt, Expr $expr, \PHPStan\Analyser\MutatingScope $scope, callable $nodeCallback, \PHPStan\Analyser\ExpressionContext $context) : \PHPStan\Analyser\ExpressionResult { if ($expr instanceof Expr\CallLike && $expr->isFirstClassCallable()) { if ($expr instanceof FuncCall) { $newExpr = new FunctionCallableNode($expr->name, $expr); } elseif ($expr instanceof MethodCall) { $newExpr = new MethodCallableNode($expr->var, $expr->name, $expr); } elseif ($expr instanceof StaticCall) { $newExpr = new StaticMethodCallableNode($expr->class, $expr->name, $expr); } elseif ($expr instanceof New_ && !$expr->class instanceof Class_) { $newExpr = new InstantiationCallableNode($expr->class, $expr); } else { throw new ShouldNotHappenException(); } return $this->processExprNode($stmt, $newExpr, $scope, $nodeCallback, $context); } $this->callNodeCallbackWithExpression($nodeCallback, $expr, $scope, $context); if ($expr instanceof Variable) { $hasYield = \false; $throwPoints = []; $impurePoints = []; if ($expr->name instanceof Expr) { return $this->processExprNode($stmt, $expr->name, $scope, $nodeCallback, $context->enterDeep()); } elseif (in_array($expr->name, \PHPStan\Analyser\Scope::SUPERGLOBAL_VARIABLES, \true)) { $impurePoints[] = new \PHPStan\Analyser\ImpurePoint($scope, $expr, 'superglobal', 'access to superglobal variable', \true); } } elseif ($expr instanceof Assign || $expr instanceof AssignRef) { $result = $this->processAssignVar($scope, $stmt, $expr->var, $expr->expr, $nodeCallback, $context, function (\PHPStan\Analyser\MutatingScope $scope) use($stmt, $expr, $nodeCallback, $context) : \PHPStan\Analyser\ExpressionResult { $impurePoints = []; if ($expr instanceof AssignRef) { $referencedExpr = $expr->expr; while ($referencedExpr instanceof ArrayDimFetch) { $referencedExpr = $referencedExpr->var; } if ($referencedExpr instanceof PropertyFetch || $referencedExpr instanceof StaticPropertyFetch) { $impurePoints[] = new \PHPStan\Analyser\ImpurePoint($scope, $expr, 'propertyAssignByRef', 'property assignment by reference', \false); } $scope = $scope->enterExpressionAssign($expr->expr); } if ($expr->var instanceof Variable && is_string($expr->var->name)) { $context = $context->enterRightSideAssign($expr->var->name, $scope->getType($expr->expr), $scope->getNativeType($expr->expr)); } $result = $this->processExprNode($stmt, $expr->expr, $scope, $nodeCallback, $context->enterDeep()); $hasYield = $result->hasYield(); $throwPoints = $result->getThrowPoints(); $impurePoints = array_merge($impurePoints, $result->getImpurePoints()); $scope = $result->getScope(); if ($expr instanceof AssignRef) { $scope = $scope->exitExpressionAssign($expr->expr); } return new \PHPStan\Analyser\ExpressionResult($scope, $hasYield, $throwPoints, $impurePoints); }, \true); $scope = $result->getScope(); $hasYield = $result->hasYield(); $throwPoints = $result->getThrowPoints(); $impurePoints = $result->getImpurePoints(); $vars = $this->getAssignedVariables($expr->var); if (count($vars) > 0) { $varChangedScope = \false; $scope = $this->processVarAnnotation($scope, $vars, $stmt, $varChangedScope); if (!$varChangedScope) { $scope = $this->processStmtVarAnnotation($scope, $stmt, null, $nodeCallback); } } } elseif ($expr instanceof Expr\AssignOp) { $result = $this->processAssignVar($scope, $stmt, $expr->var, $expr, $nodeCallback, $context, function (\PHPStan\Analyser\MutatingScope $scope) use($stmt, $expr, $nodeCallback, $context) : \PHPStan\Analyser\ExpressionResult { $originalScope = $scope; if ($expr instanceof Expr\AssignOp\Coalesce) { $scope = $scope->filterByFalseyValue(new BinaryOp\NotIdentical($expr->var, new ConstFetch(new Name('null')))); } $result = $this->processExprNode($stmt, $expr->expr, $scope, $nodeCallback, $context->enterDeep()); if ($expr instanceof Expr\AssignOp\Coalesce) { return new \PHPStan\Analyser\ExpressionResult($result->getScope()->mergeWith($originalScope), $result->hasYield(), $result->getThrowPoints(), $result->getImpurePoints()); } return $result; }, $expr instanceof Expr\AssignOp\Coalesce); $scope = $result->getScope(); $hasYield = $result->hasYield(); $throwPoints = $result->getThrowPoints(); $impurePoints = $result->getImpurePoints(); if (($expr instanceof Expr\AssignOp\Div || $expr instanceof Expr\AssignOp\Mod) && !$scope->getType($expr->expr)->toNumber()->isSuperTypeOf(new ConstantIntegerType(0))->no()) { $throwPoints[] = \PHPStan\Analyser\ThrowPoint::createExplicit($scope, new ObjectType(DivisionByZeroError::class), $expr, \false); } } elseif ($expr instanceof FuncCall) { $parametersAcceptor = null; $functionReflection = null; $throwPoints = []; $impurePoints = []; if ($expr->name instanceof Expr) { $nameType = $scope->getType($expr->name); if (!$nameType->isCallable()->no()) { $parametersAcceptor = ParametersAcceptorSelector::selectFromArgs($scope, $expr->getArgs(), $nameType->getCallableParametersAcceptors($scope), null); } $nameResult = $this->processExprNode($stmt, $expr->name, $scope, $nodeCallback, $context->enterDeep()); $scope = $nameResult->getScope(); $throwPoints = $nameResult->getThrowPoints(); $impurePoints = $nameResult->getImpurePoints(); if ($nameType->isObject()->yes() && $nameType->isCallable()->yes() && (new ObjectType(Closure::class))->isSuperTypeOf($nameType)->no()) { $invokeResult = $this->processExprNode($stmt, new MethodCall($expr->name, '__invoke', $expr->getArgs(), $expr->getAttributes()), $scope, static function () : void { }, $context->enterDeep()); $throwPoints = array_merge($throwPoints, $invokeResult->getThrowPoints()); $impurePoints = array_merge($impurePoints, $invokeResult->getImpurePoints()); } elseif ($parametersAcceptor instanceof CallableParametersAcceptor) { $callableThrowPoints = array_map(static function (SimpleThrowPoint $throwPoint) use($scope, $expr) { return $throwPoint->isExplicit() ? \PHPStan\Analyser\ThrowPoint::createExplicit($scope, $throwPoint->getType(), $expr, $throwPoint->canContainAnyThrowable()) : \PHPStan\Analyser\ThrowPoint::createImplicit($scope, $expr); }, $parametersAcceptor->getThrowPoints()); if (!$this->implicitThrows) { $callableThrowPoints = array_values(array_filter($callableThrowPoints, static function (\PHPStan\Analyser\ThrowPoint $throwPoint) { return $throwPoint->isExplicit(); })); } $throwPoints = array_merge($throwPoints, $callableThrowPoints); $impurePoints = array_merge($impurePoints, array_map(static function (SimpleImpurePoint $impurePoint) use($scope, $expr) { return new \PHPStan\Analyser\ImpurePoint($scope, $expr, $impurePoint->getIdentifier(), $impurePoint->getDescription(), $impurePoint->isCertain()); }, $parametersAcceptor->getImpurePoints())); $scope = $this->processImmediatelyCalledCallable($scope, $parametersAcceptor->getInvalidateExpressions(), $parametersAcceptor->getUsedVariables()); } } elseif ($this->reflectionProvider->hasFunction($expr->name, $scope)) { $functionReflection = $this->reflectionProvider->getFunction($expr->name, $scope); $parametersAcceptor = ParametersAcceptorSelector::selectFromArgs($scope, $expr->getArgs(), $functionReflection->getVariants(), $functionReflection->getNamedArgumentsVariants()); $impurePoint = SimpleImpurePoint::createFromVariant($functionReflection, $parametersAcceptor); if ($impurePoint !== null) { $impurePoints[] = new \PHPStan\Analyser\ImpurePoint($scope, $expr, $impurePoint->getIdentifier(), $impurePoint->getDescription(), $impurePoint->isCertain()); } } else { $impurePoints[] = new \PHPStan\Analyser\ImpurePoint($scope, $expr, 'functionCall', 'call to unknown function', \false); } if ($parametersAcceptor !== null) { $expr = \PHPStan\Analyser\ArgumentsNormalizer::reorderFuncArguments($parametersAcceptor, $expr) ?? $expr; } $result = $this->processArgs($stmt, $functionReflection, null, $parametersAcceptor, $expr, $scope, $nodeCallback, $context); $scope = $result->getScope(); $hasYield = $result->hasYield(); $throwPoints = array_merge($throwPoints, $result->getThrowPoints()); $impurePoints = array_merge($impurePoints, $result->getImpurePoints()); if ($functionReflection !== null) { $functionThrowPoint = $this->getFunctionThrowPoint($functionReflection, $parametersAcceptor, $expr, $scope); if ($functionThrowPoint !== null) { $throwPoints[] = $functionThrowPoint; } } else { $throwPoints[] = \PHPStan\Analyser\ThrowPoint::createImplicit($scope, $expr); } if ($functionReflection !== null && in_array($functionReflection->getName(), ['json_encode', 'json_decode'], \true)) { $scope = $scope->invalidateExpression(new FuncCall(new Name('json_last_error'), []))->invalidateExpression(new FuncCall(new Name\FullyQualified('json_last_error'), []))->invalidateExpression(new FuncCall(new Name('json_last_error_msg'), []))->invalidateExpression(new FuncCall(new Name\FullyQualified('json_last_error_msg'), [])); } if ($functionReflection !== null && $functionReflection->getName() === 'file_put_contents' && count($expr->getArgs()) > 0) { $scope = $scope->invalidateExpression(new FuncCall(new Name('file_get_contents'), [$expr->getArgs()[0]]))->invalidateExpression(new FuncCall(new Name\FullyQualified('file_get_contents'), [$expr->getArgs()[0]])); } if ($functionReflection !== null && in_array($functionReflection->getName(), ['array_pop', 'array_shift'], \true) && count($expr->getArgs()) >= 1) { $arrayArg = $expr->getArgs()[0]->value; $arrayArgType = $scope->getType($arrayArg); $arrayArgNativeType = $scope->getNativeType($arrayArg); $isArrayPop = $functionReflection->getName() === 'array_pop'; $scope = $scope->invalidateExpression($arrayArg)->assignExpression($arrayArg, $isArrayPop ? $arrayArgType->popArray() : $arrayArgType->shiftArray(), $isArrayPop ? $arrayArgNativeType->popArray() : $arrayArgNativeType->shiftArray()); } if ($functionReflection !== null && in_array($functionReflection->getName(), ['array_push', 'array_unshift'], \true) && count($expr->getArgs()) >= 2) { $arrayType = $this->getArrayFunctionAppendingType($functionReflection, $scope, $expr); $arrayNativeType = $this->getArrayFunctionAppendingType($functionReflection, $scope->doNotTreatPhpDocTypesAsCertain(), $expr); $arrayArg = $expr->getArgs()[0]->value; $scope = $scope->invalidateExpression($arrayArg)->assignExpression($arrayArg, $arrayType, $arrayNativeType); } if ($functionReflection !== null && in_array($functionReflection->getName(), ['fopen', 'file_get_contents'], \true)) { $scope = $scope->assignVariable('http_response_header', AccessoryArrayListType::intersectWith(new ArrayType(new IntegerType(), new StringType())), new ArrayType(new IntegerType(), new StringType())); } if ($functionReflection !== null && $functionReflection->getName() === 'shuffle') { $arrayArg = $expr->getArgs()[0]->value; $scope = $scope->assignExpression($arrayArg, $scope->getType($arrayArg)->shuffleArray(), $scope->getNativeType($arrayArg)->shuffleArray()); } if ($functionReflection !== null && $functionReflection->getName() === 'array_splice' && count($expr->getArgs()) >= 1) { $arrayArg = $expr->getArgs()[0]->value; $arrayArgType = $scope->getType($arrayArg); $valueType = $arrayArgType->getIterableValueType(); if (count($expr->getArgs()) >= 4) { $replacementType = $scope->getType($expr->getArgs()[3]->value)->toArray(); $valueType = TypeCombinator::union($valueType, $replacementType->getIterableValueType()); } $scope = $scope->invalidateExpression($arrayArg)->assignExpression($arrayArg, new ArrayType($arrayArgType->getIterableKeyType(), $valueType), new ArrayType($arrayArgType->getIterableKeyType(), $valueType)); } if ($functionReflection !== null && in_array($functionReflection->getName(), ['sort', 'rsort', 'usort'], \true) && count($expr->getArgs()) >= 1) { $arrayArg = $expr->getArgs()[0]->value; $scope = $scope->assignExpression($arrayArg, $this->getArraySortPreserveListFunctionType($scope->getType($arrayArg)), $this->getArraySortPreserveListFunctionType($scope->getNativeType($arrayArg))); } if ($functionReflection !== null && in_array($functionReflection->getName(), ['natcasesort', 'natsort', 'arsort', 'asort', 'ksort', 'krsort', 'uasort', 'uksort'], \true) && count($expr->getArgs()) >= 1) { $arrayArg = $expr->getArgs()[0]->value; $scope = $scope->assignExpression($arrayArg, $this->getArraySortDoNotPreserveListFunctionType($scope->getType($arrayArg)), $this->getArraySortDoNotPreserveListFunctionType($scope->getNativeType($arrayArg))); } if ($functionReflection !== null && $functionReflection->getName() === 'extract') { $extractedArg = $expr->getArgs()[0]->value; $extractedType = $scope->getType($extractedArg); $constantArrays = $extractedType->getConstantArrays(); if (count($constantArrays) > 0) { $properties = []; $optionalProperties = []; $refCount = []; foreach ($constantArrays as $constantArray) { foreach ($constantArray->getKeyTypes() as $i => $keyType) { if ($keyType->isString()->no()) { // integers as variable names not allowed continue; } $key = (string) $keyType->getValue(); $valueType = $constantArray->getValueTypes()[$i]; $optional = $constantArray->isOptionalKey($i); if ($optional) { $optionalProperties[] = $key; } if (isset($properties[$key])) { $properties[$key] = TypeCombinator::union($properties[$key], $valueType); $refCount[$key]++; } else { $properties[$key] = $valueType; $refCount[$key] = 1; } } } foreach ($properties as $name => $type) { $optional = in_array($name, $optionalProperties, \true) || $refCount[$name] < count($constantArrays); $scope = $scope->assignVariable($name, $type, $type, $optional ? TrinaryLogic::createMaybe() : TrinaryLogic::createYes()); } } else { $scope = $scope->afterExtractCall(); } } if ($functionReflection !== null && in_array($functionReflection->getName(), ['clearstatcache', 'unlink'], \true)) { $scope = $scope->afterClearstatcacheCall(); } if ($functionReflection !== null && str_starts_with($functionReflection->getName(), 'openssl')) { $scope = $scope->afterOpenSslCall($functionReflection->getName()); } } elseif ($expr instanceof MethodCall) { $originalScope = $scope; if (($expr->var instanceof Expr\Closure || $expr->var instanceof Expr\ArrowFunction) && $expr->name instanceof Node\Identifier && strtolower($expr->name->name) === 'call' && isset($expr->getArgs()[0])) { $closureCallScope = $scope->enterClosureCall($scope->getType($expr->getArgs()[0]->value), $scope->getNativeType($expr->getArgs()[0]->value)); } $result = $this->processExprNode($stmt, $expr->var, $closureCallScope ?? $scope, $nodeCallback, $context->enterDeep()); $hasYield = $result->hasYield(); $throwPoints = $result->getThrowPoints(); $impurePoints = $result->getImpurePoints(); $scope = $result->getScope(); if (isset($closureCallScope)) { $scope = $scope->restoreOriginalScopeAfterClosureBind($originalScope); } $parametersAcceptor = null; $methodReflection = null; $calledOnType = $scope->getType($expr->var); if ($expr->name instanceof Expr) { $methodNameResult = $this->processExprNode($stmt, $expr->name, $scope, $nodeCallback, $context->enterDeep()); $throwPoints = array_merge($throwPoints, $methodNameResult->getThrowPoints()); $scope = $methodNameResult->getScope(); } else { $methodName = $expr->name->name; $methodReflection = $scope->getMethodReflection($calledOnType, $methodName); if ($methodReflection !== null) { $parametersAcceptor = ParametersAcceptorSelector::selectFromArgs($scope, $expr->getArgs(), $methodReflection->getVariants(), $methodReflection->getNamedArgumentsVariants()); $methodThrowPoint = $this->getMethodThrowPoint($methodReflection, $parametersAcceptor, $expr, $scope); if ($methodThrowPoint !== null) { $throwPoints[] = $methodThrowPoint; } } } if ($methodReflection !== null) { $impurePoint = SimpleImpurePoint::createFromVariant($methodReflection, $parametersAcceptor); if ($impurePoint !== null) { $impurePoints[] = new \PHPStan\Analyser\ImpurePoint($scope, $expr, $impurePoint->getIdentifier(), $impurePoint->getDescription(), $impurePoint->isCertain()); } } else { $impurePoints[] = new \PHPStan\Analyser\ImpurePoint($scope, $expr, 'methodCall', 'call to unknown method', \false); } if ($parametersAcceptor !== null) { $expr = \PHPStan\Analyser\ArgumentsNormalizer::reorderMethodArguments($parametersAcceptor, $expr) ?? $expr; } $result = $this->processArgs($stmt, $methodReflection, $methodReflection !== null ? $scope->getNakedMethod($calledOnType, $methodReflection->getName()) : null, $parametersAcceptor, $expr, $scope, $nodeCallback, $context); $scope = $result->getScope(); if ($methodReflection !== null) { $hasSideEffects = $methodReflection->hasSideEffects(); if ($hasSideEffects->yes() || $methodReflection->getName() === '__construct') { $nodeCallback(new InvalidateExprNode($expr->var), $scope); $scope = $scope->invalidateExpression($expr->var, \true); } if ($parametersAcceptor !== null && !$methodReflection->isStatic()) { $selfOutType = $methodReflection->getSelfOutType(); if ($selfOutType !== null) { $scope = $scope->assignExpression($expr->var, TemplateTypeHelper::resolveTemplateTypes($selfOutType, $parametersAcceptor->getResolvedTemplateTypeMap(), $parametersAcceptor instanceof ParametersAcceptorWithPhpDocs ? $parametersAcceptor->getCallSiteVarianceMap() : TemplateTypeVarianceMap::createEmpty(), TemplateTypeVariance::createCovariant()), $scope->getNativeType($expr->var)); } } if ($scope->isInClass() && $scope->getClassReflection()->getName() === $methodReflection->getDeclaringClass()->getName() && TypeUtils::findThisType($calledOnType) !== null) { $calledMethodScope = $this->processCalledMethod($methodReflection); if ($calledMethodScope !== null) { $scope = $scope->mergeInitializedProperties($calledMethodScope); } } } else { $throwPoints[] = \PHPStan\Analyser\ThrowPoint::createImplicit($scope, $expr); } $hasYield = $hasYield || $result->hasYield(); $throwPoints = array_merge($throwPoints, $result->getThrowPoints()); $impurePoints = array_merge($impurePoints, $result->getImpurePoints()); } elseif ($expr instanceof Expr\NullsafeMethodCall) { $nonNullabilityResult = $this->ensureShallowNonNullability($scope, $scope, $expr->var); $exprResult = $this->processExprNode($stmt, new MethodCall($expr->var, $expr->name, $expr->args, array_merge($expr->getAttributes(), ['virtualNullsafeMethodCall' => \true])), $nonNullabilityResult->getScope(), $nodeCallback, $context); $scope = $this->revertNonNullability($exprResult->getScope(), $nonNullabilityResult->getSpecifiedExpressions()); return new \PHPStan\Analyser\ExpressionResult($scope, $exprResult->hasYield(), $exprResult->getThrowPoints(), $exprResult->getImpurePoints(), static function () use($scope, $expr) : \PHPStan\Analyser\MutatingScope { return $scope->filterByTruthyValue($expr); }, static function () use($scope, $expr) : \PHPStan\Analyser\MutatingScope { return $scope->filterByFalseyValue($expr); }); } elseif ($expr instanceof StaticCall) { $hasYield = \false; $throwPoints = []; $impurePoints = []; if ($expr->class instanceof Expr) { $objectClasses = $scope->getType($expr->class)->getObjectClassNames(); if (count($objectClasses) !== 1) { $objectClasses = $scope->getType(new New_($expr->class))->getObjectClassNames(); } if (count($objectClasses) === 1) { $objectExprResult = $this->processExprNode($stmt, new StaticCall(new Name($objectClasses[0]), $expr->name, []), $scope, static function () : void { }, $context->enterDeep()); $additionalThrowPoints = $objectExprResult->getThrowPoints(); } else { $additionalThrowPoints = [\PHPStan\Analyser\ThrowPoint::createImplicit($scope, $expr)]; } $classResult = $this->processExprNode($stmt, $expr->class, $scope, $nodeCallback, $context->enterDeep()); $hasYield = $classResult->hasYield(); $throwPoints = array_merge($throwPoints, $classResult->getThrowPoints()); $impurePoints = array_merge($impurePoints, $classResult->getImpurePoints()); foreach ($additionalThrowPoints as $throwPoint) { $throwPoints[] = $throwPoint; } $scope = $classResult->getScope(); } $parametersAcceptor = null; $methodReflection = null; if ($expr->name instanceof Expr) { $result = $this->processExprNode($stmt, $expr->name, $scope, $nodeCallback, $context->enterDeep()); $hasYield = $hasYield || $result->hasYield(); $throwPoints = array_merge($throwPoints, $result->getThrowPoints()); $impurePoints = array_merge($impurePoints, $result->getImpurePoints()); $scope = $result->getScope(); } elseif ($expr->class instanceof Name) { $classType = $scope->resolveTypeByName($expr->class); $methodName = $expr->name->name; if ($classType->hasMethod($methodName)->yes()) { $methodReflection = $classType->getMethod($methodName, $scope); $parametersAcceptor = ParametersAcceptorSelector::selectFromArgs($scope, $expr->getArgs(), $methodReflection->getVariants(), $methodReflection->getNamedArgumentsVariants()); $methodThrowPoint = $this->getStaticMethodThrowPoint($methodReflection, $parametersAcceptor, $expr, $scope); if ($methodThrowPoint !== null) { $throwPoints[] = $methodThrowPoint; } $declaringClass = $methodReflection->getDeclaringClass(); if ($declaringClass->getName() === 'Closure' && strtolower($methodName) === 'bind') { $thisType = null; $nativeThisType = null; if (isset($expr->getArgs()[1])) { $argType = $scope->getType($expr->getArgs()[1]->value); if ($argType->isNull()->yes()) { $thisType = null; } else { $thisType = $argType; } $nativeArgType = $scope->getNativeType($expr->getArgs()[1]->value); if ($nativeArgType->isNull()->yes()) { $nativeThisType = null; } else { $nativeThisType = $nativeArgType; } } $scopeClasses = ['static']; if (isset($expr->getArgs()[2])) { $argValue = $expr->getArgs()[2]->value; $argValueType = $scope->getType($argValue); $directClassNames = $argValueType->getObjectClassNames(); if (count($directClassNames) > 0) { $scopeClasses = $directClassNames; $thisTypes = []; foreach ($directClassNames as $directClassName) { $thisTypes[] = new ObjectType($directClassName); } $thisType = TypeCombinator::union(...$thisTypes); } else { $thisType = $argValueType->getClassStringObjectType(); $scopeClasses = $thisType->getObjectClassNames(); } } $closureBindScope = $scope->enterClosureBind($thisType, $nativeThisType, $scopeClasses); } } else { $throwPoints[] = \PHPStan\Analyser\ThrowPoint::createImplicit($scope, $expr); } } if ($methodReflection !== null) { $impurePoint = SimpleImpurePoint::createFromVariant($methodReflection, $parametersAcceptor); if ($impurePoint !== null) { $impurePoints[] = new \PHPStan\Analyser\ImpurePoint($scope, $expr, $impurePoint->getIdentifier(), $impurePoint->getDescription(), $impurePoint->isCertain()); } } else { $impurePoints[] = new \PHPStan\Analyser\ImpurePoint($scope, $expr, 'methodCall', 'call to unknown method', \false); } if ($parametersAcceptor !== null) { $expr = \PHPStan\Analyser\ArgumentsNormalizer::reorderStaticCallArguments($parametersAcceptor, $expr) ?? $expr; } $result = $this->processArgs($stmt, $methodReflection, null, $parametersAcceptor, $expr, $scope, $nodeCallback, $context, $closureBindScope ?? null); $scope = $result->getScope(); $scopeFunction = $scope->getFunction(); if ($methodReflection !== null && !$methodReflection->isStatic() && ($methodReflection->hasSideEffects()->yes() || $methodReflection->getName() === '__construct') && $scopeFunction instanceof MethodReflection && !$scopeFunction->isStatic() && $scope->isInClass() && ($scope->getClassReflection()->getName() === $methodReflection->getDeclaringClass()->getName() || $scope->getClassReflection()->isSubclassOf($methodReflection->getDeclaringClass()->getName()))) { $scope = $scope->invalidateExpression(new Variable('this'), \true); } if ($methodReflection !== null && !$methodReflection->isStatic() && $methodReflection->getName() === '__construct' && $scopeFunction instanceof MethodReflection && !$scopeFunction->isStatic() && $scope->isInClass() && $scope->getClassReflection()->isSubclassOf($methodReflection->getDeclaringClass()->getName())) { $thisType = $scope->getType(new Variable('this')); $methodClassReflection = $methodReflection->getDeclaringClass(); foreach ($methodClassReflection->getNativeReflection()->getProperties(ReflectionProperty::IS_PUBLIC | ReflectionProperty::IS_PROTECTED) as $property) { if (!$property->isPromoted() || $property->getDeclaringClass()->getName() !== $methodClassReflection->getName()) { continue; } $scope = $scope->assignInitializedProperty($thisType, $property->getName()); } } $hasYield = $hasYield || $result->hasYield(); $throwPoints = array_merge($throwPoints, $result->getThrowPoints()); $impurePoints = array_merge($impurePoints, $result->getImpurePoints()); } elseif ($expr instanceof PropertyFetch) { $result = $this->processExprNode($stmt, $expr->var, $scope, $nodeCallback, $context->enterDeep()); $hasYield = $result->hasYield(); $throwPoints = $result->getThrowPoints(); $impurePoints = $result->getImpurePoints(); $scope = $result->getScope(); if ($expr->name instanceof Expr) { $result = $this->processExprNode($stmt, $expr->name, $scope, $nodeCallback, $context->enterDeep()); $hasYield = $hasYield || $result->hasYield(); $throwPoints = array_merge($throwPoints, $result->getThrowPoints()); $impurePoints = array_merge($impurePoints, $result->getImpurePoints()); $scope = $result->getScope(); } } elseif ($expr instanceof Expr\NullsafePropertyFetch) { $nonNullabilityResult = $this->ensureShallowNonNullability($scope, $scope, $expr->var); $exprResult = $this->processExprNode($stmt, new PropertyFetch($expr->var, $expr->name, array_merge($expr->getAttributes(), ['virtualNullsafePropertyFetch' => \true])), $nonNullabilityResult->getScope(), $nodeCallback, $context); $scope = $this->revertNonNullability($exprResult->getScope(), $nonNullabilityResult->getSpecifiedExpressions()); return new \PHPStan\Analyser\ExpressionResult($scope, $exprResult->hasYield(), $exprResult->getThrowPoints(), $exprResult->getImpurePoints(), static function () use($scope, $expr) : \PHPStan\Analyser\MutatingScope { return $scope->filterByTruthyValue($expr); }, static function () use($scope, $expr) : \PHPStan\Analyser\MutatingScope { return $scope->filterByFalseyValue($expr); }); } elseif ($expr instanceof StaticPropertyFetch) { $hasYield = \false; $throwPoints = []; $impurePoints = []; if ($expr->class instanceof Expr) { $result = $this->processExprNode($stmt, $expr->class, $scope, $nodeCallback, $context->enterDeep()); $hasYield = $result->hasYield(); $throwPoints = $result->getThrowPoints(); $impurePoints = $result->getImpurePoints(); $scope = $result->getScope(); } if ($expr->name instanceof Expr) { $result = $this->processExprNode($stmt, $expr->name, $scope, $nodeCallback, $context->enterDeep()); $hasYield = $hasYield || $result->hasYield(); $throwPoints = array_merge($throwPoints, $result->getThrowPoints()); $impurePoints = array_merge($impurePoints, $result->getImpurePoints()); $scope = $result->getScope(); } } elseif ($expr instanceof Expr\Closure) { $processClosureResult = $this->processClosureNode($stmt, $expr, $scope, $nodeCallback, $context, null); return new \PHPStan\Analyser\ExpressionResult($processClosureResult->getScope(), \false, [], []); } elseif ($expr instanceof Expr\ArrowFunction) { $result = $this->processArrowFunctionNode($stmt, $expr, $scope, $nodeCallback, null); return new \PHPStan\Analyser\ExpressionResult($result->getScope(), $result->hasYield(), [], []); } elseif ($expr instanceof ErrorSuppress) { $result = $this->processExprNode($stmt, $expr->expr, $scope, $nodeCallback, $context); $hasYield = $result->hasYield(); $throwPoints = $result->getThrowPoints(); $impurePoints = $result->getImpurePoints(); $scope = $result->getScope(); } elseif ($expr instanceof Exit_) { $hasYield = \false; $throwPoints = []; $kind = $expr->getAttribute('kind', Exit_::KIND_EXIT); $identifier = $kind === Exit_::KIND_DIE ? 'die' : 'exit'; $impurePoints = [new \PHPStan\Analyser\ImpurePoint($scope, $expr, $identifier, $identifier, \true)]; if ($expr->expr !== null) { $result = $this->processExprNode($stmt, $expr->expr, $scope, $nodeCallback, $context->enterDeep()); $hasYield = $result->hasYield(); $throwPoints = $result->getThrowPoints(); $impurePoints = array_merge($impurePoints, $result->getImpurePoints()); $scope = $result->getScope(); } } elseif ($expr instanceof Node\Scalar\Encapsed) { $hasYield = \false; $throwPoints = []; $impurePoints = []; foreach ($expr->parts as $part) { $result = $this->processExprNode($stmt, $part, $scope, $nodeCallback, $context->enterDeep()); $hasYield = $hasYield || $result->hasYield(); $throwPoints = array_merge($throwPoints, $result->getThrowPoints()); $impurePoints = array_merge($impurePoints, $result->getImpurePoints()); $scope = $result->getScope(); } } elseif ($expr instanceof ArrayDimFetch) { $hasYield = \false; $throwPoints = []; $impurePoints = []; if ($expr->dim !== null) { $result = $this->processExprNode($stmt, $expr->dim, $scope, $nodeCallback, $context->enterDeep()); $hasYield = $result->hasYield(); $throwPoints = $result->getThrowPoints(); $impurePoints = $result->getImpurePoints(); $scope = $result->getScope(); } $result = $this->processExprNode($stmt, $expr->var, $scope, $nodeCallback, $context->enterDeep()); $hasYield = $hasYield || $result->hasYield(); $throwPoints = array_merge($throwPoints, $result->getThrowPoints()); $impurePoints = array_merge($impurePoints, $result->getImpurePoints()); $scope = $result->getScope(); } elseif ($expr instanceof Array_) { $itemNodes = []; $hasYield = \false; $throwPoints = []; $impurePoints = []; foreach ($expr->items as $arrayItem) { $itemNodes[] = new LiteralArrayItem($scope, $arrayItem); if ($arrayItem === null) { continue; } $nodeCallback($arrayItem, $scope); if ($arrayItem->key !== null) { $keyResult = $this->processExprNode($stmt, $arrayItem->key, $scope, $nodeCallback, $context->enterDeep()); $hasYield = $hasYield || $keyResult->hasYield(); $throwPoints = array_merge($throwPoints, $keyResult->getThrowPoints()); $impurePoints = array_merge($impurePoints, $keyResult->getImpurePoints()); $scope = $keyResult->getScope(); } $valueResult = $this->processExprNode($stmt, $arrayItem->value, $scope, $nodeCallback, $context->enterDeep()); $hasYield = $hasYield || $valueResult->hasYield(); $throwPoints = array_merge($throwPoints, $valueResult->getThrowPoints()); $impurePoints = array_merge($impurePoints, $valueResult->getImpurePoints()); $scope = $valueResult->getScope(); } $nodeCallback(new LiteralArrayNode($expr, $itemNodes), $scope); } elseif ($expr instanceof BooleanAnd || $expr instanceof BinaryOp\LogicalAnd) { $leftResult = $this->processExprNode($stmt, $expr->left, $scope, $nodeCallback, $context->enterDeep()); $rightResult = $this->processExprNode($stmt, $expr->right, $leftResult->getTruthyScope(), $nodeCallback, $context); $rightExprType = $rightResult->getScope()->getType($expr->right); if ($rightExprType instanceof NeverType && $rightExprType->isExplicit()) { $leftMergedWithRightScope = $leftResult->getFalseyScope(); } else { $leftMergedWithRightScope = $leftResult->getScope()->mergeWith($rightResult->getScope()); } $this->callNodeCallbackWithExpression($nodeCallback, new BooleanAndNode($expr, $leftResult->getTruthyScope()), $scope, $context); return new \PHPStan\Analyser\ExpressionResult($leftMergedWithRightScope, $leftResult->hasYield() || $rightResult->hasYield(), array_merge($leftResult->getThrowPoints(), $rightResult->getThrowPoints()), array_merge($leftResult->getImpurePoints(), $rightResult->getImpurePoints()), static function () use($rightResult, $expr) : \PHPStan\Analyser\MutatingScope { return $rightResult->getScope()->filterByTruthyValue($expr); }, static function () use($leftMergedWithRightScope, $expr) : \PHPStan\Analyser\MutatingScope { return $leftMergedWithRightScope->filterByFalseyValue($expr); }); } elseif ($expr instanceof BooleanOr || $expr instanceof BinaryOp\LogicalOr) { $leftResult = $this->processExprNode($stmt, $expr->left, $scope, $nodeCallback, $context->enterDeep()); $rightResult = $this->processExprNode($stmt, $expr->right, $leftResult->getFalseyScope(), $nodeCallback, $context); $rightExprType = $rightResult->getScope()->getType($expr->right); if ($rightExprType instanceof NeverType && $rightExprType->isExplicit()) { $leftMergedWithRightScope = $leftResult->getTruthyScope(); } else { $leftMergedWithRightScope = $leftResult->getScope()->mergeWith($rightResult->getScope()); } $this->callNodeCallbackWithExpression($nodeCallback, new BooleanOrNode($expr, $leftResult->getFalseyScope()), $scope, $context); return new \PHPStan\Analyser\ExpressionResult($leftMergedWithRightScope, $leftResult->hasYield() || $rightResult->hasYield(), array_merge($leftResult->getThrowPoints(), $rightResult->getThrowPoints()), array_merge($leftResult->getImpurePoints(), $rightResult->getImpurePoints()), static function () use($leftMergedWithRightScope, $expr) : \PHPStan\Analyser\MutatingScope { return $leftMergedWithRightScope->filterByTruthyValue($expr); }, static function () use($rightResult, $expr) : \PHPStan\Analyser\MutatingScope { return $rightResult->getScope()->filterByFalseyValue($expr); }); } elseif ($expr instanceof Coalesce) { $nonNullabilityResult = $this->ensureNonNullability($scope, $expr->left); $condScope = $this->lookForSetAllowedUndefinedExpressions($nonNullabilityResult->getScope(), $expr->left); $condResult = $this->processExprNode($stmt, $expr->left, $condScope, $nodeCallback, $context->enterDeep()); $scope = $this->revertNonNullability($condResult->getScope(), $nonNullabilityResult->getSpecifiedExpressions()); $scope = $this->lookForUnsetAllowedUndefinedExpressions($scope, $expr->left); $rightScope = $scope->filterByFalseyValue($expr); $rightResult = $this->processExprNode($stmt, $expr->right, $rightScope, $nodeCallback, $context->enterDeep()); $rightExprType = $scope->getType($expr->right); if ($rightExprType instanceof NeverType && $rightExprType->isExplicit()) { $scope = $scope->filterByTruthyValue(new Expr\Isset_([$expr->left])); } else { $scope = $scope->filterByTruthyValue(new Expr\Isset_([$expr->left]))->mergeWith($rightResult->getScope()); } $hasYield = $condResult->hasYield() || $rightResult->hasYield(); $throwPoints = array_merge($condResult->getThrowPoints(), $rightResult->getThrowPoints()); $impurePoints = array_merge($condResult->getImpurePoints(), $rightResult->getImpurePoints()); } elseif ($expr instanceof BinaryOp) { $result = $this->processExprNode($stmt, $expr->left, $scope, $nodeCallback, $context->enterDeep()); $scope = $result->getScope(); $hasYield = $result->hasYield(); $throwPoints = $result->getThrowPoints(); $impurePoints = $result->getImpurePoints(); $result = $this->processExprNode($stmt, $expr->right, $scope, $nodeCallback, $context->enterDeep()); if (($expr instanceof BinaryOp\Div || $expr instanceof BinaryOp\Mod) && !$scope->getType($expr->right)->toNumber()->isSuperTypeOf(new ConstantIntegerType(0))->no()) { $throwPoints[] = \PHPStan\Analyser\ThrowPoint::createExplicit($scope, new ObjectType(DivisionByZeroError::class), $expr, \false); } $scope = $result->getScope(); $hasYield = $hasYield || $result->hasYield(); $throwPoints = array_merge($throwPoints, $result->getThrowPoints()); $impurePoints = array_merge($impurePoints, $result->getImpurePoints()); } elseif ($expr instanceof Expr\Include_) { $result = $this->processExprNode($stmt, $expr->expr, $scope, $nodeCallback, $context->enterDeep()); $throwPoints = $result->getThrowPoints(); $throwPoints[] = \PHPStan\Analyser\ThrowPoint::createImplicit($scope, $expr); $impurePoints = $result->getImpurePoints(); $impurePoints[] = new \PHPStan\Analyser\ImpurePoint($scope, $expr, in_array($expr->type, [Expr\Include_::TYPE_INCLUDE, Expr\Include_::TYPE_INCLUDE_ONCE], \true) ? 'include' : 'require', in_array($expr->type, [Expr\Include_::TYPE_INCLUDE, Expr\Include_::TYPE_INCLUDE_ONCE], \true) ? 'include' : 'require', \true); $hasYield = $result->hasYield(); $scope = $result->getScope()->afterExtractCall(); } elseif ($expr instanceof Expr\Print_) { $result = $this->processExprNode($stmt, $expr->expr, $scope, $nodeCallback, $context->enterDeep()); $throwPoints = $result->getThrowPoints(); $impurePoints = $result->getImpurePoints(); $impurePoints[] = new \PHPStan\Analyser\ImpurePoint($scope, $expr, 'print', 'print', \true); $hasYield = $result->hasYield(); $scope = $result->getScope(); } elseif ($expr instanceof Cast\String_) { $result = $this->processExprNode($stmt, $expr->expr, $scope, $nodeCallback, $context->enterDeep()); $throwPoints = $result->getThrowPoints(); $impurePoints = $result->getImpurePoints(); $hasYield = $result->hasYield(); $exprType = $scope->getType($expr->expr); $toStringMethod = $scope->getMethodReflection($exprType, '__toString'); if ($toStringMethod !== null) { if (!$toStringMethod->hasSideEffects()->no()) { $impurePoints[] = new \PHPStan\Analyser\ImpurePoint($scope, $expr, 'methodCall', sprintf('call to method %s::%s()', $toStringMethod->getDeclaringClass()->getDisplayName(), $toStringMethod->getName()), $toStringMethod->isPure()->no()); } } $scope = $result->getScope(); } elseif ($expr instanceof Expr\BitwiseNot || $expr instanceof Cast || $expr instanceof Expr\Clone_ || $expr instanceof Expr\UnaryMinus || $expr instanceof Expr\UnaryPlus) { $result = $this->processExprNode($stmt, $expr->expr, $scope, $nodeCallback, $context->enterDeep()); $throwPoints = $result->getThrowPoints(); $impurePoints = $result->getImpurePoints(); $hasYield = $result->hasYield(); $scope = $result->getScope(); } elseif ($expr instanceof Expr\Eval_) { $result = $this->processExprNode($stmt, $expr->expr, $scope, $nodeCallback, $context->enterDeep()); $throwPoints = $result->getThrowPoints(); $throwPoints[] = \PHPStan\Analyser\ThrowPoint::createImplicit($scope, $expr); $impurePoints = $result->getImpurePoints(); $impurePoints[] = new \PHPStan\Analyser\ImpurePoint($scope, $expr, 'eval', 'eval', \true); $hasYield = $result->hasYield(); $scope = $result->getScope(); } elseif ($expr instanceof Expr\YieldFrom) { $result = $this->processExprNode($stmt, $expr->expr, $scope, $nodeCallback, $context->enterDeep()); $throwPoints = $result->getThrowPoints(); $throwPoints[] = \PHPStan\Analyser\ThrowPoint::createImplicit($scope, $expr); $impurePoints = $result->getImpurePoints(); $impurePoints[] = new \PHPStan\Analyser\ImpurePoint($scope, $expr, 'yieldFrom', 'yield from', \true); $hasYield = \true; $scope = $result->getScope(); } elseif ($expr instanceof BooleanNot) { $result = $this->processExprNode($stmt, $expr->expr, $scope, $nodeCallback, $context->enterDeep()); $scope = $result->getScope(); $hasYield = $result->hasYield(); $throwPoints = $result->getThrowPoints(); $impurePoints = $result->getImpurePoints(); } elseif ($expr instanceof Expr\ClassConstFetch) { if ($expr->class instanceof Expr) { $result = $this->processExprNode($stmt, $expr->class, $scope, $nodeCallback, $context->enterDeep()); $scope = $result->getScope(); $hasYield = $result->hasYield(); $throwPoints = $result->getThrowPoints(); $impurePoints = $result->getImpurePoints(); } else { $hasYield = \false; $throwPoints = []; $impurePoints = []; $nodeCallback($expr->class, $scope); } if ($expr->name instanceof Expr) { $result = $this->processExprNode($stmt, $expr->name, $scope, $nodeCallback, $context->enterDeep()); $scope = $result->getScope(); $hasYield = $hasYield || $result->hasYield(); $throwPoints = array_merge($throwPoints, $result->getThrowPoints()); $impurePoints = array_merge($impurePoints, $result->getImpurePoints()); } else { $nodeCallback($expr->name, $scope); } } elseif ($expr instanceof Expr\Empty_) { $nonNullabilityResult = $this->ensureNonNullability($scope, $expr->expr); $scope = $this->lookForSetAllowedUndefinedExpressions($nonNullabilityResult->getScope(), $expr->expr); $result = $this->processExprNode($stmt, $expr->expr, $scope, $nodeCallback, $context->enterDeep()); $scope = $result->getScope(); $hasYield = $result->hasYield(); $throwPoints = $result->getThrowPoints(); $impurePoints = $result->getImpurePoints(); $scope = $this->revertNonNullability($scope, $nonNullabilityResult->getSpecifiedExpressions()); $scope = $this->lookForUnsetAllowedUndefinedExpressions($scope, $expr->expr); } elseif ($expr instanceof Expr\Isset_) { $hasYield = \false; $throwPoints = []; $impurePoints = []; $nonNullabilityResults = []; foreach ($expr->vars as $var) { $nonNullabilityResult = $this->ensureNonNullability($scope, $var); $scope = $this->lookForSetAllowedUndefinedExpressions($nonNullabilityResult->getScope(), $var); $result = $this->processExprNode($stmt, $var, $scope, $nodeCallback, $context->enterDeep()); $scope = $result->getScope(); $hasYield = $hasYield || $result->hasYield(); $throwPoints = array_merge($throwPoints, $result->getThrowPoints()); $impurePoints = array_merge($impurePoints, $result->getImpurePoints()); $nonNullabilityResults[] = $nonNullabilityResult; } foreach (array_reverse($expr->vars) as $var) { $scope = $this->lookForUnsetAllowedUndefinedExpressions($scope, $var); } foreach (array_reverse($nonNullabilityResults) as $nonNullabilityResult) { $scope = $this->revertNonNullability($scope, $nonNullabilityResult->getSpecifiedExpressions()); } } elseif ($expr instanceof Instanceof_) { $result = $this->processExprNode($stmt, $expr->expr, $scope, $nodeCallback, $context->enterDeep()); $scope = $result->getScope(); $hasYield = $result->hasYield(); $throwPoints = $result->getThrowPoints(); $impurePoints = $result->getImpurePoints(); if ($expr->class instanceof Expr) { $result = $this->processExprNode($stmt, $expr->class, $scope, $nodeCallback, $context->enterDeep()); $scope = $result->getScope(); $hasYield = $hasYield || $result->hasYield(); $throwPoints = array_merge($throwPoints, $result->getThrowPoints()); $impurePoints = array_merge($impurePoints, $result->getImpurePoints()); } } elseif ($expr instanceof List_) { // only in assign and foreach, processed elsewhere return new \PHPStan\Analyser\ExpressionResult($scope, \false, [], []); } elseif ($expr instanceof New_) { $parametersAcceptor = null; $constructorReflection = null; $hasYield = \false; $throwPoints = []; $impurePoints = []; $className = null; if ($expr->class instanceof Expr || $expr->class instanceof Name) { if ($expr->class instanceof Expr) { $objectClasses = $scope->getType($expr)->getObjectClassNames(); if (count($objectClasses) === 1) { $objectExprResult = $this->processExprNode($stmt, new New_(new Name($objectClasses[0])), $scope, static function () : void { }, $context->enterDeep()); $className = $objectClasses[0]; $additionalThrowPoints = $objectExprResult->getThrowPoints(); } else { $additionalThrowPoints = [\PHPStan\Analyser\ThrowPoint::createImplicit($scope, $expr)]; } $result = $this->processExprNode($stmt, $expr->class, $scope, $nodeCallback, $context->enterDeep()); $scope = $result->getScope(); $hasYield = $result->hasYield(); $throwPoints = $result->getThrowPoints(); $impurePoints = $result->getImpurePoints(); foreach ($additionalThrowPoints as $throwPoint) { $throwPoints[] = $throwPoint; } } else { $className = $scope->resolveName($expr->class); } $classReflection = null; if ($className !== null && $this->reflectionProvider->hasClass($className)) { $classReflection = $this->reflectionProvider->getClass($className); if ($classReflection->hasConstructor()) { $constructorReflection = $classReflection->getConstructor(); $parametersAcceptor = ParametersAcceptorSelector::selectFromArgs($scope, $expr->getArgs(), $constructorReflection->getVariants(), $constructorReflection->getNamedArgumentsVariants()); $constructorThrowPoint = $this->getConstructorThrowPoint($constructorReflection, $parametersAcceptor, $classReflection, $expr, new Name\FullyQualified($className), $expr->getArgs(), $scope); if ($constructorThrowPoint !== null) { $throwPoints[] = $constructorThrowPoint; } } } else { $throwPoints[] = \PHPStan\Analyser\ThrowPoint::createImplicit($scope, $expr); } if ($constructorReflection !== null) { if (!$constructorReflection->hasSideEffects()->no()) { $certain = $constructorReflection->isPure()->no(); $impurePoints[] = new \PHPStan\Analyser\ImpurePoint($scope, $expr, 'new', sprintf('instantiation of class %s', $constructorReflection->getDeclaringClass()->getDisplayName()), $certain); } } elseif ($classReflection === null) { $impurePoints[] = new \PHPStan\Analyser\ImpurePoint($scope, $expr, 'new', 'instantiation of unknown class', \false); } if ($parametersAcceptor !== null) { $expr = \PHPStan\Analyser\ArgumentsNormalizer::reorderNewArguments($parametersAcceptor, $expr) ?? $expr; } } else { $classReflection = $this->reflectionProvider->getAnonymousClassReflection($expr->class, $scope); // populates $expr->class->name $constructorResult = null; $this->processStmtNode($expr->class, $scope, static function (Node $node, \PHPStan\Analyser\Scope $scope) use($nodeCallback, $classReflection, &$constructorResult) : void { $nodeCallback($node, $scope); if (!$node instanceof MethodReturnStatementsNode) { return; } if ($constructorResult !== null) { return; } $currentClassReflection = $node->getClassReflection(); if ($currentClassReflection->getName() !== $classReflection->getName()) { return; } if (!$currentClassReflection->hasConstructor()) { return; } if ($currentClassReflection->getConstructor()->getName() !== $node->getMethodReflection()->getName()) { return; } $constructorResult = $node; }, \PHPStan\Analyser\StatementContext::createTopLevel()); if ($constructorResult !== null) { $throwPoints = array_merge($throwPoints, $constructorResult->getStatementResult()->getThrowPoints()); $impurePoints = array_merge($impurePoints, $constructorResult->getImpurePoints()); } if ($classReflection->hasConstructor()) { $constructorReflection = $classReflection->getConstructor(); $parametersAcceptor = ParametersAcceptorSelector::selectFromArgs($scope, $expr->getArgs(), $constructorReflection->getVariants(), $constructorReflection->getNamedArgumentsVariants()); } } $result = $this->processArgs($stmt, $constructorReflection, null, $parametersAcceptor, $expr, $scope, $nodeCallback, $context); $scope = $result->getScope(); $hasYield = $hasYield || $result->hasYield(); $throwPoints = array_merge($throwPoints, $result->getThrowPoints()); $impurePoints = array_merge($impurePoints, $result->getImpurePoints()); } elseif ($expr instanceof Expr\PreInc || $expr instanceof Expr\PostInc || $expr instanceof Expr\PreDec || $expr instanceof Expr\PostDec) { $result = $this->processExprNode($stmt, $expr->var, $scope, $nodeCallback, $context->enterDeep()); $scope = $result->getScope(); $hasYield = $result->hasYield(); $throwPoints = $result->getThrowPoints(); $impurePoints = $result->getImpurePoints(); $newExpr = $expr; if ($expr instanceof Expr\PostInc) { $newExpr = new Expr\PreInc($expr->var); } elseif ($expr instanceof Expr\PostDec) { $newExpr = new Expr\PreDec($expr->var); } $scope = $this->processAssignVar($scope, $stmt, $expr->var, $newExpr, static function (Node $node, \PHPStan\Analyser\Scope $scope) use($nodeCallback) : void { if (!$node instanceof PropertyAssignNode && !$node instanceof VariableAssignNode) { return; } $nodeCallback($node, $scope); }, $context, static function (\PHPStan\Analyser\MutatingScope $scope) : \PHPStan\Analyser\ExpressionResult { return new \PHPStan\Analyser\ExpressionResult($scope, \false, [], []); }, \false)->getScope(); } elseif ($expr instanceof Ternary) { $ternaryCondResult = $this->processExprNode($stmt, $expr->cond, $scope, $nodeCallback, $context->enterDeep()); $throwPoints = $ternaryCondResult->getThrowPoints(); $impurePoints = $ternaryCondResult->getImpurePoints(); $ifTrueScope = $ternaryCondResult->getTruthyScope(); $ifFalseScope = $ternaryCondResult->getFalseyScope(); $ifTrueType = null; if ($expr->if !== null) { $ifResult = $this->processExprNode($stmt, $expr->if, $ifTrueScope, $nodeCallback, $context); $throwPoints = array_merge($throwPoints, $ifResult->getThrowPoints()); $impurePoints = array_merge($impurePoints, $ifResult->getImpurePoints()); $ifTrueScope = $ifResult->getScope(); $ifTrueType = $ifTrueScope->getType($expr->if); } $elseResult = $this->processExprNode($stmt, $expr->else, $ifFalseScope, $nodeCallback, $context); $throwPoints = array_merge($throwPoints, $elseResult->getThrowPoints()); $impurePoints = array_merge($impurePoints, $elseResult->getImpurePoints()); $ifFalseScope = $elseResult->getScope(); $condType = $scope->getType($expr->cond); if ($condType->isTrue()->yes()) { $finalScope = $ifTrueScope; } elseif ($condType->isFalse()->yes()) { $finalScope = $ifFalseScope; } else { if ($ifTrueType instanceof NeverType && $ifTrueType->isExplicit()) { $finalScope = $ifFalseScope; } else { $ifFalseType = $ifFalseScope->getType($expr->else); if ($ifFalseType instanceof NeverType && $ifFalseType->isExplicit()) { $finalScope = $ifTrueScope; } else { $finalScope = $ifTrueScope->mergeWith($ifFalseScope); } } } return new \PHPStan\Analyser\ExpressionResult($finalScope, $ternaryCondResult->hasYield(), $throwPoints, $impurePoints, static function () use($finalScope, $expr) : \PHPStan\Analyser\MutatingScope { return $finalScope->filterByTruthyValue($expr); }, static function () use($finalScope, $expr) : \PHPStan\Analyser\MutatingScope { return $finalScope->filterByFalseyValue($expr); }); } elseif ($expr instanceof Expr\Yield_) { $throwPoints = [\PHPStan\Analyser\ThrowPoint::createImplicit($scope, $expr)]; $impurePoints = [new \PHPStan\Analyser\ImpurePoint($scope, $expr, 'yield', 'yield', \true)]; if ($expr->key !== null) { $keyResult = $this->processExprNode($stmt, $expr->key, $scope, $nodeCallback, $context->enterDeep()); $scope = $keyResult->getScope(); $throwPoints = $keyResult->getThrowPoints(); $impurePoints = array_merge($impurePoints, $keyResult->getImpurePoints()); } if ($expr->value !== null) { $valueResult = $this->processExprNode($stmt, $expr->value, $scope, $nodeCallback, $context->enterDeep()); $scope = $valueResult->getScope(); $throwPoints = array_merge($throwPoints, $valueResult->getThrowPoints()); $impurePoints = array_merge($impurePoints, $valueResult->getImpurePoints()); } $hasYield = \true; } elseif ($expr instanceof Expr\Match_) { $deepContext = $context->enterDeep(); $condType = $scope->getType($expr->cond); $condResult = $this->processExprNode($stmt, $expr->cond, $scope, $nodeCallback, $deepContext); $scope = $condResult->getScope(); $hasYield = $condResult->hasYield(); $throwPoints = $condResult->getThrowPoints(); $impurePoints = $condResult->getImpurePoints(); $matchScope = $scope->enterMatch($expr); $armNodes = []; $hasDefaultCond = \false; $hasAlwaysTrueCond = \false; $arms = $expr->arms; if ($condType->isEnum()->yes()) { // enum match analysis would work even without this if branch // but would be much slower // this avoids using ObjectType::$subtractedType which is slow for huge enums // because of repeated union type normalization $enumCases = $condType->getEnumCases(); if (count($enumCases) > 0) { $indexedEnumCases = []; foreach ($enumCases as $enumCase) { $indexedEnumCases[strtolower($enumCase->getClassName())][$enumCase->getEnumCaseName()] = $enumCase; } $unusedIndexedEnumCases = $indexedEnumCases; foreach ($arms as $i => $arm) { if ($arm->conds === null) { continue; } $condNodes = []; $conditionCases = []; foreach ($arm->conds as $cond) { if (!$cond instanceof Expr\ClassConstFetch) { continue 2; } if (!$cond->class instanceof Name) { continue 2; } if (!$cond->name instanceof Node\Identifier) { continue 2; } $fetchedClassName = $scope->resolveName($cond->class); $loweredFetchedClassName = strtolower($fetchedClassName); if (!array_key_exists($loweredFetchedClassName, $indexedEnumCases)) { continue 2; } if (!array_key_exists($loweredFetchedClassName, $unusedIndexedEnumCases)) { throw new ShouldNotHappenException(); } $caseName = $cond->name->toString(); if (!array_key_exists($caseName, $indexedEnumCases[$loweredFetchedClassName])) { continue 2; } $enumCase = $indexedEnumCases[$loweredFetchedClassName][$caseName]; $conditionCases[] = $enumCase; $armConditionScope = $matchScope; if (!array_key_exists($caseName, $unusedIndexedEnumCases[$loweredFetchedClassName])) { // force "always false" $armConditionScope = $armConditionScope->removeTypeFromExpression($expr->cond, $enumCase); } else { $unusedCasesCount = 0; foreach ($unusedIndexedEnumCases as $cases) { $unusedCasesCount += count($cases); } if ($unusedCasesCount === 1) { $hasAlwaysTrueCond = \true; // force "always true" $armConditionScope = $armConditionScope->addTypeToExpression($expr->cond, $enumCase); } } $this->processExprNode($stmt, $cond, $armConditionScope, $nodeCallback, $deepContext); $condNodes[] = new MatchExpressionArmCondition($cond, $armConditionScope, $cond->getStartLine()); unset($unusedIndexedEnumCases[$loweredFetchedClassName][$caseName]); } $conditionCasesCount = count($conditionCases); if ($conditionCasesCount === 0) { throw new ShouldNotHappenException(); } elseif ($conditionCasesCount === 1) { $conditionCaseType = $conditionCases[0]; } else { $conditionCaseType = new UnionType($conditionCases); } $matchArmBodyScope = $matchScope->addTypeToExpression($expr->cond, $conditionCaseType); $matchArmBody = new MatchExpressionArmBody($matchArmBodyScope, $arm->body); $armNodes[$i] = new MatchExpressionArm($matchArmBody, $condNodes, $arm->getStartLine()); $armResult = $this->processExprNode($stmt, $arm->body, $matchArmBodyScope, $nodeCallback, \PHPStan\Analyser\ExpressionContext::createTopLevel()); $armScope = $armResult->getScope(); $scope = $scope->mergeWith($armScope); $hasYield = $hasYield || $armResult->hasYield(); $throwPoints = array_merge($throwPoints, $armResult->getThrowPoints()); $impurePoints = array_merge($impurePoints, $armResult->getImpurePoints()); unset($arms[$i]); } $remainingCases = []; foreach ($unusedIndexedEnumCases as $cases) { foreach ($cases as $case) { $remainingCases[] = $case; } } $remainingCasesCount = count($remainingCases); if ($remainingCasesCount === 0) { $remainingType = new NeverType(); } elseif ($remainingCasesCount === 1) { $remainingType = $remainingCases[0]; } else { $remainingType = new UnionType($remainingCases); } $matchScope = $matchScope->addTypeToExpression($expr->cond, $remainingType); } } foreach ($arms as $i => $arm) { if ($arm->conds === null) { $hasDefaultCond = \true; $matchArmBody = new MatchExpressionArmBody($matchScope, $arm->body); $armNodes[$i] = new MatchExpressionArm($matchArmBody, [], $arm->getStartLine()); $armResult = $this->processExprNode($stmt, $arm->body, $matchScope, $nodeCallback, \PHPStan\Analyser\ExpressionContext::createTopLevel()); $matchScope = $armResult->getScope(); $hasYield = $hasYield || $armResult->hasYield(); $throwPoints = array_merge($throwPoints, $armResult->getThrowPoints()); $impurePoints = array_merge($impurePoints, $armResult->getImpurePoints()); $scope = $scope->mergeWith($matchScope); continue; } if (count($arm->conds) === 0) { throw new ShouldNotHappenException(); } $filteringExprs = []; $armCondScope = $matchScope; $condNodes = []; foreach ($arm->conds as $armCond) { $condNodes[] = new MatchExpressionArmCondition($armCond, $armCondScope, $armCond->getStartLine()); $armCondResult = $this->processExprNode($stmt, $armCond, $armCondScope, $nodeCallback, $deepContext); $hasYield = $hasYield || $armCondResult->hasYield(); $throwPoints = array_merge($throwPoints, $armCondResult->getThrowPoints()); $impurePoints = array_merge($impurePoints, $armCondResult->getImpurePoints()); $armCondExpr = new BinaryOp\Identical($expr->cond, $armCond); $armCondResultScope = $armCondResult->getScope(); $armCondType = $this->treatPhpDocTypesAsCertain ? $armCondResultScope->getType($armCondExpr) : $armCondResultScope->getNativeType($armCondExpr); if ($armCondType->isTrue()->yes()) { $hasAlwaysTrueCond = \true; } $armCondScope = $armCondResult->getScope()->filterByFalseyValue($armCondExpr); $filteringExprs[] = $armCond; } if (count($filteringExprs) === 1) { $filteringExpr = new BinaryOp\Identical($expr->cond, $filteringExprs[0]); } else { $items = []; foreach ($filteringExprs as $filteringExpr) { $items[] = new ArrayItem($filteringExpr); } $filteringExpr = new FuncCall(new Name\FullyQualified('in_array'), [new Arg($expr->cond), new Arg(new Array_($items)), new Arg(new ConstFetch(new Name\FullyQualified('true')))]); } $bodyScope = $this->processExprNode($stmt, $filteringExpr, $matchScope, static function () : void { }, $deepContext)->getTruthyScope(); $matchArmBody = new MatchExpressionArmBody($bodyScope, $arm->body); $armNodes[$i] = new MatchExpressionArm($matchArmBody, $condNodes, $arm->getStartLine()); $armResult = $this->processExprNode($stmt, $arm->body, $bodyScope, $nodeCallback, \PHPStan\Analyser\ExpressionContext::createTopLevel()); $armScope = $armResult->getScope(); $scope = $scope->mergeWith($armScope); $hasYield = $hasYield || $armResult->hasYield(); $throwPoints = array_merge($throwPoints, $armResult->getThrowPoints()); $impurePoints = array_merge($impurePoints, $armResult->getImpurePoints()); $matchScope = $matchScope->filterByFalseyValue($filteringExpr); } $remainingType = $matchScope->getType($expr->cond); if (!$hasDefaultCond && !$hasAlwaysTrueCond && !$remainingType instanceof NeverType) { $throwPoints[] = \PHPStan\Analyser\ThrowPoint::createExplicit($scope, new ObjectType(UnhandledMatchError::class), $expr, \false); } ksort($armNodes, SORT_NUMERIC); $nodeCallback(new MatchExpressionNode($expr->cond, array_values($armNodes), $expr, $matchScope), $scope); } elseif ($expr instanceof AlwaysRememberedExpr) { $result = $this->processExprNode($stmt, $expr->getExpr(), $scope, $nodeCallback, $context); $hasYield = $result->hasYield(); $throwPoints = $result->getThrowPoints(); $impurePoints = $result->getImpurePoints(); $scope = $result->getScope(); } elseif ($expr instanceof Expr\Throw_) { $hasYield = \false; $result = $this->processExprNode($stmt, $expr->expr, $scope, $nodeCallback, \PHPStan\Analyser\ExpressionContext::createDeep()); $throwPoints = $result->getThrowPoints(); $impurePoints = $result->getImpurePoints(); $throwPoints[] = \PHPStan\Analyser\ThrowPoint::createExplicit($scope, $scope->getType($expr->expr), $expr, \false); } elseif ($expr instanceof FunctionCallableNode) { $throwPoints = []; $impurePoints = []; $hasYield = \false; if ($expr->getName() instanceof Expr) { $result = $this->processExprNode($stmt, $expr->getName(), $scope, $nodeCallback, \PHPStan\Analyser\ExpressionContext::createDeep()); $scope = $result->getScope(); $hasYield = $result->hasYield(); $throwPoints = $result->getThrowPoints(); $impurePoints = $result->getImpurePoints(); } } elseif ($expr instanceof MethodCallableNode) { $result = $this->processExprNode($stmt, $expr->getVar(), $scope, $nodeCallback, \PHPStan\Analyser\ExpressionContext::createDeep()); $scope = $result->getScope(); $hasYield = $result->hasYield(); $throwPoints = $result->getThrowPoints(); $impurePoints = $result->getImpurePoints(); if ($expr->getName() instanceof Expr) { $nameResult = $this->processExprNode($stmt, $expr->getVar(), $scope, $nodeCallback, \PHPStan\Analyser\ExpressionContext::createDeep()); $scope = $nameResult->getScope(); $hasYield = $hasYield || $nameResult->hasYield(); $throwPoints = array_merge($throwPoints, $nameResult->getThrowPoints()); $impurePoints = array_merge($impurePoints, $nameResult->getImpurePoints()); } } elseif ($expr instanceof StaticMethodCallableNode) { $throwPoints = []; $impurePoints = []; $hasYield = \false; if ($expr->getClass() instanceof Expr) { $classResult = $this->processExprNode($stmt, $expr->getClass(), $scope, $nodeCallback, \PHPStan\Analyser\ExpressionContext::createDeep()); $scope = $classResult->getScope(); $hasYield = $classResult->hasYield(); $throwPoints = $classResult->getThrowPoints(); $impurePoints = $classResult->getImpurePoints(); } if ($expr->getName() instanceof Expr) { $nameResult = $this->processExprNode($stmt, $expr->getName(), $scope, $nodeCallback, \PHPStan\Analyser\ExpressionContext::createDeep()); $scope = $nameResult->getScope(); $hasYield = $hasYield || $nameResult->hasYield(); $throwPoints = array_merge($throwPoints, $nameResult->getThrowPoints()); $impurePoints = array_merge($impurePoints, $nameResult->getImpurePoints()); } } elseif ($expr instanceof InstantiationCallableNode) { $throwPoints = []; $impurePoints = []; $hasYield = \false; if ($expr->getClass() instanceof Expr) { $classResult = $this->processExprNode($stmt, $expr->getClass(), $scope, $nodeCallback, \PHPStan\Analyser\ExpressionContext::createDeep()); $scope = $classResult->getScope(); $hasYield = $classResult->hasYield(); $throwPoints = $classResult->getThrowPoints(); $impurePoints = $classResult->getImpurePoints(); } } elseif ($expr instanceof Node\Scalar) { $hasYield = \false; $throwPoints = []; $impurePoints = []; } elseif ($expr instanceof ConstFetch) { $hasYield = \false; $throwPoints = []; $impurePoints = []; $nodeCallback($expr->name, $scope); } else { $hasYield = \false; $throwPoints = []; $impurePoints = []; } return new \PHPStan\Analyser\ExpressionResult($scope, $hasYield, $throwPoints, $impurePoints, static function () use($scope, $expr) : \PHPStan\Analyser\MutatingScope { return $scope->filterByTruthyValue($expr); }, static function () use($scope, $expr) : \PHPStan\Analyser\MutatingScope { return $scope->filterByFalseyValue($expr); }); } private function getArrayFunctionAppendingType(FunctionReflection $functionReflection, \PHPStan\Analyser\Scope $scope, FuncCall $expr) : Type { $arrayArg = $expr->getArgs()[0]->value; $arrayType = $scope->getType($arrayArg); $callArgs = array_slice($expr->getArgs(), 1); /** * @param Arg[] $callArgs * @param callable(?Type, Type, bool): void $setOffsetValueType */ $setOffsetValueTypes = static function (\PHPStan\Analyser\Scope $scope, array $callArgs, callable $setOffsetValueType, ?bool &$nonConstantArrayWasUnpacked = null) : void { foreach ($callArgs as $callArg) { $callArgType = $scope->getType($callArg->value); if ($callArg->unpack) { $constantArrays = $callArgType->getConstantArrays(); if (count($constantArrays) === 1) { $iterableValueTypes = $constantArrays[0]->getValueTypes(); } else { $iterableValueTypes = [$callArgType->getIterableValueType()]; $nonConstantArrayWasUnpacked = \true; } $isOptional = !$callArgType->isIterableAtLeastOnce()->yes(); foreach ($iterableValueTypes as $iterableValueType) { if ($iterableValueType instanceof UnionType) { foreach ($iterableValueType->getTypes() as $innerType) { $setOffsetValueType(null, $innerType, $isOptional); } } else { $setOffsetValueType(null, $iterableValueType, $isOptional); } } continue; } $setOffsetValueType(null, $callArgType, \false); } }; $constantArrays = $arrayType->getConstantArrays(); if (count($constantArrays) > 0) { $newArrayTypes = []; $prepend = $functionReflection->getName() === 'array_unshift'; foreach ($constantArrays as $constantArray) { $arrayTypeBuilder = $prepend ? ConstantArrayTypeBuilder::createEmpty() : ConstantArrayTypeBuilder::createFromConstantArray($constantArray); $setOffsetValueTypes($scope, $callArgs, static function (?Type $offsetType, Type $valueType, bool $optional) use(&$arrayTypeBuilder) : void { $arrayTypeBuilder->setOffsetValueType($offsetType, $valueType, $optional); }, $nonConstantArrayWasUnpacked); if ($prepend) { $keyTypes = $constantArray->getKeyTypes(); $valueTypes = $constantArray->getValueTypes(); foreach ($keyTypes as $k => $keyType) { $arrayTypeBuilder->setOffsetValueType(count($keyType->getConstantStrings()) === 1 ? $keyType->getConstantStrings()[0] : null, $valueTypes[$k], $constantArray->isOptionalKey($k)); } } $constantArray = $arrayTypeBuilder->getArray(); if ($constantArray->isConstantArray()->yes() && $nonConstantArrayWasUnpacked) { $array = new ArrayType($constantArray->generalize(GeneralizePrecision::lessSpecific())->getIterableKeyType(), $constantArray->getIterableValueType()); $isList = $constantArray->isList()->yes(); $constantArray = $constantArray->isIterableAtLeastOnce()->yes() ? TypeCombinator::intersect($array, new NonEmptyArrayType()) : $array; $constantArray = $isList ? AccessoryArrayListType::intersectWith($constantArray) : $constantArray; } $newArrayTypes[] = $constantArray; } return TypeCombinator::union(...$newArrayTypes); } $setOffsetValueTypes($scope, $callArgs, static function (?Type $offsetType, Type $valueType, bool $optional) use(&$arrayType) : void { $isIterableAtLeastOnce = $arrayType->isIterableAtLeastOnce()->yes() || !$optional; $arrayType = $arrayType->setOffsetValueType($offsetType, $valueType); if ($isIterableAtLeastOnce) { return; } $arrayType = TypeCombinator::union($arrayType, new ConstantArrayType([], [])); }); return $arrayType; } private function getArraySortPreserveListFunctionType(Type $type) : Type { $isIterableAtLeastOnce = $type->isIterableAtLeastOnce(); if ($isIterableAtLeastOnce->no()) { return $type; } return TypeTraverser::map($type, static function (Type $type, callable $traverse) use($isIterableAtLeastOnce) : Type { if ($type instanceof UnionType || $type instanceof IntersectionType) { return $traverse($type); } if (!$type instanceof ArrayType) { return $type; } $newArrayType = AccessoryArrayListType::intersectWith(new ArrayType(new IntegerType(), $type->getIterableValueType())); if ($isIterableAtLeastOnce->yes()) { $newArrayType = TypeCombinator::intersect($newArrayType, new NonEmptyArrayType()); } return $newArrayType; }); } private function getArraySortDoNotPreserveListFunctionType(Type $type) : Type { $isIterableAtLeastOnce = $type->isIterableAtLeastOnce(); if ($isIterableAtLeastOnce->no()) { return $type; } return TypeTraverser::map($type, static function (Type $type, callable $traverse) use($isIterableAtLeastOnce) : Type { if ($type instanceof UnionType) { return $traverse($type); } $constantArrays = $type->getConstantArrays(); if (count($constantArrays) > 0) { $types = []; foreach ($constantArrays as $constantArray) { $types[] = new ConstantArrayType($constantArray->getKeyTypes(), $constantArray->getValueTypes(), $constantArray->getNextAutoIndexes(), $constantArray->getOptionalKeys(), $constantArray->isList()->and(TrinaryLogic::createMaybe())); } return TypeCombinator::union(...$types); } $newArrayType = new ArrayType($type->getIterableKeyType(), $type->getIterableValueType()); if ($isIterableAtLeastOnce->yes()) { $newArrayType = TypeCombinator::intersect($newArrayType, new NonEmptyArrayType()); } return $newArrayType; }); } private function getFunctionThrowPoint(FunctionReflection $functionReflection, ?ParametersAcceptor $parametersAcceptor, FuncCall $funcCall, \PHPStan\Analyser\MutatingScope $scope) : ?\PHPStan\Analyser\ThrowPoint { $normalizedFuncCall = $funcCall; if ($parametersAcceptor !== null) { $normalizedFuncCall = \PHPStan\Analyser\ArgumentsNormalizer::reorderFuncArguments($parametersAcceptor, $funcCall); } if ($normalizedFuncCall !== null) { foreach ($this->dynamicThrowTypeExtensionProvider->getDynamicFunctionThrowTypeExtensions() as $extension) { if (!$extension->isFunctionSupported($functionReflection)) { continue; } $throwType = $extension->getThrowTypeFromFunctionCall($functionReflection, $normalizedFuncCall, $scope); if ($throwType === null) { return null; } return \PHPStan\Analyser\ThrowPoint::createExplicit($scope, $throwType, $funcCall, \false); } } $throwType = $functionReflection->getThrowType(); if ($throwType === null && $parametersAcceptor !== null) { $returnType = $parametersAcceptor->getReturnType(); if ($returnType instanceof NeverType && $returnType->isExplicit()) { $throwType = new ObjectType(Throwable::class); } } if ($throwType !== null) { if (!$throwType->isVoid()->yes()) { return \PHPStan\Analyser\ThrowPoint::createExplicit($scope, $throwType, $funcCall, \true); } } elseif ($this->implicitThrows) { $requiredParameters = null; if ($parametersAcceptor !== null) { $requiredParameters = 0; foreach ($parametersAcceptor->getParameters() as $parameter) { if ($parameter->isOptional()) { continue; } $requiredParameters++; } } if (!$functionReflection->isBuiltin() || $requiredParameters === null || $requiredParameters > 0 || count($funcCall->getArgs()) > 0) { $functionReturnedType = $scope->getType($funcCall); if (!(new ObjectType(Throwable::class))->isSuperTypeOf($functionReturnedType)->yes()) { return \PHPStan\Analyser\ThrowPoint::createImplicit($scope, $funcCall); } } } return null; } private function getMethodThrowPoint(MethodReflection $methodReflection, ParametersAcceptor $parametersAcceptor, MethodCall $methodCall, \PHPStan\Analyser\MutatingScope $scope) : ?\PHPStan\Analyser\ThrowPoint { $normalizedMethodCall = \PHPStan\Analyser\ArgumentsNormalizer::reorderMethodArguments($parametersAcceptor, $methodCall); if ($normalizedMethodCall !== null) { foreach ($this->dynamicThrowTypeExtensionProvider->getDynamicMethodThrowTypeExtensions() as $extension) { if (!$extension->isMethodSupported($methodReflection)) { continue; } $throwType = $extension->getThrowTypeFromMethodCall($methodReflection, $normalizedMethodCall, $scope); if ($throwType === null) { return null; } return \PHPStan\Analyser\ThrowPoint::createExplicit($scope, $throwType, $methodCall, \false); } } $throwType = $methodReflection->getThrowType(); if ($throwType === null) { $returnType = $parametersAcceptor->getReturnType(); if ($returnType instanceof NeverType && $returnType->isExplicit()) { $throwType = new ObjectType(Throwable::class); } } if ($throwType !== null) { if (!$throwType->isVoid()->yes()) { return \PHPStan\Analyser\ThrowPoint::createExplicit($scope, $throwType, $methodCall, \true); } } elseif ($this->implicitThrows) { $methodReturnedType = $scope->getType($methodCall); if (!(new ObjectType(Throwable::class))->isSuperTypeOf($methodReturnedType)->yes()) { return \PHPStan\Analyser\ThrowPoint::createImplicit($scope, $methodCall); } } return null; } /** * @param Node\Arg[] $args */ private function getConstructorThrowPoint(MethodReflection $constructorReflection, ParametersAcceptor $parametersAcceptor, ClassReflection $classReflection, New_ $new, Name $className, array $args, \PHPStan\Analyser\MutatingScope $scope) : ?\PHPStan\Analyser\ThrowPoint { $methodCall = new StaticCall($className, $constructorReflection->getName(), $args); $normalizedMethodCall = \PHPStan\Analyser\ArgumentsNormalizer::reorderStaticCallArguments($parametersAcceptor, $methodCall); if ($normalizedMethodCall !== null) { foreach ($this->dynamicThrowTypeExtensionProvider->getDynamicStaticMethodThrowTypeExtensions() as $extension) { if (!$extension->isStaticMethodSupported($constructorReflection)) { continue; } $throwType = $extension->getThrowTypeFromStaticMethodCall($constructorReflection, $normalizedMethodCall, $scope); if ($throwType === null) { return null; } return \PHPStan\Analyser\ThrowPoint::createExplicit($scope, $throwType, $new, \false); } } if ($constructorReflection->getThrowType() !== null) { $throwType = $constructorReflection->getThrowType(); if (!$throwType->isVoid()->yes()) { return \PHPStan\Analyser\ThrowPoint::createExplicit($scope, $throwType, $new, \true); } } elseif ($this->implicitThrows) { if ($classReflection->getName() !== Throwable::class && !$classReflection->isSubclassOf(Throwable::class)) { return \PHPStan\Analyser\ThrowPoint::createImplicit($scope, $methodCall); } } return null; } private function getStaticMethodThrowPoint(MethodReflection $methodReflection, ParametersAcceptor $parametersAcceptor, StaticCall $methodCall, \PHPStan\Analyser\MutatingScope $scope) : ?\PHPStan\Analyser\ThrowPoint { $normalizedMethodCall = \PHPStan\Analyser\ArgumentsNormalizer::reorderStaticCallArguments($parametersAcceptor, $methodCall); if ($normalizedMethodCall !== null) { foreach ($this->dynamicThrowTypeExtensionProvider->getDynamicStaticMethodThrowTypeExtensions() as $extension) { if (!$extension->isStaticMethodSupported($methodReflection)) { continue; } $throwType = $extension->getThrowTypeFromStaticMethodCall($methodReflection, $normalizedMethodCall, $scope); if ($throwType === null) { return null; } return \PHPStan\Analyser\ThrowPoint::createExplicit($scope, $throwType, $methodCall, \false); } } if ($methodReflection->getThrowType() !== null) { $throwType = $methodReflection->getThrowType(); if (!$throwType->isVoid()->yes()) { return \PHPStan\Analyser\ThrowPoint::createExplicit($scope, $throwType, $methodCall, \true); } } elseif ($this->implicitThrows) { $methodReturnedType = $scope->getType($methodCall); if (!(new ObjectType(Throwable::class))->isSuperTypeOf($methodReturnedType)->yes()) { return \PHPStan\Analyser\ThrowPoint::createImplicit($scope, $methodCall); } } return null; } /** * @return string[] */ private function getAssignedVariables(Expr $expr) : array { if ($expr instanceof Expr\Variable) { if (is_string($expr->name)) { return [$expr->name]; } return []; } if ($expr instanceof Expr\List_ || $expr instanceof Expr\Array_) { $names = []; foreach ($expr->items as $item) { if ($item === null) { continue; } $names = array_merge($names, $this->getAssignedVariables($item->value)); } return $names; } if ($expr instanceof ArrayDimFetch) { return $this->getAssignedVariables($expr->var); } return []; } /** * @param callable(Node $node, Scope $scope): void $nodeCallback */ private function callNodeCallbackWithExpression(callable $nodeCallback, Expr $expr, \PHPStan\Analyser\MutatingScope $scope, \PHPStan\Analyser\ExpressionContext $context) : void { if ($context->isDeep()) { $scope = $scope->exitFirstLevelStatements(); } $nodeCallback($expr, $scope); } /** * @param callable(Node $node, Scope $scope): void $nodeCallback */ private function processClosureNode(Node\Stmt $stmt, Expr\Closure $expr, \PHPStan\Analyser\MutatingScope $scope, callable $nodeCallback, \PHPStan\Analyser\ExpressionContext $context, ?Type $passedToType) : \PHPStan\Analyser\ProcessClosureResult { foreach ($expr->params as $param) { $this->processParamNode($stmt, $param, $scope, $nodeCallback); } $byRefUses = []; $closureCallArgs = $expr->getAttribute(ClosureArgVisitor::ATTRIBUTE_NAME); $callableParameters = $this->createCallableParameters($scope, $expr, $closureCallArgs, $passedToType); $useScope = $scope; foreach ($expr->uses as $use) { if ($use->byRef) { $byRefUses[] = $use; $useScope = $useScope->enterExpressionAssign($use->var); $inAssignRightSideVariableName = $context->getInAssignRightSideVariableName(); $inAssignRightSideType = $context->getInAssignRightSideType(); $inAssignRightSideNativeType = $context->getInAssignRightSideNativeType(); if ($inAssignRightSideVariableName === $use->var->name && $inAssignRightSideType !== null && $inAssignRightSideNativeType !== null) { if ($inAssignRightSideType instanceof ClosureType) { $variableType = $inAssignRightSideType; } else { $alreadyHasVariableType = $scope->hasVariableType($inAssignRightSideVariableName); if ($alreadyHasVariableType->no()) { $variableType = TypeCombinator::union(new NullType(), $inAssignRightSideType); } else { $variableType = TypeCombinator::union($scope->getVariableType($inAssignRightSideVariableName), $inAssignRightSideType); } } if ($inAssignRightSideNativeType instanceof ClosureType) { $variableNativeType = $inAssignRightSideNativeType; } else { $alreadyHasVariableType = $scope->hasVariableType($inAssignRightSideVariableName); if ($alreadyHasVariableType->no()) { $variableNativeType = TypeCombinator::union(new NullType(), $inAssignRightSideNativeType); } else { $variableNativeType = TypeCombinator::union($scope->getVariableType($inAssignRightSideVariableName), $inAssignRightSideNativeType); } } $scope = $scope->assignVariable($inAssignRightSideVariableName, $variableType, $variableNativeType); } } $this->processExprNode($stmt, $use->var, $useScope, $nodeCallback, $context); if (!$use->byRef) { continue; } $useScope = $useScope->exitExpressionAssign($use->var); } if ($expr->returnType !== null) { $nodeCallback($expr->returnType, $scope); } $closureScope = $scope->enterAnonymousFunction($expr, $callableParameters); $closureScope = $closureScope->processClosureScope($scope, null, $byRefUses); $closureType = $closureScope->getAnonymousFunctionReflection(); if (!$closureType instanceof ClosureType) { throw new ShouldNotHappenException(); } $nodeCallback(new InClosureNode($closureType, $expr), $closureScope); $executionEnds = []; $gatheredReturnStatements = []; $gatheredYieldStatements = []; $closureImpurePoints = []; $invalidateExpressions = []; $closureStmtsCallback = static function (Node $node, \PHPStan\Analyser\Scope $scope) use($nodeCallback, &$executionEnds, &$gatheredReturnStatements, &$gatheredYieldStatements, &$closureScope, &$closureImpurePoints, &$invalidateExpressions) : void { $nodeCallback($node, $scope); if ($scope->getAnonymousFunctionReflection() !== $closureScope->getAnonymousFunctionReflection()) { return; } if ($node instanceof PropertyAssignNode) { $closureImpurePoints[] = new \PHPStan\Analyser\ImpurePoint($scope, $node, 'propertyAssign', 'property assignment', \true); return; } if ($node instanceof ExecutionEndNode) { $executionEnds[] = $node; return; } if ($node instanceof InvalidateExprNode) { $invalidateExpressions[] = $node; return; } if ($node instanceof Expr\Yield_ || $node instanceof Expr\YieldFrom) { $gatheredYieldStatements[] = $node; } if (!$node instanceof Return_) { return; } $gatheredReturnStatements[] = new ReturnStatement($scope, $node); }; if (count($byRefUses) === 0) { $statementResult = $this->processStmtNodes($expr, $expr->stmts, $closureScope, $closureStmtsCallback, \PHPStan\Analyser\StatementContext::createTopLevel()); $nodeCallback(new ClosureReturnStatementsNode($expr, $gatheredReturnStatements, $gatheredYieldStatements, $statementResult, $executionEnds, array_merge($statementResult->getImpurePoints(), $closureImpurePoints)), $closureScope); return new \PHPStan\Analyser\ProcessClosureResult($scope, $statementResult->getThrowPoints(), $statementResult->getImpurePoints(), $invalidateExpressions); } $count = 0; $closureResultScope = null; do { $prevScope = $closureScope; $intermediaryClosureScopeResult = $this->processStmtNodes($expr, $expr->stmts, $closureScope, static function () : void { }, \PHPStan\Analyser\StatementContext::createTopLevel()); $intermediaryClosureScope = $intermediaryClosureScopeResult->getScope(); foreach ($intermediaryClosureScopeResult->getExitPoints() as $exitPoint) { $intermediaryClosureScope = $intermediaryClosureScope->mergeWith($exitPoint->getScope()); } if ($expr->getAttribute(ImmediatelyInvokedClosureVisitor::ATTRIBUTE_NAME) === \true) { $closureResultScope = $intermediaryClosureScope; break; } $closureScope = $scope->enterAnonymousFunction($expr, $callableParameters); $closureScope = $closureScope->processClosureScope($intermediaryClosureScope, $prevScope, $byRefUses); if ($closureScope->equals($prevScope)) { break; } if ($count >= self::GENERALIZE_AFTER_ITERATION) { $closureScope = $prevScope->generalizeWith($closureScope); } $count++; } while ($count < self::LOOP_SCOPE_ITERATIONS); if ($closureResultScope === null) { $closureResultScope = $closureScope; } $statementResult = $this->processStmtNodes($expr, $expr->stmts, $closureScope, $closureStmtsCallback, \PHPStan\Analyser\StatementContext::createTopLevel()); $nodeCallback(new ClosureReturnStatementsNode($expr, $gatheredReturnStatements, $gatheredYieldStatements, $statementResult, $executionEnds, array_merge($statementResult->getImpurePoints(), $closureImpurePoints)), $closureScope); return new \PHPStan\Analyser\ProcessClosureResult($scope->processClosureScope($closureResultScope, null, $byRefUses), $statementResult->getThrowPoints(), $statementResult->getImpurePoints(), $invalidateExpressions); } /** * @param InvalidateExprNode[] $invalidatedExpressions * @param string[] $uses */ private function processImmediatelyCalledCallable(\PHPStan\Analyser\MutatingScope $scope, array $invalidatedExpressions, array $uses) : \PHPStan\Analyser\MutatingScope { if ($scope->isInClass()) { $uses[] = 'this'; } $finder = new NodeFinder(); foreach ($invalidatedExpressions as $invalidateExpression) { $found = \false; foreach ($uses as $use) { $result = $finder->findFirst([$invalidateExpression->getExpr()], static function ($node) use($use) { return $node instanceof Variable && $node->name === $use; }); if ($result === null) { continue; } $found = \true; break; } if (!$found) { continue; } $scope = $scope->invalidateExpression($invalidateExpression->getExpr(), \true); } return $scope; } /** * @param callable(Node $node, Scope $scope): void $nodeCallback */ private function processArrowFunctionNode(Node\Stmt $stmt, Expr\ArrowFunction $expr, \PHPStan\Analyser\MutatingScope $scope, callable $nodeCallback, ?Type $passedToType) : \PHPStan\Analyser\ExpressionResult { foreach ($expr->params as $param) { $this->processParamNode($stmt, $param, $scope, $nodeCallback); } if ($expr->returnType !== null) { $nodeCallback($expr->returnType, $scope); } $arrowFunctionCallArgs = $expr->getAttribute(ArrowFunctionArgVisitor::ATTRIBUTE_NAME); $arrowFunctionScope = $scope->enterArrowFunction($expr, $this->createCallableParameters($scope, $expr, $arrowFunctionCallArgs, $passedToType)); $arrowFunctionType = $arrowFunctionScope->getAnonymousFunctionReflection(); if (!$arrowFunctionType instanceof ClosureType) { throw new ShouldNotHappenException(); } $nodeCallback(new InArrowFunctionNode($arrowFunctionType, $expr), $arrowFunctionScope); $exprResult = $this->processExprNode($stmt, $expr->expr, $arrowFunctionScope, $nodeCallback, \PHPStan\Analyser\ExpressionContext::createTopLevel()); return new \PHPStan\Analyser\ExpressionResult($scope, \false, $exprResult->getThrowPoints(), $exprResult->getImpurePoints()); } /** * @param Node\Arg[] $args * @return ParameterReflection[]|null */ public function createCallableParameters(\PHPStan\Analyser\Scope $scope, Expr $closureExpr, ?array $args, ?Type $passedToType) : ?array { $callableParameters = null; if ($args !== null) { $closureType = $scope->getType($closureExpr); if ($closureType->isCallable()->no()) { return null; } $acceptors = $closureType->getCallableParametersAcceptors($scope); if (count($acceptors) === 1) { $callableParameters = $acceptors[0]->getParameters(); foreach ($callableParameters as $index => $callableParameter) { if (!isset($args[$index])) { continue; } $type = $scope->getType($args[$index]->value); $callableParameters[$index] = new NativeParameterReflection($callableParameter->getName(), $callableParameter->isOptional(), $type, $callableParameter->passedByReference(), $callableParameter->isVariadic(), $callableParameter->getDefaultValue()); } } } elseif ($passedToType !== null && !$passedToType->isCallable()->no()) { if ($passedToType instanceof UnionType) { $passedToType = TypeCombinator::union(...array_filter($passedToType->getTypes(), static function (Type $type) { return $type->isCallable()->yes(); })); if ($passedToType->isCallable()->no()) { return null; } } $acceptors = $passedToType->getCallableParametersAcceptors($scope); if (count($acceptors) > 0) { foreach ($acceptors as $acceptor) { if ($callableParameters === null) { $callableParameters = array_map(static function (ParameterReflection $callableParameter) { return new NativeParameterReflection($callableParameter->getName(), $callableParameter->isOptional(), $callableParameter->getType(), $callableParameter->passedByReference(), $callableParameter->isVariadic(), $callableParameter->getDefaultValue()); }, $acceptor->getParameters()); continue; } $newParameters = []; foreach ($acceptor->getParameters() as $i => $callableParameter) { if (!array_key_exists($i, $callableParameters)) { $newParameters[] = $callableParameter; continue; } $newParameters[] = $callableParameters[$i]->union(new NativeParameterReflection($callableParameter->getName(), $callableParameter->isOptional(), $callableParameter->getType(), $callableParameter->passedByReference(), $callableParameter->isVariadic(), $callableParameter->getDefaultValue())); } $callableParameters = $newParameters; } } } return $callableParameters; } /** * @param callable(Node $node, Scope $scope): void $nodeCallback */ private function processParamNode(Node\Stmt $stmt, Node\Param $param, \PHPStan\Analyser\MutatingScope $scope, callable $nodeCallback) : void { $this->processAttributeGroups($stmt, $param->attrGroups, $scope, $nodeCallback); $nodeCallback($param, $scope); if ($param->type !== null) { $nodeCallback($param->type, $scope); } if ($param->default === null) { return; } $this->processExprNode($stmt, $param->default, $scope, $nodeCallback, \PHPStan\Analyser\ExpressionContext::createDeep()); } /** * @param AttributeGroup[] $attrGroups * @param callable(Node $node, Scope $scope): void $nodeCallback */ private function processAttributeGroups(Node\Stmt $stmt, array $attrGroups, \PHPStan\Analyser\MutatingScope $scope, callable $nodeCallback) : void { foreach ($attrGroups as $attrGroup) { foreach ($attrGroup->attrs as $attr) { foreach ($attr->args as $arg) { $this->processExprNode($stmt, $arg->value, $scope, $nodeCallback, \PHPStan\Analyser\ExpressionContext::createDeep()); $nodeCallback($arg, $scope); } $nodeCallback($attr, $scope); } $nodeCallback($attrGroup, $scope); } } /** * @param MethodReflection|FunctionReflection|null $calleeReflection * @param callable(Node $node, Scope $scope): void $nodeCallback */ private function processArgs(Node\Stmt $stmt, $calleeReflection, ?ExtendedMethodReflection $nakedMethodReflection, ?ParametersAcceptor $parametersAcceptor, CallLike $callLike, \PHPStan\Analyser\MutatingScope $scope, callable $nodeCallback, \PHPStan\Analyser\ExpressionContext $context, ?\PHPStan\Analyser\MutatingScope $closureBindScope = null) : \PHPStan\Analyser\ExpressionResult { $args = $callLike->getArgs(); if ($parametersAcceptor !== null) { $parameters = $parametersAcceptor->getParameters(); } $hasYield = \false; $throwPoints = []; $impurePoints = []; foreach ($args as $i => $arg) { $assignByReference = \false; $parameter = null; $parameterType = null; $parameterNativeType = null; if (isset($parameters) && $parametersAcceptor !== null) { if (isset($parameters[$i])) { $assignByReference = $parameters[$i]->passedByReference()->createsNewVariable(); $parameterType = $parameters[$i]->getType(); if ($parameters[$i] instanceof ParameterReflectionWithPhpDocs) { $parameterNativeType = $parameters[$i]->getNativeType(); } $parameter = $parameters[$i]; } elseif (count($parameters) > 0 && $parametersAcceptor->isVariadic()) { $lastParameter = $parameters[count($parameters) - 1]; $assignByReference = $lastParameter->passedByReference()->createsNewVariable(); $parameterType = $lastParameter->getType(); if ($lastParameter instanceof ParameterReflectionWithPhpDocs) { $parameterNativeType = $lastParameter->getNativeType(); } $parameter = $lastParameter; } } $lookForUnset = \false; if ($assignByReference) { $isBuiltin = \false; if ($calleeReflection instanceof FunctionReflection && $calleeReflection->isBuiltin()) { $isBuiltin = \true; } elseif ($calleeReflection instanceof ExtendedMethodReflection && $calleeReflection->getDeclaringClass()->isBuiltin()) { $isBuiltin = \true; } if ($isBuiltin || ($parameterNativeType === null || !$parameterNativeType->isNull()->no())) { $scope = $this->lookForSetAllowedUndefinedExpressions($scope, $arg->value); $lookForUnset = \true; } } if ($calleeReflection !== null) { $scope = $scope->pushInFunctionCall($calleeReflection, $parameter); } $originalArg = $arg->getAttribute(\PHPStan\Analyser\ArgumentsNormalizer::ORIGINAL_ARG_ATTRIBUTE) ?? $arg; $nodeCallback($originalArg, $scope); $originalScope = $scope; $scopeToPass = $scope; if ($i === 0 && $closureBindScope !== null) { $scopeToPass = $closureBindScope; } if ($parameter instanceof ParameterReflectionWithPhpDocs) { $parameterCallImmediately = $parameter->isImmediatelyInvokedCallable(); if ($parameterCallImmediately->maybe()) { $callCallbackImmediately = $calleeReflection instanceof FunctionReflection; } else { $callCallbackImmediately = $parameterCallImmediately->yes(); } } else { $callCallbackImmediately = $calleeReflection instanceof FunctionReflection; } if ($arg->value instanceof Expr\Closure) { $restoreThisScope = null; if ($closureBindScope === null && $parameter instanceof ParameterReflectionWithPhpDocs && $parameter->getClosureThisType() !== null && !$arg->value->static) { $restoreThisScope = $scopeToPass; $scopeToPass = $scopeToPass->assignVariable('this', $parameter->getClosureThisType(), new ObjectWithoutClassType()); } if ($parameter !== null) { $overwritingParameterType = $this->getParameterTypeFromParameterClosureTypeExtension($callLike, $calleeReflection, $parameter, $scopeToPass); if ($overwritingParameterType !== null) { $parameterType = $overwritingParameterType; } } $this->callNodeCallbackWithExpression($nodeCallback, $arg->value, $scopeToPass, $context); $closureResult = $this->processClosureNode($stmt, $arg->value, $scopeToPass, $nodeCallback, $context, $parameterType ?? null); if ($callCallbackImmediately) { $throwPoints = array_merge($throwPoints, array_map(static function (\PHPStan\Analyser\ThrowPoint $throwPoint) use($scope, $arg) { return $throwPoint->isExplicit() ? \PHPStan\Analyser\ThrowPoint::createExplicit($scope, $throwPoint->getType(), $arg->value, $throwPoint->canContainAnyThrowable()) : \PHPStan\Analyser\ThrowPoint::createImplicit($scope, $arg->value); }, $closureResult->getThrowPoints())); $impurePoints = array_merge($impurePoints, $closureResult->getImpurePoints()); } $uses = []; foreach ($arg->value->uses as $use) { if (!is_string($use->var->name)) { continue; } $uses[] = $use->var->name; } $scope = $closureResult->getScope(); $invalidateExpressions = $closureResult->getInvalidateExpressions(); if ($restoreThisScope !== null) { $nodeFinder = new NodeFinder(); $cb = static function ($expr) { return $expr instanceof Variable && $expr->name === 'this'; }; foreach ($invalidateExpressions as $j => $invalidateExprNode) { $foundThis = $nodeFinder->findFirst([$invalidateExprNode->getExpr()], $cb); if ($foundThis === null) { continue; } unset($invalidateExpressions[$j]); } $invalidateExpressions = array_values($invalidateExpressions); $scope = $scope->restoreThis($restoreThisScope); } $scope = $this->processImmediatelyCalledCallable($scope, $invalidateExpressions, $uses); } elseif ($arg->value instanceof Expr\ArrowFunction) { if ($closureBindScope === null && $parameter instanceof ParameterReflectionWithPhpDocs && $parameter->getClosureThisType() !== null && !$arg->value->static) { $scopeToPass = $scopeToPass->assignVariable('this', $parameter->getClosureThisType(), new ObjectWithoutClassType()); } if ($parameter !== null) { $overwritingParameterType = $this->getParameterTypeFromParameterClosureTypeExtension($callLike, $calleeReflection, $parameter, $scopeToPass); if ($overwritingParameterType !== null) { $parameterType = $overwritingParameterType; } } $this->callNodeCallbackWithExpression($nodeCallback, $arg->value, $scopeToPass, $context); $arrowFunctionResult = $this->processArrowFunctionNode($stmt, $arg->value, $scopeToPass, $nodeCallback, $parameterType ?? null); if ($callCallbackImmediately) { $throwPoints = array_merge($throwPoints, array_map(static function (\PHPStan\Analyser\ThrowPoint $throwPoint) use($scope, $arg) { return $throwPoint->isExplicit() ? \PHPStan\Analyser\ThrowPoint::createExplicit($scope, $throwPoint->getType(), $arg->value, $throwPoint->canContainAnyThrowable()) : \PHPStan\Analyser\ThrowPoint::createImplicit($scope, $arg->value); }, $arrowFunctionResult->getThrowPoints())); $impurePoints = array_merge($impurePoints, $arrowFunctionResult->getImpurePoints()); } } else { $exprType = $scope->getType($arg->value); $exprResult = $this->processExprNode($stmt, $arg->value, $scopeToPass, $nodeCallback, $context->enterDeep()); $throwPoints = array_merge($throwPoints, $exprResult->getThrowPoints()); $impurePoints = array_merge($impurePoints, $exprResult->getImpurePoints()); $scope = $exprResult->getScope(); $hasYield = $hasYield || $exprResult->hasYield(); if ($exprType->isCallable()->yes()) { $acceptors = $exprType->getCallableParametersAcceptors($scope); if (count($acceptors) === 1) { $scope = $this->processImmediatelyCalledCallable($scope, $acceptors[0]->getInvalidateExpressions(), $acceptors[0]->getUsedVariables()); if ($callCallbackImmediately) { $callableThrowPoints = array_map(static function (SimpleThrowPoint $throwPoint) use($scope, $arg) { return $throwPoint->isExplicit() ? \PHPStan\Analyser\ThrowPoint::createExplicit($scope, $throwPoint->getType(), $arg->value, $throwPoint->canContainAnyThrowable()) : \PHPStan\Analyser\ThrowPoint::createImplicit($scope, $arg->value); }, $acceptors[0]->getThrowPoints()); if (!$this->implicitThrows) { $callableThrowPoints = array_values(array_filter($callableThrowPoints, static function (\PHPStan\Analyser\ThrowPoint $throwPoint) { return $throwPoint->isExplicit(); })); } $throwPoints = array_merge($throwPoints, $callableThrowPoints); $impurePoints = array_merge($impurePoints, array_map(static function (SimpleImpurePoint $impurePoint) use($scope, $arg) { return new \PHPStan\Analyser\ImpurePoint($scope, $arg->value, $impurePoint->getIdentifier(), $impurePoint->getDescription(), $impurePoint->isCertain()); }, $acceptors[0]->getImpurePoints())); } } } } if ($assignByReference && $lookForUnset) { $scope = $this->lookForUnsetAllowedUndefinedExpressions($scope, $arg->value); } if ($calleeReflection !== null) { $scope = $scope->popInFunctionCall(); } if ($i !== 0 || $closureBindScope === null) { continue; } $scope = $scope->restoreOriginalScopeAfterClosureBind($originalScope); } foreach ($args as $i => $arg) { if (!isset($parameters) || $parametersAcceptor === null) { continue; } $byRefType = new MixedType(); $assignByReference = \false; $currentParameter = null; if (isset($parameters[$i])) { $currentParameter = $parameters[$i]; } elseif (count($parameters) > 0 && $parametersAcceptor->isVariadic()) { $currentParameter = $parameters[count($parameters) - 1]; } if ($currentParameter !== null) { $assignByReference = $currentParameter->passedByReference()->createsNewVariable(); if ($assignByReference) { if ($currentParameter instanceof ParameterReflectionWithPhpDocs && $currentParameter->getOutType() !== null) { $byRefType = $currentParameter->getOutType(); } elseif ($calleeReflection instanceof MethodReflection && !$calleeReflection->getDeclaringClass()->isBuiltin() && $this->paramOutType) { $byRefType = $currentParameter->getType(); } elseif ($calleeReflection instanceof FunctionReflection && !$calleeReflection->isBuiltin() && $this->paramOutType) { $byRefType = $currentParameter->getType(); } } } if ($assignByReference) { if ($currentParameter === null) { throw new ShouldNotHappenException(); } $argValue = $arg->value; if (!$argValue instanceof Variable || $argValue->name !== 'this') { $paramOutType = $this->getParameterOutExtensionsType($callLike, $calleeReflection, $currentParameter, $scope); if ($paramOutType !== null) { $byRefType = $paramOutType; } $result = $this->processAssignVar($scope, $stmt, $argValue, new TypeExpr($byRefType), static function (Node $node, \PHPStan\Analyser\Scope $scope) use($nodeCallback) : void { if (!$node instanceof PropertyAssignNode && !$node instanceof VariableAssignNode) { return; } $nodeCallback($node, $scope); }, $context, static function (\PHPStan\Analyser\MutatingScope $scope) : \PHPStan\Analyser\ExpressionResult { return new \PHPStan\Analyser\ExpressionResult($scope, \false, [], []); }, \true); $scope = $result->getScope(); } } elseif ($calleeReflection !== null && $calleeReflection->hasSideEffects()->yes()) { $argType = $scope->getType($arg->value); if (!$argType->isObject()->no()) { $nakedReturnType = null; if ($nakedMethodReflection !== null) { $nakedParametersAcceptor = ParametersAcceptorSelector::selectFromArgs($scope, $args, $nakedMethodReflection->getVariants(), $nakedMethodReflection->getNamedArgumentsVariants()); $nakedReturnType = $nakedParametersAcceptor->getReturnType(); } if ($nakedReturnType === null || !(new ThisType($nakedMethodReflection->getDeclaringClass()))->isSuperTypeOf($nakedReturnType)->yes() || $nakedMethodReflection->isPure()->no()) { $nodeCallback(new InvalidateExprNode($arg->value), $scope); $scope = $scope->invalidateExpression($arg->value, \true); } } elseif (!(new ResourceType())->isSuperTypeOf($argType)->no()) { $nodeCallback(new InvalidateExprNode($arg->value), $scope); $scope = $scope->invalidateExpression($arg->value, \true); } } } return new \PHPStan\Analyser\ExpressionResult($scope, $hasYield, $throwPoints, $impurePoints); } /** * @param MethodReflection|FunctionReflection|null $calleeReflection */ private function getParameterTypeFromParameterClosureTypeExtension(CallLike $callLike, $calleeReflection, ParameterReflection $parameter, \PHPStan\Analyser\MutatingScope $scope) : ?Type { if ($callLike instanceof FuncCall && $calleeReflection instanceof FunctionReflection) { foreach ($this->parameterClosureTypeExtensionProvider->getFunctionParameterClosureTypeExtensions() as $functionParameterClosureTypeExtension) { if ($functionParameterClosureTypeExtension->isFunctionSupported($calleeReflection, $parameter)) { return $functionParameterClosureTypeExtension->getTypeFromFunctionCall($calleeReflection, $callLike, $parameter, $scope); } } } elseif ($calleeReflection instanceof MethodReflection) { if ($callLike instanceof StaticCall) { foreach ($this->parameterClosureTypeExtensionProvider->getStaticMethodParameterClosureTypeExtensions() as $staticMethodParameterClosureTypeExtension) { if ($staticMethodParameterClosureTypeExtension->isStaticMethodSupported($calleeReflection, $parameter)) { return $staticMethodParameterClosureTypeExtension->getTypeFromStaticMethodCall($calleeReflection, $callLike, $parameter, $scope); } } } elseif ($callLike instanceof MethodCall) { foreach ($this->parameterClosureTypeExtensionProvider->getMethodParameterClosureTypeExtensions() as $methodParameterClosureTypeExtension) { if ($methodParameterClosureTypeExtension->isMethodSupported($calleeReflection, $parameter)) { return $methodParameterClosureTypeExtension->getTypeFromMethodCall($calleeReflection, $callLike, $parameter, $scope); } } } } return null; } /** * @param MethodReflection|FunctionReflection|null $calleeReflection */ private function getParameterOutExtensionsType(CallLike $callLike, $calleeReflection, ParameterReflection $currentParameter, \PHPStan\Analyser\MutatingScope $scope) : ?Type { $paramOutTypes = []; if ($callLike instanceof FuncCall && $calleeReflection instanceof FunctionReflection) { foreach ($this->parameterOutTypeExtensionProvider->getFunctionParameterOutTypeExtensions() as $functionParameterOutTypeExtension) { if (!$functionParameterOutTypeExtension->isFunctionSupported($calleeReflection, $currentParameter)) { continue; } $resolvedType = $functionParameterOutTypeExtension->getParameterOutTypeFromFunctionCall($calleeReflection, $callLike, $currentParameter, $scope); if ($resolvedType === null) { continue; } $paramOutTypes[] = $resolvedType; } } elseif ($callLike instanceof MethodCall && $calleeReflection instanceof MethodReflection) { foreach ($this->parameterOutTypeExtensionProvider->getMethodParameterOutTypeExtensions() as $methodParameterOutTypeExtension) { if (!$methodParameterOutTypeExtension->isMethodSupported($calleeReflection, $currentParameter)) { continue; } $resolvedType = $methodParameterOutTypeExtension->getParameterOutTypeFromMethodCall($calleeReflection, $callLike, $currentParameter, $scope); if ($resolvedType === null) { continue; } $paramOutTypes[] = $resolvedType; } } elseif ($callLike instanceof StaticCall && $calleeReflection instanceof MethodReflection) { foreach ($this->parameterOutTypeExtensionProvider->getStaticMethodParameterOutTypeExtensions() as $staticMethodParameterOutTypeExtension) { if (!$staticMethodParameterOutTypeExtension->isStaticMethodSupported($calleeReflection, $currentParameter)) { continue; } $resolvedType = $staticMethodParameterOutTypeExtension->getParameterOutTypeFromStaticMethodCall($calleeReflection, $callLike, $currentParameter, $scope); if ($resolvedType === null) { continue; } $paramOutTypes[] = $resolvedType; } } if (count($paramOutTypes) === 1) { return $paramOutTypes[0]; } if (count($paramOutTypes) > 1) { return TypeCombinator::union(...$paramOutTypes); } return null; } /** * @param callable(Node $node, Scope $scope): void $nodeCallback * @param Closure(MutatingScope $scope): ExpressionResult $processExprCallback */ private function processAssignVar(\PHPStan\Analyser\MutatingScope $scope, Node\Stmt $stmt, Expr $var, Expr $assignedExpr, callable $nodeCallback, \PHPStan\Analyser\ExpressionContext $context, Closure $processExprCallback, bool $enterExpressionAssign) : \PHPStan\Analyser\ExpressionResult { $nodeCallback($var, $enterExpressionAssign ? $scope->enterExpressionAssign($var) : $scope); $hasYield = \false; $throwPoints = []; $impurePoints = []; $isAssignOp = $assignedExpr instanceof Expr\AssignOp && !$enterExpressionAssign; if ($var instanceof Variable && is_string($var->name)) { $result = $processExprCallback($scope); $hasYield = $result->hasYield(); $throwPoints = $result->getThrowPoints(); $impurePoints = $result->getImpurePoints(); if (in_array($var->name, \PHPStan\Analyser\Scope::SUPERGLOBAL_VARIABLES, \true)) { $impurePoints[] = new \PHPStan\Analyser\ImpurePoint($scope, $var, 'superglobal', 'assign to superglobal variable', \true); } $assignedExpr = $this->unwrapAssign($assignedExpr); $type = $scope->getType($assignedExpr); $conditionalExpressions = []; if ($assignedExpr instanceof Ternary) { $if = $assignedExpr->if; if ($if === null) { $if = $assignedExpr->cond; } $condScope = $this->processExprNode($stmt, $assignedExpr->cond, $scope, static function () : void { }, \PHPStan\Analyser\ExpressionContext::createDeep())->getScope(); $truthySpecifiedTypes = $this->typeSpecifier->specifyTypesInCondition($condScope, $assignedExpr->cond, \PHPStan\Analyser\TypeSpecifierContext::createTruthy()); $falseySpecifiedTypes = $this->typeSpecifier->specifyTypesInCondition($condScope, $assignedExpr->cond, \PHPStan\Analyser\TypeSpecifierContext::createFalsey()); $truthyScope = $condScope->filterBySpecifiedTypes($truthySpecifiedTypes); $falsyScope = $condScope->filterBySpecifiedTypes($falseySpecifiedTypes); $truthyType = $truthyScope->getType($if); $falseyType = $falsyScope->getType($assignedExpr->else); if ($truthyType->isSuperTypeOf($falseyType)->no() && $falseyType->isSuperTypeOf($truthyType)->no()) { $conditionalExpressions = $this->processSureTypesForConditionalExpressionsAfterAssign($condScope, $var->name, $conditionalExpressions, $truthySpecifiedTypes, $truthyType); $conditionalExpressions = $this->processSureNotTypesForConditionalExpressionsAfterAssign($condScope, $var->name, $conditionalExpressions, $truthySpecifiedTypes, $truthyType); $conditionalExpressions = $this->processSureTypesForConditionalExpressionsAfterAssign($condScope, $var->name, $conditionalExpressions, $falseySpecifiedTypes, $falseyType); $conditionalExpressions = $this->processSureNotTypesForConditionalExpressionsAfterAssign($condScope, $var->name, $conditionalExpressions, $falseySpecifiedTypes, $falseyType); } } $scope = $result->getScope(); $truthySpecifiedTypes = $this->typeSpecifier->specifyTypesInCondition($scope, $assignedExpr, \PHPStan\Analyser\TypeSpecifierContext::createTruthy()); $falseySpecifiedTypes = $this->typeSpecifier->specifyTypesInCondition($scope, $assignedExpr, \PHPStan\Analyser\TypeSpecifierContext::createFalsey()); $truthyType = TypeCombinator::removeFalsey($type); $falseyType = TypeCombinator::intersect($type, StaticTypeFactory::falsey()); $conditionalExpressions = $this->processSureTypesForConditionalExpressionsAfterAssign($scope, $var->name, $conditionalExpressions, $truthySpecifiedTypes, $truthyType); $conditionalExpressions = $this->processSureNotTypesForConditionalExpressionsAfterAssign($scope, $var->name, $conditionalExpressions, $truthySpecifiedTypes, $truthyType); $conditionalExpressions = $this->processSureTypesForConditionalExpressionsAfterAssign($scope, $var->name, $conditionalExpressions, $falseySpecifiedTypes, $falseyType); $conditionalExpressions = $this->processSureNotTypesForConditionalExpressionsAfterAssign($scope, $var->name, $conditionalExpressions, $falseySpecifiedTypes, $falseyType); $nodeCallback(new VariableAssignNode($var, $assignedExpr, $isAssignOp), $result->getScope()); $scope = $scope->assignVariable($var->name, $type, $scope->getNativeType($assignedExpr)); foreach ($conditionalExpressions as $exprString => $holders) { $scope = $scope->addConditionalExpressions($exprString, $holders); } } elseif ($var instanceof ArrayDimFetch) { $dimFetchStack = []; $originalVar = $var; $assignedPropertyExpr = $assignedExpr; while ($var instanceof ArrayDimFetch) { $varForSetOffsetValue = $var->var; if ($varForSetOffsetValue instanceof PropertyFetch || $varForSetOffsetValue instanceof StaticPropertyFetch) { $varForSetOffsetValue = new OriginalPropertyTypeExpr($varForSetOffsetValue); } $assignedPropertyExpr = new SetOffsetValueTypeExpr($varForSetOffsetValue, $var->dim, $assignedPropertyExpr); $dimFetchStack[] = $var; $var = $var->var; } // 1. eval root expr if ($enterExpressionAssign) { $scope = $scope->enterExpressionAssign($var); } $result = $this->processExprNode($stmt, $var, $scope, $nodeCallback, $context->enterDeep()); $hasYield = $result->hasYield(); $throwPoints = $result->getThrowPoints(); $impurePoints = $result->getImpurePoints(); $scope = $result->getScope(); if ($enterExpressionAssign) { $scope = $scope->exitExpressionAssign($var); } // 2. eval dimensions $offsetTypes = []; $offsetNativeTypes = []; $dimFetchStack = array_reverse($dimFetchStack); $lastDimKey = array_key_last($dimFetchStack); foreach ($dimFetchStack as $key => $dimFetch) { $dimExpr = $dimFetch->dim; // Callback was already called for last dim at the beginning of the method. if ($key !== $lastDimKey) { $nodeCallback($dimFetch, $enterExpressionAssign ? $scope->enterExpressionAssign($dimFetch) : $scope); } if ($dimExpr === null) { $offsetTypes[] = null; $offsetNativeTypes[] = null; } else { $offsetTypes[] = $scope->getType($dimExpr); $offsetNativeTypes[] = $scope->getNativeType($dimExpr); if ($enterExpressionAssign) { $scope->enterExpressionAssign($dimExpr); } $result = $this->processExprNode($stmt, $dimExpr, $scope, $nodeCallback, $context->enterDeep()); $hasYield = $hasYield || $result->hasYield(); $throwPoints = array_merge($throwPoints, $result->getThrowPoints()); $scope = $result->getScope(); if ($enterExpressionAssign) { $scope = $scope->exitExpressionAssign($dimExpr); } } } $valueToWrite = $scope->getType($assignedExpr); $nativeValueToWrite = $scope->getNativeType($assignedExpr); $originalValueToWrite = $valueToWrite; $originalNativeValueToWrite = $nativeValueToWrite; // 3. eval assigned expr $result = $processExprCallback($scope); $hasYield = $hasYield || $result->hasYield(); $throwPoints = array_merge($throwPoints, $result->getThrowPoints()); $impurePoints = array_merge($impurePoints, $result->getImpurePoints()); $scope = $result->getScope(); $varType = $scope->getType($var); $varNativeType = $scope->getNativeType($var); // 4. compose types if ($varType instanceof ErrorType) { $varType = new ConstantArrayType([], []); } if ($varNativeType instanceof ErrorType) { $varNativeType = new ConstantArrayType([], []); } $offsetValueType = $varType; $offsetNativeValueType = $varNativeType; $valueToWrite = $this->produceArrayDimFetchAssignValueToWrite($offsetTypes, $offsetValueType, $valueToWrite); if (!$offsetValueType->equals($offsetNativeValueType) || !$valueToWrite->equals($nativeValueToWrite)) { $nativeValueToWrite = $this->produceArrayDimFetchAssignValueToWrite($offsetNativeTypes, $offsetNativeValueType, $nativeValueToWrite); } else { $rewritten = \false; foreach ($offsetTypes as $i => $offsetType) { $offsetNativeType = $offsetNativeTypes[$i]; if ($offsetType === null) { if ($offsetNativeType !== null) { throw new ShouldNotHappenException(); } continue; } elseif ($offsetNativeType === null) { throw new ShouldNotHappenException(); } if ($offsetType->equals($offsetNativeType)) { continue; } $nativeValueToWrite = $this->produceArrayDimFetchAssignValueToWrite($offsetNativeTypes, $offsetNativeValueType, $nativeValueToWrite); $rewritten = \true; break; } if (!$rewritten) { $nativeValueToWrite = $valueToWrite; } } if ($varType->isArray()->yes() || !(new ObjectType(ArrayAccess::class))->isSuperTypeOf($varType)->yes()) { if ($var instanceof Variable && is_string($var->name)) { $nodeCallback(new VariableAssignNode($var, $assignedPropertyExpr, $isAssignOp), $scope); $scope = $scope->assignVariable($var->name, $valueToWrite, $nativeValueToWrite); } else { if ($var instanceof PropertyFetch || $var instanceof StaticPropertyFetch) { $nodeCallback(new PropertyAssignNode($var, $assignedPropertyExpr, $isAssignOp), $scope); if ($var instanceof PropertyFetch && $var->name instanceof Node\Identifier && !$isAssignOp) { $scope = $scope->assignInitializedProperty($scope->getType($var->var), $var->name->toString()); } } $scope = $scope->assignExpression($var, $valueToWrite, $nativeValueToWrite); } if ($originalVar->dim instanceof Variable || $originalVar->dim instanceof Node\Scalar) { $currentVarType = $scope->getType($originalVar); if (!$originalValueToWrite->isSuperTypeOf($currentVarType)->yes()) { $scope = $scope->assignExpression($originalVar, $originalValueToWrite, $originalNativeValueToWrite); } } } else { if ($var instanceof Variable) { $nodeCallback(new VariableAssignNode($var, $assignedPropertyExpr, $isAssignOp), $scope); } elseif ($var instanceof PropertyFetch || $var instanceof StaticPropertyFetch) { $nodeCallback(new PropertyAssignNode($var, $assignedPropertyExpr, $isAssignOp), $scope); if ($var instanceof PropertyFetch && $var->name instanceof Node\Identifier && !$isAssignOp) { $scope = $scope->assignInitializedProperty($scope->getType($var->var), $var->name->toString()); } } } if (!$varType->isArray()->yes() && !(new ObjectType(ArrayAccess::class))->isSuperTypeOf($varType)->no()) { $throwPoints = array_merge($throwPoints, $this->processExprNode($stmt, new MethodCall($var, 'offsetSet'), $scope, static function () : void { }, $context)->getThrowPoints()); } } elseif ($var instanceof PropertyFetch) { $objectResult = $this->processExprNode($stmt, $var->var, $scope, $nodeCallback, $context); $hasYield = $objectResult->hasYield(); $throwPoints = $objectResult->getThrowPoints(); $impurePoints = $objectResult->getImpurePoints(); $scope = $objectResult->getScope(); $propertyName = null; if ($var->name instanceof Node\Identifier) { $propertyName = $var->name->name; } else { $propertyNameResult = $this->processExprNode($stmt, $var->name, $scope, $nodeCallback, $context); $hasYield = $hasYield || $propertyNameResult->hasYield(); $throwPoints = array_merge($throwPoints, $propertyNameResult->getThrowPoints()); $impurePoints = array_merge($impurePoints, $propertyNameResult->getImpurePoints()); $scope = $propertyNameResult->getScope(); } $result = $processExprCallback($scope); $hasYield = $hasYield || $result->hasYield(); $throwPoints = array_merge($throwPoints, $result->getThrowPoints()); $impurePoints = array_merge($impurePoints, $result->getImpurePoints()); $scope = $result->getScope(); $propertyHolderType = $scope->getType($var->var); if ($propertyName !== null && $propertyHolderType->hasProperty($propertyName)->yes()) { $propertyReflection = $propertyHolderType->getProperty($propertyName, $scope); $assignedExprType = $scope->getType($assignedExpr); $nodeCallback(new PropertyAssignNode($var, $assignedExpr, $isAssignOp), $scope); if ($propertyReflection->canChangeTypeAfterAssignment()) { $scope = $scope->assignExpression($var, $assignedExprType, $scope->getNativeType($assignedExpr)); } $declaringClass = $propertyReflection->getDeclaringClass(); if ($declaringClass->hasNativeProperty($propertyName)) { $nativeProperty = $declaringClass->getNativeProperty($propertyName); if (!$nativeProperty->getNativeType()->accepts($assignedExprType, \true)->yes()) { $throwPoints[] = \PHPStan\Analyser\ThrowPoint::createExplicit($scope, new ObjectType(TypeError::class), $assignedExpr, \false); } if ($enterExpressionAssign) { $scope = $scope->assignInitializedProperty($propertyHolderType, $propertyName); } } } else { // fallback $assignedExprType = $scope->getType($assignedExpr); $nodeCallback(new PropertyAssignNode($var, $assignedExpr, $isAssignOp), $scope); $scope = $scope->assignExpression($var, $assignedExprType, $scope->getNativeType($assignedExpr)); // simulate dynamic property assign by __set to get throw points if (!$propertyHolderType->hasMethod('__set')->no()) { $throwPoints = array_merge($throwPoints, $this->processExprNode($stmt, new MethodCall($var->var, '__set'), $scope, static function () : void { }, $context)->getThrowPoints()); } } } elseif ($var instanceof Expr\StaticPropertyFetch) { if ($var->class instanceof Node\Name) { $propertyHolderType = $scope->resolveTypeByName($var->class); } else { $this->processExprNode($stmt, $var->class, $scope, $nodeCallback, $context); $propertyHolderType = $scope->getType($var->class); } $propertyName = null; if ($var->name instanceof Node\Identifier) { $propertyName = $var->name->name; } else { $propertyNameResult = $this->processExprNode($stmt, $var->name, $scope, $nodeCallback, $context); $hasYield = $propertyNameResult->hasYield(); $throwPoints = $propertyNameResult->getThrowPoints(); $impurePoints = $propertyNameResult->getImpurePoints(); $scope = $propertyNameResult->getScope(); } $result = $processExprCallback($scope); $hasYield = $hasYield || $result->hasYield(); $throwPoints = array_merge($throwPoints, $result->getThrowPoints()); $impurePoints = array_merge($impurePoints, $result->getImpurePoints()); $scope = $result->getScope(); if ($propertyName !== null) { $propertyReflection = $scope->getPropertyReflection($propertyHolderType, $propertyName); $assignedExprType = $scope->getType($assignedExpr); $nodeCallback(new PropertyAssignNode($var, $assignedExpr, $isAssignOp), $scope); if ($propertyReflection !== null && $propertyReflection->canChangeTypeAfterAssignment()) { $scope = $scope->assignExpression($var, $assignedExprType, $scope->getNativeType($assignedExpr)); } } else { // fallback $assignedExprType = $scope->getType($assignedExpr); $nodeCallback(new PropertyAssignNode($var, $assignedExpr, $isAssignOp), $scope); $scope = $scope->assignExpression($var, $assignedExprType, $scope->getNativeType($assignedExpr)); } } elseif ($var instanceof List_ || $var instanceof Array_) { $result = $processExprCallback($scope); $hasYield = $result->hasYield(); $throwPoints = array_merge($throwPoints, $result->getThrowPoints()); $impurePoints = array_merge($impurePoints, $result->getImpurePoints()); $scope = $result->getScope(); foreach ($var->items as $i => $arrayItem) { if ($arrayItem === null) { continue; } $itemScope = $scope; if ($enterExpressionAssign) { $itemScope = $itemScope->enterExpressionAssign($arrayItem->value); } $itemScope = $this->lookForSetAllowedUndefinedExpressions($itemScope, $arrayItem->value); $nodeCallback($arrayItem, $itemScope); if ($arrayItem->key !== null) { $keyResult = $this->processExprNode($stmt, $arrayItem->key, $itemScope, $nodeCallback, $context->enterDeep()); $hasYield = $hasYield || $keyResult->hasYield(); $throwPoints = array_merge($throwPoints, $keyResult->getThrowPoints()); $impurePoints = array_merge($impurePoints, $keyResult->getImpurePoints()); $itemScope = $keyResult->getScope(); } $valueResult = $this->processExprNode($stmt, $arrayItem->value, $itemScope, $nodeCallback, $context->enterDeep()); $hasYield = $hasYield || $valueResult->hasYield(); $throwPoints = array_merge($throwPoints, $valueResult->getThrowPoints()); $impurePoints = array_merge($impurePoints, $valueResult->getImpurePoints()); if ($arrayItem->key === null) { $dimExpr = new Node\Scalar\LNumber($i); } else { $dimExpr = $arrayItem->key; } $result = $this->processAssignVar($scope, $stmt, $arrayItem->value, new GetOffsetValueTypeExpr($assignedExpr, $dimExpr), $nodeCallback, $context, static function (\PHPStan\Analyser\MutatingScope $scope) : \PHPStan\Analyser\ExpressionResult { return new \PHPStan\Analyser\ExpressionResult($scope, \false, [], []); }, $enterExpressionAssign); $scope = $result->getScope(); $hasYield = $hasYield || $result->hasYield(); $throwPoints = array_merge($throwPoints, $result->getThrowPoints()); $impurePoints = array_merge($impurePoints, $result->getImpurePoints()); } } elseif ($var instanceof ExistingArrayDimFetch) { $dimFetchStack = []; $assignedPropertyExpr = $assignedExpr; while ($var instanceof ExistingArrayDimFetch) { $varForSetOffsetValue = $var->getVar(); if ($varForSetOffsetValue instanceof PropertyFetch || $varForSetOffsetValue instanceof StaticPropertyFetch) { $varForSetOffsetValue = new OriginalPropertyTypeExpr($varForSetOffsetValue); } $assignedPropertyExpr = new SetExistingOffsetValueTypeExpr($varForSetOffsetValue, $var->getDim(), $assignedPropertyExpr); $dimFetchStack[] = $var; $var = $var->getVar(); } $offsetTypes = []; $offsetNativeTypes = []; foreach (array_reverse($dimFetchStack) as $dimFetch) { $dimExpr = $dimFetch->getDim(); $offsetTypes[] = $scope->getType($dimExpr); $offsetNativeTypes[] = $scope->getNativeType($dimExpr); } $valueToWrite = $scope->getType($assignedExpr); $nativeValueToWrite = $scope->getNativeType($assignedExpr); $varType = $scope->getType($var); $varNativeType = $scope->getNativeType($var); $offsetValueType = $varType; $offsetNativeValueType = $varNativeType; $offsetValueTypeStack = [$offsetValueType]; $offsetValueNativeTypeStack = [$offsetNativeValueType]; foreach (array_slice($offsetTypes, 0, -1) as $offsetType) { $offsetValueType = $offsetValueType->getOffsetValueType($offsetType); $offsetValueTypeStack[] = $offsetValueType; } foreach (array_slice($offsetNativeTypes, 0, -1) as $offsetNativeType) { $offsetNativeValueType = $offsetNativeValueType->getOffsetValueType($offsetNativeType); $offsetValueNativeTypeStack[] = $offsetNativeValueType; } foreach (array_reverse($offsetTypes) as $offsetType) { /** @var Type $offsetValueType */ $offsetValueType = array_pop($offsetValueTypeStack); $valueToWrite = $offsetValueType->setExistingOffsetValueType($offsetType, $valueToWrite); } foreach (array_reverse($offsetNativeTypes) as $offsetNativeType) { /** @var Type $offsetNativeValueType */ $offsetNativeValueType = array_pop($offsetValueNativeTypeStack); $nativeValueToWrite = $offsetNativeValueType->setExistingOffsetValueType($offsetNativeType, $nativeValueToWrite); } if ($var instanceof Variable && is_string($var->name)) { $nodeCallback(new VariableAssignNode($var, $assignedPropertyExpr, $isAssignOp), $scope); $scope = $scope->assignVariable($var->name, $valueToWrite, $nativeValueToWrite); } else { if ($var instanceof PropertyFetch || $var instanceof StaticPropertyFetch) { $nodeCallback(new PropertyAssignNode($var, $assignedPropertyExpr, $isAssignOp), $scope); } $scope = $scope->assignExpression($var, $valueToWrite, $nativeValueToWrite); } } return new \PHPStan\Analyser\ExpressionResult($scope, $hasYield, $throwPoints, $impurePoints); } /** * @param list<Type|null> $offsetTypes */ private function produceArrayDimFetchAssignValueToWrite(array $offsetTypes, Type $offsetValueType, Type $valueToWrite) : Type { $offsetValueTypeStack = [$offsetValueType]; foreach (array_slice($offsetTypes, 0, -1) as $offsetType) { if ($offsetType === null) { $offsetValueType = new ConstantArrayType([], []); } else { $offsetValueType = $offsetValueType->getOffsetValueType($offsetType); if ($offsetValueType instanceof ErrorType) { $offsetValueType = new ConstantArrayType([], []); } } $offsetValueTypeStack[] = $offsetValueType; } foreach (array_reverse($offsetTypes) as $i => $offsetType) { /** @var Type $offsetValueType */ $offsetValueType = array_pop($offsetValueTypeStack); if (!$offsetValueType instanceof MixedType) { $types = [new ArrayType(new MixedType(), new MixedType()), new ObjectType(ArrayAccess::class), new NullType()]; if ($offsetType !== null && $offsetType->isInteger()->yes()) { $types[] = new StringType(); } $offsetValueType = TypeCombinator::intersect($offsetValueType, TypeCombinator::union(...$types)); } $valueToWrite = $offsetValueType->setOffsetValueType($offsetType, $valueToWrite, $i === 0); } return $valueToWrite; } private function unwrapAssign(Expr $expr) : Expr { if ($expr instanceof Assign) { return $this->unwrapAssign($expr->expr); } return $expr; } /** * @param array<string, ConditionalExpressionHolder[]> $conditionalExpressions * @return array<string, ConditionalExpressionHolder[]> */ private function processSureTypesForConditionalExpressionsAfterAssign(\PHPStan\Analyser\Scope $scope, string $variableName, array $conditionalExpressions, \PHPStan\Analyser\SpecifiedTypes $specifiedTypes, Type $variableType) : array { foreach ($specifiedTypes->getSureTypes() as $exprString => [$expr, $exprType]) { if (!$expr instanceof Variable) { continue; } if (!is_string($expr->name)) { continue; } if ($expr->name === $variableName) { continue; } if (!isset($conditionalExpressions[$exprString])) { $conditionalExpressions[$exprString] = []; } $holder = new \PHPStan\Analyser\ConditionalExpressionHolder(['$' . $variableName => \PHPStan\Analyser\ExpressionTypeHolder::createYes(new Variable($variableName), $variableType)], \PHPStan\Analyser\ExpressionTypeHolder::createYes($expr, TypeCombinator::intersect($scope->getType($expr), $exprType))); $conditionalExpressions[$exprString][$holder->getKey()] = $holder; } return $conditionalExpressions; } /** * @param array<string, ConditionalExpressionHolder[]> $conditionalExpressions * @return array<string, ConditionalExpressionHolder[]> */ private function processSureNotTypesForConditionalExpressionsAfterAssign(\PHPStan\Analyser\Scope $scope, string $variableName, array $conditionalExpressions, \PHPStan\Analyser\SpecifiedTypes $specifiedTypes, Type $variableType) : array { foreach ($specifiedTypes->getSureNotTypes() as $exprString => [$expr, $exprType]) { if (!$expr instanceof Variable) { continue; } if (!is_string($expr->name)) { continue; } if ($expr->name === $variableName) { continue; } if (!isset($conditionalExpressions[$exprString])) { $conditionalExpressions[$exprString] = []; } $holder = new \PHPStan\Analyser\ConditionalExpressionHolder(['$' . $variableName => \PHPStan\Analyser\ExpressionTypeHolder::createYes(new Variable($variableName), $variableType)], \PHPStan\Analyser\ExpressionTypeHolder::createYes($expr, TypeCombinator::remove($scope->getType($expr), $exprType))); $conditionalExpressions[$exprString][$holder->getKey()] = $holder; } return $conditionalExpressions; } /** * @param callable(Node $node, Scope $scope): void $nodeCallback */ private function processStmtVarAnnotation(\PHPStan\Analyser\MutatingScope $scope, Node\Stmt $stmt, ?Expr $defaultExpr, callable $nodeCallback) : \PHPStan\Analyser\MutatingScope { $function = $scope->getFunction(); $variableLessTags = []; foreach ($stmt->getComments() as $comment) { if (!$comment instanceof Doc) { continue; } $resolvedPhpDoc = $this->fileTypeMapper->getResolvedPhpDoc($scope->getFile(), $scope->isInClass() ? $scope->getClassReflection()->getName() : null, $scope->isInTrait() ? $scope->getTraitReflection()->getName() : null, $function !== null ? $function->getName() : null, $comment->getText()); $assignedVariable = null; if ($stmt instanceof Node\Stmt\Expression && ($stmt->expr instanceof Assign || $stmt->expr instanceof AssignRef) && $stmt->expr->var instanceof Variable && is_string($stmt->expr->var->name)) { $assignedVariable = $stmt->expr->var->name; } foreach ($resolvedPhpDoc->getVarTags() as $name => $varTag) { if (is_int($name)) { $variableLessTags[] = $varTag; continue; } if ($name === $assignedVariable) { continue; } $certainty = $scope->hasVariableType($name); if ($certainty->no()) { continue; } if ($scope->isInClass() && $scope->getFunction() === null) { continue; } if ($scope->canAnyVariableExist()) { $certainty = TrinaryLogic::createYes(); } $variableNode = new Variable($name, $stmt->getAttributes()); $originalType = $scope->getVariableType($name); if (!$originalType->equals($varTag->getType())) { $nodeCallback(new VarTagChangedExpressionTypeNode($varTag, $variableNode), $scope); } $scope = $scope->assignVariable($name, $varTag->getType(), $scope->getNativeType($variableNode), $certainty); } } if (count($variableLessTags) === 1 && $defaultExpr !== null) { $originalType = $scope->getType($defaultExpr); $varTag = $variableLessTags[0]; if (!$originalType->equals($varTag->getType())) { $nodeCallback(new VarTagChangedExpressionTypeNode($varTag, $defaultExpr), $scope); } $scope = $scope->assignExpression($defaultExpr, $varTag->getType(), new MixedType()); } return $scope; } /** * @param array<int, string> $variableNames */ private function processVarAnnotation(\PHPStan\Analyser\MutatingScope $scope, array $variableNames, Node\Stmt $node, bool &$changed = \false) : \PHPStan\Analyser\MutatingScope { $function = $scope->getFunction(); $varTags = []; foreach ($node->getComments() as $comment) { if (!$comment instanceof Doc) { continue; } $resolvedPhpDoc = $this->fileTypeMapper->getResolvedPhpDoc($scope->getFile(), $scope->isInClass() ? $scope->getClassReflection()->getName() : null, $scope->isInTrait() ? $scope->getTraitReflection()->getName() : null, $function !== null ? $function->getName() : null, $comment->getText()); foreach ($resolvedPhpDoc->getVarTags() as $key => $varTag) { $varTags[$key] = $varTag; } } if (count($varTags) === 0) { return $scope; } foreach ($variableNames as $variableName) { if (!isset($varTags[$variableName])) { continue; } $variableType = $varTags[$variableName]->getType(); $changed = \true; $scope = $scope->assignVariable($variableName, $variableType, new MixedType()); } if (count($variableNames) === 1 && count($varTags) === 1 && isset($varTags[0])) { $variableType = $varTags[0]->getType(); $changed = \true; $scope = $scope->assignVariable($variableNames[0], $variableType, new MixedType()); } return $scope; } private function enterForeach(\PHPStan\Analyser\MutatingScope $scope, \PHPStan\Analyser\MutatingScope $originalScope, Foreach_ $stmt) : \PHPStan\Analyser\MutatingScope { if ($stmt->expr instanceof Variable && is_string($stmt->expr->name)) { $scope = $this->processVarAnnotation($scope, [$stmt->expr->name], $stmt); } $iterateeType = $originalScope->getType($stmt->expr); if ($stmt->valueVar instanceof Variable && is_string($stmt->valueVar->name) && ($stmt->keyVar === null || $stmt->keyVar instanceof Variable && is_string($stmt->keyVar->name))) { $keyVarName = null; if ($stmt->keyVar instanceof Variable && is_string($stmt->keyVar->name)) { $keyVarName = $stmt->keyVar->name; } $scope = $scope->enterForeach($originalScope, $stmt->expr, $stmt->valueVar->name, $keyVarName); $vars = [$stmt->valueVar->name]; if ($keyVarName !== null) { $vars[] = $keyVarName; } } else { $scope = $this->processAssignVar($scope, $stmt, $stmt->valueVar, new GetIterableValueTypeExpr($stmt->expr), static function () : void { }, \PHPStan\Analyser\ExpressionContext::createDeep(), static function (\PHPStan\Analyser\MutatingScope $scope) : \PHPStan\Analyser\ExpressionResult { return new \PHPStan\Analyser\ExpressionResult($scope, \false, [], []); }, \true)->getScope(); $vars = $this->getAssignedVariables($stmt->valueVar); if ($stmt->keyVar instanceof Variable && is_string($stmt->keyVar->name)) { $scope = $scope->enterForeachKey($originalScope, $stmt->expr, $stmt->keyVar->name); $vars[] = $stmt->keyVar->name; } elseif ($stmt->keyVar !== null) { $scope = $this->processAssignVar($scope, $stmt, $stmt->keyVar, new GetIterableKeyTypeExpr($stmt->expr), static function () : void { }, \PHPStan\Analyser\ExpressionContext::createDeep(), static function (\PHPStan\Analyser\MutatingScope $scope) : \PHPStan\Analyser\ExpressionResult { return new \PHPStan\Analyser\ExpressionResult($scope, \false, [], []); }, \true)->getScope(); $vars = array_merge($vars, $this->getAssignedVariables($stmt->keyVar)); } } $constantArrays = $iterateeType->getConstantArrays(); if ($stmt->getDocComment() === null && $iterateeType->isConstantArray()->yes() && count($constantArrays) === 1 && $stmt->valueVar instanceof Variable && is_string($stmt->valueVar->name) && $stmt->keyVar instanceof Variable && is_string($stmt->keyVar->name)) { $valueConditionalHolders = []; $arrayDimFetchConditionalHolders = []; foreach ($constantArrays[0]->getKeyTypes() as $i => $keyType) { $valueType = $constantArrays[0]->getValueTypes()[$i]; $holder = new \PHPStan\Analyser\ConditionalExpressionHolder(['$' . $stmt->keyVar->name => \PHPStan\Analyser\ExpressionTypeHolder::createYes(new Variable($stmt->keyVar->name), $keyType)], new \PHPStan\Analyser\ExpressionTypeHolder($stmt->valueVar, $valueType, TrinaryLogic::createYes())); $valueConditionalHolders[$holder->getKey()] = $holder; $arrayDimFetchHolder = new \PHPStan\Analyser\ConditionalExpressionHolder(['$' . $stmt->keyVar->name => \PHPStan\Analyser\ExpressionTypeHolder::createYes(new Variable($stmt->keyVar->name), $keyType)], new \PHPStan\Analyser\ExpressionTypeHolder(new ArrayDimFetch($stmt->expr, $stmt->keyVar), $valueType, TrinaryLogic::createYes())); $arrayDimFetchConditionalHolders[$arrayDimFetchHolder->getKey()] = $arrayDimFetchHolder; } $scope = $scope->addConditionalExpressions('$' . $stmt->valueVar->name, $valueConditionalHolders); if ($stmt->expr instanceof Variable && is_string($stmt->expr->name)) { $scope = $scope->addConditionalExpressions(sprintf('$%s[$%s]', $stmt->expr->name, $stmt->keyVar->name), $arrayDimFetchConditionalHolders); } } return $this->processVarAnnotation($scope, $vars, $stmt); } /** * @param callable(Node $node, Scope $scope): void $nodeCallback */ private function processTraitUse(Node\Stmt\TraitUse $node, \PHPStan\Analyser\MutatingScope $classScope, callable $nodeCallback) : void { $parentTraitNames = []; $parent = $classScope->getParentScope(); while ($parent !== null) { if ($parent->isInTrait()) { $parentTraitNames[] = $parent->getTraitReflection()->getName(); } $parent = $parent->getParentScope(); } foreach ($node->traits as $trait) { $traitName = (string) $trait; if (in_array($traitName, $parentTraitNames, \true)) { continue; } if (!$this->reflectionProvider->hasClass($traitName)) { continue; } $traitReflection = $this->reflectionProvider->getClass($traitName); $traitFileName = $traitReflection->getFileName(); if ($traitFileName === null) { continue; // trait from eval or from PHP itself } $fileName = $this->fileHelper->normalizePath($traitFileName); if (!isset($this->analysedFiles[$fileName])) { continue; } $adaptations = []; foreach ($node->adaptations as $adaptation) { if ($adaptation->trait === null) { $adaptations[] = $adaptation; continue; } if ($adaptation->trait->toLowerString() !== $trait->toLowerString()) { continue; } $adaptations[] = $adaptation; } $parserNodes = $this->parser->parseFile($fileName); $this->processNodesForTraitUse($parserNodes, $traitReflection, $classScope, $adaptations, $nodeCallback); } } /** * @param Node[]|Node|scalar|null $node * @param Node\Stmt\TraitUseAdaptation[] $adaptations * @param callable(Node $node, Scope $scope): void $nodeCallback */ private function processNodesForTraitUse($node, ClassReflection $traitReflection, \PHPStan\Analyser\MutatingScope $scope, array $adaptations, callable $nodeCallback) : void { if ($node instanceof Node) { if ($node instanceof Node\Stmt\Trait_ && $traitReflection->getName() === (string) $node->namespacedName && $traitReflection->getNativeReflection()->getStartLine() === $node->getStartLine()) { $methodModifiers = []; $methodNames = []; foreach ($adaptations as $adaptation) { if (!$adaptation instanceof Node\Stmt\TraitUseAdaptation\Alias) { continue; } $methodName = $adaptation->method->toLowerString(); if ($adaptation->newModifier !== null) { $methodModifiers[$methodName] = $adaptation->newModifier; } if ($adaptation->newName === null) { continue; } $methodNames[$methodName] = $adaptation->newName; } $stmts = $node->stmts; foreach ($stmts as $i => $stmt) { if (!$stmt instanceof Node\Stmt\ClassMethod) { continue; } $methodName = $stmt->name->toLowerString(); $methodAst = clone $stmt; $stmts[$i] = $methodAst; if (array_key_exists($methodName, $methodModifiers)) { $methodAst->flags = $methodAst->flags & ~Node\Stmt\Class_::VISIBILITY_MODIFIER_MASK | $methodModifiers[$methodName]; } if (!array_key_exists($methodName, $methodNames)) { continue; } $methodAst->setAttribute('originalTraitMethodName', $methodAst->name->toLowerString()); $methodAst->name = $methodNames[$methodName]; } if (!$scope->isInClass()) { throw new ShouldNotHappenException(); } $traitScope = $scope->enterTrait($traitReflection); $nodeCallback(new InTraitNode($node, $traitReflection, $scope->getClassReflection()), $traitScope); $this->processStmtNodes($node, $stmts, $traitScope, $nodeCallback, \PHPStan\Analyser\StatementContext::createTopLevel()); return; } if ($node instanceof Node\Stmt\ClassLike) { return; } if ($node instanceof Node\FunctionLike) { return; } foreach ($node->getSubNodeNames() as $subNodeName) { $subNode = $node->{$subNodeName}; $this->processNodesForTraitUse($subNode, $traitReflection, $scope, $adaptations, $nodeCallback); } } elseif (is_array($node)) { foreach ($node as $subNode) { $this->processNodesForTraitUse($subNode, $traitReflection, $scope, $adaptations, $nodeCallback); } } } private function processCalledMethod(MethodReflection $methodReflection) : ?\PHPStan\Analyser\MutatingScope { $declaringClass = $methodReflection->getDeclaringClass(); if ($declaringClass->isAnonymous()) { return null; } if ($declaringClass->getFileName() === null) { return null; } $stackName = sprintf('%s::%s', $declaringClass->getName(), $methodReflection->getName()); if (array_key_exists($stackName, $this->calledMethodResults)) { return $this->calledMethodResults[$stackName]; } if (array_key_exists($stackName, $this->calledMethodStack)) { return null; } if (count($this->calledMethodStack) > 0) { return null; } $this->calledMethodStack[$stackName] = \true; $fileName = $this->fileHelper->normalizePath($declaringClass->getFileName()); if (!isset($this->analysedFiles[$fileName])) { return null; } $parserNodes = $this->parser->parseFile($fileName); $returnStatement = null; $this->processNodesForCalledMethod($parserNodes, $fileName, $methodReflection, static function (Node $node, \PHPStan\Analyser\Scope $scope) use($methodReflection, &$returnStatement) : void { if (!$node instanceof MethodReturnStatementsNode) { return; } if ($node->getClassReflection()->getName() !== $methodReflection->getDeclaringClass()->getName()) { return; } if ($returnStatement !== null) { return; } $returnStatement = $node; }); $calledMethodEndScope = null; if ($returnStatement !== null) { foreach ($returnStatement->getExecutionEnds() as $executionEnd) { $statementResult = $executionEnd->getStatementResult(); $endNode = $executionEnd->getNode(); if ($endNode instanceof Node\Stmt\Throw_) { continue; } if ($endNode instanceof Node\Stmt\Expression) { $exprType = $statementResult->getScope()->getType($endNode->expr); if ($exprType instanceof NeverType && $exprType->isExplicit()) { continue; } } if ($calledMethodEndScope === null) { $calledMethodEndScope = $statementResult->getScope(); continue; } $calledMethodEndScope = $calledMethodEndScope->mergeWith($statementResult->getScope()); } foreach ($returnStatement->getReturnStatements() as $statement) { if ($calledMethodEndScope === null) { $calledMethodEndScope = $statement->getScope(); continue; } $calledMethodEndScope = $calledMethodEndScope->mergeWith($statement->getScope()); } } unset($this->calledMethodStack[$stackName]); $this->calledMethodResults[$stackName] = $calledMethodEndScope; return $calledMethodEndScope; } /** * @param Node[]|Node|scalar|null $node * @param callable(Node $node, Scope $scope): void $nodeCallback */ private function processNodesForCalledMethod($node, string $fileName, MethodReflection $methodReflection, callable $nodeCallback) : void { if ($node instanceof Node) { $declaringClass = $methodReflection->getDeclaringClass(); if ($node instanceof Node\Stmt\Class_ && $node->namespacedName !== null && $declaringClass->getName() === (string) $node->namespacedName && $declaringClass->getNativeReflection()->getStartLine() === $node->getStartLine()) { $stmts = $node->stmts; foreach ($stmts as $stmt) { if (!$stmt instanceof Node\Stmt\ClassMethod) { continue; } if ($stmt->name->toString() !== $methodReflection->getName()) { continue; } if ($stmt->getEndLine() - $stmt->getStartLine() > 50) { continue; } $scope = $this->scopeFactory->create(\PHPStan\Analyser\ScopeContext::create($fileName))->enterClass($declaringClass); $this->processStmtNode($stmt, $scope, $nodeCallback, \PHPStan\Analyser\StatementContext::createTopLevel()); } return; } if ($node instanceof Node\Stmt\ClassLike) { return; } if ($node instanceof Node\FunctionLike) { return; } foreach ($node->getSubNodeNames() as $subNodeName) { $subNode = $node->{$subNodeName}; $this->processNodesForCalledMethod($subNode, $fileName, $methodReflection, $nodeCallback); } } elseif (is_array($node)) { foreach ($node as $subNode) { $this->processNodesForCalledMethod($subNode, $fileName, $methodReflection, $nodeCallback); } } } /** * @return array{TemplateTypeMap, array<string, Type>, array<string, bool>, array<string, Type>, ?Type, ?Type, ?string, bool, bool, bool, bool|null, bool, bool, string|null, Assertions, ?Type, array<string, Type>, array<(string|int), VarTag>, bool} * @param Node\FunctionLike|Node\Stmt\Property $node */ public function getPhpDocs(\PHPStan\Analyser\Scope $scope, $node) : array { $templateTypeMap = TemplateTypeMap::createEmpty(); $phpDocParameterTypes = []; $phpDocImmediatelyInvokedCallableParameters = []; $phpDocClosureThisTypeParameters = []; $phpDocReturnType = null; $phpDocThrowType = null; $deprecatedDescription = null; $isDeprecated = \false; $isInternal = \false; $isFinal = \false; $isPure = null; $isAllowedPrivateMutation = \false; $acceptsNamedArguments = \true; $isReadOnly = $scope->isInClass() && $scope->getClassReflection()->isImmutable(); $asserts = Assertions::createEmpty(); $selfOutType = null; $docComment = $node->getDocComment() !== null ? $node->getDocComment()->getText() : null; $file = $scope->getFile(); $class = $scope->isInClass() ? $scope->getClassReflection()->getName() : null; $trait = $scope->isInTrait() ? $scope->getTraitReflection()->getName() : null; $resolvedPhpDoc = null; $functionName = null; $phpDocParameterOutTypes = []; if ($node instanceof Node\Stmt\ClassMethod) { if (!$scope->isInClass()) { throw new ShouldNotHappenException(); } $functionName = $node->name->name; $positionalParameterNames = array_map(static function (Node\Param $param) : string { if (!$param->var instanceof Variable || !is_string($param->var->name)) { throw new ShouldNotHappenException(); } return $param->var->name; }, $node->getParams()); $resolvedPhpDoc = $this->phpDocInheritanceResolver->resolvePhpDocForMethod($docComment, $file, $scope->getClassReflection(), $trait, $node->name->name, $positionalParameterNames); if ($node->name->toLowerString() === '__construct') { foreach ($node->params as $param) { if ($param->flags === 0) { continue; } if ($param->getDocComment() === null) { continue; } if (!$param->var instanceof Variable || !is_string($param->var->name)) { throw new ShouldNotHappenException(); } $paramPhpDoc = $this->fileTypeMapper->getResolvedPhpDoc($file, $class, $trait, '__construct', $param->getDocComment()->getText()); $varTags = $paramPhpDoc->getVarTags(); if (isset($varTags[0]) && count($varTags) === 1) { $phpDocType = $varTags[0]->getType(); } elseif (isset($varTags[$param->var->name])) { $phpDocType = $varTags[$param->var->name]->getType(); } else { continue; } $phpDocParameterTypes[$param->var->name] = $phpDocType; } } } elseif ($node instanceof Node\Stmt\Function_) { $functionName = trim($scope->getNamespace() . '\\' . $node->name->name, '\\'); } if ($docComment !== null && $resolvedPhpDoc === null) { $resolvedPhpDoc = $this->fileTypeMapper->getResolvedPhpDoc($file, $class, $trait, $functionName, $docComment); } $varTags = []; if ($resolvedPhpDoc !== null) { $templateTypeMap = $resolvedPhpDoc->getTemplateTypeMap(); $phpDocImmediatelyInvokedCallableParameters = $resolvedPhpDoc->getParamsImmediatelyInvokedCallable(); foreach ($resolvedPhpDoc->getParamTags() as $paramName => $paramTag) { if (array_key_exists($paramName, $phpDocParameterTypes)) { continue; } $paramType = $paramTag->getType(); if ($scope->isInClass()) { $paramType = $this->transformStaticType($scope->getClassReflection(), $paramType); } $phpDocParameterTypes[$paramName] = $paramType; } foreach ($resolvedPhpDoc->getParamClosureThisTags() as $paramName => $paramClosureThisTag) { if (array_key_exists($paramName, $phpDocClosureThisTypeParameters)) { continue; } $paramClosureThisType = $paramClosureThisTag->getType(); if ($scope->isInClass()) { $paramClosureThisType = $this->transformStaticType($scope->getClassReflection(), $paramClosureThisType); } $phpDocClosureThisTypeParameters[$paramName] = $paramClosureThisType; } foreach ($resolvedPhpDoc->getParamOutTags() as $paramName => $paramOutTag) { $phpDocParameterOutTypes[$paramName] = $paramOutTag->getType(); } if ($node instanceof Node\FunctionLike) { $nativeReturnType = $scope->getFunctionType($node->getReturnType(), \false, \false); $phpDocReturnType = $this->getPhpDocReturnType($resolvedPhpDoc, $nativeReturnType); if ($phpDocReturnType !== null && $scope->isInClass()) { $phpDocReturnType = $this->transformStaticType($scope->getClassReflection(), $phpDocReturnType); } } $phpDocThrowType = $resolvedPhpDoc->getThrowsTag() !== null ? $resolvedPhpDoc->getThrowsTag()->getType() : null; $deprecatedDescription = $resolvedPhpDoc->getDeprecatedTag() !== null ? $resolvedPhpDoc->getDeprecatedTag()->getMessage() : null; $isDeprecated = $resolvedPhpDoc->isDeprecated(); $isInternal = $resolvedPhpDoc->isInternal(); $isFinal = $resolvedPhpDoc->isFinal(); $isPure = $resolvedPhpDoc->isPure(); $isAllowedPrivateMutation = $resolvedPhpDoc->isAllowedPrivateMutation(); $acceptsNamedArguments = $resolvedPhpDoc->acceptsNamedArguments(); if ($acceptsNamedArguments && $scope->isInClass()) { $acceptsNamedArguments = $scope->getClassReflection()->acceptsNamedArguments(); } $isReadOnly = $isReadOnly || $resolvedPhpDoc->isReadOnly(); $asserts = Assertions::createFromResolvedPhpDocBlock($resolvedPhpDoc); $selfOutType = $resolvedPhpDoc->getSelfOutTag() !== null ? $resolvedPhpDoc->getSelfOutTag()->getType() : null; $varTags = $resolvedPhpDoc->getVarTags(); } return [$templateTypeMap, $phpDocParameterTypes, $phpDocImmediatelyInvokedCallableParameters, $phpDocClosureThisTypeParameters, $phpDocReturnType, $phpDocThrowType, $deprecatedDescription, $isDeprecated, $isInternal, $isFinal, $isPure, $acceptsNamedArguments, $isReadOnly, $docComment, $asserts, $selfOutType, $phpDocParameterOutTypes, $varTags, $isAllowedPrivateMutation]; } private function transformStaticType(ClassReflection $declaringClass, Type $type) : Type { return TypeTraverser::map($type, static function (Type $type, callable $traverse) use($declaringClass) : Type { if ($type instanceof StaticType) { $changedType = $type->changeBaseClass($declaringClass); if ($declaringClass->isFinal() && !$type instanceof ThisType) { $changedType = $changedType->getStaticObjectType(); } return $traverse($changedType); } return $traverse($type); }); } private function getPhpDocReturnType(ResolvedPhpDocBlock $resolvedPhpDoc, Type $nativeReturnType) : ?Type { $returnTag = $resolvedPhpDoc->getReturnTag(); if ($returnTag === null) { return null; } $phpDocReturnType = $returnTag->getType(); if ($returnTag->isExplicit()) { return $phpDocReturnType; } if ($nativeReturnType->isSuperTypeOf(TemplateTypeHelper::resolveToBounds($phpDocReturnType))->yes()) { return $phpDocReturnType; } return null; } /** * @template T of Node * @param array<T> $nodes * @return T|null */ private function getFirstUnreachableNode(array $nodes, bool $earlyBinding) : ?Node { foreach ($nodes as $node) { if ($node instanceof Node\Stmt\Nop) { continue; } if ($earlyBinding && ($node instanceof Node\Stmt\Function_ || $node instanceof Node\Stmt\ClassLike || $node instanceof Node\Stmt\HaltCompiler)) { continue; } return $node; } return null; } } <?php declare (strict_types=1); namespace PHPStan\Analyser; use PhpParser\Node\Stmt; final class EndStatementResult { /** * @var Stmt */ private $statement; /** * @var StatementResult */ private $result; public function __construct(Stmt $statement, \PHPStan\Analyser\StatementResult $result) { $this->statement = $statement; $this->result = $result; } public function getStatement() : Stmt { return $this->statement; } public function getResult() : \PHPStan\Analyser\StatementResult { return $this->result; } } <?php declare (strict_types=1); namespace PHPStan\Analyser; use PhpParser\Node\Expr; use PHPStan\Type\TypeCombinator; final class NullsafeOperatorHelper { public static function getNullsafeShortcircuitedExprRespectingScope(\PHPStan\Analyser\Scope $scope, Expr $expr) : Expr { if (!TypeCombinator::containsNull($scope->getType($expr))) { // We're in most likely in context of a null-safe operator ($scope->moreSpecificType is defined for $expr) // Modifying the expression would not bring any value or worse ruin the context information return $expr; } return self::getNullsafeShortcircuitedExpr($expr); } /** * @internal Use NullsafeOperatorHelper::getNullsafeShortcircuitedExprRespectingScope */ public static function getNullsafeShortcircuitedExpr(Expr $expr) : Expr { if ($expr instanceof Expr\NullsafeMethodCall) { return new Expr\MethodCall(self::getNullsafeShortcircuitedExpr($expr->var), $expr->name, $expr->args); } if ($expr instanceof Expr\MethodCall) { $var = self::getNullsafeShortcircuitedExpr($expr->var); if ($expr->var === $var) { return $expr; } return new Expr\MethodCall($var, $expr->name, $expr->getArgs()); } if ($expr instanceof Expr\StaticCall && $expr->class instanceof Expr) { $class = self::getNullsafeShortcircuitedExpr($expr->class); if ($expr->class === $class) { return $expr; } return new Expr\StaticCall($class, $expr->name, $expr->getArgs()); } if ($expr instanceof Expr\ArrayDimFetch) { $var = self::getNullsafeShortcircuitedExpr($expr->var); if ($expr->var === $var) { return $expr; } return new Expr\ArrayDimFetch($var, $expr->dim); } if ($expr instanceof Expr\NullsafePropertyFetch) { return new Expr\PropertyFetch(self::getNullsafeShortcircuitedExpr($expr->var), $expr->name); } if ($expr instanceof Expr\PropertyFetch) { $var = self::getNullsafeShortcircuitedExpr($expr->var); if ($expr->var === $var) { return $expr; } return new Expr\PropertyFetch($var, $expr->name); } if ($expr instanceof Expr\StaticPropertyFetch && $expr->class instanceof Expr) { $class = self::getNullsafeShortcircuitedExpr($expr->class); if ($expr->class === $class) { return $expr; } return new Expr\StaticPropertyFetch($class, $expr->name); } return $expr; } } <?php declare (strict_types=1); namespace PHPStan\Analyser; use PhpParser\Node; use PHPStan\AnalysedCodeException; use PHPStan\BetterReflection\NodeCompiler\Exception\UnableToCompileNode; use PHPStan\BetterReflection\Reflection\Exception\CircularReference; use PHPStan\BetterReflection\Reflector\Exception\IdentifierNotFound; use PHPStan\Collectors\CollectedData; use PHPStan\Collectors\Registry as CollectorRegistry; use PHPStan\Dependency\DependencyResolver; use PHPStan\Node\FileNode; use PHPStan\Node\InTraitNode; use PHPStan\Parser\Parser; use PHPStan\Parser\ParserErrorsException; use PHPStan\Rules\Registry as RuleRegistry; use function array_keys; use function array_unique; use function array_values; use function count; use function error_reporting; use function get_class; use function is_dir; use function is_file; use function restore_error_handler; use function set_error_handler; use function sprintf; use const E_DEPRECATED; use const E_ERROR; use const E_NOTICE; use const E_PARSE; use const E_STRICT; use const E_USER_ERROR; use const E_USER_NOTICE; use const E_USER_WARNING; use const E_WARNING; final class FileAnalyser { /** * @var ScopeFactory */ private $scopeFactory; /** * @var NodeScopeResolver */ private $nodeScopeResolver; /** * @var Parser */ private $parser; /** * @var DependencyResolver */ private $dependencyResolver; /** * @var RuleErrorTransformer */ private $ruleErrorTransformer; /** * @var LocalIgnoresProcessor */ private $localIgnoresProcessor; /** @var list<Error> */ private $allPhpErrors = []; /** @var list<Error> */ private $filteredPhpErrors = []; public function __construct(\PHPStan\Analyser\ScopeFactory $scopeFactory, \PHPStan\Analyser\NodeScopeResolver $nodeScopeResolver, Parser $parser, DependencyResolver $dependencyResolver, \PHPStan\Analyser\RuleErrorTransformer $ruleErrorTransformer, \PHPStan\Analyser\LocalIgnoresProcessor $localIgnoresProcessor) { $this->scopeFactory = $scopeFactory; $this->nodeScopeResolver = $nodeScopeResolver; $this->parser = $parser; $this->dependencyResolver = $dependencyResolver; $this->ruleErrorTransformer = $ruleErrorTransformer; $this->localIgnoresProcessor = $localIgnoresProcessor; } /** * @param array<string, true> $analysedFiles * @param callable(Node $node, Scope $scope): void|null $outerNodeCallback */ public function analyseFile(string $file, array $analysedFiles, RuleRegistry $ruleRegistry, CollectorRegistry $collectorRegistry, ?callable $outerNodeCallback) : \PHPStan\Analyser\FileAnalyserResult { /** @var list<Error> $fileErrors */ $fileErrors = []; /** @var list<Error> $locallyIgnoredErrors */ $locallyIgnoredErrors = []; /** @var list<CollectedData> $fileCollectedData */ $fileCollectedData = []; $fileDependencies = []; $exportedNodes = []; $linesToIgnore = []; $unmatchedLineIgnores = []; if (is_file($file)) { try { $this->collectErrors($analysedFiles); $parserNodes = $this->parser->parseFile($file); $linesToIgnore = $unmatchedLineIgnores = [$file => $this->getLinesToIgnoreFromTokens($parserNodes)]; $temporaryFileErrors = []; $nodeCallback = function (Node $node, \PHPStan\Analyser\Scope $scope) use(&$fileErrors, &$fileCollectedData, &$fileDependencies, &$exportedNodes, $file, $ruleRegistry, $collectorRegistry, $outerNodeCallback, $analysedFiles, &$linesToIgnore, &$unmatchedLineIgnores, &$temporaryFileErrors) : void { if ($node instanceof Node\Stmt\Trait_) { foreach (array_keys($linesToIgnore[$file] ?? []) as $lineToIgnore) { if ($lineToIgnore < $node->getStartLine() || $lineToIgnore > $node->getEndLine()) { continue; } unset($unmatchedLineIgnores[$file][$lineToIgnore]); } } if ($node instanceof InTraitNode) { $traitNode = $node->getOriginalNode(); $linesToIgnore[$scope->getFileDescription()] = $this->getLinesToIgnoreFromTokens([$traitNode]); } if ($outerNodeCallback !== null) { $outerNodeCallback($node, $scope); } $uniquedAnalysedCodeExceptionMessages = []; $nodeType = get_class($node); foreach ($ruleRegistry->getRules($nodeType) as $rule) { try { $ruleErrors = $rule->processNode($node, $scope); } catch (AnalysedCodeException $e) { if (isset($uniquedAnalysedCodeExceptionMessages[$e->getMessage()])) { continue; } $uniquedAnalysedCodeExceptionMessages[$e->getMessage()] = \true; $fileErrors[] = (new \PHPStan\Analyser\Error($e->getMessage(), $file, $node->getStartLine(), $e, null, null, $e->getTip()))->withIdentifier('phpstan.internal')->withMetadata([\PHPStan\Analyser\InternalError::STACK_TRACE_METADATA_KEY => \PHPStan\Analyser\InternalError::prepareTrace($e), \PHPStan\Analyser\InternalError::STACK_TRACE_AS_STRING_METADATA_KEY => $e->getTraceAsString()]); continue; } catch (IdentifierNotFound $e) { $fileErrors[] = (new \PHPStan\Analyser\Error(sprintf('Reflection error: %s not found.', $e->getIdentifier()->getName()), $file, $node->getStartLine(), $e, null, null, 'Learn more at https://phpstan.org/user-guide/discovering-symbols'))->withIdentifier('phpstan.reflection')->withMetadata([\PHPStan\Analyser\InternalError::STACK_TRACE_METADATA_KEY => \PHPStan\Analyser\InternalError::prepareTrace($e), \PHPStan\Analyser\InternalError::STACK_TRACE_AS_STRING_METADATA_KEY => $e->getTraceAsString()]); continue; } catch (UnableToCompileNode|CircularReference $e) { $fileErrors[] = (new \PHPStan\Analyser\Error(sprintf('Reflection error: %s', $e->getMessage()), $file, $node->getStartLine(), $e))->withIdentifier('phpstan.reflection')->withMetadata([\PHPStan\Analyser\InternalError::STACK_TRACE_METADATA_KEY => \PHPStan\Analyser\InternalError::prepareTrace($e), \PHPStan\Analyser\InternalError::STACK_TRACE_AS_STRING_METADATA_KEY => $e->getTraceAsString()]); continue; } foreach ($ruleErrors as $ruleError) { $temporaryFileErrors[] = $this->ruleErrorTransformer->transform($ruleError, $scope, $nodeType, $node->getStartLine()); } } foreach ($collectorRegistry->getCollectors($nodeType) as $collector) { try { $collectedData = $collector->processNode($node, $scope); } catch (AnalysedCodeException $e) { if (isset($uniquedAnalysedCodeExceptionMessages[$e->getMessage()])) { continue; } $uniquedAnalysedCodeExceptionMessages[$e->getMessage()] = \true; $fileErrors[] = (new \PHPStan\Analyser\Error($e->getMessage(), $file, $node->getStartLine(), $e, null, null, $e->getTip()))->withIdentifier('phpstan.internal')->withMetadata([\PHPStan\Analyser\InternalError::STACK_TRACE_METADATA_KEY => \PHPStan\Analyser\InternalError::prepareTrace($e), \PHPStan\Analyser\InternalError::STACK_TRACE_AS_STRING_METADATA_KEY => $e->getTraceAsString()]); continue; } catch (IdentifierNotFound $e) { $fileErrors[] = (new \PHPStan\Analyser\Error(sprintf('Reflection error: %s not found.', $e->getIdentifier()->getName()), $file, $node->getStartLine(), $e, null, null, 'Learn more at https://phpstan.org/user-guide/discovering-symbols'))->withIdentifier('phpstan.reflection')->withMetadata([\PHPStan\Analyser\InternalError::STACK_TRACE_METADATA_KEY => \PHPStan\Analyser\InternalError::prepareTrace($e), \PHPStan\Analyser\InternalError::STACK_TRACE_AS_STRING_METADATA_KEY => $e->getTraceAsString()]); continue; } catch (UnableToCompileNode|CircularReference $e) { $fileErrors[] = (new \PHPStan\Analyser\Error(sprintf('Reflection error: %s', $e->getMessage()), $file, $node->getStartLine(), $e))->withIdentifier('phpstan.reflection')->withMetadata([\PHPStan\Analyser\InternalError::STACK_TRACE_METADATA_KEY => \PHPStan\Analyser\InternalError::prepareTrace($e), \PHPStan\Analyser\InternalError::STACK_TRACE_AS_STRING_METADATA_KEY => $e->getTraceAsString()]); continue; } if ($collectedData === null) { continue; } $fileCollectedData[] = new CollectedData($collectedData, $scope->getFile(), get_class($collector)); } try { $dependencies = $this->dependencyResolver->resolveDependencies($node, $scope); foreach ($dependencies->getFileDependencies($scope->getFile(), $analysedFiles) as $dependentFile) { $fileDependencies[] = $dependentFile; } if ($dependencies->getExportedNode() !== null) { $exportedNodes[] = $dependencies->getExportedNode(); } } catch (AnalysedCodeException $e) { // pass } catch (IdentifierNotFound $e) { // pass } catch (UnableToCompileNode $e) { // pass } }; $scope = $this->scopeFactory->create(\PHPStan\Analyser\ScopeContext::create($file)); $nodeCallback(new FileNode($parserNodes), $scope); $this->nodeScopeResolver->processNodes($parserNodes, $scope, $nodeCallback); $localIgnoresProcessorResult = $this->localIgnoresProcessor->process($temporaryFileErrors, $linesToIgnore, $unmatchedLineIgnores); foreach ($localIgnoresProcessorResult->getFileErrors() as $fileError) { $fileErrors[] = $fileError; } foreach ($localIgnoresProcessorResult->getLocallyIgnoredErrors() as $locallyIgnoredError) { $locallyIgnoredErrors[] = $locallyIgnoredError; } $linesToIgnore = $localIgnoresProcessorResult->getLinesToIgnore(); $unmatchedLineIgnores = $localIgnoresProcessorResult->getUnmatchedLineIgnores(); } catch (\PhpParser\Error $e) { $fileErrors[] = (new \PHPStan\Analyser\Error($e->getRawMessage(), $file, $e->getStartLine() !== -1 ? $e->getStartLine() : null, $e))->withIdentifier('phpstan.parse'); } catch (ParserErrorsException $e) { foreach ($e->getErrors() as $error) { $fileErrors[] = (new \PHPStan\Analyser\Error($error->getMessage(), $e->getParsedFile() ?? $file, $error->getLine() !== -1 ? $error->getStartLine() : null, $e))->withIdentifier('phpstan.parse'); } } catch (AnalysedCodeException $e) { $fileErrors[] = (new \PHPStan\Analyser\Error($e->getMessage(), $file, null, $e, null, null, $e->getTip()))->withIdentifier('phpstan.internal')->withMetadata([\PHPStan\Analyser\InternalError::STACK_TRACE_METADATA_KEY => \PHPStan\Analyser\InternalError::prepareTrace($e), \PHPStan\Analyser\InternalError::STACK_TRACE_AS_STRING_METADATA_KEY => $e->getTraceAsString()]); } catch (IdentifierNotFound $e) { $fileErrors[] = (new \PHPStan\Analyser\Error(sprintf('Reflection error: %s not found.', $e->getIdentifier()->getName()), $file, null, $e, null, null, 'Learn more at https://phpstan.org/user-guide/discovering-symbols'))->withIdentifier('phpstan.reflection')->withMetadata([\PHPStan\Analyser\InternalError::STACK_TRACE_METADATA_KEY => \PHPStan\Analyser\InternalError::prepareTrace($e), \PHPStan\Analyser\InternalError::STACK_TRACE_AS_STRING_METADATA_KEY => $e->getTraceAsString()]); } catch (UnableToCompileNode|CircularReference $e) { $fileErrors[] = (new \PHPStan\Analyser\Error(sprintf('Reflection error: %s', $e->getMessage()), $file, null, $e))->withIdentifier('phpstan.reflection')->withMetadata([\PHPStan\Analyser\InternalError::STACK_TRACE_METADATA_KEY => \PHPStan\Analyser\InternalError::prepareTrace($e), \PHPStan\Analyser\InternalError::STACK_TRACE_AS_STRING_METADATA_KEY => $e->getTraceAsString()]); } } elseif (is_dir($file)) { $fileErrors[] = (new \PHPStan\Analyser\Error(sprintf('File %s is a directory.', $file), $file, null, \false))->withIdentifier('phpstan.path'); } else { $fileErrors[] = (new \PHPStan\Analyser\Error(sprintf('File %s does not exist.', $file), $file, null, \false))->withIdentifier('phpstan.path'); } $this->restoreCollectErrorsHandler(); foreach ($linesToIgnore as $fileKey => $lines) { if (count($lines) > 0) { continue; } unset($linesToIgnore[$fileKey]); } foreach ($unmatchedLineIgnores as $fileKey => $lines) { if (count($lines) > 0) { continue; } unset($unmatchedLineIgnores[$fileKey]); } return new \PHPStan\Analyser\FileAnalyserResult($fileErrors, $this->filteredPhpErrors, $this->allPhpErrors, $locallyIgnoredErrors, $fileCollectedData, array_values(array_unique($fileDependencies)), $exportedNodes, $linesToIgnore, $unmatchedLineIgnores); } /** * @param Node[] $nodes * @return array<int, non-empty-list<string>|null> */ private function getLinesToIgnoreFromTokens(array $nodes) : array { if (!isset($nodes[0])) { return []; } /** @var array<int, non-empty-list<string>|null> */ return $nodes[0]->getAttribute('linesToIgnore', []); } /** * @param array<string, true> $analysedFiles */ private function collectErrors(array $analysedFiles) : void { $this->filteredPhpErrors = []; $this->allPhpErrors = []; set_error_handler(function (int $errno, string $errstr, string $errfile, int $errline) use($analysedFiles) : bool { if ((error_reporting() & $errno) === 0) { // silence @ operator return \true; } $errorMessage = sprintf('%s: %s', $this->getErrorLabel($errno), $errstr); $this->allPhpErrors[] = (new \PHPStan\Analyser\Error($errorMessage, $errfile, $errline, \true))->withIdentifier('phpstan.php'); if ($errno === E_DEPRECATED) { return \true; } if (!isset($analysedFiles[$errfile])) { return \true; } $this->filteredPhpErrors[] = (new \PHPStan\Analyser\Error($errorMessage, $errfile, $errline, \true))->withIdentifier('phpstan.php'); return \true; }); } private function restoreCollectErrorsHandler() : void { restore_error_handler(); } private function getErrorLabel(int $errno) : string { switch ($errno) { case E_ERROR: return 'Fatal error'; case E_WARNING: return 'Warning'; case E_PARSE: return 'Parse error'; case E_NOTICE: return 'Notice'; case E_USER_ERROR: return 'User error (E_USER_ERROR)'; case E_USER_WARNING: return 'User warning (E_USER_WARNING)'; case E_USER_NOTICE: return 'User notice (E_USER_NOTICE)'; case E_STRICT: return 'Strict error (E_STRICT)'; } return 'Unknown PHP error'; } } <?php declare (strict_types=1); namespace PHPStan\Analyser; use JsonSerializable; use ReturnTypeWillChange; use Throwable; use function array_map; use function array_unshift; /** * @api * @final * @phpstan-type Trace = list<array{file: string|null, line: int|null}> */ class InternalError implements JsonSerializable { /** * @var string */ private $message; /** * @var string */ private $contextDescription; /** * @var Trace */ private $trace; /** * @var ?string */ private $traceAsString; /** * @var bool */ private $shouldReportBug; public const STACK_TRACE_METADATA_KEY = 'stackTrace'; public const STACK_TRACE_AS_STRING_METADATA_KEY = 'stackTraceAsString'; /** * @param Trace $trace */ public function __construct(string $message, string $contextDescription, array $trace, ?string $traceAsString, bool $shouldReportBug) { $this->message = $message; $this->contextDescription = $contextDescription; $this->trace = $trace; $this->traceAsString = $traceAsString; $this->shouldReportBug = $shouldReportBug; } /** * @return Trace */ public static function prepareTrace(Throwable $exception) : array { $trace = array_map(static function (array $trace) { return ['file' => $trace['file'] ?? null, 'line' => $trace['line'] ?? null]; }, $exception->getTrace()); array_unshift($trace, ['file' => $exception->getFile(), 'line' => $exception->getLine()]); return $trace; } public function getMessage() : string { return $this->message; } public function getContextDescription() : string { return $this->contextDescription; } /** * @return Trace */ public function getTrace() : array { return $this->trace; } public function getTraceAsString() : ?string { return $this->traceAsString; } public function shouldReportBug() : bool { return $this->shouldReportBug; } /** * @param mixed[] $json */ public static function decode(array $json) : self { return new self($json['message'], $json['contextDescription'], $json['trace'], $json['traceAsString'], $json['shouldReportBug']); } /** * @return mixed */ #[\ReturnTypeWillChange] public function jsonSerialize() { return ['message' => $this->message, 'contextDescription' => $this->contextDescription, 'trace' => $this->trace, 'traceAsString' => $this->traceAsString, 'shouldReportBug' => $this->shouldReportBug]; } } <?php declare (strict_types=1); namespace PHPStan\Analyser; use PhpParser\Node\Stmt; /** * @api * @final */ class StatementExitPoint { /** * @var Stmt */ private $statement; /** * @var MutatingScope */ private $scope; public function __construct(Stmt $statement, \PHPStan\Analyser\MutatingScope $scope) { $this->statement = $statement; $this->scope = $scope; } public function getStatement() : Stmt { return $this->statement; } public function getScope() : \PHPStan\Analyser\MutatingScope { return $this->scope; } } <?php declare (strict_types=1); namespace PHPStan\Analyser; use PHPStan\ShouldNotHappenException; use PHPStan\Type\VerbosityLevel; use function count; use function implode; use function sprintf; final class ConditionalExpressionHolder { /** * @var array<string, ExpressionTypeHolder> */ private $conditionExpressionTypeHolders; /** * @var ExpressionTypeHolder */ private $typeHolder; /** * @param array<string, ExpressionTypeHolder> $conditionExpressionTypeHolders */ public function __construct(array $conditionExpressionTypeHolders, \PHPStan\Analyser\ExpressionTypeHolder $typeHolder) { $this->conditionExpressionTypeHolders = $conditionExpressionTypeHolders; $this->typeHolder = $typeHolder; if (count($conditionExpressionTypeHolders) === 0) { throw new ShouldNotHappenException(); } } /** * @return array<string, ExpressionTypeHolder> */ public function getConditionExpressionTypeHolders() : array { return $this->conditionExpressionTypeHolders; } public function getTypeHolder() : \PHPStan\Analyser\ExpressionTypeHolder { return $this->typeHolder; } public function getKey() : string { $parts = []; foreach ($this->conditionExpressionTypeHolders as $exprString => $typeHolder) { $parts[] = $exprString . '=' . $typeHolder->getType()->describe(VerbosityLevel::precise()); } return sprintf('%s => %s (%s)', implode(' && ', $parts), $this->typeHolder->getType()->describe(VerbosityLevel::precise()), $this->typeHolder->getCertainty()->describe()); } } <?php declare (strict_types=1); namespace PHPStan\Analyser; use PhpParser\Node; use PHPStan\Node\VirtualNode; /** * @phpstan-type ImpurePointIdentifier = 'echo'|'die'|'exit'|'propertyAssign'|'propertyAssignByRef'|'propertyUnset'|'methodCall'|'new'|'functionCall'|'include'|'require'|'print'|'eval'|'superglobal'|'yield'|'yieldFrom'|'static'|'global'|'betweenPhpTags' * @api * @final */ class ImpurePoint { /** * @var Scope */ private $scope; /** * @var Node\Expr|Node\Stmt|VirtualNode */ private $node; /** * @var ImpurePointIdentifier */ private $identifier; /** * @var string */ private $description; /** * @var bool */ private $certain; /** * @param Node\Expr|Node\Stmt|VirtualNode $node * @param ImpurePointIdentifier $identifier */ public function __construct(\PHPStan\Analyser\Scope $scope, Node $node, string $identifier, string $description, bool $certain) { $this->scope = $scope; $this->node = $node; $this->identifier = $identifier; $this->description = $description; $this->certain = $certain; } public function getScope() : \PHPStan\Analyser\Scope { return $this->scope; } /** * @return Node\Expr|Node\Stmt|VirtualNode */ public function getNode() { return $this->node; } /** * @return ImpurePointIdentifier */ public function getIdentifier() : string { return $this->identifier; } public function getDescription() : string { return $this->description; } public function isCertain() : bool { return $this->certain; } } <?php declare (strict_types=1); namespace PHPStan\Analyser; use Exception; use JsonSerializable; use _PHPStan_7d8742a37\Nette\Utils\Strings; use PhpParser\Node; use PHPStan\ShouldNotHappenException; use ReturnTypeWillChange; use Throwable; use function is_bool; use function sprintf; /** * @api * @final */ class Error implements JsonSerializable { /** * @var string */ private $message; /** * @var string */ private $file; /** * @var ?int */ private $line; /** * @var bool|Throwable */ private $canBeIgnored; /** * @var ?string */ private $filePath; /** * @var ?string */ private $traitFilePath; /** * @var ?string */ private $tip; /** * @var ?int */ private $nodeLine; /** * @var class-string<Node>|null */ private $nodeType; /** * @var ?string */ private $identifier; /** * @var mixed[] */ private $metadata; public const PATTERN_IDENTIFIER = '[a-zA-Z0-9](?:[a-zA-Z0-9\\.]*[a-zA-Z0-9])?'; /** * Error constructor. * * @param class-string<Node>|null $nodeType * @param mixed[] $metadata * @param bool|Throwable $canBeIgnored */ public function __construct(string $message, string $file, ?int $line = null, $canBeIgnored = \true, ?string $filePath = null, ?string $traitFilePath = null, ?string $tip = null, ?int $nodeLine = null, ?string $nodeType = null, ?string $identifier = null, array $metadata = []) { $this->message = $message; $this->file = $file; $this->line = $line; $this->canBeIgnored = $canBeIgnored; $this->filePath = $filePath; $this->traitFilePath = $traitFilePath; $this->tip = $tip; $this->nodeLine = $nodeLine; $this->nodeType = $nodeType; $this->identifier = $identifier; $this->metadata = $metadata; if ($this->identifier !== null && !self::validateIdentifier($this->identifier)) { throw new ShouldNotHappenException(sprintf('Invalid identifier: %s', $this->identifier)); } } public function getMessage() : string { return $this->message; } public function getFile() : string { return $this->file; } public function getFilePath() : string { if ($this->filePath === null) { return $this->file; } return $this->filePath; } public function changeFilePath(string $newFilePath) : self { if ($this->traitFilePath !== null) { throw new ShouldNotHappenException('Errors in traits not yet supported'); } return new self($this->message, $newFilePath, $this->line, $this->canBeIgnored, $newFilePath, null, $this->tip, $this->nodeLine, $this->nodeType, $this->identifier, $this->metadata); } public function changeTraitFilePath(string $newFilePath) : self { return new self($this->message, $this->file, $this->line, $this->canBeIgnored, $this->filePath, $newFilePath, $this->tip, $this->nodeLine, $this->nodeType, $this->identifier, $this->metadata); } public function getTraitFilePath() : ?string { return $this->traitFilePath; } public function getLine() : ?int { return $this->line; } public function canBeIgnored() : bool { return $this->canBeIgnored === \true; } public function hasNonIgnorableException() : bool { return $this->canBeIgnored instanceof Throwable; } public function getTip() : ?string { return $this->tip; } public function withoutTip() : self { if ($this->tip === null) { return $this; } return new self($this->message, $this->file, $this->line, $this->canBeIgnored, $this->filePath, $this->traitFilePath, null, $this->nodeLine, $this->nodeType); } public function doNotIgnore() : self { if (!$this->canBeIgnored()) { return $this; } return new self($this->message, $this->file, $this->line, \false, $this->filePath, $this->traitFilePath, $this->tip, $this->nodeLine, $this->nodeType); } public function withIdentifier(string $identifier) : self { if ($this->identifier !== null) { throw new ShouldNotHappenException(sprintf('Error already has an identifier: %s', $this->identifier)); } return new self($this->message, $this->file, $this->line, $this->canBeIgnored, $this->filePath, $this->traitFilePath, $this->tip, $this->nodeLine, $this->nodeType, $identifier, $this->metadata); } /** * @param mixed[] $metadata */ public function withMetadata(array $metadata) : self { if ($this->metadata !== []) { throw new ShouldNotHappenException('Error already has metadata'); } return new self($this->message, $this->file, $this->line, $this->canBeIgnored, $this->filePath, $this->traitFilePath, $this->tip, $this->nodeLine, $this->nodeType, $this->identifier, $metadata); } public function getNodeLine() : ?int { return $this->nodeLine; } /** * @return class-string<Node>|null */ public function getNodeType() : ?string { return $this->nodeType; } /** * Error identifier set via `RuleErrorBuilder::identifier()`. * * List of all current error identifiers in PHPStan: https://phpstan.org/error-identifiers */ public function getIdentifier() : ?string { return $this->identifier; } /** * @return mixed[] */ public function getMetadata() : array { return $this->metadata; } /** * @return mixed */ #[\ReturnTypeWillChange] public function jsonSerialize() { return ['message' => $this->message, 'file' => $this->file, 'line' => $this->line, 'canBeIgnored' => is_bool($this->canBeIgnored) ? $this->canBeIgnored : 'exception', 'filePath' => $this->filePath, 'traitFilePath' => $this->traitFilePath, 'tip' => $this->tip, 'nodeLine' => $this->nodeLine, 'nodeType' => $this->nodeType, 'identifier' => $this->identifier, 'metadata' => $this->metadata]; } /** * @param mixed[] $json */ public static function decode(array $json) : self { return new self($json['message'], $json['file'], $json['line'], $json['canBeIgnored'] === 'exception' ? new Exception() : $json['canBeIgnored'], $json['filePath'], $json['traitFilePath'], $json['tip'], $json['nodeLine'] ?? null, $json['nodeType'] ?? null, $json['identifier'] ?? null, $json['metadata'] ?? []); } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : self { return new self($properties['message'], $properties['file'], $properties['line'], $properties['canBeIgnored'], $properties['filePath'], $properties['traitFilePath'], $properties['tip'], $properties['nodeLine'] ?? null, $properties['nodeType'] ?? null, $properties['identifier'] ?? null, $properties['metadata'] ?? []); } public static function validateIdentifier(string $identifier) : bool { return Strings::match($identifier, '~^' . self::PATTERN_IDENTIFIER . '$~') !== null; } } <?php declare (strict_types=1); namespace PHPStan\Analyser; use PhpParser\Node\Expr; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; final class SpecifiedTypes { /** * @var array<string, array{Expr, Type}> */ private $sureTypes; /** * @var array<string, array{Expr, Type}> */ private $sureNotTypes; /** * @var bool */ private $overwrite; /** * @var array<string, ConditionalExpressionHolder[]> */ private $newConditionalExpressionHolders; /** * @var ?Expr */ private $rootExpr; /** * @api * @param array<string, array{Expr, Type}> $sureTypes * @param array<string, array{Expr, Type}> $sureNotTypes * @param array<string, ConditionalExpressionHolder[]> $newConditionalExpressionHolders */ public function __construct(array $sureTypes = [], array $sureNotTypes = [], bool $overwrite = \false, array $newConditionalExpressionHolders = [], ?Expr $rootExpr = null) { $this->sureTypes = $sureTypes; $this->sureNotTypes = $sureNotTypes; $this->overwrite = $overwrite; $this->newConditionalExpressionHolders = $newConditionalExpressionHolders; $this->rootExpr = $rootExpr; } /** * @api * @return array<string, array{Expr, Type}> */ public function getSureTypes() : array { return $this->sureTypes; } /** * @api * @return array<string, array{Expr, Type}> */ public function getSureNotTypes() : array { return $this->sureNotTypes; } public function shouldOverwrite() : bool { return $this->overwrite; } /** * @return array<string, ConditionalExpressionHolder[]> */ public function getNewConditionalExpressionHolders() : array { return $this->newConditionalExpressionHolders; } public function getRootExpr() : ?Expr { return $this->rootExpr; } /** @api */ public function intersectWith(\PHPStan\Analyser\SpecifiedTypes $other) : self { $sureTypeUnion = []; $sureNotTypeUnion = []; $rootExpr = $this->mergeRootExpr($this->rootExpr, $other->rootExpr); foreach ($this->sureTypes as $exprString => [$exprNode, $type]) { if (!isset($other->sureTypes[$exprString])) { continue; } $sureTypeUnion[$exprString] = [$exprNode, TypeCombinator::union($type, $other->sureTypes[$exprString][1])]; } foreach ($this->sureNotTypes as $exprString => [$exprNode, $type]) { if (!isset($other->sureNotTypes[$exprString])) { continue; } $sureNotTypeUnion[$exprString] = [$exprNode, TypeCombinator::intersect($type, $other->sureNotTypes[$exprString][1])]; } return new self($sureTypeUnion, $sureNotTypeUnion, $this->overwrite && $other->overwrite, [], $rootExpr); } /** @api */ public function unionWith(\PHPStan\Analyser\SpecifiedTypes $other) : self { $sureTypeUnion = $this->sureTypes + $other->sureTypes; $sureNotTypeUnion = $this->sureNotTypes + $other->sureNotTypes; $rootExpr = $this->mergeRootExpr($this->rootExpr, $other->rootExpr); foreach ($this->sureTypes as $exprString => [$exprNode, $type]) { if (!isset($other->sureTypes[$exprString])) { continue; } $sureTypeUnion[$exprString] = [$exprNode, TypeCombinator::intersect($type, $other->sureTypes[$exprString][1])]; } foreach ($this->sureNotTypes as $exprString => [$exprNode, $type]) { if (!isset($other->sureNotTypes[$exprString])) { continue; } $sureNotTypeUnion[$exprString] = [$exprNode, TypeCombinator::union($type, $other->sureNotTypes[$exprString][1])]; } return new self($sureTypeUnion, $sureNotTypeUnion, $this->overwrite || $other->overwrite, [], $rootExpr); } public function normalize(\PHPStan\Analyser\Scope $scope) : self { $sureTypes = $this->sureTypes; foreach ($this->sureNotTypes as $exprString => [$exprNode, $sureNotType]) { if (!isset($sureTypes[$exprString])) { $sureTypes[$exprString] = [$exprNode, TypeCombinator::remove($scope->getType($exprNode), $sureNotType)]; continue; } $sureTypes[$exprString][1] = TypeCombinator::remove($sureTypes[$exprString][1], $sureNotType); } return new self($sureTypes, [], $this->overwrite, $this->newConditionalExpressionHolders, $this->rootExpr); } private function mergeRootExpr(?Expr $rootExprA, ?Expr $rootExprB) : ?Expr { if ($rootExprA === $rootExprB) { return $rootExprA; } if ($rootExprA === null || $rootExprB === null) { return $rootExprA ?? $rootExprB; } return null; } } <?php declare (strict_types=1); namespace PHPStan\Analyser; use PHPStan\Reflection\ClassMemberAccessAnswerer; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ConstantReflection; use PHPStan\Reflection\MethodReflection; use PHPStan\Reflection\PropertyReflection; final class OutOfClassScope implements ClassMemberAccessAnswerer { /** @api */ public function __construct() { } public function isInClass() : bool { return \false; } public function getClassReflection() : ?ClassReflection { return null; } public function canAccessProperty(PropertyReflection $propertyReflection) : bool { return $propertyReflection->isPublic(); } public function canCallMethod(MethodReflection $methodReflection) : bool { return $methodReflection->isPublic(); } public function canAccessConstant(ConstantReflection $constantReflection) : bool { return $constantReflection->isPublic(); } } <?php declare (strict_types=1); namespace PHPStan\Analyser; /** * @phpstan-import-type LinesToIgnore from FileAnalyserResult */ final class LocalIgnoresProcessorResult { /** * @var list<Error> */ private $fileErrors; /** * @var list<Error> */ private $locallyIgnoredErrors; /** * @var LinesToIgnore */ private $linesToIgnore; /** * @var LinesToIgnore */ private $unmatchedLineIgnores; /** * @param list<Error> $fileErrors * @param list<Error> $locallyIgnoredErrors * @param LinesToIgnore $linesToIgnore * @param LinesToIgnore $unmatchedLineIgnores */ public function __construct(array $fileErrors, array $locallyIgnoredErrors, array $linesToIgnore, array $unmatchedLineIgnores) { $this->fileErrors = $fileErrors; $this->locallyIgnoredErrors = $locallyIgnoredErrors; $this->linesToIgnore = $linesToIgnore; $this->unmatchedLineIgnores = $unmatchedLineIgnores; } /** * @return list<Error> */ public function getFileErrors() : array { return $this->fileErrors; } /** * @return list<Error> */ public function getLocallyIgnoredErrors() : array { return $this->locallyIgnoredErrors; } /** * @return LinesToIgnore */ public function getLinesToIgnore() : array { return $this->linesToIgnore; } /** * @return LinesToIgnore */ public function getUnmatchedLineIgnores() : array { return $this->unmatchedLineIgnores; } } <?php declare (strict_types=1); namespace PHPStan\Analyser; final class StatementContext { /** * @var bool */ private $isTopLevel; private function __construct(bool $isTopLevel) { $this->isTopLevel = $isTopLevel; } public static function createTopLevel() : self { return new self(\true); } public static function createDeep() : self { return new self(\false); } public function isTopLevel() : bool { return $this->isTopLevel; } public function enterDeep() : self { if ($this->isTopLevel) { return self::createDeep(); } return $this; } } <?php declare (strict_types=1); namespace PHPStan\Analyser\ResultCache; use function dirname; use function is_file; use function unlink; final class ResultCacheClearer { /** * @var string */ private $cacheFilePath; public function __construct(string $cacheFilePath) { $this->cacheFilePath = $cacheFilePath; } public function clear() : string { $dir = dirname($this->cacheFilePath); if (!is_file($this->cacheFilePath)) { return $dir; } @unlink($this->cacheFilePath); return $dir; } } <?php declare (strict_types=1); namespace PHPStan\Analyser\ResultCache; use PHPStan\Analyser\AnalyserResult; final class ResultCacheProcessResult { /** * @var AnalyserResult */ private $analyserResult; /** * @var bool */ private $saved; public function __construct(AnalyserResult $analyserResult, bool $saved) { $this->analyserResult = $analyserResult; $this->saved = $saved; } public function getAnalyserResult() : AnalyserResult { return $this->analyserResult; } public function isSaved() : bool { return $this->saved; } } <?php declare (strict_types=1); namespace PHPStan\Analyser\ResultCache; use _PHPStan_7d8742a37\Nette\Neon\Neon; use PHPStan\Analyser\AnalyserResult; use PHPStan\Analyser\Error; use PHPStan\Analyser\FileAnalyserResult; use PHPStan\Collectors\CollectedData; use PHPStan\Command\Output; use PHPStan\Dependency\ExportedNodeFetcher; use PHPStan\Dependency\RootExportedNode; use PHPStan\DependencyInjection\ProjectConfigHelper; use PHPStan\File\CouldNotReadFileException; use PHPStan\File\FileFinder; use PHPStan\File\FileHelper; use PHPStan\File\FileWriter; use PHPStan\Internal\ComposerHelper; use PHPStan\PhpDoc\StubFilesProvider; use PHPStan\Reflection\ReflectionProvider; use PHPStan\ShouldNotHappenException; use Throwable; use function array_diff; use function array_fill_keys; use function array_filter; use function array_key_exists; use function array_keys; use function array_unique; use function array_values; use function count; use function get_loaded_extensions; use function implode; use function is_array; use function is_file; use function ksort; use function microtime; use function round; use function sha1_file; use function sort; use function sprintf; use function str_starts_with; use function time; use function unlink; use function var_export; use const PHP_VERSION_ID; /** * @phpstan-import-type LinesToIgnore from FileAnalyserResult */ final class ResultCacheManager { /** * @var ExportedNodeFetcher */ private $exportedNodeFetcher; /** * @var FileFinder */ private $scanFileFinder; /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var StubFilesProvider */ private $stubFilesProvider; /** * @var FileHelper */ private $fileHelper; /** * @var string */ private $cacheFilePath; /** * @var string[] */ private $analysedPaths; /** * @var string[] */ private $composerAutoloaderProjectPaths; /** * @var string */ private $usedLevel; /** * @var ?string */ private $cliAutoloadFile; /** * @var string[] */ private $bootstrapFiles; /** * @var string[] */ private $scanFiles; /** * @var string[] */ private $scanDirectories; /** * @var bool */ private $checkDependenciesOfProjectExtensionFiles; private const CACHE_VERSION = 'v12-linesToIgnore'; /** @var array<string, string> */ private $fileHashes = []; /** @var array<string, true> */ private $alreadyProcessed = []; /** * @param string[] $analysedPaths * @param string[] $composerAutoloaderProjectPaths * @param string[] $bootstrapFiles * @param string[] $scanFiles * @param string[] $scanDirectories */ public function __construct(ExportedNodeFetcher $exportedNodeFetcher, FileFinder $scanFileFinder, ReflectionProvider $reflectionProvider, StubFilesProvider $stubFilesProvider, FileHelper $fileHelper, string $cacheFilePath, array $analysedPaths, array $composerAutoloaderProjectPaths, string $usedLevel, ?string $cliAutoloadFile, array $bootstrapFiles, array $scanFiles, array $scanDirectories, bool $checkDependenciesOfProjectExtensionFiles) { $this->exportedNodeFetcher = $exportedNodeFetcher; $this->scanFileFinder = $scanFileFinder; $this->reflectionProvider = $reflectionProvider; $this->stubFilesProvider = $stubFilesProvider; $this->fileHelper = $fileHelper; $this->cacheFilePath = $cacheFilePath; $this->analysedPaths = $analysedPaths; $this->composerAutoloaderProjectPaths = $composerAutoloaderProjectPaths; $this->usedLevel = $usedLevel; $this->cliAutoloadFile = $cliAutoloadFile; $this->bootstrapFiles = $bootstrapFiles; $this->scanFiles = $scanFiles; $this->scanDirectories = $scanDirectories; $this->checkDependenciesOfProjectExtensionFiles = $checkDependenciesOfProjectExtensionFiles; } /** * @param string[] $allAnalysedFiles * @param mixed[]|null $projectConfigArray */ public function restore(array $allAnalysedFiles, bool $debug, bool $onlyFiles, ?array $projectConfigArray, Output $output) : \PHPStan\Analyser\ResultCache\ResultCache { $startTime = microtime(\true); if ($debug) { if ($output->isVeryVerbose()) { $output->writeLineFormatted('Result cache not used because of debug mode.'); } return new \PHPStan\Analyser\ResultCache\ResultCache($allAnalysedFiles, \true, time(), $this->getMeta($allAnalysedFiles, $projectConfigArray), [], [], [], [], [], [], [], []); } if ($onlyFiles) { if ($output->isVeryVerbose()) { $output->writeLineFormatted('Result cache not used because only files were passed as analysed paths.'); } return new \PHPStan\Analyser\ResultCache\ResultCache($allAnalysedFiles, \true, time(), $this->getMeta($allAnalysedFiles, $projectConfigArray), [], [], [], [], [], [], [], []); } $cacheFilePath = $this->cacheFilePath; if (!is_file($cacheFilePath)) { if ($output->isVeryVerbose()) { $output->writeLineFormatted('Result cache not used because the cache file does not exist.'); } return new \PHPStan\Analyser\ResultCache\ResultCache($allAnalysedFiles, \true, time(), $this->getMeta($allAnalysedFiles, $projectConfigArray), [], [], [], [], [], [], [], []); } try { $data = (require $cacheFilePath); } catch (Throwable $e) { if ($output->isVeryVerbose()) { $output->writeLineFormatted(sprintf('Result cache not used because an error occurred while loading the cache file: %s', $e->getMessage())); } @unlink($cacheFilePath); return new \PHPStan\Analyser\ResultCache\ResultCache($allAnalysedFiles, \true, time(), $this->getMeta($allAnalysedFiles, $projectConfigArray), [], [], [], [], [], [], [], []); } if (!is_array($data)) { @unlink($cacheFilePath); if ($output->isVeryVerbose()) { $output->writeLineFormatted('Result cache not used because the cache file is corrupted.'); } return new \PHPStan\Analyser\ResultCache\ResultCache($allAnalysedFiles, \true, time(), $this->getMeta($allAnalysedFiles, $projectConfigArray), [], [], [], [], [], [], [], []); } $meta = $this->getMeta($allAnalysedFiles, $projectConfigArray); if ($this->isMetaDifferent($data['meta'], $meta)) { if ($output->isVeryVerbose()) { $diffs = $this->getMetaKeyDifferences($data['meta'], $meta); $output->writeLineFormatted('Result cache not used because the metadata do not match: ' . implode(', ', $diffs)); } return new \PHPStan\Analyser\ResultCache\ResultCache($allAnalysedFiles, \true, time(), $meta, [], [], [], [], [], [], [], []); } if (time() - $data['lastFullAnalysisTime'] >= 60 * 60 * 24 * 7) { if ($output->isVeryVerbose()) { $output->writeLineFormatted('Result cache not used because it\'s more than 7 days since last full analysis.'); } // run full analysis if the result cache is older than 7 days return new \PHPStan\Analyser\ResultCache\ResultCache($allAnalysedFiles, \true, time(), $meta, [], [], [], [], [], [], [], []); } /** * @var string $fileHash * @var bool $isAnalysed */ foreach ($data['projectExtensionFiles'] as $extensionFile => [$fileHash, $isAnalysed]) { if (!$isAnalysed) { continue; } if (!is_file($extensionFile)) { if ($output->isVeryVerbose()) { $output->writeLineFormatted(sprintf('Result cache not used because extension file %s was not found.', $extensionFile)); } return new \PHPStan\Analyser\ResultCache\ResultCache($allAnalysedFiles, \true, time(), $meta, [], [], [], [], [], [], [], []); } if ($this->getFileHash($extensionFile) === $fileHash) { continue; } if ($output->isVeryVerbose()) { $output->writeLineFormatted(sprintf('Result cache not used because extension file %s hash does not match.', $extensionFile)); } return new \PHPStan\Analyser\ResultCache\ResultCache($allAnalysedFiles, \true, time(), $meta, [], [], [], [], [], [], [], []); } $invertedDependencies = $data['dependencies']; $deletedFiles = array_fill_keys(array_keys($invertedDependencies), \true); $filesToAnalyse = []; $invertedDependenciesToReturn = []; $errors = $data['errorsCallback'](); $locallyIgnoredErrors = $data['locallyIgnoredErrorsCallback'](); $linesToIgnore = $data['linesToIgnore']; $unmatchedLineIgnores = $data['unmatchedLineIgnores']; $collectedData = $data['collectedDataCallback'](); $exportedNodes = $data['exportedNodesCallback'](); $filteredErrors = []; $filteredLocallyIgnoredErrors = []; $filteredLinesToIgnore = []; $filteredUnmatchedLineIgnores = []; $filteredCollectedData = []; $filteredExportedNodes = []; $newFileAppeared = \false; foreach ($this->getStubFiles() as $stubFile) { if (!array_key_exists($stubFile, $errors)) { continue; } $filteredErrors[$stubFile] = $errors[$stubFile]; } foreach ($allAnalysedFiles as $analysedFile) { if (array_key_exists($analysedFile, $errors)) { $filteredErrors[$analysedFile] = $errors[$analysedFile]; } if (array_key_exists($analysedFile, $locallyIgnoredErrors)) { $filteredLocallyIgnoredErrors[$analysedFile] = $locallyIgnoredErrors[$analysedFile]; } if (array_key_exists($analysedFile, $linesToIgnore)) { $filteredLinesToIgnore[$analysedFile] = $linesToIgnore[$analysedFile]; } if (array_key_exists($analysedFile, $unmatchedLineIgnores)) { $filteredUnmatchedLineIgnores[$analysedFile] = $unmatchedLineIgnores[$analysedFile]; } if (array_key_exists($analysedFile, $collectedData)) { $filteredCollectedData[$analysedFile] = $collectedData[$analysedFile]; } if (array_key_exists($analysedFile, $exportedNodes)) { $filteredExportedNodes[$analysedFile] = $exportedNodes[$analysedFile]; } if (!array_key_exists($analysedFile, $invertedDependencies)) { // new file $filesToAnalyse[] = $analysedFile; $newFileAppeared = \true; continue; } unset($deletedFiles[$analysedFile]); $analysedFileData = $invertedDependencies[$analysedFile]; $cachedFileHash = $analysedFileData['fileHash']; $dependentFiles = $analysedFileData['dependentFiles']; $invertedDependenciesToReturn[$analysedFile] = $dependentFiles; $currentFileHash = $this->getFileHash($analysedFile); if ($cachedFileHash === $currentFileHash) { continue; } $filesToAnalyse[] = $analysedFile; if (!array_key_exists($analysedFile, $filteredExportedNodes)) { continue; } $cachedFileExportedNodes = $filteredExportedNodes[$analysedFile]; $exportedNodesChanged = $this->exportedNodesChanged($analysedFile, $cachedFileExportedNodes); if ($exportedNodesChanged === null) { continue; } if ($exportedNodesChanged) { $newFileAppeared = \true; } foreach ($dependentFiles as $dependentFile) { if (!is_file($dependentFile)) { continue; } $filesToAnalyse[] = $dependentFile; } } foreach (array_keys($deletedFiles) as $deletedFile) { if (!array_key_exists($deletedFile, $invertedDependencies)) { continue; } $deletedFileData = $invertedDependencies[$deletedFile]; $dependentFiles = $deletedFileData['dependentFiles']; foreach ($dependentFiles as $dependentFile) { if (!is_file($dependentFile)) { continue; } $filesToAnalyse[] = $dependentFile; } } if ($newFileAppeared) { foreach (array_keys($filteredErrors) as $fileWithError) { $filesToAnalyse[] = $fileWithError; } } $filesToAnalyse = array_unique($filesToAnalyse); $filesToAnalyseCount = count($filesToAnalyse); if ($output->isVeryVerbose()) { $elapsed = microtime(\true) - $startTime; $elapsedString = $elapsed > 5 ? sprintf(' in %f seconds', round($elapsed, 1)) : ''; $output->writeLineFormatted(sprintf('Result cache restored%s. %d %s will be reanalysed.', $elapsedString, $filesToAnalyseCount, $filesToAnalyseCount === 1 ? 'file' : 'files')); } return new \PHPStan\Analyser\ResultCache\ResultCache($filesToAnalyse, \false, $data['lastFullAnalysisTime'], $meta, $filteredErrors, $filteredLocallyIgnoredErrors, $filteredLinesToIgnore, $filteredUnmatchedLineIgnores, $filteredCollectedData, $invertedDependenciesToReturn, $filteredExportedNodes, $data['projectExtensionFiles']); } /** * @param mixed[] $cachedMeta * @param mixed[] $currentMeta */ private function isMetaDifferent(array $cachedMeta, array $currentMeta) : bool { $projectConfig = $currentMeta['projectConfig']; if ($projectConfig !== null) { ksort($currentMeta['projectConfig']); $currentMeta['projectConfig'] = Neon::encode($currentMeta['projectConfig']); } return $cachedMeta !== $currentMeta; } /** * @param mixed[] $cachedMeta * @param mixed[] $currentMeta * * @return string[] */ private function getMetaKeyDifferences(array $cachedMeta, array $currentMeta) : array { $diffs = []; foreach ($cachedMeta as $key => $value) { if (!array_key_exists($key, $currentMeta)) { $diffs[] = $key; continue; } if ($value === $currentMeta[$key]) { continue; } $diffs[] = $key; } if ($diffs === []) { // when none of the keys is different, // the order of the keys is the problem $diffs[] = 'keyOrder'; } return $diffs; } /** * @param array<int, RootExportedNode> $cachedFileExportedNodes * @return bool|null null means nothing changed, true means new root symbol appeared, false means nested node changed */ private function exportedNodesChanged(string $analysedFile, array $cachedFileExportedNodes) : ?bool { $fileExportedNodes = $this->exportedNodeFetcher->fetchNodes($analysedFile); $cachedSymbols = []; foreach ($cachedFileExportedNodes as $cachedFileExportedNode) { $cachedSymbols[$cachedFileExportedNode->getType()][] = $cachedFileExportedNode->getName(); } $fileSymbols = []; foreach ($fileExportedNodes as $fileExportedNode) { $fileSymbols[$fileExportedNode->getType()][] = $fileExportedNode->getName(); } if ($cachedSymbols !== $fileSymbols) { return \true; } if (count($fileExportedNodes) !== count($cachedFileExportedNodes)) { return \true; } foreach ($fileExportedNodes as $i => $fileExportedNode) { $cachedExportedNode = $cachedFileExportedNodes[$i]; if (!$cachedExportedNode->equals($fileExportedNode)) { return \false; } } return null; } public function process(AnalyserResult $analyserResult, \PHPStan\Analyser\ResultCache\ResultCache $resultCache, Output $output, bool $onlyFiles, bool $save) : \PHPStan\Analyser\ResultCache\ResultCacheProcessResult { $internalErrors = $analyserResult->getInternalErrors(); $freshErrorsByFile = []; foreach ($analyserResult->getErrors() as $error) { $freshErrorsByFile[$error->getFilePath()][] = $error; } $freshLocallyIgnoredErrorsByFile = []; foreach ($analyserResult->getLocallyIgnoredErrors() as $error) { $freshLocallyIgnoredErrorsByFile[$error->getFilePath()][] = $error; } $freshCollectedDataByFile = []; foreach ($analyserResult->getCollectedData() as $collectedData) { $freshCollectedDataByFile[$collectedData->getFilePath()][] = $collectedData; } $meta = $resultCache->getMeta(); $projectConfigArray = $meta['projectConfig']; if ($projectConfigArray !== null) { $meta['projectConfig'] = Neon::encode($projectConfigArray); } $doSave = function (array $errorsByFile, $locallyIgnoredErrorsByFile, $linesToIgnore, $unmatchedLineIgnores, $collectedDataByFile, ?array $dependencies, array $exportedNodes, array $projectExtensionFiles) use($internalErrors, $resultCache, $output, $onlyFiles, $meta) : bool { if ($onlyFiles) { if ($output->isVeryVerbose()) { $output->writeLineFormatted('Result cache was not saved because only files were passed as analysed paths.'); } return \false; } if ($dependencies === null) { if ($output->isVeryVerbose()) { $output->writeLineFormatted('Result cache was not saved because of error in dependencies.'); } return \false; } if (count($internalErrors) > 0) { if ($output->isVeryVerbose()) { $output->writeLineFormatted('Result cache was not saved because of internal errors.'); } return \false; } foreach ($errorsByFile as $errors) { foreach ($errors as $error) { if (!$error->hasNonIgnorableException()) { continue; } if ($output->isVeryVerbose()) { $output->writeLineFormatted(sprintf('Result cache was not saved because of non-ignorable exception: %s', $error->getMessage())); } return \false; } } $this->save($resultCache->getLastFullAnalysisTime(), $errorsByFile, $locallyIgnoredErrorsByFile, $linesToIgnore, $unmatchedLineIgnores, $collectedDataByFile, $dependencies, $exportedNodes, $projectExtensionFiles, $meta); if ($output->isVeryVerbose()) { $output->writeLineFormatted('Result cache is saved.'); } return \true; }; if ($resultCache->isFullAnalysis()) { $saved = \false; if ($save !== \false) { $projectExtensionFiles = []; if ($analyserResult->getDependencies() !== null) { $projectExtensionFiles = $this->getProjectExtensionFiles($projectConfigArray, $analyserResult->getDependencies()); } $saved = $doSave($freshErrorsByFile, $freshLocallyIgnoredErrorsByFile, $analyserResult->getLinesToIgnore(), $analyserResult->getUnmatchedLineIgnores(), $freshCollectedDataByFile, $analyserResult->getDependencies(), $analyserResult->getExportedNodes(), $projectExtensionFiles); } else { if ($output->isVeryVerbose()) { $output->writeLineFormatted('Result cache was not saved because it was not requested.'); } } return new \PHPStan\Analyser\ResultCache\ResultCacheProcessResult($analyserResult, $saved); } $errorsByFile = $this->mergeErrors($resultCache, $freshErrorsByFile); $locallyIgnoredErrorsByFile = $this->mergeLocallyIgnoredErrors($resultCache, $freshLocallyIgnoredErrorsByFile); $collectedDataByFile = $this->mergeCollectedData($resultCache, $freshCollectedDataByFile); $dependencies = $this->mergeDependencies($resultCache, $analyserResult->getDependencies()); $exportedNodes = $this->mergeExportedNodes($resultCache, $analyserResult->getExportedNodes()); $linesToIgnore = $this->mergeLinesToIgnore($resultCache, $analyserResult->getLinesToIgnore()); $unmatchedLineIgnores = $this->mergeUnmatchedLineIgnores($resultCache, $analyserResult->getUnmatchedLineIgnores()); $saved = \false; if ($save !== \false) { $projectExtensionFiles = []; foreach ($resultCache->getProjectExtensionFiles() as $file => [$hash, $isAnalysed, $className]) { if ($isAnalysed) { continue; } // keep the same file hashes from the old run // so that the message "When you edit them and re-run PHPStan, the result cache will get stale." // keeps being shown on subsequent runs $projectExtensionFiles[$file] = [$hash, \false, $className]; } if ($dependencies !== null) { foreach ($this->getProjectExtensionFiles($projectConfigArray, $dependencies) as $file => [$hash, $isAnalysed, $className]) { if (!$isAnalysed) { continue; } $projectExtensionFiles[$file] = [$hash, \true, $className]; } } $saved = $doSave($errorsByFile, $locallyIgnoredErrorsByFile, $linesToIgnore, $unmatchedLineIgnores, $collectedDataByFile, $dependencies, $exportedNodes, $projectExtensionFiles); } $flatErrors = []; foreach ($errorsByFile as $fileErrors) { foreach ($fileErrors as $fileError) { $flatErrors[] = $fileError; } } $flatLocallyIgnoredErrors = []; foreach ($locallyIgnoredErrorsByFile as $fileErrors) { foreach ($fileErrors as $fileError) { $flatLocallyIgnoredErrors[] = $fileError; } } $flatCollectedData = []; foreach ($collectedDataByFile as $fileCollectedData) { foreach ($fileCollectedData as $collectedData) { $flatCollectedData[] = $collectedData; } } return new \PHPStan\Analyser\ResultCache\ResultCacheProcessResult(new AnalyserResult($flatErrors, $analyserResult->getFilteredPhpErrors(), $analyserResult->getAllPhpErrors(), $flatLocallyIgnoredErrors, $linesToIgnore, $unmatchedLineIgnores, $internalErrors, $flatCollectedData, $dependencies, $exportedNodes, $analyserResult->hasReachedInternalErrorsCountLimit(), $analyserResult->getPeakMemoryUsageBytes()), $saved); } /** * @param array<string, list<Error>> $freshErrorsByFile * @return array<string, list<Error>> */ private function mergeErrors(\PHPStan\Analyser\ResultCache\ResultCache $resultCache, array $freshErrorsByFile) : array { $errorsByFile = $resultCache->getErrors(); foreach ($resultCache->getFilesToAnalyse() as $file) { if (!array_key_exists($file, $freshErrorsByFile)) { unset($errorsByFile[$file]); continue; } $errorsByFile[$file] = $freshErrorsByFile[$file]; } return $errorsByFile; } /** * @param array<string, list<Error>> $freshLocallyIgnoredErrorsByFile * @return array<string, list<Error>> */ private function mergeLocallyIgnoredErrors(\PHPStan\Analyser\ResultCache\ResultCache $resultCache, array $freshLocallyIgnoredErrorsByFile) : array { $errorsByFile = $resultCache->getLocallyIgnoredErrors(); foreach ($resultCache->getFilesToAnalyse() as $file) { if (!array_key_exists($file, $freshLocallyIgnoredErrorsByFile)) { unset($errorsByFile[$file]); continue; } $errorsByFile[$file] = $freshLocallyIgnoredErrorsByFile[$file]; } return $errorsByFile; } /** * @param array<string, array<CollectedData>> $freshCollectedDataByFile * @return array<string, array<CollectedData>> */ private function mergeCollectedData(\PHPStan\Analyser\ResultCache\ResultCache $resultCache, array $freshCollectedDataByFile) : array { $collectedDataByFile = $resultCache->getCollectedData(); foreach ($resultCache->getFilesToAnalyse() as $file) { if (!array_key_exists($file, $freshCollectedDataByFile)) { unset($collectedDataByFile[$file]); continue; } $collectedDataByFile[$file] = $freshCollectedDataByFile[$file]; } return $collectedDataByFile; } /** * @param array<string, array<string>>|null $freshDependencies * @return array<string, array<string>>|null */ private function mergeDependencies(\PHPStan\Analyser\ResultCache\ResultCache $resultCache, ?array $freshDependencies) : ?array { if ($freshDependencies === null) { return null; } $cachedDependencies = []; $resultCacheDependencies = $resultCache->getDependencies(); $filesNoOneIsDependingOn = array_fill_keys(array_keys($resultCacheDependencies), \true); foreach ($resultCacheDependencies as $file => $filesDependingOnFile) { foreach ($filesDependingOnFile as $fileDependingOnFile) { $cachedDependencies[$fileDependingOnFile][] = $file; unset($filesNoOneIsDependingOn[$fileDependingOnFile]); } } foreach (array_keys($filesNoOneIsDependingOn) as $file) { if (array_key_exists($file, $cachedDependencies)) { throw new ShouldNotHappenException(); } $cachedDependencies[$file] = []; } $newDependencies = $cachedDependencies; foreach ($resultCache->getFilesToAnalyse() as $file) { if (!array_key_exists($file, $freshDependencies)) { unset($newDependencies[$file]); continue; } $newDependencies[$file] = $freshDependencies[$file]; } return $newDependencies; } /** * @param array<string, array<RootExportedNode>> $freshExportedNodes * @return array<string, array<RootExportedNode>> */ private function mergeExportedNodes(\PHPStan\Analyser\ResultCache\ResultCache $resultCache, array $freshExportedNodes) : array { $newExportedNodes = $resultCache->getExportedNodes(); foreach ($resultCache->getFilesToAnalyse() as $file) { if (!array_key_exists($file, $freshExportedNodes)) { unset($newExportedNodes[$file]); continue; } $newExportedNodes[$file] = $freshExportedNodes[$file]; } return $newExportedNodes; } /** * @param array<string, LinesToIgnore> $freshLinesToIgnore * @return array<string, LinesToIgnore> */ private function mergeLinesToIgnore(\PHPStan\Analyser\ResultCache\ResultCache $resultCache, array $freshLinesToIgnore) : array { $newLinesToIgnore = $resultCache->getLinesToIgnore(); foreach ($resultCache->getFilesToAnalyse() as $file) { if (!array_key_exists($file, $freshLinesToIgnore)) { unset($newLinesToIgnore[$file]); continue; } $newLinesToIgnore[$file] = $freshLinesToIgnore[$file]; } return $newLinesToIgnore; } /** * @param array<string, LinesToIgnore> $freshUnmatchedLineIgnores * @return array<string, LinesToIgnore> */ private function mergeUnmatchedLineIgnores(\PHPStan\Analyser\ResultCache\ResultCache $resultCache, array $freshUnmatchedLineIgnores) : array { $newUnmatchedLineIgnores = $resultCache->getUnmatchedLineIgnores(); foreach ($resultCache->getFilesToAnalyse() as $file) { if (!array_key_exists($file, $freshUnmatchedLineIgnores)) { unset($newUnmatchedLineIgnores[$file]); continue; } $newUnmatchedLineIgnores[$file] = $freshUnmatchedLineIgnores[$file]; } return $newUnmatchedLineIgnores; } /** * @param array<string, list<Error>> $errors * @param array<string, list<Error>> $locallyIgnoredErrors * @param array<string, LinesToIgnore> $linesToIgnore * @param array<string, LinesToIgnore> $unmatchedLineIgnores * @param array<string, array<CollectedData>> $collectedData * @param array<string, array<string>> $dependencies * @param array<string, array<RootExportedNode>> $exportedNodes * @param array<string, array{string, bool, string}> $projectExtensionFiles * @param mixed[] $meta */ private function save(int $lastFullAnalysisTime, array $errors, array $locallyIgnoredErrors, array $linesToIgnore, array $unmatchedLineIgnores, array $collectedData, array $dependencies, array $exportedNodes, array $projectExtensionFiles, array $meta) : void { $invertedDependencies = []; $filesNoOneIsDependingOn = array_fill_keys(array_keys($dependencies), \true); foreach ($dependencies as $file => $fileDependencies) { foreach ($fileDependencies as $fileDep) { if (!array_key_exists($fileDep, $invertedDependencies)) { $invertedDependencies[$fileDep] = ['fileHash' => $this->getFileHash($fileDep), 'dependentFiles' => []]; unset($filesNoOneIsDependingOn[$fileDep]); } $invertedDependencies[$fileDep]['dependentFiles'][] = $file; } } foreach (array_keys($filesNoOneIsDependingOn) as $file) { if (array_key_exists($file, $invertedDependencies)) { throw new ShouldNotHappenException(); } if (!is_file($file)) { continue; } $invertedDependencies[$file] = ['fileHash' => $this->getFileHash($file), 'dependentFiles' => []]; } ksort($errors); ksort($locallyIgnoredErrors); ksort($linesToIgnore); ksort($unmatchedLineIgnores); ksort($collectedData); ksort($invertedDependencies); foreach ($invertedDependencies as $file => $fileData) { $dependentFiles = $fileData['dependentFiles']; sort($dependentFiles); $invertedDependencies[$file]['dependentFiles'] = $dependentFiles; } ksort($exportedNodes); $file = $this->cacheFilePath; FileWriter::write($file, "<?php declare(strict_types = 1);\n\nreturn [\n\t'lastFullAnalysisTime' => " . var_export($lastFullAnalysisTime, \true) . ",\n\t'meta' => " . var_export($meta, \true) . ",\n\t'projectExtensionFiles' => " . var_export($projectExtensionFiles, \true) . ",\n\t'errorsCallback' => static function (): array { return " . var_export($errors, \true) . "; },\n\t'locallyIgnoredErrorsCallback' => static function (): array { return " . var_export($locallyIgnoredErrors, \true) . "; },\n\t'linesToIgnore' => " . var_export($linesToIgnore, \true) . ",\n\t'unmatchedLineIgnores' => " . var_export($unmatchedLineIgnores, \true) . ",\n\t'collectedDataCallback' => static function (): array { return " . var_export($collectedData, \true) . "; },\n\t'dependencies' => " . var_export($invertedDependencies, \true) . ",\n\t'exportedNodesCallback' => static function (): array { return " . var_export($exportedNodes, \true) . '; }, ]; '); } /** * @param mixed[]|null $projectConfig * @param array<string, mixed> $dependencies * @return array<string, array{string, bool, string}> */ private function getProjectExtensionFiles(?array $projectConfig, array $dependencies) : array { $this->alreadyProcessed = []; $projectExtensionFiles = []; if ($projectConfig !== null) { $vendorDirs = []; foreach ($this->composerAutoloaderProjectPaths as $autoloaderProjectPath) { $composer = ComposerHelper::getComposerConfig($autoloaderProjectPath); if ($composer === null) { continue; } $vendorDirectory = ComposerHelper::getVendorDirFromComposerConfig($autoloaderProjectPath, $composer); $vendorDirs[] = $this->fileHelper->normalizePath($vendorDirectory); } $classes = ProjectConfigHelper::getServiceClassNames($projectConfig); foreach ($classes as $class) { if (!$this->reflectionProvider->hasClass($class)) { continue; } $classReflection = $this->reflectionProvider->getClass($class); $fileName = $classReflection->getFileName(); if ($fileName === null) { continue; } if (str_starts_with($fileName, 'phar://')) { continue; } $allServiceFiles = $this->getAllDependencies($fileName, $dependencies); if (count($allServiceFiles) === 0) { $normalizedFileName = $this->fileHelper->normalizePath($fileName); foreach ($vendorDirs as $vendorDir) { if (str_starts_with($normalizedFileName, $vendorDir)) { continue 2; } } $projectExtensionFiles[$fileName] = [$this->getFileHash($fileName), \false, $class]; continue; } foreach ($allServiceFiles as $serviceFile) { if (array_key_exists($serviceFile, $projectExtensionFiles)) { continue; } $projectExtensionFiles[$serviceFile] = [$this->getFileHash($serviceFile), \true, $class]; } } } return $projectExtensionFiles; } /** * @param array<string, array<int, string>> $dependencies * @return array<int, string> */ private function getAllDependencies(string $fileName, array $dependencies) : array { if (!array_key_exists($fileName, $dependencies)) { return []; } if (array_key_exists($fileName, $this->alreadyProcessed)) { return []; } $this->alreadyProcessed[$fileName] = \true; $files = [$fileName]; if ($this->checkDependenciesOfProjectExtensionFiles) { foreach ($dependencies[$fileName] as $fileDep) { foreach ($this->getAllDependencies($fileDep, $dependencies) as $fileDep2) { $files[] = $fileDep2; } } } return $files; } /** * @param string[] $allAnalysedFiles * @param mixed[]|null $projectConfigArray * @return mixed[] */ private function getMeta(array $allAnalysedFiles, ?array $projectConfigArray) : array { $extensions = array_values(array_filter(get_loaded_extensions(), static function (string $extension) : bool { return $extension !== 'xdebug'; })); sort($extensions); if ($projectConfigArray !== null) { unset($projectConfigArray['parameters']['editorUrl']); unset($projectConfigArray['parameters']['editorUrlTitle']); unset($projectConfigArray['parameters']['errorFormat']); unset($projectConfigArray['parameters']['ignoreErrors']); unset($projectConfigArray['parameters']['reportUnmatchedIgnoredErrors']); unset($projectConfigArray['parameters']['tipsOfTheDay']); unset($projectConfigArray['parameters']['parallel']); unset($projectConfigArray['parameters']['internalErrorsCountLimit']); unset($projectConfigArray['parameters']['cache']); unset($projectConfigArray['parameters']['memoryLimitFile']); unset($projectConfigArray['parameters']['pro']); unset($projectConfigArray['parametersSchema']); ksort($projectConfigArray); } return ['cacheVersion' => self::CACHE_VERSION, 'phpstanVersion' => ComposerHelper::getPhpStanVersion(), 'phpVersion' => PHP_VERSION_ID, 'projectConfig' => $projectConfigArray, 'analysedPaths' => $this->analysedPaths, 'scannedFiles' => $this->getScannedFiles($allAnalysedFiles), 'composerLocks' => $this->getComposerLocks(), 'composerInstalled' => $this->getComposerInstalled(), 'executedFilesHashes' => $this->getExecutedFileHashes(), 'phpExtensions' => $extensions, 'stubFiles' => $this->getStubFiles(), 'level' => $this->usedLevel]; } private function getFileHash(string $path) : string { if (array_key_exists($path, $this->fileHashes)) { return $this->fileHashes[$path]; } $hash = sha1_file($path); if ($hash === \false) { throw new CouldNotReadFileException($path); } $this->fileHashes[$path] = $hash; return $hash; } /** * @param string[] $allAnalysedFiles * @return array<string, string> */ private function getScannedFiles(array $allAnalysedFiles) : array { $scannedFiles = $this->scanFiles; foreach ($this->scanFileFinder->findFiles($this->scanDirectories)->getFiles() as $file) { $scannedFiles[] = $file; } $scannedFiles = array_unique($scannedFiles); $hashes = []; foreach (array_diff($scannedFiles, $allAnalysedFiles) as $file) { $hashes[$file] = $this->getFileHash($file); } ksort($hashes); return $hashes; } /** * @return array<string, string> */ private function getExecutedFileHashes() : array { $hashes = []; if ($this->cliAutoloadFile !== null) { $hashes[$this->cliAutoloadFile] = $this->getFileHash($this->cliAutoloadFile); } foreach ($this->bootstrapFiles as $bootstrapFile) { $hashes[$bootstrapFile] = $this->getFileHash($bootstrapFile); } ksort($hashes); return $hashes; } /** * @return array<string, string> */ private function getComposerLocks() : array { $locks = []; foreach ($this->composerAutoloaderProjectPaths as $autoloadPath) { $lockPath = $autoloadPath . '/composer.lock'; if (!is_file($lockPath)) { continue; } $locks[$lockPath] = $this->getFileHash($lockPath); } return $locks; } /** * @return array<string, string> */ private function getComposerInstalled() : array { $data = []; foreach ($this->composerAutoloaderProjectPaths as $autoloadPath) { $composer = ComposerHelper::getComposerConfig($autoloadPath); if ($composer === null) { continue; } $filePath = ComposerHelper::getVendorDirFromComposerConfig($autoloadPath, $composer) . '/composer/installed.php'; if (!is_file($filePath)) { continue; } $installed = (require $filePath); $rootName = $installed['root']['name']; unset($installed['root']); unset($installed['versions'][$rootName]); $data[$filePath] = $installed; } return $data; } /** * @return array<string, string> */ private function getStubFiles() : array { $stubFiles = []; foreach ($this->stubFilesProvider->getProjectStubFiles() as $stubFile) { $stubFiles[$stubFile] = $this->getFileHash($stubFile); } ksort($stubFiles); return $stubFiles; } } <?php declare (strict_types=1); namespace PHPStan\Analyser\ResultCache; interface ResultCacheManagerFactory { public function create() : \PHPStan\Analyser\ResultCache\ResultCacheManager; } <?php declare (strict_types=1); namespace PHPStan\Analyser\ResultCache; use PHPStan\Analyser\Error; use PHPStan\Analyser\FileAnalyserResult; use PHPStan\Collectors\CollectedData; use PHPStan\Dependency\RootExportedNode; /** * @phpstan-import-type LinesToIgnore from FileAnalyserResult */ final class ResultCache { /** * @var string[] */ private $filesToAnalyse; /** * @var bool */ private $fullAnalysis; /** * @var int */ private $lastFullAnalysisTime; /** * @var mixed[] */ private $meta; /** * @var array<string, list<Error>> */ private $errors; /** * @var array<string, list<Error>> */ private $locallyIgnoredErrors; /** * @var array<string, LinesToIgnore> */ private $linesToIgnore; /** * @var array<string, LinesToIgnore> */ private $unmatchedLineIgnores; /** * @var array<string, array<CollectedData>> */ private $collectedData; /** * @var array<string, array<string>> */ private $dependencies; /** * @var array<string, array<RootExportedNode>> */ private $exportedNodes; /** * @var array<string, array{string, bool, string}> */ private $projectExtensionFiles; /** * @param string[] $filesToAnalyse * @param mixed[] $meta * @param array<string, list<Error>> $errors * @param array<string, list<Error>> $locallyIgnoredErrors * @param array<string, LinesToIgnore> $linesToIgnore * @param array<string, LinesToIgnore> $unmatchedLineIgnores * @param array<string, array<CollectedData>> $collectedData * @param array<string, array<string>> $dependencies * @param array<string, array<RootExportedNode>> $exportedNodes * @param array<string, array{string, bool, string}> $projectExtensionFiles */ public function __construct(array $filesToAnalyse, bool $fullAnalysis, int $lastFullAnalysisTime, array $meta, array $errors, array $locallyIgnoredErrors, array $linesToIgnore, array $unmatchedLineIgnores, array $collectedData, array $dependencies, array $exportedNodes, array $projectExtensionFiles) { $this->filesToAnalyse = $filesToAnalyse; $this->fullAnalysis = $fullAnalysis; $this->lastFullAnalysisTime = $lastFullAnalysisTime; $this->meta = $meta; $this->errors = $errors; $this->locallyIgnoredErrors = $locallyIgnoredErrors; $this->linesToIgnore = $linesToIgnore; $this->unmatchedLineIgnores = $unmatchedLineIgnores; $this->collectedData = $collectedData; $this->dependencies = $dependencies; $this->exportedNodes = $exportedNodes; $this->projectExtensionFiles = $projectExtensionFiles; } /** * @return string[] */ public function getFilesToAnalyse() : array { return $this->filesToAnalyse; } public function isFullAnalysis() : bool { return $this->fullAnalysis; } public function getLastFullAnalysisTime() : int { return $this->lastFullAnalysisTime; } /** * @return mixed[] */ public function getMeta() : array { return $this->meta; } /** * @return array<string, list<Error>> */ public function getErrors() : array { return $this->errors; } /** * @return array<string, list<Error>> */ public function getLocallyIgnoredErrors() : array { return $this->locallyIgnoredErrors; } /** * @return array<string, LinesToIgnore> */ public function getLinesToIgnore() : array { return $this->linesToIgnore; } /** * @return array<string, LinesToIgnore> */ public function getUnmatchedLineIgnores() : array { return $this->unmatchedLineIgnores; } /** * @return array<string, array<CollectedData>> */ public function getCollectedData() : array { return $this->collectedData; } /** * @return array<string, array<string>> */ public function getDependencies() : array { return $this->dependencies; } /** * @return array<string, array<RootExportedNode>> */ public function getExportedNodes() : array { return $this->exportedNodes; } /** * @return array<string, array{string, bool, string}> */ public function getProjectExtensionFiles() : array { return $this->projectExtensionFiles; } } <?php declare (strict_types=1); namespace PHPStan\Analyser; use ArrayAccess; use Closure; use Generator; use PhpParser\Node; use PhpParser\Node\Arg; use PhpParser\Node\Expr; use PhpParser\Node\Expr\Array_; use PhpParser\Node\Expr\BinaryOp; use PhpParser\Node\Expr\Cast\Bool_; use PhpParser\Node\Expr\Cast\Double; use PhpParser\Node\Expr\Cast\Int_; use PhpParser\Node\Expr\Cast\Object_; use PhpParser\Node\Expr\Cast\Unset_; use PhpParser\Node\Expr\ConstFetch; use PhpParser\Node\Expr\FuncCall; use PhpParser\Node\Expr\MethodCall; use PhpParser\Node\Expr\New_; use PhpParser\Node\Expr\PropertyFetch; use PhpParser\Node\Expr\Variable; use PhpParser\Node\Name; use PhpParser\Node\Name\FullyQualified; use PhpParser\Node\Scalar\DNumber; use PhpParser\Node\Scalar\EncapsedStringPart; use PhpParser\Node\Scalar\LNumber; use PhpParser\Node\Scalar\String_; use PhpParser\NodeFinder; use PHPStan\Node\ExecutionEndNode; use PHPStan\Node\Expr\AlwaysRememberedExpr; use PHPStan\Node\Expr\ExistingArrayDimFetch; use PHPStan\Node\Expr\GetIterableKeyTypeExpr; use PHPStan\Node\Expr\GetIterableValueTypeExpr; use PHPStan\Node\Expr\GetOffsetValueTypeExpr; use PHPStan\Node\Expr\OriginalPropertyTypeExpr; use PHPStan\Node\Expr\ParameterVariableOriginalValueExpr; use PHPStan\Node\Expr\PropertyInitializationExpr; use PHPStan\Node\Expr\SetExistingOffsetValueTypeExpr; use PHPStan\Node\Expr\SetOffsetValueTypeExpr; use PHPStan\Node\Expr\TypeExpr; use PHPStan\Node\Expr\UnsetOffsetExpr; use PHPStan\Node\InvalidateExprNode; use PHPStan\Node\IssetExpr; use PHPStan\Node\Printer\ExprPrinter; use PHPStan\Node\PropertyAssignNode; use PHPStan\Parser\ArrayMapArgVisitor; use PHPStan\Parser\NewAssignedToPropertyVisitor; use PHPStan\Parser\Parser; use PHPStan\Php\PhpVersion; use PHPStan\PhpDoc\Tag\TemplateTag; use PHPStan\Reflection\Assertions; use PHPStan\Reflection\Callables\CallableParametersAcceptor; use PHPStan\Reflection\Callables\SimpleImpurePoint; use PHPStan\Reflection\Callables\SimpleThrowPoint; use PHPStan\Reflection\ClassMemberReflection; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ConstantReflection; use PHPStan\Reflection\Dummy\DummyConstructorReflection; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\ExtendedPropertyReflection; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\InitializerExprContext; use PHPStan\Reflection\InitializerExprTypeResolver; use PHPStan\Reflection\MethodReflection; use PHPStan\Reflection\Native\NativeParameterReflection; use PHPStan\Reflection\ParameterReflection; use PHPStan\Reflection\ParametersAcceptor; use PHPStan\Reflection\ParametersAcceptorSelector; use PHPStan\Reflection\ParametersAcceptorWithPhpDocs; use PHPStan\Reflection\PassedByReference; use PHPStan\Reflection\Php\DummyParameter; use PHPStan\Reflection\Php\PhpFunctionFromParserNodeReflection; use PHPStan\Reflection\Php\PhpMethodFromParserNodeReflection; use PHPStan\Reflection\PropertyReflection; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Reflection\TrivialParametersAcceptor; use PHPStan\Rules\Properties\PropertyReflectionFinder; use PHPStan\ShouldNotHappenException; use PHPStan\TrinaryLogic; use PHPStan\Type\Accessory\AccessoryArrayListType; use PHPStan\Type\Accessory\AccessoryLiteralStringType; use PHPStan\Type\Accessory\HasOffsetValueType; use PHPStan\Type\Accessory\NonEmptyArrayType; use PHPStan\Type\Accessory\OversizedArrayType; use PHPStan\Type\ArrayType; use PHPStan\Type\BenevolentUnionType; use PHPStan\Type\BooleanType; use PHPStan\Type\ClosureType; use PHPStan\Type\ConditionalTypeForParameter; use PHPStan\Type\Constant\ConstantArrayTypeBuilder; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantFloatType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\ConstantTypeHelper; use PHPStan\Type\DynamicReturnTypeExtensionRegistry; use PHPStan\Type\ErrorType; use PHPStan\Type\ExpressionTypeResolverExtensionRegistry; use PHPStan\Type\FloatType; use PHPStan\Type\GeneralizePrecision; use PHPStan\Type\Generic\GenericClassStringType; use PHPStan\Type\Generic\GenericObjectType; use PHPStan\Type\Generic\GenericStaticType; use PHPStan\Type\Generic\TemplateType; use PHPStan\Type\Generic\TemplateTypeHelper; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\Generic\TemplateTypeVarianceMap; use PHPStan\Type\IntegerRangeType; use PHPStan\Type\IntegerType; use PHPStan\Type\IntersectionType; use PHPStan\Type\MixedType; use PHPStan\Type\NeverType; use PHPStan\Type\NonAcceptingNeverType; use PHPStan\Type\NonexistentParentClassType; use PHPStan\Type\NullType; use PHPStan\Type\ObjectShapeType; use PHPStan\Type\ObjectType; use PHPStan\Type\ParserNodeTypeToPHPStanType; use PHPStan\Type\StaticType; use PHPStan\Type\StringType; use PHPStan\Type\ThisType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\TypeTraverser; use PHPStan\Type\TypeUtils; use PHPStan\Type\TypeWithClassName; use PHPStan\Type\UnionType; use PHPStan\Type\VerbosityLevel; use PHPStan\Type\VoidType; use stdClass; use Throwable; use function abs; use function array_filter; use function array_key_exists; use function array_key_first; use function array_keys; use function array_map; use function array_merge; use function array_pop; use function array_slice; use function array_values; use function count; use function explode; use function get_class; use function implode; use function in_array; use function is_bool; use function is_numeric; use function is_string; use function ltrim; use function md5; use function sprintf; use function str_starts_with; use function strlen; use function strtolower; use function substr; use function usort; use const PHP_INT_MAX; use const PHP_INT_MIN; final class MutatingScope implements \PHPStan\Analyser\Scope { /** * @var InternalScopeFactory */ private $scopeFactory; /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var InitializerExprTypeResolver */ private $initializerExprTypeResolver; /** * @var DynamicReturnTypeExtensionRegistry */ private $dynamicReturnTypeExtensionRegistry; /** * @var ExpressionTypeResolverExtensionRegistry */ private $expressionTypeResolverExtensionRegistry; /** * @var ExprPrinter */ private $exprPrinter; /** * @var TypeSpecifier */ private $typeSpecifier; /** * @var PropertyReflectionFinder */ private $propertyReflectionFinder; /** * @var Parser */ private $parser; /** * @var NodeScopeResolver */ private $nodeScopeResolver; /** * @var RicherScopeGetTypeHelper */ private $richerScopeGetTypeHelper; /** * @var ConstantResolver */ private $constantResolver; /** * @var ScopeContext */ private $context; /** * @var PhpVersion */ private $phpVersion; /** * @var bool */ private $declareStrictTypes; /** * @var PhpFunctionFromParserNodeReflection|null */ private $function; /** * @var array<string, ExpressionTypeHolder> */ private $expressionTypes; /** * @var array<string, ExpressionTypeHolder> */ private $nativeExpressionTypes; /** * @var array<string, ConditionalExpressionHolder[]> */ private $conditionalExpressions; /** * @var list<string> */ private $inClosureBindScopeClasses; /** * @var ?ParametersAcceptor */ private $anonymousFunctionReflection; /** * @var bool */ private $inFirstLevelStatement; /** * @var array<string, true> */ private $currentlyAssignedExpressions; /** * @var array<string, true> */ private $currentlyAllowedUndefinedExpressions; /** * @var list<array{MethodReflection|FunctionReflection|null, ParameterReflection|null}> */ private $inFunctionCallsStack; /** * @var bool */ private $afterExtractCall; /** * @var ?Scope */ private $parentScope; /** * @var bool */ private $nativeTypesPromoted; /** * @var bool */ private $explicitMixedInUnknownGenericNew; /** * @var bool */ private $explicitMixedForGlobalVariables; private const BOOLEAN_EXPRESSION_MAX_PROCESS_DEPTH = 4; private const KEEP_VOID_ATTRIBUTE_NAME = 'keepVoid'; /** @var Type[] */ private $resolvedTypes = []; /** @var array<string, self> */ private $truthyScopes = []; /** @var array<string, self> */ private $falseyScopes = []; /** @var non-empty-string|null */ private $namespace; /** * @var ?self */ private $scopeOutOfFirstLevelStatement = null; /** * @var ?self */ private $scopeWithPromotedNativeTypes = null; /** * @var int */ private static $resolveClosureTypeDepth = 0; /** * @param array<string, ExpressionTypeHolder> $expressionTypes * @param array<string, ConditionalExpressionHolder[]> $conditionalExpressions * @param list<string> $inClosureBindScopeClasses * @param array<string, true> $currentlyAssignedExpressions * @param array<string, true> $currentlyAllowedUndefinedExpressions * @param array<string, ExpressionTypeHolder> $nativeExpressionTypes * @param list<array{MethodReflection|FunctionReflection|null, ParameterReflection|null}> $inFunctionCallsStack * @param PhpFunctionFromParserNodeReflection|null $function */ public function __construct(\PHPStan\Analyser\InternalScopeFactory $scopeFactory, ReflectionProvider $reflectionProvider, InitializerExprTypeResolver $initializerExprTypeResolver, DynamicReturnTypeExtensionRegistry $dynamicReturnTypeExtensionRegistry, ExpressionTypeResolverExtensionRegistry $expressionTypeResolverExtensionRegistry, ExprPrinter $exprPrinter, \PHPStan\Analyser\TypeSpecifier $typeSpecifier, PropertyReflectionFinder $propertyReflectionFinder, Parser $parser, \PHPStan\Analyser\NodeScopeResolver $nodeScopeResolver, \PHPStan\Analyser\RicherScopeGetTypeHelper $richerScopeGetTypeHelper, \PHPStan\Analyser\ConstantResolver $constantResolver, \PHPStan\Analyser\ScopeContext $context, PhpVersion $phpVersion, bool $declareStrictTypes = \false, $function = null, ?string $namespace = null, array $expressionTypes = [], array $nativeExpressionTypes = [], array $conditionalExpressions = [], array $inClosureBindScopeClasses = [], ?ParametersAcceptor $anonymousFunctionReflection = null, bool $inFirstLevelStatement = \true, array $currentlyAssignedExpressions = [], array $currentlyAllowedUndefinedExpressions = [], array $inFunctionCallsStack = [], bool $afterExtractCall = \false, ?\PHPStan\Analyser\Scope $parentScope = null, bool $nativeTypesPromoted = \false, bool $explicitMixedInUnknownGenericNew = \false, bool $explicitMixedForGlobalVariables = \false) { $this->scopeFactory = $scopeFactory; $this->reflectionProvider = $reflectionProvider; $this->initializerExprTypeResolver = $initializerExprTypeResolver; $this->dynamicReturnTypeExtensionRegistry = $dynamicReturnTypeExtensionRegistry; $this->expressionTypeResolverExtensionRegistry = $expressionTypeResolverExtensionRegistry; $this->exprPrinter = $exprPrinter; $this->typeSpecifier = $typeSpecifier; $this->propertyReflectionFinder = $propertyReflectionFinder; $this->parser = $parser; $this->nodeScopeResolver = $nodeScopeResolver; $this->richerScopeGetTypeHelper = $richerScopeGetTypeHelper; $this->constantResolver = $constantResolver; $this->context = $context; $this->phpVersion = $phpVersion; $this->declareStrictTypes = $declareStrictTypes; $this->function = $function; $this->expressionTypes = $expressionTypes; $this->nativeExpressionTypes = $nativeExpressionTypes; $this->conditionalExpressions = $conditionalExpressions; $this->inClosureBindScopeClasses = $inClosureBindScopeClasses; $this->anonymousFunctionReflection = $anonymousFunctionReflection; $this->inFirstLevelStatement = $inFirstLevelStatement; $this->currentlyAssignedExpressions = $currentlyAssignedExpressions; $this->currentlyAllowedUndefinedExpressions = $currentlyAllowedUndefinedExpressions; $this->inFunctionCallsStack = $inFunctionCallsStack; $this->afterExtractCall = $afterExtractCall; $this->parentScope = $parentScope; $this->nativeTypesPromoted = $nativeTypesPromoted; $this->explicitMixedInUnknownGenericNew = $explicitMixedInUnknownGenericNew; $this->explicitMixedForGlobalVariables = $explicitMixedForGlobalVariables; if ($namespace === '') { $namespace = null; } $this->namespace = $namespace; } /** @api */ public function getFile() : string { return $this->context->getFile(); } /** @api */ public function getFileDescription() : string { if ($this->context->getTraitReflection() === null) { return $this->getFile(); } /** @var ClassReflection $classReflection */ $classReflection = $this->context->getClassReflection(); $className = $classReflection->getDisplayName(); if (!$classReflection->isAnonymous()) { $className = sprintf('class %s', $className); } $traitReflection = $this->context->getTraitReflection(); if ($traitReflection->getFileName() === null) { throw new ShouldNotHappenException(); } return sprintf('%s (in context of %s)', $traitReflection->getFileName(), $className); } /** @api */ public function isDeclareStrictTypes() : bool { return $this->declareStrictTypes; } public function enterDeclareStrictTypes() : self { return $this->scopeFactory->create($this->context, \true, null, null, $this->expressionTypes, $this->nativeExpressionTypes); } /** @api */ public function isInClass() : bool { return $this->context->getClassReflection() !== null; } /** @api */ public function isInTrait() : bool { return $this->context->getTraitReflection() !== null; } /** @api */ public function getClassReflection() : ?ClassReflection { return $this->context->getClassReflection(); } /** @api */ public function getTraitReflection() : ?ClassReflection { return $this->context->getTraitReflection(); } /** * @api */ public function getFunction() : ?PhpFunctionFromParserNodeReflection { return $this->function; } /** @api */ public function getFunctionName() : ?string { return $this->function !== null ? $this->function->getName() : null; } /** @api */ public function getNamespace() : ?string { return $this->namespace; } /** @api */ public function getParentScope() : ?\PHPStan\Analyser\Scope { return $this->parentScope; } /** @api */ public function canAnyVariableExist() : bool { return $this->function === null && !$this->isInAnonymousFunction() || $this->afterExtractCall; } public function afterExtractCall() : self { return $this->scopeFactory->create($this->context, $this->isDeclareStrictTypes(), $this->getFunction(), $this->getNamespace(), $this->expressionTypes, $this->nativeExpressionTypes, [], $this->inClosureBindScopeClasses, $this->anonymousFunctionReflection, $this->isInFirstLevelStatement(), $this->currentlyAssignedExpressions, $this->currentlyAllowedUndefinedExpressions, $this->inFunctionCallsStack, \true, $this->parentScope, $this->nativeTypesPromoted); } public function afterClearstatcacheCall() : self { $expressionTypes = $this->expressionTypes; foreach (array_keys($expressionTypes) as $exprString) { // list from https://www.php.net/manual/en/function.clearstatcache.php // stat(), lstat(), file_exists(), is_writable(), is_readable(), is_executable(), is_file(), is_dir(), is_link(), filectime(), fileatime(), filemtime(), fileinode(), filegroup(), fileowner(), filesize(), filetype(), and fileperms(). foreach (['stat', 'lstat', 'file_exists', 'is_writable', 'is_writeable', 'is_readable', 'is_executable', 'is_file', 'is_dir', 'is_link', 'filectime', 'fileatime', 'filemtime', 'fileinode', 'filegroup', 'fileowner', 'filesize', 'filetype', 'fileperms'] as $functionName) { if (!str_starts_with($exprString, $functionName . '(') && !str_starts_with($exprString, '\\' . $functionName . '(')) { continue; } unset($expressionTypes[$exprString]); continue 2; } } return $this->scopeFactory->create($this->context, $this->isDeclareStrictTypes(), $this->getFunction(), $this->getNamespace(), $expressionTypes, $this->nativeExpressionTypes, $this->conditionalExpressions, $this->inClosureBindScopeClasses, $this->anonymousFunctionReflection, $this->isInFirstLevelStatement(), $this->currentlyAssignedExpressions, $this->currentlyAllowedUndefinedExpressions, $this->inFunctionCallsStack, $this->afterExtractCall, $this->parentScope, $this->nativeTypesPromoted); } public function afterOpenSslCall(string $openSslFunctionName) : self { $expressionTypes = $this->expressionTypes; if (in_array($openSslFunctionName, ['openssl_cipher_iv_length', 'openssl_cms_decrypt', 'openssl_cms_encrypt', 'openssl_cms_read', 'openssl_cms_sign', 'openssl_cms_verify', 'openssl_csr_export_to_file', 'openssl_csr_export', 'openssl_csr_get_public_key', 'openssl_csr_get_subject', 'openssl_csr_new', 'openssl_csr_sign', 'openssl_decrypt', 'openssl_dh_compute_key', 'openssl_digest', 'openssl_encrypt', 'openssl_get_curve_names', 'openssl_get_privatekey', 'openssl_get_publickey', 'openssl_open', 'openssl_pbkdf2', 'openssl_pkcs12_export_to_file', 'openssl_pkcs12_export', 'openssl_pkcs12_read', 'openssl_pkcs7_decrypt', 'openssl_pkcs7_encrypt', 'openssl_pkcs7_read', 'openssl_pkcs7_sign', 'openssl_pkcs7_verify', 'openssl_pkey_derive', 'openssl_pkey_export_to_file', 'openssl_pkey_export', 'openssl_pkey_get_private', 'openssl_pkey_get_public', 'openssl_pkey_new', 'openssl_private_decrypt', 'openssl_private_encrypt', 'openssl_public_decrypt', 'openssl_public_encrypt', 'openssl_random_pseudo_bytes', 'openssl_seal', 'openssl_sign', 'openssl_spki_export_challenge', 'openssl_spki_export', 'openssl_spki_new', 'openssl_spki_verify', 'openssl_verify', 'openssl_x509_checkpurpose', 'openssl_x509_export_to_file', 'openssl_x509_export', 'openssl_x509_fingerprint', 'openssl_x509_read', 'openssl_x509_verify'], \true)) { unset($expressionTypes['\\openssl_error_string()']); } return $this->scopeFactory->create($this->context, $this->isDeclareStrictTypes(), $this->getFunction(), $this->getNamespace(), $expressionTypes, $this->nativeExpressionTypes, $this->conditionalExpressions, $this->inClosureBindScopeClasses, $this->anonymousFunctionReflection, $this->isInFirstLevelStatement(), $this->currentlyAssignedExpressions, $this->currentlyAllowedUndefinedExpressions, $this->inFunctionCallsStack, $this->afterExtractCall, $this->parentScope, $this->nativeTypesPromoted); } /** @api */ public function hasVariableType(string $variableName) : TrinaryLogic { if ($this->isGlobalVariable($variableName)) { return TrinaryLogic::createYes(); } $varExprString = '$' . $variableName; if (!isset($this->expressionTypes[$varExprString])) { if ($this->canAnyVariableExist()) { return TrinaryLogic::createMaybe(); } return TrinaryLogic::createNo(); } return $this->expressionTypes[$varExprString]->getCertainty(); } /** @api */ public function getVariableType(string $variableName) : Type { if ($this->hasVariableType($variableName)->maybe()) { if ($variableName === 'argc') { return IntegerRangeType::fromInterval(1, null); } if ($variableName === 'argv') { return AccessoryArrayListType::intersectWith(TypeCombinator::intersect(new ArrayType(new IntegerType(), new StringType()), new NonEmptyArrayType())); } if ($this->canAnyVariableExist()) { return new MixedType(); } } if ($this->isGlobalVariable($variableName)) { return new ArrayType(new BenevolentUnionType([new IntegerType(), new StringType()]), new MixedType($this->explicitMixedForGlobalVariables)); } if ($this->hasVariableType($variableName)->no()) { throw new \PHPStan\Analyser\UndefinedVariableException($this, $variableName); } $varExprString = '$' . $variableName; if (!array_key_exists($varExprString, $this->expressionTypes)) { return new MixedType(); } return TypeUtils::resolveLateResolvableTypes($this->expressionTypes[$varExprString]->getType()); } /** * @api * @return array<int, string> */ public function getDefinedVariables() : array { $variables = []; foreach ($this->expressionTypes as $exprString => $holder) { if (!$holder->getExpr() instanceof Variable) { continue; } if (!$holder->getCertainty()->yes()) { continue; } $variables[] = substr($exprString, 1); } return $variables; } /** * @api * @return array<int, string> */ public function getMaybeDefinedVariables() : array { $variables = []; foreach ($this->expressionTypes as $exprString => $holder) { if (!$holder->getExpr() instanceof Variable) { continue; } if (!$holder->getCertainty()->maybe()) { continue; } $variables[] = substr($exprString, 1); } return $variables; } private function isGlobalVariable(string $variableName) : bool { return in_array($variableName, self::SUPERGLOBAL_VARIABLES, \true); } /** @api */ public function hasConstant(Name $name) : bool { $isCompilerHaltOffset = $name->toString() === '__COMPILER_HALT_OFFSET__'; if ($isCompilerHaltOffset) { return $this->fileHasCompilerHaltStatementCalls(); } if (!$name->isFullyQualified() && $this->getNamespace() !== null) { if ($this->hasExpressionType(new ConstFetch(new FullyQualified([$this->getNamespace(), $name->toString()])))->yes()) { return \true; } } if ($this->hasExpressionType(new ConstFetch(new FullyQualified($name->toString())))->yes()) { return \true; } return $this->reflectionProvider->hasConstant($name, $this); } private function fileHasCompilerHaltStatementCalls() : bool { $nodes = $this->parser->parseFile($this->getFile()); foreach ($nodes as $node) { if ($node instanceof Node\Stmt\HaltCompiler) { return \true; } } return \false; } /** @api */ public function isInAnonymousFunction() : bool { return $this->anonymousFunctionReflection !== null; } /** @api */ public function getAnonymousFunctionReflection() : ?ParametersAcceptor { return $this->anonymousFunctionReflection; } /** @api */ public function getAnonymousFunctionReturnType() : ?Type { if ($this->anonymousFunctionReflection === null) { return null; } return $this->anonymousFunctionReflection->getReturnType(); } /** @api */ public function getType(Expr $node) : Type { if ($node instanceof GetIterableKeyTypeExpr) { return $this->getIterableKeyType($this->getType($node->getExpr())); } if ($node instanceof GetIterableValueTypeExpr) { return $this->getIterableValueType($this->getType($node->getExpr())); } if ($node instanceof GetOffsetValueTypeExpr) { return $this->getType($node->getVar())->getOffsetValueType($this->getType($node->getDim())); } if ($node instanceof ExistingArrayDimFetch) { return $this->getType(new Expr\ArrayDimFetch($node->getVar(), $node->getDim())); } if ($node instanceof UnsetOffsetExpr) { return $this->getType($node->getVar())->unsetOffset($this->getType($node->getDim())); } if ($node instanceof SetOffsetValueTypeExpr) { return $this->getType($node->getVar())->setOffsetValueType($node->getDim() !== null ? $this->getType($node->getDim()) : null, $this->getType($node->getValue())); } if ($node instanceof SetExistingOffsetValueTypeExpr) { return $this->getType($node->getVar())->setExistingOffsetValueType($this->getType($node->getDim()), $this->getType($node->getValue())); } if ($node instanceof TypeExpr) { return $node->getExprType(); } if ($node instanceof OriginalPropertyTypeExpr) { $propertyReflection = $this->propertyReflectionFinder->findPropertyReflectionFromNode($node->getPropertyFetch(), $this); if ($propertyReflection === null) { return new ErrorType(); } return $propertyReflection->getReadableType(); } $key = $this->getNodeKey($node); if (!array_key_exists($key, $this->resolvedTypes)) { $this->resolvedTypes[$key] = TypeUtils::resolveLateResolvableTypes($this->resolveType($key, $node)); } return $this->resolvedTypes[$key]; } private function getNodeKey(Expr $node) : string { $key = $this->exprPrinter->printExpr($node); $attributes = $node->getAttributes(); if ($node instanceof Node\FunctionLike && ($attributes[ArrayMapArgVisitor::ATTRIBUTE_NAME] ?? null) !== null && ($attributes['startFilePos'] ?? null) !== null) { $key .= '/*' . $attributes['startFilePos'] . '*/'; } if (($attributes[self::KEEP_VOID_ATTRIBUTE_NAME] ?? null) === \true) { $key .= '/*' . self::KEEP_VOID_ATTRIBUTE_NAME . '*/'; } return $key; } private function getClosureScopeCacheKey() : string { $parts = []; foreach ($this->expressionTypes as $exprString => $expressionTypeHolder) { $parts[] = sprintf('%s::%s', $exprString, $expressionTypeHolder->getType()->describe(VerbosityLevel::cache())); } $parts[] = '---'; foreach ($this->nativeExpressionTypes as $exprString => $expressionTypeHolder) { $parts[] = sprintf('%s::%s', $exprString, $expressionTypeHolder->getType()->describe(VerbosityLevel::cache())); } $parts[] = sprintf(':%d', count($this->inFunctionCallsStack)); foreach ($this->inFunctionCallsStack as [$method, $parameter]) { if ($parameter === null) { $parts[] = ',null'; continue; } $parts[] = sprintf(',%s', $parameter->getType()->describe(VerbosityLevel::cache())); } return md5(implode("\n", $parts)); } private function resolveType(string $exprString, Expr $node) : Type { foreach ($this->expressionTypeResolverExtensionRegistry->getExtensions() as $extension) { $type = $extension->getType($node, $this); if ($type !== null) { return $type; } } if ($node instanceof Expr\Exit_ || $node instanceof Expr\Throw_) { return new NonAcceptingNeverType(); } if (!$node instanceof Variable && $this->hasExpressionType($node)->yes()) { return $this->expressionTypes[$exprString]->getType(); } if ($node instanceof AlwaysRememberedExpr) { return $node->getExprType(); } if ($node instanceof Expr\BinaryOp\Smaller) { return $this->getType($node->left)->isSmallerThan($this->getType($node->right))->toBooleanType(); } if ($node instanceof Expr\BinaryOp\SmallerOrEqual) { return $this->getType($node->left)->isSmallerThanOrEqual($this->getType($node->right))->toBooleanType(); } if ($node instanceof Expr\BinaryOp\Greater) { return $this->getType($node->right)->isSmallerThan($this->getType($node->left))->toBooleanType(); } if ($node instanceof Expr\BinaryOp\GreaterOrEqual) { return $this->getType($node->right)->isSmallerThanOrEqual($this->getType($node->left))->toBooleanType(); } if ($node instanceof Expr\BinaryOp\Equal) { if ($node->left instanceof Variable && is_string($node->left->name) && $node->right instanceof Variable && is_string($node->right->name) && $node->left->name === $node->right->name) { return new ConstantBooleanType(\true); } $leftType = $this->getType($node->left); $rightType = $this->getType($node->right); return $this->initializerExprTypeResolver->resolveEqualType($leftType, $rightType)->type; } if ($node instanceof Expr\BinaryOp\NotEqual) { return $this->getType(new Expr\BooleanNot(new BinaryOp\Equal($node->left, $node->right))); } if ($node instanceof Expr\Empty_) { $result = $this->issetCheck($node->expr, static function (Type $type) : ?bool { $isNull = $type->isNull(); $isFalsey = $type->toBoolean()->isFalse(); if ($isNull->maybe()) { return null; } if ($isFalsey->maybe()) { return null; } if ($isNull->yes()) { return $isFalsey->no(); } return !$isFalsey->yes(); }); if ($result === null) { return new BooleanType(); } return new ConstantBooleanType(!$result); } if ($node instanceof Node\Expr\BooleanNot) { $exprBooleanType = $this->getType($node->expr)->toBoolean(); if ($exprBooleanType instanceof ConstantBooleanType) { return new ConstantBooleanType(!$exprBooleanType->getValue()); } return new BooleanType(); } if ($node instanceof Node\Expr\BitwiseNot) { return $this->initializerExprTypeResolver->getBitwiseNotType($node->expr, function (Expr $expr) : Type { return $this->getType($expr); }); } if ($node instanceof Node\Expr\BinaryOp\BooleanAnd || $node instanceof Node\Expr\BinaryOp\LogicalAnd) { $leftBooleanType = $this->getType($node->left)->toBoolean(); if ($leftBooleanType->isFalse()->yes()) { return new ConstantBooleanType(\false); } if ($this->getBooleanExpressionDepth($node->left) <= self::BOOLEAN_EXPRESSION_MAX_PROCESS_DEPTH) { $noopCallback = static function () : void { }; $leftResult = $this->nodeScopeResolver->processExprNode(new Node\Stmt\Expression($node->left), $node->left, $this, $noopCallback, \PHPStan\Analyser\ExpressionContext::createDeep()); $rightBooleanType = $leftResult->getTruthyScope()->getType($node->right)->toBoolean(); } else { $rightBooleanType = $this->filterByTruthyValue($node->left)->getType($node->right)->toBoolean(); } if ($rightBooleanType->isFalse()->yes()) { return new ConstantBooleanType(\false); } if ($leftBooleanType->isTrue()->yes() && $rightBooleanType->isTrue()->yes()) { return new ConstantBooleanType(\true); } return new BooleanType(); } if ($node instanceof Node\Expr\BinaryOp\BooleanOr || $node instanceof Node\Expr\BinaryOp\LogicalOr) { $leftBooleanType = $this->getType($node->left)->toBoolean(); if ($leftBooleanType->isTrue()->yes()) { return new ConstantBooleanType(\true); } if ($this->getBooleanExpressionDepth($node->left) <= self::BOOLEAN_EXPRESSION_MAX_PROCESS_DEPTH) { $noopCallback = static function () : void { }; $leftResult = $this->nodeScopeResolver->processExprNode(new Node\Stmt\Expression($node->left), $node->left, $this, $noopCallback, \PHPStan\Analyser\ExpressionContext::createDeep()); $rightBooleanType = $leftResult->getFalseyScope()->getType($node->right)->toBoolean(); } else { $rightBooleanType = $this->filterByFalseyValue($node->left)->getType($node->right)->toBoolean(); } if ($rightBooleanType->isTrue()->yes()) { return new ConstantBooleanType(\true); } if ($leftBooleanType->isFalse()->yes() && $rightBooleanType->isFalse()->yes()) { return new ConstantBooleanType(\false); } return new BooleanType(); } if ($node instanceof Node\Expr\BinaryOp\LogicalXor) { $leftBooleanType = $this->getType($node->left)->toBoolean(); $rightBooleanType = $this->getType($node->right)->toBoolean(); if ($leftBooleanType instanceof ConstantBooleanType && $rightBooleanType instanceof ConstantBooleanType) { return new ConstantBooleanType($leftBooleanType->getValue() xor $rightBooleanType->getValue()); } return new BooleanType(); } if ($node instanceof Expr\BinaryOp\Identical) { return $this->richerScopeGetTypeHelper->getIdenticalResult($this, $node)->type; } if ($node instanceof Expr\BinaryOp\NotIdentical) { return $this->richerScopeGetTypeHelper->getNotIdenticalResult($this, $node)->type; } if ($node instanceof Expr\Instanceof_) { $expressionType = $this->getType($node->expr); if ($this->isInTrait() && TypeUtils::findThisType($expressionType) !== null) { return new BooleanType(); } if ($expressionType instanceof NeverType) { return new ConstantBooleanType(\false); } $uncertainty = \false; if ($node->class instanceof Node\Name) { $unresolvedClassName = $node->class->toString(); if (strtolower($unresolvedClassName) === 'static' && $this->isInClass()) { $classType = new StaticType($this->getClassReflection()); } else { $className = $this->resolveName($node->class); $classType = new ObjectType($className); } } else { $classType = $this->getType($node->class); $classType = TypeTraverser::map($classType, static function (Type $type, callable $traverse) use(&$uncertainty) : Type { if ($type instanceof UnionType || $type instanceof IntersectionType) { return $traverse($type); } if ($type->getObjectClassNames() !== []) { $uncertainty = \true; return $type; } if ($type instanceof GenericClassStringType) { $uncertainty = \true; return $type->getGenericType(); } if ($type instanceof ConstantStringType) { return new ObjectType($type->getValue()); } return new MixedType(); }); } if ($classType->isSuperTypeOf(new MixedType())->yes()) { return new BooleanType(); } $isSuperType = $classType->isSuperTypeOf($expressionType); if ($isSuperType->no()) { return new ConstantBooleanType(\false); } elseif ($isSuperType->yes() && !$uncertainty) { return new ConstantBooleanType(\true); } return new BooleanType(); } if ($node instanceof Node\Expr\UnaryPlus) { return $this->getType($node->expr)->toNumber(); } if ($node instanceof Expr\ErrorSuppress || $node instanceof Expr\Assign) { return $this->getType($node->expr); } if ($node instanceof Node\Expr\UnaryMinus) { return $this->initializerExprTypeResolver->getUnaryMinusType($node->expr, function (Expr $expr) : Type { return $this->getType($expr); }); } if ($node instanceof Expr\BinaryOp\Concat) { return $this->initializerExprTypeResolver->getConcatType($node->left, $node->right, function (Expr $expr) : Type { return $this->getType($expr); }); } if ($node instanceof Expr\AssignOp\Concat) { return $this->initializerExprTypeResolver->getConcatType($node->var, $node->expr, function (Expr $expr) : Type { return $this->getType($expr); }); } if ($node instanceof BinaryOp\BitwiseAnd) { return $this->initializerExprTypeResolver->getBitwiseAndType($node->left, $node->right, function (Expr $expr) : Type { return $this->getType($expr); }); } if ($node instanceof Expr\AssignOp\BitwiseAnd) { return $this->initializerExprTypeResolver->getBitwiseAndType($node->var, $node->expr, function (Expr $expr) : Type { return $this->getType($expr); }); } if ($node instanceof BinaryOp\BitwiseOr) { return $this->initializerExprTypeResolver->getBitwiseOrType($node->left, $node->right, function (Expr $expr) : Type { return $this->getType($expr); }); } if ($node instanceof Expr\AssignOp\BitwiseOr) { return $this->initializerExprTypeResolver->getBitwiseOrType($node->var, $node->expr, function (Expr $expr) : Type { return $this->getType($expr); }); } if ($node instanceof BinaryOp\BitwiseXor) { return $this->initializerExprTypeResolver->getBitwiseXorType($node->left, $node->right, function (Expr $expr) : Type { return $this->getType($expr); }); } if ($node instanceof Expr\AssignOp\BitwiseXor) { return $this->initializerExprTypeResolver->getBitwiseXorType($node->var, $node->expr, function (Expr $expr) : Type { return $this->getType($expr); }); } if ($node instanceof Expr\BinaryOp\Spaceship) { return $this->initializerExprTypeResolver->getSpaceshipType($node->left, $node->right, function (Expr $expr) : Type { return $this->getType($expr); }); } if ($node instanceof BinaryOp\Div) { return $this->initializerExprTypeResolver->getDivType($node->left, $node->right, function (Expr $expr) : Type { return $this->getType($expr); }); } if ($node instanceof Expr\AssignOp\Div) { return $this->initializerExprTypeResolver->getDivType($node->var, $node->expr, function (Expr $expr) : Type { return $this->getType($expr); }); } if ($node instanceof BinaryOp\Mod) { return $this->initializerExprTypeResolver->getModType($node->left, $node->right, function (Expr $expr) : Type { return $this->getType($expr); }); } if ($node instanceof Expr\AssignOp\Mod) { return $this->initializerExprTypeResolver->getModType($node->var, $node->expr, function (Expr $expr) : Type { return $this->getType($expr); }); } if ($node instanceof BinaryOp\Plus) { return $this->initializerExprTypeResolver->getPlusType($node->left, $node->right, function (Expr $expr) : Type { return $this->getType($expr); }); } if ($node instanceof Expr\AssignOp\Plus) { return $this->initializerExprTypeResolver->getPlusType($node->var, $node->expr, function (Expr $expr) : Type { return $this->getType($expr); }); } if ($node instanceof BinaryOp\Minus) { return $this->initializerExprTypeResolver->getMinusType($node->left, $node->right, function (Expr $expr) : Type { return $this->getType($expr); }); } if ($node instanceof Expr\AssignOp\Minus) { return $this->initializerExprTypeResolver->getMinusType($node->var, $node->expr, function (Expr $expr) : Type { return $this->getType($expr); }); } if ($node instanceof BinaryOp\Mul) { return $this->initializerExprTypeResolver->getMulType($node->left, $node->right, function (Expr $expr) : Type { return $this->getType($expr); }); } if ($node instanceof Expr\AssignOp\Mul) { return $this->initializerExprTypeResolver->getMulType($node->var, $node->expr, function (Expr $expr) : Type { return $this->getType($expr); }); } if ($node instanceof BinaryOp\Pow) { return $this->initializerExprTypeResolver->getPowType($node->left, $node->right, function (Expr $expr) : Type { return $this->getType($expr); }); } if ($node instanceof Expr\AssignOp\Pow) { return $this->initializerExprTypeResolver->getPowType($node->var, $node->expr, function (Expr $expr) : Type { return $this->getType($expr); }); } if ($node instanceof BinaryOp\ShiftLeft) { return $this->initializerExprTypeResolver->getShiftLeftType($node->left, $node->right, function (Expr $expr) : Type { return $this->getType($expr); }); } if ($node instanceof Expr\AssignOp\ShiftLeft) { return $this->initializerExprTypeResolver->getShiftLeftType($node->var, $node->expr, function (Expr $expr) : Type { return $this->getType($expr); }); } if ($node instanceof BinaryOp\ShiftRight) { return $this->initializerExprTypeResolver->getShiftRightType($node->left, $node->right, function (Expr $expr) : Type { return $this->getType($expr); }); } if ($node instanceof Expr\AssignOp\ShiftRight) { return $this->initializerExprTypeResolver->getShiftRightType($node->var, $node->expr, function (Expr $expr) : Type { return $this->getType($expr); }); } if ($node instanceof Expr\Clone_) { return $this->getType($node->expr); } if ($node instanceof LNumber) { return $this->initializerExprTypeResolver->getType($node, InitializerExprContext::fromScope($this)); } elseif ($node instanceof String_) { return $this->initializerExprTypeResolver->getType($node, InitializerExprContext::fromScope($this)); } elseif ($node instanceof Node\Scalar\Encapsed) { $resultType = null; foreach ($node->parts as $part) { $partType = $part instanceof EncapsedStringPart ? new ConstantStringType($part->value) : $this->getType($part)->toString(); if ($resultType === null) { $resultType = $partType; continue; } $resultType = $this->initializerExprTypeResolver->resolveConcatType($resultType, $partType); } return $resultType ?? new ConstantStringType(''); } elseif ($node instanceof DNumber) { return $this->initializerExprTypeResolver->getType($node, InitializerExprContext::fromScope($this)); } elseif ($node instanceof Expr\CallLike && $node->isFirstClassCallable()) { if ($node instanceof FuncCall) { if ($node->name instanceof Name) { if ($this->reflectionProvider->hasFunction($node->name, $this)) { $function = $this->reflectionProvider->getFunction($node->name, $this); return $this->createFirstClassCallable($function, $function->getVariants()); } return new ObjectType(Closure::class); } $callableType = $this->getType($node->name); if (!$callableType->isCallable()->yes()) { return new ObjectType(Closure::class); } return $this->createFirstClassCallable(null, $callableType->getCallableParametersAcceptors($this)); } if ($node instanceof MethodCall) { if (!$node->name instanceof Node\Identifier) { return new ObjectType(Closure::class); } $varType = $this->getType($node->var); $method = $this->getMethodReflection($varType, $node->name->toString()); if ($method === null) { return new ObjectType(Closure::class); } return $this->createFirstClassCallable($method, $method->getVariants()); } if ($node instanceof Expr\StaticCall) { if (!$node->class instanceof Name) { return new ObjectType(Closure::class); } if (!$node->name instanceof Node\Identifier) { return new ObjectType(Closure::class); } $classType = $this->resolveTypeByNameWithLateStaticBinding($node->class, $node->name); $methodName = $node->name->toString(); if (!$classType->hasMethod($methodName)->yes()) { return new ObjectType(Closure::class); } $method = $classType->getMethod($methodName, $this); return $this->createFirstClassCallable($method, $method->getVariants()); } if ($node instanceof New_) { return new ErrorType(); } throw new ShouldNotHappenException(); } elseif ($node instanceof Expr\Closure || $node instanceof Expr\ArrowFunction) { $parameters = []; $isVariadic = \false; $firstOptionalParameterIndex = null; foreach ($node->params as $i => $param) { $isOptionalCandidate = $param->default !== null || $param->variadic; if ($isOptionalCandidate) { if ($firstOptionalParameterIndex === null) { $firstOptionalParameterIndex = $i; } } else { $firstOptionalParameterIndex = null; } } foreach ($node->params as $i => $param) { if ($param->variadic) { $isVariadic = \true; } if (!$param->var instanceof Variable || !is_string($param->var->name)) { throw new ShouldNotHappenException(); } $parameters[] = new NativeParameterReflection($param->var->name, $firstOptionalParameterIndex !== null && $i >= $firstOptionalParameterIndex, $this->getFunctionType($param->type, $this->isParameterValueNullable($param), \false), $param->byRef ? PassedByReference::createCreatesNewVariable() : PassedByReference::createNo(), $param->variadic, $param->default !== null ? $this->getType($param->default) : null); } $callableParameters = null; $arrayMapArgs = $node->getAttribute(ArrayMapArgVisitor::ATTRIBUTE_NAME); if ($arrayMapArgs !== null) { $callableParameters = []; foreach ($arrayMapArgs as $funcCallArg) { $callableParameters[] = new DummyParameter('item', $this->getType($funcCallArg->value)->getIterableValueType(), \false, PassedByReference::createNo(), \false, null); } } else { $inFunctionCallsStackCount = count($this->inFunctionCallsStack); if ($inFunctionCallsStackCount > 0) { [, $inParameter] = $this->inFunctionCallsStack[$inFunctionCallsStackCount - 1]; if ($inParameter !== null) { $callableParameters = $this->nodeScopeResolver->createCallableParameters($this, $node, null, $inParameter->getType()); } } } if ($node instanceof Expr\ArrowFunction) { $arrowScope = $this->enterArrowFunctionWithoutReflection($node, $callableParameters); if ($node->expr instanceof Expr\Yield_ || $node->expr instanceof Expr\YieldFrom) { $yieldNode = $node->expr; if ($yieldNode instanceof Expr\Yield_) { if ($yieldNode->key === null) { $keyType = new IntegerType(); } else { $keyType = $arrowScope->getType($yieldNode->key); } if ($yieldNode->value === null) { $valueType = new NullType(); } else { $valueType = $arrowScope->getType($yieldNode->value); } } else { $yieldFromType = $arrowScope->getType($yieldNode->expr); $keyType = $arrowScope->getIterableKeyType($yieldFromType); $valueType = $arrowScope->getIterableValueType($yieldFromType); } $returnType = new GenericObjectType(Generator::class, [$keyType, $valueType, new MixedType(), new VoidType()]); } else { $returnType = $arrowScope->getKeepVoidType($node->expr); if ($node->returnType !== null) { $nativeReturnType = $this->getFunctionType($node->returnType, \false, \false); $returnType = self::intersectButNotNever($nativeReturnType, $returnType); } } $arrowFunctionImpurePoints = []; $invalidateExpressions = []; $arrowFunctionExprResult = $this->nodeScopeResolver->processExprNode(new Node\Stmt\Expression($node->expr), $node->expr, $arrowScope, static function (Node $node, \PHPStan\Analyser\Scope $scope) use($arrowScope, &$arrowFunctionImpurePoints, &$invalidateExpressions) : void { if ($scope->getAnonymousFunctionReflection() !== $arrowScope->getAnonymousFunctionReflection()) { return; } if ($node instanceof InvalidateExprNode) { $invalidateExpressions[] = $node; return; } if (!$node instanceof PropertyAssignNode) { return; } $arrowFunctionImpurePoints[] = new \PHPStan\Analyser\ImpurePoint($scope, $node, 'propertyAssign', 'property assignment', \true); }, \PHPStan\Analyser\ExpressionContext::createDeep()); $throwPoints = $arrowFunctionExprResult->getThrowPoints(); $impurePoints = array_merge($arrowFunctionImpurePoints, $arrowFunctionExprResult->getImpurePoints()); $usedVariables = []; } else { $cachedTypes = $node->getAttribute('phpstanCachedTypes', []); $cacheKey = $this->getClosureScopeCacheKey(); if (array_key_exists($cacheKey, $cachedTypes)) { $cachedClosureData = $cachedTypes[$cacheKey]; return new ClosureType($parameters, $cachedClosureData['returnType'], $isVariadic, TemplateTypeMap::createEmpty(), TemplateTypeMap::createEmpty(), TemplateTypeVarianceMap::createEmpty(), [], $cachedClosureData['throwPoints'], $cachedClosureData['impurePoints'], $cachedClosureData['invalidateExpressions'], $cachedClosureData['usedVariables'], \true); } if (self::$resolveClosureTypeDepth >= 2) { return new ClosureType($parameters, $this->getFunctionType($node->returnType, \false, \false), $isVariadic); } self::$resolveClosureTypeDepth++; $closureScope = $this->enterAnonymousFunctionWithoutReflection($node, $callableParameters); $closureReturnStatements = []; $closureYieldStatements = []; $onlyNeverExecutionEnds = null; $closureImpurePoints = []; $invalidateExpressions = []; try { $closureStatementResult = $this->nodeScopeResolver->processStmtNodes($node, $node->stmts, $closureScope, static function (Node $node, \PHPStan\Analyser\Scope $scope) use($closureScope, &$closureReturnStatements, &$closureYieldStatements, &$onlyNeverExecutionEnds, &$closureImpurePoints, &$invalidateExpressions) : void { if ($scope->getAnonymousFunctionReflection() !== $closureScope->getAnonymousFunctionReflection()) { return; } if ($node instanceof InvalidateExprNode) { $invalidateExpressions[] = $node; return; } if ($node instanceof PropertyAssignNode) { $closureImpurePoints[] = new \PHPStan\Analyser\ImpurePoint($scope, $node, 'propertyAssign', 'property assignment', \true); return; } if ($node instanceof ExecutionEndNode) { if ($node->getStatementResult()->isAlwaysTerminating()) { foreach ($node->getStatementResult()->getExitPoints() as $exitPoint) { if ($exitPoint->getStatement() instanceof Node\Stmt\Return_) { $onlyNeverExecutionEnds = \false; continue; } if ($onlyNeverExecutionEnds === null) { $onlyNeverExecutionEnds = \true; } break; } if (count($node->getStatementResult()->getExitPoints()) === 0) { if ($onlyNeverExecutionEnds === null) { $onlyNeverExecutionEnds = \true; } } } else { $onlyNeverExecutionEnds = \false; } return; } if ($node instanceof Node\Stmt\Return_) { $closureReturnStatements[] = [$node, $scope]; } if (!$node instanceof Expr\Yield_ && !$node instanceof Expr\YieldFrom) { return; } $closureYieldStatements[] = [$node, $scope]; }, \PHPStan\Analyser\StatementContext::createTopLevel()); } finally { self::$resolveClosureTypeDepth--; } $throwPoints = $closureStatementResult->getThrowPoints(); $impurePoints = array_merge($closureImpurePoints, $closureStatementResult->getImpurePoints()); $returnTypes = []; $hasNull = \false; foreach ($closureReturnStatements as [$returnNode, $returnScope]) { if ($returnNode->expr === null) { $hasNull = \true; continue; } $returnTypes[] = $returnScope->getType($returnNode->expr); } if (count($returnTypes) === 0) { if ($onlyNeverExecutionEnds === \true && !$hasNull) { $returnType = new NonAcceptingNeverType(); } else { $returnType = new VoidType(); } } else { if ($onlyNeverExecutionEnds === \true) { $returnTypes[] = new NonAcceptingNeverType(); } if ($hasNull) { $returnTypes[] = new NullType(); } $returnType = TypeCombinator::union(...$returnTypes); } if (count($closureYieldStatements) > 0) { $keyTypes = []; $valueTypes = []; foreach ($closureYieldStatements as [$yieldNode, $yieldScope]) { if ($yieldNode instanceof Expr\Yield_) { if ($yieldNode->key === null) { $keyTypes[] = new IntegerType(); } else { $keyTypes[] = $yieldScope->getType($yieldNode->key); } if ($yieldNode->value === null) { $valueTypes[] = new NullType(); } else { $valueTypes[] = $yieldScope->getType($yieldNode->value); } continue; } $yieldFromType = $yieldScope->getType($yieldNode->expr); $keyTypes[] = $yieldScope->getIterableKeyType($yieldFromType); $valueTypes[] = $yieldScope->getIterableValueType($yieldFromType); } $returnType = new GenericObjectType(Generator::class, [TypeCombinator::union(...$keyTypes), TypeCombinator::union(...$valueTypes), new MixedType(), $returnType]); } else { if ($node->returnType !== null) { $nativeReturnType = $this->getFunctionType($node->returnType, \false, \false); $returnType = self::intersectButNotNever($nativeReturnType, $returnType); } } $usedVariables = []; foreach ($node->uses as $use) { if (!is_string($use->var->name)) { continue; } $usedVariables[] = $use->var->name; } foreach ($node->uses as $use) { if (!$use->byRef) { continue; } $impurePoints[] = new \PHPStan\Analyser\ImpurePoint($this, $node, 'functionCall', 'call to a Closure with by-ref use', \true); break; } } foreach ($parameters as $parameter) { if ($parameter->passedByReference()->no()) { continue; } $impurePoints[] = new \PHPStan\Analyser\ImpurePoint($this, $node, 'functionCall', 'call to a Closure with by-ref parameter', \true); } $throwPointsForClosureType = array_map(static function (\PHPStan\Analyser\ThrowPoint $throwPoint) { return $throwPoint->isExplicit() ? SimpleThrowPoint::createExplicit($throwPoint->getType(), $throwPoint->canContainAnyThrowable()) : SimpleThrowPoint::createImplicit(); }, $throwPoints); $impurePointsForClosureType = array_map(static function (\PHPStan\Analyser\ImpurePoint $impurePoint) { return new SimpleImpurePoint($impurePoint->getIdentifier(), $impurePoint->getDescription(), $impurePoint->isCertain()); }, $impurePoints); $cachedTypes = $node->getAttribute('phpstanCachedTypes', []); $cachedTypes[$this->getClosureScopeCacheKey()] = ['returnType' => $returnType, 'throwPoints' => $throwPointsForClosureType, 'impurePoints' => $impurePointsForClosureType, 'invalidateExpressions' => $invalidateExpressions, 'usedVariables' => $usedVariables]; $node->setAttribute('phpstanCachedTypes', $cachedTypes); return new ClosureType($parameters, $returnType, $isVariadic, TemplateTypeMap::createEmpty(), TemplateTypeMap::createEmpty(), TemplateTypeVarianceMap::createEmpty(), [], $throwPointsForClosureType, $impurePointsForClosureType, $invalidateExpressions, $usedVariables, \true); } elseif ($node instanceof New_) { if ($node->class instanceof Name) { $type = $this->exactInstantiation($node, $node->class->toString()); if ($type !== null) { return $type; } $lowercasedClassName = strtolower($node->class->toString()); if ($lowercasedClassName === 'static') { if (!$this->isInClass()) { return new ErrorType(); } return new StaticType($this->getClassReflection()); } if ($lowercasedClassName === 'parent') { return new NonexistentParentClassType(); } return new ObjectType($node->class->toString()); } if ($node->class instanceof Node\Stmt\Class_) { $anonymousClassReflection = $this->reflectionProvider->getAnonymousClassReflection($node->class, $this); return new ObjectType($anonymousClassReflection->getName()); } $exprType = $this->getType($node->class); return $exprType->getObjectTypeOrClassStringObjectType(); } elseif ($node instanceof Array_) { return $this->initializerExprTypeResolver->getArrayType($node, function (Expr $expr) : Type { return $this->getType($expr); }); } elseif ($node instanceof Int_) { return $this->getType($node->expr)->toInteger(); } elseif ($node instanceof Bool_) { return $this->getType($node->expr)->toBoolean(); } elseif ($node instanceof Double) { return $this->getType($node->expr)->toFloat(); } elseif ($node instanceof Node\Expr\Cast\String_) { return $this->getType($node->expr)->toString(); } elseif ($node instanceof Node\Expr\Cast\Array_) { return $this->getType($node->expr)->toArray(); } elseif ($node instanceof Node\Scalar\MagicConst) { return $this->initializerExprTypeResolver->getType($node, InitializerExprContext::fromScope($this)); } elseif ($node instanceof Object_) { $castToObject = static function (Type $type) : Type { $constantArrays = $type->getConstantArrays(); if (count($constantArrays) > 0) { $objects = []; foreach ($constantArrays as $constantArray) { $properties = []; $optionalProperties = []; foreach ($constantArray->getKeyTypes() as $i => $keyType) { if (!$keyType instanceof ConstantStringType) { // an object with integer properties is >weird< continue; } $valueType = $constantArray->getValueTypes()[$i]; $optional = $constantArray->isOptionalKey($i); if ($optional) { $optionalProperties[] = $keyType->getValue(); } $properties[$keyType->getValue()] = $valueType; } $objects[] = TypeCombinator::intersect(new ObjectShapeType($properties, $optionalProperties), new ObjectType(stdClass::class)); } return TypeCombinator::union(...$objects); } if ($type->isObject()->yes()) { return $type; } return new ObjectType('stdClass'); }; $exprType = $this->getType($node->expr); if ($exprType instanceof UnionType) { return TypeCombinator::union(...array_map($castToObject, $exprType->getTypes())); } return $castToObject($exprType); } elseif ($node instanceof Unset_) { return new NullType(); } elseif ($node instanceof Expr\PostInc || $node instanceof Expr\PostDec) { return $this->getType($node->var); } elseif ($node instanceof Expr\PreInc || $node instanceof Expr\PreDec) { $varType = $this->getType($node->var); $varScalars = $varType->getConstantScalarValues(); if (count($varScalars) > 0) { $newTypes = []; foreach ($varScalars as $varValue) { if ($node instanceof Expr\PreInc) { if (!is_bool($varValue)) { ++$varValue; } } elseif (is_numeric($varValue)) { --$varValue; } $newTypes[] = $this->getTypeFromValue($varValue); } return TypeCombinator::union(...$newTypes); } elseif ($varType->isString()->yes()) { if ($varType->isLiteralString()->yes()) { return new IntersectionType([new StringType(), new AccessoryLiteralStringType()]); } if ($varType->isNumericString()->yes()) { return new BenevolentUnionType([new IntegerType(), new FloatType()]); } return new BenevolentUnionType([new StringType(), new IntegerType(), new FloatType()]); } if ($node instanceof Expr\PreInc) { return $this->getType(new BinaryOp\Plus($node->var, new LNumber(1))); } return $this->getType(new BinaryOp\Minus($node->var, new LNumber(1))); } elseif ($node instanceof Expr\Yield_) { $functionReflection = $this->getFunction(); if ($functionReflection === null) { return new MixedType(); } $returnType = $functionReflection->getReturnType(); $generatorSendType = $returnType->getTemplateType(Generator::class, 'TSend'); if ($generatorSendType instanceof ErrorType) { return new MixedType(); } return $generatorSendType; } elseif ($node instanceof Expr\YieldFrom) { $yieldFromType = $this->getType($node->expr); $generatorReturnType = $yieldFromType->getTemplateType(Generator::class, 'TReturn'); if ($generatorReturnType instanceof ErrorType) { return new MixedType(); } return $generatorReturnType; } elseif ($node instanceof Expr\Match_) { $cond = $node->cond; $condType = $this->getType($cond); $types = []; $matchScope = $this; $arms = $node->arms; if ($condType->isEnum()->yes()) { // enum match analysis would work even without this if branch // but would be much slower // this avoids using ObjectType::$subtractedType which is slow for huge enums // because of repeated union type normalization $enumCases = $condType->getEnumCases(); if (count($enumCases) > 0) { $indexedEnumCases = []; foreach ($enumCases as $enumCase) { $indexedEnumCases[strtolower($enumCase->getClassName())][$enumCase->getEnumCaseName()] = $enumCase; } $unusedIndexedEnumCases = $indexedEnumCases; foreach ($arms as $i => $arm) { if ($arm->conds === null) { continue; } $conditionCases = []; foreach ($arm->conds as $armCond) { if (!$armCond instanceof Expr\ClassConstFetch) { continue 2; } if (!$armCond->class instanceof Name) { continue 2; } if (!$armCond->name instanceof Node\Identifier) { continue 2; } $fetchedClassName = $this->resolveName($armCond->class); $loweredFetchedClassName = strtolower($fetchedClassName); if (!array_key_exists($loweredFetchedClassName, $indexedEnumCases)) { continue 2; } $caseName = $armCond->name->toString(); if (!array_key_exists($caseName, $indexedEnumCases[$loweredFetchedClassName])) { continue 2; } $conditionCases[] = $indexedEnumCases[$loweredFetchedClassName][$caseName]; unset($unusedIndexedEnumCases[$loweredFetchedClassName][$caseName]); } $conditionCasesCount = count($conditionCases); if ($conditionCasesCount === 0) { throw new ShouldNotHappenException(); } elseif ($conditionCasesCount === 1) { $conditionCaseType = $conditionCases[0]; } else { $conditionCaseType = new UnionType($conditionCases); } $types[] = $matchScope->addTypeToExpression($cond, $conditionCaseType)->getType($arm->body); unset($arms[$i]); } $remainingCases = []; foreach ($unusedIndexedEnumCases as $cases) { foreach ($cases as $case) { $remainingCases[] = $case; } } $remainingCasesCount = count($remainingCases); if ($remainingCasesCount === 0) { $remainingType = new NeverType(); } elseif ($remainingCasesCount === 1) { $remainingType = $remainingCases[0]; } else { $remainingType = new UnionType($remainingCases); } $matchScope = $matchScope->addTypeToExpression($cond, $remainingType); } } foreach ($arms as $arm) { if ($arm->conds === null) { if ($node->hasAttribute(self::KEEP_VOID_ATTRIBUTE_NAME)) { $arm->body->setAttribute(self::KEEP_VOID_ATTRIBUTE_NAME, $node->getAttribute(self::KEEP_VOID_ATTRIBUTE_NAME)); } $types[] = $matchScope->getType($arm->body); continue; } if (count($arm->conds) === 0) { throw new ShouldNotHappenException(); } if (count($arm->conds) === 1) { $filteringExpr = new BinaryOp\Identical($cond, $arm->conds[0]); } else { $items = []; foreach ($arm->conds as $filteringExpr) { $items[] = new Expr\ArrayItem($filteringExpr); } $filteringExpr = new FuncCall(new Name\FullyQualified('in_array'), [new Arg($cond), new Arg(new Array_($items)), new Arg(new ConstFetch(new Name\FullyQualified('true')))]); } $filteringExprType = $matchScope->getType($filteringExpr); if (!$filteringExprType->isFalse()->yes()) { $truthyScope = $matchScope->filterByTruthyValue($filteringExpr); if ($node->hasAttribute(self::KEEP_VOID_ATTRIBUTE_NAME)) { $arm->body->setAttribute(self::KEEP_VOID_ATTRIBUTE_NAME, $node->getAttribute(self::KEEP_VOID_ATTRIBUTE_NAME)); } $types[] = $truthyScope->getType($arm->body); } $matchScope = $matchScope->filterByFalseyValue($filteringExpr); } return TypeCombinator::union(...$types); } if ($node instanceof Expr\Isset_) { $issetResult = \true; foreach ($node->vars as $var) { $result = $this->issetCheck($var, static function (Type $type) : ?bool { $isNull = $type->isNull(); if ($isNull->maybe()) { return null; } return !$isNull->yes(); }); if ($result !== null) { if (!$result) { return new ConstantBooleanType($result); } continue; } $issetResult = $result; } if ($issetResult === null) { return new BooleanType(); } return new ConstantBooleanType($issetResult); } if ($node instanceof Expr\AssignOp\Coalesce) { return $this->getType(new BinaryOp\Coalesce($node->var, $node->expr, $node->getAttributes())); } if ($node instanceof Expr\BinaryOp\Coalesce) { $issetLeftExpr = new Expr\Isset_([$node->left]); $leftType = $this->filterByTruthyValue($issetLeftExpr)->getType($node->left); $result = $this->issetCheck($node->left, static function (Type $type) : ?bool { $isNull = $type->isNull(); if ($isNull->maybe()) { return null; } return !$isNull->yes(); }); if ($result !== null && $result !== \false) { return TypeCombinator::removeNull($leftType); } $rightType = $this->filterByFalseyValue($issetLeftExpr)->getType($node->right); if ($result === null) { return TypeCombinator::union(TypeCombinator::removeNull($leftType), $rightType); } return $rightType; } if ($node instanceof ConstFetch) { $constName = (string) $node->name; $loweredConstName = strtolower($constName); if ($loweredConstName === 'true') { return new ConstantBooleanType(\true); } elseif ($loweredConstName === 'false') { return new ConstantBooleanType(\false); } elseif ($loweredConstName === 'null') { return new NullType(); } $namespacedName = null; if (!$node->name->isFullyQualified() && $this->getNamespace() !== null) { $namespacedName = new FullyQualified([$this->getNamespace(), $node->name->toString()]); } $globalName = new FullyQualified($node->name->toString()); foreach ([$namespacedName, $globalName] as $name) { if ($name === null) { continue; } $constFetch = new ConstFetch($name); if ($this->hasExpressionType($constFetch)->yes()) { return $this->constantResolver->resolveConstantType($name->toString(), $this->expressionTypes[$this->getNodeKey($constFetch)]->getType()); } } $constantType = $this->constantResolver->resolveConstant($node->name, $this); if ($constantType !== null) { return $constantType; } return new ErrorType(); } elseif ($node instanceof Node\Expr\ClassConstFetch && $node->name instanceof Node\Identifier) { if ($this->hasExpressionType($node)->yes()) { return $this->expressionTypes[$exprString]->getType(); } return $this->initializerExprTypeResolver->getClassConstFetchTypeByReflection($node->class, $node->name->name, $this->isInClass() ? $this->getClassReflection() : null, function (Expr $expr) : Type { return $this->getType($expr); }); } if ($node instanceof Expr\Ternary) { $noopCallback = static function () : void { }; $condResult = $this->nodeScopeResolver->processExprNode(new Node\Stmt\Expression($node->cond), $node->cond, $this, $noopCallback, \PHPStan\Analyser\ExpressionContext::createDeep()); if ($node->if === null) { $conditionType = $this->getType($node->cond); $booleanConditionType = $conditionType->toBoolean(); if ($booleanConditionType->isTrue()->yes()) { return $condResult->getTruthyScope()->getType($node->cond); } if ($booleanConditionType->isFalse()->yes()) { return $condResult->getFalseyScope()->getType($node->else); } return TypeCombinator::union(TypeCombinator::removeFalsey($condResult->getTruthyScope()->getType($node->cond)), $condResult->getFalseyScope()->getType($node->else)); } $booleanConditionType = $this->getType($node->cond)->toBoolean(); if ($booleanConditionType->isTrue()->yes()) { return $condResult->getTruthyScope()->getType($node->if); } if ($booleanConditionType->isFalse()->yes()) { return $condResult->getFalseyScope()->getType($node->else); } return TypeCombinator::union($condResult->getTruthyScope()->getType($node->if), $condResult->getFalseyScope()->getType($node->else)); } if ($node instanceof Variable && is_string($node->name)) { if ($this->hasVariableType($node->name)->no()) { return new ErrorType(); } return $this->getVariableType($node->name); } if ($node instanceof Expr\ArrayDimFetch && $node->dim !== null) { return $this->getNullsafeShortCircuitingType($node->var, $this->getTypeFromArrayDimFetch($node, $this->getType($node->dim), $this->getType($node->var))); } if ($node instanceof MethodCall && $node->name instanceof Node\Identifier) { if ($this->nativeTypesPromoted) { $typeCallback = function () use($node) : Type { $methodReflection = $this->getMethodReflection($this->getNativeType($node->var), $node->name->name); if ($methodReflection === null) { return new ErrorType(); } return ParametersAcceptorSelector::combineAcceptors($methodReflection->getVariants())->getNativeReturnType(); }; return $this->getNullsafeShortCircuitingType($node->var, $typeCallback()); } $typeCallback = function () use($node) : Type { $returnType = $this->methodCallReturnType($this->getType($node->var), $node->name->name, $node); if ($returnType === null) { return new ErrorType(); } return $returnType; }; return $this->getNullsafeShortCircuitingType($node->var, $typeCallback()); } if ($node instanceof Expr\NullsafeMethodCall) { $varType = $this->getType($node->var); if ($varType->isNull()->yes()) { return new NullType(); } if (!TypeCombinator::containsNull($varType)) { return $this->getType(new MethodCall($node->var, $node->name, $node->args)); } return TypeCombinator::union($this->filterByTruthyValue(new BinaryOp\NotIdentical($node->var, new ConstFetch(new Name('null'))))->getType(new MethodCall($node->var, $node->name, $node->args)), new NullType()); } if ($node instanceof Expr\StaticCall && $node->name instanceof Node\Identifier) { if ($this->nativeTypesPromoted) { $typeCallback = function () use($node) : Type { if ($node->class instanceof Name) { $staticMethodCalledOnType = $this->resolveTypeByNameWithLateStaticBinding($node->class, $node->name); } else { $staticMethodCalledOnType = $this->getNativeType($node->class); } $methodReflection = $this->getMethodReflection($staticMethodCalledOnType, $node->name->name); if ($methodReflection === null) { return new ErrorType(); } return ParametersAcceptorSelector::combineAcceptors($methodReflection->getVariants())->getNativeReturnType(); }; $callType = $typeCallback(); if ($node->class instanceof Expr) { return $this->getNullsafeShortCircuitingType($node->class, $callType); } return $callType; } $typeCallback = function () use($node) : Type { if ($node->class instanceof Name) { $staticMethodCalledOnType = $this->resolveTypeByNameWithLateStaticBinding($node->class, $node->name); } else { $staticMethodCalledOnType = TypeCombinator::removeNull($this->getType($node->class))->getObjectTypeOrClassStringObjectType(); } $returnType = $this->methodCallReturnType($staticMethodCalledOnType, $node->name->toString(), $node); if ($returnType === null) { return new ErrorType(); } return $returnType; }; $callType = $typeCallback(); if ($node->class instanceof Expr) { return $this->getNullsafeShortCircuitingType($node->class, $callType); } return $callType; } if ($node instanceof PropertyFetch && $node->name instanceof Node\Identifier) { if ($this->nativeTypesPromoted) { $propertyReflection = $this->propertyReflectionFinder->findPropertyReflectionFromNode($node, $this); if ($propertyReflection === null) { return new ErrorType(); } $nativeType = $propertyReflection->getNativeType(); if ($nativeType === null) { return new ErrorType(); } return $this->getNullsafeShortCircuitingType($node->var, $nativeType); } $typeCallback = function () use($node) : Type { $returnType = $this->propertyFetchType($this->getType($node->var), $node->name->name, $node); if ($returnType === null) { return new ErrorType(); } return $returnType; }; return $this->getNullsafeShortCircuitingType($node->var, $typeCallback()); } if ($node instanceof Expr\NullsafePropertyFetch) { $varType = $this->getType($node->var); if ($varType->isNull()->yes()) { return new NullType(); } if (!TypeCombinator::containsNull($varType)) { return $this->getType(new PropertyFetch($node->var, $node->name)); } return TypeCombinator::union($this->filterByTruthyValue(new BinaryOp\NotIdentical($node->var, new ConstFetch(new Name('null'))))->getType(new PropertyFetch($node->var, $node->name)), new NullType()); } if ($node instanceof Expr\StaticPropertyFetch && $node->name instanceof Node\VarLikeIdentifier) { if ($this->nativeTypesPromoted) { $propertyReflection = $this->propertyReflectionFinder->findPropertyReflectionFromNode($node, $this); if ($propertyReflection === null) { return new ErrorType(); } $nativeType = $propertyReflection->getNativeType(); if ($nativeType === null) { return new ErrorType(); } if ($node->class instanceof Expr) { return $this->getNullsafeShortCircuitingType($node->class, $nativeType); } return $nativeType; } $typeCallback = function () use($node) : Type { if ($node->class instanceof Name) { $staticPropertyFetchedOnType = $this->resolveTypeByName($node->class); } else { $staticPropertyFetchedOnType = TypeCombinator::removeNull($this->getType($node->class))->getObjectTypeOrClassStringObjectType(); } $returnType = $this->propertyFetchType($staticPropertyFetchedOnType, $node->name->toString(), $node); if ($returnType === null) { return new ErrorType(); } return $returnType; }; $fetchType = $typeCallback(); if ($node->class instanceof Expr) { return $this->getNullsafeShortCircuitingType($node->class, $fetchType); } return $fetchType; } if ($node instanceof FuncCall) { if ($node->name instanceof Expr) { $calledOnType = $this->getType($node->name); if ($calledOnType->isCallable()->no()) { return new ErrorType(); } return ParametersAcceptorSelector::selectFromArgs($this, $node->getArgs(), $calledOnType->getCallableParametersAcceptors($this), null)->getReturnType(); } if (!$this->reflectionProvider->hasFunction($node->name, $this)) { return new ErrorType(); } $functionReflection = $this->reflectionProvider->getFunction($node->name, $this); if ($this->nativeTypesPromoted) { return ParametersAcceptorSelector::combineAcceptors($functionReflection->getVariants())->getNativeReturnType(); } if ($functionReflection->getName() === 'call_user_func') { $result = \PHPStan\Analyser\ArgumentsNormalizer::reorderCallUserFuncArguments($node, $this); if ($result !== null) { [, $innerFuncCall] = $result; return $this->getType($innerFuncCall); } } $parametersAcceptor = ParametersAcceptorSelector::selectFromArgs($this, $node->getArgs(), $functionReflection->getVariants(), $functionReflection->getNamedArgumentsVariants()); $normalizedNode = \PHPStan\Analyser\ArgumentsNormalizer::reorderFuncArguments($parametersAcceptor, $node); if ($normalizedNode !== null) { foreach ($this->dynamicReturnTypeExtensionRegistry->getDynamicFunctionReturnTypeExtensions() as $dynamicFunctionReturnTypeExtension) { if (!$dynamicFunctionReturnTypeExtension->isFunctionSupported($functionReflection)) { continue; } $resolvedType = $dynamicFunctionReturnTypeExtension->getTypeFromFunctionCall($functionReflection, $normalizedNode, $this); if ($resolvedType !== null) { return $resolvedType; } } } return $this->transformVoidToNull($parametersAcceptor->getReturnType(), $node); } return new MixedType(); } private function getNullsafeShortCircuitingType(Expr $expr, Type $type) : Type { if ($expr instanceof Expr\NullsafePropertyFetch || $expr instanceof Expr\NullsafeMethodCall) { $varType = $this->getType($expr->var); if (TypeCombinator::containsNull($varType)) { return TypeCombinator::addNull($type); } return $type; } if ($expr instanceof Expr\ArrayDimFetch) { return $this->getNullsafeShortCircuitingType($expr->var, $type); } if ($expr instanceof PropertyFetch) { return $this->getNullsafeShortCircuitingType($expr->var, $type); } if ($expr instanceof Expr\StaticPropertyFetch && $expr->class instanceof Expr) { return $this->getNullsafeShortCircuitingType($expr->class, $type); } if ($expr instanceof MethodCall) { return $this->getNullsafeShortCircuitingType($expr->var, $type); } if ($expr instanceof Expr\StaticCall && $expr->class instanceof Expr) { return $this->getNullsafeShortCircuitingType($expr->class, $type); } return $type; } private function transformVoidToNull(Type $type, Node $node) : Type { if ($node->getAttribute(self::KEEP_VOID_ATTRIBUTE_NAME) === \true) { return $type; } return TypeTraverser::map($type, static function (Type $type, callable $traverse) : Type { if ($type instanceof UnionType || $type instanceof IntersectionType) { return $traverse($type); } if ($type->isVoid()->yes()) { return new NullType(); } return $type; }); } /** * @param callable(Type): ?bool $typeCallback */ public function issetCheck(Expr $expr, callable $typeCallback, ?bool $result = null) : ?bool { // mirrored in PHPStan\Rules\IssetCheck if ($expr instanceof Node\Expr\Variable && is_string($expr->name)) { $hasVariable = $this->hasVariableType($expr->name); if ($hasVariable->maybe()) { return null; } if ($result === null) { if ($hasVariable->yes()) { if ($expr->name === '_SESSION') { return null; } return $typeCallback($this->getVariableType($expr->name)); } return \false; } return $result; } elseif ($expr instanceof Node\Expr\ArrayDimFetch && $expr->dim !== null) { $type = $this->getType($expr->var); if (!$type->isOffsetAccessible()->yes()) { return $result ?? $this->issetCheckUndefined($expr->var); } $dimType = $this->getType($expr->dim); $hasOffsetValue = $type->hasOffsetValueType($dimType); if ($hasOffsetValue->no()) { return \false; } // If offset cannot be null, store this error message and see if one of the earlier offsets is. // E.g. $array['a']['b']['c'] ?? null; is a valid coalesce if a OR b or C might be null. if ($hasOffsetValue->yes()) { $result = $typeCallback($type->getOffsetValueType($dimType)); if ($result !== null) { return $this->issetCheck($expr->var, $typeCallback, $result); } } // Has offset, it is nullable return null; } elseif ($expr instanceof Node\Expr\PropertyFetch || $expr instanceof Node\Expr\StaticPropertyFetch) { $propertyReflection = $this->propertyReflectionFinder->findPropertyReflectionFromNode($expr, $this); if ($propertyReflection === null) { if ($expr instanceof Node\Expr\PropertyFetch) { return $this->issetCheckUndefined($expr->var); } if ($expr->class instanceof Expr) { return $this->issetCheckUndefined($expr->class); } return null; } if (!$propertyReflection->isNative()) { if ($expr instanceof Node\Expr\PropertyFetch) { return $this->issetCheckUndefined($expr->var); } if ($expr->class instanceof Expr) { return $this->issetCheckUndefined($expr->class); } return null; } $nativeType = $propertyReflection->getNativeType(); if (!$nativeType instanceof MixedType) { if (!$this->hasExpressionType($expr)->yes()) { if ($expr instanceof Node\Expr\PropertyFetch) { return $this->issetCheckUndefined($expr->var); } if ($expr->class instanceof Expr) { return $this->issetCheckUndefined($expr->class); } return null; } } if ($result !== null) { return $result; } $result = $typeCallback($propertyReflection->getWritableType()); if ($result !== null) { if ($expr instanceof Node\Expr\PropertyFetch) { return $this->issetCheck($expr->var, $typeCallback, $result); } if ($expr->class instanceof Expr) { return $this->issetCheck($expr->class, $typeCallback, $result); } } return $result; } if ($result !== null) { return $result; } return $typeCallback($this->getType($expr)); } private function issetCheckUndefined(Expr $expr) : ?bool { if ($expr instanceof Node\Expr\Variable && is_string($expr->name)) { $hasVariable = $this->hasVariableType($expr->name); if (!$hasVariable->no()) { return null; } return \false; } if ($expr instanceof Node\Expr\ArrayDimFetch && $expr->dim !== null) { $type = $this->getType($expr->var); if (!$type->isOffsetAccessible()->yes()) { return $this->issetCheckUndefined($expr->var); } $dimType = $this->getType($expr->dim); $hasOffsetValue = $type->hasOffsetValueType($dimType); if (!$hasOffsetValue->no()) { return $this->issetCheckUndefined($expr->var); } return \false; } if ($expr instanceof Expr\PropertyFetch) { return $this->issetCheckUndefined($expr->var); } if ($expr instanceof Expr\StaticPropertyFetch && $expr->class instanceof Expr) { return $this->issetCheckUndefined($expr->class); } return null; } /** * @param ParametersAcceptor[] $variants * @param FunctionReflection|ExtendedMethodReflection|null $function */ private function createFirstClassCallable($function, array $variants) : Type { $closureTypes = []; foreach ($variants as $variant) { $returnType = $variant->getReturnType(); if ($variant instanceof ParametersAcceptorWithPhpDocs) { $returnType = $this->nativeTypesPromoted ? $variant->getNativeReturnType() : $returnType; } $templateTags = []; foreach ($variant->getTemplateTypeMap()->getTypes() as $templateType) { if (!$templateType instanceof TemplateType) { continue; } $templateTags[$templateType->getName()] = new TemplateTag($templateType->getName(), $templateType->getBound(), $templateType->getDefault(), $templateType->getVariance()); } $throwPoints = []; $impurePoints = []; $acceptsNamedArguments = \true; if ($variant instanceof CallableParametersAcceptor) { $throwPoints = $variant->getThrowPoints(); $impurePoints = $variant->getImpurePoints(); $acceptsNamedArguments = $variant->acceptsNamedArguments(); } elseif ($function !== null) { $returnTypeForThrow = $variant->getReturnType(); $throwType = $function->getThrowType(); if ($throwType === null) { if ($returnTypeForThrow instanceof NeverType && $returnTypeForThrow->isExplicit()) { $throwType = new ObjectType(Throwable::class); } } if ($throwType !== null) { if (!$throwType->isVoid()->yes()) { $throwPoints[] = SimpleThrowPoint::createExplicit($throwType, \true); } } else { if (!(new ObjectType(Throwable::class))->isSuperTypeOf($returnTypeForThrow)->yes()) { $throwPoints[] = SimpleThrowPoint::createImplicit(); } } $impurePoint = SimpleImpurePoint::createFromVariant($function, $variant); if ($impurePoint !== null) { $impurePoints[] = $impurePoint; } $acceptsNamedArguments = $function->acceptsNamedArguments(); } $parameters = $variant->getParameters(); $closureTypes[] = new ClosureType($parameters, $returnType, $variant->isVariadic(), $variant->getTemplateTypeMap(), $variant->getResolvedTemplateTypeMap(), $variant instanceof ParametersAcceptorWithPhpDocs ? $variant->getCallSiteVarianceMap() : TemplateTypeVarianceMap::createEmpty(), $templateTags, $throwPoints, $impurePoints, [], [], $acceptsNamedArguments); } return TypeCombinator::union(...$closureTypes); } /** @api */ public function getNativeType(Expr $expr) : Type { return $this->promoteNativeTypes()->getType($expr); } public function getKeepVoidType(Expr $node) : Type { $clonedNode = clone $node; $clonedNode->setAttribute(self::KEEP_VOID_ATTRIBUTE_NAME, \true); return $this->getType($clonedNode); } /** * @api * @deprecated Use getNativeType() */ public function doNotTreatPhpDocTypesAsCertain() : \PHPStan\Analyser\Scope { return $this->promoteNativeTypes(); } private function promoteNativeTypes() : self { if ($this->nativeTypesPromoted) { return $this; } if ($this->scopeWithPromotedNativeTypes !== null) { return $this->scopeWithPromotedNativeTypes; } return $this->scopeWithPromotedNativeTypes = $this->scopeFactory->create($this->context, $this->declareStrictTypes, $this->function, $this->namespace, $this->nativeExpressionTypes, [], [], $this->inClosureBindScopeClasses, $this->anonymousFunctionReflection, $this->inFirstLevelStatement, $this->currentlyAssignedExpressions, $this->currentlyAllowedUndefinedExpressions, $this->inFunctionCallsStack, $this->afterExtractCall, $this->parentScope, \true); } /** * @param Node\Expr\PropertyFetch|Node\Expr\StaticPropertyFetch $propertyFetch */ public function hasPropertyNativeType($propertyFetch) : bool { $propertyReflection = $this->propertyReflectionFinder->findPropertyReflectionFromNode($propertyFetch, $this); if ($propertyReflection === null) { return \false; } if (!$propertyReflection->isNative()) { return \false; } return !$propertyReflection->getNativeType() instanceof MixedType; } /** @api */ protected function getTypeFromArrayDimFetch(Expr\ArrayDimFetch $arrayDimFetch, Type $offsetType, Type $offsetAccessibleType) : Type { if ($arrayDimFetch->dim === null) { throw new ShouldNotHappenException(); } if (!$offsetAccessibleType->isArray()->yes() && (new ObjectType(ArrayAccess::class))->isSuperTypeOf($offsetAccessibleType)->yes()) { return $this->getType(new MethodCall($arrayDimFetch->var, new Node\Identifier('offsetGet'), [new Node\Arg($arrayDimFetch->dim)])); } return $offsetAccessibleType->getOffsetValueType($offsetType); } private function resolveExactName(Name $name) : ?string { $originalClass = (string) $name; switch (strtolower($originalClass)) { case 'self': if (!$this->isInClass()) { return null; } return $this->getClassReflection()->getName(); case 'parent': if (!$this->isInClass()) { return null; } $currentClassReflection = $this->getClassReflection(); if ($currentClassReflection->getParentClass() !== null) { return $currentClassReflection->getParentClass()->getName(); } return null; case 'static': return null; } return $originalClass; } /** @api */ public function resolveName(Name $name) : string { $originalClass = (string) $name; if ($this->isInClass()) { $lowerClass = strtolower($originalClass); if (in_array($lowerClass, ['self', 'static'], \true)) { if ($this->inClosureBindScopeClasses !== [] && $this->inClosureBindScopeClasses !== ['static']) { return $this->inClosureBindScopeClasses[0]; } return $this->getClassReflection()->getName(); } elseif ($lowerClass === 'parent') { $currentClassReflection = $this->getClassReflection(); if ($currentClassReflection->getParentClass() !== null) { return $currentClassReflection->getParentClass()->getName(); } } } return $originalClass; } /** @api */ public function resolveTypeByName(Name $name) : TypeWithClassName { if ($name->toLowerString() === 'static' && $this->isInClass()) { if ($this->inClosureBindScopeClasses !== [] && $this->inClosureBindScopeClasses !== ['static']) { if ($this->reflectionProvider->hasClass($this->inClosureBindScopeClasses[0])) { return new StaticType($this->reflectionProvider->getClass($this->inClosureBindScopeClasses[0])); } } return new StaticType($this->getClassReflection()); } $originalClass = $this->resolveName($name); if ($this->isInClass()) { if ($this->inClosureBindScopeClasses === [$originalClass]) { if ($this->reflectionProvider->hasClass($originalClass)) { return new ThisType($this->reflectionProvider->getClass($originalClass)); } return new ObjectType($originalClass); } $thisType = new ThisType($this->getClassReflection()); $ancestor = $thisType->getAncestorWithClassName($originalClass); if ($ancestor !== null) { return $ancestor; } } return new ObjectType($originalClass); } private function resolveTypeByNameWithLateStaticBinding(Name $class, Node\Identifier $name) : TypeWithClassName { $classType = $this->resolveTypeByName($class); if ($classType instanceof StaticType && !in_array($class->toLowerString(), ['self', 'static', 'parent'], \true)) { $methodReflectionCandidate = $this->getMethodReflection($classType, $name->name); if ($methodReflectionCandidate !== null && $methodReflectionCandidate->isStatic()) { $classType = $classType->getStaticObjectType(); } } return $classType; } /** * @api * @param mixed $value */ public function getTypeFromValue($value) : Type { return ConstantTypeHelper::getTypeFromValue($value); } /** * @api * @deprecated use hasExpressionType instead */ public function isSpecified(Expr $node) : bool { return !$node instanceof Variable && $this->hasExpressionType($node)->yes(); } /** @api */ public function hasExpressionType(Expr $node) : TrinaryLogic { if ($node instanceof Variable && is_string($node->name)) { return $this->hasVariableType($node->name); } $exprString = $this->getNodeKey($node); if (!isset($this->expressionTypes[$exprString])) { return TrinaryLogic::createNo(); } return $this->expressionTypes[$exprString]->getCertainty(); } /** * @param MethodReflection|FunctionReflection|null $reflection */ public function pushInFunctionCall($reflection, ?ParameterReflection $parameter) : self { $stack = $this->inFunctionCallsStack; $stack[] = [$reflection, $parameter]; return $this->scopeFactory->create($this->context, $this->isDeclareStrictTypes(), $this->getFunction(), $this->getNamespace(), $this->expressionTypes, $this->nativeExpressionTypes, $this->conditionalExpressions, $this->inClosureBindScopeClasses, $this->anonymousFunctionReflection, $this->isInFirstLevelStatement(), $this->currentlyAssignedExpressions, $this->currentlyAllowedUndefinedExpressions, $stack, $this->afterExtractCall, $this->parentScope, $this->nativeTypesPromoted); } public function popInFunctionCall() : self { $stack = $this->inFunctionCallsStack; array_pop($stack); return $this->scopeFactory->create($this->context, $this->isDeclareStrictTypes(), $this->getFunction(), $this->getNamespace(), $this->expressionTypes, $this->nativeExpressionTypes, $this->conditionalExpressions, $this->inClosureBindScopeClasses, $this->anonymousFunctionReflection, $this->isInFirstLevelStatement(), $this->currentlyAssignedExpressions, $this->currentlyAllowedUndefinedExpressions, $stack, $this->afterExtractCall, $this->parentScope, $this->nativeTypesPromoted); } /** @api */ public function isInClassExists(string $className) : bool { foreach ($this->inFunctionCallsStack as [$inFunctionCall]) { if (!$inFunctionCall instanceof FunctionReflection) { continue; } if (in_array($inFunctionCall->getName(), ['class_exists', 'interface_exists', 'trait_exists'], \true)) { return \true; } } $expr = new FuncCall(new FullyQualified('class_exists'), [new Arg(new String_(ltrim($className, '\\')))]); return $this->getType($expr)->isTrue()->yes(); } public function getFunctionCallStack() : array { return array_values(array_filter(array_map(static function ($values) { return $values[0]; }, $this->inFunctionCallsStack), static function ($reflection) { return $reflection !== null; })); } public function getFunctionCallStackWithParameters() : array { return array_values(array_filter($this->inFunctionCallsStack, static function ($item) { return $item[0] !== null; })); } /** @api */ public function isInFunctionExists(string $functionName) : bool { $expr = new FuncCall(new FullyQualified('function_exists'), [new Arg(new String_(ltrim($functionName, '\\')))]); return $this->getType($expr)->isTrue()->yes(); } /** @api */ public function enterClass(ClassReflection $classReflection) : self { $thisHolder = \PHPStan\Analyser\ExpressionTypeHolder::createYes(new Variable('this'), new ThisType($classReflection)); $constantTypes = $this->getConstantTypes(); $constantTypes['$this'] = $thisHolder; $nativeConstantTypes = $this->getNativeConstantTypes(); $nativeConstantTypes['$this'] = $thisHolder; return $this->scopeFactory->create($this->context->enterClass($classReflection), $this->isDeclareStrictTypes(), null, $this->getNamespace(), $constantTypes, $nativeConstantTypes, [], [], null, \true, [], [], [], \false, $classReflection->isAnonymous() ? $this : null); } public function enterTrait(ClassReflection $traitReflection) : self { $namespace = null; $traitName = $traitReflection->getName(); $traitNameParts = explode('\\', $traitName); if (count($traitNameParts) > 1) { $namespace = implode('\\', array_slice($traitNameParts, 0, -1)); } return $this->scopeFactory->create($this->context->enterTrait($traitReflection), $this->isDeclareStrictTypes(), $this->getFunction(), $namespace, $this->expressionTypes, $this->nativeExpressionTypes, [], $this->inClosureBindScopeClasses, $this->anonymousFunctionReflection); } /** * @api * @param Type[] $phpDocParameterTypes * @param Type[] $parameterOutTypes * @param array<string, bool> $immediatelyInvokedCallableParameters * @param array<string, Type> $phpDocClosureThisTypeParameters */ public function enterClassMethod(Node\Stmt\ClassMethod $classMethod, TemplateTypeMap $templateTypeMap, array $phpDocParameterTypes, ?Type $phpDocReturnType, ?Type $throwType, ?string $deprecatedDescription, bool $isDeprecated, bool $isInternal, bool $isFinal, ?bool $isPure = null, bool $acceptsNamedArguments = \true, ?Assertions $asserts = null, ?Type $selfOutType = null, ?string $phpDocComment = null, array $parameterOutTypes = [], array $immediatelyInvokedCallableParameters = [], array $phpDocClosureThisTypeParameters = [], bool $isConstructor = \false) : self { if (!$this->isInClass()) { throw new ShouldNotHappenException(); } return $this->enterFunctionLike(new PhpMethodFromParserNodeReflection($this->getClassReflection(), $classMethod, $this->getFile(), $templateTypeMap, $this->getRealParameterTypes($classMethod), array_map(function (Type $type) : Type { return $this->transformStaticType(TemplateTypeHelper::toArgument($type)); }, $phpDocParameterTypes), $this->getRealParameterDefaultValues($classMethod), $this->transformStaticType($this->getFunctionType($classMethod->returnType, \false, \false)), $phpDocReturnType !== null ? $this->transformStaticType(TemplateTypeHelper::toArgument($phpDocReturnType)) : null, $throwType, $deprecatedDescription, $isDeprecated, $isInternal, $isFinal, $isPure, $acceptsNamedArguments, $asserts ?? Assertions::createEmpty(), $selfOutType, $phpDocComment, array_map(function (Type $type) : Type { return $this->transformStaticType(TemplateTypeHelper::toArgument($type)); }, $parameterOutTypes), $immediatelyInvokedCallableParameters, array_map(function (Type $type) : Type { return $this->transformStaticType(TemplateTypeHelper::toArgument($type)); }, $phpDocClosureThisTypeParameters), $isConstructor), !$classMethod->isStatic()); } private function transformStaticType(Type $type) : Type { return TypeTraverser::map($type, function (Type $type, callable $traverse) : Type { if (!$this->isInClass()) { return $type; } if ($type instanceof StaticType) { $classReflection = $this->getClassReflection(); $changedType = $type->changeBaseClass($classReflection); if ($classReflection->isFinal() && !$type instanceof ThisType) { $changedType = $changedType->getStaticObjectType(); } return $traverse($changedType); } return $traverse($type); }); } /** * @return Type[] */ private function getRealParameterTypes(Node\FunctionLike $functionLike) : array { $realParameterTypes = []; foreach ($functionLike->getParams() as $parameter) { if (!$parameter->var instanceof Variable || !is_string($parameter->var->name)) { throw new ShouldNotHappenException(); } $realParameterTypes[$parameter->var->name] = $this->getFunctionType($parameter->type, $this->isParameterValueNullable($parameter) && $parameter->flags === 0, \false); } return $realParameterTypes; } /** * @return Type[] */ private function getRealParameterDefaultValues(Node\FunctionLike $functionLike) : array { $realParameterDefaultValues = []; foreach ($functionLike->getParams() as $parameter) { if ($parameter->default === null) { continue; } if (!$parameter->var instanceof Variable || !is_string($parameter->var->name)) { throw new ShouldNotHappenException(); } $realParameterDefaultValues[$parameter->var->name] = $this->getType($parameter->default); } return $realParameterDefaultValues; } /** * @api * @param Type[] $phpDocParameterTypes * @param Type[] $parameterOutTypes * @param array<string, bool> $immediatelyInvokedCallableParameters * @param array<string, Type> $phpDocClosureThisTypeParameters */ public function enterFunction(Node\Stmt\Function_ $function, TemplateTypeMap $templateTypeMap, array $phpDocParameterTypes, ?Type $phpDocReturnType, ?Type $throwType, ?string $deprecatedDescription, bool $isDeprecated, bool $isInternal, bool $isFinal, ?bool $isPure = null, bool $acceptsNamedArguments = \true, ?Assertions $asserts = null, ?string $phpDocComment = null, array $parameterOutTypes = [], array $immediatelyInvokedCallableParameters = [], array $phpDocClosureThisTypeParameters = []) : self { return $this->enterFunctionLike(new PhpFunctionFromParserNodeReflection($function, $this->getFile(), $templateTypeMap, $this->getRealParameterTypes($function), array_map(static function (Type $type) : Type { return TemplateTypeHelper::toArgument($type); }, $phpDocParameterTypes), $this->getRealParameterDefaultValues($function), $this->getFunctionType($function->returnType, $function->returnType === null, \false), $phpDocReturnType !== null ? TemplateTypeHelper::toArgument($phpDocReturnType) : null, $throwType, $deprecatedDescription, $isDeprecated, $isInternal, $isFinal, $isPure, $acceptsNamedArguments, $asserts ?? Assertions::createEmpty(), $phpDocComment, array_map(static function (Type $type) : Type { return TemplateTypeHelper::toArgument($type); }, $parameterOutTypes), $immediatelyInvokedCallableParameters, $phpDocClosureThisTypeParameters), \false); } private function enterFunctionLike(PhpFunctionFromParserNodeReflection $functionReflection, bool $preserveThis) : self { $parametersByName = []; foreach ($functionReflection->getParameters() as $parameter) { $parametersByName[$parameter->getName()] = $parameter; } $expressionTypes = []; $nativeExpressionTypes = []; $conditionalTypes = []; foreach ($functionReflection->getParameters() as $parameter) { $parameterType = $parameter->getType(); if ($parameterType instanceof ConditionalTypeForParameter) { $targetParameterName = substr($parameterType->getParameterName(), 1); if (array_key_exists($targetParameterName, $parametersByName)) { $targetParameter = $parametersByName[$targetParameterName]; $ifType = $parameterType->isNegated() ? $parameterType->getElse() : $parameterType->getIf(); $elseType = $parameterType->isNegated() ? $parameterType->getIf() : $parameterType->getElse(); $holder = new \PHPStan\Analyser\ConditionalExpressionHolder([$parameterType->getParameterName() => \PHPStan\Analyser\ExpressionTypeHolder::createYes(new Variable($targetParameterName), TypeCombinator::intersect($targetParameter->getType(), $parameterType->getTarget()))], new \PHPStan\Analyser\ExpressionTypeHolder(new Variable($parameter->getName()), $ifType, TrinaryLogic::createYes())); $conditionalTypes['$' . $parameter->getName()][$holder->getKey()] = $holder; $holder = new \PHPStan\Analyser\ConditionalExpressionHolder([$parameterType->getParameterName() => \PHPStan\Analyser\ExpressionTypeHolder::createYes(new Variable($targetParameterName), TypeCombinator::remove($targetParameter->getType(), $parameterType->getTarget()))], new \PHPStan\Analyser\ExpressionTypeHolder(new Variable($parameter->getName()), $elseType, TrinaryLogic::createYes())); $conditionalTypes['$' . $parameter->getName()][$holder->getKey()] = $holder; } } $paramExprString = '$' . $parameter->getName(); if ($parameter->isVariadic()) { if ($this->phpVersion->supportsNamedArguments() && $functionReflection->acceptsNamedArguments()) { $parameterType = new ArrayType(new UnionType([new IntegerType(), new StringType()]), $parameterType); } else { $parameterType = AccessoryArrayListType::intersectWith(new ArrayType(new IntegerType(), $parameterType)); } } $parameterNode = new Variable($parameter->getName()); $expressionTypes[$paramExprString] = \PHPStan\Analyser\ExpressionTypeHolder::createYes($parameterNode, $parameterType); $parameterOriginalValueExpr = new ParameterVariableOriginalValueExpr($parameter->getName()); $parameterOriginalValueExprString = $this->getNodeKey($parameterOriginalValueExpr); $expressionTypes[$parameterOriginalValueExprString] = \PHPStan\Analyser\ExpressionTypeHolder::createYes($parameterOriginalValueExpr, $parameterType); $nativeParameterType = $parameter->getNativeType(); if ($parameter->isVariadic()) { if ($this->phpVersion->supportsNamedArguments() && $functionReflection->acceptsNamedArguments()) { $nativeParameterType = new ArrayType(new UnionType([new IntegerType(), new StringType()]), $nativeParameterType); } else { $nativeParameterType = AccessoryArrayListType::intersectWith(new ArrayType(new IntegerType(), $nativeParameterType)); } } $nativeExpressionTypes[$paramExprString] = \PHPStan\Analyser\ExpressionTypeHolder::createYes($parameterNode, $nativeParameterType); $nativeExpressionTypes[$parameterOriginalValueExprString] = \PHPStan\Analyser\ExpressionTypeHolder::createYes($parameterOriginalValueExpr, $nativeParameterType); } if ($preserveThis && array_key_exists('$this', $this->expressionTypes)) { $expressionTypes['$this'] = $this->expressionTypes['$this']; } if ($preserveThis && array_key_exists('$this', $this->nativeExpressionTypes)) { $nativeExpressionTypes['$this'] = $this->nativeExpressionTypes['$this']; } return $this->scopeFactory->create($this->context, $this->isDeclareStrictTypes(), $functionReflection, $this->getNamespace(), array_merge($this->getConstantTypes(), $expressionTypes), array_merge($this->getNativeConstantTypes(), $nativeExpressionTypes), $conditionalTypes); } /** @api */ public function enterNamespace(string $namespaceName) : self { return $this->scopeFactory->create($this->context->beginFile(), $this->isDeclareStrictTypes(), null, $namespaceName); } /** * @param list<string> $scopeClasses */ public function enterClosureBind(?Type $thisType, ?Type $nativeThisType, array $scopeClasses) : self { $expressionTypes = $this->expressionTypes; if ($thisType !== null) { $expressionTypes['$this'] = \PHPStan\Analyser\ExpressionTypeHolder::createYes(new Variable('this'), $thisType); } else { unset($expressionTypes['$this']); } $nativeExpressionTypes = $this->nativeExpressionTypes; if ($nativeThisType !== null) { $nativeExpressionTypes['$this'] = \PHPStan\Analyser\ExpressionTypeHolder::createYes(new Variable('this'), $nativeThisType); } else { unset($nativeExpressionTypes['$this']); } if ($scopeClasses === ['static'] && $this->isInClass()) { $scopeClasses = [$this->getClassReflection()->getName()]; } return $this->scopeFactory->create($this->context, $this->isDeclareStrictTypes(), $this->getFunction(), $this->getNamespace(), $expressionTypes, $nativeExpressionTypes, $this->conditionalExpressions, $scopeClasses, $this->anonymousFunctionReflection); } public function restoreOriginalScopeAfterClosureBind(self $originalScope) : self { $expressionTypes = $this->expressionTypes; if (isset($originalScope->expressionTypes['$this'])) { $expressionTypes['$this'] = $originalScope->expressionTypes['$this']; } else { unset($expressionTypes['$this']); } $nativeExpressionTypes = $this->nativeExpressionTypes; if (isset($originalScope->nativeExpressionTypes['$this'])) { $nativeExpressionTypes['$this'] = $originalScope->nativeExpressionTypes['$this']; } else { unset($nativeExpressionTypes['$this']); } return $this->scopeFactory->create($this->context, $this->isDeclareStrictTypes(), $this->getFunction(), $this->getNamespace(), $expressionTypes, $nativeExpressionTypes, $this->conditionalExpressions, $originalScope->inClosureBindScopeClasses, $this->anonymousFunctionReflection); } public function restoreThis(self $restoreThisScope) : self { $expressionTypes = $this->expressionTypes; $nativeExpressionTypes = $this->nativeExpressionTypes; if ($restoreThisScope->isInClass()) { $nodeFinder = new NodeFinder(); $cb = static function ($expr) { return $expr instanceof Variable && $expr->name === 'this'; }; foreach ($restoreThisScope->expressionTypes as $exprString => $expressionTypeHolder) { $expr = $expressionTypeHolder->getExpr(); $thisExpr = $nodeFinder->findFirst([$expr], $cb); if ($thisExpr === null) { continue; } $expressionTypes[$exprString] = $expressionTypeHolder; } foreach ($restoreThisScope->nativeExpressionTypes as $exprString => $expressionTypeHolder) { $expr = $expressionTypeHolder->getExpr(); $thisExpr = $nodeFinder->findFirst([$expr], $cb); if ($thisExpr === null) { continue; } $nativeExpressionTypes[$exprString] = $expressionTypeHolder; } } else { unset($expressionTypes['$this']); unset($nativeExpressionTypes['$this']); } return $this->scopeFactory->create($this->context, $this->isDeclareStrictTypes(), $this->getFunction(), $this->getNamespace(), $expressionTypes, $nativeExpressionTypes, $this->conditionalExpressions, $this->inClosureBindScopeClasses, $this->anonymousFunctionReflection, $this->inFirstLevelStatement, [], [], $this->inFunctionCallsStack, $this->afterExtractCall, $this->parentScope, $this->nativeTypesPromoted); } public function enterClosureCall(Type $thisType, Type $nativeThisType) : self { $expressionTypes = $this->expressionTypes; $expressionTypes['$this'] = \PHPStan\Analyser\ExpressionTypeHolder::createYes(new Variable('this'), $thisType); $nativeExpressionTypes = $this->nativeExpressionTypes; $nativeExpressionTypes['$this'] = \PHPStan\Analyser\ExpressionTypeHolder::createYes(new Variable('this'), $nativeThisType); return $this->scopeFactory->create($this->context, $this->isDeclareStrictTypes(), $this->getFunction(), $this->getNamespace(), $expressionTypes, $nativeExpressionTypes, $this->conditionalExpressions, $thisType->getObjectClassNames(), $this->anonymousFunctionReflection); } /** @api */ public function isInClosureBind() : bool { return $this->inClosureBindScopeClasses !== []; } /** * @api * @param ParameterReflection[]|null $callableParameters */ public function enterAnonymousFunction(Expr\Closure $closure, ?array $callableParameters = null) : self { $anonymousFunctionReflection = $this->getType($closure); if (!$anonymousFunctionReflection instanceof ClosureType) { throw new ShouldNotHappenException(); } $scope = $this->enterAnonymousFunctionWithoutReflection($closure, $callableParameters); return $this->scopeFactory->create($scope->context, $scope->isDeclareStrictTypes(), $scope->getFunction(), $scope->getNamespace(), $scope->expressionTypes, $scope->nativeExpressionTypes, [], $scope->inClosureBindScopeClasses, $anonymousFunctionReflection, \true, [], [], $this->inFunctionCallsStack, \false, $this, $this->nativeTypesPromoted); } /** * @param ParameterReflection[]|null $callableParameters */ private function enterAnonymousFunctionWithoutReflection(Expr\Closure $closure, ?array $callableParameters = null) : self { $expressionTypes = []; $nativeTypes = []; foreach ($closure->params as $i => $parameter) { if (!$parameter->var instanceof Variable || !is_string($parameter->var->name)) { throw new ShouldNotHappenException(); } $paramExprString = sprintf('$%s', $parameter->var->name); $isNullable = $this->isParameterValueNullable($parameter); $parameterType = $this->getFunctionType($parameter->type, $isNullable, $parameter->variadic); if ($callableParameters !== null) { if (isset($callableParameters[$i])) { $parameterType = self::intersectButNotNever($parameterType, $callableParameters[$i]->getType()); } elseif (count($callableParameters) > 0) { $lastParameter = $callableParameters[count($callableParameters) - 1]; if ($lastParameter->isVariadic()) { $parameterType = self::intersectButNotNever($parameterType, $lastParameter->getType()); } else { $parameterType = self::intersectButNotNever($parameterType, new MixedType()); } } else { $parameterType = self::intersectButNotNever($parameterType, new MixedType()); } } $holder = \PHPStan\Analyser\ExpressionTypeHolder::createYes($parameter->var, $parameterType); $expressionTypes[$paramExprString] = $holder; $nativeTypes[$paramExprString] = $holder; } $nonRefVariableNames = []; foreach ($closure->uses as $use) { if (!is_string($use->var->name)) { throw new ShouldNotHappenException(); } $variableName = $use->var->name; $paramExprString = '$' . $use->var->name; if ($use->byRef) { $holder = \PHPStan\Analyser\ExpressionTypeHolder::createYes($use->var, new MixedType()); $expressionTypes[$paramExprString] = $holder; $nativeTypes[$paramExprString] = $holder; continue; } $nonRefVariableNames[$variableName] = \true; if ($this->hasVariableType($variableName)->no()) { $variableType = new ErrorType(); $variableNativeType = new ErrorType(); } else { $variableType = $this->getVariableType($variableName); $variableNativeType = $this->getNativeType($use->var); } $expressionTypes[$paramExprString] = \PHPStan\Analyser\ExpressionTypeHolder::createYes($use->var, $variableType); $nativeTypes[$paramExprString] = \PHPStan\Analyser\ExpressionTypeHolder::createYes($use->var, $variableNativeType); } foreach ($this->invalidateStaticExpressions($this->expressionTypes) as $exprString => $typeHolder) { $expr = $typeHolder->getExpr(); if ($expr instanceof Variable) { continue; } $variables = (new NodeFinder())->findInstanceOf([$expr], Variable::class); if ($variables === [] && !$this->expressionTypeIsUnchangeable($typeHolder)) { continue; } foreach ($variables as $variable) { if (!$variable instanceof Variable) { continue 2; } if (!is_string($variable->name)) { continue 2; } if (!array_key_exists($variable->name, $nonRefVariableNames)) { continue 2; } } $expressionTypes[$exprString] = $typeHolder; } if ($this->hasVariableType('this')->yes() && !$closure->static) { $node = new Variable('this'); $expressionTypes['$this'] = \PHPStan\Analyser\ExpressionTypeHolder::createYes($node, $this->getType($node)); $nativeTypes['$this'] = \PHPStan\Analyser\ExpressionTypeHolder::createYes($node, $this->getNativeType($node)); } return $this->scopeFactory->create($this->context, $this->isDeclareStrictTypes(), $this->getFunction(), $this->getNamespace(), array_merge($this->getConstantTypes(), $expressionTypes), array_merge($this->getNativeConstantTypes(), $nativeTypes), [], $this->inClosureBindScopeClasses, new TrivialParametersAcceptor(), \true, [], [], [], \false, $this, $this->nativeTypesPromoted); } private function expressionTypeIsUnchangeable(\PHPStan\Analyser\ExpressionTypeHolder $typeHolder) : bool { $expr = $typeHolder->getExpr(); $type = $typeHolder->getType(); return $expr instanceof FuncCall && !$expr->isFirstClassCallable() && $expr->name instanceof FullyQualified && $expr->name->toLowerString() === 'function_exists' && isset($expr->getArgs()[0]) && count($this->getType($expr->getArgs()[0]->value)->getConstantStrings()) === 1 && $type->isTrue()->yes(); } /** * @param array<string, ExpressionTypeHolder> $expressionTypes * @return array<string, ExpressionTypeHolder> */ private function invalidateStaticExpressions(array $expressionTypes) : array { $filteredExpressionTypes = []; $nodeFinder = new NodeFinder(); foreach ($expressionTypes as $exprString => $expressionType) { $staticExpression = $nodeFinder->findFirst([$expressionType->getExpr()], static function ($node) { return $node instanceof Expr\StaticCall || $node instanceof Expr\StaticPropertyFetch; }); if ($staticExpression !== null) { continue; } $filteredExpressionTypes[$exprString] = $expressionType; } return $filteredExpressionTypes; } /** * @api * @param ParameterReflection[]|null $callableParameters */ public function enterArrowFunction(Expr\ArrowFunction $arrowFunction, ?array $callableParameters = null) : self { $anonymousFunctionReflection = $this->getType($arrowFunction); if (!$anonymousFunctionReflection instanceof ClosureType) { throw new ShouldNotHappenException(); } $scope = $this->enterArrowFunctionWithoutReflection($arrowFunction, $callableParameters); return $this->scopeFactory->create($scope->context, $scope->isDeclareStrictTypes(), $scope->getFunction(), $scope->getNamespace(), $scope->expressionTypes, $scope->nativeExpressionTypes, $scope->conditionalExpressions, $scope->inClosureBindScopeClasses, $anonymousFunctionReflection, \true, [], [], $this->inFunctionCallsStack, $scope->afterExtractCall, $scope->parentScope, $this->nativeTypesPromoted); } /** * @param ParameterReflection[]|null $callableParameters */ private function enterArrowFunctionWithoutReflection(Expr\ArrowFunction $arrowFunction, ?array $callableParameters) : self { $arrowFunctionScope = $this; foreach ($arrowFunction->params as $i => $parameter) { if ($parameter->type === null) { $parameterType = new MixedType(); } else { $isNullable = $this->isParameterValueNullable($parameter); $parameterType = $this->getFunctionType($parameter->type, $isNullable, $parameter->variadic); } if ($callableParameters !== null) { if (isset($callableParameters[$i])) { $parameterType = self::intersectButNotNever($parameterType, $callableParameters[$i]->getType()); } elseif (count($callableParameters) > 0) { $lastParameter = $callableParameters[count($callableParameters) - 1]; if ($lastParameter->isVariadic()) { $parameterType = self::intersectButNotNever($parameterType, $lastParameter->getType()); } else { $parameterType = self::intersectButNotNever($parameterType, new MixedType()); } } else { $parameterType = self::intersectButNotNever($parameterType, new MixedType()); } } if (!$parameter->var instanceof Variable || !is_string($parameter->var->name)) { throw new ShouldNotHappenException(); } $arrowFunctionScope = $arrowFunctionScope->assignVariable($parameter->var->name, $parameterType, $parameterType); } if ($arrowFunction->static) { $arrowFunctionScope = $arrowFunctionScope->invalidateExpression(new Variable('this')); } return $this->scopeFactory->create($arrowFunctionScope->context, $this->isDeclareStrictTypes(), $arrowFunctionScope->getFunction(), $arrowFunctionScope->getNamespace(), $this->invalidateStaticExpressions($arrowFunctionScope->expressionTypes), $arrowFunctionScope->nativeExpressionTypes, $arrowFunctionScope->conditionalExpressions, $arrowFunctionScope->inClosureBindScopeClasses, new TrivialParametersAcceptor(), \true, [], [], [], $arrowFunctionScope->afterExtractCall, $arrowFunctionScope->parentScope, $this->nativeTypesPromoted); } public function isParameterValueNullable(Node\Param $parameter) : bool { if ($parameter->default instanceof ConstFetch) { return strtolower((string) $parameter->default->name) === 'null'; } return \false; } /** * @api * @param Node\Name|Node\Identifier|Node\ComplexType|null $type */ public function getFunctionType($type, bool $isNullable, bool $isVariadic) : Type { if ($isNullable) { return TypeCombinator::addNull($this->getFunctionType($type, \false, $isVariadic)); } if ($isVariadic) { if ($this->phpVersion->supportsNamedArguments()) { return new ArrayType(new UnionType([new IntegerType(), new StringType()]), $this->getFunctionType($type, \false, \false)); } return AccessoryArrayListType::intersectWith(new ArrayType(new IntegerType(), $this->getFunctionType($type, \false, \false))); } if ($type instanceof Name) { $className = (string) $type; $lowercasedClassName = strtolower($className); if ($lowercasedClassName === 'parent') { if ($this->isInClass() && $this->getClassReflection()->getParentClass() !== null) { return new ObjectType($this->getClassReflection()->getParentClass()->getName()); } return new NonexistentParentClassType(); } } return ParserNodeTypeToPHPStanType::resolve($type, $this->isInClass() ? $this->getClassReflection() : null); } private static function intersectButNotNever(Type $nativeType, Type $inferredType) : Type { if ($nativeType->isSuperTypeOf($inferredType)->no()) { return $nativeType; } $result = TypeCombinator::intersect($nativeType, $inferredType); if (TypeCombinator::containsNull($nativeType)) { return TypeCombinator::addNull($result); } return $result; } public function enterMatch(Expr\Match_ $expr) : self { if ($expr->cond instanceof Variable) { return $this; } if ($expr->cond instanceof AlwaysRememberedExpr) { $cond = $expr->cond->expr; } else { $cond = $expr->cond; } $type = $this->getType($cond); $nativeType = $this->getNativeType($cond); $condExpr = new AlwaysRememberedExpr($cond, $type, $nativeType); $expr->cond = $condExpr; return $this->assignExpression($condExpr, $type, $nativeType); } public function enterForeach(self $originalScope, Expr $iteratee, string $valueName, ?string $keyName) : self { $iterateeType = $originalScope->getType($iteratee); $nativeIterateeType = $originalScope->getNativeType($iteratee); $scope = $this->assignVariable($valueName, $originalScope->getIterableValueType($iterateeType), $originalScope->getIterableValueType($nativeIterateeType)); if ($keyName !== null) { $scope = $scope->enterForeachKey($originalScope, $iteratee, $keyName); } return $scope; } public function enterForeachKey(self $originalScope, Expr $iteratee, string $keyName) : self { $iterateeType = $originalScope->getType($iteratee); $nativeIterateeType = $originalScope->getNativeType($iteratee); $scope = $this->assignVariable($keyName, $originalScope->getIterableKeyType($iterateeType), $originalScope->getIterableKeyType($nativeIterateeType)); if ($iterateeType->isArray()->yes()) { $scope = $scope->assignExpression(new Expr\ArrayDimFetch($iteratee, new Variable($keyName)), $originalScope->getIterableValueType($iterateeType), $originalScope->getIterableValueType($nativeIterateeType)); } return $scope; } /** * @deprecated Use enterCatchType * @param Node\Name[] $classes */ public function enterCatch(array $classes, ?string $variableName) : self { $type = TypeCombinator::union(...array_map(static function (Node\Name $class) : ObjectType { return new ObjectType((string) $class); }, $classes)); return $this->enterCatchType($type, $variableName); } public function enterCatchType(Type $catchType, ?string $variableName) : self { if ($variableName === null) { return $this; } return $this->assignVariable($variableName, TypeCombinator::intersect($catchType, new ObjectType(Throwable::class)), TypeCombinator::intersect($catchType, new ObjectType(Throwable::class))); } public function enterExpressionAssign(Expr $expr) : self { $exprString = $this->getNodeKey($expr); $currentlyAssignedExpressions = $this->currentlyAssignedExpressions; $currentlyAssignedExpressions[$exprString] = \true; $scope = $this->scopeFactory->create($this->context, $this->isDeclareStrictTypes(), $this->getFunction(), $this->getNamespace(), $this->expressionTypes, $this->nativeExpressionTypes, $this->conditionalExpressions, $this->inClosureBindScopeClasses, $this->anonymousFunctionReflection, $this->isInFirstLevelStatement(), $currentlyAssignedExpressions, $this->currentlyAllowedUndefinedExpressions, [], $this->afterExtractCall, $this->parentScope, $this->nativeTypesPromoted); $scope->resolvedTypes = $this->resolvedTypes; $scope->truthyScopes = $this->truthyScopes; $scope->falseyScopes = $this->falseyScopes; return $scope; } public function exitExpressionAssign(Expr $expr) : self { $exprString = $this->getNodeKey($expr); $currentlyAssignedExpressions = $this->currentlyAssignedExpressions; unset($currentlyAssignedExpressions[$exprString]); $scope = $this->scopeFactory->create($this->context, $this->isDeclareStrictTypes(), $this->getFunction(), $this->getNamespace(), $this->expressionTypes, $this->nativeExpressionTypes, $this->conditionalExpressions, $this->inClosureBindScopeClasses, $this->anonymousFunctionReflection, $this->isInFirstLevelStatement(), $currentlyAssignedExpressions, $this->currentlyAllowedUndefinedExpressions, [], $this->afterExtractCall, $this->parentScope, $this->nativeTypesPromoted); $scope->resolvedTypes = $this->resolvedTypes; $scope->truthyScopes = $this->truthyScopes; $scope->falseyScopes = $this->falseyScopes; return $scope; } /** @api */ public function isInExpressionAssign(Expr $expr) : bool { $exprString = $this->getNodeKey($expr); return array_key_exists($exprString, $this->currentlyAssignedExpressions); } public function setAllowedUndefinedExpression(Expr $expr) : self { if ($this->phpVersion->deprecatesDynamicProperties() && $expr instanceof Expr\StaticPropertyFetch) { return $this; } $exprString = $this->getNodeKey($expr); $currentlyAllowedUndefinedExpressions = $this->currentlyAllowedUndefinedExpressions; $currentlyAllowedUndefinedExpressions[$exprString] = \true; $scope = $this->scopeFactory->create($this->context, $this->isDeclareStrictTypes(), $this->getFunction(), $this->getNamespace(), $this->expressionTypes, $this->nativeExpressionTypes, $this->conditionalExpressions, $this->inClosureBindScopeClasses, $this->anonymousFunctionReflection, $this->isInFirstLevelStatement(), $this->currentlyAssignedExpressions, $currentlyAllowedUndefinedExpressions, [], $this->afterExtractCall, $this->parentScope, $this->nativeTypesPromoted); $scope->resolvedTypes = $this->resolvedTypes; $scope->truthyScopes = $this->truthyScopes; $scope->falseyScopes = $this->falseyScopes; return $scope; } public function unsetAllowedUndefinedExpression(Expr $expr) : self { $exprString = $this->getNodeKey($expr); $currentlyAllowedUndefinedExpressions = $this->currentlyAllowedUndefinedExpressions; unset($currentlyAllowedUndefinedExpressions[$exprString]); $scope = $this->scopeFactory->create($this->context, $this->isDeclareStrictTypes(), $this->getFunction(), $this->getNamespace(), $this->expressionTypes, $this->nativeExpressionTypes, $this->conditionalExpressions, $this->inClosureBindScopeClasses, $this->anonymousFunctionReflection, $this->isInFirstLevelStatement(), $this->currentlyAssignedExpressions, $currentlyAllowedUndefinedExpressions, [], $this->afterExtractCall, $this->parentScope, $this->nativeTypesPromoted); $scope->resolvedTypes = $this->resolvedTypes; $scope->truthyScopes = $this->truthyScopes; $scope->falseyScopes = $this->falseyScopes; return $scope; } /** @api */ public function isUndefinedExpressionAllowed(Expr $expr) : bool { $exprString = $this->getNodeKey($expr); return array_key_exists($exprString, $this->currentlyAllowedUndefinedExpressions); } public function assignVariable(string $variableName, Type $type, Type $nativeType, ?TrinaryLogic $certainty = null) : self { $node = new Variable($variableName); $scope = $this->assignExpression($node, $type, $nativeType); if ($certainty !== null) { if ($certainty->no()) { throw new ShouldNotHappenException(); } elseif (!$certainty->yes()) { $exprString = '$' . $variableName; $scope->expressionTypes[$exprString] = new \PHPStan\Analyser\ExpressionTypeHolder($node, $type, $certainty); $scope->nativeExpressionTypes[$exprString] = new \PHPStan\Analyser\ExpressionTypeHolder($node, $nativeType, $certainty); } } $parameterOriginalValueExprString = $this->getNodeKey(new ParameterVariableOriginalValueExpr($variableName)); unset($scope->expressionTypes[$parameterOriginalValueExprString]); unset($scope->nativeExpressionTypes[$parameterOriginalValueExprString]); return $scope; } public function unsetExpression(Expr $expr) : self { $scope = $this; if ($expr instanceof Expr\ArrayDimFetch && $expr->dim !== null) { $exprVarType = $scope->getType($expr->var); $dimType = $scope->getType($expr->dim); $unsetType = $exprVarType->unsetOffset($dimType); $exprVarNativeType = $scope->getNativeType($expr->var); $dimNativeType = $scope->getNativeType($expr->dim); $unsetNativeType = $exprVarNativeType->unsetOffset($dimNativeType); $scope = $scope->assignExpression($expr->var, $unsetType, $unsetNativeType)->invalidateExpression(new FuncCall(new FullyQualified('count'), [new Arg($expr->var)]))->invalidateExpression(new FuncCall(new FullyQualified('sizeof'), [new Arg($expr->var)]))->invalidateExpression(new FuncCall(new Name('count'), [new Arg($expr->var)]))->invalidateExpression(new FuncCall(new Name('sizeof'), [new Arg($expr->var)])); if ($expr->var instanceof Expr\ArrayDimFetch && $expr->var->dim !== null) { $scope = $scope->assignExpression($expr->var->var, $this->getType($expr->var->var)->setOffsetValueType($scope->getType($expr->var->dim), $scope->getType($expr->var)), $this->getNativeType($expr->var->var)->setOffsetValueType($scope->getNativeType($expr->var->dim), $scope->getNativeType($expr->var))); } } return $scope->invalidateExpression($expr); } public function specifyExpressionType(Expr $expr, Type $type, Type $nativeType, ?TrinaryLogic $certainty = null) : self { if ($expr instanceof ConstFetch) { $loweredConstName = strtolower($expr->name->toString()); if (in_array($loweredConstName, ['true', 'false', 'null'], \true)) { return $this; } } if ($expr instanceof FuncCall && $expr->name instanceof Name && $type->isFalse()->yes()) { $functionName = $this->reflectionProvider->resolveFunctionName($expr->name, $this); if ($functionName !== null && in_array(strtolower($functionName), ['is_dir', 'is_file', 'file_exists'], \true)) { return $this; } } $scope = $this; if ($expr instanceof Expr\ArrayDimFetch && $expr->dim !== null) { $dimType = $scope->getType($expr->dim)->toArrayKey(); if ($dimType instanceof ConstantIntegerType || $dimType instanceof ConstantStringType) { $exprVarType = $scope->getType($expr->var); if (!$exprVarType instanceof MixedType && !$exprVarType->isArray()->no()) { $types = [new ArrayType(new MixedType(), new MixedType()), new ObjectType(ArrayAccess::class), new NullType()]; if ($dimType instanceof ConstantIntegerType) { $types[] = new StringType(); } $scope = $scope->specifyExpressionType($expr->var, TypeCombinator::intersect(TypeCombinator::intersect($exprVarType, TypeCombinator::union(...$types)), new HasOffsetValueType($dimType, $type)), $scope->getNativeType($expr->var), $certainty); } } } if ($certainty === null) { $certainty = TrinaryLogic::createYes(); } elseif ($certainty->no()) { throw new ShouldNotHappenException(); } $exprString = $this->getNodeKey($expr); $expressionTypes = $scope->expressionTypes; $expressionTypes[$exprString] = new \PHPStan\Analyser\ExpressionTypeHolder($expr, $type, $certainty); $nativeTypes = $scope->nativeExpressionTypes; $nativeTypes[$exprString] = new \PHPStan\Analyser\ExpressionTypeHolder($expr, $nativeType, $certainty); $scope = $this->scopeFactory->create($this->context, $this->isDeclareStrictTypes(), $this->getFunction(), $this->getNamespace(), $expressionTypes, $nativeTypes, $this->conditionalExpressions, $this->inClosureBindScopeClasses, $this->anonymousFunctionReflection, $this->inFirstLevelStatement, $this->currentlyAssignedExpressions, $this->currentlyAllowedUndefinedExpressions, $this->inFunctionCallsStack, $this->afterExtractCall, $this->parentScope, $this->nativeTypesPromoted); if ($expr instanceof AlwaysRememberedExpr) { return $scope->specifyExpressionType($expr->expr, $type, $nativeType, $certainty); } return $scope; } public function assignExpression(Expr $expr, Type $type, ?Type $nativeType = null) : self { if ($nativeType === null) { $nativeType = new MixedType(); } $scope = $this; if ($expr instanceof PropertyFetch) { $scope = $this->invalidateExpression($expr)->invalidateMethodsOnExpression($expr->var); } elseif ($expr instanceof Expr\StaticPropertyFetch) { $scope = $this->invalidateExpression($expr); } elseif ($expr instanceof Variable) { $scope = $this->invalidateExpression($expr); } return $scope->specifyExpressionType($expr, $type, $nativeType); } public function assignInitializedProperty(Type $fetchedOnType, string $propertyName) : self { if (!$this->isInClass()) { return $this; } if (TypeUtils::findThisType($fetchedOnType) === null) { return $this; } $propertyReflection = $this->getPropertyReflection($fetchedOnType, $propertyName); if ($propertyReflection === null) { return $this; } $declaringClass = $propertyReflection->getDeclaringClass(); if ($this->getClassReflection()->getName() !== $declaringClass->getName()) { return $this; } if (!$declaringClass->hasNativeProperty($propertyName)) { return $this; } return $this->assignExpression(new PropertyInitializationExpr($propertyName), new MixedType(), new MixedType()); } public function invalidateExpression(Expr $expressionToInvalidate, bool $requireMoreCharacters = \false) : self { $expressionTypes = $this->expressionTypes; $nativeExpressionTypes = $this->nativeExpressionTypes; $invalidated = \false; $exprStringToInvalidate = $this->getNodeKey($expressionToInvalidate); foreach ($expressionTypes as $exprString => $exprTypeHolder) { $exprExpr = $exprTypeHolder->getExpr(); if (!$this->shouldInvalidateExpression($exprStringToInvalidate, $expressionToInvalidate, $exprExpr, $requireMoreCharacters)) { continue; } unset($expressionTypes[$exprString]); unset($nativeExpressionTypes[$exprString]); $invalidated = \true; } $newConditionalExpressions = []; foreach ($this->conditionalExpressions as $conditionalExprString => $holders) { if (count($holders) === 0) { continue; } if ($this->shouldInvalidateExpression($exprStringToInvalidate, $expressionToInvalidate, $holders[array_key_first($holders)]->getTypeHolder()->getExpr())) { $invalidated = \true; continue; } foreach ($holders as $holder) { $conditionalTypeHolders = $holder->getConditionExpressionTypeHolders(); foreach ($conditionalTypeHolders as $conditionalTypeHolder) { if ($this->shouldInvalidateExpression($exprStringToInvalidate, $expressionToInvalidate, $conditionalTypeHolder->getExpr())) { $invalidated = \true; continue 3; } } } $newConditionalExpressions[$conditionalExprString] = $holders; } if (!$invalidated) { return $this; } return $this->scopeFactory->create($this->context, $this->isDeclareStrictTypes(), $this->getFunction(), $this->getNamespace(), $expressionTypes, $nativeExpressionTypes, $newConditionalExpressions, $this->inClosureBindScopeClasses, $this->anonymousFunctionReflection, $this->inFirstLevelStatement, $this->currentlyAssignedExpressions, $this->currentlyAllowedUndefinedExpressions, [], $this->afterExtractCall, $this->parentScope, $this->nativeTypesPromoted); } private function shouldInvalidateExpression(string $exprStringToInvalidate, Expr $exprToInvalidate, Expr $expr, bool $requireMoreCharacters = \false) : bool { if ($requireMoreCharacters && $exprStringToInvalidate === $this->getNodeKey($expr)) { return \false; } // Variables will not contain traversable expressions. skip the NodeFinder overhead if ($expr instanceof Variable && is_string($expr->name) && !$requireMoreCharacters) { return $exprStringToInvalidate === $this->getNodeKey($expr); } $nodeFinder = new NodeFinder(); $expressionToInvalidateClass = get_class($exprToInvalidate); $found = $nodeFinder->findFirst([$expr], function (Node $node) use($expressionToInvalidateClass, $exprStringToInvalidate) : bool { if (!$node instanceof $expressionToInvalidateClass) { return \false; } $nodeString = $this->getNodeKey($node); return $nodeString === $exprStringToInvalidate; }); if ($found === null) { return \false; } if ($this->phpVersion->supportsReadOnlyProperties() && $expr instanceof PropertyFetch && $expr->name instanceof Node\Identifier && $requireMoreCharacters) { $propertyReflection = $this->propertyReflectionFinder->findPropertyReflectionFromNode($expr, $this); if ($propertyReflection !== null) { $nativePropertyReflection = $propertyReflection->getNativeReflection(); if ($nativePropertyReflection !== null && $nativePropertyReflection->isReadOnly()) { return \false; } } } return \true; } private function invalidateMethodsOnExpression(Expr $expressionToInvalidate) : self { $exprStringToInvalidate = $this->getNodeKey($expressionToInvalidate); $expressionTypes = $this->expressionTypes; $nativeExpressionTypes = $this->nativeExpressionTypes; $invalidated = \false; $nodeFinder = new NodeFinder(); foreach ($expressionTypes as $exprString => $exprTypeHolder) { $expr = $exprTypeHolder->getExpr(); $found = $nodeFinder->findFirst([$expr], function (Node $node) use($exprStringToInvalidate) : bool { if (!$node instanceof MethodCall) { return \false; } return $this->getNodeKey($node->var) === $exprStringToInvalidate; }); if ($found === null) { continue; } unset($expressionTypes[$exprString]); unset($nativeExpressionTypes[$exprString]); $invalidated = \true; } if (!$invalidated) { return $this; } return $this->scopeFactory->create($this->context, $this->isDeclareStrictTypes(), $this->getFunction(), $this->getNamespace(), $expressionTypes, $nativeExpressionTypes, $this->conditionalExpressions, $this->inClosureBindScopeClasses, $this->anonymousFunctionReflection, $this->inFirstLevelStatement, $this->currentlyAssignedExpressions, $this->currentlyAllowedUndefinedExpressions, [], $this->afterExtractCall, $this->parentScope, $this->nativeTypesPromoted); } private function setExpressionCertainty(Expr $expr, TrinaryLogic $certainty) : self { if ($this->hasExpressionType($expr)->no()) { throw new ShouldNotHappenException(); } $originalExprType = $this->getType($expr); $nativeType = $this->getNativeType($expr); return $this->specifyExpressionType($expr, $originalExprType, $nativeType, $certainty); } public function addTypeToExpression(Expr $expr, Type $type) : self { $originalExprType = $this->getType($expr); $nativeType = $this->getNativeType($expr); if ($originalExprType->equals($nativeType)) { $newType = TypeCombinator::intersect($type, $originalExprType); return $this->specifyExpressionType($expr, $newType, $newType); } return $this->specifyExpressionType($expr, TypeCombinator::intersect($type, $originalExprType), TypeCombinator::intersect($type, $nativeType)); } public function removeTypeFromExpression(Expr $expr, Type $typeToRemove) : self { $exprType = $this->getType($expr); if ($exprType instanceof NeverType || $typeToRemove instanceof NeverType) { return $this; } return $this->specifyExpressionType($expr, TypeCombinator::remove($exprType, $typeToRemove), TypeCombinator::remove($this->getNativeType($expr), $typeToRemove)); } /** * @api * @return MutatingScope */ public function filterByTruthyValue(Expr $expr) : \PHPStan\Analyser\Scope { $exprString = $this->getNodeKey($expr); if (array_key_exists($exprString, $this->truthyScopes)) { return $this->truthyScopes[$exprString]; } $specifiedTypes = $this->typeSpecifier->specifyTypesInCondition($this, $expr, \PHPStan\Analyser\TypeSpecifierContext::createTruthy()); $scope = $this->filterBySpecifiedTypes($specifiedTypes); $this->truthyScopes[$exprString] = $scope; return $scope; } /** * @api * @return MutatingScope */ public function filterByFalseyValue(Expr $expr) : \PHPStan\Analyser\Scope { $exprString = $this->getNodeKey($expr); if (array_key_exists($exprString, $this->falseyScopes)) { return $this->falseyScopes[$exprString]; } $specifiedTypes = $this->typeSpecifier->specifyTypesInCondition($this, $expr, \PHPStan\Analyser\TypeSpecifierContext::createFalsey()); $scope = $this->filterBySpecifiedTypes($specifiedTypes); $this->falseyScopes[$exprString] = $scope; return $scope; } public function filterBySpecifiedTypes(\PHPStan\Analyser\SpecifiedTypes $specifiedTypes) : self { $typeSpecifications = []; foreach ($specifiedTypes->getSureTypes() as $exprString => [$expr, $type]) { if ($expr instanceof Node\Scalar || $expr instanceof Array_ || $expr instanceof Expr\UnaryMinus && $expr->expr instanceof Node\Scalar) { continue; } $typeSpecifications[] = ['sure' => \true, 'exprString' => (string) $exprString, 'expr' => $expr, 'type' => $type]; } foreach ($specifiedTypes->getSureNotTypes() as $exprString => [$expr, $type]) { if ($expr instanceof Node\Scalar || $expr instanceof Array_ || $expr instanceof Expr\UnaryMinus && $expr->expr instanceof Node\Scalar) { continue; } $typeSpecifications[] = ['sure' => \false, 'exprString' => (string) $exprString, 'expr' => $expr, 'type' => $type]; } usort($typeSpecifications, static function (array $a, array $b) : int { $length = strlen($a['exprString']) - strlen($b['exprString']); if ($length !== 0) { return $length; } return $b['sure'] - $a['sure']; // @phpstan-ignore minus.leftNonNumeric, minus.rightNonNumeric }); $scope = $this; $specifiedExpressions = []; foreach ($typeSpecifications as $typeSpecification) { $expr = $typeSpecification['expr']; $type = $typeSpecification['type']; if ($expr instanceof IssetExpr) { $issetExpr = $expr; $expr = $issetExpr->getExpr(); if ($typeSpecification['sure']) { $scope = $scope->setExpressionCertainty($expr, TrinaryLogic::createMaybe()); } else { $scope = $scope->unsetExpression($expr); } continue; } if ($typeSpecification['sure']) { if ($specifiedTypes->shouldOverwrite()) { $scope = $scope->assignExpression($expr, $type, $type); } else { $scope = $scope->addTypeToExpression($expr, $type); } } else { $scope = $scope->removeTypeFromExpression($expr, $type); } $specifiedExpressions[$this->getNodeKey($expr)] = \PHPStan\Analyser\ExpressionTypeHolder::createYes($expr, $scope->getType($expr)); } $conditions = []; foreach ($scope->conditionalExpressions as $conditionalExprString => $conditionalExpressions) { foreach ($conditionalExpressions as $conditionalExpression) { foreach ($conditionalExpression->getConditionExpressionTypeHolders() as $holderExprString => $conditionalTypeHolder) { if (!array_key_exists($holderExprString, $specifiedExpressions) || !$specifiedExpressions[$holderExprString]->equals($conditionalTypeHolder)) { continue 2; } } $conditions[$conditionalExprString][] = $conditionalExpression; $specifiedExpressions[$conditionalExprString] = $conditionalExpression->getTypeHolder(); } } foreach ($conditions as $conditionalExprString => $expressions) { $certainty = TrinaryLogic::lazyExtremeIdentity($expressions, static function (\PHPStan\Analyser\ConditionalExpressionHolder $holder) { return $holder->getTypeHolder()->getCertainty(); }); if ($certainty->no()) { unset($scope->expressionTypes[$conditionalExprString]); } else { $type = TypeCombinator::intersect(...array_map(static function (\PHPStan\Analyser\ConditionalExpressionHolder $holder) { return $holder->getTypeHolder()->getType(); }, $expressions)); $scope->expressionTypes[$conditionalExprString] = array_key_exists($conditionalExprString, $scope->expressionTypes) ? new \PHPStan\Analyser\ExpressionTypeHolder($scope->expressionTypes[$conditionalExprString]->getExpr(), TypeCombinator::intersect($scope->expressionTypes[$conditionalExprString]->getType(), $type), TrinaryLogic::maxMin($scope->expressionTypes[$conditionalExprString]->getCertainty(), $certainty)) : $expressions[0]->getTypeHolder(); } } return $scope->scopeFactory->create($scope->context, $scope->isDeclareStrictTypes(), $scope->getFunction(), $scope->getNamespace(), $scope->expressionTypes, $scope->nativeExpressionTypes, array_merge($specifiedTypes->getNewConditionalExpressionHolders(), $scope->conditionalExpressions), $scope->inClosureBindScopeClasses, $scope->anonymousFunctionReflection, $scope->inFirstLevelStatement, $scope->currentlyAssignedExpressions, $scope->currentlyAllowedUndefinedExpressions, $scope->inFunctionCallsStack, $scope->afterExtractCall, $scope->parentScope, $scope->nativeTypesPromoted); } /** * @param ConditionalExpressionHolder[] $conditionalExpressionHolders */ public function addConditionalExpressions(string $exprString, array $conditionalExpressionHolders) : self { $conditionalExpressions = $this->conditionalExpressions; $conditionalExpressions[$exprString] = $conditionalExpressionHolders; return $this->scopeFactory->create($this->context, $this->isDeclareStrictTypes(), $this->getFunction(), $this->getNamespace(), $this->expressionTypes, $this->nativeExpressionTypes, $conditionalExpressions, $this->inClosureBindScopeClasses, $this->anonymousFunctionReflection, $this->inFirstLevelStatement, $this->currentlyAssignedExpressions, $this->currentlyAllowedUndefinedExpressions, $this->inFunctionCallsStack, $this->afterExtractCall, $this->parentScope, $this->nativeTypesPromoted); } public function exitFirstLevelStatements() : self { if (!$this->inFirstLevelStatement) { return $this; } if ($this->scopeOutOfFirstLevelStatement !== null) { return $this->scopeOutOfFirstLevelStatement; } $scope = $this->scopeFactory->create($this->context, $this->isDeclareStrictTypes(), $this->getFunction(), $this->getNamespace(), $this->expressionTypes, $this->nativeExpressionTypes, $this->conditionalExpressions, $this->inClosureBindScopeClasses, $this->anonymousFunctionReflection, \false, $this->currentlyAssignedExpressions, $this->currentlyAllowedUndefinedExpressions, $this->inFunctionCallsStack, $this->afterExtractCall, $this->parentScope, $this->nativeTypesPromoted); $scope->resolvedTypes = $this->resolvedTypes; $scope->truthyScopes = $this->truthyScopes; $scope->falseyScopes = $this->falseyScopes; $this->scopeOutOfFirstLevelStatement = $scope; return $scope; } /** @api */ public function isInFirstLevelStatement() : bool { return $this->inFirstLevelStatement; } public function mergeWith(?self $otherScope) : self { if ($otherScope === null) { return $this; } $ourExpressionTypes = $this->expressionTypes; $theirExpressionTypes = $otherScope->expressionTypes; $mergedExpressionTypes = $this->mergeVariableHolders($ourExpressionTypes, $theirExpressionTypes); $conditionalExpressions = $this->intersectConditionalExpressions($otherScope->conditionalExpressions); $conditionalExpressions = $this->createConditionalExpressions($conditionalExpressions, $ourExpressionTypes, $theirExpressionTypes, $mergedExpressionTypes); $conditionalExpressions = $this->createConditionalExpressions($conditionalExpressions, $theirExpressionTypes, $ourExpressionTypes, $mergedExpressionTypes); return $this->scopeFactory->create($this->context, $this->isDeclareStrictTypes(), $this->getFunction(), $this->getNamespace(), $mergedExpressionTypes, $this->mergeVariableHolders($this->nativeExpressionTypes, $otherScope->nativeExpressionTypes), $conditionalExpressions, $this->inClosureBindScopeClasses, $this->anonymousFunctionReflection, $this->inFirstLevelStatement, [], [], [], $this->afterExtractCall && $otherScope->afterExtractCall, $this->parentScope, $this->nativeTypesPromoted); } /** * @param array<string, ConditionalExpressionHolder[]> $otherConditionalExpressions * @return array<string, ConditionalExpressionHolder[]> */ private function intersectConditionalExpressions(array $otherConditionalExpressions) : array { $newConditionalExpressions = []; foreach ($this->conditionalExpressions as $exprString => $holders) { if (!array_key_exists($exprString, $otherConditionalExpressions)) { continue; } $otherHolders = $otherConditionalExpressions[$exprString]; foreach (array_keys($holders) as $key) { if (!array_key_exists($key, $otherHolders)) { continue 2; } } $newConditionalExpressions[$exprString] = $holders; } return $newConditionalExpressions; } /** * @param array<string, ConditionalExpressionHolder[]> $conditionalExpressions * @param array<string, ExpressionTypeHolder> $ourExpressionTypes * @param array<string, ExpressionTypeHolder> $theirExpressionTypes * @param array<string, ExpressionTypeHolder> $mergedExpressionTypes * @return array<string, ConditionalExpressionHolder[]> */ private function createConditionalExpressions(array $conditionalExpressions, array $ourExpressionTypes, array $theirExpressionTypes, array $mergedExpressionTypes) : array { $newVariableTypes = $ourExpressionTypes; foreach ($theirExpressionTypes as $exprString => $holder) { if (!array_key_exists($exprString, $mergedExpressionTypes)) { continue; } if (!$mergedExpressionTypes[$exprString]->getType()->equals($holder->getType())) { continue; } unset($newVariableTypes[$exprString]); } $typeGuards = []; foreach ($newVariableTypes as $exprString => $holder) { if (!$holder->getCertainty()->yes()) { continue; } if (!array_key_exists($exprString, $mergedExpressionTypes)) { continue; } if ($mergedExpressionTypes[$exprString]->getType()->equals($holder->getType())) { continue; } $typeGuards[$exprString] = $holder; } if (count($typeGuards) === 0) { return $conditionalExpressions; } foreach ($newVariableTypes as $exprString => $holder) { if (array_key_exists($exprString, $mergedExpressionTypes) && $mergedExpressionTypes[$exprString]->equals($holder)) { continue; } $variableTypeGuards = $typeGuards; unset($variableTypeGuards[$exprString]); if (count($variableTypeGuards) === 0) { continue; } $conditionalExpression = new \PHPStan\Analyser\ConditionalExpressionHolder($variableTypeGuards, $holder); $conditionalExpressions[$exprString][$conditionalExpression->getKey()] = $conditionalExpression; } foreach ($mergedExpressionTypes as $exprString => $mergedExprTypeHolder) { if (array_key_exists($exprString, $ourExpressionTypes)) { continue; } $conditionalExpression = new \PHPStan\Analyser\ConditionalExpressionHolder($typeGuards, new \PHPStan\Analyser\ExpressionTypeHolder($mergedExprTypeHolder->getExpr(), new ErrorType(), TrinaryLogic::createNo())); $conditionalExpressions[$exprString][$conditionalExpression->getKey()] = $conditionalExpression; } return $conditionalExpressions; } /** * @param array<string, ExpressionTypeHolder> $ourVariableTypeHolders * @param array<string, ExpressionTypeHolder> $theirVariableTypeHolders * @return array<string, ExpressionTypeHolder> */ private function mergeVariableHolders(array $ourVariableTypeHolders, array $theirVariableTypeHolders) : array { $intersectedVariableTypeHolders = []; foreach ($ourVariableTypeHolders as $exprString => $variableTypeHolder) { if (isset($theirVariableTypeHolders[$exprString])) { $intersectedVariableTypeHolders[$exprString] = $variableTypeHolder->and($theirVariableTypeHolders[$exprString]); } else { $intersectedVariableTypeHolders[$exprString] = \PHPStan\Analyser\ExpressionTypeHolder::createMaybe($variableTypeHolder->getExpr(), $variableTypeHolder->getType()); } } foreach ($theirVariableTypeHolders as $exprString => $variableTypeHolder) { if (isset($intersectedVariableTypeHolders[$exprString])) { continue; } $intersectedVariableTypeHolders[$exprString] = \PHPStan\Analyser\ExpressionTypeHolder::createMaybe($variableTypeHolder->getExpr(), $variableTypeHolder->getType()); } return $intersectedVariableTypeHolders; } public function mergeInitializedProperties(self $calledMethodScope) : self { $scope = $this; foreach ($calledMethodScope->expressionTypes as $exprString => $typeHolder) { $exprString = (string) $exprString; if (!str_starts_with($exprString, '__phpstanPropertyInitialization(')) { continue; } $propertyName = substr($exprString, strlen('__phpstanPropertyInitialization('), -1); $propertyExpr = new PropertyInitializationExpr($propertyName); if (!array_key_exists($exprString, $scope->expressionTypes)) { $scope = $scope->assignExpression($propertyExpr, new MixedType(), new MixedType()); $scope->expressionTypes[$exprString] = $typeHolder; continue; } $certainty = $scope->expressionTypes[$exprString]->getCertainty(); $scope = $scope->assignExpression($propertyExpr, new MixedType(), new MixedType()); $scope->expressionTypes[$exprString] = new \PHPStan\Analyser\ExpressionTypeHolder($typeHolder->getExpr(), $typeHolder->getType(), $typeHolder->getCertainty()->or($certainty)); } return $scope; } public function processFinallyScope(self $finallyScope, self $originalFinallyScope) : self { return $this->scopeFactory->create($this->context, $this->isDeclareStrictTypes(), $this->getFunction(), $this->getNamespace(), $this->processFinallyScopeVariableTypeHolders($this->expressionTypes, $finallyScope->expressionTypes, $originalFinallyScope->expressionTypes), $this->processFinallyScopeVariableTypeHolders($this->nativeExpressionTypes, $finallyScope->nativeExpressionTypes, $originalFinallyScope->nativeExpressionTypes), $this->conditionalExpressions, $this->inClosureBindScopeClasses, $this->anonymousFunctionReflection, $this->inFirstLevelStatement, [], [], [], $this->afterExtractCall, $this->parentScope, $this->nativeTypesPromoted); } /** * @param array<string, ExpressionTypeHolder> $ourVariableTypeHolders * @param array<string, ExpressionTypeHolder> $finallyVariableTypeHolders * @param array<string, ExpressionTypeHolder> $originalVariableTypeHolders * @return array<string, ExpressionTypeHolder> */ private function processFinallyScopeVariableTypeHolders(array $ourVariableTypeHolders, array $finallyVariableTypeHolders, array $originalVariableTypeHolders) : array { foreach ($finallyVariableTypeHolders as $exprString => $variableTypeHolder) { if (isset($originalVariableTypeHolders[$exprString]) && !$originalVariableTypeHolders[$exprString]->getType()->equals($variableTypeHolder->getType())) { $ourVariableTypeHolders[$exprString] = $variableTypeHolder; continue; } if (isset($originalVariableTypeHolders[$exprString])) { continue; } $ourVariableTypeHolders[$exprString] = $variableTypeHolder; } return $ourVariableTypeHolders; } /** * @param Expr\ClosureUse[] $byRefUses */ public function processClosureScope(self $closureScope, ?self $prevScope, array $byRefUses) : self { $nativeExpressionTypes = $this->nativeExpressionTypes; $expressionTypes = $this->expressionTypes; if (count($byRefUses) === 0) { return $this; } foreach ($byRefUses as $use) { if (!is_string($use->var->name)) { throw new ShouldNotHappenException(); } $variableName = $use->var->name; $variableExprString = '$' . $variableName; if (!$closureScope->hasVariableType($variableName)->yes()) { $holder = \PHPStan\Analyser\ExpressionTypeHolder::createYes($use->var, new NullType()); $expressionTypes[$variableExprString] = $holder; $nativeExpressionTypes[$variableExprString] = $holder; continue; } $variableType = $closureScope->getVariableType($variableName); if ($prevScope !== null) { $prevVariableType = $prevScope->getVariableType($variableName); if (!$variableType->equals($prevVariableType)) { $variableType = TypeCombinator::union($variableType, $prevVariableType); $variableType = self::generalizeType($variableType, $prevVariableType, 0); } } $expressionTypes[$variableExprString] = \PHPStan\Analyser\ExpressionTypeHolder::createYes($use->var, $variableType); $nativeExpressionTypes[$variableExprString] = \PHPStan\Analyser\ExpressionTypeHolder::createYes($use->var, $variableType); } return $this->scopeFactory->create($this->context, $this->isDeclareStrictTypes(), $this->getFunction(), $this->getNamespace(), $expressionTypes, $nativeExpressionTypes, $this->conditionalExpressions, $this->inClosureBindScopeClasses, $this->anonymousFunctionReflection, $this->inFirstLevelStatement, [], [], $this->inFunctionCallsStack, $this->afterExtractCall, $this->parentScope, $this->nativeTypesPromoted); } public function processAlwaysIterableForeachScopeWithoutPollute(self $finalScope) : self { $expressionTypes = $this->expressionTypes; foreach ($finalScope->expressionTypes as $variableExprString => $variableTypeHolder) { if (!isset($expressionTypes[$variableExprString])) { $expressionTypes[$variableExprString] = \PHPStan\Analyser\ExpressionTypeHolder::createMaybe($variableTypeHolder->getExpr(), $variableTypeHolder->getType()); continue; } $expressionTypes[$variableExprString] = new \PHPStan\Analyser\ExpressionTypeHolder($variableTypeHolder->getExpr(), $variableTypeHolder->getType(), $variableTypeHolder->getCertainty()->and($expressionTypes[$variableExprString]->getCertainty())); } $nativeTypes = $this->nativeExpressionTypes; foreach ($finalScope->nativeExpressionTypes as $variableExprString => $variableTypeHolder) { if (!isset($nativeTypes[$variableExprString])) { $nativeTypes[$variableExprString] = \PHPStan\Analyser\ExpressionTypeHolder::createMaybe($variableTypeHolder->getExpr(), $variableTypeHolder->getType()); continue; } $nativeTypes[$variableExprString] = new \PHPStan\Analyser\ExpressionTypeHolder($variableTypeHolder->getExpr(), $variableTypeHolder->getType(), $variableTypeHolder->getCertainty()->and($nativeTypes[$variableExprString]->getCertainty())); } return $this->scopeFactory->create($this->context, $this->isDeclareStrictTypes(), $this->getFunction(), $this->getNamespace(), $expressionTypes, $nativeTypes, $this->conditionalExpressions, $this->inClosureBindScopeClasses, $this->anonymousFunctionReflection, $this->inFirstLevelStatement, [], [], [], $this->afterExtractCall, $this->parentScope, $this->nativeTypesPromoted); } public function generalizeWith(self $otherScope) : self { $variableTypeHolders = $this->generalizeVariableTypeHolders($this->expressionTypes, $otherScope->expressionTypes); $nativeTypes = $this->generalizeVariableTypeHolders($this->nativeExpressionTypes, $otherScope->nativeExpressionTypes); return $this->scopeFactory->create($this->context, $this->isDeclareStrictTypes(), $this->getFunction(), $this->getNamespace(), $variableTypeHolders, $nativeTypes, $this->conditionalExpressions, $this->inClosureBindScopeClasses, $this->anonymousFunctionReflection, $this->inFirstLevelStatement, [], [], [], $this->afterExtractCall, $this->parentScope, $this->nativeTypesPromoted); } /** * @param array<string, ExpressionTypeHolder> $variableTypeHolders * @param array<string, ExpressionTypeHolder> $otherVariableTypeHolders * @return array<string, ExpressionTypeHolder> */ private function generalizeVariableTypeHolders(array $variableTypeHolders, array $otherVariableTypeHolders) : array { foreach ($variableTypeHolders as $variableExprString => $variableTypeHolder) { if (!isset($otherVariableTypeHolders[$variableExprString])) { continue; } $variableTypeHolders[$variableExprString] = new \PHPStan\Analyser\ExpressionTypeHolder($variableTypeHolder->getExpr(), self::generalizeType($variableTypeHolder->getType(), $otherVariableTypeHolders[$variableExprString]->getType(), 0), $variableTypeHolder->getCertainty()); } return $variableTypeHolders; } private static function generalizeType(Type $a, Type $b, int $depth) : Type { if ($a->equals($b)) { return $a; } $constantIntegers = ['a' => [], 'b' => []]; $constantFloats = ['a' => [], 'b' => []]; $constantBooleans = ['a' => [], 'b' => []]; $constantStrings = ['a' => [], 'b' => []]; $constantArrays = ['a' => [], 'b' => []]; $generalArrays = ['a' => [], 'b' => []]; $integerRanges = ['a' => [], 'b' => []]; $otherTypes = []; foreach (['a' => TypeUtils::flattenTypes($a), 'b' => TypeUtils::flattenTypes($b)] as $key => $types) { foreach ($types as $type) { if ($type instanceof ConstantIntegerType) { $constantIntegers[$key][] = $type; continue; } if ($type instanceof ConstantFloatType) { $constantFloats[$key][] = $type; continue; } if ($type instanceof ConstantBooleanType) { $constantBooleans[$key][] = $type; continue; } if ($type instanceof ConstantStringType) { $constantStrings[$key][] = $type; continue; } if ($type->isConstantArray()->yes()) { $constantArrays[$key][] = $type; continue; } if ($type->isArray()->yes()) { $generalArrays[$key][] = $type; continue; } if ($type instanceof IntegerRangeType) { $integerRanges[$key][] = $type; continue; } $otherTypes[] = $type; } } $resultTypes = []; foreach ([$constantFloats, $constantBooleans, $constantStrings] as $constantTypes) { if (count($constantTypes['a']) === 0) { if (count($constantTypes['b']) > 0) { $resultTypes[] = TypeCombinator::union(...$constantTypes['b']); } continue; } elseif (count($constantTypes['b']) === 0) { $resultTypes[] = TypeCombinator::union(...$constantTypes['a']); continue; } $aTypes = TypeCombinator::union(...$constantTypes['a']); $bTypes = TypeCombinator::union(...$constantTypes['b']); if ($aTypes->equals($bTypes)) { $resultTypes[] = $aTypes; continue; } $resultTypes[] = TypeCombinator::union(...$constantTypes['a'], ...$constantTypes['b'])->generalize(GeneralizePrecision::moreSpecific()); } if (count($constantArrays['a']) > 0) { if (count($constantArrays['b']) === 0) { $resultTypes[] = TypeCombinator::union(...$constantArrays['a']); } else { $constantArraysA = TypeCombinator::union(...$constantArrays['a']); $constantArraysB = TypeCombinator::union(...$constantArrays['b']); if ($constantArraysA->getIterableKeyType()->equals($constantArraysB->getIterableKeyType()) && $constantArraysA->getArraySize()->getGreaterOrEqualType()->isSuperTypeOf($constantArraysB->getArraySize())->yes()) { $resultArrayBuilder = ConstantArrayTypeBuilder::createEmpty(); foreach (TypeUtils::flattenTypes($constantArraysA->getIterableKeyType()) as $keyType) { $resultArrayBuilder->setOffsetValueType($keyType, self::generalizeType($constantArraysA->getOffsetValueType($keyType), $constantArraysB->getOffsetValueType($keyType), $depth + 1), !$constantArraysA->hasOffsetValueType($keyType)->and($constantArraysB->hasOffsetValueType($keyType))->negate()->no()); } $resultTypes[] = $resultArrayBuilder->getArray(); } else { $resultType = new ArrayType(TypeCombinator::union(self::generalizeType($constantArraysA->getIterableKeyType(), $constantArraysB->getIterableKeyType(), $depth + 1)), TypeCombinator::union(self::generalizeType($constantArraysA->getIterableValueType(), $constantArraysB->getIterableValueType(), $depth + 1))); if ($constantArraysA->isIterableAtLeastOnce()->yes() && $constantArraysB->isIterableAtLeastOnce()->yes() && $constantArraysA->getArraySize()->getGreaterOrEqualType()->isSuperTypeOf($constantArraysB->getArraySize())->yes()) { $resultType = TypeCombinator::intersect($resultType, new NonEmptyArrayType()); } if ($constantArraysA->isList()->yes() && $constantArraysB->isList()->yes()) { $resultType = AccessoryArrayListType::intersectWith($resultType); } $resultTypes[] = $resultType; } } } elseif (count($constantArrays['b']) > 0) { $resultTypes[] = TypeCombinator::union(...$constantArrays['b']); } if (count($generalArrays['a']) > 0) { if (count($generalArrays['b']) === 0) { $resultTypes[] = TypeCombinator::union(...$generalArrays['a']); } else { $generalArraysA = TypeCombinator::union(...$generalArrays['a']); $generalArraysB = TypeCombinator::union(...$generalArrays['b']); $aValueType = $generalArraysA->getIterableValueType(); $bValueType = $generalArraysB->getIterableValueType(); if ($aValueType->isArray()->yes() && $aValueType->isConstantArray()->no() && $bValueType->isArray()->yes() && $bValueType->isConstantArray()->no()) { $aDepth = self::getArrayDepth($aValueType) + $depth; $bDepth = self::getArrayDepth($bValueType) + $depth; if (($aDepth > 2 || $bDepth > 2) && abs($aDepth - $bDepth) > 0) { $aValueType = new MixedType(); $bValueType = new MixedType(); } } $resultType = new ArrayType(TypeCombinator::union(self::generalizeType($generalArraysA->getIterableKeyType(), $generalArraysB->getIterableKeyType(), $depth + 1)), TypeCombinator::union(self::generalizeType($aValueType, $bValueType, $depth + 1))); if ($generalArraysA->isIterableAtLeastOnce()->yes() && $generalArraysB->isIterableAtLeastOnce()->yes()) { $resultType = TypeCombinator::intersect($resultType, new NonEmptyArrayType()); } if ($generalArraysA->isList()->yes() && $generalArraysB->isList()->yes()) { $resultType = AccessoryArrayListType::intersectWith($resultType); } if ($generalArraysA->isOversizedArray()->yes() && $generalArraysB->isOversizedArray()->yes()) { $resultType = TypeCombinator::intersect($resultType, new OversizedArrayType()); } $resultTypes[] = $resultType; } } elseif (count($generalArrays['b']) > 0) { $resultTypes[] = TypeCombinator::union(...$generalArrays['b']); } if (count($constantIntegers['a']) > 0) { if (count($constantIntegers['b']) === 0) { $resultTypes[] = TypeCombinator::union(...$constantIntegers['a']); } else { $constantIntegersA = TypeCombinator::union(...$constantIntegers['a']); $constantIntegersB = TypeCombinator::union(...$constantIntegers['b']); if ($constantIntegersA->equals($constantIntegersB)) { $resultTypes[] = $constantIntegersA; } else { $min = null; $max = null; foreach ($constantIntegers['a'] as $int) { if ($min === null || $int->getValue() < $min) { $min = $int->getValue(); } if ($max !== null && $int->getValue() <= $max) { continue; } $max = $int->getValue(); } $gotGreater = \false; $gotSmaller = \false; foreach ($constantIntegers['b'] as $int) { if ($int->getValue() > $max) { $gotGreater = \true; } if ($int->getValue() >= $min) { continue; } $gotSmaller = \true; } if ($gotGreater && $gotSmaller) { $resultTypes[] = new IntegerType(); } elseif ($gotGreater) { $resultTypes[] = IntegerRangeType::fromInterval($min, null); } elseif ($gotSmaller) { $resultTypes[] = IntegerRangeType::fromInterval(null, $max); } else { $resultTypes[] = TypeCombinator::union($constantIntegersA, $constantIntegersB); } } } } elseif (count($constantIntegers['b']) > 0) { $resultTypes[] = TypeCombinator::union(...$constantIntegers['b']); } if (count($integerRanges['a']) > 0) { if (count($integerRanges['b']) === 0) { $resultTypes[] = TypeCombinator::union(...$integerRanges['a']); } else { $integerRangesA = TypeCombinator::union(...$integerRanges['a']); $integerRangesB = TypeCombinator::union(...$integerRanges['b']); if ($integerRangesA->equals($integerRangesB)) { $resultTypes[] = $integerRangesA; } else { $min = null; $max = null; foreach ($integerRanges['a'] as $range) { if ($range->getMin() === null) { $rangeMin = PHP_INT_MIN; } else { $rangeMin = $range->getMin(); } if ($range->getMax() === null) { $rangeMax = PHP_INT_MAX; } else { $rangeMax = $range->getMax(); } if ($min === null || $rangeMin < $min) { $min = $rangeMin; } if ($max !== null && $rangeMax <= $max) { continue; } $max = $rangeMax; } $gotGreater = \false; $gotSmaller = \false; foreach ($integerRanges['b'] as $range) { if ($range->getMin() === null) { $rangeMin = PHP_INT_MIN; } else { $rangeMin = $range->getMin(); } if ($range->getMax() === null) { $rangeMax = PHP_INT_MAX; } else { $rangeMax = $range->getMax(); } if ($rangeMax > $max) { $gotGreater = \true; } if ($rangeMin >= $min) { continue; } $gotSmaller = \true; } if ($min === PHP_INT_MIN) { $min = null; } if ($max === PHP_INT_MAX) { $max = null; } if ($gotGreater && $gotSmaller) { $resultTypes[] = new IntegerType(); } elseif ($gotGreater) { $resultTypes[] = IntegerRangeType::fromInterval($min, null); } elseif ($gotSmaller) { $resultTypes[] = IntegerRangeType::fromInterval(null, $max); } else { $resultTypes[] = TypeCombinator::union($integerRangesA, $integerRangesB); } } } } elseif (count($integerRanges['b']) > 0) { $resultTypes[] = TypeCombinator::union(...$integerRanges['b']); } $accessoryTypes = array_map(static function (Type $type) : Type { return $type->generalize(GeneralizePrecision::moreSpecific()); }, TypeUtils::getAccessoryTypes($a)); return TypeCombinator::union(TypeCombinator::intersect(TypeCombinator::union(...$resultTypes, ...$otherTypes), ...$accessoryTypes), ...$otherTypes); } private static function getArrayDepth(Type $type) : int { $depth = 0; $arrays = TypeUtils::getAnyArrays($type); while (count($arrays) > 0) { $temp = $type->getIterableValueType(); $type = $temp; $arrays = TypeUtils::getAnyArrays($type); $depth++; } return $depth; } public function equals(self $otherScope) : bool { if (!$this->context->equals($otherScope->context)) { return \false; } if (!$this->compareVariableTypeHolders($this->expressionTypes, $otherScope->expressionTypes)) { return \false; } return $this->compareVariableTypeHolders($this->nativeExpressionTypes, $otherScope->nativeExpressionTypes); } /** * @param array<string, ExpressionTypeHolder> $variableTypeHolders * @param array<string, ExpressionTypeHolder> $otherVariableTypeHolders */ private function compareVariableTypeHolders(array $variableTypeHolders, array $otherVariableTypeHolders) : bool { if (count($variableTypeHolders) !== count($otherVariableTypeHolders)) { return \false; } foreach ($variableTypeHolders as $variableExprString => $variableTypeHolder) { if (!isset($otherVariableTypeHolders[$variableExprString])) { return \false; } if (!$variableTypeHolder->getCertainty()->equals($otherVariableTypeHolders[$variableExprString]->getCertainty())) { return \false; } if (!$variableTypeHolder->getType()->equals($otherVariableTypeHolders[$variableExprString]->getType())) { return \false; } unset($otherVariableTypeHolders[$variableExprString]); } return \true; } private function getBooleanExpressionDepth(Expr $expr, int $depth = 0) : int { while ($expr instanceof BinaryOp\BooleanOr || $expr instanceof BinaryOp\LogicalOr || $expr instanceof BinaryOp\BooleanAnd || $expr instanceof BinaryOp\LogicalAnd) { return $this->getBooleanExpressionDepth($expr->left, $depth + 1); } return $depth; } /** @api */ public function canAccessProperty(PropertyReflection $propertyReflection) : bool { return $this->canAccessClassMember($propertyReflection); } /** @api */ public function canCallMethod(MethodReflection $methodReflection) : bool { if ($this->canAccessClassMember($methodReflection)) { return \true; } return $this->canAccessClassMember($methodReflection->getPrototype()); } /** @api */ public function canAccessConstant(ConstantReflection $constantReflection) : bool { return $this->canAccessClassMember($constantReflection); } private function canAccessClassMember(ClassMemberReflection $classMemberReflection) : bool { if ($classMemberReflection->isPublic()) { return \true; } $classReflectionName = $classMemberReflection->getDeclaringClass()->getName(); $canAccessClassMember = static function (ClassReflection $classReflection) use($classMemberReflection, $classReflectionName) { if ($classMemberReflection->isPrivate()) { return $classReflection->getName() === $classReflectionName; } // protected if ($classReflection->getName() === $classReflectionName || $classReflection->isSubclassOf($classReflectionName)) { return \true; } return $classMemberReflection->getDeclaringClass()->isSubclassOf($classReflection->getName()); }; foreach ($this->inClosureBindScopeClasses as $inClosureBindScopeClass) { if (!$this->reflectionProvider->hasClass($inClosureBindScopeClass)) { continue; } if ($canAccessClassMember($this->reflectionProvider->getClass($inClosureBindScopeClass))) { return \true; } } if ($this->isInClass()) { return $canAccessClassMember($this->getClassReflection()); } return \false; } /** * @return string[] */ public function debug() : array { $descriptions = []; foreach ($this->expressionTypes as $name => $variableTypeHolder) { $key = sprintf('%s (%s)', $name, $variableTypeHolder->getCertainty()->describe()); $descriptions[$key] = $variableTypeHolder->getType()->describe(VerbosityLevel::precise()); } foreach ($this->nativeExpressionTypes as $exprString => $nativeTypeHolder) { $key = sprintf('native %s (%s)', $exprString, $nativeTypeHolder->getCertainty()->describe()); $descriptions[$key] = $nativeTypeHolder->getType()->describe(VerbosityLevel::precise()); } foreach ($this->conditionalExpressions as $exprString => $holders) { foreach (array_values($holders) as $i => $holder) { $key = sprintf('condition about %s #%d', $exprString, $i + 1); $parts = []; foreach ($holder->getConditionExpressionTypeHolders() as $conditionalExprString => $expressionTypeHolder) { $parts[] = $conditionalExprString . '=' . $expressionTypeHolder->getType()->describe(VerbosityLevel::precise()); } $condition = implode(' && ', $parts); $descriptions[$key] = sprintf('if %s then %s is %s (%s)', $condition, $exprString, $holder->getTypeHolder()->getType()->describe(VerbosityLevel::precise()), $holder->getTypeHolder()->getCertainty()->describe()); } } return $descriptions; } /** * @param non-empty-string $className */ private function exactInstantiation(New_ $node, string $className) : ?Type { $resolvedClassName = $this->resolveExactName(new Name($className)); $isStatic = \false; if ($resolvedClassName === null) { if (strtolower($className) !== 'static') { return null; } if (!$this->isInClass()) { return null; } $resolvedClassName = $this->getClassReflection()->getName(); $isStatic = \true; } if (!$this->reflectionProvider->hasClass($resolvedClassName)) { return null; } $classReflection = $this->reflectionProvider->getClass($resolvedClassName); if ($classReflection->hasConstructor()) { $constructorMethod = $classReflection->getConstructor(); } else { $constructorMethod = new DummyConstructorReflection($classReflection); } $resolvedTypes = []; $methodCall = new Expr\StaticCall(new Name($resolvedClassName), new Node\Identifier($constructorMethod->getName()), $node->getArgs()); $parametersAcceptor = ParametersAcceptorSelector::selectFromArgs($this, $methodCall->getArgs(), $constructorMethod->getVariants(), $constructorMethod->getNamedArgumentsVariants()); $normalizedMethodCall = \PHPStan\Analyser\ArgumentsNormalizer::reorderStaticCallArguments($parametersAcceptor, $methodCall); if ($normalizedMethodCall !== null) { foreach ($this->dynamicReturnTypeExtensionRegistry->getDynamicStaticMethodReturnTypeExtensionsForClass($classReflection->getName()) as $dynamicStaticMethodReturnTypeExtension) { if (!$dynamicStaticMethodReturnTypeExtension->isStaticMethodSupported($constructorMethod)) { continue; } $resolvedType = $dynamicStaticMethodReturnTypeExtension->getTypeFromStaticMethodCall($constructorMethod, $normalizedMethodCall, $this); if ($resolvedType === null) { continue; } $resolvedTypes[] = $resolvedType; } } if (count($resolvedTypes) > 0) { return TypeCombinator::union(...$resolvedTypes); } $methodResult = $this->getType($methodCall); if ($methodResult instanceof NeverType && $methodResult->isExplicit()) { return $methodResult; } $objectType = $isStatic ? new StaticType($classReflection) : new ObjectType($resolvedClassName); if (!$classReflection->isGeneric()) { return $objectType; } $assignedToProperty = $node->getAttribute(NewAssignedToPropertyVisitor::ATTRIBUTE_NAME); if ($assignedToProperty !== null) { $constructorVariant = $constructorMethod->getOnlyVariant(); $classTemplateTypes = $classReflection->getTemplateTypeMap()->getTypes(); $originalClassTemplateTypes = $classTemplateTypes; foreach ($constructorVariant->getParameters() as $parameter) { TypeTraverser::map($parameter->getType(), static function (Type $type, callable $traverse) use(&$classTemplateTypes) : Type { if ($type instanceof TemplateType && array_key_exists($type->getName(), $classTemplateTypes)) { $classTemplateType = $classTemplateTypes[$type->getName()]; if ($classTemplateType instanceof TemplateType && $classTemplateType->getScope()->equals($type->getScope())) { unset($classTemplateTypes[$type->getName()]); } return $type; } return $traverse($type); }); } if (count($classTemplateTypes) === count($originalClassTemplateTypes)) { $propertyType = TypeCombinator::removeNull($this->getType($assignedToProperty)); if ($objectType->isSuperTypeOf($propertyType)->yes()) { return $propertyType; } } } if ($constructorMethod instanceof DummyConstructorReflection) { if ($isStatic) { return new GenericStaticType($classReflection, $classReflection->typeMapToList($classReflection->getTemplateTypeMap()->resolveToBounds()), null, []); } return new GenericObjectType($resolvedClassName, $classReflection->typeMapToList($classReflection->getTemplateTypeMap()->resolveToBounds())); } if ($constructorMethod->getDeclaringClass()->getName() !== $classReflection->getName()) { if (!$constructorMethod->getDeclaringClass()->isGeneric()) { if ($isStatic) { return new GenericStaticType($classReflection, $classReflection->typeMapToList($classReflection->getTemplateTypeMap()->resolveToBounds()), null, []); } return new GenericObjectType($resolvedClassName, $classReflection->typeMapToList($classReflection->getTemplateTypeMap()->resolveToBounds())); } $newType = new GenericObjectType($resolvedClassName, $classReflection->typeMapToList($classReflection->getTemplateTypeMap())); $ancestorType = $newType->getAncestorWithClassName($constructorMethod->getDeclaringClass()->getName()); if ($ancestorType === null) { if ($isStatic) { return new GenericStaticType($classReflection, $classReflection->typeMapToList($classReflection->getTemplateTypeMap()->resolveToBounds()), null, []); } return new GenericObjectType($resolvedClassName, $classReflection->typeMapToList($classReflection->getTemplateTypeMap()->resolveToBounds())); } $ancestorClassReflections = $ancestorType->getObjectClassReflections(); if (count($ancestorClassReflections) !== 1) { if ($isStatic) { return new GenericStaticType($classReflection, $classReflection->typeMapToList($classReflection->getTemplateTypeMap()->resolveToBounds()), null, []); } return new GenericObjectType($resolvedClassName, $classReflection->typeMapToList($classReflection->getTemplateTypeMap()->resolveToBounds())); } $newParentNode = new New_(new Name($constructorMethod->getDeclaringClass()->getName()), $node->args); $newParentType = $this->getType($newParentNode); $newParentTypeClassReflections = $newParentType->getObjectClassReflections(); if (count($newParentTypeClassReflections) !== 1) { if ($isStatic) { return new GenericStaticType($classReflection, $classReflection->typeMapToList($classReflection->getTemplateTypeMap()->resolveToBounds()), null, []); } return new GenericObjectType($resolvedClassName, $classReflection->typeMapToList($classReflection->getTemplateTypeMap()->resolveToBounds())); } $newParentTypeClassReflection = $newParentTypeClassReflections[0]; $ancestorClassReflection = $ancestorClassReflections[0]; $ancestorMapping = []; foreach ($ancestorClassReflection->getActiveTemplateTypeMap()->getTypes() as $typeName => $templateType) { if (!$templateType instanceof TemplateType) { continue; } $ancestorMapping[$typeName] = $templateType; } $resolvedTypeMap = []; foreach ($newParentTypeClassReflection->getActiveTemplateTypeMap()->getTypes() as $typeName => $type) { if (!array_key_exists($typeName, $ancestorMapping)) { continue; } $ancestorType = $ancestorMapping[$typeName]; if (!$ancestorType->getBound()->isSuperTypeOf($type)->yes()) { continue; } if (!array_key_exists($ancestorType->getName(), $resolvedTypeMap)) { $resolvedTypeMap[$ancestorType->getName()] = $type; continue; } $resolvedTypeMap[$ancestorType->getName()] = TypeCombinator::union($resolvedTypeMap[$ancestorType->getName()], $type); } if ($isStatic) { return new GenericStaticType($classReflection, $classReflection->typeMapToList(new TemplateTypeMap($resolvedTypeMap)), null, []); } return new GenericObjectType($resolvedClassName, $classReflection->typeMapToList(new TemplateTypeMap($resolvedTypeMap))); } $parametersAcceptor = ParametersAcceptorSelector::selectFromArgs($this, $methodCall->getArgs(), $constructorMethod->getVariants(), $constructorMethod->getNamedArgumentsVariants()); if ($this->explicitMixedInUnknownGenericNew) { $resolvedTemplateTypeMap = $parametersAcceptor->getResolvedTemplateTypeMap(); $newGenericType = new GenericObjectType($resolvedClassName, $classReflection->typeMapToList($classReflection->getTemplateTypeMap())); if ($isStatic) { $newGenericType = new GenericStaticType($classReflection, $classReflection->typeMapToList($classReflection->getTemplateTypeMap()), null, []); } return TypeTraverser::map($newGenericType, static function (Type $type, callable $traverse) use($resolvedTemplateTypeMap) : Type { if ($type instanceof TemplateType && !$type->isArgument()) { $newType = $resolvedTemplateTypeMap->getType($type->getName()); if ($newType === null || $newType instanceof ErrorType) { return $type->getBound(); } return TemplateTypeHelper::generalizeInferredTemplateType($type, $newType); } return $traverse($type); }); } $resolvedPhpDoc = $classReflection->getResolvedPhpDoc(); if ($resolvedPhpDoc === null) { return $objectType; } $list = []; $typeMap = $parametersAcceptor->getResolvedTemplateTypeMap(); foreach ($resolvedPhpDoc->getTemplateTags() as $tag) { $templateType = $typeMap->getType($tag->getName()); if ($templateType !== null) { $list[] = $templateType; continue; } $default = $tag->getDefault(); if ($default !== null) { $list[] = $default; continue; } $bound = $tag->getBound(); if ($bound instanceof MixedType && $bound->isExplicitMixed()) { $bound = new MixedType(\false); } $list[] = $bound; } if ($isStatic) { return new GenericStaticType($classReflection, $list, null, []); } return new GenericObjectType($resolvedClassName, $list); } private function filterTypeWithMethod(Type $typeWithMethod, string $methodName) : ?Type { if ($typeWithMethod instanceof UnionType) { $typeWithMethod = $typeWithMethod->filterTypes(static function (Type $innerType) use($methodName) { return $innerType->hasMethod($methodName)->yes(); }); } if (!$typeWithMethod->hasMethod($methodName)->yes()) { return null; } return $typeWithMethod; } /** @api */ public function getMethodReflection(Type $typeWithMethod, string $methodName) : ?ExtendedMethodReflection { $type = $this->filterTypeWithMethod($typeWithMethod, $methodName); if ($type === null) { return null; } return $type->getMethod($methodName, $this); } /** @api */ public function getNakedMethod(Type $typeWithMethod, string $methodName) : ?ExtendedMethodReflection { $type = $this->filterTypeWithMethod($typeWithMethod, $methodName); if ($type === null) { return null; } return $type->getUnresolvedMethodPrototype($methodName, $this)->getNakedMethod(); } /** * @param MethodCall|Node\Expr\StaticCall $methodCall */ private function methodCallReturnType(Type $typeWithMethod, string $methodName, Expr $methodCall) : ?Type { $typeWithMethod = $this->filterTypeWithMethod($typeWithMethod, $methodName); if ($typeWithMethod === null) { return null; } $methodReflection = $typeWithMethod->getMethod($methodName, $this); $parametersAcceptor = ParametersAcceptorSelector::selectFromArgs($this, $methodCall->getArgs(), $methodReflection->getVariants(), $methodReflection->getNamedArgumentsVariants()); if ($methodCall instanceof MethodCall) { $normalizedMethodCall = \PHPStan\Analyser\ArgumentsNormalizer::reorderMethodArguments($parametersAcceptor, $methodCall); } else { $normalizedMethodCall = \PHPStan\Analyser\ArgumentsNormalizer::reorderStaticCallArguments($parametersAcceptor, $methodCall); } if ($normalizedMethodCall === null) { return $this->transformVoidToNull($parametersAcceptor->getReturnType(), $methodCall); } $resolvedTypes = []; foreach ($typeWithMethod->getObjectClassNames() as $className) { if ($normalizedMethodCall instanceof MethodCall) { foreach ($this->dynamicReturnTypeExtensionRegistry->getDynamicMethodReturnTypeExtensionsForClass($className) as $dynamicMethodReturnTypeExtension) { if (!$dynamicMethodReturnTypeExtension->isMethodSupported($methodReflection)) { continue; } $resolvedType = $dynamicMethodReturnTypeExtension->getTypeFromMethodCall($methodReflection, $normalizedMethodCall, $this); if ($resolvedType === null) { continue; } $resolvedTypes[] = $resolvedType; } } else { foreach ($this->dynamicReturnTypeExtensionRegistry->getDynamicStaticMethodReturnTypeExtensionsForClass($className) as $dynamicStaticMethodReturnTypeExtension) { if (!$dynamicStaticMethodReturnTypeExtension->isStaticMethodSupported($methodReflection)) { continue; } $resolvedType = $dynamicStaticMethodReturnTypeExtension->getTypeFromStaticMethodCall($methodReflection, $normalizedMethodCall, $this); if ($resolvedType === null) { continue; } $resolvedTypes[] = $resolvedType; } } } if (count($resolvedTypes) > 0) { return $this->transformVoidToNull(TypeCombinator::union(...$resolvedTypes), $methodCall); } return $this->transformVoidToNull($parametersAcceptor->getReturnType(), $methodCall); } /** @api */ public function getPropertyReflection(Type $typeWithProperty, string $propertyName) : ?ExtendedPropertyReflection { if ($typeWithProperty instanceof UnionType) { $typeWithProperty = $typeWithProperty->filterTypes(static function (Type $innerType) use($propertyName) { return $innerType->hasProperty($propertyName)->yes(); }); } if (!$typeWithProperty->hasProperty($propertyName)->yes()) { return null; } return $typeWithProperty->getProperty($propertyName, $this); } /** * @param PropertyFetch|Node\Expr\StaticPropertyFetch $propertyFetch */ private function propertyFetchType(Type $fetchedOnType, string $propertyName, Expr $propertyFetch) : ?Type { $propertyReflection = $this->getPropertyReflection($fetchedOnType, $propertyName); if ($propertyReflection === null) { return null; } if ($this->isInExpressionAssign($propertyFetch)) { return $propertyReflection->getWritableType(); } return $propertyReflection->getReadableType(); } public function getConstantReflection(Type $typeWithConstant, string $constantName) : ?ConstantReflection { if ($typeWithConstant instanceof UnionType) { $typeWithConstant = $typeWithConstant->filterTypes(static function (Type $innerType) use($constantName) { return $innerType->hasConstant($constantName)->yes(); }); } if (!$typeWithConstant->hasConstant($constantName)->yes()) { return null; } return $typeWithConstant->getConstant($constantName); } /** * @return array<string, ExpressionTypeHolder> */ private function getConstantTypes() : array { $constantTypes = []; foreach ($this->expressionTypes as $exprString => $typeHolder) { $expr = $typeHolder->getExpr(); if (!$expr instanceof ConstFetch) { continue; } $constantTypes[$exprString] = $typeHolder; } return $constantTypes; } /** * @return array<string, ExpressionTypeHolder> */ private function getNativeConstantTypes() : array { $constantTypes = []; foreach ($this->nativeExpressionTypes as $exprString => $typeHolder) { $expr = $typeHolder->getExpr(); if (!$expr instanceof ConstFetch) { continue; } $constantTypes[$exprString] = $typeHolder; } return $constantTypes; } public function getIterableKeyType(Type $iteratee) : Type { if ($iteratee instanceof UnionType) { $filtered = $iteratee->filterTypes(static function (Type $innerType) { return $innerType->isIterable()->yes(); }); if (!$filtered instanceof NeverType) { $iteratee = $filtered; } } return $iteratee->getIterableKeyType(); } public function getIterableValueType(Type $iteratee) : Type { if ($iteratee instanceof UnionType) { $filtered = $iteratee->filterTypes(static function (Type $innerType) { return $innerType->isIterable()->yes(); }); if (!$filtered instanceof NeverType) { $iteratee = $filtered; } } return $iteratee->getIterableValueType(); } } <?php declare (strict_types=1); namespace PHPStan\Analyser; final class FinalizerResult { /** * @var AnalyserResult */ private $analyserResult; /** * @var list<Error> */ private $collectorErrors; /** * @var list<Error> */ private $locallyIgnoredCollectorErrors; /** * @param list<Error> $collectorErrors * @param list<Error> $locallyIgnoredCollectorErrors */ public function __construct(\PHPStan\Analyser\AnalyserResult $analyserResult, array $collectorErrors, array $locallyIgnoredCollectorErrors) { $this->analyserResult = $analyserResult; $this->collectorErrors = $collectorErrors; $this->locallyIgnoredCollectorErrors = $locallyIgnoredCollectorErrors; } /** * @return list<Error> */ public function getErrors() : array { return $this->analyserResult->getErrors(); } public function getAnalyserResult() : \PHPStan\Analyser\AnalyserResult { return $this->analyserResult; } /** * @return list<Error> */ public function getCollectorErrors() : array { return $this->collectorErrors; } /** * @return list<Error> */ public function getLocallyIgnoredCollectorErrors() : array { return $this->locallyIgnoredCollectorErrors; } } <?php declare (strict_types=1); namespace PHPStan\Analyser; use PHPStan\Collectors\CollectedData; use PHPStan\Dependency\RootExportedNode; /** * @phpstan-type LinesToIgnore = array<string, array<int, non-empty-list<string>|null>> */ final class FileAnalyserResult { /** * @var list<Error> */ private $errors; /** * @var list<Error> */ private $filteredPhpErrors; /** * @var list<Error> */ private $allPhpErrors; /** * @var list<Error> */ private $locallyIgnoredErrors; /** * @var list<CollectedData> */ private $collectedData; /** * @var list<string> */ private $dependencies; /** * @var list<RootExportedNode> */ private $exportedNodes; /** * @var LinesToIgnore */ private $linesToIgnore; /** * @var LinesToIgnore */ private $unmatchedLineIgnores; /** * @param list<Error> $errors * @param list<Error> $filteredPhpErrors * @param list<Error> $allPhpErrors * @param list<Error> $locallyIgnoredErrors * @param list<CollectedData> $collectedData * @param list<string> $dependencies * @param list<RootExportedNode> $exportedNodes * @param LinesToIgnore $linesToIgnore * @param LinesToIgnore $unmatchedLineIgnores */ public function __construct(array $errors, array $filteredPhpErrors, array $allPhpErrors, array $locallyIgnoredErrors, array $collectedData, array $dependencies, array $exportedNodes, array $linesToIgnore, array $unmatchedLineIgnores) { $this->errors = $errors; $this->filteredPhpErrors = $filteredPhpErrors; $this->allPhpErrors = $allPhpErrors; $this->locallyIgnoredErrors = $locallyIgnoredErrors; $this->collectedData = $collectedData; $this->dependencies = $dependencies; $this->exportedNodes = $exportedNodes; $this->linesToIgnore = $linesToIgnore; $this->unmatchedLineIgnores = $unmatchedLineIgnores; } /** * @return list<Error> */ public function getErrors() : array { return $this->errors; } /** * @return list<Error> */ public function getFilteredPhpErrors() : array { return $this->filteredPhpErrors; } /** * @return list<Error> */ public function getAllPhpErrors() : array { return $this->allPhpErrors; } /** * @return list<Error> */ public function getLocallyIgnoredErrors() : array { return $this->locallyIgnoredErrors; } /** * @return list<CollectedData> */ public function getCollectedData() : array { return $this->collectedData; } /** * @return list<string> */ public function getDependencies() : array { return $this->dependencies; } /** * @return list<RootExportedNode> */ public function getExportedNodes() : array { return $this->exportedNodes; } /** * @return LinesToIgnore */ public function getLinesToIgnore() : array { return $this->linesToIgnore; } /** * @return LinesToIgnore */ public function getUnmatchedLineIgnores() : array { return $this->unmatchedLineIgnores; } } <?php declare (strict_types=1); namespace PHPStan\Analyser; use PHPStan\DependencyInjection\Container; use PHPStan\DependencyInjection\Type\DynamicReturnTypeExtensionRegistryProvider; use PHPStan\DependencyInjection\Type\ExpressionTypeResolverExtensionRegistryProvider; use PHPStan\Node\Printer\ExprPrinter; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\InitializerExprTypeResolver; use PHPStan\Reflection\MethodReflection; use PHPStan\Reflection\ParameterReflection; use PHPStan\Reflection\ParametersAcceptor; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\Properties\PropertyReflectionFinder; use PHPStan\ShouldNotHappenException; use function is_a; final class LazyInternalScopeFactory implements \PHPStan\Analyser\InternalScopeFactory { /** * @var class-string */ private $scopeClass; /** * @var Container */ private $container; /** * @var bool */ private $explicitMixedInUnknownGenericNew; /** * @var bool */ private $explicitMixedForGlobalVariables; /** * @param class-string $scopeClass */ public function __construct(string $scopeClass, Container $container) { $this->scopeClass = $scopeClass; $this->container = $container; $this->explicitMixedInUnknownGenericNew = $this->container->getParameter('featureToggles')['explicitMixedInUnknownGenericNew']; $this->explicitMixedForGlobalVariables = $this->container->getParameter('featureToggles')['explicitMixedForGlobalVariables']; } /** * @param array<string, ExpressionTypeHolder> $expressionTypes * @param array<string, ExpressionTypeHolder> $nativeExpressionTypes * @param array<string, ConditionalExpressionHolder[]> $conditionalExpressions * @param array<string, true> $currentlyAssignedExpressions * @param array<string, true> $currentlyAllowedUndefinedExpressions * @param list<array{FunctionReflection|MethodReflection|null, ParameterReflection|null}> $inFunctionCallsStack * @param FunctionReflection|MethodReflection|null $function */ public function create(\PHPStan\Analyser\ScopeContext $context, bool $declareStrictTypes = \false, $function = null, ?string $namespace = null, array $expressionTypes = [], array $nativeExpressionTypes = [], array $conditionalExpressions = [], array $inClosureBindScopeClasses = [], ?ParametersAcceptor $anonymousFunctionReflection = null, bool $inFirstLevelStatement = \true, array $currentlyAssignedExpressions = [], array $currentlyAllowedUndefinedExpressions = [], array $inFunctionCallsStack = [], bool $afterExtractCall = \false, ?\PHPStan\Analyser\Scope $parentScope = null, bool $nativeTypesPromoted = \false) : \PHPStan\Analyser\MutatingScope { $scopeClass = $this->scopeClass; if (!is_a($scopeClass, \PHPStan\Analyser\MutatingScope::class, \true)) { throw new ShouldNotHappenException(); } return new $scopeClass($this, $this->container->getByType(ReflectionProvider::class), $this->container->getByType(InitializerExprTypeResolver::class), $this->container->getByType(DynamicReturnTypeExtensionRegistryProvider::class)->getRegistry(), $this->container->getByType(ExpressionTypeResolverExtensionRegistryProvider::class)->getRegistry(), $this->container->getByType(ExprPrinter::class), $this->container->getByType(\PHPStan\Analyser\TypeSpecifier::class), $this->container->getByType(PropertyReflectionFinder::class), $this->container->getService('currentPhpVersionSimpleParser'), $this->container->getByType(\PHPStan\Analyser\NodeScopeResolver::class), $this->container->getByType(\PHPStan\Analyser\RicherScopeGetTypeHelper::class), $this->container->getByType(\PHPStan\Analyser\ConstantResolver::class), $context, $this->container->getByType(PhpVersion::class), $declareStrictTypes, $function, $namespace, $expressionTypes, $nativeExpressionTypes, $conditionalExpressions, $inClosureBindScopeClasses, $anonymousFunctionReflection, $inFirstLevelStatement, $currentlyAssignedExpressions, $currentlyAllowedUndefinedExpressions, $inFunctionCallsStack, $afterExtractCall, $parentScope, $nativeTypesPromoted, $this->explicitMixedInUnknownGenericNew, $this->explicitMixedForGlobalVariables); } } <?php declare (strict_types=1); namespace PHPStan\Analyser; use Countable; use PhpParser\Node; use PhpParser\Node\Expr; use PhpParser\Node\Expr\ArrayDimFetch; use PhpParser\Node\Expr\BinaryOp\BooleanAnd; use PhpParser\Node\Expr\BinaryOp\BooleanOr; use PhpParser\Node\Expr\BinaryOp\LogicalAnd; use PhpParser\Node\Expr\BinaryOp\LogicalOr; use PhpParser\Node\Expr\ClassConstFetch; use PhpParser\Node\Expr\ConstFetch; use PhpParser\Node\Expr\FuncCall; use PhpParser\Node\Expr\Instanceof_; use PhpParser\Node\Expr\MethodCall; use PhpParser\Node\Expr\PropertyFetch; use PhpParser\Node\Expr\StaticCall; use PhpParser\Node\Expr\StaticPropertyFetch; use PhpParser\Node\Name; use PHPStan\Node\Expr\AlwaysRememberedExpr; use PHPStan\Node\IssetExpr; use PHPStan\Node\Printer\ExprPrinter; use PHPStan\Reflection\Assertions; use PHPStan\Reflection\ParametersAcceptor; use PHPStan\Reflection\ParametersAcceptorSelector; use PHPStan\Reflection\ParametersAcceptorWithPhpDocs; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Reflection\ResolvedFunctionVariant; use PHPStan\Rules\Arrays\AllowedArrayKeysTypes; use PHPStan\ShouldNotHappenException; use PHPStan\TrinaryLogic; use PHPStan\Type\Accessory\AccessoryArrayListType; use PHPStan\Type\Accessory\AccessoryNonEmptyStringType; use PHPStan\Type\Accessory\AccessoryNonFalsyStringType; use PHPStan\Type\Accessory\HasOffsetType; use PHPStan\Type\Accessory\HasPropertyType; use PHPStan\Type\Accessory\NonEmptyArrayType; use PHPStan\Type\ArrayType; use PHPStan\Type\BooleanType; use PHPStan\Type\ConditionalTypeForParameter; use PHPStan\Type\Constant\ConstantArrayType; use PHPStan\Type\Constant\ConstantArrayTypeBuilder; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantFloatType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\ConstantScalarType; use PHPStan\Type\FloatType; use PHPStan\Type\FunctionTypeSpecifyingExtension; use PHPStan\Type\Generic\GenericClassStringType; use PHPStan\Type\Generic\TemplateType; use PHPStan\Type\Generic\TemplateTypeHelper; use PHPStan\Type\Generic\TemplateTypeVariance; use PHPStan\Type\Generic\TemplateTypeVarianceMap; use PHPStan\Type\IntegerRangeType; use PHPStan\Type\IntegerType; use PHPStan\Type\IntersectionType; use PHPStan\Type\MethodTypeSpecifyingExtension; use PHPStan\Type\MixedType; use PHPStan\Type\NeverType; use PHPStan\Type\NonexistentParentClassType; use PHPStan\Type\NullType; use PHPStan\Type\ObjectType; use PHPStan\Type\ObjectWithoutClassType; use PHPStan\Type\ResourceType; use PHPStan\Type\StaticMethodTypeSpecifyingExtension; use PHPStan\Type\StaticType; use PHPStan\Type\StaticTypeFactory; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\TypeTraverser; use PHPStan\Type\UnionType; use function array_key_exists; use function array_map; use function array_merge; use function array_reverse; use function array_shift; use function count; use function in_array; use function is_string; use function strtolower; use function substr; use const COUNT_NORMAL; final class TypeSpecifier { /** * @var ExprPrinter */ private $exprPrinter; /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var FunctionTypeSpecifyingExtension[] */ private $functionTypeSpecifyingExtensions; /** * @var MethodTypeSpecifyingExtension[] */ private $methodTypeSpecifyingExtensions; /** * @var StaticMethodTypeSpecifyingExtension[] */ private $staticMethodTypeSpecifyingExtensions; /** * @var bool */ private $rememberPossiblyImpureFunctionValues; /** @var MethodTypeSpecifyingExtension[][]|null */ private $methodTypeSpecifyingExtensionsByClass = null; /** @var StaticMethodTypeSpecifyingExtension[][]|null */ private $staticMethodTypeSpecifyingExtensionsByClass = null; /** * @param FunctionTypeSpecifyingExtension[] $functionTypeSpecifyingExtensions * @param MethodTypeSpecifyingExtension[] $methodTypeSpecifyingExtensions * @param StaticMethodTypeSpecifyingExtension[] $staticMethodTypeSpecifyingExtensions */ public function __construct(ExprPrinter $exprPrinter, ReflectionProvider $reflectionProvider, array $functionTypeSpecifyingExtensions, array $methodTypeSpecifyingExtensions, array $staticMethodTypeSpecifyingExtensions, bool $rememberPossiblyImpureFunctionValues) { $this->exprPrinter = $exprPrinter; $this->reflectionProvider = $reflectionProvider; $this->functionTypeSpecifyingExtensions = $functionTypeSpecifyingExtensions; $this->methodTypeSpecifyingExtensions = $methodTypeSpecifyingExtensions; $this->staticMethodTypeSpecifyingExtensions = $staticMethodTypeSpecifyingExtensions; $this->rememberPossiblyImpureFunctionValues = $rememberPossiblyImpureFunctionValues; foreach (array_merge($functionTypeSpecifyingExtensions, $methodTypeSpecifyingExtensions, $staticMethodTypeSpecifyingExtensions) as $extension) { if (!$extension instanceof \PHPStan\Analyser\TypeSpecifierAwareExtension) { continue; } $extension->setTypeSpecifier($this); } } /** @api */ public function specifyTypesInCondition(\PHPStan\Analyser\Scope $scope, Expr $expr, \PHPStan\Analyser\TypeSpecifierContext $context, ?Expr $rootExpr = null) : \PHPStan\Analyser\SpecifiedTypes { $rootExpr = $rootExpr ?? $expr; if ($expr instanceof Expr\CallLike && $expr->isFirstClassCallable()) { return new \PHPStan\Analyser\SpecifiedTypes([], [], \false, [], $rootExpr); } if ($expr instanceof Instanceof_) { $exprNode = $expr->expr; if ($expr->class instanceof Name) { $className = (string) $expr->class; $lowercasedClassName = strtolower($className); if ($lowercasedClassName === 'self' && $scope->isInClass()) { $type = new ObjectType($scope->getClassReflection()->getName()); } elseif ($lowercasedClassName === 'static' && $scope->isInClass()) { $type = new StaticType($scope->getClassReflection()); } elseif ($lowercasedClassName === 'parent') { if ($scope->isInClass() && $scope->getClassReflection()->getParentClass() !== null) { $type = new ObjectType($scope->getClassReflection()->getParentClass()->getName()); } else { $type = new NonexistentParentClassType(); } } else { $type = new ObjectType($className); } return $this->create($exprNode, $type, $context, \false, $scope, $rootExpr); } $classType = $scope->getType($expr->class); $uncertainty = \false; $type = TypeTraverser::map($classType, static function (Type $type, callable $traverse) use(&$uncertainty) : Type { if ($type instanceof UnionType || $type instanceof IntersectionType) { return $traverse($type); } if ($type->getObjectClassNames() !== []) { $uncertainty = \true; return $type; } if ($type instanceof GenericClassStringType) { $uncertainty = \true; return $type->getGenericType(); } if ($type instanceof ConstantStringType) { return new ObjectType($type->getValue()); } return new MixedType(); }); if (!$type->isSuperTypeOf(new MixedType())->yes()) { if ($context->true()) { $type = TypeCombinator::intersect($type, new ObjectWithoutClassType()); return $this->create($exprNode, $type, $context, \false, $scope, $rootExpr); } elseif ($context->false() && !$uncertainty) { $exprType = $scope->getType($expr->expr); if (!$type->isSuperTypeOf($exprType)->yes()) { return $this->create($exprNode, $type, $context, \false, $scope, $rootExpr); } } } if ($context->true()) { return $this->create($exprNode, new ObjectWithoutClassType(), $context, \false, $scope, $rootExpr); } } elseif ($expr instanceof Node\Expr\BinaryOp\Identical) { return $this->resolveIdentical($expr, $scope, $context, $rootExpr); } elseif ($expr instanceof Node\Expr\BinaryOp\NotIdentical) { return $this->specifyTypesInCondition($scope, new Node\Expr\BooleanNot(new Node\Expr\BinaryOp\Identical($expr->left, $expr->right)), $context, $rootExpr); } elseif ($expr instanceof Expr\Cast\Bool_) { return $this->specifyTypesInCondition($scope, new Node\Expr\BinaryOp\Equal($expr->expr, new ConstFetch(new Name\FullyQualified('true'))), $context, $rootExpr); } elseif ($expr instanceof Expr\Cast\String_) { return $this->specifyTypesInCondition($scope, new Node\Expr\BinaryOp\NotEqual($expr->expr, new Node\Scalar\String_('')), $context, $rootExpr); } elseif ($expr instanceof Expr\Cast\Int_) { return $this->specifyTypesInCondition($scope, new Node\Expr\BinaryOp\NotEqual($expr->expr, new Node\Scalar\LNumber(0)), $context, $rootExpr); } elseif ($expr instanceof Expr\Cast\Double) { return $this->specifyTypesInCondition($scope, new Node\Expr\BinaryOp\NotEqual($expr->expr, new Node\Scalar\DNumber(0.0)), $context, $rootExpr); } elseif ($expr instanceof Node\Expr\BinaryOp\Equal) { return $this->resolveEqual($expr, $scope, $context, $rootExpr); } elseif ($expr instanceof Node\Expr\BinaryOp\NotEqual) { return $this->specifyTypesInCondition($scope, new Node\Expr\BooleanNot(new Node\Expr\BinaryOp\Equal($expr->left, $expr->right)), $context, $rootExpr); } elseif ($expr instanceof Node\Expr\BinaryOp\Smaller || $expr instanceof Node\Expr\BinaryOp\SmallerOrEqual) { if ($expr->left instanceof FuncCall && count($expr->left->getArgs()) >= 1 && $expr->left->name instanceof Name && in_array(strtolower((string) $expr->left->name), ['count', 'sizeof', 'strlen', 'mb_strlen', 'preg_match'], \true) && (!$expr->right instanceof FuncCall || !$expr->right->name instanceof Name || !in_array(strtolower((string) $expr->right->name), ['count', 'sizeof', 'strlen', 'mb_strlen', 'preg_match'], \true))) { $inverseOperator = $expr instanceof Node\Expr\BinaryOp\Smaller ? new Node\Expr\BinaryOp\SmallerOrEqual($expr->right, $expr->left) : new Node\Expr\BinaryOp\Smaller($expr->right, $expr->left); return $this->specifyTypesInCondition($scope, new Node\Expr\BooleanNot($inverseOperator), $context, $rootExpr); } $orEqual = $expr instanceof Node\Expr\BinaryOp\SmallerOrEqual; $offset = $orEqual ? 0 : 1; $leftType = $scope->getType($expr->left); $result = new \PHPStan\Analyser\SpecifiedTypes([], [], \false, [], $rootExpr); if (!$context->null() && $expr->right instanceof FuncCall && count($expr->right->getArgs()) >= 1 && $expr->right->name instanceof Name && in_array(strtolower((string) $expr->right->name), ['count', 'sizeof'], \true) && $leftType->isInteger()->yes()) { $argType = $scope->getType($expr->right->getArgs()[0]->value); if ($argType instanceof UnionType) { $sizeType = null; if ($leftType instanceof ConstantIntegerType) { if ($orEqual) { $sizeType = IntegerRangeType::createAllGreaterThanOrEqualTo($leftType->getValue()); } else { $sizeType = IntegerRangeType::createAllGreaterThan($leftType->getValue()); } } elseif ($leftType instanceof IntegerRangeType) { $sizeType = $leftType; } $narrowed = $this->narrowUnionByArraySize($expr->right, $argType, $sizeType, $context, $scope, $rootExpr); if ($narrowed !== null) { return $narrowed; } } if ($context->true() && IntegerRangeType::createAllGreaterThanOrEqualTo(1 - $offset)->isSuperTypeOf($leftType)->yes() || $context->false() && (new ConstantIntegerType(1 - $offset))->isSuperTypeOf($leftType)->yes()) { if ($context->truthy() && $argType->isArray()->maybe()) { $countables = []; if ($argType instanceof UnionType) { $countableInterface = new ObjectType(Countable::class); foreach ($argType->getTypes() as $innerType) { if ($innerType->isArray()->yes()) { $innerType = TypeCombinator::intersect(new NonEmptyArrayType(), $innerType); $countables[] = $innerType; } if (!$countableInterface->isSuperTypeOf($innerType)->yes()) { continue; } $countables[] = $innerType; } } if (count($countables) > 0) { $countableType = TypeCombinator::union(...$countables); return $this->create($expr->right->getArgs()[0]->value, $countableType, $context, \false, $scope, $rootExpr); } } if ($argType->isArray()->yes()) { $newType = new NonEmptyArrayType(); if ($context->true() && $argType->isList()->yes()) { $newType = AccessoryArrayListType::intersectWith($newType); } $result = $result->unionWith($this->create($expr->right->getArgs()[0]->value, $newType, $context, \false, $scope, $rootExpr)); } } } if (!$context->null() && $expr->right instanceof FuncCall && count($expr->right->getArgs()) >= 3 && $expr->right->name instanceof Name && in_array(strtolower((string) $expr->right->name), ['preg_match'], \true) && IntegerRangeType::fromInterval(0, null)->isSuperTypeOf($leftType)->yes()) { return $this->specifyTypesInCondition($scope, new Expr\BinaryOp\NotIdentical($expr->right, new ConstFetch(new Name('false'))), $context, $rootExpr); } if (!$context->null() && $expr->right instanceof FuncCall && count($expr->right->getArgs()) === 1 && $expr->right->name instanceof Name && in_array(strtolower((string) $expr->right->name), ['strlen', 'mb_strlen'], \true) && $leftType->isInteger()->yes()) { if ($context->true() && IntegerRangeType::createAllGreaterThanOrEqualTo(1 - $offset)->isSuperTypeOf($leftType)->yes() || $context->false() && (new ConstantIntegerType(1 - $offset))->isSuperTypeOf($leftType)->yes()) { $argType = $scope->getType($expr->right->getArgs()[0]->value); if ($argType->isString()->yes()) { $accessory = new AccessoryNonEmptyStringType(); if (IntegerRangeType::createAllGreaterThanOrEqualTo(2 - $offset)->isSuperTypeOf($leftType)->yes()) { $accessory = new AccessoryNonFalsyStringType(); } $result = $result->unionWith($this->create($expr->right->getArgs()[0]->value, $accessory, $context, \false, $scope, $rootExpr)); } } } if ($leftType instanceof ConstantIntegerType) { if ($expr->right instanceof Expr\PostInc) { $result = $result->unionWith($this->createRangeTypes($rootExpr, $expr->right->var, IntegerRangeType::fromInterval($leftType->getValue(), null, $offset + 1), $context)); } elseif ($expr->right instanceof Expr\PostDec) { $result = $result->unionWith($this->createRangeTypes($rootExpr, $expr->right->var, IntegerRangeType::fromInterval($leftType->getValue(), null, $offset - 1), $context)); } elseif ($expr->right instanceof Expr\PreInc || $expr->right instanceof Expr\PreDec) { $result = $result->unionWith($this->createRangeTypes($rootExpr, $expr->right->var, IntegerRangeType::fromInterval($leftType->getValue(), null, $offset), $context)); } } $rightType = $scope->getType($expr->right); if ($rightType instanceof ConstantIntegerType) { if ($expr->left instanceof Expr\PostInc) { $result = $result->unionWith($this->createRangeTypes($rootExpr, $expr->left->var, IntegerRangeType::fromInterval(null, $rightType->getValue(), -$offset + 1), $context)); } elseif ($expr->left instanceof Expr\PostDec) { $result = $result->unionWith($this->createRangeTypes($rootExpr, $expr->left->var, IntegerRangeType::fromInterval(null, $rightType->getValue(), -$offset - 1), $context)); } elseif ($expr->left instanceof Expr\PreInc || $expr->left instanceof Expr\PreDec) { $result = $result->unionWith($this->createRangeTypes($rootExpr, $expr->left->var, IntegerRangeType::fromInterval(null, $rightType->getValue(), -$offset), $context)); } } if ($context->true()) { if (!$expr->left instanceof Node\Scalar) { $result = $result->unionWith($this->create($expr->left, $orEqual ? $rightType->getSmallerOrEqualType() : $rightType->getSmallerType(), \PHPStan\Analyser\TypeSpecifierContext::createTruthy(), \false, $scope, $rootExpr)); } if (!$expr->right instanceof Node\Scalar) { $result = $result->unionWith($this->create($expr->right, $orEqual ? $leftType->getGreaterOrEqualType() : $leftType->getGreaterType(), \PHPStan\Analyser\TypeSpecifierContext::createTruthy(), \false, $scope, $rootExpr)); } } elseif ($context->false()) { if (!$expr->left instanceof Node\Scalar) { $result = $result->unionWith($this->create($expr->left, $orEqual ? $rightType->getGreaterType() : $rightType->getGreaterOrEqualType(), \PHPStan\Analyser\TypeSpecifierContext::createTruthy(), \false, $scope, $rootExpr)); } if (!$expr->right instanceof Node\Scalar) { $result = $result->unionWith($this->create($expr->right, $orEqual ? $leftType->getSmallerType() : $leftType->getSmallerOrEqualType(), \PHPStan\Analyser\TypeSpecifierContext::createTruthy(), \false, $scope, $rootExpr)); } } return $result; } elseif ($expr instanceof Node\Expr\BinaryOp\Greater) { return $this->specifyTypesInCondition($scope, new Expr\BinaryOp\Smaller($expr->right, $expr->left), $context, $rootExpr); } elseif ($expr instanceof Node\Expr\BinaryOp\GreaterOrEqual) { return $this->specifyTypesInCondition($scope, new Expr\BinaryOp\SmallerOrEqual($expr->right, $expr->left), $context, $rootExpr); } elseif ($expr instanceof FuncCall && $expr->name instanceof Name) { if ($this->reflectionProvider->hasFunction($expr->name, $scope)) { $functionReflection = $this->reflectionProvider->getFunction($expr->name, $scope); foreach ($this->getFunctionTypeSpecifyingExtensions() as $extension) { if (!$extension->isFunctionSupported($functionReflection, $expr, $context)) { continue; } return $extension->specifyTypes($functionReflection, $expr, $scope, $context); } // lazy create parametersAcceptor, as creation can be expensive $parametersAcceptor = null; if (count($expr->getArgs()) > 0) { $parametersAcceptor = ParametersAcceptorSelector::selectFromArgs($scope, $expr->getArgs(), $functionReflection->getVariants(), $functionReflection->getNamedArgumentsVariants()); $specifiedTypes = $this->specifyTypesFromConditionalReturnType($context, $expr, $parametersAcceptor, $scope); if ($specifiedTypes !== null) { return $specifiedTypes; } } $assertions = $functionReflection->getAsserts(); if ($assertions->getAll() !== []) { $parametersAcceptor = $parametersAcceptor ?? ParametersAcceptorSelector::selectFromArgs($scope, $expr->getArgs(), $functionReflection->getVariants(), $functionReflection->getNamedArgumentsVariants()); $asserts = $assertions->mapTypes(static function (Type $type) use($parametersAcceptor) { return TemplateTypeHelper::resolveTemplateTypes($type, $parametersAcceptor->getResolvedTemplateTypeMap(), $parametersAcceptor instanceof ParametersAcceptorWithPhpDocs ? $parametersAcceptor->getCallSiteVarianceMap() : TemplateTypeVarianceMap::createEmpty(), TemplateTypeVariance::createInvariant()); }); $specifiedTypes = $this->specifyTypesFromAsserts($context, $expr, $asserts, $parametersAcceptor, $scope); if ($specifiedTypes !== null) { return $specifiedTypes; } } } return $this->handleDefaultTruthyOrFalseyContext($context, $rootExpr, $expr, $scope); } elseif ($expr instanceof MethodCall && $expr->name instanceof Node\Identifier) { $methodCalledOnType = $scope->getType($expr->var); $methodReflection = $scope->getMethodReflection($methodCalledOnType, $expr->name->name); if ($methodReflection !== null) { $referencedClasses = $methodCalledOnType->getObjectClassNames(); if (count($referencedClasses) === 1 && $this->reflectionProvider->hasClass($referencedClasses[0])) { $methodClassReflection = $this->reflectionProvider->getClass($referencedClasses[0]); foreach ($this->getMethodTypeSpecifyingExtensionsForClass($methodClassReflection->getName()) as $extension) { if (!$extension->isMethodSupported($methodReflection, $expr, $context)) { continue; } return $extension->specifyTypes($methodReflection, $expr, $scope, $context); } } // lazy create parametersAcceptor, as creation can be expensive $parametersAcceptor = null; if (count($expr->getArgs()) > 0) { $parametersAcceptor = ParametersAcceptorSelector::selectFromArgs($scope, $expr->getArgs(), $methodReflection->getVariants(), $methodReflection->getNamedArgumentsVariants()); $specifiedTypes = $this->specifyTypesFromConditionalReturnType($context, $expr, $parametersAcceptor, $scope); if ($specifiedTypes !== null) { return $specifiedTypes; } } $assertions = $methodReflection->getAsserts(); if ($assertions->getAll() !== []) { $parametersAcceptor = $parametersAcceptor ?? ParametersAcceptorSelector::selectFromArgs($scope, $expr->getArgs(), $methodReflection->getVariants(), $methodReflection->getNamedArgumentsVariants()); $asserts = $assertions->mapTypes(static function (Type $type) use($parametersAcceptor) { return TemplateTypeHelper::resolveTemplateTypes($type, $parametersAcceptor->getResolvedTemplateTypeMap(), $parametersAcceptor instanceof ParametersAcceptorWithPhpDocs ? $parametersAcceptor->getCallSiteVarianceMap() : TemplateTypeVarianceMap::createEmpty(), TemplateTypeVariance::createInvariant()); }); $specifiedTypes = $this->specifyTypesFromAsserts($context, $expr, $asserts, $parametersAcceptor, $scope); if ($specifiedTypes !== null) { return $specifiedTypes; } } } return $this->handleDefaultTruthyOrFalseyContext($context, $rootExpr, $expr, $scope); } elseif ($expr instanceof StaticCall && $expr->name instanceof Node\Identifier) { if ($expr->class instanceof Name) { $calleeType = $scope->resolveTypeByName($expr->class); } else { $calleeType = $scope->getType($expr->class); } $staticMethodReflection = $scope->getMethodReflection($calleeType, $expr->name->name); if ($staticMethodReflection !== null) { $referencedClasses = $calleeType->getObjectClassNames(); if (count($referencedClasses) === 1 && $this->reflectionProvider->hasClass($referencedClasses[0])) { $staticMethodClassReflection = $this->reflectionProvider->getClass($referencedClasses[0]); foreach ($this->getStaticMethodTypeSpecifyingExtensionsForClass($staticMethodClassReflection->getName()) as $extension) { if (!$extension->isStaticMethodSupported($staticMethodReflection, $expr, $context)) { continue; } return $extension->specifyTypes($staticMethodReflection, $expr, $scope, $context); } } // lazy create parametersAcceptor, as creation can be expensive $parametersAcceptor = null; if (count($expr->getArgs()) > 0) { $parametersAcceptor = ParametersAcceptorSelector::selectFromArgs($scope, $expr->getArgs(), $staticMethodReflection->getVariants(), $staticMethodReflection->getNamedArgumentsVariants()); $specifiedTypes = $this->specifyTypesFromConditionalReturnType($context, $expr, $parametersAcceptor, $scope); if ($specifiedTypes !== null) { return $specifiedTypes; } } $assertions = $staticMethodReflection->getAsserts(); if ($assertions->getAll() !== []) { $parametersAcceptor = $parametersAcceptor ?? ParametersAcceptorSelector::selectFromArgs($scope, $expr->getArgs(), $staticMethodReflection->getVariants(), $staticMethodReflection->getNamedArgumentsVariants()); $asserts = $assertions->mapTypes(static function (Type $type) use($parametersAcceptor) { return TemplateTypeHelper::resolveTemplateTypes($type, $parametersAcceptor->getResolvedTemplateTypeMap(), $parametersAcceptor instanceof ParametersAcceptorWithPhpDocs ? $parametersAcceptor->getCallSiteVarianceMap() : TemplateTypeVarianceMap::createEmpty(), TemplateTypeVariance::createInvariant()); }); $specifiedTypes = $this->specifyTypesFromAsserts($context, $expr, $asserts, $parametersAcceptor, $scope); if ($specifiedTypes !== null) { return $specifiedTypes; } } } return $this->handleDefaultTruthyOrFalseyContext($context, $rootExpr, $expr, $scope); } elseif ($expr instanceof BooleanAnd || $expr instanceof LogicalAnd) { if (!$scope instanceof \PHPStan\Analyser\MutatingScope) { throw new ShouldNotHappenException(); } $leftTypes = $this->specifyTypesInCondition($scope, $expr->left, $context, $rootExpr); $rightScope = $scope->filterByTruthyValue($expr->left); $rightTypes = $this->specifyTypesInCondition($rightScope, $expr->right, $context, $rootExpr); $types = $context->true() ? $leftTypes->unionWith($rightTypes) : $leftTypes->normalize($scope)->intersectWith($rightTypes->normalize($rightScope)); if ($context->false()) { return new \PHPStan\Analyser\SpecifiedTypes($types->getSureTypes(), $types->getSureNotTypes(), \false, array_merge($this->processBooleanNotSureConditionalTypes($scope, $leftTypes, $rightTypes), $this->processBooleanNotSureConditionalTypes($scope, $rightTypes, $leftTypes), $this->processBooleanSureConditionalTypes($scope, $leftTypes, $rightTypes), $this->processBooleanSureConditionalTypes($scope, $rightTypes, $leftTypes)), $rootExpr); } return $types; } elseif ($expr instanceof BooleanOr || $expr instanceof LogicalOr) { if (!$scope instanceof \PHPStan\Analyser\MutatingScope) { throw new ShouldNotHappenException(); } $leftTypes = $this->specifyTypesInCondition($scope, $expr->left, $context, $rootExpr); $rightScope = $scope->filterByFalseyValue($expr->left); $rightTypes = $this->specifyTypesInCondition($rightScope, $expr->right, $context, $rootExpr); $types = $context->true() ? $leftTypes->normalize($scope)->intersectWith($rightTypes->normalize($rightScope)) : $leftTypes->unionWith($rightTypes); if ($context->true()) { return new \PHPStan\Analyser\SpecifiedTypes($types->getSureTypes(), $types->getSureNotTypes(), \false, array_merge($this->processBooleanNotSureConditionalTypes($scope, $leftTypes, $rightTypes), $this->processBooleanNotSureConditionalTypes($scope, $rightTypes, $leftTypes), $this->processBooleanSureConditionalTypes($scope, $leftTypes, $rightTypes), $this->processBooleanSureConditionalTypes($scope, $rightTypes, $leftTypes)), $rootExpr); } return $types; } elseif ($expr instanceof Node\Expr\BooleanNot && !$context->null()) { return $this->specifyTypesInCondition($scope, $expr->expr, $context->negate(), $rootExpr); } elseif ($expr instanceof Node\Expr\Assign) { if (!$scope instanceof \PHPStan\Analyser\MutatingScope) { throw new ShouldNotHappenException(); } if ($context->null()) { return $this->specifyTypesInCondition($scope->exitFirstLevelStatements(), $expr->expr, $context, $rootExpr); } return $this->specifyTypesInCondition($scope->exitFirstLevelStatements(), $expr->var, $context, $rootExpr); } elseif ($expr instanceof Expr\Isset_ && count($expr->vars) > 0 && !$context->null()) { // rewrite multi param isset() to and-chained single param isset() if (count($expr->vars) > 1) { $issets = []; foreach ($expr->vars as $var) { $issets[] = new Expr\Isset_([$var], $expr->getAttributes()); } $first = array_shift($issets); $andChain = null; foreach ($issets as $isset) { if ($andChain === null) { $andChain = new BooleanAnd($first, $isset); continue; } $andChain = new BooleanAnd($andChain, $isset); } if ($andChain === null) { throw new ShouldNotHappenException(); } return $this->specifyTypesInCondition($scope, $andChain, $context, $rootExpr); } $issetExpr = $expr->vars[0]; if (!$context->true()) { if (!$scope instanceof \PHPStan\Analyser\MutatingScope) { throw new ShouldNotHappenException(); } $isset = $scope->issetCheck($issetExpr, static function () { return \true; }); if ($isset === \false) { return new \PHPStan\Analyser\SpecifiedTypes(); } $type = $scope->getType($issetExpr); $isNullable = !$type->isNull()->no(); $exprType = $this->create($issetExpr, new NullType(), $context->negate(), \false, $scope, $rootExpr); if ($issetExpr instanceof Expr\Variable && is_string($issetExpr->name)) { if ($isset === \true) { if ($isNullable) { return $exprType; } // variable cannot exist in !isset() return $exprType->unionWith($this->create(new IssetExpr($issetExpr), new NullType(), $context, \false, $scope, $rootExpr)); } if ($isNullable) { // reduces variable certainty to maybe return $exprType->unionWith($this->create(new IssetExpr($issetExpr), new NullType(), $context->negate(), \false, $scope, $rootExpr)); } // variable cannot exist in !isset() return $this->create(new IssetExpr($issetExpr), new NullType(), $context, \false, $scope, $rootExpr); } if ($isNullable && $isset === \true) { return $exprType; } return new \PHPStan\Analyser\SpecifiedTypes(); } $tmpVars = [$issetExpr]; while ($issetExpr instanceof ArrayDimFetch || $issetExpr instanceof PropertyFetch || $issetExpr instanceof StaticPropertyFetch && $issetExpr->class instanceof Expr) { if ($issetExpr instanceof StaticPropertyFetch) { /** @var Expr $issetExpr */ $issetExpr = $issetExpr->class; } else { $issetExpr = $issetExpr->var; } $tmpVars[] = $issetExpr; } $vars = array_reverse($tmpVars); $types = new \PHPStan\Analyser\SpecifiedTypes(); foreach ($vars as $var) { if ($var instanceof Expr\Variable && is_string($var->name)) { if ($scope->hasVariableType($var->name)->no()) { return new \PHPStan\Analyser\SpecifiedTypes([], [], \false, [], $rootExpr); } } if ($var instanceof ArrayDimFetch && $var->dim !== null && !$scope->getType($var->var) instanceof MixedType) { $dimType = $scope->getType($var->dim); if ($dimType instanceof ConstantIntegerType || $dimType instanceof ConstantStringType) { $types = $types->unionWith($this->create($var->var, new HasOffsetType($dimType), $context, \false, $scope, $rootExpr)); } else { $varType = $scope->getType($var->var); $narrowedKey = AllowedArrayKeysTypes::narrowOffsetKeyType($varType, $dimType); if ($narrowedKey !== null) { $types = $types->unionWith($this->create($var->dim, $narrowedKey, $context, \false, $scope, $rootExpr)); } } } if ($var instanceof PropertyFetch && $var->name instanceof Node\Identifier) { $types = $types->unionWith($this->create($var->var, new IntersectionType([new ObjectWithoutClassType(), new HasPropertyType($var->name->toString())]), \PHPStan\Analyser\TypeSpecifierContext::createTruthy(), \false, $scope, $rootExpr)); } elseif ($var instanceof StaticPropertyFetch && $var->class instanceof Expr && $var->name instanceof Node\VarLikeIdentifier) { $types = $types->unionWith($this->create($var->class, new IntersectionType([new ObjectWithoutClassType(), new HasPropertyType($var->name->toString())]), \PHPStan\Analyser\TypeSpecifierContext::createTruthy(), \false, $scope, $rootExpr)); } $types = $types->unionWith($this->create($var, new NullType(), \PHPStan\Analyser\TypeSpecifierContext::createFalse(), \false, $scope, $rootExpr)); } return $types; } elseif ($expr instanceof Expr\BinaryOp\Coalesce && !$context->null()) { if (!$context->true()) { if (!$scope instanceof \PHPStan\Analyser\MutatingScope) { throw new ShouldNotHappenException(); } $isset = $scope->issetCheck($expr->left, static function () { return \true; }); if ($isset !== \true) { return new \PHPStan\Analyser\SpecifiedTypes(); } return $this->create($expr->left, new NullType(), $context->negate(), \false, $scope, $rootExpr); } if ((new ConstantBooleanType(\false))->isSuperTypeOf($scope->getType($expr->right)->toBoolean())->yes()) { return $this->create($expr->left, new NullType(), \PHPStan\Analyser\TypeSpecifierContext::createFalse(), \false, $scope, $rootExpr); } } elseif ($expr instanceof Expr\Empty_) { if (!$scope instanceof \PHPStan\Analyser\MutatingScope) { throw new ShouldNotHappenException(); } $isset = $scope->issetCheck($expr->expr, static function () { return \true; }); if ($isset === \false) { return new \PHPStan\Analyser\SpecifiedTypes(); } return $this->specifyTypesInCondition($scope, new BooleanOr(new Expr\BooleanNot(new Expr\Isset_([$expr->expr])), new Expr\BooleanNot($expr->expr)), $context, $rootExpr); } elseif ($expr instanceof Expr\ErrorSuppress) { return $this->specifyTypesInCondition($scope, $expr->expr, $context, $rootExpr); } elseif ($expr instanceof Expr\Ternary && !$context->null() && $scope->getType($expr->else)->isFalse()->yes()) { $conditionExpr = $expr->cond; if ($expr->if !== null) { $conditionExpr = new BooleanAnd($conditionExpr, $expr->if); } return $this->specifyTypesInCondition($scope, $conditionExpr, $context, $rootExpr); } elseif ($expr instanceof Expr\NullsafePropertyFetch && !$context->null()) { $types = $this->specifyTypesInCondition($scope, new BooleanAnd(new Expr\BinaryOp\NotIdentical($expr->var, new ConstFetch(new Name('null'))), new PropertyFetch($expr->var, $expr->name)), $context, $rootExpr); $nullSafeTypes = $this->handleDefaultTruthyOrFalseyContext($context, $rootExpr, $expr, $scope); return $context->true() ? $types->unionWith($nullSafeTypes) : $types->normalize($scope)->intersectWith($nullSafeTypes->normalize($scope)); } elseif ($expr instanceof Expr\NullsafeMethodCall && !$context->null()) { $types = $this->specifyTypesInCondition($scope, new BooleanAnd(new Expr\BinaryOp\NotIdentical($expr->var, new ConstFetch(new Name('null'))), new MethodCall($expr->var, $expr->name, $expr->args)), $context, $rootExpr); $nullSafeTypes = $this->handleDefaultTruthyOrFalseyContext($context, $rootExpr, $expr, $scope); return $context->true() ? $types->unionWith($nullSafeTypes) : $types->normalize($scope)->intersectWith($nullSafeTypes->normalize($scope)); } elseif ($expr instanceof Expr\New_ && $expr->class instanceof Name && $this->reflectionProvider->hasClass($expr->class->toString())) { $classReflection = $this->reflectionProvider->getClass($expr->class->toString()); if ($classReflection->hasConstructor()) { $methodReflection = $classReflection->getConstructor(); $asserts = $methodReflection->getAsserts(); if ($asserts->getAll() !== []) { $parametersAcceptor = ParametersAcceptorSelector::selectFromArgs($scope, $expr->getArgs(), $methodReflection->getVariants(), $methodReflection->getNamedArgumentsVariants()); $asserts = $asserts->mapTypes(static function (Type $type) use($parametersAcceptor) { return TemplateTypeHelper::resolveTemplateTypes($type, $parametersAcceptor->getResolvedTemplateTypeMap(), $parametersAcceptor instanceof ParametersAcceptorWithPhpDocs ? $parametersAcceptor->getCallSiteVarianceMap() : TemplateTypeVarianceMap::createEmpty(), TemplateTypeVariance::createInvariant()); }); $specifiedTypes = $this->specifyTypesFromAsserts($context, $expr, $asserts, $parametersAcceptor, $scope); if ($specifiedTypes !== null) { return $specifiedTypes; } } } } elseif (!$context->null()) { return $this->handleDefaultTruthyOrFalseyContext($context, $rootExpr, $expr, $scope); } return new \PHPStan\Analyser\SpecifiedTypes([], [], \false, [], $rootExpr); } private function narrowUnionByArraySize(FuncCall $countFuncCall, UnionType $argType, ?Type $sizeType, \PHPStan\Analyser\TypeSpecifierContext $context, \PHPStan\Analyser\Scope $scope, ?Expr $rootExpr) : ?\PHPStan\Analyser\SpecifiedTypes { if ($sizeType === null) { return null; } if (count($countFuncCall->getArgs()) === 1) { $isNormalCount = TrinaryLogic::createYes(); } else { $mode = $scope->getType($countFuncCall->getArgs()[1]->value); $isNormalCount = (new ConstantIntegerType(COUNT_NORMAL))->isSuperTypeOf($mode)->or($argType->getIterableValueType()->isArray()->negate()); } if ($isNormalCount->yes() && $argType->isConstantArray()->yes()) { $result = []; foreach ($argType->getTypes() as $innerType) { $arraySize = $innerType->getArraySize(); $isSize = $sizeType->isSuperTypeOf($arraySize); if ($context->truthy()) { if ($isSize->no()) { continue; } $constArray = $this->turnListIntoConstantArray($countFuncCall, $innerType, $sizeType, $scope); if ($constArray !== null) { $innerType = $constArray; } } if ($context->falsey()) { if (!$isSize->yes()) { continue; } } $result[] = $innerType; } return $this->create($countFuncCall->getArgs()[0]->value, TypeCombinator::union(...$result), $context, \false, $scope, $rootExpr); } return null; } private function turnListIntoConstantArray(FuncCall $countFuncCall, Type $type, Type $sizeType, \PHPStan\Analyser\Scope $scope) : ?Type { $argType = $scope->getType($countFuncCall->getArgs()[0]->value); if (count($countFuncCall->getArgs()) === 1) { $isNormalCount = TrinaryLogic::createYes(); } else { $mode = $scope->getType($countFuncCall->getArgs()[1]->value); $isNormalCount = (new ConstantIntegerType(COUNT_NORMAL))->isSuperTypeOf($mode)->or($argType->getIterableValueType()->isArray()->negate()); } if ($isNormalCount->yes() && $type->isList()->yes() && $sizeType instanceof ConstantIntegerType && $sizeType->getValue() < ConstantArrayTypeBuilder::ARRAY_COUNT_LIMIT) { // turn optional offsets non-optional $valueTypesBuilder = ConstantArrayTypeBuilder::createEmpty(); for ($i = 0; $i < $sizeType->getValue(); $i++) { $offsetType = new ConstantIntegerType($i); $valueTypesBuilder->setOffsetValueType($offsetType, $type->getOffsetValueType($offsetType)); } return $valueTypesBuilder->getArray(); } if ($isNormalCount->yes() && $type->isList()->yes() && $sizeType instanceof IntegerRangeType && $sizeType->getMin() !== null) { // turn optional offsets non-optional $valueTypesBuilder = ConstantArrayTypeBuilder::createEmpty(); for ($i = 0; $i < $sizeType->getMin(); $i++) { $offsetType = new ConstantIntegerType($i); $valueTypesBuilder->setOffsetValueType($offsetType, $type->getOffsetValueType($offsetType)); } if ($sizeType->getMax() !== null) { for ($i = $sizeType->getMin(); $i < $sizeType->getMax(); $i++) { $offsetType = new ConstantIntegerType($i); $valueTypesBuilder->setOffsetValueType($offsetType, $type->getOffsetValueType($offsetType), \true); } } elseif ($type->isConstantArray()->yes()) { for ($i = $sizeType->getMin();; $i++) { $offsetType = new ConstantIntegerType($i); $hasOffset = $type->hasOffsetValueType($offsetType); if ($hasOffset->no()) { break; } $valueTypesBuilder->setOffsetValueType($offsetType, $type->getOffsetValueType($offsetType), !$hasOffset->yes()); } } else { return null; } $arrayType = $valueTypesBuilder->getArray(); if ($arrayType->isIterableAtLeastOnce()->yes()) { return $arrayType; } } return null; } private function specifyTypesForConstantBinaryExpression(Expr $exprNode, Type $constantType, \PHPStan\Analyser\TypeSpecifierContext $context, \PHPStan\Analyser\Scope $scope, ?Expr $rootExpr) : ?\PHPStan\Analyser\SpecifiedTypes { if (!$context->null() && $constantType->isFalse()->yes()) { $types = $this->create($exprNode, $constantType, $context, \false, $scope, $rootExpr); if ($exprNode instanceof Expr\NullsafeMethodCall || $exprNode instanceof Expr\NullsafePropertyFetch) { return $types; } return $types->unionWith($this->specifyTypesInCondition($scope, $exprNode, $context->true() ? \PHPStan\Analyser\TypeSpecifierContext::createFalse() : \PHPStan\Analyser\TypeSpecifierContext::createFalse()->negate(), $rootExpr)); } if (!$context->null() && $constantType->isTrue()->yes()) { $types = $this->create($exprNode, $constantType, $context, \false, $scope, $rootExpr); if ($exprNode instanceof Expr\NullsafeMethodCall || $exprNode instanceof Expr\NullsafePropertyFetch) { return $types; } return $types->unionWith($this->specifyTypesInCondition($scope, $exprNode, $context->true() ? \PHPStan\Analyser\TypeSpecifierContext::createTrue() : \PHPStan\Analyser\TypeSpecifierContext::createTrue()->negate(), $rootExpr)); } return null; } private function specifyTypesForConstantStringBinaryExpression(Expr $exprNode, Type $constantType, \PHPStan\Analyser\TypeSpecifierContext $context, \PHPStan\Analyser\Scope $scope, ?Expr $rootExpr) : ?\PHPStan\Analyser\SpecifiedTypes { $scalarValues = $constantType->getConstantScalarValues(); if (count($scalarValues) !== 1 || !is_string($scalarValues[0])) { return null; } $constantStringValue = $scalarValues[0]; if ($exprNode instanceof FuncCall && $exprNode->name instanceof Name && strtolower($exprNode->name->toString()) === 'gettype' && isset($exprNode->getArgs()[0])) { $type = null; if ($constantStringValue === 'string') { $type = new StringType(); } if ($constantStringValue === 'array') { $type = new ArrayType(new MixedType(), new MixedType()); } if ($constantStringValue === 'boolean') { $type = new BooleanType(); } if (in_array($constantStringValue, ['resource', 'resource (closed)'], \true)) { $type = new ResourceType(); } if ($constantStringValue === 'integer') { $type = new IntegerType(); } if ($constantStringValue === 'double') { $type = new FloatType(); } if ($constantStringValue === 'NULL') { $type = new NullType(); } if ($constantStringValue === 'object') { $type = new ObjectWithoutClassType(); } if ($type !== null) { $callType = $this->create($exprNode, $constantType, $context, \false, $scope, $rootExpr); $argType = $this->create($exprNode->getArgs()[0]->value, $type, $context, \false, $scope, $rootExpr); return $callType->unionWith($argType); } } if ($context->true() && $exprNode instanceof FuncCall && $exprNode->name instanceof Name && strtolower((string) $exprNode->name) === 'get_parent_class' && isset($exprNode->getArgs()[0])) { $argType = $scope->getType($exprNode->getArgs()[0]->value); $objectType = new ObjectType($constantStringValue); $classStringType = new GenericClassStringType($objectType); if ($argType->isString()->yes()) { return $this->create($exprNode->getArgs()[0]->value, $classStringType, $context, \false, $scope); } if ($argType->isObject()->yes()) { return $this->create($exprNode->getArgs()[0]->value, $objectType, $context, \false, $scope); } return $this->create($exprNode->getArgs()[0]->value, TypeCombinator::union($objectType, $classStringType), $context, \false, $scope); } return null; } private function handleDefaultTruthyOrFalseyContext(\PHPStan\Analyser\TypeSpecifierContext $context, ?Expr $rootExpr, Expr $expr, \PHPStan\Analyser\Scope $scope) : \PHPStan\Analyser\SpecifiedTypes { if ($context->null()) { return new \PHPStan\Analyser\SpecifiedTypes([], [], \false, [], $rootExpr); } if (!$context->truthy()) { $type = StaticTypeFactory::truthy(); return $this->create($expr, $type, \PHPStan\Analyser\TypeSpecifierContext::createFalse(), \false, $scope, $rootExpr); } elseif (!$context->falsey()) { $type = StaticTypeFactory::falsey(); return $this->create($expr, $type, \PHPStan\Analyser\TypeSpecifierContext::createFalse(), \false, $scope, $rootExpr); } return new \PHPStan\Analyser\SpecifiedTypes([], [], \false, [], $rootExpr); } private function specifyTypesFromConditionalReturnType(\PHPStan\Analyser\TypeSpecifierContext $context, Expr\CallLike $call, ParametersAcceptor $parametersAcceptor, \PHPStan\Analyser\Scope $scope) : ?\PHPStan\Analyser\SpecifiedTypes { if (!$parametersAcceptor instanceof ResolvedFunctionVariant) { return null; } $returnType = $parametersAcceptor->getOriginalParametersAcceptor()->getReturnType(); if (!$returnType instanceof ConditionalTypeForParameter) { return null; } if ($context->true()) { $leftType = new ConstantBooleanType(\true); $rightType = new ConstantBooleanType(\false); } elseif ($context->false()) { $leftType = new ConstantBooleanType(\false); $rightType = new ConstantBooleanType(\true); } elseif ($context->null()) { $leftType = new MixedType(); $rightType = new NeverType(); } else { return null; } $argsMap = []; $parameters = $parametersAcceptor->getParameters(); foreach ($call->getArgs() as $i => $arg) { if ($arg->unpack) { continue; } if ($arg->name !== null) { $paramName = $arg->name->toString(); } elseif (isset($parameters[$i])) { $paramName = $parameters[$i]->getName(); } else { continue; } $argsMap['$' . $paramName] = $arg->value; } return $this->getConditionalSpecifiedTypes($returnType, $leftType, $rightType, $scope, $argsMap); } /** * @param array<string, Expr> $argsMap */ public function getConditionalSpecifiedTypes(ConditionalTypeForParameter $conditionalType, Type $leftType, Type $rightType, \PHPStan\Analyser\Scope $scope, array $argsMap) : ?\PHPStan\Analyser\SpecifiedTypes { $parameterName = $conditionalType->getParameterName(); if (!array_key_exists($parameterName, $argsMap)) { return null; } $targetType = $conditionalType->getTarget(); $ifType = $conditionalType->getIf(); $elseType = $conditionalType->getElse(); if ($leftType->isSuperTypeOf($ifType)->yes() && $rightType->isSuperTypeOf($elseType)->yes()) { $context = $conditionalType->isNegated() ? \PHPStan\Analyser\TypeSpecifierContext::createFalse() : \PHPStan\Analyser\TypeSpecifierContext::createTrue(); } elseif ($leftType->isSuperTypeOf($elseType)->yes() && $rightType->isSuperTypeOf($ifType)->yes()) { $context = $conditionalType->isNegated() ? \PHPStan\Analyser\TypeSpecifierContext::createTrue() : \PHPStan\Analyser\TypeSpecifierContext::createFalse(); } else { return null; } $specifiedTypes = $this->create($argsMap[$parameterName], $targetType, $context, \false, $scope); if ($targetType instanceof ConstantBooleanType) { if (!$targetType->getValue()) { $context = $context->negate(); } $specifiedTypes = $specifiedTypes->unionWith($this->specifyTypesInCondition($scope, $argsMap[$parameterName], $context)); } return $specifiedTypes; } private function specifyTypesFromAsserts(\PHPStan\Analyser\TypeSpecifierContext $context, Expr\CallLike $call, Assertions $assertions, ParametersAcceptor $parametersAcceptor, \PHPStan\Analyser\Scope $scope) : ?\PHPStan\Analyser\SpecifiedTypes { if ($context->null()) { $asserts = $assertions->getAsserts(); } elseif ($context->true()) { $asserts = $assertions->getAssertsIfTrue(); } elseif ($context->false()) { $asserts = $assertions->getAssertsIfFalse(); } else { throw new ShouldNotHappenException(); } if (count($asserts) === 0) { return null; } $argsMap = []; $parameters = $parametersAcceptor->getParameters(); foreach ($call->getArgs() as $i => $arg) { if ($arg->unpack) { continue; } if ($arg->name !== null) { $paramName = $arg->name->toString(); } elseif (isset($parameters[$i])) { $paramName = $parameters[$i]->getName(); } elseif (count($parameters) > 0 && $parametersAcceptor->isVariadic()) { $lastParameter = $parameters[count($parameters) - 1]; $paramName = $lastParameter->getName(); } else { continue; } $argsMap[$paramName][] = $arg->value; } if ($call instanceof MethodCall) { $argsMap['this'] = [$call->var]; } /** @var SpecifiedTypes|null $types */ $types = null; foreach ($asserts as $assert) { foreach ($argsMap[substr($assert->getParameter()->getParameterName(), 1)] ?? [] as $parameterExpr) { $assertedType = TypeTraverser::map($assert->getType(), static function (Type $type, callable $traverse) use($argsMap, $scope) : Type { if ($type instanceof ConditionalTypeForParameter) { $parameterName = substr($type->getParameterName(), 1); if (array_key_exists($parameterName, $argsMap)) { $argType = TypeCombinator::union(...array_map(static function (Expr $expr) use($scope) { return $scope->getType($expr); }, $argsMap[$parameterName])); $type = $type->toConditional($argType); } } return $traverse($type); }); $assertExpr = $assert->getParameter()->getExpr($parameterExpr); $templateTypeMap = $parametersAcceptor->getResolvedTemplateTypeMap(); $containsUnresolvedTemplate = \false; TypeTraverser::map($assert->getOriginalType(), static function (Type $type, callable $traverse) use($templateTypeMap, &$containsUnresolvedTemplate) { if ($type instanceof TemplateType && $type->getScope()->getClassName() !== null) { $resolvedType = $templateTypeMap->getType($type->getName()); if ($resolvedType === null || $type->getBound()->equals($resolvedType)) { $containsUnresolvedTemplate = \true; return $type; } } return $traverse($type); }); $newTypes = $this->create($assertExpr, $assertedType, $assert->isNegated() ? \PHPStan\Analyser\TypeSpecifierContext::createFalse() : \PHPStan\Analyser\TypeSpecifierContext::createTrue(), \false, $scope, $containsUnresolvedTemplate || $assert->isEquality() ? $call : null); $types = $types !== null ? $types->unionWith($newTypes) : $newTypes; if (!$context->null() || !$assertedType instanceof ConstantBooleanType) { continue; } $subContext = $assertedType->getValue() ? \PHPStan\Analyser\TypeSpecifierContext::createTrue() : \PHPStan\Analyser\TypeSpecifierContext::createFalse(); if ($assert->isNegated()) { $subContext = $subContext->negate(); } $types = $types->unionWith($this->specifyTypesInCondition($scope, $assertExpr, $subContext)); } } return $types; } /** * @return array<string, ConditionalExpressionHolder[]> */ private function processBooleanSureConditionalTypes(\PHPStan\Analyser\Scope $scope, \PHPStan\Analyser\SpecifiedTypes $leftTypes, \PHPStan\Analyser\SpecifiedTypes $rightTypes) : array { $conditionExpressionTypes = []; foreach ($leftTypes->getSureTypes() as $exprString => [$expr, $type]) { if (!$expr instanceof Expr\Variable) { continue; } if (!is_string($expr->name)) { continue; } $conditionExpressionTypes[$exprString] = \PHPStan\Analyser\ExpressionTypeHolder::createYes($expr, TypeCombinator::remove($scope->getType($expr), $type)); } if (count($conditionExpressionTypes) > 0) { $holders = []; foreach ($rightTypes->getSureTypes() as $exprString => [$expr, $type]) { if (!$expr instanceof Expr\Variable) { continue; } if (!is_string($expr->name)) { continue; } if (!isset($holders[$exprString])) { $holders[$exprString] = []; } $conditions = $conditionExpressionTypes; foreach ($conditions as $conditionExprString => $conditionExprTypeHolder) { $conditionExpr = $conditionExprTypeHolder->getExpr(); if (!$conditionExpr instanceof Expr\Variable) { continue; } if (!is_string($conditionExpr->name)) { continue; } if ($conditionExpr->name !== $expr->name) { continue; } unset($conditions[$conditionExprString]); } if (count($conditions) === 0) { continue; } $holder = new \PHPStan\Analyser\ConditionalExpressionHolder($conditions, new \PHPStan\Analyser\ExpressionTypeHolder($expr, TypeCombinator::intersect($scope->getType($expr), $type), TrinaryLogic::createYes())); $holders[$exprString][$holder->getKey()] = $holder; } return $holders; } return []; } /** * @return array<string, ConditionalExpressionHolder[]> */ private function processBooleanNotSureConditionalTypes(\PHPStan\Analyser\Scope $scope, \PHPStan\Analyser\SpecifiedTypes $leftTypes, \PHPStan\Analyser\SpecifiedTypes $rightTypes) : array { $conditionExpressionTypes = []; foreach ($leftTypes->getSureNotTypes() as $exprString => [$expr, $type]) { if (!$expr instanceof Expr\Variable) { continue; } if (!is_string($expr->name)) { continue; } $conditionExpressionTypes[$exprString] = \PHPStan\Analyser\ExpressionTypeHolder::createYes($expr, TypeCombinator::intersect($scope->getType($expr), $type)); } if (count($conditionExpressionTypes) > 0) { $holders = []; foreach ($rightTypes->getSureNotTypes() as $exprString => [$expr, $type]) { if (!$expr instanceof Expr\Variable) { continue; } if (!is_string($expr->name)) { continue; } if (!isset($holders[$exprString])) { $holders[$exprString] = []; } $conditions = $conditionExpressionTypes; foreach ($conditions as $conditionExprString => $conditionExprTypeHolder) { $conditionExpr = $conditionExprTypeHolder->getExpr(); if (!$conditionExpr instanceof Expr\Variable) { continue; } if (!is_string($conditionExpr->name)) { continue; } if ($conditionExpr->name !== $expr->name) { continue; } unset($conditions[$conditionExprString]); } if (count($conditions) === 0) { continue; } $holder = new \PHPStan\Analyser\ConditionalExpressionHolder($conditions, new \PHPStan\Analyser\ExpressionTypeHolder($expr, TypeCombinator::remove($scope->getType($expr), $type), TrinaryLogic::createYes())); $holders[$exprString][$holder->getKey()] = $holder; } return $holders; } return []; } /** * @return array{Expr, ConstantScalarType, Type}|null */ private function findTypeExpressionsFromBinaryOperation(\PHPStan\Analyser\Scope $scope, Node\Expr\BinaryOp $binaryOperation) : ?array { $leftType = $scope->getType($binaryOperation->left); $rightType = $scope->getType($binaryOperation->right); $rightExpr = $binaryOperation->right; if ($rightExpr instanceof AlwaysRememberedExpr) { $rightExpr = $rightExpr->getExpr(); } $leftExpr = $binaryOperation->left; if ($leftExpr instanceof AlwaysRememberedExpr) { $leftExpr = $leftExpr->getExpr(); } if ($leftType instanceof ConstantScalarType && !$rightExpr instanceof ConstFetch && !$rightExpr instanceof ClassConstFetch) { return [$binaryOperation->right, $leftType, $rightType]; } elseif ($rightType instanceof ConstantScalarType && !$leftExpr instanceof ConstFetch && !$leftExpr instanceof ClassConstFetch) { return [$binaryOperation->left, $rightType, $leftType]; } return null; } /** @api */ public function create(Expr $expr, Type $type, \PHPStan\Analyser\TypeSpecifierContext $context, bool $overwrite = \false, ?\PHPStan\Analyser\Scope $scope = null, ?Expr $rootExpr = null) : \PHPStan\Analyser\SpecifiedTypes { if ($expr instanceof Instanceof_ || $expr instanceof Expr\List_) { return new \PHPStan\Analyser\SpecifiedTypes([], [], \false, [], $rootExpr); } $specifiedExprs = []; if ($expr instanceof AlwaysRememberedExpr) { $specifiedExprs[] = $expr; $expr = $expr->expr; } if ($expr instanceof Expr\Assign) { $specifiedExprs[] = $expr->var; $specifiedExprs[] = $expr->expr; while ($expr->expr instanceof Expr\Assign) { $specifiedExprs[] = $expr->expr->var; $expr = $expr->expr; } } elseif ($expr instanceof Expr\AssignOp\Coalesce) { $specifiedExprs[] = $expr->var; } else { $specifiedExprs[] = $expr; } $types = null; foreach ($specifiedExprs as $specifiedExpr) { $newTypes = $this->createForExpr($specifiedExpr, $type, $context, $overwrite, $scope, $rootExpr); if ($types === null) { $types = $newTypes; } else { $types = $types->unionWith($newTypes); } } return $types; } private function createForExpr(Expr $expr, Type $type, \PHPStan\Analyser\TypeSpecifierContext $context, bool $overwrite = \false, ?\PHPStan\Analyser\Scope $scope = null, ?Expr $rootExpr = null) : \PHPStan\Analyser\SpecifiedTypes { if ($scope !== null) { if ($context->true()) { $containsNull = !$type->isNull()->no() && !$scope->getType($expr)->isNull()->no(); } elseif ($context->false()) { $containsNull = !TypeCombinator::containsNull($type) && !$scope->getType($expr)->isNull()->no(); } } $originalExpr = $expr; if (isset($containsNull) && !$containsNull) { $expr = \PHPStan\Analyser\NullsafeOperatorHelper::getNullsafeShortcircuitedExpr($expr); } if ($scope !== null && !$context->null() && $expr instanceof Expr\BinaryOp\Coalesce) { $rightIsSuperType = $type->isSuperTypeOf($scope->getType($expr->right)); if ($context->true() && $rightIsSuperType->no() || $context->false() && $rightIsSuperType->yes()) { $expr = $expr->left; } } if ($expr instanceof FuncCall && $expr->name instanceof Name) { $has = $this->reflectionProvider->hasFunction($expr->name, $scope); if (!$has) { // backwards compatibility with previous behaviour return new \PHPStan\Analyser\SpecifiedTypes([], [], \false, [], $rootExpr); } $functionReflection = $this->reflectionProvider->getFunction($expr->name, $scope); $hasSideEffects = $functionReflection->hasSideEffects(); if ($hasSideEffects->yes()) { return new \PHPStan\Analyser\SpecifiedTypes([], [], \false, [], $rootExpr); } if (!$this->rememberPossiblyImpureFunctionValues && !$hasSideEffects->no()) { return new \PHPStan\Analyser\SpecifiedTypes([], [], \false, [], $rootExpr); } } if ($expr instanceof MethodCall && $expr->name instanceof Node\Identifier && $scope !== null) { $methodName = $expr->name->toString(); $calledOnType = $scope->getType($expr->var); $methodReflection = $scope->getMethodReflection($calledOnType, $methodName); if ($methodReflection === null || $methodReflection->hasSideEffects()->yes() || !$this->rememberPossiblyImpureFunctionValues && !$methodReflection->hasSideEffects()->no()) { if (isset($containsNull) && !$containsNull) { return $this->createNullsafeTypes($rootExpr, $originalExpr, $scope, $context, $overwrite, $type); } return new \PHPStan\Analyser\SpecifiedTypes([], [], \false, [], $rootExpr); } } if ($expr instanceof StaticCall && $expr->name instanceof Node\Identifier && $scope !== null) { $methodName = $expr->name->toString(); if ($expr->class instanceof Name) { $calledOnType = $scope->resolveTypeByName($expr->class); } else { $calledOnType = $scope->getType($expr->class); } $methodReflection = $scope->getMethodReflection($calledOnType, $methodName); if ($methodReflection === null || $methodReflection->hasSideEffects()->yes() || !$this->rememberPossiblyImpureFunctionValues && !$methodReflection->hasSideEffects()->no()) { if (isset($containsNull) && !$containsNull) { return $this->createNullsafeTypes($rootExpr, $originalExpr, $scope, $context, $overwrite, $type); } return new \PHPStan\Analyser\SpecifiedTypes([], [], \false, [], $rootExpr); } } $sureTypes = []; $sureNotTypes = []; $exprString = $this->exprPrinter->printExpr($expr); $originalExprString = $this->exprPrinter->printExpr($originalExpr); if ($context->false()) { $sureNotTypes[$exprString] = [$expr, $type]; if ($exprString !== $originalExprString) { $sureNotTypes[$originalExprString] = [$originalExpr, $type]; } } elseif ($context->true()) { $sureTypes[$exprString] = [$expr, $type]; if ($exprString !== $originalExprString) { $sureTypes[$originalExprString] = [$originalExpr, $type]; } } $types = new \PHPStan\Analyser\SpecifiedTypes($sureTypes, $sureNotTypes, $overwrite, [], $rootExpr); if ($scope !== null && isset($containsNull) && !$containsNull) { return $this->createNullsafeTypes($rootExpr, $originalExpr, $scope, $context, $overwrite, $type)->unionWith($types); } return $types; } private function createNullsafeTypes(?Expr $rootExpr, Expr $expr, \PHPStan\Analyser\Scope $scope, \PHPStan\Analyser\TypeSpecifierContext $context, bool $overwrite, ?Type $type) : \PHPStan\Analyser\SpecifiedTypes { if ($expr instanceof Expr\NullsafePropertyFetch) { if ($type !== null) { $propertyFetchTypes = $this->create(new PropertyFetch($expr->var, $expr->name), $type, $context, \false, $scope, $rootExpr); } else { $propertyFetchTypes = $this->create(new PropertyFetch($expr->var, $expr->name), new NullType(), \PHPStan\Analyser\TypeSpecifierContext::createFalse(), \false, $scope, $rootExpr); } return $propertyFetchTypes->unionWith($this->create($expr->var, new NullType(), \PHPStan\Analyser\TypeSpecifierContext::createFalse(), $overwrite, $scope, $rootExpr)); } if ($expr instanceof Expr\NullsafeMethodCall) { if ($type !== null) { $methodCallTypes = $this->create(new MethodCall($expr->var, $expr->name, $expr->args), $type, $context, $overwrite, $scope, $rootExpr); } else { $methodCallTypes = $this->create(new MethodCall($expr->var, $expr->name, $expr->args), new NullType(), \PHPStan\Analyser\TypeSpecifierContext::createFalse(), $overwrite, $scope, $rootExpr); } return $methodCallTypes->unionWith($this->create($expr->var, new NullType(), \PHPStan\Analyser\TypeSpecifierContext::createFalse(), $overwrite, $scope, $rootExpr)); } if ($expr instanceof Expr\PropertyFetch) { return $this->createNullsafeTypes($rootExpr, $expr->var, $scope, $context, $overwrite, null); } if ($expr instanceof Expr\MethodCall) { return $this->createNullsafeTypes($rootExpr, $expr->var, $scope, $context, $overwrite, null); } if ($expr instanceof Expr\ArrayDimFetch) { return $this->createNullsafeTypes($rootExpr, $expr->var, $scope, $context, $overwrite, null); } if ($expr instanceof Expr\StaticPropertyFetch && $expr->class instanceof Expr) { return $this->createNullsafeTypes($rootExpr, $expr->class, $scope, $context, $overwrite, null); } if ($expr instanceof Expr\StaticCall && $expr->class instanceof Expr) { return $this->createNullsafeTypes($rootExpr, $expr->class, $scope, $context, $overwrite, null); } return new \PHPStan\Analyser\SpecifiedTypes([], [], $overwrite, [], $rootExpr); } private function createRangeTypes(?Expr $rootExpr, Expr $expr, Type $type, \PHPStan\Analyser\TypeSpecifierContext $context) : \PHPStan\Analyser\SpecifiedTypes { $sureNotTypes = []; if ($type instanceof IntegerRangeType || $type instanceof ConstantIntegerType) { $exprString = $this->exprPrinter->printExpr($expr); if ($context->false()) { $sureNotTypes[$exprString] = [$expr, $type]; } elseif ($context->true()) { $inverted = TypeCombinator::remove(new IntegerType(), $type); $sureNotTypes[$exprString] = [$expr, $inverted]; } } return new \PHPStan\Analyser\SpecifiedTypes([], $sureNotTypes, \false, [], $rootExpr); } /** * @return FunctionTypeSpecifyingExtension[] */ private function getFunctionTypeSpecifyingExtensions() : array { return $this->functionTypeSpecifyingExtensions; } /** * @return MethodTypeSpecifyingExtension[] */ private function getMethodTypeSpecifyingExtensionsForClass(string $className) : array { if ($this->methodTypeSpecifyingExtensionsByClass === null) { $byClass = []; foreach ($this->methodTypeSpecifyingExtensions as $extension) { $byClass[$extension->getClass()][] = $extension; } $this->methodTypeSpecifyingExtensionsByClass = $byClass; } return $this->getTypeSpecifyingExtensionsForType($this->methodTypeSpecifyingExtensionsByClass, $className); } /** * @return StaticMethodTypeSpecifyingExtension[] */ private function getStaticMethodTypeSpecifyingExtensionsForClass(string $className) : array { if ($this->staticMethodTypeSpecifyingExtensionsByClass === null) { $byClass = []; foreach ($this->staticMethodTypeSpecifyingExtensions as $extension) { $byClass[$extension->getClass()][] = $extension; } $this->staticMethodTypeSpecifyingExtensionsByClass = $byClass; } return $this->getTypeSpecifyingExtensionsForType($this->staticMethodTypeSpecifyingExtensionsByClass, $className); } /** * @param MethodTypeSpecifyingExtension[][]|StaticMethodTypeSpecifyingExtension[][] $extensions * @return mixed[] */ private function getTypeSpecifyingExtensionsForType(array $extensions, string $className) : array { $extensionsForClass = [[]]; $class = $this->reflectionProvider->getClass($className); foreach (array_merge([$className], $class->getParentClassesNames(), $class->getNativeReflection()->getInterfaceNames()) as $extensionClassName) { if (!isset($extensions[$extensionClassName])) { continue; } $extensionsForClass[] = $extensions[$extensionClassName]; } return array_merge(...$extensionsForClass); } public function resolveEqual(Expr\BinaryOp\Equal $expr, \PHPStan\Analyser\Scope $scope, \PHPStan\Analyser\TypeSpecifierContext $context, ?Expr $rootExpr) : \PHPStan\Analyser\SpecifiedTypes { $expressions = $this->findTypeExpressionsFromBinaryOperation($scope, $expr); if ($expressions !== null) { $exprNode = $expressions[0]; $constantType = $expressions[1]; $otherType = $expressions[2]; if (!$context->null() && $constantType->getValue() === null) { $trueTypes = [new NullType(), new ConstantBooleanType(\false), new ConstantIntegerType(0), new ConstantFloatType(0.0), new ConstantStringType(''), new ConstantArrayType([], [])]; return $this->create($exprNode, new UnionType($trueTypes), $context, \false, $scope, $rootExpr); } if (!$context->null() && $constantType->getValue() === \false) { return $this->specifyTypesInCondition($scope, $exprNode, $context->true() ? \PHPStan\Analyser\TypeSpecifierContext::createFalsey() : \PHPStan\Analyser\TypeSpecifierContext::createFalsey()->negate(), $rootExpr); } if (!$context->null() && $constantType->getValue() === \true) { return $this->specifyTypesInCondition($scope, $exprNode, $context->true() ? \PHPStan\Analyser\TypeSpecifierContext::createTruthy() : \PHPStan\Analyser\TypeSpecifierContext::createTruthy()->negate(), $rootExpr); } if (!$context->null() && $constantType->getValue() === 0 && !$otherType->isInteger()->yes() && !$otherType->isBoolean()->yes()) { /* There is a difference between php 7.x and 8.x on the equality * behavior between zero and the empty string, so to be conservative * we leave it untouched regardless of the language version */ if ($context->true()) { $trueTypes = [new NullType(), new ConstantBooleanType(\false), new ConstantIntegerType(0), new ConstantFloatType(0.0), new StringType()]; } else { $trueTypes = [new NullType(), new ConstantBooleanType(\false), new ConstantIntegerType(0), new ConstantFloatType(0.0), new ConstantStringType('0')]; } return $this->create($exprNode, new UnionType($trueTypes), $context, \false, $scope, $rootExpr); } if (!$context->null() && $constantType->getValue() === '') { /* There is a difference between php 7.x and 8.x on the equality * behavior between zero and the empty string, so to be conservative * we leave it untouched regardless of the language version */ if ($context->true()) { $trueTypes = [new NullType(), new ConstantBooleanType(\false), new ConstantIntegerType(0), new ConstantFloatType(0.0), new ConstantStringType('')]; } else { $trueTypes = [new NullType(), new ConstantBooleanType(\false), new ConstantStringType('')]; } return $this->create($exprNode, new UnionType($trueTypes), $context, \false, $scope, $rootExpr); } if ($exprNode instanceof FuncCall && $exprNode->name instanceof Name && in_array(strtolower($exprNode->name->toString()), ['gettype', 'get_class', 'get_debug_type'], \true) && isset($exprNode->getArgs()[0]) && $constantType->isString()->yes()) { return $this->specifyTypesInCondition($scope, new Expr\BinaryOp\Identical($expr->left, $expr->right), $context, $rootExpr); } if ($context->true() && $exprNode instanceof FuncCall && $exprNode->name instanceof Name && $exprNode->name->toLowerString() === 'preg_match' && (new ConstantIntegerType(1))->isSuperTypeOf($constantType)->yes()) { return $this->specifyTypesInCondition($scope, new Expr\BinaryOp\Identical($expr->left, $expr->right), $context, $rootExpr); } } $leftType = $scope->getType($expr->left); $rightType = $scope->getType($expr->right); $leftBooleanType = $leftType->toBoolean(); if ($leftBooleanType instanceof ConstantBooleanType && $rightType->isBoolean()->yes()) { return $this->specifyTypesInCondition($scope, new Expr\BinaryOp\Identical(new ConstFetch(new Name($leftBooleanType->getValue() ? 'true' : 'false')), $expr->right), $context, $rootExpr); } $rightBooleanType = $rightType->toBoolean(); if ($rightBooleanType instanceof ConstantBooleanType && $leftType->isBoolean()->yes()) { return $this->specifyTypesInCondition($scope, new Expr\BinaryOp\Identical($expr->left, new ConstFetch(new Name($rightBooleanType->getValue() ? 'true' : 'false'))), $context, $rootExpr); } if (!$context->null() && $rightType->isArray()->yes() && $leftType->isConstantArray()->yes() && $leftType->isIterableAtLeastOnce()->no()) { return $this->create($expr->right, new NonEmptyArrayType(), $context->negate(), \false, $scope, $rootExpr); } if (!$context->null() && $leftType->isArray()->yes() && $rightType->isConstantArray()->yes() && $rightType->isIterableAtLeastOnce()->no()) { return $this->create($expr->left, new NonEmptyArrayType(), $context->negate(), \false, $scope, $rootExpr); } if ($leftType->isString()->yes() && $rightType->isString()->yes() || $leftType->isInteger()->yes() && $rightType->isInteger()->yes() || $leftType->isFloat()->yes() && $rightType->isFloat()->yes() || $leftType->isEnum()->yes() && $rightType->isEnum()->yes()) { return $this->specifyTypesInCondition($scope, new Expr\BinaryOp\Identical($expr->left, $expr->right), $context, $rootExpr); } $leftExprString = $this->exprPrinter->printExpr($expr->left); $rightExprString = $this->exprPrinter->printExpr($expr->right); if ($leftExprString === $rightExprString) { if (!$expr->left instanceof Expr\Variable || !$expr->right instanceof Expr\Variable) { return new \PHPStan\Analyser\SpecifiedTypes([], [], \false, [], $rootExpr); } } $leftTypes = $this->create($expr->left, $leftType, $context, \false, $scope, $rootExpr); $rightTypes = $this->create($expr->right, $rightType, $context, \false, $scope, $rootExpr); return $context->true() ? $leftTypes->unionWith($rightTypes) : $leftTypes->normalize($scope)->intersectWith($rightTypes->normalize($scope)); } public function resolveIdentical(Expr\BinaryOp\Identical $expr, \PHPStan\Analyser\Scope $scope, \PHPStan\Analyser\TypeSpecifierContext $context, ?Expr $rootExpr) : \PHPStan\Analyser\SpecifiedTypes { // Normalize to: fn() === expr $leftExpr = $expr->left; $rightExpr = $expr->right; if ($rightExpr instanceof FuncCall && !$leftExpr instanceof FuncCall) { [$leftExpr, $rightExpr] = [$rightExpr, $leftExpr]; } $unwrappedLeftExpr = $leftExpr; if ($leftExpr instanceof AlwaysRememberedExpr) { $unwrappedLeftExpr = $leftExpr->getExpr(); } $unwrappedRightExpr = $rightExpr; if ($rightExpr instanceof AlwaysRememberedExpr) { $unwrappedRightExpr = $rightExpr->getExpr(); } $rightType = $scope->getType($rightExpr); // (count($a) === $b) if (!$context->null() && $unwrappedLeftExpr instanceof FuncCall && count($unwrappedLeftExpr->getArgs()) >= 1 && $unwrappedLeftExpr->name instanceof Name && in_array(strtolower((string) $unwrappedLeftExpr->name), ['count', 'sizeof'], \true) && $rightType->isInteger()->yes()) { if (IntegerRangeType::fromInterval(null, -1)->isSuperTypeOf($rightType)->yes()) { return $this->create($unwrappedLeftExpr->getArgs()[0]->value, new NeverType(), $context, \false, $scope, $rootExpr); } $argType = $scope->getType($unwrappedLeftExpr->getArgs()[0]->value); $isZero = (new ConstantIntegerType(0))->isSuperTypeOf($rightType); if ($isZero->yes()) { $funcTypes = $this->create($unwrappedLeftExpr, $rightType, $context, \false, $scope, $rootExpr); if ($context->truthy() && !$argType->isArray()->yes()) { $newArgType = new UnionType([new ObjectType(Countable::class), new ConstantArrayType([], [])]); } else { $newArgType = new ConstantArrayType([], []); } return $funcTypes->unionWith($this->create($unwrappedLeftExpr->getArgs()[0]->value, $newArgType, $context, \false, $scope, $rootExpr)); } if ($argType instanceof UnionType) { $narrowed = $this->narrowUnionByArraySize($unwrappedLeftExpr, $argType, $rightType, $context, $scope, $rootExpr); if ($narrowed !== null) { return $narrowed; } } if ($context->truthy()) { if ($argType->isArray()->yes()) { if ($argType->isConstantArray()->yes() && $rightType->isSuperTypeOf($argType->getArraySize())->no()) { return $this->create($unwrappedLeftExpr->getArgs()[0]->value, new NeverType(), $context, \false, $scope, $rootExpr); } $funcTypes = $this->create($unwrappedLeftExpr, $rightType, $context, \false, $scope, $rootExpr); $constArray = $this->turnListIntoConstantArray($unwrappedLeftExpr, $argType, $rightType, $scope); if ($constArray !== null) { return $funcTypes->unionWith($this->create($unwrappedLeftExpr->getArgs()[0]->value, $constArray, $context, \false, $scope, $rootExpr)); } elseif (IntegerRangeType::fromInterval(1, null)->isSuperTypeOf($rightType)->yes()) { return $funcTypes->unionWith($this->create($unwrappedLeftExpr->getArgs()[0]->value, new NonEmptyArrayType(), $context, \false, $scope, $rootExpr)); } return $funcTypes; } } } // strlen($a) === $b if (!$context->null() && $unwrappedLeftExpr instanceof FuncCall && count($unwrappedLeftExpr->getArgs()) === 1 && $unwrappedLeftExpr->name instanceof Name && in_array(strtolower((string) $unwrappedLeftExpr->name), ['strlen', 'mb_strlen'], \true) && $rightType->isInteger()->yes()) { if (IntegerRangeType::fromInterval(null, -1)->isSuperTypeOf($rightType)->yes()) { return $this->create($unwrappedLeftExpr->getArgs()[0]->value, new NeverType(), $context, \false, $scope, $rootExpr); } $isZero = (new ConstantIntegerType(0))->isSuperTypeOf($rightType); if ($isZero->yes()) { $funcTypes = $this->create($unwrappedLeftExpr, $rightType, $context, \false, $scope, $rootExpr); return $funcTypes->unionWith($this->create($unwrappedLeftExpr->getArgs()[0]->value, new ConstantStringType(''), $context, \false, $scope, $rootExpr)); } if ($context->truthy() && IntegerRangeType::fromInterval(1, null)->isSuperTypeOf($rightType)->yes()) { $argType = $scope->getType($unwrappedLeftExpr->getArgs()[0]->value); if ($argType->isString()->yes()) { $funcTypes = $this->create($unwrappedLeftExpr, $rightType, $context, \false, $scope, $rootExpr); $accessory = new AccessoryNonEmptyStringType(); if (IntegerRangeType::fromInterval(2, null)->isSuperTypeOf($rightType)->yes()) { $accessory = new AccessoryNonFalsyStringType(); } $valueTypes = $this->create($unwrappedLeftExpr->getArgs()[0]->value, $accessory, $context, \false, $scope, $rootExpr); return $funcTypes->unionWith($valueTypes); } } } // preg_match($a) === $b if ($context->true() && $unwrappedLeftExpr instanceof FuncCall && $unwrappedLeftExpr->name instanceof Name && $unwrappedLeftExpr->name->toLowerString() === 'preg_match' && (new ConstantIntegerType(1))->isSuperTypeOf($rightType)->yes()) { return $this->specifyTypesInCondition($scope, $leftExpr, $context, $rootExpr); } // get_class($a) === 'Foo' if ($context->true() && $unwrappedLeftExpr instanceof FuncCall && $unwrappedLeftExpr->name instanceof Name && in_array(strtolower($unwrappedLeftExpr->name->toString()), ['get_class', 'get_debug_type'], \true) && isset($unwrappedLeftExpr->getArgs()[0])) { if ($rightType->getClassStringObjectType()->isObject()->yes()) { return $this->create($unwrappedLeftExpr->getArgs()[0]->value, $rightType->getClassStringObjectType(), $context, \false, $scope, $rootExpr)->unionWith($this->create($leftExpr, $rightType, $context, \false, $scope, $rootExpr)); } } // get_class($a) === 'Foo' if ($context->truthy() && $unwrappedLeftExpr instanceof FuncCall && $unwrappedLeftExpr->name instanceof Name && in_array(strtolower($unwrappedLeftExpr->name->toString()), ['substr', 'strstr', 'stristr', 'strchr', 'strrchr', 'strtolower', 'strtoupper', 'ucfirst', 'lcfirst', 'mb_substr', 'mb_strstr', 'mb_stristr', 'mb_strchr', 'mb_strrchr', 'mb_strtolower', 'mb_strtoupper', 'mb_ucfirst', 'mb_lcfirst', 'ucwords', 'mb_convert_case', 'mb_convert_kana'], \true) && isset($unwrappedLeftExpr->getArgs()[0]) && $rightType->isNonEmptyString()->yes()) { $argType = $scope->getType($unwrappedLeftExpr->getArgs()[0]->value); if ($argType->isString()->yes()) { if ($rightType->isNonFalsyString()->yes()) { return $this->create($unwrappedLeftExpr->getArgs()[0]->value, TypeCombinator::intersect($argType, new AccessoryNonFalsyStringType()), $context, \false, $scope); } return $this->create($unwrappedLeftExpr->getArgs()[0]->value, TypeCombinator::intersect($argType, new AccessoryNonEmptyStringType()), $context, \false, $scope); } } if ($rightType->isString()->yes()) { $types = null; foreach ($rightType->getConstantStrings() as $constantString) { $specifiedType = $this->specifyTypesForConstantStringBinaryExpression($unwrappedLeftExpr, $constantString, $context, $scope, $rootExpr); if ($specifiedType === null) { continue; } if ($types === null) { $types = $specifiedType; continue; } $types = $types->intersectWith($specifiedType); } if ($types !== null) { if ($leftExpr !== $unwrappedLeftExpr) { $types = $types->unionWith($this->create($leftExpr, $rightType, $context, \false, $scope, $rootExpr)); } return $types; } } $expressions = $this->findTypeExpressionsFromBinaryOperation($scope, $expr); if ($expressions !== null) { $exprNode = $expressions[0]; $constantType = $expressions[1]; $unwrappedExprNode = $exprNode; if ($exprNode instanceof AlwaysRememberedExpr) { $unwrappedExprNode = $exprNode->getExpr(); } $specifiedType = $this->specifyTypesForConstantBinaryExpression($unwrappedExprNode, $constantType, $context, $scope, $rootExpr); if ($specifiedType !== null) { if ($exprNode !== $unwrappedExprNode) { $specifiedType = $specifiedType->unionWith($this->create($exprNode, $constantType, $context, \false, $scope, $rootExpr)); } return $specifiedType; } } // $a::class === 'Foo' if ($context->true() && $unwrappedLeftExpr instanceof ClassConstFetch && $unwrappedLeftExpr->class instanceof Expr && $unwrappedLeftExpr->name instanceof Node\Identifier && $unwrappedRightExpr instanceof ClassConstFetch && $rightType instanceof ConstantStringType && $rightType->getValue() !== '' && strtolower($unwrappedLeftExpr->name->toString()) === 'class') { return $this->specifyTypesInCondition($scope, new Instanceof_($unwrappedLeftExpr->class, new Name($rightType->getValue())), $context, $rootExpr)->unionWith($this->create($leftExpr, $rightType, $context, \false, $scope, $rootExpr)); } $leftType = $scope->getType($leftExpr); // 'Foo' === $a::class if ($context->true() && $unwrappedRightExpr instanceof ClassConstFetch && $unwrappedRightExpr->class instanceof Expr && $unwrappedRightExpr->name instanceof Node\Identifier && $unwrappedLeftExpr instanceof ClassConstFetch && $leftType instanceof ConstantStringType && $leftType->getValue() !== '' && strtolower($unwrappedRightExpr->name->toString()) === 'class') { return $this->specifyTypesInCondition($scope, new Instanceof_($unwrappedRightExpr->class, new Name($leftType->getValue())), $context, $rootExpr)->unionWith($this->create($rightExpr, $leftType, $context, \false, $scope, $rootExpr)); } if ($context->false()) { $identicalType = $scope->getType($expr); if ($identicalType instanceof ConstantBooleanType) { $never = new NeverType(); $contextForTypes = $identicalType->getValue() ? $context->negate() : $context; $leftTypes = $this->create($leftExpr, $never, $contextForTypes, \false, $scope, $rootExpr); $rightTypes = $this->create($rightExpr, $never, $contextForTypes, \false, $scope, $rootExpr); if ($leftExpr instanceof AlwaysRememberedExpr) { $leftTypes = $leftTypes->unionWith($this->create($unwrappedLeftExpr, $never, $contextForTypes, \false, $scope, $rootExpr)); } if ($rightExpr instanceof AlwaysRememberedExpr) { $rightTypes = $rightTypes->unionWith($this->create($unwrappedRightExpr, $never, $contextForTypes, \false, $scope, $rootExpr)); } return $leftTypes->unionWith($rightTypes); } } $types = null; if (count($leftType->getFiniteTypes()) === 1 || $context->true() && $leftType->isConstantValue()->yes() && !$rightType->equals($leftType) && $rightType->isSuperTypeOf($leftType)->yes()) { $types = $this->create($rightExpr, $leftType, $context, \false, $scope, $rootExpr); if ($rightExpr instanceof AlwaysRememberedExpr) { $types = $types->unionWith($this->create($unwrappedRightExpr, $leftType, $context, \false, $scope, $rootExpr)); } } if (count($rightType->getFiniteTypes()) === 1 || $context->true() && $rightType->isConstantValue()->yes() && !$leftType->equals($rightType) && $leftType->isSuperTypeOf($rightType)->yes()) { $leftTypes = $this->create($leftExpr, $rightType, $context, \false, $scope, $rootExpr); if ($leftExpr instanceof AlwaysRememberedExpr) { $leftTypes = $leftTypes->unionWith($this->create($unwrappedLeftExpr, $rightType, $context, \false, $scope, $rootExpr)); } if ($types !== null) { $types = $types->unionWith($leftTypes); } else { $types = $leftTypes; } } if ($types !== null) { return $types; } $leftExprString = $this->exprPrinter->printExpr($unwrappedLeftExpr); $rightExprString = $this->exprPrinter->printExpr($unwrappedRightExpr); if ($leftExprString === $rightExprString) { if (!$unwrappedLeftExpr instanceof Expr\Variable || !$unwrappedRightExpr instanceof Expr\Variable) { return new \PHPStan\Analyser\SpecifiedTypes([], [], \false, [], $rootExpr); } } if ($context->true()) { $leftTypes = $this->create($leftExpr, $rightType, $context, \false, $scope, $rootExpr); $rightTypes = $this->create($rightExpr, $leftType, $context, \false, $scope, $rootExpr); if ($leftExpr instanceof AlwaysRememberedExpr) { $leftTypes = $leftTypes->unionWith($this->create($unwrappedLeftExpr, $rightType, $context, \false, $scope, $rootExpr)); } if ($rightExpr instanceof AlwaysRememberedExpr) { $rightTypes = $rightTypes->unionWith($this->create($unwrappedRightExpr, $leftType, $context, \false, $scope, $rootExpr)); } return $leftTypes->unionWith($rightTypes); } elseif ($context->false()) { return $this->create($leftExpr, $leftType, $context, \false, $scope, $rootExpr)->normalize($scope)->intersectWith($this->create($rightExpr, $rightType, $context, \false, $scope, $rootExpr)->normalize($scope)); } return new \PHPStan\Analyser\SpecifiedTypes([], [], \false, [], $rootExpr); } } <?php declare (strict_types=1); namespace PHPStan\Analyser; use PhpParser\Node; use PHPStan\Rules\FileRuleError; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\LineRuleError; use PHPStan\Rules\MetadataRuleError; use PHPStan\Rules\NonIgnorableRuleError; use PHPStan\Rules\RuleError; use PHPStan\Rules\TipRuleError; use function is_string; final class RuleErrorTransformer { /** * @param class-string<Node> $nodeType * @param string|RuleError $ruleError */ public function transform($ruleError, \PHPStan\Analyser\Scope $scope, string $nodeType, int $nodeLine) : \PHPStan\Analyser\Error { $line = $nodeLine; $canBeIgnored = \true; $fileName = $scope->getFileDescription(); $filePath = $scope->getFile(); $traitFilePath = null; $tip = null; $identifier = null; $metadata = []; if ($scope->isInTrait()) { $traitReflection = $scope->getTraitReflection(); if ($traitReflection->getFileName() !== null) { $traitFilePath = $traitReflection->getFileName(); } } if (is_string($ruleError)) { $message = $ruleError; } else { $message = $ruleError->getMessage(); if ($ruleError instanceof LineRuleError && $ruleError->getLine() !== -1) { $line = $ruleError->getLine(); } if ($ruleError instanceof FileRuleError && $ruleError->getFile() !== '') { $fileName = $ruleError->getFileDescription(); $filePath = $ruleError->getFile(); $traitFilePath = null; } if ($ruleError instanceof TipRuleError) { $tip = $ruleError->getTip(); } if ($ruleError instanceof IdentifierRuleError) { $identifier = $ruleError->getIdentifier(); } if ($ruleError instanceof MetadataRuleError) { $metadata = $ruleError->getMetadata(); } if ($ruleError instanceof NonIgnorableRuleError) { $canBeIgnored = \false; } } return new \PHPStan\Analyser\Error($message, $fileName, $line, $canBeIgnored, $filePath, $traitFilePath, $tip, $nodeLine, $nodeType, $identifier, $metadata); } } <?php declare (strict_types=1); namespace PHPStan\Analyser; use PhpParser\Node\Expr; use PHPStan\TrinaryLogic; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; final class ExpressionTypeHolder { /** * @var Expr */ private $expr; /** * @var Type */ private $type; /** * @var TrinaryLogic */ private $certainty; public function __construct(Expr $expr, Type $type, TrinaryLogic $certainty) { $this->expr = $expr; $this->type = $type; $this->certainty = $certainty; } public static function createYes(Expr $expr, Type $type) : self { return new self($expr, $type, TrinaryLogic::createYes()); } public static function createMaybe(Expr $expr, Type $type) : self { return new self($expr, $type, TrinaryLogic::createMaybe()); } public function equals(self $other) : bool { if (!$this->certainty->equals($other->certainty)) { return \false; } return $this->type->equals($other->type); } public function and(self $other) : self { if ($this->getType()->equals($other->getType())) { $type = $this->getType(); } else { $type = TypeCombinator::union($this->getType(), $other->getType()); } return new self($this->expr, $type, $this->getCertainty()->and($other->getCertainty())); } public function getExpr() : Expr { return $this->expr; } public function getType() : Type { return $this->type; } public function getCertainty() : TrinaryLogic { return $this->certainty; } } <?php declare (strict_types=1); namespace PHPStan\Analyser; use PHPStan\Broker\BrokerFactory; use PHPStan\DependencyInjection\Container; use PHPStan\Node\Printer\ExprPrinter; use PHPStan\Reflection\ReflectionProvider; use function array_merge; final class TypeSpecifierFactory { /** * @var Container */ private $container; public const FUNCTION_TYPE_SPECIFYING_EXTENSION_TAG = 'phpstan.typeSpecifier.functionTypeSpecifyingExtension'; public const METHOD_TYPE_SPECIFYING_EXTENSION_TAG = 'phpstan.typeSpecifier.methodTypeSpecifyingExtension'; public const STATIC_METHOD_TYPE_SPECIFYING_EXTENSION_TAG = 'phpstan.typeSpecifier.staticMethodTypeSpecifyingExtension'; public function __construct(Container $container) { $this->container = $container; } public function create() : \PHPStan\Analyser\TypeSpecifier { $typeSpecifier = new \PHPStan\Analyser\TypeSpecifier($this->container->getByType(ExprPrinter::class), $this->container->getByType(ReflectionProvider::class), $this->container->getServicesByTag(self::FUNCTION_TYPE_SPECIFYING_EXTENSION_TAG), $this->container->getServicesByTag(self::METHOD_TYPE_SPECIFYING_EXTENSION_TAG), $this->container->getServicesByTag(self::STATIC_METHOD_TYPE_SPECIFYING_EXTENSION_TAG), $this->container->getParameter('rememberPossiblyImpureFunctionValues')); foreach (array_merge($this->container->getServicesByTag(BrokerFactory::PROPERTIES_CLASS_REFLECTION_EXTENSION_TAG), $this->container->getServicesByTag(BrokerFactory::METHODS_CLASS_REFLECTION_EXTENSION_TAG), $this->container->getServicesByTag(BrokerFactory::DYNAMIC_METHOD_RETURN_TYPE_EXTENSION_TAG), $this->container->getServicesByTag(BrokerFactory::DYNAMIC_STATIC_METHOD_RETURN_TYPE_EXTENSION_TAG), $this->container->getServicesByTag(BrokerFactory::DYNAMIC_FUNCTION_RETURN_TYPE_EXTENSION_TAG)) as $extension) { if (!$extension instanceof \PHPStan\Analyser\TypeSpecifierAwareExtension) { continue; } $extension->setTypeSpecifier($typeSpecifier); } return $typeSpecifier; } } <?php declare (strict_types=1); namespace PHPStan\Analyser; /** * @api * @final */ class ScopeFactory { /** * @var InternalScopeFactory */ private $internalScopeFactory; public function __construct(\PHPStan\Analyser\InternalScopeFactory $internalScopeFactory) { $this->internalScopeFactory = $internalScopeFactory; } public function create(\PHPStan\Analyser\ScopeContext $context) : \PHPStan\Analyser\MutatingScope { return $this->internalScopeFactory->create($context); } } <?php declare (strict_types=1); namespace PHPStan\Analyser; use PhpParser\Node\Name; use PHPStan\Reflection\NamespaceAnswerer; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Reflection\ReflectionProvider\ReflectionProviderProvider; use PHPStan\Type\Accessory\AccessoryNonFalsyStringType; use PHPStan\Type\Constant\ConstantFloatType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\GeneralizePrecision; use PHPStan\Type\IntegerRangeType; use PHPStan\Type\IntersectionType; use PHPStan\Type\MixedType; use PHPStan\Type\ResourceType; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\UnionType; use function array_key_exists; use function in_array; use function sprintf; use const INF; use const NAN; use const PHP_INT_SIZE; final class ConstantResolver { /** * @var ReflectionProviderProvider */ private $reflectionProviderProvider; /** * @var string[] */ private $dynamicConstantNames; /** @var array<string, true> */ private $currentlyResolving = []; /** * @param string[] $dynamicConstantNames */ public function __construct(ReflectionProviderProvider $reflectionProviderProvider, array $dynamicConstantNames) { $this->reflectionProviderProvider = $reflectionProviderProvider; $this->dynamicConstantNames = $dynamicConstantNames; } public function resolveConstant(Name $name, ?NamespaceAnswerer $scope) : ?Type { if (!$this->getReflectionProvider()->hasConstant($name, $scope)) { return null; } /** @var string $resolvedConstantName */ $resolvedConstantName = $this->getReflectionProvider()->resolveConstantName($name, $scope); $constantType = $this->resolvePredefinedConstant($resolvedConstantName); if ($constantType !== null) { return $constantType; } if (array_key_exists($resolvedConstantName, $this->currentlyResolving)) { return new MixedType(); } $this->currentlyResolving[$resolvedConstantName] = \true; $constantReflection = $this->getReflectionProvider()->getConstant($name, $scope); $constantType = $constantReflection->getValueType(); $type = $this->resolveConstantType($resolvedConstantName, $constantType); unset($this->currentlyResolving[$resolvedConstantName]); return $type; } public function resolvePredefinedConstant(string $resolvedConstantName) : ?Type { // core, https://www.php.net/manual/en/reserved.constants.php if ($resolvedConstantName === 'PHP_VERSION') { return new IntersectionType([new StringType(), new AccessoryNonFalsyStringType()]); } if ($resolvedConstantName === 'PHP_MAJOR_VERSION') { return IntegerRangeType::fromInterval(5, null); } if ($resolvedConstantName === 'PHP_MINOR_VERSION') { return IntegerRangeType::fromInterval(0, null); } if ($resolvedConstantName === 'PHP_RELEASE_VERSION') { return IntegerRangeType::fromInterval(0, null); } if ($resolvedConstantName === 'PHP_VERSION_ID') { return IntegerRangeType::fromInterval(50207, null); } if ($resolvedConstantName === 'PHP_ZTS') { return new UnionType([new ConstantIntegerType(0), new ConstantIntegerType(1)]); } if ($resolvedConstantName === 'PHP_DEBUG') { return new UnionType([new ConstantIntegerType(0), new ConstantIntegerType(1)]); } if ($resolvedConstantName === 'PHP_MAXPATHLEN') { return IntegerRangeType::fromInterval(1, null); } if ($resolvedConstantName === 'PHP_OS') { return new IntersectionType([new StringType(), new AccessoryNonFalsyStringType()]); } if ($resolvedConstantName === 'PHP_OS_FAMILY') { return new UnionType([new ConstantStringType('Windows'), new ConstantStringType('BSD'), new ConstantStringType('Darwin'), new ConstantStringType('Solaris'), new ConstantStringType('Linux'), new ConstantStringType('Unknown')]); } if ($resolvedConstantName === 'PHP_SAPI') { return new UnionType([new ConstantStringType('apache'), new ConstantStringType('apache2handler'), new ConstantStringType('cgi'), new ConstantStringType('cli'), new ConstantStringType('cli-server'), new ConstantStringType('embed'), new ConstantStringType('fpm-fcgi'), new ConstantStringType('litespeed'), new ConstantStringType('phpdbg'), new IntersectionType([new StringType(), new AccessoryNonFalsyStringType()])]); } if ($resolvedConstantName === 'PHP_EOL') { return new UnionType([new ConstantStringType("\n"), new ConstantStringType("\r\n")]); } if ($resolvedConstantName === 'PHP_INT_MAX') { return PHP_INT_SIZE === 8 ? new UnionType([new ConstantIntegerType(2147483647), new ConstantIntegerType(9223372036854775807)]) : new ConstantIntegerType(2147483647); } if ($resolvedConstantName === 'PHP_INT_MIN') { // Why the -1 you might wonder, the answer is to fit it into an int :/ see https://3v4l.org/4SHIQ return PHP_INT_SIZE === 8 ? new UnionType([new ConstantIntegerType(-9223372036854775807 - 1), new ConstantIntegerType(-2147483647 - 1)]) : new ConstantIntegerType(-2147483647 - 1); } if ($resolvedConstantName === 'PHP_INT_SIZE') { return new UnionType([new ConstantIntegerType(4), new ConstantIntegerType(8)]); } if ($resolvedConstantName === 'PHP_FLOAT_DIG') { return IntegerRangeType::fromInterval(1, null); } if ($resolvedConstantName === 'PHP_EXTENSION_DIR') { return new IntersectionType([new StringType(), new AccessoryNonFalsyStringType()]); } if ($resolvedConstantName === 'PHP_PREFIX') { return new IntersectionType([new StringType(), new AccessoryNonFalsyStringType()]); } if ($resolvedConstantName === 'PHP_BINDIR') { return new IntersectionType([new StringType(), new AccessoryNonFalsyStringType()]); } if ($resolvedConstantName === 'PHP_BINARY') { return new IntersectionType([new StringType(), new AccessoryNonFalsyStringType()]); } if ($resolvedConstantName === 'PHP_MANDIR') { return new IntersectionType([new StringType(), new AccessoryNonFalsyStringType()]); } if ($resolvedConstantName === 'PHP_LIBDIR') { return new IntersectionType([new StringType(), new AccessoryNonFalsyStringType()]); } if ($resolvedConstantName === 'PHP_DATADIR') { return new IntersectionType([new StringType(), new AccessoryNonFalsyStringType()]); } if ($resolvedConstantName === 'PHP_SYSCONFDIR') { return new IntersectionType([new StringType(), new AccessoryNonFalsyStringType()]); } if ($resolvedConstantName === 'PHP_LOCALSTATEDIR') { return new IntersectionType([new StringType(), new AccessoryNonFalsyStringType()]); } if ($resolvedConstantName === 'PHP_CONFIG_FILE_PATH') { return new IntersectionType([new StringType(), new AccessoryNonFalsyStringType()]); } if ($resolvedConstantName === 'PHP_SHLIB_SUFFIX') { return new UnionType([new ConstantStringType('so'), new ConstantStringType('dll')]); } if ($resolvedConstantName === 'PHP_FD_SETSIZE') { return IntegerRangeType::fromInterval(1, null); } if ($resolvedConstantName === '__COMPILER_HALT_OFFSET__') { return IntegerRangeType::fromInterval(1, null); } // core other, https://www.php.net/manual/en/info.constants.php if ($resolvedConstantName === 'PHP_WINDOWS_VERSION_MAJOR') { return IntegerRangeType::fromInterval(4, null); } if ($resolvedConstantName === 'PHP_WINDOWS_VERSION_MINOR') { return IntegerRangeType::fromInterval(0, null); } if ($resolvedConstantName === 'PHP_WINDOWS_VERSION_BUILD') { return IntegerRangeType::fromInterval(1, null); } // dir, https://www.php.net/manual/en/dir.constants.php if ($resolvedConstantName === 'DIRECTORY_SEPARATOR') { return new UnionType([new ConstantStringType('/'), new ConstantStringType('\\')]); } if ($resolvedConstantName === 'PATH_SEPARATOR') { return new UnionType([new ConstantStringType(':'), new ConstantStringType(';')]); } // iconv, https://www.php.net/manual/en/iconv.constants.php if ($resolvedConstantName === 'ICONV_IMPL') { return new IntersectionType([new StringType(), new AccessoryNonFalsyStringType()]); } // libxml, https://www.php.net/manual/en/libxml.constants.php if ($resolvedConstantName === 'LIBXML_VERSION') { return IntegerRangeType::fromInterval(1, null); } if ($resolvedConstantName === 'LIBXML_DOTTED_VERSION') { return new IntersectionType([new StringType(), new AccessoryNonFalsyStringType()]); } // openssl, https://www.php.net/manual/en/openssl.constants.php if ($resolvedConstantName === 'OPENSSL_VERSION_NUMBER') { return IntegerRangeType::fromInterval(1, null); } // pcre, https://www.php.net/manual/en/pcre.constants.php if ($resolvedConstantName === 'PCRE_VERSION') { return new IntersectionType([new StringType(), new AccessoryNonFalsyStringType()]); } if (in_array($resolvedConstantName, ['STDIN', 'STDOUT', 'STDERR'], \true)) { return new ResourceType(); } if ($resolvedConstantName === 'NAN') { return new ConstantFloatType(NAN); } if ($resolvedConstantName === 'INF') { return new ConstantFloatType(INF); } return null; } public function resolveConstantType(string $constantName, Type $constantType) : Type { if ($constantType->isConstantValue()->yes() && in_array($constantName, $this->dynamicConstantNames, \true)) { return $constantType->generalize(GeneralizePrecision::lessSpecific()); } return $constantType; } public function resolveClassConstantType(string $className, string $constantName, Type $constantType, ?Type $nativeType) : Type { $lookupConstantName = sprintf('%s::%s', $className, $constantName); if (in_array($lookupConstantName, $this->dynamicConstantNames, \true)) { if ($nativeType !== null) { return $nativeType; } if ($constantType->isConstantValue()->yes()) { return $constantType->generalize(GeneralizePrecision::lessSpecific()); } } return $constantType; } private function getReflectionProvider() : ReflectionProvider { return $this->reflectionProviderProvider->getReflectionProvider(); } } <?php declare (strict_types=1); namespace PHPStan\Analyser; use Closure; use PHPStan\Collectors\CollectedData; use PHPStan\Collectors\Registry as CollectorRegistry; use PHPStan\Rules\Registry as RuleRegistry; use Throwable; use function array_fill_keys; use function array_merge; use function count; use function memory_get_peak_usage; final class Analyser { /** * @var FileAnalyser */ private $fileAnalyser; /** * @var RuleRegistry */ private $ruleRegistry; /** * @var CollectorRegistry */ private $collectorRegistry; /** * @var NodeScopeResolver */ private $nodeScopeResolver; /** * @var int */ private $internalErrorsCountLimit; public function __construct(\PHPStan\Analyser\FileAnalyser $fileAnalyser, RuleRegistry $ruleRegistry, CollectorRegistry $collectorRegistry, \PHPStan\Analyser\NodeScopeResolver $nodeScopeResolver, int $internalErrorsCountLimit) { $this->fileAnalyser = $fileAnalyser; $this->ruleRegistry = $ruleRegistry; $this->collectorRegistry = $collectorRegistry; $this->nodeScopeResolver = $nodeScopeResolver; $this->internalErrorsCountLimit = $internalErrorsCountLimit; } /** * @param string[] $files * @param Closure(string $file): void|null $preFileCallback * @param Closure(int ): void|null $postFileCallback * @param string[]|null $allAnalysedFiles */ public function analyse(array $files, ?Closure $preFileCallback = null, ?Closure $postFileCallback = null, bool $debug = \false, ?array $allAnalysedFiles = null) : \PHPStan\Analyser\AnalyserResult { if ($allAnalysedFiles === null) { $allAnalysedFiles = $files; } $this->nodeScopeResolver->setAnalysedFiles($allAnalysedFiles); $allAnalysedFiles = array_fill_keys($allAnalysedFiles, \true); /** @var list<Error> $errors */ $errors = []; /** @var list<Error> $filteredPhpErrors */ $filteredPhpErrors = []; /** @var list<Error> $allPhpErrors */ $allPhpErrors = []; /** @var list<Error> $locallyIgnoredErrors */ $locallyIgnoredErrors = []; $linesToIgnore = []; $unmatchedLineIgnores = []; /** @var list<CollectedData> $collectedData */ $collectedData = []; $internalErrorsCount = 0; $reachedInternalErrorsCountLimit = \false; $dependencies = []; $exportedNodes = []; foreach ($files as $file) { if ($preFileCallback !== null) { $preFileCallback($file); } try { $fileAnalyserResult = $this->fileAnalyser->analyseFile($file, $allAnalysedFiles, $this->ruleRegistry, $this->collectorRegistry, null); $errors = array_merge($errors, $fileAnalyserResult->getErrors()); $filteredPhpErrors = array_merge($filteredPhpErrors, $fileAnalyserResult->getFilteredPhpErrors()); $allPhpErrors = array_merge($allPhpErrors, $fileAnalyserResult->getAllPhpErrors()); $locallyIgnoredErrors = array_merge($locallyIgnoredErrors, $fileAnalyserResult->getLocallyIgnoredErrors()); $linesToIgnore[$file] = $fileAnalyserResult->getLinesToIgnore(); $unmatchedLineIgnores[$file] = $fileAnalyserResult->getUnmatchedLineIgnores(); $collectedData = array_merge($collectedData, $fileAnalyserResult->getCollectedData()); $dependencies[$file] = $fileAnalyserResult->getDependencies(); $fileExportedNodes = $fileAnalyserResult->getExportedNodes(); if (count($fileExportedNodes) > 0) { $exportedNodes[$file] = $fileExportedNodes; } } catch (Throwable $t) { if ($debug) { throw $t; } $internalErrorsCount++; $errors[] = (new \PHPStan\Analyser\Error($t->getMessage(), $file, null, $t))->withIdentifier('phpstan.internal')->withMetadata([\PHPStan\Analyser\InternalError::STACK_TRACE_METADATA_KEY => \PHPStan\Analyser\InternalError::prepareTrace($t), \PHPStan\Analyser\InternalError::STACK_TRACE_AS_STRING_METADATA_KEY => $t->getTraceAsString()]); if ($internalErrorsCount >= $this->internalErrorsCountLimit) { $reachedInternalErrorsCountLimit = \true; break; } } if ($postFileCallback === null) { continue; } $postFileCallback(1); } return new \PHPStan\Analyser\AnalyserResult($errors, $filteredPhpErrors, $allPhpErrors, $locallyIgnoredErrors, $linesToIgnore, $unmatchedLineIgnores, [], $collectedData, $internalErrorsCount === 0 ? $dependencies : null, $exportedNodes, $reachedInternalErrorsCountLimit, memory_get_peak_usage(\true)); } } <?php declare (strict_types=1); namespace PHPStan\Analyser; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\MethodReflection; use PHPStan\Reflection\ParameterReflection; use PHPStan\Reflection\ParametersAcceptor; interface InternalScopeFactory { /** * @param array<string, ExpressionTypeHolder> $expressionTypes * @param array<string, ExpressionTypeHolder> $nativeExpressionTypes * @param array<string, ConditionalExpressionHolder[]> $conditionalExpressions * @param list<string> $inClosureBindScopeClasses * @param array<string, true> $currentlyAssignedExpressions * @param array<string, true> $currentlyAllowedUndefinedExpressions * @param list<array{MethodReflection|FunctionReflection|null, ParameterReflection|null}> $inFunctionCallsStack * @param FunctionReflection|MethodReflection|null $function */ public function create(\PHPStan\Analyser\ScopeContext $context, bool $declareStrictTypes = \false, $function = null, ?string $namespace = null, array $expressionTypes = [], array $nativeExpressionTypes = [], array $conditionalExpressions = [], array $inClosureBindScopeClasses = [], ?ParametersAcceptor $anonymousFunctionReflection = null, bool $inFirstLevelStatement = \true, array $currentlyAssignedExpressions = [], array $currentlyAllowedUndefinedExpressions = [], array $inFunctionCallsStack = [], bool $afterExtractCall = \false, ?\PHPStan\Analyser\Scope $parentScope = null, bool $nativeTypesPromoted = \false) : \PHPStan\Analyser\MutatingScope; } <?php declare (strict_types=1); namespace PHPStan\Analyser; use function array_key_exists; use function array_values; use function count; use function is_array; /** * @phpstan-import-type LinesToIgnore from FileAnalyserResult */ final class LocalIgnoresProcessor { /** * @param list<Error> $temporaryFileErrors * @param LinesToIgnore $linesToIgnore * @param LinesToIgnore $unmatchedLineIgnores */ public function process(array $temporaryFileErrors, array $linesToIgnore, array $unmatchedLineIgnores) : \PHPStan\Analyser\LocalIgnoresProcessorResult { $fileErrors = []; $locallyIgnoredErrors = []; foreach ($temporaryFileErrors as $tmpFileError) { $line = $tmpFileError->getLine(); if ($line !== null && $tmpFileError->canBeIgnored() && array_key_exists($tmpFileError->getFile(), $linesToIgnore) && array_key_exists($line, $linesToIgnore[$tmpFileError->getFile()])) { $identifiers = $linesToIgnore[$tmpFileError->getFile()][$line]; if ($identifiers === null) { $locallyIgnoredErrors[] = $tmpFileError; unset($unmatchedLineIgnores[$tmpFileError->getFile()][$line]); continue; } if ($tmpFileError->getIdentifier() === null) { $fileErrors[] = $tmpFileError; continue; } foreach ($identifiers as $i => $ignoredIdentifier) { if ($ignoredIdentifier !== $tmpFileError->getIdentifier()) { continue; } unset($identifiers[$i]); if (count($identifiers) > 0) { $linesToIgnore[$tmpFileError->getFile()][$line] = array_values($identifiers); } else { unset($linesToIgnore[$tmpFileError->getFile()][$line]); } if (array_key_exists($tmpFileError->getFile(), $unmatchedLineIgnores) && array_key_exists($line, $unmatchedLineIgnores[$tmpFileError->getFile()])) { $unmatchedIgnoredIdentifiers = $unmatchedLineIgnores[$tmpFileError->getFile()][$line]; if (is_array($unmatchedIgnoredIdentifiers)) { foreach ($unmatchedIgnoredIdentifiers as $j => $unmatchedIgnoredIdentifier) { if ($ignoredIdentifier !== $unmatchedIgnoredIdentifier) { continue; } unset($unmatchedIgnoredIdentifiers[$j]); if (count($unmatchedIgnoredIdentifiers) > 0) { $unmatchedLineIgnores[$tmpFileError->getFile()][$line] = array_values($unmatchedIgnoredIdentifiers); } else { unset($unmatchedLineIgnores[$tmpFileError->getFile()][$line]); } break; } } } $locallyIgnoredErrors[] = $tmpFileError; continue 2; } } $fileErrors[] = $tmpFileError; } return new \PHPStan\Analyser\LocalIgnoresProcessorResult($fileErrors, $locallyIgnoredErrors, $linesToIgnore, $unmatchedLineIgnores); } } <?php declare (strict_types=1); namespace PHPStan\Analyser; use PHPStan\Node\InvalidateExprNode; final class ProcessClosureResult { /** * @var MutatingScope */ private $scope; /** * @var ThrowPoint[] */ private $throwPoints; /** * @var ImpurePoint[] */ private $impurePoints; /** * @var InvalidateExprNode[] */ private $invalidateExpressions; /** * @param ThrowPoint[] $throwPoints * @param ImpurePoint[] $impurePoints * @param InvalidateExprNode[] $invalidateExpressions */ public function __construct(\PHPStan\Analyser\MutatingScope $scope, array $throwPoints, array $impurePoints, array $invalidateExpressions) { $this->scope = $scope; $this->throwPoints = $throwPoints; $this->impurePoints = $impurePoints; $this->invalidateExpressions = $invalidateExpressions; } public function getScope() : \PHPStan\Analyser\MutatingScope { return $this->scope; } /** * @return ThrowPoint[] */ public function getThrowPoints() : array { return $this->throwPoints; } /** * @return ImpurePoint[] */ public function getImpurePoints() : array { return $this->impurePoints; } /** * @return InvalidateExprNode[] */ public function getInvalidateExpressions() : array { return $this->invalidateExpressions; } } <?php declare (strict_types=1); namespace PHPStan\Analyser; use PHPStan\Type\Type; final class ExpressionContext { /** * @var bool */ private $isDeep; /** * @var ?string */ private $inAssignRightSideVariableName; /** * @var ?Type */ private $inAssignRightSideType; /** * @var ?Type */ private $inAssignRightSideNativeType; private function __construct(bool $isDeep, ?string $inAssignRightSideVariableName, ?Type $inAssignRightSideType, ?Type $inAssignRightSideNativeType) { $this->isDeep = $isDeep; $this->inAssignRightSideVariableName = $inAssignRightSideVariableName; $this->inAssignRightSideType = $inAssignRightSideType; $this->inAssignRightSideNativeType = $inAssignRightSideNativeType; } public static function createTopLevel() : self { return new self(\false, null, null, null); } public static function createDeep() : self { return new self(\true, null, null, null); } public function enterDeep() : self { if ($this->isDeep) { return $this; } return new self(\true, $this->inAssignRightSideVariableName, $this->inAssignRightSideType, $this->inAssignRightSideNativeType); } public function isDeep() : bool { return $this->isDeep; } public function enterRightSideAssign(string $variableName, Type $type, Type $nativeType) : self { return new self($this->isDeep, $variableName, $type, $nativeType); } public function getInAssignRightSideVariableName() : ?string { return $this->inAssignRightSideVariableName; } public function getInAssignRightSideType() : ?Type { return $this->inAssignRightSideType; } public function getInAssignRightSideNativeType() : ?Type { return $this->inAssignRightSideNativeType; } } <?php declare (strict_types=1); namespace PHPStan\Analyser; use PhpParser\Node\Arg; use PhpParser\Node\Expr\FuncCall; use PhpParser\Node\Expr\MethodCall; use PhpParser\Node\Expr\New_; use PhpParser\Node\Expr\StaticCall; use PHPStan\Node\Expr\TypeExpr; use PHPStan\Reflection\ParametersAcceptor; use PHPStan\Reflection\ParametersAcceptorSelector; use PHPStan\ShouldNotHappenException; use PHPStan\Type\Constant\ConstantArrayType; use function array_key_exists; use function array_keys; use function count; use function ksort; use function max; /** * @api */ final class ArgumentsNormalizer { public const ORIGINAL_ARG_ATTRIBUTE = 'originalArg'; /** * @return array{ParametersAcceptor, FuncCall, bool}|null */ public static function reorderCallUserFuncArguments(FuncCall $callUserFuncCall, \PHPStan\Analyser\Scope $scope) : ?array { $args = $callUserFuncCall->getArgs(); if (count($args) < 1) { return null; } $passThruArgs = []; $callbackArg = null; foreach ($args as $i => $arg) { if ($callbackArg === null) { if ($arg->name === null && $i === 0) { $callbackArg = $arg; continue; } if ($arg->name !== null && $arg->name->toString() === 'callback') { $callbackArg = $arg; continue; } } $passThruArgs[] = $arg; } if ($callbackArg === null) { return null; } $calledOnType = $scope->getType($callbackArg->value); if (!$calledOnType->isCallable()->yes()) { return null; } $callableParametersAcceptors = $calledOnType->getCallableParametersAcceptors($scope); $parametersAcceptor = ParametersAcceptorSelector::selectFromArgs($scope, $passThruArgs, $callableParametersAcceptors, null); $acceptsNamedArguments = \true; foreach ($callableParametersAcceptors as $callableParametersAcceptor) { $acceptsNamedArguments = $acceptsNamedArguments && $callableParametersAcceptor->acceptsNamedArguments(); } return [$parametersAcceptor, new FuncCall($callbackArg->value, $passThruArgs, $callUserFuncCall->getAttributes()), $acceptsNamedArguments]; } public static function reorderFuncArguments(ParametersAcceptor $parametersAcceptor, FuncCall $functionCall) : ?FuncCall { $reorderedArgs = self::reorderArgs($parametersAcceptor, $functionCall->getArgs()); if ($reorderedArgs === null) { return null; } return new FuncCall($functionCall->name, $reorderedArgs, $functionCall->getAttributes()); } public static function reorderMethodArguments(ParametersAcceptor $parametersAcceptor, MethodCall $methodCall) : ?MethodCall { $reorderedArgs = self::reorderArgs($parametersAcceptor, $methodCall->getArgs()); if ($reorderedArgs === null) { return null; } return new MethodCall($methodCall->var, $methodCall->name, $reorderedArgs, $methodCall->getAttributes()); } public static function reorderStaticCallArguments(ParametersAcceptor $parametersAcceptor, StaticCall $staticCall) : ?StaticCall { $reorderedArgs = self::reorderArgs($parametersAcceptor, $staticCall->getArgs()); if ($reorderedArgs === null) { return null; } return new StaticCall($staticCall->class, $staticCall->name, $reorderedArgs, $staticCall->getAttributes()); } public static function reorderNewArguments(ParametersAcceptor $parametersAcceptor, New_ $new) : ?New_ { $reorderedArgs = self::reorderArgs($parametersAcceptor, $new->getArgs()); if ($reorderedArgs === null) { return null; } return new New_($new->class, $reorderedArgs, $new->getAttributes()); } /** * @param Arg[] $callArgs * @return ?array<int, Arg> */ public static function reorderArgs(ParametersAcceptor $parametersAcceptor, array $callArgs) : ?array { if (count($callArgs) === 0) { return []; } $signatureParameters = $parametersAcceptor->getParameters(); $hasNamedArgs = \false; foreach ($callArgs as $arg) { if ($arg->name !== null) { $hasNamedArgs = \true; break; } } if (!$hasNamedArgs) { return $callArgs; } $hasVariadic = \false; $argumentPositions = []; foreach ($signatureParameters as $i => $parameter) { if ($hasVariadic) { // variadic parameter must be last return null; } $hasVariadic = $parameter->isVariadic(); $argumentPositions[$parameter->getName()] = $i; } $reorderedArgs = []; $additionalNamedArgs = []; $appendArgs = []; foreach ($callArgs as $i => $arg) { if ($arg->name === null) { // add regular args as is $reorderedArgs[$i] = $arg; } elseif (array_key_exists($arg->name->toString(), $argumentPositions)) { $argName = $arg->name->toString(); // order named args into the position the signature expects them $attributes = $arg->getAttributes(); $attributes[self::ORIGINAL_ARG_ATTRIBUTE] = $arg; $reorderedArgs[$argumentPositions[$argName]] = new Arg($arg->value, $arg->byRef, $arg->unpack, $attributes, null); } else { if (!$hasVariadic) { $attributes = $arg->getAttributes(); $attributes[self::ORIGINAL_ARG_ATTRIBUTE] = $arg; $appendArgs[] = new Arg($arg->value, $arg->byRef, $arg->unpack, $attributes, null); continue; } $attributes = $arg->getAttributes(); $attributes[self::ORIGINAL_ARG_ATTRIBUTE] = $arg; $additionalNamedArgs[] = new Arg($arg->value, $arg->byRef, $arg->unpack, $attributes, null); } } // replace variadic parameter with additional named args, except if it is already set $additionalNamedArgsOffset = count($argumentPositions) - 1; if (array_key_exists($additionalNamedArgsOffset, $reorderedArgs)) { $additionalNamedArgsOffset++; } foreach ($additionalNamedArgs as $i => $additionalNamedArg) { $reorderedArgs[$additionalNamedArgsOffset + $i] = $additionalNamedArg; } if (count($reorderedArgs) === 0) { foreach ($appendArgs as $arg) { $reorderedArgs[] = $arg; } return $reorderedArgs; } // fill up all holes with default values until the last given argument for ($j = 0; $j < max(array_keys($reorderedArgs)); $j++) { if (array_key_exists($j, $reorderedArgs)) { continue; } if (!array_key_exists($j, $signatureParameters)) { throw new ShouldNotHappenException('Parameter signatures cannot have holes'); } $parameter = $signatureParameters[$j]; // we can only fill up optional parameters with default values if (!$parameter->isOptional()) { return null; } $defaultValue = $parameter->getDefaultValue(); if ($defaultValue === null) { if (!$parameter->isVariadic()) { throw new ShouldNotHappenException('An optional parameter must have a default value'); } $defaultValue = new ConstantArrayType([], []); } $reorderedArgs[$j] = new Arg(new TypeExpr($defaultValue)); } ksort($reorderedArgs); foreach ($appendArgs as $arg) { $reorderedArgs[] = $arg; } return $reorderedArgs; } } <?php declare (strict_types=1); namespace PHPStan\Analyser; /** @api */ interface TypeSpecifierAwareExtension { public function setTypeSpecifier(\PHPStan\Analyser\TypeSpecifier $typeSpecifier) : void; } <?php declare (strict_types=1); namespace PHPStan\Analyser; use PHPStan\AnalysedCodeException; use PHPStan\BetterReflection\NodeCompiler\Exception\UnableToCompileNode; use PHPStan\BetterReflection\Reflection\Exception\CircularReference; use PHPStan\BetterReflection\Reflector\Exception\IdentifierNotFound; use PHPStan\Node\CollectedDataNode; use PHPStan\Rules\Registry as RuleRegistry; use Throwable; use function array_merge; use function count; use function get_class; use function sprintf; final class AnalyserResultFinalizer { /** * @var RuleRegistry */ private $ruleRegistry; /** * @var RuleErrorTransformer */ private $ruleErrorTransformer; /** * @var ScopeFactory */ private $scopeFactory; /** * @var LocalIgnoresProcessor */ private $localIgnoresProcessor; /** * @var bool */ private $reportUnmatchedIgnoredErrors; public function __construct(RuleRegistry $ruleRegistry, \PHPStan\Analyser\RuleErrorTransformer $ruleErrorTransformer, \PHPStan\Analyser\ScopeFactory $scopeFactory, \PHPStan\Analyser\LocalIgnoresProcessor $localIgnoresProcessor, bool $reportUnmatchedIgnoredErrors) { $this->ruleRegistry = $ruleRegistry; $this->ruleErrorTransformer = $ruleErrorTransformer; $this->scopeFactory = $scopeFactory; $this->localIgnoresProcessor = $localIgnoresProcessor; $this->reportUnmatchedIgnoredErrors = $reportUnmatchedIgnoredErrors; } public function finalize(\PHPStan\Analyser\AnalyserResult $analyserResult, bool $onlyFiles, bool $debug) : \PHPStan\Analyser\FinalizerResult { if (count($analyserResult->getCollectedData()) === 0) { return $this->addUnmatchedIgnoredErrors($this->mergeFilteredPhpErrors($analyserResult), [], []); } $hasInternalErrors = count($analyserResult->getInternalErrors()) > 0 || $analyserResult->hasReachedInternalErrorsCountLimit(); if ($hasInternalErrors) { return $this->addUnmatchedIgnoredErrors($this->mergeFilteredPhpErrors($analyserResult), [], []); } $nodeType = CollectedDataNode::class; $node = new CollectedDataNode($analyserResult->getCollectedData(), $onlyFiles); $file = 'N/A'; $scope = $this->scopeFactory->create(\PHPStan\Analyser\ScopeContext::create($file)); $tempCollectorErrors = []; $internalErrors = $analyserResult->getInternalErrors(); foreach ($this->ruleRegistry->getRules($nodeType) as $rule) { try { $ruleErrors = $rule->processNode($node, $scope); } catch (AnalysedCodeException $e) { $tempCollectorErrors[] = (new \PHPStan\Analyser\Error($e->getMessage(), $file, $node->getStartLine(), $e, null, null, $e->getTip()))->withIdentifier('phpstan.internal')->withMetadata([\PHPStan\Analyser\InternalError::STACK_TRACE_METADATA_KEY => \PHPStan\Analyser\InternalError::prepareTrace($e), \PHPStan\Analyser\InternalError::STACK_TRACE_AS_STRING_METADATA_KEY => $e->getTraceAsString()]); continue; } catch (IdentifierNotFound $e) { $tempCollectorErrors[] = (new \PHPStan\Analyser\Error(sprintf('Reflection error: %s not found.', $e->getIdentifier()->getName()), $file, $node->getStartLine(), $e, null, null, 'Learn more at https://phpstan.org/user-guide/discovering-symbols'))->withIdentifier('phpstan.reflection')->withMetadata([\PHPStan\Analyser\InternalError::STACK_TRACE_METADATA_KEY => \PHPStan\Analyser\InternalError::prepareTrace($e), \PHPStan\Analyser\InternalError::STACK_TRACE_AS_STRING_METADATA_KEY => $e->getTraceAsString()]); continue; } catch (UnableToCompileNode|CircularReference $e) { $tempCollectorErrors[] = (new \PHPStan\Analyser\Error(sprintf('Reflection error: %s', $e->getMessage()), $file, $node->getStartLine(), $e))->withIdentifier('phpstan.reflection')->withMetadata([\PHPStan\Analyser\InternalError::STACK_TRACE_METADATA_KEY => \PHPStan\Analyser\InternalError::prepareTrace($e), \PHPStan\Analyser\InternalError::STACK_TRACE_AS_STRING_METADATA_KEY => $e->getTraceAsString()]); continue; } catch (Throwable $t) { if ($debug) { throw $t; } $internalErrors[] = new \PHPStan\Analyser\InternalError($t->getMessage(), sprintf('running CollectedDataNode rule %s', get_class($rule)), \PHPStan\Analyser\InternalError::prepareTrace($t), $t->getTraceAsString(), \true); continue; } foreach ($ruleErrors as $ruleError) { $tempCollectorErrors[] = $this->ruleErrorTransformer->transform($ruleError, $scope, $nodeType, $node->getStartLine()); } } $errors = $analyserResult->getUnorderedErrors(); $locallyIgnoredErrors = $analyserResult->getLocallyIgnoredErrors(); $allLinesToIgnore = $analyserResult->getLinesToIgnore(); $allUnmatchedLineIgnores = $analyserResult->getUnmatchedLineIgnores(); $collectorErrors = []; $locallyIgnoredCollectorErrors = []; foreach ($tempCollectorErrors as $tempCollectorError) { $file = $tempCollectorError->getFilePath(); $linesToIgnore = $allLinesToIgnore[$file] ?? []; $unmatchedLineIgnores = $allUnmatchedLineIgnores[$file] ?? []; $localIgnoresProcessorResult = $this->localIgnoresProcessor->process([$tempCollectorError], $linesToIgnore, $unmatchedLineIgnores); foreach ($localIgnoresProcessorResult->getFileErrors() as $error) { $errors[] = $error; $collectorErrors[] = $error; } foreach ($localIgnoresProcessorResult->getLocallyIgnoredErrors() as $locallyIgnoredError) { $locallyIgnoredErrors[] = $locallyIgnoredError; $locallyIgnoredCollectorErrors[] = $locallyIgnoredError; } $allLinesToIgnore[$file] = $localIgnoresProcessorResult->getLinesToIgnore(); $allUnmatchedLineIgnores[$file] = $localIgnoresProcessorResult->getUnmatchedLineIgnores(); } return $this->addUnmatchedIgnoredErrors(new \PHPStan\Analyser\AnalyserResult(array_merge($errors, $analyserResult->getFilteredPhpErrors()), [], $analyserResult->getAllPhpErrors(), $locallyIgnoredErrors, $allLinesToIgnore, $allUnmatchedLineIgnores, $internalErrors, $analyserResult->getCollectedData(), $analyserResult->getDependencies(), $analyserResult->getExportedNodes(), $analyserResult->hasReachedInternalErrorsCountLimit(), $analyserResult->getPeakMemoryUsageBytes()), $collectorErrors, $locallyIgnoredCollectorErrors); } private function mergeFilteredPhpErrors(\PHPStan\Analyser\AnalyserResult $analyserResult) : \PHPStan\Analyser\AnalyserResult { return new \PHPStan\Analyser\AnalyserResult(array_merge($analyserResult->getUnorderedErrors(), $analyserResult->getFilteredPhpErrors()), [], $analyserResult->getAllPhpErrors(), $analyserResult->getLocallyIgnoredErrors(), $analyserResult->getLinesToIgnore(), $analyserResult->getUnmatchedLineIgnores(), $analyserResult->getInternalErrors(), $analyserResult->getCollectedData(), $analyserResult->getDependencies(), $analyserResult->getExportedNodes(), $analyserResult->hasReachedInternalErrorsCountLimit(), $analyserResult->getPeakMemoryUsageBytes()); } /** * @param list<Error> $collectorErrors * @param list<Error> $locallyIgnoredCollectorErrors */ private function addUnmatchedIgnoredErrors(\PHPStan\Analyser\AnalyserResult $analyserResult, array $collectorErrors, array $locallyIgnoredCollectorErrors) : \PHPStan\Analyser\FinalizerResult { if (!$this->reportUnmatchedIgnoredErrors) { return new \PHPStan\Analyser\FinalizerResult($analyserResult, $collectorErrors, $locallyIgnoredCollectorErrors); } $errors = $analyserResult->getUnorderedErrors(); foreach ($analyserResult->getUnmatchedLineIgnores() as $file => $data) { foreach ($data as $ignoredFile => $lines) { if ($ignoredFile !== $file) { continue; } foreach ($lines as $line => $identifiers) { if ($identifiers === null) { $errors[] = (new \PHPStan\Analyser\Error(sprintf('No error to ignore is reported on line %d.', $line), $file, $line, \false, $file))->withIdentifier('ignore.unmatchedLine'); continue; } foreach ($identifiers as $identifier) { $errors[] = (new \PHPStan\Analyser\Error(sprintf('No error with identifier %s is reported on line %d.', $identifier, $line), $file, $line, \false, $file))->withIdentifier('ignore.unmatchedIdentifier'); } } } } return new \PHPStan\Analyser\FinalizerResult(new \PHPStan\Analyser\AnalyserResult($errors, $analyserResult->getFilteredPhpErrors(), $analyserResult->getAllPhpErrors(), $analyserResult->getLocallyIgnoredErrors(), $analyserResult->getLinesToIgnore(), $analyserResult->getUnmatchedLineIgnores(), $analyserResult->getInternalErrors(), $analyserResult->getCollectedData(), $analyserResult->getDependencies(), $analyserResult->getExportedNodes(), $analyserResult->hasReachedInternalErrorsCountLimit(), $analyserResult->getPeakMemoryUsageBytes()), $collectorErrors, $locallyIgnoredCollectorErrors); } } <?php declare (strict_types=1); namespace PHPStan\Analyser; use PHPStan\Reflection\ClassReflection; use PHPStan\ShouldNotHappenException; final class ScopeContext { /** * @var string */ private $file; /** * @var ?ClassReflection */ private $classReflection; /** * @var ?ClassReflection */ private $traitReflection; private function __construct(string $file, ?ClassReflection $classReflection, ?ClassReflection $traitReflection) { $this->file = $file; $this->classReflection = $classReflection; $this->traitReflection = $traitReflection; } /** @api */ public static function create(string $file) : self { return new self($file, null, null); } public function beginFile() : self { return new self($this->file, null, null); } public function enterClass(ClassReflection $classReflection) : self { if ($this->classReflection !== null && !$classReflection->isAnonymous()) { throw new ShouldNotHappenException(); } if ($classReflection->isTrait()) { throw new ShouldNotHappenException(); } return new self($this->file, $classReflection, null); } public function enterTrait(ClassReflection $traitReflection) : self { if ($this->classReflection === null) { throw new ShouldNotHappenException(); } if (!$traitReflection->isTrait()) { throw new ShouldNotHappenException(); } return new self($this->file, $this->classReflection, $traitReflection); } public function equals(self $otherContext) : bool { if ($this->file !== $otherContext->file) { return \false; } if ($this->getClassReflection() === null) { return $otherContext->getClassReflection() === null; } elseif ($otherContext->getClassReflection() === null) { return \false; } $isSameClass = $this->getClassReflection()->getName() === $otherContext->getClassReflection()->getName(); if ($this->getTraitReflection() === null) { return $otherContext->getTraitReflection() === null && $isSameClass; } elseif ($otherContext->getTraitReflection() === null) { return \false; } $isSameTrait = $this->getTraitReflection()->getName() === $otherContext->getTraitReflection()->getName(); return $isSameClass && $isSameTrait; } public function getFile() : string { return $this->file; } public function getClassReflection() : ?ClassReflection { return $this->classReflection; } public function getTraitReflection() : ?ClassReflection { return $this->traitReflection; } } <?php declare (strict_types=1); namespace PHPStan\Analyser; use PhpParser\Node; use PHPStan\Type\ObjectType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use Throwable; /** * @api * @final */ class ThrowPoint { /** * @var MutatingScope */ private $scope; /** * @var Type */ private $type; /** * @var Node\Expr|Node\Stmt */ private $node; /** * @var bool */ private $explicit; /** * @var bool */ private $canContainAnyThrowable; /** * @param Node\Expr|Node\Stmt $node */ private function __construct(\PHPStan\Analyser\MutatingScope $scope, Type $type, Node $node, bool $explicit, bool $canContainAnyThrowable) { $this->scope = $scope; $this->type = $type; $this->node = $node; $this->explicit = $explicit; $this->canContainAnyThrowable = $canContainAnyThrowable; } /** * @param Node\Expr|Node\Stmt $node */ public static function createExplicit(\PHPStan\Analyser\MutatingScope $scope, Type $type, Node $node, bool $canContainAnyThrowable) : self { return new self($scope, $type, $node, \true, $canContainAnyThrowable); } /** * @param Node\Expr|Node\Stmt $node */ public static function createImplicit(\PHPStan\Analyser\MutatingScope $scope, Node $node) : self { return new self($scope, new ObjectType(Throwable::class), $node, \false, \true); } public function getScope() : \PHPStan\Analyser\MutatingScope { return $this->scope; } public function getType() : Type { return $this->type; } /** * @return Node\Expr|Node\Stmt */ public function getNode() { return $this->node; } public function isExplicit() : bool { return $this->explicit; } public function canContainAnyThrowable() : bool { return $this->canContainAnyThrowable; } public function subtractCatchType(Type $catchType) : self { return new self($this->scope, TypeCombinator::remove($this->type, $catchType), $this->node, $this->explicit, $this->canContainAnyThrowable); } } <?php declare (strict_types=1); namespace PHPStan\Analyser; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\Generic\TemplateTypeScope; use PHPStan\Type\Type; use function array_key_exists; use function array_merge; use function array_shift; use function count; use function explode; use function implode; use function ltrim; use function sprintf; use function str_starts_with; use function strtolower; /** * @api * @final */ class NameScope { /** * @var non-empty-string|null */ private $namespace; /** * @var array<string, string> */ private $uses; /** * @var ?string */ private $className; /** * @var ?string */ private $functionName; /** * @var array<string, true> */ private $typeAliasesMap; /** * @var bool */ private $bypassTypeAliases; /** * @var array<string, string> */ private $constUses; /** * @var ?string */ private $typeAliasClassName; /** * @var TemplateTypeMap */ private $templateTypeMap; /** * @api * @param non-empty-string|null $namespace * @param array<string, string> $uses alias(string) => fullName(string) * @param array<string, string> $constUses alias(string) => fullName(string) * @param array<string, true> $typeAliasesMap */ public function __construct(?string $namespace, array $uses, ?string $className = null, ?string $functionName = null, ?TemplateTypeMap $templateTypeMap = null, array $typeAliasesMap = [], bool $bypassTypeAliases = \false, array $constUses = [], ?string $typeAliasClassName = null) { $this->namespace = $namespace; $this->uses = $uses; $this->className = $className; $this->functionName = $functionName; $this->typeAliasesMap = $typeAliasesMap; $this->bypassTypeAliases = $bypassTypeAliases; $this->constUses = $constUses; $this->typeAliasClassName = $typeAliasClassName; $this->templateTypeMap = $templateTypeMap ?? TemplateTypeMap::createEmpty(); } public function getNamespace() : ?string { return $this->namespace; } /** * @return array<string, string> */ public function getUses() : array { return $this->uses; } public function hasUseAlias(string $name) : bool { return isset($this->uses[strtolower($name)]); } /** * @return array<string, string> */ public function getConstUses() : array { return $this->constUses; } public function getClassName() : ?string { return $this->className; } public function getClassNameForTypeAlias() : ?string { return $this->typeAliasClassName ?? $this->className; } public function resolveStringName(string $name) : string { if (str_starts_with($name, '\\')) { return ltrim($name, '\\'); } $nameParts = explode('\\', $name); $firstNamePart = strtolower($nameParts[0]); if (isset($this->uses[$firstNamePart])) { if (count($nameParts) === 1) { return $this->uses[$firstNamePart]; } array_shift($nameParts); return sprintf('%s\\%s', $this->uses[$firstNamePart], implode('\\', $nameParts)); } if ($this->namespace !== null) { return sprintf('%s\\%s', $this->namespace, $name); } return $name; } /** * @return non-empty-list<string> */ public function resolveConstantNames(string $name) : array { if (str_starts_with($name, '\\')) { return [ltrim($name, '\\')]; } $nameParts = explode('\\', $name); $firstNamePart = strtolower($nameParts[0]); if (count($nameParts) > 1) { if (isset($this->uses[$firstNamePart])) { array_shift($nameParts); return [sprintf('%s\\%s', $this->uses[$firstNamePart], implode('\\', $nameParts))]; } } elseif (isset($this->constUses[$firstNamePart])) { return [$this->constUses[$firstNamePart]]; } if ($this->namespace !== null) { return [sprintf('%s\\%s', $this->namespace, $name), $name]; } return [$name]; } public function getTemplateTypeScope() : ?TemplateTypeScope { if ($this->className !== null) { if ($this->functionName !== null) { return TemplateTypeScope::createWithMethod($this->className, $this->functionName); } return TemplateTypeScope::createWithClass($this->className); } if ($this->functionName !== null) { return TemplateTypeScope::createWithFunction($this->functionName); } return null; } public function getTemplateTypeMap() : TemplateTypeMap { return $this->templateTypeMap; } public function resolveTemplateTypeName(string $name) : ?Type { return $this->templateTypeMap->getType($name); } public function withTemplateTypeMap(TemplateTypeMap $map) : self { if ($map->isEmpty() && $this->templateTypeMap->isEmpty()) { return $this; } return new self($this->namespace, $this->uses, $this->className, $this->functionName, new TemplateTypeMap(array_merge($this->templateTypeMap->getTypes(), $map->getTypes())), $this->typeAliasesMap, $this->bypassTypeAliases, $this->constUses); } public function withClassName(string $className) : self { return new self($this->namespace, $this->uses, $className, $this->functionName, $this->templateTypeMap, $this->typeAliasesMap, $this->bypassTypeAliases, $this->constUses); } public function unsetTemplateType(string $name) : self { $map = $this->templateTypeMap; if (!$map->hasType($name)) { return $this; } return new self($this->namespace, $this->uses, $this->className, $this->functionName, $this->templateTypeMap->unsetType($name), $this->typeAliasesMap, $this->bypassTypeAliases, $this->constUses); } public function bypassTypeAliases() : self { return new self($this->namespace, $this->uses, $this->className, $this->functionName, $this->templateTypeMap, $this->typeAliasesMap, \true, $this->constUses); } public function shouldBypassTypeAliases() : bool { return $this->bypassTypeAliases; } public function hasTypeAlias(string $alias) : bool { return array_key_exists($alias, $this->typeAliasesMap); } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : self { return new self($properties['namespace'], $properties['uses'], $properties['className'], $properties['functionName'], $properties['templateTypeMap'], $properties['typeAliasesMap'], $properties['bypassTypeAliases'], $properties['constUses']); } } <?php declare (strict_types=1); namespace PHPStan\Analyser; use PhpParser\Node\Expr; use PHPStan\TrinaryLogic; use PHPStan\Type\Type; final class EnsuredNonNullabilityResultExpression { /** * @var Expr */ private $expression; /** * @var Type */ private $originalType; /** * @var Type */ private $originalNativeType; /** * @var TrinaryLogic */ private $certainty; public function __construct(Expr $expression, Type $originalType, Type $originalNativeType, TrinaryLogic $certainty) { $this->expression = $expression; $this->originalType = $originalType; $this->originalNativeType = $originalNativeType; $this->certainty = $certainty; } public function getExpression() : Expr { return $this->expression; } public function getOriginalType() : Type { return $this->originalType; } public function getOriginalNativeType() : Type { return $this->originalNativeType; } public function getCertainty() : TrinaryLogic { return $this->certainty; } } <?php declare (strict_types=1); namespace PHPStan\Analyser; use PhpParser\Node; use PhpParser\Node\Expr; use PhpParser\Node\Name; use PhpParser\Node\Param; use PHPStan\Reflection\ClassMemberAccessAnswerer; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ConstantReflection; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\ExtendedPropertyReflection; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\MethodReflection; use PHPStan\Reflection\NamespaceAnswerer; use PHPStan\Reflection\ParameterReflection; use PHPStan\Reflection\ParametersAcceptor; use PHPStan\Reflection\Php\PhpFunctionFromParserNodeReflection; use PHPStan\TrinaryLogic; use PHPStan\Type\Type; use PHPStan\Type\TypeWithClassName; /** @api */ interface Scope extends ClassMemberAccessAnswerer, NamespaceAnswerer { public const SUPERGLOBAL_VARIABLES = ['GLOBALS', '_SERVER', '_GET', '_POST', '_FILES', '_COOKIE', '_SESSION', '_REQUEST', '_ENV']; public function getFile() : string; public function getFileDescription() : string; public function isDeclareStrictTypes() : bool; /** * @phpstan-assert-if-true !null $this->getTraitReflection() */ public function isInTrait() : bool; public function getTraitReflection() : ?ClassReflection; public function getFunction() : ?PhpFunctionFromParserNodeReflection; public function getFunctionName() : ?string; public function getParentScope() : ?self; public function hasVariableType(string $variableName) : TrinaryLogic; public function getVariableType(string $variableName) : Type; public function canAnyVariableExist() : bool; /** * @return array<int, string> */ public function getDefinedVariables() : array; /** * @return array<int, string> */ public function getMaybeDefinedVariables() : array; public function hasConstant(Name $name) : bool; public function getPropertyReflection(Type $typeWithProperty, string $propertyName) : ?ExtendedPropertyReflection; public function getMethodReflection(Type $typeWithMethod, string $methodName) : ?ExtendedMethodReflection; public function getConstantReflection(Type $typeWithConstant, string $constantName) : ?ConstantReflection; public function getIterableKeyType(Type $iteratee) : Type; public function getIterableValueType(Type $iteratee) : Type; public function isInAnonymousFunction() : bool; public function getAnonymousFunctionReflection() : ?ParametersAcceptor; public function getAnonymousFunctionReturnType() : ?Type; public function getType(Expr $node) : Type; public function getNativeType(Expr $expr) : Type; public function getKeepVoidType(Expr $node) : Type; /** * @deprecated Use getNativeType() */ public function doNotTreatPhpDocTypesAsCertain() : self; public function resolveName(Name $name) : string; public function resolveTypeByName(Name $name) : TypeWithClassName; /** * @param mixed $value */ public function getTypeFromValue($value) : Type; /** @deprecated use hasExpressionType instead */ public function isSpecified(Expr $node) : bool; public function hasExpressionType(Expr $node) : TrinaryLogic; public function isInClassExists(string $className) : bool; public function isInFunctionExists(string $functionName) : bool; public function isInClosureBind() : bool; /** @return list<FunctionReflection|MethodReflection> */ public function getFunctionCallStack() : array; /** @return list<array{FunctionReflection|MethodReflection, ParameterReflection|null}> */ public function getFunctionCallStackWithParameters() : array; public function isParameterValueNullable(Param $parameter) : bool; /** * @param Node\Name|Node\Identifier|Node\ComplexType|null $type */ public function getFunctionType($type, bool $isNullable, bool $isVariadic) : Type; public function isInExpressionAssign(Expr $expr) : bool; public function isUndefinedExpressionAllowed(Expr $expr) : bool; public function filterByTruthyValue(Expr $expr) : self; public function filterByFalseyValue(Expr $expr) : self; public function isInFirstLevelStatement() : bool; } <?php declare (strict_types=1); namespace PHPStan\Analyser; use PHPStan\DependencyInjection\Container; use PHPStan\Reflection\ReflectionProvider\ReflectionProviderProvider; final class ConstantResolverFactory { /** * @var ReflectionProviderProvider */ private $reflectionProviderProvider; /** * @var Container */ private $container; public function __construct(ReflectionProviderProvider $reflectionProviderProvider, Container $container) { $this->reflectionProviderProvider = $reflectionProviderProvider; $this->container = $container; } public function create() : \PHPStan\Analyser\ConstantResolver { return new \PHPStan\Analyser\ConstantResolver($this->reflectionProviderProvider, $this->container->getParameter('dynamicConstantNames')); } } <?php declare (strict_types=1); namespace PHPStan\Analyser\Ignore; use PHPStan\Analyser\Error; final class IgnoredErrorHelperProcessedResult { /** * @var list<Error> */ private $notIgnoredErrors; /** * @var list<array{Error, mixed[]|string}> */ private $ignoredErrors; /** * @var list<string> */ private $otherIgnoreMessages; /** * @param list<Error> $notIgnoredErrors * @param list<array{Error, mixed[]|string}> $ignoredErrors * @param list<string> $otherIgnoreMessages */ public function __construct(array $notIgnoredErrors, array $ignoredErrors, array $otherIgnoreMessages) { $this->notIgnoredErrors = $notIgnoredErrors; $this->ignoredErrors = $ignoredErrors; $this->otherIgnoreMessages = $otherIgnoreMessages; } /** * @return list<Error> */ public function getNotIgnoredErrors() : array { return $this->notIgnoredErrors; } /** * @return list<array{Error, mixed[]|string}> */ public function getIgnoredErrors() : array { return $this->ignoredErrors; } /** * @return list<string> */ public function getOtherIgnoreMessages() : array { return $this->otherIgnoreMessages; } } <?php declare (strict_types=1); namespace PHPStan\Analyser\Ignore; use PHPStan\Analyser\Error; use PHPStan\File\FileHelper; use PHPStan\ShouldNotHappenException; use function array_fill_keys; use function array_key_exists; use function array_values; use function count; use function is_array; use function is_string; use function sprintf; final class IgnoredErrorHelperResult { /** * @var FileHelper */ private $fileHelper; /** * @var list<string> */ private $errors; /** * @var array<array<mixed>> */ private $otherIgnoreErrors; /** * @var array<string, array<array<mixed>>> */ private $ignoreErrorsByFile; /** * @var (string|mixed[])[] */ private $ignoreErrors; /** * @var bool */ private $reportUnmatchedIgnoredErrors; /** * @param list<string> $errors * @param array<array<mixed>> $otherIgnoreErrors * @param array<string, array<array<mixed>>> $ignoreErrorsByFile * @param (string|mixed[])[] $ignoreErrors */ public function __construct(FileHelper $fileHelper, array $errors, array $otherIgnoreErrors, array $ignoreErrorsByFile, array $ignoreErrors, bool $reportUnmatchedIgnoredErrors) { $this->fileHelper = $fileHelper; $this->errors = $errors; $this->otherIgnoreErrors = $otherIgnoreErrors; $this->ignoreErrorsByFile = $ignoreErrorsByFile; $this->ignoreErrors = $ignoreErrors; $this->reportUnmatchedIgnoredErrors = $reportUnmatchedIgnoredErrors; } /** * @return list<string> */ public function getErrors() : array { return $this->errors; } /** * @param Error[] $errors * @param string[] $analysedFiles */ public function process(array $errors, bool $onlyFiles, array $analysedFiles, bool $hasInternalErrors) : \PHPStan\Analyser\Ignore\IgnoredErrorHelperProcessedResult { $unmatchedIgnoredErrors = $this->ignoreErrors; $stringErrors = []; $processIgnoreError = function (Error $error, int $i, $ignore) use(&$unmatchedIgnoredErrors, &$stringErrors) : bool { $shouldBeIgnored = \false; if (is_string($ignore)) { $shouldBeIgnored = \PHPStan\Analyser\Ignore\IgnoredError::shouldIgnore($this->fileHelper, $error, $ignore, null, null); if ($shouldBeIgnored) { unset($unmatchedIgnoredErrors[$i]); } } else { if (isset($ignore['path'])) { $shouldBeIgnored = \PHPStan\Analyser\Ignore\IgnoredError::shouldIgnore($this->fileHelper, $error, $ignore['message'] ?? null, $ignore['identifier'] ?? null, $ignore['path']); if ($shouldBeIgnored) { if (isset($ignore['count'])) { $realCount = $unmatchedIgnoredErrors[$i]['realCount'] ?? 0; $realCount++; $unmatchedIgnoredErrors[$i]['realCount'] = $realCount; if (!isset($unmatchedIgnoredErrors[$i]['file'])) { $unmatchedIgnoredErrors[$i]['file'] = $error->getFile(); $unmatchedIgnoredErrors[$i]['line'] = $error->getLine(); } if ($realCount > $ignore['count']) { $shouldBeIgnored = \false; } } else { unset($unmatchedIgnoredErrors[$i]); } } } elseif (isset($ignore['paths'])) { foreach ($ignore['paths'] as $j => $ignorePath) { $shouldBeIgnored = \PHPStan\Analyser\Ignore\IgnoredError::shouldIgnore($this->fileHelper, $error, $ignore['message'] ?? null, $ignore['identifier'] ?? null, $ignorePath); if (!$shouldBeIgnored) { continue; } if (isset($unmatchedIgnoredErrors[$i])) { if (!is_array($unmatchedIgnoredErrors[$i])) { throw new ShouldNotHappenException(); } unset($unmatchedIgnoredErrors[$i]['paths'][$j]); if (isset($unmatchedIgnoredErrors[$i]['paths']) && count($unmatchedIgnoredErrors[$i]['paths']) === 0) { unset($unmatchedIgnoredErrors[$i]); } } break; } } else { $shouldBeIgnored = \PHPStan\Analyser\Ignore\IgnoredError::shouldIgnore($this->fileHelper, $error, $ignore['message'] ?? null, $ignore['identifier'] ?? null, null); if ($shouldBeIgnored) { unset($unmatchedIgnoredErrors[$i]); } } } if ($shouldBeIgnored) { if (!$error->canBeIgnored()) { $stringErrors[] = sprintf('Error message "%s" cannot be ignored, use excludePaths instead.', $error->getMessage()); return \true; } return \false; } return \true; }; $ignoredErrors = []; foreach ($errors as $errorIndex => $error) { $filePath = $this->fileHelper->normalizePath($error->getFilePath()); if (isset($this->ignoreErrorsByFile[$filePath])) { foreach ($this->ignoreErrorsByFile[$filePath] as $ignoreError) { $i = $ignoreError['index']; $ignore = $ignoreError['ignoreError']; $result = $processIgnoreError($error, $i, $ignore); if (!$result) { unset($errors[$errorIndex]); $ignoredErrors[] = [$error, $ignore]; continue 2; } } } $traitFilePath = $error->getTraitFilePath(); if ($traitFilePath !== null) { $normalizedTraitFilePath = $this->fileHelper->normalizePath($traitFilePath); if (isset($this->ignoreErrorsByFile[$normalizedTraitFilePath])) { foreach ($this->ignoreErrorsByFile[$normalizedTraitFilePath] as $ignoreError) { $i = $ignoreError['index']; $ignore = $ignoreError['ignoreError']; $result = $processIgnoreError($error, $i, $ignore); if (!$result) { unset($errors[$errorIndex]); $ignoredErrors[] = [$error, $ignore]; continue 2; } } } } foreach ($this->otherIgnoreErrors as $ignoreError) { $i = $ignoreError['index']; $ignore = $ignoreError['ignoreError']; $result = $processIgnoreError($error, $i, $ignore); if (!$result) { unset($errors[$errorIndex]); $ignoredErrors[] = [$error, $ignore]; continue 2; } } } $errors = array_values($errors); foreach ($unmatchedIgnoredErrors as $unmatchedIgnoredError) { if (!isset($unmatchedIgnoredError['count']) || !isset($unmatchedIgnoredError['realCount'])) { continue; } if ($unmatchedIgnoredError['realCount'] <= $unmatchedIgnoredError['count']) { continue; } $errors[] = (new Error(sprintf('Ignored error pattern %s is expected to occur %d %s, but occurred %d %s.', \PHPStan\Analyser\Ignore\IgnoredError::stringifyPattern($unmatchedIgnoredError), $unmatchedIgnoredError['count'], $unmatchedIgnoredError['count'] === 1 ? 'time' : 'times', $unmatchedIgnoredError['realCount'], $unmatchedIgnoredError['realCount'] === 1 ? 'time' : 'times'), $unmatchedIgnoredError['file'], $unmatchedIgnoredError['line'], \false))->withIdentifier('ignore.count'); } $analysedFilesKeys = array_fill_keys($analysedFiles, \true); if (!$hasInternalErrors) { foreach ($unmatchedIgnoredErrors as $unmatchedIgnoredError) { $reportUnmatched = $unmatchedIgnoredError['reportUnmatched'] ?? $this->reportUnmatchedIgnoredErrors; if ($reportUnmatched === \false) { continue; } if (isset($unmatchedIgnoredError['count']) && isset($unmatchedIgnoredError['realCount']) && (isset($unmatchedIgnoredError['realPath']) || !$onlyFiles)) { if ($unmatchedIgnoredError['realCount'] < $unmatchedIgnoredError['count']) { $errors[] = (new Error(sprintf('Ignored error pattern %s is expected to occur %d %s, but occurred only %d %s.', \PHPStan\Analyser\Ignore\IgnoredError::stringifyPattern($unmatchedIgnoredError), $unmatchedIgnoredError['count'], $unmatchedIgnoredError['count'] === 1 ? 'time' : 'times', $unmatchedIgnoredError['realCount'], $unmatchedIgnoredError['realCount'] === 1 ? 'time' : 'times'), $unmatchedIgnoredError['file'], $unmatchedIgnoredError['line'], \false))->withIdentifier('ignore.count'); } } elseif (isset($unmatchedIgnoredError['realPath'])) { if (!array_key_exists($unmatchedIgnoredError['realPath'], $analysedFilesKeys)) { continue; } $errors[] = (new Error(sprintf('Ignored error pattern %s was not matched in reported errors.', \PHPStan\Analyser\Ignore\IgnoredError::stringifyPattern($unmatchedIgnoredError)), $unmatchedIgnoredError['realPath'], null, \false))->withIdentifier('ignore.unmatched'); } elseif (!$onlyFiles) { $stringErrors[] = sprintf('Ignored error pattern %s was not matched in reported errors.', \PHPStan\Analyser\Ignore\IgnoredError::stringifyPattern($unmatchedIgnoredError)); } } } return new \PHPStan\Analyser\Ignore\IgnoredErrorHelperProcessedResult($errors, $ignoredErrors, $stringErrors); } } <?php declare (strict_types=1); namespace PHPStan\Analyser\Ignore; use Exception; final class IgnoreParseException extends Exception { /** * @var int */ private $phpDocLine; public function __construct(string $message, int $phpDocLine) { $this->phpDocLine = $phpDocLine; parent::__construct($message); } public function getPhpDocLine() : int { return $this->phpDocLine; } } <?php declare (strict_types=1); namespace PHPStan\Analyser\Ignore; use _PHPStan_7d8742a37\Nette\Utils\Strings; use PHPStan\Analyser\Error; use PHPStan\DependencyInjection\BleedingEdgeToggle; use PHPStan\File\FileExcluder; use PHPStan\File\FileHelper; use PHPStan\ShouldNotHappenException; use function count; use function implode; use function is_array; use function preg_quote; use function sprintf; use function str_replace; final class IgnoredError { /** * @param mixed[]|string $ignoredError * @return string Representation of the ignored error */ public static function stringifyPattern($ignoredError) : string { if (!is_array($ignoredError)) { return $ignoredError; } $message = ''; if (isset($ignoredError['message'])) { $message = $ignoredError['message']; } if (isset($ignoredError['identifier'])) { if ($message === '') { $message = $ignoredError['identifier']; } else { $message = sprintf('%s (%s)', $message, $ignoredError['identifier']); } } if ($message === '') { throw new ShouldNotHappenException(); } // ignore by path if (isset($ignoredError['path'])) { return sprintf('%s in path %s', $message, $ignoredError['path']); } elseif (isset($ignoredError['paths'])) { if (count($ignoredError['paths']) === 1) { return sprintf('%s in path %s', $message, implode(', ', $ignoredError['paths'])); } return sprintf('%s in paths: %s', $message, implode(', ', $ignoredError['paths'])); } return $message; } /** * @return bool To ignore or not to ignore? */ public static function shouldIgnore(FileHelper $fileHelper, Error $error, ?string $ignoredErrorPattern, ?string $identifier, ?string $path) : bool { if ($identifier !== null) { if ($error->getIdentifier() !== $identifier) { return \false; } } if ($ignoredErrorPattern !== null) { // normalize newlines to allow working with ignore-patterns independent of used OS newline-format $errorMessage = $error->getMessage(); $errorMessage = str_replace(['\\r\\n', '\\r'], '\\n', $errorMessage); $ignoredErrorPattern = str_replace([preg_quote('\\r\\n'), preg_quote('\\r')], preg_quote('\\n'), $ignoredErrorPattern); if (Strings::match($errorMessage, $ignoredErrorPattern) === null) { return \false; } } if ($path !== null) { $fileExcluder = new FileExcluder($fileHelper, [$path], BleedingEdgeToggle::isBleedingEdge()); $isExcluded = $fileExcluder->isExcludedFromAnalysing($error->getFilePath()); if (!$isExcluded && $error->getTraitFilePath() !== null) { return $fileExcluder->isExcludedFromAnalysing($error->getTraitFilePath()); } return $isExcluded; } return \true; } } <?php declare (strict_types=1); namespace PHPStan\Analyser\Ignore; use _PHPStan_7d8742a37\Nette\Utils\Json; use _PHPStan_7d8742a37\Nette\Utils\JsonException; use PHPStan\File\FileHelper; use PHPStan\ShouldNotHappenException; use function array_key_exists; use function array_values; use function is_array; use function is_file; use function sprintf; final class IgnoredErrorHelper { /** * @var FileHelper */ private $fileHelper; /** * @var (string|mixed[])[] */ private $ignoreErrors; /** * @var bool */ private $reportUnmatchedIgnoredErrors; /** * @param (string|mixed[])[] $ignoreErrors */ public function __construct(FileHelper $fileHelper, array $ignoreErrors, bool $reportUnmatchedIgnoredErrors) { $this->fileHelper = $fileHelper; $this->ignoreErrors = $ignoreErrors; $this->reportUnmatchedIgnoredErrors = $reportUnmatchedIgnoredErrors; } public function initialize() : \PHPStan\Analyser\Ignore\IgnoredErrorHelperResult { $otherIgnoreErrors = []; $ignoreErrorsByFile = []; $errors = []; $expandedIgnoreErrors = []; foreach ($this->ignoreErrors as $ignoreError) { if (is_array($ignoreError)) { if (!isset($ignoreError['message']) && !isset($ignoreError['messages']) && !isset($ignoreError['identifier'])) { $errors[] = sprintf('Ignored error %s is missing a message or an identifier.', Json::encode($ignoreError)); continue; } if (isset($ignoreError['messages'])) { foreach ($ignoreError['messages'] as $message) { $expandedIgnoreError = $ignoreError; unset($expandedIgnoreError['messages']); $expandedIgnoreError['message'] = $message; $expandedIgnoreErrors[] = $expandedIgnoreError; } } else { $expandedIgnoreErrors[] = $ignoreError; } } else { $expandedIgnoreErrors[] = $ignoreError; } } $uniquedExpandedIgnoreErrors = []; foreach ($expandedIgnoreErrors as $ignoreError) { if (!isset($ignoreError['message']) && !isset($ignoreError['identifier'])) { $uniquedExpandedIgnoreErrors[] = $ignoreError; continue; } if (!isset($ignoreError['path'])) { $uniquedExpandedIgnoreErrors[] = $ignoreError; continue; } $key = $ignoreError['path']; if (isset($ignoreError['message'])) { $key = sprintf("%s\n%s", $key, $ignoreError['message']); } if (isset($ignoreError['identifier'])) { $key = sprintf("%s\n%s", $key, $ignoreError['identifier']); } if ($key === '') { throw new ShouldNotHappenException(); } if (!array_key_exists($key, $uniquedExpandedIgnoreErrors)) { $uniquedExpandedIgnoreErrors[$key] = $ignoreError; continue; } $uniquedExpandedIgnoreErrors[$key] = ['message' => $ignoreError['message'] ?? null, 'path' => $ignoreError['path'], 'identifier' => $ignoreError['identifier'] ?? null, 'count' => ($uniquedExpandedIgnoreErrors[$key]['count'] ?? 1) + ($ignoreError['count'] ?? 1), 'reportUnmatched' => ($uniquedExpandedIgnoreErrors[$key]['reportUnmatched'] ?? $this->reportUnmatchedIgnoredErrors) || ($ignoreError['reportUnmatched'] ?? $this->reportUnmatchedIgnoredErrors)]; } $expandedIgnoreErrors = array_values($uniquedExpandedIgnoreErrors); foreach ($expandedIgnoreErrors as $i => $ignoreError) { $ignoreErrorEntry = ['index' => $i, 'ignoreError' => $ignoreError]; try { if (is_array($ignoreError)) { if (!isset($ignoreError['message']) && !isset($ignoreError['identifier'])) { $errors[] = sprintf('Ignored error %s is missing a message or an identifier.', Json::encode($ignoreError)); continue; } if (!isset($ignoreError['path'])) { $otherIgnoreErrors[] = $ignoreErrorEntry; } elseif (@is_file($ignoreError['path'])) { $normalizedPath = $this->fileHelper->normalizePath($ignoreError['path']); $ignoreError['path'] = $normalizedPath; $ignoreErrorsByFile[$normalizedPath][] = $ignoreErrorEntry; $ignoreError['realPath'] = $normalizedPath; $expandedIgnoreErrors[$i] = $ignoreError; } else { $otherIgnoreErrors[] = $ignoreErrorEntry; } } else { $otherIgnoreErrors[] = $ignoreErrorEntry; } } catch (JsonException $e) { $errors[] = $e->getMessage(); } } return new \PHPStan\Analyser\Ignore\IgnoredErrorHelperResult($this->fileHelper, $errors, $otherIgnoreErrors, $ignoreErrorsByFile, $expandedIgnoreErrors, $this->reportUnmatchedIgnoredErrors); } } <?php declare (strict_types=1); namespace PHPStan\Analyser\Ignore; use _PHPStan_7d8742a37\Nette\Utils\Strings; use PHPStan\Analyser\Error; use function implode; use const PREG_SET_ORDER; final class IgnoreLexer { public const TOKEN_WHITESPACE = 1; public const TOKEN_END = 2; public const TOKEN_IDENTIFIER = 3; public const TOKEN_COMMA = 4; public const TOKEN_OPEN_PARENTHESIS = 5; public const TOKEN_CLOSE_PARENTHESIS = 6; public const TOKEN_OTHER = 7; private const LABELS = [self::TOKEN_WHITESPACE => 'T_WHITESPACE', self::TOKEN_END => 'end', self::TOKEN_IDENTIFIER => 'identifier', self::TOKEN_COMMA => 'comma (,)', self::TOKEN_OPEN_PARENTHESIS => 'T_OPEN_PARENTHESIS', self::TOKEN_CLOSE_PARENTHESIS => 'T_CLOSE_PARENTHESIS', self::TOKEN_OTHER => 'T_OTHER']; public const VALUE_OFFSET = 0; public const TYPE_OFFSET = 1; public const LINE_OFFSET = 2; /** * @var ?string */ private $regexp = null; /** * @return list<array{string, self::TOKEN_*, int}> */ public function tokenize(string $input) : array { if ($this->regexp === null) { $this->regexp = $this->generateRegexp(); } $matches = Strings::matchAll($input, $this->regexp, PREG_SET_ORDER); $tokens = []; $line = 1; foreach ($matches as $match) { /** @var self::TOKEN_* $type */ $type = (int) $match['MARK']; $tokens[] = [$match[0], $type, $line]; if ($type !== self::TOKEN_END) { continue; } $line++; } if (($type ?? null) !== self::TOKEN_END) { $tokens[] = ['', self::TOKEN_END, $line]; // ensure ending token is present } return $tokens; } /** * @param self::TOKEN_* $type */ public function getLabel(int $type) : string { return self::LABELS[$type]; } private function generateRegexp() : string { $patterns = [ self::TOKEN_WHITESPACE => '[\\x09\\x20]++', self::TOKEN_END => '(\\r?+\\n[\\x09\\x20]*+(?:\\*(?!/)\\x20?+)?|\\*/)', self::TOKEN_IDENTIFIER => Error::PATTERN_IDENTIFIER, self::TOKEN_COMMA => ',', self::TOKEN_OPEN_PARENTHESIS => '\\(', self::TOKEN_CLOSE_PARENTHESIS => '\\)', // everything except whitespaces and parentheses self::TOKEN_OTHER => '([^\\s\\)\\(])++', ]; foreach ($patterns as $type => &$pattern) { $pattern = '(?:' . $pattern . ')(*MARK:' . $type . ')'; } return '~' . implode('|', $patterns) . '~Asi'; } } <?php declare (strict_types=1); namespace PHPStan\Analyser; use PHPStan\Collectors\CollectedData; use PHPStan\Dependency\RootExportedNode; use function usort; /** * @phpstan-import-type LinesToIgnore from FileAnalyserResult */ final class AnalyserResult { /** * @var list<Error> */ private $unorderedErrors; /** * @var list<Error> */ private $filteredPhpErrors; /** * @var list<Error> */ private $allPhpErrors; /** * @var list<Error> */ private $locallyIgnoredErrors; /** * @var array<string, LinesToIgnore> */ private $linesToIgnore; /** * @var array<string, LinesToIgnore> */ private $unmatchedLineIgnores; /** * @var list<InternalError> */ private $internalErrors; /** * @var list<CollectedData> */ private $collectedData; /** * @var array<string, array<string>>|null */ private $dependencies; /** * @var array<string, array<RootExportedNode>> */ private $exportedNodes; /** * @var bool */ private $reachedInternalErrorsCountLimit; /** * @var int */ private $peakMemoryUsageBytes; /** @var list<Error>|null */ private $errors = null; /** * @param list<Error> $unorderedErrors * @param list<Error> $filteredPhpErrors * @param list<Error> $allPhpErrors * @param list<Error> $locallyIgnoredErrors * @param array<string, LinesToIgnore> $linesToIgnore * @param array<string, LinesToIgnore> $unmatchedLineIgnores * @param list<CollectedData> $collectedData * @param list<InternalError> $internalErrors * @param array<string, array<string>>|null $dependencies * @param array<string, array<RootExportedNode>> $exportedNodes */ public function __construct(array $unorderedErrors, array $filteredPhpErrors, array $allPhpErrors, array $locallyIgnoredErrors, array $linesToIgnore, array $unmatchedLineIgnores, array $internalErrors, array $collectedData, ?array $dependencies, array $exportedNodes, bool $reachedInternalErrorsCountLimit, int $peakMemoryUsageBytes) { $this->unorderedErrors = $unorderedErrors; $this->filteredPhpErrors = $filteredPhpErrors; $this->allPhpErrors = $allPhpErrors; $this->locallyIgnoredErrors = $locallyIgnoredErrors; $this->linesToIgnore = $linesToIgnore; $this->unmatchedLineIgnores = $unmatchedLineIgnores; $this->internalErrors = $internalErrors; $this->collectedData = $collectedData; $this->dependencies = $dependencies; $this->exportedNodes = $exportedNodes; $this->reachedInternalErrorsCountLimit = $reachedInternalErrorsCountLimit; $this->peakMemoryUsageBytes = $peakMemoryUsageBytes; } /** * @return list<Error> */ public function getUnorderedErrors() : array { return $this->unorderedErrors; } /** * @return list<Error> */ public function getErrors() : array { if (!isset($this->errors)) { $this->errors = $this->unorderedErrors; usort($this->errors, static function (\PHPStan\Analyser\Error $a, \PHPStan\Analyser\Error $b) : int { return [$a->getFile(), $a->getLine(), $a->getMessage()] <=> [$b->getFile(), $b->getLine(), $b->getMessage()]; }); } return $this->errors; } /** * @return list<Error> */ public function getFilteredPhpErrors() : array { return $this->filteredPhpErrors; } /** * @return list<Error> */ public function getAllPhpErrors() : array { return $this->allPhpErrors; } /** * @return list<Error> */ public function getLocallyIgnoredErrors() : array { return $this->locallyIgnoredErrors; } /** * @return array<string, LinesToIgnore> */ public function getLinesToIgnore() : array { return $this->linesToIgnore; } /** * @return array<string, LinesToIgnore> */ public function getUnmatchedLineIgnores() : array { return $this->unmatchedLineIgnores; } /** * @return list<InternalError> */ public function getInternalErrors() : array { return $this->internalErrors; } /** * @return list<CollectedData> */ public function getCollectedData() : array { return $this->collectedData; } /** * @return array<string, array<string>>|null */ public function getDependencies() : ?array { return $this->dependencies; } /** * @return array<string, array<RootExportedNode>> */ public function getExportedNodes() : array { return $this->exportedNodes; } public function hasReachedInternalErrorsCountLimit() : bool { return $this->reachedInternalErrorsCountLimit; } public function getPeakMemoryUsageBytes() : int { return $this->peakMemoryUsageBytes; } } <?php declare (strict_types=1); namespace PHPStan\Analyser; final class EnsuredNonNullabilityResult { /** * @var MutatingScope */ private $scope; /** * @var EnsuredNonNullabilityResultExpression[] */ private $specifiedExpressions; /** * @param EnsuredNonNullabilityResultExpression[] $specifiedExpressions */ public function __construct(\PHPStan\Analyser\MutatingScope $scope, array $specifiedExpressions) { $this->scope = $scope; $this->specifiedExpressions = $specifiedExpressions; } public function getScope() : \PHPStan\Analyser\MutatingScope { return $this->scope; } /** * @return EnsuredNonNullabilityResultExpression[] */ public function getSpecifiedExpressions() : array { return $this->specifiedExpressions; } } <?php declare (strict_types=1); namespace PHPStan\Analyser; use PHPStan\ShouldNotHappenException; /** * @api * @final */ class TypeSpecifierContext { /** * @var ?int */ private $value; public const CONTEXT_TRUE = 0b1; public const CONTEXT_TRUTHY_BUT_NOT_TRUE = 0b10; public const CONTEXT_TRUTHY = self::CONTEXT_TRUE | self::CONTEXT_TRUTHY_BUT_NOT_TRUE; public const CONTEXT_FALSE = 0b100; public const CONTEXT_FALSEY_BUT_NOT_FALSE = 0b1000; public const CONTEXT_FALSEY = self::CONTEXT_FALSE | self::CONTEXT_FALSEY_BUT_NOT_FALSE; public const CONTEXT_BITMASK = 0b1111; /** @var self[] */ private static $registry; private function __construct(?int $value) { $this->value = $value; } private static function create(?int $value) : self { self::$registry[$value] = self::$registry[$value] ?? new self($value); return self::$registry[$value]; } public static function createTrue() : self { return self::create(self::CONTEXT_TRUE); } public static function createTruthy() : self { return self::create(self::CONTEXT_TRUTHY); } public static function createFalse() : self { return self::create(self::CONTEXT_FALSE); } public static function createFalsey() : self { return self::create(self::CONTEXT_FALSEY); } public static function createNull() : self { return self::create(null); } public function negate() : self { if ($this->value === null) { throw new ShouldNotHappenException(); } return self::create(~$this->value & self::CONTEXT_BITMASK); } public function true() : bool { return $this->value !== null && (bool) ($this->value & self::CONTEXT_TRUE); } public function truthy() : bool { return $this->value !== null && (bool) ($this->value & self::CONTEXT_TRUTHY); } public function false() : bool { return $this->value !== null && (bool) ($this->value & self::CONTEXT_FALSE); } public function falsey() : bool { return $this->value !== null && (bool) ($this->value & self::CONTEXT_FALSEY); } public function null() : bool { return $this->value === null; } } <?php declare (strict_types=1); namespace PHPStan\Analyser; use PHPStan\AnalysedCodeException; use function sprintf; final class UndefinedVariableException extends AnalysedCodeException { /** * @var Scope */ private $scope; /** * @var string */ private $variableName; public function __construct(\PHPStan\Analyser\Scope $scope, string $variableName) { $this->scope = $scope; $this->variableName = $variableName; parent::__construct(sprintf('Undefined variable: $%s', $variableName)); } public function getScope() : \PHPStan\Analyser\Scope { return $this->scope; } public function getVariableName() : string { return $this->variableName; } public function getTip() : ?string { return null; } } <?php declare (strict_types=1); namespace PHPStan\Analyser; use PhpParser\Node; use PhpParser\Node\Expr\BinaryOp\Identical; use PhpParser\Node\Expr\Variable; use PHPStan\Reflection\InitializerExprTypeResolver; use PHPStan\Type\BooleanType; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\TypeResult; use function is_string; final class RicherScopeGetTypeHelper { /** * @var InitializerExprTypeResolver */ private $initializerExprTypeResolver; public function __construct(InitializerExprTypeResolver $initializerExprTypeResolver) { $this->initializerExprTypeResolver = $initializerExprTypeResolver; } /** * @return TypeResult<BooleanType> */ public function getIdenticalResult(\PHPStan\Analyser\Scope $scope, Identical $expr) : TypeResult { if ($expr->left instanceof Variable && is_string($expr->left->name) && $expr->right instanceof Variable && is_string($expr->right->name) && $expr->left->name === $expr->right->name) { return new TypeResult(new ConstantBooleanType(\true), []); } $leftType = $scope->getType($expr->left); $rightType = $scope->getType($expr->right); if (!$scope instanceof \PHPStan\Analyser\MutatingScope) { return $this->initializerExprTypeResolver->resolveIdenticalType($leftType, $rightType); } if (($expr->left instanceof Node\Expr\PropertyFetch || $expr->left instanceof Node\Expr\StaticPropertyFetch) && $rightType->isNull()->yes() && !$scope->hasPropertyNativeType($expr->left)) { return new TypeResult(new BooleanType(), []); } if (($expr->right instanceof Node\Expr\PropertyFetch || $expr->right instanceof Node\Expr\StaticPropertyFetch) && $leftType->isNull()->yes() && !$scope->hasPropertyNativeType($expr->right)) { return new TypeResult(new BooleanType(), []); } return $this->initializerExprTypeResolver->resolveIdenticalType($leftType, $rightType); } /** * @return TypeResult<BooleanType> */ public function getNotIdenticalResult(\PHPStan\Analyser\Scope $scope, Node\Expr\BinaryOp\NotIdentical $expr) : TypeResult { $identicalResult = $this->getIdenticalResult($scope, new Identical($expr->left, $expr->right)); $identicalType = $identicalResult->type; if ($identicalType instanceof ConstantBooleanType) { return new TypeResult(new ConstantBooleanType(!$identicalType->getValue()), $identicalResult->reasons); } return new TypeResult(new BooleanType(), []); } } <?php declare (strict_types=1); namespace PHPStan\Diagnose; use PHPStan\Command\Output; /** * DiagnoseExtension can output any diagnostic information to stderr after analysis. * * PHPStan displays this information when running the "analyse" command with "-vvv" CLI option. * * To register it in the configuration file use the `phpstan.diagnoseExtension` service tag: * * ``` * services: * - * class: App\PHPStan\MyExtension * tags: * - phpstan.diagnoseExtension * ``` * * @api */ interface DiagnoseExtension { public const EXTENSION_TAG = 'phpstan.diagnoseExtension'; public function print(Output $output) : void; } <?php declare (strict_types=1); namespace PHPStan\Diagnose; use Phar; use PHPStan\Command\Output; use PHPStan\ExtensionInstaller\GeneratedConfig; use PHPStan\File\FileHelper; use PHPStan\Internal\ComposerHelper; use PHPStan\Php\PhpVersion; use ReflectionClass; use function array_key_exists; use function array_slice; use function class_exists; use function count; use function dirname; use function explode; use function implode; use function in_array; use function is_file; use function is_readable; use function sprintf; use function str_starts_with; use function strlen; use function substr; use const PHP_VERSION_ID; final class PHPStanDiagnoseExtension implements \PHPStan\Diagnose\DiagnoseExtension { /** * @var PhpVersion */ private $phpVersion; /** * @var FileHelper */ private $fileHelper; /** * @var string[] */ private $composerAutoloaderProjectPaths; /** * @var string[] */ private $allConfigFiles; /** * @param string[] $composerAutoloaderProjectPaths * @param string [] $allConfigFiles */ public function __construct(PhpVersion $phpVersion, FileHelper $fileHelper, array $composerAutoloaderProjectPaths, array $allConfigFiles) { $this->phpVersion = $phpVersion; $this->fileHelper = $fileHelper; $this->composerAutoloaderProjectPaths = $composerAutoloaderProjectPaths; $this->allConfigFiles = $allConfigFiles; } public function print(Output $output) : void { $phpRuntimeVersion = new PhpVersion(PHP_VERSION_ID); $output->writeLineFormatted(sprintf('<info>PHP runtime version:</info> %s', $phpRuntimeVersion->getVersionString())); $output->writeLineFormatted(sprintf('<info>PHP version for analysis:</info> %s (from %s)', $this->phpVersion->getVersionString(), $this->phpVersion->getSourceLabel())); $output->writeLineFormatted(''); $output->writeLineFormatted(sprintf('<info>PHPStan version:</info> %s', ComposerHelper::getPhpStanVersion())); $output->writeLineFormatted('<info>PHPStan running from:</info>'); $pharRunning = Phar::running(\false); if ($pharRunning !== '') { $output->writeLineFormatted(dirname($pharRunning)); } else { if (isset($_SERVER['argv'][0]) && is_file($_SERVER['argv'][0])) { $output->writeLineFormatted($_SERVER['argv'][0]); } else { $output->writeLineFormatted('Unknown'); } } $output->writeLineFormatted(''); $configFilesFromExtensionInstaller = []; if (class_exists('PHPStan\\ExtensionInstaller\\GeneratedConfig')) { $output->writeLineFormatted('<info>Extension installer:</info>'); if (count(GeneratedConfig::EXTENSIONS) === 0) { $output->writeLineFormatted('No extensions installed'); } $generatedConfigReflection = new ReflectionClass('PHPStan\\ExtensionInstaller\\GeneratedConfig'); $generatedConfigDirectory = dirname($generatedConfigReflection->getFileName()); foreach (GeneratedConfig::EXTENSIONS as $name => $extensionConfig) { $output->writeLineFormatted(sprintf('%s: %s', $name, $extensionConfig['version'] ?? 'Unknown version')); foreach ($extensionConfig['extra']['includes'] ?? [] as $includedFile) { $includedFilePath = null; if (isset($extensionConfig['relative_install_path'])) { $includedFilePath = sprintf('%s/%s/%s', $generatedConfigDirectory, $extensionConfig['relative_install_path'], $includedFile); if (!is_file($includedFilePath) || !is_readable($includedFilePath)) { $includedFilePath = null; } } if ($includedFilePath === null) { $includedFilePath = sprintf('%s/%s', $extensionConfig['install_path'], $includedFile); } $configFilesFromExtensionInstaller[] = $this->fileHelper->normalizePath($includedFilePath, '/'); } } } else { $output->writeLineFormatted('<info>Extension installer:</info> Not installed'); } $output->writeLineFormatted(''); $thirdPartyIncludedConfigs = []; foreach ($this->allConfigFiles as $configFile) { $configFile = $this->fileHelper->normalizePath($configFile, '/'); if (in_array($configFile, $configFilesFromExtensionInstaller, \true)) { continue; } foreach ($this->composerAutoloaderProjectPaths as $composerAutoloaderProjectPath) { $composerConfig = ComposerHelper::getComposerConfig($composerAutoloaderProjectPath); if ($composerConfig === null) { continue; } $vendorDir = $this->fileHelper->normalizePath(ComposerHelper::getVendorDirFromComposerConfig($composerAutoloaderProjectPath, $composerConfig), '/'); if (!str_starts_with($configFile, $vendorDir)) { continue; } $installedPath = $vendorDir . '/composer/installed.php'; if (!is_file($installedPath)) { continue; } $installed = (require $installedPath); $trimmed = substr($configFile, strlen($vendorDir) + 1); $parts = explode('/', $trimmed); $package = implode('/', array_slice($parts, 0, 2)); $configPath = implode('/', array_slice($parts, 2)); if (!array_key_exists($package, $installed['versions'])) { continue; } $packageVersion = $installed['versions'][$package]['pretty_version'] ?? null; if ($packageVersion === null) { continue; } $thirdPartyIncludedConfigs[] = [$package, $packageVersion, $configPath]; } } if (count($thirdPartyIncludedConfigs) > 0) { $output->writeLineFormatted('<info>Included configs from Composer packages:</info>'); foreach ($thirdPartyIncludedConfigs as [$package, $packageVersion, $configPath]) { $output->writeLineFormatted(sprintf('%s (%s): %s', $package, $configPath, $packageVersion)); } $output->writeLineFormatted(''); } $composerAutoloaderProjectPathsCount = count($this->composerAutoloaderProjectPaths); $output->writeLineFormatted(sprintf('<info>Discovered Composer project %s:</info>', $composerAutoloaderProjectPathsCount === 1 ? 'root' : 'roots')); if ($composerAutoloaderProjectPathsCount === 0) { $output->writeLineFormatted('None'); } foreach ($this->composerAutoloaderProjectPaths as $composerAutoloaderProjectPath) { $output->writeLineFormatted($composerAutoloaderProjectPath); } $output->writeLineFormatted(''); } } <?php declare (strict_types=1); namespace PHPStan\Rules\TooWideTypehints; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\ClosureReturnStatementsNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\TypeCombinator; use PHPStan\Type\UnionType; use PHPStan\Type\VerbosityLevel; use function count; use function sprintf; /** * @implements Rule<ClosureReturnStatementsNode> */ final class TooWideClosureReturnTypehintRule implements Rule { public function getNodeType() : string { return ClosureReturnStatementsNode::class; } public function processNode(Node $node, Scope $scope) : array { $closureExpr = $node->getClosureExpr(); if ($closureExpr->returnType === null) { return []; } $statementResult = $node->getStatementResult(); if ($statementResult->hasYield()) { return []; } $returnStatements = $node->getReturnStatements(); if (count($returnStatements) === 0) { return []; } $closureReturnType = $scope->getFunctionType($closureExpr->returnType, \false, \false); if (!$closureReturnType instanceof UnionType) { return []; } $returnTypes = []; foreach ($returnStatements as $returnStatement) { $returnNode = $returnStatement->getReturnNode(); if ($returnNode->expr === null) { continue; } $returnTypes[] = $returnStatement->getScope()->getType($returnNode->expr); } if (count($returnTypes) === 0) { return []; } $returnType = TypeCombinator::union(...$returnTypes); if ($returnType->isNull()->yes()) { return []; } $messages = []; foreach ($closureReturnType->getTypes() as $type) { if (!$type->isSuperTypeOf($returnType)->no()) { continue; } $messages[] = RuleErrorBuilder::message(sprintf('Anonymous function never returns %s so it can be removed from the return type.', $type->describe(VerbosityLevel::getRecommendedLevelByType($type))))->identifier('return.unusedType')->build(); } return $messages; } } <?php declare (strict_types=1); namespace PHPStan\Rules\TooWideTypehints; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\FunctionReturnStatementsNode; use PHPStan\Rules\Rule; use function sprintf; /** * @implements Rule<FunctionReturnStatementsNode> */ final class TooWideFunctionParameterOutTypeRule implements Rule { /** * @var TooWideParameterOutTypeCheck */ private $check; public function __construct(\PHPStan\Rules\TooWideTypehints\TooWideParameterOutTypeCheck $check) { $this->check = $check; } public function getNodeType() : string { return FunctionReturnStatementsNode::class; } public function processNode(Node $node, Scope $scope) : array { $inFunction = $node->getFunctionReflection(); return $this->check->check($node->getExecutionEnds(), $node->getReturnStatements(), $inFunction->getParameters(), sprintf('Function %s()', $inFunction->getName())); } } <?php declare (strict_types=1); namespace PHPStan\Rules\TooWideTypehints; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\ClassPropertiesNode; use PHPStan\Reflection\PropertyReflection; use PHPStan\Rules\Properties\PropertyReflectionFinder; use PHPStan\Rules\Properties\ReadWritePropertiesExtensionProvider; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\NullType; use PHPStan\Type\TypeCombinator; use PHPStan\Type\UnionType; use PHPStan\Type\VerbosityLevel; use function count; use function sprintf; /** * @implements Rule<ClassPropertiesNode> */ final class TooWidePropertyTypeRule implements Rule { /** * @var ReadWritePropertiesExtensionProvider */ private $extensionProvider; /** * @var PropertyReflectionFinder */ private $propertyReflectionFinder; public function __construct(ReadWritePropertiesExtensionProvider $extensionProvider, PropertyReflectionFinder $propertyReflectionFinder) { $this->extensionProvider = $extensionProvider; $this->propertyReflectionFinder = $propertyReflectionFinder; } public function getNodeType() : string { return ClassPropertiesNode::class; } public function processNode(Node $node, Scope $scope) : array { $errors = []; $classReflection = $node->getClassReflection(); foreach ($node->getProperties() as $property) { if (!$property->isPrivate()) { continue; } if ($property->isDeclaredInTrait()) { continue; } if ($property->isPromoted()) { continue; } $propertyName = $property->getName(); if (!$classReflection->hasNativeProperty($propertyName)) { continue; } $propertyReflection = $classReflection->getNativeProperty($propertyName); $propertyType = $propertyReflection->getWritableType(); if (!$propertyType instanceof UnionType) { continue; } foreach ($this->extensionProvider->getExtensions() as $extension) { if ($extension->isAlwaysRead($propertyReflection, $propertyName)) { continue 2; } if ($extension->isAlwaysWritten($propertyReflection, $propertyName)) { continue 2; } if ($extension->isInitialized($propertyReflection, $propertyName)) { continue 2; } } $assignedTypes = []; foreach ($node->getPropertyAssigns() as $assign) { $assignNode = $assign->getAssign(); $assignPropertyReflections = $this->propertyReflectionFinder->findPropertyReflectionsFromNode($assignNode->getPropertyFetch(), $assign->getScope()); foreach ($assignPropertyReflections as $assignPropertyReflection) { if ($propertyName !== $assignPropertyReflection->getName()) { continue; } if ($propertyReflection->getDeclaringClass()->getName() !== $assignPropertyReflection->getDeclaringClass()->getName()) { continue; } $assignedTypes[] = $assignPropertyReflection->getScope()->getType($assignNode->getAssignedExpr()); } } if ($property->getDefault() !== null) { $assignedTypes[] = $scope->getType($property->getDefault()); } if (count($assignedTypes) === 0) { continue; } $assignedType = TypeCombinator::union(...$assignedTypes); $propertyDescription = $this->describePropertyByName($propertyReflection, $propertyName); $verbosityLevel = VerbosityLevel::getRecommendedLevelByType($propertyType, $assignedType); foreach ($propertyType->getTypes() as $type) { if (!$type->isSuperTypeOf($assignedType)->no()) { continue; } if ($property->getNativeType() === null && (new NullType())->isSuperTypeOf($type)->yes()) { continue; } $errors[] = RuleErrorBuilder::message(sprintf('%s (%s) is never assigned %s so it can be removed from the property type.', $propertyDescription, $propertyType->describe($verbosityLevel), $type->describe($verbosityLevel)))->identifier('property.unusedType')->line($property->getStartLine())->build(); } } return $errors; } private function describePropertyByName(PropertyReflection $property, string $propertyName) : string { if (!$property->isStatic()) { return sprintf('Property %s::$%s', $property->getDeclaringClass()->getDisplayName(), $propertyName); } return sprintf('Static property %s::$%s', $property->getDeclaringClass()->getDisplayName(), $propertyName); } } <?php declare (strict_types=1); namespace PHPStan\Rules\TooWideTypehints; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\InArrowFunctionNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\UnionType; use PHPStan\Type\VerbosityLevel; use function sprintf; /** * @implements Rule<InArrowFunctionNode> */ final class TooWideArrowFunctionReturnTypehintRule implements Rule { public function getNodeType() : string { return InArrowFunctionNode::class; } public function processNode(Node $node, Scope $scope) : array { $arrowFunction = $node->getOriginalNode(); if ($arrowFunction->returnType === null) { return []; } $expr = $arrowFunction->expr; if ($expr instanceof Node\Expr\YieldFrom || $expr instanceof Node\Expr\Yield_) { return []; } $functionReturnType = $scope->getFunctionType($arrowFunction->returnType, \false, \false); if (!$functionReturnType instanceof UnionType) { return []; } $returnType = $scope->getType($expr); if ($returnType->isNull()->yes()) { return []; } $messages = []; foreach ($functionReturnType->getTypes() as $type) { if (!$type->isSuperTypeOf($returnType)->no()) { continue; } $messages[] = RuleErrorBuilder::message(sprintf('Anonymous function never returns %s so it can be removed from the return type.', $type->describe(VerbosityLevel::getRecommendedLevelByType($type))))->identifier('return.unusedType')->build(); } return $messages; } } <?php declare (strict_types=1); namespace PHPStan\Rules\TooWideTypehints; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\FunctionReturnStatementsNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\TypeCombinator; use PHPStan\Type\TypeUtils; use PHPStan\Type\UnionType; use PHPStan\Type\VerbosityLevel; use PHPStan\Type\VoidType; use function count; use function sprintf; /** * @implements Rule<FunctionReturnStatementsNode> */ final class TooWideFunctionReturnTypehintRule implements Rule { public function getNodeType() : string { return FunctionReturnStatementsNode::class; } public function processNode(Node $node, Scope $scope) : array { $function = $node->getFunctionReflection(); $functionReturnType = $function->getReturnType(); $functionReturnType = TypeUtils::resolveLateResolvableTypes($functionReturnType); if (!$functionReturnType instanceof UnionType) { return []; } $statementResult = $node->getStatementResult(); if ($statementResult->hasYield()) { return []; } $returnStatements = $node->getReturnStatements(); if (count($returnStatements) === 0) { return []; } $returnTypes = []; foreach ($returnStatements as $returnStatement) { $returnNode = $returnStatement->getReturnNode(); if ($returnNode->expr === null) { $returnTypes[] = new VoidType(); continue; } $returnTypes[] = $returnStatement->getScope()->getType($returnNode->expr); } if (!$statementResult->isAlwaysTerminating()) { $returnTypes[] = new VoidType(); } $returnType = TypeCombinator::union(...$returnTypes); $messages = []; foreach ($functionReturnType->getTypes() as $type) { if (!$type->isSuperTypeOf($returnType)->no()) { continue; } if ($type->isNull()->yes() && !$node->hasNativeReturnTypehint()) { foreach ($node->getExecutionEnds() as $executionEnd) { if ($executionEnd->getStatementResult()->isAlwaysTerminating()) { continue; } continue 2; } } $messages[] = RuleErrorBuilder::message(sprintf('Function %s() never returns %s so it can be removed from the return type.', $function->getName(), $type->describe(VerbosityLevel::getRecommendedLevelByType($type))))->identifier('return.unusedType')->build(); } return $messages; } } <?php declare (strict_types=1); namespace PHPStan\Rules\TooWideTypehints; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\MethodReturnStatementsNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\TypeCombinator; use PHPStan\Type\TypeUtils; use PHPStan\Type\UnionType; use PHPStan\Type\VerbosityLevel; use PHPStan\Type\VoidType; use function count; use function sprintf; /** * @implements Rule<MethodReturnStatementsNode> */ final class TooWideMethodReturnTypehintRule implements Rule { /** * @var bool */ private $checkProtectedAndPublicMethods; /** * @var bool */ private $alwaysCheckFinal; public function __construct(bool $checkProtectedAndPublicMethods, bool $alwaysCheckFinal) { $this->checkProtectedAndPublicMethods = $checkProtectedAndPublicMethods; $this->alwaysCheckFinal = $alwaysCheckFinal; } public function getNodeType() : string { return MethodReturnStatementsNode::class; } public function processNode(Node $node, Scope $scope) : array { if ($scope->isInTrait()) { return []; } $method = $node->getMethodReflection(); $isFirstDeclaration = $method->getPrototype()->getDeclaringClass() === $method->getDeclaringClass(); if (!$method->isPrivate()) { if ($this->alwaysCheckFinal) { if (!$method->getDeclaringClass()->isFinal() && !$method->isFinal()->yes()) { if (!$this->checkProtectedAndPublicMethods) { return []; } if ($isFirstDeclaration) { return []; } } } elseif (!$this->checkProtectedAndPublicMethods) { return []; } elseif ($isFirstDeclaration && !$method->getDeclaringClass()->isFinal() && !$method->isFinal()->yes()) { return []; } } $methodReturnType = $method->getReturnType(); $methodReturnType = TypeUtils::resolveLateResolvableTypes($methodReturnType); if (!$methodReturnType instanceof UnionType) { return []; } $statementResult = $node->getStatementResult(); if ($statementResult->hasYield()) { return []; } $returnStatements = $node->getReturnStatements(); if (count($returnStatements) === 0) { return []; } $returnTypes = []; foreach ($returnStatements as $returnStatement) { $returnNode = $returnStatement->getReturnNode(); if ($returnNode->expr === null) { $returnTypes[] = new VoidType(); continue; } $returnTypes[] = $returnStatement->getScope()->getType($returnNode->expr); } if (!$statementResult->isAlwaysTerminating()) { $returnTypes[] = new VoidType(); } $returnType = TypeCombinator::union(...$returnTypes); if (!$method->isPrivate() && ($returnType->isNull()->yes() || $returnType instanceof ConstantBooleanType) && !$isFirstDeclaration) { return []; } $messages = []; foreach ($methodReturnType->getTypes() as $type) { if (!$type->isSuperTypeOf($returnType)->no()) { continue; } if ($type->isNull()->yes() && !$node->hasNativeReturnTypehint()) { foreach ($node->getExecutionEnds() as $executionEnd) { if ($executionEnd->getStatementResult()->isAlwaysTerminating()) { continue; } continue 2; } } $messages[] = RuleErrorBuilder::message(sprintf('Method %s::%s() never returns %s so it can be removed from the return type.', $method->getDeclaringClass()->getDisplayName(), $method->getName(), $type->describe(VerbosityLevel::getRecommendedLevelByType($type))))->identifier('return.unusedType')->build(); } return $messages; } } <?php declare (strict_types=1); namespace PHPStan\Rules\TooWideTypehints; use PhpParser\Node\Expr\Variable; use PHPStan\Analyser\Scope; use PHPStan\Node\ExecutionEndNode; use PHPStan\Node\ReturnStatement; use PHPStan\Reflection\ParameterReflectionWithPhpDocs; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\TypeUtils; use PHPStan\Type\UnionType; use PHPStan\Type\VerbosityLevel; use function sprintf; final class TooWideParameterOutTypeCheck { /** * @param list<ExecutionEndNode> $executionEnds * @param list<ReturnStatement> $returnStatements * @param ParameterReflectionWithPhpDocs[] $parameters * @return list<IdentifierRuleError> */ public function check(array $executionEnds, array $returnStatements, array $parameters, string $functionDescription) : array { $finalScope = null; foreach ($executionEnds as $executionEnd) { $endScope = $executionEnd->getStatementResult()->getScope(); if ($finalScope === null) { $finalScope = $endScope; continue; } $finalScope = $finalScope->mergeWith($endScope); } foreach ($returnStatements as $statement) { if ($finalScope === null) { $finalScope = $statement->getScope(); continue; } $finalScope = $finalScope->mergeWith($statement->getScope()); } if ($finalScope === null) { return []; } $errors = []; foreach ($parameters as $parameter) { if (!$parameter->passedByReference()->createsNewVariable()) { continue; } foreach ($this->processSingleParameter($finalScope, $functionDescription, $parameter) as $error) { $errors[] = $error; } } return $errors; } /** * @return list<IdentifierRuleError> */ private function processSingleParameter(Scope $scope, string $functionDescription, ParameterReflectionWithPhpDocs $parameter) : array { $isParamOutType = \true; $outType = $parameter->getOutType(); if ($outType === null) { $isParamOutType = \false; $outType = $parameter->getType(); } $outType = TypeUtils::resolveLateResolvableTypes($outType); if (!$outType instanceof UnionType) { return []; } $variableExpr = new Variable($parameter->getName()); $variableType = $scope->getType($variableExpr); $messages = []; foreach ($outType->getTypes() as $type) { if (!$type->isSuperTypeOf($variableType)->no()) { continue; } $errorBuilder = RuleErrorBuilder::message(sprintf('%s never assigns %s to &$%s so it can be removed from the %s.', $functionDescription, $type->describe(VerbosityLevel::getRecommendedLevelByType($type)), $parameter->getName(), $isParamOutType ? '@param-out type' : 'by-ref type'))->identifier(sprintf('%s.unusedType', $isParamOutType ? 'paramOut' : 'parameterByRef')); if (!$isParamOutType) { $errorBuilder->tip('You can narrow the parameter out type with @param-out PHPDoc tag.'); } $messages[] = $errorBuilder->build(); } return $messages; } } <?php declare (strict_types=1); namespace PHPStan\Rules\TooWideTypehints; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\MethodReturnStatementsNode; use PHPStan\Rules\Rule; use function sprintf; /** * @implements Rule<MethodReturnStatementsNode> */ final class TooWideMethodParameterOutTypeRule implements Rule { /** * @var TooWideParameterOutTypeCheck */ private $check; public function __construct(\PHPStan\Rules\TooWideTypehints\TooWideParameterOutTypeCheck $check) { $this->check = $check; } public function getNodeType() : string { return MethodReturnStatementsNode::class; } public function processNode(Node $node, Scope $scope) : array { $inMethod = $node->getMethodReflection(); return $this->check->check($node->getExecutionEnds(), $node->getReturnStatements(), $inMethod->getParameters(), sprintf('Method %s::%s()', $inMethod->getDeclaringClass()->getDisplayName(), $inMethod->getName())); } } <?php declare (strict_types=1); namespace PHPStan\Rules; use PhpParser\Node\Expr; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Type\BenevolentUnionType; use PHPStan\Type\CallableType; use PHPStan\Type\ClosureType; use PHPStan\Type\ErrorType; use PHPStan\Type\Generic\TemplateMixedType; use PHPStan\Type\IntersectionType; use PHPStan\Type\MixedType; use PHPStan\Type\NeverType; use PHPStan\Type\NullType; use PHPStan\Type\ObjectType; use PHPStan\Type\ObjectWithoutClassType; use PHPStan\Type\StaticType; use PHPStan\Type\StrictMixedType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\TypeTraverser; use PHPStan\Type\TypeUtils; use PHPStan\Type\UnionType; use PHPStan\Type\VerbosityLevel; use function array_merge; use function count; use function sprintf; final class RuleLevelHelper { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var bool */ private $checkNullables; /** * @var bool */ private $checkThisOnly; /** * @var bool */ private $checkUnionTypes; /** * @var bool */ private $checkExplicitMixed; /** * @var bool */ private $checkImplicitMixed; /** * @var bool */ private $newRuleLevelHelper; /** * @var bool */ private $checkBenevolentUnionTypes; public function __construct(ReflectionProvider $reflectionProvider, bool $checkNullables, bool $checkThisOnly, bool $checkUnionTypes, bool $checkExplicitMixed, bool $checkImplicitMixed, bool $newRuleLevelHelper, bool $checkBenevolentUnionTypes) { $this->reflectionProvider = $reflectionProvider; $this->checkNullables = $checkNullables; $this->checkThisOnly = $checkThisOnly; $this->checkUnionTypes = $checkUnionTypes; $this->checkExplicitMixed = $checkExplicitMixed; $this->checkImplicitMixed = $checkImplicitMixed; $this->newRuleLevelHelper = $newRuleLevelHelper; $this->checkBenevolentUnionTypes = $checkBenevolentUnionTypes; } /** @api */ public function isThis(Expr $expression) : bool { return $expression instanceof Expr\Variable && $expression->name === 'this'; } /** @api */ public function accepts(Type $acceptingType, Type $acceptedType, bool $strictTypes) : bool { return $this->acceptsWithReason($acceptingType, $acceptedType, $strictTypes)->result; } private function transformCommonType(Type $type) : Type { if (!$this->checkExplicitMixed && !$this->checkImplicitMixed) { return $type; } return TypeTraverser::map($type, function (Type $type, callable $traverse) { if ($type instanceof TemplateMixedType) { if (!$this->newRuleLevelHelper) { return $type->toStrictMixedType(); } if ($this->checkExplicitMixed) { return $type->toStrictMixedType(); } } if ($type instanceof MixedType && ($type->isExplicitMixed() && $this->checkExplicitMixed || !$type->isExplicitMixed() && $this->checkImplicitMixed)) { return new StrictMixedType(); } return $traverse($type); }); } /** * @return array{Type, bool} */ private function transformAcceptedType(Type $acceptingType, Type $acceptedType) : array { $checkForUnion = $this->checkUnionTypes; $acceptedType = TypeTraverser::map($acceptedType, function (Type $acceptedType, callable $traverse) use($acceptingType, &$checkForUnion) : Type { if ($acceptedType instanceof CallableType) { if ($acceptedType->isCommonCallable()) { return $acceptedType; } return new CallableType($acceptedType->getParameters(), $traverse($this->transformCommonType($acceptedType->getReturnType())), $acceptedType->isVariadic(), $acceptedType->getTemplateTypeMap(), $acceptedType->getResolvedTemplateTypeMap(), $acceptedType->getTemplateTags(), $acceptedType->isPure()); } if ($acceptedType instanceof ClosureType) { if ($acceptedType->isCommonCallable()) { return $acceptedType; } return new ClosureType($acceptedType->getParameters(), $traverse($this->transformCommonType($acceptedType->getReturnType())), $acceptedType->isVariadic(), $acceptedType->getTemplateTypeMap(), $acceptedType->getResolvedTemplateTypeMap(), $acceptedType->getCallSiteVarianceMap(), $acceptedType->getTemplateTags(), $acceptedType->getThrowPoints(), $acceptedType->getImpurePoints(), $acceptedType->getInvalidateExpressions(), $acceptedType->getUsedVariables(), $acceptedType->acceptsNamedArguments()); } if (!$this->checkNullables && !$acceptingType instanceof NullType && !$acceptedType instanceof NullType && !$acceptedType instanceof BenevolentUnionType) { return $traverse(TypeCombinator::removeNull($acceptedType)); } if ($this->checkBenevolentUnionTypes) { if ($acceptedType instanceof BenevolentUnionType) { $checkForUnion = \true; return $traverse(TypeUtils::toStrictUnion($acceptedType)); } } return $traverse($this->transformCommonType($acceptedType)); }); return [$acceptedType, $checkForUnion]; } public function acceptsWithReason(Type $acceptingType, Type $acceptedType, bool $strictTypes) : \PHPStan\Rules\RuleLevelHelperAcceptsResult { if ($this->newRuleLevelHelper) { [$acceptedType, $checkForUnion] = $this->transformAcceptedType($acceptingType, $acceptedType); $acceptingType = $this->transformCommonType($acceptingType); $accepts = $acceptingType->acceptsWithReason($acceptedType, $strictTypes); return new \PHPStan\Rules\RuleLevelHelperAcceptsResult($checkForUnion ? $accepts->yes() : !$accepts->no(), $accepts->reasons); } $checkForUnion = $this->checkUnionTypes; if ($this->checkBenevolentUnionTypes) { $traverse = static function (Type $type, callable $traverse) use(&$checkForUnion) : Type { if ($type instanceof BenevolentUnionType) { $checkForUnion = \true; return TypeUtils::toStrictUnion($type); } return $traverse($type); }; $acceptedType = TypeTraverser::map($acceptedType, $traverse); } if ($this->checkExplicitMixed) { $traverse = static function (Type $type, callable $traverse) : Type { if ($type instanceof TemplateMixedType) { return $type->toStrictMixedType(); } if ($type instanceof MixedType && $type->isExplicitMixed()) { return new StrictMixedType(); } return $traverse($type); }; $acceptingType = TypeTraverser::map($acceptingType, $traverse); $acceptedType = TypeTraverser::map($acceptedType, $traverse); } if ($this->checkImplicitMixed) { $traverse = static function (Type $type, callable $traverse) : Type { if ($type instanceof TemplateMixedType) { return $type->toStrictMixedType(); } if ($type instanceof MixedType && !$type->isExplicitMixed()) { return new StrictMixedType(); } return $traverse($type); }; $acceptingType = TypeTraverser::map($acceptingType, $traverse); $acceptedType = TypeTraverser::map($acceptedType, $traverse); } if (!$this->checkNullables && !$acceptingType instanceof NullType && !$acceptedType instanceof NullType && !$acceptedType instanceof BenevolentUnionType) { $acceptedType = TypeCombinator::removeNull($acceptedType); } $accepts = $acceptingType->acceptsWithReason($acceptedType, $strictTypes); if ($accepts->yes()) { return new \PHPStan\Rules\RuleLevelHelperAcceptsResult(\true, $accepts->reasons); } if ($acceptingType instanceof UnionType) { $reasons = []; foreach ($acceptingType->getTypes() as $innerType) { $accepts = self::acceptsWithReason($innerType, $acceptedType, $strictTypes); if ($accepts->result) { return $accepts; } $reasons = array_merge($reasons, $accepts->reasons); } return new \PHPStan\Rules\RuleLevelHelperAcceptsResult(\false, $reasons); } if ($acceptedType->isArray()->yes() && $acceptingType->isArray()->yes() && ($acceptedType->isConstantArray()->no() || !$acceptedType->isIterableAtLeastOnce()->no()) && $acceptingType->isConstantArray()->no()) { if ($acceptingType->isIterableAtLeastOnce()->yes() && !$acceptedType->isIterableAtLeastOnce()->yes()) { $verbosity = VerbosityLevel::getRecommendedLevelByType($acceptingType, $acceptedType); return new \PHPStan\Rules\RuleLevelHelperAcceptsResult(\false, [sprintf('%s %s empty.', $acceptedType->describe($verbosity), $acceptedType->isIterableAtLeastOnce()->no() ? 'is' : 'might be')]); } if ($acceptingType->isList()->yes() && !$acceptedType->isList()->yes()) { $report = $checkForUnion || $acceptedType->isList()->no(); if ($report) { $verbosity = VerbosityLevel::getRecommendedLevelByType($acceptingType, $acceptedType); return new \PHPStan\Rules\RuleLevelHelperAcceptsResult(\false, [sprintf('%s %s a list.', $acceptedType->describe($verbosity), $acceptedType->isList()->no() ? 'is not' : 'might not be')]); } } return self::acceptsWithReason($acceptingType->getIterableKeyType(), $acceptedType->getIterableKeyType(), $strictTypes)->and(self::acceptsWithReason($acceptingType->getIterableValueType(), $acceptedType->getIterableValueType(), $strictTypes)); } return new \PHPStan\Rules\RuleLevelHelperAcceptsResult($checkForUnion ? $accepts->yes() : !$accepts->no(), $accepts->reasons); } /** * @api * @param callable(Type $type): bool $unionTypeCriteriaCallback */ public function findTypeToCheck(Scope $scope, Expr $var, string $unknownClassErrorPattern, callable $unionTypeCriteriaCallback) : \PHPStan\Rules\FoundTypeResult { if ($this->checkThisOnly && !$this->isThis($var)) { return new \PHPStan\Rules\FoundTypeResult(new ErrorType(), [], [], null); } $type = $scope->getType($var); return $this->findTypeToCheckImplementation($scope, $var, $type, $unknownClassErrorPattern, $unionTypeCriteriaCallback, \true); } /** @param callable(Type $type): bool $unionTypeCriteriaCallback */ private function findTypeToCheckImplementation(Scope $scope, Expr $var, Type $type, string $unknownClassErrorPattern, callable $unionTypeCriteriaCallback, bool $isTopLevel = \false) : \PHPStan\Rules\FoundTypeResult { if (!$this->checkNullables && !$type->isNull()->yes()) { $type = TypeCombinator::removeNull($type); } if ($this->newRuleLevelHelper) { if (($this->checkExplicitMixed || $this->checkImplicitMixed) && $type instanceof MixedType && ($type->isExplicitMixed() ? $this->checkExplicitMixed : $this->checkImplicitMixed)) { return new \PHPStan\Rules\FoundTypeResult($type instanceof TemplateMixedType ? $type->toStrictMixedType() : new StrictMixedType(), [], [], null); } } else { if ($this->checkExplicitMixed && $type instanceof MixedType && !$type instanceof TemplateMixedType && $type->isExplicitMixed()) { return new \PHPStan\Rules\FoundTypeResult(new StrictMixedType(), [], [], null); } if ($this->checkImplicitMixed && $type instanceof MixedType && !$type instanceof TemplateMixedType && !$type->isExplicitMixed()) { return new \PHPStan\Rules\FoundTypeResult(new StrictMixedType(), [], [], null); } } if ($type instanceof MixedType || $type instanceof NeverType) { return new \PHPStan\Rules\FoundTypeResult(new ErrorType(), [], [], null); } if (!$this->newRuleLevelHelper) { if ($isTopLevel && $type instanceof StaticType) { $type = $type->getStaticObjectType(); } } $errors = []; $hasClassExistsClass = \false; $directClassNames = []; if ($isTopLevel) { $directClassNames = $type->getObjectClassNames(); foreach ($directClassNames as $referencedClass) { if ($this->reflectionProvider->hasClass($referencedClass)) { $classReflection = $this->reflectionProvider->getClass($referencedClass); if (!$classReflection->isTrait()) { continue; } } if ($scope->isInClassExists($referencedClass)) { $hasClassExistsClass = \true; continue; } $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf($unknownClassErrorPattern, $referencedClass))->line($var->getStartLine())->identifier('class.notFound')->discoveringSymbolsTip()->build(); } } if (count($errors) > 0 || $hasClassExistsClass) { return new \PHPStan\Rules\FoundTypeResult(new ErrorType(), [], $errors, null); } if (!$this->checkUnionTypes && $type instanceof ObjectWithoutClassType) { return new \PHPStan\Rules\FoundTypeResult(new ErrorType(), [], [], null); } if ($this->newRuleLevelHelper) { if ($type instanceof UnionType) { $shouldFilterUnion = !$this->checkUnionTypes && !$type instanceof BenevolentUnionType || !$this->checkBenevolentUnionTypes && $type instanceof BenevolentUnionType; $newTypes = []; foreach ($type->getTypes() as $innerType) { if ($shouldFilterUnion && !$unionTypeCriteriaCallback($innerType)) { continue; } $newTypes[] = $this->findTypeToCheckImplementation($scope, $var, $innerType, $unknownClassErrorPattern, $unionTypeCriteriaCallback)->getType(); } if (count($newTypes) > 0) { $newUnion = TypeCombinator::union(...$newTypes); if (!$this->checkBenevolentUnionTypes && $type instanceof BenevolentUnionType) { $newUnion = TypeUtils::toBenevolentUnion($newUnion); } return new \PHPStan\Rules\FoundTypeResult($newUnion, $directClassNames, [], null); } } if ($type instanceof IntersectionType) { $newTypes = []; foreach ($type->getTypes() as $innerType) { $newTypes[] = $this->findTypeToCheckImplementation($scope, $var, $innerType, $unknownClassErrorPattern, $unionTypeCriteriaCallback)->getType(); } return new \PHPStan\Rules\FoundTypeResult(TypeCombinator::intersect(...$newTypes), $directClassNames, [], null); } } else { if (!$this->checkUnionTypes && $type instanceof UnionType && !$type instanceof BenevolentUnionType || !$this->checkBenevolentUnionTypes && $type instanceof BenevolentUnionType) { $newTypes = []; foreach ($type->getTypes() as $innerType) { if (!$unionTypeCriteriaCallback($innerType)) { continue; } $newTypes[] = $innerType; } if (count($newTypes) > 0) { return new \PHPStan\Rules\FoundTypeResult(TypeCombinator::union(...$newTypes), $directClassNames, [], null); } } } $tip = null; if ($type instanceof UnionType && count($type->getTypes()) === 2 && $type->getTypes()[0] instanceof ObjectType && $type->getTypes()[1] instanceof ObjectType && $type->getTypes()[0]->getClassName() === 'PhpParser\\Node\\Arg' && $type->getTypes()[1]->getClassName() === 'PhpParser\\Node\\VariadicPlaceholder' && !$unionTypeCriteriaCallback($type)) { $tip = 'Use <fg=cyan>->getArgs()</> instead of <fg=cyan>->args</>.'; } return new \PHPStan\Rules\FoundTypeResult($type, $directClassNames, [], $tip); } } <?php declare (strict_types=1); namespace PHPStan\Rules; /** @api */ interface TipRuleError extends \PHPStan\Rules\RuleError { public function getTip() : string; } <?php declare (strict_types=1); namespace PHPStan\Rules\EnumCases; use Attribute; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\AttributesCheck; use PHPStan\Rules\Rule; /** * @implements Rule<Node\Stmt\EnumCase> */ final class EnumCaseAttributesRule implements Rule { /** * @var AttributesCheck */ private $attributesCheck; public function __construct(AttributesCheck $attributesCheck) { $this->attributesCheck = $attributesCheck; } public function getNodeType() : string { return Node\Stmt\EnumCase::class; } public function processNode(Node $node, Scope $scope) : array { return $this->attributesCheck->check($scope, $node->attrGroups, Attribute::TARGET_CLASS_CONSTANT, 'class constant'); } } <?php declare (strict_types=1); namespace PHPStan\Rules; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Type\Constant\ConstantStringType; use function array_fill_keys; use function array_keys; use function array_merge; use function is_array; use function is_string; use function sprintf; final class UnusedFunctionParametersCheck { /** * @var ReflectionProvider */ private $reflectionProvider; public function __construct(ReflectionProvider $reflectionProvider) { $this->reflectionProvider = $reflectionProvider; } /** * @param string[] $parameterNames * @param Node[] $statements * @param 'constructor.unusedParameter'|'closure.unusedUse' $identifier * @return list<IdentifierRuleError> */ public function getUnusedParameters(Scope $scope, array $parameterNames, array $statements, string $unusedParameterMessage, string $identifier) : array { $unusedParameters = array_fill_keys($parameterNames, \true); foreach ($this->getUsedVariables($scope, $statements) as $variableName) { if (!isset($unusedParameters[$variableName])) { continue; } unset($unusedParameters[$variableName]); } $errors = []; foreach (array_keys($unusedParameters) as $name) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf($unusedParameterMessage, $name))->identifier($identifier)->build(); } return $errors; } /** * @param Node[]|Node|scalar|null $node * @return string[] */ private function getUsedVariables(Scope $scope, $node) : array { $variableNames = []; if ($node instanceof Node) { if ($node instanceof Node\Expr\FuncCall && $node->name instanceof Node\Name) { $functionName = $this->reflectionProvider->resolveFunctionName($node->name, $scope); if ($functionName === 'func_get_args' || $functionName === 'get_defined_vars') { return $scope->getDefinedVariables(); } } if ($node instanceof Node\Expr\Variable && is_string($node->name) && $node->name !== 'this') { return [$node->name]; } if ($node instanceof Node\Expr\ClosureUse && is_string($node->var->name)) { return [$node->var->name]; } if ($node instanceof Node\Expr\FuncCall && $node->name instanceof Node\Name && (string) $node->name === 'compact') { foreach ($node->getArgs() as $arg) { $argType = $scope->getType($arg->value); if (!$argType instanceof ConstantStringType) { continue; } $variableNames[] = $argType->getValue(); } } foreach ($node->getSubNodeNames() as $subNodeName) { if ($node instanceof Node\Expr\Closure && $subNodeName !== 'uses') { continue; } $subNode = $node->{$subNodeName}; $variableNames = array_merge($variableNames, $this->getUsedVariables($scope, $subNode)); } } elseif (is_array($node)) { foreach ($node as $subNode) { $variableNames = array_merge($variableNames, $this->getUsedVariables($scope, $subNode)); } } return $variableNames; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Traits; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionClassConstant; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\InitializerExprContext; use PHPStan\Reflection\InitializerExprTypeResolver; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\ParserNodeTypeToPHPStanType; use PHPStan\Type\TypehintHelper; use PHPStan\Type\VerbosityLevel; use function sprintf; /** * @implements Rule<Node\Stmt\ClassConst> */ final class ConflictingTraitConstantsRule implements Rule { /** * @var InitializerExprTypeResolver */ private $initializerExprTypeResolver; public function __construct(InitializerExprTypeResolver $initializerExprTypeResolver) { $this->initializerExprTypeResolver = $initializerExprTypeResolver; } public function getNodeType() : string { return Node\Stmt\ClassConst::class; } public function processNode(Node $node, Scope $scope) : array { if (!$scope->isInClass()) { return []; } $classReflection = $scope->getClassReflection(); $traitConstants = []; foreach ($classReflection->getTraits(\true) as $trait) { foreach ($trait->getNativeReflection()->getReflectionConstants() as $constant) { $traitConstants[] = $constant; } } $errors = []; foreach ($node->consts as $const) { foreach ($traitConstants as $traitConstant) { if ($traitConstant->getName() !== $const->name->toString()) { continue; } foreach ($this->processSingleConstant($classReflection, $traitConstant, $node, $const->value) as $error) { $errors[] = $error; } } } return $errors; } /** * @return list<IdentifierRuleError> */ private function processSingleConstant(ClassReflection $classReflection, ReflectionClassConstant $traitConstant, Node\Stmt\ClassConst $classConst, Node\Expr $valueExpr) : array { $errors = []; if ($traitConstant->isPublic()) { if ($classConst->isProtected()) { $errors[] = RuleErrorBuilder::message(sprintf('Protected constant %s::%s overriding public constant %s::%s should also be public.', $classReflection->getDisplayName(), $traitConstant->getName(), $traitConstant->getDeclaringClass()->getName(), $traitConstant->getName()))->nonIgnorable()->identifier('classConstant.visibility')->build(); } elseif ($classConst->isPrivate()) { $errors[] = RuleErrorBuilder::message(sprintf('Private constant %s::%s overriding public constant %s::%s should also be public.', $classReflection->getDisplayName(), $traitConstant->getName(), $traitConstant->getDeclaringClass()->getName(), $traitConstant->getName()))->nonIgnorable()->identifier('classConstant.visibility')->build(); } } elseif ($traitConstant->isProtected()) { if ($classConst->isPublic()) { $errors[] = RuleErrorBuilder::message(sprintf('Public constant %s::%s overriding protected constant %s::%s should also be protected.', $classReflection->getDisplayName(), $traitConstant->getName(), $traitConstant->getDeclaringClass()->getName(), $traitConstant->getName()))->nonIgnorable()->identifier('classConstant.visibility')->build(); } elseif ($classConst->isPrivate()) { $errors[] = RuleErrorBuilder::message(sprintf('Private constant %s::%s overriding protected constant %s::%s should also be protected.', $classReflection->getDisplayName(), $traitConstant->getName(), $traitConstant->getDeclaringClass()->getName(), $traitConstant->getName()))->nonIgnorable()->identifier('classConstant.visibility')->build(); } } elseif ($traitConstant->isPrivate()) { if ($classConst->isPublic()) { $errors[] = RuleErrorBuilder::message(sprintf('Public constant %s::%s overriding private constant %s::%s should also be private.', $classReflection->getDisplayName(), $traitConstant->getName(), $traitConstant->getDeclaringClass()->getName(), $traitConstant->getName()))->nonIgnorable()->identifier('classConstant.visibility')->build(); } elseif ($classConst->isProtected()) { $errors[] = RuleErrorBuilder::message(sprintf('Protected constant %s::%s overriding private constant %s::%s should also be private.', $classReflection->getDisplayName(), $traitConstant->getName(), $traitConstant->getDeclaringClass()->getName(), $traitConstant->getName()))->nonIgnorable()->identifier('classConstant.visibility')->build(); } } if ($traitConstant->isFinal()) { if (!$classConst->isFinal()) { $errors[] = RuleErrorBuilder::message(sprintf('Non-final constant %s::%s overriding final constant %s::%s should also be final.', $classReflection->getDisplayName(), $traitConstant->getName(), $traitConstant->getDeclaringClass()->getName(), $traitConstant->getName()))->nonIgnorable()->identifier('classConstant.nonFinal')->build(); } } elseif ($classConst->isFinal()) { $errors[] = RuleErrorBuilder::message(sprintf('Final constant %s::%s overriding non-final constant %s::%s should also be non-final.', $classReflection->getDisplayName(), $traitConstant->getName(), $traitConstant->getDeclaringClass()->getName(), $traitConstant->getName()))->nonIgnorable()->identifier('classConstant.final')->build(); } $traitNativeType = $traitConstant->getType(); $constantNativeType = $classConst->type; $traitDeclaringClass = $traitConstant->getDeclaringClass(); if ($traitNativeType === null) { if ($constantNativeType !== null) { $constantNativeTypeType = ParserNodeTypeToPHPStanType::resolve($constantNativeType, $classReflection); $errors[] = RuleErrorBuilder::message(sprintf('Constant %s::%s (%s) overriding constant %s::%s should not have a native type.', $classReflection->getDisplayName(), $traitConstant->getName(), $constantNativeTypeType->describe(VerbosityLevel::typeOnly()), $traitConstant->getDeclaringClass()->getName(), $traitConstant->getName()))->nonIgnorable()->identifier('classConstant.nativeType')->build(); } } elseif ($constantNativeType === null) { $traitNativeTypeType = TypehintHelper::decideTypeFromReflection($traitNativeType, null, $traitDeclaringClass->getName()); $errors[] = RuleErrorBuilder::message(sprintf('Constant %s::%s overriding constant %s::%s (%s) should also have native type %s.', $classReflection->getDisplayName(), $traitConstant->getName(), $traitConstant->getDeclaringClass()->getName(), $traitConstant->getName(), $traitNativeTypeType->describe(VerbosityLevel::typeOnly()), $traitNativeTypeType->describe(VerbosityLevel::typeOnly())))->nonIgnorable()->identifier('classConstant.missingNativeType')->build(); } else { $traitNativeTypeType = TypehintHelper::decideTypeFromReflection($traitNativeType, null, $traitDeclaringClass->getName()); $constantNativeTypeType = ParserNodeTypeToPHPStanType::resolve($constantNativeType, $classReflection); if (!$traitNativeTypeType->equals($constantNativeTypeType)) { $errors[] = RuleErrorBuilder::message(sprintf('Constant %s::%s (%s) overriding constant %s::%s (%s) should have the same native type %s.', $classReflection->getDisplayName(), $traitConstant->getName(), $constantNativeTypeType->describe(VerbosityLevel::typeOnly()), $traitConstant->getDeclaringClass()->getName(), $traitConstant->getName(), $traitNativeTypeType->describe(VerbosityLevel::typeOnly()), $traitNativeTypeType->describe(VerbosityLevel::typeOnly())))->nonIgnorable()->identifier('classConstant.nativeType')->build(); } } $classConstantValueType = $this->initializerExprTypeResolver->getType($valueExpr, InitializerExprContext::fromClassReflection($classReflection)); $traitConstantValueType = $this->initializerExprTypeResolver->getType($traitConstant->getValueExpression(), InitializerExprContext::fromClass($traitDeclaringClass->getName(), $traitDeclaringClass->getFileName() !== \false ? $traitDeclaringClass->getFileName() : null)); if (!$classConstantValueType->equals($traitConstantValueType)) { $errors[] = RuleErrorBuilder::message(sprintf('Constant %s::%s with value %s overriding constant %s::%s with different value %s should have the same value.', $classReflection->getDisplayName(), $traitConstant->getName(), $classConstantValueType->describe(VerbosityLevel::value()), $traitConstant->getDeclaringClass()->getName(), $traitConstant->getName(), $traitConstantValueType->describe(VerbosityLevel::value())))->nonIgnorable()->identifier('classConstant.value')->build(); } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Traits; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Php\PhpVersion; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; /** * @implements Rule<Node\Stmt\ClassConst> */ final class ConstantsInTraitsRule implements Rule { /** * @var PhpVersion */ private $phpVersion; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; } public function getNodeType() : string { return Node\Stmt\ClassConst::class; } /** * @param Node\Stmt\ClassConst $node */ public function processNode(Node $node, Scope $scope) : array { if ($this->phpVersion->supportsConstantsInTraits()) { return []; } if (!$scope->isInTrait()) { return []; } return [RuleErrorBuilder::message('Constant is declared inside a trait but is only supported on PHP 8.2 and later.')->identifier('classConstant.inTrait')->nonIgnorable()->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Traits; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Collectors\Collector; /** * @implements Collector<Node\Stmt\Trait_, array{string, int}> */ final class TraitDeclarationCollector implements Collector { public function getNodeType() : string { return Node\Stmt\Trait_::class; } public function processNode(Node $node, Scope $scope) { if ($node->namespacedName === null) { return null; } return [$node->namespacedName->toString(), $node->getStartLine()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Traits; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Collectors\Collector; use function array_map; use function array_values; /** * @implements Collector<Node\Stmt\TraitUse, list<string>> */ final class TraitUseCollector implements Collector { public function getNodeType() : string { return Node\Stmt\TraitUse::class; } /** * @return list<string> */ public function processNode(Node $node, Scope $scope) : array { return array_values(array_map(static function (Node\Name $traitName) { return $traitName->toString(); }, $node->traits)); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Traits; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\CollectedDataNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function sprintf; use function strtolower; /** * @implements Rule<CollectedDataNode> */ final class NotAnalysedTraitRule implements Rule { public function getNodeType() : string { return CollectedDataNode::class; } public function processNode(Node $node, Scope $scope) : array { if ($node->isOnlyFilesAnalysis()) { return []; } $traitDeclarationData = $node->get(\PHPStan\Rules\Traits\TraitDeclarationCollector::class); $traitUseData = $node->get(\PHPStan\Rules\Traits\TraitUseCollector::class); $declaredTraits = []; foreach ($traitDeclarationData as $file => $declaration) { foreach ($declaration as [$name, $line]) { $declaredTraits[strtolower($name)] = [$file, $name, $line]; } } foreach ($traitUseData as $usedNamesData) { foreach ($usedNamesData as $usedNames) { foreach ($usedNames as $usedName) { unset($declaredTraits[strtolower($usedName)]); } } } $errors = []; foreach ($declaredTraits as [$file, $name, $line]) { $errors[] = RuleErrorBuilder::message(sprintf('Trait %s is used zero times and is not analysed.', $name))->file($file)->line($line)->identifier('trait.unused')->tip('See: https://phpstan.org/blog/how-phpstan-analyses-traits')->build(); } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Regexp; use _PHPStan_7d8742a37\Nette\Utils\RegexpException; use _PHPStan_7d8742a37\Nette\Utils\Strings; use PhpParser\Node; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\Regex\RegexExpressionHelper; use function in_array; use function sprintf; use function str_starts_with; use function strtolower; /** * @implements Rule<Node\Expr\FuncCall> */ final class RegularExpressionPatternRule implements Rule { /** * @var RegexExpressionHelper */ private $regexExpressionHelper; public function __construct(RegexExpressionHelper $regexExpressionHelper) { $this->regexExpressionHelper = $regexExpressionHelper; } public function getNodeType() : string { return FuncCall::class; } public function processNode(Node $node, Scope $scope) : array { $patterns = $this->extractPatterns($node, $scope); $errors = []; foreach ($patterns as $pattern) { $errorMessage = $this->validatePattern($pattern); if ($errorMessage === null) { continue; } $errors[] = RuleErrorBuilder::message(sprintf('Regex pattern is invalid: %s', $errorMessage))->identifier('regexp.pattern')->build(); } return $errors; } /** * @return string[] */ private function extractPatterns(FuncCall $functionCall, Scope $scope) : array { if (!$functionCall->name instanceof Node\Name) { return []; } $functionName = strtolower((string) $functionCall->name); if (!str_starts_with($functionName, 'preg_')) { return []; } if (!isset($functionCall->getArgs()[0])) { return []; } $patternNode = $functionCall->getArgs()[0]->value; $patternType = $scope->getType($patternNode); $patternStrings = []; if (in_array($functionName, ['preg_match', 'preg_match_all', 'preg_split', 'preg_grep', 'preg_replace', 'preg_replace_callback', 'preg_filter'], \true)) { if ($patternNode instanceof Node\Expr\BinaryOp\Concat) { $patternType = $this->regexExpressionHelper->resolvePatternConcat($patternNode, $scope); } foreach ($patternType->getConstantStrings() as $constantStringType) { $patternStrings[] = $constantStringType->getValue(); } } if (in_array($functionName, ['preg_replace', 'preg_replace_callback', 'preg_filter'], \true)) { foreach ($patternType->getConstantArrays() as $constantArrayType) { foreach ($constantArrayType->getValueTypes() as $arrayKeyType) { foreach ($arrayKeyType->getConstantStrings() as $constantString) { $patternStrings[] = $constantString->getValue(); } } } } if ($functionName === 'preg_replace_callback_array') { foreach ($patternType->getConstantArrays() as $constantArrayType) { foreach ($constantArrayType->getKeyTypes() as $arrayKeyType) { foreach ($arrayKeyType->getConstantStrings() as $constantString) { $patternStrings[] = $constantString->getValue(); } } } } return $patternStrings; } private function validatePattern(string $pattern) : ?string { try { Strings::match('', $pattern); } catch (RegexpException $e) { return $e->getMessage(); } return null; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Regexp; use PhpParser\Node; use PhpParser\Node\Expr\BinaryOp\Concat; use PhpParser\Node\Expr\FuncCall; use PhpParser\Node\Name; use PHPStan\Analyser\ArgumentsNormalizer; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\ParametersAcceptorSelector; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\ShouldNotHappenException; use PHPStan\Type\Regex\RegexExpressionHelper; use function array_filter; use function array_merge; use function array_values; use function count; use function in_array; use function sprintf; use function strlen; /** * @implements Rule<Node\Expr\FuncCall> */ final class RegularExpressionQuotingRule implements Rule { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var RegexExpressionHelper */ private $regexExpressionHelper; public function __construct(ReflectionProvider $reflectionProvider, RegexExpressionHelper $regexExpressionHelper) { $this->reflectionProvider = $reflectionProvider; $this->regexExpressionHelper = $regexExpressionHelper; } public function getNodeType() : string { return FuncCall::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->name instanceof Node\Name) { return []; } if (!$this->reflectionProvider->hasFunction($node->name, $scope)) { return []; } $functionReflection = $this->reflectionProvider->getFunction($node->name, $scope); if (!in_array($functionReflection->getName(), ['preg_match', 'preg_match_all', 'preg_filter', 'preg_grep', 'preg_replace', 'preg_replace_callback', 'preg_split'], \true)) { return []; } $normalizedArgs = $this->getNormalizedArgs($node, $scope, $functionReflection); if ($normalizedArgs === null) { return []; } if (!isset($normalizedArgs[0])) { return []; } if (!$normalizedArgs[0]->value instanceof Concat) { return []; } $patternDelimiters = $this->regexExpressionHelper->getPatternDelimiters($normalizedArgs[0]->value, $scope); return $this->validateQuoteDelimiters($normalizedArgs[0]->value, $scope, $patternDelimiters); } /** * @param string[] $patternDelimiters * * @return list<IdentifierRuleError> */ private function validateQuoteDelimiters(Concat $concat, Scope $scope, array $patternDelimiters) : array { if ($patternDelimiters === []) { return []; } $errors = []; if ($concat->left instanceof FuncCall && $concat->left->name instanceof Name && $concat->left->name->toLowerString() === 'preg_quote') { $pregError = $this->validatePregQuote($concat->left, $scope, $patternDelimiters); if ($pregError !== null) { $errors[] = $pregError; } } elseif ($concat->left instanceof Concat) { $errors = array_merge($errors, $this->validateQuoteDelimiters($concat->left, $scope, $patternDelimiters)); } if ($concat->right instanceof FuncCall && $concat->right->name instanceof Name && $concat->right->name->toLowerString() === 'preg_quote') { $pregError = $this->validatePregQuote($concat->right, $scope, $patternDelimiters); if ($pregError !== null) { $errors[] = $pregError; } } elseif ($concat->right instanceof Concat) { $errors = array_merge($errors, $this->validateQuoteDelimiters($concat->right, $scope, $patternDelimiters)); } return $errors; } /** * @param string[] $patternDelimiters */ private function validatePregQuote(FuncCall $pregQuote, Scope $scope, array $patternDelimiters) : ?IdentifierRuleError { if (!$pregQuote->name instanceof Node\Name) { return null; } if (!$this->reflectionProvider->hasFunction($pregQuote->name, $scope)) { return null; } $functionReflection = $this->reflectionProvider->getFunction($pregQuote->name, $scope); $args = $this->getNormalizedArgs($pregQuote, $scope, $functionReflection); if ($args === null) { return null; } $patternDelimiters = $this->removeDefaultEscapedDelimiters($patternDelimiters); if ($patternDelimiters === []) { return null; } if (count($args) === 1) { if (count($patternDelimiters) === 1) { return RuleErrorBuilder::message(sprintf('Call to preg_quote() is missing delimiter %s to be effective.', $patternDelimiters[0]))->line($pregQuote->getStartLine())->identifier('argument.invalidPregQuote')->build(); } return RuleErrorBuilder::message('Call to preg_quote() is missing delimiter parameter to be effective.')->line($pregQuote->getStartLine())->identifier('argument.invalidPregQuote')->build(); } if (count($args) >= 2) { foreach ($scope->getType($args[1]->value)->getConstantStrings() as $quoteDelimiterType) { $quoteDelimiter = $quoteDelimiterType->getValue(); $quoteDelimiters = $this->removeDefaultEscapedDelimiters([$quoteDelimiter]); if ($quoteDelimiters === []) { continue; } if (count($quoteDelimiters) !== 1) { throw new ShouldNotHappenException(); } $quoteDelimiter = $quoteDelimiters[0]; if (!in_array($quoteDelimiter, $patternDelimiters, \true)) { if (count($patternDelimiters) === 1) { return RuleErrorBuilder::message(sprintf('Call to preg_quote() uses invalid delimiter %s while pattern uses %s.', $quoteDelimiter, $patternDelimiters[0]))->line($pregQuote->getStartLine())->identifier('argument.invalidPregQuote')->build(); } return RuleErrorBuilder::message(sprintf('Call to preg_quote() uses invalid delimiter %s.', $quoteDelimiter))->line($pregQuote->getStartLine())->identifier('argument.invalidPregQuote')->build(); } } } return null; } /** * @param string[] $delimiters * * @return list<string> */ private function removeDefaultEscapedDelimiters(array $delimiters) : array { return array_values(array_filter($delimiters, function (string $delimiter) : bool { return !$this->isDefaultEscaped($delimiter); })); } private function isDefaultEscaped(string $delimiter) : bool { if (strlen($delimiter) !== 1) { return \false; } return in_array( $delimiter, // these delimiters are escaped, no matter what preg_quote() 2nd arg looks like ['.', '\\', '+', '*', '?', '[', '^', ']', '$', '(', ')', '{', '}', '=', '!', '<', '>', '|', ':', '-', '#'], \true ); } /** * @return Node\Arg[]|null */ private function getNormalizedArgs(FuncCall $functionCall, Scope $scope, FunctionReflection $functionReflection) : ?array { $parametersAcceptor = ParametersAcceptorSelector::selectFromArgs($scope, $functionCall->getArgs(), $functionReflection->getVariants(), $functionReflection->getNamedArgumentsVariants()); $normalizedFuncCall = ArgumentsNormalizer::reorderFuncArguments($parametersAcceptor, $functionCall); if ($normalizedFuncCall === null) { return null; } return $normalizedFuncCall->getArgs(); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Missing; use Generator; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\ExecutionEndNode; use PHPStan\Reflection\MethodReflection; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\ShouldNotHappenException; use PHPStan\Type\ErrorType; use PHPStan\Type\Generic\TemplateMixedType; use PHPStan\Type\MixedType; use PHPStan\Type\NeverType; use PHPStan\Type\TypeCombinator; use PHPStan\Type\TypeUtils; use PHPStan\Type\VerbosityLevel; use PHPStan\Type\VoidType; use function sprintf; /** * @implements Rule<ExecutionEndNode> */ final class MissingReturnRule implements Rule { /** * @var bool */ private $checkExplicitMixedMissingReturn; /** * @var bool */ private $checkPhpDocMissingReturn; public function __construct(bool $checkExplicitMixedMissingReturn, bool $checkPhpDocMissingReturn) { $this->checkExplicitMixedMissingReturn = $checkExplicitMixedMissingReturn; $this->checkPhpDocMissingReturn = $checkPhpDocMissingReturn; } public function getNodeType() : string { return ExecutionEndNode::class; } public function processNode(Node $node, Scope $scope) : array { $statementResult = $node->getStatementResult(); if ($statementResult->isAlwaysTerminating()) { return []; } $anonymousFunctionReturnType = $scope->getAnonymousFunctionReturnType(); $scopeFunction = $scope->getFunction(); if ($anonymousFunctionReturnType !== null) { $returnType = $anonymousFunctionReturnType; $description = 'Anonymous function'; if (!$node->hasNativeReturnTypehint()) { return []; } } elseif ($scopeFunction !== null) { $returnType = $scopeFunction->getReturnType(); if ($scopeFunction instanceof MethodReflection) { $description = sprintf('Method %s::%s()', $scopeFunction->getDeclaringClass()->getDisplayName(), $scopeFunction->getName()); } else { $description = sprintf('Function %s()', $scopeFunction->getName()); } } else { throw new ShouldNotHappenException(); } $returnType = TypeUtils::resolveLateResolvableTypes($returnType); $isVoidSuperType = $returnType->isSuperTypeOf(new VoidType()); if ($isVoidSuperType->yes() && !$returnType instanceof MixedType) { return []; } if ($statementResult->hasYield()) { if ($this->checkPhpDocMissingReturn) { $generatorReturnType = $returnType->getTemplateType(Generator::class, 'TReturn'); if (!$generatorReturnType instanceof ErrorType) { $returnType = $generatorReturnType; if ($returnType->isVoid()->yes()) { return []; } if (!$returnType instanceof MixedType) { return [RuleErrorBuilder::message(sprintf('%s should return %s but return statement is missing.', $description, $returnType->describe(VerbosityLevel::typeOnly())))->line($node->getNode()->getStartLine())->identifier('return.missing')->build()]; } } } return []; } if (!$node->hasNativeReturnTypehint() && !$this->checkPhpDocMissingReturn && TypeCombinator::containsNull($returnType)) { return []; } if ($returnType instanceof NeverType && $returnType->isExplicit()) { $errorBuilder = RuleErrorBuilder::message(sprintf('%s should always throw an exception or terminate script execution but doesn\'t do that.', $description))->line($node->getNode()->getStartLine()); if ($node->hasNativeReturnTypehint()) { $errorBuilder->nonIgnorable(); } $errorBuilder->identifier('return.never'); return [$errorBuilder->build()]; } if ($returnType instanceof MixedType && !$returnType instanceof TemplateMixedType && !$node->hasNativeReturnTypehint() && (!$returnType->isExplicitMixed() || !$this->checkExplicitMixedMissingReturn)) { return []; } $errorBuilder = RuleErrorBuilder::message(sprintf('%s should return %s but return statement is missing.', $description, $returnType->describe(VerbosityLevel::typeOnly())))->line($node->getNode()->getStartLine()); if ($node->hasNativeReturnTypehint()) { $errorBuilder->nonIgnorable(); } $errorBuilder->identifier('return.missing'); return [$errorBuilder->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Api; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Reflection\MethodReflection; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function count; use function sprintf; use function str_contains; /** * @implements Rule<Node\Expr\StaticCall> */ final class ApiStaticCallRule implements Rule { /** * @var ApiRuleHelper */ private $apiRuleHelper; /** * @var ReflectionProvider */ private $reflectionProvider; public function __construct(\PHPStan\Rules\Api\ApiRuleHelper $apiRuleHelper, ReflectionProvider $reflectionProvider) { $this->apiRuleHelper = $apiRuleHelper; $this->reflectionProvider = $reflectionProvider; } public function getNodeType() : string { return Node\Expr\StaticCall::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->name instanceof Node\Identifier) { return []; } if (!$node->class instanceof Node\Name) { return []; } $className = $scope->resolveName($node->class); if (!$this->reflectionProvider->hasClass($className)) { return []; } $classReflection = $this->reflectionProvider->getClass($className); $methodName = $node->name->toString(); if (!$classReflection->hasNativeMethod($methodName)) { return []; } $methodReflection = $classReflection->getNativeMethod($methodName); $declaringClass = $methodReflection->getDeclaringClass(); if (!$this->apiRuleHelper->isPhpStanCode($scope, $declaringClass->getName(), $declaringClass->getFileName())) { return []; } if ($this->isCovered($methodReflection)) { return []; } $ruleError = RuleErrorBuilder::message(sprintf('Calling %s::%s() is not covered by backward compatibility promise. The method might change in a minor PHPStan version.', $declaringClass->getDisplayName(), $methodReflection->getName()))->identifier('phpstanApi.method')->tip(sprintf("If you think it should be covered by backward compatibility promise, open a discussion:\n %s\n\n See also:\n https://phpstan.org/developing-extensions/backward-compatibility-promise", 'https://github.com/phpstan/phpstan/discussions'))->build(); return [$ruleError]; } private function isCovered(MethodReflection $methodReflection) : bool { $declaringClass = $methodReflection->getDeclaringClass(); $classDocBlock = $declaringClass->getResolvedPhpDoc(); if ($methodReflection->getName() !== '__construct' && $classDocBlock !== null) { foreach ($classDocBlock->getPhpDocNodes() as $phpDocNode) { $apiTags = $phpDocNode->getTagsByName('@api'); if (count($apiTags) > 0) { return \true; } } } $methodDocComment = $methodReflection->getDocComment(); if ($methodDocComment === null) { return \false; } return str_contains($methodDocComment, '@api'); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Api; use PHPStan\Analyser\Scope; use PHPStan\File\ParentDirectoryRelativePathHelper; use function dirname; use function pathinfo; use function str_starts_with; use function stripos; use function strtolower; use const PATHINFO_BASENAME; final class ApiRuleHelper { public function isPhpStanCode(Scope $scope, string $namespace, ?string $declaringFile) : bool { $scopeNamespace = $scope->getNamespace(); if ($scopeNamespace === null) { return $this->isPhpStanName($namespace); } if ($this->isPhpStanName($scopeNamespace)) { if (!$this->isPhpStanName($namespace)) { return \false; } if ($declaringFile !== null) { $scopeFile = $scope->getFile(); $dir = dirname($scopeFile); $helper = new ParentDirectoryRelativePathHelper($dir); $pathParts = $helper->getFilenameParts($declaringFile); $directories = $this->createAbsoluteDirectories($dir, $pathParts); foreach ($directories as $directory) { if (pathinfo($directory, PATHINFO_BASENAME) === 'vendor') { return \true; } } } return \false; } return $this->isPhpStanName($namespace); } /** * @param string[] $parts * @return string[] */ private function createAbsoluteDirectories(string $currentDirectory, array $parts) : array { $directories = []; foreach ($parts as $part) { if ($part === '..') { $currentDirectory = dirname($currentDirectory); $directories[] = $currentDirectory; continue; } $currentDirectory .= '/' . $part; $directories[] = $currentDirectory; } return $directories; } public function isPhpStanName(string $namespace) : bool { if (strtolower($namespace) === 'phpstan') { return \true; } if (str_starts_with($namespace, 'PHPStan\\PhpDocParser\\')) { return \false; } if (str_starts_with($namespace, 'PHPStan\\BetterReflection\\')) { return \false; } return stripos($namespace, 'PHPStan\\') === 0; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Api; use PhpParser\Node; use PhpParser\Node\Stmt\Class_; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function array_merge; use function count; use function in_array; use function sprintf; /** * @implements Rule<Class_> */ final class ApiClassImplementsRule implements Rule { /** * @var ApiRuleHelper */ private $apiRuleHelper; /** * @var ReflectionProvider */ private $reflectionProvider; public function __construct(\PHPStan\Rules\Api\ApiRuleHelper $apiRuleHelper, ReflectionProvider $reflectionProvider) { $this->apiRuleHelper = $apiRuleHelper; $this->reflectionProvider = $reflectionProvider; } public function getNodeType() : string { return Class_::class; } public function processNode(Node $node, Scope $scope) : array { $errors = []; foreach ($node->implements as $implements) { $errors = array_merge($errors, $this->checkName($scope, $implements)); } return $errors; } /** * @return list<IdentifierRuleError> */ private function checkName(Scope $scope, Node\Name $name) : array { $implementedClassName = (string) $name; if (!$this->reflectionProvider->hasClass($implementedClassName)) { return []; } $implementedClassReflection = $this->reflectionProvider->getClass($implementedClassName); if (!$this->apiRuleHelper->isPhpStanCode($scope, $implementedClassReflection->getName(), $implementedClassReflection->getFileName())) { return []; } $ruleError = RuleErrorBuilder::message(sprintf('Implementing %s is not covered by backward compatibility promise. The interface might change in a minor PHPStan version.', $implementedClassReflection->getDisplayName()))->identifier('phpstanApi.interface')->tip(sprintf("If you think it should be covered by backward compatibility promise, open a discussion:\n %s\n\n See also:\n https://phpstan.org/developing-extensions/backward-compatibility-promise", 'https://github.com/phpstan/phpstan/discussions'))->build(); if (in_array($implementedClassReflection->getName(), \PHPStan\Rules\Api\BcUncoveredInterface::CLASSES, \true)) { return [$ruleError]; } $docBlock = $implementedClassReflection->getResolvedPhpDoc(); if ($docBlock === null) { return [$ruleError]; } foreach ($docBlock->getPhpDocNodes() as $phpDocNode) { $apiTags = $phpDocNode->getTagsByName('@api'); if (count($apiTags) > 0) { return []; } } return [$ruleError]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Api; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function count; use function sprintf; use function str_contains; /** * @implements Rule<Node\Expr\ClassConstFetch> */ final class ApiClassConstFetchRule implements Rule { /** * @var ApiRuleHelper */ private $apiRuleHelper; /** * @var ReflectionProvider */ private $reflectionProvider; public function __construct(\PHPStan\Rules\Api\ApiRuleHelper $apiRuleHelper, ReflectionProvider $reflectionProvider) { $this->apiRuleHelper = $apiRuleHelper; $this->reflectionProvider = $reflectionProvider; } public function getNodeType() : string { return Node\Expr\ClassConstFetch::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->name instanceof Node\Identifier) { return []; } if (!$node->class instanceof Node\Name) { return []; } $className = $scope->resolveName($node->class); if (!$this->reflectionProvider->hasClass($className)) { return []; } $classReflection = $this->reflectionProvider->getClass($className); if (!$this->apiRuleHelper->isPhpStanCode($scope, $classReflection->getName(), $classReflection->getFileName())) { return []; } $ruleError = RuleErrorBuilder::message(sprintf('Accessing %s::%s is not covered by backward compatibility promise. The class might change in a minor PHPStan version.', $classReflection->getDisplayName(), $node->name->toString()))->identifier('phpstanApi.classConstant')->tip(sprintf("If you think it should be covered by backward compatibility promise, open a discussion:\n %s\n\n See also:\n https://phpstan.org/developing-extensions/backward-compatibility-promise", 'https://github.com/phpstan/phpstan/discussions'))->build(); $docBlock = $classReflection->getResolvedPhpDoc(); if ($docBlock !== null) { foreach ($docBlock->getPhpDocNodes() as $phpDocNode) { $apiTags = $phpDocNode->getTagsByName('@api'); if (count($apiTags) > 0) { return []; } } } if ($node->name->toLowerString() === 'class') { foreach ($classReflection->getNativeReflection()->getMethods() as $methodReflection) { $methodDocComment = $methodReflection->getDocComment(); if ($methodDocComment === \false) { continue; } if (!str_contains($methodDocComment, '@api')) { continue; } return []; } } return [$ruleError]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Api; use PhpParser\Node; use PhpParser\Node\Expr\Instanceof_; use PHPStan\Analyser\Scope; use PHPStan\Parser\TypeTraverserInstanceofVisitor; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\Accessory\AccessoryArrayListType; use PHPStan\Type\Accessory\AccessoryLiteralStringType; use PHPStan\Type\Accessory\AccessoryLowercaseStringType; use PHPStan\Type\Accessory\AccessoryNonEmptyStringType; use PHPStan\Type\Accessory\AccessoryNonFalsyStringType; use PHPStan\Type\Accessory\AccessoryNumericStringType; use PHPStan\Type\Accessory\AccessoryType; use PHPStan\Type\Accessory\AccessoryUppercaseStringType; use PHPStan\Type\Accessory\HasMethodType; use PHPStan\Type\Accessory\HasOffsetType; use PHPStan\Type\Accessory\HasPropertyType; use PHPStan\Type\Accessory\NonEmptyArrayType; use PHPStan\Type\Accessory\OversizedArrayType; use PHPStan\Type\ArrayType; use PHPStan\Type\BooleanType; use PHPStan\Type\CallableType; use PHPStan\Type\ClassStringType; use PHPStan\Type\Constant\ConstantArrayType; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\ConstantScalarType; use PHPStan\Type\ConstantType; use PHPStan\Type\Enum\EnumCaseObjectType; use PHPStan\Type\FloatType; use PHPStan\Type\Generic\GenericClassStringType; use PHPStan\Type\Generic\GenericObjectType; use PHPStan\Type\IntegerType; use PHPStan\Type\IntersectionType; use PHPStan\Type\IterableType; use PHPStan\Type\NullType; use PHPStan\Type\ObjectShapeType; use PHPStan\Type\ObjectType; use PHPStan\Type\ObjectWithoutClassType; use PHPStan\Type\StringType; use PHPStan\Type\TypeWithClassName; use PHPStan\Type\VoidType; use function array_key_exists; use function sprintf; use function strtolower; /** * @implements Rule<Instanceof_> */ final class ApiInstanceofTypeRule implements Rule { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var bool */ private $enabled; /** * @var bool */ private $deprecationRulesInstalled; private const MAP = [ TypeWithClassName::class => 'Type::getObjectClassNames() or Type::getObjectClassReflections()', EnumCaseObjectType::class => 'Type::getEnumCases()', ConstantArrayType::class => 'Type::getConstantArrays()', ArrayType::class => 'Type::isArray() or Type::getArrays()', ConstantStringType::class => 'Type::getConstantStrings()', StringType::class => 'Type::isString()', ClassStringType::class => 'Type::isClassStringType()', IntegerType::class => 'Type::isInteger()', FloatType::class => 'Type::isFloat()', NullType::class => 'Type::isNull()', VoidType::class => 'Type::isVoid()', BooleanType::class => 'Type::isBoolean()', ConstantBooleanType::class => 'Type::isTrue() or Type::isFalse()', CallableType::class => 'Type::isCallable() and Type::getCallableParametersAcceptors()', IterableType::class => 'Type::isIterable()', ObjectWithoutClassType::class => 'Type::isObject()', ObjectType::class => 'Type::isObject() or Type::getObjectClassNames()', GenericClassStringType::class => 'Type::isClassStringType() and Type::getClassStringObjectType()', GenericObjectType::class => null, IntersectionType::class => null, ConstantType::class => 'Type::isConstantValue() or Type::generalize()', ConstantScalarType::class => 'Type::isConstantScalarValue() or Type::getConstantScalarTypes() or Type::getConstantScalarValues()', ObjectShapeType::class => 'Type::isObject() and Type::hasProperty()', // accessory types NonEmptyArrayType::class => 'Type::isIterableAtLeastOnce()', OversizedArrayType::class => 'Type::isOversizedArray()', AccessoryArrayListType::class => 'Type::isList()', AccessoryNumericStringType::class => 'Type::isNumericString()', AccessoryLiteralStringType::class => 'Type::isLiteralString()', AccessoryLowercaseStringType::class => 'Type::isLowercaseString()', AccessoryUppercaseStringType::class => 'Type::isUppercaseString()', AccessoryNonEmptyStringType::class => 'Type::isNonEmptyString()', AccessoryNonFalsyStringType::class => 'Type::isNonFalsyString()', HasMethodType::class => 'Type::hasMethod()', HasPropertyType::class => 'Type::hasProperty()', HasOffsetType::class => 'Type::hasOffsetValueType()', AccessoryType::class => 'methods on PHPStan\\Type\\Type', ]; public function __construct(ReflectionProvider $reflectionProvider, bool $enabled, bool $deprecationRulesInstalled) { $this->reflectionProvider = $reflectionProvider; $this->enabled = $enabled; $this->deprecationRulesInstalled = $deprecationRulesInstalled; } public function getNodeType() : string { return Instanceof_::class; } public function processNode(Node $node, Scope $scope) : array { if (!$this->enabled && !$this->deprecationRulesInstalled) { return []; } if (!$node->class instanceof Node\Name) { return []; } if ($node->getAttribute(TypeTraverserInstanceofVisitor::ATTRIBUTE_NAME, \false) === \true) { return []; } $lowerMap = []; foreach (self::MAP as $className => $method) { $lowerMap[strtolower($className)] = $method; } $className = $scope->resolveName($node->class); $lowerClassName = strtolower($className); if (!array_key_exists($lowerClassName, $lowerMap)) { return []; } if ($this->reflectionProvider->hasClass($className)) { $classReflection = $this->reflectionProvider->getClass($className); if ($classReflection->isSubclassOf(AccessoryType::class)) { if ($className === $classReflection->getName()) { return []; } } } $tip = 'Learn more: <fg=cyan>https://phpstan.org/blog/why-is-instanceof-type-wrong-and-getting-deprecated</>'; if ($lowerMap[$lowerClassName] === null) { return [RuleErrorBuilder::message(sprintf('Doing instanceof %s is error-prone and deprecated.', $className))->identifier('phpstanApi.instanceofType')->tip($tip)->build()]; } return [RuleErrorBuilder::message(sprintf('Doing instanceof %s is error-prone and deprecated. Use %s instead.', $className, $lowerMap[$lowerClassName]))->identifier('phpstanApi.instanceofType')->tip($tip)->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Api; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function sprintf; use function str_contains; /** * @implements Rule<Node\Expr\New_> */ final class ApiInstantiationRule implements Rule { /** * @var ApiRuleHelper */ private $apiRuleHelper; /** * @var ReflectionProvider */ private $reflectionProvider; public function __construct(\PHPStan\Rules\Api\ApiRuleHelper $apiRuleHelper, ReflectionProvider $reflectionProvider) { $this->apiRuleHelper = $apiRuleHelper; $this->reflectionProvider = $reflectionProvider; } public function getNodeType() : string { return Node\Expr\New_::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->class instanceof Node\Name) { return []; } $className = $scope->resolveName($node->class); if (!$this->reflectionProvider->hasClass($className)) { return []; } $classReflection = $this->reflectionProvider->getClass($className); if (!$this->apiRuleHelper->isPhpStanCode($scope, $classReflection->getName(), $classReflection->getFileName())) { return []; } $ruleError = RuleErrorBuilder::message(sprintf('Creating new %s is not covered by backward compatibility promise. The class might change in a minor PHPStan version.', $classReflection->getDisplayName()))->identifier('phpstanApi.constructor')->tip(sprintf("If you think it should be covered by backward compatibility promise, open a discussion:\n %s\n\n See also:\n https://phpstan.org/developing-extensions/backward-compatibility-promise", 'https://github.com/phpstan/phpstan/discussions'))->build(); if (!$classReflection->hasConstructor()) { return [$ruleError]; } $constructor = $classReflection->getConstructor(); $docComment = $constructor->getDocComment(); if ($docComment === null) { return [$ruleError]; } if (!str_contains($docComment, '@api')) { return [$ruleError]; } if ($constructor->getDeclaringClass()->getName() !== $classReflection->getName()) { return [$ruleError]; } return []; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Api; use PhpParser\Node; use PhpParser\Node\Expr\MethodCall; use PhpParser\NodeVisitor\NodeConnectingVisitor; use PHPStan\Analyser\Scope; use PHPStan\DependencyInjection\Container; use PHPStan\Parser\RichParser; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\ObjectType; use function array_keys; use function get_class; use function in_array; use function sprintf; use function str_starts_with; /** * @implements Rule<MethodCall> */ final class NodeConnectingVisitorAttributesRule implements Rule { /** * @var Container */ private $container; public function __construct(Container $container) { $this->container = $container; } public function getNodeType() : string { return MethodCall::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->name instanceof Node\Identifier) { return []; } if ($node->name->toLowerString() !== 'getattribute') { return []; } $calledOnType = $scope->getType($node->var); if (!(new ObjectType(Node::class))->isSuperTypeOf($calledOnType)->yes()) { return []; } $args = $node->getArgs(); if (!isset($args[0])) { return []; } $argType = $scope->getType($args[0]->value); if (!$argType instanceof ConstantStringType) { return []; } if (!in_array($argType->getValue(), ['parent', 'previous', 'next'], \true)) { return []; } if (!$scope->isInClass()) { return []; } $classReflection = $scope->getClassReflection(); $hasPhpStanInterface = \false; foreach (array_keys($classReflection->getInterfaces()) as $interfaceName) { if (!str_starts_with($interfaceName, 'PHPStan\\')) { continue; } $hasPhpStanInterface = \true; } if (!$hasPhpStanInterface) { return []; } $isVisitorRegistered = \false; foreach ($this->container->getServicesByTag(RichParser::VISITOR_SERVICE_TAG) as $service) { if (get_class($service) !== NodeConnectingVisitor::class) { continue; } $isVisitorRegistered = \true; break; } if ($isVisitorRegistered) { return []; } return [RuleErrorBuilder::message(sprintf('Node attribute \'%s\' is no longer available.', $argType->getValue()))->identifier('phpParser.nodeConnectingAttribute')->tip('See: https://phpstan.org/blog/preprocessing-ast-for-custom-rules')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Api; use PHPStan\Analyser\Scope; use PHPStan\Command\Output; use PHPStan\Reflection\Callables\CallableParametersAcceptor; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\ExtendedPropertyReflection; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\ParameterReflectionWithPhpDocs; use PHPStan\Reflection\ParametersAcceptorWithPhpDocs; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\FileRuleError; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\LineRuleError; use PHPStan\Rules\MetadataRuleError; use PHPStan\Rules\NonIgnorableRuleError; use PHPStan\Rules\RuleError; use PHPStan\Rules\TipRuleError; use PHPStan\Type\Type; final class BcUncoveredInterface { public const CLASSES = [Type::class, ReflectionProvider::class, Scope::class, FunctionReflection::class, ExtendedMethodReflection::class, ExtendedPropertyReflection::class, ParametersAcceptorWithPhpDocs::class, ParameterReflectionWithPhpDocs::class, CallableParametersAcceptor::class, FileRuleError::class, IdentifierRuleError::class, LineRuleError::class, MetadataRuleError::class, NonIgnorableRuleError::class, RuleError::class, TipRuleError::class, Output::class]; } <?php declare (strict_types=1); namespace PHPStan\Rules\Api; use PhpParser\Node; use PhpParser\Node\Stmt\Interface_; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function array_merge; use function count; use function in_array; use function sprintf; /** * @implements Rule<Interface_> */ final class ApiInterfaceExtendsRule implements Rule { /** * @var ApiRuleHelper */ private $apiRuleHelper; /** * @var ReflectionProvider */ private $reflectionProvider; public function __construct(\PHPStan\Rules\Api\ApiRuleHelper $apiRuleHelper, ReflectionProvider $reflectionProvider) { $this->apiRuleHelper = $apiRuleHelper; $this->reflectionProvider = $reflectionProvider; } public function getNodeType() : string { return Interface_::class; } public function processNode(Node $node, Scope $scope) : array { $errors = []; foreach ($node->extends as $extends) { $errors = array_merge($errors, $this->checkName($scope, $extends)); } return $errors; } /** * @return list<IdentifierRuleError> */ private function checkName(Scope $scope, Node\Name $name) : array { $extendedInterface = (string) $name; if (!$this->reflectionProvider->hasClass($extendedInterface)) { return []; } $extendedInterfaceReflection = $this->reflectionProvider->getClass($extendedInterface); if (!$this->apiRuleHelper->isPhpStanCode($scope, $extendedInterfaceReflection->getName(), $extendedInterfaceReflection->getFileName())) { return []; } $ruleError = RuleErrorBuilder::message(sprintf('Extending %s is not covered by backward compatibility promise. The interface might change in a minor PHPStan version.', $extendedInterfaceReflection->getDisplayName()))->identifier('phpstanApi.interface')->tip(sprintf("If you think it should be covered by backward compatibility promise, open a discussion:\n %s\n\n See also:\n https://phpstan.org/developing-extensions/backward-compatibility-promise", 'https://github.com/phpstan/phpstan/discussions'))->build(); if (in_array($extendedInterfaceReflection->getName(), \PHPStan\Rules\Api\BcUncoveredInterface::CLASSES, \true)) { return [$ruleError]; } $docBlock = $extendedInterfaceReflection->getResolvedPhpDoc(); if ($docBlock === null) { return [$ruleError]; } foreach ($docBlock->getPhpDocNodes() as $phpDocNode) { $apiTags = $phpDocNode->getTagsByName('@api'); if (count($apiTags) > 0) { return []; } } return [$ruleError]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Api; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\ObjectType; use PHPStan\Type\Type; use PHPStan\Type\UnionType; use function count; use function sprintf; use function strtolower; /** * @implements Rule<Node\Expr\Instanceof_> */ final class ApiInstanceofRule implements Rule { /** * @var ApiRuleHelper */ private $apiRuleHelper; /** * @var ReflectionProvider */ private $reflectionProvider; public function __construct(\PHPStan\Rules\Api\ApiRuleHelper $apiRuleHelper, ReflectionProvider $reflectionProvider) { $this->apiRuleHelper = $apiRuleHelper; $this->reflectionProvider = $reflectionProvider; } public function getNodeType() : string { return Node\Expr\Instanceof_::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->class instanceof Node\Name) { return []; } $className = $scope->resolveName($node->class); if (!$this->reflectionProvider->hasClass($className)) { return []; } $classReflection = $this->reflectionProvider->getClass($className); if (!$this->apiRuleHelper->isPhpStanCode($scope, $classReflection->getName(), $classReflection->getFileName())) { return []; } $ruleError = RuleErrorBuilder::message(sprintf('Asking about instanceof %s is not covered by backward compatibility promise. The %s might change in a minor PHPStan version.', $classReflection->getDisplayName(), strtolower($classReflection->getClassTypeDescription())))->identifier(sprintf('phpstanApi.%s', strtolower($classReflection->getClassTypeDescription())))->tip(sprintf("If you think it should be covered by backward compatibility promise, open a discussion:\n %s\n\n See also:\n https://phpstan.org/developing-extensions/backward-compatibility-promise", 'https://github.com/phpstan/phpstan/discussions'))->build(); $docBlock = $classReflection->getResolvedPhpDoc(); if ($docBlock === null) { return [$ruleError]; } foreach ($docBlock->getPhpDocNodes() as $phpDocNode) { $apiTags = $phpDocNode->getTagsByName('@api'); if (count($apiTags) > 0) { return $this->processCoveredClass($node, $scope, $classReflection); } } return [$ruleError]; } /** * @return list<IdentifierRuleError> */ private function processCoveredClass(Node\Expr\Instanceof_ $node, Scope $scope, ClassReflection $classReflection) : array { if ($classReflection->getName() === Type::class || $classReflection->isSubclassOf(Type::class)) { return []; } if ($classReflection->isInterface()) { return []; } $instanceofType = $scope->getType($node); if ($instanceofType->isTrue()->or($instanceofType->isFalse())->yes()) { return []; } $classType = new ObjectType($classReflection->getName(), null, $classReflection); $exprType = $scope->getType($node->expr); if ($exprType instanceof UnionType) { foreach ($exprType->getTypes() as $innerType) { if ($innerType->getObjectClassNames() !== [] && $classType->isSuperTypeOf($innerType)->yes()) { return []; } } } return [RuleErrorBuilder::message(sprintf('Although %s is covered by backward compatibility promise, this instanceof assumption might break because it\'s not guaranteed to always stay the same.', $classReflection->getDisplayName()))->identifier('phpstanApi.instanceofAssumption')->tip(sprintf("In case of questions how to solve this correctly, open a discussion:\n %s\n\n See also:\n https://phpstan.org/developing-extensions/backward-compatibility-promise", 'https://github.com/phpstan/phpstan/discussions'))->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Api; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use ReflectionClass; use ReflectionClassConstant; use ReflectionExtension; use ReflectionFunction; use ReflectionGenerator; use ReflectionMethod; use ReflectionObject; use ReflectionParameter; use ReflectionProperty; use ReflectionZendExtension; use function array_keys; use function in_array; use function sprintf; use function str_starts_with; /** * @implements Rule<Node\Expr\New_> */ final class RuntimeReflectionInstantiationRule implements Rule { /** * @var ReflectionProvider */ private $reflectionProvider; public function __construct(ReflectionProvider $reflectionProvider) { $this->reflectionProvider = $reflectionProvider; } public function getNodeType() : string { return Node\Expr\New_::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->class instanceof Node\Name) { return []; } $className = $scope->resolveName($node->class); if (!$this->reflectionProvider->hasClass($className)) { return []; } $classReflection = $this->reflectionProvider->getClass($className); if (!in_array($classReflection->getName(), [ReflectionMethod::class, ReflectionClass::class, ReflectionClassConstant::class, 'ReflectionEnum', 'ReflectionEnumBackedCase', ReflectionZendExtension::class, ReflectionExtension::class, ReflectionFunction::class, ReflectionObject::class, ReflectionParameter::class, ReflectionProperty::class, ReflectionGenerator::class, 'ReflectionFiber'], \true)) { return []; } if (!$scope->isInClass()) { return []; } $scopeClassReflection = $scope->getClassReflection(); $hasPhpStanInterface = \false; foreach (array_keys($scopeClassReflection->getInterfaces()) as $interfaceName) { if (!str_starts_with($interfaceName, 'PHPStan\\')) { continue; } $hasPhpStanInterface = \true; } if (!$hasPhpStanInterface) { return []; } return [RuleErrorBuilder::message(sprintf('Creating new %s is a runtime reflection concept that might not work in PHPStan because it uses fully static reflection engine. Use objects retrieved from ReflectionProvider instead.', $classReflection->getName()))->identifier('phpstanApi.runtimeReflection')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Api; use _PHPStan_7d8742a37\Nette\Utils\Json; use _PHPStan_7d8742a37\Nette\Utils\JsonException; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\File\CouldNotReadFileException; use PHPStan\File\FileReader; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function dirname; use function is_dir; use function is_file; use function str_starts_with; /** * @implements Rule<Node\Stmt\Namespace_> */ final class PhpStanNamespaceIn3rdPartyPackageRule implements Rule { /** * @var ApiRuleHelper */ private $apiRuleHelper; public function __construct(\PHPStan\Rules\Api\ApiRuleHelper $apiRuleHelper) { $this->apiRuleHelper = $apiRuleHelper; } public function getNodeType() : string { return Node\Stmt\Namespace_::class; } public function processNode(Node $node, Scope $scope) : array { $namespace = null; if ($node->name !== null) { $namespace = $node->name->toString(); } if ($namespace === null || !$this->apiRuleHelper->isPhpStanName($namespace)) { return []; } $composerJson = $this->findComposerJsonContents(dirname($scope->getFile())); if ($composerJson === null) { return []; } $packageName = $composerJson['name'] ?? null; if ($packageName !== null && str_starts_with($packageName, 'phpstan/')) { return []; } return [RuleErrorBuilder::message('Declaring PHPStan namespace is not allowed in 3rd party packages.')->identifier('phpstanApi.phpstanNamespace')->tip("See:\n https://phpstan.org/developing-extensions/backward-compatibility-promise")->build()]; } /** * @return mixed[]|null */ private function findComposerJsonContents(string $fromDirectory) : ?array { if (!is_dir($fromDirectory)) { return null; } $composerJsonPath = $fromDirectory . '/composer.json'; if (!is_file($composerJsonPath)) { $dirName = dirname($fromDirectory); if ($dirName !== $fromDirectory) { return $this->findComposerJsonContents($dirName); } return null; } try { return Json::decode(FileReader::read($composerJsonPath), Json::FORCE_ARRAY); } catch (JsonException $e) { return null; } catch (CouldNotReadFileException $e) { return null; } } } <?php declare (strict_types=1); namespace PHPStan\Rules\Api; use PhpParser\Node; use PhpParser\Node\Expr\MethodCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\Type; use function count; use function sprintf; /** * @implements Rule<MethodCall> */ final class GetTemplateTypeRule implements Rule { /** * @var ReflectionProvider */ private $reflectionProvider; public function __construct(ReflectionProvider $reflectionProvider) { $this->reflectionProvider = $reflectionProvider; } public function getNodeType() : string { return MethodCall::class; } public function processNode(Node $node, Scope $scope) : array { $args = $node->getArgs(); if (count($args) < 2) { return []; } if (!$node->name instanceof Node\Identifier) { return []; } if ($node->name->toLowerString() !== 'gettemplatetype') { return []; } $calledOnType = $scope->getType($node->var); $methodReflection = $scope->getMethodReflection($calledOnType, $node->name->toString()); if ($methodReflection === null) { return []; } if (!$methodReflection->getDeclaringClass()->is(Type::class)) { return []; } $classType = $scope->getType($args[0]->value); $templateType = $scope->getType($args[1]->value); $errors = []; foreach ($classType->getConstantStrings() as $classNameType) { if (!$this->reflectionProvider->hasClass($classNameType->getValue())) { continue; } $classReflection = $this->reflectionProvider->getClass($classNameType->getValue()); $templateTypeMap = $classReflection->getTemplateTypeMap(); foreach ($templateType->getConstantStrings() as $templateTypeName) { if ($templateTypeMap->hasType($templateTypeName->getValue())) { continue; } $errors[] = RuleErrorBuilder::message(sprintf('Call to %s::%s() references unknown template type %s on class %s.', $methodReflection->getDeclaringClass()->getDisplayName(), $methodReflection->getName(), $templateTypeName->getValue(), $classReflection->getDisplayName()))->identifier('phpstanApi.getTemplateType')->build(); } } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Api; use PhpParser\Node; use PhpParser\Node\Stmt\Class_; use PHPStan\Analyser\MutatingScope; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function count; use function sprintf; /** * @implements Rule<Class_> */ final class ApiClassExtendsRule implements Rule { /** * @var ApiRuleHelper */ private $apiRuleHelper; /** * @var ReflectionProvider */ private $reflectionProvider; public function __construct(\PHPStan\Rules\Api\ApiRuleHelper $apiRuleHelper, ReflectionProvider $reflectionProvider) { $this->apiRuleHelper = $apiRuleHelper; $this->reflectionProvider = $reflectionProvider; } public function getNodeType() : string { return Class_::class; } public function processNode(Node $node, Scope $scope) : array { if ($node->extends === null) { return []; } $extendedClassName = (string) $node->extends; if (!$this->reflectionProvider->hasClass($extendedClassName)) { return []; } $extendedClassReflection = $this->reflectionProvider->getClass($extendedClassName); if (!$this->apiRuleHelper->isPhpStanCode($scope, $extendedClassReflection->getName(), $extendedClassReflection->getFileName())) { return []; } if ($extendedClassReflection->getName() === MutatingScope::class) { return []; } $ruleError = RuleErrorBuilder::message(sprintf('Extending %s is not covered by backward compatibility promise. The class might change in a minor PHPStan version.', $extendedClassReflection->getDisplayName()))->identifier('phpstanApi.class')->tip(sprintf("If you think it should be covered by backward compatibility promise, open a discussion:\n %s\n\n See also:\n https://phpstan.org/developing-extensions/backward-compatibility-promise", 'https://github.com/phpstan/phpstan/discussions'))->build(); $docBlock = $extendedClassReflection->getResolvedPhpDoc(); if ($docBlock === null) { return [$ruleError]; } foreach ($docBlock->getPhpDocNodes() as $phpDocNode) { $apiTags = $phpDocNode->getTagsByName('@api'); if (count($apiTags) > 0) { return []; } } return [$ruleError]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Api; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function sprintf; /** * @implements Rule<Node\Stmt\TraitUse> */ final class ApiTraitUseRule implements Rule { /** * @var ApiRuleHelper */ private $apiRuleHelper; /** * @var ReflectionProvider */ private $reflectionProvider; public function __construct(\PHPStan\Rules\Api\ApiRuleHelper $apiRuleHelper, ReflectionProvider $reflectionProvider) { $this->apiRuleHelper = $apiRuleHelper; $this->reflectionProvider = $reflectionProvider; } public function getNodeType() : string { return Node\Stmt\TraitUse::class; } public function processNode(Node $node, Scope $scope) : array { $errors = []; $tip = sprintf("If you think it should be covered by backward compatibility promise, open a discussion:\n %s\n\n See also:\n https://phpstan.org/developing-extensions/backward-compatibility-promise", 'https://github.com/phpstan/phpstan/discussions'); foreach ($node->traits as $traitName) { $traitName = $traitName->toString(); if (!$this->reflectionProvider->hasClass($traitName)) { continue; } $traitReflection = $this->reflectionProvider->getClass($traitName); if (!$this->apiRuleHelper->isPhpStanCode($scope, $traitReflection->getName(), $traitReflection->getFileName())) { continue; } $errors[] = RuleErrorBuilder::message(sprintf('Using %s is not covered by backward compatibility promise. The trait might change in a minor PHPStan version.', $traitReflection->getDisplayName()))->identifier('phpstanApi.trait')->tip($tip)->build(); } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Api; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Reflection\MethodReflection; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function count; use function sprintf; use function str_contains; /** * @implements Rule<Node\Expr\MethodCall> */ final class ApiMethodCallRule implements Rule { /** * @var ApiRuleHelper */ private $apiRuleHelper; public function __construct(\PHPStan\Rules\Api\ApiRuleHelper $apiRuleHelper) { $this->apiRuleHelper = $apiRuleHelper; } public function getNodeType() : string { return Node\Expr\MethodCall::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->name instanceof Node\Identifier) { return []; } $methodReflection = $scope->getMethodReflection($scope->getType($node->var), $node->name->toString()); if ($methodReflection === null) { return []; } $declaringClass = $methodReflection->getDeclaringClass(); if (!$this->apiRuleHelper->isPhpStanCode($scope, $declaringClass->getName(), $declaringClass->getFileName())) { return []; } if ($this->isCovered($methodReflection)) { return []; } $ruleError = RuleErrorBuilder::message(sprintf('Calling %s::%s() is not covered by backward compatibility promise. The method might change in a minor PHPStan version.', $declaringClass->getDisplayName(), $methodReflection->getName()))->identifier('phpstanApi.method')->tip(sprintf("If you think it should be covered by backward compatibility promise, open a discussion:\n %s\n\n See also:\n https://phpstan.org/developing-extensions/backward-compatibility-promise", 'https://github.com/phpstan/phpstan/discussions'))->build(); return [$ruleError]; } private function isCovered(MethodReflection $methodReflection) : bool { $declaringClass = $methodReflection->getDeclaringClass(); $classDocBlock = $declaringClass->getResolvedPhpDoc(); if ($classDocBlock !== null) { foreach ($classDocBlock->getPhpDocNodes() as $phpDocNode) { $apiTags = $phpDocNode->getTagsByName('@api'); if (count($apiTags) > 0) { return \true; } } } $methodDocComment = $methodReflection->getDocComment(); if ($methodDocComment === null) { return \false; } return str_contains($methodDocComment, '@api'); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Api; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function array_keys; use function in_array; use function sprintf; use function str_starts_with; /** * @implements Rule<Node\Expr\FuncCall> */ final class RuntimeReflectionFunctionRule implements Rule { /** * @var ReflectionProvider */ private $reflectionProvider; public function __construct(ReflectionProvider $reflectionProvider) { $this->reflectionProvider = $reflectionProvider; } public function getNodeType() : string { return Node\Expr\FuncCall::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->name instanceof Node\Name) { return []; } if (!$this->reflectionProvider->hasFunction($node->name, $scope)) { return []; } $functionReflection = $this->reflectionProvider->getFunction($node->name, $scope); if (!in_array($functionReflection->getName(), ['is_a', 'is_subclass_of', 'class_parents', 'class_implements', 'class_uses'], \true)) { return []; } if (!$scope->isInClass()) { return []; } $classReflection = $scope->getClassReflection(); $hasPhpStanInterface = \false; foreach (array_keys($classReflection->getInterfaces()) as $interfaceName) { if (!str_starts_with($interfaceName, 'PHPStan\\')) { continue; } $hasPhpStanInterface = \true; } if (!$hasPhpStanInterface) { return []; } return [RuleErrorBuilder::message(sprintf('Function %s() is a runtime reflection concept that might not work in PHPStan because it uses fully static reflection engine. Use objects retrieved from ReflectionProvider instead.', $functionReflection->getName()))->identifier('phpstanApi.runtimeReflection')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Debug; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\PhpDocParser\Printer\Printer; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function count; use function sprintf; use function strtolower; /** * @implements Rule<Node\Expr\FuncCall> */ final class DumpPhpDocTypeRule implements Rule { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var Printer */ private $printer; public function __construct(ReflectionProvider $reflectionProvider, Printer $printer) { $this->reflectionProvider = $reflectionProvider; $this->printer = $printer; } public function getNodeType() : string { return Node\Expr\FuncCall::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->name instanceof Node\Name) { return []; } $functionName = $this->reflectionProvider->resolveFunctionName($node->name, $scope); if ($functionName === null) { return []; } if (strtolower($functionName) !== 'phpstan\\dumpphpdoctype') { return []; } if (count($node->getArgs()) === 0) { return []; } return [RuleErrorBuilder::message(sprintf('Dumped type: %s', $this->printer->print($scope->getType($node->getArgs()[0]->value)->toPhpDocNode())))->nonIgnorable()->identifier('phpstan.dumpPhpDocType')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Debug; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\VerbosityLevel; use function count; use function sprintf; use function strtolower; /** * @implements Rule<Node\Expr\FuncCall> */ final class DumpTypeRule implements Rule { /** * @var ReflectionProvider */ private $reflectionProvider; public function __construct(ReflectionProvider $reflectionProvider) { $this->reflectionProvider = $reflectionProvider; } public function getNodeType() : string { return Node\Expr\FuncCall::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->name instanceof Node\Name) { return []; } $functionName = $this->reflectionProvider->resolveFunctionName($node->name, $scope); if ($functionName === null) { return []; } if (strtolower($functionName) !== 'phpstan\\dumptype') { return []; } if (count($node->getArgs()) === 0) { return []; } return [RuleErrorBuilder::message(sprintf('Dumped type: %s', $scope->getType($node->getArgs()[0]->value)->describe(VerbosityLevel::precise())))->nonIgnorable()->identifier('phpstan.dumpType')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Debug; use PhpParser\Node; use PHPStan\Analyser\MutatingScope; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function count; use function implode; use function sprintf; use function strtolower; /** * @implements Rule<Node\Expr\FuncCall> */ final class DebugScopeRule implements Rule { /** * @var ReflectionProvider */ private $reflectionProvider; public function __construct(ReflectionProvider $reflectionProvider) { $this->reflectionProvider = $reflectionProvider; } public function getNodeType() : string { return Node\Expr\FuncCall::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->name instanceof Node\Name) { return []; } $functionName = $this->reflectionProvider->resolveFunctionName($node->name, $scope); if ($functionName === null) { return []; } if (strtolower($functionName) !== 'phpstan\\debugscope') { return []; } if (!$scope instanceof MutatingScope) { return []; } $parts = []; foreach ($scope->debug() as $key => $row) { $parts[] = sprintf('%s: %s', $key, $row); } if (count($parts) === 0) { $parts[] = 'Scope is empty'; } return [RuleErrorBuilder::message(implode("\n", $parts))->nonIgnorable()->identifier('phpstan.debugScope')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Debug; use PhpParser\Node; use PhpParser\Node\Expr\StaticCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\TrinaryLogic; use PHPStan\Type\VerbosityLevel; use function count; use function is_string; use function sprintf; /** * @implements Rule<Node\Expr\FuncCall> */ final class FileAssertRule implements Rule { /** * @var ReflectionProvider */ private $reflectionProvider; public function __construct(ReflectionProvider $reflectionProvider) { $this->reflectionProvider = $reflectionProvider; } public function getNodeType() : string { return Node\Expr\FuncCall::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->name instanceof Node\Name) { return []; } if (!$this->reflectionProvider->hasFunction($node->name, $scope)) { return []; } $function = $this->reflectionProvider->getFunction($node->name, $scope); if ($function->getName() === 'PHPStan\\Testing\\assertType') { return $this->processAssertType($node->getArgs(), $scope); } if ($function->getName() === 'PHPStan\\Testing\\assertNativeType') { return $this->processAssertNativeType($node->getArgs(), $scope); } if ($function->getName() === 'PHPStan\\Testing\\assertVariableCertainty') { return $this->processAssertVariableCertainty($node->getArgs(), $scope); } return []; } /** * @param Node\Arg[] $args * @return list<IdentifierRuleError> */ private function processAssertType(array $args, Scope $scope) : array { if (count($args) !== 2) { return []; } $expectedTypeStrings = $scope->getType($args[0]->value)->getConstantStrings(); if (count($expectedTypeStrings) !== 1) { return [RuleErrorBuilder::message('Expected type must be a literal string.')->nonIgnorable()->identifier('phpstan.unknownExpectation')->build()]; } $expressionType = $scope->getType($args[1]->value)->describe(VerbosityLevel::precise()); if ($expectedTypeStrings[0]->getValue() === $expressionType) { return []; } return [RuleErrorBuilder::message(sprintf('Expected type %s, actual: %s', $expectedTypeStrings[0]->getValue(), $expressionType))->nonIgnorable()->identifier('phpstan.type')->build()]; } /** * @param Node\Arg[] $args * @return list<IdentifierRuleError> */ private function processAssertNativeType(array $args, Scope $scope) : array { if (count($args) !== 2) { return []; } $expectedTypeStrings = $scope->getNativeType($args[0]->value)->getConstantStrings(); if (count($expectedTypeStrings) !== 1) { return [RuleErrorBuilder::message('Expected native type must be a literal string.')->nonIgnorable()->identifier('phpstan.unknownExpectation')->build()]; } $expressionType = $scope->getNativeType($args[1]->value)->describe(VerbosityLevel::precise()); if ($expectedTypeStrings[0]->getValue() === $expressionType) { return []; } return [RuleErrorBuilder::message(sprintf('Expected native type %s, actual: %s', $expectedTypeStrings[0]->getValue(), $expressionType))->nonIgnorable()->identifier('phpstan.nativeType')->build()]; } /** * @param Node\Arg[] $args * @return list<IdentifierRuleError> */ private function processAssertVariableCertainty(array $args, Scope $scope) : array { if (count($args) !== 2) { return []; } $certainty = $args[0]->value; if (!$certainty instanceof StaticCall) { return [RuleErrorBuilder::message('First argument of %s() must be TrinaryLogic call')->nonIgnorable()->identifier('phpstan.unknownExpectation')->build()]; } if (!$certainty->class instanceof Node\Name) { return [RuleErrorBuilder::message('Invalid TrinaryLogic call.')->nonIgnorable()->identifier('phpstan.unknownExpectation')->build()]; } if ($certainty->class->toString() !== 'PHPStan\\TrinaryLogic') { return [RuleErrorBuilder::message('Invalid TrinaryLogic call.')->nonIgnorable()->identifier('phpstan.unknownExpectation')->build()]; } if (!$certainty->name instanceof Node\Identifier) { return [RuleErrorBuilder::message('Invalid TrinaryLogic call.')->nonIgnorable()->identifier('phpstan.unknownExpectation')->build()]; } // @phpstan-ignore staticMethod.dynamicName $expectedCertaintyValue = TrinaryLogic::{$certainty->name->toString()}(); $variable = $args[1]->value; if ($variable instanceof Node\Expr\Variable && is_string($variable->name)) { $actualCertaintyValue = $scope->hasVariableType($variable->name); $variableDescription = sprintf('variable $%s', $variable->name); } elseif ($variable instanceof Node\Expr\ArrayDimFetch && $variable->dim !== null) { $offset = $scope->getType($variable->dim); $actualCertaintyValue = $scope->getType($variable->var)->hasOffsetValueType($offset); $variableDescription = sprintf('offset %s', $offset->describe(VerbosityLevel::precise())); } else { return [RuleErrorBuilder::message('Invalid assertVariableCertainty call.')->nonIgnorable()->identifier('phpstan.unknownExpectation')->build()]; } if ($expectedCertaintyValue->equals($actualCertaintyValue)) { return []; } return [RuleErrorBuilder::message(sprintf('Expected %s certainty %s, actual: %s', $variableDescription, $expectedCertaintyValue->describe(), $actualCertaintyValue->describe()))->nonIgnorable()->identifier('phpstan.variable')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules; use PhpParser\Node; use PHPStan\Analyser\Scope; /** * This is the interface custom rules implement. To register it in the configuration file * use the `phpstan.rules.rule` service tag: * * ``` * services: * - * class: App\MyRule * tags: * - phpstan.rules.rule * ``` * * Learn more: https://phpstan.org/developing-extensions/rules * * @api * @template TNodeType of Node */ interface Rule { /** * @return class-string<TNodeType> */ public function getNodeType() : string; /** * @param TNodeType $node * @return (string|RuleError)[] errors */ public function processNode(Node $node, Scope $scope) : array; } <?php declare (strict_types=1); namespace PHPStan\Rules; use Closure; use Generator; use Iterator; use IteratorAggregate; use PHPStan\ShouldNotHappenException; use PHPStan\Type\Accessory\AccessoryType; use PHPStan\Type\CallableType; use PHPStan\Type\ClosureType; use PHPStan\Type\ConditionalType; use PHPStan\Type\ConditionalTypeForParameter; use PHPStan\Type\Generic\GenericObjectType; use PHPStan\Type\Generic\GenericStaticType; use PHPStan\Type\Generic\TemplateType; use PHPStan\Type\Generic\TemplateTypeHelper; use PHPStan\Type\IntersectionType; use PHPStan\Type\MixedType; use PHPStan\Type\ObjectType; use PHPStan\Type\Type; use PHPStan\Type\TypeTraverser; use Traversable; use function array_filter; use function array_keys; use function array_merge; use function count; use function implode; use function in_array; use function sprintf; use function strtolower; final class MissingTypehintCheck { /** * @var bool */ private $disableCheckMissingIterableValueType; /** * @var bool */ private $checkMissingIterableValueType; /** * @var bool */ private $checkGenericClassInNonGenericObjectType; /** * @var bool */ private $checkMissingCallableSignature; /** * @var string[] */ private $skipCheckGenericClasses; public const MISSING_ITERABLE_VALUE_TYPE_TIP = 'See: https://phpstan.org/blog/solving-phpstan-no-value-type-specified-in-iterable-type'; private const ITERABLE_GENERIC_CLASS_NAMES = [Traversable::class, Iterator::class, IteratorAggregate::class, Generator::class]; /** * @param string[] $skipCheckGenericClasses */ public function __construct(bool $disableCheckMissingIterableValueType, bool $checkMissingIterableValueType, bool $checkGenericClassInNonGenericObjectType, bool $checkMissingCallableSignature, array $skipCheckGenericClasses) { $this->disableCheckMissingIterableValueType = $disableCheckMissingIterableValueType; $this->checkMissingIterableValueType = $checkMissingIterableValueType; $this->checkGenericClassInNonGenericObjectType = $checkGenericClassInNonGenericObjectType; $this->checkMissingCallableSignature = $checkMissingCallableSignature; $this->skipCheckGenericClasses = $skipCheckGenericClasses; } /** * @return Type[] */ public function getIterableTypesWithMissingValueTypehint(Type $type) : array { if (!$this->checkMissingIterableValueType) { if (!$this->disableCheckMissingIterableValueType) { return []; } } $iterablesWithMissingValueTypehint = []; TypeTraverser::map($type, function (Type $type, callable $traverse) use(&$iterablesWithMissingValueTypehint) : Type { if ($type instanceof TemplateType) { return $type; } if ($type instanceof AccessoryType) { return $type; } if ($type instanceof ConditionalType || $type instanceof ConditionalTypeForParameter) { $iterablesWithMissingValueTypehint = array_merge($iterablesWithMissingValueTypehint, $this->getIterableTypesWithMissingValueTypehint($type->getIf()), $this->getIterableTypesWithMissingValueTypehint($type->getElse())); return $type; } if ($type->isIterable()->yes()) { $iterableValue = $type->getIterableValueType(); if ($iterableValue instanceof MixedType && !$iterableValue->isExplicitMixed()) { $iterablesWithMissingValueTypehint[] = $type; } if ($type instanceof IntersectionType) { if ($type->isList()->yes()) { return $traverse($iterableValue); } return $type; } } return $traverse($type); }); return $iterablesWithMissingValueTypehint; } /** * @return array<int, array{string, string}> */ public function getNonGenericObjectTypesWithGenericClass(Type $type) : array { if (!$this->checkGenericClassInNonGenericObjectType) { return []; } $objectTypes = []; TypeTraverser::map($type, function (Type $type, callable $traverse) use(&$objectTypes) : Type { if ($type instanceof GenericObjectType || $type instanceof GenericStaticType) { $traverse($type); return $type; } if ($type instanceof TemplateType) { return $type; } if ($type instanceof ObjectType) { $classReflection = $type->getClassReflection(); if ($classReflection === null) { return $type; } if (in_array($classReflection->getName(), self::ITERABLE_GENERIC_CLASS_NAMES, \true)) { // checked by getIterableTypesWithMissingValueTypehint() already return $type; } if (in_array($classReflection->getName(), $this->skipCheckGenericClasses, \true)) { return $type; } if ($classReflection->isTrait()) { return $type; } if (!$classReflection->isGeneric()) { return $type; } $resolvedType = TemplateTypeHelper::resolveToBounds($type); if (!$resolvedType instanceof ObjectType) { throw new ShouldNotHappenException(); } $templateTypes = $classReflection->getTemplateTypeMap()->getTypes(); $templateTypesCount = count($templateTypes); $requiredTemplateTypesCount = count(array_filter($templateTypes, static function (Type $type) { return $type instanceof TemplateType && $type->getDefault() === null; })); if ($requiredTemplateTypesCount === 0) { return $type; } $templateTypesList = implode(', ', array_keys($templateTypes)); if ($requiredTemplateTypesCount !== $templateTypesCount) { $templateTypesList .= sprintf(' (%d-%d required)', $requiredTemplateTypesCount, $templateTypesCount); } $objectTypes[] = [sprintf('%s %s', strtolower($classReflection->getClassTypeDescription()), $classReflection->getDisplayName(\false)), $templateTypesList]; return $type; } return $traverse($type); }); return $objectTypes; } /** * @return Type[] */ public function getCallablesWithMissingSignature(Type $type) : array { if (!$this->checkMissingCallableSignature) { return []; } $result = []; TypeTraverser::map($type, static function (Type $type, callable $traverse) use(&$result) : Type { if ($type instanceof CallableType && $type->isCommonCallable() || $type instanceof ClosureType && $type->isCommonCallable() || $type instanceof ObjectType && $type->getClassName() === Closure::class) { $result[] = $type; } return $traverse($type); }); return $result; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Playground; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\MethodReturnStatementsNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function count; use function sprintf; /** * @implements Rule<MethodReturnStatementsNode> */ final class MethodNeverRule implements Rule { /** * @var NeverRuleHelper */ private $helper; public function __construct(\PHPStan\Rules\Playground\NeverRuleHelper $helper) { $this->helper = $helper; } public function getNodeType() : string { return MethodReturnStatementsNode::class; } public function processNode(Node $node, Scope $scope) : array { if (count($node->getReturnStatements()) > 0) { return []; } $method = $node->getMethodReflection(); $returnType = $method->getReturnType(); $helperResult = $this->helper->shouldReturnNever($node, $returnType); if ($helperResult === \false) { return []; } return [RuleErrorBuilder::message(sprintf('Method %s::%s() always %s, it should have return type "never".', $method->getDeclaringClass()->getDisplayName(), $method->getName(), count($helperResult) === 0 ? 'throws an exception' : 'terminates script execution'))->identifier('phpstanPlayground.never')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Playground; use PhpParser\Node; use PHPStan\Node\ReturnStatementsNode; use PHPStan\Type\NeverType; use PHPStan\Type\Type; final class NeverRuleHelper { /** * @return list<Node>|false */ public function shouldReturnNever(ReturnStatementsNode $node, Type $returnType) { if ($returnType instanceof NeverType && $returnType->isExplicit()) { return \false; } if ($node->isGenerator()) { return \false; } $other = []; foreach ($node->getExecutionEnds() as $executionEnd) { if ($executionEnd->getStatementResult()->isAlwaysTerminating()) { if (!$executionEnd->getNode() instanceof Node\Stmt\Throw_) { $other[] = $executionEnd->getNode(); } continue; } return \false; } return $other; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Playground; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\CollectedDataNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Rules\Traits\TraitDeclarationCollector; use PHPStan\Rules\Traits\TraitUseCollector; use function sprintf; use function strtolower; /** * @implements Rule<CollectedDataNode> */ final class NotAnalysedTraitRule implements Rule { public function getNodeType() : string { return CollectedDataNode::class; } public function processNode(Node $node, Scope $scope) : array { $traitDeclarationData = $node->get(TraitDeclarationCollector::class); $traitUseData = $node->get(TraitUseCollector::class); $declaredTraits = []; foreach ($traitDeclarationData as $file => $declaration) { foreach ($declaration as [$name, $line]) { $declaredTraits[strtolower($name)] = [$file, $name, $line]; } } foreach ($traitUseData as $usedNamesData) { foreach ($usedNamesData as $usedNames) { foreach ($usedNames as $usedName) { unset($declaredTraits[strtolower($usedName)]); } } } $errors = []; foreach ($declaredTraits as [$file, $name, $line]) { $errors[] = RuleErrorBuilder::message(sprintf('Trait %s is used zero times and is not analysed.', $name))->identifier('phpstanPlayground.traitUnused')->file($file)->line($line)->tip('See: https://phpstan.org/blog/how-phpstan-analyses-traits')->build(); } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Playground; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\FileNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function count; /** * @implements Rule<FileNode> */ final class NoPhpCodeRule implements Rule { public function getNodeType() : string { return FileNode::class; } public function processNode(Node $node, Scope $scope) : array { if (count($node->getNodes()) !== 1) { return []; } $html = $node->getNodes()[0]; if (!$html instanceof Node\Stmt\InlineHTML) { return []; } return [RuleErrorBuilder::message('The example does not contain any PHP code. Did you forget the opening <?php tag?')->identifier('phpstanPlayground.noPhp')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Playground; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\FunctionReturnStatementsNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function count; use function sprintf; /** * @implements Rule<FunctionReturnStatementsNode> */ final class FunctionNeverRule implements Rule { /** * @var NeverRuleHelper */ private $helper; public function __construct(\PHPStan\Rules\Playground\NeverRuleHelper $helper) { $this->helper = $helper; } public function getNodeType() : string { return FunctionReturnStatementsNode::class; } public function processNode(Node $node, Scope $scope) : array { if (count($node->getReturnStatements()) > 0) { return []; } $function = $node->getFunctionReflection(); $returnType = $function->getReturnType(); $helperResult = $this->helper->shouldReturnNever($node, $returnType); if ($helperResult === \false) { return []; } return [RuleErrorBuilder::message(sprintf('Function %s() always %s, it should have return type "never".', $function->getName(), count($helperResult) === 0 ? 'throws an exception' : 'terminates script execution'))->identifier('phpstanPlayground.never')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules; use PhpParser\Node; final class ClassNameNodePair { /** * @var string */ private $className; /** * @var Node */ private $node; public function __construct(string $className, Node $node) { $this->className = $className; $this->node = $node; } public function getClassName() : string { return $this->className; } public function getNode() : Node { return $this->node; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Generators; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\TrinaryLogic; use PHPStan\Type\MixedType; use PHPStan\Type\NeverType; use function sprintf; /** * @implements Rule<Node\Expr> */ final class YieldInGeneratorRule implements Rule { /** * @var bool */ private $reportMaybes; public function __construct(bool $reportMaybes) { $this->reportMaybes = $reportMaybes; } public function getNodeType() : string { return Node\Expr::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node instanceof Node\Expr\Yield_ && !$node instanceof Node\Expr\YieldFrom) { return []; } $anonymousFunctionReturnType = $scope->getAnonymousFunctionReturnType(); $scopeFunction = $scope->getFunction(); if ($anonymousFunctionReturnType !== null) { $returnType = $anonymousFunctionReturnType; } elseif ($scopeFunction !== null) { $returnType = $scopeFunction->getReturnType(); } else { return [RuleErrorBuilder::message('Yield can be used only inside a function.')->identifier('generator.outOfFunction')->nonIgnorable()->build()]; } if ($returnType instanceof MixedType) { return []; } if ($returnType instanceof NeverType && $returnType->isExplicit()) { $isSuperType = TrinaryLogic::createNo(); } else { $isSuperType = $returnType->isIterable()->and(TrinaryLogic::createFromBoolean(!$returnType->isArray()->yes())); } if ($isSuperType->yes()) { return []; } if ($isSuperType->maybe() && !$this->reportMaybes) { return []; } return [RuleErrorBuilder::message(sprintf('Yield can be used only with these return types: %s.', 'Generator, Iterator, Traversable, iterable'))->identifier('generator.returnType')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Generators; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Rules\RuleLevelHelper; use PHPStan\Type\IntegerType; use PHPStan\Type\MixedType; use PHPStan\Type\NullType; use PHPStan\Type\VerbosityLevel; use function sprintf; /** * @implements Rule<Node\Expr\Yield_> */ final class YieldTypeRule implements Rule { /** * @var RuleLevelHelper */ private $ruleLevelHelper; public function __construct(RuleLevelHelper $ruleLevelHelper) { $this->ruleLevelHelper = $ruleLevelHelper; } public function getNodeType() : string { return Node\Expr\Yield_::class; } public function processNode(Node $node, Scope $scope) : array { $anonymousFunctionReturnType = $scope->getAnonymousFunctionReturnType(); $scopeFunction = $scope->getFunction(); if ($anonymousFunctionReturnType !== null) { $returnType = $anonymousFunctionReturnType; } elseif ($scopeFunction !== null) { $returnType = $scopeFunction->getReturnType(); } else { return []; // already reported by YieldInGeneratorRule } if ($returnType instanceof MixedType) { return []; } if ($node->key === null) { $keyType = new IntegerType(); } else { $keyType = $scope->getType($node->key); } $messages = []; $acceptsKey = $this->ruleLevelHelper->acceptsWithReason($returnType->getIterableKeyType(), $keyType, $scope->isDeclareStrictTypes()); if (!$acceptsKey->result) { $verbosityLevel = VerbosityLevel::getRecommendedLevelByType($returnType->getIterableKeyType(), $keyType); $messages[] = RuleErrorBuilder::message(sprintf('Generator expects key type %s, %s given.', $returnType->getIterableKeyType()->describe($verbosityLevel), $keyType->describe($verbosityLevel)))->acceptsReasonsTip($acceptsKey->reasons)->identifier('generator.keyType')->build(); } if ($node->value === null) { $valueType = new NullType(); } else { $valueType = $scope->getType($node->value); } $acceptsValue = $this->ruleLevelHelper->acceptsWithReason($returnType->getIterableValueType(), $valueType, $scope->isDeclareStrictTypes()); if (!$acceptsValue->result) { $verbosityLevel = VerbosityLevel::getRecommendedLevelByType($returnType->getIterableValueType(), $valueType); $messages[] = RuleErrorBuilder::message(sprintf('Generator expects value type %s, %s given.', $returnType->getIterableValueType()->describe($verbosityLevel), $valueType->describe($verbosityLevel)))->acceptsReasonsTip($acceptsValue->reasons)->identifier('generator.valueType')->build(); } if (!$scope->isInFirstLevelStatement() && $scope->getType($node)->isVoid()->yes()) { $messages[] = RuleErrorBuilder::message('Result of yield (void) is used.')->identifier('generator.void')->build(); } return $messages; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Generators; use Generator; use PhpParser\Node; use PhpParser\Node\Expr\YieldFrom; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Rules\RuleLevelHelper; use PHPStan\Type\ErrorType; use PHPStan\Type\MixedType; use PHPStan\Type\VerbosityLevel; use function sprintf; /** * @implements Rule<Node\Expr\YieldFrom> */ final class YieldFromTypeRule implements Rule { /** * @var RuleLevelHelper */ private $ruleLevelHelper; /** * @var bool */ private $reportMaybes; public function __construct(RuleLevelHelper $ruleLevelHelper, bool $reportMaybes) { $this->ruleLevelHelper = $ruleLevelHelper; $this->reportMaybes = $reportMaybes; } public function getNodeType() : string { return YieldFrom::class; } public function processNode(Node $node, Scope $scope) : array { $exprType = $scope->getType($node->expr); $isIterable = $exprType->isIterable(); $messagePattern = 'Argument of an invalid type %s passed to yield from, only iterables are supported.'; if ($isIterable->no()) { return [RuleErrorBuilder::message(sprintf($messagePattern, $exprType->describe(VerbosityLevel::typeOnly())))->line($node->expr->getStartLine())->identifier('generator.nonIterable')->build()]; } elseif (!$exprType instanceof MixedType && $this->reportMaybes && $isIterable->maybe()) { return [RuleErrorBuilder::message(sprintf($messagePattern, $exprType->describe(VerbosityLevel::typeOnly())))->line($node->expr->getStartLine())->identifier('generator.nonIterable')->build()]; } $anonymousFunctionReturnType = $scope->getAnonymousFunctionReturnType(); $scopeFunction = $scope->getFunction(); if ($anonymousFunctionReturnType !== null) { $returnType = $anonymousFunctionReturnType; } elseif ($scopeFunction !== null) { $returnType = $scopeFunction->getReturnType(); } else { return []; // already reported by YieldInGeneratorRule } if ($returnType instanceof MixedType) { return []; } $messages = []; $acceptsKey = $this->ruleLevelHelper->acceptsWithReason($returnType->getIterableKeyType(), $exprType->getIterableKeyType(), $scope->isDeclareStrictTypes()); if (!$acceptsKey->result) { $verbosityLevel = VerbosityLevel::getRecommendedLevelByType($returnType->getIterableKeyType(), $exprType->getIterableKeyType()); $messages[] = RuleErrorBuilder::message(sprintf('Generator expects key type %s, %s given.', $returnType->getIterableKeyType()->describe($verbosityLevel), $exprType->getIterableKeyType()->describe($verbosityLevel)))->line($node->expr->getStartLine())->identifier('generator.keyType')->acceptsReasonsTip($acceptsKey->reasons)->build(); } $acceptsValue = $this->ruleLevelHelper->acceptsWithReason($returnType->getIterableValueType(), $exprType->getIterableValueType(), $scope->isDeclareStrictTypes()); if (!$acceptsValue->result) { $verbosityLevel = VerbosityLevel::getRecommendedLevelByType($returnType->getIterableValueType(), $exprType->getIterableValueType()); $messages[] = RuleErrorBuilder::message(sprintf('Generator expects value type %s, %s given.', $returnType->getIterableValueType()->describe($verbosityLevel), $exprType->getIterableValueType()->describe($verbosityLevel)))->line($node->expr->getStartLine())->identifier('generator.valueType')->acceptsReasonsTip($acceptsValue->reasons)->build(); } $scopeFunction = $scope->getFunction(); if ($scopeFunction === null) { return $messages; } $currentReturnType = $scopeFunction->getReturnType(); $exprSendType = $exprType->getTemplateType(Generator::class, 'TSend'); $thisSendType = $currentReturnType->getTemplateType(Generator::class, 'TSend'); if ($exprSendType instanceof ErrorType || $thisSendType instanceof ErrorType) { return $messages; } $isSuperType = $exprSendType->isSuperTypeOf($thisSendType); if ($isSuperType->no()) { $messages[] = RuleErrorBuilder::message(sprintf('Generator expects delegated TSend type %s, %s given.', $exprSendType->describe(VerbosityLevel::typeOnly()), $thisSendType->describe(VerbosityLevel::typeOnly())))->identifier('generator.sendType')->build(); } elseif ($this->reportMaybes && !$isSuperType->yes()) { $messages[] = RuleErrorBuilder::message(sprintf('Generator expects delegated TSend type %s, %s given.', $exprSendType->describe(VerbosityLevel::typeOnly()), $thisSendType->describe(VerbosityLevel::typeOnly())))->identifier('generator.sendType')->build(); } if (!$scope->isInFirstLevelStatement() && $scope->getType($node)->isVoid()->yes()) { $messages[] = RuleErrorBuilder::message('Result of yield from (void) is used.')->identifier('generator.void')->build(); } return $messages; } } <?php declare (strict_types=1); namespace PHPStan\Rules; use DateTime; use PhpParser\Node; use PhpParser\Node\Expr\New_; use PHPStan\Analyser\Scope; use Throwable; use function count; use function in_array; use function sprintf; use function strtolower; /** * @implements Rule<Node\Expr\New_> */ final class DateTimeInstantiationRule implements \PHPStan\Rules\Rule { public function getNodeType() : string { return New_::class; } /** * @param New_ $node */ public function processNode(Node $node, Scope $scope) : array { if (!$node->class instanceof Node\Name) { return []; } $lowerClassName = strtolower((string) $node->class); if (count($node->getArgs()) === 0 || !in_array($lowerClassName, ['datetime', 'datetimeimmutable'], \true)) { return []; } $arg = $scope->getType($node->getArgs()[0]->value); $errors = []; foreach ($arg->getConstantStrings() as $constantString) { $dateString = $constantString->getValue(); try { new DateTime($dateString); } catch (Throwable $e) { // an exception is thrown for errors only but we want to catch warnings too } $lastErrors = DateTime::getLastErrors(); if ($lastErrors === \false) { continue; } foreach ($lastErrors['errors'] as $error) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf('Instantiating %s with %s produces an error: %s', $lowerClassName === 'datetime' ? 'DateTime' : 'DateTimeImmutable', $dateString, $error))->identifier(sprintf('new.%s', $lowerClassName === 'datetime' ? 'dateTime' : 'dateTimeImmutable'))->build(); } } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules; final class ClassNameCheck { /** * @var ClassCaseSensitivityCheck */ private $classCaseSensitivityCheck; /** * @var ClassForbiddenNameCheck */ private $classForbiddenNameCheck; public function __construct(\PHPStan\Rules\ClassCaseSensitivityCheck $classCaseSensitivityCheck, \PHPStan\Rules\ClassForbiddenNameCheck $classForbiddenNameCheck) { $this->classCaseSensitivityCheck = $classCaseSensitivityCheck; $this->classForbiddenNameCheck = $classForbiddenNameCheck; } /** * @param ClassNameNodePair[] $pairs * @return list<IdentifierRuleError> */ public function checkClassNames(array $pairs, bool $checkClassCaseSensitivity = \true) : array { $errors = []; if ($checkClassCaseSensitivity) { foreach ($this->classCaseSensitivityCheck->checkClassNames($pairs) as $error) { $errors[] = $error; } } foreach ($this->classForbiddenNameCheck->checkClassNames($pairs) as $error) { $errors[] = $error; } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Namespaces; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\ClassNameCheck; use PHPStan\Rules\ClassNameNodePair; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\ShouldNotHappenException; use function array_map; use function sprintf; use function strtolower; /** * @implements Rule<Node\Stmt\Use_> */ final class ExistingNamesInUseRule implements Rule { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var ClassNameCheck */ private $classCheck; /** * @var bool */ private $checkFunctionNameCase; public function __construct(ReflectionProvider $reflectionProvider, ClassNameCheck $classCheck, bool $checkFunctionNameCase) { $this->reflectionProvider = $reflectionProvider; $this->classCheck = $classCheck; $this->checkFunctionNameCase = $checkFunctionNameCase; } public function getNodeType() : string { return Node\Stmt\Use_::class; } public function processNode(Node $node, Scope $scope) : array { if ($node->type === Node\Stmt\Use_::TYPE_UNKNOWN) { throw new ShouldNotHappenException(); } foreach ($node->uses as $use) { if ($use->type !== Node\Stmt\Use_::TYPE_UNKNOWN) { throw new ShouldNotHappenException(); } } if ($node->type === Node\Stmt\Use_::TYPE_CONSTANT) { return $this->checkConstants($node->uses); } if ($node->type === Node\Stmt\Use_::TYPE_FUNCTION) { return $this->checkFunctions($node->uses); } return $this->checkClasses($node->uses); } /** * @param Node\Stmt\UseUse[] $uses * @return list<IdentifierRuleError> */ private function checkConstants(array $uses) : array { $errors = []; foreach ($uses as $use) { if ($this->reflectionProvider->hasConstant($use->name, null)) { continue; } $errors[] = RuleErrorBuilder::message(sprintf('Used constant %s not found.', (string) $use->name))->line($use->name->getStartLine())->identifier('constant.notFound')->discoveringSymbolsTip()->build(); } return $errors; } /** * @param Node\Stmt\UseUse[] $uses * @return list<IdentifierRuleError> */ private function checkFunctions(array $uses) : array { $errors = []; foreach ($uses as $use) { if (!$this->reflectionProvider->hasFunction($use->name, null)) { $errors[] = RuleErrorBuilder::message(sprintf('Used function %s not found.', (string) $use->name))->line($use->name->getStartLine())->identifier('function.notFound')->discoveringSymbolsTip()->build(); } elseif ($this->checkFunctionNameCase) { $functionReflection = $this->reflectionProvider->getFunction($use->name, null); $realName = $functionReflection->getName(); $usedName = (string) $use->name; if (strtolower($realName) === strtolower($usedName) && $realName !== $usedName) { $errors[] = RuleErrorBuilder::message(sprintf('Function %s used with incorrect case: %s.', $realName, $usedName))->line($use->name->getStartLine())->identifier('function.nameCase')->build(); } } } return $errors; } /** * @param Node\Stmt\UseUse[] $uses * @return list<IdentifierRuleError> */ private function checkClasses(array $uses) : array { return $this->classCheck->checkClassNames(array_map(static function (Node\Stmt\UseUse $use) : ClassNameNodePair { return new ClassNameNodePair((string) $use->name, $use->name); }, $uses)); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Namespaces; use PhpParser\Node; use PhpParser\Node\Stmt\Use_; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\ClassNameCheck; use PHPStan\Rules\ClassNameNodePair; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\ShouldNotHappenException; use function count; use function sprintf; use function strtolower; /** * @implements Rule<Node\Stmt\GroupUse> */ final class ExistingNamesInGroupUseRule implements Rule { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var ClassNameCheck */ private $classCheck; /** * @var bool */ private $checkFunctionNameCase; public function __construct(ReflectionProvider $reflectionProvider, ClassNameCheck $classCheck, bool $checkFunctionNameCase) { $this->reflectionProvider = $reflectionProvider; $this->classCheck = $classCheck; $this->checkFunctionNameCase = $checkFunctionNameCase; } public function getNodeType() : string { return Node\Stmt\GroupUse::class; } public function processNode(Node $node, Scope $scope) : array { $errors = []; foreach ($node->uses as $use) { $error = null; /** @var Node\Name $name */ $name = Node\Name::concat($node->prefix, $use->name, ['startLine' => $use->getStartLine()]); if ($node->type === Use_::TYPE_CONSTANT || $use->type === Use_::TYPE_CONSTANT) { $error = $this->checkConstant($name); } elseif ($node->type === Use_::TYPE_FUNCTION || $use->type === Use_::TYPE_FUNCTION) { $error = $this->checkFunction($name); } elseif ($use->type === Use_::TYPE_NORMAL) { $error = $this->checkClass($name); } else { throw new ShouldNotHappenException(); } if ($error === null) { continue; } $errors[] = $error; } return $errors; } private function checkConstant(Node\Name $name) : ?IdentifierRuleError { if (!$this->reflectionProvider->hasConstant($name, null)) { return RuleErrorBuilder::message(sprintf('Used constant %s not found.', (string) $name))->discoveringSymbolsTip()->line($name->getStartLine())->identifier('constant.notFound')->build(); } return null; } private function checkFunction(Node\Name $name) : ?IdentifierRuleError { if (!$this->reflectionProvider->hasFunction($name, null)) { return RuleErrorBuilder::message(sprintf('Used function %s not found.', (string) $name))->discoveringSymbolsTip()->line($name->getStartLine())->identifier('function.notFound')->build(); } if ($this->checkFunctionNameCase) { $functionReflection = $this->reflectionProvider->getFunction($name, null); $realName = $functionReflection->getName(); $usedName = (string) $name; if (strtolower($realName) === strtolower($usedName) && $realName !== $usedName) { return RuleErrorBuilder::message(sprintf('Function %s used with incorrect case: %s.', $realName, $usedName))->line($name->getStartLine())->identifier('function.nameCase')->build(); } } return null; } private function checkClass(Node\Name $name) : ?IdentifierRuleError { $errors = $this->classCheck->checkClassNames([new ClassNameNodePair((string) $name, $name)]); if (count($errors) === 0) { return null; } elseif (count($errors) === 1) { return $errors[0]; } throw new ShouldNotHappenException(); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Generics; use PHPStan\Reflection\ParametersAcceptorWithPhpDocs; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\Generic\TemplateType; use PHPStan\Type\Generic\TemplateTypeVariance; use PHPStan\Type\Type; use function sprintf; final class VarianceCheck { /** * @var bool */ private $checkParamOutVariance; /** * @var bool */ private $strictStaticVariance; public function __construct(bool $checkParamOutVariance, bool $strictStaticVariance) { $this->checkParamOutVariance = $checkParamOutVariance; $this->strictStaticVariance = $strictStaticVariance; } /** * @param 'function'|'method' $identifier * @return list<IdentifierRuleError> */ public function checkParametersAcceptor(ParametersAcceptorWithPhpDocs $parametersAcceptor, string $parameterTypeMessage, string $parameterOutTypeMessage, string $returnTypeMessage, string $generalMessage, bool $isStatic, bool $isPrivate, string $identifier) : array { $errors = []; foreach ($parametersAcceptor->getTemplateTypeMap()->getTypes() as $templateType) { if (!$templateType instanceof TemplateType || $templateType->getScope()->getFunctionName() === null || $templateType->getVariance()->invariant()) { continue; } $errors[] = RuleErrorBuilder::message(sprintf('Variance annotation is only allowed for type parameters of classes and interfaces, but occurs in template type %s in %s.', $templateType->getName(), $generalMessage))->identifier(sprintf('%s.variance', $identifier))->build(); } if ($isPrivate) { return $errors; } $covariant = TemplateTypeVariance::createCovariant(); $parameterVariance = $isStatic && !$this->strictStaticVariance ? TemplateTypeVariance::createStatic() : TemplateTypeVariance::createContravariant(); foreach ($parametersAcceptor->getParameters() as $parameterReflection) { $type = $parameterReflection->getType(); $message = sprintf($parameterTypeMessage, $parameterReflection->getName()); foreach ($this->check($parameterVariance, $type, $message) as $error) { $errors[] = $error; } if (!$this->checkParamOutVariance) { continue; } $paramOutType = $parameterReflection->getOutType(); if ($paramOutType === null) { continue; } $outMessage = sprintf($parameterOutTypeMessage, $parameterReflection->getName()); foreach ($this->check($covariant, $paramOutType, $outMessage) as $error) { $errors[] = $error; } } $type = $parametersAcceptor->getReturnType(); foreach ($this->check($covariant, $type, $returnTypeMessage) as $error) { $errors[] = $error; } return $errors; } /** @return list<IdentifierRuleError> */ public function check(TemplateTypeVariance $positionVariance, Type $type, string $messageContext) : array { $errors = []; foreach ($type->getReferencedTemplateTypes($positionVariance) as $reference) { $referredType = $reference->getType(); if ($referredType->getScope()->getFunctionName() !== null && !$referredType->getVariance()->invariant() || $this->isTemplateTypeVarianceValid($reference->getPositionVariance(), $referredType)) { continue; } $errors[] = RuleErrorBuilder::message(sprintf('Template type %s is declared as %s, but occurs in %s position %s.', $referredType->getName(), $referredType->getVariance()->describe(), $reference->getPositionVariance()->describe(), $messageContext))->identifier('generics.variance')->build(); } return $errors; } private function isTemplateTypeVarianceValid(TemplateTypeVariance $positionVariance, TemplateType $type) : bool { return $positionVariance->validPosition($type->getVariance()); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Generics; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Internal\SprintfHelper; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\ShouldNotHappenException; use PHPStan\Type\FileTypeMapper; use PHPStan\Type\Generic\TemplateTypeScope; use PHPStan\Type\VerbosityLevel; use function array_keys; use function sprintf; /** * @implements Rule<Node\Stmt\ClassMethod> */ final class MethodTemplateTypeRule implements Rule { /** * @var FileTypeMapper */ private $fileTypeMapper; /** * @var TemplateTypeCheck */ private $templateTypeCheck; public function __construct(FileTypeMapper $fileTypeMapper, \PHPStan\Rules\Generics\TemplateTypeCheck $templateTypeCheck) { $this->fileTypeMapper = $fileTypeMapper; $this->templateTypeCheck = $templateTypeCheck; } public function getNodeType() : string { return Node\Stmt\ClassMethod::class; } public function processNode(Node $node, Scope $scope) : array { $docComment = $node->getDocComment(); if ($docComment === null) { return []; } if (!$scope->isInClass()) { throw new ShouldNotHappenException(); } $classReflection = $scope->getClassReflection(); $className = $classReflection->getDisplayName(); $methodName = $node->name->toString(); $resolvedPhpDoc = $this->fileTypeMapper->getResolvedPhpDoc($scope->getFile(), $classReflection->getName(), $scope->isInTrait() ? $scope->getTraitReflection()->getName() : null, $methodName, $docComment->getText()); $methodTemplateTags = $resolvedPhpDoc->getTemplateTags(); $escapedClassName = SprintfHelper::escapeFormatString($className); $escapedMethodName = SprintfHelper::escapeFormatString($methodName); $messages = $this->templateTypeCheck->check($scope, $node, TemplateTypeScope::createWithMethod($className, $methodName), $methodTemplateTags, sprintf('PHPDoc tag @template for method %s::%s() cannot have existing class %%s as its name.', $escapedClassName, $escapedMethodName), sprintf('PHPDoc tag @template for method %s::%s() cannot have existing type alias %%s as its name.', $escapedClassName, $escapedMethodName), sprintf('PHPDoc tag @template %%s for method %s::%s() has invalid bound type %%s.', $escapedClassName, $escapedMethodName), sprintf('PHPDoc tag @template %%s for method %s::%s() with bound type %%s is not supported.', $escapedClassName, $escapedMethodName), sprintf('PHPDoc tag @template %%s for method %s::%s() has invalid default type %%s.', $escapedClassName, $escapedMethodName), sprintf('Default type %%s in PHPDoc tag @template %%s for method %s::%s() is not subtype of bound type %%s.', $escapedClassName, $escapedMethodName), sprintf('PHPDoc tag @template %%s for method %s::%s() does not have a default type but follows an optional @template %%s.', $escapedClassName, $escapedMethodName)); $classTemplateTypes = $classReflection->getTemplateTypeMap()->getTypes(); foreach (array_keys($methodTemplateTags) as $name) { if (!isset($classTemplateTypes[$name])) { continue; } $messages[] = RuleErrorBuilder::message(sprintf('PHPDoc tag @template %s for method %s::%s() shadows @template %s for class %s.', $name, $className, $methodName, $classTemplateTypes[$name]->describe(VerbosityLevel::typeOnly()), $classReflection->getDisplayName(\false)))->identifier('method.shadowTemplate')->build(); } return $messages; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Generics; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Internal\SprintfHelper; use PHPStan\Node\InClassNode; use PHPStan\Rules\Rule; use PHPStan\Type\Generic\TemplateTypeScope; use function sprintf; /** * @implements Rule<InClassNode> */ final class ClassTemplateTypeRule implements Rule { /** * @var TemplateTypeCheck */ private $templateTypeCheck; public function __construct(\PHPStan\Rules\Generics\TemplateTypeCheck $templateTypeCheck) { $this->templateTypeCheck = $templateTypeCheck; } public function getNodeType() : string { return InClassNode::class; } public function processNode(Node $node, Scope $scope) : array { $classReflection = $node->getClassReflection(); if (!$classReflection->isClass()) { return []; } $className = $classReflection->getName(); if ($classReflection->isAnonymous()) { $displayName = 'anonymous class'; } else { $displayName = 'class ' . SprintfHelper::escapeFormatString($classReflection->getDisplayName()); } return $this->templateTypeCheck->check($scope, $node, TemplateTypeScope::createWithClass($className), $classReflection->getTemplateTags(), sprintf('PHPDoc tag @template for %s cannot have existing class %%s as its name.', $displayName), sprintf('PHPDoc tag @template for %s cannot have existing type alias %%s as its name.', $displayName), sprintf('PHPDoc tag @template %%s for %s has invalid bound type %%s.', $displayName), sprintf('PHPDoc tag @template %%s for %s with bound type %%s is not supported.', $displayName), sprintf('PHPDoc tag @template %%s for %s has invalid default type %%s.', $displayName), sprintf('Default type %%s in PHPDoc tag @template %%s for %s is not subtype of bound type %%s.', $displayName), sprintf('PHPDoc tag @template %%s for %s does not have a default type but follows an optional @template %%s.', $displayName)); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Generics; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\InClassNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function count; use function sprintf; /** * @implements Rule<InClassNode> */ final class EnumTemplateTypeRule implements Rule { public function getNodeType() : string { return InClassNode::class; } public function processNode(Node $node, Scope $scope) : array { $classReflection = $node->getClassReflection(); if (!$classReflection->isEnum()) { return []; } $templateTagsCount = count($classReflection->getTemplateTags()); if ($templateTagsCount === 0) { return []; } $className = $classReflection->getDisplayName(); return [RuleErrorBuilder::message(sprintf('Enum %s has PHPDoc @template tag%s but enums cannot be generic.', $className, $templateTagsCount === 1 ? '' : 's'))->identifier('enum.generic')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Generics; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Internal\SprintfHelper; use PHPStan\Node\InClassNode; use PHPStan\PhpDoc\Tag\ExtendsTag; use PHPStan\PhpDoc\Tag\ImplementsTag; use PHPStan\Rules\Rule; use PHPStan\Type\Type; use function array_map; use function array_merge; use function sprintf; /** * @implements Rule<InClassNode> */ final class InterfaceAncestorsRule implements Rule { /** * @var GenericAncestorsCheck */ private $genericAncestorsCheck; /** * @var CrossCheckInterfacesHelper */ private $crossCheckInterfacesHelper; public function __construct(\PHPStan\Rules\Generics\GenericAncestorsCheck $genericAncestorsCheck, \PHPStan\Rules\Generics\CrossCheckInterfacesHelper $crossCheckInterfacesHelper) { $this->genericAncestorsCheck = $genericAncestorsCheck; $this->crossCheckInterfacesHelper = $crossCheckInterfacesHelper; } public function getNodeType() : string { return InClassNode::class; } public function processNode(Node $node, Scope $scope) : array { $originalNode = $node->getOriginalNode(); if (!$originalNode instanceof Node\Stmt\Interface_) { return []; } $classReflection = $node->getClassReflection(); $interfaceName = $classReflection->getName(); $escapedInterfaceName = SprintfHelper::escapeFormatString($interfaceName); $extendsErrors = $this->genericAncestorsCheck->check($originalNode->extends, array_map(static function (ExtendsTag $tag) : Type { return $tag->getType(); }, $classReflection->getExtendsTags()), sprintf('Interface %s @extends tag contains incompatible type %%s.', $escapedInterfaceName), sprintf('Interface %s @extends tag contains unresolvable type.', $interfaceName), sprintf('Interface %s has @extends tag, but does not extend any interface.', $escapedInterfaceName), sprintf('The @extends tag of interface %s describes %%s but the interface extends: %%s', $escapedInterfaceName), 'PHPDoc tag @extends contains generic type %s but %s %s is not generic.', 'Generic type %s in PHPDoc tag @extends does not specify all template types of %s %s: %s', 'Generic type %s in PHPDoc tag @extends specifies %d template types, but %s %s supports only %d: %s', 'Type %s in generic type %s in PHPDoc tag @extends is not subtype of template type %s of %s %s.', 'Call-site variance annotation of %s in generic type %s in PHPDoc tag @extends is not allowed.', 'PHPDoc tag @extends has invalid type %s.', sprintf('Interface %s extends generic interface %%s but does not specify its types: %%s', $escapedInterfaceName), sprintf('in extended type %%s of interface %s', $escapedInterfaceName)); $implementsErrors = $this->genericAncestorsCheck->check([], array_map(static function (ImplementsTag $tag) : Type { return $tag->getType(); }, $classReflection->getImplementsTags()), sprintf('Interface %s @implements tag contains incompatible type %%s.', $escapedInterfaceName), sprintf('Interface %s @implements tag contains unresolvable type.', $interfaceName), sprintf('Interface %s has @implements tag, but can not implement any interface, must extend from it.', $escapedInterfaceName), '', '', '', '', '', '', '', '', ''); foreach ($this->crossCheckInterfacesHelper->check($classReflection) as $error) { $implementsErrors[] = $error; } return array_merge($extendsErrors, $implementsErrors); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Generics; use PhpParser\Node; use PhpParser\Node\Name; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\PhpDoc\UnresolvableTypeHelper; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\Generic\GenericObjectType; use PHPStan\Type\Generic\TemplateType; use PHPStan\Type\Generic\TemplateTypeVariance; use PHPStan\Type\Generic\TypeProjectionHelper; use PHPStan\Type\Type; use PHPStan\Type\VerbosityLevel; use function array_fill_keys; use function array_filter; use function array_keys; use function array_map; use function array_merge; use function count; use function implode; use function in_array; use function sprintf; final class GenericAncestorsCheck { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var GenericObjectTypeCheck */ private $genericObjectTypeCheck; /** * @var VarianceCheck */ private $varianceCheck; /** * @var UnresolvableTypeHelper */ private $unresolvableTypeHelper; /** * @var bool */ private $checkGenericClassInNonGenericObjectType; /** * @var string[] */ private $skipCheckGenericClasses; /** * @var bool */ private $absentTypeChecks; /** * @param string[] $skipCheckGenericClasses */ public function __construct(ReflectionProvider $reflectionProvider, \PHPStan\Rules\Generics\GenericObjectTypeCheck $genericObjectTypeCheck, \PHPStan\Rules\Generics\VarianceCheck $varianceCheck, UnresolvableTypeHelper $unresolvableTypeHelper, bool $checkGenericClassInNonGenericObjectType, array $skipCheckGenericClasses, bool $absentTypeChecks) { $this->reflectionProvider = $reflectionProvider; $this->genericObjectTypeCheck = $genericObjectTypeCheck; $this->varianceCheck = $varianceCheck; $this->unresolvableTypeHelper = $unresolvableTypeHelper; $this->checkGenericClassInNonGenericObjectType = $checkGenericClassInNonGenericObjectType; $this->skipCheckGenericClasses = $skipCheckGenericClasses; $this->absentTypeChecks = $absentTypeChecks; } /** * @param array<Node\Name> $nameNodes * @param array<Type> $ancestorTypes * @return list<IdentifierRuleError> */ public function check(array $nameNodes, array $ancestorTypes, string $incompatibleTypeMessage, string $unresolvableTypeMessage, string $noNamesMessage, string $noRelatedNameMessage, string $classNotGenericMessage, string $notEnoughTypesMessage, string $extraTypesMessage, string $typeIsNotSubtypeMessage, string $typeProjectionIsNotAllowedMessage, string $invalidTypeMessage, string $genericClassInNonGenericObjectType, string $invalidVarianceMessage) : array { $names = array_fill_keys(array_map(static function (Name $nameNode) : string { return $nameNode->toString(); }, $nameNodes), \true); $unusedNames = $names; $messages = []; foreach ($ancestorTypes as $ancestorType) { if (!$ancestorType instanceof GenericObjectType) { $messages[] = RuleErrorBuilder::message(sprintf($incompatibleTypeMessage, $ancestorType->describe(VerbosityLevel::typeOnly())))->identifier('generics.notCompatible')->build(); continue; } $ancestorTypeClassName = $ancestorType->getClassName(); if (!isset($names[$ancestorTypeClassName])) { if (count($names) === 0) { $messages[] = RuleErrorBuilder::message($noNamesMessage)->identifier('generics.noParent')->build(); } else { $messages[] = RuleErrorBuilder::message(sprintf($noRelatedNameMessage, $ancestorTypeClassName, implode(', ', array_keys($names))))->identifier('generics.wrongParent')->build(); } continue; } unset($unusedNames[$ancestorTypeClassName]); $genericObjectTypeCheckMessages = $this->genericObjectTypeCheck->check($ancestorType, $classNotGenericMessage, $notEnoughTypesMessage, $extraTypesMessage, $typeIsNotSubtypeMessage, '', ''); $messages = array_merge($messages, $genericObjectTypeCheckMessages); if ($this->absentTypeChecks) { if ($this->unresolvableTypeHelper->containsUnresolvableType($ancestorType)) { $messages[] = RuleErrorBuilder::message($unresolvableTypeMessage)->identifier('generics.unresolvable')->build(); } } foreach ($ancestorType->getReferencedClasses() as $referencedClass) { if (!$this->reflectionProvider->hasClass($referencedClass)) { $messages[] = RuleErrorBuilder::message(sprintf($invalidTypeMessage, $referencedClass))->identifier('class.notFound')->build(); continue; } if (!$this->absentTypeChecks) { continue; } if ($referencedClass === $ancestorType->getClassName()) { continue; } $classReflection = $this->reflectionProvider->getClass($referencedClass); if (!$classReflection->isTrait()) { continue; } $messages[] = RuleErrorBuilder::message(sprintf($invalidTypeMessage, $referencedClass))->identifier('generics.trait')->build(); } $variance = TemplateTypeVariance::createStatic(); $messageContext = sprintf($invalidVarianceMessage, $ancestorType->describe(VerbosityLevel::typeOnly())); foreach ($this->varianceCheck->check($variance, $ancestorType, $messageContext) as $message) { $messages[] = $message; } foreach ($ancestorType->getVariances() as $index => $typeVariance) { if ($typeVariance->invariant()) { continue; } $messages[] = RuleErrorBuilder::message(sprintf($typeProjectionIsNotAllowedMessage, TypeProjectionHelper::describe($ancestorType->getTypes()[$index], $typeVariance, VerbosityLevel::typeOnly()), $ancestorType->describe(VerbosityLevel::typeOnly())))->identifier('generics.callSiteVarianceNotAllowed')->build(); } } if ($this->checkGenericClassInNonGenericObjectType) { foreach (array_keys($unusedNames) as $unusedName) { if (!$this->reflectionProvider->hasClass($unusedName)) { continue; } $unusedNameClassReflection = $this->reflectionProvider->getClass($unusedName); if (in_array($unusedNameClassReflection->getName(), $this->skipCheckGenericClasses, \true)) { continue; } if (!$unusedNameClassReflection->isGeneric()) { continue; } $templateTypes = $unusedNameClassReflection->getTemplateTypeMap()->getTypes(); $templateTypesCount = count($templateTypes); $requiredTemplateTypesCount = count(array_filter($templateTypes, static function (Type $type) { return $type instanceof TemplateType && $type->getDefault() === null; })); if ($requiredTemplateTypesCount === 0) { continue; } $templateTypesList = implode(', ', array_keys($templateTypes)); if ($requiredTemplateTypesCount !== $templateTypesCount) { $templateTypesList .= sprintf(' (%d-%d required)', $requiredTemplateTypesCount, $templateTypesCount); } $messages[] = RuleErrorBuilder::message(sprintf($genericClassInNonGenericObjectType, $unusedName, $templateTypesList))->identifier('missingType.generics')->build(); } } return $messages; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Generics; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\InClassNode; use PHPStan\Rules\Rule; /** * @implements Rule<InClassNode> */ final class MethodTagTemplateTypeRule implements Rule { /** * @var MethodTagTemplateTypeCheck */ private $check; public function __construct(\PHPStan\Rules\Generics\MethodTagTemplateTypeCheck $check) { $this->check = $check; } public function getNodeType() : string { return InClassNode::class; } public function processNode(Node $node, Scope $scope) : array { $docComment = $node->getDocComment(); if ($docComment === null) { return []; } return $this->check->check($node->getClassReflection(), $scope, $node->getOriginalNode(), $docComment->getText()); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Generics; use PHPStan\Reflection\ClassReflection; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\VerbosityLevel; use function array_key_exists; use function sprintf; final class CrossCheckInterfacesHelper { /** * @return list<IdentifierRuleError> */ public function check(ClassReflection $classReflection) : array { $interfaceTemplateTypeMaps = []; $errors = []; $check = static function (ClassReflection $classReflection, bool $first) use(&$interfaceTemplateTypeMaps, &$check, &$errors) : void { foreach ($classReflection->getInterfaces() as $interface) { if (!$interface->isGeneric()) { continue; } if (array_key_exists($interface->getName(), $interfaceTemplateTypeMaps)) { $otherMap = $interfaceTemplateTypeMaps[$interface->getName()]; foreach ($interface->getActiveTemplateTypeMap()->getTypes() as $name => $type) { $otherType = $otherMap->getType($name); if ($otherType === null) { continue; } if ($type->equals($otherType)) { continue; } $errors[] = RuleErrorBuilder::message(sprintf('%s specifies template type %s of interface %s as %s but it\'s already specified as %s.', $classReflection->isInterface() ? sprintf('Interface %s', $classReflection->getName()) : sprintf('Class %s', $classReflection->getName()), $name, $interface->getName(), $type->describe(VerbosityLevel::value()), $otherType->describe(VerbosityLevel::value())))->identifier('generics.interfaceConflict')->build(); } continue; } $interfaceTemplateTypeMaps[$interface->getName()] = $interface->getActiveTemplateTypeMap(); } $parent = $classReflection->getParentClass(); $checkParents = \true; if ($first && $parent !== null) { $extendsTags = $classReflection->getExtendsTags(); if (!array_key_exists($parent->getName(), $extendsTags)) { $checkParents = \false; } } if ($checkParents) { while ($parent !== null) { $check($parent, \false); $parent = $parent->getParentClass(); } } $interfaceTags = []; if ($first) { if ($classReflection->isInterface()) { $interfaceTags = $classReflection->getExtendsTags(); } else { $interfaceTags = $classReflection->getImplementsTags(); } } foreach ($classReflection->getInterfaces() as $interface) { if ($first) { if (!array_key_exists($interface->getName(), $interfaceTags)) { continue; } } $check($interface, \false); } }; $check($classReflection, \true); return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Generics; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Internal\SprintfHelper; use PHPStan\Node\InClassNode; use PHPStan\Rules\Rule; use PHPStan\Type\Generic\TemplateTypeScope; use function sprintf; /** * @implements Rule<InClassNode> */ final class InterfaceTemplateTypeRule implements Rule { /** * @var TemplateTypeCheck */ private $templateTypeCheck; public function __construct(\PHPStan\Rules\Generics\TemplateTypeCheck $templateTypeCheck) { $this->templateTypeCheck = $templateTypeCheck; } public function getNodeType() : string { return InClassNode::class; } public function processNode(Node $node, Scope $scope) : array { $classReflection = $node->getClassReflection(); if (!$classReflection->isInterface()) { return []; } $interfaceName = $classReflection->getName(); $escapadInterfaceName = SprintfHelper::escapeFormatString($interfaceName); return $this->templateTypeCheck->check($scope, $node, TemplateTypeScope::createWithClass($interfaceName), $classReflection->getTemplateTags(), sprintf('PHPDoc tag @template for interface %s cannot have existing class %%s as its name.', $escapadInterfaceName), sprintf('PHPDoc tag @template for interface %s cannot have existing type alias %%s as its name.', $escapadInterfaceName), sprintf('PHPDoc tag @template %%s for interface %s has invalid bound type %%s.', $escapadInterfaceName), sprintf('PHPDoc tag @template %%s for interface %s with bound type %%s is not supported.', $escapadInterfaceName), sprintf('PHPDoc tag @template %%s for interface %s has invalid default type %%s.', $escapadInterfaceName), sprintf('Default type %%s in PHPDoc tag @template %%s for interface %s is not subtype of bound type %%s.', $escapadInterfaceName), sprintf('PHPDoc tag @template %%s for interface %s does not have a default type but follows an optional @template %%s.', $escapadInterfaceName)); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Generics; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Internal\SprintfHelper; use PHPStan\Node\InClassNode; use PHPStan\PhpDoc\Tag\ExtendsTag; use PHPStan\PhpDoc\Tag\ImplementsTag; use PHPStan\Rules\Rule; use PHPStan\Type\Type; use function array_map; use function array_merge; use function sprintf; /** * @implements Rule<InClassNode> */ final class ClassAncestorsRule implements Rule { /** * @var GenericAncestorsCheck */ private $genericAncestorsCheck; /** * @var CrossCheckInterfacesHelper */ private $crossCheckInterfacesHelper; public function __construct(\PHPStan\Rules\Generics\GenericAncestorsCheck $genericAncestorsCheck, \PHPStan\Rules\Generics\CrossCheckInterfacesHelper $crossCheckInterfacesHelper) { $this->genericAncestorsCheck = $genericAncestorsCheck; $this->crossCheckInterfacesHelper = $crossCheckInterfacesHelper; } public function getNodeType() : string { return InClassNode::class; } public function processNode(Node $node, Scope $scope) : array { $originalNode = $node->getOriginalNode(); if (!$originalNode instanceof Node\Stmt\Class_) { return []; } $classReflection = $node->getClassReflection(); if ($classReflection->isAnonymous()) { return []; } $className = $classReflection->getName(); $escapedClassName = SprintfHelper::escapeFormatString($className); $extendsErrors = $this->genericAncestorsCheck->check($originalNode->extends !== null ? [$originalNode->extends] : [], array_map(static function (ExtendsTag $tag) : Type { return $tag->getType(); }, $classReflection->getExtendsTags()), sprintf('Class %s @extends tag contains incompatible type %%s.', $escapedClassName), sprintf('Class %s @extends tag contains unresolvable type.', $className), sprintf('Class %s has @extends tag, but does not extend any class.', $escapedClassName), sprintf('The @extends tag of class %s describes %%s but the class extends %%s.', $escapedClassName), 'PHPDoc tag @extends contains generic type %s but %s %s is not generic.', 'Generic type %s in PHPDoc tag @extends does not specify all template types of %s %s: %s', 'Generic type %s in PHPDoc tag @extends specifies %d template types, but %s %s supports only %d: %s', 'Type %s in generic type %s in PHPDoc tag @extends is not subtype of template type %s of %s %s.', 'Call-site variance annotation of %s in generic type %s in PHPDoc tag @extends is not allowed.', 'PHPDoc tag @extends has invalid type %s.', sprintf('Class %s extends generic class %%s but does not specify its types: %%s', $escapedClassName), sprintf('in extended type %%s of class %s', $escapedClassName)); $implementsErrors = $this->genericAncestorsCheck->check($originalNode->implements, array_map(static function (ImplementsTag $tag) : Type { return $tag->getType(); }, $classReflection->getImplementsTags()), sprintf('Class %s @implements tag contains incompatible type %%s.', $escapedClassName), sprintf('Class %s @implements tag contains unresolvable type.', $className), sprintf('Class %s has @implements tag, but does not implement any interface.', $escapedClassName), sprintf('The @implements tag of class %s describes %%s but the class implements: %%s', $escapedClassName), 'PHPDoc tag @implements contains generic type %s but %s %s is not generic.', 'Generic type %s in PHPDoc tag @implements does not specify all template types of %s %s: %s', 'Generic type %s in PHPDoc tag @implements specifies %d template types, but %s %s supports only %d: %s', 'Type %s in generic type %s in PHPDoc tag @implements is not subtype of template type %s of %s %s.', 'Call-site variance annotation of %s in generic type %s in PHPDoc tag @implements is not allowed.', 'PHPDoc tag @implements has invalid type %s.', sprintf('Class %s implements generic interface %%s but does not specify its types: %%s', $escapedClassName), sprintf('in implemented type %%s of class %s', $escapedClassName)); foreach ($this->crossCheckInterfacesHelper->check($classReflection) as $error) { $implementsErrors[] = $error; } return array_merge($extendsErrors, $implementsErrors); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Generics; use PhpParser\Node\Stmt\ClassLike; use PHPStan\Analyser\Scope; use PHPStan\Internal\SprintfHelper; use PHPStan\Reflection\ClassReflection; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\FileTypeMapper; use PHPStan\Type\Generic\TemplateTypeScope; use PHPStan\Type\VerbosityLevel; use function array_keys; use function array_merge; use function sprintf; final class MethodTagTemplateTypeCheck { /** * @var FileTypeMapper */ private $fileTypeMapper; /** * @var TemplateTypeCheck */ private $templateTypeCheck; public function __construct(FileTypeMapper $fileTypeMapper, \PHPStan\Rules\Generics\TemplateTypeCheck $templateTypeCheck) { $this->fileTypeMapper = $fileTypeMapper; $this->templateTypeCheck = $templateTypeCheck; } /** * @return list<IdentifierRuleError> */ public function check(ClassReflection $classReflection, Scope $scope, ClassLike $node, string $docComment) : array { $className = $classReflection->getDisplayName(); $resolvedPhpDoc = $this->fileTypeMapper->getResolvedPhpDoc($scope->getFile(), $classReflection->getName(), $scope->isInTrait() ? $scope->getTraitReflection()->getName() : null, null, $docComment); $messages = []; $escapedClassName = SprintfHelper::escapeFormatString($className); $classTemplateTypes = $classReflection->getTemplateTypeMap()->getTypes(); foreach ($resolvedPhpDoc->getMethodTags() as $methodName => $methodTag) { $methodTemplateTags = $methodTag->getTemplateTags(); $escapedMethodName = SprintfHelper::escapeFormatString($methodName); $messages = array_merge($messages, $this->templateTypeCheck->check($scope, $node, TemplateTypeScope::createWithMethod($className, $methodName), $methodTemplateTags, sprintf('PHPDoc tag @method template for method %s::%s() cannot have existing class %%s as its name.', $escapedClassName, $escapedMethodName), sprintf('PHPDoc tag @method template for method %s::%s() cannot have existing type alias %%s as its name.', $escapedClassName, $escapedMethodName), sprintf('PHPDoc tag @method template %%s for method %s::%s() has invalid bound type %%s.', $escapedClassName, $escapedMethodName), sprintf('PHPDoc tag @method template %%s for method %s::%s() with bound type %%s is not supported.', $escapedClassName, $escapedMethodName), sprintf('PHPDoc tag @method template %%s for method %s::%s() has invalid default type %%s', $escapedClassName, $escapedMethodName), sprintf('Default type %%s in PHPDoc tag @method template %%s for method %s::%s() is not subtype of bound type %%s', $escapedClassName, $escapedMethodName), sprintf('PHPDoc tag @template %%s for method %s::%s() does not have a default type but follows an optional @template %%s.', $escapedClassName, $escapedMethodName))); foreach (array_keys($methodTemplateTags) as $name) { if (!isset($classTemplateTypes[$name])) { continue; } $messages[] = RuleErrorBuilder::message(sprintf('PHPDoc tag @method template %s for method %s::%s() shadows @template %s for class %s.', $name, $className, $methodName, $classTemplateTypes[$name]->describe(VerbosityLevel::typeOnly()), $classReflection->getDisplayName(\false)))->identifier('methodTag.shadowTemplate')->build(); } } return $messages; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Generics; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Internal\SprintfHelper; use PHPStan\Rules\Rule; use PHPStan\ShouldNotHappenException; use PHPStan\Type\FileTypeMapper; use PHPStan\Type\Generic\TemplateTypeScope; use function sprintf; /** * @implements Rule<Node\Stmt\Function_> */ final class FunctionTemplateTypeRule implements Rule { /** * @var FileTypeMapper */ private $fileTypeMapper; /** * @var TemplateTypeCheck */ private $templateTypeCheck; public function __construct(FileTypeMapper $fileTypeMapper, \PHPStan\Rules\Generics\TemplateTypeCheck $templateTypeCheck) { $this->fileTypeMapper = $fileTypeMapper; $this->templateTypeCheck = $templateTypeCheck; } public function getNodeType() : string { return Node\Stmt\Function_::class; } public function processNode(Node $node, Scope $scope) : array { $docComment = $node->getDocComment(); if ($docComment === null) { return []; } if (!isset($node->namespacedName)) { throw new ShouldNotHappenException(); } $functionName = (string) $node->namespacedName; $resolvedPhpDoc = $this->fileTypeMapper->getResolvedPhpDoc($scope->getFile(), null, null, $functionName, $docComment->getText()); $escapedFunctionName = SprintfHelper::escapeFormatString($functionName); return $this->templateTypeCheck->check($scope, $node, TemplateTypeScope::createWithFunction($functionName), $resolvedPhpDoc->getTemplateTags(), sprintf('PHPDoc tag @template for function %s() cannot have existing class %%s as its name.', $escapedFunctionName), sprintf('PHPDoc tag @template for function %s() cannot have existing type alias %%s as its name.', $escapedFunctionName), sprintf('PHPDoc tag @template %%s for function %s() has invalid bound type %%s.', $escapedFunctionName), sprintf('PHPDoc tag @template %%s for function %s() with bound type %%s is not supported.', $escapedFunctionName), sprintf('PHPDoc tag @template %%s for function %s() has invalid default type %%s.', $escapedFunctionName), sprintf('Default type %%s in PHPDoc tag @template %%s for function %s() is not subtype of bound type %%s.', $escapedFunctionName), sprintf('PHPDoc tag @template %%s for function %s() does not have a default type but follows an optional @template %%s.', $escapedFunctionName)); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Generics; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Internal\SprintfHelper; use PHPStan\PhpDoc\Tag\UsesTag; use PHPStan\Rules\Rule; use PHPStan\ShouldNotHappenException; use PHPStan\Type\FileTypeMapper; use PHPStan\Type\Type; use function array_map; use function sprintf; use function strtolower; use function ucfirst; /** * @implements Rule<Node\Stmt\TraitUse> */ final class UsedTraitsRule implements Rule { /** * @var FileTypeMapper */ private $fileTypeMapper; /** * @var GenericAncestorsCheck */ private $genericAncestorsCheck; public function __construct(FileTypeMapper $fileTypeMapper, \PHPStan\Rules\Generics\GenericAncestorsCheck $genericAncestorsCheck) { $this->fileTypeMapper = $fileTypeMapper; $this->genericAncestorsCheck = $genericAncestorsCheck; } public function getNodeType() : string { return Node\Stmt\TraitUse::class; } public function processNode(Node $node, Scope $scope) : array { if (!$scope->isInClass()) { throw new ShouldNotHappenException(); } $className = $scope->getClassReflection()->getName(); $traitName = null; if ($scope->isInTrait()) { $traitName = $scope->getTraitReflection()->getName(); } $useTags = []; $docComment = $node->getDocComment(); if ($docComment !== null) { $resolvedPhpDoc = $this->fileTypeMapper->getResolvedPhpDoc($scope->getFile(), $className, $traitName, null, $docComment->getText()); $useTags = $resolvedPhpDoc->getUsesTags(); } $typeDescription = strtolower($scope->getClassReflection()->getClassTypeDescription()); $description = sprintf('%s %s', $typeDescription, SprintfHelper::escapeFormatString($className)); if ($traitName !== null) { $typeDescription = 'trait'; $description = sprintf('%s %s', $typeDescription, SprintfHelper::escapeFormatString($traitName)); } $escapedDescription = SprintfHelper::escapeFormatString($description); $upperCaseDescription = ucfirst($description); $escapedUpperCaseDescription = SprintfHelper::escapeFormatString($upperCaseDescription); return $this->genericAncestorsCheck->check($node->traits, array_map(static function (UsesTag $tag) : Type { return $tag->getType(); }, $useTags), sprintf('%s @use tag contains incompatible type %%s.', $escapedUpperCaseDescription), sprintf('%s @use tag contains unresolvable type.', $upperCaseDescription), sprintf('%s has @use tag, but does not use any trait.', $upperCaseDescription), sprintf('The @use tag of %s describes %%s but the %s uses %%s.', $escapedDescription, $typeDescription), 'PHPDoc tag @use contains generic type %s but %s %s is not generic.', 'Generic type %s in PHPDoc tag @use does not specify all template types of %s %s: %s', 'Generic type %s in PHPDoc tag @use specifies %d template types, but %s %s supports only %d: %s', 'Type %s in generic type %s in PHPDoc tag @use is not subtype of template type %s of %s %s.', 'Call-site variance annotation of %s in generic type %s in PHPDoc tag @use is not allowed.', 'PHPDoc tag @use has invalid type %s.', sprintf('%s uses generic trait %%s but does not specify its types: %%s', $escapedUpperCaseDescription), sprintf('in used type %%s of %s', $escapedDescription)); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Generics; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Internal\SprintfHelper; use PHPStan\Node\InFunctionNode; use PHPStan\Rules\Rule; use function sprintf; /** * @implements Rule<InFunctionNode> */ final class FunctionSignatureVarianceRule implements Rule { /** * @var VarianceCheck */ private $varianceCheck; public function __construct(\PHPStan\Rules\Generics\VarianceCheck $varianceCheck) { $this->varianceCheck = $varianceCheck; } public function getNodeType() : string { return InFunctionNode::class; } public function processNode(Node $node, Scope $scope) : array { $functionReflection = $node->getFunctionReflection(); $functionName = $functionReflection->getName(); return $this->varianceCheck->checkParametersAcceptor($functionReflection, sprintf('in parameter %%s of function %s()', SprintfHelper::escapeFormatString($functionName)), sprintf('in param-out type of parameter %%s of function %s()', SprintfHelper::escapeFormatString($functionName)), sprintf('in return type of function %s()', $functionName), sprintf('in function %s()', $functionName), \false, \false, 'function'); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Generics; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Internal\SprintfHelper; use PHPStan\Node\InClassNode; use PHPStan\PhpDoc\Tag\ExtendsTag; use PHPStan\PhpDoc\Tag\ImplementsTag; use PHPStan\Rules\Rule; use PHPStan\Type\Type; use function array_map; use function array_merge; use function sprintf; /** * @implements Rule<InClassNode> */ final class EnumAncestorsRule implements Rule { /** * @var GenericAncestorsCheck */ private $genericAncestorsCheck; /** * @var CrossCheckInterfacesHelper */ private $crossCheckInterfacesHelper; public function __construct(\PHPStan\Rules\Generics\GenericAncestorsCheck $genericAncestorsCheck, \PHPStan\Rules\Generics\CrossCheckInterfacesHelper $crossCheckInterfacesHelper) { $this->genericAncestorsCheck = $genericAncestorsCheck; $this->crossCheckInterfacesHelper = $crossCheckInterfacesHelper; } public function getNodeType() : string { return InClassNode::class; } public function processNode(Node $node, Scope $scope) : array { $originalNode = $node->getOriginalNode(); if (!$originalNode instanceof Node\Stmt\Enum_) { return []; } $classReflection = $node->getClassReflection(); $enumName = $classReflection->getName(); $escapedEnumName = SprintfHelper::escapeFormatString($enumName); $extendsErrors = $this->genericAncestorsCheck->check([], array_map(static function (ExtendsTag $tag) : Type { return $tag->getType(); }, $classReflection->getExtendsTags()), sprintf('Enum %s @extends tag contains incompatible type %%s.', $escapedEnumName), sprintf('Enum %s @extends tag contains unresolvable type.', $enumName), sprintf('Enum %s has @extends tag, but cannot extend anything.', $escapedEnumName), '', '', '', '', '', '', '', '', ''); $implementsErrors = $this->genericAncestorsCheck->check($originalNode->implements, array_map(static function (ImplementsTag $tag) : Type { return $tag->getType(); }, $classReflection->getImplementsTags()), sprintf('Enum %s @implements tag contains incompatible type %%s.', $escapedEnumName), sprintf('Enum %s @implements tag contains unresolvable type.', $enumName), sprintf('Enum %s has @implements tag, but does not implement any interface.', $escapedEnumName), sprintf('The @implements tag of eunm %s describes %%s but the enum implements: %%s', $escapedEnumName), 'PHPDoc tag @implements contains generic type %s but %s %s is not generic.', 'Generic type %s in PHPDoc tag @implements does not specify all template types of %s %s: %s', 'Generic type %s in PHPDoc tag @implements specifies %d template types, but %s %s supports only %d: %s', 'Type %s in generic type %s in PHPDoc tag @implements is not subtype of template type %s of %s %s.', 'Call-site variance annotation of %s in generic type %s in PHPDoc tag @implements is not allowed.', 'PHPDoc tag @implements has invalid type %s.', sprintf('Enum %s implements generic interface %%s but does not specify its types: %%s', $escapedEnumName), sprintf('in implemented type %%s of enum %s', $escapedEnumName)); foreach ($this->crossCheckInterfacesHelper->check($classReflection) as $error) { $implementsErrors[] = $error; } return array_merge($extendsErrors, $implementsErrors); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Generics; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Internal\SprintfHelper; use PHPStan\PhpDoc\Tag\TemplateTag; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\ClassNameCheck; use PHPStan\Rules\ClassNameNodePair; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\ArrayType; use PHPStan\Type\BooleanType; use PHPStan\Type\Constant\ConstantArrayType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\FloatType; use PHPStan\Type\Generic\GenericObjectType; use PHPStan\Type\Generic\TemplateType; use PHPStan\Type\Generic\TemplateTypeScope; use PHPStan\Type\IntegerType; use PHPStan\Type\IntersectionType; use PHPStan\Type\KeyOfType; use PHPStan\Type\MixedType; use PHPStan\Type\ObjectShapeType; use PHPStan\Type\ObjectType; use PHPStan\Type\ObjectWithoutClassType; use PHPStan\Type\StringType; use PHPStan\Type\TypeAliasResolver; use PHPStan\Type\UnionType; use PHPStan\Type\VerbosityLevel; use function array_map; use function array_merge; use function get_class; use function sprintf; final class TemplateTypeCheck { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var ClassNameCheck */ private $classCheck; /** * @var GenericObjectTypeCheck */ private $genericObjectTypeCheck; /** * @var TypeAliasResolver */ private $typeAliasResolver; /** * @var bool */ private $checkClassCaseSensitivity; public function __construct(ReflectionProvider $reflectionProvider, ClassNameCheck $classCheck, \PHPStan\Rules\Generics\GenericObjectTypeCheck $genericObjectTypeCheck, TypeAliasResolver $typeAliasResolver, bool $checkClassCaseSensitivity) { $this->reflectionProvider = $reflectionProvider; $this->classCheck = $classCheck; $this->genericObjectTypeCheck = $genericObjectTypeCheck; $this->typeAliasResolver = $typeAliasResolver; $this->checkClassCaseSensitivity = $checkClassCaseSensitivity; } /** * @param array<string, TemplateTag> $templateTags * @return list<IdentifierRuleError> */ public function check(Scope $scope, Node $node, TemplateTypeScope $templateTypeScope, array $templateTags, string $sameTemplateTypeNameAsClassMessage, string $sameTemplateTypeNameAsTypeMessage, string $invalidBoundTypeMessage, string $notSupportedBoundMessage, string $invalidDefaultTypeMessage, string $defaultNotSubtypeOfBoundMessage, string $requiredTypeAfterOptionalMessage) : array { $messages = []; $templateTagWithDefaultType = null; foreach ($templateTags as $templateTag) { $templateTagName = $scope->resolveName(new Node\Name($templateTag->getName())); if ($this->reflectionProvider->hasClass($templateTagName)) { $messages[] = RuleErrorBuilder::message(sprintf($sameTemplateTypeNameAsClassMessage, $templateTagName))->identifier('generics.existingClass')->build(); } if ($this->typeAliasResolver->hasTypeAlias($templateTagName, $templateTypeScope->getClassName())) { $messages[] = RuleErrorBuilder::message(sprintf($sameTemplateTypeNameAsTypeMessage, $templateTagName))->identifier('generics.existingTypeAlias')->build(); } $boundType = $templateTag->getBound(); foreach ($boundType->getReferencedClasses() as $referencedClass) { if (!$this->reflectionProvider->hasClass($referencedClass)) { $messages[] = RuleErrorBuilder::message(sprintf($invalidBoundTypeMessage, $templateTagName, $referencedClass))->identifier('class.notFound')->build(); continue; } if (!$this->reflectionProvider->getClass($referencedClass)->isTrait()) { continue; } $messages[] = RuleErrorBuilder::message(sprintf($invalidBoundTypeMessage, $templateTagName, $referencedClass))->identifier('generics.traitBound')->build(); } $classNameNodePairs = array_map(static function (string $referencedClass) use($node) : ClassNameNodePair { return new ClassNameNodePair($referencedClass, $node); }, $boundType->getReferencedClasses()); $messages = array_merge($messages, $this->classCheck->checkClassNames($classNameNodePairs, $this->checkClassCaseSensitivity)); $boundTypeClass = get_class($boundType); if ($boundTypeClass !== MixedType::class && $boundTypeClass !== ConstantArrayType::class && $boundTypeClass !== ArrayType::class && $boundTypeClass !== ConstantStringType::class && $boundTypeClass !== StringType::class && $boundTypeClass !== ConstantIntegerType::class && $boundTypeClass !== IntegerType::class && $boundTypeClass !== FloatType::class && $boundTypeClass !== BooleanType::class && $boundTypeClass !== ObjectWithoutClassType::class && $boundTypeClass !== ObjectType::class && $boundTypeClass !== ObjectShapeType::class && $boundTypeClass !== GenericObjectType::class && $boundTypeClass !== KeyOfType::class && !$boundType instanceof UnionType && !$boundType instanceof IntersectionType && !$boundType instanceof TemplateType) { $messages[] = RuleErrorBuilder::message(sprintf($notSupportedBoundMessage, $templateTagName, $boundType->describe(VerbosityLevel::typeOnly())))->identifier('generics.notSupportedBound')->build(); } $escapedTemplateTagName = SprintfHelper::escapeFormatString($templateTagName); $genericObjectErrors = $this->genericObjectTypeCheck->check($boundType, sprintf('PHPDoc tag @template %s bound contains generic type %%s but %%s %%s is not generic.', $escapedTemplateTagName), sprintf('PHPDoc tag @template %s bound has type %%s which does not specify all template types of %%s %%s: %%s', $escapedTemplateTagName), sprintf('PHPDoc tag @template %s bound has type %%s which specifies %%d template types, but %%s %%s supports only %%d: %%s', $escapedTemplateTagName), sprintf('Type %%s in generic type %%s in PHPDoc tag @template %s is not subtype of template type %%s of %%s %%s.', $escapedTemplateTagName), sprintf('Call-site variance of %%s in generic type %%s in PHPDoc tag @template %s is in conflict with %%s template type %%s of %%s %%s.', $escapedTemplateTagName), sprintf('Call-site variance of %%s in generic type %%s in PHPDoc tag @template %s is redundant, template type %%s of %%s %%s has the same variance.', $escapedTemplateTagName)); foreach ($genericObjectErrors as $genericObjectError) { $messages[] = $genericObjectError; } $defaultType = $templateTag->getDefault(); if ($defaultType === null) { if ($templateTagWithDefaultType !== null) { $messages[] = RuleErrorBuilder::message(sprintf($requiredTypeAfterOptionalMessage, $templateTagName, $templateTagWithDefaultType))->identifier('generics.requiredTypeAfterOptional')->build(); } continue; } $templateTagWithDefaultType = $templateTagName; foreach ($defaultType->getReferencedClasses() as $referencedClass) { if (!$this->reflectionProvider->hasClass($referencedClass)) { $messages[] = RuleErrorBuilder::message(sprintf($invalidDefaultTypeMessage, $templateTagName, $referencedClass))->identifier('class.notFound')->build(); continue; } if (!$this->reflectionProvider->getClass($referencedClass)->isTrait()) { continue; } $messages[] = RuleErrorBuilder::message(sprintf($invalidDefaultTypeMessage, $templateTagName, $referencedClass))->identifier('generics.traitBound')->build(); } $classNameNodePairs = array_map(static function (string $referencedClass) use($node) : ClassNameNodePair { return new ClassNameNodePair($referencedClass, $node); }, $defaultType->getReferencedClasses()); $messages = array_merge($messages, $this->classCheck->checkClassNames($classNameNodePairs, $this->checkClassCaseSensitivity)); $genericDefaultErrors = $this->genericObjectTypeCheck->check($defaultType, sprintf('PHPDoc tag @template %s default contains generic type %%s but class %%s is not generic.', $escapedTemplateTagName), sprintf('PHPDoc tag @template %s default has type %%s which does not specify all template types of class %%s: %%s', $escapedTemplateTagName), sprintf('PHPDoc tag @template %s default has type %%s which specifies %%d template types, but class %%s supports only %%d: %%s', $escapedTemplateTagName), sprintf('Type %%s in generic type %%s in PHPDoc tag @template %s default is not subtype of template type %%s of class %%s.', $escapedTemplateTagName), sprintf('Call-site variance of %%s in generic type %%s in PHPDoc tag @template %s default is in conflict with %%s template type %%s of %%s %%s.', $escapedTemplateTagName), sprintf('Call-site variance of %%s in generic type %%s in PHPDoc tag @template %s default is redundant, template type %%s of %%s %%s has the same variance.', $escapedTemplateTagName)); foreach ($genericDefaultErrors as $genericDefaultError) { $messages[] = $genericDefaultError; } if (!$boundType->accepts($defaultType, $scope->isDeclareStrictTypes())->no()) { continue; } $messages[] = RuleErrorBuilder::message(sprintf($defaultNotSubtypeOfBoundMessage, $defaultType->describe(VerbosityLevel::typeOnly()), $templateTagName, $boundType->describe(VerbosityLevel::typeOnly())))->identifier('generics.templateDefaultOutOfBounds')->build(); } return $messages; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Generics; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\Rule; /** * @implements Rule<Node\Stmt\Trait_> */ final class MethodTagTemplateTypeTraitRule implements Rule { /** * @var MethodTagTemplateTypeCheck */ private $check; /** * @var ReflectionProvider */ private $reflectionProvider; public function __construct(\PHPStan\Rules\Generics\MethodTagTemplateTypeCheck $check, ReflectionProvider $reflectionProvider) { $this->check = $check; $this->reflectionProvider = $reflectionProvider; } public function getNodeType() : string { return Node\Stmt\Trait_::class; } public function processNode(Node $node, Scope $scope) : array { $docComment = $node->getDocComment(); if ($docComment === null) { return []; } $traitName = $node->namespacedName; if ($traitName === null) { return []; } if (!$this->reflectionProvider->hasClass($traitName->toString())) { return []; } return $this->check->check($this->reflectionProvider->getClass($traitName->toString()), $scope, $node, $docComment->getText()); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Generics; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\ShouldNotHappenException; use PHPStan\Type\Generic\GenericObjectType; use PHPStan\Type\Generic\GenericStaticType; use PHPStan\Type\Generic\TemplateType; use PHPStan\Type\Generic\TemplateTypeHelper; use PHPStan\Type\Generic\TemplateTypeVariance; use PHPStan\Type\Generic\TemplateTypeVarianceMap; use PHPStan\Type\Generic\TypeProjectionHelper; use PHPStan\Type\Type; use PHPStan\Type\TypeTraverser; use PHPStan\Type\VerbosityLevel; use function array_filter; use function array_keys; use function array_values; use function count; use function implode; use function sprintf; use function strtolower; final class GenericObjectTypeCheck { /** * @return list<IdentifierRuleError> */ public function check(Type $phpDocType, string $classNotGenericMessage, string $notEnoughTypesMessage, string $extraTypesMessage, string $typeIsNotSubtypeMessage, string $typeProjectionHasConflictingVarianceMessage, string $typeProjectionIsRedundantMessage) : array { $genericTypes = $this->getGenericTypes($phpDocType); $messages = []; foreach ($genericTypes as $genericType) { $classReflection = $genericType->getClassReflection(); if ($classReflection === null) { continue; } $classLikeDescription = strtolower($classReflection->getClassTypeDescription()); if (!$classReflection->isGeneric()) { $messages[] = RuleErrorBuilder::message(sprintf($classNotGenericMessage, $genericType->describe(VerbosityLevel::typeOnly()), $classLikeDescription, $classReflection->getDisplayName()))->identifier('generics.notGeneric')->build(); continue; } $templateTypes = array_values($classReflection->getTemplateTypeMap()->getTypes()); $genericTypeTypes = $genericType->getTypes(); $genericTypeVariances = $genericType->getVariances(); $templateTypesCount = count($templateTypes); $genericTypeTypesCount = count($genericTypeTypes); $requiredTemplateTypesCount = count(array_filter($templateTypes, static function (Type $type) { return $type instanceof TemplateType && $type->getDefault() === null; })); if ($requiredTemplateTypesCount > $genericTypeTypesCount) { $templateTypesList = implode(', ', array_keys($classReflection->getTemplateTypeMap()->getTypes())); if ($requiredTemplateTypesCount !== $templateTypesCount) { $templateTypesList .= sprintf(' (%d-%d required).', $requiredTemplateTypesCount, $templateTypesCount); } $messages[] = RuleErrorBuilder::message(sprintf($notEnoughTypesMessage, $genericType->describe(VerbosityLevel::typeOnly()), $classLikeDescription, $classReflection->getDisplayName(\false), $templateTypesList))->identifier('generics.lessTypes')->build(); } elseif ($templateTypesCount < $genericTypeTypesCount) { $templateTypesList = implode(', ', array_keys($classReflection->getTemplateTypeMap()->getTypes())); if ($requiredTemplateTypesCount !== $templateTypesCount) { $templateTypesList .= sprintf(' (%d-%d required)', $requiredTemplateTypesCount, $templateTypesCount); } $messages[] = RuleErrorBuilder::message(sprintf($extraTypesMessage, $genericType->describe(VerbosityLevel::typeOnly()), $genericTypeTypesCount, $classLikeDescription, $classReflection->getDisplayName(\false), $templateTypesCount, $templateTypesList))->identifier('generics.moreTypes')->build(); } for ($i = 0; $i < $templateTypesCount; $i++) { if (!isset($genericTypeTypes[$i])) { continue; } $templateType = $templateTypes[$i]; $genericTypeType = $genericTypeTypes[$i]; $genericTypeVariance = $genericTypeVariances[$i] ?? TemplateTypeVariance::createInvariant(); if ($templateType instanceof TemplateType && !$genericTypeVariance->invariant()) { if ($genericTypeVariance->equals($templateType->getVariance())) { $messages[] = RuleErrorBuilder::message(sprintf($typeProjectionIsRedundantMessage, TypeProjectionHelper::describe($genericTypeType, $genericTypeVariance, VerbosityLevel::typeOnly()), $genericType->describe(VerbosityLevel::typeOnly()), $templateType->describe(VerbosityLevel::typeOnly()), $classLikeDescription, $classReflection->getDisplayName(\false)))->identifier('generics.callSiteVarianceRedundant')->tip('You can safely remove the call-site variance annotation.')->build(); } elseif (!$genericTypeVariance->validPosition($templateType->getVariance())) { $messages[] = RuleErrorBuilder::message(sprintf($typeProjectionHasConflictingVarianceMessage, TypeProjectionHelper::describe($genericTypeType, $genericTypeVariance, VerbosityLevel::typeOnly()), $genericType->describe(VerbosityLevel::typeOnly()), $templateType->getVariance()->describe(), $templateType->describe(VerbosityLevel::typeOnly()), $classLikeDescription, $classReflection->getDisplayName(\false)))->identifier('generics.callSiteVarianceConflict')->build(); } } $boundType = TemplateTypeHelper::resolveToBounds($templateType); if ($boundType->isSuperTypeOf($genericTypeType)->yes()) { if (!$templateType instanceof TemplateType) { continue; } $map = $templateType->inferTemplateTypes($genericTypeType); for ($j = 0; $j < $templateTypesCount; $j++) { if ($i === $j) { continue; } $templateTypes[$j] = TemplateTypeHelper::resolveTemplateTypes($templateTypes[$j], $map, TemplateTypeVarianceMap::createEmpty(), TemplateTypeVariance::createStatic()); } continue; } if ($genericTypeVariance->bivariant()) { continue; } $messages[] = RuleErrorBuilder::message(sprintf($typeIsNotSubtypeMessage, $genericTypeType->describe(VerbosityLevel::typeOnly()), $genericType->describe(VerbosityLevel::typeOnly()), $templateType->describe(VerbosityLevel::typeOnly()), $classLikeDescription, $classReflection->getDisplayName(\false)))->identifier('generics.notSubtype')->build(); } } return $messages; } /** * @return list<GenericObjectType|GenericStaticType> */ private function getGenericTypes(Type $phpDocType) : array { $genericObjectTypes = []; TypeTraverser::map($phpDocType, static function (Type $type, callable $traverse) use(&$genericObjectTypes) : Type { if ($type instanceof GenericObjectType || $type instanceof GenericStaticType) { $resolvedType = TemplateTypeHelper::resolveToBounds($type); if (!$resolvedType instanceof GenericObjectType && !$resolvedType instanceof GenericStaticType) { throw new ShouldNotHappenException(); } $genericObjectTypes[] = $resolvedType; $traverse($type); return $type; } $traverse($type); return $type; }); return $genericObjectTypes; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Generics; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Internal\SprintfHelper; use PHPStan\Rules\Rule; use PHPStan\ShouldNotHappenException; use PHPStan\Type\FileTypeMapper; use PHPStan\Type\Generic\TemplateTypeScope; use function sprintf; /** * @implements Rule<Node\Stmt\Trait_> */ final class TraitTemplateTypeRule implements Rule { /** * @var FileTypeMapper */ private $fileTypeMapper; /** * @var TemplateTypeCheck */ private $templateTypeCheck; public function __construct(FileTypeMapper $fileTypeMapper, \PHPStan\Rules\Generics\TemplateTypeCheck $templateTypeCheck) { $this->fileTypeMapper = $fileTypeMapper; $this->templateTypeCheck = $templateTypeCheck; } public function getNodeType() : string { return Node\Stmt\Trait_::class; } public function processNode(Node $node, Scope $scope) : array { $docComment = $node->getDocComment(); if ($docComment === null) { return []; } if (!isset($node->namespacedName)) { throw new ShouldNotHappenException(); } $traitName = (string) $node->namespacedName; $resolvedPhpDoc = $this->fileTypeMapper->getResolvedPhpDoc($scope->getFile(), $traitName, null, null, $docComment->getText()); $escapedTraitName = SprintfHelper::escapeFormatString($traitName); return $this->templateTypeCheck->check($scope, $node, TemplateTypeScope::createWithClass($traitName), $resolvedPhpDoc->getTemplateTags(), sprintf('PHPDoc tag @template for trait %s cannot have existing class %%s as its name.', $escapedTraitName), sprintf('PHPDoc tag @template for trait %s cannot have existing type alias %%s as its name.', $escapedTraitName), sprintf('PHPDoc tag @template %%s for trait %s has invalid bound type %%s.', $escapedTraitName), sprintf('PHPDoc tag @template %%s for trait %s with bound type %%s is not supported.', $escapedTraitName), sprintf('PHPDoc tag @template %%s for trait %s has invalid default type %%s.', $escapedTraitName), sprintf('Default type %%s in PHPDoc tag @template %%s for trait %s is not subtype of bound type %%s.', $escapedTraitName), sprintf('PHPDoc tag @template %%s for trait %s does not have a default type but follows an optional @template %%s.', $escapedTraitName)); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Generics; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Internal\SprintfHelper; use PHPStan\Node\InClassMethodNode; use PHPStan\Rules\Rule; use function sprintf; /** * @implements Rule<InClassMethodNode> */ final class MethodSignatureVarianceRule implements Rule { /** * @var VarianceCheck */ private $varianceCheck; public function __construct(\PHPStan\Rules\Generics\VarianceCheck $varianceCheck) { $this->varianceCheck = $varianceCheck; } public function getNodeType() : string { return InClassMethodNode::class; } public function processNode(Node $node, Scope $scope) : array { $method = $node->getMethodReflection(); return $this->varianceCheck->checkParametersAcceptor($method, sprintf('in parameter %%s of method %s::%s()', SprintfHelper::escapeFormatString($method->getDeclaringClass()->getDisplayName()), SprintfHelper::escapeFormatString($method->getName())), sprintf('in param-out type of parameter %%s of method %s::%s()', SprintfHelper::escapeFormatString($method->getDeclaringClass()->getDisplayName()), SprintfHelper::escapeFormatString($method->getName())), sprintf('in return type of method %s::%s()', $method->getDeclaringClass()->getDisplayName(), $method->getName()), sprintf('in method %s::%s()', $method->getDeclaringClass()->getDisplayName(), $method->getName()), $method->isStatic(), $method->isPrivate() || $method->getName() === '__construct', 'method'); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Generics; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Internal\SprintfHelper; use PHPStan\Node\ClassPropertyNode; use PHPStan\Rules\Rule; use PHPStan\Type\Generic\TemplateTypeVariance; use function sprintf; /** * @implements Rule<ClassPropertyNode> */ final class PropertyVarianceRule implements Rule { /** * @var VarianceCheck */ private $varianceCheck; /** * @var bool */ private $readOnlyByPhpDoc; public function __construct(\PHPStan\Rules\Generics\VarianceCheck $varianceCheck, bool $readOnlyByPhpDoc) { $this->varianceCheck = $varianceCheck; $this->readOnlyByPhpDoc = $readOnlyByPhpDoc; } public function getNodeType() : string { return ClassPropertyNode::class; } public function processNode(Node $node, Scope $scope) : array { $classReflection = $node->getClassReflection(); if (!$classReflection->hasNativeProperty($node->getName())) { return []; } $propertyReflection = $classReflection->getNativeProperty($node->getName()); if ($propertyReflection->isPrivate()) { return []; } $variance = $node->isReadOnly() || $this->readOnlyByPhpDoc && $node->isReadOnlyByPhpDoc() ? TemplateTypeVariance::createCovariant() : TemplateTypeVariance::createInvariant(); return $this->varianceCheck->check($variance, $propertyReflection->getReadableType(), sprintf('in property %s::$%s', SprintfHelper::escapeFormatString($classReflection->getDisplayName()), SprintfHelper::escapeFormatString($node->getName()))); } } <?php declare (strict_types=1); namespace PHPStan\Rules; use PhpParser\Node; use PhpParser\Node\Expr; use PHPStan\Analyser\MutatingScope; use PHPStan\Analyser\Scope; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\ParameterReflection; use PHPStan\Reflection\ParameterReflectionWithPhpDocs; use PHPStan\Reflection\ParametersAcceptor; use PHPStan\Reflection\ResolvedFunctionVariant; use PHPStan\Rules\PhpDoc\UnresolvableTypeHelper; use PHPStan\Rules\Properties\PropertyReflectionFinder; use PHPStan\ShouldNotHappenException; use PHPStan\Type\ConditionalType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\ErrorType; use PHPStan\Type\Generic\TemplateType; use PHPStan\Type\IntegerRangeType; use PHPStan\Type\NeverType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\TypeTraverser; use PHPStan\Type\TypeUtils; use PHPStan\Type\VerbosityLevel; use function array_fill; use function array_key_exists; use function count; use function implode; use function is_string; use function max; use function sprintf; final class FunctionCallParametersCheck { /** * @var RuleLevelHelper */ private $ruleLevelHelper; /** * @var NullsafeCheck */ private $nullsafeCheck; /** * @var PhpVersion */ private $phpVersion; /** * @var UnresolvableTypeHelper */ private $unresolvableTypeHelper; /** * @var PropertyReflectionFinder */ private $propertyReflectionFinder; /** * @var bool */ private $checkArgumentTypes; /** * @var bool */ private $checkArgumentsPassedByReference; /** * @var bool */ private $checkExtraArguments; /** * @var bool */ private $checkMissingTypehints; /** * @var bool */ private $checkUnresolvableParameterTypes; public function __construct(\PHPStan\Rules\RuleLevelHelper $ruleLevelHelper, \PHPStan\Rules\NullsafeCheck $nullsafeCheck, PhpVersion $phpVersion, UnresolvableTypeHelper $unresolvableTypeHelper, PropertyReflectionFinder $propertyReflectionFinder, bool $checkArgumentTypes, bool $checkArgumentsPassedByReference, bool $checkExtraArguments, bool $checkMissingTypehints, bool $checkUnresolvableParameterTypes) { $this->ruleLevelHelper = $ruleLevelHelper; $this->nullsafeCheck = $nullsafeCheck; $this->phpVersion = $phpVersion; $this->unresolvableTypeHelper = $unresolvableTypeHelper; $this->propertyReflectionFinder = $propertyReflectionFinder; $this->checkArgumentTypes = $checkArgumentTypes; $this->checkArgumentsPassedByReference = $checkArgumentsPassedByReference; $this->checkExtraArguments = $checkExtraArguments; $this->checkMissingTypehints = $checkMissingTypehints; $this->checkUnresolvableParameterTypes = $checkUnresolvableParameterTypes; } /** * @param Node\Expr\FuncCall|Node\Expr\MethodCall|Node\Expr\StaticCall|Node\Expr\New_ $funcCall * @param array{0: string, 1: string, 2: string, 3: string, 4: string, 5: string, 6: string, 7: string, 8: string, 9: string, 10: string, 11: string, 12: string, 13?: string, 14?: string} $messages * @param 'attribute'|'callable'|'method'|'staticMethod'|'function'|'new' $nodeType * @return list<IdentifierRuleError> */ public function check(ParametersAcceptor $parametersAcceptor, Scope $scope, bool $isBuiltin, $funcCall, array $messages, string $nodeType = 'function', bool $acceptsNamedArguments = \true) : array { $functionParametersMinCount = 0; $functionParametersMaxCount = 0; foreach ($parametersAcceptor->getParameters() as $parameter) { if (!$parameter->isOptional()) { $functionParametersMinCount++; } $functionParametersMaxCount++; } if ($parametersAcceptor->isVariadic()) { $functionParametersMaxCount = -1; } /** @var array<int, array{Expr, Type|null, bool, string|null, int}> $arguments */ $arguments = []; /** @var array<int, Node\Arg> $args */ $args = $funcCall->getArgs(); $hasNamedArguments = \false; $hasUnpackedArgument = \false; $errors = []; foreach ($args as $arg) { if ($hasNamedArguments && $arg->unpack) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message('Named argument cannot be followed by an unpacked (...) argument.')->identifier('argument.unpackAfterNamed')->line($arg->getStartLine())->nonIgnorable()->build(); } if ($hasUnpackedArgument && !$arg->unpack) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message('Unpacked argument (...) cannot be followed by a non-unpacked argument.')->identifier('argument.nonUnpackAfterUnpacked')->line($arg->getStartLine())->nonIgnorable()->build(); } if ($arg->unpack) { $hasUnpackedArgument = \true; } $argumentName = null; if ($arg->name !== null) { $hasNamedArguments = \true; $argumentName = $arg->name->toString(); } if ($arg->unpack) { $type = $scope->getType($arg->value); $arrays = $type->getConstantArrays(); if (count($arrays) > 0) { $minKeys = null; foreach ($arrays as $array) { $countType = $array->getArraySize(); if ($countType instanceof ConstantIntegerType) { $keysCount = $countType->getValue(); } elseif ($countType instanceof IntegerRangeType) { $keysCount = $countType->getMin(); if ($keysCount === null) { throw new ShouldNotHappenException(); } } else { throw new ShouldNotHappenException(); } if ($minKeys !== null && $keysCount >= $minKeys) { continue; } $minKeys = $keysCount; } for ($j = 0; $j < $minKeys; $j++) { $types = []; $commonKey = null; foreach ($arrays as $constantArray) { $types[] = $constantArray->getValueTypes()[$j]; $keyType = $constantArray->getKeyTypes()[$j]; if ($commonKey === null) { $commonKey = $keyType->getValue(); } elseif ($commonKey !== $keyType->getValue()) { $commonKey = \false; } } $keyArgumentName = null; if (is_string($commonKey)) { $keyArgumentName = $commonKey; $hasNamedArguments = \true; } $arguments[] = [$arg->value, TypeCombinator::union(...$types), \false, $keyArgumentName, $arg->getStartLine()]; } } else { $arguments[] = [$arg->value, $type->getIterableValueType(), \true, null, $arg->getStartLine()]; } continue; } $arguments[] = [$arg->value, null, \false, $argumentName, $arg->getStartLine()]; } if ($hasNamedArguments && !$this->phpVersion->supportsNamedArguments() && !(bool) $funcCall->getAttribute('isAttribute', \false)) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message('Named arguments are supported only on PHP 8.0 and later.')->identifier('argument.namedNotSupported')->line($funcCall->getStartLine())->nonIgnorable()->build(); } if (!$hasNamedArguments) { $invokedParametersCount = count($arguments); foreach ($arguments as [$argumentValue, $argumentValueType, $unpack, $argumentName]) { if ($unpack) { $invokedParametersCount = max($functionParametersMinCount, $functionParametersMaxCount); break; } } if ($invokedParametersCount < $functionParametersMinCount || $this->checkExtraArguments && $invokedParametersCount > $functionParametersMaxCount) { if ($functionParametersMinCount === $functionParametersMaxCount) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf($invokedParametersCount === 1 ? $messages[0] : $messages[1], $invokedParametersCount, $functionParametersMinCount))->identifier('arguments.count')->line($funcCall->getStartLine())->build(); } elseif ($functionParametersMaxCount === -1 && $invokedParametersCount < $functionParametersMinCount) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf($invokedParametersCount === 1 ? $messages[2] : $messages[3], $invokedParametersCount, $functionParametersMinCount))->identifier('arguments.count')->line($funcCall->getStartLine())->build(); } elseif ($functionParametersMaxCount !== -1) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf($invokedParametersCount === 1 ? $messages[4] : $messages[5], $invokedParametersCount, $functionParametersMinCount, $functionParametersMaxCount))->identifier('arguments.count')->line($funcCall->getStartLine())->build(); } } } if (!$funcCall instanceof Node\Expr\New_ && !$scope->isInFirstLevelStatement() && $scope->getKeepVoidType($funcCall)->isVoid()->yes()) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message($messages[7])->identifier(sprintf('%s.void', $nodeType))->line($funcCall->getStartLine())->build(); } [$addedErrors, $argumentsWithParameters] = $this->processArguments($parametersAcceptor, $funcCall->getStartLine(), $isBuiltin, $arguments, $hasNamedArguments, $messages[10], $messages[11]); foreach ($addedErrors as $error) { $errors[] = $error; } if (!$this->checkArgumentTypes && !$this->checkArgumentsPassedByReference) { return $errors; } foreach ($argumentsWithParameters as $i => [$argumentValue, $argumentValueType, $unpack, $argumentName, $argumentLine, $parameter, $originalParameter]) { if ($this->checkArgumentTypes && $unpack) { $iterableTypeResult = $this->ruleLevelHelper->findTypeToCheck($scope, $argumentValue, '', static function (Type $type) : bool { return $type->isIterable()->yes(); }); $iterableTypeResultType = $iterableTypeResult->getType(); if (!$iterableTypeResultType instanceof ErrorType && !$iterableTypeResultType->isIterable()->yes()) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf('Only iterables can be unpacked, %s given in argument #%d.', $iterableTypeResultType->describe(VerbosityLevel::typeOnly()), $i + 1))->identifier('argument.unpackNonIterable')->line($argumentLine)->build(); } } if ($parameter === null) { continue; } if ($argumentValueType === null) { if ($scope instanceof MutatingScope) { $scope = $scope->pushInFunctionCall(null, $parameter); } $argumentValueType = $scope->getType($argumentValue); if ($scope instanceof MutatingScope) { $scope = $scope->popInFunctionCall(); } } if (!$acceptsNamedArguments && $this->checkUnresolvableParameterTypes && isset($messages[14])) { if ($argumentName !== null) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf($messages[14], sprintf('named argument $%s', $argumentName)))->identifier('argument.named')->line($argumentLine)->build(); } elseif ($unpack) { $unpackedArrayType = $scope->getType($argumentValue); $hasStringKey = $unpackedArrayType->getIterableKeyType()->isString(); if (!$hasStringKey->no()) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf($messages[14], sprintf('unpacked array with %s', $hasStringKey->yes() ? 'string key' : 'possibly string key')))->identifier('argument.named')->line($argumentLine)->build(); } } } if ($this->checkArgumentTypes) { $parameterType = TypeUtils::resolveLateResolvableTypes($parameter->getType()); if (!$parameter->passedByReference()->createsNewVariable() || !$isBuiltin && $this->checkUnresolvableParameterTypes && !$argumentValueType instanceof ErrorType) { $accepts = $this->ruleLevelHelper->acceptsWithReason($parameterType, $argumentValueType, $scope->isDeclareStrictTypes()); if (!$accepts->result) { $verbosityLevel = VerbosityLevel::getRecommendedLevelByType($parameterType, $argumentValueType); $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf($messages[6], $this->describeParameter($parameter, $argumentName === null ? $i + 1 : null), $parameterType->describe($verbosityLevel), $argumentValueType->describe($verbosityLevel)))->identifier('argument.type')->line($argumentLine)->acceptsReasonsTip($accepts->reasons)->build(); } } if ($this->checkUnresolvableParameterTypes && $originalParameter !== null && isset($messages[13]) && !$this->unresolvableTypeHelper->containsUnresolvableType($originalParameter->getType()) && $this->unresolvableTypeHelper->containsUnresolvableType($parameterType)) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf($messages[13], $this->describeParameter($parameter, $argumentName === null ? $i + 1 : null)))->identifier('argument.unresolvableType')->line($argumentLine)->build(); } if ($parameter instanceof ParameterReflectionWithPhpDocs && $parameter->getClosureThisType() !== null && ($argumentValue instanceof Expr\Closure || $argumentValue instanceof Expr\ArrowFunction) && $argumentValue->static) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf($messages[6], $this->describeParameter($parameter, $argumentName === null ? $i + 1 : null), 'bindable closure', 'static closure'))->identifier('argument.staticClosure')->line($argumentLine)->build(); } } if (!$this->checkArgumentsPassedByReference || !$parameter->passedByReference()->yes()) { continue; } if ($this->nullsafeCheck->containsNullSafe($argumentValue)) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf($messages[8], $this->describeParameter($parameter, $argumentName === null ? $i + 1 : null)))->identifier('argument.byRef')->line($argumentLine)->build(); continue; } if ($argumentValue instanceof Node\Expr\PropertyFetch || $argumentValue instanceof Node\Expr\StaticPropertyFetch) { $propertyReflections = $this->propertyReflectionFinder->findPropertyReflectionsFromNode($argumentValue, $scope); foreach ($propertyReflections as $propertyReflection) { $nativePropertyReflection = $propertyReflection->getNativeReflection(); if ($nativePropertyReflection === null) { continue; } if (!$nativePropertyReflection->isReadOnly()) { continue; } if ($nativePropertyReflection->isStatic()) { $propertyDescription = sprintf('static readonly property %s::$%s', $propertyReflection->getDeclaringClass()->getDisplayName(), $propertyReflection->getName()); } else { $propertyDescription = sprintf('readonly property %s::$%s', $propertyReflection->getDeclaringClass()->getDisplayName(), $propertyReflection->getName()); } $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf('Parameter %s is passed by reference so it does not accept %s.', $this->describeParameter($parameter, $argumentName === null ? $i + 1 : null), $propertyDescription))->identifier('argument.byRef')->line($argumentLine)->build(); } } if ($argumentValue instanceof Node\Expr\Variable || $argumentValue instanceof Node\Expr\ArrayDimFetch || $argumentValue instanceof Node\Expr\PropertyFetch || $argumentValue instanceof Node\Expr\StaticPropertyFetch) { continue; } $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf($messages[8], $this->describeParameter($parameter, $argumentName === null ? $i + 1 : null)))->identifier('argument.byRef')->line($argumentLine)->build(); } if ($this->checkMissingTypehints && $parametersAcceptor instanceof ResolvedFunctionVariant) { $originalParametersAcceptor = $parametersAcceptor->getOriginalParametersAcceptor(); $resolvedTypes = $parametersAcceptor->getResolvedTemplateTypeMap()->getTypes(); if (count($resolvedTypes) > 0) { $returnTemplateTypes = []; TypeTraverser::map($parametersAcceptor->getReturnTypeWithUnresolvableTemplateTypes(), static function (Type $type, callable $traverse) use(&$returnTemplateTypes) : Type { while ($type instanceof ConditionalType && $type->isResolvable()) { $type = $type->resolve(); } if ($type instanceof TemplateType && $type->getDefault() === null) { $returnTemplateTypes[$type->getName()] = \true; return $type; } return $traverse($type); }); $parameterTemplateTypes = []; foreach ($originalParametersAcceptor->getParameters() as $parameter) { TypeTraverser::map($parameter->getType(), static function (Type $type, callable $traverse) use(&$parameterTemplateTypes) : Type { if ($type instanceof TemplateType && $type->getDefault() === null) { $parameterTemplateTypes[$type->getName()] = \true; return $type; } return $traverse($type); }); } foreach ($resolvedTypes as $name => $type) { if (!$type instanceof ErrorType && (!$type instanceof NeverType || $type->isExplicit())) { continue; } if (!array_key_exists($name, $returnTemplateTypes)) { continue; } if (!array_key_exists($name, $parameterTemplateTypes)) { continue; } $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf($messages[9], $name))->identifier('argument.templateType')->line($funcCall->getStartLine())->tip('See: https://phpstan.org/blog/solving-phpstan-error-unable-to-resolve-template-type')->build(); } } if (!$this->unresolvableTypeHelper->containsUnresolvableType($originalParametersAcceptor->getReturnType()) && $this->unresolvableTypeHelper->containsUnresolvableType($parametersAcceptor->getReturnType())) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message($messages[12])->identifier(sprintf('%s.unresolvableReturnType', $nodeType))->line($funcCall->getStartLine())->build(); } } return $errors; } /** * @param array<int, array{Expr, Type|null, bool, string|null, int}> $arguments * @return array{list<IdentifierRuleError>, array<int, array{Expr, Type|null, bool, (string|null), int, (ParameterReflection|null), (ParameterReflection|null)}>} */ private function processArguments(ParametersAcceptor $parametersAcceptor, int $line, bool $isBuiltin, array $arguments, bool $hasNamedArguments, string $missingParameterMessage, string $unknownParameterMessage) : array { $parameters = $parametersAcceptor->getParameters(); $originalParameters = $parametersAcceptor instanceof ResolvedFunctionVariant ? $parametersAcceptor->getOriginalParametersAcceptor()->getParameters() : array_fill(0, count($parameters), null); $parametersByName = []; $originalParametersByName = []; $unusedParametersByName = []; $errors = []; foreach ($parameters as $i => $parameter) { $parametersByName[$parameter->getName()] = $parameter; $originalParametersByName[$parameter->getName()] = $originalParameters[$i]; if ($parameter->isVariadic()) { continue; } $unusedParametersByName[$parameter->getName()] = $parameter; } $newArguments = []; $namedArgumentAlreadyOccurred = \false; foreach ($arguments as $i => [$argumentValue, $argumentValueType, $unpack, $argumentName, $argumentLine]) { if ($argumentName === null) { if (!isset($parameters[$i])) { if (!$parametersAcceptor->isVariadic() || count($parameters) === 0) { $newArguments[$i] = [$argumentValue, $argumentValueType, $unpack, $argumentName, $argumentLine, null, null]; break; } $parameter = $parameters[count($parameters) - 1]; $originalParameter = $originalParameters[count($originalParameters) - 1]; if (!$parameter->isVariadic()) { $newArguments[$i] = [$argumentValue, $argumentValueType, $unpack, $argumentName, $argumentLine, null, null]; break; // func_get_args } } else { $parameter = $parameters[$i]; $originalParameter = $originalParameters[$i]; } } elseif (array_key_exists($argumentName, $parametersByName)) { $namedArgumentAlreadyOccurred = \true; $parameter = $parametersByName[$argumentName]; $originalParameter = $originalParametersByName[$argumentName]; } else { $namedArgumentAlreadyOccurred = \true; $parametersCount = count($parameters); if (!$parametersAcceptor->isVariadic() || $parametersCount <= 0 || $isBuiltin) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf($unknownParameterMessage, $argumentName))->identifier('argument.unknown')->line($argumentLine)->build(); $newArguments[$i] = [$argumentValue, $argumentValueType, $unpack, $argumentName, $argumentLine, null, null]; continue; } $parameter = $parameters[$parametersCount - 1]; $originalParameter = $originalParameters[$parametersCount - 1]; } if ($namedArgumentAlreadyOccurred && $argumentName === null && !$unpack) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message('Named argument cannot be followed by a positional argument.')->identifier('argument.positionalAfterNamed')->line($argumentLine)->nonIgnorable()->build(); $newArguments[$i] = [$argumentValue, $argumentValueType, $unpack, $argumentName, $argumentLine, null, null]; continue; } $newArguments[$i] = [$argumentValue, $argumentValueType, $unpack, $argumentName, $argumentLine, $parameter, $originalParameter]; if ($hasNamedArguments && !$parameter->isVariadic() && !array_key_exists($parameter->getName(), $unusedParametersByName)) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf('Argument for parameter $%s has already been passed.', $parameter->getName()))->identifier('argument.duplicate')->line($argumentLine)->build(); continue; } unset($unusedParametersByName[$parameter->getName()]); } if ($hasNamedArguments) { foreach ($unusedParametersByName as $parameter) { if ($parameter->isOptional()) { continue; } $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf($missingParameterMessage, sprintf('%s (%s)', $parameter->getName(), $parameter->getType()->describe(VerbosityLevel::typeOnly()))))->identifier('argument.missing')->line($line)->build(); } } return [$errors, $newArguments]; } private function describeParameter(ParameterReflection $parameter, ?int $position) : string { $parts = []; if ($position !== null) { $parts[] = '#' . $position; } $name = $parameter->getName(); if ($name !== '') { $parts[] = ($parameter->isVariadic() ? '...$' : '$') . $name; } return implode(' ', $parts); } } <?php declare (strict_types=1); namespace PHPStan\Rules; use function array_merge; final class RuleLevelHelperAcceptsResult { /** * @readonly * @var bool */ public $result; /** * @readonly * @var list<string> */ public $reasons; /** * @param list<string> $reasons */ public function __construct(bool $result, array $reasons) { $this->result = $result; $this->reasons = $reasons; } public function and(self $other) : self { return new self($this->result && $other->result, array_merge($this->reasons, $other->reasons)); } /** * @param callable(string): string $cb */ public function decorateReasons(callable $cb) : self { $reasons = []; foreach ($this->reasons as $reason) { $reasons[] = $cb($reason); } return new self($this->result, $reasons); } } <?php declare (strict_types=1); namespace PHPStan\Rules\DeadCode; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\Printer\ExprPrinter; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function sprintf; /** * @deprecated Replaced by PHPStan\Rules\DeadCode\BetterNoopRule * @implements Rule<Node\Stmt\Expression> */ final class NoopRule implements Rule { /** * @var ExprPrinter */ private $exprPrinter; /** * @var bool */ private $better; public function __construct(ExprPrinter $exprPrinter, bool $better) { $this->exprPrinter = $exprPrinter; $this->better = $better; } public function getNodeType() : string { return Node\Stmt\Expression::class; } public function processNode(Node $node, Scope $scope) : array { if ($this->better) { // disabled in bleeding edge return []; } $originalExpr = $node->expr; $expr = $originalExpr; if ($expr instanceof Node\Expr\Cast || $expr instanceof Node\Expr\UnaryMinus || $expr instanceof Node\Expr\UnaryPlus || $expr instanceof Node\Expr\ErrorSuppress) { $expr = $expr->expr; } if (!$this->isNoopExpr($expr)) { return []; } return [RuleErrorBuilder::message(sprintf('Expression "%s" on a separate line does not do anything.', $this->exprPrinter->printExpr($originalExpr)))->line($expr->getStartLine())->identifier('expr.resultUnused')->build()]; } public function isNoopExpr(Node\Expr $expr) : bool { return $expr instanceof Node\Expr\Variable || $expr instanceof Node\Expr\PropertyFetch || $expr instanceof Node\Expr\StaticPropertyFetch || $expr instanceof Node\Expr\NullsafePropertyFetch || $expr instanceof Node\Expr\ArrayDimFetch || $expr instanceof Node\Scalar || $expr instanceof Node\Expr\Isset_ || $expr instanceof Node\Expr\Empty_ || $expr instanceof Node\Expr\ConstFetch || $expr instanceof Node\Expr\ClassConstFetch; } } <?php declare (strict_types=1); namespace PHPStan\Rules\DeadCode; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Collectors\Collector; use PHPStan\Node\MethodReturnStatementsNode; use function count; /** * @implements Collector<MethodReturnStatementsNode, array{class-string, string, string}> */ final class MethodWithoutImpurePointsCollector implements Collector { public function getNodeType() : string { return MethodReturnStatementsNode::class; } public function processNode(Node $node, Scope $scope) { $method = $node->getMethodReflection(); if (!$method->isPure()->maybe()) { return null; } if (!$method->hasSideEffects()->maybe()) { return null; } if (count($node->getImpurePoints()) !== 0) { return null; } if (count($node->getStatementResult()->getThrowPoints()) !== 0) { return null; } foreach ($method->getParameters() as $parameter) { if (!$parameter->passedByReference()->createsNewVariable()) { continue; } return null; } if (count($method->getAsserts()->getAll()) !== 0) { return null; } if ($method->isConstructor()) { return null; } return [$method->getDeclaringClass()->getName(), $method->getName(), $method->getDeclaringClass()->getDisplayName()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\DeadCode; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\CollectedDataNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function array_key_exists; use function sprintf; use function strtolower; /** * @implements Rule<CollectedDataNode> */ final class CallToFunctionStatementWithoutImpurePointsRule implements Rule { public function getNodeType() : string { return CollectedDataNode::class; } public function processNode(Node $node, Scope $scope) : array { $functions = []; foreach ($node->get(\PHPStan\Rules\DeadCode\FunctionWithoutImpurePointsCollector::class) as [$functionName]) { $functions[strtolower($functionName)] = $functionName; } $errors = []; foreach ($node->get(\PHPStan\Rules\DeadCode\PossiblyPureFuncCallCollector::class) as $filePath => $data) { foreach ($data as [$func, $line]) { $lowerFunc = strtolower($func); if (!array_key_exists($lowerFunc, $functions)) { continue; } $originalFunctionName = $functions[$lowerFunc]; $errors[] = RuleErrorBuilder::message(sprintf('Call to function %s() on a separate line has no effect.', $originalFunctionName))->file($filePath)->line($line)->identifier('function.resultUnused')->build(); } } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\DeadCode; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\CollectedDataNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function array_key_exists; use function sprintf; use function strtolower; /** * @implements Rule<CollectedDataNode> */ final class CallToConstructorStatementWithoutImpurePointsRule implements Rule { public function getNodeType() : string { return CollectedDataNode::class; } public function processNode(Node $node, Scope $scope) : array { $classesWithConstructors = []; foreach ($node->get(\PHPStan\Rules\DeadCode\ConstructorWithoutImpurePointsCollector::class) as [$class]) { $classesWithConstructors[strtolower($class)] = $class; } $errors = []; foreach ($node->get(\PHPStan\Rules\DeadCode\PossiblyPureNewCollector::class) as $filePath => $data) { foreach ($data as [$class, $line]) { $lowerClass = strtolower($class); if (!array_key_exists($lowerClass, $classesWithConstructors)) { continue; } $originalClassName = $classesWithConstructors[$lowerClass]; $errors[] = RuleErrorBuilder::message(sprintf('Call to new %s() on a separate line has no effect.', $originalClassName))->file($filePath)->line($line)->identifier('new.resultUnused')->build(); } } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\DeadCode; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\ClassConstantsNode; use PHPStan\Rules\Constants\AlwaysUsedClassConstantsExtensionProvider; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\ObjectType; use function sprintf; /** * @implements Rule<ClassConstantsNode> */ final class UnusedPrivateConstantRule implements Rule { /** * @var AlwaysUsedClassConstantsExtensionProvider */ private $extensionProvider; public function __construct(AlwaysUsedClassConstantsExtensionProvider $extensionProvider) { $this->extensionProvider = $extensionProvider; } public function getNodeType() : string { return ClassConstantsNode::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->getClass() instanceof Node\Stmt\Class_ && !$node->getClass() instanceof Node\Stmt\Enum_) { return []; } $classReflection = $node->getClassReflection(); $classType = new ObjectType($classReflection->getName(), null, $classReflection); $constants = []; foreach ($node->getConstants() as $constant) { if (!$constant->isPrivate()) { continue; } foreach ($constant->consts as $const) { $constantName = $const->name->toString(); $constantReflection = $classReflection->getConstant($constantName); foreach ($this->extensionProvider->getExtensions() as $extension) { if ($extension->isAlwaysUsed($constantReflection)) { continue 2; } } $constants[$constantName] = $const; } } foreach ($node->getFetches() as $fetch) { $fetchNode = $fetch->getNode(); $fetchScope = $fetch->getScope(); if ($fetchNode->class instanceof Node\Name) { $fetchedOnClass = $fetchScope->resolveTypeByName($fetchNode->class); } else { $fetchedOnClass = $fetchScope->getType($fetchNode->class); } if (!$fetchNode->name instanceof Node\Identifier) { if (!$classType->isSuperTypeOf($fetchedOnClass)->no()) { $constants = []; break; } continue; } $constantReflection = $fetchScope->getConstantReflection($fetchedOnClass, $fetchNode->name->toString()); if ($constantReflection === null) { if (!$classType->isSuperTypeOf($fetchedOnClass)->no()) { unset($constants[$fetchNode->name->toString()]); } continue; } if ($constantReflection->getDeclaringClass()->getName() !== $classReflection->getName()) { if (!$classType->isSuperTypeOf($fetchedOnClass)->no()) { unset($constants[$fetchNode->name->toString()]); } continue; } unset($constants[$fetchNode->name->toString()]); } $errors = []; foreach ($constants as $constantName => $constantNode) { $errors[] = RuleErrorBuilder::message(sprintf('Constant %s::%s is unused.', $classReflection->getDisplayName(), $constantName))->line($constantNode->getStartLine())->identifier('classConstant.unused')->tip(sprintf('See: %s', 'https://phpstan.org/developing-extensions/always-used-class-constants'))->build(); } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\DeadCode; use PhpParser\Node; use PhpParser\Node\Stmt\Expression; use PHPStan\Analyser\Scope; use PHPStan\Collectors\Collector; use PHPStan\Reflection\ReflectionProvider; /** * @implements Collector<Node\Stmt\Expression, array{string, int}> */ final class PossiblyPureFuncCallCollector implements Collector { /** * @var ReflectionProvider */ private $reflectionProvider; public function __construct(ReflectionProvider $reflectionProvider) { $this->reflectionProvider = $reflectionProvider; } public function getNodeType() : string { return Expression::class; } public function processNode(Node $node, Scope $scope) { if (!$node->expr instanceof Node\Expr\FuncCall) { return null; } if (!$node->expr->name instanceof Node\Name) { return null; } if (!$this->reflectionProvider->hasFunction($node->expr->name, $scope)) { return null; } $functionReflection = $this->reflectionProvider->getFunction($node->expr->name, $scope); if (!$functionReflection->isPure()->maybe()) { return null; } if (!$functionReflection->hasSideEffects()->maybe()) { return null; } return [$functionReflection->getName(), $node->getStartLine()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\DeadCode; use PhpParser\Node; use PhpParser\Node\Stmt\Expression; use PHPStan\Analyser\Scope; use PHPStan\Collectors\Collector; /** * @implements Collector<Node\Stmt\Expression, array{non-empty-list<class-string>, string, int}> */ final class PossiblyPureMethodCallCollector implements Collector { public function __construct() { } public function getNodeType() : string { return Expression::class; } public function processNode(Node $node, Scope $scope) { if (!$node->expr instanceof Node\Expr\MethodCall) { return null; } if (!$node->expr->name instanceof Node\Identifier) { return null; } $methodName = $node->expr->name->toString(); $calledOnType = $scope->getType($node->expr->var); if (!$calledOnType->hasMethod($methodName)->yes()) { return null; } $classNames = []; $methodReflection = null; foreach ($calledOnType->getObjectClassReflections() as $classReflection) { if (!$classReflection->hasMethod($methodName)) { return null; } $methodReflection = $classReflection->getMethod($methodName, $scope); if (!$methodReflection->isPrivate() && !$methodReflection->isFinal()->yes() && !$methodReflection->getDeclaringClass()->isFinal()) { if (!$classReflection->isFinal()) { return null; } } if (!$methodReflection->isPure()->maybe()) { return null; } if (!$methodReflection->hasSideEffects()->maybe()) { return null; } $classNames[] = $methodReflection->getDeclaringClass()->getName(); } if ($methodReflection === null) { return null; } return [$classNames, $methodReflection->getName(), $node->getStartLine()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\DeadCode; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\UnreachableStatementNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; /** * @implements Rule<UnreachableStatementNode> */ final class UnreachableStatementRule implements Rule { public function getNodeType() : string { return UnreachableStatementNode::class; } public function processNode(Node $node, Scope $scope) : array { return [RuleErrorBuilder::message('Unreachable statement - code above always terminates.')->identifier('deadCode.unreachable')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\DeadCode; use PhpParser\Node; use PhpParser\Node\Stmt\Expression; use PHPStan\Analyser\Scope; use PHPStan\Collectors\Collector; /** * @implements Collector<Node\Stmt\Expression, array{class-string, string, int}> */ final class PossiblyPureStaticCallCollector implements Collector { public function __construct() { } public function getNodeType() : string { return Expression::class; } public function processNode(Node $node, Scope $scope) { if (!$node->expr instanceof Node\Expr\StaticCall) { return null; } if (!$node->expr->name instanceof Node\Identifier) { return null; } if (!$node->expr->class instanceof Node\Name) { return null; } $methodName = $node->expr->name->toString(); $calledOnType = $scope->resolveTypeByName($node->expr->class); $methodReflection = $scope->getMethodReflection($calledOnType, $methodName); if ($methodReflection === null) { return null; } if (!$methodReflection->isPure()->maybe()) { return null; } if (!$methodReflection->hasSideEffects()->maybe()) { return null; } return [$methodReflection->getDeclaringClass()->getName(), $methodReflection->getName(), $node->getStartLine()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\DeadCode; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\ClassPropertiesNode; use PHPStan\Node\Property\PropertyRead; use PHPStan\Rules\Properties\ReadWritePropertiesExtensionProvider; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\ObjectType; use function array_key_exists; use function array_map; use function count; use function sprintf; use function str_contains; /** * @implements Rule<ClassPropertiesNode> */ final class UnusedPrivatePropertyRule implements Rule { /** * @var ReadWritePropertiesExtensionProvider */ private $extensionProvider; /** * @var string[] */ private $alwaysWrittenTags; /** * @var string[] */ private $alwaysReadTags; /** * @var bool */ private $checkUninitializedProperties; /** * @param string[] $alwaysWrittenTags * @param string[] $alwaysReadTags */ public function __construct(ReadWritePropertiesExtensionProvider $extensionProvider, array $alwaysWrittenTags, array $alwaysReadTags, bool $checkUninitializedProperties) { $this->extensionProvider = $extensionProvider; $this->alwaysWrittenTags = $alwaysWrittenTags; $this->alwaysReadTags = $alwaysReadTags; $this->checkUninitializedProperties = $checkUninitializedProperties; } public function getNodeType() : string { return ClassPropertiesNode::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->getClass() instanceof Node\Stmt\Class_) { return []; } $classReflection = $node->getClassReflection(); $classType = new ObjectType($classReflection->getName(), null, $classReflection); $properties = []; foreach ($node->getProperties() as $property) { if (!$property->isPrivate()) { continue; } if ($property->isDeclaredInTrait()) { continue; } $alwaysRead = \false; $alwaysWritten = \false; if ($property->getPhpDoc() !== null) { $text = $property->getPhpDoc(); foreach ($this->alwaysReadTags as $tag) { if (!str_contains($text, $tag)) { continue; } $alwaysRead = \true; break; } foreach ($this->alwaysWrittenTags as $tag) { if (!str_contains($text, $tag)) { continue; } $alwaysWritten = \true; break; } } $propertyName = $property->getName(); if (!$alwaysRead || !$alwaysWritten) { if (!$classReflection->hasNativeProperty($propertyName)) { continue; } $propertyReflection = $classReflection->getNativeProperty($propertyName); foreach ($this->extensionProvider->getExtensions() as $extension) { if ($alwaysRead && $alwaysWritten) { break; } if (!$alwaysRead && $extension->isAlwaysRead($propertyReflection, $propertyName)) { $alwaysRead = \true; } if ($alwaysWritten || !$extension->isAlwaysWritten($propertyReflection, $propertyName)) { continue; } $alwaysWritten = \true; } } $read = $alwaysRead; $written = $alwaysWritten || $property->getDefault() !== null; $properties[$propertyName] = ['read' => $read, 'written' => $written, 'node' => $property]; } foreach ($node->getPropertyUsages() as $usage) { $fetch = $usage->getFetch(); if ($fetch->name instanceof Node\Identifier) { $propertyNames = [$fetch->name->toString()]; } else { $propertyNameType = $usage->getScope()->getType($fetch->name); $strings = $propertyNameType->getConstantStrings(); if (count($strings) === 0) { // handle subtractions of a dynamic property fetch foreach ($properties as $propertyName => $data) { if ((new ConstantStringType($propertyName))->isSuperTypeOf($propertyNameType)->no()) { continue; } unset($properties[$propertyName]); } continue; } $propertyNames = array_map(static function (ConstantStringType $type) : string { return $type->getValue(); }, $strings); } if ($fetch instanceof Node\Expr\PropertyFetch) { $fetchedOnType = $usage->getScope()->getType($fetch->var); } else { if ($fetch->class instanceof Node\Name) { $fetchedOnType = $usage->getScope()->resolveTypeByName($fetch->class); } else { $fetchedOnType = $usage->getScope()->getType($fetch->class); } } foreach ($propertyNames as $propertyName) { if (!array_key_exists($propertyName, $properties)) { continue; } $propertyReflection = $usage->getScope()->getPropertyReflection($fetchedOnType, $propertyName); if ($propertyReflection === null) { if (!$classType->isSuperTypeOf($fetchedOnType)->no()) { if ($usage instanceof PropertyRead) { $properties[$propertyName]['read'] = \true; } else { $properties[$propertyName]['written'] = \true; } } continue; } if ($propertyReflection->getDeclaringClass()->getName() !== $classReflection->getName()) { if (!$classType->isSuperTypeOf($fetchedOnType)->no()) { if ($usage instanceof PropertyRead) { $properties[$propertyName]['read'] = \true; } else { $properties[$propertyName]['written'] = \true; } } continue; } if ($usage instanceof PropertyRead) { $properties[$propertyName]['read'] = \true; } else { $properties[$propertyName]['written'] = \true; } } } [$uninitializedProperties] = $node->getUninitializedProperties($scope, []); $errors = []; foreach ($properties as $name => $data) { $propertyNode = $data['node']; if ($propertyNode->isStatic()) { $propertyName = sprintf('Static property %s::$%s', $classReflection->getDisplayName(), $name); } else { $propertyName = sprintf('Property %s::$%s', $classReflection->getDisplayName(), $name); } $tip = sprintf('See: %s', 'https://phpstan.org/developing-extensions/always-read-written-properties'); if (!$data['read']) { if (!$data['written']) { $errors[] = RuleErrorBuilder::message(sprintf('%s is unused.', $propertyName))->line($propertyNode->getStartLine())->tip($tip)->identifier('property.unused')->build(); } else { $errors[] = RuleErrorBuilder::message(sprintf('%s is never read, only written.', $propertyName))->line($propertyNode->getStartLine())->identifier('property.onlyWritten')->tip($tip)->build(); } } elseif (!$data['written'] && (!array_key_exists($name, $uninitializedProperties) || !$this->checkUninitializedProperties)) { $errors[] = RuleErrorBuilder::message(sprintf('%s is never written, only read.', $propertyName))->line($propertyNode->getStartLine())->identifier('property.onlyRead')->tip($tip)->build(); } } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\DeadCode; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\CollectedDataNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function array_key_exists; use function sprintf; use function strtolower; /** * @implements Rule<CollectedDataNode> */ final class CallToMethodStatementWithoutImpurePointsRule implements Rule { public function getNodeType() : string { return CollectedDataNode::class; } public function processNode(Node $node, Scope $scope) : array { $methods = []; foreach ($node->get(\PHPStan\Rules\DeadCode\MethodWithoutImpurePointsCollector::class) as $collected) { foreach ($collected as [$className, $methodName, $classDisplayName]) { $className = strtolower($className); if (!array_key_exists($className, $methods)) { $methods[$className] = []; } $methods[$className][strtolower($methodName)] = $classDisplayName . '::' . $methodName; } } $errors = []; foreach ($node->get(\PHPStan\Rules\DeadCode\PossiblyPureMethodCallCollector::class) as $filePath => $data) { foreach ($data as [$classNames, $method, $line]) { $originalMethodName = null; foreach ($classNames as $className) { $className = strtolower($className); if (!array_key_exists($className, $methods)) { continue 2; } $lowerMethod = strtolower($method); if (!array_key_exists($lowerMethod, $methods[$className])) { continue 2; } $originalMethodName = $methods[$className][$lowerMethod]; } $errors[] = RuleErrorBuilder::message(sprintf('Call to method %s() on a separate line has no effect.', $originalMethodName))->file($filePath)->line($line)->identifier('method.resultUnused')->build(); } } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\DeadCode; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\CollectedDataNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function array_key_exists; use function sprintf; use function strtolower; /** * @implements Rule<CollectedDataNode> */ final class CallToStaticMethodStatementWithoutImpurePointsRule implements Rule { public function getNodeType() : string { return CollectedDataNode::class; } public function processNode(Node $node, Scope $scope) : array { $methods = []; foreach ($node->get(\PHPStan\Rules\DeadCode\MethodWithoutImpurePointsCollector::class) as $collected) { foreach ($collected as [$className, $methodName, $classDisplayName]) { $lowerClassName = strtolower($className); if (!array_key_exists($lowerClassName, $methods)) { $methods[$lowerClassName] = []; } $methods[$lowerClassName][strtolower($methodName)] = $classDisplayName . '::' . $methodName; } } $errors = []; foreach ($node->get(\PHPStan\Rules\DeadCode\PossiblyPureStaticCallCollector::class) as $filePath => $data) { foreach ($data as [$className, $method, $line]) { $lowerClassName = strtolower($className); if (!array_key_exists($lowerClassName, $methods)) { continue; } $lowerMethod = strtolower($method); if (!array_key_exists($lowerMethod, $methods[$lowerClassName])) { continue; } $originalMethodName = $methods[$lowerClassName][$lowerMethod]; $errors[] = RuleErrorBuilder::message(sprintf('Call to %s() on a separate line has no effect.', $originalMethodName))->file($filePath)->line($line)->identifier('staticMethod.resultUnused')->build(); } } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\DeadCode; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\NoopExpressionNode; use PHPStan\Node\Printer\ExprPrinter; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function count; use function preg_split; use function sprintf; /** * @implements Rule<NoopExpressionNode> */ final class BetterNoopRule implements Rule { /** * @var ExprPrinter */ private $exprPrinter; public function __construct(ExprPrinter $exprPrinter) { $this->exprPrinter = $exprPrinter; } public function getNodeType() : string { return NoopExpressionNode::class; } public function processNode(Node $node, Scope $scope) : array { $expr = $node->getOriginalExpr(); if ($expr instanceof Node\Expr\BinaryOp\LogicalXor) { return [RuleErrorBuilder::message('Unused result of "xor" operator.')->line($expr->getStartLine())->tip('This operator has unexpected precedence, try disambiguating the logic with parentheses ().')->identifier('logicalXor.resultUnused')->build()]; } if ($expr instanceof Node\Expr\BinaryOp\LogicalAnd || $expr instanceof Node\Expr\BinaryOp\LogicalOr) { $identifierType = $expr instanceof Node\Expr\BinaryOp\LogicalAnd ? 'logicalAnd' : 'logicalOr'; return [RuleErrorBuilder::message(sprintf('Unused result of "%s" operator.', $expr->getOperatorSigil()))->line($expr->getStartLine())->tip('This operator has unexpected precedence, try disambiguating the logic with parentheses ().')->identifier(sprintf('%s.resultUnused', $identifierType))->build()]; } if ($node->hasAssign()) { return []; } if ($expr instanceof Node\Expr\BinaryOp\BooleanAnd || $expr instanceof Node\Expr\BinaryOp\BooleanOr) { $identifierType = $expr instanceof Node\Expr\BinaryOp\BooleanAnd ? 'booleanAnd' : 'booleanOr'; return [RuleErrorBuilder::message(sprintf('Unused result of "%s" operator.', $expr->getOperatorSigil()))->line($expr->getStartLine())->identifier(sprintf('%s.resultUnused', $identifierType))->build()]; } if ($expr instanceof Node\Expr\Ternary) { return [RuleErrorBuilder::message('Unused result of ternary operator.')->line($expr->getStartLine())->identifier('ternary.resultUnused')->build()]; } if ($expr instanceof Node\Expr\FuncCall) { if ($expr->name instanceof Node\Name) { // handled by CallToFunctionStatementWithoutSideEffectsRule return []; } $nameType = $scope->getType($expr->name); if (!$nameType->isCallable()->yes()) { return []; } } if ($expr instanceof Node\Expr\New_ && $expr->class instanceof Node\Name) { // handled by CallToConstructorStatementWithoutSideEffectsRule return []; } if ($expr instanceof Node\Expr\NullsafeMethodCall || $expr instanceof Node\Expr\MethodCall || $expr instanceof Node\Expr\StaticCall) { // handled by *WithoutSideEffectsRule rules return []; } if ($expr instanceof Node\Expr\Assign || $expr instanceof Node\Expr\AssignOp || $expr instanceof Node\Expr\AssignRef) { return []; } if ($expr instanceof Node\Expr\Closure) { return []; } $exprString = $this->exprPrinter->printExpr($expr); $exprStringLines = preg_split('~\\R~', $exprString, 2); if ($exprStringLines !== \false && count($exprStringLines) > 1) { $exprString = $exprStringLines[0] . '…'; } return [RuleErrorBuilder::message(sprintf('Expression "%s" on a separate line does not do anything.', $exprString))->line($expr->getStartLine())->identifier('expr.resultUnused')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\DeadCode; use PhpParser\Node; use PhpParser\Node\Identifier; use PHPStan\Analyser\Scope; use PHPStan\Node\ClassMethodsNode; use PHPStan\Reflection\MethodReflection; use PHPStan\Rules\Methods\AlwaysUsedMethodExtensionProvider; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\ObjectType; use function array_map; use function count; use function sprintf; use function strtolower; /** * @implements Rule<ClassMethodsNode> */ final class UnusedPrivateMethodRule implements Rule { /** * @var AlwaysUsedMethodExtensionProvider */ private $extensionProvider; public function __construct(AlwaysUsedMethodExtensionProvider $extensionProvider) { $this->extensionProvider = $extensionProvider; } public function getNodeType() : string { return ClassMethodsNode::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->getClass() instanceof Node\Stmt\Class_ && !$node->getClass() instanceof Node\Stmt\Enum_) { return []; } $classReflection = $node->getClassReflection(); $classType = new ObjectType($classReflection->getName(), null, $classReflection); $constructor = null; if ($classReflection->hasConstructor()) { $constructor = $classReflection->getConstructor(); } $methods = []; foreach ($node->getMethods() as $method) { if (!$method->getNode()->isPrivate()) { continue; } if ($method->isDeclaredInTrait()) { continue; } $methodName = $method->getNode()->name->toString(); if ($constructor !== null && $constructor->getName() === $methodName) { continue; } if (strtolower($methodName) === '__clone') { continue; } $methodReflection = $classReflection->getNativeMethod($methodName); foreach ($this->extensionProvider->getExtensions() as $extension) { if ($extension->isAlwaysUsed($methodReflection)) { continue 2; } } $methods[strtolower($methodName)] = $method; } $arrayCalls = []; foreach ($node->getMethodCalls() as $methodCall) { $methodCallNode = $methodCall->getNode(); if ($methodCallNode instanceof Node\Expr\Array_) { $arrayCalls[] = $methodCall; continue; } $callScope = $methodCall->getScope(); if ($methodCallNode->name instanceof Identifier) { $methodNames = [$methodCallNode->name->toString()]; } else { $methodNameType = $callScope->getType($methodCallNode->name); $strings = $methodNameType->getConstantStrings(); if (count($strings) === 0) { // handle subtractions of a dynamic method call foreach ($methods as $lowerMethodName => $method) { if ((new ConstantStringType($method->getNode()->name->toString()))->isSuperTypeOf($methodNameType)->no()) { continue; } unset($methods[$lowerMethodName]); } continue; } $methodNames = array_map(static function (ConstantStringType $type) : string { return $type->getValue(); }, $strings); } if ($methodCallNode instanceof Node\Expr\MethodCall) { $calledOnType = $callScope->getType($methodCallNode->var); } else { if ($methodCallNode->class instanceof Node\Name) { $calledOnType = $callScope->resolveTypeByName($methodCallNode->class); } else { $calledOnType = $callScope->getType($methodCallNode->class); } } $inMethod = $callScope->getFunction(); if (!$inMethod instanceof MethodReflection) { continue; } foreach ($methodNames as $methodName) { $methodReflection = $callScope->getMethodReflection($calledOnType, $methodName); if ($methodReflection === null) { if (!$classType->isSuperTypeOf($calledOnType)->no()) { unset($methods[strtolower($methodName)]); } continue; } if ($methodReflection->getDeclaringClass()->getName() !== $classReflection->getName()) { if (!$classType->isSuperTypeOf($calledOnType)->no()) { unset($methods[strtolower($methodName)]); } continue; } if ($inMethod->getName() === $methodName) { continue; } unset($methods[strtolower($methodName)]); } } if (count($methods) > 0) { foreach ($arrayCalls as $arrayCall) { /** @var Node\Expr\Array_ $array */ $array = $arrayCall->getNode(); $arrayScope = $arrayCall->getScope(); $arrayType = $arrayScope->getType($array); if (!$arrayType->isCallable()->yes()) { continue; } foreach ($arrayType->getConstantArrays() as $constantArray) { foreach ($constantArray->findTypeAndMethodNames() as $typeAndMethod) { if ($typeAndMethod->isUnknown()) { return []; } if (!$typeAndMethod->getCertainty()->yes()) { return []; } $calledOnType = $typeAndMethod->getType(); $methodReflection = $arrayScope->getMethodReflection($calledOnType, $typeAndMethod->getMethod()); if ($methodReflection === null) { continue; } if ($methodReflection->getDeclaringClass()->getName() !== $classReflection->getName()) { continue; } $inMethod = $arrayScope->getFunction(); if (!$inMethod instanceof MethodReflection) { continue; } if ($inMethod->getName() === $typeAndMethod->getMethod()) { continue; } unset($methods[strtolower($typeAndMethod->getMethod())]); } } } } $errors = []; foreach ($methods as $method) { $originalMethodName = $method->getNode()->name->toString(); $methodType = 'Method'; if ($method->getNode()->isStatic()) { $methodType = 'Static method'; } $errors[] = RuleErrorBuilder::message(sprintf('%s %s::%s() is unused.', $methodType, $classReflection->getDisplayName(), $originalMethodName))->line($method->getNode()->getStartLine())->identifier('method.unused')->build(); } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\DeadCode; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Collectors\Collector; use PHPStan\Node\MethodReturnStatementsNode; use function count; /** * @implements Collector<MethodReturnStatementsNode, string> */ final class ConstructorWithoutImpurePointsCollector implements Collector { public function getNodeType() : string { return MethodReturnStatementsNode::class; } public function processNode(Node $node, Scope $scope) { $method = $node->getMethodReflection(); if (!$method->isConstructor()) { return null; } if (!$method->isPure()->maybe()) { return null; } if (count($node->getImpurePoints()) !== 0) { return null; } if (count($node->getStatementResult()->getThrowPoints()) !== 0) { return null; } foreach ($method->getParameters() as $parameter) { if (!$parameter->passedByReference()->createsNewVariable()) { continue; } return null; } if (count($method->getAsserts()->getAll()) !== 0) { return null; } return $method->getDeclaringClass()->getName(); } } <?php declare (strict_types=1); namespace PHPStan\Rules\DeadCode; use PhpParser\Node; use PhpParser\Node\Stmt\Expression; use PHPStan\Analyser\Scope; use PHPStan\Collectors\Collector; use PHPStan\Reflection\ReflectionProvider; use function strtolower; /** * @implements Collector<Expression, array{string, int}> */ final class PossiblyPureNewCollector implements Collector { /** * @var ReflectionProvider */ private $reflectionProvider; public function __construct(ReflectionProvider $reflectionProvider) { $this->reflectionProvider = $reflectionProvider; } public function getNodeType() : string { return Expression::class; } public function processNode(Node $node, Scope $scope) { if (!$node->expr instanceof Node\Expr\New_) { return null; } if (!$node->expr->class instanceof Node\Name) { return null; } $className = $node->expr->class->toString(); if (!$this->reflectionProvider->hasClass($className)) { return null; } $classReflection = $this->reflectionProvider->getClass($className); if (!$classReflection->hasConstructor()) { return null; } $constructor = $classReflection->getConstructor(); if (strtolower($constructor->getName()) !== '__construct') { return null; } if (!$constructor->isPure()->maybe()) { return null; } return [$constructor->getDeclaringClass()->getName(), $node->getStartLine()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\DeadCode; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Collectors\Collector; use PHPStan\Node\FunctionReturnStatementsNode; use function count; /** * @implements Collector<FunctionReturnStatementsNode, string> */ final class FunctionWithoutImpurePointsCollector implements Collector { public function getNodeType() : string { return FunctionReturnStatementsNode::class; } public function processNode(Node $node, Scope $scope) { $function = $node->getFunctionReflection(); if (!$function->isPure()->maybe()) { return null; } if (!$function->hasSideEffects()->maybe()) { return null; } if (count($node->getImpurePoints()) !== 0) { return null; } if (count($node->getStatementResult()->getThrowPoints()) !== 0) { return null; } foreach ($function->getParameters() as $parameter) { if (!$parameter->passedByReference()->createsNewVariable()) { continue; } return null; } if (count($function->getAsserts()->getAll()) !== 0) { return null; } return $function->getName(); } } <?php declare (strict_types=1); namespace PHPStan\Rules; /** @api */ interface IdentifierRuleError extends \PHPStan\Rules\RuleError { public function getIdentifier() : string; } <?php declare (strict_types=1); namespace PHPStan\Rules\Methods; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\InClassMethodNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function sprintf; /** @implements Rule<InClassMethodNode> */ final class MethodVisibilityInInterfaceRule implements Rule { public function getNodeType() : string { return InClassMethodNode::class; } public function processNode(Node $node, Scope $scope) : array { $method = $node->getMethodReflection(); if ($method->isPublic()) { return []; } $classReflection = $scope->getClassReflection(); if ($classReflection === null) { return []; } if (!$classReflection->isInterface()) { return []; } return [RuleErrorBuilder::message(sprintf('Method %s::%s() cannot use non-public visibility in interface.', $method->getDeclaringClass()->getDisplayName(), $method->getName()))->identifier('method.visibility')->nonIgnorable()->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Methods; use DOMDocument; use PhpParser\Node\Expr; use PhpParser\Node\Name; use PHPStan\Analyser\NullsafeOperatorHelper; use PHPStan\Analyser\Scope; use PHPStan\Internal\SprintfHelper; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\MethodReflection; use PHPStan\Reflection\Native\NativeMethodReflection; use PHPStan\Reflection\Php\PhpMethodReflection; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\ClassNameCheck; use PHPStan\Rules\ClassNameNodePair; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Rules\RuleLevelHelper; use PHPStan\ShouldNotHappenException; use PHPStan\TrinaryLogic; use PHPStan\Type\ErrorType; use PHPStan\Type\Generic\GenericClassStringType; use PHPStan\Type\StaticType; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\VerbosityLevel; use function array_merge; use function in_array; use function sprintf; use function strtolower; final class StaticMethodCallCheck { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var RuleLevelHelper */ private $ruleLevelHelper; /** * @var ClassNameCheck */ private $classCheck; /** * @var bool */ private $checkFunctionNameCase; /** * @var bool */ private $reportMagicMethods; public function __construct(ReflectionProvider $reflectionProvider, RuleLevelHelper $ruleLevelHelper, ClassNameCheck $classCheck, bool $checkFunctionNameCase, bool $reportMagicMethods) { $this->reflectionProvider = $reflectionProvider; $this->ruleLevelHelper = $ruleLevelHelper; $this->classCheck = $classCheck; $this->checkFunctionNameCase = $checkFunctionNameCase; $this->reportMagicMethods = $reportMagicMethods; } /** * @param Name|Expr $class * @return array{list<IdentifierRuleError>, ExtendedMethodReflection|null} */ public function check(Scope $scope, string $methodName, $class) : array { $errors = []; $isAbstract = \false; if ($class instanceof Name) { $classStringType = $scope->getType(new Expr\ClassConstFetch($class, 'class')); if ($classStringType->hasMethod($methodName)->yes()) { return [[], null]; } $className = (string) $class; $lowercasedClassName = strtolower($className); if (in_array($lowercasedClassName, ['self', 'static'], \true)) { if (!$scope->isInClass()) { return [[RuleErrorBuilder::message(sprintf('Calling %s::%s() outside of class scope.', $className, $methodName))->identifier(sprintf('outOfClass.%s', $lowercasedClassName))->build()], null]; } $classType = $scope->resolveTypeByName($class); } elseif ($lowercasedClassName === 'parent') { if (!$scope->isInClass()) { return [[RuleErrorBuilder::message(sprintf('Calling %s::%s() outside of class scope.', $className, $methodName))->identifier(sprintf('outOfClass.parent'))->build()], null]; } $currentClassReflection = $scope->getClassReflection(); if ($currentClassReflection->getParentClass() === null) { return [[RuleErrorBuilder::message(sprintf('%s::%s() calls parent::%s() but %s does not extend any class.', $scope->getClassReflection()->getDisplayName(), $scope->getFunctionName(), $methodName, $scope->getClassReflection()->getDisplayName()))->identifier('class.noParent')->build()], null]; } if ($scope->getFunctionName() === null) { throw new ShouldNotHappenException(); } $classType = $scope->resolveTypeByName($class); } else { if (!$this->reflectionProvider->hasClass($className)) { if ($scope->isInClassExists($className)) { return [[], null]; } return [[RuleErrorBuilder::message(sprintf('Call to static method %s() on an unknown class %s.', $methodName, $className))->identifier('class.notFound')->discoveringSymbolsTip()->build()], null]; } $errors = $this->classCheck->checkClassNames([new ClassNameNodePair($className, $class)]); $classType = $scope->resolveTypeByName($class); } $classReflection = $classType->getClassReflection(); if ($classReflection !== null && $classReflection->hasNativeMethod($methodName) && $lowercasedClassName !== 'static') { $nativeMethodReflection = $classReflection->getNativeMethod($methodName); if ($nativeMethodReflection instanceof PhpMethodReflection || $nativeMethodReflection instanceof NativeMethodReflection) { $isAbstract = $nativeMethodReflection->isAbstract(); if ($isAbstract instanceof TrinaryLogic) { $isAbstract = $isAbstract->yes(); } } } } else { $classTypeResult = $this->ruleLevelHelper->findTypeToCheck($scope, NullsafeOperatorHelper::getNullsafeShortcircuitedExprRespectingScope($scope, $class), sprintf('Call to static method %s() on an unknown class %%s.', SprintfHelper::escapeFormatString($methodName)), static function (Type $type) use($methodName) : bool { return $type->canCallMethods()->yes() && $type->hasMethod($methodName)->yes(); }); $classType = $classTypeResult->getType(); if ($classType instanceof ErrorType) { return [$classTypeResult->getUnknownClassErrors(), null]; } } if ($classType instanceof GenericClassStringType) { $classType = $classType->getGenericType(); if (!$classType->isObject()->yes()) { return [[], null]; } } elseif ($classType->isString()->yes()) { return [[], null]; } $typeForDescribe = $classType; if ($classType instanceof StaticType) { $typeForDescribe = $classType->getStaticObjectType(); } $classType = TypeCombinator::remove($classType, new StringType()); if (!$classType->canCallMethods()->yes()) { return [array_merge($errors, [RuleErrorBuilder::message(sprintf('Cannot call static method %s() on %s.', $methodName, $typeForDescribe->describe(VerbosityLevel::typeOnly())))->identifier('staticMethod.nonObject')->build()]), null]; } if (!$classType->hasMethod($methodName)->yes()) { if (!$this->reportMagicMethods) { foreach ($classType->getObjectClassNames() as $className) { if (!$this->reflectionProvider->hasClass($className)) { continue; } $classReflection = $this->reflectionProvider->getClass($className); if ($classReflection->hasNativeMethod('__callStatic')) { return [[], null]; } } } return [array_merge($errors, [RuleErrorBuilder::message(sprintf('Call to an undefined static method %s::%s().', $typeForDescribe->describe(VerbosityLevel::typeOnly()), $methodName))->identifier('staticMethod.notFound')->build()]), null]; } $method = $classType->getMethod($methodName, $scope); if (!$method->isStatic()) { $function = $scope->getFunction(); $scopeIsInMethodClassOrSubClass = TrinaryLogic::createFromBoolean($scope->isInClass())->lazyAnd($classType->getObjectClassNames(), static function (string $objectClassName) use($scope) { return TrinaryLogic::createFromBoolean($scope->isInClass() && ($scope->getClassReflection()->getName() === $objectClassName || $scope->getClassReflection()->isSubclassOf($objectClassName))); }); if (!$function instanceof MethodReflection || $function->isStatic() || $scopeIsInMethodClassOrSubClass->no()) { // per php-src docs, this method can be called statically, even if declared non-static if (strtolower($method->getName()) === 'loadhtml' && $method->getDeclaringClass()->getName() === DOMDocument::class) { return [[], null]; } return [array_merge($errors, [RuleErrorBuilder::message(sprintf('Static call to instance method %s::%s().', $method->getDeclaringClass()->getDisplayName(), $method->getName()))->identifier('method.staticCall')->build()]), $method]; } } if (!$scope->canCallMethod($method)) { $errors = array_merge($errors, [RuleErrorBuilder::message(sprintf('Call to %s %s %s() of class %s.', $method->isPrivate() ? 'private' : 'protected', $method->isStatic() ? 'static method' : 'method', $method->getName(), $method->getDeclaringClass()->getDisplayName()))->identifier(sprintf('staticMethod.%s', $method->isPrivate() ? 'private' : 'protected'))->build()]); } if ($isAbstract) { return [[RuleErrorBuilder::message(sprintf('Cannot call abstract%s method %s::%s().', $method->isStatic() ? ' static' : '', $method->getDeclaringClass()->getDisplayName(), $method->getName()))->identifier(sprintf('%s.callToAbstract', $method->isStatic() ? 'staticMethod' : 'method'))->build()], $method]; } $lowercasedMethodName = SprintfHelper::escapeFormatString(sprintf('%s %s', $method->isStatic() ? 'static method' : 'method', $method->getDeclaringClass()->getDisplayName() . '::' . $method->getName() . '()')); if ($this->checkFunctionNameCase && $method->getName() !== $methodName) { $errors[] = RuleErrorBuilder::message(sprintf('Call to %s with incorrect case: %s', $lowercasedMethodName, $methodName))->identifier('staticMethod.nameCase')->build(); } return [$errors, $method]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Methods; use PHPStan\DependencyInjection\Container; final class LazyAlwaysUsedMethodExtensionProvider implements \PHPStan\Rules\Methods\AlwaysUsedMethodExtensionProvider { /** * @var Container */ private $container; /** @var AlwaysUsedMethodExtension[]|null */ private $extensions = null; public function __construct(Container $container) { $this->container = $container; } public function getExtensions() : array { return $this->extensions = $this->extensions ?? $this->container->getServicesByTag(static::EXTENSION_TAG); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Methods; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Internal\SprintfHelper; use PHPStan\Node\InClassMethodNode; use PHPStan\Rules\FunctionDefinitionCheck; use PHPStan\Rules\Rule; use function sprintf; /** * @implements Rule<InClassMethodNode> */ final class ExistingClassesInTypehintsRule implements Rule { /** * @var FunctionDefinitionCheck */ private $check; public function __construct(FunctionDefinitionCheck $check) { $this->check = $check; } public function getNodeType() : string { return InClassMethodNode::class; } public function processNode(Node $node, Scope $scope) : array { $methodReflection = $node->getMethodReflection(); $className = SprintfHelper::escapeFormatString($node->getClassReflection()->getDisplayName()); $methodName = SprintfHelper::escapeFormatString($methodReflection->getName()); return $this->check->checkClassMethod($methodReflection, $node->getOriginalNode(), sprintf('Parameter $%%s of method %s::%s() has invalid type %%s.', $className, $methodName), sprintf('Method %s::%s() has invalid return type %%s.', $className, $methodName), sprintf('Method %s::%s() uses native union types but they\'re supported only on PHP 8.0 and later.', $className, $methodName), sprintf('Template type %%s of method %s::%s() is not referenced in a parameter.', $className, $methodName), sprintf('Parameter $%%s of method %s::%s() has unresolvable native type.', $className, $methodName), sprintf('Method %s::%s() has unresolvable native return type.', $className, $methodName), sprintf('Method %s::%s() has invalid @phpstan-self-out type %%s.', $className, $methodName)); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Methods; use PhpParser\Node; use PhpParser\Node\Expr\MethodCall; use PHPStan\Analyser\Scope; use PHPStan\Internal\SprintfHelper; use PHPStan\Reflection\ParametersAcceptorSelector; use PHPStan\Rules\FunctionCallParametersCheck; use PHPStan\Rules\Rule; use function array_merge; /** * @implements Rule<Node\Expr\MethodCall> */ final class CallMethodsRule implements Rule { /** * @var MethodCallCheck */ private $methodCallCheck; /** * @var FunctionCallParametersCheck */ private $parametersCheck; public function __construct(\PHPStan\Rules\Methods\MethodCallCheck $methodCallCheck, FunctionCallParametersCheck $parametersCheck) { $this->methodCallCheck = $methodCallCheck; $this->parametersCheck = $parametersCheck; } public function getNodeType() : string { return MethodCall::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->name instanceof Node\Identifier) { return []; } $methodName = $node->name->name; [$errors, $methodReflection] = $this->methodCallCheck->check($scope, $methodName, $node->var); if ($methodReflection === null) { return $errors; } $declaringClass = $methodReflection->getDeclaringClass(); $messagesMethodName = SprintfHelper::escapeFormatString($declaringClass->getDisplayName() . '::' . $methodReflection->getName() . '()'); return array_merge($errors, $this->parametersCheck->check(ParametersAcceptorSelector::selectFromArgs($scope, $node->getArgs(), $methodReflection->getVariants(), $methodReflection->getNamedArgumentsVariants()), $scope, $declaringClass->isBuiltin(), $node, ['Method ' . $messagesMethodName . ' invoked with %d parameter, %d required.', 'Method ' . $messagesMethodName . ' invoked with %d parameters, %d required.', 'Method ' . $messagesMethodName . ' invoked with %d parameter, at least %d required.', 'Method ' . $messagesMethodName . ' invoked with %d parameters, at least %d required.', 'Method ' . $messagesMethodName . ' invoked with %d parameter, %d-%d required.', 'Method ' . $messagesMethodName . ' invoked with %d parameters, %d-%d required.', 'Parameter %s of method ' . $messagesMethodName . ' expects %s, %s given.', 'Result of method ' . $messagesMethodName . ' (void) is used.', 'Parameter %s of method ' . $messagesMethodName . ' is passed by reference, so it expects variables only.', 'Unable to resolve the template type %s in call to method ' . $messagesMethodName, 'Missing parameter $%s in call to method ' . $messagesMethodName . '.', 'Unknown parameter $%s in call to method ' . $messagesMethodName . '.', 'Return type of call to method ' . $messagesMethodName . ' contains unresolvable type.', 'Parameter %s of method ' . $messagesMethodName . ' contains unresolvable type.', 'Method ' . $messagesMethodName . ' invoked with %s, but it\'s not allowed because of @no-named-arguments.'], 'method', $methodReflection->acceptsNamedArguments())); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Methods; interface AlwaysUsedMethodExtensionProvider { public const EXTENSION_TAG = 'phpstan.methods.alwaysUsedMethodExtension'; /** * @return AlwaysUsedMethodExtension[] */ public function getExtensions() : array; } <?php declare (strict_types=1); namespace PHPStan\Rules\Methods; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; /** * @implements Rule<Node\Expr\MethodCall> */ final class IllegalConstructorMethodCallRule implements Rule { public function getNodeType() : string { return Node\Expr\MethodCall::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->name instanceof Node\Identifier || $node->name->toLowerString() !== '__construct') { return []; } return [RuleErrorBuilder::message('Call to __construct() on an existing object is not allowed.')->identifier('constructor.call')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Methods; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\InClassMethodNode; use PHPStan\Php\PhpVersion; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function sprintf; /** @implements Rule<InClassMethodNode> */ final class FinalPrivateMethodRule implements Rule { /** * @var PhpVersion */ private $phpVersion; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; } public function getNodeType() : string { return InClassMethodNode::class; } public function processNode(Node $node, Scope $scope) : array { $method = $node->getMethodReflection(); if (!$this->phpVersion->producesWarningForFinalPrivateMethods()) { return []; } if ($method->getName() === '__construct') { return []; } if (!$method->isFinal()->yes() || !$method->isPrivate()) { return []; } return [RuleErrorBuilder::message(sprintf('Private method %s::%s() cannot be final as it is never overridden by other classes.', $method->getDeclaringClass()->getDisplayName(), $method->getName()))->identifier('method.finalPrivate')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Methods; use PhpParser\Node; use PhpParser\Node\Expr\StaticCall; use PHPStan\Analyser\Scope; use PHPStan\Internal\SprintfHelper; use PHPStan\Reflection\ParametersAcceptorSelector; use PHPStan\Rules\FunctionCallParametersCheck; use PHPStan\Rules\Rule; use function array_merge; use function sprintf; /** * @implements Rule<Node\Expr\StaticCall> */ final class CallStaticMethodsRule implements Rule { /** * @var StaticMethodCallCheck */ private $methodCallCheck; /** * @var FunctionCallParametersCheck */ private $parametersCheck; public function __construct(\PHPStan\Rules\Methods\StaticMethodCallCheck $methodCallCheck, FunctionCallParametersCheck $parametersCheck) { $this->methodCallCheck = $methodCallCheck; $this->parametersCheck = $parametersCheck; } public function getNodeType() : string { return StaticCall::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->name instanceof Node\Identifier) { return []; } $methodName = $node->name->name; [$errors, $method] = $this->methodCallCheck->check($scope, $methodName, $node->class); if ($method === null) { return $errors; } $displayMethodName = SprintfHelper::escapeFormatString(sprintf('%s %s', $method->isStatic() ? 'Static method' : 'Method', $method->getDeclaringClass()->getDisplayName() . '::' . $method->getName() . '()')); $lowercasedMethodName = SprintfHelper::escapeFormatString(sprintf('%s %s', $method->isStatic() ? 'static method' : 'method', $method->getDeclaringClass()->getDisplayName() . '::' . $method->getName() . '()')); $errors = array_merge($errors, $this->parametersCheck->check(ParametersAcceptorSelector::selectFromArgs($scope, $node->getArgs(), $method->getVariants(), $method->getNamedArgumentsVariants()), $scope, $method->getDeclaringClass()->isBuiltin(), $node, [$displayMethodName . ' invoked with %d parameter, %d required.', $displayMethodName . ' invoked with %d parameters, %d required.', $displayMethodName . ' invoked with %d parameter, at least %d required.', $displayMethodName . ' invoked with %d parameters, at least %d required.', $displayMethodName . ' invoked with %d parameter, %d-%d required.', $displayMethodName . ' invoked with %d parameters, %d-%d required.', 'Parameter %s of ' . $lowercasedMethodName . ' expects %s, %s given.', 'Result of ' . $lowercasedMethodName . ' (void) is used.', 'Parameter %s of ' . $lowercasedMethodName . ' is passed by reference, so it expects variables only.', 'Unable to resolve the template type %s in call to method ' . $lowercasedMethodName, 'Missing parameter $%s in call to ' . $lowercasedMethodName . '.', 'Unknown parameter $%s in call to ' . $lowercasedMethodName . '.', 'Return type of call to ' . $lowercasedMethodName . ' contains unresolvable type.', 'Parameter %s of ' . $lowercasedMethodName . ' contains unresolvable type.', $displayMethodName . ' invoked with %s, but it\'s not allowed because of @no-named-arguments.'], 'staticMethod', $method->acceptsNamedArguments())); return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Methods; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function array_key_exists; use function array_map; use function in_array; use function sprintf; use function strtolower; /** * @implements Rule<Node\Expr\StaticCall> */ final class IllegalConstructorStaticCallRule implements Rule { public function getNodeType() : string { return Node\Expr\StaticCall::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->name instanceof Node\Identifier || $node->name->toLowerString() !== '__construct') { return []; } if ($this->isCollectCallingConstructor($node, $scope)) { return []; } return [RuleErrorBuilder::message('Static call to __construct() is only allowed on a parent class in the constructor.')->identifier('constructor.call')->build()]; } private function isCollectCallingConstructor(Node\Expr\StaticCall $node, Scope $scope) : bool { // __construct should be called from inside constructor if ($scope->getFunction() === null) { return \false; } if ($scope->getFunction()->getName() !== '__construct') { if (!$this->isInRenamedTraitConstructor($scope)) { return \false; } } if (!$scope->isInClass()) { return \false; } if (!$node->class instanceof Node\Name) { return \false; } $parentClasses = array_map(static function (string $name) { return strtolower($name); }, $scope->getClassReflection()->getParentClassesNames()); return in_array(strtolower($scope->resolveName($node->class)), $parentClasses, \true); } private function isInRenamedTraitConstructor(Scope $scope) : bool { if (!$scope->isInClass()) { return \false; } if (!$scope->isInTrait()) { return \false; } if ($scope->getFunction() === null) { return \false; } $traitAliases = $scope->getClassReflection()->getNativeReflection()->getTraitAliases(); $functionName = $scope->getFunction()->getName(); if (!array_key_exists($functionName, $traitAliases)) { return \false; } return $traitAliases[$functionName] === sprintf('%s::%s', $scope->getTraitReflection()->getName(), '__construct'); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Methods; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\InClassMethodNode; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\FunctionVariantWithPhpDocs; use PHPStan\Reflection\MethodPrototypeReflection; use PHPStan\Reflection\Native\NativeMethodReflection; use PHPStan\Reflection\Php\NativeBuiltinMethodReflection; use PHPStan\Reflection\Php\PhpClassReflectionExtension; use PHPStan\Reflection\Php\PhpMethodReflection; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\MixedType; use PHPStan\Type\VerbosityLevel; use function array_merge; use function count; use function is_bool; use function sprintf; use function strtolower; /** * @implements Rule<InClassMethodNode> */ final class OverridingMethodRule implements Rule { /** * @var PhpVersion */ private $phpVersion; /** * @var MethodSignatureRule */ private $methodSignatureRule; /** * @var bool */ private $checkPhpDocMethodSignatures; /** * @var MethodParameterComparisonHelper */ private $methodParameterComparisonHelper; /** * @var PhpClassReflectionExtension */ private $phpClassReflectionExtension; /** * @var bool */ private $genericPrototypeMessage; /** * @var bool */ private $finalByPhpDoc; /** * @var bool */ private $checkMissingOverrideMethodAttribute; public function __construct(PhpVersion $phpVersion, \PHPStan\Rules\Methods\MethodSignatureRule $methodSignatureRule, bool $checkPhpDocMethodSignatures, \PHPStan\Rules\Methods\MethodParameterComparisonHelper $methodParameterComparisonHelper, PhpClassReflectionExtension $phpClassReflectionExtension, bool $genericPrototypeMessage, bool $finalByPhpDoc, bool $checkMissingOverrideMethodAttribute) { $this->phpVersion = $phpVersion; $this->methodSignatureRule = $methodSignatureRule; $this->checkPhpDocMethodSignatures = $checkPhpDocMethodSignatures; $this->methodParameterComparisonHelper = $methodParameterComparisonHelper; $this->phpClassReflectionExtension = $phpClassReflectionExtension; $this->genericPrototypeMessage = $genericPrototypeMessage; $this->finalByPhpDoc = $finalByPhpDoc; $this->checkMissingOverrideMethodAttribute = $checkMissingOverrideMethodAttribute; } public function getNodeType() : string { return InClassMethodNode::class; } public function processNode(Node $node, Scope $scope) : array { $method = $node->getMethodReflection(); $prototypeData = $this->findPrototype($node->getClassReflection(), $method->getName()); if ($prototypeData === null) { if (strtolower($method->getName()) === '__construct') { $parent = $method->getDeclaringClass()->getParentClass(); if ($parent !== null && $parent->hasConstructor()) { $parentConstructor = $parent->getConstructor(); if ($parentConstructor->isFinalByKeyword()->yes()) { return $this->addErrors([RuleErrorBuilder::message(sprintf('Method %s::%s() overrides final method %s::%s().', $method->getDeclaringClass()->getDisplayName(), $method->getName(), $parent->getDisplayName($this->genericPrototypeMessage), $parentConstructor->getName()))->nonIgnorable()->identifier('method.parentMethodFinal')->build()], $node, $scope); } if ($parentConstructor->isFinal()->yes() && $this->finalByPhpDoc) { return $this->addErrors([RuleErrorBuilder::message(sprintf('Method %s::%s() overrides @final method %s::%s().', $method->getDeclaringClass()->getDisplayName(), $method->getName(), $parent->getDisplayName($this->genericPrototypeMessage), $parentConstructor->getName()))->identifier('method.parentMethodFinalByPhpDoc')->build()], $node, $scope); } } } if ($this->phpVersion->supportsOverrideAttribute() && $this->hasOverrideAttribute($node->getOriginalNode())) { return [RuleErrorBuilder::message(sprintf('Method %s::%s() has #[\\Override] attribute but does not override any method.', $method->getDeclaringClass()->getDisplayName(), $method->getName()))->nonIgnorable()->identifier('method.override')->build()]; } return []; } [$prototype, $prototypeDeclaringClass, $checkVisibility] = $prototypeData; $messages = []; if ($this->phpVersion->supportsOverrideAttribute() && $this->checkMissingOverrideMethodAttribute && !$this->hasOverrideAttribute($node->getOriginalNode())) { $messages[] = RuleErrorBuilder::message(sprintf('Method %s::%s() overrides method %s::%s() but is missing the #[\\Override] attribute.', $method->getDeclaringClass()->getDisplayName(), $method->getName(), $prototypeDeclaringClass->getDisplayName($this->genericPrototypeMessage), $prototype->getName()))->identifier('method.missingOverride')->build(); } if ($prototype->isFinalByKeyword()->yes()) { $messages[] = RuleErrorBuilder::message(sprintf('Method %s::%s() overrides final method %s::%s().', $method->getDeclaringClass()->getDisplayName(), $method->getName(), $prototypeDeclaringClass->getDisplayName($this->genericPrototypeMessage), $prototype->getName()))->nonIgnorable()->identifier('method.parentMethodFinal')->build(); } elseif ($prototype->isFinal()->yes() && $this->finalByPhpDoc) { $messages[] = RuleErrorBuilder::message(sprintf('Method %s::%s() overrides @final method %s::%s().', $method->getDeclaringClass()->getDisplayName(), $method->getName(), $prototypeDeclaringClass->getDisplayName($this->genericPrototypeMessage), $prototype->getName()))->identifier('method.parentMethodFinalByPhpDoc')->build(); } if ($prototype->isStatic()) { if (!$method->isStatic()) { $messages[] = RuleErrorBuilder::message(sprintf('Non-static method %s::%s() overrides static method %s::%s().', $method->getDeclaringClass()->getDisplayName(), $method->getName(), $prototypeDeclaringClass->getDisplayName($this->genericPrototypeMessage), $prototype->getName()))->nonIgnorable()->identifier('method.nonStatic')->build(); } } elseif ($method->isStatic()) { $messages[] = RuleErrorBuilder::message(sprintf('Static method %s::%s() overrides non-static method %s::%s().', $method->getDeclaringClass()->getDisplayName(), $method->getName(), $prototypeDeclaringClass->getDisplayName($this->genericPrototypeMessage), $prototype->getName()))->nonIgnorable()->identifier('method.static')->build(); } if ($checkVisibility) { if ($prototype->isPublic()) { if (!$method->isPublic()) { $messages[] = RuleErrorBuilder::message(sprintf('%s method %s::%s() overriding public method %s::%s() should also be public.', $method->isPrivate() ? 'Private' : 'Protected', $method->getDeclaringClass()->getDisplayName(), $method->getName(), $prototypeDeclaringClass->getDisplayName($this->genericPrototypeMessage), $prototype->getName()))->nonIgnorable()->identifier('method.visibility')->build(); } } elseif ($method->isPrivate()) { $messages[] = RuleErrorBuilder::message(sprintf('Private method %s::%s() overriding protected method %s::%s() should be protected or public.', $method->getDeclaringClass()->getDisplayName(), $method->getName(), $prototypeDeclaringClass->getDisplayName($this->genericPrototypeMessage), $prototype->getName()))->nonIgnorable()->identifier('method.visibility')->build(); } } $prototypeVariants = $prototype->getVariants(); if (count($prototypeVariants) !== 1) { return $this->addErrors($messages, $node, $scope); } $prototypeVariant = $prototypeVariants[0]; $methodReturnType = $method->getNativeReturnType(); $realPrototype = $method->getPrototype(); if ($realPrototype instanceof MethodPrototypeReflection && $this->phpVersion->hasTentativeReturnTypes() && $realPrototype->getTentativeReturnType() !== null && !$this->hasReturnTypeWillChangeAttribute($node->getOriginalNode()) && count($prototypeDeclaringClass->getNativeReflection()->getMethod($prototype->getName())->getAttributes('ReturnTypeWillChange')) === 0) { if (!$this->methodParameterComparisonHelper->isReturnTypeCompatible($realPrototype->getTentativeReturnType(), $method->getNativeReturnType(), \true)) { $messages[] = RuleErrorBuilder::message(sprintf('Return type %s of method %s::%s() is not covariant with tentative return type %s of method %s::%s().', $methodReturnType->describe(VerbosityLevel::typeOnly()), $method->getDeclaringClass()->getDisplayName(), $method->getName(), $realPrototype->getTentativeReturnType()->describe(VerbosityLevel::typeOnly()), $realPrototype->getDeclaringClass()->getDisplayName($this->genericPrototypeMessage), $realPrototype->getName()))->tip('Make it covariant, or use the #[\\ReturnTypeWillChange] attribute to temporarily suppress the error.')->nonIgnorable()->identifier('method.tentativeReturnType')->build(); } } $messages = array_merge($messages, $this->methodParameterComparisonHelper->compare($prototype, $prototypeDeclaringClass, $method)); if (!$prototypeVariant instanceof FunctionVariantWithPhpDocs) { return $this->addErrors($messages, $node, $scope); } $prototypeReturnType = $prototypeVariant->getNativeReturnType(); $reportReturnType = \true; if ($this->phpVersion->hasTentativeReturnTypes()) { $reportReturnType = !$realPrototype instanceof MethodPrototypeReflection || $realPrototype->getTentativeReturnType() === null || $prototype->isInternal()->no(); } else { if ($realPrototype instanceof MethodPrototypeReflection && $realPrototype->isInternal()) { if ($prototype->isInternal()->yes() && $prototypeDeclaringClass->getName() !== $realPrototype->getDeclaringClass()->getName()) { $realPrototypeVariant = $realPrototype->getVariants()[0]; if ($prototypeReturnType instanceof MixedType && !$prototypeReturnType->isExplicitMixed() && (!$realPrototypeVariant->getReturnType() instanceof MixedType || $realPrototypeVariant->getReturnType()->isExplicitMixed())) { $reportReturnType = \false; } } if ($reportReturnType && $prototype->isInternal()->yes()) { $reportReturnType = !$this->hasReturnTypeWillChangeAttribute($node->getOriginalNode()); } } } if ($reportReturnType && !$this->methodParameterComparisonHelper->isReturnTypeCompatible($prototypeReturnType, $methodReturnType, $this->phpVersion->supportsReturnCovariance())) { if ($this->phpVersion->supportsReturnCovariance()) { $messages[] = RuleErrorBuilder::message(sprintf('Return type %s of method %s::%s() is not covariant with return type %s of method %s::%s().', $methodReturnType->describe(VerbosityLevel::typeOnly()), $method->getDeclaringClass()->getDisplayName(), $method->getName(), $prototypeReturnType->describe(VerbosityLevel::typeOnly()), $prototypeDeclaringClass->getDisplayName($this->genericPrototypeMessage), $prototype->getName()))->nonIgnorable()->identifier('method.childReturnType')->build(); } else { $messages[] = RuleErrorBuilder::message(sprintf('Return type %s of method %s::%s() is not compatible with return type %s of method %s::%s().', $methodReturnType->describe(VerbosityLevel::typeOnly()), $method->getDeclaringClass()->getDisplayName(), $method->getName(), $prototypeReturnType->describe(VerbosityLevel::typeOnly()), $prototypeDeclaringClass->getDisplayName($this->genericPrototypeMessage), $prototype->getName()))->nonIgnorable()->identifier('method.childReturnType')->build(); } } return $this->addErrors($messages, $node, $scope); } /** * @param list<IdentifierRuleError> $errors * @return list<IdentifierRuleError> */ private function addErrors(array $errors, InClassMethodNode $classMethod, Scope $scope) : array { if (count($errors) > 0) { return $errors; } if (!$this->checkPhpDocMethodSignatures) { return $errors; } return $this->methodSignatureRule->processNode($classMethod, $scope); } private function hasReturnTypeWillChangeAttribute(Node\Stmt\ClassMethod $method) : bool { foreach ($method->attrGroups as $attrGroup) { foreach ($attrGroup->attrs as $attr) { if ($attr->name->toLowerString() === 'returntypewillchange') { return \true; } } } return \false; } private function hasOverrideAttribute(Node\Stmt\ClassMethod $method) : bool { foreach ($method->attrGroups as $attrGroup) { foreach ($attrGroup->attrs as $attr) { if ($attr->name->toLowerString() === 'override') { return \true; } } } return \false; } /** * @return array{ExtendedMethodReflection, ClassReflection, bool}|null */ private function findPrototype(ClassReflection $classReflection, string $methodName) : ?array { foreach ($classReflection->getImmediateInterfaces() as $immediateInterface) { if ($immediateInterface->hasNativeMethod($methodName)) { $method = $immediateInterface->getNativeMethod($methodName); return [$method, $method->getDeclaringClass(), \true]; } } if ($this->phpVersion->supportsAbstractTraitMethods()) { foreach ($classReflection->getTraits(\true) as $trait) { $nativeTraitReflection = $trait->getNativeReflection(); if (!$nativeTraitReflection->hasMethod($methodName)) { continue; } $methodReflection = $nativeTraitReflection->getMethod($methodName); $isAbstract = $methodReflection->isAbstract(); if ($isAbstract) { $declaringTrait = $trait->getNativeMethod($methodName)->getDeclaringClass(); return [$this->phpClassReflectionExtension->createUserlandMethodReflection($trait, $classReflection, new NativeBuiltinMethodReflection($methodReflection), $declaringTrait->getName()), $declaringTrait, \false]; } } } $parentClass = $classReflection->getParentClass(); if ($parentClass === null) { return null; } if (!$parentClass->hasNativeMethod($methodName)) { return null; } $method = $parentClass->getNativeMethod($methodName); if ($method->isPrivate()) { return null; } $declaringClass = $method->getDeclaringClass(); if ($declaringClass->hasConstructor()) { if ($method->getName() === $declaringClass->getConstructor()->getName()) { $prototype = $method->getPrototype(); if ($prototype instanceof PhpMethodReflection || $prototype instanceof MethodPrototypeReflection || $prototype instanceof NativeMethodReflection) { $abstract = $prototype->isAbstract(); if (is_bool($abstract)) { if (!$abstract) { return null; } } elseif (!$abstract->yes()) { return null; } } } elseif (strtolower($methodName) === '__construct') { return null; } } return [$method, $method->getDeclaringClass(), \true]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Methods; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\InClassMethodNode; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\ParameterReflectionWithPhpDocs; use PHPStan\Reflection\ParametersAcceptorWithPhpDocs; use PHPStan\Reflection\Php\NativeBuiltinMethodReflection; use PHPStan\Reflection\Php\PhpClassReflectionExtension; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleError; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\TrinaryLogic; use PHPStan\Type\Accessory\AccessoryArrayListType; use PHPStan\Type\ArrayType; use PHPStan\Type\Generic\GenericStaticType; use PHPStan\Type\Generic\TemplateTypeHelper; use PHPStan\Type\IntegerRangeType; use PHPStan\Type\IntersectionType; use PHPStan\Type\MixedType; use PHPStan\Type\ObjectType; use PHPStan\Type\StaticType; use PHPStan\Type\Type; use PHPStan\Type\TypehintHelper; use PHPStan\Type\TypeTraverser; use PHPStan\Type\VerbosityLevel; use function count; use function min; use function sprintf; use function strtolower; /** * @implements Rule<InClassMethodNode> */ final class MethodSignatureRule implements Rule { /** * @var PhpClassReflectionExtension */ private $phpClassReflectionExtension; /** * @var bool */ private $reportMaybes; /** * @var bool */ private $reportStatic; /** * @var bool */ private $abstractTraitMethod; public function __construct(PhpClassReflectionExtension $phpClassReflectionExtension, bool $reportMaybes, bool $reportStatic, bool $abstractTraitMethod) { $this->phpClassReflectionExtension = $phpClassReflectionExtension; $this->reportMaybes = $reportMaybes; $this->reportStatic = $reportStatic; $this->abstractTraitMethod = $abstractTraitMethod; } public function getNodeType() : string { return InClassMethodNode::class; } public function processNode(Node $node, Scope $scope) : array { $method = $node->getMethodReflection(); $methodName = $method->getName(); if ($methodName === '__construct') { return []; } if (!$this->reportStatic && $method->isStatic()) { return []; } if ($method->isPrivate()) { return []; } $errors = []; $declaringClass = $method->getDeclaringClass(); foreach ($this->collectParentMethods($methodName, $method->getDeclaringClass()) as [$parentMethod, $parentMethodDeclaringClass]) { $parentVariants = $parentMethod->getVariants(); if (count($parentVariants) !== 1) { continue; } $parentVariant = $parentVariants[0]; [$returnTypeCompatibility, $returnType, $parentReturnType] = $this->checkReturnTypeCompatibility($declaringClass, $method, $parentVariant); if ($returnTypeCompatibility->no() || !$returnTypeCompatibility->yes() && $this->reportMaybes) { $builder = RuleErrorBuilder::message(sprintf('Return type (%s) of method %s::%s() should be %s with return type (%s) of method %s::%s()', $returnType->describe(VerbosityLevel::value()), $method->getDeclaringClass()->getDisplayName(), $method->getName(), $returnTypeCompatibility->no() ? 'compatible' : 'covariant', $parentReturnType->describe(VerbosityLevel::value()), $parentMethodDeclaringClass->getDisplayName(), $parentMethod->getName()))->identifier('method.childReturnType'); if ($parentMethod->getDeclaringClass()->getName() === Rule::class && strtolower($methodName) === 'processnode') { $ruleErrorType = new ObjectType(RuleError::class); $identifierRuleErrorType = new ObjectType(IdentifierRuleError::class); $listOfIdentifierRuleErrors = new IntersectionType([new ArrayType(IntegerRangeType::fromInterval(0, null), $identifierRuleErrorType), new AccessoryArrayListType()]); if ($listOfIdentifierRuleErrors->isSuperTypeOf($parentReturnType)->yes()) { $returnValueType = $returnType->getIterableValueType(); if (!$returnValueType->isString()->no()) { $builder->tip('Rules can no longer return plain strings. See: https://phpstan.org/blog/using-rule-error-builder'); } elseif ($ruleErrorType->isSuperTypeOf($returnValueType)->yes() && !$identifierRuleErrorType->isSuperTypeOf($returnValueType)->yes()) { $builder->tip('Errors are missing identifiers. See: https://phpstan.org/blog/using-rule-error-builder'); } elseif (!$returnType->isList()->yes()) { $builder->tip('Return type must be a list. See: https://phpstan.org/blog/using-rule-error-builder'); } } } $errors[] = $builder->build(); } $parameterResults = $this->checkParameterTypeCompatibility($declaringClass, $method->getParameters(), $parentVariant->getParameters()); foreach ($parameterResults as $parameterIndex => [$parameterResult, $parameterType, $parentParameterType]) { if ($parameterResult->yes()) { continue; } if (!$parameterResult->no() && !$this->reportMaybes) { continue; } $parameter = $method->getParameters()[$parameterIndex]; $parentParameter = $parentVariant->getParameters()[$parameterIndex]; $errors[] = RuleErrorBuilder::message(sprintf('Parameter #%d $%s (%s) of method %s::%s() should be %s with parameter $%s (%s) of method %s::%s()', $parameterIndex + 1, $parameter->getName(), $parameterType->describe(VerbosityLevel::value()), $method->getDeclaringClass()->getDisplayName(), $method->getName(), $parameterResult->no() ? 'compatible' : 'contravariant', $parentParameter->getName(), $parentParameterType->describe(VerbosityLevel::value()), $parentMethodDeclaringClass->getDisplayName(), $parentMethod->getName()))->identifier('method.childParameterType')->build(); } } return $errors; } /** * @return list<array{ExtendedMethodReflection, ClassReflection}> */ private function collectParentMethods(string $methodName, ClassReflection $class) : array { $parentMethods = []; $parentClass = $class->getParentClass(); if ($parentClass !== null && $parentClass->hasNativeMethod($methodName)) { $parentMethod = $parentClass->getNativeMethod($methodName); if (!$parentMethod->isPrivate()) { $parentMethods[] = [$parentMethod, $parentMethod->getDeclaringClass()]; } } foreach ($class->getInterfaces() as $interface) { if (!$interface->hasNativeMethod($methodName)) { continue; } $method = $interface->getNativeMethod($methodName); $parentMethods[] = [$method, $method->getDeclaringClass()]; } if ($this->abstractTraitMethod) { foreach ($class->getTraits(\true) as $trait) { $nativeTraitReflection = $trait->getNativeReflection(); if (!$nativeTraitReflection->hasMethod($methodName)) { continue; } $methodReflection = $nativeTraitReflection->getMethod($methodName); $isAbstract = $methodReflection->isAbstract(); if (!$isAbstract) { continue; } $declaringTrait = $trait->getNativeMethod($methodName)->getDeclaringClass(); $parentMethods[] = [$this->phpClassReflectionExtension->createUserlandMethodReflection($trait, $class, new NativeBuiltinMethodReflection($methodReflection), $declaringTrait->getName()), $declaringTrait]; } } return $parentMethods; } /** * @return array{TrinaryLogic, Type, Type} */ private function checkReturnTypeCompatibility(ClassReflection $declaringClass, ParametersAcceptorWithPhpDocs $currentVariant, ParametersAcceptorWithPhpDocs $parentVariant) : array { $returnType = TypehintHelper::decideType($currentVariant->getNativeReturnType(), TemplateTypeHelper::resolveToBounds($currentVariant->getPhpDocReturnType())); $originalParentReturnType = TypehintHelper::decideType($parentVariant->getNativeReturnType(), TemplateTypeHelper::resolveToBounds($parentVariant->getPhpDocReturnType())); $parentReturnType = $this->transformStaticType($declaringClass, $originalParentReturnType); // Allow adding `void` return type hints when the parent defines no return type if ($returnType->isVoid()->yes() && $parentReturnType instanceof MixedType) { return [TrinaryLogic::createYes(), $returnType, $parentReturnType]; } // We can return anything if ($parentReturnType->isVoid()->yes()) { return [TrinaryLogic::createYes(), $returnType, $parentReturnType]; } return [$parentReturnType->isSuperTypeOf($returnType), TypehintHelper::decideType($currentVariant->getNativeReturnType(), $currentVariant->getPhpDocReturnType()), $originalParentReturnType]; } /** * @param ParameterReflectionWithPhpDocs[] $parameters * @param ParameterReflectionWithPhpDocs[] $parentParameters * @return array<int, array{TrinaryLogic, Type, Type}> */ private function checkParameterTypeCompatibility(ClassReflection $declaringClass, array $parameters, array $parentParameters) : array { $parameterResults = []; $numberOfParameters = min(count($parameters), count($parentParameters)); for ($i = 0; $i < $numberOfParameters; $i++) { $parameter = $parameters[$i]; $parentParameter = $parentParameters[$i]; $parameterType = TypehintHelper::decideType($parameter->getNativeType(), TemplateTypeHelper::resolveToBounds($parameter->getPhpDocType())); $originalParameterType = TypehintHelper::decideType($parentParameter->getNativeType(), TemplateTypeHelper::resolveToBounds($parentParameter->getPhpDocType())); $parentParameterType = $this->transformStaticType($declaringClass, $originalParameterType); $parameterResults[] = [$parameterType->isSuperTypeOf($parentParameterType), TypehintHelper::decideType($parameter->getNativeType(), $parameter->getPhpDocType()), $originalParameterType]; } return $parameterResults; } private function transformStaticType(ClassReflection $declaringClass, Type $type) : Type { return TypeTraverser::map($type, static function (Type $type, callable $traverse) use($declaringClass) : Type { if ($type instanceof GenericStaticType) { if ($declaringClass->isFinal()) { $changedType = $type->changeBaseClass($declaringClass)->getStaticObjectType(); } else { $changedType = $type->changeBaseClass($declaringClass); } return $traverse($changedType); } if ($type instanceof StaticType) { if ($declaringClass->isFinal()) { $changedType = new ObjectType($declaringClass->getName()); } else { $changedType = $type->changeBaseClass($declaringClass); } return $traverse($changedType); } return $traverse($type); }); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Methods; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\ShouldNotHappenException; use function in_array; use function sprintf; /** * @implements Rule<Node\Stmt\ClassMethod> */ final class AbstractMethodInNonAbstractClassRule implements Rule { public function getNodeType() : string { return Node\Stmt\ClassMethod::class; } public function processNode(Node $node, Scope $scope) : array { if (!$scope->isInClass()) { throw new ShouldNotHappenException(); } $class = $scope->getClassReflection(); if (!$class->isAbstract() && $node->isAbstract()) { if ($class->isEnum()) { $lowercasedMethodName = $node->name->toLowerString(); if ($lowercasedMethodName === 'cases') { return []; } if ($class->isBackedEnum()) { if (in_array($lowercasedMethodName, ['from', 'tryfrom'], \true)) { return []; } } } $description = $class->getClassTypeDescription(); return [RuleErrorBuilder::message(sprintf('%s %s contains abstract method %s().', $description === 'Class' ? 'Non-abstract class' : $description, $class->getDisplayName(), $node->name->toString()))->nonIgnorable()->identifier('method.abstract')->build()]; } if (!$class->isAbstract() && !$class->isInterface() && $node->getStmts() === null) { return [RuleErrorBuilder::message(sprintf('Non-abstract method %s::%s() must contain a body.', $class->getDisplayName(), $node->name->toString()))->nonIgnorable()->identifier('method.nonAbstract')->build()]; } return []; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Methods; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\Php\PhpMethodFromParserNodeReflection; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\ArrayType; use PHPStan\Type\IterableType; use PHPStan\Type\MixedType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\VerbosityLevel; use Traversable; use function array_key_exists; use function array_slice; use function count; use function sprintf; final class MethodParameterComparisonHelper { /** * @var PhpVersion */ private $phpVersion; /** * @var bool */ private $genericPrototypeMessage; public function __construct(PhpVersion $phpVersion, bool $genericPrototypeMessage) { $this->phpVersion = $phpVersion; $this->genericPrototypeMessage = $genericPrototypeMessage; } /** * @return list<IdentifierRuleError> */ public function compare(ExtendedMethodReflection $prototype, ClassReflection $prototypeDeclaringClass, PhpMethodFromParserNodeReflection $method, bool $ignorable = \false) : array { /** @var list<IdentifierRuleError> $messages */ $messages = []; $prototypeVariant = $prototype->getVariants()[0]; $methodParameters = $method->getParameters(); $prototypeAfterVariadic = \false; foreach ($prototypeVariant->getParameters() as $i => $prototypeParameter) { if (!array_key_exists($i, $methodParameters)) { $error = RuleErrorBuilder::message(sprintf('Method %s::%s() overrides method %s::%s() but misses parameter #%d $%s.', $method->getDeclaringClass()->getDisplayName(), $method->getName(), $prototypeDeclaringClass->getDisplayName($this->genericPrototypeMessage), $prototype->getName(), $i + 1, $prototypeParameter->getName()))->identifier('parameter.missing'); if (!$ignorable) { $error->nonIgnorable(); } $messages[] = $error->build(); continue; } $methodParameter = $methodParameters[$i]; if ($prototypeParameter->passedByReference()->no()) { if (!$methodParameter->passedByReference()->no()) { $error = RuleErrorBuilder::message(sprintf('Parameter #%d $%s of method %s::%s() is passed by reference but parameter #%d $%s of method %s::%s() is not passed by reference.', $i + 1, $methodParameter->getName(), $method->getDeclaringClass()->getDisplayName(), $method->getName(), $i + 1, $prototypeParameter->getName(), $prototypeDeclaringClass->getDisplayName($this->genericPrototypeMessage), $prototype->getName()))->identifier('parameter.byRef'); if (!$ignorable) { $error->nonIgnorable(); } $messages[] = $error->build(); } } elseif ($methodParameter->passedByReference()->no()) { $error = RuleErrorBuilder::message(sprintf('Parameter #%d $%s of method %s::%s() is not passed by reference but parameter #%d $%s of method %s::%s() is passed by reference.', $i + 1, $methodParameter->getName(), $method->getDeclaringClass()->getDisplayName(), $method->getName(), $i + 1, $prototypeParameter->getName(), $prototypeDeclaringClass->getDisplayName($this->genericPrototypeMessage), $prototype->getName()))->identifier('parameter.notByRef'); if (!$ignorable) { $error->nonIgnorable(); } $messages[] = $error->build(); } if ($prototypeParameter->isVariadic()) { $prototypeAfterVariadic = \true; if (!$methodParameter->isVariadic()) { if (!$methodParameter->isOptional()) { if (count($methodParameters) !== $i + 1) { $error = RuleErrorBuilder::message(sprintf('Parameter #%d $%s of method %s::%s() is not optional.', $i + 1, $methodParameter->getName(), $method->getDeclaringClass()->getDisplayName(), $method->getName()))->identifier('parameter.notOptional'); if (!$ignorable) { $error->nonIgnorable(); } $messages[] = $error->build(); continue; } $error = RuleErrorBuilder::message(sprintf('Parameter #%d $%s of method %s::%s() is not variadic but parameter #%d $%s of method %s::%s() is variadic.', $i + 1, $methodParameter->getName(), $method->getDeclaringClass()->getDisplayName(), $method->getName(), $i + 1, $prototypeParameter->getName(), $prototypeDeclaringClass->getDisplayName($this->genericPrototypeMessage), $prototype->getName()))->identifier('parameter.notVariadic'); if (!$ignorable) { $error->nonIgnorable(); } $messages[] = $error->build(); continue; } elseif (count($methodParameters) === $i + 1) { $error = RuleErrorBuilder::message(sprintf('Parameter #%d $%s of method %s::%s() is not variadic.', $i + 1, $methodParameter->getName(), $method->getDeclaringClass()->getDisplayName(), $method->getName()))->identifier('parameter.notVariadic'); if (!$ignorable) { $error->nonIgnorable(); } $messages[] = $error->build(); } } } elseif ($methodParameter->isVariadic()) { if ($this->phpVersion->supportsLessOverridenParametersWithVariadic()) { $remainingPrototypeParameters = array_slice($prototypeVariant->getParameters(), $i); foreach ($remainingPrototypeParameters as $j => $remainingPrototypeParameter) { if ($methodParameter->getNativeType()->isSuperTypeOf($remainingPrototypeParameter->getNativeType())->yes()) { continue; } $error = RuleErrorBuilder::message(sprintf('Parameter #%d ...$%s (%s) of method %s::%s() is not contravariant with parameter #%d $%s (%s) of method %s::%s().', $i + 1, $methodParameter->getName(), $methodParameter->getNativeType()->describe(VerbosityLevel::typeOnly()), $method->getDeclaringClass()->getDisplayName(), $method->getName(), $i + $j + 1, $remainingPrototypeParameter->getName(), $remainingPrototypeParameter->getNativeType()->describe(VerbosityLevel::typeOnly()), $prototypeDeclaringClass->getDisplayName($this->genericPrototypeMessage), $prototype->getName()))->identifier('method.childParameterType'); if (!$ignorable) { $error->nonIgnorable(); } $messages[] = $error->build(); } break; } $error = RuleErrorBuilder::message(sprintf('Parameter #%d $%s of method %s::%s() is variadic but parameter #%d $%s of method %s::%s() is not variadic.', $i + 1, $methodParameter->getName(), $method->getDeclaringClass()->getDisplayName(), $method->getName(), $i + 1, $prototypeParameter->getName(), $prototypeDeclaringClass->getDisplayName($this->genericPrototypeMessage), $prototype->getName()))->identifier('parameter.variadic'); if (!$ignorable) { $error->nonIgnorable(); } $messages[] = $error->build(); continue; } if ($prototypeParameter->isOptional() && !$methodParameter->isOptional()) { $error = RuleErrorBuilder::message(sprintf('Parameter #%d $%s of method %s::%s() is required but parameter #%d $%s of method %s::%s() is optional.', $i + 1, $methodParameter->getName(), $method->getDeclaringClass()->getDisplayName(), $method->getName(), $i + 1, $prototypeParameter->getName(), $prototypeDeclaringClass->getDisplayName($this->genericPrototypeMessage), $prototype->getName()))->identifier('parameter.notOptional'); if (!$ignorable) { $error->nonIgnorable(); } $messages[] = $error->build(); } $methodParameterType = $methodParameter->getNativeType(); $prototypeParameterType = $prototypeParameter->getNativeType(); if (!$this->phpVersion->supportsParameterTypeWidening()) { if (!$methodParameterType->equals($prototypeParameterType)) { $error = RuleErrorBuilder::message(sprintf('Parameter #%d $%s (%s) of method %s::%s() does not match parameter #%d $%s (%s) of method %s::%s().', $i + 1, $methodParameter->getName(), $methodParameterType->describe(VerbosityLevel::typeOnly()), $method->getDeclaringClass()->getDisplayName(), $method->getName(), $i + 1, $prototypeParameter->getName(), $prototypeParameterType->describe(VerbosityLevel::typeOnly()), $prototypeDeclaringClass->getDisplayName($this->genericPrototypeMessage), $prototype->getName()))->identifier('method.childParameterType'); if (!$ignorable) { $error->nonIgnorable(); } $messages[] = $error->build(); } continue; } if ($this->isParameterTypeCompatible($methodParameterType, $prototypeParameterType, $this->phpVersion->supportsParameterContravariance())) { continue; } if ($this->phpVersion->supportsParameterContravariance()) { $error = RuleErrorBuilder::message(sprintf('Parameter #%d $%s (%s) of method %s::%s() is not contravariant with parameter #%d $%s (%s) of method %s::%s().', $i + 1, $methodParameter->getName(), $methodParameterType->describe(VerbosityLevel::typeOnly()), $method->getDeclaringClass()->getDisplayName(), $method->getName(), $i + 1, $prototypeParameter->getName(), $prototypeParameterType->describe(VerbosityLevel::typeOnly()), $prototypeDeclaringClass->getDisplayName($this->genericPrototypeMessage), $prototype->getName()))->identifier('method.childParameterType'); if (!$ignorable) { $error->nonIgnorable(); } $messages[] = $error->build(); } else { $error = RuleErrorBuilder::message(sprintf('Parameter #%d $%s (%s) of method %s::%s() is not compatible with parameter #%d $%s (%s) of method %s::%s().', $i + 1, $methodParameter->getName(), $methodParameterType->describe(VerbosityLevel::typeOnly()), $method->getDeclaringClass()->getDisplayName(), $method->getName(), $i + 1, $prototypeParameter->getName(), $prototypeParameterType->describe(VerbosityLevel::typeOnly()), $prototypeDeclaringClass->getDisplayName($this->genericPrototypeMessage), $prototype->getName()))->identifier('method.childParameterType'); if (!$ignorable) { $error->nonIgnorable(); } $messages[] = $error->build(); } } if (!isset($i)) { $i = -1; } foreach ($methodParameters as $j => $methodParameter) { if ($j <= $i) { continue; } if ($j === count($methodParameters) - 1 && $prototypeAfterVariadic && !$methodParameter->isVariadic()) { $error = RuleErrorBuilder::message(sprintf('Parameter #%d $%s of method %s::%s() is not variadic.', $j + 1, $methodParameter->getName(), $method->getDeclaringClass()->getDisplayName(), $method->getName()))->identifier('parameter.notVariadic'); if (!$ignorable) { $error->nonIgnorable(); } $messages[] = $error->build(); continue; } if ($methodParameter->isOptional()) { continue; } $error = RuleErrorBuilder::message(sprintf('Parameter #%d $%s of method %s::%s() is not optional.', $j + 1, $methodParameter->getName(), $method->getDeclaringClass()->getDisplayName(), $method->getName()))->identifier('parameter.notOptional'); if (!$ignorable) { $error->nonIgnorable(); } $messages[] = $error->build(); continue; } return $messages; } public function isParameterTypeCompatible(Type $methodParameterType, Type $prototypeParameterType, bool $supportsContravariance) : bool { return $this->isTypeCompatible($methodParameterType, $prototypeParameterType, $supportsContravariance, \false); } public function isReturnTypeCompatible(Type $methodParameterType, Type $prototypeParameterType, bool $supportsCovariance) : bool { return $this->isTypeCompatible($methodParameterType, $prototypeParameterType, $supportsCovariance, \true); } private function isTypeCompatible(Type $methodParameterType, Type $prototypeParameterType, bool $supportsContravariance, bool $considerMixedExplicitness) : bool { if ($methodParameterType instanceof MixedType) { if ($considerMixedExplicitness && $prototypeParameterType instanceof MixedType) { return !$methodParameterType->isExplicitMixed() || $prototypeParameterType->isExplicitMixed(); } return \true; } if (!$supportsContravariance) { if (TypeCombinator::containsNull($methodParameterType)) { $prototypeParameterType = TypeCombinator::removeNull($prototypeParameterType); } $methodParameterType = TypeCombinator::removeNull($methodParameterType); if ($methodParameterType->equals($prototypeParameterType)) { return \true; } if ($methodParameterType instanceof IterableType) { if ($prototypeParameterType instanceof ArrayType) { return \true; } if ($prototypeParameterType->isObject()->yes() && $prototypeParameterType->getObjectClassNames() === [Traversable::class]) { return \true; } } return \false; } return $methodParameterType->isSuperTypeOf($prototypeParameterType)->yes(); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Methods; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\InClassMethodNode; use PHPStan\Rules\MissingTypehintCheck; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\VerbosityLevel; use function sprintf; /** * @implements Rule<InClassMethodNode> */ final class MissingMethodSelfOutTypeRule implements Rule { /** * @var MissingTypehintCheck */ private $missingTypehintCheck; public function __construct(MissingTypehintCheck $missingTypehintCheck) { $this->missingTypehintCheck = $missingTypehintCheck; } public function getNodeType() : string { return InClassMethodNode::class; } public function processNode(Node $node, Scope $scope) : array { $methodReflection = $node->getMethodReflection(); $selfOutType = $methodReflection->getSelfOutType(); if ($selfOutType === null) { return []; } $classReflection = $methodReflection->getDeclaringClass(); $phpDocTagMessage = 'PHPDoc tag @phpstan-self-out'; $messages = []; foreach ($this->missingTypehintCheck->getIterableTypesWithMissingValueTypehint($selfOutType) as $iterableType) { $iterableTypeDescription = $iterableType->describe(VerbosityLevel::typeOnly()); $messages[] = RuleErrorBuilder::message(sprintf('Method %s::%s() has %s with no value type specified in iterable type %s.', $classReflection->getDisplayName(), $methodReflection->getName(), $phpDocTagMessage, $iterableTypeDescription))->tip(MissingTypehintCheck::MISSING_ITERABLE_VALUE_TYPE_TIP)->identifier('missingType.iterableValue')->build(); } foreach ($this->missingTypehintCheck->getNonGenericObjectTypesWithGenericClass($selfOutType) as [$name, $genericTypeNames]) { $messages[] = RuleErrorBuilder::message(sprintf('Method %s::%s() has %s with generic %s but does not specify its types: %s', $classReflection->getDisplayName(), $methodReflection->getName(), $phpDocTagMessage, $name, $genericTypeNames))->identifier('missingType.generics')->build(); } foreach ($this->missingTypehintCheck->getCallablesWithMissingSignature($selfOutType) as $callableType) { $messages[] = RuleErrorBuilder::message(sprintf('Method %s::%s() has %s with no signature specified for %s.', $classReflection->getDisplayName(), $methodReflection->getName(), $phpDocTagMessage, $callableType->describe(VerbosityLevel::typeOnly())))->identifier('missingType.callable')->build(); } return $messages; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Methods; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\InClassMethodNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\ShouldNotHappenException; use PHPStan\Type\Generic\TemplateTypeHelper; use PHPStan\Type\VerbosityLevel; use function is_string; use function sprintf; /** * @implements Rule<InClassMethodNode> */ final class IncompatibleDefaultParameterTypeRule implements Rule { public function getNodeType() : string { return InClassMethodNode::class; } public function processNode(Node $node, Scope $scope) : array { $method = $node->getMethodReflection(); $errors = []; foreach ($node->getOriginalNode()->getParams() as $paramI => $param) { if ($param->default === null) { continue; } if ($param->var instanceof Node\Expr\Error || !is_string($param->var->name)) { throw new ShouldNotHappenException(); } $defaultValueType = $scope->getType($param->default); $parameter = $method->getParameters()[$paramI]; $parameterType = $parameter->getType(); $parameterType = TemplateTypeHelper::resolveToBounds($parameterType); $accepts = $parameterType->acceptsWithReason($defaultValueType, \true); if ($accepts->yes()) { continue; } $verbosityLevel = VerbosityLevel::getRecommendedLevelByType($parameterType, $defaultValueType); $errors[] = RuleErrorBuilder::message(sprintf('Default value of the parameter #%d $%s (%s) of method %s::%s() is incompatible with type %s.', $paramI + 1, $param->var->name, $defaultValueType->describe($verbosityLevel), $method->getDeclaringClass()->getDisplayName(), $method->getName(), $parameterType->describe($verbosityLevel)))->line($param->getStartLine())->identifier('parameter.defaultValue')->acceptsReasonsTip($accepts->reasons)->build(); } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Methods; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\BetterReflection\Reflector\Exception\IdentifierNotFound; use PHPStan\Node\InClassNode; use PHPStan\Php\PhpVersion; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use Serializable; use function sprintf; use function strtolower; /** * @implements Rule<InClassNode> */ final class MissingMagicSerializationMethodsRule implements Rule { /** * @var PhpVersion */ private $phpversion; public function __construct(PhpVersion $phpversion) { $this->phpversion = $phpversion; } public function getNodeType() : string { return InClassNode::class; } public function processNode(Node $node, Scope $scope) : array { $classReflection = $node->getClassReflection(); if (!$this->phpversion->serializableRequiresMagicMethods()) { return []; } if (!$classReflection->implementsInterface(Serializable::class)) { return []; } if ($classReflection->isAbstract() || $classReflection->isInterface() || $classReflection->isEnum()) { return []; } $messages = []; try { $nativeMethods = $classReflection->getNativeReflection()->getMethods(); } catch (IdentifierNotFound $e) { return []; } $missingMagicSerialize = \true; $missingMagicUnserialize = \true; foreach ($nativeMethods as $method) { if (strtolower($method->getName()) === '__serialize') { $missingMagicSerialize = \false; } if (strtolower($method->getName()) !== '__unserialize') { continue; } $missingMagicUnserialize = \false; } if ($missingMagicSerialize) { $messages[] = RuleErrorBuilder::message(sprintf('Non-abstract class %s implements the Serializable interface, but does not implement __serialize().', $classReflection->getDisplayName()))->tip('See https://wiki.php.net/rfc/phase_out_serializable')->identifier('class.serializable')->build(); } if ($missingMagicUnserialize) { $messages[] = RuleErrorBuilder::message(sprintf('Non-abstract class %s implements the Serializable interface, but does not implement __unserialize().', $classReflection->getDisplayName()))->tip('See https://wiki.php.net/rfc/phase_out_serializable')->identifier('class.serializable')->build(); } return $messages; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Methods; use Attribute; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\AttributesCheck; use PHPStan\Rules\Rule; /** * @implements Rule<Node\Stmt\ClassMethod> */ final class MethodAttributesRule implements Rule { /** * @var AttributesCheck */ private $attributesCheck; public function __construct(AttributesCheck $attributesCheck) { $this->attributesCheck = $attributesCheck; } public function getNodeType() : string { return Node\Stmt\ClassMethod::class; } public function processNode(Node $node, Scope $scope) : array { return $this->attributesCheck->check($scope, $node->attrGroups, Attribute::TARGET_METHOD, 'method'); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Methods; use PhpParser\Node; use PHPStan\Analyser\NullsafeOperatorHelper; use PHPStan\Analyser\Scope; use PHPStan\Node\NoopExpressionNode; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Rules\RuleLevelHelper; use PHPStan\Type\ErrorType; use PHPStan\Type\NeverType; use PHPStan\Type\ObjectType; use PHPStan\Type\Type; use function sprintf; use function strtolower; /** * @implements Rule<NoopExpressionNode> */ final class CallToStaticMethodStatementWithoutSideEffectsRule implements Rule { /** * @var RuleLevelHelper */ private $ruleLevelHelper; /** * @var ReflectionProvider */ private $reflectionProvider; public function __construct(RuleLevelHelper $ruleLevelHelper, ReflectionProvider $reflectionProvider) { $this->ruleLevelHelper = $ruleLevelHelper; $this->reflectionProvider = $reflectionProvider; } public function getNodeType() : string { return NoopExpressionNode::class; } public function processNode(Node $node, Scope $scope) : array { $staticCall = $node->getOriginalExpr(); if (!$staticCall instanceof Node\Expr\StaticCall) { return []; } if (!$staticCall->name instanceof Node\Identifier) { return []; } $methodName = $staticCall->name->toString(); if ($staticCall->class instanceof Node\Name) { $className = $scope->resolveName($staticCall->class); if (!$this->reflectionProvider->hasClass($className)) { return []; } $calledOnType = new ObjectType($className); } else { $typeResult = $this->ruleLevelHelper->findTypeToCheck($scope, NullsafeOperatorHelper::getNullsafeShortcircuitedExprRespectingScope($scope, $staticCall->class), '', static function (Type $type) use($methodName) : bool { return $type->canCallMethods()->yes() && $type->hasMethod($methodName)->yes(); }); $calledOnType = $typeResult->getType(); if ($calledOnType instanceof ErrorType) { return []; } } if (!$calledOnType->canCallMethods()->yes()) { return []; } if (!$calledOnType->hasMethod($methodName)->yes()) { return []; } $method = $calledOnType->getMethod($methodName, $scope); if (strtolower($method->getName()) === '__construct' || strtolower($method->getName()) === strtolower($method->getDeclaringClass()->getName())) { return []; } $methodResult = $scope->getType($staticCall); if ($methodResult instanceof NeverType && $methodResult->isExplicit()) { return []; } return [RuleErrorBuilder::message(sprintf('Call to %s %s::%s() on a separate line has no effect.', $method->isStatic() ? 'static method' : 'method', $method->getDeclaringClass()->getDisplayName(), $method->getName()))->identifier('staticMethod.resultUnused')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Methods; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Internal\SprintfHelper; use PHPStan\Node\MethodCallableNode; use PHPStan\Php\PhpVersion; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function sprintf; /** * @implements Rule<MethodCallableNode> */ final class MethodCallableRule implements Rule { /** * @var MethodCallCheck */ private $methodCallCheck; /** * @var PhpVersion */ private $phpVersion; public function __construct(\PHPStan\Rules\Methods\MethodCallCheck $methodCallCheck, PhpVersion $phpVersion) { $this->methodCallCheck = $methodCallCheck; $this->phpVersion = $phpVersion; } public function getNodeType() : string { return MethodCallableNode::class; } public function processNode(Node $node, Scope $scope) : array { if (!$this->phpVersion->supportsFirstClassCallables()) { return [RuleErrorBuilder::message('First-class callables are supported only on PHP 8.1 and later.')->nonIgnorable()->identifier('callable.notSupported')->build()]; } $methodName = $node->getName(); if (!$methodName instanceof Node\Identifier) { return []; } $methodNameName = $methodName->toString(); [$errors, $methodReflection] = $this->methodCallCheck->check($scope, $methodNameName, $node->getVar()); if ($methodReflection === null) { return $errors; } $declaringClass = $methodReflection->getDeclaringClass(); if ($declaringClass->hasNativeMethod($methodNameName)) { return $errors; } $messagesMethodName = SprintfHelper::escapeFormatString($declaringClass->getDisplayName() . '::' . $methodReflection->getName() . '()'); $errors[] = RuleErrorBuilder::message(sprintf('Creating callable from a non-native method %s.', $messagesMethodName))->identifier('callable.nonNativeMethod')->build(); return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Methods; use PhpParser\Node; use PhpParser\Node\Expr\StaticCall; use PhpParser\Node\Name; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function sprintf; /** * @implements Rule<StaticCall> */ final class CallPrivateMethodThroughStaticRule implements Rule { public function getNodeType() : string { return StaticCall::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->name instanceof Node\Identifier) { return []; } if (!$node->class instanceof Name) { return []; } $methodName = $node->name->name; $className = $node->class; if ($className->toLowerString() !== 'static') { return []; } $classType = $scope->resolveTypeByName($className); if (!$classType->hasMethod($methodName)->yes()) { return []; } $method = $classType->getMethod($methodName, $scope); if (!$method->isPrivate()) { return []; } if ($scope->isInClass() && $scope->getClassReflection()->isFinal()) { return []; } return [RuleErrorBuilder::message(sprintf('Unsafe call to private method %s::%s() through static::.', $method->getDeclaringClass()->getDisplayName(), $method->getName()))->identifier('staticClassAccess.privateMethod')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Methods; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\InClassMethodNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function sprintf; /** @implements Rule<InClassMethodNode> */ final class AbstractPrivateMethodRule implements Rule { public function getNodeType() : string { return InClassMethodNode::class; } public function processNode(Node $node, Scope $scope) : array { $method = $node->getMethodReflection(); if (!$method->isPrivate()) { return []; } if (!$method->isAbstract()->yes()) { return []; } if ($scope->isInTrait()) { return []; } $classReflection = $scope->getClassReflection(); if ($classReflection === null) { return []; } if (!$classReflection->isAbstract() && !$classReflection->isInterface()) { return []; } return [RuleErrorBuilder::message(sprintf('Private method %s::%s() cannot be abstract.', $method->getDeclaringClass()->getDisplayName(), $method->getName()))->identifier('method.abstractPrivate')->nonIgnorable()->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Methods; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Internal\SprintfHelper; use PHPStan\Node\StaticMethodCallableNode; use PHPStan\Php\PhpVersion; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function sprintf; /** * @implements Rule<StaticMethodCallableNode> */ final class StaticMethodCallableRule implements Rule { /** * @var StaticMethodCallCheck */ private $methodCallCheck; /** * @var PhpVersion */ private $phpVersion; public function __construct(\PHPStan\Rules\Methods\StaticMethodCallCheck $methodCallCheck, PhpVersion $phpVersion) { $this->methodCallCheck = $methodCallCheck; $this->phpVersion = $phpVersion; } public function getNodeType() : string { return StaticMethodCallableNode::class; } public function processNode(Node $node, Scope $scope) : array { if (!$this->phpVersion->supportsFirstClassCallables()) { return [RuleErrorBuilder::message('First-class callables are supported only on PHP 8.1 and later.')->nonIgnorable()->identifier('callable.notSupported')->build()]; } $methodName = $node->getName(); if (!$methodName instanceof Node\Identifier) { return []; } $methodNameName = $methodName->toString(); [$errors, $methodReflection] = $this->methodCallCheck->check($scope, $methodNameName, $node->getClass()); if ($methodReflection === null) { return $errors; } $declaringClass = $methodReflection->getDeclaringClass(); if ($declaringClass->hasNativeMethod($methodNameName)) { return $errors; } $messagesMethodName = SprintfHelper::escapeFormatString($declaringClass->getDisplayName() . '::' . $methodReflection->getName() . '()'); $errors[] = RuleErrorBuilder::message(sprintf('Creating callable from a non-native static method %s.', $messagesMethodName))->identifier('callable.nonNativeMethod')->build(); return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Methods; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\BetterReflection\Reflector\Exception\IdentifierNotFound; use PHPStan\Node\InClassNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function sprintf; /** * @implements Rule<InClassNode> */ final class MissingMethodImplementationRule implements Rule { public function getNodeType() : string { return InClassNode::class; } public function processNode(Node $node, Scope $scope) : array { $classReflection = $node->getClassReflection(); if ($classReflection->isInterface()) { return []; } if ($classReflection->isAbstract()) { return []; } $messages = []; try { $nativeMethods = $classReflection->getNativeReflection()->getMethods(); } catch (IdentifierNotFound $e) { return []; } foreach ($nativeMethods as $method) { if (!$method->isAbstract()) { continue; } $declaringClass = $method->getDeclaringClass(); $classLikeDescription = 'Non-abstract class'; if ($classReflection->isEnum()) { $classLikeDescription = 'Enum'; } $messages[] = RuleErrorBuilder::message(sprintf('%s %s contains abstract method %s() from %s %s.', $classLikeDescription, $classReflection->getDisplayName(), $method->getName(), $declaringClass->isInterface() ? 'interface' : 'class', $declaringClass->getName()))->nonIgnorable()->identifier('method.abstract')->build(); } return $messages; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Methods; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\VerbosityLevel; use function sprintf; /** * @implements Rule<Node\Expr\NullsafeMethodCall> */ final class NullsafeMethodCallRule implements Rule { public function getNodeType() : string { return Node\Expr\NullsafeMethodCall::class; } public function processNode(Node $node, Scope $scope) : array { $calledOnType = $scope->getType($node->var); if (!$calledOnType->isNull()->no()) { return []; } return [RuleErrorBuilder::message(sprintf('Using nullsafe method call on non-nullable type %s. Use -> instead.', $calledOnType->describe(VerbosityLevel::typeOnly())))->identifier('nullsafe.neverNull')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Methods; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\InClassMethodNode; use PHPStan\Reflection\Dummy\DummyConstructorReflection; use PHPStan\Rules\Rule; use function strtolower; /** @implements Rule<InClassMethodNode> */ final class ConsistentConstructorRule implements Rule { /** * @var MethodParameterComparisonHelper */ private $methodParameterComparisonHelper; public function __construct(\PHPStan\Rules\Methods\MethodParameterComparisonHelper $methodParameterComparisonHelper) { $this->methodParameterComparisonHelper = $methodParameterComparisonHelper; } public function getNodeType() : string { return InClassMethodNode::class; } public function processNode(Node $node, Scope $scope) : array { $method = $node->getMethodReflection(); if (strtolower($method->getName()) !== '__construct') { return []; } $parent = $method->getDeclaringClass()->getParentClass(); if ($parent === null) { return []; } if ($parent->hasConstructor()) { $parentConstructor = $parent->getConstructor(); } else { $parentConstructor = new DummyConstructorReflection($parent); } if (!$parentConstructor->getDeclaringClass()->hasConsistentConstructor()) { return []; } return $this->methodParameterComparisonHelper->compare($parentConstructor, $parentConstructor->getDeclaringClass(), $method, \true); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Methods; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\InClassMethodNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function sprintf; /** * @implements Rule<InClassMethodNode> */ final class ConstructorReturnTypeRule implements Rule { public function getNodeType() : string { return InClassMethodNode::class; } public function processNode(Node $node, Scope $scope) : array { $classReflection = $node->getClassReflection(); $methodNode = $node->getOriginalNode(); if ($scope->isInTrait()) { $originalMethodName = $methodNode->getAttribute('originalTraitMethodName'); if ($originalMethodName === '__construct' && $methodNode->returnType !== null) { return [RuleErrorBuilder::message(sprintf('Original constructor of trait %s has a return type.', $scope->getTraitReflection()->getDisplayName()))->identifier('constructor.returnType')->nonIgnorable()->build()]; } } if (!$classReflection->hasConstructor()) { return []; } $constructorReflection = $classReflection->getConstructor(); $methodReflection = $node->getMethodReflection(); if ($methodReflection->getName() !== $constructorReflection->getName()) { return []; } if ($methodNode->returnType === null) { return []; } return [RuleErrorBuilder::message(sprintf('Constructor of class %s has a return type.', $classReflection->getDisplayName()))->identifier('constructor.returnType')->nonIgnorable()->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Methods; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\InClassMethodNode; use PHPStan\Reflection\MethodReflection; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\MissingTypehintCheck; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\MixedType; use PHPStan\Type\Type; use PHPStan\Type\VerbosityLevel; use function sprintf; /** * @implements Rule<InClassMethodNode> */ final class MissingMethodParameterTypehintRule implements Rule { /** * @var MissingTypehintCheck */ private $missingTypehintCheck; /** * @var bool */ private $paramOut; public function __construct(MissingTypehintCheck $missingTypehintCheck, bool $paramOut) { $this->missingTypehintCheck = $missingTypehintCheck; $this->paramOut = $paramOut; } public function getNodeType() : string { return InClassMethodNode::class; } public function processNode(Node $node, Scope $scope) : array { $methodReflection = $node->getMethodReflection(); $messages = []; foreach ($methodReflection->getParameters() as $parameterReflection) { foreach ($this->checkMethodParameter($methodReflection, sprintf('parameter $%s', $parameterReflection->getName()), $parameterReflection->getType()) as $parameterMessage) { $messages[] = $parameterMessage; } if ($parameterReflection->getClosureThisType() !== null) { foreach ($this->checkMethodParameter($methodReflection, sprintf('@param-closure-this PHPDoc tag for parameter $%s', $parameterReflection->getName()), $parameterReflection->getClosureThisType()) as $parameterMessage) { $messages[] = $parameterMessage; } } if (!$this->paramOut) { continue; } if ($parameterReflection->getOutType() === null) { continue; } foreach ($this->checkMethodParameter($methodReflection, sprintf('@param-out PHPDoc tag for parameter $%s', $parameterReflection->getName()), $parameterReflection->getOutType()) as $parameterMessage) { $messages[] = $parameterMessage; } } return $messages; } /** * @return list<IdentifierRuleError> */ private function checkMethodParameter(MethodReflection $methodReflection, string $parameterMessage, Type $parameterType) : array { if ($parameterType instanceof MixedType && !$parameterType->isExplicitMixed()) { return [RuleErrorBuilder::message(sprintf('Method %s::%s() has %s with no type specified.', $methodReflection->getDeclaringClass()->getDisplayName(), $methodReflection->getName(), $parameterMessage))->identifier('missingType.parameter')->build()]; } $messages = []; foreach ($this->missingTypehintCheck->getIterableTypesWithMissingValueTypehint($parameterType) as $iterableType) { $iterableTypeDescription = $iterableType->describe(VerbosityLevel::typeOnly()); $messages[] = RuleErrorBuilder::message(sprintf('Method %s::%s() has %s with no value type specified in iterable type %s.', $methodReflection->getDeclaringClass()->getDisplayName(), $methodReflection->getName(), $parameterMessage, $iterableTypeDescription))->tip(MissingTypehintCheck::MISSING_ITERABLE_VALUE_TYPE_TIP)->identifier('missingType.iterableValue')->build(); } foreach ($this->missingTypehintCheck->getNonGenericObjectTypesWithGenericClass($parameterType) as [$name, $genericTypeNames]) { $messages[] = RuleErrorBuilder::message(sprintf('Method %s::%s() has %s with generic %s but does not specify its types: %s', $methodReflection->getDeclaringClass()->getDisplayName(), $methodReflection->getName(), $parameterMessage, $name, $genericTypeNames))->identifier('missingType.generics')->build(); } foreach ($this->missingTypehintCheck->getCallablesWithMissingSignature($parameterType) as $callableType) { $messages[] = RuleErrorBuilder::message(sprintf('Method %s::%s() has %s with no signature specified for %s.', $methodReflection->getDeclaringClass()->getDisplayName(), $methodReflection->getName(), $parameterMessage, $callableType->describe(VerbosityLevel::typeOnly())))->identifier('missingType.callable')->build(); } return $messages; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Methods; use PhpParser\Node\Expr; use PHPStan\Analyser\NullsafeOperatorHelper; use PHPStan\Analyser\Scope; use PHPStan\Internal\SprintfHelper; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Rules\RuleLevelHelper; use PHPStan\Type\ErrorType; use PHPStan\Type\StaticType; use PHPStan\Type\Type; use PHPStan\Type\VerbosityLevel; use function count; use function sprintf; use function strtolower; final class MethodCallCheck { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var RuleLevelHelper */ private $ruleLevelHelper; /** * @var bool */ private $checkFunctionNameCase; /** * @var bool */ private $reportMagicMethods; public function __construct(ReflectionProvider $reflectionProvider, RuleLevelHelper $ruleLevelHelper, bool $checkFunctionNameCase, bool $reportMagicMethods) { $this->reflectionProvider = $reflectionProvider; $this->ruleLevelHelper = $ruleLevelHelper; $this->checkFunctionNameCase = $checkFunctionNameCase; $this->reportMagicMethods = $reportMagicMethods; } /** * @return array{list<IdentifierRuleError>, ExtendedMethodReflection|null} */ public function check(Scope $scope, string $methodName, Expr $var) : array { $typeResult = $this->ruleLevelHelper->findTypeToCheck($scope, NullsafeOperatorHelper::getNullsafeShortcircuitedExprRespectingScope($scope, $var), sprintf('Call to method %s() on an unknown class %%s.', SprintfHelper::escapeFormatString($methodName)), static function (Type $type) use($methodName) : bool { return $type->canCallMethods()->yes() && $type->hasMethod($methodName)->yes(); }); $type = $typeResult->getType(); if ($type instanceof ErrorType) { return [$typeResult->getUnknownClassErrors(), null]; } $typeForDescribe = $type; if ($type instanceof StaticType) { $typeForDescribe = $type->getStaticObjectType(); } if (!$type->canCallMethods()->yes() || $type->isClassStringType()->yes()) { return [[RuleErrorBuilder::message(sprintf('Cannot call method %s() on %s.', $methodName, $typeForDescribe->describe(VerbosityLevel::typeOnly())))->identifier('method.nonObject')->build()], null]; } if (!$type->hasMethod($methodName)->yes()) { $directClassNames = $typeResult->getReferencedClasses(); if (!$this->reportMagicMethods) { foreach ($directClassNames as $className) { if (!$this->reflectionProvider->hasClass($className)) { continue; } $classReflection = $this->reflectionProvider->getClass($className); if ($classReflection->hasNativeMethod('__call')) { return [[], null]; } } } if (count($directClassNames) === 1) { $referencedClass = $directClassNames[0]; $methodClassReflection = $this->reflectionProvider->getClass($referencedClass); $parentClassReflection = $methodClassReflection->getParentClass(); while ($parentClassReflection !== null) { if ($parentClassReflection->hasMethod($methodName)) { $methodReflection = $parentClassReflection->getMethod($methodName, $scope); return [[RuleErrorBuilder::message(sprintf('Call to private method %s() of parent class %s.', $methodReflection->getName(), $parentClassReflection->getDisplayName()))->identifier('method.private')->build()], $methodReflection]; } $parentClassReflection = $parentClassReflection->getParentClass(); } } return [[RuleErrorBuilder::message(sprintf('Call to an undefined method %s::%s().', $typeForDescribe->describe(VerbosityLevel::typeOnly()), $methodName))->identifier('method.notFound')->build()], null]; } $methodReflection = $type->getMethod($methodName, $scope); $declaringClass = $methodReflection->getDeclaringClass(); $messagesMethodName = SprintfHelper::escapeFormatString($declaringClass->getDisplayName() . '::' . $methodReflection->getName() . '()'); $errors = []; if (!$scope->canCallMethod($methodReflection)) { $errors[] = RuleErrorBuilder::message(sprintf('Call to %s method %s() of class %s.', $methodReflection->isPrivate() ? 'private' : 'protected', $methodReflection->getName(), $declaringClass->getDisplayName()))->identifier(sprintf('method.%s', $methodReflection->isPrivate() ? 'private' : 'protected'))->build(); } if ($this->checkFunctionNameCase && strtolower($methodReflection->getName()) === strtolower($methodName) && $methodReflection->getName() !== $methodName) { $errors[] = RuleErrorBuilder::message(sprintf('Call to method %s with incorrect case: %s', $messagesMethodName, $methodName))->identifier('method.nameCase')->build(); } return [$errors, $methodReflection]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Methods; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\InClassMethodNode; use PHPStan\Rules\MissingTypehintCheck; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\MixedType; use PHPStan\Type\VerbosityLevel; use function sprintf; /** * @implements Rule<InClassMethodNode> */ final class MissingMethodReturnTypehintRule implements Rule { /** * @var MissingTypehintCheck */ private $missingTypehintCheck; public function __construct(MissingTypehintCheck $missingTypehintCheck) { $this->missingTypehintCheck = $missingTypehintCheck; } public function getNodeType() : string { return InClassMethodNode::class; } public function processNode(Node $node, Scope $scope) : array { $methodReflection = $node->getMethodReflection(); if ($scope->isInTrait()) { $methodNode = $node->getOriginalNode(); $originalMethodName = $methodNode->getAttribute('originalTraitMethodName'); if ($originalMethodName === '__construct') { return []; } } $returnType = $methodReflection->getReturnType(); if ($returnType instanceof MixedType && !$returnType->isExplicitMixed()) { return [RuleErrorBuilder::message(sprintf('Method %s::%s() has no return type specified.', $methodReflection->getDeclaringClass()->getDisplayName(), $methodReflection->getName()))->identifier('missingType.return')->build()]; } $messages = []; foreach ($this->missingTypehintCheck->getIterableTypesWithMissingValueTypehint($returnType) as $iterableType) { $iterableTypeDescription = $iterableType->describe(VerbosityLevel::typeOnly()); $messages[] = RuleErrorBuilder::message(sprintf('Method %s::%s() return type has no value type specified in iterable type %s.', $methodReflection->getDeclaringClass()->getDisplayName(), $methodReflection->getName(), $iterableTypeDescription))->tip(MissingTypehintCheck::MISSING_ITERABLE_VALUE_TYPE_TIP)->identifier('missingType.iterableValue')->build(); } foreach ($this->missingTypehintCheck->getNonGenericObjectTypesWithGenericClass($returnType) as [$name, $genericTypeNames]) { $messages[] = RuleErrorBuilder::message(sprintf('Method %s::%s() return type with generic %s does not specify its types: %s', $methodReflection->getDeclaringClass()->getDisplayName(), $methodReflection->getName(), $name, $genericTypeNames))->identifier('missingType.generics')->build(); } foreach ($this->missingTypehintCheck->getCallablesWithMissingSignature($returnType) as $callableType) { $messages[] = RuleErrorBuilder::message(sprintf('Method %s::%s() return type has no signature specified for %s.', $methodReflection->getDeclaringClass()->getDisplayName(), $methodReflection->getName(), $callableType->describe(VerbosityLevel::typeOnly())))->identifier('missingType.callable')->build(); } return $messages; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Methods; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\NoopExpressionNode; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\NeverType; use function sprintf; /** * @implements Rule<NoopExpressionNode> */ final class CallToConstructorStatementWithoutSideEffectsRule implements Rule { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var bool */ private $reportNoConstructor; public function __construct(ReflectionProvider $reflectionProvider, bool $reportNoConstructor) { $this->reflectionProvider = $reflectionProvider; $this->reportNoConstructor = $reportNoConstructor; } public function getNodeType() : string { return NoopExpressionNode::class; } public function processNode(Node $node, Scope $scope) : array { $instantiation = $node->getOriginalExpr(); if (!$instantiation instanceof Node\Expr\New_) { return []; } if (!$instantiation->class instanceof Node\Name) { return []; } $className = $scope->resolveName($instantiation->class); if (!$this->reflectionProvider->hasClass($className)) { return []; } $classReflection = $this->reflectionProvider->getClass($className); if (!$classReflection->hasConstructor()) { if ($this->reportNoConstructor) { return [RuleErrorBuilder::message(sprintf('Call to new %s() on a separate line has no effect.', $classReflection->getDisplayName()))->identifier('new.resultUnused')->build()]; } return []; } $constructor = $classReflection->getConstructor(); $methodResult = $scope->getType($instantiation); if ($methodResult instanceof NeverType && $methodResult->isExplicit()) { return []; } return [RuleErrorBuilder::message(sprintf('Call to %s::%s() on a separate line has no effect.', $classReflection->getDisplayName(), $constructor->getName()))->identifier('new.resultUnused')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Methods; final class DirectAlwaysUsedMethodExtensionProvider implements \PHPStan\Rules\Methods\AlwaysUsedMethodExtensionProvider { /** * @var AlwaysUsedMethodExtension[] */ private $extensions; /** * @param AlwaysUsedMethodExtension[] $extensions */ public function __construct(array $extensions) { $this->extensions = $extensions; } public function getExtensions() : array { return $this->extensions; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Methods; use PhpParser\Node; use PHPStan\Analyser\NullsafeOperatorHelper; use PHPStan\Analyser\Scope; use PHPStan\Node\NoopExpressionNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Rules\RuleLevelHelper; use PHPStan\Type\ErrorType; use PHPStan\Type\NeverType; use PHPStan\Type\Type; use function sprintf; /** * @implements Rule<NoopExpressionNode> */ final class CallToMethodStatementWithoutSideEffectsRule implements Rule { /** * @var RuleLevelHelper */ private $ruleLevelHelper; public function __construct(RuleLevelHelper $ruleLevelHelper) { $this->ruleLevelHelper = $ruleLevelHelper; } public function getNodeType() : string { return NoopExpressionNode::class; } public function processNode(Node $node, Scope $scope) : array { $methodCall = $node->getOriginalExpr(); if ($methodCall instanceof Node\Expr\NullsafeMethodCall) { $scope = $scope->filterByTruthyValue(new Node\Expr\BinaryOp\NotIdentical($methodCall->var, new Node\Expr\ConstFetch(new Node\Name('null')))); } elseif (!$methodCall instanceof Node\Expr\MethodCall) { return []; } if (!$methodCall->name instanceof Node\Identifier) { return []; } $methodName = $methodCall->name->toString(); $typeResult = $this->ruleLevelHelper->findTypeToCheck($scope, NullsafeOperatorHelper::getNullsafeShortcircuitedExprRespectingScope($scope, $methodCall->var), '', static function (Type $type) use($methodName) : bool { return $type->canCallMethods()->yes() && $type->hasMethod($methodName)->yes(); }); $calledOnType = $typeResult->getType(); if ($calledOnType instanceof ErrorType) { return []; } if (!$calledOnType->canCallMethods()->yes()) { return []; } if (!$calledOnType->hasMethod($methodName)->yes()) { return []; } $methodResult = $scope->getType($methodCall); if ($methodResult instanceof NeverType && $methodResult->isExplicit()) { return []; } $method = $calledOnType->getMethod($methodName, $scope); return [RuleErrorBuilder::message(sprintf('Call to %s %s::%s() on a separate line has no effect.', $method->isStatic() ? 'static method' : 'method', $method->getDeclaringClass()->getDisplayName(), $method->getName()))->identifier('method.resultUnused')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Methods; use PHPStan\Reflection\MethodReflection; /** * This is the extension interface to implement if you want to describe an always-used class method. * * To register it in the configuration file use the `phpstan.methods.alwaysUsedMethodExtension` service tag: * * ``` * services: * - * class: App\PHPStan\MyExtension * tags: * - phpstan.methods.alwaysUsedMethodExtension * ``` * * @api */ interface AlwaysUsedMethodExtension { public function isAlwaysUsed(MethodReflection $methodReflection) : bool; } <?php declare (strict_types=1); namespace PHPStan\Rules\Methods; use PhpParser\Node; use PhpParser\Node\Stmt\Return_; use PHPStan\Analyser\Scope; use PHPStan\Reflection\Php\PhpMethodFromParserNodeReflection; use PHPStan\Rules\FunctionReturnTypeCheck; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\LineRuleError; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleError; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Rules\TipRuleError; use PHPStan\Type\Accessory\AccessoryArrayListType; use PHPStan\Type\ArrayType; use PHPStan\Type\IntegerRangeType; use PHPStan\Type\IntersectionType; use PHPStan\Type\ObjectType; use function count; use function sprintf; use function strtolower; /** * @implements Rule<Node\Stmt\Return_> */ final class ReturnTypeRule implements Rule { /** * @var FunctionReturnTypeCheck */ private $returnTypeCheck; public function __construct(FunctionReturnTypeCheck $returnTypeCheck) { $this->returnTypeCheck = $returnTypeCheck; } public function getNodeType() : string { return Return_::class; } public function processNode(Node $node, Scope $scope) : array { if ($scope->getFunction() === null) { return []; } if ($scope->isInAnonymousFunction()) { return []; } $method = $scope->getFunction(); if (!$method instanceof PhpMethodFromParserNodeReflection) { return []; } $returnType = $method->getReturnType(); $errors = $this->returnTypeCheck->checkReturnType($scope, $returnType, $node->expr, $node, sprintf('Method %s::%s() should return %%s but empty return statement found.', $method->getDeclaringClass()->getDisplayName(), $method->getName()), sprintf('Method %s::%s() with return type void returns %%s but should not return anything.', $method->getDeclaringClass()->getDisplayName(), $method->getName()), sprintf('Method %s::%s() should return %%s but returns %%s.', $method->getDeclaringClass()->getDisplayName(), $method->getName()), sprintf('Method %s::%s() should never return but return statement found.', $method->getDeclaringClass()->getDisplayName(), $method->getName()), $method->isGenerator()); if (count($errors) === 1 && $errors[0]->getIdentifier() === 'return.type' && !$errors[0] instanceof TipRuleError && $errors[0] instanceof LineRuleError && $method->getDeclaringClass()->isSubclassOf(Rule::class) && strtolower($method->getName()) === 'processnode' && $node->expr !== null) { $ruleErrorType = new ObjectType(RuleError::class); $identifierRuleErrorType = new ObjectType(IdentifierRuleError::class); $listOfIdentifierRuleErrors = new IntersectionType([new ArrayType(IntegerRangeType::fromInterval(0, null), $identifierRuleErrorType), new AccessoryArrayListType()]); if (!$listOfIdentifierRuleErrors->isSuperTypeOf($returnType)->yes()) { return $errors; } $returnValueType = $scope->getType($node->expr)->getIterableValueType(); $builder = RuleErrorBuilder::message($errors[0]->getMessage())->line($errors[0]->getLine())->identifier($errors[0]->getIdentifier()); if (!$returnValueType->isString()->no()) { $builder->tip('Rules can no longer return plain strings. See: https://phpstan.org/blog/using-rule-error-builder'); } elseif ($ruleErrorType->isSuperTypeOf($returnValueType)->yes() && !$identifierRuleErrorType->isSuperTypeOf($returnValueType)->yes()) { $builder->tip('Error is missing an identifier. See: https://phpstan.org/blog/using-rule-error-builder'); } $errors = [$builder->build()]; } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Types; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\ClassPropertyNode; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function array_merge; use function in_array; use function sprintf; /** * @implements Rule<Node> */ final class InvalidTypesInUnionRule implements Rule { private const ONLY_STANDALONE_TYPES = ['mixed', 'never', 'void']; public function getNodeType() : string { return Node::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node instanceof Node\FunctionLike && !$node instanceof ClassPropertyNode) { return []; } if ($node instanceof Node\FunctionLike) { return $this->processFunctionLikeNode($node); } return $this->processClassPropertyNode($node); } /** * @return list<IdentifierRuleError> */ private function processFunctionLikeNode(Node\FunctionLike $functionLike) : array { $errors = []; foreach ($functionLike->getParams() as $param) { if (!$param->type instanceof Node\ComplexType) { continue; } $errors = array_merge($errors, $this->processComplexType($param->type)); } if ($functionLike->getReturnType() instanceof Node\ComplexType) { $errors = array_merge($errors, $this->processComplexType($functionLike->getReturnType())); } return $errors; } /** * @return list<IdentifierRuleError> */ private function processClassPropertyNode(ClassPropertyNode $classPropertyNode) : array { if (!$classPropertyNode->getNativeType() instanceof Node\ComplexType) { return []; } return $this->processComplexType($classPropertyNode->getNativeType()); } /** * @return list<IdentifierRuleError> */ private function processComplexType(Node\ComplexType $complexType) : array { if (!$complexType instanceof Node\UnionType && !$complexType instanceof Node\NullableType) { return []; } if ($complexType instanceof Node\UnionType) { foreach ($complexType->types as $type) { if (!$type instanceof Node\Identifier) { continue; } $typeString = $type->toLowerString(); if (in_array($typeString, self::ONLY_STANDALONE_TYPES, \true)) { return [RuleErrorBuilder::message(sprintf('Type %s cannot be part of a union type declaration.', $type->toString()))->line($complexType->getStartLine())->identifier(sprintf('unionType.%s', $typeString))->nonIgnorable()->build()]; } } return []; } if ($complexType->type instanceof Node\Identifier) { $complexTypeString = $complexType->type->toLowerString(); if (in_array($complexTypeString, self::ONLY_STANDALONE_TYPES, \true)) { return [RuleErrorBuilder::message(sprintf('Type %s cannot be part of a nullable type declaration.', $complexType->type->toString()))->line($complexType->getStartLine())->identifier(sprintf('nullableType.%s', $complexTypeString))->nonIgnorable()->build()]; } } return []; } } <?php declare (strict_types=1); namespace PHPStan\Rules; use PHPStan\Type\Type; /** * @api * @final */ class FoundTypeResult { /** * @var Type */ private $type; /** * @var string[] */ private $referencedClasses; /** * @var list<IdentifierRuleError> */ private $unknownClassErrors; /** * @var ?string */ private $tip; /** * @param string[] $referencedClasses * @param list<IdentifierRuleError> $unknownClassErrors */ public function __construct(Type $type, array $referencedClasses, array $unknownClassErrors, ?string $tip) { $this->type = $type; $this->referencedClasses = $referencedClasses; $this->unknownClassErrors = $unknownClassErrors; $this->tip = $tip; } public function getType() : Type { return $this->type; } /** * @return string[] */ public function getReferencedClasses() : array { return $this->referencedClasses; } /** * @return list<IdentifierRuleError> */ public function getUnknownClassErrors() : array { return $this->unknownClassErrors; } public function getTip() : ?string { return $this->tip; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Arrays; use PHPStan\Type\ArrayType; use PHPStan\Type\BooleanType; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\FloatType; use PHPStan\Type\IntegerType; use PHPStan\Type\MixedType; use PHPStan\Type\NullType; use PHPStan\Type\ObjectWithoutClassType; use PHPStan\Type\ResourceType; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\UnionType; final class AllowedArrayKeysTypes { public static function getType() : Type { return new UnionType([new IntegerType(), new StringType(), new FloatType(), new BooleanType(), new NullType()]); } public static function narrowOffsetKeyType(Type $varType, Type $keyType) : ?Type { if (!$varType->isArray()->yes() || $varType->isIterableAtLeastOnce()->no()) { return null; } $varIterableKeyType = $varType->getIterableKeyType(); if ($varIterableKeyType->isConstantScalarValue()->yes()) { $narrowedKey = TypeCombinator::union($varIterableKeyType, TypeCombinator::remove($varIterableKeyType->toString(), new ConstantStringType(''))); if (!$varType->hasOffsetValueType(new ConstantIntegerType(0))->no()) { $narrowedKey = TypeCombinator::union($narrowedKey, new ConstantBooleanType(\false)); } if (!$varType->hasOffsetValueType(new ConstantIntegerType(1))->no()) { $narrowedKey = TypeCombinator::union($narrowedKey, new ConstantBooleanType(\true)); } if (!$varType->hasOffsetValueType(new ConstantStringType(''))->no()) { $narrowedKey = TypeCombinator::addNull($narrowedKey); } if (!$varIterableKeyType->isNumericString()->no() || !$varIterableKeyType->isInteger()->no()) { $narrowedKey = TypeCombinator::union($narrowedKey, new FloatType()); } return $narrowedKey; } elseif ($varIterableKeyType->isInteger()->yes() && $keyType->isString()->yes()) { return TypeCombinator::intersect($varIterableKeyType->toString(), $keyType); } return new MixedType(\false, new UnionType([new ArrayType(new MixedType(), new MixedType()), new ObjectWithoutClassType(), new ResourceType()])); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Arrays; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; /** * @implements Rule<Node\Stmt\Foreach_> */ final class DeadForeachRule implements Rule { public function getNodeType() : string { return Node\Stmt\Foreach_::class; } public function processNode(Node $node, Scope $scope) : array { $iterableType = $scope->getType($node->expr); if ($iterableType->isIterable()->no()) { return []; } if (!$iterableType->isIterableAtLeastOnce()->no()) { return []; } return [RuleErrorBuilder::message('Empty array passed to foreach.')->identifier('foreach.emptyArray')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Arrays; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\LiteralArrayNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Rules\RuleLevelHelper; use PHPStan\Type\ErrorType; use PHPStan\Type\Type; use PHPStan\Type\VerbosityLevel; use function sprintf; /** * @implements Rule<LiteralArrayNode> */ final class UnpackIterableInArrayRule implements Rule { /** * @var RuleLevelHelper */ private $ruleLevelHelper; public function __construct(RuleLevelHelper $ruleLevelHelper) { $this->ruleLevelHelper = $ruleLevelHelper; } public function getNodeType() : string { return LiteralArrayNode::class; } public function processNode(Node $node, Scope $scope) : array { $errors = []; foreach ($node->getItemNodes() as $itemNode) { $item = $itemNode->getArrayItem(); if ($item === null) { continue; } if (!$item->unpack) { continue; } $typeResult = $this->ruleLevelHelper->findTypeToCheck($scope, $item->value, '', static function (Type $type) : bool { return $type->isIterable()->yes(); }); $type = $typeResult->getType(); if ($type instanceof ErrorType) { continue; } if ($type->isIterable()->yes()) { continue; } $errors[] = RuleErrorBuilder::message(sprintf('Only iterables can be unpacked, %s given.', $type->describe(VerbosityLevel::typeOnly())))->identifier('arrayUnpacking.nonIterable')->line($item->getStartLine())->build(); } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Arrays; use PhpParser\Node; use PhpParser\Node\Expr\ArrayDimFetch; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Rules\RuleLevelHelper; use PHPStan\Type\ErrorType; use PHPStan\Type\MixedType; use PHPStan\Type\Type; use PHPStan\Type\VerbosityLevel; use function sprintf; /** * @implements Rule<Node\Expr\AssignOp> */ final class OffsetAccessAssignOpRule implements Rule { /** * @var RuleLevelHelper */ private $ruleLevelHelper; public function __construct(RuleLevelHelper $ruleLevelHelper) { $this->ruleLevelHelper = $ruleLevelHelper; } public function getNodeType() : string { return Node\Expr\AssignOp::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->var instanceof ArrayDimFetch) { return []; } $arrayDimFetch = $node->var; $potentialDimType = null; if ($arrayDimFetch->dim !== null) { $potentialDimType = $scope->getType($arrayDimFetch->dim); } $varTypeResult = $this->ruleLevelHelper->findTypeToCheck($scope, $arrayDimFetch->var, '', static function (Type $varType) use($potentialDimType) : bool { $arrayDimType = $varType->setOffsetValueType($potentialDimType, new MixedType()); return !$arrayDimType instanceof ErrorType; }); $varType = $varTypeResult->getType(); if ($arrayDimFetch->dim !== null) { $dimTypeResult = $this->ruleLevelHelper->findTypeToCheck($scope, $arrayDimFetch->dim, '', static function (Type $dimType) use($varType) : bool { $arrayDimType = $varType->setOffsetValueType($dimType, new MixedType()); return !$arrayDimType instanceof ErrorType; }); $dimType = $dimTypeResult->getType(); if ($varType->hasOffsetValueType($dimType)->no()) { return []; } } else { $dimType = $potentialDimType; } $resultType = $varType->setOffsetValueType($dimType, new MixedType()); if (!$resultType instanceof ErrorType) { return []; } if ($dimType === null) { return [RuleErrorBuilder::message(sprintf('Cannot assign new offset to %s.', $varType->describe(VerbosityLevel::typeOnly())))->identifier('offsetAssign.dimType')->build()]; } return [RuleErrorBuilder::message(sprintf('Cannot assign offset %s to %s.', $dimType->describe(VerbosityLevel::value()), $varType->describe(VerbosityLevel::typeOnly())))->identifier('offsetAssign.dimType')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Arrays; use PhpParser\Node; use PHPStan\Analyser\NullsafeOperatorHelper; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Rules\RuleLevelHelper; use PHPStan\Type\ErrorType; use PHPStan\Type\MixedType; use PHPStan\Type\Type; use PHPStan\Type\VerbosityLevel; use function sprintf; /** * @implements Rule<Node\Expr\ArrayDimFetch> */ final class OffsetAccessAssignmentRule implements Rule { /** * @var RuleLevelHelper */ private $ruleLevelHelper; public function __construct(RuleLevelHelper $ruleLevelHelper) { $this->ruleLevelHelper = $ruleLevelHelper; } public function getNodeType() : string { return Node\Expr\ArrayDimFetch::class; } public function processNode(Node $node, Scope $scope) : array { if (!$scope->isInExpressionAssign($node)) { return []; } $potentialDimType = null; if ($node->dim !== null) { $potentialDimType = $scope->getType($node->dim); } $varTypeResult = $this->ruleLevelHelper->findTypeToCheck($scope, NullsafeOperatorHelper::getNullsafeShortcircuitedExprRespectingScope($scope, $node->var), '', static function (Type $varType) use($potentialDimType) : bool { $arrayDimType = $varType->setOffsetValueType($potentialDimType, new MixedType()); return !$arrayDimType instanceof ErrorType; }); $varType = $varTypeResult->getType(); if ($varType instanceof ErrorType) { return []; } if (!$varType->isOffsetAccessible()->yes()) { return []; } if ($node->dim !== null) { $dimTypeResult = $this->ruleLevelHelper->findTypeToCheck($scope, $node->dim, '', static function (Type $dimType) use($varType) : bool { $arrayDimType = $varType->setOffsetValueType($dimType, new MixedType()); return !$arrayDimType instanceof ErrorType; }); $dimType = $dimTypeResult->getType(); } else { $dimType = $potentialDimType; } $resultType = $varType->setOffsetValueType($dimType, new MixedType()); if (!$resultType instanceof ErrorType) { return []; } if ($dimType === null) { return [RuleErrorBuilder::message(sprintf('Cannot assign new offset to %s.', $varType->describe(VerbosityLevel::typeOnly())))->identifier('offsetAssign.dimType')->build()]; } return [RuleErrorBuilder::message(sprintf('Cannot assign offset %s to %s.', $dimType->describe(VerbosityLevel::value()), $varType->describe(VerbosityLevel::typeOnly())))->identifier('offsetAssign.dimType')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Arrays; use PhpParser\Node; use PhpParser\Node\Expr; use PhpParser\Node\Expr\Assign; use PhpParser\Node\Expr\AssignOp; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Rules\RuleLevelHelper; use PHPStan\Type\ErrorType; use PHPStan\Type\MixedType; use PHPStan\Type\Type; use PHPStan\Type\VerbosityLevel; use function sprintf; /** * @implements Rule<Expr> */ final class OffsetAccessValueAssignmentRule implements Rule { /** * @var RuleLevelHelper */ private $ruleLevelHelper; public function __construct(RuleLevelHelper $ruleLevelHelper) { $this->ruleLevelHelper = $ruleLevelHelper; } public function getNodeType() : string { return Expr::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node instanceof Assign && !$node instanceof AssignOp && !$node instanceof Expr\AssignRef) { return []; } if (!$node->var instanceof Expr\ArrayDimFetch) { return []; } $arrayDimFetch = $node->var; $varType = $scope->getType($arrayDimFetch->var); if ($varType->isObject()->no()) { return []; } if ($node instanceof Assign || $node instanceof Expr\AssignRef) { $assignedValueType = $scope->getType($node->expr); } else { $assignedValueType = $scope->getType($node); } $arrayTypeResult = $this->ruleLevelHelper->findTypeToCheck($scope, $arrayDimFetch->var, '', static function (Type $varType) use($assignedValueType) : bool { $result = $varType->setOffsetValueType(new MixedType(), $assignedValueType); return !$result instanceof ErrorType; }); $arrayType = $arrayTypeResult->getType(); if ($arrayType instanceof ErrorType) { return []; } $isOffsetAccessible = $arrayType->isOffsetAccessible(); if (!$isOffsetAccessible->yes()) { return []; } $resultType = $arrayType->setOffsetValueType(new MixedType(), $assignedValueType); if (!$resultType instanceof ErrorType) { return []; } $originalArrayType = $scope->getType($arrayDimFetch->var); return [RuleErrorBuilder::message(sprintf('%s does not accept %s.', $originalArrayType->describe(VerbosityLevel::value()), $assignedValueType->describe(VerbosityLevel::typeOnly())))->identifier('offsetAssign.valueType')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Arrays; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\MixedType; use PHPStan\Type\VerbosityLevel; use function sprintf; /** * @implements Rule<Node\Expr\ArrayItem> */ final class InvalidKeyInArrayItemRule implements Rule { /** * @var bool */ private $reportMaybes; public function __construct(bool $reportMaybes) { $this->reportMaybes = $reportMaybes; } public function getNodeType() : string { return Node\Expr\ArrayItem::class; } public function processNode(Node $node, Scope $scope) : array { if ($node->key === null) { return []; } $dimensionType = $scope->getType($node->key); $isSuperType = \PHPStan\Rules\Arrays\AllowedArrayKeysTypes::getType()->isSuperTypeOf($dimensionType); if ($isSuperType->no()) { return [RuleErrorBuilder::message(sprintf('Invalid array key type %s.', $dimensionType->describe(VerbosityLevel::typeOnly())))->identifier('array.invalidKey')->build()]; } elseif ($this->reportMaybes && $isSuperType->maybe() && !$dimensionType instanceof MixedType) { return [RuleErrorBuilder::message(sprintf('Possibly invalid array key type %s.', $dimensionType->describe(VerbosityLevel::typeOnly())))->identifier('array.invalidKey')->build()]; } return []; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Arrays; use PhpParser\Node; use PhpParser\Node\Expr\ArrayItem; use PHPStan\Analyser\Scope; use PHPStan\Node\Expr\GetIterableKeyTypeExpr; use PHPStan\Php\PhpVersion; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Rules\RuleLevelHelper; use PHPStan\Type\ErrorType; use PHPStan\Type\Type; use PHPStan\Type\VerbosityLevel; use function sprintf; /** * @implements Rule<ArrayItem> */ final class ArrayUnpackingRule implements Rule { /** * @var PhpVersion */ private $phpVersion; /** * @var RuleLevelHelper */ private $ruleLevelHelper; public function __construct(PhpVersion $phpVersion, RuleLevelHelper $ruleLevelHelper) { $this->phpVersion = $phpVersion; $this->ruleLevelHelper = $ruleLevelHelper; } public function getNodeType() : string { return ArrayItem::class; } public function processNode(Node $node, Scope $scope) : array { if ($node->unpack === \false || $this->phpVersion->supportsArrayUnpackingWithStringKeys()) { return []; } $typeResult = $this->ruleLevelHelper->findTypeToCheck($scope, new GetIterableKeyTypeExpr($node->value), '', static function (Type $type) : bool { return $type->isString()->no(); }); $keyType = $typeResult->getType(); if ($keyType instanceof ErrorType) { return $typeResult->getUnknownClassErrors(); } $isString = $keyType->isString(); if ($isString->no()) { return []; } return [RuleErrorBuilder::message(sprintf('Array unpacking cannot be used on an array with %sstring keys: %s', $isString->yes() ? '' : 'potential ', $scope->getType($node->value)->describe(VerbosityLevel::value())))->identifier('arrayUnpacking.stringOffset')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Arrays; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\LiteralArrayNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; /** * @implements Rule<LiteralArrayNode> */ final class EmptyArrayItemRule implements Rule { public function getNodeType() : string { return LiteralArrayNode::class; } public function processNode(Node $node, Scope $scope) : array { foreach ($node->getItemNodes() as $itemNode) { $item = $itemNode->getArrayItem(); if ($item !== null) { continue; } return [RuleErrorBuilder::message('Literal array contains empty item.')->nonIgnorable()->identifier('array.emptyItem')->build()]; } return []; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Arrays; use ArrayAccess; use PhpParser\Node; use PhpParser\Node\Expr; use PhpParser\Node\Expr\Assign; use PHPStan\Analyser\Scope; use PHPStan\Node\Expr\TypeExpr; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Rules\RuleLevelHelper; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\ErrorType; use PHPStan\Type\ObjectType; use PHPStan\Type\Type; use PHPStan\Type\VerbosityLevel; use function array_merge; use function sprintf; /** * @implements Rule<Assign> */ final class ArrayDestructuringRule implements Rule { /** * @var RuleLevelHelper */ private $ruleLevelHelper; /** * @var NonexistentOffsetInArrayDimFetchCheck */ private $nonexistentOffsetInArrayDimFetchCheck; public function __construct(RuleLevelHelper $ruleLevelHelper, \PHPStan\Rules\Arrays\NonexistentOffsetInArrayDimFetchCheck $nonexistentOffsetInArrayDimFetchCheck) { $this->ruleLevelHelper = $ruleLevelHelper; $this->nonexistentOffsetInArrayDimFetchCheck = $nonexistentOffsetInArrayDimFetchCheck; } public function getNodeType() : string { return Assign::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->var instanceof Node\Expr\List_ && !$node->var instanceof Node\Expr\Array_) { return []; } return $this->getErrors($scope, $node->var, $node->expr); } /** * @param Node\Expr\List_|Node\Expr\Array_ $var * @return list<IdentifierRuleError> */ private function getErrors(Scope $scope, Expr $var, Expr $expr) : array { $exprTypeResult = $this->ruleLevelHelper->findTypeToCheck($scope, $expr, '', static function (Type $varType) : bool { return $varType->isArray()->yes() || (new ObjectType(ArrayAccess::class))->isSuperTypeOf($varType)->yes(); }); $exprType = $exprTypeResult->getType(); if ($exprType instanceof ErrorType) { return []; } if (!$exprType->isArray()->yes() && !(new ObjectType(ArrayAccess::class))->isSuperTypeOf($exprType)->yes()) { return [RuleErrorBuilder::message(sprintf('Cannot use array destructuring on %s.', $exprType->describe(VerbosityLevel::typeOnly())))->identifier('offsetAccess.nonArray')->build()]; } $errors = []; $i = 0; foreach ($var->items as $item) { if ($item === null) { $i++; continue; } $keyExpr = null; if ($item->key === null) { $keyType = new ConstantIntegerType($i); $keyExpr = new Node\Scalar\LNumber($i); } else { $keyType = $scope->getType($item->key); $keyExpr = new TypeExpr($keyType); } $itemErrors = $this->nonexistentOffsetInArrayDimFetchCheck->check($scope, $expr, '', $keyType); $errors = array_merge($errors, $itemErrors); if (!$item->value instanceof Node\Expr\List_ && !$item->value instanceof Node\Expr\Array_) { $i++; continue; } $errors = array_merge($errors, $this->getErrors($scope, $item->value, new Expr\ArrayDimFetch($expr, $keyExpr))); } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Arrays; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Rules\RuleLevelHelper; use PHPStan\Type\ErrorType; use PHPStan\Type\MixedType; use PHPStan\Type\Type; use PHPStan\Type\VerbosityLevel; use function sprintf; /** * @implements Rule<Node\Expr\ArrayDimFetch> */ final class InvalidKeyInArrayDimFetchRule implements Rule { /** * @var RuleLevelHelper */ private $ruleLevelHelper; /** * @var bool */ private $reportMaybes; public function __construct(RuleLevelHelper $ruleLevelHelper, bool $reportMaybes) { $this->ruleLevelHelper = $ruleLevelHelper; $this->reportMaybes = $reportMaybes; } public function getNodeType() : string { return Node\Expr\ArrayDimFetch::class; } public function processNode(Node $node, Scope $scope) : array { if ($node->dim === null) { return []; } $dimensionType = $scope->getType($node->dim); if ($dimensionType instanceof MixedType) { return []; } $varType = $this->ruleLevelHelper->findTypeToCheck($scope, $node->var, '', static function (Type $varType) use($dimensionType) : bool { return $varType->isArray()->no() || \PHPStan\Rules\Arrays\AllowedArrayKeysTypes::getType()->isSuperTypeOf($dimensionType)->yes(); })->getType(); if ($varType instanceof ErrorType || $varType->isArray()->no()) { return []; } $isSuperType = \PHPStan\Rules\Arrays\AllowedArrayKeysTypes::getType()->isSuperTypeOf($dimensionType); if ($isSuperType->yes() || $isSuperType->maybe() && !$this->reportMaybes) { return []; } return [RuleErrorBuilder::message(sprintf('%s array key type %s.', $isSuperType->no() ? 'Invalid' : 'Possibly invalid', $dimensionType->describe(VerbosityLevel::typeOnly())))->identifier('offsetAccess.invalidOffset')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Arrays; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\InForeachNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Rules\RuleLevelHelper; use PHPStan\Type\ErrorType; use PHPStan\Type\Type; use PHPStan\Type\VerbosityLevel; use function sprintf; /** * @implements Rule<InForeachNode> */ final class IterableInForeachRule implements Rule { /** * @var RuleLevelHelper */ private $ruleLevelHelper; public function __construct(RuleLevelHelper $ruleLevelHelper) { $this->ruleLevelHelper = $ruleLevelHelper; } public function getNodeType() : string { return InForeachNode::class; } public function processNode(Node $node, Scope $scope) : array { $originalNode = $node->getOriginalNode(); $typeResult = $this->ruleLevelHelper->findTypeToCheck($scope, $originalNode->expr, 'Iterating over an object of an unknown class %s.', static function (Type $type) : bool { return $type->isIterable()->yes(); }); $type = $typeResult->getType(); if ($type instanceof ErrorType) { return $typeResult->getUnknownClassErrors(); } if ($type->isIterable()->yes()) { return []; } return [RuleErrorBuilder::message(sprintf('Argument of an invalid type %s supplied for foreach, only iterables are supported.', $type->describe(VerbosityLevel::typeOnly())))->identifier('foreach.nonIterable')->line($originalNode->expr->getStartLine())->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Arrays; use PhpParser\Node; use PhpParser\Node\Expr\ArrayDimFetch; use PhpParser\Node\Expr\Assign; use PhpParser\Node\Expr\AssignOp; use PhpParser\Node\Expr\AssignRef; use PHPStan\Analyser\Scope; use PHPStan\Rules\Properties\PropertyReflectionFinder; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Rules\RuleLevelHelper; use PHPStan\Type\VerbosityLevel; use function sprintf; /** * @deprecated Replaced by PHPStan\Rules\Properties\TypesAssignedToPropertiesRule * @implements Rule<Node\Expr> */ final class AppendedArrayItemTypeRule implements Rule { /** * @var PropertyReflectionFinder */ private $propertyReflectionFinder; /** * @var RuleLevelHelper */ private $ruleLevelHelper; public function __construct(PropertyReflectionFinder $propertyReflectionFinder, RuleLevelHelper $ruleLevelHelper) { $this->propertyReflectionFinder = $propertyReflectionFinder; $this->ruleLevelHelper = $ruleLevelHelper; } public function getNodeType() : string { return Node\Expr::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node instanceof Assign && !$node instanceof AssignOp && !$node instanceof AssignRef) { return []; } if (!$node->var instanceof ArrayDimFetch) { return []; } if (!$node->var->var instanceof Node\Expr\PropertyFetch && !$node->var->var instanceof Node\Expr\StaticPropertyFetch) { return []; } $propertyReflection = $this->propertyReflectionFinder->findPropertyReflectionFromNode($node->var->var, $scope); if ($propertyReflection === null) { return []; } $assignedToType = $propertyReflection->getWritableType(); if (!$assignedToType->isArray()->yes()) { return []; } if ($node instanceof Assign || $node instanceof AssignRef) { $assignedValueType = $scope->getType($node->expr); } else { $assignedValueType = $scope->getType($node); } $itemType = $assignedToType->getIterableValueType(); $accepts = $this->ruleLevelHelper->acceptsWithReason($itemType, $assignedValueType, $scope->isDeclareStrictTypes()); if (!$accepts->result) { $verbosityLevel = VerbosityLevel::getRecommendedLevelByType($itemType, $assignedValueType); return [RuleErrorBuilder::message(sprintf('Array (%s) does not accept %s.', $assignedToType->describe($verbosityLevel), $assignedValueType->describe($verbosityLevel)))->acceptsReasonsTip($accepts->reasons)->identifier('array.valueType')->build()]; } return []; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Arrays; use PhpParser\Node\Expr; use PHPStan\Analyser\NullsafeOperatorHelper; use PHPStan\Analyser\Scope; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Rules\RuleLevelHelper; use PHPStan\Type\BenevolentUnionType; use PHPStan\Type\ErrorType; use PHPStan\Type\Type; use PHPStan\Type\TypeUtils; use PHPStan\Type\UnionType; use PHPStan\Type\VerbosityLevel; use function sprintf; final class NonexistentOffsetInArrayDimFetchCheck { /** * @var RuleLevelHelper */ private $ruleLevelHelper; /** * @var bool */ private $reportMaybes; /** * @var bool */ private $bleedingEdge; /** * @var bool */ private $reportPossiblyNonexistentGeneralArrayOffset; /** * @var bool */ private $reportPossiblyNonexistentConstantArrayOffset; public function __construct(RuleLevelHelper $ruleLevelHelper, bool $reportMaybes, bool $bleedingEdge, bool $reportPossiblyNonexistentGeneralArrayOffset, bool $reportPossiblyNonexistentConstantArrayOffset) { $this->ruleLevelHelper = $ruleLevelHelper; $this->reportMaybes = $reportMaybes; $this->bleedingEdge = $bleedingEdge; $this->reportPossiblyNonexistentGeneralArrayOffset = $reportPossiblyNonexistentGeneralArrayOffset; $this->reportPossiblyNonexistentConstantArrayOffset = $reportPossiblyNonexistentConstantArrayOffset; } /** * @return list<IdentifierRuleError> */ public function check(Scope $scope, Expr $var, string $unknownClassPattern, Type $dimType) : array { $typeResult = $this->ruleLevelHelper->findTypeToCheck($scope, NullsafeOperatorHelper::getNullsafeShortcircuitedExprRespectingScope($scope, $var), $unknownClassPattern, static function (Type $type) use($dimType) : bool { return $type->hasOffsetValueType($dimType)->yes(); }); $type = $typeResult->getType(); if ($type instanceof ErrorType) { return $typeResult->getUnknownClassErrors(); } if ($scope->isInExpressionAssign($var) || $scope->isUndefinedExpressionAllowed($var)) { return []; } if ($type->hasOffsetValueType($dimType)->no()) { return [RuleErrorBuilder::message(sprintf('Offset %s does not exist on %s.', $dimType->describe(VerbosityLevel::value()), $type->describe(VerbosityLevel::value())))->identifier('offsetAccess.notFound')->build()]; } if ($this->reportMaybes) { $report = \false; if ($type instanceof BenevolentUnionType) { $flattenedTypes = [$type]; } else { $flattenedTypes = TypeUtils::flattenTypes($type); } foreach ($flattenedTypes as $innerType) { if ($this->reportPossiblyNonexistentGeneralArrayOffset && $innerType->isArray()->yes() && !$innerType->isConstantArray()->yes() && !$innerType->hasOffsetValueType($dimType)->yes()) { $report = \true; break; } if ($this->reportPossiblyNonexistentConstantArrayOffset && $innerType->isConstantArray()->yes() && !$innerType->hasOffsetValueType($dimType)->yes()) { $report = \true; break; } if ($dimType instanceof UnionType) { if ($innerType->hasOffsetValueType($dimType)->no()) { $report = \true; break; } continue; } foreach (TypeUtils::flattenTypes($dimType) as $innerDimType) { if ($innerType->hasOffsetValueType($innerDimType)->no()) { $report = \true; break 2; } } } if ($report) { if ($this->bleedingEdge || $this->reportPossiblyNonexistentGeneralArrayOffset || $this->reportPossiblyNonexistentConstantArrayOffset) { return [RuleErrorBuilder::message(sprintf('Offset %s might not exist on %s.', $dimType->describe(VerbosityLevel::value()), $type->describe(VerbosityLevel::value())))->identifier('offsetAccess.notFound')->build()]; } return [RuleErrorBuilder::message(sprintf('Offset %s does not exist on %s.', $dimType->describe(VerbosityLevel::value()), $type->describe(VerbosityLevel::value())))->identifier('offsetAccess.notFound')->build()]; } } return []; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Arrays; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\LiteralArrayNode; use PHPStan\Node\Printer\ExprPrinter; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\ConstantScalarType; use function array_keys; use function count; use function implode; use function max; use function sprintf; use function var_export; /** * @implements Rule<LiteralArrayNode> */ final class DuplicateKeysInLiteralArraysRule implements Rule { /** * @var ExprPrinter */ private $exprPrinter; public function __construct(ExprPrinter $exprPrinter) { $this->exprPrinter = $exprPrinter; } public function getNodeType() : string { return LiteralArrayNode::class; } public function processNode(Node $node, Scope $scope) : array { $values = []; $duplicateKeys = []; $printedValues = []; $valueLines = []; /** * @var int|false|null $autoGeneratedIndex * - An int value represent the biggest integer used as array key. * When no key is provided this value + 1 will be used. * - Null is used as initializer instead of 0 to avoid issue with negative keys. * - False means a non-scalar value was encountered and we cannot be sure of the next keys. */ $autoGeneratedIndex = null; foreach ($node->getItemNodes() as $itemNode) { $item = $itemNode->getArrayItem(); if ($item === null) { $autoGeneratedIndex = \false; continue; } $key = $item->key; if ($key === null) { if ($autoGeneratedIndex === \false) { continue; } if ($autoGeneratedIndex === null) { $autoGeneratedIndex = 0; $keyType = new ConstantIntegerType(0); } else { $keyType = new ConstantIntegerType(++$autoGeneratedIndex); } } else { $keyType = $itemNode->getScope()->getType($key); $arrayKeyValue = $keyType->toArrayKey(); if ($arrayKeyValue instanceof ConstantIntegerType) { $autoGeneratedIndex = $autoGeneratedIndex === null ? $arrayKeyValue->getValue() : max($autoGeneratedIndex, $arrayKeyValue->getValue()); } } if (!$keyType instanceof ConstantScalarType) { $autoGeneratedIndex = \false; continue; } $value = $keyType->getValue(); $printedValue = $key !== null ? $this->exprPrinter->printExpr($key) : $value; $printedValues[$value][] = $printedValue; if (!isset($valueLines[$value])) { $valueLines[$value] = $item->getStartLine(); } $previousCount = count($values); $values[$value] = $printedValue; if ($previousCount !== count($values)) { continue; } $duplicateKeys[$value] = \true; } $messages = []; foreach (array_keys($duplicateKeys) as $value) { $messages[] = RuleErrorBuilder::message(sprintf('Array has %d %s with value %s (%s).', count($printedValues[$value]), count($printedValues[$value]) === 1 ? 'duplicate key' : 'duplicate keys', var_export($value, \true), implode(', ', $printedValues[$value])))->identifier('array.duplicateKey')->line($valueLines[$value])->build(); } return $messages; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Arrays; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; /** * @implements Rule<Node\Expr\ArrayDimFetch> */ final class OffsetAccessWithoutDimForReadingRule implements Rule { public function getNodeType() : string { return Node\Expr\ArrayDimFetch::class; } public function processNode(Node $node, Scope $scope) : array { if ($scope->isInExpressionAssign($node)) { return []; } if ($node->dim !== null) { return []; } return [RuleErrorBuilder::message('Cannot use [] for reading.')->identifier('offsetAccess.noDim')->nonIgnorable()->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Arrays; use PhpParser\Node; use PHPStan\Analyser\NullsafeOperatorHelper; use PHPStan\Analyser\Scope; use PHPStan\Internal\SprintfHelper; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Rules\RuleLevelHelper; use PHPStan\Type\ErrorType; use PHPStan\Type\Type; use PHPStan\Type\VerbosityLevel; use function sprintf; /** * @implements Rule<Node\Expr\ArrayDimFetch> */ final class NonexistentOffsetInArrayDimFetchRule implements Rule { /** * @var RuleLevelHelper */ private $ruleLevelHelper; /** * @var NonexistentOffsetInArrayDimFetchCheck */ private $nonexistentOffsetInArrayDimFetchCheck; /** * @var bool */ private $reportMaybes; public function __construct(RuleLevelHelper $ruleLevelHelper, \PHPStan\Rules\Arrays\NonexistentOffsetInArrayDimFetchCheck $nonexistentOffsetInArrayDimFetchCheck, bool $reportMaybes) { $this->ruleLevelHelper = $ruleLevelHelper; $this->nonexistentOffsetInArrayDimFetchCheck = $nonexistentOffsetInArrayDimFetchCheck; $this->reportMaybes = $reportMaybes; } public function getNodeType() : string { return Node\Expr\ArrayDimFetch::class; } public function processNode(Node $node, Scope $scope) : array { if ($node->dim !== null) { $dimType = $scope->getType($node->dim); $unknownClassPattern = sprintf('Access to offset %s on an unknown class %%s.', SprintfHelper::escapeFormatString($dimType->describe(VerbosityLevel::value()))); } else { $dimType = null; $unknownClassPattern = 'Access to an offset on an unknown class %s.'; } $isOffsetAccessibleTypeResult = $this->ruleLevelHelper->findTypeToCheck($scope, NullsafeOperatorHelper::getNullsafeShortcircuitedExprRespectingScope($scope, $node->var), $unknownClassPattern, static function (Type $type) : bool { return $type->isOffsetAccessible()->yes(); }); $isOffsetAccessibleType = $isOffsetAccessibleTypeResult->getType(); if ($isOffsetAccessibleType instanceof ErrorType) { return $isOffsetAccessibleTypeResult->getUnknownClassErrors(); } if ($scope->hasExpressionType($node)->yes()) { return []; } $isOffsetAccessible = $isOffsetAccessibleType->isOffsetAccessible(); if ($scope->isInExpressionAssign($node) && $isOffsetAccessible->yes()) { return []; } if ($scope->isUndefinedExpressionAllowed($node) && $isOffsetAccessibleType->isOffsetAccessLegal()->yes()) { return []; } if (!$isOffsetAccessible->yes()) { if ($isOffsetAccessible->no() || $this->reportMaybes) { if ($dimType !== null) { return [RuleErrorBuilder::message(sprintf('Cannot access offset %s on %s.', $dimType->describe(VerbosityLevel::value()), $isOffsetAccessibleType->describe(VerbosityLevel::value())))->identifier('offsetAccess.nonOffsetAccessible')->build()]; } return [RuleErrorBuilder::message(sprintf('Cannot access an offset on %s.', $isOffsetAccessibleType->describe(VerbosityLevel::typeOnly())))->identifier('offsetAccess.nonOffsetAccessible')->build()]; } return []; } if ($dimType === null) { return []; } return $this->nonexistentOffsetInArrayDimFetchCheck->check($scope, $node->var, $unknownClassPattern, $dimType); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Arrays; use PhpParser\Node; use PhpParser\Node\Expr\ArrayDimFetch; use PhpParser\Node\Expr\Assign; use PHPStan\Analyser\Scope; use PHPStan\Rules\Properties\PropertyReflectionFinder; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\IntegerType; use PHPStan\Type\UnionType; use PHPStan\Type\VerbosityLevel; use function sprintf; /** * @deprecated Replaced by PHPStan\Rules\Properties\TypesAssignedToPropertiesRule * @implements Rule<Node\Expr\Assign> */ final class AppendedArrayKeyTypeRule implements Rule { /** * @var PropertyReflectionFinder */ private $propertyReflectionFinder; /** * @var bool */ private $checkUnionTypes; public function __construct(PropertyReflectionFinder $propertyReflectionFinder, bool $checkUnionTypes) { $this->propertyReflectionFinder = $propertyReflectionFinder; $this->checkUnionTypes = $checkUnionTypes; } public function getNodeType() : string { return Assign::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->var instanceof ArrayDimFetch) { return []; } if (!$node->var->var instanceof Node\Expr\PropertyFetch && !$node->var->var instanceof Node\Expr\StaticPropertyFetch) { return []; } $propertyReflection = $this->propertyReflectionFinder->findPropertyReflectionFromNode($node->var->var, $scope); if ($propertyReflection === null) { return []; } $arrayType = $propertyReflection->getReadableType(); if (!$arrayType->isArray()->yes()) { return []; } if ($node->var->dim !== null) { $dimensionType = $scope->getType($node->var->dim); $isValidKey = \PHPStan\Rules\Arrays\AllowedArrayKeysTypes::getType()->isSuperTypeOf($dimensionType); if (!$isValidKey->yes()) { // already handled by InvalidKeyInArrayDimFetchRule return []; } $keyType = $dimensionType->toArrayKey(); if (!$this->checkUnionTypes && $keyType instanceof UnionType) { return []; } } else { $keyType = new IntegerType(); } if (!$arrayType->getIterableKeyType()->isSuperTypeOf($keyType)->yes()) { $verbosity = VerbosityLevel::getRecommendedLevelByType($arrayType->getIterableKeyType(), $keyType); return [RuleErrorBuilder::message(sprintf('Array (%s) does not accept key %s.', $arrayType->describe($verbosity), $keyType->describe(VerbosityLevel::value())))->identifier('array.keyType')->build()]; } return []; } } <?php declare (strict_types=1); namespace PHPStan\Rules\PhpDoc; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\InFunctionNode; use PHPStan\Rules\Rule; use function count; /** * @implements Rule<InFunctionNode> */ final class FunctionAssertRule implements Rule { /** * @var AssertRuleHelper */ private $helper; public function __construct(\PHPStan\Rules\PhpDoc\AssertRuleHelper $helper) { $this->helper = $helper; } public function getNodeType() : string { return InFunctionNode::class; } public function processNode(Node $node, Scope $scope) : array { $function = $node->getFunctionReflection(); $variants = $function->getVariants(); if (count($variants) !== 1) { return []; } return $this->helper->check($node->getOriginalNode(), $function, $variants[0]); } } <?php declare (strict_types=1); namespace PHPStan\Rules\PhpDoc; use PhpParser\Node; use PhpParser\Node\Expr\Variable; use PhpParser\Node\FunctionLike; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\ShouldNotHappenException; use PHPStan\Type\FileTypeMapper; use PHPStan\Type\VerbosityLevel; use function is_string; use function sprintf; use function trim; /** * @implements Rule<FunctionLike> */ final class IncompatibleParamImmediatelyInvokedCallableRule implements Rule { /** * @var FileTypeMapper */ private $fileTypeMapper; public function __construct(FileTypeMapper $fileTypeMapper) { $this->fileTypeMapper = $fileTypeMapper; } public function getNodeType() : string { return FunctionLike::class; } public function processNode(Node $node, Scope $scope) : array { if ($node instanceof Node\Stmt\ClassMethod) { $functionName = $node->name->name; } elseif ($node instanceof Node\Stmt\Function_) { $functionName = trim($scope->getNamespace() . '\\' . $node->name->name, '\\'); } else { return []; } $docComment = $node->getDocComment(); if ($docComment === null) { return []; } $resolvedPhpDoc = $this->fileTypeMapper->getResolvedPhpDoc($scope->getFile(), $scope->isInClass() ? $scope->getClassReflection()->getName() : null, $scope->isInTrait() ? $scope->getTraitReflection()->getName() : null, $functionName, $docComment->getText()); $nativeParameterTypes = []; foreach ($node->getParams() as $parameter) { if (!$parameter->var instanceof Variable || !is_string($parameter->var->name)) { throw new ShouldNotHappenException(); } $nativeParameterTypes[$parameter->var->name] = $scope->getFunctionType($parameter->type, $scope->isParameterValueNullable($parameter), \false); } $errors = []; foreach ($resolvedPhpDoc->getParamsImmediatelyInvokedCallable() as $parameterName => $immediately) { $tagName = $immediately ? '@param-immediately-invoked-callable' : '@param-later-invoked-callable'; if (!isset($nativeParameterTypes[$parameterName])) { $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag %s references unknown parameter: $%s', $tagName, $parameterName))->identifier('parameter.notFound')->build(); } elseif ($nativeParameterTypes[$parameterName]->isCallable()->no()) { $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag %s is for parameter $%s with non-callable type %s.', $tagName, $parameterName, $nativeParameterTypes[$parameterName]->describe(VerbosityLevel::typeOnly())))->identifier(sprintf('%s.nonCallable', $immediately ? 'paramImmediatelyInvokedCallable' : 'paramLaterInvokedCallable'))->build(); } } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\PhpDoc; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\FileTypeMapper; use PHPStan\Type\ObjectType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\UnionType; use PHPStan\Type\VerbosityLevel; use Throwable; use function sprintf; /** * @implements Rule<Node\Stmt> */ final class InvalidThrowsPhpDocValueRule implements Rule { /** * @var FileTypeMapper */ private $fileTypeMapper; public function __construct(FileTypeMapper $fileTypeMapper) { $this->fileTypeMapper = $fileTypeMapper; } public function getNodeType() : string { return Node\Stmt::class; } public function processNode(Node $node, Scope $scope) : array { if ($node instanceof Node\Stmt\Function_ || $node instanceof Node\Stmt\ClassMethod) { return []; // is handled by virtual nodes } $docComment = $node->getDocComment(); if ($docComment === null) { return []; } $functionName = null; if ($scope->getFunction() !== null) { $functionName = $scope->getFunction()->getName(); } $resolvedPhpDoc = $this->fileTypeMapper->getResolvedPhpDoc($scope->getFile(), $scope->isInClass() ? $scope->getClassReflection()->getName() : null, $scope->isInTrait() ? $scope->getTraitReflection()->getName() : null, $functionName, $docComment->getText()); if ($resolvedPhpDoc->getThrowsTag() === null) { return []; } $phpDocThrowsType = $resolvedPhpDoc->getThrowsTag()->getType(); if ($phpDocThrowsType->isVoid()->yes()) { return []; } if ($this->isThrowsValid($phpDocThrowsType)) { return []; } return [RuleErrorBuilder::message(sprintf('PHPDoc tag @throws with type %s is not subtype of Throwable', $phpDocThrowsType->describe(VerbosityLevel::typeOnly())))->identifier('throws.notThrowable')->build()]; } private function isThrowsValid(Type $phpDocThrowsType) : bool { $throwType = new ObjectType(Throwable::class); if ($phpDocThrowsType instanceof UnionType) { foreach ($phpDocThrowsType->getTypes() as $innerType) { if (!$this->isThrowsValid($innerType)) { return \false; } } return \true; } $toIntersectWith = []; foreach ($phpDocThrowsType->getObjectClassReflections() as $classReflection) { if (!$classReflection->isInterface()) { continue; } foreach ($classReflection->getRequireExtendsTags() as $requireExtendsTag) { $toIntersectWith[] = $requireExtendsTag->getType(); } } return $throwType->isSuperTypeOf(TypeCombinator::intersect($phpDocThrowsType, ...$toIntersectWith))->yes(); } } <?php declare (strict_types=1); namespace PHPStan\Rules\PhpDoc; use PhpParser\Node; use PhpParser\Node\Expr\Variable; use PHPStan\Analyser\Scope; use PHPStan\Internal\SprintfHelper; use PHPStan\PhpDoc\Tag\ParamOutTag; use PHPStan\PhpDoc\Tag\ParamTag; use PHPStan\Rules\Generics\GenericObjectTypeCheck; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\ShouldNotHappenException; use PHPStan\Type\ClosureType; use PHPStan\Type\FileTypeMapper; use PHPStan\Type\Generic\TemplateType; use PHPStan\Type\Type; use PHPStan\Type\VerbosityLevel; use function array_merge; use function in_array; use function is_string; use function sprintf; use function trim; /** * @implements Rule<Node\FunctionLike> */ final class IncompatiblePhpDocTypeRule implements Rule { /** * @var FileTypeMapper */ private $fileTypeMapper; /** * @var GenericObjectTypeCheck */ private $genericObjectTypeCheck; /** * @var UnresolvableTypeHelper */ private $unresolvableTypeHelper; /** * @var GenericCallableRuleHelper */ private $genericCallableRuleHelper; public function __construct(FileTypeMapper $fileTypeMapper, GenericObjectTypeCheck $genericObjectTypeCheck, \PHPStan\Rules\PhpDoc\UnresolvableTypeHelper $unresolvableTypeHelper, \PHPStan\Rules\PhpDoc\GenericCallableRuleHelper $genericCallableRuleHelper) { $this->fileTypeMapper = $fileTypeMapper; $this->genericObjectTypeCheck = $genericObjectTypeCheck; $this->unresolvableTypeHelper = $unresolvableTypeHelper; $this->genericCallableRuleHelper = $genericCallableRuleHelper; } public function getNodeType() : string { return Node\FunctionLike::class; } public function processNode(Node $node, Scope $scope) : array { if ($node instanceof Node\Stmt\ClassMethod) { $functionName = $node->name->name; } elseif ($node instanceof Node\Stmt\Function_) { $functionName = trim($scope->getNamespace() . '\\' . $node->name->name, '\\'); } else { return []; } $docComment = $node->getDocComment(); if ($docComment === null) { return []; } $resolvedPhpDoc = $this->fileTypeMapper->getResolvedPhpDoc($scope->getFile(), $scope->isInClass() ? $scope->getClassReflection()->getName() : null, $scope->isInTrait() ? $scope->getTraitReflection()->getName() : null, $functionName, $docComment->getText()); $nativeParameterTypes = $this->getNativeParameterTypes($node, $scope); $byRefParameters = $this->getByRefParameters($node); $errors = []; foreach (['@param' => $resolvedPhpDoc->getParamTags(), '@param-out' => $resolvedPhpDoc->getParamOutTags(), '@param-closure-this' => $resolvedPhpDoc->getParamClosureThisTags()] as $tagName => $parameters) { foreach ($parameters as $parameterName => $phpDocParamTag) { $phpDocParamType = $phpDocParamTag->getType(); if (!isset($nativeParameterTypes[$parameterName])) { $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag %s references unknown parameter: $%s', $tagName, $parameterName))->identifier('parameter.notFound')->build(); } elseif ($this->unresolvableTypeHelper->containsUnresolvableType($phpDocParamType)) { $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag %s for parameter $%s contains unresolvable type.', $tagName, $parameterName))->identifier('parameter.unresolvableType')->build(); } else { $nativeParamType = $nativeParameterTypes[$parameterName]; if ($phpDocParamTag instanceof ParamTag && $phpDocParamTag->isVariadic() && $phpDocParamType->isArray()->yes() && $nativeParamType->isArray()->no()) { $phpDocParamType = $phpDocParamType->getIterableValueType(); } $escapedParameterName = SprintfHelper::escapeFormatString($parameterName); $escapedTagName = SprintfHelper::escapeFormatString($tagName); $errors = array_merge($errors, $this->genericObjectTypeCheck->check($phpDocParamType, sprintf('PHPDoc tag %s for parameter $%s contains generic type %%s but %%s %%s is not generic.', $escapedTagName, $escapedParameterName), sprintf('Generic type %%s in PHPDoc tag %s for parameter $%s does not specify all template types of %%s %%s: %%s', $escapedTagName, $escapedParameterName), sprintf('Generic type %%s in PHPDoc tag %s for parameter $%s specifies %%d template types, but %%s %%s supports only %%d: %%s', $escapedTagName, $escapedParameterName), sprintf('Type %%s in generic type %%s in PHPDoc tag %s for parameter $%s is not subtype of template type %%s of %%s %%s.', $escapedTagName, $escapedParameterName), sprintf('Call-site variance of %%s in generic type %%s in PHPDoc tag %s for parameter $%s is in conflict with %%s template type %%s of %%s %%s.', $escapedTagName, $escapedParameterName), sprintf('Call-site variance of %%s in generic type %%s in PHPDoc tag %s for parameter $%s is redundant, template type %%s of %%s %%s has the same variance.', $escapedTagName, $escapedParameterName))); $errors = array_merge($errors, $this->genericCallableRuleHelper->check($node, $scope, sprintf('%s for parameter $%s', $escapedTagName, $escapedParameterName), $phpDocParamType, $functionName, $resolvedPhpDoc->getTemplateTags(), $scope->isInClass() ? $scope->getClassReflection() : null)); if ($phpDocParamTag instanceof ParamOutTag) { if (!$byRefParameters[$parameterName]) { $errors[] = RuleErrorBuilder::message(sprintf('Parameter $%s for PHPDoc tag %s is not passed by reference.', $parameterName, $tagName))->identifier('parameter.notByRef')->build(); } continue; } if (in_array($tagName, ['@param', '@param-out'], \true)) { $isParamSuperType = $nativeParamType->isSuperTypeOf($phpDocParamType); if ($isParamSuperType->no()) { $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag %s for parameter $%s with type %s is incompatible with native type %s.', $tagName, $parameterName, $phpDocParamType->describe(VerbosityLevel::typeOnly()), $nativeParamType->describe(VerbosityLevel::typeOnly())))->identifier('parameter.phpDocType')->build(); } elseif ($isParamSuperType->maybe()) { $errorBuilder = RuleErrorBuilder::message(sprintf('PHPDoc tag %s for parameter $%s with type %s is not subtype of native type %s.', $tagName, $parameterName, $phpDocParamType->describe(VerbosityLevel::typeOnly()), $nativeParamType->describe(VerbosityLevel::typeOnly())))->identifier('parameter.phpDocType'); if ($phpDocParamType instanceof TemplateType) { $errorBuilder->tip(sprintf('Write @template %s of %s to fix this.', $phpDocParamType->getName(), $nativeParamType->describe(VerbosityLevel::typeOnly()))); } $errors[] = $errorBuilder->build(); } } if ($tagName === '@param-closure-this') { $isNonClosure = (new ClosureType())->isSuperTypeOf($nativeParamType)->no(); if ($isNonClosure) { $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag %s is for parameter $%s with non-Closure type %s.', $tagName, $parameterName, $nativeParamType->describe(VerbosityLevel::typeOnly())))->identifier('paramClosureThis.nonClosure')->build(); } } } } } if ($resolvedPhpDoc->getReturnTag() !== null) { $phpDocReturnType = $resolvedPhpDoc->getReturnTag()->getType(); if ($this->unresolvableTypeHelper->containsUnresolvableType($phpDocReturnType)) { $errors[] = RuleErrorBuilder::message('PHPDoc tag @return contains unresolvable type.')->identifier('return.unresolvableType')->build(); } else { $nativeReturnType = $this->getNativeReturnType($node, $scope); $isReturnSuperType = $nativeReturnType->isSuperTypeOf($phpDocReturnType); $errors = array_merge($errors, $this->genericObjectTypeCheck->check($phpDocReturnType, 'PHPDoc tag @return contains generic type %s but %s %s is not generic.', 'Generic type %s in PHPDoc tag @return does not specify all template types of %s %s: %s', 'Generic type %s in PHPDoc tag @return specifies %d template types, but %s %s supports only %d: %s', 'Type %s in generic type %s in PHPDoc tag @return is not subtype of template type %s of %s %s.', 'Call-site variance of %s in generic type %s in PHPDoc tag @return is in conflict with %s template type %s of %s %s.', 'Call-site variance of %s in generic type %s in PHPDoc tag @return is redundant, template type %s of %s %s has the same variance.')); if ($isReturnSuperType->no()) { $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag @return with type %s is incompatible with native type %s.', $phpDocReturnType->describe(VerbosityLevel::typeOnly()), $nativeReturnType->describe(VerbosityLevel::typeOnly())))->identifier('return.phpDocType')->build(); } elseif ($isReturnSuperType->maybe()) { $errorBuilder = RuleErrorBuilder::message(sprintf('PHPDoc tag @return with type %s is not subtype of native type %s.', $phpDocReturnType->describe(VerbosityLevel::typeOnly()), $nativeReturnType->describe(VerbosityLevel::typeOnly())))->identifier('return.phpDocType'); if ($phpDocReturnType instanceof TemplateType) { $errorBuilder->tip(sprintf('Write @template %s of %s to fix this.', $phpDocReturnType->getName(), $nativeReturnType->describe(VerbosityLevel::typeOnly()))); } $errors[] = $errorBuilder->build(); } $errors = array_merge($errors, $this->genericCallableRuleHelper->check($node, $scope, '@return', $phpDocReturnType, $functionName, $resolvedPhpDoc->getTemplateTags(), $scope->isInClass() ? $scope->getClassReflection() : null)); } } return $errors; } /** * @return Type[] */ private function getNativeParameterTypes(Node\FunctionLike $node, Scope $scope) : array { $nativeParameterTypes = []; foreach ($node->getParams() as $parameter) { $isNullable = $scope->isParameterValueNullable($parameter); if (!$parameter->var instanceof Variable || !is_string($parameter->var->name)) { throw new ShouldNotHappenException(); } $nativeParameterTypes[$parameter->var->name] = $scope->getFunctionType($parameter->type, $isNullable, \false); } return $nativeParameterTypes; } /** * @return array<string, bool> */ private function getByRefParameters(Node\FunctionLike $node) : array { $nativeParameterTypes = []; foreach ($node->getParams() as $parameter) { if (!$parameter->var instanceof Variable || !is_string($parameter->var->name)) { throw new ShouldNotHappenException(); } $nativeParameterTypes[$parameter->var->name] = $parameter->byRef; } return $nativeParameterTypes; } private function getNativeReturnType(Node\FunctionLike $node, Scope $scope) : Type { return $scope->getFunctionType($node->getReturnType(), \false, \false); } } <?php declare (strict_types=1); namespace PHPStan\Rules\PhpDoc; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\InClassMethodNode; use PHPStan\Rules\Rule; use function count; /** * @implements Rule<InClassMethodNode> */ final class MethodConditionalReturnTypeRule implements Rule { /** * @var ConditionalReturnTypeRuleHelper */ private $helper; public function __construct(\PHPStan\Rules\PhpDoc\ConditionalReturnTypeRuleHelper $helper) { $this->helper = $helper; } public function getNodeType() : string { return InClassMethodNode::class; } public function processNode(Node $node, Scope $scope) : array { $method = $node->getMethodReflection(); $variants = $method->getVariants(); if (count($variants) !== 1) { return []; } return $this->helper->check($variants[0]); } } <?php declare (strict_types=1); namespace PHPStan\Rules\PhpDoc; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Internal\SprintfHelper; use PHPStan\Node\InClassMethodNode; use PHPStan\Rules\Generics\GenericObjectTypeCheck; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\ObjectType; use PHPStan\Type\VerbosityLevel; use function array_merge; use function sprintf; /** * @implements Rule<InClassMethodNode> */ final class IncompatibleSelfOutTypeRule implements Rule { /** * @var UnresolvableTypeHelper */ private $unresolvableTypeHelper; /** * @var GenericObjectTypeCheck */ private $genericObjectTypeCheck; public function __construct(\PHPStan\Rules\PhpDoc\UnresolvableTypeHelper $unresolvableTypeHelper, GenericObjectTypeCheck $genericObjectTypeCheck) { $this->unresolvableTypeHelper = $unresolvableTypeHelper; $this->genericObjectTypeCheck = $genericObjectTypeCheck; } public function getNodeType() : string { return InClassMethodNode::class; } public function processNode(Node $node, Scope $scope) : array { $method = $node->getMethodReflection(); $selfOutType = $method->getSelfOutType(); if ($selfOutType === null) { return []; } $classReflection = $method->getDeclaringClass(); $classType = new ObjectType($classReflection->getName(), null, $classReflection); $errors = []; if (!$classType->isSuperTypeOf($selfOutType)->yes()) { $errors[] = RuleErrorBuilder::message(sprintf('Self-out type %s of method %s::%s is not subtype of %s.', $selfOutType->describe(VerbosityLevel::precise()), $classReflection->getDisplayName(), $method->getName(), $classType->describe(VerbosityLevel::precise())))->identifier('selfOut.type')->build(); } if ($method->isStatic()) { $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag @phpstan-self-out is not supported above static method %s::%s().', $classReflection->getName(), $method->getName()))->identifier('selfOut.static')->build(); } if ($this->unresolvableTypeHelper->containsUnresolvableType($selfOutType)) { $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag @phpstan-self-out for method %s::%s() contains unresolvable type.', $classReflection->getDisplayName(), $method->getName()))->identifier('selfOut.unresolvableType')->build(); } $escapedTagName = SprintfHelper::escapeFormatString('@phpstan-self-out'); return array_merge($errors, $this->genericObjectTypeCheck->check($selfOutType, sprintf('PHPDoc tag %s contains generic type %%s but %%s %%s is not generic.', $escapedTagName), sprintf('Generic type %%s in PHPDoc tag %s does not specify all template types of %%s %%s: %%s', $escapedTagName), sprintf('Generic type %%s in PHPDoc tag %s specifies %%d template types, but %%s %%s supports only %%d: %%s', $escapedTagName), sprintf('Type %%s in generic type %%s in PHPDoc tag %s is not subtype of template type %%s of %%s %%s.', $escapedTagName), sprintf('Call-site variance of %%s in generic type %%s in PHPDoc tag %s is in conflict with %%s template type %%s of %%s %%s.', $escapedTagName), sprintf('Call-site variance of %%s in generic type %%s in PHPDoc tag %s is redundant, template type %%s of %%s %%s has the same variance.', $escapedTagName))); } } <?php declare (strict_types=1); namespace PHPStan\Rules\PhpDoc; use PHPStan\Reflection\ParametersAcceptorWithPhpDocs; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\ConditionalType; use PHPStan\Type\ConditionalTypeForParameter; use PHPStan\Type\Generic\TemplateType; use PHPStan\Type\StaticType; use PHPStan\Type\Type; use PHPStan\Type\TypeTraverser; use PHPStan\Type\VerbosityLevel; use function array_key_exists; use function count; use function sprintf; use function substr; final class ConditionalReturnTypeRuleHelper { /** * @return list<IdentifierRuleError> */ public function check(ParametersAcceptorWithPhpDocs $acceptor) : array { $conditionalTypes = []; $parametersByName = []; foreach ($acceptor->getParameters() as $parameter) { TypeTraverser::map($parameter->getType(), static function (Type $type, callable $traverse) use(&$conditionalTypes) : Type { if ($type instanceof ConditionalType || $type instanceof ConditionalTypeForParameter) { $conditionalTypes[] = $type; } return $traverse($type); }); if ($parameter->getOutType() !== null) { TypeTraverser::map($parameter->getOutType(), static function (Type $type, callable $traverse) use(&$conditionalTypes) : Type { if ($type instanceof ConditionalType || $type instanceof ConditionalTypeForParameter) { $conditionalTypes[] = $type; } return $traverse($type); }); } if ($parameter->getClosureThisType() !== null) { TypeTraverser::map($parameter->getClosureThisType(), static function (Type $type, callable $traverse) use(&$conditionalTypes) : Type { if ($type instanceof ConditionalType || $type instanceof ConditionalTypeForParameter) { $conditionalTypes[] = $type; } return $traverse($type); }); } $parametersByName[$parameter->getName()] = $parameter; } TypeTraverser::map($acceptor->getReturnType(), static function (Type $type, callable $traverse) use(&$conditionalTypes) : Type { if ($type instanceof ConditionalType || $type instanceof ConditionalTypeForParameter) { $conditionalTypes[] = $type; } return $traverse($type); }); $errors = []; foreach ($conditionalTypes as $conditionalType) { if ($conditionalType instanceof ConditionalType) { $subjectType = $conditionalType->getSubject(); if ($subjectType instanceof StaticType) { continue; } $templateTypes = []; TypeTraverser::map($subjectType, static function (Type $type, callable $traverse) use(&$templateTypes) : Type { if ($type instanceof TemplateType) { $templateTypes[] = $type; return $type; } return $traverse($type); }); if (count($templateTypes) === 0) { $errors[] = RuleErrorBuilder::message(sprintf('Conditional return type uses subject type %s which is not part of PHPDoc @template tags.', $subjectType->describe(VerbosityLevel::typeOnly())))->identifier('conditionalType.subjectNotFound')->build(); continue; } } else { $parameterName = substr($conditionalType->getParameterName(), 1); if (!array_key_exists($parameterName, $parametersByName)) { $errors[] = RuleErrorBuilder::message(sprintf('Conditional return type references unknown parameter $%s.', $parameterName))->identifier('parameter.notFound')->build(); continue; } $subjectType = $parametersByName[$parameterName]->getType(); } $targetType = $conditionalType->getTarget(); $isTargetSuperType = $targetType->isSuperTypeOf($subjectType); if ($isTargetSuperType->maybe()) { continue; } $verbosity = VerbosityLevel::getRecommendedLevelByType($subjectType, $targetType); $errors[] = RuleErrorBuilder::message(sprintf('Condition "%s" in conditional return type is always %s.', sprintf('%s %s %s', $subjectType->describe($verbosity), $conditionalType->isNegated() ? 'is not' : 'is', $targetType->describe($verbosity)), $conditionalType->isNegated() ? $isTargetSuperType->yes() ? 'false' : 'true' : ($isTargetSuperType->yes() ? 'true' : 'false')))->identifier(sprintf('conditionalType.always%s', $conditionalType->isNegated() ? $isTargetSuperType->yes() ? 'False' : 'True' : ($isTargetSuperType->yes() ? 'True' : 'False')))->build(); } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\PhpDoc; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\ClassNameCheck; use PHPStan\Rules\ClassNameNodePair; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\ObjectType; use PHPStan\Type\VerbosityLevel; use function array_merge; use function sprintf; use function strtolower; /** * @implements Rule<Node\Stmt\Trait_> */ final class RequireImplementsDefinitionTraitRule implements Rule { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var ClassNameCheck */ private $classCheck; /** * @var bool */ private $checkClassCaseSensitivity; public function __construct(ReflectionProvider $reflectionProvider, ClassNameCheck $classCheck, bool $checkClassCaseSensitivity) { $this->reflectionProvider = $reflectionProvider; $this->classCheck = $classCheck; $this->checkClassCaseSensitivity = $checkClassCaseSensitivity; } public function getNodeType() : string { return Node\Stmt\Trait_::class; } public function processNode(Node $node, Scope $scope) : array { if ($node->namespacedName === null || !$this->reflectionProvider->hasClass($node->namespacedName->toString())) { return []; } $traitReflection = $this->reflectionProvider->getClass($node->namespacedName->toString()); $implementsTags = $traitReflection->getRequireImplementsTags(); $errors = []; foreach ($implementsTags as $implementsTag) { $type = $implementsTag->getType(); if (!$type instanceof ObjectType) { $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag @phpstan-require-implements contains non-object type %s.', $type->describe(VerbosityLevel::typeOnly())))->identifier('requireImplements.nonObject')->build(); continue; } $class = $type->getClassName(); $referencedClassReflection = $type->getClassReflection(); if ($referencedClassReflection === null) { $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag @phpstan-require-implements contains unknown class %s.', $class))->discoveringSymbolsTip()->identifier('class.notFound')->build(); continue; } if (!$referencedClassReflection->isInterface()) { $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag @phpstan-require-implements cannot contain non-interface type %s.', $class))->identifier(sprintf('requireImplements.%s', strtolower($referencedClassReflection->getClassTypeDescription())))->build(); } else { $errors = array_merge($errors, $this->classCheck->checkClassNames([new ClassNameNodePair($class, $node)], $this->checkClassCaseSensitivity)); } } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\PhpDoc; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\InClassNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function count; use function sprintf; /** * @implements Rule<InClassNode> */ final class RequireImplementsDefinitionClassRule implements Rule { public function getNodeType() : string { return InClassNode::class; } public function processNode(Node $node, Scope $scope) : array { $classReflection = $node->getClassReflection(); $implementsTags = $classReflection->getRequireImplementsTags(); if (count($implementsTags) === 0) { return []; } return [RuleErrorBuilder::message('PHPDoc tag @phpstan-require-implements is only valid on trait.')->identifier(sprintf('requireImplements.on%s', $classReflection->getClassTypeDescription()))->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\PhpDoc; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\Rule; /** * @implements Rule<Node\Stmt\Trait_> */ final class RequireExtendsDefinitionTraitRule implements Rule { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var RequireExtendsCheck */ private $requireExtendsCheck; public function __construct(ReflectionProvider $reflectionProvider, \PHPStan\Rules\PhpDoc\RequireExtendsCheck $requireExtendsCheck) { $this->reflectionProvider = $reflectionProvider; $this->requireExtendsCheck = $requireExtendsCheck; } public function getNodeType() : string { return Node\Stmt\Trait_::class; } public function processNode(Node $node, Scope $scope) : array { if ($node->namespacedName === null || !$this->reflectionProvider->hasClass($node->namespacedName->toString())) { return []; } $traitReflection = $this->reflectionProvider->getClass($node->namespacedName->toString()); $extendsTags = $traitReflection->getRequireExtendsTags(); return $this->requireExtendsCheck->checkExtendsTags($node, $extendsTags); } } <?php declare (strict_types=1); namespace PHPStan\Rules\PhpDoc; use _PHPStan_7d8742a37\Nette\Utils\Strings; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\VirtualNode; use PHPStan\PhpDocParser\Ast\PhpDoc\InvalidTagValueNode; use PHPStan\PhpDocParser\Ast\PhpDoc\TypeAliasTagValueNode; use PHPStan\PhpDocParser\Ast\Type\InvalidTypeNode; use PHPStan\PhpDocParser\Lexer\Lexer; use PHPStan\PhpDocParser\Parser\PhpDocParser; use PHPStan\PhpDocParser\Parser\TokenIterator; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function sprintf; use function str_starts_with; /** * @implements Rule<Node> */ final class InvalidPhpDocTagValueRule implements Rule { /** * @var Lexer */ private $phpDocLexer; /** * @var PhpDocParser */ private $phpDocParser; /** * @var bool */ private $checkAllInvalidPhpDocs; /** * @var bool */ private $invalidPhpDocTagLine; public function __construct(Lexer $phpDocLexer, PhpDocParser $phpDocParser, bool $checkAllInvalidPhpDocs, bool $invalidPhpDocTagLine) { $this->phpDocLexer = $phpDocLexer; $this->phpDocParser = $phpDocParser; $this->checkAllInvalidPhpDocs = $checkAllInvalidPhpDocs; $this->invalidPhpDocTagLine = $invalidPhpDocTagLine; } public function getNodeType() : string { return Node::class; } public function processNode(Node $node, Scope $scope) : array { if (!$this->checkAllInvalidPhpDocs) { if (!$node instanceof Node\Stmt\ClassLike && !$node instanceof Node\FunctionLike && !$node instanceof Node\Stmt\Foreach_ && !$node instanceof Node\Stmt\Property && !$node instanceof Node\Expr\Assign && !$node instanceof Node\Expr\AssignRef && !$node instanceof Node\Stmt\ClassConst) { return []; } } else { // mirrored with InvalidPHPStanDocTagRule if ($node instanceof VirtualNode) { return []; } if ($node instanceof Node\Stmt\Expression) { return []; } if ($node instanceof Node\Expr && !$node instanceof Node\Expr\Assign && !$node instanceof Node\Expr\AssignRef) { return []; } } $docComment = $node->getDocComment(); if ($docComment === null) { return []; } $phpDocString = $docComment->getText(); $tokens = new TokenIterator($this->phpDocLexer->tokenize($phpDocString)); $phpDocNode = $this->phpDocParser->parse($tokens); $errors = []; foreach ($phpDocNode->getTags() as $phpDocTag) { if (str_starts_with($phpDocTag->name, '@phan-') || str_starts_with($phpDocTag->name, '@psalm-')) { continue; } if ($phpDocTag->value instanceof TypeAliasTagValueNode) { if (!$phpDocTag->value->type instanceof InvalidTypeNode) { continue; } $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag %s %s has invalid value: %s', $phpDocTag->name, $phpDocTag->value->alias, $this->trimExceptionMessage($phpDocTag->value->type->getException()->getMessage())))->line(\PHPStan\Rules\PhpDoc\PhpDocLineHelper::detectLine($node, $phpDocTag))->identifier('phpDoc.parseError')->build(); continue; } elseif (!$phpDocTag->value instanceof InvalidTagValueNode) { continue; } $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag %s has invalid value (%s): %s', $phpDocTag->name, $phpDocTag->value->value, $this->trimExceptionMessage($phpDocTag->value->exception->getMessage())))->line(\PHPStan\Rules\PhpDoc\PhpDocLineHelper::detectLine($node, $phpDocTag))->identifier('phpDoc.parseError')->build(); } return $errors; } private function trimExceptionMessage(string $message) : string { if ($this->invalidPhpDocTagLine) { return $message; } return Strings::replace($message, '~( on line \\d+)$~', ''); } } <?php declare (strict_types=1); namespace PHPStan\Rules\PhpDoc; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\VirtualNode; use PHPStan\PhpDocParser\Lexer\Lexer; use PHPStan\PhpDocParser\Parser\PhpDocParser; use PHPStan\PhpDocParser\Parser\TokenIterator; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function in_array; use function sprintf; use function str_starts_with; /** * @implements Rule<Node> */ final class InvalidPHPStanDocTagRule implements Rule { /** * @var Lexer */ private $phpDocLexer; /** * @var PhpDocParser */ private $phpDocParser; /** * @var bool */ private $checkAllInvalidPhpDocs; private const POSSIBLE_PHPSTAN_TAGS = ['@phpstan-param', '@phpstan-param-out', '@phpstan-var', '@phpstan-extends', '@phpstan-implements', '@phpstan-use', '@phpstan-template', '@phpstan-template-contravariant', '@phpstan-template-covariant', '@phpstan-return', '@phpstan-throws', '@phpstan-ignore', '@phpstan-ignore-next-line', '@phpstan-ignore-line', '@phpstan-method', '@phpstan-pure', '@phpstan-impure', '@phpstan-immutable', '@phpstan-type', '@phpstan-import-type', '@phpstan-property', '@phpstan-property-read', '@phpstan-property-write', '@phpstan-consistent-constructor', '@phpstan-assert', '@phpstan-assert-if-true', '@phpstan-assert-if-false', '@phpstan-self-out', '@phpstan-this-out', '@phpstan-allow-private-mutation', '@phpstan-readonly', '@phpstan-readonly-allow-private-mutation', '@phpstan-require-extends', '@phpstan-require-implements', '@phpstan-param-immediately-invoked-callable', '@phpstan-param-later-invoked-callable', '@phpstan-param-closure-this']; public function __construct(Lexer $phpDocLexer, PhpDocParser $phpDocParser, bool $checkAllInvalidPhpDocs) { $this->phpDocLexer = $phpDocLexer; $this->phpDocParser = $phpDocParser; $this->checkAllInvalidPhpDocs = $checkAllInvalidPhpDocs; } public function getNodeType() : string { return Node::class; } public function processNode(Node $node, Scope $scope) : array { if (!$this->checkAllInvalidPhpDocs) { if (!$node instanceof Node\Stmt\ClassLike && !$node instanceof Node\FunctionLike && !$node instanceof Node\Stmt\Foreach_ && !$node instanceof Node\Stmt\Property && !$node instanceof Node\Expr\Assign && !$node instanceof Node\Expr\AssignRef && !$node instanceof Node\Stmt\ClassConst) { return []; } } else { // mirrored with InvalidPhpDocTagValueRule if ($node instanceof VirtualNode) { return []; } if ($node instanceof Node\Stmt\Expression) { return []; } if ($node instanceof Node\Expr && !$node instanceof Node\Expr\Assign && !$node instanceof Node\Expr\AssignRef) { return []; } } $docComment = $node->getDocComment(); if ($docComment === null) { return []; } $phpDocString = $docComment->getText(); $tokens = new TokenIterator($this->phpDocLexer->tokenize($phpDocString)); $phpDocNode = $this->phpDocParser->parse($tokens); $errors = []; foreach ($phpDocNode->getTags() as $phpDocTag) { if (!str_starts_with($phpDocTag->name, '@phpstan-') || in_array($phpDocTag->name, self::POSSIBLE_PHPSTAN_TAGS, \true)) { continue; } $errors[] = RuleErrorBuilder::message(sprintf('Unknown PHPDoc tag: %s', $phpDocTag->name))->line(\PHPStan\Rules\PhpDoc\PhpDocLineHelper::detectLine($node, $phpDocTag))->identifier('phpDoc.phpstanTag')->build(); } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\PhpDoc; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\PhpDoc\Tag\TemplateTag; use PHPStan\Reflection\ClassReflection; use PHPStan\Rules\Generics\TemplateTypeCheck; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\CallableType; use PHPStan\Type\ClosureType; use PHPStan\Type\Generic\TemplateTypeScope; use PHPStan\Type\Type; use PHPStan\Type\TypeTraverser; use PHPStan\Type\VerbosityLevel; use function array_keys; use function sprintf; final class GenericCallableRuleHelper { /** * @var TemplateTypeCheck */ private $templateTypeCheck; public function __construct(TemplateTypeCheck $templateTypeCheck) { $this->templateTypeCheck = $templateTypeCheck; } /** * @param array<string, TemplateTag> $functionTemplateTags * * @return list<IdentifierRuleError> */ public function check(Node $node, Scope $scope, string $location, Type $callableType, ?string $functionName, array $functionTemplateTags, ?ClassReflection $classReflection) : array { $errors = []; TypeTraverser::map($callableType, function (Type $type, callable $traverse) use(&$errors, $node, $scope, $location, $functionName, $functionTemplateTags, $classReflection) { if (!($type instanceof CallableType || $type instanceof ClosureType)) { return $traverse($type); } $typeDescription = $type->describe(VerbosityLevel::precise()); $errors = $this->templateTypeCheck->check($scope, $node, TemplateTypeScope::createWithAnonymousFunction(), $type->getTemplateTags(), sprintf('PHPDoc tag %s template of %s cannot have existing class %%s as its name.', $location, $typeDescription), sprintf('PHPDoc tag %s template of %s cannot have existing type alias %%s as its name.', $location, $typeDescription), sprintf('PHPDoc tag %s template %%s of %s has invalid bound type %%s.', $location, $typeDescription), sprintf('PHPDoc tag %s template %%s of %s with bound type %%s is not supported.', $location, $typeDescription), sprintf('PHPDoc tag %s template %%s of %s has invalid default type %%s.', $location, $typeDescription), sprintf('Default type %%s in PHPDoc tag %s template %%s of %s is not subtype of bound type %%s.', $location, $typeDescription), sprintf('PHPDoc tag %s template %%s of %s does not have a default type but follows an optional template %%s.', $location, $typeDescription)); $templateTags = $type->getTemplateTags(); $classDescription = null; if ($classReflection !== null) { $classDescription = $classReflection->getDisplayName(); } if ($functionName !== null) { $functionDescription = sprintf('function %s', $functionName); if ($classReflection !== null) { $functionDescription = sprintf('method %s::%s', $classDescription, $functionName); } foreach (array_keys($functionTemplateTags) as $name) { if (!isset($templateTags[$name])) { continue; } $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag %s template %s of %s shadows @template %s for %s.', $location, $name, $typeDescription, $name, $functionDescription))->identifier('callable.shadowTemplate')->build(); } } if ($classReflection !== null) { foreach (array_keys($classReflection->getTemplateTags()) as $name) { if (!isset($templateTags[$name])) { continue; } $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag %s template %s of %s shadows @template %s for class %s.', $location, $name, $typeDescription, $name, $classDescription))->identifier('callable.shadowTemplate')->build(); } } return $traverse($type); }); return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\PhpDoc; use PhpParser\Node\Stmt\ClassMethod; use PhpParser\Node\Stmt\Function_; use PHPStan\Node\Expr\TypeExpr; use PHPStan\PhpDoc\Tag\AssertTag; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\InitializerExprContext; use PHPStan\Reflection\InitializerExprTypeResolver; use PHPStan\Reflection\ParametersAcceptor; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\ClassNameCheck; use PHPStan\Rules\ClassNameNodePair; use PHPStan\Rules\Generics\GenericObjectTypeCheck; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\MissingTypehintCheck; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\ErrorType; use PHPStan\Type\ObjectType; use PHPStan\Type\VerbosityLevel; use function array_key_exists; use function array_merge; use function sprintf; use function substr; final class AssertRuleHelper { /** * @var InitializerExprTypeResolver */ private $initializerExprTypeResolver; /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var UnresolvableTypeHelper */ private $unresolvableTypeHelper; /** * @var ClassNameCheck */ private $classCheck; /** * @var MissingTypehintCheck */ private $missingTypehintCheck; /** * @var GenericObjectTypeCheck */ private $genericObjectTypeCheck; /** * @var bool */ private $absentTypeChecks; /** * @var bool */ private $checkClassCaseSensitivity; /** * @var bool */ private $checkMissingTypehints; public function __construct(InitializerExprTypeResolver $initializerExprTypeResolver, ReflectionProvider $reflectionProvider, \PHPStan\Rules\PhpDoc\UnresolvableTypeHelper $unresolvableTypeHelper, ClassNameCheck $classCheck, MissingTypehintCheck $missingTypehintCheck, GenericObjectTypeCheck $genericObjectTypeCheck, bool $absentTypeChecks, bool $checkClassCaseSensitivity, bool $checkMissingTypehints) { $this->initializerExprTypeResolver = $initializerExprTypeResolver; $this->reflectionProvider = $reflectionProvider; $this->unresolvableTypeHelper = $unresolvableTypeHelper; $this->classCheck = $classCheck; $this->missingTypehintCheck = $missingTypehintCheck; $this->genericObjectTypeCheck = $genericObjectTypeCheck; $this->absentTypeChecks = $absentTypeChecks; $this->checkClassCaseSensitivity = $checkClassCaseSensitivity; $this->checkMissingTypehints = $checkMissingTypehints; } /** * @return list<IdentifierRuleError> * @param Function_|ClassMethod $node * @param ExtendedMethodReflection|FunctionReflection $reflection */ public function check($node, $reflection, ParametersAcceptor $acceptor) : array { $parametersByName = []; foreach ($acceptor->getParameters() as $parameter) { $parametersByName[$parameter->getName()] = $parameter->getType(); } if ($reflection instanceof ExtendedMethodReflection && !$reflection->isStatic()) { $class = $reflection->getDeclaringClass(); $parametersByName['this'] = new ObjectType($class->getName(), null, $class); } $context = InitializerExprContext::createEmpty(); $errors = []; foreach ($reflection->getAsserts()->getAll() as $assert) { $parameterName = substr($assert->getParameter()->getParameterName(), 1); if (!array_key_exists($parameterName, $parametersByName)) { $errors[] = RuleErrorBuilder::message(sprintf('Assert references unknown parameter $%s.', $parameterName))->identifier('parameter.notFound')->build(); continue; } if (!$assert->isExplicit()) { continue; } $assertedExpr = $assert->getParameter()->getExpr(new TypeExpr($parametersByName[$parameterName])); $assertedExprType = $this->initializerExprTypeResolver->getType($assertedExpr, $context); $assertedExprString = $assert->getParameter()->describe(); if ($assertedExprType instanceof ErrorType) { if ($this->absentTypeChecks) { $errors[] = RuleErrorBuilder::message(sprintf('Assert references unknown %s.', $assertedExprString))->identifier('assert.unknownExpr')->build(); } continue; } $assertedType = $assert->getType(); $tagName = [AssertTag::NULL => '@phpstan-assert', AssertTag::IF_TRUE => '@phpstan-assert-if-true', AssertTag::IF_FALSE => '@phpstan-assert-if-false'][$assert->getIf()]; if ($this->absentTypeChecks) { if ($this->unresolvableTypeHelper->containsUnresolvableType($assertedType)) { $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag %s for %s contains unresolvable type.', $tagName, $assertedExprString))->identifier('assert.unresolvableType')->build(); continue; } } $isSuperType = $assertedType->isSuperTypeOf($assertedExprType); if (!$isSuperType->maybe()) { if ($assert->isNegated() ? $isSuperType->yes() : $isSuperType->no()) { $errors[] = RuleErrorBuilder::message(sprintf('Asserted %stype %s for %s with type %s can never happen.', $assert->isNegated() ? 'negated ' : '', $assertedType->describe(VerbosityLevel::precise()), $assertedExprString, $assertedExprType->describe(VerbosityLevel::precise())))->identifier('assert.impossibleType')->build(); } elseif ($assert->isNegated() ? $isSuperType->no() : $isSuperType->yes()) { $errors[] = RuleErrorBuilder::message(sprintf('Asserted %stype %s for %s with type %s does not narrow down the type.', $assert->isNegated() ? 'negated ' : '', $assertedType->describe(VerbosityLevel::precise()), $assertedExprString, $assertedExprType->describe(VerbosityLevel::precise())))->identifier('assert.alreadyNarrowedType')->build(); } } if (!$this->absentTypeChecks) { continue; } foreach ($assertedType->getReferencedClasses() as $class) { if (!$this->reflectionProvider->hasClass($class)) { $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag %s for %s contains unknown class %s.', $tagName, $assertedExprString, $class))->identifier('class.notFound')->build(); continue; } $classReflection = $this->reflectionProvider->getClass($class); if ($classReflection->isTrait()) { $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag %s for %s contains invalid type %s.', $tagName, $assertedExprString, $class))->identifier('assert.trait')->build(); continue; } $errors = array_merge($errors, $this->classCheck->checkClassNames([new ClassNameNodePair($class, $node)], $this->checkClassCaseSensitivity)); } $errors = array_merge($errors, $this->genericObjectTypeCheck->check($assertedType, sprintf('PHPDoc tag %s for %s contains generic type %%s but %%s %%s is not generic.', $tagName, $assertedExprString), sprintf('Generic type %%s in PHPDoc tag %s for %s does not specify all template types of %%s %%s: %%s', $tagName, $assertedExprString), sprintf('Generic type %%s in PHPDoc tag %s for %s specifies %%d template types, but %%s %%s supports only %%d: %%s', $tagName, $assertedExprString), sprintf('Type %%s in generic type %%s in PHPDoc tag %s for %s is not subtype of template type %%s of %%s %%s.', $tagName, $assertedExprString), sprintf('Call-site variance of %%s in generic type %%s in PHPDoc tag %s for %s is in conflict with %%s template type %%s of %%s %%s.', $tagName, $assertedExprString), sprintf('Call-site variance of %%s in generic type %%s in PHPDoc tag %s for %s is redundant, template type %%s of %%s %%s has the same variance.', $tagName, $assertedExprString))); if (!$this->checkMissingTypehints) { continue; } foreach ($this->missingTypehintCheck->getIterableTypesWithMissingValueTypehint($assertedType) as $iterableType) { $iterableTypeDescription = $iterableType->describe(VerbosityLevel::typeOnly()); $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag %s for %s has no value type specified in iterable type %s.', $tagName, $assertedExprString, $iterableTypeDescription))->tip(MissingTypehintCheck::MISSING_ITERABLE_VALUE_TYPE_TIP)->identifier('missingType.iterableValue')->build(); } foreach ($this->missingTypehintCheck->getNonGenericObjectTypesWithGenericClass($assertedType) as [$innerName, $genericTypeNames]) { $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag %s for %s contains generic %s but does not specify its types: %s', $tagName, $assertedExprString, $innerName, $genericTypeNames))->identifier('missingType.generics')->build(); } foreach ($this->missingTypehintCheck->getCallablesWithMissingSignature($assertedType) as $callableType) { $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag %s for %s has no signature specified for %s.', $tagName, $assertedExprString, $callableType->describe(VerbosityLevel::typeOnly())))->identifier('missingType.callable')->build(); } } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\PhpDoc; use PhpParser\Comment\Doc; use PhpParser\Node; use PhpParser\Node\Expr; use PHPStan\Analyser\Scope; use PHPStan\Node\Expr\GetIterableKeyTypeExpr; use PHPStan\Node\Expr\GetIterableValueTypeExpr; use PHPStan\Node\InClassMethodNode; use PHPStan\Node\InClassNode; use PHPStan\Node\InFunctionNode; use PHPStan\Node\VirtualNode; use PHPStan\PhpDoc\Tag\VarTag; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\ShouldNotHappenException; use PHPStan\Type\FileTypeMapper; use function array_keys; use function array_map; use function array_merge; use function count; use function implode; use function in_array; use function is_int; use function is_string; use function sprintf; /** * @implements Rule<Node\Stmt> */ final class WrongVariableNameInVarTagRule implements Rule { /** * @var FileTypeMapper */ private $fileTypeMapper; /** * @var VarTagTypeRuleHelper */ private $varTagTypeRuleHelper; /** * @var bool */ private $checkTypeAgainstNativeType; public function __construct(FileTypeMapper $fileTypeMapper, \PHPStan\Rules\PhpDoc\VarTagTypeRuleHelper $varTagTypeRuleHelper, bool $checkTypeAgainstNativeType) { $this->fileTypeMapper = $fileTypeMapper; $this->varTagTypeRuleHelper = $varTagTypeRuleHelper; $this->checkTypeAgainstNativeType = $checkTypeAgainstNativeType; } public function getNodeType() : string { return Node\Stmt::class; } public function processNode(Node $node, Scope $scope) : array { if ($node instanceof Node\Stmt\Property || $node instanceof Node\Stmt\PropertyProperty || $node instanceof Node\Stmt\ClassConst || $node instanceof Node\Stmt\Const_ || $node instanceof VirtualNode && !$node instanceof InFunctionNode && !$node instanceof InClassMethodNode && !$node instanceof InClassNode) { return []; } $varTags = []; $function = $scope->getFunction(); foreach ($node->getComments() as $comment) { if (!$comment instanceof Doc) { continue; } $resolvedPhpDoc = $this->fileTypeMapper->getResolvedPhpDoc($scope->getFile(), $scope->isInClass() ? $scope->getClassReflection()->getName() : null, $scope->isInTrait() ? $scope->getTraitReflection()->getName() : null, $function !== null ? $function->getName() : null, $comment->getText()); foreach ($resolvedPhpDoc->getVarTags() as $key => $varTag) { $varTags[$key] = $varTag; } } if (count($varTags) === 0) { return []; } if ($node instanceof Node\Stmt\Foreach_) { return $this->processForeach($scope, $node->expr, $node->keyVar, $node->valueVar, $varTags); } if ($node instanceof Node\Stmt\Static_) { return $this->processStatic($scope, $node->vars, $varTags); } if ($node instanceof Node\Stmt\Expression) { return $this->processExpression($scope, $node->expr, $varTags); } if ($node instanceof Node\Stmt\Throw_ || $node instanceof Node\Stmt\Return_) { return $this->processStmt($scope, $varTags, $node->expr); } if ($node instanceof Node\Stmt\Global_) { return $this->processGlobal($scope, $node, $varTags); } if ($node instanceof InClassNode || $node instanceof InClassMethodNode || $node instanceof InFunctionNode) { $description = 'a function'; $originalNode = $node->getOriginalNode(); if ($originalNode instanceof Node\Stmt\Interface_) { $description = 'an interface'; } elseif ($originalNode instanceof Node\Stmt\Class_) { $description = 'a class'; } elseif ($originalNode instanceof Node\Stmt\Enum_) { $description = 'an enum'; } elseif ($originalNode instanceof Node\Stmt\Trait_) { throw new ShouldNotHappenException(); } elseif ($originalNode instanceof Node\Stmt\ClassMethod) { $description = 'a method'; } return [RuleErrorBuilder::message(sprintf('PHPDoc tag @var above %s has no effect.', $description))->identifier('varTag.misplaced')->build()]; } return $this->processStmt($scope, $varTags, null); } /** * @param VarTag[] $varTags * @return list<IdentifierRuleError> */ private function processAssign(Scope $scope, Node\Expr $var, Node\Expr $expr, array $varTags) : array { $errors = []; $hasMultipleMessage = \false; $assignedVariables = $this->getAssignedVariables($var); if ($this->checkTypeAgainstNativeType) { foreach ($this->varTagTypeRuleHelper->checkVarType($scope, $var, $expr, $varTags, $assignedVariables) as $error) { $errors[] = $error; } } foreach (array_keys($varTags) as $key) { if (is_int($key)) { if (count($varTags) !== 1) { if (!$hasMultipleMessage) { $errors[] = RuleErrorBuilder::message('Multiple PHPDoc @var tags above single variable assignment are not supported.')->identifier('varTag.multipleTags')->build(); $hasMultipleMessage = \true; } } elseif (count($assignedVariables) !== 1) { $errors[] = RuleErrorBuilder::message('PHPDoc tag @var above assignment does not specify variable name.')->identifier('varTag.noVariable')->build(); } continue; } if (!$scope->hasVariableType($key)->no()) { continue; } if (in_array($key, $assignedVariables, \true)) { continue; } if (count($assignedVariables) === 1 && count($varTags) === 1) { $errors[] = RuleErrorBuilder::message(sprintf('Variable $%s in PHPDoc tag @var does not match assigned variable $%s.', $key, $assignedVariables[0]))->identifier('varTag.differentVariable')->build(); } else { $errors[] = RuleErrorBuilder::message(sprintf('Variable $%s in PHPDoc tag @var does not exist.', $key))->identifier('varTag.variableNotFound')->build(); } } return $errors; } /** * @return string[] */ private function getAssignedVariables(Expr $expr) : array { if ($expr instanceof Expr\Variable) { if (is_string($expr->name)) { return [$expr->name]; } return []; } if ($expr instanceof Expr\List_ || $expr instanceof Expr\Array_) { $names = []; foreach ($expr->items as $item) { if ($item === null) { continue; } $names = array_merge($names, $this->getAssignedVariables($item->value)); } return $names; } return []; } /** * @param VarTag[] $varTags * @return list<IdentifierRuleError> */ private function processForeach(Scope $scope, Node\Expr $iterateeExpr, ?Node\Expr $keyVar, Node\Expr $valueVar, array $varTags) : array { $variableNames = []; if ($iterateeExpr instanceof Node\Expr\Variable && is_string($iterateeExpr->name)) { $variableNames[] = $iterateeExpr->name; } if ($keyVar instanceof Node\Expr\Variable && is_string($keyVar->name)) { $variableNames[] = $keyVar->name; } $variableNames = array_merge($variableNames, $this->getAssignedVariables($valueVar)); $errors = []; foreach (array_keys($varTags) as $name) { if (is_int($name)) { if (count($variableNames) === 1) { continue; } $errors[] = RuleErrorBuilder::message('PHPDoc tag @var above foreach loop does not specify variable name.')->identifier('varTag.noVariable')->build(); continue; } if (in_array($name, $variableNames, \true)) { continue; } $errors[] = RuleErrorBuilder::message(sprintf('Variable $%s in PHPDoc tag @var does not match any variable in the foreach loop: %s', $name, implode(', ', array_map(static function (string $name) : string { return sprintf('$%s', $name); }, $variableNames))))->identifier('varTag.differentVariable')->build(); } if ($this->checkTypeAgainstNativeType) { foreach ($this->varTagTypeRuleHelper->checkVarType($scope, $iterateeExpr, $iterateeExpr, $varTags, $variableNames) as $error) { $errors[] = $error; } if ($keyVar !== null) { foreach ($this->varTagTypeRuleHelper->checkVarType($scope, $keyVar, new GetIterableKeyTypeExpr($iterateeExpr), $varTags, $variableNames) as $error) { $errors[] = $error; } } foreach ($this->varTagTypeRuleHelper->checkVarType($scope, $valueVar, new GetIterableValueTypeExpr($iterateeExpr), $varTags, $variableNames) as $error) { $errors[] = $error; } } return $errors; } /** * @param VarTag[] $varTags * @return list<IdentifierRuleError> */ private function processExpression(Scope $scope, Expr $expr, array $varTags) : array { if ($expr instanceof Node\Expr\Assign || $expr instanceof Node\Expr\AssignRef) { return $this->processAssign($scope, $expr->var, $expr->expr, $varTags); } return $this->processStmt($scope, $varTags, null); } /** * @param Node\Stmt\StaticVar[] $vars * @param VarTag[] $varTags * @return list<IdentifierRuleError> */ private function processStatic(Scope $scope, array $vars, array $varTags) : array { $variableNames = []; foreach ($vars as $var) { if (!is_string($var->var->name)) { continue; } $variableNames[] = $var->var->name; } $errors = []; foreach (array_keys($varTags) as $name) { if (is_int($name)) { if (count($vars) === 1) { continue; } $errors[] = RuleErrorBuilder::message('PHPDoc tag @var above multiple static variables does not specify variable name.')->identifier('varTag.noVariable')->build(); continue; } if (in_array($name, $variableNames, \true)) { continue; } $errors[] = RuleErrorBuilder::message(sprintf('Variable $%s in PHPDoc tag @var does not match any static variable: %s', $name, implode(', ', array_map(static function (string $name) : string { return sprintf('$%s', $name); }, $variableNames))))->identifier('varTag.differentVariable')->build(); } if ($this->checkTypeAgainstNativeType) { foreach ($vars as $var) { if ($var->default === null) { continue; } foreach ($this->varTagTypeRuleHelper->checkVarType($scope, $var->var, $var->default, $varTags, $variableNames) as $error) { $errors[] = $error; } } } return $errors; } /** * @param VarTag[] $varTags * @return list<IdentifierRuleError> */ private function processStmt(Scope $scope, array $varTags, ?Expr $defaultExpr) : array { $errors = []; $variableLessVarTags = []; foreach ($varTags as $name => $varTag) { if (is_int($name)) { $variableLessVarTags[] = $varTag; continue; } if (!$scope->hasVariableType($name)->no()) { continue; } $errors[] = RuleErrorBuilder::message(sprintf('Variable $%s in PHPDoc tag @var does not exist.', $name))->identifier('varTag.variableNotFound')->build(); } if (count($variableLessVarTags) !== 1 || $defaultExpr === null) { if (count($variableLessVarTags) > 0) { $errors[] = RuleErrorBuilder::message('PHPDoc tag @var does not specify variable name.')->identifier('varTag.noVariable')->build(); } } return $errors; } /** * @param VarTag[] $varTags * @return list<IdentifierRuleError> */ private function processGlobal(Scope $scope, Node\Stmt\Global_ $node, array $varTags) : array { $variableNames = []; foreach ($node->vars as $var) { if (!$var instanceof Expr\Variable) { continue; } if (!is_string($var->name)) { continue; } $variableNames[$var->name] = \true; } $errors = []; foreach (array_keys($varTags) as $name) { if (is_int($name)) { if (count($variableNames) === 1) { continue; } $errors[] = RuleErrorBuilder::message('PHPDoc tag @var above multiple global variables does not specify variable name.')->identifier('varTag.noVariable')->build(); continue; } if (isset($variableNames[$name])) { continue; } $errors[] = RuleErrorBuilder::message(sprintf('Variable $%s in PHPDoc tag @var does not match any global variable: %s', $name, implode(', ', array_map(static function (string $name) : string { return sprintf('$%s', $name); }, array_keys($variableNames)))))->identifier('varTag.differentVariable')->build(); } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\PhpDoc; use PHPStan\Type\ErrorType; use PHPStan\Type\NeverType; use PHPStan\Type\Type; use PHPStan\Type\TypeTraverser; final class UnresolvableTypeHelper { public function containsUnresolvableType(Type $type) : bool { $containsUnresolvable = \false; TypeTraverser::map($type, static function (Type $type, callable $traverse) use(&$containsUnresolvable) : Type { if ($type instanceof ErrorType) { $containsUnresolvable = \true; return $type; } if ($type instanceof NeverType && !$type->isExplicit()) { $containsUnresolvable = \true; return $type; } return $traverse($type); }); return $containsUnresolvable; } } <?php declare (strict_types=1); namespace PHPStan\Rules\PhpDoc; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\InClassMethodNode; use PHPStan\Rules\Rule; use function count; /** * @implements Rule<InClassMethodNode> */ final class MethodAssertRule implements Rule { /** * @var AssertRuleHelper */ private $helper; public function __construct(\PHPStan\Rules\PhpDoc\AssertRuleHelper $helper) { $this->helper = $helper; } public function getNodeType() : string { return InClassMethodNode::class; } public function processNode(Node $node, Scope $scope) : array { $method = $node->getMethodReflection(); $variants = $method->getVariants(); if (count($variants) !== 1) { return []; } return $this->helper->check($node->getOriginalNode(), $method, $variants[0]); } } <?php declare (strict_types=1); namespace PHPStan\Rules\PhpDoc; use PhpParser\Node; use PHPStan\PhpDoc\Tag\RequireExtendsTag; use PHPStan\Rules\ClassNameCheck; use PHPStan\Rules\ClassNameNodePair; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\ObjectType; use PHPStan\Type\VerbosityLevel; use function array_merge; use function count; use function sprintf; use function strtolower; final class RequireExtendsCheck { /** * @var ClassNameCheck */ private $classCheck; /** * @var bool */ private $checkClassCaseSensitivity; public function __construct(ClassNameCheck $classCheck, bool $checkClassCaseSensitivity) { $this->classCheck = $classCheck; $this->checkClassCaseSensitivity = $checkClassCaseSensitivity; } /** * @param array<RequireExtendsTag> $extendsTags * @return list<IdentifierRuleError> */ public function checkExtendsTags(Node $node, array $extendsTags) : array { $errors = []; if (count($extendsTags) > 1) { $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag @phpstan-require-extends can only be used once.'))->identifier('requireExtends.duplicate')->build(); } foreach ($extendsTags as $extendsTag) { $type = $extendsTag->getType(); if (!$type instanceof ObjectType) { $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag @phpstan-require-extends contains non-object type %s.', $type->describe(VerbosityLevel::typeOnly())))->identifier('requireExtends.nonObject')->build(); continue; } $class = $type->getClassName(); $referencedClassReflection = $type->getClassReflection(); if ($referencedClassReflection === null) { $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag @phpstan-require-extends contains unknown class %s.', $class))->discoveringSymbolsTip()->identifier('class.notFound')->build(); continue; } if (!$referencedClassReflection->isClass()) { $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag @phpstan-require-extends cannot contain non-class type %s.', $class))->identifier(sprintf('requireExtends.%s', strtolower($referencedClassReflection->getClassTypeDescription())))->build(); } elseif ($referencedClassReflection->isFinal()) { $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag @phpstan-require-extends cannot contain final class %s.', $class))->identifier('requireExtends.finalClass')->build(); } else { $errors = array_merge($errors, $this->classCheck->checkClassNames([new ClassNameNodePair($class, $node)], $this->checkClassCaseSensitivity)); } } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\PhpDoc; use PhpParser\Node; use PhpParser\Node\Expr; use PHPStan\Analyser\NameScope; use PHPStan\Analyser\Scope; use PHPStan\Node\Expr\GetOffsetValueTypeExpr; use PHPStan\PhpDoc\NameScopeAlreadyBeingCreatedException; use PHPStan\PhpDoc\Tag\VarTag; use PHPStan\PhpDoc\TypeNodeResolver; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\ArrayType; use PHPStan\Type\FileTypeMapper; use PHPStan\Type\Generic\GenericObjectType; use PHPStan\Type\MixedType; use PHPStan\Type\ObjectType; use PHPStan\Type\Type; use PHPStan\Type\TypeUtils; use PHPStan\Type\VerbosityLevel; use function array_key_exists; use function count; use function is_string; use function sprintf; final class VarTagTypeRuleHelper { /** * @var TypeNodeResolver */ private $typeNodeResolver; /** * @var FileTypeMapper */ private $fileTypeMapper; /** * @var bool */ private $checkTypeAgainstPhpDocType; /** * @var bool */ private $strictWideningCheck; public function __construct(TypeNodeResolver $typeNodeResolver, FileTypeMapper $fileTypeMapper, bool $checkTypeAgainstPhpDocType, bool $strictWideningCheck) { $this->typeNodeResolver = $typeNodeResolver; $this->fileTypeMapper = $fileTypeMapper; $this->checkTypeAgainstPhpDocType = $checkTypeAgainstPhpDocType; $this->strictWideningCheck = $strictWideningCheck; } /** * @param VarTag[] $varTags * @param string[] $assignedVariables * @return list<IdentifierRuleError> */ public function checkVarType(Scope $scope, Node\Expr $var, Node\Expr $expr, array $varTags, array $assignedVariables) : array { $errors = []; if ($var instanceof Expr\Variable && is_string($var->name)) { if (array_key_exists($var->name, $varTags)) { $varTagType = $varTags[$var->name]->getType(); } elseif (count($assignedVariables) === 1 && array_key_exists(0, $varTags)) { $varTagType = $varTags[0]->getType(); } else { return []; } return $this->checkExprType($scope, $expr, $varTagType); } elseif ($var instanceof Expr\List_ || $var instanceof Expr\Array_) { foreach ($var->items as $i => $arrayItem) { if ($arrayItem === null) { continue; } if ($arrayItem->key === null) { $dimExpr = new Node\Scalar\LNumber($i); } else { $dimExpr = $arrayItem->key; } $itemErrors = $this->checkVarType($scope, $arrayItem->value, new GetOffsetValueTypeExpr($expr, $dimExpr), $varTags, $assignedVariables); foreach ($itemErrors as $error) { $errors[] = $error; } } } return $errors; } /** * @return list<IdentifierRuleError> */ public function checkExprType(Scope $scope, Node\Expr $expr, Type $varTagType) : array { $errors = []; $exprNativeType = $scope->getNativeType($expr); $containsPhpStanType = $this->containsPhpStanType($varTagType); if ($this->shouldVarTagTypeBeReported($scope, $expr, $exprNativeType, $varTagType)) { $verbosity = VerbosityLevel::getRecommendedLevelByType($exprNativeType, $varTagType); $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag @var with type %s is not subtype of native type %s.', $varTagType->describe($verbosity), $exprNativeType->describe($verbosity)))->identifier('varTag.nativeType')->build(); } else { $exprType = $scope->getType($expr); if ($this->shouldVarTagTypeBeReported($scope, $expr, $exprType, $varTagType) && ($this->checkTypeAgainstPhpDocType || $containsPhpStanType)) { $verbosity = VerbosityLevel::getRecommendedLevelByType($exprType, $varTagType); $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag @var with type %s is not subtype of type %s.', $varTagType->describe($verbosity), $exprType->describe($verbosity)))->identifier('varTag.type')->build(); } } if (count($errors) === 0 && $containsPhpStanType) { $exprType = $scope->getType($expr); if (!$exprType->equals($varTagType)) { $verbosity = VerbosityLevel::getRecommendedLevelByType($exprType, $varTagType); $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag @var assumes the expression with type %s is always %s but it\'s error-prone and dangerous.', $exprType->describe($verbosity), $varTagType->describe($verbosity)))->identifier('phpstanApi.varTagAssumption')->build(); } } return $errors; } private function containsPhpStanType(Type $type) : bool { $classReflections = TypeUtils::toBenevolentUnion($type)->getObjectClassReflections(); foreach ($classReflections as $classReflection) { if (!$classReflection->isSubclassOf(Type::class)) { continue; } return \true; } return \false; } private function shouldVarTagTypeBeReported(Scope $scope, Node\Expr $expr, Type $type, Type $varTagType) : bool { if ($expr instanceof Expr\Array_) { if ($expr->items === []) { $type = new ArrayType(new MixedType(), new MixedType()); } return !$this->isAtLeastMaybeSuperTypeOfVarType($scope, $type, $varTagType); } if ($expr instanceof Expr\ConstFetch) { return !$this->isAtLeastMaybeSuperTypeOfVarType($scope, $type, $varTagType); } if ($expr instanceof Node\Scalar) { return !$this->isAtLeastMaybeSuperTypeOfVarType($scope, $type, $varTagType); } if ($expr instanceof Expr\New_) { if ($type instanceof GenericObjectType) { $type = new ObjectType($type->getClassName()); } } return $this->checkType($scope, $type, $varTagType); } private function checkType(Scope $scope, Type $type, Type $varTagType, int $depth = 0) : bool { if ($this->strictWideningCheck) { return !$this->isSuperTypeOfVarType($scope, $type, $varTagType); } if ($type->isConstantArray()->yes()) { if ($type->isIterableAtLeastOnce()->no()) { $type = new ArrayType(new MixedType(), new MixedType()); return !$this->isAtLeastMaybeSuperTypeOfVarType($scope, $type, $varTagType); } } if ($type->isIterable()->yes() && $varTagType->isIterable()->yes()) { if (!$this->isAtLeastMaybeSuperTypeOfVarType($scope, $type, $varTagType)) { return \true; } $innerType = $type->getIterableValueType(); $innerVarTagType = $varTagType->getIterableValueType(); if ($type->equals($innerType) || $varTagType->equals($innerVarTagType)) { return !$this->isSuperTypeOfVarType($scope, $innerType, $innerVarTagType); } return $this->checkType($scope, $innerType, $innerVarTagType, $depth + 1); } if ($depth === 0 && $type->isConstantValue()->yes()) { return !$this->isAtLeastMaybeSuperTypeOfVarType($scope, $type, $varTagType); } return !$this->isSuperTypeOfVarType($scope, $type, $varTagType); } private function isSuperTypeOfVarType(Scope $scope, Type $type, Type $varTagType) : bool { if ($type->isSuperTypeOf($varTagType)->yes()) { return \true; } try { $type = $this->typeNodeResolver->resolve($type->toPhpDocNode(), $this->createNameScope($scope)); } catch (NameScopeAlreadyBeingCreatedException $e) { return \true; } return $type->isSuperTypeOf($varTagType)->yes(); } private function isAtLeastMaybeSuperTypeOfVarType(Scope $scope, Type $type, Type $varTagType) : bool { if (!$type->isSuperTypeOf($varTagType)->no()) { return \true; } try { $type = $this->typeNodeResolver->resolve($type->toPhpDocNode(), $this->createNameScope($scope)); } catch (NameScopeAlreadyBeingCreatedException $e) { return \true; } return !$type->isSuperTypeOf($varTagType)->no(); } /** * @throws NameScopeAlreadyBeingCreatedException */ private function createNameScope(Scope $scope) : NameScope { $function = $scope->getFunction(); return $this->fileTypeMapper->getNameScope($scope->getFile(), $scope->isInClass() ? $scope->getClassReflection()->getName() : null, $scope->isInTrait() ? $scope->getTraitReflection()->getName() : null, $function !== null ? $function->getName() : null); } } <?php declare (strict_types=1); namespace PHPStan\Rules\PhpDoc; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Internal\SprintfHelper; use PHPStan\Reflection\ClassReflection; use PHPStan\Rules\Generics\GenericObjectTypeCheck; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\ShouldNotHappenException; use PHPStan\Type\ParserNodeTypeToPHPStanType; use PHPStan\Type\Type; use PHPStan\Type\VerbosityLevel; use function array_merge; use function sprintf; /** * @implements Rule<Node\Stmt\ClassConst> */ final class IncompatibleClassConstantPhpDocTypeRule implements Rule { /** * @var GenericObjectTypeCheck */ private $genericObjectTypeCheck; /** * @var UnresolvableTypeHelper */ private $unresolvableTypeHelper; public function __construct(GenericObjectTypeCheck $genericObjectTypeCheck, \PHPStan\Rules\PhpDoc\UnresolvableTypeHelper $unresolvableTypeHelper) { $this->genericObjectTypeCheck = $genericObjectTypeCheck; $this->unresolvableTypeHelper = $unresolvableTypeHelper; } public function getNodeType() : string { return Node\Stmt\ClassConst::class; } public function processNode(Node $node, Scope $scope) : array { if (!$scope->isInClass()) { throw new ShouldNotHappenException(); } $nativeType = null; if ($node->type !== null) { $nativeType = ParserNodeTypeToPHPStanType::resolve($node->type, $scope->getClassReflection()); } $errors = []; foreach ($node->consts as $const) { $constantName = $const->name->toString(); $errors = array_merge($errors, $this->processSingleConstant($scope->getClassReflection(), $nativeType, $constantName)); } return $errors; } /** * @return list<IdentifierRuleError> */ private function processSingleConstant(ClassReflection $classReflection, ?Type $nativeType, string $constantName) : array { $constantReflection = $classReflection->getConstant($constantName); $phpDocType = $constantReflection->getPhpDocType(); if ($phpDocType === null) { return []; } $errors = []; if ($this->unresolvableTypeHelper->containsUnresolvableType($phpDocType)) { $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag @var for constant %s::%s contains unresolvable type.', $constantReflection->getDeclaringClass()->getName(), $constantName))->identifier('classConstant.unresolvableType')->build(); } elseif ($nativeType !== null) { $isSuperType = $nativeType->isSuperTypeOf($phpDocType); if ($isSuperType->no()) { $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag @var for constant %s::%s with type %s is incompatible with native type %s.', $constantReflection->getDeclaringClass()->getDisplayName(), $constantName, $phpDocType->describe(VerbosityLevel::typeOnly()), $nativeType->describe(VerbosityLevel::typeOnly())))->identifier('classConstant.phpDocType')->build(); } elseif ($isSuperType->maybe()) { $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag @var for constant %s::%s with type %s is not subtype of native type %s.', $constantReflection->getDeclaringClass()->getDisplayName(), $constantName, $phpDocType->describe(VerbosityLevel::typeOnly()), $nativeType->describe(VerbosityLevel::typeOnly())))->identifier('classConstant.phpDocType')->build(); } } $className = SprintfHelper::escapeFormatString($constantReflection->getDeclaringClass()->getDisplayName()); $escapedConstantName = SprintfHelper::escapeFormatString($constantName); return array_merge($errors, $this->genericObjectTypeCheck->check($phpDocType, sprintf('PHPDoc tag @var for constant %s::%s contains generic type %%s but %%s %%s is not generic.', $className, $escapedConstantName), sprintf('Generic type %%s in PHPDoc tag @var for constant %s::%s does not specify all template types of %%s %%s: %%s', $className, $escapedConstantName), sprintf('Generic type %%s in PHPDoc tag @var for constant %s::%s specifies %%d template types, but %%s %%s supports only %%d: %%s', $className, $escapedConstantName), sprintf('Type %%s in generic type %%s in PHPDoc tag @var for constant %s::%s is not subtype of template type %%s of %%s %%s.', $className, $escapedConstantName), sprintf('Call-site variance of %%s in generic type %%s in PHPDoc tag @var for constant %s::%s is in conflict with %%s template type %%s of %%s %%s.', $className, $escapedConstantName), sprintf('Call-site variance of %%s in generic type %%s in PHPDoc tag @var for constant %s::%s is redundant, template type %%s of %%s %%s has the same variance.', $className, $escapedConstantName))); } } <?php declare (strict_types=1); namespace PHPStan\Rules\PhpDoc; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Internal\SprintfHelper; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\ClassNameCheck; use PHPStan\Rules\ClassNameNodePair; use PHPStan\Rules\Generics\GenericObjectTypeCheck; use PHPStan\Rules\MissingTypehintCheck; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\FileTypeMapper; use PHPStan\Type\VerbosityLevel; use function array_map; use function array_merge; use function is_string; use function sprintf; /** * @implements Rule<Node\Stmt> */ final class InvalidPhpDocVarTagTypeRule implements Rule { /** * @var FileTypeMapper */ private $fileTypeMapper; /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var ClassNameCheck */ private $classCheck; /** * @var GenericObjectTypeCheck */ private $genericObjectTypeCheck; /** * @var MissingTypehintCheck */ private $missingTypehintCheck; /** * @var UnresolvableTypeHelper */ private $unresolvableTypeHelper; /** * @var bool */ private $checkClassCaseSensitivity; /** * @var bool */ private $checkMissingVarTagTypehint; public function __construct(FileTypeMapper $fileTypeMapper, ReflectionProvider $reflectionProvider, ClassNameCheck $classCheck, GenericObjectTypeCheck $genericObjectTypeCheck, MissingTypehintCheck $missingTypehintCheck, \PHPStan\Rules\PhpDoc\UnresolvableTypeHelper $unresolvableTypeHelper, bool $checkClassCaseSensitivity, bool $checkMissingVarTagTypehint) { $this->fileTypeMapper = $fileTypeMapper; $this->reflectionProvider = $reflectionProvider; $this->classCheck = $classCheck; $this->genericObjectTypeCheck = $genericObjectTypeCheck; $this->missingTypehintCheck = $missingTypehintCheck; $this->unresolvableTypeHelper = $unresolvableTypeHelper; $this->checkClassCaseSensitivity = $checkClassCaseSensitivity; $this->checkMissingVarTagTypehint = $checkMissingVarTagTypehint; } public function getNodeType() : string { return Node\Stmt::class; } public function processNode(Node $node, Scope $scope) : array { if ($node instanceof Node\Stmt\Property || $node instanceof Node\Stmt\PropertyProperty || $node instanceof Node\Stmt\ClassConst || $node instanceof Node\Stmt\Const_) { return []; } $docComment = $node->getDocComment(); if ($docComment === null) { return []; } $function = $scope->getFunction(); $resolvedPhpDoc = $this->fileTypeMapper->getResolvedPhpDoc($scope->getFile(), $scope->isInClass() ? $scope->getClassReflection()->getName() : null, $scope->isInTrait() ? $scope->getTraitReflection()->getName() : null, $function !== null ? $function->getName() : null, $docComment->getText()); $errors = []; foreach ($resolvedPhpDoc->getVarTags() as $name => $varTag) { $varTagType = $varTag->getType(); $identifier = 'PHPDoc tag @var'; if (is_string($name)) { $identifier .= sprintf(' for variable $%s', $name); } if ($this->unresolvableTypeHelper->containsUnresolvableType($varTagType)) { $errors[] = RuleErrorBuilder::message(sprintf('%s contains unresolvable type.', $identifier))->line($docComment->getStartLine())->identifier('varTag.unresolvableType')->build(); continue; } if ($this->checkMissingVarTagTypehint) { foreach ($this->missingTypehintCheck->getIterableTypesWithMissingValueTypehint($varTagType) as $iterableType) { $iterableTypeDescription = $iterableType->describe(VerbosityLevel::typeOnly()); $errors[] = RuleErrorBuilder::message(sprintf('%s has no value type specified in iterable type %s.', $identifier, $iterableTypeDescription))->tip(MissingTypehintCheck::MISSING_ITERABLE_VALUE_TYPE_TIP)->identifier('missingType.iterableValue')->build(); } } $escapedIdentifier = SprintfHelper::escapeFormatString($identifier); $errors = array_merge($errors, $this->genericObjectTypeCheck->check($varTagType, sprintf('%s contains generic type %%s but %%s %%s is not generic.', $escapedIdentifier), sprintf('Generic type %%s in %s does not specify all template types of %%s %%s: %%s', $escapedIdentifier), sprintf('Generic type %%s in %s specifies %%d template types, but %%s %%s supports only %%d: %%s', $escapedIdentifier), sprintf('Type %%s in generic type %%s in %s is not subtype of template type %%s of %%s %%s.', $escapedIdentifier), sprintf('Call-site variance of %%s in generic type %%s in %s is in conflict with %%s template type %%s of %%s %%s.', $escapedIdentifier), sprintf('Call-site variance of %%s in generic type %%s in %s is redundant, template type %%s of %%s %%s has the same variance.', $escapedIdentifier))); foreach ($this->missingTypehintCheck->getNonGenericObjectTypesWithGenericClass($varTagType) as [$innerName, $genericTypeNames]) { $errors[] = RuleErrorBuilder::message(sprintf('%s contains generic %s but does not specify its types: %s', $identifier, $innerName, $genericTypeNames))->identifier('missingType.generics')->build(); } $referencedClasses = $varTagType->getReferencedClasses(); foreach ($referencedClasses as $referencedClass) { if ($this->reflectionProvider->hasClass($referencedClass)) { if ($this->reflectionProvider->getClass($referencedClass)->isTrait()) { $errors[] = RuleErrorBuilder::message(sprintf(sprintf('%s has invalid type %%s.', $identifier), $referencedClass))->identifier('varTag.trait')->build(); } continue; } if ($scope->isInClassExists($referencedClass)) { continue; } $errors[] = RuleErrorBuilder::message(sprintf(sprintf('%s contains unknown class %%s.', $identifier), $referencedClass))->identifier('class.notFound')->discoveringSymbolsTip()->build(); } $errors = array_merge($errors, $this->classCheck->checkClassNames(array_map(static function (string $class) use($node) : ClassNameNodePair { return new ClassNameNodePair($class, $node); }, $referencedClasses), $this->checkClassCaseSensitivity)); } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\PhpDoc; use PhpParser\Node as PhpParserNode; use PHPStan\PhpDocParser\Ast\Node as PhpDocNode; final class PhpDocLineHelper { /** * This method returns exact line of e.g. `@param` tag in PHPDoc so that it can be used for precise error reporting * - exact position is available only when bleedingEdge is enabled * - otherwise, it falls back to given node start line */ public static function detectLine(PhpParserNode $node, PhpDocNode $phpDocNode) : int { $phpDocTagLine = $phpDocNode->getAttribute('startLine'); $phpDoc = $node->getDocComment(); if ($phpDocTagLine === null || $phpDoc === null) { return $node->getLine(); } return $phpDoc->getStartLine() + $phpDocTagLine - 1; } } <?php declare (strict_types=1); namespace PHPStan\Rules\PhpDoc; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Internal\SprintfHelper; use PHPStan\Node\ClassPropertyNode; use PHPStan\Rules\Generics\GenericObjectTypeCheck; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\Generic\TemplateType; use PHPStan\Type\ParserNodeTypeToPHPStanType; use PHPStan\Type\VerbosityLevel; use function array_merge; use function sprintf; /** * @implements Rule<ClassPropertyNode> */ final class IncompatiblePropertyPhpDocTypeRule implements Rule { /** * @var GenericObjectTypeCheck */ private $genericObjectTypeCheck; /** * @var UnresolvableTypeHelper */ private $unresolvableTypeHelper; /** * @var GenericCallableRuleHelper */ private $genericCallableRuleHelper; public function __construct(GenericObjectTypeCheck $genericObjectTypeCheck, \PHPStan\Rules\PhpDoc\UnresolvableTypeHelper $unresolvableTypeHelper, \PHPStan\Rules\PhpDoc\GenericCallableRuleHelper $genericCallableRuleHelper) { $this->genericObjectTypeCheck = $genericObjectTypeCheck; $this->unresolvableTypeHelper = $unresolvableTypeHelper; $this->genericCallableRuleHelper = $genericCallableRuleHelper; } public function getNodeType() : string { return ClassPropertyNode::class; } public function processNode(Node $node, Scope $scope) : array { $phpDocType = $node->getPhpDocType(); if ($phpDocType === null) { return []; } $propertyName = $node->getName(); $description = 'PHPDoc tag @var'; if ($node->isPromoted()) { $description = 'PHPDoc type'; } $classReflection = $node->getClassReflection(); $messages = []; if ($this->unresolvableTypeHelper->containsUnresolvableType($phpDocType)) { $messages[] = RuleErrorBuilder::message(sprintf('%s for property %s::$%s contains unresolvable type.', $description, $classReflection->getDisplayName(), $propertyName))->identifier('property.unresolvableType')->build(); } $nativeType = ParserNodeTypeToPHPStanType::resolve($node->getNativeType(), $classReflection); $isSuperType = $nativeType->isSuperTypeOf($phpDocType); if ($isSuperType->no()) { $messages[] = RuleErrorBuilder::message(sprintf('%s for property %s::$%s with type %s is incompatible with native type %s.', $description, $classReflection->getDisplayName(), $propertyName, $phpDocType->describe(VerbosityLevel::typeOnly()), $nativeType->describe(VerbosityLevel::typeOnly())))->identifier('property.phpDocType')->build(); } elseif ($isSuperType->maybe()) { $errorBuilder = RuleErrorBuilder::message(sprintf('%s for property %s::$%s with type %s is not subtype of native type %s.', $description, $classReflection->getDisplayName(), $propertyName, $phpDocType->describe(VerbosityLevel::typeOnly()), $nativeType->describe(VerbosityLevel::typeOnly())))->identifier('property.phpDocType'); if ($phpDocType instanceof TemplateType) { $errorBuilder->tip(sprintf('Write @template %s of %s to fix this.', $phpDocType->getName(), $nativeType->describe(VerbosityLevel::typeOnly()))); } $messages[] = $errorBuilder->build(); } $className = SprintfHelper::escapeFormatString($classReflection->getDisplayName()); $escapedPropertyName = SprintfHelper::escapeFormatString($propertyName); if ($node->isPromoted() === \false) { $messages = array_merge($messages, $this->genericCallableRuleHelper->check($node, $scope, '@var', $phpDocType, null, [], $classReflection)); } $messages = array_merge($messages, $this->genericObjectTypeCheck->check($phpDocType, sprintf('%s for property %s::$%s contains generic type %%s but %%s %%s is not generic.', $description, $className, $escapedPropertyName), sprintf('Generic type %%s in %s for property %s::$%s does not specify all template types of %%s %%s: %%s', $description, $className, $escapedPropertyName), sprintf('Generic type %%s in %s for property %s::$%s specifies %%d template types, but %%s %%s supports only %%d: %%s', $description, $className, $escapedPropertyName), sprintf('Type %%s in generic type %%s in %s for property %s::$%s is not subtype of template type %%s of %%s %%s.', $description, $className, $escapedPropertyName), sprintf('Call-site variance of %%s in generic type %%s in %s for property %s::$%s is in conflict with %%s template type %%s of %%s %%s.', $description, $className, $escapedPropertyName), sprintf('Call-site variance of %%s in generic type %%s in %s for property %s::$%s is redundant, template type %%s of %%s %%s has the same variance.', $description, $className, $escapedPropertyName))); return $messages; } } <?php declare (strict_types=1); namespace PHPStan\Rules\PhpDoc; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\InFunctionNode; use PHPStan\Rules\Rule; use function count; /** * @implements Rule<InFunctionNode> */ final class FunctionConditionalReturnTypeRule implements Rule { /** * @var ConditionalReturnTypeRuleHelper */ private $helper; public function __construct(\PHPStan\Rules\PhpDoc\ConditionalReturnTypeRuleHelper $helper) { $this->helper = $helper; } public function getNodeType() : string { return InFunctionNode::class; } public function processNode(Node $node, Scope $scope) : array { $function = $node->getFunctionReflection(); $variants = $function->getVariants(); if (count($variants) !== 1) { return []; } return $this->helper->check($variants[0]); } } <?php declare (strict_types=1); namespace PHPStan\Rules\PhpDoc; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\InClassNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function count; use function sprintf; /** * @implements Rule<InClassNode> */ final class RequireExtendsDefinitionClassRule implements Rule { /** * @var RequireExtendsCheck */ private $requireExtendsCheck; public function __construct(\PHPStan\Rules\PhpDoc\RequireExtendsCheck $requireExtendsCheck) { $this->requireExtendsCheck = $requireExtendsCheck; } public function getNodeType() : string { return InClassNode::class; } public function processNode(Node $node, Scope $scope) : array { $classReflection = $node->getClassReflection(); $extendsTags = $classReflection->getRequireExtendsTags(); if (count($extendsTags) === 0) { return []; } if (!$classReflection->isInterface()) { return [RuleErrorBuilder::message('PHPDoc tag @phpstan-require-extends is only valid on trait or interface.')->identifier(sprintf('requireExtends.on%s', $classReflection->getClassTypeDescription()))->build()]; } return $this->requireExtendsCheck->checkExtendsTags($node, $extendsTags); } } <?php declare (strict_types=1); namespace PHPStan\Rules\PhpDoc; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\VarTagChangedExpressionTypeNode; use PHPStan\Rules\Rule; /** * @implements Rule<VarTagChangedExpressionTypeNode> */ final class VarTagChangedExpressionTypeRule implements Rule { /** * @var VarTagTypeRuleHelper */ private $varTagTypeRuleHelper; public function __construct(\PHPStan\Rules\PhpDoc\VarTagTypeRuleHelper $varTagTypeRuleHelper) { $this->varTagTypeRuleHelper = $varTagTypeRuleHelper; } public function getNodeType() : string { return VarTagChangedExpressionTypeNode::class; } public function processNode(Node $node, Scope $scope) : array { return $this->varTagTypeRuleHelper->checkExprType($scope, $node->getExpr(), $node->getVarTag()->getType()); } } <?php declare (strict_types=1); namespace PHPStan\Rules; use PhpParser\Node; interface Registry { /** * @template TNodeType of Node * @param class-string<TNodeType> $nodeType * @return array<Rule<TNodeType>> */ public function getRules(string $nodeType) : array; } <?php declare (strict_types=1); namespace PHPStan\Rules\Cast; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Rules\RuleLevelHelper; use PHPStan\Type\ErrorType; use PHPStan\Type\Type; use PHPStan\Type\VerbosityLevel; use function get_class; use function sprintf; use function strtolower; use function substr; /** * @implements Rule<Node\Expr\Cast> */ final class InvalidCastRule implements Rule { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var RuleLevelHelper */ private $ruleLevelHelper; public function __construct(ReflectionProvider $reflectionProvider, RuleLevelHelper $ruleLevelHelper) { $this->reflectionProvider = $reflectionProvider; $this->ruleLevelHelper = $ruleLevelHelper; } public function getNodeType() : string { return Node\Expr\Cast::class; } public function processNode(Node $node, Scope $scope) : array { $castTypeCallback = static function (Type $type) use($node) : ?array { if ($node instanceof Node\Expr\Cast\Int_) { return [$type->toInteger(), 'int']; } elseif ($node instanceof Node\Expr\Cast\Bool_) { return [$type->toBoolean(), 'bool']; } elseif ($node instanceof Node\Expr\Cast\Double) { return [$type->toFloat(), 'double']; } elseif ($node instanceof Node\Expr\Cast\String_) { return [$type->toString(), 'string']; } return null; }; $typeResult = $this->ruleLevelHelper->findTypeToCheck($scope, $node->expr, '', static function (Type $type) use($castTypeCallback) : bool { $castResult = $castTypeCallback($type); if ($castResult === null) { return \true; } [$castType] = $castResult; return !$castType instanceof ErrorType; }); $type = $typeResult->getType(); if ($type instanceof ErrorType) { return []; } $castResult = $castTypeCallback($type); if ($castResult === null) { return []; } [$castType, $castIdentifier] = $castResult; if ($castType instanceof ErrorType) { $classReflection = $this->reflectionProvider->getClass(get_class($node)); $shortName = $classReflection->getNativeReflection()->getShortName(); $shortName = strtolower($shortName); if ($shortName === 'double') { $shortName = 'float'; } else { $shortName = substr($shortName, 0, -1); } return [RuleErrorBuilder::message(sprintf('Cannot cast %s to %s.', $scope->getType($node->expr)->describe(VerbosityLevel::value()), $shortName))->identifier(sprintf('cast.%s', $castIdentifier))->line($node->getStartLine())->build()]; } return []; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Cast; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\Printer\ExprPrinter; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Rules\RuleLevelHelper; use PHPStan\Type\ErrorType; use PHPStan\Type\Type; use PHPStan\Type\VerbosityLevel; use function sprintf; /** * @implements Rule<Node\Scalar\Encapsed> */ final class InvalidPartOfEncapsedStringRule implements Rule { /** * @var ExprPrinter */ private $exprPrinter; /** * @var RuleLevelHelper */ private $ruleLevelHelper; public function __construct(ExprPrinter $exprPrinter, RuleLevelHelper $ruleLevelHelper) { $this->exprPrinter = $exprPrinter; $this->ruleLevelHelper = $ruleLevelHelper; } public function getNodeType() : string { return Node\Scalar\Encapsed::class; } public function processNode(Node $node, Scope $scope) : array { $messages = []; foreach ($node->parts as $part) { if ($part instanceof Node\Scalar\EncapsedStringPart) { continue; } $typeResult = $this->ruleLevelHelper->findTypeToCheck($scope, $part, '', static function (Type $type) : bool { return !$type->toString() instanceof ErrorType; }); $partType = $typeResult->getType(); if ($partType instanceof ErrorType) { continue; } $stringPartType = $partType->toString(); if (!$stringPartType instanceof ErrorType) { continue; } $messages[] = RuleErrorBuilder::message(sprintf('Part %s (%s) of encapsed string cannot be cast to string.', $this->exprPrinter->printExpr($part), $partType->describe(VerbosityLevel::value())))->identifier('encapsedStringPart.nonString')->line($part->getStartLine())->build(); } return $messages; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Cast; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Rules\RuleLevelHelper; use PHPStan\Type\ErrorType; use PHPStan\Type\Type; use PHPStan\Type\VerbosityLevel; use function sprintf; /** * @implements Rule<Node\Stmt\Echo_> */ final class EchoRule implements Rule { /** * @var RuleLevelHelper */ private $ruleLevelHelper; public function __construct(RuleLevelHelper $ruleLevelHelper) { $this->ruleLevelHelper = $ruleLevelHelper; } public function getNodeType() : string { return Node\Stmt\Echo_::class; } public function processNode(Node $node, Scope $scope) : array { $messages = []; foreach ($node->exprs as $key => $expr) { $typeResult = $this->ruleLevelHelper->findTypeToCheck($scope, $expr, '', static function (Type $type) : bool { return !$type->toString() instanceof ErrorType; }); if ($typeResult->getType() instanceof ErrorType || !$typeResult->getType()->toString() instanceof ErrorType) { continue; } $messages[] = RuleErrorBuilder::message(sprintf('Parameter #%d (%s) of echo cannot be converted to string.', $key + 1, $typeResult->getType()->describe(VerbosityLevel::value())))->identifier('echo.nonString')->line($expr->getStartLine())->build(); } return $messages; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Cast; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Rules\RuleLevelHelper; use PHPStan\Type\ErrorType; use PHPStan\Type\Type; use PHPStan\Type\VerbosityLevel; use function sprintf; /** * @implements Rule<Node\Expr\Print_> */ final class PrintRule implements Rule { /** * @var RuleLevelHelper */ private $ruleLevelHelper; public function __construct(RuleLevelHelper $ruleLevelHelper) { $this->ruleLevelHelper = $ruleLevelHelper; } public function getNodeType() : string { return Node\Expr\Print_::class; } public function processNode(Node $node, Scope $scope) : array { $typeResult = $this->ruleLevelHelper->findTypeToCheck($scope, $node->expr, '', static function (Type $type) : bool { return !$type->toString() instanceof ErrorType; }); if (!$typeResult->getType() instanceof ErrorType && $typeResult->getType()->toString() instanceof ErrorType) { return [RuleErrorBuilder::message(sprintf('Parameter %s of print cannot be converted to string.', $typeResult->getType()->describe(VerbosityLevel::value())))->identifier('print.nonString')->line($node->expr->getStartLine())->build()]; } return []; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Cast; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Php\PhpVersion; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; /** * @implements Rule<Node\Expr\Cast\Unset_> */ final class UnsetCastRule implements Rule { /** * @var PhpVersion */ private $phpVersion; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; } public function getNodeType() : string { return Node\Expr\Cast\Unset_::class; } public function processNode(Node $node, Scope $scope) : array { if ($this->phpVersion->supportsUnsetCast()) { return []; } return [RuleErrorBuilder::message('The (unset) cast is no longer supported in PHP 8.0 and later.')->identifier('cast.unset')->nonIgnorable()->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules; use PhpParser\Node\Expr; final class NullsafeCheck { public function containsNullSafe(Expr $expr) : bool { if ($expr instanceof Expr\NullsafePropertyFetch || $expr instanceof Expr\NullsafeMethodCall) { return \true; } if ($expr instanceof Expr\ArrayDimFetch) { return $this->containsNullSafe($expr->var); } if ($expr instanceof Expr\PropertyFetch) { return $this->containsNullSafe($expr->var); } if ($expr instanceof Expr\StaticPropertyFetch && $expr->class instanceof Expr) { return $this->containsNullSafe($expr->class); } if ($expr instanceof Expr\MethodCall) { return $this->containsNullSafe($expr->var); } if ($expr instanceof Expr\StaticCall && $expr->class instanceof Expr) { return $this->containsNullSafe($expr->class); } if ($expr instanceof Expr\List_ || $expr instanceof Expr\Array_) { foreach ($expr->items as $item) { if ($item === null) { continue; } if ($item->key !== null && $this->containsNullSafe($item->key)) { return \true; } if ($this->containsNullSafe($item->value)) { return \true; } } } return \false; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Names; use PhpParser\Node; use PhpParser\Node\Stmt\ClassLike; use PhpParser\Node\Stmt\Enum_; use PhpParser\Node\Stmt\GroupUse; use PhpParser\Node\Stmt\Interface_; use PhpParser\Node\Stmt\Namespace_; use PhpParser\Node\Stmt\Trait_; use PhpParser\Node\Stmt\Use_; use PhpParser\Node\Stmt\UseUse; use PHPStan\Analyser\Scope; use PHPStan\Node\FileNode; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function in_array; use function sprintf; use function strtolower; /** * @implements Rule<FileNode> */ final class UsedNamesRule implements Rule { public function getNodeType() : string { return FileNode::class; } /** * @param FileNode $node */ public function processNode(Node $node, Scope $scope) : array { $usedNames = []; $errors = []; foreach ($node->getNodes() as $oneNode) { if ($oneNode instanceof Namespace_) { $namespaceName = $oneNode->name !== null ? $oneNode->name->toString() : ''; foreach ($oneNode->stmts as $stmt) { foreach ($this->findErrorsForNode($stmt, $namespaceName, $usedNames) as $error) { $errors[] = $error; } } continue; } foreach ($this->findErrorsForNode($oneNode, '', $usedNames) as $error) { $errors[] = $error; } } return $errors; } /** * @param array<string, string[]> $usedNames * @return list<IdentifierRuleError> */ private function findErrorsForNode(Node $node, string $namespace, array &$usedNames) : array { $lowerNamespace = strtolower($namespace); if ($node instanceof Use_) { if ($this->shouldBeIgnored($node)) { return []; } return $this->findErrorsInUses($node->uses, '', $lowerNamespace, $usedNames); } if ($node instanceof GroupUse) { if ($this->shouldBeIgnored($node)) { return []; } $useGroupPrefix = $node->prefix->toString(); return $this->findErrorsInUses($node->uses, $useGroupPrefix, $lowerNamespace, $usedNames); } if ($node instanceof ClassLike) { if ($node->name === null) { return []; } $type = 'class'; if ($node instanceof Interface_) { $type = 'interface'; } elseif ($node instanceof Trait_) { $type = 'trait'; } elseif ($node instanceof Enum_) { $type = 'enum'; } $name = $node->name->toLowerString(); if (in_array($name, $usedNames[$lowerNamespace] ?? [], \true)) { return [RuleErrorBuilder::message(sprintf('Cannot declare %s %s because the name is already in use.', $type, $namespace !== '' ? $namespace . '\\' . $node->name->toString() : $node->name->toString()))->identifier(sprintf('%s.nameInUse', $type))->line($node->getLine())->nonIgnorable()->build()]; } $usedNames[$lowerNamespace][] = $name; return []; } return []; } /** * @param UseUse[] $uses * @param array<string, string[]> $usedNames * @return list<IdentifierRuleError> */ private function findErrorsInUses(array $uses, string $useGroupPrefix, string $lowerNamespace, array &$usedNames) : array { $errors = []; foreach ($uses as $use) { if ($this->shouldBeIgnored($use)) { continue; } $useAlias = $use->getAlias()->toLowerString(); if (in_array($useAlias, $usedNames[$lowerNamespace] ?? [], \true)) { $errors[] = RuleErrorBuilder::message(sprintf('Cannot use %s as %s because the name is already in use.', $useGroupPrefix !== '' ? $useGroupPrefix . '\\' . $use->name->toString() : $use->name->toString(), $use->getAlias()->toString()))->identifier('use.nameInUse')->line($use->getLine())->nonIgnorable()->build(); continue; } $usedNames[$lowerNamespace][] = $useAlias; } return $errors; } /** * @param Use_|GroupUse|UseUse $use */ private function shouldBeIgnored($use) : bool { return in_array($use->type, [Use_::TYPE_FUNCTION, Use_::TYPE_CONSTANT], \true); } } <?php declare (strict_types=1); namespace PHPStan\Rules; /** @api */ interface LineRuleError extends \PHPStan\Rules\RuleError { public function getLine() : int; } <?php declare (strict_types=1); namespace PHPStan\Rules; use Attribute; use PhpParser\Node\AttributeGroup; use PhpParser\Node\Expr\New_; use PHPStan\Analyser\Scope; use PHPStan\Internal\SprintfHelper; use PHPStan\Reflection\ParametersAcceptorSelector; use PHPStan\Reflection\ReflectionProvider; use function array_key_exists; use function count; use function sprintf; use function strtolower; final class AttributesCheck { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var FunctionCallParametersCheck */ private $functionCallParametersCheck; /** * @var ClassNameCheck */ private $classCheck; /** * @var bool */ private $deprecationRulesInstalled; public function __construct(ReflectionProvider $reflectionProvider, \PHPStan\Rules\FunctionCallParametersCheck $functionCallParametersCheck, \PHPStan\Rules\ClassNameCheck $classCheck, bool $deprecationRulesInstalled) { $this->reflectionProvider = $reflectionProvider; $this->functionCallParametersCheck = $functionCallParametersCheck; $this->classCheck = $classCheck; $this->deprecationRulesInstalled = $deprecationRulesInstalled; } /** * @param AttributeGroup[] $attrGroups * @param int-mask-of<Attribute::TARGET_*> $requiredTarget * @return list<IdentifierRuleError> */ public function check(Scope $scope, array $attrGroups, int $requiredTarget, string $targetName) : array { $errors = []; $alreadyPresent = []; foreach ($attrGroups as $attrGroup) { foreach ($attrGroup->attrs as $attribute) { $name = $attribute->name->toString(); if (!$this->reflectionProvider->hasClass($name)) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf('Attribute class %s does not exist.', $name))->line($attribute->getStartLine())->identifier('attribute.notFound')->build(); continue; } $attributeClass = $this->reflectionProvider->getClass($name); if (!$attributeClass->isAttributeClass()) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf('%s %s is not an Attribute class.', $attributeClass->getClassTypeDescription(), $attributeClass->getDisplayName()))->identifier('attribute.notAttribute')->line($attribute->getStartLine())->build(); continue; } if ($attributeClass->isAbstract()) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf('Attribute class %s is abstract.', $name))->identifier('attribute.abstract')->line($attribute->getStartLine())->build(); } foreach ($this->classCheck->checkClassNames([new \PHPStan\Rules\ClassNameNodePair($name, $attribute)]) as $caseSensitivityError) { $errors[] = $caseSensitivityError; } $flags = $attributeClass->getAttributeClassFlags(); if (($flags & $requiredTarget) === 0) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf('Attribute class %s does not have the %s target.', $name, $targetName))->identifier('attribute.target')->line($attribute->getStartLine())->build(); } if (($flags & Attribute::IS_REPEATABLE) === 0) { $loweredName = strtolower($name); if (array_key_exists($loweredName, $alreadyPresent)) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf('Attribute class %s is not repeatable but is already present above the %s.', $name, $targetName))->identifier('attribute.nonRepeatable')->line($attribute->getStartLine())->build(); } $alreadyPresent[$loweredName] = \true; } if ($this->deprecationRulesInstalled && $attributeClass->isDeprecated()) { if ($attributeClass->getDeprecatedDescription() !== null) { $deprecatedError = sprintf('Attribute class %s is deprecated: %s', $name, $attributeClass->getDeprecatedDescription()); } else { $deprecatedError = sprintf('Attribute class %s is deprecated.', $name); } $errors[] = \PHPStan\Rules\RuleErrorBuilder::message($deprecatedError)->identifier('attribute.deprecated')->line($attribute->getStartLine())->build(); } if (!$attributeClass->hasConstructor()) { if (count($attribute->args) > 0) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf('Attribute class %s does not have a constructor and must be instantiated without any parameters.', $name))->identifier('attribute.noConstructor')->line($attribute->getStartLine())->build(); } continue; } $attributeConstructor = $attributeClass->getConstructor(); if (!$attributeConstructor->isPublic()) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf('Constructor of attribute class %s is not public.', $name))->identifier('attribute.constructorNotPublic')->line($attribute->getStartLine())->build(); } $attributeClassName = SprintfHelper::escapeFormatString($attributeClass->getDisplayName()); $nodeAttributes = $attribute->getAttributes(); $nodeAttributes['isAttribute'] = \true; $parameterErrors = $this->functionCallParametersCheck->check(ParametersAcceptorSelector::selectFromArgs($scope, $attribute->args, $attributeConstructor->getVariants(), $attributeConstructor->getNamedArgumentsVariants()), $scope, $attributeConstructor->getDeclaringClass()->isBuiltin(), new New_($attribute->name, $attribute->args, $nodeAttributes), [ 'Attribute class ' . $attributeClassName . ' constructor invoked with %d parameter, %d required.', 'Attribute class ' . $attributeClassName . ' constructor invoked with %d parameters, %d required.', 'Attribute class ' . $attributeClassName . ' constructor invoked with %d parameter, at least %d required.', 'Attribute class ' . $attributeClassName . ' constructor invoked with %d parameters, at least %d required.', 'Attribute class ' . $attributeClassName . ' constructor invoked with %d parameter, %d-%d required.', 'Attribute class ' . $attributeClassName . ' constructor invoked with %d parameters, %d-%d required.', 'Parameter %s of attribute class ' . $attributeClassName . ' constructor expects %s, %s given.', '', // constructor does not have a return type 'Parameter %s of attribute class ' . $attributeClassName . ' constructor is passed by reference, so it expects variables only', 'Unable to resolve the template type %s in instantiation of attribute class ' . $attributeClassName, 'Missing parameter $%s in call to ' . $attributeClassName . ' constructor.', 'Unknown parameter $%s in call to ' . $attributeClassName . ' constructor.', 'Return type of call to ' . $attributeClassName . ' constructor contains unresolvable type.', 'Parameter %s of attribute class ' . $attributeClassName . ' constructor contains unresolvable type.', 'Attribute class ' . $attributeClassName . ' constructor invoked with %s, but it\'s not allowed because of @no-named-arguments.', ], 'attribute', $attributeConstructor->acceptsNamedArguments()); foreach ($parameterErrors as $error) { $errors[] = $error; } } } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules; use PHPStan\Reflection\ReflectionProvider; use function sprintf; use function strtolower; final class ClassCaseSensitivityCheck { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var bool */ private $checkInternalClassCaseSensitivity; public function __construct(ReflectionProvider $reflectionProvider, bool $checkInternalClassCaseSensitivity) { $this->reflectionProvider = $reflectionProvider; $this->checkInternalClassCaseSensitivity = $checkInternalClassCaseSensitivity; } /** * @param ClassNameNodePair[] $pairs * @return list<IdentifierRuleError> */ public function checkClassNames(array $pairs) : array { $errors = []; foreach ($pairs as $pair) { $className = $pair->getClassName(); if (!$this->reflectionProvider->hasClass($className)) { continue; } $classReflection = $this->reflectionProvider->getClass($className); if (!$this->checkInternalClassCaseSensitivity && $classReflection->isBuiltin()) { continue; // skip built-in classes } $realClassName = $classReflection->getName(); if (strtolower($realClassName) !== strtolower($className)) { continue; // skip class alias } if ($realClassName === $className) { continue; } $typeName = $classReflection->getClassTypeDescription(); $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf('%s %s referenced with incorrect case: %s.', $typeName, $realClassName, $className))->identifier(sprintf('%s.nameCase', strtolower($typeName)))->line($pair->getNode()->getStartLine())->build(); } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules; /** @api */ interface MetadataRuleError extends \PHPStan\Rules\RuleError { /** * @return mixed[] */ public function getMetadata() : array; } <?php declare (strict_types=1); namespace PHPStan\Rules\Operators; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Rules\RuleLevelHelper; use PHPStan\ShouldNotHappenException; use PHPStan\Type\BenevolentUnionType; use PHPStan\Type\ErrorType; use PHPStan\Type\FloatType; use PHPStan\Type\IntegerType; use PHPStan\Type\ObjectWithoutClassType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\UnionType; use PHPStan\Type\VerbosityLevel; use function get_class; use function sprintf; /** * @implements Rule<Node\Expr\BinaryOp> */ final class InvalidComparisonOperationRule implements Rule { /** * @var RuleLevelHelper */ private $ruleLevelHelper; public function __construct(RuleLevelHelper $ruleLevelHelper) { $this->ruleLevelHelper = $ruleLevelHelper; } public function getNodeType() : string { return Node\Expr\BinaryOp::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node instanceof Node\Expr\BinaryOp\Equal && !$node instanceof Node\Expr\BinaryOp\NotEqual && !$node instanceof Node\Expr\BinaryOp\Smaller && !$node instanceof Node\Expr\BinaryOp\SmallerOrEqual && !$node instanceof Node\Expr\BinaryOp\Greater && !$node instanceof Node\Expr\BinaryOp\GreaterOrEqual && !$node instanceof Node\Expr\BinaryOp\Spaceship) { return []; } if ($this->isNumberType($scope, $node->left) && $this->isNumberType($scope, $node->right)) { return []; } if ($this->isNumberType($scope, $node->left) && ($this->isPossiblyNullableObjectType($scope, $node->right) || $this->isPossiblyNullableArrayType($scope, $node->right)) || $this->isNumberType($scope, $node->right) && ($this->isPossiblyNullableObjectType($scope, $node->left) || $this->isPossiblyNullableArrayType($scope, $node->left))) { switch (get_class($node)) { case Node\Expr\BinaryOp\Equal::class: $nodeType = 'equal'; break; case Node\Expr\BinaryOp\NotEqual::class: $nodeType = 'notEqual'; break; case Node\Expr\BinaryOp\Greater::class: $nodeType = 'greater'; break; case Node\Expr\BinaryOp\GreaterOrEqual::class: $nodeType = 'greaterOrEqual'; break; case Node\Expr\BinaryOp\Smaller::class: $nodeType = 'smaller'; break; case Node\Expr\BinaryOp\SmallerOrEqual::class: $nodeType = 'smallerOrEqual'; break; case Node\Expr\BinaryOp\Spaceship::class: $nodeType = 'spaceship'; break; default: throw new ShouldNotHappenException(); } return [RuleErrorBuilder::message(sprintf('Comparison operation "%s" between %s and %s results in an error.', $node->getOperatorSigil(), $scope->getType($node->left)->describe(VerbosityLevel::value()), $scope->getType($node->right)->describe(VerbosityLevel::value())))->line($node->left->getStartLine())->identifier(sprintf('%s.invalid', $nodeType))->build()]; } return []; } private function isNumberType(Scope $scope, Node\Expr $expr) : bool { $acceptedType = new UnionType([new IntegerType(), new FloatType()]); $onlyNumber = static function (Type $type) use($acceptedType) : bool { return $acceptedType->isSuperTypeOf($type)->yes(); }; $type = $this->ruleLevelHelper->findTypeToCheck($scope, $expr, '', $onlyNumber)->getType(); if ($type instanceof ErrorType || !$type->equals($scope->getType($expr))) { return \false; } // SimpleXMLElement can be cast to number union type return !$acceptedType->isSuperTypeOf($type)->no() || $acceptedType->equals($type->toNumber()); } private function isPossiblyNullableObjectType(Scope $scope, Node\Expr $expr) : bool { $acceptedType = new ObjectWithoutClassType(); $type = $this->ruleLevelHelper->findTypeToCheck($scope, $expr, '', static function (Type $type) use($acceptedType) : bool { return $acceptedType->isSuperTypeOf($type)->yes(); })->getType(); if ($type instanceof ErrorType) { return \false; } if (TypeCombinator::containsNull($type) && !$type->isNull()->yes()) { $type = TypeCombinator::removeNull($type); } $isSuperType = $acceptedType->isSuperTypeOf($type); if ($type instanceof BenevolentUnionType) { return !$isSuperType->no(); } return $isSuperType->yes(); } private function isPossiblyNullableArrayType(Scope $scope, Node\Expr $expr) : bool { $type = $this->ruleLevelHelper->findTypeToCheck($scope, $expr, '', static function (Type $type) : bool { return $type->isArray()->yes(); })->getType(); if (TypeCombinator::containsNull($type) && !$type->isNull()->yes()) { $type = TypeCombinator::removeNull($type); } return !$type instanceof ErrorType && $type->isArray()->yes(); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Operators; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Rules\RuleLevelHelper; use PHPStan\ShouldNotHappenException; use PHPStan\Type\BooleanType; use PHPStan\Type\ErrorType; use PHPStan\Type\FloatType; use PHPStan\Type\IntegerType; use PHPStan\Type\NullType; use PHPStan\Type\ObjectType; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\UnionType; use PHPStan\Type\VerbosityLevel; use function get_class; use function sprintf; /** * @implements Rule<Node\Expr> */ final class InvalidIncDecOperationRule implements Rule { /** * @var RuleLevelHelper */ private $ruleLevelHelper; /** * @var bool */ private $bleedingEdge; /** * @var bool */ private $checkThisOnly; public function __construct(RuleLevelHelper $ruleLevelHelper, bool $bleedingEdge, bool $checkThisOnly) { $this->ruleLevelHelper = $ruleLevelHelper; $this->bleedingEdge = $bleedingEdge; $this->checkThisOnly = $checkThisOnly; } public function getNodeType() : string { return Node\Expr::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node instanceof Node\Expr\PreInc && !$node instanceof Node\Expr\PostInc && !$node instanceof Node\Expr\PreDec && !$node instanceof Node\Expr\PostDec) { return []; } switch (get_class($node)) { case Node\Expr\PreInc::class: $nodeType = 'preInc'; break; case Node\Expr\PostInc::class: $nodeType = 'postInc'; break; case Node\Expr\PreDec::class: $nodeType = 'preDec'; break; case Node\Expr\PostDec::class: $nodeType = 'postDec'; break; default: throw new ShouldNotHappenException(); } $operatorString = $node instanceof Node\Expr\PreInc || $node instanceof Node\Expr\PostInc ? '++' : '--'; if (!$node->var instanceof Node\Expr\Variable && !$node->var instanceof Node\Expr\ArrayDimFetch && !$node->var instanceof Node\Expr\PropertyFetch && !$node->var instanceof Node\Expr\StaticPropertyFetch) { return [RuleErrorBuilder::message(sprintf('Cannot use %s on a non-variable.', $operatorString))->line($node->var->getStartLine())->identifier(sprintf('%s.expr', $nodeType))->build()]; } if (!$this->bleedingEdge) { if ($this->checkThisOnly) { return []; } $varType = $scope->getType($node->var); if (!$varType->toString() instanceof ErrorType) { return []; } if (!$varType->toNumber() instanceof ErrorType) { return []; } } else { $allowedTypes = new UnionType([new BooleanType(), new FloatType(), new IntegerType(), new StringType(), new NullType(), new ObjectType('SimpleXMLElement')]); $varType = $this->ruleLevelHelper->findTypeToCheck($scope, $node->var, '', static function (Type $type) use($allowedTypes) : bool { return $allowedTypes->isSuperTypeOf($type)->yes(); })->getType(); if ($varType instanceof ErrorType || $allowedTypes->isSuperTypeOf($varType)->yes()) { return []; } } return [RuleErrorBuilder::message(sprintf('Cannot use %s on %s.', $operatorString, $varType->describe(VerbosityLevel::value())))->line($node->var->getStartLine())->identifier(sprintf('%s.type', $nodeType))->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Operators; use PhpParser\Node; use PHPStan\Analyser\MutatingScope; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Rules\RuleLevelHelper; use PHPStan\ShouldNotHappenException; use PHPStan\Type\ErrorType; use PHPStan\Type\Type; use PHPStan\Type\VerbosityLevel; use function sprintf; /** * @implements Rule<Node\Expr> */ final class InvalidUnaryOperationRule implements Rule { /** * @var RuleLevelHelper */ private $ruleLevelHelper; /** * @var bool */ private $bleedingEdge; public function __construct(RuleLevelHelper $ruleLevelHelper, bool $bleedingEdge) { $this->ruleLevelHelper = $ruleLevelHelper; $this->bleedingEdge = $bleedingEdge; } public function getNodeType() : string { return Node\Expr::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node instanceof Node\Expr\UnaryPlus && !$node instanceof Node\Expr\UnaryMinus && !$node instanceof Node\Expr\BitwiseNot) { return []; } if ($this->bleedingEdge) { $varName = '__PHPSTAN__LEFT__'; $variable = new Node\Expr\Variable($varName); $newNode = clone $node; $newNode->setAttribute('phpstan_cache_printer', null); $newNode->expr = $variable; if ($node instanceof Node\Expr\BitwiseNot) { $callback = static function (Type $type) : bool { return $type->isString()->yes() || $type->isInteger()->yes() || $type->isFloat()->yes(); }; } else { $callback = static function (Type $type) : bool { return !$type->toNumber() instanceof ErrorType; }; } $exprType = $this->ruleLevelHelper->findTypeToCheck($scope, $node->expr, '', $callback)->getType(); if ($exprType instanceof ErrorType) { return []; } if (!$scope instanceof MutatingScope) { throw new ShouldNotHappenException(); } $scope = $scope->assignVariable($varName, $exprType, $exprType); if (!$scope->getType($newNode) instanceof ErrorType) { return []; } } elseif (!$scope->getType($node) instanceof ErrorType) { return []; } if ($node instanceof Node\Expr\UnaryPlus) { $operator = '+'; } elseif ($node instanceof Node\Expr\UnaryMinus) { $operator = '-'; } else { $operator = '~'; } return [RuleErrorBuilder::message(sprintf('Unary operation "%s" on %s results in an error.', $operator, $scope->getType($node->expr)->describe(VerbosityLevel::value())))->line($node->expr->getStartLine())->identifier('unaryOp.invalid')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Operators; use PhpParser\Node; use PHPStan\Analyser\MutatingScope; use PHPStan\Analyser\Scope; use PHPStan\Node\Printer\ExprPrinter; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Rules\RuleLevelHelper; use PHPStan\ShouldNotHappenException; use PHPStan\Type\ErrorType; use PHPStan\Type\Type; use PHPStan\Type\VerbosityLevel; use function sprintf; use function strlen; use function substr; /** * @implements Rule<Node\Expr> */ final class InvalidBinaryOperationRule implements Rule { /** * @var ExprPrinter */ private $exprPrinter; /** * @var RuleLevelHelper */ private $ruleLevelHelper; /** * @var bool */ private $bleedingEdge; public function __construct(ExprPrinter $exprPrinter, RuleLevelHelper $ruleLevelHelper, bool $bleedingEdge) { $this->exprPrinter = $exprPrinter; $this->ruleLevelHelper = $ruleLevelHelper; $this->bleedingEdge = $bleedingEdge; } public function getNodeType() : string { return Node\Expr::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node instanceof Node\Expr\BinaryOp && !$node instanceof Node\Expr\AssignOp) { return []; } if (!$scope->getType($node) instanceof ErrorType && !$this->bleedingEdge) { return []; } $leftName = '__PHPSTAN__LEFT__'; $rightName = '__PHPSTAN__RIGHT__'; $leftVariable = new Node\Expr\Variable($leftName); $rightVariable = new Node\Expr\Variable($rightName); if ($node instanceof Node\Expr\AssignOp) { $identifier = 'assignOp'; $newNode = clone $node; $newNode->setAttribute('phpstan_cache_printer', null); $left = $node->var; $right = $node->expr; $newNode->var = $leftVariable; $newNode->expr = $rightVariable; } else { $identifier = 'binaryOp'; $newNode = clone $node; $newNode->setAttribute('phpstan_cache_printer', null); $left = $node->left; $right = $node->right; $newNode->left = $leftVariable; $newNode->right = $rightVariable; } if ($node instanceof Node\Expr\AssignOp\Concat || $node instanceof Node\Expr\BinaryOp\Concat) { $callback = static function (Type $type) : bool { return !$type->toString() instanceof ErrorType; }; } elseif ($node instanceof Node\Expr\AssignOp\Plus || $node instanceof Node\Expr\BinaryOp\Plus) { $callback = static function (Type $type) : bool { return !$type->toNumber() instanceof ErrorType || $type->isArray()->yes(); }; } else { $callback = static function (Type $type) : bool { return !$type->toNumber() instanceof ErrorType; }; } $leftType = $this->ruleLevelHelper->findTypeToCheck($scope, $left, '', $callback)->getType(); if ($leftType instanceof ErrorType) { return []; } $rightType = $this->ruleLevelHelper->findTypeToCheck($scope, $right, '', $callback)->getType(); if ($rightType instanceof ErrorType) { return []; } if (!$scope instanceof MutatingScope) { throw new ShouldNotHappenException(); } $scope = $scope->assignVariable($leftName, $leftType, $leftType)->assignVariable($rightName, $rightType, $rightType); if (!$scope->getType($newNode) instanceof ErrorType) { return []; } return [RuleErrorBuilder::message(sprintf('Binary operation "%s" between %s and %s results in an error.', substr(substr($this->exprPrinter->printExpr($newNode), strlen($leftName) + 2), 0, -(strlen($rightName) + 2)), $scope->getType($left)->describe(VerbosityLevel::value()), $scope->getType($right)->describe(VerbosityLevel::value())))->line($left->getStartLine())->identifier(sprintf('%s.invalid', $identifier))->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Operators; use PhpParser\Node; use PhpParser\Node\Expr; use PhpParser\Node\Expr\Assign; use PhpParser\Node\Expr\AssignOp; use PhpParser\Node\Expr\AssignRef; use PHPStan\Analyser\Scope; use PHPStan\Rules\NullsafeCheck; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; /** * @implements Rule<Expr> */ final class InvalidAssignVarRule implements Rule { /** * @var NullsafeCheck */ private $nullsafeCheck; public function __construct(NullsafeCheck $nullsafeCheck) { $this->nullsafeCheck = $nullsafeCheck; } public function getNodeType() : string { return Expr::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node instanceof Assign && !$node instanceof AssignOp && !$node instanceof AssignRef) { return []; } if ($this->nullsafeCheck->containsNullSafe($node->var)) { return [RuleErrorBuilder::message('Nullsafe operator cannot be on left side of assignment.')->identifier('nullsafe.assign')->nonIgnorable()->build()]; } if ($node instanceof AssignRef && $this->nullsafeCheck->containsNullSafe($node->expr)) { return [RuleErrorBuilder::message('Nullsafe operator cannot be on right side of assignment by reference.')->identifier('nullsafe.byRef')->nonIgnorable()->build()]; } if ($this->containsNonAssignableExpression($node->var)) { return [RuleErrorBuilder::message('Expression on left side of assignment is not assignable.')->identifier('assign.invalidExpr')->nonIgnorable()->build()]; } return []; } private function containsNonAssignableExpression(Expr $expr) : bool { if ($expr instanceof Expr\Variable) { return \false; } if ($expr instanceof Expr\PropertyFetch) { return \false; } if ($expr instanceof Expr\ArrayDimFetch) { return \false; } if ($expr instanceof Expr\StaticPropertyFetch) { return \false; } if ($expr instanceof Expr\List_ || $expr instanceof Expr\Array_) { foreach ($expr->items as $item) { if ($item === null) { continue; } if (!$this->containsNonAssignableExpression($item->value)) { continue; } return \true; } return \false; } return \true; } } <?php declare (strict_types=1); namespace PHPStan\Rules; use PhpParser\Node; use PhpParser\Node\ComplexType; use PhpParser\Node\Expr\ConstFetch; use PhpParser\Node\Expr\Variable; use PhpParser\Node\FunctionLike; use PhpParser\Node\Identifier; use PhpParser\Node\IntersectionType; use PhpParser\Node\Name; use PhpParser\Node\NullableType; use PhpParser\Node\Param; use PhpParser\Node\Stmt\ClassMethod; use PhpParser\Node\Stmt\Function_; use PhpParser\Node\UnionType; use PHPStan\Analyser\Scope; use PHPStan\Node\Printer\NodeTypePrinter; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\ParameterReflection; use PHPStan\Reflection\ParameterReflectionWithPhpDocs; use PHPStan\Reflection\ParametersAcceptor; use PHPStan\Reflection\ParametersAcceptorWithPhpDocs; use PHPStan\Reflection\Php\PhpFunctionFromParserNodeReflection; use PHPStan\Reflection\Php\PhpMethodFromParserNodeReflection; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\PhpDoc\UnresolvableTypeHelper; use PHPStan\ShouldNotHappenException; use PHPStan\Type\ConditionalTypeForParameter; use PHPStan\Type\Generic\TemplateType; use PHPStan\Type\NonexistentParentClassType; use PHPStan\Type\ParserNodeTypeToPHPStanType; use PHPStan\Type\Type; use PHPStan\Type\TypeTraverser; use PHPStan\Type\VerbosityLevel; use function array_filter; use function array_keys; use function array_map; use function array_merge; use function count; use function in_array; use function is_string; use function sprintf; use function strtolower; final class FunctionDefinitionCheck { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var ClassNameCheck */ private $classCheck; /** * @var UnresolvableTypeHelper */ private $unresolvableTypeHelper; /** * @var PhpVersion */ private $phpVersion; /** * @var bool */ private $checkClassCaseSensitivity; /** * @var bool */ private $checkThisOnly; /** * @var bool */ private $absentTypeChecks; public function __construct(ReflectionProvider $reflectionProvider, \PHPStan\Rules\ClassNameCheck $classCheck, UnresolvableTypeHelper $unresolvableTypeHelper, PhpVersion $phpVersion, bool $checkClassCaseSensitivity, bool $checkThisOnly, bool $absentTypeChecks) { $this->reflectionProvider = $reflectionProvider; $this->classCheck = $classCheck; $this->unresolvableTypeHelper = $unresolvableTypeHelper; $this->phpVersion = $phpVersion; $this->checkClassCaseSensitivity = $checkClassCaseSensitivity; $this->checkThisOnly = $checkThisOnly; $this->absentTypeChecks = $absentTypeChecks; } /** * @return list<IdentifierRuleError> */ public function checkFunction(Function_ $function, PhpFunctionFromParserNodeReflection $functionReflection, string $parameterMessage, string $returnMessage, string $unionTypesMessage, string $templateTypeMissingInParameterMessage, string $unresolvableParameterTypeMessage, string $unresolvableReturnTypeMessage) : array { return $this->checkParametersAcceptor($functionReflection, $function, $parameterMessage, $returnMessage, $unionTypesMessage, $templateTypeMissingInParameterMessage, $unresolvableParameterTypeMessage, $unresolvableReturnTypeMessage); } /** * @param Node\Param[] $parameters * @param Node\Identifier|Node\Name|Node\ComplexType|null $returnTypeNode * @return list<IdentifierRuleError> */ public function checkAnonymousFunction(Scope $scope, array $parameters, $returnTypeNode, string $parameterMessage, string $returnMessage, string $unionTypesMessage, string $unresolvableParameterTypeMessage, string $unresolvableReturnTypeMessage) : array { $errors = []; $unionTypeReported = \false; foreach ($parameters as $i => $param) { if ($param->type === null) { continue; } if (!$unionTypeReported && $param->type instanceof UnionType && !$this->phpVersion->supportsNativeUnionTypes()) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message($unionTypesMessage)->line($param->getStartLine())->identifier('parameter.unionTypeNotSupported')->nonIgnorable()->build(); $unionTypeReported = \true; } if (!$param->var instanceof Variable || !is_string($param->var->name)) { throw new ShouldNotHappenException(); } $implicitlyNullableTypeError = $this->checkImplicitlyNullableType($param->type, $param->default, $i + 1, $param->getStartLine(), $param->var->name); if ($implicitlyNullableTypeError !== null) { $errors[] = $implicitlyNullableTypeError; } $type = $scope->getFunctionType($param->type, \false, \false); if ($type->isVoid()->yes()) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf($parameterMessage, $param->var->name, 'void'))->line($param->type->getStartLine())->identifier('parameter.void')->nonIgnorable()->build(); } if ($this->phpVersion->supportsPureIntersectionTypes() && $this->unresolvableTypeHelper->containsUnresolvableType($type)) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf($unresolvableParameterTypeMessage, $param->var->name))->line($param->type->getStartLine())->identifier('parameter.unresolvableNativeType')->nonIgnorable()->build(); } foreach ($type->getReferencedClasses() as $class) { if (!$this->reflectionProvider->hasClass($class)) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf($parameterMessage, $param->var->name, $class))->line($param->type->getStartLine())->identifier('class.notFound')->build(); continue; } $classReflection = $this->reflectionProvider->getClass($class); if ($classReflection->isTrait()) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf($parameterMessage, $param->var->name, $class))->line($param->type->getStartLine())->identifier('parameter.trait')->build(); continue; } $errors = array_merge($errors, $this->classCheck->checkClassNames([new \PHPStan\Rules\ClassNameNodePair($class, $param->type)], $this->checkClassCaseSensitivity)); } } if ($this->phpVersion->deprecatesRequiredParameterAfterOptional()) { $errors = array_merge($errors, $this->checkRequiredParameterAfterOptional($parameters)); } if ($returnTypeNode === null) { return $errors; } if (!$unionTypeReported && $returnTypeNode instanceof UnionType && !$this->phpVersion->supportsNativeUnionTypes()) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message($unionTypesMessage)->line($returnTypeNode->getStartLine())->identifier('return.unionTypeNotSupported')->nonIgnorable()->build(); } $returnType = $scope->getFunctionType($returnTypeNode, \false, \false); if ($this->phpVersion->supportsPureIntersectionTypes() && $this->unresolvableTypeHelper->containsUnresolvableType($returnType)) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message($unresolvableReturnTypeMessage)->line($returnTypeNode->getStartLine())->identifier('return.unresolvableNativeType')->nonIgnorable()->build(); } foreach ($returnType->getReferencedClasses() as $returnTypeClass) { if (!$this->reflectionProvider->hasClass($returnTypeClass)) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf($returnMessage, $returnTypeClass))->line($returnTypeNode->getLine())->identifier('class.notFound')->build(); continue; } if ($this->reflectionProvider->getClass($returnTypeClass)->isTrait()) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf($returnMessage, $returnTypeClass))->line($returnTypeNode->getStartLine())->identifier('return.trait')->build(); continue; } $errors = array_merge($errors, $this->classCheck->checkClassNames([new \PHPStan\Rules\ClassNameNodePair($returnTypeClass, $returnTypeNode)], $this->checkClassCaseSensitivity)); } return $errors; } /** * @return list<IdentifierRuleError> */ public function checkClassMethod(PhpMethodFromParserNodeReflection $methodReflection, ClassMethod $methodNode, string $parameterMessage, string $returnMessage, string $unionTypesMessage, string $templateTypeMissingInParameterMessage, string $unresolvableParameterTypeMessage, string $unresolvableReturnTypeMessage, string $selfOutMessage) : array { $errors = $this->checkParametersAcceptor($methodReflection, $methodNode, $parameterMessage, $returnMessage, $unionTypesMessage, $templateTypeMissingInParameterMessage, $unresolvableParameterTypeMessage, $unresolvableReturnTypeMessage); $selfOutType = $methodReflection->getSelfOutType(); if ($selfOutType !== null && $this->absentTypeChecks) { $selfOutTypeReferencedClasses = $selfOutType->getReferencedClasses(); foreach ($selfOutTypeReferencedClasses as $class) { if (!$this->reflectionProvider->hasClass($class)) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf($selfOutMessage, $class))->line($methodNode->getStartLine())->identifier('class.notFound')->build(); continue; } if (!$this->reflectionProvider->getClass($class)->isTrait()) { continue; } $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf($selfOutMessage, $class))->line($methodNode->getStartLine())->identifier('selfOut.trait')->build(); } $errors = array_merge($errors, $this->classCheck->checkClassNames(array_map(static function (string $class) use($methodNode) : \PHPStan\Rules\ClassNameNodePair { return new \PHPStan\Rules\ClassNameNodePair($class, $methodNode); }, $selfOutTypeReferencedClasses), $this->checkClassCaseSensitivity)); } return $errors; } /** * @return list<IdentifierRuleError> */ private function checkParametersAcceptor(ParametersAcceptor $parametersAcceptor, FunctionLike $functionNode, string $parameterMessage, string $returnMessage, string $unionTypesMessage, string $templateTypeMissingInParameterMessage, string $unresolvableParameterTypeMessage, string $unresolvableReturnTypeMessage) : array { $errors = []; $parameterNodes = $functionNode->getParams(); if (!$this->phpVersion->supportsNativeUnionTypes()) { $unionTypeReported = \false; foreach ($parameterNodes as $parameterNode) { if (!$parameterNode->type instanceof UnionType) { continue; } $errors[] = \PHPStan\Rules\RuleErrorBuilder::message($unionTypesMessage)->line($parameterNode->getStartLine())->identifier('parameter.unionTypeNotSupported')->nonIgnorable()->build(); $unionTypeReported = \true; break; } if (!$unionTypeReported && $functionNode->getReturnType() instanceof UnionType) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message($unionTypesMessage)->line($functionNode->getReturnType()->getStartLine())->identifier('return.unionTypeNotSupported')->nonIgnorable()->build(); } } foreach ($parameterNodes as $i => $parameterNode) { if (!$parameterNode->var instanceof Variable || !is_string($parameterNode->var->name)) { throw new ShouldNotHappenException(); } $implicitlyNullableTypeError = $this->checkImplicitlyNullableType($parameterNode->type, $parameterNode->default, $i + 1, $parameterNode->getStartLine(), $parameterNode->var->name); if ($implicitlyNullableTypeError === null) { continue; } $errors[] = $implicitlyNullableTypeError; } if ($this->phpVersion->deprecatesRequiredParameterAfterOptional()) { $errors = array_merge($errors, $this->checkRequiredParameterAfterOptional($parameterNodes)); } $returnTypeNode = $functionNode->getReturnType() ?? $functionNode; foreach ($parametersAcceptor->getParameters() as $parameter) { $referencedClasses = $this->getParameterReferencedClasses($parameter); $parameterNode = null; $parameterNodeCallback = function () use($parameter, $parameterNodes, &$parameterNode) : Param { if ($parameterNode === null) { $parameterNode = $this->getParameterNode($parameter->getName(), $parameterNodes); } return $parameterNode; }; if ($parameter instanceof ParameterReflectionWithPhpDocs) { $parameterVar = $parameterNodeCallback()->var; if (!$parameterVar instanceof Variable || !is_string($parameterVar->name)) { throw new ShouldNotHappenException(); } if ($parameter->getNativeType()->isVoid()->yes()) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf($parameterMessage, $parameterVar->name, 'void'))->line($parameterNodeCallback()->getStartLine())->identifier('parameter.void')->nonIgnorable()->build(); } if ($this->phpVersion->supportsPureIntersectionTypes() && $this->unresolvableTypeHelper->containsUnresolvableType($parameter->getNativeType())) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf($unresolvableParameterTypeMessage, $parameterVar->name))->line($parameterNodeCallback()->getStartLine())->identifier('parameter.unresolvableNativeType')->nonIgnorable()->build(); } } foreach ($referencedClasses as $class) { if (!$this->reflectionProvider->hasClass($class)) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf($parameterMessage, $parameter->getName(), $class))->line($parameterNodeCallback()->getStartLine())->identifier('class.notFound')->build(); continue; } if (!$this->reflectionProvider->getClass($class)->isTrait()) { continue; } $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf($parameterMessage, $parameter->getName(), $class))->line($parameterNodeCallback()->getStartLine())->identifier('parameter.trait')->build(); } $errors = array_merge($errors, $this->classCheck->checkClassNames(array_map(static function (string $class) use($parameterNodeCallback) : \PHPStan\Rules\ClassNameNodePair { return new \PHPStan\Rules\ClassNameNodePair($class, $parameterNodeCallback()); }, $referencedClasses), $this->checkClassCaseSensitivity)); if (!$parameter->getType() instanceof NonexistentParentClassType) { continue; } $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf($parameterMessage, $parameter->getName(), $parameter->getType()->describe(VerbosityLevel::typeOnly())))->line($parameterNodeCallback()->getStartLine())->identifier('parameter.noParent')->build(); } if ($this->phpVersion->supportsPureIntersectionTypes() && $functionNode->getReturnType() !== null) { $nativeReturnType = ParserNodeTypeToPHPStanType::resolve($functionNode->getReturnType(), null); if ($this->unresolvableTypeHelper->containsUnresolvableType($nativeReturnType)) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message($unresolvableReturnTypeMessage)->nonIgnorable()->line($returnTypeNode->getStartLine())->identifier('return.unresolvableNativeType')->build(); } } $returnTypeReferencedClasses = $this->getReturnTypeReferencedClasses($parametersAcceptor); foreach ($returnTypeReferencedClasses as $class) { if (!$this->reflectionProvider->hasClass($class)) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf($returnMessage, $class))->line($returnTypeNode->getStartLine())->identifier('class.notFound')->build(); continue; } if (!$this->reflectionProvider->getClass($class)->isTrait()) { continue; } $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf($returnMessage, $class))->line($returnTypeNode->getStartLine())->identifier('return.trait')->build(); } $errors = array_merge($errors, $this->classCheck->checkClassNames(array_map(static function (string $class) use($returnTypeNode) : \PHPStan\Rules\ClassNameNodePair { return new \PHPStan\Rules\ClassNameNodePair($class, $returnTypeNode); }, $returnTypeReferencedClasses), $this->checkClassCaseSensitivity)); if ($parametersAcceptor->getReturnType() instanceof NonexistentParentClassType) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf($returnMessage, $parametersAcceptor->getReturnType()->describe(VerbosityLevel::typeOnly())))->line($returnTypeNode->getStartLine())->identifier('return.noParent')->build(); } $templateTypeMap = $parametersAcceptor->getTemplateTypeMap(); $templateTypes = $templateTypeMap->getTypes(); if (count($templateTypes) > 0) { foreach ($parametersAcceptor->getParameters() as $parameter) { TypeTraverser::map($parameter->getType(), static function (Type $type, callable $traverse) use(&$templateTypes) : Type { if ($type instanceof TemplateType) { unset($templateTypes[$type->getName()]); return $traverse($type); } return $traverse($type); }); } $returnType = $parametersAcceptor->getReturnType(); if ($returnType instanceof ConditionalTypeForParameter && !$returnType->isNegated()) { TypeTraverser::map($returnType, static function (Type $type, callable $traverse) use(&$templateTypes) : Type { if ($type instanceof TemplateType) { unset($templateTypes[$type->getName()]); return $traverse($type); } return $traverse($type); }); } foreach (array_keys($templateTypes) as $templateTypeName) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf($templateTypeMissingInParameterMessage, $templateTypeName))->identifier('method.templateTypeNotInParameter')->build(); } } return $errors; } /** * @param Param[] $parameterNodes * @return list<IdentifierRuleError> */ private function checkRequiredParameterAfterOptional(array $parameterNodes) : array { /** @var string|null $optionalParameter */ $optionalParameter = null; $errors = []; $targetPhpVersion = null; foreach ($parameterNodes as $parameterNode) { if (!$parameterNode->var instanceof Variable) { throw new ShouldNotHappenException(); } if (!is_string($parameterNode->var->name)) { throw new ShouldNotHappenException(); } $parameterName = $parameterNode->var->name; if ($optionalParameter !== null && $parameterNode->default === null && !$parameterNode->variadic) { $errors[] = \PHPStan\Rules\RuleErrorBuilder::message(sprintf('Deprecated in PHP %s: Required parameter $%s follows optional parameter $%s.', $targetPhpVersion ?? '8.0', $parameterName, $optionalParameter))->line($parameterNode->getStartLine())->identifier('parameter.requiredAfterOptional')->build(); $targetPhpVersion = null; continue; } if ($parameterNode->default === null) { continue; } if ($parameterNode->type === null) { $optionalParameter = $parameterName; continue; } $defaultValue = $parameterNode->default; if (!$defaultValue instanceof ConstFetch) { $optionalParameter = $parameterName; continue; } $constantName = $defaultValue->name->toLowerString(); if ($constantName === 'null') { if (!$this->phpVersion->deprecatesRequiredParameterAfterOptionalNullableAndDefaultNull()) { continue; } $parameterNodeType = $parameterNode->type; if ($parameterNodeType instanceof NullableType) { $targetPhpVersion = '8.1'; } if ($this->phpVersion->deprecatesRequiredParameterAfterOptionalUnionOrMixed()) { $types = []; if ($parameterNodeType instanceof UnionType) { $types = $parameterNodeType->types; } elseif ($parameterNodeType instanceof Identifier) { $types = [$parameterNodeType]; } $nullOrMixed = array_filter($types, static function ($type) : bool { return $type instanceof Identifier && in_array($type->name, ['null', 'mixed'], \true); }); if (0 < count($nullOrMixed)) { $targetPhpVersion = '8.3'; } } if ($targetPhpVersion === null) { continue; } } $optionalParameter = $parameterName; } return $errors; } /** * @param Param[] $parameterNodes */ private function getParameterNode(string $parameterName, array $parameterNodes) : Param { foreach ($parameterNodes as $param) { if ($param->var instanceof Node\Expr\Error) { continue; } if (!is_string($param->var->name)) { continue; } if ($param->var->name === $parameterName) { return $param; } } throw new ShouldNotHappenException(sprintf('Parameter %s not found.', $parameterName)); } /** * @return string[] */ private function getParameterReferencedClasses(ParameterReflection $parameter) : array { if (!$parameter instanceof ParameterReflectionWithPhpDocs) { return $parameter->getType()->getReferencedClasses(); } if ($this->checkThisOnly) { return $parameter->getNativeType()->getReferencedClasses(); } $moreClasses = []; if ($this->absentTypeChecks) { if ($parameter->getOutType() !== null) { $moreClasses = array_merge($moreClasses, $parameter->getOutType()->getReferencedClasses()); } if ($parameter->getClosureThisType() !== null) { $moreClasses = array_merge($moreClasses, $parameter->getClosureThisType()->getReferencedClasses()); } } return array_merge($parameter->getNativeType()->getReferencedClasses(), $parameter->getPhpDocType()->getReferencedClasses(), $moreClasses); } /** * @return string[] */ private function getReturnTypeReferencedClasses(ParametersAcceptor $parametersAcceptor) : array { if (!$parametersAcceptor instanceof ParametersAcceptorWithPhpDocs) { return $parametersAcceptor->getReturnType()->getReferencedClasses(); } if ($this->checkThisOnly) { return $parametersAcceptor->getNativeReturnType()->getReferencedClasses(); } return array_merge($parametersAcceptor->getNativeReturnType()->getReferencedClasses(), $parametersAcceptor->getPhpDocReturnType()->getReferencedClasses()); } /** * @param Identifier|Name|ComplexType|null $type */ private function checkImplicitlyNullableType($type, ?Node\Expr $default, int $order, int $line, string $name) : ?\PHPStan\Rules\IdentifierRuleError { if (!$default instanceof ConstFetch) { return null; } if ($default->name->toLowerString() !== 'null') { return null; } if ($type === null) { return null; } if ($type instanceof NullableType || $type instanceof IntersectionType) { return null; } if (!$this->phpVersion->deprecatesImplicitlyNullableParameterTypes()) { return null; } if ($type instanceof Identifier && strtolower($type->name) === 'mixed') { return null; } if ($type instanceof Name && $type->toLowerString() === 'mixed') { return null; } if ($type instanceof Identifier && strtolower($type->name) === 'null') { return null; } if ($type instanceof Name && $type->toLowerString() === 'null') { return null; } if ($type instanceof UnionType) { foreach ($type->types as $innerType) { if ($innerType instanceof Identifier && strtolower($innerType->name) === 'null') { return null; } if ($innerType instanceof Name && $innerType->toLowerString() === 'null') { return null; } } } return \PHPStan\Rules\RuleErrorBuilder::message(sprintf('Deprecated in PHP 8.4: Parameter #%d $%s (%s) is implicitly nullable via default value null.', $order, $name, NodeTypePrinter::printType($type)))->line($line)->identifier('parameter.implicitlyNullable')->build(); } } <?php declare (strict_types=1); namespace PHPStan\Rules; use Generator; use PhpParser\Node; use PhpParser\Node\Expr; use PHPStan\Analyser\Scope; use PHPStan\Type\ErrorType; use PHPStan\Type\NeverType; use PHPStan\Type\Type; use PHPStan\Type\TypeUtils; use PHPStan\Type\VerbosityLevel; use function sprintf; final class FunctionReturnTypeCheck { /** * @var RuleLevelHelper */ private $ruleLevelHelper; public function __construct(\PHPStan\Rules\RuleLevelHelper $ruleLevelHelper) { $this->ruleLevelHelper = $ruleLevelHelper; } /** * @return list<IdentifierRuleError> */ public function checkReturnType(Scope $scope, Type $returnType, ?Expr $returnValue, Node $returnNode, string $emptyReturnStatementMessage, string $voidMessage, string $typeMismatchMessage, string $neverMessage, bool $isGenerator) : array { $returnType = TypeUtils::resolveLateResolvableTypes($returnType); if ($returnType instanceof NeverType && $returnType->isExplicit()) { return [\PHPStan\Rules\RuleErrorBuilder::message($neverMessage)->line($returnNode->getStartLine())->identifier('return.never')->build()]; } if ($isGenerator) { $returnType = $returnType->getTemplateType(Generator::class, 'TReturn'); if ($returnType instanceof ErrorType) { return []; } } $isVoidSuperType = $returnType->isVoid(); $verbosityLevel = VerbosityLevel::getRecommendedLevelByType($returnType, null); if ($returnValue === null) { if (!$isVoidSuperType->no()) { return []; } return [\PHPStan\Rules\RuleErrorBuilder::message(sprintf($emptyReturnStatementMessage, $returnType->describe($verbosityLevel)))->line($returnNode->getStartLine())->identifier('return.empty')->build()]; } if ($returnNode instanceof Expr\Yield_ || $returnNode instanceof Expr\YieldFrom) { return []; } $returnValueType = $scope->getType($returnValue); $verbosityLevel = VerbosityLevel::getRecommendedLevelByType($returnType, $returnValueType); if ($isVoidSuperType->yes()) { return [\PHPStan\Rules\RuleErrorBuilder::message(sprintf($voidMessage, $returnValueType->describe($verbosityLevel)))->line($returnNode->getStartLine())->identifier('return.void')->build()]; } $accepts = $this->ruleLevelHelper->acceptsWithReason($returnType, $returnValueType, $scope->isDeclareStrictTypes()); if (!$accepts->result) { return [\PHPStan\Rules\RuleErrorBuilder::message(sprintf($typeMismatchMessage, $returnType->describe($verbosityLevel), $returnValueType->describe($verbosityLevel)))->line($returnNode->getStartLine())->identifier('return.type')->acceptsReasonsTip($accepts->reasons)->build()]; } return []; } } <?php declare (strict_types=1); namespace PHPStan\Rules; use PHPStan\Analyser\Error; use PHPStan\ShouldNotHappenException; use function array_map; use function class_exists; use function count; use function implode; use function is_file; use function sprintf; /** * @api * @final * @template-covariant T of RuleError */ class RuleErrorBuilder { private const TYPE_MESSAGE = 1; private const TYPE_LINE = 2; private const TYPE_FILE = 4; private const TYPE_TIP = 8; private const TYPE_IDENTIFIER = 16; private const TYPE_METADATA = 32; private const TYPE_NON_IGNORABLE = 64; /** * @var int */ private $type; /** @var mixed[] */ private $properties; /** @var list<string> */ private $tips = []; private function __construct(string $message) { $this->properties['message'] = $message; $this->type = self::TYPE_MESSAGE; } /** * @return array<int, array{string, array<array{string|null, string|null, string|null}>}> */ public static function getRuleErrorTypes() : array { return [self::TYPE_MESSAGE => [\PHPStan\Rules\RuleError::class, [['message', 'string', 'string']]], self::TYPE_LINE => [\PHPStan\Rules\LineRuleError::class, [['line', 'int', 'int']]], self::TYPE_FILE => [\PHPStan\Rules\FileRuleError::class, [['file', 'string', 'string'], ['fileDescription', 'string', 'string']]], self::TYPE_TIP => [\PHPStan\Rules\TipRuleError::class, [['tip', 'string', 'string']]], self::TYPE_IDENTIFIER => [\PHPStan\Rules\IdentifierRuleError::class, [['identifier', 'string', 'string']]], self::TYPE_METADATA => [\PHPStan\Rules\MetadataRuleError::class, [['metadata', 'array', 'mixed[]']]], self::TYPE_NON_IGNORABLE => [\PHPStan\Rules\NonIgnorableRuleError::class, []]]; } /** * @return self<RuleError> */ public static function message(string $message) : self { return new self($message); } /** * @phpstan-this-out self<T&LineRuleError> * @return self<T&LineRuleError> */ public function line(int $line) : self { $this->properties['line'] = $line; $this->type |= self::TYPE_LINE; return $this; } /** * @phpstan-this-out self<T&FileRuleError> * @return self<T&FileRuleError> */ public function file(string $file, ?string $fileDescription = null) : self { if (!is_file($file)) { throw new ShouldNotHappenException(sprintf('File %s does not exist.', $file)); } $this->properties['file'] = $file; $this->properties['fileDescription'] = $fileDescription ?? $file; $this->type |= self::TYPE_FILE; return $this; } /** * @phpstan-this-out self<T&TipRuleError> * @return self<T&TipRuleError> */ public function tip(string $tip) : self { $this->tips = [$tip]; $this->type |= self::TYPE_TIP; return $this; } /** * @phpstan-this-out self<T&TipRuleError> * @return self<T&TipRuleError> */ public function addTip(string $tip) : self { $this->tips[] = $tip; $this->type |= self::TYPE_TIP; return $this; } /** * @phpstan-this-out self<T&TipRuleError> * @return self<T&TipRuleError> */ public function discoveringSymbolsTip() : self { return $this->tip('Learn more at https://phpstan.org/user-guide/discovering-symbols'); } /** * @param list<string> $reasons * @phpstan-this-out self<T&TipRuleError> * @return self<T&TipRuleError> */ public function acceptsReasonsTip(array $reasons) : self { foreach ($reasons as $reason) { $this->addTip($reason); } return $this; } /** * @phpstan-this-out self<T&TipRuleError> * @return self<T&TipRuleError> */ public function treatPhpDocTypesAsCertainTip() : self { return $this->tip('Because the type is coming from a PHPDoc, you can turn off this check by setting <fg=cyan>treatPhpDocTypesAsCertain: false</> in your <fg=cyan>%configurationFile%</>.'); } /** * Sets an error identifier. * * List of all current error identifiers in PHPStan: https://phpstan.org/error-identifiers * * @phpstan-this-out self<T&IdentifierRuleError> * @return self<T&IdentifierRuleError> */ public function identifier(string $identifier) : self { if (!Error::validateIdentifier($identifier)) { throw new ShouldNotHappenException(sprintf('Invalid identifier: %s, error identifiers must match /%s/', $identifier, Error::PATTERN_IDENTIFIER)); } $this->properties['identifier'] = $identifier; $this->type |= self::TYPE_IDENTIFIER; return $this; } /** * @param mixed[] $metadata * @phpstan-this-out self<T&MetadataRuleError> * @return self<T&MetadataRuleError> */ public function metadata(array $metadata) : self { $this->properties['metadata'] = $metadata; $this->type |= self::TYPE_METADATA; return $this; } /** * @phpstan-this-out self<T&NonIgnorableRuleError> * @return self<T&NonIgnorableRuleError> */ public function nonIgnorable() : self { $this->type |= self::TYPE_NON_IGNORABLE; return $this; } /** * @return T */ public function build() : \PHPStan\Rules\RuleError { /** @var class-string<T> $className */ $className = sprintf('PHPStan\\Rules\\RuleErrors\\RuleError%d', $this->type); if (!class_exists($className)) { throw new ShouldNotHappenException(sprintf('Class %s does not exist.', $className)); } $ruleError = new $className(); foreach ($this->properties as $propertyName => $value) { $ruleError->{$propertyName} = $value; } if (count($this->tips) > 0) { if (count($this->tips) === 1) { $ruleError->tip = $this->tips[0]; } else { $ruleError->tip = implode("\n", array_map(static function (string $tip) { return sprintf('• %s', $tip); }, $this->tips)); } } return $ruleError; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Comparison; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\Constant\ConstantBooleanType; use function sprintf; /** * @implements Rule<Node\Expr\Ternary> */ final class TernaryOperatorConstantConditionRule implements Rule { /** * @var ConstantConditionRuleHelper */ private $helper; /** * @var bool */ private $treatPhpDocTypesAsCertain; /** * @var bool */ private $treatPhpDocTypesAsCertainTip; public function __construct(\PHPStan\Rules\Comparison\ConstantConditionRuleHelper $helper, bool $treatPhpDocTypesAsCertain, bool $treatPhpDocTypesAsCertainTip) { $this->helper = $helper; $this->treatPhpDocTypesAsCertain = $treatPhpDocTypesAsCertain; $this->treatPhpDocTypesAsCertainTip = $treatPhpDocTypesAsCertainTip; } public function getNodeType() : string { return Node\Expr\Ternary::class; } public function processNode(Node $node, Scope $scope) : array { $exprType = $this->helper->getBooleanType($scope, $node->cond); if ($exprType instanceof ConstantBooleanType) { $addTip = function (RuleErrorBuilder $ruleErrorBuilder) use($scope, $node) : RuleErrorBuilder { if (!$this->treatPhpDocTypesAsCertain) { return $ruleErrorBuilder; } $booleanNativeType = $this->helper->getNativeBooleanType($scope, $node->cond); if ($booleanNativeType instanceof ConstantBooleanType) { return $ruleErrorBuilder; } if (!$this->treatPhpDocTypesAsCertainTip) { return $ruleErrorBuilder; } return $ruleErrorBuilder->treatPhpDocTypesAsCertainTip(); }; return [$addTip(RuleErrorBuilder::message(sprintf('Ternary operator condition is always %s.', $exprType->getValue() ? 'true' : 'false')))->identifier(sprintf('ternary.always%s', $exprType->getValue() ? 'True' : 'False'))->build()]; } return []; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Comparison; use PhpParser\Node; use PhpParser\Node\Scalar\LNumber; use PhpParser\Node\Stmt\Break_; use PhpParser\Node\Stmt\Continue_; use PHPStan\Analyser\Scope; use PHPStan\Node\BreaklessWhileLoopNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\Constant\ConstantBooleanType; /** * @implements Rule<BreaklessWhileLoopNode> */ final class WhileLoopAlwaysTrueConditionRule implements Rule { /** * @var ConstantConditionRuleHelper */ private $helper; /** * @var bool */ private $treatPhpDocTypesAsCertain; /** * @var bool */ private $treatPhpDocTypesAsCertainTip; public function __construct(\PHPStan\Rules\Comparison\ConstantConditionRuleHelper $helper, bool $treatPhpDocTypesAsCertain, bool $treatPhpDocTypesAsCertainTip) { $this->helper = $helper; $this->treatPhpDocTypesAsCertain = $treatPhpDocTypesAsCertain; $this->treatPhpDocTypesAsCertainTip = $treatPhpDocTypesAsCertainTip; } public function getNodeType() : string { return BreaklessWhileLoopNode::class; } public function processNode(Node $node, Scope $scope) : array { foreach ($node->getExitPoints() as $exitPoint) { $statement = $exitPoint->getStatement(); if ($statement instanceof Break_) { return []; } if (!$statement instanceof Continue_) { return []; } if ($statement->num === null) { continue; } if (!$statement->num instanceof LNumber) { continue; } $value = $statement->num->value; if ($value === 1) { continue; } if ($value > 1) { return []; } } $originalNode = $node->getOriginalNode(); $exprType = $this->helper->getBooleanType($scope, $originalNode->cond); if ($exprType->isTrue()->yes()) { $addTip = function (RuleErrorBuilder $ruleErrorBuilder) use($scope, $originalNode) : RuleErrorBuilder { if (!$this->treatPhpDocTypesAsCertain) { return $ruleErrorBuilder; } $booleanNativeType = $this->helper->getNativeBooleanType($scope, $originalNode->cond); if ($booleanNativeType instanceof ConstantBooleanType) { return $ruleErrorBuilder; } if (!$this->treatPhpDocTypesAsCertainTip) { return $ruleErrorBuilder; } return $ruleErrorBuilder->treatPhpDocTypesAsCertainTip(); }; return [$addTip(RuleErrorBuilder::message('While loop condition is always true.'))->line($originalNode->cond->getStartLine())->identifier('while.alwaysTrue')->build()]; } return []; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Comparison; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Parser\LastConditionVisitor; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\VerbosityLevel; use function sprintf; /** * @implements Rule<Node\Expr\BinaryOp> */ final class ConstantLooseComparisonRule implements Rule { /** * @var bool */ private $checkAlwaysTrueLooseComparison; /** * @var bool */ private $treatPhpDocTypesAsCertain; /** * @var bool */ private $reportAlwaysTrueInLastCondition; /** * @var bool */ private $treatPhpDocTypesAsCertainTip; public function __construct(bool $checkAlwaysTrueLooseComparison, bool $treatPhpDocTypesAsCertain, bool $reportAlwaysTrueInLastCondition, bool $treatPhpDocTypesAsCertainTip) { $this->checkAlwaysTrueLooseComparison = $checkAlwaysTrueLooseComparison; $this->treatPhpDocTypesAsCertain = $treatPhpDocTypesAsCertain; $this->reportAlwaysTrueInLastCondition = $reportAlwaysTrueInLastCondition; $this->treatPhpDocTypesAsCertainTip = $treatPhpDocTypesAsCertainTip; } public function getNodeType() : string { return Node\Expr\BinaryOp::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node instanceof Node\Expr\BinaryOp\Equal && !$node instanceof Node\Expr\BinaryOp\NotEqual) { return []; } $nodeType = $this->treatPhpDocTypesAsCertain ? $scope->getType($node) : $scope->getNativeType($node); if (!$nodeType instanceof ConstantBooleanType) { return []; } $addTip = function (RuleErrorBuilder $ruleErrorBuilder) use($scope, $node) : RuleErrorBuilder { if (!$this->treatPhpDocTypesAsCertain) { return $ruleErrorBuilder; } $instanceofTypeWithoutPhpDocs = $scope->getNativeType($node); if ($instanceofTypeWithoutPhpDocs instanceof ConstantBooleanType) { return $ruleErrorBuilder; } if (!$this->treatPhpDocTypesAsCertainTip) { return $ruleErrorBuilder; } return $ruleErrorBuilder->treatPhpDocTypesAsCertainTip(); }; if (!$nodeType->getValue()) { return [$addTip(RuleErrorBuilder::message(sprintf('Loose comparison using %s between %s and %s will always evaluate to false.', $node->getOperatorSigil(), $scope->getType($node->left)->describe(VerbosityLevel::value()), $scope->getType($node->right)->describe(VerbosityLevel::value()))))->identifier(sprintf('%s.alwaysFalse', $node instanceof Node\Expr\BinaryOp\Equal ? 'equal' : 'notEqual'))->build()]; } elseif ($this->checkAlwaysTrueLooseComparison) { $isLast = $node->getAttribute(LastConditionVisitor::ATTRIBUTE_NAME); if ($isLast === \true && !$this->reportAlwaysTrueInLastCondition) { return []; } $errorBuilder = $addTip(RuleErrorBuilder::message(sprintf('Loose comparison using %s between %s and %s will always evaluate to true.', $node->getOperatorSigil(), $scope->getType($node->left)->describe(VerbosityLevel::value()), $scope->getType($node->right)->describe(VerbosityLevel::value())))); if ($isLast === \false && !$this->reportAlwaysTrueInLastCondition) { $errorBuilder->tip('Remove remaining cases below this one and this error will disappear too.'); } $errorBuilder->identifier(sprintf('%s.alwaysTrue', $node instanceof Node\Expr\BinaryOp\Equal ? 'equal' : 'notEqual')); return [$errorBuilder->build()]; } return []; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Comparison; use PhpParser\Node; use PhpParser\Node\Expr; use PHPStan\Analyser\Scope; use PHPStan\Parser\LastConditionVisitor; use PHPStan\Reflection\MethodReflection; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\ShouldNotHappenException; use function sprintf; /** * @implements Rule<Node\Expr\StaticCall> */ final class ImpossibleCheckTypeStaticMethodCallRule implements Rule { /** * @var ImpossibleCheckTypeHelper */ private $impossibleCheckTypeHelper; /** * @var bool */ private $checkAlwaysTrueCheckTypeFunctionCall; /** * @var bool */ private $treatPhpDocTypesAsCertain; /** * @var bool */ private $reportAlwaysTrueInLastCondition; /** * @var bool */ private $treatPhpDocTypesAsCertainTip; public function __construct(\PHPStan\Rules\Comparison\ImpossibleCheckTypeHelper $impossibleCheckTypeHelper, bool $checkAlwaysTrueCheckTypeFunctionCall, bool $treatPhpDocTypesAsCertain, bool $reportAlwaysTrueInLastCondition, bool $treatPhpDocTypesAsCertainTip) { $this->impossibleCheckTypeHelper = $impossibleCheckTypeHelper; $this->checkAlwaysTrueCheckTypeFunctionCall = $checkAlwaysTrueCheckTypeFunctionCall; $this->treatPhpDocTypesAsCertain = $treatPhpDocTypesAsCertain; $this->reportAlwaysTrueInLastCondition = $reportAlwaysTrueInLastCondition; $this->treatPhpDocTypesAsCertainTip = $treatPhpDocTypesAsCertainTip; } public function getNodeType() : string { return Node\Expr\StaticCall::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->name instanceof Node\Identifier) { return []; } $isAlways = $this->impossibleCheckTypeHelper->findSpecifiedType($scope, $node); if ($isAlways === null) { return []; } $addTip = function (RuleErrorBuilder $ruleErrorBuilder) use($scope, $node) : RuleErrorBuilder { if (!$this->treatPhpDocTypesAsCertain) { return $ruleErrorBuilder; } $isAlways = $this->impossibleCheckTypeHelper->doNotTreatPhpDocTypesAsCertain()->findSpecifiedType($scope, $node); if ($isAlways !== null) { return $ruleErrorBuilder; } if (!$this->treatPhpDocTypesAsCertainTip) { return $ruleErrorBuilder; } return $ruleErrorBuilder->treatPhpDocTypesAsCertainTip(); }; if (!$isAlways) { $method = $this->getMethod($node->class, $node->name->name, $scope); return [$addTip(RuleErrorBuilder::message(sprintf('Call to static method %s::%s()%s will always evaluate to false.', $method->getDeclaringClass()->getDisplayName(), $method->getName(), $this->impossibleCheckTypeHelper->getArgumentsDescription($scope, $node->getArgs()))))->identifier('staticMethod.impossibleType')->build()]; } elseif ($this->checkAlwaysTrueCheckTypeFunctionCall) { $isLast = $node->getAttribute(LastConditionVisitor::ATTRIBUTE_NAME); if ($isLast === \true && !$this->reportAlwaysTrueInLastCondition) { return []; } $method = $this->getMethod($node->class, $node->name->name, $scope); $errorBuilder = $addTip(RuleErrorBuilder::message(sprintf('Call to static method %s::%s()%s will always evaluate to true.', $method->getDeclaringClass()->getDisplayName(), $method->getName(), $this->impossibleCheckTypeHelper->getArgumentsDescription($scope, $node->getArgs())))); if ($isLast === \false && !$this->reportAlwaysTrueInLastCondition) { $errorBuilder->tip('Remove remaining cases below this one and this error will disappear too.'); } $errorBuilder->identifier('staticMethod.alreadyNarrowedType'); return [$errorBuilder->build()]; } return []; } /** * @param Node\Name|Expr $class * @throws ShouldNotHappenException */ private function getMethod($class, string $methodName, Scope $scope) : MethodReflection { if ($class instanceof Node\Name) { $calledOnType = $scope->resolveTypeByName($class); } else { $calledOnType = $scope->getType($class); } $method = $scope->getMethodReflection($calledOnType, $methodName); if ($method === null) { throw new ShouldNotHappenException(); } return $method; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Comparison; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\BooleanOrNode; use PHPStan\Parser\LastConditionVisitor; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\Constant\ConstantBooleanType; use function count; use function sprintf; /** * @implements Rule<BooleanOrNode> */ final class BooleanOrConstantConditionRule implements Rule { /** * @var ConstantConditionRuleHelper */ private $helper; /** * @var bool */ private $treatPhpDocTypesAsCertain; /** * @var bool */ private $bleedingEdge; /** * @var bool */ private $reportAlwaysTrueInLastCondition; /** * @var bool */ private $treatPhpDocTypesAsCertainTip; public function __construct(\PHPStan\Rules\Comparison\ConstantConditionRuleHelper $helper, bool $treatPhpDocTypesAsCertain, bool $bleedingEdge, bool $reportAlwaysTrueInLastCondition, bool $treatPhpDocTypesAsCertainTip) { $this->helper = $helper; $this->treatPhpDocTypesAsCertain = $treatPhpDocTypesAsCertain; $this->bleedingEdge = $bleedingEdge; $this->reportAlwaysTrueInLastCondition = $reportAlwaysTrueInLastCondition; $this->treatPhpDocTypesAsCertainTip = $treatPhpDocTypesAsCertainTip; } public function getNodeType() : string { return BooleanOrNode::class; } public function processNode(Node $node, Scope $scope) : array { $originalNode = $node->getOriginalNode(); $nodeText = $this->bleedingEdge ? $originalNode->getOperatorSigil() : '||'; $messages = []; $leftType = $this->helper->getBooleanType($scope, $originalNode->left); $identifierType = $originalNode instanceof Node\Expr\BinaryOp\BooleanOr ? 'booleanOr' : 'logicalOr'; if ($leftType instanceof ConstantBooleanType) { $addTipLeft = function (RuleErrorBuilder $ruleErrorBuilder) use($scope, $originalNode) : RuleErrorBuilder { if (!$this->treatPhpDocTypesAsCertain) { return $ruleErrorBuilder; } $booleanNativeType = $this->helper->getNativeBooleanType($scope, $originalNode->left); if ($booleanNativeType instanceof ConstantBooleanType) { return $ruleErrorBuilder; } if (!$this->treatPhpDocTypesAsCertainTip) { return $ruleErrorBuilder; } return $ruleErrorBuilder->treatPhpDocTypesAsCertainTip(); }; $isLast = $node->getAttribute(LastConditionVisitor::ATTRIBUTE_NAME); if (!$leftType->getValue() || $isLast !== \true || $this->reportAlwaysTrueInLastCondition) { $errorBuilder = $addTipLeft(RuleErrorBuilder::message(sprintf('Left side of %s is always %s.', $nodeText, $leftType->getValue() ? 'true' : 'false')))->identifier(sprintf('%s.leftAlways%s', $identifierType, $leftType->getValue() ? 'True' : 'False'))->line($originalNode->left->getStartLine()); if ($leftType->getValue() && $isLast === \false && !$this->reportAlwaysTrueInLastCondition) { $errorBuilder->tip('Remove remaining cases below this one and this error will disappear too.'); } $messages[] = $errorBuilder->build(); } } $rightScope = $node->getRightScope(); $rightType = $this->helper->getBooleanType($rightScope, $originalNode->right); if ($rightType instanceof ConstantBooleanType && !$scope->isInFirstLevelStatement()) { $addTipRight = function (RuleErrorBuilder $ruleErrorBuilder) use($rightScope, $originalNode) : RuleErrorBuilder { if (!$this->treatPhpDocTypesAsCertain) { return $ruleErrorBuilder; } $booleanNativeType = $this->helper->getNativeBooleanType($rightScope, $originalNode->right); if ($booleanNativeType instanceof ConstantBooleanType) { return $ruleErrorBuilder; } if (!$this->treatPhpDocTypesAsCertainTip) { return $ruleErrorBuilder; } return $ruleErrorBuilder->treatPhpDocTypesAsCertainTip(); }; $isLast = $node->getAttribute(LastConditionVisitor::ATTRIBUTE_NAME); if (!$rightType->getValue() || $isLast !== \true || $this->reportAlwaysTrueInLastCondition) { $errorBuilder = $addTipRight(RuleErrorBuilder::message(sprintf('Right side of %s is always %s.', $nodeText, $rightType->getValue() ? 'true' : 'false')))->identifier(sprintf('%s.rightAlways%s', $identifierType, $rightType->getValue() ? 'True' : 'False'))->line($originalNode->right->getStartLine()); if ($rightType->getValue() && $isLast === \false && !$this->reportAlwaysTrueInLastCondition) { $errorBuilder->tip('Remove remaining cases below this one and this error will disappear too.'); } $messages[] = $errorBuilder->build(); } } if (count($messages) === 0 && !$scope->isInFirstLevelStatement()) { $nodeType = $this->treatPhpDocTypesAsCertain ? $scope->getType($originalNode) : $scope->getNativeType($originalNode); if ($nodeType instanceof ConstantBooleanType) { $addTip = function (RuleErrorBuilder $ruleErrorBuilder) use($scope, $originalNode) : RuleErrorBuilder { if (!$this->treatPhpDocTypesAsCertain) { return $ruleErrorBuilder; } $booleanNativeType = $scope->getNativeType($originalNode); if ($booleanNativeType instanceof ConstantBooleanType) { return $ruleErrorBuilder; } if (!$this->treatPhpDocTypesAsCertainTip) { return $ruleErrorBuilder; } return $ruleErrorBuilder->treatPhpDocTypesAsCertainTip(); }; $isLast = $node->getAttribute(LastConditionVisitor::ATTRIBUTE_NAME); if (!$nodeType->getValue() || $isLast !== \true || $this->reportAlwaysTrueInLastCondition) { $errorBuilder = $addTip(RuleErrorBuilder::message(sprintf('Result of %s is always %s.', $nodeText, $nodeType->getValue() ? 'true' : 'false'))); if ($nodeType->getValue() && $isLast === \false && !$this->reportAlwaysTrueInLastCondition) { $errorBuilder->tip('Remove remaining cases below this one and this error will disappear too.'); } $errorBuilder->identifier(sprintf('%s.always%s', $identifierType, $nodeType->getValue() ? 'True' : 'False')); $messages[] = $errorBuilder->build(); } } } return $messages; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Comparison; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\Constant\ConstantBooleanType; use function sprintf; /** * @implements Rule<Node\Stmt\If_> */ final class IfConstantConditionRule implements Rule { /** * @var ConstantConditionRuleHelper */ private $helper; /** * @var bool */ private $treatPhpDocTypesAsCertain; /** * @var bool */ private $treatPhpDocTypesAsCertainTip; public function __construct(\PHPStan\Rules\Comparison\ConstantConditionRuleHelper $helper, bool $treatPhpDocTypesAsCertain, bool $treatPhpDocTypesAsCertainTip) { $this->helper = $helper; $this->treatPhpDocTypesAsCertain = $treatPhpDocTypesAsCertain; $this->treatPhpDocTypesAsCertainTip = $treatPhpDocTypesAsCertainTip; } public function getNodeType() : string { return Node\Stmt\If_::class; } public function processNode(Node $node, Scope $scope) : array { $exprType = $this->helper->getBooleanType($scope, $node->cond); if ($exprType instanceof ConstantBooleanType) { $addTip = function (RuleErrorBuilder $ruleErrorBuilder) use($scope, $node) : RuleErrorBuilder { if (!$this->treatPhpDocTypesAsCertain) { return $ruleErrorBuilder; } $booleanNativeType = $this->helper->getNativeBooleanType($scope, $node->cond); if ($booleanNativeType instanceof ConstantBooleanType) { return $ruleErrorBuilder; } if (!$this->treatPhpDocTypesAsCertainTip) { return $ruleErrorBuilder; } return $ruleErrorBuilder->treatPhpDocTypesAsCertainTip(); }; return [$addTip(RuleErrorBuilder::message(sprintf('If condition is always %s.', $exprType->getValue() ? 'true' : 'false')))->identifier(sprintf('if.always%s', $exprType->getValue() ? 'True' : 'False'))->line($node->cond->getStartLine())->build()]; } return []; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Comparison; use PhpParser\Node; use PHPStan\Analyser\RicherScopeGetTypeHelper; use PHPStan\Analyser\Scope; use PHPStan\Parser\LastConditionVisitor; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\TrinaryLogic; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\VerbosityLevel; use function count; use function sprintf; /** * @implements Rule<Node\Expr\BinaryOp> */ final class StrictComparisonOfDifferentTypesRule implements Rule { /** * @var RicherScopeGetTypeHelper */ private $richerScopeGetTypeHelper; /** * @var bool */ private $checkAlwaysTrueStrictComparison; /** * @var bool */ private $treatPhpDocTypesAsCertain; /** * @var bool */ private $reportAlwaysTrueInLastCondition; /** * @var bool */ private $treatPhpDocTypesAsCertainTip; public function __construct(RicherScopeGetTypeHelper $richerScopeGetTypeHelper, bool $checkAlwaysTrueStrictComparison, bool $treatPhpDocTypesAsCertain, bool $reportAlwaysTrueInLastCondition, bool $treatPhpDocTypesAsCertainTip) { $this->richerScopeGetTypeHelper = $richerScopeGetTypeHelper; $this->checkAlwaysTrueStrictComparison = $checkAlwaysTrueStrictComparison; $this->treatPhpDocTypesAsCertain = $treatPhpDocTypesAsCertain; $this->reportAlwaysTrueInLastCondition = $reportAlwaysTrueInLastCondition; $this->treatPhpDocTypesAsCertainTip = $treatPhpDocTypesAsCertainTip; } public function getNodeType() : string { return Node\Expr\BinaryOp::class; } public function processNode(Node $node, Scope $scope) : array { if ($node instanceof Node\Expr\BinaryOp\Identical) { $nodeTypeResult = $this->richerScopeGetTypeHelper->getIdenticalResult($this->treatPhpDocTypesAsCertain ? $scope : $scope->doNotTreatPhpDocTypesAsCertain(), $node); } elseif ($node instanceof Node\Expr\BinaryOp\NotIdentical) { $nodeTypeResult = $this->richerScopeGetTypeHelper->getNotIdenticalResult($this->treatPhpDocTypesAsCertain ? $scope : $scope->doNotTreatPhpDocTypesAsCertain(), $node); } else { return []; } $nodeType = $nodeTypeResult->type; if (!$nodeType instanceof ConstantBooleanType) { return []; } $leftType = $this->treatPhpDocTypesAsCertain ? $scope->getType($node->left) : $scope->getNativeType($node->left); $rightType = $this->treatPhpDocTypesAsCertain ? $scope->getType($node->right) : $scope->getNativeType($node->right); $addTip = function (RuleErrorBuilder $ruleErrorBuilder) use($scope, $node, $nodeTypeResult) : RuleErrorBuilder { $reasons = $nodeTypeResult->reasons; if (count($reasons) > 0) { return $ruleErrorBuilder->acceptsReasonsTip($reasons); } if (!$this->treatPhpDocTypesAsCertain) { return $ruleErrorBuilder; } $instanceofTypeWithoutPhpDocs = $scope->getNativeType($node); if ($instanceofTypeWithoutPhpDocs instanceof ConstantBooleanType) { return $ruleErrorBuilder; } if (!$this->treatPhpDocTypesAsCertainTip) { return $ruleErrorBuilder; } return $ruleErrorBuilder->treatPhpDocTypesAsCertainTip(); }; $verbosity = VerbosityLevel::value(); if ($leftType->isConstantScalarValue()->yes() && !$leftType->isString()->no() && !$rightType->isConstantScalarValue()->yes() && !$rightType->isString()->no() && (TrinaryLogic::extremeIdentity($leftType->isLowercaseString(), $rightType->isLowercaseString())->maybe() || TrinaryLogic::extremeIdentity($leftType->isUppercaseString(), $rightType->isUppercaseString())->maybe()) || $rightType->isConstantScalarValue()->yes() && !$rightType->isString()->no() && !$leftType->isConstantScalarValue()->yes() && !$leftType->isString()->no() && (TrinaryLogic::extremeIdentity($leftType->isLowercaseString(), $rightType->isLowercaseString())->maybe() || TrinaryLogic::extremeIdentity($leftType->isUppercaseString(), $rightType->isUppercaseString())->maybe())) { $verbosity = VerbosityLevel::precise(); } if (!$nodeType->getValue()) { return [$addTip(RuleErrorBuilder::message(sprintf('Strict comparison using %s between %s and %s will always evaluate to false.', $node->getOperatorSigil(), $leftType->describe($verbosity), $rightType->describe($verbosity))))->identifier(sprintf('%s.alwaysFalse', $node instanceof Node\Expr\BinaryOp\Identical ? 'identical' : 'notIdentical'))->build()]; } elseif ($this->checkAlwaysTrueStrictComparison) { $isLast = $node->getAttribute(LastConditionVisitor::ATTRIBUTE_NAME); if ($isLast === \true && !$this->reportAlwaysTrueInLastCondition) { return []; } $errorBuilder = $addTip(RuleErrorBuilder::message(sprintf('Strict comparison using %s between %s and %s will always evaluate to true.', $node->getOperatorSigil(), $leftType->describe($verbosity), $rightType->describe($verbosity)))); if ($isLast === \false && !$this->reportAlwaysTrueInLastCondition) { $errorBuilder->addTip('Remove remaining cases below this one and this error will disappear too.'); } if ($leftType->isEnum()->yes() && $rightType->isEnum()->yes() && $node->getAttribute(LastConditionVisitor::ATTRIBUTE_IS_MATCH_NAME, \false) !== \true) { $errorBuilder->addTip('Use match expression instead. PHPStan will report unhandled enum cases.'); } $errorBuilder->identifier(sprintf('%s.alwaysTrue', $node instanceof Node\Expr\BinaryOp\Identical ? 'identical' : 'notIdentical')); return [$errorBuilder->build()]; } return []; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Comparison; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\Constant\ConstantBooleanType; /** * @implements Rule<Node\Stmt\If_> */ final class UnreachableIfBranchesRule implements Rule { /** * @var ConstantConditionRuleHelper */ private $helper; /** * @var bool */ private $treatPhpDocTypesAsCertain; /** * @var bool */ private $disable; /** * @var bool */ private $treatPhpDocTypesAsCertainTip; public function __construct(\PHPStan\Rules\Comparison\ConstantConditionRuleHelper $helper, bool $treatPhpDocTypesAsCertain, bool $disable, bool $treatPhpDocTypesAsCertainTip) { $this->helper = $helper; $this->treatPhpDocTypesAsCertain = $treatPhpDocTypesAsCertain; $this->disable = $disable; $this->treatPhpDocTypesAsCertainTip = $treatPhpDocTypesAsCertainTip; } public function getNodeType() : string { return Node\Stmt\If_::class; } public function processNode(Node $node, Scope $scope) : array { if ($this->disable) { return []; } $errors = []; $condition = $node->cond; $conditionType = $this->treatPhpDocTypesAsCertain ? $scope->getType($condition) : $scope->getNativeType($condition); $conditionBooleanType = $conditionType->toBoolean(); $nextBranchIsDead = $conditionBooleanType->isTrue()->yes() && $this->helper->shouldSkip($scope, $node->cond) && !$this->helper->shouldReportAlwaysTrueByDefault($node->cond); $addTip = function (RuleErrorBuilder $ruleErrorBuilder) use($scope, &$condition) : RuleErrorBuilder { if (!$this->treatPhpDocTypesAsCertain) { return $ruleErrorBuilder; } $booleanNativeType = $scope->getNativeType($condition)->toBoolean(); if ($booleanNativeType instanceof ConstantBooleanType) { return $ruleErrorBuilder; } if (!$this->treatPhpDocTypesAsCertainTip) { return $ruleErrorBuilder; } return $ruleErrorBuilder->treatPhpDocTypesAsCertainTip(); }; foreach ($node->elseifs as $elseif) { if ($nextBranchIsDead) { $errors[] = $addTip(RuleErrorBuilder::message('Elseif branch is unreachable because previous condition is always true.'))->identifier('elseif.unreachable')->line($elseif->getStartLine())->build(); continue; } $condition = $elseif->cond; $conditionType = $this->treatPhpDocTypesAsCertain ? $scope->getType($condition) : $scope->getNativeType($condition); $conditionBooleanType = $conditionType->toBoolean(); $nextBranchIsDead = $conditionBooleanType->isTrue()->yes() && $this->helper->shouldSkip($scope, $elseif->cond) && !$this->helper->shouldReportAlwaysTrueByDefault($elseif->cond); } if ($node->else !== null && $nextBranchIsDead) { $errors[] = $addTip(RuleErrorBuilder::message('Else branch is unreachable because previous condition is always true.'))->identifier('else.unreachable')->line($node->else->getStartLine())->build(); } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Comparison; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; /** * @implements Rule<Node\Expr\Match_> */ final class UsageOfVoidMatchExpressionRule implements Rule { public function getNodeType() : string { return Node\Expr\Match_::class; } public function processNode(Node $node, Scope $scope) : array { if (!$scope->isInFirstLevelStatement()) { $matchResultType = $scope->getKeepVoidType($node); if ($matchResultType->isVoid()->yes()) { return [RuleErrorBuilder::message('Result of match expression (void) is used.')->identifier('match.void')->build()]; } } return []; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Comparison; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\MatchExpressionNode; use PHPStan\Parser\TryCatchTypeVisitor; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\NeverType; use PHPStan\Type\ObjectType; use PHPStan\Type\TypeCombinator; use PHPStan\Type\UnionType; use PHPStan\Type\VerbosityLevel; use UnhandledMatchError; use function array_map; use function count; use function sprintf; /** * @implements Rule<MatchExpressionNode> */ final class MatchExpressionRule implements Rule { /** * @var ConstantConditionRuleHelper */ private $constantConditionRuleHelper; /** * @var bool */ private $checkAlwaysTrueStrictComparison; /** * @var bool */ private $disableUnreachable; /** * @var bool */ private $reportAlwaysTrueInLastCondition; /** * @var bool */ private $treatPhpDocTypesAsCertain; public function __construct(\PHPStan\Rules\Comparison\ConstantConditionRuleHelper $constantConditionRuleHelper, bool $checkAlwaysTrueStrictComparison, bool $disableUnreachable, bool $reportAlwaysTrueInLastCondition, bool $treatPhpDocTypesAsCertain) { $this->constantConditionRuleHelper = $constantConditionRuleHelper; $this->checkAlwaysTrueStrictComparison = $checkAlwaysTrueStrictComparison; $this->disableUnreachable = $disableUnreachable; $this->reportAlwaysTrueInLastCondition = $reportAlwaysTrueInLastCondition; $this->treatPhpDocTypesAsCertain = $treatPhpDocTypesAsCertain; } public function getNodeType() : string { return MatchExpressionNode::class; } public function processNode(Node $node, Scope $scope) : array { $matchCondition = $node->getCondition(); $matchConditionType = $scope->getType($matchCondition); $nextArmIsDeadForType = \false; $nextArmIsDeadForNativeType = \false; $errors = []; $armsCount = count($node->getArms()); $hasDefault = \false; foreach ($node->getArms() as $i => $arm) { if ($nextArmIsDeadForNativeType || $nextArmIsDeadForType && $this->treatPhpDocTypesAsCertain) { if (!$this->disableUnreachable) { $errors[] = RuleErrorBuilder::message('Match arm is unreachable because previous comparison is always true.')->identifier('match.unreachable')->line($arm->getLine())->build(); } continue; } $armConditions = $arm->getConditions(); if (count($armConditions) === 0) { $hasDefault = \true; } foreach ($armConditions as $armCondition) { $armConditionScope = $armCondition->getScope(); $armConditionExpr = new Node\Expr\BinaryOp\Identical($matchCondition, $armCondition->getCondition()); $armConditionResult = $armConditionScope->getType($armConditionExpr); if (!$armConditionResult instanceof ConstantBooleanType) { continue; } if ($armConditionResult->getValue()) { $nextArmIsDeadForType = \true; } if (!$this->treatPhpDocTypesAsCertain) { $armConditionNativeResult = $armConditionScope->getNativeType($armConditionExpr); if (!$armConditionNativeResult instanceof ConstantBooleanType) { continue; } if ($armConditionNativeResult->getValue()) { $nextArmIsDeadForNativeType = \true; } } if ($matchConditionType instanceof ConstantBooleanType) { $armConditionStandaloneResult = $this->constantConditionRuleHelper->getBooleanType($armConditionScope, $armCondition->getCondition()); if (!$armConditionStandaloneResult instanceof ConstantBooleanType) { continue; } } $armLine = $armCondition->getLine(); if (!$armConditionResult->getValue()) { $errors[] = RuleErrorBuilder::message(sprintf('Match arm comparison between %s and %s is always false.', $armConditionScope->getType($matchCondition)->describe(VerbosityLevel::value()), $armConditionScope->getType($armCondition->getCondition())->describe(VerbosityLevel::value())))->line($armLine)->identifier('match.alwaysFalse')->build(); } else { if ($this->checkAlwaysTrueStrictComparison) { if ($i === $armsCount - 1 && !$this->reportAlwaysTrueInLastCondition) { continue; } $errorBuilder = RuleErrorBuilder::message(sprintf('Match arm comparison between %s and %s is always true.', $armConditionScope->getType($matchCondition)->describe(VerbosityLevel::value()), $armConditionScope->getType($armCondition->getCondition())->describe(VerbosityLevel::value())))->line($armLine); if ($i !== $armsCount - 1 && !$this->reportAlwaysTrueInLastCondition) { $errorBuilder->tip('Remove remaining cases below this one and this error will disappear too.'); } $errorBuilder->identifier('match.alwaysTrue'); $errors[] = $errorBuilder->build(); } } } } if (!$hasDefault && !$nextArmIsDeadForType) { $remainingType = $node->getEndScope()->getType($matchCondition); $cases = $remainingType->getEnumCases(); $casesCount = count($cases); if ($casesCount > 1) { $remainingType = new UnionType($cases); } if ($casesCount === 1) { $remainingType = $cases[0]; } if (!$remainingType instanceof NeverType && !$this->isUnhandledMatchErrorCaught($node) && !$this->hasUnhandledMatchErrorThrowsTag($scope)) { $errors[] = RuleErrorBuilder::message(sprintf('Match expression does not handle remaining %s: %s', $remainingType instanceof UnionType ? 'values' : 'value', $remainingType->describe(VerbosityLevel::value())))->identifier('match.unhandled')->build(); } } return $errors; } private function isUnhandledMatchErrorCaught(Node $node) : bool { $tryCatchTypes = $node->getAttribute(TryCatchTypeVisitor::ATTRIBUTE_NAME); if ($tryCatchTypes === null) { return \false; } $tryCatchType = TypeCombinator::union(...array_map(static function (string $class) { return new ObjectType($class); }, $tryCatchTypes)); return $tryCatchType->isSuperTypeOf(new ObjectType(UnhandledMatchError::class))->yes(); } private function hasUnhandledMatchErrorThrowsTag(Scope $scope) : bool { $function = $scope->getFunction(); if ($function === null) { return \false; } $throwsType = $function->getThrowType(); if ($throwsType === null) { return \false; } return $throwsType->isSuperTypeOf(new ObjectType(UnhandledMatchError::class))->yes(); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Comparison; use PhpParser\Node; use PhpParser\Node\Expr\BinaryOp\LogicalXor; use PHPStan\Analyser\Scope; use PHPStan\Parser\LastConditionVisitor; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\Constant\ConstantBooleanType; use function sprintf; /** * @implements Rule<LogicalXor> */ final class LogicalXorConstantConditionRule implements Rule { /** * @var ConstantConditionRuleHelper */ private $helper; /** * @var bool */ private $treatPhpDocTypesAsCertain; /** * @var bool */ private $reportAlwaysTrueInLastCondition; /** * @var bool */ private $treatPhpDocTypesAsCertainTip; public function __construct(\PHPStan\Rules\Comparison\ConstantConditionRuleHelper $helper, bool $treatPhpDocTypesAsCertain, bool $reportAlwaysTrueInLastCondition, bool $treatPhpDocTypesAsCertainTip) { $this->helper = $helper; $this->treatPhpDocTypesAsCertain = $treatPhpDocTypesAsCertain; $this->reportAlwaysTrueInLastCondition = $reportAlwaysTrueInLastCondition; $this->treatPhpDocTypesAsCertainTip = $treatPhpDocTypesAsCertainTip; } public function getNodeType() : string { return LogicalXor::class; } public function processNode(Node $node, Scope $scope) : array { $errors = []; $leftType = $this->helper->getBooleanType($scope, $node->left); if ($leftType instanceof ConstantBooleanType) { $addTipLeft = function (RuleErrorBuilder $ruleErrorBuilder) use($scope, $node) : RuleErrorBuilder { if (!$this->treatPhpDocTypesAsCertain) { return $ruleErrorBuilder; } $booleanNativeType = $this->helper->getNativeBooleanType($scope, $node->left); if ($booleanNativeType instanceof ConstantBooleanType) { return $ruleErrorBuilder; } if (!$this->treatPhpDocTypesAsCertainTip) { return $ruleErrorBuilder; } return $ruleErrorBuilder->treatPhpDocTypesAsCertainTip(); }; $isLast = $node->getAttribute(LastConditionVisitor::ATTRIBUTE_NAME); if (!$leftType->getValue() || $isLast !== \true || $this->reportAlwaysTrueInLastCondition) { $errorBuilder = $addTipLeft(RuleErrorBuilder::message(sprintf('Left side of xor is always %s.', $leftType->getValue() ? 'true' : 'false')))->identifier(sprintf('logicalXor.leftAlways%s', $leftType->getValue() ? 'True' : 'False'))->line($node->left->getStartLine()); if ($leftType->getValue() && $isLast === \false && !$this->reportAlwaysTrueInLastCondition) { $errorBuilder->tip('Remove remaining cases below this one and this error will disappear too.'); } $errors[] = $errorBuilder->build(); } } $rightType = $this->helper->getBooleanType($scope, $node->right); if ($rightType instanceof ConstantBooleanType) { $addTipRight = function (RuleErrorBuilder $ruleErrorBuilder) use($scope, $node) : RuleErrorBuilder { if (!$this->treatPhpDocTypesAsCertain) { return $ruleErrorBuilder; } $booleanNativeType = $this->helper->getNativeBooleanType($scope, $node->right); if ($booleanNativeType instanceof ConstantBooleanType) { return $ruleErrorBuilder; } if (!$this->treatPhpDocTypesAsCertainTip) { return $ruleErrorBuilder; } return $ruleErrorBuilder->treatPhpDocTypesAsCertainTip(); }; $isLast = $node->getAttribute(LastConditionVisitor::ATTRIBUTE_NAME); if (!$rightType->getValue() || $isLast !== \true || $this->reportAlwaysTrueInLastCondition) { $errorBuilder = $addTipRight(RuleErrorBuilder::message(sprintf('Right side of xor is always %s.', $rightType->getValue() ? 'true' : 'false')))->identifier(sprintf('logicalXor.rightAlways%s', $rightType->getValue() ? 'True' : 'False'))->line($node->right->getStartLine()); if ($rightType->getValue() && $isLast === \false && !$this->reportAlwaysTrueInLastCondition) { $errorBuilder->tip('Remove remaining cases below this one and this error will disappear too.'); } $errors[] = $errorBuilder->build(); } } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Comparison; use PhpParser\Node; use PhpParser\Node\Expr; use PHPStan\Analyser\Scope; use PHPStan\Parser\LastConditionVisitor; use PHPStan\Reflection\MethodReflection; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\ShouldNotHappenException; use function sprintf; /** * @implements Rule<Node\Expr\MethodCall> */ final class ImpossibleCheckTypeMethodCallRule implements Rule { /** * @var ImpossibleCheckTypeHelper */ private $impossibleCheckTypeHelper; /** * @var bool */ private $checkAlwaysTrueCheckTypeFunctionCall; /** * @var bool */ private $treatPhpDocTypesAsCertain; /** * @var bool */ private $reportAlwaysTrueInLastCondition; /** * @var bool */ private $treatPhpDocTypesAsCertainTip; public function __construct(\PHPStan\Rules\Comparison\ImpossibleCheckTypeHelper $impossibleCheckTypeHelper, bool $checkAlwaysTrueCheckTypeFunctionCall, bool $treatPhpDocTypesAsCertain, bool $reportAlwaysTrueInLastCondition, bool $treatPhpDocTypesAsCertainTip) { $this->impossibleCheckTypeHelper = $impossibleCheckTypeHelper; $this->checkAlwaysTrueCheckTypeFunctionCall = $checkAlwaysTrueCheckTypeFunctionCall; $this->treatPhpDocTypesAsCertain = $treatPhpDocTypesAsCertain; $this->reportAlwaysTrueInLastCondition = $reportAlwaysTrueInLastCondition; $this->treatPhpDocTypesAsCertainTip = $treatPhpDocTypesAsCertainTip; } public function getNodeType() : string { return Node\Expr\MethodCall::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->name instanceof Node\Identifier) { return []; } $isAlways = $this->impossibleCheckTypeHelper->findSpecifiedType($scope, $node); if ($isAlways === null) { return []; } $addTip = function (RuleErrorBuilder $ruleErrorBuilder) use($scope, $node) : RuleErrorBuilder { if (!$this->treatPhpDocTypesAsCertain) { return $ruleErrorBuilder; } $isAlways = $this->impossibleCheckTypeHelper->doNotTreatPhpDocTypesAsCertain()->findSpecifiedType($scope, $node); if ($isAlways !== null) { return $ruleErrorBuilder; } if (!$this->treatPhpDocTypesAsCertainTip) { return $ruleErrorBuilder; } return $ruleErrorBuilder->treatPhpDocTypesAsCertainTip(); }; if (!$isAlways) { $method = $this->getMethod($node->var, $node->name->name, $scope); return [$addTip(RuleErrorBuilder::message(sprintf('Call to method %s::%s()%s will always evaluate to false.', $method->getDeclaringClass()->getDisplayName(), $method->getName(), $this->impossibleCheckTypeHelper->getArgumentsDescription($scope, $node->getArgs()))))->identifier('method.impossibleType')->build()]; } elseif ($this->checkAlwaysTrueCheckTypeFunctionCall) { $isLast = $node->getAttribute(LastConditionVisitor::ATTRIBUTE_NAME); if ($isLast === \true && !$this->reportAlwaysTrueInLastCondition) { return []; } $method = $this->getMethod($node->var, $node->name->name, $scope); $errorBuilder = $addTip(RuleErrorBuilder::message(sprintf('Call to method %s::%s()%s will always evaluate to true.', $method->getDeclaringClass()->getDisplayName(), $method->getName(), $this->impossibleCheckTypeHelper->getArgumentsDescription($scope, $node->getArgs())))); if ($isLast === \false && !$this->reportAlwaysTrueInLastCondition) { $errorBuilder->tip('Remove remaining cases below this one and this error will disappear too.'); } $errorBuilder->identifier('method.alreadyNarrowedType'); return [$errorBuilder->build()]; } return []; } private function getMethod(Expr $var, string $methodName, Scope $scope) : MethodReflection { $calledOnType = $scope->getType($var); $method = $scope->getMethodReflection($calledOnType, $methodName); if ($method === null) { throw new ShouldNotHappenException(); } return $method; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Comparison; use PhpParser\Node; use PhpParser\Node\Expr\BinaryOp; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\ShouldNotHappenException; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\VerbosityLevel; use function get_class; use function sprintf; /** * @implements Rule<Node\Expr\BinaryOp> */ final class NumberComparisonOperatorsConstantConditionRule implements Rule { /** * @var bool */ private $treatPhpDocTypesAsCertain; /** * @var bool */ private $treatPhpDocTypesAsCertainTip; public function __construct(bool $treatPhpDocTypesAsCertain, bool $treatPhpDocTypesAsCertainTip) { $this->treatPhpDocTypesAsCertain = $treatPhpDocTypesAsCertain; $this->treatPhpDocTypesAsCertainTip = $treatPhpDocTypesAsCertainTip; } public function getNodeType() : string { return BinaryOp::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node instanceof BinaryOp\Greater && !$node instanceof BinaryOp\GreaterOrEqual && !$node instanceof BinaryOp\Smaller && !$node instanceof BinaryOp\SmallerOrEqual) { return []; } $exprType = $this->treatPhpDocTypesAsCertain ? $scope->getType($node) : $scope->getNativeType($node); if ($exprType instanceof ConstantBooleanType) { $addTip = function (RuleErrorBuilder $ruleErrorBuilder) use($scope, $node) : RuleErrorBuilder { if (!$this->treatPhpDocTypesAsCertain) { return $ruleErrorBuilder; } $booleanNativeType = $scope->getNativeType($node); if ($booleanNativeType instanceof ConstantBooleanType) { return $ruleErrorBuilder; } if (!$this->treatPhpDocTypesAsCertainTip) { return $ruleErrorBuilder; } return $ruleErrorBuilder->treatPhpDocTypesAsCertainTip(); }; switch (get_class($node)) { case BinaryOp\Greater::class: $nodeType = 'greater'; break; case BinaryOp\GreaterOrEqual::class: $nodeType = 'greaterOrEqual'; break; case BinaryOp\Smaller::class: $nodeType = 'smaller'; break; case BinaryOp\SmallerOrEqual::class: $nodeType = 'smallerOrEqual'; break; default: throw new ShouldNotHappenException(); } return [$addTip(RuleErrorBuilder::message(sprintf('Comparison operation "%s" between %s and %s is always %s.', $node->getOperatorSigil(), $scope->getType($node->left)->describe(VerbosityLevel::value()), $scope->getType($node->right)->describe(VerbosityLevel::value()), $exprType->getValue() ? 'true' : 'false')))->identifier(sprintf('%s.always%s', $nodeType, $exprType->getValue() ? 'True' : 'False'))->build()]; } return []; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Comparison; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Parser\LastConditionVisitor; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\Constant\ConstantBooleanType; use function sprintf; /** * @implements Rule<Node\Expr\BooleanNot> */ final class BooleanNotConstantConditionRule implements Rule { /** * @var ConstantConditionRuleHelper */ private $helper; /** * @var bool */ private $treatPhpDocTypesAsCertain; /** * @var bool */ private $reportAlwaysTrueInLastCondition; /** * @var bool */ private $treatPhpDocTypesAsCertainTip; public function __construct(\PHPStan\Rules\Comparison\ConstantConditionRuleHelper $helper, bool $treatPhpDocTypesAsCertain, bool $reportAlwaysTrueInLastCondition, bool $treatPhpDocTypesAsCertainTip) { $this->helper = $helper; $this->treatPhpDocTypesAsCertain = $treatPhpDocTypesAsCertain; $this->reportAlwaysTrueInLastCondition = $reportAlwaysTrueInLastCondition; $this->treatPhpDocTypesAsCertainTip = $treatPhpDocTypesAsCertainTip; } public function getNodeType() : string { return Node\Expr\BooleanNot::class; } public function processNode(Node $node, Scope $scope) : array { $exprType = $this->helper->getBooleanType($scope, $node->expr); if ($exprType instanceof ConstantBooleanType) { $addTip = function (RuleErrorBuilder $ruleErrorBuilder) use($scope, $node) : RuleErrorBuilder { if (!$this->treatPhpDocTypesAsCertain) { return $ruleErrorBuilder; } $booleanNativeType = $this->helper->getNativeBooleanType($scope, $node->expr); if ($booleanNativeType instanceof ConstantBooleanType) { return $ruleErrorBuilder; } if (!$this->treatPhpDocTypesAsCertainTip) { return $ruleErrorBuilder; } return $ruleErrorBuilder->treatPhpDocTypesAsCertainTip(); }; $isLast = $node->getAttribute(LastConditionVisitor::ATTRIBUTE_NAME); if ($exprType->getValue() || $isLast !== \true || $this->reportAlwaysTrueInLastCondition) { $errorBuilder = $addTip(RuleErrorBuilder::message(sprintf('Negated boolean expression is always %s.', $exprType->getValue() ? 'false' : 'true')))->line($node->expr->getStartLine()); if (!$exprType->getValue() && $isLast === \false && !$this->reportAlwaysTrueInLastCondition) { $errorBuilder->tip('Remove remaining cases below this one and this error will disappear too.'); } $errorBuilder->identifier(sprintf('booleanNot.always%s', $exprType->getValue() ? 'False' : 'True')); return [$errorBuilder->build()]; } } return []; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Comparison; use PhpParser\Node; use PhpParser\Node\Stmt\While_; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\Constant\ConstantBooleanType; /** * @implements Rule<While_> */ final class WhileLoopAlwaysFalseConditionRule implements Rule { /** * @var ConstantConditionRuleHelper */ private $helper; /** * @var bool */ private $treatPhpDocTypesAsCertain; /** * @var bool */ private $treatPhpDocTypesAsCertainTip; public function __construct(\PHPStan\Rules\Comparison\ConstantConditionRuleHelper $helper, bool $treatPhpDocTypesAsCertain, bool $treatPhpDocTypesAsCertainTip) { $this->helper = $helper; $this->treatPhpDocTypesAsCertain = $treatPhpDocTypesAsCertain; $this->treatPhpDocTypesAsCertainTip = $treatPhpDocTypesAsCertainTip; } public function getNodeType() : string { return While_::class; } public function processNode(Node $node, Scope $scope) : array { $exprType = $this->helper->getBooleanType($scope, $node->cond); if ($exprType->isFalse()->yes()) { $addTip = function (RuleErrorBuilder $ruleErrorBuilder) use($scope, $node) : RuleErrorBuilder { if (!$this->treatPhpDocTypesAsCertain) { return $ruleErrorBuilder; } $booleanNativeType = $this->helper->getNativeBooleanType($scope, $node->cond); if ($booleanNativeType instanceof ConstantBooleanType) { return $ruleErrorBuilder; } if (!$this->treatPhpDocTypesAsCertainTip) { return $ruleErrorBuilder; } return $ruleErrorBuilder->treatPhpDocTypesAsCertainTip(); }; return [$addTip(RuleErrorBuilder::message('While loop condition is always false.'))->line($node->cond->getStartLine())->identifier('while.alwaysFalse')->build()]; } return []; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Comparison; use PhpParser\Node; use PhpParser\Node\Scalar\LNumber; use PhpParser\Node\Stmt\Break_; use PhpParser\Node\Stmt\Continue_; use PHPStan\Analyser\Scope; use PHPStan\Node\DoWhileLoopConditionNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\Constant\ConstantBooleanType; use function sprintf; /** * @implements Rule<DoWhileLoopConditionNode> */ final class DoWhileLoopConstantConditionRule implements Rule { /** * @var ConstantConditionRuleHelper */ private $helper; /** * @var bool */ private $treatPhpDocTypesAsCertain; /** * @var bool */ private $treatPhpDocTypesAsCertainTip; public function __construct(\PHPStan\Rules\Comparison\ConstantConditionRuleHelper $helper, bool $treatPhpDocTypesAsCertain, bool $treatPhpDocTypesAsCertainTip) { $this->helper = $helper; $this->treatPhpDocTypesAsCertain = $treatPhpDocTypesAsCertain; $this->treatPhpDocTypesAsCertainTip = $treatPhpDocTypesAsCertainTip; } public function getNodeType() : string { return DoWhileLoopConditionNode::class; } public function processNode(Node $node, Scope $scope) : array { $exprType = $this->helper->getBooleanType($scope, $node->getCond()); if ($exprType instanceof ConstantBooleanType) { if ($exprType->getValue()) { foreach ($node->getExitPoints() as $exitPoint) { $statement = $exitPoint->getStatement(); if ($statement instanceof Break_) { return []; } if (!$statement instanceof Continue_) { return []; } if ($statement->num === null) { continue; } if (!$statement->num instanceof LNumber) { continue; } $value = $statement->num->value; if ($value === 1) { continue; } if ($value > 1) { return []; } } } $addTip = function (RuleErrorBuilder $ruleErrorBuilder) use($scope, $node) : RuleErrorBuilder { if (!$this->treatPhpDocTypesAsCertain) { return $ruleErrorBuilder; } $booleanNativeType = $this->helper->getNativeBooleanType($scope, $node->getCond()); if ($booleanNativeType instanceof ConstantBooleanType) { return $ruleErrorBuilder; } if (!$this->treatPhpDocTypesAsCertainTip) { return $ruleErrorBuilder; } return $ruleErrorBuilder->treatPhpDocTypesAsCertainTip(); }; return [$addTip(RuleErrorBuilder::message(sprintf('Do-while loop condition is always %s.', $exprType->getValue() ? 'true' : 'false')))->line($node->getCond()->getStartLine())->identifier(sprintf('doWhile.always%s', $exprType->getValue() ? 'True' : 'False'))->build()]; } return []; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Comparison; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\Constant\ConstantBooleanType; /** * @implements Rule<Node\Expr\Ternary> */ final class UnreachableTernaryElseBranchRule implements Rule { /** * @var ConstantConditionRuleHelper */ private $helper; /** * @var bool */ private $treatPhpDocTypesAsCertain; /** * @var bool */ private $disable; /** * @var bool */ private $treatPhpDocTypesAsCertainTip; public function __construct(\PHPStan\Rules\Comparison\ConstantConditionRuleHelper $helper, bool $treatPhpDocTypesAsCertain, bool $disable, bool $treatPhpDocTypesAsCertainTip) { $this->helper = $helper; $this->treatPhpDocTypesAsCertain = $treatPhpDocTypesAsCertain; $this->disable = $disable; $this->treatPhpDocTypesAsCertainTip = $treatPhpDocTypesAsCertainTip; } public function getNodeType() : string { return Node\Expr\Ternary::class; } public function processNode(Node $node, Scope $scope) : array { if ($this->disable) { return []; } $conditionType = $this->treatPhpDocTypesAsCertain ? $scope->getType($node->cond) : $scope->getNativeType($node->cond); $conditionBooleanType = $conditionType->toBoolean(); if ($conditionBooleanType->isTrue()->yes() && $this->helper->shouldSkip($scope, $node->cond) && !$this->helper->shouldReportAlwaysTrueByDefault($node->cond)) { $addTip = function (RuleErrorBuilder $ruleErrorBuilder) use($scope, $node) : RuleErrorBuilder { if (!$this->treatPhpDocTypesAsCertain) { return $ruleErrorBuilder; } $booleanNativeType = $scope->getNativeType($node->cond); if ($booleanNativeType instanceof ConstantBooleanType) { return $ruleErrorBuilder; } if (!$this->treatPhpDocTypesAsCertainTip) { return $ruleErrorBuilder; } return $ruleErrorBuilder->treatPhpDocTypesAsCertainTip(); }; return [$addTip(RuleErrorBuilder::message('Else branch is unreachable because ternary operator condition is always true.'))->identifier('ternary.elseUnreachable')->line($node->else->getStartLine())->build()]; } return []; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Comparison; use PhpParser\Node; use PhpParser\Node\Arg; use PhpParser\Node\Expr; use PhpParser\Node\Expr\FuncCall; use PhpParser\Node\Expr\MethodCall; use PhpParser\Node\Expr\StaticCall; use PHPStan\Analyser\Scope; use PHPStan\Analyser\TypeSpecifier; use PHPStan\Analyser\TypeSpecifierContext; use PHPStan\Reflection\ParametersAcceptorSelector; use PHPStan\Reflection\ReflectionProvider; use PHPStan\TrinaryLogic; use PHPStan\Type\Constant\ConstantArrayType; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\Generic\GenericClassStringType; use PHPStan\Type\IntersectionType; use PHPStan\Type\MixedType; use PHPStan\Type\NeverType; use PHPStan\Type\ObjectType; use PHPStan\Type\Type; use PHPStan\Type\TypeTraverser; use PHPStan\Type\TypeUtils; use PHPStan\Type\TypeWithClassName; use PHPStan\Type\UnionType; use PHPStan\Type\VerbosityLevel; use function array_map; use function array_pop; use function count; use function implode; use function in_array; use function is_string; use function sprintf; use function strtolower; final class ImpossibleCheckTypeHelper { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var TypeSpecifier */ private $typeSpecifier; /** * @var string[] */ private $universalObjectCratesClasses; /** * @var bool */ private $treatPhpDocTypesAsCertain; /** * @var bool */ private $nullContextForVoidReturningFunctions; /** * @param string[] $universalObjectCratesClasses */ public function __construct(ReflectionProvider $reflectionProvider, TypeSpecifier $typeSpecifier, array $universalObjectCratesClasses, bool $treatPhpDocTypesAsCertain, bool $nullContextForVoidReturningFunctions) { $this->reflectionProvider = $reflectionProvider; $this->typeSpecifier = $typeSpecifier; $this->universalObjectCratesClasses = $universalObjectCratesClasses; $this->treatPhpDocTypesAsCertain = $treatPhpDocTypesAsCertain; $this->nullContextForVoidReturningFunctions = $nullContextForVoidReturningFunctions; } public function findSpecifiedType(Scope $scope, Expr $node) : ?bool { if ($node instanceof FuncCall) { if ($node->isFirstClassCallable()) { return null; } $argsCount = count($node->getArgs()); if ($node->name instanceof Node\Name) { $functionName = strtolower((string) $node->name); if ($functionName === 'assert' && $argsCount >= 1) { $arg = $node->getArgs()[0]->value; $assertValue = ($this->treatPhpDocTypesAsCertain ? $scope->getType($arg) : $scope->getNativeType($arg))->toBoolean(); if (!$assertValue instanceof ConstantBooleanType) { return null; } return $assertValue->getValue(); } if (in_array($functionName, ['class_exists', 'interface_exists', 'trait_exists', 'enum_exists'], \true)) { return null; } if (in_array($functionName, ['count', 'sizeof'], \true)) { return null; } elseif ($functionName === 'defined') { return null; } elseif ($functionName === 'array_search') { return null; } elseif ($functionName === 'in_array' && $argsCount >= 2) { $haystackArg = $node->getArgs()[1]->value; $haystackType = $this->treatPhpDocTypesAsCertain ? $scope->getType($haystackArg) : $scope->getNativeType($haystackArg); if ($haystackType instanceof MixedType) { return null; } if (!$haystackType->isArray()->yes()) { return null; } $needleArg = $node->getArgs()[0]->value; $needleType = $this->treatPhpDocTypesAsCertain ? $scope->getType($needleArg) : $scope->getNativeType($needleArg); $isStrictComparison = \false; if ($argsCount >= 3) { $strictNodeType = $scope->getType($node->getArgs()[2]->value); $isStrictComparison = $strictNodeType->isTrue()->yes(); } $isStrictComparison = $isStrictComparison || $needleType->isEnum()->yes() || $haystackType->getIterableValueType()->isEnum()->yes(); if (!$isStrictComparison) { return null; } $valueType = $haystackType->getIterableValueType(); $constantNeedleTypesCount = count($needleType->getFiniteTypes()); $constantHaystackTypesCount = count($valueType->getFiniteTypes()); $isNeedleSupertype = $needleType->isSuperTypeOf($valueType); if ($haystackType->isConstantArray()->no()) { if ($haystackType->isIterableAtLeastOnce()->yes()) { // In this case the generic implementation via typeSpecifier fails, because the argument types cannot be narrowed down. if ($constantNeedleTypesCount === 1 && $constantHaystackTypesCount === 1) { if ($isNeedleSupertype->yes()) { return \true; } if ($isNeedleSupertype->no()) { return \false; } } return null; } } if (!$haystackType instanceof ConstantArrayType || count($haystackType->getValueTypes()) > 0) { $haystackArrayTypes = $haystackType->getArrays(); if (count($haystackArrayTypes) === 1 && $haystackArrayTypes[0]->getIterableValueType() instanceof NeverType) { return null; } if ($isNeedleSupertype->maybe() || $isNeedleSupertype->yes()) { foreach ($haystackArrayTypes as $haystackArrayType) { if ($haystackArrayType instanceof ConstantArrayType) { foreach ($haystackArrayType->getValueTypes() as $i => $haystackArrayValueType) { if ($haystackArrayType->isOptionalKey($i)) { continue; } foreach ($haystackArrayValueType->getConstantScalarTypes() as $constantScalarType) { if ($constantScalarType->isSuperTypeOf($needleType)->yes()) { continue 3; } } } } else { foreach ($haystackArrayType->getIterableValueType()->getConstantScalarTypes() as $constantScalarType) { if ($constantScalarType->isSuperTypeOf($needleType)->yes()) { continue 2; } } } return null; } } if ($isNeedleSupertype->yes()) { $hasConstantNeedleTypes = $constantNeedleTypesCount > 0; $hasConstantHaystackTypes = $constantHaystackTypesCount > 0; if (!$hasConstantNeedleTypes && !$hasConstantHaystackTypes || $hasConstantNeedleTypes !== $hasConstantHaystackTypes) { return null; } } } } elseif ($functionName === 'method_exists' && $argsCount >= 2) { $objectArg = $node->getArgs()[0]->value; $objectType = $this->treatPhpDocTypesAsCertain ? $scope->getType($objectArg) : $scope->getNativeType($objectArg); if ($objectType instanceof ConstantStringType && !$this->reflectionProvider->hasClass($objectType->getValue())) { return \false; } $methodArg = $node->getArgs()[1]->value; $methodType = $this->treatPhpDocTypesAsCertain ? $scope->getType($methodArg) : $scope->getNativeType($methodArg); if ($methodType instanceof ConstantStringType) { if ($objectType instanceof ConstantStringType) { $objectType = new ObjectType($objectType->getValue()); } if ($objectType->getObjectClassNames() !== []) { if ($objectType->hasMethod($methodType->getValue())->yes()) { return \true; } if ($objectType->hasMethod($methodType->getValue())->no()) { return \false; } } $genericType = TypeTraverser::map($objectType, static function (Type $type, callable $traverse) : Type { if ($type instanceof UnionType || $type instanceof IntersectionType) { return $traverse($type); } if ($type instanceof GenericClassStringType) { return $type->getGenericType(); } return new MixedType(); }); if ($genericType instanceof TypeWithClassName) { if ($genericType->hasMethod($methodType->getValue())->yes()) { return \true; } $classReflection = $genericType->getClassReflection(); if ($classReflection !== null && $classReflection->isFinal() && $genericType->hasMethod($methodType->getValue())->no()) { return \false; } } } } } } $typeSpecifierScope = $this->treatPhpDocTypesAsCertain ? $scope : $scope->doNotTreatPhpDocTypesAsCertain(); $specifiedTypes = $this->typeSpecifier->specifyTypesInCondition($typeSpecifierScope, $node, $this->determineContext($typeSpecifierScope, $node)); // don't validate types on overwrite if ($specifiedTypes->shouldOverwrite()) { return null; } $sureTypes = $specifiedTypes->getSureTypes(); $sureNotTypes = $specifiedTypes->getSureNotTypes(); $rootExpr = $specifiedTypes->getRootExpr(); if ($rootExpr !== null) { if (self::isSpecified($typeSpecifierScope, $node, $rootExpr)) { return null; } $rootExprType = $this->treatPhpDocTypesAsCertain ? $scope->getType($rootExpr) : $scope->getNativeType($rootExpr); if ($rootExprType instanceof ConstantBooleanType) { return $rootExprType->getValue(); } return null; } $results = []; foreach ($sureTypes as $sureType) { if (self::isSpecified($typeSpecifierScope, $node, $sureType[0])) { $results[] = TrinaryLogic::createMaybe(); continue; } if ($this->treatPhpDocTypesAsCertain) { $argumentType = $scope->getType($sureType[0]); } else { $argumentType = $scope->getNativeType($sureType[0]); } /** @var Type $resultType */ $resultType = $sureType[1]; $results[] = $resultType->isSuperTypeOf($argumentType); } foreach ($sureNotTypes as $sureNotType) { if (self::isSpecified($typeSpecifierScope, $node, $sureNotType[0])) { $results[] = TrinaryLogic::createMaybe(); continue; } if ($this->treatPhpDocTypesAsCertain) { $argumentType = $scope->getType($sureNotType[0]); } else { $argumentType = $scope->getNativeType($sureNotType[0]); } /** @var Type $resultType */ $resultType = $sureNotType[1]; $results[] = $resultType->isSuperTypeOf($argumentType)->negate(); } if (count($results) === 0) { return null; } $result = TrinaryLogic::createYes()->and(...$results); return $result->maybe() ? null : $result->yes(); } private static function isSpecified(Scope $scope, Expr $node, Expr $expr) : bool { if ($expr === $node) { return \true; } if ($expr instanceof Expr\Variable) { return is_string($expr->name) && !$scope->hasVariableType($expr->name)->yes(); } if ($expr instanceof Expr\BooleanNot) { return self::isSpecified($scope, $node, $expr->expr); } if ($expr instanceof Expr\BinaryOp) { return self::isSpecified($scope, $node, $expr->left) || self::isSpecified($scope, $node, $expr->right); } return ($node instanceof FuncCall || $node instanceof MethodCall || $node instanceof Expr\StaticCall) && $scope->hasExpressionType($expr)->yes(); } /** * @param Node\Arg[] $args */ public function getArgumentsDescription(Scope $scope, array $args) : string { if (count($args) === 0) { return ''; } $descriptions = array_map(function (Arg $arg) use($scope) : string { return ($this->treatPhpDocTypesAsCertain ? $scope->getType($arg->value) : $scope->getNativeType($arg->value))->describe(VerbosityLevel::value()); }, $args); if (count($descriptions) < 3) { return sprintf(' with %s', implode(' and ', $descriptions)); } $lastDescription = array_pop($descriptions); return sprintf(' with arguments %s and %s', implode(', ', $descriptions), $lastDescription); } public function doNotTreatPhpDocTypesAsCertain() : self { if (!$this->treatPhpDocTypesAsCertain) { return $this; } return new self($this->reflectionProvider, $this->typeSpecifier, $this->universalObjectCratesClasses, \false, $this->nullContextForVoidReturningFunctions); } private function determineContext(Scope $scope, Expr $node) : TypeSpecifierContext { if (!$this->nullContextForVoidReturningFunctions) { return TypeSpecifierContext::createTruthy(); } if ($node instanceof Expr\CallLike && $node->isFirstClassCallable()) { return TypeSpecifierContext::createTruthy(); } if ($node instanceof FuncCall && $node->name instanceof Node\Name) { if ($this->reflectionProvider->hasFunction($node->name, $scope)) { $functionReflection = $this->reflectionProvider->getFunction($node->name, $scope); $parametersAcceptor = ParametersAcceptorSelector::selectFromArgs($scope, $node->getArgs(), $functionReflection->getVariants(), $functionReflection->getNamedArgumentsVariants()); $returnType = TypeUtils::resolveLateResolvableTypes($parametersAcceptor->getReturnType()); return $returnType->isVoid()->yes() ? TypeSpecifierContext::createNull() : TypeSpecifierContext::createTruthy(); } } elseif ($node instanceof MethodCall && $node->name instanceof Node\Identifier) { $methodCalledOnType = $scope->getType($node->var); $methodReflection = $scope->getMethodReflection($methodCalledOnType, $node->name->name); if ($methodReflection !== null) { $parametersAcceptor = ParametersAcceptorSelector::selectFromArgs($scope, $node->getArgs(), $methodReflection->getVariants(), $methodReflection->getNamedArgumentsVariants()); $returnType = TypeUtils::resolveLateResolvableTypes($parametersAcceptor->getReturnType()); return $returnType->isVoid()->yes() ? TypeSpecifierContext::createNull() : TypeSpecifierContext::createTruthy(); } } elseif ($node instanceof StaticCall && $node->name instanceof Node\Identifier) { if ($node->class instanceof Node\Name) { $calleeType = $scope->resolveTypeByName($node->class); } else { $calleeType = $scope->getType($node->class); } $staticMethodReflection = $scope->getMethodReflection($calleeType, $node->name->name); if ($staticMethodReflection !== null) { $parametersAcceptor = ParametersAcceptorSelector::selectFromArgs($scope, $node->getArgs(), $staticMethodReflection->getVariants(), $staticMethodReflection->getNamedArgumentsVariants()); $returnType = TypeUtils::resolveLateResolvableTypes($parametersAcceptor->getReturnType()); return $returnType->isVoid()->yes() ? TypeSpecifierContext::createNull() : TypeSpecifierContext::createTruthy(); } } return TypeSpecifierContext::createTruthy(); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Comparison; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Parser\LastConditionVisitor; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\Constant\ConstantBooleanType; use function sprintf; /** * @implements Rule<Node\Stmt\ElseIf_> */ final class ElseIfConstantConditionRule implements Rule { /** * @var ConstantConditionRuleHelper */ private $helper; /** * @var bool */ private $treatPhpDocTypesAsCertain; /** * @var bool */ private $reportAlwaysTrueInLastCondition; /** * @var bool */ private $treatPhpDocTypesAsCertainTip; public function __construct(\PHPStan\Rules\Comparison\ConstantConditionRuleHelper $helper, bool $treatPhpDocTypesAsCertain, bool $reportAlwaysTrueInLastCondition, bool $treatPhpDocTypesAsCertainTip) { $this->helper = $helper; $this->treatPhpDocTypesAsCertain = $treatPhpDocTypesAsCertain; $this->reportAlwaysTrueInLastCondition = $reportAlwaysTrueInLastCondition; $this->treatPhpDocTypesAsCertainTip = $treatPhpDocTypesAsCertainTip; } public function getNodeType() : string { return Node\Stmt\ElseIf_::class; } public function processNode(Node $node, Scope $scope) : array { $exprType = $this->helper->getBooleanType($scope, $node->cond); if ($exprType instanceof ConstantBooleanType) { $addTip = function (RuleErrorBuilder $ruleErrorBuilder) use($scope, $node) : RuleErrorBuilder { if (!$this->treatPhpDocTypesAsCertain) { return $ruleErrorBuilder; } $booleanNativeType = $this->helper->getNativeBooleanType($scope, $node->cond); if ($booleanNativeType instanceof ConstantBooleanType) { return $ruleErrorBuilder; } if (!$this->treatPhpDocTypesAsCertainTip) { return $ruleErrorBuilder; } return $ruleErrorBuilder->treatPhpDocTypesAsCertainTip(); }; $isLast = $node->cond->getAttribute(LastConditionVisitor::ATTRIBUTE_NAME); if (!$exprType->getValue() || $isLast !== \true || $this->reportAlwaysTrueInLastCondition) { $errorBuilder = $addTip(RuleErrorBuilder::message(sprintf('Elseif condition is always %s.', $exprType->getValue() ? 'true' : 'false')))->line($node->cond->getStartLine()); if ($exprType->getValue() && $isLast === \false && !$this->reportAlwaysTrueInLastCondition) { $errorBuilder->tip('Remove remaining cases below this one and this error will disappear too.'); } $errorBuilder->identifier(sprintf('elseif.always%s', $exprType->getValue() ? 'True' : 'False')); return [$errorBuilder->build()]; } } return []; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Comparison; use PhpParser\Node\Expr; use PhpParser\Node\Expr\FuncCall; use PhpParser\Node\Expr\MethodCall; use PHPStan\Analyser\Scope; use PHPStan\Type\BooleanType; final class ConstantConditionRuleHelper { /** * @var ImpossibleCheckTypeHelper */ private $impossibleCheckTypeHelper; /** * @var bool */ private $treatPhpDocTypesAsCertain; /** * @var bool */ private $looseComparisonRuleEnabled; public function __construct(\PHPStan\Rules\Comparison\ImpossibleCheckTypeHelper $impossibleCheckTypeHelper, bool $treatPhpDocTypesAsCertain, bool $looseComparisonRuleEnabled) { $this->impossibleCheckTypeHelper = $impossibleCheckTypeHelper; $this->treatPhpDocTypesAsCertain = $treatPhpDocTypesAsCertain; $this->looseComparisonRuleEnabled = $looseComparisonRuleEnabled; } public function shouldReportAlwaysTrueByDefault(Expr $expr) : bool { return $expr instanceof Expr\BooleanNot || $expr instanceof Expr\BinaryOp\BooleanOr || $expr instanceof Expr\BinaryOp\BooleanAnd || $expr instanceof Expr\Ternary || $expr instanceof Expr\Isset_ || $expr instanceof Expr\Empty_; } public function shouldSkip(Scope $scope, Expr $expr) : bool { if ($this->looseComparisonRuleEnabled && ($expr instanceof Expr\BinaryOp\Equal || $expr instanceof Expr\BinaryOp\NotEqual)) { return \true; } if ($expr instanceof Expr\Instanceof_ || $expr instanceof Expr\BinaryOp\Identical || $expr instanceof Expr\BinaryOp\NotIdentical || $expr instanceof Expr\BooleanNot || $expr instanceof Expr\BinaryOp\BooleanOr || $expr instanceof Expr\BinaryOp\BooleanAnd || $expr instanceof Expr\Ternary || $expr instanceof Expr\Isset_ || $expr instanceof Expr\Empty_ || $expr instanceof Expr\BinaryOp\Greater || $expr instanceof Expr\BinaryOp\GreaterOrEqual || $expr instanceof Expr\BinaryOp\Smaller || $expr instanceof Expr\BinaryOp\SmallerOrEqual) { // already checked by different rules return \true; } if ($expr instanceof FuncCall || $expr instanceof MethodCall || $expr instanceof Expr\StaticCall) { $isAlways = $this->impossibleCheckTypeHelper->findSpecifiedType($scope, $expr); if ($isAlways !== null) { return \true; } } return \false; } public function getBooleanType(Scope $scope, Expr $expr) : BooleanType { if ($this->shouldSkip($scope, $expr)) { return new BooleanType(); } if ($this->treatPhpDocTypesAsCertain) { return $scope->getType($expr)->toBoolean(); } return $scope->getNativeType($expr)->toBoolean(); } public function getNativeBooleanType(Scope $scope, Expr $expr) : BooleanType { if ($this->shouldSkip($scope, $expr)) { return new BooleanType(); } return $scope->getNativeType($expr)->toBoolean(); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Comparison; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\BooleanAndNode; use PHPStan\Parser\LastConditionVisitor; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\Constant\ConstantBooleanType; use function count; use function sprintf; /** * @implements Rule<BooleanAndNode> */ final class BooleanAndConstantConditionRule implements Rule { /** * @var ConstantConditionRuleHelper */ private $helper; /** * @var bool */ private $treatPhpDocTypesAsCertain; /** * @var bool */ private $bleedingEdge; /** * @var bool */ private $reportAlwaysTrueInLastCondition; /** * @var bool */ private $treatPhpDocTypesAsCertainTip; public function __construct(\PHPStan\Rules\Comparison\ConstantConditionRuleHelper $helper, bool $treatPhpDocTypesAsCertain, bool $bleedingEdge, bool $reportAlwaysTrueInLastCondition, bool $treatPhpDocTypesAsCertainTip) { $this->helper = $helper; $this->treatPhpDocTypesAsCertain = $treatPhpDocTypesAsCertain; $this->bleedingEdge = $bleedingEdge; $this->reportAlwaysTrueInLastCondition = $reportAlwaysTrueInLastCondition; $this->treatPhpDocTypesAsCertainTip = $treatPhpDocTypesAsCertainTip; } public function getNodeType() : string { return BooleanAndNode::class; } public function processNode(Node $node, Scope $scope) : array { $errors = []; $originalNode = $node->getOriginalNode(); $nodeText = $this->bleedingEdge ? $originalNode->getOperatorSigil() : '&&'; $leftType = $this->helper->getBooleanType($scope, $originalNode->left); $identifierType = $originalNode instanceof Node\Expr\BinaryOp\BooleanAnd ? 'booleanAnd' : 'logicalAnd'; if ($leftType instanceof ConstantBooleanType) { $addTipLeft = function (RuleErrorBuilder $ruleErrorBuilder) use($scope, $originalNode) : RuleErrorBuilder { if (!$this->treatPhpDocTypesAsCertain) { return $ruleErrorBuilder; } $booleanNativeType = $this->helper->getNativeBooleanType($scope, $originalNode->left); if ($booleanNativeType instanceof ConstantBooleanType) { return $ruleErrorBuilder; } if (!$this->treatPhpDocTypesAsCertainTip) { return $ruleErrorBuilder; } return $ruleErrorBuilder->treatPhpDocTypesAsCertainTip(); }; $isLast = $node->getAttribute(LastConditionVisitor::ATTRIBUTE_NAME); if (!$leftType->getValue() || $isLast !== \true || $this->reportAlwaysTrueInLastCondition) { $errorBuilder = $addTipLeft(RuleErrorBuilder::message(sprintf('Left side of %s is always %s.', $nodeText, $leftType->getValue() ? 'true' : 'false')))->identifier(sprintf('%s.leftAlways%s', $identifierType, $leftType->getValue() ? 'True' : 'False'))->line($originalNode->left->getStartLine()); if ($leftType->getValue() && $isLast === \false && !$this->reportAlwaysTrueInLastCondition) { $errorBuilder->tip('Remove remaining cases below this one and this error will disappear too.'); } $errors[] = $errorBuilder->build(); } } $rightScope = $node->getRightScope(); $rightType = $this->helper->getBooleanType($rightScope, $originalNode->right); if ($rightType instanceof ConstantBooleanType && !$scope->isInFirstLevelStatement()) { $addTipRight = function (RuleErrorBuilder $ruleErrorBuilder) use($rightScope, $originalNode) : RuleErrorBuilder { if (!$this->treatPhpDocTypesAsCertain) { return $ruleErrorBuilder; } $booleanNativeType = $this->helper->getNativeBooleanType($rightScope, $originalNode->right); if ($booleanNativeType instanceof ConstantBooleanType) { return $ruleErrorBuilder; } if (!$this->treatPhpDocTypesAsCertainTip) { return $ruleErrorBuilder; } return $ruleErrorBuilder->treatPhpDocTypesAsCertainTip(); }; $isLast = $node->getAttribute(LastConditionVisitor::ATTRIBUTE_NAME); if (!$rightType->getValue() || $isLast !== \true || $this->reportAlwaysTrueInLastCondition) { $errorBuilder = $addTipRight(RuleErrorBuilder::message(sprintf('Right side of %s is always %s.', $nodeText, $rightType->getValue() ? 'true' : 'false')))->identifier(sprintf('%s.rightAlways%s', $identifierType, $rightType->getValue() ? 'True' : 'False'))->line($originalNode->right->getStartLine()); if ($rightType->getValue() && $isLast === \false && !$this->reportAlwaysTrueInLastCondition) { $errorBuilder->tip('Remove remaining cases below this one and this error will disappear too.'); } $errors[] = $errorBuilder->build(); } } if (count($errors) === 0 && !$scope->isInFirstLevelStatement()) { $nodeType = $this->treatPhpDocTypesAsCertain ? $scope->getType($originalNode) : $scope->getNativeType($originalNode); if ($nodeType instanceof ConstantBooleanType) { $addTip = function (RuleErrorBuilder $ruleErrorBuilder) use($scope, $originalNode) : RuleErrorBuilder { if (!$this->treatPhpDocTypesAsCertain) { return $ruleErrorBuilder; } $booleanNativeType = $scope->getNativeType($originalNode); if ($booleanNativeType instanceof ConstantBooleanType) { return $ruleErrorBuilder; } if (!$this->treatPhpDocTypesAsCertainTip) { return $ruleErrorBuilder; } return $ruleErrorBuilder->treatPhpDocTypesAsCertainTip(); }; $isLast = $node->getAttribute(LastConditionVisitor::ATTRIBUTE_NAME); if (!$nodeType->getValue() || $isLast !== \true || $this->reportAlwaysTrueInLastCondition) { $errorBuilder = $addTip(RuleErrorBuilder::message(sprintf('Result of %s is always %s.', $nodeText, $nodeType->getValue() ? 'true' : 'false'))); if ($nodeType->getValue() && $isLast === \false && !$this->reportAlwaysTrueInLastCondition) { $errorBuilder->tip('Remove remaining cases below this one and this error will disappear too.'); } $errorBuilder->identifier(sprintf('%s.always%s', $identifierType, $nodeType->getValue() ? 'True' : 'False')); $errors[] = $errorBuilder->build(); } } } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Comparison; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Parser\LastConditionVisitor; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function sprintf; use function strtolower; /** * @implements Rule<Node\Expr\FuncCall> */ final class ImpossibleCheckTypeFunctionCallRule implements Rule { /** * @var ImpossibleCheckTypeHelper */ private $impossibleCheckTypeHelper; /** * @var bool */ private $checkAlwaysTrueCheckTypeFunctionCall; /** * @var bool */ private $treatPhpDocTypesAsCertain; /** * @var bool */ private $reportAlwaysTrueInLastCondition; /** * @var bool */ private $treatPhpDocTypesAsCertainTip; public function __construct(\PHPStan\Rules\Comparison\ImpossibleCheckTypeHelper $impossibleCheckTypeHelper, bool $checkAlwaysTrueCheckTypeFunctionCall, bool $treatPhpDocTypesAsCertain, bool $reportAlwaysTrueInLastCondition, bool $treatPhpDocTypesAsCertainTip) { $this->impossibleCheckTypeHelper = $impossibleCheckTypeHelper; $this->checkAlwaysTrueCheckTypeFunctionCall = $checkAlwaysTrueCheckTypeFunctionCall; $this->treatPhpDocTypesAsCertain = $treatPhpDocTypesAsCertain; $this->reportAlwaysTrueInLastCondition = $reportAlwaysTrueInLastCondition; $this->treatPhpDocTypesAsCertainTip = $treatPhpDocTypesAsCertainTip; } public function getNodeType() : string { return Node\Expr\FuncCall::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->name instanceof Node\Name) { return []; } $functionName = (string) $node->name; if (strtolower($functionName) === 'is_a') { return []; } $isAlways = $this->impossibleCheckTypeHelper->findSpecifiedType($scope, $node); if ($isAlways === null) { return []; } $addTip = function (RuleErrorBuilder $ruleErrorBuilder) use($scope, $node) : RuleErrorBuilder { if (!$this->treatPhpDocTypesAsCertain) { return $ruleErrorBuilder; } $isAlways = $this->impossibleCheckTypeHelper->doNotTreatPhpDocTypesAsCertain()->findSpecifiedType($scope, $node); if ($isAlways !== null) { return $ruleErrorBuilder; } if (!$this->treatPhpDocTypesAsCertainTip) { return $ruleErrorBuilder; } return $ruleErrorBuilder->treatPhpDocTypesAsCertainTip(); }; if (!$isAlways) { return [$addTip(RuleErrorBuilder::message(sprintf('Call to function %s()%s will always evaluate to false.', $functionName, $this->impossibleCheckTypeHelper->getArgumentsDescription($scope, $node->getArgs()))))->identifier('function.impossibleType')->build()]; } elseif ($this->checkAlwaysTrueCheckTypeFunctionCall) { $isLast = $node->getAttribute(LastConditionVisitor::ATTRIBUTE_NAME); if ($isLast === \true && !$this->reportAlwaysTrueInLastCondition) { return []; } $errorBuilder = $addTip(RuleErrorBuilder::message(sprintf('Call to function %s()%s will always evaluate to true.', $functionName, $this->impossibleCheckTypeHelper->getArgumentsDescription($scope, $node->getArgs())))); if ($isLast === \false && !$this->reportAlwaysTrueInLastCondition) { $errorBuilder->tip('Remove remaining cases below this one and this error will disappear too.'); } $errorBuilder->identifier('function.alreadyNarrowedType'); return [$errorBuilder->build()]; } return []; } } <?php declare (strict_types=1); namespace PHPStan\Rules; use PhpParser\Node; use PhpParser\Node\Expr; use PHPStan\Analyser\Scope; use PHPStan\Rules\Properties\PropertyDescriptor; use PHPStan\Rules\Properties\PropertyReflectionFinder; use PHPStan\Type\MixedType; use PHPStan\Type\NeverType; use PHPStan\Type\Type; use PHPStan\Type\VerbosityLevel; use function is_string; use function sprintf; /** * @phpstan-type ErrorIdentifier = 'empty'|'isset'|'nullCoalesce' */ final class IssetCheck { /** * @var PropertyDescriptor */ private $propertyDescriptor; /** * @var PropertyReflectionFinder */ private $propertyReflectionFinder; /** * @var bool */ private $checkAdvancedIsset; /** * @var bool */ private $treatPhpDocTypesAsCertain; /** * @var bool */ private $strictUnnecessaryNullsafePropertyFetch; public function __construct(PropertyDescriptor $propertyDescriptor, PropertyReflectionFinder $propertyReflectionFinder, bool $checkAdvancedIsset, bool $treatPhpDocTypesAsCertain, bool $strictUnnecessaryNullsafePropertyFetch) { $this->propertyDescriptor = $propertyDescriptor; $this->propertyReflectionFinder = $propertyReflectionFinder; $this->checkAdvancedIsset = $checkAdvancedIsset; $this->treatPhpDocTypesAsCertain = $treatPhpDocTypesAsCertain; $this->strictUnnecessaryNullsafePropertyFetch = $strictUnnecessaryNullsafePropertyFetch; } /** * @param ErrorIdentifier $identifier * @param callable(Type): ?string $typeMessageCallback */ public function check(Expr $expr, Scope $scope, string $operatorDescription, string $identifier, callable $typeMessageCallback, ?\PHPStan\Rules\IdentifierRuleError $error = null) : ?\PHPStan\Rules\IdentifierRuleError { // mirrored in PHPStan\Analyser\MutatingScope::issetCheck() if ($expr instanceof Node\Expr\Variable && is_string($expr->name)) { $hasVariable = $scope->hasVariableType($expr->name); if ($hasVariable->maybe()) { return null; } if ($error === null) { if ($hasVariable->yes()) { if ($expr->name === '_SESSION') { return null; } $type = $this->treatPhpDocTypesAsCertain ? $scope->getType($expr) : $scope->getNativeType($expr); if (!$type instanceof NeverType) { return $this->generateError($type, sprintf('Variable $%s %s always exists and', $expr->name, $operatorDescription), $typeMessageCallback, $identifier, 'variable'); } } return \PHPStan\Rules\RuleErrorBuilder::message(sprintf('Variable $%s %s is never defined.', $expr->name, $operatorDescription))->identifier(sprintf('%s.variable', $identifier))->build(); } return $error; } elseif ($expr instanceof Node\Expr\ArrayDimFetch && $expr->dim !== null) { $type = $this->treatPhpDocTypesAsCertain ? $scope->getType($expr->var) : $scope->getNativeType($expr->var); if (!$type->isOffsetAccessible()->yes()) { return $error ?? $this->checkUndefined($expr->var, $scope, $operatorDescription, $identifier); } $dimType = $this->treatPhpDocTypesAsCertain ? $scope->getType($expr->dim) : $scope->getNativeType($expr->dim); $hasOffsetValue = $type->hasOffsetValueType($dimType); if ($hasOffsetValue->no()) { if (!$this->checkAdvancedIsset) { return null; } return \PHPStan\Rules\RuleErrorBuilder::message(sprintf('Offset %s on %s %s does not exist.', $dimType->describe(VerbosityLevel::value()), $type->describe(VerbosityLevel::value()), $operatorDescription))->identifier(sprintf('%s.offset', $identifier))->build(); } // If offset cannot be null, store this error message and see if one of the earlier offsets is. // E.g. $array['a']['b']['c'] ?? null; is a valid coalesce if a OR b or C might be null. if ($hasOffsetValue->yes() || $scope->hasExpressionType($expr)->yes()) { if (!$this->checkAdvancedIsset) { return null; } $error = $error ?? $this->generateError($type->getOffsetValueType($dimType), sprintf('Offset %s on %s %s always exists and', $dimType->describe(VerbosityLevel::value()), $type->describe(VerbosityLevel::value()), $operatorDescription), $typeMessageCallback, $identifier, 'offset'); if ($error !== null) { return $this->check($expr->var, $scope, $operatorDescription, $identifier, $typeMessageCallback, $error); } } // Has offset, it is nullable return null; } elseif ($expr instanceof Node\Expr\PropertyFetch || $expr instanceof Node\Expr\StaticPropertyFetch) { $propertyReflection = $this->propertyReflectionFinder->findPropertyReflectionFromNode($expr, $scope); if ($propertyReflection === null) { if ($expr instanceof Node\Expr\PropertyFetch) { return $this->checkUndefined($expr->var, $scope, $operatorDescription, $identifier); } if ($expr->class instanceof Expr) { return $this->checkUndefined($expr->class, $scope, $operatorDescription, $identifier); } return null; } if (!$propertyReflection->isNative()) { if ($expr instanceof Node\Expr\PropertyFetch) { return $this->checkUndefined($expr->var, $scope, $operatorDescription, $identifier); } if ($expr->class instanceof Expr) { return $this->checkUndefined($expr->class, $scope, $operatorDescription, $identifier); } return null; } $nativeType = $propertyReflection->getNativeType(); if (!$nativeType instanceof MixedType) { if (!$scope->hasExpressionType($expr)->yes()) { if ($expr instanceof Node\Expr\PropertyFetch) { return $this->checkUndefined($expr->var, $scope, $operatorDescription, $identifier); } if ($expr->class instanceof Expr) { return $this->checkUndefined($expr->class, $scope, $operatorDescription, $identifier); } return null; } } $propertyDescription = $this->propertyDescriptor->describeProperty($propertyReflection, $scope, $expr); $propertyType = $propertyReflection->getWritableType(); if ($error !== null) { return $error; } if (!$this->checkAdvancedIsset) { if ($expr instanceof Node\Expr\PropertyFetch) { return $this->checkUndefined($expr->var, $scope, $operatorDescription, $identifier); } if ($expr->class instanceof Expr) { return $this->checkUndefined($expr->class, $scope, $operatorDescription, $identifier); } return null; } $error = $this->generateError($propertyReflection->getWritableType(), sprintf('%s (%s) %s', $propertyDescription, $propertyType->describe(VerbosityLevel::typeOnly()), $operatorDescription), $typeMessageCallback, $identifier, 'property'); if ($error !== null) { if ($expr instanceof Node\Expr\PropertyFetch) { return $this->check($expr->var, $scope, $operatorDescription, $identifier, $typeMessageCallback, $error); } if ($expr->class instanceof Expr) { return $this->check($expr->class, $scope, $operatorDescription, $identifier, $typeMessageCallback, $error); } } return $error; } if ($error !== null) { return $error; } if (!$this->checkAdvancedIsset) { return null; } $error = $this->generateError($this->treatPhpDocTypesAsCertain ? $scope->getType($expr) : $scope->getNativeType($expr), sprintf('Expression %s', $operatorDescription), $typeMessageCallback, $identifier, 'expr'); if ($error !== null) { return $error; } if ($expr instanceof Expr\NullsafePropertyFetch) { if (!$this->strictUnnecessaryNullsafePropertyFetch) { return null; } if ($expr->name instanceof Node\Identifier) { return \PHPStan\Rules\RuleErrorBuilder::message(sprintf('Using nullsafe property access "?->%s" %s is unnecessary. Use -> instead.', $expr->name->name, $operatorDescription))->identifier('nullsafe.neverNull')->build(); } return \PHPStan\Rules\RuleErrorBuilder::message(sprintf('Using nullsafe property access "?->(Expression)" %s is unnecessary. Use -> instead.', $operatorDescription))->identifier('nullsafe.neverNull')->build(); } return null; } /** * @param ErrorIdentifier $identifier */ private function checkUndefined(Expr $expr, Scope $scope, string $operatorDescription, string $identifier) : ?\PHPStan\Rules\IdentifierRuleError { if ($expr instanceof Node\Expr\Variable && is_string($expr->name)) { $hasVariable = $scope->hasVariableType($expr->name); if (!$hasVariable->no()) { return null; } return \PHPStan\Rules\RuleErrorBuilder::message(sprintf('Variable $%s %s is never defined.', $expr->name, $operatorDescription))->identifier(sprintf('%s.variable', $identifier))->build(); } if ($expr instanceof Node\Expr\ArrayDimFetch && $expr->dim !== null) { $type = $this->treatPhpDocTypesAsCertain ? $scope->getType($expr->var) : $scope->getNativeType($expr->var); $dimType = $this->treatPhpDocTypesAsCertain ? $scope->getType($expr->dim) : $scope->getNativeType($expr->dim); $hasOffsetValue = $type->hasOffsetValueType($dimType); if (!$type->isOffsetAccessible()->yes()) { return $this->checkUndefined($expr->var, $scope, $operatorDescription, $identifier); } if (!$hasOffsetValue->no()) { return $this->checkUndefined($expr->var, $scope, $operatorDescription, $identifier); } return \PHPStan\Rules\RuleErrorBuilder::message(sprintf('Offset %s on %s %s does not exist.', $dimType->describe(VerbosityLevel::value()), $type->describe(VerbosityLevel::value()), $operatorDescription))->identifier(sprintf('%s.offset', $identifier))->build(); } if ($expr instanceof Expr\PropertyFetch) { return $this->checkUndefined($expr->var, $scope, $operatorDescription, $identifier); } if ($expr instanceof Expr\StaticPropertyFetch && $expr->class instanceof Expr) { return $this->checkUndefined($expr->class, $scope, $operatorDescription, $identifier); } return null; } /** * @param callable(Type): ?string $typeMessageCallback * @param ErrorIdentifier $identifier * @param 'variable'|'offset'|'property'|'expr' $identifierSecondPart */ private function generateError(Type $type, string $message, callable $typeMessageCallback, string $identifier, string $identifierSecondPart) : ?\PHPStan\Rules\IdentifierRuleError { $typeMessage = $typeMessageCallback($type); if ($typeMessage === null) { return null; } return \PHPStan\Rules\RuleErrorBuilder::message(sprintf('%s %s.', $message, $typeMessage))->identifier(sprintf('%s.%s', $identifier, $identifierSecondPart))->build(); } } <?php declare (strict_types=1); namespace PHPStan\Rules; /** @api */ interface RuleError { public function getMessage() : string; } <?php declare (strict_types=1); namespace PHPStan\Rules; use PhpParser\Node; use function class_implements; use function class_parents; /** * @final */ class DirectRegistry implements \PHPStan\Rules\Registry { /** @var Rule[][] */ private $rules = []; /** @var Rule[][] */ private $cache = []; /** * @param Rule[] $rules */ public function __construct(array $rules) { foreach ($rules as $rule) { $this->rules[$rule->getNodeType()][] = $rule; } } /** * @template TNodeType of Node * @param class-string<TNodeType> $nodeType * @return array<Rule<TNodeType>> */ public function getRules(string $nodeType) : array { if (!isset($this->cache[$nodeType])) { $parentNodeTypes = [$nodeType] + class_parents($nodeType) + class_implements($nodeType); $rules = []; foreach ($parentNodeTypes as $parentNodeType) { foreach ($this->rules[$parentNodeType] ?? [] as $rule) { $rules[] = $rule; } } $this->cache[$nodeType] = $rules; } /** * @var array<Rule<TNodeType>> $selectedRules */ $selectedRules = $this->cache[$nodeType]; return $selectedRules; } } <?php declare (strict_types=1); namespace PHPStan\Rules; use PHPStan\Classes\ForbiddenClassNameExtension; use PHPStan\DependencyInjection\Container; use function array_map; use function array_merge; use function sprintf; use function str_starts_with; use function strlen; use function strpos; use function substr; final class ClassForbiddenNameCheck { /** * @var Container */ private $container; private const INTERNAL_CLASS_PREFIXES = ['PHPStan' => '_PHPStan_', 'Rector' => 'RectorPrefix', 'PHP-Scoper' => '_PhpScoper', 'PHPUnit' => 'PHPUnitPHAR', 'Box' => '_HumbugBox']; public function __construct(Container $container) { $this->container = $container; } /** * @param ClassNameNodePair[] $pairs * @return list<IdentifierRuleError> */ public function checkClassNames(array $pairs) : array { $extensions = $this->container->getServicesByTag(ForbiddenClassNameExtension::EXTENSION_TAG); $classPrefixes = array_merge(self::INTERNAL_CLASS_PREFIXES, ...array_map(static function (ForbiddenClassNameExtension $extension) : array { return $extension->getClassPrefixes(); }, $extensions)); $errors = []; foreach ($pairs as $pair) { $className = $pair->getClassName(); $projectName = null; $withoutPrefixClassName = null; foreach ($classPrefixes as $project => $prefix) { if (!str_starts_with($className, $prefix)) { continue; } $projectName = $project; $withoutPrefixClassName = substr($className, strlen($prefix)); if (strpos($withoutPrefixClassName, '\\') === \false) { continue; } $withoutPrefixClassName = substr($withoutPrefixClassName, strpos($withoutPrefixClassName, '\\')); } if ($projectName === null) { continue; } $error = \PHPStan\Rules\RuleErrorBuilder::message(sprintf('Referencing prefixed %s class: %s.', $projectName, $className))->line($pair->getNode()->getLine())->identifier('class.prefixed')->nonIgnorable(); if ($withoutPrefixClassName !== null) { $error->tip(sprintf('This is most likely unintentional. Did you mean to type %s?', $withoutPrefixClassName)); } $errors[] = $error->build(); } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Functions; use PhpParser\Node; use PhpParser\Node\Expr\Closure; use PHPStan\Analyser\Scope; use PHPStan\Rules\FunctionDefinitionCheck; use PHPStan\Rules\Rule; /** * @implements Rule<Node\Expr\Closure> */ final class ExistingClassesInClosureTypehintsRule implements Rule { /** * @var FunctionDefinitionCheck */ private $check; public function __construct(FunctionDefinitionCheck $check) { $this->check = $check; } public function getNodeType() : string { return Closure::class; } public function processNode(Node $node, Scope $scope) : array { return $this->check->checkAnonymousFunction($scope, $node->getParams(), $node->getReturnType(), 'Parameter $%s of anonymous function has invalid type %s.', 'Anonymous function has invalid return type %s.', 'Anonymous function uses native union types but they\'re supported only on PHP 8.0 and later.', 'Parameter $%s of anonymous function has unresolvable native type.', 'Anonymous function has unresolvable native return type.'); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Functions; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Internal\SprintfHelper; use PHPStan\Node\InFunctionNode; use PHPStan\Rules\FunctionDefinitionCheck; use PHPStan\Rules\Rule; use function sprintf; /** * @implements Rule<InFunctionNode> */ final class ExistingClassesInTypehintsRule implements Rule { /** * @var FunctionDefinitionCheck */ private $check; public function __construct(FunctionDefinitionCheck $check) { $this->check = $check; } public function getNodeType() : string { return InFunctionNode::class; } public function processNode(Node $node, Scope $scope) : array { $functionName = SprintfHelper::escapeFormatString($node->getFunctionReflection()->getName()); return $this->check->checkFunction($node->getOriginalNode(), $node->getFunctionReflection(), sprintf('Parameter $%%s of function %s() has invalid type %%s.', $functionName), sprintf('Function %s() has invalid return type %%s.', $functionName), sprintf('Function %s() uses native union types but they\'re supported only on PHP 8.0 and later.', $functionName), sprintf('Template type %%s of function %s() is not referenced in a parameter.', $functionName), sprintf('Parameter $%%s of function %s() has unresolvable native type.', $functionName), sprintf('Function %s() has unresolvable native return type.', $functionName)); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Functions; use PhpParser\Node; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function sprintf; use function strtolower; /** * @implements Rule<Node\Expr\FuncCall> */ final class CallToNonExistentFunctionRule implements Rule { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var bool */ private $checkFunctionNameCase; public function __construct(ReflectionProvider $reflectionProvider, bool $checkFunctionNameCase) { $this->reflectionProvider = $reflectionProvider; $this->checkFunctionNameCase = $checkFunctionNameCase; } public function getNodeType() : string { return FuncCall::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->name instanceof Node\Name) { return []; } if (!$this->reflectionProvider->hasFunction($node->name, $scope)) { if ($scope->isInFunctionExists($node->name->toString())) { return []; } return [RuleErrorBuilder::message(sprintf('Function %s not found.', (string) $node->name))->identifier('function.notFound')->discoveringSymbolsTip()->build()]; } $function = $this->reflectionProvider->getFunction($node->name, $scope); $name = (string) $node->name; if ($this->checkFunctionNameCase) { /** @var string $calledFunctionName */ $calledFunctionName = $this->reflectionProvider->resolveFunctionName($node->name, $scope); if (strtolower($function->getName()) === strtolower($calledFunctionName) && $function->getName() !== $calledFunctionName) { return [RuleErrorBuilder::message(sprintf('Call to function %s() with incorrect case: %s', $function->getName(), $name))->identifier('function.nameCase')->build()]; } } return []; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Functions; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\BetterReflection\Reflection\ReflectionFunction; use PHPStan\BetterReflection\Reflector\Reflector; use PHPStan\File\RelativePathHelper; use PHPStan\Node\InFunctionNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function array_map; use function count; use function implode; use function sprintf; /** * @implements Rule<InFunctionNode> */ final class DuplicateFunctionDeclarationRule implements Rule { /** * @var Reflector */ private $reflector; /** * @var RelativePathHelper */ private $relativePathHelper; public function __construct(Reflector $reflector, RelativePathHelper $relativePathHelper) { $this->reflector = $reflector; $this->relativePathHelper = $relativePathHelper; } public function getNodeType() : string { return InFunctionNode::class; } public function processNode(Node $node, Scope $scope) : array { $thisFunction = $node->getFunctionReflection(); $allFunctions = $this->reflector->reflectAllFunctions(); $filteredFunctions = []; foreach ($allFunctions as $reflectionFunction) { if ($reflectionFunction->getName() !== $thisFunction->getName()) { continue; } $filteredFunctions[] = $reflectionFunction; } if (count($filteredFunctions) < 2) { return []; } return [RuleErrorBuilder::message(sprintf("Function %s declared multiple times:\n%s", $thisFunction->getName(), implode("\n", array_map(function (ReflectionFunction $function) { return sprintf('- %s:%d', $this->relativePathHelper->getRelativePath($function->getFileName() ?? 'unknown'), $function->getStartLine()); }, $filteredFunctions))))->identifier('function.duplicate')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Functions; use Attribute; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\AttributesCheck; use PHPStan\Rules\Rule; /** * @implements Rule<Node\Stmt\Function_> */ final class FunctionAttributesRule implements Rule { /** * @var AttributesCheck */ private $attributesCheck; public function __construct(AttributesCheck $attributesCheck) { $this->attributesCheck = $attributesCheck; } public function getNodeType() : string { return Node\Stmt\Function_::class; } public function processNode(Node $node, Scope $scope) : array { return $this->attributesCheck->check($scope, $node->attrGroups, Attribute::TARGET_FUNCTION, 'function'); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Functions; use Generator; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\InArrowFunctionNode; use PHPStan\Rules\FunctionReturnTypeCheck; use PHPStan\Rules\Rule; use PHPStan\ShouldNotHappenException; use PHPStan\Type\NeverType; use PHPStan\Type\ObjectType; use PHPStan\Type\Type; /** * @implements Rule<InArrowFunctionNode> */ final class ArrowFunctionReturnTypeRule implements Rule { /** * @var FunctionReturnTypeCheck */ private $returnTypeCheck; public function __construct(FunctionReturnTypeCheck $returnTypeCheck) { $this->returnTypeCheck = $returnTypeCheck; } public function getNodeType() : string { return InArrowFunctionNode::class; } public function processNode(Node $node, Scope $scope) : array { if (!$scope->isInAnonymousFunction()) { throw new ShouldNotHappenException(); } /** @var Type $returnType */ $returnType = $scope->getAnonymousFunctionReturnType(); $generatorType = new ObjectType(Generator::class); $originalNode = $node->getOriginalNode(); $isVoidSuperType = $returnType->isVoid(); if ($originalNode->returnType === null && $isVoidSuperType->yes()) { return []; } $exprType = $scope->getType($originalNode->expr); if ($returnType instanceof NeverType && $returnType->isExplicit() && $exprType instanceof NeverType && $exprType->isExplicit()) { return []; } return $this->returnTypeCheck->checkReturnType($scope, $returnType, $originalNode->expr, $originalNode->expr, 'Anonymous function should return %s but empty return statement found.', 'Anonymous function with return type void returns %s but should not return anything.', 'Anonymous function should return %s but returns %s.', 'Anonymous function should never return but return statement found.', $generatorType->isSuperTypeOf($returnType)->yes()); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Functions; use Attribute; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\AttributesCheck; use PHPStan\Rules\Rule; /** * @implements Rule<Node\Param> */ final class ParamAttributesRule implements Rule { /** * @var AttributesCheck */ private $attributesCheck; public function __construct(AttributesCheck $attributesCheck) { $this->attributesCheck = $attributesCheck; } public function getNodeType() : string { return Node\Param::class; } public function processNode(Node $node, Scope $scope) : array { $targetName = 'parameter'; $targetType = Attribute::TARGET_PARAMETER; if ($node->flags !== 0) { $targetName = 'parameter or property'; $targetType |= Attribute::TARGET_PROPERTY; } return $this->attributesCheck->check($scope, $node->attrGroups, $targetType, $targetName); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Functions; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\InClosureNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\ShouldNotHappenException; use PHPStan\Type\Generic\TemplateTypeHelper; use PHPStan\Type\VerbosityLevel; use function is_string; use function sprintf; /** * @implements Rule<InClosureNode> */ final class IncompatibleClosureDefaultParameterTypeRule implements Rule { public function getNodeType() : string { return InClosureNode::class; } public function processNode(Node $node, Scope $scope) : array { $parameters = $node->getClosureType()->getParameters(); $errors = []; foreach ($node->getOriginalNode()->getParams() as $paramI => $param) { if ($param->default === null) { continue; } if ($param->var instanceof Node\Expr\Error || !is_string($param->var->name)) { throw new ShouldNotHappenException(); } $defaultValueType = $scope->getType($param->default); $parameterType = $parameters[$paramI]->getType(); $parameterType = TemplateTypeHelper::resolveToBounds($parameterType); $accepts = $parameterType->acceptsWithReason($defaultValueType, \true); if ($accepts->yes()) { continue; } $verbosityLevel = VerbosityLevel::getRecommendedLevelByType($parameterType, $defaultValueType); $errors[] = RuleErrorBuilder::message(sprintf('Default value of the parameter #%d $%s (%s) of anonymous function is incompatible with type %s.', $paramI + 1, $param->var->name, $defaultValueType->describe($verbosityLevel), $parameterType->describe($verbosityLevel)))->line($param->getStartLine())->identifier('parameter.defaultValue')->acceptsReasonsTip($accepts->reasons)->build(); } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Functions; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\InFunctionNode; use PHPStan\Reflection\FunctionReflection; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\MissingTypehintCheck; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\MixedType; use PHPStan\Type\Type; use PHPStan\Type\VerbosityLevel; use function sprintf; /** * @implements Rule<InFunctionNode> */ final class MissingFunctionParameterTypehintRule implements Rule { /** * @var MissingTypehintCheck */ private $missingTypehintCheck; /** * @var bool */ private $paramOut; public function __construct(MissingTypehintCheck $missingTypehintCheck, bool $paramOut) { $this->missingTypehintCheck = $missingTypehintCheck; $this->paramOut = $paramOut; } public function getNodeType() : string { return InFunctionNode::class; } public function processNode(Node $node, Scope $scope) : array { $functionReflection = $node->getFunctionReflection(); $messages = []; foreach ($functionReflection->getParameters() as $parameterReflection) { foreach ($this->checkFunctionParameter($functionReflection, sprintf('parameter $%s', $parameterReflection->getName()), $parameterReflection->getType()) as $parameterMessage) { $messages[] = $parameterMessage; } if ($parameterReflection->getClosureThisType() !== null) { foreach ($this->checkFunctionParameter($functionReflection, sprintf('@param-closure-this PHPDoc tag for parameter $%s', $parameterReflection->getName()), $parameterReflection->getClosureThisType()) as $parameterMessage) { $messages[] = $parameterMessage; } } if (!$this->paramOut) { continue; } if ($parameterReflection->getOutType() === null) { continue; } foreach ($this->checkFunctionParameter($functionReflection, sprintf('@param-out PHPDoc tag for parameter $%s', $parameterReflection->getName()), $parameterReflection->getOutType()) as $parameterMessage) { $messages[] = $parameterMessage; } } return $messages; } /** * @return list<IdentifierRuleError> */ private function checkFunctionParameter(FunctionReflection $functionReflection, string $parameterMessage, Type $parameterType) : array { if ($parameterType instanceof MixedType && !$parameterType->isExplicitMixed()) { return [RuleErrorBuilder::message(sprintf('Function %s() has %s with no type specified.', $functionReflection->getName(), $parameterMessage))->identifier('missingType.parameter')->build()]; } $messages = []; foreach ($this->missingTypehintCheck->getIterableTypesWithMissingValueTypehint($parameterType) as $iterableType) { $iterableTypeDescription = $iterableType->describe(VerbosityLevel::typeOnly()); $messages[] = RuleErrorBuilder::message(sprintf('Function %s() has %s with no value type specified in iterable type %s.', $functionReflection->getName(), $parameterMessage, $iterableTypeDescription))->tip(MissingTypehintCheck::MISSING_ITERABLE_VALUE_TYPE_TIP)->identifier('missingType.iterableValue')->build(); } foreach ($this->missingTypehintCheck->getNonGenericObjectTypesWithGenericClass($parameterType) as [$name, $genericTypeNames]) { $messages[] = RuleErrorBuilder::message(sprintf('Function %s() has %s with generic %s but does not specify its types: %s', $functionReflection->getName(), $parameterMessage, $name, $genericTypeNames))->identifier('missingType.generics')->build(); } foreach ($this->missingTypehintCheck->getCallablesWithMissingSignature($parameterType) as $callableType) { $messages[] = RuleErrorBuilder::message(sprintf('Function %s() has %s with no signature specified for %s.', $functionReflection->getName(), $parameterMessage, $callableType->describe(VerbosityLevel::typeOnly())))->identifier('missingType.callable')->build(); } return $messages; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Functions; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function array_filter; use function array_map; use function in_array; use function is_string; use function sprintf; /** * @implements Rule<Node\Expr\Closure> */ final class InvalidLexicalVariablesInClosureUseRule implements Rule { public function getNodeType() : string { return Node\Expr\Closure::class; } /** * @param Node\Expr\Closure $node */ public function processNode(Node $node, Scope $scope) : array { $errors = []; $params = array_filter(array_map(static function (Node\Param $param) { if (!$param->var instanceof Node\Expr\Variable) { return \false; } if (!is_string($param->var->name)) { return \false; } return $param->var->name; }, $node->getParams()), static function ($name) { return $name !== \false; }); foreach ($node->uses as $use) { if (!is_string($use->var->name)) { continue; } $var = $use->var->name; if ($var === 'this') { $errors[] = RuleErrorBuilder::message('Cannot use $this as lexical variable.')->line($use->getStartLine())->identifier('closure.useThis')->nonIgnorable()->build(); continue; } if (in_array($var, Scope::SUPERGLOBAL_VARIABLES, \true)) { $errors[] = RuleErrorBuilder::message(sprintf('Cannot use superglobal variable $%s as lexical variable.', $var))->line($use->getStartLine())->identifier('closure.useSuperGlobal')->nonIgnorable()->build(); continue; } if (!in_array($var, $params, \true)) { continue; } $errors[] = RuleErrorBuilder::message(sprintf('Cannot use lexical variable $%s since a parameter with the same name already exists.', $var))->line($use->getStartLine())->identifier('closure.useDuplicate')->nonIgnorable()->build(); } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Functions; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Php\PhpVersion; use PHPStan\Rules\FunctionDefinitionCheck; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\NonAcceptingNeverType; use PHPStan\Type\ParserNodeTypeToPHPStanType; use function array_merge; /** * @implements Rule<Node\Expr\ArrowFunction> */ final class ExistingClassesInArrowFunctionTypehintsRule implements Rule { /** * @var FunctionDefinitionCheck */ private $check; /** * @var PhpVersion */ private $phpVersion; public function __construct(FunctionDefinitionCheck $check, PhpVersion $phpVersion) { $this->check = $check; $this->phpVersion = $phpVersion; } public function getNodeType() : string { return Node\Expr\ArrowFunction::class; } public function processNode(Node $node, Scope $scope) : array { $messages = []; if ($node->returnType !== null && !$this->phpVersion->supportsNeverReturnTypeInArrowFunction()) { $returnType = ParserNodeTypeToPHPStanType::resolve($node->returnType, $scope->isInClass() ? $scope->getClassReflection() : null); if ($returnType instanceof NonAcceptingNeverType) { $messages[] = RuleErrorBuilder::message('Never return type in arrow function is supported only on PHP 8.2 and later.')->identifier('return.neverTypeNotSupported')->nonIgnorable()->build(); } } return array_merge($messages, $this->check->checkAnonymousFunction($scope, $node->getParams(), $node->getReturnType(), 'Parameter $%s of anonymous function has invalid type %s.', 'Anonymous function has invalid return type %s.', 'Anonymous function uses native union types but they\'re supported only on PHP 8.0 and later.', 'Parameter $%s of anonymous function has unresolvable native type.', 'Anonymous function has unresolvable native return type.')); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Functions; use PhpParser\Node; use PHPStan\Analyser\NullsafeOperatorHelper; use PHPStan\Analyser\Scope; use PHPStan\Internal\SprintfHelper; use PHPStan\Reflection\InaccessibleMethod; use PHPStan\Reflection\ParametersAcceptorSelector; use PHPStan\Rules\FunctionCallParametersCheck; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Rules\RuleLevelHelper; use PHPStan\Type\ClosureType; use PHPStan\Type\ErrorType; use PHPStan\Type\Type; use PHPStan\Type\VerbosityLevel; use function array_merge; use function count; use function sprintf; use function ucfirst; /** * @implements Rule<Node\Expr\FuncCall> */ final class CallCallablesRule implements Rule { /** * @var FunctionCallParametersCheck */ private $check; /** * @var RuleLevelHelper */ private $ruleLevelHelper; /** * @var bool */ private $reportMaybes; public function __construct(FunctionCallParametersCheck $check, RuleLevelHelper $ruleLevelHelper, bool $reportMaybes) { $this->check = $check; $this->ruleLevelHelper = $ruleLevelHelper; $this->reportMaybes = $reportMaybes; } public function getNodeType() : string { return Node\Expr\FuncCall::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->name instanceof Node\Expr) { return []; } $typeResult = $this->ruleLevelHelper->findTypeToCheck($scope, NullsafeOperatorHelper::getNullsafeShortcircuitedExprRespectingScope($scope, $node->name), 'Invoking callable on an unknown class %s.', static function (Type $type) : bool { return $type->isCallable()->yes(); }); $type = $typeResult->getType(); if ($type instanceof ErrorType) { return $typeResult->getUnknownClassErrors(); } $isCallable = $type->isCallable(); if ($isCallable->no()) { return [RuleErrorBuilder::message(sprintf('Trying to invoke %s but it\'s not a callable.', $type->describe(VerbosityLevel::value())))->identifier('callable.nonCallable')->build()]; } if ($this->reportMaybes && $isCallable->maybe()) { return [RuleErrorBuilder::message(sprintf('Trying to invoke %s but it might not be a callable.', $type->describe(VerbosityLevel::value())))->identifier('callable.nonCallable')->build()]; } $parametersAcceptors = $type->getCallableParametersAcceptors($scope); $messages = []; $acceptsNamedArguments = \true; foreach ($parametersAcceptors as $parametersAcceptor) { $acceptsNamedArguments = $acceptsNamedArguments && $parametersAcceptor->acceptsNamedArguments(); } if (count($parametersAcceptors) === 1 && $parametersAcceptors[0] instanceof InaccessibleMethod) { $method = $parametersAcceptors[0]->getMethod(); $messages[] = RuleErrorBuilder::message(sprintf('Call to %s method %s() of class %s.', $method->isPrivate() ? 'private' : 'protected', $method->getName(), $method->getDeclaringClass()->getDisplayName()))->identifier('callable.inaccessibleMethod')->build(); } $parametersAcceptor = ParametersAcceptorSelector::selectFromArgs($scope, $node->getArgs(), $parametersAcceptors, null); if ($type instanceof ClosureType) { $callableDescription = 'closure'; } else { $callableDescription = sprintf('callable %s', SprintfHelper::escapeFormatString($type->describe(VerbosityLevel::value()))); } return array_merge($messages, $this->check->check($parametersAcceptor, $scope, \false, $node, [ucfirst($callableDescription) . ' invoked with %d parameter, %d required.', ucfirst($callableDescription) . ' invoked with %d parameters, %d required.', ucfirst($callableDescription) . ' invoked with %d parameter, at least %d required.', ucfirst($callableDescription) . ' invoked with %d parameters, at least %d required.', ucfirst($callableDescription) . ' invoked with %d parameter, %d-%d required.', ucfirst($callableDescription) . ' invoked with %d parameters, %d-%d required.', 'Parameter %s of ' . $callableDescription . ' expects %s, %s given.', 'Result of ' . $callableDescription . ' (void) is used.', 'Parameter %s of ' . $callableDescription . ' is passed by reference, so it expects variables only.', 'Unable to resolve the template type %s in call to ' . $callableDescription, 'Missing parameter $%s in call to ' . $callableDescription . '.', 'Unknown parameter $%s in call to ' . $callableDescription . '.', 'Return type of call to ' . $callableDescription . ' contains unresolvable type.', 'Parameter %s of ' . $callableDescription . ' contains unresolvable type.', ucfirst($callableDescription) . ' invoked with %s, but it\'s not allowed because of @no-named-arguments.'], 'callable', $acceptsNamedArguments)); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Functions; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\ReturnStatementsNode; use PHPStan\Rules\NullsafeCheck; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; /** * @implements Rule<ReturnStatementsNode> */ final class ReturnNullsafeByRefRule implements Rule { /** * @var NullsafeCheck */ private $nullsafeCheck; public function __construct(NullsafeCheck $nullsafeCheck) { $this->nullsafeCheck = $nullsafeCheck; } public function getNodeType() : string { return ReturnStatementsNode::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->returnsByRef()) { return []; } $errors = []; foreach ($node->getReturnStatements() as $returnStatement) { $returnNode = $returnStatement->getReturnNode(); if ($returnNode->expr === null) { continue; } if (!$this->nullsafeCheck->containsNullSafe($returnNode->expr)) { continue; } $errors[] = RuleErrorBuilder::message('Nullsafe cannot be returned by reference.')->line($returnNode->getStartLine())->identifier('nullsafe.byRef')->nonIgnorable()->build(); } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Functions; use _PHPStan_7d8742a37\Nette\Utils\Strings; use PHPStan\Php\PhpVersion; use function array_filter; use function count; use function max; use function sprintf; use function strlen; use const PREG_SET_ORDER; final class PrintfHelper { /** * @var PhpVersion */ private $phpVersion; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; } public function getPrintfPlaceholdersCount(string $format) : int { return $this->getPlaceholdersCount('(?:[bs%s]|l?[cdeEgfFGouxX])', $format); } public function getScanfPlaceholdersCount(string $format) : int { return $this->getPlaceholdersCount('(?:[cdDeEfinosuxX%s]|\\[[^\\]]+\\])', $format); } private function getPlaceholdersCount(string $specifiersPattern, string $format) : int { $addSpecifier = ''; if ($this->phpVersion->supportsHhPrintfSpecifier()) { $addSpecifier .= 'hH'; } $specifiers = sprintf($specifiersPattern, $addSpecifier); $pattern = '~(?<before>%*)%(?:(?<position>\\d+)\\$)?[-+]?(?:[ 0]|(?:\'[^%]))?(?<width>\\*)?-?\\d*(?:\\.(?:\\d+|(?<precision>\\*))?)?' . $specifiers . '~'; $matches = Strings::matchAll($format, $pattern, PREG_SET_ORDER); if (count($matches) === 0) { return 0; } $placeholders = array_filter($matches, static function (array $match) : bool { return strlen($match['before']) % 2 === 0; }); if (count($placeholders) === 0) { return 0; } $maxPositionedNumber = 0; $maxOrdinaryNumber = 0; foreach ($placeholders as $placeholder) { if (isset($placeholder['width']) && $placeholder['width'] !== '') { $maxOrdinaryNumber++; } if (isset($placeholder['precision']) && $placeholder['precision'] !== '') { $maxOrdinaryNumber++; } if (isset($placeholder['position']) && $placeholder['position'] !== '') { $maxPositionedNumber = max((int) $placeholder['position'], $maxPositionedNumber); } else { $maxOrdinaryNumber++; } } return max($maxPositionedNumber, $maxOrdinaryNumber); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Functions; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\UnusedFunctionParametersCheck; use PHPStan\ShouldNotHappenException; use function array_map; use function count; use function is_string; /** * @implements Rule<Node\Expr\Closure> */ final class UnusedClosureUsesRule implements Rule { /** * @var UnusedFunctionParametersCheck */ private $check; public function __construct(UnusedFunctionParametersCheck $check) { $this->check = $check; } public function getNodeType() : string { return Node\Expr\Closure::class; } public function processNode(Node $node, Scope $scope) : array { if (count($node->uses) === 0) { return []; } return $this->check->getUnusedParameters($scope, array_map(static function (Node\Expr\ClosureUse $use) : string { if (!is_string($use->var->name)) { throw new ShouldNotHappenException(); } return $use->var->name; }, $node->uses), $node->stmts, 'Anonymous function has an unused use $%s.', 'closure.unusedUse'); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Functions; use PhpParser\Node; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function array_key_exists; use function count; use function in_array; use function sprintf; /** * @implements Rule<Node\Expr\FuncCall> */ final class PrintfParametersRule implements Rule { /** * @var PrintfHelper */ private $printfHelper; /** * @var ReflectionProvider */ private $reflectionProvider; private const FORMAT_ARGUMENT_POSITIONS = ['printf' => 0, 'sprintf' => 0, 'sscanf' => 1, 'fscanf' => 1]; private const MINIMUM_NUMBER_OF_ARGUMENTS = ['printf' => 1, 'sprintf' => 1, 'sscanf' => 3, 'fscanf' => 3]; public function __construct(\PHPStan\Rules\Functions\PrintfHelper $printfHelper, ReflectionProvider $reflectionProvider) { $this->printfHelper = $printfHelper; $this->reflectionProvider = $reflectionProvider; } public function getNodeType() : string { return FuncCall::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->name instanceof Node\Name) { return []; } if (!$this->reflectionProvider->hasFunction($node->name, $scope)) { return []; } $functionReflection = $this->reflectionProvider->getFunction($node->name, $scope); $name = $functionReflection->getName(); if (!array_key_exists($name, self::FORMAT_ARGUMENT_POSITIONS)) { return []; } $formatArgumentPosition = self::FORMAT_ARGUMENT_POSITIONS[$name]; $args = $node->getArgs(); foreach ($args as $arg) { if ($arg->unpack) { return []; } } $argsCount = count($args); if ($argsCount < self::MINIMUM_NUMBER_OF_ARGUMENTS[$name]) { return []; // caught by CallToFunctionParametersRule } $formatArgType = $scope->getType($args[$formatArgumentPosition]->value); $maxPlaceHoldersCount = null; foreach ($formatArgType->getConstantStrings() as $formatString) { $format = $formatString->getValue(); if (in_array($name, ['sprintf', 'printf'], \true)) { $tempPlaceHoldersCount = $this->printfHelper->getPrintfPlaceholdersCount($format); } else { $tempPlaceHoldersCount = $this->printfHelper->getScanfPlaceholdersCount($format); } if ($maxPlaceHoldersCount === null) { $maxPlaceHoldersCount = $tempPlaceHoldersCount; } elseif ($tempPlaceHoldersCount > $maxPlaceHoldersCount) { $maxPlaceHoldersCount = $tempPlaceHoldersCount; } } if ($maxPlaceHoldersCount === null) { return []; } $argsCount -= $formatArgumentPosition; if ($argsCount !== $maxPlaceHoldersCount + 1) { return [RuleErrorBuilder::message(sprintf(sprintf('%s, %s.', $maxPlaceHoldersCount === 1 ? 'Call to %s contains %d placeholder' : 'Call to %s contains %d placeholders', $argsCount - 1 === 1 ? '%d value given' : '%d values given'), $name, $maxPlaceHoldersCount, $argsCount - 1))->identifier(sprintf('argument.%s', $name))->build()]; } return []; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Functions; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\ClosureReturnStatementsNode; use PHPStan\Rules\FunctionReturnTypeCheck; use PHPStan\Rules\Rule; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; /** * @implements Rule<ClosureReturnStatementsNode> */ final class ClosureReturnTypeRule implements Rule { /** * @var FunctionReturnTypeCheck */ private $returnTypeCheck; public function __construct(FunctionReturnTypeCheck $returnTypeCheck) { $this->returnTypeCheck = $returnTypeCheck; } public function getNodeType() : string { return ClosureReturnStatementsNode::class; } public function processNode(Node $node, Scope $scope) : array { if (!$scope->isInAnonymousFunction()) { return []; } /** @var Type $returnType */ $returnType = $scope->getAnonymousFunctionReturnType(); $containsNull = TypeCombinator::containsNull($returnType); $hasNativeTypehint = $node->getClosureExpr()->returnType !== null; $messages = []; foreach ($node->getReturnStatements() as $returnStatement) { $returnNode = $returnStatement->getReturnNode(); $returnExpr = $returnNode->expr; if ($returnExpr === null && $containsNull && !$hasNativeTypehint) { $returnExpr = new Node\Expr\ConstFetch(new Node\Name\FullyQualified('null')); } $returnMessages = $this->returnTypeCheck->checkReturnType($returnStatement->getScope(), $returnType, $returnExpr, $returnNode, 'Anonymous function should return %s but empty return statement found.', 'Anonymous function with return type void returns %s but should not return anything.', 'Anonymous function should return %s but returns %s.', 'Anonymous function should never return but return statement found.', $node->isGenerator()); foreach ($returnMessages as $returnMessage) { $messages[] = $returnMessage; } } return $messages; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Functions; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\InFunctionNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\ShouldNotHappenException; use PHPStan\Type\Generic\TemplateTypeHelper; use PHPStan\Type\VerbosityLevel; use function is_string; use function sprintf; /** * @implements Rule<InFunctionNode> */ final class IncompatibleDefaultParameterTypeRule implements Rule { public function getNodeType() : string { return InFunctionNode::class; } public function processNode(Node $node, Scope $scope) : array { $function = $node->getFunctionReflection(); $errors = []; foreach ($node->getOriginalNode()->getParams() as $paramI => $param) { if ($param->default === null) { continue; } if ($param->var instanceof Node\Expr\Error || !is_string($param->var->name)) { throw new ShouldNotHappenException(); } $defaultValueType = $scope->getType($param->default); $parameterType = $function->getParameters()[$paramI]->getType(); $parameterType = TemplateTypeHelper::resolveToBounds($parameterType); $accepts = $parameterType->acceptsWithReason($defaultValueType, \true); if ($accepts->yes()) { continue; } $verbosityLevel = VerbosityLevel::getRecommendedLevelByType($parameterType, $defaultValueType); $errors[] = RuleErrorBuilder::message(sprintf('Default value of the parameter #%d $%s (%s) of function %s() is incompatible with type %s.', $paramI + 1, $param->var->name, $defaultValueType->describe($verbosityLevel), $function->getName(), $parameterType->describe($verbosityLevel)))->line($param->getStartLine())->identifier('parameter.defaultValue')->acceptsReasonsTip($accepts->reasons)->build(); } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Functions; use PhpParser\Node; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\ShouldNotHappenException; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\IntegerRangeType; use PHPStan\Type\IntegerType; use PHPStan\Type\TypeCombinator; use function count; use function in_array; use function max; use function min; use function sprintf; /** * @implements Rule<Node\Expr\FuncCall> */ final class PrintfArrayParametersRule implements Rule { /** * @var PrintfHelper */ private $printfHelper; /** * @var ReflectionProvider */ private $reflectionProvider; public function __construct(\PHPStan\Rules\Functions\PrintfHelper $printfHelper, ReflectionProvider $reflectionProvider) { $this->printfHelper = $printfHelper; $this->reflectionProvider = $reflectionProvider; } public function getNodeType() : string { return FuncCall::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->name instanceof Node\Name) { return []; } if (!$this->reflectionProvider->hasFunction($node->name, $scope)) { return []; } $functionReflection = $this->reflectionProvider->getFunction($node->name, $scope); $name = $functionReflection->getName(); if (!in_array($name, ['vprintf', 'vsprintf'], \true)) { return []; } $args = $node->getArgs(); $argsCount = count($args); if ($argsCount < 1) { return []; // caught by CallToFunctionParametersRule } $formatArgType = $scope->getType($args[0]->value); $placeHoldersCounts = []; foreach ($formatArgType->getConstantStrings() as $formatString) { $format = $formatString->getValue(); $placeHoldersCounts[] = $this->printfHelper->getPrintfPlaceholdersCount($format); } if ($placeHoldersCounts === []) { return []; } $minCount = min($placeHoldersCounts); $maxCount = max($placeHoldersCounts); if ($minCount === $maxCount) { $placeHoldersCount = new ConstantIntegerType($minCount); } else { $placeHoldersCount = IntegerRangeType::fromInterval($minCount, $maxCount); if (!$placeHoldersCount instanceof IntegerRangeType && !$placeHoldersCount instanceof ConstantIntegerType) { return []; } } $formatArgsCounts = []; if (isset($args[1])) { $formatArgsType = $scope->getType($args[1]->value); $constantArrays = $formatArgsType->getConstantArrays(); if ($constantArrays === []) { $formatArgsCounts[] = new IntegerType(); } foreach ($constantArrays as $constantArray) { $formatArgsCounts[] = $constantArray->getArraySize(); } } if ($formatArgsCounts === []) { $formatArgsCount = new ConstantIntegerType(0); } else { $formatArgsCount = TypeCombinator::union(...$formatArgsCounts); if (!$formatArgsCount instanceof IntegerRangeType && !$formatArgsCount instanceof ConstantIntegerType) { return []; } } if (!$this->placeholdersMatchesArgsCount($placeHoldersCount, $formatArgsCount)) { if ($placeHoldersCount instanceof IntegerRangeType) { $placeholders = $this->getIntegerRangeAsString($placeHoldersCount); $singlePlaceholder = \false; } else { $placeholders = $placeHoldersCount->getValue(); $singlePlaceholder = $placeholders === 1; } if ($formatArgsCount instanceof IntegerRangeType) { $values = $this->getIntegerRangeAsString($formatArgsCount); $singleValue = \false; } else { $values = $formatArgsCount->getValue(); $singleValue = $values === 1; } return [RuleErrorBuilder::message(sprintf(sprintf('%s, %s.', $singlePlaceholder ? 'Call to %s contains %d placeholder' : 'Call to %s contains %s placeholders', $singleValue ? '%d value given' : '%s values given'), $name, $placeholders, $values))->identifier(sprintf('argument.%s', $name))->build()]; } return []; } /** * @param ConstantIntegerType|IntegerRangeType $placeHoldersCount * @param ConstantIntegerType|IntegerRangeType $formatArgsCount */ private function placeholdersMatchesArgsCount($placeHoldersCount, $formatArgsCount) : bool { if ($placeHoldersCount instanceof ConstantIntegerType) { if ($formatArgsCount instanceof ConstantIntegerType) { return $placeHoldersCount->getValue() === $formatArgsCount->getValue(); } // Zero placeholders + array if ($placeHoldersCount->getValue() === 0) { return \true; } return \false; } if ($formatArgsCount instanceof IntegerRangeType && IntegerRangeType::fromInterval(1, null)->isSuperTypeOf($placeHoldersCount)->yes()) { if ($formatArgsCount->getMin() !== null && $formatArgsCount->getMax() !== null) { // constant array return $placeHoldersCount->isSuperTypeOf($formatArgsCount)->yes(); } // general array return IntegerRangeType::fromInterval(1, null)->isSuperTypeOf($formatArgsCount)->yes(); } return \false; } private function getIntegerRangeAsString(IntegerRangeType $range) : string { if ($range->getMin() !== null && $range->getMax() !== null) { return $range->getMin() . '-' . $range->getMax(); } elseif ($range->getMin() !== null) { return $range->getMin() . ' or more'; } elseif ($range->getMax() !== null) { return $range->getMax() . ' or less'; } throw new ShouldNotHappenException(); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Functions; use PhpParser\Node; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Internal\SprintfHelper; use PHPStan\Reflection\ParametersAcceptorSelector; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\FunctionCallParametersCheck; use PHPStan\Rules\Rule; /** * @implements Rule<Node\Expr\FuncCall> */ final class CallToFunctionParametersRule implements Rule { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var FunctionCallParametersCheck */ private $check; public function __construct(ReflectionProvider $reflectionProvider, FunctionCallParametersCheck $check) { $this->reflectionProvider = $reflectionProvider; $this->check = $check; } public function getNodeType() : string { return FuncCall::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->name instanceof Node\Name) { return []; } if (!$this->reflectionProvider->hasFunction($node->name, $scope)) { return []; } $function = $this->reflectionProvider->getFunction($node->name, $scope); $functionName = SprintfHelper::escapeFormatString($function->getName()); return $this->check->check(ParametersAcceptorSelector::selectFromArgs($scope, $node->getArgs(), $function->getVariants(), $function->getNamedArgumentsVariants()), $scope, $function->isBuiltin(), $node, ['Function ' . $functionName . ' invoked with %d parameter, %d required.', 'Function ' . $functionName . ' invoked with %d parameters, %d required.', 'Function ' . $functionName . ' invoked with %d parameter, at least %d required.', 'Function ' . $functionName . ' invoked with %d parameters, at least %d required.', 'Function ' . $functionName . ' invoked with %d parameter, %d-%d required.', 'Function ' . $functionName . ' invoked with %d parameters, %d-%d required.', 'Parameter %s of function ' . $functionName . ' expects %s, %s given.', 'Result of function ' . $functionName . ' (void) is used.', 'Parameter %s of function ' . $functionName . ' is passed by reference, so it expects variables only.', 'Unable to resolve the template type %s in call to function ' . $functionName, 'Missing parameter $%s in call to function ' . $functionName . '.', 'Unknown parameter $%s in call to function ' . $functionName . '.', 'Return type of call to function ' . $functionName . ' contains unresolvable type.', 'Parameter %s of function ' . $functionName . ' contains unresolvable type.', 'Function ' . $functionName . ' invoked with %s, but it\'s not allowed because of @no-named-arguments.'], 'function', $function->acceptsNamedArguments()); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Functions; use PhpParser\Node; use PhpParser\Node\Arg; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\NeverType; use PHPStan\Type\Type; use function in_array; use function sprintf; /** * @implements Rule<Node\Stmt\Expression> */ final class CallToFunctionStatementWithoutSideEffectsRule implements Rule { /** * @var ReflectionProvider */ private $reflectionProvider; private const SIDE_EFFECT_FLIP_PARAMETERS = [ // functionName => [name, pos, testName] 'print_r' => ['return', 1, 'isTruthy'], 'var_export' => ['return', 1, 'isTruthy'], 'highlight_string' => ['return', 1, 'isTruthy'], ]; public const PHPSTAN_TESTING_FUNCTIONS = ['PHPStan\\dumpType', 'PHPStan\\dumpPhpDocType', 'PHPStan\\debugScope', 'PHPStan\\Testing\\assertType', 'PHPStan\\Testing\\assertNativeType', 'PHPStan\\Testing\\assertVariableCertainty']; public function __construct(ReflectionProvider $reflectionProvider) { $this->reflectionProvider = $reflectionProvider; } public function getNodeType() : string { return Node\Stmt\Expression::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->expr instanceof Node\Expr\FuncCall) { return []; } $funcCall = $node->expr; if (!$funcCall->name instanceof Node\Name) { return []; } if (!$this->reflectionProvider->hasFunction($funcCall->name, $scope)) { return []; } $function = $this->reflectionProvider->getFunction($funcCall->name, $scope); $functionName = $function->getName(); $functionHasSideEffects = !$function->hasSideEffects()->no(); if (in_array($functionName, self::PHPSTAN_TESTING_FUNCTIONS, \true)) { return []; } if (isset(self::SIDE_EFFECT_FLIP_PARAMETERS[$functionName])) { [$flipParameterName, $flipParameterPosition, $testName] = self::SIDE_EFFECT_FLIP_PARAMETERS[$functionName]; $sideEffectFlipped = \false; $hasNamedParameter = \false; $checker = ['isNotNull' => static function (Type $type) { return $type->isNull()->no(); }, 'isTruthy' => static function (Type $type) { return $type->toBoolean()->isTrue()->yes(); }][$testName]; foreach ($funcCall->getRawArgs() as $i => $arg) { if (!$arg instanceof Arg) { return []; } $isFlipParameter = \false; if ($arg->name !== null) { $hasNamedParameter = \true; if ($arg->name->name === $flipParameterName) { $isFlipParameter = \true; } } if (!$hasNamedParameter && $i === $flipParameterPosition) { $isFlipParameter = \true; } if ($isFlipParameter) { $sideEffectFlipped = $checker($scope->getType($arg->value)); break; } } if (!$sideEffectFlipped) { return []; } $functionHasSideEffects = \false; } if (!$functionHasSideEffects || $node->expr->isFirstClassCallable()) { if (!$node->expr->isFirstClassCallable()) { $throwsType = $function->getThrowType(); if ($throwsType !== null && !$throwsType->isVoid()->yes()) { return []; } } $functionResult = $scope->getType($funcCall); if ($functionResult instanceof NeverType && $functionResult->isExplicit()) { return []; } return [RuleErrorBuilder::message(sprintf('Call to function %s() on a separate line has no effect.', $function->getName()))->identifier('function.resultUnused')->build()]; } return []; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Functions; use PhpParser\Node; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\ArgumentsNormalizer; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ParametersAcceptorSelector; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\ParameterCastableToStringCheck; use PHPStan\Rules\Rule; use PHPStan\Type\Type; use function array_key_exists; use function count; use function in_array; use function sprintf; /** * @implements Rule<Node\Expr\FuncCall> */ final class ImplodeParameterCastableToStringRule implements Rule { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var ParameterCastableToStringCheck */ private $parameterCastableToStringCheck; public function __construct(ReflectionProvider $reflectionProvider, ParameterCastableToStringCheck $parameterCastableToStringCheck) { $this->reflectionProvider = $reflectionProvider; $this->parameterCastableToStringCheck = $parameterCastableToStringCheck; } public function getNodeType() : string { return FuncCall::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->name instanceof Node\Name) { return []; } if (!$this->reflectionProvider->hasFunction($node->name, $scope)) { return []; } $functionReflection = $this->reflectionProvider->getFunction($node->name, $scope); $functionName = $functionReflection->getName(); if (!in_array($functionName, ['implode', 'join'], \true)) { return []; } $origArgs = $node->getArgs(); $parametersAcceptor = ParametersAcceptorSelector::selectFromArgs($scope, $origArgs, $functionReflection->getVariants(), $functionReflection->getNamedArgumentsVariants()); $normalizedFuncCall = ArgumentsNormalizer::reorderFuncArguments($parametersAcceptor, $node); if ($normalizedFuncCall === null) { return []; } $normalizedArgs = $normalizedFuncCall->getArgs(); $errorMessage = 'Parameter %s of function %s expects array<string>, %s given.'; if (count($normalizedArgs) === 1) { $argsToCheck = [0 => $normalizedArgs[0]]; } elseif (count($normalizedArgs) === 2) { $argsToCheck = [1 => $normalizedArgs[1]]; } else { return []; } $origNamedArgs = []; foreach ($origArgs as $arg) { if ($arg->unpack || $arg->name === null) { continue; } $origNamedArgs[$arg->name->toString()] = $arg; } $errors = []; foreach ($argsToCheck as $argIdx => $arg) { // implode has weird variants, so $array has to be fixed. It's especially weird with named arguments. if (array_key_exists('array', $origNamedArgs)) { $argName = '$array'; } elseif (array_key_exists('separator', $origNamedArgs) && count($origArgs) === 1) { $argName = '$separator'; } else { $argName = sprintf('#%d $array', $argIdx + 1); } $error = $this->parameterCastableToStringCheck->checkParameter($arg, $scope, $errorMessage, static function (Type $t) { return $t->toString(); }, $functionName, $argName); if ($error === null) { continue; } $errors[] = $error; } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Functions; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\InArrowFunctionNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\ShouldNotHappenException; use PHPStan\Type\Generic\TemplateTypeHelper; use PHPStan\Type\VerbosityLevel; use function is_string; use function sprintf; /** * @implements Rule<InArrowFunctionNode> */ final class IncompatibleArrowFunctionDefaultParameterTypeRule implements Rule { public function getNodeType() : string { return InArrowFunctionNode::class; } public function processNode(Node $node, Scope $scope) : array { $parameters = $node->getClosureType()->getParameters(); $errors = []; foreach ($node->getOriginalNode()->getParams() as $paramI => $param) { if ($param->default === null) { continue; } if ($param->var instanceof Node\Expr\Error || !is_string($param->var->name)) { throw new ShouldNotHappenException(); } $defaultValueType = $scope->getType($param->default); $parameterType = $parameters[$paramI]->getType(); $parameterType = TemplateTypeHelper::resolveToBounds($parameterType); $accepts = $parameterType->acceptsWithReason($defaultValueType, \true); if ($accepts->yes()) { continue; } $verbosityLevel = VerbosityLevel::getRecommendedLevelByType($parameterType, $defaultValueType); $errors[] = RuleErrorBuilder::message(sprintf('Default value of the parameter #%d $%s (%s) of anonymous function is incompatible with type %s.', $paramI + 1, $param->var->name, $defaultValueType->describe($verbosityLevel), $parameterType->describe($verbosityLevel)))->line($param->getStartLine())->identifier('parameter.defaultValue')->acceptsReasonsTip($accepts->reasons)->build(); } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Functions; use PhpParser\Node; use PhpParser\Node\Stmt\Function_; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; /** * @implements Rule<Node\Stmt\Function_> */ final class InnerFunctionRule implements Rule { public function getNodeType() : string { return Function_::class; } public function processNode(Node $node, Scope $scope) : array { if ($scope->getFunction() === null) { return []; } return [RuleErrorBuilder::message('Inner named functions are not supported by PHPStan. Consider refactoring to an anonymous function, class method, or a top-level-defined function. See issue #165 (https://github.com/phpstan/phpstan/issues/165) for more details.')->identifier('function.inner')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Functions; use PhpParser\Node; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\ArgumentsNormalizer; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\FunctionCallParametersCheck; use PHPStan\Rules\Rule; use function count; use function ucfirst; /** * @implements Rule<FuncCall> */ final class CallUserFuncRule implements Rule { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var FunctionCallParametersCheck */ private $check; public function __construct(ReflectionProvider $reflectionProvider, FunctionCallParametersCheck $check) { $this->reflectionProvider = $reflectionProvider; $this->check = $check; } public function getNodeType() : string { return FuncCall::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->name instanceof Node\Name) { return []; } if (count($node->getArgs()) === 0) { return []; } if (!$this->reflectionProvider->hasFunction($node->name, $scope)) { return []; } $functionReflection = $this->reflectionProvider->getFunction($node->name, $scope); if ($functionReflection->getName() !== 'call_user_func') { return []; } $result = ArgumentsNormalizer::reorderCallUserFuncArguments($node, $scope); if ($result === null) { return []; } [$parametersAcceptor, $funcCall, $acceptsNamedArguments] = $result; $callableDescription = 'callable passed to call_user_func()'; return $this->check->check($parametersAcceptor, $scope, \false, $funcCall, [ucfirst($callableDescription) . ' invoked with %d parameter, %d required.', ucfirst($callableDescription) . ' invoked with %d parameters, %d required.', ucfirst($callableDescription) . ' invoked with %d parameter, at least %d required.', ucfirst($callableDescription) . ' invoked with %d parameters, at least %d required.', ucfirst($callableDescription) . ' invoked with %d parameter, %d-%d required.', ucfirst($callableDescription) . ' invoked with %d parameters, %d-%d required.', 'Parameter %s of ' . $callableDescription . ' expects %s, %s given.', 'Result of ' . $callableDescription . ' (void) is used.', 'Parameter %s of ' . $callableDescription . ' is passed by reference, so it expects variables only.', 'Unable to resolve the template type %s in call to ' . $callableDescription, 'Missing parameter $%s in call to ' . $callableDescription . '.', 'Unknown parameter $%s in call to ' . $callableDescription . '.', 'Return type of call to ' . $callableDescription . ' contains unresolvable type.', 'Parameter %s of ' . $callableDescription . ' contains unresolvable type.', ucfirst($callableDescription) . ' invoked with %s, but it\'s not allowed because of @no-named-arguments.'], 'function', $acceptsNamedArguments); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Functions; use PhpParser\Node; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Php\PhpVersion; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function count; use function strtolower; /** * @implements Rule<Node\Expr\FuncCall> */ final class DefineParametersRule implements Rule { /** * @var PhpVersion */ private $phpVersion; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; } public function getNodeType() : string { return FuncCall::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->name instanceof Node\Name) { return []; } if ($this->phpVersion->supportsCaseInsensitiveConstantNames()) { return []; } $name = strtolower((string) $node->name); if ($name !== 'define') { return []; } $args = $node->getArgs(); $argsCount = count($args); // Expects 2 or 3, 1 arg is caught by CallToFunctionParametersRule if ($argsCount < 3) { return []; } return [RuleErrorBuilder::message('Argument #3 ($case_insensitive) is ignored since declaration of case-insensitive constants is no longer supported.')->line($node->getStartLine())->identifier('argument.unused')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Functions; use PhpParser\Node; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Rules\RuleLevelHelper; use PHPStan\Type\ErrorType; use PHPStan\Type\Type; use PHPStan\Type\VerbosityLevel; use function count; use function in_array; use function sprintf; /** * @deprecated Replaced by PHPStan\Rules\Functions\ImplodeParameterCastableToStringRuleTest * @implements Rule<Node\Expr\FuncCall> */ final class ImplodeFunctionRule implements Rule { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var RuleLevelHelper */ private $ruleLevelHelper; /** * @var bool */ private $disabled; public function __construct(ReflectionProvider $reflectionProvider, RuleLevelHelper $ruleLevelHelper, bool $disabled) { $this->reflectionProvider = $reflectionProvider; $this->ruleLevelHelper = $ruleLevelHelper; $this->disabled = $disabled; } public function getNodeType() : string { return FuncCall::class; } public function processNode(Node $node, Scope $scope) : array { if ($this->disabled) { return []; } if (!$node->name instanceof Node\Name) { return []; } $functionName = $this->reflectionProvider->resolveFunctionName($node->name, $scope); if (!in_array($functionName, ['implode', 'join'], \true)) { return []; } $args = $node->getArgs(); if (count($args) === 1) { $arrayArg = $args[0]->value; $paramNo = 1; } elseif (count($args) === 2) { $arrayArg = $args[1]->value; $paramNo = 2; } else { return []; } $typeResult = $this->ruleLevelHelper->findTypeToCheck($scope, $arrayArg, '', static function (Type $type) : bool { return !$type->getIterableValueType()->toString() instanceof ErrorType; }); if ($typeResult->getType() instanceof ErrorType || !$typeResult->getType()->getIterableValueType()->toString() instanceof ErrorType) { return []; } return [RuleErrorBuilder::message(sprintf('Parameter #%d $array of function %s expects array<string>, %s given.', $paramNo, $functionName, $typeResult->getType()->describe(VerbosityLevel::typeOnly())))->identifier('argument.type')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Functions; use PhpParser\Node; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\ArgumentsNormalizer; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ParametersAcceptorSelector; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\ParameterCastableToStringCheck; use PHPStan\Rules\Rule; use PHPStan\Type\Type; use function array_key_exists; use function in_array; /** * @implements Rule<Node\Expr\FuncCall> */ final class ParameterCastableToStringRule implements Rule { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var ParameterCastableToStringCheck */ private $parameterCastableToStringCheck; public function __construct(ReflectionProvider $reflectionProvider, ParameterCastableToStringCheck $parameterCastableToStringCheck) { $this->reflectionProvider = $reflectionProvider; $this->parameterCastableToStringCheck = $parameterCastableToStringCheck; } public function getNodeType() : string { return FuncCall::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->name instanceof Node\Name) { return []; } if (!$this->reflectionProvider->hasFunction($node->name, $scope)) { return []; } $functionReflection = $this->reflectionProvider->getFunction($node->name, $scope); $functionName = $functionReflection->getName(); $checkAllArgsFunctions = ['array_intersect', 'array_intersect_assoc', 'array_diff', 'array_diff_assoc']; $checkFirstArgFunctions = ['array_combine', 'natcasesort', 'natsort', 'array_count_values', 'array_fill_keys']; if (!in_array($functionName, $checkAllArgsFunctions, \true) && !in_array($functionName, $checkFirstArgFunctions, \true)) { return []; } $origArgs = $node->getArgs(); $parametersAcceptor = ParametersAcceptorSelector::selectFromArgs($scope, $origArgs, $functionReflection->getVariants(), $functionReflection->getNamedArgumentsVariants()); $errorMessage = 'Parameter %s of function %s expects an array of values castable to string, %s given.'; $functionParameters = $parametersAcceptor->getParameters(); if (in_array($functionName, $checkAllArgsFunctions, \true)) { $argsToCheck = $origArgs; } elseif (in_array($functionName, $checkFirstArgFunctions, \true)) { $normalizedFuncCall = ArgumentsNormalizer::reorderFuncArguments($parametersAcceptor, $node); if ($normalizedFuncCall === null) { return []; } $normalizedArgs = $normalizedFuncCall->getArgs(); if (!array_key_exists(0, $normalizedArgs)) { return []; } $argsToCheck = [0 => $normalizedArgs[0]]; } else { return []; } $errors = []; foreach ($argsToCheck as $argIdx => $arg) { $error = $this->parameterCastableToStringCheck->checkParameter($arg, $scope, $errorMessage, static function (Type $t) { return $t->toString(); }, $functionName, $this->parameterCastableToStringCheck->getParameterName($arg, $argIdx, $functionParameters[$argIdx] ?? null)); if ($error === null) { continue; } $errors[] = $error; } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Functions; use PhpParser\Node; use PHPStan\Analyser\NullsafeOperatorHelper; use PHPStan\Analyser\Scope; use PHPStan\Node\FunctionCallableNode; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Rules\RuleLevelHelper; use PHPStan\Type\ErrorType; use PHPStan\Type\Type; use PHPStan\Type\VerbosityLevel; use function sprintf; use function strtolower; /** * @implements Rule<FunctionCallableNode> */ final class FunctionCallableRule implements Rule { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var RuleLevelHelper */ private $ruleLevelHelper; /** * @var PhpVersion */ private $phpVersion; /** * @var bool */ private $checkFunctionNameCase; /** * @var bool */ private $reportMaybes; public function __construct(ReflectionProvider $reflectionProvider, RuleLevelHelper $ruleLevelHelper, PhpVersion $phpVersion, bool $checkFunctionNameCase, bool $reportMaybes) { $this->reflectionProvider = $reflectionProvider; $this->ruleLevelHelper = $ruleLevelHelper; $this->phpVersion = $phpVersion; $this->checkFunctionNameCase = $checkFunctionNameCase; $this->reportMaybes = $reportMaybes; } public function getNodeType() : string { return FunctionCallableNode::class; } public function processNode(Node $node, Scope $scope) : array { if (!$this->phpVersion->supportsFirstClassCallables()) { return [RuleErrorBuilder::message('First-class callables are supported only on PHP 8.1 and later.')->nonIgnorable()->identifier('callable.notSupported')->build()]; } $functionName = $node->getName(); if ($functionName instanceof Node\Name) { $functionNameName = $functionName->toString(); if ($this->reflectionProvider->hasFunction($functionName, $scope)) { if ($this->checkFunctionNameCase) { $function = $this->reflectionProvider->getFunction($functionName, $scope); /** @var string $calledFunctionName */ $calledFunctionName = $this->reflectionProvider->resolveFunctionName($functionName, $scope); if (strtolower($function->getName()) === strtolower($calledFunctionName) && $function->getName() !== $calledFunctionName) { return [RuleErrorBuilder::message(sprintf('Call to function %s() with incorrect case: %s', $function->getName(), $functionNameName))->identifier('function.nameCase')->build()]; } } return []; } if ($scope->isInFunctionExists($functionNameName)) { return []; } return [RuleErrorBuilder::message(sprintf('Function %s not found.', $functionNameName))->identifier('function.notFound')->build()]; } $typeResult = $this->ruleLevelHelper->findTypeToCheck($scope, NullsafeOperatorHelper::getNullsafeShortcircuitedExprRespectingScope($scope, $functionName), 'Creating callable from an unknown class %s.', static function (Type $type) : bool { return $type->isCallable()->yes(); }); $type = $typeResult->getType(); if ($type instanceof ErrorType) { return $typeResult->getUnknownClassErrors(); } $isCallable = $type->isCallable(); if ($isCallable->no()) { return [RuleErrorBuilder::message(sprintf('Creating callable from %s but it\'s not a callable.', $type->describe(VerbosityLevel::value())))->identifier('callable.nonCallable')->build()]; } if ($this->reportMaybes && $isCallable->maybe()) { return [RuleErrorBuilder::message(sprintf('Creating callable from %s but it might not be a callable.', $type->describe(VerbosityLevel::value())))->identifier('callable.nonCallable')->build()]; } return []; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Functions; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\NullsafeCheck; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; /** * @implements Rule<Node\Expr\ArrowFunction> */ final class ArrowFunctionReturnNullsafeByRefRule implements Rule { /** * @var NullsafeCheck */ private $nullsafeCheck; public function __construct(NullsafeCheck $nullsafeCheck) { $this->nullsafeCheck = $nullsafeCheck; } public function getNodeType() : string { return Node\Expr\ArrowFunction::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->byRef) { return []; } if (!$this->nullsafeCheck->containsNullSafe($node->expr)) { return []; } return [RuleErrorBuilder::message('Nullsafe cannot be returned by reference.')->nonIgnorable()->identifier('nullsafe.byRef')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Functions; use PhpParser\Node; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\IntegerRangeType; use PHPStan\Type\VerbosityLevel; use function array_values; use function count; use function sprintf; /** * @implements Rule<Node\Expr\FuncCall> */ final class RandomIntParametersRule implements Rule { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var bool */ private $reportMaybes; public function __construct(ReflectionProvider $reflectionProvider, bool $reportMaybes) { $this->reflectionProvider = $reflectionProvider; $this->reportMaybes = $reportMaybes; } public function getNodeType() : string { return FuncCall::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->name instanceof Node\Name) { return []; } if ($this->reflectionProvider->resolveFunctionName($node->name, $scope) !== 'random_int') { return []; } $args = array_values($node->getArgs()); if (count($args) < 2) { return []; } $minType = $scope->getType($args[0]->value)->toInteger(); $maxType = $scope->getType($args[1]->value)->toInteger(); if (!$minType instanceof ConstantIntegerType && !$minType instanceof IntegerRangeType || !$maxType instanceof ConstantIntegerType && !$maxType instanceof IntegerRangeType) { return []; } $isSmaller = $maxType->isSmallerThan($minType); if ($isSmaller->yes() || $isSmaller->maybe() && $this->reportMaybes) { $message = 'Parameter #1 $min (%s) of function random_int expects lower number than parameter #2 $max (%s).'; return [RuleErrorBuilder::message(sprintf($message, $minType->describe(VerbosityLevel::value()), $maxType->describe(VerbosityLevel::value())))->identifier('argument.type')->build()]; } return []; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Functions; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\InFunctionNode; use PHPStan\Rules\MissingTypehintCheck; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\MixedType; use PHPStan\Type\VerbosityLevel; use function sprintf; /** * @implements Rule<InFunctionNode> */ final class MissingFunctionReturnTypehintRule implements Rule { /** * @var MissingTypehintCheck */ private $missingTypehintCheck; public function __construct(MissingTypehintCheck $missingTypehintCheck) { $this->missingTypehintCheck = $missingTypehintCheck; } public function getNodeType() : string { return InFunctionNode::class; } public function processNode(Node $node, Scope $scope) : array { $functionReflection = $node->getFunctionReflection(); $returnType = $functionReflection->getReturnType(); if ($returnType instanceof MixedType && !$returnType->isExplicitMixed()) { return [RuleErrorBuilder::message(sprintf('Function %s() has no return type specified.', $functionReflection->getName()))->identifier('missingType.return')->build()]; } $messages = []; foreach ($this->missingTypehintCheck->getIterableTypesWithMissingValueTypehint($returnType) as $iterableType) { $iterableTypeDescription = $iterableType->describe(VerbosityLevel::typeOnly()); $messages[] = RuleErrorBuilder::message(sprintf('Function %s() return type has no value type specified in iterable type %s.', $functionReflection->getName(), $iterableTypeDescription))->tip(MissingTypehintCheck::MISSING_ITERABLE_VALUE_TYPE_TIP)->identifier('missingType.iterableValue')->build(); } foreach ($this->missingTypehintCheck->getNonGenericObjectTypesWithGenericClass($returnType) as [$name, $genericTypeNames]) { $messages[] = RuleErrorBuilder::message(sprintf('Function %s() return type with generic %s does not specify its types: %s', $functionReflection->getName(), $name, $genericTypeNames))->identifier('missingType.generics')->build(); } foreach ($this->missingTypehintCheck->getCallablesWithMissingSignature($returnType) as $callableType) { $messages[] = RuleErrorBuilder::message(sprintf('Function %s() return type has no signature specified for %s.', $functionReflection->getName(), $callableType->describe(VerbosityLevel::typeOnly())))->identifier('missingType.callable')->build(); } return $messages; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Functions; use PhpParser\Node; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\ArgumentsNormalizer; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ParametersAcceptorSelector; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function array_key_exists; use function count; use function sprintf; /** * @implements Rule<Node\Expr\FuncCall> */ final class UselessFunctionReturnValueRule implements Rule { /** * @var ReflectionProvider */ private $reflectionProvider; private const USELESS_FUNCTIONS = ['var_export' => 'null', 'print_r' => 'true', 'highlight_string' => 'true']; public function __construct(ReflectionProvider $reflectionProvider) { $this->reflectionProvider = $reflectionProvider; } public function getNodeType() : string { return FuncCall::class; } public function processNode(Node $funcCall, Scope $scope) : array { if (!$funcCall->name instanceof Node\Name || $scope->isInFirstLevelStatement()) { return []; } if (!$this->reflectionProvider->hasFunction($funcCall->name, $scope)) { return []; } $functionReflection = $this->reflectionProvider->getFunction($funcCall->name, $scope); if (!array_key_exists($functionReflection->getName(), self::USELESS_FUNCTIONS)) { return []; } $parametersAcceptor = ParametersAcceptorSelector::selectFromArgs($scope, $funcCall->getArgs(), $functionReflection->getVariants(), $functionReflection->getNamedArgumentsVariants()); $reorderedFuncCall = ArgumentsNormalizer::reorderFuncArguments($parametersAcceptor, $funcCall); if ($reorderedFuncCall === null) { return []; } $reorderedArgs = $reorderedFuncCall->getArgs(); if (count($reorderedArgs) === 1 || count($reorderedArgs) >= 2 && $scope->getType($reorderedArgs[1]->value)->isFalse()->yes()) { return [RuleErrorBuilder::message(sprintf('Return value of function %s() is always %s and the result is printed instead of being returned. Pass in true as parameter #%d $%s to return the output instead.', $functionReflection->getName(), self::USELESS_FUNCTIONS[$functionReflection->getName()], 2, $parametersAcceptor->getParameters()[1]->getName()))->identifier('function.uselessReturnValue')->line($funcCall->getStartLine())->build()]; } return []; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Functions; use PhpParser\Node; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\ArgumentsNormalizer; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ParametersAcceptorSelector; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\ParameterCastableToStringCheck; use PHPStan\Rules\Rule; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\ErrorType; use PHPStan\Type\Type; use PHPStan\Type\TypeUtils; use function array_key_exists; use function in_array; use const SORT_FLAG_CASE; use const SORT_LOCALE_STRING; use const SORT_NATURAL; use const SORT_NUMERIC; use const SORT_REGULAR; use const SORT_STRING; /** * @implements Rule<Node\Expr\FuncCall> */ final class SortParameterCastableToStringRule implements Rule { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var ParameterCastableToStringCheck */ private $parameterCastableToStringCheck; public function __construct(ReflectionProvider $reflectionProvider, ParameterCastableToStringCheck $parameterCastableToStringCheck) { $this->reflectionProvider = $reflectionProvider; $this->parameterCastableToStringCheck = $parameterCastableToStringCheck; } public function getNodeType() : string { return FuncCall::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->name instanceof Node\Name) { return []; } if (!$this->reflectionProvider->hasFunction($node->name, $scope)) { return []; } $functionReflection = $this->reflectionProvider->getFunction($node->name, $scope); $functionName = $functionReflection->getName(); if (!in_array($functionName, ['array_unique', 'sort', 'rsort', 'asort', 'arsort'], \true)) { return []; } $origArgs = $node->getArgs(); $parametersAcceptor = ParametersAcceptorSelector::selectFromArgs($scope, $origArgs, $functionReflection->getVariants(), $functionReflection->getNamedArgumentsVariants()); $functionParameters = $parametersAcceptor->getParameters(); $normalizedFuncCall = ArgumentsNormalizer::reorderFuncArguments($parametersAcceptor, $node); if ($normalizedFuncCall === null) { return []; } $normalizedArgs = $normalizedFuncCall->getArgs(); if (!array_key_exists(0, $normalizedArgs)) { return []; } $argsToCheck = [0 => $normalizedArgs[0]]; $flags = null; if (array_key_exists(1, $normalizedArgs)) { $flags = $scope->getType($normalizedArgs[1]->value); } elseif (array_key_exists(1, $functionParameters)) { $flags = $functionParameters[1]->getDefaultValue(); } if ($flags === null || $flags->equals(new ConstantIntegerType(SORT_REGULAR))) { return []; } $constantIntFlags = TypeUtils::getConstantIntegers($flags); $mustBeCastableToString = $mustBeCastableToFloat = $constantIntFlags === []; foreach ($constantIntFlags as $flag) { if ($flag->getValue() === SORT_NUMERIC) { $mustBeCastableToFloat = \true; } elseif (in_array($flag->getValue() & ~SORT_FLAG_CASE, [SORT_STRING, SORT_LOCALE_STRING, SORT_NATURAL], \true)) { $mustBeCastableToString = \true; } } if ($mustBeCastableToString && !$mustBeCastableToFloat) { $errorMessage = 'Parameter %s of function %s expects an array of values castable to string, %s given.'; $castFn = static function (Type $t) { return $t->toString(); }; } elseif ($mustBeCastableToString) { $errorMessage = 'Parameter %s of function %s expects an array of values castable to string and float, %s given.'; $castFn = static function (Type $t) : Type { $float = $t->toFloat(); return $float instanceof ErrorType ? $float : $t->toString(); }; } elseif ($mustBeCastableToFloat) { $errorMessage = 'Parameter %s of function %s expects an array of values castable to float, %s given.'; $castFn = static function (Type $t) { return $t->toFloat(); }; } else { return []; } $errors = []; foreach ($argsToCheck as $argIdx => $arg) { $error = $this->parameterCastableToStringCheck->checkParameter($arg, $scope, $errorMessage, $castFn, $functionName, $this->parameterCastableToStringCheck->getParameterName($arg, $argIdx, $functionParameters[$argIdx] ?? null)); if ($error === null) { continue; } $errors[] = $error; } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Functions; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function count; use function is_string; use function sprintf; /** * @implements Rule<Node\FunctionLike> */ final class RedefinedParametersRule implements Rule { public function getNodeType() : string { return Node\FunctionLike::class; } public function processNode(Node $node, Scope $scope) : array { $params = $node->getParams(); if (count($params) <= 1) { return []; } $vars = []; $errors = []; foreach ($params as $param) { if (!$param->var instanceof Node\Expr\Variable) { continue; } if (!is_string($param->var->name)) { continue; } $var = $param->var->name; if (!isset($vars[$var])) { $vars[$var] = \true; continue; } $errors[] = RuleErrorBuilder::message(sprintf('Redefinition of parameter $%s.', $var))->identifier('parameter.duplicate')->nonIgnorable()->build(); } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Functions; use PhpParser\Node; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\ArgumentsNormalizer; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ParametersAcceptorSelector; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\Accessory\AccessoryArrayListType; use PHPStan\Type\VerbosityLevel; use function count; use function sprintf; /** * @implements Rule<Node\Expr\FuncCall> */ final class ArrayValuesRule implements Rule { /** * @readonly * @var ReflectionProvider */ private $reflectionProvider; /** * @readonly * @var bool */ private $treatPhpDocTypesAsCertain; /** * @var bool */ private $treatPhpDocTypesAsCertainTip; public function __construct(ReflectionProvider $reflectionProvider, bool $treatPhpDocTypesAsCertain, bool $treatPhpDocTypesAsCertainTip) { $this->reflectionProvider = $reflectionProvider; $this->treatPhpDocTypesAsCertain = $treatPhpDocTypesAsCertain; $this->treatPhpDocTypesAsCertainTip = $treatPhpDocTypesAsCertainTip; } public function getNodeType() : string { return FuncCall::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->name instanceof Node\Name) { return []; } if (AccessoryArrayListType::isListTypeEnabled() === \false) { return []; } if (!$this->reflectionProvider->hasFunction($node->name, $scope)) { return []; } $functionReflection = $this->reflectionProvider->getFunction($node->name, $scope); if ($functionReflection->getName() !== 'array_values') { return []; } $parametersAcceptor = ParametersAcceptorSelector::selectFromArgs($scope, $node->getArgs(), $functionReflection->getVariants(), $functionReflection->getNamedArgumentsVariants()); $normalizedFuncCall = ArgumentsNormalizer::reorderFuncArguments($parametersAcceptor, $node); if ($normalizedFuncCall === null) { return []; } $args = $normalizedFuncCall->getArgs(); if (count($args) === 0) { return []; } if ($this->treatPhpDocTypesAsCertain) { $arrayType = $scope->getType($args[0]->value); } else { $arrayType = $scope->getNativeType($args[0]->value); } if ($arrayType->isIterableAtLeastOnce()->no()) { $message = 'Parameter #1 $array (%s) to function array_values is empty, call has no effect.'; $errorBuilder = RuleErrorBuilder::message(sprintf($message, $arrayType->describe(VerbosityLevel::value())))->identifier('arrayValues.empty'); if ($this->treatPhpDocTypesAsCertain) { $nativeArrayType = $scope->getNativeType($args[0]->value); if ($this->treatPhpDocTypesAsCertainTip && !$nativeArrayType->isIterableAtLeastOnce()->no()) { $errorBuilder->treatPhpDocTypesAsCertainTip(); } } return [$errorBuilder->build()]; } if ($arrayType->isList()->yes()) { $message = 'Parameter #1 $array (%s) of array_values is already a list, call has no effect.'; $errorBuilder = RuleErrorBuilder::message(sprintf($message, $arrayType->describe(VerbosityLevel::value())))->identifier('arrayValues.list'); if ($this->treatPhpDocTypesAsCertain) { $nativeArrayType = $scope->getNativeType($args[0]->value); if ($this->treatPhpDocTypesAsCertainTip && !$nativeArrayType->isList()->yes()) { $errorBuilder->treatPhpDocTypesAsCertainTip(); } } return [$errorBuilder->build()]; } return []; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Functions; use PhpParser\Node; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\ArgumentsNormalizer; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ParametersAcceptorSelector; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\StaticTypeFactory; use PHPStan\Type\VerbosityLevel; use function count; use function sprintf; /** * @implements Rule<Node\Expr\FuncCall> */ final class ArrayFilterRule implements Rule { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var bool */ private $treatPhpDocTypesAsCertain; /** * @var bool */ private $treatPhpDocTypesAsCertainTip; public function __construct(ReflectionProvider $reflectionProvider, bool $treatPhpDocTypesAsCertain, bool $treatPhpDocTypesAsCertainTip) { $this->reflectionProvider = $reflectionProvider; $this->treatPhpDocTypesAsCertain = $treatPhpDocTypesAsCertain; $this->treatPhpDocTypesAsCertainTip = $treatPhpDocTypesAsCertainTip; } public function getNodeType() : string { return FuncCall::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->name instanceof Node\Name) { return []; } if (!$this->reflectionProvider->hasFunction($node->name, $scope)) { return []; } $functionReflection = $this->reflectionProvider->getFunction($node->name, $scope); if ($functionReflection->getName() !== 'array_filter') { return []; } $parametersAcceptor = ParametersAcceptorSelector::selectFromArgs($scope, $node->getArgs(), $functionReflection->getVariants(), $functionReflection->getNamedArgumentsVariants()); $normalizedFuncCall = ArgumentsNormalizer::reorderFuncArguments($parametersAcceptor, $node); if ($normalizedFuncCall === null) { return []; } $args = $normalizedFuncCall->getArgs(); if (count($args) !== 1) { return []; } if ($this->treatPhpDocTypesAsCertain) { $arrayType = $scope->getType($args[0]->value); } else { $arrayType = $scope->getNativeType($args[0]->value); } if ($arrayType->isIterableAtLeastOnce()->no()) { $message = 'Parameter #1 $array (%s) to function array_filter is empty, call has no effect.'; $errorBuilder = RuleErrorBuilder::message(sprintf($message, $arrayType->describe(VerbosityLevel::value())))->identifier('arrayFilter.empty'); if ($this->treatPhpDocTypesAsCertain) { $nativeArrayType = $scope->getNativeType($args[0]->value); if ($this->treatPhpDocTypesAsCertainTip && !$nativeArrayType->isIterableAtLeastOnce()->no()) { $errorBuilder->treatPhpDocTypesAsCertainTip(); } } return [$errorBuilder->build()]; } $falsyType = StaticTypeFactory::falsey(); $isSuperType = $falsyType->isSuperTypeOf($arrayType->getIterableValueType()); if ($isSuperType->no()) { $message = 'Parameter #1 $array (%s) to function array_filter does not contain falsy values, the array will always stay the same.'; $errorBuilder = RuleErrorBuilder::message(sprintf($message, $arrayType->describe(VerbosityLevel::value())))->identifier('arrayFilter.same'); if ($this->treatPhpDocTypesAsCertain) { $nativeArrayType = $scope->getNativeType($args[0]->value); $isNativeSuperType = $falsyType->isSuperTypeOf($nativeArrayType->getIterableValueType()); if ($this->treatPhpDocTypesAsCertainTip && !$isNativeSuperType->no()) { $errorBuilder->treatPhpDocTypesAsCertainTip(); } } return [$errorBuilder->build()]; } if ($isSuperType->yes()) { $message = 'Parameter #1 $array (%s) to function array_filter contains falsy values only, the result will always be an empty array.'; $errorBuilder = RuleErrorBuilder::message(sprintf($message, $arrayType->describe(VerbosityLevel::value())))->identifier('arrayFilter.alwaysEmpty'); if ($this->treatPhpDocTypesAsCertain) { $nativeArrayType = $scope->getNativeType($args[0]->value); $isNativeSuperType = $falsyType->isSuperTypeOf($nativeArrayType->getIterableValueType()); if ($this->treatPhpDocTypesAsCertainTip && !$isNativeSuperType->yes()) { $errorBuilder->treatPhpDocTypesAsCertainTip(); } } return [$errorBuilder->build()]; } return []; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Functions; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function count; /** * @implements Rule<Node\FunctionLike> */ final class VariadicParametersDeclarationRule implements Rule { public function getNodeType() : string { return Node\FunctionLike::class; } public function processNode(Node $node, Scope $scope) : array { $parameters = $node->getParams(); $paramCount = count($parameters); if ($paramCount === 0) { return []; } $errors = []; foreach ($parameters as $index => $parameter) { if (!$parameter->variadic) { continue; } if ($paramCount - 1 === $index) { continue; } $errors[] = RuleErrorBuilder::message('Only the last parameter can be variadic.')->nonIgnorable()->identifier('parameter.variadicNotLast')->build(); } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Functions; use Attribute; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\AttributesCheck; use PHPStan\Rules\Rule; /** * @implements Rule<Node\Expr\Closure> */ final class ClosureAttributesRule implements Rule { /** * @var AttributesCheck */ private $attributesCheck; public function __construct(AttributesCheck $attributesCheck) { $this->attributesCheck = $attributesCheck; } public function getNodeType() : string { return Node\Expr\Closure::class; } public function processNode(Node $node, Scope $scope) : array { return $this->attributesCheck->check($scope, $node->attrGroups, Attribute::TARGET_FUNCTION, 'function'); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Functions; use Attribute; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\AttributesCheck; use PHPStan\Rules\Rule; /** * @implements Rule<Node\Expr\ArrowFunction> */ final class ArrowFunctionAttributesRule implements Rule { /** * @var AttributesCheck */ private $attributesCheck; public function __construct(AttributesCheck $attributesCheck) { $this->attributesCheck = $attributesCheck; } public function getNodeType() : string { return Node\Expr\ArrowFunction::class; } public function processNode(Node $node, Scope $scope) : array { return $this->attributesCheck->check($scope, $node->attrGroups, Attribute::TARGET_FUNCTION, 'function'); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Functions; use PhpParser\Node; use PhpParser\Node\Stmt\Return_; use PHPStan\Analyser\Scope; use PHPStan\Reflection\MethodReflection; use PHPStan\Rules\FunctionReturnTypeCheck; use PHPStan\Rules\Rule; use function sprintf; /** * @implements Rule<Node\Stmt\Return_> */ final class ReturnTypeRule implements Rule { /** * @var FunctionReturnTypeCheck */ private $returnTypeCheck; public function __construct(FunctionReturnTypeCheck $returnTypeCheck) { $this->returnTypeCheck = $returnTypeCheck; } public function getNodeType() : string { return Return_::class; } public function processNode(Node $node, Scope $scope) : array { if ($scope->getFunction() === null) { return []; } if ($scope->isInAnonymousFunction()) { return []; } $function = $scope->getFunction(); if ($function instanceof MethodReflection) { return []; } return $this->returnTypeCheck->checkReturnType($scope, $function->getReturnType(), $node->expr, $node, sprintf('Function %s() should return %%s but empty return statement found.', $function->getName()), sprintf('Function %s() with return type void returns %%s but should not return anything.', $function->getName()), sprintf('Function %s() should return %%s but returns %%s.', $function->getName()), sprintf('Function %s() should never return but return statement found.', $function->getName()), $function->isGenerator()); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Properties; use PhpParser\Node; use PhpParser\Node\Expr; use PhpParser\Node\Scalar\String_; use PhpParser\Node\VarLikeIdentifier; use PHPStan\Analyser\Scope; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\Type; use function array_map; final class PropertyReflectionFinder { /** * @param Node\Expr\PropertyFetch|Node\Expr\StaticPropertyFetch $propertyFetch * @return FoundPropertyReflection[] */ public function findPropertyReflectionsFromNode($propertyFetch, Scope $scope) : array { if ($propertyFetch instanceof Node\Expr\PropertyFetch) { if ($propertyFetch->name instanceof Node\Identifier) { $names = [$propertyFetch->name->name]; } else { $names = array_map(static function (ConstantStringType $name) : string { return $name->getValue(); }, $scope->getType($propertyFetch->name)->getConstantStrings()); } $reflections = []; $propertyHolderType = $scope->getType($propertyFetch->var); foreach ($names as $name) { $reflection = $this->findPropertyReflection($propertyHolderType, $name, $propertyFetch->name instanceof Expr ? $scope->filterByTruthyValue(new Expr\BinaryOp\Identical($propertyFetch->name, new String_($name))) : $scope); if ($reflection === null) { continue; } $reflections[] = $reflection; } return $reflections; } if ($propertyFetch->class instanceof Node\Name) { $propertyHolderType = $scope->resolveTypeByName($propertyFetch->class); } else { $propertyHolderType = $scope->getType($propertyFetch->class); } if ($propertyFetch->name instanceof VarLikeIdentifier) { $names = [$propertyFetch->name->name]; } else { $names = array_map(static function (ConstantStringType $name) : string { return $name->getValue(); }, $scope->getType($propertyFetch->name)->getConstantStrings()); } $reflections = []; foreach ($names as $name) { $reflection = $this->findPropertyReflection($propertyHolderType, $name, $propertyFetch->name instanceof Expr ? $scope->filterByTruthyValue(new Expr\BinaryOp\Identical($propertyFetch->name, new String_($name))) : $scope); if ($reflection === null) { continue; } $reflections[] = $reflection; } return $reflections; } /** * @param Node\Expr\PropertyFetch|Node\Expr\StaticPropertyFetch $propertyFetch */ public function findPropertyReflectionFromNode($propertyFetch, Scope $scope) : ?\PHPStan\Rules\Properties\FoundPropertyReflection { if ($propertyFetch instanceof Node\Expr\PropertyFetch) { if (!$propertyFetch->name instanceof Node\Identifier) { return null; } $propertyHolderType = $scope->getType($propertyFetch->var); return $this->findPropertyReflection($propertyHolderType, $propertyFetch->name->name, $scope); } if (!$propertyFetch->name instanceof Node\Identifier) { return null; } if ($propertyFetch->class instanceof Node\Name) { $propertyHolderType = $scope->resolveTypeByName($propertyFetch->class); } else { $propertyHolderType = $scope->getType($propertyFetch->class); } return $this->findPropertyReflection($propertyHolderType, $propertyFetch->name->name, $scope); } private function findPropertyReflection(Type $propertyHolderType, string $propertyName, Scope $scope) : ?\PHPStan\Rules\Properties\FoundPropertyReflection { if (!$propertyHolderType->hasProperty($propertyName)->yes()) { return null; } $originalProperty = $propertyHolderType->getProperty($propertyName, $scope); return new \PHPStan\Rules\Properties\FoundPropertyReflection($originalProperty, $scope, $propertyName, $originalProperty->getReadableType(), $originalProperty->getWritableType()); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Properties; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Rules\RuleLevelHelper; use function sprintf; /** * @implements Rule<Node\Expr> */ final class ReadingWriteOnlyPropertiesRule implements Rule { /** * @var PropertyDescriptor */ private $propertyDescriptor; /** * @var PropertyReflectionFinder */ private $propertyReflectionFinder; /** * @var RuleLevelHelper */ private $ruleLevelHelper; /** * @var bool */ private $checkThisOnly; public function __construct(\PHPStan\Rules\Properties\PropertyDescriptor $propertyDescriptor, \PHPStan\Rules\Properties\PropertyReflectionFinder $propertyReflectionFinder, RuleLevelHelper $ruleLevelHelper, bool $checkThisOnly) { $this->propertyDescriptor = $propertyDescriptor; $this->propertyReflectionFinder = $propertyReflectionFinder; $this->ruleLevelHelper = $ruleLevelHelper; $this->checkThisOnly = $checkThisOnly; } public function getNodeType() : string { return Node\Expr::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node instanceof Node\Expr\PropertyFetch && !$node instanceof Node\Expr\StaticPropertyFetch) { return []; } if ($node instanceof Node\Expr\PropertyFetch && $this->checkThisOnly && !$this->ruleLevelHelper->isThis($node->var)) { return []; } if ($scope->isInExpressionAssign($node)) { return []; } $propertyReflection = $this->propertyReflectionFinder->findPropertyReflectionFromNode($node, $scope); if ($propertyReflection === null) { return []; } if (!$scope->canAccessProperty($propertyReflection)) { return []; } if (!$propertyReflection->isReadable()) { $propertyDescription = $this->propertyDescriptor->describeProperty($propertyReflection, $scope, $node); return [RuleErrorBuilder::message(sprintf('%s is not readable.', $propertyDescription))->identifier('property.writeOnly')->build()]; } return []; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Properties; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\ClassPropertyNode; use PHPStan\Rules\MissingTypehintCheck; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\MixedType; use PHPStan\Type\VerbosityLevel; use function sprintf; /** * @implements Rule<ClassPropertyNode> */ final class MissingPropertyTypehintRule implements Rule { /** * @var MissingTypehintCheck */ private $missingTypehintCheck; public function __construct(MissingTypehintCheck $missingTypehintCheck) { $this->missingTypehintCheck = $missingTypehintCheck; } public function getNodeType() : string { return ClassPropertyNode::class; } public function processNode(Node $node, Scope $scope) : array { $propertyReflection = $node->getClassReflection()->getNativeProperty($node->getName()); if ($propertyReflection->isPromoted()) { return []; } $propertyType = $propertyReflection->getReadableType(); if ($propertyType instanceof MixedType && !$propertyType->isExplicitMixed()) { return [RuleErrorBuilder::message(sprintf('Property %s::$%s has no type specified.', $propertyReflection->getDeclaringClass()->getDisplayName(), $node->getName()))->identifier('missingType.property')->build()]; } $messages = []; foreach ($this->missingTypehintCheck->getIterableTypesWithMissingValueTypehint($propertyType) as $iterableType) { $iterableTypeDescription = $iterableType->describe(VerbosityLevel::typeOnly()); $messages[] = RuleErrorBuilder::message(sprintf('Property %s::$%s type has no value type specified in iterable type %s.', $propertyReflection->getDeclaringClass()->getDisplayName(), $node->getName(), $iterableTypeDescription))->tip(MissingTypehintCheck::MISSING_ITERABLE_VALUE_TYPE_TIP)->identifier('missingType.iterableValue')->build(); } foreach ($this->missingTypehintCheck->getNonGenericObjectTypesWithGenericClass($propertyType) as [$name, $genericTypeNames]) { $messages[] = RuleErrorBuilder::message(sprintf('Property %s::$%s with generic %s does not specify its types: %s', $propertyReflection->getDeclaringClass()->getDisplayName(), $node->getName(), $name, $genericTypeNames))->identifier('missingType.generics')->build(); } foreach ($this->missingTypehintCheck->getCallablesWithMissingSignature($propertyType) as $callableType) { $messages[] = RuleErrorBuilder::message(sprintf('Property %s::$%s type has no signature specified for %s.', $propertyReflection->getDeclaringClass()->getDisplayName(), $node->getName(), $callableType->describe(VerbosityLevel::typeOnly())))->identifier('missingType.callable')->build(); } return $messages; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Properties; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ExtendedPropertyReflection; use PHPStan\Reflection\Php\PhpPropertyReflection; use PHPStan\Reflection\WrapperPropertyReflection; use PHPStan\TrinaryLogic; use PHPStan\Type\Type; final class FoundPropertyReflection implements ExtendedPropertyReflection { /** * @var ExtendedPropertyReflection */ private $originalPropertyReflection; /** * @var Scope */ private $scope; /** * @var string */ private $propertyName; /** * @var Type */ private $readableType; /** * @var Type */ private $writableType; public function __construct(ExtendedPropertyReflection $originalPropertyReflection, Scope $scope, string $propertyName, Type $readableType, Type $writableType) { $this->originalPropertyReflection = $originalPropertyReflection; $this->scope = $scope; $this->propertyName = $propertyName; $this->readableType = $readableType; $this->writableType = $writableType; } public function getScope() : Scope { return $this->scope; } public function getDeclaringClass() : ClassReflection { return $this->originalPropertyReflection->getDeclaringClass(); } public function getName() : string { return $this->propertyName; } public function isStatic() : bool { return $this->originalPropertyReflection->isStatic(); } public function isPrivate() : bool { return $this->originalPropertyReflection->isPrivate(); } public function isPublic() : bool { return $this->originalPropertyReflection->isPublic(); } public function getDocComment() : ?string { return $this->originalPropertyReflection->getDocComment(); } public function getReadableType() : Type { return $this->readableType; } public function getWritableType() : Type { return $this->writableType; } public function canChangeTypeAfterAssignment() : bool { return $this->originalPropertyReflection->canChangeTypeAfterAssignment(); } public function isReadable() : bool { return $this->originalPropertyReflection->isReadable(); } public function isWritable() : bool { return $this->originalPropertyReflection->isWritable(); } public function isDeprecated() : TrinaryLogic { return $this->originalPropertyReflection->isDeprecated(); } public function getDeprecatedDescription() : ?string { return $this->originalPropertyReflection->getDeprecatedDescription(); } public function isInternal() : TrinaryLogic { return $this->originalPropertyReflection->isInternal(); } public function isNative() : bool { return $this->getNativeReflection() !== null; } public function getNativeType() : ?Type { $reflection = $this->getNativeReflection(); if ($reflection === null) { return null; } return $reflection->getNativeType(); } public function getNativeReflection() : ?PhpPropertyReflection { $reflection = $this->originalPropertyReflection; while ($reflection instanceof WrapperPropertyReflection) { $reflection = $reflection->getOriginalReflection(); } if (!$reflection instanceof PhpPropertyReflection) { return null; } return $reflection; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Properties; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\ClassPropertyNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Rules\RuleLevelHelper; use PHPStan\Type\MixedType; use PHPStan\Type\VerbosityLevel; use function sprintf; /** * @implements Rule<ClassPropertyNode> */ final class DefaultValueTypesAssignedToPropertiesRule implements Rule { /** * @var RuleLevelHelper */ private $ruleLevelHelper; public function __construct(RuleLevelHelper $ruleLevelHelper) { $this->ruleLevelHelper = $ruleLevelHelper; } public function getNodeType() : string { return ClassPropertyNode::class; } public function processNode(Node $node, Scope $scope) : array { $default = $node->getDefault(); if ($default === null) { return []; } $classReflection = $node->getClassReflection(); $propertyReflection = $classReflection->getNativeProperty($node->getName()); $propertyType = $propertyReflection->getWritableType(); if ($propertyReflection->getNativeType() instanceof MixedType) { if ($default instanceof Node\Expr\ConstFetch && $default->name->toLowerString() === 'null') { return []; } } $defaultValueType = $scope->getType($default); $accepts = $this->ruleLevelHelper->acceptsWithReason($propertyType, $defaultValueType, \true); if ($accepts->result) { return []; } $verbosityLevel = VerbosityLevel::getRecommendedLevelByType($propertyType, $defaultValueType); return [RuleErrorBuilder::message(sprintf('%s %s::$%s (%s) does not accept default value of type %s.', $node->isStatic() ? 'Static property' : 'Property', $classReflection->getDisplayName(), $node->getName(), $propertyType->describe($verbosityLevel), $defaultValueType->describe($verbosityLevel)))->identifier('property.defaultValue')->acceptsReasonsTip($accepts->reasons)->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Properties; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\ClassPropertiesNode; use PHPStan\Reflection\ConstructorsHelper; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function sprintf; /** * @implements Rule<ClassPropertiesNode> */ final class MissingReadOnlyByPhpDocPropertyAssignRule implements Rule { /** * @var ConstructorsHelper */ private $constructorsHelper; public function __construct(ConstructorsHelper $constructorsHelper) { $this->constructorsHelper = $constructorsHelper; } public function getNodeType() : string { return ClassPropertiesNode::class; } public function processNode(Node $node, Scope $scope) : array { $classReflection = $node->getClassReflection(); [$properties, $prematureAccess, $additionalAssigns] = $node->getUninitializedProperties($scope, $this->constructorsHelper->getConstructors($classReflection)); $errors = []; foreach ($properties as $propertyName => $propertyNode) { if (!$propertyNode->isReadOnlyByPhpDoc() || $propertyNode->isReadOnly()) { continue; } $errors[] = RuleErrorBuilder::message(sprintf('Class %s has an uninitialized @readonly property $%s. Assign it in the constructor.', $classReflection->getDisplayName(), $propertyName))->line($propertyNode->getStartLine())->identifier('property.uninitializedReadonlyByPhpDoc')->build(); } foreach ($prematureAccess as [$propertyName, $line, $propertyNode, $file, $fileDescription]) { if (!$propertyNode->isReadOnlyByPhpDoc() || $propertyNode->isReadOnly()) { continue; } $errors[] = RuleErrorBuilder::message(sprintf('Access to an uninitialized @readonly property %s::$%s.', $classReflection->getDisplayName(), $propertyName))->identifier('property.uninitializedReadonlyByPhpDoc')->line($line)->file($file, $fileDescription)->build(); } foreach ($additionalAssigns as [$propertyName, $line, $propertyNode]) { if (!$propertyNode->isReadOnlyByPhpDoc() || $propertyNode->isReadOnly()) { continue; } $errors[] = RuleErrorBuilder::message(sprintf('@readonly property %s::$%s is already assigned.', $classReflection->getDisplayName(), $propertyName))->identifier('assign.readOnlyPropertyByPhpDoc')->line($line)->build(); } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Properties; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\PropertyAssignNode; use PHPStan\Reflection\ConstructorsHelper; use PHPStan\Reflection\MethodReflection; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\ShouldNotHappenException; use PHPStan\Type\TypeUtils; use function in_array; use function sprintf; use function strtolower; /** * @implements Rule<PropertyAssignNode> */ final class ReadOnlyByPhpDocPropertyAssignRule implements Rule { /** * @var PropertyReflectionFinder */ private $propertyReflectionFinder; /** * @var ConstructorsHelper */ private $constructorsHelper; public function __construct(\PHPStan\Rules\Properties\PropertyReflectionFinder $propertyReflectionFinder, ConstructorsHelper $constructorsHelper) { $this->propertyReflectionFinder = $propertyReflectionFinder; $this->constructorsHelper = $constructorsHelper; } public function getNodeType() : string { return PropertyAssignNode::class; } public function processNode(Node $node, Scope $scope) : array { $propertyFetch = $node->getPropertyFetch(); if (!$propertyFetch instanceof Node\Expr\PropertyFetch) { return []; } $errors = []; $reflections = $this->propertyReflectionFinder->findPropertyReflectionsFromNode($propertyFetch, $scope); foreach ($reflections as $propertyReflection) { $nativeReflection = $propertyReflection->getNativeReflection(); if ($nativeReflection === null) { continue; } if (!$scope->canAccessProperty($propertyReflection)) { continue; } if (!$nativeReflection->isReadOnlyByPhpDoc() || $nativeReflection->isReadOnly()) { continue; } $declaringClass = $nativeReflection->getDeclaringClass(); if (!$scope->isInClass()) { $errors[] = RuleErrorBuilder::message(sprintf('@readonly property %s::$%s is assigned outside of its declaring class.', $declaringClass->getDisplayName(), $propertyReflection->getName()))->identifier('property.readOnlyByPhpDocAssignOutOfClass')->build(); continue; } $scopeClassReflection = $scope->getClassReflection(); if ($scopeClassReflection->getName() !== $declaringClass->getName()) { $errors[] = RuleErrorBuilder::message(sprintf('@readonly property %s::$%s is assigned outside of its declaring class.', $declaringClass->getDisplayName(), $propertyReflection->getName()))->identifier('property.readOnlyByPhpDocAssignOutOfClass')->build(); continue; } $scopeMethod = $scope->getFunction(); if (!$scopeMethod instanceof MethodReflection) { throw new ShouldNotHappenException(); } if (in_array($scopeMethod->getName(), $this->constructorsHelper->getConstructors($scopeClassReflection), \true) || strtolower($scopeMethod->getName()) === '__unserialize') { if (TypeUtils::findThisType($scope->getType($propertyFetch->var)) === null) { $errors[] = RuleErrorBuilder::message(sprintf('@readonly property %s::$%s is not assigned on $this.', $declaringClass->getDisplayName(), $propertyReflection->getName()))->identifier('property.readOnlyByPhpDocAssignNotOnThis')->build(); } continue; } if ($nativeReflection->isAllowedPrivateMutation()) { continue; } $errors[] = RuleErrorBuilder::message(sprintf('@readonly property %s::$%s is assigned outside of the constructor.', $declaringClass->getDisplayName(), $propertyReflection->getName()))->identifier('property.readOnlyByPhpDocAssignNotInConstructor')->build(); } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Properties; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\PropertyAssignNode; use PHPStan\Reflection\ConstructorsHelper; use PHPStan\Reflection\MethodReflection; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\ShouldNotHappenException; use PHPStan\Type\TypeUtils; use function in_array; use function sprintf; use function strtolower; /** * @implements Rule<PropertyAssignNode> */ final class ReadOnlyPropertyAssignRule implements Rule { /** * @var PropertyReflectionFinder */ private $propertyReflectionFinder; /** * @var ConstructorsHelper */ private $constructorsHelper; public function __construct(\PHPStan\Rules\Properties\PropertyReflectionFinder $propertyReflectionFinder, ConstructorsHelper $constructorsHelper) { $this->propertyReflectionFinder = $propertyReflectionFinder; $this->constructorsHelper = $constructorsHelper; } public function getNodeType() : string { return PropertyAssignNode::class; } public function processNode(Node $node, Scope $scope) : array { $propertyFetch = $node->getPropertyFetch(); if (!$propertyFetch instanceof Node\Expr\PropertyFetch) { return []; } $errors = []; $reflections = $this->propertyReflectionFinder->findPropertyReflectionsFromNode($propertyFetch, $scope); foreach ($reflections as $propertyReflection) { $nativeReflection = $propertyReflection->getNativeReflection(); if ($nativeReflection === null) { continue; } if (!$scope->canAccessProperty($propertyReflection)) { continue; } if (!$nativeReflection->isReadOnly()) { continue; } $declaringClass = $nativeReflection->getDeclaringClass(); if (!$scope->isInClass()) { $errors[] = RuleErrorBuilder::message(sprintf('Readonly property %s::$%s is assigned outside of its declaring class.', $declaringClass->getDisplayName(), $propertyReflection->getName()))->identifier('property.readOnlyAssignOutOfClass')->build(); continue; } $scopeClassReflection = $scope->getClassReflection(); if ($scopeClassReflection->getName() !== $declaringClass->getName()) { $errors[] = RuleErrorBuilder::message(sprintf('Readonly property %s::$%s is assigned outside of its declaring class.', $declaringClass->getDisplayName(), $propertyReflection->getName()))->identifier('property.readOnlyAssignOutOfClass')->build(); continue; } $scopeMethod = $scope->getFunction(); if (!$scopeMethod instanceof MethodReflection) { throw new ShouldNotHappenException(); } if (in_array($scopeMethod->getName(), $this->constructorsHelper->getConstructors($scopeClassReflection), \true) || strtolower($scopeMethod->getName()) === '__unserialize') { if (TypeUtils::findThisType($scope->getType($propertyFetch->var)) === null) { $errors[] = RuleErrorBuilder::message(sprintf('Readonly property %s::$%s is not assigned on $this.', $declaringClass->getDisplayName(), $propertyReflection->getName()))->identifier('property.readOnlyAssignNotOnThis')->build(); } continue; } $errors[] = RuleErrorBuilder::message(sprintf('Readonly property %s::$%s is assigned outside of the constructor.', $declaringClass->getDisplayName(), $propertyReflection->getName()))->identifier('property.readOnlyAssignNotInConstructor')->build(); } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Properties; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function sprintf; /** * @implements Rule<Node\Expr\AssignRef> */ final class ReadOnlyByPhpDocPropertyAssignRefRule implements Rule { /** * @var PropertyReflectionFinder */ private $propertyReflectionFinder; public function __construct(\PHPStan\Rules\Properties\PropertyReflectionFinder $propertyReflectionFinder) { $this->propertyReflectionFinder = $propertyReflectionFinder; } public function getNodeType() : string { return Node\Expr\AssignRef::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->expr instanceof Node\Expr\PropertyFetch && !$node->expr instanceof Node\Expr\StaticPropertyFetch) { return []; } $propertyFetch = $node->expr; $errors = []; $reflections = $this->propertyReflectionFinder->findPropertyReflectionsFromNode($propertyFetch, $scope); foreach ($reflections as $propertyReflection) { $nativeReflection = $propertyReflection->getNativeReflection(); if ($nativeReflection === null) { continue; } if (!$scope->canAccessProperty($propertyReflection)) { continue; } if (!$nativeReflection->isReadOnlyByPhpDoc() || $nativeReflection->isReadOnly()) { continue; } $declaringClass = $nativeReflection->getDeclaringClass(); $errors[] = RuleErrorBuilder::message(sprintf('@readonly property %s::$%s is assigned by reference.', $declaringClass->getDisplayName(), $propertyReflection->getName()))->identifier('property.readOnlyByPhpDocAssignByRef')->build(); } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Properties; use PhpParser\Node; use PhpParser\Node\Name; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function sprintf; /** * @implements Rule<Node\Expr\StaticPropertyFetch> */ final class AccessPrivatePropertyThroughStaticRule implements Rule { public function getNodeType() : string { return Node\Expr\StaticPropertyFetch::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->name instanceof Node\VarLikeIdentifier) { return []; } if (!$node->class instanceof Name) { return []; } $propertyName = $node->name->name; $className = $node->class; if ($className->toLowerString() !== 'static') { return []; } $classType = $scope->resolveTypeByName($className); if (!$classType->hasProperty($propertyName)->yes()) { return []; } $property = $classType->getProperty($propertyName, $scope); if (!$property->isPrivate()) { return []; } if (!$property->isStatic()) { return []; } if ($scope->isInClass() && $scope->getClassReflection()->isFinal()) { return []; } return [RuleErrorBuilder::message(sprintf('Unsafe access to private property %s::$%s through static::.', $property->getDeclaringClass()->getDisplayName(), $propertyName))->identifier('staticClassAccess.privateProperty')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Properties; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\VerbosityLevel; use function sprintf; /** * @implements Rule<Node\Expr\NullsafePropertyFetch> */ final class NullsafePropertyFetchRule implements Rule { public function __construct() { } public function getNodeType() : string { return Node\Expr\NullsafePropertyFetch::class; } public function processNode(Node $node, Scope $scope) : array { $calledOnType = $scope->getType($node->var); if (!$calledOnType->isNull()->no()) { return []; } if ($scope->isUndefinedExpressionAllowed($node)) { return []; } return [RuleErrorBuilder::message(sprintf('Using nullsafe property access on non-nullable type %s. Use -> instead.', $calledOnType->describe(VerbosityLevel::typeOnly())))->identifier('nullsafe.neverNull')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Properties; use PHPStan\Reflection\PropertyReflection; /** * This is the extension interface to implement if you want to describe * always-read or always-written properties. * * To register it in the configuration file use the `phpstan.properties.readWriteExtension` service tag: * * ``` * services: * - * class: App\PHPStan\MyExtension * tags: * - phpstan.properties.readWriteExtension * ``` * * Learn more: https://phpstan.org/developing-extensions/always-read-written-properties * * @api */ interface ReadWritePropertiesExtension { public function isAlwaysRead(PropertyReflection $property, string $propertyName) : bool; public function isAlwaysWritten(PropertyReflection $property, string $propertyName) : bool; public function isInitialized(PropertyReflection $property, string $propertyName) : bool; } <?php declare (strict_types=1); namespace PHPStan\Rules\Properties; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\ClassPropertyNode; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\Php\PhpPropertyReflection; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\ParserNodeTypeToPHPStanType; use PHPStan\Type\VerbosityLevel; use function array_merge; use function count; use function sprintf; /** * @implements Rule<ClassPropertyNode> */ final class OverridingPropertyRule implements Rule { /** * @var bool */ private $checkPhpDocMethodSignatures; /** * @var bool */ private $reportMaybes; public function __construct(bool $checkPhpDocMethodSignatures, bool $reportMaybes) { $this->checkPhpDocMethodSignatures = $checkPhpDocMethodSignatures; $this->reportMaybes = $reportMaybes; } public function getNodeType() : string { return ClassPropertyNode::class; } public function processNode(Node $node, Scope $scope) : array { $classReflection = $node->getClassReflection(); $prototype = $this->findPrototype($classReflection, $node->getName()); if ($prototype === null) { return []; } $errors = []; if ($prototype->isStatic()) { if (!$node->isStatic()) { $errors[] = RuleErrorBuilder::message(sprintf('Non-static property %s::$%s overrides static property %s::$%s.', $classReflection->getDisplayName(), $node->getName(), $prototype->getDeclaringClass()->getDisplayName(), $node->getName()))->identifier('property.nonStatic')->nonIgnorable()->build(); } } elseif ($node->isStatic()) { $errors[] = RuleErrorBuilder::message(sprintf('Static property %s::$%s overrides non-static property %s::$%s.', $classReflection->getDisplayName(), $node->getName(), $prototype->getDeclaringClass()->getDisplayName(), $node->getName()))->identifier('property.static')->nonIgnorable()->build(); } if ($prototype->isReadOnly()) { if (!$node->isReadOnly()) { $errors[] = RuleErrorBuilder::message(sprintf('Readwrite property %s::$%s overrides readonly property %s::$%s.', $classReflection->getDisplayName(), $node->getName(), $prototype->getDeclaringClass()->getDisplayName(), $node->getName()))->identifier('property.readWrite')->nonIgnorable()->build(); } } elseif ($node->isReadOnly()) { $errors[] = RuleErrorBuilder::message(sprintf('Readonly property %s::$%s overrides readwrite property %s::$%s.', $classReflection->getDisplayName(), $node->getName(), $prototype->getDeclaringClass()->getDisplayName(), $node->getName()))->identifier('property.readOnly')->nonIgnorable()->build(); } if ($prototype->isPublic()) { if (!$node->isPublic()) { $errors[] = RuleErrorBuilder::message(sprintf('%s property %s::$%s overriding public property %s::$%s should also be public.', $node->isPrivate() ? 'Private' : 'Protected', $classReflection->getDisplayName(), $node->getName(), $prototype->getDeclaringClass()->getDisplayName(), $node->getName()))->identifier('property.visibility')->nonIgnorable()->build(); } } elseif ($node->isPrivate()) { $errors[] = RuleErrorBuilder::message(sprintf('Private property %s::$%s overriding protected property %s::$%s should be protected or public.', $classReflection->getDisplayName(), $node->getName(), $prototype->getDeclaringClass()->getDisplayName(), $node->getName()))->identifier('property.visibility')->nonIgnorable()->build(); } $typeErrors = []; if ($prototype->hasNativeType()) { if ($node->getNativeType() === null) { $typeErrors[] = RuleErrorBuilder::message(sprintf('Property %s::$%s overriding property %s::$%s (%s) should also have native type %s.', $classReflection->getDisplayName(), $node->getName(), $prototype->getDeclaringClass()->getDisplayName(), $node->getName(), $prototype->getNativeType()->describe(VerbosityLevel::typeOnly()), $prototype->getNativeType()->describe(VerbosityLevel::typeOnly())))->identifier('property.missingNativeType')->nonIgnorable()->build(); } else { $nativeType = ParserNodeTypeToPHPStanType::resolve($node->getNativeType(), $classReflection); if (!$prototype->getNativeType()->equals($nativeType)) { $typeErrors[] = RuleErrorBuilder::message(sprintf('Type %s of property %s::$%s is not the same as type %s of overridden property %s::$%s.', $nativeType->describe(VerbosityLevel::typeOnly()), $classReflection->getDisplayName(), $node->getName(), $prototype->getNativeType()->describe(VerbosityLevel::typeOnly()), $prototype->getDeclaringClass()->getDisplayName(), $node->getName()))->identifier('property.nativeType')->nonIgnorable()->build(); } } } elseif ($node->getNativeType() !== null) { $typeErrors[] = RuleErrorBuilder::message(sprintf('Property %s::$%s (%s) overriding property %s::$%s should not have a native type.', $classReflection->getDisplayName(), $node->getName(), ParserNodeTypeToPHPStanType::resolve($node->getNativeType(), $classReflection)->describe(VerbosityLevel::typeOnly()), $prototype->getDeclaringClass()->getDisplayName(), $node->getName()))->identifier('property.extraNativeType')->nonIgnorable()->build(); } $errors = array_merge($errors, $typeErrors); if (!$this->checkPhpDocMethodSignatures) { return $errors; } if (count($typeErrors) > 0) { return $errors; } $propertyReflection = $classReflection->getNativeProperty($node->getName()); if ($prototype->getReadableType()->equals($propertyReflection->getReadableType())) { return $errors; } $verbosity = VerbosityLevel::getRecommendedLevelByType($prototype->getReadableType(), $propertyReflection->getReadableType()); $isSuperType = $prototype->getReadableType()->isSuperTypeOf($propertyReflection->getReadableType()); $canBeTurnedOffError = RuleErrorBuilder::message(sprintf('PHPDoc type %s of property %s::$%s is not the same as PHPDoc type %s of overridden property %s::$%s.', $propertyReflection->getReadableType()->describe($verbosity), $classReflection->getDisplayName(), $node->getName(), $prototype->getReadableType()->describe($verbosity), $prototype->getDeclaringClass()->getDisplayName(), $node->getName()))->identifier('property.phpDocType')->tip(sprintf("You can fix 3rd party PHPDoc types with stub files:\n %s\n This error can be turned off by setting\n %s", '<fg=cyan>https://phpstan.org/user-guide/stub-files</>', '<fg=cyan>reportMaybesInPropertyPhpDocTypes: false</> in your <fg=cyan>%configurationFile%</>.'))->build(); $cannotBeTurnedOffError = RuleErrorBuilder::message(sprintf('PHPDoc type %s of property %s::$%s is %s PHPDoc type %s of overridden property %s::$%s.', $propertyReflection->getReadableType()->describe($verbosity), $classReflection->getDisplayName(), $node->getName(), $this->reportMaybes ? 'not the same as' : 'not covariant with', $prototype->getReadableType()->describe($verbosity), $prototype->getDeclaringClass()->getDisplayName(), $node->getName()))->identifier('property.phpDocType')->tip(sprintf("You can fix 3rd party PHPDoc types with stub files:\n %s", '<fg=cyan>https://phpstan.org/user-guide/stub-files</>'))->build(); if ($this->reportMaybes) { if (!$isSuperType->yes()) { $errors[] = $cannotBeTurnedOffError; } else { $errors[] = $canBeTurnedOffError; } } else { if (!$isSuperType->yes()) { $errors[] = $cannotBeTurnedOffError; } } return $errors; } private function findPrototype(ClassReflection $classReflection, string $propertyName) : ?PhpPropertyReflection { $parentClass = $classReflection->getParentClass(); if ($parentClass === null) { return null; } if (!$parentClass->hasNativeProperty($propertyName)) { return null; } $property = $parentClass->getNativeProperty($propertyName); if ($property->isPrivate()) { return null; } return $property; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Properties; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\PropertyAssignNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Rules\RuleLevelHelper; use function sprintf; /** * @implements Rule<PropertyAssignNode> */ final class WritingToReadOnlyPropertiesRule implements Rule { /** * @var RuleLevelHelper */ private $ruleLevelHelper; /** * @var PropertyDescriptor */ private $propertyDescriptor; /** * @var PropertyReflectionFinder */ private $propertyReflectionFinder; /** * @var bool */ private $checkThisOnly; public function __construct(RuleLevelHelper $ruleLevelHelper, \PHPStan\Rules\Properties\PropertyDescriptor $propertyDescriptor, \PHPStan\Rules\Properties\PropertyReflectionFinder $propertyReflectionFinder, bool $checkThisOnly) { $this->ruleLevelHelper = $ruleLevelHelper; $this->propertyDescriptor = $propertyDescriptor; $this->propertyReflectionFinder = $propertyReflectionFinder; $this->checkThisOnly = $checkThisOnly; } public function getNodeType() : string { return PropertyAssignNode::class; } public function processNode(Node $node, Scope $scope) : array { $propertyFetch = $node->getPropertyFetch(); if ($propertyFetch instanceof Node\Expr\PropertyFetch && $this->checkThisOnly && !$this->ruleLevelHelper->isThis($propertyFetch->var)) { return []; } $propertyReflection = $this->propertyReflectionFinder->findPropertyReflectionFromNode($propertyFetch, $scope); if ($propertyReflection === null) { return []; } if (!$scope->canAccessProperty($propertyReflection)) { return []; } if (!$propertyReflection->isWritable()) { $propertyDescription = $this->propertyDescriptor->describeProperty($propertyReflection, $scope, $propertyFetch); return [RuleErrorBuilder::message(sprintf('%s is not writable.', $propertyDescription))->identifier('assign.propertyReadOnly')->build()]; } return []; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Properties; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\ClassPropertyNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; /** * @implements Rule<ClassPropertyNode> */ final class ReadOnlyByPhpDocPropertyRule implements Rule { public function getNodeType() : string { return ClassPropertyNode::class; } public function processNode(Node $node, Scope $scope) : array { if (!($node->isReadOnlyByPhpDoc() && !$node->isAllowedPrivateMutation()) || $node->isReadOnly()) { return []; } $errors = []; if ($node->getDefault() !== null) { $errors[] = RuleErrorBuilder::message('@readonly property cannot have a default value.')->identifier('property.readOnlyByPhpDocDefaultValue')->build(); } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Properties; final class DirectReadWritePropertiesExtensionProvider implements \PHPStan\Rules\Properties\ReadWritePropertiesExtensionProvider { /** * @var ReadWritePropertiesExtension[] */ private $extensions; /** * @param ReadWritePropertiesExtension[] $extensions */ public function __construct(array $extensions) { $this->extensions = $extensions; } /** * @return ReadWritePropertiesExtension[] */ public function getExtensions() : array { return $this->extensions; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Properties; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\PropertyAssignNode; use PHPStan\Rules\Rule; /** * @implements Rule<PropertyAssignNode> */ final class AccessPropertiesInAssignRule implements Rule { /** * @var AccessPropertiesRule */ private $accessPropertiesRule; public function __construct(\PHPStan\Rules\Properties\AccessPropertiesRule $accessPropertiesRule) { $this->accessPropertiesRule = $accessPropertiesRule; } public function getNodeType() : string { return PropertyAssignNode::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->getPropertyFetch() instanceof Node\Expr\PropertyFetch) { return []; } if ($node->isAssignOp()) { return []; } return $this->accessPropertiesRule->processNode($node->getPropertyFetch(), $scope); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Properties; use Attribute; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\AttributesCheck; use PHPStan\Rules\Rule; /** * @implements Rule<Node\Stmt\Property> */ final class PropertyAttributesRule implements Rule { /** * @var AttributesCheck */ private $attributesCheck; public function __construct(AttributesCheck $attributesCheck) { $this->attributesCheck = $attributesCheck; } public function getNodeType() : string { return Node\Stmt\Property::class; } public function processNode(Node $node, Scope $scope) : array { return $this->attributesCheck->check($scope, $node->attrGroups, Attribute::TARGET_PROPERTY, 'property'); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Properties; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\ClassPropertiesNode; use PHPStan\Reflection\ConstructorsHelper; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function sprintf; /** * @implements Rule<ClassPropertiesNode> */ final class MissingReadOnlyPropertyAssignRule implements Rule { /** * @var ConstructorsHelper */ private $constructorsHelper; public function __construct(ConstructorsHelper $constructorsHelper) { $this->constructorsHelper = $constructorsHelper; } public function getNodeType() : string { return ClassPropertiesNode::class; } public function processNode(Node $node, Scope $scope) : array { $classReflection = $node->getClassReflection(); [$properties, $prematureAccess, $additionalAssigns] = $node->getUninitializedProperties($scope, $this->constructorsHelper->getConstructors($classReflection)); $errors = []; foreach ($properties as $propertyName => $propertyNode) { if (!$propertyNode->isReadOnly()) { continue; } $errors[] = RuleErrorBuilder::message(sprintf('Class %s has an uninitialized readonly property $%s. Assign it in the constructor.', $classReflection->getDisplayName(), $propertyName))->line($propertyNode->getStartLine())->identifier('property.uninitializedReadonly')->build(); } foreach ($prematureAccess as [$propertyName, $line, $propertyNode, $file, $fileDescription]) { if (!$propertyNode->isReadOnly()) { continue; } $errors[] = RuleErrorBuilder::message(sprintf('Access to an uninitialized readonly property %s::$%s.', $classReflection->getDisplayName(), $propertyName))->line($line)->file($file, $fileDescription)->identifier('property.uninitializedReadonly')->build(); } foreach ($additionalAssigns as [$propertyName, $line, $propertyNode]) { if (!$propertyNode->isReadOnly()) { continue; } $errors[] = RuleErrorBuilder::message(sprintf('Readonly property %s::$%s is already assigned.', $classReflection->getDisplayName(), $propertyName))->line($line)->identifier('assign.readOnlyProperty')->build(); } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Properties; use PhpParser\Node; use PhpParser\Node\Expr\StaticPropertyFetch; use PhpParser\Node\Name; use PHPStan\Analyser\NullsafeOperatorHelper; use PHPStan\Analyser\Scope; use PHPStan\Internal\SprintfHelper; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\ClassNameCheck; use PHPStan\Rules\ClassNameNodePair; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Rules\RuleLevelHelper; use PHPStan\ShouldNotHappenException; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\ErrorType; use PHPStan\Type\StringType; use PHPStan\Type\ThisType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\TypeUtils; use PHPStan\Type\VerbosityLevel; use function array_map; use function array_merge; use function count; use function in_array; use function sprintf; use function strtolower; /** * @implements Rule<Node\Expr\StaticPropertyFetch> */ final class AccessStaticPropertiesRule implements Rule { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var RuleLevelHelper */ private $ruleLevelHelper; /** * @var ClassNameCheck */ private $classCheck; public function __construct(ReflectionProvider $reflectionProvider, RuleLevelHelper $ruleLevelHelper, ClassNameCheck $classCheck) { $this->reflectionProvider = $reflectionProvider; $this->ruleLevelHelper = $ruleLevelHelper; $this->classCheck = $classCheck; } public function getNodeType() : string { return StaticPropertyFetch::class; } public function processNode(Node $node, Scope $scope) : array { if ($node->name instanceof Node\VarLikeIdentifier) { $names = [$node->name->name]; } else { $names = array_map(static function (ConstantStringType $type) : string { return $type->getValue(); }, $scope->getType($node->name)->getConstantStrings()); } $errors = []; foreach ($names as $name) { $errors = array_merge($errors, $this->processSingleProperty($scope, $node, $name)); } return $errors; } /** * @return list<IdentifierRuleError> */ private function processSingleProperty(Scope $scope, StaticPropertyFetch $node, string $name) : array { $messages = []; if ($node->class instanceof Name) { $class = (string) $node->class; $lowercasedClass = strtolower($class); if (in_array($lowercasedClass, ['self', 'static'], \true)) { if (!$scope->isInClass()) { return [RuleErrorBuilder::message(sprintf('Accessing %s::$%s outside of class scope.', $class, $name))->identifier(sprintf('outOfClass.%s', $lowercasedClass))->build()]; } $classType = $scope->resolveTypeByName($node->class); } elseif ($lowercasedClass === 'parent') { if (!$scope->isInClass()) { return [RuleErrorBuilder::message(sprintf('Accessing %s::$%s outside of class scope.', $class, $name))->identifier('outOfClass.parent')->build()]; } if ($scope->getClassReflection()->getParentClass() === null) { return [RuleErrorBuilder::message(sprintf('%s::%s() accesses parent::$%s but %s does not extend any class.', $scope->getClassReflection()->getDisplayName(), $scope->getFunctionName(), $name, $scope->getClassReflection()->getDisplayName()))->identifier('class.noParent')->build()]; } if ($scope->getFunctionName() === null) { throw new ShouldNotHappenException(); } $currentMethodReflection = $scope->getClassReflection()->getNativeMethod($scope->getFunctionName()); if (!$currentMethodReflection->isStatic()) { // calling parent::method() from instance method return []; } $classType = $scope->resolveTypeByName($node->class); } else { if (!$this->reflectionProvider->hasClass($class)) { if ($scope->isInClassExists($class)) { return []; } return [RuleErrorBuilder::message(sprintf('Access to static property $%s on an unknown class %s.', $name, $class))->discoveringSymbolsTip()->identifier('class.notFound')->build()]; } $messages = $this->classCheck->checkClassNames([new ClassNameNodePair($class, $node->class)]); $classType = $scope->resolveTypeByName($node->class); } } else { $classTypeResult = $this->ruleLevelHelper->findTypeToCheck($scope, NullsafeOperatorHelper::getNullsafeShortcircuitedExprRespectingScope($scope, $node->class), sprintf('Access to static property $%s on an unknown class %%s.', SprintfHelper::escapeFormatString($name)), static function (Type $type) use($name) : bool { return $type->canAccessProperties()->yes() && $type->hasProperty($name)->yes(); }); $classType = $classTypeResult->getType(); if ($classType instanceof ErrorType) { return $classTypeResult->getUnknownClassErrors(); } } if ($classType->isString()->yes()) { return []; } $typeForDescribe = $classType; if ($classType instanceof ThisType) { $typeForDescribe = $classType->getStaticObjectType(); } $classType = TypeCombinator::remove($classType, new StringType()); if ($scope->isInExpressionAssign($node)) { return []; } if ($classType->canAccessProperties()->no() || $classType->canAccessProperties()->maybe() && !$scope->isUndefinedExpressionAllowed($node)) { return array_merge($messages, [RuleErrorBuilder::message(sprintf('Cannot access static property $%s on %s.', $name, $typeForDescribe->describe(VerbosityLevel::typeOnly())))->identifier('staticProperty.nonObject')->build()]); } $has = $classType->hasProperty($name); if (!$has->no() && $scope->isUndefinedExpressionAllowed($node)) { return []; } if (!$has->yes()) { if ($scope->hasExpressionType($node)->yes()) { return $messages; } $classNames = $classType->getObjectClassNames(); if (count($classNames) === 1) { $propertyClassReflection = $this->reflectionProvider->getClass($classNames[0]); $parentClassReflection = $propertyClassReflection->getParentClass(); while ($parentClassReflection !== null) { if ($parentClassReflection->hasProperty($name)) { if ($scope->canAccessProperty($parentClassReflection->getProperty($name, $scope))) { return []; } return [RuleErrorBuilder::message(sprintf('Access to private static property $%s of parent class %s.', $name, $parentClassReflection->getDisplayName()))->identifier('staticProperty.private')->build()]; } $parentClassReflection = $parentClassReflection->getParentClass(); } } return array_merge($messages, [RuleErrorBuilder::message(sprintf('Access to an undefined static property %s::$%s.', $typeForDescribe->describe(VerbosityLevel::typeOnly()), $name))->identifier('staticProperty.notFound')->build()]); } $property = $classType->getProperty($name, $scope); if (!$property->isStatic()) { $hasPropertyTypes = TypeUtils::getHasPropertyTypes($classType); foreach ($hasPropertyTypes as $hasPropertyType) { if ($hasPropertyType->getPropertyName() === $name) { return []; } } return array_merge($messages, [RuleErrorBuilder::message(sprintf('Static access to instance property %s::$%s.', $property->getDeclaringClass()->getDisplayName(), $name))->identifier('property.staticAccess')->build()]); } if (!$scope->canAccessProperty($property)) { return array_merge($messages, [RuleErrorBuilder::message(sprintf('Access to %s property $%s of class %s.', $property->isPrivate() ? 'private' : 'protected', $name, $property->getDeclaringClass()->getDisplayName()))->identifier(sprintf('staticProperty.%s', $property->isPrivate() ? 'private' : 'protected'))->build()]); } return $messages; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Properties; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\ClassPropertyNode; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\ClassNameCheck; use PHPStan\Rules\ClassNameNodePair; use PHPStan\Rules\PhpDoc\UnresolvableTypeHelper; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function array_map; use function array_merge; use function sprintf; /** * @implements Rule<ClassPropertyNode> */ final class ExistingClassesInPropertiesRule implements Rule { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var ClassNameCheck */ private $classCheck; /** * @var UnresolvableTypeHelper */ private $unresolvableTypeHelper; /** * @var PhpVersion */ private $phpVersion; /** * @var bool */ private $checkClassCaseSensitivity; /** * @var bool */ private $checkThisOnly; public function __construct(ReflectionProvider $reflectionProvider, ClassNameCheck $classCheck, UnresolvableTypeHelper $unresolvableTypeHelper, PhpVersion $phpVersion, bool $checkClassCaseSensitivity, bool $checkThisOnly) { $this->reflectionProvider = $reflectionProvider; $this->classCheck = $classCheck; $this->unresolvableTypeHelper = $unresolvableTypeHelper; $this->phpVersion = $phpVersion; $this->checkClassCaseSensitivity = $checkClassCaseSensitivity; $this->checkThisOnly = $checkThisOnly; } public function getNodeType() : string { return ClassPropertyNode::class; } public function processNode(Node $node, Scope $scope) : array { $propertyReflection = $node->getClassReflection()->getNativeProperty($node->getName()); if ($this->checkThisOnly) { $referencedClasses = $propertyReflection->getNativeType()->getReferencedClasses(); } else { $referencedClasses = array_merge($propertyReflection->getNativeType()->getReferencedClasses(), $propertyReflection->getPhpDocType()->getReferencedClasses()); } $errors = []; foreach ($referencedClasses as $referencedClass) { if ($this->reflectionProvider->hasClass($referencedClass)) { if ($this->reflectionProvider->getClass($referencedClass)->isTrait()) { $errors[] = RuleErrorBuilder::message(sprintf('Property %s::$%s has invalid type %s.', $propertyReflection->getDeclaringClass()->getDisplayName(), $node->getName(), $referencedClass))->identifier('property.trait')->build(); } continue; } $errors[] = RuleErrorBuilder::message(sprintf('Property %s::$%s has unknown class %s as its type.', $propertyReflection->getDeclaringClass()->getDisplayName(), $node->getName(), $referencedClass))->identifier('class.notFound')->discoveringSymbolsTip()->build(); } $errors = array_merge($errors, $this->classCheck->checkClassNames(array_map(static function (string $class) use($node) : ClassNameNodePair { return new ClassNameNodePair($class, $node); }, $referencedClasses), $this->checkClassCaseSensitivity)); if ($this->phpVersion->supportsPureIntersectionTypes() && $this->unresolvableTypeHelper->containsUnresolvableType($propertyReflection->getNativeType())) { $errors[] = RuleErrorBuilder::message(sprintf('Property %s::$%s has unresolvable native type.', $propertyReflection->getDeclaringClass()->getDisplayName(), $node->getName()))->identifier('property.unresolvableNativeType')->build(); } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Properties; interface ReadWritePropertiesExtensionProvider { public const EXTENSION_TAG = 'phpstan.properties.readWriteExtension'; /** * @return ReadWritePropertiesExtension[] */ public function getExtensions() : array; } <?php declare (strict_types=1); namespace PHPStan\Rules\Properties; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\ClassPropertyNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; /** * @implements Rule<ClassPropertyNode> */ final class PropertiesInInterfaceRule implements Rule { public function getNodeType() : string { return ClassPropertyNode::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->getClassReflection()->isInterface()) { return []; } return [RuleErrorBuilder::message('Interfaces may not include properties.')->nonIgnorable()->identifier('property.inInterface')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Properties; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\ClassPropertyNode; use PHPStan\Php\PhpVersion; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; /** * @implements Rule<ClassPropertyNode> */ final class ReadOnlyPropertyRule implements Rule { /** * @var PhpVersion */ private $phpVersion; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; } public function getNodeType() : string { return ClassPropertyNode::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->isReadOnly()) { return []; } $errors = []; if (!$this->phpVersion->supportsReadOnlyProperties()) { $errors[] = RuleErrorBuilder::message('Readonly properties are supported only on PHP 8.1 and later.')->nonIgnorable()->identifier('property.readOnlyNotSupported')->build(); } if ($node->getNativeType() === null) { $errors[] = RuleErrorBuilder::message('Readonly property must have a native type.')->identifier('property.readOnlyNoNativeType')->nonIgnorable()->build(); } if ($node->getDefault() !== null) { $errors[] = RuleErrorBuilder::message('Readonly property cannot have a default value.')->nonIgnorable()->identifier('property.readOnlyDefaultValue')->build(); } if ($node->isStatic()) { $errors[] = RuleErrorBuilder::message('Readonly property cannot be static.')->nonIgnorable()->identifier('property.readOnlyStatic')->build(); } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Properties; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Reflection\PropertyReflection; use PHPStan\Type\ObjectType; use PHPStan\Type\VerbosityLevel; use function sprintf; final class PropertyDescriptor { /** * @param Node\Expr\PropertyFetch|Node\Expr\StaticPropertyFetch $propertyFetch */ public function describeProperty(PropertyReflection $property, Scope $scope, $propertyFetch) : string { if ($propertyFetch instanceof Node\Expr\PropertyFetch) { $fetchedOnType = $scope->getType($propertyFetch->var); $declaringClassType = new ObjectType($property->getDeclaringClass()->getName()); if ($declaringClassType->isSuperTypeOf($fetchedOnType)->yes()) { $classDescription = $property->getDeclaringClass()->getDisplayName(); } else { $classDescription = $fetchedOnType->describe(VerbosityLevel::typeOnly()); } } else { $classDescription = $property->getDeclaringClass()->getDisplayName(); } /** @var Node\Identifier $name */ $name = $propertyFetch->name; if (!$property->isStatic()) { return sprintf('Property %s::$%s', $classDescription, $name->name); } return sprintf('Static property %s::$%s', $classDescription, $name->name); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Properties; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function sprintf; /** * @implements Rule<Node\Expr\AssignRef> */ final class ReadOnlyPropertyAssignRefRule implements Rule { /** * @var PropertyReflectionFinder */ private $propertyReflectionFinder; public function __construct(\PHPStan\Rules\Properties\PropertyReflectionFinder $propertyReflectionFinder) { $this->propertyReflectionFinder = $propertyReflectionFinder; } public function getNodeType() : string { return Node\Expr\AssignRef::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->expr instanceof Node\Expr\PropertyFetch && !$node->expr instanceof Node\Expr\StaticPropertyFetch) { return []; } $propertyFetch = $node->expr; $errors = []; $reflections = $this->propertyReflectionFinder->findPropertyReflectionsFromNode($propertyFetch, $scope); foreach ($reflections as $propertyReflection) { $nativeReflection = $propertyReflection->getNativeReflection(); if ($nativeReflection === null) { continue; } if (!$scope->canAccessProperty($propertyReflection)) { continue; } if (!$nativeReflection->isReadOnly()) { continue; } $declaringClass = $nativeReflection->getDeclaringClass(); $errors[] = RuleErrorBuilder::message(sprintf('Readonly property %s::$%s is assigned by reference.', $declaringClass->getDisplayName(), $propertyReflection->getName()))->identifier('property.readOnlyAssignByRef')->build(); } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Properties; use PhpParser\Node; use PhpParser\Node\Expr\PropertyFetch; use PhpParser\Node\Identifier; use PHPStan\Analyser\NullsafeOperatorHelper; use PHPStan\Analyser\Scope; use PHPStan\Internal\SprintfHelper; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Rules\RuleLevelHelper; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\ErrorType; use PHPStan\Type\StaticType; use PHPStan\Type\Type; use PHPStan\Type\VerbosityLevel; use function array_map; use function array_merge; use function count; use function sprintf; /** * @implements Rule<Node\Expr\PropertyFetch> */ final class AccessPropertiesRule implements Rule { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var RuleLevelHelper */ private $ruleLevelHelper; /** * @var bool */ private $reportMagicProperties; /** * @var bool */ private $checkDynamicProperties; public function __construct(ReflectionProvider $reflectionProvider, RuleLevelHelper $ruleLevelHelper, bool $reportMagicProperties, bool $checkDynamicProperties) { $this->reflectionProvider = $reflectionProvider; $this->ruleLevelHelper = $ruleLevelHelper; $this->reportMagicProperties = $reportMagicProperties; $this->checkDynamicProperties = $checkDynamicProperties; } public function getNodeType() : string { return PropertyFetch::class; } public function processNode(Node $node, Scope $scope) : array { if ($node->name instanceof Identifier) { $names = [$node->name->name]; } else { $names = array_map(static function (ConstantStringType $type) : string { return $type->getValue(); }, $scope->getType($node->name)->getConstantStrings()); } $errors = []; foreach ($names as $name) { $errors = array_merge($errors, $this->processSingleProperty($scope, $node, $name)); } return $errors; } /** * @return list<IdentifierRuleError> */ private function processSingleProperty(Scope $scope, PropertyFetch $node, string $name) : array { $typeResult = $this->ruleLevelHelper->findTypeToCheck($scope, NullsafeOperatorHelper::getNullsafeShortcircuitedExprRespectingScope($scope, $node->var), sprintf('Access to property $%s on an unknown class %%s.', SprintfHelper::escapeFormatString($name)), static function (Type $type) use($name) : bool { return $type->canAccessProperties()->yes() && $type->hasProperty($name)->yes(); }); $type = $typeResult->getType(); if ($type instanceof ErrorType) { return $typeResult->getUnknownClassErrors(); } if ($scope->isInExpressionAssign($node)) { return []; } $typeForDescribe = $type; if ($type instanceof StaticType) { $typeForDescribe = $type->getStaticObjectType(); } if ($type->canAccessProperties()->no() || $type->canAccessProperties()->maybe() && !$scope->isUndefinedExpressionAllowed($node)) { return [RuleErrorBuilder::message(sprintf('Cannot access property $%s on %s.', $name, $typeForDescribe->describe(VerbosityLevel::typeOnly())))->identifier('property.nonObject')->build()]; } $has = $type->hasProperty($name); if (!$has->no() && $this->canAccessUndefinedProperties($scope, $node)) { return []; } if (!$has->yes()) { if ($scope->hasExpressionType($node)->yes()) { return []; } $classNames = $type->getObjectClassNames(); if (!$this->reportMagicProperties) { foreach ($classNames as $className) { if (!$this->reflectionProvider->hasClass($className)) { continue; } $classReflection = $this->reflectionProvider->getClass($className); if ($classReflection->hasNativeMethod('__get') || $classReflection->hasNativeMethod('__set')) { return []; } } } if (count($classNames) === 1) { $propertyClassReflection = $this->reflectionProvider->getClass($classNames[0]); $parentClassReflection = $propertyClassReflection->getParentClass(); while ($parentClassReflection !== null) { if ($parentClassReflection->hasProperty($name)) { if ($scope->canAccessProperty($parentClassReflection->getProperty($name, $scope))) { return []; } return [RuleErrorBuilder::message(sprintf('Access to private property $%s of parent class %s.', $name, $parentClassReflection->getDisplayName()))->identifier('property.private')->build()]; } $parentClassReflection = $parentClassReflection->getParentClass(); } } $ruleErrorBuilder = RuleErrorBuilder::message(sprintf('Access to an undefined property %s::$%s.', $typeForDescribe->describe(VerbosityLevel::typeOnly()), $name))->identifier('property.notFound'); if ($typeResult->getTip() !== null) { $ruleErrorBuilder->tip($typeResult->getTip()); } else { $ruleErrorBuilder->tip('Learn more: <fg=cyan>https://phpstan.org/blog/solving-phpstan-access-to-undefined-property</>'); } return [$ruleErrorBuilder->build()]; } $propertyReflection = $type->getProperty($name, $scope); if (!$scope->canAccessProperty($propertyReflection)) { return [RuleErrorBuilder::message(sprintf('Access to %s property %s::$%s.', $propertyReflection->isPrivate() ? 'private' : 'protected', $type->describe(VerbosityLevel::typeOnly()), $name))->identifier(sprintf('property.%s', $propertyReflection->isPrivate() ? 'private' : 'protected'))->build()]; } return []; } private function canAccessUndefinedProperties(Scope $scope, Node\Expr $node) : bool { return $scope->isUndefinedExpressionAllowed($node) && !$this->checkDynamicProperties; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Properties; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\ClassPropertyNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\CallableType; use PHPStan\Type\IntersectionType; use PHPStan\Type\Type; use PHPStan\Type\TypeTraverser; use PHPStan\Type\UnionType; use function sprintf; /** * @implements Rule<ClassPropertyNode> */ final class InvalidCallablePropertyTypeRule implements Rule { public function getNodeType() : string { return ClassPropertyNode::class; } public function processNode(Node $node, Scope $scope) : array { $classReflection = $node->getClassReflection(); $propertyReflection = $classReflection->getNativeProperty($node->getName()); if (!$propertyReflection->hasNativeType()) { return []; } $nativeType = $propertyReflection->getNativeType(); $callableTypes = []; TypeTraverser::map($nativeType, static function (Type $type, callable $traverse) use(&$callableTypes) : Type { if ($type instanceof UnionType || $type instanceof IntersectionType) { return $traverse($type); } if ($type instanceof CallableType) { $callableTypes[] = $type; } return $type; }); if ($callableTypes === []) { return []; } return [RuleErrorBuilder::message(sprintf('Property %s::$%s cannot have callable in its type declaration.', $classReflection->getDisplayName(), $node->getName()))->identifier('property.callableType')->nonIgnorable()->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Properties; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\PropertyAssignNode; use PHPStan\Reflection\PropertyReflection; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Rules\RuleLevelHelper; use PHPStan\Type\VerbosityLevel; use function array_merge; use function sprintf; /** * @implements Rule<PropertyAssignNode> */ final class TypesAssignedToPropertiesRule implements Rule { /** * @var RuleLevelHelper */ private $ruleLevelHelper; /** * @var PropertyReflectionFinder */ private $propertyReflectionFinder; public function __construct(RuleLevelHelper $ruleLevelHelper, \PHPStan\Rules\Properties\PropertyReflectionFinder $propertyReflectionFinder) { $this->ruleLevelHelper = $ruleLevelHelper; $this->propertyReflectionFinder = $propertyReflectionFinder; } public function getNodeType() : string { return PropertyAssignNode::class; } public function processNode(Node $node, Scope $scope) : array { $propertyReflections = $this->propertyReflectionFinder->findPropertyReflectionsFromNode($node->getPropertyFetch(), $scope); $errors = []; foreach ($propertyReflections as $propertyReflection) { $errors = array_merge($errors, $this->processSingleProperty($propertyReflection, $node->getAssignedExpr())); } return $errors; } /** * @return list<IdentifierRuleError> */ private function processSingleProperty(\PHPStan\Rules\Properties\FoundPropertyReflection $propertyReflection, Node\Expr $assignedExpr) : array { if (!$propertyReflection->isWritable()) { return []; } $propertyType = $propertyReflection->getWritableType(); $scope = $propertyReflection->getScope(); $assignedValueType = $scope->getType($assignedExpr); $accepts = $this->ruleLevelHelper->acceptsWithReason($propertyType, $assignedValueType, $scope->isDeclareStrictTypes()); if (!$accepts->result) { $propertyDescription = $this->describePropertyByName($propertyReflection, $propertyReflection->getName()); $verbosityLevel = VerbosityLevel::getRecommendedLevelByType($propertyType, $assignedValueType); return [RuleErrorBuilder::message(sprintf('%s (%s) does not accept %s.', $propertyDescription, $propertyType->describe($verbosityLevel), $assignedValueType->describe($verbosityLevel)))->identifier('assign.propertyType')->acceptsReasonsTip($accepts->reasons)->build()]; } return []; } private function describePropertyByName(PropertyReflection $property, string $propertyName) : string { if (!$property->isStatic()) { return sprintf('Property %s::$%s', $property->getDeclaringClass()->getDisplayName(), $propertyName); } return sprintf('Static property %s::$%s', $property->getDeclaringClass()->getDisplayName(), $propertyName); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Properties; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\ClassPropertiesNode; use PHPStan\Reflection\ConstructorsHelper; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function sprintf; /** * @implements Rule<ClassPropertiesNode> */ final class UninitializedPropertyRule implements Rule { /** * @var ConstructorsHelper */ private $constructorsHelper; public function __construct(ConstructorsHelper $constructorsHelper) { $this->constructorsHelper = $constructorsHelper; } public function getNodeType() : string { return ClassPropertiesNode::class; } public function processNode(Node $node, Scope $scope) : array { $classReflection = $node->getClassReflection(); [$properties, $prematureAccess] = $node->getUninitializedProperties($scope, $this->constructorsHelper->getConstructors($classReflection)); $errors = []; foreach ($properties as $propertyName => $propertyNode) { if ($propertyNode->isReadOnly() || $propertyNode->isReadOnlyByPhpDoc()) { continue; } $errors[] = RuleErrorBuilder::message(sprintf('Class %s has an uninitialized property $%s. Give it default value or assign it in the constructor.', $classReflection->getDisplayName(), $propertyName))->line($propertyNode->getStartLine())->identifier('property.uninitialized')->build(); } foreach ($prematureAccess as [$propertyName, $line, $propertyNode, $file, $fileDescription]) { if ($propertyNode->isReadOnly() || $propertyNode->isReadOnlyByPhpDoc()) { continue; } $errors[] = RuleErrorBuilder::message(sprintf('Access to an uninitialized property %s::$%s.', $classReflection->getDisplayName(), $propertyName))->line($line)->file($file, $fileDescription)->identifier('property.uninitialized')->build(); } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Properties; use PHPStan\DependencyInjection\Container; final class LazyReadWritePropertiesExtensionProvider implements \PHPStan\Rules\Properties\ReadWritePropertiesExtensionProvider { /** * @var Container */ private $container; /** @var ReadWritePropertiesExtension[]|null */ private $extensions = null; public function __construct(Container $container) { $this->container = $container; } public function getExtensions() : array { if ($this->extensions === null) { $this->extensions = $this->container->getServicesByTag(\PHPStan\Rules\Properties\ReadWritePropertiesExtensionProvider::EXTENSION_TAG); } return $this->extensions; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Properties; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\PropertyAssignNode; use PHPStan\Rules\Rule; /** * @implements Rule<PropertyAssignNode> */ final class AccessStaticPropertiesInAssignRule implements Rule { /** * @var AccessStaticPropertiesRule */ private $accessStaticPropertiesRule; public function __construct(\PHPStan\Rules\Properties\AccessStaticPropertiesRule $accessStaticPropertiesRule) { $this->accessStaticPropertiesRule = $accessStaticPropertiesRule; } public function getNodeType() : string { return PropertyAssignNode::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->getPropertyFetch() instanceof Node\Expr\StaticPropertyFetch) { return []; } if ($node->isAssignOp()) { return []; } return $this->accessStaticPropertiesRule->processNode($node->getPropertyFetch(), $scope); } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\MetadataRuleError; use PHPStan\Rules\RuleError; use PHPStan\Rules\TipRuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError41 implements RuleError, TipRuleError, MetadataRuleError { /** * @var string */ public $message; /** * @var string */ public $tip; /** @var mixed[] */ public $metadata; public function getMessage() : string { return $this->message; } public function getTip() : string { return $this->tip; } /** * @return mixed[] */ public function getMetadata() : array { return $this->metadata; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\FileRuleError; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\LineRuleError; use PHPStan\Rules\NonIgnorableRuleError; use PHPStan\Rules\RuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError87 implements RuleError, LineRuleError, FileRuleError, IdentifierRuleError, NonIgnorableRuleError { /** * @var string */ public $message; /** * @var int */ public $line; /** * @var string */ public $file; /** * @var string */ public $fileDescription; /** * @var string */ public $identifier; public function getMessage() : string { return $this->message; } public function getLine() : int { return $this->line; } public function getFile() : string { return $this->file; } public function getFileDescription() : string { return $this->fileDescription; } public function getIdentifier() : string { return $this->identifier; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\FileRuleError; use PHPStan\Rules\MetadataRuleError; use PHPStan\Rules\RuleError; use PHPStan\Rules\TipRuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError45 implements RuleError, FileRuleError, TipRuleError, MetadataRuleError { /** * @var string */ public $message; /** * @var string */ public $file; /** * @var string */ public $fileDescription; /** * @var string */ public $tip; /** @var mixed[] */ public $metadata; public function getMessage() : string { return $this->message; } public function getFile() : string { return $this->file; } public function getFileDescription() : string { return $this->fileDescription; } public function getTip() : string { return $this->tip; } /** * @return mixed[] */ public function getMetadata() : array { return $this->metadata; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\FileRuleError; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\NonIgnorableRuleError; use PHPStan\Rules\RuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError85 implements RuleError, FileRuleError, IdentifierRuleError, NonIgnorableRuleError { /** * @var string */ public $message; /** * @var string */ public $file; /** * @var string */ public $fileDescription; /** * @var string */ public $identifier; public function getMessage() : string { return $this->message; } public function getFile() : string { return $this->file; } public function getFileDescription() : string { return $this->fileDescription; } public function getIdentifier() : string { return $this->identifier; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\FileRuleError; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\MetadataRuleError; use PHPStan\Rules\RuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError53 implements RuleError, FileRuleError, IdentifierRuleError, MetadataRuleError { /** * @var string */ public $message; /** * @var string */ public $file; /** * @var string */ public $fileDescription; /** * @var string */ public $identifier; /** @var mixed[] */ public $metadata; public function getMessage() : string { return $this->message; } public function getFile() : string { return $this->file; } public function getFileDescription() : string { return $this->fileDescription; } public function getIdentifier() : string { return $this->identifier; } /** * @return mixed[] */ public function getMetadata() : array { return $this->metadata; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\FileRuleError; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\LineRuleError; use PHPStan\Rules\MetadataRuleError; use PHPStan\Rules\RuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError55 implements RuleError, LineRuleError, FileRuleError, IdentifierRuleError, MetadataRuleError { /** * @var string */ public $message; /** * @var int */ public $line; /** * @var string */ public $file; /** * @var string */ public $fileDescription; /** * @var string */ public $identifier; /** @var mixed[] */ public $metadata; public function getMessage() : string { return $this->message; } public function getLine() : int { return $this->line; } public function getFile() : string { return $this->file; } public function getFileDescription() : string { return $this->fileDescription; } public function getIdentifier() : string { return $this->identifier; } /** * @return mixed[] */ public function getMetadata() : array { return $this->metadata; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\LineRuleError; use PHPStan\Rules\MetadataRuleError; use PHPStan\Rules\NonIgnorableRuleError; use PHPStan\Rules\RuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError115 implements RuleError, LineRuleError, IdentifierRuleError, MetadataRuleError, NonIgnorableRuleError { /** * @var string */ public $message; /** * @var int */ public $line; /** * @var string */ public $identifier; /** @var mixed[] */ public $metadata; public function getMessage() : string { return $this->message; } public function getLine() : int { return $this->line; } public function getIdentifier() : string { return $this->identifier; } /** * @return mixed[] */ public function getMetadata() : array { return $this->metadata; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\FileRuleError; use PHPStan\Rules\LineRuleError; use PHPStan\Rules\RuleError; use PHPStan\Rules\TipRuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError15 implements RuleError, LineRuleError, FileRuleError, TipRuleError { /** * @var string */ public $message; /** * @var int */ public $line; /** * @var string */ public $file; /** * @var string */ public $fileDescription; /** * @var string */ public $tip; public function getMessage() : string { return $this->message; } public function getLine() : int { return $this->line; } public function getFile() : string { return $this->file; } public function getFileDescription() : string { return $this->fileDescription; } public function getTip() : string { return $this->tip; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\FileRuleError; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\RuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError21 implements RuleError, FileRuleError, IdentifierRuleError { /** * @var string */ public $message; /** * @var string */ public $file; /** * @var string */ public $fileDescription; /** * @var string */ public $identifier; public function getMessage() : string { return $this->message; } public function getFile() : string { return $this->file; } public function getFileDescription() : string { return $this->fileDescription; } public function getIdentifier() : string { return $this->identifier; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\LineRuleError; use PHPStan\Rules\MetadataRuleError; use PHPStan\Rules\NonIgnorableRuleError; use PHPStan\Rules\RuleError; use PHPStan\Rules\TipRuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError107 implements RuleError, LineRuleError, TipRuleError, MetadataRuleError, NonIgnorableRuleError { /** * @var string */ public $message; /** * @var int */ public $line; /** * @var string */ public $tip; /** @var mixed[] */ public $metadata; public function getMessage() : string { return $this->message; } public function getLine() : int { return $this->line; } public function getTip() : string { return $this->tip; } /** * @return mixed[] */ public function getMetadata() : array { return $this->metadata; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\FileRuleError; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\RuleError; use PHPStan\Rules\TipRuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError29 implements RuleError, FileRuleError, TipRuleError, IdentifierRuleError { /** * @var string */ public $message; /** * @var string */ public $file; /** * @var string */ public $fileDescription; /** * @var string */ public $tip; /** * @var string */ public $identifier; public function getMessage() : string { return $this->message; } public function getFile() : string { return $this->file; } public function getFileDescription() : string { return $this->fileDescription; } public function getTip() : string { return $this->tip; } public function getIdentifier() : string { return $this->identifier; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\LineRuleError; use PHPStan\Rules\NonIgnorableRuleError; use PHPStan\Rules\RuleError; use PHPStan\Rules\TipRuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError91 implements RuleError, LineRuleError, TipRuleError, IdentifierRuleError, NonIgnorableRuleError { /** * @var string */ public $message; /** * @var int */ public $line; /** * @var string */ public $tip; /** * @var string */ public $identifier; public function getMessage() : string { return $this->message; } public function getLine() : int { return $this->line; } public function getTip() : string { return $this->tip; } public function getIdentifier() : string { return $this->identifier; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\FileRuleError; use PHPStan\Rules\NonIgnorableRuleError; use PHPStan\Rules\RuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError69 implements RuleError, FileRuleError, NonIgnorableRuleError { /** * @var string */ public $message; /** * @var string */ public $file; /** * @var string */ public $fileDescription; public function getMessage() : string { return $this->message; } public function getFile() : string { return $this->file; } public function getFileDescription() : string { return $this->fileDescription; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\LineRuleError; use PHPStan\Rules\RuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError19 implements RuleError, LineRuleError, IdentifierRuleError { /** * @var string */ public $message; /** * @var int */ public $line; /** * @var string */ public $identifier; public function getMessage() : string { return $this->message; } public function getLine() : int { return $this->line; } public function getIdentifier() : string { return $this->identifier; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\LineRuleError; use PHPStan\Rules\NonIgnorableRuleError; use PHPStan\Rules\RuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError83 implements RuleError, LineRuleError, IdentifierRuleError, NonIgnorableRuleError { /** * @var string */ public $message; /** * @var int */ public $line; /** * @var string */ public $identifier; public function getMessage() : string { return $this->message; } public function getLine() : int { return $this->line; } public function getIdentifier() : string { return $this->identifier; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\MetadataRuleError; use PHPStan\Rules\RuleError; use PHPStan\Rules\TipRuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError57 implements RuleError, TipRuleError, IdentifierRuleError, MetadataRuleError { /** * @var string */ public $message; /** * @var string */ public $tip; /** * @var string */ public $identifier; /** @var mixed[] */ public $metadata; public function getMessage() : string { return $this->message; } public function getTip() : string { return $this->tip; } public function getIdentifier() : string { return $this->identifier; } /** * @return mixed[] */ public function getMetadata() : array { return $this->metadata; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\NonIgnorableRuleError; use PHPStan\Rules\RuleError; use PHPStan\Rules\TipRuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError73 implements RuleError, TipRuleError, NonIgnorableRuleError { /** * @var string */ public $message; /** * @var string */ public $tip; public function getMessage() : string { return $this->message; } public function getTip() : string { return $this->tip; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\RuleError; use PHPStan\Rules\TipRuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError9 implements RuleError, TipRuleError { /** * @var string */ public $message; /** * @var string */ public $tip; public function getMessage() : string { return $this->message; } public function getTip() : string { return $this->tip; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\LineRuleError; use PHPStan\Rules\NonIgnorableRuleError; use PHPStan\Rules\RuleError; use PHPStan\Rules\TipRuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError75 implements RuleError, LineRuleError, TipRuleError, NonIgnorableRuleError { /** * @var string */ public $message; /** * @var int */ public $line; /** * @var string */ public $tip; public function getMessage() : string { return $this->message; } public function getLine() : int { return $this->line; } public function getTip() : string { return $this->tip; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\FileRuleError; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\MetadataRuleError; use PHPStan\Rules\RuleError; use PHPStan\Rules\TipRuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError61 implements RuleError, FileRuleError, TipRuleError, IdentifierRuleError, MetadataRuleError { /** * @var string */ public $message; /** * @var string */ public $file; /** * @var string */ public $fileDescription; /** * @var string */ public $tip; /** * @var string */ public $identifier; /** @var mixed[] */ public $metadata; public function getMessage() : string { return $this->message; } public function getFile() : string { return $this->file; } public function getFileDescription() : string { return $this->fileDescription; } public function getTip() : string { return $this->tip; } public function getIdentifier() : string { return $this->identifier; } /** * @return mixed[] */ public function getMetadata() : array { return $this->metadata; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\RuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError17 implements RuleError, IdentifierRuleError { /** * @var string */ public $message; /** * @var string */ public $identifier; public function getMessage() : string { return $this->message; } public function getIdentifier() : string { return $this->identifier; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\LineRuleError; use PHPStan\Rules\MetadataRuleError; use PHPStan\Rules\RuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError51 implements RuleError, LineRuleError, IdentifierRuleError, MetadataRuleError { /** * @var string */ public $message; /** * @var int */ public $line; /** * @var string */ public $identifier; /** @var mixed[] */ public $metadata; public function getMessage() : string { return $this->message; } public function getLine() : int { return $this->line; } public function getIdentifier() : string { return $this->identifier; } /** * @return mixed[] */ public function getMetadata() : array { return $this->metadata; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\LineRuleError; use PHPStan\Rules\MetadataRuleError; use PHPStan\Rules\NonIgnorableRuleError; use PHPStan\Rules\RuleError; use PHPStan\Rules\TipRuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError123 implements RuleError, LineRuleError, TipRuleError, IdentifierRuleError, MetadataRuleError, NonIgnorableRuleError { /** * @var string */ public $message; /** * @var int */ public $line; /** * @var string */ public $tip; /** * @var string */ public $identifier; /** @var mixed[] */ public $metadata; public function getMessage() : string { return $this->message; } public function getLine() : int { return $this->line; } public function getTip() : string { return $this->tip; } public function getIdentifier() : string { return $this->identifier; } /** * @return mixed[] */ public function getMetadata() : array { return $this->metadata; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\LineRuleError; use PHPStan\Rules\MetadataRuleError; use PHPStan\Rules\NonIgnorableRuleError; use PHPStan\Rules\RuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError99 implements RuleError, LineRuleError, MetadataRuleError, NonIgnorableRuleError { /** * @var string */ public $message; /** * @var int */ public $line; /** @var mixed[] */ public $metadata; public function getMessage() : string { return $this->message; } public function getLine() : int { return $this->line; } /** * @return mixed[] */ public function getMetadata() : array { return $this->metadata; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\FileRuleError; use PHPStan\Rules\LineRuleError; use PHPStan\Rules\MetadataRuleError; use PHPStan\Rules\NonIgnorableRuleError; use PHPStan\Rules\RuleError; use PHPStan\Rules\TipRuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError111 implements RuleError, LineRuleError, FileRuleError, TipRuleError, MetadataRuleError, NonIgnorableRuleError { /** * @var string */ public $message; /** * @var int */ public $line; /** * @var string */ public $file; /** * @var string */ public $fileDescription; /** * @var string */ public $tip; /** @var mixed[] */ public $metadata; public function getMessage() : string { return $this->message; } public function getLine() : int { return $this->line; } public function getFile() : string { return $this->file; } public function getFileDescription() : string { return $this->fileDescription; } public function getTip() : string { return $this->tip; } /** * @return mixed[] */ public function getMetadata() : array { return $this->metadata; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\FileRuleError; use PHPStan\Rules\NonIgnorableRuleError; use PHPStan\Rules\RuleError; use PHPStan\Rules\TipRuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError77 implements RuleError, FileRuleError, TipRuleError, NonIgnorableRuleError { /** * @var string */ public $message; /** * @var string */ public $file; /** * @var string */ public $fileDescription; /** * @var string */ public $tip; public function getMessage() : string { return $this->message; } public function getFile() : string { return $this->file; } public function getFileDescription() : string { return $this->fileDescription; } public function getTip() : string { return $this->tip; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\LineRuleError; use PHPStan\Rules\MetadataRuleError; use PHPStan\Rules\RuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError35 implements RuleError, LineRuleError, MetadataRuleError { /** * @var string */ public $message; /** * @var int */ public $line; /** @var mixed[] */ public $metadata; public function getMessage() : string { return $this->message; } public function getLine() : int { return $this->line; } /** * @return mixed[] */ public function getMetadata() : array { return $this->metadata; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\FileRuleError; use PHPStan\Rules\MetadataRuleError; use PHPStan\Rules\NonIgnorableRuleError; use PHPStan\Rules\RuleError; use PHPStan\Rules\TipRuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError109 implements RuleError, FileRuleError, TipRuleError, MetadataRuleError, NonIgnorableRuleError { /** * @var string */ public $message; /** * @var string */ public $file; /** * @var string */ public $fileDescription; /** * @var string */ public $tip; /** @var mixed[] */ public $metadata; public function getMessage() : string { return $this->message; } public function getFile() : string { return $this->file; } public function getFileDescription() : string { return $this->fileDescription; } public function getTip() : string { return $this->tip; } /** * @return mixed[] */ public function getMetadata() : array { return $this->metadata; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\FileRuleError; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\LineRuleError; use PHPStan\Rules\RuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError23 implements RuleError, LineRuleError, FileRuleError, IdentifierRuleError { /** * @var string */ public $message; /** * @var int */ public $line; /** * @var string */ public $file; /** * @var string */ public $fileDescription; /** * @var string */ public $identifier; public function getMessage() : string { return $this->message; } public function getLine() : int { return $this->line; } public function getFile() : string { return $this->file; } public function getFileDescription() : string { return $this->fileDescription; } public function getIdentifier() : string { return $this->identifier; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\LineRuleError; use PHPStan\Rules\MetadataRuleError; use PHPStan\Rules\RuleError; use PHPStan\Rules\TipRuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError43 implements RuleError, LineRuleError, TipRuleError, MetadataRuleError { /** * @var string */ public $message; /** * @var int */ public $line; /** * @var string */ public $tip; /** @var mixed[] */ public $metadata; public function getMessage() : string { return $this->message; } public function getLine() : int { return $this->line; } public function getTip() : string { return $this->tip; } /** * @return mixed[] */ public function getMetadata() : array { return $this->metadata; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\FileRuleError; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\NonIgnorableRuleError; use PHPStan\Rules\RuleError; use PHPStan\Rules\TipRuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError93 implements RuleError, FileRuleError, TipRuleError, IdentifierRuleError, NonIgnorableRuleError { /** * @var string */ public $message; /** * @var string */ public $file; /** * @var string */ public $fileDescription; /** * @var string */ public $tip; /** * @var string */ public $identifier; public function getMessage() : string { return $this->message; } public function getFile() : string { return $this->file; } public function getFileDescription() : string { return $this->fileDescription; } public function getTip() : string { return $this->tip; } public function getIdentifier() : string { return $this->identifier; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\FileRuleError; use PHPStan\Rules\LineRuleError; use PHPStan\Rules\MetadataRuleError; use PHPStan\Rules\RuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError39 implements RuleError, LineRuleError, FileRuleError, MetadataRuleError { /** * @var string */ public $message; /** * @var int */ public $line; /** * @var string */ public $file; /** * @var string */ public $fileDescription; /** @var mixed[] */ public $metadata; public function getMessage() : string { return $this->message; } public function getLine() : int { return $this->line; } public function getFile() : string { return $this->file; } public function getFileDescription() : string { return $this->fileDescription; } /** * @return mixed[] */ public function getMetadata() : array { return $this->metadata; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\MetadataRuleError; use PHPStan\Rules\NonIgnorableRuleError; use PHPStan\Rules\RuleError; use PHPStan\Rules\TipRuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError121 implements RuleError, TipRuleError, IdentifierRuleError, MetadataRuleError, NonIgnorableRuleError { /** * @var string */ public $message; /** * @var string */ public $tip; /** * @var string */ public $identifier; /** @var mixed[] */ public $metadata; public function getMessage() : string { return $this->message; } public function getTip() : string { return $this->tip; } public function getIdentifier() : string { return $this->identifier; } /** * @return mixed[] */ public function getMetadata() : array { return $this->metadata; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\FileRuleError; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\LineRuleError; use PHPStan\Rules\MetadataRuleError; use PHPStan\Rules\NonIgnorableRuleError; use PHPStan\Rules\RuleError; use PHPStan\Rules\TipRuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError127 implements RuleError, LineRuleError, FileRuleError, TipRuleError, IdentifierRuleError, MetadataRuleError, NonIgnorableRuleError { /** * @var string */ public $message; /** * @var int */ public $line; /** * @var string */ public $file; /** * @var string */ public $fileDescription; /** * @var string */ public $tip; /** * @var string */ public $identifier; /** @var mixed[] */ public $metadata; public function getMessage() : string { return $this->message; } public function getLine() : int { return $this->line; } public function getFile() : string { return $this->file; } public function getFileDescription() : string { return $this->fileDescription; } public function getTip() : string { return $this->tip; } public function getIdentifier() : string { return $this->identifier; } /** * @return mixed[] */ public function getMetadata() : array { return $this->metadata; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\FileRuleError; use PHPStan\Rules\LineRuleError; use PHPStan\Rules\MetadataRuleError; use PHPStan\Rules\RuleError; use PHPStan\Rules\TipRuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError47 implements RuleError, LineRuleError, FileRuleError, TipRuleError, MetadataRuleError { /** * @var string */ public $message; /** * @var int */ public $line; /** * @var string */ public $file; /** * @var string */ public $fileDescription; /** * @var string */ public $tip; /** @var mixed[] */ public $metadata; public function getMessage() : string { return $this->message; } public function getLine() : int { return $this->line; } public function getFile() : string { return $this->file; } public function getFileDescription() : string { return $this->fileDescription; } public function getTip() : string { return $this->tip; } /** * @return mixed[] */ public function getMetadata() : array { return $this->metadata; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\FileRuleError; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\LineRuleError; use PHPStan\Rules\MetadataRuleError; use PHPStan\Rules\NonIgnorableRuleError; use PHPStan\Rules\RuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError119 implements RuleError, LineRuleError, FileRuleError, IdentifierRuleError, MetadataRuleError, NonIgnorableRuleError { /** * @var string */ public $message; /** * @var int */ public $line; /** * @var string */ public $file; /** * @var string */ public $fileDescription; /** * @var string */ public $identifier; /** @var mixed[] */ public $metadata; public function getMessage() : string { return $this->message; } public function getLine() : int { return $this->line; } public function getFile() : string { return $this->file; } public function getFileDescription() : string { return $this->fileDescription; } public function getIdentifier() : string { return $this->identifier; } /** * @return mixed[] */ public function getMetadata() : array { return $this->metadata; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\MetadataRuleError; use PHPStan\Rules\NonIgnorableRuleError; use PHPStan\Rules\RuleError; use PHPStan\Rules\TipRuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError105 implements RuleError, TipRuleError, MetadataRuleError, NonIgnorableRuleError { /** * @var string */ public $message; /** * @var string */ public $tip; /** @var mixed[] */ public $metadata; public function getMessage() : string { return $this->message; } public function getTip() : string { return $this->tip; } /** * @return mixed[] */ public function getMetadata() : array { return $this->metadata; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\RuleError; use PHPStan\Rules\TipRuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError25 implements RuleError, TipRuleError, IdentifierRuleError { /** * @var string */ public $message; /** * @var string */ public $tip; /** * @var string */ public $identifier; public function getMessage() : string { return $this->message; } public function getTip() : string { return $this->tip; } public function getIdentifier() : string { return $this->identifier; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\MetadataRuleError; use PHPStan\Rules\RuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError49 implements RuleError, IdentifierRuleError, MetadataRuleError { /** * @var string */ public $message; /** * @var string */ public $identifier; /** @var mixed[] */ public $metadata; public function getMessage() : string { return $this->message; } public function getIdentifier() : string { return $this->identifier; } /** * @return mixed[] */ public function getMetadata() : array { return $this->metadata; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\FileRuleError; use PHPStan\Rules\MetadataRuleError; use PHPStan\Rules\RuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError37 implements RuleError, FileRuleError, MetadataRuleError { /** * @var string */ public $message; /** * @var string */ public $file; /** * @var string */ public $fileDescription; /** @var mixed[] */ public $metadata; public function getMessage() : string { return $this->message; } public function getFile() : string { return $this->file; } public function getFileDescription() : string { return $this->fileDescription; } /** * @return mixed[] */ public function getMetadata() : array { return $this->metadata; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\MetadataRuleError; use PHPStan\Rules\RuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError33 implements RuleError, MetadataRuleError { /** * @var string */ public $message; /** @var mixed[] */ public $metadata; public function getMessage() : string { return $this->message; } /** * @return mixed[] */ public function getMetadata() : array { return $this->metadata; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\FileRuleError; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\MetadataRuleError; use PHPStan\Rules\NonIgnorableRuleError; use PHPStan\Rules\RuleError; use PHPStan\Rules\TipRuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError125 implements RuleError, FileRuleError, TipRuleError, IdentifierRuleError, MetadataRuleError, NonIgnorableRuleError { /** * @var string */ public $message; /** * @var string */ public $file; /** * @var string */ public $fileDescription; /** * @var string */ public $tip; /** * @var string */ public $identifier; /** @var mixed[] */ public $metadata; public function getMessage() : string { return $this->message; } public function getFile() : string { return $this->file; } public function getFileDescription() : string { return $this->fileDescription; } public function getTip() : string { return $this->tip; } public function getIdentifier() : string { return $this->identifier; } /** * @return mixed[] */ public function getMetadata() : array { return $this->metadata; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\RuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError1 implements RuleError { /** * @var string */ public $message; public function getMessage() : string { return $this->message; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\NonIgnorableRuleError; use PHPStan\Rules\RuleError; use PHPStan\Rules\TipRuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError89 implements RuleError, TipRuleError, IdentifierRuleError, NonIgnorableRuleError { /** * @var string */ public $message; /** * @var string */ public $tip; /** * @var string */ public $identifier; public function getMessage() : string { return $this->message; } public function getTip() : string { return $this->tip; } public function getIdentifier() : string { return $this->identifier; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\FileRuleError; use PHPStan\Rules\LineRuleError; use PHPStan\Rules\RuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError7 implements RuleError, LineRuleError, FileRuleError { /** * @var string */ public $message; /** * @var int */ public $line; /** * @var string */ public $file; /** * @var string */ public $fileDescription; public function getMessage() : string { return $this->message; } public function getLine() : int { return $this->line; } public function getFile() : string { return $this->file; } public function getFileDescription() : string { return $this->fileDescription; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\FileRuleError; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\LineRuleError; use PHPStan\Rules\MetadataRuleError; use PHPStan\Rules\RuleError; use PHPStan\Rules\TipRuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError63 implements RuleError, LineRuleError, FileRuleError, TipRuleError, IdentifierRuleError, MetadataRuleError { /** * @var string */ public $message; /** * @var int */ public $line; /** * @var string */ public $file; /** * @var string */ public $fileDescription; /** * @var string */ public $tip; /** * @var string */ public $identifier; /** @var mixed[] */ public $metadata; public function getMessage() : string { return $this->message; } public function getLine() : int { return $this->line; } public function getFile() : string { return $this->file; } public function getFileDescription() : string { return $this->fileDescription; } public function getTip() : string { return $this->tip; } public function getIdentifier() : string { return $this->identifier; } /** * @return mixed[] */ public function getMetadata() : array { return $this->metadata; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\MetadataRuleError; use PHPStan\Rules\NonIgnorableRuleError; use PHPStan\Rules\RuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError113 implements RuleError, IdentifierRuleError, MetadataRuleError, NonIgnorableRuleError { /** * @var string */ public $message; /** * @var string */ public $identifier; /** @var mixed[] */ public $metadata; public function getMessage() : string { return $this->message; } public function getIdentifier() : string { return $this->identifier; } /** * @return mixed[] */ public function getMetadata() : array { return $this->metadata; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\LineRuleError; use PHPStan\Rules\MetadataRuleError; use PHPStan\Rules\RuleError; use PHPStan\Rules\TipRuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError59 implements RuleError, LineRuleError, TipRuleError, IdentifierRuleError, MetadataRuleError { /** * @var string */ public $message; /** * @var int */ public $line; /** * @var string */ public $tip; /** * @var string */ public $identifier; /** @var mixed[] */ public $metadata; public function getMessage() : string { return $this->message; } public function getLine() : int { return $this->line; } public function getTip() : string { return $this->tip; } public function getIdentifier() : string { return $this->identifier; } /** * @return mixed[] */ public function getMetadata() : array { return $this->metadata; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\LineRuleError; use PHPStan\Rules\NonIgnorableRuleError; use PHPStan\Rules\RuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError67 implements RuleError, LineRuleError, NonIgnorableRuleError { /** * @var string */ public $message; /** * @var int */ public $line; public function getMessage() : string { return $this->message; } public function getLine() : int { return $this->line; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\FileRuleError; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\MetadataRuleError; use PHPStan\Rules\NonIgnorableRuleError; use PHPStan\Rules\RuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError117 implements RuleError, FileRuleError, IdentifierRuleError, MetadataRuleError, NonIgnorableRuleError { /** * @var string */ public $message; /** * @var string */ public $file; /** * @var string */ public $fileDescription; /** * @var string */ public $identifier; /** @var mixed[] */ public $metadata; public function getMessage() : string { return $this->message; } public function getFile() : string { return $this->file; } public function getFileDescription() : string { return $this->fileDescription; } public function getIdentifier() : string { return $this->identifier; } /** * @return mixed[] */ public function getMetadata() : array { return $this->metadata; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\LineRuleError; use PHPStan\Rules\RuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError3 implements RuleError, LineRuleError { /** * @var string */ public $message; /** * @var int */ public $line; public function getMessage() : string { return $this->message; } public function getLine() : int { return $this->line; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\FileRuleError; use PHPStan\Rules\LineRuleError; use PHPStan\Rules\NonIgnorableRuleError; use PHPStan\Rules\RuleError; use PHPStan\Rules\TipRuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError79 implements RuleError, LineRuleError, FileRuleError, TipRuleError, NonIgnorableRuleError { /** * @var string */ public $message; /** * @var int */ public $line; /** * @var string */ public $file; /** * @var string */ public $fileDescription; /** * @var string */ public $tip; public function getMessage() : string { return $this->message; } public function getLine() : int { return $this->line; } public function getFile() : string { return $this->file; } public function getFileDescription() : string { return $this->fileDescription; } public function getTip() : string { return $this->tip; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\NonIgnorableRuleError; use PHPStan\Rules\RuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError65 implements RuleError, NonIgnorableRuleError { /** * @var string */ public $message; public function getMessage() : string { return $this->message; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\FileRuleError; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\LineRuleError; use PHPStan\Rules\NonIgnorableRuleError; use PHPStan\Rules\RuleError; use PHPStan\Rules\TipRuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError95 implements RuleError, LineRuleError, FileRuleError, TipRuleError, IdentifierRuleError, NonIgnorableRuleError { /** * @var string */ public $message; /** * @var int */ public $line; /** * @var string */ public $file; /** * @var string */ public $fileDescription; /** * @var string */ public $tip; /** * @var string */ public $identifier; public function getMessage() : string { return $this->message; } public function getLine() : int { return $this->line; } public function getFile() : string { return $this->file; } public function getFileDescription() : string { return $this->fileDescription; } public function getTip() : string { return $this->tip; } public function getIdentifier() : string { return $this->identifier; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\NonIgnorableRuleError; use PHPStan\Rules\RuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError81 implements RuleError, IdentifierRuleError, NonIgnorableRuleError { /** * @var string */ public $message; /** * @var string */ public $identifier; public function getMessage() : string { return $this->message; } public function getIdentifier() : string { return $this->identifier; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\FileRuleError; use PHPStan\Rules\MetadataRuleError; use PHPStan\Rules\NonIgnorableRuleError; use PHPStan\Rules\RuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError101 implements RuleError, FileRuleError, MetadataRuleError, NonIgnorableRuleError { /** * @var string */ public $message; /** * @var string */ public $file; /** * @var string */ public $fileDescription; /** @var mixed[] */ public $metadata; public function getMessage() : string { return $this->message; } public function getFile() : string { return $this->file; } public function getFileDescription() : string { return $this->fileDescription; } /** * @return mixed[] */ public function getMetadata() : array { return $this->metadata; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\FileRuleError; use PHPStan\Rules\LineRuleError; use PHPStan\Rules\MetadataRuleError; use PHPStan\Rules\NonIgnorableRuleError; use PHPStan\Rules\RuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError103 implements RuleError, LineRuleError, FileRuleError, MetadataRuleError, NonIgnorableRuleError { /** * @var string */ public $message; /** * @var int */ public $line; /** * @var string */ public $file; /** * @var string */ public $fileDescription; /** @var mixed[] */ public $metadata; public function getMessage() : string { return $this->message; } public function getLine() : int { return $this->line; } public function getFile() : string { return $this->file; } public function getFileDescription() : string { return $this->fileDescription; } /** * @return mixed[] */ public function getMetadata() : array { return $this->metadata; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\LineRuleError; use PHPStan\Rules\RuleError; use PHPStan\Rules\TipRuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError11 implements RuleError, LineRuleError, TipRuleError { /** * @var string */ public $message; /** * @var int */ public $line; /** * @var string */ public $tip; public function getMessage() : string { return $this->message; } public function getLine() : int { return $this->line; } public function getTip() : string { return $this->tip; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\FileRuleError; use PHPStan\Rules\RuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError5 implements RuleError, FileRuleError { /** * @var string */ public $message; /** * @var string */ public $file; /** * @var string */ public $fileDescription; public function getMessage() : string { return $this->message; } public function getFile() : string { return $this->file; } public function getFileDescription() : string { return $this->fileDescription; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\FileRuleError; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\LineRuleError; use PHPStan\Rules\RuleError; use PHPStan\Rules\TipRuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError31 implements RuleError, LineRuleError, FileRuleError, TipRuleError, IdentifierRuleError { /** * @var string */ public $message; /** * @var int */ public $line; /** * @var string */ public $file; /** * @var string */ public $fileDescription; /** * @var string */ public $tip; /** * @var string */ public $identifier; public function getMessage() : string { return $this->message; } public function getLine() : int { return $this->line; } public function getFile() : string { return $this->file; } public function getFileDescription() : string { return $this->fileDescription; } public function getTip() : string { return $this->tip; } public function getIdentifier() : string { return $this->identifier; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\LineRuleError; use PHPStan\Rules\RuleError; use PHPStan\Rules\TipRuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError27 implements RuleError, LineRuleError, TipRuleError, IdentifierRuleError { /** * @var string */ public $message; /** * @var int */ public $line; /** * @var string */ public $tip; /** * @var string */ public $identifier; public function getMessage() : string { return $this->message; } public function getLine() : int { return $this->line; } public function getTip() : string { return $this->tip; } public function getIdentifier() : string { return $this->identifier; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\MetadataRuleError; use PHPStan\Rules\NonIgnorableRuleError; use PHPStan\Rules\RuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError97 implements RuleError, MetadataRuleError, NonIgnorableRuleError { /** * @var string */ public $message; /** @var mixed[] */ public $metadata; public function getMessage() : string { return $this->message; } /** * @return mixed[] */ public function getMetadata() : array { return $this->metadata; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\FileRuleError; use PHPStan\Rules\RuleError; use PHPStan\Rules\TipRuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError13 implements RuleError, FileRuleError, TipRuleError { /** * @var string */ public $message; /** * @var string */ public $file; /** * @var string */ public $fileDescription; /** * @var string */ public $tip; public function getMessage() : string { return $this->message; } public function getFile() : string { return $this->file; } public function getFileDescription() : string { return $this->fileDescription; } public function getTip() : string { return $this->tip; } } <?php declare (strict_types=1); namespace PHPStan\Rules\RuleErrors; use PHPStan\Rules\FileRuleError; use PHPStan\Rules\LineRuleError; use PHPStan\Rules\NonIgnorableRuleError; use PHPStan\Rules\RuleError; /** * @internal Use PHPStan\Rules\RuleErrorBuilder instead. */ final class RuleError71 implements RuleError, LineRuleError, FileRuleError, NonIgnorableRuleError { /** * @var string */ public $message; /** * @var int */ public $line; /** * @var string */ public $file; /** * @var string */ public $fileDescription; public function getMessage() : string { return $this->message; } public function getLine() : int { return $this->line; } public function getFile() : string { return $this->file; } public function getFileDescription() : string { return $this->fileDescription; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Whitespace; use _PHPStan_7d8742a37\Nette\Utils\Strings; use PhpParser\Node; use PhpParser\NodeTraverser; use PhpParser\NodeVisitorAbstract; use PHPStan\Analyser\Scope; use PHPStan\Node\FileNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function count; /** * @implements Rule<FileNode> */ final class FileWhitespaceRule implements Rule { public function getNodeType() : string { return FileNode::class; } public function processNode(Node $node, Scope $scope) : array { $nodes = $node->getNodes(); if (count($nodes) === 0) { return []; } $firstNode = $nodes[0]; $messages = []; if ($firstNode instanceof Node\Stmt\InlineHTML && $firstNode->value === "") { $messages[] = RuleErrorBuilder::message('File begins with UTF-8 BOM character. This may cause problems when running the code in the web browser.')->identifier('whitespace.bom')->build(); } $nodeTraverser = new NodeTraverser(); $visitor = new class extends NodeVisitorAbstract { /** @var Node[] */ private $lastNodes = []; /** * @return int|null */ public function enterNode(Node $node) { if ($node instanceof Node\Stmt\Declare_) { if ($node->stmts !== null && count($node->stmts) > 0) { $this->lastNodes[] = $node->stmts[count($node->stmts) - 1]; } return null; } if ($node instanceof Node\Stmt\Namespace_) { if (count($node->stmts) > 0) { $this->lastNodes[] = $node->stmts[count($node->stmts) - 1]; } return null; } return NodeTraverser::DONT_TRAVERSE_CURRENT_AND_CHILDREN; } /** * @return Node[] */ public function getLastNodes() : array { return $this->lastNodes; } }; $nodeTraverser->addVisitor($visitor); $nodeTraverser->traverse($nodes); $lastNodes = $visitor->getLastNodes(); $lastNodes[] = $nodes[count($nodes) - 1]; foreach ($lastNodes as $lastNode) { if (!$lastNode instanceof Node\Stmt\InlineHTML || Strings::match($lastNode->value, '#^(\\s+)$#') === null) { continue; } $messages[] = RuleErrorBuilder::message('File ends with a trailing whitespace. This may cause problems when running the code in the web browser. Remove the closing ?> mark or remove the whitespace.')->line($lastNode->getStartLine())->identifier('whitespace.fileEnd')->build(); } return $messages; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Constants; use PHPStan\Reflection\ConstantReflection; /** * This is the extension interface to implement if you want to describe * always-used class constant. * * To register it in the configuration file use the `phpstan.constants.alwaysUsedClassConstantsExtension` service tag: * * ``` * services: * - * class: App\PHPStan\MyExtension * tags: * - phpstan.constants.alwaysUsedClassConstantsExtension * ``` * * Learn more: https://phpstan.org/developing-extensions/always-used-class-constants * * @api */ interface AlwaysUsedClassConstantsExtension { public function isAlwaysUsed(ConstantReflection $constant) : bool; } <?php declare (strict_types=1); namespace PHPStan\Rules\Constants; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ClassReflection; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\ShouldNotHappenException; use PHPStan\Type\ParserNodeTypeToPHPStanType; use PHPStan\Type\Type; use PHPStan\Type\VerbosityLevel; use function array_merge; use function sprintf; /** * @implements Rule<Node\Stmt\ClassConst> */ final class ValueAssignedToClassConstantRule implements Rule { public function getNodeType() : string { return Node\Stmt\ClassConst::class; } public function processNode(Node $node, Scope $scope) : array { if (!$scope->isInClass()) { throw new ShouldNotHappenException(); } $nativeType = null; if ($node->type !== null) { $nativeType = ParserNodeTypeToPHPStanType::resolve($node->type, $scope->getClassReflection()); } $errors = []; foreach ($node->consts as $const) { $constantName = $const->name->toString(); $errors = array_merge($errors, $this->processSingleConstant($scope->getClassReflection(), $constantName, $scope->getType($const->value), $nativeType)); } return $errors; } /** * @return list<IdentifierRuleError> */ private function processSingleConstant(ClassReflection $classReflection, string $constantName, Type $valueExprType, ?Type $nativeType) : array { $constantReflection = $classReflection->getConstant($constantName); $phpDocType = $constantReflection->getPhpDocType(); if ($phpDocType === null) { if ($nativeType === null) { return []; } $accepts = $nativeType->acceptsWithReason($valueExprType, \true); if ($accepts->yes()) { return []; } return [RuleErrorBuilder::message(sprintf('Constant %s::%s (%s) does not accept value %s.', $constantReflection->getDeclaringClass()->getDisplayName(), $constantName, $nativeType->describe(VerbosityLevel::typeOnly()), $valueExprType->describe(VerbosityLevel::value())))->acceptsReasonsTip($accepts->reasons)->nonIgnorable()->identifier('classConstant.value')->build()]; } elseif ($nativeType === null) { $isSuperType = $phpDocType->isSuperTypeOf($valueExprType); $verbosity = VerbosityLevel::getRecommendedLevelByType($phpDocType, $valueExprType); if ($isSuperType->no()) { return [RuleErrorBuilder::message(sprintf('PHPDoc tag @var for constant %s::%s with type %s is incompatible with value %s.', $constantReflection->getDeclaringClass()->getDisplayName(), $constantName, $phpDocType->describe($verbosity), $valueExprType->describe(VerbosityLevel::value())))->identifier('classConstant.phpDocType')->build()]; } elseif ($isSuperType->maybe()) { return [RuleErrorBuilder::message(sprintf('PHPDoc tag @var for constant %s::%s with type %s is not subtype of value %s.', $constantReflection->getDeclaringClass()->getDisplayName(), $constantName, $phpDocType->describe($verbosity), $valueExprType->describe(VerbosityLevel::value())))->identifier('classConstant.phpDocType')->build()]; } return []; } $type = $constantReflection->getValueType(); $accepts = $type->acceptsWithReason($valueExprType, \true); if ($accepts->yes()) { return []; } $verbosity = VerbosityLevel::getRecommendedLevelByType($type, $valueExprType); return [RuleErrorBuilder::message(sprintf('Constant %s::%s (%s) does not accept value %s.', $constantReflection->getDeclaringClass()->getDisplayName(), $constantName, $type->describe(VerbosityLevel::typeOnly()), $valueExprType->describe($verbosity)))->acceptsReasonsTip($accepts->reasons)->identifier('classConstant.value')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Constants; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function sprintf; /** * @implements Rule<Node\Expr\ConstFetch> */ final class ConstantRule implements Rule { public function getNodeType() : string { return Node\Expr\ConstFetch::class; } public function processNode(Node $node, Scope $scope) : array { if (!$scope->hasConstant($node->name)) { return [RuleErrorBuilder::message(sprintf('Constant %s not found.', (string) $node->name))->identifier('constant.notFound')->discoveringSymbolsTip()->build()]; } return []; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Constants; use PhpParser\Node; use PhpParser\Node\Scalar\MagicConst; use PHPStan\Analyser\Scope; use PHPStan\Parser\MagicConstantParamDefaultVisitor; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function sprintf; /** @implements Rule<MagicConst> */ final class MagicConstantContextRule implements Rule { public function getNodeType() : string { return MagicConst::class; } public function processNode(Node $node, Scope $scope) : array { // test cases https://3v4l.org/ZUvvr if ($node instanceof MagicConst\Class_) { if ($scope->isInClass()) { return []; } return [RuleErrorBuilder::message(sprintf('Magic constant %s is always empty outside a class.', $node->getName()))->identifier('magicConstant.outOfClass')->build()]; } elseif ($node instanceof MagicConst\Trait_) { if ($scope->isInTrait()) { return []; } return [RuleErrorBuilder::message(sprintf('Magic constant %s is always empty outside a trait.', $node->getName()))->identifier('magicConstant.outOfTrait')->build()]; } elseif ($node instanceof MagicConst\Method || $node instanceof MagicConst\Function_) { if ($scope->getFunctionName() !== null) { return []; } if ($scope->isInAnonymousFunction()) { return []; } if ((bool) $node->getAttribute(MagicConstantParamDefaultVisitor::ATTRIBUTE_NAME)) { return []; } return [RuleErrorBuilder::message(sprintf('Magic constant %s is always empty outside a function.', $node->getName()))->identifier('magicConstant.outOfFunction')->build()]; } elseif ($node instanceof MagicConst\Namespace_) { if ($scope->getNamespace() === null) { return [RuleErrorBuilder::message(sprintf('Magic constant %s is always empty in global namespace.', $node->getName()))->identifier('magicConstant.outOfNamespace')->build()]; } } return []; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Constants; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ClassConstantReflection; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ConstantReflection; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\ShouldNotHappenException; use PHPStan\Type\VerbosityLevel; use function array_merge; use function sprintf; /** * @implements Rule<Node\Stmt\ClassConst> */ final class OverridingConstantRule implements Rule { /** * @var bool */ private $checkPhpDocMethodSignatures; public function __construct(bool $checkPhpDocMethodSignatures) { $this->checkPhpDocMethodSignatures = $checkPhpDocMethodSignatures; } public function getNodeType() : string { return Node\Stmt\ClassConst::class; } public function processNode(Node $node, Scope $scope) : array { if (!$scope->isInClass()) { throw new ShouldNotHappenException(); } $errors = []; foreach ($node->consts as $const) { $constantName = $const->name->toString(); $errors = array_merge($errors, $this->processSingleConstant($scope->getClassReflection(), $constantName)); } return $errors; } /** * @return list<IdentifierRuleError> */ private function processSingleConstant(ClassReflection $classReflection, string $constantName) : array { $prototype = $this->findPrototype($classReflection, $constantName); if (!$prototype instanceof ClassConstantReflection) { return []; } $constantReflection = $classReflection->getConstant($constantName); $errors = []; if ($prototype->isFinal()) { $errors[] = RuleErrorBuilder::message(sprintf('Constant %s::%s overrides final constant %s::%s.', $classReflection->getDisplayName(), $constantReflection->getName(), $prototype->getDeclaringClass()->getDisplayName(), $prototype->getName()))->identifier('classConstant.final')->nonIgnorable()->build(); } if ($prototype->isPublic()) { if (!$constantReflection->isPublic()) { $errors[] = RuleErrorBuilder::message(sprintf('%s constant %s::%s overriding public constant %s::%s should also be public.', $constantReflection->isPrivate() ? 'Private' : 'Protected', $constantReflection->getDeclaringClass()->getDisplayName(), $constantReflection->getName(), $prototype->getDeclaringClass()->getDisplayName(), $prototype->getName()))->identifier('classConstant.visibility')->nonIgnorable()->build(); } } elseif ($constantReflection->isPrivate()) { $errors[] = RuleErrorBuilder::message(sprintf('Private constant %s::%s overriding protected constant %s::%s should be protected or public.', $constantReflection->getDeclaringClass()->getDisplayName(), $constantReflection->getName(), $prototype->getDeclaringClass()->getDisplayName(), $prototype->getName()))->identifier('classConstant.visibility')->nonIgnorable()->build(); } if (!$this->checkPhpDocMethodSignatures) { return $errors; } $prototypeNativeType = $prototype->getNativeType(); $constantNativeType = $constantReflection->getNativeType(); if ($prototypeNativeType !== null) { if ($constantNativeType !== null) { if (!$prototypeNativeType->isSuperTypeOf($constantNativeType)->yes()) { $errors[] = RuleErrorBuilder::message(sprintf('Native type %s of constant %s::%s is not covariant with native type %s of constant %s::%s.', $constantNativeType->describe(VerbosityLevel::typeOnly()), $constantReflection->getDeclaringClass()->getDisplayName(), $constantReflection->getName(), $prototypeNativeType->describe(VerbosityLevel::typeOnly()), $prototype->getDeclaringClass()->getDisplayName(), $prototype->getName()))->identifier('classConstant.nativeType')->nonIgnorable()->build(); } } else { $errors[] = RuleErrorBuilder::message(sprintf('Constant %s::%s overriding constant %s::%s (%s) should also have native type %s.', $constantReflection->getDeclaringClass()->getDisplayName(), $constantReflection->getName(), $prototype->getDeclaringClass()->getDisplayName(), $prototype->getName(), $prototypeNativeType->describe(VerbosityLevel::typeOnly()), $prototypeNativeType->describe(VerbosityLevel::typeOnly())))->identifier('classConstant.missingNativeType')->nonIgnorable()->build(); } } if (!$prototype->hasPhpDocType()) { return $errors; } if (!$constantReflection->hasPhpDocType()) { return $errors; } if (!$prototype->getValueType()->isSuperTypeOf($constantReflection->getValueType())->yes()) { $errors[] = RuleErrorBuilder::message(sprintf('Type %s of constant %s::%s is not covariant with type %s of constant %s::%s.', $constantReflection->getValueType()->describe(VerbosityLevel::value()), $constantReflection->getDeclaringClass()->getDisplayName(), $constantReflection->getName(), $prototype->getValueType()->describe(VerbosityLevel::value()), $prototype->getDeclaringClass()->getDisplayName(), $prototype->getName()))->identifier('classConstant.type')->build(); } return $errors; } private function findPrototype(ClassReflection $classReflection, string $constantName) : ?ConstantReflection { foreach ($classReflection->getImmediateInterfaces() as $immediateInterface) { if ($immediateInterface->hasConstant($constantName)) { return $immediateInterface->getConstant($constantName); } } $parentClass = $classReflection->getParentClass(); if ($parentClass === null) { return null; } if (!$parentClass->hasConstant($constantName)) { return null; } $constant = $parentClass->getConstant($constantName); if ($constant->isPrivate()) { return null; } return $constant; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Constants; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Php\PhpVersion; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; /** * @implements Rule<Node\Stmt\ClassConst> */ final class NativeTypedClassConstantRule implements Rule { /** * @var PhpVersion */ private $phpVersion; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; } public function getNodeType() : string { return Node\Stmt\ClassConst::class; } public function processNode(Node $node, Scope $scope) : array { if ($node->type === null) { return []; } if ($this->phpVersion->supportsNativeTypesInClassConstants()) { return []; } return [RuleErrorBuilder::message('Class constants with native types are supported only on PHP 8.3 and later.')->identifier('classConstant.nativeTypeNotSupported')->nonIgnorable()->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Constants; use PHPStan\DependencyInjection\Container; final class LazyAlwaysUsedClassConstantsExtensionProvider implements \PHPStan\Rules\Constants\AlwaysUsedClassConstantsExtensionProvider { /** * @var Container */ private $container; /** @var AlwaysUsedClassConstantsExtension[]|null */ private $extensions = null; public function __construct(Container $container) { $this->container = $container; } public function getExtensions() : array { if ($this->extensions === null) { $this->extensions = $this->container->getServicesByTag(\PHPStan\Rules\Constants\AlwaysUsedClassConstantsExtensionProvider::EXTENSION_TAG); } return $this->extensions; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Constants; use PhpParser\Node; use PhpParser\Node\Stmt\ClassConst; use PHPStan\Analyser\Scope; use PHPStan\Php\PhpVersion; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; /** @implements Rule<ClassConst> */ final class FinalConstantRule implements Rule { /** * @var PhpVersion */ private $phpVersion; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; } public function getNodeType() : string { return ClassConst::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->isFinal()) { return []; } if ($this->phpVersion->supportsFinalConstants()) { return []; } return [RuleErrorBuilder::message('Final class constants are supported only on PHP 8.1 and later.')->identifier('classConstant.finalNotSupported')->nonIgnorable()->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Constants; interface AlwaysUsedClassConstantsExtensionProvider { public const EXTENSION_TAG = 'phpstan.constants.alwaysUsedClassConstantsExtension'; /** * @return AlwaysUsedClassConstantsExtension[] */ public function getExtensions() : array; } <?php declare (strict_types=1); namespace PHPStan\Rules\Constants; use PhpParser\Node; use PhpParser\Node\Expr\ClassConstFetch; use PHPStan\Analyser\Scope; use PHPStan\Php\PhpVersion; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Rules\RuleLevelHelper; use PHPStan\Type\ErrorType; use PHPStan\Type\Type; use PHPStan\Type\VerbosityLevel; use function sprintf; /** * @implements Rule<ClassConstFetch> */ final class DynamicClassConstantFetchRule implements Rule { /** * @var PhpVersion */ private $phpVersion; /** * @var RuleLevelHelper */ private $ruleLevelHelper; public function __construct(PhpVersion $phpVersion, RuleLevelHelper $ruleLevelHelper) { $this->phpVersion = $phpVersion; $this->ruleLevelHelper = $ruleLevelHelper; } public function getNodeType() : string { return ClassConstFetch::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->name instanceof Node\Expr) { return []; } if (!$this->phpVersion->supportsDynamicClassConstantFetch()) { return [RuleErrorBuilder::message('Fetching class constants with a dynamic name is supported only on PHP 8.3 and later.')->identifier('classConstant.dynamicFetch')->nonIgnorable()->build()]; } $typeResult = $this->ruleLevelHelper->findTypeToCheck($scope, $node->name, '', static function (Type $type) : bool { return $type->isString()->yes(); }); $type = $typeResult->getType(); if ($type instanceof ErrorType) { return []; } if ($type->isString()->yes()) { return []; } return [RuleErrorBuilder::message(sprintf('Class constant name in dynamic fetch can only be a string, %s given.', $type->describe(VerbosityLevel::typeOnly())))->identifier('classConstant.nameType')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Constants; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ClassReflection; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\MissingTypehintCheck; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\ShouldNotHappenException; use PHPStan\Type\VerbosityLevel; use function array_merge; use function sprintf; /** * @implements Rule<Node\Stmt\ClassConst> */ final class MissingClassConstantTypehintRule implements Rule { /** * @var MissingTypehintCheck */ private $missingTypehintCheck; public function __construct(MissingTypehintCheck $missingTypehintCheck) { $this->missingTypehintCheck = $missingTypehintCheck; } public function getNodeType() : string { return Node\Stmt\ClassConst::class; } public function processNode(Node $node, Scope $scope) : array { if (!$scope->isInClass()) { throw new ShouldNotHappenException(); } $errors = []; foreach ($node->consts as $const) { $constantName = $const->name->toString(); $errors = array_merge($errors, $this->processSingleConstant($scope->getClassReflection(), $constantName)); } return $errors; } /** * @return list<IdentifierRuleError> */ private function processSingleConstant(ClassReflection $classReflection, string $constantName) : array { $constantReflection = $classReflection->getConstant($constantName); $constantType = $constantReflection->getPhpDocType(); if ($constantType === null) { return []; } $errors = []; foreach ($this->missingTypehintCheck->getIterableTypesWithMissingValueTypehint($constantType) as $iterableType) { $iterableTypeDescription = $iterableType->describe(VerbosityLevel::typeOnly()); $errors[] = RuleErrorBuilder::message(sprintf('Constant %s::%s type has no value type specified in iterable type %s.', $constantReflection->getDeclaringClass()->getDisplayName(), $constantName, $iterableTypeDescription))->tip(MissingTypehintCheck::MISSING_ITERABLE_VALUE_TYPE_TIP)->identifier('missingType.iterableValue')->build(); } foreach ($this->missingTypehintCheck->getNonGenericObjectTypesWithGenericClass($constantType) as [$name, $genericTypeNames]) { $errors[] = RuleErrorBuilder::message(sprintf('Constant %s::%s with generic %s does not specify its types: %s', $constantReflection->getDeclaringClass()->getDisplayName(), $constantName, $name, $genericTypeNames))->identifier('missingType.generics')->build(); } foreach ($this->missingTypehintCheck->getCallablesWithMissingSignature($constantType) as $callableType) { $errors[] = RuleErrorBuilder::message(sprintf('Constant %s::%s type has no signature specified for %s.', $constantReflection->getDeclaringClass()->getDisplayName(), $constantName, $callableType->describe(VerbosityLevel::typeOnly())))->identifier('missingType.callable')->build(); } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Constants; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; /** * @implements Rule<Node\Stmt\ClassConst> */ final class ClassAsClassConstantRule implements Rule { public function getNodeType() : string { return Node\Stmt\ClassConst::class; } public function processNode(Node $node, Scope $scope) : array { $errors = []; foreach ($node->consts as $const) { if ($const->name->toLowerString() !== 'class') { continue; } $errors[] = RuleErrorBuilder::message('A class constant must not be called \'class\'; it is reserved for class name fetching.')->line($const->getStartLine())->identifier('classConstant.class')->nonIgnorable()->build(); } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules; use PhpParser\Node; use PHPStan\DependencyInjection\Container; use function class_implements; use function class_parents; final class LazyRegistry implements \PHPStan\Rules\Registry { /** * @var Container */ private $container; public const RULE_TAG = 'phpstan.rules.rule'; /** @var Rule[][]|null */ private $rules = null; /** @var Rule[][] */ private $cache = []; public function __construct(Container $container) { $this->container = $container; } /** * @template TNodeType of Node * @param class-string<TNodeType> $nodeType * @return array<Rule<TNodeType>> */ public function getRules(string $nodeType) : array { if (!isset($this->cache[$nodeType])) { $parentNodeTypes = [$nodeType] + class_parents($nodeType) + class_implements($nodeType); $rules = []; $rulesFromContainer = $this->getRulesFromContainer(); foreach ($parentNodeTypes as $parentNodeType) { foreach ($rulesFromContainer[$parentNodeType] ?? [] as $rule) { $rules[] = $rule; } } $this->cache[$nodeType] = $rules; } /** * @var array<Rule<TNodeType>> $selectedRules */ $selectedRules = $this->cache[$nodeType]; return $selectedRules; } /** * @return Rule[][] */ private function getRulesFromContainer() : array { if ($this->rules !== null) { return $this->rules; } $rules = []; foreach ($this->container->getServicesByTag(self::RULE_TAG) as $rule) { $rules[$rule->getNodeType()][] = $rule; } return $this->rules = $rules; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Ignore; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\FileNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function count; use function sprintf; /** * @implements Rule<FileNode> */ final class IgnoreParseErrorRule implements Rule { public function getNodeType() : string { return FileNode::class; } public function processNode(Node $node, Scope $scope) : array { $nodes = $node->getNodes(); if (count($nodes) === 0) { return []; } $firstNode = $nodes[0]; $parseErrors = $firstNode->getAttribute('linesToIgnoreParseErrors', []); $errors = []; foreach ($parseErrors as $line => $lineParseErrors) { foreach ($lineParseErrors as $parseError) { $errors[] = RuleErrorBuilder::message(sprintf('Parse error in @phpstan-ignore: %s', $parseError))->line($line)->identifier('ignore.parseError')->nonIgnorable()->build(); } } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Keywords; use PhpParser\Node; use PhpParser\Node\Stmt; use PHPStan\Analyser\Scope; use PHPStan\Node\Printer\ExprPrinter; use PHPStan\Parser\DeclarePositionVisitor; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function in_array; use function sprintf; /** * @implements Rule<Stmt\Declare_> */ final class DeclareStrictTypesRule implements Rule { /** * @readonly * @var ExprPrinter */ private $exprPrinter; public function __construct(ExprPrinter $exprPrinter) { $this->exprPrinter = $exprPrinter; } public function getNodeType() : string { return Stmt\Declare_::class; } public function processNode(Node $node, Scope $scope) : array { $declaresStrictTypes = \false; foreach ($node->declares as $declare) { if ($declare->key->name !== 'strict_types') { continue; } if (!$declare->value instanceof Node\Scalar\LNumber || !in_array($declare->value->value, [0, 1], \true)) { return [RuleErrorBuilder::message(sprintf(sprintf('Declare strict_types must have 0 or 1 as its value, %s given.', $this->exprPrinter->printExpr($declare->value))))->identifier('declareStrictTypes.value')->nonIgnorable()->build()]; } $declaresStrictTypes = \true; break; } if ($declaresStrictTypes === \false) { return []; } if (!$node->hasAttribute(DeclarePositionVisitor::ATTRIBUTE_NAME)) { return []; } $isFirstStatement = (bool) $node->getAttribute(DeclarePositionVisitor::ATTRIBUTE_NAME); if ($isFirstStatement) { return []; } return [RuleErrorBuilder::message(sprintf('Declare strict_types must be the very first statement.'))->identifier('declareStrictTypes.notFirst')->nonIgnorable()->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Keywords; use PhpParser\Node; use PhpParser\Node\Expr\Include_; use PHPStan\Analyser\Scope; use PHPStan\File\FileHelper; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\ShouldNotHappenException; use function array_merge; use function dirname; use function explode; use function get_include_path; use function is_file; use function sprintf; use const PATH_SEPARATOR; /** * @implements Rule<Include_> */ final class RequireFileExistsRule implements Rule { /** * @var string */ private $currentWorkingDirectory; public function __construct(string $currentWorkingDirectory) { $this->currentWorkingDirectory = $currentWorkingDirectory; } public function getNodeType() : string { return Include_::class; } public function processNode(Node $node, Scope $scope) : array { $errors = []; $paths = $this->resolveFilePaths($node, $scope); foreach ($paths as $path) { if ($this->doesFileExist($path, $scope)) { continue; } $errors[] = $this->getErrorMessage($node, $path); } return $errors; } /** * We cannot use `stream_resolve_include_path` as it works based on the calling script. * This method simulates the behavior of `stream_resolve_include_path` but for the given scope. * The priority order is the following: * 1. The current working directory. * 2. The include path. * 3. The path of the script that is being executed. */ private function doesFileExist(string $path, Scope $scope) : bool { $directories = array_merge([$this->currentWorkingDirectory], explode(PATH_SEPARATOR, get_include_path()), [dirname($scope->getFile())]); foreach ($directories as $directory) { if ($this->doesFileExistForDirectory($path, $directory)) { return \true; } } return \false; } private function doesFileExistForDirectory(string $path, string $workingDirectory) : bool { $fileHelper = new FileHelper($workingDirectory); $absolutePath = $fileHelper->absolutizePath($path); return is_file($absolutePath); } private function getErrorMessage(Include_ $node, string $filePath) : IdentifierRuleError { $message = 'Path in %s() "%s" is not a file or it does not exist.'; switch ($node->type) { case Include_::TYPE_REQUIRE: $type = 'require'; $identifierType = 'require'; break; case Include_::TYPE_REQUIRE_ONCE: $type = 'require_once'; $identifierType = 'requireOnce'; break; case Include_::TYPE_INCLUDE: $type = 'include'; $identifierType = 'include'; break; case Include_::TYPE_INCLUDE_ONCE: $type = 'include_once'; $identifierType = 'includeOnce'; break; default: throw new ShouldNotHappenException('Rule should have already validated the node type.'); } $identifier = sprintf('%s.fileNotFound', $identifierType); return RuleErrorBuilder::message(sprintf($message, $type, $filePath))->identifier($identifier)->build(); } /** * @return array<string> */ private function resolveFilePaths(Include_ $node, Scope $scope) : array { $paths = []; $type = $scope->getType($node->expr); $constantStrings = $type->getConstantStrings(); foreach ($constantStrings as $constantString) { $paths[] = $constantString->getValue(); } return $paths; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Keywords; use PhpParser\Node; use PhpParser\Node\Stmt; use PHPStan\Analyser\Scope; use PHPStan\Parser\ParentStmtTypesVisitor; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function array_reverse; use function sprintf; /** * @implements Rule<Stmt> */ final class ContinueBreakInLoopRule implements Rule { public function getNodeType() : string { return Stmt::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node instanceof Stmt\Continue_ && !$node instanceof Stmt\Break_) { return []; } if (!$node->num instanceof Node\Scalar\LNumber) { $value = 1; } else { $value = $node->num->value; } $parentStmtTypes = array_reverse($node->getAttribute(ParentStmtTypesVisitor::ATTRIBUTE_NAME)); foreach ($parentStmtTypes as $parentStmtType) { if ($parentStmtType === Stmt\Case_::class) { continue; } if ($parentStmtType === Stmt\Function_::class || $parentStmtType === Stmt\ClassMethod::class || $parentStmtType === Node\Expr\Closure::class) { return [RuleErrorBuilder::message(sprintf('Keyword %s used outside of a loop or a switch statement.', $node instanceof Stmt\Continue_ ? 'continue' : 'break'))->nonIgnorable()->identifier(sprintf('%s.outOfLoop', $node instanceof Stmt\Continue_ ? 'continue' : 'break'))->build()]; } if ($parentStmtType === Stmt\For_::class || $parentStmtType === Stmt\Foreach_::class || $parentStmtType === Stmt\Do_::class || $parentStmtType === Stmt\While_::class || $parentStmtType === Stmt\Switch_::class) { $value--; } if ($value === 0) { break; } } if ($value > 0) { return [RuleErrorBuilder::message(sprintf('Keyword %s used outside of a loop or a switch statement.', $node instanceof Stmt\Continue_ ? 'continue' : 'break'))->nonIgnorable()->identifier(sprintf('%s.outOfLoop', $node instanceof Stmt\Continue_ ? 'continue' : 'break'))->build()]; } return []; } } <?php declare (strict_types=1); namespace PHPStan\Rules; /** @api */ interface NonIgnorableRuleError extends \PHPStan\Rules\RuleError { } <?php declare (strict_types=1); namespace PHPStan\Rules\Exceptions; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\FinallyExitPointsNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function count; use function sprintf; /** * @implements Rule<FinallyExitPointsNode> */ final class OverwrittenExitPointByFinallyRule implements Rule { public function getNodeType() : string { return FinallyExitPointsNode::class; } public function processNode(Node $node, Scope $scope) : array { if (count($node->getTryCatchExitPoints()) === 0) { return []; } $errors = []; foreach ($node->getTryCatchExitPoints() as $exitPoint) { $errors[] = RuleErrorBuilder::message(sprintf('This %s is overwritten by a different one in the finally block below.', $this->describeExitPoint($exitPoint->getStatement())))->line($exitPoint->getStatement()->getStartLine())->identifier('finally.exitPoint')->build(); } foreach ($node->getFinallyExitPoints() as $exitPoint) { $errors[] = RuleErrorBuilder::message(sprintf('The overwriting %s is on this line.', $this->describeExitPoint($exitPoint->getStatement())))->line($exitPoint->getStatement()->getStartLine())->identifier('finally.exitPoint')->build(); } return $errors; } private function describeExitPoint(Node\Stmt $stmt) : string { if ($stmt instanceof Node\Stmt\Return_) { return 'return'; } if ($stmt instanceof Node\Stmt\Throw_) { return 'throw'; } if ($stmt instanceof Node\Stmt\Continue_) { return 'continue'; } if ($stmt instanceof Node\Stmt\Break_) { return 'break'; } return 'exit point'; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Exceptions; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Rules\RuleLevelHelper; use PHPStan\Type\ErrorType; use PHPStan\Type\ObjectType; use PHPStan\Type\Type; use PHPStan\Type\VerbosityLevel; use Throwable; use function sprintf; /** * @implements Rule<Node\Expr\Throw_> */ final class ThrowExprTypeRule implements Rule { /** * @var RuleLevelHelper */ private $ruleLevelHelper; public function __construct(RuleLevelHelper $ruleLevelHelper) { $this->ruleLevelHelper = $ruleLevelHelper; } public function getNodeType() : string { return Node\Expr\Throw_::class; } public function processNode(Node $node, Scope $scope) : array { $throwableType = new ObjectType(Throwable::class); $typeResult = $this->ruleLevelHelper->findTypeToCheck($scope, $node->expr, 'Throwing object of an unknown class %s.', static function (Type $type) use($throwableType) : bool { return $throwableType->isSuperTypeOf($type)->yes(); }); $foundType = $typeResult->getType(); if ($foundType instanceof ErrorType) { return $typeResult->getUnknownClassErrors(); } $isSuperType = $throwableType->isSuperTypeOf($foundType); if ($isSuperType->yes()) { return []; } return [RuleErrorBuilder::message(sprintf('Invalid type %s to throw.', $foundType->describe(VerbosityLevel::typeOnly())))->identifier('throw.notThrowable')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Exceptions; use _PHPStan_7d8742a37\Nette\Utils\Strings; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ReflectionProvider; use function count; /** * @api * @final */ class DefaultExceptionTypeResolver implements \PHPStan\Rules\Exceptions\ExceptionTypeResolver { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var string[] */ private $uncheckedExceptionRegexes; /** * @var string[] */ private $uncheckedExceptionClasses; /** * @var string[] */ private $checkedExceptionRegexes; /** * @var string[] */ private $checkedExceptionClasses; /** * @param string[] $uncheckedExceptionRegexes * @param string[] $uncheckedExceptionClasses * @param string[] $checkedExceptionRegexes * @param string[] $checkedExceptionClasses */ public function __construct(ReflectionProvider $reflectionProvider, array $uncheckedExceptionRegexes, array $uncheckedExceptionClasses, array $checkedExceptionRegexes, array $checkedExceptionClasses) { $this->reflectionProvider = $reflectionProvider; $this->uncheckedExceptionRegexes = $uncheckedExceptionRegexes; $this->uncheckedExceptionClasses = $uncheckedExceptionClasses; $this->checkedExceptionRegexes = $checkedExceptionRegexes; $this->checkedExceptionClasses = $checkedExceptionClasses; } public function isCheckedException(string $className, Scope $scope) : bool { foreach ($this->uncheckedExceptionRegexes as $regex) { if (Strings::match($className, $regex) !== null) { return \false; } } foreach ($this->uncheckedExceptionClasses as $uncheckedExceptionClass) { if ($className === $uncheckedExceptionClass) { return \false; } } if (!$this->reflectionProvider->hasClass($className)) { return $this->isCheckedExceptionInternal($className); } $classReflection = $this->reflectionProvider->getClass($className); foreach ($this->uncheckedExceptionClasses as $uncheckedExceptionClass) { if ($classReflection->getName() === $uncheckedExceptionClass) { return \false; } if (!$classReflection->isSubclassOf($uncheckedExceptionClass)) { continue; } return \false; } return $this->isCheckedExceptionInternal($className); } private function isCheckedExceptionInternal(string $className) : bool { foreach ($this->checkedExceptionRegexes as $regex) { if (Strings::match($className, $regex) !== null) { return \true; } } foreach ($this->checkedExceptionClasses as $checkedExceptionClass) { if ($className === $checkedExceptionClass) { return \true; } } if (!$this->reflectionProvider->hasClass($className)) { return count($this->checkedExceptionRegexes) === 0 && count($this->checkedExceptionClasses) === 0; } $classReflection = $this->reflectionProvider->getClass($className); foreach ($this->checkedExceptionClasses as $checkedExceptionClass) { if ($classReflection->getName() === $checkedExceptionClass) { return \true; } if (!$classReflection->isSubclassOf($checkedExceptionClass)) { continue; } return \true; } return count($this->checkedExceptionRegexes) === 0 && count($this->checkedExceptionClasses) === 0; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Exceptions; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\MethodReturnStatementsNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\TrinaryLogic; use PHPStan\Type\TypeUtils; use PHPStan\Type\VerbosityLevel; use function sprintf; /** * @implements Rule<MethodReturnStatementsNode> */ final class ThrowsVoidMethodWithExplicitThrowPointRule implements Rule { /** * @var ExceptionTypeResolver */ private $exceptionTypeResolver; /** * @var bool */ private $missingCheckedExceptionInThrows; public function __construct(\PHPStan\Rules\Exceptions\ExceptionTypeResolver $exceptionTypeResolver, bool $missingCheckedExceptionInThrows) { $this->exceptionTypeResolver = $exceptionTypeResolver; $this->missingCheckedExceptionInThrows = $missingCheckedExceptionInThrows; } public function getNodeType() : string { return MethodReturnStatementsNode::class; } public function processNode(Node $node, Scope $scope) : array { $statementResult = $node->getStatementResult(); $methodReflection = $node->getMethodReflection(); if ($methodReflection->getThrowType() === null || !$methodReflection->getThrowType()->isVoid()->yes()) { return []; } $errors = []; foreach ($statementResult->getThrowPoints() as $throwPoint) { if (!$throwPoint->isExplicit()) { continue; } foreach (TypeUtils::flattenTypes($throwPoint->getType()) as $throwPointType) { $isCheckedException = TrinaryLogic::createFromBoolean($this->missingCheckedExceptionInThrows)->lazyAnd($throwPointType->getObjectClassNames(), function (string $objectClassName) use($throwPoint) { return TrinaryLogic::createFromBoolean($this->exceptionTypeResolver->isCheckedException($objectClassName, $throwPoint->getScope())); }); if ($isCheckedException->yes()) { continue; } $errors[] = RuleErrorBuilder::message(sprintf('Method %s::%s() throws exception %s but the PHPDoc contains @throws void.', $methodReflection->getDeclaringClass()->getDisplayName(), $methodReflection->getName(), $throwPointType->describe(VerbosityLevel::typeOnly())))->line($throwPoint->getNode()->getStartLine())->identifier('throws.void')->build(); } } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Exceptions; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\MethodReturnStatementsNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\FileTypeMapper; use function sprintf; /** * @implements Rule<MethodReturnStatementsNode> */ final class TooWideMethodThrowTypeRule implements Rule { /** * @var FileTypeMapper */ private $fileTypeMapper; /** * @var TooWideThrowTypeCheck */ private $check; public function __construct(FileTypeMapper $fileTypeMapper, \PHPStan\Rules\Exceptions\TooWideThrowTypeCheck $check) { $this->fileTypeMapper = $fileTypeMapper; $this->check = $check; } public function getNodeType() : string { return MethodReturnStatementsNode::class; } public function processNode(Node $node, Scope $scope) : array { $docComment = $node->getDocComment(); if ($docComment === null) { return []; } $statementResult = $node->getStatementResult(); $methodReflection = $node->getMethodReflection(); $classReflection = $node->getClassReflection(); $resolvedPhpDoc = $this->fileTypeMapper->getResolvedPhpDoc($scope->getFile(), $classReflection->getName(), $scope->isInTrait() ? $scope->getTraitReflection()->getName() : null, $methodReflection->getName(), $docComment->getText()); if ($resolvedPhpDoc->getThrowsTag() === null) { return []; } $throwType = $resolvedPhpDoc->getThrowsTag()->getType(); $errors = []; foreach ($this->check->check($throwType, $statementResult->getThrowPoints()) as $throwClass) { $errors[] = RuleErrorBuilder::message(sprintf('Method %s::%s() has %s in PHPDoc @throws tag but it\'s not thrown.', $methodReflection->getDeclaringClass()->getDisplayName(), $methodReflection->getName(), $throwClass))->identifier('throws.unusedType')->build(); } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Exceptions; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\FunctionReturnStatementsNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function sprintf; /** * @implements Rule<FunctionReturnStatementsNode> */ final class MissingCheckedExceptionInFunctionThrowsRule implements Rule { /** * @var MissingCheckedExceptionInThrowsCheck */ private $check; public function __construct(\PHPStan\Rules\Exceptions\MissingCheckedExceptionInThrowsCheck $check) { $this->check = $check; } public function getNodeType() : string { return FunctionReturnStatementsNode::class; } public function processNode(Node $node, Scope $scope) : array { $statementResult = $node->getStatementResult(); $functionReflection = $node->getFunctionReflection(); $errors = []; foreach ($this->check->check($functionReflection->getThrowType(), $statementResult->getThrowPoints()) as [$className, $throwPointNode]) { $errors[] = RuleErrorBuilder::message(sprintf('Function %s() throws checked exception %s but it\'s missing from the PHPDoc @throws tag.', $functionReflection->getName(), $className))->line($throwPointNode->getStartLine())->identifier('missingType.checkedException')->build(); } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Exceptions; use PhpParser\Node; use PhpParser\Node\Stmt\Catch_; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\ClassNameCheck; use PHPStan\Rules\ClassNameNodePair; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use Throwable; use function array_merge; use function sprintf; /** * @implements Rule<Node\Stmt\Catch_> */ final class CaughtExceptionExistenceRule implements Rule { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var ClassNameCheck */ private $classCheck; /** * @var bool */ private $checkClassCaseSensitivity; public function __construct(ReflectionProvider $reflectionProvider, ClassNameCheck $classCheck, bool $checkClassCaseSensitivity) { $this->reflectionProvider = $reflectionProvider; $this->classCheck = $classCheck; $this->checkClassCaseSensitivity = $checkClassCaseSensitivity; } public function getNodeType() : string { return Catch_::class; } public function processNode(Node $node, Scope $scope) : array { $errors = []; foreach ($node->types as $class) { $className = (string) $class; if (!$this->reflectionProvider->hasClass($className)) { if ($scope->isInClassExists($className)) { continue; } $errors[] = RuleErrorBuilder::message(sprintf('Caught class %s not found.', $className))->line($class->getStartLine())->identifier('class.notFound')->discoveringSymbolsTip()->build(); continue; } $classReflection = $this->reflectionProvider->getClass($className); if (!$classReflection->isInterface() && !$classReflection->implementsInterface(Throwable::class)) { $errors[] = RuleErrorBuilder::message(sprintf('Caught class %s is not an exception.', $classReflection->getDisplayName()))->line($class->getStartLine())->identifier('catch.notThrowable')->build(); } $errors = array_merge($errors, $this->classCheck->checkClassNames([new ClassNameNodePair($className, $class)], $this->checkClassCaseSensitivity)); } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Exceptions; use PhpParser\Node; use PHPStan\Analyser\ThrowPoint; use PHPStan\TrinaryLogic; use PHPStan\Type\NeverType; use PHPStan\Type\ObjectType; use PHPStan\Type\Type; use PHPStan\Type\TypeUtils; use PHPStan\Type\VerbosityLevel; use Throwable; final class MissingCheckedExceptionInThrowsCheck { /** * @var ExceptionTypeResolver */ private $exceptionTypeResolver; public function __construct(\PHPStan\Rules\Exceptions\ExceptionTypeResolver $exceptionTypeResolver) { $this->exceptionTypeResolver = $exceptionTypeResolver; } /** * @param ThrowPoint[] $throwPoints * @return array<int, array{string, Node\Expr|Node\Stmt}> */ public function check(?Type $throwType, array $throwPoints) : array { if ($throwType === null) { $throwType = new NeverType(); } $classes = []; foreach ($throwPoints as $throwPoint) { if (!$throwPoint->isExplicit()) { continue; } foreach (TypeUtils::flattenTypes($throwPoint->getType()) as $throwPointType) { if ($throwPointType->isSuperTypeOf(new ObjectType(Throwable::class))->yes()) { continue; } if ($throwType->isSuperTypeOf($throwPointType)->yes()) { continue; } $isCheckedException = TrinaryLogic::createNo()->lazyOr($throwPointType->getObjectClassNames(), function (string $objectClassName) use($throwPoint) { return TrinaryLogic::createFromBoolean($this->exceptionTypeResolver->isCheckedException($objectClassName, $throwPoint->getScope())); }); if ($isCheckedException->no()) { continue; } $classes[] = [$throwPointType->describe(VerbosityLevel::typeOnly()), $throwPoint->getNode()]; } } return $classes; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Exceptions; use PHPStan\Analyser\Scope; /** * @api * * This interface allows you to write custom logic that can dynamically decide * whether an exception is checked or unchecked type. * * Because the interface accepts a Scope, you can ask about the place in the code where * it's being decided - a file, a namespace or a class name. * * There can only be a single ExceptionTypeResolver per project, and you can register it * in your configuration file like this: * * ``` * services: * exceptionTypeResolver!: * class: PHPStan\Rules\Exceptions\ExceptionTypeResolver * ``` * * You can also take advantage of the `PHPStan\Rules\Exceptions\DefaultExceptionTypeResolver` * by injecting it into the constructor of your ExceptionTypeResolver * and delegate the logic of the classes and places you don't care about. * * DefaultExceptionTypeResolver decides the type of the exception based on configuration * parameters like `exceptions.uncheckedExceptionClasses` etc. * * Learn more: https://phpstan.org/blog/bring-your-exceptions-under-control */ interface ExceptionTypeResolver { public function isCheckedException(string $className, Scope $scope) : bool; } <?php declare (strict_types=1); namespace PHPStan\Rules\Exceptions; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\FunctionReturnStatementsNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\TrinaryLogic; use PHPStan\Type\TypeUtils; use PHPStan\Type\VerbosityLevel; use function sprintf; /** * @implements Rule<FunctionReturnStatementsNode> */ final class ThrowsVoidFunctionWithExplicitThrowPointRule implements Rule { /** * @var ExceptionTypeResolver */ private $exceptionTypeResolver; /** * @var bool */ private $missingCheckedExceptionInThrows; public function __construct(\PHPStan\Rules\Exceptions\ExceptionTypeResolver $exceptionTypeResolver, bool $missingCheckedExceptionInThrows) { $this->exceptionTypeResolver = $exceptionTypeResolver; $this->missingCheckedExceptionInThrows = $missingCheckedExceptionInThrows; } public function getNodeType() : string { return FunctionReturnStatementsNode::class; } public function processNode(Node $node, Scope $scope) : array { $statementResult = $node->getStatementResult(); $functionReflection = $node->getFunctionReflection(); if ($functionReflection->getThrowType() === null || !$functionReflection->getThrowType()->isVoid()->yes()) { return []; } $errors = []; foreach ($statementResult->getThrowPoints() as $throwPoint) { if (!$throwPoint->isExplicit()) { continue; } foreach (TypeUtils::flattenTypes($throwPoint->getType()) as $throwPointType) { $isCheckedException = TrinaryLogic::createFromBoolean($this->missingCheckedExceptionInThrows)->lazyAnd($throwPointType->getObjectClassNames(), function (string $objectClassName) use($throwPoint) { return TrinaryLogic::createFromBoolean($this->exceptionTypeResolver->isCheckedException($objectClassName, $throwPoint->getScope())); }); if ($isCheckedException->yes()) { continue; } $errors[] = RuleErrorBuilder::message(sprintf('Function %s() throws exception %s but the PHPDoc contains @throws void.', $functionReflection->getName(), $throwPointType->describe(VerbosityLevel::typeOnly())))->line($throwPoint->getNode()->getStartLine())->identifier('throws.void')->build(); } } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Exceptions; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Php\PhpVersion; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; /** * @implements Rule<Node\Stmt\Catch_> */ final class NoncapturingCatchRule implements Rule { /** * @var PhpVersion */ private $phpVersion; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; } public function getNodeType() : string { return Node\Stmt\Catch_::class; } /** * @param Node\Stmt\Catch_ $node */ public function processNode(Node $node, Scope $scope) : array { if ($this->phpVersion->supportsNoncapturingCatches()) { return []; } if ($node->var !== null) { return []; } return [RuleErrorBuilder::message('Non-capturing catch is supported only on PHP 8.0 and later.')->nonIgnorable()->identifier('catch.nonCapturingNotSupported')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Exceptions; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Php\PhpVersion; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; /** * @implements Rule<Node\Expr\Throw_> */ final class ThrowExpressionRule implements Rule { /** * @var PhpVersion */ private $phpVersion; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; } public function getNodeType() : string { return Node\Expr\Throw_::class; } public function processNode(Node $node, Scope $scope) : array { if ($this->phpVersion->supportsThrowExpression()) { return []; } return [RuleErrorBuilder::message('Throw expression is supported only on PHP 8.0 and later.')->nonIgnorable()->identifier('throw.notSupported')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Exceptions; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\CatchWithUnthrownExceptionNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\NeverType; use PHPStan\Type\VerbosityLevel; use function sprintf; /** * @implements Rule<CatchWithUnthrownExceptionNode> */ final class CatchWithUnthrownExceptionRule implements Rule { /** * @var ExceptionTypeResolver */ private $exceptionTypeResolver; /** * @var bool */ private $reportUncheckedExceptionDeadCatch; public function __construct(\PHPStan\Rules\Exceptions\ExceptionTypeResolver $exceptionTypeResolver, bool $reportUncheckedExceptionDeadCatch) { $this->exceptionTypeResolver = $exceptionTypeResolver; $this->reportUncheckedExceptionDeadCatch = $reportUncheckedExceptionDeadCatch; } public function getNodeType() : string { return CatchWithUnthrownExceptionNode::class; } public function processNode(Node $node, Scope $scope) : array { if ($node->getCaughtType() instanceof NeverType) { return [RuleErrorBuilder::message(sprintf('Dead catch - %s is already caught above.', $node->getOriginalCaughtType()->describe(VerbosityLevel::typeOnly())))->line($node->getStartLine())->identifier('catch.alreadyCaught')->build()]; } if (!$this->reportUncheckedExceptionDeadCatch) { $isCheckedException = \false; foreach ($node->getCaughtType()->getObjectClassNames() as $objectClassName) { if ($this->exceptionTypeResolver->isCheckedException($objectClassName, $scope)) { $isCheckedException = \true; break; } } if (!$isCheckedException) { return []; } } return [RuleErrorBuilder::message(sprintf('Dead catch - %s is never thrown in the try block.', $node->getCaughtType()->describe(VerbosityLevel::typeOnly())))->line($node->getStartLine())->identifier('catch.neverThrown')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Exceptions; use PHPStan\Analyser\ThrowPoint; use PHPStan\Type\NeverType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\TypeUtils; use PHPStan\Type\VerbosityLevel; use function array_map; final class TooWideThrowTypeCheck { /** * @param ThrowPoint[] $throwPoints * @return string[] */ public function check(Type $throwType, array $throwPoints) : array { if ($throwType->isVoid()->yes()) { return []; } $throwPointType = TypeCombinator::union(...array_map(static function (ThrowPoint $throwPoint) : Type { if (!$throwPoint->isExplicit()) { return new NeverType(); } return $throwPoint->getType(); }, $throwPoints)); $throwClasses = []; foreach (TypeUtils::flattenTypes($throwType) as $type) { if (!$throwPointType instanceof NeverType && !$type->isSuperTypeOf($throwPointType)->no()) { continue; } $throwClasses[] = $type->describe(VerbosityLevel::typeOnly()); } return $throwClasses; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Exceptions; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\MethodReturnStatementsNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function sprintf; /** * @implements Rule<MethodReturnStatementsNode> */ final class MissingCheckedExceptionInMethodThrowsRule implements Rule { /** * @var MissingCheckedExceptionInThrowsCheck */ private $check; public function __construct(\PHPStan\Rules\Exceptions\MissingCheckedExceptionInThrowsCheck $check) { $this->check = $check; } public function getNodeType() : string { return MethodReturnStatementsNode::class; } public function processNode(Node $node, Scope $scope) : array { $statementResult = $node->getStatementResult(); $methodReflection = $node->getMethodReflection(); $errors = []; foreach ($this->check->check($methodReflection->getThrowType(), $statementResult->getThrowPoints()) as [$className, $throwPointNode]) { $errors[] = RuleErrorBuilder::message(sprintf('Method %s::%s() throws checked exception %s but it\'s missing from the PHPDoc @throws tag.', $methodReflection->getDeclaringClass()->getDisplayName(), $methodReflection->getName(), $className))->line($throwPointNode->getStartLine())->identifier('missingType.checkedException')->build(); } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Exceptions; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\FunctionReturnStatementsNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function sprintf; /** * @implements Rule<FunctionReturnStatementsNode> */ final class TooWideFunctionThrowTypeRule implements Rule { /** * @var TooWideThrowTypeCheck */ private $check; public function __construct(\PHPStan\Rules\Exceptions\TooWideThrowTypeCheck $check) { $this->check = $check; } public function getNodeType() : string { return FunctionReturnStatementsNode::class; } public function processNode(Node $node, Scope $scope) : array { $statementResult = $node->getStatementResult(); $functionReflection = $node->getFunctionReflection(); $throwType = $functionReflection->getThrowType(); if ($throwType === null) { return []; } $errors = []; foreach ($this->check->check($throwType, $statementResult->getThrowPoints()) as $throwClass) { $errors[] = RuleErrorBuilder::message(sprintf('Function %s() has %s in PHPDoc @throws tag but it\'s not thrown.', $functionReflection->getName(), $throwClass))->identifier('throws.unusedType')->build(); } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Variables; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\IssetCheck; use PHPStan\Rules\Rule; use PHPStan\Type\Type; /** * @implements Rule<Node\Expr> */ final class NullCoalesceRule implements Rule { /** * @var IssetCheck */ private $issetCheck; public function __construct(IssetCheck $issetCheck) { $this->issetCheck = $issetCheck; } public function getNodeType() : string { return Node\Expr::class; } public function processNode(Node $node, Scope $scope) : array { $typeMessageCallback = static function (Type $type) : ?string { $isNull = $type->isNull(); if ($isNull->maybe()) { return null; } if ($isNull->yes()) { return 'is always null'; } return 'is not nullable'; }; if ($node instanceof Node\Expr\BinaryOp\Coalesce) { $error = $this->issetCheck->check($node->left, $scope, 'on left side of ??', 'nullCoalesce', $typeMessageCallback); } elseif ($node instanceof Node\Expr\AssignOp\Coalesce) { $error = $this->issetCheck->check($node->var, $scope, 'on left side of ??=', 'nullCoalesce', $typeMessageCallback); } else { return []; } if ($error === null) { return []; } return [$error]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Variables; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\IssetCheck; use PHPStan\Rules\Rule; use PHPStan\Type\Type; /** * @implements Rule<Node\Expr\Empty_> */ final class EmptyRule implements Rule { /** * @var IssetCheck */ private $issetCheck; public function __construct(IssetCheck $issetCheck) { $this->issetCheck = $issetCheck; } public function getNodeType() : string { return Node\Expr\Empty_::class; } public function processNode(Node $node, Scope $scope) : array { $error = $this->issetCheck->check($node->expr, $scope, 'in empty()', 'empty', static function (Type $type) : ?string { $isNull = $type->isNull(); if ($isNull->maybe()) { return null; } $isFalsey = $type->toBoolean()->isFalse(); if ($isFalsey->maybe()) { return null; } if ($isNull->yes()) { if ($isFalsey->yes()) { return 'is always falsy'; } if ($isFalsey->no()) { return 'is not falsy'; } return 'is always null'; } if ($isFalsey->yes()) { return 'is always falsy'; } if ($isFalsey->no()) { return 'is not falsy'; } return 'is not nullable'; }); if ($error === null) { return []; } return [$error]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Variables; use PhpParser\Node; use PhpParser\Node\Expr\Variable; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function in_array; use function is_string; use function sprintf; /** * @implements Rule<Node\Expr\Variable> */ final class DefinedVariableRule implements Rule { /** * @var bool */ private $cliArgumentsVariablesRegistered; /** * @var bool */ private $checkMaybeUndefinedVariables; public function __construct(bool $cliArgumentsVariablesRegistered, bool $checkMaybeUndefinedVariables) { $this->cliArgumentsVariablesRegistered = $cliArgumentsVariablesRegistered; $this->checkMaybeUndefinedVariables = $checkMaybeUndefinedVariables; } public function getNodeType() : string { return Variable::class; } public function processNode(Node $node, Scope $scope) : array { if (!is_string($node->name)) { return []; } if ($this->cliArgumentsVariablesRegistered && in_array($node->name, ['argc', 'argv'], \true)) { $isInMain = !$scope->isInClass() && !$scope->isInAnonymousFunction() && $scope->getFunction() === null; if ($isInMain) { return []; } } if ($scope->isInExpressionAssign($node) || $scope->isUndefinedExpressionAllowed($node)) { return []; } if ($scope->hasVariableType($node->name)->no()) { return [RuleErrorBuilder::message(sprintf('Undefined variable: $%s', $node->name))->identifier('variable.undefined')->build()]; } elseif ($this->checkMaybeUndefinedVariables && !$scope->hasVariableType($node->name)->yes()) { return [RuleErrorBuilder::message(sprintf('Variable $%s might not be defined.', $node->name))->identifier('variable.undefined')->build()]; } return []; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Variables; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Rules\RuleLevelHelper; use PHPStan\Type\ErrorType; use PHPStan\Type\ObjectType; use PHPStan\Type\Type; use PHPStan\Type\VerbosityLevel; use Throwable; use function sprintf; /** * @implements Rule<Node\Stmt\Throw_> */ final class ThrowTypeRule implements Rule { /** * @var RuleLevelHelper */ private $ruleLevelHelper; public function __construct(RuleLevelHelper $ruleLevelHelper) { $this->ruleLevelHelper = $ruleLevelHelper; } public function getNodeType() : string { return Node\Stmt\Throw_::class; } public function processNode(Node $node, Scope $scope) : array { $throwableType = new ObjectType(Throwable::class); $typeResult = $this->ruleLevelHelper->findTypeToCheck($scope, $node->expr, 'Throwing object of an unknown class %s.', static function (Type $type) use($throwableType) : bool { return $throwableType->isSuperTypeOf($type)->yes(); }); $foundType = $typeResult->getType(); if ($foundType instanceof ErrorType) { return $typeResult->getUnknownClassErrors(); } $isSuperType = $throwableType->isSuperTypeOf($foundType); if ($isSuperType->yes()) { return []; } return [RuleErrorBuilder::message(sprintf('Invalid type %s to throw.', $foundType->describe(VerbosityLevel::typeOnly())))->identifier('throw.notThrowable')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Variables; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\VerbosityLevel; use function is_string; use function sprintf; /** * @implements Rule<Node\Stmt\Unset_> */ final class UnsetRule implements Rule { public function getNodeType() : string { return Node\Stmt\Unset_::class; } public function processNode(Node $node, Scope $scope) : array { $functionArguments = $node->vars; $errors = []; foreach ($functionArguments as $argument) { $error = $this->canBeUnset($argument, $scope); if ($error === null) { continue; } $errors[] = $error; } return $errors; } private function canBeUnset(Node $node, Scope $scope) : ?IdentifierRuleError { if ($node instanceof Node\Expr\Variable && is_string($node->name)) { $hasVariable = $scope->hasVariableType($node->name); if ($hasVariable->no()) { return RuleErrorBuilder::message(sprintf('Call to function unset() contains undefined variable $%s.', $node->name))->line($node->getStartLine())->identifier('unset.variable')->build(); } } elseif ($node instanceof Node\Expr\ArrayDimFetch && $node->dim !== null) { $type = $scope->getType($node->var); $dimType = $scope->getType($node->dim); if ($type->isOffsetAccessible()->no() || $type->hasOffsetValueType($dimType)->no()) { return RuleErrorBuilder::message(sprintf('Cannot unset offset %s on %s.', $dimType->describe(VerbosityLevel::value()), $type->describe(VerbosityLevel::value())))->line($node->getStartLine())->identifier('unset.offset')->build(); } return $this->canBeUnset($node->var, $scope); } return null; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Variables; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\IssetCheck; use PHPStan\Rules\Rule; use PHPStan\Type\Type; /** * @implements Rule<Node\Expr\Isset_> */ final class IssetRule implements Rule { /** * @var IssetCheck */ private $issetCheck; public function __construct(IssetCheck $issetCheck) { $this->issetCheck = $issetCheck; } public function getNodeType() : string { return Node\Expr\Isset_::class; } public function processNode(Node $node, Scope $scope) : array { $messages = []; foreach ($node->vars as $var) { $error = $this->issetCheck->check($var, $scope, 'in isset()', 'isset', static function (Type $type) : ?string { $isNull = $type->isNull(); if ($isNull->maybe()) { return null; } if ($isNull->yes()) { return 'is always null'; } return 'is not nullable'; }); if ($error === null) { continue; } $messages[] = $error; } return $messages; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Variables; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\VariableAssignNode; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Rules\RuleLevelHelper; use PHPStan\Type\ErrorType; use PHPStan\Type\Type; use PHPStan\Type\TypeUtils; use PHPStan\Type\VerbosityLevel; use function is_string; use function sprintf; /** * @implements Rule<VariableAssignNode> */ final class ParameterOutAssignedTypeRule implements Rule { /** * @var RuleLevelHelper */ private $ruleLevelHelper; public function __construct(RuleLevelHelper $ruleLevelHelper) { $this->ruleLevelHelper = $ruleLevelHelper; } public function getNodeType() : string { return VariableAssignNode::class; } public function processNode(Node $node, Scope $scope) : array { $inFunction = $scope->getFunction(); if ($inFunction === null) { return []; } if ($scope->isInAnonymousFunction()) { return []; } $variable = $node->getVariable(); if (!is_string($variable->name)) { return []; } $parameters = $inFunction->getParameters(); $foundParameter = null; foreach ($parameters as $parameter) { if (!$parameter->passedByReference()->createsNewVariable()) { continue; } if ($parameter->getName() !== $variable->name) { continue; } $foundParameter = $parameter; break; } if ($foundParameter === null) { return []; } $isParamOutType = \true; $outType = $foundParameter->getOutType(); if ($outType === null) { $isParamOutType = \false; $outType = $foundParameter->getType(); } $outType = TypeUtils::resolveLateResolvableTypes($outType); $typeResult = $this->ruleLevelHelper->findTypeToCheck($scope, $node->getAssignedExpr(), '', static function (Type $type) use($outType) : bool { return $outType->isSuperTypeOf($type)->yes(); }); $type = $typeResult->getType(); if ($type instanceof ErrorType) { return $typeResult->getUnknownClassErrors(); } $assignedExprType = $scope->getType($node->getAssignedExpr()); if ($outType->isSuperTypeOf($assignedExprType)->yes()) { return []; } if ($inFunction instanceof ExtendedMethodReflection) { $functionDescription = sprintf('method %s::%s()', $inFunction->getDeclaringClass()->getDisplayName(), $inFunction->getName()); } else { $functionDescription = sprintf('function %s()', $inFunction->getName()); } $verbosityLevel = VerbosityLevel::getRecommendedLevelByType($outType, $assignedExprType); $errorBuilder = RuleErrorBuilder::message(sprintf('Parameter &$%s %s of %s expects %s, %s given.', $foundParameter->getName(), $isParamOutType ? '@param-out type' : 'by-ref type', $functionDescription, $outType->describe($verbosityLevel), $assignedExprType->describe($verbosityLevel)))->identifier(sprintf('%s.type', $isParamOutType ? 'paramOut' : 'parameterByRef')); if (!$isParamOutType) { $errorBuilder->tip('You can change the parameter out type with @param-out PHPDoc tag.'); } return [$errorBuilder->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Variables; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\Constant\ConstantArrayType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\Type; use function array_merge; use function sprintf; use function strtolower; /** * @implements Rule<Node\Expr\FuncCall> */ final class CompactVariablesRule implements Rule { /** * @var bool */ private $checkMaybeUndefinedVariables; public function __construct(bool $checkMaybeUndefinedVariables) { $this->checkMaybeUndefinedVariables = $checkMaybeUndefinedVariables; } public function getNodeType() : string { return Node\Expr\FuncCall::class; } public function processNode(Node $node, Scope $scope) : array { if ($node->name instanceof Node\Expr) { return []; } $functionName = strtolower($node->name->toString()); if ($functionName !== 'compact') { return []; } $functionArguments = $node->getArgs(); $messages = []; foreach ($functionArguments as $argument) { $argumentType = $scope->getType($argument->value); $constantStrings = $this->findConstantStrings($argumentType); foreach ($constantStrings as $constantString) { $variableName = $constantString->getValue(); $scopeHasVariable = $scope->hasVariableType($variableName); if ($scopeHasVariable->no()) { $messages[] = RuleErrorBuilder::message(sprintf('Call to function compact() contains undefined variable $%s.', $variableName))->identifier('variable.undefined')->line($argument->getStartLine())->build(); } elseif ($this->checkMaybeUndefinedVariables && $scopeHasVariable->maybe()) { $messages[] = RuleErrorBuilder::message(sprintf('Call to function compact() contains possibly undefined variable $%s.', $variableName))->identifier('variable.undefined')->line($argument->getStartLine())->build(); } } } return $messages; } /** * @return array<int, ConstantStringType> */ private function findConstantStrings(Type $type) : array { if ($type instanceof ConstantStringType) { return [$type]; } if ($type instanceof ConstantArrayType) { $result = []; foreach ($type->getValueTypes() as $valueType) { $constantStrings = $this->findConstantStrings($valueType); $result = array_merge($result, $constantStrings); } return $result; } return []; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Variables; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\ExecutionEndNode; use PHPStan\Node\Expr\ParameterVariableOriginalValueExpr; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\ParameterReflectionWithPhpDocs; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Rules\RuleLevelHelper; use PHPStan\Type\ErrorType; use PHPStan\Type\NeverType; use PHPStan\Type\Type; use PHPStan\Type\TypeUtils; use PHPStan\Type\VerbosityLevel; use function sprintf; /** * @implements Rule<ExecutionEndNode> */ final class ParameterOutExecutionEndTypeRule implements Rule { /** * @var RuleLevelHelper */ private $ruleLevelHelper; public function __construct(RuleLevelHelper $ruleLevelHelper) { $this->ruleLevelHelper = $ruleLevelHelper; } public function getNodeType() : string { return ExecutionEndNode::class; } public function processNode(Node $node, Scope $scope) : array { $inFunction = $scope->getFunction(); if ($inFunction === null) { return []; } if ($scope->isInAnonymousFunction()) { return []; } $endNode = $node->getNode(); if ($endNode instanceof Node\Stmt\Expression) { $endNodeExpr = $endNode->expr; $endNodeExprType = $scope->getType($endNodeExpr); if ($endNodeExprType instanceof NeverType && $endNodeExprType->isExplicit()) { return []; } } if ($endNode instanceof Node\Stmt\Throw_) { return []; } $parameters = $inFunction->getParameters(); $errors = []; foreach ($parameters as $parameter) { if (!$parameter->passedByReference()->createsNewVariable()) { continue; } foreach ($this->processSingleParameter($scope, $inFunction, $parameter) as $error) { $errors[] = $error; } } return $errors; } /** * @return list<IdentifierRuleError> * @param FunctionReflection|ExtendedMethodReflection $inFunction */ private function processSingleParameter(Scope $scope, $inFunction, ParameterReflectionWithPhpDocs $parameter) : array { $outType = $parameter->getOutType(); if ($outType === null) { return []; } if ($scope->hasExpressionType(new ParameterVariableOriginalValueExpr($parameter->getName()))->no()) { return []; } $outType = TypeUtils::resolveLateResolvableTypes($outType); $variableExpr = new Node\Expr\Variable($parameter->getName()); $typeResult = $this->ruleLevelHelper->findTypeToCheck($scope, $variableExpr, '', static function (Type $type) use($outType) : bool { return $outType->isSuperTypeOf($type)->yes(); }); $type = $typeResult->getType(); if ($type instanceof ErrorType) { return $typeResult->getUnknownClassErrors(); } $assignedExprType = $scope->getType($variableExpr); if ($outType->isSuperTypeOf($assignedExprType)->yes()) { return []; } if ($inFunction instanceof ExtendedMethodReflection) { $functionDescription = sprintf('method %s::%s()', $inFunction->getDeclaringClass()->getDisplayName(), $inFunction->getName()); } else { $functionDescription = sprintf('function %s()', $inFunction->getName()); } $verbosityLevel = VerbosityLevel::getRecommendedLevelByType($outType, $assignedExprType); $errorBuilder = RuleErrorBuilder::message(sprintf('Parameter &$%s @param-out type of %s expects %s, %s given.', $parameter->getName(), $functionDescription, $outType->describe($verbosityLevel), $assignedExprType->describe($verbosityLevel)))->identifier(sprintf('paramOut.type')); return [$errorBuilder->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Variables; use PhpParser\Node; use PhpParser\Node\Expr\Clone_; use PhpParser\Node\Expr\Variable; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Rules\RuleLevelHelper; use PHPStan\Type\ErrorType; use PHPStan\Type\Type; use PHPStan\Type\VerbosityLevel; use function is_string; use function sprintf; /** * @implements Rule<Node\Expr\Clone_> */ final class VariableCloningRule implements Rule { /** * @var RuleLevelHelper */ private $ruleLevelHelper; public function __construct(RuleLevelHelper $ruleLevelHelper) { $this->ruleLevelHelper = $ruleLevelHelper; } public function getNodeType() : string { return Clone_::class; } public function processNode(Node $node, Scope $scope) : array { $typeResult = $this->ruleLevelHelper->findTypeToCheck($scope, $node->expr, 'Cloning object of an unknown class %s.', static function (Type $type) : bool { return $type->isCloneable()->yes(); }); $type = $typeResult->getType(); if ($type instanceof ErrorType) { return $typeResult->getUnknownClassErrors(); } if ($type->isCloneable()->yes()) { return []; } if ($node->expr instanceof Variable && is_string($node->expr->name)) { return [RuleErrorBuilder::message(sprintf('Cannot clone non-object variable $%s of type %s.', $node->expr->name, $type->describe(VerbosityLevel::typeOnly())))->identifier('clone.nonObject')->build()]; } return [RuleErrorBuilder::message(sprintf('Cannot clone %s.', $type->describe(VerbosityLevel::typeOnly())))->identifier('clone.nonObject')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Pure; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\MethodReturnStatementsNode; use PHPStan\Rules\Rule; use function sprintf; /** * @implements Rule<MethodReturnStatementsNode> */ final class PureMethodRule implements Rule { /** * @var FunctionPurityCheck */ private $check; public function __construct(\PHPStan\Rules\Pure\FunctionPurityCheck $check) { $this->check = $check; } public function getNodeType() : string { return MethodReturnStatementsNode::class; } public function processNode(Node $node, Scope $scope) : array { $method = $node->getMethodReflection(); return $this->check->check(sprintf('Method %s::%s()', $method->getDeclaringClass()->getDisplayName(), $method->getName()), 'Method', $method, $method->getParameters(), $method->getReturnType(), $node->getImpurePoints(), $node->getStatementResult()->getThrowPoints(), $node->getStatements(), $method->isConstructor()); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Pure; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\FunctionReturnStatementsNode; use PHPStan\Rules\Rule; use function sprintf; /** * @implements Rule<FunctionReturnStatementsNode> */ final class PureFunctionRule implements Rule { /** * @var FunctionPurityCheck */ private $check; public function __construct(\PHPStan\Rules\Pure\FunctionPurityCheck $check) { $this->check = $check; } public function getNodeType() : string { return FunctionReturnStatementsNode::class; } public function processNode(Node $node, Scope $scope) : array { $function = $node->getFunctionReflection(); return $this->check->check(sprintf('Function %s()', $function->getName()), 'Function', $function, $function->getParameters(), $function->getReturnType(), $node->getImpurePoints(), $node->getStatementResult()->getThrowPoints(), $node->getStatements(), \false); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Pure; use PhpParser\Node\Expr\FuncCall; use PhpParser\Node\Name; use PhpParser\Node\Stmt; use PHPStan\Analyser\ImpurePoint; use PHPStan\Analyser\ThrowPoint; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\ParameterReflectionWithPhpDocs; use PHPStan\Rules\Functions\CallToFunctionStatementWithoutSideEffectsRule; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\Type; use function array_filter; use function count; use function in_array; use function lcfirst; use function sprintf; final class FunctionPurityCheck { /** * @param 'Function'|'Method' $identifier * @param ParameterReflectionWithPhpDocs[] $parameters * @param ImpurePoint[] $impurePoints * @param ThrowPoint[] $throwPoints * @param Stmt[] $statements * @return list<IdentifierRuleError> * @param FunctionReflection|ExtendedMethodReflection $functionReflection */ public function check(string $functionDescription, string $identifier, $functionReflection, array $parameters, Type $returnType, array $impurePoints, array $throwPoints, array $statements, bool $isConstructor) : array { $errors = []; $isPure = $functionReflection->isPure(); if ($isPure->yes()) { foreach ($parameters as $parameter) { if (!$parameter->passedByReference()->createsNewVariable()) { continue; } $errors[] = RuleErrorBuilder::message(sprintf('%s is marked as pure but parameter $%s is passed by reference.', $functionDescription, $parameter->getName()))->identifier(sprintf('pure%s.parameterByRef', $identifier))->build(); } if ($returnType->isVoid()->yes() && !$isConstructor) { $errors[] = RuleErrorBuilder::message(sprintf('%s is marked as pure but returns void.', $functionDescription))->identifier(sprintf('pure%s.void', $identifier))->build(); } foreach ($impurePoints as $impurePoint) { $errors[] = RuleErrorBuilder::message(sprintf('%s %s in pure %s.', $impurePoint->isCertain() ? 'Impure' : 'Possibly impure', $impurePoint->getDescription(), lcfirst($functionDescription)))->line($impurePoint->getNode()->getStartLine())->identifier(sprintf('%s.%s', $impurePoint->isCertain() ? 'impure' : 'possiblyImpure', $impurePoint->getIdentifier()))->build(); } } elseif ($isPure->no()) { if (count($throwPoints) === 0 && count($impurePoints) === 0 && count($functionReflection->getAsserts()->getAll()) === 0) { $errors[] = RuleErrorBuilder::message(sprintf('%s is marked as impure but does not have any side effects.', $functionDescription))->identifier(sprintf('impure%s.pure', $identifier))->build(); } } elseif ($returnType->isVoid()->yes()) { if (count($throwPoints) === 0 && count($impurePoints) === 0 && !$isConstructor && (!$functionReflection instanceof ExtendedMethodReflection || $functionReflection->isPrivate()) && count($functionReflection->getAsserts()->getAll()) === 0) { $hasByRef = \false; foreach ($parameters as $parameter) { if (!$parameter->passedByReference()->createsNewVariable()) { continue; } $hasByRef = \true; break; } $statements = array_filter($statements, static function (Stmt $stmt) : bool { if ($stmt instanceof Stmt\Nop) { return \false; } if (!$stmt instanceof Stmt\Expression) { return \true; } if (!$stmt->expr instanceof FuncCall) { return \true; } if (!$stmt->expr->name instanceof Name) { return \true; } return !in_array($stmt->expr->name->toString(), CallToFunctionStatementWithoutSideEffectsRule::PHPSTAN_TESTING_FUNCTIONS, \true); }); if (!$hasByRef && count($statements) > 0) { $errors[] = RuleErrorBuilder::message(sprintf('%s returns void but does not have any side effects.', $functionDescription))->identifier('void.pure')->build(); } } } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules; /** @api */ interface FileRuleError extends \PHPStan\Rules\RuleError { public function getFile() : string; public function getFileDescription() : string; } <?php declare (strict_types=1); namespace PHPStan\Rules; use PhpParser\Node\Arg; use PHPStan\Analyser\ArgumentsNormalizer; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ParameterReflection; use PHPStan\Type\ErrorType; use PHPStan\Type\Type; use PHPStan\Type\VerbosityLevel; use function sprintf; final class ParameterCastableToStringCheck { /** * @var RuleLevelHelper */ private $ruleLevelHelper; public function __construct(\PHPStan\Rules\RuleLevelHelper $ruleLevelHelper) { $this->ruleLevelHelper = $ruleLevelHelper; } /** @param callable(Type): Type $castFn */ public function checkParameter(Arg $parameter, Scope $scope, string $errorMessageTemplate, callable $castFn, string $functionName, string $parameterName) : ?\PHPStan\Rules\IdentifierRuleError { if ($parameter->unpack) { return null; } $typeResult = $this->ruleLevelHelper->findTypeToCheck($scope, $parameter->value, '', static function (Type $type) use($castFn) : bool { return !$castFn($type->getIterableValueType()) instanceof ErrorType; }); if ($typeResult->getType() instanceof ErrorType || !$castFn($typeResult->getType()->getIterableValueType()) instanceof ErrorType) { return null; } return \PHPStan\Rules\RuleErrorBuilder::message(sprintf($errorMessageTemplate, $parameterName, $functionName, $typeResult->getType()->describe(VerbosityLevel::typeOnly())))->identifier('argument.type')->build(); } public function getParameterName(Arg $parameter, int $parameterIdx, ?ParameterReflection $parameterReflection) : string { if ($parameterReflection === null) { return sprintf('#%d', $parameterIdx + 1); } $paramName = $parameterReflection->getName(); $origParameter = $parameter->getAttributes()[ArgumentsNormalizer::ORIGINAL_ARG_ATTRIBUTE] ?? null; if (!$origParameter instanceof Arg) { $origParameter = $parameter; } return $origParameter->name !== null ? sprintf('$%s', $paramName) : sprintf('#%d $%s', $parameterIdx + 1, $paramName); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Classes; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\InClassNode; use PHPStan\Rules\Rule; /** * @implements Rule<InClassNode> */ final class MethodTagRule implements Rule { /** * @var MethodTagCheck */ private $check; public function __construct(\PHPStan\Rules\Classes\MethodTagCheck $check) { $this->check = $check; } public function getNodeType() : string { return InClassNode::class; } public function processNode(Node $node, Scope $scope) : array { return $this->check->check($node->getClassReflection(), $node->getOriginalNode()); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Classes; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\InClassNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\ObjectType; use PHPStan\Type\VerbosityLevel; use function sprintf; /** * @implements Rule<InClassNode> */ final class RequireImplementsRule implements Rule { public function getNodeType() : string { return InClassNode::class; } public function processNode(Node $node, Scope $scope) : array { $classReflection = $node->getClassReflection(); $errors = []; foreach ($classReflection->getTraits(\true) as $trait) { $implementsTags = $trait->getRequireImplementsTags(); foreach ($implementsTags as $implementsTag) { $type = $implementsTag->getType(); if (!$type instanceof ObjectType) { continue; } if ($classReflection->implementsInterface($type->getClassName())) { continue; } $errors[] = RuleErrorBuilder::message(sprintf('Trait %s requires using class to implement %s, but %s does not.', $trait->getDisplayName(), $type->describe(VerbosityLevel::typeOnly()), $classReflection->getDisplayName()))->identifier('class.missingImplements')->build(); } } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Classes; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\InClassNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\ObjectType; use PHPStan\Type\VerbosityLevel; use function sprintf; /** * @implements Rule<InClassNode> */ final class RequireExtendsRule implements Rule { public function getNodeType() : string { return InClassNode::class; } public function processNode(Node $node, Scope $scope) : array { $classReflection = $node->getClassReflection(); if ($classReflection->isInterface()) { return []; } $errors = []; foreach ($classReflection->getInterfaces() as $interface) { $extendsTags = $interface->getRequireExtendsTags(); foreach ($extendsTags as $extendsTag) { $type = $extendsTag->getType(); if (!$type instanceof ObjectType) { continue; } if ($classReflection->is($type->getClassName())) { continue; } $errors[] = RuleErrorBuilder::message(sprintf('Interface %s requires implementing class to extend %s, but %s does not.', $interface->getDisplayName(), $type->describe(VerbosityLevel::typeOnly()), $classReflection->getDisplayName()))->identifier('class.missingExtends')->build(); } } foreach ($classReflection->getTraits(\true) as $trait) { $extendsTags = $trait->getRequireExtendsTags(); foreach ($extendsTags as $extendsTag) { $type = $extendsTag->getType(); if (!$type instanceof ObjectType) { continue; } if ($classReflection->is($type->getClassName())) { continue; } $errors[] = RuleErrorBuilder::message(sprintf('Trait %s requires using class to extend %s, but %s does not.', $trait->getDisplayName(), $type->describe(VerbosityLevel::typeOnly()), $classReflection->getDisplayName()))->identifier('class.missingExtends')->build(); } } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Classes; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\ClassNameCheck; use PHPStan\Rules\ClassNameNodePair; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function array_map; use function sprintf; /** * @implements Rule<Node\Stmt\Enum_> */ final class ExistingClassesInEnumImplementsRule implements Rule { /** * @var ClassNameCheck */ private $classCheck; /** * @var ReflectionProvider */ private $reflectionProvider; public function __construct(ClassNameCheck $classCheck, ReflectionProvider $reflectionProvider) { $this->classCheck = $classCheck; $this->reflectionProvider = $reflectionProvider; } public function getNodeType() : string { return Node\Stmt\Enum_::class; } public function processNode(Node $node, Scope $scope) : array { $messages = $this->classCheck->checkClassNames(array_map(static function (Node\Name $interfaceName) : ClassNameNodePair { return new ClassNameNodePair((string) $interfaceName, $interfaceName); }, $node->implements)); $currentEnumName = (string) $node->namespacedName; foreach ($node->implements as $implements) { $implementedClassName = (string) $implements; if (!$this->reflectionProvider->hasClass($implementedClassName)) { if (!$scope->isInClassExists($implementedClassName)) { $messages[] = RuleErrorBuilder::message(sprintf('Enum %s implements unknown interface %s.', $currentEnumName, $implementedClassName))->identifier('interface.notFound')->nonIgnorable()->discoveringSymbolsTip()->build(); } } else { $reflection = $this->reflectionProvider->getClass($implementedClassName); if ($reflection->isClass()) { $messages[] = RuleErrorBuilder::message(sprintf('Enum %s implements class %s.', $currentEnumName, $reflection->getDisplayName()))->identifier('enumImplements.class')->nonIgnorable()->build(); } elseif ($reflection->isTrait()) { $messages[] = RuleErrorBuilder::message(sprintf('Enum %s implements trait %s.', $currentEnumName, $reflection->getDisplayName()))->identifier('enumImplements.trait')->nonIgnorable()->build(); } elseif ($reflection->isEnum()) { $messages[] = RuleErrorBuilder::message(sprintf('Enum %s implements enum %s.', $currentEnumName, $reflection->getDisplayName()))->identifier('enumImplements.enum')->nonIgnorable()->build(); } } } return $messages; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Classes; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\InClassNode; use PHPStan\Rules\Rule; /** * @implements Rule<InClassNode> */ final class LocalTypeAliasesRule implements Rule { /** * @var LocalTypeAliasesCheck */ private $check; public function __construct(\PHPStan\Rules\Classes\LocalTypeAliasesCheck $check) { $this->check = $check; } public function getNodeType() : string { return InClassNode::class; } public function processNode(Node $node, Scope $scope) : array { return $this->check->check($node->getClassReflection(), $node->getOriginalNode()); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Classes; use PhpParser\Node\Stmt\ClassLike; use PHPStan\Internal\SprintfHelper; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\ClassNameCheck; use PHPStan\Rules\ClassNameNodePair; use PHPStan\Rules\Generics\GenericObjectTypeCheck; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\MissingTypehintCheck; use PHPStan\Rules\PhpDoc\UnresolvableTypeHelper; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\Type; use PHPStan\Type\VerbosityLevel; use function array_merge; use function sprintf; final class MethodTagCheck { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var ClassNameCheck */ private $classCheck; /** * @var GenericObjectTypeCheck */ private $genericObjectTypeCheck; /** * @var MissingTypehintCheck */ private $missingTypehintCheck; /** * @var UnresolvableTypeHelper */ private $unresolvableTypeHelper; /** * @var bool */ private $checkClassCaseSensitivity; /** * @var bool */ private $checkMissingTypehints; public function __construct(ReflectionProvider $reflectionProvider, ClassNameCheck $classCheck, GenericObjectTypeCheck $genericObjectTypeCheck, MissingTypehintCheck $missingTypehintCheck, UnresolvableTypeHelper $unresolvableTypeHelper, bool $checkClassCaseSensitivity, bool $checkMissingTypehints) { $this->reflectionProvider = $reflectionProvider; $this->classCheck = $classCheck; $this->genericObjectTypeCheck = $genericObjectTypeCheck; $this->missingTypehintCheck = $missingTypehintCheck; $this->unresolvableTypeHelper = $unresolvableTypeHelper; $this->checkClassCaseSensitivity = $checkClassCaseSensitivity; $this->checkMissingTypehints = $checkMissingTypehints; } /** * @return list<IdentifierRuleError> */ public function check(ClassReflection $classReflection, ClassLike $node) : array { $errors = []; foreach ($classReflection->getMethodTags() as $methodName => $methodTag) { $i = 0; foreach ($methodTag->getParameters() as $parameterName => $parameterTag) { $i++; $parameterDescription = sprintf('parameter #%d $%s', $i, $parameterName); foreach ($this->checkMethodTypeInTraitDefinitionContext($classReflection, $methodName, $parameterDescription, $parameterTag->getType()) as $error) { $errors[] = $error; } foreach ($this->checkMethodTypeInTraitUseContext($classReflection, $methodName, $parameterDescription, $parameterTag->getType(), $node) as $error) { $errors[] = $error; } if ($parameterTag->getDefaultValue() === null) { continue; } $defaultValueDescription = sprintf('%s default value', $parameterDescription); foreach ($this->checkMethodTypeInTraitDefinitionContext($classReflection, $methodName, $defaultValueDescription, $parameterTag->getDefaultValue()) as $error) { $errors[] = $error; } foreach ($this->checkMethodTypeInTraitUseContext($classReflection, $methodName, $defaultValueDescription, $parameterTag->getDefaultValue(), $node) as $error) { $errors[] = $error; } } $returnTypeDescription = 'return type'; foreach ($this->checkMethodTypeInTraitDefinitionContext($classReflection, $methodName, $returnTypeDescription, $methodTag->getReturnType()) as $error) { $errors[] = $error; } foreach ($this->checkMethodTypeInTraitUseContext($classReflection, $methodName, $returnTypeDescription, $methodTag->getReturnType(), $node) as $error) { $errors[] = $error; } } return $errors; } /** * @return list<IdentifierRuleError> */ public function checkInTraitDefinitionContext(ClassReflection $classReflection) : array { $errors = []; foreach ($classReflection->getMethodTags() as $methodName => $methodTag) { $i = 0; foreach ($methodTag->getParameters() as $parameterName => $parameterTag) { $i++; $parameterDescription = sprintf('parameter #%d $%s', $i, $parameterName); foreach ($this->checkMethodTypeInTraitDefinitionContext($classReflection, $methodName, $parameterDescription, $parameterTag->getType()) as $error) { $errors[] = $error; } if ($parameterTag->getDefaultValue() === null) { continue; } $defaultValueDescription = sprintf('%s default value', $parameterDescription); foreach ($this->checkMethodTypeInTraitDefinitionContext($classReflection, $methodName, $defaultValueDescription, $parameterTag->getDefaultValue()) as $error) { $errors[] = $error; } } $returnTypeDescription = 'return type'; foreach ($this->checkMethodTypeInTraitDefinitionContext($classReflection, $methodName, $returnTypeDescription, $methodTag->getReturnType()) as $error) { $errors[] = $error; } } return $errors; } /** * @return list<IdentifierRuleError> */ public function checkInTraitUseContext(ClassReflection $classReflection, ClassReflection $implementingClass, ClassLike $node) : array { $phpDoc = $classReflection->getTraitContextResolvedPhpDoc($implementingClass); if ($phpDoc === null) { return []; } $errors = []; foreach ($phpDoc->getMethodTags() as $methodName => $methodTag) { $i = 0; foreach ($methodTag->getParameters() as $parameterName => $parameterTag) { $i++; $parameterDescription = sprintf('parameter #%d $%s', $i, $parameterName); foreach ($this->checkMethodTypeInTraitUseContext($classReflection, $methodName, $parameterDescription, $parameterTag->getType(), $node) as $error) { $errors[] = $error; } if ($parameterTag->getDefaultValue() === null) { continue; } $defaultValueDescription = sprintf('%s default value', $parameterDescription); foreach ($this->checkMethodTypeInTraitUseContext($classReflection, $methodName, $defaultValueDescription, $parameterTag->getDefaultValue(), $node) as $error) { $errors[] = $error; } } $returnTypeDescription = 'return type'; foreach ($this->checkMethodTypeInTraitUseContext($classReflection, $methodName, $returnTypeDescription, $methodTag->getReturnType(), $node) as $error) { $errors[] = $error; } } return $errors; } /** * @return list<IdentifierRuleError> */ private function checkMethodTypeInTraitDefinitionContext(ClassReflection $classReflection, string $methodName, string $description, Type $type) : array { if (!$this->checkMissingTypehints) { return []; } $errors = []; foreach ($this->missingTypehintCheck->getNonGenericObjectTypesWithGenericClass($type) as [$innerName, $genericTypeNames]) { $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag @method for method %s::%s() %s contains generic %s but does not specify its types: %s', $classReflection->getDisplayName(), $methodName, $description, $innerName, $genericTypeNames))->identifier('missingType.generics')->build(); } foreach ($this->missingTypehintCheck->getIterableTypesWithMissingValueTypehint($type) as $iterableType) { $iterableTypeDescription = $iterableType->describe(VerbosityLevel::typeOnly()); $errors[] = RuleErrorBuilder::message(sprintf('%s %s has PHPDoc tag @method for method %s() %s with no value type specified in iterable type %s.', $classReflection->getClassTypeDescription(), $classReflection->getDisplayName(), $methodName, $description, $iterableTypeDescription))->tip(MissingTypehintCheck::MISSING_ITERABLE_VALUE_TYPE_TIP)->identifier('missingType.iterableValue')->build(); } foreach ($this->missingTypehintCheck->getCallablesWithMissingSignature($type) as $callableType) { $errors[] = RuleErrorBuilder::message(sprintf('%s %s has PHPDoc tag @method for method %s() %s with no signature specified for %s.', $classReflection->getClassTypeDescription(), $classReflection->getDisplayName(), $methodName, $description, $callableType->describe(VerbosityLevel::typeOnly())))->identifier('missingType.callable')->build(); } return $errors; } /** * @return list<IdentifierRuleError> */ private function checkMethodTypeInTraitUseContext(ClassReflection $classReflection, string $methodName, string $description, Type $type, ClassLike $node) : array { $errors = []; foreach ($type->getReferencedClasses() as $class) { if (!$this->reflectionProvider->hasClass($class)) { $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag @method for method %s::%s() %s contains unknown class %s.', $classReflection->getDisplayName(), $methodName, $description, $class))->identifier('class.notFound')->discoveringSymbolsTip()->build(); } elseif ($this->reflectionProvider->getClass($class)->isTrait()) { $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag @method for method %s::%s() %s contains invalid type %s.', $classReflection->getDisplayName(), $methodName, $description, $class))->identifier('methodTag.trait')->build(); } else { $errors = array_merge($errors, $this->classCheck->checkClassNames([new ClassNameNodePair($class, $node)], $this->checkClassCaseSensitivity)); } } if ($this->unresolvableTypeHelper->containsUnresolvableType($type)) { $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag @method for method %s::%s() %s contains unresolvable type.', $classReflection->getDisplayName(), $methodName, $description))->identifier('methodTag.unresolvableType')->build(); } $escapedClassName = SprintfHelper::escapeFormatString($classReflection->getDisplayName()); $escapedMethodName = SprintfHelper::escapeFormatString($methodName); $escapedDescription = SprintfHelper::escapeFormatString($description); return array_merge($errors, $this->genericObjectTypeCheck->check($type, sprintf('PHPDoc tag @method for method %s::%s() %s contains generic type %%s but %%s %%s is not generic.', $escapedClassName, $escapedMethodName, $escapedDescription), sprintf('Generic type %%s in PHPDoc tag @method for method %s::%s() %s does not specify all template types of %%s %%s: %%s', $escapedClassName, $escapedMethodName, $escapedDescription), sprintf('Generic type %%s in PHPDoc tag @method for method %s::%s() %s specifies %%d template types, but %%s %%s supports only %%d: %%s', $escapedClassName, $escapedMethodName, $escapedDescription), sprintf('Type %%s in generic type %%s in PHPDoc tag @method for method %s::%s() %s is not subtype of template type %%s of %%s %%s.', $escapedClassName, $escapedMethodName, $escapedDescription), sprintf('Call-site variance of %%s in generic type %%s in PHPDoc tag @method for method %s::%s() %s is in conflict with %%s template type %%s of %%s %%s.', $escapedClassName, $escapedMethodName, $escapedDescription), sprintf('Call-site variance of %%s in generic type %%s in PHPDoc tag @method for method %s::%s() %s is redundant, template type %%s of %%s %%s has the same variance.', $escapedClassName, $escapedMethodName, $escapedDescription))); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Classes; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\InClassNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function array_values; use function sprintf; use function strtolower; /** * @implements Rule<InClassNode> */ final class AllowedSubTypesRule implements Rule { public function getNodeType() : string { return InClassNode::class; } /** * @param InClassNode $node */ public function processNode(Node $node, Scope $scope) : array { $classReflection = $node->getClassReflection(); $className = $classReflection->getName(); $parents = array_values($classReflection->getImmediateInterfaces()); $parentClass = $classReflection->getParentClass(); if ($parentClass !== null) { $parents[] = $parentClass; } $messages = []; foreach ($parents as $parentReflection) { $allowedSubTypes = $parentReflection->getAllowedSubTypes(); if ($allowedSubTypes === null) { continue; } foreach ($allowedSubTypes as $allowedSubType) { if (!$allowedSubType->isObject()->yes()) { continue; } if ($allowedSubType->getObjectClassNames() === [$className]) { continue 2; } } $identifierType = strtolower($classReflection->getClassTypeDescription()); $messages[] = RuleErrorBuilder::message(sprintf('Type %s is not allowed to be a subtype of %s.', $className, $parentReflection->getName()))->identifier(sprintf('%s.disallowedSubtype', $identifierType))->build(); } return $messages; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Classes; use PhpParser\Node; use PhpParser\Node\Expr\Instanceof_; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\ClassNameCheck; use PHPStan\Rules\ClassNameNodePair; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\VerbosityLevel; use function array_merge; use function in_array; use function sprintf; use function strtolower; /** * @implements Rule<Node\Expr\Instanceof_> */ final class ExistingClassInInstanceOfRule implements Rule { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var ClassNameCheck */ private $classCheck; /** * @var bool */ private $checkClassCaseSensitivity; public function __construct(ReflectionProvider $reflectionProvider, ClassNameCheck $classCheck, bool $checkClassCaseSensitivity) { $this->reflectionProvider = $reflectionProvider; $this->classCheck = $classCheck; $this->checkClassCaseSensitivity = $checkClassCaseSensitivity; } public function getNodeType() : string { return Instanceof_::class; } public function processNode(Node $node, Scope $scope) : array { $class = $node->class; if (!$class instanceof Node\Name) { return []; } $name = (string) $class; $lowercaseName = strtolower($name); if (in_array($lowercaseName, ['self', 'static', 'parent'], \true)) { if (!$scope->isInClass()) { return [RuleErrorBuilder::message(sprintf('Using %s outside of class scope.', $lowercaseName))->identifier(sprintf('outOfClass.%s', $lowercaseName))->line($class->getStartLine())->build()]; } return []; } $errors = []; if (!$this->reflectionProvider->hasClass($name)) { if ($scope->isInClassExists($name)) { return []; } return [RuleErrorBuilder::message(sprintf('Class %s not found.', $name))->identifier('class.notFound')->line($class->getStartLine())->discoveringSymbolsTip()->build()]; } $errors = array_merge($errors, $this->classCheck->checkClassNames([new ClassNameNodePair($name, $class)], $this->checkClassCaseSensitivity)); $classReflection = $this->reflectionProvider->getClass($name); if ($classReflection->isTrait()) { $expressionType = $scope->getType($node->expr); $errors[] = RuleErrorBuilder::message(sprintf('Instanceof between %s and trait %s will always evaluate to false.', $expressionType->describe(VerbosityLevel::typeOnly()), $name))->identifier('instanceof.trait')->build(); } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Classes; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\ClassNameCheck; use PHPStan\Rules\ClassNameNodePair; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function array_map; use function sprintf; /** * @implements Rule<Node\Stmt\Interface_> */ final class ExistingClassesInInterfaceExtendsRule implements Rule { /** * @var ClassNameCheck */ private $classCheck; /** * @var ReflectionProvider */ private $reflectionProvider; public function __construct(ClassNameCheck $classCheck, ReflectionProvider $reflectionProvider) { $this->classCheck = $classCheck; $this->reflectionProvider = $reflectionProvider; } public function getNodeType() : string { return Node\Stmt\Interface_::class; } public function processNode(Node $node, Scope $scope) : array { $messages = $this->classCheck->checkClassNames(array_map(static function (Node\Name $interfaceName) : ClassNameNodePair { return new ClassNameNodePair((string) $interfaceName, $interfaceName); }, $node->extends)); $currentInterfaceName = (string) $node->namespacedName; foreach ($node->extends as $extends) { $extendedInterfaceName = (string) $extends; if (!$this->reflectionProvider->hasClass($extendedInterfaceName)) { if (!$scope->isInClassExists($extendedInterfaceName)) { $messages[] = RuleErrorBuilder::message(sprintf('Interface %s extends unknown interface %s.', $currentInterfaceName, $extendedInterfaceName))->identifier('interface.notFound')->nonIgnorable()->discoveringSymbolsTip()->build(); } } else { $reflection = $this->reflectionProvider->getClass($extendedInterfaceName); if ($reflection->isClass()) { $messages[] = RuleErrorBuilder::message(sprintf('Interface %s extends class %s.', $currentInterfaceName, $reflection->getDisplayName()))->identifier('interfaceExtends.class')->nonIgnorable()->build(); } elseif ($reflection->isTrait()) { $messages[] = RuleErrorBuilder::message(sprintf('Interface %s extends trait %s.', $currentInterfaceName, $reflection->getDisplayName()))->identifier('interfaceExtends.trait')->nonIgnorable()->build(); } elseif ($reflection->isEnum()) { $messages[] = RuleErrorBuilder::message(sprintf('Interface %s extends enum %s.', $currentInterfaceName, $reflection->getDisplayName()))->identifier('interfaceExtends.enum')->nonIgnorable()->build(); } } return $messages; } return $messages; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Classes; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\InstantiationCallableNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; /** * @implements Rule<InstantiationCallableNode> */ final class InstantiationCallableRule implements Rule { public function getNodeType() : string { return InstantiationCallableNode::class; } public function processNode(Node $node, Scope $scope) : array { return [RuleErrorBuilder::message('Cannot create callable from the new operator.')->identifier('callable.notSupported')->nonIgnorable()->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Classes; use PhpParser\Node; use PhpParser\Node\Name; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function sprintf; /** * @implements Rule<Node\Expr\ClassConstFetch> */ final class AccessPrivateConstantThroughStaticRule implements Rule { public function getNodeType() : string { return Node\Expr\ClassConstFetch::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->name instanceof Node\Identifier) { return []; } if (!$node->class instanceof Name) { return []; } $constantName = $node->name->name; $className = $node->class; if ($className->toLowerString() !== 'static') { return []; } $classType = $scope->resolveTypeByName($className); if (!$classType->hasConstant($constantName)->yes()) { return []; } $constant = $classType->getConstant($constantName); if (!$constant->isPrivate()) { return []; } if ($scope->isInClass() && $scope->getClassReflection()->isFinal()) { return []; } return [RuleErrorBuilder::message(sprintf('Unsafe access to private constant %s::%s through static::.', $constant->getDeclaringClass()->getDisplayName(), $constantName))->identifier('staticClassAccess.privateConstant')->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Classes; use PhpParser\Node; use PhpParser\Node\Stmt\ClassConst; use PhpParser\Node\Stmt\EnumCase; use PHPStan\Analyser\Scope; use PHPStan\Node\InClassNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\ShouldNotHappenException; use function array_key_exists; use function is_string; use function sprintf; use function strtolower; /** * @implements Rule<InClassNode> */ final class DuplicateDeclarationRule implements Rule { public function getNodeType() : string { return InClassNode::class; } public function processNode(Node $node, Scope $scope) : array { $classReflection = $node->getClassReflection(); $identifierType = strtolower($classReflection->getClassTypeDescription()); $errors = []; $declaredClassConstantsOrEnumCases = []; foreach ($node->getOriginalNode()->stmts as $stmtNode) { if ($stmtNode instanceof EnumCase) { if (array_key_exists($stmtNode->name->name, $declaredClassConstantsOrEnumCases)) { $errors[] = RuleErrorBuilder::message(sprintf('Cannot redeclare enum case %s::%s.', $classReflection->getDisplayName(), $stmtNode->name->name))->identifier(sprintf('%s.duplicateEnumCase', $identifierType))->line($stmtNode->getStartLine())->nonIgnorable()->build(); } else { $declaredClassConstantsOrEnumCases[$stmtNode->name->name] = \true; } } elseif ($stmtNode instanceof ClassConst) { foreach ($stmtNode->consts as $classConstNode) { if (array_key_exists($classConstNode->name->name, $declaredClassConstantsOrEnumCases)) { $errors[] = RuleErrorBuilder::message(sprintf('Cannot redeclare constant %s::%s.', $classReflection->getDisplayName(), $classConstNode->name->name))->identifier(sprintf('%s.duplicateConstant', $identifierType))->line($classConstNode->getStartLine())->nonIgnorable()->build(); } else { $declaredClassConstantsOrEnumCases[$classConstNode->name->name] = \true; } } } } $declaredProperties = []; foreach ($node->getOriginalNode()->getProperties() as $propertyDecl) { foreach ($propertyDecl->props as $property) { if (array_key_exists($property->name->name, $declaredProperties)) { $errors[] = RuleErrorBuilder::message(sprintf('Cannot redeclare property %s::$%s.', $classReflection->getDisplayName(), $property->name->name))->identifier(sprintf('%s.duplicateProperty', $identifierType))->line($property->getStartLine())->nonIgnorable()->build(); } else { $declaredProperties[$property->name->name] = \true; } } } $declaredFunctions = []; foreach ($node->getOriginalNode()->getMethods() as $method) { if ($method->name->toLowerString() === '__construct') { foreach ($method->params as $param) { if ($param->flags === 0) { continue; } if (!$param->var instanceof Node\Expr\Variable || !is_string($param->var->name)) { throw new ShouldNotHappenException(); } $propertyName = $param->var->name; if (array_key_exists($propertyName, $declaredProperties)) { $errors[] = RuleErrorBuilder::message(sprintf('Cannot redeclare property %s::$%s.', $classReflection->getDisplayName(), $propertyName))->identifier(sprintf('%s.duplicateProperty', $identifierType))->line($param->getStartLine())->nonIgnorable()->build(); } else { $declaredProperties[$propertyName] = \true; } } } if (array_key_exists(strtolower($method->name->name), $declaredFunctions)) { $errors[] = RuleErrorBuilder::message(sprintf('Cannot redeclare method %s::%s().', $classReflection->getDisplayName(), $method->name->name))->identifier(sprintf('%s.duplicateMethod', $identifierType))->line($method->getStartLine())->nonIgnorable()->build(); } else { $declaredFunctions[strtolower($method->name->name)] = \true; } } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Classes; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; /** * @implements Rule<Node\Stmt\Trait_> */ final class TraitAttributeClassRule implements Rule { public function getNodeType() : string { return Node\Stmt\Trait_::class; } public function processNode(Node $node, Scope $scope) : array { foreach ($node->attrGroups as $attrGroup) { foreach ($attrGroup->attrs as $attr) { $name = $attr->name->toLowerString(); if ($name === 'attribute') { return [RuleErrorBuilder::message('Trait cannot be an Attribute class.')->identifier('attribute.trait')->build()]; } } } return []; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Classes; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\ClassNameCheck; use PHPStan\Rules\ClassNameNodePair; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\ShouldNotHappenException; use function array_map; use function sprintf; /** * @implements Rule<Node\Stmt\TraitUse> */ final class ExistingClassInTraitUseRule implements Rule { /** * @var ClassNameCheck */ private $classCheck; /** * @var ReflectionProvider */ private $reflectionProvider; public function __construct(ClassNameCheck $classCheck, ReflectionProvider $reflectionProvider) { $this->classCheck = $classCheck; $this->reflectionProvider = $reflectionProvider; } public function getNodeType() : string { return Node\Stmt\TraitUse::class; } public function processNode(Node $node, Scope $scope) : array { $messages = $this->classCheck->checkClassNames(array_map(static function (Node\Name $traitName) : ClassNameNodePair { return new ClassNameNodePair((string) $traitName, $traitName); }, $node->traits)); if (!$scope->isInClass()) { throw new ShouldNotHappenException(); } $classReflection = $scope->getClassReflection(); if ($classReflection->isInterface()) { if (!$scope->isInTrait()) { foreach ($node->traits as $trait) { $messages[] = RuleErrorBuilder::message(sprintf('Interface %s uses trait %s.', $classReflection->getName(), (string) $trait))->identifier('interface.traitUse')->nonIgnorable()->build(); } } } else { if ($scope->isInTrait()) { $currentName = sprintf('Trait %s', $scope->getTraitReflection()->getName()); } else { if ($classReflection->isAnonymous()) { $currentName = 'Anonymous class'; } else { $currentName = sprintf('Class %s', $classReflection->getName()); } } foreach ($node->traits as $trait) { $traitName = (string) $trait; if (!$this->reflectionProvider->hasClass($traitName)) { $messages[] = RuleErrorBuilder::message(sprintf('%s uses unknown trait %s.', $currentName, $traitName))->identifier('trait.notFound')->nonIgnorable()->discoveringSymbolsTip()->build(); } else { $reflection = $this->reflectionProvider->getClass($traitName); if ($reflection->isClass()) { $messages[] = RuleErrorBuilder::message(sprintf('%s uses class %s.', $currentName, $reflection->getDisplayName()))->identifier('traitUse.class')->nonIgnorable()->build(); } elseif ($reflection->isInterface()) { $messages[] = RuleErrorBuilder::message(sprintf('%s uses interface %s.', $currentName, $reflection->getDisplayName()))->identifier('traitUse.interface')->nonIgnorable()->build(); } elseif ($reflection->isEnum()) { $messages[] = RuleErrorBuilder::message(sprintf('%s uses enum %s.', $currentName, $reflection->getDisplayName()))->identifier('traitUse.enum')->nonIgnorable()->build(); } } } } return $messages; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Classes; use PhpParser\Node\Stmt\ClassLike; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\ClassNameCheck; use PHPStan\Rules\ClassNameNodePair; use PHPStan\Rules\Generics\GenericObjectTypeCheck; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\MissingTypehintCheck; use PHPStan\Rules\PhpDoc\UnresolvableTypeHelper; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\VerbosityLevel; use function array_merge; use function sprintf; final class MixinCheck { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var ClassNameCheck */ private $classCheck; /** * @var GenericObjectTypeCheck */ private $genericObjectTypeCheck; /** * @var MissingTypehintCheck */ private $missingTypehintCheck; /** * @var UnresolvableTypeHelper */ private $unresolvableTypeHelper; /** * @var bool */ private $checkClassCaseSensitivity; /** * @var bool */ private $absentTypeChecks; /** * @var bool */ private $checkMissingTypehints; public function __construct(ReflectionProvider $reflectionProvider, ClassNameCheck $classCheck, GenericObjectTypeCheck $genericObjectTypeCheck, MissingTypehintCheck $missingTypehintCheck, UnresolvableTypeHelper $unresolvableTypeHelper, bool $checkClassCaseSensitivity, bool $absentTypeChecks, bool $checkMissingTypehints) { $this->reflectionProvider = $reflectionProvider; $this->classCheck = $classCheck; $this->genericObjectTypeCheck = $genericObjectTypeCheck; $this->missingTypehintCheck = $missingTypehintCheck; $this->unresolvableTypeHelper = $unresolvableTypeHelper; $this->checkClassCaseSensitivity = $checkClassCaseSensitivity; $this->absentTypeChecks = $absentTypeChecks; $this->checkMissingTypehints = $checkMissingTypehints; } /** * @return list<IdentifierRuleError> */ public function check(ClassReflection $classReflection, ClassLike $node) : array { $errors = []; foreach ($this->checkInTraitDefinitionContext($classReflection) as $error) { $errors[] = $error; } foreach ($this->checkInTraitUseContext($classReflection, $classReflection, $node) as $error) { $errors[] = $error; } return $errors; } /** * @return list<IdentifierRuleError> */ public function checkInTraitDefinitionContext(ClassReflection $classReflection) : array { $errors = []; foreach ($classReflection->getMixinTags() as $mixinTag) { $type = $mixinTag->getType(); if (!$type->canCallMethods()->yes() || !$type->canAccessProperties()->yes()) { $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag @mixin contains non-object type %s.', $type->describe(VerbosityLevel::typeOnly())))->identifier('mixin.nonObject')->build(); continue; } if (!$this->absentTypeChecks) { continue; } if (!$this->checkMissingTypehints) { continue; } foreach ($this->missingTypehintCheck->getIterableTypesWithMissingValueTypehint($type) as $iterableType) { $iterableTypeDescription = $iterableType->describe(VerbosityLevel::typeOnly()); $errors[] = RuleErrorBuilder::message(sprintf('%s %s has PHPDoc tag @mixin with no value type specified in iterable type %s.', $classReflection->getClassTypeDescription(), $classReflection->getDisplayName(), $iterableTypeDescription))->tip(MissingTypehintCheck::MISSING_ITERABLE_VALUE_TYPE_TIP)->identifier('missingType.iterableValue')->build(); } foreach ($this->missingTypehintCheck->getNonGenericObjectTypesWithGenericClass($type) as [$innerName, $genericTypeNames]) { $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag @mixin contains generic %s but does not specify its types: %s', $innerName, $genericTypeNames))->identifier('missingType.generics')->build(); } foreach ($this->missingTypehintCheck->getCallablesWithMissingSignature($type) as $callableType) { $errors[] = RuleErrorBuilder::message(sprintf('%s %s has PHPDoc tag @mixin with no signature specified for %s.', $classReflection->getClassTypeDescription(), $classReflection->getDisplayName(), $callableType->describe(VerbosityLevel::typeOnly())))->identifier('missingType.callable')->build(); } } return $errors; } /** * @return list<IdentifierRuleError> */ public function checkInTraitUseContext(ClassReflection $reflection, ClassReflection $implementingClassReflection, ClassLike $node) : array { if ($reflection->getNativeReflection()->getName() === $implementingClassReflection->getName()) { $phpDoc = $reflection->getResolvedPhpDoc(); } else { $phpDoc = $reflection->getTraitContextResolvedPhpDoc($implementingClassReflection); } if ($phpDoc === null) { return []; } $errors = []; foreach ($phpDoc->getMixinTags() as $mixinTag) { $type = $mixinTag->getType(); if ($this->unresolvableTypeHelper->containsUnresolvableType($type)) { $errors[] = RuleErrorBuilder::message('PHPDoc tag @mixin contains unresolvable type.')->identifier('mixin.unresolvableType')->build(); continue; } $errors = array_merge($errors, $this->genericObjectTypeCheck->check($type, 'PHPDoc tag @mixin contains generic type %s but %s %s is not generic.', 'Generic type %s in PHPDoc tag @mixin does not specify all template types of %s %s: %s', 'Generic type %s in PHPDoc tag @mixin specifies %d template types, but %s %s supports only %d: %s', 'Type %s in generic type %s in PHPDoc tag @mixin is not subtype of template type %s of %s %s.', 'Call-site variance of %s in generic type %s in PHPDoc tag @mixin is in conflict with %s template type %s of %s %s.', 'Call-site variance of %s in generic type %s in PHPDoc tag @mixin is redundant, template type %s of %s %s has the same variance.')); foreach ($type->getReferencedClasses() as $class) { if (!$this->reflectionProvider->hasClass($class)) { $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag @mixin contains unknown class %s.', $class))->identifier('class.notFound')->discoveringSymbolsTip()->build(); } elseif ($this->reflectionProvider->getClass($class)->isTrait()) { $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag @mixin contains invalid type %s.', $class))->identifier('mixin.trait')->build(); } else { $errors = array_merge($errors, $this->classCheck->checkClassNames([new ClassNameNodePair($class, $node)], $this->checkClassCaseSensitivity)); } } } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Classes; use PhpParser\Node; use PhpParser\Node\Expr\ClassConstFetch; use PHPStan\Analyser\NullsafeOperatorHelper; use PHPStan\Analyser\Scope; use PHPStan\Internal\SprintfHelper; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\ClassNameCheck; use PHPStan\Rules\ClassNameNodePair; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Rules\RuleLevelHelper; use PHPStan\Type\ErrorType; use PHPStan\Type\StringType; use PHPStan\Type\ThisType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\VerbosityLevel; use function array_merge; use function in_array; use function sprintf; use function strtolower; /** * @implements Rule<Node\Expr\ClassConstFetch> */ final class ClassConstantRule implements Rule { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var RuleLevelHelper */ private $ruleLevelHelper; /** * @var ClassNameCheck */ private $classCheck; /** * @var PhpVersion */ private $phpVersion; public function __construct(ReflectionProvider $reflectionProvider, RuleLevelHelper $ruleLevelHelper, ClassNameCheck $classCheck, PhpVersion $phpVersion) { $this->reflectionProvider = $reflectionProvider; $this->ruleLevelHelper = $ruleLevelHelper; $this->classCheck = $classCheck; $this->phpVersion = $phpVersion; } public function getNodeType() : string { return ClassConstFetch::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->name instanceof Node\Identifier) { return []; } $constantName = $node->name->name; $class = $node->class; $messages = []; if ($class instanceof Node\Name) { $className = (string) $class; $lowercasedClassName = strtolower($className); if (in_array($lowercasedClassName, ['self', 'static'], \true)) { if (!$scope->isInClass()) { return [RuleErrorBuilder::message(sprintf('Using %s outside of class scope.', $className))->identifier(sprintf('outOfClass.%s', $lowercasedClassName))->build()]; } $classType = $scope->resolveTypeByName($class); } elseif ($lowercasedClassName === 'parent') { if (!$scope->isInClass()) { return [RuleErrorBuilder::message(sprintf('Using %s outside of class scope.', $className))->identifier(sprintf('outOfClass.%s', $lowercasedClassName))->build()]; } $currentClassReflection = $scope->getClassReflection(); if ($currentClassReflection->getParentClass() === null) { return [RuleErrorBuilder::message(sprintf('Access to parent::%s but %s does not extend any class.', $constantName, $currentClassReflection->getDisplayName()))->identifier('class.noParent')->build()]; } $classType = $scope->resolveTypeByName($class); } else { if (!$this->reflectionProvider->hasClass($className)) { if ($scope->isInClassExists($className)) { return []; } if (strtolower($constantName) === 'class') { return [RuleErrorBuilder::message(sprintf('Class %s not found.', $className))->identifier('class.notFound')->discoveringSymbolsTip()->build()]; } return [RuleErrorBuilder::message(sprintf('Access to constant %s on an unknown class %s.', $constantName, $className))->identifier('class.notFound')->discoveringSymbolsTip()->build()]; } $messages = $this->classCheck->checkClassNames([new ClassNameNodePair($className, $class)]); $classType = $scope->resolveTypeByName($class); } if (strtolower($constantName) === 'class') { return $messages; } } else { $classTypeResult = $this->ruleLevelHelper->findTypeToCheck($scope, NullsafeOperatorHelper::getNullsafeShortcircuitedExprRespectingScope($scope, $class), sprintf('Access to constant %s on an unknown class %%s.', SprintfHelper::escapeFormatString($constantName)), static function (Type $type) use($constantName) : bool { return $type->canAccessConstants()->yes() && $type->hasConstant($constantName)->yes(); }); $classType = $classTypeResult->getType(); if ($classType instanceof ErrorType) { return $classTypeResult->getUnknownClassErrors(); } if (strtolower($constantName) === 'class') { if (!$this->phpVersion->supportsClassConstantOnExpression()) { return [RuleErrorBuilder::message('Accessing ::class constant on an expression is supported only on PHP 8.0 and later.')->identifier('classConstant.notSupported')->nonIgnorable()->build()]; } if (!$class instanceof Node\Scalar\String_ && $classType->isString()->yes()) { return [RuleErrorBuilder::message('Accessing ::class constant on a dynamic string is not supported in PHP.')->identifier('classConstant.dynamicString')->nonIgnorable()->build()]; } } } if ($classType->isString()->yes()) { return $messages; } $typeForDescribe = $classType; if ($classType instanceof ThisType) { $typeForDescribe = $classType->getStaticObjectType(); } $classType = TypeCombinator::remove($classType, new StringType()); if (!$classType->canAccessConstants()->yes()) { return array_merge($messages, [RuleErrorBuilder::message(sprintf('Cannot access constant %s on %s.', $constantName, $typeForDescribe->describe(VerbosityLevel::typeOnly())))->identifier('classConstant.nonObject')->build()]); } if (strtolower($constantName) === 'class' || $scope->hasExpressionType($node)->yes()) { return $messages; } if (!$classType->hasConstant($constantName)->yes()) { return array_merge($messages, [RuleErrorBuilder::message(sprintf('Access to undefined constant %s::%s.', $typeForDescribe->describe(VerbosityLevel::typeOnly()), $constantName))->identifier('classConstant.notFound')->build()]); } $constantReflection = $classType->getConstant($constantName); if (!$scope->canAccessConstant($constantReflection)) { return array_merge($messages, [RuleErrorBuilder::message(sprintf('Access to %s constant %s of class %s.', $constantReflection->isPrivate() ? 'private' : 'protected', $constantName, $constantReflection->getDeclaringClass()->getDisplayName()))->identifier(sprintf('classConstant.%s', $constantReflection->isPrivate() ? 'private' : 'protected'))->build()]); } return $messages; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Classes; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Parser\LastConditionVisitor; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\ObjectType; use PHPStan\Type\ObjectWithoutClassType; use PHPStan\Type\StringType; use PHPStan\Type\TypeCombinator; use PHPStan\Type\VerbosityLevel; use function sprintf; /** * @implements Rule<Node\Expr\Instanceof_> */ final class ImpossibleInstanceOfRule implements Rule { /** * @var bool */ private $checkAlwaysTrueInstanceof; /** * @var bool */ private $treatPhpDocTypesAsCertain; /** * @var bool */ private $reportAlwaysTrueInLastCondition; /** * @var bool */ private $treatPhpDocTypesAsCertainTip; public function __construct(bool $checkAlwaysTrueInstanceof, bool $treatPhpDocTypesAsCertain, bool $reportAlwaysTrueInLastCondition, bool $treatPhpDocTypesAsCertainTip) { $this->checkAlwaysTrueInstanceof = $checkAlwaysTrueInstanceof; $this->treatPhpDocTypesAsCertain = $treatPhpDocTypesAsCertain; $this->reportAlwaysTrueInLastCondition = $reportAlwaysTrueInLastCondition; $this->treatPhpDocTypesAsCertainTip = $treatPhpDocTypesAsCertainTip; } public function getNodeType() : string { return Node\Expr\Instanceof_::class; } public function processNode(Node $node, Scope $scope) : array { $instanceofType = $this->treatPhpDocTypesAsCertain ? $scope->getType($node) : $scope->getNativeType($node); if (!$instanceofType instanceof ConstantBooleanType) { return []; } if ($node->class instanceof Node\Name) { $className = $scope->resolveName($node->class); $classType = new ObjectType($className); } else { $classType = $this->treatPhpDocTypesAsCertain ? $scope->getType($node->class) : $scope->getNativeType($node->class); $allowed = TypeCombinator::union(new StringType(), new ObjectWithoutClassType()); if (!$allowed->isSuperTypeOf($classType)->yes()) { return [RuleErrorBuilder::message(sprintf('Instanceof between %s and %s results in an error.', $scope->getType($node->expr)->describe(VerbosityLevel::typeOnly()), $classType->describe(VerbosityLevel::typeOnly())))->identifier('instanceof.invalidExprType')->build()]; } } $addTip = function (RuleErrorBuilder $ruleErrorBuilder) use($scope, $node) : RuleErrorBuilder { if (!$this->treatPhpDocTypesAsCertain) { return $ruleErrorBuilder; } $instanceofTypeWithoutPhpDocs = $scope->getNativeType($node); if ($instanceofTypeWithoutPhpDocs instanceof ConstantBooleanType) { return $ruleErrorBuilder; } if (!$this->treatPhpDocTypesAsCertainTip) { return $ruleErrorBuilder; } return $ruleErrorBuilder->treatPhpDocTypesAsCertainTip(); }; if (!$instanceofType->getValue()) { $exprType = $this->treatPhpDocTypesAsCertain ? $scope->getType($node->expr) : $scope->getNativeType($node->expr); return [$addTip(RuleErrorBuilder::message(sprintf('Instanceof between %s and %s will always evaluate to false.', $exprType->describe(VerbosityLevel::typeOnly()), $classType->describe(VerbosityLevel::getRecommendedLevelByType($classType)))))->identifier('instanceof.alwaysFalse')->build()]; } elseif ($this->checkAlwaysTrueInstanceof) { $isLast = $node->getAttribute(LastConditionVisitor::ATTRIBUTE_NAME); if ($isLast === \true && !$this->reportAlwaysTrueInLastCondition) { return []; } $exprType = $this->treatPhpDocTypesAsCertain ? $scope->getType($node->expr) : $scope->getNativeType($node->expr); $errorBuilder = $addTip(RuleErrorBuilder::message(sprintf('Instanceof between %s and %s will always evaluate to true.', $exprType->describe(VerbosityLevel::typeOnly()), $classType->describe(VerbosityLevel::getRecommendedLevelByType($classType))))); if ($isLast === \false && !$this->reportAlwaysTrueInLastCondition) { $errorBuilder->tip('Remove remaining cases below this one and this error will disappear too.'); } $errorBuilder->identifier('instanceof.alwaysTrue'); return [$errorBuilder->build()]; } return []; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Classes; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\InTraitNode; use PHPStan\Rules\Rule; /** * @implements Rule<InTraitNode> */ final class MixinTraitUseRule implements Rule { /** * @var MixinCheck */ private $check; public function __construct(\PHPStan\Rules\Classes\MixinCheck $check) { $this->check = $check; } public function getNodeType() : string { return InTraitNode::class; } public function processNode(Node $node, Scope $scope) : array { return $this->check->checkInTraitUseContext($node->getTraitReflection(), $node->getImplementingClassReflection(), $node->getOriginalNode()); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Classes; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\Rule; /** * @implements Rule<Node\Stmt\Trait_> */ final class LocalTypeTraitAliasesRule implements Rule { /** * @var LocalTypeAliasesCheck */ private $check; /** * @var ReflectionProvider */ private $reflectionProvider; public function __construct(\PHPStan\Rules\Classes\LocalTypeAliasesCheck $check, ReflectionProvider $reflectionProvider) { $this->check = $check; $this->reflectionProvider = $reflectionProvider; } public function getNodeType() : string { return Node\Stmt\Trait_::class; } public function processNode(Node $node, Scope $scope) : array { $traitName = $node->namespacedName; if ($traitName === null) { return []; } if (!$this->reflectionProvider->hasClass($traitName->toString())) { return []; } return $this->check->checkInTraitDefinitionContext($this->reflectionProvider->getClass($traitName->toString())); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Classes; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\InClassNode; use PHPStan\Rules\Rule; /** * @implements Rule<InClassNode> */ final class PropertyTagRule implements Rule { /** * @var PropertyTagCheck */ private $check; public function __construct(\PHPStan\Rules\Classes\PropertyTagCheck $check) { $this->check = $check; } public function getNodeType() : string { return InClassNode::class; } public function processNode(Node $node, Scope $scope) : array { return $this->check->check($node->getClassReflection(), $node->getOriginalNode()); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Classes; use PhpParser\Node\Stmt\ClassLike; use PHPStan\Analyser\NameScope; use PHPStan\Internal\SprintfHelper; use PHPStan\PhpDoc\TypeNodeResolver; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\ClassNameCheck; use PHPStan\Rules\ClassNameNodePair; use PHPStan\Rules\Generics\GenericObjectTypeCheck; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\MissingTypehintCheck; use PHPStan\Rules\PhpDoc\UnresolvableTypeHelper; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\CircularTypeAliasErrorType; use PHPStan\Type\ErrorType; use PHPStan\Type\Generic\TemplateType; use PHPStan\Type\Type; use PHPStan\Type\TypeTraverser; use PHPStan\Type\VerbosityLevel; use function array_key_exists; use function array_merge; use function in_array; use function sprintf; final class LocalTypeAliasesCheck { /** * @var array<string, string> */ private $globalTypeAliases; /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var TypeNodeResolver */ private $typeNodeResolver; /** * @var MissingTypehintCheck */ private $missingTypehintCheck; /** * @var ClassNameCheck */ private $classCheck; /** * @var UnresolvableTypeHelper */ private $unresolvableTypeHelper; /** * @var GenericObjectTypeCheck */ private $genericObjectTypeCheck; /** * @var bool */ private $checkMissingTypehints; /** * @var bool */ private $checkClassCaseSensitivity; /** * @var bool */ private $absentTypeChecks; /** * @param array<string, string> $globalTypeAliases */ public function __construct(array $globalTypeAliases, ReflectionProvider $reflectionProvider, TypeNodeResolver $typeNodeResolver, MissingTypehintCheck $missingTypehintCheck, ClassNameCheck $classCheck, UnresolvableTypeHelper $unresolvableTypeHelper, GenericObjectTypeCheck $genericObjectTypeCheck, bool $checkMissingTypehints, bool $checkClassCaseSensitivity, bool $absentTypeChecks) { $this->globalTypeAliases = $globalTypeAliases; $this->reflectionProvider = $reflectionProvider; $this->typeNodeResolver = $typeNodeResolver; $this->missingTypehintCheck = $missingTypehintCheck; $this->classCheck = $classCheck; $this->unresolvableTypeHelper = $unresolvableTypeHelper; $this->genericObjectTypeCheck = $genericObjectTypeCheck; $this->checkMissingTypehints = $checkMissingTypehints; $this->checkClassCaseSensitivity = $checkClassCaseSensitivity; $this->absentTypeChecks = $absentTypeChecks; } /** * @return list<IdentifierRuleError> */ public function check(ClassReflection $reflection, ClassLike $node) : array { $errors = []; foreach ($this->checkInTraitDefinitionContext($reflection) as $error) { $errors[] = $error; } foreach ($this->checkInTraitUseContext($reflection, $reflection, $node) as $error) { $errors[] = $error; } return $errors; } /** * @return list<IdentifierRuleError> */ public function checkInTraitDefinitionContext(ClassReflection $reflection) : array { $phpDoc = $reflection->getResolvedPhpDoc(); if ($phpDoc === null) { return []; } $nameScope = $phpDoc->getNullableNameScope(); $resolveName = static function (string $name) use($nameScope) : string { if ($nameScope === null) { return $name; } return $nameScope->resolveStringName($name); }; $errors = []; $className = $reflection->getDisplayName(); $importedAliases = []; foreach ($phpDoc->getTypeAliasImportTags() as $typeAliasImportTag) { $aliasName = $typeAliasImportTag->getImportedAs() ?? $typeAliasImportTag->getImportedAlias(); $importedAlias = $typeAliasImportTag->getImportedAlias(); $importedFromClassName = $typeAliasImportTag->getImportedFrom(); if (!$this->reflectionProvider->hasClass($importedFromClassName)) { $errors[] = RuleErrorBuilder::message(sprintf('Cannot import type alias %s: class %s does not exist.', $importedAlias, $importedFromClassName))->identifier('class.notFound')->build(); continue; } $importedFromReflection = $this->reflectionProvider->getClass($importedFromClassName); $typeAliases = $importedFromReflection->getTypeAliases(); if (!array_key_exists($importedAlias, $typeAliases)) { $errors[] = RuleErrorBuilder::message(sprintf('Cannot import type alias %s: type alias does not exist in %s.', $importedAlias, $importedFromClassName))->identifier('typeAlias.notFound')->build(); continue; } $resolvedName = $resolveName($aliasName); if ($this->reflectionProvider->hasClass($resolveName($aliasName))) { $classReflection = $this->reflectionProvider->getClass($resolvedName); $classLikeDescription = 'a class'; if ($classReflection->isInterface()) { $classLikeDescription = 'an interface'; } elseif ($classReflection->isTrait()) { $classLikeDescription = 'a trait'; } elseif ($classReflection->isEnum()) { $classLikeDescription = 'an enum'; } $errors[] = RuleErrorBuilder::message(sprintf('Type alias %s already exists as %s in scope of %s.', $aliasName, $classLikeDescription, $className))->identifier('typeAlias.duplicate')->build(); continue; } if (array_key_exists($aliasName, $this->globalTypeAliases)) { $errors[] = RuleErrorBuilder::message(sprintf('Type alias %s already exists as a global type alias.', $aliasName))->identifier('typeAlias.duplicate')->build(); continue; } $importedAs = $typeAliasImportTag->getImportedAs(); if ($importedAs !== null && !$this->isAliasNameValid($importedAs, $nameScope)) { $errors[] = RuleErrorBuilder::message(sprintf('Imported type alias %s has an invalid name: %s.', $importedAlias, $importedAs))->identifier('typeAlias.invalidName')->build(); continue; } $importedAliases[] = $aliasName; } foreach ($phpDoc->getTypeAliasTags() as $typeAliasTag) { $aliasName = $typeAliasTag->getAliasName(); if (in_array($aliasName, $importedAliases, \true)) { $errors[] = RuleErrorBuilder::message(sprintf('Type alias %s overwrites an imported type alias of the same name.', $aliasName))->identifier('typeAlias.duplicate')->build(); continue; } $resolvedName = $resolveName($aliasName); if ($this->reflectionProvider->hasClass($resolvedName)) { $classReflection = $this->reflectionProvider->getClass($resolvedName); $classLikeDescription = 'a class'; if ($classReflection->isInterface()) { $classLikeDescription = 'an interface'; } elseif ($classReflection->isTrait()) { $classLikeDescription = 'a trait'; } elseif ($classReflection->isEnum()) { $classLikeDescription = 'an enum'; } $errors[] = RuleErrorBuilder::message(sprintf('Type alias %s already exists as %s in scope of %s.', $aliasName, $classLikeDescription, $className))->identifier('typeAlias.duplicate')->build(); continue; } if (array_key_exists($aliasName, $this->globalTypeAliases)) { $errors[] = RuleErrorBuilder::message(sprintf('Type alias %s already exists as a global type alias.', $aliasName))->identifier('typeAlias.duplicate')->build(); continue; } if (!$this->isAliasNameValid($aliasName, $nameScope)) { $errors[] = RuleErrorBuilder::message(sprintf('Type alias has an invalid name: %s.', $aliasName))->identifier('typeAlias.invalidName')->build(); continue; } $resolvedType = $typeAliasTag->getTypeAlias()->resolve($this->typeNodeResolver); if ($this->hasErrorType($resolvedType, $aliasName, $errors)) { continue; } if (!$this->absentTypeChecks) { continue; } if (!$this->checkMissingTypehints) { continue; } foreach ($this->missingTypehintCheck->getIterableTypesWithMissingValueTypehint($resolvedType) as $iterableType) { $iterableTypeDescription = $iterableType->describe(VerbosityLevel::typeOnly()); $errors[] = RuleErrorBuilder::message(sprintf('%s %s has type alias %s with no value type specified in iterable type %s.', $reflection->getClassTypeDescription(), $reflection->getDisplayName(), $aliasName, $iterableTypeDescription))->tip(MissingTypehintCheck::MISSING_ITERABLE_VALUE_TYPE_TIP)->identifier('missingType.iterableValue')->build(); } foreach ($this->missingTypehintCheck->getNonGenericObjectTypesWithGenericClass($resolvedType) as [$name, $genericTypeNames]) { $errors[] = RuleErrorBuilder::message(sprintf('%s %s has type alias %s with generic %s but does not specify its types: %s', $reflection->getClassTypeDescription(), $reflection->getDisplayName(), $aliasName, $name, $genericTypeNames))->identifier('missingType.generics')->build(); } foreach ($this->missingTypehintCheck->getCallablesWithMissingSignature($resolvedType) as $callableType) { $errors[] = RuleErrorBuilder::message(sprintf('%s %s has type alias %s with no signature specified for %s.', $reflection->getClassTypeDescription(), $reflection->getDisplayName(), $aliasName, $callableType->describe(VerbosityLevel::typeOnly())))->identifier('missingType.callable')->build(); } } return $errors; } /** * @return list<IdentifierRuleError> */ public function checkInTraitUseContext(ClassReflection $reflection, ClassReflection $implementingClassReflection, ClassLike $node) : array { if ($reflection->getNativeReflection()->getName() === $implementingClassReflection->getName()) { $phpDoc = $reflection->getResolvedPhpDoc(); } else { $phpDoc = $reflection->getTraitContextResolvedPhpDoc($implementingClassReflection); } if ($phpDoc === null) { return []; } $errors = []; foreach ($phpDoc->getTypeAliasTags() as $typeAliasTag) { $aliasName = $typeAliasTag->getAliasName(); $resolvedType = $typeAliasTag->getTypeAlias()->resolve($this->typeNodeResolver); $throwawayErrors = []; if ($this->hasErrorType($resolvedType, $aliasName, $throwawayErrors)) { continue; } foreach ($resolvedType->getReferencedClasses() as $class) { if (!$this->reflectionProvider->hasClass($class)) { $errors[] = RuleErrorBuilder::message(sprintf('Type alias %s contains unknown class %s.', $aliasName, $class))->identifier('class.notFound')->discoveringSymbolsTip()->build(); } elseif ($this->reflectionProvider->getClass($class)->isTrait()) { $errors[] = RuleErrorBuilder::message(sprintf('Type alias %s contains invalid type %s.', $aliasName, $class))->identifier('typeAlias.trait')->build(); } else { $errors = array_merge($errors, $this->classCheck->checkClassNames([new ClassNameNodePair($class, $node)], $this->checkClassCaseSensitivity)); } } if ($this->unresolvableTypeHelper->containsUnresolvableType($resolvedType)) { $errors[] = RuleErrorBuilder::message(sprintf('Type alias %s contains unresolvable type.', $aliasName))->identifier('typeAlias.unresolvableType')->build(); } $escapedTypeAlias = SprintfHelper::escapeFormatString($aliasName); $errors = array_merge($errors, $this->genericObjectTypeCheck->check($resolvedType, sprintf('Type alias %s contains generic type %%s but %%s %%s is not generic.', $escapedTypeAlias), sprintf('Generic type %%s in type alias %s does not specify all template types of %%s %%s: %%s', $escapedTypeAlias), sprintf('Generic type %%s in type alias %s specifies %%d template types, but %%s %%s supports only %%d: %%s', $escapedTypeAlias), sprintf('Type %%s in generic type %%s in type alias %s is not subtype of template type %%s of %%s %%s.', $escapedTypeAlias), sprintf('Call-site variance of %%s in generic type %%s in type alias %s is in conflict with %%s template type %%s of %%s %%s.', $escapedTypeAlias), sprintf('Call-site variance of %%s in generic type %%s in type alias %s is redundant, template type %%s of %%s %%s has the same variance.', $escapedTypeAlias))); } return $errors; } private function isAliasNameValid(string $aliasName, ?NameScope $nameScope) : bool { if ($nameScope === null) { return \true; } $aliasNameResolvedType = $this->typeNodeResolver->resolve(new IdentifierTypeNode($aliasName), $nameScope->bypassTypeAliases()); return $aliasNameResolvedType->isObject()->yes() && !in_array($aliasName, ['self', 'parent'], \true) || $aliasNameResolvedType instanceof TemplateType; // aliases take precedence over type parameters, this is reported by other rules using TemplateTypeCheck } /** * @param list<IdentifierRuleError> $errors * @param-out list<IdentifierRuleError> $errors */ private function hasErrorType(Type $type, string $aliasName, array &$errors) : bool { $foundError = \false; TypeTraverser::map($type, static function (Type $type, callable $traverse) use(&$errors, &$foundError, $aliasName) : Type { if ($foundError) { return $type; } if ($type instanceof CircularTypeAliasErrorType) { $errors[] = RuleErrorBuilder::message(sprintf('Circular definition detected in type alias %s.', $aliasName))->identifier('typeAlias.circular')->build(); $foundError = \true; return $type; } if ($type instanceof ErrorType) { $errors[] = RuleErrorBuilder::message(sprintf('Invalid type definition detected in type alias %s.', $aliasName))->identifier('typeAlias.invalidType')->build(); $foundError = \true; return $type; } return $traverse($type); }); return $foundError; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Classes; use Attribute; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\InClassNode; use PHPStan\Rules\AttributesCheck; use PHPStan\Rules\Rule; /** * @implements Rule<InClassNode> */ final class ClassAttributesRule implements Rule { /** * @var AttributesCheck */ private $attributesCheck; public function __construct(AttributesCheck $attributesCheck) { $this->attributesCheck = $attributesCheck; } public function getNodeType() : string { return InClassNode::class; } public function processNode(Node $node, Scope $scope) : array { $classLikeNode = $node->getOriginalNode(); return $this->attributesCheck->check($scope, $classLikeNode->attrGroups, Attribute::TARGET_CLASS, 'class'); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Classes; use Attribute; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Rules\AttributesCheck; use PHPStan\Rules\Rule; /** * @implements Rule<Node\Stmt\ClassConst> */ final class ClassConstantAttributesRule implements Rule { /** * @var AttributesCheck */ private $attributesCheck; public function __construct(AttributesCheck $attributesCheck) { $this->attributesCheck = $attributesCheck; } public function getNodeType() : string { return Node\Stmt\ClassConst::class; } public function processNode(Node $node, Scope $scope) : array { return $this->attributesCheck->check($scope, $node->attrGroups, Attribute::TARGET_CLASS_CONSTANT, 'class constant'); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Classes; use PhpParser\Node\Stmt\ClassLike; use PHPStan\Internal\SprintfHelper; use PHPStan\PhpDoc\Tag\PropertyTag; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\ClassNameCheck; use PHPStan\Rules\ClassNameNodePair; use PHPStan\Rules\Generics\GenericObjectTypeCheck; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\MissingTypehintCheck; use PHPStan\Rules\PhpDoc\UnresolvableTypeHelper; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\ShouldNotHappenException; use PHPStan\Type\Type; use PHPStan\Type\VerbosityLevel; use function array_merge; use function sprintf; final class PropertyTagCheck { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var ClassNameCheck */ private $classCheck; /** * @var GenericObjectTypeCheck */ private $genericObjectTypeCheck; /** * @var MissingTypehintCheck */ private $missingTypehintCheck; /** * @var UnresolvableTypeHelper */ private $unresolvableTypeHelper; /** * @var bool */ private $checkClassCaseSensitivity; /** * @var bool */ private $checkMissingTypehints; public function __construct(ReflectionProvider $reflectionProvider, ClassNameCheck $classCheck, GenericObjectTypeCheck $genericObjectTypeCheck, MissingTypehintCheck $missingTypehintCheck, UnresolvableTypeHelper $unresolvableTypeHelper, bool $checkClassCaseSensitivity, bool $checkMissingTypehints) { $this->reflectionProvider = $reflectionProvider; $this->classCheck = $classCheck; $this->genericObjectTypeCheck = $genericObjectTypeCheck; $this->missingTypehintCheck = $missingTypehintCheck; $this->unresolvableTypeHelper = $unresolvableTypeHelper; $this->checkClassCaseSensitivity = $checkClassCaseSensitivity; $this->checkMissingTypehints = $checkMissingTypehints; } /** * @return list<IdentifierRuleError> */ public function check(ClassReflection $classReflection, ClassLike $node) : array { $errors = []; foreach ($classReflection->getPropertyTags() as $propertyName => $propertyTag) { [$types, $tagName] = $this->getTypesAndTagName($propertyTag); foreach ($types as $type) { foreach ($this->checkPropertyTypeInTraitDefinitionContext($classReflection, $propertyName, $tagName, $type) as $error) { $errors[] = $error; } foreach ($this->checkPropertyTypeInTraitUseContext($classReflection, $propertyName, $tagName, $type, $node) as $error) { $errors[] = $error; } } } return $errors; } /** * @return list<IdentifierRuleError> */ public function checkInTraitDefinitionContext(ClassReflection $classReflection) : array { $errors = []; foreach ($classReflection->getPropertyTags() as $propertyName => $propertyTag) { [$types, $tagName] = $this->getTypesAndTagName($propertyTag); foreach ($types as $type) { foreach ($this->checkPropertyTypeInTraitDefinitionContext($classReflection, $propertyName, $tagName, $type) as $error) { $errors[] = $error; } } } return $errors; } /** * @return list<IdentifierRuleError> */ public function checkInTraitUseContext(ClassReflection $classReflection, ClassReflection $implementingClass, ClassLike $node) : array { $phpDoc = $classReflection->getTraitContextResolvedPhpDoc($implementingClass); if ($phpDoc === null) { return []; } $errors = []; foreach ($phpDoc->getPropertyTags() as $propertyName => $propertyTag) { [$types, $tagName] = $this->getTypesAndTagName($propertyTag); foreach ($types as $type) { foreach ($this->checkPropertyTypeInTraitUseContext($classReflection, $propertyName, $tagName, $type, $node) as $error) { $errors[] = $error; } } } return $errors; } /** * @return array{list<Type>, string} */ private function getTypesAndTagName(PropertyTag $propertyTag) : array { $readableType = $propertyTag->getReadableType(); $writableType = $propertyTag->getWritableType(); $types = []; $tagName = '@property'; if ($readableType !== null) { if ($writableType !== null) { if ($writableType->equals($readableType)) { $types[] = $readableType; } else { $types[] = $readableType; $types[] = $writableType; } } else { $tagName = '@property-read'; $types[] = $readableType; } } elseif ($writableType !== null) { $tagName = '@property-write'; $types[] = $writableType; } else { throw new ShouldNotHappenException(); } return [$types, $tagName]; } /** * @return list<IdentifierRuleError> */ private function checkPropertyTypeInTraitDefinitionContext(ClassReflection $classReflection, string $propertyName, string $tagName, Type $type) : array { if (!$this->checkMissingTypehints) { return []; } $errors = []; foreach ($this->missingTypehintCheck->getNonGenericObjectTypesWithGenericClass($type) as [$innerName, $genericTypeNames]) { $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag %s for property %s::$%s contains generic %s but does not specify its types: %s', $tagName, $classReflection->getDisplayName(), $propertyName, $innerName, $genericTypeNames))->identifier('missingType.generics')->build(); } foreach ($this->missingTypehintCheck->getIterableTypesWithMissingValueTypehint($type) as $iterableType) { $iterableTypeDescription = $iterableType->describe(VerbosityLevel::typeOnly()); $errors[] = RuleErrorBuilder::message(sprintf('%s %s has PHPDoc tag %s for property $%s with no value type specified in iterable type %s.', $classReflection->getClassTypeDescription(), $classReflection->getDisplayName(), $tagName, $propertyName, $iterableTypeDescription))->tip(MissingTypehintCheck::MISSING_ITERABLE_VALUE_TYPE_TIP)->identifier('missingType.iterableValue')->build(); } foreach ($this->missingTypehintCheck->getCallablesWithMissingSignature($type) as $callableType) { $errors[] = RuleErrorBuilder::message(sprintf('%s %s has PHPDoc tag %s for property $%s with no signature specified for %s.', $classReflection->getClassTypeDescription(), $classReflection->getDisplayName(), $tagName, $propertyName, $callableType->describe(VerbosityLevel::typeOnly())))->identifier('missingType.callable')->build(); } return $errors; } /** * @return list<IdentifierRuleError> */ private function checkPropertyTypeInTraitUseContext(ClassReflection $classReflection, string $propertyName, string $tagName, Type $type, ClassLike $node) : array { $errors = []; foreach ($type->getReferencedClasses() as $class) { if (!$this->reflectionProvider->hasClass($class)) { $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag %s for property %s::$%s contains unknown class %s.', $tagName, $classReflection->getDisplayName(), $propertyName, $class))->identifier('class.notFound')->discoveringSymbolsTip()->build(); } elseif ($this->reflectionProvider->getClass($class)->isTrait()) { $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag %s for property %s::$%s contains invalid type %s.', $tagName, $classReflection->getDisplayName(), $propertyName, $class))->identifier('propertyTag.trait')->build(); } else { $errors = array_merge($errors, $this->classCheck->checkClassNames([new ClassNameNodePair($class, $node)], $this->checkClassCaseSensitivity)); } } if ($this->unresolvableTypeHelper->containsUnresolvableType($type)) { $errors[] = RuleErrorBuilder::message(sprintf('PHPDoc tag %s for property %s::$%s contains unresolvable type.', $tagName, $classReflection->getDisplayName(), $propertyName))->identifier('propertyTag.unresolvableType')->build(); } $escapedClassName = SprintfHelper::escapeFormatString($classReflection->getDisplayName()); $escapedPropertyName = SprintfHelper::escapeFormatString($propertyName); $escapedTagName = SprintfHelper::escapeFormatString($tagName); return array_merge($errors, $this->genericObjectTypeCheck->check($type, sprintf('PHPDoc tag %s for property %s::$%s contains generic type %%s but %%s %%s is not generic.', $escapedTagName, $escapedClassName, $escapedPropertyName), sprintf('Generic type %%s in PHPDoc tag %s for property %s::$%s does not specify all template types of %%s %%s: %%s', $escapedTagName, $escapedClassName, $escapedPropertyName), sprintf('Generic type %%s in PHPDoc tag %s for property %s::$%s specifies %%d template types, but %%s %%s supports only %%d: %%s', $escapedTagName, $escapedClassName, $escapedPropertyName), sprintf('Type %%s in generic type %%s in PHPDoc tag %s for property %s::$%s is not subtype of template type %%s of %%s %%s.', $escapedTagName, $escapedClassName, $escapedPropertyName), sprintf('Call-site variance of %%s in generic type %%s in PHPDoc tag %s for property %s::$%s is in conflict with %%s template type %%s of %%s %%s.', $escapedTagName, $escapedClassName, $escapedPropertyName), sprintf('Call-site variance of %%s in generic type %%s in PHPDoc tag %s for property %s::$%s is redundant, template type %%s of %%s %%s has the same variance.', $escapedTagName, $escapedClassName, $escapedPropertyName))); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Classes; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Reflection\Php\PhpMethodReflection; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function strtolower; /** * @implements Rule<Node\Expr\New_> */ final class NewStaticRule implements Rule { public function getNodeType() : string { return Node\Expr\New_::class; } public function processNode(Node $node, Scope $scope) : array { if (!$node->class instanceof Node\Name) { return []; } if (!$scope->isInClass()) { return []; } if (strtolower($node->class->toString()) !== 'static') { return []; } $classReflection = $scope->getClassReflection(); if ($classReflection->isFinal()) { return []; } $messages = [RuleErrorBuilder::message('Unsafe usage of new static().')->identifier('new.static')->tip('See: https://phpstan.org/blog/solving-phpstan-error-unsafe-usage-of-new-static')->build()]; if (!$classReflection->hasConstructor()) { return $messages; } $constructor = $classReflection->getConstructor(); if ($constructor->getPrototype()->getDeclaringClass()->isInterface()) { return []; } if ($constructor->getDeclaringClass()->hasConsistentConstructor()) { return []; } foreach ($classReflection->getImmediateInterfaces() as $interface) { if ($interface->hasConstructor()) { return []; } } if ($constructor instanceof PhpMethodReflection) { if ($constructor->isFinal()->yes()) { return []; } $prototype = $constructor->getPrototype(); if ($prototype->isAbstract()) { return []; } } return $messages; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Classes; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\ClassNameCheck; use PHPStan\Rules\ClassNameNodePair; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function sprintf; /** * @implements Rule<Node\Stmt\Class_> */ final class ExistingClassInClassExtendsRule implements Rule { /** * @var ClassNameCheck */ private $classCheck; /** * @var ReflectionProvider */ private $reflectionProvider; public function __construct(ClassNameCheck $classCheck, ReflectionProvider $reflectionProvider) { $this->classCheck = $classCheck; $this->reflectionProvider = $reflectionProvider; } public function getNodeType() : string { return Node\Stmt\Class_::class; } public function processNode(Node $node, Scope $scope) : array { if ($node->extends === null) { return []; } $extendedClassName = (string) $node->extends; $messages = $this->classCheck->checkClassNames([new ClassNameNodePair($extendedClassName, $node->extends)]); $currentClassName = null; if (isset($node->namespacedName)) { $currentClassName = (string) $node->namespacedName; } if (!$this->reflectionProvider->hasClass($extendedClassName)) { if (!$scope->isInClassExists($extendedClassName)) { $messages[] = RuleErrorBuilder::message(sprintf('%s extends unknown class %s.', $currentClassName !== null ? sprintf('Class %s', $currentClassName) : 'Anonymous class', $extendedClassName))->identifier('class.notFound')->nonIgnorable()->discoveringSymbolsTip()->build(); } } else { $reflection = $this->reflectionProvider->getClass($extendedClassName); if ($reflection->isInterface()) { $messages[] = RuleErrorBuilder::message(sprintf('%s extends interface %s.', $currentClassName !== null ? sprintf('Class %s', $currentClassName) : 'Anonymous class', $reflection->getDisplayName()))->identifier('class.extendsInterface')->nonIgnorable()->build(); } elseif ($reflection->isTrait()) { $messages[] = RuleErrorBuilder::message(sprintf('%s extends trait %s.', $currentClassName !== null ? sprintf('Class %s', $currentClassName) : 'Anonymous class', $reflection->getDisplayName()))->identifier('class.extendsTrait')->nonIgnorable()->build(); } elseif ($reflection->isEnum()) { $messages[] = RuleErrorBuilder::message(sprintf('%s extends enum %s.', $currentClassName !== null ? sprintf('Class %s', $currentClassName) : 'Anonymous class', $reflection->getDisplayName()))->identifier('class.extendsEnum')->nonIgnorable()->build(); } elseif ($reflection->isFinalByKeyword()) { $messages[] = RuleErrorBuilder::message(sprintf('%s extends final class %s.', $currentClassName !== null ? sprintf('Class %s', $currentClassName) : 'Anonymous class', $reflection->getDisplayName()))->identifier('class.extendsFinal')->nonIgnorable()->build(); } elseif ($reflection->isFinal()) { $messages[] = RuleErrorBuilder::message(sprintf('%s extends @final class %s.', $currentClassName !== null ? sprintf('Class %s', $currentClassName) : 'Anonymous class', $reflection->getDisplayName()))->identifier('class.extendsFinalByPhpDoc')->build(); } if ($reflection->isClass()) { if ($node->isReadonly()) { if (!$reflection->isReadOnly()) { $messages[] = RuleErrorBuilder::message(sprintf('%s extends non-readonly class %s.', $currentClassName !== null ? sprintf('Readonly class %s', $currentClassName) : 'Anonymous readonly class', $reflection->getDisplayName()))->identifier('class.readOnly')->nonIgnorable()->build(); } } elseif ($reflection->isReadOnly()) { $messages[] = RuleErrorBuilder::message(sprintf('%s extends readonly class %s.', $currentClassName !== null ? sprintf('Non-readonly class %s', $currentClassName) : 'Anonymous non-readonly class', $reflection->getDisplayName()))->identifier('class.nonReadOnly')->nonIgnorable()->build(); } } } return $messages; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Classes; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\BetterReflection\Reflection\ReflectionClass; use PHPStan\BetterReflection\Reflector\Reflector; use PHPStan\File\RelativePathHelper; use PHPStan\Node\InClassNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function array_filter; use function array_map; use function count; use function implode; use function sprintf; use function strtolower; /** * @implements Rule<InClassNode> */ final class DuplicateClassDeclarationRule implements Rule { /** * @var Reflector */ private $reflector; /** * @var RelativePathHelper */ private $relativePathHelper; public function __construct(Reflector $reflector, RelativePathHelper $relativePathHelper) { $this->reflector = $reflector; $this->relativePathHelper = $relativePathHelper; } public function getNodeType() : string { return InClassNode::class; } public function processNode(Node $node, Scope $scope) : array { $thisClass = $node->getClassReflection(); $className = $thisClass->getName(); $allClasses = $this->reflector->reflectAllClasses(); $filteredClasses = []; foreach ($allClasses as $reflectionClass) { if ($reflectionClass->getName() !== $className) { continue; } $filteredClasses[] = $reflectionClass; } if (count($filteredClasses) < 2) { return []; } $filteredClasses = array_filter($filteredClasses, static function (ReflectionClass $class) use($thisClass) { return $class->getStartLine() !== $thisClass->getNativeReflection()->getStartLine(); }); $identifierType = strtolower($thisClass->getClassTypeDescription()); return [RuleErrorBuilder::message(sprintf("Class %s declared multiple times:\n%s", $thisClass->getDisplayName(), implode("\n", array_map(function (ReflectionClass $class) { return sprintf('- %s:%d', $this->relativePathHelper->getRelativePath($class->getFileName() ?? 'unknown'), $class->getStartLine()); }, $filteredClasses))))->identifier(sprintf('%s.duplicate', $identifierType))->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Classes; use PhpParser\Node; use PhpParser\Node\Expr\New_; use PHPStan\Analyser\Scope; use PHPStan\Internal\SprintfHelper; use PHPStan\Reflection\ParametersAcceptorSelector; use PHPStan\Reflection\Php\PhpMethodReflection; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\ClassNameCheck; use PHPStan\Rules\ClassNameNodePair; use PHPStan\Rules\FunctionCallParametersCheck; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\ShouldNotHappenException; use PHPStan\Type\Constant\ConstantStringType; use function array_map; use function array_merge; use function count; use function sprintf; use function strtolower; /** * @implements Rule<Node\Expr\New_> */ final class InstantiationRule implements Rule { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var FunctionCallParametersCheck */ private $check; /** * @var ClassNameCheck */ private $classCheck; public function __construct(ReflectionProvider $reflectionProvider, FunctionCallParametersCheck $check, ClassNameCheck $classCheck) { $this->reflectionProvider = $reflectionProvider; $this->check = $check; $this->classCheck = $classCheck; } public function getNodeType() : string { return New_::class; } public function processNode(Node $node, Scope $scope) : array { $errors = []; foreach ($this->getClassNames($node, $scope) as [$class, $isName]) { $errors = array_merge($errors, $this->checkClassName($class, $isName, $node, $scope)); } return $errors; } /** * @param Node\Expr\New_ $node * @return list<IdentifierRuleError> */ private function checkClassName(string $class, bool $isName, Node $node, Scope $scope) : array { $lowercasedClass = strtolower($class); $messages = []; $isStatic = \false; if ($lowercasedClass === 'static') { if (!$scope->isInClass()) { return [RuleErrorBuilder::message(sprintf('Using %s outside of class scope.', $class))->identifier('outOfClass.static')->build()]; } $isStatic = \true; $classReflection = $scope->getClassReflection(); if (!$classReflection->isFinal()) { if (!$classReflection->hasConstructor()) { return []; } $constructor = $classReflection->getConstructor(); if (!$constructor->getPrototype()->getDeclaringClass()->isInterface() && $constructor instanceof PhpMethodReflection && !$constructor->isFinal()->yes() && !$constructor->getPrototype()->isAbstract()) { return []; } } } elseif ($lowercasedClass === 'self') { if (!$scope->isInClass()) { return [RuleErrorBuilder::message(sprintf('Using %s outside of class scope.', $class))->identifier('outOfClass.self')->build()]; } $classReflection = $scope->getClassReflection(); } elseif ($lowercasedClass === 'parent') { if (!$scope->isInClass()) { return [RuleErrorBuilder::message(sprintf('Using %s outside of class scope.', $class))->identifier('outOfClass.parent')->build()]; } if ($scope->getClassReflection()->getParentClass() === null) { return [RuleErrorBuilder::message(sprintf('%s::%s() calls new parent but %s does not extend any class.', $scope->getClassReflection()->getDisplayName(), $scope->getFunctionName(), $scope->getClassReflection()->getDisplayName()))->identifier('class.noParent')->build()]; } $classReflection = $scope->getClassReflection()->getParentClass(); } else { if (!$this->reflectionProvider->hasClass($class)) { if ($scope->isInClassExists($class)) { return []; } return [RuleErrorBuilder::message(sprintf('Instantiated class %s not found.', $class))->identifier('class.notFound')->discoveringSymbolsTip()->build()]; } $messages = $this->classCheck->checkClassNames([new ClassNameNodePair($class, $node->class)]); $classReflection = $this->reflectionProvider->getClass($class); } if ($classReflection->isEnum() && $isName) { return [RuleErrorBuilder::message(sprintf('Cannot instantiate enum %s.', $classReflection->getDisplayName()))->identifier('new.enum')->build()]; } if (!$isStatic && $classReflection->isInterface() && $isName) { return [RuleErrorBuilder::message(sprintf('Cannot instantiate interface %s.', $classReflection->getDisplayName()))->identifier('new.interface')->build()]; } if (!$isStatic && $classReflection->isAbstract() && $isName) { return [RuleErrorBuilder::message(sprintf('Instantiated class %s is abstract.', $classReflection->getDisplayName()))->identifier('new.abstract')->build()]; } if (!$isName) { return []; } if (!$classReflection->hasConstructor()) { if (count($node->getArgs()) > 0) { return array_merge($messages, [RuleErrorBuilder::message(sprintf('Class %s does not have a constructor and must be instantiated without any parameters.', $classReflection->getDisplayName()))->identifier('new.noConstructor')->build()]); } return $messages; } $constructorReflection = $classReflection->getConstructor(); if (!$scope->canCallMethod($constructorReflection)) { $messages[] = RuleErrorBuilder::message(sprintf('Cannot instantiate class %s via %s constructor %s::%s().', $classReflection->getDisplayName(), $constructorReflection->isPrivate() ? 'private' : 'protected', $constructorReflection->getDeclaringClass()->getDisplayName(), $constructorReflection->getName()))->identifier(sprintf('new.%sConstructor', $constructorReflection->isPrivate() ? 'private' : 'protected'))->build(); } $classDisplayName = SprintfHelper::escapeFormatString($classReflection->getDisplayName()); return array_merge($messages, $this->check->check(ParametersAcceptorSelector::selectFromArgs($scope, $node->getArgs(), $constructorReflection->getVariants(), $constructorReflection->getNamedArgumentsVariants()), $scope, $constructorReflection->getDeclaringClass()->isBuiltin(), $node, [ 'Class ' . $classDisplayName . ' constructor invoked with %d parameter, %d required.', 'Class ' . $classDisplayName . ' constructor invoked with %d parameters, %d required.', 'Class ' . $classDisplayName . ' constructor invoked with %d parameter, at least %d required.', 'Class ' . $classDisplayName . ' constructor invoked with %d parameters, at least %d required.', 'Class ' . $classDisplayName . ' constructor invoked with %d parameter, %d-%d required.', 'Class ' . $classDisplayName . ' constructor invoked with %d parameters, %d-%d required.', 'Parameter %s of class ' . $classDisplayName . ' constructor expects %s, %s given.', '', // constructor does not have a return type 'Parameter %s of class ' . $classDisplayName . ' constructor is passed by reference, so it expects variables only', 'Unable to resolve the template type %s in instantiation of class ' . $classDisplayName, 'Missing parameter $%s in call to ' . $classDisplayName . ' constructor.', 'Unknown parameter $%s in call to ' . $classDisplayName . ' constructor.', 'Return type of call to ' . $classDisplayName . ' constructor contains unresolvable type.', 'Parameter %s of class ' . $classDisplayName . ' constructor contains unresolvable type.', 'Class ' . $classDisplayName . ' constructor invoked with %s, but it\'s not allowed because of @no-named-arguments.', ], 'new', $constructorReflection->acceptsNamedArguments())); } /** * @param Node\Expr\New_ $node * @return array<int, array{string, bool}> */ private function getClassNames(Node $node, Scope $scope) : array { if ($node->class instanceof Node\Name) { return [[(string) $node->class, \true]]; } if ($node->class instanceof Node\Stmt\Class_) { $classNames = $scope->getType($node)->getObjectClassNames(); if ($classNames === []) { throw new ShouldNotHappenException(); } return array_map(static function (string $className) { return [$className, \true]; }, $classNames); } $type = $scope->getType($node->class); return array_merge(array_map(static function (ConstantStringType $type) : array { return [$type->getValue(), \true]; }, $type->getConstantStrings()), array_map(static function (string $name) : array { return [$name, \false]; }, $type->getObjectClassNames())); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Classes; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\InTraitNode; use PHPStan\Rules\Rule; /** * @implements Rule<InTraitNode> */ final class MethodTagTraitUseRule implements Rule { /** * @var MethodTagCheck */ private $check; public function __construct(\PHPStan\Rules\Classes\MethodTagCheck $check) { $this->check = $check; } public function getNodeType() : string { return InTraitNode::class; } public function processNode(Node $node, Scope $scope) : array { return $this->check->checkInTraitUseContext($node->getTraitReflection(), $node->getImplementingClassReflection(), $node->getOriginalNode()); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Classes; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\InClassNode; use PHPStan\Rules\Rule; /** * @implements Rule<InClassNode> */ final class MixinRule implements Rule { /** * @var MixinCheck */ private $check; public function __construct(\PHPStan\Rules\Classes\MixinCheck $check) { $this->check = $check; } public function getNodeType() : string { return InClassNode::class; } public function processNode(Node $node, Scope $scope) : array { return $this->check->check($node->getClassReflection(), $node->getOriginalNode()); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Classes; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\InClassNode; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\Type\IntegerType; use PHPStan\Type\StringType; use PHPStan\Type\VerbosityLevel; use Serializable; use function array_key_exists; use function count; use function implode; use function in_array; use function sprintf; /** * @implements Rule<InClassNode> */ final class EnumSanityRule implements Rule { private const ALLOWED_MAGIC_METHODS = ['__call' => \true, '__callstatic' => \true, '__invoke' => \true]; public function getNodeType() : string { return InClassNode::class; } public function processNode(Node $node, Scope $scope) : array { $classReflection = $node->getClassReflection(); if (!$classReflection->isEnum()) { return []; } /** @var Node\Stmt\Enum_ $enumNode */ $enumNode = $node->getOriginalNode(); $errors = []; foreach ($enumNode->getMethods() as $methodNode) { $lowercasedMethodName = $methodNode->name->toLowerString(); if ($methodNode->isMagic()) { if ($lowercasedMethodName === '__construct') { $errors[] = RuleErrorBuilder::message(sprintf('Enum %s contains constructor.', $classReflection->getDisplayName()))->identifier('enum.constructor')->line($methodNode->getStartLine())->nonIgnorable()->build(); } elseif ($lowercasedMethodName === '__destruct') { $errors[] = RuleErrorBuilder::message(sprintf('Enum %s contains destructor.', $classReflection->getDisplayName()))->identifier('enum.destructor')->line($methodNode->getStartLine())->nonIgnorable()->build(); } elseif (!array_key_exists($lowercasedMethodName, self::ALLOWED_MAGIC_METHODS)) { $errors[] = RuleErrorBuilder::message(sprintf('Enum %s contains magic method %s().', $classReflection->getDisplayName(), $methodNode->name->name))->identifier('enum.magicMethod')->line($methodNode->getStartLine())->nonIgnorable()->build(); } } if ($lowercasedMethodName === 'cases') { $errors[] = RuleErrorBuilder::message(sprintf('Enum %s cannot redeclare native method %s().', $classReflection->getDisplayName(), $methodNode->name->name))->identifier('enum.methodRedeclaration')->line($methodNode->getStartLine())->nonIgnorable()->build(); } if ($enumNode->scalarType === null) { continue; } if (!in_array($lowercasedMethodName, ['from', 'tryfrom'], \true)) { continue; } $errors[] = RuleErrorBuilder::message(sprintf('Enum %s cannot redeclare native method %s().', $classReflection->getDisplayName(), $methodNode->name->name))->identifier('enum.methodRedeclaration')->line($methodNode->getStartLine())->nonIgnorable()->build(); } if ($enumNode->scalarType !== null && !in_array($enumNode->scalarType->name, ['int', 'string'], \true)) { $errors[] = RuleErrorBuilder::message(sprintf('Backed enum %s can have only "int" or "string" type.', $classReflection->getDisplayName()))->identifier('enum.backingType')->line($enumNode->scalarType->getStartLine())->nonIgnorable()->build(); } if ($classReflection->implementsInterface(Serializable::class)) { $errors[] = RuleErrorBuilder::message(sprintf('Enum %s cannot implement the Serializable interface.', $classReflection->getDisplayName()))->identifier('enum.serializable')->line($enumNode->getStartLine())->nonIgnorable()->build(); } $enumCases = []; foreach ($enumNode->stmts as $stmt) { if (!$stmt instanceof Node\Stmt\EnumCase) { continue; } $caseName = $stmt->name->name; if ($stmt->expr instanceof Node\Scalar\LNumber || $stmt->expr instanceof Node\Scalar\String_) { if ($enumNode->scalarType === null) { $errors[] = RuleErrorBuilder::message(sprintf('Enum %s is not backed, but case %s has value %s.', $classReflection->getDisplayName(), $caseName, $stmt->expr->value))->identifier('enum.caseWithValue')->line($stmt->getStartLine())->nonIgnorable()->build(); } else { $caseValue = $stmt->expr->value; if (!isset($enumCases[$caseValue])) { $enumCases[$caseValue] = []; } $enumCases[$caseValue][] = $caseName; } } if ($enumNode->scalarType === null) { continue; } if ($stmt->expr === null) { $errors[] = RuleErrorBuilder::message(sprintf('Enum case %s::%s does not have a value but the enum is backed with the "%s" type.', $classReflection->getDisplayName(), $caseName, $enumNode->scalarType->name))->identifier('enum.missingCase')->line($stmt->getStartLine())->nonIgnorable()->build(); continue; } $exprType = $scope->getType($stmt->expr); $scalarType = $enumNode->scalarType->toLowerString() === 'int' ? new IntegerType() : new StringType(); if ($scalarType->isSuperTypeOf($exprType)->yes()) { continue; } $errors[] = RuleErrorBuilder::message(sprintf('Enum case %s::%s value %s does not match the "%s" type.', $classReflection->getDisplayName(), $caseName, $exprType->describe(VerbosityLevel::value()), $scalarType->describe(VerbosityLevel::typeOnly())))->identifier('enum.caseType')->line($stmt->getStartLine())->nonIgnorable()->build(); } foreach ($enumCases as $caseValue => $caseNames) { if (count($caseNames) <= 1) { continue; } $errors[] = RuleErrorBuilder::message(sprintf('Enum %s has duplicate value %s for cases %s.', $classReflection->getDisplayName(), $caseValue, implode(', ', $caseNames)))->identifier('enum.duplicateValue')->line($enumNode->getStartLine())->nonIgnorable()->build(); } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Classes; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Php\PhpVersion; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\ShouldNotHappenException; use function is_string; use function sprintf; /** * @implements Rule<Node\FunctionLike> */ final class InvalidPromotedPropertiesRule implements Rule { /** * @var PhpVersion */ private $phpVersion; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; } public function getNodeType() : string { return Node\FunctionLike::class; } public function processNode(Node $node, Scope $scope) : array { $hasPromotedProperties = \false; foreach ($node->getParams() as $param) { if ($param->flags === 0) { continue; } $hasPromotedProperties = \true; break; } if (!$hasPromotedProperties) { return []; } if (!$this->phpVersion->supportsPromotedProperties()) { return [RuleErrorBuilder::message('Promoted properties are supported only on PHP 8.0 and later.')->identifier('property.promotedNotSupported')->nonIgnorable()->build()]; } if (!$node instanceof Node\Stmt\ClassMethod || $node->name->toLowerString() !== '__construct' && $node->getAttribute('originalTraitMethodName') !== '__construct') { return [RuleErrorBuilder::message('Promoted properties can be in constructor only.')->identifier('property.invalidPromoted')->nonIgnorable()->build()]; } if ($node->getStmts() === null) { return [RuleErrorBuilder::message('Promoted properties are not allowed in abstract constructors.')->identifier('property.invalidPromoted')->nonIgnorable()->build()]; } $errors = []; foreach ($node->getParams() as $param) { if ($param->flags === 0) { continue; } if (!$param->var instanceof Node\Expr\Variable || !is_string($param->var->name)) { throw new ShouldNotHappenException(); } if (!$param->variadic) { continue; } $propertyName = $param->var->name; $errors[] = RuleErrorBuilder::message(sprintf('Promoted property parameter $%s can not be variadic.', $propertyName))->identifier('property.invalidPromoted')->nonIgnorable()->line($param->getStartLine())->build(); } return $errors; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Classes; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\Rule; /** * @implements Rule<Node\Stmt\Trait_> */ final class PropertyTagTraitRule implements Rule { /** * @var PropertyTagCheck */ private $check; /** * @var ReflectionProvider */ private $reflectionProvider; public function __construct(\PHPStan\Rules\Classes\PropertyTagCheck $check, ReflectionProvider $reflectionProvider) { $this->check = $check; $this->reflectionProvider = $reflectionProvider; } public function getNodeType() : string { return Node\Stmt\Trait_::class; } public function processNode(Node $node, Scope $scope) : array { $traitName = $node->namespacedName; if ($traitName === null) { return []; } if (!$this->reflectionProvider->hasClass($traitName->toString())) { return []; } return $this->check->checkInTraitDefinitionContext($this->reflectionProvider->getClass($traitName->toString())); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Classes; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\Rule; /** * @implements Rule<Node\Stmt\Trait_> */ final class MixinTraitRule implements Rule { /** * @var MixinCheck */ private $check; /** * @var ReflectionProvider */ private $reflectionProvider; public function __construct(\PHPStan\Rules\Classes\MixinCheck $check, ReflectionProvider $reflectionProvider) { $this->check = $check; $this->reflectionProvider = $reflectionProvider; } public function getNodeType() : string { return Node\Stmt\Trait_::class; } public function processNode(Node $node, Scope $scope) : array { $traitName = $node->namespacedName; if ($traitName === null) { return []; } if (!$this->reflectionProvider->hasClass($traitName->toString())) { return []; } return $this->check->checkInTraitDefinitionContext($this->reflectionProvider->getClass($traitName->toString())); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Classes; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\InTraitNode; use PHPStan\Rules\Rule; /** * @implements Rule<InTraitNode> */ final class PropertyTagTraitUseRule implements Rule { /** * @var PropertyTagCheck */ private $check; public function __construct(\PHPStan\Rules\Classes\PropertyTagCheck $check) { $this->check = $check; } public function getNodeType() : string { return InTraitNode::class; } public function processNode(Node $node, Scope $scope) : array { return $this->check->checkInTraitUseContext($node->getTraitReflection(), $node->getImplementingClassReflection(), $node->getOriginalNode()); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Classes; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\Rule; /** * @implements Rule<Node\Stmt\Trait_> */ final class MethodTagTraitRule implements Rule { /** * @var MethodTagCheck */ private $check; /** * @var ReflectionProvider */ private $reflectionProvider; public function __construct(\PHPStan\Rules\Classes\MethodTagCheck $check, ReflectionProvider $reflectionProvider) { $this->check = $check; $this->reflectionProvider = $reflectionProvider; } public function getNodeType() : string { return Node\Stmt\Trait_::class; } public function processNode(Node $node, Scope $scope) : array { $traitName = $node->namespacedName; if ($traitName === null) { return []; } if (!$this->reflectionProvider->hasClass($traitName->toString())) { return []; } return $this->check->checkInTraitDefinitionContext($this->reflectionProvider->getClass($traitName->toString())); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Classes; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\ClassNameCheck; use PHPStan\Rules\ClassNameNodePair; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use function array_map; use function sprintf; /** * @implements Rule<Node\Stmt\Class_> */ final class ExistingClassesInClassImplementsRule implements Rule { /** * @var ClassNameCheck */ private $classCheck; /** * @var ReflectionProvider */ private $reflectionProvider; public function __construct(ClassNameCheck $classCheck, ReflectionProvider $reflectionProvider) { $this->classCheck = $classCheck; $this->reflectionProvider = $reflectionProvider; } public function getNodeType() : string { return Node\Stmt\Class_::class; } public function processNode(Node $node, Scope $scope) : array { $messages = $this->classCheck->checkClassNames(array_map(static function (Node\Name $interfaceName) : ClassNameNodePair { return new ClassNameNodePair((string) $interfaceName, $interfaceName); }, $node->implements)); $currentClassName = null; if (isset($node->namespacedName)) { $currentClassName = (string) $node->namespacedName; } foreach ($node->implements as $implements) { $implementedClassName = (string) $implements; if (!$this->reflectionProvider->hasClass($implementedClassName)) { if (!$scope->isInClassExists($implementedClassName)) { $messages[] = RuleErrorBuilder::message(sprintf('%s implements unknown interface %s.', $currentClassName !== null ? sprintf('Class %s', $currentClassName) : 'Anonymous class', $implementedClassName))->identifier('interface.notFound')->nonIgnorable()->discoveringSymbolsTip()->build(); } } else { $reflection = $this->reflectionProvider->getClass($implementedClassName); if ($reflection->isClass()) { $messages[] = RuleErrorBuilder::message(sprintf('%s implements class %s.', $currentClassName !== null ? sprintf('Class %s', $currentClassName) : 'Anonymous class', $reflection->getDisplayName()))->identifier('classImplements.class')->nonIgnorable()->build(); } elseif ($reflection->isTrait()) { $messages[] = RuleErrorBuilder::message(sprintf('%s implements trait %s.', $currentClassName !== null ? sprintf('Class %s', $currentClassName) : 'Anonymous class', $reflection->getDisplayName()))->identifier('classImplements.trait')->nonIgnorable()->build(); } elseif ($reflection->isEnum()) { $messages[] = RuleErrorBuilder::message(sprintf('%s implements enum %s.', $currentClassName !== null ? sprintf('Class %s', $currentClassName) : 'Anonymous class', $reflection->getDisplayName()))->identifier('classImplements.enum')->nonIgnorable()->build(); } } } return $messages; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Classes; use PhpParser\Node; use PhpParser\Node\Expr\Variable; use PhpParser\Node\Param; use PHPStan\Analyser\Scope; use PHPStan\Internal\SprintfHelper; use PHPStan\Node\InClassMethodNode; use PHPStan\Rules\Rule; use PHPStan\Rules\UnusedFunctionParametersCheck; use PHPStan\ShouldNotHappenException; use function array_filter; use function array_map; use function array_values; use function count; use function is_string; use function sprintf; use function strtolower; /** * @implements Rule<InClassMethodNode> */ final class UnusedConstructorParametersRule implements Rule { /** * @var UnusedFunctionParametersCheck */ private $check; public function __construct(UnusedFunctionParametersCheck $check) { $this->check = $check; } public function getNodeType() : string { return InClassMethodNode::class; } public function processNode(Node $node, Scope $scope) : array { $method = $node->getMethodReflection(); $originalNode = $node->getOriginalNode(); if (strtolower($method->getName()) !== '__construct' || $originalNode->stmts === null) { return []; } if (count($originalNode->params) === 0) { return []; } $message = sprintf('Constructor of class %s has an unused parameter $%%s.', SprintfHelper::escapeFormatString($node->getClassReflection()->getDisplayName())); if ($node->getClassReflection()->isAnonymous()) { $message = 'Constructor of an anonymous class has an unused parameter $%s.'; } return $this->check->getUnusedParameters($scope, array_map(static function (Param $parameter) : string { if (!$parameter->var instanceof Variable || !is_string($parameter->var->name)) { throw new ShouldNotHappenException(); } return $parameter->var->name; }, array_values(array_filter($originalNode->params, static function (Param $parameter) : bool { return $parameter->flags === 0; }))), $originalNode->stmts, $message, 'constructor.unusedParameter'); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Classes; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\InTraitNode; use PHPStan\Rules\Rule; /** * @implements Rule<InTraitNode> */ final class LocalTypeTraitUseAliasesRule implements Rule { /** * @var LocalTypeAliasesCheck */ private $check; public function __construct(\PHPStan\Rules\Classes\LocalTypeAliasesCheck $check) { $this->check = $check; } public function getNodeType() : string { return InTraitNode::class; } public function processNode(Node $node, Scope $scope) : array { return $this->check->checkInTraitUseContext($node->getTraitReflection(), $node->getImplementingClassReflection(), $node->getOriginalNode()); } } <?php declare (strict_types=1); namespace PHPStan\Rules\Classes; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\InClassNode; use PHPStan\Rules\IdentifierRuleError; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; use PHPStan\ShouldNotHappenException; use function sprintf; use function strtolower; /** * @implements Rule<InClassNode> */ final class NonClassAttributeClassRule implements Rule { public function getNodeType() : string { return InClassNode::class; } public function processNode(Node $node, Scope $scope) : array { $originalNode = $node->getOriginalNode(); foreach ($originalNode->attrGroups as $attrGroup) { foreach ($attrGroup->attrs as $attr) { $name = $attr->name->toLowerString(); if ($name === 'attribute') { return $this->check($scope); } } } return []; } /** * @return list<IdentifierRuleError> */ private function check(Scope $scope) : array { if (!$scope->isInClass()) { throw new ShouldNotHappenException(); } $classReflection = $scope->getClassReflection(); if (!$classReflection->isClass()) { return [RuleErrorBuilder::message(sprintf('%s cannot be an Attribute class.', $classReflection->getClassTypeDescription()))->identifier(sprintf('attribute.%s', strtolower($classReflection->getClassTypeDescription())))->build()]; } if ($classReflection->isAbstract()) { return [RuleErrorBuilder::message(sprintf('Abstract class %s cannot be an Attribute class.', $classReflection->getDisplayName()))->identifier('attribute.abstract')->build()]; } if (!$classReflection->hasConstructor()) { return []; } if (!$classReflection->getConstructor()->isPublic()) { return [RuleErrorBuilder::message(sprintf('Attribute class %s constructor must be public.', $classReflection->getDisplayName()))->identifier('attribute.constructorNotPublic')->build()]; } return []; } } <?php declare (strict_types=1); namespace PHPStan\Rules\Classes; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Node\InClassNode; use PHPStan\Php\PhpVersion; use PHPStan\Rules\Rule; use PHPStan\Rules\RuleErrorBuilder; /** * @implements Rule<InClassNode> */ final class ReadOnlyClassRule implements Rule { /** * @var PhpVersion */ private $phpVersion; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; } public function getNodeType() : string { return InClassNode::class; } public function processNode(Node $node, Scope $scope) : array { $classReflection = $node->getClassReflection(); if (!$classReflection->isReadOnly()) { return []; } if ($classReflection->isAnonymous()) { if ($this->phpVersion->supportsReadOnlyAnonymousClasses()) { return []; } return [RuleErrorBuilder::message('Anonymous readonly classes are supported only on PHP 8.3 and later.')->identifier('classConstant.nativeTypeNotSupported')->nonIgnorable()->build()]; } if ($this->phpVersion->supportsReadOnlyClasses()) { return []; } return [RuleErrorBuilder::message('Readonly classes are supported only on PHP 8.2 and later.')->identifier('classConstant.nativeTypeNotSupported')->nonIgnorable()->build()]; } } <?php declare (strict_types=1); namespace PHPStan\Reflection; use PHPStan\Type\Type; final class MethodPrototypeReflection implements \PHPStan\Reflection\ClassMemberReflection { /** * @var string */ private $name; /** * @var ClassReflection */ private $declaringClass; /** * @var bool */ private $isStatic; /** * @var bool */ private $isPrivate; /** * @var bool */ private $isPublic; /** * @var bool */ private $isAbstract; /** * @var bool */ private $isFinal; /** * @var bool */ private $isInternal; /** * @var ParametersAcceptor[] */ private $variants; /** * @var ?Type */ private $tentativeReturnType; /** * @param ParametersAcceptor[] $variants */ public function __construct(string $name, \PHPStan\Reflection\ClassReflection $declaringClass, bool $isStatic, bool $isPrivate, bool $isPublic, bool $isAbstract, bool $isFinal, bool $isInternal, array $variants, ?Type $tentativeReturnType) { $this->name = $name; $this->declaringClass = $declaringClass; $this->isStatic = $isStatic; $this->isPrivate = $isPrivate; $this->isPublic = $isPublic; $this->isAbstract = $isAbstract; $this->isFinal = $isFinal; $this->isInternal = $isInternal; $this->variants = $variants; $this->tentativeReturnType = $tentativeReturnType; } public function getName() : string { return $this->name; } public function getDeclaringClass() : \PHPStan\Reflection\ClassReflection { return $this->declaringClass; } public function isStatic() : bool { return $this->isStatic; } public function isPrivate() : bool { return $this->isPrivate; } public function isPublic() : bool { return $this->isPublic; } public function isAbstract() : bool { return $this->isAbstract; } public function isFinal() : bool { return $this->isFinal; } public function isInternal() : bool { return $this->isInternal; } public function getDocComment() : ?string { return null; } /** * @return ParametersAcceptor[] */ public function getVariants() : array { return $this->variants; } public function getTentativeReturnType() : ?Type { return $this->tentativeReturnType; } } <?php declare (strict_types=1); namespace PHPStan\Reflection; /** * This is the interface custom methods class reflection extensions implement. * * To register it in the configuration file use the `phpstan.broker.methodsClassReflectionExtension` service tag: * * ``` * services: * - * class: App\PHPStan\MyMethodsClassReflectionExtension * tags: * - phpstan.broker.methodsClassReflectionExtension * ``` * * Learn more: https://phpstan.org/developing-extensions/class-reflection-extensions * * @api */ interface MethodsClassReflectionExtension { public function hasMethod(\PHPStan\Reflection\ClassReflection $classReflection, string $methodName) : bool; public function getMethod(\PHPStan\Reflection\ClassReflection $classReflection, string $methodName) : \PHPStan\Reflection\MethodReflection; } <?php declare (strict_types=1); namespace PHPStan\Reflection\RequireExtension; use PHPStan\Analyser\OutOfClassScope; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ExtendedPropertyReflection; use PHPStan\Reflection\PropertiesClassReflectionExtension; use PHPStan\Reflection\PropertyReflection; use PHPStan\ShouldNotHappenException; final class RequireExtendsPropertiesClassReflectionExtension implements PropertiesClassReflectionExtension { public function hasProperty(ClassReflection $classReflection, string $propertyName) : bool { return $this->findProperty($classReflection, $propertyName) !== null; } /** * @return ExtendedPropertyReflection */ public function getProperty(ClassReflection $classReflection, string $propertyName) : PropertyReflection { $property = $this->findProperty($classReflection, $propertyName); if ($property === null) { throw new ShouldNotHappenException(); } return $property; } private function findProperty(ClassReflection $classReflection, string $propertyName) : ?ExtendedPropertyReflection { if (!$classReflection->isInterface()) { return null; } $requireExtendsTags = $classReflection->getRequireExtendsTags(); foreach ($requireExtendsTags as $requireExtendsTag) { $type = $requireExtendsTag->getType(); if (!$type->hasProperty($propertyName)->yes()) { continue; } return $type->getProperty($propertyName, new OutOfClassScope()); } $interfaces = $classReflection->getInterfaces(); foreach ($interfaces as $interface) { $property = $this->findProperty($interface, $propertyName); if ($property !== null) { return $property; } } return null; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\RequireExtension; use PHPStan\Analyser\OutOfClassScope; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\MethodReflection; use PHPStan\Reflection\MethodsClassReflectionExtension; use PHPStan\ShouldNotHappenException; final class RequireExtendsMethodsClassReflectionExtension implements MethodsClassReflectionExtension { public function hasMethod(ClassReflection $classReflection, string $methodName) : bool { return $this->findMethod($classReflection, $methodName) !== null; } /** * @return ExtendedMethodReflection */ public function getMethod(ClassReflection $classReflection, string $methodName) : MethodReflection { $method = $this->findMethod($classReflection, $methodName); if ($method === null) { throw new ShouldNotHappenException(); } return $method; } /** * @return ExtendedMethodReflection|null */ private function findMethod(ClassReflection $classReflection, string $methodName) : ?MethodReflection { if (!$classReflection->isInterface()) { return null; } $extendsTags = $classReflection->getRequireExtendsTags(); foreach ($extendsTags as $extendsTag) { $type = $extendsTag->getType(); if (!$type->hasMethod($methodName)->yes()) { continue; } return $type->getMethod($methodName, new OutOfClassScope()); } $interfaces = $classReflection->getInterfaces(); foreach ($interfaces as $interface) { $method = $this->findMethod($interface, $methodName); if ($method !== null) { return $method; } } return null; } } <?php declare (strict_types=1); namespace PHPStan\Reflection; use PHPStan\Broker\Broker; /** * @api * @deprecated Inject PHPStan\Reflection\ReflectionProvider into the constructor instead */ interface BrokerAwareExtension { public function setBroker(Broker $broker) : void; } <?php declare (strict_types=1); namespace PHPStan\Reflection; use Closure; use PhpParser\Node; use PHPStan\Analyser\ArgumentsNormalizer; use PHPStan\Analyser\MutatingScope; use PHPStan\Analyser\Scope; use PHPStan\Node\Expr\ParameterVariableOriginalValueExpr; use PHPStan\Parser\ArrayFilterArgVisitor; use PHPStan\Parser\ArrayFindArgVisitor; use PHPStan\Parser\ArrayMapArgVisitor; use PHPStan\Parser\ArrayWalkArgVisitor; use PHPStan\Parser\ClosureBindArgVisitor; use PHPStan\Parser\ClosureBindToVarVisitor; use PHPStan\Parser\CurlSetOptArgVisitor; use PHPStan\Reflection\Callables\CallableParametersAcceptor; use PHPStan\Reflection\Native\NativeParameterReflection; use PHPStan\Reflection\Php\DummyParameter; use PHPStan\Reflection\Php\DummyParameterWithPhpDocs; use PHPStan\ShouldNotHappenException; use PHPStan\TrinaryLogic; use PHPStan\Type\Accessory\AccessoryNonEmptyStringType; use PHPStan\Type\ArrayType; use PHPStan\Type\BooleanType; use PHPStan\Type\CallableType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Generic\TemplateType; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\Generic\TemplateTypeVarianceMap; use PHPStan\Type\IntegerType; use PHPStan\Type\LateResolvableType; use PHPStan\Type\MixedType; use PHPStan\Type\NullType; use PHPStan\Type\ObjectType; use PHPStan\Type\ResourceType; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\TypeTraverser; use PHPStan\Type\UnionType; use function array_key_exists; use function array_key_last; use function array_map; use function array_merge; use function array_slice; use function constant; use function count; use function defined; use function is_string; use function sprintf; use const ARRAY_FILTER_USE_BOTH; use const ARRAY_FILTER_USE_KEY; use const CURLOPT_SSL_VERIFYHOST; /** * @api * @final */ class ParametersAcceptorSelector { /** * @deprecated See https://github.com/phpstan/phpstan-src/blob/2.0.x/UPGRADING.md#removed-deprecated-parametersacceptorselectorselectsingle * * @template T of ParametersAcceptor * @param T[] $parametersAcceptors * @return T */ public static function selectSingle(array $parametersAcceptors) : \PHPStan\Reflection\ParametersAcceptor { $count = count($parametersAcceptors); if ($count === 0) { throw new ShouldNotHappenException('getVariants() must return at least one variant.'); } if ($count !== 1) { throw new ShouldNotHappenException('Multiple variants - use selectFromArgs() instead.'); } return $parametersAcceptors[0]; } /** * @param Node\Arg[] $args * @param ParametersAcceptor[] $parametersAcceptors * @param ParametersAcceptor[]|null $namedArgumentsVariants */ public static function selectFromArgs(Scope $scope, array $args, array $parametersAcceptors, ?array $namedArgumentsVariants = null) : \PHPStan\Reflection\ParametersAcceptor { $types = []; $unpack = \false; if (count($args) > 0 && count($parametersAcceptors) > 0) { $arrayMapArgs = $args[0]->value->getAttribute(ArrayMapArgVisitor::ATTRIBUTE_NAME); if ($arrayMapArgs !== null) { $acceptor = $parametersAcceptors[0]; $parameters = $acceptor->getParameters(); $callbackParameters = []; foreach ($arrayMapArgs as $arg) { $argType = $scope->getType($arg->value); if ($arg->unpack) { $constantArrays = $argType->getConstantArrays(); if (count($constantArrays) > 0) { foreach ($constantArrays as $constantArray) { $valueTypes = $constantArray->getValueTypes(); foreach ($valueTypes as $valueType) { $callbackParameters[] = new DummyParameter('item', $scope->getIterableValueType($valueType), \false, \PHPStan\Reflection\PassedByReference::createNo(), \false, null); } } } } else { $callbackParameters[] = new DummyParameter('item', $scope->getIterableValueType($argType), \false, \PHPStan\Reflection\PassedByReference::createNo(), \false, null); } } $parameters[0] = new NativeParameterReflection($parameters[0]->getName(), $parameters[0]->isOptional(), new UnionType([new CallableType($callbackParameters, new MixedType(), \false), new NullType()]), $parameters[0]->passedByReference(), $parameters[0]->isVariadic(), $parameters[0]->getDefaultValue()); $parametersAcceptors = [new \PHPStan\Reflection\FunctionVariant($acceptor->getTemplateTypeMap(), $acceptor->getResolvedTemplateTypeMap(), $parameters, $acceptor->isVariadic(), $acceptor->getReturnType(), $acceptor instanceof \PHPStan\Reflection\ParametersAcceptorWithPhpDocs ? $acceptor->getCallSiteVarianceMap() : TemplateTypeVarianceMap::createEmpty())]; } if (count($args) >= 3 && (bool) $args[0]->getAttribute(CurlSetOptArgVisitor::ATTRIBUTE_NAME)) { $optType = $scope->getType($args[1]->value); if ($optType instanceof ConstantIntegerType) { $optValueType = self::getCurlOptValueType($optType->getValue()); if ($optValueType !== null) { $acceptor = $parametersAcceptors[0]; $parameters = $acceptor->getParameters(); $parameters[2] = new NativeParameterReflection($parameters[2]->getName(), $parameters[2]->isOptional(), $optValueType, $parameters[2]->passedByReference(), $parameters[2]->isVariadic(), $parameters[2]->getDefaultValue()); $parametersAcceptors = [new \PHPStan\Reflection\FunctionVariant($acceptor->getTemplateTypeMap(), $acceptor->getResolvedTemplateTypeMap(), $parameters, $acceptor->isVariadic(), $acceptor->getReturnType(), $acceptor instanceof \PHPStan\Reflection\ParametersAcceptorWithPhpDocs ? $acceptor->getCallSiteVarianceMap() : TemplateTypeVarianceMap::createEmpty())]; } } } if (isset($args[0]) && (bool) $args[0]->getAttribute(ArrayFilterArgVisitor::ATTRIBUTE_NAME)) { if (isset($args[2])) { $mode = $scope->getType($args[2]->value); if ($mode instanceof ConstantIntegerType) { if ($mode->getValue() === ARRAY_FILTER_USE_KEY) { $arrayFilterParameters = [new DummyParameter('key', $scope->getIterableKeyType($scope->getType($args[0]->value)), \false, \PHPStan\Reflection\PassedByReference::createNo(), \false, null)]; } elseif ($mode->getValue() === ARRAY_FILTER_USE_BOTH) { $arrayFilterParameters = [new DummyParameter('item', $scope->getIterableValueType($scope->getType($args[0]->value)), \false, \PHPStan\Reflection\PassedByReference::createNo(), \false, null), new DummyParameter('key', $scope->getIterableKeyType($scope->getType($args[0]->value)), \false, \PHPStan\Reflection\PassedByReference::createNo(), \false, null)]; } } } $acceptor = $parametersAcceptors[0]; $parameters = $acceptor->getParameters(); $parameters[1] = new NativeParameterReflection($parameters[1]->getName(), $parameters[1]->isOptional(), new UnionType([new CallableType($arrayFilterParameters ?? [new DummyParameter('item', $scope->getIterableValueType($scope->getType($args[0]->value)), \false, \PHPStan\Reflection\PassedByReference::createNo(), \false, null)], new BooleanType(), \false), new NullType()]), $parameters[1]->passedByReference(), $parameters[1]->isVariadic(), $parameters[1]->getDefaultValue()); $parametersAcceptors = [new \PHPStan\Reflection\FunctionVariant($acceptor->getTemplateTypeMap(), $acceptor->getResolvedTemplateTypeMap(), $parameters, $acceptor->isVariadic(), $acceptor->getReturnType(), $acceptor instanceof \PHPStan\Reflection\ParametersAcceptorWithPhpDocs ? $acceptor->getCallSiteVarianceMap() : TemplateTypeVarianceMap::createEmpty())]; } if (isset($args[0]) && (bool) $args[0]->getAttribute(ArrayWalkArgVisitor::ATTRIBUTE_NAME)) { $arrayWalkParameters = [new DummyParameter('item', $scope->getIterableValueType($scope->getType($args[0]->value)), \false, \PHPStan\Reflection\PassedByReference::createReadsArgument(), \false, null), new DummyParameter('key', $scope->getIterableKeyType($scope->getType($args[0]->value)), \false, \PHPStan\Reflection\PassedByReference::createNo(), \false, null)]; if (isset($args[2])) { $arrayWalkParameters[] = new DummyParameter('arg', $scope->getType($args[2]->value), \false, \PHPStan\Reflection\PassedByReference::createNo(), \false, null); } $acceptor = $parametersAcceptors[0]; $parameters = $acceptor->getParameters(); $parameters[1] = new NativeParameterReflection($parameters[1]->getName(), $parameters[1]->isOptional(), new CallableType($arrayWalkParameters, new MixedType(), \false), $parameters[1]->passedByReference(), $parameters[1]->isVariadic(), $parameters[1]->getDefaultValue()); $parametersAcceptors = [new \PHPStan\Reflection\FunctionVariant($acceptor->getTemplateTypeMap(), $acceptor->getResolvedTemplateTypeMap(), $parameters, $acceptor->isVariadic(), $acceptor->getReturnType(), $acceptor instanceof \PHPStan\Reflection\ParametersAcceptorWithPhpDocs ? $acceptor->getCallSiteVarianceMap() : TemplateTypeVarianceMap::createEmpty())]; } if (isset($args[0]) && (bool) $args[0]->getAttribute(ArrayFindArgVisitor::ATTRIBUTE_NAME)) { $acceptor = $parametersAcceptors[0]; $parameters = $acceptor->getParameters(); $argType = $scope->getType($args[0]->value); $parameters[1] = new NativeParameterReflection($parameters[1]->getName(), $parameters[1]->isOptional(), new CallableType([new DummyParameter('value', $scope->getIterableValueType($argType), \false, \PHPStan\Reflection\PassedByReference::createNo(), \false, null), new DummyParameter('key', $scope->getIterableKeyType($argType), \false, \PHPStan\Reflection\PassedByReference::createNo(), \false, null)], new BooleanType(), \false), $parameters[1]->passedByReference(), $parameters[1]->isVariadic(), $parameters[1]->getDefaultValue()); $parametersAcceptors = [new \PHPStan\Reflection\FunctionVariant($acceptor->getTemplateTypeMap(), $acceptor->getResolvedTemplateTypeMap(), $parameters, $acceptor->isVariadic(), $acceptor->getReturnType(), $acceptor instanceof \PHPStan\Reflection\ParametersAcceptorWithPhpDocs ? $acceptor->getCallSiteVarianceMap() : TemplateTypeVarianceMap::createEmpty())]; } if (isset($args[0])) { $closureBindToVar = $args[0]->getAttribute(ClosureBindToVarVisitor::ATTRIBUTE_NAME); if ($closureBindToVar !== null && $closureBindToVar instanceof Node\Expr\Variable && is_string($closureBindToVar->name)) { $varType = $scope->getType($closureBindToVar); if ((new ObjectType(Closure::class))->isSuperTypeOf($varType)->yes()) { $inFunction = $scope->getFunction(); if ($inFunction !== null) { $closureThisParameters = []; foreach ($inFunction->getParameters() as $parameter) { if ($parameter->getClosureThisType() === null) { continue; } $closureThisParameters[$parameter->getName()] = $parameter->getClosureThisType(); } if (array_key_exists($closureBindToVar->name, $closureThisParameters)) { if ($scope->hasExpressionType(new ParameterVariableOriginalValueExpr($closureBindToVar->name))->yes()) { $acceptor = $parametersAcceptors[0]; $parameters = $acceptor->getParameters(); $parameters[0] = new NativeParameterReflection($parameters[0]->getName(), $parameters[0]->isOptional(), $closureThisParameters[$closureBindToVar->name], $parameters[0]->passedByReference(), $parameters[0]->isVariadic(), $parameters[0]->getDefaultValue()); $parametersAcceptors = [new \PHPStan\Reflection\FunctionVariant($acceptor->getTemplateTypeMap(), $acceptor->getResolvedTemplateTypeMap(), $parameters, $acceptor->isVariadic(), $acceptor->getReturnType(), $acceptor instanceof \PHPStan\Reflection\ParametersAcceptorWithPhpDocs ? $acceptor->getCallSiteVarianceMap() : TemplateTypeVarianceMap::createEmpty())]; } } } } } if ($args[0]->getAttribute(ClosureBindArgVisitor::ATTRIBUTE_NAME) !== null && $args[0]->value instanceof Node\Expr\Variable && is_string($args[0]->value->name)) { $closureVarName = $args[0]->value->name; $inFunction = $scope->getFunction(); if ($inFunction !== null) { $closureThisParameters = []; foreach ($inFunction->getParameters() as $parameter) { if ($parameter->getClosureThisType() === null) { continue; } $closureThisParameters[$parameter->getName()] = $parameter->getClosureThisType(); } if (array_key_exists($closureVarName, $closureThisParameters)) { if ($scope->hasExpressionType(new ParameterVariableOriginalValueExpr($closureVarName))->yes()) { $acceptor = $parametersAcceptors[0]; $parameters = $acceptor->getParameters(); $parameters[1] = new NativeParameterReflection($parameters[1]->getName(), $parameters[1]->isOptional(), $closureThisParameters[$closureVarName], $parameters[1]->passedByReference(), $parameters[1]->isVariadic(), $parameters[1]->getDefaultValue()); $parametersAcceptors = [new \PHPStan\Reflection\FunctionVariant($acceptor->getTemplateTypeMap(), $acceptor->getResolvedTemplateTypeMap(), $parameters, $acceptor->isVariadic(), $acceptor->getReturnType(), $acceptor instanceof \PHPStan\Reflection\ParametersAcceptorWithPhpDocs ? $acceptor->getCallSiteVarianceMap() : TemplateTypeVarianceMap::createEmpty())]; } } } } } } if (count($parametersAcceptors) === 1) { $acceptor = $parametersAcceptors[0]; if (!self::hasAcceptorTemplateOrLateResolvableType($acceptor)) { return $acceptor; } } $reorderedArgs = $args; $parameters = null; $singleParametersAcceptor = null; if (count($parametersAcceptors) === 1) { $reorderedArgs = ArgumentsNormalizer::reorderArgs($parametersAcceptors[0], $args); $singleParametersAcceptor = $parametersAcceptors[0]; } $hasName = \false; foreach ($reorderedArgs ?? $args as $i => $arg) { $originalArg = $arg->getAttribute(ArgumentsNormalizer::ORIGINAL_ARG_ATTRIBUTE) ?? $arg; $parameter = null; if ($singleParametersAcceptor !== null) { $parameters = $singleParametersAcceptor->getParameters(); if (isset($parameters[$i])) { $parameter = $parameters[$i]; } elseif (count($parameters) > 0 && $singleParametersAcceptor->isVariadic()) { $parameter = $parameters[count($parameters) - 1]; } } if ($parameter !== null && $scope instanceof MutatingScope) { $scope = $scope->pushInFunctionCall(null, $parameter); } $type = $scope->getType($originalArg->value); if ($parameter !== null && $scope instanceof MutatingScope) { $scope = $scope->popInFunctionCall(); } if ($originalArg->name !== null) { $index = $originalArg->name->toString(); $hasName = \true; } else { $index = $i; } if ($originalArg->unpack) { $unpack = \true; $types[$index] = $type->getIterableValueType(); } else { $types[$index] = $type; } } if ($hasName && $namedArgumentsVariants !== null) { return self::selectFromTypes($types, $namedArgumentsVariants, $unpack); } return self::selectFromTypes($types, $parametersAcceptors, $unpack); } private static function hasAcceptorTemplateOrLateResolvableType(\PHPStan\Reflection\ParametersAcceptor $acceptor) : bool { if (self::hasTemplateOrLateResolvableType($acceptor->getReturnType())) { return \true; } foreach ($acceptor->getParameters() as $parameter) { if ($parameter instanceof \PHPStan\Reflection\ParameterReflectionWithPhpDocs && $parameter->getOutType() !== null && self::hasTemplateOrLateResolvableType($parameter->getOutType())) { return \true; } if ($parameter instanceof \PHPStan\Reflection\ParameterReflectionWithPhpDocs && $parameter->getClosureThisType() !== null && self::hasTemplateOrLateResolvableType($parameter->getClosureThisType())) { return \true; } if (!self::hasTemplateOrLateResolvableType($parameter->getType())) { continue; } return \true; } return \false; } private static function hasTemplateOrLateResolvableType(Type $type) : bool { $has = \false; TypeTraverser::map($type, static function (Type $type, callable $traverse) use(&$has) : Type { if ($type instanceof TemplateType || $type instanceof LateResolvableType) { $has = \true; return $type; } return $traverse($type); }); return $has; } /** * @param array<int|string, Type> $types * @param ParametersAcceptor[] $parametersAcceptors */ public static function selectFromTypes(array $types, array $parametersAcceptors, bool $unpack) : \PHPStan\Reflection\ParametersAcceptor { if (count($parametersAcceptors) === 1) { return \PHPStan\Reflection\GenericParametersAcceptorResolver::resolve($types, $parametersAcceptors[0]); } if (count($parametersAcceptors) === 0) { throw new ShouldNotHappenException('getVariants() must return at least one variant.'); } $typesCount = count($types); $acceptableAcceptors = []; foreach ($parametersAcceptors as $parametersAcceptor) { if ($unpack) { $acceptableAcceptors[] = $parametersAcceptor; continue; } $functionParametersMinCount = 0; $functionParametersMaxCount = 0; foreach ($parametersAcceptor->getParameters() as $parameter) { if (!$parameter->isOptional()) { $functionParametersMinCount++; } $functionParametersMaxCount++; } if ($typesCount < $functionParametersMinCount) { continue; } if (!$parametersAcceptor->isVariadic() && $typesCount > $functionParametersMaxCount) { continue; } $acceptableAcceptors[] = $parametersAcceptor; } if (count($acceptableAcceptors) === 0) { return \PHPStan\Reflection\GenericParametersAcceptorResolver::resolve($types, self::combineAcceptors($parametersAcceptors)); } if (count($acceptableAcceptors) === 1) { return \PHPStan\Reflection\GenericParametersAcceptorResolver::resolve($types, $acceptableAcceptors[0]); } $winningAcceptors = []; $winningCertainty = null; foreach ($acceptableAcceptors as $acceptableAcceptor) { $isSuperType = TrinaryLogic::createYes(); $acceptableAcceptor = \PHPStan\Reflection\GenericParametersAcceptorResolver::resolve($types, $acceptableAcceptor); foreach ($acceptableAcceptor->getParameters() as $i => $parameter) { if (!isset($types[$i])) { if (!$unpack || count($types) <= 0) { break; } $type = $types[array_key_last($types)]; } else { $type = $types[$i]; } if ($parameter->getType() instanceof MixedType) { $isSuperType = $isSuperType->and(TrinaryLogic::createMaybe()); } else { $isSuperType = $isSuperType->and($parameter->getType()->isSuperTypeOf($type)); } } if ($isSuperType->no()) { continue; } if ($winningCertainty === null) { $winningAcceptors[] = $acceptableAcceptor; $winningCertainty = $isSuperType; } else { $comparison = $winningCertainty->compareTo($isSuperType); if ($comparison === $isSuperType) { $winningAcceptors = [$acceptableAcceptor]; $winningCertainty = $isSuperType; } elseif ($comparison === null) { $winningAcceptors[] = $acceptableAcceptor; } } } if (count($winningAcceptors) === 0) { return \PHPStan\Reflection\GenericParametersAcceptorResolver::resolve($types, self::combineAcceptors($acceptableAcceptors)); } return \PHPStan\Reflection\GenericParametersAcceptorResolver::resolve($types, self::combineAcceptors($winningAcceptors)); } /** * @param ParametersAcceptor[] $acceptors */ public static function combineAcceptors(array $acceptors) : \PHPStan\Reflection\ParametersAcceptorWithPhpDocs { if (count($acceptors) === 0) { throw new ShouldNotHappenException('getVariants() must return at least one variant.'); } if (count($acceptors) === 1) { return self::wrapAcceptor($acceptors[0]); } $minimumNumberOfParameters = null; foreach ($acceptors as $acceptor) { $acceptorParametersMinCount = 0; foreach ($acceptor->getParameters() as $parameter) { if ($parameter->isOptional()) { continue; } $acceptorParametersMinCount++; } if ($minimumNumberOfParameters !== null && $minimumNumberOfParameters <= $acceptorParametersMinCount) { continue; } $minimumNumberOfParameters = $acceptorParametersMinCount; } $parameters = []; $isVariadic = \false; $returnTypes = []; $phpDocReturnTypes = []; $nativeReturnTypes = []; $callableOccurred = \false; $throwPoints = []; $isPure = TrinaryLogic::createNo(); $impurePoints = []; $invalidateExpressions = []; $usedVariables = []; $acceptsNamedArguments = \false; foreach ($acceptors as $acceptor) { $returnTypes[] = $acceptor->getReturnType(); if ($acceptor instanceof \PHPStan\Reflection\ParametersAcceptorWithPhpDocs) { $phpDocReturnTypes[] = $acceptor->getPhpDocReturnType(); $nativeReturnTypes[] = $acceptor->getNativeReturnType(); } if ($acceptor instanceof CallableParametersAcceptor) { $callableOccurred = \true; $throwPoints = array_merge($throwPoints, $acceptor->getThrowPoints()); $isPure = $isPure->or($acceptor->isPure()); $impurePoints = array_merge($impurePoints, $acceptor->getImpurePoints()); $invalidateExpressions = array_merge($invalidateExpressions, $acceptor->getInvalidateExpressions()); $usedVariables = array_merge($usedVariables, $acceptor->getUsedVariables()); $acceptsNamedArguments = $acceptsNamedArguments || $acceptor->acceptsNamedArguments(); } $isVariadic = $isVariadic || $acceptor->isVariadic(); foreach ($acceptor->getParameters() as $i => $parameter) { if (!isset($parameters[$i])) { $parameters[$i] = new DummyParameterWithPhpDocs($parameter->getName(), $parameter->getType(), $i + 1 > $minimumNumberOfParameters, $parameter->passedByReference(), $parameter->isVariadic(), $parameter->getDefaultValue(), $parameter instanceof \PHPStan\Reflection\ParameterReflectionWithPhpDocs ? $parameter->getNativeType() : new MixedType(), $parameter instanceof \PHPStan\Reflection\ParameterReflectionWithPhpDocs ? $parameter->getPhpDocType() : new MixedType(), $parameter instanceof \PHPStan\Reflection\ParameterReflectionWithPhpDocs ? $parameter->getOutType() : null, $parameter instanceof \PHPStan\Reflection\ParameterReflectionWithPhpDocs ? $parameter->isImmediatelyInvokedCallable() : TrinaryLogic::createMaybe(), $parameter instanceof \PHPStan\Reflection\ParameterReflectionWithPhpDocs ? $parameter->getClosureThisType() : null); continue; } $isVariadic = $parameters[$i]->isVariadic() || $parameter->isVariadic(); $defaultValueLeft = $parameters[$i]->getDefaultValue(); $defaultValueRight = $parameter->getDefaultValue(); if ($defaultValueLeft !== null && $defaultValueRight !== null) { $defaultValue = TypeCombinator::union($defaultValueLeft, $defaultValueRight); } else { $defaultValue = null; } $type = TypeCombinator::union($parameters[$i]->getType(), $parameter->getType()); $nativeType = $parameters[$i]->getNativeType(); $phpDocType = $parameters[$i]->getPhpDocType(); $outType = $parameters[$i]->getOutType(); $immediatelyInvokedCallable = $parameters[$i]->isImmediatelyInvokedCallable(); $closureThisType = $parameters[$i]->getClosureThisType(); if ($parameter instanceof \PHPStan\Reflection\ParameterReflectionWithPhpDocs) { $nativeType = TypeCombinator::union($nativeType, $parameter->getNativeType()); $phpDocType = TypeCombinator::union($phpDocType, $parameter->getPhpDocType()); if ($parameter->getOutType() !== null) { $outType = $outType === null ? null : TypeCombinator::union($outType, $parameter->getOutType()); } else { $outType = null; } if ($parameter->getClosureThisType() !== null && $closureThisType !== null) { $closureThisType = TypeCombinator::union($closureThisType, $parameter->getClosureThisType()); } else { $closureThisType = null; } $immediatelyInvokedCallable = $parameter->isImmediatelyInvokedCallable()->or($immediatelyInvokedCallable); } else { $nativeType = new MixedType(); $phpDocType = $type; $outType = null; $immediatelyInvokedCallable = TrinaryLogic::createMaybe(); $closureThisType = null; } $parameters[$i] = new DummyParameterWithPhpDocs($parameters[$i]->getName() !== $parameter->getName() ? sprintf('%s|%s', $parameters[$i]->getName(), $parameter->getName()) : $parameter->getName(), $type, $i + 1 > $minimumNumberOfParameters, $parameters[$i]->passedByReference()->combine($parameter->passedByReference()), $isVariadic, $defaultValue, $nativeType, $phpDocType, $outType, $immediatelyInvokedCallable, $closureThisType); if ($isVariadic) { $parameters = array_slice($parameters, 0, $i + 1); break; } } } $returnType = TypeCombinator::union(...$returnTypes); $phpDocReturnType = $phpDocReturnTypes === [] ? null : TypeCombinator::union(...$phpDocReturnTypes); $nativeReturnType = $nativeReturnTypes === [] ? null : TypeCombinator::union(...$nativeReturnTypes); if ($callableOccurred) { return new \PHPStan\Reflection\CallableFunctionVariantWithPhpDocs(TemplateTypeMap::createEmpty(), null, $parameters, $isVariadic, $returnType, $phpDocReturnType ?? $returnType, $nativeReturnType ?? new MixedType(), null, $throwPoints, $isPure, $impurePoints, $invalidateExpressions, $usedVariables, $acceptsNamedArguments); } return new \PHPStan\Reflection\FunctionVariantWithPhpDocs(TemplateTypeMap::createEmpty(), null, $parameters, $isVariadic, $returnType, $phpDocReturnType ?? $returnType, $nativeReturnType ?? new MixedType()); } private static function wrapAcceptor(\PHPStan\Reflection\ParametersAcceptor $acceptor) : \PHPStan\Reflection\ParametersAcceptorWithPhpDocs { if ($acceptor instanceof \PHPStan\Reflection\ParametersAcceptorWithPhpDocs) { return $acceptor; } if ($acceptor instanceof CallableParametersAcceptor) { return new \PHPStan\Reflection\CallableFunctionVariantWithPhpDocs($acceptor->getTemplateTypeMap(), $acceptor->getResolvedTemplateTypeMap(), array_map(static function (\PHPStan\Reflection\ParameterReflection $parameter) : \PHPStan\Reflection\ParameterReflectionWithPhpDocs { return self::wrapParameter($parameter); }, $acceptor->getParameters()), $acceptor->isVariadic(), $acceptor->getReturnType(), $acceptor->getReturnType(), new MixedType(), TemplateTypeVarianceMap::createEmpty(), $acceptor->getThrowPoints(), $acceptor->isPure(), $acceptor->getImpurePoints(), $acceptor->getInvalidateExpressions(), $acceptor->getUsedVariables(), $acceptor->acceptsNamedArguments()); } return new \PHPStan\Reflection\FunctionVariantWithPhpDocs($acceptor->getTemplateTypeMap(), $acceptor->getResolvedTemplateTypeMap(), array_map(static function (\PHPStan\Reflection\ParameterReflection $parameter) : \PHPStan\Reflection\ParameterReflectionWithPhpDocs { return self::wrapParameter($parameter); }, $acceptor->getParameters()), $acceptor->isVariadic(), $acceptor->getReturnType(), $acceptor->getReturnType(), new MixedType(), TemplateTypeVarianceMap::createEmpty()); } private static function wrapParameter(\PHPStan\Reflection\ParameterReflection $parameter) : \PHPStan\Reflection\ParameterReflectionWithPhpDocs { return $parameter instanceof \PHPStan\Reflection\ParameterReflectionWithPhpDocs ? $parameter : new DummyParameterWithPhpDocs($parameter->getName(), $parameter->getType(), $parameter->isOptional(), $parameter->passedByReference(), $parameter->isVariadic(), $parameter->getDefaultValue(), new MixedType(), $parameter->getType(), null, TrinaryLogic::createMaybe(), null); } private static function getCurlOptValueType(int $curlOpt) : ?Type { if (defined('CURLOPT_SSL_VERIFYHOST') && $curlOpt === CURLOPT_SSL_VERIFYHOST) { return new UnionType([new ConstantIntegerType(0), new ConstantIntegerType(2)]); } $boolConstants = ['CURLOPT_AUTOREFERER', 'CURLOPT_COOKIESESSION', 'CURLOPT_CERTINFO', 'CURLOPT_CONNECT_ONLY', 'CURLOPT_CRLF', 'CURLOPT_DISALLOW_USERNAME_IN_URL', 'CURLOPT_DNS_SHUFFLE_ADDRESSES', 'CURLOPT_HAPROXYPROTOCOL', 'CURLOPT_SSH_COMPRESSION', 'CURLOPT_DNS_USE_GLOBAL_CACHE', 'CURLOPT_FAILONERROR', 'CURLOPT_SSL_FALSESTART', 'CURLOPT_FILETIME', 'CURLOPT_FOLLOWLOCATION', 'CURLOPT_FORBID_REUSE', 'CURLOPT_FRESH_CONNECT', 'CURLOPT_FTP_USE_EPRT', 'CURLOPT_FTP_USE_EPSV', 'CURLOPT_FTP_CREATE_MISSING_DIRS', 'CURLOPT_FTPAPPEND', 'CURLOPT_TCP_NODELAY', 'CURLOPT_FTPASCII', 'CURLOPT_FTPLISTONLY', 'CURLOPT_HEADER', 'CURLOPT_HTTP09_ALLOWED', 'CURLOPT_HTTPGET', 'CURLOPT_HTTPPROXYTUNNEL', 'CURLOPT_HTTP_CONTENT_DECODING', 'CURLOPT_KEEP_SENDING_ON_ERROR', 'CURLOPT_MUTE', 'CURLOPT_NETRC', 'CURLOPT_NOBODY', 'CURLOPT_NOPROGRESS', 'CURLOPT_NOSIGNAL', 'CURLOPT_PATH_AS_IS', 'CURLOPT_PIPEWAIT', 'CURLOPT_POST', 'CURLOPT_PUT', 'CURLOPT_RETURNTRANSFER', 'CURLOPT_SASL_IR', 'CURLOPT_SSL_ENABLE_ALPN', 'CURLOPT_SSL_ENABLE_NPN', 'CURLOPT_SSL_VERIFYPEER', 'CURLOPT_SSL_VERIFYSTATUS', 'CURLOPT_PROXY_SSL_VERIFYPEER', 'CURLOPT_SUPPRESS_CONNECT_HEADERS', 'CURLOPT_TCP_FASTOPEN', 'CURLOPT_TFTP_NO_OPTIONS', 'CURLOPT_TRANSFERTEXT', 'CURLOPT_UNRESTRICTED_AUTH', 'CURLOPT_UPLOAD', 'CURLOPT_VERBOSE']; foreach ($boolConstants as $constName) { if (defined($constName) && constant($constName) === $curlOpt) { return new BooleanType(); } } $intConstants = ['CURLOPT_BUFFERSIZE', 'CURLOPT_CONNECTTIMEOUT', 'CURLOPT_CONNECTTIMEOUT_MS', 'CURLOPT_DNS_CACHE_TIMEOUT', 'CURLOPT_EXPECT_100_TIMEOUT_MS', 'CURLOPT_HAPPY_EYEBALLS_TIMEOUT_MS', 'CURLOPT_FTPSSLAUTH', 'CURLOPT_HEADEROPT', 'CURLOPT_HTTP_VERSION', 'CURLOPT_HTTPAUTH', 'CURLOPT_INFILESIZE', 'CURLOPT_LOW_SPEED_LIMIT', 'CURLOPT_LOW_SPEED_TIME', 'CURLOPT_MAXCONNECTS', 'CURLOPT_MAXREDIRS', 'CURLOPT_PORT', 'CURLOPT_POSTREDIR', 'CURLOPT_PROTOCOLS', 'CURLOPT_PROXYAUTH', 'CURLOPT_PROXYPORT', 'CURLOPT_PROXYTYPE', 'CURLOPT_REDIR_PROTOCOLS', 'CURLOPT_RESUME_FROM', 'CURLOPT_SOCKS5_AUTH', 'CURLOPT_SSL_OPTIONS', 'CURLOPT_SSL_VERIFYHOST', 'CURLOPT_SSLVERSION', 'CURLOPT_PROXY_SSL_OPTIONS', 'CURLOPT_PROXY_SSL_VERIFYHOST', 'CURLOPT_PROXY_SSLVERSION', 'CURLOPT_STREAM_WEIGHT', 'CURLOPT_TCP_KEEPALIVE', 'CURLOPT_TCP_KEEPIDLE', 'CURLOPT_TCP_KEEPINTVL', 'CURLOPT_TIMECONDITION', 'CURLOPT_TIMEOUT', 'CURLOPT_TIMEOUT_MS', 'CURLOPT_TIMEVALUE', 'CURLOPT_TIMEVALUE_LARGE', 'CURLOPT_MAX_RECV_SPEED_LARGE', 'CURLOPT_SSH_AUTH_TYPES', 'CURLOPT_IPRESOLVE', 'CURLOPT_FTP_FILEMETHOD']; foreach ($intConstants as $constName) { if (defined($constName) && constant($constName) === $curlOpt) { return new IntegerType(); } } $nonEmptyStringConstants = ['CURLOPT_ABSTRACT_UNIX_SOCKET', 'CURLOPT_CAINFO', 'CURLOPT_CAPATH', 'CURLOPT_COOKIE', 'CURLOPT_COOKIEJAR', 'CURLOPT_COOKIELIST', 'CURLOPT_CUSTOMREQUEST', 'CURLOPT_DEFAULT_PROTOCOL', 'CURLOPT_DNS_INTERFACE', 'CURLOPT_DNS_LOCAL_IP4', 'CURLOPT_DNS_LOCAL_IP6', 'CURLOPT_EGDSOCKET', 'CURLOPT_FTPPORT', 'CURLOPT_INTERFACE', 'CURLOPT_KEYPASSWD', 'CURLOPT_KRB4LEVEL', 'CURLOPT_LOGIN_OPTIONS', 'CURLOPT_PINNEDPUBLICKEY', 'CURLOPT_PROXY_SERVICE_NAME', 'CURLOPT_PROXY_CAINFO', 'CURLOPT_PROXY_CAPATH', 'CURLOPT_PROXY_CRLFILE', 'CURLOPT_PROXY_KEYPASSWD', 'CURLOPT_PROXY_PINNEDPUBLICKEY', 'CURLOPT_PROXY_SSLCERT', 'CURLOPT_PROXY_SSLCERTTYPE', 'CURLOPT_PROXY_SSL_CIPHER_LIST', 'CURLOPT_PROXY_TLS13_CIPHERS', 'CURLOPT_PROXY_SSLKEY', 'CURLOPT_PROXY_SSLKEYTYPE', 'CURLOPT_PROXY_TLSAUTH_PASSWORD', 'CURLOPT_PROXY_TLSAUTH_TYPE', 'CURLOPT_PROXY_TLSAUTH_USERNAME', 'CURLOPT_PROXYUSERPWD', 'CURLOPT_RANDOM_FILE', 'CURLOPT_RANGE', 'CURLOPT_REFERER', 'CURLOPT_SERVICE_NAME', 'CURLOPT_SSH_HOST_PUBLIC_KEY_MD5', 'CURLOPT_SSH_PUBLIC_KEYFILE', 'CURLOPT_SSH_PRIVATE_KEYFILE', 'CURLOPT_SSL_CIPHER_LIST', 'CURLOPT_SSLCERT', 'CURLOPT_SSLCERTPASSWD', 'CURLOPT_SSLCERTTYPE', 'CURLOPT_SSLENGINE', 'CURLOPT_SSLENGINE_DEFAULT', 'CURLOPT_SSLKEY', 'CURLOPT_SSLKEYPASSWD', 'CURLOPT_SSLKEYTYPE', 'CURLOPT_TLS13_CIPHERS', 'CURLOPT_UNIX_SOCKET_PATH', 'CURLOPT_URL', 'CURLOPT_USERAGENT', 'CURLOPT_USERNAME', 'CURLOPT_PASSWORD', 'CURLOPT_USERPWD', 'CURLOPT_XOAUTH2_BEARER']; foreach ($nonEmptyStringConstants as $constName) { if (defined($constName) && constant($constName) === $curlOpt) { return TypeCombinator::intersect(new StringType(), new AccessoryNonEmptyStringType()); } } $stringConstants = ['CURLOPT_COOKIEFILE', 'CURLOPT_ENCODING', 'CURLOPT_PRE_PROXY', 'CURLOPT_PRIVATE', 'CURLOPT_PROXY']; foreach ($stringConstants as $constName) { if (defined($constName) && constant($constName) === $curlOpt) { return new StringType(); } } $intArrayStringKeysConstants = ['CURLOPT_HTTPHEADER']; foreach ($intArrayStringKeysConstants as $constName) { if (defined($constName) && constant($constName) === $curlOpt) { return new ArrayType(new IntegerType(), new StringType()); } } $arrayConstants = ['CURLOPT_CONNECT_TO', 'CURLOPT_HTTP200ALIASES', 'CURLOPT_POSTQUOTE', 'CURLOPT_PROXYHEADER', 'CURLOPT_QUOTE', 'CURLOPT_RESOLVE']; foreach ($arrayConstants as $constName) { if (defined($constName) && constant($constName) === $curlOpt) { return new ArrayType(new MixedType(), new MixedType()); } } $arrayOrStringConstants = ['CURLOPT_POSTFIELDS']; foreach ($arrayOrStringConstants as $constName) { if (defined($constName) && constant($constName) === $curlOpt) { return new UnionType([new StringType(), new ArrayType(new MixedType(), new MixedType())]); } } $resourceConstants = ['CURLOPT_FILE', 'CURLOPT_INFILE', 'CURLOPT_STDERR', 'CURLOPT_WRITEHEADER']; foreach ($resourceConstants as $constName) { if (defined($constName) && constant($constName) === $curlOpt) { return new ResourceType(); } } // unknown constant return null; } } <?php declare (strict_types=1); namespace PHPStan\Reflection; use PHPStan\TrinaryLogic; use PHPStan\Type\Type; final class WrappedExtendedPropertyReflection implements \PHPStan\Reflection\ExtendedPropertyReflection { /** * @var PropertyReflection */ private $property; public function __construct(\PHPStan\Reflection\PropertyReflection $property) { $this->property = $property; } public function getDeclaringClass() : \PHPStan\Reflection\ClassReflection { return $this->property->getDeclaringClass(); } public function isStatic() : bool { return $this->property->isStatic(); } public function isPrivate() : bool { return $this->property->isPrivate(); } public function isPublic() : bool { return $this->property->isPublic(); } public function getDocComment() : ?string { return $this->property->getDocComment(); } public function getReadableType() : Type { return $this->property->getReadableType(); } public function getWritableType() : Type { return $this->property->getWritableType(); } public function canChangeTypeAfterAssignment() : bool { return $this->property->canChangeTypeAfterAssignment(); } public function isReadable() : bool { return $this->property->isReadable(); } public function isWritable() : bool { return $this->property->isWritable(); } public function isDeprecated() : TrinaryLogic { return $this->property->isDeprecated(); } public function getDeprecatedDescription() : ?string { return $this->property->getDeprecatedDescription(); } public function isInternal() : TrinaryLogic { return $this->property->isInternal(); } } <?php declare (strict_types=1); namespace PHPStan\Reflection; use PHPStan\Type\Type; /** * This is the extension interface to implement if you want to described * allowed subtypes - to limit which classes can implement a certain interface * or extend a certain parent class. * * To register it in the configuration file use the `phpstan.broker.allowedSubTypesClassReflectionExtension` service tag: * * ``` * services: * - * class: App\PHPStan\MyExtension * tags: * - phpstan.broker.allowedSubTypesClassReflectionExtension * ``` * * Learn more: https://phpstan.org/developing-extensions/allowed-subtypes * * @api */ interface AllowedSubTypesClassReflectionExtension { public function supports(\PHPStan\Reflection\ClassReflection $classReflection) : bool; /** * @return array<Type> */ public function getAllowedSubTypes(\PHPStan\Reflection\ClassReflection $classReflection) : array; } <?php declare (strict_types=1); namespace PHPStan\Reflection; use PhpParser\Node\Stmt\ClassMethod; use PhpParser\Node\Stmt\Function_; use PHPStan\Analyser\Scope; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionFunction; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionParameter; use PHPStan\BetterReflection\Reflection\ReflectionConstant; use PHPStan\ShouldNotHappenException; use function array_slice; use function count; use function explode; use function implode; use function sprintf; /** * @api * @final */ class InitializerExprContext implements \PHPStan\Reflection\NamespaceAnswerer { /** * @var ?string */ private $file; /** * @var non-empty-string|null */ private $namespace; /** * @var ?string */ private $className; /** * @var ?string */ private $traitName; /** * @var ?string */ private $function; /** * @var ?string */ private $method; /** * @param non-empty-string|null $namespace */ private function __construct(?string $file, ?string $namespace, ?string $className, ?string $traitName, ?string $function, ?string $method) { $this->file = $file; $this->namespace = $namespace; $this->className = $className; $this->traitName = $traitName; $this->function = $function; $this->method = $method; } public static function fromScope(Scope $scope) : self { return new self($scope->getFile(), $scope->getNamespace(), $scope->isInClass() ? $scope->getClassReflection()->getName() : null, $scope->isInTrait() ? $scope->getTraitReflection()->getName() : null, $scope->isInAnonymousFunction() ? '{closure}' : ($scope->getFunction() !== null ? $scope->getFunction()->getName() : null), $scope->isInAnonymousFunction() ? '{closure}' : ($scope->getFunction() instanceof \PHPStan\Reflection\MethodReflection ? sprintf('%s::%s', $scope->getFunction()->getDeclaringClass()->getName(), $scope->getFunction()->getName()) : ($scope->getFunction() instanceof \PHPStan\Reflection\FunctionReflection ? $scope->getFunction()->getName() : null))); } /** * @return non-empty-string|null */ private static function parseNamespace(string $name) : ?string { $parts = explode('\\', $name); if (count($parts) > 1) { $ns = implode('\\', array_slice($parts, 0, -1)); if ($ns === '') { throw new ShouldNotHappenException('Namespace cannot be empty.'); } return $ns; } return null; } public static function fromClassReflection(\PHPStan\Reflection\ClassReflection $classReflection) : self { return self::fromClass($classReflection->getName(), $classReflection->getFileName()); } public static function fromClass(string $className, ?string $fileName) : self { return new self($fileName, self::parseNamespace($className), $className, null, null, null); } public static function fromReflectionParameter(ReflectionParameter $parameter) : self { $declaringFunction = $parameter->getDeclaringFunction(); if ($declaringFunction instanceof ReflectionFunction) { $file = $declaringFunction->getFileName(); return new self($file === \false ? null : $file, self::parseNamespace($declaringFunction->getName()), null, null, $declaringFunction->getName(), $declaringFunction->getName()); } $file = $declaringFunction->getFileName(); $betterReflection = $declaringFunction->getBetterReflection(); return new self($file === \false ? null : $file, self::parseNamespace($betterReflection->getDeclaringClass()->getName()), $declaringFunction->getDeclaringClass()->getName(), $betterReflection->getDeclaringClass()->isTrait() ? $betterReflection->getDeclaringClass()->getName() : null, $declaringFunction->getName(), sprintf('%s::%s', $declaringFunction->getDeclaringClass()->getName(), $declaringFunction->getName())); } /** * @param ClassMethod|Function_ $function */ public static function fromStubParameter(?string $className, string $stubFile, $function) : self { $namespace = null; if ($className !== null) { $namespace = self::parseNamespace($className); } else { if ($function instanceof Function_ && $function->namespacedName !== null) { $namespace = self::parseNamespace($function->namespacedName->toString()); } } return new self($stubFile, $namespace, $className, null, $function instanceof Function_ && $function->namespacedName !== null ? $function->namespacedName->toString() : ($function instanceof ClassMethod ? $function->name->toString() : null), $function instanceof ClassMethod && $className !== null ? sprintf('%s::%s', $className, $function->name->toString()) : ($function instanceof Function_ && $function->namespacedName !== null ? $function->namespacedName->toString() : null)); } public static function fromGlobalConstant(ReflectionConstant $constant) : self { return new self($constant->getFileName(), $constant->getNamespaceName(), null, null, null, null); } public static function createEmpty() : self { return new self(null, null, null, null, null, null); } public function getFile() : ?string { return $this->file; } public function getClassName() : ?string { return $this->className; } public function getNamespace() : ?string { return $this->namespace; } public function getTraitName() : ?string { return $this->traitName; } public function getFunction() : ?string { return $this->function; } public function getMethod() : ?string { return $this->method; } } <?php declare (strict_types=1); namespace PHPStan\Reflection; use function array_key_exists; /** * @api * @final */ class PassedByReference { /** * @var int */ private $value; private const NO = 1; private const READS_ARGUMENT = 2; private const CREATES_NEW_VARIABLE = 3; /** @var self[] */ private static $registry = []; private function __construct(int $value) { $this->value = $value; } private static function create(int $value) : self { if (!array_key_exists($value, self::$registry)) { self::$registry[$value] = new self($value); } return self::$registry[$value]; } public static function createNo() : self { return self::create(self::NO); } public static function createCreatesNewVariable() : self { return self::create(self::CREATES_NEW_VARIABLE); } public static function createReadsArgument() : self { return self::create(self::READS_ARGUMENT); } public function no() : bool { return $this->value === self::NO; } public function yes() : bool { return !$this->no(); } public function equals(self $other) : bool { return $this->value === $other->value; } public function createsNewVariable() : bool { return $this->value === self::CREATES_NEW_VARIABLE; } public function combine(self $other) : self { if ($this->value > $other->value) { return $this; } elseif ($this->value < $other->value) { return $other; } return $this; } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : self { return new self($properties['value']); } } <?php declare (strict_types=1); namespace PHPStan\Reflection; /** @api */ interface NamespaceAnswerer { /** * @return non-empty-string|null */ public function getNamespace() : ?string; } <?php declare (strict_types=1); namespace PHPStan\Reflection; use PHPStan\Reflection\Callables\CallableParametersAcceptor; use PHPStan\Reflection\Callables\SimpleImpurePoint; use PHPStan\TrinaryLogic; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\Generic\TemplateTypeVarianceMap; use PHPStan\Type\MixedType; use PHPStan\Type\Type; final class InaccessibleMethod implements CallableParametersAcceptor { /** * @var ExtendedMethodReflection */ private $methodReflection; public function __construct(\PHPStan\Reflection\ExtendedMethodReflection $methodReflection) { $this->methodReflection = $methodReflection; } public function getMethod() : \PHPStan\Reflection\ExtendedMethodReflection { return $this->methodReflection; } public function getTemplateTypeMap() : TemplateTypeMap { return TemplateTypeMap::createEmpty(); } public function getResolvedTemplateTypeMap() : TemplateTypeMap { return TemplateTypeMap::createEmpty(); } public function getCallSiteVarianceMap() : TemplateTypeVarianceMap { return TemplateTypeVarianceMap::createEmpty(); } /** * @return array<int, ParameterReflection> */ public function getParameters() : array { return []; } public function isVariadic() : bool { return \true; } public function getReturnType() : Type { return new MixedType(); } public function getThrowPoints() : array { return []; } public function isPure() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getImpurePoints() : array { return [new SimpleImpurePoint('methodCall', 'call to unknown method', \false)]; } public function getInvalidateExpressions() : array { return []; } public function getUsedVariables() : array { return []; } public function acceptsNamedArguments() : bool { return $this->methodReflection->acceptsNamedArguments(); } } <?php declare (strict_types=1); namespace PHPStan\Reflection; use PHPStan\TrinaryLogic; use PHPStan\Type\Type; /** @api */ interface PropertyReflection extends \PHPStan\Reflection\ClassMemberReflection { public function getReadableType() : Type; public function getWritableType() : Type; public function canChangeTypeAfterAssignment() : bool; public function isReadable() : bool; public function isWritable() : bool; public function isDeprecated() : TrinaryLogic; public function getDeprecatedDescription() : ?string; public function isInternal() : TrinaryLogic; } <?php declare (strict_types=1); namespace PHPStan\Reflection; use Exception; use function sprintf; final class MissingPropertyFromReflectionException extends Exception { public function __construct(string $className, string $propertyName) { parent::__construct(sprintf('Property $%s was not found in reflection of class %s.', $propertyName, $className)); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\ReflectionProvider; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\GlobalConstantReflection; use PHPStan\Reflection\NamespaceAnswerer; use PHPStan\Reflection\ReflectionProvider; use function strtolower; final class MemoizingReflectionProvider implements ReflectionProvider { /** * @var ReflectionProvider */ private $provider; /** @var array<string, bool> */ private $hasClasses = []; /** @var array<string, ClassReflection> */ private $classes = []; /** @var array<string, string> */ private $classNames = []; public function __construct(ReflectionProvider $provider) { $this->provider = $provider; } public function hasClass(string $className) : bool { if (isset($this->hasClasses[$className])) { return $this->hasClasses[$className]; } return $this->hasClasses[$className] = $this->provider->hasClass($className); } public function getClass(string $className) : ClassReflection { $lowerClassName = strtolower($className); if (isset($this->classes[$lowerClassName])) { return $this->classes[$lowerClassName]; } return $this->classes[$lowerClassName] = $this->provider->getClass($className); } public function getClassName(string $className) : string { $lowerClassName = strtolower($className); if (isset($this->classNames[$lowerClassName])) { return $this->classNames[$lowerClassName]; } return $this->classNames[$lowerClassName] = $this->provider->getClassName($className); } public function supportsAnonymousClasses() : bool { return $this->provider->supportsAnonymousClasses(); } public function getAnonymousClassReflection(Node\Stmt\Class_ $classNode, Scope $scope) : ClassReflection { return $this->provider->getAnonymousClassReflection($classNode, $scope); } public function hasFunction(Node\Name $nameNode, ?NamespaceAnswerer $namespaceAnswerer) : bool { return $this->provider->hasFunction($nameNode, $namespaceAnswerer); } public function getFunction(Node\Name $nameNode, ?NamespaceAnswerer $namespaceAnswerer) : FunctionReflection { return $this->provider->getFunction($nameNode, $namespaceAnswerer); } public function resolveFunctionName(Node\Name $nameNode, ?NamespaceAnswerer $namespaceAnswerer) : ?string { return $this->provider->resolveFunctionName($nameNode, $namespaceAnswerer); } public function hasConstant(Node\Name $nameNode, ?NamespaceAnswerer $namespaceAnswerer) : bool { return $this->provider->hasConstant($nameNode, $namespaceAnswerer); } public function getConstant(Node\Name $nameNode, ?NamespaceAnswerer $namespaceAnswerer) : GlobalConstantReflection { return $this->provider->getConstant($nameNode, $namespaceAnswerer); } public function resolveConstantName(Node\Name $nameNode, ?NamespaceAnswerer $namespaceAnswerer) : ?string { return $this->provider->resolveConstantName($nameNode, $namespaceAnswerer); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\ReflectionProvider; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\GlobalConstantReflection; use PHPStan\Reflection\NamespaceAnswerer; use PHPStan\Reflection\ReflectionProvider; use PHPStan\ShouldNotHappenException; final class DummyReflectionProvider implements ReflectionProvider { public function hasClass(string $className) : bool { return \false; } public function getClass(string $className) : ClassReflection { throw new ShouldNotHappenException(); } public function getClassName(string $className) : string { return $className; } public function supportsAnonymousClasses() : bool { return \false; } public function getAnonymousClassReflection(Node\Stmt\Class_ $classNode, Scope $scope) : ClassReflection { throw new ShouldNotHappenException(); } public function hasFunction(Node\Name $nameNode, ?NamespaceAnswerer $namespaceAnswerer) : bool { return \false; } public function getFunction(Node\Name $nameNode, ?NamespaceAnswerer $namespaceAnswerer) : FunctionReflection { throw new ShouldNotHappenException(); } public function resolveFunctionName(Node\Name $nameNode, ?NamespaceAnswerer $namespaceAnswerer) : ?string { return null; } public function hasConstant(Node\Name $nameNode, ?NamespaceAnswerer $namespaceAnswerer) : bool { return \false; } public function getConstant(Node\Name $nameNode, ?NamespaceAnswerer $namespaceAnswerer) : GlobalConstantReflection { throw new ShouldNotHappenException(); } public function resolveConstantName(Node\Name $nameNode, ?NamespaceAnswerer $namespaceAnswerer) : ?string { return null; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\ReflectionProvider; use PHPStan\Reflection\ReflectionProvider; final class SetterReflectionProviderProvider implements \PHPStan\Reflection\ReflectionProvider\ReflectionProviderProvider { /** * @var ReflectionProvider */ private $reflectionProvider; public function setReflectionProvider(ReflectionProvider $reflectionProvider) : void { $this->reflectionProvider = $reflectionProvider; } public function getReflectionProvider() : ReflectionProvider { return $this->reflectionProvider; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\ReflectionProvider; use PHPStan\DependencyInjection\Container; use PHPStan\Reflection\ReflectionProvider; final class LazyReflectionProviderProvider implements \PHPStan\Reflection\ReflectionProvider\ReflectionProviderProvider { /** * @var Container */ private $container; public function __construct(Container $container) { $this->container = $container; } public function getReflectionProvider() : ReflectionProvider { return $this->container->getByType(ReflectionProvider::class); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\ReflectionProvider; use PHPStan\Reflection\ReflectionProvider; interface ReflectionProviderProvider { public function getReflectionProvider() : ReflectionProvider; } <?php declare (strict_types=1); namespace PHPStan\Reflection\ReflectionProvider; use PHPStan\Reflection\ReflectionProvider; final class DirectReflectionProviderProvider implements \PHPStan\Reflection\ReflectionProvider\ReflectionProviderProvider { /** * @var ReflectionProvider */ private $reflectionProvider; public function __construct(ReflectionProvider $reflectionProvider) { $this->reflectionProvider = $reflectionProvider; } public function getReflectionProvider() : ReflectionProvider { return $this->reflectionProvider; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\ReflectionProvider; use PHPStan\Reflection\ReflectionProvider; final class ReflectionProviderFactory { /** * @var ReflectionProvider */ private $staticReflectionProvider; public function __construct(ReflectionProvider $staticReflectionProvider) { $this->staticReflectionProvider = $staticReflectionProvider; } public function create() : ReflectionProvider { return new \PHPStan\Reflection\ReflectionProvider\MemoizingReflectionProvider($this->staticReflectionProvider); } } <?php declare (strict_types=1); namespace PHPStan\Reflection; use PHPStan\PhpDoc\ResolvedPhpDocBlock; use PHPStan\PhpDoc\Tag\AssertTag; use PHPStan\Type\Type; use function array_filter; use function array_map; use function array_merge; use function count; /** * @api * @final */ class Assertions { /** * @var AssertTag[] */ private $asserts; /** * @var ?self */ private static $empty = null; /** * @param AssertTag[] $asserts */ private function __construct(array $asserts) { $this->asserts = $asserts; } /** * @return AssertTag[] */ public function getAll() : array { return $this->asserts; } /** * @return AssertTag[] */ public function getAsserts() : array { return array_filter($this->asserts, static function (AssertTag $assert) { return $assert->getIf() === AssertTag::NULL; }); } /** * @return AssertTag[] */ public function getAssertsIfTrue() : array { return array_merge(array_filter($this->asserts, static function (AssertTag $assert) { return $assert->getIf() === AssertTag::IF_TRUE; }), array_map(static function (AssertTag $assert) { return $assert->negate(); }, array_filter($this->asserts, static function (AssertTag $assert) { return $assert->getIf() === AssertTag::IF_FALSE && !$assert->isEquality(); }))); } /** * @return AssertTag[] */ public function getAssertsIfFalse() : array { return array_merge(array_filter($this->asserts, static function (AssertTag $assert) { return $assert->getIf() === AssertTag::IF_FALSE; }), array_map(static function (AssertTag $assert) { return $assert->negate(); }, array_filter($this->asserts, static function (AssertTag $assert) { return $assert->getIf() === AssertTag::IF_TRUE && !$assert->isEquality(); }))); } /** * @param callable(Type): Type $callable */ public function mapTypes(callable $callable) : self { $assertTagsCallback = static function (AssertTag $tag) use($callable) : AssertTag { return $tag->withType($callable($tag->getType())); }; return new self(array_map($assertTagsCallback, $this->asserts)); } public function intersectWith(\PHPStan\Reflection\Assertions $other) : self { return new self(array_merge($this->getAll(), $other->getAll())); } public static function createEmpty() : self { $empty = self::$empty; if ($empty !== null) { return $empty; } $empty = new self([]); self::$empty = $empty; return $empty; } public static function createFromResolvedPhpDocBlock(ResolvedPhpDocBlock $phpDocBlock) : self { $tags = $phpDocBlock->getAssertTags(); if (count($tags) === 0) { return self::createEmpty(); } return new self($tags); } } <?php declare (strict_types=1); namespace PHPStan\Reflection; use PHPStan\Reflection\Php\PhpPropertyReflection; use PHPStan\TrinaryLogic; use PHPStan\Type\Generic\TemplateTypeHelper; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\Generic\TemplateTypeVariance; use PHPStan\Type\Generic\TemplateTypeVarianceMap; use PHPStan\Type\Type; final class ResolvedPropertyReflection implements \PHPStan\Reflection\WrapperPropertyReflection { /** * @var ExtendedPropertyReflection */ private $reflection; /** * @var TemplateTypeMap */ private $templateTypeMap; /** * @var TemplateTypeVarianceMap */ private $callSiteVarianceMap; /** * @var ?Type */ private $readableType = null; /** * @var ?Type */ private $writableType = null; public function __construct(\PHPStan\Reflection\ExtendedPropertyReflection $reflection, TemplateTypeMap $templateTypeMap, TemplateTypeVarianceMap $callSiteVarianceMap) { $this->reflection = $reflection; $this->templateTypeMap = $templateTypeMap; $this->callSiteVarianceMap = $callSiteVarianceMap; } public function getOriginalReflection() : \PHPStan\Reflection\ExtendedPropertyReflection { return $this->reflection; } public function getDeclaringClass() : \PHPStan\Reflection\ClassReflection { return $this->reflection->getDeclaringClass(); } public function getDeclaringTrait() : ?\PHPStan\Reflection\ClassReflection { if ($this->reflection instanceof PhpPropertyReflection) { return $this->reflection->getDeclaringTrait(); } return null; } public function isStatic() : bool { return $this->reflection->isStatic(); } public function isPrivate() : bool { return $this->reflection->isPrivate(); } public function isPublic() : bool { return $this->reflection->isPublic(); } public function getReadableType() : Type { $type = $this->readableType; if ($type !== null) { return $type; } $type = TemplateTypeHelper::resolveTemplateTypes($this->reflection->getReadableType(), $this->templateTypeMap, $this->callSiteVarianceMap, TemplateTypeVariance::createCovariant()); $type = TemplateTypeHelper::resolveTemplateTypes($type, $this->templateTypeMap, $this->callSiteVarianceMap, TemplateTypeVariance::createCovariant()); $this->readableType = $type; return $type; } public function getWritableType() : Type { $type = $this->writableType; if ($type !== null) { return $type; } $type = TemplateTypeHelper::resolveTemplateTypes($this->reflection->getWritableType(), $this->templateTypeMap, $this->callSiteVarianceMap, TemplateTypeVariance::createContravariant()); $type = TemplateTypeHelper::resolveTemplateTypes($type, $this->templateTypeMap, $this->callSiteVarianceMap, TemplateTypeVariance::createContravariant()); $this->writableType = $type; return $type; } public function canChangeTypeAfterAssignment() : bool { return $this->reflection->canChangeTypeAfterAssignment(); } public function isReadable() : bool { return $this->reflection->isReadable(); } public function isWritable() : bool { return $this->reflection->isWritable(); } public function getDocComment() : ?string { return $this->reflection->getDocComment(); } public function isDeprecated() : TrinaryLogic { return $this->reflection->isDeprecated(); } public function getDeprecatedDescription() : ?string { return $this->reflection->getDeprecatedDescription(); } public function isInternal() : TrinaryLogic { return $this->reflection->isInternal(); } } <?php declare (strict_types=1); namespace PHPStan\Reflection; use _PHPStan_7d8742a37\Nette\Utils\Strings; use PhpParser\Node\Arg; use PhpParser\Node\Expr; use PhpParser\Node\Expr\BinaryOp; use PhpParser\Node\Expr\ClassConstFetch; use PhpParser\Node\Expr\ConstFetch; use PhpParser\Node\Expr\PropertyFetch; use PhpParser\Node\Identifier; use PhpParser\Node\Name; use PhpParser\Node\Scalar\DNumber; use PhpParser\Node\Scalar\LNumber; use PhpParser\Node\Scalar\MagicConst; use PhpParser\Node\Scalar\MagicConst\Dir; use PhpParser\Node\Scalar\MagicConst\File; use PhpParser\Node\Scalar\MagicConst\Line; use PhpParser\Node\Scalar\String_; use PHPStan\Analyser\ConstantResolver; use PHPStan\Analyser\OutOfClassScope; use PHPStan\DependencyInjection\Type\OperatorTypeSpecifyingExtensionRegistryProvider; use PHPStan\Node\Expr\TypeExpr; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\ReflectionProvider\ReflectionProviderProvider; use PHPStan\ShouldNotHappenException; use PHPStan\Type\Accessory\AccessoryArrayListType; use PHPStan\Type\Accessory\AccessoryLiteralStringType; use PHPStan\Type\Accessory\AccessoryLowercaseStringType; use PHPStan\Type\Accessory\AccessoryNonEmptyStringType; use PHPStan\Type\Accessory\AccessoryNonFalsyStringType; use PHPStan\Type\Accessory\AccessoryNumericStringType; use PHPStan\Type\Accessory\AccessoryUppercaseStringType; use PHPStan\Type\Accessory\NonEmptyArrayType; use PHPStan\Type\ArrayType; use PHPStan\Type\BenevolentUnionType; use PHPStan\Type\BooleanType; use PHPStan\Type\ClassStringType; use PHPStan\Type\Constant\ConstantArrayType; use PHPStan\Type\Constant\ConstantArrayTypeBuilder; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantFloatType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\Constant\OversizedArrayBuilder; use PHPStan\Type\ConstantScalarType; use PHPStan\Type\ConstantTypeHelper; use PHPStan\Type\Enum\EnumCaseObjectType; use PHPStan\Type\ErrorType; use PHPStan\Type\FloatType; use PHPStan\Type\GeneralizePrecision; use PHPStan\Type\Generic\GenericClassStringType; use PHPStan\Type\Generic\TemplateType; use PHPStan\Type\IntegerRangeType; use PHPStan\Type\IntegerType; use PHPStan\Type\IntersectionType; use PHPStan\Type\MixedType; use PHPStan\Type\NeverType; use PHPStan\Type\NullType; use PHPStan\Type\ObjectType; use PHPStan\Type\ObjectWithoutClassType; use PHPStan\Type\StaticType; use PHPStan\Type\StringType; use PHPStan\Type\ThisType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\TypehintHelper; use PHPStan\Type\TypeResult; use PHPStan\Type\TypeTraverser; use PHPStan\Type\TypeUtils; use PHPStan\Type\TypeWithClassName; use PHPStan\Type\UnionType; use function array_key_exists; use function array_keys; use function array_merge; use function assert; use function ceil; use function count; use function dirname; use function floor; use function in_array; use function intval; use function is_finite; use function is_float; use function is_int; use function is_numeric; use function max; use function min; use function sprintf; use function strtolower; use const INF; final class InitializerExprTypeResolver { /** * @var ConstantResolver */ private $constantResolver; /** * @var ReflectionProviderProvider */ private $reflectionProviderProvider; /** * @var PhpVersion */ private $phpVersion; /** * @var OperatorTypeSpecifyingExtensionRegistryProvider */ private $operatorTypeSpecifyingExtensionRegistryProvider; /** * @var OversizedArrayBuilder */ private $oversizedArrayBuilder; /** * @var bool */ private $usePathConstantsAsConstantString; public const CALCULATE_SCALARS_LIMIT = 128; /** @var array<string, true> */ private $currentlyResolvingClassConstant = []; public function __construct(ConstantResolver $constantResolver, ReflectionProviderProvider $reflectionProviderProvider, PhpVersion $phpVersion, OperatorTypeSpecifyingExtensionRegistryProvider $operatorTypeSpecifyingExtensionRegistryProvider, OversizedArrayBuilder $oversizedArrayBuilder, bool $usePathConstantsAsConstantString = \false) { $this->constantResolver = $constantResolver; $this->reflectionProviderProvider = $reflectionProviderProvider; $this->phpVersion = $phpVersion; $this->operatorTypeSpecifyingExtensionRegistryProvider = $operatorTypeSpecifyingExtensionRegistryProvider; $this->oversizedArrayBuilder = $oversizedArrayBuilder; $this->usePathConstantsAsConstantString = $usePathConstantsAsConstantString; } /** @api */ public function getType(Expr $expr, \PHPStan\Reflection\InitializerExprContext $context) : Type { if ($expr instanceof TypeExpr) { return $expr->getExprType(); } if ($expr instanceof LNumber) { return new ConstantIntegerType($expr->value); } if ($expr instanceof DNumber) { return new ConstantFloatType($expr->value); } if ($expr instanceof String_) { return new ConstantStringType($expr->value); } if ($expr instanceof ConstFetch) { $constName = (string) $expr->name; $loweredConstName = strtolower($constName); if ($loweredConstName === 'true') { return new ConstantBooleanType(\true); } elseif ($loweredConstName === 'false') { return new ConstantBooleanType(\false); } elseif ($loweredConstName === 'null') { return new NullType(); } $constant = $this->constantResolver->resolveConstant($expr->name, $context); if ($constant !== null) { return $constant; } return new ErrorType(); } if ($expr instanceof File) { $file = $context->getFile(); if ($file === null) { return new StringType(); } $stringType = new ConstantStringType($file); return $this->usePathConstantsAsConstantString ? $stringType : $stringType->generalize(GeneralizePrecision::moreSpecific()); } if ($expr instanceof Dir) { $file = $context->getFile(); if ($file === null) { return new StringType(); } $stringType = new ConstantStringType(dirname($file)); return $this->usePathConstantsAsConstantString ? $stringType : $stringType->generalize(GeneralizePrecision::moreSpecific()); } if ($expr instanceof Line) { return new ConstantIntegerType($expr->getStartLine()); } if ($expr instanceof Expr\New_) { if ($expr->class instanceof Name) { return new ObjectType((string) $expr->class); } return new ObjectWithoutClassType(); } if ($expr instanceof Expr\Array_) { return $this->getArrayType($expr, function (Expr $expr) use($context) : Type { return $this->getType($expr, $context); }); } if ($expr instanceof Expr\ArrayDimFetch && $expr->dim !== null) { $var = $this->getType($expr->var, $context); $dim = $this->getType($expr->dim, $context); return $var->getOffsetValueType($dim); } if ($expr instanceof ClassConstFetch && $expr->name instanceof Identifier) { return $this->getClassConstFetchType($expr->class, $expr->name->toString(), $context->getClassName(), function (Expr $expr) use($context) : Type { return $this->getType($expr, $context); }); } if ($expr instanceof Expr\UnaryPlus) { return $this->getType($expr->expr, $context)->toNumber(); } if ($expr instanceof Expr\UnaryMinus) { return $this->getUnaryMinusType($expr->expr, function (Expr $expr) use($context) : Type { return $this->getType($expr, $context); }); } if ($expr instanceof Expr\BinaryOp\Coalesce) { $leftType = $this->getType($expr->left, $context); $rightType = $this->getType($expr->right, $context); return TypeCombinator::union(TypeCombinator::removeNull($leftType), $rightType); } if ($expr instanceof Expr\Ternary) { $condType = $this->getType($expr->cond, $context); $elseType = $this->getType($expr->else, $context); if ($expr->if === null) { return TypeCombinator::union(TypeCombinator::removeFalsey($condType), $elseType); } $ifType = $this->getType($expr->if, $context); return TypeCombinator::union(TypeCombinator::removeFalsey($ifType), $elseType); } if ($expr instanceof Expr\FuncCall && $expr->name instanceof Name && $expr->name->toLowerString() === 'constant') { $firstArg = $expr->args[0] ?? null; if ($firstArg instanceof Arg && $firstArg->value instanceof String_) { $constant = $this->constantResolver->resolvePredefinedConstant($firstArg->value->value); if ($constant !== null) { return $constant; } } } if ($expr instanceof Expr\BooleanNot) { $exprBooleanType = $this->getType($expr->expr, $context)->toBoolean(); if ($exprBooleanType instanceof ConstantBooleanType) { return new ConstantBooleanType(!$exprBooleanType->getValue()); } return new BooleanType(); } if ($expr instanceof Expr\BitwiseNot) { return $this->getBitwiseNotType($expr->expr, function (Expr $expr) use($context) : Type { return $this->getType($expr, $context); }); } if ($expr instanceof Expr\BinaryOp\Concat) { return $this->getConcatType($expr->left, $expr->right, function (Expr $expr) use($context) : Type { return $this->getType($expr, $context); }); } if ($expr instanceof Expr\BinaryOp\BitwiseAnd) { return $this->getBitwiseAndType($expr->left, $expr->right, function (Expr $expr) use($context) : Type { return $this->getType($expr, $context); }); } if ($expr instanceof Expr\BinaryOp\BitwiseOr) { return $this->getBitwiseOrType($expr->left, $expr->right, function (Expr $expr) use($context) : Type { return $this->getType($expr, $context); }); } if ($expr instanceof Expr\BinaryOp\BitwiseXor) { return $this->getBitwiseXorType($expr->left, $expr->right, function (Expr $expr) use($context) : Type { return $this->getType($expr, $context); }); } if ($expr instanceof Expr\BinaryOp\Spaceship) { return $this->getSpaceshipType($expr->left, $expr->right, function (Expr $expr) use($context) : Type { return $this->getType($expr, $context); }); } if ($expr instanceof Expr\BinaryOp\BooleanAnd || $expr instanceof Expr\BinaryOp\LogicalAnd || $expr instanceof Expr\BinaryOp\BooleanOr || $expr instanceof Expr\BinaryOp\LogicalOr) { return new BooleanType(); } if ($expr instanceof Expr\BinaryOp\Div) { return $this->getDivType($expr->left, $expr->right, function (Expr $expr) use($context) : Type { return $this->getType($expr, $context); }); } if ($expr instanceof Expr\BinaryOp\Mod) { return $this->getModType($expr->left, $expr->right, function (Expr $expr) use($context) : Type { return $this->getType($expr, $context); }); } if ($expr instanceof Expr\BinaryOp\Plus) { return $this->getPlusType($expr->left, $expr->right, function (Expr $expr) use($context) : Type { return $this->getType($expr, $context); }); } if ($expr instanceof Expr\BinaryOp\Minus) { return $this->getMinusType($expr->left, $expr->right, function (Expr $expr) use($context) : Type { return $this->getType($expr, $context); }); } if ($expr instanceof Expr\BinaryOp\Mul) { return $this->getMulType($expr->left, $expr->right, function (Expr $expr) use($context) : Type { return $this->getType($expr, $context); }); } if ($expr instanceof Expr\BinaryOp\Pow) { return $this->getPowType($expr->left, $expr->right, function (Expr $expr) use($context) : Type { return $this->getType($expr, $context); }); } if ($expr instanceof Expr\BinaryOp\ShiftLeft) { return $this->getShiftLeftType($expr->left, $expr->right, function (Expr $expr) use($context) : Type { return $this->getType($expr, $context); }); } if ($expr instanceof Expr\BinaryOp\ShiftRight) { return $this->getShiftRightType($expr->left, $expr->right, function (Expr $expr) use($context) : Type { return $this->getType($expr, $context); }); } if ($expr instanceof BinaryOp\Identical) { return $this->resolveIdenticalType($this->getType($expr->left, $context), $this->getType($expr->right, $context))->type; } if ($expr instanceof BinaryOp\NotIdentical) { return $this->getType(new Expr\BooleanNot(new BinaryOp\Identical($expr->left, $expr->right)), $context); } if ($expr instanceof BinaryOp\Equal) { return $this->resolveEqualType($this->getType($expr->left, $context), $this->getType($expr->right, $context))->type; } if ($expr instanceof BinaryOp\NotEqual) { return $this->getType(new Expr\BooleanNot(new BinaryOp\Equal($expr->left, $expr->right)), $context); } if ($expr instanceof Expr\BinaryOp\Smaller) { return $this->getType($expr->left, $context)->isSmallerThan($this->getType($expr->right, $context))->toBooleanType(); } if ($expr instanceof Expr\BinaryOp\SmallerOrEqual) { return $this->getType($expr->left, $context)->isSmallerThanOrEqual($this->getType($expr->right, $context))->toBooleanType(); } if ($expr instanceof Expr\BinaryOp\Greater) { return $this->getType($expr->right, $context)->isSmallerThan($this->getType($expr->left, $context))->toBooleanType(); } if ($expr instanceof Expr\BinaryOp\GreaterOrEqual) { return $this->getType($expr->right, $context)->isSmallerThanOrEqual($this->getType($expr->left, $context))->toBooleanType(); } if ($expr instanceof Expr\BinaryOp\LogicalXor) { $leftBooleanType = $this->getType($expr->left, $context)->toBoolean(); $rightBooleanType = $this->getType($expr->right, $context)->toBoolean(); if ($leftBooleanType instanceof ConstantBooleanType && $rightBooleanType instanceof ConstantBooleanType) { return new ConstantBooleanType($leftBooleanType->getValue() xor $rightBooleanType->getValue()); } return new BooleanType(); } if ($expr instanceof MagicConst\Class_) { if ($context->getTraitName() !== null) { return TypeCombinator::intersect(new ClassStringType(), new AccessoryLiteralStringType()); } if ($context->getClassName() === null) { return new ConstantStringType(''); } return new ConstantStringType($context->getClassName(), \true); } if ($expr instanceof MagicConst\Namespace_) { if ($context->getTraitName() !== null) { return TypeCombinator::intersect(new StringType(), new AccessoryLiteralStringType()); } return new ConstantStringType($context->getNamespace() ?? ''); } if ($expr instanceof MagicConst\Method) { return new ConstantStringType($context->getMethod() ?? ''); } if ($expr instanceof MagicConst\Function_) { return new ConstantStringType($context->getFunction() ?? ''); } if ($expr instanceof MagicConst\Trait_) { if ($context->getTraitName() === null) { return new ConstantStringType(''); } return new ConstantStringType($context->getTraitName(), \true); } if ($expr instanceof PropertyFetch && $expr->name instanceof Identifier) { $fetchedOnType = $this->getType($expr->var, $context); if (!$fetchedOnType->hasProperty($expr->name->name)->yes()) { return new ErrorType(); } return $fetchedOnType->getProperty($expr->name->name, new OutOfClassScope())->getReadableType(); } return new MixedType(); } /** * @param callable(Expr): Type $getTypeCallback */ public function getConcatType(Expr $left, Expr $right, callable $getTypeCallback) : Type { $leftType = $getTypeCallback($left); $rightType = $getTypeCallback($right); return $this->resolveConcatType($leftType, $rightType); } public function resolveConcatType(Type $left, Type $right) : Type { $leftStringType = $left->toString(); $rightStringType = $right->toString(); if (TypeCombinator::union($leftStringType, $rightStringType) instanceof ErrorType) { return new ErrorType(); } if ($leftStringType instanceof ConstantStringType && $leftStringType->getValue() === '') { return $rightStringType; } if ($rightStringType instanceof ConstantStringType && $rightStringType->getValue() === '') { return $leftStringType; } if ($leftStringType instanceof ConstantStringType && $rightStringType instanceof ConstantStringType) { return $leftStringType->append($rightStringType); } $leftConstantStrings = $leftStringType->getConstantStrings(); $rightConstantStrings = $rightStringType->getConstantStrings(); $combinedConstantStringsCount = count($leftConstantStrings) * count($rightConstantStrings); // we limit the number of union-types for performance reasons if ($combinedConstantStringsCount > 0 && $combinedConstantStringsCount <= 16) { $strings = []; foreach ($leftConstantStrings as $leftConstantString) { if ($leftConstantString->getValue() === '') { $strings = array_merge($strings, $rightConstantStrings); continue; } foreach ($rightConstantStrings as $rightConstantString) { if ($rightConstantString->getValue() === '') { $strings[] = $leftConstantString; continue; } $strings[] = $leftConstantString->append($rightConstantString); } } if (count($strings) > 0) { return TypeCombinator::union(...$strings); } } $accessoryTypes = []; if ($leftStringType->isNonEmptyString()->and($rightStringType->isNonEmptyString())->yes()) { $accessoryTypes[] = new AccessoryNonFalsyStringType(); } elseif ($leftStringType->isNonFalsyString()->or($rightStringType->isNonFalsyString())->yes()) { $accessoryTypes[] = new AccessoryNonFalsyStringType(); } elseif ($leftStringType->isNonEmptyString()->or($rightStringType->isNonEmptyString())->yes()) { $accessoryTypes[] = new AccessoryNonEmptyStringType(); } if ($leftStringType->isLiteralString()->and($rightStringType->isLiteralString())->yes()) { $accessoryTypes[] = new AccessoryLiteralStringType(); } if ($leftStringType->isLowercaseString()->and($rightStringType->isLowercaseString())->yes()) { $accessoryTypes[] = new AccessoryLowercaseStringType(); } if ($leftStringType->isUppercaseString()->and($rightStringType->isUppercaseString())->yes()) { $accessoryTypes[] = new AccessoryUppercaseStringType(); } $leftNumericStringNonEmpty = TypeCombinator::remove($leftStringType, new ConstantStringType('')); if ($leftNumericStringNonEmpty->isNumericString()->yes()) { $allRightConstantsZeroOrMore = \false; foreach ($rightConstantStrings as $rightConstantString) { if ($rightConstantString->getValue() === '') { continue; } if (!is_numeric($rightConstantString->getValue()) || Strings::match($rightConstantString->getValue(), '#^[0-9]+$#') === null) { $allRightConstantsZeroOrMore = \false; break; } $allRightConstantsZeroOrMore = \true; } $zeroOrMoreInteger = IntegerRangeType::fromInterval(0, null); $nonNegativeRight = $allRightConstantsZeroOrMore || $zeroOrMoreInteger->isSuperTypeOf($right)->yes(); if ($nonNegativeRight) { $accessoryTypes[] = new AccessoryNumericStringType(); } } if (count($accessoryTypes) > 0) { $accessoryTypes[] = new StringType(); return new IntersectionType($accessoryTypes); } return new StringType(); } /** * @param callable(Expr): Type $getTypeCallback */ public function getArrayType(Expr\Array_ $expr, callable $getTypeCallback) : Type { if (count($expr->items) > ConstantArrayTypeBuilder::ARRAY_COUNT_LIMIT) { return $this->oversizedArrayBuilder->build($expr, $getTypeCallback); } $arrayBuilder = ConstantArrayTypeBuilder::createEmpty(); $isList = null; foreach ($expr->items as $arrayItem) { if ($arrayItem === null) { continue; } $valueType = $getTypeCallback($arrayItem->value); if ($arrayItem->unpack) { $constantArrays = $valueType->getConstantArrays(); if (count($constantArrays) === 1) { $constantArrayType = $constantArrays[0]; $hasStringKey = \false; foreach ($constantArrayType->getKeyTypes() as $keyType) { if ($keyType->isString()->yes()) { $hasStringKey = \true; break; } } foreach ($constantArrayType->getValueTypes() as $i => $innerValueType) { if ($hasStringKey && $this->phpVersion->supportsArrayUnpackingWithStringKeys()) { $arrayBuilder->setOffsetValueType($constantArrayType->getKeyTypes()[$i], $innerValueType, $constantArrayType->isOptionalKey($i)); } else { $arrayBuilder->setOffsetValueType(null, $innerValueType, $constantArrayType->isOptionalKey($i)); } } } else { $arrayBuilder->degradeToGeneralArray(); if ($this->phpVersion->supportsArrayUnpackingWithStringKeys() && !$valueType->getIterableKeyType()->isString()->no()) { $isList = \false; $offsetType = $valueType->getIterableKeyType(); } else { $isList = $isList ?? $arrayBuilder->isList(); $offsetType = new IntegerType(); } $arrayBuilder->setOffsetValueType($offsetType, $valueType->getIterableValueType(), !$valueType->isIterableAtLeastOnce()->yes()); } } else { $arrayBuilder->setOffsetValueType($arrayItem->key !== null ? $getTypeCallback($arrayItem->key) : null, $valueType); } } $arrayType = $arrayBuilder->getArray(); if ($isList === \true) { return AccessoryArrayListType::intersectWith($arrayType); } return $arrayType; } /** * @param callable(Expr): Type $getTypeCallback */ public function getBitwiseAndType(Expr $left, Expr $right, callable $getTypeCallback) : Type { $leftType = $getTypeCallback($left); $rightType = $getTypeCallback($right); if ($leftType instanceof NeverType || $rightType instanceof NeverType) { return $this->getNeverType($leftType, $rightType); } $leftTypes = $leftType->getConstantScalarTypes(); $rightTypes = $rightType->getConstantScalarTypes(); $leftTypesCount = count($leftTypes); $rightTypesCount = count($rightTypes); if ($leftTypesCount > 0 && $rightTypesCount > 0) { $resultTypes = []; $generalize = $leftTypesCount * $rightTypesCount > self::CALCULATE_SCALARS_LIMIT; foreach ($leftTypes as $leftTypeInner) { foreach ($rightTypes as $rightTypeInner) { if ($leftTypeInner instanceof ConstantStringType && $rightTypeInner instanceof ConstantStringType) { $resultType = $this->getTypeFromValue($leftTypeInner->getValue() & $rightTypeInner->getValue()); } else { $leftNumberType = $leftTypeInner->toNumber(); $rightNumberType = $rightTypeInner->toNumber(); if ($leftNumberType instanceof ErrorType || $rightNumberType instanceof ErrorType) { return new ErrorType(); } if (!$leftNumberType instanceof ConstantScalarType || !$rightNumberType instanceof ConstantScalarType) { throw new ShouldNotHappenException(); } $resultType = $this->getTypeFromValue($leftNumberType->getValue() & $rightNumberType->getValue()); } if ($generalize) { $resultType = $resultType->generalize(GeneralizePrecision::lessSpecific()); } $resultTypes[] = $resultType; } } return TypeCombinator::union(...$resultTypes); } if ($leftType->isString()->yes() && $rightType->isString()->yes()) { return new StringType(); } $leftNumberType = $leftType->toNumber(); $rightNumberType = $rightType->toNumber(); if ($leftNumberType instanceof ErrorType || $rightNumberType instanceof ErrorType) { return new ErrorType(); } if ($rightNumberType instanceof ConstantIntegerType && $rightNumberType->getValue() >= 0) { return IntegerRangeType::fromInterval(0, $rightNumberType->getValue()); } if ($leftNumberType instanceof ConstantIntegerType && $leftNumberType->getValue() >= 0) { return IntegerRangeType::fromInterval(0, $leftNumberType->getValue()); } return new IntegerType(); } /** * @param callable(Expr): Type $getTypeCallback */ public function getBitwiseOrType(Expr $left, Expr $right, callable $getTypeCallback) : Type { $leftType = $getTypeCallback($left); $rightType = $getTypeCallback($right); if ($leftType instanceof NeverType || $rightType instanceof NeverType) { return $this->getNeverType($leftType, $rightType); } $leftTypes = $leftType->getConstantScalarTypes(); $rightTypes = $rightType->getConstantScalarTypes(); $leftTypesCount = count($leftTypes); $rightTypesCount = count($rightTypes); if ($leftTypesCount > 0 && $rightTypesCount > 0) { $resultTypes = []; $generalize = $leftTypesCount * $rightTypesCount > self::CALCULATE_SCALARS_LIMIT; foreach ($leftTypes as $leftTypeInner) { foreach ($rightTypes as $rightTypeInner) { if ($leftTypeInner instanceof ConstantStringType && $rightTypeInner instanceof ConstantStringType) { $resultType = $this->getTypeFromValue($leftTypeInner->getValue() | $rightTypeInner->getValue()); } else { $leftNumberType = $leftTypeInner->toNumber(); $rightNumberType = $rightTypeInner->toNumber(); if ($leftNumberType instanceof ErrorType || $rightNumberType instanceof ErrorType) { return new ErrorType(); } if (!$leftNumberType instanceof ConstantScalarType || !$rightNumberType instanceof ConstantScalarType) { throw new ShouldNotHappenException(); } $resultType = $this->getTypeFromValue($leftNumberType->getValue() | $rightNumberType->getValue()); } if ($generalize) { $resultType = $resultType->generalize(GeneralizePrecision::lessSpecific()); } $resultTypes[] = $resultType; } } return TypeCombinator::union(...$resultTypes); } if ($leftType->isString()->yes() && $rightType->isString()->yes()) { return new StringType(); } if (TypeCombinator::union($leftType->toNumber(), $rightType->toNumber()) instanceof ErrorType) { return new ErrorType(); } return new IntegerType(); } /** * @param callable(Expr): Type $getTypeCallback */ public function getBitwiseXorType(Expr $left, Expr $right, callable $getTypeCallback) : Type { $leftType = $getTypeCallback($left); $rightType = $getTypeCallback($right); if ($leftType instanceof NeverType || $rightType instanceof NeverType) { return $this->getNeverType($leftType, $rightType); } $leftTypes = $leftType->getConstantScalarTypes(); $rightTypes = $rightType->getConstantScalarTypes(); $leftTypesCount = count($leftTypes); $rightTypesCount = count($rightTypes); if ($leftTypesCount > 0 && $rightTypesCount > 0) { $resultTypes = []; $generalize = $leftTypesCount * $rightTypesCount > self::CALCULATE_SCALARS_LIMIT; foreach ($leftTypes as $leftTypeInner) { foreach ($rightTypes as $rightTypeInner) { if ($leftTypeInner instanceof ConstantStringType && $rightTypeInner instanceof ConstantStringType) { $resultType = $this->getTypeFromValue($leftTypeInner->getValue() ^ $rightTypeInner->getValue()); } else { $leftNumberType = $leftTypeInner->toNumber(); $rightNumberType = $rightTypeInner->toNumber(); if ($leftNumberType instanceof ErrorType || $rightNumberType instanceof ErrorType) { return new ErrorType(); } if (!$leftNumberType instanceof ConstantScalarType || !$rightNumberType instanceof ConstantScalarType) { throw new ShouldNotHappenException(); } $resultType = $this->getTypeFromValue($leftNumberType->getValue() ^ $rightNumberType->getValue()); } if ($generalize) { $resultType = $resultType->generalize(GeneralizePrecision::lessSpecific()); } $resultTypes[] = $resultType; } } return TypeCombinator::union(...$resultTypes); } if ($leftType->isString()->yes() && $rightType->isString()->yes()) { return new StringType(); } if (TypeCombinator::union($leftType->toNumber(), $rightType->toNumber()) instanceof ErrorType) { return new ErrorType(); } return new IntegerType(); } /** * @param callable(Expr): Type $getTypeCallback */ public function getSpaceshipType(Expr $left, Expr $right, callable $getTypeCallback) : Type { $callbackLeftType = $getTypeCallback($left); $callbackRightType = $getTypeCallback($right); if ($callbackLeftType instanceof NeverType || $callbackRightType instanceof NeverType) { return $this->getNeverType($callbackLeftType, $callbackRightType); } $leftTypes = $callbackLeftType->getConstantScalarTypes(); $rightTypes = $callbackRightType->getConstantScalarTypes(); $leftTypesCount = count($leftTypes); $rightTypesCount = count($rightTypes); if ($leftTypesCount > 0 && $rightTypesCount > 0 && $leftTypesCount * $rightTypesCount <= self::CALCULATE_SCALARS_LIMIT) { $resultTypes = []; foreach ($leftTypes as $leftType) { foreach ($rightTypes as $rightType) { $leftValue = $leftType->getValue(); $rightValue = $rightType->getValue(); $resultType = $this->getTypeFromValue($leftValue <=> $rightValue); $resultTypes[] = $resultType; } } return TypeCombinator::union(...$resultTypes); } return IntegerRangeType::fromInterval(-1, 1); } /** * @param callable(Expr): Type $getTypeCallback */ public function getDivType(Expr $left, Expr $right, callable $getTypeCallback) : Type { $leftType = $getTypeCallback($left); $rightType = $getTypeCallback($right); $leftTypes = $leftType->getConstantScalarTypes(); $rightTypes = $rightType->getConstantScalarTypes(); $leftTypesCount = count($leftTypes); $rightTypesCount = count($rightTypes); if ($leftTypesCount > 0 && $rightTypesCount > 0) { $resultTypes = []; $generalize = $leftTypesCount * $rightTypesCount > self::CALCULATE_SCALARS_LIMIT; foreach ($leftTypes as $leftTypeInner) { foreach ($rightTypes as $rightTypeInner) { $leftNumberType = $leftTypeInner->toNumber(); $rightNumberType = $rightTypeInner->toNumber(); if ($leftNumberType instanceof ErrorType || $rightNumberType instanceof ErrorType) { return new ErrorType(); } if (!$leftNumberType instanceof ConstantScalarType || !$rightNumberType instanceof ConstantScalarType) { throw new ShouldNotHappenException(); } if (in_array($rightNumberType->getValue(), [0, 0.0], \true)) { return new ErrorType(); } $resultType = $this->getTypeFromValue($leftNumberType->getValue() / $rightNumberType->getValue()); // @phpstan-ignore binaryOp.invalid if ($generalize) { $resultType = $resultType->generalize(GeneralizePrecision::lessSpecific()); } $resultTypes[] = $resultType; } } return TypeCombinator::union(...$resultTypes); } $rightScalarValues = $rightType->toNumber()->getConstantScalarValues(); foreach ($rightScalarValues as $scalarValue) { if ($scalarValue === 0 || $scalarValue === 0.0) { return new ErrorType(); } } return $this->resolveCommonMath(new BinaryOp\Div($left, $right), $leftType, $rightType); } /** * @param callable(Expr): Type $getTypeCallback */ public function getModType(Expr $left, Expr $right, callable $getTypeCallback) : Type { $leftType = $getTypeCallback($left); $rightType = $getTypeCallback($right); if ($leftType instanceof NeverType || $rightType instanceof NeverType) { return $this->getNeverType($leftType, $rightType); } if ($leftType->toNumber() instanceof ErrorType || $rightType->toNumber() instanceof ErrorType) { return new ErrorType(); } $leftTypes = $leftType->getConstantScalarTypes(); $rightTypes = $rightType->getConstantScalarTypes(); $leftTypesCount = count($leftTypes); $rightTypesCount = count($rightTypes); if ($leftTypesCount > 0 && $rightTypesCount > 0) { $resultTypes = []; $generalize = $leftTypesCount * $rightTypesCount > self::CALCULATE_SCALARS_LIMIT; foreach ($leftTypes as $leftTypeInner) { foreach ($rightTypes as $rightTypeInner) { $leftNumberType = $leftTypeInner->toNumber(); $rightNumberType = $rightTypeInner->toNumber(); if ($leftNumberType instanceof ErrorType || $rightNumberType instanceof ErrorType) { return new ErrorType(); } if (!$leftNumberType instanceof ConstantScalarType || !$rightNumberType instanceof ConstantScalarType) { throw new ShouldNotHappenException(); } $rightIntegerValue = (int) $rightNumberType->getValue(); if ($rightIntegerValue === 0) { return new ErrorType(); } $resultType = $this->getTypeFromValue((int) $leftNumberType->getValue() % $rightIntegerValue); if ($generalize) { $resultType = $resultType->generalize(GeneralizePrecision::lessSpecific()); } $resultTypes[] = $resultType; } } return TypeCombinator::union(...$resultTypes); } $integerType = $rightType->toInteger(); if ($integerType instanceof ConstantIntegerType && $integerType->getValue() === 1) { return new ConstantIntegerType(0); } $rightScalarValues = $rightType->toNumber()->getConstantScalarValues(); foreach ($rightScalarValues as $scalarValue) { if ($scalarValue === 0 || $scalarValue === 0.0) { return new ErrorType(); } } $positiveInt = IntegerRangeType::fromInterval(0, null); if ($rightType->isInteger()->yes()) { $rangeMin = null; $rangeMax = null; if ($rightType instanceof IntegerRangeType) { $rangeMax = $rightType->getMax() !== null ? $rightType->getMax() - 1 : null; } elseif ($rightType instanceof ConstantIntegerType) { $rangeMax = $rightType->getValue() - 1; } elseif ($rightType instanceof UnionType) { foreach ($rightType->getTypes() as $type) { if ($type instanceof IntegerRangeType) { if ($type->getMax() === null) { $rangeMax = null; } else { $rangeMax = max($rangeMax, $type->getMax()); } } elseif ($type instanceof ConstantIntegerType) { $rangeMax = max($rangeMax, $type->getValue() - 1); } } } if ($positiveInt->isSuperTypeOf($leftType)->yes()) { $rangeMin = 0; } elseif ($rangeMax !== null) { $rangeMin = $rangeMax * -1; } return IntegerRangeType::fromInterval($rangeMin, $rangeMax); } elseif ($positiveInt->isSuperTypeOf($leftType)->yes()) { return IntegerRangeType::fromInterval(0, null); } return new IntegerType(); } /** * @param callable(Expr): Type $getTypeCallback */ public function getPlusType(Expr $left, Expr $right, callable $getTypeCallback) : Type { $leftType = $getTypeCallback($left); $rightType = $getTypeCallback($right); if ($leftType instanceof NeverType || $rightType instanceof NeverType) { return $this->getNeverType($leftType, $rightType); } $leftTypes = $leftType->getConstantScalarTypes(); $rightTypes = $rightType->getConstantScalarTypes(); $leftTypesCount = count($leftTypes); $rightTypesCount = count($rightTypes); if ($leftTypesCount > 0 && $rightTypesCount > 0) { $resultTypes = []; $generalize = $leftTypesCount * $rightTypesCount > self::CALCULATE_SCALARS_LIMIT; foreach ($leftTypes as $leftTypeInner) { foreach ($rightTypes as $rightTypeInner) { $leftNumberType = $leftTypeInner->toNumber(); $rightNumberType = $rightTypeInner->toNumber(); if ($leftNumberType instanceof ErrorType || $rightNumberType instanceof ErrorType) { return new ErrorType(); } if (!$leftNumberType instanceof ConstantScalarType || !$rightNumberType instanceof ConstantScalarType) { throw new ShouldNotHappenException(); } $resultType = $this->getTypeFromValue($leftNumberType->getValue() + $rightNumberType->getValue()); if ($generalize) { $resultType = $resultType->generalize(GeneralizePrecision::lessSpecific()); } $resultTypes[] = $resultType; } } return TypeCombinator::union(...$resultTypes); } $leftConstantArrays = $leftType->getConstantArrays(); $rightConstantArrays = $rightType->getConstantArrays(); $leftCount = count($leftConstantArrays); $rightCount = count($rightConstantArrays); if ($leftCount > 0 && $rightCount > 0 && $leftCount + $rightCount < ConstantArrayTypeBuilder::ARRAY_COUNT_LIMIT) { $resultTypes = []; foreach ($rightConstantArrays as $rightConstantArray) { foreach ($leftConstantArrays as $leftConstantArray) { $newArrayBuilder = ConstantArrayTypeBuilder::createFromConstantArray($rightConstantArray); foreach ($leftConstantArray->getKeyTypes() as $i => $leftKeyType) { $optional = $leftConstantArray->isOptionalKey($i); $valueType = $leftConstantArray->getOffsetValueType($leftKeyType); if (!$optional) { if ($rightConstantArray->hasOffsetValueType($leftKeyType)->maybe()) { $valueType = TypeCombinator::union($valueType, $rightConstantArray->getOffsetValueType($leftKeyType)); } } $newArrayBuilder->setOffsetValueType($leftKeyType, $valueType, $optional); } $resultTypes[] = $newArrayBuilder->getArray(); } } return TypeCombinator::union(...$resultTypes); } $leftIsArray = $leftType->isArray(); $rightIsArray = $rightType->isArray(); if ($leftIsArray->yes() && $rightIsArray->yes()) { if ($leftType->getIterableKeyType()->equals($rightType->getIterableKeyType())) { // to preserve BenevolentUnionType $keyType = $leftType->getIterableKeyType(); } else { $keyTypes = []; foreach ([$leftType->getIterableKeyType(), $rightType->getIterableKeyType()] as $keyType) { $keyTypes[] = $keyType; } $keyType = TypeCombinator::union(...$keyTypes); } $arrayType = new ArrayType($keyType, TypeCombinator::union($leftType->getIterableValueType(), $rightType->getIterableValueType())); if ($leftType->isIterableAtLeastOnce()->yes() || $rightType->isIterableAtLeastOnce()->yes()) { $arrayType = TypeCombinator::intersect($arrayType, new NonEmptyArrayType()); } if ($leftType->isList()->yes() && $rightType->isList()->yes()) { $arrayType = AccessoryArrayListType::intersectWith($arrayType); } return $arrayType; } if ($leftType instanceof MixedType && $rightType instanceof MixedType) { if ($leftIsArray->no() && $rightIsArray->no()) { return new BenevolentUnionType([new FloatType(), new IntegerType()]); } return new BenevolentUnionType([new FloatType(), new IntegerType(), new ArrayType(new MixedType(), new MixedType())]); } if ($leftIsArray->yes() && $rightIsArray->no() || $leftIsArray->no() && $rightIsArray->yes()) { return new ErrorType(); } if ($leftIsArray->yes() && $rightIsArray->maybe() || $leftIsArray->maybe() && $rightIsArray->yes()) { $resultType = new ArrayType(new MixedType(), new MixedType()); if ($leftType->isIterableAtLeastOnce()->yes() || $rightType->isIterableAtLeastOnce()->yes()) { return TypeCombinator::intersect($resultType, new NonEmptyArrayType()); } return $resultType; } if ($leftIsArray->maybe() && $rightIsArray->maybe()) { $plusable = new UnionType([new StringType(), new FloatType(), new IntegerType(), new ArrayType(new MixedType(), new MixedType()), new BooleanType()]); $plusableSuperTypeOfLeft = $plusable->isSuperTypeOf($leftType)->yes(); $plusableSuperTypeOfRight = $plusable->isSuperTypeOf($rightType)->yes(); if ($plusableSuperTypeOfLeft && $plusableSuperTypeOfRight) { return TypeCombinator::union($leftType, $rightType); } if ($plusableSuperTypeOfLeft && $rightType instanceof MixedType) { return $leftType; } if ($plusableSuperTypeOfRight && $leftType instanceof MixedType) { return $rightType; } } return $this->resolveCommonMath(new BinaryOp\Plus($left, $right), $leftType, $rightType); } /** * @param callable(Expr): Type $getTypeCallback */ public function getMinusType(Expr $left, Expr $right, callable $getTypeCallback) : Type { $leftType = $getTypeCallback($left); $rightType = $getTypeCallback($right); $leftTypes = $leftType->getConstantScalarTypes(); $rightTypes = $rightType->getConstantScalarTypes(); $leftTypesCount = count($leftTypes); $rightTypesCount = count($rightTypes); if ($leftTypesCount > 0 && $rightTypesCount > 0) { $resultTypes = []; $generalize = $leftTypesCount * $rightTypesCount > self::CALCULATE_SCALARS_LIMIT; foreach ($leftTypes as $leftTypeInner) { foreach ($rightTypes as $rightTypeInner) { $leftNumberType = $leftTypeInner->toNumber(); $rightNumberType = $rightTypeInner->toNumber(); if ($leftNumberType instanceof ErrorType || $rightNumberType instanceof ErrorType) { return new ErrorType(); } if (!$leftNumberType instanceof ConstantScalarType || !$rightNumberType instanceof ConstantScalarType) { throw new ShouldNotHappenException(); } $resultType = $this->getTypeFromValue($leftNumberType->getValue() - $rightNumberType->getValue()); if ($generalize) { $resultType = $resultType->generalize(GeneralizePrecision::lessSpecific()); } $resultTypes[] = $resultType; } } return TypeCombinator::union(...$resultTypes); } return $this->resolveCommonMath(new BinaryOp\Minus($left, $right), $leftType, $rightType); } /** * @param callable(Expr): Type $getTypeCallback */ public function getMulType(Expr $left, Expr $right, callable $getTypeCallback) : Type { $leftType = $getTypeCallback($left); $rightType = $getTypeCallback($right); $leftTypes = $leftType->getConstantScalarTypes(); $rightTypes = $rightType->getConstantScalarTypes(); $leftTypesCount = count($leftTypes); $rightTypesCount = count($rightTypes); if ($leftTypesCount > 0 && $rightTypesCount > 0) { $resultTypes = []; $generalize = $leftTypesCount * $rightTypesCount > self::CALCULATE_SCALARS_LIMIT; foreach ($leftTypes as $leftTypeInner) { foreach ($rightTypes as $rightTypeInner) { $leftNumberType = $leftTypeInner->toNumber(); $rightNumberType = $rightTypeInner->toNumber(); if ($leftNumberType instanceof ErrorType || $rightNumberType instanceof ErrorType) { return new ErrorType(); } if (!$leftNumberType instanceof ConstantScalarType || !$rightNumberType instanceof ConstantScalarType) { throw new ShouldNotHappenException(); } $resultType = $this->getTypeFromValue($leftNumberType->getValue() * $rightNumberType->getValue()); if ($generalize) { $resultType = $resultType->generalize(GeneralizePrecision::lessSpecific()); } $resultTypes[] = $resultType; } } return TypeCombinator::union(...$resultTypes); } $leftNumberType = $leftType->toNumber(); if ($leftNumberType instanceof ConstantIntegerType && $leftNumberType->getValue() === 0) { if ($rightType->isFloat()->yes()) { return new ConstantFloatType(0.0); } return new ConstantIntegerType(0); } $rightNumberType = $rightType->toNumber(); if ($rightNumberType instanceof ConstantIntegerType && $rightNumberType->getValue() === 0) { if ($leftType->isFloat()->yes()) { return new ConstantFloatType(0.0); } return new ConstantIntegerType(0); } return $this->resolveCommonMath(new BinaryOp\Mul($left, $right), $leftType, $rightType); } /** * @param callable(Expr): Type $getTypeCallback */ public function getPowType(Expr $left, Expr $right, callable $getTypeCallback) : Type { $leftType = $getTypeCallback($left); $rightType = $getTypeCallback($right); $exponentiatedTyped = $leftType->exponentiate($rightType); if (!$exponentiatedTyped instanceof ErrorType) { return $exponentiatedTyped; } $extensionSpecified = $this->callOperatorTypeSpecifyingExtensions(new BinaryOp\Pow($left, $right), $leftType, $rightType); if ($extensionSpecified !== null) { return $extensionSpecified; } return new ErrorType(); } /** * @param callable(Expr): Type $getTypeCallback */ public function getShiftLeftType(Expr $left, Expr $right, callable $getTypeCallback) : Type { $leftType = $getTypeCallback($left); $rightType = $getTypeCallback($right); if ($leftType instanceof NeverType || $rightType instanceof NeverType) { return $this->getNeverType($leftType, $rightType); } $leftTypes = $leftType->getConstantScalarTypes(); $rightTypes = $rightType->getConstantScalarTypes(); $leftTypesCount = count($leftTypes); $rightTypesCount = count($rightTypes); if ($leftTypesCount > 0 && $rightTypesCount > 0) { $resultTypes = []; $generalize = $leftTypesCount * $rightTypesCount > self::CALCULATE_SCALARS_LIMIT; foreach ($leftTypes as $leftTypeInner) { foreach ($rightTypes as $rightTypeInner) { $leftNumberType = $leftTypeInner->toNumber(); $rightNumberType = $rightTypeInner->toNumber(); if ($leftNumberType instanceof ErrorType || $rightNumberType instanceof ErrorType) { return new ErrorType(); } if (!$leftNumberType instanceof ConstantScalarType || !$rightNumberType instanceof ConstantScalarType) { throw new ShouldNotHappenException(); } if ($rightNumberType->getValue() < 0) { return new ErrorType(); } $resultType = $this->getTypeFromValue(intval($leftNumberType->getValue()) << intval($rightNumberType->getValue())); if ($generalize) { $resultType = $resultType->generalize(GeneralizePrecision::lessSpecific()); } $resultTypes[] = $resultType; } } return TypeCombinator::union(...$resultTypes); } $leftNumberType = $leftType->toNumber(); $rightNumberType = $rightType->toNumber(); if ($leftNumberType instanceof ErrorType || $rightNumberType instanceof ErrorType) { return new ErrorType(); } return $this->resolveCommonMath(new Expr\BinaryOp\ShiftLeft($left, $right), $leftType, $rightType); } /** * @param callable(Expr): Type $getTypeCallback */ public function getShiftRightType(Expr $left, Expr $right, callable $getTypeCallback) : Type { $leftType = $getTypeCallback($left); $rightType = $getTypeCallback($right); if ($leftType instanceof NeverType || $rightType instanceof NeverType) { return $this->getNeverType($leftType, $rightType); } $leftTypes = $leftType->getConstantScalarTypes(); $rightTypes = $rightType->getConstantScalarTypes(); $leftTypesCount = count($leftTypes); $rightTypesCount = count($rightTypes); if ($leftTypesCount > 0 && $rightTypesCount > 0) { $resultTypes = []; $generalize = $leftTypesCount * $rightTypesCount > self::CALCULATE_SCALARS_LIMIT; foreach ($leftTypes as $leftTypeInner) { foreach ($rightTypes as $rightTypeInner) { $leftNumberType = $leftTypeInner->toNumber(); $rightNumberType = $rightTypeInner->toNumber(); if ($leftNumberType instanceof ErrorType || $rightNumberType instanceof ErrorType) { return new ErrorType(); } if (!$leftNumberType instanceof ConstantScalarType || !$rightNumberType instanceof ConstantScalarType) { throw new ShouldNotHappenException(); } if ($rightNumberType->getValue() < 0) { return new ErrorType(); } $resultType = $this->getTypeFromValue(intval($leftNumberType->getValue()) >> intval($rightNumberType->getValue())); if ($generalize) { $resultType = $resultType->generalize(GeneralizePrecision::lessSpecific()); } $resultTypes[] = $resultType; } } return TypeCombinator::union(...$resultTypes); } $leftNumberType = $leftType->toNumber(); $rightNumberType = $rightType->toNumber(); if ($leftNumberType instanceof ErrorType || $rightNumberType instanceof ErrorType) { return new ErrorType(); } return $this->resolveCommonMath(new Expr\BinaryOp\ShiftRight($left, $right), $leftType, $rightType); } /** * @return TypeResult<BooleanType> */ public function resolveIdenticalType(Type $leftType, Type $rightType) : TypeResult { if ($leftType instanceof NeverType || $rightType instanceof NeverType) { return new TypeResult(new ConstantBooleanType(\false), []); } if ($leftType instanceof ConstantScalarType && $rightType instanceof ConstantScalarType) { return new TypeResult(new ConstantBooleanType($leftType->getValue() === $rightType->getValue()), []); } $leftTypeFiniteTypes = $leftType->getFiniteTypes(); $rightTypeFiniteType = $rightType->getFiniteTypes(); if (count($leftTypeFiniteTypes) === 1 && count($rightTypeFiniteType) === 1) { return new TypeResult(new ConstantBooleanType($leftTypeFiniteTypes[0]->equals($rightTypeFiniteType[0])), []); } $leftIsSuperTypeOfRight = $leftType->isSuperTypeOfWithReason($rightType); $rightIsSuperTypeOfLeft = $rightType->isSuperTypeOfWithReason($leftType); if ($leftIsSuperTypeOfRight->no() && $rightIsSuperTypeOfLeft->no()) { return new TypeResult(new ConstantBooleanType(\false), array_merge($leftIsSuperTypeOfRight->reasons, $rightIsSuperTypeOfLeft->reasons)); } if ($leftType instanceof ConstantArrayType && $rightType instanceof ConstantArrayType) { return $this->resolveConstantArrayTypeComparison($leftType, $rightType, function ($leftValueType, $rightValueType) : TypeResult { return $this->resolveIdenticalType($leftValueType, $rightValueType); }); } return new TypeResult(new BooleanType(), []); } /** * @return TypeResult<BooleanType> */ public function resolveEqualType(Type $leftType, Type $rightType) : TypeResult { if ($leftType->isEnum()->yes() && $rightType->isTrue()->no() || $rightType->isEnum()->yes() && $leftType->isTrue()->no()) { return $this->resolveIdenticalType($leftType, $rightType); } if ($leftType instanceof ConstantArrayType && $rightType instanceof ConstantArrayType) { return $this->resolveConstantArrayTypeComparison($leftType, $rightType, function ($leftValueType, $rightValueType) : TypeResult { return $this->resolveEqualType($leftValueType, $rightValueType); }); } return new TypeResult($leftType->looseCompare($rightType, $this->phpVersion), []); } /** * @param callable(Type, Type): TypeResult<BooleanType> $valueComparisonCallback * @return TypeResult<BooleanType> */ private function resolveConstantArrayTypeComparison(ConstantArrayType $leftType, ConstantArrayType $rightType, callable $valueComparisonCallback) : TypeResult { $leftKeyTypes = $leftType->getKeyTypes(); $rightKeyTypes = $rightType->getKeyTypes(); $leftValueTypes = $leftType->getValueTypes(); $rightValueTypes = $rightType->getValueTypes(); $resultType = new ConstantBooleanType(\true); foreach ($leftKeyTypes as $i => $leftKeyType) { $leftOptional = $leftType->isOptionalKey($i); if ($leftOptional) { $resultType = new BooleanType(); } if (count($rightKeyTypes) === 0) { if (!$leftOptional) { return new TypeResult(new ConstantBooleanType(\false), []); } continue; } $found = \false; foreach ($rightKeyTypes as $j => $rightKeyType) { unset($rightKeyTypes[$j]); if ($leftKeyType->equals($rightKeyType)) { $found = \true; break; } elseif (!$rightType->isOptionalKey($j)) { return new TypeResult(new ConstantBooleanType(\false), []); } } if (!$found) { if (!$leftOptional) { return new TypeResult(new ConstantBooleanType(\false), []); } continue; } if (!isset($j)) { throw new ShouldNotHappenException(); } $rightOptional = $rightType->isOptionalKey($j); if ($rightOptional) { $resultType = new BooleanType(); if ($leftOptional) { continue; } } $leftIdenticalToRightResult = $valueComparisonCallback($leftValueTypes[$i], $rightValueTypes[$j]); $leftIdenticalToRight = $leftIdenticalToRightResult->type; if ($leftIdenticalToRight->isFalse()->yes()) { return $leftIdenticalToRightResult; } $resultType = TypeCombinator::union($resultType, $leftIdenticalToRight); } foreach (array_keys($rightKeyTypes) as $j) { if (!$rightType->isOptionalKey($j)) { return new TypeResult(new ConstantBooleanType(\false), []); } $resultType = new BooleanType(); } return new TypeResult($resultType->toBoolean(), []); } private function callOperatorTypeSpecifyingExtensions(Expr\BinaryOp $expr, Type $leftType, Type $rightType) : ?Type { $operatorSigil = $expr->getOperatorSigil(); $operatorTypeSpecifyingExtensions = $this->operatorTypeSpecifyingExtensionRegistryProvider->getRegistry()->getOperatorTypeSpecifyingExtensions($operatorSigil, $leftType, $rightType); /** @var Type[] $extensionTypes */ $extensionTypes = []; foreach ($operatorTypeSpecifyingExtensions as $extension) { $extensionTypes[] = $extension->specifyType($operatorSigil, $leftType, $rightType); } if (count($extensionTypes) > 0) { return TypeCombinator::union(...$extensionTypes); } return null; } /** * @param BinaryOp\Plus|BinaryOp\Minus|BinaryOp\Mul|BinaryOp\Div|BinaryOp\ShiftLeft|BinaryOp\ShiftRight $expr */ private function resolveCommonMath(Expr\BinaryOp $expr, Type $leftType, Type $rightType) : Type { $types = TypeCombinator::union($leftType, $rightType); $leftNumberType = $leftType->toNumber(); $rightNumberType = $rightType->toNumber(); if (!$types instanceof MixedType && ($rightNumberType instanceof IntegerRangeType || $rightNumberType instanceof ConstantIntegerType || $rightNumberType instanceof UnionType)) { if ($leftNumberType instanceof IntegerRangeType || $leftNumberType instanceof ConstantIntegerType) { return $this->integerRangeMath($leftNumberType, $expr, $rightNumberType); } elseif ($leftNumberType instanceof UnionType) { $unionParts = []; foreach ($leftNumberType->getTypes() as $type) { $numberType = $type->toNumber(); if ($numberType instanceof IntegerRangeType || $numberType instanceof ConstantIntegerType) { $unionParts[] = $this->integerRangeMath($numberType, $expr, $rightNumberType); } else { $unionParts[] = $numberType; } } $union = TypeCombinator::union(...$unionParts); if ($leftNumberType instanceof BenevolentUnionType) { return TypeUtils::toBenevolentUnion($union)->toNumber(); } return $union->toNumber(); } } $specifiedTypes = $this->callOperatorTypeSpecifyingExtensions($expr, $leftType, $rightType); if ($specifiedTypes !== null) { return $specifiedTypes; } if ($leftType->isArray()->yes() || $rightType->isArray()->yes() || $types->isArray()->yes()) { return new ErrorType(); } if ($leftNumberType instanceof ErrorType || $rightNumberType instanceof ErrorType) { return new ErrorType(); } if ($leftNumberType instanceof NeverType || $rightNumberType instanceof NeverType) { return $this->getNeverType($leftNumberType, $rightNumberType); } if ($leftNumberType->isFloat()->yes() || $rightNumberType->isFloat()->yes()) { if ($expr instanceof Expr\BinaryOp\ShiftLeft || $expr instanceof Expr\BinaryOp\ShiftRight) { return new IntegerType(); } return new FloatType(); } $resultType = TypeCombinator::union($leftNumberType, $rightNumberType); if ($expr instanceof Expr\BinaryOp\Div) { if ($types instanceof MixedType || $resultType->isInteger()->yes()) { return new BenevolentUnionType([new IntegerType(), new FloatType()]); } return new UnionType([new IntegerType(), new FloatType()]); } if ($types instanceof MixedType || $leftType instanceof BenevolentUnionType || $rightType instanceof BenevolentUnionType) { return TypeUtils::toBenevolentUnion($resultType); } return $resultType; } /** * @param ConstantIntegerType|IntegerRangeType $range * @param BinaryOp\Div|BinaryOp\Minus|BinaryOp\Mul|BinaryOp\Plus|BinaryOp\ShiftLeft|BinaryOp\ShiftRight $node */ private function integerRangeMath(Type $range, BinaryOp $node, Type $operand) : Type { if ($range instanceof IntegerRangeType) { $rangeMin = $range->getMin(); $rangeMax = $range->getMax(); } else { $rangeMin = $range->getValue(); $rangeMax = $rangeMin; } if ($operand instanceof UnionType) { $unionParts = []; foreach ($operand->getTypes() as $type) { $numberType = $type->toNumber(); if ($numberType instanceof IntegerRangeType || $numberType instanceof ConstantIntegerType) { $unionParts[] = $this->integerRangeMath($range, $node, $numberType); } else { $unionParts[] = $type->toNumber(); } } $union = TypeCombinator::union(...$unionParts); if ($operand instanceof BenevolentUnionType) { return TypeUtils::toBenevolentUnion($union)->toNumber(); } return $union->toNumber(); } $operand = $operand->toNumber(); if ($operand instanceof IntegerRangeType) { $operandMin = $operand->getMin(); $operandMax = $operand->getMax(); } elseif ($operand instanceof ConstantIntegerType) { $operandMin = $operand->getValue(); $operandMax = $operand->getValue(); } else { return $operand; } if ($node instanceof BinaryOp\Plus) { if ($operand instanceof ConstantIntegerType) { /** @var int|float|null $min */ $min = $rangeMin !== null ? $rangeMin + $operand->getValue() : null; /** @var int|float|null $max */ $max = $rangeMax !== null ? $rangeMax + $operand->getValue() : null; } else { /** @var int|float|null $min */ $min = $rangeMin !== null && $operand->getMin() !== null ? $rangeMin + $operand->getMin() : null; /** @var int|float|null $max */ $max = $rangeMax !== null && $operand->getMax() !== null ? $rangeMax + $operand->getMax() : null; } } elseif ($node instanceof BinaryOp\Minus) { if ($operand instanceof ConstantIntegerType) { /** @var int|float|null $min */ $min = $rangeMin !== null ? $rangeMin - $operand->getValue() : null; /** @var int|float|null $max */ $max = $rangeMax !== null ? $rangeMax - $operand->getValue() : null; } else { if ($rangeMin === $rangeMax && $rangeMin !== null && ($operand->getMin() === null || $operand->getMax() === null)) { $min = null; $max = $rangeMin; } else { if ($operand->getMin() === null) { $min = null; } elseif ($rangeMin !== null) { if ($operand->getMax() !== null) { /** @var int|float $min */ $min = $rangeMin - $operand->getMax(); } else { /** @var int|float $min */ $min = $rangeMin - $operand->getMin(); } } else { $min = null; } if ($operand->getMax() === null) { $min = null; $max = null; } elseif ($rangeMax !== null) { if ($rangeMin !== null && $operand->getMin() === null) { /** @var int|float $min */ $min = $rangeMin - $operand->getMax(); $max = null; } elseif ($operand->getMin() !== null) { /** @var int|float $max */ $max = $rangeMax - $operand->getMin(); } else { $max = null; } } else { $max = null; } if ($min !== null && $max !== null && $min > $max) { [$min, $max] = [$max, $min]; } } } } elseif ($node instanceof Expr\BinaryOp\Mul) { $min1 = $rangeMin === 0 || $operandMin === 0 ? 0 : ($rangeMin ?? -INF) * ($operandMin ?? -INF); $min2 = $rangeMin === 0 || $operandMax === 0 ? 0 : ($rangeMin ?? -INF) * ($operandMax ?? INF); $max1 = $rangeMax === 0 || $operandMin === 0 ? 0 : ($rangeMax ?? INF) * ($operandMin ?? -INF); $max2 = $rangeMax === 0 || $operandMax === 0 ? 0 : ($rangeMax ?? INF) * ($operandMax ?? INF); $min = min($min1, $min2, $max1, $max2); $max = max($min1, $min2, $max1, $max2); if (!is_finite($min)) { $min = null; } if (!is_finite($max)) { $max = null; } } elseif ($node instanceof Expr\BinaryOp\Div) { if ($operand instanceof ConstantIntegerType) { $min = $rangeMin !== null && $operand->getValue() !== 0 ? $rangeMin / $operand->getValue() : null; $max = $rangeMax !== null && $operand->getValue() !== 0 ? $rangeMax / $operand->getValue() : null; } else { // Avoid division by zero when looking for the min and the max by using the closest int $operandMin = $operandMin !== 0 ? $operandMin : 1; $operandMax = $operandMax !== 0 ? $operandMax : -1; if (($operandMin < 0 || $operandMin === null) && ($operandMax > 0 || $operandMax === null)) { $negativeOperand = IntegerRangeType::fromInterval($operandMin, 0); assert($negativeOperand instanceof IntegerRangeType); $positiveOperand = IntegerRangeType::fromInterval(0, $operandMax); assert($positiveOperand instanceof IntegerRangeType); $result = TypeCombinator::union($this->integerRangeMath($range, $node, $negativeOperand), $this->integerRangeMath($range, $node, $positiveOperand))->toNumber(); if ($result->equals(new UnionType([new IntegerType(), new FloatType()]))) { return new BenevolentUnionType([new IntegerType(), new FloatType()]); } return $result; } if (($rangeMin < 0 || $rangeMin === null) && ($rangeMax > 0 || $rangeMax === null)) { $negativeRange = IntegerRangeType::fromInterval($rangeMin, 0); assert($negativeRange instanceof IntegerRangeType); $positiveRange = IntegerRangeType::fromInterval(0, $rangeMax); assert($positiveRange instanceof IntegerRangeType); $result = TypeCombinator::union($this->integerRangeMath($negativeRange, $node, $operand), $this->integerRangeMath($positiveRange, $node, $operand))->toNumber(); if ($result->equals(new UnionType([new IntegerType(), new FloatType()]))) { return new BenevolentUnionType([new IntegerType(), new FloatType()]); } return $result; } $rangeMinSign = ($rangeMin ?? -INF) <=> 0; $rangeMaxSign = ($rangeMax ?? INF) <=> 0; $min1 = $operandMin !== null ? ($rangeMin ?? -INF) / $operandMin : $rangeMinSign * -0.1; $min2 = $operandMax !== null ? ($rangeMin ?? -INF) / $operandMax : $rangeMinSign * 0.1; $max1 = $operandMin !== null ? ($rangeMax ?? INF) / $operandMin : $rangeMaxSign * -0.1; $max2 = $operandMax !== null ? ($rangeMax ?? INF) / $operandMax : $rangeMaxSign * 0.1; $min = min($min1, $min2, $max1, $max2); $max = max($min1, $min2, $max1, $max2); if ($min === -INF) { $min = null; } if ($max === INF) { $max = null; } } if ($min !== null && $max !== null && $min > $max) { [$min, $max] = [$max, $min]; } if (is_float($min)) { $min = (int) ceil($min); } if (is_float($max)) { $max = (int) floor($max); } // invert maximas on division with negative constants if (($range instanceof ConstantIntegerType && $range->getValue() < 0 || $operand instanceof ConstantIntegerType && $operand->getValue() < 0) && ($min === null || $max === null)) { [$min, $max] = [$max, $min]; } if ($min === null && $max === null) { return new BenevolentUnionType([new IntegerType(), new FloatType()]); } return TypeCombinator::union(IntegerRangeType::fromInterval($min, $max), new FloatType()); } elseif ($node instanceof Expr\BinaryOp\ShiftLeft) { if (!$operand instanceof ConstantIntegerType) { return new IntegerType(); } if ($operand->getValue() < 0) { return new ErrorType(); } $min = $rangeMin !== null ? intval($rangeMin) << $operand->getValue() : null; $max = $rangeMax !== null ? intval($rangeMax) << $operand->getValue() : null; } elseif ($node instanceof Expr\BinaryOp\ShiftRight) { if (!$operand instanceof ConstantIntegerType) { return new IntegerType(); } if ($operand->getValue() < 0) { return new ErrorType(); } $min = $rangeMin !== null ? intval($rangeMin) >> $operand->getValue() : null; $max = $rangeMax !== null ? intval($rangeMax) >> $operand->getValue() : null; } else { throw new ShouldNotHappenException(); } if (is_float($min)) { $min = null; } if (is_float($max)) { $max = null; } return IntegerRangeType::fromInterval($min, $max); } /** * @param callable(Expr): Type $getTypeCallback * @param Name|Expr $class */ public function getClassConstFetchTypeByReflection($class, string $constantName, ?\PHPStan\Reflection\ClassReflection $classReflection, callable $getTypeCallback) : Type { $isObject = \false; if ($class instanceof Name) { $constantClass = (string) $class; $constantClassType = new ObjectType($constantClass); $namesToResolve = ['self', 'parent']; if ($classReflection !== null) { if ($classReflection->isFinal()) { $namesToResolve[] = 'static'; } elseif (strtolower($constantClass) === 'static') { if (strtolower($constantName) === 'class') { return new GenericClassStringType(new StaticType($classReflection)); } $namesToResolve[] = 'static'; $isObject = \true; } } if (in_array(strtolower($constantClass), $namesToResolve, \true)) { $resolvedName = $this->resolveName($class, $classReflection); if (strtolower($resolvedName) === 'parent' && strtolower($constantName) === 'class') { return new ClassStringType(); } $constantClassType = $this->resolveTypeByName($class, $classReflection); } if (strtolower($constantName) === 'class') { return new ConstantStringType($constantClassType->getClassName(), \true); } } elseif ($class instanceof String_ && strtolower($constantName) === 'class') { return new ConstantStringType($class->value, \true); } else { $constantClassType = $getTypeCallback($class); $isObject = \true; } if (strtolower($constantName) === 'class') { return TypeTraverser::map($constantClassType, function (Type $type, callable $traverse) : Type { if ($type instanceof UnionType || $type instanceof IntersectionType) { return $traverse($type); } if ($type instanceof NullType) { return $type; } if ($type instanceof EnumCaseObjectType) { return TypeCombinator::intersect(new GenericClassStringType(new ObjectType($type->getClassName())), new AccessoryLiteralStringType()); } $objectClassNames = $type->getObjectClassNames(); if (count($objectClassNames) > 1) { throw new ShouldNotHappenException(); } if ($type instanceof TemplateType && $objectClassNames === []) { return TypeCombinator::intersect(new GenericClassStringType($type), new AccessoryLiteralStringType()); } elseif ($objectClassNames !== [] && $this->getReflectionProvider()->hasClass($objectClassNames[0])) { $reflection = $this->getReflectionProvider()->getClass($objectClassNames[0]); if ($reflection->isFinalByKeyword()) { return new ConstantStringType($reflection->getName(), \true); } return TypeCombinator::intersect(new GenericClassStringType($type), new AccessoryLiteralStringType()); } elseif ($type->isObject()->yes()) { return TypeCombinator::intersect(new ClassStringType(), new AccessoryLiteralStringType()); } return new ErrorType(); }); } if ($constantClassType->isClassStringType()->yes()) { if ($constantClassType->isConstantScalarValue()->yes()) { $isObject = \false; } $constantClassType = $constantClassType->getClassStringObjectType(); } $types = []; foreach ($constantClassType->getObjectClassNames() as $referencedClass) { if (!$this->getReflectionProvider()->hasClass($referencedClass)) { continue; } $constantClassReflection = $this->getReflectionProvider()->getClass($referencedClass); if (!$constantClassReflection->hasConstant($constantName)) { continue; } if ($constantClassReflection->isEnum() && $constantClassReflection->hasEnumCase($constantName)) { $types[] = new EnumCaseObjectType($constantClassReflection->getName(), $constantName); continue; } $resolvingName = sprintf('%s::%s', $constantClassReflection->getName(), $constantName); if (array_key_exists($resolvingName, $this->currentlyResolvingClassConstant)) { $types[] = new MixedType(); continue; } $this->currentlyResolvingClassConstant[$resolvingName] = \true; if (!$isObject) { $reflectionConstant = $constantClassReflection->getNativeReflection()->getReflectionConstant($constantName); if ($reflectionConstant === \false) { unset($this->currentlyResolvingClassConstant[$resolvingName]); continue; } $reflectionConstantDeclaringClass = $reflectionConstant->getDeclaringClass(); $constantType = $this->getType($reflectionConstant->getValueExpression(), \PHPStan\Reflection\InitializerExprContext::fromClass($reflectionConstantDeclaringClass->getName(), $reflectionConstantDeclaringClass->getFileName() ?: null)); $nativeType = null; if ($reflectionConstant->getType() !== null) { $nativeType = TypehintHelper::decideTypeFromReflection($reflectionConstant->getType(), null, $constantClassReflection); } $types[] = $this->constantResolver->resolveClassConstantType($constantClassReflection->getName(), $constantName, $constantType, $nativeType); unset($this->currentlyResolvingClassConstant[$resolvingName]); continue; } $constantReflection = $constantClassReflection->getConstant($constantName); if (!$constantClassReflection->isFinal() && !$constantReflection->isFinal() && !$constantReflection->hasPhpDocType() && !$constantReflection->hasNativeType()) { unset($this->currentlyResolvingClassConstant[$resolvingName]); return new MixedType(); } if (!$constantClassReflection->isFinal()) { $constantType = $constantReflection->getValueType(); } else { $constantType = $this->getType($constantReflection->getValueExpr(), \PHPStan\Reflection\InitializerExprContext::fromClassReflection($constantReflection->getDeclaringClass())); } $nativeType = $constantReflection->getNativeType(); $constantType = $this->constantResolver->resolveClassConstantType($constantClassReflection->getName(), $constantName, $constantType, $nativeType); unset($this->currentlyResolvingClassConstant[$resolvingName]); $types[] = $constantType; } if (count($types) > 0) { return TypeCombinator::union(...$types); } if (!$constantClassType->hasConstant($constantName)->yes()) { return new ErrorType(); } return $constantClassType->getConstant($constantName)->getValueType(); } /** * @param callable(Expr): Type $getTypeCallback * @param Name|Expr $class */ public function getClassConstFetchType($class, string $constantName, ?string $className, callable $getTypeCallback) : Type { $classReflection = null; if ($className !== null && $this->getReflectionProvider()->hasClass($className)) { $classReflection = $this->getReflectionProvider()->getClass($className); } return $this->getClassConstFetchTypeByReflection($class, $constantName, $classReflection, $getTypeCallback); } /** * @param callable(Expr): Type $getTypeCallback */ public function getUnaryMinusType(Expr $expr, callable $getTypeCallback) : Type { $type = $getTypeCallback($expr)->toNumber(); $scalarValues = $type->getConstantScalarValues(); if (count($scalarValues) > 0) { $newTypes = []; foreach ($scalarValues as $scalarValue) { if (is_int($scalarValue)) { /** @var int|float $newValue */ $newValue = -$scalarValue; if (!is_int($newValue)) { return $type; } $newTypes[] = new ConstantIntegerType($newValue); } elseif (is_float($scalarValue)) { $newTypes[] = new ConstantFloatType(-$scalarValue); } } return TypeCombinator::union(...$newTypes); } if ($type instanceof IntegerRangeType) { return $getTypeCallback(new Expr\BinaryOp\Mul($expr, new LNumber(-1))); } return $type; } /** * @param callable(Expr): Type $getTypeCallback */ public function getBitwiseNotType(Expr $expr, callable $getTypeCallback) : Type { $exprType = $getTypeCallback($expr); return TypeTraverser::map($exprType, static function (Type $type, callable $traverse) : Type { if ($type instanceof UnionType || $type instanceof IntersectionType) { return $traverse($type); } if ($type instanceof ConstantStringType) { return new ConstantStringType(~$type->getValue()); } if ($type->isString()->yes()) { $accessories = [new StringType()]; if ($type->isNonEmptyString()->yes()) { $accessories[] = new AccessoryNonEmptyStringType(); } // it is not useful to apply numeric and literal strings here. // numeric string isn't certainly kept numeric: 3v4l.org/JERDB return TypeCombinator::intersect(...$accessories); } if ($type->isInteger()->yes() || $type->isFloat()->yes()) { return new IntegerType(); //no const types here, result depends on PHP_INT_SIZE } return new ErrorType(); }); } private function resolveName(Name $name, ?\PHPStan\Reflection\ClassReflection $classReflection) : string { $originalClass = (string) $name; if ($classReflection !== null) { $lowerClass = strtolower($originalClass); if (in_array($lowerClass, ['self', 'static'], \true)) { return $classReflection->getName(); } elseif ($lowerClass === 'parent') { if ($classReflection->getParentClass() !== null) { return $classReflection->getParentClass()->getName(); } } } return $originalClass; } private function resolveTypeByName(Name $name, ?\PHPStan\Reflection\ClassReflection $classReflection) : TypeWithClassName { if ($name->toLowerString() === 'static' && $classReflection !== null) { return new StaticType($classReflection); } $originalClass = $this->resolveName($name, $classReflection); if ($classReflection !== null) { $thisType = new ThisType($classReflection); $ancestor = $thisType->getAncestorWithClassName($originalClass); if ($ancestor !== null) { return $ancestor; } } return new ObjectType($originalClass); } /** * @param mixed $value */ private function getTypeFromValue($value) : Type { return ConstantTypeHelper::getTypeFromValue($value); } private function getReflectionProvider() : \PHPStan\Reflection\ReflectionProvider { return $this->reflectionProviderProvider->getReflectionProvider(); } private function getNeverType(Type $leftType, Type $rightType) : Type { // make sure we don't lose the explicit flag in the process if ($leftType instanceof NeverType && $leftType->isExplicit()) { return $leftType; } if ($rightType instanceof NeverType && $rightType->isExplicit()) { return $rightType; } return new NeverType(); } } <?php declare (strict_types=1); namespace PHPStan\Reflection; use PHPStan\TrinaryLogic; use PHPStan\Type\Type; /** * The purpose of this interface is to be able to * answer more questions about methods * without breaking backward compatibility * with existing MethodsClassReflectionExtension. * * Developers are meant to only implement MethodReflection * and its methods in their code. * * New methods on ExtendedMethodReflection will be added * in minor versions. * * @api */ interface ExtendedMethodReflection extends \PHPStan\Reflection\MethodReflection { /** * @return ParametersAcceptorWithPhpDocs[] */ public function getVariants() : array; /** * @internal */ public function getOnlyVariant() : \PHPStan\Reflection\ParametersAcceptorWithPhpDocs; /** * @return ParametersAcceptorWithPhpDocs[]|null */ public function getNamedArgumentsVariants() : ?array; public function acceptsNamedArguments() : bool; public function getAsserts() : \PHPStan\Reflection\Assertions; public function getSelfOutType() : ?Type; public function returnsByReference() : TrinaryLogic; public function isFinalByKeyword() : TrinaryLogic; /** * @return TrinaryLogic|bool */ public function isAbstract(); /** * This indicates whether the method has phpstan-pure * or phpstan-impure annotation above it. * * In most cases asking hasSideEffects() is much more practical * as it also accounts for void return type (method being always impure). */ public function isPure() : TrinaryLogic; } <?php declare (strict_types=1); namespace PHPStan\Reflection; /** @api */ interface ClassMemberReflection { public function getDeclaringClass() : \PHPStan\Reflection\ClassReflection; public function isStatic() : bool; public function isPrivate() : bool; public function isPublic() : bool; public function getDocComment() : ?string; } <?php declare (strict_types=1); namespace PHPStan\Reflection; use PHPStan\TrinaryLogic; use PHPStan\Type\Type; /** @api */ interface MethodReflection extends \PHPStan\Reflection\ClassMemberReflection { public function getName() : string; public function getPrototype() : \PHPStan\Reflection\ClassMemberReflection; /** * @return ParametersAcceptor[] */ public function getVariants() : array; public function isDeprecated() : TrinaryLogic; public function getDeprecatedDescription() : ?string; public function isFinal() : TrinaryLogic; public function isInternal() : TrinaryLogic; public function getThrowType() : ?Type; public function hasSideEffects() : TrinaryLogic; } <?php declare (strict_types=1); namespace PHPStan\Reflection; use PhpParser\Node\Expr; /** @api */ interface ConstantReflection extends \PHPStan\Reflection\ClassMemberReflection, \PHPStan\Reflection\GlobalConstantReflection { /** * @deprecated Use getValueExpr() * @return mixed */ public function getValue(); public function getValueExpr() : Expr; } <?php declare (strict_types=1); namespace PHPStan\Reflection; use Exception; use function sprintf; final class MissingConstantFromReflectionException extends Exception { public function __construct(string $className, string $constantName) { parent::__construct(sprintf('Constant %s was not found in reflection of class %s.', $constantName, $className)); } } <?php declare (strict_types=1); namespace PHPStan\Reflection; use PHPStan\Type\Type; interface ResolvedFunctionVariant extends \PHPStan\Reflection\ParametersAcceptorWithPhpDocs { public function getOriginalParametersAcceptor() : \PHPStan\Reflection\ParametersAcceptor; public function getReturnTypeWithUnresolvableTemplateTypes() : Type; public function getPhpDocReturnTypeWithUnresolvableTemplateTypes() : Type; } <?php declare (strict_types=1); namespace PHPStan\Reflection; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionFunction; use PHPStan\Reflection\Php\PhpFunctionReflection; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\Type; interface FunctionReflectionFactory { /** * @param array<string, Type> $phpDocParameterTypes * @param array<string, Type> $phpDocParameterOutTypes * @param array<string, bool> $phpDocParameterImmediatelyInvokedCallable * @param array<string, Type> $phpDocParameterClosureThisTypes */ public function create(ReflectionFunction $reflection, TemplateTypeMap $templateTypeMap, array $phpDocParameterTypes, ?Type $phpDocReturnType, ?Type $phpDocThrowType, ?string $deprecatedDescription, bool $isDeprecated, bool $isInternal, bool $isFinal, ?string $filename, ?bool $isPure, \PHPStan\Reflection\Assertions $asserts, bool $acceptsNamedArguments, ?string $phpDocComment, array $phpDocParameterOutTypes, array $phpDocParameterImmediatelyInvokedCallable, array $phpDocParameterClosureThisTypes) : PhpFunctionReflection; } <?php declare (strict_types=1); namespace PHPStan\Reflection; /** * This is the extension interface to implement if you want to dynamically * mark methods as constructor. As opposed to simply list them in the configuration file. * * To register it in the configuration file use the `phpstan.additionalConstructorsExtension` service tag: * * ``` * services: * - * class: App\PHPStan\MyExtension * tags: * - phpstan.additionalConstructorsExtension * ``` * * @api */ interface AdditionalConstructorsExtension { public const EXTENSION_TAG = 'phpstan.additionalConstructorsExtension'; /** @return string[] */ public function getAdditionalConstructors(\PHPStan\Reflection\ClassReflection $classReflection) : array; } <?php declare (strict_types=1); namespace PHPStan\Reflection; use PHPStan\Reflection\Callables\CallableParametersAcceptor; use PHPStan\Reflection\Callables\SimpleImpurePoint; use PHPStan\TrinaryLogic; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\Generic\TemplateTypeVarianceMap; use PHPStan\Type\MixedType; use PHPStan\Type\Type; use function sprintf; /** * @api * @final */ class TrivialParametersAcceptor implements \PHPStan\Reflection\ParametersAcceptorWithPhpDocs, CallableParametersAcceptor { /** * @var string */ private $callableName; /** @api */ public function __construct(string $callableName = 'callable') { $this->callableName = $callableName; } public function getTemplateTypeMap() : TemplateTypeMap { return TemplateTypeMap::createEmpty(); } public function getResolvedTemplateTypeMap() : TemplateTypeMap { return TemplateTypeMap::createEmpty(); } public function getCallSiteVarianceMap() : TemplateTypeVarianceMap { return TemplateTypeVarianceMap::createEmpty(); } public function getParameters() : array { return []; } public function isVariadic() : bool { return \true; } public function getReturnType() : Type { return new MixedType(); } public function getPhpDocReturnType() : Type { return new MixedType(); } public function getNativeReturnType() : Type { return new MixedType(); } public function getThrowPoints() : array { return []; } public function isPure() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getImpurePoints() : array { return [new SimpleImpurePoint('functionCall', sprintf('call to a %s', $this->callableName), \false)]; } public function getInvalidateExpressions() : array { return []; } public function getUsedVariables() : array { return []; } public function acceptsNamedArguments() : bool { return \true; } } <?php declare (strict_types=1); namespace PHPStan\Reflection; use PHPStan\Node\InvalidateExprNode; use PHPStan\Reflection\Callables\CallableParametersAcceptor; use PHPStan\Reflection\Callables\SimpleImpurePoint; use PHPStan\Reflection\Callables\SimpleThrowPoint; use PHPStan\TrinaryLogic; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\Generic\TemplateTypeVarianceMap; use PHPStan\Type\Type; final class ResolvedFunctionVariantWithCallable implements \PHPStan\Reflection\ResolvedFunctionVariant, CallableParametersAcceptor { /** * @var ResolvedFunctionVariant */ private $parametersAcceptor; /** * @var SimpleThrowPoint[] */ private $throwPoints; /** * @var TrinaryLogic */ private $isPure; /** * @var SimpleImpurePoint[] */ private $impurePoints; /** * @var InvalidateExprNode[] */ private $invalidateExpressions; /** * @var string[] */ private $usedVariables; /** * @var bool */ private $acceptsNamedArguments; /** * @param SimpleThrowPoint[] $throwPoints * @param SimpleImpurePoint[] $impurePoints * @param InvalidateExprNode[] $invalidateExpressions * @param string[] $usedVariables */ public function __construct(\PHPStan\Reflection\ResolvedFunctionVariant $parametersAcceptor, array $throwPoints, TrinaryLogic $isPure, array $impurePoints, array $invalidateExpressions, array $usedVariables, bool $acceptsNamedArguments) { $this->parametersAcceptor = $parametersAcceptor; $this->throwPoints = $throwPoints; $this->isPure = $isPure; $this->impurePoints = $impurePoints; $this->invalidateExpressions = $invalidateExpressions; $this->usedVariables = $usedVariables; $this->acceptsNamedArguments = $acceptsNamedArguments; } public function getOriginalParametersAcceptor() : \PHPStan\Reflection\ParametersAcceptor { return $this->parametersAcceptor->getOriginalParametersAcceptor(); } public function getTemplateTypeMap() : TemplateTypeMap { return $this->parametersAcceptor->getTemplateTypeMap(); } public function getResolvedTemplateTypeMap() : TemplateTypeMap { return $this->parametersAcceptor->getResolvedTemplateTypeMap(); } public function getCallSiteVarianceMap() : TemplateTypeVarianceMap { return $this->parametersAcceptor->getCallSiteVarianceMap(); } public function getParameters() : array { return $this->parametersAcceptor->getParameters(); } public function isVariadic() : bool { return $this->parametersAcceptor->isVariadic(); } public function getReturnTypeWithUnresolvableTemplateTypes() : Type { return $this->parametersAcceptor->getReturnTypeWithUnresolvableTemplateTypes(); } public function getPhpDocReturnTypeWithUnresolvableTemplateTypes() : Type { return $this->parametersAcceptor->getPhpDocReturnTypeWithUnresolvableTemplateTypes(); } public function getReturnType() : Type { return $this->parametersAcceptor->getReturnType(); } public function getPhpDocReturnType() : Type { return $this->parametersAcceptor->getPhpDocReturnType(); } public function getNativeReturnType() : Type { return $this->parametersAcceptor->getNativeReturnType(); } public function getThrowPoints() : array { return $this->throwPoints; } public function isPure() : TrinaryLogic { return $this->isPure; } public function getImpurePoints() : array { return $this->impurePoints; } public function getInvalidateExpressions() : array { return $this->invalidateExpressions; } public function getUsedVariables() : array { return $this->usedVariables; } public function acceptsNamedArguments() : bool { return $this->acceptsNamedArguments; } } <?php declare (strict_types=1); namespace PHPStan\Reflection; /** @api */ interface ClassMemberAccessAnswerer { /** * @phpstan-assert-if-true !null $this->getClassReflection() */ public function isInClass() : bool; public function getClassReflection() : ?\PHPStan\Reflection\ClassReflection; public function canAccessProperty(\PHPStan\Reflection\PropertyReflection $propertyReflection) : bool; public function canCallMethod(\PHPStan\Reflection\MethodReflection $methodReflection) : bool; public function canAccessConstant(\PHPStan\Reflection\ConstantReflection $constantReflection) : bool; } <?php declare (strict_types=1); namespace PHPStan\Reflection\Annotations; use PHPStan\PhpDoc\Tag\TemplateTag; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\MethodReflection; use PHPStan\Reflection\MethodsClassReflectionExtension; use PHPStan\Type\Generic\TemplateTypeFactory; use PHPStan\Type\Generic\TemplateTypeHelper; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\Generic\TemplateTypeScope; use PHPStan\Type\Generic\TemplateTypeVariance; use PHPStan\Type\Type; use function array_map; use function count; final class AnnotationsMethodsClassReflectionExtension implements MethodsClassReflectionExtension { /** @var ExtendedMethodReflection[][] */ private $methods = []; public function hasMethod(ClassReflection $classReflection, string $methodName) : bool { if (!isset($this->methods[$classReflection->getCacheKey()][$methodName])) { $method = $this->findClassReflectionWithMethod($classReflection, $classReflection, $methodName); if ($method === null) { return \false; } $this->methods[$classReflection->getCacheKey()][$methodName] = $method; } return isset($this->methods[$classReflection->getCacheKey()][$methodName]); } /** * @return ExtendedMethodReflection */ public function getMethod(ClassReflection $classReflection, string $methodName) : MethodReflection { return $this->methods[$classReflection->getCacheKey()][$methodName]; } private function findClassReflectionWithMethod(ClassReflection $classReflection, ClassReflection $declaringClass, string $methodName) : ?ExtendedMethodReflection { $methodTags = $classReflection->getMethodTags(); if (isset($methodTags[$methodName])) { $parameters = []; foreach ($methodTags[$methodName]->getParameters() as $parameterName => $parameterTag) { $parameters[] = new \PHPStan\Reflection\Annotations\AnnotationsMethodParameterReflection($parameterName, $parameterTag->getType(), $parameterTag->passedByReference(), $parameterTag->isOptional(), $parameterTag->isVariadic(), $parameterTag->getDefaultValue()); } $templateTypeScope = TemplateTypeScope::createWithClass($classReflection->getName()); $templateTypeMap = new TemplateTypeMap(array_map(static function (TemplateTag $tag) use($templateTypeScope) : Type { return TemplateTypeFactory::fromTemplateTag($templateTypeScope, $tag); }, $methodTags[$methodName]->getTemplateTags())); $isStatic = $methodTags[$methodName]->isStatic(); $nativeCallMethodName = $isStatic ? '__callStatic' : '__call'; return new \PHPStan\Reflection\Annotations\AnnotationMethodReflection($methodName, $declaringClass, TemplateTypeHelper::resolveTemplateTypes($methodTags[$methodName]->getReturnType(), $classReflection->getActiveTemplateTypeMap(), $classReflection->getCallSiteVarianceMap(), TemplateTypeVariance::createCovariant()), $parameters, $isStatic, $this->detectMethodVariadic($parameters), $classReflection->hasNativeMethod($nativeCallMethodName) ? $classReflection->getNativeMethod($nativeCallMethodName)->getThrowType() : null, $templateTypeMap); } foreach ($classReflection->getTraits() as $traitClass) { $methodWithDeclaringClass = $this->findClassReflectionWithMethod($traitClass, $classReflection, $methodName); if ($methodWithDeclaringClass === null) { continue; } return $methodWithDeclaringClass; } $parentClass = $classReflection->getParentClass(); while ($parentClass !== null) { $methodWithDeclaringClass = $this->findClassReflectionWithMethod($parentClass, $parentClass, $methodName); if ($methodWithDeclaringClass !== null) { return $methodWithDeclaringClass; } $parentClass = $parentClass->getParentClass(); } foreach ($classReflection->getInterfaces() as $interfaceClass) { $methodWithDeclaringClass = $this->findClassReflectionWithMethod($interfaceClass, $interfaceClass, $methodName); if ($methodWithDeclaringClass === null) { continue; } return $methodWithDeclaringClass; } return null; } /** * @param AnnotationsMethodParameterReflection[] $parameters */ private function detectMethodVariadic(array $parameters) : bool { if ($parameters === []) { return \false; } $possibleVariadicParameterIndex = count($parameters) - 1; $possibleVariadicParameter = $parameters[$possibleVariadicParameterIndex]; return $possibleVariadicParameter->isVariadic(); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Annotations; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ExtendedPropertyReflection; use PHPStan\Reflection\PropertiesClassReflectionExtension; use PHPStan\Reflection\PropertyReflection; use PHPStan\Type\Generic\TemplateTypeHelper; use PHPStan\Type\Generic\TemplateTypeVariance; use PHPStan\Type\NeverType; final class AnnotationsPropertiesClassReflectionExtension implements PropertiesClassReflectionExtension { /** @var ExtendedPropertyReflection[][] */ private $properties = []; public function hasProperty(ClassReflection $classReflection, string $propertyName) : bool { if (!isset($this->properties[$classReflection->getCacheKey()][$propertyName])) { $property = $this->findClassReflectionWithProperty($classReflection, $classReflection, $propertyName); if ($property === null) { return \false; } $this->properties[$classReflection->getCacheKey()][$propertyName] = $property; } return isset($this->properties[$classReflection->getCacheKey()][$propertyName]); } /** * @return ExtendedPropertyReflection */ public function getProperty(ClassReflection $classReflection, string $propertyName) : PropertyReflection { return $this->properties[$classReflection->getCacheKey()][$propertyName]; } private function findClassReflectionWithProperty(ClassReflection $classReflection, ClassReflection $declaringClass, string $propertyName) : ?ExtendedPropertyReflection { $propertyTags = $classReflection->getPropertyTags(); if (isset($propertyTags[$propertyName])) { $propertyTag = $propertyTags[$propertyName]; $isReadable = $propertyTags[$propertyName]->isReadable(); $isWritable = $propertyTags[$propertyName]->isWritable(); if ($classReflection->hasNativeProperty($propertyName)) { $nativeProperty = $classReflection->getNativeProperty($propertyName); $isReadable = $isReadable || $nativeProperty->isReadable(); $isWritable = $isWritable || $nativeProperty->isWritable(); } return new \PHPStan\Reflection\Annotations\AnnotationPropertyReflection($declaringClass, TemplateTypeHelper::resolveTemplateTypes($propertyTag->getReadableType() ?? new NeverType(), $classReflection->getActiveTemplateTypeMap(), $classReflection->getCallSiteVarianceMap(), TemplateTypeVariance::createCovariant()), TemplateTypeHelper::resolveTemplateTypes($propertyTag->getWritableType() ?? new NeverType(), $classReflection->getActiveTemplateTypeMap(), $classReflection->getCallSiteVarianceMap(), TemplateTypeVariance::createContravariant()), $isReadable, $isWritable); } foreach ($classReflection->getTraits() as $traitClass) { $methodWithDeclaringClass = $this->findClassReflectionWithProperty($traitClass, $classReflection, $propertyName); if ($methodWithDeclaringClass === null) { continue; } return $methodWithDeclaringClass; } $parentClass = $classReflection->getParentClass(); while ($parentClass !== null) { $methodWithDeclaringClass = $this->findClassReflectionWithProperty($parentClass, $parentClass, $propertyName); if ($methodWithDeclaringClass !== null) { return $methodWithDeclaringClass; } $parentClass = $parentClass->getParentClass(); } foreach ($classReflection->getInterfaces() as $interfaceClass) { $methodWithDeclaringClass = $this->findClassReflectionWithProperty($interfaceClass, $interfaceClass, $propertyName); if ($methodWithDeclaringClass === null) { continue; } return $methodWithDeclaringClass; } return null; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Annotations; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ExtendedPropertyReflection; use PHPStan\TrinaryLogic; use PHPStan\Type\Type; final class AnnotationPropertyReflection implements ExtendedPropertyReflection { /** * @var ClassReflection */ private $declaringClass; /** * @var Type */ private $readableType; /** * @var Type */ private $writableType; /** * @var bool */ private $readable; /** * @var bool */ private $writable; public function __construct(ClassReflection $declaringClass, Type $readableType, Type $writableType, bool $readable, bool $writable) { $this->declaringClass = $declaringClass; $this->readableType = $readableType; $this->writableType = $writableType; $this->readable = $readable; $this->writable = $writable; } public function getDeclaringClass() : ClassReflection { return $this->declaringClass; } public function isStatic() : bool { return \false; } public function isPrivate() : bool { return \false; } public function isPublic() : bool { return \true; } public function getReadableType() : Type { return $this->readableType; } public function getWritableType() : Type { return $this->writableType; } public function canChangeTypeAfterAssignment() : bool { return $this->readableType->equals($this->writableType); } public function isReadable() : bool { return $this->readable; } public function isWritable() : bool { return $this->writable; } public function isDeprecated() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getDeprecatedDescription() : ?string { return null; } public function isInternal() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getDocComment() : ?string { return null; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Annotations; use PHPStan\Reflection\Assertions; use PHPStan\Reflection\ClassMemberReflection; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\FunctionVariantWithPhpDocs; use PHPStan\Reflection\ParametersAcceptorWithPhpDocs; use PHPStan\TrinaryLogic; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\MixedType; use PHPStan\Type\ThisType; use PHPStan\Type\Type; final class AnnotationMethodReflection implements ExtendedMethodReflection { /** * @var string */ private $name; /** * @var ClassReflection */ private $declaringClass; /** * @var Type */ private $returnType; /** * @var AnnotationsMethodParameterReflection[] */ private $parameters; /** * @var bool */ private $isStatic; /** * @var bool */ private $isVariadic; /** * @var ?Type */ private $throwType; /** * @var TemplateTypeMap */ private $templateTypeMap; /** @var FunctionVariantWithPhpDocs[]|null */ private $variants = null; /** * @param AnnotationsMethodParameterReflection[] $parameters */ public function __construct(string $name, ClassReflection $declaringClass, Type $returnType, array $parameters, bool $isStatic, bool $isVariadic, ?Type $throwType, TemplateTypeMap $templateTypeMap) { $this->name = $name; $this->declaringClass = $declaringClass; $this->returnType = $returnType; $this->parameters = $parameters; $this->isStatic = $isStatic; $this->isVariadic = $isVariadic; $this->throwType = $throwType; $this->templateTypeMap = $templateTypeMap; } public function getDeclaringClass() : ClassReflection { return $this->declaringClass; } public function getPrototype() : ClassMemberReflection { return $this; } public function isStatic() : bool { return $this->isStatic; } public function isPrivate() : bool { return \false; } public function isPublic() : bool { return \true; } public function getName() : string { return $this->name; } public function getVariants() : array { if ($this->variants === null) { $this->variants = [new FunctionVariantWithPhpDocs($this->templateTypeMap, null, $this->parameters, $this->isVariadic, $this->returnType, $this->returnType, new MixedType())]; } return $this->variants; } public function getOnlyVariant() : ParametersAcceptorWithPhpDocs { return $this->getVariants()[0]; } public function getNamedArgumentsVariants() : ?array { return null; } public function isDeprecated() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getDeprecatedDescription() : ?string { return null; } public function isFinal() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFinalByKeyword() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isInternal() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getThrowType() : ?Type { return $this->throwType; } public function hasSideEffects() : TrinaryLogic { if ($this->returnType->isVoid()->yes()) { return TrinaryLogic::createYes(); } if ((new ThisType($this->declaringClass))->isSuperTypeOf($this->returnType)->yes()) { return TrinaryLogic::createYes(); } return TrinaryLogic::createMaybe(); } public function getDocComment() : ?string { return null; } public function getAsserts() : Assertions { return Assertions::createEmpty(); } public function acceptsNamedArguments() : bool { return $this->declaringClass->acceptsNamedArguments(); } public function getSelfOutType() : ?Type { return null; } public function returnsByReference() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isAbstract() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isPure() : TrinaryLogic { if ($this->hasSideEffects()->yes()) { return TrinaryLogic::createNo(); } return TrinaryLogic::createMaybe(); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Annotations; use PHPStan\Reflection\ParameterReflectionWithPhpDocs; use PHPStan\Reflection\PassedByReference; use PHPStan\TrinaryLogic; use PHPStan\Type\MixedType; use PHPStan\Type\Type; final class AnnotationsMethodParameterReflection implements ParameterReflectionWithPhpDocs { /** * @var string */ private $name; /** * @var Type */ private $type; /** * @var PassedByReference */ private $passedByReference; /** * @var bool */ private $isOptional; /** * @var bool */ private $isVariadic; /** * @var ?Type */ private $defaultValue; public function __construct(string $name, Type $type, PassedByReference $passedByReference, bool $isOptional, bool $isVariadic, ?Type $defaultValue) { $this->name = $name; $this->type = $type; $this->passedByReference = $passedByReference; $this->isOptional = $isOptional; $this->isVariadic = $isVariadic; $this->defaultValue = $defaultValue; } public function getName() : string { return $this->name; } public function isOptional() : bool { return $this->isOptional; } public function getType() : Type { return $this->type; } public function getPhpDocType() : Type { return $this->type; } public function getNativeType() : Type { return new MixedType(); } public function getOutType() : ?Type { return null; } public function isImmediatelyInvokedCallable() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getClosureThisType() : ?Type { return null; } public function passedByReference() : PassedByReference { return $this->passedByReference; } public function isVariadic() : bool { return $this->isVariadic; } public function getDefaultValue() : ?Type { return $this->defaultValue; } } <?php declare (strict_types=1); namespace PHPStan\Reflection; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\Type; /** @api */ interface ParametersAcceptor { public const VARIADIC_FUNCTIONS = ['func_get_args', 'func_get_arg', 'func_num_args']; public function getTemplateTypeMap() : TemplateTypeMap; public function getResolvedTemplateTypeMap() : TemplateTypeMap; /** * @return array<int, ParameterReflection> */ public function getParameters() : array; public function isVariadic() : bool; public function getReturnType() : Type; } <?php declare (strict_types=1); namespace PHPStan\Reflection; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\Generic\TemplateTypeVarianceMap; use PHPStan\Type\Type; /** * @api */ class FunctionVariant implements \PHPStan\Reflection\ParametersAcceptor { /** * @var TemplateTypeMap */ private $templateTypeMap; /** * @var ?TemplateTypeMap */ private $resolvedTemplateTypeMap; /** * @var array<int, ParameterReflection> */ private $parameters; /** * @var bool */ private $isVariadic; /** * @var Type */ private $returnType; /** * @var TemplateTypeVarianceMap */ private $callSiteVarianceMap; /** * @api * @param array<int, ParameterReflection> $parameters */ public function __construct(TemplateTypeMap $templateTypeMap, ?TemplateTypeMap $resolvedTemplateTypeMap, array $parameters, bool $isVariadic, Type $returnType, ?TemplateTypeVarianceMap $callSiteVarianceMap = null) { $this->templateTypeMap = $templateTypeMap; $this->resolvedTemplateTypeMap = $resolvedTemplateTypeMap; $this->parameters = $parameters; $this->isVariadic = $isVariadic; $this->returnType = $returnType; $this->callSiteVarianceMap = $callSiteVarianceMap ?? TemplateTypeVarianceMap::createEmpty(); } public function getTemplateTypeMap() : TemplateTypeMap { return $this->templateTypeMap; } public function getResolvedTemplateTypeMap() : TemplateTypeMap { return $this->resolvedTemplateTypeMap ?? TemplateTypeMap::createEmpty(); } public function getCallSiteVarianceMap() : TemplateTypeVarianceMap { return $this->callSiteVarianceMap; } /** * @return array<int, ParameterReflection> */ public function getParameters() : array { return $this->parameters; } public function isVariadic() : bool { return $this->isVariadic; } public function getReturnType() : Type { return $this->returnType; } } <?php declare (strict_types=1); namespace PHPStan\Reflection; use PHPStan\Reflection\Php\DummyParameterWithPhpDocs; use PHPStan\TrinaryLogic; use PHPStan\Type\Generic\TemplateTypeVarianceMap; use PHPStan\Type\MixedType; use PHPStan\Type\Type; use function array_map; final class WrappedExtendedMethodReflection implements \PHPStan\Reflection\ExtendedMethodReflection { /** * @var MethodReflection */ private $method; public function __construct(\PHPStan\Reflection\MethodReflection $method) { $this->method = $method; } public function getDeclaringClass() : \PHPStan\Reflection\ClassReflection { return $this->method->getDeclaringClass(); } public function isStatic() : bool { return $this->method->isStatic(); } public function isPrivate() : bool { return $this->method->isPrivate(); } public function isPublic() : bool { return $this->method->isPublic(); } public function getDocComment() : ?string { return $this->method->getDocComment(); } public function getName() : string { return $this->method->getName(); } public function getPrototype() : \PHPStan\Reflection\ClassMemberReflection { return $this->method->getPrototype(); } public function getVariants() : array { $variants = []; foreach ($this->method->getVariants() as $variant) { if ($variant instanceof \PHPStan\Reflection\ParametersAcceptorWithPhpDocs) { $variants[] = $variant; continue; } $variants[] = new \PHPStan\Reflection\FunctionVariantWithPhpDocs($variant->getTemplateTypeMap(), $variant->getResolvedTemplateTypeMap(), array_map(static function (\PHPStan\Reflection\ParameterReflection $parameter) : \PHPStan\Reflection\ParameterReflectionWithPhpDocs { return $parameter instanceof \PHPStan\Reflection\ParameterReflectionWithPhpDocs ? $parameter : new DummyParameterWithPhpDocs($parameter->getName(), $parameter->getType(), $parameter->isOptional(), $parameter->passedByReference(), $parameter->isVariadic(), $parameter->getDefaultValue(), new MixedType(), $parameter->getType(), null, TrinaryLogic::createMaybe(), null); }, $variant->getParameters()), $variant->isVariadic(), $variant->getReturnType(), $variant->getReturnType(), new MixedType(), TemplateTypeVarianceMap::createEmpty()); } return $variants; } public function getOnlyVariant() : \PHPStan\Reflection\ParametersAcceptorWithPhpDocs { return $this->getVariants()[0]; } public function getNamedArgumentsVariants() : ?array { return null; } public function isDeprecated() : TrinaryLogic { return $this->method->isDeprecated(); } public function getDeprecatedDescription() : ?string { return $this->method->getDeprecatedDescription(); } public function isFinal() : TrinaryLogic { return $this->method->isFinal(); } public function isFinalByKeyword() : TrinaryLogic { return $this->isFinal(); } public function isInternal() : TrinaryLogic { return $this->method->isInternal(); } public function getThrowType() : ?Type { return $this->method->getThrowType(); } public function hasSideEffects() : TrinaryLogic { return $this->method->hasSideEffects(); } public function isPure() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getAsserts() : \PHPStan\Reflection\Assertions { return \PHPStan\Reflection\Assertions::createEmpty(); } public function acceptsNamedArguments() : bool { return $this->getDeclaringClass()->acceptsNamedArguments(); } public function getSelfOutType() : ?Type { return null; } public function returnsByReference() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isAbstract() : TrinaryLogic { return TrinaryLogic::createNo(); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Dummy; use PHPStan\Reflection\Assertions; use PHPStan\Reflection\ClassMemberReflection; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\FunctionVariantWithPhpDocs; use PHPStan\Reflection\ParametersAcceptorWithPhpDocs; use PHPStan\TrinaryLogic; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\MixedType; use PHPStan\Type\Type; use PHPStan\Type\VoidType; final class DummyConstructorReflection implements ExtendedMethodReflection { /** * @var ClassReflection */ private $declaringClass; public function __construct(ClassReflection $declaringClass) { $this->declaringClass = $declaringClass; } public function getDeclaringClass() : ClassReflection { return $this->declaringClass; } public function isStatic() : bool { return \false; } public function isPrivate() : bool { return \false; } public function isPublic() : bool { return \true; } public function getName() : string { return '__construct'; } public function getPrototype() : ClassMemberReflection { return $this; } public function getVariants() : array { return [new FunctionVariantWithPhpDocs(TemplateTypeMap::createEmpty(), null, [], \false, new VoidType(), new MixedType(), new MixedType(), null)]; } public function getOnlyVariant() : ParametersAcceptorWithPhpDocs { return $this->getVariants()[0]; } public function getNamedArgumentsVariants() : ?array { return null; } public function isDeprecated() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getDeprecatedDescription() : ?string { return null; } public function isFinal() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isInternal() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getThrowType() : ?Type { return null; } public function hasSideEffects() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getDocComment() : ?string { return null; } public function getAsserts() : Assertions { return Assertions::createEmpty(); } public function acceptsNamedArguments() : bool { return $this->declaringClass->acceptsNamedArguments(); } public function getSelfOutType() : ?Type { return null; } public function returnsByReference() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFinalByKeyword() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isAbstract() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isPure() : TrinaryLogic { return TrinaryLogic::createYes(); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Dummy; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ExtendedPropertyReflection; use PHPStan\Reflection\ReflectionProviderStaticAccessor; use PHPStan\TrinaryLogic; use PHPStan\Type\MixedType; use PHPStan\Type\Type; use stdClass; final class DummyPropertyReflection implements ExtendedPropertyReflection { public function getDeclaringClass() : ClassReflection { $reflectionProvider = ReflectionProviderStaticAccessor::getInstance(); return $reflectionProvider->getClass(stdClass::class); } public function isStatic() : bool { return \false; } public function isPrivate() : bool { return \false; } public function isPublic() : bool { return \true; } public function getReadableType() : Type { return new MixedType(); } public function getWritableType() : Type { return new MixedType(); } public function canChangeTypeAfterAssignment() : bool { return \true; } public function isReadable() : bool { return \true; } public function isWritable() : bool { return \true; } public function isDeprecated() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getDeprecatedDescription() : ?string { return null; } public function isInternal() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getDocComment() : ?string { return null; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Dummy; use PHPStan\Reflection\Assertions; use PHPStan\Reflection\ClassMemberReflection; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\ParametersAcceptorWithPhpDocs; use PHPStan\ShouldNotHappenException; use PHPStan\TrinaryLogic; use PHPStan\Type\Type; use function count; use function is_bool; final class ChangedTypeMethodReflection implements ExtendedMethodReflection { /** * @var ClassReflection */ private $declaringClass; /** * @var ExtendedMethodReflection */ private $reflection; /** * @var ParametersAcceptorWithPhpDocs[] */ private $variants; /** * @var ParametersAcceptorWithPhpDocs[]|null */ private $namedArgumentsVariants; /** * @param ParametersAcceptorWithPhpDocs[] $variants * @param ParametersAcceptorWithPhpDocs[]|null $namedArgumentsVariants */ public function __construct(ClassReflection $declaringClass, ExtendedMethodReflection $reflection, array $variants, ?array $namedArgumentsVariants) { $this->declaringClass = $declaringClass; $this->reflection = $reflection; $this->variants = $variants; $this->namedArgumentsVariants = $namedArgumentsVariants; } public function getDeclaringClass() : ClassReflection { return $this->declaringClass; } public function isStatic() : bool { return $this->reflection->isStatic(); } public function isPrivate() : bool { return $this->reflection->isPrivate(); } public function isPublic() : bool { return $this->reflection->isPublic(); } public function getDocComment() : ?string { return $this->reflection->getDocComment(); } public function getName() : string { return $this->reflection->getName(); } public function getPrototype() : ClassMemberReflection { return $this->reflection->getPrototype(); } public function getVariants() : array { return $this->variants; } public function getOnlyVariant() : ParametersAcceptorWithPhpDocs { $variants = $this->getVariants(); if (count($variants) !== 1) { throw new ShouldNotHappenException(); } return $variants[0]; } public function getNamedArgumentsVariants() : ?array { return $this->namedArgumentsVariants; } public function isDeprecated() : TrinaryLogic { return $this->reflection->isDeprecated(); } public function getDeprecatedDescription() : ?string { return $this->reflection->getDeprecatedDescription(); } public function isFinal() : TrinaryLogic { return $this->reflection->isFinal(); } public function isFinalByKeyword() : TrinaryLogic { return $this->reflection->isFinalByKeyword(); } public function isInternal() : TrinaryLogic { return $this->reflection->isInternal(); } public function getThrowType() : ?Type { return $this->reflection->getThrowType(); } public function hasSideEffects() : TrinaryLogic { return $this->reflection->hasSideEffects(); } public function getAsserts() : Assertions { return $this->reflection->getAsserts(); } public function acceptsNamedArguments() : bool { return $this->reflection->acceptsNamedArguments(); } public function getSelfOutType() : ?Type { return $this->reflection->getSelfOutType(); } public function returnsByReference() : TrinaryLogic { return $this->reflection->returnsByReference(); } public function isAbstract() : TrinaryLogic { $abstract = $this->reflection->isAbstract(); if (is_bool($abstract)) { return TrinaryLogic::createFromBoolean($abstract); } return $abstract; } public function isPure() : TrinaryLogic { return $this->reflection->isPure(); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Dummy; use PHPStan\Reflection\Assertions; use PHPStan\Reflection\ClassMemberReflection; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\ParametersAcceptorWithPhpDocs; use PHPStan\Reflection\ReflectionProviderStaticAccessor; use PHPStan\Reflection\TrivialParametersAcceptor; use PHPStan\TrinaryLogic; use PHPStan\Type\Type; use stdClass; final class DummyMethodReflection implements ExtendedMethodReflection { /** * @var string */ private $name; public function __construct(string $name) { $this->name = $name; } public function getDeclaringClass() : ClassReflection { $reflectionProvider = ReflectionProviderStaticAccessor::getInstance(); return $reflectionProvider->getClass(stdClass::class); } public function isStatic() : bool { return \false; } public function isPrivate() : bool { return \false; } public function isPublic() : bool { return \true; } public function getName() : string { return $this->name; } public function getPrototype() : ClassMemberReflection { return $this; } public function getVariants() : array { return [new TrivialParametersAcceptor()]; } public function getOnlyVariant() : ParametersAcceptorWithPhpDocs { return $this->getVariants()[0]; } public function getNamedArgumentsVariants() : ?array { return null; } public function isDeprecated() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getDeprecatedDescription() : ?string { return null; } public function isFinal() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isFinalByKeyword() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isInternal() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getThrowType() : ?Type { return null; } public function hasSideEffects() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getDocComment() : ?string { return null; } public function getAsserts() : Assertions { return Assertions::createEmpty(); } public function acceptsNamedArguments() : bool { return \true; } public function getSelfOutType() : ?Type { return null; } public function returnsByReference() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isAbstract() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isPure() : TrinaryLogic { return TrinaryLogic::createMaybe(); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Dummy; use PhpParser\Node\Expr; use PHPStan\Node\Expr\TypeExpr; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ConstantReflection; use PHPStan\Reflection\ReflectionProviderStaticAccessor; use PHPStan\TrinaryLogic; use PHPStan\Type\MixedType; use PHPStan\Type\Type; use stdClass; final class DummyConstantReflection implements ConstantReflection { /** * @var string */ private $name; public function __construct(string $name) { $this->name = $name; } public function getDeclaringClass() : ClassReflection { $reflectionProvider = ReflectionProviderStaticAccessor::getInstance(); return $reflectionProvider->getClass(stdClass::class); } public function getFileName() : ?string { return null; } public function isStatic() : bool { return \true; } public function isPrivate() : bool { return \false; } public function isPublic() : bool { return \true; } public function getName() : string { return $this->name; } /** * @deprecated * @return mixed */ public function getValue() { // so that Scope::getTypeFromValue() returns mixed return new stdClass(); } public function getValueType() : Type { return new MixedType(); } public function getValueExpr() : Expr { return new TypeExpr(new MixedType()); } public function isDeprecated() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getDeprecatedDescription() : ?string { return null; } public function isInternal() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getDocComment() : ?string { return null; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Dummy; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ExtendedPropertyReflection; use PHPStan\Reflection\WrapperPropertyReflection; use PHPStan\TrinaryLogic; use PHPStan\Type\Type; final class ChangedTypePropertyReflection implements WrapperPropertyReflection { /** * @var ClassReflection */ private $declaringClass; /** * @var ExtendedPropertyReflection */ private $reflection; /** * @var Type */ private $readableType; /** * @var Type */ private $writableType; public function __construct(ClassReflection $declaringClass, ExtendedPropertyReflection $reflection, Type $readableType, Type $writableType) { $this->declaringClass = $declaringClass; $this->reflection = $reflection; $this->readableType = $readableType; $this->writableType = $writableType; } public function getDeclaringClass() : ClassReflection { return $this->declaringClass; } public function isStatic() : bool { return $this->reflection->isStatic(); } public function isPrivate() : bool { return $this->reflection->isPrivate(); } public function isPublic() : bool { return $this->reflection->isPublic(); } public function getDocComment() : ?string { return $this->reflection->getDocComment(); } public function getReadableType() : Type { return $this->readableType; } public function getWritableType() : Type { return $this->writableType; } public function canChangeTypeAfterAssignment() : bool { return $this->reflection->canChangeTypeAfterAssignment(); } public function isReadable() : bool { return $this->reflection->isReadable(); } public function isWritable() : bool { return $this->reflection->isWritable(); } public function isDeprecated() : TrinaryLogic { return $this->reflection->isDeprecated(); } public function getDeprecatedDescription() : ?string { return $this->reflection->getDeprecatedDescription(); } public function isInternal() : TrinaryLogic { return $this->reflection->isInternal(); } public function getOriginalReflection() : ExtendedPropertyReflection { return $this->reflection; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\BetterReflection\SourceLocator; use PhpParser\Node; final class FetchedNodesResult { /** * @var array<string, array<FetchedNode<Node\Stmt\ClassLike>>> */ private $classNodes; /** * @var array<string, array<FetchedNode<Node\Stmt\Function_>>> */ private $functionNodes; /** * @var array<string, array<FetchedNode<Node\Stmt\Const_|Node\Expr\FuncCall>>> */ private $constantNodes; /** * @param array<string, array<FetchedNode<Node\Stmt\ClassLike>>> $classNodes * @param array<string, array<FetchedNode<Node\Stmt\Function_>>> $functionNodes * @param array<string, array<FetchedNode<Node\Stmt\Const_|Node\Expr\FuncCall>>> $constantNodes */ public function __construct(array $classNodes, array $functionNodes, array $constantNodes) { $this->classNodes = $classNodes; $this->functionNodes = $functionNodes; $this->constantNodes = $constantNodes; } /** * @return array<string, array<FetchedNode<Node\Stmt\ClassLike>>> */ public function getClassNodes() : array { return $this->classNodes; } /** * @return array<string, array<FetchedNode<Node\Stmt\Function_>>> */ public function getFunctionNodes() : array { return $this->functionNodes; } /** * @return array<string, array<FetchedNode<Node\Stmt\Const_|Node\Expr\FuncCall>>> */ public function getConstantNodes() : array { return $this->constantNodes; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\BetterReflection\SourceLocator; use PHPStan\BetterReflection\Identifier\Identifier; use PHPStan\BetterReflection\Identifier\IdentifierType; use PHPStan\BetterReflection\Reflection\Reflection; use PHPStan\BetterReflection\Reflector\Reflector; use PHPStan\BetterReflection\SourceLocator\Type\SourceLocator; use ReflectionClass; use function class_exists; final class SkipClassAliasSourceLocator implements SourceLocator { /** * @var SourceLocator */ private $sourceLocator; public function __construct(SourceLocator $sourceLocator) { $this->sourceLocator = $sourceLocator; } public function locateIdentifier(Reflector $reflector, Identifier $identifier) : ?Reflection { if ($identifier->isClass()) { $className = $identifier->getName(); if (!class_exists($className, \false)) { return $this->sourceLocator->locateIdentifier($reflector, $identifier); } $reflection = new ReflectionClass($className); if ($reflection->getName() === 'ReturnTypeWillChange') { return $this->sourceLocator->locateIdentifier($reflector, $identifier); } if ($reflection->getFileName() === \false) { return $this->sourceLocator->locateIdentifier($reflector, $identifier); } return null; } return $this->sourceLocator->locateIdentifier($reflector, $identifier); } public function locateIdentifiersByType(Reflector $reflector, IdentifierType $identifierType) : array { return $this->sourceLocator->locateIdentifiersByType($reflector, $identifierType); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\BetterReflection\SourceLocator; use PhpParser\Node; use PhpParser\Node\Stmt\Namespace_; use PhpParser\NodeTraverser; use PhpParser\NodeVisitorAbstract; use PHPStan\BetterReflection\Reflection\Exception\InvalidConstantNode; use PHPStan\BetterReflection\SourceLocator\Located\LocatedSource; use PHPStan\BetterReflection\Util\ConstantNodeChecker; use PHPStan\Reflection\ConstantNameHelper; use function strtolower; final class CachingVisitor extends NodeVisitorAbstract { /** * @var string */ private $fileName; /** * @var string */ private $contents; /** @var array<string, array<FetchedNode<Node\Stmt\ClassLike>>> */ private $classNodes; /** @var array<string, array<FetchedNode<Node\Stmt\Function_>>> */ private $functionNodes; /** @var array<string, array<FetchedNode<Node\Stmt\Const_|Node\Expr\FuncCall>>> */ private $constantNodes; /** * @var ?Node\Stmt\Namespace_ */ private $currentNamespaceNode = null; public function enterNode(Node $node) : ?int { if ($node instanceof Namespace_) { $this->currentNamespaceNode = $node; return null; } if ($node instanceof Node\Stmt\ClassLike) { if ($node->name !== null) { $fullClassName = $node->name->toString(); if ($this->currentNamespaceNode !== null && $this->currentNamespaceNode->name !== null) { $fullClassName = $this->currentNamespaceNode->name . '\\' . $fullClassName; } $this->classNodes[strtolower($fullClassName)][] = new \PHPStan\Reflection\BetterReflection\SourceLocator\FetchedNode($node, $this->currentNamespaceNode, new LocatedSource($this->contents, $fullClassName, $this->fileName)); } return NodeTraverser::DONT_TRAVERSE_CHILDREN; } if ($node instanceof Node\Stmt\Function_) { if ($node->namespacedName !== null) { $functionName = $node->namespacedName->toString(); $this->functionNodes[strtolower($functionName)][] = new \PHPStan\Reflection\BetterReflection\SourceLocator\FetchedNode($node, $this->currentNamespaceNode, new LocatedSource($this->contents, $functionName, $this->fileName)); } return NodeTraverser::DONT_TRAVERSE_CHILDREN; } if ($node instanceof Node\Stmt\Const_) { foreach ($node->consts as $const) { if ($const->namespacedName === null) { continue; } $this->constantNodes[ConstantNameHelper::normalize($const->namespacedName->toString())][] = new \PHPStan\Reflection\BetterReflection\SourceLocator\FetchedNode($node, $this->currentNamespaceNode, new LocatedSource($this->contents, null, $this->fileName)); } return NodeTraverser::DONT_TRAVERSE_CHILDREN; } if ($node instanceof Node\Expr\FuncCall) { try { ConstantNodeChecker::assertValidDefineFunctionCall($node); } catch (InvalidConstantNode $e) { return null; } /** @var Node\Scalar\String_ $nameNode */ $nameNode = $node->getArgs()[0]->value; $constantName = $nameNode->value; $constantNode = new \PHPStan\Reflection\BetterReflection\SourceLocator\FetchedNode($node, $this->currentNamespaceNode, new LocatedSource($this->contents, $constantName, $this->fileName)); $this->constantNodes[ConstantNameHelper::normalize($constantName)][] = $constantNode; return NodeTraverser::DONT_TRAVERSE_CHILDREN; } return null; } /** * @return null */ public function leaveNode(Node $node) { if (!$node instanceof Namespace_) { return null; } $this->currentNamespaceNode = null; return null; } /** * @return array<string, array<FetchedNode<Node\Stmt\ClassLike>>> */ public function getClassNodes() : array { return $this->classNodes; } /** * @return array<string, array<FetchedNode<Node\Stmt\Function_>>> */ public function getFunctionNodes() : array { return $this->functionNodes; } /** * @return array<string, array<FetchedNode<Node\Stmt\Const_|Node\Expr\FuncCall>>> */ public function getConstantNodes() : array { return $this->constantNodes; } public function reset(string $fileName, string $contents) : void { $this->classNodes = []; $this->functionNodes = []; $this->constantNodes = []; $this->fileName = $fileName; $this->contents = $contents; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\BetterReflection\SourceLocator; use PHPStan\Cache\Cache; use PHPStan\File\FileFinder; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\ConstantNameHelper; use function array_key_exists; use function count; use function in_array; use function ltrim; use function php_strip_whitespace; use function preg_match_all; use function preg_replace; use function sha1_file; use function sprintf; use function strtolower; final class OptimizedDirectorySourceLocatorFactory { /** * @var FileNodesFetcher */ private $fileNodesFetcher; /** * @var FileFinder */ private $fileFinder; /** * @var PhpVersion */ private $phpVersion; /** * @var Cache */ private $cache; /** * @var PhpFileCleaner */ private $cleaner; /** * @var string */ private $extraTypes; public function __construct(\PHPStan\Reflection\BetterReflection\SourceLocator\FileNodesFetcher $fileNodesFetcher, FileFinder $fileFinder, PhpVersion $phpVersion, Cache $cache) { $this->fileNodesFetcher = $fileNodesFetcher; $this->fileFinder = $fileFinder; $this->phpVersion = $phpVersion; $this->cache = $cache; $this->extraTypes = $this->phpVersion->supportsEnums() ? '|enum' : ''; $this->cleaner = new \PHPStan\Reflection\BetterReflection\SourceLocator\PhpFileCleaner(); } public function createByDirectory(string $directory) : \PHPStan\Reflection\BetterReflection\SourceLocator\NewOptimizedDirectorySourceLocator { $files = $this->fileFinder->findFiles([$directory])->getFiles(); $fileHashes = []; foreach ($files as $file) { $hash = sha1_file($file); if ($hash === \false) { continue; } $fileHashes[$file] = $hash; } $cacheKey = sprintf('odsl-%s', $directory); $variableCacheKey = 'v1'; /** @var array<string, array{string, string[], string[], string[]}>|null $cached */ $cached = $this->cache->load($cacheKey, $variableCacheKey); if ($cached !== null) { foreach ($cached as $file => [$hash, $classes, $functions, $constants]) { if (!array_key_exists($file, $fileHashes)) { unset($cached[$file]); continue; } $newHash = $fileHashes[$file]; unset($fileHashes[$file]); if ($hash === $newHash) { continue; } [$newClasses, $newFunctions, $newConstants] = $this->findSymbols($file); $cached[$file] = [$newHash, $newClasses, $newFunctions, $newConstants]; } } else { $cached = []; } foreach ($fileHashes as $file => $newHash) { [$newClasses, $newFunctions, $newConstants] = $this->findSymbols($file); $cached[$file] = [$newHash, $newClasses, $newFunctions, $newConstants]; } $this->cache->save($cacheKey, $variableCacheKey, $cached); [$classToFile, $functionToFiles, $constantToFile] = $this->changeStructure($cached); return new \PHPStan\Reflection\BetterReflection\SourceLocator\NewOptimizedDirectorySourceLocator($this->fileNodesFetcher, $classToFile, $functionToFiles, $constantToFile); } /** * @param string[] $files */ public function createByFiles(array $files) : \PHPStan\Reflection\BetterReflection\SourceLocator\NewOptimizedDirectorySourceLocator { $symbols = []; foreach ($files as $file) { [$newClasses, $newFunctions, $newConstants] = $this->findSymbols($file); $symbols[$file] = ['', $newClasses, $newFunctions, $newConstants]; } [$classToFile, $functionToFiles, $constantToFile] = $this->changeStructure($symbols); return new \PHPStan\Reflection\BetterReflection\SourceLocator\NewOptimizedDirectorySourceLocator($this->fileNodesFetcher, $classToFile, $functionToFiles, $constantToFile); } /** * @param array<string, array{string, string[], string[], string[]}> $symbols * @return array{array<string, string>, array<string, array<int, string>>, array<string, string>} */ private function changeStructure(array $symbols) : array { $classToFile = []; $constantToFile = []; $functionToFiles = []; foreach ($symbols as $file => [, $classes, $functions, $constants]) { foreach ($classes as $classInFile) { $classToFile[$classInFile] = $file; } foreach ($functions as $functionInFile) { if (!array_key_exists($functionInFile, $functionToFiles)) { $functionToFiles[$functionInFile] = []; } $functionToFiles[$functionInFile][] = $file; } foreach ($constants as $constantInFile) { $constantToFile[$constantInFile] = $file; } } return [$classToFile, $functionToFiles, $constantToFile]; } /** * Inspired by Composer\Autoload\ClassMapGenerator::findClasses() * @link https://github.com/composer/composer/blob/45d3e133a4691eccb12e9cd6f9dfd76eddc1906d/src/Composer/Autoload/ClassMapGenerator.php#L216 * * @return array{string[], string[], string[]} */ private function findSymbols(string $file) : array { $contents = @php_strip_whitespace($file); if ($contents === '') { return [[], [], []]; } $matchResults = (bool) preg_match_all(sprintf('{\\b(?:(?:class|interface|trait|const|function%s)\\s)|(?:define\\s*\\()}i', $this->extraTypes), $contents, $matches); if (!$matchResults) { return [[], [], []]; } $contents = $this->cleaner->clean($contents, count($matches[0])); preg_match_all(sprintf('{ (?: \\b(?<![\\$:>])(?: (?: (?P<type>class|interface|trait%s) \\s++ (?P<name>[a-zA-Z_\\x7f-\\xff][a-zA-Z0-9_\\x7f-\\xff\\-]*+) ) | (?: (?P<function>function) \\s++ (?:&\\s*)? (?P<fname>[a-zA-Z_\\x7f-\\xff][a-zA-Z0-9_\\x7f-\\xff\\-]*+) \\s*+ [&\\(] ) | (?: (?P<constant>const) \\s++ (?P<cname>[a-zA-Z_\\x7f-\\xff][a-zA-Z0-9_\\x7f-\\xff\\-]*+) \\s*+ [^;] ) | (?: (?:\\\\)? (?P<define>define) \\s*+ \\( \\s*+ [\'"] (?P<dname>[a-zA-Z_\\x7f-\\xff][a-zA-Z0-9_\\x7f-\\xff]*+(?:[\\\\]{1,2}[a-zA-Z_\\x7f-\\xff][a-zA-Z0-9_\\x7f-\\xff]*+)*+) ) | (?: (?P<ns>namespace) (?P<nsname>\\s++[a-zA-Z_\\x7f-\\xff][a-zA-Z0-9_\\x7f-\\xff]*+(?:\\s*+\\\\\\s*+[a-zA-Z_\\x7f-\\xff][a-zA-Z0-9_\\x7f-\\xff]*+)*+)? \\s*+ [\\{;] ) ) ) }ix', $this->extraTypes), $contents, $matches); $classes = []; $functions = []; $constants = []; $namespace = ''; for ($i = 0, $len = count($matches['type']); $i < $len; $i++) { if (isset($matches['ns'][$i]) && $matches['ns'][$i] !== '') { $namespace = preg_replace('~\\s+~', '', strtolower($matches['nsname'][$i])) . '\\'; continue; } if ($matches['function'][$i] !== '') { $functions[] = strtolower(ltrim($namespace . $matches['fname'][$i], '\\')); continue; } if ($matches['constant'][$i] !== '') { $constants[] = ConstantNameHelper::normalize(ltrim($namespace . $matches['cname'][$i], '\\')); } if ($matches['define'][$i] !== '') { $constants[] = ConstantNameHelper::normalize($matches['dname'][$i]); continue; } $name = $matches['name'][$i]; // skip anon classes extending/implementing if (in_array($name, ['extends', 'implements'], \true)) { continue; } $classes[] = strtolower(ltrim($namespace . $name, '\\')); } return [$classes, $functions, $constants]; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\BetterReflection\SourceLocator; use PHPStan\BetterReflection\Identifier\Identifier; use PHPStan\BetterReflection\Identifier\IdentifierType; use PHPStan\BetterReflection\Reflection\Reflection; use PHPStan\BetterReflection\Reflector\Reflector; use PHPStan\BetterReflection\SourceLocator\SourceStubber\PhpStormStubsSourceStubber; use PHPStan\BetterReflection\SourceLocator\Type\SourceLocator; final class PhpVersionBlacklistSourceLocator implements SourceLocator { /** * @var SourceLocator */ private $sourceLocator; /** * @var PhpStormStubsSourceStubber */ private $phpStormStubsSourceStubber; public function __construct(SourceLocator $sourceLocator, PhpStormStubsSourceStubber $phpStormStubsSourceStubber) { $this->sourceLocator = $sourceLocator; $this->phpStormStubsSourceStubber = $phpStormStubsSourceStubber; } public function locateIdentifier(Reflector $reflector, Identifier $identifier) : ?Reflection { if ($identifier->isClass()) { if ($this->phpStormStubsSourceStubber->isPresentClass($identifier->getName()) === \false) { return null; } } if ($identifier->isFunction()) { if ($this->phpStormStubsSourceStubber->isPresentFunction($identifier->getName()) === \false) { return null; } } return $this->sourceLocator->locateIdentifier($reflector, $identifier); } public function locateIdentifiersByType(Reflector $reflector, IdentifierType $identifierType) : array { return $this->sourceLocator->locateIdentifiersByType($reflector, $identifierType); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\BetterReflection\SourceLocator; use function array_keys; use function implode; use function in_array; use function preg_match; use function preg_quote; use function strlen; use function substr; /** * @author Jordi Boggiano <j.boggiano@seld.be> * @see https://github.com/composer/composer/pull/10107 */ final class PhpFileCleaner { /** @var array<array{name: string, length: int, pattern: string}> */ private $typeConfig = []; /** * @var string */ private $restPattern; /** * @var string */ private $contents = ''; /** * @var int */ private $len = 0; /** * @var int */ private $index = 0; public function __construct() { foreach (['class', 'interface', 'trait', 'enum'] as $type) { $this->typeConfig[$type[0]] = ['name' => $type, 'length' => strlen($type), 'pattern' => '{.\\b(?<![\\$:>])' . $type . '\\s++[a-zA-Z_\\x7f-\\xff][a-zA-Z0-9_\\x7f-\\xff\\-]*+}Ais']; } $this->restPattern = '{[^{}?"\'</d' . implode('', array_keys($this->typeConfig)) . ']+}A'; } public function clean(string $contents, int $maxMatches) : string { $this->contents = $contents; $this->len = strlen($contents); $this->index = 0; $inType = \false; $typeLevel = 0; $inDefine = \false; $clean = ''; while ($this->index < $this->len) { $this->skipToPhp(); $clean .= '<?'; while ($this->index < $this->len) { $char = $this->contents[$this->index]; if ($char === '?' && $this->peek('>')) { $clean .= '?>'; $this->index += 2; continue 2; } if (in_array($char, ['"', "'"], \true)) { if ($inDefine) { $clean .= $char . $this->consumeString($char); $inDefine = \false; } else { $this->skipString($char); $clean .= 'null'; } continue; } if ($char === '{') { if ($inType) { $typeLevel++; } $clean .= $char; $this->index++; continue; } if ($char === '}') { if ($inType) { $typeLevel--; if ($typeLevel === 0) { $inType = \false; } } $clean .= $char; $this->index++; continue; } if ($char === '<' && $this->peek('<') && $this->match('{<<<[ \\t]*+([\'"]?)([a-zA-Z_\\x80-\\xff][a-zA-Z0-9_\\x80-\\xff]*+)\\1(?:\\r\\n|\\n|\\r)}A', $match)) { $this->index += strlen($match[0]); $this->skipHeredoc($match[2]); $clean .= 'null'; continue; } if ($char === '/') { if ($this->peek('/')) { $this->skipToNewline(); continue; } if ($this->peek('*')) { $this->skipComment(); continue; } } if ($inType && $char === 'c' && $this->match('~.\\b(?<![\\$:>])const(\\s++[a-zA-Z_\\x7f-\\xff][a-zA-Z0-9_\\x7f-\\xff\\-]*+)~Ais', $match, $this->index - 1)) { // It's invalid PHP but it does not matter $clean .= 'class_const' . $match[1]; $this->index += strlen($match[0]) - 1; continue; } if ($char === 'd' && $this->match('~.\\b(?<![\\$:>])define\\s*+\\(~Ais', $match, $this->index - 1)) { $inDefine = \true; $clean .= $match[0]; $this->index += strlen($match[0]) - 1; continue; } if (isset($this->typeConfig[$char])) { $type = $this->typeConfig[$char]; if (substr($this->contents, $this->index, $type['length']) === $type['name']) { if ($maxMatches === 1 && $this->match($type['pattern'], $match, $this->index - 1)) { return $clean . $match[0]; } $inType = \true; } } $this->index += 1; if ($this->match($this->restPattern, $match)) { $clean .= $char . $match[0]; $this->index += strlen($match[0]); } else { $clean .= $char; } } } return $clean; } private function skipToPhp() : void { while ($this->index < $this->len) { if ($this->contents[$this->index] === '<' && $this->peek('?')) { $this->index += 2; break; } $this->index += 1; } } private function consumeString(string $delimiter) : string { $string = ''; $this->index += 1; while ($this->index < $this->len) { if ($this->contents[$this->index] === '\\' && ($this->peek('\\') || $this->peek($delimiter))) { $string .= $this->contents[$this->index]; $string .= $this->contents[$this->index + 1]; $this->index += 2; continue; } if ($this->contents[$this->index] === $delimiter) { $string .= $delimiter; $this->index += 1; break; } $string .= $this->contents[$this->index]; $this->index += 1; } return $string; } private function skipString(string $delimiter) : void { $this->index += 1; while ($this->index < $this->len) { if ($this->contents[$this->index] === '\\' && ($this->peek('\\') || $this->peek($delimiter))) { $this->index += 2; continue; } if ($this->contents[$this->index] === $delimiter) { $this->index += 1; break; } $this->index += 1; } } private function skipComment() : void { $this->index += 2; while ($this->index < $this->len) { if ($this->contents[$this->index] === '*' && $this->peek('/')) { $this->index += 2; break; } $this->index += 1; } } private function skipToNewline() : void { while ($this->index < $this->len) { if (in_array($this->contents[$this->index], ["\r", "\n"], \true)) { return; } $this->index += 1; } } private function skipHeredoc(string $delimiter) : void { $firstDelimiterChar = $delimiter[0]; $delimiterLength = strlen($delimiter); $delimiterPattern = '{' . preg_quote($delimiter) . '(?![a-zA-Z0-9_\\x80-\\xff])}A'; while ($this->index < $this->len) { // check if we find the delimiter after some spaces/tabs switch ($this->contents[$this->index]) { case "\t": case ' ': $this->index += 1; continue 2; case $firstDelimiterChar: if (substr($this->contents, $this->index, $delimiterLength) === $delimiter && $this->match($delimiterPattern)) { $this->index += $delimiterLength; return; } break; } // skip the rest of the line while ($this->index < $this->len) { $this->skipToNewline(); // skip newlines while ($this->index < $this->len && ($this->contents[$this->index] === "\r" || $this->contents[$this->index] === "\n")) { $this->index += 1; } break; } } } private function peek(string $char) : bool { return $this->index + 1 < $this->len && $this->contents[$this->index + 1] === $char; } /** * @param string[]|null $match * @param-out string[] $match */ private function match(string $regex, ?array &$match = null, ?int $offset = null) : bool { return preg_match($regex, $this->contents, $match, 0, $offset ?? $this->index) === 1; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\BetterReflection\SourceLocator; use PhpParser\Node; use PHPStan\BetterReflection\Identifier\Identifier; use PHPStan\BetterReflection\Identifier\IdentifierType; use PHPStan\BetterReflection\Reflection\Reflection; use PHPStan\BetterReflection\Reflector\Reflector; use PHPStan\BetterReflection\SourceLocator\Ast\Strategy\NodeToReflection; use PHPStan\BetterReflection\SourceLocator\Type\SourceLocator; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\ConstantNameHelper; use PHPStan\ShouldNotHappenException; use function array_key_exists; use function array_values; use function count; use function current; use function in_array; use function ltrim; use function php_strip_whitespace; use function preg_match_all; use function preg_replace; use function sprintf; use function strtolower; /** * @deprecated Use NewOptimizedDirectorySourceLocator */ final class OptimizedDirectorySourceLocator implements SourceLocator { /** * @var FileNodesFetcher */ private $fileNodesFetcher; /** * @var PhpVersion */ private $phpVersion; /** * @var string[] */ private $files; /** * @var PhpFileCleaner */ private $cleaner; /** * @var string */ private $extraTypes; /** @var array<string, string>|null */ private $classToFile = null; /** @var array<string, string>|null */ private $constantToFile = null; /** @var array<string, array<int, string>>|null */ private $functionToFiles = null; /** * @param string[] $files */ public function __construct(\PHPStan\Reflection\BetterReflection\SourceLocator\FileNodesFetcher $fileNodesFetcher, PhpVersion $phpVersion, array $files) { $this->fileNodesFetcher = $fileNodesFetcher; $this->phpVersion = $phpVersion; $this->files = $files; $this->extraTypes = $this->phpVersion->supportsEnums() ? '|enum' : ''; $this->cleaner = new \PHPStan\Reflection\BetterReflection\SourceLocator\PhpFileCleaner(); } public function locateIdentifier(Reflector $reflector, Identifier $identifier) : ?Reflection { if ($identifier->isClass()) { $className = strtolower($identifier->getName()); $file = $this->findFileByClass($className); if ($file === null) { return null; } $fetchedClassNodes = $this->fileNodesFetcher->fetchNodes($file)->getClassNodes(); if (!array_key_exists($className, $fetchedClassNodes)) { return null; } /** @var FetchedNode<Node\Stmt\ClassLike> $fetchedClassNode */ $fetchedClassNode = current($fetchedClassNodes[$className]); return $this->nodeToReflection($reflector, $fetchedClassNode); } if ($identifier->isFunction()) { $functionName = strtolower($identifier->getName()); $files = $this->findFilesByFunction($functionName); $fetchedFunctionNode = null; foreach ($files as $file) { $fetchedFunctionNodes = $this->fileNodesFetcher->fetchNodes($file)->getFunctionNodes(); if (!array_key_exists($functionName, $fetchedFunctionNodes)) { continue; } /** @var FetchedNode<Node\Stmt\Function_> $fetchedFunctionNode */ $fetchedFunctionNode = current($fetchedFunctionNodes[$functionName]); } if ($fetchedFunctionNode === null) { return null; } return $this->nodeToReflection($reflector, $fetchedFunctionNode); } if ($identifier->isConstant()) { $constantName = ConstantNameHelper::normalize($identifier->getName()); $file = $this->findFileByConstant($constantName); if ($file === null) { return null; } $fetchedConstantNodes = $this->fileNodesFetcher->fetchNodes($file)->getConstantNodes(); if (!array_key_exists($constantName, $fetchedConstantNodes)) { return null; } /** @var FetchedNode<Node\Stmt\Const_|Node\Expr\FuncCall> $fetchedConstantNode */ $fetchedConstantNode = current($fetchedConstantNodes[$constantName]); return $this->nodeToReflection($reflector, $fetchedConstantNode, $this->findConstantPositionInConstNode($fetchedConstantNode->getNode(), $constantName)); } return null; } /** * @param FetchedNode<Node\Stmt\ClassLike>|FetchedNode<Node\Stmt\Function_>|FetchedNode<Node\Stmt\Const_|Node\Expr\FuncCall> $fetchedNode */ private function nodeToReflection(Reflector $reflector, \PHPStan\Reflection\BetterReflection\SourceLocator\FetchedNode $fetchedNode, ?int $positionInNode = null) : Reflection { $nodeToReflection = new NodeToReflection(); return $nodeToReflection->__invoke($reflector, $fetchedNode->getNode(), $fetchedNode->getLocatedSource(), $fetchedNode->getNamespace(), $positionInNode); } private function findFileByClass(string $className) : ?string { if ($this->classToFile === null) { $this->init(); if ($this->classToFile === null) { throw new ShouldNotHappenException(); } } if (!array_key_exists($className, $this->classToFile)) { return null; } return $this->classToFile[$className]; } private function findFileByConstant(string $constantName) : ?string { if ($this->constantToFile === null) { $this->init(); if ($this->constantToFile === null) { throw new ShouldNotHappenException(); } } if (!array_key_exists($constantName, $this->constantToFile)) { return null; } return $this->constantToFile[$constantName]; } /** * @return string[] */ private function findFilesByFunction(string $functionName) : array { if ($this->functionToFiles === null) { $this->init(); if ($this->functionToFiles === null) { throw new ShouldNotHappenException(); } } if (!array_key_exists($functionName, $this->functionToFiles)) { return []; } return $this->functionToFiles[$functionName]; } private function init() : void { $classToFile = []; $constantToFile = []; $functionToFiles = []; foreach ($this->files as $file) { $symbols = $this->findSymbols($file); foreach ($symbols['classes'] as $classInFile) { $classToFile[$classInFile] = $file; } foreach ($symbols['constants'] as $constantInFile) { $constantToFile[$constantInFile] = $file; } foreach ($symbols['functions'] as $functionInFile) { if (!array_key_exists($functionInFile, $functionToFiles)) { $functionToFiles[$functionInFile] = []; } $functionToFiles[$functionInFile][] = $file; } } $this->classToFile = $classToFile; $this->functionToFiles = $functionToFiles; $this->constantToFile = $constantToFile; } /** * Inspired by Composer\Autoload\ClassMapGenerator::findClasses() * @link https://github.com/composer/composer/blob/45d3e133a4691eccb12e9cd6f9dfd76eddc1906d/src/Composer/Autoload/ClassMapGenerator.php#L216 * * @return array{classes: string[], functions: string[], constants: string[]} */ private function findSymbols(string $file) : array { $contents = @php_strip_whitespace($file); if ($contents === '') { return ['classes' => [], 'functions' => [], 'constants' => []]; } $matchResults = (bool) preg_match_all(sprintf('{\\b(?:(?:class|interface|trait|const|function%s)\\s)|(?:define\\s*\\()}i', $this->extraTypes), $contents, $matches); if (!$matchResults) { return ['classes' => [], 'functions' => [], 'constants' => []]; } $contents = $this->cleaner->clean($contents, count($matches[0])); preg_match_all(sprintf('{ (?: \\b(?<![\\$:>])(?: (?: (?P<type>class|interface|trait%s) \\s++ (?P<name>[a-zA-Z_\\x7f-\\xff][a-zA-Z0-9_\\x7f-\\xff\\-]*+) ) | (?: (?P<function>function) \\s++ (?:&\\s*)? (?P<fname>[a-zA-Z_\\x7f-\\xff][a-zA-Z0-9_\\x7f-\\xff\\-]*+) \\s*+ [&\\(] ) | (?: (?P<constant>const) \\s++ (?P<cname>[a-zA-Z_\\x7f-\\xff][a-zA-Z0-9_\\x7f-\\xff\\-]*+) \\s*+ [^;] ) | (?: (?:\\\\)? (?P<define>define) \\s*+ \\( \\s*+ [\'"] (?P<dname>[a-zA-Z_\\x7f-\\xff][a-zA-Z0-9_\\x7f-\\xff]*+(?:[\\\\]{1,2}[a-zA-Z_\\x7f-\\xff][a-zA-Z0-9_\\x7f-\\xff]*+)*+) ) | (?: (?P<ns>namespace) (?P<nsname>\\s++[a-zA-Z_\\x7f-\\xff][a-zA-Z0-9_\\x7f-\\xff]*+(?:\\s*+\\\\\\s*+[a-zA-Z_\\x7f-\\xff][a-zA-Z0-9_\\x7f-\\xff]*+)*+)? \\s*+ [\\{;] ) ) ) }ix', $this->extraTypes), $contents, $matches); $classes = []; $functions = []; $constants = []; $namespace = ''; for ($i = 0, $len = count($matches['type']); $i < $len; $i++) { if (isset($matches['ns'][$i]) && $matches['ns'][$i] !== '') { $namespace = preg_replace('~\\s+~', '', strtolower($matches['nsname'][$i])) . '\\'; continue; } if ($matches['function'][$i] !== '') { $functions[] = strtolower(ltrim($namespace . $matches['fname'][$i], '\\')); continue; } if ($matches['constant'][$i] !== '') { $constants[] = ConstantNameHelper::normalize(ltrim($namespace . $matches['cname'][$i], '\\')); } if ($matches['define'][$i] !== '') { $constants[] = ConstantNameHelper::normalize($matches['dname'][$i]); continue; } $name = $matches['name'][$i]; // skip anon classes extending/implementing if (in_array($name, ['extends', 'implements'], \true)) { continue; } $classes[] = strtolower(ltrim($namespace . $name, '\\')); } return ['classes' => $classes, 'functions' => $functions, 'constants' => $constants]; } /** * @return list<Reflection> */ public function locateIdentifiersByType(Reflector $reflector, IdentifierType $identifierType) : array { if ($this->classToFile === null || $this->functionToFiles === null || $this->constantToFile === null) { $this->init(); if ($this->classToFile === null || $this->functionToFiles === null || $this->constantToFile === null) { throw new ShouldNotHappenException(); } } $reflections = []; if ($identifierType->isClass()) { foreach ($this->classToFile as $file) { $fetchedNodesResult = $this->fileNodesFetcher->fetchNodes($file); foreach ($fetchedNodesResult->getClassNodes() as $identifierName => $fetchedClassNodes) { foreach ($fetchedClassNodes as $fetchedClassNode) { $reflections[$identifierName] = $this->nodeToReflection($reflector, $fetchedClassNode); } } } } elseif ($identifierType->isFunction()) { foreach ($this->functionToFiles as $files) { foreach ($files as $file) { $fetchedNodesResult = $this->fileNodesFetcher->fetchNodes($file); foreach ($fetchedNodesResult->getFunctionNodes() as $identifierName => $fetchedFunctionNodes) { foreach ($fetchedFunctionNodes as $fetchedFunctionNode) { $reflections[$identifierName] = $this->nodeToReflection($reflector, $fetchedFunctionNode); continue 2; } } } } } elseif ($identifierType->isConstant()) { foreach ($this->constantToFile as $file) { $fetchedNodesResult = $this->fileNodesFetcher->fetchNodes($file); foreach ($fetchedNodesResult->getConstantNodes() as $identifierName => $fetchedConstantNodes) { foreach ($fetchedConstantNodes as $fetchedConstantNode) { $reflections[$identifierName] = $this->nodeToReflection($reflector, $fetchedConstantNode, $this->findConstantPositionInConstNode($fetchedConstantNode->getNode(), $identifierName)); } } } } return array_values($reflections); } /** * @param Node\Stmt\Const_|Node\Expr\FuncCall $constantNode */ private function findConstantPositionInConstNode($constantNode, string $constantName) : ?int { if ($constantNode instanceof Node\Expr\FuncCall) { return null; } /** @var int $position */ foreach ($constantNode->consts as $position => $const) { if ($const->namespacedName === null) { throw new ShouldNotHappenException(); } if (ConstantNameHelper::normalize($const->namespacedName->toString()) === $constantName) { return $position; } } throw new ShouldNotHappenException(); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\BetterReflection\SourceLocator; use PhpParser\Node; use PHPStan\BetterReflection\SourceLocator\Located\LocatedSource; /** * @template-covariant T of Node */ final class FetchedNode { /** * @var T */ private $node; /** * @var ?Node\Stmt\Namespace_ */ private $namespace; /** * @var LocatedSource */ private $locatedSource; /** * @param T $node */ public function __construct(Node $node, ?Node\Stmt\Namespace_ $namespace, LocatedSource $locatedSource) { $this->node = $node; $this->namespace = $namespace; $this->locatedSource = $locatedSource; } /** * @return T */ public function getNode() : Node { return $this->node; } public function getNamespace() : ?Node\Stmt\Namespace_ { return $this->namespace; } public function getLocatedSource() : LocatedSource { return $this->locatedSource; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\BetterReflection\SourceLocator; use PhpParser\Node; use PHPStan\BetterReflection\Identifier\Identifier; use PHPStan\BetterReflection\Identifier\IdentifierType; use PHPStan\BetterReflection\Reflection\Reflection; use PHPStan\BetterReflection\Reflector\Reflector; use PHPStan\BetterReflection\SourceLocator\Ast\Strategy\NodeToReflection; use PHPStan\BetterReflection\SourceLocator\Type\SourceLocator; use PHPStan\Reflection\ConstantNameHelper; use PHPStan\ShouldNotHappenException; use function array_key_exists; use function array_values; use function current; use function strtolower; final class NewOptimizedDirectorySourceLocator implements SourceLocator { /** * @var FileNodesFetcher */ private $fileNodesFetcher; /** * @var array<string, string> */ private $classToFile; /** * @var array<string, array<int, string>> */ private $functionToFiles; /** * @var array<string, string> */ private $constantToFile; /** * @param array<string, string> $classToFile * @param array<string, array<int, string>> $functionToFiles * @param array<string, string> $constantToFile */ public function __construct(\PHPStan\Reflection\BetterReflection\SourceLocator\FileNodesFetcher $fileNodesFetcher, array $classToFile, array $functionToFiles, array $constantToFile) { $this->fileNodesFetcher = $fileNodesFetcher; $this->classToFile = $classToFile; $this->functionToFiles = $functionToFiles; $this->constantToFile = $constantToFile; } public function locateIdentifier(Reflector $reflector, Identifier $identifier) : ?Reflection { if ($identifier->isClass()) { $className = strtolower($identifier->getName()); $file = $this->findFileByClass($className); if ($file === null) { return null; } $fetchedClassNodes = $this->fileNodesFetcher->fetchNodes($file)->getClassNodes(); if (!array_key_exists($className, $fetchedClassNodes)) { return null; } /** @var FetchedNode<Node\Stmt\ClassLike> $fetchedClassNode */ $fetchedClassNode = current($fetchedClassNodes[$className]); return $this->nodeToReflection($reflector, $fetchedClassNode); } if ($identifier->isFunction()) { $functionName = strtolower($identifier->getName()); $files = $this->findFilesByFunction($functionName); $fetchedFunctionNode = null; foreach ($files as $file) { $fetchedFunctionNodes = $this->fileNodesFetcher->fetchNodes($file)->getFunctionNodes(); if (!array_key_exists($functionName, $fetchedFunctionNodes)) { continue; } /** @var FetchedNode<Node\Stmt\Function_> $fetchedFunctionNode */ $fetchedFunctionNode = current($fetchedFunctionNodes[$functionName]); } if ($fetchedFunctionNode === null) { return null; } return $this->nodeToReflection($reflector, $fetchedFunctionNode); } if ($identifier->isConstant()) { $constantName = ConstantNameHelper::normalize($identifier->getName()); $file = $this->findFileByConstant($constantName); if ($file === null) { return null; } $fetchedConstantNodes = $this->fileNodesFetcher->fetchNodes($file)->getConstantNodes(); if (!array_key_exists($constantName, $fetchedConstantNodes)) { return null; } /** @var FetchedNode<Node\Stmt\Const_|Node\Expr\FuncCall> $fetchedConstantNode */ $fetchedConstantNode = current($fetchedConstantNodes[$constantName]); return $this->nodeToReflection($reflector, $fetchedConstantNode, $this->findConstantPositionInConstNode($fetchedConstantNode->getNode(), $constantName)); } return null; } /** * @param FetchedNode<Node\Stmt\ClassLike>|FetchedNode<Node\Stmt\Function_>|FetchedNode<Node\Stmt\Const_|Node\Expr\FuncCall> $fetchedNode */ private function nodeToReflection(Reflector $reflector, \PHPStan\Reflection\BetterReflection\SourceLocator\FetchedNode $fetchedNode, ?int $positionInNode = null) : Reflection { $nodeToReflection = new NodeToReflection(); return $nodeToReflection->__invoke($reflector, $fetchedNode->getNode(), $fetchedNode->getLocatedSource(), $fetchedNode->getNamespace(), $positionInNode); } private function findFileByClass(string $className) : ?string { if (!array_key_exists($className, $this->classToFile)) { return null; } return $this->classToFile[$className]; } private function findFileByConstant(string $constantName) : ?string { if (!array_key_exists($constantName, $this->constantToFile)) { return null; } return $this->constantToFile[$constantName]; } /** * @return string[] */ private function findFilesByFunction(string $functionName) : array { if (!array_key_exists($functionName, $this->functionToFiles)) { return []; } return $this->functionToFiles[$functionName]; } /** * @return list<Reflection> */ public function locateIdentifiersByType(Reflector $reflector, IdentifierType $identifierType) : array { $reflections = []; if ($identifierType->isClass()) { foreach ($this->classToFile as $file) { $fetchedNodesResult = $this->fileNodesFetcher->fetchNodes($file); foreach ($fetchedNodesResult->getClassNodes() as $identifierName => $fetchedClassNodes) { foreach ($fetchedClassNodes as $fetchedClassNode) { $reflections[$identifierName] = $this->nodeToReflection($reflector, $fetchedClassNode); } } } } elseif ($identifierType->isFunction()) { foreach ($this->functionToFiles as $files) { foreach ($files as $file) { $fetchedNodesResult = $this->fileNodesFetcher->fetchNodes($file); foreach ($fetchedNodesResult->getFunctionNodes() as $identifierName => $fetchedFunctionNodes) { foreach ($fetchedFunctionNodes as $fetchedFunctionNode) { $reflections[$identifierName] = $this->nodeToReflection($reflector, $fetchedFunctionNode); continue 2; } } } } } elseif ($identifierType->isConstant()) { foreach ($this->constantToFile as $file) { $fetchedNodesResult = $this->fileNodesFetcher->fetchNodes($file); foreach ($fetchedNodesResult->getConstantNodes() as $identifierName => $fetchedConstantNodes) { foreach ($fetchedConstantNodes as $fetchedConstantNode) { $reflections[$identifierName] = $this->nodeToReflection($reflector, $fetchedConstantNode, $this->findConstantPositionInConstNode($fetchedConstantNode->getNode(), $identifierName)); } } } } return array_values($reflections); } /** * @param Node\Stmt\Const_|Node\Expr\FuncCall $constantNode */ private function findConstantPositionInConstNode($constantNode, string $constantName) : ?int { if ($constantNode instanceof Node\Expr\FuncCall) { return null; } /** @var int $position */ foreach ($constantNode->consts as $position => $const) { if ($const->namespacedName === null) { throw new ShouldNotHappenException(); } if (ConstantNameHelper::normalize($const->namespacedName->toString()) === $constantName) { return $position; } } throw new ShouldNotHappenException(); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\BetterReflection\SourceLocator; use PhpParser\NodeTraverser; use PHPStan\File\FileReader; use PHPStan\Parser\Parser; use PHPStan\Parser\ParserErrorsException; final class FileNodesFetcher { /** * @var CachingVisitor */ private $cachingVisitor; /** * @var Parser */ private $parser; public function __construct(\PHPStan\Reflection\BetterReflection\SourceLocator\CachingVisitor $cachingVisitor, Parser $parser) { $this->cachingVisitor = $cachingVisitor; $this->parser = $parser; } public function fetchNodes(string $fileName) : \PHPStan\Reflection\BetterReflection\SourceLocator\FetchedNodesResult { $nodeTraverser = new NodeTraverser(); $nodeTraverser->addVisitor($this->cachingVisitor); $contents = FileReader::read($fileName); try { $ast = $this->parser->parseFile($fileName); } catch (ParserErrorsException $e) { return new \PHPStan\Reflection\BetterReflection\SourceLocator\FetchedNodesResult([], [], []); } $this->cachingVisitor->reset($fileName, $contents); $nodeTraverser->traverse($ast); $result = new \PHPStan\Reflection\BetterReflection\SourceLocator\FetchedNodesResult($this->cachingVisitor->getClassNodes(), $this->cachingVisitor->getFunctionNodes(), $this->cachingVisitor->getConstantNodes()); $this->cachingVisitor->reset($fileName, $contents); return $result; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\BetterReflection\SourceLocator; use _PHPStan_7d8742a37\Nette\Utils\Json; use _PHPStan_7d8742a37\Nette\Utils\JsonException; use PHPStan\BetterReflection\SourceLocator\Type\AggregateSourceLocator; use PHPStan\BetterReflection\SourceLocator\Type\Composer\Psr\Psr0Mapping; use PHPStan\BetterReflection\SourceLocator\Type\Composer\Psr\Psr4Mapping; use PHPStan\BetterReflection\SourceLocator\Type\SourceLocator; use PHPStan\File\CouldNotReadFileException; use PHPStan\File\FileReader; use PHPStan\Internal\ComposerHelper; use PHPStan\Php\PhpVersion; use function array_key_exists; use function array_map; use function array_merge; use function array_merge_recursive; use function array_reverse; use function count; use function dirname; use function glob; use function is_dir; use function is_file; use function str_contains; use const GLOB_ONLYDIR; final class ComposerJsonAndInstalledJsonSourceLocatorMaker { /** * @var OptimizedDirectorySourceLocatorRepository */ private $optimizedDirectorySourceLocatorRepository; /** * @var OptimizedPsrAutoloaderLocatorFactory */ private $optimizedPsrAutoloaderLocatorFactory; /** * @var OptimizedDirectorySourceLocatorFactory */ private $optimizedDirectorySourceLocatorFactory; /** * @var PhpVersion */ private $phpVersion; public function __construct(\PHPStan\Reflection\BetterReflection\SourceLocator\OptimizedDirectorySourceLocatorRepository $optimizedDirectorySourceLocatorRepository, \PHPStan\Reflection\BetterReflection\SourceLocator\OptimizedPsrAutoloaderLocatorFactory $optimizedPsrAutoloaderLocatorFactory, \PHPStan\Reflection\BetterReflection\SourceLocator\OptimizedDirectorySourceLocatorFactory $optimizedDirectorySourceLocatorFactory, PhpVersion $phpVersion) { $this->optimizedDirectorySourceLocatorRepository = $optimizedDirectorySourceLocatorRepository; $this->optimizedPsrAutoloaderLocatorFactory = $optimizedPsrAutoloaderLocatorFactory; $this->optimizedDirectorySourceLocatorFactory = $optimizedDirectorySourceLocatorFactory; $this->phpVersion = $phpVersion; } public function create(string $projectInstallationPath) : ?SourceLocator { $composer = ComposerHelper::getComposerConfig($projectInstallationPath); if ($composer === null) { return null; } $vendorDirectory = ComposerHelper::getVendorDirFromComposerConfig($projectInstallationPath, $composer); $installedJsonPath = $vendorDirectory . '/composer/installed.json'; if (!is_file($installedJsonPath)) { return null; } $installedJsonDirectoryPath = dirname($installedJsonPath); try { $installedJsonContents = FileReader::read($installedJsonPath); $installedJson = Json::decode($installedJsonContents, Json::FORCE_ARRAY); } catch (CouldNotReadFileException|JsonException $e) { return null; } $installed = $installedJson['packages'] ?? $installedJson; $dev = (bool) ($installedJson['dev'] ?? \true); $classMapPaths = array_merge($this->prefixPaths($this->packageToClassMapPaths($composer), $projectInstallationPath . '/'), $dev ? $this->prefixPaths($this->packageToClassMapPaths($composer, 'autoload-dev'), $projectInstallationPath . '/') : [], ...array_map(function (array $package) use($installedJsonDirectoryPath, $vendorDirectory) : array { return $this->prefixPaths($this->packageToClassMapPaths($package), $this->packagePrefixPath($installedJsonDirectoryPath, $package, $vendorDirectory)); }, $installed)); $filePaths = array_merge($this->prefixPaths($this->packageToFilePaths($composer), $projectInstallationPath . '/'), $dev ? $this->prefixPaths($this->packageToFilePaths($composer, 'autoload-dev'), $projectInstallationPath . '/') : [], ...array_map(function (array $package) use($installedJsonDirectoryPath, $vendorDirectory) : array { return $this->prefixPaths($this->packageToFilePaths($package), $this->packagePrefixPath($installedJsonDirectoryPath, $package, $vendorDirectory)); }, $installed)); $locators = []; $locators[] = $this->optimizedPsrAutoloaderLocatorFactory->create(Psr4Mapping::fromArrayMappings(array_merge_recursive($this->prefixWithInstallationPath($this->packageToPsr4AutoloadNamespaces($composer), $projectInstallationPath), $dev ? $this->prefixWithInstallationPath($this->packageToPsr4AutoloadNamespaces($composer, 'autoload-dev'), $projectInstallationPath) : [], ...array_map(function (array $package) use($installedJsonDirectoryPath, $vendorDirectory) : array { return $this->prefixWithPackagePath($this->packageToPsr4AutoloadNamespaces($package), $installedJsonDirectoryPath, $package, $vendorDirectory); }, $installed)))); $locators[] = $this->optimizedPsrAutoloaderLocatorFactory->create(Psr0Mapping::fromArrayMappings(array_merge_recursive($this->prefixWithInstallationPath($this->packageToPsr0AutoloadNamespaces($composer), $projectInstallationPath), $dev ? $this->prefixWithInstallationPath($this->packageToPsr0AutoloadNamespaces($composer, 'autoload-dev'), $projectInstallationPath) : [], ...array_map(function (array $package) use($installedJsonDirectoryPath, $vendorDirectory) : array { return $this->prefixWithPackagePath($this->packageToPsr0AutoloadNamespaces($package), $installedJsonDirectoryPath, $package, $vendorDirectory); }, $installed)))); $files = []; foreach ($classMapPaths as $classMapPath) { if (is_dir($classMapPath)) { $locators[] = $this->optimizedDirectorySourceLocatorRepository->getOrCreate($classMapPath); continue; } if (!is_file($classMapPath)) { continue; } $files[] = $classMapPath; } foreach ($filePaths as $file) { if (!is_file($file)) { continue; } $files[] = $file; } if (count($files) > 0) { $locators[] = $this->optimizedDirectorySourceLocatorFactory->createByFiles($files); } $binDir = ComposerHelper::getBinDirFromComposerConfig($projectInstallationPath, $composer); $phpunitBridgeDir = $binDir . '/.phpunit'; if (!is_dir($vendorDirectory . '/phpunit/phpunit') && is_dir($phpunitBridgeDir)) { // from https://github.com/composer/composer/blob/8ff237afb61b8766efa576b8ae1cc8560c8aed96/phpstan/locate-phpunit-autoloader.php $bestDirFound = null; $phpunitBridgeDirectories = glob($phpunitBridgeDir . '/phpunit-*', GLOB_ONLYDIR); if ($phpunitBridgeDirectories !== \false) { foreach (array_reverse($phpunitBridgeDirectories) as $dir) { $bestDirFound = $dir; if ($this->phpVersion->getVersionId() >= 80100 && str_contains($dir, 'phpunit-10')) { break; } if ($this->phpVersion->getVersionId() >= 80000) { if (str_contains($dir, 'phpunit-9')) { break; } continue; } if (str_contains($dir, 'phpunit-8') || str_contains($dir, 'phpunit-7')) { break; } } if ($bestDirFound !== null) { $phpunitBridgeLocator = $this->create($bestDirFound); if ($phpunitBridgeLocator !== null) { $locators[] = $phpunitBridgeLocator; } } } } return new AggregateSourceLocator($locators); } /** * @param mixed[] $package * * @return array<string, array<int, string>> */ private function packageToPsr4AutoloadNamespaces(array $package, string $autoloadSection = 'autoload') : array { return array_map(static function ($namespacePaths) : array { return (array) $namespacePaths; }, $package[$autoloadSection]['psr-4'] ?? []); } /** * @param mixed[] $package * * @return array<string, array<int, string>> */ private function packageToPsr0AutoloadNamespaces(array $package, string $autoloadSection = 'autoload') : array { return array_map(static function ($namespacePaths) : array { return (array) $namespacePaths; }, $package[$autoloadSection]['psr-0'] ?? []); } /** * @param mixed[] $package * * @return array<int, string> */ private function packageToClassMapPaths(array $package, string $autoloadSection = 'autoload') : array { return $package[$autoloadSection]['classmap'] ?? []; } /** * @param mixed[] $package * * @return array<int, string> */ private function packageToFilePaths(array $package, string $autoloadSection = 'autoload') : array { return $package[$autoloadSection]['files'] ?? []; } /** * @param mixed[] $package */ private function packagePrefixPath(string $installedJsonDirectoryPath, array $package, string $vendorDirectory) : string { if (array_key_exists('install-path', $package)) { return $installedJsonDirectoryPath . '/' . $package['install-path'] . '/'; } return $vendorDirectory . '/' . $package['name'] . '/'; } /** * @param array<string, array<int, string>> $paths * @param array<string, array<int, string>> $package * * @return array<string, array<int, string>> */ private function prefixWithPackagePath(array $paths, string $installedJsonDirectoryPath, array $package, string $vendorDirectory) : array { $prefix = $this->packagePrefixPath($installedJsonDirectoryPath, $package, $vendorDirectory); return array_map(function (array $paths) use($prefix) : array { return $this->prefixPaths($paths, $prefix); }, $paths); } /** * @param array<int|string, array<string>> $paths * * @return array<int|string, array<string>> */ private function prefixWithInstallationPath(array $paths, string $trimmedInstallationPath) : array { return array_map(function (array $paths) use($trimmedInstallationPath) : array { return $this->prefixPaths($paths, $trimmedInstallationPath . '/'); }, $paths); } /** * @param array<int, string> $paths * * @return array<int, string> */ private function prefixPaths(array $paths, string $prefix) : array { return array_map(static function (string $path) use($prefix) : string { return $prefix . $path; }, $paths); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\BetterReflection\SourceLocator; use function array_key_exists; final class OptimizedSingleFileSourceLocatorRepository { /** * @var OptimizedSingleFileSourceLocatorFactory */ private $factory; /** @var array<string, OptimizedSingleFileSourceLocator> */ private $locators = []; public function __construct(\PHPStan\Reflection\BetterReflection\SourceLocator\OptimizedSingleFileSourceLocatorFactory $factory) { $this->factory = $factory; } public function getOrCreate(string $fileName) : \PHPStan\Reflection\BetterReflection\SourceLocator\OptimizedSingleFileSourceLocator { if (array_key_exists($fileName, $this->locators)) { return $this->locators[$fileName]; } $this->locators[$fileName] = $this->factory->create($fileName); return $this->locators[$fileName]; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\BetterReflection\SourceLocator; use PhpParser\Node\Arg; use PhpParser\Node\Expr\FuncCall; use PhpParser\Node\Name; use PhpParser\Node\Scalar\String_; use PhpParser\Node\Stmt\Const_; use PHPStan\BetterReflection\Identifier\Identifier; use PHPStan\BetterReflection\Identifier\IdentifierType; use PHPStan\BetterReflection\Reflection\Reflection; use PHPStan\BetterReflection\Reflection\ReflectionConstant; use PHPStan\BetterReflection\Reflector\Reflector; use PHPStan\BetterReflection\SourceLocator\Ast\Strategy\NodeToReflection; use PHPStan\BetterReflection\SourceLocator\Located\LocatedSource; use PHPStan\BetterReflection\SourceLocator\Type\SourceLocator; use PHPStan\Node\Expr\TypeExpr; use PHPStan\Reflection\ConstantNameHelper; use PHPStan\ShouldNotHappenException; use PHPStan\Type\ConstantTypeHelper; use ReflectionClass; use ReflectionFunction; use function array_key_exists; use function array_keys; use function class_exists; use function constant; use function count; use function defined; use function function_exists; use function interface_exists; use function is_file; use function is_string; use function opcache_invalidate; use function restore_error_handler; use function set_error_handler; use function spl_autoload_functions; use function strtolower; use function trait_exists; use const PHP_VERSION_ID; /** * Use PHP's built in autoloader to locate a class, without actually loading. * * There are some prerequisites... * - we expect the autoloader to load classes from a file (i.e. using require/include) * * Modified code from Roave/BetterReflection, Copyright (c) 2017 Roave, LLC. */ final class AutoloadSourceLocator implements SourceLocator { /** * @var FileNodesFetcher */ private $fileNodesFetcher; /** * @var bool */ private $executeAutoloadersInFileReadTrap; /** @var array{classes: array<string, string>, functions: array<string, string>, constants: array<string, string>} */ private $presentSymbols = ['classes' => [], 'functions' => [], 'constants' => []]; /** @var array<string, true> */ private $scannedFiles = []; /** @var array<string, int> */ private $startLineByClass = []; public function __construct(\PHPStan\Reflection\BetterReflection\SourceLocator\FileNodesFetcher $fileNodesFetcher, bool $executeAutoloadersInFileReadTrap) { $this->fileNodesFetcher = $fileNodesFetcher; $this->executeAutoloadersInFileReadTrap = $executeAutoloadersInFileReadTrap; } public function locateIdentifier(Reflector $reflector, Identifier $identifier) : ?Reflection { if ($identifier->isFunction()) { $functionName = $identifier->getName(); $loweredFunctionName = strtolower($functionName); if (array_key_exists($loweredFunctionName, $this->presentSymbols['functions'])) { return $this->findReflection($reflector, $this->presentSymbols['functions'][$loweredFunctionName], $identifier, null); } if (!function_exists($functionName)) { return null; } $reflection = new ReflectionFunction($functionName); $reflectionFileName = $reflection->getFileName(); if (!is_string($reflectionFileName)) { return null; } if (!is_file($reflectionFileName)) { return null; } return $this->findReflection($reflector, $reflectionFileName, $identifier, null); } if ($identifier->isConstant()) { $constantName = ConstantNameHelper::normalize($identifier->getName()); if (array_key_exists($constantName, $this->presentSymbols['constants'])) { return $this->findReflection($reflector, $this->presentSymbols['constants'][$constantName], $identifier, null); } if (!defined($constantName)) { return null; } $constantValue = @constant($constantName); return ReflectionConstant::createFromNode($reflector, new FuncCall(new Name('define'), [new Arg(new String_($constantName)), new Arg(new TypeExpr(ConstantTypeHelper::getTypeFromValue($constantValue)))], ['startLine' => 1, 'endLine' => 1, 'startFilePos' => 1, 'endFilePos' => 4]), new LocatedSource('<?php', $constantName, null), null, null); } if (!$identifier->isClass()) { return null; } $loweredClassName = strtolower($identifier->getName()); if (array_key_exists($loweredClassName, $this->presentSymbols['classes'])) { $startLine = null; if (array_key_exists($loweredClassName, $this->startLineByClass)) { $startLine = $this->startLineByClass[$loweredClassName]; } else { $reflection = $this->getReflectionClass($identifier->getName()); if ($reflection !== null && $reflection->getStartLine() !== \false && is_string($reflection->getFileName()) && is_file($reflection->getFileName()) && $reflection->getFileName() === $this->presentSymbols['classes'][$loweredClassName]) { $startLine = $reflection->getStartLine(); } } return $this->findReflection($reflector, $this->presentSymbols['classes'][$loweredClassName], $identifier, $startLine); } $locateResult = $this->locateClassByName($identifier->getName()); if ($locateResult === null) { return null; } [$potentiallyLocatedFiles, $className, $startLine] = $locateResult; if ($startLine !== null) { $this->startLineByClass[strtolower($className)] = $startLine; } $newIdentifier = new Identifier($className, $identifier->getType()); foreach ($potentiallyLocatedFiles as $potentiallyLocatedFile) { $reflection = $this->findReflection($reflector, $potentiallyLocatedFile, $newIdentifier, $startLine); if ($reflection === null) { continue; } return $reflection; } return null; } private function findReflection(Reflector $reflector, string $file, Identifier $identifier, ?int $startLine) : ?Reflection { $result = $this->fileNodesFetcher->fetchNodes($file); if (!array_key_exists($file, $this->scannedFiles)) { foreach (array_keys($result->getClassNodes()) as $className) { if (array_key_exists($className, $this->presentSymbols['classes'])) { continue; } $this->presentSymbols['classes'][$className] = $file; } foreach (array_keys($result->getFunctionNodes()) as $functionName) { if (array_key_exists($functionName, $this->presentSymbols['functions'])) { continue; } $this->presentSymbols['functions'][$functionName] = $file; } foreach (array_keys($result->getConstantNodes()) as $constantName) { if (array_key_exists($constantName, $this->presentSymbols['constants'])) { continue; } $this->presentSymbols['constants'][$constantName] = $file; } $this->scannedFiles[$file] = \true; } $nodeToReflection = new NodeToReflection(); if ($identifier->isClass()) { $identifierName = strtolower($identifier->getName()); if (!array_key_exists($identifierName, $result->getClassNodes())) { return null; } $classNodesCount = count($result->getClassNodes()[$identifierName]); foreach ($result->getClassNodes()[$identifierName] as $classNode) { if ($classNodesCount > 1 && $startLine !== null) { if (count($classNode->getNode()->attrGroups) > 0 && PHP_VERSION_ID < 80000) { $startLine--; } if ($startLine !== $classNode->getNode()->getStartLine()) { continue; } } return $nodeToReflection->__invoke($reflector, $classNode->getNode(), $classNode->getLocatedSource(), $classNode->getNamespace()); } return null; } if ($identifier->isFunction()) { $identifierName = strtolower($identifier->getName()); if (!array_key_exists($identifierName, $result->getFunctionNodes())) { return null; } foreach ($result->getFunctionNodes()[$identifierName] as $functionNode) { return $nodeToReflection->__invoke($reflector, $functionNode->getNode(), $functionNode->getLocatedSource(), $functionNode->getNamespace()); } } if ($identifier->isConstant()) { $identifierName = ConstantNameHelper::normalize($identifier->getName()); $constantNodes = $result->getConstantNodes(); if (!array_key_exists($identifierName, $constantNodes)) { return null; } foreach ($constantNodes[$identifierName] as $fetchedConstantNode) { $constantNode = $fetchedConstantNode->getNode(); $positionInNode = null; if ($constantNode instanceof Const_) { foreach ($constantNode->consts as $constPosition => $const) { if ($const->namespacedName === null) { throw new ShouldNotHappenException(); } if (ConstantNameHelper::normalize($const->namespacedName->toString()) === $identifierName) { /** @var int $positionInNode */ $positionInNode = $constPosition; break; } } if ($positionInNode === null) { throw new ShouldNotHappenException(); } } return $nodeToReflection->__invoke($reflector, $constantNode, $fetchedConstantNode->getLocatedSource(), $fetchedConstantNode->getNamespace(), $positionInNode); } } return null; } public function locateIdentifiersByType(Reflector $reflector, IdentifierType $identifierType) : array { return []; } /** * @return ReflectionClass<object>|null */ private function getReflectionClass(string $className) : ?ReflectionClass { if (class_exists($className, \false) || interface_exists($className, \false) || trait_exists($className, \false)) { return new ReflectionClass($className); } return null; } /** * Attempt to locate a class by name. * * If class already exists, simply use internal reflection API to get the * filename and store it. * * If class does not exist, we make an assumption that whatever autoloaders * that are registered will be loading a file. We then override the file:// * protocol stream wrapper to "capture" the filename we expect the class to * be in, and then restore it. Note that class_exists will cause an error * that it cannot find the file, so we squelch the errors by overriding the * error handler temporarily. * * @return array{string[], string, int|null}|null */ private function locateClassByName(string $className) : ?array { $reflection = $this->getReflectionClass($className); if ($reflection !== null) { $filename = $reflection->getFileName(); if (!is_string($filename)) { return null; } if (!is_file($filename)) { return null; } return [[$filename], $reflection->getName(), $reflection->getStartLine() !== \false ? $reflection->getStartLine() : null]; } if (!$this->executeAutoloadersInFileReadTrap) { return null; } $this->silenceErrors(); try { $result = \PHPStan\Reflection\BetterReflection\SourceLocator\FileReadTrapStreamWrapper::withStreamWrapperOverride(static function () use($className) : ?array { $functions = spl_autoload_functions(); if ($functions === \false) { return null; } foreach ($functions as $preExistingAutoloader) { $preExistingAutoloader($className); /** * This static variable is populated by the side-effect of the stream wrapper * trying to read the file path when `include()` is used by an autoloader. * * This will not be `null` when the autoloader tried to read a file. */ if (\PHPStan\Reflection\BetterReflection\SourceLocator\FileReadTrapStreamWrapper::$autoloadLocatedFiles !== []) { return [\PHPStan\Reflection\BetterReflection\SourceLocator\FileReadTrapStreamWrapper::$autoloadLocatedFiles, $className, null]; } } return null; }); if ($result === null) { return null; } if (!function_exists('opcache_invalidate')) { return $result; } foreach ($result[0] as $file) { opcache_invalidate($file, \true); } return $result; } finally { restore_error_handler(); } } private function silenceErrors() : void { set_error_handler(static function () : bool { return \true; }); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\BetterReflection\SourceLocator; interface OptimizedSingleFileSourceLocatorFactory { public function create(string $fileName) : \PHPStan\Reflection\BetterReflection\SourceLocator\OptimizedSingleFileSourceLocator; } <?php declare (strict_types=1); namespace PHPStan\Reflection\BetterReflection\SourceLocator; use PHPStan\BetterReflection\Identifier\Identifier; use PHPStan\BetterReflection\Identifier\IdentifierType; use PHPStan\BetterReflection\Reflection\Reflection; use PHPStan\BetterReflection\Reflector\Reflector; use PHPStan\BetterReflection\SourceLocator\Type\Composer\Psr\PsrAutoloaderMapping; use PHPStan\BetterReflection\SourceLocator\Type\SourceLocator; use function is_file; final class OptimizedPsrAutoloaderLocator implements SourceLocator { /** * @var PsrAutoloaderMapping */ private $mapping; /** * @var OptimizedSingleFileSourceLocatorRepository */ private $optimizedSingleFileSourceLocatorRepository; /** @var array<string, OptimizedSingleFileSourceLocator> */ private $locators = []; public function __construct(PsrAutoloaderMapping $mapping, \PHPStan\Reflection\BetterReflection\SourceLocator\OptimizedSingleFileSourceLocatorRepository $optimizedSingleFileSourceLocatorRepository) { $this->mapping = $mapping; $this->optimizedSingleFileSourceLocatorRepository = $optimizedSingleFileSourceLocatorRepository; } public function locateIdentifier(Reflector $reflector, Identifier $identifier) : ?Reflection { foreach ($this->locators as $locator) { $reflection = $locator->locateIdentifier($reflector, $identifier); if ($reflection === null) { continue; } return $reflection; } foreach ($this->mapping->resolvePossibleFilePaths($identifier) as $file) { if (!is_file($file)) { continue; } $locator = $this->optimizedSingleFileSourceLocatorRepository->getOrCreate($file); $reflection = $locator->locateIdentifier($reflector, $identifier); if ($reflection === null) { continue; } $this->locators[$file] = $locator; return $reflection; } return null; } /** * @return list<Reflection> */ public function locateIdentifiersByType(Reflector $reflector, IdentifierType $identifierType) : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\BetterReflection\SourceLocator; use PHPStan\BetterReflection\Identifier\Identifier; use PHPStan\BetterReflection\Identifier\IdentifierType; use PHPStan\BetterReflection\Reflection\Reflection; use PHPStan\BetterReflection\Reflector\Reflector; use PHPStan\BetterReflection\SourceLocator\Type\SourceLocator; use function class_exists; use function interface_exists; use function PHPStan\autoloadFunctions; use function trait_exists; final class AutoloadFunctionsSourceLocator implements SourceLocator { /** * @var AutoloadSourceLocator */ private $autoloadSourceLocator; /** * @var ReflectionClassSourceLocator */ private $reflectionClassSourceLocator; public function __construct(\PHPStan\Reflection\BetterReflection\SourceLocator\AutoloadSourceLocator $autoloadSourceLocator, \PHPStan\Reflection\BetterReflection\SourceLocator\ReflectionClassSourceLocator $reflectionClassSourceLocator) { $this->autoloadSourceLocator = $autoloadSourceLocator; $this->reflectionClassSourceLocator = $reflectionClassSourceLocator; } public function locateIdentifier(Reflector $reflector, Identifier $identifier) : ?Reflection { if (!$identifier->isClass()) { return null; } $className = $identifier->getName(); if (class_exists($className, \false) || interface_exists($className, \false) || trait_exists($className, \false)) { return null; } $autoloadFunctions = autoloadFunctions(); foreach ($autoloadFunctions as $autoloadFunction) { $autoloadFunction($className); $reflection = $this->autoloadSourceLocator->locateIdentifier($reflector, $identifier); if ($reflection !== null) { return $reflection; } $reflection = $this->reflectionClassSourceLocator->locateIdentifier($reflector, $identifier); if ($reflection !== null) { return $reflection; } } return null; } public function locateIdentifiersByType(Reflector $reflector, IdentifierType $identifierType) : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\BetterReflection\SourceLocator; use function array_key_exists; final class OptimizedDirectorySourceLocatorRepository { /** * @var OptimizedDirectorySourceLocatorFactory */ private $factory; /** @var array<string, NewOptimizedDirectorySourceLocator> */ private $locators = []; public function __construct(\PHPStan\Reflection\BetterReflection\SourceLocator\OptimizedDirectorySourceLocatorFactory $factory) { $this->factory = $factory; } public function getOrCreate(string $directory) : \PHPStan\Reflection\BetterReflection\SourceLocator\NewOptimizedDirectorySourceLocator { if (array_key_exists($directory, $this->locators)) { return $this->locators[$directory]; } $this->locators[$directory] = $this->factory->createByDirectory($directory); return $this->locators[$directory]; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\BetterReflection\SourceLocator; use PHPStan\BetterReflection\SourceLocator\Type\Composer\Psr\PsrAutoloaderMapping; interface OptimizedPsrAutoloaderLocatorFactory { public function create(PsrAutoloaderMapping $mapping) : \PHPStan\Reflection\BetterReflection\SourceLocator\OptimizedPsrAutoloaderLocator; } <?php declare (strict_types=1); namespace PHPStan\Reflection\BetterReflection\SourceLocator; use PHPStan\ShouldNotHappenException; use function is_dir; use function is_file; use function stat; use function stream_resolve_include_path; use function stream_wrapper_register; use function stream_wrapper_restore; use function stream_wrapper_unregister; use const SEEK_CUR; use const SEEK_END; use const SEEK_SET; use const STREAM_URL_STAT_QUIET; /** * This class will operate as a stream wrapper, intercepting any access to a file while * in operation. * * @internal DO NOT USE: this is an implementation detail of * the {@see \PHPStan\BetterReflection\SourceLocator\Type\AutoloadSourceLocator} * * phpcs:disable SlevomatCodingStandard.TypeHints.ParameterTypeHint.MissingNativeTypeHint * phpcs:disable PSR1.Methods.CamelCapsMethodName.NotCamelCaps * phpcs:disable Squiz.NamingConventions.ValidVariableName.NotCamelCaps */ final class FileReadTrapStreamWrapper { private const DEFAULT_STREAM_WRAPPER_PROTOCOLS = ['file', 'phar']; /** @var string[]|null */ private static $registeredStreamWrapperProtocols; /** @var string[] */ public static $autoloadLocatedFiles = []; /** * @var bool */ private $readFromFile = \false; /** * @var int */ private $seekPosition = 0; /** * @param string[] $streamWrapperProtocols * * @return mixed * * @psalm-template ExecutedMethodReturnType of mixed * @psalm-param callable() : ExecutedMethodReturnType $executeMeWithinStreamWrapperOverride * @psalm-return ExecutedMethodReturnType */ public static function withStreamWrapperOverride(callable $executeMeWithinStreamWrapperOverride, array $streamWrapperProtocols = self::DEFAULT_STREAM_WRAPPER_PROTOCOLS) { self::$registeredStreamWrapperProtocols = $streamWrapperProtocols; self::$autoloadLocatedFiles = []; try { foreach ($streamWrapperProtocols as $protocol) { stream_wrapper_unregister($protocol); stream_wrapper_register($protocol, self::class); } $result = $executeMeWithinStreamWrapperOverride(); } finally { foreach ($streamWrapperProtocols as $protocol) { stream_wrapper_restore($protocol); } } self::$registeredStreamWrapperProtocols = null; self::$autoloadLocatedFiles = []; return $result; } /** * Our wrapper simply records which file we tried to load and returns * boolean false indicating failure. * * @internal do not call this method directly! This is stream wrapper * voodoo logic that you **DO NOT** want to touch! * * @see https://php.net/manual/en/class.streamwrapper.php * @see https://php.net/manual/en/streamwrapper.stream-open.php * * @param string $path * @param string $mode * @param int $options * @param string $openedPath */ public function stream_open($path, $mode, $options, &$openedPath) : bool { $exists = is_file($path) || stream_resolve_include_path($path) !== \false; if ($exists) { self::$autoloadLocatedFiles[] = $path; } $this->readFromFile = \false; $this->seekPosition = 0; return $exists; } /** * Since we allow our wrapper's stream_open() to succeed, we need to * simulate a successful read so autoloaders with require() don't explode. * * @param int $count * */ public function stream_read($count) : string { $this->readFromFile = \true; // Dummy return value that is also valid PHP for require(). We'll read // and process the file elsewhere, so it's OK to provide dummy data for // this read. return ''; } /** * Since we allowed the open to succeed, we should allow the close to occur * as well. * */ public function stream_close() : void { // no op } /** * Required for `require_once` and `include_once` to work per PHP.net * comment referenced below. We delegate to url_stat(). * * @see https://www.php.net/manual/en/function.stream-wrapper-register.php#51855 * * @return mixed[]|bool */ public function stream_stat() { if (self::$autoloadLocatedFiles === []) { return \false; } return $this->url_stat(self::$autoloadLocatedFiles[0], STREAM_URL_STAT_QUIET); } /** * url_stat is triggered by calls like "file_exists". The call to "file_exists" must not be overloaded. * This function restores the original "file" stream, issues a call to "stat" to get the real results, * and then re-registers the AutoloadSourceLocator stream wrapper. * * @internal do not call this method directly! This is stream wrapper * voodoo logic that you **DO NOT** want to touch! * * @see https://php.net/manual/en/class.streamwrapper.php * @see https://php.net/manual/en/streamwrapper.url-stat.php * * @param string $path * @param int $flags * * @return mixed[]|bool */ public function url_stat($path, $flags) { return $this->invokeWithRealFileStreamWrapper(static function ($path, $flags) { if (($flags & STREAM_URL_STAT_QUIET) !== 0) { return @stat($path); } return stat($path); }, [$path, $flags]); } /** * @param mixed[] $args * @return mixed */ private function invokeWithRealFileStreamWrapper(callable $cb, array $args) { if (self::$registeredStreamWrapperProtocols === null) { throw new ShouldNotHappenException(self::class . ' not registered: cannot operate. Do not call this method directly.'); } foreach (self::$registeredStreamWrapperProtocols as $protocol) { stream_wrapper_restore($protocol); } $result = $cb(...$args); foreach (self::$registeredStreamWrapperProtocols as $protocol) { stream_wrapper_unregister($protocol); stream_wrapper_register($protocol, self::class); } return $result; } /** * Simulates behavior of reading from an empty file. * */ public function stream_eof() : bool { return $this->readFromFile; } public function stream_flush() : bool { return \true; } public function stream_tell() : int { return $this->seekPosition; } /** * @param int $offset * @param int $whence */ public function stream_seek($offset, $whence) : bool { switch ($whence) { // Behavior is the same for a zero-length file case SEEK_SET: case SEEK_END: if ($offset < 0) { return \false; } $this->seekPosition = $offset; return \true; case SEEK_CUR: if ($offset < 0) { return \false; } $this->seekPosition += $offset; return \true; default: return \false; } } /** * @param int $option * @param int $arg1 * @param int $arg2 */ public function stream_set_option($option, $arg1, $arg2) : bool { return \false; } public function dir_opendir(string $path, int $options) : bool { return is_dir($path); } public function dir_readdir() : string { return ''; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\BetterReflection\SourceLocator; use PHPStan\BetterReflection\Identifier\Identifier; use PHPStan\BetterReflection\Identifier\IdentifierType; use PHPStan\BetterReflection\Reflection\Reflection; use PHPStan\BetterReflection\Reflector\Reflector; use PHPStan\BetterReflection\SourceLocator\Ast\Locator; use PHPStan\BetterReflection\SourceLocator\Located\LocatedSource; use PHPStan\BetterReflection\SourceLocator\SourceStubber\ReflectionSourceStubber; use PHPStan\BetterReflection\SourceLocator\Type\SourceLocator; use ReflectionClass; final class ReflectionClassSourceLocator implements SourceLocator { /** * @var Locator */ private $astLocator; /** * @var ReflectionSourceStubber */ private $reflectionSourceStubber; public function __construct(Locator $astLocator, ReflectionSourceStubber $reflectionSourceStubber) { $this->astLocator = $astLocator; $this->reflectionSourceStubber = $reflectionSourceStubber; } public function locateIdentifier(Reflector $reflector, Identifier $identifier) : ?Reflection { if (!$identifier->isClass()) { return null; } /** @var class-string $className */ $className = $identifier->getName(); $stub = $this->reflectionSourceStubber->generateClassStub($className); if ($stub === null) { return null; } $reflection = new ReflectionClass($className); return $this->astLocator->findReflection($reflector, new LocatedSource($stub->getStub(), $reflection->getName(), null), new Identifier($reflection->getName(), new IdentifierType(IdentifierType::IDENTIFIER_CLASS))); } public function locateIdentifiersByType(Reflector $reflector, IdentifierType $identifierType) : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\BetterReflection\SourceLocator; use PHPStan\BetterReflection\Identifier\Identifier; use PHPStan\BetterReflection\Identifier\IdentifierType; use PHPStan\BetterReflection\Reflection\Reflection; use PHPStan\BetterReflection\Reflector\Reflector; use PHPStan\BetterReflection\SourceLocator\Type\SourceLocator; use ReflectionClass as CoreReflectionClass; use function class_exists; use function interface_exists; use function trait_exists; final class RewriteClassAliasSourceLocator implements SourceLocator { /** * @var SourceLocator */ private $originalSourceLocator; public function __construct(SourceLocator $originalSourceLocator) { $this->originalSourceLocator = $originalSourceLocator; } public function locateIdentifier(Reflector $reflector, Identifier $identifier) : ?Reflection { if (!$identifier->isClass()) { return $this->originalSourceLocator->locateIdentifier($reflector, $identifier); } if (class_exists($identifier->getName(), \false) || interface_exists($identifier->getName(), \false) || trait_exists($identifier->getName(), \false)) { $classReflection = new CoreReflectionClass($identifier->getName()); return $this->originalSourceLocator->locateIdentifier($reflector, new Identifier($classReflection->getName(), $identifier->getType())); } return $this->originalSourceLocator->locateIdentifier($reflector, $identifier); } public function locateIdentifiersByType(Reflector $reflector, IdentifierType $identifierType) : array { return $this->originalSourceLocator->locateIdentifiersByType($reflector, $identifierType); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\BetterReflection\SourceLocator; use PhpParser\Node\Stmt\Const_; use PHPStan\BetterReflection\Identifier\Identifier; use PHPStan\BetterReflection\Identifier\IdentifierType; use PHPStan\BetterReflection\Reflection\Reflection; use PHPStan\BetterReflection\Reflection\ReflectionClass; use PHPStan\BetterReflection\Reflection\ReflectionConstant; use PHPStan\BetterReflection\Reflection\ReflectionFunction; use PHPStan\BetterReflection\Reflector\Reflector; use PHPStan\BetterReflection\SourceLocator\Ast\Strategy\NodeToReflection; use PHPStan\BetterReflection\SourceLocator\Type\SourceLocator; use PHPStan\Reflection\ConstantNameHelper; use PHPStan\ShouldNotHappenException; use function array_key_exists; use function array_keys; use function strtolower; final class OptimizedSingleFileSourceLocator implements SourceLocator { /** * @var FileNodesFetcher */ private $fileNodesFetcher; /** * @var string */ private $fileName; /** @var array{classes: array<string, true>, functions: array<string, true>, constants: array<string, true>}|null */ private $presentSymbols = null; public function __construct(\PHPStan\Reflection\BetterReflection\SourceLocator\FileNodesFetcher $fileNodesFetcher, string $fileName) { $this->fileNodesFetcher = $fileNodesFetcher; $this->fileName = $fileName; } public function locateIdentifier(Reflector $reflector, Identifier $identifier) : ?Reflection { if ($this->presentSymbols !== null) { if ($identifier->isClass()) { $className = strtolower($identifier->getName()); if (!array_key_exists($className, $this->presentSymbols['classes'])) { return null; } } if ($identifier->isFunction()) { $className = strtolower($identifier->getName()); if (!array_key_exists($className, $this->presentSymbols['functions'])) { return null; } } if ($identifier->isConstant()) { $constantName = ConstantNameHelper::normalize($identifier->getName()); if (!array_key_exists($constantName, $this->presentSymbols['constants'])) { return null; } } } $fetchedNodesResult = $this->fileNodesFetcher->fetchNodes($this->fileName); if ($this->presentSymbols === null) { $presentSymbols = ['classes' => [], 'functions' => [], 'constants' => []]; foreach (array_keys($fetchedNodesResult->getClassNodes()) as $className) { $presentSymbols['classes'][$className] = \true; } foreach (array_keys($fetchedNodesResult->getFunctionNodes()) as $functionName) { $presentSymbols['functions'][$functionName] = \true; } foreach (array_keys($fetchedNodesResult->getConstantNodes()) as $constantName) { $presentSymbols['constants'][$constantName] = \true; } $this->presentSymbols = $presentSymbols; } $nodeToReflection = new NodeToReflection(); if ($identifier->isClass()) { $classNodes = $fetchedNodesResult->getClassNodes(); $className = strtolower($identifier->getName()); if (!array_key_exists($className, $classNodes)) { return null; } foreach ($classNodes[$className] as $classNode) { $classReflection = $nodeToReflection->__invoke($reflector, $classNode->getNode(), $classNode->getLocatedSource(), $classNode->getNamespace()); if (!$classReflection instanceof ReflectionClass) { throw new ShouldNotHappenException(); } return $classReflection; } } if ($identifier->isFunction()) { $functionNodes = $fetchedNodesResult->getFunctionNodes(); $functionName = strtolower($identifier->getName()); if (!array_key_exists($functionName, $functionNodes)) { return null; } foreach ($functionNodes[$functionName] as $functionNode) { $functionReflection = $nodeToReflection->__invoke($reflector, $functionNode->getNode(), $functionNode->getLocatedSource(), $functionNode->getNamespace()); if (!$functionReflection instanceof ReflectionFunction) { throw new ShouldNotHappenException(); } return $functionReflection; } } if ($identifier->isConstant()) { $constantNodes = $fetchedNodesResult->getConstantNodes(); $constantName = ConstantNameHelper::normalize($identifier->getName()); if (!array_key_exists($constantName, $constantNodes)) { return null; } foreach ($constantNodes[$constantName] as $fetchedConstantNode) { $constantNode = $fetchedConstantNode->getNode(); $positionInNode = null; if ($constantNode instanceof Const_) { foreach ($constantNode->consts as $constPosition => $const) { if ($const->namespacedName === null) { throw new ShouldNotHappenException(); } if (ConstantNameHelper::normalize($const->namespacedName->toString()) === $constantName) { /** @var int $positionInNode */ $positionInNode = $constPosition; break; } } if ($positionInNode === null) { throw new ShouldNotHappenException(); } } $constantReflection = $nodeToReflection->__invoke($reflector, $fetchedConstantNode->getNode(), $fetchedConstantNode->getLocatedSource(), $fetchedConstantNode->getNamespace(), $positionInNode); if (!$constantReflection instanceof ReflectionConstant) { throw new ShouldNotHappenException(); } return $constantReflection; } return null; } throw new ShouldNotHappenException(); } public function locateIdentifiersByType(Reflector $reflector, IdentifierType $identifierType) : array { $fetchedNodesResult = $this->fileNodesFetcher->fetchNodes($this->fileName); $nodeToReflection = new NodeToReflection(); $reflections = []; if ($identifierType->isClass()) { $classNodes = $fetchedNodesResult->getClassNodes(); foreach ($classNodes as $classNodesArray) { foreach ($classNodesArray as $classNode) { $classReflection = $nodeToReflection->__invoke($reflector, $classNode->getNode(), $classNode->getLocatedSource(), $classNode->getNamespace()); if (!$classReflection instanceof ReflectionClass) { throw new ShouldNotHappenException(); } $reflections[] = $classReflection; } } } if ($identifierType->isFunction()) { $functionNodes = $fetchedNodesResult->getFunctionNodes(); foreach ($functionNodes as $functionNodesArray) { foreach ($functionNodesArray as $functionNode) { $functionReflection = $nodeToReflection->__invoke($reflector, $functionNode->getNode(), $functionNode->getLocatedSource(), $functionNode->getNamespace()); $reflections[] = $functionReflection; } } } if ($identifierType->isConstant()) { $constantNodes = $fetchedNodesResult->getConstantNodes(); foreach ($constantNodes as $constantNodesArray) { foreach ($constantNodesArray as $fetchedConstantNode) { $constantNode = $fetchedConstantNode->getNode(); if ($constantNode instanceof Const_) { foreach ($constantNode->consts as $constPosition => $const) { if ($const->namespacedName === null) { throw new ShouldNotHappenException(); } $constantReflection = $nodeToReflection->__invoke($reflector, $constantNode, $fetchedConstantNode->getLocatedSource(), $fetchedConstantNode->getNamespace(), $constPosition); if (!$constantReflection instanceof ReflectionConstant) { throw new ShouldNotHappenException(); } $reflections[] = $constantReflection; } continue; } $constantReflection = $nodeToReflection->__invoke($reflector, $constantNode, $fetchedConstantNode->getLocatedSource(), $fetchedConstantNode->getNamespace()); if (!$constantReflection instanceof ReflectionConstant) { throw new ShouldNotHappenException(); } $reflections[] = $constantReflection; } } } return $reflections; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\BetterReflection\Reflector; use PHPStan\BetterReflection\Identifier\Identifier; use PHPStan\BetterReflection\Identifier\IdentifierType; use PHPStan\BetterReflection\Reflection\ReflectionClass; use PHPStan\BetterReflection\Reflection\ReflectionConstant; use PHPStan\BetterReflection\Reflection\ReflectionFunction; use PHPStan\BetterReflection\Reflector\Exception\IdentifierNotFound; use PHPStan\BetterReflection\Reflector\Reflector; use function array_key_exists; use function strtolower; final class MemoizingReflector implements Reflector { /** * @var Reflector */ private $reflector; /** @var array<string, ReflectionClass|null> */ private $classReflections = []; /** @var array<string, ReflectionConstant|null> */ private $constantReflections = []; /** @var array<string, ReflectionFunction|null> */ private $functionReflections = []; public function __construct(Reflector $reflector) { $this->reflector = $reflector; } public function reflectClass(string $className) : ReflectionClass { $lowerClassName = strtolower($className); if (array_key_exists($lowerClassName, $this->classReflections) && $this->classReflections[$lowerClassName] !== null) { return $this->classReflections[$lowerClassName]; } if (array_key_exists($className, $this->classReflections)) { $classReflection = $this->classReflections[$className]; if ($classReflection === null) { throw IdentifierNotFound::fromIdentifier(new Identifier($className, new IdentifierType(IdentifierType::IDENTIFIER_CLASS))); } return $classReflection; } try { return $this->classReflections[$lowerClassName] = $this->reflector->reflectClass($className); } catch (IdentifierNotFound $e) { $this->classReflections[$className] = null; throw $e; } } public function reflectConstant(string $constantName) : ReflectionConstant { if (array_key_exists($constantName, $this->constantReflections)) { $constantReflection = $this->constantReflections[$constantName]; if ($constantReflection === null) { throw IdentifierNotFound::fromIdentifier(new Identifier($constantName, new IdentifierType(IdentifierType::IDENTIFIER_CONSTANT))); } return $constantReflection; } try { return $this->constantReflections[$constantName] = $this->reflector->reflectConstant($constantName); } catch (IdentifierNotFound $e) { $this->constantReflections[$constantName] = null; throw $e; } } public function reflectFunction(string $functionName) : ReflectionFunction { $lowerFunctionName = strtolower($functionName); if (array_key_exists($lowerFunctionName, $this->functionReflections)) { $functionReflection = $this->functionReflections[$lowerFunctionName]; if ($functionReflection === null) { throw IdentifierNotFound::fromIdentifier(new Identifier($functionName, new IdentifierType(IdentifierType::IDENTIFIER_FUNCTION))); } return $functionReflection; } try { return $this->functionReflections[$lowerFunctionName] = $this->reflector->reflectFunction($functionName); } catch (IdentifierNotFound $e) { $this->functionReflections[$lowerFunctionName] = null; throw $e; } } public function reflectAllClasses() : iterable { return $this->reflector->reflectAllClasses(); } public function reflectAllFunctions() : iterable { return $this->reflector->reflectAllFunctions(); } public function reflectAllConstants() : iterable { return $this->reflector->reflectAllConstants(); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\BetterReflection; use PHPStan\BetterReflection\Reflector\Reflector; interface BetterReflectionProviderFactory { public function create(Reflector $reflector) : \PHPStan\Reflection\BetterReflection\BetterReflectionProvider; } <?php declare (strict_types=1); namespace PHPStan\Reflection\BetterReflection; use Closure; use _PHPStan_7d8742a37\Nette\Utils\Strings; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\BetterReflection\Identifier\Exception\InvalidIdentifierName; use PHPStan\BetterReflection\NodeCompiler\Exception\UnableToCompileNode; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionClass; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionFunction; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionParameter; use PHPStan\BetterReflection\Reflection\ReflectionEnum; use PHPStan\BetterReflection\Reflector\Exception\IdentifierNotFound; use PHPStan\BetterReflection\Reflector\Reflector; use PHPStan\BetterReflection\SourceLocator\Located\LocatedSource; use PHPStan\BetterReflection\SourceLocator\SourceStubber\PhpStormStubsSourceStubber; use PHPStan\Broker\AnonymousClassNameHelper; use PHPStan\Broker\ClassNotFoundException; use PHPStan\Broker\ConstantNotFoundException; use PHPStan\Broker\FunctionNotFoundException; use PHPStan\DependencyInjection\Reflection\ClassReflectionExtensionRegistryProvider; use PHPStan\File\FileHelper; use PHPStan\File\FileReader; use PHPStan\File\RelativePathHelper; use PHPStan\Parser\AnonymousClassVisitor; use PHPStan\Php\PhpVersion; use PHPStan\PhpDoc\PhpDocInheritanceResolver; use PHPStan\PhpDoc\StubPhpDocProvider; use PHPStan\PhpDoc\Tag\ParamClosureThisTag; use PHPStan\PhpDoc\Tag\ParamOutTag; use PHPStan\Reflection\Assertions; use PHPStan\Reflection\ClassNameHelper; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\Constant\RuntimeConstantReflection; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\FunctionReflectionFactory; use PHPStan\Reflection\GlobalConstantReflection; use PHPStan\Reflection\InitializerExprContext; use PHPStan\Reflection\InitializerExprTypeResolver; use PHPStan\Reflection\NamespaceAnswerer; use PHPStan\Reflection\Php\ExitFunctionReflection; use PHPStan\Reflection\Php\PhpFunctionReflection; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Reflection\SignatureMap\NativeFunctionReflectionProvider; use PHPStan\Reflection\SignatureMap\SignatureMapProvider; use PHPStan\ShouldNotHappenException; use PHPStan\TrinaryLogic; use PHPStan\Type\FileTypeMapper; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\Type; use function array_key_exists; use function array_map; use function base64_decode; use function in_array; use function sprintf; use function strtolower; use const PHP_VERSION_ID; final class BetterReflectionProvider implements ReflectionProvider { /** * @var ReflectionProvider\ReflectionProviderProvider */ private $reflectionProviderProvider; /** * @var InitializerExprTypeResolver */ private $initializerExprTypeResolver; /** * @var ClassReflectionExtensionRegistryProvider */ private $classReflectionExtensionRegistryProvider; /** * @var Reflector */ private $reflector; /** * @var FileTypeMapper */ private $fileTypeMapper; /** * @var PhpDocInheritanceResolver */ private $phpDocInheritanceResolver; /** * @var PhpVersion */ private $phpVersion; /** * @var NativeFunctionReflectionProvider */ private $nativeFunctionReflectionProvider; /** * @var StubPhpDocProvider */ private $stubPhpDocProvider; /** * @var FunctionReflectionFactory */ private $functionReflectionFactory; /** * @var RelativePathHelper */ private $relativePathHelper; /** * @var AnonymousClassNameHelper */ private $anonymousClassNameHelper; /** * @var FileHelper */ private $fileHelper; /** * @var PhpStormStubsSourceStubber */ private $phpstormStubsSourceStubber; /** * @var SignatureMapProvider */ private $signatureMapProvider; /** * @var string[] */ private $universalObjectCratesClasses; /** @var FunctionReflection[] */ private $functionReflections = []; /** @var ClassReflection[] */ private $classReflections = []; /** @var ClassReflection[] */ private static $anonymousClasses = []; /** @var array<string, GlobalConstantReflection> */ private $cachedConstants = []; /** * @param string[] $universalObjectCratesClasses */ public function __construct(ReflectionProvider\ReflectionProviderProvider $reflectionProviderProvider, InitializerExprTypeResolver $initializerExprTypeResolver, ClassReflectionExtensionRegistryProvider $classReflectionExtensionRegistryProvider, Reflector $reflector, FileTypeMapper $fileTypeMapper, PhpDocInheritanceResolver $phpDocInheritanceResolver, PhpVersion $phpVersion, NativeFunctionReflectionProvider $nativeFunctionReflectionProvider, StubPhpDocProvider $stubPhpDocProvider, FunctionReflectionFactory $functionReflectionFactory, RelativePathHelper $relativePathHelper, AnonymousClassNameHelper $anonymousClassNameHelper, FileHelper $fileHelper, PhpStormStubsSourceStubber $phpstormStubsSourceStubber, SignatureMapProvider $signatureMapProvider, array $universalObjectCratesClasses) { $this->reflectionProviderProvider = $reflectionProviderProvider; $this->initializerExprTypeResolver = $initializerExprTypeResolver; $this->classReflectionExtensionRegistryProvider = $classReflectionExtensionRegistryProvider; $this->reflector = $reflector; $this->fileTypeMapper = $fileTypeMapper; $this->phpDocInheritanceResolver = $phpDocInheritanceResolver; $this->phpVersion = $phpVersion; $this->nativeFunctionReflectionProvider = $nativeFunctionReflectionProvider; $this->stubPhpDocProvider = $stubPhpDocProvider; $this->functionReflectionFactory = $functionReflectionFactory; $this->relativePathHelper = $relativePathHelper; $this->anonymousClassNameHelper = $anonymousClassNameHelper; $this->fileHelper = $fileHelper; $this->phpstormStubsSourceStubber = $phpstormStubsSourceStubber; $this->signatureMapProvider = $signatureMapProvider; $this->universalObjectCratesClasses = $universalObjectCratesClasses; } public function hasClass(string $className) : bool { if (isset(self::$anonymousClasses[$className])) { return \true; } if (!ClassNameHelper::isValidClassName($className)) { return \false; } try { $this->reflector->reflectClass($className); return \true; } catch (IdentifierNotFound $e) { return \false; } catch (InvalidIdentifierName $e) { return \false; } } public function getClass(string $className) : ClassReflection { if (isset(self::$anonymousClasses[$className])) { return self::$anonymousClasses[$className]; } try { $reflectionClass = $this->reflector->reflectClass($className); } catch (IdentifierNotFound|InvalidIdentifierName $e) { throw new ClassNotFoundException($className); } $reflectionClassName = strtolower($reflectionClass->getName()); if (array_key_exists($reflectionClassName, $this->classReflections)) { return $this->classReflections[$reflectionClassName]; } $enumAdapter = base64_decode('UEhQU3RhblxCZXR0ZXJSZWZsZWN0aW9uXFJlZmxlY3Rpb25cQWRhcHRlclxSZWZsZWN0aW9uRW51bQ==', \true); $classReflection = new ClassReflection($this->reflectionProviderProvider->getReflectionProvider(), $this->initializerExprTypeResolver, $this->fileTypeMapper, $this->stubPhpDocProvider, $this->phpDocInheritanceResolver, $this->phpVersion, $this->signatureMapProvider, $this->classReflectionExtensionRegistryProvider->getRegistry()->getPropertiesClassReflectionExtensions(), $this->classReflectionExtensionRegistryProvider->getRegistry()->getMethodsClassReflectionExtensions(), $this->classReflectionExtensionRegistryProvider->getRegistry()->getAllowedSubTypesClassReflectionExtensions(), $this->classReflectionExtensionRegistryProvider->getRegistry()->getRequireExtendsPropertyClassReflectionExtension(), $this->classReflectionExtensionRegistryProvider->getRegistry()->getRequireExtendsMethodsClassReflectionExtension(), $reflectionClass->getName(), $reflectionClass instanceof ReflectionEnum && PHP_VERSION_ID >= 80000 ? new $enumAdapter($reflectionClass) : new ReflectionClass($reflectionClass), null, null, $this->stubPhpDocProvider->findClassPhpDoc($reflectionClass->getName()), $this->universalObjectCratesClasses); $this->classReflections[$reflectionClassName] = $classReflection; return $classReflection; } public function getClassName(string $className) : string { if (!$this->hasClass($className)) { throw new ClassNotFoundException($className); } if (isset(self::$anonymousClasses[$className])) { return self::$anonymousClasses[$className]->getDisplayName(); } $reflectionClass = $this->reflector->reflectClass($className); return $reflectionClass->getName(); } public function supportsAnonymousClasses() : bool { return \true; } public function getAnonymousClassReflection(Node\Stmt\Class_ $classNode, Scope $scope) : ClassReflection { if (isset($classNode->namespacedName)) { throw new ShouldNotHappenException(); } if (!$scope->isInTrait()) { $scopeFile = $scope->getFile(); } else { $scopeFile = $scope->getTraitReflection()->getFileName(); if ($scopeFile === null) { $scopeFile = $scope->getFile(); } } $filename = $this->fileHelper->normalizePath($this->relativePathHelper->getRelativePath($scopeFile), '/'); $className = $this->anonymousClassNameHelper->getAnonymousClassName($classNode, $scopeFile); $classNode->name = new Node\Identifier($className); if (isset(self::$anonymousClasses[$className])) { return self::$anonymousClasses[$className]; } $reflectionClass = \PHPStan\BetterReflection\Reflection\ReflectionClass::createFromNode($this->reflector, $classNode, new LocatedSource(FileReader::read($scopeFile), $className, $scopeFile), null); /** @var int|null $classLineIndex */ $classLineIndex = $classNode->getAttribute(AnonymousClassVisitor::ATTRIBUTE_LINE_INDEX); if ($classLineIndex === null) { $displayName = sprintf('class@anonymous/%s:%s', $filename, $classNode->getStartLine()); } else { $displayName = sprintf('class@anonymous/%s:%s:%d', $filename, $classNode->getStartLine(), $classLineIndex); } self::$anonymousClasses[$className] = new ClassReflection($this->reflectionProviderProvider->getReflectionProvider(), $this->initializerExprTypeResolver, $this->fileTypeMapper, $this->stubPhpDocProvider, $this->phpDocInheritanceResolver, $this->phpVersion, $this->signatureMapProvider, $this->classReflectionExtensionRegistryProvider->getRegistry()->getPropertiesClassReflectionExtensions(), $this->classReflectionExtensionRegistryProvider->getRegistry()->getMethodsClassReflectionExtensions(), $this->classReflectionExtensionRegistryProvider->getRegistry()->getAllowedSubTypesClassReflectionExtensions(), $this->classReflectionExtensionRegistryProvider->getRegistry()->getRequireExtendsPropertyClassReflectionExtension(), $this->classReflectionExtensionRegistryProvider->getRegistry()->getRequireExtendsMethodsClassReflectionExtension(), $displayName, new ReflectionClass($reflectionClass), $scopeFile, null, $this->stubPhpDocProvider->findClassPhpDoc($className), $this->universalObjectCratesClasses); $this->classReflections[$className] = self::$anonymousClasses[$className]; return self::$anonymousClasses[$className]; } public function hasFunction(Node\Name $nameNode, ?NamespaceAnswerer $namespaceAnswerer) : bool { return $this->resolveFunctionName($nameNode, $namespaceAnswerer) !== null; } public function getFunction(Node\Name $nameNode, ?NamespaceAnswerer $namespaceAnswerer) : FunctionReflection { $functionName = $this->resolveFunctionName($nameNode, $namespaceAnswerer); if ($functionName === null) { throw new FunctionNotFoundException((string) $nameNode); } $lowerCasedFunctionName = strtolower($functionName); if (isset($this->functionReflections[$lowerCasedFunctionName])) { return $this->functionReflections[$lowerCasedFunctionName]; } if (in_array($lowerCasedFunctionName, ['exit', 'die'], \true)) { return $this->functionReflections[$lowerCasedFunctionName] = new ExitFunctionReflection($lowerCasedFunctionName); } $nativeFunctionReflection = $this->nativeFunctionReflectionProvider->findFunctionReflection($lowerCasedFunctionName); if ($nativeFunctionReflection !== null) { $this->functionReflections[$lowerCasedFunctionName] = $nativeFunctionReflection; return $nativeFunctionReflection; } $this->functionReflections[$lowerCasedFunctionName] = $this->getCustomFunction($functionName); return $this->functionReflections[$lowerCasedFunctionName]; } private function getCustomFunction(string $functionName) : PhpFunctionReflection { $reflectionFunction = new ReflectionFunction($this->reflector->reflectFunction($functionName)); $templateTypeMap = TemplateTypeMap::createEmpty(); $phpDocParameterTypes = []; $phpDocReturnTag = null; $phpDocThrowsTag = null; $deprecatedTag = null; $isDeprecated = \false; $isInternal = \false; $isFinal = \false; $isPure = null; $asserts = Assertions::createEmpty(); $acceptsNamedArguments = \true; $phpDocComment = null; $phpDocParameterOutTags = []; $phpDocParameterImmediatelyInvokedCallable = []; $phpDocParameterClosureThisTypeTags = []; $resolvedPhpDoc = $this->stubPhpDocProvider->findFunctionPhpDoc($reflectionFunction->getName(), array_map(static function (ReflectionParameter $parameter) : string { return $parameter->getName(); }, $reflectionFunction->getParameters())); if ($resolvedPhpDoc === null && $reflectionFunction->getFileName() !== \false && $reflectionFunction->getDocComment() !== \false) { $docComment = $reflectionFunction->getDocComment(); $resolvedPhpDoc = $this->fileTypeMapper->getResolvedPhpDoc($reflectionFunction->getFileName(), null, null, $reflectionFunction->getName(), $docComment); } if ($resolvedPhpDoc !== null) { $templateTypeMap = $resolvedPhpDoc->getTemplateTypeMap(); $phpDocParameterTypes = array_map(static function ($tag) { return $tag->getType(); }, $resolvedPhpDoc->getParamTags()); $phpDocReturnTag = $resolvedPhpDoc->getReturnTag(); $phpDocThrowsTag = $resolvedPhpDoc->getThrowsTag(); $deprecatedTag = $resolvedPhpDoc->getDeprecatedTag(); $isDeprecated = $resolvedPhpDoc->isDeprecated(); $isInternal = $resolvedPhpDoc->isInternal(); $isFinal = $resolvedPhpDoc->isFinal(); $isPure = $resolvedPhpDoc->isPure(); $asserts = Assertions::createFromResolvedPhpDocBlock($resolvedPhpDoc); if ($resolvedPhpDoc->hasPhpDocString()) { $phpDocComment = $resolvedPhpDoc->getPhpDocString(); } $acceptsNamedArguments = $resolvedPhpDoc->acceptsNamedArguments(); $phpDocParameterOutTags = $resolvedPhpDoc->getParamOutTags(); $phpDocParameterImmediatelyInvokedCallable = $resolvedPhpDoc->getParamsImmediatelyInvokedCallable(); $phpDocParameterClosureThisTypeTags = $resolvedPhpDoc->getParamClosureThisTags(); } return $this->functionReflectionFactory->create($reflectionFunction, $templateTypeMap, $phpDocParameterTypes, $phpDocReturnTag !== null ? $phpDocReturnTag->getType() : null, $phpDocThrowsTag !== null ? $phpDocThrowsTag->getType() : null, $deprecatedTag !== null ? $deprecatedTag->getMessage() : null, $isDeprecated, $isInternal, $isFinal, $reflectionFunction->getFileName() !== \false ? $reflectionFunction->getFileName() : null, $isPure, $asserts, $acceptsNamedArguments, $phpDocComment, array_map(static function (ParamOutTag $paramOutTag) : Type { return $paramOutTag->getType(); }, $phpDocParameterOutTags), $phpDocParameterImmediatelyInvokedCallable, array_map(static function (ParamClosureThisTag $tag) : Type { return $tag->getType(); }, $phpDocParameterClosureThisTypeTags)); } public function resolveFunctionName(Node\Name $nameNode, ?NamespaceAnswerer $namespaceAnswerer) : ?string { $name = $nameNode->toLowerString(); if (in_array($name, ['exit', 'die'], \true)) { return $name; } return $this->resolveName($nameNode, function (string $name) : bool { try { $this->reflector->reflectFunction($name); return \true; } catch (IdentifierNotFound $e) { // pass } catch (InvalidIdentifierName $e) { // pass } if ($this->nativeFunctionReflectionProvider->findFunctionReflection($name) !== null) { return $this->phpstormStubsSourceStubber->isPresentFunction($name) !== \false; } return \false; }, $namespaceAnswerer); } public function hasConstant(Node\Name $nameNode, ?NamespaceAnswerer $namespaceAnswerer) : bool { return $this->resolveConstantName($nameNode, $namespaceAnswerer) !== null; } public function getConstant(Node\Name $nameNode, ?NamespaceAnswerer $namespaceAnswerer) : GlobalConstantReflection { $constantName = $this->resolveConstantName($nameNode, $namespaceAnswerer); if ($constantName === null) { throw new ConstantNotFoundException((string) $nameNode); } if (array_key_exists($constantName, $this->cachedConstants)) { return $this->cachedConstants[$constantName]; } $constantReflection = $this->reflector->reflectConstant($constantName); $fileName = $constantReflection->getFileName(); $constantValueType = $this->initializerExprTypeResolver->getType($constantReflection->getValueExpression(), InitializerExprContext::fromGlobalConstant($constantReflection)); $docComment = $constantReflection->getDocComment(); $isDeprecated = TrinaryLogic::createNo(); $deprecatedDescription = null; if ($docComment !== null) { $resolvedPhpDoc = $this->fileTypeMapper->getResolvedPhpDoc($fileName, null, null, null, $docComment); $isDeprecated = TrinaryLogic::createFromBoolean($resolvedPhpDoc->isDeprecated()); if ($resolvedPhpDoc->isDeprecated() && $resolvedPhpDoc->getDeprecatedTag() !== null) { $deprecatedMessage = $resolvedPhpDoc->getDeprecatedTag()->getMessage(); $matches = Strings::match($deprecatedMessage ?? '', '#^(\\d+)\\.(\\d+)(?:\\.(\\d+))?$#'); if ($matches !== null) { $major = $matches[1]; $minor = $matches[2]; $patch = $matches[3] ?? 0; $versionId = sprintf('%d%02d%02d', $major, $minor, $patch); $isDeprecated = TrinaryLogic::createFromBoolean($this->phpVersion->getVersionId() >= $versionId); } else { // filter raw version number messages like in // https://github.com/JetBrains/phpstorm-stubs/blob/9608c953230b08f07b703ecfe459cc58d5421437/filter/filter.php#L478 $deprecatedDescription = $deprecatedMessage; } } } return $this->cachedConstants[$constantName] = new RuntimeConstantReflection($constantName, $constantValueType, $fileName, $isDeprecated, $deprecatedDescription); } public function resolveConstantName(Node\Name $nameNode, ?NamespaceAnswerer $namespaceAnswerer) : ?string { return $this->resolveName($nameNode, function (string $name) : bool { try { $this->reflector->reflectConstant($name); return \true; } catch (IdentifierNotFound $e) { // pass } catch (UnableToCompileNode $e) { // pass } return \false; }, $namespaceAnswerer); } /** * @param Closure(string $name): bool $existsCallback */ private function resolveName(Node\Name $nameNode, Closure $existsCallback, ?NamespaceAnswerer $namespaceAnswerer) : ?string { $name = (string) $nameNode; if ($namespaceAnswerer !== null && $namespaceAnswerer->getNamespace() !== null && !$nameNode->isFullyQualified()) { $namespacedName = sprintf('%s\\%s', $namespaceAnswerer->getNamespace(), $name); if ($existsCallback($namespacedName)) { return $namespacedName; } } if ($existsCallback($name)) { return $name; } return null; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\BetterReflection\SourceStubber; use PhpParser\Parser; use PHPStan\BetterReflection\SourceLocator\SourceStubber\PhpStormStubsSourceStubber; use PHPStan\Node\Printer\Printer; use PHPStan\Php\PhpVersion; final class PhpStormStubsSourceStubberFactory { /** * @var Parser */ private $phpParser; /** * @var Printer */ private $printer; /** * @var PhpVersion */ private $phpVersion; public function __construct(Parser $phpParser, Printer $printer, PhpVersion $phpVersion) { $this->phpParser = $phpParser; $this->printer = $printer; $this->phpVersion = $phpVersion; } public function create() : PhpStormStubsSourceStubber { return new PhpStormStubsSourceStubber($this->phpParser, $this->printer, $this->phpVersion->getVersionId()); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\BetterReflection\SourceStubber; use PHPStan\BetterReflection\SourceLocator\SourceStubber\ReflectionSourceStubber; use PHPStan\Node\Printer\Printer; use PHPStan\Php\PhpVersion; final class ReflectionSourceStubberFactory { /** * @var Printer */ private $printer; /** * @var PhpVersion */ private $phpVersion; public function __construct(Printer $printer, PhpVersion $phpVersion) { $this->printer = $printer; $this->phpVersion = $phpVersion; } public function create() : ReflectionSourceStubber { return new ReflectionSourceStubber($this->printer, $this->phpVersion->getVersionId()); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\BetterReflection; use Phar; use PhpParser\Parser; use PHPStan\BetterReflection\SourceLocator\Ast\Locator; use PHPStan\BetterReflection\SourceLocator\SourceStubber\PhpStormStubsSourceStubber; use PHPStan\BetterReflection\SourceLocator\SourceStubber\ReflectionSourceStubber; use PHPStan\BetterReflection\SourceLocator\Type\AggregateSourceLocator; use PHPStan\BetterReflection\SourceLocator\Type\Composer\Psr\Psr4Mapping; use PHPStan\BetterReflection\SourceLocator\Type\EvaledCodeSourceLocator; use PHPStan\BetterReflection\SourceLocator\Type\MemoizingSourceLocator; use PHPStan\BetterReflection\SourceLocator\Type\PhpInternalSourceLocator; use PHPStan\BetterReflection\SourceLocator\Type\SourceLocator; use PHPStan\Reflection\BetterReflection\SourceLocator\AutoloadFunctionsSourceLocator; use PHPStan\Reflection\BetterReflection\SourceLocator\AutoloadSourceLocator; use PHPStan\Reflection\BetterReflection\SourceLocator\ComposerJsonAndInstalledJsonSourceLocatorMaker; use PHPStan\Reflection\BetterReflection\SourceLocator\FileNodesFetcher; use PHPStan\Reflection\BetterReflection\SourceLocator\OptimizedDirectorySourceLocatorRepository; use PHPStan\Reflection\BetterReflection\SourceLocator\OptimizedPsrAutoloaderLocatorFactory; use PHPStan\Reflection\BetterReflection\SourceLocator\OptimizedSingleFileSourceLocatorRepository; use PHPStan\Reflection\BetterReflection\SourceLocator\PhpVersionBlacklistSourceLocator; use PHPStan\Reflection\BetterReflection\SourceLocator\ReflectionClassSourceLocator; use PHPStan\Reflection\BetterReflection\SourceLocator\RewriteClassAliasSourceLocator; use PHPStan\Reflection\BetterReflection\SourceLocator\SkipClassAliasSourceLocator; use function array_merge; use function array_unique; use function extension_loaded; use function is_dir; use function is_file; final class BetterReflectionSourceLocatorFactory { /** * @var Parser */ private $parser; /** * @var Parser */ private $php8Parser; /** * @var PhpStormStubsSourceStubber */ private $phpstormStubsSourceStubber; /** * @var ReflectionSourceStubber */ private $reflectionSourceStubber; /** * @var OptimizedSingleFileSourceLocatorRepository */ private $optimizedSingleFileSourceLocatorRepository; /** * @var OptimizedDirectorySourceLocatorRepository */ private $optimizedDirectorySourceLocatorRepository; /** * @var ComposerJsonAndInstalledJsonSourceLocatorMaker */ private $composerJsonAndInstalledJsonSourceLocatorMaker; /** * @var OptimizedPsrAutoloaderLocatorFactory */ private $optimizedPsrAutoloaderLocatorFactory; /** * @var FileNodesFetcher */ private $fileNodesFetcher; /** * @var string[] */ private $scanFiles; /** * @var string[] */ private $scanDirectories; /** * @var string[] */ private $analysedPaths; /** * @var string[] */ private $composerAutoloaderProjectPaths; /** * @var string[] */ private $analysedPathsFromConfig; /** * @var bool */ private $playgroundMode; /** * @param string[] $scanFiles * @param string[] $scanDirectories * @param string[] $analysedPaths * @param string[] $composerAutoloaderProjectPaths * @param string[] $analysedPathsFromConfig */ public function __construct(Parser $parser, Parser $php8Parser, PhpStormStubsSourceStubber $phpstormStubsSourceStubber, ReflectionSourceStubber $reflectionSourceStubber, OptimizedSingleFileSourceLocatorRepository $optimizedSingleFileSourceLocatorRepository, OptimizedDirectorySourceLocatorRepository $optimizedDirectorySourceLocatorRepository, ComposerJsonAndInstalledJsonSourceLocatorMaker $composerJsonAndInstalledJsonSourceLocatorMaker, OptimizedPsrAutoloaderLocatorFactory $optimizedPsrAutoloaderLocatorFactory, FileNodesFetcher $fileNodesFetcher, array $scanFiles, array $scanDirectories, array $analysedPaths, array $composerAutoloaderProjectPaths, array $analysedPathsFromConfig, bool $playgroundMode) { $this->parser = $parser; $this->php8Parser = $php8Parser; $this->phpstormStubsSourceStubber = $phpstormStubsSourceStubber; $this->reflectionSourceStubber = $reflectionSourceStubber; $this->optimizedSingleFileSourceLocatorRepository = $optimizedSingleFileSourceLocatorRepository; $this->optimizedDirectorySourceLocatorRepository = $optimizedDirectorySourceLocatorRepository; $this->composerJsonAndInstalledJsonSourceLocatorMaker = $composerJsonAndInstalledJsonSourceLocatorMaker; $this->optimizedPsrAutoloaderLocatorFactory = $optimizedPsrAutoloaderLocatorFactory; $this->fileNodesFetcher = $fileNodesFetcher; $this->scanFiles = $scanFiles; $this->scanDirectories = $scanDirectories; $this->analysedPaths = $analysedPaths; $this->composerAutoloaderProjectPaths = $composerAutoloaderProjectPaths; $this->analysedPathsFromConfig = $analysedPathsFromConfig; $this->playgroundMode = $playgroundMode; } public function create() : SourceLocator { $locators = []; $astLocator = new Locator($this->parser); $locators[] = new AutoloadFunctionsSourceLocator(new AutoloadSourceLocator($this->fileNodesFetcher, \false), new ReflectionClassSourceLocator($astLocator, $this->reflectionSourceStubber)); $analysedDirectories = []; $analysedFiles = []; foreach (array_merge($this->analysedPaths, $this->analysedPathsFromConfig) as $analysedPath) { if (is_file($analysedPath)) { $analysedFiles[] = $analysedPath; continue; } if (!is_dir($analysedPath)) { continue; } $analysedDirectories[] = $analysedPath; } $fileLocators = []; $analysedFiles = array_unique(array_merge($analysedFiles, $this->scanFiles)); foreach ($analysedFiles as $analysedFile) { $fileLocators[] = $this->optimizedSingleFileSourceLocatorRepository->getOrCreate($analysedFile); } $directories = array_unique(array_merge($analysedDirectories, $this->scanDirectories)); foreach ($directories as $directory) { $fileLocators[] = $this->optimizedDirectorySourceLocatorRepository->getOrCreate($directory); } $astPhp8Locator = new Locator($this->php8Parser); foreach ($this->composerAutoloaderProjectPaths as $composerAutoloaderProjectPath) { $locator = $this->composerJsonAndInstalledJsonSourceLocatorMaker->create($composerAutoloaderProjectPath); if ($locator === null) { continue; } $fileLocators[] = $locator; } if (extension_loaded('phar')) { $pharProtocolPath = Phar::running(); if ($pharProtocolPath !== '') { $mappings = ['PHPStan\\BetterReflection\\' => [$pharProtocolPath . '/vendor/ondrejmirtes/better-reflection/src/']]; if ($this->playgroundMode) { $mappings['PHPStan\\'] = [$pharProtocolPath . '/src/']; } else { $mappings['PHPStan\\Testing\\'] = [$pharProtocolPath . '/src/Testing/']; } $fileLocators[] = $this->optimizedPsrAutoloaderLocatorFactory->create(Psr4Mapping::fromArrayMappings($mappings)); } } $locators[] = new RewriteClassAliasSourceLocator(new AggregateSourceLocator($fileLocators)); $locators[] = new SkipClassAliasSourceLocator(new PhpInternalSourceLocator($astPhp8Locator, $this->phpstormStubsSourceStubber)); $locators[] = new AutoloadSourceLocator($this->fileNodesFetcher, \true); $locators[] = new PhpVersionBlacklistSourceLocator(new PhpInternalSourceLocator($astLocator, $this->reflectionSourceStubber), $this->phpstormStubsSourceStubber); $locators[] = new PhpVersionBlacklistSourceLocator(new EvaledCodeSourceLocator($astLocator, $this->reflectionSourceStubber), $this->phpstormStubsSourceStubber); return new MemoizingSourceLocator(new AggregateSourceLocator($locators)); } } <?php declare (strict_types=1); namespace PHPStan\Reflection; use _PHPStan_7d8742a37\Nette\Utils\Strings; use function ltrim; final class ClassNameHelper { public static function isValidClassName(string $name) : bool { // from https://stackoverflow.com/questions/3195614/validate-class-method-names-with-regex#comment104531582_12011255 return Strings::match(ltrim($name, '\\'), '/^[a-zA-Z_\\x80-\\xff][a-zA-Z0-9_\\x80-\\xff]*(\\\\[a-zA-Z_\\x80-\\xff][a-zA-Z0-9_\\x80-\\xff]*)*$/') !== null; } } <?php declare (strict_types=1); namespace PHPStan\Reflection; use PHPStan\ShouldNotHappenException; final class ReflectionProviderStaticAccessor { /** * @var ?ReflectionProvider */ private static $instance = null; private function __construct() { } public static function registerInstance(\PHPStan\Reflection\ReflectionProvider $reflectionProvider) : void { self::$instance = $reflectionProvider; } public static function getInstance() : \PHPStan\Reflection\ReflectionProvider { if (self::$instance === null) { throw new ShouldNotHappenException(); } return self::$instance; } } <?php declare (strict_types=1); namespace PHPStan\Reflection; use PHPStan\DependencyInjection\Container; use ReflectionException; use function array_key_exists; use function explode; final class ConstructorsHelper { /** * @var Container */ private $container; /** * @var list<string> */ private $additionalConstructors; /** @var array<string, list<string>> */ private $additionalConstructorsCache = []; /** * @param list<string> $additionalConstructors */ public function __construct(Container $container, array $additionalConstructors) { $this->container = $container; $this->additionalConstructors = $additionalConstructors; } /** * @return list<string> */ public function getConstructors(\PHPStan\Reflection\ClassReflection $classReflection) : array { if (array_key_exists($classReflection->getName(), $this->additionalConstructorsCache)) { return $this->additionalConstructorsCache[$classReflection->getName()]; } $constructors = []; if ($classReflection->hasConstructor()) { $constructors[] = $classReflection->getConstructor()->getName(); } /** @var AdditionalConstructorsExtension[] $extensions */ $extensions = $this->container->getServicesByTag(\PHPStan\Reflection\AdditionalConstructorsExtension::EXTENSION_TAG); foreach ($extensions as $extension) { $extensionConstructors = $extension->getAdditionalConstructors($classReflection); foreach ($extensionConstructors as $extensionConstructor) { $constructors[] = $extensionConstructor; } } $nativeReflection = $classReflection->getNativeReflection(); foreach ($this->additionalConstructors as $additionalConstructor) { [$className, $methodName] = explode('::', $additionalConstructor); if (!$nativeReflection->hasMethod($methodName)) { continue; } $nativeMethod = $nativeReflection->getMethod($methodName); if ($nativeMethod->getDeclaringClass()->getName() !== $nativeReflection->getName()) { continue; } try { $prototype = $nativeMethod->getPrototype(); } catch (ReflectionException $e) { $prototype = $nativeMethod; } if ($prototype->getDeclaringClass()->getName() !== $className) { continue; } $constructors[] = $methodName; } $this->additionalConstructorsCache[$classReflection->getName()] = $constructors; return $constructors; } } <?php declare (strict_types=1); namespace PHPStan\Reflection; use PHPStan\Type\Generic\TemplateTypeVarianceMap; use PHPStan\Type\Type; /** @api */ interface ParametersAcceptorWithPhpDocs extends \PHPStan\Reflection\ParametersAcceptor { /** * @return array<int, ParameterReflectionWithPhpDocs> */ public function getParameters() : array; public function getPhpDocReturnType() : Type; public function getNativeReturnType() : Type; public function getCallSiteVarianceMap() : TemplateTypeVarianceMap; } <?php declare (strict_types=1); namespace PHPStan\Reflection\Mixin; use PHPStan\Reflection\ClassMemberReflection; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\MethodReflection; use PHPStan\TrinaryLogic; use PHPStan\Type\Type; final class MixinMethodReflection implements MethodReflection { /** * @var MethodReflection */ private $reflection; /** * @var bool */ private $static; public function __construct(MethodReflection $reflection, bool $static) { $this->reflection = $reflection; $this->static = $static; } public function getDeclaringClass() : ClassReflection { return $this->reflection->getDeclaringClass(); } public function isStatic() : bool { return $this->static; } public function isPrivate() : bool { return $this->reflection->isPrivate(); } public function isPublic() : bool { return $this->reflection->isPublic(); } public function getDocComment() : ?string { return $this->reflection->getDocComment(); } public function getName() : string { return $this->reflection->getName(); } public function getPrototype() : ClassMemberReflection { return $this->reflection->getPrototype(); } public function getVariants() : array { return $this->reflection->getVariants(); } public function isDeprecated() : TrinaryLogic { return $this->reflection->isDeprecated(); } public function getDeprecatedDescription() : ?string { return $this->reflection->getDeprecatedDescription(); } public function isFinal() : TrinaryLogic { return $this->reflection->isFinal(); } public function isInternal() : TrinaryLogic { return $this->reflection->isInternal(); } public function getThrowType() : ?Type { return $this->reflection->getThrowType(); } public function hasSideEffects() : TrinaryLogic { return $this->reflection->hasSideEffects(); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Mixin; use PHPStan\Analyser\OutOfClassScope; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\MethodReflection; use PHPStan\Reflection\MethodsClassReflectionExtension; use PHPStan\ShouldNotHappenException; use PHPStan\Type\VerbosityLevel; use function array_intersect; use function count; final class MixinMethodsClassReflectionExtension implements MethodsClassReflectionExtension { /** * @var string[] */ private $mixinExcludeClasses; /** @var array<string, array<string, true>> */ private $inProcess = []; /** * @param string[] $mixinExcludeClasses */ public function __construct(array $mixinExcludeClasses) { $this->mixinExcludeClasses = $mixinExcludeClasses; } public function hasMethod(ClassReflection $classReflection, string $methodName) : bool { return $this->findMethod($classReflection, $methodName) !== null; } public function getMethod(ClassReflection $classReflection, string $methodName) : MethodReflection { $method = $this->findMethod($classReflection, $methodName); if ($method === null) { throw new ShouldNotHappenException(); } return $method; } private function findMethod(ClassReflection $classReflection, string $methodName) : ?MethodReflection { $mixinTypes = $classReflection->getResolvedMixinTypes(); foreach ($mixinTypes as $type) { if (count(array_intersect($type->getObjectClassNames(), $this->mixinExcludeClasses)) > 0) { continue; } $typeDescription = $type->describe(VerbosityLevel::typeOnly()); if (isset($this->inProcess[$typeDescription][$methodName])) { continue; } $this->inProcess[$typeDescription][$methodName] = \true; if (!$type->hasMethod($methodName)->yes()) { unset($this->inProcess[$typeDescription][$methodName]); continue; } $method = $type->getMethod($methodName, new OutOfClassScope()); unset($this->inProcess[$typeDescription][$methodName]); $static = $method->isStatic(); if (!$static && $classReflection->hasNativeMethod('__callStatic')) { $static = \true; } return new \PHPStan\Reflection\Mixin\MixinMethodReflection($method, $static); } foreach ($classReflection->getTraits() as $traitClass) { $methodWithDeclaringClass = $this->findMethod($traitClass, $methodName); if ($methodWithDeclaringClass === null) { continue; } return $methodWithDeclaringClass; } $parentClass = $classReflection->getParentClass(); while ($parentClass !== null) { $method = $this->findMethod($parentClass, $methodName); if ($method !== null) { return $method; } $parentClass = $parentClass->getParentClass(); } return null; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Mixin; use PHPStan\Analyser\OutOfClassScope; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\PropertiesClassReflectionExtension; use PHPStan\Reflection\PropertyReflection; use PHPStan\ShouldNotHappenException; use PHPStan\Type\VerbosityLevel; use function array_intersect; use function count; final class MixinPropertiesClassReflectionExtension implements PropertiesClassReflectionExtension { /** * @var string[] */ private $mixinExcludeClasses; /** @var array<string, array<string, true>> */ private $inProcess = []; /** * @param string[] $mixinExcludeClasses */ public function __construct(array $mixinExcludeClasses) { $this->mixinExcludeClasses = $mixinExcludeClasses; } public function hasProperty(ClassReflection $classReflection, string $propertyName) : bool { return $this->findProperty($classReflection, $propertyName) !== null; } public function getProperty(ClassReflection $classReflection, string $propertyName) : PropertyReflection { $property = $this->findProperty($classReflection, $propertyName); if ($property === null) { throw new ShouldNotHappenException(); } return $property; } private function findProperty(ClassReflection $classReflection, string $propertyName) : ?PropertyReflection { $mixinTypes = $classReflection->getResolvedMixinTypes(); foreach ($mixinTypes as $type) { if (count(array_intersect($type->getObjectClassNames(), $this->mixinExcludeClasses)) > 0) { continue; } $typeDescription = $type->describe(VerbosityLevel::typeOnly()); if (isset($this->inProcess[$typeDescription][$propertyName])) { continue; } $this->inProcess[$typeDescription][$propertyName] = \true; if (!$type->hasProperty($propertyName)->yes()) { unset($this->inProcess[$typeDescription][$propertyName]); continue; } $property = $type->getProperty($propertyName, new OutOfClassScope()); unset($this->inProcess[$typeDescription][$propertyName]); return $property; } foreach ($classReflection->getTraits() as $traitClass) { $methodWithDeclaringClass = $this->findProperty($traitClass, $propertyName); if ($methodWithDeclaringClass === null) { continue; } return $methodWithDeclaringClass; } $parentClass = $classReflection->getParentClass(); while ($parentClass !== null) { $property = $this->findProperty($parentClass, $propertyName); if ($property !== null) { return $property; } $parentClass = $parentClass->getParentClass(); } return null; } } <?php declare (strict_types=1); namespace PHPStan\Reflection; use PhpParser\Node\Expr; use PHPStan\BetterReflection\NodeCompiler\Exception\UnableToCompileNode; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionClassConstant; use PHPStan\TrinaryLogic; use PHPStan\Type\Type; use PHPStan\Type\TypehintHelper; use const NAN; /** * @api * @final */ class ClassConstantReflection implements \PHPStan\Reflection\ConstantReflection { /** * @var InitializerExprTypeResolver */ private $initializerExprTypeResolver; /** * @var ClassReflection */ private $declaringClass; /** * @var ReflectionClassConstant */ private $reflection; /** * @var ?Type */ private $nativeType; /** * @var ?Type */ private $phpDocType; /** * @var ?string */ private $deprecatedDescription; /** * @var bool */ private $isDeprecated; /** * @var bool */ private $isInternal; /** * @var bool */ private $isFinal; /** * @var ?Type */ private $valueType = null; public function __construct(\PHPStan\Reflection\InitializerExprTypeResolver $initializerExprTypeResolver, \PHPStan\Reflection\ClassReflection $declaringClass, ReflectionClassConstant $reflection, ?Type $nativeType, ?Type $phpDocType, ?string $deprecatedDescription, bool $isDeprecated, bool $isInternal, bool $isFinal) { $this->initializerExprTypeResolver = $initializerExprTypeResolver; $this->declaringClass = $declaringClass; $this->reflection = $reflection; $this->nativeType = $nativeType; $this->phpDocType = $phpDocType; $this->deprecatedDescription = $deprecatedDescription; $this->isDeprecated = $isDeprecated; $this->isInternal = $isInternal; $this->isFinal = $isFinal; } public function getName() : string { return $this->reflection->getName(); } public function getFileName() : ?string { return $this->declaringClass->getFileName(); } /** * @deprecated Use getValueExpr() * @return mixed */ public function getValue() { try { return $this->reflection->getValue(); } catch (UnableToCompileNode $e) { return NAN; } } public function getValueExpr() : Expr { return $this->reflection->getValueExpression(); } public function hasPhpDocType() : bool { return $this->phpDocType !== null; } public function getPhpDocType() : ?Type { return $this->phpDocType; } public function hasNativeType() : bool { return $this->nativeType !== null; } public function getNativeType() : ?Type { return $this->nativeType; } public function getValueType() : Type { if ($this->valueType === null) { if ($this->phpDocType !== null) { if ($this->nativeType !== null) { return $this->valueType = TypehintHelper::decideType($this->nativeType, $this->phpDocType); } return $this->phpDocType; } elseif ($this->nativeType !== null) { return $this->nativeType; } $this->valueType = $this->initializerExprTypeResolver->getType($this->getValueExpr(), \PHPStan\Reflection\InitializerExprContext::fromClassReflection($this->declaringClass)); } return $this->valueType; } public function getDeclaringClass() : \PHPStan\Reflection\ClassReflection { return $this->declaringClass; } public function isStatic() : bool { return \true; } public function isPrivate() : bool { return $this->reflection->isPrivate(); } public function isPublic() : bool { return $this->reflection->isPublic(); } public function isFinal() : bool { return $this->isFinal || $this->reflection->isFinal(); } public function isDeprecated() : TrinaryLogic { return TrinaryLogic::createFromBoolean($this->isDeprecated); } public function getDeprecatedDescription() : ?string { if ($this->isDeprecated) { return $this->deprecatedDescription; } return null; } public function isInternal() : TrinaryLogic { return TrinaryLogic::createFromBoolean($this->isInternal); } public function getDocComment() : ?string { $docComment = $this->reflection->getDocComment(); if ($docComment === \false) { return null; } return $docComment; } } <?php declare (strict_types=1); namespace PHPStan\Reflection; use Attribute; use PhpParser\Node\Arg; use PhpParser\Node\Expr\StaticCall; use PhpParser\Node\Identifier; use PhpParser\Node\Name\FullyQualified; use PHPStan\Analyser\ArgumentsNormalizer; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionClass; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionEnum; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionEnumBackedCase; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionMethod; use PHPStan\Php\PhpVersion; use PHPStan\PhpDoc\PhpDocInheritanceResolver; use PHPStan\PhpDoc\ResolvedPhpDocBlock; use PHPStan\PhpDoc\StubPhpDocProvider; use PHPStan\PhpDoc\Tag\ExtendsTag; use PHPStan\PhpDoc\Tag\ImplementsTag; use PHPStan\PhpDoc\Tag\MethodTag; use PHPStan\PhpDoc\Tag\MixinTag; use PHPStan\PhpDoc\Tag\PropertyTag; use PHPStan\PhpDoc\Tag\RequireExtendsTag; use PHPStan\PhpDoc\Tag\RequireImplementsTag; use PHPStan\PhpDoc\Tag\TemplateTag; use PHPStan\PhpDoc\Tag\TypeAliasImportTag; use PHPStan\PhpDoc\Tag\TypeAliasTag; use PHPStan\Reflection\Php\PhpClassReflectionExtension; use PHPStan\Reflection\Php\PhpPropertyReflection; use PHPStan\Reflection\Php\UniversalObjectCratesClassReflectionExtension; use PHPStan\Reflection\RequireExtension\RequireExtendsMethodsClassReflectionExtension; use PHPStan\Reflection\RequireExtension\RequireExtendsPropertiesClassReflectionExtension; use PHPStan\Reflection\SignatureMap\SignatureMapProvider; use PHPStan\ShouldNotHappenException; use PHPStan\Type\CircularTypeAliasDefinitionException; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\ErrorType; use PHPStan\Type\FileTypeMapper; use PHPStan\Type\Generic\GenericObjectType; use PHPStan\Type\Generic\TemplateTypeFactory; use PHPStan\Type\Generic\TemplateTypeHelper; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\Generic\TemplateTypeScope; use PHPStan\Type\Generic\TemplateTypeVariance; use PHPStan\Type\Generic\TemplateTypeVarianceMap; use PHPStan\Type\Generic\TypeProjectionHelper; use PHPStan\Type\ObjectType; use PHPStan\Type\Type; use PHPStan\Type\TypeAlias; use PHPStan\Type\TypehintHelper; use PHPStan\Type\VerbosityLevel; use ReflectionException; use function array_diff; use function array_filter; use function array_key_exists; use function array_map; use function array_merge; use function array_shift; use function array_unique; use function array_values; use function count; use function implode; use function in_array; use function is_bool; use function is_file; use function is_int; use function reset; use function sprintf; use function strtolower; /** * @api * @final */ class ClassReflection { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var InitializerExprTypeResolver */ private $initializerExprTypeResolver; /** * @var FileTypeMapper */ private $fileTypeMapper; /** * @var StubPhpDocProvider */ private $stubPhpDocProvider; /** * @var PhpDocInheritanceResolver */ private $phpDocInheritanceResolver; /** * @var PhpVersion */ private $phpVersion; /** * @var SignatureMapProvider */ private $signatureMapProvider; /** * @var PropertiesClassReflectionExtension[] */ private $propertiesClassReflectionExtensions; /** * @var MethodsClassReflectionExtension[] */ private $methodsClassReflectionExtensions; /** * @var AllowedSubTypesClassReflectionExtension[] */ private $allowedSubTypesClassReflectionExtensions; /** * @var RequireExtendsPropertiesClassReflectionExtension */ private $requireExtendsPropertiesClassReflectionExtension; /** * @var RequireExtendsMethodsClassReflectionExtension */ private $requireExtendsMethodsClassReflectionExtension; /** * @var string */ private $displayName; /** * @var ReflectionClass|ReflectionEnum */ private $reflection; /** * @var ?string */ private $anonymousFilename; /** * @var ?TemplateTypeMap */ private $resolvedTemplateTypeMap; /** * @var ?ResolvedPhpDocBlock */ private $stubPhpDocBlock; /** * @var string[] */ private $universalObjectCratesClasses; /** * @var ?string */ private $extraCacheKey; /** * @var ?TemplateTypeVarianceMap */ private $resolvedCallSiteVarianceMap; /** @var ExtendedMethodReflection[] */ private $methods = []; /** @var ExtendedPropertyReflection[] */ private $properties = []; /** @var ClassConstantReflection[] */ private $constants = []; /** @var EnumCaseReflection[]|null */ private $enumCases = null; /** @var int[]|null */ private $classHierarchyDistances = null; /** * @var ?string */ private $deprecatedDescription = null; /** * @var ?bool */ private $isDeprecated = null; /** * @var ?bool */ private $isGeneric = null; /** * @var ?bool */ private $isInternal = null; /** * @var ?bool */ private $isFinal = null; /** * @var ?bool */ private $isImmutable = null; /** * @var ?bool */ private $hasConsistentConstructor = null; /** * @var ?bool */ private $acceptsNamedArguments = null; /** * @var ?TemplateTypeMap */ private $templateTypeMap = null; /** * @var ?TemplateTypeMap */ private $activeTemplateTypeMap = null; /** * @var ?TemplateTypeVarianceMap */ private $defaultCallSiteVarianceMap = null; /** * @var ?TemplateTypeVarianceMap */ private $callSiteVarianceMap = null; /** @var array<string,ClassReflection>|null */ private $ancestors = null; /** * @var ?string */ private $cacheKey = null; /** @var array<string, bool> */ private $subclasses = []; /** * @var string|false|null */ private $filename = \false; /** * @var string|false|null */ private $reflectionDocComment = \false; /** * @var false|ResolvedPhpDocBlock */ private $resolvedPhpDocBlock = \false; /** * @var false|ResolvedPhpDocBlock */ private $traitContextResolvedPhpDocBlock = \false; /** @var ClassReflection[]|null */ private $cachedInterfaces = null; /** * @var ClassReflection|false|null */ private $cachedParentClass = \false; /** @var array<string, TypeAlias>|null */ private $typeAliases = null; /** @var array<string, true> */ private static $resolvingTypeAliasImports = []; /** @var array<string, bool> */ private $hasMethodCache = []; /** * @param PropertiesClassReflectionExtension[] $propertiesClassReflectionExtensions * @param MethodsClassReflectionExtension[] $methodsClassReflectionExtensions * @param AllowedSubTypesClassReflectionExtension[] $allowedSubTypesClassReflectionExtensions * @param string[] $universalObjectCratesClasses * @param ReflectionClass|ReflectionEnum $reflection */ public function __construct(\PHPStan\Reflection\ReflectionProvider $reflectionProvider, \PHPStan\Reflection\InitializerExprTypeResolver $initializerExprTypeResolver, FileTypeMapper $fileTypeMapper, StubPhpDocProvider $stubPhpDocProvider, PhpDocInheritanceResolver $phpDocInheritanceResolver, PhpVersion $phpVersion, SignatureMapProvider $signatureMapProvider, array $propertiesClassReflectionExtensions, array $methodsClassReflectionExtensions, array $allowedSubTypesClassReflectionExtensions, RequireExtendsPropertiesClassReflectionExtension $requireExtendsPropertiesClassReflectionExtension, RequireExtendsMethodsClassReflectionExtension $requireExtendsMethodsClassReflectionExtension, string $displayName, $reflection, ?string $anonymousFilename, ?TemplateTypeMap $resolvedTemplateTypeMap, ?ResolvedPhpDocBlock $stubPhpDocBlock, array $universalObjectCratesClasses, ?string $extraCacheKey = null, ?TemplateTypeVarianceMap $resolvedCallSiteVarianceMap = null) { $this->reflectionProvider = $reflectionProvider; $this->initializerExprTypeResolver = $initializerExprTypeResolver; $this->fileTypeMapper = $fileTypeMapper; $this->stubPhpDocProvider = $stubPhpDocProvider; $this->phpDocInheritanceResolver = $phpDocInheritanceResolver; $this->phpVersion = $phpVersion; $this->signatureMapProvider = $signatureMapProvider; $this->propertiesClassReflectionExtensions = $propertiesClassReflectionExtensions; $this->methodsClassReflectionExtensions = $methodsClassReflectionExtensions; $this->allowedSubTypesClassReflectionExtensions = $allowedSubTypesClassReflectionExtensions; $this->requireExtendsPropertiesClassReflectionExtension = $requireExtendsPropertiesClassReflectionExtension; $this->requireExtendsMethodsClassReflectionExtension = $requireExtendsMethodsClassReflectionExtension; $this->displayName = $displayName; $this->reflection = $reflection; $this->anonymousFilename = $anonymousFilename; $this->resolvedTemplateTypeMap = $resolvedTemplateTypeMap; $this->stubPhpDocBlock = $stubPhpDocBlock; $this->universalObjectCratesClasses = $universalObjectCratesClasses; $this->extraCacheKey = $extraCacheKey; $this->resolvedCallSiteVarianceMap = $resolvedCallSiteVarianceMap; } /** * @return ReflectionClass|ReflectionEnum */ public function getNativeReflection() { return $this->reflection; } public function getFileName() : ?string { if (!is_bool($this->filename)) { return $this->filename; } if ($this->anonymousFilename !== null) { return $this->filename = $this->anonymousFilename; } $fileName = $this->reflection->getFileName(); if ($fileName === \false) { return $this->filename = null; } if (!is_file($fileName)) { return $this->filename = null; } return $this->filename = $fileName; } /** * @deprecated Use getFileName() */ public function getFileNameWithPhpDocs() : ?string { return $this->getFileName(); } public function getParentClass() : ?\PHPStan\Reflection\ClassReflection { if (!is_bool($this->cachedParentClass)) { return $this->cachedParentClass; } $parentClass = $this->reflection->getParentClass(); if ($parentClass === \false) { return $this->cachedParentClass = null; } $extendsTag = $this->getFirstExtendsTag(); if ($extendsTag !== null && $this->isValidAncestorType($extendsTag->getType(), [$parentClass->getName()])) { $extendedType = $extendsTag->getType(); if ($this->isGeneric()) { $extendedType = TemplateTypeHelper::resolveTemplateTypes($extendedType, $this->getPossiblyIncompleteActiveTemplateTypeMap(), $this->getCallSiteVarianceMap(), TemplateTypeVariance::createStatic()); } if (!$extendedType instanceof GenericObjectType) { return $this->reflectionProvider->getClass($parentClass->getName()); } return $extendedType->getClassReflection() ?? $this->reflectionProvider->getClass($parentClass->getName()); } $parentReflection = $this->reflectionProvider->getClass($parentClass->getName()); if ($parentReflection->isGeneric()) { return $parentReflection->withTypes(array_values($parentReflection->getTemplateTypeMap()->map(static function () : Type { return new ErrorType(); })->getTypes())); } $this->cachedParentClass = $parentReflection; return $parentReflection; } /** * @return class-string */ public function getName() : string { return $this->reflection->getName(); } public function getDisplayName(bool $withTemplateTypes = \true) : string { if ($withTemplateTypes === \false || $this->resolvedTemplateTypeMap === null || count($this->resolvedTemplateTypeMap->getTypes()) === 0) { return $this->displayName; } $templateTypes = []; $variances = $this->getCallSiteVarianceMap()->getVariances(); foreach ($this->getActiveTemplateTypeMap()->getTypes() as $name => $templateType) { $variance = $variances[$name] ?? null; if ($variance === null) { continue; } $templateTypes[] = TypeProjectionHelper::describe($templateType, $variance, VerbosityLevel::typeOnly()); } return $this->displayName . '<' . implode(',', $templateTypes) . '>'; } public function getCacheKey() : string { $cacheKey = $this->cacheKey; if ($cacheKey !== null) { return $this->cacheKey; } $cacheKey = $this->displayName; if ($this->resolvedTemplateTypeMap !== null) { $templateTypes = []; $variances = $this->getCallSiteVarianceMap()->getVariances(); foreach ($this->getActiveTemplateTypeMap()->getTypes() as $name => $templateType) { $variance = $variances[$name] ?? null; if ($variance === null) { continue; } $templateTypes[] = TypeProjectionHelper::describe($templateType, $variance, VerbosityLevel::cache()); } $cacheKey .= '<' . implode(',', $templateTypes) . '>'; } if ($this->extraCacheKey !== null) { $cacheKey .= '-' . $this->extraCacheKey; } $this->cacheKey = $cacheKey; return $cacheKey; } /** * @return int[] */ public function getClassHierarchyDistances() : array { if ($this->classHierarchyDistances === null) { $distance = 0; $distances = [$this->getName() => $distance]; $currentClassReflection = $this->getNativeReflection(); foreach ($this->collectTraits($this->getNativeReflection()) as $trait) { $distance++; if (array_key_exists($trait->getName(), $distances)) { continue; } $distances[$trait->getName()] = $distance; } while ($currentClassReflection->getParentClass() !== \false) { $distance++; $parentClassName = $currentClassReflection->getParentClass()->getName(); if (!array_key_exists($parentClassName, $distances)) { $distances[$parentClassName] = $distance; } $currentClassReflection = $currentClassReflection->getParentClass(); foreach ($this->collectTraits($currentClassReflection) as $trait) { $distance++; if (array_key_exists($trait->getName(), $distances)) { continue; } $distances[$trait->getName()] = $distance; } } foreach ($this->getNativeReflection()->getInterfaces() as $interface) { $distance++; if (array_key_exists($interface->getName(), $distances)) { continue; } $distances[$interface->getName()] = $distance; } $this->classHierarchyDistances = $distances; } return $this->classHierarchyDistances; } /** * @return ReflectionClass[] * @param ReflectionClass|ReflectionEnum $class */ private function collectTraits($class) : array { $traits = []; $traitsLeftToAnalyze = $class->getTraits(); while (count($traitsLeftToAnalyze) !== 0) { $trait = reset($traitsLeftToAnalyze); $traits[] = $trait; foreach ($trait->getTraits() as $subTrait) { if (in_array($subTrait, $traits, \true)) { continue; } $traitsLeftToAnalyze[] = $subTrait; } array_shift($traitsLeftToAnalyze); } return $traits; } public function allowsDynamicProperties() : bool { if ($this->isEnum()) { return \false; } if (!$this->phpVersion->deprecatesDynamicProperties()) { return \true; } if ($this->isReadOnly()) { return \false; } if (UniversalObjectCratesClassReflectionExtension::isUniversalObjectCrate($this->reflectionProvider, $this->universalObjectCratesClasses, $this)) { return \true; } $class = $this; $attributes = $class->reflection->getAttributes('AllowDynamicProperties'); while (count($attributes) === 0 && $class->getParentClass() !== null) { $attributes = $class->getParentClass()->reflection->getAttributes('AllowDynamicProperties'); $class = $class->getParentClass(); } return count($attributes) > 0; } private function allowsDynamicPropertiesExtensions() : bool { if ($this->allowsDynamicProperties()) { return \true; } $hasMagicMethod = $this->hasNativeMethod('__get') || $this->hasNativeMethod('__set') || $this->hasNativeMethod('__isset'); if ($hasMagicMethod) { return \true; } foreach ($this->getRequireExtendsTags() as $extendsTag) { $type = $extendsTag->getType(); if (!$type instanceof ObjectType) { continue; } $reflection = $type->getClassReflection(); if ($reflection === null) { continue; } if (!$reflection->allowsDynamicPropertiesExtensions()) { continue; } return \true; } return \false; } public function hasProperty(string $propertyName) : bool { if ($this->isEnum()) { return $this->hasNativeProperty($propertyName); } foreach ($this->propertiesClassReflectionExtensions as $i => $extension) { if ($i > 0 && !$this->allowsDynamicPropertiesExtensions()) { break; } if ($extension->hasProperty($this, $propertyName)) { return \true; } } if ($this->requireExtendsPropertiesClassReflectionExtension->hasProperty($this, $propertyName)) { return \true; } return \false; } public function hasMethod(string $methodName) : bool { if (array_key_exists($methodName, $this->hasMethodCache)) { return $this->hasMethodCache[$methodName]; } foreach ($this->methodsClassReflectionExtensions as $extension) { if ($extension->hasMethod($this, $methodName)) { $this->hasMethodCache[$methodName] = \true; return \true; } } if ($this->requireExtendsMethodsClassReflectionExtension->hasMethod($this, $methodName)) { $this->hasMethodCache[$methodName] = \true; return \true; } $this->hasMethodCache[$methodName] = \false; return \false; } public function getMethod(string $methodName, \PHPStan\Reflection\ClassMemberAccessAnswerer $scope) : \PHPStan\Reflection\ExtendedMethodReflection { $key = $methodName; if ($scope->isInClass()) { $key = sprintf('%s-%s', $key, $scope->getClassReflection()->getCacheKey()); } if (!isset($this->methods[$key])) { foreach ($this->methodsClassReflectionExtensions as $extension) { if (!$extension->hasMethod($this, $methodName)) { continue; } $method = $this->wrapExtendedMethod($extension->getMethod($this, $methodName)); if ($scope->canCallMethod($method)) { return $this->methods[$key] = $method; } $this->methods[$key] = $method; } } if (!isset($this->methods[$key])) { if ($this->requireExtendsMethodsClassReflectionExtension->hasMethod($this, $methodName)) { $method = $this->requireExtendsMethodsClassReflectionExtension->getMethod($this, $methodName); $this->methods[$key] = $method; } } if (!isset($this->methods[$key])) { throw new \PHPStan\Reflection\MissingMethodFromReflectionException($this->getName(), $methodName); } return $this->methods[$key]; } private function wrapExtendedMethod(\PHPStan\Reflection\MethodReflection $method) : \PHPStan\Reflection\ExtendedMethodReflection { if ($method instanceof \PHPStan\Reflection\ExtendedMethodReflection) { return $method; } return new \PHPStan\Reflection\WrappedExtendedMethodReflection($method); } private function wrapExtendedProperty(\PHPStan\Reflection\PropertyReflection $method) : \PHPStan\Reflection\ExtendedPropertyReflection { if ($method instanceof \PHPStan\Reflection\ExtendedPropertyReflection) { return $method; } return new \PHPStan\Reflection\WrappedExtendedPropertyReflection($method); } public function hasNativeMethod(string $methodName) : bool { return $this->getPhpExtension()->hasNativeMethod($this, $methodName); } public function getNativeMethod(string $methodName) : \PHPStan\Reflection\ExtendedMethodReflection { if (!$this->hasNativeMethod($methodName)) { throw new \PHPStan\Reflection\MissingMethodFromReflectionException($this->getName(), $methodName); } return $this->getPhpExtension()->getNativeMethod($this, $methodName); } public function hasConstructor() : bool { return $this->findConstructor() !== null; } public function getConstructor() : \PHPStan\Reflection\ExtendedMethodReflection { $constructor = $this->findConstructor(); if ($constructor === null) { throw new ShouldNotHappenException(); } return $this->getNativeMethod($constructor->getName()); } private function findConstructor() : ?ReflectionMethod { $constructor = $this->reflection->getConstructor(); if ($constructor === null) { return null; } if ($this->phpVersion->supportsLegacyConstructor()) { return $constructor; } if (strtolower($constructor->getName()) !== '__construct') { return null; } return $constructor; } private function getPhpExtension() : PhpClassReflectionExtension { $extension = $this->methodsClassReflectionExtensions[0]; if (!$extension instanceof PhpClassReflectionExtension) { throw new ShouldNotHappenException(); } return $extension; } /** @internal */ public function evictPrivateSymbols() : void { foreach ($this->constants as $name => $constant) { if (!$constant->isPrivate()) { continue; } unset($this->constants[$name]); } foreach ($this->properties as $name => $property) { if (!$property->isPrivate()) { continue; } unset($this->properties[$name]); } foreach ($this->methods as $name => $method) { if (!$method->isPrivate()) { continue; } unset($this->methods[$name]); } $this->getPhpExtension()->evictPrivateSymbols($this->getCacheKey()); } public function getProperty(string $propertyName, \PHPStan\Reflection\ClassMemberAccessAnswerer $scope) : \PHPStan\Reflection\ExtendedPropertyReflection { if ($this->isEnum()) { return $this->getNativeProperty($propertyName); } $key = $propertyName; if ($scope->isInClass()) { $key = sprintf('%s-%s', $key, $scope->getClassReflection()->getCacheKey()); } if (!isset($this->properties[$key])) { foreach ($this->propertiesClassReflectionExtensions as $i => $extension) { if ($i > 0 && !$this->allowsDynamicPropertiesExtensions()) { break; } if (!$extension->hasProperty($this, $propertyName)) { continue; } $property = $this->wrapExtendedProperty($extension->getProperty($this, $propertyName)); if ($scope->canAccessProperty($property)) { return $this->properties[$key] = $property; } $this->properties[$key] = $property; } } if (!isset($this->properties[$key])) { if ($this->requireExtendsPropertiesClassReflectionExtension->hasProperty($this, $propertyName)) { $property = $this->requireExtendsPropertiesClassReflectionExtension->getProperty($this, $propertyName); $this->properties[$key] = $property; } } if (!isset($this->properties[$key])) { throw new \PHPStan\Reflection\MissingPropertyFromReflectionException($this->getName(), $propertyName); } return $this->properties[$key]; } public function hasNativeProperty(string $propertyName) : bool { return $this->getPhpExtension()->hasProperty($this, $propertyName); } public function getNativeProperty(string $propertyName) : PhpPropertyReflection { if (!$this->hasNativeProperty($propertyName)) { throw new \PHPStan\Reflection\MissingPropertyFromReflectionException($this->getName(), $propertyName); } return $this->getPhpExtension()->getNativeProperty($this, $propertyName); } public function isAbstract() : bool { return $this->reflection->isAbstract(); } public function isInterface() : bool { return $this->reflection->isInterface(); } public function isTrait() : bool { return $this->reflection->isTrait(); } /** * @phpstan-assert-if-true ReflectionEnum $this->reflection */ public function isEnum() : bool { return $this->reflection instanceof ReflectionEnum && $this->reflection->isEnum(); } /** * @return 'Interface'|'Trait'|'Enum'|'Class' */ public function getClassTypeDescription() : string { if ($this->isInterface()) { return 'Interface'; } elseif ($this->isTrait()) { return 'Trait'; } elseif ($this->isEnum()) { return 'Enum'; } return 'Class'; } public function isReadOnly() : bool { return $this->reflection->isReadOnly(); } public function isBackedEnum() : bool { if (!$this->reflection instanceof ReflectionEnum) { return \false; } return $this->reflection->isBacked(); } public function getBackedEnumType() : ?Type { if (!$this->reflection instanceof ReflectionEnum) { return null; } if (!$this->reflection->isBacked()) { return null; } return TypehintHelper::decideTypeFromReflection($this->reflection->getBackingType()); } public function hasEnumCase(string $name) : bool { if (!$this->isEnum()) { return \false; } return $this->reflection->hasCase($name); } /** * @return array<string, EnumCaseReflection> */ public function getEnumCases() : array { if (!$this->isEnum()) { throw new ShouldNotHappenException(); } if ($this->enumCases !== null) { return $this->enumCases; } $cases = []; $initializerExprContext = \PHPStan\Reflection\InitializerExprContext::fromClassReflection($this); foreach ($this->reflection->getCases() as $case) { $valueType = null; if ($case instanceof ReflectionEnumBackedCase) { $valueType = $this->initializerExprTypeResolver->getType($case->getValueExpression(), $initializerExprContext); } /** @var string $caseName */ $caseName = $case->getName(); $cases[$caseName] = new \PHPStan\Reflection\EnumCaseReflection($this, $caseName, $valueType); } return $this->enumCases = $cases; } public function getEnumCase(string $name) : \PHPStan\Reflection\EnumCaseReflection { if (!$this->hasEnumCase($name)) { throw new ShouldNotHappenException(sprintf('Enum case %s::%s does not exist.', $this->getDisplayName(), $name)); } if (!$this->reflection instanceof ReflectionEnum) { throw new ShouldNotHappenException(); } if ($this->enumCases !== null && array_key_exists($name, $this->enumCases)) { return $this->enumCases[$name]; } $case = $this->reflection->getCase($name); $valueType = null; if ($case instanceof ReflectionEnumBackedCase) { $valueType = $this->initializerExprTypeResolver->getType($case->getValueExpression(), \PHPStan\Reflection\InitializerExprContext::fromClassReflection($this)); } return new \PHPStan\Reflection\EnumCaseReflection($this, $name, $valueType); } public function isClass() : bool { return !$this->isInterface() && !$this->isTrait() && !$this->isEnum(); } public function isAnonymous() : bool { return $this->anonymousFilename !== null; } public function is(string $className) : bool { return $this->getName() === $className || $this->isSubclassOf($className); } public function isSubclassOf(string $className) : bool { if (isset($this->subclasses[$className])) { return $this->subclasses[$className]; } if (!$this->reflectionProvider->hasClass($className)) { return $this->subclasses[$className] = \false; } try { return $this->subclasses[$className] = $this->reflection->isSubclassOf($className); } catch (ReflectionException $e) { return $this->subclasses[$className] = \false; } } public function implementsInterface(string $className) : bool { try { return $this->reflection->implementsInterface($className); } catch (ReflectionException $e) { return \false; } } /** * @return ClassReflection[] */ public function getParents() : array { $parents = []; $parent = $this->getParentClass(); while ($parent !== null) { $parents[] = $parent; $parent = $parent->getParentClass(); } return $parents; } /** * @return ClassReflection[] */ public function getInterfaces() : array { if ($this->cachedInterfaces !== null) { return $this->cachedInterfaces; } $interfaces = $this->getImmediateInterfaces(); $immediateInterfaces = $interfaces; $parent = $this->getParentClass(); while ($parent !== null) { foreach ($parent->getImmediateInterfaces() as $parentInterface) { $interfaces[$parentInterface->getName()] = $parentInterface; foreach ($this->collectInterfaces($parentInterface) as $parentInterfaceInterface) { $interfaces[$parentInterfaceInterface->getName()] = $parentInterfaceInterface; } } $parent = $parent->getParentClass(); } foreach ($immediateInterfaces as $immediateInterface) { foreach ($this->collectInterfaces($immediateInterface) as $interfaceInterface) { $interfaces[$interfaceInterface->getName()] = $interfaceInterface; } } $this->cachedInterfaces = $interfaces; return $interfaces; } /** * @return ClassReflection[] */ private function collectInterfaces(\PHPStan\Reflection\ClassReflection $interface) : array { $interfaces = []; foreach ($interface->getImmediateInterfaces() as $immediateInterface) { $interfaces[$immediateInterface->getName()] = $immediateInterface; foreach ($this->collectInterfaces($immediateInterface) as $immediateInterfaceInterface) { $interfaces[$immediateInterfaceInterface->getName()] = $immediateInterfaceInterface; } } return $interfaces; } /** * @return ClassReflection[] */ public function getImmediateInterfaces() : array { $indirectInterfaceNames = []; $parent = $this->getParentClass(); while ($parent !== null) { foreach ($parent->getNativeReflection()->getInterfaceNames() as $parentInterfaceName) { $indirectInterfaceNames[] = $parentInterfaceName; } $parent = $parent->getParentClass(); } foreach ($this->getNativeReflection()->getInterfaces() as $interfaceInterface) { foreach ($interfaceInterface->getInterfaceNames() as $interfaceInterfaceName) { $indirectInterfaceNames[] = $interfaceInterfaceName; } } if ($this->reflection->isInterface()) { $implementsTags = $this->getExtendsTags(); } else { $implementsTags = $this->getImplementsTags(); } $immediateInterfaceNames = array_diff($this->getNativeReflection()->getInterfaceNames(), $indirectInterfaceNames); $immediateInterfaces = []; foreach ($immediateInterfaceNames as $immediateInterfaceName) { if (!$this->reflectionProvider->hasClass($immediateInterfaceName)) { continue; } $immediateInterface = $this->reflectionProvider->getClass($immediateInterfaceName); if (array_key_exists($immediateInterface->getName(), $implementsTags)) { $implementsTag = $implementsTags[$immediateInterface->getName()]; $implementedType = $implementsTag->getType(); if ($this->isGeneric()) { $implementedType = TemplateTypeHelper::resolveTemplateTypes($implementedType, $this->getPossiblyIncompleteActiveTemplateTypeMap(), $this->getCallSiteVarianceMap(), TemplateTypeVariance::createStatic(), \true); } if ($implementedType instanceof GenericObjectType && $implementedType->getClassReflection() !== null) { $immediateInterfaces[$immediateInterface->getName()] = $implementedType->getClassReflection(); continue; } } if ($immediateInterface->isGeneric()) { $immediateInterfaces[$immediateInterface->getName()] = $immediateInterface->withTypes(array_values($immediateInterface->getTemplateTypeMap()->map(static function () : Type { return new ErrorType(); })->getTypes())); continue; } $immediateInterfaces[$immediateInterface->getName()] = $immediateInterface; } return $immediateInterfaces; } /** * @return array<string, ClassReflection> */ public function getTraits(bool $recursive = \false) : array { $traits = []; if ($recursive) { foreach ($this->collectTraits($this->getNativeReflection()) as $trait) { $traits[$trait->getName()] = $trait; } } else { $traits = $this->getNativeReflection()->getTraits(); } $traits = array_map(function (ReflectionClass $trait) : \PHPStan\Reflection\ClassReflection { return $this->reflectionProvider->getClass($trait->getName()); }, $traits); if ($recursive) { $parentClass = $this->getNativeReflection()->getParentClass(); if ($parentClass !== \false) { return array_merge($traits, $this->reflectionProvider->getClass($parentClass->getName())->getTraits(\true)); } } return $traits; } /** * @return list<class-string> */ public function getParentClassesNames() : array { $parentNames = []; $parentClass = $this->getParentClass(); while ($parentClass !== null) { $parentNames[] = $parentClass->getName(); $parentClass = $parentClass->getParentClass(); } return $parentNames; } public function hasConstant(string $name) : bool { if (!$this->getNativeReflection()->hasConstant($name)) { return \false; } $reflectionConstant = $this->getNativeReflection()->getReflectionConstant($name); if ($reflectionConstant === \false) { return \false; } return $this->reflectionProvider->hasClass($reflectionConstant->getDeclaringClass()->getName()); } public function getConstant(string $name) : \PHPStan\Reflection\ClassConstantReflection { if (!isset($this->constants[$name])) { $reflectionConstant = $this->getNativeReflection()->getReflectionConstant($name); if ($reflectionConstant === \false) { throw new \PHPStan\Reflection\MissingConstantFromReflectionException($this->getName(), $name); } $declaringClass = $this->reflectionProvider->getClass($reflectionConstant->getDeclaringClass()->getName()); $fileName = $declaringClass->getFileName(); $phpDocType = null; $resolvedPhpDoc = $this->stubPhpDocProvider->findClassConstantPhpDoc($declaringClass->getName(), $name); if ($resolvedPhpDoc === null) { $docComment = null; if ($reflectionConstant->getDocComment() !== \false) { $docComment = $reflectionConstant->getDocComment(); } $resolvedPhpDoc = $this->phpDocInheritanceResolver->resolvePhpDocForConstant($docComment, $declaringClass, $fileName, $name); } $deprecatedDescription = $resolvedPhpDoc->getDeprecatedTag() !== null ? $resolvedPhpDoc->getDeprecatedTag()->getMessage() : null; $isDeprecated = $resolvedPhpDoc->isDeprecated(); $isInternal = $resolvedPhpDoc->isInternal(); $isFinal = $resolvedPhpDoc->isFinal(); $varTags = $resolvedPhpDoc->getVarTags(); if (isset($varTags[0]) && count($varTags) === 1) { $phpDocType = $varTags[0]->getType(); } $nativeType = null; if ($reflectionConstant->getType() !== null) { $nativeType = TypehintHelper::decideTypeFromReflection($reflectionConstant->getType(), null, $declaringClass); } elseif ($this->signatureMapProvider->hasClassConstantMetadata($declaringClass->getName(), $name)) { $nativeType = $this->signatureMapProvider->getClassConstantMetadata($declaringClass->getName(), $name)['nativeType']; } $this->constants[$name] = new \PHPStan\Reflection\ClassConstantReflection($this->initializerExprTypeResolver, $declaringClass, $reflectionConstant, $nativeType, $phpDocType, $deprecatedDescription, $isDeprecated, $isInternal, $isFinal); } return $this->constants[$name]; } public function hasTraitUse(string $traitName) : bool { return in_array($traitName, $this->getTraitNames(), \true); } /** * @return string[] */ private function getTraitNames() : array { $class = $this->reflection; $traitNames = array_map(static function (ReflectionClass $class) { return $class->getName(); }, $this->collectTraits($class)); while ($class->getParentClass() !== \false) { $traitNames = array_values(array_unique(array_merge($traitNames, $class->getParentClass()->getTraitNames()))); $class = $class->getParentClass(); } return $traitNames; } /** * @return array<string, TypeAlias> */ public function getTypeAliases() : array { if ($this->typeAliases === null) { $resolvedPhpDoc = $this->getResolvedPhpDoc(); if ($resolvedPhpDoc === null) { return $this->typeAliases = []; } $typeAliasImportTags = $resolvedPhpDoc->getTypeAliasImportTags(); $typeAliasTags = $resolvedPhpDoc->getTypeAliasTags(); // prevent circular imports if (array_key_exists($this->getName(), self::$resolvingTypeAliasImports)) { throw new CircularTypeAliasDefinitionException(); } self::$resolvingTypeAliasImports[$this->getName()] = \true; $importedAliases = array_map(function (TypeAliasImportTag $typeAliasImportTag) : ?TypeAlias { $importedAlias = $typeAliasImportTag->getImportedAlias(); $importedFromClassName = $typeAliasImportTag->getImportedFrom(); if (!$this->reflectionProvider->hasClass($importedFromClassName)) { return null; } $importedFromReflection = $this->reflectionProvider->getClass($importedFromClassName); try { $typeAliases = $importedFromReflection->getTypeAliases(); } catch (CircularTypeAliasDefinitionException $e) { return TypeAlias::invalid(); } if (!array_key_exists($importedAlias, $typeAliases)) { return null; } return $typeAliases[$importedAlias]; }, $typeAliasImportTags); unset(self::$resolvingTypeAliasImports[$this->getName()]); $localAliases = array_map(static function (TypeAliasTag $typeAliasTag) : TypeAlias { return $typeAliasTag->getTypeAlias(); }, $typeAliasTags); $this->typeAliases = array_filter(array_merge($importedAliases, $localAliases), static function (?TypeAlias $typeAlias) : bool { return $typeAlias !== null; }); } return $this->typeAliases; } public function getDeprecatedDescription() : ?string { if ($this->deprecatedDescription === null && $this->isDeprecated()) { $resolvedPhpDoc = $this->getResolvedPhpDoc(); if ($resolvedPhpDoc !== null && $resolvedPhpDoc->getDeprecatedTag() !== null) { $this->deprecatedDescription = $resolvedPhpDoc->getDeprecatedTag()->getMessage(); } } return $this->deprecatedDescription; } public function isDeprecated() : bool { if ($this->isDeprecated === null) { $resolvedPhpDoc = $this->getResolvedPhpDoc(); $this->isDeprecated = $resolvedPhpDoc !== null && $resolvedPhpDoc->isDeprecated(); } return $this->isDeprecated; } public function isBuiltin() : bool { return $this->reflection->isInternal(); } public function isInternal() : bool { if ($this->isInternal === null) { $resolvedPhpDoc = $this->getResolvedPhpDoc(); $this->isInternal = $resolvedPhpDoc !== null && $resolvedPhpDoc->isInternal(); } return $this->isInternal; } public function isFinal() : bool { if ($this->isFinalByKeyword()) { return \true; } if ($this->isFinal === null) { $resolvedPhpDoc = $this->getResolvedPhpDoc(); $this->isFinal = $resolvedPhpDoc !== null && $resolvedPhpDoc->isFinal(); } return $this->isFinal; } public function isImmutable() : bool { if ($this->isImmutable === null) { $resolvedPhpDoc = $this->getResolvedPhpDoc(); $this->isImmutable = $resolvedPhpDoc !== null && ($resolvedPhpDoc->isImmutable() || $resolvedPhpDoc->isReadOnly()); $parentClass = $this->getParentClass(); if ($parentClass !== null && !$this->isImmutable) { $this->isImmutable = $parentClass->isImmutable(); } } return $this->isImmutable; } public function hasConsistentConstructor() : bool { if ($this->hasConsistentConstructor === null) { $resolvedPhpDoc = $this->getResolvedPhpDoc(); $this->hasConsistentConstructor = $resolvedPhpDoc !== null && $resolvedPhpDoc->hasConsistentConstructor(); } return $this->hasConsistentConstructor; } public function acceptsNamedArguments() : bool { if ($this->acceptsNamedArguments === null) { $resolvedPhpDoc = $this->getResolvedPhpDoc(); $this->acceptsNamedArguments = $resolvedPhpDoc === null || $resolvedPhpDoc->acceptsNamedArguments(); } return $this->acceptsNamedArguments; } public function isFinalByKeyword() : bool { if ($this->isAnonymous()) { return \true; } return $this->reflection->isFinal(); } public function isAttributeClass() : bool { return $this->findAttributeFlags() !== null; } private function findAttributeFlags() : ?int { if ($this->isInterface() || $this->isTrait() || $this->isEnum()) { return null; } $nativeAttributes = $this->reflection->getAttributes(Attribute::class); if (count($nativeAttributes) === 1) { if (!$this->reflectionProvider->hasClass(Attribute::class)) { return null; } $attributeClass = $this->reflectionProvider->getClass(Attribute::class); $arguments = []; foreach ($nativeAttributes[0]->getArgumentsExpressions() as $i => $expression) { $arguments[] = new Arg($expression, \false, \false, [], is_int($i) ? null : new Identifier($i)); } if (!$attributeClass->hasConstructor()) { return null; } $attributeConstructor = $attributeClass->getConstructor(); $attributeConstructorVariant = $attributeConstructor->getOnlyVariant(); if (count($arguments) === 0) { $flagType = $attributeConstructorVariant->getParameters()[0]->getDefaultValue(); } else { $staticCall = ArgumentsNormalizer::reorderStaticCallArguments($attributeConstructorVariant, new StaticCall(new FullyQualified(Attribute::class), $attributeConstructor->getName(), $arguments)); if ($staticCall === null) { return null; } $flagExpr = $staticCall->getArgs()[0]->value; $flagType = $this->initializerExprTypeResolver->getType($flagExpr, \PHPStan\Reflection\InitializerExprContext::fromClassReflection($this)); } if (!$flagType instanceof ConstantIntegerType) { return null; } return $flagType->getValue(); } return null; } public function getAttributeClassFlags() : int { $flags = $this->findAttributeFlags(); if ($flags === null) { throw new ShouldNotHappenException(); } return $flags; } public function getTemplateTypeMap() : TemplateTypeMap { if ($this->templateTypeMap !== null) { return $this->templateTypeMap; } $resolvedPhpDoc = $this->getResolvedPhpDoc(); if ($resolvedPhpDoc === null) { $this->templateTypeMap = TemplateTypeMap::createEmpty(); return $this->templateTypeMap; } $templateTypeScope = TemplateTypeScope::createWithClass($this->getName()); $templateTypeMap = new TemplateTypeMap(array_map(static function (TemplateTag $tag) use($templateTypeScope) : Type { return TemplateTypeFactory::fromTemplateTag($templateTypeScope, $tag); }, $this->getTemplateTags())); $this->templateTypeMap = $templateTypeMap; return $templateTypeMap; } public function getActiveTemplateTypeMap() : TemplateTypeMap { if ($this->activeTemplateTypeMap !== null) { return $this->activeTemplateTypeMap; } $resolved = $this->resolvedTemplateTypeMap; if ($resolved !== null) { $templateTypeMap = $this->getTemplateTypeMap(); return $this->activeTemplateTypeMap = $resolved->map(static function (string $name, Type $type) use($templateTypeMap) : Type { if ($type instanceof ErrorType) { $templateType = $templateTypeMap->getType($name); if ($templateType !== null) { return TemplateTypeHelper::resolveToDefaults($templateType); } } return $type; }); } return $this->activeTemplateTypeMap = $this->getTemplateTypeMap(); } public function getPossiblyIncompleteActiveTemplateTypeMap() : TemplateTypeMap { return $this->resolvedTemplateTypeMap ?? $this->getTemplateTypeMap(); } private function getDefaultCallSiteVarianceMap() : TemplateTypeVarianceMap { if ($this->defaultCallSiteVarianceMap !== null) { return $this->defaultCallSiteVarianceMap; } $resolvedPhpDoc = $this->getResolvedPhpDoc(); if ($resolvedPhpDoc === null) { $this->defaultCallSiteVarianceMap = TemplateTypeVarianceMap::createEmpty(); return $this->defaultCallSiteVarianceMap; } $map = []; foreach ($this->getTemplateTags() as $templateTag) { $map[$templateTag->getName()] = TemplateTypeVariance::createInvariant(); } $this->defaultCallSiteVarianceMap = new TemplateTypeVarianceMap($map); return $this->defaultCallSiteVarianceMap; } public function getCallSiteVarianceMap() : TemplateTypeVarianceMap { return $this->callSiteVarianceMap = $this->callSiteVarianceMap ?? $this->resolvedCallSiteVarianceMap ?? $this->getDefaultCallSiteVarianceMap(); } public function isGeneric() : bool { if ($this->isGeneric === null) { if ($this->isEnum()) { return $this->isGeneric = \false; } $this->isGeneric = count($this->getTemplateTags()) > 0; } return $this->isGeneric; } /** * @param array<int, Type> $types */ public function typeMapFromList(array $types) : TemplateTypeMap { $resolvedPhpDoc = $this->getResolvedPhpDoc(); if ($resolvedPhpDoc === null) { return TemplateTypeMap::createEmpty(); } $map = []; $i = 0; foreach ($resolvedPhpDoc->getTemplateTags() as $tag) { $map[$tag->getName()] = $types[$i] ?? $tag->getDefault() ?? $tag->getBound(); $i++; } return new TemplateTypeMap($map); } /** * @param array<int, TemplateTypeVariance> $variances */ public function varianceMapFromList(array $variances) : TemplateTypeVarianceMap { $resolvedPhpDoc = $this->getResolvedPhpDoc(); if ($resolvedPhpDoc === null) { return new TemplateTypeVarianceMap([]); } $map = []; $i = 0; foreach ($resolvedPhpDoc->getTemplateTags() as $tag) { $map[$tag->getName()] = $variances[$i] ?? TemplateTypeVariance::createInvariant(); $i++; } return new TemplateTypeVarianceMap($map); } /** @return array<int, Type> */ public function typeMapToList(TemplateTypeMap $typeMap) : array { $resolvedPhpDoc = $this->getResolvedPhpDoc(); if ($resolvedPhpDoc === null) { return []; } $list = []; foreach ($resolvedPhpDoc->getTemplateTags() as $tag) { $list[] = $typeMap->getType($tag->getName()) ?? $tag->getDefault() ?? $tag->getBound(); } return $list; } /** @return array<int, TemplateTypeVariance> */ public function varianceMapToList(TemplateTypeVarianceMap $varianceMap) : array { $resolvedPhpDoc = $this->getResolvedPhpDoc(); if ($resolvedPhpDoc === null) { return []; } $list = []; foreach ($resolvedPhpDoc->getTemplateTags() as $tag) { $list[] = $varianceMap->getVariance($tag->getName()) ?? TemplateTypeVariance::createInvariant(); } return $list; } /** * @param array<int, Type> $types */ public function withTypes(array $types) : self { return new self($this->reflectionProvider, $this->initializerExprTypeResolver, $this->fileTypeMapper, $this->stubPhpDocProvider, $this->phpDocInheritanceResolver, $this->phpVersion, $this->signatureMapProvider, $this->propertiesClassReflectionExtensions, $this->methodsClassReflectionExtensions, $this->allowedSubTypesClassReflectionExtensions, $this->requireExtendsPropertiesClassReflectionExtension, $this->requireExtendsMethodsClassReflectionExtension, $this->displayName, $this->reflection, $this->anonymousFilename, $this->typeMapFromList($types), $this->stubPhpDocBlock, $this->universalObjectCratesClasses, null, $this->resolvedCallSiteVarianceMap); } /** * @param array<int, TemplateTypeVariance> $variances */ public function withVariances(array $variances) : self { return new self($this->reflectionProvider, $this->initializerExprTypeResolver, $this->fileTypeMapper, $this->stubPhpDocProvider, $this->phpDocInheritanceResolver, $this->phpVersion, $this->signatureMapProvider, $this->propertiesClassReflectionExtensions, $this->methodsClassReflectionExtensions, $this->allowedSubTypesClassReflectionExtensions, $this->requireExtendsPropertiesClassReflectionExtension, $this->requireExtendsMethodsClassReflectionExtension, $this->displayName, $this->reflection, $this->anonymousFilename, $this->resolvedTemplateTypeMap, $this->stubPhpDocBlock, $this->universalObjectCratesClasses, null, $this->varianceMapFromList($variances)); } public function getResolvedPhpDoc() : ?ResolvedPhpDocBlock { if ($this->stubPhpDocBlock !== null) { return $this->stubPhpDocBlock; } $fileName = $this->getFileName(); if (is_bool($this->reflectionDocComment)) { $docComment = $this->reflection->getDocComment(); $this->reflectionDocComment = $docComment !== \false ? $docComment : null; } if ($this->reflectionDocComment === null) { return null; } if ($this->resolvedPhpDocBlock !== \false) { return $this->resolvedPhpDocBlock; } return $this->resolvedPhpDocBlock = $this->fileTypeMapper->getResolvedPhpDoc($fileName, $this->getName(), null, null, $this->reflectionDocComment); } public function getTraitContextResolvedPhpDoc(self $implementingClass) : ?ResolvedPhpDocBlock { if (!$this->isTrait()) { throw new ShouldNotHappenException(); } if ($implementingClass->isTrait()) { throw new ShouldNotHappenException(); } $fileName = $this->getFileName(); if (is_bool($this->reflectionDocComment)) { $docComment = $this->reflection->getDocComment(); $this->reflectionDocComment = $docComment !== \false ? $docComment : null; } if ($this->reflectionDocComment === null) { return null; } if ($this->traitContextResolvedPhpDocBlock !== \false) { return $this->traitContextResolvedPhpDocBlock; } return $this->traitContextResolvedPhpDocBlock = $this->fileTypeMapper->getResolvedPhpDoc($fileName, $implementingClass->getName(), $this->getName(), null, $this->reflectionDocComment); } private function getFirstExtendsTag() : ?ExtendsTag { foreach ($this->getExtendsTags() as $tag) { return $tag; } return null; } /** @return array<string, ExtendsTag> */ public function getExtendsTags() : array { $resolvedPhpDoc = $this->getResolvedPhpDoc(); if ($resolvedPhpDoc === null) { return []; } return $resolvedPhpDoc->getExtendsTags(); } /** @return array<string, ImplementsTag> */ public function getImplementsTags() : array { $resolvedPhpDoc = $this->getResolvedPhpDoc(); if ($resolvedPhpDoc === null) { return []; } return $resolvedPhpDoc->getImplementsTags(); } /** @return array<string,TemplateTag> */ public function getTemplateTags() : array { $resolvedPhpDoc = $this->getResolvedPhpDoc(); if ($resolvedPhpDoc === null) { return []; } return $resolvedPhpDoc->getTemplateTags(); } /** * @return array<string,ClassReflection> */ public function getAncestors() : array { $ancestors = $this->ancestors; if ($ancestors === null) { $ancestors = [$this->getName() => $this]; $addToAncestors = static function (string $name, \PHPStan\Reflection\ClassReflection $classReflection) use(&$ancestors) : void { if (array_key_exists($name, $ancestors)) { return; } $ancestors[$name] = $classReflection; }; foreach ($this->getInterfaces() as $interface) { $addToAncestors($interface->getName(), $interface); foreach ($interface->getAncestors() as $name => $ancestor) { $addToAncestors($name, $ancestor); } } foreach ($this->getTraits() as $trait) { $addToAncestors($trait->getName(), $trait); foreach ($trait->getAncestors() as $name => $ancestor) { $addToAncestors($name, $ancestor); } } $parent = $this->getParentClass(); if ($parent !== null) { $addToAncestors($parent->getName(), $parent); foreach ($parent->getAncestors() as $name => $ancestor) { $addToAncestors($name, $ancestor); } } $this->ancestors = $ancestors; } return $ancestors; } public function getAncestorWithClassName(string $className) : ?self { return $this->getAncestors()[$className] ?? null; } /** * @param string[] $ancestorClasses */ private function isValidAncestorType(Type $type, array $ancestorClasses) : bool { if (!$type instanceof GenericObjectType) { return \false; } $reflection = $type->getClassReflection(); if ($reflection === null) { return \false; } return in_array($reflection->getName(), $ancestorClasses, \true); } /** * @return array<MixinTag> */ public function getMixinTags() : array { $resolvedPhpDoc = $this->getResolvedPhpDoc(); if ($resolvedPhpDoc === null) { return []; } return $resolvedPhpDoc->getMixinTags(); } /** * @return array<RequireExtendsTag> */ public function getRequireExtendsTags() : array { $resolvedPhpDoc = $this->getResolvedPhpDoc(); if ($resolvedPhpDoc === null) { return []; } return $resolvedPhpDoc->getRequireExtendsTags(); } /** * @return array<RequireImplementsTag> */ public function getRequireImplementsTags() : array { $resolvedPhpDoc = $this->getResolvedPhpDoc(); if ($resolvedPhpDoc === null) { return []; } return $resolvedPhpDoc->getRequireImplementsTags(); } /** * @return array<string, PropertyTag> */ public function getPropertyTags() : array { $resolvedPhpDoc = $this->getResolvedPhpDoc(); if ($resolvedPhpDoc === null) { return []; } return $resolvedPhpDoc->getPropertyTags(); } /** * @return array<string, MethodTag> */ public function getMethodTags() : array { $resolvedPhpDoc = $this->getResolvedPhpDoc(); if ($resolvedPhpDoc === null) { return []; } return $resolvedPhpDoc->getMethodTags(); } /** * @return array<Type> */ public function getResolvedMixinTypes() : array { $types = []; foreach ($this->getMixinTags() as $mixinTag) { if (!$this->isGeneric()) { $types[] = $mixinTag->getType(); continue; } $types[] = TemplateTypeHelper::resolveTemplateTypes($mixinTag->getType(), $this->getActiveTemplateTypeMap(), $this->getCallSiteVarianceMap(), TemplateTypeVariance::createStatic()); } return $types; } /** * @return array<Type>|null */ public function getAllowedSubTypes() : ?array { foreach ($this->allowedSubTypesClassReflectionExtensions as $allowedSubTypesClassReflectionExtension) { if ($allowedSubTypesClassReflectionExtension->supports($this)) { return $allowedSubTypesClassReflectionExtension->getAllowedSubTypes($this); } } return null; } } <?php declare (strict_types=1); namespace PHPStan\Reflection; interface WrapperPropertyReflection extends \PHPStan\Reflection\ExtendedPropertyReflection { public function getOriginalReflection() : \PHPStan\Reflection\ExtendedPropertyReflection; } <?php declare (strict_types=1); namespace PHPStan\Reflection; /** * The purpose of this interface is to be able to * answer more questions about properties * without breaking backward compatibility * with existing PropertiesClassReflectionExtension. * * Developers are meant to only implement PropertyReflection * and its methods in their code. * * New methods on ExtendedPropertyReflection will be added * in minor versions. * * @api */ interface ExtendedPropertyReflection extends \PHPStan\Reflection\PropertyReflection { } <?php declare (strict_types=1); namespace PHPStan\Reflection\Type; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Type\Type; interface UnresolvedMethodPrototypeReflection { public function doNotResolveTemplateTypeMapToBounds() : self; public function getNakedMethod() : ExtendedMethodReflection; public function getTransformedMethod() : ExtendedMethodReflection; public function withCalledOnType(Type $type) : self; } <?php declare (strict_types=1); namespace PHPStan\Reflection\Type; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\MethodReflection; use PHPStan\Type\Type; use function array_map; final class UnionTypeUnresolvedMethodPrototypeReflection implements \PHPStan\Reflection\Type\UnresolvedMethodPrototypeReflection { /** * @var string */ private $methodName; /** * @var UnresolvedMethodPrototypeReflection[] */ private $methodPrototypes; /** * @var ?ExtendedMethodReflection */ private $transformedMethod = null; /** * @var ?self */ private $cachedDoNotResolveTemplateTypeMapToBounds = null; /** * @param UnresolvedMethodPrototypeReflection[] $methodPrototypes */ public function __construct(string $methodName, array $methodPrototypes) { $this->methodName = $methodName; $this->methodPrototypes = $methodPrototypes; } public function doNotResolveTemplateTypeMapToBounds() : \PHPStan\Reflection\Type\UnresolvedMethodPrototypeReflection { if ($this->cachedDoNotResolveTemplateTypeMapToBounds !== null) { return $this->cachedDoNotResolveTemplateTypeMapToBounds; } return $this->cachedDoNotResolveTemplateTypeMapToBounds = new self($this->methodName, array_map(static function (\PHPStan\Reflection\Type\UnresolvedMethodPrototypeReflection $prototype) : \PHPStan\Reflection\Type\UnresolvedMethodPrototypeReflection { return $prototype->doNotResolveTemplateTypeMapToBounds(); }, $this->methodPrototypes)); } public function getNakedMethod() : ExtendedMethodReflection { return $this->getTransformedMethod(); } public function getTransformedMethod() : ExtendedMethodReflection { if ($this->transformedMethod !== null) { return $this->transformedMethod; } $methods = array_map(static function (\PHPStan\Reflection\Type\UnresolvedMethodPrototypeReflection $prototype) : MethodReflection { return $prototype->getTransformedMethod(); }, $this->methodPrototypes); return $this->transformedMethod = new \PHPStan\Reflection\Type\UnionTypeMethodReflection($this->methodName, $methods); } public function withCalledOnType(Type $type) : \PHPStan\Reflection\Type\UnresolvedMethodPrototypeReflection { return new self($this->methodName, array_map(static function (\PHPStan\Reflection\Type\UnresolvedMethodPrototypeReflection $prototype) use($type) : \PHPStan\Reflection\Type\UnresolvedMethodPrototypeReflection { return $prototype->withCalledOnType($type); }, $this->methodPrototypes)); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Type; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ExtendedPropertyReflection; use PHPStan\Reflection\PropertyReflection; use PHPStan\TrinaryLogic; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function array_map; use function count; use function implode; final class IntersectionTypePropertyReflection implements ExtendedPropertyReflection { /** * @var PropertyReflection[] */ private $properties; /** * @param PropertyReflection[] $properties */ public function __construct(array $properties) { $this->properties = $properties; } public function getDeclaringClass() : ClassReflection { return $this->properties[0]->getDeclaringClass(); } public function isStatic() : bool { return $this->computeResult(static function (PropertyReflection $property) { return $property->isStatic(); }); } public function isPrivate() : bool { return $this->computeResult(static function (PropertyReflection $property) { return $property->isPrivate(); }); } public function isPublic() : bool { return $this->computeResult(static function (PropertyReflection $property) { return $property->isPublic(); }); } public function isDeprecated() : TrinaryLogic { return TrinaryLogic::lazyMaxMin($this->properties, static function (PropertyReflection $propertyReflection) : TrinaryLogic { return $propertyReflection->isDeprecated(); }); } public function getDeprecatedDescription() : ?string { $descriptions = []; foreach ($this->properties as $property) { if (!$property->isDeprecated()->yes()) { continue; } $description = $property->getDeprecatedDescription(); if ($description === null) { continue; } $descriptions[] = $description; } if (count($descriptions) === 0) { return null; } return implode(' ', $descriptions); } public function isInternal() : TrinaryLogic { return TrinaryLogic::lazyMaxMin($this->properties, static function (PropertyReflection $propertyReflection) : TrinaryLogic { return $propertyReflection->isInternal(); }); } public function getDocComment() : ?string { return null; } public function getReadableType() : Type { return TypeCombinator::intersect(...array_map(static function (PropertyReflection $property) : Type { return $property->getReadableType(); }, $this->properties)); } public function getWritableType() : Type { return TypeCombinator::intersect(...array_map(static function (PropertyReflection $property) : Type { return $property->getWritableType(); }, $this->properties)); } public function canChangeTypeAfterAssignment() : bool { return $this->computeResult(static function (PropertyReflection $property) { return $property->canChangeTypeAfterAssignment(); }); } public function isReadable() : bool { return $this->computeResult(static function (PropertyReflection $property) { return $property->isReadable(); }); } public function isWritable() : bool { return $this->computeResult(static function (PropertyReflection $property) { return $property->isWritable(); }); } /** * @param callable(PropertyReflection): bool $cb */ private function computeResult(callable $cb) : bool { $result = \false; foreach ($this->properties as $property) { $result = $result || $cb($property); } return $result; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Type; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\Dummy\ChangedTypeMethodReflection; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\FunctionVariantWithPhpDocs; use PHPStan\Reflection\ParameterReflectionWithPhpDocs; use PHPStan\Reflection\ParametersAcceptorWithPhpDocs; use PHPStan\Reflection\Php\DummyParameterWithPhpDocs; use PHPStan\Reflection\ResolvedMethodReflection; use PHPStan\Type\Generic\GenericStaticType; use PHPStan\Type\StaticType; use PHPStan\Type\Type; use PHPStan\Type\TypeTraverser; use function array_map; use function count; final class CalledOnTypeUnresolvedMethodPrototypeReflection implements \PHPStan\Reflection\Type\UnresolvedMethodPrototypeReflection { /** * @var ExtendedMethodReflection */ private $methodReflection; /** * @var ClassReflection */ private $resolvedDeclaringClass; /** * @var bool */ private $resolveTemplateTypeMapToBounds; /** * @var Type */ private $calledOnType; /** * @var ?ExtendedMethodReflection */ private $transformedMethod = null; /** * @var ?self */ private $cachedDoNotResolveTemplateTypeMapToBounds = null; public function __construct(ExtendedMethodReflection $methodReflection, ClassReflection $resolvedDeclaringClass, bool $resolveTemplateTypeMapToBounds, Type $calledOnType) { $this->methodReflection = $methodReflection; $this->resolvedDeclaringClass = $resolvedDeclaringClass; $this->resolveTemplateTypeMapToBounds = $resolveTemplateTypeMapToBounds; $this->calledOnType = $calledOnType; } public function doNotResolveTemplateTypeMapToBounds() : \PHPStan\Reflection\Type\UnresolvedMethodPrototypeReflection { if ($this->cachedDoNotResolveTemplateTypeMapToBounds !== null) { return $this->cachedDoNotResolveTemplateTypeMapToBounds; } return $this->cachedDoNotResolveTemplateTypeMapToBounds = new self($this->methodReflection, $this->resolvedDeclaringClass, \false, $this->calledOnType); } public function getNakedMethod() : ExtendedMethodReflection { return $this->methodReflection; } public function getTransformedMethod() : ExtendedMethodReflection { if ($this->transformedMethod !== null) { return $this->transformedMethod; } $templateTypeMap = $this->resolvedDeclaringClass->getActiveTemplateTypeMap(); $callSiteVarianceMap = $this->resolvedDeclaringClass->getCallSiteVarianceMap(); return $this->transformedMethod = new ResolvedMethodReflection($this->transformMethodWithStaticType($this->resolvedDeclaringClass, $this->methodReflection), $this->resolveTemplateTypeMapToBounds ? $templateTypeMap->resolveToBounds() : $templateTypeMap, $callSiteVarianceMap); } public function withCalledOnType(Type $type) : \PHPStan\Reflection\Type\UnresolvedMethodPrototypeReflection { return new self($this->methodReflection, $this->resolvedDeclaringClass, $this->resolveTemplateTypeMapToBounds, $type); } private function transformMethodWithStaticType(ClassReflection $declaringClass, ExtendedMethodReflection $method) : ExtendedMethodReflection { $variantFn = function (ParametersAcceptorWithPhpDocs $acceptor) : ParametersAcceptorWithPhpDocs { return new FunctionVariantWithPhpDocs($acceptor->getTemplateTypeMap(), $acceptor->getResolvedTemplateTypeMap(), array_map(function (ParameterReflectionWithPhpDocs $parameter) : ParameterReflectionWithPhpDocs { return new DummyParameterWithPhpDocs($parameter->getName(), $this->transformStaticType($parameter->getType()), $parameter->isOptional(), $parameter->passedByReference(), $parameter->isVariadic(), $parameter->getDefaultValue(), $parameter->getNativeType(), $this->transformStaticType($parameter->getPhpDocType()), $parameter->getOutType() !== null ? $this->transformStaticType($parameter->getOutType()) : null, $parameter->isImmediatelyInvokedCallable(), $parameter->getClosureThisType() !== null ? $this->transformStaticType($parameter->getClosureThisType()) : null); }, $acceptor->getParameters()), $acceptor->isVariadic(), $this->transformStaticType($acceptor->getReturnType()), $this->transformStaticType($acceptor->getPhpDocReturnType()), $this->transformStaticType($acceptor->getNativeReturnType()), $acceptor->getCallSiteVarianceMap()); }; $variants = array_map($variantFn, $method->getVariants()); $namedArgumentsVariants = $method->getNamedArgumentsVariants(); $namedArgumentsVariants = $namedArgumentsVariants !== null ? array_map($variantFn, $namedArgumentsVariants) : null; return new ChangedTypeMethodReflection($declaringClass, $method, $variants, $namedArgumentsVariants); } private function transformStaticType(Type $type) : Type { return TypeTraverser::map($type, function (Type $type, callable $traverse) : Type { if ($type instanceof GenericStaticType) { $calledOnTypeReflections = $this->calledOnType->getObjectClassReflections(); if (count($calledOnTypeReflections) === 1) { $calledOnTypeReflection = $calledOnTypeReflections[0]; return $traverse($type->changeBaseClass($calledOnTypeReflection)->getStaticObjectType()); } return $this->calledOnType; } if ($type instanceof StaticType) { return $this->calledOnType; } return $traverse($type); }); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Type; use PHPStan\Reflection\ExtendedPropertyReflection; use PHPStan\Reflection\PropertyReflection; use PHPStan\Type\Type; use function array_map; final class IntersectionTypeUnresolvedPropertyPrototypeReflection implements \PHPStan\Reflection\Type\UnresolvedPropertyPrototypeReflection { /** * @var string */ private $propertyName; /** * @var UnresolvedPropertyPrototypeReflection[] */ private $propertyPrototypes; /** * @var ?ExtendedPropertyReflection */ private $transformedProperty = null; /** * @var ?self */ private $cachedDoNotResolveTemplateTypeMapToBounds = null; /** * @param UnresolvedPropertyPrototypeReflection[] $propertyPrototypes */ public function __construct(string $propertyName, array $propertyPrototypes) { $this->propertyName = $propertyName; $this->propertyPrototypes = $propertyPrototypes; } public function doNotResolveTemplateTypeMapToBounds() : \PHPStan\Reflection\Type\UnresolvedPropertyPrototypeReflection { if ($this->cachedDoNotResolveTemplateTypeMapToBounds !== null) { return $this->cachedDoNotResolveTemplateTypeMapToBounds; } return $this->cachedDoNotResolveTemplateTypeMapToBounds = new self($this->propertyName, array_map(static function (\PHPStan\Reflection\Type\UnresolvedPropertyPrototypeReflection $prototype) : \PHPStan\Reflection\Type\UnresolvedPropertyPrototypeReflection { return $prototype->doNotResolveTemplateTypeMapToBounds(); }, $this->propertyPrototypes)); } public function getNakedProperty() : ExtendedPropertyReflection { return $this->getTransformedProperty(); } public function getTransformedProperty() : ExtendedPropertyReflection { if ($this->transformedProperty !== null) { return $this->transformedProperty; } $properties = array_map(static function (\PHPStan\Reflection\Type\UnresolvedPropertyPrototypeReflection $prototype) : PropertyReflection { return $prototype->getTransformedProperty(); }, $this->propertyPrototypes); return $this->transformedProperty = new \PHPStan\Reflection\Type\IntersectionTypePropertyReflection($properties); } public function withFechedOnType(Type $type) : \PHPStan\Reflection\Type\UnresolvedPropertyPrototypeReflection { return new self($this->propertyName, array_map(static function (\PHPStan\Reflection\Type\UnresolvedPropertyPrototypeReflection $prototype) use($type) : \PHPStan\Reflection\Type\UnresolvedPropertyPrototypeReflection { return $prototype->withFechedOnType($type); }, $this->propertyPrototypes)); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Type; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ExtendedPropertyReflection; use PHPStan\Reflection\PropertyReflection; use PHPStan\TrinaryLogic; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function array_map; use function count; use function implode; final class UnionTypePropertyReflection implements ExtendedPropertyReflection { /** * @var PropertyReflection[] */ private $properties; /** * @param PropertyReflection[] $properties */ public function __construct(array $properties) { $this->properties = $properties; } public function getDeclaringClass() : ClassReflection { return $this->properties[0]->getDeclaringClass(); } public function isStatic() : bool { return $this->computeResult(static function (PropertyReflection $property) { return $property->isStatic(); }); } public function isPrivate() : bool { return $this->computeResult(static function (PropertyReflection $property) { return $property->isPrivate(); }); } public function isPublic() : bool { return $this->computeResult(static function (PropertyReflection $property) { return $property->isPublic(); }); } public function isDeprecated() : TrinaryLogic { return TrinaryLogic::lazyExtremeIdentity($this->properties, static function (PropertyReflection $propertyReflection) : TrinaryLogic { return $propertyReflection->isDeprecated(); }); } public function getDeprecatedDescription() : ?string { $descriptions = []; foreach ($this->properties as $property) { if (!$property->isDeprecated()->yes()) { continue; } $description = $property->getDeprecatedDescription(); if ($description === null) { continue; } $descriptions[] = $description; } if (count($descriptions) === 0) { return null; } return implode(' ', $descriptions); } public function isInternal() : TrinaryLogic { return TrinaryLogic::lazyExtremeIdentity($this->properties, static function (PropertyReflection $propertyReflection) : TrinaryLogic { return $propertyReflection->isInternal(); }); } public function getDocComment() : ?string { return null; } public function getReadableType() : Type { return TypeCombinator::union(...array_map(static function (PropertyReflection $property) : Type { return $property->getReadableType(); }, $this->properties)); } public function getWritableType() : Type { return TypeCombinator::union(...array_map(static function (PropertyReflection $property) : Type { return $property->getWritableType(); }, $this->properties)); } public function canChangeTypeAfterAssignment() : bool { return $this->computeResult(static function (PropertyReflection $property) { return $property->canChangeTypeAfterAssignment(); }); } public function isReadable() : bool { return $this->computeResult(static function (PropertyReflection $property) { return $property->isReadable(); }); } public function isWritable() : bool { return $this->computeResult(static function (PropertyReflection $property) { return $property->isWritable(); }); } /** * @param callable(PropertyReflection): bool $cb */ private function computeResult(callable $cb) : bool { $result = \true; foreach ($this->properties as $property) { $result = $result && $cb($property); } return $result; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Type; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\MethodReflection; use PHPStan\Type\Type; use function array_map; final class IntersectionTypeUnresolvedMethodPrototypeReflection implements \PHPStan\Reflection\Type\UnresolvedMethodPrototypeReflection { /** * @var string */ private $methodName; /** * @var UnresolvedMethodPrototypeReflection[] */ private $methodPrototypes; /** * @var ?ExtendedMethodReflection */ private $transformedMethod = null; /** * @var ?self */ private $cachedDoNotResolveTemplateTypeMapToBounds = null; /** * @param UnresolvedMethodPrototypeReflection[] $methodPrototypes */ public function __construct(string $methodName, array $methodPrototypes) { $this->methodName = $methodName; $this->methodPrototypes = $methodPrototypes; } public function doNotResolveTemplateTypeMapToBounds() : \PHPStan\Reflection\Type\UnresolvedMethodPrototypeReflection { if ($this->cachedDoNotResolveTemplateTypeMapToBounds !== null) { return $this->cachedDoNotResolveTemplateTypeMapToBounds; } return $this->cachedDoNotResolveTemplateTypeMapToBounds = new self($this->methodName, array_map(static function (\PHPStan\Reflection\Type\UnresolvedMethodPrototypeReflection $prototype) : \PHPStan\Reflection\Type\UnresolvedMethodPrototypeReflection { return $prototype->doNotResolveTemplateTypeMapToBounds(); }, $this->methodPrototypes)); } public function getNakedMethod() : ExtendedMethodReflection { return $this->getTransformedMethod(); } public function getTransformedMethod() : ExtendedMethodReflection { if ($this->transformedMethod !== null) { return $this->transformedMethod; } $methods = array_map(static function (\PHPStan\Reflection\Type\UnresolvedMethodPrototypeReflection $prototype) : MethodReflection { return $prototype->getTransformedMethod(); }, $this->methodPrototypes); return $this->transformedMethod = new \PHPStan\Reflection\Type\IntersectionTypeMethodReflection($this->methodName, $methods); } public function withCalledOnType(Type $type) : \PHPStan\Reflection\Type\UnresolvedMethodPrototypeReflection { return new self($this->methodName, array_map(static function (\PHPStan\Reflection\Type\UnresolvedMethodPrototypeReflection $prototype) use($type) : \PHPStan\Reflection\Type\UnresolvedMethodPrototypeReflection { return $prototype->withCalledOnType($type); }, $this->methodPrototypes)); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Type; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\Dummy\ChangedTypePropertyReflection; use PHPStan\Reflection\ExtendedPropertyReflection; use PHPStan\Reflection\ResolvedPropertyReflection; use PHPStan\Type\Type; final class CallbackUnresolvedPropertyPrototypeReflection implements \PHPStan\Reflection\Type\UnresolvedPropertyPrototypeReflection { /** * @var ExtendedPropertyReflection */ private $propertyReflection; /** * @var ClassReflection */ private $resolvedDeclaringClass; /** * @var bool */ private $resolveTemplateTypeMapToBounds; /** @var callable(Type): Type */ private $transformStaticTypeCallback; /** * @var ?ExtendedPropertyReflection */ private $transformedProperty = null; /** * @var ?self */ private $cachedDoNotResolveTemplateTypeMapToBounds = null; /** * @param callable(Type): Type $transformStaticTypeCallback */ public function __construct(ExtendedPropertyReflection $propertyReflection, ClassReflection $resolvedDeclaringClass, bool $resolveTemplateTypeMapToBounds, callable $transformStaticTypeCallback) { $this->propertyReflection = $propertyReflection; $this->resolvedDeclaringClass = $resolvedDeclaringClass; $this->resolveTemplateTypeMapToBounds = $resolveTemplateTypeMapToBounds; $this->transformStaticTypeCallback = $transformStaticTypeCallback; } public function doNotResolveTemplateTypeMapToBounds() : \PHPStan\Reflection\Type\UnresolvedPropertyPrototypeReflection { if ($this->cachedDoNotResolveTemplateTypeMapToBounds !== null) { return $this->cachedDoNotResolveTemplateTypeMapToBounds; } return $this->cachedDoNotResolveTemplateTypeMapToBounds = new self($this->propertyReflection, $this->resolvedDeclaringClass, \false, $this->transformStaticTypeCallback); } public function getNakedProperty() : ExtendedPropertyReflection { return $this->propertyReflection; } public function getTransformedProperty() : ExtendedPropertyReflection { if ($this->transformedProperty !== null) { return $this->transformedProperty; } $templateTypeMap = $this->resolvedDeclaringClass->getActiveTemplateTypeMap(); $callSiteVarianceMap = $this->resolvedDeclaringClass->getCallSiteVarianceMap(); return $this->transformedProperty = new ResolvedPropertyReflection($this->transformPropertyWithStaticType($this->resolvedDeclaringClass, $this->propertyReflection), $this->resolveTemplateTypeMapToBounds ? $templateTypeMap->resolveToBounds() : $templateTypeMap, $callSiteVarianceMap); } public function withFechedOnType(Type $type) : \PHPStan\Reflection\Type\UnresolvedPropertyPrototypeReflection { return new \PHPStan\Reflection\Type\CalledOnTypeUnresolvedPropertyPrototypeReflection($this->propertyReflection, $this->resolvedDeclaringClass, $this->resolveTemplateTypeMapToBounds, $type); } private function transformPropertyWithStaticType(ClassReflection $declaringClass, ExtendedPropertyReflection $property) : ExtendedPropertyReflection { $readableType = $this->transformStaticType($property->getReadableType()); $writableType = $this->transformStaticType($property->getWritableType()); return new ChangedTypePropertyReflection($declaringClass, $property, $readableType, $writableType); } private function transformStaticType(Type $type) : Type { $callback = $this->transformStaticTypeCallback; return $callback($type); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Type; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\Dummy\ChangedTypeMethodReflection; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\FunctionVariantWithPhpDocs; use PHPStan\Reflection\ParameterReflectionWithPhpDocs; use PHPStan\Reflection\ParametersAcceptorWithPhpDocs; use PHPStan\Reflection\Php\DummyParameterWithPhpDocs; use PHPStan\Reflection\ResolvedMethodReflection; use PHPStan\Type\Type; use function array_map; final class CallbackUnresolvedMethodPrototypeReflection implements \PHPStan\Reflection\Type\UnresolvedMethodPrototypeReflection { /** * @var ExtendedMethodReflection */ private $methodReflection; /** * @var ClassReflection */ private $resolvedDeclaringClass; /** * @var bool */ private $resolveTemplateTypeMapToBounds; /** @var callable(Type): Type */ private $transformStaticTypeCallback; /** * @var ?ExtendedMethodReflection */ private $transformedMethod = null; /** * @var ?self */ private $cachedDoNotResolveTemplateTypeMapToBounds = null; /** * @param callable(Type): Type $transformStaticTypeCallback */ public function __construct(ExtendedMethodReflection $methodReflection, ClassReflection $resolvedDeclaringClass, bool $resolveTemplateTypeMapToBounds, callable $transformStaticTypeCallback) { $this->methodReflection = $methodReflection; $this->resolvedDeclaringClass = $resolvedDeclaringClass; $this->resolveTemplateTypeMapToBounds = $resolveTemplateTypeMapToBounds; $this->transformStaticTypeCallback = $transformStaticTypeCallback; } public function doNotResolveTemplateTypeMapToBounds() : \PHPStan\Reflection\Type\UnresolvedMethodPrototypeReflection { if ($this->cachedDoNotResolveTemplateTypeMapToBounds !== null) { return $this->cachedDoNotResolveTemplateTypeMapToBounds; } return $this->cachedDoNotResolveTemplateTypeMapToBounds = new self($this->methodReflection, $this->resolvedDeclaringClass, \false, $this->transformStaticTypeCallback); } public function getNakedMethod() : ExtendedMethodReflection { return $this->methodReflection; } public function getTransformedMethod() : ExtendedMethodReflection { if ($this->transformedMethod !== null) { return $this->transformedMethod; } $templateTypeMap = $this->resolvedDeclaringClass->getActiveTemplateTypeMap(); $callSiteVarianceMap = $this->resolvedDeclaringClass->getCallSiteVarianceMap(); return $this->transformedMethod = new ResolvedMethodReflection($this->transformMethodWithStaticType($this->resolvedDeclaringClass, $this->methodReflection), $this->resolveTemplateTypeMapToBounds ? $templateTypeMap->resolveToBounds() : $templateTypeMap, $callSiteVarianceMap); } public function withCalledOnType(Type $type) : \PHPStan\Reflection\Type\UnresolvedMethodPrototypeReflection { return new \PHPStan\Reflection\Type\CalledOnTypeUnresolvedMethodPrototypeReflection($this->methodReflection, $this->resolvedDeclaringClass, $this->resolveTemplateTypeMapToBounds, $type); } private function transformMethodWithStaticType(ClassReflection $declaringClass, ExtendedMethodReflection $method) : ExtendedMethodReflection { $variantFn = function (ParametersAcceptorWithPhpDocs $acceptor) : ParametersAcceptorWithPhpDocs { return new FunctionVariantWithPhpDocs($acceptor->getTemplateTypeMap(), $acceptor->getResolvedTemplateTypeMap(), array_map(function (ParameterReflectionWithPhpDocs $parameter) : ParameterReflectionWithPhpDocs { return new DummyParameterWithPhpDocs($parameter->getName(), $this->transformStaticType($parameter->getType()), $parameter->isOptional(), $parameter->passedByReference(), $parameter->isVariadic(), $parameter->getDefaultValue(), $parameter->getNativeType(), $this->transformStaticType($parameter->getPhpDocType()), $parameter->getOutType() !== null ? $this->transformStaticType($parameter->getOutType()) : null, $parameter->isImmediatelyInvokedCallable(), $parameter->getClosureThisType() !== null ? $this->transformStaticType($parameter->getClosureThisType()) : null); }, $acceptor->getParameters()), $acceptor->isVariadic(), $this->transformStaticType($acceptor->getReturnType()), $this->transformStaticType($acceptor->getPhpDocReturnType()), $this->transformStaticType($acceptor->getNativeReturnType()), $acceptor->getCallSiteVarianceMap()); }; $variants = array_map($variantFn, $method->getVariants()); $namedArgumentVariants = $method->getNamedArgumentsVariants(); $namedArgumentVariants = $namedArgumentVariants !== null ? array_map($variantFn, $namedArgumentVariants) : null; return new ChangedTypeMethodReflection($declaringClass, $method, $variants, $namedArgumentVariants); } private function transformStaticType(Type $type) : Type { $callback = $this->transformStaticTypeCallback; return $callback($type); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Type; use PHPStan\Reflection\ExtendedPropertyReflection; use PHPStan\Reflection\PropertyReflection; use PHPStan\Type\Type; use function array_map; final class UnionTypeUnresolvedPropertyPrototypeReflection implements \PHPStan\Reflection\Type\UnresolvedPropertyPrototypeReflection { /** * @var string */ private $propertyName; /** * @var UnresolvedPropertyPrototypeReflection[] */ private $propertyPrototypes; /** * @var ?ExtendedPropertyReflection */ private $transformedProperty = null; /** * @var ?self */ private $cachedDoNotResolveTemplateTypeMapToBounds = null; /** * @param UnresolvedPropertyPrototypeReflection[] $propertyPrototypes */ public function __construct(string $propertyName, array $propertyPrototypes) { $this->propertyName = $propertyName; $this->propertyPrototypes = $propertyPrototypes; } public function doNotResolveTemplateTypeMapToBounds() : \PHPStan\Reflection\Type\UnresolvedPropertyPrototypeReflection { if ($this->cachedDoNotResolveTemplateTypeMapToBounds !== null) { return $this->cachedDoNotResolveTemplateTypeMapToBounds; } return $this->cachedDoNotResolveTemplateTypeMapToBounds = new self($this->propertyName, array_map(static function (\PHPStan\Reflection\Type\UnresolvedPropertyPrototypeReflection $prototype) : \PHPStan\Reflection\Type\UnresolvedPropertyPrototypeReflection { return $prototype->doNotResolveTemplateTypeMapToBounds(); }, $this->propertyPrototypes)); } public function getNakedProperty() : ExtendedPropertyReflection { return $this->getTransformedProperty(); } public function getTransformedProperty() : ExtendedPropertyReflection { if ($this->transformedProperty !== null) { return $this->transformedProperty; } $methods = array_map(static function (\PHPStan\Reflection\Type\UnresolvedPropertyPrototypeReflection $prototype) : PropertyReflection { return $prototype->getTransformedProperty(); }, $this->propertyPrototypes); return $this->transformedProperty = new \PHPStan\Reflection\Type\UnionTypePropertyReflection($methods); } public function withFechedOnType(Type $type) : \PHPStan\Reflection\Type\UnresolvedPropertyPrototypeReflection { return new self($this->propertyName, array_map(static function (\PHPStan\Reflection\Type\UnresolvedPropertyPrototypeReflection $prototype) use($type) : \PHPStan\Reflection\Type\UnresolvedPropertyPrototypeReflection { return $prototype->withFechedOnType($type); }, $this->propertyPrototypes)); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Type; use PHPStan\Reflection\ExtendedPropertyReflection; use PHPStan\Type\Type; interface UnresolvedPropertyPrototypeReflection { public function doNotResolveTemplateTypeMapToBounds() : self; public function getNakedProperty() : ExtendedPropertyReflection; public function getTransformedProperty() : ExtendedPropertyReflection; public function withFechedOnType(Type $type) : self; } <?php declare (strict_types=1); namespace PHPStan\Reflection\Type; use PHPStan\Reflection\Assertions; use PHPStan\Reflection\ClassMemberReflection; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\MethodReflection; use PHPStan\Reflection\ParametersAcceptorSelector; use PHPStan\Reflection\ParametersAcceptorWithPhpDocs; use PHPStan\TrinaryLogic; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function array_map; use function array_merge; use function count; use function implode; use function is_bool; final class UnionTypeMethodReflection implements ExtendedMethodReflection { /** * @var string */ private $methodName; /** * @var ExtendedMethodReflection[] */ private $methods; /** * @param ExtendedMethodReflection[] $methods */ public function __construct(string $methodName, array $methods) { $this->methodName = $methodName; $this->methods = $methods; } public function getDeclaringClass() : ClassReflection { return $this->methods[0]->getDeclaringClass(); } public function isStatic() : bool { foreach ($this->methods as $method) { if (!$method->isStatic()) { return \false; } } return \true; } public function isPrivate() : bool { foreach ($this->methods as $method) { if ($method->isPrivate()) { return \true; } } return \false; } public function isPublic() : bool { foreach ($this->methods as $method) { if (!$method->isPublic()) { return \false; } } return \true; } public function getName() : string { return $this->methodName; } public function getPrototype() : ClassMemberReflection { return $this; } public function getVariants() : array { $variants = array_merge(...array_map(static function (MethodReflection $method) { return $method->getVariants(); }, $this->methods)); return [ParametersAcceptorSelector::combineAcceptors($variants)]; } public function getOnlyVariant() : ParametersAcceptorWithPhpDocs { return $this->getVariants()[0]; } public function getNamedArgumentsVariants() : ?array { return null; } public function isDeprecated() : TrinaryLogic { return TrinaryLogic::lazyExtremeIdentity($this->methods, static function (MethodReflection $method) : TrinaryLogic { return $method->isDeprecated(); }); } public function getDeprecatedDescription() : ?string { $descriptions = []; foreach ($this->methods as $method) { if (!$method->isDeprecated()->yes()) { continue; } $description = $method->getDeprecatedDescription(); if ($description === null) { continue; } $descriptions[] = $description; } if (count($descriptions) === 0) { return null; } return implode(' ', $descriptions); } public function isFinal() : TrinaryLogic { return TrinaryLogic::lazyExtremeIdentity($this->methods, static function (MethodReflection $method) : TrinaryLogic { return $method->isFinal(); }); } public function isFinalByKeyword() : TrinaryLogic { return TrinaryLogic::lazyExtremeIdentity($this->methods, static function (ExtendedMethodReflection $method) : TrinaryLogic { return $method->isFinalByKeyword(); }); } public function isInternal() : TrinaryLogic { return TrinaryLogic::lazyExtremeIdentity($this->methods, static function (MethodReflection $method) : TrinaryLogic { return $method->isInternal(); }); } public function getThrowType() : ?Type { $types = []; foreach ($this->methods as $method) { $type = $method->getThrowType(); if ($type === null) { continue; } $types[] = $type; } if (count($types) === 0) { return null; } return TypeCombinator::union(...$types); } public function hasSideEffects() : TrinaryLogic { return TrinaryLogic::lazyExtremeIdentity($this->methods, static function (MethodReflection $method) : TrinaryLogic { return $method->hasSideEffects(); }); } public function isPure() : TrinaryLogic { return TrinaryLogic::lazyExtremeIdentity($this->methods, static function (ExtendedMethodReflection $method) : TrinaryLogic { return $method->isPure(); }); } public function getDocComment() : ?string { return null; } public function getAsserts() : Assertions { return Assertions::createEmpty(); } public function acceptsNamedArguments() : bool { $accepts = \true; foreach ($this->methods as $method) { $accepts = $accepts && $method->acceptsNamedArguments(); } return $accepts; } public function getSelfOutType() : ?Type { return null; } public function returnsByReference() : TrinaryLogic { return TrinaryLogic::lazyExtremeIdentity($this->methods, static function (ExtendedMethodReflection $method) : TrinaryLogic { return $method->returnsByReference(); }); } public function isAbstract() : TrinaryLogic { return TrinaryLogic::lazyExtremeIdentity($this->methods, static function (ExtendedMethodReflection $method) : TrinaryLogic { return is_bool($method->isAbstract()) ? TrinaryLogic::createFromBoolean($method->isAbstract()) : $method->isAbstract(); }); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Type; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\Dummy\ChangedTypePropertyReflection; use PHPStan\Reflection\ExtendedPropertyReflection; use PHPStan\Reflection\ResolvedPropertyReflection; use PHPStan\Type\StaticType; use PHPStan\Type\Type; use PHPStan\Type\TypeTraverser; final class CalledOnTypeUnresolvedPropertyPrototypeReflection implements \PHPStan\Reflection\Type\UnresolvedPropertyPrototypeReflection { /** * @var ExtendedPropertyReflection */ private $propertyReflection; /** * @var ClassReflection */ private $resolvedDeclaringClass; /** * @var bool */ private $resolveTemplateTypeMapToBounds; /** * @var Type */ private $fetchedOnType; /** * @var ?ExtendedPropertyReflection */ private $transformedProperty = null; /** * @var ?self */ private $cachedDoNotResolveTemplateTypeMapToBounds = null; public function __construct(ExtendedPropertyReflection $propertyReflection, ClassReflection $resolvedDeclaringClass, bool $resolveTemplateTypeMapToBounds, Type $fetchedOnType) { $this->propertyReflection = $propertyReflection; $this->resolvedDeclaringClass = $resolvedDeclaringClass; $this->resolveTemplateTypeMapToBounds = $resolveTemplateTypeMapToBounds; $this->fetchedOnType = $fetchedOnType; } public function doNotResolveTemplateTypeMapToBounds() : \PHPStan\Reflection\Type\UnresolvedPropertyPrototypeReflection { if ($this->cachedDoNotResolveTemplateTypeMapToBounds !== null) { return $this->cachedDoNotResolveTemplateTypeMapToBounds; } return $this->cachedDoNotResolveTemplateTypeMapToBounds = new self($this->propertyReflection, $this->resolvedDeclaringClass, \false, $this->fetchedOnType); } public function getNakedProperty() : ExtendedPropertyReflection { return $this->propertyReflection; } public function getTransformedProperty() : ExtendedPropertyReflection { if ($this->transformedProperty !== null) { return $this->transformedProperty; } $templateTypeMap = $this->resolvedDeclaringClass->getActiveTemplateTypeMap(); $callSiteVarianceMap = $this->resolvedDeclaringClass->getCallSiteVarianceMap(); return $this->transformedProperty = new ResolvedPropertyReflection($this->transformPropertyWithStaticType($this->resolvedDeclaringClass, $this->propertyReflection), $this->resolveTemplateTypeMapToBounds ? $templateTypeMap->resolveToBounds() : $templateTypeMap, $callSiteVarianceMap); } public function withFechedOnType(Type $type) : \PHPStan\Reflection\Type\UnresolvedPropertyPrototypeReflection { return new self($this->propertyReflection, $this->resolvedDeclaringClass, $this->resolveTemplateTypeMapToBounds, $type); } private function transformPropertyWithStaticType(ClassReflection $declaringClass, ExtendedPropertyReflection $property) : ExtendedPropertyReflection { $readableType = $this->transformStaticType($property->getReadableType()); $writableType = $this->transformStaticType($property->getWritableType()); return new ChangedTypePropertyReflection($declaringClass, $property, $readableType, $writableType); } private function transformStaticType(Type $type) : Type { return TypeTraverser::map($type, function (Type $type, callable $traverse) : Type { if ($type instanceof StaticType) { return $this->fetchedOnType; } return $traverse($type); }); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Type; use PHPStan\Reflection\Assertions; use PHPStan\Reflection\ClassMemberReflection; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\FunctionVariantWithPhpDocs; use PHPStan\Reflection\MethodReflection; use PHPStan\Reflection\ParametersAcceptor; use PHPStan\Reflection\ParametersAcceptorWithPhpDocs; use PHPStan\ShouldNotHappenException; use PHPStan\TrinaryLogic; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function array_map; use function count; use function implode; use function is_bool; final class IntersectionTypeMethodReflection implements ExtendedMethodReflection { /** * @var string */ private $methodName; /** * @var ExtendedMethodReflection[] */ private $methods; /** * @param ExtendedMethodReflection[] $methods */ public function __construct(string $methodName, array $methods) { $this->methodName = $methodName; $this->methods = $methods; } public function getDeclaringClass() : ClassReflection { return $this->methods[0]->getDeclaringClass(); } public function isStatic() : bool { foreach ($this->methods as $method) { if ($method->isStatic()) { return \true; } } return \false; } public function isPrivate() : bool { foreach ($this->methods as $method) { if (!$method->isPrivate()) { return \false; } } return \true; } public function isPublic() : bool { foreach ($this->methods as $method) { if ($method->isPublic()) { return \true; } } return \false; } public function getName() : string { return $this->methodName; } public function getPrototype() : ClassMemberReflection { return $this; } public function getVariants() : array { $returnType = TypeCombinator::intersect(...array_map(static function (MethodReflection $method) : Type { return TypeCombinator::intersect(...array_map(static function (ParametersAcceptor $acceptor) : Type { return $acceptor->getReturnType(); }, $method->getVariants())); }, $this->methods)); $phpDocReturnType = TypeCombinator::intersect(...array_map(static function (MethodReflection $method) : Type { return TypeCombinator::intersect(...array_map(static function (ParametersAcceptor $acceptor) : Type { return $acceptor->getPhpDocReturnType(); }, $method->getVariants())); }, $this->methods)); $nativeReturnType = TypeCombinator::intersect(...array_map(static function (MethodReflection $method) : Type { return TypeCombinator::intersect(...array_map(static function (ParametersAcceptor $acceptor) : Type { return $acceptor->getNativeReturnType(); }, $method->getVariants())); }, $this->methods)); return array_map(static function (ParametersAcceptorWithPhpDocs $acceptor) use($returnType, $phpDocReturnType, $nativeReturnType) : ParametersAcceptorWithPhpDocs { return new FunctionVariantWithPhpDocs($acceptor->getTemplateTypeMap(), $acceptor->getResolvedTemplateTypeMap(), $acceptor->getParameters(), $acceptor->isVariadic(), $returnType, $phpDocReturnType, $nativeReturnType, $acceptor->getCallSiteVarianceMap()); }, $this->methods[0]->getVariants()); } public function getOnlyVariant() : ParametersAcceptorWithPhpDocs { $variants = $this->getVariants(); if (count($variants) !== 1) { throw new ShouldNotHappenException(); } return $variants[0]; } public function getNamedArgumentsVariants() : ?array { return null; } public function isDeprecated() : TrinaryLogic { return TrinaryLogic::lazyMaxMin($this->methods, static function (MethodReflection $method) : TrinaryLogic { return $method->isDeprecated(); }); } public function getDeprecatedDescription() : ?string { $descriptions = []; foreach ($this->methods as $method) { if (!$method->isDeprecated()->yes()) { continue; } $description = $method->getDeprecatedDescription(); if ($description === null) { continue; } $descriptions[] = $description; } if (count($descriptions) === 0) { return null; } return implode(' ', $descriptions); } public function isFinal() : TrinaryLogic { return TrinaryLogic::lazyMaxMin($this->methods, static function (MethodReflection $method) : TrinaryLogic { return $method->isFinal(); }); } public function isFinalByKeyword() : TrinaryLogic { return TrinaryLogic::lazyMaxMin($this->methods, static function (ExtendedMethodReflection $method) : TrinaryLogic { return $method->isFinalByKeyword(); }); } public function isInternal() : TrinaryLogic { return TrinaryLogic::lazyMaxMin($this->methods, static function (MethodReflection $method) : TrinaryLogic { return $method->isInternal(); }); } public function getThrowType() : ?Type { $types = []; foreach ($this->methods as $method) { $type = $method->getThrowType(); if ($type === null) { continue; } $types[] = $type; } if (count($types) === 0) { return null; } return TypeCombinator::intersect(...$types); } public function hasSideEffects() : TrinaryLogic { return TrinaryLogic::lazyMaxMin($this->methods, static function (MethodReflection $method) : TrinaryLogic { return $method->hasSideEffects(); }); } public function isPure() : TrinaryLogic { return TrinaryLogic::lazyMaxMin($this->methods, static function (ExtendedMethodReflection $method) : TrinaryLogic { return $method->isPure(); }); } public function getDocComment() : ?string { return null; } public function getAsserts() : Assertions { $assertions = Assertions::createEmpty(); foreach ($this->methods as $method) { $assertions = $assertions->intersectWith($method->getAsserts()); } return $assertions; } public function acceptsNamedArguments() : bool { $accepts = \true; foreach ($this->methods as $method) { $accepts = $accepts && $method->acceptsNamedArguments(); } return $accepts; } public function getSelfOutType() : ?Type { return null; } public function returnsByReference() : TrinaryLogic { return TrinaryLogic::lazyMaxMin($this->methods, static function (ExtendedMethodReflection $method) : TrinaryLogic { return $method->returnsByReference(); }); } public function isAbstract() : TrinaryLogic { return TrinaryLogic::lazyMaxMin($this->methods, static function (ExtendedMethodReflection $method) : TrinaryLogic { return is_bool($method->isAbstract()) ? TrinaryLogic::createFromBoolean($method->isAbstract()) : $method->isAbstract(); }); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Constant; use PHPStan\Reflection\GlobalConstantReflection; use PHPStan\TrinaryLogic; use PHPStan\Type\Type; final class RuntimeConstantReflection implements GlobalConstantReflection { /** * @var string */ private $name; /** * @var Type */ private $valueType; /** * @var ?string */ private $fileName; /** * @var TrinaryLogic */ private $isDeprecated; /** * @var ?string */ private $deprecatedDescription; public function __construct(string $name, Type $valueType, ?string $fileName, TrinaryLogic $isDeprecated, ?string $deprecatedDescription) { $this->name = $name; $this->valueType = $valueType; $this->fileName = $fileName; $this->isDeprecated = $isDeprecated; $this->deprecatedDescription = $deprecatedDescription; } public function getName() : string { return $this->name; } public function getValueType() : Type { return $this->valueType; } public function getFileName() : ?string { return $this->fileName; } public function isDeprecated() : TrinaryLogic { return $this->isDeprecated; } public function getDeprecatedDescription() : ?string { return $this->deprecatedDescription; } public function isInternal() : TrinaryLogic { return TrinaryLogic::createNo(); } } <?php declare (strict_types=1); namespace PHPStan\Reflection; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\Generic\TemplateTypeVarianceMap; use PHPStan\Type\Type; /** * @api */ class FunctionVariantWithPhpDocs extends \PHPStan\Reflection\FunctionVariant implements \PHPStan\Reflection\ParametersAcceptorWithPhpDocs { /** * @var Type */ private $phpDocReturnType; /** * @var Type */ private $nativeReturnType; /** * @api * @param array<int, ParameterReflectionWithPhpDocs> $parameters */ public function __construct(TemplateTypeMap $templateTypeMap, ?TemplateTypeMap $resolvedTemplateTypeMap, array $parameters, bool $isVariadic, Type $returnType, Type $phpDocReturnType, Type $nativeReturnType, ?TemplateTypeVarianceMap $callSiteVarianceMap = null) { $this->phpDocReturnType = $phpDocReturnType; $this->nativeReturnType = $nativeReturnType; parent::__construct($templateTypeMap, $resolvedTemplateTypeMap, $parameters, $isVariadic, $returnType, $callSiteVarianceMap); } /** * @return array<int, ParameterReflectionWithPhpDocs> */ public function getParameters() : array { /** @var array<int, ParameterReflectionWithPhpDocs> $parameters */ $parameters = parent::getParameters(); return $parameters; } public function getPhpDocReturnType() : Type { return $this->phpDocReturnType; } public function getNativeReturnType() : Type { return $this->nativeReturnType; } } <?php declare (strict_types=1); namespace PHPStan\Reflection; use PHPStan\DependencyInjection\BleedingEdgeToggle; use PHPStan\Reflection\Php\DummyParameterWithPhpDocs; use PHPStan\Type\ConditionalTypeForParameter; use PHPStan\Type\ErrorType; use PHPStan\Type\Generic\GenericObjectType; use PHPStan\Type\Generic\GenericStaticType; use PHPStan\Type\Generic\TemplateType; use PHPStan\Type\Generic\TemplateTypeHelper; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\Generic\TemplateTypeVariance; use PHPStan\Type\Generic\TemplateTypeVarianceMap; use PHPStan\Type\NonAcceptingNeverType; use PHPStan\Type\Type; use PHPStan\Type\TypeTraverser; use PHPStan\Type\TypeUtils; use function array_key_exists; use function array_map; final class ResolvedFunctionVariantWithOriginal implements \PHPStan\Reflection\ResolvedFunctionVariant { /** * @var ParametersAcceptorWithPhpDocs */ private $parametersAcceptor; /** * @var TemplateTypeMap */ private $resolvedTemplateTypeMap; /** * @var TemplateTypeVarianceMap */ private $callSiteVarianceMap; /** * @var array<string, Type> */ private $passedArgs; /** @var ParameterReflectionWithPhpDocs[]|null */ private $parameters = null; /** * @var ?Type */ private $returnTypeWithUnresolvableTemplateTypes = null; /** * @var ?Type */ private $phpDocReturnTypeWithUnresolvableTemplateTypes = null; /** * @var ?Type */ private $returnType = null; /** * @var ?Type */ private $phpDocReturnType = null; /** * @param array<string, Type> $passedArgs */ public function __construct(\PHPStan\Reflection\ParametersAcceptorWithPhpDocs $parametersAcceptor, TemplateTypeMap $resolvedTemplateTypeMap, TemplateTypeVarianceMap $callSiteVarianceMap, array $passedArgs) { $this->parametersAcceptor = $parametersAcceptor; $this->resolvedTemplateTypeMap = $resolvedTemplateTypeMap; $this->callSiteVarianceMap = $callSiteVarianceMap; $this->passedArgs = $passedArgs; } public function getOriginalParametersAcceptor() : \PHPStan\Reflection\ParametersAcceptor { return $this->parametersAcceptor; } public function getTemplateTypeMap() : TemplateTypeMap { return $this->parametersAcceptor->getTemplateTypeMap(); } public function getResolvedTemplateTypeMap() : TemplateTypeMap { return $this->resolvedTemplateTypeMap; } public function getCallSiteVarianceMap() : TemplateTypeVarianceMap { return $this->callSiteVarianceMap; } public function getParameters() : array { $parameters = $this->parameters; if ($parameters === null) { $parameters = array_map(function (\PHPStan\Reflection\ParameterReflectionWithPhpDocs $param) : \PHPStan\Reflection\ParameterReflectionWithPhpDocs { $paramType = TypeUtils::resolveLateResolvableTypes(TemplateTypeHelper::resolveTemplateTypes($this->resolveConditionalTypesForParameter($param->getType()), $this->resolvedTemplateTypeMap, $this->callSiteVarianceMap, TemplateTypeVariance::createContravariant()), \false); $paramOutType = $param->getOutType(); if ($paramOutType !== null) { $paramOutType = TypeUtils::resolveLateResolvableTypes(TemplateTypeHelper::resolveTemplateTypes($this->resolveConditionalTypesForParameter($paramOutType), $this->resolvedTemplateTypeMap, $this->callSiteVarianceMap, TemplateTypeVariance::createCovariant()), \false); } $closureThisType = $param->getClosureThisType(); if ($closureThisType !== null) { $closureThisType = TypeUtils::resolveLateResolvableTypes(TemplateTypeHelper::resolveTemplateTypes($this->resolveConditionalTypesForParameter($closureThisType), $this->resolvedTemplateTypeMap, $this->callSiteVarianceMap, TemplateTypeVariance::createCovariant()), \false); } return new DummyParameterWithPhpDocs($param->getName(), $paramType, $param->isOptional(), $param->passedByReference(), $param->isVariadic(), $param->getDefaultValue(), $param->getNativeType(), $param->getPhpDocType(), $paramOutType, $param->isImmediatelyInvokedCallable(), $closureThisType); }, $this->parametersAcceptor->getParameters()); $this->parameters = $parameters; } return $parameters; } public function isVariadic() : bool { return $this->parametersAcceptor->isVariadic(); } public function getReturnTypeWithUnresolvableTemplateTypes() : Type { return $this->returnTypeWithUnresolvableTemplateTypes = $this->returnTypeWithUnresolvableTemplateTypes ?? $this->resolveConditionalTypesForParameter($this->resolveResolvableTemplateTypes($this->parametersAcceptor->getReturnType(), TemplateTypeVariance::createCovariant())); } public function getPhpDocReturnTypeWithUnresolvableTemplateTypes() : Type { return $this->phpDocReturnTypeWithUnresolvableTemplateTypes = $this->phpDocReturnTypeWithUnresolvableTemplateTypes ?? $this->resolveConditionalTypesForParameter($this->resolveResolvableTemplateTypes($this->parametersAcceptor->getPhpDocReturnType(), TemplateTypeVariance::createCovariant())); } public function getReturnType() : Type { $type = $this->returnType; if ($type === null) { $type = TypeUtils::resolveLateResolvableTypes(TemplateTypeHelper::resolveTemplateTypes($this->getReturnTypeWithUnresolvableTemplateTypes(), $this->resolvedTemplateTypeMap, $this->callSiteVarianceMap, TemplateTypeVariance::createCovariant()), \false); $this->returnType = $type; } return $type; } public function getPhpDocReturnType() : Type { $type = $this->phpDocReturnType; if ($type === null) { $type = TypeUtils::resolveLateResolvableTypes(TemplateTypeHelper::resolveTemplateTypes($this->getPhpDocReturnTypeWithUnresolvableTemplateTypes(), $this->resolvedTemplateTypeMap, $this->callSiteVarianceMap, TemplateTypeVariance::createCovariant()), \false); $this->phpDocReturnType = $type; } return $type; } public function getNativeReturnType() : Type { return $this->parametersAcceptor->getNativeReturnType(); } private function resolveResolvableTemplateTypes(Type $type, TemplateTypeVariance $positionVariance) : Type { $references = $type->getReferencedTemplateTypes($positionVariance); $objectCb = function (Type $type, callable $traverse) use($references) : Type { if ($type instanceof TemplateType && !$type->isArgument() && $type->getScope()->getFunctionName() !== null) { $newType = $this->resolvedTemplateTypeMap->getType($type->getName()); if ($newType === null || $newType instanceof ErrorType) { return $traverse($type); } $newType = TemplateTypeHelper::generalizeInferredTemplateType($type, $newType); $variance = TemplateTypeVariance::createInvariant(); foreach ($references as $reference) { // this uses identity to distinguish between different occurrences of the same template type // see https://github.com/phpstan/phpstan-src/pull/2485#discussion_r1328555397 for details if ($reference->getType() === $type) { $variance = $reference->getPositionVariance(); break; } } $callSiteVariance = $this->callSiteVarianceMap->getVariance($type->getName()); if ($callSiteVariance === null || $callSiteVariance->invariant()) { return $newType; } if (!$callSiteVariance->covariant() && $variance->covariant()) { return $traverse($type->getBound()); } if (!$callSiteVariance->contravariant() && $variance->contravariant()) { return new NonAcceptingNeverType(); } return $newType; } return $traverse($type); }; return TypeTraverser::map($type, function (Type $type, callable $traverse) use($references, $objectCb) : Type { if (BleedingEdgeToggle::isBleedingEdge() && ($type instanceof GenericObjectType || $type instanceof GenericStaticType)) { return TypeTraverser::map($type, $objectCb); } if ($type instanceof TemplateType && !$type->isArgument()) { $newType = $this->resolvedTemplateTypeMap->getType($type->getName()); if ($newType === null || $newType instanceof ErrorType) { return $traverse($type); } $variance = TemplateTypeVariance::createInvariant(); foreach ($references as $reference) { // this uses identity to distinguish between different occurrences of the same template type // see https://github.com/phpstan/phpstan-src/pull/2485#discussion_r1328555397 for details if ($reference->getType() === $type) { $variance = $reference->getPositionVariance(); break; } } $callSiteVariance = $this->callSiteVarianceMap->getVariance($type->getName()); if ($callSiteVariance === null || $callSiteVariance->invariant()) { return $newType; } if (!$callSiteVariance->covariant() && $variance->covariant()) { return $traverse($type->getBound()); } if (!$callSiteVariance->contravariant() && $variance->contravariant()) { return new NonAcceptingNeverType(); } return $newType; } return $traverse($type); }); } private function resolveConditionalTypesForParameter(Type $type) : Type { return TypeTraverser::map($type, function (Type $type, callable $traverse) : Type { if ($type instanceof ConditionalTypeForParameter && array_key_exists($type->getParameterName(), $this->passedArgs)) { $type = $type->toConditional($this->passedArgs[$type->getParameterName()]); } return $traverse($type); }); } } <?php declare (strict_types=1); namespace PHPStan\Reflection; use function array_filter; use function array_slice; use function end; use function explode; use function implode; use function str_contains; use function strtolower; final class ConstantNameHelper { public static function normalize(string $name) : string { if (!str_contains($name, '\\')) { return $name; } $nameParts = array_filter(explode('\\', $name), static function ($part) { return $part !== ''; }); return strtolower(implode('\\', array_slice($nameParts, 0, -1))) . '\\' . end($nameParts); } } <?php declare (strict_types=1); namespace PHPStan\Reflection; use PHPStan\TrinaryLogic; use PHPStan\Type\Type; /** @api */ interface FunctionReflection { public function getName() : string; public function getFileName() : ?string; /** * @return ParametersAcceptorWithPhpDocs[] */ public function getVariants() : array; /** * @internal */ public function getOnlyVariant() : \PHPStan\Reflection\ParametersAcceptorWithPhpDocs; /** * @return ParametersAcceptorWithPhpDocs[]|null */ public function getNamedArgumentsVariants() : ?array; public function acceptsNamedArguments() : bool; public function isDeprecated() : TrinaryLogic; public function getDeprecatedDescription() : ?string; public function isFinal() : TrinaryLogic; public function isInternal() : TrinaryLogic; public function getThrowType() : ?Type; public function hasSideEffects() : TrinaryLogic; public function isBuiltin() : bool; public function getAsserts() : \PHPStan\Reflection\Assertions; public function getDocComment() : ?string; public function returnsByReference() : TrinaryLogic; /** * This indicates whether the function has phpstan-pure * or phpstan-impure annotation above it. * * In most cases asking hasSideEffects() is much more practical * as it also accounts for void return type (method being always impure). */ public function isPure() : TrinaryLogic; } <?php declare (strict_types=1); namespace PHPStan\Reflection; use PHPStan\Type\Type; /** * @api * @final */ class EnumCaseReflection { /** * @var ClassReflection */ private $declaringEnum; /** * @var string */ private $name; /** * @var ?Type */ private $backingValueType; public function __construct(\PHPStan\Reflection\ClassReflection $declaringEnum, string $name, ?Type $backingValueType) { $this->declaringEnum = $declaringEnum; $this->name = $name; $this->backingValueType = $backingValueType; } public function getDeclaringEnum() : \PHPStan\Reflection\ClassReflection { return $this->declaringEnum; } public function getName() : string { return $this->name; } public function getBackingValueType() : ?Type { return $this->backingValueType; } } <?php declare (strict_types=1); namespace PHPStan\Reflection; use PHPStan\TrinaryLogic; use PHPStan\Type\Type; /** @api */ interface GlobalConstantReflection { public function getName() : string; public function getValueType() : Type; public function isDeprecated() : TrinaryLogic; public function getDeprecatedDescription() : ?string; public function isInternal() : TrinaryLogic; public function getFileName() : ?string; } <?php declare (strict_types=1); namespace PHPStan\Reflection; use PHPStan\Reflection\Callables\CallableParametersAcceptor; use PHPStan\Reflection\Php\DummyParameterWithPhpDocs; use PHPStan\TrinaryLogic; use PHPStan\Type\ConditionalTypeForParameter; use PHPStan\Type\ErrorType; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\Generic\TemplateTypeVarianceMap; use PHPStan\Type\MixedType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function array_key_exists; use function array_map; use function array_merge; use function count; use function is_int; final class GenericParametersAcceptorResolver { /** * @api * @param array<int|string, Type> $argTypes */ public static function resolve(array $argTypes, \PHPStan\Reflection\ParametersAcceptor $parametersAcceptor) : \PHPStan\Reflection\ParametersAcceptorWithPhpDocs { $typeMap = TemplateTypeMap::createEmpty(); $passedArgs = []; $parameters = $parametersAcceptor->getParameters(); $namedArgTypes = []; foreach ($argTypes as $i => $argType) { if (is_int($i)) { if (isset($parameters[$i])) { $namedArgTypes[$parameters[$i]->getName()] = $argType; continue; } if (count($parameters) > 0) { $lastParameter = $parameters[count($parameters) - 1]; if ($lastParameter->isVariadic()) { $parameterName = $lastParameter->getName(); if (array_key_exists($parameterName, $namedArgTypes)) { $namedArgTypes[$parameterName] = TypeCombinator::union($namedArgTypes[$parameterName], $argType); continue; } $namedArgTypes[$parameterName] = $argType; } } continue; } $namedArgTypes[$i] = $argType; } foreach ($parametersAcceptor->getParameters() as $param) { if (isset($namedArgTypes[$param->getName()])) { $argType = $namedArgTypes[$param->getName()]; } elseif ($param->getDefaultValue() !== null) { $argType = $param->getDefaultValue(); } else { continue; } $paramType = $param->getType(); $typeMap = $typeMap->union($paramType->inferTemplateTypes($argType)); $passedArgs['$' . $param->getName()] = $argType; } $returnType = $parametersAcceptor->getReturnType(); if ($returnType instanceof ConditionalTypeForParameter && !$returnType->isNegated() && array_key_exists($returnType->getParameterName(), $passedArgs)) { $paramType = $returnType->getTarget(); $argType = $passedArgs[$returnType->getParameterName()]; $typeMap = $typeMap->union($paramType->inferTemplateTypes($argType)); } $resolvedTemplateTypeMap = new TemplateTypeMap(array_merge($parametersAcceptor->getTemplateTypeMap()->map(static function (string $name, Type $type) : Type { return new ErrorType(); })->getTypes(), $typeMap->getTypes())); $originalParametersAcceptor = $parametersAcceptor; if (!$parametersAcceptor instanceof \PHPStan\Reflection\ParametersAcceptorWithPhpDocs) { $parametersAcceptor = new \PHPStan\Reflection\FunctionVariantWithPhpDocs($parametersAcceptor->getTemplateTypeMap(), $parametersAcceptor->getResolvedTemplateTypeMap(), array_map(static function (\PHPStan\Reflection\ParameterReflection $parameter) : \PHPStan\Reflection\ParameterReflectionWithPhpDocs { return new DummyParameterWithPhpDocs($parameter->getName(), $parameter->getType(), $parameter->isOptional(), $parameter->passedByReference(), $parameter->isVariadic(), $parameter->getDefaultValue(), new MixedType(), $parameter->getType(), null, TrinaryLogic::createMaybe(), null); }, $parametersAcceptor->getParameters()), $parametersAcceptor->isVariadic(), $parametersAcceptor->getReturnType(), $parametersAcceptor->getReturnType(), new MixedType(), TemplateTypeVarianceMap::createEmpty()); } $result = new \PHPStan\Reflection\ResolvedFunctionVariantWithOriginal($parametersAcceptor, $resolvedTemplateTypeMap, $parametersAcceptor->getCallSiteVarianceMap(), $passedArgs); if ($originalParametersAcceptor instanceof CallableParametersAcceptor) { return new \PHPStan\Reflection\ResolvedFunctionVariantWithCallable($result, $originalParametersAcceptor->getThrowPoints(), $originalParametersAcceptor->isPure(), $originalParametersAcceptor->getImpurePoints(), $originalParametersAcceptor->getInvalidateExpressions(), $originalParametersAcceptor->getUsedVariables(), $originalParametersAcceptor->acceptsNamedArguments()); } return $result; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Callables; use PHPStan\Type\ObjectType; use PHPStan\Type\Type; use Throwable; final class SimpleThrowPoint { /** * @var Type */ private $type; /** * @var bool */ private $explicit; /** * @var bool */ private $canContainAnyThrowable; private function __construct(Type $type, bool $explicit, bool $canContainAnyThrowable) { $this->type = $type; $this->explicit = $explicit; $this->canContainAnyThrowable = $canContainAnyThrowable; } public static function createExplicit(Type $type, bool $canContainAnyThrowable) : self { return new self($type, \true, $canContainAnyThrowable); } public static function createImplicit() : self { return new self(new ObjectType(Throwable::class), \false, \true); } public function getType() : Type { return $this->type; } public function isExplicit() : bool { return $this->explicit; } public function canContainAnyThrowable() : bool { return $this->canContainAnyThrowable; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Callables; use PHPStan\Analyser\ImpurePoint; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\ParametersAcceptor; use function sprintf; /** * @phpstan-import-type ImpurePointIdentifier from ImpurePoint */ final class SimpleImpurePoint { /** * @var ImpurePointIdentifier */ private $identifier; /** * @var string */ private $description; /** * @var bool */ private $certain; /** * @param ImpurePointIdentifier $identifier */ public function __construct(string $identifier, string $description, bool $certain) { $this->identifier = $identifier; $this->description = $description; $this->certain = $certain; } /** * @param FunctionReflection|ExtendedMethodReflection $function */ public static function createFromVariant($function, ?ParametersAcceptor $variant) : ?self { if (!$function->hasSideEffects()->no()) { $certain = $function->isPure()->no(); if ($variant !== null) { $certain = $certain || $variant->getReturnType()->isVoid()->yes(); } if ($function instanceof FunctionReflection) { return new \PHPStan\Reflection\Callables\SimpleImpurePoint('functionCall', sprintf('call to function %s()', $function->getName()), $certain); } return new \PHPStan\Reflection\Callables\SimpleImpurePoint('methodCall', sprintf('call to method %s::%s()', $function->getDeclaringClass()->getDisplayName(), $function->getName()), $certain); } return null; } /** * @return ImpurePointIdentifier */ public function getIdentifier() : string { return $this->identifier; } public function getDescription() : string { return $this->description; } public function isCertain() : bool { return $this->certain; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Callables; use PHPStan\Node\InvalidateExprNode; use PHPStan\Reflection\ParametersAcceptor; use PHPStan\TrinaryLogic; /** * @api */ interface CallableParametersAcceptor extends ParametersAcceptor { /** * @return SimpleThrowPoint[] */ public function getThrowPoints() : array; public function isPure() : TrinaryLogic; public function acceptsNamedArguments() : bool; /** * @return SimpleImpurePoint[] */ public function getImpurePoints() : array; /** * @return InvalidateExprNode[] */ public function getInvalidateExpressions() : array; /** * @return string[] */ public function getUsedVariables() : array; } <?php declare (strict_types=1); namespace PHPStan\Reflection\Callables; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\ParameterReflectionWithPhpDocs; use PHPStan\Reflection\ParametersAcceptorWithPhpDocs; use PHPStan\TrinaryLogic; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\Generic\TemplateTypeVarianceMap; use PHPStan\Type\NeverType; use PHPStan\Type\ObjectType; use PHPStan\Type\Type; use Throwable; use function array_map; use function count; final class FunctionCallableVariant implements \PHPStan\Reflection\Callables\CallableParametersAcceptor, ParametersAcceptorWithPhpDocs { /** * @var FunctionReflection|ExtendedMethodReflection */ private $function; /** * @var ParametersAcceptorWithPhpDocs */ private $variant; /** @var SimpleThrowPoint[]|null */ private $throwPoints = null; /** @var SimpleImpurePoint[]|null */ private $impurePoints = null; /** * @param FunctionReflection|ExtendedMethodReflection $function */ public function __construct($function, ParametersAcceptorWithPhpDocs $variant) { $this->function = $function; $this->variant = $variant; } /** * @param ParametersAcceptorWithPhpDocs[] $variants * @return self[] * @param FunctionReflection|ExtendedMethodReflection $function */ public static function createFromVariants($function, array $variants) : array { return array_map(static function (ParametersAcceptorWithPhpDocs $variant) use($function) { return new self($function, $variant); }, $variants); } public function getTemplateTypeMap() : TemplateTypeMap { return $this->variant->getTemplateTypeMap(); } public function getResolvedTemplateTypeMap() : TemplateTypeMap { return $this->variant->getResolvedTemplateTypeMap(); } /** * @return array<int, ParameterReflectionWithPhpDocs> */ public function getParameters() : array { return $this->variant->getParameters(); } public function isVariadic() : bool { return $this->variant->isVariadic(); } public function getReturnType() : Type { return $this->variant->getReturnType(); } public function getPhpDocReturnType() : Type { return $this->variant->getPhpDocReturnType(); } public function getNativeReturnType() : Type { return $this->variant->getNativeReturnType(); } public function getCallSiteVarianceMap() : TemplateTypeVarianceMap { return $this->variant->getCallSiteVarianceMap(); } public function getThrowPoints() : array { if ($this->throwPoints !== null) { return $this->throwPoints; } if ($this->variant instanceof \PHPStan\Reflection\Callables\CallableParametersAcceptor) { return $this->throwPoints = $this->variant->getThrowPoints(); } $returnType = $this->variant->getReturnType(); $throwType = $this->function->getThrowType(); if ($throwType === null) { if ($returnType instanceof NeverType && $returnType->isExplicit()) { $throwType = new ObjectType(Throwable::class); } } $throwPoints = []; if ($throwType !== null) { if (!$throwType->isVoid()->yes()) { $throwPoints[] = \PHPStan\Reflection\Callables\SimpleThrowPoint::createExplicit($throwType, \true); } } else { if (!(new ObjectType(Throwable::class))->isSuperTypeOf($returnType)->yes()) { $throwPoints[] = \PHPStan\Reflection\Callables\SimpleThrowPoint::createImplicit(); } } return $this->throwPoints = $throwPoints; } public function isPure() : TrinaryLogic { $impurePoints = $this->getImpurePoints(); if (count($impurePoints) === 0) { return TrinaryLogic::createYes(); } $certainCount = 0; foreach ($impurePoints as $impurePoint) { if (!$impurePoint->isCertain()) { continue; } $certainCount++; } return $certainCount > 0 ? TrinaryLogic::createNo() : TrinaryLogic::createMaybe(); } public function getImpurePoints() : array { if ($this->impurePoints !== null) { return $this->impurePoints; } if ($this->variant instanceof \PHPStan\Reflection\Callables\CallableParametersAcceptor) { return $this->impurePoints = $this->variant->getImpurePoints(); } $impurePoint = \PHPStan\Reflection\Callables\SimpleImpurePoint::createFromVariant($this->function, $this->variant); if ($impurePoint === null) { return $this->impurePoints = []; } return $this->impurePoints = [$impurePoint]; } public function getInvalidateExpressions() : array { return []; } public function getUsedVariables() : array { return []; } public function acceptsNamedArguments() : bool { return $this->function->acceptsNamedArguments(); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Php; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ExtendedPropertyReflection; use PHPStan\TrinaryLogic; use PHPStan\Type\BooleanType; use PHPStan\Type\FloatType; use PHPStan\Type\IntegerType; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; final class SimpleXMLElementProperty implements ExtendedPropertyReflection { /** * @var ClassReflection */ private $declaringClass; /** * @var Type */ private $type; public function __construct(ClassReflection $declaringClass, Type $type) { $this->declaringClass = $declaringClass; $this->type = $type; } public function getDeclaringClass() : ClassReflection { return $this->declaringClass; } public function isStatic() : bool { return \false; } public function isPrivate() : bool { return \false; } public function isPublic() : bool { return \true; } public function getReadableType() : Type { return $this->type; } public function getWritableType() : Type { return TypeCombinator::union($this->type, new IntegerType(), new FloatType(), new StringType(), new BooleanType()); } public function isReadable() : bool { return \true; } public function isWritable() : bool { return \true; } public function canChangeTypeAfterAssignment() : bool { return \false; } public function isDeprecated() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getDeprecatedDescription() : ?string { return null; } public function isInternal() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getDocComment() : ?string { return null; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Php; use PHPStan\Reflection\ExtendedPropertyReflection; use PHPStan\Reflection\Type\UnresolvedPropertyPrototypeReflection; use PHPStan\Type\Type; final class EnumUnresolvedPropertyPrototypeReflection implements UnresolvedPropertyPrototypeReflection { /** * @var EnumPropertyReflection */ private $property; public function __construct(\PHPStan\Reflection\Php\EnumPropertyReflection $property) { $this->property = $property; } public function doNotResolveTemplateTypeMapToBounds() : UnresolvedPropertyPrototypeReflection { return $this; } public function getNakedProperty() : ExtendedPropertyReflection { return $this->property; } public function getTransformedProperty() : ExtendedPropertyReflection { return $this->property; } public function withFechedOnType(Type $type) : UnresolvedPropertyPrototypeReflection { return $this; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Php; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ExtendedPropertyReflection; use PHPStan\TrinaryLogic; use PHPStan\Type\Type; final class UniversalObjectCrateProperty implements ExtendedPropertyReflection { /** * @var ClassReflection */ private $declaringClass; /** * @var Type */ private $readableType; /** * @var Type */ private $writableType; public function __construct(ClassReflection $declaringClass, Type $readableType, Type $writableType) { $this->declaringClass = $declaringClass; $this->readableType = $readableType; $this->writableType = $writableType; } public function getDeclaringClass() : ClassReflection { return $this->declaringClass; } public function isStatic() : bool { return \false; } public function isPrivate() : bool { return \false; } public function isPublic() : bool { return \true; } public function getReadableType() : Type { return $this->readableType; } public function getWritableType() : Type { return $this->writableType; } public function canChangeTypeAfterAssignment() : bool { return \true; } public function isReadable() : bool { return \true; } public function isWritable() : bool { return \true; } public function isDeprecated() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getDeprecatedDescription() : ?string { return null; } public function isInternal() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getDocComment() : ?string { return null; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Php; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionIntersectionType; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionNamedType; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionProperty; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionUnionType; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ExtendedPropertyReflection; use PHPStan\TrinaryLogic; use PHPStan\Type\MixedType; use PHPStan\Type\Type; use PHPStan\Type\TypehintHelper; /** * @api * @final */ class PhpPropertyReflection implements ExtendedPropertyReflection { /** * @var ClassReflection */ private $declaringClass; /** * @var ?ClassReflection */ private $declaringTrait; /** * @var ReflectionUnionType|ReflectionNamedType|ReflectionIntersectionType|null */ private $nativeType; /** * @var ?Type */ private $phpDocType; /** * @var ReflectionProperty */ private $reflection; /** * @var ?string */ private $deprecatedDescription; /** * @var bool */ private $isDeprecated; /** * @var bool */ private $isInternal; /** * @var bool */ private $isReadOnlyByPhpDoc; /** * @var bool */ private $isAllowedPrivateMutation; /** * @var ?Type */ private $finalNativeType = null; /** * @var ?Type */ private $type = null; /** * @param ReflectionUnionType|ReflectionNamedType|ReflectionIntersectionType|null $nativeType */ public function __construct(ClassReflection $declaringClass, ?ClassReflection $declaringTrait, $nativeType, ?Type $phpDocType, ReflectionProperty $reflection, ?string $deprecatedDescription, bool $isDeprecated, bool $isInternal, bool $isReadOnlyByPhpDoc, bool $isAllowedPrivateMutation) { $this->declaringClass = $declaringClass; $this->declaringTrait = $declaringTrait; $this->nativeType = $nativeType; $this->phpDocType = $phpDocType; $this->reflection = $reflection; $this->deprecatedDescription = $deprecatedDescription; $this->isDeprecated = $isDeprecated; $this->isInternal = $isInternal; $this->isReadOnlyByPhpDoc = $isReadOnlyByPhpDoc; $this->isAllowedPrivateMutation = $isAllowedPrivateMutation; } public function getDeclaringClass() : ClassReflection { return $this->declaringClass; } public function getDeclaringTrait() : ?ClassReflection { return $this->declaringTrait; } public function getDocComment() : ?string { $docComment = $this->reflection->getDocComment(); if ($docComment === \false) { return null; } return $docComment; } public function isStatic() : bool { return $this->reflection->isStatic(); } public function isPrivate() : bool { return $this->reflection->isPrivate(); } public function isPublic() : bool { return $this->reflection->isPublic(); } public function isReadOnly() : bool { return $this->reflection->isReadOnly(); } public function isReadOnlyByPhpDoc() : bool { return $this->isReadOnlyByPhpDoc; } public function getReadableType() : Type { if ($this->type === null) { $this->type = TypehintHelper::decideTypeFromReflection($this->nativeType, $this->phpDocType, $this->declaringClass); } return $this->type; } public function getWritableType() : Type { return $this->getReadableType(); } public function canChangeTypeAfterAssignment() : bool { return \true; } public function isPromoted() : bool { return $this->reflection->isPromoted(); } public function hasPhpDocType() : bool { return $this->phpDocType !== null; } public function getPhpDocType() : Type { if ($this->phpDocType !== null) { return $this->phpDocType; } return new MixedType(); } public function hasNativeType() : bool { return $this->nativeType !== null; } public function getNativeType() : Type { if ($this->finalNativeType === null) { $this->finalNativeType = TypehintHelper::decideTypeFromReflection($this->nativeType, null, $this->declaringClass); } return $this->finalNativeType; } public function isReadable() : bool { return \true; } public function isWritable() : bool { return \true; } public function getDeprecatedDescription() : ?string { if ($this->isDeprecated) { return $this->deprecatedDescription; } return null; } public function isDeprecated() : TrinaryLogic { return TrinaryLogic::createFromBoolean($this->isDeprecated); } public function isInternal() : TrinaryLogic { return TrinaryLogic::createFromBoolean($this->isInternal); } public function isAllowedPrivateMutation() : bool { return $this->isAllowedPrivateMutation; } public function getNativeReflection() : ReflectionProperty { return $this->reflection; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Php; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionParameter; use PHPStan\Reflection\InitializerExprContext; use PHPStan\Reflection\InitializerExprTypeResolver; use PHPStan\Reflection\ParameterReflectionWithPhpDocs; use PHPStan\Reflection\PassedByReference; use PHPStan\TrinaryLogic; use PHPStan\Type\MixedType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\TypehintHelper; final class PhpParameterReflection implements ParameterReflectionWithPhpDocs { /** * @var InitializerExprTypeResolver */ private $initializerExprTypeResolver; /** * @var ReflectionParameter */ private $reflection; /** * @var ?Type */ private $phpDocType; /** * @var ?string */ private $declaringClassName; /** * @var ?Type */ private $outType; /** * @var TrinaryLogic */ private $immediatelyInvokedCallable; /** * @var ?Type */ private $closureThisType; /** * @var ?Type */ private $type = null; /** * @var ?Type */ private $nativeType = null; public function __construct(InitializerExprTypeResolver $initializerExprTypeResolver, ReflectionParameter $reflection, ?Type $phpDocType, ?string $declaringClassName, ?Type $outType, TrinaryLogic $immediatelyInvokedCallable, ?Type $closureThisType) { $this->initializerExprTypeResolver = $initializerExprTypeResolver; $this->reflection = $reflection; $this->phpDocType = $phpDocType; $this->declaringClassName = $declaringClassName; $this->outType = $outType; $this->immediatelyInvokedCallable = $immediatelyInvokedCallable; $this->closureThisType = $closureThisType; } public function isOptional() : bool { return $this->reflection->isOptional(); } public function getName() : string { return $this->reflection->getName(); } public function getType() : Type { if ($this->type === null) { $phpDocType = $this->phpDocType; if ($phpDocType !== null && $this->reflection->isDefaultValueAvailable()) { $defaultValueType = $this->initializerExprTypeResolver->getType($this->reflection->getDefaultValueExpression(), InitializerExprContext::fromReflectionParameter($this->reflection)); if ($defaultValueType->isNull()->yes()) { $phpDocType = TypeCombinator::addNull($phpDocType); } } $this->type = TypehintHelper::decideTypeFromReflection($this->reflection->getType(), $phpDocType, $this->declaringClassName, $this->isVariadic()); } return $this->type; } public function passedByReference() : PassedByReference { return $this->reflection->isPassedByReference() ? PassedByReference::createCreatesNewVariable() : PassedByReference::createNo(); } public function isVariadic() : bool { return $this->reflection->isVariadic(); } public function getPhpDocType() : Type { if ($this->phpDocType !== null) { return $this->phpDocType; } return new MixedType(); } public function getNativeType() : Type { if ($this->nativeType === null) { $this->nativeType = TypehintHelper::decideTypeFromReflection($this->reflection->getType(), null, $this->declaringClassName, $this->isVariadic()); } return $this->nativeType; } public function getDefaultValue() : ?Type { if ($this->reflection->isDefaultValueAvailable()) { return $this->initializerExprTypeResolver->getType($this->reflection->getDefaultValueExpression(), InitializerExprContext::fromReflectionParameter($this->reflection)); } return null; } public function getOutType() : ?Type { return $this->outType; } public function isImmediatelyInvokedCallable() : TrinaryLogic { return $this->immediatelyInvokedCallable; } public function getClosureThisType() : ?Type { return $this->closureThisType; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Php; use PHPStan\Reflection\ParameterReflectionWithPhpDocs; use PHPStan\Reflection\PassedByReference; use PHPStan\TrinaryLogic; use PHPStan\Type\MixedType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\TypehintHelper; final class PhpParameterFromParserNodeReflection implements ParameterReflectionWithPhpDocs { /** * @var string */ private $name; /** * @var bool */ private $optional; /** * @var Type */ private $realType; /** * @var ?Type */ private $phpDocType; /** * @var PassedByReference */ private $passedByReference; /** * @var ?Type */ private $defaultValue; /** * @var bool */ private $variadic; /** * @var ?Type */ private $outType; /** * @var TrinaryLogic */ private $immediatelyInvokedCallable; /** * @var ?Type */ private $closureThisType; /** * @var ?Type */ private $type = null; public function __construct(string $name, bool $optional, Type $realType, ?Type $phpDocType, PassedByReference $passedByReference, ?Type $defaultValue, bool $variadic, ?Type $outType, TrinaryLogic $immediatelyInvokedCallable, ?Type $closureThisType) { $this->name = $name; $this->optional = $optional; $this->realType = $realType; $this->phpDocType = $phpDocType; $this->passedByReference = $passedByReference; $this->defaultValue = $defaultValue; $this->variadic = $variadic; $this->outType = $outType; $this->immediatelyInvokedCallable = $immediatelyInvokedCallable; $this->closureThisType = $closureThisType; } public function getName() : string { return $this->name; } public function isOptional() : bool { return $this->optional; } public function getType() : Type { if ($this->type === null) { $phpDocType = $this->phpDocType; if ($phpDocType !== null && $this->defaultValue !== null) { if ($this->defaultValue->isNull()->yes()) { $inferred = $phpDocType->inferTemplateTypes($this->defaultValue); if ($inferred->isEmpty()) { $phpDocType = TypeCombinator::addNull($phpDocType); } } } $this->type = TypehintHelper::decideType($this->realType, $phpDocType); } return $this->type; } public function getPhpDocType() : Type { return $this->phpDocType ?? new MixedType(); } public function getNativeType() : Type { return $this->realType; } public function passedByReference() : PassedByReference { return $this->passedByReference; } public function isVariadic() : bool { return $this->variadic; } public function getDefaultValue() : ?Type { return $this->defaultValue; } public function getOutType() : ?Type { return $this->outType; } public function isImmediatelyInvokedCallable() : TrinaryLogic { return $this->immediatelyInvokedCallable; } public function getClosureThisType() : ?Type { return $this->closureThisType; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Php; use PhpParser\Node; use PhpParser\Node\Stmt\ClassMethod; use PHPStan\Reflection\Assertions; use PHPStan\Reflection\ClassMemberReflection; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\MissingMethodFromReflectionException; use PHPStan\TrinaryLogic; use PHPStan\Type\ArrayType; use PHPStan\Type\BooleanType; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\IntegerType; use PHPStan\Type\MixedType; use PHPStan\Type\ObjectWithoutClassType; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\VoidType; use function in_array; use function strtolower; /** * @api * @final */ class PhpMethodFromParserNodeReflection extends \PHPStan\Reflection\Php\PhpFunctionFromParserNodeReflection implements ExtendedMethodReflection { /** * @var ClassReflection */ private $declaringClass; /** * @var ?Type */ private $selfOutType; /** * @var bool */ private $isConstructor; /** * @param Type[] $realParameterTypes * @param Type[] $phpDocParameterTypes * @param Type[] $realParameterDefaultValues * @param array<string, bool> $immediatelyInvokedCallableParameters * @param array<string, Type> $phpDocClosureThisTypeParameters */ public function __construct(ClassReflection $declaringClass, ClassMethod $classMethod, string $fileName, TemplateTypeMap $templateTypeMap, array $realParameterTypes, array $phpDocParameterTypes, array $realParameterDefaultValues, Type $realReturnType, ?Type $phpDocReturnType, ?Type $throwType, ?string $deprecatedDescription, bool $isDeprecated, bool $isInternal, bool $isFinal, ?bool $isPure, bool $acceptsNamedArguments, Assertions $assertions, ?Type $selfOutType, ?string $phpDocComment, array $parameterOutTypes, array $immediatelyInvokedCallableParameters, array $phpDocClosureThisTypeParameters, bool $isConstructor) { $this->declaringClass = $declaringClass; $this->selfOutType = $selfOutType; $this->isConstructor = $isConstructor; $name = strtolower($classMethod->name->name); if ($this->isConstructor) { $realReturnType = new VoidType(); } if (in_array($name, ['__destruct', '__unset', '__wakeup', '__clone'], \true)) { $realReturnType = new VoidType(); } if ($name === '__tostring') { $realReturnType = new StringType(); } if ($name === '__isset') { $realReturnType = new BooleanType(); } if ($name === '__sleep') { $realReturnType = new ArrayType(new IntegerType(), new StringType()); } if ($name === '__set_state') { $realReturnType = TypeCombinator::intersect(new ObjectWithoutClassType(), $realReturnType); } if ($name === '__set') { $realReturnType = new VoidType(); } if ($name === '__debuginfo') { $realReturnType = TypeCombinator::intersect(TypeCombinator::addNull(new ArrayType(new MixedType(\true), new MixedType(\true))), $realReturnType); } if ($name === '__unserialize') { $realReturnType = new VoidType(); } if ($name === '__serialize') { $realReturnType = new ArrayType(new MixedType(\true), new MixedType(\true)); } parent::__construct($classMethod, $fileName, $templateTypeMap, $realParameterTypes, $phpDocParameterTypes, $realParameterDefaultValues, $realReturnType, $phpDocReturnType, $throwType, $deprecatedDescription, $isDeprecated, $isInternal, $isFinal || $classMethod->isFinal(), $isPure, $acceptsNamedArguments, $assertions, $phpDocComment, $parameterOutTypes, $immediatelyInvokedCallableParameters, $phpDocClosureThisTypeParameters); } public function getDeclaringClass() : ClassReflection { return $this->declaringClass; } public function getPrototype() : ClassMemberReflection { try { return $this->declaringClass->getNativeMethod($this->getClassMethod()->name->name)->getPrototype(); } catch (MissingMethodFromReflectionException $e) { return $this; } } private function getClassMethod() : ClassMethod { /** @var Node\Stmt\ClassMethod $functionLike */ $functionLike = $this->getFunctionLike(); return $functionLike; } public function isStatic() : bool { return $this->getClassMethod()->isStatic(); } public function isPrivate() : bool { return $this->getClassMethod()->isPrivate(); } public function isPublic() : bool { return $this->getClassMethod()->isPublic(); } public function isBuiltin() : bool { return \false; } public function getSelfOutType() : ?Type { return $this->selfOutType; } public function returnsByReference() : TrinaryLogic { return TrinaryLogic::createFromBoolean($this->getClassMethod()->returnsByRef()); } public function isAbstract() : TrinaryLogic { return TrinaryLogic::createFromBoolean($this->getClassMethod()->isAbstract()); } public function isConstructor() : bool { return $this->isConstructor; } public function hasSideEffects() : TrinaryLogic { if (strtolower($this->getName()) !== '__construct' && $this->getReturnType()->isVoid()->yes()) { return TrinaryLogic::createYes(); } if ($this->isPure !== null) { return TrinaryLogic::createFromBoolean(!$this->isPure); } return TrinaryLogic::createMaybe(); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Php; use PHPStan\Reflection\ParameterReflectionWithPhpDocs; use PHPStan\Reflection\PassedByReference; use PHPStan\TrinaryLogic; use PHPStan\Type\Type; final class DummyParameterWithPhpDocs extends \PHPStan\Reflection\Php\DummyParameter implements ParameterReflectionWithPhpDocs { /** * @var Type */ private $nativeType; /** * @var Type */ private $phpDocType; /** * @var ?Type */ private $outType; /** * @var TrinaryLogic */ private $immediatelyInvokedCallable; /** * @var ?Type */ private $closureThisType; public function __construct(string $name, Type $type, bool $optional, ?PassedByReference $passedByReference, bool $variadic, ?Type $defaultValue, Type $nativeType, Type $phpDocType, ?Type $outType, TrinaryLogic $immediatelyInvokedCallable, ?Type $closureThisType) { $this->nativeType = $nativeType; $this->phpDocType = $phpDocType; $this->outType = $outType; $this->immediatelyInvokedCallable = $immediatelyInvokedCallable; $this->closureThisType = $closureThisType; parent::__construct($name, $type, $optional, $passedByReference, $variadic, $defaultValue); } public function getPhpDocType() : Type { return $this->phpDocType; } public function getNativeType() : Type { return $this->nativeType; } public function getOutType() : ?Type { return $this->outType; } public function isImmediatelyInvokedCallable() : TrinaryLogic { return $this->immediatelyInvokedCallable; } public function getClosureThisType() : ?Type { return $this->closureThisType; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Php; use PhpParser\Node; use PhpParser\Node\Stmt\Function_; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionFunction; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionParameter; use PHPStan\Cache\Cache; use PHPStan\Parser\FunctionCallStatementFinder; use PHPStan\Parser\Parser; use PHPStan\Reflection\Assertions; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\FunctionVariantWithPhpDocs; use PHPStan\Reflection\InitializerExprTypeResolver; use PHPStan\Reflection\ParameterReflectionWithPhpDocs; use PHPStan\Reflection\ParametersAcceptor; use PHPStan\Reflection\ParametersAcceptorWithPhpDocs; use PHPStan\TrinaryLogic; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\MixedType; use PHPStan\Type\Type; use PHPStan\Type\TypehintHelper; use function array_key_exists; use function array_map; use function filemtime; use function is_array; use function is_file; use function sprintf; use function time; final class PhpFunctionReflection implements FunctionReflection { /** * @var InitializerExprTypeResolver */ private $initializerExprTypeResolver; /** * @var ReflectionFunction */ private $reflection; /** * @var Parser */ private $parser; /** * @var FunctionCallStatementFinder */ private $functionCallStatementFinder; /** * @var Cache */ private $cache; /** * @var TemplateTypeMap */ private $templateTypeMap; /** * @var array<string, Type> */ private $phpDocParameterTypes; /** * @var ?Type */ private $phpDocReturnType; /** * @var ?Type */ private $phpDocThrowType; /** * @var ?string */ private $deprecatedDescription; /** * @var bool */ private $isDeprecated; /** * @var bool */ private $isInternal; /** * @var bool */ private $isFinal; /** * @var ?string */ private $filename; /** * @var ?bool */ private $isPure; /** * @var Assertions */ private $asserts; /** * @var bool */ private $acceptsNamedArguments; /** * @var ?string */ private $phpDocComment; /** * @var array<string, Type> */ private $phpDocParameterOutTypes; /** * @var array<string, bool> */ private $phpDocParameterImmediatelyInvokedCallable; /** * @var array<string, Type> */ private $phpDocParameterClosureThisTypes; /** @var FunctionVariantWithPhpDocs[]|null */ private $variants = null; /** * @param array<string, Type> $phpDocParameterTypes * @param array<string, Type> $phpDocParameterOutTypes * @param array<string, bool> $phpDocParameterImmediatelyInvokedCallable * @param array<string, Type> $phpDocParameterClosureThisTypes */ public function __construct(InitializerExprTypeResolver $initializerExprTypeResolver, ReflectionFunction $reflection, Parser $parser, FunctionCallStatementFinder $functionCallStatementFinder, Cache $cache, TemplateTypeMap $templateTypeMap, array $phpDocParameterTypes, ?Type $phpDocReturnType, ?Type $phpDocThrowType, ?string $deprecatedDescription, bool $isDeprecated, bool $isInternal, bool $isFinal, ?string $filename, ?bool $isPure, Assertions $asserts, bool $acceptsNamedArguments, ?string $phpDocComment, array $phpDocParameterOutTypes, array $phpDocParameterImmediatelyInvokedCallable, array $phpDocParameterClosureThisTypes) { $this->initializerExprTypeResolver = $initializerExprTypeResolver; $this->reflection = $reflection; $this->parser = $parser; $this->functionCallStatementFinder = $functionCallStatementFinder; $this->cache = $cache; $this->templateTypeMap = $templateTypeMap; $this->phpDocParameterTypes = $phpDocParameterTypes; $this->phpDocReturnType = $phpDocReturnType; $this->phpDocThrowType = $phpDocThrowType; $this->deprecatedDescription = $deprecatedDescription; $this->isDeprecated = $isDeprecated; $this->isInternal = $isInternal; $this->isFinal = $isFinal; $this->filename = $filename; $this->isPure = $isPure; $this->asserts = $asserts; $this->acceptsNamedArguments = $acceptsNamedArguments; $this->phpDocComment = $phpDocComment; $this->phpDocParameterOutTypes = $phpDocParameterOutTypes; $this->phpDocParameterImmediatelyInvokedCallable = $phpDocParameterImmediatelyInvokedCallable; $this->phpDocParameterClosureThisTypes = $phpDocParameterClosureThisTypes; } public function getName() : string { return $this->reflection->getName(); } public function getFileName() : ?string { if ($this->filename === null) { return null; } if (!is_file($this->filename)) { return null; } return $this->filename; } /** * @return ParametersAcceptorWithPhpDocs[] */ public function getVariants() : array { if ($this->variants === null) { $this->variants = [new FunctionVariantWithPhpDocs($this->templateTypeMap, null, $this->getParameters(), $this->isVariadic(), $this->getReturnType(), $this->getPhpDocReturnType(), $this->getNativeReturnType())]; } return $this->variants; } public function getOnlyVariant() : ParametersAcceptorWithPhpDocs { return $this->getVariants()[0]; } public function getNamedArgumentsVariants() : ?array { return null; } /** * @return ParameterReflectionWithPhpDocs[] */ private function getParameters() : array { return array_map(function (ReflectionParameter $reflection) : \PHPStan\Reflection\Php\PhpParameterReflection { if (array_key_exists($reflection->getName(), $this->phpDocParameterImmediatelyInvokedCallable)) { $immediatelyInvokedCallable = TrinaryLogic::createFromBoolean($this->phpDocParameterImmediatelyInvokedCallable[$reflection->getName()]); } else { $immediatelyInvokedCallable = TrinaryLogic::createMaybe(); } return new \PHPStan\Reflection\Php\PhpParameterReflection($this->initializerExprTypeResolver, $reflection, $this->phpDocParameterTypes[$reflection->getName()] ?? null, null, $this->phpDocParameterOutTypes[$reflection->getName()] ?? null, $immediatelyInvokedCallable, $this->phpDocParameterClosureThisTypes[$reflection->getName()] ?? null); }, $this->reflection->getParameters()); } private function isVariadic() : bool { $isNativelyVariadic = $this->reflection->isVariadic(); if (!$isNativelyVariadic && $this->reflection->getFileName() !== \false) { $fileName = $this->reflection->getFileName(); if (is_file($fileName)) { $functionName = $this->reflection->getName(); $modifiedTime = filemtime($fileName); if ($modifiedTime === \false) { $modifiedTime = time(); } $variableCacheKey = sprintf('%d-v4', $modifiedTime); $key = sprintf('variadic-function-%s-%s', $functionName, $fileName); $cachedResult = $this->cache->load($key, $variableCacheKey); if ($cachedResult === null) { $nodes = $this->parser->parseFile($fileName); $result = !$this->containsVariadicFunction($nodes)->no(); $this->cache->save($key, $variableCacheKey, $result); return $result; } return $cachedResult; } } return $isNativelyVariadic; } /** * @param Node[]|scalar[]|Node $node */ private function containsVariadicFunction($node) : TrinaryLogic { $result = TrinaryLogic::createMaybe(); if ($node instanceof Node) { if ($node instanceof Function_) { $functionName = (string) $node->namespacedName; if ($functionName === $this->reflection->getName()) { return TrinaryLogic::createFromBoolean($this->isFunctionNodeVariadic($node)); } } foreach ($node->getSubNodeNames() as $subNodeName) { $innerNode = $node->{$subNodeName}; if (!$innerNode instanceof Node && !is_array($innerNode)) { continue; } $result = $result->and($this->containsVariadicFunction($innerNode)); } } elseif (is_array($node)) { foreach ($node as $subNode) { if (!$subNode instanceof Node) { continue; } $result = $result->and($this->containsVariadicFunction($subNode)); } } return $result; } private function getReturnType() : Type { return TypehintHelper::decideTypeFromReflection($this->reflection->getReturnType(), $this->phpDocReturnType); } private function getPhpDocReturnType() : Type { if ($this->phpDocReturnType !== null) { return $this->phpDocReturnType; } return new MixedType(); } private function getNativeReturnType() : Type { return TypehintHelper::decideTypeFromReflection($this->reflection->getReturnType()); } public function getDeprecatedDescription() : ?string { if ($this->isDeprecated) { return $this->deprecatedDescription; } return null; } public function isDeprecated() : TrinaryLogic { return TrinaryLogic::createFromBoolean($this->isDeprecated || $this->reflection->isDeprecated()); } public function isInternal() : TrinaryLogic { return TrinaryLogic::createFromBoolean($this->isInternal); } public function isFinal() : TrinaryLogic { return TrinaryLogic::createFromBoolean($this->isFinal); } public function getThrowType() : ?Type { return $this->phpDocThrowType; } public function hasSideEffects() : TrinaryLogic { if ($this->getReturnType()->isVoid()->yes()) { return TrinaryLogic::createYes(); } if ($this->isPure !== null) { return TrinaryLogic::createFromBoolean(!$this->isPure); } return TrinaryLogic::createMaybe(); } public function isPure() : TrinaryLogic { if ($this->isPure === null) { return TrinaryLogic::createMaybe(); } return TrinaryLogic::createFromBoolean($this->isPure); } public function isBuiltin() : bool { return $this->reflection->isInternal(); } public function getAsserts() : Assertions { return $this->asserts; } public function getDocComment() : ?string { return $this->phpDocComment; } public function returnsByReference() : TrinaryLogic { return TrinaryLogic::createFromBoolean($this->reflection->returnsReference()); } public function acceptsNamedArguments() : bool { return $this->acceptsNamedArguments; } private function isFunctionNodeVariadic(Function_ $node) : bool { foreach ($node->params as $parameter) { if ($parameter->variadic) { return \true; } } if ($this->functionCallStatementFinder->findFunctionCallInStatements(ParametersAcceptor::VARIADIC_FUNCTIONS, $node->getStmts()) !== null) { return \true; } return \false; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Php; use PhpParser\Node; use PhpParser\Node\Stmt\ClassMethod; use PhpParser\Node\Stmt\Declare_; use PhpParser\Node\Stmt\Function_; use PhpParser\Node\Stmt\Namespace_; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionParameter; use PHPStan\Cache\Cache; use PHPStan\Parser\FunctionCallStatementFinder; use PHPStan\Parser\Parser; use PHPStan\Reflection\Assertions; use PHPStan\Reflection\ClassMemberReflection; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\FunctionVariantWithPhpDocs; use PHPStan\Reflection\InitializerExprTypeResolver; use PHPStan\Reflection\MethodPrototypeReflection; use PHPStan\Reflection\ParameterReflectionWithPhpDocs; use PHPStan\Reflection\ParametersAcceptor; use PHPStan\Reflection\ParametersAcceptorWithPhpDocs; use PHPStan\Reflection\ReflectionProvider; use PHPStan\TrinaryLogic; use PHPStan\Type\ArrayType; use PHPStan\Type\BooleanType; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\IntegerType; use PHPStan\Type\MixedType; use PHPStan\Type\ObjectWithoutClassType; use PHPStan\Type\StringType; use PHPStan\Type\ThisType; use PHPStan\Type\Type; use PHPStan\Type\TypehintHelper; use PHPStan\Type\VoidType; use ReflectionException; use function array_map; use function explode; use function filemtime; use function in_array; use function is_bool; use function sprintf; use function strtolower; use function time; use const PHP_VERSION_ID; /** * @api * @final */ class PhpMethodReflection implements ExtendedMethodReflection { /** * @var InitializerExprTypeResolver */ private $initializerExprTypeResolver; /** * @var ClassReflection */ private $declaringClass; /** * @var ?ClassReflection */ private $declaringTrait; /** * @var BuiltinMethodReflection */ private $reflection; /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var Parser */ private $parser; /** * @var FunctionCallStatementFinder */ private $functionCallStatementFinder; /** * @var Cache */ private $cache; /** * @var TemplateTypeMap */ private $templateTypeMap; /** * @var Type[] */ private $phpDocParameterTypes; /** * @var ?Type */ private $phpDocReturnType; /** * @var ?Type */ private $phpDocThrowType; /** * @var ?string */ private $deprecatedDescription; /** * @var bool */ private $isDeprecated; /** * @var bool */ private $isInternal; /** * @var bool */ private $isFinal; /** * @var ?bool */ private $isPure; /** * @var Assertions */ private $asserts; /** * @var bool */ private $acceptsNamedArguments; /** * @var ?Type */ private $selfOutType; /** * @var ?string */ private $phpDocComment; /** * @var Type[] */ private $phpDocParameterOutTypes; /** * @var array<string, TrinaryLogic> */ private $immediatelyInvokedCallableParameters; /** * @var array<string, Type> */ private $phpDocClosureThisTypeParameters; /** @var PhpParameterReflection[]|null */ private $parameters = null; /** * @var ?Type */ private $returnType = null; /** * @var ?Type */ private $nativeReturnType = null; /** @var FunctionVariantWithPhpDocs[]|null */ private $variants = null; /** * @param Type[] $phpDocParameterTypes * @param Type[] $phpDocParameterOutTypes * @param array<string, TrinaryLogic> $immediatelyInvokedCallableParameters * @param array<string, Type> $phpDocClosureThisTypeParameters */ public function __construct(InitializerExprTypeResolver $initializerExprTypeResolver, ClassReflection $declaringClass, ?ClassReflection $declaringTrait, \PHPStan\Reflection\Php\BuiltinMethodReflection $reflection, ReflectionProvider $reflectionProvider, Parser $parser, FunctionCallStatementFinder $functionCallStatementFinder, Cache $cache, TemplateTypeMap $templateTypeMap, array $phpDocParameterTypes, ?Type $phpDocReturnType, ?Type $phpDocThrowType, ?string $deprecatedDescription, bool $isDeprecated, bool $isInternal, bool $isFinal, ?bool $isPure, Assertions $asserts, bool $acceptsNamedArguments, ?Type $selfOutType, ?string $phpDocComment, array $phpDocParameterOutTypes, array $immediatelyInvokedCallableParameters, array $phpDocClosureThisTypeParameters) { $this->initializerExprTypeResolver = $initializerExprTypeResolver; $this->declaringClass = $declaringClass; $this->declaringTrait = $declaringTrait; $this->reflection = $reflection; $this->reflectionProvider = $reflectionProvider; $this->parser = $parser; $this->functionCallStatementFinder = $functionCallStatementFinder; $this->cache = $cache; $this->templateTypeMap = $templateTypeMap; $this->phpDocParameterTypes = $phpDocParameterTypes; $this->phpDocReturnType = $phpDocReturnType; $this->phpDocThrowType = $phpDocThrowType; $this->deprecatedDescription = $deprecatedDescription; $this->isDeprecated = $isDeprecated; $this->isInternal = $isInternal; $this->isFinal = $isFinal; $this->isPure = $isPure; $this->asserts = $asserts; $this->acceptsNamedArguments = $acceptsNamedArguments; $this->selfOutType = $selfOutType; $this->phpDocComment = $phpDocComment; $this->phpDocParameterOutTypes = $phpDocParameterOutTypes; $this->immediatelyInvokedCallableParameters = $immediatelyInvokedCallableParameters; $this->phpDocClosureThisTypeParameters = $phpDocClosureThisTypeParameters; } public function getDeclaringClass() : ClassReflection { return $this->declaringClass; } public function getDeclaringTrait() : ?ClassReflection { return $this->declaringTrait; } /** * @return self|MethodPrototypeReflection */ public function getPrototype() : ClassMemberReflection { try { $prototypeMethod = $this->reflection->getPrototype(); $prototypeDeclaringClass = $this->declaringClass->getAncestorWithClassName($prototypeMethod->getDeclaringClass()->getName()); if ($prototypeDeclaringClass === null) { $prototypeDeclaringClass = $this->reflectionProvider->getClass($prototypeMethod->getDeclaringClass()->getName()); } if (!$prototypeDeclaringClass->hasNativeMethod($prototypeMethod->getName())) { return $this; } $tentativeReturnType = null; if ($prototypeMethod->getTentativeReturnType() !== null) { $tentativeReturnType = TypehintHelper::decideTypeFromReflection($prototypeMethod->getTentativeReturnType()); } return new MethodPrototypeReflection($prototypeMethod->getName(), $prototypeDeclaringClass, $prototypeMethod->isStatic(), $prototypeMethod->isPrivate(), $prototypeMethod->isPublic(), $prototypeMethod->isAbstract(), $prototypeMethod->isFinal(), $prototypeMethod->isInternal(), $prototypeDeclaringClass->getNativeMethod($prototypeMethod->getName())->getVariants(), $tentativeReturnType); } catch (ReflectionException $e) { return $this; } } public function isStatic() : bool { return $this->reflection->isStatic(); } public function getName() : string { $name = $this->reflection->getName(); $lowercaseName = strtolower($name); if ($lowercaseName === $name) { if (PHP_VERSION_ID >= 80000) { return $name; } // fix for https://bugs.php.net/bug.php?id=74939 foreach ($this->getDeclaringClass()->getNativeReflection()->getTraitAliases() as $traitTarget) { $correctName = $this->getMethodNameWithCorrectCase($name, $traitTarget); if ($correctName !== null) { $name = $correctName; break; } } } return $name; } private function getMethodNameWithCorrectCase(string $lowercaseMethodName, string $traitTarget) : ?string { $trait = explode('::', $traitTarget)[0]; $traitReflection = $this->reflectionProvider->getClass($trait)->getNativeReflection(); foreach ($traitReflection->getTraitAliases() as $methodAlias => $aliasTraitTarget) { if ($lowercaseMethodName === strtolower($methodAlias)) { return $methodAlias; } $correctName = $this->getMethodNameWithCorrectCase($lowercaseMethodName, $aliasTraitTarget); if ($correctName !== null) { return $correctName; } } return null; } /** * @return ParametersAcceptorWithPhpDocs[] */ public function getVariants() : array { if ($this->variants === null) { $this->variants = [new FunctionVariantWithPhpDocs($this->templateTypeMap, null, $this->getParameters(), $this->isVariadic(), $this->getReturnType(), $this->getPhpDocReturnType(), $this->getNativeReturnType())]; } return $this->variants; } public function getOnlyVariant() : ParametersAcceptorWithPhpDocs { return $this->getVariants()[0]; } public function getNamedArgumentsVariants() : ?array { return null; } /** * @return ParameterReflectionWithPhpDocs[] */ private function getParameters() : array { if ($this->parameters === null) { $this->parameters = array_map(function (ReflectionParameter $reflection) : \PHPStan\Reflection\Php\PhpParameterReflection { return new \PHPStan\Reflection\Php\PhpParameterReflection($this->initializerExprTypeResolver, $reflection, $this->phpDocParameterTypes[$reflection->getName()] ?? null, $this->getDeclaringClass()->getName(), $this->phpDocParameterOutTypes[$reflection->getName()] ?? null, $this->immediatelyInvokedCallableParameters[$reflection->getName()] ?? TrinaryLogic::createMaybe(), $this->phpDocClosureThisTypeParameters[$reflection->getName()] ?? null); }, $this->reflection->getParameters()); } return $this->parameters; } private function isVariadic() : bool { $isNativelyVariadic = $this->reflection->isVariadic(); $declaringClass = $this->declaringClass; $filename = $this->declaringClass->getFileName(); if ($this->declaringTrait !== null) { $declaringClass = $this->declaringTrait; $filename = $this->declaringTrait->getFileName(); } if (!$isNativelyVariadic && $filename !== null) { $modifiedTime = @filemtime($filename); if ($modifiedTime === \false) { $modifiedTime = time(); } $key = sprintf('variadic-method-%s-%s-%s', $declaringClass->getName(), $this->reflection->getName(), $filename); $variableCacheKey = sprintf('%d-v4', $modifiedTime); $cachedResult = $this->cache->load($key, $variableCacheKey); if ($cachedResult === null || !is_bool($cachedResult)) { $nodes = $this->parser->parseFile($filename); $result = $this->callsFuncGetArgs($declaringClass, $nodes); $this->cache->save($key, $variableCacheKey, $result); return $result; } return $cachedResult; } return $isNativelyVariadic; } /** * @param Node[] $nodes */ private function callsFuncGetArgs(ClassReflection $declaringClass, array $nodes) : bool { foreach ($nodes as $node) { if ($node instanceof Node\Stmt\ClassLike) { if (!isset($node->namespacedName)) { continue; } if ($declaringClass->getName() !== (string) $node->namespacedName) { continue; } if ($this->callsFuncGetArgs($declaringClass, $node->stmts)) { return \true; } continue; } if ($node instanceof ClassMethod) { if ($node->getStmts() === null) { continue; // interface } $methodName = $node->name->name; if ($methodName === $this->reflection->getName()) { return $this->functionCallStatementFinder->findFunctionCallInStatements(ParametersAcceptor::VARIADIC_FUNCTIONS, $node->getStmts()) !== null; } continue; } if ($node instanceof Function_) { continue; } if ($node instanceof Namespace_) { if ($this->callsFuncGetArgs($declaringClass, $node->stmts)) { return \true; } continue; } if (!$node instanceof Declare_ || $node->stmts === null) { continue; } if ($this->callsFuncGetArgs($declaringClass, $node->stmts)) { return \true; } } return \false; } public function isPrivate() : bool { return $this->reflection->isPrivate(); } public function isPublic() : bool { return $this->reflection->isPublic(); } private function getReturnType() : Type { if ($this->returnType === null) { $name = strtolower($this->getName()); $returnType = $this->reflection->getReturnType(); if ($returnType === null) { if (in_array($name, ['__construct', '__destruct', '__unset', '__wakeup', '__clone'], \true)) { return $this->returnType = TypehintHelper::decideType(new VoidType(), $this->phpDocReturnType); } if ($name === '__tostring') { return $this->returnType = TypehintHelper::decideType(new StringType(), $this->phpDocReturnType); } if ($name === '__isset') { return $this->returnType = TypehintHelper::decideType(new BooleanType(), $this->phpDocReturnType); } if ($name === '__sleep') { return $this->returnType = TypehintHelper::decideType(new ArrayType(new IntegerType(), new StringType()), $this->phpDocReturnType); } if ($name === '__set_state') { return $this->returnType = TypehintHelper::decideType(new ObjectWithoutClassType(), $this->phpDocReturnType); } } $this->returnType = TypehintHelper::decideTypeFromReflection($returnType, $this->phpDocReturnType, $this->declaringClass); } return $this->returnType; } private function getPhpDocReturnType() : Type { if ($this->phpDocReturnType !== null) { return $this->phpDocReturnType; } return new MixedType(); } private function getNativeReturnType() : Type { if ($this->nativeReturnType === null) { $this->nativeReturnType = TypehintHelper::decideTypeFromReflection($this->reflection->getReturnType(), null, $this->declaringClass); } return $this->nativeReturnType; } public function getDeprecatedDescription() : ?string { if ($this->isDeprecated) { return $this->deprecatedDescription; } return null; } public function isDeprecated() : TrinaryLogic { if ($this->isDeprecated) { return TrinaryLogic::createYes(); } return $this->reflection->isDeprecated(); } public function isInternal() : TrinaryLogic { return TrinaryLogic::createFromBoolean($this->isInternal || $this->reflection->isInternal()); } public function isFinal() : TrinaryLogic { return TrinaryLogic::createFromBoolean($this->isFinal || $this->reflection->isFinal()); } public function isFinalByKeyword() : TrinaryLogic { return TrinaryLogic::createFromBoolean($this->reflection->isFinal()); } public function isAbstract() : bool { return $this->reflection->isAbstract(); } public function getThrowType() : ?Type { return $this->phpDocThrowType; } public function hasSideEffects() : TrinaryLogic { if (strtolower($this->getName()) !== '__construct' && $this->getReturnType()->isVoid()->yes()) { return TrinaryLogic::createYes(); } if ($this->isPure !== null) { return TrinaryLogic::createFromBoolean(!$this->isPure); } if ((new ThisType($this->declaringClass))->isSuperTypeOf($this->getReturnType())->yes()) { return TrinaryLogic::createYes(); } return TrinaryLogic::createMaybe(); } public function getAsserts() : Assertions { return $this->asserts; } public function acceptsNamedArguments() : bool { return $this->declaringClass->acceptsNamedArguments() && $this->acceptsNamedArguments; } public function getSelfOutType() : ?Type { return $this->selfOutType; } public function getDocComment() : ?string { return $this->phpDocComment; } public function returnsByReference() : TrinaryLogic { return $this->reflection->returnsByReference(); } public function isPure() : TrinaryLogic { if ($this->isPure === null) { return TrinaryLogic::createMaybe(); } return TrinaryLogic::createFromBoolean($this->isPure); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Php; use PHPStan\Reflection\Annotations\AnnotationsPropertiesClassReflectionExtension; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\PropertiesClassReflectionExtension; use PHPStan\Reflection\PropertyReflection; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Type\MixedType; final class UniversalObjectCratesClassReflectionExtension implements PropertiesClassReflectionExtension { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var string[] */ private $classes; /** * @var AnnotationsPropertiesClassReflectionExtension */ private $annotationClassReflection; /** * @param string[] $classes */ public function __construct(ReflectionProvider $reflectionProvider, array $classes, AnnotationsPropertiesClassReflectionExtension $annotationClassReflection) { $this->reflectionProvider = $reflectionProvider; $this->classes = $classes; $this->annotationClassReflection = $annotationClassReflection; } public function hasProperty(ClassReflection $classReflection, string $propertyName) : bool { return self::isUniversalObjectCrate($this->reflectionProvider, $this->classes, $classReflection); } /** * @param string[] $classes */ public static function isUniversalObjectCrate(ReflectionProvider $reflectionProvider, array $classes, ClassReflection $classReflection) : bool { foreach ($classes as $className) { if (!$reflectionProvider->hasClass($className)) { continue; } if ($classReflection->getName() === $className || $classReflection->isSubclassOf($className)) { return \true; } } return \false; } public function getProperty(ClassReflection $classReflection, string $propertyName) : PropertyReflection { if ($this->annotationClassReflection->hasProperty($classReflection, $propertyName)) { return $this->annotationClassReflection->getProperty($classReflection, $propertyName); } if ($classReflection->hasNativeMethod('__get')) { $readableType = $classReflection->getNativeMethod('__get')->getOnlyVariant()->getReturnType(); } else { $readableType = new MixedType(); } if ($classReflection->hasNativeMethod('__set')) { $writableType = $classReflection->getNativeMethod('__set')->getOnlyVariant()->getParameters()[1]->getType(); } else { $writableType = new MixedType(); } return new \PHPStan\Reflection\Php\UniversalObjectCrateProperty($classReflection, $readableType, $writableType); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Php; use PhpParser\Node; use PhpParser\Node\Stmt\Class_; use PhpParser\Node\Stmt\ClassMethod; use PhpParser\Node\Stmt\Declare_; use PhpParser\Node\Stmt\Namespace_; use PHPStan\Analyser\NodeScopeResolver; use PHPStan\Analyser\ScopeContext; use PHPStan\Analyser\ScopeFactory; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionParameter; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionProperty; use PHPStan\Parser\Parser; use PHPStan\PhpDoc\PhpDocInheritanceResolver; use PHPStan\PhpDoc\ResolvedPhpDocBlock; use PHPStan\PhpDoc\StubPhpDocProvider; use PHPStan\Reflection\Annotations\AnnotationsMethodsClassReflectionExtension; use PHPStan\Reflection\Annotations\AnnotationsPropertiesClassReflectionExtension; use PHPStan\Reflection\Assertions; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\ExtendedPropertyReflection; use PHPStan\Reflection\FunctionVariantWithPhpDocs; use PHPStan\Reflection\MethodReflection; use PHPStan\Reflection\MethodsClassReflectionExtension; use PHPStan\Reflection\Native\NativeMethodReflection; use PHPStan\Reflection\Native\NativeParameterWithPhpDocsReflection; use PHPStan\Reflection\PropertiesClassReflectionExtension; use PHPStan\Reflection\PropertyReflection; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Reflection\SignatureMap\FunctionSignature; use PHPStan\Reflection\SignatureMap\ParameterSignature; use PHPStan\Reflection\SignatureMap\SignatureMapProvider; use PHPStan\ShouldNotHappenException; use PHPStan\TrinaryLogic; use PHPStan\Type\ArrayType; use PHPStan\Type\Constant\ConstantArrayTypeBuilder; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\Enum\EnumCaseObjectType; use PHPStan\Type\ErrorType; use PHPStan\Type\FileTypeMapper; use PHPStan\Type\GeneralizePrecision; use PHPStan\Type\Generic\TemplateTypeHelper; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\Generic\TemplateTypeVariance; use PHPStan\Type\MixedType; use PHPStan\Type\NeverType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\TypehintHelper; use function array_key_exists; use function array_keys; use function array_map; use function array_slice; use function count; use function explode; use function implode; use function is_array; use function sprintf; use function strtolower; final class PhpClassReflectionExtension implements PropertiesClassReflectionExtension, MethodsClassReflectionExtension { /** * @var ScopeFactory */ private $scopeFactory; /** * @var NodeScopeResolver */ private $nodeScopeResolver; /** * @var PhpMethodReflectionFactory */ private $methodReflectionFactory; /** * @var PhpDocInheritanceResolver */ private $phpDocInheritanceResolver; /** * @var AnnotationsMethodsClassReflectionExtension */ private $annotationsMethodsClassReflectionExtension; /** * @var AnnotationsPropertiesClassReflectionExtension */ private $annotationsPropertiesClassReflectionExtension; /** * @var SignatureMapProvider */ private $signatureMapProvider; /** * @var Parser */ private $parser; /** * @var StubPhpDocProvider */ private $stubPhpDocProvider; /** * @var ReflectionProvider\ReflectionProviderProvider */ private $reflectionProviderProvider; /** * @var FileTypeMapper */ private $fileTypeMapper; /** * @var bool */ private $inferPrivatePropertyTypeFromConstructor; /** @var ExtendedPropertyReflection[][] */ private $propertiesIncludingAnnotations = []; /** @var PhpPropertyReflection[][] */ private $nativeProperties = []; /** @var ExtendedMethodReflection[][] */ private $methodsIncludingAnnotations = []; /** @var ExtendedMethodReflection[][] */ private $nativeMethods = []; /** @var array<string, array<string, Type>> */ private $propertyTypesCache = []; /** @var array<string, true> */ private $inferClassConstructorPropertyTypesInProcess = []; public function __construct(ScopeFactory $scopeFactory, NodeScopeResolver $nodeScopeResolver, \PHPStan\Reflection\Php\PhpMethodReflectionFactory $methodReflectionFactory, PhpDocInheritanceResolver $phpDocInheritanceResolver, AnnotationsMethodsClassReflectionExtension $annotationsMethodsClassReflectionExtension, AnnotationsPropertiesClassReflectionExtension $annotationsPropertiesClassReflectionExtension, SignatureMapProvider $signatureMapProvider, Parser $parser, StubPhpDocProvider $stubPhpDocProvider, ReflectionProvider\ReflectionProviderProvider $reflectionProviderProvider, FileTypeMapper $fileTypeMapper, bool $inferPrivatePropertyTypeFromConstructor) { $this->scopeFactory = $scopeFactory; $this->nodeScopeResolver = $nodeScopeResolver; $this->methodReflectionFactory = $methodReflectionFactory; $this->phpDocInheritanceResolver = $phpDocInheritanceResolver; $this->annotationsMethodsClassReflectionExtension = $annotationsMethodsClassReflectionExtension; $this->annotationsPropertiesClassReflectionExtension = $annotationsPropertiesClassReflectionExtension; $this->signatureMapProvider = $signatureMapProvider; $this->parser = $parser; $this->stubPhpDocProvider = $stubPhpDocProvider; $this->reflectionProviderProvider = $reflectionProviderProvider; $this->fileTypeMapper = $fileTypeMapper; $this->inferPrivatePropertyTypeFromConstructor = $inferPrivatePropertyTypeFromConstructor; } public function evictPrivateSymbols(string $classCacheKey) : void { foreach ($this->propertiesIncludingAnnotations as $key => $properties) { if ($key !== $classCacheKey) { continue; } foreach ($properties as $name => $property) { if (!$property->isPrivate()) { continue; } unset($this->propertiesIncludingAnnotations[$key][$name]); } } foreach ($this->nativeProperties as $key => $properties) { if ($key !== $classCacheKey) { continue; } foreach ($properties as $name => $property) { if (!$property->isPrivate()) { continue; } unset($this->nativeProperties[$key][$name]); } } foreach ($this->methodsIncludingAnnotations as $key => $methods) { if ($key !== $classCacheKey) { continue; } foreach ($methods as $name => $method) { if (!$method->isPrivate()) { continue; } unset($this->methodsIncludingAnnotations[$key][$name]); } } foreach ($this->nativeMethods as $key => $methods) { if ($key !== $classCacheKey) { continue; } foreach ($methods as $name => $method) { if (!$method->isPrivate()) { continue; } unset($this->nativeMethods[$key][$name]); } } } public function hasProperty(ClassReflection $classReflection, string $propertyName) : bool { return $classReflection->getNativeReflection()->hasProperty($propertyName); } /** * @return ExtendedPropertyReflection */ public function getProperty(ClassReflection $classReflection, string $propertyName) : PropertyReflection { if (!isset($this->propertiesIncludingAnnotations[$classReflection->getCacheKey()][$propertyName])) { $this->propertiesIncludingAnnotations[$classReflection->getCacheKey()][$propertyName] = $this->createProperty($classReflection, $propertyName, \true); } return $this->propertiesIncludingAnnotations[$classReflection->getCacheKey()][$propertyName]; } public function getNativeProperty(ClassReflection $classReflection, string $propertyName) : \PHPStan\Reflection\Php\PhpPropertyReflection { if (!isset($this->nativeProperties[$classReflection->getCacheKey()][$propertyName])) { /** @var PhpPropertyReflection $property */ $property = $this->createProperty($classReflection, $propertyName, \false); $this->nativeProperties[$classReflection->getCacheKey()][$propertyName] = $property; } return $this->nativeProperties[$classReflection->getCacheKey()][$propertyName]; } private function createProperty(ClassReflection $classReflection, string $propertyName, bool $includingAnnotations) : ExtendedPropertyReflection { $propertyReflection = $classReflection->getNativeReflection()->getProperty($propertyName); $propertyName = $propertyReflection->getName(); $declaringClassName = $propertyReflection->getDeclaringClass()->getName(); $declaringClassReflection = $classReflection->getAncestorWithClassName($declaringClassName); if ($declaringClassReflection === null) { throw new ShouldNotHappenException(sprintf('Internal error: Expected to find an ancestor with class name %s on %s, but none was found.', $declaringClassName, $classReflection->getName())); } if ($declaringClassReflection->isEnum()) { if ($propertyName === 'name' || $declaringClassReflection->isBackedEnum() && $propertyName === 'value') { $types = []; foreach (array_keys($classReflection->getEnumCases()) as $name) { if ($propertyName === 'name') { $types[] = new ConstantStringType($name); continue; } $case = $classReflection->getEnumCase($name); $value = $case->getBackingValueType(); if ($value === null) { throw new ShouldNotHappenException(); } $types[] = $value; } return new \PHPStan\Reflection\Php\PhpPropertyReflection($declaringClassReflection, null, null, TypeCombinator::union(...$types), $classReflection->getNativeReflection()->getProperty($propertyName), null, \false, \false, \false, \false); } } $deprecatedDescription = null; $isDeprecated = \false; $isInternal = \false; $isReadOnlyByPhpDoc = $classReflection->isImmutable(); $isAllowedPrivateMutation = \false; if ($includingAnnotations && !$declaringClassReflection->isEnum() && $this->annotationsPropertiesClassReflectionExtension->hasProperty($classReflection, $propertyName)) { $hierarchyDistances = $classReflection->getClassHierarchyDistances(); $annotationProperty = $this->annotationsPropertiesClassReflectionExtension->getProperty($classReflection, $propertyName); if (!isset($hierarchyDistances[$annotationProperty->getDeclaringClass()->getName()])) { throw new ShouldNotHappenException(); } $distanceDeclaringClass = $propertyReflection->getDeclaringClass()->getName(); $propertyTrait = $this->findPropertyTrait($propertyReflection); if ($propertyTrait !== null) { $distanceDeclaringClass = $propertyTrait; } if (!isset($hierarchyDistances[$distanceDeclaringClass])) { throw new ShouldNotHappenException(); } if ($hierarchyDistances[$annotationProperty->getDeclaringClass()->getName()] <= $hierarchyDistances[$distanceDeclaringClass]) { return $annotationProperty; } } $docComment = $propertyReflection->getDocComment() !== \false ? $propertyReflection->getDocComment() : null; $phpDocType = null; $resolvedPhpDoc = null; $declaringTraitName = $this->findPropertyTrait($propertyReflection); $constructorName = null; if ($propertyReflection->isPromoted()) { if ($declaringClassReflection->hasConstructor()) { $constructorName = $declaringClassReflection->getConstructor()->getName(); } } if ($constructorName === null) { $resolvedPhpDoc = $this->phpDocInheritanceResolver->resolvePhpDocForProperty($docComment, $declaringClassReflection, $declaringClassReflection->getFileName(), $declaringTraitName, $propertyName); } elseif ($docComment !== null) { $resolvedPhpDoc = $this->fileTypeMapper->getResolvedPhpDoc($declaringClassReflection->getFileName(), $declaringClassName, $declaringTraitName, $constructorName, $docComment); } $phpDocBlockClassReflection = $declaringClassReflection; if ($resolvedPhpDoc !== null) { $varTags = $resolvedPhpDoc->getVarTags(); if (isset($varTags[0]) && count($varTags) === 1) { $phpDocType = $varTags[0]->getType(); } elseif (isset($varTags[$propertyName])) { $phpDocType = $varTags[$propertyName]->getType(); } $phpDocType = $phpDocType !== null ? TemplateTypeHelper::resolveTemplateTypes($phpDocType, $phpDocBlockClassReflection->getActiveTemplateTypeMap(), $phpDocBlockClassReflection->getCallSiteVarianceMap(), TemplateTypeVariance::createInvariant()) : null; $deprecatedDescription = $resolvedPhpDoc->getDeprecatedTag() !== null ? $resolvedPhpDoc->getDeprecatedTag()->getMessage() : null; $isDeprecated = $resolvedPhpDoc->isDeprecated(); $isInternal = $resolvedPhpDoc->isInternal(); $isReadOnlyByPhpDoc = $isReadOnlyByPhpDoc || $resolvedPhpDoc->isReadOnly(); $isAllowedPrivateMutation = $resolvedPhpDoc->isAllowedPrivateMutation(); } if ($phpDocType === null) { if (isset($constructorName)) { $constructorDocComment = $declaringClassReflection->getConstructor()->getDocComment(); $nativeClassReflection = $declaringClassReflection->getNativeReflection(); $positionalParameterNames = []; if ($nativeClassReflection->getConstructor() !== null) { $positionalParameterNames = array_map(static function (ReflectionParameter $parameter) : string { return $parameter->getName(); }, $nativeClassReflection->getConstructor()->getParameters()); } $resolvedConstructorPhpDoc = $this->phpDocInheritanceResolver->resolvePhpDocForMethod($constructorDocComment, $declaringClassReflection->getFileName(), $declaringClassReflection, $declaringTraitName, $constructorName, $positionalParameterNames); $paramTags = $resolvedConstructorPhpDoc->getParamTags(); if (isset($paramTags[$propertyReflection->getName()])) { $phpDocType = $paramTags[$propertyReflection->getName()]->getType(); } } } if ($phpDocType === null && $this->inferPrivatePropertyTypeFromConstructor && $declaringClassReflection->getFileName() !== null && $propertyReflection->isPrivate() && !$propertyReflection->isPromoted() && !$propertyReflection->hasType() && $declaringClassReflection->hasConstructor() && $declaringClassReflection->getConstructor()->getDeclaringClass()->getName() === $declaringClassReflection->getName()) { $phpDocType = $this->inferPrivatePropertyType($propertyReflection->getName(), $declaringClassReflection->getConstructor()); } $nativeType = null; if ($propertyReflection->getType() !== null) { $nativeType = $propertyReflection->getType(); } $declaringTrait = null; $reflectionProvider = $this->reflectionProviderProvider->getReflectionProvider(); if ($declaringTraitName !== null && $reflectionProvider->hasClass($declaringTraitName)) { $declaringTrait = $reflectionProvider->getClass($declaringTraitName); } return new \PHPStan\Reflection\Php\PhpPropertyReflection($declaringClassReflection, $declaringTrait, $nativeType, $phpDocType, $propertyReflection, $deprecatedDescription, $isDeprecated, $isInternal, $isReadOnlyByPhpDoc, $isAllowedPrivateMutation); } public function hasMethod(ClassReflection $classReflection, string $methodName) : bool { return $classReflection->getNativeReflection()->hasMethod($methodName); } /** * @return ExtendedMethodReflection */ public function getMethod(ClassReflection $classReflection, string $methodName) : MethodReflection { if (isset($this->methodsIncludingAnnotations[$classReflection->getCacheKey()][$methodName])) { return $this->methodsIncludingAnnotations[$classReflection->getCacheKey()][$methodName]; } $nativeMethodReflection = new \PHPStan\Reflection\Php\NativeBuiltinMethodReflection($classReflection->getNativeReflection()->getMethod($methodName)); if (!isset($this->methodsIncludingAnnotations[$classReflection->getCacheKey()][$nativeMethodReflection->getName()])) { $method = $this->createMethod($classReflection, $nativeMethodReflection, \true); $this->methodsIncludingAnnotations[$classReflection->getCacheKey()][$nativeMethodReflection->getName()] = $method; if ($nativeMethodReflection->getName() !== $methodName) { $this->methodsIncludingAnnotations[$classReflection->getCacheKey()][$methodName] = $method; } } return $this->methodsIncludingAnnotations[$classReflection->getCacheKey()][$nativeMethodReflection->getName()]; } public function hasNativeMethod(ClassReflection $classReflection, string $methodName) : bool { return $this->hasMethod($classReflection, $methodName); } public function getNativeMethod(ClassReflection $classReflection, string $methodName) : ExtendedMethodReflection { if (isset($this->nativeMethods[$classReflection->getCacheKey()][$methodName])) { return $this->nativeMethods[$classReflection->getCacheKey()][$methodName]; } if (!$classReflection->getNativeReflection()->hasMethod($methodName)) { throw new ShouldNotHappenException(); } $reflectionMethod = $classReflection->getNativeReflection()->getMethod($methodName); $nativeMethodReflection = new \PHPStan\Reflection\Php\NativeBuiltinMethodReflection($reflectionMethod); if (!isset($this->nativeMethods[$classReflection->getCacheKey()][$nativeMethodReflection->getName()])) { $method = $this->createMethod($classReflection, $nativeMethodReflection, \false); $this->nativeMethods[$classReflection->getCacheKey()][$nativeMethodReflection->getName()] = $method; } return $this->nativeMethods[$classReflection->getCacheKey()][$nativeMethodReflection->getName()]; } private function createMethod(ClassReflection $classReflection, \PHPStan\Reflection\Php\BuiltinMethodReflection $methodReflection, bool $includingAnnotations) : ExtendedMethodReflection { if ($includingAnnotations && $this->annotationsMethodsClassReflectionExtension->hasMethod($classReflection, $methodReflection->getName())) { $hierarchyDistances = $classReflection->getClassHierarchyDistances(); $annotationMethod = $this->annotationsMethodsClassReflectionExtension->getMethod($classReflection, $methodReflection->getName()); if (!isset($hierarchyDistances[$annotationMethod->getDeclaringClass()->getName()])) { throw new ShouldNotHappenException(); } $distanceDeclaringClass = $methodReflection->getDeclaringClass()->getName(); $methodTrait = $this->findMethodTrait($methodReflection); if ($methodTrait !== null) { $distanceDeclaringClass = $methodTrait; } if (!isset($hierarchyDistances[$distanceDeclaringClass])) { throw new ShouldNotHappenException(); } if ($hierarchyDistances[$annotationMethod->getDeclaringClass()->getName()] <= $hierarchyDistances[$distanceDeclaringClass]) { return $annotationMethod; } } $declaringClassName = $methodReflection->getDeclaringClass()->getName(); $declaringClass = $classReflection->getAncestorWithClassName($declaringClassName); if ($declaringClass === null) { throw new ShouldNotHappenException(sprintf('Internal error: Expected to find an ancestor with class name %s on %s, but none was found.', $declaringClassName, $classReflection->getName())); } if ($declaringClass->isEnum() && $declaringClass->getName() !== 'UnitEnum' && strtolower($methodReflection->getName()) === 'cases') { $arrayBuilder = ConstantArrayTypeBuilder::createEmpty(); foreach (array_keys($classReflection->getEnumCases()) as $name) { $arrayBuilder->setOffsetValueType(null, new EnumCaseObjectType($classReflection->getName(), $name)); } return new \PHPStan\Reflection\Php\EnumCasesMethodReflection($declaringClass, $arrayBuilder->getArray()); } if ($this->signatureMapProvider->hasMethodSignature($declaringClassName, $methodReflection->getName())) { $variantsByType = ['positional' => []]; $reflectionMethod = null; $throwType = null; $asserts = Assertions::createEmpty(); $acceptsNamedArguments = \true; $selfOutType = null; $phpDocComment = null; if ($classReflection->getNativeReflection()->hasMethod($methodReflection->getName())) { $reflectionMethod = $classReflection->getNativeReflection()->getMethod($methodReflection->getName()); } $methodSignaturesResult = $this->signatureMapProvider->getMethodSignatures($declaringClassName, $methodReflection->getName(), $reflectionMethod); foreach ($methodSignaturesResult as $signatureType => $methodSignatures) { if ($methodSignatures === null) { continue; } foreach ($methodSignatures as $methodSignature) { $phpDocParameterNameMapping = []; foreach ($methodSignature->getParameters() as $parameter) { $phpDocParameterNameMapping[$parameter->getName()] = $parameter->getName(); } $stubPhpDocReturnType = null; $stubPhpDocParameterTypes = []; $stubPhpDocParameterVariadicity = []; $phpDocParameterTypes = []; $phpDocReturnType = null; $stubPhpDocPair = null; $stubPhpParameterOutTypes = []; $phpDocParameterOutTypes = []; $immediatelyInvokedCallableParameters = []; $closureThisParameters = []; $stubImmediatelyInvokedCallableParameters = []; $stubClosureThisParameters = []; if (count($methodSignatures) === 1) { $stubPhpDocPair = $this->findMethodPhpDocIncludingAncestors($declaringClass, $declaringClass, $methodReflection->getName(), array_map(static function (ParameterSignature $parameterSignature) : string { return $parameterSignature->getName(); }, $methodSignature->getParameters())); if ($stubPhpDocPair !== null) { [$stubPhpDoc, $stubDeclaringClass] = $stubPhpDocPair; $templateTypeMap = $stubDeclaringClass->getActiveTemplateTypeMap(); $callSiteVarianceMap = $stubDeclaringClass->getCallSiteVarianceMap(); $returnTag = $stubPhpDoc->getReturnTag(); $stubImmediatelyInvokedCallableParameters = array_map(static function (bool $immediate) { return TrinaryLogic::createFromBoolean($immediate); }, $stubPhpDoc->getParamsImmediatelyInvokedCallable()); if ($returnTag !== null) { $stubPhpDocReturnType = TemplateTypeHelper::resolveTemplateTypes($returnTag->getType(), $templateTypeMap, $callSiteVarianceMap, TemplateTypeVariance::createCovariant()); } $stubClosureThisParameters = array_map(static function ($tag) { return $tag->getType(); }, $stubPhpDoc->getParamClosureThisTags()); foreach ($stubPhpDoc->getParamTags() as $name => $paramTag) { $stubPhpDocParameterTypes[$name] = TemplateTypeHelper::resolveTemplateTypes($paramTag->getType(), $templateTypeMap, $callSiteVarianceMap, TemplateTypeVariance::createContravariant()); $stubPhpDocParameterVariadicity[$name] = $paramTag->isVariadic(); } $throwsTag = $stubPhpDoc->getThrowsTag(); if ($throwsTag !== null) { $throwType = $throwsTag->getType(); } $asserts = Assertions::createFromResolvedPhpDocBlock($stubPhpDoc); $acceptsNamedArguments = $stubPhpDoc->acceptsNamedArguments(); $selfOutTypeTag = $stubPhpDoc->getSelfOutTag(); if ($selfOutTypeTag !== null) { $selfOutType = $selfOutTypeTag->getType(); } foreach ($stubPhpDoc->getParamOutTags() as $name => $paramOutTag) { $stubPhpParameterOutTypes[$name] = TemplateTypeHelper::resolveTemplateTypes($paramOutTag->getType(), $templateTypeMap, $callSiteVarianceMap, TemplateTypeVariance::createCovariant()); } if ($declaringClassName === $stubDeclaringClass->getName() && $stubPhpDoc->hasPhpDocString()) { $phpDocComment = $stubPhpDoc->getPhpDocString(); } } } if ($stubPhpDocPair === null && $reflectionMethod !== null && $reflectionMethod->getDocComment() !== \false) { $filename = $reflectionMethod->getFileName(); if ($filename !== \false) { $phpDocBlock = $this->fileTypeMapper->getResolvedPhpDoc($filename, $declaringClassName, null, $reflectionMethod->getName(), $reflectionMethod->getDocComment()); $throwsTag = $phpDocBlock->getThrowsTag(); if ($throwsTag !== null) { $throwType = $throwsTag->getType(); } $returnTag = $phpDocBlock->getReturnTag(); if ($returnTag !== null && count($methodSignatures) === 1) { $phpDocReturnType = $returnTag->getType(); } $immediatelyInvokedCallableParameters = array_map(static function ($immediate) { return TrinaryLogic::createFromBoolean($immediate); }, $phpDocBlock->getParamsImmediatelyInvokedCallable()); $closureThisParameters = array_map(static function ($tag) { return $tag->getType(); }, $phpDocBlock->getParamClosureThisTags()); foreach ($phpDocBlock->getParamTags() as $name => $paramTag) { $phpDocParameterTypes[$name] = $paramTag->getType(); } $asserts = Assertions::createFromResolvedPhpDocBlock($phpDocBlock); $acceptsNamedArguments = $phpDocBlock->acceptsNamedArguments(); $selfOutTypeTag = $phpDocBlock->getSelfOutTag(); if ($selfOutTypeTag !== null) { $selfOutType = $selfOutTypeTag->getType(); } if ($phpDocBlock->hasPhpDocString()) { $phpDocComment = $phpDocBlock->getPhpDocString(); } foreach ($phpDocBlock->getParamOutTags() as $name => $paramOutTag) { $phpDocParameterOutTypes[$name] = $paramOutTag->getType(); } $signatureParameters = $methodSignature->getParameters(); foreach ($reflectionMethod->getParameters() as $paramI => $reflectionParameter) { if (!array_key_exists($paramI, $signatureParameters)) { continue; } $phpDocParameterNameMapping[$signatureParameters[$paramI]->getName()] = $reflectionParameter->getName(); } } } $variantsByType[$signatureType][] = $this->createNativeMethodVariant($methodSignature, $stubPhpDocParameterTypes, $stubPhpDocParameterVariadicity, $stubPhpDocReturnType, $phpDocParameterTypes, $phpDocReturnType, $phpDocParameterNameMapping, $stubPhpParameterOutTypes, $phpDocParameterOutTypes, $stubImmediatelyInvokedCallableParameters, $immediatelyInvokedCallableParameters, $stubClosureThisParameters, $closureThisParameters, $signatureType !== 'named'); } } if ($this->signatureMapProvider->hasMethodMetadata($declaringClassName, $methodReflection->getName())) { $hasSideEffects = TrinaryLogic::createFromBoolean($this->signatureMapProvider->getMethodMetadata($declaringClassName, $methodReflection->getName())['hasSideEffects']); } else { $hasSideEffects = TrinaryLogic::createMaybe(); } return new NativeMethodReflection($this->reflectionProviderProvider->getReflectionProvider(), $declaringClass, $methodReflection, $variantsByType['positional'], $variantsByType['named'] ?? null, $hasSideEffects, $throwType, $asserts, $acceptsNamedArguments, $selfOutType, $phpDocComment); } return $this->createUserlandMethodReflection($declaringClass, $declaringClass, $methodReflection, $this->findMethodTrait($methodReflection)); } public function createUserlandMethodReflection(ClassReflection $fileDeclaringClass, ClassReflection $actualDeclaringClass, \PHPStan\Reflection\Php\BuiltinMethodReflection $methodReflection, ?string $declaringTraitName) : \PHPStan\Reflection\Php\PhpMethodReflection { $resolvedPhpDoc = null; $stubPhpDocPair = $this->findMethodPhpDocIncludingAncestors($fileDeclaringClass, $fileDeclaringClass, $methodReflection->getName(), array_map(static function (ReflectionParameter $parameter) : string { return $parameter->getName(); }, $methodReflection->getParameters())); $phpDocBlockClassReflection = $fileDeclaringClass; if ($methodReflection->getReflection() !== null) { $methodDeclaringClass = $methodReflection->getReflection()->getBetterReflection()->getDeclaringClass(); if ($stubPhpDocPair === null && $methodDeclaringClass->isTrait()) { if (!$methodReflection->getDeclaringClass()->isTrait() || $methodDeclaringClass->getName() !== $methodReflection->getDeclaringClass()->getName()) { $stubPhpDocPair = $this->findMethodPhpDocIncludingAncestors($this->reflectionProviderProvider->getReflectionProvider()->getClass($methodDeclaringClass->getName()), $this->reflectionProviderProvider->getReflectionProvider()->getClass($methodReflection->getDeclaringClass()->getName()), $methodReflection->getName(), array_map(static function (ReflectionParameter $parameter) : string { return $parameter->getName(); }, $methodReflection->getParameters())); } } } if ($stubPhpDocPair !== null) { [$resolvedPhpDoc, $phpDocBlockClassReflection] = $stubPhpDocPair; } if ($resolvedPhpDoc === null) { $docComment = $methodReflection->getDocComment(); $positionalParameterNames = array_map(static function (ReflectionParameter $parameter) : string { return $parameter->getName(); }, $methodReflection->getParameters()); $resolvedPhpDoc = $this->phpDocInheritanceResolver->resolvePhpDocForMethod($docComment, $actualDeclaringClass->getFileName(), $actualDeclaringClass, $declaringTraitName, $methodReflection->getName(), $positionalParameterNames); $phpDocBlockClassReflection = $fileDeclaringClass; } $declaringTrait = null; $reflectionProvider = $this->reflectionProviderProvider->getReflectionProvider(); if ($declaringTraitName !== null && $reflectionProvider->hasClass($declaringTraitName)) { $declaringTrait = $reflectionProvider->getClass($declaringTraitName); } $phpDocParameterTypes = []; if ($methodReflection instanceof \PHPStan\Reflection\Php\NativeBuiltinMethodReflection && $methodReflection->isConstructor()) { foreach ($methodReflection->getParameters() as $parameter) { if (!$parameter->isPromoted()) { continue; } if (!$methodReflection->getDeclaringClass()->hasProperty($parameter->getName())) { continue; } $parameterProperty = $methodReflection->getDeclaringClass()->getProperty($parameter->getName()); if (!$parameterProperty->isPromoted()) { continue; } if ($parameterProperty->getDocComment() === \false) { continue; } $propertyDocblock = $this->fileTypeMapper->getResolvedPhpDoc($fileDeclaringClass->getFileName(), $fileDeclaringClass->getName(), $declaringTraitName, $methodReflection->getName(), $parameterProperty->getDocComment()); $varTags = $propertyDocblock->getVarTags(); if (isset($varTags[0]) && count($varTags) === 1) { $phpDocType = $varTags[0]->getType(); } elseif (isset($varTags[$parameter->getName()])) { $phpDocType = $varTags[$parameter->getName()]->getType(); } else { continue; } $phpDocParameterTypes[$parameter->getName()] = $phpDocType; } } $templateTypeMap = $resolvedPhpDoc->getTemplateTypeMap(); $immediatelyInvokedCallableParameters = array_map(static function (bool $immediate) { return TrinaryLogic::createFromBoolean($immediate); }, $resolvedPhpDoc->getParamsImmediatelyInvokedCallable()); $closureThisParameters = array_map(static function ($tag) { return $tag->getType(); }, $resolvedPhpDoc->getParamClosureThisTags()); foreach ($resolvedPhpDoc->getParamTags() as $paramName => $paramTag) { if (array_key_exists($paramName, $phpDocParameterTypes)) { continue; } $phpDocParameterTypes[$paramName] = $paramTag->getType(); } foreach ($phpDocParameterTypes as $paramName => $paramType) { $phpDocParameterTypes[$paramName] = TemplateTypeHelper::resolveTemplateTypes($paramType, $phpDocBlockClassReflection->getActiveTemplateTypeMap(), $phpDocBlockClassReflection->getCallSiteVarianceMap(), TemplateTypeVariance::createContravariant()); } $phpDocParameterOutTypes = []; foreach ($resolvedPhpDoc->getParamOutTags() as $paramName => $paramOutTag) { $phpDocParameterOutTypes[$paramName] = TemplateTypeHelper::resolveTemplateTypes($paramOutTag->getType(), $phpDocBlockClassReflection->getActiveTemplateTypeMap(), $phpDocBlockClassReflection->getCallSiteVarianceMap(), TemplateTypeVariance::createCovariant()); } $nativeReturnType = TypehintHelper::decideTypeFromReflection($methodReflection->getReturnType(), null, $actualDeclaringClass); $phpDocReturnType = $this->getPhpDocReturnType($phpDocBlockClassReflection, $resolvedPhpDoc, $nativeReturnType); $phpDocThrowType = $resolvedPhpDoc->getThrowsTag() !== null ? $resolvedPhpDoc->getThrowsTag()->getType() : null; $deprecatedDescription = $resolvedPhpDoc->getDeprecatedTag() !== null ? $resolvedPhpDoc->getDeprecatedTag()->getMessage() : null; $isDeprecated = $resolvedPhpDoc->isDeprecated(); $isInternal = $resolvedPhpDoc->isInternal(); $isFinal = $resolvedPhpDoc->isFinal(); $isPure = $resolvedPhpDoc->isPure(); $asserts = Assertions::createFromResolvedPhpDocBlock($resolvedPhpDoc); $acceptsNamedArguments = $resolvedPhpDoc->acceptsNamedArguments(); $selfOutType = $resolvedPhpDoc->getSelfOutTag() !== null ? $resolvedPhpDoc->getSelfOutTag()->getType() : null; $phpDocComment = null; if ($resolvedPhpDoc->hasPhpDocString()) { $phpDocComment = $resolvedPhpDoc->getPhpDocString(); } return $this->methodReflectionFactory->create($actualDeclaringClass, $declaringTrait, $methodReflection, $templateTypeMap, $phpDocParameterTypes, $phpDocReturnType, $phpDocThrowType, $deprecatedDescription, $isDeprecated, $isInternal, $isFinal, $isPure, $asserts, $selfOutType, $phpDocComment, $phpDocParameterOutTypes, $immediatelyInvokedCallableParameters, $closureThisParameters, $acceptsNamedArguments); } /** * @param array<string, Type> $stubPhpDocParameterTypes * @param array<string, bool> $stubPhpDocParameterVariadicity * @param array<string, Type> $phpDocParameterTypes * @param array<string, string> $phpDocParameterNameMapping * @param array<string, Type> $stubPhpDocParameterOutTypes * @param array<string, Type> $phpDocParameterOutTypes * @param array<string, TrinaryLogic> $stubImmediatelyInvokedCallableParameters * @param array<string, TrinaryLogic> $immediatelyInvokedCallableParameters * @param array<string, Type> $stubClosureThisParameters * @param array<string, Type> $closureThisParameters */ private function createNativeMethodVariant(FunctionSignature $methodSignature, array $stubPhpDocParameterTypes, array $stubPhpDocParameterVariadicity, ?Type $stubPhpDocReturnType, array $phpDocParameterTypes, ?Type $phpDocReturnType, array $phpDocParameterNameMapping, array $stubPhpDocParameterOutTypes, array $phpDocParameterOutTypes, array $stubImmediatelyInvokedCallableParameters, array $immediatelyInvokedCallableParameters, array $stubClosureThisParameters, array $closureThisParameters, bool $usePhpDocParameterNames) : FunctionVariantWithPhpDocs { $parameters = []; foreach ($methodSignature->getParameters() as $parameterSignature) { $type = null; $phpDocType = null; $parameterOutType = null; $phpDocParameterName = $phpDocParameterNameMapping[$parameterSignature->getName()] ?? $parameterSignature->getName(); if (isset($stubPhpDocParameterTypes[$parameterSignature->getName()])) { $type = $stubPhpDocParameterTypes[$parameterSignature->getName()]; $phpDocType = $stubPhpDocParameterTypes[$parameterSignature->getName()]; } elseif (isset($phpDocParameterTypes[$phpDocParameterName])) { $phpDocType = $phpDocParameterTypes[$phpDocParameterName]; } if (isset($stubPhpDocParameterOutTypes[$parameterSignature->getName()])) { $parameterOutType = $stubPhpDocParameterOutTypes[$parameterSignature->getName()]; } elseif (isset($phpDocParameterOutTypes[$phpDocParameterName])) { $parameterOutType = $phpDocParameterOutTypes[$phpDocParameterName]; } if (isset($stubImmediatelyInvokedCallableParameters[$parameterSignature->getName()])) { $immediatelyInvoked = $stubImmediatelyInvokedCallableParameters[$parameterSignature->getName()]; } elseif (isset($immediatelyInvokedCallableParameters[$phpDocParameterName])) { $immediatelyInvoked = $immediatelyInvokedCallableParameters[$phpDocParameterName]; } else { $immediatelyInvoked = TrinaryLogic::createMaybe(); } $closureThisType = null; if (isset($stubClosureThisParameters[$parameterSignature->getName()])) { $closureThisType = $stubClosureThisParameters[$parameterSignature->getName()]; } elseif (isset($closureThisParameters[$phpDocParameterName])) { $closureThisType = $closureThisParameters[$phpDocParameterName]; } $parameters[] = new NativeParameterWithPhpDocsReflection($usePhpDocParameterNames ? $phpDocParameterName : $parameterSignature->getName(), $parameterSignature->isOptional(), $type ?? $parameterSignature->getType(), $phpDocType ?? new MixedType(), $parameterSignature->getNativeType(), $parameterSignature->passedByReference(), $stubPhpDocParameterVariadicity[$parameterSignature->getName()] ?? $parameterSignature->isVariadic(), $parameterSignature->getDefaultValue(), $parameterOutType ?? $parameterSignature->getOutType(), $immediatelyInvoked, $closureThisType); } if ($stubPhpDocReturnType !== null) { $returnType = $stubPhpDocReturnType; $phpDocReturnType = $stubPhpDocReturnType; } else { $returnType = TypehintHelper::decideType($methodSignature->getReturnType(), $phpDocReturnType); } return new FunctionVariantWithPhpDocs(TemplateTypeMap::createEmpty(), null, $parameters, $methodSignature->isVariadic(), $returnType, $phpDocReturnType ?? new MixedType(), $methodSignature->getNativeReturnType()); } private function findPropertyTrait(ReflectionProperty $propertyReflection) : ?string { $declaringClass = $propertyReflection->getBetterReflection()->getDeclaringClass(); if ($declaringClass->isTrait()) { if ($propertyReflection->getDeclaringClass()->isTrait() && $propertyReflection->getDeclaringClass()->getName() === $declaringClass->getName()) { return null; } return $declaringClass->getName(); } return null; } private function findMethodTrait(\PHPStan\Reflection\Php\BuiltinMethodReflection $methodReflection) : ?string { if ($methodReflection->getReflection() === null) { return null; } $declaringClass = $methodReflection->getReflection()->getBetterReflection()->getDeclaringClass(); if ($declaringClass->isTrait()) { if ($methodReflection->getDeclaringClass()->isTrait() && $declaringClass->getName() === $methodReflection->getDeclaringClass()->getName()) { return null; } return $declaringClass->getName(); } return null; } private function inferPrivatePropertyType(string $propertyName, MethodReflection $constructor) : ?Type { $declaringClassName = $constructor->getDeclaringClass()->getName(); if (isset($this->inferClassConstructorPropertyTypesInProcess[$declaringClassName])) { return null; } $this->inferClassConstructorPropertyTypesInProcess[$declaringClassName] = \true; $propertyTypes = $this->inferAndCachePropertyTypes($constructor); unset($this->inferClassConstructorPropertyTypesInProcess[$declaringClassName]); if (array_key_exists($propertyName, $propertyTypes)) { return $propertyTypes[$propertyName]; } return null; } /** * @return array<string, Type> */ private function inferAndCachePropertyTypes(MethodReflection $constructor) : array { $declaringClass = $constructor->getDeclaringClass(); if (isset($this->propertyTypesCache[$declaringClass->getName()])) { return $this->propertyTypesCache[$declaringClass->getName()]; } if ($declaringClass->getFileName() === null) { return $this->propertyTypesCache[$declaringClass->getName()] = []; } $fileName = $declaringClass->getFileName(); $nodes = $this->parser->parseFile($fileName); $classNode = $this->findClassNode($declaringClass->getName(), $nodes); if ($classNode === null) { return $this->propertyTypesCache[$declaringClass->getName()] = []; } $methodNode = $this->findConstructorNode($constructor->getName(), $classNode->stmts); if ($methodNode === null || $methodNode->stmts === null || count($methodNode->stmts) === 0) { return $this->propertyTypesCache[$declaringClass->getName()] = []; } $classNameParts = explode('\\', $declaringClass->getName()); $namespace = null; if (count($classNameParts) > 1) { $namespace = implode('\\', array_slice($classNameParts, 0, -1)); } $classScope = $this->scopeFactory->create(ScopeContext::create($fileName)); if ($namespace !== null) { $classScope = $classScope->enterNamespace($namespace); } $classScope = $classScope->enterClass($declaringClass); [$templateTypeMap, $phpDocParameterTypes, $phpDocImmediatelyInvokedCallableParameters, $phpDocClosureThisTypeParameters, $phpDocReturnType, $phpDocThrowType, $deprecatedDescription, $isDeprecated, $isInternal, $isFinal, $isPure, $acceptsNamedArguments, , $phpDocComment, $asserts, $selfOutType, $phpDocParameterOutTypes] = $this->nodeScopeResolver->getPhpDocs($classScope, $methodNode); $methodScope = $classScope->enterClassMethod($methodNode, $templateTypeMap, $phpDocParameterTypes, $phpDocReturnType, $phpDocThrowType, $deprecatedDescription, $isDeprecated, $isInternal, $isFinal, $isPure, $acceptsNamedArguments, $asserts, $selfOutType, $phpDocComment, $phpDocParameterOutTypes, $phpDocImmediatelyInvokedCallableParameters, $phpDocClosureThisTypeParameters); $propertyTypes = []; foreach ($methodNode->stmts as $statement) { if (!$statement instanceof Node\Stmt\Expression) { continue; } $expr = $statement->expr; if (!$expr instanceof Node\Expr\Assign) { continue; } if (!$expr->var instanceof Node\Expr\PropertyFetch) { continue; } $propertyFetch = $expr->var; if (!$propertyFetch->var instanceof Node\Expr\Variable || $propertyFetch->var->name !== 'this' || !$propertyFetch->name instanceof Node\Identifier) { continue; } $propertyType = $methodScope->getType($expr->expr); if ($propertyType instanceof ErrorType || $propertyType instanceof NeverType) { continue; } $propertyType = $propertyType->generalize(GeneralizePrecision::lessSpecific()); if ($propertyType->isConstantArray()->yes()) { $propertyType = new ArrayType(new MixedType(\true), new MixedType(\true)); } $propertyTypes[$propertyFetch->name->toString()] = $propertyType; } return $this->propertyTypesCache[$declaringClass->getName()] = $propertyTypes; } /** * @param Node[] $nodes */ private function findClassNode(string $className, array $nodes) : ?Class_ { foreach ($nodes as $node) { if ($node instanceof Class_ && $node->namespacedName !== null && $node->namespacedName->toString() === $className) { return $node; } if (!$node instanceof Namespace_ && !$node instanceof Declare_) { continue; } $subNodeNames = $node->getSubNodeNames(); foreach ($subNodeNames as $subNodeName) { $subNode = $node->{$subNodeName}; if (!is_array($subNode)) { $subNode = [$subNode]; } $result = $this->findClassNode($className, $subNode); if ($result === null) { continue; } return $result; } } return null; } /** * @param Node\Stmt[] $classStatements */ private function findConstructorNode(string $methodName, array $classStatements) : ?ClassMethod { foreach ($classStatements as $statement) { if ($statement instanceof ClassMethod && $statement->name->toString() === $methodName) { return $statement; } } return null; } private function getPhpDocReturnType(ClassReflection $phpDocBlockClassReflection, ResolvedPhpDocBlock $resolvedPhpDoc, Type $nativeReturnType) : ?Type { $returnTag = $resolvedPhpDoc->getReturnTag(); if ($returnTag === null) { return null; } $phpDocReturnType = $returnTag->getType(); $phpDocReturnType = TemplateTypeHelper::resolveTemplateTypes($phpDocReturnType, $phpDocBlockClassReflection->getActiveTemplateTypeMap(), $phpDocBlockClassReflection->getCallSiteVarianceMap(), TemplateTypeVariance::createCovariant()); if ($returnTag->isExplicit() || $nativeReturnType->isSuperTypeOf($phpDocReturnType)->yes()) { return $phpDocReturnType; } return null; } /** * @param array<int, string> $positionalParameterNames * @return array{ResolvedPhpDocBlock, ClassReflection}|null */ private function findMethodPhpDocIncludingAncestors(ClassReflection $declaringClass, ClassReflection $implementingClass, string $methodName, array $positionalParameterNames) : ?array { $declaringClassName = $declaringClass->getName(); $resolved = $this->stubPhpDocProvider->findMethodPhpDoc($declaringClassName, $implementingClass->getName(), $methodName, $positionalParameterNames); if ($resolved !== null) { return [$resolved, $declaringClass]; } if (!$this->stubPhpDocProvider->isKnownClass($declaringClassName)) { return null; } $ancestors = $declaringClass->getAncestors(); foreach ($ancestors as $ancestor) { if ($ancestor->getName() === $declaringClassName) { continue; } if (!$ancestor->hasNativeMethod($methodName)) { continue; } $resolved = $this->stubPhpDocProvider->findMethodPhpDoc($ancestor->getName(), $ancestor->getName(), $methodName, $positionalParameterNames); if ($resolved === null) { continue; } return [$resolved, $ancestor]; } return null; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Php; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionClass; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionEnum; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionIntersectionType; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionMethod; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionNamedType; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionParameter; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionUnionType; use PHPStan\TrinaryLogic; interface BuiltinMethodReflection { public function getName() : string; public function getReflection() : ?ReflectionMethod; public function getFileName() : ?string; /** * @return ReflectionClass|ReflectionEnum */ public function getDeclaringClass(); public function getStartLine() : ?int; public function getEndLine() : ?int; public function getDocComment() : ?string; public function isStatic() : bool; public function isPrivate() : bool; public function isPublic() : bool; public function getPrototype() : self; public function isDeprecated() : TrinaryLogic; public function isVariadic() : bool; /** * @return ReflectionIntersectionType|ReflectionNamedType|ReflectionUnionType|null */ public function getReturnType(); /** * @return ReflectionIntersectionType|ReflectionNamedType|ReflectionUnionType|null */ public function getTentativeReturnType(); /** * @return ReflectionParameter[] */ public function getParameters() : array; public function isFinal() : bool; public function isInternal() : bool; public function isAbstract() : bool; public function returnsByReference() : TrinaryLogic; } <?php declare (strict_types=1); namespace PHPStan\Reflection\Php; use PHPStan\Reflection\AllowedSubTypesClassReflectionExtension; use PHPStan\Reflection\ClassReflection; use PHPStan\Type\Enum\EnumCaseObjectType; use function array_keys; final class EnumAllowedSubTypesClassReflectionExtension implements AllowedSubTypesClassReflectionExtension { public function supports(ClassReflection $classReflection) : bool { return $classReflection->isEnum(); } public function getAllowedSubTypes(ClassReflection $classReflection) : array { $cases = []; foreach (array_keys($classReflection->getEnumCases()) as $name) { $cases[] = new EnumCaseObjectType($classReflection->getName(), $name); } return $cases; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Php; use PHPStan\Reflection\ParameterReflection; use PHPStan\Reflection\PassedByReference; use PHPStan\Type\Type; class DummyParameter implements ParameterReflection { /** * @var string */ private $name; /** * @var Type */ private $type; /** * @var bool */ private $optional; /** * @var bool */ private $variadic; /** * @var ?Type */ private $defaultValue; /** * @var PassedByReference */ private $passedByReference; public function __construct(string $name, Type $type, bool $optional, ?PassedByReference $passedByReference, bool $variadic, ?Type $defaultValue) { $this->name = $name; $this->type = $type; $this->optional = $optional; $this->variadic = $variadic; $this->defaultValue = $defaultValue; $this->passedByReference = $passedByReference ?? PassedByReference::createNo(); } public function getName() : string { return $this->name; } public function isOptional() : bool { return $this->optional; } public function getType() : Type { return $this->type; } public function passedByReference() : PassedByReference { return $this->passedByReference; } public function isVariadic() : bool { return $this->variadic; } public function getDefaultValue() : ?Type { return $this->defaultValue; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Php; use PHPStan\Reflection\Assertions; use PHPStan\Reflection\ClassMemberReflection; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\FunctionVariantWithPhpDocs; use PHPStan\Reflection\Native\NativeParameterReflection; use PHPStan\Reflection\ParameterReflection; use PHPStan\Reflection\ParameterReflectionWithPhpDocs; use PHPStan\Reflection\ParametersAcceptorWithPhpDocs; use PHPStan\Reflection\PassedByReference; use PHPStan\TrinaryLogic; use PHPStan\Type\ClosureType; use PHPStan\Type\MixedType; use PHPStan\Type\ObjectWithoutClassType; use PHPStan\Type\Type; use function array_map; use function array_unshift; use function is_bool; final class ClosureCallMethodReflection implements ExtendedMethodReflection { /** * @var ExtendedMethodReflection */ private $nativeMethodReflection; /** * @var ClosureType */ private $closureType; public function __construct(ExtendedMethodReflection $nativeMethodReflection, ClosureType $closureType) { $this->nativeMethodReflection = $nativeMethodReflection; $this->closureType = $closureType; } public function getDeclaringClass() : ClassReflection { return $this->nativeMethodReflection->getDeclaringClass(); } public function isStatic() : bool { return $this->nativeMethodReflection->isStatic(); } public function isPrivate() : bool { return $this->nativeMethodReflection->isPrivate(); } public function isPublic() : bool { return $this->nativeMethodReflection->isPublic(); } public function getDocComment() : ?string { return $this->nativeMethodReflection->getDocComment(); } public function getName() : string { return $this->nativeMethodReflection->getName(); } public function getPrototype() : ClassMemberReflection { return $this->nativeMethodReflection->getPrototype(); } public function getVariants() : array { $parameters = $this->closureType->getParameters(); $newThis = new NativeParameterReflection('newThis', \false, new ObjectWithoutClassType(), PassedByReference::createNo(), \false, null); array_unshift($parameters, $newThis); return [new FunctionVariantWithPhpDocs($this->closureType->getTemplateTypeMap(), $this->closureType->getResolvedTemplateTypeMap(), array_map(static function (ParameterReflection $parameter) : ParameterReflectionWithPhpDocs { return new \PHPStan\Reflection\Php\DummyParameterWithPhpDocs($parameter->getName(), $parameter->getType(), $parameter->isOptional(), $parameter->passedByReference(), $parameter->isVariadic(), $parameter->getDefaultValue(), new MixedType(), $parameter->getType(), null, TrinaryLogic::createMaybe(), null); }, $parameters), $this->closureType->isVariadic(), $this->closureType->getReturnType(), $this->closureType->getReturnType(), new MixedType(), $this->closureType->getCallSiteVarianceMap())]; } public function getOnlyVariant() : ParametersAcceptorWithPhpDocs { return $this->getVariants()[0]; } public function getNamedArgumentsVariants() : ?array { return null; } public function isDeprecated() : TrinaryLogic { return $this->nativeMethodReflection->isDeprecated(); } public function getDeprecatedDescription() : ?string { return $this->nativeMethodReflection->getDeprecatedDescription(); } public function isFinal() : TrinaryLogic { return $this->nativeMethodReflection->isFinal(); } public function isFinalByKeyword() : TrinaryLogic { return $this->nativeMethodReflection->isFinalByKeyword(); } public function isInternal() : TrinaryLogic { return $this->nativeMethodReflection->isInternal(); } public function getThrowType() : ?Type { return $this->nativeMethodReflection->getThrowType(); } public function hasSideEffects() : TrinaryLogic { return $this->nativeMethodReflection->hasSideEffects(); } public function getAsserts() : Assertions { return $this->nativeMethodReflection->getAsserts(); } public function acceptsNamedArguments() : bool { return $this->nativeMethodReflection->acceptsNamedArguments(); } public function getSelfOutType() : ?Type { return $this->nativeMethodReflection->getSelfOutType(); } public function returnsByReference() : TrinaryLogic { return $this->nativeMethodReflection->returnsByReference(); } public function isAbstract() : TrinaryLogic { $abstract = $this->nativeMethodReflection->isAbstract(); if (is_bool($abstract)) { return TrinaryLogic::createFromBoolean($abstract); } return $abstract; } public function isPure() : TrinaryLogic { return $this->nativeMethodReflection->isPure(); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Php\Soap; use PHPStan\Reflection\ClassMemberReflection; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\FunctionVariant; use PHPStan\Reflection\MethodReflection; use PHPStan\TrinaryLogic; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\MixedType; use PHPStan\Type\ObjectType; use PHPStan\Type\Type; final class SoapClientMethodReflection implements MethodReflection { /** * @var ClassReflection */ private $declaringClass; /** * @var string */ private $name; public function __construct(ClassReflection $declaringClass, string $name) { $this->declaringClass = $declaringClass; $this->name = $name; } public function getDeclaringClass() : ClassReflection { return $this->declaringClass; } public function isStatic() : bool { return \false; } public function isPrivate() : bool { return \false; } public function isPublic() : bool { return \true; } public function getDocComment() : ?string { return null; } public function getName() : string { return $this->name; } public function getPrototype() : ClassMemberReflection { return $this; } public function getVariants() : array { return [new FunctionVariant(TemplateTypeMap::createEmpty(), TemplateTypeMap::createEmpty(), [], \true, new MixedType(\true))]; } public function isDeprecated() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getDeprecatedDescription() : ?string { return null; } public function isFinal() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isInternal() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getThrowType() : Type { return new ObjectType('SoapFault'); } public function hasSideEffects() : TrinaryLogic { return TrinaryLogic::createYes(); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Php\Soap; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\MethodReflection; use PHPStan\Reflection\MethodsClassReflectionExtension; final class SoapClientMethodsClassReflectionExtension implements MethodsClassReflectionExtension { public function hasMethod(ClassReflection $classReflection, string $methodName) : bool { return $classReflection->getName() === 'SoapClient' || $classReflection->isSubclassOf('SoapClient'); } public function getMethod(ClassReflection $classReflection, string $methodName) : MethodReflection { return new \PHPStan\Reflection\Php\Soap\SoapClientMethodReflection($classReflection, $methodName); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Php; use PHPStan\Reflection\Assertions; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\FunctionVariantWithPhpDocs; use PHPStan\Reflection\ParametersAcceptorWithPhpDocs; use PHPStan\Reflection\PassedByReference; use PHPStan\TrinaryLogic; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\Generic\TemplateTypeVarianceMap; use PHPStan\Type\IntegerType; use PHPStan\Type\MixedType; use PHPStan\Type\NeverType; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\UnionType; final class ExitFunctionReflection implements FunctionReflection { /** * @var string */ private $name; public function __construct(string $name) { $this->name = $name; } public function getName() : string { return $this->name; } public function getFileName() : ?string { return null; } public function getVariants() : array { $parameterType = new UnionType([new StringType(), new IntegerType()]); return [new FunctionVariantWithPhpDocs(TemplateTypeMap::createEmpty(), TemplateTypeMap::createEmpty(), [new \PHPStan\Reflection\Php\DummyParameterWithPhpDocs('status', $parameterType, \true, PassedByReference::createNo(), \false, new ConstantIntegerType(0), $parameterType, new MixedType(), null, TrinaryLogic::createNo(), null)], \false, new NeverType(\true), new MixedType(), new NeverType(\true), TemplateTypeVarianceMap::createEmpty())]; } public function getOnlyVariant() : ParametersAcceptorWithPhpDocs { return $this->getVariants()[0]; } /** * @return ParametersAcceptorWithPhpDocs[] */ public function getNamedArgumentsVariants() : array { return $this->getVariants(); } public function acceptsNamedArguments() : bool { return \true; } public function isDeprecated() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getDeprecatedDescription() : ?string { return null; } public function isFinal() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isInternal() : TrinaryLogic { return TrinaryLogic::createYes(); } public function getThrowType() : ?Type { return null; } public function hasSideEffects() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isBuiltin() : bool { return \true; } public function getAsserts() : Assertions { return Assertions::createEmpty(); } public function getDocComment() : ?string { return null; } public function returnsByReference() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isPure() : TrinaryLogic { return TrinaryLogic::createNo(); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Php; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ExtendedPropertyReflection; use PHPStan\TrinaryLogic; use PHPStan\Type\Type; final class EnumPropertyReflection implements ExtendedPropertyReflection { /** * @var ClassReflection */ private $declaringClass; /** * @var Type */ private $type; public function __construct(ClassReflection $declaringClass, Type $type) { $this->declaringClass = $declaringClass; $this->type = $type; } public function getDeclaringClass() : ClassReflection { return $this->declaringClass; } public function isStatic() : bool { return \false; } public function isPrivate() : bool { return \false; } public function isPublic() : bool { return \true; } public function getDocComment() : ?string { return null; } public function getReadableType() : Type { return $this->type; } public function getWritableType() : Type { return $this->type; } public function canChangeTypeAfterAssignment() : bool { return \true; } public function isReadable() : bool { return \true; } public function isWritable() : bool { return \false; } public function isDeprecated() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getDeprecatedDescription() : ?string { return null; } public function isInternal() : TrinaryLogic { return TrinaryLogic::createNo(); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Php; use PHPStan\Reflection\Assertions; use PHPStan\Reflection\ClassReflection; use PHPStan\TrinaryLogic; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\Type; interface PhpMethodReflectionFactory { /** * @param Type[] $phpDocParameterTypes * @param Type[] $phpDocParameterOutTypes * @param array<string, TrinaryLogic> $immediatelyInvokedCallableParameters * @param array<string, Type> $phpDocClosureThisTypeParameters */ public function create(ClassReflection $declaringClass, ?ClassReflection $declaringTrait, \PHPStan\Reflection\Php\BuiltinMethodReflection $reflection, TemplateTypeMap $templateTypeMap, array $phpDocParameterTypes, ?Type $phpDocReturnType, ?Type $phpDocThrowType, ?string $deprecatedDescription, bool $isDeprecated, bool $isInternal, bool $isFinal, ?bool $isPure, Assertions $asserts, ?Type $selfOutType, ?string $phpDocComment, array $phpDocParameterOutTypes, array $immediatelyInvokedCallableParameters = [], array $phpDocClosureThisTypeParameters = [], bool $acceptsNamedArguments = \true) : \PHPStan\Reflection\Php\PhpMethodReflection; } <?php declare (strict_types=1); namespace PHPStan\Reflection\Php; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionClass; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionIntersectionType; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionMethod; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionNamedType; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionParameter; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionUnionType; use PHPStan\TrinaryLogic; final class NativeBuiltinMethodReflection implements \PHPStan\Reflection\Php\BuiltinMethodReflection { /** * @var ReflectionMethod */ private $reflection; public function __construct(ReflectionMethod $reflection) { $this->reflection = $reflection; } public function getName() : string { return $this->reflection->getName(); } public function getReflection() : ReflectionMethod { return $this->reflection; } public function getFileName() : ?string { $fileName = $this->reflection->getFileName(); if ($fileName === \false) { return null; } return $fileName; } public function getDeclaringClass() : ReflectionClass { return $this->reflection->getDeclaringClass(); } public function getStartLine() : ?int { $line = $this->reflection->getStartLine(); if ($line === \false) { return null; } return $line; } public function getEndLine() : ?int { $line = $this->reflection->getEndLine(); if ($line === \false) { return null; } return $line; } public function getDocComment() : ?string { $docComment = $this->reflection->getDocComment(); if ($docComment === \false) { return null; } return $docComment; } public function isStatic() : bool { return $this->reflection->isStatic(); } public function isPrivate() : bool { return $this->reflection->isPrivate(); } public function isPublic() : bool { return $this->reflection->isPublic(); } public function isConstructor() : bool { return $this->reflection->isConstructor(); } public function getPrototype() : \PHPStan\Reflection\Php\BuiltinMethodReflection { return new self($this->reflection->getPrototype()); } public function isDeprecated() : TrinaryLogic { return TrinaryLogic::createFromBoolean($this->reflection->isDeprecated()); } public function isFinal() : bool { return $this->reflection->isFinal(); } public function isInternal() : bool { return $this->reflection->isInternal(); } public function isAbstract() : bool { return $this->reflection->isAbstract(); } public function isVariadic() : bool { return $this->reflection->isVariadic(); } /** * @return ReflectionIntersectionType|ReflectionNamedType|ReflectionUnionType|null */ public function getReturnType() { return $this->reflection->getReturnType(); } /** * @return ReflectionIntersectionType|ReflectionNamedType|ReflectionUnionType|null */ public function getTentativeReturnType() { return $this->reflection->getTentativeReturnType(); } /** * @return ReflectionParameter[] */ public function getParameters() : array { return $this->reflection->getParameters(); } public function returnsByReference() : TrinaryLogic { return TrinaryLogic::createFromBoolean($this->reflection->returnsReference()); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Php; use PhpParser\Node; use PhpParser\Node\Expr\Variable; use PhpParser\Node\FunctionLike; use PhpParser\Node\Stmt\ClassMethod; use PhpParser\Node\Stmt\Function_; use PHPStan\Reflection\Assertions; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\FunctionVariantWithPhpDocs; use PHPStan\Reflection\ParameterReflectionWithPhpDocs; use PHPStan\Reflection\ParametersAcceptorWithPhpDocs; use PHPStan\Reflection\PassedByReference; use PHPStan\ShouldNotHappenException; use PHPStan\TrinaryLogic; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\Generic\TemplateTypeVarianceMap; use PHPStan\Type\MixedType; use PHPStan\Type\Type; use PHPStan\Type\TypehintHelper; use function array_reverse; use function is_array; use function is_string; /** * @api */ class PhpFunctionFromParserNodeReflection implements FunctionReflection, ParametersAcceptorWithPhpDocs { /** * @var string */ private $fileName; /** * @var TemplateTypeMap */ private $templateTypeMap; /** * @var Type[] */ private $realParameterTypes; /** * @var Type[] */ private $phpDocParameterTypes; /** * @var Type[] */ private $realParameterDefaultValues; /** * @var Type */ private $realReturnType; /** * @var ?Type */ private $phpDocReturnType; /** * @var ?Type */ private $throwType; /** * @var ?string */ private $deprecatedDescription; /** * @var bool */ private $isDeprecated; /** * @var bool */ private $isInternal; /** * @var bool */ private $isFinal; /** * @var ?bool */ protected $isPure; /** * @var bool */ private $acceptsNamedArguments; /** * @var Assertions */ private $assertions; /** * @var ?string */ private $phpDocComment; /** * @var Type[] */ private $parameterOutTypes; /** * @var array<string, bool> */ private $immediatelyInvokedCallableParameters; /** * @var array<string, Type> */ private $phpDocClosureThisTypeParameters; /** @var Function_|ClassMethod */ private $functionLike; /** @var FunctionVariantWithPhpDocs[]|null */ private $variants = null; /** * @param Function_|ClassMethod $functionLike * @param Type[] $realParameterTypes * @param Type[] $phpDocParameterTypes * @param Type[] $realParameterDefaultValues * @param Type[] $parameterOutTypes * @param array<string, bool> $immediatelyInvokedCallableParameters * @param array<string, Type> $phpDocClosureThisTypeParameters */ public function __construct(FunctionLike $functionLike, string $fileName, TemplateTypeMap $templateTypeMap, array $realParameterTypes, array $phpDocParameterTypes, array $realParameterDefaultValues, Type $realReturnType, ?Type $phpDocReturnType, ?Type $throwType, ?string $deprecatedDescription, bool $isDeprecated, bool $isInternal, bool $isFinal, ?bool $isPure, bool $acceptsNamedArguments, Assertions $assertions, ?string $phpDocComment, array $parameterOutTypes, array $immediatelyInvokedCallableParameters, array $phpDocClosureThisTypeParameters) { $this->fileName = $fileName; $this->templateTypeMap = $templateTypeMap; $this->realParameterTypes = $realParameterTypes; $this->phpDocParameterTypes = $phpDocParameterTypes; $this->realParameterDefaultValues = $realParameterDefaultValues; $this->realReturnType = $realReturnType; $this->phpDocReturnType = $phpDocReturnType; $this->throwType = $throwType; $this->deprecatedDescription = $deprecatedDescription; $this->isDeprecated = $isDeprecated; $this->isInternal = $isInternal; $this->isFinal = $isFinal; $this->isPure = $isPure; $this->acceptsNamedArguments = $acceptsNamedArguments; $this->assertions = $assertions; $this->phpDocComment = $phpDocComment; $this->parameterOutTypes = $parameterOutTypes; $this->immediatelyInvokedCallableParameters = $immediatelyInvokedCallableParameters; $this->phpDocClosureThisTypeParameters = $phpDocClosureThisTypeParameters; $this->functionLike = $functionLike; } protected function getFunctionLike() : FunctionLike { return $this->functionLike; } public function getFileName() : string { return $this->fileName; } public function getName() : string { if ($this->functionLike instanceof ClassMethod) { return $this->functionLike->name->name; } if ($this->functionLike->namespacedName === null) { throw new ShouldNotHappenException(); } return (string) $this->functionLike->namespacedName; } /** * @return ParametersAcceptorWithPhpDocs[] */ public function getVariants() : array { if ($this->variants === null) { $this->variants = [new FunctionVariantWithPhpDocs($this->getTemplateTypeMap(), $this->getResolvedTemplateTypeMap(), $this->getParameters(), $this->isVariadic(), $this->getReturnType(), $this->getPhpDocReturnType(), $this->getNativeReturnType())]; } return $this->variants; } public function getOnlyVariant() : ParametersAcceptorWithPhpDocs { return $this; } public function getNamedArgumentsVariants() : ?array { return null; } public function getTemplateTypeMap() : TemplateTypeMap { return $this->templateTypeMap; } public function getResolvedTemplateTypeMap() : TemplateTypeMap { return TemplateTypeMap::createEmpty(); } /** * @return array<int, ParameterReflectionWithPhpDocs> */ public function getParameters() : array { $parameters = []; $isOptional = \true; /** @var Node\Param $parameter */ foreach (array_reverse($this->functionLike->getParams()) as $parameter) { if ($parameter->default === null && !$parameter->variadic) { $isOptional = \false; } if (!$parameter->var instanceof Variable || !is_string($parameter->var->name)) { throw new ShouldNotHappenException(); } if (isset($this->immediatelyInvokedCallableParameters[$parameter->var->name])) { $immediatelyInvokedCallable = TrinaryLogic::createFromBoolean($this->immediatelyInvokedCallableParameters[$parameter->var->name]); } else { $immediatelyInvokedCallable = TrinaryLogic::createMaybe(); } if (isset($this->phpDocClosureThisTypeParameters[$parameter->var->name])) { $closureThisType = $this->phpDocClosureThisTypeParameters[$parameter->var->name]; } else { $closureThisType = null; } $parameters[] = new \PHPStan\Reflection\Php\PhpParameterFromParserNodeReflection($parameter->var->name, $isOptional, $this->realParameterTypes[$parameter->var->name], $this->phpDocParameterTypes[$parameter->var->name] ?? null, $parameter->byRef ? PassedByReference::createCreatesNewVariable() : PassedByReference::createNo(), $this->realParameterDefaultValues[$parameter->var->name] ?? null, $parameter->variadic, $this->parameterOutTypes[$parameter->var->name] ?? null, $immediatelyInvokedCallable, $closureThisType); } return array_reverse($parameters); } public function isVariadic() : bool { foreach ($this->functionLike->getParams() as $parameter) { if ($parameter->variadic) { return \true; } } return \false; } public function getReturnType() : Type { return TypehintHelper::decideType($this->realReturnType, $this->phpDocReturnType); } public function getPhpDocReturnType() : Type { return $this->phpDocReturnType ?? new MixedType(); } public function getNativeReturnType() : Type { return $this->realReturnType; } public function getCallSiteVarianceMap() : TemplateTypeVarianceMap { return TemplateTypeVarianceMap::createEmpty(); } public function getDeprecatedDescription() : ?string { if ($this->isDeprecated) { return $this->deprecatedDescription; } return null; } public function isDeprecated() : TrinaryLogic { return TrinaryLogic::createFromBoolean($this->isDeprecated); } public function isInternal() : TrinaryLogic { return TrinaryLogic::createFromBoolean($this->isInternal); } public function isFinal() : TrinaryLogic { $finalMethod = \false; if ($this->functionLike instanceof ClassMethod) { $finalMethod = $this->functionLike->isFinal(); } return TrinaryLogic::createFromBoolean($finalMethod || $this->isFinal); } public function isFinalByKeyword() : TrinaryLogic { $finalMethod = \false; if ($this->functionLike instanceof ClassMethod) { $finalMethod = $this->functionLike->isFinal(); } return TrinaryLogic::createFromBoolean($finalMethod); } public function getThrowType() : ?Type { return $this->throwType; } public function hasSideEffects() : TrinaryLogic { if ($this->getReturnType()->isVoid()->yes()) { return TrinaryLogic::createYes(); } if ($this->isPure !== null) { return TrinaryLogic::createFromBoolean(!$this->isPure); } return TrinaryLogic::createMaybe(); } public function isBuiltin() : bool { return \false; } public function isGenerator() : bool { return $this->nodeIsOrContainsYield($this->functionLike); } public function acceptsNamedArguments() : bool { return $this->acceptsNamedArguments; } private function nodeIsOrContainsYield(Node $node) : bool { if ($node instanceof Node\Expr\Yield_) { return \true; } if ($node instanceof Node\Expr\YieldFrom) { return \true; } foreach ($node->getSubNodeNames() as $nodeName) { $nodeProperty = $node->{$nodeName}; if ($nodeProperty instanceof Node && $this->nodeIsOrContainsYield($nodeProperty)) { return \true; } if (!is_array($nodeProperty)) { continue; } foreach ($nodeProperty as $nodePropertyArrayItem) { if ($nodePropertyArrayItem instanceof Node && $this->nodeIsOrContainsYield($nodePropertyArrayItem)) { return \true; } } } return \false; } public function getAsserts() : Assertions { return $this->assertions; } public function getDocComment() : ?string { return $this->phpDocComment; } public function returnsByReference() : TrinaryLogic { return TrinaryLogic::createFromBoolean($this->functionLike->returnsByRef()); } public function isPure() : TrinaryLogic { if ($this->isPure === null) { return TrinaryLogic::createMaybe(); } return TrinaryLogic::createFromBoolean($this->isPure); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Php; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\Type\UnresolvedMethodPrototypeReflection; use PHPStan\Type\ClosureType; use PHPStan\Type\Type; final class ClosureCallUnresolvedMethodPrototypeReflection implements UnresolvedMethodPrototypeReflection { /** * @var UnresolvedMethodPrototypeReflection */ private $prototype; /** * @var ClosureType */ private $closure; public function __construct(UnresolvedMethodPrototypeReflection $prototype, ClosureType $closure) { $this->prototype = $prototype; $this->closure = $closure; } public function doNotResolveTemplateTypeMapToBounds() : UnresolvedMethodPrototypeReflection { return new self($this->prototype->doNotResolveTemplateTypeMapToBounds(), $this->closure); } public function getNakedMethod() : ExtendedMethodReflection { return $this->getTransformedMethod(); } public function getTransformedMethod() : ExtendedMethodReflection { return new \PHPStan\Reflection\Php\ClosureCallMethodReflection($this->prototype->getTransformedMethod(), $this->closure); } public function withCalledOnType(Type $type) : UnresolvedMethodPrototypeReflection { return new self($this->prototype->withCalledOnType($type), $this->closure); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Php; use PHPStan\Reflection\Assertions; use PHPStan\Reflection\ClassMemberReflection; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\FunctionVariantWithPhpDocs; use PHPStan\Reflection\ParametersAcceptorWithPhpDocs; use PHPStan\ShouldNotHappenException; use PHPStan\TrinaryLogic; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\MixedType; use PHPStan\Type\Type; final class EnumCasesMethodReflection implements ExtendedMethodReflection { /** * @var ClassReflection */ private $declaringClass; /** * @var Type */ private $returnType; public function __construct(ClassReflection $declaringClass, Type $returnType) { $this->declaringClass = $declaringClass; $this->returnType = $returnType; } public function getDeclaringClass() : ClassReflection { return $this->declaringClass; } public function isStatic() : bool { return \true; } public function isPrivate() : bool { return \false; } public function isPublic() : bool { return \true; } public function getDocComment() : ?string { return null; } public function getName() : string { return 'cases'; } public function getPrototype() : ClassMemberReflection { $unitEnum = $this->declaringClass->getAncestorWithClassName('UnitEnum'); if ($unitEnum === null) { throw new ShouldNotHappenException(); } return $unitEnum->getNativeMethod('cases'); } public function getVariants() : array { return [new FunctionVariantWithPhpDocs(TemplateTypeMap::createEmpty(), TemplateTypeMap::createEmpty(), [], \false, $this->returnType, new MixedType(), $this->returnType)]; } public function getOnlyVariant() : ParametersAcceptorWithPhpDocs { return $this->getVariants()[0]; } public function getNamedArgumentsVariants() : ?array { return null; } public function isDeprecated() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getDeprecatedDescription() : ?string { return null; } public function isFinal() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isFinalByKeyword() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isInternal() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getThrowType() : ?Type { return null; } public function hasSideEffects() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getAsserts() : Assertions { return Assertions::createEmpty(); } public function acceptsNamedArguments() : bool { return $this->declaringClass->acceptsNamedArguments(); } public function getSelfOutType() : ?Type { return null; } public function returnsByReference() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isAbstract() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isPure() : TrinaryLogic { return TrinaryLogic::createYes(); } } <?php declare (strict_types=1); namespace PHPStan\Reflection; use PHPStan\Reflection\Php\PhpMethodReflection; use PHPStan\TrinaryLogic; use PHPStan\Type\Generic\TemplateTypeHelper; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\Generic\TemplateTypeVariance; use PHPStan\Type\Generic\TemplateTypeVarianceMap; use PHPStan\Type\Type; use function is_bool; final class ResolvedMethodReflection implements \PHPStan\Reflection\ExtendedMethodReflection { /** * @var ExtendedMethodReflection */ private $reflection; /** * @var TemplateTypeMap */ private $resolvedTemplateTypeMap; /** * @var TemplateTypeVarianceMap */ private $callSiteVarianceMap; /** @var ParametersAcceptorWithPhpDocs[]|null */ private $variants = null; /** @var ParametersAcceptorWithPhpDocs[]|null */ private $namedArgumentVariants = null; /** * @var ?Assertions */ private $asserts = null; /** * @var Type|false|null */ private $selfOutType = \false; public function __construct(\PHPStan\Reflection\ExtendedMethodReflection $reflection, TemplateTypeMap $resolvedTemplateTypeMap, TemplateTypeVarianceMap $callSiteVarianceMap) { $this->reflection = $reflection; $this->resolvedTemplateTypeMap = $resolvedTemplateTypeMap; $this->callSiteVarianceMap = $callSiteVarianceMap; } public function getName() : string { return $this->reflection->getName(); } public function getPrototype() : \PHPStan\Reflection\ClassMemberReflection { return $this->reflection->getPrototype(); } public function getVariants() : array { $variants = $this->variants; if ($variants !== null) { return $variants; } return $this->variants = $this->resolveVariants($this->reflection->getVariants()); } public function getOnlyVariant() : \PHPStan\Reflection\ParametersAcceptorWithPhpDocs { return $this->getVariants()[0]; } public function getNamedArgumentsVariants() : ?array { $variants = $this->namedArgumentVariants; if ($variants !== null) { return $variants; } $innerVariants = $this->reflection->getNamedArgumentsVariants(); if ($innerVariants === null) { return null; } return $this->namedArgumentVariants = $this->resolveVariants($innerVariants); } /** * @param ParametersAcceptorWithPhpDocs[] $variants * @return ResolvedFunctionVariant[] */ private function resolveVariants(array $variants) : array { $result = []; foreach ($variants as $variant) { $result[] = new \PHPStan\Reflection\ResolvedFunctionVariantWithOriginal($variant, $this->resolvedTemplateTypeMap, $this->callSiteVarianceMap, []); } return $result; } public function getDeclaringClass() : \PHPStan\Reflection\ClassReflection { return $this->reflection->getDeclaringClass(); } public function getDeclaringTrait() : ?\PHPStan\Reflection\ClassReflection { if ($this->reflection instanceof PhpMethodReflection) { return $this->reflection->getDeclaringTrait(); } return null; } public function isStatic() : bool { return $this->reflection->isStatic(); } public function isPrivate() : bool { return $this->reflection->isPrivate(); } public function isPublic() : bool { return $this->reflection->isPublic(); } public function getDocComment() : ?string { return $this->reflection->getDocComment(); } public function isDeprecated() : TrinaryLogic { return $this->reflection->isDeprecated(); } public function getDeprecatedDescription() : ?string { return $this->reflection->getDeprecatedDescription(); } public function isFinal() : TrinaryLogic { return $this->reflection->isFinal(); } public function isFinalByKeyword() : TrinaryLogic { return $this->reflection->isFinalByKeyword(); } public function isInternal() : TrinaryLogic { return $this->reflection->isInternal(); } public function getThrowType() : ?Type { return $this->reflection->getThrowType(); } public function hasSideEffects() : TrinaryLogic { return $this->reflection->hasSideEffects(); } public function isPure() : TrinaryLogic { return $this->reflection->isPure(); } public function getAsserts() : \PHPStan\Reflection\Assertions { return $this->asserts = $this->asserts ?? $this->reflection->getAsserts()->mapTypes(function (Type $type) { return TemplateTypeHelper::resolveTemplateTypes($type, $this->resolvedTemplateTypeMap, $this->callSiteVarianceMap, TemplateTypeVariance::createInvariant()); }); } public function acceptsNamedArguments() : bool { return $this->reflection->acceptsNamedArguments(); } public function getSelfOutType() : ?Type { if ($this->selfOutType === \false) { $selfOutType = $this->reflection->getSelfOutType(); if ($selfOutType !== null) { $selfOutType = TemplateTypeHelper::resolveTemplateTypes($selfOutType, $this->resolvedTemplateTypeMap, $this->callSiteVarianceMap, TemplateTypeVariance::createInvariant()); } $this->selfOutType = $selfOutType; } return $this->selfOutType; } public function returnsByReference() : TrinaryLogic { return $this->reflection->returnsByReference(); } public function isAbstract() : TrinaryLogic { $abstract = $this->reflection->isAbstract(); if (is_bool($abstract)) { return TrinaryLogic::createFromBoolean($abstract); } return $abstract; } } <?php declare (strict_types=1); namespace PHPStan\Reflection; use PHPStan\Php\PhpVersion; use PHPStan\ShouldNotHappenException; final class PhpVersionStaticAccessor { /** * @var ?PhpVersion */ private static $instance = null; private function __construct() { } public static function registerInstance(PhpVersion $phpVersion) : void { self::$instance = $phpVersion; } public static function getInstance() : PhpVersion { if (self::$instance === null) { throw new ShouldNotHappenException(); } return self::$instance; } } <?php declare (strict_types=1); namespace PHPStan\Reflection; /** * This is the interface custom properties class reflection extensions implement. * * To register it in the configuration file use the `phpstan.broker.propertiesClassReflectionExtension` service tag: * * ``` * services: * - * class: App\PHPStan\MyPropertiesClassReflectionExtension * tags: * - phpstan.broker.propertiesClassReflectionExtension * ``` * * Learn more: https://phpstan.org/developing-extensions/class-reflection-extensions * * @api */ interface PropertiesClassReflectionExtension { public function hasProperty(\PHPStan\Reflection\ClassReflection $classReflection, string $propertyName) : bool; public function getProperty(\PHPStan\Reflection\ClassReflection $classReflection, string $propertyName) : \PHPStan\Reflection\PropertyReflection; } <?php declare (strict_types=1); namespace PHPStan\Reflection; use PHPStan\TrinaryLogic; use PHPStan\Type\Type; /** @api */ interface ParameterReflectionWithPhpDocs extends \PHPStan\Reflection\ParameterReflection { public function getPhpDocType() : Type; public function getNativeType() : Type; public function getOutType() : ?Type; public function isImmediatelyInvokedCallable() : TrinaryLogic; public function getClosureThisType() : ?Type; } <?php declare (strict_types=1); namespace PHPStan\Reflection; use Exception; use function sprintf; final class MissingMethodFromReflectionException extends Exception { public function __construct(string $className, string $methodName) { parent::__construct(sprintf('Method %s() was not found in reflection of class %s.', $methodName, $className)); } } <?php declare (strict_types=1); namespace PHPStan\Reflection; use PHPStan\Broker\Broker; use PHPStan\Reflection\RequireExtension\RequireExtendsMethodsClassReflectionExtension; use PHPStan\Reflection\RequireExtension\RequireExtendsPropertiesClassReflectionExtension; use function array_merge; final class ClassReflectionExtensionRegistry { /** * @var PropertiesClassReflectionExtension[] */ private $propertiesClassReflectionExtensions; /** * @var MethodsClassReflectionExtension[] */ private $methodsClassReflectionExtensions; /** * @var AllowedSubTypesClassReflectionExtension[] */ private $allowedSubTypesClassReflectionExtensions; /** * @var RequireExtendsPropertiesClassReflectionExtension */ private $requireExtendsPropertiesClassReflectionExtension; /** * @var RequireExtendsMethodsClassReflectionExtension */ private $requireExtendsMethodsClassReflectionExtension; /** * @param PropertiesClassReflectionExtension[] $propertiesClassReflectionExtensions * @param MethodsClassReflectionExtension[] $methodsClassReflectionExtensions * @param AllowedSubTypesClassReflectionExtension[] $allowedSubTypesClassReflectionExtensions */ public function __construct(Broker $broker, array $propertiesClassReflectionExtensions, array $methodsClassReflectionExtensions, array $allowedSubTypesClassReflectionExtensions, RequireExtendsPropertiesClassReflectionExtension $requireExtendsPropertiesClassReflectionExtension, RequireExtendsMethodsClassReflectionExtension $requireExtendsMethodsClassReflectionExtension) { $this->propertiesClassReflectionExtensions = $propertiesClassReflectionExtensions; $this->methodsClassReflectionExtensions = $methodsClassReflectionExtensions; $this->allowedSubTypesClassReflectionExtensions = $allowedSubTypesClassReflectionExtensions; $this->requireExtendsPropertiesClassReflectionExtension = $requireExtendsPropertiesClassReflectionExtension; $this->requireExtendsMethodsClassReflectionExtension = $requireExtendsMethodsClassReflectionExtension; foreach (array_merge($propertiesClassReflectionExtensions, $methodsClassReflectionExtensions, $allowedSubTypesClassReflectionExtensions) as $extension) { if (!$extension instanceof \PHPStan\Reflection\BrokerAwareExtension) { continue; } $extension->setBroker($broker); } } /** * @return PropertiesClassReflectionExtension[] */ public function getPropertiesClassReflectionExtensions() : array { return $this->propertiesClassReflectionExtensions; } /** * @return MethodsClassReflectionExtension[] */ public function getMethodsClassReflectionExtensions() : array { return $this->methodsClassReflectionExtensions; } /** * @return AllowedSubTypesClassReflectionExtension[] */ public function getAllowedSubTypesClassReflectionExtensions() : array { return $this->allowedSubTypesClassReflectionExtensions; } public function getRequireExtendsPropertyClassReflectionExtension() : RequireExtendsPropertiesClassReflectionExtension { return $this->requireExtendsPropertiesClassReflectionExtension; } public function getRequireExtendsMethodsClassReflectionExtension() : RequireExtendsMethodsClassReflectionExtension { return $this->requireExtendsMethodsClassReflectionExtension; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\SignatureMap; use PHPStan\BetterReflection\Identifier\Exception\InvalidIdentifierName; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionFunction; use PHPStan\BetterReflection\Reflector\Exception\IdentifierNotFound; use PHPStan\BetterReflection\Reflector\Reflector; use PHPStan\PhpDoc\ResolvedPhpDocBlock; use PHPStan\PhpDoc\StubPhpDocProvider; use PHPStan\Reflection\Assertions; use PHPStan\Reflection\FunctionVariantWithPhpDocs; use PHPStan\Reflection\Native\NativeFunctionReflection; use PHPStan\Reflection\Native\NativeParameterWithPhpDocsReflection; use PHPStan\TrinaryLogic; use PHPStan\Type\FileTypeMapper; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\MixedType; use PHPStan\Type\Type; use PHPStan\Type\TypehintHelper; use function array_key_exists; use function array_map; use function strtolower; final class NativeFunctionReflectionProvider { /** * @var SignatureMapProvider */ private $signatureMapProvider; /** * @var Reflector */ private $reflector; /** * @var FileTypeMapper */ private $fileTypeMapper; /** * @var StubPhpDocProvider */ private $stubPhpDocProvider; /** @var NativeFunctionReflection[] */ private $functionMap = []; public function __construct(\PHPStan\Reflection\SignatureMap\SignatureMapProvider $signatureMapProvider, Reflector $reflector, FileTypeMapper $fileTypeMapper, StubPhpDocProvider $stubPhpDocProvider) { $this->signatureMapProvider = $signatureMapProvider; $this->reflector = $reflector; $this->fileTypeMapper = $fileTypeMapper; $this->stubPhpDocProvider = $stubPhpDocProvider; } public function findFunctionReflection(string $functionName) : ?NativeFunctionReflection { $lowerCasedFunctionName = strtolower($functionName); $realFunctionName = $lowerCasedFunctionName; if (isset($this->functionMap[$lowerCasedFunctionName])) { return $this->functionMap[$lowerCasedFunctionName]; } if (!$this->signatureMapProvider->hasFunctionSignature($lowerCasedFunctionName)) { return null; } $throwType = null; $reflectionFunctionAdapter = null; $isDeprecated = \false; $phpDocReturnType = null; $asserts = Assertions::createEmpty(); $docComment = null; $returnsByReference = TrinaryLogic::createMaybe(); $acceptsNamedArguments = \true; try { $reflectionFunction = $this->reflector->reflectFunction($functionName); $reflectionFunctionAdapter = new ReflectionFunction($reflectionFunction); $returnsByReference = TrinaryLogic::createFromBoolean($reflectionFunctionAdapter->returnsReference()); $realFunctionName = $reflectionFunction->getName(); if ($reflectionFunction->getFileName() !== null) { $fileName = $reflectionFunction->getFileName(); $docComment = $reflectionFunction->getDocComment(); if ($docComment !== null) { $resolvedPhpDoc = $this->fileTypeMapper->getResolvedPhpDoc($fileName, null, null, $reflectionFunction->getName(), $docComment); $throwsTag = $resolvedPhpDoc->getThrowsTag(); if ($throwsTag !== null) { $throwType = $throwsTag->getType(); } $isDeprecated = $reflectionFunction->isDeprecated(); } } } catch (IdentifierNotFound|InvalidIdentifierName $e) { // pass } $functionSignaturesResult = $this->signatureMapProvider->getFunctionSignatures($lowerCasedFunctionName, null, $reflectionFunctionAdapter); $phpDoc = $this->stubPhpDocProvider->findFunctionPhpDoc($lowerCasedFunctionName, array_map(static function (\PHPStan\Reflection\SignatureMap\ParameterSignature $parameter) : string { return $parameter->getName(); }, $functionSignaturesResult['positional'][0]->getParameters())); if ($phpDoc !== null) { if ($phpDoc->hasPhpDocString()) { $docComment = $phpDoc->getPhpDocString(); } if ($phpDoc->getThrowsTag() !== null) { $throwType = $phpDoc->getThrowsTag()->getType(); } $asserts = Assertions::createFromResolvedPhpDocBlock($phpDoc); $phpDocReturnType = $this->getReturnTypeFromPhpDoc($phpDoc); $acceptsNamedArguments = $phpDoc->acceptsNamedArguments(); } $variantsByType = ['positional' => []]; foreach ($functionSignaturesResult as $signatureType => $functionSignatures) { foreach ($functionSignatures ?? [] as $functionSignature) { $variantsByType[$signatureType][] = new FunctionVariantWithPhpDocs(TemplateTypeMap::createEmpty(), null, array_map(static function (\PHPStan\Reflection\SignatureMap\ParameterSignature $parameterSignature) use($phpDoc) : NativeParameterWithPhpDocsReflection { $type = $parameterSignature->getType(); $phpDocType = null; $immediatelyInvokedCallable = TrinaryLogic::createMaybe(); $closureThisType = null; if ($phpDoc !== null) { if (array_key_exists($parameterSignature->getName(), $phpDoc->getParamTags())) { $phpDocType = $phpDoc->getParamTags()[$parameterSignature->getName()]->getType(); } if (array_key_exists($parameterSignature->getName(), $phpDoc->getParamsImmediatelyInvokedCallable())) { $immediatelyInvokedCallable = TrinaryLogic::createFromBoolean($phpDoc->getParamsImmediatelyInvokedCallable()[$parameterSignature->getName()]); } if (array_key_exists($parameterSignature->getName(), $phpDoc->getParamClosureThisTags())) { $closureThisType = $phpDoc->getParamClosureThisTags()[$parameterSignature->getName()]->getType(); } } return new NativeParameterWithPhpDocsReflection($parameterSignature->getName(), $parameterSignature->isOptional(), TypehintHelper::decideType($type, $phpDocType), $phpDocType ?? new MixedType(), $type, $parameterSignature->passedByReference(), $parameterSignature->isVariadic(), $parameterSignature->getDefaultValue(), $phpDoc !== null ? \PHPStan\Reflection\SignatureMap\NativeFunctionReflectionProvider::getParamOutTypeFromPhpDoc($parameterSignature->getName(), $phpDoc) : null, $immediatelyInvokedCallable, $closureThisType); }, $functionSignature->getParameters()), $functionSignature->isVariadic(), TypehintHelper::decideType($functionSignature->getReturnType(), $phpDocReturnType), $phpDocReturnType ?? new MixedType(), $functionSignature->getReturnType()); } } if ($this->signatureMapProvider->hasFunctionMetadata($lowerCasedFunctionName)) { $hasSideEffects = TrinaryLogic::createFromBoolean($this->signatureMapProvider->getFunctionMetadata($lowerCasedFunctionName)['hasSideEffects']); } else { $hasSideEffects = TrinaryLogic::createMaybe(); } $functionReflection = new NativeFunctionReflection($realFunctionName, $variantsByType['positional'], $variantsByType['named'] ?? null, $throwType, $hasSideEffects, $isDeprecated, $asserts, $docComment, $returnsByReference, $acceptsNamedArguments); $this->functionMap[$lowerCasedFunctionName] = $functionReflection; return $functionReflection; } private function getReturnTypeFromPhpDoc(ResolvedPhpDocBlock $phpDoc) : ?Type { $returnTag = $phpDoc->getReturnTag(); if ($returnTag === null) { return null; } return $returnTag->getType(); } private static function getParamOutTypeFromPhpDoc(string $paramName, ResolvedPhpDocBlock $stubPhpDoc) : ?Type { $paramOutTags = $stubPhpDoc->getParamOutTags(); if (array_key_exists($paramName, $paramOutTags)) { return $paramOutTags[$paramName]->getType(); } return null; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\SignatureMap; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionMethod; use PHPStan\Type\Type; use ReflectionFunctionAbstract; interface SignatureMapProvider { public function hasMethodSignature(string $className, string $methodName) : bool; public function hasFunctionSignature(string $name) : bool; /** @return array{positional: array<int, FunctionSignature>, named: ?array<int, FunctionSignature>} */ public function getMethodSignatures(string $className, string $methodName, ?ReflectionMethod $reflectionMethod) : array; /** @return array{positional: array<int, FunctionSignature>, named: ?array<int, FunctionSignature>} */ public function getFunctionSignatures(string $functionName, ?string $className, ?ReflectionFunctionAbstract $reflectionFunction) : array; public function hasMethodMetadata(string $className, string $methodName) : bool; public function hasFunctionMetadata(string $name) : bool; /** * @return array{hasSideEffects: bool} */ public function getMethodMetadata(string $className, string $methodName) : array; /** * @return array{hasSideEffects: bool} */ public function getFunctionMetadata(string $functionName) : array; public function hasClassConstantMetadata(string $className, string $constantName) : bool; /** * @return array{nativeType: Type} */ public function getClassConstantMetadata(string $className, string $constantName) : array; } <?php declare (strict_types=1); namespace PHPStan\Reflection\SignatureMap; use PHPStan\Type\Type; final class FunctionSignature { /** * @var array<int, ParameterSignature> */ private $parameters; /** * @var Type */ private $returnType; /** * @var Type */ private $nativeReturnType; /** * @var bool */ private $variadic; /** * @param array<int, ParameterSignature> $parameters */ public function __construct(array $parameters, Type $returnType, Type $nativeReturnType, bool $variadic) { $this->parameters = $parameters; $this->returnType = $returnType; $this->nativeReturnType = $nativeReturnType; $this->variadic = $variadic; } /** * @return array<int, ParameterSignature> */ public function getParameters() : array { return $this->parameters; } public function getReturnType() : Type { return $this->returnType; } public function getNativeReturnType() : Type { return $this->nativeReturnType; } public function isVariadic() : bool { return $this->variadic; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\SignatureMap; use _PHPStan_7d8742a37\Nette\Utils\Strings; use PHPStan\Analyser\NameScope; use PHPStan\PhpDoc\TypeStringResolver; use PHPStan\Reflection\PassedByReference; use PHPStan\ShouldNotHappenException; use PHPStan\Type\MixedType; use PHPStan\Type\Type; use function array_slice; use function str_starts_with; use function substr; final class SignatureMapParser { /** * @var TypeStringResolver */ private $typeStringResolver; public function __construct(TypeStringResolver $typeNodeResolver) { $this->typeStringResolver = $typeNodeResolver; } /** * @param mixed[] $map */ public function getFunctionSignature(array $map, ?string $className) : \PHPStan\Reflection\SignatureMap\FunctionSignature { $parameterSignatures = $this->getParameters(array_slice($map, 1)); $hasVariadic = \false; foreach ($parameterSignatures as $parameterSignature) { if ($parameterSignature->isVariadic()) { $hasVariadic = \true; break; } } return new \PHPStan\Reflection\SignatureMap\FunctionSignature($parameterSignatures, $this->getTypeFromString($map[0], $className), new MixedType(), $hasVariadic); } private function getTypeFromString(string $typeString, ?string $className) : Type { if ($typeString === '') { return new MixedType(\true); } return $this->typeStringResolver->resolve($typeString, new NameScope(null, [], $className)); } /** * @param array<string, string> $parameterMap * @return array<int, ParameterSignature> */ private function getParameters(array $parameterMap) : array { $parameterSignatures = []; foreach ($parameterMap as $parameterName => $typeString) { [$name, $isOptional, $passedByReference, $isVariadic] = $this->getParameterInfoFromName($parameterName); $parameterSignatures[] = new \PHPStan\Reflection\SignatureMap\ParameterSignature($name, $isOptional, $this->getTypeFromString($typeString, null), new MixedType(), $passedByReference, $isVariadic, null, null); } return $parameterSignatures; } /** * @return mixed[] */ private function getParameterInfoFromName(string $parameterNameString) : array { $matches = Strings::match($parameterNameString, '#^(?P<reference>&(?:\\.\\.\\.)?r?w?_?)?(?P<variadic>\\.\\.\\.)?(?P<name>[^=]+)?(?P<optional>=)?($)#'); if ($matches === null || !isset($matches['optional'])) { throw new ShouldNotHappenException(); } $isVariadic = $matches['variadic'] !== ''; $reference = $matches['reference']; if (str_starts_with($reference, '&...')) { $reference = '&' . substr($reference, 4); $isVariadic = \true; } if (str_starts_with($reference, '&rw')) { $passedByReference = PassedByReference::createReadsArgument(); } elseif (str_starts_with($reference, '&')) { $passedByReference = PassedByReference::createCreatesNewVariable(); } else { $passedByReference = PassedByReference::createNo(); } $isOptional = $isVariadic || $matches['optional'] !== ''; $name = $matches['name'] !== '' ? $matches['name'] : '...'; return [$name, $isOptional, $passedByReference, $isVariadic]; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\SignatureMap; use PHPStan\Reflection\PassedByReference; use PHPStan\Type\Type; final class ParameterSignature { /** * @var string */ private $name; /** * @var bool */ private $optional; /** * @var Type */ private $type; /** * @var Type */ private $nativeType; /** * @var PassedByReference */ private $passedByReference; /** * @var bool */ private $variadic; /** * @var ?Type */ private $defaultValue; /** * @var ?Type */ private $outType; public function __construct(string $name, bool $optional, Type $type, Type $nativeType, PassedByReference $passedByReference, bool $variadic, ?Type $defaultValue, ?Type $outType) { $this->name = $name; $this->optional = $optional; $this->type = $type; $this->nativeType = $nativeType; $this->passedByReference = $passedByReference; $this->variadic = $variadic; $this->defaultValue = $defaultValue; $this->outType = $outType; } public function getName() : string { return $this->name; } public function isOptional() : bool { return $this->optional; } public function getType() : Type { return $this->type; } public function getNativeType() : Type { return $this->nativeType; } public function passedByReference() : PassedByReference { return $this->passedByReference; } public function isVariadic() : bool { return $this->variadic; } public function getDefaultValue() : ?Type { return $this->defaultValue; } public function getOutType() : ?Type { return $this->outType; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\SignatureMap; use PhpParser\Node\AttributeGroup; use PhpParser\Node\Expr\Variable; use PhpParser\Node\Scalar\String_; use PhpParser\Node\Stmt\ClassConst; use PhpParser\Node\Stmt\ClassMethod; use PhpParser\Node\Stmt\Function_; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionMethod; use PHPStan\Php\PhpVersion; use PHPStan\Php8StubsMap; use PHPStan\PhpDoc\Tag\ParamTag; use PHPStan\Reflection\BetterReflection\SourceLocator\FileNodesFetcher; use PHPStan\Reflection\InitializerExprContext; use PHPStan\Reflection\InitializerExprTypeResolver; use PHPStan\Reflection\PassedByReference; use PHPStan\Reflection\ReflectionProvider\ReflectionProviderProvider; use PHPStan\ShouldNotHappenException; use PHPStan\Type\FileTypeMapper; use PHPStan\Type\MixedType; use PHPStan\Type\ParserNodeTypeToPHPStanType; use PHPStan\Type\Type; use PHPStan\Type\TypehintHelper; use ReflectionFunctionAbstract; use function array_key_exists; use function array_map; use function count; use function explode; use function is_string; use function sprintf; use function strtolower; final class Php8SignatureMapProvider implements \PHPStan\Reflection\SignatureMap\SignatureMapProvider { /** * @var FunctionSignatureMapProvider */ private $functionSignatureMapProvider; /** * @var FileNodesFetcher */ private $fileNodesFetcher; /** * @var FileTypeMapper */ private $fileTypeMapper; /** * @var PhpVersion */ private $phpVersion; /** * @var InitializerExprTypeResolver */ private $initializerExprTypeResolver; /** * @var ReflectionProviderProvider */ private $reflectionProviderProvider; private const DIRECTORY = __DIR__ . '/../../../vendor/phpstan/php-8-stubs'; /** @var array<string, array<string, array{ClassMethod, string}>> */ private $methodNodes = []; /** @var array<string, array<string, Type|null>> */ private $constantTypes = []; /** * @var Php8StubsMap */ private $map; public function __construct(\PHPStan\Reflection\SignatureMap\FunctionSignatureMapProvider $functionSignatureMapProvider, FileNodesFetcher $fileNodesFetcher, FileTypeMapper $fileTypeMapper, PhpVersion $phpVersion, InitializerExprTypeResolver $initializerExprTypeResolver, ReflectionProviderProvider $reflectionProviderProvider) { $this->functionSignatureMapProvider = $functionSignatureMapProvider; $this->fileNodesFetcher = $fileNodesFetcher; $this->fileTypeMapper = $fileTypeMapper; $this->phpVersion = $phpVersion; $this->initializerExprTypeResolver = $initializerExprTypeResolver; $this->reflectionProviderProvider = $reflectionProviderProvider; $this->map = new Php8StubsMap($phpVersion->getVersionId()); } public function hasMethodSignature(string $className, string $methodName) : bool { $lowerClassName = strtolower($className); if ($lowerClassName === 'backedenum') { return \false; } if (!array_key_exists($lowerClassName, $this->map->classes)) { return $this->functionSignatureMapProvider->hasMethodSignature($className, $methodName); } if ($this->findMethodNode($className, $methodName) === null) { return $this->functionSignatureMapProvider->hasMethodSignature($className, $methodName); } return \true; } /** * @return array{ClassMethod, string}|null */ private function findMethodNode(string $className, string $methodName) : ?array { $lowerClassName = strtolower($className); $lowerMethodName = strtolower($methodName); if (isset($this->methodNodes[$lowerClassName][$lowerMethodName])) { return $this->methodNodes[$lowerClassName][$lowerMethodName]; } $stubFile = self::DIRECTORY . '/' . $this->map->classes[$lowerClassName]; $nodes = $this->fileNodesFetcher->fetchNodes($stubFile); $classes = $nodes->getClassNodes(); if (count($classes) !== 1) { throw new ShouldNotHappenException(sprintf('Class %s stub not found in %s.', $className, $stubFile)); } $class = $classes[$lowerClassName]; if (count($class) !== 1) { throw new ShouldNotHappenException(sprintf('Class %s stub not found in %s.', $className, $stubFile)); } foreach ($class[0]->getNode()->stmts as $stmt) { if (!$stmt instanceof ClassMethod) { continue; } if ($stmt->name->toLowerString() === $lowerMethodName) { if (!$this->isForCurrentVersion($stmt->attrGroups)) { continue; } return $this->methodNodes[$lowerClassName][$lowerMethodName] = [$stmt, $stubFile]; } } return null; } /** * @param AttributeGroup[] $attrGroups */ private function isForCurrentVersion(array $attrGroups) : bool { foreach ($attrGroups as $attrGroup) { foreach ($attrGroup->attrs as $attr) { if ($attr->name->toString() === 'Until') { $arg = $attr->args[0]->value; if (!$arg instanceof String_) { throw new ShouldNotHappenException(); } $parts = explode('.', $arg->value); $versionId = (int) $parts[0] * 10000 + (int) ($parts[1] ?? 0) * 100 + (int) ($parts[2] ?? 0); if ($this->phpVersion->getVersionId() >= $versionId) { return \false; } } if ($attr->name->toString() !== 'Since') { continue; } $arg = $attr->args[0]->value; if (!$arg instanceof String_) { throw new ShouldNotHappenException(); } $parts = explode('.', $arg->value); $versionId = (int) $parts[0] * 10000 + (int) ($parts[1] ?? 0) * 100 + (int) ($parts[2] ?? 0); if ($this->phpVersion->getVersionId() < $versionId) { return \false; } } } return \true; } public function hasFunctionSignature(string $name) : bool { $lowerName = strtolower($name); if (!array_key_exists($lowerName, $this->map->functions)) { return $this->functionSignatureMapProvider->hasFunctionSignature($name); } return \true; } public function getMethodSignatures(string $className, string $methodName, ?ReflectionMethod $reflectionMethod) : array { $lowerClassName = strtolower($className); if (!array_key_exists($lowerClassName, $this->map->classes)) { return $this->functionSignatureMapProvider->getMethodSignatures($className, $methodName, $reflectionMethod); } $methodNode = $this->findMethodNode($className, $methodName); if ($methodNode === null) { return $this->functionSignatureMapProvider->getMethodSignatures($className, $methodName, $reflectionMethod); } [$methodNode, $stubFile] = $methodNode; $signature = $this->getSignature($methodNode, $className, $stubFile); if ($this->functionSignatureMapProvider->hasMethodSignature($className, $methodName)) { $functionMapSignatures = $this->functionSignatureMapProvider->getMethodSignatures($className, $methodName, $reflectionMethod); return $this->getMergedSignatures($signature, $functionMapSignatures); } return ['positional' => [$signature], 'named' => null]; } /** * @param ReflectionFunctionAbstract|null $reflectionFunction */ public function getFunctionSignatures(string $functionName, ?string $className, $reflectionFunction) : array { $lowerName = strtolower($functionName); if (!array_key_exists($lowerName, $this->map->functions)) { return $this->functionSignatureMapProvider->getFunctionSignatures($functionName, $className, $reflectionFunction); } $stubFile = self::DIRECTORY . '/' . $this->map->functions[$lowerName]; $nodes = $this->fileNodesFetcher->fetchNodes($stubFile); $functions = $nodes->getFunctionNodes(); if (!array_key_exists($lowerName, $functions)) { throw new ShouldNotHappenException(sprintf('Function %s stub not found in %s.', $functionName, $stubFile)); } foreach ($functions[$lowerName] as $functionNode) { if (!$this->isForCurrentVersion($functionNode->getNode()->getAttrGroups())) { continue; } $signature = $this->getSignature($functionNode->getNode(), null, $stubFile); if ($this->functionSignatureMapProvider->hasFunctionSignature($functionName)) { $functionMapSignatures = $this->functionSignatureMapProvider->getFunctionSignatures($functionName, $className, $reflectionFunction); return $this->getMergedSignatures($signature, $functionMapSignatures); } return ['positional' => [$signature], 'named' => null]; } throw new ShouldNotHappenException(sprintf('Function %s stub not found in %s.', $functionName, $stubFile)); } /** * @param array{positional: array<int, FunctionSignature>, named: ?array<int, FunctionSignature>} $functionMapSignatures * @return array{positional: array<int, FunctionSignature>, named: ?array<int, FunctionSignature>} */ private function getMergedSignatures(\PHPStan\Reflection\SignatureMap\FunctionSignature $nativeSignature, array $functionMapSignatures) : array { if (count($functionMapSignatures['positional']) === 1) { return ['positional' => [$this->mergeSignatures($nativeSignature, $functionMapSignatures['positional'][0])], 'named' => null]; } if (count($functionMapSignatures['positional']) === 0) { return ['positional' => [], 'named' => null]; } $nativeParams = $nativeSignature->getParameters(); $namedArgumentsVariants = []; $allParamNamesMatchNative = \true; foreach ($functionMapSignatures['positional'] as $functionMapSignature) { $isPrevParamVariadic = \false; $hasMiddleVariadicParam = \false; // avoid weird functions like array_diff_uassoc foreach ($functionMapSignature->getParameters() as $i => $functionParam) { $nativeParam = $nativeParams[$i] ?? null; $allParamNamesMatchNative = $allParamNamesMatchNative && $nativeParam !== null && $functionParam->getName() === $nativeParam->getName(); $hasMiddleVariadicParam = $hasMiddleVariadicParam || $isPrevParamVariadic; $isPrevParamVariadic = $functionParam->isVariadic() || ($nativeParam !== null ? $nativeParam->isVariadic() : \false); } if ($hasMiddleVariadicParam) { continue; } $parameters = []; foreach ($functionMapSignature->getParameters() as $i => $functionParam) { if (!array_key_exists($i, $nativeParams)) { continue 2; } // it seems that variadic parameters cannot be named in native functions/methods. $nativeParam = $nativeParams[$i]; if ($nativeParam->isVariadic()) { break; } $parameters[] = new \PHPStan\Reflection\SignatureMap\ParameterSignature($nativeParam->getName(), $functionParam->isOptional(), $functionParam->getType(), $functionParam->getNativeType(), $functionParam->passedByReference(), $functionParam->isVariadic(), $functionParam->getDefaultValue(), $functionParam->getOutType()); } $namedArgumentsVariants[] = new \PHPStan\Reflection\SignatureMap\FunctionSignature($parameters, $functionMapSignature->getReturnType(), $functionMapSignature->getNativeReturnType(), $functionMapSignature->isVariadic()); } if ($allParamNamesMatchNative || count($namedArgumentsVariants) === 0) { $namedArgumentsVariants = null; } return ['positional' => $functionMapSignatures['positional'], 'named' => $namedArgumentsVariants]; } private function mergeSignatures(\PHPStan\Reflection\SignatureMap\FunctionSignature $nativeSignature, \PHPStan\Reflection\SignatureMap\FunctionSignature $functionMapSignature) : \PHPStan\Reflection\SignatureMap\FunctionSignature { $parameters = []; foreach ($nativeSignature->getParameters() as $i => $nativeParameter) { if (!array_key_exists($i, $functionMapSignature->getParameters())) { $parameters[] = $nativeParameter; continue; } $functionMapParameter = $functionMapSignature->getParameters()[$i]; $nativeParameterType = $nativeParameter->getNativeType(); $parameters[] = new \PHPStan\Reflection\SignatureMap\ParameterSignature($nativeParameter->getName(), $nativeParameter->isOptional(), TypehintHelper::decideType($nativeParameterType, TypehintHelper::decideType($nativeParameter->getType(), $functionMapParameter->getType())), $nativeParameterType, $nativeParameter->passedByReference()->yes() ? $functionMapParameter->passedByReference() : $nativeParameter->passedByReference(), $nativeParameter->isVariadic(), $nativeParameter->getDefaultValue(), $nativeParameter->getOutType()); } $nativeReturnType = $nativeSignature->getNativeReturnType(); if ($nativeReturnType instanceof MixedType && !$nativeReturnType->isExplicitMixed()) { $returnType = $functionMapSignature->getReturnType(); } else { $returnType = TypehintHelper::decideType($nativeReturnType, TypehintHelper::decideType($nativeSignature->getReturnType(), $functionMapSignature->getReturnType())); } return new \PHPStan\Reflection\SignatureMap\FunctionSignature($parameters, $returnType, $nativeReturnType, $nativeSignature->isVariadic()); } public function hasMethodMetadata(string $className, string $methodName) : bool { return $this->functionSignatureMapProvider->hasMethodMetadata($className, $methodName); } public function hasFunctionMetadata(string $name) : bool { return $this->functionSignatureMapProvider->hasFunctionMetadata($name); } /** * @return array{hasSideEffects: bool} */ public function getMethodMetadata(string $className, string $methodName) : array { return $this->functionSignatureMapProvider->getMethodMetadata($className, $methodName); } /** * @return array{hasSideEffects: bool} */ public function getFunctionMetadata(string $functionName) : array { return $this->functionSignatureMapProvider->getFunctionMetadata($functionName); } /** * @param ClassMethod|Function_ $function */ private function getSignature($function, ?string $className, string $stubFile) : \PHPStan\Reflection\SignatureMap\FunctionSignature { $phpDocParameterTypes = null; $phpDocReturnType = null; if ($function->getDocComment() !== null) { if ($function instanceof ClassMethod) { $functionName = $function->name->toString(); } elseif ($function->namespacedName !== null) { $functionName = $function->namespacedName->toString(); } else { throw new ShouldNotHappenException(); } $phpDoc = $this->fileTypeMapper->getResolvedPhpDoc($stubFile, $className, null, $functionName, $function->getDocComment()->getText()); $phpDocParameterTypes = array_map(static function (ParamTag $param) : Type { return $param->getType(); }, $phpDoc->getParamTags()); if ($phpDoc->getReturnTag() !== null) { $phpDocReturnType = $phpDoc->getReturnTag()->getType(); } } $classReflection = null; if ($className !== null) { $reflectionProvider = $this->reflectionProviderProvider->getReflectionProvider(); $classReflection = $reflectionProvider->getClass($className); } $parameters = []; $variadic = \false; foreach ($function->getParams() as $param) { $name = $param->var; if (!$name instanceof Variable || !is_string($name->name)) { throw new ShouldNotHappenException(); } $parameterType = ParserNodeTypeToPHPStanType::resolve($param->type, $classReflection); $parameters[] = new \PHPStan\Reflection\SignatureMap\ParameterSignature($name->name, $param->default !== null || $param->variadic, TypehintHelper::decideType($parameterType, $phpDocParameterTypes[$name->name] ?? null), $parameterType, $param->byRef ? PassedByReference::createCreatesNewVariable() : PassedByReference::createNo(), $param->variadic, $param->default !== null ? $this->initializerExprTypeResolver->getType($param->default, InitializerExprContext::fromStubParameter($className, $stubFile, $function)) : null, null); $variadic = $variadic || $param->variadic; } $returnType = ParserNodeTypeToPHPStanType::resolve($function->getReturnType(), $classReflection); return new \PHPStan\Reflection\SignatureMap\FunctionSignature($parameters, TypehintHelper::decideType($returnType, $phpDocReturnType ?? null), $returnType, $variadic); } public function hasClassConstantMetadata(string $className, string $constantName) : bool { $lowerClassName = strtolower($className); if (!array_key_exists($lowerClassName, $this->map->classes)) { return \false; } return $this->findConstantType($className, $constantName) !== null; } public function getClassConstantMetadata(string $className, string $constantName) : array { $lowerClassName = strtolower($className); if (!array_key_exists($lowerClassName, $this->map->classes)) { throw new ShouldNotHappenException(); } $type = $this->findConstantType($className, $constantName); if ($type === null) { throw new ShouldNotHappenException(); } return ['nativeType' => $type]; } private function findConstantType(string $className, string $constantName) : ?Type { $lowerClassName = strtolower($className); $lowerConstantName = strtolower($constantName); if (isset($this->constantTypes[$lowerClassName][$lowerConstantName])) { return $this->constantTypes[$lowerClassName][$lowerConstantName]; } $stubFile = self::DIRECTORY . '/' . $this->map->classes[$lowerClassName]; $nodes = $this->fileNodesFetcher->fetchNodes($stubFile); $classes = $nodes->getClassNodes(); if (count($classes) !== 1) { throw new ShouldNotHappenException(sprintf('Class %s stub not found in %s.', $className, $stubFile)); } $class = $classes[$lowerClassName]; if (count($class) !== 1) { throw new ShouldNotHappenException(sprintf('Class %s stub not found in %s.', $className, $stubFile)); } foreach ($class[0]->getNode()->stmts as $stmt) { if (!$stmt instanceof ClassConst) { continue; } foreach ($stmt->consts as $const) { if ($const->name->toString() !== $constantName) { continue; } if (!$this->isForCurrentVersion($stmt->attrGroups)) { continue; } if ($stmt->type === null) { return null; } return $this->constantTypes[$lowerClassName][$lowerConstantName] = ParserNodeTypeToPHPStanType::resolve($stmt->type, null); } } return null; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\SignatureMap; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionFunction; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionMethod; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\InitializerExprContext; use PHPStan\Reflection\InitializerExprTypeResolver; use PHPStan\ShouldNotHappenException; use PHPStan\Type\MixedType; use PHPStan\Type\TypehintHelper; use ReflectionFunctionAbstract; use function array_change_key_case; use function array_key_exists; use function array_keys; use function is_array; use function sprintf; use function strtolower; use const CASE_LOWER; final class FunctionSignatureMapProvider implements \PHPStan\Reflection\SignatureMap\SignatureMapProvider { /** * @var SignatureMapParser */ private $parser; /** * @var InitializerExprTypeResolver */ private $initializerExprTypeResolver; /** * @var PhpVersion */ private $phpVersion; /** * @var bool */ private $stricterFunctionMap; /** @var array<string, mixed[]> */ private static $signatureMaps = []; /** @var array<string, array{hasSideEffects: bool}>|null */ private static $functionMetadata = null; public function __construct(\PHPStan\Reflection\SignatureMap\SignatureMapParser $parser, InitializerExprTypeResolver $initializerExprTypeResolver, PhpVersion $phpVersion, bool $stricterFunctionMap) { $this->parser = $parser; $this->initializerExprTypeResolver = $initializerExprTypeResolver; $this->phpVersion = $phpVersion; $this->stricterFunctionMap = $stricterFunctionMap; } public function hasMethodSignature(string $className, string $methodName) : bool { return $this->hasFunctionSignature(sprintf('%s::%s', $className, $methodName)); } public function hasFunctionSignature(string $name) : bool { return array_key_exists(strtolower($name), $this->getSignatureMap()); } public function getMethodSignatures(string $className, string $methodName, ?ReflectionMethod $reflectionMethod) : array { return $this->getFunctionSignatures(sprintf('%s::%s', $className, $methodName), $className, $reflectionMethod); } public function getFunctionSignatures(string $functionName, ?string $className, ?ReflectionFunctionAbstract $reflectionFunction) : array { $functionName = strtolower($functionName); $signatures = [$this->createSignature($functionName, $className, $reflectionFunction)]; $i = 1; $variantFunctionName = $functionName . '\'' . $i; while ($this->hasFunctionSignature($variantFunctionName)) { $signatures[] = $this->createSignature($variantFunctionName, $className, $reflectionFunction); $i++; $variantFunctionName = $functionName . '\'' . $i; } return ['positional' => $signatures, 'named' => null]; } private function createSignature(string $functionName, ?string $className, ?ReflectionFunctionAbstract $reflectionFunction) : \PHPStan\Reflection\SignatureMap\FunctionSignature { if (!$reflectionFunction instanceof ReflectionMethod && !$reflectionFunction instanceof ReflectionFunction && $reflectionFunction !== null) { throw new ShouldNotHappenException(); } $signatureMap = self::getSignatureMap(); $signature = $this->parser->getFunctionSignature($signatureMap[$functionName], $className); $parameters = []; foreach ($signature->getParameters() as $i => $parameter) { if ($reflectionFunction === null) { $parameters[] = $parameter; continue; } $nativeParameters = $reflectionFunction->getParameters(); if (!array_key_exists($i, $nativeParameters)) { $parameters[] = $parameter; continue; } $parameters[] = new \PHPStan\Reflection\SignatureMap\ParameterSignature($parameter->getName(), $parameter->isOptional(), $parameter->getType(), TypehintHelper::decideTypeFromReflection($nativeParameters[$i]->getType()), $parameter->passedByReference(), $parameter->isVariadic(), $nativeParameters[$i]->isDefaultValueAvailable() ? $this->initializerExprTypeResolver->getType($nativeParameters[$i]->getDefaultValueExpression(), InitializerExprContext::fromReflectionParameter($nativeParameters[$i])) : null, $parameter->getOutType()); } if ($reflectionFunction === null) { $nativeReturnType = new MixedType(); } else { $nativeReturnType = TypehintHelper::decideTypeFromReflection($reflectionFunction->getReturnType()); } return new \PHPStan\Reflection\SignatureMap\FunctionSignature($parameters, $signature->getReturnType(), $nativeReturnType, $signature->isVariadic()); } public function hasMethodMetadata(string $className, string $methodName) : bool { return $this->hasFunctionMetadata(sprintf('%s::%s', $className, $methodName)); } public function hasFunctionMetadata(string $name) : bool { $signatureMap = self::getFunctionMetadataMap(); return array_key_exists(strtolower($name), $signatureMap); } /** * @return array{hasSideEffects: bool} */ public function getMethodMetadata(string $className, string $methodName) : array { return $this->getFunctionMetadata(sprintf('%s::%s', $className, $methodName)); } /** * @return array{hasSideEffects: bool} */ public function getFunctionMetadata(string $functionName) : array { $functionName = strtolower($functionName); if (!$this->hasFunctionMetadata($functionName)) { throw new ShouldNotHappenException(); } return self::getFunctionMetadataMap()[$functionName]; } /** * @return array<string, array{hasSideEffects: bool}> */ private static function getFunctionMetadataMap() : array { if (self::$functionMetadata === null) { /** @var array<string, array{hasSideEffects: bool}> $metadata */ $metadata = (require __DIR__ . '/../../../resources/functionMetadata.php'); self::$functionMetadata = array_change_key_case($metadata, CASE_LOWER); } return self::$functionMetadata; } /** * @return mixed[] */ public function getSignatureMap() : array { $cacheKey = sprintf('%d-%d', $this->phpVersion->getVersionId(), $this->stricterFunctionMap ? 1 : 0); if (array_key_exists($cacheKey, self::$signatureMaps)) { return self::$signatureMaps[$cacheKey]; } $signatureMap = (require __DIR__ . '/../../../resources/functionMap.php'); if (!is_array($signatureMap)) { throw new ShouldNotHappenException('Signature map could not be loaded.'); } $signatureMap = array_change_key_case($signatureMap, CASE_LOWER); if ($this->stricterFunctionMap) { $signatureMap = $this->computeSignatureMapFile($signatureMap, __DIR__ . '/../../../resources/functionMap_bleedingEdge.php'); } if ($this->phpVersion->getVersionId() >= 70400) { $signatureMap = $this->computeSignatureMapFile($signatureMap, __DIR__ . '/../../../resources/functionMap_php74delta.php'); } if ($this->phpVersion->getVersionId() >= 80000) { $signatureMap = $this->computeSignatureMapFile($signatureMap, __DIR__ . '/../../../resources/functionMap_php80delta.php'); if ($this->stricterFunctionMap) { $signatureMap = $this->computeSignatureMapFile($signatureMap, __DIR__ . '/../../../resources/functionMap_php80delta_bleedingEdge.php'); } } if ($this->phpVersion->getVersionId() >= 80100) { $signatureMap = $this->computeSignatureMapFile($signatureMap, __DIR__ . '/../../../resources/functionMap_php81delta.php'); } if ($this->phpVersion->getVersionId() >= 80200) { $signatureMap = $this->computeSignatureMapFile($signatureMap, __DIR__ . '/../../../resources/functionMap_php82delta.php'); } if ($this->phpVersion->getVersionId() >= 80300) { $signatureMap = $this->computeSignatureMapFile($signatureMap, __DIR__ . '/../../../resources/functionMap_php83delta.php'); } if ($this->phpVersion->getVersionId() >= 80400) { $signatureMap = $this->computeSignatureMapFile($signatureMap, __DIR__ . '/../../../resources/functionMap_php84delta.php'); } return self::$signatureMaps[$cacheKey] = $signatureMap; } /** * @param array<string, mixed> $signatureMap * @return array<string, mixed> */ private function computeSignatureMapFile(array $signatureMap, string $file) : array { $signatureMapDelta = (include $file); if (!is_array($signatureMapDelta)) { throw new ShouldNotHappenException(sprintf('Signature map file "%s" could not be loaded.', $file)); } return $this->computeSignatureMap($signatureMap, $signatureMapDelta); } /** * @param array<string, mixed> $signatureMap * @param array<string, array<string, mixed>> $delta * @return array<string, mixed> */ private function computeSignatureMap(array $signatureMap, array $delta) : array { foreach (array_keys($delta['old']) as $key) { unset($signatureMap[strtolower($key)]); } foreach ($delta['new'] as $key => $signature) { $signatureMap[strtolower($key)] = $signature; } return $signatureMap; } public function hasClassConstantMetadata(string $className, string $constantName) : bool { return \false; } public function getClassConstantMetadata(string $className, string $constantName) : array { throw new ShouldNotHappenException(); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\SignatureMap; use PHPStan\Php\PhpVersion; final class SignatureMapProviderFactory { /** * @var PhpVersion */ private $phpVersion; /** * @var FunctionSignatureMapProvider */ private $functionSignatureMapProvider; /** * @var Php8SignatureMapProvider */ private $php8SignatureMapProvider; public function __construct(PhpVersion $phpVersion, \PHPStan\Reflection\SignatureMap\FunctionSignatureMapProvider $functionSignatureMapProvider, \PHPStan\Reflection\SignatureMap\Php8SignatureMapProvider $php8SignatureMapProvider) { $this->phpVersion = $phpVersion; $this->functionSignatureMapProvider = $functionSignatureMapProvider; $this->php8SignatureMapProvider = $php8SignatureMapProvider; } public function create() : \PHPStan\Reflection\SignatureMap\SignatureMapProvider { if ($this->phpVersion->getVersionId() < 80000) { return $this->functionSignatureMapProvider; } return $this->php8SignatureMapProvider; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Native; use PHPStan\Reflection\ParameterReflection; use PHPStan\Reflection\PassedByReference; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; final class NativeParameterReflection implements ParameterReflection { /** * @var string */ private $name; /** * @var bool */ private $optional; /** * @var Type */ private $type; /** * @var PassedByReference */ private $passedByReference; /** * @var bool */ private $variadic; /** * @var ?Type */ private $defaultValue; public function __construct(string $name, bool $optional, Type $type, PassedByReference $passedByReference, bool $variadic, ?Type $defaultValue) { $this->name = $name; $this->optional = $optional; $this->type = $type; $this->passedByReference = $passedByReference; $this->variadic = $variadic; $this->defaultValue = $defaultValue; } public function getName() : string { return $this->name; } public function isOptional() : bool { return $this->optional; } public function getType() : Type { return $this->type; } public function passedByReference() : PassedByReference { return $this->passedByReference; } public function isVariadic() : bool { return $this->variadic; } public function getDefaultValue() : ?Type { return $this->defaultValue; } public function union(self $other) : self { return new self($this->name, $this->optional && $other->optional, TypeCombinator::union($this->type, $other->type), $this->passedByReference->combine($other->passedByReference), $this->variadic && $other->variadic, $this->optional && $other->optional ? $this->defaultValue : null); } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : self { return new self($properties['name'], $properties['optional'], $properties['type'], $properties['passedByReference'], $properties['variadic'], $properties['defaultValue']); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Native; use PHPStan\Reflection\Assertions; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\ParametersAcceptorWithPhpDocs; use PHPStan\ShouldNotHappenException; use PHPStan\TrinaryLogic; use PHPStan\Type\Type; use function count; final class NativeFunctionReflection implements FunctionReflection { /** * @var string */ private $name; /** * @var ParametersAcceptorWithPhpDocs[] */ private $variants; /** * @var ParametersAcceptorWithPhpDocs[]|null */ private $namedArgumentsVariants; /** * @var ?Type */ private $throwType; /** * @var TrinaryLogic */ private $hasSideEffects; /** * @var bool */ private $isDeprecated; /** * @var ?string */ private $phpDocComment; /** * @var bool */ private $acceptsNamedArguments; /** * @var Assertions */ private $assertions; /** * @var TrinaryLogic */ private $returnsByReference; /** * @param ParametersAcceptorWithPhpDocs[] $variants * @param ParametersAcceptorWithPhpDocs[]|null $namedArgumentsVariants */ public function __construct(string $name, array $variants, ?array $namedArgumentsVariants, ?Type $throwType, TrinaryLogic $hasSideEffects, bool $isDeprecated, ?Assertions $assertions = null, ?string $phpDocComment = null, ?TrinaryLogic $returnsByReference = null, bool $acceptsNamedArguments = \true) { $this->name = $name; $this->variants = $variants; $this->namedArgumentsVariants = $namedArgumentsVariants; $this->throwType = $throwType; $this->hasSideEffects = $hasSideEffects; $this->isDeprecated = $isDeprecated; $this->phpDocComment = $phpDocComment; $this->acceptsNamedArguments = $acceptsNamedArguments; $this->assertions = $assertions ?? Assertions::createEmpty(); $this->returnsByReference = $returnsByReference ?? TrinaryLogic::createMaybe(); } public function getName() : string { return $this->name; } public function getFileName() : ?string { return null; } public function getVariants() : array { return $this->variants; } public function getOnlyVariant() : ParametersAcceptorWithPhpDocs { $variants = $this->getVariants(); if (count($variants) !== 1) { throw new ShouldNotHappenException(); } return $variants[0]; } public function getNamedArgumentsVariants() : ?array { return $this->namedArgumentsVariants; } public function getThrowType() : ?Type { return $this->throwType; } public function getDeprecatedDescription() : ?string { return null; } public function isDeprecated() : TrinaryLogic { return TrinaryLogic::createFromBoolean($this->isDeprecated); } public function isInternal() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFinal() : TrinaryLogic { return TrinaryLogic::createNo(); } public function hasSideEffects() : TrinaryLogic { if ($this->isVoid()) { return TrinaryLogic::createYes(); } return $this->hasSideEffects; } public function isPure() : TrinaryLogic { if ($this->hasSideEffects()->yes()) { return TrinaryLogic::createNo(); } return $this->hasSideEffects->negate(); } private function isVoid() : bool { foreach ($this->variants as $variant) { if (!$variant->getReturnType()->isVoid()->yes()) { return \false; } } return \true; } public function isBuiltin() : bool { return \true; } public function getAsserts() : Assertions { return $this->assertions; } public function getDocComment() : ?string { return $this->phpDocComment; } public function returnsByReference() : TrinaryLogic { return $this->returnsByReference; } public function acceptsNamedArguments() : bool { return $this->acceptsNamedArguments; } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Native; use PHPStan\Reflection\Assertions; use PHPStan\Reflection\ClassMemberReflection; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\MethodPrototypeReflection; use PHPStan\Reflection\ParametersAcceptorWithPhpDocs; use PHPStan\Reflection\Php\BuiltinMethodReflection; use PHPStan\Reflection\ReflectionProvider; use PHPStan\ShouldNotHappenException; use PHPStan\TrinaryLogic; use PHPStan\Type\Type; use PHPStan\Type\TypehintHelper; use ReflectionException; use function count; use function strtolower; final class NativeMethodReflection implements ExtendedMethodReflection { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var ClassReflection */ private $declaringClass; /** * @var BuiltinMethodReflection */ private $reflection; /** * @var ParametersAcceptorWithPhpDocs[] */ private $variants; /** * @var ParametersAcceptorWithPhpDocs[]|null */ private $namedArgumentsVariants; /** * @var TrinaryLogic */ private $hasSideEffects; /** * @var ?Type */ private $throwType; /** * @var Assertions */ private $assertions; /** * @var bool */ private $acceptsNamedArguments; /** * @var ?Type */ private $selfOutType; /** * @var ?string */ private $phpDocComment; /** * @param ParametersAcceptorWithPhpDocs[] $variants * @param ParametersAcceptorWithPhpDocs[]|null $namedArgumentsVariants */ public function __construct(ReflectionProvider $reflectionProvider, ClassReflection $declaringClass, BuiltinMethodReflection $reflection, array $variants, ?array $namedArgumentsVariants, TrinaryLogic $hasSideEffects, ?Type $throwType, Assertions $assertions, bool $acceptsNamedArguments, ?Type $selfOutType, ?string $phpDocComment) { $this->reflectionProvider = $reflectionProvider; $this->declaringClass = $declaringClass; $this->reflection = $reflection; $this->variants = $variants; $this->namedArgumentsVariants = $namedArgumentsVariants; $this->hasSideEffects = $hasSideEffects; $this->throwType = $throwType; $this->assertions = $assertions; $this->acceptsNamedArguments = $acceptsNamedArguments; $this->selfOutType = $selfOutType; $this->phpDocComment = $phpDocComment; } public function getDeclaringClass() : ClassReflection { return $this->declaringClass; } public function isStatic() : bool { return $this->reflection->isStatic(); } public function isPrivate() : bool { return $this->reflection->isPrivate(); } public function isPublic() : bool { return $this->reflection->isPublic(); } public function isAbstract() : TrinaryLogic { return TrinaryLogic::createFromBoolean($this->reflection->isAbstract()); } public function getPrototype() : ClassMemberReflection { try { $prototypeMethod = $this->reflection->getPrototype(); $prototypeDeclaringClass = $this->declaringClass->getAncestorWithClassName($prototypeMethod->getDeclaringClass()->getName()); if ($prototypeDeclaringClass === null) { $prototypeDeclaringClass = $this->reflectionProvider->getClass($prototypeMethod->getDeclaringClass()->getName()); } if (!$prototypeDeclaringClass->hasNativeMethod($prototypeMethod->getName())) { return $this; } $tentativeReturnType = null; if ($prototypeMethod->getTentativeReturnType() !== null) { $tentativeReturnType = TypehintHelper::decideTypeFromReflection($prototypeMethod->getTentativeReturnType()); } return new MethodPrototypeReflection($prototypeMethod->getName(), $prototypeDeclaringClass, $prototypeMethod->isStatic(), $prototypeMethod->isPrivate(), $prototypeMethod->isPublic(), $prototypeMethod->isAbstract(), $prototypeMethod->isFinal(), $prototypeMethod->isInternal(), $prototypeDeclaringClass->getNativeMethod($prototypeMethod->getName())->getVariants(), $tentativeReturnType); } catch (ReflectionException $e) { return $this; } } public function getName() : string { return $this->reflection->getName(); } public function getVariants() : array { return $this->variants; } public function getOnlyVariant() : ParametersAcceptorWithPhpDocs { $variants = $this->getVariants(); if (count($variants) !== 1) { throw new ShouldNotHappenException(); } return $variants[0]; } public function getNamedArgumentsVariants() : ?array { return $this->namedArgumentsVariants; } public function getDeprecatedDescription() : ?string { return null; } public function isDeprecated() : TrinaryLogic { return $this->reflection->isDeprecated(); } public function isInternal() : TrinaryLogic { return TrinaryLogic::createFromBoolean($this->reflection->isInternal()); } public function isFinal() : TrinaryLogic { return TrinaryLogic::createFromBoolean($this->reflection->isFinal()); } public function isFinalByKeyword() : TrinaryLogic { return $this->isFinal(); } public function getThrowType() : ?Type { return $this->throwType; } public function hasSideEffects() : TrinaryLogic { $name = strtolower($this->getName()); $isVoid = $this->isVoid(); if ($name !== '__construct' && $isVoid) { return TrinaryLogic::createYes(); } return $this->hasSideEffects; } public function isPure() : TrinaryLogic { if ($this->hasSideEffects()->yes()) { return TrinaryLogic::createNo(); } return $this->hasSideEffects->negate(); } private function isVoid() : bool { foreach ($this->variants as $variant) { if (!$variant->getReturnType()->isVoid()->yes()) { return \false; } } return \true; } public function getDocComment() : ?string { return $this->phpDocComment; } public function getAsserts() : Assertions { return $this->assertions; } public function acceptsNamedArguments() : bool { return $this->declaringClass->acceptsNamedArguments() && $this->acceptsNamedArguments; } public function getSelfOutType() : ?Type { return $this->selfOutType; } public function returnsByReference() : TrinaryLogic { return $this->reflection->returnsByReference(); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\Native; use PHPStan\Reflection\ParameterReflectionWithPhpDocs; use PHPStan\Reflection\PassedByReference; use PHPStan\TrinaryLogic; use PHPStan\Type\Type; final class NativeParameterWithPhpDocsReflection implements ParameterReflectionWithPhpDocs { /** * @var string */ private $name; /** * @var bool */ private $optional; /** * @var Type */ private $type; /** * @var Type */ private $phpDocType; /** * @var Type */ private $nativeType; /** * @var PassedByReference */ private $passedByReference; /** * @var bool */ private $variadic; /** * @var ?Type */ private $defaultValue; /** * @var ?Type */ private $outType; /** * @var TrinaryLogic */ private $immediatelyInvokedCallable; /** * @var ?Type */ private $closureThisType; public function __construct(string $name, bool $optional, Type $type, Type $phpDocType, Type $nativeType, PassedByReference $passedByReference, bool $variadic, ?Type $defaultValue, ?Type $outType, TrinaryLogic $immediatelyInvokedCallable, ?Type $closureThisType) { $this->name = $name; $this->optional = $optional; $this->type = $type; $this->phpDocType = $phpDocType; $this->nativeType = $nativeType; $this->passedByReference = $passedByReference; $this->variadic = $variadic; $this->defaultValue = $defaultValue; $this->outType = $outType; $this->immediatelyInvokedCallable = $immediatelyInvokedCallable; $this->closureThisType = $closureThisType; } public function getName() : string { return $this->name; } public function isOptional() : bool { return $this->optional; } public function getType() : Type { return $this->type; } public function getPhpDocType() : Type { return $this->phpDocType; } public function getNativeType() : Type { return $this->nativeType; } public function passedByReference() : PassedByReference { return $this->passedByReference; } public function isVariadic() : bool { return $this->variadic; } public function getDefaultValue() : ?Type { return $this->defaultValue; } public function getOutType() : ?Type { return $this->outType; } public function isImmediatelyInvokedCallable() : TrinaryLogic { return $this->immediatelyInvokedCallable; } public function getClosureThisType() : ?Type { return $this->closureThisType; } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : self { return new self($properties['name'], $properties['optional'], $properties['type'], $properties['phpDocType'], $properties['nativeType'], $properties['passedByReference'], $properties['variadic'], $properties['defaultValue'], $properties['outType'], $properties['immediatelyInvokedCallable'], $properties['closureThisType']); } } <?php declare (strict_types=1); namespace PHPStan\Reflection\PHPStan; use PhpParser\Node\Expr\MethodCall; use PHPStan\Analyser\Scope; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionClass; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\MethodReflection; use PHPStan\Type\DynamicMethodReturnTypeExtension; use PHPStan\Type\ObjectType; use PHPStan\Type\Type; final class NativeReflectionEnumReturnDynamicReturnTypeExtension implements DynamicMethodReturnTypeExtension { /** * @var PhpVersion */ private $phpVersion; /** * @var string */ private $className; /** * @var string */ private $methodName; public function __construct(PhpVersion $phpVersion, string $className, string $methodName) { $this->phpVersion = $phpVersion; $this->className = $className; $this->methodName = $methodName; } public function getClass() : string { return $this->className; } public function isMethodSupported(MethodReflection $methodReflection) : bool { return $methodReflection->getName() === $this->methodName; } public function getTypeFromMethodCall(MethodReflection $methodReflection, MethodCall $methodCall, Scope $scope) : ?Type { if ($this->phpVersion->getVersionId() >= 80000) { return null; } return new ObjectType(ReflectionClass::class); } } <?php declare (strict_types=1); namespace PHPStan\Reflection; use PhpParser\Node; use PHPStan\Analyser\Scope; /** @api */ interface ReflectionProvider { /** @phpstan-assert-if-true =class-string $className */ public function hasClass(string $className) : bool; public function getClass(string $className) : \PHPStan\Reflection\ClassReflection; public function getClassName(string $className) : string; public function supportsAnonymousClasses() : bool; public function getAnonymousClassReflection(Node\Stmt\Class_ $classNode, Scope $scope) : \PHPStan\Reflection\ClassReflection; public function hasFunction(Node\Name $nameNode, ?\PHPStan\Reflection\NamespaceAnswerer $namespaceAnswerer) : bool; public function getFunction(Node\Name $nameNode, ?\PHPStan\Reflection\NamespaceAnswerer $namespaceAnswerer) : \PHPStan\Reflection\FunctionReflection; public function resolveFunctionName(Node\Name $nameNode, ?\PHPStan\Reflection\NamespaceAnswerer $namespaceAnswerer) : ?string; public function hasConstant(Node\Name $nameNode, ?\PHPStan\Reflection\NamespaceAnswerer $namespaceAnswerer) : bool; public function getConstant(Node\Name $nameNode, ?\PHPStan\Reflection\NamespaceAnswerer $namespaceAnswerer) : \PHPStan\Reflection\GlobalConstantReflection; public function resolveConstantName(Node\Name $nameNode, ?\PHPStan\Reflection\NamespaceAnswerer $namespaceAnswerer) : ?string; } <?php declare (strict_types=1); namespace PHPStan\Reflection; use PHPStan\Type\Type; /** @api */ interface ParameterReflection { public function getName() : string; public function isOptional() : bool; public function getType() : Type; public function passedByReference() : \PHPStan\Reflection\PassedByReference; public function isVariadic() : bool; public function getDefaultValue() : ?Type; } <?php declare (strict_types=1); namespace PHPStan\Reflection; use PHPStan\Node\InvalidateExprNode; use PHPStan\Reflection\Callables\CallableParametersAcceptor; use PHPStan\Reflection\Callables\SimpleImpurePoint; use PHPStan\Reflection\Callables\SimpleThrowPoint; use PHPStan\TrinaryLogic; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\Generic\TemplateTypeVarianceMap; use PHPStan\Type\Type; final class CallableFunctionVariantWithPhpDocs extends \PHPStan\Reflection\FunctionVariantWithPhpDocs implements CallableParametersAcceptor { /** * @var SimpleThrowPoint[] */ private $throwPoints; /** * @var TrinaryLogic */ private $isPure; /** * @var SimpleImpurePoint[] */ private $impurePoints; /** * @var InvalidateExprNode[] */ private $invalidateExpressions; /** * @var string[] */ private $usedVariables; /** * @var bool */ private $acceptsNamedArguments; /** * @param array<int, ParameterReflectionWithPhpDocs> $parameters * @param SimpleThrowPoint[] $throwPoints * @param SimpleImpurePoint[] $impurePoints * @param InvalidateExprNode[] $invalidateExpressions * @param string[] $usedVariables */ public function __construct(TemplateTypeMap $templateTypeMap, ?TemplateTypeMap $resolvedTemplateTypeMap, array $parameters, bool $isVariadic, Type $returnType, Type $phpDocReturnType, Type $nativeReturnType, ?TemplateTypeVarianceMap $callSiteVarianceMap, array $throwPoints, TrinaryLogic $isPure, array $impurePoints, array $invalidateExpressions, array $usedVariables, bool $acceptsNamedArguments) { $this->throwPoints = $throwPoints; $this->isPure = $isPure; $this->impurePoints = $impurePoints; $this->invalidateExpressions = $invalidateExpressions; $this->usedVariables = $usedVariables; $this->acceptsNamedArguments = $acceptsNamedArguments; parent::__construct($templateTypeMap, $resolvedTemplateTypeMap, $parameters, $isVariadic, $returnType, $phpDocReturnType, $nativeReturnType, $callSiteVarianceMap); } public function getThrowPoints() : array { return $this->throwPoints; } public function isPure() : TrinaryLogic { return $this->isPure; } public function getImpurePoints() : array { return $this->impurePoints; } public function getInvalidateExpressions() : array { return $this->invalidateExpressions; } public function getUsedVariables() : array { return $this->usedVariables; } public function acceptsNamedArguments() : bool { return $this->acceptsNamedArguments; } } <?php declare (strict_types=1); namespace PHPStan\File; use function array_key_exists; use function array_merge; use function array_unique; use function array_values; final class FileExcluderFactory { /** * @var FileExcluderRawFactory */ private $fileExcluderRawFactory; /** * @var string[] */ private $obsoleteExcludesAnalyse; /** * @var array{analyse?: array<int, string>, analyseAndScan?: array<int, string>}|null */ private $excludePaths; /** * @param string[] $obsoleteExcludesAnalyse * @param array{analyse?: array<int, string>, analyseAndScan?: array<int, string>}|null $excludePaths */ public function __construct(\PHPStan\File\FileExcluderRawFactory $fileExcluderRawFactory, array $obsoleteExcludesAnalyse, ?array $excludePaths) { $this->fileExcluderRawFactory = $fileExcluderRawFactory; $this->obsoleteExcludesAnalyse = $obsoleteExcludesAnalyse; $this->excludePaths = $excludePaths; } public function createAnalyseFileExcluder() : \PHPStan\File\FileExcluder { if ($this->excludePaths === null) { return $this->fileExcluderRawFactory->create($this->obsoleteExcludesAnalyse); } $paths = []; if (array_key_exists('analyse', $this->excludePaths)) { $paths = $this->excludePaths['analyse']; } if (array_key_exists('analyseAndScan', $this->excludePaths)) { $paths = array_merge($paths, $this->excludePaths['analyseAndScan']); } return $this->fileExcluderRawFactory->create(array_values(array_unique($paths))); } public function createScanFileExcluder() : \PHPStan\File\FileExcluder { if ($this->excludePaths === null) { return $this->fileExcluderRawFactory->create($this->obsoleteExcludesAnalyse); } $paths = []; if (array_key_exists('analyseAndScan', $this->excludePaths)) { $paths = $this->excludePaths['analyseAndScan']; } return $this->fileExcluderRawFactory->create(array_values(array_unique($paths))); } } <?php declare (strict_types=1); namespace PHPStan\File; use PHPStan\ShouldNotHappenException; use function array_fill; use function array_merge; use function array_slice; use function count; use function explode; use function implode; use function str_replace; use function strpos; use function substr; use function trim; final class ParentDirectoryRelativePathHelper implements \PHPStan\File\RelativePathHelper { /** * @var string */ private $parentDirectory; public function __construct(string $parentDirectory) { $this->parentDirectory = $parentDirectory; } public function getRelativePath(string $filename) : string { return implode('/', $this->getFilenameParts($filename)); } /** * @return string[] */ public function getFilenameParts(string $filename) : array { $schemePosition = strpos($filename, '://'); if ($schemePosition !== \false) { $filename = substr($filename, $schemePosition + 3); } $parentParts = explode('/', trim(str_replace('\\', '/', $this->parentDirectory), '/')); $parentPartsCount = count($parentParts); $filenameParts = explode('/', trim(str_replace('\\', '/', $filename), '/')); $filenamePartsCount = count($filenameParts); $i = 0; for (; $i < $filenamePartsCount; $i++) { if ($parentPartsCount < $i + 1) { break; } $parentPath = implode('/', array_slice($parentParts, 0, $i + 1)); $filenamePath = implode('/', array_slice($filenameParts, 0, $i + 1)); if ($parentPath !== $filenamePath) { break; } } if ($i === 0) { return [$filename]; } $dotsCount = $parentPartsCount - $i; if ($dotsCount < 0) { throw new ShouldNotHappenException(); } return array_merge(array_fill(0, $dotsCount, '..'), array_slice($filenameParts, $i)); } } <?php declare (strict_types=1); namespace PHPStan\File; interface FileExcluderRawFactory { /** * @param string[] $analyseExcludes */ public function create(array $analyseExcludes) : \PHPStan\File\FileExcluder; } <?php declare (strict_types=1); namespace PHPStan\File; use function count; final class FileMonitorResult { /** * @var string[] */ private $newFiles; /** * @var string[] */ private $changedFiles; /** * @var string[] */ private $deletedFiles; /** * @var int */ private $totalFilesCount; /** * @param string[] $newFiles * @param string[] $changedFiles * @param string[] $deletedFiles */ public function __construct(array $newFiles, array $changedFiles, array $deletedFiles, int $totalFilesCount) { $this->newFiles = $newFiles; $this->changedFiles = $changedFiles; $this->deletedFiles = $deletedFiles; $this->totalFilesCount = $totalFilesCount; } /** * @return string[] */ public function getChangedFiles() : array { return $this->changedFiles; } public function hasAnyChanges() : bool { return count($this->newFiles) > 0 || count($this->changedFiles) > 0 || count($this->deletedFiles) > 0; } public function getTotalFilesCount() : int { return $this->totalFilesCount; } } <?php declare (strict_types=1); namespace PHPStan\File; use function fnmatch; use function in_array; use function is_dir; use function is_file; use function preg_match; use function str_starts_with; use function strlen; use function substr; use const DIRECTORY_SEPARATOR; use const FNM_CASEFOLD; use const FNM_NOESCAPE; final class FileExcluder { /** * @var bool */ private $noImplicitWildcard; /** * Paths to exclude from analysing * * @var string[] */ private $literalAnalyseExcludes = []; /** * Directories to exclude from analysing * * @var string[] */ private $literalAnalyseDirectoryExcludes = []; /** * Files to exclude from analysing * * @var string[] */ private $literalAnalyseFilesExcludes = []; /** * fnmatch() patterns to use for excluding files and directories from analysing * @var string[] */ private $fnmatchAnalyseExcludes = []; /** * @var int */ private $fnmatchFlags; /** * @param string[] $analyseExcludes */ public function __construct(\PHPStan\File\FileHelper $fileHelper, array $analyseExcludes, bool $noImplicitWildcard) { $this->noImplicitWildcard = $noImplicitWildcard; foreach ($analyseExcludes as $exclude) { $len = strlen($exclude); $trailingDirSeparator = $len > 0 && in_array($exclude[$len - 1], ['\\', '/'], \true); $normalized = $fileHelper->normalizePath($exclude); if ($trailingDirSeparator) { $normalized .= DIRECTORY_SEPARATOR; } if (self::isFnmatchPattern($normalized)) { $this->fnmatchAnalyseExcludes[] = $normalized; } else { if ($this->noImplicitWildcard) { if (is_file($normalized)) { $this->literalAnalyseFilesExcludes[] = $normalized; } elseif (is_dir($normalized)) { if (!$trailingDirSeparator) { $normalized .= DIRECTORY_SEPARATOR; } $this->literalAnalyseDirectoryExcludes[] = $normalized; } } else { $this->literalAnalyseExcludes[] = $fileHelper->absolutizePath($normalized); } } } $isWindows = DIRECTORY_SEPARATOR === '\\'; if ($isWindows) { $this->fnmatchFlags = FNM_NOESCAPE | FNM_CASEFOLD; } else { $this->fnmatchFlags = 0; } } public function isExcludedFromAnalysing(string $file) : bool { foreach ($this->literalAnalyseExcludes as $exclude) { if (str_starts_with($file, $exclude)) { return \true; } } if ($this->noImplicitWildcard) { foreach ($this->literalAnalyseDirectoryExcludes as $exclude) { if (str_starts_with($file, $exclude)) { return \true; } } foreach ($this->literalAnalyseFilesExcludes as $exclude) { if ($file === $exclude) { return \true; } } } foreach ($this->fnmatchAnalyseExcludes as $exclude) { if (fnmatch($exclude, $file, $this->fnmatchFlags)) { return \true; } } return \false; } public static function isAbsolutePath(string $path) : bool { if (DIRECTORY_SEPARATOR === '/') { if (str_starts_with($path, '/')) { return \true; } } elseif (substr($path, 1, 1) === ':') { return \true; } return \false; } public static function isFnmatchPattern(string $path) : bool { return preg_match('~[*?[\\]]~', $path) > 0; } } <?php declare (strict_types=1); namespace PHPStan\File; final class NullRelativePathHelper implements \PHPStan\File\RelativePathHelper { public function getRelativePath(string $filename) : string { return $filename; } } <?php declare (strict_types=1); namespace PHPStan\File; use PHPStan\AnalysedCodeException; use function sprintf; final class CouldNotWriteFileException extends AnalysedCodeException { public function __construct(string $fileName, string $error) { parent::__construct(sprintf('Could not write file: %s (%s)', $fileName, $error)); } public function getTip() : ?string { return null; } } <?php declare (strict_types=1); namespace PHPStan\File; /** @api */ interface RelativePathHelper { public function getRelativePath(string $filename) : string; } <?php declare (strict_types=1); namespace PHPStan\File; use function count; use function explode; use function implode; use function in_array; use function ltrim; use function realpath; use function str_ends_with; use function str_starts_with; use function strlen; use function substr; use const DIRECTORY_SEPARATOR; final class FuzzyRelativePathHelper implements \PHPStan\File\RelativePathHelper { /** * @var RelativePathHelper */ private $fallbackRelativePathHelper; /** * @var string */ private $directorySeparator; /** * @var ?string */ private $pathToTrim = null; /** * @param string[] $analysedPaths * @param non-empty-string|null $directorySeparator */ public function __construct(\PHPStan\File\RelativePathHelper $fallbackRelativePathHelper, string $currentWorkingDirectory, array $analysedPaths, ?string $directorySeparator = null) { $this->fallbackRelativePathHelper = $fallbackRelativePathHelper; if ($directorySeparator === null) { $directorySeparator = DIRECTORY_SEPARATOR; } $this->directorySeparator = $directorySeparator; $pathBeginning = null; $pathToTrimArray = null; $trimBeginning = static function (string $path) : array { if (str_starts_with($path, '/')) { return ['/', substr($path, 1)]; } elseif (substr($path, 1, 1) === ':') { return [substr($path, 0, 3), substr($path, 3)]; } return ['', $path]; }; if (!in_array($currentWorkingDirectory, ['', '/'], \true) && !(strlen($currentWorkingDirectory) === 3 && substr($currentWorkingDirectory, 1, 1) === ':')) { [$pathBeginning, $currentWorkingDirectory] = $trimBeginning($currentWorkingDirectory); $pathToTrimArray = explode($directorySeparator, $currentWorkingDirectory); } foreach ($analysedPaths as $pathNumber => $path) { [$tempPathBeginning, $path] = $trimBeginning($path); $pathArray = explode($directorySeparator, $path); $pathTempParts = []; $pathArraySize = count($pathArray); foreach ($pathArray as $i => $pathPart) { if ($i === $pathArraySize - 1 && str_ends_with($pathPart, '.php')) { continue; } if (!isset($pathToTrimArray[$i])) { if ($pathNumber !== 0) { $pathToTrimArray = $pathTempParts; continue 2; } } elseif ($pathToTrimArray[$i] !== $pathPart) { $pathToTrimArray = $pathTempParts; continue 2; } $pathTempParts[] = $pathPart; } $pathBeginning = $tempPathBeginning; $pathToTrimArray = $pathTempParts; } if ($pathToTrimArray === null || count($pathToTrimArray) === 0) { return; } $pathToTrim = $pathBeginning . implode($directorySeparator, $pathToTrimArray); $realPathToTrim = realpath($pathToTrim); if ($realPathToTrim !== \false) { $pathToTrim = $realPathToTrim; } $this->pathToTrim = $pathToTrim; } public function getRelativePath(string $filename) : string { if ($this->pathToTrim !== null && str_starts_with($filename, $this->pathToTrim)) { return ltrim(substr($filename, strlen($this->pathToTrim)), $this->directorySeparator); } return $this->fallbackRelativePathHelper->getRelativePath($filename); } } <?php declare (strict_types=1); namespace PHPStan\File; use PHPStan\AnalysedCodeException; use function sprintf; final class CouldNotReadFileException extends AnalysedCodeException { public function __construct(string $fileName) { parent::__construct(sprintf('Could not read file: %s', $fileName)); } public function getTip() : ?string { return null; } } <?php declare (strict_types=1); namespace PHPStan\File; use function str_starts_with; use function strlen; use function substr; final class SystemAgnosticSimpleRelativePathHelper implements \PHPStan\File\RelativePathHelper { /** * @var FileHelper */ private $fileHelper; public function __construct(\PHPStan\File\FileHelper $fileHelper) { $this->fileHelper = $fileHelper; } public function getRelativePath(string $filename) : string { $cwd = $this->fileHelper->getWorkingDirectory(); if ($cwd !== '' && str_starts_with($filename, $cwd)) { return substr($filename, strlen($cwd) + 1); } return $filename; } } <?php declare (strict_types=1); namespace PHPStan\File; use PHPStan\ShouldNotHappenException; use function array_key_exists; use function array_keys; use function count; use function sha1_file; final class FileMonitor { /** * @var FileFinder */ private $fileFinder; /** @var array<string, string>|null */ private $fileHashes = null; /** @var array<string>|null */ private $paths = null; public function __construct(\PHPStan\File\FileFinder $fileFinder) { $this->fileFinder = $fileFinder; } /** * @param array<string> $paths */ public function initialize(array $paths) : void { $finderResult = $this->fileFinder->findFiles($paths); $fileHashes = []; foreach ($finderResult->getFiles() as $filePath) { $fileHashes[$filePath] = $this->getFileHash($filePath); } $this->fileHashes = $fileHashes; $this->paths = $paths; } public function getChanges() : \PHPStan\File\FileMonitorResult { if ($this->fileHashes === null || $this->paths === null) { throw new ShouldNotHappenException(); } $finderResult = $this->fileFinder->findFiles($this->paths); $oldFileHashes = $this->fileHashes; $fileHashes = []; $newFiles = []; $changedFiles = []; $deletedFiles = []; foreach ($finderResult->getFiles() as $filePath) { if (!array_key_exists($filePath, $oldFileHashes)) { $newFiles[] = $filePath; $fileHashes[$filePath] = $this->getFileHash($filePath); continue; } $oldHash = $oldFileHashes[$filePath]; unset($oldFileHashes[$filePath]); $newHash = $this->getFileHash($filePath); $fileHashes[$filePath] = $newHash; if ($oldHash === $newHash) { continue; } $changedFiles[] = $filePath; } $this->fileHashes = $fileHashes; foreach (array_keys($oldFileHashes) as $file) { $deletedFiles[] = $file; } return new \PHPStan\File\FileMonitorResult($newFiles, $changedFiles, $deletedFiles, count($fileHashes)); } private function getFileHash(string $filePath) : string { $hash = sha1_file($filePath); if ($hash === \false) { throw new \PHPStan\File\CouldNotReadFileException($filePath); } return $hash; } } <?php declare (strict_types=1); namespace PHPStan\File; final class FileFinderResult { /** * @var string[] */ private $files; /** * @var bool */ private $onlyFiles; /** * @param string[] $files */ public function __construct(array $files, bool $onlyFiles) { $this->files = $files; $this->onlyFiles = $onlyFiles; } /** * @return string[] */ public function getFiles() : array { return $this->files; } public function isOnlyFiles() : bool { return $this->onlyFiles; } } <?php declare (strict_types=1); namespace PHPStan\File; use _PHPStan_7d8742a37\Symfony\Component\Finder\Finder; use function array_filter; use function array_unique; use function array_values; use function file_exists; use function implode; use function is_file; final class FileFinder { /** * @var FileExcluder */ private $fileExcluder; /** * @var FileHelper */ private $fileHelper; /** * @var string[] */ private $fileExtensions; /** * @param string[] $fileExtensions */ public function __construct(\PHPStan\File\FileExcluder $fileExcluder, \PHPStan\File\FileHelper $fileHelper, array $fileExtensions) { $this->fileExcluder = $fileExcluder; $this->fileHelper = $fileHelper; $this->fileExtensions = $fileExtensions; } /** * @param string[] $paths */ public function findFiles(array $paths) : \PHPStan\File\FileFinderResult { $onlyFiles = \true; $files = []; foreach ($paths as $path) { if (is_file($path)) { $files[] = $this->fileHelper->normalizePath($path); } elseif (!file_exists($path)) { throw new \PHPStan\File\PathNotFoundException($path); } else { $finder = new Finder(); $finder->followLinks(); foreach ($finder->files()->name('*.{' . implode(',', $this->fileExtensions) . '}')->in($path) as $fileInfo) { $files[] = $this->fileHelper->normalizePath($fileInfo->getPathname()); $onlyFiles = \false; } } } $files = array_values(array_unique(array_filter($files, function (string $file) : bool { return !$this->fileExcluder->isExcludedFromAnalysing($file); }))); return new \PHPStan\File\FileFinderResult($files, $onlyFiles); } } <?php declare (strict_types=1); namespace PHPStan\File; use Exception; use function sprintf; final class PathNotFoundException extends Exception { /** * @var string */ private $path; public function __construct(string $path) { $this->path = $path; parent::__construct(sprintf('Path %s does not exist', $path)); } public function getPath() : string { return $this->path; } } <?php declare (strict_types=1); namespace PHPStan\File; use function error_get_last; use function file_put_contents; final class FileWriter { public static function write(string $fileName, string $contents) : void { $success = @file_put_contents($fileName, $contents); if ($success === \false) { $error = error_get_last(); throw new \PHPStan\File\CouldNotWriteFileException($fileName, $error !== null ? $error['message'] : 'unknown cause'); } } } <?php declare (strict_types=1); namespace PHPStan\File; use function str_replace; use function str_starts_with; use function strlen; use function substr; final class SimpleRelativePathHelper implements \PHPStan\File\RelativePathHelper { /** * @var string */ private $currentWorkingDirectory; public function __construct(string $currentWorkingDirectory) { $this->currentWorkingDirectory = $currentWorkingDirectory; } public function getRelativePath(string $filename) : string { if ($this->currentWorkingDirectory !== '' && str_starts_with($filename, $this->currentWorkingDirectory)) { return str_replace('\\', '/', substr($filename, strlen($this->currentWorkingDirectory) + 1)); } return str_replace('\\', '/', $filename); } } <?php declare (strict_types=1); namespace PHPStan\File; use _PHPStan_7d8742a37\Nette\Utils\Strings; use function array_pop; use function explode; use function implode; use function ltrim; use function preg_match; use function rtrim; use function str_ends_with; use function str_replace; use function str_starts_with; use function strlen; use function strtolower; use function substr; use function trim; use const DIRECTORY_SEPARATOR; final class FileHelper { /** * @var string */ private $workingDirectory; public function __construct(string $workingDirectory) { $this->workingDirectory = $this->normalizePath($workingDirectory); } public function getWorkingDirectory() : string { return $this->workingDirectory; } /** @api */ public function absolutizePath(string $path) : string { if (DIRECTORY_SEPARATOR === '/') { if (str_starts_with($path, '/')) { return $path; } } elseif (substr($path, 1, 1) === ':') { return $path; } if (preg_match('~^[a-z0-9+\\-.]+://~i', $path) === 1) { return $path; } return rtrim($this->getWorkingDirectory(), '/\\') . DIRECTORY_SEPARATOR . ltrim($path, '/\\'); } /** @api */ public function normalizePath(string $originalPath, string $directorySeparator = DIRECTORY_SEPARATOR) : string { $isLocalPath = \false; if ($originalPath !== '') { if ($originalPath[0] === '/') { $isLocalPath = \true; } elseif (strlen($originalPath) >= 3 && $originalPath[1] === ':' && $originalPath[2] === '\\') { // e.g. C:\ $isLocalPath = \true; } } $matches = null; if (!$isLocalPath) { $matches = Strings::match($originalPath, '~^([a-z0-9+\\-.]+)://(.+)$~is'); } if ($matches !== null) { [, $scheme, $path] = $matches; $scheme = strtolower($scheme); } else { $scheme = null; $path = $originalPath; } $path = str_replace(['\\', '//', '///', '////'], '/', $path); $pathRoot = str_starts_with($path, '/') ? $directorySeparator : ''; $pathParts = explode('/', trim($path, '/')); $normalizedPathParts = []; foreach ($pathParts as $pathPart) { if ($pathPart === '.') { continue; } if ($pathPart === '..') { $removedPart = array_pop($normalizedPathParts); if ($scheme === 'phar' && $removedPart !== null && str_ends_with($removedPart, '.phar')) { $scheme = null; } } else { $normalizedPathParts[] = $pathPart; } } return ($scheme !== null ? $scheme . '://' : '') . $pathRoot . implode($directorySeparator, $normalizedPathParts); } } <?php declare (strict_types=1); namespace PHPStan\File; use function file_get_contents; use function stream_resolve_include_path; final class FileReader { /** * @throws CouldNotReadFileException */ public static function read(string $fileName) : string { $path = $fileName; $contents = @file_get_contents($path); if ($contents === \false) { $path = stream_resolve_include_path($fileName); if ($path === \false) { throw new \PHPStan\File\CouldNotReadFileException($fileName); } $contents = @file_get_contents($path); } if ($contents === \false) { throw new \PHPStan\File\CouldNotReadFileException($fileName); } return $contents; } } <?php declare (strict_types=1); namespace PHPStan; /** * @phpstan-pure * @return mixed * * @throws void */ function debugScope() { return null; } <?php declare (strict_types=1); namespace PHPStan; use PHPStan\Type\BooleanType; use PHPStan\Type\Constant\ConstantBooleanType; use function array_column; use function max; use function min; /** * @api * @final * @see https://phpstan.org/developing-extensions/trinary-logic */ class TrinaryLogic { /** * @var int */ private $value; private const YES = 1; private const MAYBE = 0; private const NO = -1; /** @var self[] */ private static $registry = []; private function __construct(int $value) { $this->value = $value; } public static function createYes() : self { return self::$registry[self::YES] = self::$registry[self::YES] ?? new self(self::YES); } public static function createNo() : self { return self::$registry[self::NO] = self::$registry[self::NO] ?? new self(self::NO); } public static function createMaybe() : self { return self::$registry[self::MAYBE] = self::$registry[self::MAYBE] ?? new self(self::MAYBE); } public static function createFromBoolean(bool $value) : self { $yesNo = $value ? self::YES : self::NO; return self::$registry[$yesNo] = self::$registry[$yesNo] ?? new self($yesNo); } private static function create(int $value) : self { self::$registry[$value] = self::$registry[$value] ?? new self($value); return self::$registry[$value]; } public function yes() : bool { return $this->value === self::YES; } public function maybe() : bool { return $this->value === self::MAYBE; } public function no() : bool { return $this->value === self::NO; } public function toBooleanType() : BooleanType { if ($this->value === self::MAYBE) { return new BooleanType(); } return new ConstantBooleanType($this->value === self::YES); } public function and(self ...$operands) : self { $operandValues = array_column($operands, 'value'); $operandValues[] = $this->value; return self::create(min($operandValues)); } /** * @template T * @param T[] $objects * @param callable(T): self $callback */ public function lazyAnd(array $objects, callable $callback) : self { if ($this->no()) { return $this; } $results = []; foreach ($objects as $object) { $result = $callback($object); if ($result->no()) { return $result; } $results[] = $result; } return $this->and(...$results); } public function or(self ...$operands) : self { $operandValues = array_column($operands, 'value'); $operandValues[] = $this->value; return self::create(max($operandValues)); } /** * @template T * @param T[] $objects * @param callable(T): self $callback */ public function lazyOr(array $objects, callable $callback) : self { if ($this->yes()) { return $this; } $results = []; foreach ($objects as $object) { $result = $callback($object); if ($result->yes()) { return $result; } $results[] = $result; } return $this->or(...$results); } public static function extremeIdentity(self ...$operands) : self { if ($operands === []) { throw new \PHPStan\ShouldNotHappenException(); } $operandValues = array_column($operands, 'value'); $min = min($operandValues); $max = max($operandValues); return self::create($min === $max ? $min : self::MAYBE); } /** * @template T * @param T[] $objects * @param callable(T): self $callback */ public static function lazyExtremeIdentity(array $objects, callable $callback) : self { if ($objects === []) { throw new \PHPStan\ShouldNotHappenException(); } $lastResult = null; foreach ($objects as $object) { $result = $callback($object); if ($lastResult === null) { $lastResult = $result; continue; } if ($lastResult->equals($result)) { continue; } return self::createMaybe(); } return $lastResult; } public static function maxMin(self ...$operands) : self { if ($operands === []) { throw new \PHPStan\ShouldNotHappenException(); } $operandValues = array_column($operands, 'value'); return self::create(max($operandValues) > 0 ? 1 : min($operandValues)); } /** * @template T * @param T[] $objects * @param callable(T): self $callback */ public static function lazyMaxMin(array $objects, callable $callback) : self { $results = []; foreach ($objects as $object) { $result = $callback($object); if ($result->yes()) { return $result; } $results[] = $result; } return self::maxMin(...$results); } public function negate() : self { return self::create(-$this->value); } public function equals(self $other) : bool { return $this === $other; } public function compareTo(self $other) : ?self { if ($this->value > $other->value) { return $this; } elseif ($other->value > $this->value) { return $other; } return null; } public function describe() : string { static $labels = [self::NO => 'No', self::MAYBE => 'Maybe', self::YES => 'Yes']; return $labels[$this->value]; } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : self { return self::create($properties['value']); } } <?php declare (strict_types=1); namespace PHPStan\Cache; final class CacheItem { /** * @var string */ private $variableKey; /** * @var mixed */ private $data; /** * @param mixed $data */ public function __construct(string $variableKey, $data) { $this->variableKey = $variableKey; $this->data = $data; } public function isVariableKeyValid(string $variableKey) : bool { return $this->variableKey === $variableKey; } /** * @return mixed */ public function getData() { return $this->data; } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : self { return new self($properties['variableKey'], $properties['data']); } } <?php declare (strict_types=1); namespace PHPStan\Cache; interface CacheStorage { /** * @return mixed|null */ public function load(string $key, string $variableKey); /** * @param mixed $data */ public function save(string $key, string $variableKey, $data) : void; } <?php declare (strict_types=1); namespace PHPStan\Cache; use function var_export; final class MemoryCacheStorage implements \PHPStan\Cache\CacheStorage { /** @var array<string, CacheItem> */ private $storage = []; /** * @return mixed|null */ public function load(string $key, string $variableKey) { if (!isset($this->storage[$key])) { return null; } $item = $this->storage[$key]; if (!$item->isVariableKeyValid($variableKey)) { return null; } return $item->getData(); } /** * @param mixed $data */ public function save(string $key, string $variableKey, $data) : void { $item = new \PHPStan\Cache\CacheItem($variableKey, $data); @var_export($item, \true); $this->storage[$key] = $item; } } <?php declare (strict_types=1); namespace PHPStan\Cache; final class Cache { /** * @var CacheStorage */ private $storage; public function __construct(\PHPStan\Cache\CacheStorage $storage) { $this->storage = $storage; } /** * @return mixed|null */ public function load(string $key, string $variableKey) { return $this->storage->load($key, $variableKey); } /** * @param mixed $data */ public function save(string $key, string $variableKey, $data) : void { $this->storage->save($key, $variableKey, $data); } } <?php declare (strict_types=1); namespace PHPStan\Cache; use InvalidArgumentException; use _PHPStan_7d8742a37\Nette\Utils\Random; use PHPStan\File\FileWriter; use PHPStan\Internal\DirectoryCreator; use PHPStan\Internal\DirectoryCreatorException; use PHPStan\ShouldNotHappenException; use function error_get_last; use function is_file; use function rename; use function sha1; use function sprintf; use function substr; use function unlink; use function var_export; use const DIRECTORY_SEPARATOR; final class FileCacheStorage implements \PHPStan\Cache\CacheStorage { /** * @var string */ private $directory; public function __construct(string $directory) { $this->directory = $directory; } /** * @return mixed|null */ public function load(string $key, string $variableKey) { [, , $filePath] = $this->getFilePaths($key); return (static function () use($variableKey, $filePath) { $cacheItem = @(include $filePath); if (!$cacheItem instanceof \PHPStan\Cache\CacheItem) { return null; } if (!$cacheItem->isVariableKeyValid($variableKey)) { return null; } return $cacheItem->getData(); })(); } /** * @param mixed $data * @throws DirectoryCreatorException */ public function save(string $key, string $variableKey, $data) : void { [$firstDirectory, $secondDirectory, $path] = $this->getFilePaths($key); DirectoryCreator::ensureDirectoryExists($this->directory, 0777); DirectoryCreator::ensureDirectoryExists($firstDirectory, 0777); DirectoryCreator::ensureDirectoryExists($secondDirectory, 0777); $tmpPath = sprintf('%s/%s.tmp', $this->directory, Random::generate()); $errorBefore = error_get_last(); $exported = @var_export(new \PHPStan\Cache\CacheItem($variableKey, $data), \true); $errorAfter = error_get_last(); if ($errorAfter !== null && $errorBefore !== $errorAfter) { throw new ShouldNotHappenException(sprintf('Error occurred while saving item %s (%s) to cache: %s', $key, $variableKey, $errorAfter['message'])); } FileWriter::write($tmpPath, sprintf("<?php declare(strict_types = 1);\n\n%s\nreturn %s;", sprintf('// %s', $key), $exported)); $renameSuccess = @rename($tmpPath, $path); if ($renameSuccess) { return; } @unlink($tmpPath); if (DIRECTORY_SEPARATOR === '/' || !is_file($path)) { throw new InvalidArgumentException(sprintf('Could not write data to cache file %s.', $path)); } } /** * @return array{string, string, string} */ private function getFilePaths(string $key) : array { $keyHash = sha1($key); $firstDirectory = sprintf('%s/%s', $this->directory, substr($keyHash, 0, 2)); $secondDirectory = sprintf('%s/%s', $firstDirectory, substr($keyHash, 2, 2)); $filePath = sprintf('%s/%s.php', $secondDirectory, $keyHash); return [$firstDirectory, $secondDirectory, $filePath]; } } <?php declare (strict_types=1); namespace PHPStan\Internal; use function str_replace; final class SprintfHelper { public static function escapeFormatString(string $format) : string { return str_replace('%', '%%', $format); } } <?php declare (strict_types=1); namespace PHPStan\Internal; use Exception; use function error_get_last; use function is_null; use function sprintf; final class DirectoryCreatorException extends Exception { /** * @readonly * @var string */ public $directory; public function __construct(string $directory) { $this->directory = $directory; $error = error_get_last(); parent::__construct(sprintf('Failed to create directory "%s" (%s).', $directory, is_null($error) ? 'unknown cause' : $error['message'])); } } <?php declare (strict_types=1); namespace PHPStan\Internal; use function clearstatcache; use function is_dir; use function mkdir; final class DirectoryCreator { /** * @throws DirectoryCreatorException if unable to create directory. */ public static function ensureDirectoryExists(string $directory, int $mode = 0755, bool $recursive = \true) : void { if (is_dir($directory)) { return; } if (@mkdir($directory, $mode, $recursive)) { return; } clearstatcache(); if (!is_dir($directory)) { throw new \PHPStan\Internal\DirectoryCreatorException($directory); } } } <?php declare (strict_types=1); namespace PHPStan\Internal; use PhpParser\Node\Expr\MethodCall; use PHPStan\Analyser\Scope; use PHPStan\DependencyInjection\Container; use PHPStan\Reflection\MethodReflection; use PHPStan\Reflection\ParametersAcceptorSelector; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\DynamicMethodReturnTypeExtension; use PHPStan\Type\ObjectType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function count; use function in_array; final class ContainerDynamicReturnTypeExtension implements DynamicMethodReturnTypeExtension { public function getClass() : string { return Container::class; } public function isMethodSupported(MethodReflection $methodReflection) : bool { return in_array($methodReflection->getName(), ['getByType'], \true); } public function getTypeFromMethodCall(MethodReflection $methodReflection, MethodCall $methodCall, Scope $scope) : Type { if (count($methodCall->getArgs()) === 0) { return ParametersAcceptorSelector::selectFromArgs($scope, $methodCall->getArgs(), $methodReflection->getVariants())->getReturnType(); } $argType = $scope->getType($methodCall->getArgs()[0]->value); if (!$argType instanceof ConstantStringType) { return ParametersAcceptorSelector::selectFromArgs($scope, $methodCall->getArgs(), $methodReflection->getVariants())->getReturnType(); } $type = new ObjectType($argType->getValue()); if ($methodReflection->getName() === 'getByType' && count($methodCall->getArgs()) >= 2) { $argType = $scope->getType($methodCall->getArgs()[1]->value); if ($argType->isTrue()->yes()) { $type = TypeCombinator::addNull($type); } } return $type; } } <?php declare (strict_types=1); namespace PHPStan\Internal; use function array_shift; final class CombinationsHelper { /** * @param array<mixed> $arrays * @return iterable<mixed> */ public static function combinations(array $arrays) : iterable { // from https://stackoverflow.com/a/70800936/565782 by Arnaud Le Blanc if ($arrays === []) { (yield []); return; } $head = array_shift($arrays); foreach ($head as $elem) { foreach (self::combinations($arrays) as $combination) { $comb = [$elem]; foreach ($combination as $c) { $comb[] = $c; } (yield $comb); } } } } <?php declare (strict_types=1); namespace PHPStan\Internal; use _PHPStan_7d8742a37\Nette\Utils\Json; use _PHPStan_7d8742a37\Nette\Utils\JsonException; use PHPStan\File\CouldNotReadFileException; use PHPStan\File\FileReader; use function basename; use function getenv; use function is_file; use function is_string; use function preg_match; use function substr; use function trim; final class ComposerHelper { public const UNKNOWN_VERSION = 'Unknown version'; /** * @var ?string */ private static $phpstanVersion = null; /** @return array<string, mixed>|null */ public static function getComposerConfig(string $root) : ?array { $composerJsonPath = self::getComposerJsonPath($root); if (!is_file($composerJsonPath)) { return null; } try { $composerJsonContents = FileReader::read($composerJsonPath); return Json::decode($composerJsonContents, Json::FORCE_ARRAY); } catch (CouldNotReadFileException|JsonException $e) { return null; } } private static function getComposerJsonPath(string $root) : string { $envComposer = getenv('COMPOSER'); $fileName = is_string($envComposer) ? $envComposer : 'composer.json'; $fileName = basename(trim($fileName)); return $root . '/' . $fileName; } /** * @param array<string, mixed> $composerConfig */ public static function getVendorDirFromComposerConfig(string $root, array $composerConfig) : string { $vendorDirectory = $composerConfig['config']['vendor-dir'] ?? 'vendor'; return $root . '/' . trim($vendorDirectory, '/'); } /** * @param array<string, mixed> $composerConfig */ public static function getBinDirFromComposerConfig(string $root, array $composerConfig) : string { $vendorDirectory = $composerConfig['config']['bin-dir'] ?? 'vendor/bin'; return $root . '/' . trim($vendorDirectory, '/'); } public static function getPhpStanVersion() : string { if (self::$phpstanVersion !== null) { return self::$phpstanVersion; } $installed = (require __DIR__ . '/../../vendor/composer/installed.php'); $rootPackage = $installed['root'] ?? null; if ($rootPackage === null) { return self::$phpstanVersion = self::UNKNOWN_VERSION; } if (preg_match('/[^v\\d.]/', $rootPackage['pretty_version']) === 0) { // Handles tagged versions, see https://github.com/Jean85/pretty-package-versions/blob/2.0.5/src/Version.php#L31 return self::$phpstanVersion = $rootPackage['pretty_version']; } return self::$phpstanVersion = $rootPackage['pretty_version'] . '@' . substr((string) $rootPackage['reference'], 0, 7); } } <?php declare (strict_types=1); namespace PHPStan\Internal; use PHPStan\ShouldNotHappenException; use function abs; use function end; use function round; final class BytesHelper { public static function bytes(int $bytes) : string { $bytes = round($bytes); $units = ['B', 'kB', 'MB', 'GB', 'TB', 'PB']; foreach ($units as $unit) { if (abs($bytes) < 1024 || $unit === end($units)) { break; } $bytes /= 1024; } if (!isset($unit)) { throw new ShouldNotHappenException(); } return round($bytes, 2) . ' ' . $unit; } } <?php declare (strict_types=1); namespace PHPStan; /** * @phpstan-pure * @param mixed $value * @return mixed * * @throws void */ function dumpType($value) { return null; } /** * @phpstan-pure * @param mixed $value * @return mixed * * @throws void */ function dumpPhpDocType($value) { return null; } <?php declare (strict_types=1); namespace PHPStan\Parallel; use Exception; final class ProcessTimedOutException extends Exception { } <?php declare (strict_types=1); namespace PHPStan\Parallel; use PHPStan\ShouldNotHappenException; use _PHPStan_7d8742a37\React\EventLoop\LoopInterface; use _PHPStan_7d8742a37\React\EventLoop\TimerInterface; use _PHPStan_7d8742a37\React\Stream\ReadableStreamInterface; use _PHPStan_7d8742a37\React\Stream\WritableStreamInterface; use Throwable; use function fclose; use function is_string; use function rewind; use function sprintf; use function stream_get_contents; use function tmpfile; final class Process { /** * @var string */ private $command; /** * @var LoopInterface */ private $loop; /** * @var float */ private $timeoutSeconds; /** * @var \React\ChildProcess\Process */ public $process; /** * @var ?WritableStreamInterface */ private $in = null; /** @var resource */ private $stdOut; /** @var resource */ private $stdErr; /** @var callable(mixed[] $json) : void */ private $onData; /** @var callable(Throwable $exception): void */ private $onError; /** * @var ?TimerInterface */ private $timer = null; public function __construct(string $command, LoopInterface $loop, float $timeoutSeconds) { $this->command = $command; $this->loop = $loop; $this->timeoutSeconds = $timeoutSeconds; } /** * @param callable(mixed[] $json) : void $onData * @param callable(Throwable $exception): void $onError * @param callable(?int $exitCode, string $output) : void $onExit */ public function start(callable $onData, callable $onError, callable $onExit) : void { $tmpStdOut = tmpfile(); if ($tmpStdOut === \false) { throw new ShouldNotHappenException('Failed creating temp file for stdout.'); } $tmpStdErr = tmpfile(); if ($tmpStdErr === \false) { throw new ShouldNotHappenException('Failed creating temp file for stderr.'); } $this->stdOut = $tmpStdOut; $this->stdErr = $tmpStdErr; $this->process = new \_PHPStan_7d8742a37\React\ChildProcess\Process($this->command, null, null, [1 => $this->stdOut, 2 => $this->stdErr]); $this->process->start($this->loop); $this->onData = $onData; $this->onError = $onError; $this->process->on('exit', function ($exitCode) use($onExit) : void { $this->cancelTimer(); $output = ''; rewind($this->stdOut); $stdOut = stream_get_contents($this->stdOut); if (is_string($stdOut)) { $output .= $stdOut; } rewind($this->stdErr); $stdErr = stream_get_contents($this->stdErr); if (is_string($stdErr)) { $output .= $stdErr; } $onExit($exitCode, $output); fclose($this->stdOut); fclose($this->stdErr); }); } private function cancelTimer() : void { if ($this->timer === null) { return; } $this->loop->cancelTimer($this->timer); $this->timer = null; } /** * @param mixed[] $data */ public function request(array $data) : void { $this->cancelTimer(); if ($this->in === null) { throw new ShouldNotHappenException(); } $this->in->write($data); $this->timer = $this->loop->addTimer($this->timeoutSeconds, function () : void { $onError = $this->onError; $onError(new \PHPStan\Parallel\ProcessTimedOutException(sprintf('Child process timed out after %.1f seconds. Try making it longer with parallel.processTimeout setting.', $this->timeoutSeconds))); }); } public function quit() : void { $this->cancelTimer(); if (!$this->process->isRunning()) { return; } foreach ($this->process->pipes as $pipe) { $pipe->close(); } if ($this->in === null) { return; } $this->in->end(); } public function bindConnection(ReadableStreamInterface $out, WritableStreamInterface $in) : void { $out->on('data', function (array $json) : void { $this->cancelTimer(); if ($json['action'] !== 'result') { return; } $onData = $this->onData; $onData($json['result']); }); $this->in = $in; $out->on('error', function (Throwable $error) : void { $onError = $this->onError; $onError($error); }); $in->on('error', function (Throwable $error) : void { $onError = $this->onError; $onError($error); }); } } <?php declare (strict_types=1); namespace PHPStan\Parallel; use Closure; use _PHPStan_7d8742a37\Clue\React\NDJson\Decoder; use _PHPStan_7d8742a37\Clue\React\NDJson\Encoder; use _PHPStan_7d8742a37\Nette\Utils\Random; use PHPStan\Analyser\AnalyserResult; use PHPStan\Analyser\Error; use PHPStan\Analyser\InternalError; use PHPStan\Collectors\CollectedData; use PHPStan\Dependency\RootExportedNode; use PHPStan\Process\ProcessHelper; use _PHPStan_7d8742a37\React\EventLoop\LoopInterface; use _PHPStan_7d8742a37\React\Promise\Deferred; use _PHPStan_7d8742a37\React\Promise\PromiseInterface; use _PHPStan_7d8742a37\React\Socket\ConnectionInterface; use _PHPStan_7d8742a37\React\Socket\TcpServer; use _PHPStan_7d8742a37\Symfony\Component\Console\Input\InputInterface; use Throwable; use function array_map; use function array_pop; use function array_reverse; use function array_sum; use function count; use function defined; use function ini_get; use function max; use function memory_get_usage; use function parse_url; use function sprintf; use function str_contains; use const PHP_URL_PORT; final class ParallelAnalyser { /** * @var int */ private $internalErrorsCountLimit; /** * @var int */ private $decoderBufferSize; private const DEFAULT_TIMEOUT = 600.0; /** * @var float */ private $processTimeout; /** * @var ProcessPool */ private $processPool; public function __construct(int $internalErrorsCountLimit, float $processTimeout, int $decoderBufferSize) { $this->internalErrorsCountLimit = $internalErrorsCountLimit; $this->decoderBufferSize = $decoderBufferSize; $this->processTimeout = max($processTimeout, self::DEFAULT_TIMEOUT); } /** * @param Closure(int ): void|null $postFileCallback * @param (callable(list<Error>, list<Error>, string[]): void)|null $onFileAnalysisHandler * @return PromiseInterface<AnalyserResult> */ public function analyse(LoopInterface $loop, \PHPStan\Parallel\Schedule $schedule, string $mainScript, ?Closure $postFileCallback, ?string $projectConfigFile, InputInterface $input, ?callable $onFileAnalysisHandler) : PromiseInterface { $jobs = array_reverse($schedule->getJobs()); $numberOfProcesses = $schedule->getNumberOfProcesses(); $someChildEnded = \false; $errors = []; $filteredPhpErrors = []; $allPhpErrors = []; $locallyIgnoredErrors = []; $linesToIgnore = []; $unmatchedLineIgnores = []; $peakMemoryUsages = []; $internalErrors = []; $internalErrorsCount = 0; $collectedData = []; $dependencies = []; $reachedInternalErrorsCountLimit = \false; $exportedNodes = []; /** @var Deferred<AnalyserResult> $deferred */ $deferred = new Deferred(); $server = new TcpServer('127.0.0.1:0', $loop); $this->processPool = new \PHPStan\Parallel\ProcessPool($server, static function () use($deferred, &$jobs, &$internalErrors, &$internalErrorsCount, &$reachedInternalErrorsCountLimit, &$errors, &$filteredPhpErrors, &$allPhpErrors, &$locallyIgnoredErrors, &$linesToIgnore, &$unmatchedLineIgnores, &$collectedData, &$dependencies, &$exportedNodes, &$peakMemoryUsages) : void { if (count($jobs) > 0 && $internalErrorsCount === 0) { $internalErrors[] = new InternalError('Some parallel worker jobs have not finished.', 'running parallel worker', [], null, \true); $internalErrorsCount++; } $deferred->resolve(new AnalyserResult($errors, $filteredPhpErrors, $allPhpErrors, $locallyIgnoredErrors, $linesToIgnore, $unmatchedLineIgnores, $internalErrors, $collectedData, $internalErrorsCount === 0 ? $dependencies : null, $exportedNodes, $reachedInternalErrorsCountLimit, array_sum($peakMemoryUsages))); }); $server->on('connection', function (ConnectionInterface $connection) use(&$jobs) : void { // phpcs:disable SlevomatCodingStandard.Namespaces.ReferenceUsedNamesOnly $jsonInvalidUtf8Ignore = defined('JSON_INVALID_UTF8_IGNORE') ? \JSON_INVALID_UTF8_IGNORE : 0; // phpcs:enable $decoder = new Decoder($connection, \true, 512, $jsonInvalidUtf8Ignore, $this->decoderBufferSize); $encoder = new Encoder($connection, $jsonInvalidUtf8Ignore); $decoder->on('data', function (array $data) use(&$jobs, $decoder, $encoder) : void { if ($data['action'] !== 'hello') { return; } $identifier = $data['identifier']; $process = $this->processPool->getProcess($identifier); $process->bindConnection($decoder, $encoder); if (count($jobs) === 0) { $this->processPool->tryQuitProcess($identifier); return; } $job = array_pop($jobs); $process->request(['action' => 'analyse', 'files' => $job]); }); }); /** @var string $serverAddress */ $serverAddress = $server->getAddress(); /** @var int<0, 65535> $serverPort */ $serverPort = parse_url($serverAddress, PHP_URL_PORT); $handleError = function (Throwable $error) use(&$internalErrors, &$internalErrorsCount, &$reachedInternalErrorsCountLimit) : void { $internalErrors[] = new InternalError($error->getMessage(), 'communicating with parallel worker', InternalError::prepareTrace($error), $error->getTraceAsString(), !$error instanceof \PHPStan\Parallel\ProcessTimedOutException); $internalErrorsCount++; $reachedInternalErrorsCountLimit = \true; $this->processPool->quitAll(); }; for ($i = 0; $i < $numberOfProcesses; $i++) { if (count($jobs) === 0) { break; } $processIdentifier = Random::generate(); $commandOptions = ['--port', (string) $serverPort, '--identifier', $processIdentifier]; $process = new \PHPStan\Parallel\Process(ProcessHelper::getWorkerCommand($mainScript, 'worker', $projectConfigFile, $commandOptions, $input), $loop, $this->processTimeout); $process->start(function (array $json) use($process, &$internalErrors, &$errors, &$filteredPhpErrors, &$allPhpErrors, &$locallyIgnoredErrors, &$linesToIgnore, &$unmatchedLineIgnores, &$collectedData, &$dependencies, &$exportedNodes, &$peakMemoryUsages, &$jobs, $postFileCallback, &$internalErrorsCount, &$reachedInternalErrorsCountLimit, $processIdentifier, $onFileAnalysisHandler) : void { $fileErrors = []; foreach ($json['errors'] as $jsonError) { $fileErrors[] = Error::decode($jsonError); } foreach ($json['internalErrors'] as $internalJsonError) { $internalErrors[] = InternalError::decode($internalJsonError); } foreach ($json['filteredPhpErrors'] as $filteredPhpError) { $filteredPhpErrors[] = Error::decode($filteredPhpError); } foreach ($json['allPhpErrors'] as $allPhpError) { $allPhpErrors[] = Error::decode($allPhpError); } $locallyIgnoredFileErrors = []; foreach ($json['locallyIgnoredErrors'] as $locallyIgnoredJsonError) { $locallyIgnoredFileErrors[] = Error::decode($locallyIgnoredJsonError); } if ($onFileAnalysisHandler !== null) { $onFileAnalysisHandler($fileErrors, $locallyIgnoredFileErrors, $json['files']); } foreach ($fileErrors as $fileError) { $errors[] = $fileError; } foreach ($locallyIgnoredFileErrors as $locallyIgnoredFileError) { $locallyIgnoredErrors[] = $locallyIgnoredFileError; } foreach ($json['collectedData'] as $jsonData) { $collectedData[] = CollectedData::decode($jsonData); } /** * @var string $file * @var array<string> $fileDependencies */ foreach ($json['dependencies'] as $file => $fileDependencies) { $dependencies[$file] = $fileDependencies; } foreach ($json['linesToIgnore'] as $file => $fileLinesToIgnore) { if (count($fileLinesToIgnore) === 0) { continue; } $linesToIgnore[$file] = $fileLinesToIgnore; } foreach ($json['unmatchedLineIgnores'] as $file => $fileUnmatchedLineIgnores) { if (count($fileUnmatchedLineIgnores) === 0) { continue; } $unmatchedLineIgnores[$file] = $fileUnmatchedLineIgnores; } /** * @var string $file * @var array<mixed[]> $fileExportedNodes */ foreach ($json['exportedNodes'] as $file => $fileExportedNodes) { if (count($fileExportedNodes) === 0) { continue; } $exportedNodes[$file] = array_map(static function (array $node) : RootExportedNode { $class = $node['type']; return $class::decode($node['data']); }, $fileExportedNodes); } if ($postFileCallback !== null) { $postFileCallback(count($json['files'])); } if (!isset($peakMemoryUsages[$processIdentifier]) || $peakMemoryUsages[$processIdentifier] < $json['memoryUsage']) { $peakMemoryUsages[$processIdentifier] = $json['memoryUsage']; } $internalErrorsCount += $json['internalErrorsCount']; if ($internalErrorsCount >= $this->internalErrorsCountLimit) { $reachedInternalErrorsCountLimit = \true; $this->processPool->quitAll(); } if (count($jobs) === 0) { $this->processPool->tryQuitProcess($processIdentifier); return; } $job = array_pop($jobs); $process->request(['action' => 'analyse', 'files' => $job]); }, $handleError, function ($exitCode, string $output) use(&$someChildEnded, &$peakMemoryUsages, &$internalErrors, &$internalErrorsCount, $processIdentifier) : void { if ($someChildEnded === \false) { $peakMemoryUsages['main'] = memory_get_usage(\true); } $someChildEnded = \true; if ($exitCode === 0) { $this->processPool->tryQuitProcess($processIdentifier); return; } if ($exitCode === null) { $this->processPool->tryQuitProcess($processIdentifier); return; } $memoryLimitMessage = 'PHPStan process crashed because it reached configured PHP memory limit'; if (str_contains($output, $memoryLimitMessage)) { foreach ($internalErrors as $internalError) { if (!str_contains($internalError->getMessage(), $memoryLimitMessage)) { continue; } $this->processPool->tryQuitProcess($processIdentifier); return; } $internalErrors[] = new InternalError(sprintf("Child process error: %s: %s\n%s\n", $memoryLimitMessage, ini_get('memory_limit'), 'Increase your memory limit in php.ini or run PHPStan with --memory-limit CLI option.'), 'running parallel worker', [], null, \false); $internalErrorsCount++; $this->processPool->tryQuitProcess($processIdentifier); return; } $internalErrors[] = new InternalError(sprintf('Child process error (exit code %d): %s', $exitCode, $output), 'running parallel worker', [], null, \true); $internalErrorsCount++; $this->processPool->tryQuitProcess($processIdentifier); }); $this->processPool->attachProcess($processIdentifier, $process); } return $deferred->promise(); } } <?php declare (strict_types=1); namespace PHPStan\Parallel; use PHPStan\ShouldNotHappenException; use _PHPStan_7d8742a37\React\Socket\TcpServer; use function array_key_exists; use function array_keys; use function count; use function sprintf; final class ProcessPool { /** * @var TcpServer */ private $server; /** @var array<string, Process> */ private $processes = []; /** @var callable(): void */ private $onServerClose; /** * @param callable(): void $onServerClose */ public function __construct(TcpServer $server, callable $onServerClose) { $this->server = $server; $this->onServerClose = $onServerClose; } public function getProcess(string $identifier) : \PHPStan\Parallel\Process { if (!array_key_exists($identifier, $this->processes)) { throw new ShouldNotHappenException(sprintf('Process %s not found.', $identifier)); } return $this->processes[$identifier]; } public function attachProcess(string $identifier, \PHPStan\Parallel\Process $process) : void { $this->processes[$identifier] = $process; } public function tryQuitProcess(string $identifier) : void { if (!array_key_exists($identifier, $this->processes)) { return; } $this->quitProcess($identifier); } private function quitProcess(string $identifier) : void { $process = $this->getProcess($identifier); $process->quit(); unset($this->processes[$identifier]); if (count($this->processes) !== 0) { return; } $this->server->close(); $callback = $this->onServerClose; $callback(); } public function quitAll() : void { foreach (array_keys($this->processes) as $identifier) { $this->quitProcess($identifier); } } } <?php declare (strict_types=1); namespace PHPStan\Parallel; final class Schedule { /** * @var int */ private $numberOfProcesses; /** * @var array<array<string>> */ private $jobs; /** * @param array<array<string>> $jobs */ public function __construct(int $numberOfProcesses, array $jobs) { $this->numberOfProcesses = $numberOfProcesses; $this->jobs = $jobs; } public function getNumberOfProcesses() : int { return $this->numberOfProcesses; } /** * @return array<array<string>> */ public function getJobs() : array { return $this->jobs; } } <?php declare (strict_types=1); namespace PHPStan\Parallel; use PHPStan\Command\Output; use PHPStan\Diagnose\DiagnoseExtension; use function array_chunk; use function count; use function floor; use function max; use function min; use function sprintf; final class Scheduler implements DiagnoseExtension { /** * @var positive-int */ private $jobSize; /** * @var positive-int */ private $maximumNumberOfProcesses; /** * @var positive-int */ private $minimumNumberOfJobsPerProcess; /** @var array{int, int, int, int}|null */ private $storedData = null; /** * @param positive-int $jobSize * @param positive-int $maximumNumberOfProcesses * @param positive-int $minimumNumberOfJobsPerProcess */ public function __construct(int $jobSize, int $maximumNumberOfProcesses, int $minimumNumberOfJobsPerProcess) { $this->jobSize = $jobSize; $this->maximumNumberOfProcesses = $maximumNumberOfProcesses; $this->minimumNumberOfJobsPerProcess = $minimumNumberOfJobsPerProcess; } /** * @param array<string> $files */ public function scheduleWork(int $cpuCores, array $files) : \PHPStan\Parallel\Schedule { $jobs = array_chunk($files, $this->jobSize); $numberOfProcesses = min(max((int) floor(count($jobs) / $this->minimumNumberOfJobsPerProcess), 1), $cpuCores); $usedNumberOfProcesses = min($numberOfProcesses, $this->maximumNumberOfProcesses); $this->storedData = [$cpuCores, count($files), count($jobs), $usedNumberOfProcesses]; return new \PHPStan\Parallel\Schedule($usedNumberOfProcesses, $jobs); } public function print(Output $output) : void { if ($this->storedData === null) { return; } [$cpuCores, $filesCount, $jobsCount, $usedNumberOfProcesses] = $this->storedData; $output->writeLineFormatted('<info>Parallel processing scheduler:</info>'); $output->writeLineFormatted(sprintf('# of detected CPU %s: %s%d', $cpuCores === 1 ? 'core' : 'cores', $cpuCores === 1 ? '' : ' ', $cpuCores)); $output->writeLineFormatted(sprintf('# of analysed files: %d', $filesCount)); $output->writeLineFormatted(sprintf('# of jobs: %d', $jobsCount)); $output->writeLineFormatted(sprintf('# of spawned processes: %d', $usedNumberOfProcesses)); $output->writeLineFormatted(''); } } <?php declare (strict_types=1); namespace PHPStan\Command; use PHPStan\Analyser\ResultCache\ResultCacheClearer; use PHPStan\ShouldNotHappenException; use _PHPStan_7d8742a37\Symfony\Component\Console\Command\Command; use _PHPStan_7d8742a37\Symfony\Component\Console\Input\InputInterface; use _PHPStan_7d8742a37\Symfony\Component\Console\Input\InputOption; use _PHPStan_7d8742a37\Symfony\Component\Console\Output\OutputInterface; use function is_bool; use function is_string; final class ClearResultCacheCommand extends Command { /** * @var string[] */ private $composerAutoloaderProjectPaths; private const NAME = 'clear-result-cache'; /** * @param string[] $composerAutoloaderProjectPaths */ public function __construct(array $composerAutoloaderProjectPaths) { $this->composerAutoloaderProjectPaths = $composerAutoloaderProjectPaths; parent::__construct(); } protected function configure() : void { $this->setName(self::NAME)->setDescription('Clears the result cache.')->setDefinition([new InputOption('configuration', 'c', InputOption::VALUE_REQUIRED, 'Path to project configuration file'), new InputOption('autoload-file', 'a', InputOption::VALUE_REQUIRED, 'Project\'s additional autoload file path'), new InputOption('debug', null, InputOption::VALUE_NONE, 'Show debug information - which file is analysed, do not catch internal errors'), new InputOption('memory-limit', null, InputOption::VALUE_REQUIRED, 'Memory limit for clearing result cache'), new InputOption('xdebug', null, InputOption::VALUE_NONE, 'Allow running with Xdebug for debugging purposes')]); } protected function initialize(InputInterface $input, OutputInterface $output) : void { if ((bool) $input->getOption('debug')) { $application = $this->getApplication(); if ($application === null) { throw new ShouldNotHappenException(); } $application->setCatchExceptions(\false); return; } } protected function execute(InputInterface $input, OutputInterface $output) : int { $autoloadFile = $input->getOption('autoload-file'); $configuration = $input->getOption('configuration'); $memoryLimit = $input->getOption('memory-limit'); $debugEnabled = (bool) $input->getOption('debug'); $allowXdebug = $input->getOption('xdebug'); if (!is_string($autoloadFile) && $autoloadFile !== null || !is_string($configuration) && $configuration !== null || !is_string($memoryLimit) && $memoryLimit !== null || !is_bool($allowXdebug)) { throw new ShouldNotHappenException(); } try { $inceptionResult = \PHPStan\Command\CommandHelper::begin($input, $output, [], $memoryLimit, $autoloadFile, $this->composerAutoloaderProjectPaths, $configuration, null, '0', $allowXdebug, $debugEnabled); } catch (\PHPStan\Command\InceptionNotSuccessfulException $e) { return 1; } $container = $inceptionResult->getContainer(); $resultCacheClearer = $container->getByType(ResultCacheClearer::class); $path = $resultCacheClearer->clear(); $output->writeln('<info>Result cache cleared from directory:</info>'); $output->writeln($path); return 0; } } <?php declare (strict_types=1); namespace PHPStan\Command\Symfony; use PHPStan\Command\OutputStyle; use _PHPStan_7d8742a37\Symfony\Component\Console\Style\StyleInterface; /** * @internal */ final class SymfonyStyle implements OutputStyle { /** * @var StyleInterface */ private $symfonyStyle; public function __construct(StyleInterface $symfonyStyle) { $this->symfonyStyle = $symfonyStyle; } public function getSymfonyStyle() : StyleInterface { return $this->symfonyStyle; } public function title(string $message) : void { $this->symfonyStyle->title($message); } public function section(string $message) : void { $this->symfonyStyle->section($message); } public function listing(array $elements) : void { $this->symfonyStyle->listing($elements); } public function success(string $message) : void { $this->symfonyStyle->success($message); } public function error(string $message) : void { $this->symfonyStyle->error($message); } public function warning(string $message) : void { $this->symfonyStyle->warning($message); } public function note(string $message) : void { $this->symfonyStyle->note($message); } public function caution(string $message) : void { $this->symfonyStyle->caution($message); } public function table(array $headers, array $rows) : void { $this->symfonyStyle->table($headers, $rows); } public function newLine(int $count = 1) : void { $this->symfonyStyle->newLine($count); } public function progressStart(int $max = 0) : void { $this->symfonyStyle->progressStart($max); } public function progressAdvance(int $step = 1) : void { $this->symfonyStyle->progressAdvance($step); } public function progressFinish() : void { $this->symfonyStyle->progressFinish(); } } <?php declare (strict_types=1); namespace PHPStan\Command\Symfony; use PHPStan\Command\Output; use PHPStan\Command\OutputStyle; use _PHPStan_7d8742a37\Symfony\Component\Console\Output\OutputInterface; /** * @internal */ final class SymfonyOutput implements Output { /** * @var OutputInterface */ private $symfonyOutput; /** * @var OutputStyle */ private $style; public function __construct(OutputInterface $symfonyOutput, OutputStyle $style) { $this->symfonyOutput = $symfonyOutput; $this->style = $style; } public function writeFormatted(string $message) : void { $this->symfonyOutput->write($message, \false, OutputInterface::OUTPUT_NORMAL); } public function writeLineFormatted(string $message) : void { $this->symfonyOutput->writeln($message, OutputInterface::OUTPUT_NORMAL); } public function writeRaw(string $message) : void { $this->symfonyOutput->write($message, \false, OutputInterface::OUTPUT_RAW); } public function getStyle() : OutputStyle { return $this->style; } public function isVerbose() : bool { return $this->symfonyOutput->isVerbose(); } public function isVeryVerbose() : bool { return $this->symfonyOutput->isVeryVerbose(); } public function isDebug() : bool { return $this->symfonyOutput->isDebug(); } public function isDecorated() : bool { return $this->symfonyOutput->isDecorated(); } } <?php declare (strict_types=1); namespace PHPStan\Command; use Closure; use PHPStan\Analyser\Analyser; use PHPStan\Analyser\AnalyserResult; use PHPStan\Parallel\ParallelAnalyser; use PHPStan\Parallel\Scheduler; use PHPStan\Process\CpuCoreCounter; use PHPStan\ShouldNotHappenException; use _PHPStan_7d8742a37\React\EventLoop\StreamSelectLoop; use _PHPStan_7d8742a37\Symfony\Component\Console\Input\InputInterface; use function count; use function function_exists; use function is_file; use function memory_get_peak_usage; final class AnalyserRunner { /** * @var Scheduler */ private $scheduler; /** * @var Analyser */ private $analyser; /** * @var ParallelAnalyser */ private $parallelAnalyser; /** * @var CpuCoreCounter */ private $cpuCoreCounter; public function __construct(Scheduler $scheduler, Analyser $analyser, ParallelAnalyser $parallelAnalyser, CpuCoreCounter $cpuCoreCounter) { $this->scheduler = $scheduler; $this->analyser = $analyser; $this->parallelAnalyser = $parallelAnalyser; $this->cpuCoreCounter = $cpuCoreCounter; } /** * @param string[] $files * @param string[] $allAnalysedFiles * @param Closure(string $file): void|null $preFileCallback * @param Closure(int ): void|null $postFileCallback */ public function runAnalyser(array $files, array $allAnalysedFiles, ?Closure $preFileCallback, ?Closure $postFileCallback, bool $debug, bool $allowParallel, ?string $projectConfigFile, InputInterface $input) : AnalyserResult { $filesCount = count($files); if ($filesCount === 0) { return new AnalyserResult([], [], [], [], [], [], [], [], [], [], \false, memory_get_peak_usage(\true)); } $schedule = $this->scheduler->scheduleWork($this->cpuCoreCounter->getNumberOfCpuCores(), $files); $mainScript = null; if (isset($_SERVER['argv'][0]) && is_file($_SERVER['argv'][0])) { $mainScript = $_SERVER['argv'][0]; } if (!$debug && $allowParallel && function_exists('proc_open') && $mainScript !== null && $schedule->getNumberOfProcesses() > 0) { $loop = new StreamSelectLoop(); $result = null; $promise = $this->parallelAnalyser->analyse($loop, $schedule, $mainScript, $postFileCallback, $projectConfigFile, $input, null); $promise->then(static function (AnalyserResult $tmp) use(&$result) : void { $result = $tmp; }); $loop->run(); if ($result === null) { throw new ShouldNotHappenException(); } return $result; } return $this->analyser->analyse($files, $preFileCallback, $postFileCallback, $debug, $allAnalysedFiles); } } <?php declare (strict_types=1); namespace PHPStan\Command; use _PHPStan_7d8742a37\Composer\Semver\Semver; use _PHPStan_7d8742a37\Composer\XdebugHandler\XdebugHandler; use _PHPStan_7d8742a37\Nette\DI\Helpers; use _PHPStan_7d8742a37\Nette\DI\InvalidConfigurationException; use _PHPStan_7d8742a37\Nette\DI\ServiceCreationException; use _PHPStan_7d8742a37\Nette\FileNotFoundException; use _PHPStan_7d8742a37\Nette\InvalidStateException; use _PHPStan_7d8742a37\Nette\Schema\ValidationException; use _PHPStan_7d8742a37\Nette\Utils\AssertionException; use _PHPStan_7d8742a37\Nette\Utils\Strings; use PHPStan\Analyser\MutatingScope; use PHPStan\Command\Symfony\SymfonyOutput; use PHPStan\Command\Symfony\SymfonyStyle; use PHPStan\DependencyInjection\Container; use PHPStan\DependencyInjection\ContainerFactory; use PHPStan\DependencyInjection\DuplicateIncludedFilesException; use PHPStan\DependencyInjection\InvalidExcludePathsException; use PHPStan\DependencyInjection\InvalidIgnoredErrorPatternsException; use PHPStan\DependencyInjection\LoaderFactory; use PHPStan\ExtensionInstaller\GeneratedConfig; use PHPStan\File\FileExcluder; use PHPStan\File\FileFinder; use PHPStan\File\FileHelper; use PHPStan\File\SimpleRelativePathHelper; use PHPStan\Internal\ComposerHelper; use PHPStan\Internal\DirectoryCreator; use PHPStan\Internal\DirectoryCreatorException; use PHPStan\PhpDoc\StubFilesProvider; use PHPStan\ShouldNotHappenException; use ReflectionClass; use _PHPStan_7d8742a37\Symfony\Component\Console\Input\InputInterface; use _PHPStan_7d8742a37\Symfony\Component\Console\Output\ConsoleOutputInterface; use _PHPStan_7d8742a37\Symfony\Component\Console\Output\OutputInterface; use Throwable; use function array_filter; use function array_key_exists; use function array_map; use function array_values; use function class_exists; use function count; use function dirname; use function error_get_last; use function get_class; use function getcwd; use function getenv; use function gettype; use function implode; use function ini_get; use function ini_set; use function is_dir; use function is_file; use function is_readable; use function is_string; use function register_shutdown_function; use function spl_autoload_functions; use function sprintf; use function str_contains; use function str_repeat; use function sys_get_temp_dir; use const DIRECTORY_SEPARATOR; use const E_ERROR; use const PHP_VERSION_ID; final class CommandHelper { public const DEFAULT_LEVEL = '0'; /** * @var ?string */ private static $reservedMemory = null; /** * @param string[] $paths * @param string[] $composerAutoloaderProjectPaths * * @throws InceptionNotSuccessfulException */ public static function begin(InputInterface $input, OutputInterface $output, array $paths, ?string $memoryLimit, ?string $autoloadFile, array $composerAutoloaderProjectPaths, ?string $projectConfigFile, ?string $generateBaselineFile, ?string $level, bool $allowXdebug, bool $debugEnabled = \false, bool $cleanupContainerCache = \true) : \PHPStan\Command\InceptionResult { $stdOutput = new SymfonyOutput($output, new SymfonyStyle(new \PHPStan\Command\ErrorsConsoleStyle($input, $output))); $errorOutput = (static function () use($input, $output) : \PHPStan\Command\Output { $symfonyErrorOutput = $output instanceof ConsoleOutputInterface ? $output->getErrorOutput() : $output; return new SymfonyOutput($symfonyErrorOutput, new SymfonyStyle(new \PHPStan\Command\ErrorsConsoleStyle($input, $symfonyErrorOutput))); })(); if (!$allowXdebug) { $xdebug = new XdebugHandler('phpstan'); $xdebug->setPersistent(); $xdebug->check(); unset($xdebug); } if ($allowXdebug) { if (!XdebugHandler::isXdebugActive()) { $errorOutput->getStyle()->note('You are running with "--xdebug" enabled, but the Xdebug PHP extension is not active. The process will not halt at breakpoints.'); } else { $errorOutput->getStyle()->note("You are running with \"--xdebug\" enabled, and the Xdebug PHP extension is active.\nThe process will halt at breakpoints, but PHPStan will run much slower.\nUse this only if you are debugging PHPStan itself or your custom extensions."); } } elseif (XdebugHandler::isXdebugActive()) { $errorOutput->getStyle()->note('The Xdebug PHP extension is active, but "--xdebug" is not used. This may slow down performance and the process will not halt at breakpoints.'); } elseif ($debugEnabled) { $v = XdebugHandler::getSkippedVersion(); if ($v !== '') { $errorOutput->getStyle()->note("The Xdebug PHP extension is active, but \"--xdebug\" is not used.\n" . "The process was restarted and it will not halt at breakpoints.\n" . 'Use "--xdebug" if you want to halt at breakpoints.'); } } if ($memoryLimit !== null) { if (Strings::match($memoryLimit, '#^-?\\d+[kMG]?$#i') === null) { $errorOutput->writeLineFormatted(sprintf('Invalid memory limit format "%s".', $memoryLimit)); throw new \PHPStan\Command\InceptionNotSuccessfulException(); } if (ini_set('memory_limit', $memoryLimit) === \false) { $errorOutput->writeLineFormatted(sprintf('Memory limit "%s" cannot be set.', $memoryLimit)); throw new \PHPStan\Command\InceptionNotSuccessfulException(); } } self::$reservedMemory = str_repeat('PHPStan', 1463); // reserve 10 kB of space register_shutdown_function(static function () use($errorOutput) : void { self::$reservedMemory = null; $error = error_get_last(); if ($error === null) { return; } if ($error['type'] !== E_ERROR) { return; } if (!str_contains($error['message'], 'Allowed memory size')) { return; } $errorOutput->writeLineFormatted(''); $errorOutput->writeLineFormatted(sprintf('<error>PHPStan process crashed because it reached configured PHP memory limit</error>: %s', ini_get('memory_limit'))); $errorOutput->writeLineFormatted('Increase your memory limit in php.ini or run PHPStan with --memory-limit CLI option.'); }); $currentWorkingDirectory = getcwd(); if ($currentWorkingDirectory === \false) { throw new ShouldNotHappenException(); } $currentWorkingDirectoryFileHelper = new FileHelper($currentWorkingDirectory); $currentWorkingDirectory = $currentWorkingDirectoryFileHelper->getWorkingDirectory(); /** @var list<callable(string): void>|false $autoloadFunctionsBefore */ $autoloadFunctionsBefore = spl_autoload_functions(); if ($autoloadFile !== null) { $autoloadFile = $currentWorkingDirectoryFileHelper->absolutizePath($autoloadFile); if (!is_file($autoloadFile)) { $errorOutput->writeLineFormatted(sprintf('Autoload file "%s" not found.', $autoloadFile)); throw new \PHPStan\Command\InceptionNotSuccessfulException(); } (static function (string $file) : void { require_once $file; })($autoloadFile); } if ($projectConfigFile === null) { $discoverableConfigNames = ['.phpstan.neon', 'phpstan.neon', '.phpstan.neon.dist', 'phpstan.neon.dist', '.phpstan.dist.neon', 'phpstan.dist.neon']; foreach ($discoverableConfigNames as $discoverableConfigName) { $discoverableConfigFile = $currentWorkingDirectory . DIRECTORY_SEPARATOR . $discoverableConfigName; if (is_file($discoverableConfigFile)) { $projectConfigFile = $discoverableConfigFile; $errorOutput->writeLineFormatted(sprintf('Note: Using configuration file %s.', $projectConfigFile)); break; } } } else { $projectConfigFile = $currentWorkingDirectoryFileHelper->absolutizePath($projectConfigFile); } if ($generateBaselineFile !== null) { $generateBaselineFile = $currentWorkingDirectoryFileHelper->normalizePath($currentWorkingDirectoryFileHelper->absolutizePath($generateBaselineFile)); } $defaultLevelUsed = \false; if ($projectConfigFile === null && $level === null) { $level = self::DEFAULT_LEVEL; $defaultLevelUsed = \true; } $paths = array_map(static function (string $path) use($currentWorkingDirectoryFileHelper) : string { return $currentWorkingDirectoryFileHelper->normalizePath($currentWorkingDirectoryFileHelper->absolutizePath($path)); }, $paths); $analysedPathsFromConfig = []; $containerFactory = new ContainerFactory($currentWorkingDirectory, \true); $projectConfig = null; if ($projectConfigFile !== null) { if (!is_file($projectConfigFile)) { $errorOutput->writeLineFormatted(sprintf('Project config file at path %s does not exist.', $projectConfigFile)); throw new \PHPStan\Command\InceptionNotSuccessfulException(); } $loader = (new LoaderFactory($currentWorkingDirectoryFileHelper, $containerFactory->getRootDirectory(), $containerFactory->getCurrentWorkingDirectory(), $generateBaselineFile))->createLoader(); try { $projectConfig = $loader->load($projectConfigFile, null); } catch (InvalidStateException|FileNotFoundException $e) { $errorOutput->writeLineFormatted($e->getMessage()); throw new \PHPStan\Command\InceptionNotSuccessfulException(); } $defaultParameters = ['rootDir' => $containerFactory->getRootDirectory(), 'currentWorkingDirectory' => $containerFactory->getCurrentWorkingDirectory(), 'env' => getenv()]; if (isset($projectConfig['parameters']['tmpDir'])) { $tmpDir = Helpers::expand($projectConfig['parameters']['tmpDir'], $defaultParameters); } if ($level === null && isset($projectConfig['parameters']['level'])) { $level = (string) $projectConfig['parameters']['level']; } if (isset($projectConfig['parameters']['paths'])) { $analysedPathsFromConfig = Helpers::expand($projectConfig['parameters']['paths'], $defaultParameters); } if (count($paths) === 0) { $paths = $analysedPathsFromConfig; } } $additionalConfigFiles = []; if ($level !== null) { $levelConfigFile = sprintf('%s/config.level%s.neon', $containerFactory->getConfigDirectory(), $level); if (!is_file($levelConfigFile)) { $errorOutput->writeLineFormatted(sprintf('Level config file %s was not found.', $levelConfigFile)); throw new \PHPStan\Command\InceptionNotSuccessfulException(); } $additionalConfigFiles[] = $levelConfigFile; } if (class_exists('PHPStan\\ExtensionInstaller\\GeneratedConfig')) { $generatedConfigReflection = new ReflectionClass('PHPStan\\ExtensionInstaller\\GeneratedConfig'); $generatedConfigDirectory = dirname($generatedConfigReflection->getFileName()); foreach (GeneratedConfig::EXTENSIONS as $name => $extensionConfig) { foreach ($extensionConfig['extra']['includes'] ?? [] as $includedFile) { if (!is_string($includedFile)) { $errorOutput->writeLineFormatted(sprintf('Cannot include config from package %s, expecting string file path but got %s', $name, gettype($includedFile))); throw new \PHPStan\Command\InceptionNotSuccessfulException(); } $includedFilePath = null; if (isset($extensionConfig['relative_install_path'])) { $includedFilePath = sprintf('%s/%s/%s', $generatedConfigDirectory, $extensionConfig['relative_install_path'], $includedFile); if (!is_file($includedFilePath) || !is_readable($includedFilePath)) { $includedFilePath = null; } } if ($includedFilePath === null) { $includedFilePath = sprintf('%s/%s', $extensionConfig['install_path'], $includedFile); } if (!is_file($includedFilePath) || !is_readable($includedFilePath)) { $errorOutput->writeLineFormatted(sprintf('Config file %s does not exist or isn\'t readable', $includedFilePath)); throw new \PHPStan\Command\InceptionNotSuccessfulException(); } $additionalConfigFiles[] = $includedFilePath; } } if (count($additionalConfigFiles) > 0 && $generatedConfigReflection->hasConstant('PHPSTAN_VERSION_CONSTRAINT')) { $generatedConfigPhpStanVersionConstraint = $generatedConfigReflection->getConstant('PHPSTAN_VERSION_CONSTRAINT'); if ($generatedConfigPhpStanVersionConstraint !== null) { $phpstanSemverVersion = ComposerHelper::getPhpStanVersion(); if ($phpstanSemverVersion !== ComposerHelper::UNKNOWN_VERSION && !str_contains($phpstanSemverVersion, '@') && !Semver::satisfies($phpstanSemverVersion, $generatedConfigPhpStanVersionConstraint)) { $errorOutput->writeLineFormatted('<error>Running PHPStan with incompatible extensions</error>'); $errorOutput->writeLineFormatted('You\'re running PHPStan from a different Composer project'); $errorOutput->writeLineFormatted('than the one where you installed extensions.'); $errorOutput->writeLineFormatted(''); $errorOutput->writeLineFormatted(sprintf('Your PHPStan version is: <fg=red>%s</>', $phpstanSemverVersion)); $errorOutput->writeLineFormatted(sprintf('Installed PHPStan extensions support: %s', $generatedConfigPhpStanVersionConstraint)); $errorOutput->writeLineFormatted(''); if (isset($_SERVER['argv'][0]) && is_file($_SERVER['argv'][0])) { $mainScript = $_SERVER['argv'][0]; $errorOutput->writeLineFormatted(sprintf('PHPStan is running from: %s', $currentWorkingDirectoryFileHelper->absolutizePath(dirname($mainScript)))); } $errorOutput->writeLineFormatted(sprintf('Extensions were installed in: %s', dirname($generatedConfigDirectory, 3))); $errorOutput->writeLineFormatted(''); $simpleRelativePathHelper = new SimpleRelativePathHelper($currentWorkingDirectory); $errorOutput->writeLineFormatted(sprintf('Run PHPStan with <fg=green>%s</> to fix this problem.', $simpleRelativePathHelper->getRelativePath(dirname($generatedConfigDirectory, 3) . '/bin/phpstan'))); $errorOutput->writeLineFormatted(''); throw new \PHPStan\Command\InceptionNotSuccessfulException(); } } } } if ($projectConfigFile !== null && $currentWorkingDirectoryFileHelper->normalizePath($projectConfigFile, '/') !== $currentWorkingDirectoryFileHelper->normalizePath(__DIR__ . '/../../conf/config.stubFiles.neon', '/')) { $additionalConfigFiles[] = $projectConfigFile; } $createDir = static function (string $path) use($errorOutput) : void { try { DirectoryCreator::ensureDirectoryExists($path, 0777); } catch (DirectoryCreatorException $e) { $errorOutput->writeLineFormatted($e->getMessage()); throw new \PHPStan\Command\InceptionNotSuccessfulException(); } }; if (!isset($tmpDir)) { $tmpDir = sys_get_temp_dir() . '/phpstan'; $createDir($tmpDir); } try { $container = $containerFactory->create($tmpDir, $additionalConfigFiles, $paths, $composerAutoloaderProjectPaths, $analysedPathsFromConfig, $level ?? self::DEFAULT_LEVEL, $generateBaselineFile, $autoloadFile); } catch (InvalidConfigurationException|AssertionException $e) { $errorOutput->writeLineFormatted('<error>Invalid configuration:</error>'); $errorOutput->writeLineFormatted($e->getMessage()); throw new \PHPStan\Command\InceptionNotSuccessfulException(); } catch (InvalidIgnoredErrorPatternsException $e) { $errorOutput->writeLineFormatted(sprintf('<error>Invalid %s in ignoreErrors:</error>', count($e->getErrors()) === 1 ? 'entry' : 'entries')); foreach ($e->getErrors() as $error) { $errorOutput->writeLineFormatted($error); $errorOutput->writeLineFormatted(''); } $errorOutput->writeLineFormatted('To ignore non-existent paths in ignoreErrors,'); $errorOutput->writeLineFormatted('set <fg=cyan>reportUnmatchedIgnoredErrors: false</> in your configuration file.'); $errorOutput->writeLineFormatted(''); throw new \PHPStan\Command\InceptionNotSuccessfulException(); } catch (InvalidExcludePathsException $e) { $errorOutput->writeLineFormatted(sprintf('<error>Invalid %s in excludePaths:</error>', count($e->getErrors()) === 1 ? 'entry' : 'entries')); foreach ($e->getErrors() as $error) { $errorOutput->writeLineFormatted($error); $errorOutput->writeLineFormatted(''); } $errorOutput->writeLineFormatted('If the excluded path can sometimes exist, append <fg=cyan>(?)</>'); $errorOutput->writeLineFormatted('to its config entry to mark it as optional.'); $errorOutput->writeLineFormatted(''); throw new \PHPStan\Command\InceptionNotSuccessfulException(); } catch (ValidationException $e) { foreach ($e->getMessages() as $message) { $errorOutput->writeLineFormatted('<error>Invalid configuration:</error>'); $errorOutput->writeLineFormatted($message); } throw new \PHPStan\Command\InceptionNotSuccessfulException(); } catch (ServiceCreationException $e) { $matches = Strings::match($e->getMessage(), '#Service of type (?<serviceType>[a-zA-Z_\\x7f-\\xff][a-zA-Z0-9_\\x7f-\\xff\\\\]*[a-zA-Z0-9_\\x7f-\\xff]): Service of type (?<parserServiceType>[a-zA-Z_\\x7f-\\xff][a-zA-Z0-9_\\x7f-\\xff\\\\]*[a-zA-Z0-9_\\x7f-\\xff]) needed by \\$(?<parameterName>[a-zA-Z_\\x7f-\\xff][a-zA-Z_0-9\\x7f-\\xff]*) in (?<methodName>[a-zA-Z_\\x7f-\\xff][a-zA-Z_0-9\\x7f-\\xff]*)\\(\\)#'); if ($matches === null) { throw $e; } if ($matches['parserServiceType'] !== 'PHPStan\\Parser\\Parser') { throw $e; } if ($matches['methodName'] !== '__construct') { throw $e; } $errorOutput->writeLineFormatted('<error>Invalid configuration:</error>'); $errorOutput->writeLineFormatted(sprintf("Service of type <fg=cyan>%s</> is no longer autowired.\n", $matches['parserServiceType'])); $errorOutput->writeLineFormatted('You need to choose one of the following services'); $errorOutput->writeLineFormatted(sprintf('and use it in the %s argument of your service <fg=cyan>%s</>:', $matches['parameterName'], $matches['serviceType'])); $errorOutput->writeLineFormatted('* <fg=cyan>defaultAnalysisParser</> (if you\'re parsing files from analysed paths)'); $errorOutput->writeLineFormatted('* <fg=cyan>currentPhpVersionSimpleDirectParser</> (in most other situations)'); $errorOutput->writeLineFormatted(''); $errorOutput->writeLineFormatted('After fixing this problem, your configuration will look something like this:'); $errorOutput->writeLineFormatted(''); $errorOutput->writeLineFormatted('-'); $errorOutput->writeLineFormatted(sprintf("\tclass: %s", $matches['serviceType'])); $errorOutput->writeLineFormatted(sprintf("\targuments:")); $errorOutput->writeLineFormatted(sprintf("\t\t%s: @defaultAnalysisParser", $matches['parameterName'])); $errorOutput->writeLineFormatted(''); throw new \PHPStan\Command\InceptionNotSuccessfulException(); } catch (DuplicateIncludedFilesException $e) { $format = "<error>These files are included multiple times:</error>\n- %s"; if (count($e->getFiles()) === 1) { $format = "<error>This file is included multiple times:</error>\n- %s"; } $errorOutput->writeLineFormatted(sprintf($format, implode("\n- ", $e->getFiles()))); if (class_exists('PHPStan\\ExtensionInstaller\\GeneratedConfig')) { $errorOutput->writeLineFormatted(''); $errorOutput->writeLineFormatted('It can lead to unexpected results. If you\'re using phpstan/extension-installer, make sure you have removed corresponding neon files from your project config file.'); } throw new \PHPStan\Command\InceptionNotSuccessfulException(); } if ($cleanupContainerCache) { $containerFactory->clearOldContainers($tmpDir); } /** @var bool|null $customRulesetUsed */ $customRulesetUsed = $container->getParameter('customRulesetUsed'); if ($customRulesetUsed === null) { $errorOutput->writeLineFormatted(''); $errorOutput->writeLineFormatted('<comment>No rules detected</comment>'); $errorOutput->writeLineFormatted(''); $errorOutput->writeLineFormatted('You have the following choices:'); $errorOutput->writeLineFormatted(''); $errorOutput->writeLineFormatted('* while running the analyse option, use the <info>--level</info> option to adjust your rule level - the higher the stricter'); $errorOutput->writeLineFormatted(''); $errorOutput->writeLineFormatted(sprintf('* create your own <info>custom ruleset</info> by selecting which rules you want to check by copying the service definitions from the built-in config level files in <options=bold>%s</>.', $currentWorkingDirectoryFileHelper->normalizePath(__DIR__ . '/../../conf'))); $errorOutput->writeLineFormatted(' * in this case, don\'t forget to define parameter <options=bold>customRulesetUsed</> in your config file.'); $errorOutput->writeLineFormatted(''); throw new \PHPStan\Command\InceptionNotSuccessfulException(); } elseif ($customRulesetUsed) { $defaultLevelUsed = \false; } foreach ($container->getParameter('bootstrapFiles') as $bootstrapFileFromArray) { self::executeBootstrapFile($bootstrapFileFromArray, $container, $errorOutput, $debugEnabled); } /** @var list<callable(string): void>|false $autoloadFunctionsAfter */ $autoloadFunctionsAfter = spl_autoload_functions(); if ($autoloadFunctionsBefore !== \false && $autoloadFunctionsAfter !== \false) { $newAutoloadFunctions = $GLOBALS['__phpstanAutoloadFunctions'] ?? []; foreach ($autoloadFunctionsAfter as $after) { foreach ($autoloadFunctionsBefore as $before) { if ($after === $before) { continue 2; } } $newAutoloadFunctions[] = $after; } $GLOBALS['__phpstanAutoloadFunctions'] = $newAutoloadFunctions; } if (PHP_VERSION_ID >= 80000) { require_once __DIR__ . '/../../stubs/runtime/Enum/UnitEnum.php'; require_once __DIR__ . '/../../stubs/runtime/Enum/BackedEnum.php'; require_once __DIR__ . '/../../stubs/runtime/Enum/ReflectionEnum.php'; require_once __DIR__ . '/../../stubs/runtime/Enum/ReflectionEnumUnitCase.php'; require_once __DIR__ . '/../../stubs/runtime/Enum/ReflectionEnumBackedCase.php'; } foreach ($container->getParameter('scanFiles') as $scannedFile) { if (is_file($scannedFile)) { continue; } $errorOutput->writeLineFormatted(sprintf('Scanned file %s does not exist.', $scannedFile)); throw new \PHPStan\Command\InceptionNotSuccessfulException(); } foreach ($container->getParameter('scanDirectories') as $scannedDirectory) { if (is_dir($scannedDirectory)) { continue; } $errorOutput->writeLineFormatted(sprintf('Scanned directory %s does not exist.', $scannedDirectory)); throw new \PHPStan\Command\InceptionNotSuccessfulException(); } $alreadyAddedStubFiles = []; foreach ($container->getParameter('stubFiles') as $stubFile) { if (array_key_exists($stubFile, $alreadyAddedStubFiles)) { $errorOutput->writeLineFormatted(sprintf('Stub file %s is added multiple times.', $stubFile)); throw new \PHPStan\Command\InceptionNotSuccessfulException(); } $alreadyAddedStubFiles[$stubFile] = \true; if (is_file($stubFile)) { continue; } $errorOutput->writeLineFormatted(sprintf('Stub file %s does not exist.', $stubFile)); throw new \PHPStan\Command\InceptionNotSuccessfulException(); } $excludesAnalyse = $container->getParameter('excludes_analyse'); $excludePaths = $container->getParameter('excludePaths'); if (count($excludesAnalyse) > 0 && $excludePaths !== null) { $errorOutput->writeLineFormatted(sprintf('Configuration parameters <fg=cyan>excludes_analyse</> and <fg=cyan>excludePaths</> cannot be used at the same time.')); $errorOutput->writeLineFormatted(''); $errorOutput->writeLineFormatted(sprintf('Parameter <fg=cyan>excludes_analyse</> has been deprecated so use <fg=cyan>excludePaths</> only from now on.')); $errorOutput->writeLineFormatted(''); throw new \PHPStan\Command\InceptionNotSuccessfulException(); } elseif (count($excludesAnalyse) > 0) { $errorOutput->writeLineFormatted('⚠️ You\'re using a deprecated config option <fg=cyan>excludes_analyse</>. ⚠️️'); $errorOutput->writeLineFormatted(''); $errorOutput->writeLineFormatted(sprintf('Parameter <fg=cyan>excludes_analyse</> has been deprecated so use <fg=cyan>excludePaths</> only from now on.')); } if ($container->hasParameter('scopeClass') && $container->getParameter('scopeClass') !== MutatingScope::class) { $errorOutput->writeLineFormatted('⚠️ You\'re using a deprecated config option <fg=cyan>scopeClass</>. ⚠️️'); $errorOutput->writeLineFormatted(''); $errorOutput->writeLineFormatted(sprintf('Please implement PHPStan\\Type\\ExpressionTypeResolverExtension interface instead and register it as a service.')); } if ($projectConfig !== null) { $parameters = $projectConfig['parameters'] ?? []; /** @var bool $checkMissingIterableValueType */ $checkMissingIterableValueType = $parameters['checkMissingIterableValueType'] ?? \true; if (!$checkMissingIterableValueType) { $errorOutput->writeLineFormatted('⚠️ You\'re using a deprecated config option <fg=cyan>checkMissingIterableValueType</> ⚠️️'); $errorOutput->writeLineFormatted(''); $featureToggles = $container->getParameter('featureToggles'); if (!(bool) $featureToggles['bleedingEdge']) { $errorOutput->writeLineFormatted('It\'s strongly recommended to remove it from your configuration file'); $errorOutput->writeLineFormatted('and add the missing array typehints.'); $errorOutput->writeLineFormatted(''); } $errorOutput->writeLineFormatted('If you want to continue ignoring missing typehints from arrays,'); $errorOutput->writeLineFormatted('add <fg=cyan>missingType.iterableValue</> error identifier to your <fg=cyan>ignoreErrors</>:'); $errorOutput->writeLineFormatted(''); $errorOutput->writeLineFormatted('parameters:'); $errorOutput->writeLineFormatted("\tignoreErrors:"); $errorOutput->writeLineFormatted("\t\t-"); $errorOutput->writeLineFormatted("\t\t\tidentifier: missingType.iterableValue"); $errorOutput->writeLineFormatted(''); } /** @var bool $checkGenericClassInNonGenericObjectType */ $checkGenericClassInNonGenericObjectType = $parameters['checkGenericClassInNonGenericObjectType'] ?? \true; if (!$checkGenericClassInNonGenericObjectType) { $errorOutput->writeLineFormatted('⚠️ You\'re using a deprecated config option <fg=cyan>checkGenericClassInNonGenericObjectType</> ⚠️️'); $errorOutput->writeLineFormatted(''); $errorOutput->writeLineFormatted('It\'s strongly recommended to remove it from your configuration file'); $errorOutput->writeLineFormatted('and add the missing generic typehints.'); $errorOutput->writeLineFormatted(''); $errorOutput->writeLineFormatted('If you want to continue ignoring missing typehints from generics,'); $errorOutput->writeLineFormatted('add <fg=cyan>missingType.generics</> error identifier to your <fg=cyan>ignoreErrors</>:'); $errorOutput->writeLineFormatted(''); $errorOutput->writeLineFormatted('parameters:'); $errorOutput->writeLineFormatted("\tignoreErrors:"); $errorOutput->writeLineFormatted("\t\t-"); $errorOutput->writeLineFormatted("\t\t\tidentifier: missingType.generics"); $errorOutput->writeLineFormatted(''); } } $tempResultCachePath = $container->getParameter('tempResultCachePath'); $createDir($tempResultCachePath); /** @var FileFinder $fileFinder */ $fileFinder = $container->getService('fileFinderAnalyse'); $pathRoutingParser = $container->getService('pathRoutingParser'); $stubFilesProvider = $container->getByType(StubFilesProvider::class); $filesCallback = static function () use($currentWorkingDirectoryFileHelper, $stubFilesProvider, $fileFinder, $pathRoutingParser, $paths, $errorOutput) : array { if (count($paths) === 0) { $errorOutput->writeLineFormatted('At least one path must be specified to analyse.'); throw new \PHPStan\Command\InceptionNotSuccessfulException(); } $fileFinderResult = $fileFinder->findFiles($paths); $files = $fileFinderResult->getFiles(); $pathRoutingParser->setAnalysedFiles($files); $stubFilesExcluder = new FileExcluder($currentWorkingDirectoryFileHelper, $stubFilesProvider->getProjectStubFiles(), \true); $files = array_values(array_filter($files, static function (string $file) use($stubFilesExcluder) { return !$stubFilesExcluder->isExcludedFromAnalysing($file); })); return [$files, $fileFinderResult->isOnlyFiles()]; }; return new \PHPStan\Command\InceptionResult($filesCallback, $stdOutput, $errorOutput, $container, $defaultLevelUsed, $projectConfigFile, $projectConfig, $generateBaselineFile); } /** * @throws InceptionNotSuccessfulException */ private static function executeBootstrapFile(string $file, Container $container, \PHPStan\Command\Output $errorOutput, bool $debugEnabled) : void { if (!is_file($file)) { $errorOutput->writeLineFormatted(sprintf('Bootstrap file %s does not exist.', $file)); throw new \PHPStan\Command\InceptionNotSuccessfulException(); } try { (static function (string $file) use($container) : void { require_once $file; })($file); } catch (Throwable $e) { $errorOutput->writeLineFormatted(sprintf('%s thrown in %s on line %d while loading bootstrap file %s: %s', get_class($e), $e->getFile(), $e->getLine(), $file, $e->getMessage())); if ($debugEnabled) { $errorOutput->writeLineFormatted($e->getTraceAsString()); } throw new \PHPStan\Command\InceptionNotSuccessfulException(); } } } <?php declare (strict_types=1); namespace PHPStan\Command; /** @api */ interface Output { public function writeFormatted(string $message) : void; public function writeLineFormatted(string $message) : void; public function writeRaw(string $message) : void; public function getStyle() : \PHPStan\Command\OutputStyle; public function isVerbose() : bool; public function isVeryVerbose() : bool; public function isDebug() : bool; public function isDecorated() : bool; } <?php declare (strict_types=1); namespace PHPStan\Command\ErrorFormatter; use _PHPStan_7d8742a37\Nette\Utils\Json; use PHPStan\Command\AnalysisResult; use PHPStan\Command\Output; use PHPStan\File\RelativePathHelper; use function hash; use function implode; /** * @see https://docs.gitlab.com/ee/user/project/merge_requests/code_quality.html#implementing-a-custom-tool */ final class GitlabErrorFormatter implements \PHPStan\Command\ErrorFormatter\ErrorFormatter { /** * @var RelativePathHelper */ private $relativePathHelper; public function __construct(RelativePathHelper $relativePathHelper) { $this->relativePathHelper = $relativePathHelper; } public function formatErrors(AnalysisResult $analysisResult, Output $output) : int { $errorsArray = []; foreach ($analysisResult->getFileSpecificErrors() as $fileSpecificError) { $error = ['description' => $fileSpecificError->getMessage(), 'fingerprint' => hash('sha256', implode([$fileSpecificError->getFile(), $fileSpecificError->getLine(), $fileSpecificError->getMessage()])), 'severity' => $fileSpecificError->canBeIgnored() ? 'major' : 'blocker', 'location' => ['path' => $this->relativePathHelper->getRelativePath($fileSpecificError->getFile()), 'lines' => ['begin' => $fileSpecificError->getLine() ?? 0]]]; $errorsArray[] = $error; } foreach ($analysisResult->getNotFileSpecificErrors() as $notFileSpecificError) { $errorsArray[] = ['description' => $notFileSpecificError, 'fingerprint' => hash('sha256', $notFileSpecificError), 'severity' => 'major', 'location' => ['path' => '', 'lines' => ['begin' => 0]]]; } $json = Json::encode($errorsArray, Json::PRETTY); $output->writeRaw($json); return $analysisResult->hasErrors() ? 1 : 0; } } <?php declare (strict_types=1); namespace PHPStan\Command\ErrorFormatter; use PHPStan\Analyser\Error; use PHPStan\Command\AnalysisResult; use PHPStan\Command\Output; use PHPStan\File\RelativePathHelper; use function count; use function htmlspecialchars; use function sprintf; use const ENT_COMPAT; use const ENT_XML1; final class CheckstyleErrorFormatter implements \PHPStan\Command\ErrorFormatter\ErrorFormatter { /** * @var RelativePathHelper */ private $relativePathHelper; public function __construct(RelativePathHelper $relativePathHelper) { $this->relativePathHelper = $relativePathHelper; } public function formatErrors(AnalysisResult $analysisResult, Output $output) : int { $output->writeRaw('<?xml version="1.0" encoding="UTF-8"?>'); $output->writeLineFormatted(''); $output->writeRaw('<checkstyle>'); $output->writeLineFormatted(''); foreach ($this->groupByFile($analysisResult) as $relativeFilePath => $errors) { $output->writeRaw(sprintf('<file name="%s">', $this->escape($relativeFilePath))); $output->writeLineFormatted(''); foreach ($errors as $error) { $output->writeRaw(sprintf(' <error line="%d" column="1" severity="error" message="%s"%s />', $this->escape((string) $error->getLine()), $this->escape($error->getMessage()), $error->getIdentifier() !== null ? sprintf(' source="%s"', $this->escape($error->getIdentifier())) : '')); $output->writeLineFormatted(''); } $output->writeRaw('</file>'); $output->writeLineFormatted(''); } $notFileSpecificErrors = $analysisResult->getNotFileSpecificErrors(); if (count($notFileSpecificErrors) > 0) { $output->writeRaw('<file>'); $output->writeLineFormatted(''); foreach ($notFileSpecificErrors as $error) { $output->writeRaw(sprintf(' <error severity="error" message="%s" />', $this->escape($error))); $output->writeLineFormatted(''); } $output->writeRaw('</file>'); $output->writeLineFormatted(''); } if ($analysisResult->hasWarnings()) { $output->writeRaw('<file>'); $output->writeLineFormatted(''); foreach ($analysisResult->getWarnings() as $warning) { $output->writeRaw(sprintf(' <error severity="warning" message="%s" />', $this->escape($warning))); $output->writeLineFormatted(''); } $output->writeRaw('</file>'); $output->writeLineFormatted(''); } $output->writeRaw('</checkstyle>'); $output->writeLineFormatted(''); return $analysisResult->hasErrors() ? 1 : 0; } /** * Escapes values for using in XML * */ private function escape(string $string) : string { return htmlspecialchars($string, ENT_XML1 | ENT_COMPAT, 'UTF-8'); } /** * Group errors by file * * @return array<string, array<Error>> Array that have as key the relative path of file * and as value an array with occurred errors. */ private function groupByFile(AnalysisResult $analysisResult) : array { $files = []; /** @var Error $fileSpecificError */ foreach ($analysisResult->getFileSpecificErrors() as $fileSpecificError) { $absolutePath = $fileSpecificError->getFilePath(); if ($fileSpecificError->getTraitFilePath() !== null) { $absolutePath = $fileSpecificError->getTraitFilePath(); } $relativeFilePath = $this->relativePathHelper->getRelativePath($absolutePath); $files[$relativeFilePath][] = $fileSpecificError; } return $files; } } <?php declare (strict_types=1); namespace PHPStan\Command\ErrorFormatter; use PHPStan\Analyser\Error; use PHPStan\Command\AnalyseCommand; use PHPStan\Command\AnalysisResult; use PHPStan\Command\Output; use PHPStan\File\RelativePathHelper; use PHPStan\File\SimpleRelativePathHelper; use _PHPStan_7d8742a37\Symfony\Component\Console\Formatter\OutputFormatter; use function array_key_exists; use function array_map; use function count; use function explode; use function getenv; use function in_array; use function is_string; use function ltrim; use function sprintf; use function str_contains; use function str_replace; final class TableErrorFormatter implements \PHPStan\Command\ErrorFormatter\ErrorFormatter { /** * @var RelativePathHelper */ private $relativePathHelper; /** * @var SimpleRelativePathHelper */ private $simpleRelativePathHelper; /** * @var CiDetectedErrorFormatter */ private $ciDetectedErrorFormatter; /** * @var bool */ private $showTipsOfTheDay; /** * @var ?string */ private $editorUrl; /** * @var ?string */ private $editorUrlTitle; public function __construct(RelativePathHelper $relativePathHelper, SimpleRelativePathHelper $simpleRelativePathHelper, \PHPStan\Command\ErrorFormatter\CiDetectedErrorFormatter $ciDetectedErrorFormatter, bool $showTipsOfTheDay, ?string $editorUrl, ?string $editorUrlTitle) { $this->relativePathHelper = $relativePathHelper; $this->simpleRelativePathHelper = $simpleRelativePathHelper; $this->ciDetectedErrorFormatter = $ciDetectedErrorFormatter; $this->showTipsOfTheDay = $showTipsOfTheDay; $this->editorUrl = $editorUrl; $this->editorUrlTitle = $editorUrlTitle; } /** @api */ public function formatErrors(AnalysisResult $analysisResult, Output $output) : int { $this->ciDetectedErrorFormatter->formatErrors($analysisResult, $output); $projectConfigFile = 'phpstan.neon'; if ($analysisResult->getProjectConfigFile() !== null) { $projectConfigFile = $this->relativePathHelper->getRelativePath($analysisResult->getProjectConfigFile()); } $style = $output->getStyle(); if (!$analysisResult->hasErrors() && !$analysisResult->hasWarnings()) { $style->success('No errors'); if ($this->showTipsOfTheDay) { if ($analysisResult->isDefaultLevelUsed()) { $output->writeLineFormatted('💡 Tip of the Day:'); $output->writeLineFormatted(sprintf("PHPStan is performing only the most basic checks.\nYou can pass a higher rule level through the <fg=cyan>--%s</> option\n(the default and current level is %d) to analyse code more thoroughly.", AnalyseCommand::OPTION_LEVEL, AnalyseCommand::DEFAULT_LEVEL)); $output->writeLineFormatted(''); } } return 0; } /** @var array<string, Error[]> $fileErrors */ $fileErrors = []; $outputIdentifiers = $output->isVerbose(); $outputIdentifiersInFile = []; foreach ($analysisResult->getFileSpecificErrors() as $fileSpecificError) { if (!isset($fileErrors[$fileSpecificError->getFile()])) { $fileErrors[$fileSpecificError->getFile()] = []; } $fileErrors[$fileSpecificError->getFile()][] = $fileSpecificError; if ($outputIdentifiers) { continue; } $filePath = $fileSpecificError->getTraitFilePath() ?? $fileSpecificError->getFilePath(); if (array_key_exists($filePath, $outputIdentifiersInFile)) { continue; } if ($fileSpecificError->getIdentifier() === null) { continue; } if (!in_array($fileSpecificError->getIdentifier(), ['ignore.unmatchedIdentifier', 'ignore.parseError', 'ignore.unmatched'], \true)) { continue; } $outputIdentifiersInFile[$filePath] = \true; } foreach ($fileErrors as $file => $errors) { $rows = []; foreach ($errors as $error) { $message = $error->getMessage(); $filePath = $error->getTraitFilePath() ?? $error->getFilePath(); if (($outputIdentifiers || array_key_exists($filePath, $outputIdentifiersInFile)) && $error->getIdentifier() !== null && $error->canBeIgnored()) { $message .= "\n"; $message .= '🪪 ' . $error->getIdentifier(); } if ($error->getTip() !== null) { $tip = $error->getTip(); $tip = str_replace('%configurationFile%', $projectConfigFile, $tip); $message .= "\n"; if (str_contains($tip, "\n")) { $lines = explode("\n", $tip); foreach ($lines as $line) { $message .= '💡 ' . ltrim($line, ' •') . "\n"; } } else { $message .= '💡 ' . $tip; } } if (is_string($this->editorUrl)) { $url = str_replace(['%file%', '%relFile%', '%line%'], [$filePath, $this->simpleRelativePathHelper->getRelativePath($filePath), (string) $error->getLine()], $this->editorUrl); if (is_string($this->editorUrlTitle)) { $title = str_replace(['%file%', '%relFile%', '%line%'], [$filePath, $this->simpleRelativePathHelper->getRelativePath($filePath), (string) $error->getLine()], $this->editorUrlTitle); } else { $title = $this->relativePathHelper->getRelativePath($filePath); } $message .= "\n✏️ <href=" . OutputFormatter::escape($url) . '>' . $title . '</>'; } $rows[] = [$this->formatLineNumber($error->getLine()), $message]; } $style->table(['Line', $this->relativePathHelper->getRelativePath($file)], $rows); } if (count($analysisResult->getNotFileSpecificErrors()) > 0) { $style->table(['', 'Error'], array_map(static function (string $error) : array { return ['', OutputFormatter::escape($error)]; }, $analysisResult->getNotFileSpecificErrors())); } $warningsCount = count($analysisResult->getWarnings()); if ($warningsCount > 0) { $style->table(['', 'Warning'], array_map(static function (string $warning) : array { return ['', OutputFormatter::escape($warning)]; }, $analysisResult->getWarnings())); } $finalMessage = sprintf($analysisResult->getTotalErrorsCount() === 1 ? 'Found %d error' : 'Found %d errors', $analysisResult->getTotalErrorsCount()); if ($warningsCount > 0) { $finalMessage .= sprintf($warningsCount === 1 ? ' and %d warning' : ' and %d warnings', $warningsCount); } if ($analysisResult->getTotalErrorsCount() > 0) { $style->error($finalMessage); } else { $style->warning($finalMessage); } return $analysisResult->getTotalErrorsCount() > 0 ? 1 : 0; } private function formatLineNumber(?int $lineNumber) : string { if ($lineNumber === null) { return ''; } $isRunningInVSCodeTerminal = getenv('TERM_PROGRAM') === 'vscode'; if ($isRunningInVSCodeTerminal) { return ':' . $lineNumber; } return (string) $lineNumber; } } <?php declare (strict_types=1); namespace PHPStan\Command\ErrorFormatter; use PHPStan\Command\AnalysisResult; use PHPStan\Command\Output; /** * This is the interface custom error formatters implement. Register it in the configuration file * like this: * * ``` * services: * errorFormatter.myFormat: * class: App\PHPStan\AwesomeErrorFormatter * ``` * * Learn more: https://phpstan.org/developing-extensions/error-formatters * * @api */ interface ErrorFormatter { /** * Formats the errors and outputs them to the console. * * @return int Error code. */ public function formatErrors(AnalysisResult $analysisResult, Output $output) : int; } <?php declare (strict_types=1); namespace PHPStan\Command\ErrorFormatter; use PHPStan\Command\AnalysisResult; use PHPStan\Command\Output; use PHPStan\File\RelativePathHelper; use function array_walk; use function implode; use function sprintf; use function str_replace; /** * Allow errors to be reported in pull-requests diff when run in a GitHub Action * @see https://help.github.com/en/actions/reference/workflow-commands-for-github-actions#setting-an-error-message */ final class GithubErrorFormatter implements \PHPStan\Command\ErrorFormatter\ErrorFormatter { /** * @var RelativePathHelper */ private $relativePathHelper; public function __construct(RelativePathHelper $relativePathHelper) { $this->relativePathHelper = $relativePathHelper; } public function formatErrors(AnalysisResult $analysisResult, Output $output) : int { foreach ($analysisResult->getFileSpecificErrors() as $fileSpecificError) { $metas = ['file' => $this->relativePathHelper->getRelativePath($fileSpecificError->getFile()), 'line' => $fileSpecificError->getLine(), 'col' => 0]; array_walk($metas, static function (&$value, string $key) : void { $value = sprintf('%s=%s', $key, (string) $value); }); $message = $fileSpecificError->getMessage(); // newlines need to be encoded // see https://github.com/actions/starter-workflows/issues/68#issuecomment-581479448 $message = str_replace("\n", '%0A', $message); $line = sprintf('::error %s::%s', implode(',', $metas), $message); $output->writeRaw($line); $output->writeLineFormatted(''); } foreach ($analysisResult->getNotFileSpecificErrors() as $notFileSpecificError) { // newlines need to be encoded // see https://github.com/actions/starter-workflows/issues/68#issuecomment-581479448 $notFileSpecificError = str_replace("\n", '%0A', $notFileSpecificError); $line = sprintf('::error ::%s', $notFileSpecificError); $output->writeRaw($line); $output->writeLineFormatted(''); } foreach ($analysisResult->getWarnings() as $warning) { // newlines need to be encoded // see https://github.com/actions/starter-workflows/issues/68#issuecomment-581479448 $warning = str_replace("\n", '%0A', $warning); $line = sprintf('::warning ::%s', $warning); $output->writeRaw($line); $output->writeLineFormatted(''); } return $analysisResult->hasErrors() ? 1 : 0; } } <?php declare (strict_types=1); namespace PHPStan\Command\ErrorFormatter; use _PHPStan_7d8742a37\Nette\DI\Helpers; use _PHPStan_7d8742a37\Nette\Neon\Neon; use _PHPStan_7d8742a37\Nette\Utils\Strings; use PHPStan\Command\AnalysisResult; use PHPStan\Command\Output; use PHPStan\File\RelativePathHelper; use PHPStan\ShouldNotHappenException; use function ksort; use function preg_quote; use function substr; use const SORT_STRING; final class BaselineNeonErrorFormatter { /** * @var RelativePathHelper */ private $relativePathHelper; public function __construct(RelativePathHelper $relativePathHelper) { $this->relativePathHelper = $relativePathHelper; } public function formatErrors(AnalysisResult $analysisResult, Output $output, string $existingBaselineContent) : int { if (!$analysisResult->hasErrors()) { $output->writeRaw($this->getNeon([], $existingBaselineContent)); return 0; } $fileErrors = []; foreach ($analysisResult->getFileSpecificErrors() as $fileSpecificError) { if (!$fileSpecificError->canBeIgnored()) { continue; } $fileErrors[$this->relativePathHelper->getRelativePath($fileSpecificError->getFilePath())][] = $fileSpecificError->getMessage(); } ksort($fileErrors, SORT_STRING); $errorsToOutput = []; foreach ($fileErrors as $file => $errorMessages) { $fileErrorsCounts = []; foreach ($errorMessages as $errorMessage) { if (!isset($fileErrorsCounts[$errorMessage])) { $fileErrorsCounts[$errorMessage] = 1; continue; } $fileErrorsCounts[$errorMessage]++; } ksort($fileErrorsCounts, SORT_STRING); foreach ($fileErrorsCounts as $message => $count) { $errorsToOutput[] = ['message' => Helpers::escape('#^' . preg_quote($message, '#') . '$#'), 'count' => $count, 'path' => Helpers::escape($file)]; } } $output->writeRaw($this->getNeon($errorsToOutput, $existingBaselineContent)); return 1; } /** * @param array<int, array{message: string, count: int, path: string}> $ignoreErrors */ private function getNeon(array $ignoreErrors, string $existingBaselineContent) : string { $neon = Neon::encode(['parameters' => ['ignoreErrors' => $ignoreErrors]], Neon::BLOCK); if (substr($neon, -2) !== "\n\n") { throw new ShouldNotHappenException(); } if ($existingBaselineContent === '') { return substr($neon, 0, -1); } $existingBaselineContentEndOfFileNewlinesMatches = Strings::match($existingBaselineContent, "~(\n)+\$~"); $existingBaselineContentEndOfFileNewlines = $existingBaselineContentEndOfFileNewlinesMatches !== null ? $existingBaselineContentEndOfFileNewlinesMatches[0] : ''; return substr($neon, 0, -2) . $existingBaselineContentEndOfFileNewlines; } } <?php declare (strict_types=1); namespace PHPStan\Command\ErrorFormatter; use _PHPStan_7d8742a37\Nette\DI\Helpers; use PHPStan\Command\AnalysisResult; use PHPStan\Command\Output; use PHPStan\File\RelativePathHelper; use function array_keys; use function count; use function implode; use function ksort; use function preg_quote; use function sort; use function sprintf; use function var_export; use const SORT_STRING; final class BaselinePhpErrorFormatter { /** * @var RelativePathHelper */ private $relativePathHelper; public function __construct(RelativePathHelper $relativePathHelper) { $this->relativePathHelper = $relativePathHelper; } public function formatErrors(AnalysisResult $analysisResult, Output $output) : int { if (!$analysisResult->hasErrors()) { $php = '<?php declare(strict_types = 1);'; $php .= "\n\n"; $php .= 'return [];'; $php .= "\n"; $output->writeRaw($php); return 0; } $fileErrors = []; foreach ($analysisResult->getFileSpecificErrors() as $fileSpecificError) { if (!$fileSpecificError->canBeIgnored()) { continue; } $fileErrors['/' . $this->relativePathHelper->getRelativePath($fileSpecificError->getFilePath())][] = $fileSpecificError; } ksort($fileErrors, SORT_STRING); $php = '<?php declare(strict_types = 1);'; $php .= "\n\n"; $php .= '$ignoreErrors = [];'; $php .= "\n"; foreach ($fileErrors as $file => $errors) { $fileErrorsByMessage = []; foreach ($errors as $error) { $errorMessage = $error->getMessage(); if (!isset($fileErrorsByMessage[$errorMessage])) { $fileErrorsByMessage[$errorMessage] = [1, $error->getIdentifier() !== null ? [$error->getIdentifier() => \true] : []]; continue; } $fileErrorsByMessage[$errorMessage][0]++; if ($error->getIdentifier() === null) { continue; } $fileErrorsByMessage[$errorMessage][1][$error->getIdentifier()] = \true; } ksort($fileErrorsByMessage, SORT_STRING); foreach ($fileErrorsByMessage as $message => [$count, $identifiersInKeys]) { $identifiers = array_keys($identifiersInKeys); sort($identifiers); $identifiersComment = ''; if (count($identifiers) > 0) { if (count($identifiers) === 1) { $identifiersComment = "\n\t// identifier: " . $identifiers[0]; } else { $identifiersComment = "\n\t// identifiers: " . implode(', ', $identifiers); } } $php .= sprintf("\$ignoreErrors[] = [%s\n\t'message' => %s,\n\t'count' => %d,\n\t'path' => __DIR__ . %s,\n];\n", $identifiersComment, var_export(Helpers::escape('#^' . preg_quote($message, '#') . '$#'), \true), var_export($count, \true), var_export(Helpers::escape($file), \true)); } } $php .= "\n"; $php .= 'return [\'parameters\' => [\'ignoreErrors\' => $ignoreErrors]];'; $php .= "\n"; $output->writeRaw($php); return 1; } } <?php declare (strict_types=1); namespace PHPStan\Command\ErrorFormatter; use PHPStan\Command\AnalysisResult; use PHPStan\Command\Output; use PHPStan\File\RelativePathHelper; use function htmlspecialchars; use function sprintf; use const ENT_COMPAT; use const ENT_XML1; final class JunitErrorFormatter implements \PHPStan\Command\ErrorFormatter\ErrorFormatter { /** * @var RelativePathHelper */ private $relativePathHelper; public function __construct(RelativePathHelper $relativePathHelper) { $this->relativePathHelper = $relativePathHelper; } public function formatErrors(AnalysisResult $analysisResult, Output $output) : int { $totalFailuresCount = $analysisResult->getTotalErrorsCount(); $totalTestsCount = $analysisResult->hasErrors() ? $totalFailuresCount : 1; $result = '<?xml version="1.0" encoding="UTF-8"?>'; $result .= sprintf('<testsuite failures="%d" name="phpstan" tests="%d" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="https://raw.githubusercontent.com/junit-team/junit5/r5.5.1/platform-tests/src/test/resources/jenkins-junit.xsd">', $totalFailuresCount, $totalTestsCount); foreach ($analysisResult->getFileSpecificErrors() as $fileSpecificError) { $fileName = $this->relativePathHelper->getRelativePath($fileSpecificError->getFile()); $result .= $this->createTestCase(sprintf('%s:%s', $fileName, (string) $fileSpecificError->getLine()), 'ERROR', $fileSpecificError->getMessage()); } foreach ($analysisResult->getNotFileSpecificErrors() as $notFileSpecificError) { $result .= $this->createTestCase('General error', 'ERROR', $notFileSpecificError); } foreach ($analysisResult->getWarnings() as $warning) { $result .= $this->createTestCase('Warning', 'WARNING', $warning); } if (!$analysisResult->hasErrors()) { $result .= $this->createTestCase('phpstan', ''); } $result .= '</testsuite>'; $output->writeRaw($result); return $analysisResult->hasErrors() ? 1 : 0; } /** * Format a single test case * * */ private function createTestCase(string $reference, string $type, ?string $message = null) : string { $result = sprintf('<testcase name="%s">', $this->escape($reference)); if ($message !== null) { $result .= sprintf('<failure type="%s" message="%s" />', $this->escape($type), $this->escape($message)); } $result .= '</testcase>'; return $result; } /** * Escapes values for using in XML * */ private function escape(string $string) : string { return htmlspecialchars($string, ENT_XML1 | ENT_COMPAT, 'UTF-8'); } } <?php declare (strict_types=1); namespace PHPStan\Command\ErrorFormatter; use PHPStan\Command\AnalysisResult; use PHPStan\Command\Output; use function sprintf; final class RawErrorFormatter implements \PHPStan\Command\ErrorFormatter\ErrorFormatter { public function formatErrors(AnalysisResult $analysisResult, Output $output) : int { foreach ($analysisResult->getNotFileSpecificErrors() as $notFileSpecificError) { $output->writeRaw(sprintf('?:?:%s', $notFileSpecificError)); $output->writeLineFormatted(''); } $outputIdentifiers = $output->isVerbose(); foreach ($analysisResult->getFileSpecificErrors() as $fileSpecificError) { $identifier = ''; if ($outputIdentifiers && $fileSpecificError->getIdentifier() !== null) { $identifier = sprintf(' [identifier=%s]', $fileSpecificError->getIdentifier()); } $output->writeRaw(sprintf('%s:%d:%s%s', $fileSpecificError->getFile(), $fileSpecificError->getLine() ?? '?', $fileSpecificError->getMessage(), $identifier)); $output->writeLineFormatted(''); } foreach ($analysisResult->getWarnings() as $warning) { $output->writeRaw(sprintf('?:?:%s', $warning)); $output->writeLineFormatted(''); } return $analysisResult->hasErrors() ? 1 : 0; } } <?php declare (strict_types=1); namespace PHPStan\Command\ErrorFormatter; use PHPStan\Command\AnalysisResult; use PHPStan\Command\Output; use PHPStan\File\RelativePathHelper; use function array_keys; use function array_values; use function count; use function is_string; use function preg_replace; use const PHP_EOL; /** * @see https://www.jetbrains.com/help/teamcity/build-script-interaction-with-teamcity.html#Reporting+Inspections */ final class TeamcityErrorFormatter implements \PHPStan\Command\ErrorFormatter\ErrorFormatter { /** * @var RelativePathHelper */ private $relativePathHelper; public function __construct(RelativePathHelper $relativePathHelper) { $this->relativePathHelper = $relativePathHelper; } public function formatErrors(AnalysisResult $analysisResult, Output $output) : int { $result = ''; $fileSpecificErrors = $analysisResult->getFileSpecificErrors(); $notFileSpecificErrors = $analysisResult->getNotFileSpecificErrors(); $warnings = $analysisResult->getWarnings(); if (count($fileSpecificErrors) === 0 && count($notFileSpecificErrors) === 0 && count($warnings) === 0) { return 0; } $result .= $this->createTeamcityLine('inspectionType', ['id' => 'phpstan', 'name' => 'phpstan', 'category' => 'phpstan', 'description' => 'phpstan Inspection']); foreach ($fileSpecificErrors as $fileSpecificError) { $result .= $this->createTeamcityLine('inspection', [ 'typeId' => 'phpstan', 'message' => $fileSpecificError->getMessage(), 'file' => $this->relativePathHelper->getRelativePath($fileSpecificError->getFile()), 'line' => $fileSpecificError->getLine(), // additional attributes 'SEVERITY' => 'ERROR', 'ignorable' => $fileSpecificError->canBeIgnored(), 'tip' => $fileSpecificError->getTip(), ]); } foreach ($notFileSpecificErrors as $notFileSpecificError) { $result .= $this->createTeamcityLine('inspection', [ 'typeId' => 'phpstan', 'message' => $notFileSpecificError, // the file is required 'file' => $analysisResult->getProjectConfigFile() !== null ? $this->relativePathHelper->getRelativePath($analysisResult->getProjectConfigFile()) : '.', 'SEVERITY' => 'ERROR', ]); } foreach ($warnings as $warning) { $result .= $this->createTeamcityLine('inspection', [ 'typeId' => 'phpstan', 'message' => $warning, // the file is required 'file' => $analysisResult->getProjectConfigFile() !== null ? $this->relativePathHelper->getRelativePath($analysisResult->getProjectConfigFile()) : '.', 'SEVERITY' => 'WARNING', ]); } $output->writeRaw($result); return $analysisResult->hasErrors() ? 1 : 0; } /** * Creates a Teamcity report line * * @param string $messageName The message name * @param mixed[] $keyValuePairs The key=>value pairs * @return string The Teamcity report line */ private function createTeamcityLine(string $messageName, array $keyValuePairs) : string { $string = '##teamcity[' . $messageName; foreach ($keyValuePairs as $key => $value) { if (is_string($value)) { $value = $this->escape($value); } $string .= ' ' . $key . '=\'' . $value . '\''; } return $string . ']' . PHP_EOL; } /** * Escapes the given string for Teamcity output * * @param string $string The string to escape * @return string The escaped string */ private function escape(string $string) : string { $replacements = ['~\\n~' => '|n', '~\\r~' => '|r', '~([\'\\|\\[\\]])~' => '|$1']; return (string) preg_replace(array_keys($replacements), array_values($replacements), $string); } } <?php declare (strict_types=1); namespace PHPStan\Command\ErrorFormatter; use _PHPStan_7d8742a37\Nette\Utils\Json; use PHPStan\Command\AnalysisResult; use PHPStan\Command\Output; use _PHPStan_7d8742a37\Symfony\Component\Console\Formatter\OutputFormatter; use function array_key_exists; use function count; final class JsonErrorFormatter implements \PHPStan\Command\ErrorFormatter\ErrorFormatter { /** * @var bool */ private $pretty; public function __construct(bool $pretty) { $this->pretty = $pretty; } public function formatErrors(AnalysisResult $analysisResult, Output $output) : int { $errorsArray = ['totals' => ['errors' => count($analysisResult->getNotFileSpecificErrors()), 'file_errors' => count($analysisResult->getFileSpecificErrors())], 'files' => [], 'errors' => []]; $tipFormatter = new OutputFormatter(\false); foreach ($analysisResult->getFileSpecificErrors() as $fileSpecificError) { $file = $fileSpecificError->getFile(); if (!array_key_exists($file, $errorsArray['files'])) { $errorsArray['files'][$file] = ['errors' => 0, 'messages' => []]; } $errorsArray['files'][$file]['errors']++; $message = ['message' => $fileSpecificError->getMessage(), 'line' => $fileSpecificError->getLine(), 'ignorable' => $fileSpecificError->canBeIgnored()]; if ($fileSpecificError->getTip() !== null) { $message['tip'] = $tipFormatter->format($fileSpecificError->getTip()); } if ($fileSpecificError->getIdentifier() !== null) { $message['identifier'] = $fileSpecificError->getIdentifier(); } $errorsArray['files'][$file]['messages'][] = $message; } foreach ($analysisResult->getNotFileSpecificErrors() as $notFileSpecificError) { $errorsArray['errors'][] = $notFileSpecificError; } $json = Json::encode($errorsArray, $this->pretty ? Json::PRETTY : 0); $output->writeRaw($json); return $analysisResult->hasErrors() ? 1 : 0; } } <?php declare (strict_types=1); namespace PHPStan\Command\ErrorFormatter; use _PHPStan_7d8742a37\OndraM\CiDetector\CiDetector; use _PHPStan_7d8742a37\OndraM\CiDetector\Exception\CiNotDetectedException; use PHPStan\Command\AnalysisResult; use PHPStan\Command\Output; /** * @api * @final */ class CiDetectedErrorFormatter implements \PHPStan\Command\ErrorFormatter\ErrorFormatter { /** * @var GithubErrorFormatter */ private $githubErrorFormatter; /** * @var TeamcityErrorFormatter */ private $teamcityErrorFormatter; public function __construct(\PHPStan\Command\ErrorFormatter\GithubErrorFormatter $githubErrorFormatter, \PHPStan\Command\ErrorFormatter\TeamcityErrorFormatter $teamcityErrorFormatter) { $this->githubErrorFormatter = $githubErrorFormatter; $this->teamcityErrorFormatter = $teamcityErrorFormatter; } public function formatErrors(AnalysisResult $analysisResult, Output $output) : int { $ciDetector = new CiDetector(); try { $ci = $ciDetector->detect(); if ($ci->getCiName() === CiDetector::CI_GITHUB_ACTIONS) { return $this->githubErrorFormatter->formatErrors($analysisResult, $output); } elseif ($ci->getCiName() === CiDetector::CI_TEAMCITY) { return $this->teamcityErrorFormatter->formatErrors($analysisResult, $output); } } catch (CiNotDetectedException $e) { // pass } if (!$analysisResult->hasErrors() && !$analysisResult->hasWarnings()) { return 0; } return $analysisResult->getTotalErrorsCount() > 0 ? 1 : 0; } } <?php declare (strict_types=1); namespace PHPStan\Command; use Exception; final class InceptionNotSuccessfulException extends Exception { } -----BEGIN PUBLIC KEY----- MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAs+kHoHhs66QaDeVmF6zb kqgEafJTHVsKraOJp64zLlrIZhEiBjKnl5EwpIvvPOfgjjI9z9zm0Y8IoWMfNMf1 MN/9f7603vfJxTAdXVVPtTq4x3dKf1z8RdE9+04Nrfb/+OuAVCtDGCjKec9sRdce 4Ex499BfQx80njFoeC84eY39hNf82rhflW9OMCQeEZhv3durZV5q+tgp+2pdf0yw sdIc/NYebZB1C0Cj6AfqbT9WoMAojfG8R5tF+4S3mMiDHNXx6hNM4mJEpyODje1A qZW91T0x1rFWe25WWLtQG/VP1E+an03C8axn3Ag7+9gohE5hNRKfOWZLZsx+KivD sivJSiyZEP6h6Mxp3aVYk9fmxyJnn0+tvPGYm3wZlPYp0SQIMeYooPr1ddERwtxm 4TyoQ6v8tg+7hrPu4I5km7X8uUzKFtLWj5CB+DVQycjzSbA3Wrj7EcXbKlx8hoyl onQWCVNkSY75CuizY3YqGJr1lCYH7Gut/IAD+gT7CuqgU0PrsSE0c1yBI36Xz090 XZbT1h5UuhF1ezVv3GYSCSHuu3vHzoO4lrrIOmOdcPlSw+BuSy3WOpS9OIud4IwZ UFbzJNs6cOZbnwz7lwBzXFkm3PXPlwXmlGUPF9S4My+F4hYONE4zxI4IcmeF6U43 JUX0xbD+LXNnezCLkvkcVjMCAwEAAQ== -----END PUBLIC KEY----- <?php declare (strict_types=1); namespace PHPStan\Command; use _PHPStan_7d8742a37\OndraM\CiDetector\CiDetector; use PHPStan\Analyser\InternalError; use PHPStan\Command\ErrorFormatter\BaselineNeonErrorFormatter; use PHPStan\Command\ErrorFormatter\BaselinePhpErrorFormatter; use PHPStan\Command\ErrorFormatter\ErrorFormatter; use PHPStan\Command\Symfony\SymfonyOutput; use PHPStan\Command\Symfony\SymfonyStyle; use PHPStan\DependencyInjection\Container; use PHPStan\Diagnose\DiagnoseExtension; use PHPStan\Diagnose\PHPStanDiagnoseExtension; use PHPStan\File\CouldNotWriteFileException; use PHPStan\File\FileHelper; use PHPStan\File\FileReader; use PHPStan\File\FileWriter; use PHPStan\File\ParentDirectoryRelativePathHelper; use PHPStan\File\PathNotFoundException; use PHPStan\File\RelativePathHelper; use PHPStan\Internal\BytesHelper; use PHPStan\Internal\DirectoryCreator; use PHPStan\Internal\DirectoryCreatorException; use PHPStan\ShouldNotHappenException; use _PHPStan_7d8742a37\Symfony\Component\Console\Command\Command; use _PHPStan_7d8742a37\Symfony\Component\Console\Input\InputArgument; use _PHPStan_7d8742a37\Symfony\Component\Console\Input\InputInterface; use _PHPStan_7d8742a37\Symfony\Component\Console\Input\InputOption; use _PHPStan_7d8742a37\Symfony\Component\Console\Input\StringInput; use _PHPStan_7d8742a37\Symfony\Component\Console\Output\OutputInterface; use _PHPStan_7d8742a37\Symfony\Component\Console\Output\StreamOutput; use Throwable; use function array_intersect; use function array_key_exists; use function array_keys; use function array_map; use function array_reverse; use function array_unique; use function array_values; use function count; use function dirname; use function filesize; use function fopen; use function get_class; use function implode; use function in_array; use function is_array; use function is_bool; use function is_file; use function is_string; use function pathinfo; use function rewind; use function sprintf; use function str_contains; use function stream_get_contents; use function strlen; use function substr; use const PATHINFO_BASENAME; use const PATHINFO_EXTENSION; /** * @phpstan-import-type Trace from InternalError as InternalErrorTrace */ final class AnalyseCommand extends Command { /** * @var string[] */ private $composerAutoloaderProjectPaths; /** * @var float */ private $analysisStartTime; private const NAME = 'analyse'; public const OPTION_LEVEL = 'level'; public const DEFAULT_LEVEL = \PHPStan\Command\CommandHelper::DEFAULT_LEVEL; /** * @param string[] $composerAutoloaderProjectPaths */ public function __construct(array $composerAutoloaderProjectPaths, float $analysisStartTime) { $this->composerAutoloaderProjectPaths = $composerAutoloaderProjectPaths; $this->analysisStartTime = $analysisStartTime; parent::__construct(); } protected function configure() : void { $this->setName(self::NAME)->setDescription('Analyses source code')->setDefinition([new InputArgument('paths', InputArgument::OPTIONAL | InputArgument::IS_ARRAY, 'Paths with source code to run analysis on'), new InputOption('configuration', 'c', InputOption::VALUE_REQUIRED, 'Path to project configuration file'), new InputOption(self::OPTION_LEVEL, 'l', InputOption::VALUE_REQUIRED, 'Level of rule options - the higher the stricter'), new InputOption(\PHPStan\Command\ErrorsConsoleStyle::OPTION_NO_PROGRESS, null, InputOption::VALUE_NONE, 'Do not show progress bar, only results'), new InputOption('debug', null, InputOption::VALUE_NONE, 'Show debug information - which file is analysed, do not catch internal errors'), new InputOption('autoload-file', 'a', InputOption::VALUE_REQUIRED, 'Project\'s additional autoload file path'), new InputOption('error-format', null, InputOption::VALUE_REQUIRED, 'Format in which to print the result of the analysis', null), new InputOption('generate-baseline', 'b', InputOption::VALUE_OPTIONAL, 'Path to a file where the baseline should be saved', \false), new InputOption('allow-empty-baseline', null, InputOption::VALUE_NONE, 'Do not error out when the generated baseline is empty'), new InputOption('memory-limit', null, InputOption::VALUE_REQUIRED, 'Memory limit for analysis'), new InputOption('xdebug', null, InputOption::VALUE_NONE, 'Allow running with Xdebug for debugging purposes'), new InputOption('fix', null, InputOption::VALUE_NONE, 'Launch PHPStan Pro'), new InputOption('watch', null, InputOption::VALUE_NONE, 'Launch PHPStan Pro'), new InputOption('pro', null, InputOption::VALUE_NONE, 'Launch PHPStan Pro'), new InputOption('fail-without-result-cache', null, InputOption::VALUE_NONE, 'Return non-zero exit code when result cache is not used')]); } /** * @return string[] */ public function getAliases() : array { return ['analyze']; } protected function initialize(InputInterface $input, OutputInterface $output) : void { if ((bool) $input->getOption('debug')) { $application = $this->getApplication(); if ($application === null) { return; } $application->setCatchExceptions(\false); return; } } protected function execute(InputInterface $input, OutputInterface $output) : int { $paths = $input->getArgument('paths'); $memoryLimit = $input->getOption('memory-limit'); $autoloadFile = $input->getOption('autoload-file'); $configuration = $input->getOption('configuration'); $level = $input->getOption(self::OPTION_LEVEL); $allowXdebug = $input->getOption('xdebug'); $debugEnabled = (bool) $input->getOption('debug'); $fix = (bool) $input->getOption('fix') || (bool) $input->getOption('watch') || (bool) $input->getOption('pro'); $failWithoutResultCache = (bool) $input->getOption('fail-without-result-cache'); /** @var string|false|null $generateBaselineFile */ $generateBaselineFile = $input->getOption('generate-baseline'); if ($generateBaselineFile === \false) { $generateBaselineFile = null; } elseif ($generateBaselineFile === null) { $generateBaselineFile = 'phpstan-baseline.neon'; } $allowEmptyBaseline = (bool) $input->getOption('allow-empty-baseline'); if (!is_array($paths) || !is_string($memoryLimit) && $memoryLimit !== null || !is_string($autoloadFile) && $autoloadFile !== null || !is_string($configuration) && $configuration !== null || !is_string($level) && $level !== null || !is_bool($allowXdebug)) { throw new ShouldNotHappenException(); } try { $inceptionResult = \PHPStan\Command\CommandHelper::begin($input, $output, $paths, $memoryLimit, $autoloadFile, $this->composerAutoloaderProjectPaths, $configuration, $generateBaselineFile, $level, $allowXdebug, $debugEnabled); } catch (\PHPStan\Command\InceptionNotSuccessfulException $e) { return 1; } if ($generateBaselineFile === null && $allowEmptyBaseline) { $inceptionResult->getStdOutput()->getStyle()->error('You must pass the --generate-baseline option alongside --allow-empty-baseline.'); return $inceptionResult->handleReturn(1, null, $this->analysisStartTime); } $errorOutput = $inceptionResult->getErrorOutput(); $obsoleteDockerImage = $_SERVER['PHPSTAN_OBSOLETE_DOCKER_IMAGE'] ?? 'false'; if ($obsoleteDockerImage === 'true') { $errorOutput->writeLineFormatted('⚠️ You\'re using an obsolete PHPStan Docker image. ⚠️️'); $errorOutput->writeLineFormatted(' You can obtain the current one from <fg=cyan>ghcr.io/phpstan/phpstan</>.'); $errorOutput->writeLineFormatted(' Read more about it here:'); $errorOutput->writeLineFormatted(' <fg=cyan>https://phpstan.org/user-guide/docker</>'); $errorOutput->writeLineFormatted(''); } $errorFormat = $input->getOption('error-format'); if (!is_string($errorFormat) && $errorFormat !== null) { throw new ShouldNotHappenException(); } if ($errorFormat === null) { $errorFormat = $inceptionResult->getContainer()->getParameter('errorFormat'); } if ($errorFormat === null) { $errorFormat = 'table'; } $container = $inceptionResult->getContainer(); $errorFormatterServiceName = sprintf('errorFormatter.%s', $errorFormat); if (!$container->hasService($errorFormatterServiceName)) { $errorOutput->writeLineFormatted(sprintf('Error formatter "%s" not found. Available error formatters are: %s', $errorFormat, implode(', ', array_map(static function (string $name) : string { return substr($name, strlen('errorFormatter.')); }, $container->findServiceNamesByType(ErrorFormatter::class))))); return 1; } $generateBaselineFile = $inceptionResult->getGenerateBaselineFile(); if ($generateBaselineFile !== null) { $baselineExtension = pathinfo($generateBaselineFile, PATHINFO_EXTENSION); if ($baselineExtension === '') { $inceptionResult->getStdOutput()->getStyle()->error(sprintf('Baseline filename must have an extension, %s provided instead.', pathinfo($generateBaselineFile, PATHINFO_BASENAME))); return $inceptionResult->handleReturn(1, null, $this->analysisStartTime); } if (!in_array($baselineExtension, ['neon', 'php'], \true)) { $inceptionResult->getStdOutput()->getStyle()->error(sprintf('Baseline filename extension must be .neon or .php, .%s was used instead.', $baselineExtension)); return $inceptionResult->handleReturn(1, null, $this->analysisStartTime); } } try { [$files, $onlyFiles] = $inceptionResult->getFiles(); } catch (PathNotFoundException $e) { $this->runDiagnoseExtensions($container, $inceptionResult->getErrorOutput()); $inceptionResult->getErrorOutput()->writeLineFormatted(sprintf('<error>%s</error>', $e->getMessage())); return 1; } catch (\PHPStan\Command\InceptionNotSuccessfulException $e) { $this->runDiagnoseExtensions($container, $inceptionResult->getErrorOutput()); return 1; } if (count($files) === 0) { $bleedingEdge = (bool) $container->getParameter('featureToggles')['zeroFiles']; $this->runDiagnoseExtensions($container, $inceptionResult->getErrorOutput()); if (!$bleedingEdge) { $inceptionResult->getErrorOutput()->getStyle()->note('No files found to analyse.'); $inceptionResult->getErrorOutput()->getStyle()->warning('This will cause a non-zero exit code in PHPStan 2.0.'); return $inceptionResult->handleReturn(0, null, $this->analysisStartTime); } $inceptionResult->getErrorOutput()->getStyle()->error('No files found to analyse.'); return $inceptionResult->handleReturn(1, null, $this->analysisStartTime); } $analysedConfigFiles = array_intersect($files, $container->getParameter('allConfigFiles')); /** @var RelativePathHelper $relativePathHelper */ $relativePathHelper = $container->getService('relativePathHelper'); foreach ($analysedConfigFiles as $analysedConfigFile) { $fileSize = @filesize($analysedConfigFile); if ($fileSize === \false) { continue; } if ($fileSize <= 512 * 1024) { continue; } $inceptionResult->getErrorOutput()->getStyle()->warning(sprintf('Configuration file %s (%s) is too big and might slow down PHPStan. Consider adding it to excludePaths.', $relativePathHelper->getRelativePath($analysedConfigFile), BytesHelper::bytes($fileSize))); } if ($fix) { if ($generateBaselineFile !== null) { $inceptionResult->getStdOutput()->getStyle()->error('You cannot pass the --generate-baseline option when running PHPStan Pro.'); return $inceptionResult->handleReturn(1, null, $this->analysisStartTime); } return $this->runFixer($inceptionResult, $container, $onlyFiles, $input, $output, $files); } /** @var AnalyseApplication $application */ $application = $container->getByType(\PHPStan\Command\AnalyseApplication::class); $debug = $input->getOption('debug'); if (!is_bool($debug)) { throw new ShouldNotHappenException(); } try { $analysisResult = $application->analyse($files, $onlyFiles, $inceptionResult->getStdOutput(), $inceptionResult->getErrorOutput(), $inceptionResult->isDefaultLevelUsed(), $debug, $inceptionResult->getProjectConfigFile(), $inceptionResult->getProjectConfigArray(), $input); } catch (Throwable $t) { if ($debug) { $stdOutput = $inceptionResult->getStdOutput(); $stdOutput->writeRaw(sprintf('Uncaught %s: %s in %s:%d', get_class($t), $t->getMessage(), $t->getFile(), $t->getLine())); $stdOutput->writeLineFormatted(''); $stdOutput->writeRaw($t->getTraceAsString()); $stdOutput->writeLineFormatted(''); $previous = $t->getPrevious(); while ($previous !== null) { $stdOutput->writeLineFormatted(''); $stdOutput->writeLineFormatted('Caused by:'); $stdOutput->writeRaw(sprintf('Uncaught %s: %s in %s:%d', get_class($previous), $previous->getMessage(), $previous->getFile(), $previous->getLine())); $stdOutput->writeRaw($previous->getTraceAsString()); $stdOutput->writeLineFormatted(''); $previous = $previous->getPrevious(); } return $inceptionResult->handleReturn(1, null, $this->analysisStartTime); } throw $t; } /** * Variable $internalErrorsTuples contains both "internal errors" * and "errors with non-ignorable exception" as InternalError objects. */ $internalErrorsTuples = []; $internalFileSpecificErrors = []; foreach ($analysisResult->getInternalErrorObjects() as $internalError) { $internalErrorsTuples[$internalError->getMessage()] = [new InternalError($internalError->getTraceAsString() !== null ? sprintf('Internal error: %s', $internalError->getMessage()) : $internalError->getMessage(), $internalError->getContextDescription(), $internalError->getTrace(), $internalError->getTraceAsString(), $internalError->shouldReportBug()), \false]; } foreach ($analysisResult->getFileSpecificErrors() as $fileSpecificError) { if (!$fileSpecificError->hasNonIgnorableException()) { continue; } $message = $fileSpecificError->getMessage(); $metadata = $fileSpecificError->getMetadata(); $hasStackTrace = \false; if ($fileSpecificError->getIdentifier() === 'phpstan.internal' && array_key_exists(InternalError::STACK_TRACE_AS_STRING_METADATA_KEY, $metadata)) { $message = sprintf('Internal error: %s', $message); $hasStackTrace = \true; } if (!$hasStackTrace) { if (!array_key_exists($fileSpecificError->getMessage(), $internalFileSpecificErrors)) { $internalFileSpecificErrors[$fileSpecificError->getMessage()] = $fileSpecificError; } } $internalErrorsTuples[$fileSpecificError->getMessage()] = [new InternalError($message, sprintf('analysing file %s', $fileSpecificError->getTraitFilePath() ?? $fileSpecificError->getFilePath()), $metadata[InternalError::STACK_TRACE_METADATA_KEY] ?? [], $metadata[InternalError::STACK_TRACE_AS_STRING_METADATA_KEY] ?? null, \true), !$hasStackTrace]; } $internalErrorsTuples = array_values($internalErrorsTuples); $fileHelper = $container->getByType(FileHelper::class); /** * Variable $internalErrors only contains non-file-specific "internal errors". */ $internalErrors = []; foreach ($internalErrorsTuples as [$internalError, $isInFileSpecificErrors]) { if ($isInFileSpecificErrors) { continue; } $internalErrors[] = new InternalError($this->getMessageFromInternalError($fileHelper, $internalError, $output->getVerbosity()), $internalError->getContextDescription(), $internalError->getTrace(), $internalError->getTraceAsString(), $internalError->shouldReportBug()); } if ($generateBaselineFile !== null) { $this->runDiagnoseExtensions($container, $inceptionResult->getErrorOutput()); if (count($internalErrorsTuples) > 0) { foreach ($internalErrorsTuples as [$internalError]) { $inceptionResult->getStdOutput()->writeLineFormatted($internalError->getMessage()); $inceptionResult->getStdOutput()->writeLineFormatted(''); } $inceptionResult->getStdOutput()->getStyle()->error(sprintf('%s occurred. Baseline could not be generated.', count($internalErrors) === 1 ? 'An internal error' : 'Internal errors')); return $inceptionResult->handleReturn(1, $analysisResult->getPeakMemoryUsageBytes(), $this->analysisStartTime); } return $this->generateBaseline($generateBaselineFile, $inceptionResult, $analysisResult, $output, $allowEmptyBaseline, $baselineExtension, $failWithoutResultCache); } /** @var ErrorFormatter $errorFormatter */ $errorFormatter = $container->getService($errorFormatterServiceName); if (count($internalErrorsTuples) > 0) { $analysisResult = new \PHPStan\Command\AnalysisResult(array_values($internalFileSpecificErrors), array_map(static function (InternalError $internalError) { return $internalError->getMessage(); }, $internalErrors), [], [], [], $analysisResult->isDefaultLevelUsed(), $analysisResult->getProjectConfigFile(), $analysisResult->isResultCacheSaved(), $analysisResult->getPeakMemoryUsageBytes(), $analysisResult->isResultCacheUsed(), $analysisResult->getChangedProjectExtensionFilesOutsideOfAnalysedPaths()); $exitCode = $errorFormatter->formatErrors($analysisResult, $inceptionResult->getStdOutput()); $this->runDiagnoseExtensions($container, $inceptionResult->getErrorOutput()); $errorOutput->writeLineFormatted('⚠️ Result is incomplete because of severe errors. ⚠️'); $errorOutput->writeLineFormatted(' Fix these errors first and then re-run PHPStan'); $errorOutput->writeLineFormatted(' to get all reported errors.'); $errorOutput->writeLineFormatted(''); return $inceptionResult->handleReturn($exitCode, $analysisResult->getPeakMemoryUsageBytes(), $this->analysisStartTime); } $exitCode = $errorFormatter->formatErrors($analysisResult, $inceptionResult->getStdOutput()); if ($failWithoutResultCache && !$analysisResult->isResultCacheUsed()) { $exitCode = 2; } if ($analysisResult->isResultCacheUsed() && $analysisResult->isResultCacheSaved() && !$onlyFiles && $inceptionResult->getProjectConfigArray() !== null) { $projectServicesNotInAnalysedPaths = array_values(array_unique($analysisResult->getChangedProjectExtensionFilesOutsideOfAnalysedPaths())); $projectServiceFileNamesNotInAnalysedPaths = array_keys($analysisResult->getChangedProjectExtensionFilesOutsideOfAnalysedPaths()); if (count($projectServicesNotInAnalysedPaths) > 0) { $one = count($projectServicesNotInAnalysedPaths) === 1; $errorOutput->writeLineFormatted('<comment>Result cache might not behave correctly.</comment>'); $errorOutput->writeLineFormatted(sprintf('You\'re using custom %s in your project config', $one ? 'extension' : 'extensions')); $errorOutput->writeLineFormatted(sprintf('but %s not part of analysed paths:', $one ? 'this extension is' : 'these extensions are')); $errorOutput->writeLineFormatted(''); foreach ($projectServicesNotInAnalysedPaths as $service) { $errorOutput->writeLineFormatted(sprintf('- %s', $service)); } $errorOutput->writeLineFormatted(''); $errorOutput->writeLineFormatted('When you edit them and re-run PHPStan, the result cache will get stale.'); $directoriesToAdd = []; foreach ($projectServiceFileNamesNotInAnalysedPaths as $path) { $directoriesToAdd[] = dirname($relativePathHelper->getRelativePath($path)); } $directoriesToAdd = array_unique($directoriesToAdd); $oneDirectory = count($directoriesToAdd) === 1; $errorOutput->writeLineFormatted(sprintf('Add %s to your analysed paths to get rid of this problem:', $oneDirectory ? 'this directory' : 'these directories')); $errorOutput->writeLineFormatted(''); foreach ($directoriesToAdd as $directory) { $errorOutput->writeLineFormatted(sprintf('- %s', $directory)); } $errorOutput->writeLineFormatted(''); $bleedingEdge = (bool) $container->getParameter('featureToggles')['projectServicesNotInAnalysedPaths']; if ($bleedingEdge) { return $inceptionResult->handleReturn(1, $analysisResult->getPeakMemoryUsageBytes(), $this->analysisStartTime); } $errorOutput->getStyle()->warning('This will cause a non-zero exit code in PHPStan 2.0.'); } } $this->runDiagnoseExtensions($container, $inceptionResult->getErrorOutput()); return $inceptionResult->handleReturn($exitCode, $analysisResult->getPeakMemoryUsageBytes(), $this->analysisStartTime); } private function createStreamOutput() : StreamOutput { $resource = fopen('php://memory', 'w', \false); if ($resource === \false) { throw new ShouldNotHappenException(); } return new StreamOutput($resource); } private function getMessageFromInternalError(FileHelper $fileHelper, InternalError $internalError, int $verbosity) : string { $message = sprintf('%s while %s', $internalError->getMessage(), $internalError->getContextDescription()); $hasLarastan = \false; $isLaravelLast = \false; foreach (array_reverse($internalError->getTrace()) as $traceItem) { if ($traceItem['file'] === null) { continue; } $file = $fileHelper->normalizePath($traceItem['file'], '/'); if (str_contains($file, '/larastan/')) { $hasLarastan = \true; $isLaravelLast = \false; continue; } if (!str_contains($file, '/laravel/framework/')) { continue; } $isLaravelLast = \true; } if ($hasLarastan) { if ($isLaravelLast) { $message .= "\n"; $message .= "\n" . 'This message is coming from Laravel Framework itself.'; $message .= "\n" . 'Larastan boots up your application in order to provide'; $message .= "\n" . 'smarter static analysis of your codebase.'; $message .= "\n"; $message .= "\n" . 'In order to do that, the environment you run PHPStan in'; $message .= "\n" . 'must match the environment you run your application in.'; $message .= "\n"; $message .= "\n" . 'Make sure you\'ve set your environment variables'; $message .= "\n" . 'or the .env file correctly.'; return $message; } $bugReportUrl = 'https://github.com/larastan/larastan/issues/new?template=bug-report.md'; } else { $bugReportUrl = 'https://github.com/phpstan/phpstan/issues/new?template=Bug_report.yaml'; } if ($internalError->getTraceAsString() !== null) { if (OutputInterface::VERBOSITY_VERBOSE <= $verbosity) { $firstTraceItem = $internalError->getTrace()[0] ?? null; $trace = ''; if ($firstTraceItem !== null && $firstTraceItem['file'] !== null && $firstTraceItem['line'] !== null) { $trace = sprintf('## %s(%d)%s', $firstTraceItem['file'], $firstTraceItem['line'], "\n"); } $trace .= $internalError->getTraceAsString(); if ($internalError->shouldReportBug()) { $message .= sprintf('%sPost the following stack trace to %s: %s%s', "\n", $bugReportUrl, "\n", $trace); } else { $message .= sprintf('%s%s', "\n\n", $trace); } } else { if ($internalError->shouldReportBug()) { $message .= sprintf('%sRun PHPStan with -v option and post the stack trace to:%s%s%s', "\n\n", "\n", $bugReportUrl, "\n"); } else { $message .= sprintf('%sRun PHPStan with -v option to see the stack trace', "\n"); } } } return $message; } private function generateBaseline(string $generateBaselineFile, \PHPStan\Command\InceptionResult $inceptionResult, \PHPStan\Command\AnalysisResult $analysisResult, OutputInterface $output, bool $allowEmptyBaseline, string $baselineExtension, bool $failWithoutResultCache) : int { if (!$allowEmptyBaseline && !$analysisResult->hasErrors()) { $inceptionResult->getStdOutput()->getStyle()->error('No errors were found during the analysis. Baseline could not be generated.'); $inceptionResult->getStdOutput()->writeLineFormatted('To allow generating empty baselines, pass <fg=cyan>--allow-empty-baseline</> option.'); return $inceptionResult->handleReturn(1, $analysisResult->getPeakMemoryUsageBytes(), $this->analysisStartTime); } $streamOutput = $this->createStreamOutput(); $errorConsoleStyle = new \PHPStan\Command\ErrorsConsoleStyle(new StringInput(''), $streamOutput); $baselineOutput = new SymfonyOutput($streamOutput, new SymfonyStyle($errorConsoleStyle)); $baselineFileDirectory = dirname($generateBaselineFile); $baselinePathHelper = new ParentDirectoryRelativePathHelper($baselineFileDirectory); if ($baselineExtension === 'php') { $baselineErrorFormatter = new BaselinePhpErrorFormatter($baselinePathHelper); $baselineErrorFormatter->formatErrors($analysisResult, $baselineOutput); } else { $baselineErrorFormatter = new BaselineNeonErrorFormatter($baselinePathHelper); $existingBaselineContent = is_file($generateBaselineFile) ? FileReader::read($generateBaselineFile) : ''; $baselineErrorFormatter->formatErrors($analysisResult, $baselineOutput, $existingBaselineContent); } $stream = $streamOutput->getStream(); rewind($stream); $baselineContents = stream_get_contents($stream); if ($baselineContents === \false) { throw new ShouldNotHappenException(); } try { DirectoryCreator::ensureDirectoryExists($baselineFileDirectory, 0644); } catch (DirectoryCreatorException $e) { $inceptionResult->getStdOutput()->writeLineFormatted($e->getMessage()); return $inceptionResult->handleReturn(1, $analysisResult->getPeakMemoryUsageBytes(), $this->analysisStartTime); } try { FileWriter::write($generateBaselineFile, $baselineContents); } catch (CouldNotWriteFileException $e) { $inceptionResult->getStdOutput()->writeLineFormatted($e->getMessage()); return $inceptionResult->handleReturn(1, $analysisResult->getPeakMemoryUsageBytes(), $this->analysisStartTime); } $errorsCount = 0; $unignorableCount = 0; foreach ($analysisResult->getFileSpecificErrors() as $fileSpecificError) { if (!$fileSpecificError->canBeIgnored()) { $unignorableCount++; if ($output->isVeryVerbose()) { $inceptionResult->getStdOutput()->writeLineFormatted('<error>Unignorable errors could not be added to the baseline:</error>'); $inceptionResult->getStdOutput()->writeLineFormatted($fileSpecificError->getMessage()); $inceptionResult->getStdOutput()->writeLineFormatted($fileSpecificError->getFile()); $inceptionResult->getStdOutput()->writeLineFormatted(''); } continue; } $errorsCount++; } $message = sprintf('Baseline generated with %d %s.', $errorsCount, $errorsCount === 1 ? 'error' : 'errors'); if ($unignorableCount === 0 && count($analysisResult->getNotFileSpecificErrors()) === 0) { $inceptionResult->getStdOutput()->getStyle()->success($message); } else { if ($output->isVeryVerbose()) { $inceptionResult->getStdOutput()->getStyle()->warning($message . "\nSome errors could not be put into baseline."); } else { $inceptionResult->getStdOutput()->getStyle()->warning($message . "\nSome errors could not be put into baseline. Re-run PHPStan with \"-vv\" and fix them."); } } $exitCode = 0; if ($failWithoutResultCache && !$analysisResult->isResultCacheUsed()) { $exitCode = 2; } return $inceptionResult->handleReturn($exitCode, $analysisResult->getPeakMemoryUsageBytes(), $this->analysisStartTime); } /** * @param string[] $files */ private function runFixer(\PHPStan\Command\InceptionResult $inceptionResult, Container $container, bool $onlyFiles, InputInterface $input, OutputInterface $output, array $files) : int { $ciDetector = new CiDetector(); if ($ciDetector->isCiDetected()) { $inceptionResult->getStdOutput()->writeLineFormatted('PHPStan Pro can\'t run in CI environment yet. Stay tuned!'); return $inceptionResult->handleReturn(1, null, $this->analysisStartTime); } /** @var FixerApplication $fixerApplication */ $fixerApplication = $container->getByType(\PHPStan\Command\FixerApplication::class); return $fixerApplication->run($inceptionResult->getProjectConfigFile(), $input, $output, count($files), $_SERVER['argv'][0]); } private function runDiagnoseExtensions(Container $container, \PHPStan\Command\Output $errorOutput) : void { if (!$errorOutput->isDebug()) { return; } /** @var PHPStanDiagnoseExtension $phpstanDiagnoseExtension */ $phpstanDiagnoseExtension = $container->getService('phpstanDiagnoseExtension'); // not using tag for this extension to make sure it's always first $phpstanDiagnoseExtension->print($errorOutput); /** @var DiagnoseExtension $extension */ foreach ($container->getServicesByTag(DiagnoseExtension::EXTENSION_TAG) as $extension) { $extension->print($errorOutput); } } } <?php declare (strict_types=1); namespace PHPStan\Command; use PHPStan\DependencyInjection\Container; use PHPStan\File\PathNotFoundException; use PHPStan\Internal\BytesHelper; use function floor; use function implode; use function max; use function memory_get_peak_usage; use function microtime; use function round; use function sprintf; final class InceptionResult { /** * @var Output */ private $stdOutput; /** * @var Output */ private $errorOutput; /** * @var Container */ private $container; /** * @var bool */ private $isDefaultLevelUsed; /** * @var ?string */ private $projectConfigFile; /** * @var mixed[]|null */ private $projectConfigArray; /** * @var ?string */ private $generateBaselineFile; /** @var callable(): (array{string[], bool}) */ private $filesCallback; /** * @param callable(): (array{string[], bool}) $filesCallback * @param mixed[]|null $projectConfigArray */ public function __construct(callable $filesCallback, \PHPStan\Command\Output $stdOutput, \PHPStan\Command\Output $errorOutput, Container $container, bool $isDefaultLevelUsed, ?string $projectConfigFile, ?array $projectConfigArray, ?string $generateBaselineFile) { $this->stdOutput = $stdOutput; $this->errorOutput = $errorOutput; $this->container = $container; $this->isDefaultLevelUsed = $isDefaultLevelUsed; $this->projectConfigFile = $projectConfigFile; $this->projectConfigArray = $projectConfigArray; $this->generateBaselineFile = $generateBaselineFile; $this->filesCallback = $filesCallback; } /** * @throws InceptionNotSuccessfulException * @throws PathNotFoundException * @return array{string[], bool} */ public function getFiles() : array { $callback = $this->filesCallback; /** @throws InceptionNotSuccessfulException|PathNotFoundException */ return $callback(); } public function getStdOutput() : \PHPStan\Command\Output { return $this->stdOutput; } public function getErrorOutput() : \PHPStan\Command\Output { return $this->errorOutput; } public function getContainer() : Container { return $this->container; } public function isDefaultLevelUsed() : bool { return $this->isDefaultLevelUsed; } public function getProjectConfigFile() : ?string { return $this->projectConfigFile; } /** * @return mixed[]|null */ public function getProjectConfigArray() : ?array { return $this->projectConfigArray; } public function getGenerateBaselineFile() : ?string { return $this->generateBaselineFile; } public function handleReturn(int $exitCode, ?int $peakMemoryUsageBytes, float $analysisStartTime) : int { if ($this->getErrorOutput()->isVerbose()) { $this->getErrorOutput()->writeLineFormatted(sprintf('Elapsed time: %s', $this->formatDuration((int) round(microtime(\true) - $analysisStartTime)))); } if ($peakMemoryUsageBytes !== null && $this->getErrorOutput()->isVerbose()) { $this->getErrorOutput()->writeLineFormatted(sprintf('Used memory: %s', BytesHelper::bytes(max(memory_get_peak_usage(\true), $peakMemoryUsageBytes)))); } return $exitCode; } private function formatDuration(int $seconds) : string { $minutes = (int) floor($seconds / 60); $remainingSeconds = $seconds % 60; $result = []; if ($minutes > 0) { $result[] = $minutes . ' minute' . ($minutes > 1 ? 's' : ''); } if ($remainingSeconds > 0) { $result[] = $remainingSeconds . ' second' . ($remainingSeconds > 1 ? 's' : ''); } return implode(' ', $result); } } <?php declare (strict_types=1); namespace PHPStan\Command; use _PHPStan_7d8742a37\OndraM\CiDetector\CiDetector; use _PHPStan_7d8742a37\Symfony\Component\Console\Helper\ProgressBar; use _PHPStan_7d8742a37\Symfony\Component\Console\Helper\TableSeparator; use _PHPStan_7d8742a37\Symfony\Component\Console\Input\InputInterface; use _PHPStan_7d8742a37\Symfony\Component\Console\Output\OutputInterface; use _PHPStan_7d8742a37\Symfony\Component\Console\Style\SymfonyStyle; use _PHPStan_7d8742a37\Symfony\Component\Console\Terminal; use function array_unshift; use function explode; use function implode; use function sprintf; use function str_starts_with; use function strlen; use function wordwrap; use const DIRECTORY_SEPARATOR; final class ErrorsConsoleStyle extends SymfonyStyle { public const OPTION_NO_PROGRESS = 'no-progress'; /** * @var bool */ private $showProgress; /** * @var ProgressBar */ private $progressBar; /** * @var ?bool */ private $isCiDetected = null; public function __construct(InputInterface $input, OutputInterface $output) { parent::__construct($input, $output); $this->showProgress = $input->hasOption(self::OPTION_NO_PROGRESS) && !(bool) $input->getOption(self::OPTION_NO_PROGRESS); } private function isCiDetected() : bool { if ($this->isCiDetected === null) { $ciDetector = new CiDetector(); $this->isCiDetected = $ciDetector->isCiDetected(); } return $this->isCiDetected; } /** * @param string[] $headers * @param string[][] $rows */ public function table(array $headers, array $rows) : void { /** @var int $terminalWidth */ $terminalWidth = (new Terminal())->getWidth() - 2; $maxHeaderWidth = strlen($headers[0]); foreach ($rows as $row) { $length = strlen($row[0]); if ($maxHeaderWidth !== 0 && $length <= $maxHeaderWidth) { continue; } $maxHeaderWidth = $length; } // manual wrapping could be replaced with $table->setColumnMaxWidth() // but it's buggy for <href> lines // https://github.com/symfony/symfony/issues/45520 // https://github.com/symfony/symfony/issues/45521 $headers = $this->wrap($headers, $terminalWidth, $maxHeaderWidth); foreach ($headers as $i => $header) { $newHeader = []; foreach (explode("\n", $header) as $h) { $newHeader[] = sprintf('<info>%s</info>', $h); } $headers[$i] = implode("\n", $newHeader); } foreach ($rows as $i => $row) { $rows[$i] = $this->wrap($row, $terminalWidth, $maxHeaderWidth); } $table = $this->createTable(); array_unshift($rows, $headers, new TableSeparator()); $table->setRows($rows); $table->render(); $this->newLine(); } /** * @param string[] $rows * @return string[] */ private function wrap(array $rows, int $terminalWidth, int $maxHeaderWidth) : array { foreach ($rows as $i => $column) { $columnRows = explode("\n", $column); foreach ($columnRows as $k => $columnRow) { if (str_starts_with($columnRow, '✏️')) { continue; } $wrapped = wordwrap($columnRow, $terminalWidth - $maxHeaderWidth - 5); if (str_starts_with($columnRow, '💡 ')) { $wrappedLines = explode("\n", $wrapped); $newWrappedLines = []; foreach ($wrappedLines as $l => $line) { if ($l === 0) { $newWrappedLines[] = $line; continue; } $newWrappedLines[] = ' ' . $line; } $columnRows[$k] = implode("\n", $newWrappedLines); } else { $columnRows[$k] = $wrapped; } } $rows[$i] = implode("\n", $columnRows); } return $rows; } public function createProgressBar(int $max = 0) : ProgressBar { $this->progressBar = parent::createProgressBar($max); $format = $this->getProgressBarFormat(); if ($format !== null) { $this->progressBar->setFormat($format); } $ci = $this->isCiDetected(); $this->progressBar->setOverwrite(!$ci); if ($ci) { $this->progressBar->minSecondsBetweenRedraws(15); $this->progressBar->maxSecondsBetweenRedraws(30); } elseif (DIRECTORY_SEPARATOR === '\\') { $this->progressBar->minSecondsBetweenRedraws(0.5); $this->progressBar->maxSecondsBetweenRedraws(2); } else { $this->progressBar->minSecondsBetweenRedraws(0.1); $this->progressBar->maxSecondsBetweenRedraws(0.5); } return $this->progressBar; } private function getProgressBarFormat() : ?string { switch ($this->getVerbosity()) { case OutputInterface::VERBOSITY_NORMAL: $formatName = ProgressBar::FORMAT_NORMAL; break; case OutputInterface::VERBOSITY_VERBOSE: $formatName = ProgressBar::FORMAT_VERBOSE; break; case OutputInterface::VERBOSITY_VERY_VERBOSE: case OutputInterface::VERBOSITY_DEBUG: $formatName = ProgressBar::FORMAT_VERY_VERBOSE; break; default: $formatName = null; break; } if ($formatName === null) { return null; } return ProgressBar::getFormatDefinition($formatName); } public function progressStart(int $max = 0) : void { if (!$this->showProgress) { return; } parent::progressStart($max); } public function progressAdvance(int $step = 1) : void { if (!$this->showProgress) { return; } parent::progressAdvance($step); } public function progressFinish() : void { if (!$this->showProgress) { return; } parent::progressFinish(); } } <?php declare (strict_types=1); namespace PHPStan\Command; use PHPStan\Diagnose\DiagnoseExtension; use PHPStan\Diagnose\PHPStanDiagnoseExtension; use PHPStan\ShouldNotHappenException; use _PHPStan_7d8742a37\Symfony\Component\Console\Command\Command; use _PHPStan_7d8742a37\Symfony\Component\Console\Input\InputInterface; use _PHPStan_7d8742a37\Symfony\Component\Console\Input\InputOption; use _PHPStan_7d8742a37\Symfony\Component\Console\Output\OutputInterface; use function is_string; final class DiagnoseCommand extends Command { /** * @var string[] */ private $composerAutoloaderProjectPaths; private const NAME = 'diagnose'; /** * @param string[] $composerAutoloaderProjectPaths */ public function __construct(array $composerAutoloaderProjectPaths) { $this->composerAutoloaderProjectPaths = $composerAutoloaderProjectPaths; parent::__construct(); } protected function configure() : void { $this->setName(self::NAME)->setDescription('Shows diagnose information about PHPStan and extensions')->setDefinition([new InputOption('configuration', 'c', InputOption::VALUE_REQUIRED, 'Path to project configuration file'), new InputOption(\PHPStan\Command\AnalyseCommand::OPTION_LEVEL, 'l', InputOption::VALUE_REQUIRED, 'Level of rule options - the higher the stricter'), new InputOption('autoload-file', 'a', InputOption::VALUE_REQUIRED, 'Project\'s additional autoload file path'), new InputOption('debug', null, InputOption::VALUE_NONE, 'Show debug information - do not catch internal errors'), new InputOption('memory-limit', null, InputOption::VALUE_REQUIRED, 'Memory limit for clearing result cache')]); } protected function initialize(InputInterface $input, OutputInterface $output) : void { if ((bool) $input->getOption('debug')) { $application = $this->getApplication(); if ($application === null) { throw new ShouldNotHappenException(); } $application->setCatchExceptions(\false); return; } } protected function execute(InputInterface $input, OutputInterface $output) : int { $memoryLimit = $input->getOption('memory-limit'); $autoloadFile = $input->getOption('autoload-file'); $configuration = $input->getOption('configuration'); $level = $input->getOption(\PHPStan\Command\AnalyseCommand::OPTION_LEVEL); if (!is_string($memoryLimit) && $memoryLimit !== null || !is_string($autoloadFile) && $autoloadFile !== null || !is_string($configuration) && $configuration !== null || !is_string($level) && $level !== null) { throw new ShouldNotHappenException(); } try { $inceptionResult = \PHPStan\Command\CommandHelper::begin($input, $output, [], $memoryLimit, $autoloadFile, $this->composerAutoloaderProjectPaths, $configuration, null, $level, \false); } catch (\PHPStan\Command\InceptionNotSuccessfulException $e) { return 1; } $container = $inceptionResult->getContainer(); $output = $inceptionResult->getStdOutput(); /** @var PHPStanDiagnoseExtension $phpstanDiagnoseExtension */ $phpstanDiagnoseExtension = $container->getService('phpstanDiagnoseExtension'); // not using tag for this extension to make sure it's always first $phpstanDiagnoseExtension->print($output); /** @var DiagnoseExtension $extension */ foreach ($container->getServicesByTag(DiagnoseExtension::EXTENSION_TAG) as $extension) { $extension->print($output); } return 0; } } <?php declare (strict_types=1); namespace PHPStan\Command; final class IgnoredRegexValidatorResult { /** * @var array<string, string> */ private $ignoredTypes; /** * @var bool */ private $anchorsInTheMiddle; /** * @var bool */ private $allErrorsIgnored; /** * @var ?string */ private $wrongSequence; /** * @var ?string */ private $escapedWrongSequence; /** * @param array<string, string> $ignoredTypes */ public function __construct(array $ignoredTypes, bool $anchorsInTheMiddle, bool $allErrorsIgnored, ?string $wrongSequence = null, ?string $escapedWrongSequence = null) { $this->ignoredTypes = $ignoredTypes; $this->anchorsInTheMiddle = $anchorsInTheMiddle; $this->allErrorsIgnored = $allErrorsIgnored; $this->wrongSequence = $wrongSequence; $this->escapedWrongSequence = $escapedWrongSequence; } /** * @return array<string, string> */ public function getIgnoredTypes() : array { return $this->ignoredTypes; } public function hasAnchorsInTheMiddle() : bool { return $this->anchorsInTheMiddle; } public function areAllErrorsIgnored() : bool { return $this->allErrorsIgnored; } public function getWrongSequence() : ?string { return $this->wrongSequence; } public function getEscapedWrongSequence() : ?string { return $this->escapedWrongSequence; } } <?php declare (strict_types=1); namespace PHPStan\Command; use PHPStan\Analyser\Error; use PHPStan\Analyser\InternalError; use PHPStan\Collectors\CollectedData; use function array_map; use function count; use function usort; /** * @api * @final */ class AnalysisResult { /** * @var list<string> */ private $notFileSpecificErrors; /** * @var list<InternalError> */ private $internalErrors; /** * @var list<string> */ private $warnings; /** * @var list<CollectedData> */ private $collectedData; /** * @var bool */ private $defaultLevelUsed; /** * @var ?string */ private $projectConfigFile; /** * @var bool */ private $savedResultCache; /** * @var int */ private $peakMemoryUsageBytes; /** * @var bool */ private $isResultCacheUsed; /** * @var array<string, string> */ private $changedProjectExtensionFilesOutsideOfAnalysedPaths; /** @var list<Error> sorted by their file name, line number and message */ private $fileSpecificErrors; /** * @param list<Error> $fileSpecificErrors * @param list<string> $notFileSpecificErrors * @param list<InternalError> $internalErrors * @param list<string> $warnings * @param list<CollectedData> $collectedData * @param array<string, string> $changedProjectExtensionFilesOutsideOfAnalysedPaths */ public function __construct(array $fileSpecificErrors, array $notFileSpecificErrors, array $internalErrors, array $warnings, array $collectedData, bool $defaultLevelUsed, ?string $projectConfigFile, bool $savedResultCache, int $peakMemoryUsageBytes, bool $isResultCacheUsed, array $changedProjectExtensionFilesOutsideOfAnalysedPaths) { $this->notFileSpecificErrors = $notFileSpecificErrors; $this->internalErrors = $internalErrors; $this->warnings = $warnings; $this->collectedData = $collectedData; $this->defaultLevelUsed = $defaultLevelUsed; $this->projectConfigFile = $projectConfigFile; $this->savedResultCache = $savedResultCache; $this->peakMemoryUsageBytes = $peakMemoryUsageBytes; $this->isResultCacheUsed = $isResultCacheUsed; $this->changedProjectExtensionFilesOutsideOfAnalysedPaths = $changedProjectExtensionFilesOutsideOfAnalysedPaths; usort($fileSpecificErrors, static function (Error $a, Error $b) : int { return [$a->getFile(), $a->getLine(), $a->getMessage()] <=> [$b->getFile(), $b->getLine(), $b->getMessage()]; }); $this->fileSpecificErrors = $fileSpecificErrors; } public function hasErrors() : bool { return $this->getTotalErrorsCount() > 0; } public function getTotalErrorsCount() : int { return count($this->fileSpecificErrors) + count($this->notFileSpecificErrors); } /** * @return list<Error> sorted by their file name, line number and message */ public function getFileSpecificErrors() : array { return $this->fileSpecificErrors; } /** * @return list<string> */ public function getNotFileSpecificErrors() : array { return $this->notFileSpecificErrors; } /** * @deprecated Use getInternalErrorObjects * @return list<string> */ public function getInternalErrors() : array { return array_map(static function (InternalError $internalError) { return $internalError->getMessage(); }, $this->internalErrors); } /** * @return list<InternalError> */ public function getInternalErrorObjects() : array { return $this->internalErrors; } /** * @return list<string> */ public function getWarnings() : array { return $this->warnings; } public function hasWarnings() : bool { return count($this->warnings) > 0; } /** * @return list<CollectedData> */ public function getCollectedData() : array { return $this->collectedData; } public function isDefaultLevelUsed() : bool { return $this->defaultLevelUsed; } public function getProjectConfigFile() : ?string { return $this->projectConfigFile; } public function hasInternalErrors() : bool { return count($this->internalErrors) > 0; } public function isResultCacheSaved() : bool { return $this->savedResultCache; } public function getPeakMemoryUsageBytes() : int { return $this->peakMemoryUsageBytes; } public function isResultCacheUsed() : bool { return $this->isResultCacheUsed; } /** * @return array<string, string> */ public function getChangedProjectExtensionFilesOutsideOfAnalysedPaths() : array { return $this->changedProjectExtensionFilesOutsideOfAnalysedPaths; } } <?php declare (strict_types=1); namespace PHPStan\Command; use _PHPStan_7d8742a37\Clue\React\NDJson\Encoder; use PHPStan\Analyser\AnalyserResult; use PHPStan\Analyser\AnalyserResultFinalizer; use PHPStan\Analyser\Error; use PHPStan\Analyser\Ignore\IgnoredErrorHelper; use PHPStan\Analyser\Ignore\IgnoredErrorHelperResult; use PHPStan\Analyser\InternalError; use PHPStan\Analyser\ResultCache\ResultCacheManager; use PHPStan\Analyser\ResultCache\ResultCacheManagerFactory; use PHPStan\DependencyInjection\Container; use PHPStan\File\PathNotFoundException; use PHPStan\Parallel\ParallelAnalyser; use PHPStan\Parallel\Scheduler; use PHPStan\Process\CpuCoreCounter; use PHPStan\ShouldNotHappenException; use _PHPStan_7d8742a37\React\EventLoop\LoopInterface; use _PHPStan_7d8742a37\React\EventLoop\StreamSelectLoop; use _PHPStan_7d8742a37\React\Promise\PromiseInterface; use _PHPStan_7d8742a37\React\Socket\ConnectionInterface; use _PHPStan_7d8742a37\React\Socket\TcpConnector; use _PHPStan_7d8742a37\Symfony\Component\Console\Command\Command; use _PHPStan_7d8742a37\Symfony\Component\Console\Input\InputArgument; use _PHPStan_7d8742a37\Symfony\Component\Console\Input\InputInterface; use _PHPStan_7d8742a37\Symfony\Component\Console\Input\InputOption; use _PHPStan_7d8742a37\Symfony\Component\Console\Output\OutputInterface; use function array_diff; use function array_key_exists; use function count; use function filemtime; use function in_array; use function is_array; use function is_bool; use function is_file; use function is_string; use function memory_get_peak_usage; use function _PHPStan_7d8742a37\React\Promise\resolve; use function sprintf; use function usort; use const JSON_INVALID_UTF8_IGNORE; final class FixerWorkerCommand extends Command { /** * @var string[] */ private $composerAutoloaderProjectPaths; private const NAME = 'fixer:worker'; /** * @param string[] $composerAutoloaderProjectPaths */ public function __construct(array $composerAutoloaderProjectPaths) { $this->composerAutoloaderProjectPaths = $composerAutoloaderProjectPaths; parent::__construct(); } protected function configure() : void { $this->setName(self::NAME)->setDescription('(Internal) Support for PHPStan Pro.')->setDefinition([new InputArgument('paths', InputArgument::OPTIONAL | InputArgument::IS_ARRAY, 'Paths with source code to run analysis on'), new InputOption('configuration', 'c', InputOption::VALUE_REQUIRED, 'Path to project configuration file'), new InputOption(\PHPStan\Command\AnalyseCommand::OPTION_LEVEL, 'l', InputOption::VALUE_REQUIRED, 'Level of rule options - the higher the stricter'), new InputOption('autoload-file', 'a', InputOption::VALUE_REQUIRED, 'Project\'s additional autoload file path'), new InputOption('memory-limit', null, InputOption::VALUE_REQUIRED, 'Memory limit for analysis'), new InputOption('xdebug', null, InputOption::VALUE_NONE, 'Allow running with Xdebug for debugging purposes'), new InputOption('server-port', null, InputOption::VALUE_REQUIRED, 'Server port for FixerApplication')])->setHidden(\true); } protected function execute(InputInterface $input, OutputInterface $output) : int { $paths = $input->getArgument('paths'); $memoryLimit = $input->getOption('memory-limit'); $autoloadFile = $input->getOption('autoload-file'); $configuration = $input->getOption('configuration'); $level = $input->getOption(\PHPStan\Command\AnalyseCommand::OPTION_LEVEL); $allowXdebug = $input->getOption('xdebug'); $serverPort = $input->getOption('server-port'); if (!is_array($paths) || !is_string($memoryLimit) && $memoryLimit !== null || !is_string($autoloadFile) && $autoloadFile !== null || !is_string($configuration) && $configuration !== null || !is_string($level) && $level !== null || !is_bool($allowXdebug) || !is_string($serverPort)) { throw new ShouldNotHappenException(); } try { $inceptionResult = \PHPStan\Command\CommandHelper::begin($input, $output, $paths, $memoryLimit, $autoloadFile, $this->composerAutoloaderProjectPaths, $configuration, null, $level, $allowXdebug, \false, \false); } catch (\PHPStan\Command\InceptionNotSuccessfulException $e) { return 1; } $container = $inceptionResult->getContainer(); /** @var IgnoredErrorHelper $ignoredErrorHelper */ $ignoredErrorHelper = $container->getByType(IgnoredErrorHelper::class); $ignoredErrorHelperResult = $ignoredErrorHelper->initialize(); if (count($ignoredErrorHelperResult->getErrors()) > 0) { throw new ShouldNotHappenException(); } $loop = new StreamSelectLoop(); $tcpConnector = new TcpConnector($loop); $tcpConnector->connect(sprintf('127.0.0.1:%d', $serverPort))->then(function (ConnectionInterface $connection) use($container, $inceptionResult, $configuration, $input, $ignoredErrorHelperResult, $loop) : void { // phpcs:disable SlevomatCodingStandard.Namespaces.ReferenceUsedNamesOnly $jsonInvalidUtf8Ignore = \defined('JSON_INVALID_UTF8_IGNORE') ? JSON_INVALID_UTF8_IGNORE : 0; // phpcs:enable $out = new Encoder($connection, $jsonInvalidUtf8Ignore); //$in = new Decoder($connection, true, 512, $jsonInvalidUtf8Ignore, 128 * 1024 * 1024); /** @var ResultCacheManager $resultCacheManager */ $resultCacheManager = $container->getByType(ResultCacheManagerFactory::class)->create(); $projectConfigArray = $inceptionResult->getProjectConfigArray(); /** @var AnalyserResultFinalizer $analyserResultFinalizer */ $analyserResultFinalizer = $container->getByType(AnalyserResultFinalizer::class); try { [$inceptionFiles, $isOnlyFiles] = $inceptionResult->getFiles(); } catch (PathNotFoundException|\PHPStan\Command\InceptionNotSuccessfulException $e) { throw new ShouldNotHappenException(); } $out->write(['action' => 'analysisStart', 'result' => ['analysedFiles' => $inceptionFiles]]); $resultCache = $resultCacheManager->restore($inceptionFiles, \false, \false, $projectConfigArray, $inceptionResult->getErrorOutput()); $errorsFromResultCacheTmp = $resultCache->getErrors(); $locallyIgnoredErrorsFromResultCacheTmp = $resultCache->getLocallyIgnoredErrors(); foreach ($resultCache->getFilesToAnalyse() as $fileToAnalyse) { unset($errorsFromResultCacheTmp[$fileToAnalyse]); unset($locallyIgnoredErrorsFromResultCacheTmp[$fileToAnalyse]); } $errorsFromResultCache = []; foreach ($errorsFromResultCacheTmp as $errorsByFile) { foreach ($errorsByFile as $error) { $errorsFromResultCache[] = $error; } } [$errorsFromResultCache, $ignoredErrorsFromResultCache] = $this->filterErrors($errorsFromResultCache, $ignoredErrorHelperResult, $isOnlyFiles, $inceptionFiles, \false); foreach ($locallyIgnoredErrorsFromResultCacheTmp as $locallyIgnoredErrors) { foreach ($locallyIgnoredErrors as $locallyIgnoredError) { $ignoredErrorsFromResultCache[] = [$locallyIgnoredError, null]; } } $out->write(['action' => 'analysisStream', 'result' => ['errors' => $errorsFromResultCache, 'ignoredErrors' => $ignoredErrorsFromResultCache, 'analysedFiles' => array_diff($inceptionFiles, $resultCache->getFilesToAnalyse())]]); $filesToAnalyse = $resultCache->getFilesToAnalyse(); usort($filesToAnalyse, static function (string $a, string $b) : int { $aTime = @filemtime($a); if ($aTime === \false) { return 1; } $bTime = @filemtime($b); if ($bTime === \false) { return -1; } // files are sorted from the oldest // because ParallelAnalyser reverses the scheduler jobs to do the smallest // jobs first return $aTime <=> $bTime; }); $this->runAnalyser($loop, $container, $filesToAnalyse, $configuration, $input, function (array $errors, array $locallyIgnoredErrors, array $analysedFiles) use($out, $ignoredErrorHelperResult, $isOnlyFiles, $inceptionFiles) : void { $internalErrors = []; foreach ($errors as $fileSpecificError) { if (!$fileSpecificError->hasNonIgnorableException()) { continue; } $internalErrors[] = $this->transformErrorIntoInternalError($fileSpecificError); } if (count($internalErrors) > 0) { $out->write(['action' => 'analysisCrash', 'data' => ['internalErrors' => $internalErrors]]); return; } [$errors, $ignoredErrors] = $this->filterErrors($errors, $ignoredErrorHelperResult, $isOnlyFiles, $inceptionFiles, \false); foreach ($locallyIgnoredErrors as $locallyIgnoredError) { $ignoredErrors[] = [$locallyIgnoredError, null]; } $out->write(['action' => 'analysisStream', 'result' => ['errors' => $errors, 'ignoredErrors' => $ignoredErrors, 'analysedFiles' => $analysedFiles]]); })->then(function (AnalyserResult $intermediateAnalyserResult) use($analyserResultFinalizer, $resultCacheManager, $resultCache, $inceptionResult, $isOnlyFiles, $ignoredErrorHelperResult, $inceptionFiles, $out) : void { $analyserResult = $resultCacheManager->process($intermediateAnalyserResult, $resultCache, $inceptionResult->getErrorOutput(), \false, \true)->getAnalyserResult(); $finalizerResult = $analyserResultFinalizer->finalize($analyserResult, $isOnlyFiles, \false); $internalErrors = []; foreach ($finalizerResult->getAnalyserResult()->getInternalErrors() as $internalError) { $internalErrors[] = new InternalError($internalError->getTraceAsString() !== null ? sprintf('Internal error: %s', $internalError->getMessage()) : $internalError->getMessage(), $internalError->getContextDescription(), $internalError->getTrace(), $internalError->getTraceAsString(), $internalError->shouldReportBug()); } foreach ($finalizerResult->getAnalyserResult()->getUnorderedErrors() as $fileSpecificError) { if (!$fileSpecificError->hasNonIgnorableException()) { continue; } $internalErrors[] = $this->transformErrorIntoInternalError($fileSpecificError); } $hasInternalErrors = count($internalErrors) > 0 || $finalizerResult->getAnalyserResult()->hasReachedInternalErrorsCountLimit(); if ($hasInternalErrors) { $out->write(['action' => 'analysisCrash', 'data' => ['internalErrors' => count($internalErrors) > 0 ? $internalErrors : [new InternalError('Internal error occurred', 'running analyser in PHPStan Pro worker', [], null, \false)]]]); } [$collectorErrors, $ignoredCollectorErrors] = $this->filterErrors($finalizerResult->getCollectorErrors(), $ignoredErrorHelperResult, $isOnlyFiles, $inceptionFiles, $hasInternalErrors); foreach ($finalizerResult->getLocallyIgnoredCollectorErrors() as $locallyIgnoredCollectorError) { $ignoredCollectorErrors[] = [$locallyIgnoredCollectorError, null]; } $out->write(['action' => 'analysisStream', 'result' => ['errors' => $collectorErrors, 'ignoredErrors' => $ignoredCollectorErrors, 'analysedFiles' => []]]); $ignoredErrorHelperProcessedResult = $ignoredErrorHelperResult->process($finalizerResult->getErrors(), $isOnlyFiles, $inceptionFiles, $hasInternalErrors); $ignoreFileErrors = []; foreach ($ignoredErrorHelperProcessedResult->getNotIgnoredErrors() as $error) { if ($error->getIdentifier() === null) { continue; } if (!in_array($error->getIdentifier(), ['ignore.count', 'ignore.unmatched', 'ignore.unmatchedLine', 'ignore.unmatchedIdentifier'], \true)) { continue; } $ignoreFileErrors[] = $error; } $out->end(['action' => 'analysisEnd', 'result' => ['ignoreFileErrors' => $ignoreFileErrors, 'ignoreNotFileErrors' => $ignoredErrorHelperProcessedResult->getOtherIgnoreMessages()]]); }); }); $loop->run(); return 0; } private function transformErrorIntoInternalError(Error $error) : InternalError { $message = $error->getMessage(); $metadata = $error->getMetadata(); if ($error->getIdentifier() === 'phpstan.internal' && array_key_exists(InternalError::STACK_TRACE_AS_STRING_METADATA_KEY, $metadata)) { $message = sprintf('Internal error: %s', $message); } return new InternalError($message, sprintf('analysing file %s', $error->getTraitFilePath() ?? $error->getFilePath()), $metadata[InternalError::STACK_TRACE_METADATA_KEY] ?? [], $metadata[InternalError::STACK_TRACE_AS_STRING_METADATA_KEY] ?? null, \true); } /** * @param string[] $inceptionFiles * @param array<Error> $errors * @return array{list<Error>, list<array{Error, mixed[]|string}>} */ private function filterErrors(array $errors, IgnoredErrorHelperResult $ignoredErrorHelperResult, bool $onlyFiles, array $inceptionFiles, bool $hasInternalErrors) : array { $ignoredErrorHelperProcessedResult = $ignoredErrorHelperResult->process($errors, $onlyFiles, $inceptionFiles, $hasInternalErrors); $finalErrors = []; foreach ($ignoredErrorHelperProcessedResult->getNotIgnoredErrors() as $error) { if ($error->getIdentifier() === null) { $finalErrors[] = $error; continue; } if (in_array($error->getIdentifier(), ['ignore.count', 'ignore.unmatched'], \true)) { continue; } $finalErrors[] = $error; } return [$finalErrors, $ignoredErrorHelperProcessedResult->getIgnoredErrors()]; } /** * @param string[] $files * @param callable(list<Error>, list<Error>, string[]): void $onFileAnalysisHandler * @return PromiseInterface<AnalyserResult> */ private function runAnalyser(LoopInterface $loop, Container $container, array $files, ?string $configuration, InputInterface $input, callable $onFileAnalysisHandler) : PromiseInterface { /** @var ParallelAnalyser $parallelAnalyser */ $parallelAnalyser = $container->getByType(ParallelAnalyser::class); $filesCount = count($files); if ($filesCount === 0) { return resolve(new AnalyserResult([], [], [], [], [], [], [], [], [], [], \false, memory_get_peak_usage(\true))); } /** @var Scheduler $scheduler */ $scheduler = $container->getByType(Scheduler::class); /** @var CpuCoreCounter $cpuCoreCounter */ $cpuCoreCounter = $container->getByType(CpuCoreCounter::class); $schedule = $scheduler->scheduleWork($cpuCoreCounter->getNumberOfCpuCores(), $files); $mainScript = null; if (isset($_SERVER['argv'][0]) && is_file($_SERVER['argv'][0])) { $mainScript = $_SERVER['argv'][0]; } return $parallelAnalyser->analyse($loop, $schedule, $mainScript, null, $configuration, $input, $onFileAnalysisHandler); } } <?php declare (strict_types=1); namespace PHPStan\Command; use _PHPStan_7d8742a37\Nette\Neon\Neon; use _PHPStan_7d8742a37\Nette\Utils\Json; use PHPStan\ShouldNotHappenException; use _PHPStan_7d8742a37\Symfony\Component\Console\Command\Command; use _PHPStan_7d8742a37\Symfony\Component\Console\Input\InputInterface; use _PHPStan_7d8742a37\Symfony\Component\Console\Input\InputOption; use _PHPStan_7d8742a37\Symfony\Component\Console\Output\OutputInterface; use function is_string; final class DumpParametersCommand extends Command { /** * @var string[] */ private $composerAutoloaderProjectPaths; private const NAME = 'dump-parameters'; /** * @param string[] $composerAutoloaderProjectPaths */ public function __construct(array $composerAutoloaderProjectPaths) { $this->composerAutoloaderProjectPaths = $composerAutoloaderProjectPaths; parent::__construct(); } protected function configure() : void { $this->setName(self::NAME)->setDescription('Dumps all parameters')->setDefinition([new InputOption('configuration', 'c', InputOption::VALUE_REQUIRED, 'Path to project configuration file'), new InputOption(\PHPStan\Command\AnalyseCommand::OPTION_LEVEL, 'l', InputOption::VALUE_REQUIRED, 'Level of rule options - the higher the stricter'), new InputOption('autoload-file', 'a', InputOption::VALUE_REQUIRED, 'Project\'s additional autoload file path'), new InputOption('debug', null, InputOption::VALUE_NONE, 'Show debug information - which file is analysed, do not catch internal errors'), new InputOption('memory-limit', null, InputOption::VALUE_REQUIRED, 'Memory limit for clearing result cache'), new InputOption('json', null, InputOption::VALUE_NONE, 'Dump parameters as JSON instead of NEON')]); } protected function initialize(InputInterface $input, OutputInterface $output) : void { if ((bool) $input->getOption('debug')) { $application = $this->getApplication(); if ($application === null) { throw new ShouldNotHappenException(); } $application->setCatchExceptions(\false); return; } } protected function execute(InputInterface $input, OutputInterface $output) : int { $memoryLimit = $input->getOption('memory-limit'); $autoloadFile = $input->getOption('autoload-file'); $configuration = $input->getOption('configuration'); $level = $input->getOption(\PHPStan\Command\AnalyseCommand::OPTION_LEVEL); $json = (bool) $input->getOption('json'); if (!is_string($memoryLimit) && $memoryLimit !== null || !is_string($autoloadFile) && $autoloadFile !== null || !is_string($configuration) && $configuration !== null || !is_string($level) && $level !== null) { throw new ShouldNotHappenException(); } try { $inceptionResult = \PHPStan\Command\CommandHelper::begin($input, $output, [], $memoryLimit, $autoloadFile, $this->composerAutoloaderProjectPaths, $configuration, null, $level, \false); } catch (\PHPStan\Command\InceptionNotSuccessfulException $e) { return 1; } $parameters = $inceptionResult->getContainer()->getParameters(); // always set to '.' unset($parameters['analysedPaths']); // irrelevant Nette parameters unset($parameters['debugMode']); unset($parameters['productionMode']); unset($parameters['tempDir']); unset($parameters['__validate']); if ($json) { $encoded = Json::encode($parameters, Json::PRETTY); } else { $encoded = Neon::encode($parameters, \true); } $output->writeln($encoded); return 0; } } <?php declare (strict_types=1); namespace PHPStan\Command; use _PHPStan_7d8742a37\Clue\React\NDJson\Decoder; use _PHPStan_7d8742a37\Clue\React\NDJson\Encoder; use PHPStan\Analyser\FileAnalyser; use PHPStan\Analyser\InternalError; use PHPStan\Analyser\NodeScopeResolver; use PHPStan\Collectors\Registry as CollectorRegistry; use PHPStan\DependencyInjection\Container; use PHPStan\File\PathNotFoundException; use PHPStan\Rules\Registry as RuleRegistry; use PHPStan\ShouldNotHappenException; use _PHPStan_7d8742a37\React\EventLoop\StreamSelectLoop; use _PHPStan_7d8742a37\React\Socket\ConnectionInterface; use _PHPStan_7d8742a37\React\Socket\TcpConnector; use _PHPStan_7d8742a37\React\Stream\ReadableStreamInterface; use _PHPStan_7d8742a37\React\Stream\WritableStreamInterface; use _PHPStan_7d8742a37\Symfony\Component\Console\Command\Command; use _PHPStan_7d8742a37\Symfony\Component\Console\Input\InputArgument; use _PHPStan_7d8742a37\Symfony\Component\Console\Input\InputInterface; use _PHPStan_7d8742a37\Symfony\Component\Console\Input\InputOption; use _PHPStan_7d8742a37\Symfony\Component\Console\Output\OutputInterface; use Throwable; use function array_fill_keys; use function array_merge; use function defined; use function is_array; use function is_bool; use function is_string; use function memory_get_peak_usage; use function sprintf; final class WorkerCommand extends Command { /** * @var string[] */ private $composerAutoloaderProjectPaths; private const NAME = 'worker'; /** * @var int */ private $errorCount = 0; /** * @param string[] $composerAutoloaderProjectPaths */ public function __construct(array $composerAutoloaderProjectPaths) { $this->composerAutoloaderProjectPaths = $composerAutoloaderProjectPaths; parent::__construct(); } protected function configure() : void { $this->setName(self::NAME)->setDescription('(Internal) Support for parallel analysis.')->setDefinition([new InputArgument('paths', InputArgument::OPTIONAL | InputArgument::IS_ARRAY, 'Paths with source code to run analysis on'), new InputOption('configuration', 'c', InputOption::VALUE_REQUIRED, 'Path to project configuration file'), new InputOption(\PHPStan\Command\AnalyseCommand::OPTION_LEVEL, 'l', InputOption::VALUE_REQUIRED, 'Level of rule options - the higher the stricter'), new InputOption('autoload-file', 'a', InputOption::VALUE_REQUIRED, 'Project\'s additional autoload file path'), new InputOption('memory-limit', null, InputOption::VALUE_REQUIRED, 'Memory limit for analysis'), new InputOption('xdebug', null, InputOption::VALUE_NONE, 'Allow running with Xdebug for debugging purposes'), new InputOption('port', null, InputOption::VALUE_REQUIRED), new InputOption('identifier', null, InputOption::VALUE_REQUIRED)])->setHidden(\true); } protected function execute(InputInterface $input, OutputInterface $output) : int { $paths = $input->getArgument('paths'); $memoryLimit = $input->getOption('memory-limit'); $autoloadFile = $input->getOption('autoload-file'); $configuration = $input->getOption('configuration'); $level = $input->getOption(\PHPStan\Command\AnalyseCommand::OPTION_LEVEL); $allowXdebug = $input->getOption('xdebug'); $port = $input->getOption('port'); $identifier = $input->getOption('identifier'); if (!is_array($paths) || !is_string($memoryLimit) && $memoryLimit !== null || !is_string($autoloadFile) && $autoloadFile !== null || !is_string($configuration) && $configuration !== null || !is_string($level) && $level !== null || !is_bool($allowXdebug) || !is_string($port) || !is_string($identifier)) { throw new ShouldNotHappenException(); } try { $inceptionResult = \PHPStan\Command\CommandHelper::begin($input, $output, $paths, $memoryLimit, $autoloadFile, $this->composerAutoloaderProjectPaths, $configuration, null, $level, $allowXdebug, \false, \false); } catch (\PHPStan\Command\InceptionNotSuccessfulException $e) { return 1; } $loop = new StreamSelectLoop(); $container = $inceptionResult->getContainer(); try { [$analysedFiles] = $inceptionResult->getFiles(); } catch (PathNotFoundException $e) { $inceptionResult->getErrorOutput()->writeLineFormatted(sprintf('<error>%s</error>', $e->getMessage())); return 1; } catch (\PHPStan\Command\InceptionNotSuccessfulException $e) { return 1; } $nodeScopeResolver = $container->getByType(NodeScopeResolver::class); $nodeScopeResolver->setAnalysedFiles($analysedFiles); $analysedFiles = array_fill_keys($analysedFiles, \true); $tcpConnector = new TcpConnector($loop); $tcpConnector->connect(sprintf('127.0.0.1:%d', $port))->then(function (ConnectionInterface $connection) use($container, $identifier, $output, $analysedFiles) : void { // phpcs:disable SlevomatCodingStandard.Namespaces.ReferenceUsedNamesOnly $jsonInvalidUtf8Ignore = defined('JSON_INVALID_UTF8_IGNORE') ? \JSON_INVALID_UTF8_IGNORE : 0; // phpcs:enable $out = new Encoder($connection, $jsonInvalidUtf8Ignore); $in = new Decoder($connection, \true, 512, $jsonInvalidUtf8Ignore, $container->getParameter('parallel')['buffer']); $out->write(['action' => 'hello', 'identifier' => $identifier]); $this->runWorker($container, $out, $in, $output, $analysedFiles); }); $loop->run(); if ($this->errorCount > 0) { return 1; } return 0; } /** * @param array<string, true> $analysedFiles */ private function runWorker(Container $container, WritableStreamInterface $out, ReadableStreamInterface $in, OutputInterface $output, array $analysedFiles) : void { $handleError = function (Throwable $error) use($out, $output) : void { $this->errorCount++; $output->writeln(sprintf('Error: %s', $error->getMessage())); $out->write(['action' => 'result', 'result' => ['errors' => [], 'internalErrors' => [new InternalError($error->getMessage(), 'communicating with main process in parallel worker', InternalError::prepareTrace($error), $error->getTraceAsString(), \true)], 'filteredPhpErrors' => [], 'allPhpErrors' => [], 'locallyIgnoredErrors' => [], 'linesToIgnore' => [], 'unmatchedLineIgnores' => [], 'collectedData' => [], 'memoryUsage' => memory_get_peak_usage(\true), 'dependencies' => [], 'exportedNodes' => [], 'files' => [], 'internalErrorsCount' => 1]]); $out->end(); }; $out->on('error', $handleError); $fileAnalyser = $container->getByType(FileAnalyser::class); $ruleRegistry = $container->getByType(RuleRegistry::class); $collectorRegistry = $container->getByType(CollectorRegistry::class); $in->on('data', static function (array $json) use($fileAnalyser, $ruleRegistry, $collectorRegistry, $out, $analysedFiles) : void { $action = $json['action']; if ($action !== 'analyse') { return; } $internalErrorsCount = 0; $files = $json['files']; $errors = []; $internalErrors = []; $filteredPhpErrors = []; $allPhpErrors = []; $locallyIgnoredErrors = []; $linesToIgnore = []; $unmatchedLineIgnores = []; $collectedData = []; $dependencies = []; $exportedNodes = []; foreach ($files as $file) { try { $fileAnalyserResult = $fileAnalyser->analyseFile($file, $analysedFiles, $ruleRegistry, $collectorRegistry, null); $fileErrors = $fileAnalyserResult->getErrors(); $filteredPhpErrors = array_merge($filteredPhpErrors, $fileAnalyserResult->getFilteredPhpErrors()); $allPhpErrors = array_merge($allPhpErrors, $fileAnalyserResult->getAllPhpErrors()); $linesToIgnore[$file] = $fileAnalyserResult->getLinesToIgnore(); $unmatchedLineIgnores[$file] = $fileAnalyserResult->getUnmatchedLineIgnores(); $dependencies[$file] = $fileAnalyserResult->getDependencies(); $exportedNodes[$file] = $fileAnalyserResult->getExportedNodes(); foreach ($fileErrors as $fileError) { $errors[] = $fileError; } foreach ($fileAnalyserResult->getLocallyIgnoredErrors() as $locallyIgnoredError) { $locallyIgnoredErrors[] = $locallyIgnoredError; } foreach ($fileAnalyserResult->getCollectedData() as $data) { $collectedData[] = $data; } } catch (Throwable $t) { $internalErrorsCount++; $internalErrors[] = new InternalError($t->getMessage(), sprintf('analysing file %s', $file), InternalError::prepareTrace($t), $t->getTraceAsString(), \true); } } $out->write(['action' => 'result', 'result' => ['errors' => $errors, 'internalErrors' => $internalErrors, 'filteredPhpErrors' => $filteredPhpErrors, 'allPhpErrors' => $allPhpErrors, 'locallyIgnoredErrors' => $locallyIgnoredErrors, 'linesToIgnore' => $linesToIgnore, 'unmatchedLineIgnores' => $unmatchedLineIgnores, 'collectedData' => $collectedData, 'memoryUsage' => memory_get_peak_usage(\true), 'dependencies' => $dependencies, 'exportedNodes' => $exportedNodes, 'files' => $files, 'internalErrorsCount' => $internalErrorsCount]]); }); $in->on('error', $handleError); } } <?php declare (strict_types=1); namespace PHPStan\Command; use _PHPStan_7d8742a37\Clue\React\NDJson\Decoder; use _PHPStan_7d8742a37\Clue\React\NDJson\Encoder; use _PHPStan_7d8742a37\Composer\CaBundle\CaBundle; use DateTime; use DateTimeImmutable; use DateTimeZone; use _PHPStan_7d8742a37\Nette\Utils\Json; use Phar; use PHPStan\Analyser\Ignore\IgnoredErrorHelper; use PHPStan\Analyser\InternalError; use PHPStan\File\FileMonitor; use PHPStan\File\FileMonitorResult; use PHPStan\File\FileReader; use PHPStan\File\FileWriter; use PHPStan\Internal\ComposerHelper; use PHPStan\Internal\DirectoryCreator; use PHPStan\Internal\DirectoryCreatorException; use PHPStan\PhpDoc\StubFilesProvider; use PHPStan\Process\ProcessCanceledException; use PHPStan\Process\ProcessCrashedException; use PHPStan\Process\ProcessHelper; use PHPStan\Process\ProcessPromise; use PHPStan\ShouldNotHappenException; use _PHPStan_7d8742a37\Psr\Http\Message\ResponseInterface; use _PHPStan_7d8742a37\React\ChildProcess\Process; use _PHPStan_7d8742a37\React\Dns\Config\Config; use _PHPStan_7d8742a37\React\EventLoop\Loop; use _PHPStan_7d8742a37\React\EventLoop\LoopInterface; use _PHPStan_7d8742a37\React\EventLoop\StreamSelectLoop; use _PHPStan_7d8742a37\React\Http\Browser; use _PHPStan_7d8742a37\React\Promise\PromiseInterface; use _PHPStan_7d8742a37\React\Socket\ConnectionInterface; use _PHPStan_7d8742a37\React\Socket\Connector; use _PHPStan_7d8742a37\React\Socket\TcpServer; use _PHPStan_7d8742a37\React\Stream\ReadableStreamInterface; use RuntimeException; use _PHPStan_7d8742a37\Symfony\Component\Console\Helper\ProgressBar; use _PHPStan_7d8742a37\Symfony\Component\Console\Input\InputInterface; use _PHPStan_7d8742a37\Symfony\Component\Console\Output\OutputInterface; use Throwable; use function array_merge; use function count; use function defined; use function escapeshellarg; use function fclose; use function fopen; use function fwrite; use function get_class; use function getenv; use function http_build_query; use function ini_get; use function is_file; use function parse_url; use function _PHPStan_7d8742a37\React\Async\await; use function sprintf; use function strlen; use function unlink; use const JSON_INVALID_UTF8_IGNORE; use const PHP_BINARY; use const PHP_URL_PORT; use const PHP_VERSION_ID; final class FixerApplication { /** * @var FileMonitor */ private $fileMonitor; /** * @var IgnoredErrorHelper */ private $ignoredErrorHelper; /** * @var StubFilesProvider */ private $stubFilesProvider; /** * @var string[] */ private $analysedPaths; /** * @var string */ private $currentWorkingDirectory; /** * @var string */ private $proTmpDir; /** * @var list<string> */ private $dnsServers; /** * @var string[] */ private $composerAutoloaderProjectPaths; /** * @var string[] */ private $allConfigFiles; /** * @var ?string */ private $cliAutoloadFile; /** * @var string[] */ private $bootstrapFiles; /** * @var ?string */ private $editorUrl; /** * @var string */ private $usedLevel; /** @var PromiseInterface<string>|null */ private $processInProgress = null; /** * @var bool */ private $fileMonitorActive = \true; /** * @param string[] $analysedPaths * @param list<string> $dnsServers * @param string[] $composerAutoloaderProjectPaths * @param string[] $allConfigFiles * @param string[] $bootstrapFiles */ public function __construct(FileMonitor $fileMonitor, IgnoredErrorHelper $ignoredErrorHelper, StubFilesProvider $stubFilesProvider, array $analysedPaths, string $currentWorkingDirectory, string $proTmpDir, array $dnsServers, array $composerAutoloaderProjectPaths, array $allConfigFiles, ?string $cliAutoloadFile, array $bootstrapFiles, ?string $editorUrl, string $usedLevel) { $this->fileMonitor = $fileMonitor; $this->ignoredErrorHelper = $ignoredErrorHelper; $this->stubFilesProvider = $stubFilesProvider; $this->analysedPaths = $analysedPaths; $this->currentWorkingDirectory = $currentWorkingDirectory; $this->proTmpDir = $proTmpDir; $this->dnsServers = $dnsServers; $this->composerAutoloaderProjectPaths = $composerAutoloaderProjectPaths; $this->allConfigFiles = $allConfigFiles; $this->cliAutoloadFile = $cliAutoloadFile; $this->bootstrapFiles = $bootstrapFiles; $this->editorUrl = $editorUrl; $this->usedLevel = $usedLevel; } public function run(?string $projectConfigFile, InputInterface $input, OutputInterface $output, int $filesCount, string $mainScript) : int { $loop = new StreamSelectLoop(); $server = new TcpServer('127.0.0.1:0', $loop); /** @var string $serverAddress */ $serverAddress = $server->getAddress(); /** @var int<0, 65535> $serverPort */ $serverPort = parse_url($serverAddress, PHP_URL_PORT); $server->on('connection', function (ConnectionInterface $connection) use($loop, $projectConfigFile, $input, $output, $mainScript, $filesCount) : void { // phpcs:disable SlevomatCodingStandard.Namespaces.ReferenceUsedNamesOnly $jsonInvalidUtf8Ignore = defined('JSON_INVALID_UTF8_IGNORE') ? JSON_INVALID_UTF8_IGNORE : 0; // phpcs:enable $decoder = new Decoder($connection, \true, 512, $jsonInvalidUtf8Ignore, 128 * 1024 * 1024); $encoder = new Encoder($connection, $jsonInvalidUtf8Ignore); $encoder->write(['action' => 'initialData', 'data' => ['currentWorkingDirectory' => $this->currentWorkingDirectory, 'analysedPaths' => $this->analysedPaths, 'projectConfigFile' => $projectConfigFile, 'filesCount' => $filesCount, 'phpstanVersion' => ComposerHelper::getPhpStanVersion(), 'editorUrl' => $this->editorUrl, 'ruleLevel' => $this->usedLevel]]); $decoder->on('data', function (array $data) use($output) : void { if ($data['action'] === 'webPort') { $output->writeln(sprintf('Open your web browser at: <fg=cyan>http://127.0.0.1:%d</>', $data['data']['port'])); $output->writeln('Press [Ctrl-C] to quit.'); return; } if ($data['action'] === 'resumeFileMonitor') { $this->fileMonitorActive = \true; return; } if ($data['action'] === 'pauseFileMonitor') { $this->fileMonitorActive = \false; return; } }); $this->fileMonitor->initialize(array_merge($this->analysedPaths, $this->getComposerLocks(), $this->getComposerInstalled(), $this->getExecutedFiles(), $this->getStubFiles(), $this->allConfigFiles)); $this->analyse($loop, $mainScript, $projectConfigFile, $input, $output, $encoder); $this->monitorFileChanges($loop, function (FileMonitorResult $changes) use($loop, $mainScript, $projectConfigFile, $input, $encoder, $output) : void { if ($this->processInProgress !== null) { $this->processInProgress->cancel(); $this->processInProgress = null; } if (count($changes->getChangedFiles()) > 0) { $encoder->write(['action' => 'changedFiles', 'data' => ['paths' => $changes->getChangedFiles()]]); } $this->analyse($loop, $mainScript, $projectConfigFile, $input, $output, $encoder); }); }); try { $fixerProcess = $this->getFixerProcess($output, $serverPort); } catch (\PHPStan\Command\FixerProcessException $e) { return 1; } $fixerProcess->start($loop); $fixerProcess->on('exit', function ($exitCode) use($output, $loop) : void { $loop->stop(); if ($exitCode === null) { return; } if ($exitCode === 0) { return; } $output->writeln(sprintf('<fg=red>PHPStan Pro process exited with code %d.</>', $exitCode)); @unlink($this->proTmpDir . '/phar-info.json'); }); $loop->run(); return 0; } /** * @throws FixerProcessException */ private function getFixerProcess(OutputInterface $output, int $serverPort) : Process { try { DirectoryCreator::ensureDirectoryExists($this->proTmpDir, 0777); } catch (DirectoryCreatorException $e) { $output->writeln($e->getMessage()); throw new \PHPStan\Command\FixerProcessException(); } $pharPath = $this->proTmpDir . '/phpstan-fixer.phar'; $infoPath = $this->proTmpDir . '/phar-info.json'; try { $this->downloadPhar($output, $pharPath, $infoPath); } catch (RuntimeException $e) { if (!is_file($pharPath)) { $this->printDownloadError($output, $e); throw new \PHPStan\Command\FixerProcessException(); } } $pubKeyPath = $pharPath . '.pubkey'; FileWriter::write($pubKeyPath, FileReader::read(__DIR__ . '/fixer-phar.pubkey')); try { $phar = new Phar($pharPath); } catch (Throwable $e) { @unlink($pharPath); @unlink($infoPath); $output->writeln('<fg=red>PHPStan Pro PHAR signature is corrupted.</>'); $output->writeln(sprintf('%s: %s', get_class($e), $e->getMessage())); throw new \PHPStan\Command\FixerProcessException(); } if ($phar->getSignature()['hash_type'] !== 'OpenSSL') { @unlink($pharPath); @unlink($infoPath); $output->writeln('<fg=red>PHPStan Pro PHAR signature is corrupted.</>'); $output->writeln(sprintf('Wrong hash type: %s', $phar->getSignature()['hash_type'])); throw new \PHPStan\Command\FixerProcessException(); } $env = getenv(); $env['PHPSTAN_PRO_TMP_DIR'] = $this->proTmpDir; $forcedPort = $_SERVER['PHPSTAN_PRO_WEB_PORT'] ?? null; if ($forcedPort !== null) { $env['PHPSTAN_PRO_WEB_PORT'] = $_SERVER['PHPSTAN_PRO_WEB_PORT']; $isDocker = $this->isDockerRunning(); if ($isDocker) { $output->writeln('Running in Docker? Don\'t forget to do these steps:'); $output->writeln('1) Publish this port when running Docker:'); $output->writeln(sprintf(' <fg=cyan>-p 127.0.0.1:%d:%d</>', $_SERVER['PHPSTAN_PRO_WEB_PORT'], $_SERVER['PHPSTAN_PRO_WEB_PORT'])); $output->writeln('2) Map the temp directory to a persistent volume'); $output->writeln(' so that you don\'t have to log in every time:'); $output->writeln(sprintf(' <fg=cyan>-v ~/.phpstan-pro:%s</>', $this->proTmpDir)); $output->writeln(''); } } else { $isDocker = $this->isDockerRunning(); if ($isDocker) { $output->writeln('Running in Docker? You need to do these steps in order to launch PHPStan Pro:'); $output->writeln(''); $output->writeln('1) Set the PHPSTAN_PRO_WEB_PORT environment variable in the Dockerfile:'); $output->writeln(' <fg=cyan>ENV PHPSTAN_PRO_WEB_PORT=11111</>'); $output->writeln('2) Expose this port in the Dockerfile:'); $output->writeln(' <fg=cyan>EXPOSE 11111</>'); $output->writeln('3) Publish this port when running Docker:'); $output->writeln(' <fg=cyan>-p 127.0.0.1:11111:11111</>'); $output->writeln('4) Map the temp directory to a persistent volume'); $output->writeln(' so that you don\'t have to log in every time:'); $output->writeln(sprintf(' <fg=cyan>-v ~/phpstan-pro:%s</>', $this->proTmpDir)); $output->writeln(''); } } return new Process(sprintf('%s -d memory_limit=%s %s --port %d', escapeshellarg(PHP_BINARY), escapeshellarg(ini_get('memory_limit')), escapeshellarg($pharPath), $serverPort), null, $env, []); } private function downloadPhar(OutputInterface $output, string $pharPath, string $infoPath) : void { $currentVersion = null; $branch = '1.1.x'; if (is_file($pharPath) && is_file($infoPath)) { /** @var array{version: string, date: string, branch?: string} $currentInfo */ $currentInfo = Json::decode(FileReader::read($infoPath), Json::FORCE_ARRAY); $currentVersion = $currentInfo['version']; $currentBranch = $currentInfo['branch'] ?? 'master'; $currentDate = DateTime::createFromFormat(DateTime::ATOM, $currentInfo['date']); if ($currentDate === \false) { throw new ShouldNotHappenException(); } if ($currentBranch === $branch && new DateTimeImmutable('', new DateTimeZone('UTC')) <= $currentDate->modify('+24 hours')) { return; } $output->writeln('<fg=green>Checking if there\'s a new PHPStan Pro release...</>'); } $dnsConfig = new Config(); $dnsConfig->nameservers = $this->dnsServers; $client = new Browser(new Connector(['timeout' => 5, 'tls' => ['cafile' => CaBundle::getBundledCaBundlePath()], 'dns' => $dnsConfig])); /** * @var array{url: string, version: string} $latestInfo */ $latestInfo = Json::decode((string) await($client->get(sprintf('https://fixer-download-api.phpstan.com/latest?%s', http_build_query(['phpVersion' => PHP_VERSION_ID, 'branch' => $branch]))))->getBody(), Json::FORCE_ARRAY); if ($currentVersion !== null && $latestInfo['version'] === $currentVersion) { $this->writeInfoFile($infoPath, $latestInfo['version'], $branch); $output->writeln('<fg=green>You\'re running the latest PHPStan Pro!</>'); return; } $output->writeln('<fg=green>Downloading the latest PHPStan Pro...</>'); $pharPathResource = fopen($pharPath, 'w'); if ($pharPathResource === \false) { throw new ShouldNotHappenException(sprintf('Could not open file %s for writing.', $pharPath)); } $progressBar = new ProgressBar($output); $client->requestStreaming('GET', $latestInfo['url'])->then(static function (ResponseInterface $response) use($progressBar, $pharPathResource) : void { $body = $response->getBody(); if (!$body instanceof ReadableStreamInterface) { throw new ShouldNotHappenException(); } $totalSize = (int) $response->getHeaderLine('Content-Length'); $progressBar->setFormat('file_download'); $progressBar->setMessage(sprintf('%.2f MB', $totalSize / 1000000), 'fileSize'); $progressBar->start($totalSize); $bytes = 0; $body->on('data', static function ($chunk) use($pharPathResource, $progressBar, &$bytes) : void { $bytes += strlen($chunk); fwrite($pharPathResource, $chunk); $progressBar->setProgress($bytes); }); }, function (Throwable $e) use($output) : void { $this->printDownloadError($output, $e); }); Loop::run(); fclose($pharPathResource); $progressBar->finish(); $output->writeln(''); $output->writeln(''); $this->writeInfoFile($infoPath, $latestInfo['version'], $branch); } private function printDownloadError(OutputInterface $output, Throwable $e) : void { $output->writeln(sprintf('<fg=red>Could not download the PHPStan Pro executable:</> %s', $e->getMessage())); $output->writeln(''); $output->writeln('Try different DNS servers in your configuration file:'); $output->writeln(''); $output->writeln('parameters:'); $output->writeln("\tpro:"); $output->writeln("\t\tdnsServers!:"); $output->writeln("\t\t\t- '8.8.8.8'"); $output->writeln(''); } private function writeInfoFile(string $infoPath, string $version, string $branch) : void { FileWriter::write($infoPath, Json::encode(['version' => $version, 'branch' => $branch, 'date' => (new DateTimeImmutable('', new DateTimeZone('UTC')))->format(DateTime::ATOM)])); } /** * @param callable(FileMonitorResult): void $hasChangesCallback */ private function monitorFileChanges(LoopInterface $loop, callable $hasChangesCallback) : void { $callback = function () use(&$callback, $loop, $hasChangesCallback) : void { if (!$this->fileMonitorActive) { $loop->addTimer(1.0, $callback); return; } if ($this->processInProgress !== null) { $loop->addTimer(1.0, $callback); return; } $changes = $this->fileMonitor->getChanges(); if ($changes->hasAnyChanges()) { $hasChangesCallback($changes); } $loop->addTimer(1.0, $callback); }; $loop->addTimer(1.0, $callback); } private function analyse(LoopInterface $loop, string $mainScript, ?string $projectConfigFile, InputInterface $input, OutputInterface $output, Encoder $phpstanFixerEncoder) : void { $ignoredErrorHelperResult = $this->ignoredErrorHelper->initialize(); if (count($ignoredErrorHelperResult->getErrors()) > 0) { throw new ShouldNotHappenException(); } // TCP server for fixer:worker (TCP client) $server = new TcpServer('127.0.0.1:0', $loop); /** @var string $serverAddress */ $serverAddress = $server->getAddress(); /** @var int<0, 65535> $serverPort */ $serverPort = parse_url($serverAddress, PHP_URL_PORT); $server->on('connection', static function (ConnectionInterface $connection) use($phpstanFixerEncoder) : void { // phpcs:disable SlevomatCodingStandard.Namespaces.ReferenceUsedNamesOnly $jsonInvalidUtf8Ignore = defined('JSON_INVALID_UTF8_IGNORE') ? JSON_INVALID_UTF8_IGNORE : 0; // phpcs:enable $decoder = new Decoder($connection, \true, 512, $jsonInvalidUtf8Ignore, 128 * 1024 * 1024); $decoder->on('data', static function (array $data) use($phpstanFixerEncoder) : void { $phpstanFixerEncoder->write($data); }); }); $process = new ProcessPromise($loop, 'changedFileAnalysis', ProcessHelper::getWorkerCommand($mainScript, 'fixer:worker', $projectConfigFile, ['--server-port', (string) $serverPort], $input)); $this->processInProgress = $process->run(); $this->processInProgress->then(function () use($server) : void { $this->processInProgress = null; $server->close(); }, function (Throwable $e) use($server, $phpstanFixerEncoder) : void { $this->processInProgress = null; $server->close(); if ($e instanceof ProcessCanceledException) { return; } if ($e instanceof ProcessCrashedException) { $message = 'Analysis crashed'; $traceAsString = $e->getMessage(); $trace = []; } else { $message = $e->getMessage(); $traceAsString = $e->getTraceAsString(); $trace = InternalError::prepareTrace($e); } $phpstanFixerEncoder->write(['action' => 'analysisCrash', 'data' => ['internalErrors' => [new InternalError($message, 'running PHPStan Pro worker', $trace, $traceAsString, \false)]]]); }); } private function isDockerRunning() : bool { return is_file('/.dockerenv'); } /** * @return list<string> */ private function getComposerLocks() : array { $locks = []; foreach ($this->composerAutoloaderProjectPaths as $autoloadPath) { $lockPath = $autoloadPath . '/composer.lock'; if (!is_file($lockPath)) { continue; } $locks[] = $lockPath; } return $locks; } /** * @return list<string> */ private function getComposerInstalled() : array { $files = []; foreach ($this->composerAutoloaderProjectPaths as $autoloadPath) { $composer = ComposerHelper::getComposerConfig($autoloadPath); if ($composer === null) { continue; } $filePath = ComposerHelper::getVendorDirFromComposerConfig($autoloadPath, $composer) . '/composer/installed.php'; if (!is_file($filePath)) { continue; } $files[] = $filePath; } return $files; } /** * @return list<string> */ private function getExecutedFiles() : array { $files = []; if ($this->cliAutoloadFile !== null) { $files[] = $this->cliAutoloadFile; } foreach ($this->bootstrapFiles as $bootstrapFile) { $files[] = $bootstrapFile; } return $files; } /** * @return list<string> */ private function getStubFiles() : array { $stubFiles = []; foreach ($this->stubFilesProvider->getProjectStubFiles() as $stubFile) { $stubFiles[] = $stubFile; } return $stubFiles; } } <?php declare (strict_types=1); namespace PHPStan\Command; use Exception; final class FixerProcessException extends Exception { } <?php declare (strict_types=1); namespace PHPStan\Command; use PHPStan\Analyser\AnalyserResult; use PHPStan\Analyser\AnalyserResultFinalizer; use PHPStan\Analyser\Ignore\IgnoredErrorHelper; use PHPStan\Analyser\ResultCache\ResultCacheManagerFactory; use PHPStan\Internal\BytesHelper; use PHPStan\PhpDoc\StubFilesProvider; use PHPStan\PhpDoc\StubValidator; use PHPStan\ShouldNotHappenException; use _PHPStan_7d8742a37\Symfony\Component\Console\Input\InputInterface; use function array_merge; use function count; use function is_file; use function memory_get_peak_usage; use function microtime; use function sha1_file; use function sprintf; final class AnalyseApplication { /** * @var AnalyserRunner */ private $analyserRunner; /** * @var AnalyserResultFinalizer */ private $analyserResultFinalizer; /** * @var StubValidator */ private $stubValidator; /** * @var ResultCacheManagerFactory */ private $resultCacheManagerFactory; /** * @var IgnoredErrorHelper */ private $ignoredErrorHelper; /** * @var StubFilesProvider */ private $stubFilesProvider; public function __construct(\PHPStan\Command\AnalyserRunner $analyserRunner, AnalyserResultFinalizer $analyserResultFinalizer, StubValidator $stubValidator, ResultCacheManagerFactory $resultCacheManagerFactory, IgnoredErrorHelper $ignoredErrorHelper, StubFilesProvider $stubFilesProvider) { $this->analyserRunner = $analyserRunner; $this->analyserResultFinalizer = $analyserResultFinalizer; $this->stubValidator = $stubValidator; $this->resultCacheManagerFactory = $resultCacheManagerFactory; $this->ignoredErrorHelper = $ignoredErrorHelper; $this->stubFilesProvider = $stubFilesProvider; } /** * @param string[] $files * @param mixed[]|null $projectConfigArray */ public function analyse(array $files, bool $onlyFiles, \PHPStan\Command\Output $stdOutput, \PHPStan\Command\Output $errorOutput, bool $defaultLevelUsed, bool $debug, ?string $projectConfigFile, ?array $projectConfigArray, InputInterface $input) : \PHPStan\Command\AnalysisResult { $isResultCacheUsed = \false; $resultCacheManager = $this->resultCacheManagerFactory->create(); $ignoredErrorHelperResult = $this->ignoredErrorHelper->initialize(); $fileSpecificErrors = []; if (count($ignoredErrorHelperResult->getErrors()) > 0) { $notFileSpecificErrors = $ignoredErrorHelperResult->getErrors(); $internalErrors = []; $collectedData = []; $savedResultCache = \false; $memoryUsageBytes = memory_get_peak_usage(\true); if ($errorOutput->isVeryVerbose()) { $errorOutput->writeLineFormatted('Result cache was not saved because of ignoredErrorHelperResult errors.'); } $changedProjectExtensionFilesOutsideOfAnalysedPaths = []; } else { $resultCache = $resultCacheManager->restore($files, $debug, $onlyFiles, $projectConfigArray, $errorOutput); $intermediateAnalyserResult = $this->runAnalyser($resultCache->getFilesToAnalyse(), $files, $debug, $projectConfigFile, $stdOutput, $errorOutput, $input); $projectStubFiles = $this->stubFilesProvider->getProjectStubFiles(); $forceValidateStubFiles = (bool) ($_SERVER['__PHPSTAN_FORCE_VALIDATE_STUB_FILES'] ?? \false); if ($resultCache->isFullAnalysis() && count($projectStubFiles) !== 0 && (!$onlyFiles || $forceValidateStubFiles)) { $stubErrors = $this->stubValidator->validate($projectStubFiles, $debug); $intermediateAnalyserResult = new AnalyserResult(array_merge($intermediateAnalyserResult->getUnorderedErrors(), $stubErrors), $intermediateAnalyserResult->getFilteredPhpErrors(), $intermediateAnalyserResult->getAllPhpErrors(), $intermediateAnalyserResult->getLocallyIgnoredErrors(), $intermediateAnalyserResult->getLinesToIgnore(), $intermediateAnalyserResult->getUnmatchedLineIgnores(), $intermediateAnalyserResult->getInternalErrors(), $intermediateAnalyserResult->getCollectedData(), $intermediateAnalyserResult->getDependencies(), $intermediateAnalyserResult->getExportedNodes(), $intermediateAnalyserResult->hasReachedInternalErrorsCountLimit(), $intermediateAnalyserResult->getPeakMemoryUsageBytes()); } $resultCacheResult = $resultCacheManager->process($intermediateAnalyserResult, $resultCache, $errorOutput, $onlyFiles, \true); $analyserResult = $this->analyserResultFinalizer->finalize($resultCacheResult->getAnalyserResult(), $onlyFiles, $debug)->getAnalyserResult(); $internalErrors = $analyserResult->getInternalErrors(); $errors = array_merge($analyserResult->getErrors(), $analyserResult->getFilteredPhpErrors()); $hasInternalErrors = count($internalErrors) > 0 || $analyserResult->hasReachedInternalErrorsCountLimit(); $memoryUsageBytes = $analyserResult->getPeakMemoryUsageBytes(); $isResultCacheUsed = !$resultCache->isFullAnalysis(); $changedProjectExtensionFilesOutsideOfAnalysedPaths = []; if ($isResultCacheUsed && $resultCacheResult->isSaved() && !$onlyFiles && $projectConfigArray !== null) { foreach ($resultCache->getProjectExtensionFiles() as $file => [$hash, $isAnalysed, $className]) { if ($isAnalysed) { continue; } if (!is_file($file)) { $changedProjectExtensionFilesOutsideOfAnalysedPaths[$file] = $className; continue; } $newHash = sha1_file($file); if ($newHash === $hash) { continue; } $changedProjectExtensionFilesOutsideOfAnalysedPaths[$file] = $className; } } $ignoredErrorHelperProcessedResult = $ignoredErrorHelperResult->process($errors, $onlyFiles, $files, $hasInternalErrors); $fileSpecificErrors = $ignoredErrorHelperProcessedResult->getNotIgnoredErrors(); $notFileSpecificErrors = $ignoredErrorHelperProcessedResult->getOtherIgnoreMessages(); $collectedData = $analyserResult->getCollectedData(); $savedResultCache = $resultCacheResult->isSaved(); } return new \PHPStan\Command\AnalysisResult($fileSpecificErrors, $notFileSpecificErrors, $internalErrors, [], $collectedData, $defaultLevelUsed, $projectConfigFile, $savedResultCache, $memoryUsageBytes, $isResultCacheUsed, $changedProjectExtensionFilesOutsideOfAnalysedPaths); } /** * @param string[] $files * @param string[] $allAnalysedFiles */ private function runAnalyser(array $files, array $allAnalysedFiles, bool $debug, ?string $projectConfigFile, \PHPStan\Command\Output $stdOutput, \PHPStan\Command\Output $errorOutput, InputInterface $input) : AnalyserResult { $filesCount = count($files); $allAnalysedFilesCount = count($allAnalysedFiles); if ($filesCount === 0) { $errorOutput->getStyle()->progressStart($allAnalysedFilesCount); $errorOutput->getStyle()->progressAdvance($allAnalysedFilesCount); $errorOutput->getStyle()->progressFinish(); return new AnalyserResult([], [], [], [], [], [], [], [], [], [], \false, memory_get_peak_usage(\true)); } if (!$debug) { $preFileCallback = null; $postFileCallback = static function (int $step) use($errorOutput) : void { $errorOutput->getStyle()->progressAdvance($step); }; $errorOutput->getStyle()->progressStart($allAnalysedFilesCount); $errorOutput->getStyle()->progressAdvance($allAnalysedFilesCount - $filesCount); } else { $startTime = null; $preFileCallback = static function (string $file) use($stdOutput, &$startTime) : void { $stdOutput->writeLineFormatted($file); $startTime = microtime(\true); }; $postFileCallback = null; if ($stdOutput->isDebug()) { $previousMemory = memory_get_peak_usage(\true); $postFileCallback = static function () use($stdOutput, &$previousMemory, &$startTime) : void { if ($startTime === null) { throw new ShouldNotHappenException(); } $currentTotalMemory = memory_get_peak_usage(\true); $elapsedTime = microtime(\true) - $startTime; $stdOutput->writeLineFormatted(sprintf('--- consumed %s, total %s, took %.2f s', BytesHelper::bytes($currentTotalMemory - $previousMemory), BytesHelper::bytes($currentTotalMemory), $elapsedTime)); $previousMemory = $currentTotalMemory; }; } } $analyserResult = $this->analyserRunner->runAnalyser($files, $allAnalysedFiles, $preFileCallback, $postFileCallback, $debug, \true, $projectConfigFile, $input); if (!$debug) { $errorOutput->getStyle()->progressFinish(); } return $analyserResult; } } <?php declare (strict_types=1); namespace PHPStan\Command; use Hoa\Compiler\Llk\Parser; use Hoa\Compiler\Llk\TreeNode; use Hoa\Exception\Exception; use _PHPStan_7d8742a37\Nette\Utils\Strings; use PHPStan\PhpDoc\TypeStringResolver; use PHPStan\PhpDocParser\Parser\ParserException; use PHPStan\ShouldNotHappenException; use PHPStan\Type\ObjectType; use PHPStan\Type\VerbosityLevel; use function count; use function strrpos; use function substr; final class IgnoredRegexValidator { /** * @var Parser */ private $parser; /** * @var TypeStringResolver */ private $typeStringResolver; public function __construct(Parser $parser, TypeStringResolver $typeStringResolver) { $this->parser = $parser; $this->typeStringResolver = $typeStringResolver; } public function validate(string $regex) : \PHPStan\Command\IgnoredRegexValidatorResult { $regex = $this->removeDelimiters($regex); try { /** @var TreeNode $ast */ $ast = $this->parser->parse($regex); } catch (Exception $e) { return new \PHPStan\Command\IgnoredRegexValidatorResult([], \false, \false); } if (Strings::match($regex, '~(?<!\\\\)(?:\\\\\\\\)*\\|\\|~')) { return new \PHPStan\Command\IgnoredRegexValidatorResult([], \false, \true, '||', '\\|\\|'); } if (Strings::match($regex, '~(?<!\\\\)(?:\\\\\\\\)*\\(\\)~')) { return new \PHPStan\Command\IgnoredRegexValidatorResult([], \false, \true, '()', '\\(\\)'); } return new \PHPStan\Command\IgnoredRegexValidatorResult($this->getIgnoredTypes($ast), $this->hasAnchorsInTheMiddle($ast), \false); } /** * @return array<string, string> */ private function getIgnoredTypes(TreeNode $ast) : array { /** @var TreeNode|null $alternation */ $alternation = $ast->getChild(0); if ($alternation === null) { return []; } if ($alternation->getId() !== '#alternation') { return []; } $types = []; foreach ($alternation->getChildren() as $child) { $text = $this->getText($child); if ($text === null) { continue; } $matches = Strings::match($text, '#^([a-zA-Z0-9]+)[,]?\\s*#'); if ($matches === null) { continue; } try { $type = $this->typeStringResolver->resolve($matches[1], null); } catch (ParserException $e) { continue; } if ($type instanceof ObjectType) { continue; } $typeDescription = $type->describe(VerbosityLevel::typeOnly()); if ($typeDescription !== $matches[1]) { continue; } $types[$typeDescription] = $text; } return $types; } private function removeDelimiters(string $regex) : string { $delimiter = substr($regex, 0, 1); $endDelimiterPosition = strrpos($regex, $delimiter); if ($endDelimiterPosition === \false) { throw new ShouldNotHappenException(); } return substr($regex, 1, $endDelimiterPosition - 1); } private function getText(TreeNode $treeNode) : ?string { if ($treeNode->getId() === 'token') { return $treeNode->getValueValue(); } if ($treeNode->getId() === '#concatenation') { $fullText = ''; foreach ($treeNode->getChildren() as $child) { $text = $this->getText($child); if ($text === null) { continue; } $fullText .= $text; } if ($fullText === '') { return null; } return $fullText; } return null; } private function hasAnchorsInTheMiddle(TreeNode $ast) : bool { if ($ast->getId() === 'token') { $valueArray = $ast->getValue(); return $valueArray['token'] === 'anchor' && $valueArray['value'] === '$'; } $childrenCount = count($ast->getChildren()); foreach ($ast->getChildren() as $i => $child) { $has = $this->hasAnchorsInTheMiddle($child); if ($has && ($ast->getId() !== '#concatenation' || $i !== $childrenCount - 1)) { return \true; } } return \false; } } <?php declare (strict_types=1); namespace PHPStan\Command; /** @api */ interface OutputStyle { public function title(string $message) : void; public function section(string $message) : void; /** * @param string[] $elements */ public function listing(array $elements) : void; public function success(string $message) : void; public function error(string $message) : void; public function warning(string $message) : void; public function note(string $message) : void; public function caution(string $message) : void; /** * @param mixed[] $headers * @param mixed[] $rows */ public function table(array $headers, array $rows) : void; public function newLine(int $count = 1) : void; public function progressStart(int $max = 0) : void; public function progressAdvance(int $step = 1) : void; public function progressFinish() : void; } <?php declare (strict_types=1); namespace PHPStan; use Exception; abstract class AnalysedCodeException extends Exception { public abstract function getTip() : ?string; } <?php declare (strict_types=1); namespace PHPStan\Collectors; use PHPStan\DependencyInjection\Container; final class RegistryFactory { /** * @var Container */ private $container; public const COLLECTOR_TAG = 'phpstan.collector'; public function __construct(Container $container) { $this->container = $container; } public function create() : \PHPStan\Collectors\Registry { return new \PHPStan\Collectors\Registry($this->container->getServicesByTag(self::COLLECTOR_TAG)); } } <?php declare (strict_types=1); namespace PHPStan\Collectors; use JsonSerializable; use PhpParser\Node; use ReturnTypeWillChange; /** * @api * @final */ class CollectedData implements JsonSerializable { /** * @var mixed */ private $data; /** * @var string */ private $filePath; /** * @var class-string<Collector<Node, mixed>> */ private $collectorType; /** * @param mixed $data * @param class-string<Collector<Node, mixed>> $collectorType */ public function __construct($data, string $filePath, string $collectorType) { $this->data = $data; $this->filePath = $filePath; $this->collectorType = $collectorType; } /** * @return mixed */ public function getData() { return $this->data; } public function getFilePath() : string { return $this->filePath; } public function changeFilePath(string $newFilePath) : self { return new self($this->data, $newFilePath, $this->collectorType); } /** * @return class-string<Collector<Node, mixed>> */ public function getCollectorType() : string { return $this->collectorType; } /** * @return mixed */ #[\ReturnTypeWillChange] public function jsonSerialize() { return ['data' => $this->data, 'filePath' => $this->filePath, 'collectorType' => $this->collectorType]; } /** * @param mixed[] $json */ public static function decode(array $json) : self { return new self($json['data'], $json['filePath'], $json['collectorType']); } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : self { return new self($properties['data'], $properties['filePath'], $properties['collectorType']); } } <?php declare (strict_types=1); namespace PHPStan\Collectors; use PhpParser\Node; use function class_implements; use function class_parents; final class Registry { /** @var Collector[][] */ private $collectors = []; /** @var Collector[][] */ private $cache = []; /** * @param Collector[] $collectors */ public function __construct(array $collectors) { foreach ($collectors as $collector) { $this->collectors[$collector->getNodeType()][] = $collector; } } /** * @template TNodeType of Node * @param class-string<TNodeType> $nodeType * @return array<Collector<TNodeType, mixed>> */ public function getCollectors(string $nodeType) : array { if (!isset($this->cache[$nodeType])) { $parentNodeTypes = [$nodeType] + class_parents($nodeType) + class_implements($nodeType); $collectors = []; foreach ($parentNodeTypes as $parentNodeType) { foreach ($this->collectors[$parentNodeType] ?? [] as $collector) { $collectors[] = $collector; } } $this->cache[$nodeType] = $collectors; } /** * @var array<Collector<TNodeType, mixed>> $selectedCollectors */ $selectedCollectors = $this->cache[$nodeType]; return $selectedCollectors; } } <?php declare (strict_types=1); namespace PHPStan\Collectors; use PhpParser\Node; use PHPStan\Analyser\Scope; /** * This is the interface custom collectors implement. To register it in the configuration file * use the `phpstan.collector` service tag: * * ``` * services: * - * class: App\MyCollector * tags: * - phpstan.collector * ``` * * Learn more: https://phpstan.org/developing-extensions/collectors * * @api * @template-covariant TNodeType of Node * @template-covariant TValue */ interface Collector { /** * @return class-string<TNodeType> */ public function getNodeType() : string; /** * @param TNodeType $node * @return TValue|null Collected data */ public function processNode(Node $node, Scope $scope); } <?php declare (strict_types=1); namespace PHPStan\Process; use Exception; final class ProcessCrashedException extends Exception { } <?php declare (strict_types=1); namespace PHPStan\Process; use PHPStan\Command\AnalyseCommand; use _PHPStan_7d8742a37\Symfony\Component\Console\Input\InputInterface; use function array_merge; use function escapeshellarg; use function implode; use function ini_get; use function is_bool; use function php_ini_loaded_file; use function sprintf; use const PHP_BINARY; final class ProcessHelper { /** * @param string[] $additionalItems */ public static function getWorkerCommand(string $mainScript, string $commandName, ?string $projectConfigFile, array $additionalItems, InputInterface $input) : string { $phpIni = php_ini_loaded_file(); $phpCmd = $phpIni === \false ? escapeshellarg(PHP_BINARY) : sprintf('%s -c %s', escapeshellarg(PHP_BINARY), escapeshellarg($phpIni)); $processCommandArray = [$phpCmd]; if ($input->getOption('memory-limit') === null) { $processCommandArray[] = '-d'; $processCommandArray[] = 'memory_limit=' . ini_get('memory_limit'); } foreach ([$mainScript, $commandName] as $arg) { $processCommandArray[] = escapeshellarg($arg); } if ($projectConfigFile !== null) { $processCommandArray[] = '--configuration'; $processCommandArray[] = escapeshellarg($projectConfigFile); } $options = [AnalyseCommand::OPTION_LEVEL, 'autoload-file', 'memory-limit', 'xdebug', 'verbose']; foreach ($options as $optionName) { /** @var bool|string|null $optionValue */ $optionValue = $input->getOption($optionName); if (is_bool($optionValue)) { if ($optionValue === \true) { $processCommandArray[] = sprintf('--%s', $optionName); } continue; } if ($optionValue === null) { continue; } $processCommandArray[] = sprintf('--%s=%s', $optionName, escapeshellarg($optionValue)); } $processCommandArray = array_merge($processCommandArray, $additionalItems); $processCommandArray[] = '--'; /** @var string[] $paths */ $paths = $input->getArgument('paths'); foreach ($paths as $path) { $processCommandArray[] = escapeshellarg($path); } return implode(' ', $processCommandArray); } } <?php declare (strict_types=1); namespace PHPStan\Process; use Exception; final class ProcessCanceledException extends Exception { } <?php declare (strict_types=1); namespace PHPStan\Process; use _PHPStan_7d8742a37\Fidry\CpuCoreCounter\CpuCoreCounter as FidryCpuCoreCounter; use _PHPStan_7d8742a37\Fidry\CpuCoreCounter\NumberOfCpuCoreNotFound; final class CpuCoreCounter { /** * @var ?int */ private $count = null; public function getNumberOfCpuCores() : int { if ($this->count !== null) { return $this->count; } try { $this->count = (new FidryCpuCoreCounter())->getCount(); } catch (NumberOfCpuCoreNotFound $e) { $this->count = 1; } return $this->count; } } <?php declare (strict_types=1); namespace PHPStan\Process; use PHPStan\ShouldNotHappenException; use _PHPStan_7d8742a37\React\ChildProcess\Process; use _PHPStan_7d8742a37\React\EventLoop\LoopInterface; use _PHPStan_7d8742a37\React\Promise\Deferred; use _PHPStan_7d8742a37\React\Promise\PromiseInterface; use function fclose; use function rewind; use function stream_get_contents; use function tmpfile; final class ProcessPromise { /** * @var LoopInterface */ private $loop; /** * @var string */ private $name; /** * @var string */ private $command; /** @var Deferred<string> */ private $deferred; /** * @var ?Process */ private $process = null; /** * @var bool */ private $canceled = \false; public function __construct(LoopInterface $loop, string $name, string $command) { $this->loop = $loop; $this->name = $name; $this->command = $command; $this->deferred = new Deferred(); } public function getName() : string { return $this->name; } /** * @return PromiseInterface<string> */ public function run() : PromiseInterface { $tmpStdOutResource = tmpfile(); if ($tmpStdOutResource === \false) { throw new ShouldNotHappenException('Failed creating temp file for stdout.'); } $tmpStdErrResource = tmpfile(); if ($tmpStdErrResource === \false) { throw new ShouldNotHappenException('Failed creating temp file for stderr.'); } $this->process = new Process($this->command, null, null, [1 => $tmpStdOutResource, 2 => $tmpStdErrResource]); $this->process->start($this->loop); $this->process->on('exit', function ($exitCode) use($tmpStdOutResource, $tmpStdErrResource) : void { if ($this->canceled) { fclose($tmpStdOutResource); fclose($tmpStdErrResource); return; } rewind($tmpStdOutResource); $stdOut = stream_get_contents($tmpStdOutResource); fclose($tmpStdOutResource); rewind($tmpStdErrResource); $stdErr = stream_get_contents($tmpStdErrResource); fclose($tmpStdErrResource); if ($exitCode === null) { $this->deferred->reject(new \PHPStan\Process\ProcessCrashedException($stdOut . $stdErr)); return; } if ($exitCode === 0) { if ($stdOut === \false) { $stdOut = ''; } $this->deferred->resolve($stdOut); return; } $this->deferred->reject(new \PHPStan\Process\ProcessCrashedException($stdOut . $stdErr)); }); return $this->deferred->promise(); } public function cancel() : void { if ($this->process === null) { throw new ShouldNotHappenException('Cancelling process before running'); } $this->canceled = \true; $this->process->terminate(); $this->deferred->reject(new \PHPStan\Process\ProcessCanceledException()); } } <?php declare (strict_types=1); namespace PHPStan\Parser; use PhpParser\Node; use PhpParser\NodeVisitorAbstract; use function array_pop; use function array_reverse; use function count; final class TryCatchTypeVisitor extends NodeVisitorAbstract { public const ATTRIBUTE_NAME = 'tryCatchTypes'; /** @var array<int, array<int, string>|null> */ private $typeStack = []; public function beforeTraverse(array $nodes) : ?array { $this->typeStack = []; return null; } public function enterNode(Node $node) : ?Node { if ($node instanceof Node\Stmt || $node instanceof Node\Expr\Match_) { if (count($this->typeStack) > 0) { $node->setAttribute(self::ATTRIBUTE_NAME, $this->typeStack[count($this->typeStack) - 1]); } } if ($node instanceof Node\FunctionLike) { $this->typeStack[] = null; } if ($node instanceof Node\Stmt\TryCatch) { $types = []; foreach (array_reverse($this->typeStack) as $stackTypes) { if ($stackTypes === null) { break; } foreach ($stackTypes as $type) { $types[] = $type; } } foreach ($node->catches as $catch) { foreach ($catch->types as $type) { $types[] = $type->toString(); } } $this->typeStack[] = $types; } return null; } public function leaveNode(Node $node) : ?Node { if (!$node instanceof Node\Stmt\TryCatch && !$node instanceof Node\FunctionLike) { return null; } array_pop($this->typeStack); return null; } } <?php declare (strict_types=1); namespace PHPStan\Parser; use PhpParser\Node; /** @api */ interface Parser { /** * @param string $file path to a file to parse * @return Node\Stmt[] * @throws ParserErrorsException */ public function parseFile(string $file) : array; /** * @return Node\Stmt[] * @throws ParserErrorsException */ public function parseString(string $sourceCode) : array; } <?php declare (strict_types=1); namespace PHPStan\Parser; use PhpParser\ErrorHandler\Collecting; use PhpParser\Node; use PhpParser\NodeTraverser; use PhpParser\NodeVisitor\NameResolver; use PHPStan\File\FileReader; use PHPStan\ShouldNotHappenException; final class SimpleParser implements \PHPStan\Parser\Parser { /** * @var \PhpParser\Parser */ private $parser; /** * @var NameResolver */ private $nameResolver; public function __construct(\PhpParser\Parser $parser, NameResolver $nameResolver) { $this->parser = $parser; $this->nameResolver = $nameResolver; } /** * @param string $file path to a file to parse * @return Node\Stmt[] */ public function parseFile(string $file) : array { try { return $this->parseString(FileReader::read($file)); } catch (\PHPStan\Parser\ParserErrorsException $e) { throw new \PHPStan\Parser\ParserErrorsException($e->getErrors(), $file); } } /** * @return Node\Stmt[] */ public function parseString(string $sourceCode) : array { $errorHandler = new Collecting(); $nodes = $this->parser->parse($sourceCode, $errorHandler); if ($errorHandler->hasErrors()) { throw new \PHPStan\Parser\ParserErrorsException($errorHandler->getErrors(), null); } if ($nodes === null) { throw new ShouldNotHappenException(); } $nodeTraverser = new NodeTraverser(); $nodeTraverser->addVisitor($this->nameResolver); /** @var array<Node\Stmt> */ return $nodeTraverser->traverse($nodes); } } <?php declare (strict_types=1); namespace PHPStan\Parser; use PhpParser\Node; use PhpParser\NodeVisitorAbstract; use function str_starts_with; final class DeclarePositionVisitor extends NodeVisitorAbstract { /** * @var bool */ private $isFirstStatement = \true; public const ATTRIBUTE_NAME = 'isFirstStatement'; public function beforeTraverse(array $nodes) : ?array { $this->isFirstStatement = \true; return null; } public function enterNode(Node $node) : ?Node { // ignore shebang if ($this->isFirstStatement && $node instanceof Node\Stmt\InlineHTML && str_starts_with($node->value, '#!')) { return null; } if ($node instanceof Node\Stmt) { if ($node instanceof Node\Stmt\Declare_) { $node->setAttribute(self::ATTRIBUTE_NAME, $this->isFirstStatement); } $this->isFirstStatement = \false; } return null; } } <?php declare (strict_types=1); namespace PHPStan\Parser; use PhpParser\Node\Stmt; use PhpParser\NodeTraverser; use PHPStan\Php\PhpVersion; final class CleaningParser implements \PHPStan\Parser\Parser { /** * @var Parser */ private $wrappedParser; /** * @var NodeTraverser */ private $traverser; public function __construct(\PHPStan\Parser\Parser $wrappedParser, PhpVersion $phpVersion) { $this->wrappedParser = $wrappedParser; $this->traverser = new NodeTraverser(); $this->traverser->addVisitor(new \PHPStan\Parser\CleaningVisitor()); $this->traverser->addVisitor(new \PHPStan\Parser\RemoveUnusedCodeByPhpVersionIdVisitor($phpVersion->getVersionString())); } public function parseFile(string $file) : array { return $this->clean($this->wrappedParser->parseFile($file)); } public function parseString(string $sourceCode) : array { return $this->clean($this->wrappedParser->parseString($sourceCode)); } /** * @param Stmt[] $ast * @return Stmt[] */ private function clean(array $ast) : array { /** @var Stmt[] */ return $this->traverser->traverse($ast); } } <?php declare (strict_types=1); namespace PHPStan\Parser; use PhpParser\Node; use PhpParser\NodeVisitorAbstract; use function count; final class ClosureArgVisitor extends NodeVisitorAbstract { public const ATTRIBUTE_NAME = 'closureCallArgs'; public function enterNode(Node $node) : ?Node { if (!$node instanceof Node\Expr\FuncCall) { return null; } if ($node->isFirstClassCallable()) { return null; } if ($node->name instanceof Node\Expr\Assign && $node->name->expr instanceof Node\Expr\Closure) { $closure = $node->name->expr; } elseif ($node->name instanceof Node\Expr\Closure) { $closure = $node->name; } else { return null; } $args = $node->getArgs(); if (count($args) > 0) { $closure->setAttribute(self::ATTRIBUTE_NAME, $args); } return null; } } <?php declare (strict_types=1); namespace PHPStan\Parser; use PhpParser\Node; use PhpParser\NodeVisitorAbstract; final class MagicConstantParamDefaultVisitor extends NodeVisitorAbstract { public const ATTRIBUTE_NAME = 'isMagicConstantParamDefault'; public function enterNode(Node $node) : ?Node { if ($node instanceof Node\Param && $node->default instanceof Node\Scalar\MagicConst) { $node->default->setAttribute(self::ATTRIBUTE_NAME, \true); } return null; } } <?php declare (strict_types=1); namespace PHPStan\Parser; use PhpParser\Node; use PhpParser\NodeVisitorAbstract; use function in_array; final class ArrayFindArgVisitor extends NodeVisitorAbstract { public const ATTRIBUTE_NAME = 'isArrayFindArg'; public function enterNode(Node $node) : ?Node { if ($node instanceof Node\Expr\FuncCall && $node->name instanceof Node\Name) { $functionName = $node->name->toLowerString(); if (in_array($functionName, ['array_all', 'array_any', 'array_find', 'array_find_key'], \true)) { $args = $node->getRawArgs(); if (isset($args[0])) { $args[0]->setAttribute(self::ATTRIBUTE_NAME, \true); } } } return null; } } <?php declare (strict_types=1); namespace PHPStan\Parser; use PhpParser\Node; use PhpParser\NodeVisitorAbstract; final class TypeTraverserInstanceofVisitor extends NodeVisitorAbstract { public const ATTRIBUTE_NAME = 'insideTypeTraverserMap'; /** * @var int */ private $depth = 0; public function beforeTraverse(array $nodes) : ?array { $this->depth = 0; return null; } public function enterNode(Node $node) : ?Node { if ($node instanceof Node\Expr\Instanceof_ && $this->depth > 0) { $node->setAttribute(self::ATTRIBUTE_NAME, \true); return null; } if ($node instanceof Node\Expr\StaticCall && $node->class instanceof Node\Name && $node->class->toLowerString() === 'phpstan\\type\\typetraverser' && $node->name instanceof Node\Identifier && $node->name->toLowerString() === 'map') { $this->depth++; } return null; } public function leaveNode(Node $node) : ?Node { if ($node instanceof Node\Expr\StaticCall && $node->class instanceof Node\Name && $node->class->toLowerString() === 'phpstan\\type\\typetraverser' && $node->name instanceof Node\Identifier && $node->name->toLowerString() === 'map') { $this->depth--; } return null; } } <?php declare (strict_types=1); namespace PHPStan\Parser; use PhpParser\Node; use PhpParser\NodeVisitorAbstract; final class NewAssignedToPropertyVisitor extends NodeVisitorAbstract { public const ATTRIBUTE_NAME = 'assignedToProperty'; public function enterNode(Node $node) : ?Node { if ($node instanceof Node\Expr\Assign || $node instanceof Node\Expr\AssignRef) { if (($node->var instanceof Node\Expr\PropertyFetch || $node->var instanceof Node\Expr\StaticPropertyFetch) && $node->expr instanceof Node\Expr\New_) { $node->expr->setAttribute(self::ATTRIBUTE_NAME, $node->var); } } return null; } } <?php declare (strict_types=1); namespace PHPStan\Parser; use PhpParser\Node; use PhpParser\NodeVisitorAbstract; final class ImmediatelyInvokedClosureVisitor extends NodeVisitorAbstract { public const ATTRIBUTE_NAME = 'isImmediatelyInvokedClosure'; public function enterNode(Node $node) : ?Node { if ($node instanceof Node\Expr\FuncCall && $node->name instanceof Node\Expr\Closure) { $node->name->setAttribute(self::ATTRIBUTE_NAME, \true); } return null; } } <?php declare (strict_types=1); namespace PHPStan\Parser; use PhpParser\Node; use PhpParser\NodeFinder; use PhpParser\NodeVisitorAbstract; use PHPStan\Reflection\ParametersAcceptor; use function in_array; final class CleaningVisitor extends NodeVisitorAbstract { /** * @var NodeFinder */ private $nodeFinder; public function __construct() { $this->nodeFinder = new NodeFinder(); } public function enterNode(Node $node) : ?Node { if ($node instanceof Node\Stmt\Function_) { $node->stmts = $this->keepVariadicsAndYields($node->stmts); return $node; } if ($node instanceof Node\Stmt\ClassMethod && $node->stmts !== null) { $node->stmts = $this->keepVariadicsAndYields($node->stmts); return $node; } if ($node instanceof Node\Expr\Closure) { $node->stmts = $this->keepVariadicsAndYields($node->stmts); return $node; } return null; } /** * @param Node\Stmt[] $stmts * @return Node\Stmt[] */ private function keepVariadicsAndYields(array $stmts) : array { $results = $this->nodeFinder->find($stmts, static function (Node $node) : bool { if ($node instanceof Node\Expr\YieldFrom || $node instanceof Node\Expr\Yield_) { return \true; } if ($node instanceof Node\Expr\FuncCall && $node->name instanceof Node\Name) { return in_array($node->name->toLowerString(), ParametersAcceptor::VARIADIC_FUNCTIONS, \true); } if ($node instanceof Node\Expr\Closure || $node instanceof Node\Expr\ArrowFunction) { return \true; } return \false; }); $newStmts = []; foreach ($results as $result) { if ($result instanceof Node\Expr\Yield_ || $result instanceof Node\Expr\YieldFrom || $result instanceof Node\Expr\Closure || $result instanceof Node\Expr\ArrowFunction) { $newStmts[] = new Node\Stmt\Expression($result); continue; } if (!$result instanceof Node\Expr\FuncCall) { continue; } $newStmts[] = new Node\Stmt\Expression(new Node\Expr\FuncCall(new Node\Name\FullyQualified('func_get_args'))); } return $newStmts; } } <?php declare (strict_types=1); namespace PHPStan\Parser; use PhpParser\Node; use PhpParser\Node\Expr\FuncCall; use PhpParser\Node\Name; use function in_array; use function is_array; final class FunctionCallStatementFinder { /** * @param string[] $functionNames * @param mixed $statements */ public function findFunctionCallInStatements(array $functionNames, $statements) : ?Node { foreach ($statements as $statement) { if (is_array($statement)) { $result = $this->findFunctionCallInStatements($functionNames, $statement); if ($result !== null) { return $result; } } if (!$statement instanceof Node) { continue; } if ($statement instanceof FuncCall && $statement->name instanceof Name) { if (in_array((string) $statement->name, $functionNames, \true)) { return $statement; } } $result = $this->findFunctionCallInStatements($functionNames, $statement); if ($result !== null) { return $result; } } return null; } } <?php declare (strict_types=1); namespace PHPStan\Parser; use Exception; use PhpParser\Error; use function array_map; use function count; use function implode; final class ParserErrorsException extends Exception { /** * @var Error[] */ private $errors; /** * @var ?string */ private $parsedFile; /** @var mixed[] */ private $attributes; /** * @param Error[] $errors */ public function __construct(array $errors, ?string $parsedFile) { $this->errors = $errors; $this->parsedFile = $parsedFile; parent::__construct(implode(', ', array_map(static function (Error $error) : string { return $error->getRawMessage(); }, $errors))); if (count($errors) > 0) { $this->attributes = $errors[0]->getAttributes(); } else { $this->attributes = []; } } /** * @return Error[] */ public function getErrors() : array { return $this->errors; } public function getParsedFile() : ?string { return $this->parsedFile; } /** * @return mixed[] */ public function getAttributes() : array { return $this->attributes; } } <?php declare (strict_types=1); namespace PHPStan\Parser; use PhpParser\Node; use PhpParser\NodeVisitorAbstract; use PHPStan\Php\PhpVersion; use function count; use function version_compare; final class RemoveUnusedCodeByPhpVersionIdVisitor extends NodeVisitorAbstract { /** * @var string */ private $phpVersionString; public function __construct(string $phpVersionString) { $this->phpVersionString = $phpVersionString; } public function enterNode(Node $node) : ?Node { if (!$node instanceof Node\Stmt\If_) { return null; } if (count($node->elseifs) > 0) { return null; } if ($node->else === null) { return null; } $cond = $node->cond; if (!$cond instanceof Node\Expr\BinaryOp\Smaller && !$cond instanceof Node\Expr\BinaryOp\SmallerOrEqual && !$cond instanceof Node\Expr\BinaryOp\Greater && !$cond instanceof Node\Expr\BinaryOp\GreaterOrEqual && !$cond instanceof Node\Expr\BinaryOp\Equal && !$cond instanceof Node\Expr\BinaryOp\NotEqual && !$cond instanceof Node\Expr\BinaryOp\Identical && !$cond instanceof Node\Expr\BinaryOp\NotIdentical) { return null; } $operator = $cond->getOperatorSigil(); if ($operator === '===') { $operator = '=='; } elseif ($operator === '!==') { $operator = '!='; } $operands = $this->getOperands($cond->left, $cond->right); if ($operands === null) { return null; } $result = version_compare($operands[0], $operands[1], $operator); if ($result) { // remove else $node->cond = new Node\Expr\ConstFetch(new Node\Name('true')); $node->else = null; return $node; } // remove if $node->cond = new Node\Expr\ConstFetch(new Node\Name('false')); $node->stmts = []; return $node; } /** * @return array{string, string}|null */ private function getOperands(Node\Expr $left, Node\Expr $right) : ?array { if ($left instanceof Node\Scalar\LNumber && $right instanceof Node\Expr\ConstFetch && $right->name->toString() === 'PHP_VERSION_ID') { return [(new PhpVersion($left->value))->getVersionString(), $this->phpVersionString]; } if ($right instanceof Node\Scalar\LNumber && $left instanceof Node\Expr\ConstFetch && $left->name->toString() === 'PHP_VERSION_ID') { return [$this->phpVersionString, (new PhpVersion($right->value))->getVersionString()]; } return null; } } <?php declare (strict_types=1); namespace PHPStan\Parser; use PhpParser\Node; use PhpParser\Node\Identifier; use PhpParser\NodeVisitorAbstract; final class ClosureBindToVarVisitor extends NodeVisitorAbstract { public const ATTRIBUTE_NAME = 'closureBindToVar'; public function enterNode(Node $node) : ?Node { if ($node instanceof Node\Expr\MethodCall && $node->name instanceof Identifier && $node->name->toLowerString() === 'bindto' && !$node->isFirstClassCallable()) { $args = $node->getArgs(); if (isset($args[0])) { $args[0]->setAttribute(self::ATTRIBUTE_NAME, $node->var); } } return null; } } <?php declare (strict_types=1); namespace PHPStan\Parser; use PhpParser\Node; use PhpParser\NodeVisitorAbstract; use function count; final class LastConditionVisitor extends NodeVisitorAbstract { public const ATTRIBUTE_NAME = 'isLastCondition'; public const ATTRIBUTE_IS_MATCH_NAME = 'isMatch'; public function enterNode(Node $node) : ?Node { if ($node instanceof Node\Stmt\If_ && $node->elseifs !== []) { $lastElseIf = count($node->elseifs) - 1; $elseIsMissingOrThrowing = $node->else === null || count($node->else->stmts) === 1 && $node->else->stmts[0] instanceof Node\Stmt\Throw_; foreach ($node->elseifs as $i => $elseif) { $isLast = $i === $lastElseIf && $elseIsMissingOrThrowing; $elseif->cond->setAttribute(self::ATTRIBUTE_NAME, $isLast); } } if ($node instanceof Node\Expr\Match_ && $node->arms !== []) { $lastArm = count($node->arms) - 1; foreach ($node->arms as $i => $arm) { if ($arm->conds === null || $arm->conds === []) { continue; } $isLast = $i === $lastArm; $index = count($arm->conds) - 1; $arm->conds[$index]->setAttribute(self::ATTRIBUTE_NAME, $isLast); $arm->conds[$index]->setAttribute(self::ATTRIBUTE_IS_MATCH_NAME, \true); } } if ($node instanceof Node\Stmt\Function_ || $node instanceof Node\Stmt\ClassMethod || $node instanceof Node\Stmt\If_ || $node instanceof Node\Stmt\ElseIf_ || $node instanceof Node\Stmt\Else_ || $node instanceof Node\Stmt\Case_ || $node instanceof Node\Stmt\Catch_ || $node instanceof Node\Stmt\Do_ || $node instanceof Node\Stmt\Finally_ || $node instanceof Node\Stmt\For_ || $node instanceof Node\Stmt\Foreach_ || $node instanceof Node\Stmt\Namespace_ || $node instanceof Node\Stmt\TryCatch || $node instanceof Node\Stmt\While_) { $statements = $node->stmts ?? []; $statementCount = count($statements); if ($statementCount < 2) { return null; } if (!$statements[$statementCount - 1] instanceof Node\Stmt\Throw_) { return null; } if (!$statements[$statementCount - 2] instanceof Node\Stmt\If_ || $statements[$statementCount - 2]->else !== null) { return null; } $if = $statements[$statementCount - 2]; $cond = count($if->elseifs) > 0 ? $if->elseifs[count($if->elseifs) - 1]->cond : $if->cond; $cond->setAttribute(self::ATTRIBUTE_NAME, \true); } return null; } } <?php declare (strict_types=1); namespace PHPStan\Parser; use PhpParser\Node; use PhpParser\NodeVisitorAbstract; use function count; final class ArrowFunctionArgVisitor extends NodeVisitorAbstract { public const ATTRIBUTE_NAME = 'arrowFunctionCallArgs'; public function enterNode(Node $node) : ?Node { if (!$node instanceof Node\Expr\FuncCall) { return null; } if ($node->isFirstClassCallable()) { return null; } if ($node->name instanceof Node\Expr\Assign && $node->name->expr instanceof Node\Expr\ArrowFunction) { $arrow = $node->name->expr; } elseif ($node->name instanceof Node\Expr\ArrowFunction) { $arrow = $node->name; } else { return null; } $args = $node->getArgs(); if (count($args) > 0) { $arrow->setAttribute(self::ATTRIBUTE_NAME, $args); } return null; } } <?php declare (strict_types=1); namespace PHPStan\Parser; use PhpParser\Error; use PhpParser\ErrorHandler; use PhpParser\Node; use PhpParser\Parser; use function sprintf; final class PhpParserDecorator implements Parser { /** * @var \PHPStan\Parser\Parser */ private $wrappedParser; public function __construct(\PHPStan\Parser\Parser $wrappedParser) { $this->wrappedParser = $wrappedParser; } /** * @return Node\Stmt[] */ public function parse(string $code, ?ErrorHandler $errorHandler = null) : array { try { return $this->wrappedParser->parseString($code); } catch (\PHPStan\Parser\ParserErrorsException $e) { $message = $e->getMessage(); if ($e->getParsedFile() !== null) { $message .= sprintf(' in file %s', $e->getParsedFile()); } throw new Error($message, $e->getAttributes()); } } } <?php declare (strict_types=1); namespace PHPStan\Parser; use PhpParser\Node; use PhpParser\NodeVisitorAbstract; use function array_pop; use function count; use function get_class; final class ParentStmtTypesVisitor extends NodeVisitorAbstract { public const ATTRIBUTE_NAME = 'parentStmtTypes'; /** @var array<int, class-string<Node\Stmt|Node\Expr\Closure>> */ private $typeStack = []; public function beforeTraverse(array $nodes) : ?array { $this->typeStack = []; return null; } public function enterNode(Node $node) : ?Node { if (!$node instanceof Node\Stmt && !$node instanceof Node\Expr\Closure) { return null; } if (count($this->typeStack) > 0) { $node->setAttribute(self::ATTRIBUTE_NAME, $this->typeStack); } $this->typeStack[] = get_class($node); return null; } public function leaveNode(Node $node) : ?Node { if (!$node instanceof Node\Stmt && !$node instanceof Node\Expr\Closure) { return null; } array_pop($this->typeStack); return null; } } <?php declare (strict_types=1); namespace PHPStan\Parser; use PhpParser\Node; use PhpParser\NodeVisitorAbstract; use function array_slice; use function count; final class ArrayMapArgVisitor extends NodeVisitorAbstract { public const ATTRIBUTE_NAME = 'arrayMapArgs'; public function enterNode(Node $node) : ?Node { if ($node instanceof Node\Expr\FuncCall && $node->name instanceof Node\Name && !$node->isFirstClassCallable()) { $functionName = $node->name->toLowerString(); if ($functionName === 'array_map') { $args = $node->getArgs(); if (isset($args[0])) { $slicedArgs = array_slice($args, 1); if (count($slicedArgs) > 0) { $args[0]->value->setAttribute(self::ATTRIBUTE_NAME, $slicedArgs); } } } } return null; } } <?php declare (strict_types=1); namespace PHPStan\Parser; use PhpParser\Node; use PhpParser\NodeVisitorAbstract; use PHPStan\Node\AnonymousClassNode; use function count; final class AnonymousClassVisitor extends NodeVisitorAbstract { public const ATTRIBUTE_LINE_INDEX = 'anonymousClassLineIndex'; /** @var array<int, non-empty-list<AnonymousClassNode>> */ private $nodesPerLine = []; public function beforeTraverse(array $nodes) : ?array { $this->nodesPerLine = []; return null; } public function enterNode(Node $node) : ?Node { if (!$node instanceof Node\Stmt\Class_ || !$node->isAnonymous()) { return null; } $node = AnonymousClassNode::createFromClassNode($node); $node->setAttribute('anonymousClass', \true); // We keep this for backward compatibility $this->nodesPerLine[$node->getStartLine()][] = $node; return $node; } public function afterTraverse(array $nodes) : ?array { foreach ($this->nodesPerLine as $nodesOnLine) { if (count($nodesOnLine) === 1) { continue; } for ($i = 0; $i < count($nodesOnLine); $i++) { $nodesOnLine[$i]->setAttribute(self::ATTRIBUTE_LINE_INDEX, $i + 1); } } $this->nodesPerLine = []; return null; } } <?php declare (strict_types=1); namespace PHPStan\Parser; use PhpParser\Node; use PhpParser\NodeVisitorAbstract; final class TraitCollectingVisitor extends NodeVisitorAbstract { /** @var list<Node\Stmt\Trait_> */ public $traits = []; public function enterNode(Node $node) : ?Node { if (!$node instanceof Node\Stmt\Trait_) { return null; } $this->traits[] = $node; return null; } } <?php declare (strict_types=1); namespace PHPStan\Parser; use PhpParser\Node; use PhpParser\Node\Identifier; use PhpParser\NodeVisitorAbstract; use function count; final class ClosureBindArgVisitor extends NodeVisitorAbstract { public const ATTRIBUTE_NAME = 'closureBindArg'; public function enterNode(Node $node) : ?Node { if ($node instanceof Node\Expr\StaticCall && $node->class instanceof Node\Name && $node->class->toLowerString() === 'closure' && $node->name instanceof Identifier && $node->name->toLowerString() === 'bind' && !$node->isFirstClassCallable()) { $args = $node->getArgs(); if (count($args) > 1) { $args[0]->setAttribute(self::ATTRIBUTE_NAME, \true); } } return null; } } <?php declare (strict_types=1); namespace PHPStan\Parser; use PhpParser\Node; use PhpParser\NodeVisitorAbstract; final class ArrayFilterArgVisitor extends NodeVisitorAbstract { public const ATTRIBUTE_NAME = 'isArrayFilterArg'; public function enterNode(Node $node) : ?Node { if ($node instanceof Node\Expr\FuncCall && $node->name instanceof Node\Name) { $functionName = $node->name->toLowerString(); if ($functionName === 'array_filter') { $args = $node->getRawArgs(); if (isset($args[0])) { $args[0]->setAttribute(self::ATTRIBUTE_NAME, \true); } } } return null; } } <?php declare (strict_types=1); namespace PHPStan\Parser; use PhpParser\Node; use PHPStan\File\FileReader; use function array_slice; final class CachedParser implements \PHPStan\Parser\Parser { /** * @var Parser */ private $originalParser; /** * @var int */ private $cachedNodesByStringCountMax; /** @var array<string, Node\Stmt[]>*/ private $cachedNodesByString = []; /** * @var int */ private $cachedNodesByStringCount = 0; /** @var array<string, true> */ private $parsedByString = []; public function __construct(\PHPStan\Parser\Parser $originalParser, int $cachedNodesByStringCountMax) { $this->originalParser = $originalParser; $this->cachedNodesByStringCountMax = $cachedNodesByStringCountMax; } /** * @param string $file path to a file to parse * @return Node\Stmt[] */ public function parseFile(string $file) : array { if ($this->cachedNodesByStringCountMax !== 0 && $this->cachedNodesByStringCount >= $this->cachedNodesByStringCountMax) { $this->cachedNodesByString = array_slice($this->cachedNodesByString, 1, null, \true); --$this->cachedNodesByStringCount; } $sourceCode = FileReader::read($file); if (!isset($this->cachedNodesByString[$sourceCode]) || isset($this->parsedByString[$sourceCode])) { $this->cachedNodesByString[$sourceCode] = $this->originalParser->parseFile($file); $this->cachedNodesByStringCount++; unset($this->parsedByString[$sourceCode]); } return $this->cachedNodesByString[$sourceCode]; } /** * @return Node\Stmt[] */ public function parseString(string $sourceCode) : array { if ($this->cachedNodesByStringCountMax !== 0 && $this->cachedNodesByStringCount >= $this->cachedNodesByStringCountMax) { $this->cachedNodesByString = array_slice($this->cachedNodesByString, 1, null, \true); --$this->cachedNodesByStringCount; } if (!isset($this->cachedNodesByString[$sourceCode])) { $this->cachedNodesByString[$sourceCode] = $this->originalParser->parseString($sourceCode); $this->cachedNodesByStringCount++; $this->parsedByString[$sourceCode] = \true; } return $this->cachedNodesByString[$sourceCode]; } public function getCachedNodesByStringCount() : int { return $this->cachedNodesByStringCount; } public function getCachedNodesByStringCountMax() : int { return $this->cachedNodesByStringCountMax; } /** * @return array<string, Node[]> */ public function getCachedNodesByString() : array { return $this->cachedNodesByString; } } <?php declare (strict_types=1); namespace PHPStan\Parser; use PhpParser\Node; use PhpParser\NodeVisitorAbstract; final class ArrayWalkArgVisitor extends NodeVisitorAbstract { public const ATTRIBUTE_NAME = 'isArrayWalkArg'; public function enterNode(Node $node) : ?Node { if ($node instanceof Node\Expr\FuncCall && $node->name instanceof Node\Name) { $functionName = $node->name->toLowerString(); if ($functionName === 'array_walk') { $args = $node->getRawArgs(); if (isset($args[0])) { $args[0]->setAttribute(self::ATTRIBUTE_NAME, \true); } } } return null; } } <?php declare (strict_types=1); namespace PHPStan\Parser; use PhpParser\Lexer; use PHPStan\Php\PhpVersion; use const PHP_VERSION_ID; final class LexerFactory { /** * @var PhpVersion */ private $phpVersion; private const OPTIONS = ['usedAttributes' => ['comments', 'startLine', 'endLine', 'startTokenPos', 'endTokenPos', 'startFilePos', 'endFilePos']]; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; } public function create() : Lexer { $options = self::OPTIONS; if ($this->phpVersion->getVersionId() === PHP_VERSION_ID) { return new Lexer($options); } $options['phpVersion'] = $this->phpVersion->getVersionString(); return new Lexer\Emulative($options); } public function createEmulative() : Lexer\Emulative { return new Lexer\Emulative(self::OPTIONS); } } <?php declare (strict_types=1); namespace PHPStan\Parser; use PhpParser\Node; use PhpParser\NodeVisitorAbstract; final class CurlSetOptArgVisitor extends NodeVisitorAbstract { public const ATTRIBUTE_NAME = 'isCurlSetOptArg'; public function enterNode(Node $node) : ?Node { if ($node instanceof Node\Expr\FuncCall && $node->name instanceof Node\Name) { $functionName = $node->name->toLowerString(); if ($functionName === 'curl_setopt') { $args = $node->getRawArgs(); if (isset($args[0])) { $args[0]->setAttribute(self::ATTRIBUTE_NAME, \true); } } } return null; } } <?php declare (strict_types=1); namespace PHPStan\Parser; use PHPStan\File\FileHelper; use function array_fill_keys; use function array_slice; use function count; use function explode; use function implode; use function is_link; use function realpath; use function str_contains; use const DIRECTORY_SEPARATOR; final class PathRoutingParser implements \PHPStan\Parser\Parser { /** * @var FileHelper */ private $fileHelper; /** * @var Parser */ private $currentPhpVersionRichParser; /** * @var Parser */ private $currentPhpVersionSimpleParser; /** * @var Parser */ private $php8Parser; /** @var bool[] filePath(string) => bool(true) */ private $analysedFiles = []; public function __construct(FileHelper $fileHelper, \PHPStan\Parser\Parser $currentPhpVersionRichParser, \PHPStan\Parser\Parser $currentPhpVersionSimpleParser, \PHPStan\Parser\Parser $php8Parser) { $this->fileHelper = $fileHelper; $this->currentPhpVersionRichParser = $currentPhpVersionRichParser; $this->currentPhpVersionSimpleParser = $currentPhpVersionSimpleParser; $this->php8Parser = $php8Parser; } /** * @param string[] $files */ public function setAnalysedFiles(array $files) : void { $this->analysedFiles = array_fill_keys($files, \true); } public function parseFile(string $file) : array { $normalizedPath = $this->fileHelper->normalizePath($file, '/'); if (str_contains($normalizedPath, 'vendor/jetbrains/phpstorm-stubs')) { return $this->php8Parser->parseFile($file); } if (str_contains($normalizedPath, 'vendor/phpstan/php-8-stubs/stubs')) { return $this->php8Parser->parseFile($file); } $file = $this->fileHelper->normalizePath($file); if (!isset($this->analysedFiles[$file])) { // check symlinked file that still might be in analysedFiles $pathParts = explode(DIRECTORY_SEPARATOR, $file); for ($i = count($pathParts); $i > 1; $i--) { $joinedPartOfPath = implode(DIRECTORY_SEPARATOR, array_slice($pathParts, 0, $i)); if (!@is_link($joinedPartOfPath)) { continue; } $realFilePath = realpath($file); if ($realFilePath !== \false) { $normalizedRealFilePath = $this->fileHelper->normalizePath($realFilePath); if (isset($this->analysedFiles[$normalizedRealFilePath])) { return $this->currentPhpVersionRichParser->parseFile($file); } } break; } return $this->currentPhpVersionSimpleParser->parseFile($file); } return $this->currentPhpVersionRichParser->parseFile($file); } public function parseString(string $sourceCode) : array { return $this->currentPhpVersionSimpleParser->parseString($sourceCode); } } <?php declare (strict_types=1); namespace PHPStan\Parser; use PhpParser\ErrorHandler\Collecting; use PhpParser\Lexer; use PhpParser\Node; use PhpParser\NodeTraverser; use PhpParser\NodeVisitor\NameResolver; use PHPStan\Analyser\Ignore\IgnoreLexer; use PHPStan\Analyser\Ignore\IgnoreParseException; use PHPStan\DependencyInjection\Container; use PHPStan\File\FileReader; use PHPStan\ShouldNotHappenException; use function array_filter; use function array_map; use function count; use function implode; use function in_array; use function is_string; use function preg_match_all; use function sprintf; use function str_contains; use function strlen; use function strpos; use function substr; use function substr_count; use const ARRAY_FILTER_USE_KEY; use const PREG_OFFSET_CAPTURE; use const T_COMMENT; use const T_DOC_COMMENT; use const T_WHITESPACE; final class RichParser implements \PHPStan\Parser\Parser { /** * @var \PhpParser\Parser */ private $parser; /** * @var Lexer */ private $lexer; /** * @var NameResolver */ private $nameResolver; /** * @var Container */ private $container; /** * @var IgnoreLexer */ private $ignoreLexer; /** * @var bool */ private $enableIgnoreErrorsWithinPhpDocs; public const VISITOR_SERVICE_TAG = 'phpstan.parser.richParserNodeVisitor'; private const PHPDOC_TAG_REGEX = '(@(?:[a-z][a-z0-9-\\\\]+:)?[a-z][a-z0-9-\\\\]*+)'; private const PHPDOC_DOCTRINE_TAG_REGEX = '(@[a-z_\\\\][a-z0-9_\\:\\\\]*[a-z_][a-z0-9_]*)'; public function __construct(\PhpParser\Parser $parser, Lexer $lexer, NameResolver $nameResolver, Container $container, IgnoreLexer $ignoreLexer, bool $enableIgnoreErrorsWithinPhpDocs = \false) { $this->parser = $parser; $this->lexer = $lexer; $this->nameResolver = $nameResolver; $this->container = $container; $this->ignoreLexer = $ignoreLexer; $this->enableIgnoreErrorsWithinPhpDocs = $enableIgnoreErrorsWithinPhpDocs; } /** * @param string $file path to a file to parse * @return Node\Stmt[] */ public function parseFile(string $file) : array { try { return $this->parseString(FileReader::read($file)); } catch (\PHPStan\Parser\ParserErrorsException $e) { throw new \PHPStan\Parser\ParserErrorsException($e->getErrors(), $file); } } /** * @return Node\Stmt[] */ public function parseString(string $sourceCode) : array { $errorHandler = new Collecting(); $nodes = $this->parser->parse($sourceCode, $errorHandler); /** @var list<string|array{0:int,1:string,2:int}> $tokens */ $tokens = $this->lexer->getTokens(); if ($errorHandler->hasErrors()) { throw new \PHPStan\Parser\ParserErrorsException($errorHandler->getErrors(), null); } if ($nodes === null) { throw new ShouldNotHappenException(); } $nodeTraverser = new NodeTraverser(); $nodeTraverser->addVisitor($this->nameResolver); $traitCollectingVisitor = new \PHPStan\Parser\TraitCollectingVisitor(); $nodeTraverser->addVisitor($traitCollectingVisitor); foreach ($this->container->getServicesByTag(self::VISITOR_SERVICE_TAG) as $visitor) { $nodeTraverser->addVisitor($visitor); } /** @var array<Node\Stmt> */ $nodes = $nodeTraverser->traverse($nodes); ['lines' => $linesToIgnore, 'errors' => $ignoreParseErrors] = $this->getLinesToIgnore($tokens); if (isset($nodes[0])) { $nodes[0]->setAttribute('linesToIgnore', $linesToIgnore); if (count($ignoreParseErrors) > 0) { $nodes[0]->setAttribute('linesToIgnoreParseErrors', $ignoreParseErrors); } } foreach ($traitCollectingVisitor->traits as $trait) { $preexisting = $trait->getAttribute('linesToIgnore', []); $filteredLinesToIgnore = array_filter($linesToIgnore, static function (int $line) use($trait) : bool { return $line >= $trait->getStartLine() && $line <= $trait->getEndLine(); }, ARRAY_FILTER_USE_KEY); foreach ($preexisting as $line => $ignores) { $filteredLinesToIgnore[$line] = $ignores; } $trait->setAttribute('linesToIgnore', $filteredLinesToIgnore); } return $nodes; } /** * @param list<string|array{0:int,1:string,2:int}> $tokens * @return array{lines: array<int, non-empty-list<string>|null>, errors: array<int, non-empty-list<string>>} */ private function getLinesToIgnore(array $tokens) : array { $lines = []; $previousToken = null; $pendingToken = null; $errors = []; foreach ($tokens as $token) { if (is_string($token)) { continue; } $type = $token[0]; $line = $token[2]; if ($type !== T_COMMENT && $type !== T_DOC_COMMENT) { if ($type !== T_WHITESPACE) { if ($pendingToken !== null) { [$pendingText, $pendingIgnorePos, $tokenLine, $pendingLine] = $pendingToken; try { $identifiers = $this->parseIdentifiers($pendingText, $pendingIgnorePos); } catch (IgnoreParseException $e) { $errors[] = [$tokenLine + $e->getPhpDocLine(), $e->getMessage()]; $pendingToken = null; continue; } if ($line !== $pendingLine + 1) { $lineToAdd = $pendingLine; } else { $lineToAdd = $line; } foreach ($identifiers as $identifier) { $lines[$lineToAdd][] = $identifier; } $pendingToken = null; } $previousToken = $token; } continue; } $text = $token[1]; $isNextLine = str_contains($text, '@phpstan-ignore-next-line'); $isCurrentLine = str_contains($text, '@phpstan-ignore-line'); if ($this->enableIgnoreErrorsWithinPhpDocs && $type === T_DOC_COMMENT) { $lines += $this->getLinesToIgnoreForTokenByIgnoreComment($text, $line, '@phpstan-ignore-line'); if ($isNextLine) { $pattern = sprintf('~%s~si', implode('|', [self::PHPDOC_TAG_REGEX, self::PHPDOC_DOCTRINE_TAG_REGEX])); $r = preg_match_all($pattern, $text, $pregMatches, PREG_OFFSET_CAPTURE); if ($r !== \false) { $c = count($pregMatches[0]); if ($c > 0) { [$lastMatchTag, $lastMatchOffset] = $pregMatches[0][$c - 1]; if ($lastMatchTag === '@phpstan-ignore-next-line') { // this will let us ignore errors outside of PHPDoc // and also cut off the PHPDoc text before the last tag $lineToIgnore = $line + 1 + substr_count($text, "\n"); $lines[$lineToIgnore] = null; $text = substr($text, 0, $lastMatchOffset); } } } $lines += $this->getLinesToIgnoreForTokenByIgnoreComment($text, $line, '@phpstan-ignore-next-line', \true); } if ($isNextLine || $isCurrentLine) { continue; } } else { if ($isNextLine) { $line++; } if ($isNextLine || $isCurrentLine) { $line += substr_count($token[1], "\n"); $lines[$line] = null; continue; } } $ignorePos = strpos($text, '@phpstan-ignore'); if ($ignorePos === \false) { continue; } $ignoreLine = substr_count(substr($text, 0, $ignorePos), "\n") - 1; if ($previousToken !== null && $previousToken[2] === $line) { try { foreach ($this->parseIdentifiers($text, $ignorePos) as $identifier) { $lines[$line][] = $identifier; } } catch (IgnoreParseException $e) { $errors[] = [$token[2] + $e->getPhpDocLine() + $ignoreLine, $e->getMessage()]; } continue; } $line += substr_count($token[1], "\n"); $pendingToken = [$text, $ignorePos, $token[2] + $ignoreLine, $line]; } if ($pendingToken !== null) { [$pendingText, $pendingIgnorePos, $tokenLine, $pendingLine] = $pendingToken; try { foreach ($this->parseIdentifiers($pendingText, $pendingIgnorePos) as $identifier) { $lines[$pendingLine][] = $identifier; } } catch (IgnoreParseException $e) { $errors[] = [$tokenLine + $e->getPhpDocLine(), $e->getMessage()]; } } $processedErrors = []; foreach ($errors as [$line, $message]) { $processedErrors[$line][] = $message; } return ['lines' => $lines, 'errors' => $processedErrors]; } /** * @return array<int, null> */ private function getLinesToIgnoreForTokenByIgnoreComment(string $tokenText, int $tokenLine, string $ignoreComment, bool $ignoreNextLine = \false) : array { $lines = []; $positionsOfIgnoreComment = []; $offset = 0; while (($pos = strpos($tokenText, $ignoreComment, $offset)) !== \false) { $positionsOfIgnoreComment[] = $pos; $offset = $pos + 1; } foreach ($positionsOfIgnoreComment as $pos) { $line = $tokenLine + substr_count(substr($tokenText, 0, $pos), "\n") + ($ignoreNextLine ? 1 : 0); $lines[$line] = null; } return $lines; } /** * @return non-empty-list<string> * @throws IgnoreParseException */ private function parseIdentifiers(string $text, int $ignorePos) : array { $text = substr($text, $ignorePos + strlen('@phpstan-ignore')); $originalTokens = $this->ignoreLexer->tokenize($text); $tokens = []; foreach ($originalTokens as $originalToken) { if ($originalToken[IgnoreLexer::TYPE_OFFSET] === IgnoreLexer::TOKEN_WHITESPACE) { continue; } $tokens[] = $originalToken; } $c = count($tokens); $identifiers = []; $openParenthesisCount = 0; $expected = [IgnoreLexer::TOKEN_IDENTIFIER]; for ($i = 0; $i < $c; $i++) { $lastTokenTypeLabel = isset($tokenType) ? $this->ignoreLexer->getLabel($tokenType) : '@phpstan-ignore'; [IgnoreLexer::VALUE_OFFSET => $content, IgnoreLexer::TYPE_OFFSET => $tokenType, IgnoreLexer::LINE_OFFSET => $tokenLine] = $tokens[$i]; if ($expected !== null && !in_array($tokenType, $expected, \true)) { $tokenTypeLabel = $this->ignoreLexer->getLabel($tokenType); $otherTokenContent = $tokenType === IgnoreLexer::TOKEN_OTHER ? sprintf(" '%s'", $content) : ''; $expectedLabels = implode(' or ', array_map(function ($token) { return $this->ignoreLexer->getLabel($token); }, $expected)); throw new IgnoreParseException(sprintf('Unexpected %s%s after %s, expected %s', $tokenTypeLabel, $otherTokenContent, $lastTokenTypeLabel, $expectedLabels), $tokenLine); } if ($tokenType === IgnoreLexer::TOKEN_OPEN_PARENTHESIS) { $openParenthesisCount++; $expected = null; continue; } if ($tokenType === IgnoreLexer::TOKEN_CLOSE_PARENTHESIS) { $openParenthesisCount--; if ($openParenthesisCount === 0) { $expected = [IgnoreLexer::TOKEN_COMMA, IgnoreLexer::TOKEN_END]; } continue; } if ($openParenthesisCount > 0) { continue; // waiting for comment end } if ($tokenType === IgnoreLexer::TOKEN_IDENTIFIER) { $identifiers[] = $content; $expected = [IgnoreLexer::TOKEN_COMMA, IgnoreLexer::TOKEN_END, IgnoreLexer::TOKEN_OPEN_PARENTHESIS]; continue; } if ($tokenType === IgnoreLexer::TOKEN_COMMA) { $expected = [IgnoreLexer::TOKEN_IDENTIFIER]; continue; } } if ($openParenthesisCount > 0) { throw new IgnoreParseException('Unexpected end, unclosed opening parenthesis', $tokenLine ?? 1); } if (count($identifiers) === 0) { throw new IgnoreParseException('Missing identifier', 1); } return $identifiers; } } <?php declare (strict_types=1); namespace PHPStan; use Exception; final class ShouldNotHappenException extends Exception { /** @api */ public function __construct(string $message = 'Internal error.') { parent::__construct($message); } } parameters: inferPrivatePropertyTypeFromConstructor: true featureToggles: checkUnresolvableParameterTypes: true services: - class: PHPStan\Testing\TestCaseSourceLocatorFactory arguments: phpParser: @phpParserDecorator php8Parser: @php8PhpParser fileExtensions: %fileExtensions% obsoleteExcludesAnalyse: %excludes_analyse% excludePaths: %excludePaths% cacheStorage: class: PHPStan\Cache\MemoryCacheStorage arguments!: [] currentPhpVersionSimpleParser!: factory: @currentPhpVersionRichParser currentPhpVersionLexer: class: PhpParser\Lexer factory: @PHPStan\Parser\LexerFactory::createEmulative() betterReflectionSourceLocator: class: PHPStan\BetterReflection\SourceLocator\Type\SourceLocator factory: @PHPStan\Testing\TestCaseSourceLocatorFactory::create() autowired: false reflectionProvider: factory: @betterReflectionProvider arguments!: [] autowired: - PHPStan\Reflection\ReflectionProvider <?php declare (strict_types=1); namespace PHPStan\Testing; use Composer\Autoload\ClassLoader; use PhpParser\Parser; use PHPStan\BetterReflection\SourceLocator\Ast\Locator; use PHPStan\BetterReflection\SourceLocator\SourceStubber\PhpStormStubsSourceStubber; use PHPStan\BetterReflection\SourceLocator\SourceStubber\ReflectionSourceStubber; use PHPStan\BetterReflection\SourceLocator\Type\AggregateSourceLocator; use PHPStan\BetterReflection\SourceLocator\Type\EvaledCodeSourceLocator; use PHPStan\BetterReflection\SourceLocator\Type\MemoizingSourceLocator; use PHPStan\BetterReflection\SourceLocator\Type\PhpInternalSourceLocator; use PHPStan\BetterReflection\SourceLocator\Type\SourceLocator; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\BetterReflection\SourceLocator\AutoloadSourceLocator; use PHPStan\Reflection\BetterReflection\SourceLocator\ComposerJsonAndInstalledJsonSourceLocatorMaker; use PHPStan\Reflection\BetterReflection\SourceLocator\FileNodesFetcher; use PHPStan\Reflection\BetterReflection\SourceLocator\PhpVersionBlacklistSourceLocator; use ReflectionClass; use function dirname; use function is_file; use function serialize; use function sha1; final class TestCaseSourceLocatorFactory { /** * @var ComposerJsonAndInstalledJsonSourceLocatorMaker */ private $composerJsonAndInstalledJsonSourceLocatorMaker; /** * @var Parser */ private $phpParser; /** * @var Parser */ private $php8Parser; /** * @var FileNodesFetcher */ private $fileNodesFetcher; /** * @var PhpStormStubsSourceStubber */ private $phpstormStubsSourceStubber; /** * @var ReflectionSourceStubber */ private $reflectionSourceStubber; /** * @var PhpVersion */ private $phpVersion; /** * @var string[] */ private $fileExtensions; /** * @var string[] */ private $obsoleteExcludesAnalyse; /** * @var array{analyse?: array<int, string>, analyseAndScan?: array<int, string>}|null */ private $excludePaths; /** @var array<string, list<SourceLocator>> */ private static $composerSourceLocatorsCache = []; /** * @param string[] $fileExtensions * @param string[] $obsoleteExcludesAnalyse * @param array{analyse?: array<int, string>, analyseAndScan?: array<int, string>}|null $excludePaths */ public function __construct(ComposerJsonAndInstalledJsonSourceLocatorMaker $composerJsonAndInstalledJsonSourceLocatorMaker, Parser $phpParser, Parser $php8Parser, FileNodesFetcher $fileNodesFetcher, PhpStormStubsSourceStubber $phpstormStubsSourceStubber, ReflectionSourceStubber $reflectionSourceStubber, PhpVersion $phpVersion, array $fileExtensions, array $obsoleteExcludesAnalyse, ?array $excludePaths) { $this->composerJsonAndInstalledJsonSourceLocatorMaker = $composerJsonAndInstalledJsonSourceLocatorMaker; $this->phpParser = $phpParser; $this->php8Parser = $php8Parser; $this->fileNodesFetcher = $fileNodesFetcher; $this->phpstormStubsSourceStubber = $phpstormStubsSourceStubber; $this->reflectionSourceStubber = $reflectionSourceStubber; $this->phpVersion = $phpVersion; $this->fileExtensions = $fileExtensions; $this->obsoleteExcludesAnalyse = $obsoleteExcludesAnalyse; $this->excludePaths = $excludePaths; } public function create() : SourceLocator { $classLoaders = ClassLoader::getRegisteredLoaders(); $classLoaderReflection = new ReflectionClass(ClassLoader::class); $cacheKey = sha1(serialize([$this->phpVersion->getVersionId(), $this->fileExtensions, $this->obsoleteExcludesAnalyse, $this->excludePaths])); if ($classLoaderReflection->hasProperty('vendorDir') && !isset(self::$composerSourceLocatorsCache[$cacheKey])) { $composerLocators = []; $vendorDirProperty = $classLoaderReflection->getProperty('vendorDir'); $vendorDirProperty->setAccessible(\true); foreach ($classLoaders as $classLoader) { $composerProjectPath = dirname($vendorDirProperty->getValue($classLoader)); if (!is_file($composerProjectPath . '/composer.json')) { continue; } $composerSourceLocator = $this->composerJsonAndInstalledJsonSourceLocatorMaker->create($composerProjectPath); if ($composerSourceLocator === null) { continue; } $composerLocators[] = $composerSourceLocator; } self::$composerSourceLocatorsCache[$cacheKey] = $composerLocators; } $locators = self::$composerSourceLocatorsCache[$cacheKey] ?? []; $astLocator = new Locator($this->phpParser); $astPhp8Locator = new Locator($this->php8Parser); $locators[] = new PhpInternalSourceLocator($astPhp8Locator, $this->phpstormStubsSourceStubber); $locators[] = new AutoloadSourceLocator($this->fileNodesFetcher, \true); $locators[] = new PhpVersionBlacklistSourceLocator(new PhpInternalSourceLocator($astLocator, $this->reflectionSourceStubber), $this->phpstormStubsSourceStubber); $locators[] = new PhpVersionBlacklistSourceLocator(new EvaledCodeSourceLocator($astLocator, $this->reflectionSourceStubber), $this->phpstormStubsSourceStubber); return new MemoizingSourceLocator(new AggregateSourceLocator($locators)); } } <?php declare (strict_types=1); namespace PHPStan\Testing; use PHPStan\Analyser\ConstantResolver; use PHPStan\Analyser\DirectInternalScopeFactory; use PHPStan\Analyser\Error; use PHPStan\Analyser\MutatingScope; use PHPStan\Analyser\NodeScopeResolver; use PHPStan\Analyser\RicherScopeGetTypeHelper; use PHPStan\Analyser\ScopeFactory; use PHPStan\Analyser\TypeSpecifier; use PHPStan\BetterReflection\Reflector\ClassReflector; use PHPStan\BetterReflection\Reflector\ConstantReflector; use PHPStan\BetterReflection\Reflector\FunctionReflector; use PHPStan\BetterReflection\Reflector\Reflector; use PHPStan\Broker\Broker; use PHPStan\DependencyInjection\Container; use PHPStan\DependencyInjection\ContainerFactory; use PHPStan\DependencyInjection\Reflection\ClassReflectionExtensionRegistryProvider; use PHPStan\DependencyInjection\Type\DynamicReturnTypeExtensionRegistryProvider; use PHPStan\DependencyInjection\Type\ExpressionTypeResolverExtensionRegistryProvider; use PHPStan\DependencyInjection\Type\OperatorTypeSpecifyingExtensionRegistryProvider; use PHPStan\File\FileHelper; use PHPStan\Internal\DirectoryCreator; use PHPStan\Internal\DirectoryCreatorException; use PHPStan\Node\Printer\ExprPrinter; use PHPStan\Parser\Parser; use PHPStan\Php\PhpVersion; use PHPStan\PhpDoc\TypeNodeResolver; use PHPStan\PhpDoc\TypeStringResolver; use PHPStan\Reflection\InitializerExprTypeResolver; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Reflection\ReflectionProvider\DirectReflectionProviderProvider; use PHPStan\Rules\Properties\PropertyReflectionFinder; use PHPStan\Type\Constant\OversizedArrayBuilder; use PHPStan\Type\TypeAliasResolver; use PHPStan\Type\UsefulTypeAliasResolver; use PHPUnit\Framework\ExpectationFailedException; use PHPUnit\Framework\TestCase; use function array_merge; use function count; use function implode; use function rtrim; use function sha1; use function sprintf; use function sys_get_temp_dir; use const DIRECTORY_SEPARATOR; use const PHP_VERSION_ID; /** @api */ abstract class PHPStanTestCase extends TestCase { /** @deprecated *@var bool */ public static $useStaticReflectionProvider = \true; /** @var array<string, Container> */ private static $containers = []; /** @api */ public static function getContainer() : Container { $additionalConfigFiles = static::getAdditionalConfigFiles(); $additionalConfigFiles[] = __DIR__ . '/TestCase.neon'; $cacheKey = sha1(implode("\n", $additionalConfigFiles)); if (!isset(self::$containers[$cacheKey])) { $tmpDir = sys_get_temp_dir() . '/phpstan-tests'; try { DirectoryCreator::ensureDirectoryExists($tmpDir, 0777); } catch (DirectoryCreatorException $e) { self::fail($e->getMessage()); } $rootDir = __DIR__ . '/../..'; $fileHelper = new FileHelper($rootDir); $rootDir = $fileHelper->normalizePath($rootDir, '/'); $containerFactory = new ContainerFactory($rootDir); $container = $containerFactory->create($tmpDir, array_merge([$containerFactory->getConfigDirectory() . '/config.level8.neon'], $additionalConfigFiles), []); self::$containers[$cacheKey] = $container; foreach ($container->getParameter('bootstrapFiles') as $bootstrapFile) { (static function (string $file) use($container) : void { require_once $file; })($bootstrapFile); } if (PHP_VERSION_ID >= 80000) { require_once __DIR__ . '/../../stubs/runtime/Enum/UnitEnum.php'; require_once __DIR__ . '/../../stubs/runtime/Enum/BackedEnum.php'; require_once __DIR__ . '/../../stubs/runtime/Enum/ReflectionEnum.php'; require_once __DIR__ . '/../../stubs/runtime/Enum/ReflectionEnumUnitCase.php'; require_once __DIR__ . '/../../stubs/runtime/Enum/ReflectionEnumBackedCase.php'; } } else { ContainerFactory::postInitializeContainer(self::$containers[$cacheKey]); } return self::$containers[$cacheKey]; } /** * @return string[] */ public static function getAdditionalConfigFiles() : array { return []; } public static function getParser() : Parser { /** @var Parser $parser */ $parser = self::getContainer()->getService('defaultAnalysisParser'); return $parser; } /** * @api * @deprecated Use createReflectionProvider() instead */ public function createBroker() : Broker { return self::getContainer()->getByType(Broker::class); } /** @api */ public static function createReflectionProvider() : ReflectionProvider { return self::getContainer()->getByType(ReflectionProvider::class); } public static function getReflector() : Reflector { return self::getContainer()->getService('betterReflectionReflector'); } /** * @deprecated Use getReflector() instead. * @return array{ClassReflector, FunctionReflector, ConstantReflector} */ public static function getReflectors() : array { return [self::getContainer()->getService('betterReflectionClassReflector'), self::getContainer()->getService('betterReflectionFunctionReflector'), self::getContainer()->getService('betterReflectionConstantReflector')]; } public static function getClassReflectionExtensionRegistryProvider() : ClassReflectionExtensionRegistryProvider { return self::getContainer()->getByType(ClassReflectionExtensionRegistryProvider::class); } /** * @param string[] $dynamicConstantNames */ public static function createScopeFactory(ReflectionProvider $reflectionProvider, TypeSpecifier $typeSpecifier, array $dynamicConstantNames = []) : ScopeFactory { $container = self::getContainer(); if (count($dynamicConstantNames) === 0) { $dynamicConstantNames = $container->getParameter('dynamicConstantNames'); } $reflectionProviderProvider = new DirectReflectionProviderProvider($reflectionProvider); $constantResolver = new ConstantResolver($reflectionProviderProvider, $dynamicConstantNames); $initializerExprTypeResolver = new InitializerExprTypeResolver($constantResolver, $reflectionProviderProvider, $container->getByType(PhpVersion::class), $container->getByType(OperatorTypeSpecifyingExtensionRegistryProvider::class), new OversizedArrayBuilder(), $container->getParameter('usePathConstantsAsConstantString')); return new ScopeFactory(new DirectInternalScopeFactory(MutatingScope::class, $reflectionProvider, $initializerExprTypeResolver, $container->getByType(DynamicReturnTypeExtensionRegistryProvider::class), $container->getByType(ExpressionTypeResolverExtensionRegistryProvider::class), $container->getByType(ExprPrinter::class), $typeSpecifier, new PropertyReflectionFinder(), self::getParser(), $container->getByType(NodeScopeResolver::class), new RicherScopeGetTypeHelper($initializerExprTypeResolver), $container->getByType(PhpVersion::class), $container->getParameter('featureToggles')['explicitMixedInUnknownGenericNew'], $container->getParameter('featureToggles')['explicitMixedForGlobalVariables'], $constantResolver)); } /** * @param array<string, string> $globalTypeAliases */ public static function createTypeAliasResolver(array $globalTypeAliases, ReflectionProvider $reflectionProvider) : TypeAliasResolver { $container = self::getContainer(); return new UsefulTypeAliasResolver($globalTypeAliases, $container->getByType(TypeStringResolver::class), $container->getByType(TypeNodeResolver::class), $reflectionProvider); } protected function shouldTreatPhpDocTypesAsCertain() : bool { return \true; } public static function getFileHelper() : FileHelper { return self::getContainer()->getByType(FileHelper::class); } /** * Provides a DIRECTORY_SEPARATOR agnostic assertion helper, to compare file paths. * */ protected function assertSamePaths(string $expected, string $actual, string $message = '') : void { $expected = $this->getFileHelper()->normalizePath($expected); $actual = $this->getFileHelper()->normalizePath($actual); $this->assertSame($expected, $actual, $message); } /** * @param Error[]|string[] $errors */ protected function assertNoErrors(array $errors) : void { try { $this->assertCount(0, $errors); } catch (ExpectationFailedException $e) { $messages = []; foreach ($errors as $error) { if ($error instanceof Error) { $messages[] = sprintf("- %s\n in %s on line %d\n", rtrim($error->getMessage(), '.'), $error->getFile(), $error->getLine()); } else { $messages[] = $error; } } $this->fail($e->getMessage() . "\n\nEmitted errors:\n" . implode("\n", $messages)); } } protected function skipIfNotOnWindows() : void { if (DIRECTORY_SEPARATOR === '\\') { return; } self::markTestSkipped(); } protected function skipIfNotOnUnix() : void { if (DIRECTORY_SEPARATOR === '/') { return; } self::markTestSkipped(); } } <?php declare (strict_types=1); namespace PHPStan\Testing; use PhpParser\Node; use PHPStan\Analyser\Analyser; use PHPStan\Analyser\AnalyserResultFinalizer; use PHPStan\Analyser\Error; use PHPStan\Analyser\FileAnalyser; use PHPStan\Analyser\InternalError; use PHPStan\Analyser\LocalIgnoresProcessor; use PHPStan\Analyser\NodeScopeResolver; use PHPStan\Analyser\RuleErrorTransformer; use PHPStan\Analyser\TypeSpecifier; use PHPStan\Collectors\Collector; use PHPStan\Collectors\Registry as CollectorRegistry; use PHPStan\Dependency\DependencyResolver; use PHPStan\DependencyInjection\Type\DynamicThrowTypeExtensionProvider; use PHPStan\DependencyInjection\Type\ParameterClosureTypeExtensionProvider; use PHPStan\DependencyInjection\Type\ParameterOutTypeExtensionProvider; use PHPStan\File\FileHelper; use PHPStan\Php\PhpVersion; use PHPStan\PhpDoc\PhpDocInheritanceResolver; use PHPStan\PhpDoc\StubPhpDocProvider; use PHPStan\Reflection\InitializerExprTypeResolver; use PHPStan\Reflection\SignatureMap\SignatureMapProvider; use PHPStan\Rules\DirectRegistry as DirectRuleRegistry; use PHPStan\Rules\Properties\DirectReadWritePropertiesExtensionProvider; use PHPStan\Rules\Properties\ReadWritePropertiesExtension; use PHPStan\Rules\Properties\ReadWritePropertiesExtensionProvider; use PHPStan\Rules\Rule; use PHPStan\Type\FileTypeMapper; use function array_map; use function count; use function implode; use function sprintf; /** * @api * @template TRule of Rule */ abstract class RuleTestCase extends \PHPStan\Testing\PHPStanTestCase { /** * @var ?Analyser */ private $analyser = null; /** * @return TRule */ protected abstract function getRule() : Rule; /** * @return array<Collector<Node, mixed>> */ protected function getCollectors() : array { return []; } /** * @return ReadWritePropertiesExtension[] */ protected function getReadWritePropertiesExtensions() : array { return []; } protected function getTypeSpecifier() : TypeSpecifier { return self::getContainer()->getService('typeSpecifier'); } private function getAnalyser(DirectRuleRegistry $ruleRegistry) : Analyser { if ($this->analyser === null) { $collectorRegistry = new CollectorRegistry($this->getCollectors()); $reflectionProvider = $this->createReflectionProvider(); $typeSpecifier = $this->getTypeSpecifier(); $readWritePropertiesExtensions = $this->getReadWritePropertiesExtensions(); $nodeScopeResolver = new NodeScopeResolver($reflectionProvider, self::getContainer()->getByType(InitializerExprTypeResolver::class), self::getReflector(), self::getClassReflectionExtensionRegistryProvider(), self::getContainer()->getByType(ParameterOutTypeExtensionProvider::class), $this->getParser(), self::getContainer()->getByType(FileTypeMapper::class), self::getContainer()->getByType(StubPhpDocProvider::class), self::getContainer()->getByType(PhpVersion::class), self::getContainer()->getByType(SignatureMapProvider::class), self::getContainer()->getByType(PhpDocInheritanceResolver::class), self::getContainer()->getByType(FileHelper::class), $typeSpecifier, self::getContainer()->getByType(DynamicThrowTypeExtensionProvider::class), $readWritePropertiesExtensions !== [] ? new DirectReadWritePropertiesExtensionProvider($readWritePropertiesExtensions) : self::getContainer()->getByType(ReadWritePropertiesExtensionProvider::class), self::getContainer()->getByType(ParameterClosureTypeExtensionProvider::class), self::createScopeFactory($reflectionProvider, $typeSpecifier), $this->shouldPolluteScopeWithLoopInitialAssignments(), $this->shouldPolluteScopeWithAlwaysIterableForeach(), [], [], self::getContainer()->getParameter('universalObjectCratesClasses'), self::getContainer()->getParameter('exceptions')['implicitThrows'], $this->shouldTreatPhpDocTypesAsCertain(), self::getContainer()->getParameter('featureToggles')['detectDeadTypeInMultiCatch'], self::getContainer()->getParameter('featureToggles')['paramOutType'], self::getContainer()->getParameter('featureToggles')['preciseMissingReturn'], self::getContainer()->getParameter('featureToggles')['explicitThrow']); $fileAnalyser = new FileAnalyser($this->createScopeFactory($reflectionProvider, $typeSpecifier), $nodeScopeResolver, $this->getParser(), self::getContainer()->getByType(DependencyResolver::class), new RuleErrorTransformer(), new LocalIgnoresProcessor()); $this->analyser = new Analyser($fileAnalyser, $ruleRegistry, $collectorRegistry, $nodeScopeResolver, 50); } return $this->analyser; } /** * @param string[] $files * @param list<array{0: string, 1: int, 2?: string|null}> $expectedErrors */ public function analyse(array $files, array $expectedErrors) : void { $actualErrors = $this->gatherAnalyserErrors($files); $strictlyTypedSprintf = static function (int $line, string $message, ?string $tip) : string { $message = sprintf('%02d: %s', $line, $message); if ($tip !== null) { $message .= "\n 💡 " . $tip; } return $message; }; $expectedErrors = array_map(static function (array $error) use($strictlyTypedSprintf) : string { return $strictlyTypedSprintf($error[1], $error[0], $error[2] ?? null); }, $expectedErrors); $actualErrors = array_map(static function (Error $error) use($strictlyTypedSprintf) : string { $line = $error->getLine(); if ($line === null) { return $strictlyTypedSprintf(-1, $error->getMessage(), $error->getTip()); } return $strictlyTypedSprintf($line, $error->getMessage(), $error->getTip()); }, $actualErrors); $this->assertSame(implode("\n", $expectedErrors) . "\n", implode("\n", $actualErrors) . "\n"); } /** * @param string[] $files * @return list<Error> */ public function gatherAnalyserErrors(array $files) : array { $ruleRegistry = new DirectRuleRegistry([$this->getRule()]); $files = array_map([$this->getFileHelper(), 'normalizePath'], $files); $analyserResult = $this->getAnalyser($ruleRegistry)->analyse($files, null, null, \true); if (count($analyserResult->getInternalErrors()) > 0) { $this->fail(implode("\n", array_map(static function (InternalError $internalError) { return $internalError->getMessage(); }, $analyserResult->getInternalErrors()))); } if ($this->shouldFailOnPhpErrors() && count($analyserResult->getAllPhpErrors()) > 0) { $this->fail(implode("\n", array_map(static function (Error $error) : string { return sprintf('%s on %s:%d', $error->getMessage(), $error->getFile(), $error->getLine()); }, $analyserResult->getAllPhpErrors()))); } $finalizer = new AnalyserResultFinalizer($ruleRegistry, new RuleErrorTransformer(), $this->createScopeFactory($this->createReflectionProvider(), $this->getTypeSpecifier()), new LocalIgnoresProcessor(), \true); return $finalizer->finalize($analyserResult, \false, \true)->getAnalyserResult()->getUnorderedErrors(); } protected function shouldPolluteScopeWithLoopInitialAssignments() : bool { return \false; } protected function shouldPolluteScopeWithAlwaysIterableForeach() : bool { return \true; } protected function shouldFailOnPhpErrors() : bool { return \true; } public static function getAdditionalConfigFiles() : array { return [__DIR__ . '/../../conf/bleedingEdge.neon']; } } <?php declare (strict_types=1); namespace PHPStan\Testing; use PhpParser\Node; use PhpParser\Node\Expr\StaticCall; use PhpParser\Node\Name; use PHPStan\Analyser\NodeScopeResolver; use PHPStan\Analyser\Scope; use PHPStan\Analyser\ScopeContext; use PHPStan\DependencyInjection\Type\DynamicThrowTypeExtensionProvider; use PHPStan\DependencyInjection\Type\ParameterClosureTypeExtensionProvider; use PHPStan\DependencyInjection\Type\ParameterOutTypeExtensionProvider; use PHPStan\File\FileHelper; use PHPStan\File\SystemAgnosticSimpleRelativePathHelper; use PHPStan\Php\PhpVersion; use PHPStan\PhpDoc\PhpDocInheritanceResolver; use PHPStan\PhpDoc\StubPhpDocProvider; use PHPStan\Reflection\InitializerExprTypeResolver; use PHPStan\Reflection\SignatureMap\SignatureMapProvider; use PHPStan\Rules\Properties\ReadWritePropertiesExtensionProvider; use PHPStan\TrinaryLogic; use PHPStan\Type\ConstantScalarType; use PHPStan\Type\FileTypeMapper; use PHPStan\Type\Type; use PHPStan\Type\VerbosityLevel; use _PHPStan_7d8742a37\Symfony\Component\Finder\Finder; use function array_map; use function array_merge; use function count; use function fclose; use function fgets; use function fopen; use function in_array; use function is_dir; use function is_string; use function preg_match; use function sprintf; use function stripos; use function strpos; use function strtolower; use function version_compare; use const PHP_VERSION; /** @api */ abstract class TypeInferenceTestCase extends \PHPStan\Testing\PHPStanTestCase { /** * @param callable(Node , Scope ): void $callback * @param string[] $dynamicConstantNames */ public static function processFile(string $file, callable $callback, array $dynamicConstantNames = []) : void { $reflectionProvider = self::createReflectionProvider(); $typeSpecifier = self::getContainer()->getService('typeSpecifier'); $fileHelper = self::getContainer()->getByType(FileHelper::class); $resolver = new NodeScopeResolver($reflectionProvider, self::getContainer()->getByType(InitializerExprTypeResolver::class), self::getReflector(), self::getClassReflectionExtensionRegistryProvider(), self::getContainer()->getByType(ParameterOutTypeExtensionProvider::class), self::getParser(), self::getContainer()->getByType(FileTypeMapper::class), self::getContainer()->getByType(StubPhpDocProvider::class), self::getContainer()->getByType(PhpVersion::class), self::getContainer()->getByType(SignatureMapProvider::class), self::getContainer()->getByType(PhpDocInheritanceResolver::class), self::getContainer()->getByType(FileHelper::class), $typeSpecifier, self::getContainer()->getByType(DynamicThrowTypeExtensionProvider::class), self::getContainer()->getByType(ReadWritePropertiesExtensionProvider::class), self::getContainer()->getByType(ParameterClosureTypeExtensionProvider::class), self::createScopeFactory($reflectionProvider, $typeSpecifier), self::getContainer()->getParameter('polluteScopeWithLoopInitialAssignments'), self::getContainer()->getParameter('polluteScopeWithAlwaysIterableForeach'), static::getEarlyTerminatingMethodCalls(), static::getEarlyTerminatingFunctionCalls(), self::getContainer()->getParameter('universalObjectCratesClasses'), self::getContainer()->getParameter('exceptions')['implicitThrows'], self::getContainer()->getParameter('treatPhpDocTypesAsCertain'), self::getContainer()->getParameter('featureToggles')['detectDeadTypeInMultiCatch'], self::getContainer()->getParameter('featureToggles')['paramOutType'], self::getContainer()->getParameter('featureToggles')['preciseMissingReturn'], self::getContainer()->getParameter('featureToggles')['explicitThrow']); $resolver->setAnalysedFiles(array_map(static function (string $file) use($fileHelper) : string { return $fileHelper->normalizePath($file); }, array_merge([$file], static::getAdditionalAnalysedFiles()))); $scopeFactory = self::createScopeFactory($reflectionProvider, $typeSpecifier, $dynamicConstantNames); $scope = $scopeFactory->create(ScopeContext::create($file)); $resolver->processNodes(self::getParser()->parseFile($file), $scope, $callback); } /** * @api * @param mixed ...$args */ public function assertFileAsserts(string $assertType, string $file, ...$args) : void { if ($assertType === 'type') { if ($args[0] instanceof Type) { // backward compatibility $expectedType = $args[0]; $this->assertInstanceOf(ConstantScalarType::class, $expectedType); $expected = $expectedType->getValue(); $actualType = $args[1]; $actual = $actualType->describe(VerbosityLevel::precise()); } else { $expected = $args[0]; $actual = $args[1]; } $this->assertSame($expected, $actual, sprintf('Expected type %s, got type %s in %s on line %d.', $expected, $actual, $file, $args[2])); } elseif ($assertType === 'variableCertainty') { $expectedCertainty = $args[0]; $actualCertainty = $args[1]; $variableName = $args[2]; $this->assertTrue($expectedCertainty->equals($actualCertainty), sprintf('Expected %s, actual certainty of %s is %s in %s on line %d.', $expectedCertainty->describe(), $variableName, $actualCertainty->describe(), $file, $args[3])); } } /** * @api * @return array<string, mixed[]> */ public static function gatherAssertTypes(string $file) : array { $fileHelper = self::getContainer()->getByType(FileHelper::class); $relativePathHelper = new SystemAgnosticSimpleRelativePathHelper($fileHelper); $file = $fileHelper->normalizePath($file); $asserts = []; self::processFile($file, static function (Node $node, Scope $scope) use(&$asserts, $file, $relativePathHelper) : void { if (!$node instanceof Node\Expr\FuncCall) { return; } $nameNode = $node->name; if (!$nameNode instanceof Name) { return; } $functionName = $nameNode->toString(); if (in_array(strtolower($functionName), ['asserttype', 'assertnativetype', 'assertvariablecertainty'], \true)) { self::fail(sprintf('Missing use statement for %s() in %s on line %d.', $functionName, $relativePathHelper->getRelativePath($file), $node->getStartLine())); } elseif ($functionName === 'PHPStan\\Testing\\assertType') { $expectedType = $scope->getType($node->getArgs()[0]->value); if (!$expectedType instanceof ConstantScalarType) { self::fail(sprintf('Expected type must be a literal string, %s given in %s on line %d.', $expectedType->describe(VerbosityLevel::precise()), $relativePathHelper->getRelativePath($file), $node->getLine())); } $actualType = $scope->getType($node->getArgs()[1]->value); $assert = ['type', $file, $expectedType->getValue(), $actualType->describe(VerbosityLevel::precise()), $node->getStartLine()]; } elseif ($functionName === 'PHPStan\\Testing\\assertNativeType') { $expectedType = $scope->getType($node->getArgs()[0]->value); if (!$expectedType instanceof ConstantScalarType) { self::fail(sprintf('Expected type must be a literal string, %s given in %s on line %d.', $expectedType->describe(VerbosityLevel::precise()), $relativePathHelper->getRelativePath($file), $node->getLine())); } $actualType = $scope->getNativeType($node->getArgs()[1]->value); $assert = ['type', $file, $expectedType->getValue(), $actualType->describe(VerbosityLevel::precise()), $node->getStartLine()]; } elseif ($functionName === 'PHPStan\\Testing\\assertVariableCertainty') { $certainty = $node->getArgs()[0]->value; if (!$certainty instanceof StaticCall) { self::fail(sprintf('First argument of %s() must be TrinaryLogic call', $functionName)); } if (!$certainty->class instanceof Node\Name) { self::fail(sprintf('ERROR: Invalid TrinaryLogic call.')); } if ($certainty->class->toString() !== 'PHPStan\\TrinaryLogic') { self::fail(sprintf('ERROR: Invalid TrinaryLogic call.')); } if (!$certainty->name instanceof Node\Identifier) { self::fail(sprintf('ERROR: Invalid TrinaryLogic call.')); } // @phpstan-ignore staticMethod.dynamicName $expectedertaintyValue = TrinaryLogic::{$certainty->name->toString()}(); $variable = $node->getArgs()[1]->value; if ($variable instanceof Node\Expr\Variable && is_string($variable->name)) { $actualCertaintyValue = $scope->hasVariableType($variable->name); $variableDescription = sprintf('variable $%s', $variable->name); } elseif ($variable instanceof Node\Expr\ArrayDimFetch && $variable->dim !== null) { $offset = $scope->getType($variable->dim); $actualCertaintyValue = $scope->getType($variable->var)->hasOffsetValueType($offset); $variableDescription = sprintf('offset %s', $offset->describe(VerbosityLevel::precise())); } else { self::fail(sprintf('ERROR: Invalid assertVariableCertainty call.')); } $assert = ['variableCertainty', $file, $expectedertaintyValue, $actualCertaintyValue, $variableDescription, $node->getStartLine()]; } else { $correctFunction = null; $assertFunctions = ['assertType' => 'PHPStan\\Testing\\assertType', 'assertNativeType' => 'PHPStan\\Testing\\assertNativeType', 'assertVariableCertainty' => 'PHPStan\\Testing\\assertVariableCertainty']; foreach ($assertFunctions as $assertFn => $fqFunctionName) { if (stripos($functionName, $assertFn) === \false) { continue; } $correctFunction = $fqFunctionName; } if ($correctFunction === null) { return; } self::fail(sprintf('Function %s imported with wrong namespace %s called in %s on line %d.', $correctFunction, $functionName, $relativePathHelper->getRelativePath($file), $node->getStartLine())); } if (count($node->getArgs()) !== 2) { self::fail(sprintf('ERROR: Wrong %s() call in %s on line %d.', $functionName, $relativePathHelper->getRelativePath($file), $node->getStartLine())); } $asserts[$file . ':' . $node->getStartLine()] = $assert; }); if (count($asserts) === 0) { self::fail(sprintf('File %s does not contain any asserts', $file)); } return $asserts; } /** * @api * @return array<string, mixed[]> */ public static function gatherAssertTypesFromDirectory(string $directory) : array { $asserts = []; foreach (self::findTestDataFilesFromDirectory($directory) as $path) { foreach (self::gatherAssertTypes($path) as $key => $assert) { $asserts[$key] = $assert; } } return $asserts; } /** * @return list<string> */ public static function findTestDataFilesFromDirectory(string $directory) : array { if (!is_dir($directory)) { self::fail(sprintf('Directory %s does not exist.', $directory)); } $finder = new Finder(); $finder->followLinks(); $files = []; foreach ($finder->files()->name('*.php')->in($directory) as $fileInfo) { $path = $fileInfo->getPathname(); if (self::isFileLintSkipped($path)) { continue; } $files[] = $path; } return $files; } /** * From https://github.com/php-parallel-lint/PHP-Parallel-Lint/blob/0c2706086ac36dce31967cb36062ff8915fe03f7/bin/skip-linting.php * * Copyright (c) 2012, Jakub Onderka */ private static function isFileLintSkipped(string $file) : bool { $f = @fopen($file, 'r'); if ($f !== \false) { $firstLine = fgets($f); if ($firstLine === \false) { return \false; } // ignore shebang line if (strpos($firstLine, '#!') === 0) { $firstLine = fgets($f); if ($firstLine === \false) { return \false; } } @fclose($f); if (preg_match('~<?php\\s*\\/\\/\\s*lint\\s*([^\\d\\s]+)\\s*([^\\s]+)\\s*~i', $firstLine, $m) === 1) { return version_compare(PHP_VERSION, $m[2], $m[1]) === \false; } } return \false; } /** @return string[] */ protected static function getAdditionalAnalysedFiles() : array { return []; } /** @return string[][] */ protected static function getEarlyTerminatingMethodCalls() : array { return []; } /** @return string[] */ protected static function getEarlyTerminatingFunctionCalls() : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Testing; use _PHPStan_7d8742a37\Nette\Utils\Json; use _PHPStan_7d8742a37\Nette\Utils\JsonException; use PHPStan\File\FileHelper; use PHPStan\File\FileWriter; use PHPStan\ShouldNotHappenException; use PHPUnit\Framework\AssertionFailedError; use PHPUnit\Framework\TestCase; use function array_merge; use function count; use function escapeshellarg; use function escapeshellcmd; use function exec; use function implode; use function method_exists; use function putenv; use function range; use function sprintf; use function unlink; use const DIRECTORY_SEPARATOR; use const PHP_BINARY; /** @api */ abstract class LevelsTestCase extends TestCase { /** * @return array<array<string>> */ public abstract function dataTopics() : array; public abstract function getDataPath() : string; public abstract function getPhpStanExecutablePath() : string; public abstract function getPhpStanConfigPath() : ?string; protected function getResultSuffix() : string { return ''; } protected function shouldAutoloadAnalysedFile() : bool { return \true; } /** * @dataProvider dataTopics */ public function testLevels(string $topic) : void { $file = sprintf('%s' . DIRECTORY_SEPARATOR . '%s.php', $this->getDataPath(), $topic); $command = escapeshellcmd($this->getPhpStanExecutablePath()); $configPath = $this->getPhpStanConfigPath(); $fileHelper = new FileHelper(__DIR__ . '/../..'); $previousMessages = []; $exceptions = []; exec(sprintf('%s %s clear-result-cache %s 2>&1', escapeshellarg(PHP_BINARY), $command, $configPath !== null ? '--configuration ' . escapeshellarg($configPath) : ''), $clearResultCacheOutputLines, $clearResultCacheExitCode); if ($clearResultCacheExitCode !== 0) { throw new ShouldNotHappenException('Could not clear result cache: ' . implode("\n", $clearResultCacheOutputLines)); } putenv('__PHPSTAN_FORCE_VALIDATE_STUB_FILES=1'); foreach (range(0, 9) as $level) { unset($outputLines); exec(sprintf('%s %s analyse --no-progress --error-format=prettyJson --level=%d %s %s %s', escapeshellarg(PHP_BINARY), $command, $level, $configPath !== null ? '--configuration ' . escapeshellarg($configPath) : '', $this->shouldAutoloadAnalysedFile() ? sprintf('--autoload-file %s', escapeshellarg($file)) : '', escapeshellarg($file)), $outputLines); $output = implode("\n", $outputLines); try { $actualJson = Json::decode($output, Json::FORCE_ARRAY); } catch (JsonException $e) { throw new JsonException(sprintf('Cannot decode: %s', $output)); } if (count($actualJson['files']) > 0) { $normalizedFilePath = $fileHelper->normalizePath($file); if (!isset($actualJson['files'][$normalizedFilePath])) { $messagesBeforeDiffing = []; } else { $messagesBeforeDiffing = $actualJson['files'][$normalizedFilePath]['messages']; } foreach ($this->getAdditionalAnalysedFiles() as $additionalAnalysedFile) { $normalizedAdditionalFilePath = $fileHelper->normalizePath($additionalAnalysedFile); if (!isset($actualJson['files'][$normalizedAdditionalFilePath])) { continue; } $messagesBeforeDiffing = array_merge($messagesBeforeDiffing, $actualJson['files'][$normalizedAdditionalFilePath]['messages']); } } else { $messagesBeforeDiffing = []; } $messages = []; foreach ($messagesBeforeDiffing as $message) { foreach ($previousMessages as $lastMessage) { if ($message['message'] === $lastMessage['message'] && $message['line'] === $lastMessage['line']) { continue 2; } } unset($message['tip']); unset($message['identifier']); $messages[] = $message; } $missingMessages = []; foreach ($previousMessages as $previousMessage) { foreach ($messagesBeforeDiffing as $message) { if ($previousMessage['message'] === $message['message'] && $previousMessage['line'] === $message['line']) { continue 2; } } unset($previousMessage['tip']); $missingMessages[] = $previousMessage; } $previousMessages = array_merge($previousMessages, $messages); $expectedJsonFile = sprintf('%s/%s-%d%s.json', $this->getDataPath(), $topic, $level, $this->getResultSuffix()); $exception = $this->compareFiles($expectedJsonFile, $messages); if ($exception !== null) { $exceptions[] = $exception; } $expectedJsonMissingFile = sprintf('%s/%s-%d-missing%s.json', $this->getDataPath(), $topic, $level, $this->getResultSuffix()); $exception = $this->compareFiles($expectedJsonMissingFile, $missingMessages); if ($exception === null) { continue; } $exceptions[] = $exception; } if (count($exceptions) > 0) { throw $exceptions[0]; } } /** * @return string[] */ public function getAdditionalAnalysedFiles() : array { return []; } /** * @param string[] $expectedMessages */ private function compareFiles(string $expectedJsonFile, array $expectedMessages) : ?AssertionFailedError { if (count($expectedMessages) === 0) { try { self::ourCustomAssertFileDoesNotExist($expectedJsonFile); return null; } catch (AssertionFailedError $e) { unlink($expectedJsonFile); return $e; } } $actualOutput = Json::encode($expectedMessages, Json::PRETTY); try { $this->assertJsonStringEqualsJsonFile($expectedJsonFile, $actualOutput); } catch (AssertionFailedError $e) { FileWriter::write($expectedJsonFile, $actualOutput); return $e; } return null; } public static function ourCustomAssertFileDoesNotExist(string $filename, string $message = '') : void { // this method is no longer called assertFileDoesNotExist because this method is final in PHPUnit 10 if (!method_exists(parent::class, 'assertFileDoesNotExist')) { parent::assertFileNotExists($filename, $message); return; } parent::assertFileDoesNotExist($filename, $message); } } <?php declare (strict_types=1); namespace PHPStan\Testing; use PHPStan\TrinaryLogic; /** * Asserts the static type of a value. * * @phpstan-pure * @param mixed $value * @return mixed * * @throws void */ function assertType(string $type, $value) { return null; } /** * Asserts the static type of a value. * * The difference from assertType() is that it doesn't resolve * method/function parameter phpDocs. * * @phpstan-pure * @param mixed $value * @return mixed * * @throws void */ function assertNativeType(string $type, $value) { return null; } /** * @phpstan-pure * @param mixed $variable * @return mixed * * @throws void */ function assertVariableCertainty(TrinaryLogic $certainty, $variable) { return null; } <?php declare (strict_types=1); namespace PHPStan\Testing; use PHPStan\Analyser\Error; use PHPStan\Command\AnalysisResult; use PHPStan\Command\ErrorsConsoleStyle; use PHPStan\Command\Output; use PHPStan\Command\Symfony\SymfonyOutput; use PHPStan\Command\Symfony\SymfonyStyle; use PHPStan\ShouldNotHappenException; use _PHPStan_7d8742a37\Symfony\Component\Console\Input\StringInput; use _PHPStan_7d8742a37\Symfony\Component\Console\Output\StreamOutput; use function array_map; use function array_slice; use function explode; use function fopen; use function implode; use function in_array; use function is_int; use function range; use function rewind; use function rtrim; use function stream_get_contents; abstract class ErrorFormatterTestCase extends \PHPStan\Testing\PHPStanTestCase { protected const DIRECTORY_PATH = '/data/folder/with space/and unicode 😃/project'; private const KIND_DECORATED = 'decorated'; private const KIND_PLAIN = 'plain'; private const KIND_VERBOSE = '+verbose'; private const KIND_NOT_VERBOSE = '+not-verbose'; /** @var array<string, StreamOutput> */ private $outputStream = []; /** @var array<string, Output> */ private $output = []; private function getOutputStream(bool $decorated = \false, bool $verbose = \false) : StreamOutput { $kind = $decorated ? self::KIND_DECORATED : self::KIND_PLAIN; $kind .= $verbose ? self::KIND_VERBOSE : self::KIND_NOT_VERBOSE; if (!isset($this->outputStream[$kind])) { $resource = fopen('php://memory', 'w', \false); if ($resource === \false) { throw new ShouldNotHappenException(); } $verbosity = $verbose ? StreamOutput::VERBOSITY_VERBOSE : StreamOutput::VERBOSITY_NORMAL; $this->outputStream[$kind] = new StreamOutput($resource, $verbosity, $decorated); } return $this->outputStream[$kind]; } protected function getOutput(bool $decorated = \false, bool $verbose = \false) : Output { $kind = $decorated ? self::KIND_DECORATED : self::KIND_PLAIN; $kind .= $verbose ? self::KIND_VERBOSE : self::KIND_NOT_VERBOSE; if (!isset($this->output[$kind])) { $outputStream = $this->getOutputStream($decorated, $verbose); $errorConsoleStyle = new ErrorsConsoleStyle(new StringInput(''), $outputStream); $this->output[$kind] = new SymfonyOutput($outputStream, new SymfonyStyle($errorConsoleStyle)); } return $this->output[$kind]; } protected function getOutputContent(bool $decorated = \false, bool $verbose = \false) : string { rewind($this->getOutputStream($decorated, $verbose)->getStream()); $contents = stream_get_contents($this->getOutputStream($decorated, $verbose)->getStream()); if ($contents === \false) { throw new ShouldNotHappenException(); } return $this->rtrimMultiline($contents); } /** * @param array{int, int}|int $numFileErrors */ protected function getAnalysisResult($numFileErrors, int $numGenericErrors) : AnalysisResult { if (is_int($numFileErrors)) { $offsetFileErrors = 0; } else { [$offsetFileErrors, $numFileErrors] = $numFileErrors; } if (!in_array($numFileErrors, range(0, 6), \true) || !in_array($offsetFileErrors, range(0, 6), \true) || !in_array($numGenericErrors, range(0, 2), \true)) { throw new ShouldNotHappenException(); } $fileErrors = array_slice([new Error('Foo', self::DIRECTORY_PATH . '/folder with unicode 😃/file name with "spaces" and unicode 😃.php', 4), new Error('Foo<Bar>', self::DIRECTORY_PATH . '/foo.php', 1), new Error("Bar\nBar2", self::DIRECTORY_PATH . '/foo.php', 5, \true, null, null, 'a tip'), new Error("Bar\nBar2", self::DIRECTORY_PATH . '/folder with unicode 😃/file name with "spaces" and unicode 😃.php', 2), new Error("Bar\nBar2", self::DIRECTORY_PATH . '/foo.php', null), new Error('Foobar\\Buz', self::DIRECTORY_PATH . '/foo.php', 5, \true, null, null, 'a tip', null, null, 'foobar.buz')], $offsetFileErrors, $numFileErrors); $genericErrors = array_slice(['first generic error', 'second generic<error>'], 0, $numGenericErrors); return new AnalysisResult($fileErrors, $genericErrors, [], [], [], \false, null, \true, 0, \false, []); } private function rtrimMultiline(string $output) : string { $result = array_map(static function (string $line) : string { return rtrim($line, " \r\n"); }, explode("\n", $output)); return implode("\n", $result); } } <?php declare (strict_types=1); namespace PHPStan\PhpDoc; interface TypeNodeResolverExtensionRegistry { /** * @return TypeNodeResolverExtension[] */ public function getExtensions() : array; } <?php declare (strict_types=1); namespace PHPStan\PhpDoc; use PHPStan\Analyser\NameScope; use PHPStan\PhpDoc\Tag\AssertTag; use PHPStan\PhpDoc\Tag\AssertTagParameter; use PHPStan\PhpDoc\Tag\DeprecatedTag; use PHPStan\PhpDoc\Tag\ExtendsTag; use PHPStan\PhpDoc\Tag\ImplementsTag; use PHPStan\PhpDoc\Tag\MethodTag; use PHPStan\PhpDoc\Tag\MethodTagParameter; use PHPStan\PhpDoc\Tag\MixinTag; use PHPStan\PhpDoc\Tag\ParamClosureThisTag; use PHPStan\PhpDoc\Tag\ParamOutTag; use PHPStan\PhpDoc\Tag\ParamTag; use PHPStan\PhpDoc\Tag\PropertyTag; use PHPStan\PhpDoc\Tag\RequireExtendsTag; use PHPStan\PhpDoc\Tag\RequireImplementsTag; use PHPStan\PhpDoc\Tag\ReturnTag; use PHPStan\PhpDoc\Tag\SelfOutTypeTag; use PHPStan\PhpDoc\Tag\TemplateTag; use PHPStan\PhpDoc\Tag\ThrowsTag; use PHPStan\PhpDoc\Tag\TypeAliasImportTag; use PHPStan\PhpDoc\Tag\TypeAliasTag; use PHPStan\PhpDoc\Tag\UsesTag; use PHPStan\PhpDoc\Tag\VarTag; use PHPStan\PhpDocParser\Ast\ConstExpr\ConstExprNullNode; use PHPStan\PhpDocParser\Ast\PhpDoc\MixinTagValueNode; use PHPStan\PhpDocParser\Ast\PhpDoc\PhpDocNode; use PHPStan\PhpDocParser\Ast\PhpDoc\TemplateTagValueNode; use PHPStan\Reflection\PassedByReference; use PHPStan\Rules\PhpDoc\UnresolvableTypeHelper; use PHPStan\Type\Generic\TemplateTypeFactory; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\Generic\TemplateTypeScope; use PHPStan\Type\Generic\TemplateTypeVariance; use PHPStan\Type\MixedType; use PHPStan\Type\ObjectWithoutClassType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function array_key_exists; use function array_map; use function array_merge; use function array_reverse; use function count; use function in_array; use function method_exists; use function str_starts_with; use function substr; final class PhpDocNodeResolver { /** * @var TypeNodeResolver */ private $typeNodeResolver; /** * @var ConstExprNodeResolver */ private $constExprNodeResolver; /** * @var UnresolvableTypeHelper */ private $unresolvableTypeHelper; public function __construct(\PHPStan\PhpDoc\TypeNodeResolver $typeNodeResolver, \PHPStan\PhpDoc\ConstExprNodeResolver $constExprNodeResolver, UnresolvableTypeHelper $unresolvableTypeHelper) { $this->typeNodeResolver = $typeNodeResolver; $this->constExprNodeResolver = $constExprNodeResolver; $this->unresolvableTypeHelper = $unresolvableTypeHelper; } /** * @return array<(string|int), VarTag> */ public function resolveVarTags(PhpDocNode $phpDocNode, NameScope $nameScope) : array { $resolved = []; $resolvedByTag = []; foreach (['@var', '@phan-var', '@psalm-var', '@phpstan-var'] as $tagName) { $tagResolved = []; foreach ($phpDocNode->getVarTagValues($tagName) as $tagValue) { $type = $this->typeNodeResolver->resolve($tagValue->type, $nameScope); if ($this->shouldSkipType($tagName, $type)) { continue; } if ($tagValue->variableName !== '') { $variableName = substr($tagValue->variableName, 1); $resolved[$variableName] = new VarTag($type); } else { $varTag = new VarTag($type); $tagResolved[] = $varTag; } } if (count($tagResolved) === 0) { continue; } $resolvedByTag[] = $tagResolved; } if (count($resolvedByTag) > 0) { return array_reverse($resolvedByTag)[0]; } return $resolved; } /** * @return array<string, PropertyTag> */ public function resolvePropertyTags(PhpDocNode $phpDocNode, NameScope $nameScope) : array { $resolved = []; foreach (['@property', '@phpstan-property'] as $tagName) { foreach ($phpDocNode->getPropertyTagValues($tagName) as $tagValue) { $propertyName = substr($tagValue->propertyName, 1); $propertyType = $this->typeNodeResolver->resolve($tagValue->type, $nameScope); $resolved[$propertyName] = new PropertyTag($propertyType, $propertyType, $propertyType); } } foreach (['@property-read', '@phpstan-property-read'] as $tagName) { foreach ($phpDocNode->getPropertyReadTagValues($tagName) as $tagValue) { $propertyName = substr($tagValue->propertyName, 1); $propertyType = $this->typeNodeResolver->resolve($tagValue->type, $nameScope); $writableType = null; if (array_key_exists($propertyName, $resolved)) { $writableType = $resolved[$propertyName]->getWritableType(); } $resolved[$propertyName] = new PropertyTag($propertyType, $propertyType, $writableType); } } foreach (['@property-write', '@phpstan-property-write'] as $tagName) { foreach ($phpDocNode->getPropertyWriteTagValues($tagName) as $tagValue) { $propertyName = substr($tagValue->propertyName, 1); $propertyType = $this->typeNodeResolver->resolve($tagValue->type, $nameScope); $readableType = null; if (array_key_exists($propertyName, $resolved)) { $readableType = $resolved[$propertyName]->getReadableType(); } $resolved[$propertyName] = new PropertyTag($readableType ?? $propertyType, $readableType, $propertyType); } } return $resolved; } /** * @return array<string, MethodTag> */ public function resolveMethodTags(PhpDocNode $phpDocNode, NameScope $nameScope) : array { $resolved = []; $originalNameScope = $nameScope; foreach (['@method', '@phan-method', '@psalm-method', '@phpstan-method'] as $tagName) { foreach ($phpDocNode->getMethodTagValues($tagName) as $tagValue) { $nameScope = $originalNameScope; $templateTags = []; if (count($tagValue->templateTypes) > 0 && $nameScope->getClassName() !== null) { foreach ($tagValue->templateTypes as $templateType) { $templateTags[$templateType->name] = new TemplateTag($templateType->name, $templateType->bound !== null ? $this->typeNodeResolver->resolve($templateType->bound, $nameScope) : new MixedType(), $templateType->default !== null ? $this->typeNodeResolver->resolve($templateType->default, $nameScope) : null, TemplateTypeVariance::createInvariant()); } $templateTypeScope = TemplateTypeScope::createWithMethod($nameScope->getClassName(), $tagValue->methodName); $templateTypeMap = new TemplateTypeMap(array_map(static function (TemplateTag $tag) use($templateTypeScope) : Type { return TemplateTypeFactory::fromTemplateTag($templateTypeScope, $tag); }, $templateTags)); $nameScope = $nameScope->withTemplateTypeMap($templateTypeMap); } $parameters = []; foreach ($tagValue->parameters as $parameterNode) { $parameterName = substr($parameterNode->parameterName, 1); $type = $parameterNode->type !== null ? $this->typeNodeResolver->resolve($parameterNode->type, $nameScope) : new MixedType(); if ($parameterNode->defaultValue instanceof ConstExprNullNode) { $type = TypeCombinator::addNull($type); } $defaultValue = null; if ($parameterNode->defaultValue !== null) { $defaultValue = $this->constExprNodeResolver->resolve($parameterNode->defaultValue, $nameScope); } $parameters[$parameterName] = new MethodTagParameter($type, $parameterNode->isReference ? PassedByReference::createCreatesNewVariable() : PassedByReference::createNo(), $parameterNode->isVariadic || $parameterNode->defaultValue !== null, $parameterNode->isVariadic, $defaultValue); } $resolved[$tagValue->methodName] = new MethodTag($tagValue->returnType !== null ? $this->typeNodeResolver->resolve($tagValue->returnType, $nameScope) : new MixedType(), $tagValue->isStatic, $parameters, $templateTags); } } return $resolved; } /** * @return array<string, ExtendsTag> */ public function resolveExtendsTags(PhpDocNode $phpDocNode, NameScope $nameScope) : array { $resolved = []; foreach (['@extends', '@phan-extends', '@phan-inherits', '@template-extends', '@phpstan-extends'] as $tagName) { foreach ($phpDocNode->getExtendsTagValues($tagName) as $tagValue) { $resolved[$nameScope->resolveStringName($tagValue->type->type->name)] = new ExtendsTag($this->typeNodeResolver->resolve($tagValue->type, $nameScope)); } } return $resolved; } /** * @return array<string, ImplementsTag> */ public function resolveImplementsTags(PhpDocNode $phpDocNode, NameScope $nameScope) : array { $resolved = []; foreach (['@implements', '@template-implements', '@phpstan-implements'] as $tagName) { foreach ($phpDocNode->getImplementsTagValues($tagName) as $tagValue) { $resolved[$nameScope->resolveStringName($tagValue->type->type->name)] = new ImplementsTag($this->typeNodeResolver->resolve($tagValue->type, $nameScope)); } } return $resolved; } /** * @return array<string, UsesTag> */ public function resolveUsesTags(PhpDocNode $phpDocNode, NameScope $nameScope) : array { $resolved = []; foreach (['@use', '@template-use', '@phpstan-use'] as $tagName) { foreach ($phpDocNode->getUsesTagValues($tagName) as $tagValue) { $resolved[$nameScope->resolveStringName($tagValue->type->type->name)] = new UsesTag($this->typeNodeResolver->resolve($tagValue->type, $nameScope)); } } return $resolved; } /** * @return array<string, TemplateTag> */ public function resolveTemplateTags(PhpDocNode $phpDocNode, NameScope $nameScope) : array { $resolved = []; $resolvedPrefix = []; $prefixPriority = ['' => 0, 'phan' => 1, 'psalm' => 2, 'phpstan' => 3]; foreach ($phpDocNode->getTags() as $phpDocTagNode) { $valueNode = $phpDocTagNode->value; if (!$valueNode instanceof TemplateTagValueNode) { continue; } $tagName = $phpDocTagNode->name; if (in_array($tagName, ['@template', '@phan-template', '@psalm-template', '@phpstan-template'], \true)) { $variance = TemplateTypeVariance::createInvariant(); } elseif (in_array($tagName, ['@template-covariant', '@psalm-template-covariant', '@phpstan-template-covariant'], \true)) { $variance = TemplateTypeVariance::createCovariant(); } elseif (in_array($tagName, ['@template-contravariant', '@psalm-template-contravariant', '@phpstan-template-contravariant'], \true)) { $variance = TemplateTypeVariance::createContravariant(); } else { continue; } if (str_starts_with($tagName, '@phan-')) { $prefix = 'phan'; } elseif (str_starts_with($tagName, '@psalm-')) { $prefix = 'psalm'; } elseif (str_starts_with($tagName, '@phpstan-')) { $prefix = 'phpstan'; } else { $prefix = ''; } if (isset($resolved[$valueNode->name])) { $setPrefix = $resolvedPrefix[$valueNode->name]; if ($prefixPriority[$prefix] <= $prefixPriority[$setPrefix]) { continue; } } $nameScopeWithoutCurrent = $nameScope->unsetTemplateType($valueNode->name); $resolved[$valueNode->name] = new TemplateTag($valueNode->name, $valueNode->bound !== null ? $this->typeNodeResolver->resolve($valueNode->bound, $nameScopeWithoutCurrent) : new MixedType(\true), $valueNode->default !== null ? $this->typeNodeResolver->resolve($valueNode->default, $nameScopeWithoutCurrent) : null, $variance); $resolvedPrefix[$valueNode->name] = $prefix; } return $resolved; } /** * @return array<string, ParamTag> */ public function resolveParamTags(PhpDocNode $phpDocNode, NameScope $nameScope) : array { $resolved = []; foreach (['@param', '@phan-param', '@psalm-param', '@phpstan-param'] as $tagName) { foreach ($phpDocNode->getParamTagValues($tagName) as $tagValue) { $parameterName = substr($tagValue->parameterName, 1); $parameterType = $this->typeNodeResolver->resolve($tagValue->type, $nameScope); if ($this->shouldSkipType($tagName, $parameterType)) { continue; } $resolved[$parameterName] = new ParamTag($parameterType, $tagValue->isVariadic); } } return $resolved; } /** * @return array<string, ParamOutTag> */ public function resolveParamOutTags(PhpDocNode $phpDocNode, NameScope $nameScope) : array { if (!method_exists($phpDocNode, 'getParamOutTypeTagValues')) { return []; } $resolved = []; foreach (['@param-out', '@psalm-param-out', '@phpstan-param-out'] as $tagName) { foreach ($phpDocNode->getParamOutTypeTagValues($tagName) as $tagValue) { $parameterName = substr($tagValue->parameterName, 1); $parameterType = $this->typeNodeResolver->resolve($tagValue->type, $nameScope); if ($this->shouldSkipType($tagName, $parameterType)) { continue; } $resolved[$parameterName] = new ParamOutTag($parameterType); } } return $resolved; } /** * @return array<string, bool> */ public function resolveParamImmediatelyInvokedCallable(PhpDocNode $phpDocNode) : array { $parameters = []; foreach (['@param-immediately-invoked-callable', '@phpstan-param-immediately-invoked-callable'] as $tagName) { foreach ($phpDocNode->getParamImmediatelyInvokedCallableTagValues($tagName) as $tagValue) { $parameterName = substr($tagValue->parameterName, 1); $parameters[$parameterName] = \true; } } foreach (['@param-later-invoked-callable', '@phpstan-param-later-invoked-callable'] as $tagName) { foreach ($phpDocNode->getParamLaterInvokedCallableTagValues($tagName) as $tagValue) { $parameterName = substr($tagValue->parameterName, 1); $parameters[$parameterName] = \false; } } return $parameters; } /** * @return array<string, ParamClosureThisTag> */ public function resolveParamClosureThisTags(PhpDocNode $phpDocNode, NameScope $nameScope) : array { $closureThisTypes = []; foreach (['@param-closure-this', '@phpstan-param-closure-this'] as $tagName) { foreach ($phpDocNode->getParamClosureThisTagValues($tagName) as $tagValue) { $parameterName = substr($tagValue->parameterName, 1); $closureThisTypes[$parameterName] = new ParamClosureThisTag(TypeCombinator::intersect($this->typeNodeResolver->resolve($tagValue->type, $nameScope), new ObjectWithoutClassType())); } } return $closureThisTypes; } public function resolveReturnTag(PhpDocNode $phpDocNode, NameScope $nameScope) : ?ReturnTag { $resolved = null; foreach (['@return', '@phan-return', '@phan-real-return', '@psalm-return', '@phpstan-return'] as $tagName) { foreach ($phpDocNode->getReturnTagValues($tagName) as $tagValue) { $type = $this->typeNodeResolver->resolve($tagValue->type, $nameScope); if ($this->shouldSkipType($tagName, $type)) { continue; } $resolved = new ReturnTag($type, \true); } } return $resolved; } public function resolveThrowsTags(PhpDocNode $phpDocNode, NameScope $nameScope) : ?ThrowsTag { foreach (['@phpstan-throws', '@throws'] as $tagName) { $types = []; foreach ($phpDocNode->getThrowsTagValues($tagName) as $tagValue) { $type = $this->typeNodeResolver->resolve($tagValue->type, $nameScope); if ($this->shouldSkipType($tagName, $type)) { continue; } $types[] = $type; } if (count($types) > 0) { return new ThrowsTag(TypeCombinator::union(...$types)); } } return null; } /** * @return array<MixinTag> */ public function resolveMixinTags(PhpDocNode $phpDocNode, NameScope $nameScope) : array { return array_map(function (MixinTagValueNode $mixinTagValueNode) use($nameScope) : MixinTag { return new MixinTag($this->typeNodeResolver->resolve($mixinTagValueNode->type, $nameScope)); }, $phpDocNode->getMixinTagValues()); } /** * @return array<RequireExtendsTag> */ public function resolveRequireExtendsTags(PhpDocNode $phpDocNode, NameScope $nameScope) : array { $resolved = []; foreach (['@psalm-require-extends', '@phpstan-require-extends'] as $tagName) { foreach ($phpDocNode->getRequireExtendsTagValues($tagName) as $tagValue) { $resolved[] = new RequireExtendsTag($this->typeNodeResolver->resolve($tagValue->type, $nameScope)); } } return $resolved; } /** * @return array<RequireImplementsTag> */ public function resolveRequireImplementsTags(PhpDocNode $phpDocNode, NameScope $nameScope) : array { $resolved = []; foreach (['@psalm-require-implements', '@phpstan-require-implements'] as $tagName) { foreach ($phpDocNode->getRequireImplementsTagValues($tagName) as $tagValue) { $resolved[] = new RequireImplementsTag($this->typeNodeResolver->resolve($tagValue->type, $nameScope)); } } return $resolved; } /** * @return array<string, TypeAliasTag> */ public function resolveTypeAliasTags(PhpDocNode $phpDocNode, NameScope $nameScope) : array { $resolved = []; foreach (['@phan-type', '@psalm-type', '@phpstan-type'] as $tagName) { foreach ($phpDocNode->getTypeAliasTagValues($tagName) as $typeAliasTagValue) { $alias = $typeAliasTagValue->alias; $typeNode = $typeAliasTagValue->type; $resolved[$alias] = new TypeAliasTag($alias, $typeNode, $nameScope); } } return $resolved; } /** * @return array<string, TypeAliasImportTag> */ public function resolveTypeAliasImportTags(PhpDocNode $phpDocNode, NameScope $nameScope) : array { $resolved = []; foreach (['@psalm-import-type', '@phpstan-import-type'] as $tagName) { foreach ($phpDocNode->getTypeAliasImportTagValues($tagName) as $typeAliasImportTagValue) { $importedAlias = $typeAliasImportTagValue->importedAlias; $importedFrom = $nameScope->resolveStringName($typeAliasImportTagValue->importedFrom->name); $importedAs = $typeAliasImportTagValue->importedAs; $resolved[$importedAs ?? $importedAlias] = new TypeAliasImportTag($importedAlias, $importedFrom, $importedAs); } } return $resolved; } /** * @return AssertTag[] */ public function resolveAssertTags(PhpDocNode $phpDocNode, NameScope $nameScope) : array { foreach (['@phpstan', '@psalm', '@phan'] as $prefix) { $resolved = array_merge($this->resolveAssertTagsFor($phpDocNode, $nameScope, $prefix . '-assert', AssertTag::NULL), $this->resolveAssertTagsFor($phpDocNode, $nameScope, $prefix . '-assert-if-true', AssertTag::IF_TRUE), $this->resolveAssertTagsFor($phpDocNode, $nameScope, $prefix . '-assert-if-false', AssertTag::IF_FALSE)); if (count($resolved) > 0) { return $resolved; } } return []; } /** * @param AssertTag::NULL|AssertTag::IF_TRUE|AssertTag::IF_FALSE $if * @return AssertTag[] */ private function resolveAssertTagsFor(PhpDocNode $phpDocNode, NameScope $nameScope, string $tagName, string $if) : array { $resolved = []; foreach ($phpDocNode->getAssertTagValues($tagName) as $assertTagValue) { $type = $this->typeNodeResolver->resolve($assertTagValue->type, $nameScope); $parameter = new AssertTagParameter($assertTagValue->parameter, null, null); $resolved[] = new AssertTag($if, $type, $parameter, $assertTagValue->isNegated, $assertTagValue->isEquality ?? \false, \true); } foreach ($phpDocNode->getAssertPropertyTagValues($tagName) as $assertTagValue) { $type = $this->typeNodeResolver->resolve($assertTagValue->type, $nameScope); $parameter = new AssertTagParameter($assertTagValue->parameter, $assertTagValue->property, null); $resolved[] = new AssertTag($if, $type, $parameter, $assertTagValue->isNegated, $assertTagValue->isEquality ?? \false, \true); } foreach ($phpDocNode->getAssertMethodTagValues($tagName) as $assertTagValue) { $type = $this->typeNodeResolver->resolve($assertTagValue->type, $nameScope); $parameter = new AssertTagParameter($assertTagValue->parameter, null, $assertTagValue->method); $resolved[] = new AssertTag($if, $type, $parameter, $assertTagValue->isNegated, $assertTagValue->isEquality ?? \false, \true); } return $resolved; } public function resolveSelfOutTypeTag(PhpDocNode $phpDocNode, NameScope $nameScope) : ?SelfOutTypeTag { if (!method_exists($phpDocNode, 'getSelfOutTypeTagValues')) { return null; } foreach (['@phpstan-this-out', '@phpstan-self-out', '@psalm-this-out', '@psalm-self-out'] as $tagName) { foreach ($phpDocNode->getSelfOutTypeTagValues($tagName) as $selfOutTypeTagValue) { $type = $this->typeNodeResolver->resolve($selfOutTypeTagValue->type, $nameScope); return new SelfOutTypeTag($type); } } return null; } public function resolveDeprecatedTag(PhpDocNode $phpDocNode, NameScope $nameScope) : ?DeprecatedTag { foreach ($phpDocNode->getDeprecatedTagValues() as $deprecatedTagValue) { $description = (string) $deprecatedTagValue; return new DeprecatedTag($description === '' ? null : $description); } return null; } public function resolveIsDeprecated(PhpDocNode $phpDocNode) : bool { $deprecatedTags = $phpDocNode->getTagsByName('@deprecated'); return count($deprecatedTags) > 0; } public function resolveIsNotDeprecated(PhpDocNode $phpDocNode) : bool { $notDeprecatedTags = $phpDocNode->getTagsByName('@not-deprecated'); return count($notDeprecatedTags) > 0; } public function resolveIsInternal(PhpDocNode $phpDocNode) : bool { $internalTags = $phpDocNode->getTagsByName('@internal'); return count($internalTags) > 0; } public function resolveIsFinal(PhpDocNode $phpDocNode) : bool { $finalTags = $phpDocNode->getTagsByName('@final'); return count($finalTags) > 0; } public function resolveIsPure(PhpDocNode $phpDocNode) : bool { foreach ($phpDocNode->getTags() as $phpDocTagNode) { if (in_array($phpDocTagNode->name, ['@pure', '@phan-pure', '@phan-side-effect-free', '@psalm-pure', '@phpstan-pure'], \true)) { return \true; } } return \false; } public function resolveIsImpure(PhpDocNode $phpDocNode) : bool { foreach ($phpDocNode->getTags() as $phpDocTagNode) { if (in_array($phpDocTagNode->name, ['@impure', '@phpstan-impure'], \true)) { return \true; } } return \false; } public function resolveIsReadOnly(PhpDocNode $phpDocNode) : bool { foreach (['@readonly', '@phan-read-only', '@psalm-readonly', '@phpstan-readonly', '@phpstan-readonly-allow-private-mutation', '@psalm-readonly-allow-private-mutation'] as $tagName) { $tags = $phpDocNode->getTagsByName($tagName); if (count($tags) > 0) { return \true; } } return \false; } public function resolveIsImmutable(PhpDocNode $phpDocNode) : bool { foreach (['@immutable', '@phan-immutable', '@psalm-immutable', '@phpstan-immutable'] as $tagName) { $tags = $phpDocNode->getTagsByName($tagName); if (count($tags) > 0) { return \true; } } return \false; } public function resolveHasConsistentConstructor(PhpDocNode $phpDocNode) : bool { foreach (['@consistent-constructor', '@phpstan-consistent-constructor', '@psalm-consistent-constructor'] as $tagName) { $tags = $phpDocNode->getTagsByName($tagName); if (count($tags) > 0) { return \true; } } return \false; } public function resolveAcceptsNamedArguments(PhpDocNode $phpDocNode) : bool { return count($phpDocNode->getTagsByName('@no-named-arguments')) === 0; } private function shouldSkipType(string $tagName, Type $type) : bool { if (!str_starts_with($tagName, '@psalm-')) { return \false; } return $this->unresolvableTypeHelper->containsUnresolvableType($type); } public function resolveAllowPrivateMutation(PhpDocNode $phpDocNode) : bool { foreach (['@phpstan-readonly-allow-private-mutation', '@phpstan-allow-private-mutation', '@psalm-readonly-allow-private-mutation', '@psalm-allow-private-mutation'] as $tagName) { $tags = $phpDocNode->getTagsByName($tagName); if (count($tags) > 0) { return \true; } } return \false; } } <?php declare (strict_types=1); namespace PHPStan\PhpDoc\Tag; use PHPStan\Type\Type; /** * @api * @final */ class ParamOutTag implements \PHPStan\PhpDoc\Tag\TypedTag { /** * @var Type */ private $type; public function __construct(Type $type) { $this->type = $type; } public function getType() : Type { return $this->type; } /** * @return self */ public function withType(Type $type) : \PHPStan\PhpDoc\Tag\TypedTag { return new self($type); } } <?php declare (strict_types=1); namespace PHPStan\PhpDoc\Tag; use PHPStan\Type\Type; /** * @api * @final */ class RequireExtendsTag { /** * @var Type */ private $type; public function __construct(Type $type) { $this->type = $type; } public function getType() : Type { return $this->type; } } <?php declare (strict_types=1); namespace PHPStan\PhpDoc\Tag; use PHPStan\Reflection\PassedByReference; use PHPStan\Type\Type; /** * @api * @final */ class MethodTagParameter { /** * @var Type */ private $type; /** * @var PassedByReference */ private $passedByReference; /** * @var bool */ private $isOptional; /** * @var bool */ private $isVariadic; /** * @var ?Type */ private $defaultValue; public function __construct(Type $type, PassedByReference $passedByReference, bool $isOptional, bool $isVariadic, ?Type $defaultValue) { $this->type = $type; $this->passedByReference = $passedByReference; $this->isOptional = $isOptional; $this->isVariadic = $isVariadic; $this->defaultValue = $defaultValue; } public function getType() : Type { return $this->type; } public function passedByReference() : PassedByReference { return $this->passedByReference; } public function isOptional() : bool { return $this->isOptional; } public function isVariadic() : bool { return $this->isVariadic; } public function getDefaultValue() : ?Type { return $this->defaultValue; } } <?php declare (strict_types=1); namespace PHPStan\PhpDoc\Tag; use PHPStan\Type\Type; /** * @api * @final */ class MixinTag { /** * @var Type */ private $type; public function __construct(Type $type) { $this->type = $type; } public function getType() : Type { return $this->type; } } <?php declare (strict_types=1); namespace PHPStan\PhpDoc\Tag; use PhpParser\Node\Expr; use function sprintf; final class AssertTagParameter { /** * @var string */ private $parameterName; /** * @var ?string */ private $property; /** * @var ?string */ private $method; public function __construct(string $parameterName, ?string $property, ?string $method) { $this->parameterName = $parameterName; $this->property = $property; $this->method = $method; } public function getParameterName() : string { return $this->parameterName; } public function changeParameterName(string $parameterName) : self { return new self($parameterName, $this->property, $this->method); } public function describe() : string { if ($this->property !== null) { return sprintf('%s->%s', $this->parameterName, $this->property); } if ($this->method !== null) { return sprintf('%s->%s()', $this->parameterName, $this->method); } return $this->parameterName; } public function getExpr(Expr $parameter) : Expr { if ($this->property !== null) { return new Expr\PropertyFetch($parameter, $this->property); } if ($this->method !== null) { return new Expr\MethodCall($parameter, $this->method); } return $parameter; } } <?php declare (strict_types=1); namespace PHPStan\PhpDoc\Tag; use PHPStan\Type\Type; /** * @api * @final */ class PropertyTag { /** * @var Type */ private $type; /** * @var ?Type */ private $readableType; /** * @var ?Type */ private $writableType; public function __construct(Type $type, ?Type $readableType, ?Type $writableType) { $this->type = $type; $this->readableType = $readableType; $this->writableType = $writableType; } /** * @deprecated Use getReadableType() / getWritableType() */ public function getType() : Type { return $this->type; } public function getReadableType() : ?Type { return $this->readableType; } public function getWritableType() : ?Type { return $this->writableType; } /** * @phpstan-assert-if-true !null $this->getReadableType() */ public function isReadable() : bool { return $this->readableType !== null; } /** * @phpstan-assert-if-true !null $this->getWritableType() */ public function isWritable() : bool { return $this->writableType !== null; } } <?php declare (strict_types=1); namespace PHPStan\PhpDoc\Tag; use PHPStan\Type\Type; /** * @api * @final */ class ExtendsTag { /** * @var Type */ private $type; public function __construct(Type $type) { $this->type = $type; } public function getType() : Type { return $this->type; } } <?php declare (strict_types=1); namespace PHPStan\PhpDoc\Tag; use PHPStan\Type\Type; /** * @api * @final */ class VarTag implements \PHPStan\PhpDoc\Tag\TypedTag { /** * @var Type */ private $type; public function __construct(Type $type) { $this->type = $type; } public function getType() : Type { return $this->type; } /** * @return self */ public function withType(Type $type) : \PHPStan\PhpDoc\Tag\TypedTag { return new self($type); } } <?php declare (strict_types=1); namespace PHPStan\PhpDoc\Tag; /** @api */ final class TypeAliasImportTag { /** * @var string */ private $importedAlias; /** * @var string */ private $importedFrom; /** * @var ?string */ private $importedAs; public function __construct(string $importedAlias, string $importedFrom, ?string $importedAs) { $this->importedAlias = $importedAlias; $this->importedFrom = $importedFrom; $this->importedAs = $importedAs; } public function getImportedAlias() : string { return $this->importedAlias; } public function getImportedFrom() : string { return $this->importedFrom; } public function getImportedAs() : ?string { return $this->importedAs; } } <?php declare (strict_types=1); namespace PHPStan\PhpDoc\Tag; use PHPStan\Type\Type; /** * @api * @final */ final class ParamClosureThisTag implements \PHPStan\PhpDoc\Tag\TypedTag { /** * @var Type */ private $type; public function __construct(Type $type) { $this->type = $type; } public function getType() : Type { return $this->type; } /** * @return self */ public function withType(Type $type) : \PHPStan\PhpDoc\Tag\TypedTag { return new self($type); } } <?php declare (strict_types=1); namespace PHPStan\PhpDoc\Tag; use PHPStan\Type\Type; /** @api */ interface TypedTag { public function getType() : Type; /** * @return static */ public function withType(Type $type) : self; } <?php declare (strict_types=1); namespace PHPStan\PhpDoc\Tag; use PHPStan\Type\Type; /** * @api * @final */ class ParamTag implements \PHPStan\PhpDoc\Tag\TypedTag { /** * @var Type */ private $type; /** * @var bool */ private $isVariadic; public function __construct(Type $type, bool $isVariadic) { $this->type = $type; $this->isVariadic = $isVariadic; } public function getType() : Type { return $this->type; } public function isVariadic() : bool { return $this->isVariadic; } /** * @return self */ public function withType(Type $type) : \PHPStan\PhpDoc\Tag\TypedTag { return new self($type, $this->isVariadic); } } <?php declare (strict_types=1); namespace PHPStan\PhpDoc\Tag; use PHPStan\Type\Type; /** * @api * @final */ class UsesTag { /** * @var Type */ private $type; public function __construct(Type $type) { $this->type = $type; } public function getType() : Type { return $this->type; } } <?php declare (strict_types=1); namespace PHPStan\PhpDoc\Tag; use PHPStan\Type\Type; /** * @api * @final */ class SelfOutTypeTag implements \PHPStan\PhpDoc\Tag\TypedTag { /** * @var Type */ private $type; public function __construct(Type $type) { $this->type = $type; } public function getType() : Type { return $this->type; } /** * @return self */ public function withType(Type $type) : \PHPStan\PhpDoc\Tag\TypedTag { return new self($type); } } <?php declare (strict_types=1); namespace PHPStan\PhpDoc\Tag; use PHPStan\Type\Type; /** * @api * @final */ class RequireImplementsTag { /** * @var Type */ private $type; public function __construct(Type $type) { $this->type = $type; } public function getType() : Type { return $this->type; } } <?php declare (strict_types=1); namespace PHPStan\PhpDoc\Tag; use PHPStan\Type\Type; /** * @api * @final */ class ReturnTag implements \PHPStan\PhpDoc\Tag\TypedTag { /** * @var Type */ private $type; /** * @var bool */ private $isExplicit; public function __construct(Type $type, bool $isExplicit) { $this->type = $type; $this->isExplicit = $isExplicit; } public function getType() : Type { return $this->type; } public function isExplicit() : bool { return $this->isExplicit; } /** * @return self */ public function withType(Type $type) : \PHPStan\PhpDoc\Tag\TypedTag { return new self($type, $this->isExplicit); } public function toImplicit() : self { return new self($this->type, \false); } } <?php declare (strict_types=1); namespace PHPStan\PhpDoc\Tag; /** * @api * @final */ class DeprecatedTag { /** * @var ?string */ private $message; public function __construct(?string $message) { $this->message = $message; } public function getMessage() : ?string { return $this->message; } } <?php declare (strict_types=1); namespace PHPStan\PhpDoc\Tag; use PHPStan\Type\Type; /** * @api * @final */ class ThrowsTag { /** * @var Type */ private $type; public function __construct(Type $type) { $this->type = $type; } public function getType() : Type { return $this->type; } } <?php declare (strict_types=1); namespace PHPStan\PhpDoc\Tag; use PHPStan\ShouldNotHappenException; use PHPStan\Type\Type; /** @api */ final class AssertTag implements \PHPStan\PhpDoc\Tag\TypedTag { /** * @var self::NULL|self::IF_TRUE|self::IF_FALSE */ private $if; /** * @var Type */ private $type; /** * @var AssertTagParameter */ private $parameter; /** * @var bool */ private $negated; /** * @var bool */ private $equality; /** * @var bool */ private $isExplicit; public const NULL = ''; public const IF_TRUE = 'true'; public const IF_FALSE = 'false'; /** * @var ?Type */ private $originalType = null; /** * @param self::NULL|self::IF_TRUE|self::IF_FALSE $if */ public function __construct(string $if, Type $type, \PHPStan\PhpDoc\Tag\AssertTagParameter $parameter, bool $negated, bool $equality, bool $isExplicit) { $this->if = $if; $this->type = $type; $this->parameter = $parameter; $this->negated = $negated; $this->equality = $equality; $this->isExplicit = $isExplicit; } /** * @return self::NULL|self::IF_TRUE|self::IF_FALSE */ public function getIf() : string { return $this->if; } public function getType() : Type { return $this->type; } public function getOriginalType() : Type { return $this->originalType = $this->originalType ?? $this->type; } public function getParameter() : \PHPStan\PhpDoc\Tag\AssertTagParameter { return $this->parameter; } public function isNegated() : bool { return $this->negated; } public function isEquality() : bool { return $this->equality; } /** * @return static */ public function withType(Type $type) : \PHPStan\PhpDoc\Tag\TypedTag { $tag = new self($this->if, $type, $this->parameter, $this->negated, $this->equality, $this->isExplicit); $tag->originalType = $this->getOriginalType(); return $tag; } public function withParameter(\PHPStan\PhpDoc\Tag\AssertTagParameter $parameter) : self { $tag = new self($this->if, $this->type, $parameter, $this->negated, $this->equality, $this->isExplicit); $tag->originalType = $this->getOriginalType(); return $tag; } public function negate() : self { if ($this->isEquality()) { throw new ShouldNotHappenException(); } $tag = new self($this->if, $this->type, $this->parameter, !$this->negated, $this->equality, $this->isExplicit); $tag->originalType = $this->getOriginalType(); return $tag; } public function isExplicit() : bool { return $this->isExplicit; } public function toImplicit() : self { return new self($this->if, $this->type, $this->parameter, $this->negated, $this->equality, \false); } } <?php declare (strict_types=1); namespace PHPStan\PhpDoc\Tag; use PHPStan\Type\Type; /** * @api * @final */ class MethodTag { /** * @var Type */ private $returnType; /** * @var bool */ private $isStatic; /** * @var array<string, MethodTagParameter> */ private $parameters; /** * @var array<string, TemplateTag> */ private $templateTags; /** * @param array<string, MethodTagParameter> $parameters * @param array<string, TemplateTag> $templateTags */ public function __construct(Type $returnType, bool $isStatic, array $parameters, array $templateTags = []) { $this->returnType = $returnType; $this->isStatic = $isStatic; $this->parameters = $parameters; $this->templateTags = $templateTags; } public function getReturnType() : Type { return $this->returnType; } public function isStatic() : bool { return $this->isStatic; } /** * @return array<string, MethodTagParameter> */ public function getParameters() : array { return $this->parameters; } /** * @return array<string, TemplateTag> */ public function getTemplateTags() : array { return $this->templateTags; } } <?php declare (strict_types=1); namespace PHPStan\PhpDoc\Tag; use PHPStan\Type\Generic\TemplateTypeVariance; use PHPStan\Type\Type; /** * @api * @final */ class TemplateTag { /** * @var non-empty-string */ private $name; /** * @var Type */ private $bound; /** * @var ?Type */ private $default; /** * @var TemplateTypeVariance */ private $variance; /** * @param non-empty-string $name */ public function __construct(string $name, Type $bound, ?Type $default, TemplateTypeVariance $variance) { $this->name = $name; $this->bound = $bound; $this->default = $default; $this->variance = $variance; } /** * @return non-empty-string */ public function getName() : string { return $this->name; } public function getBound() : Type { return $this->bound; } public function getDefault() : ?Type { return $this->default; } public function getVariance() : TemplateTypeVariance { return $this->variance; } } <?php declare (strict_types=1); namespace PHPStan\PhpDoc\Tag; use PHPStan\Type\Type; /** * @api * @final */ class ImplementsTag { /** * @var Type */ private $type; public function __construct(Type $type) { $this->type = $type; } public function getType() : Type { return $this->type; } } <?php declare (strict_types=1); namespace PHPStan\PhpDoc\Tag; use PHPStan\Analyser\NameScope; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\Type\TypeAlias; /** * @api * @final */ class TypeAliasTag { /** * @var string */ private $aliasName; /** * @var TypeNode */ private $typeNode; /** * @var NameScope */ private $nameScope; public function __construct(string $aliasName, TypeNode $typeNode, NameScope $nameScope) { $this->aliasName = $aliasName; $this->typeNode = $typeNode; $this->nameScope = $nameScope; } public function getAliasName() : string { return $this->aliasName; } public function getTypeAlias() : TypeAlias { return new TypeAlias($this->typeNode, $this->nameScope); } } <?php declare (strict_types=1); namespace PHPStan\PhpDoc; use PHPStan\PhpDocParser\Ast\PhpDoc\PhpDocNode; use PHPStan\PhpDocParser\Lexer\Lexer; use PHPStan\PhpDocParser\Parser\PhpDocParser; use PHPStan\PhpDocParser\Parser\TokenIterator; final class PhpDocStringResolver { /** * @var Lexer */ private $phpDocLexer; /** * @var PhpDocParser */ private $phpDocParser; public function __construct(Lexer $phpDocLexer, PhpDocParser $phpDocParser) { $this->phpDocLexer = $phpDocLexer; $this->phpDocParser = $phpDocParser; } public function resolve(string $phpDocString) : PhpDocNode { $tokens = new TokenIterator($this->phpDocLexer->tokenize($phpDocString)); $phpDocNode = $this->phpDocParser->parse($tokens); $tokens->consumeTokenType(Lexer::TOKEN_END); // @phpstan-ignore missingType.checkedException return $phpDocNode; } } <?php declare (strict_types=1); namespace PHPStan\PhpDoc; use PHPStan\DependencyInjection\Container; use PHPStan\Internal\ComposerHelper; use function array_filter; use function array_values; use function str_contains; use function strtr; final class DefaultStubFilesProvider implements \PHPStan\PhpDoc\StubFilesProvider { /** * @var Container */ private $container; /** * @var string[] */ private $stubFiles; /** * @var string[] */ private $composerAutoloaderProjectPaths; /** @var string[]|null */ private $cachedFiles = null; /** @var string[]|null */ private $cachedProjectFiles = null; /** * @param string[] $stubFiles * @param string[] $composerAutoloaderProjectPaths */ public function __construct(Container $container, array $stubFiles, array $composerAutoloaderProjectPaths) { $this->container = $container; $this->stubFiles = $stubFiles; $this->composerAutoloaderProjectPaths = $composerAutoloaderProjectPaths; } public function getStubFiles() : array { if ($this->cachedFiles !== null) { return $this->cachedFiles; } $files = $this->stubFiles; $extensions = $this->container->getServicesByTag(\PHPStan\PhpDoc\StubFilesExtension::EXTENSION_TAG); foreach ($extensions as $extension) { foreach ($extension->getFiles() as $extensionFile) { $files[] = $extensionFile; } } return $this->cachedFiles = $files; } public function getProjectStubFiles() : array { if ($this->cachedProjectFiles !== null) { return $this->cachedProjectFiles; } $filteredStubFiles = $this->getStubFiles(); foreach ($this->composerAutoloaderProjectPaths as $composerAutoloaderProjectPath) { $composerConfig = ComposerHelper::getComposerConfig($composerAutoloaderProjectPath); if ($composerConfig === null) { continue; } $vendorDir = ComposerHelper::getVendorDirFromComposerConfig($composerAutoloaderProjectPath, $composerConfig); $vendorDir = strtr($vendorDir, '\\', '/'); $filteredStubFiles = array_filter($filteredStubFiles, static function (string $file) use($vendorDir) : bool { return !str_contains(strtr($file, '\\', '/'), $vendorDir); }); } return $this->cachedProjectFiles = array_values($filteredStubFiles); } } <?php declare (strict_types=1); namespace PHPStan\PhpDoc; final class DirectTypeNodeResolverExtensionRegistryProvider implements \PHPStan\PhpDoc\TypeNodeResolverExtensionRegistryProvider { /** * @var TypeNodeResolverExtensionRegistry */ private $registry; public function __construct(\PHPStan\PhpDoc\TypeNodeResolverExtensionRegistry $registry) { $this->registry = $registry; } public function getRegistry() : \PHPStan\PhpDoc\TypeNodeResolverExtensionRegistry { return $this->registry; } } <?php declare (strict_types=1); namespace PHPStan\PhpDoc; interface TypeNodeResolverExtensionRegistryProvider { public function getRegistry() : \PHPStan\PhpDoc\TypeNodeResolverExtensionRegistry; } <?php declare (strict_types=1); namespace PHPStan\PhpDoc; use PhpParser\Node; use PhpParser\Node\Expr\Variable; use PhpParser\Node\Stmt\Class_; use PhpParser\Node\Stmt\Interface_; use PhpParser\Node\Stmt\Trait_; use PHPStan\Parser\Parser; use PHPStan\ShouldNotHappenException; use PHPStan\Type\FileTypeMapper; use function array_key_exists; use function array_map; use function is_string; final class StubPhpDocProvider { /** * @var Parser */ private $parser; /** * @var FileTypeMapper */ private $fileTypeMapper; /** * @var StubFilesProvider */ private $stubFilesProvider; /** @var array<string, ResolvedPhpDocBlock|null> */ private $classMap = []; /** @var array<string, array<string, ResolvedPhpDocBlock|null>> */ private $propertyMap = []; /** @var array<string, array<string, ResolvedPhpDocBlock|null>> */ private $constantMap = []; /** @var array<string, array<string, null>> */ private $methodMap = []; /** @var array<string, ResolvedPhpDocBlock|null> */ private $functionMap = []; /** * @var bool */ private $initialized = \false; /** * @var bool */ private $initializing = \false; /** @var array<string, array{string, string}> */ private $knownClassesDocComments = []; /** @var array<string, array{string, string}> */ private $knownFunctionsDocComments = []; /** @var array<string, array<string, array{string, string}>> */ private $knownPropertiesDocComments = []; /** @var array<string, array<string, array{string, string}>> */ private $knownConstantsDocComments = []; /** @var array<string, array<string, array{string, string}>> */ private $knownMethodsDocComments = []; /** @var array<string, array<string, array<string>>> */ private $knownMethodsParameterNames = []; /** @var array<string, array<string>> */ private $knownFunctionParameterNames = []; public function __construct(Parser $parser, FileTypeMapper $fileTypeMapper, \PHPStan\PhpDoc\StubFilesProvider $stubFilesProvider) { $this->parser = $parser; $this->fileTypeMapper = $fileTypeMapper; $this->stubFilesProvider = $stubFilesProvider; } public function findClassPhpDoc(string $className) : ?\PHPStan\PhpDoc\ResolvedPhpDocBlock { if (!$this->isKnownClass($className)) { return null; } if (array_key_exists($className, $this->classMap)) { return $this->classMap[$className]; } if (array_key_exists($className, $this->knownClassesDocComments)) { [$file, $docComment] = $this->knownClassesDocComments[$className]; $this->classMap[$className] = $this->fileTypeMapper->getResolvedPhpDoc($file, $className, null, null, $docComment); return $this->classMap[$className]; } return null; } public function findPropertyPhpDoc(string $className, string $propertyName) : ?\PHPStan\PhpDoc\ResolvedPhpDocBlock { if (!$this->isKnownClass($className)) { return null; } if (array_key_exists($propertyName, $this->propertyMap[$className])) { return $this->propertyMap[$className][$propertyName]; } if (array_key_exists($propertyName, $this->knownPropertiesDocComments[$className])) { [$file, $docComment] = $this->knownPropertiesDocComments[$className][$propertyName]; $this->propertyMap[$className][$propertyName] = $this->fileTypeMapper->getResolvedPhpDoc($file, $className, null, null, $docComment); return $this->propertyMap[$className][$propertyName]; } return null; } public function findClassConstantPhpDoc(string $className, string $constantName) : ?\PHPStan\PhpDoc\ResolvedPhpDocBlock { if (!$this->isKnownClass($className)) { return null; } if (array_key_exists($constantName, $this->constantMap[$className])) { return $this->constantMap[$className][$constantName]; } if (array_key_exists($constantName, $this->knownConstantsDocComments[$className])) { [$file, $docComment] = $this->knownConstantsDocComments[$className][$constantName]; $this->constantMap[$className][$constantName] = $this->fileTypeMapper->getResolvedPhpDoc($file, $className, null, null, $docComment); return $this->constantMap[$className][$constantName]; } return null; } /** * @param array<int, string> $positionalParameterNames */ public function findMethodPhpDoc(string $className, string $implementingClassName, string $methodName, array $positionalParameterNames) : ?\PHPStan\PhpDoc\ResolvedPhpDocBlock { if (!$this->isKnownClass($className)) { return null; } if (array_key_exists($methodName, $this->methodMap[$className])) { return $this->methodMap[$className][$methodName]; } if (array_key_exists($methodName, $this->knownMethodsDocComments[$className])) { [$file, $docComment] = $this->knownMethodsDocComments[$className][$methodName]; $resolvedPhpDoc = $this->fileTypeMapper->getResolvedPhpDoc($file, $className, null, $methodName, $docComment); if (!isset($this->knownMethodsParameterNames[$className][$methodName])) { throw new ShouldNotHappenException(); } if ($className !== $implementingClassName && $resolvedPhpDoc->getNullableNameScope() !== null) { $resolvedPhpDoc = $resolvedPhpDoc->withNameScope($resolvedPhpDoc->getNullableNameScope()->withClassName($implementingClassName)); } $methodParameterNames = $this->knownMethodsParameterNames[$className][$methodName]; $parameterNameMapping = []; foreach ($positionalParameterNames as $i => $parameterName) { if (!array_key_exists($i, $methodParameterNames)) { continue; } $parameterNameMapping[$methodParameterNames[$i]] = $parameterName; } return $resolvedPhpDoc->changeParameterNamesByMapping($parameterNameMapping); } return null; } /** * @param array<int, string> $positionalParameterNames * @throws ShouldNotHappenException */ public function findFunctionPhpDoc(string $functionName, array $positionalParameterNames) : ?\PHPStan\PhpDoc\ResolvedPhpDocBlock { if (!$this->isKnownFunction($functionName)) { return null; } if (array_key_exists($functionName, $this->functionMap)) { return $this->functionMap[$functionName]; } if (array_key_exists($functionName, $this->knownFunctionsDocComments)) { [$file, $docComment] = $this->knownFunctionsDocComments[$functionName]; $resolvedPhpDoc = $this->fileTypeMapper->getResolvedPhpDoc($file, null, null, $functionName, $docComment); if (!isset($this->knownFunctionParameterNames[$functionName])) { throw new ShouldNotHappenException(); } $functionParameterNames = $this->knownFunctionParameterNames[$functionName]; $parameterNameMapping = []; foreach ($positionalParameterNames as $i => $parameterName) { if (!array_key_exists($i, $functionParameterNames)) { continue; } $parameterNameMapping[$functionParameterNames[$i]] = $parameterName; } $this->functionMap[$functionName] = $resolvedPhpDoc->changeParameterNamesByMapping($parameterNameMapping); return $this->functionMap[$functionName]; } return null; } public function isKnownClass(string $className) : bool { $this->initializeKnownElements(); if (array_key_exists($className, $this->classMap)) { return \true; } return array_key_exists($className, $this->knownClassesDocComments); } private function isKnownFunction(string $functionName) : bool { $this->initializeKnownElements(); if (array_key_exists($functionName, $this->functionMap)) { return \true; } return array_key_exists($functionName, $this->knownFunctionsDocComments); } private function initializeKnownElements() : void { if ($this->initializing) { throw new ShouldNotHappenException(); } if ($this->initialized) { return; } $this->initializing = \true; try { foreach ($this->stubFilesProvider->getStubFiles() as $stubFile) { $nodes = $this->parser->parseFile($stubFile); foreach ($nodes as $node) { $this->initializeKnownElementNode($stubFile, $node); } } } finally { $this->initializing = \false; $this->initialized = \true; } } private function initializeKnownElementNode(string $stubFile, Node $node) : void { if ($node instanceof Node\Stmt\Namespace_) { foreach ($node->stmts as $stmt) { $this->initializeKnownElementNode($stubFile, $stmt); } return; } if ($node instanceof Node\Stmt\Function_) { $functionName = (string) $node->namespacedName; $docComment = $node->getDocComment(); if ($docComment === null) { $this->functionMap[$functionName] = null; return; } $this->knownFunctionParameterNames[$functionName] = array_map(static function (Node\Param $param) : string { if (!$param->var instanceof Variable || !is_string($param->var->name)) { throw new ShouldNotHappenException(); } return $param->var->name; }, $node->getParams()); $this->knownFunctionsDocComments[$functionName] = [$stubFile, $docComment->getText()]; return; } if (!$node instanceof Class_ && !$node instanceof Interface_ && !$node instanceof Trait_ && !$node instanceof Node\Stmt\Enum_) { return; } if (!isset($node->namespacedName)) { return; } $className = (string) $node->namespacedName; $docComment = $node->getDocComment(); if ($docComment === null) { $this->classMap[$className] = null; } else { $this->knownClassesDocComments[$className] = [$stubFile, $docComment->getText()]; } $this->methodMap[$className] = []; $this->propertyMap[$className] = []; $this->constantMap[$className] = []; $this->knownPropertiesDocComments[$className] = []; $this->knownConstantsDocComments[$className] = []; $this->knownMethodsDocComments[$className] = []; foreach ($node->stmts as $stmt) { $docComment = $stmt->getDocComment(); if ($stmt instanceof Node\Stmt\Property) { foreach ($stmt->props as $property) { if ($docComment === null) { $this->propertyMap[$className][$property->name->toString()] = null; continue; } $this->knownPropertiesDocComments[$className][$property->name->toString()] = [$stubFile, $docComment->getText()]; } } elseif ($stmt instanceof Node\Stmt\ClassConst) { foreach ($stmt->consts as $const) { if ($docComment === null) { $this->constantMap[$className][$const->name->toString()] = null; continue; } $this->knownConstantsDocComments[$className][$const->name->toString()] = [$stubFile, $docComment->getText()]; } } elseif ($stmt instanceof Node\Stmt\ClassMethod) { if ($docComment === null) { $this->methodMap[$className][$stmt->name->toString()] = null; continue; } $methodName = $stmt->name->toString(); $this->knownMethodsDocComments[$className][$methodName] = [$stubFile, $docComment->getText()]; $this->knownMethodsParameterNames[$className][$methodName] = array_map(static function (Node\Param $param) : string { if (!$param->var instanceof Variable || !is_string($param->var->name)) { throw new ShouldNotHappenException(); } return $param->var->name; }, $stmt->getParams()); } } } } <?php declare (strict_types=1); namespace PHPStan\PhpDoc; use PHPStan\Analyser\Error; use PHPStan\Analyser\FileAnalyser; use PHPStan\Analyser\InternalError; use PHPStan\Analyser\NodeScopeResolver; use PHPStan\Broker\Broker; use PHPStan\Collectors\Registry as CollectorRegistry; use PHPStan\DependencyInjection\Container; use PHPStan\DependencyInjection\DerivativeContainerFactory; use PHPStan\Php\PhpVersion; use PHPStan\PhpDocParser\Lexer\Lexer; use PHPStan\PhpDocParser\Parser\PhpDocParser; use PHPStan\Reflection\Php\PhpClassReflectionExtension; use PHPStan\Reflection\PhpVersionStaticAccessor; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Reflection\ReflectionProviderStaticAccessor; use PHPStan\Rules\Classes\DuplicateClassDeclarationRule; use PHPStan\Rules\Classes\DuplicateDeclarationRule; use PHPStan\Rules\Classes\ExistingClassesInClassImplementsRule; use PHPStan\Rules\Classes\ExistingClassesInInterfaceExtendsRule; use PHPStan\Rules\Classes\ExistingClassInClassExtendsRule; use PHPStan\Rules\Classes\ExistingClassInTraitUseRule; use PHPStan\Rules\Classes\LocalTypeAliasesCheck; use PHPStan\Rules\Classes\LocalTypeAliasesRule; use PHPStan\Rules\Classes\LocalTypeTraitAliasesRule; use PHPStan\Rules\Classes\LocalTypeTraitUseAliasesRule; use PHPStan\Rules\Classes\MethodTagCheck; use PHPStan\Rules\Classes\MethodTagRule; use PHPStan\Rules\Classes\MethodTagTraitRule; use PHPStan\Rules\Classes\MethodTagTraitUseRule; use PHPStan\Rules\Classes\MixinCheck; use PHPStan\Rules\Classes\MixinRule; use PHPStan\Rules\Classes\MixinTraitRule; use PHPStan\Rules\Classes\MixinTraitUseRule; use PHPStan\Rules\Classes\PropertyTagCheck; use PHPStan\Rules\Classes\PropertyTagRule; use PHPStan\Rules\Classes\PropertyTagTraitRule; use PHPStan\Rules\Classes\PropertyTagTraitUseRule; use PHPStan\Rules\ClassNameCheck; use PHPStan\Rules\DirectRegistry as DirectRuleRegistry; use PHPStan\Rules\FunctionDefinitionCheck; use PHPStan\Rules\Functions\DuplicateFunctionDeclarationRule; use PHPStan\Rules\Functions\MissingFunctionParameterTypehintRule; use PHPStan\Rules\Functions\MissingFunctionReturnTypehintRule; use PHPStan\Rules\Generics\ClassAncestorsRule; use PHPStan\Rules\Generics\ClassTemplateTypeRule; use PHPStan\Rules\Generics\CrossCheckInterfacesHelper; use PHPStan\Rules\Generics\FunctionSignatureVarianceRule; use PHPStan\Rules\Generics\FunctionTemplateTypeRule; use PHPStan\Rules\Generics\GenericAncestorsCheck; use PHPStan\Rules\Generics\GenericObjectTypeCheck; use PHPStan\Rules\Generics\InterfaceAncestorsRule; use PHPStan\Rules\Generics\InterfaceTemplateTypeRule; use PHPStan\Rules\Generics\MethodSignatureVarianceRule; use PHPStan\Rules\Generics\MethodTagTemplateTypeCheck; use PHPStan\Rules\Generics\MethodTagTemplateTypeRule; use PHPStan\Rules\Generics\MethodTagTemplateTypeTraitRule; use PHPStan\Rules\Generics\MethodTemplateTypeRule; use PHPStan\Rules\Generics\TemplateTypeCheck; use PHPStan\Rules\Generics\TraitTemplateTypeRule; use PHPStan\Rules\Generics\VarianceCheck; use PHPStan\Rules\Methods\ExistingClassesInTypehintsRule; use PHPStan\Rules\Methods\MethodParameterComparisonHelper; use PHPStan\Rules\Methods\MethodSignatureRule; use PHPStan\Rules\Methods\MissingMethodParameterTypehintRule; use PHPStan\Rules\Methods\MissingMethodReturnTypehintRule; use PHPStan\Rules\Methods\MissingMethodSelfOutTypeRule; use PHPStan\Rules\Methods\OverridingMethodRule; use PHPStan\Rules\MissingTypehintCheck; use PHPStan\Rules\PhpDoc\GenericCallableRuleHelper; use PHPStan\Rules\PhpDoc\IncompatibleClassConstantPhpDocTypeRule; use PHPStan\Rules\PhpDoc\IncompatibleParamImmediatelyInvokedCallableRule; use PHPStan\Rules\PhpDoc\IncompatiblePhpDocTypeRule; use PHPStan\Rules\PhpDoc\IncompatiblePropertyPhpDocTypeRule; use PHPStan\Rules\PhpDoc\IncompatibleSelfOutTypeRule; use PHPStan\Rules\PhpDoc\InvalidPhpDocTagValueRule; use PHPStan\Rules\PhpDoc\InvalidPHPStanDocTagRule; use PHPStan\Rules\PhpDoc\InvalidThrowsPhpDocValueRule; use PHPStan\Rules\PhpDoc\UnresolvableTypeHelper; use PHPStan\Rules\Properties\ExistingClassesInPropertiesRule; use PHPStan\Rules\Properties\MissingPropertyTypehintRule; use PHPStan\Rules\Registry as RuleRegistry; use PHPStan\Type\FileTypeMapper; use PHPStan\Type\ObjectType; use Throwable; use function array_fill_keys; use function count; use function sprintf; final class StubValidator { /** * @var DerivativeContainerFactory */ private $derivativeContainerFactory; /** * @var bool */ private $duplicateStubs; public function __construct(DerivativeContainerFactory $derivativeContainerFactory, bool $duplicateStubs) { $this->derivativeContainerFactory = $derivativeContainerFactory; $this->duplicateStubs = $duplicateStubs; } /** * @param string[] $stubFiles * @return list<Error> */ public function validate(array $stubFiles, bool $debug) : array { if (count($stubFiles) === 0) { return []; } $originalBroker = Broker::getInstance(); $originalReflectionProvider = ReflectionProviderStaticAccessor::getInstance(); $originalPhpVersion = PhpVersionStaticAccessor::getInstance(); $container = $this->derivativeContainerFactory->create([__DIR__ . '/../../conf/config.stubValidator.neon']); $ruleRegistry = $this->getRuleRegistry($container); $collectorRegistry = $this->getCollectorRegistry($container); $fileAnalyser = $container->getByType(FileAnalyser::class); $nodeScopeResolver = $container->getByType(NodeScopeResolver::class); $nodeScopeResolver->setAnalysedFiles($stubFiles); $pathRoutingParser = $container->getService('pathRoutingParser'); $pathRoutingParser->setAnalysedFiles($stubFiles); $analysedFiles = array_fill_keys($stubFiles, \true); $errors = []; foreach ($stubFiles as $stubFile) { try { $tmpErrors = $fileAnalyser->analyseFile($stubFile, $analysedFiles, $ruleRegistry, $collectorRegistry, static function () : void { })->getErrors(); foreach ($tmpErrors as $tmpError) { $errors[] = $tmpError->withoutTip()->doNotIgnore(); } } catch (Throwable $e) { if ($debug) { throw $e; } $internalErrorMessage = sprintf('Internal error: %s', $e->getMessage()); $errors[] = (new Error($internalErrorMessage, $stubFile, null, $e))->withIdentifier('phpstan.internal')->withMetadata([InternalError::STACK_TRACE_METADATA_KEY => InternalError::prepareTrace($e), InternalError::STACK_TRACE_AS_STRING_METADATA_KEY => $e->getTraceAsString()]); } } Broker::registerInstance($originalBroker); ReflectionProviderStaticAccessor::registerInstance($originalReflectionProvider); PhpVersionStaticAccessor::registerInstance($originalPhpVersion); ObjectType::resetCaches(); return $errors; } private function getRuleRegistry(Container $container) : RuleRegistry { $fileTypeMapper = $container->getByType(FileTypeMapper::class); $genericObjectTypeCheck = $container->getByType(GenericObjectTypeCheck::class); $genericAncestorsCheck = $container->getByType(GenericAncestorsCheck::class); $templateTypeCheck = $container->getByType(TemplateTypeCheck::class); $varianceCheck = $container->getByType(VarianceCheck::class); $reflectionProvider = $container->getByType(ReflectionProvider::class); $classNameCheck = $container->getByType(ClassNameCheck::class); $functionDefinitionCheck = $container->getByType(FunctionDefinitionCheck::class); $missingTypehintCheck = $container->getByType(MissingTypehintCheck::class); $unresolvableTypeHelper = $container->getByType(UnresolvableTypeHelper::class); $crossCheckInterfacesHelper = $container->getByType(CrossCheckInterfacesHelper::class); $phpVersion = $container->getByType(PhpVersion::class); $localTypeAliasesCheck = $container->getByType(LocalTypeAliasesCheck::class); $phpClassReflectionExtension = $container->getByType(PhpClassReflectionExtension::class); $genericCallableRuleHelper = $container->getByType(GenericCallableRuleHelper::class); $methodTagTemplateTypeCheck = $container->getByType(MethodTagTemplateTypeCheck::class); $mixinCheck = $container->getByType(MixinCheck::class); $rules = [ // level 0 new ExistingClassesInClassImplementsRule($classNameCheck, $reflectionProvider), new ExistingClassesInInterfaceExtendsRule($classNameCheck, $reflectionProvider), new ExistingClassInClassExtendsRule($classNameCheck, $reflectionProvider), new ExistingClassInTraitUseRule($classNameCheck, $reflectionProvider), new ExistingClassesInTypehintsRule($functionDefinitionCheck), new \PHPStan\Rules\Functions\ExistingClassesInTypehintsRule($functionDefinitionCheck), new ExistingClassesInPropertiesRule($reflectionProvider, $classNameCheck, $unresolvableTypeHelper, $phpVersion, \true, \false), new OverridingMethodRule($phpVersion, new MethodSignatureRule($phpClassReflectionExtension, \true, \true, $container->getParameter('featureToggles')['abstractTraitMethod']), \true, new MethodParameterComparisonHelper($phpVersion, $container->getParameter('featureToggles')['genericPrototypeMessage']), $phpClassReflectionExtension, $container->getParameter('featureToggles')['genericPrototypeMessage'], $container->getParameter('featureToggles')['finalByPhpDoc'], $container->getParameter('checkMissingOverrideMethodAttribute')), new DuplicateDeclarationRule(), new LocalTypeAliasesRule($localTypeAliasesCheck), new LocalTypeTraitAliasesRule($localTypeAliasesCheck, $reflectionProvider), // level 2 new ClassAncestorsRule($genericAncestorsCheck, $crossCheckInterfacesHelper), new ClassTemplateTypeRule($templateTypeCheck), new FunctionTemplateTypeRule($fileTypeMapper, $templateTypeCheck), new FunctionSignatureVarianceRule($varianceCheck), new InterfaceAncestorsRule($genericAncestorsCheck, $crossCheckInterfacesHelper), new InterfaceTemplateTypeRule($templateTypeCheck), new MethodTemplateTypeRule($fileTypeMapper, $templateTypeCheck), new MethodTagTemplateTypeRule($methodTagTemplateTypeCheck), new MethodSignatureVarianceRule($varianceCheck), new TraitTemplateTypeRule($fileTypeMapper, $templateTypeCheck), new IncompatiblePhpDocTypeRule($fileTypeMapper, $genericObjectTypeCheck, $unresolvableTypeHelper, $genericCallableRuleHelper), new IncompatiblePropertyPhpDocTypeRule($genericObjectTypeCheck, $unresolvableTypeHelper, $genericCallableRuleHelper), new InvalidPhpDocTagValueRule($container->getByType(Lexer::class), $container->getByType(PhpDocParser::class), $container->getParameter('featureToggles')['allInvalidPhpDocs'], $container->getParameter('featureToggles')['invalidPhpDocTagLine']), new IncompatibleParamImmediatelyInvokedCallableRule($fileTypeMapper), new IncompatibleSelfOutTypeRule($unresolvableTypeHelper, $genericObjectTypeCheck), new IncompatibleClassConstantPhpDocTypeRule($genericObjectTypeCheck, $unresolvableTypeHelper), new InvalidThrowsPhpDocValueRule($fileTypeMapper), // level 6 new MissingFunctionParameterTypehintRule($missingTypehintCheck, $container->getParameter('featureToggles')['paramOutType']), new MissingFunctionReturnTypehintRule($missingTypehintCheck), new MissingMethodParameterTypehintRule($missingTypehintCheck, $container->getParameter('featureToggles')['paramOutType']), new MissingMethodReturnTypehintRule($missingTypehintCheck), new MissingPropertyTypehintRule($missingTypehintCheck), ]; if ($this->duplicateStubs) { $reflector = $container->getService('stubReflector'); $relativePathHelper = $container->getService('simpleRelativePathHelper'); $rules[] = new DuplicateClassDeclarationRule($reflector, $relativePathHelper); $rules[] = new DuplicateFunctionDeclarationRule($reflector, $relativePathHelper); } if ((bool) $container->getParameter('featureToggles')['allInvalidPhpDocs']) { $rules[] = new InvalidPHPStanDocTagRule($container->getByType(Lexer::class), $container->getByType(PhpDocParser::class), \true); } if ((bool) $container->getParameter('featureToggles')['absentTypeChecks']) { $rules[] = new MissingMethodSelfOutTypeRule($missingTypehintCheck); $methodTagCheck = new MethodTagCheck($reflectionProvider, $classNameCheck, $genericObjectTypeCheck, $missingTypehintCheck, $unresolvableTypeHelper, \true, \true); $rules[] = new MethodTagRule($methodTagCheck); $rules[] = new MethodTagTraitRule($methodTagCheck, $reflectionProvider); $rules[] = new MethodTagTraitUseRule($methodTagCheck); $propertyTagCheck = new PropertyTagCheck($reflectionProvider, $classNameCheck, $genericObjectTypeCheck, $missingTypehintCheck, $unresolvableTypeHelper, \true, \true); $rules[] = new PropertyTagRule($propertyTagCheck); $rules[] = new PropertyTagTraitRule($propertyTagCheck, $reflectionProvider); $rules[] = new PropertyTagTraitUseRule($propertyTagCheck); $rules[] = new MixinRule($mixinCheck); $rules[] = new MixinTraitRule($mixinCheck, $reflectionProvider); $rules[] = new MixinTraitUseRule($mixinCheck); $rules[] = new LocalTypeTraitUseAliasesRule($localTypeAliasesCheck); $rules[] = new MethodTagTemplateTypeTraitRule($methodTagTemplateTypeCheck, $reflectionProvider); } return new DirectRuleRegistry($rules); } private function getCollectorRegistry(Container $container) : CollectorRegistry { return new CollectorRegistry([]); } } <?php declare (strict_types=1); namespace PHPStan\PhpDoc; use PHPStan\Analyser\NameScope; use PHPStan\PhpDocParser\Ast\ConstExpr\ConstExprArrayNode; use PHPStan\PhpDocParser\Ast\ConstExpr\ConstExprFalseNode; use PHPStan\PhpDocParser\Ast\ConstExpr\ConstExprFloatNode; use PHPStan\PhpDocParser\Ast\ConstExpr\ConstExprIntegerNode; use PHPStan\PhpDocParser\Ast\ConstExpr\ConstExprNode; use PHPStan\PhpDocParser\Ast\ConstExpr\ConstExprNullNode; use PHPStan\PhpDocParser\Ast\ConstExpr\ConstExprStringNode; use PHPStan\PhpDocParser\Ast\ConstExpr\ConstExprTrueNode; use PHPStan\PhpDocParser\Ast\ConstExpr\ConstFetchNode; use PHPStan\Reflection\InitializerExprContext; use PHPStan\Reflection\InitializerExprTypeResolver; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Type\Constant\ConstantArrayTypeBuilder; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantFloatType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\Enum\EnumCaseObjectType; use PHPStan\Type\ErrorType; use PHPStan\Type\NullType; use PHPStan\Type\Type; use function strtolower; final class ConstExprNodeResolver { /** * @var ReflectionProvider\ReflectionProviderProvider */ private $reflectionProviderProvider; /** * @var InitializerExprTypeResolver */ private $initializerExprTypeResolver; public function __construct(ReflectionProvider\ReflectionProviderProvider $reflectionProviderProvider, InitializerExprTypeResolver $initializerExprTypeResolver) { $this->reflectionProviderProvider = $reflectionProviderProvider; $this->initializerExprTypeResolver = $initializerExprTypeResolver; } public function resolve(ConstExprNode $node, NameScope $nameScope) : Type { if ($node instanceof ConstExprArrayNode) { return $this->resolveArrayNode($node, $nameScope); } if ($node instanceof ConstExprFalseNode) { return new ConstantBooleanType(\false); } if ($node instanceof ConstExprTrueNode) { return new ConstantBooleanType(\true); } if ($node instanceof ConstExprFloatNode) { return new ConstantFloatType((float) $node->value); } if ($node instanceof ConstExprIntegerNode) { return new ConstantIntegerType((int) $node->value); } if ($node instanceof ConstExprNullNode) { return new NullType(); } if ($node instanceof ConstExprStringNode) { return new ConstantStringType($node->value); } if ($node instanceof ConstFetchNode) { if ($nameScope->getClassName() !== null) { switch (strtolower($node->className)) { case 'static': case 'self': $className = $nameScope->getClassName(); break; case 'parent': if ($this->getReflectionProvider()->hasClass($nameScope->getClassName())) { $classReflection = $this->getReflectionProvider()->getClass($nameScope->getClassName()); if ($classReflection->getParentClass() === null) { return new ErrorType(); } $className = $classReflection->getParentClass()->getName(); } break; } } if (!isset($className)) { $className = $nameScope->resolveStringName($node->className); } if (!$this->getReflectionProvider()->hasClass($className)) { return new ErrorType(); } $classReflection = $this->getReflectionProvider()->getClass($className); if (!$classReflection->hasConstant($node->name)) { return new ErrorType(); } if ($classReflection->isEnum() && $classReflection->hasEnumCase($node->name)) { return new EnumCaseObjectType($classReflection->getName(), $node->name); } $reflectionConstant = $classReflection->getNativeReflection()->getReflectionConstant($node->name); if ($reflectionConstant === \false) { return new ErrorType(); } $declaringClass = $reflectionConstant->getDeclaringClass(); return $this->initializerExprTypeResolver->getType($reflectionConstant->getValueExpression(), InitializerExprContext::fromClass($declaringClass->getName(), $declaringClass->getFileName() ?: null)); } return new ErrorType(); } private function resolveArrayNode(ConstExprArrayNode $node, NameScope $nameScope) : Type { $arrayBuilder = ConstantArrayTypeBuilder::createEmpty(); foreach ($node->items as $item) { if ($item->key === null) { $key = null; } else { $key = $this->resolve($item->key, $nameScope); } $arrayBuilder->setOffsetValueType($key, $this->resolve($item->value, $nameScope)); } return $arrayBuilder->getArray(); } private function getReflectionProvider() : ReflectionProvider { return $this->reflectionProviderProvider->getReflectionProvider(); } } <?php declare (strict_types=1); namespace PHPStan\PhpDoc; final class CountableStubFilesExtension implements \PHPStan\PhpDoc\StubFilesExtension { /** * @var bool */ private $bleedingEdge; public function __construct(bool $bleedingEdge) { $this->bleedingEdge = $bleedingEdge; } public function getFiles() : array { if ($this->bleedingEdge) { return [__DIR__ . '/../../stubs/bleedingEdge/Countable.stub']; } return [__DIR__ . '/../../stubs/Countable.stub']; } } <?php declare (strict_types=1); namespace PHPStan\PhpDoc; use PHPStan\Analyser\NameScope; use PHPStan\PhpDocParser\Lexer\Lexer; use PHPStan\PhpDocParser\Parser\TokenIterator; use PHPStan\PhpDocParser\Parser\TypeParser; use PHPStan\Type\Type; final class TypeStringResolver { /** * @var Lexer */ private $typeLexer; /** * @var TypeParser */ private $typeParser; /** * @var TypeNodeResolver */ private $typeNodeResolver; public function __construct(Lexer $typeLexer, TypeParser $typeParser, \PHPStan\PhpDoc\TypeNodeResolver $typeNodeResolver) { $this->typeLexer = $typeLexer; $this->typeParser = $typeParser; $this->typeNodeResolver = $typeNodeResolver; } /** @api */ public function resolve(string $typeString, ?NameScope $nameScope = null) : Type { $tokens = new TokenIterator($this->typeLexer->tokenize($typeString)); $typeNode = $this->typeParser->parse($tokens); $tokens->consumeTokenType(Lexer::TOKEN_END); // @phpstan-ignore missingType.checkedException return $this->typeNodeResolver->resolve($typeNode, $nameScope ?? new NameScope(null, [])); } } <?php declare (strict_types=1); namespace PHPStan\PhpDoc; use PHPStan\Php\PhpVersion; final class ReflectionEnumStubFilesExtension implements \PHPStan\PhpDoc\StubFilesExtension { /** * @var PhpVersion */ private $phpVersion; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; } public function getFiles() : array { if (!$this->phpVersion->supportsEnums()) { return []; } return [__DIR__ . '/../../stubs/ReflectionEnum.stub']; } } <?php declare (strict_types=1); namespace PHPStan\PhpDoc; use PHPStan\Analyser\NameScope; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\Type\Type; /** * This is the interface type node resolver extensions implement for custom PHPDoc types. * * To register it in the configuration file use the `phpstan.phpDoc.typeNodeResolverExtension` service tag: * * ``` * services: * - * class: App\PHPStan\MyExtension * tags: * - phpstan.phpDoc.typeNodeResolverExtension * ``` * * Learn more: https://phpstan.org/developing-extensions/custom-phpdoc-types * * @api */ interface TypeNodeResolverExtension { public const EXTENSION_TAG = 'phpstan.phpDoc.typeNodeResolverExtension'; public function resolve(TypeNode $typeNode, NameScope $nameScope) : ?Type; } <?php declare (strict_types=1); namespace PHPStan\PhpDoc; /** @api */ interface TypeNodeResolverAwareExtension { public function setTypeNodeResolver(\PHPStan\PhpDoc\TypeNodeResolver $typeNodeResolver) : void; } <?php declare (strict_types=1); namespace PHPStan\PhpDoc; use PHPStan\Php\PhpVersion; final class JsonValidateStubFilesExtension implements \PHPStan\PhpDoc\StubFilesExtension { /** * @var PhpVersion */ private $phpVersion; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; } public function getFiles() : array { if (!$this->phpVersion->supportsJsonValidate()) { return []; } return [__DIR__ . '/../../stubs/json_validate.stub']; } } <?php declare (strict_types=1); namespace PHPStan\PhpDoc; use PHPStan\DependencyInjection\Container; final class LazyTypeNodeResolverExtensionRegistryProvider implements \PHPStan\PhpDoc\TypeNodeResolverExtensionRegistryProvider { /** * @var Container */ private $container; /** * @var ?TypeNodeResolverExtensionRegistry */ private $registry = null; public function __construct(Container $container) { $this->container = $container; } public function getRegistry() : \PHPStan\PhpDoc\TypeNodeResolverExtensionRegistry { if ($this->registry === null) { $this->registry = new \PHPStan\PhpDoc\TypeNodeResolverExtensionAwareRegistry($this->container->getByType(\PHPStan\PhpDoc\TypeNodeResolver::class), $this->container->getServicesByTag(\PHPStan\PhpDoc\TypeNodeResolverExtension::EXTENSION_TAG)); } return $this->registry; } } <?php declare (strict_types=1); namespace PHPStan\PhpDoc; use PHPStan\PhpDoc\Tag\AssertTagParameter; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\Php\PhpMethodReflection; use PHPStan\Reflection\ResolvedMethodReflection; use PHPStan\Type\ConditionalTypeForParameter; use PHPStan\Type\Type; use PHPStan\Type\TypeTraverser; use function array_key_exists; use function count; use function is_bool; use function strtolower; use function substr; final class PhpDocBlock { /** * @var string */ private $docComment; /** * @var ?string */ private $file; /** * @var ClassReflection */ private $classReflection; /** * @var ?string */ private $trait; /** * @var bool */ private $explicit; /** * @var array<string, string> */ private $parameterNameMapping; /** * @var array<int, self> */ private $parents; /** * @param array<string, string> $parameterNameMapping * @param array<int, self> $parents */ private function __construct(string $docComment, ?string $file, ClassReflection $classReflection, ?string $trait, bool $explicit, array $parameterNameMapping, array $parents) { $this->docComment = $docComment; $this->file = $file; $this->classReflection = $classReflection; $this->trait = $trait; $this->explicit = $explicit; $this->parameterNameMapping = $parameterNameMapping; $this->parents = $parents; } public function getDocComment() : string { return $this->docComment; } public function getFile() : ?string { return $this->file; } public function getClassReflection() : ClassReflection { return $this->classReflection; } public function getTrait() : ?string { return $this->trait; } public function isExplicit() : bool { return $this->explicit; } /** * @return array<int, self> */ public function getParents() : array { return $this->parents; } /** * @template T * @param array<string, T> $array * @return array<string, T> */ public function transformArrayKeysWithParameterNameMapping(array $array) : array { $newArray = []; foreach ($array as $key => $value) { if (!array_key_exists($key, $this->parameterNameMapping)) { continue; } $newArray[$this->parameterNameMapping[$key]] = $value; } return $newArray; } public function transformConditionalReturnTypeWithParameterNameMapping(Type $type) : Type { return TypeTraverser::map($type, function (Type $type, callable $traverse) : Type { if ($type instanceof ConditionalTypeForParameter) { $parameterName = substr($type->getParameterName(), 1); if (array_key_exists($parameterName, $this->parameterNameMapping)) { $type = $type->changeParameterName('$' . $this->parameterNameMapping[$parameterName]); } } return $traverse($type); }); } public function transformAssertTagParameterWithParameterNameMapping(AssertTagParameter $parameter) : AssertTagParameter { $parameterName = substr($parameter->getParameterName(), 1); if (array_key_exists($parameterName, $this->parameterNameMapping)) { $parameter = $parameter->changeParameterName('$' . $this->parameterNameMapping[$parameterName]); } return $parameter; } public static function resolvePhpDocBlockForProperty(?string $docComment, ClassReflection $classReflection, ?string $trait, string $propertyName, ?string $file, ?bool $explicit) : self { $docBlocksFromParents = []; foreach (self::getParentReflections($classReflection) as $parentReflection) { $oneResult = self::resolvePropertyPhpDocBlockFromClass($parentReflection, $propertyName, $explicit ?? $docComment !== null); if ($oneResult === null) { // Null if it is private or from a wrong trait. continue; } $docBlocksFromParents[] = $oneResult; } return new self($docComment ?? \PHPStan\PhpDoc\ResolvedPhpDocBlock::EMPTY_DOC_STRING, $file, $classReflection, $trait, $explicit ?? \true, [], $docBlocksFromParents); } public static function resolvePhpDocBlockForConstant(?string $docComment, ClassReflection $classReflection, string $constantName, ?string $file, ?bool $explicit) : self { $docBlocksFromParents = []; foreach (self::getParentReflections($classReflection) as $parentReflection) { $oneResult = self::resolveConstantPhpDocBlockFromClass($parentReflection, $constantName, $explicit ?? $docComment !== null); if ($oneResult === null) { // Null if it is private or from a wrong trait. continue; } $docBlocksFromParents[] = $oneResult; } return new self($docComment ?? \PHPStan\PhpDoc\ResolvedPhpDocBlock::EMPTY_DOC_STRING, $file, $classReflection, null, $explicit ?? \true, [], $docBlocksFromParents); } /** * @param array<int, string> $originalPositionalParameterNames * @param array<int, string> $newPositionalParameterNames */ public static function resolvePhpDocBlockForMethod(?string $docComment, ClassReflection $classReflection, ?string $trait, string $methodName, ?string $file, ?bool $explicit, array $originalPositionalParameterNames, array $newPositionalParameterNames) : self { $docBlocksFromParents = []; foreach (self::getParentReflections($classReflection) as $parentReflection) { $oneResult = self::resolveMethodPhpDocBlockFromClass($parentReflection, $methodName, $explicit ?? $docComment !== null, $newPositionalParameterNames); if ($oneResult === null) { // Null if it is private or from a wrong trait. continue; } $docBlocksFromParents[] = $oneResult; } foreach ($classReflection->getTraits(\true) as $traitReflection) { if (!$traitReflection->hasNativeMethod($methodName)) { continue; } $traitMethod = $traitReflection->getNativeMethod($methodName); $abstract = $traitMethod->isAbstract(); if (is_bool($abstract)) { if (!$abstract) { continue; } } elseif (!$abstract->yes()) { continue; } $methodVariant = $traitMethod->getOnlyVariant(); $positionalMethodParameterNames = []; foreach ($methodVariant->getParameters() as $methodParameter) { $positionalMethodParameterNames[] = $methodParameter->getName(); } $docBlocksFromParents[] = new self($traitMethod->getDocComment() ?? \PHPStan\PhpDoc\ResolvedPhpDocBlock::EMPTY_DOC_STRING, $classReflection->getFileName(), $classReflection, $traitReflection->getName(), $explicit ?? $traitMethod->getDocComment() !== null, self::remapParameterNames($newPositionalParameterNames, $positionalMethodParameterNames), []); } return new self($docComment ?? \PHPStan\PhpDoc\ResolvedPhpDocBlock::EMPTY_DOC_STRING, $file, $classReflection, $trait, $explicit ?? \true, self::remapParameterNames($originalPositionalParameterNames, $newPositionalParameterNames), $docBlocksFromParents); } /** * @param array<int, string> $originalPositionalParameterNames * @param array<int, string> $newPositionalParameterNames * @return array<string, string> */ private static function remapParameterNames(array $originalPositionalParameterNames, array $newPositionalParameterNames) : array { $parameterNameMapping = []; foreach ($originalPositionalParameterNames as $i => $parameterName) { if (!array_key_exists($i, $newPositionalParameterNames)) { continue; } $parameterNameMapping[$newPositionalParameterNames[$i]] = $parameterName; } return $parameterNameMapping; } /** * @return array<int, ClassReflection> */ private static function getParentReflections(ClassReflection $classReflection) : array { $result = []; $parent = $classReflection->getParentClass(); if ($parent !== null) { $result[] = $parent; } foreach ($classReflection->getInterfaces() as $interface) { $result[] = $interface; } return $result; } private static function resolveConstantPhpDocBlockFromClass(ClassReflection $classReflection, string $name, bool $explicit) : ?self { if ($classReflection->hasConstant($name)) { $parentReflection = $classReflection->getConstant($name); if ($parentReflection->isPrivate()) { return null; } $classReflection = $parentReflection->getDeclaringClass(); return self::resolvePhpDocBlockForConstant($parentReflection->getDocComment() ?? \PHPStan\PhpDoc\ResolvedPhpDocBlock::EMPTY_DOC_STRING, $classReflection, $name, $classReflection->getFileName(), $explicit); } return null; } private static function resolvePropertyPhpDocBlockFromClass(ClassReflection $classReflection, string $name, bool $explicit) : ?self { if ($classReflection->hasNativeProperty($name)) { $parentReflection = $classReflection->getNativeProperty($name); if ($parentReflection->isPrivate()) { return null; } $classReflection = $parentReflection->getDeclaringClass(); $traitReflection = $parentReflection->getDeclaringTrait(); $trait = $traitReflection !== null ? $traitReflection->getName() : null; return self::resolvePhpDocBlockForProperty($parentReflection->getDocComment() ?? \PHPStan\PhpDoc\ResolvedPhpDocBlock::EMPTY_DOC_STRING, $classReflection, $trait, $name, $classReflection->getFileName(), $explicit); } return null; } /** * @param array<int, string> $positionalParameterNames */ private static function resolveMethodPhpDocBlockFromClass(ClassReflection $classReflection, string $name, bool $explicit, array $positionalParameterNames) : ?self { if ($classReflection->hasNativeMethod($name)) { $parentReflection = $classReflection->getNativeMethod($name); if ($parentReflection->isPrivate()) { return null; } $classReflection = $parentReflection->getDeclaringClass(); $traitReflection = null; if ($parentReflection instanceof PhpMethodReflection || $parentReflection instanceof ResolvedMethodReflection) { $traitReflection = $parentReflection->getDeclaringTrait(); } $methodVariants = $parentReflection->getVariants(); $positionalMethodParameterNames = []; $lowercaseMethodName = strtolower($parentReflection->getName()); if (count($methodVariants) === 1 && $lowercaseMethodName !== '__construct' && $lowercaseMethodName !== strtolower($parentReflection->getDeclaringClass()->getName())) { $methodParameters = $methodVariants[0]->getParameters(); foreach ($methodParameters as $methodParameter) { $positionalMethodParameterNames[] = $methodParameter->getName(); } } else { $positionalMethodParameterNames = $positionalParameterNames; } $trait = $traitReflection !== null ? $traitReflection->getName() : null; return self::resolvePhpDocBlockForMethod($parentReflection->getDocComment() ?? \PHPStan\PhpDoc\ResolvedPhpDocBlock::EMPTY_DOC_STRING, $classReflection, $trait, $name, $classReflection->getFileName(), $explicit, $positionalParameterNames, $positionalMethodParameterNames); } return null; } } <?php declare (strict_types=1); namespace PHPStan\PhpDoc; interface StubFilesProvider { /** @return string[] */ public function getStubFiles() : array; /** @return string[] */ public function getProjectStubFiles() : array; } <?php declare (strict_types=1); namespace PHPStan\PhpDoc; use Exception; final class NameScopeAlreadyBeingCreatedException extends Exception { } <?php declare (strict_types=1); namespace PHPStan\PhpDoc; use PHPStan\Php\PhpVersion; final class SocketSelectStubFilesExtension implements \PHPStan\PhpDoc\StubFilesExtension { /** * @var PhpVersion */ private $phpVersion; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; } public function getFiles() : array { if ($this->phpVersion->getVersionId() >= 80000) { return [__DIR__ . '/../../stubs/socket_select_php8.stub']; } return [__DIR__ . '/../../stubs/socket_select.stub']; } } <?php declare (strict_types=1); namespace PHPStan\PhpDoc; /** * This is the extension interface to implement if you want to dynamically * load stub files based on your logic. As opposed to simply list them in the configuration file. * * To register it in the configuration file use the `phpstan.stubFilesExtension` service tag: * * ``` * services: * - * class: App\PHPStan\MyExtension * tags: * - phpstan.stubFilesExtension * ``` * * @api */ interface StubFilesExtension { public const EXTENSION_TAG = 'phpstan.stubFilesExtension'; /** @return string[] */ public function getFiles() : array; } <?php declare (strict_types=1); namespace PHPStan\PhpDoc; final class TypeNodeResolverExtensionAwareRegistry implements \PHPStan\PhpDoc\TypeNodeResolverExtensionRegistry { /** * @var TypeNodeResolverExtension[] */ private $extensions; /** * @param TypeNodeResolverExtension[] $extensions */ public function __construct(\PHPStan\PhpDoc\TypeNodeResolver $typeNodeResolver, array $extensions) { $this->extensions = $extensions; foreach ($extensions as $extension) { if (!$extension instanceof \PHPStan\PhpDoc\TypeNodeResolverAwareExtension) { continue; } $extension->setTypeNodeResolver($typeNodeResolver); } } /** * @return TypeNodeResolverExtension[] */ public function getExtensions() : array { return $this->extensions; } } <?php declare (strict_types=1); namespace PHPStan\PhpDoc; use PHPStan\Analyser\NameScope; use PHPStan\PhpDoc\Tag\AssertTag; use PHPStan\PhpDoc\Tag\DeprecatedTag; use PHPStan\PhpDoc\Tag\ExtendsTag; use PHPStan\PhpDoc\Tag\ImplementsTag; use PHPStan\PhpDoc\Tag\MethodTag; use PHPStan\PhpDoc\Tag\MixinTag; use PHPStan\PhpDoc\Tag\ParamClosureThisTag; use PHPStan\PhpDoc\Tag\ParamOutTag; use PHPStan\PhpDoc\Tag\ParamTag; use PHPStan\PhpDoc\Tag\PropertyTag; use PHPStan\PhpDoc\Tag\RequireExtendsTag; use PHPStan\PhpDoc\Tag\RequireImplementsTag; use PHPStan\PhpDoc\Tag\ReturnTag; use PHPStan\PhpDoc\Tag\SelfOutTypeTag; use PHPStan\PhpDoc\Tag\TemplateTag; use PHPStan\PhpDoc\Tag\ThrowsTag; use PHPStan\PhpDoc\Tag\TypeAliasImportTag; use PHPStan\PhpDoc\Tag\TypeAliasTag; use PHPStan\PhpDoc\Tag\TypedTag; use PHPStan\PhpDoc\Tag\UsesTag; use PHPStan\PhpDoc\Tag\VarTag; use PHPStan\PhpDocParser\Ast\PhpDoc\PhpDocNode; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Type\ConditionalTypeForParameter; use PHPStan\Type\Generic\TemplateTypeHelper; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\Generic\TemplateTypeVariance; use PHPStan\Type\StaticType; use PHPStan\Type\Type; use PHPStan\Type\TypeTraverser; use function array_key_exists; use function array_map; use function count; use function is_bool; use function substr; /** * @api * @final */ class ResolvedPhpDocBlock { public const EMPTY_DOC_STRING = '/** */'; /** * @var PhpDocNode */ private $phpDocNode; /** @var PhpDocNode[] */ private $phpDocNodes; /** * @var string */ private $phpDocString; /** * @var ?string */ private $filename; /** * @var ?NameScope */ private $nameScope = null; /** * @var TemplateTypeMap */ private $templateTypeMap; /** @var array<string, TemplateTag> */ private $templateTags; /** * @var PhpDocNodeResolver */ private $phpDocNodeResolver; /** * @var ReflectionProvider */ private $reflectionProvider; /** @var array<(string|int), VarTag>|false */ private $varTags = \false; /** @var array<string, MethodTag>|false */ private $methodTags = \false; /** @var array<string, PropertyTag>|false */ private $propertyTags = \false; /** @var array<string, ExtendsTag>|false */ private $extendsTags = \false; /** @var array<string, ImplementsTag>|false */ private $implementsTags = \false; /** @var array<string, UsesTag>|false */ private $usesTags = \false; /** @var array<string, ParamTag>|false */ private $paramTags = \false; /** @var array<string, ParamOutTag>|false */ private $paramOutTags = \false; /** @var array<string, bool>|false */ private $paramsImmediatelyInvokedCallable = \false; /** @var array<string, ParamClosureThisTag>|false */ private $paramClosureThisTags = \false; /** * @var ReturnTag|false|null */ private $returnTag = \false; /** * @var ThrowsTag|false|null */ private $throwsTag = \false; /** @var array<MixinTag>|false */ private $mixinTags = \false; /** @var array<RequireExtendsTag>|false */ private $requireExtendsTags = \false; /** @var array<RequireImplementsTag>|false */ private $requireImplementsTags = \false; /** @var array<TypeAliasTag>|false */ private $typeAliasTags = \false; /** @var array<TypeAliasImportTag>|false */ private $typeAliasImportTags = \false; /** @var array<AssertTag>|false */ private $assertTags = \false; /** * @var SelfOutTypeTag|false|null */ private $selfOutTypeTag = \false; /** * @var DeprecatedTag|false|null */ private $deprecatedTag = \false; /** * @var ?bool */ private $isDeprecated = null; /** * @var ?bool */ private $isNotDeprecated = null; /** * @var ?bool */ private $isInternal = null; /** * @var ?bool */ private $isFinal = null; /** @var bool|'notLoaded'|null */ private $isPure = 'notLoaded'; /** * @var ?bool */ private $isReadOnly = null; /** * @var ?bool */ private $isImmutable = null; /** * @var ?bool */ private $isAllowedPrivateMutation = null; /** * @var ?bool */ private $hasConsistentConstructor = null; /** * @var ?bool */ private $acceptsNamedArguments = null; private function __construct() { } /** * @param TemplateTag[] $templateTags */ public static function create(PhpDocNode $phpDocNode, string $phpDocString, ?string $filename, NameScope $nameScope, TemplateTypeMap $templateTypeMap, array $templateTags, \PHPStan\PhpDoc\PhpDocNodeResolver $phpDocNodeResolver, ReflectionProvider $reflectionProvider) : self { // new property also needs to be added to withNameScope(), createEmpty() and merge() $self = new self(); $self->phpDocNode = $phpDocNode; $self->phpDocNodes = [$phpDocNode]; $self->phpDocString = $phpDocString; $self->filename = $filename; $self->nameScope = $nameScope; $self->templateTypeMap = $templateTypeMap; $self->templateTags = $templateTags; $self->phpDocNodeResolver = $phpDocNodeResolver; $self->reflectionProvider = $reflectionProvider; return $self; } public function withNameScope(NameScope $nameScope) : self { $self = new self(); $self->phpDocNode = $this->phpDocNode; $self->phpDocNodes = $this->phpDocNodes; $self->phpDocString = $this->phpDocString; $self->filename = $this->filename; $self->nameScope = $nameScope; $self->templateTypeMap = $this->templateTypeMap; $self->templateTags = $this->templateTags; $self->phpDocNodeResolver = $this->phpDocNodeResolver; $self->reflectionProvider = $this->reflectionProvider; return $self; } public static function createEmpty() : self { // new property also needs to be added to merge() $self = new self(); $self->phpDocString = self::EMPTY_DOC_STRING; $self->phpDocNodes = []; $self->filename = null; $self->templateTypeMap = TemplateTypeMap::createEmpty(); $self->templateTags = []; $self->varTags = []; $self->methodTags = []; $self->propertyTags = []; $self->extendsTags = []; $self->implementsTags = []; $self->usesTags = []; $self->paramTags = []; $self->paramOutTags = []; $self->paramsImmediatelyInvokedCallable = []; $self->paramClosureThisTags = []; $self->returnTag = null; $self->throwsTag = null; $self->mixinTags = []; $self->requireExtendsTags = []; $self->requireImplementsTags = []; $self->typeAliasTags = []; $self->typeAliasImportTags = []; $self->assertTags = []; $self->selfOutTypeTag = null; $self->deprecatedTag = null; $self->isDeprecated = \false; $self->isNotDeprecated = \false; $self->isInternal = \false; $self->isFinal = \false; $self->isPure = null; $self->isReadOnly = \false; $self->isImmutable = \false; $self->isAllowedPrivateMutation = \false; $self->hasConsistentConstructor = \false; $self->acceptsNamedArguments = \true; return $self; } /** * @param array<int, self> $parents * @param array<int, PhpDocBlock> $parentPhpDocBlocks */ public function merge(array $parents, array $parentPhpDocBlocks) : self { $className = $this->nameScope !== null ? $this->nameScope->getClassName() : null; $classReflection = $className !== null && $this->reflectionProvider->hasClass($className) ? $this->reflectionProvider->getClass($className) : null; // new property also needs to be added to createEmpty() $result = new self(); // we will resolve everything on $this here so these properties don't have to be populated // skip $result->phpDocNode $phpDocNodes = $this->phpDocNodes; $acceptsNamedArguments = $this->acceptsNamedArguments(); foreach ($parents as $parent) { foreach ($parent->phpDocNodes as $phpDocNode) { $phpDocNodes[] = $phpDocNode; $acceptsNamedArguments = $acceptsNamedArguments && $parent->acceptsNamedArguments(); } } $result->phpDocNodes = $phpDocNodes; $result->phpDocString = $this->phpDocString; $result->filename = $this->filename; // skip $result->nameScope $result->templateTypeMap = $this->templateTypeMap; $result->templateTags = $this->templateTags; // skip $result->phpDocNodeResolver $result->varTags = self::mergeVarTags($this->getVarTags(), $parents, $parentPhpDocBlocks); $result->methodTags = $this->getMethodTags(); $result->propertyTags = $this->getPropertyTags(); $result->extendsTags = $this->getExtendsTags(); $result->implementsTags = $this->getImplementsTags(); $result->usesTags = $this->getUsesTags(); $result->paramTags = self::mergeParamTags($this->getParamTags(), $parents, $parentPhpDocBlocks); $result->paramOutTags = self::mergeParamOutTags($this->getParamOutTags(), $parents, $parentPhpDocBlocks); $result->paramsImmediatelyInvokedCallable = self::mergeParamsImmediatelyInvokedCallable($this->getParamsImmediatelyInvokedCallable(), $parents, $parentPhpDocBlocks); $result->paramClosureThisTags = self::mergeParamClosureThisTags($this->getParamClosureThisTags(), $parents, $parentPhpDocBlocks); $result->returnTag = self::mergeReturnTags($this->getReturnTag(), $classReflection, $parents, $parentPhpDocBlocks); $result->throwsTag = self::mergeThrowsTags($this->getThrowsTag(), $parents); $result->mixinTags = $this->getMixinTags(); $result->requireExtendsTags = $this->getRequireExtendsTags(); $result->requireImplementsTags = $this->getRequireImplementsTags(); $result->typeAliasTags = $this->getTypeAliasTags(); $result->typeAliasImportTags = $this->getTypeAliasImportTags(); $result->assertTags = self::mergeAssertTags($this->getAssertTags(), $parents, $parentPhpDocBlocks); $result->selfOutTypeTag = self::mergeSelfOutTypeTags($this->getSelfOutTag(), $parents); $result->deprecatedTag = self::mergeDeprecatedTags($this->getDeprecatedTag(), $this->isNotDeprecated(), $parents); $result->isDeprecated = $result->deprecatedTag !== null; $result->isNotDeprecated = $this->isNotDeprecated(); $result->isInternal = $this->isInternal(); $result->isFinal = $this->isFinal(); $result->isPure = self::mergePureTags($this->isPure(), $parents); $result->isReadOnly = $this->isReadOnly(); $result->isImmutable = $this->isImmutable(); $result->isAllowedPrivateMutation = $this->isAllowedPrivateMutation(); $result->hasConsistentConstructor = $this->hasConsistentConstructor(); $result->acceptsNamedArguments = $acceptsNamedArguments; return $result; } /** * @param array<string, string> $parameterNameMapping */ public function changeParameterNamesByMapping(array $parameterNameMapping) : self { if (count($this->phpDocNodes) === 0) { return $this; } $mapParameterCb = static function (Type $type, callable $traverse) use($parameterNameMapping) : Type { if ($type instanceof ConditionalTypeForParameter) { $parameterName = substr($type->getParameterName(), 1); if (array_key_exists($parameterName, $parameterNameMapping)) { $type = $type->changeParameterName('$' . $parameterNameMapping[$parameterName]); } } return $traverse($type); }; $newParamTags = []; foreach ($this->getParamTags() as $key => $paramTag) { if (!array_key_exists($key, $parameterNameMapping)) { continue; } $transformedType = TypeTraverser::map($paramTag->getType(), $mapParameterCb); $newParamTags[$parameterNameMapping[$key]] = $paramTag->withType($transformedType); } $newParamOutTags = []; foreach ($this->getParamOutTags() as $key => $paramOutTag) { if (!array_key_exists($key, $parameterNameMapping)) { continue; } $transformedType = TypeTraverser::map($paramOutTag->getType(), $mapParameterCb); $newParamOutTags[$parameterNameMapping[$key]] = $paramOutTag->withType($transformedType); } $newParamsImmediatelyInvokedCallable = []; foreach ($this->getParamsImmediatelyInvokedCallable() as $key => $immediatelyInvokedCallable) { if (!array_key_exists($key, $parameterNameMapping)) { continue; } $newParamsImmediatelyInvokedCallable[$parameterNameMapping[$key]] = $immediatelyInvokedCallable; } $paramClosureThisTags = $this->getParamClosureThisTags(); $newParamClosureThisTags = []; foreach ($paramClosureThisTags as $key => $paramClosureThisTag) { if (!array_key_exists($key, $parameterNameMapping)) { continue; } $transformedType = TypeTraverser::map($paramClosureThisTag->getType(), $mapParameterCb); $newParamClosureThisTags[$parameterNameMapping[$key]] = $paramClosureThisTag->withType($transformedType); } $returnTag = $this->getReturnTag(); if ($returnTag !== null) { $transformedType = TypeTraverser::map($returnTag->getType(), $mapParameterCb); $returnTag = $returnTag->withType($transformedType); } $assertTags = $this->getAssertTags(); if (count($assertTags) > 0) { $assertTags = array_map(static function (AssertTag $tag) use($parameterNameMapping) : AssertTag { $parameterName = substr($tag->getParameter()->getParameterName(), 1); if (array_key_exists($parameterName, $parameterNameMapping)) { $tag = $tag->withParameter($tag->getParameter()->changeParameterName('$' . $parameterNameMapping[$parameterName])); } return $tag; }, $assertTags); } $self = new self(); $self->phpDocNode = $this->phpDocNode; $self->phpDocNodes = $this->phpDocNodes; $self->phpDocString = $this->phpDocString; $self->filename = $this->filename; $self->nameScope = $this->nameScope; $self->templateTypeMap = $this->templateTypeMap; $self->templateTags = $this->templateTags; $self->phpDocNodeResolver = $this->phpDocNodeResolver; $self->reflectionProvider = $this->reflectionProvider; $self->varTags = $this->varTags; $self->methodTags = $this->methodTags; $self->propertyTags = $this->propertyTags; $self->extendsTags = $this->extendsTags; $self->implementsTags = $this->implementsTags; $self->usesTags = $this->usesTags; $self->paramTags = $newParamTags; $self->paramOutTags = $newParamOutTags; $self->paramsImmediatelyInvokedCallable = $newParamsImmediatelyInvokedCallable; $self->paramClosureThisTags = $newParamClosureThisTags; $self->returnTag = $returnTag; $self->throwsTag = $this->throwsTag; $self->mixinTags = $this->mixinTags; $self->requireImplementsTags = $this->requireImplementsTags; $self->requireExtendsTags = $this->requireExtendsTags; $self->typeAliasTags = $this->typeAliasTags; $self->typeAliasImportTags = $this->typeAliasImportTags; $self->assertTags = $assertTags; $self->selfOutTypeTag = $this->selfOutTypeTag; $self->deprecatedTag = $this->deprecatedTag; $self->isDeprecated = $this->isDeprecated; $self->isNotDeprecated = $this->isNotDeprecated; $self->isInternal = $this->isInternal; $self->isFinal = $this->isFinal; $self->isPure = $this->isPure; return $self; } public function hasPhpDocString() : bool { return $this->phpDocString !== self::EMPTY_DOC_STRING; } public function getPhpDocString() : string { return $this->phpDocString; } /** * @return PhpDocNode[] */ public function getPhpDocNodes() : array { return $this->phpDocNodes; } public function getFilename() : ?string { return $this->filename; } private function getNameScope() : NameScope { return $this->nameScope; } public function getNullableNameScope() : ?NameScope { return $this->nameScope; } /** * @return array<(string|int), VarTag> */ public function getVarTags() : array { if ($this->varTags === \false) { $this->varTags = $this->phpDocNodeResolver->resolveVarTags($this->phpDocNode, $this->getNameScope()); } return $this->varTags; } /** * @return array<string, MethodTag> */ public function getMethodTags() : array { if ($this->methodTags === \false) { $this->methodTags = $this->phpDocNodeResolver->resolveMethodTags($this->phpDocNode, $this->getNameScope()); } return $this->methodTags; } /** * @return array<string, PropertyTag> */ public function getPropertyTags() : array { if ($this->propertyTags === \false) { $this->propertyTags = $this->phpDocNodeResolver->resolvePropertyTags($this->phpDocNode, $this->getNameScope()); } return $this->propertyTags; } /** * @return array<string, TemplateTag> */ public function getTemplateTags() : array { return $this->templateTags; } /** * @return array<string, ExtendsTag> */ public function getExtendsTags() : array { if ($this->extendsTags === \false) { $this->extendsTags = $this->phpDocNodeResolver->resolveExtendsTags($this->phpDocNode, $this->getNameScope()); } return $this->extendsTags; } /** * @return array<string, ImplementsTag> */ public function getImplementsTags() : array { if ($this->implementsTags === \false) { $this->implementsTags = $this->phpDocNodeResolver->resolveImplementsTags($this->phpDocNode, $this->getNameScope()); } return $this->implementsTags; } /** * @return array<string, UsesTag> */ public function getUsesTags() : array { if ($this->usesTags === \false) { $this->usesTags = $this->phpDocNodeResolver->resolveUsesTags($this->phpDocNode, $this->getNameScope()); } return $this->usesTags; } /** * @return array<string, ParamTag> */ public function getParamTags() : array { if ($this->paramTags === \false) { $this->paramTags = $this->phpDocNodeResolver->resolveParamTags($this->phpDocNode, $this->getNameScope()); } return $this->paramTags; } /** * @return array<string, ParamOutTag> */ public function getParamOutTags() : array { if ($this->paramOutTags === \false) { $this->paramOutTags = $this->phpDocNodeResolver->resolveParamOutTags($this->phpDocNode, $this->getNameScope()); } return $this->paramOutTags; } /** * @return array<string, bool> */ public function getParamsImmediatelyInvokedCallable() : array { if ($this->paramsImmediatelyInvokedCallable === \false) { $this->paramsImmediatelyInvokedCallable = $this->phpDocNodeResolver->resolveParamImmediatelyInvokedCallable($this->phpDocNode); } return $this->paramsImmediatelyInvokedCallable; } /** * @return array<string, ParamClosureThisTag> */ public function getParamClosureThisTags() : array { if ($this->paramClosureThisTags === \false) { $this->paramClosureThisTags = $this->phpDocNodeResolver->resolveParamClosureThisTags($this->phpDocNode, $this->getNameScope()); } return $this->paramClosureThisTags; } public function getReturnTag() : ?ReturnTag { if (is_bool($this->returnTag)) { $this->returnTag = $this->phpDocNodeResolver->resolveReturnTag($this->phpDocNode, $this->getNameScope()); } return $this->returnTag; } public function getThrowsTag() : ?ThrowsTag { if (is_bool($this->throwsTag)) { $this->throwsTag = $this->phpDocNodeResolver->resolveThrowsTags($this->phpDocNode, $this->getNameScope()); } return $this->throwsTag; } /** * @return array<MixinTag> */ public function getMixinTags() : array { if ($this->mixinTags === \false) { $this->mixinTags = $this->phpDocNodeResolver->resolveMixinTags($this->phpDocNode, $this->getNameScope()); } return $this->mixinTags; } /** * @return array<RequireExtendsTag> */ public function getRequireExtendsTags() : array { if ($this->requireExtendsTags === \false) { $this->requireExtendsTags = $this->phpDocNodeResolver->resolveRequireExtendsTags($this->phpDocNode, $this->getNameScope()); } return $this->requireExtendsTags; } /** * @return array<RequireImplementsTag> */ public function getRequireImplementsTags() : array { if ($this->requireImplementsTags === \false) { $this->requireImplementsTags = $this->phpDocNodeResolver->resolveRequireImplementsTags($this->phpDocNode, $this->getNameScope()); } return $this->requireImplementsTags; } /** * @return array<TypeAliasTag> */ public function getTypeAliasTags() : array { if ($this->typeAliasTags === \false) { $this->typeAliasTags = $this->phpDocNodeResolver->resolveTypeAliasTags($this->phpDocNode, $this->getNameScope()); } return $this->typeAliasTags; } /** * @return array<TypeAliasImportTag> */ public function getTypeAliasImportTags() : array { if ($this->typeAliasImportTags === \false) { $this->typeAliasImportTags = $this->phpDocNodeResolver->resolveTypeAliasImportTags($this->phpDocNode, $this->getNameScope()); } return $this->typeAliasImportTags; } /** * @return array<AssertTag> */ public function getAssertTags() : array { if ($this->assertTags === \false) { $this->assertTags = $this->phpDocNodeResolver->resolveAssertTags($this->phpDocNode, $this->getNameScope()); } return $this->assertTags; } public function getSelfOutTag() : ?SelfOutTypeTag { if ($this->selfOutTypeTag === \false) { $this->selfOutTypeTag = $this->phpDocNodeResolver->resolveSelfOutTypeTag($this->phpDocNode, $this->getNameScope()); } return $this->selfOutTypeTag; } public function getDeprecatedTag() : ?DeprecatedTag { if (is_bool($this->deprecatedTag)) { $this->deprecatedTag = $this->phpDocNodeResolver->resolveDeprecatedTag($this->phpDocNode, $this->getNameScope()); } return $this->deprecatedTag; } public function isDeprecated() : bool { if ($this->isDeprecated === null) { $this->isDeprecated = $this->phpDocNodeResolver->resolveIsDeprecated($this->phpDocNode); } return $this->isDeprecated; } /** * @internal */ public function isNotDeprecated() : bool { if ($this->isNotDeprecated === null) { $this->isNotDeprecated = $this->phpDocNodeResolver->resolveIsNotDeprecated($this->phpDocNode); } return $this->isNotDeprecated; } public function isInternal() : bool { if ($this->isInternal === null) { $this->isInternal = $this->phpDocNodeResolver->resolveIsInternal($this->phpDocNode); } return $this->isInternal; } public function isFinal() : bool { if ($this->isFinal === null) { $this->isFinal = $this->phpDocNodeResolver->resolveIsFinal($this->phpDocNode); } return $this->isFinal; } public function hasConsistentConstructor() : bool { if ($this->hasConsistentConstructor === null) { $this->hasConsistentConstructor = $this->phpDocNodeResolver->resolveHasConsistentConstructor($this->phpDocNode); } return $this->hasConsistentConstructor; } public function acceptsNamedArguments() : bool { if ($this->acceptsNamedArguments === null) { $this->acceptsNamedArguments = $this->phpDocNodeResolver->resolveAcceptsNamedArguments($this->phpDocNode); } return $this->acceptsNamedArguments; } public function getTemplateTypeMap() : TemplateTypeMap { return $this->templateTypeMap; } public function isPure() : ?bool { if ($this->isPure === 'notLoaded') { $pure = $this->phpDocNodeResolver->resolveIsPure($this->phpDocNode); if ($pure) { $this->isPure = \true; return $this->isPure; } $impure = $this->phpDocNodeResolver->resolveIsImpure($this->phpDocNode); if ($impure) { $this->isPure = \false; return $this->isPure; } $this->isPure = null; } return $this->isPure; } public function isReadOnly() : bool { if ($this->isReadOnly === null) { $this->isReadOnly = $this->phpDocNodeResolver->resolveIsReadOnly($this->phpDocNode); } return $this->isReadOnly; } public function isImmutable() : bool { if ($this->isImmutable === null) { $this->isImmutable = $this->phpDocNodeResolver->resolveIsImmutable($this->phpDocNode); } return $this->isImmutable; } public function isAllowedPrivateMutation() : bool { if ($this->isAllowedPrivateMutation === null) { $this->isAllowedPrivateMutation = $this->phpDocNodeResolver->resolveAllowPrivateMutation($this->phpDocNode); } return $this->isAllowedPrivateMutation; } /** * @param array<string|int, VarTag> $varTags * @param array<int, self> $parents * @param array<int, PhpDocBlock> $parentPhpDocBlocks * @return array<string|int, VarTag> */ private static function mergeVarTags(array $varTags, array $parents, array $parentPhpDocBlocks) : array { // Only allow one var tag per comment. Check the parent if child does not have this tag. if (count($varTags) > 0) { return $varTags; } foreach ($parents as $i => $parent) { $result = self::mergeOneParentVarTags($parent, $parentPhpDocBlocks[$i]); if ($result === null) { continue; } return $result; } return []; } /** * @return array<string|int, VarTag>|null */ private static function mergeOneParentVarTags(self $parent, \PHPStan\PhpDoc\PhpDocBlock $phpDocBlock) : ?array { foreach ($parent->getVarTags() as $key => $parentVarTag) { return [$key => self::resolveTemplateTypeInTag($parentVarTag, $phpDocBlock, TemplateTypeVariance::createInvariant())]; } return null; } /** * @param array<string, ParamTag> $paramTags * @param array<int, self> $parents * @param array<int, PhpDocBlock> $parentPhpDocBlocks * @return array<string, ParamTag> */ private static function mergeParamTags(array $paramTags, array $parents, array $parentPhpDocBlocks) : array { foreach ($parents as $i => $parent) { $paramTags = self::mergeOneParentParamTags($paramTags, $parent, $parentPhpDocBlocks[$i]); } return $paramTags; } /** * @param array<string, ParamTag> $paramTags * @return array<string, ParamTag> */ private static function mergeOneParentParamTags(array $paramTags, self $parent, \PHPStan\PhpDoc\PhpDocBlock $phpDocBlock) : array { $parentParamTags = $phpDocBlock->transformArrayKeysWithParameterNameMapping($parent->getParamTags()); foreach ($parentParamTags as $name => $parentParamTag) { if (array_key_exists($name, $paramTags)) { continue; } $paramTags[$name] = self::resolveTemplateTypeInTag($parentParamTag->withType($phpDocBlock->transformConditionalReturnTypeWithParameterNameMapping($parentParamTag->getType())), $phpDocBlock, TemplateTypeVariance::createContravariant()); } return $paramTags; } /** * @param array<int, self> $parents * @param array<int, PhpDocBlock> $parentPhpDocBlocks * @return ReturnTag|Null */ private static function mergeReturnTags(?ReturnTag $returnTag, ?ClassReflection $classReflection, array $parents, array $parentPhpDocBlocks) : ?ReturnTag { if ($returnTag !== null) { return $returnTag; } foreach ($parents as $i => $parent) { $result = self::mergeOneParentReturnTag($returnTag, $classReflection, $parent, $parentPhpDocBlocks[$i]); if ($result === null) { continue; } return $result; } return null; } private static function mergeOneParentReturnTag(?ReturnTag $returnTag, ?ClassReflection $classReflection, self $parent, \PHPStan\PhpDoc\PhpDocBlock $phpDocBlock) : ?ReturnTag { $parentReturnTag = $parent->getReturnTag(); if ($parentReturnTag === null) { return $returnTag; } $parentType = $parentReturnTag->getType(); if ($classReflection !== null) { $parentType = TypeTraverser::map($parentType, static function (Type $type, callable $traverse) use($classReflection) : Type { if ($type instanceof StaticType) { return $type->changeBaseClass($classReflection); } return $traverse($type); }); $parentReturnTag = $parentReturnTag->withType($parentType); } // Each parent would overwrite the previous one except if it returns a less specific type. // Do not care for incompatible types as there is a separate rule for that. if ($returnTag !== null && $parentType->isSuperTypeOf($returnTag->getType())->yes()) { return null; } return self::resolveTemplateTypeInTag($parentReturnTag->withType($phpDocBlock->transformConditionalReturnTypeWithParameterNameMapping($parentReturnTag->getType()))->toImplicit(), $phpDocBlock, TemplateTypeVariance::createCovariant()); } /** * @param array<AssertTag> $assertTags * @param array<int, self> $parents * @param array<int, PhpDocBlock> $parentPhpDocBlocks * @return array<AssertTag> */ private static function mergeAssertTags(array $assertTags, array $parents, array $parentPhpDocBlocks) : array { if (count($assertTags) > 0) { return $assertTags; } foreach ($parents as $i => $parent) { $result = $parent->getAssertTags(); if (count($result) === 0) { continue; } $phpDocBlock = $parentPhpDocBlocks[$i]; return array_map(static function (AssertTag $assertTag) use($phpDocBlock) { return self::resolveTemplateTypeInTag($assertTag->withParameter($phpDocBlock->transformAssertTagParameterWithParameterNameMapping($assertTag->getParameter()))->toImplicit(), $phpDocBlock, TemplateTypeVariance::createCovariant()); }, $result); } return $assertTags; } /** * @param array<int, self> $parents */ private static function mergeSelfOutTypeTags(?SelfOutTypeTag $selfOutTypeTag, array $parents) : ?SelfOutTypeTag { if ($selfOutTypeTag !== null) { return $selfOutTypeTag; } foreach ($parents as $parent) { $result = $parent->getSelfOutTag(); if ($result === null) { continue; } return $result; } return null; } /** * @param array<int, self> $parents */ private static function mergeDeprecatedTags(?DeprecatedTag $deprecatedTag, bool $hasNotDeprecatedTag, array $parents) : ?DeprecatedTag { if ($deprecatedTag !== null) { return $deprecatedTag; } if ($hasNotDeprecatedTag) { return null; } foreach ($parents as $parent) { $result = $parent->getDeprecatedTag(); if ($result === null && !$parent->isNotDeprecated()) { continue; } return $result; } return null; } /** * @param array<int, self> $parents */ private static function mergeThrowsTags(?ThrowsTag $throwsTag, array $parents) : ?ThrowsTag { if ($throwsTag !== null) { return $throwsTag; } foreach ($parents as $parent) { $result = $parent->getThrowsTag(); if ($result === null) { continue; } return $result; } return null; } /** * @param array<string, ParamOutTag> $paramOutTags * @param array<int, self> $parents * @param array<int, PhpDocBlock> $parentPhpDocBlocks * @return array<string, ParamOutTag> */ private static function mergeParamOutTags(array $paramOutTags, array $parents, array $parentPhpDocBlocks) : array { foreach ($parents as $i => $parent) { $paramOutTags = self::mergeOneParentParamOutTags($paramOutTags, $parent, $parentPhpDocBlocks[$i]); } return $paramOutTags; } /** * @param array<string, ParamOutTag> $paramOutTags * @return array<string, ParamOutTag> */ private static function mergeOneParentParamOutTags(array $paramOutTags, self $parent, \PHPStan\PhpDoc\PhpDocBlock $phpDocBlock) : array { $parentParamOutTags = $phpDocBlock->transformArrayKeysWithParameterNameMapping($parent->getParamOutTags()); foreach ($parentParamOutTags as $name => $parentParamTag) { if (array_key_exists($name, $paramOutTags)) { continue; } $paramOutTags[$name] = self::resolveTemplateTypeInTag($parentParamTag->withType($phpDocBlock->transformConditionalReturnTypeWithParameterNameMapping($parentParamTag->getType())), $phpDocBlock, TemplateTypeVariance::createCovariant()); } return $paramOutTags; } /** * @param array<string, bool> $paramsImmediatelyInvokedCallable * @param array<int, self> $parents * @param array<int, PhpDocBlock> $parentPhpDocBlocks * @return array<string, bool> */ private static function mergeParamsImmediatelyInvokedCallable(array $paramsImmediatelyInvokedCallable, array $parents, array $parentPhpDocBlocks) : array { foreach ($parents as $i => $parent) { $paramsImmediatelyInvokedCallable = self::mergeOneParentParamImmediatelyInvokedCallable($paramsImmediatelyInvokedCallable, $parent, $parentPhpDocBlocks[$i]); } return $paramsImmediatelyInvokedCallable; } /** * @param array<string, bool> $paramsImmediatelyInvokedCallable * @return array<string, bool> */ private static function mergeOneParentParamImmediatelyInvokedCallable(array $paramsImmediatelyInvokedCallable, self $parent, \PHPStan\PhpDoc\PhpDocBlock $phpDocBlock) : array { $parentImmediatelyInvokedCallable = $phpDocBlock->transformArrayKeysWithParameterNameMapping($parent->getParamsImmediatelyInvokedCallable()); foreach ($parentImmediatelyInvokedCallable as $name => $parentIsImmediatelyInvokedCallable) { if (array_key_exists($name, $paramsImmediatelyInvokedCallable)) { continue; } $paramsImmediatelyInvokedCallable[$name] = $parentIsImmediatelyInvokedCallable; } return $paramsImmediatelyInvokedCallable; } /** * @param array<string, ParamClosureThisTag> $paramsClosureThisTags * @param array<int, self> $parents * @param array<int, PhpDocBlock> $parentPhpDocBlocks * @return array<string, ParamClosureThisTag> */ private static function mergeParamClosureThisTags(array $paramsClosureThisTags, array $parents, array $parentPhpDocBlocks) : array { foreach ($parents as $i => $parent) { $paramsClosureThisTags = self::mergeOneParentParamClosureThisTag($paramsClosureThisTags, $parent, $parentPhpDocBlocks[$i]); } return $paramsClosureThisTags; } /** * @param array<string, ParamClosureThisTag> $paramsClosureThisTags * @return array<string, ParamClosureThisTag> */ private static function mergeOneParentParamClosureThisTag(array $paramsClosureThisTags, self $parent, \PHPStan\PhpDoc\PhpDocBlock $phpDocBlock) : array { $parentClosureThisTags = $phpDocBlock->transformArrayKeysWithParameterNameMapping($parent->getParamClosureThisTags()); foreach ($parentClosureThisTags as $name => $parentParamClosureThisTag) { if (array_key_exists($name, $paramsClosureThisTags)) { continue; } $paramsClosureThisTags[$name] = self::resolveTemplateTypeInTag($parentParamClosureThisTag->withType($phpDocBlock->transformConditionalReturnTypeWithParameterNameMapping($parentParamClosureThisTag->getType())), $phpDocBlock, TemplateTypeVariance::createContravariant()); } return $paramsClosureThisTags; } /** * @param array<int, self> $parents */ private static function mergePureTags(?bool $isPure, array $parents) : ?bool { if ($isPure !== null) { return $isPure; } foreach ($parents as $parent) { $parentIsPure = $parent->isPure(); if ($parentIsPure === null) { continue; } return $parentIsPure; } return null; } /** * @template T of TypedTag * @param T $tag * @return T */ private static function resolveTemplateTypeInTag(TypedTag $tag, \PHPStan\PhpDoc\PhpDocBlock $phpDocBlock, TemplateTypeVariance $positionVariance) : TypedTag { $type = TemplateTypeHelper::resolveTemplateTypes($tag->getType(), $phpDocBlock->getClassReflection()->getActiveTemplateTypeMap(), $phpDocBlock->getClassReflection()->getCallSiteVarianceMap(), $positionVariance); return $tag->withType($type); } } <?php declare (strict_types=1); namespace PHPStan\PhpDoc; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionParameter; use PHPStan\Reflection\ClassReflection; use PHPStan\Type\FileTypeMapper; use function array_map; use function strtolower; final class PhpDocInheritanceResolver { /** * @var FileTypeMapper */ private $fileTypeMapper; /** * @var StubPhpDocProvider */ private $stubPhpDocProvider; public function __construct(FileTypeMapper $fileTypeMapper, \PHPStan\PhpDoc\StubPhpDocProvider $stubPhpDocProvider) { $this->fileTypeMapper = $fileTypeMapper; $this->stubPhpDocProvider = $stubPhpDocProvider; } public function resolvePhpDocForProperty(?string $docComment, ClassReflection $classReflection, ?string $classReflectionFileName, ?string $declaringTraitName, string $propertyName) : \PHPStan\PhpDoc\ResolvedPhpDocBlock { $phpDocBlock = \PHPStan\PhpDoc\PhpDocBlock::resolvePhpDocBlockForProperty($docComment, $classReflection, null, $propertyName, $classReflectionFileName, null); return $this->docBlockTreeToResolvedDocBlock($phpDocBlock, $declaringTraitName, null, $propertyName, null); } public function resolvePhpDocForConstant(?string $docComment, ClassReflection $classReflection, ?string $classReflectionFileName, string $constantName) : \PHPStan\PhpDoc\ResolvedPhpDocBlock { $phpDocBlock = \PHPStan\PhpDoc\PhpDocBlock::resolvePhpDocBlockForConstant($docComment, $classReflection, $constantName, $classReflectionFileName, null); return $this->docBlockTreeToResolvedDocBlock($phpDocBlock, null, null, null, $constantName); } /** * @param array<int, string> $positionalParameterNames */ public function resolvePhpDocForMethod(?string $docComment, ?string $fileName, ClassReflection $classReflection, ?string $declaringTraitName, string $methodName, array $positionalParameterNames) : \PHPStan\PhpDoc\ResolvedPhpDocBlock { $phpDocBlock = \PHPStan\PhpDoc\PhpDocBlock::resolvePhpDocBlockForMethod($docComment, $classReflection, $declaringTraitName, $methodName, $fileName, null, $positionalParameterNames, $positionalParameterNames); return $this->docBlockTreeToResolvedDocBlock($phpDocBlock, $phpDocBlock->getTrait(), $methodName, null, null); } private function docBlockTreeToResolvedDocBlock(\PHPStan\PhpDoc\PhpDocBlock $phpDocBlock, ?string $traitName, ?string $functionName, ?string $propertyName, ?string $constantName) : \PHPStan\PhpDoc\ResolvedPhpDocBlock { $parents = []; $parentPhpDocBlocks = []; foreach ($phpDocBlock->getParents() as $parentPhpDocBlock) { if ($functionName !== null && strtolower($functionName) === '__construct' && $parentPhpDocBlock->getClassReflection()->isBuiltin()) { continue; } $parents[] = $this->docBlockTreeToResolvedDocBlock($parentPhpDocBlock, $parentPhpDocBlock->getTrait(), $functionName, $propertyName, $constantName); $parentPhpDocBlocks[] = $parentPhpDocBlock; } $oneResolvedDockBlock = $this->docBlockToResolvedDocBlock($phpDocBlock, $traitName, $functionName, $propertyName, $constantName); return $oneResolvedDockBlock->merge($parents, $parentPhpDocBlocks); } private function docBlockToResolvedDocBlock(\PHPStan\PhpDoc\PhpDocBlock $phpDocBlock, ?string $traitName, ?string $functionName, ?string $propertyName, ?string $constantName) : \PHPStan\PhpDoc\ResolvedPhpDocBlock { $classReflection = $phpDocBlock->getClassReflection(); if ($functionName !== null && $classReflection->getNativeReflection()->hasMethod($functionName)) { $methodReflection = $classReflection->getNativeReflection()->getMethod($functionName); $stub = $this->stubPhpDocProvider->findMethodPhpDoc($classReflection->getName(), $classReflection->getName(), $functionName, array_map(static function (ReflectionParameter $parameter) : string { return $parameter->getName(); }, $methodReflection->getParameters())); if ($stub !== null) { return $stub; } } if ($propertyName !== null && $classReflection->getNativeReflection()->hasProperty($propertyName)) { $stub = $this->stubPhpDocProvider->findPropertyPhpDoc($classReflection->getName(), $propertyName); if ($stub === null) { $propertyReflection = $classReflection->getNativeReflection()->getProperty($propertyName); $propertyDeclaringClass = $propertyReflection->getBetterReflection()->getDeclaringClass(); if ($propertyDeclaringClass->isTrait() && (!$propertyReflection->getDeclaringClass()->isTrait() || $propertyReflection->getDeclaringClass()->getName() !== $propertyDeclaringClass->getName())) { $stub = $this->stubPhpDocProvider->findPropertyPhpDoc($propertyDeclaringClass->getName(), $propertyName); } } if ($stub !== null) { return $stub; } } if ($constantName !== null && $classReflection->getNativeReflection()->hasConstant($constantName)) { $stub = $this->stubPhpDocProvider->findClassConstantPhpDoc($classReflection->getName(), $constantName); if ($stub !== null) { return $stub; } } return $this->fileTypeMapper->getResolvedPhpDoc($phpDocBlock->getFile(), $classReflection->getName(), $traitName, $functionName, $phpDocBlock->getDocComment()); } } <?php declare (strict_types=1); namespace PHPStan\PhpDoc; use PhpParser\Parser; use PHPStan\BetterReflection\SourceLocator\Ast\Locator; use PHPStan\BetterReflection\SourceLocator\SourceStubber\PhpStormStubsSourceStubber; use PHPStan\BetterReflection\SourceLocator\Type\AggregateSourceLocator; use PHPStan\BetterReflection\SourceLocator\Type\Composer\Psr\Psr4Mapping; use PHPStan\BetterReflection\SourceLocator\Type\MemoizingSourceLocator; use PHPStan\BetterReflection\SourceLocator\Type\PhpInternalSourceLocator; use PHPStan\BetterReflection\SourceLocator\Type\SourceLocator; use PHPStan\Reflection\BetterReflection\SourceLocator\OptimizedPsrAutoloaderLocatorFactory; use PHPStan\Reflection\BetterReflection\SourceLocator\OptimizedSingleFileSourceLocatorRepository; use function dirname; final class StubSourceLocatorFactory { /** * @var Parser */ private $php8Parser; /** * @var PhpStormStubsSourceStubber */ private $phpStormStubsSourceStubber; /** * @var OptimizedSingleFileSourceLocatorRepository */ private $optimizedSingleFileSourceLocatorRepository; /** * @var OptimizedPsrAutoloaderLocatorFactory */ private $optimizedPsrAutoloaderLocatorFactory; /** * @var StubFilesProvider */ private $stubFilesProvider; public function __construct(Parser $php8Parser, PhpStormStubsSourceStubber $phpStormStubsSourceStubber, OptimizedSingleFileSourceLocatorRepository $optimizedSingleFileSourceLocatorRepository, OptimizedPsrAutoloaderLocatorFactory $optimizedPsrAutoloaderLocatorFactory, \PHPStan\PhpDoc\StubFilesProvider $stubFilesProvider) { $this->php8Parser = $php8Parser; $this->phpStormStubsSourceStubber = $phpStormStubsSourceStubber; $this->optimizedSingleFileSourceLocatorRepository = $optimizedSingleFileSourceLocatorRepository; $this->optimizedPsrAutoloaderLocatorFactory = $optimizedPsrAutoloaderLocatorFactory; $this->stubFilesProvider = $stubFilesProvider; } public function create() : SourceLocator { $locators = []; $astPhp8Locator = new Locator($this->php8Parser); foreach ($this->stubFilesProvider->getStubFiles() as $stubFile) { $locators[] = $this->optimizedSingleFileSourceLocatorRepository->getOrCreate($stubFile); } $locators[] = $this->optimizedPsrAutoloaderLocatorFactory->create(Psr4Mapping::fromArrayMappings(['PHPStan\\' => [dirname(__DIR__) . '/']])); $locators[] = $this->optimizedPsrAutoloaderLocatorFactory->create(Psr4Mapping::fromArrayMappings(['PhpParser\\' => [dirname(__DIR__, 2) . '/vendor/nikic/php-parser/lib/PhpParser/']])); $locators[] = new PhpInternalSourceLocator($astPhp8Locator, $this->phpStormStubsSourceStubber); return new MemoizingSourceLocator(new AggregateSourceLocator($locators)); } } <?php declare (strict_types=1); namespace PHPStan\PhpDoc; use PHPStan\PhpDocParser\Parser\ConstExprParser; final class ConstExprParserFactory { /** * @var bool */ private $unescapeStrings; public function __construct(bool $unescapeStrings) { $this->unescapeStrings = $unescapeStrings; } public function create() : ConstExprParser { return new ConstExprParser($this->unescapeStrings, $this->unescapeStrings); } } <?php declare (strict_types=1); namespace PHPStan\PhpDoc; use Closure; use Generator; use Iterator; use IteratorAggregate; use _PHPStan_7d8742a37\Nette\Utils\Strings; use PhpParser\Node\Name; use PHPStan\Analyser\ConstantResolver; use PHPStan\Analyser\NameScope; use PHPStan\PhpDoc\Tag\TemplateTag; use PHPStan\PhpDocParser\Ast\ConstExpr\ConstExprArrayNode; use PHPStan\PhpDocParser\Ast\ConstExpr\ConstExprFalseNode; use PHPStan\PhpDocParser\Ast\ConstExpr\ConstExprFloatNode; use PHPStan\PhpDocParser\Ast\ConstExpr\ConstExprIntegerNode; use PHPStan\PhpDocParser\Ast\ConstExpr\ConstExprNullNode; use PHPStan\PhpDocParser\Ast\ConstExpr\ConstExprStringNode; use PHPStan\PhpDocParser\Ast\ConstExpr\ConstExprTrueNode; use PHPStan\PhpDocParser\Ast\ConstExpr\ConstFetchNode; use PHPStan\PhpDocParser\Ast\Type\ArrayShapeNode; use PHPStan\PhpDocParser\Ast\Type\ArrayTypeNode; use PHPStan\PhpDocParser\Ast\Type\CallableTypeNode; use PHPStan\PhpDocParser\Ast\Type\CallableTypeParameterNode; use PHPStan\PhpDocParser\Ast\Type\ConditionalTypeForParameterNode; use PHPStan\PhpDocParser\Ast\Type\ConditionalTypeNode; use PHPStan\PhpDocParser\Ast\Type\ConstTypeNode; use PHPStan\PhpDocParser\Ast\Type\GenericTypeNode; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\IntersectionTypeNode; use PHPStan\PhpDocParser\Ast\Type\InvalidTypeNode; use PHPStan\PhpDocParser\Ast\Type\NullableTypeNode; use PHPStan\PhpDocParser\Ast\Type\ObjectShapeNode; use PHPStan\PhpDocParser\Ast\Type\OffsetAccessTypeNode; use PHPStan\PhpDocParser\Ast\Type\ThisTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\PhpDocParser\Ast\Type\UnionTypeNode; use PHPStan\Reflection\Callables\SimpleImpurePoint; use PHPStan\Reflection\InitializerExprContext; use PHPStan\Reflection\InitializerExprTypeResolver; use PHPStan\Reflection\Native\NativeParameterReflection; use PHPStan\Reflection\PassedByReference; use PHPStan\Reflection\ReflectionProvider; use PHPStan\ShouldNotHappenException; use PHPStan\TrinaryLogic; use PHPStan\Type\Accessory\AccessoryArrayListType; use PHPStan\Type\Accessory\AccessoryLiteralStringType; use PHPStan\Type\Accessory\AccessoryLowercaseStringType; use PHPStan\Type\Accessory\AccessoryNonEmptyStringType; use PHPStan\Type\Accessory\AccessoryNonFalsyStringType; use PHPStan\Type\Accessory\AccessoryNumericStringType; use PHPStan\Type\Accessory\AccessoryUppercaseStringType; use PHPStan\Type\Accessory\NonEmptyArrayType; use PHPStan\Type\ArrayType; use PHPStan\Type\BenevolentUnionType; use PHPStan\Type\BooleanType; use PHPStan\Type\CallableType; use PHPStan\Type\ClassStringType; use PHPStan\Type\ClosureType; use PHPStan\Type\ConditionalType; use PHPStan\Type\ConditionalTypeForParameter; use PHPStan\Type\Constant\ConstantArrayTypeBuilder; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantFloatType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\Enum\EnumCaseObjectType; use PHPStan\Type\ErrorType; use PHPStan\Type\FloatType; use PHPStan\Type\Generic\GenericClassStringType; use PHPStan\Type\Generic\GenericObjectType; use PHPStan\Type\Generic\GenericStaticType; use PHPStan\Type\Generic\TemplateType; use PHPStan\Type\Generic\TemplateTypeFactory; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\Generic\TemplateTypeScope; use PHPStan\Type\Generic\TemplateTypeVariance; use PHPStan\Type\Helper\GetTemplateTypeType; use PHPStan\Type\IntegerRangeType; use PHPStan\Type\IntegerType; use PHPStan\Type\IntersectionType; use PHPStan\Type\IterableType; use PHPStan\Type\KeyOfType; use PHPStan\Type\MixedType; use PHPStan\Type\NewObjectType; use PHPStan\Type\NonAcceptingNeverType; use PHPStan\Type\NonexistentParentClassType; use PHPStan\Type\NullType; use PHPStan\Type\ObjectShapeType; use PHPStan\Type\ObjectType; use PHPStan\Type\ObjectWithoutClassType; use PHPStan\Type\OffsetAccessType; use PHPStan\Type\ResourceType; use PHPStan\Type\StaticType; use PHPStan\Type\StaticTypeFactory; use PHPStan\Type\StringAlwaysAcceptingObjectWithToStringType; use PHPStan\Type\StringType; use PHPStan\Type\ThisType; use PHPStan\Type\Type; use PHPStan\Type\TypeAliasResolver; use PHPStan\Type\TypeAliasResolverProvider; use PHPStan\Type\TypeCombinator; use PHPStan\Type\TypeUtils; use PHPStan\Type\UnionType; use PHPStan\Type\ValueOfType; use PHPStan\Type\VoidType; use Traversable; use function array_key_exists; use function array_map; use function array_values; use function count; use function explode; use function get_class; use function in_array; use function max; use function min; use function preg_match; use function preg_quote; use function str_contains; use function str_replace; use function str_starts_with; use function strtolower; use function substr; final class TypeNodeResolver { /** * @var TypeNodeResolverExtensionRegistryProvider */ private $extensionRegistryProvider; /** * @var ReflectionProvider\ReflectionProviderProvider */ private $reflectionProviderProvider; /** * @var TypeAliasResolverProvider */ private $typeAliasResolverProvider; /** * @var ConstantResolver */ private $constantResolver; /** * @var InitializerExprTypeResolver */ private $initializerExprTypeResolver; /** @var array<string, true> */ private $genericTypeResolvingStack = []; public function __construct(\PHPStan\PhpDoc\TypeNodeResolverExtensionRegistryProvider $extensionRegistryProvider, ReflectionProvider\ReflectionProviderProvider $reflectionProviderProvider, TypeAliasResolverProvider $typeAliasResolverProvider, ConstantResolver $constantResolver, InitializerExprTypeResolver $initializerExprTypeResolver) { $this->extensionRegistryProvider = $extensionRegistryProvider; $this->reflectionProviderProvider = $reflectionProviderProvider; $this->typeAliasResolverProvider = $typeAliasResolverProvider; $this->constantResolver = $constantResolver; $this->initializerExprTypeResolver = $initializerExprTypeResolver; } /** @api */ public function resolve(TypeNode $typeNode, NameScope $nameScope) : Type { foreach ($this->extensionRegistryProvider->getRegistry()->getExtensions() as $extension) { $type = $extension->resolve($typeNode, $nameScope); if ($type !== null) { return $type; } } if ($typeNode instanceof IdentifierTypeNode) { return $this->resolveIdentifierTypeNode($typeNode, $nameScope); } elseif ($typeNode instanceof ThisTypeNode) { return $this->resolveThisTypeNode($typeNode, $nameScope); } elseif ($typeNode instanceof NullableTypeNode) { return $this->resolveNullableTypeNode($typeNode, $nameScope); } elseif ($typeNode instanceof UnionTypeNode) { return $this->resolveUnionTypeNode($typeNode, $nameScope); } elseif ($typeNode instanceof IntersectionTypeNode) { return $this->resolveIntersectionTypeNode($typeNode, $nameScope); } elseif ($typeNode instanceof ConditionalTypeNode) { return $this->resolveConditionalTypeNode($typeNode, $nameScope); } elseif ($typeNode instanceof ConditionalTypeForParameterNode) { return $this->resolveConditionalTypeForParameterNode($typeNode, $nameScope); } elseif ($typeNode instanceof ArrayTypeNode) { return $this->resolveArrayTypeNode($typeNode, $nameScope); } elseif ($typeNode instanceof GenericTypeNode) { return $this->resolveGenericTypeNode($typeNode, $nameScope); } elseif ($typeNode instanceof CallableTypeNode) { return $this->resolveCallableTypeNode($typeNode, $nameScope); } elseif ($typeNode instanceof ArrayShapeNode) { return $this->resolveArrayShapeNode($typeNode, $nameScope); } elseif ($typeNode instanceof ObjectShapeNode) { return $this->resolveObjectShapeNode($typeNode, $nameScope); } elseif ($typeNode instanceof ConstTypeNode) { return $this->resolveConstTypeNode($typeNode, $nameScope); } elseif ($typeNode instanceof OffsetAccessTypeNode) { return $this->resolveOffsetAccessNode($typeNode, $nameScope); } elseif ($typeNode instanceof InvalidTypeNode) { return new MixedType(\true); } return new ErrorType(); } private function resolveIdentifierTypeNode(IdentifierTypeNode $typeNode, NameScope $nameScope) : Type { switch (strtolower($typeNode->name)) { case 'int': case 'integer': return new IntegerType(); case 'positive-int': return IntegerRangeType::fromInterval(1, null); case 'negative-int': return IntegerRangeType::fromInterval(null, -1); case 'non-positive-int': return IntegerRangeType::fromInterval(null, 0); case 'non-negative-int': return IntegerRangeType::fromInterval(0, null); case 'non-zero-int': return new UnionType([IntegerRangeType::fromInterval(null, -1), IntegerRangeType::fromInterval(1, null)]); case 'string': return new StringType(); case 'lowercase-string': return new IntersectionType([new StringType(), new AccessoryLowercaseStringType()]); case 'uppercase-string': return new IntersectionType([new StringType(), new AccessoryUppercaseStringType()]); case 'literal-string': return new IntersectionType([new StringType(), new AccessoryLiteralStringType()]); case 'class-string': case 'interface-string': case 'trait-string': case 'enum-string': return new ClassStringType(); case 'callable-string': return new IntersectionType([new StringType(), new CallableType()]); case 'array-key': return new BenevolentUnionType([new IntegerType(), new StringType()]); case 'scalar': $type = $this->tryResolvePseudoTypeClassType($typeNode, $nameScope); if ($type !== null) { return $type; } return new UnionType([new IntegerType(), new FloatType(), new StringType(), new BooleanType()]); case 'empty-scalar': return TypeCombinator::intersect(new UnionType([new IntegerType(), new FloatType(), new StringType(), new BooleanType()]), StaticTypeFactory::falsey()); case 'non-empty-scalar': return TypeCombinator::remove(new UnionType([new IntegerType(), new FloatType(), new StringType(), new BooleanType()]), StaticTypeFactory::falsey()); case 'number': $type = $this->tryResolvePseudoTypeClassType($typeNode, $nameScope); if ($type !== null) { return $type; } return new UnionType([new IntegerType(), new FloatType()]); case 'numeric': $type = $this->tryResolvePseudoTypeClassType($typeNode, $nameScope); if ($type !== null) { return $type; } return new UnionType([new IntegerType(), new FloatType(), new IntersectionType([new StringType(), new AccessoryNumericStringType()])]); case 'numeric-string': return new IntersectionType([new StringType(), new AccessoryNumericStringType()]); case 'non-empty-string': return new IntersectionType([new StringType(), new AccessoryNonEmptyStringType()]); case 'non-empty-lowercase-string': return new IntersectionType([new StringType(), new AccessoryNonEmptyStringType(), new AccessoryLowercaseStringType()]); case 'non-empty-uppercase-string': return new IntersectionType([new StringType(), new AccessoryNonEmptyStringType(), new AccessoryUppercaseStringType()]); case 'truthy-string': case 'non-falsy-string': return new IntersectionType([new StringType(), new AccessoryNonFalsyStringType()]); case 'non-empty-literal-string': return new IntersectionType([new StringType(), new AccessoryNonEmptyStringType(), new AccessoryLiteralStringType()]); case 'bool': return new BooleanType(); case 'boolean': $type = $this->tryResolvePseudoTypeClassType($typeNode, $nameScope); if ($type !== null) { return $type; } return new BooleanType(); case 'true': return new ConstantBooleanType(\true); case 'false': return new ConstantBooleanType(\false); case 'null': return new NullType(); case 'float': return new FloatType(); case 'double': $type = $this->tryResolvePseudoTypeClassType($typeNode, $nameScope); if ($type !== null) { return $type; } return new FloatType(); case 'array': case 'associative-array': return new ArrayType(new MixedType(), new MixedType()); case 'non-empty-array': return TypeCombinator::intersect(new ArrayType(new MixedType(), new MixedType()), new NonEmptyArrayType()); case 'iterable': return new IterableType(new MixedType(), new MixedType()); case 'callable': return new CallableType(); case 'pure-callable': return new CallableType(null, null, \true, null, null, [], TrinaryLogic::createYes()); case 'pure-closure': return ClosureType::createPure(); case 'resource': $type = $this->tryResolvePseudoTypeClassType($typeNode, $nameScope); if ($type !== null) { return $type; } return new ResourceType(); case 'open-resource': case 'closed-resource': return new ResourceType(); case 'mixed': return new MixedType(\true); case 'non-empty-mixed': return new MixedType(\true, StaticTypeFactory::falsey()); case 'void': return new VoidType(); case 'object': return new ObjectWithoutClassType(); case 'callable-object': return new IntersectionType([new ObjectWithoutClassType(), new CallableType()]); case 'callable-array': return new IntersectionType([new ArrayType(new MixedType(), new MixedType()), new CallableType()]); case 'never': case 'noreturn': $type = $this->tryResolvePseudoTypeClassType($typeNode, $nameScope); if ($type !== null) { return $type; } return new NonAcceptingNeverType(); case 'never-return': case 'never-returns': case 'no-return': return new NonAcceptingNeverType(); case 'list': return AccessoryArrayListType::intersectWith(new ArrayType(new IntegerType(), new MixedType())); case 'non-empty-list': return AccessoryArrayListType::intersectWith(TypeCombinator::intersect(new ArrayType(new IntegerType(), new MixedType()), new NonEmptyArrayType())); case '__always-list': return TypeCombinator::intersect(new ArrayType(new IntegerType(), new MixedType()), new AccessoryArrayListType()); case 'empty': $type = $this->tryResolvePseudoTypeClassType($typeNode, $nameScope); if ($type !== null) { return $type; } return StaticTypeFactory::falsey(); case '__stringandstringable': return new StringAlwaysAcceptingObjectWithToStringType(); } if ($nameScope->getClassName() !== null) { switch (strtolower($typeNode->name)) { case 'self': return new ObjectType($nameScope->getClassName()); case 'static': if ($this->getReflectionProvider()->hasClass($nameScope->getClassName())) { $classReflection = $this->getReflectionProvider()->getClass($nameScope->getClassName()); return new StaticType($classReflection); } return new ErrorType(); case 'parent': if ($this->getReflectionProvider()->hasClass($nameScope->getClassName())) { $classReflection = $this->getReflectionProvider()->getClass($nameScope->getClassName()); if ($classReflection->getParentClass() !== null) { return new ObjectType($classReflection->getParentClass()->getName()); } } return new NonexistentParentClassType(); } } if (!$nameScope->shouldBypassTypeAliases()) { $typeAlias = $this->getTypeAliasResolver()->resolveTypeAlias($typeNode->name, $nameScope); if ($typeAlias !== null) { return $typeAlias; } } $templateType = $nameScope->resolveTemplateTypeName($typeNode->name); if ($templateType !== null) { return $templateType; } $stringName = $nameScope->resolveStringName($typeNode->name); if (str_contains($stringName, '-') && !str_starts_with($stringName, 'OCI-')) { return new ErrorType(); } if ($this->mightBeConstant($typeNode->name) && !$this->getReflectionProvider()->hasClass($stringName)) { $constType = $this->tryResolveConstant($typeNode->name, $nameScope); if ($constType !== null) { return $constType; } } return new ObjectType($stringName); } private function mightBeConstant(string $name) : bool { return preg_match('((?:^|\\\\)[A-Z_][A-Z0-9_]*$)', $name) > 0; } private function tryResolveConstant(string $name, NameScope $nameScope) : ?Type { foreach ($nameScope->resolveConstantNames($name) as $constName) { $nameNode = new Name\FullyQualified(explode('\\', $constName)); $constType = $this->constantResolver->resolveConstant($nameNode, null); if ($constType !== null) { return $constType; } } return null; } private function tryResolvePseudoTypeClassType(IdentifierTypeNode $typeNode, NameScope $nameScope) : ?Type { if ($nameScope->hasUseAlias($typeNode->name)) { return new ObjectType($nameScope->resolveStringName($typeNode->name)); } if ($nameScope->getNamespace() === null) { return null; } $className = $nameScope->resolveStringName($typeNode->name); if ($this->getReflectionProvider()->hasClass($className)) { return new ObjectType($className); } return null; } private function resolveThisTypeNode(ThisTypeNode $typeNode, NameScope $nameScope) : Type { $className = $nameScope->getClassName(); if ($className !== null) { if ($this->getReflectionProvider()->hasClass($className)) { return new ThisType($this->getReflectionProvider()->getClass($className)); } } return new ErrorType(); } private function resolveNullableTypeNode(NullableTypeNode $typeNode, NameScope $nameScope) : Type { return TypeCombinator::union($this->resolve($typeNode->type, $nameScope), new NullType()); } private function resolveUnionTypeNode(UnionTypeNode $typeNode, NameScope $nameScope) : Type { $iterableTypeNodes = []; $otherTypeNodes = []; foreach ($typeNode->types as $innerTypeNode) { if ($innerTypeNode instanceof ArrayTypeNode) { $iterableTypeNodes[] = $innerTypeNode->type; } else { $otherTypeNodes[] = $innerTypeNode; } } $otherTypeTypes = $this->resolveMultiple($otherTypeNodes, $nameScope); if (count($iterableTypeNodes) > 0) { $arrayTypeTypes = $this->resolveMultiple($iterableTypeNodes, $nameScope); $arrayTypeType = TypeCombinator::union(...$arrayTypeTypes); $addArray = \true; foreach ($otherTypeTypes as &$type) { if (!$type->isIterable()->yes() || !$type->getIterableValueType()->isSuperTypeOf($arrayTypeType)->yes()) { continue; } if ($type instanceof ObjectType) { $type = new IntersectionType([$type, new IterableType(new MixedType(), $arrayTypeType)]); } elseif ($type instanceof ArrayType) { $type = new ArrayType(new MixedType(), $arrayTypeType); } elseif ($type instanceof IterableType) { $type = new IterableType(new MixedType(), $arrayTypeType); } else { continue; } $addArray = \false; } if ($addArray) { $otherTypeTypes[] = new ArrayType(new MixedType(), $arrayTypeType); } } return TypeCombinator::union(...$otherTypeTypes); } private function resolveIntersectionTypeNode(IntersectionTypeNode $typeNode, NameScope $nameScope) : Type { $types = $this->resolveMultiple($typeNode->types, $nameScope); return TypeCombinator::intersect(...$types); } private function resolveConditionalTypeNode(ConditionalTypeNode $typeNode, NameScope $nameScope) : Type { return new ConditionalType($this->resolve($typeNode->subjectType, $nameScope), $this->resolve($typeNode->targetType, $nameScope), $this->resolve($typeNode->if, $nameScope), $this->resolve($typeNode->else, $nameScope), $typeNode->negated); } private function resolveConditionalTypeForParameterNode(ConditionalTypeForParameterNode $typeNode, NameScope $nameScope) : Type { return new ConditionalTypeForParameter($typeNode->parameterName, $this->resolve($typeNode->targetType, $nameScope), $this->resolve($typeNode->if, $nameScope), $this->resolve($typeNode->else, $nameScope), $typeNode->negated); } private function resolveArrayTypeNode(ArrayTypeNode $typeNode, NameScope $nameScope) : Type { $itemType = $this->resolve($typeNode->type, $nameScope); return new ArrayType(new BenevolentUnionType([new IntegerType(), new StringType()]), $itemType); } private function resolveGenericTypeNode(GenericTypeNode $typeNode, NameScope $nameScope) : Type { $mainTypeName = strtolower($typeNode->type->name); $genericTypes = $this->resolveMultiple($typeNode->genericTypes, $nameScope); $variances = array_map(static function (string $variance) : TemplateTypeVariance { switch ($variance) { case GenericTypeNode::VARIANCE_INVARIANT: return TemplateTypeVariance::createInvariant(); case GenericTypeNode::VARIANCE_COVARIANT: return TemplateTypeVariance::createCovariant(); case GenericTypeNode::VARIANCE_CONTRAVARIANT: return TemplateTypeVariance::createContravariant(); case GenericTypeNode::VARIANCE_BIVARIANT: return TemplateTypeVariance::createBivariant(); } }, $typeNode->variances); if (in_array($mainTypeName, ['array', 'non-empty-array'], \true)) { if (count($genericTypes) === 1) { // array<ValueType> $arrayType = new ArrayType(new BenevolentUnionType([new IntegerType(), new StringType()]), $genericTypes[0]); } elseif (count($genericTypes) === 2) { // array<KeyType, ValueType> $keyType = TypeCombinator::intersect($genericTypes[0], new UnionType([new IntegerType(), new StringType()])); $arrayType = new ArrayType($keyType->toArrayKey(), $genericTypes[1]); } else { return new ErrorType(); } if ($mainTypeName === 'non-empty-array') { return TypeCombinator::intersect($arrayType, new NonEmptyArrayType()); } return $arrayType; } elseif (in_array($mainTypeName, ['list', 'non-empty-list'], \true)) { if (count($genericTypes) === 1) { // list<ValueType> $listType = AccessoryArrayListType::intersectWith(new ArrayType(new IntegerType(), $genericTypes[0])); if ($mainTypeName === 'non-empty-list') { return TypeCombinator::intersect($listType, new NonEmptyArrayType()); } return $listType; } return new ErrorType(); } elseif ($mainTypeName === 'iterable') { if (count($genericTypes) === 1) { // iterable<ValueType> return new IterableType(new MixedType(\true), $genericTypes[0]); } if (count($genericTypes) === 2) { // iterable<KeyType, ValueType> return new IterableType($genericTypes[0], $genericTypes[1]); } } elseif (in_array($mainTypeName, ['class-string', 'interface-string'], \true)) { if (count($genericTypes) === 1) { $genericType = $genericTypes[0]; if ($genericType->isObject()->yes() || $genericType instanceof MixedType) { return new GenericClassStringType($genericType); } } return new ErrorType(); } elseif ($mainTypeName === 'int') { if (count($genericTypes) === 2) { // int<min, max>, int<1, 3> if ($genericTypes[0] instanceof ConstantIntegerType) { $min = $genericTypes[0]->getValue(); } elseif ($typeNode->genericTypes[0] instanceof IdentifierTypeNode && $typeNode->genericTypes[0]->name === 'min') { $min = null; } else { return new ErrorType(); } if ($genericTypes[1] instanceof ConstantIntegerType) { $max = $genericTypes[1]->getValue(); } elseif ($typeNode->genericTypes[1] instanceof IdentifierTypeNode && $typeNode->genericTypes[1]->name === 'max') { $max = null; } else { return new ErrorType(); } return IntegerRangeType::fromInterval($min, $max); } } elseif ($mainTypeName === 'key-of') { if (count($genericTypes) === 1) { // key-of<ValueType> $type = new KeyOfType($genericTypes[0]); return $type->isResolvable() ? $type->resolve() : $type; } return new ErrorType(); } elseif ($mainTypeName === 'value-of') { if (count($genericTypes) === 1) { // value-of<ValueType> $type = new ValueOfType($genericTypes[0]); return $type->isResolvable() ? $type->resolve() : $type; } return new ErrorType(); } elseif ($mainTypeName === 'int-mask-of') { if (count($genericTypes) === 1) { // int-mask-of<Class::CONST*> $maskType = $this->expandIntMaskToType($genericTypes[0]); if ($maskType !== null) { return $maskType; } } return new ErrorType(); } elseif ($mainTypeName === 'int-mask') { if (count($genericTypes) > 0) { // int-mask<1, 2, 4> $maskType = $this->expandIntMaskToType(TypeCombinator::union(...$genericTypes)); if ($maskType !== null) { return $maskType; } } return new ErrorType(); } elseif ($mainTypeName === '__benevolent') { if (count($genericTypes) === 1) { return TypeUtils::toBenevolentUnion($genericTypes[0]); } return new ErrorType(); } elseif ($mainTypeName === 'template-type') { if (count($genericTypes) === 3) { $result = []; /** @var class-string $ancestorClassName */ foreach ($genericTypes[1]->getObjectClassNames() as $ancestorClassName) { foreach ($genericTypes[2]->getConstantStrings() as $templateTypeName) { $result[] = new GetTemplateTypeType($genericTypes[0], $ancestorClassName, $templateTypeName->getValue()); } } return TypeCombinator::union(...$result); } return new ErrorType(); } elseif ($mainTypeName === 'new') { if (count($genericTypes) === 1) { $type = new NewObjectType($genericTypes[0]); return $type->isResolvable() ? $type->resolve() : $type; } return new ErrorType(); } elseif ($mainTypeName === 'static') { if ($nameScope->getClassName() !== null && $this->getReflectionProvider()->hasClass($nameScope->getClassName())) { $classReflection = $this->getReflectionProvider()->getClass($nameScope->getClassName()); return new GenericStaticType($classReflection, $genericTypes, null, $variances); } return new ErrorType(); } $mainType = $this->resolveIdentifierTypeNode($typeNode->type, $nameScope); $mainTypeObjectClassNames = $mainType->getObjectClassNames(); if (count($mainTypeObjectClassNames) > 1) { if ($mainType instanceof TemplateType) { return new ErrorType(); } throw new ShouldNotHappenException(); } $mainTypeClassName = $mainTypeObjectClassNames[0] ?? null; if ($mainTypeClassName !== null) { if (!$this->getReflectionProvider()->hasClass($mainTypeClassName)) { return new GenericObjectType($mainTypeClassName, $genericTypes, null, null, $variances); } $classReflection = $this->getReflectionProvider()->getClass($mainTypeClassName); if ($classReflection->isGeneric()) { $templateTypes = array_values($classReflection->getTemplateTypeMap()->getTypes()); for ($i = count($genericTypes), $templateTypesCount = count($templateTypes); $i < $templateTypesCount; $i++) { $templateType = $templateTypes[$i]; if (!$templateType instanceof TemplateType || $templateType->getDefault() === null) { continue; } $genericTypes[] = $templateType->getDefault(); } if (in_array($mainTypeClassName, [Traversable::class, IteratorAggregate::class, Iterator::class], \true)) { if (count($genericTypes) === 1) { return new GenericObjectType($mainTypeClassName, [new MixedType(\true), $genericTypes[0]], null, null, [TemplateTypeVariance::createInvariant(), $variances[0]]); } if (count($genericTypes) === 2) { return new GenericObjectType($mainTypeClassName, [$genericTypes[0], $genericTypes[1]], null, null, [$variances[0], $variances[1]]); } } if ($mainTypeClassName === Generator::class) { if (count($genericTypes) === 1) { $mixed = new MixedType(\true); return new GenericObjectType($mainTypeClassName, [$mixed, $genericTypes[0], $mixed, $mixed], null, null, [TemplateTypeVariance::createInvariant(), $variances[0], TemplateTypeVariance::createInvariant(), TemplateTypeVariance::createInvariant()]); } if (count($genericTypes) === 2) { $mixed = new MixedType(\true); return new GenericObjectType($mainTypeClassName, [$genericTypes[0], $genericTypes[1], $mixed, $mixed], null, null, [$variances[0], $variances[1], TemplateTypeVariance::createInvariant(), TemplateTypeVariance::createInvariant()]); } } if (!$mainType->isIterable()->yes()) { return new GenericObjectType($mainTypeClassName, $genericTypes, null, null, $variances); } if (count($genericTypes) !== 1 || $classReflection->getTemplateTypeMap()->count() === 1) { return new GenericObjectType($mainTypeClassName, $genericTypes, null, null, $variances); } } } if ($mainType->isIterable()->yes()) { if ($mainTypeClassName !== null) { if (isset($this->genericTypeResolvingStack[$mainTypeClassName])) { return new ErrorType(); } $this->genericTypeResolvingStack[$mainTypeClassName] = \true; } try { if (count($genericTypes) === 1) { // Foo<ValueType> return TypeCombinator::intersect($mainType, new IterableType(new MixedType(\true), $genericTypes[0])); } if (count($genericTypes) === 2) { // Foo<KeyType, ValueType> return TypeCombinator::intersect($mainType, new IterableType($genericTypes[0], $genericTypes[1])); } } finally { if ($mainTypeClassName !== null) { unset($this->genericTypeResolvingStack[$mainTypeClassName]); } } } if ($mainTypeClassName !== null) { return new GenericObjectType($mainTypeClassName, $genericTypes, null, null, $variances); } return new ErrorType(); } private function resolveCallableTypeNode(CallableTypeNode $typeNode, NameScope $nameScope) : Type { $templateTags = []; if (count($typeNode->templateTypes ?? []) > 0) { foreach ($typeNode->templateTypes as $templateType) { $templateTags[$templateType->name] = new TemplateTag($templateType->name, $templateType->bound !== null ? $this->resolve($templateType->bound, $nameScope) : new MixedType(), $templateType->default !== null ? $this->resolve($templateType->default, $nameScope) : null, TemplateTypeVariance::createInvariant()); } $templateTypeScope = TemplateTypeScope::createWithAnonymousFunction(); $templateTypeMap = new TemplateTypeMap(array_map(static function (TemplateTag $tag) use($templateTypeScope) : Type { return TemplateTypeFactory::fromTemplateTag($templateTypeScope, $tag); }, $templateTags)); $nameScope = $nameScope->withTemplateTypeMap($templateTypeMap); } else { $templateTypeMap = TemplateTypeMap::createEmpty(); } $mainType = $this->resolve($typeNode->identifier, $nameScope); $isVariadic = \false; $parameters = array_map(function (CallableTypeParameterNode $parameterNode) use($nameScope, &$isVariadic) : NativeParameterReflection { $isVariadic = $isVariadic || $parameterNode->isVariadic; $parameterName = $parameterNode->parameterName; if (str_starts_with($parameterName, '$')) { $parameterName = substr($parameterName, 1); } return new NativeParameterReflection($parameterName, $parameterNode->isOptional || $parameterNode->isVariadic, $this->resolve($parameterNode->type, $nameScope), $parameterNode->isReference ? PassedByReference::createCreatesNewVariable() : PassedByReference::createNo(), $parameterNode->isVariadic, null); }, $typeNode->parameters); $returnType = $this->resolve($typeNode->returnType, $nameScope); if ($mainType instanceof CallableType) { $pure = $mainType->isPure(); if ($pure->yes() && $returnType->isVoid()->yes()) { return new ErrorType(); } return new CallableType($parameters, $returnType, $isVariadic, $templateTypeMap, null, $templateTags, $pure); } elseif ($mainType instanceof ObjectType && $mainType->getClassName() === Closure::class) { return new ClosureType($parameters, $returnType, $isVariadic, $templateTypeMap, null, null, $templateTags, [], [new SimpleImpurePoint('functionCall', 'call to a Closure', \false)]); } elseif ($mainType instanceof ClosureType) { $closure = new ClosureType($parameters, $returnType, $isVariadic, $templateTypeMap, null, null, $templateTags, [], $mainType->getImpurePoints(), $mainType->getInvalidateExpressions(), $mainType->getUsedVariables(), $mainType->acceptsNamedArguments()); if ($closure->isPure()->yes() && $returnType->isVoid()->yes()) { return new ErrorType(); } return $closure; } return new ErrorType(); } private function resolveArrayShapeNode(ArrayShapeNode $typeNode, NameScope $nameScope) : Type { $builder = ConstantArrayTypeBuilder::createEmpty(); if (count($typeNode->items) > ConstantArrayTypeBuilder::ARRAY_COUNT_LIMIT) { $builder->degradeToGeneralArray(\true); } foreach ($typeNode->items as $itemNode) { $offsetType = null; if ($itemNode->keyName instanceof ConstExprIntegerNode) { $offsetType = new ConstantIntegerType((int) $itemNode->keyName->value); } elseif ($itemNode->keyName instanceof IdentifierTypeNode) { $offsetType = new ConstantStringType($itemNode->keyName->name); } elseif ($itemNode->keyName instanceof ConstExprStringNode) { $offsetType = new ConstantStringType($itemNode->keyName->value); } elseif ($itemNode->keyName !== null) { throw new ShouldNotHappenException('Unsupported key node type: ' . get_class($itemNode->keyName)); } $builder->setOffsetValueType($offsetType, $this->resolve($itemNode->valueType, $nameScope), $itemNode->optional); } $arrayType = $builder->getArray(); if (in_array($typeNode->kind, [ArrayShapeNode::KIND_LIST, ArrayShapeNode::KIND_NON_EMPTY_LIST], \true)) { $arrayType = AccessoryArrayListType::intersectWith($arrayType); } if (in_array($typeNode->kind, [ArrayShapeNode::KIND_NON_EMPTY_ARRAY, ArrayShapeNode::KIND_NON_EMPTY_LIST], \true)) { $arrayType = TypeCombinator::intersect($arrayType, new NonEmptyArrayType()); } return $arrayType; } private function resolveObjectShapeNode(ObjectShapeNode $typeNode, NameScope $nameScope) : Type { $properties = []; $optionalProperties = []; foreach ($typeNode->items as $itemNode) { if ($itemNode->keyName instanceof IdentifierTypeNode) { $propertyName = $itemNode->keyName->name; } elseif ($itemNode->keyName instanceof ConstExprStringNode) { $propertyName = $itemNode->keyName->value; } if ($itemNode->optional) { $optionalProperties[] = $propertyName; } $properties[$propertyName] = $this->resolve($itemNode->valueType, $nameScope); } return new ObjectShapeType($properties, $optionalProperties); } private function resolveConstTypeNode(ConstTypeNode $typeNode, NameScope $nameScope) : Type { $constExpr = $typeNode->constExpr; if ($constExpr instanceof ConstExprArrayNode) { throw new ShouldNotHappenException(); // we prefer array shapes } if ($constExpr instanceof ConstExprFalseNode || $constExpr instanceof ConstExprTrueNode || $constExpr instanceof ConstExprNullNode) { throw new ShouldNotHappenException(); // we prefer IdentifierTypeNode } if ($constExpr instanceof ConstFetchNode) { if ($constExpr->className === '') { throw new ShouldNotHappenException(); // global constant should get parsed as class name in IdentifierTypeNode } if ($nameScope->getClassName() !== null) { switch (strtolower($constExpr->className)) { case 'static': case 'self': $className = $nameScope->getClassName(); break; case 'parent': if ($this->getReflectionProvider()->hasClass($nameScope->getClassName())) { $classReflection = $this->getReflectionProvider()->getClass($nameScope->getClassName()); if ($classReflection->getParentClass() === null) { return new ErrorType(); } $className = $classReflection->getParentClass()->getName(); } break; } } if (!isset($className)) { $className = $nameScope->resolveStringName($constExpr->className); } if (!$this->getReflectionProvider()->hasClass($className)) { return new ErrorType(); } $classReflection = $this->getReflectionProvider()->getClass($className); $constantName = $constExpr->name; if (Strings::contains($constantName, '*')) { // convert * into .*? and escape everything else so the constants can be matched against the pattern $pattern = '{^' . str_replace('\\*', '.*?', preg_quote($constantName)) . '$}D'; $constantTypes = []; foreach ($classReflection->getNativeReflection()->getReflectionConstants() as $reflectionConstant) { $classConstantName = $reflectionConstant->getName(); if (Strings::match($classConstantName, $pattern) === null) { continue; } if ($classReflection->isEnum() && $classReflection->hasEnumCase($classConstantName)) { $constantTypes[] = new EnumCaseObjectType($classReflection->getName(), $classConstantName); continue; } $declaringClassName = $reflectionConstant->getDeclaringClass()->getName(); if (!$this->getReflectionProvider()->hasClass($declaringClassName)) { continue; } $constantTypes[] = $this->initializerExprTypeResolver->getType($reflectionConstant->getValueExpression(), InitializerExprContext::fromClassReflection($this->getReflectionProvider()->getClass($declaringClassName))); } if (count($constantTypes) === 0) { return new ErrorType(); } return TypeCombinator::union(...$constantTypes); } if (!$classReflection->hasConstant($constantName)) { return new ErrorType(); } if ($classReflection->isEnum() && $classReflection->hasEnumCase($constantName)) { return new EnumCaseObjectType($classReflection->getName(), $constantName); } $reflectionConstant = $classReflection->getNativeReflection()->getReflectionConstant($constantName); if ($reflectionConstant === \false) { return new ErrorType(); } $declaringClass = $reflectionConstant->getDeclaringClass(); return $this->initializerExprTypeResolver->getType($reflectionConstant->getValueExpression(), InitializerExprContext::fromClass($declaringClass->getName(), $declaringClass->getFileName() ?: null)); } if ($constExpr instanceof ConstExprFloatNode) { return new ConstantFloatType((float) $constExpr->value); } if ($constExpr instanceof ConstExprIntegerNode) { return new ConstantIntegerType((int) $constExpr->value); } if ($constExpr instanceof ConstExprStringNode) { return new ConstantStringType($constExpr->value); } return new ErrorType(); } private function resolveOffsetAccessNode(OffsetAccessTypeNode $typeNode, NameScope $nameScope) : Type { $type = $this->resolve($typeNode->type, $nameScope); $offset = $this->resolve($typeNode->offset, $nameScope); if ($type->isOffsetAccessible()->no() || $type->hasOffsetValueType($offset)->no()) { return new ErrorType(); } return new OffsetAccessType($type, $offset); } private function expandIntMaskToType(Type $type) : ?Type { $ints = array_map(static function (ConstantIntegerType $type) { return $type->getValue(); }, TypeUtils::getConstantIntegers($type)); if (count($ints) === 0) { return null; } $values = []; foreach ($ints as $int) { if ($int !== 0 && !array_key_exists($int, $values)) { foreach ($values as $value) { $computedValue = $value | $int; $values[$computedValue] = $computedValue; } } $values[$int] = $int; } $values[0] = 0; $min = min($values); $max = max($values); if ($max - $min === count($values) - 1) { return IntegerRangeType::fromInterval($min, $max); } return TypeCombinator::union(...array_map(static function ($value) { return new ConstantIntegerType($value); }, $values)); } /** * @api * @param TypeNode[] $typeNodes * @return Type[] */ public function resolveMultiple(array $typeNodes, NameScope $nameScope) : array { $types = []; foreach ($typeNodes as $typeNode) { $types[] = $this->resolve($typeNode, $nameScope); } return $types; } private function getReflectionProvider() : ReflectionProvider { return $this->reflectionProviderProvider->getReflectionProvider(); } private function getTypeAliasResolver() : TypeAliasResolver { return $this->typeAliasResolverProvider->getTypeAliasResolver(); } } <?php declare (strict_types=1); namespace PHPStan\DependencyInjection; use function array_merge; final class DerivativeContainerFactory { /** * @var string */ private $currentWorkingDirectory; /** * @var string */ private $tempDirectory; /** * @var string[] */ private $additionalConfigFiles; /** * @var string[] */ private $analysedPaths; /** * @var string[] */ private $composerAutoloaderProjectPaths; /** * @var string[] */ private $analysedPathsFromConfig; /** * @var string */ private $usedLevel; /** * @var ?string */ private $generateBaselineFile; /** * @var ?string */ private $cliAutoloadFile; /** * @param string[] $additionalConfigFiles * @param string[] $analysedPaths * @param string[] $composerAutoloaderProjectPaths * @param string[] $analysedPathsFromConfig */ public function __construct(string $currentWorkingDirectory, string $tempDirectory, array $additionalConfigFiles, array $analysedPaths, array $composerAutoloaderProjectPaths, array $analysedPathsFromConfig, string $usedLevel, ?string $generateBaselineFile, ?string $cliAutoloadFile) { $this->currentWorkingDirectory = $currentWorkingDirectory; $this->tempDirectory = $tempDirectory; $this->additionalConfigFiles = $additionalConfigFiles; $this->analysedPaths = $analysedPaths; $this->composerAutoloaderProjectPaths = $composerAutoloaderProjectPaths; $this->analysedPathsFromConfig = $analysedPathsFromConfig; $this->usedLevel = $usedLevel; $this->generateBaselineFile = $generateBaselineFile; $this->cliAutoloadFile = $cliAutoloadFile; } /** * @param string[] $additionalConfigFiles */ public function create(array $additionalConfigFiles) : \PHPStan\DependencyInjection\Container { $containerFactory = new \PHPStan\DependencyInjection\ContainerFactory($this->currentWorkingDirectory); return $containerFactory->create($this->tempDirectory, array_merge($this->additionalConfigFiles, $additionalConfigFiles), $this->analysedPaths, $this->composerAutoloaderProjectPaths, $this->analysedPathsFromConfig, $this->usedLevel, $this->generateBaselineFile, $this->cliAutoloadFile); } } <?php declare (strict_types=1); namespace PHPStan\DependencyInjection; use Exception; use function implode; final class InvalidExcludePathsException extends Exception { /** * @var string[] */ private $errors; /** * @param string[] $errors */ public function __construct(array $errors) { $this->errors = $errors; parent::__construct(implode("\n", $this->errors)); } /** * @return string[] */ public function getErrors() : array { return $this->errors; } } <?php declare (strict_types=1); namespace PHPStan\DependencyInjection; use _PHPStan_7d8742a37\Nette\DI\Definitions\Statement; use function array_merge; use function array_unique; use function array_values; use function is_array; use function is_string; final class ProjectConfigHelper { /** * @param array<mixed> $projectConfig * @return list<string> */ public static function getServiceClassNames(array $projectConfig) : array { $services = array_merge($projectConfig['services'] ?? [], $projectConfig['rules'] ?? []); $classes = []; foreach ($services as $service) { $classes = array_merge($classes, self::getClassesFromConfigDefinition($service)); if (!is_array($service)) { continue; } foreach (['class', 'factory', 'implement'] as $key) { if (!isset($service[$key])) { continue; } $classes = array_merge($classes, self::getClassesFromConfigDefinition($service[$key])); } } return array_values(array_unique($classes)); } /** * @param mixed $definition * @return string[] */ private static function getClassesFromConfigDefinition($definition) : array { if (is_string($definition)) { return [$definition]; } if ($definition instanceof Statement) { $entity = $definition->entity; if (is_string($entity)) { return [$entity]; } elseif (is_array($entity) && isset($entity[0]) && is_string($entity[0])) { return [$entity[0]]; } } return []; } } <?php declare (strict_types=1); namespace PHPStan\DependencyInjection; /** @api */ interface Container { public function hasService(string $serviceName) : bool; /** * @return mixed */ public function getService(string $serviceName); /** * @template T of object * @param class-string<T> $className * @return T */ public function getByType(string $className); /** * @param class-string $className * @return string[] */ public function findServiceNamesByType(string $className) : array; /** * @return mixed[] */ public function getServicesByTag(string $tagName) : array; /** * @return mixed[] */ public function getParameters() : array; public function hasParameter(string $parameterName) : bool; /** * @return mixed * @throws ParameterNotFoundException */ public function getParameter(string $parameterName); } <?php declare (strict_types=1); namespace PHPStan\DependencyInjection; use _PHPStan_7d8742a37\Nette\Bootstrap\Extensions\PhpExtension; use _PHPStan_7d8742a37\Nette\DI\Config\Adapters\PhpAdapter; use _PHPStan_7d8742a37\Nette\DI\Definitions\Statement; use _PHPStan_7d8742a37\Nette\DI\Extensions\ExtensionsExtension; use _PHPStan_7d8742a37\Nette\DI\Helpers; use _PHPStan_7d8742a37\Nette\Schema\Context as SchemaContext; use _PHPStan_7d8742a37\Nette\Schema\Elements\AnyOf; use _PHPStan_7d8742a37\Nette\Schema\Elements\Structure; use _PHPStan_7d8742a37\Nette\Schema\Elements\Type; use _PHPStan_7d8742a37\Nette\Schema\Expect; use _PHPStan_7d8742a37\Nette\Schema\Processor; use _PHPStan_7d8742a37\Nette\Schema\Schema; use _PHPStan_7d8742a37\Nette\Utils\Strings; use _PHPStan_7d8742a37\Nette\Utils\Validators; use Phar; use PhpParser\Parser; use PHPStan\BetterReflection\BetterReflection; use PHPStan\BetterReflection\Reflector\Reflector; use PHPStan\BetterReflection\SourceLocator\SourceStubber\PhpStormStubsSourceStubber; use PHPStan\BetterReflection\SourceLocator\Type\SourceLocator; use PHPStan\Broker\Broker; use PHPStan\Command\CommandHelper; use PHPStan\File\FileHelper; use PHPStan\Node\Printer\Printer; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\PhpVersionStaticAccessor; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Reflection\ReflectionProviderStaticAccessor; use PHPStan\ShouldNotHappenException; use PHPStan\Type\Accessory\AccessoryArrayListType; use PHPStan\Type\Generic\TemplateTypeVariance; use PHPStan\Type\ObjectType; use _PHPStan_7d8742a37\Symfony\Component\Finder\Finder; use function array_diff_key; use function array_map; use function array_merge; use function array_unique; use function count; use function dirname; use function extension_loaded; use function getenv; use function ini_get; use function is_array; use function is_dir; use function is_file; use function is_readable; use function spl_object_id; use function sprintf; use function str_ends_with; use function substr; use function time; use function unlink; /** * @api * @final */ class ContainerFactory { /** * @var string */ private $currentWorkingDirectory; /** * @var bool */ private $checkDuplicateFiles; /** * @var FileHelper */ private $fileHelper; /** * @var string */ private $rootDirectory; /** * @var string */ private $configDirectory; /** * @var ?int */ private static $lastInitializedContainerId = null; /** @api */ public function __construct(string $currentWorkingDirectory, bool $checkDuplicateFiles = \false) { $this->currentWorkingDirectory = $currentWorkingDirectory; $this->checkDuplicateFiles = $checkDuplicateFiles; $this->fileHelper = new FileHelper($currentWorkingDirectory); $rootDir = __DIR__ . '/../..'; $originalRootDir = $this->fileHelper->normalizePath($rootDir); if (extension_loaded('phar')) { $pharPath = Phar::running(\false); if ($pharPath !== '') { $rootDir = dirname($pharPath); } } $this->rootDirectory = $this->fileHelper->normalizePath($rootDir); $this->configDirectory = $originalRootDir . '/conf'; } /** * @param string[] $additionalConfigFiles * @param string[] $analysedPaths * @param string[] $composerAutoloaderProjectPaths * @param string[] $analysedPathsFromConfig */ public function create(string $tempDirectory, array $additionalConfigFiles, array $analysedPaths, array $composerAutoloaderProjectPaths = [], array $analysedPathsFromConfig = [], string $usedLevel = CommandHelper::DEFAULT_LEVEL, ?string $generateBaselineFile = null, ?string $cliAutoloadFile = null) : \PHPStan\DependencyInjection\Container { [$allConfigFiles, $projectConfig] = $this->detectDuplicateIncludedFiles(array_merge([__DIR__ . '/../../conf/parametersSchema.neon'], $additionalConfigFiles), ['rootDir' => $this->rootDirectory, 'currentWorkingDirectory' => $this->currentWorkingDirectory, 'env' => getenv()]); $configurator = new \PHPStan\DependencyInjection\Configurator(new \PHPStan\DependencyInjection\LoaderFactory($this->fileHelper, $this->rootDirectory, $this->currentWorkingDirectory, $generateBaselineFile)); $configurator->defaultExtensions = ['php' => PhpExtension::class, 'extensions' => ExtensionsExtension::class]; $configurator->setDebugMode(\true); $configurator->setTempDirectory($tempDirectory); $configurator->addParameters(['rootDir' => $this->rootDirectory, 'currentWorkingDirectory' => $this->currentWorkingDirectory, 'cliArgumentsVariablesRegistered' => ini_get('register_argc_argv') === '1', 'tmpDir' => $tempDirectory, 'additionalConfigFiles' => $additionalConfigFiles, 'allConfigFiles' => $allConfigFiles, 'composerAutoloaderProjectPaths' => $composerAutoloaderProjectPaths, 'generateBaselineFile' => $generateBaselineFile, 'usedLevel' => $usedLevel, 'cliAutoloadFile' => $cliAutoloadFile]); $configurator->addDynamicParameters(['analysedPaths' => $analysedPaths, 'analysedPathsFromConfig' => $analysedPathsFromConfig, 'env' => getenv()]); $configurator->addConfig($this->configDirectory . '/config.neon'); foreach ($additionalConfigFiles as $additionalConfigFile) { $configurator->addConfig($additionalConfigFile); } $configurator->setAllConfigFiles($allConfigFiles); $container = $configurator->createContainer()->getByType(\PHPStan\DependencyInjection\Container::class); $this->validateParameters($container->getParameters(), $projectConfig['parametersSchema']); self::postInitializeContainer($container); return $container; } /** @internal */ public static function postInitializeContainer(\PHPStan\DependencyInjection\Container $container) : void { $containerId = spl_object_id($container); if ($containerId === self::$lastInitializedContainerId) { return; } self::$lastInitializedContainerId = $containerId; /** @var SourceLocator $sourceLocator */ $sourceLocator = $container->getService('betterReflectionSourceLocator'); /** @var Reflector $reflector */ $reflector = $container->getService('betterReflectionReflector'); /** @var Parser $phpParser */ $phpParser = $container->getService('phpParserDecorator'); BetterReflection::populate($container->getByType(PhpVersion::class)->getVersionId(), $sourceLocator, $reflector, $phpParser, $container->getByType(PhpStormStubsSourceStubber::class), $container->getByType(Printer::class)); $broker = $container->getByType(Broker::class); Broker::registerInstance($broker); ReflectionProviderStaticAccessor::registerInstance($container->getByType(ReflectionProvider::class)); PhpVersionStaticAccessor::registerInstance($container->getByType(PhpVersion::class)); ObjectType::resetCaches(); $container->getService('typeSpecifier'); \PHPStan\DependencyInjection\BleedingEdgeToggle::setBleedingEdge($container->getParameter('featureToggles')['bleedingEdge']); AccessoryArrayListType::setListTypeEnabled($container->getParameter('featureToggles')['listType']); TemplateTypeVariance::setInvarianceCompositionEnabled($container->getParameter('featureToggles')['invarianceComposition']); } public function clearOldContainers(string $tempDirectory) : void { $configurator = new \PHPStan\DependencyInjection\Configurator(new \PHPStan\DependencyInjection\LoaderFactory($this->fileHelper, $this->rootDirectory, $this->currentWorkingDirectory, null)); $configurator->setDebugMode(\true); $configurator->setTempDirectory($tempDirectory); $containerDirectory = $configurator->getContainerCacheDirectory(); if (!is_dir($containerDirectory)) { return; } $finder = new Finder(); $finder->name('Container_*')->in($containerDirectory); $twoDaysAgo = time() - 24 * 60 * 60 * 2; foreach ($finder as $containerFile) { $path = $containerFile->getRealPath(); if ($path === \false) { continue; } if ($containerFile->getATime() > $twoDaysAgo) { continue; } if ($containerFile->getCTime() > $twoDaysAgo) { continue; } @unlink($path); } } public function getCurrentWorkingDirectory() : string { return $this->currentWorkingDirectory; } public function getRootDirectory() : string { return $this->rootDirectory; } public function getConfigDirectory() : string { return $this->configDirectory; } /** * @param string[] $configFiles * @param array<string, mixed> $loaderParameters * @return array{list<string>, array<mixed>} * @throws DuplicateIncludedFilesException */ private function detectDuplicateIncludedFiles(array $configFiles, array $loaderParameters) : array { $neonAdapter = new \PHPStan\DependencyInjection\NeonAdapter(); $phpAdapter = new PhpAdapter(); $allConfigFiles = []; $configArray = []; foreach ($configFiles as $configFile) { [$tmpConfigFiles, $tmpConfigArray] = self::getConfigFiles($this->fileHelper, $neonAdapter, $phpAdapter, $configFile, $loaderParameters, null); $allConfigFiles = array_merge($allConfigFiles, $tmpConfigFiles); /** @var array<mixed> $configArray */ $configArray = \_PHPStan_7d8742a37\Nette\Schema\Helpers::merge($tmpConfigArray, $configArray); } $normalized = array_map(function (string $file) : string { return $this->fileHelper->normalizePath($file); }, $allConfigFiles); $deduplicated = array_unique($normalized); if (count($normalized) <= count($deduplicated)) { return [$normalized, $configArray]; } if (!$this->checkDuplicateFiles) { return [$normalized, $configArray]; } $duplicateFiles = array_unique(array_diff_key($normalized, $deduplicated)); throw new \PHPStan\DependencyInjection\DuplicateIncludedFilesException($duplicateFiles); } /** * @param array<string, string> $loaderParameters * @return array{list<string>, array<mixed>} */ private static function getConfigFiles(FileHelper $fileHelper, \PHPStan\DependencyInjection\NeonAdapter $neonAdapter, PhpAdapter $phpAdapter, string $configFile, array $loaderParameters, ?string $generateBaselineFile) : array { if ($generateBaselineFile === $fileHelper->normalizePath($configFile)) { return [[], []]; } if (!is_file($configFile) || !is_readable($configFile)) { return [[], []]; } if (str_ends_with($configFile, '.php')) { $data = $phpAdapter->load($configFile); } else { $data = $neonAdapter->load($configFile); } $allConfigFiles = [$configFile]; if (isset($data['includes'])) { Validators::assert($data['includes'], 'list', sprintf("section 'includes' in file '%s'", $configFile)); $includes = Helpers::expand($data['includes'], $loaderParameters); foreach ($includes as $include) { $include = self::expandIncludedFile($include, $configFile); [$tmpConfigFiles, $tmpConfigArray] = self::getConfigFiles($fileHelper, $neonAdapter, $phpAdapter, $include, $loaderParameters, $generateBaselineFile); $allConfigFiles = array_merge($allConfigFiles, $tmpConfigFiles); /** @var array<mixed> $data */ $data = \_PHPStan_7d8742a37\Nette\Schema\Helpers::merge($tmpConfigArray, $data); } } return [$allConfigFiles, $data]; } private static function expandIncludedFile(string $includedFile, string $mainFile) : string { return Strings::match($includedFile, '#([a-z]+:)?[/\\\\]#Ai') !== null ? $includedFile : dirname($mainFile) . '/' . $includedFile; } /** * @param array<mixed> $parameters * @param array<mixed> $parametersSchema */ private function validateParameters(array $parameters, array $parametersSchema) : void { if (!(bool) $parameters['__validate']) { return; } $schema = $this->processArgument(new Statement('schema', [new Statement('structure', [$parametersSchema])])); $processor = new Processor(); $processor->onNewContext[] = static function (SchemaContext $context) : void { $context->path = ['parameters']; }; $processor->process($schema, $parameters); } /** * @param Statement[] $statements */ private function processSchema(array $statements, bool $required = \true) : Schema { if (count($statements) === 0) { throw new ShouldNotHappenException(); } $parameterSchema = null; foreach ($statements as $statement) { $processedArguments = array_map(function ($argument) { return $this->processArgument($argument); }, $statement->arguments); if ($parameterSchema === null) { /** @var Type|AnyOf|Structure $parameterSchema */ $parameterSchema = Expect::{$statement->getEntity()}(...$processedArguments); } else { $parameterSchema->{$statement->getEntity()}(...$processedArguments); } } if ($required) { $parameterSchema->required(); } return $parameterSchema; } /** * @param mixed $argument * @return mixed */ private function processArgument($argument, bool $required = \true) { if ($argument instanceof Statement) { if ($argument->entity === 'schema') { $arguments = []; foreach ($argument->arguments as $schemaArgument) { if (!$schemaArgument instanceof Statement) { throw new ShouldNotHappenException('schema() should contain another statement().'); } $arguments[] = $schemaArgument; } if (count($arguments) === 0) { throw new ShouldNotHappenException('schema() should have at least one argument.'); } return $this->processSchema($arguments, $required); } return $this->processSchema([$argument], $required); } elseif (is_array($argument)) { $processedArray = []; foreach ($argument as $key => $val) { $required = $key[0] !== '?'; $key = $required ? $key : substr($key, 1); $processedArray[$key] = $this->processArgument($val, $required); } return $processedArray; } return $argument; } } <?php declare (strict_types=1); namespace PHPStan\DependencyInjection\Reflection; use PHPStan\Reflection\ClassReflectionExtensionRegistry; interface ClassReflectionExtensionRegistryProvider { public function getRegistry() : ClassReflectionExtensionRegistry; } <?php declare (strict_types=1); namespace PHPStan\DependencyInjection\Reflection; use PHPStan\Broker\Broker; use PHPStan\Broker\BrokerFactory; use PHPStan\DependencyInjection\Container; use PHPStan\Reflection\Annotations\AnnotationsMethodsClassReflectionExtension; use PHPStan\Reflection\Annotations\AnnotationsPropertiesClassReflectionExtension; use PHPStan\Reflection\ClassReflectionExtensionRegistry; use PHPStan\Reflection\Mixin\MixinMethodsClassReflectionExtension; use PHPStan\Reflection\Mixin\MixinPropertiesClassReflectionExtension; use PHPStan\Reflection\Php\PhpClassReflectionExtension; use PHPStan\Reflection\RequireExtension\RequireExtendsMethodsClassReflectionExtension; use PHPStan\Reflection\RequireExtension\RequireExtendsPropertiesClassReflectionExtension; use function array_merge; final class LazyClassReflectionExtensionRegistryProvider implements \PHPStan\DependencyInjection\Reflection\ClassReflectionExtensionRegistryProvider { /** * @var Container */ private $container; /** * @var ?ClassReflectionExtensionRegistry */ private $registry = null; public function __construct(Container $container) { $this->container = $container; } public function getRegistry() : ClassReflectionExtensionRegistry { if ($this->registry === null) { $phpClassReflectionExtension = $this->container->getByType(PhpClassReflectionExtension::class); $annotationsMethodsClassReflectionExtension = $this->container->getByType(AnnotationsMethodsClassReflectionExtension::class); $annotationsPropertiesClassReflectionExtension = $this->container->getByType(AnnotationsPropertiesClassReflectionExtension::class); $mixinMethodsClassReflectionExtension = $this->container->getByType(MixinMethodsClassReflectionExtension::class); $mixinPropertiesClassReflectionExtension = $this->container->getByType(MixinPropertiesClassReflectionExtension::class); $this->registry = new ClassReflectionExtensionRegistry($this->container->getByType(Broker::class), array_merge([$phpClassReflectionExtension], $this->container->getServicesByTag(BrokerFactory::PROPERTIES_CLASS_REFLECTION_EXTENSION_TAG), [$annotationsPropertiesClassReflectionExtension, $mixinPropertiesClassReflectionExtension]), array_merge([$phpClassReflectionExtension], $this->container->getServicesByTag(BrokerFactory::METHODS_CLASS_REFLECTION_EXTENSION_TAG), [$annotationsMethodsClassReflectionExtension, $mixinMethodsClassReflectionExtension]), $this->container->getServicesByTag(BrokerFactory::ALLOWED_SUB_TYPES_CLASS_REFLECTION_EXTENSION_TAG), $this->container->getByType(RequireExtendsPropertiesClassReflectionExtension::class), $this->container->getByType(RequireExtendsMethodsClassReflectionExtension::class)); } return $this->registry; } } <?php declare (strict_types=1); namespace PHPStan\DependencyInjection; final class BleedingEdgeToggle { /** * @var bool */ private static $bleedingEdge = \false; public static function isBleedingEdge() : bool { return self::$bleedingEdge; } public static function setBleedingEdge(bool $bleedingEdge) : void { self::$bleedingEdge = $bleedingEdge; } } <?php declare (strict_types=1); namespace PHPStan\DependencyInjection; use _PHPStan_7d8742a37\Nette\DI\CompilerExtension; use PHPStan\DependencyInjection\Neon\OptionalPath; use PHPStan\File\FileExcluder; use function array_key_exists; use function array_map; use function array_merge; use function count; use function is_dir; use function is_file; use function sprintf; final class ValidateExcludePathsExtension extends CompilerExtension { /** * @throws InvalidExcludePathsException */ public function loadConfiguration() : void { $builder = $this->getContainerBuilder(); $excludePaths = $builder->parameters['excludePaths']; if ($excludePaths === null) { return; } $errors = []; $noImplicitWildcard = $builder->parameters['featureToggles']['noImplicitWildcard']; if ($builder->parameters['__validate'] && $noImplicitWildcard) { $paths = []; if (array_key_exists('analyse', $excludePaths)) { $paths = $excludePaths['analyse']; } if (array_key_exists('analyseAndScan', $excludePaths)) { $paths = array_merge($paths, $excludePaths['analyseAndScan']); } foreach ($paths as $path) { if ($path instanceof OptionalPath) { continue; } if (FileExcluder::isAbsolutePath($path)) { if (is_dir($path)) { continue; } if (is_file($path)) { continue; } } if (FileExcluder::isFnmatchPattern($path)) { continue; } $errors[] = sprintf('Path %s is neither a directory, nor a file path, nor a fnmatch pattern.', $path); } } $newExcludePaths = []; if (array_key_exists('analyseAndScan', $excludePaths)) { $newExcludePaths['analyseAndScan'] = $excludePaths['analyseAndScan']; } if (array_key_exists('analyse', $excludePaths)) { $newExcludePaths['analyse'] = $excludePaths['analyse']; } foreach ($newExcludePaths as $key => $p) { $newExcludePaths[$key] = array_map(static function ($path) { return $path instanceof OptionalPath ? $path->path : $path; }, $p); } $builder->parameters['excludePaths'] = $newExcludePaths; if (count($errors) === 0) { return; } throw new \PHPStan\DependencyInjection\InvalidExcludePathsException($errors); } } <?php declare (strict_types=1); namespace PHPStan\DependencyInjection; use _PHPStan_7d8742a37\Nette\DI\Config\Loader; use PHPStan\File\FileHelper; use function getenv; final class LoaderFactory { /** * @var FileHelper */ private $fileHelper; /** * @var string */ private $rootDir; /** * @var string */ private $currentWorkingDirectory; /** * @var ?string */ private $generateBaselineFile; public function __construct(FileHelper $fileHelper, string $rootDir, string $currentWorkingDirectory, ?string $generateBaselineFile) { $this->fileHelper = $fileHelper; $this->rootDir = $rootDir; $this->currentWorkingDirectory = $currentWorkingDirectory; $this->generateBaselineFile = $generateBaselineFile; } public function createLoader() : Loader { $loader = new \PHPStan\DependencyInjection\NeonLoader($this->fileHelper, $this->generateBaselineFile); $loader->addAdapter('dist', \PHPStan\DependencyInjection\NeonAdapter::class); $loader->addAdapter('neon', \PHPStan\DependencyInjection\NeonAdapter::class); $loader->setParameters(['rootDir' => $this->rootDir, 'currentWorkingDirectory' => $this->currentWorkingDirectory, 'env' => getenv()]); return $loader; } } <?php declare (strict_types=1); namespace PHPStan\DependencyInjection; use _PHPStan_7d8742a37\Nette; use _PHPStan_7d8742a37\Nette\DI\CompilerExtension; use _PHPStan_7d8742a37\Nette\Schema\Expect; use PHPStan\Analyser\TypeSpecifierFactory; use PHPStan\Broker\BrokerFactory; use PHPStan\Collectors\RegistryFactory as CollectorRegistryFactory; use PHPStan\DependencyInjection\Type\LazyDynamicThrowTypeExtensionProvider; use PHPStan\DependencyInjection\Type\LazyParameterClosureTypeExtensionProvider; use PHPStan\DependencyInjection\Type\LazyParameterOutTypeExtensionProvider; use PHPStan\Diagnose\DiagnoseExtension; use PHPStan\Parser\RichParser; use PHPStan\PhpDoc\StubFilesExtension; use PHPStan\PhpDoc\TypeNodeResolverExtension; use PHPStan\Rules\Constants\AlwaysUsedClassConstantsExtensionProvider; use PHPStan\Rules\LazyRegistry; use PHPStan\Rules\Properties\ReadWritePropertiesExtensionProvider; use PHPStan\ShouldNotHappenException; use function array_reduce; use function count; use function is_array; use function sprintf; final class ConditionalTagsExtension extends CompilerExtension { public function getConfigSchema() : Nette\Schema\Schema { $bool = Expect::anyOf(Expect::bool(), Expect::listOf(Expect::bool())); return Expect::arrayOf(Expect::structure([BrokerFactory::PROPERTIES_CLASS_REFLECTION_EXTENSION_TAG => $bool, BrokerFactory::METHODS_CLASS_REFLECTION_EXTENSION_TAG => $bool, BrokerFactory::DYNAMIC_METHOD_RETURN_TYPE_EXTENSION_TAG => $bool, BrokerFactory::DYNAMIC_STATIC_METHOD_RETURN_TYPE_EXTENSION_TAG => $bool, BrokerFactory::DYNAMIC_FUNCTION_RETURN_TYPE_EXTENSION_TAG => $bool, BrokerFactory::EXPRESSION_TYPE_RESOLVER_EXTENSION_TAG => $bool, BrokerFactory::OPERATOR_TYPE_SPECIFYING_EXTENSION_TAG => $bool, BrokerFactory::ALLOWED_SUB_TYPES_CLASS_REFLECTION_EXTENSION_TAG => $bool, LazyRegistry::RULE_TAG => $bool, TypeNodeResolverExtension::EXTENSION_TAG => $bool, StubFilesExtension::EXTENSION_TAG => $bool, AlwaysUsedClassConstantsExtensionProvider::EXTENSION_TAG => $bool, ReadWritePropertiesExtensionProvider::EXTENSION_TAG => $bool, TypeSpecifierFactory::FUNCTION_TYPE_SPECIFYING_EXTENSION_TAG => $bool, TypeSpecifierFactory::METHOD_TYPE_SPECIFYING_EXTENSION_TAG => $bool, TypeSpecifierFactory::STATIC_METHOD_TYPE_SPECIFYING_EXTENSION_TAG => $bool, RichParser::VISITOR_SERVICE_TAG => $bool, CollectorRegistryFactory::COLLECTOR_TAG => $bool, LazyDynamicThrowTypeExtensionProvider::FUNCTION_TAG => $bool, LazyDynamicThrowTypeExtensionProvider::METHOD_TAG => $bool, LazyDynamicThrowTypeExtensionProvider::STATIC_METHOD_TAG => $bool, LazyParameterClosureTypeExtensionProvider::FUNCTION_TAG => $bool, LazyParameterClosureTypeExtensionProvider::METHOD_TAG => $bool, LazyParameterClosureTypeExtensionProvider::STATIC_METHOD_TAG => $bool, LazyParameterOutTypeExtensionProvider::FUNCTION_TAG => $bool, LazyParameterOutTypeExtensionProvider::METHOD_TAG => $bool, LazyParameterOutTypeExtensionProvider::STATIC_METHOD_TAG => $bool, DiagnoseExtension::EXTENSION_TAG => $bool])->min(1)); } public function beforeCompile() : void { /** @var mixed[] $config */ $config = $this->config; $builder = $this->getContainerBuilder(); foreach ($config as $type => $tags) { $services = $builder->findByType($type); if (count($services) === 0) { throw new ShouldNotHappenException(sprintf('No services of type "%s" found.', $type)); } foreach ($services as $service) { foreach ($tags as $tag => $parameter) { if (is_array($parameter)) { $parameter = array_reduce($parameter, static function ($carry, $item) { return $carry && (bool) $item; }, \true); } if ((bool) $parameter) { $service->addTag($tag); continue; } } } } } } <?php declare (strict_types=1); namespace PHPStan\DependencyInjection; use function array_key_exists; final class MemoizingContainer implements \PHPStan\DependencyInjection\Container { /** * @var Container */ private $originalContainer; /** @var array<string, mixed> */ private $servicesByType = []; public function __construct(\PHPStan\DependencyInjection\Container $originalContainer) { $this->originalContainer = $originalContainer; } public function hasService(string $serviceName) : bool { return $this->originalContainer->hasService($serviceName); } public function getService(string $serviceName) { return $this->originalContainer->getService($serviceName); } public function getByType(string $className) { if (array_key_exists($className, $this->servicesByType)) { return $this->servicesByType[$className]; } $service = $this->originalContainer->getByType($className); $this->servicesByType[$className] = $service; return $service; } public function findServiceNamesByType(string $className) : array { return $this->originalContainer->findServiceNamesByType($className); } public function getServicesByTag(string $tagName) : array { return $this->originalContainer->getServicesByTag($tagName); } public function getParameters() : array { return $this->originalContainer->getParameters(); } public function hasParameter(string $parameterName) : bool { return $this->originalContainer->hasParameter($parameterName); } public function getParameter(string $parameterName) { return $this->originalContainer->getParameter($parameterName); } } <?php declare (strict_types=1); namespace PHPStan\DependencyInjection\Nette; use PHPStan\DependencyInjection\Container; use PHPStan\DependencyInjection\ParameterNotFoundException; use function array_key_exists; use function array_keys; use function array_map; /** * @internal */ final class NetteContainer implements Container { /** * @var \Nette\DI\Container */ private $container; public function __construct(\_PHPStan_7d8742a37\Nette\DI\Container $container) { $this->container = $container; } public function hasService(string $serviceName) : bool { return $this->container->hasService($serviceName); } /** * @return mixed */ public function getService(string $serviceName) { return $this->container->getService($serviceName); } /** * @template T of object * @param class-string<T> $className * @return T */ public function getByType(string $className) { return $this->container->getByType($className); } /** * @param class-string $className * @return string[] */ public function findServiceNamesByType(string $className) : array { return $this->container->findByType($className); } /** * @return mixed[] */ public function getServicesByTag(string $tagName) : array { return $this->tagsToServices($this->container->findByTag($tagName)); } /** * @return mixed[] */ public function getParameters() : array { return $this->container->getParameters(); } public function hasParameter(string $parameterName) : bool { return array_key_exists($parameterName, $this->container->getParameters()); } /** * @return mixed */ public function getParameter(string $parameterName) { if (!$this->hasParameter($parameterName)) { throw new ParameterNotFoundException($parameterName); } return $this->container->getParameter($parameterName); } /** * @param mixed[] $tags * @return mixed[] */ private function tagsToServices(array $tags) : array { return array_map(function (string $serviceName) { return $this->getService($serviceName); }, array_keys($tags)); } } <?php declare (strict_types=1); namespace PHPStan\DependencyInjection; use _PHPStan_7d8742a37\Nette\DI\CompilerExtension; use _PHPStan_7d8742a37\Nette\Schema\Expect; use _PHPStan_7d8742a37\Nette\Schema\Schema; use PHPStan\Rules\LazyRegistry; final class RulesExtension extends CompilerExtension { public function getConfigSchema() : Schema { return Expect::listOf('string'); } public function loadConfiguration() : void { /** @var mixed[] $config */ $config = $this->config; $builder = $this->getContainerBuilder(); foreach ($config as $key => $rule) { $builder->addDefinition($this->prefix((string) $key))->setFactory($rule)->setAutowired($rule)->addTag(LazyRegistry::RULE_TAG); } } } <?php declare (strict_types=1); namespace PHPStan\DependencyInjection; use Exception; use function implode; final class InvalidIgnoredErrorPatternsException extends Exception { /** * @var string[] */ private $errors; /** * @param string[] $errors */ public function __construct(array $errors) { $this->errors = $errors; parent::__construct(implode("\n", $this->errors)); } /** * @return string[] */ public function getErrors() : array { return $this->errors; } } <?php declare (strict_types=1); namespace PHPStan\DependencyInjection\Type; use PHPStan\Type\DynamicFunctionThrowTypeExtension; use PHPStan\Type\DynamicMethodThrowTypeExtension; use PHPStan\Type\DynamicStaticMethodThrowTypeExtension; interface DynamicThrowTypeExtensionProvider { /** @return DynamicFunctionThrowTypeExtension[] */ public function getDynamicFunctionThrowTypeExtensions() : array; /** @return DynamicMethodThrowTypeExtension[] */ public function getDynamicMethodThrowTypeExtensions() : array; /** @return DynamicStaticMethodThrowTypeExtension[] */ public function getDynamicStaticMethodThrowTypeExtensions() : array; } <?php declare (strict_types=1); namespace PHPStan\DependencyInjection\Type; use PHPStan\Broker\Broker; use PHPStan\Broker\BrokerFactory; use PHPStan\DependencyInjection\Container; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Type\DynamicReturnTypeExtensionRegistry; final class LazyDynamicReturnTypeExtensionRegistryProvider implements \PHPStan\DependencyInjection\Type\DynamicReturnTypeExtensionRegistryProvider { /** * @var Container */ private $container; /** * @var ?DynamicReturnTypeExtensionRegistry */ private $registry = null; public function __construct(Container $container) { $this->container = $container; } public function getRegistry() : DynamicReturnTypeExtensionRegistry { if ($this->registry === null) { $this->registry = new DynamicReturnTypeExtensionRegistry($this->container->getByType(Broker::class), $this->container->getByType(ReflectionProvider::class), $this->container->getServicesByTag(BrokerFactory::DYNAMIC_METHOD_RETURN_TYPE_EXTENSION_TAG), $this->container->getServicesByTag(BrokerFactory::DYNAMIC_STATIC_METHOD_RETURN_TYPE_EXTENSION_TAG), $this->container->getServicesByTag(BrokerFactory::DYNAMIC_FUNCTION_RETURN_TYPE_EXTENSION_TAG)); } return $this->registry; } } <?php declare (strict_types=1); namespace PHPStan\DependencyInjection\Type; use PHPStan\Type\OperatorTypeSpecifyingExtensionRegistry; interface OperatorTypeSpecifyingExtensionRegistryProvider { public function getRegistry() : OperatorTypeSpecifyingExtensionRegistry; } <?php declare (strict_types=1); namespace PHPStan\DependencyInjection\Type; use PHPStan\DependencyInjection\Container; final class LazyParameterOutTypeExtensionProvider implements \PHPStan\DependencyInjection\Type\ParameterOutTypeExtensionProvider { /** * @var Container */ private $container; public const FUNCTION_TAG = 'phpstan.functionParameterOutTypeExtension'; public const METHOD_TAG = 'phpstan.methodParameterOutTypeExtension'; public const STATIC_METHOD_TAG = 'phpstan.staticMethodParameterOutTypeExtension'; public function __construct(Container $container) { $this->container = $container; } public function getFunctionParameterOutTypeExtensions() : array { return $this->container->getServicesByTag(self::FUNCTION_TAG); } public function getMethodParameterOutTypeExtensions() : array { return $this->container->getServicesByTag(self::METHOD_TAG); } public function getStaticMethodParameterOutTypeExtensions() : array { return $this->container->getServicesByTag(self::STATIC_METHOD_TAG); } } <?php declare (strict_types=1); namespace PHPStan\DependencyInjection\Type; use PHPStan\DependencyInjection\Container; final class LazyDynamicThrowTypeExtensionProvider implements \PHPStan\DependencyInjection\Type\DynamicThrowTypeExtensionProvider { /** * @var Container */ private $container; public const FUNCTION_TAG = 'phpstan.dynamicFunctionThrowTypeExtension'; public const METHOD_TAG = 'phpstan.dynamicMethodThrowTypeExtension'; public const STATIC_METHOD_TAG = 'phpstan.dynamicStaticMethodThrowTypeExtension'; public function __construct(Container $container) { $this->container = $container; } public function getDynamicFunctionThrowTypeExtensions() : array { return $this->container->getServicesByTag(self::FUNCTION_TAG); } public function getDynamicMethodThrowTypeExtensions() : array { return $this->container->getServicesByTag(self::METHOD_TAG); } public function getDynamicStaticMethodThrowTypeExtensions() : array { return $this->container->getServicesByTag(self::STATIC_METHOD_TAG); } } <?php declare (strict_types=1); namespace PHPStan\DependencyInjection\Type; use PHPStan\Type\FunctionParameterClosureTypeExtension; use PHPStan\Type\MethodParameterClosureTypeExtension; use PHPStan\Type\StaticMethodParameterClosureTypeExtension; interface ParameterClosureTypeExtensionProvider { /** @return FunctionParameterClosureTypeExtension[] */ public function getFunctionParameterClosureTypeExtensions() : array; /** @return MethodParameterClosureTypeExtension[] */ public function getMethodParameterClosureTypeExtensions() : array; /** @return StaticMethodParameterClosureTypeExtension[] */ public function getStaticMethodParameterClosureTypeExtensions() : array; } <?php declare (strict_types=1); namespace PHPStan\DependencyInjection\Type; use PHPStan\Type\DynamicReturnTypeExtensionRegistry; interface DynamicReturnTypeExtensionRegistryProvider { public function getRegistry() : DynamicReturnTypeExtensionRegistry; } <?php declare (strict_types=1); namespace PHPStan\DependencyInjection\Type; use PHPStan\Broker\BrokerFactory; use PHPStan\DependencyInjection\Container; use PHPStan\Type\ExpressionTypeResolverExtensionRegistry; final class LazyExpressionTypeResolverExtensionRegistryProvider implements \PHPStan\DependencyInjection\Type\ExpressionTypeResolverExtensionRegistryProvider { /** * @var Container */ private $container; /** * @var ?ExpressionTypeResolverExtensionRegistry */ private $registry = null; public function __construct(Container $container) { $this->container = $container; } public function getRegistry() : ExpressionTypeResolverExtensionRegistry { if ($this->registry === null) { $this->registry = new ExpressionTypeResolverExtensionRegistry($this->container->getServicesByTag(BrokerFactory::EXPRESSION_TYPE_RESOLVER_EXTENSION_TAG)); } return $this->registry; } } <?php declare (strict_types=1); namespace PHPStan\DependencyInjection\Type; use PHPStan\Broker\Broker; use PHPStan\Broker\BrokerFactory; use PHPStan\DependencyInjection\Container; use PHPStan\Type\OperatorTypeSpecifyingExtensionRegistry; final class LazyOperatorTypeSpecifyingExtensionRegistryProvider implements \PHPStan\DependencyInjection\Type\OperatorTypeSpecifyingExtensionRegistryProvider { /** * @var Container */ private $container; /** * @var ?OperatorTypeSpecifyingExtensionRegistry */ private $registry = null; public function __construct(Container $container) { $this->container = $container; } public function getRegistry() : OperatorTypeSpecifyingExtensionRegistry { if ($this->registry === null) { $this->registry = new OperatorTypeSpecifyingExtensionRegistry($this->container->getByType(Broker::class), $this->container->getServicesByTag(BrokerFactory::OPERATOR_TYPE_SPECIFYING_EXTENSION_TAG)); } return $this->registry; } } <?php declare (strict_types=1); namespace PHPStan\DependencyInjection\Type; use PHPStan\DependencyInjection\Container; final class LazyParameterClosureTypeExtensionProvider implements \PHPStan\DependencyInjection\Type\ParameterClosureTypeExtensionProvider { /** * @var Container */ private $container; public const FUNCTION_TAG = 'phpstan.functionParameterClosureTypeExtension'; public const METHOD_TAG = 'phpstan.methodParameterClosureTypeExtension'; public const STATIC_METHOD_TAG = 'phpstan.staticMethodParameterClosureTypeExtension'; public function __construct(Container $container) { $this->container = $container; } public function getFunctionParameterClosureTypeExtensions() : array { return $this->container->getServicesByTag(self::FUNCTION_TAG); } public function getMethodParameterClosureTypeExtensions() : array { return $this->container->getServicesByTag(self::METHOD_TAG); } public function getStaticMethodParameterClosureTypeExtensions() : array { return $this->container->getServicesByTag(self::STATIC_METHOD_TAG); } } <?php declare (strict_types=1); namespace PHPStan\DependencyInjection\Type; use PHPStan\Type\ExpressionTypeResolverExtensionRegistry; interface ExpressionTypeResolverExtensionRegistryProvider { public function getRegistry() : ExpressionTypeResolverExtensionRegistry; } <?php declare (strict_types=1); namespace PHPStan\DependencyInjection\Type; use PHPStan\Type\FunctionParameterOutTypeExtension; use PHPStan\Type\MethodParameterOutTypeExtension; use PHPStan\Type\StaticMethodParameterOutTypeExtension; interface ParameterOutTypeExtensionProvider { /** @return FunctionParameterOutTypeExtension[] */ public function getFunctionParameterOutTypeExtensions() : array; /** @return MethodParameterOutTypeExtension[] */ public function getMethodParameterOutTypeExtensions() : array; /** @return StaticMethodParameterOutTypeExtension[] */ public function getStaticMethodParameterOutTypeExtensions() : array; } <?php declare (strict_types=1); namespace PHPStan\DependencyInjection; use _PHPStan_7d8742a37\Nette\DI\CompilerExtension; use _PHPStan_7d8742a37\Nette\DI\Definitions\Statement; use _PHPStan_7d8742a37\Nette\Schema\Expect; use _PHPStan_7d8742a37\Nette\Schema\Schema; final class ParametersSchemaExtension extends CompilerExtension { public function getConfigSchema() : Schema { return Expect::arrayOf(Expect::type(Statement::class))->min(1); } } <?php declare (strict_types=1); namespace PHPStan\DependencyInjection; use _PHPStan_7d8742a37\Nette\DI\Config\Loader; use _PHPStan_7d8742a37\Nette\DI\Container as OriginalNetteContainer; use _PHPStan_7d8742a37\Nette\DI\ContainerLoader; use PHPStan\File\CouldNotReadFileException; use function array_keys; use function error_reporting; use function restore_error_handler; use function set_error_handler; use function sha1_file; use const E_USER_DEPRECATED; use const PHP_RELEASE_VERSION; use const PHP_VERSION_ID; final class Configurator extends \_PHPStan_7d8742a37\Nette\Bootstrap\Configurator { /** * @var LoaderFactory */ private $loaderFactory; /** @var string[] */ private $allConfigFiles = []; public function __construct(\PHPStan\DependencyInjection\LoaderFactory $loaderFactory) { $this->loaderFactory = $loaderFactory; parent::__construct(); } protected function createLoader() : Loader { return $this->loaderFactory->createLoader(); } /** * @param string[] $allConfigFiles */ public function setAllConfigFiles(array $allConfigFiles) : void { $this->allConfigFiles = $allConfigFiles; } /** * @return mixed[] */ protected function getDefaultParameters() : array { return []; } public function getContainerCacheDirectory() : string { return $this->getCacheDirectory() . '/nette.configurator'; } public function loadContainer() : string { $loader = new ContainerLoader($this->getContainerCacheDirectory(), $this->staticParameters['debugMode']); return $loader->load([$this, 'generateContainer'], [$this->staticParameters, array_keys($this->dynamicParameters), $this->configs, PHP_VERSION_ID - PHP_RELEASE_VERSION, \PHPStan\DependencyInjection\NeonAdapter::CACHE_KEY, $this->getAllConfigFilesHashes()]); } public function createContainer(bool $initialize = \true) : OriginalNetteContainer { set_error_handler(static function (int $errno) : bool { if ((error_reporting() & $errno) === 0) { // silence @ operator return \true; } return $errno === E_USER_DEPRECATED; }); try { $container = parent::createContainer($initialize); } finally { restore_error_handler(); } return $container; } /** * @return string[] */ private function getAllConfigFilesHashes() : array { $hashes = []; foreach ($this->allConfigFiles as $file) { $hash = sha1_file($file); if ($hash === \false) { throw new CouldNotReadFileException($file); } $hashes[$file] = $hash; } return $hashes; } } <?php declare (strict_types=1); namespace PHPStan\DependencyInjection; use _PHPStan_7d8742a37\Nette\DI\Config\Loader; use PHPStan\File\FileHelper; final class NeonLoader extends Loader { /** * @var FileHelper */ private $fileHelper; /** * @var ?string */ private $generateBaselineFile; public function __construct(FileHelper $fileHelper, ?string $generateBaselineFile) { $this->fileHelper = $fileHelper; $this->generateBaselineFile = $generateBaselineFile; } /** * @return mixed[] */ public function load(string $file, ?bool $merge = \true) : array { if ($this->generateBaselineFile === null) { return parent::load($file, $merge); } $normalizedFile = $this->fileHelper->normalizePath($file); if ($this->generateBaselineFile === $normalizedFile) { return []; } return parent::load($file, $merge); } } <?php declare (strict_types=1); namespace PHPStan\DependencyInjection; use _PHPStan_7d8742a37\Nette\DI\Config\Adapter; use _PHPStan_7d8742a37\Nette\DI\Config\Helpers; use _PHPStan_7d8742a37\Nette\DI\Definitions\Reference; use _PHPStan_7d8742a37\Nette\DI\Definitions\Statement; use _PHPStan_7d8742a37\Nette\DI\InvalidConfigurationException; use _PHPStan_7d8742a37\Nette\Neon\Entity; use _PHPStan_7d8742a37\Nette\Neon\Exception; use _PHPStan_7d8742a37\Nette\Neon\Neon; use PHPStan\DependencyInjection\Neon\OptionalPath; use PHPStan\File\FileHelper; use PHPStan\File\FileReader; use function array_values; use function array_walk_recursive; use function count; use function dirname; use function implode; use function in_array; use function is_array; use function is_int; use function is_string; use function ltrim; use function sprintf; use function str_contains; use function str_starts_with; use function substr; final class NeonAdapter implements Adapter { public const CACHE_KEY = 'v28-ignore-errors'; private const PREVENT_MERGING_SUFFIX = '!'; /** @var FileHelper[] */ private $fileHelpers = []; /** * @return mixed[] */ public function load(string $file) : array { $contents = FileReader::read($file); try { return $this->process((array) Neon::decode($contents), '', $file); } catch (Exception $e) { throw new Exception(sprintf('Error while loading %s: %s', $file, $e->getMessage())); } } /** * @param mixed[] $arr * @return mixed[] */ public function process(array $arr, string $fileKey, string $file) : array { $res = []; foreach ($arr as $key => $val) { if (is_string($key) && substr($key, -1) === self::PREVENT_MERGING_SUFFIX) { if (!is_array($val) && $val !== null) { throw new InvalidConfigurationException(sprintf('Replacing operator is available only for arrays, item \'%s\' is not array.', $key)); } $key = substr($key, 0, -1); $val[Helpers::PREVENT_MERGING] = \true; } $keyToResolve = $fileKey; if (is_int($key)) { $keyToResolve .= '[]'; } else { $keyToResolve .= '[' . $key . ']'; } if (is_array($val)) { if (!is_int($key)) { $fileKeyToPass = $fileKey . '[' . $key . ']'; } else { $fileKeyToPass = $fileKey . '[]'; } $val = $this->process($val, $fileKeyToPass, $file); } elseif ($val instanceof Entity) { if (!is_int($key)) { $fileKeyToPass = $fileKey . '(' . $key . ')'; } else { $fileKeyToPass = $fileKey . '()'; } if ($val->value === Neon::CHAIN) { $tmp = null; foreach ($this->process($val->attributes, $fileKeyToPass, $file) as $st) { $tmp = new Statement($tmp === null ? $st->getEntity() : [$tmp, ltrim(implode('::', (array) $st->getEntity()), ':')], $st->arguments); } $val = $tmp; } else { if (in_array($keyToResolve, ['[parameters][excludePaths][]', '[parameters][excludePaths][analyse][]', '[parameters][excludePaths][analyseAndScan][]'], \true) && count($val->attributes) === 1 && $val->attributes[0] === '?' && is_string($val->value) && !str_contains($val->value, '%') && !str_starts_with($val->value, '*')) { $fileHelper = $this->createFileHelperByFile($file); $val = new OptionalPath($fileHelper->normalizePath($fileHelper->absolutizePath($val->value))); } else { $tmp = $this->process([$val->value], $fileKeyToPass, $file); $val = new Statement($tmp[0], $this->process($val->attributes, $fileKeyToPass, $file)); } } } if (in_array($keyToResolve, ['[parameters][paths][]', '[parameters][excludes_analyse][]', '[parameters][excludePaths][]', '[parameters][excludePaths][analyse][]', '[parameters][excludePaths][analyseAndScan][]', '[parameters][ignoreErrors][][paths][]', '[parameters][ignoreErrors][][path]', '[parameters][bootstrapFiles][]', '[parameters][scanFiles][]', '[parameters][scanDirectories][]', '[parameters][tmpDir]', '[parameters][pro][tmpDir]', '[parameters][memoryLimitFile]', '[parameters][benchmarkFile]', '[parameters][stubFiles][]', '[parameters][symfony][console_application_loader]', '[parameters][symfony][consoleApplicationLoader]', '[parameters][symfony][container_xml_path]', '[parameters][symfony][containerXmlPath]', '[parameters][doctrine][objectManagerLoader]'], \true) && is_string($val) && !str_contains($val, '%') && !str_starts_with($val, '*')) { $fileHelper = $this->createFileHelperByFile($file); $val = $fileHelper->normalizePath($fileHelper->absolutizePath($val)); } if ($keyToResolve === '[parameters][excludePaths]' && $val !== null && array_values($val) === $val) { $val = ['analyseAndScan' => $val, 'analyse' => []]; } $res[$key] = $val; } return $res; } /** * @param mixed[] $data */ public function dump(array $data) : string { array_walk_recursive($data, static function (&$val) : void { if (!$val instanceof Statement) { return; } $val = self::statementToEntity($val); }); return "# generated by Nette\n\n" . Neon::encode($data, Neon::BLOCK); } private static function statementToEntity(Statement $val) : Entity { array_walk_recursive($val->arguments, static function (&$val) : void { if ($val instanceof Statement) { $val = self::statementToEntity($val); } elseif ($val instanceof Reference) { $val = '@' . $val->getValue(); } }); $entity = $val->getEntity(); if ($entity instanceof Reference) { $entity = '@' . $entity->getValue(); } elseif (is_array($entity)) { if ($entity[0] instanceof Statement) { return new Entity(Neon::CHAIN, [self::statementToEntity($entity[0]), new Entity('::' . $entity[1], $val->arguments)]); } elseif ($entity[0] instanceof Reference) { $entity = '@' . $entity[0]->getValue() . '::' . $entity[1]; } elseif (is_string($entity[0])) { $entity = $entity[0] . '::' . $entity[1]; } } return new Entity($entity, $val->arguments); } private function createFileHelperByFile(string $file) : FileHelper { $dir = dirname($file); if (!isset($this->fileHelpers[$dir])) { $this->fileHelpers[$dir] = new FileHelper($dir); } return $this->fileHelpers[$dir]; } } <?php declare (strict_types=1); namespace PHPStan\DependencyInjection; use Hoa\Compiler\Llk\Llk; use Hoa\File\Read; use _PHPStan_7d8742a37\Nette\DI\CompilerExtension; use _PHPStan_7d8742a37\Nette\Utils\RegexpException; use _PHPStan_7d8742a37\Nette\Utils\Strings; use PHPStan\Analyser\ConstantResolver; use PHPStan\Analyser\NameScope; use PHPStan\Command\IgnoredRegexValidator; use PHPStan\DependencyInjection\Type\OperatorTypeSpecifyingExtensionRegistryProvider; use PHPStan\File\FileExcluder; use PHPStan\Php\PhpVersion; use PHPStan\PhpDoc\DirectTypeNodeResolverExtensionRegistryProvider; use PHPStan\PhpDoc\TypeNodeResolver; use PHPStan\PhpDoc\TypeNodeResolverExtensionRegistry; use PHPStan\PhpDoc\TypeStringResolver; use PHPStan\PhpDocParser\Lexer\Lexer; use PHPStan\PhpDocParser\Parser\ConstExprParser; use PHPStan\PhpDocParser\Parser\TypeParser; use PHPStan\Reflection\InitializerExprTypeResolver; use PHPStan\Reflection\PhpVersionStaticAccessor; use PHPStan\Reflection\ReflectionProvider\DirectReflectionProviderProvider; use PHPStan\Reflection\ReflectionProvider\DummyReflectionProvider; use PHPStan\Reflection\ReflectionProviderStaticAccessor; use PHPStan\Type\Constant\OversizedArrayBuilder; use PHPStan\Type\DirectTypeAliasResolverProvider; use PHPStan\Type\OperatorTypeSpecifyingExtensionRegistry; use PHPStan\Type\Type; use PHPStan\Type\TypeAliasResolver; use function array_keys; use function array_map; use function count; use function implode; use function is_array; use function is_dir; use function is_file; use function sprintf; use const PHP_VERSION_ID; final class ValidateIgnoredErrorsExtension extends CompilerExtension { /** * @throws InvalidIgnoredErrorPatternsException */ public function loadConfiguration() : void { $builder = $this->getContainerBuilder(); if (!$builder->parameters['__validate']) { return; } $ignoreErrors = $builder->parameters['ignoreErrors']; if (count($ignoreErrors) === 0) { return; } $noImplicitWildcard = $builder->parameters['featureToggles']['noImplicitWildcard']; /** @throws void */ $parser = Llk::load(new Read(__DIR__ . '/../../resources/RegexGrammar.pp')); $reflectionProvider = new DummyReflectionProvider(); $reflectionProviderProvider = new DirectReflectionProviderProvider($reflectionProvider); ReflectionProviderStaticAccessor::registerInstance($reflectionProvider); PhpVersionStaticAccessor::registerInstance(new PhpVersion(PHP_VERSION_ID)); $constantResolver = new ConstantResolver($reflectionProviderProvider, []); $ignoredRegexValidator = new IgnoredRegexValidator($parser, new TypeStringResolver(new Lexer(), new TypeParser(new ConstExprParser($builder->parameters['featureToggles']['unescapeStrings'])), new TypeNodeResolver(new DirectTypeNodeResolverExtensionRegistryProvider(new class implements TypeNodeResolverExtensionRegistry { public function getExtensions() : array { return []; } }), $reflectionProviderProvider, new DirectTypeAliasResolverProvider(new class implements TypeAliasResolver { public function hasTypeAlias(string $aliasName, ?string $classNameScope) : bool { return \false; } public function resolveTypeAlias(string $aliasName, NameScope $nameScope) : ?Type { return null; } }), $constantResolver, new InitializerExprTypeResolver($constantResolver, $reflectionProviderProvider, new PhpVersion(PHP_VERSION_ID), new class implements OperatorTypeSpecifyingExtensionRegistryProvider { public function getRegistry() : OperatorTypeSpecifyingExtensionRegistry { return new OperatorTypeSpecifyingExtensionRegistry(null, []); } }, new OversizedArrayBuilder())))); $errors = []; foreach ($ignoreErrors as $ignoreError) { if (is_array($ignoreError)) { if (isset($ignoreError['count'])) { continue; // ignoreError coming from baseline will be correct } if (isset($ignoreError['messages'])) { $ignoreMessages = $ignoreError['messages']; } elseif (isset($ignoreError['message'])) { $ignoreMessages = [$ignoreError['message']]; } else { continue; } } else { $ignoreMessages = [$ignoreError]; } foreach ($ignoreMessages as $ignoreMessage) { $error = $this->validateMessage($ignoredRegexValidator, $ignoreMessage); if ($error === null) { continue; } $errors[] = $error; } } $reportUnmatched = (bool) $builder->parameters['reportUnmatchedIgnoredErrors']; if ($noImplicitWildcard && $reportUnmatched) { foreach ($ignoreErrors as $ignoreError) { if (!is_array($ignoreError)) { continue; } if (isset($ignoreError['path'])) { $ignorePaths = [$ignoreError['path']]; } elseif (isset($ignoreError['paths'])) { $ignorePaths = $ignoreError['paths']; } else { continue; } foreach ($ignorePaths as $ignorePath) { if (FileExcluder::isAbsolutePath($ignorePath)) { if (is_dir($ignorePath)) { continue; } if (is_file($ignorePath)) { continue; } } if (FileExcluder::isFnmatchPattern($ignorePath)) { continue; } $errors[] = sprintf('Path %s is neither a directory, nor a file path, nor a fnmatch pattern.', $ignorePath); } } } if (count($errors) === 0) { return; } throw new \PHPStan\DependencyInjection\InvalidIgnoredErrorPatternsException($errors); } private function validateMessage(IgnoredRegexValidator $ignoredRegexValidator, string $ignoreMessage) : ?string { try { Strings::match('', $ignoreMessage); $validationResult = $ignoredRegexValidator->validate($ignoreMessage); $ignoredTypes = $validationResult->getIgnoredTypes(); if (count($ignoredTypes) > 0) { return $this->createIgnoredTypesError($ignoreMessage, $ignoredTypes); } if ($validationResult->hasAnchorsInTheMiddle()) { return $this->createAnchorInTheMiddleError($ignoreMessage); } if ($validationResult->areAllErrorsIgnored()) { return sprintf("Ignored error %s has an unescaped '%s' which leads to ignoring all errors. Use '%s' instead.", $ignoreMessage, $validationResult->getWrongSequence(), $validationResult->getEscapedWrongSequence()); } } catch (RegexpException $e) { return $e->getMessage(); } return null; } /** * @param array<string, string> $ignoredTypes */ private function createIgnoredTypesError(string $regex, array $ignoredTypes) : string { return sprintf("Ignored error %s has an unescaped '|' which leads to ignoring more errors than intended. Use '\\|' instead.\n%s", $regex, sprintf("It ignores all errors containing the following types:\n%s", implode("\n", array_map(static function (string $typeDescription) : string { return sprintf('* %s', $typeDescription); }, array_keys($ignoredTypes))))); } private function createAnchorInTheMiddleError(string $regex) : string { return sprintf("Ignored error %s has an unescaped anchor '\$' in the middle. This leads to unintended behavior. Use '\\\$' instead.", $regex); } } <?php declare (strict_types=1); namespace PHPStan\DependencyInjection\Neon; final class OptionalPath { /** * @readonly * @var string */ public $path; public function __construct(string $path) { $this->path = $path; } } <?php declare (strict_types=1); namespace PHPStan\DependencyInjection; use Exception; use function implode; use function sprintf; final class DuplicateIncludedFilesException extends Exception { /** * @var string[] */ private $files; /** * @param string[] $files */ public function __construct(array $files) { $this->files = $files; parent::__construct(sprintf('These files are included multiple times: %s', implode(', ', $this->files))); } /** * @return string[] */ public function getFiles() : array { return $this->files; } } <?php declare (strict_types=1); namespace PHPStan\DependencyInjection; use Exception; use function sprintf; final class ParameterNotFoundException extends Exception { public function __construct(string $parameterName) { parent::__construct(sprintf('Parameter %s not found in the container.', $parameterName)); } } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\TrinaryLogic; use PHPStan\Type\Traits\NonGeneralizableTypeTrait; use PHPStan\Type\Traits\NonGenericTypeTrait; use PHPStan\Type\Traits\ObjectTypeTrait; use PHPStan\Type\Traits\UndecidedComparisonTypeTrait; use function sprintf; /** @api */ class ObjectWithoutClassType implements \PHPStan\Type\SubtractableType { use ObjectTypeTrait; use NonGenericTypeTrait; use UndecidedComparisonTypeTrait; use NonGeneralizableTypeTrait; /** * @var ?Type */ private $subtractedType; /** @api */ public function __construct(?\PHPStan\Type\Type $subtractedType = null) { if ($subtractedType instanceof \PHPStan\Type\NeverType) { $subtractedType = null; } $this->subtractedType = $subtractedType; } /** * @return string[] */ public function getReferencedClasses() : array { return []; } public function getObjectClassNames() : array { return []; } public function getObjectClassReflections() : array { return []; } public function accepts(\PHPStan\Type\Type $type, bool $strictTypes) : TrinaryLogic { return $this->acceptsWithReason($type, $strictTypes)->result; } public function acceptsWithReason(\PHPStan\Type\Type $type, bool $strictTypes) : \PHPStan\Type\AcceptsResult { if ($type instanceof \PHPStan\Type\CompoundType) { return $type->isAcceptedWithReasonBy($this, $strictTypes); } return \PHPStan\Type\AcceptsResult::createFromBoolean($type instanceof self || $type instanceof \PHPStan\Type\ObjectShapeType || $type->getObjectClassNames() !== []); } public function isSuperTypeOf(\PHPStan\Type\Type $type) : TrinaryLogic { return $this->isSuperTypeOfWithReason($type)->result; } public function isSuperTypeOfWithReason(\PHPStan\Type\Type $type) : \PHPStan\Type\IsSuperTypeOfResult { if ($type instanceof \PHPStan\Type\CompoundType) { return $type->isSubTypeOfWithReason($this); } if ($type instanceof self) { if ($this->subtractedType === null) { return \PHPStan\Type\IsSuperTypeOfResult::createYes(); } if ($type->subtractedType !== null) { $isSuperType = $type->subtractedType->isSuperTypeOfWithReason($this->subtractedType); if ($isSuperType->yes()) { return $isSuperType; } } return \PHPStan\Type\IsSuperTypeOfResult::createMaybe(); } if ($type instanceof \PHPStan\Type\ObjectShapeType) { return \PHPStan\Type\IsSuperTypeOfResult::createYes(); } if ($type->getObjectClassNames() === []) { return \PHPStan\Type\IsSuperTypeOfResult::createNo(); } if ($this->subtractedType === null) { return \PHPStan\Type\IsSuperTypeOfResult::createYes(); } return $this->subtractedType->isSuperTypeOfWithReason($type)->negate(); } public function equals(\PHPStan\Type\Type $type) : bool { if (!$type instanceof self) { return \false; } if ($this->subtractedType === null) { if ($type->subtractedType === null) { return \true; } return \false; } if ($type->subtractedType === null) { return \false; } return $this->subtractedType->equals($type->subtractedType); } public function describe(\PHPStan\Type\VerbosityLevel $level) : string { return $level->handle(static function () : string { return 'object'; }, static function () : string { return 'object'; }, function () use($level) : string { $description = 'object'; if ($this->subtractedType !== null) { $description .= $this->subtractedType instanceof \PHPStan\Type\UnionType ? sprintf('~(%s)', $this->subtractedType->describe($level)) : sprintf('~%s', $this->subtractedType->describe($level)); } return $description; }); } public function isOffsetAccessLegal() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getEnumCases() : array { return []; } public function subtract(\PHPStan\Type\Type $type) : \PHPStan\Type\Type { if ($type instanceof self) { return new \PHPStan\Type\NeverType(); } if ($this->subtractedType !== null) { $type = \PHPStan\Type\TypeCombinator::union($this->subtractedType, $type); } return new self($type); } public function getTypeWithoutSubtractedType() : \PHPStan\Type\Type { return new self(); } public function changeSubtractedType(?\PHPStan\Type\Type $subtractedType) : \PHPStan\Type\Type { return new self($subtractedType); } public function getSubtractedType() : ?\PHPStan\Type\Type { return $this->subtractedType; } public function traverse(callable $cb) : \PHPStan\Type\Type { $subtractedType = $this->subtractedType !== null ? $cb($this->subtractedType) : null; if ($subtractedType !== $this->subtractedType) { return new self($subtractedType); } return $this; } public function traverseSimultaneously(\PHPStan\Type\Type $right, callable $cb) : \PHPStan\Type\Type { if ($this->subtractedType === null) { return $this; } return new self(); } public function tryRemove(\PHPStan\Type\Type $typeToRemove) : ?\PHPStan\Type\Type { if ($this->isSuperTypeOf($typeToRemove)->yes()) { return $this->subtract($typeToRemove); } return null; } public function exponentiate(\PHPStan\Type\Type $exponent) : \PHPStan\Type\Type { if (!$exponent instanceof \PHPStan\Type\NeverType && !$this->isSuperTypeOf($exponent)->no()) { return \PHPStan\Type\TypeCombinator::union($this, $exponent); } return new \PHPStan\Type\BenevolentUnionType([new \PHPStan\Type\FloatType(), new \PHPStan\Type\IntegerType()]); } public function getFiniteTypes() : array { return []; } public function toPhpDocNode() : TypeNode { return new IdentifierTypeNode('object'); } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : \PHPStan\Type\Type { return new self($properties['subtractedType'] ?? null); } } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\TrinaryLogic; use PHPStan\Type\Generic\TemplateTypeMap; use function count; /** @api */ class BenevolentUnionType extends \PHPStan\Type\UnionType { /** * @api * @param Type[] $types */ public function __construct(array $types, bool $normalized = \false) { parent::__construct($types, $normalized); } public function filterTypes(callable $filterCb) : \PHPStan\Type\Type { $result = parent::filterTypes($filterCb); if (!$result instanceof self && $result instanceof \PHPStan\Type\UnionType) { return \PHPStan\Type\TypeUtils::toBenevolentUnion($result); } return $result; } public function describe(\PHPStan\Type\VerbosityLevel $level) : string { return '(' . parent::describe($level) . ')'; } protected function unionTypes(callable $getType) : \PHPStan\Type\Type { $resultTypes = []; foreach ($this->getTypes() as $type) { $result = $getType($type); if ($result instanceof \PHPStan\Type\ErrorType) { continue; } $resultTypes[] = $result; } if (count($resultTypes) === 0) { return new \PHPStan\Type\ErrorType(); } return \PHPStan\Type\TypeUtils::toBenevolentUnion(\PHPStan\Type\TypeCombinator::union(...$resultTypes)); } protected function pickFromTypes(callable $getValues, callable $criteria) : array { $values = []; foreach ($this->getTypes() as $type) { $innerValues = $getValues($type); if ($innerValues === [] && $criteria($type)) { return []; } foreach ($innerValues as $innerType) { $values[] = $innerType; } } return $values; } public function getOffsetValueType(\PHPStan\Type\Type $offsetType) : \PHPStan\Type\Type { $types = []; foreach ($this->getTypes() as $innerType) { $valueType = $innerType->getOffsetValueType($offsetType); if ($valueType instanceof \PHPStan\Type\ErrorType) { continue; } $types[] = $valueType; } if (count($types) === 0) { return new \PHPStan\Type\ErrorType(); } return \PHPStan\Type\TypeUtils::toBenevolentUnion(\PHPStan\Type\TypeCombinator::union(...$types)); } protected function unionResults(callable $getResult) : TrinaryLogic { return TrinaryLogic::createNo()->lazyOr($this->getTypes(), $getResult); } public function isAcceptedBy(\PHPStan\Type\Type $acceptingType, bool $strictTypes) : TrinaryLogic { return $this->isAcceptedWithReasonBy($acceptingType, $strictTypes)->result; } public function isAcceptedWithReasonBy(\PHPStan\Type\Type $acceptingType, bool $strictTypes) : \PHPStan\Type\AcceptsResult { $result = \PHPStan\Type\AcceptsResult::createNo(); foreach ($this->getTypes() as $innerType) { $result = $result->or($acceptingType->acceptsWithReason($innerType, $strictTypes)); } return $result; } public function inferTemplateTypes(\PHPStan\Type\Type $receivedType) : TemplateTypeMap { $types = TemplateTypeMap::createEmpty(); foreach ($this->getTypes() as $type) { $types = $types->benevolentUnion($type->inferTemplateTypes($receivedType)); } return $types; } public function inferTemplateTypesOn(\PHPStan\Type\Type $templateType) : TemplateTypeMap { $types = TemplateTypeMap::createEmpty(); foreach ($this->getTypes() as $type) { $types = $types->benevolentUnion($templateType->inferTemplateTypes($type)); } return $types; } public function traverse(callable $cb) : \PHPStan\Type\Type { $types = []; $changed = \false; foreach ($this->getTypes() as $type) { $newType = $cb($type); if ($type !== $newType) { $changed = \true; } $types[] = $newType; } if ($changed) { return \PHPStan\Type\TypeUtils::toBenevolentUnion(\PHPStan\Type\TypeCombinator::union(...$types)); } return $this; } public function traverseSimultaneously(\PHPStan\Type\Type $right, callable $cb) : \PHPStan\Type\Type { $types = []; $changed = \false; if (!$right instanceof \PHPStan\Type\UnionType) { return $this; } if (count($this->getTypes()) !== count($right->getTypes())) { return $this; } foreach ($this->getSortedTypes() as $i => $leftType) { $rightType = $right->getSortedTypes()[$i]; $newType = $cb($leftType, $rightType); if ($leftType !== $newType) { $changed = \true; } $types[] = $newType; } if ($changed) { return \PHPStan\Type\TypeUtils::toBenevolentUnion(\PHPStan\Type\TypeCombinator::union(...$types)); } return $this; } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : \PHPStan\Type\Type { return new self($properties['types']); } } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\Php\PhpVersion; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\TrinaryLogic; use PHPStan\Type\Constant\ConstantArrayType; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantFloatType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\Traits\FalseyBooleanTypeTrait; use PHPStan\Type\Traits\NonArrayTypeTrait; use PHPStan\Type\Traits\NonCallableTypeTrait; use PHPStan\Type\Traits\NonGenericTypeTrait; use PHPStan\Type\Traits\NonIterableTypeTrait; use PHPStan\Type\Traits\NonObjectTypeTrait; use PHPStan\Type\Traits\NonRemoveableTypeTrait; /** @api */ class NullType implements \PHPStan\Type\ConstantScalarType { use NonArrayTypeTrait; use NonCallableTypeTrait; use NonIterableTypeTrait; use NonObjectTypeTrait; use FalseyBooleanTypeTrait; use NonGenericTypeTrait; use NonRemoveableTypeTrait; /** @api */ public function __construct() { } /** * @return string[] */ public function getReferencedClasses() : array { return []; } public function getObjectClassNames() : array { return []; } public function getObjectClassReflections() : array { return []; } public function getConstantStrings() : array { return []; } /** * @return null */ public function getValue() { return null; } public function generalize(\PHPStan\Type\GeneralizePrecision $precision) : \PHPStan\Type\Type { return $this; } public function accepts(\PHPStan\Type\Type $type, bool $strictTypes) : TrinaryLogic { return $this->acceptsWithReason($type, $strictTypes)->result; } public function acceptsWithReason(\PHPStan\Type\Type $type, bool $strictTypes) : \PHPStan\Type\AcceptsResult { if ($type instanceof self) { return \PHPStan\Type\AcceptsResult::createYes(); } if ($type instanceof \PHPStan\Type\CompoundType) { return $type->isAcceptedWithReasonBy($this, $strictTypes); } return \PHPStan\Type\AcceptsResult::createNo(); } public function isSuperTypeOf(\PHPStan\Type\Type $type) : TrinaryLogic { return $this->isSuperTypeOfWithReason($type)->result; } public function isSuperTypeOfWithReason(\PHPStan\Type\Type $type) : \PHPStan\Type\IsSuperTypeOfResult { if ($type instanceof self) { return \PHPStan\Type\IsSuperTypeOfResult::createYes(); } if ($type instanceof \PHPStan\Type\CompoundType) { return $type->isSubTypeOfWithReason($this); } return \PHPStan\Type\IsSuperTypeOfResult::createNo(); } public function equals(\PHPStan\Type\Type $type) : bool { return $type instanceof self; } public function isSmallerThan(\PHPStan\Type\Type $otherType) : TrinaryLogic { if ($otherType instanceof \PHPStan\Type\ConstantScalarType) { return TrinaryLogic::createFromBoolean(null < $otherType->getValue()); } if ($otherType instanceof \PHPStan\Type\CompoundType) { return $otherType->isGreaterThan($this); } return TrinaryLogic::createMaybe(); } public function isSmallerThanOrEqual(\PHPStan\Type\Type $otherType) : TrinaryLogic { if ($otherType instanceof \PHPStan\Type\ConstantScalarType) { return TrinaryLogic::createFromBoolean(null <= $otherType->getValue()); } if ($otherType instanceof \PHPStan\Type\CompoundType) { return $otherType->isGreaterThanOrEqual($this); } return TrinaryLogic::createMaybe(); } public function describe(\PHPStan\Type\VerbosityLevel $level) : string { return 'null'; } public function toNumber() : \PHPStan\Type\Type { return new ConstantIntegerType(0); } public function toAbsoluteNumber() : \PHPStan\Type\Type { return $this->toNumber()->toAbsoluteNumber(); } public function toString() : \PHPStan\Type\Type { return new ConstantStringType(''); } public function toInteger() : \PHPStan\Type\Type { return $this->toNumber(); } public function toFloat() : \PHPStan\Type\Type { return $this->toNumber()->toFloat(); } public function toArray() : \PHPStan\Type\Type { return new ConstantArrayType([], []); } public function toArrayKey() : \PHPStan\Type\Type { return new ConstantStringType(''); } public function isOffsetAccessible() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isOffsetAccessLegal() : TrinaryLogic { return TrinaryLogic::createYes(); } public function hasOffsetValueType(\PHPStan\Type\Type $offsetType) : TrinaryLogic { return TrinaryLogic::createNo(); } public function getOffsetValueType(\PHPStan\Type\Type $offsetType) : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function setOffsetValueType(?\PHPStan\Type\Type $offsetType, \PHPStan\Type\Type $valueType, bool $unionValues = \true) : \PHPStan\Type\Type { $array = new ConstantArrayType([], []); return $array->setOffsetValueType($offsetType, $valueType, $unionValues); } public function setExistingOffsetValueType(\PHPStan\Type\Type $offsetType, \PHPStan\Type\Type $valueType) : \PHPStan\Type\Type { return $this; } public function unsetOffset(\PHPStan\Type\Type $offsetType) : \PHPStan\Type\Type { return $this; } public function traverse(callable $cb) : \PHPStan\Type\Type { return $this; } public function traverseSimultaneously(\PHPStan\Type\Type $right, callable $cb) : \PHPStan\Type\Type { return $this; } public function isNull() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isConstantValue() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isConstantScalarValue() : TrinaryLogic { return TrinaryLogic::createYes(); } public function getConstantScalarTypes() : array { return [$this]; } public function getConstantScalarValues() : array { return [$this->getValue()]; } public function isTrue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFalse() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isBoolean() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFloat() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isInteger() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isNumericString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isNonEmptyString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isNonFalsyString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isLiteralString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isLowercaseString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isUppercaseString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isClassStringType() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getClassStringObjectType() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function getObjectTypeOrClassStringObjectType() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function isVoid() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isScalar() : TrinaryLogic { return TrinaryLogic::createNo(); } public function looseCompare(\PHPStan\Type\Type $type, PhpVersion $phpVersion) : \PHPStan\Type\BooleanType { if ($type instanceof \PHPStan\Type\ConstantScalarType) { return \PHPStan\Type\LooseComparisonHelper::compareConstantScalars($this, $type, $phpVersion); } if ($type->isConstantArray()->yes() && $type->isIterableAtLeastOnce()->no()) { // @phpstan-ignore equal.alwaysTrue, equal.notAllowed return new ConstantBooleanType($this->getValue() == []); // phpcs:ignore } if ($type instanceof \PHPStan\Type\CompoundType) { return $type->looseCompare($this, $phpVersion); } return new \PHPStan\Type\BooleanType(); } public function getSmallerType() : \PHPStan\Type\Type { return new \PHPStan\Type\NeverType(); } public function getSmallerOrEqualType() : \PHPStan\Type\Type { // All falsey types except '0' return new \PHPStan\Type\UnionType([new \PHPStan\Type\NullType(), new ConstantBooleanType(\false), new ConstantIntegerType(0), new ConstantFloatType(0.0), new ConstantStringType(''), new ConstantArrayType([], [])]); } public function getGreaterType() : \PHPStan\Type\Type { // All truthy types, but also '0' return new \PHPStan\Type\MixedType(\false, new \PHPStan\Type\UnionType([new \PHPStan\Type\NullType(), new ConstantBooleanType(\false), new ConstantIntegerType(0), new ConstantFloatType(0.0), new ConstantStringType(''), new ConstantArrayType([], [])])); } public function getGreaterOrEqualType() : \PHPStan\Type\Type { return new \PHPStan\Type\MixedType(); } public function getFiniteTypes() : array { return [$this]; } public function exponentiate(\PHPStan\Type\Type $exponent) : \PHPStan\Type\Type { return new \PHPStan\Type\UnionType([new ConstantIntegerType(0), new ConstantIntegerType(1)]); } public function toPhpDocNode() : TypeNode { return new IdentifierTypeNode('null'); } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : \PHPStan\Type\Type { return new self(); } } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\Php\PhpVersion; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\Reflection\Callables\CallableParametersAcceptor; use PHPStan\Reflection\ClassMemberAccessAnswerer; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ConstantReflection; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\ExtendedPropertyReflection; use PHPStan\Reflection\PropertyReflection; use PHPStan\Reflection\Type\UnresolvedMethodPrototypeReflection; use PHPStan\Reflection\Type\UnresolvedPropertyPrototypeReflection; use PHPStan\TrinaryLogic; use PHPStan\Type\Constant\ConstantArrayType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\Enum\EnumCaseObjectType; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\Generic\TemplateTypeReference; use PHPStan\Type\Generic\TemplateTypeVariance; /** * @api * @see https://phpstan.org/developing-extensions/type-system */ interface Type { /** * @return string[] */ public function getReferencedClasses() : array; /** @return list<non-empty-string> */ public function getObjectClassNames() : array; /** * @return list<ClassReflection> */ public function getObjectClassReflections() : array; /** * Returns object type Foo for class-string<Foo> and 'Foo' (if Foo is a valid class). */ public function getClassStringObjectType() : \PHPStan\Type\Type; /** * Returns object type Foo for class-string<Foo>, 'Foo' (if Foo is a valid class), * and object type Foo. */ public function getObjectTypeOrClassStringObjectType() : \PHPStan\Type\Type; public function isObject() : TrinaryLogic; public function isEnum() : TrinaryLogic; /** @return list<ArrayType> */ public function getArrays() : array; /** @return list<ConstantArrayType> */ public function getConstantArrays() : array; /** @return list<ConstantStringType> */ public function getConstantStrings() : array; public function accepts(\PHPStan\Type\Type $type, bool $strictTypes) : TrinaryLogic; /** * This is like accepts() but gives reasons * why the type was not/might not be accepted in some non-intuitive scenarios. * * In PHPStan 2.0 this method will be removed and the return type of accepts() * will change to AcceptsResult. */ public function acceptsWithReason(\PHPStan\Type\Type $type, bool $strictTypes) : \PHPStan\Type\AcceptsResult; public function isSuperTypeOf(\PHPStan\Type\Type $type) : TrinaryLogic; /** * This is like isSuperTypeOf() but gives reasons * why the type was not/might not be accepted in some non-intuitive scenarios. * * In PHPStan 2.0 this method will be removed and the return type of isSuperTypeOf() * will change to IsSuperTypeOfResult. */ public function isSuperTypeOfWithReason(\PHPStan\Type\Type $type) : \PHPStan\Type\IsSuperTypeOfResult; public function equals(\PHPStan\Type\Type $type) : bool; public function describe(\PHPStan\Type\VerbosityLevel $level) : string; public function canAccessProperties() : TrinaryLogic; public function hasProperty(string $propertyName) : TrinaryLogic; /** * @return ExtendedPropertyReflection */ public function getProperty(string $propertyName, ClassMemberAccessAnswerer $scope) : PropertyReflection; public function getUnresolvedPropertyPrototype(string $propertyName, ClassMemberAccessAnswerer $scope) : UnresolvedPropertyPrototypeReflection; public function canCallMethods() : TrinaryLogic; public function hasMethod(string $methodName) : TrinaryLogic; public function getMethod(string $methodName, ClassMemberAccessAnswerer $scope) : ExtendedMethodReflection; public function getUnresolvedMethodPrototype(string $methodName, ClassMemberAccessAnswerer $scope) : UnresolvedMethodPrototypeReflection; public function canAccessConstants() : TrinaryLogic; public function hasConstant(string $constantName) : TrinaryLogic; public function getConstant(string $constantName) : ConstantReflection; public function isIterable() : TrinaryLogic; public function isIterableAtLeastOnce() : TrinaryLogic; public function getArraySize() : \PHPStan\Type\Type; public function getIterableKeyType() : \PHPStan\Type\Type; public function getFirstIterableKeyType() : \PHPStan\Type\Type; public function getLastIterableKeyType() : \PHPStan\Type\Type; public function getIterableValueType() : \PHPStan\Type\Type; public function getFirstIterableValueType() : \PHPStan\Type\Type; public function getLastIterableValueType() : \PHPStan\Type\Type; public function isArray() : TrinaryLogic; public function isConstantArray() : TrinaryLogic; public function isOversizedArray() : TrinaryLogic; public function isList() : TrinaryLogic; public function isOffsetAccessible() : TrinaryLogic; public function isOffsetAccessLegal() : TrinaryLogic; public function hasOffsetValueType(\PHPStan\Type\Type $offsetType) : TrinaryLogic; public function getOffsetValueType(\PHPStan\Type\Type $offsetType) : \PHPStan\Type\Type; public function setOffsetValueType(?\PHPStan\Type\Type $offsetType, \PHPStan\Type\Type $valueType, bool $unionValues = \true) : \PHPStan\Type\Type; public function setExistingOffsetValueType(\PHPStan\Type\Type $offsetType, \PHPStan\Type\Type $valueType) : \PHPStan\Type\Type; public function unsetOffset(\PHPStan\Type\Type $offsetType) : \PHPStan\Type\Type; public function getKeysArray() : \PHPStan\Type\Type; public function getValuesArray() : \PHPStan\Type\Type; public function chunkArray(\PHPStan\Type\Type $lengthType, TrinaryLogic $preserveKeys) : \PHPStan\Type\Type; public function fillKeysArray(\PHPStan\Type\Type $valueType) : \PHPStan\Type\Type; public function flipArray() : \PHPStan\Type\Type; public function intersectKeyArray(\PHPStan\Type\Type $otherArraysType) : \PHPStan\Type\Type; public function popArray() : \PHPStan\Type\Type; public function reverseArray(TrinaryLogic $preserveKeys) : \PHPStan\Type\Type; public function searchArray(\PHPStan\Type\Type $needleType) : \PHPStan\Type\Type; public function shiftArray() : \PHPStan\Type\Type; public function shuffleArray() : \PHPStan\Type\Type; public function sliceArray(\PHPStan\Type\Type $offsetType, \PHPStan\Type\Type $lengthType, TrinaryLogic $preserveKeys) : \PHPStan\Type\Type; /** * @return list<EnumCaseObjectType> */ public function getEnumCases() : array; /** * Returns a list of finite values. * * Examples: * * - for bool: [true, false] * - for int<0, 3>: [0, 1, 2, 3] * - for enums: list of enum cases * - for scalars: the scalar itself * * For infinite types it returns an empty array. * * @return list<Type> */ public function getFiniteTypes() : array; public function exponentiate(\PHPStan\Type\Type $exponent) : \PHPStan\Type\Type; public function isCallable() : TrinaryLogic; /** * @return CallableParametersAcceptor[] */ public function getCallableParametersAcceptors(ClassMemberAccessAnswerer $scope) : array; public function isCloneable() : TrinaryLogic; public function toBoolean() : \PHPStan\Type\BooleanType; public function toNumber() : \PHPStan\Type\Type; public function toInteger() : \PHPStan\Type\Type; public function toFloat() : \PHPStan\Type\Type; public function toString() : \PHPStan\Type\Type; public function toArray() : \PHPStan\Type\Type; public function toArrayKey() : \PHPStan\Type\Type; public function isSmallerThan(\PHPStan\Type\Type $otherType) : TrinaryLogic; public function isSmallerThanOrEqual(\PHPStan\Type\Type $otherType) : TrinaryLogic; /** * Is Type of a known constant value? Includes literal strings, integers, floats, true, false, null, and array shapes. */ public function isConstantValue() : TrinaryLogic; /** * Is Type of a known constant scalar value? Includes literal strings, integers, floats, true, false, and null. */ public function isConstantScalarValue() : TrinaryLogic; /** * @return list<ConstantScalarType> */ public function getConstantScalarTypes() : array; /** * @return list<int|float|string|bool|null> */ public function getConstantScalarValues() : array; public function isNull() : TrinaryLogic; public function isTrue() : TrinaryLogic; public function isFalse() : TrinaryLogic; public function isBoolean() : TrinaryLogic; public function isFloat() : TrinaryLogic; public function isInteger() : TrinaryLogic; public function isString() : TrinaryLogic; public function isNumericString() : TrinaryLogic; public function isNonEmptyString() : TrinaryLogic; public function isNonFalsyString() : TrinaryLogic; public function isLiteralString() : TrinaryLogic; public function isLowercaseString() : TrinaryLogic; public function isUppercaseString() : TrinaryLogic; public function isClassStringType() : TrinaryLogic; public function isVoid() : TrinaryLogic; public function isScalar() : TrinaryLogic; public function looseCompare(\PHPStan\Type\Type $type, PhpVersion $phpVersion) : \PHPStan\Type\BooleanType; public function getSmallerType() : \PHPStan\Type\Type; public function getSmallerOrEqualType() : \PHPStan\Type\Type; public function getGreaterType() : \PHPStan\Type\Type; public function getGreaterOrEqualType() : \PHPStan\Type\Type; /** * Returns actual template type for a given object. * * Example: * * @-template T * class Foo {} * * // $fooType is Foo<int> * $t = $fooType->getTemplateType(Foo::class, 'T'); * $t->isInteger(); // yes * * Returns ErrorType in case of a missing type. * * @param class-string $ancestorClassName */ public function getTemplateType(string $ancestorClassName, string $templateTypeName) : \PHPStan\Type\Type; /** * Infers template types * * Infers the real Type of the TemplateTypes found in $this, based on * the received Type. */ public function inferTemplateTypes(\PHPStan\Type\Type $receivedType) : TemplateTypeMap; /** * Returns the template types referenced by this Type, recursively * * The return value is a list of TemplateTypeReferences, who contain the * referenced template type as well as the variance position in which it was * found. * * For example, calling this on array<Foo<T>,Bar> (with T a template type) * will return one TemplateTypeReference for the type T. * * @param TemplateTypeVariance $positionVariance The variance position in * which the receiver type was * found. * * @return TemplateTypeReference[] */ public function getReferencedTemplateTypes(TemplateTypeVariance $positionVariance) : array; public function toAbsoluteNumber() : \PHPStan\Type\Type; /** * Traverses inner types * * Returns a new instance with all inner types mapped through $cb. Might * return the same instance if inner types did not change. * * @param callable(Type):Type $cb */ public function traverse(callable $cb) : \PHPStan\Type\Type; /** * Traverses inner types while keeping the same context in another type. * * @param callable(Type $left, Type $right): Type $cb */ public function traverseSimultaneously(\PHPStan\Type\Type $right, callable $cb) : \PHPStan\Type\Type; public function toPhpDocNode() : TypeNode; /** * Return the difference with another type, or null if it cannot be represented. * * @see TypeCombinator::remove() */ public function tryRemove(\PHPStan\Type\Type $typeToRemove) : ?\PHPStan\Type\Type; public function generalize(\PHPStan\Type\GeneralizePrecision $precision) : \PHPStan\Type\Type; /** * @param mixed[] $properties */ public static function __set_state(array $properties) : self; } <?php declare (strict_types=1); namespace PHPStan\Type\Generic; use PHPStan\Type\NeverType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\TypeTraverser; use PHPStan\Type\TypeUtils; use function array_key_exists; use function count; /** * @api * @final */ class TemplateTypeMap { /** * @var array<string, Type> */ private $types; /** * @var array<string, Type> */ private $lowerBoundTypes; /** * @var ?TemplateTypeMap */ private static $empty = null; /** * @var ?TemplateTypeMap */ private $resolvedToBounds = null; /** * @api * @param array<string, Type> $types * @param array<string, Type> $lowerBoundTypes */ public function __construct(array $types, array $lowerBoundTypes = []) { $this->types = $types; $this->lowerBoundTypes = $lowerBoundTypes; } public function convertToLowerBoundTypes() : self { $lowerBoundTypes = $this->types; foreach ($this->lowerBoundTypes as $name => $type) { if (isset($lowerBoundTypes[$name])) { $intersection = TypeCombinator::intersect($lowerBoundTypes[$name], $type); if ($intersection instanceof NeverType) { continue; } $lowerBoundTypes[$name] = $intersection; } else { $lowerBoundTypes[$name] = $type; } } return new self([], $lowerBoundTypes); } public static function createEmpty() : self { $empty = self::$empty; if ($empty !== null) { return $empty; } $empty = new self([], []); self::$empty = $empty; return $empty; } public function isEmpty() : bool { return $this->count() === 0; } public function count() : int { return count($this->types + $this->lowerBoundTypes); } /** @return array<string, Type> */ public function getTypes() : array { $types = $this->types; foreach ($this->lowerBoundTypes as $name => $type) { if (array_key_exists($name, $types)) { continue; } $types[$name] = $type; } return $types; } public function hasType(string $name) : bool { return array_key_exists($name, $this->getTypes()); } public function getType(string $name) : ?Type { return $this->getTypes()[$name] ?? null; } public function unsetType(string $name) : self { if (!$this->hasType($name)) { return $this; } $types = $this->types; $lowerBoundTypes = $this->lowerBoundTypes; unset($types[$name]); unset($lowerBoundTypes[$name]); if (count($types) === 0 && count($lowerBoundTypes) === 0) { return self::createEmpty(); } return new self($types, $lowerBoundTypes); } public function union(self $other) : self { $result = $this->types; foreach ($other->types as $name => $type) { if (isset($result[$name])) { $result[$name] = TypeCombinator::union($result[$name], $type); } else { $result[$name] = $type; } } $resultLowerBoundTypes = $this->lowerBoundTypes; foreach ($other->lowerBoundTypes as $name => $type) { if (isset($resultLowerBoundTypes[$name])) { $intersection = TypeCombinator::intersect($resultLowerBoundTypes[$name], $type); if ($intersection instanceof NeverType) { continue; } $resultLowerBoundTypes[$name] = $intersection; } else { $resultLowerBoundTypes[$name] = $type; } } return new self($result, $resultLowerBoundTypes); } public function benevolentUnion(self $other) : self { $result = $this->types; foreach ($other->types as $name => $type) { if (isset($result[$name])) { $result[$name] = TypeUtils::toBenevolentUnion(TypeCombinator::union($result[$name], $type)); } else { $result[$name] = $type; } } $resultLowerBoundTypes = $this->lowerBoundTypes; foreach ($other->lowerBoundTypes as $name => $type) { if (isset($resultLowerBoundTypes[$name])) { $intersection = TypeCombinator::intersect($resultLowerBoundTypes[$name], $type); if ($intersection instanceof NeverType) { continue; } $resultLowerBoundTypes[$name] = $intersection; } else { $resultLowerBoundTypes[$name] = $type; } } return new self($result, $resultLowerBoundTypes); } public function intersect(self $other) : self { $result = $this->types; foreach ($other->types as $name => $type) { if (isset($result[$name])) { $result[$name] = TypeCombinator::intersect($result[$name], $type); } else { $result[$name] = $type; } } $resultLowerBoundTypes = $this->lowerBoundTypes; foreach ($other->lowerBoundTypes as $name => $type) { if (isset($resultLowerBoundTypes[$name])) { $resultLowerBoundTypes[$name] = TypeCombinator::union($resultLowerBoundTypes[$name], $type); } else { $resultLowerBoundTypes[$name] = $type; } } return new self($result, $resultLowerBoundTypes); } /** @param callable(string,Type):Type $cb */ public function map(callable $cb) : self { $types = []; foreach ($this->getTypes() as $name => $type) { $types[$name] = $cb($name, $type); } return new self($types); } public function resolveToBounds() : self { if ($this->resolvedToBounds !== null) { return $this->resolvedToBounds; } return $this->resolvedToBounds = $this->map(static function (string $name, Type $type) : Type { return TypeTraverser::map($type, static function (Type $type, callable $traverse) : Type { return $type instanceof \PHPStan\Type\Generic\TemplateType ? $traverse($type->getDefault() ?? $type->getBound()) : $traverse($type); }); }); } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : self { return new self($properties['types'], $properties['lowerBoundTypes'] ?? []); } } <?php declare (strict_types=1); namespace PHPStan\Type\Generic; use PHPStan\Type\Traits\UndecidedComparisonCompoundTypeTrait; use PHPStan\Type\Type; /** @api */ final class TemplateGenericObjectType extends \PHPStan\Type\Generic\GenericObjectType implements \PHPStan\Type\Generic\TemplateType { use UndecidedComparisonCompoundTypeTrait; /** @use TemplateTypeTrait<GenericObjectType> */ use \PHPStan\Type\Generic\TemplateTypeTrait; /** * @param non-empty-string $name */ public function __construct(\PHPStan\Type\Generic\TemplateTypeScope $scope, \PHPStan\Type\Generic\TemplateTypeStrategy $templateTypeStrategy, \PHPStan\Type\Generic\TemplateTypeVariance $templateTypeVariance, string $name, \PHPStan\Type\Generic\GenericObjectType $bound, ?Type $default) { parent::__construct($bound->getClassName(), $bound->getTypes(), null, null, $bound->getVariances()); $this->scope = $scope; $this->strategy = $templateTypeStrategy; $this->variance = $templateTypeVariance; $this->name = $name; $this->bound = $bound; $this->default = $default; } protected function recreate(string $className, array $types, ?Type $subtractedType, array $variances = []) : \PHPStan\Type\Generic\GenericObjectType { return new self($this->scope, $this->strategy, $this->variance, $this->name, $this->getBound(), $this->default); } } <?php declare (strict_types=1); namespace PHPStan\Type\Generic; use PHPStan\Type\ObjectShapeType; use PHPStan\Type\Traits\UndecidedComparisonCompoundTypeTrait; use PHPStan\Type\Type; /** @api */ final class TemplateObjectShapeType extends ObjectShapeType implements \PHPStan\Type\Generic\TemplateType { /** @use TemplateTypeTrait<ObjectShapeType> */ use \PHPStan\Type\Generic\TemplateTypeTrait; use UndecidedComparisonCompoundTypeTrait; /** * @param non-empty-string $name */ public function __construct(\PHPStan\Type\Generic\TemplateTypeScope $scope, \PHPStan\Type\Generic\TemplateTypeStrategy $templateTypeStrategy, \PHPStan\Type\Generic\TemplateTypeVariance $templateTypeVariance, string $name, ObjectShapeType $bound, ?Type $default) { parent::__construct($bound->getProperties(), $bound->getOptionalProperties()); $this->scope = $scope; $this->strategy = $templateTypeStrategy; $this->variance = $templateTypeVariance; $this->name = $name; $this->bound = $bound; $this->default = $default; } protected function shouldGeneralizeInferredType() : bool { return \false; } } <?php declare (strict_types=1); namespace PHPStan\Type\Generic; final class TemplateTypeReference { /** * @var TemplateType */ private $type; /** * @var TemplateTypeVariance */ private $positionVariance; public function __construct(\PHPStan\Type\Generic\TemplateType $type, \PHPStan\Type\Generic\TemplateTypeVariance $positionVariance) { $this->type = $type; $this->positionVariance = $positionVariance; } public function getType() : \PHPStan\Type\Generic\TemplateType { return $this->type; } public function getPositionVariance() : \PHPStan\Type\Generic\TemplateTypeVariance { return $this->positionVariance; } } <?php declare (strict_types=1); namespace PHPStan\Type\Generic; use PHPStan\TrinaryLogic; use PHPStan\Type\AcceptsResult; use PHPStan\Type\MixedType; use PHPStan\Type\StrictMixedType; use PHPStan\Type\Type; /** @api */ final class TemplateMixedType extends MixedType implements \PHPStan\Type\Generic\TemplateType { /** @use TemplateTypeTrait<MixedType> */ use \PHPStan\Type\Generic\TemplateTypeTrait; /** * @param non-empty-string $name */ public function __construct(\PHPStan\Type\Generic\TemplateTypeScope $scope, \PHPStan\Type\Generic\TemplateTypeStrategy $templateTypeStrategy, \PHPStan\Type\Generic\TemplateTypeVariance $templateTypeVariance, string $name, MixedType $bound, ?Type $default) { parent::__construct(\true); $this->scope = $scope; $this->strategy = $templateTypeStrategy; $this->variance = $templateTypeVariance; $this->name = $name; $this->bound = $bound; $this->default = $default; } public function isSuperTypeOfMixed(MixedType $type) : TrinaryLogic { return $this->isSuperTypeOf($type); } public function isAcceptedBy(Type $acceptingType, bool $strictTypes) : TrinaryLogic { return $this->isAcceptedWithReasonBy($acceptingType, $strictTypes)->result; } public function isAcceptedWithReasonBy(Type $acceptingType, bool $strictTypes) : AcceptsResult { $isSuperType = $this->isSuperTypeOfWithReason($acceptingType)->toAcceptsResult(); if ($isSuperType->no()) { return $isSuperType; } return AcceptsResult::createYes(); } public function toStrictMixedType() : \PHPStan\Type\Generic\TemplateStrictMixedType { return new \PHPStan\Type\Generic\TemplateStrictMixedType($this->scope, $this->strategy, $this->variance, $this->name, new StrictMixedType(), $this->default); } } <?php declare (strict_types=1); namespace PHPStan\Type\Generic; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Traits\UndecidedComparisonCompoundTypeTrait; use PHPStan\Type\Type; /** @api */ final class TemplateConstantIntegerType extends ConstantIntegerType implements \PHPStan\Type\Generic\TemplateType { /** @use TemplateTypeTrait<ConstantIntegerType> */ use \PHPStan\Type\Generic\TemplateTypeTrait; use UndecidedComparisonCompoundTypeTrait; /** * @param non-empty-string $name */ public function __construct(\PHPStan\Type\Generic\TemplateTypeScope $scope, \PHPStan\Type\Generic\TemplateTypeStrategy $templateTypeStrategy, \PHPStan\Type\Generic\TemplateTypeVariance $templateTypeVariance, string $name, ConstantIntegerType $bound, ?Type $default) { parent::__construct($bound->getValue()); $this->scope = $scope; $this->strategy = $templateTypeStrategy; $this->variance = $templateTypeVariance; $this->name = $name; $this->bound = $bound; $this->default = $default; } protected function shouldGeneralizeInferredType() : bool { return \false; } } <?php declare (strict_types=1); namespace PHPStan\Type\Generic; use PHPStan\PhpDocParser\Ast\Type\GenericTypeNode; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\Reflection\ClassMemberAccessAnswerer; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\PropertyReflection; use PHPStan\Reflection\ReflectionProviderStaticAccessor; use PHPStan\Reflection\Type\UnresolvedMethodPrototypeReflection; use PHPStan\Reflection\Type\UnresolvedPropertyPrototypeReflection; use PHPStan\ShouldNotHappenException; use PHPStan\TrinaryLogic; use PHPStan\Type\AcceptsResult; use PHPStan\Type\CompoundType; use PHPStan\Type\ErrorType; use PHPStan\Type\IntersectionType; use PHPStan\Type\IsSuperTypeOfResult; use PHPStan\Type\ObjectType; use PHPStan\Type\Type; use PHPStan\Type\TypeWithClassName; use PHPStan\Type\UnionType; use PHPStan\Type\VerbosityLevel; use function array_map; use function count; use function implode; use function sprintf; /** @api */ class GenericObjectType extends ObjectType { /** * @var array<int, Type> */ private $types; /** * @var ?ClassReflection */ private $classReflection; /** * @var array<int, TemplateTypeVariance> */ private $variances; /** * @api * @param array<int, Type> $types * @param array<int, TemplateTypeVariance> $variances */ public function __construct(string $mainType, array $types, ?Type $subtractedType = null, ?ClassReflection $classReflection = null, array $variances = []) { $this->types = $types; $this->classReflection = $classReflection; $this->variances = $variances; parent::__construct($mainType, $subtractedType, $classReflection); } public function describe(VerbosityLevel $level) : string { return sprintf('%s<%s>', parent::describe($level), implode(', ', array_map(static function (Type $type, ?\PHPStan\Type\Generic\TemplateTypeVariance $variance = null) use($level) : string { return \PHPStan\Type\Generic\TypeProjectionHelper::describe($type, $variance, $level); }, $this->types, $this->variances))); } public function equals(Type $type) : bool { if (!$type instanceof self) { return \false; } if (!parent::equals($type)) { return \false; } if (count($this->types) !== count($type->types)) { return \false; } foreach ($this->types as $i => $genericType) { $otherGenericType = $type->types[$i]; if (!$genericType->equals($otherGenericType)) { return \false; } $variance = $this->variances[$i] ?? \PHPStan\Type\Generic\TemplateTypeVariance::createInvariant(); $otherVariance = $type->variances[$i] ?? \PHPStan\Type\Generic\TemplateTypeVariance::createInvariant(); if (!$variance->equals($otherVariance)) { return \false; } } return \true; } /** * @return string[] */ public function getReferencedClasses() : array { $classes = parent::getReferencedClasses(); foreach ($this->types as $type) { foreach ($type->getReferencedClasses() as $referencedClass) { $classes[] = $referencedClass; } } return $classes; } /** @return array<int, Type> */ public function getTypes() : array { return $this->types; } /** @return array<int, TemplateTypeVariance> */ public function getVariances() : array { return $this->variances; } public function accepts(Type $type, bool $strictTypes) : TrinaryLogic { return $this->acceptsWithReason($type, $strictTypes)->result; } public function acceptsWithReason(Type $type, bool $strictTypes) : AcceptsResult { if ($type instanceof CompoundType) { return $type->isAcceptedWithReasonBy($this, $strictTypes); } return $this->isSuperTypeOfInternal($type, \true)->toAcceptsResult(); } public function isSuperTypeOf(Type $type) : TrinaryLogic { return $this->isSuperTypeOfWithReason($type)->result; } public function isSuperTypeOfWithReason(Type $type) : IsSuperTypeOfResult { if ($type instanceof CompoundType) { return $type->isSubTypeOfWithReason($this); } return $this->isSuperTypeOfInternal($type, \false); } private function isSuperTypeOfInternal(Type $type, bool $acceptsContext) : IsSuperTypeOfResult { $nakedSuperTypeOf = parent::isSuperTypeOfWithReason($type); if ($nakedSuperTypeOf->no()) { return $nakedSuperTypeOf; } if (!$type instanceof ObjectType) { return $nakedSuperTypeOf; } $ancestor = $type->getAncestorWithClassName($this->getClassName()); if ($ancestor === null) { return $nakedSuperTypeOf; } if (!$ancestor instanceof self) { if ($acceptsContext) { return $nakedSuperTypeOf; } return $nakedSuperTypeOf->and(IsSuperTypeOfResult::createMaybe()); } if (count($this->types) !== count($ancestor->types)) { return IsSuperTypeOfResult::createNo(); } $classReflection = $this->getClassReflection(); if ($classReflection === null) { return $nakedSuperTypeOf; } $typeList = $classReflection->typeMapToList($classReflection->getTemplateTypeMap()); $results = []; foreach ($typeList as $i => $templateType) { if (!isset($ancestor->types[$i])) { continue; } if (!isset($this->types[$i])) { continue; } if ($templateType instanceof ErrorType) { continue; } if (!$templateType instanceof \PHPStan\Type\Generic\TemplateType) { throw new ShouldNotHappenException(); } $thisVariance = $this->variances[$i] ?? \PHPStan\Type\Generic\TemplateTypeVariance::createInvariant(); $ancestorVariance = $ancestor->variances[$i] ?? \PHPStan\Type\Generic\TemplateTypeVariance::createInvariant(); if (!$thisVariance->invariant()) { $result = $thisVariance->isValidVarianceWithReason($templateType, $this->types[$i], $ancestor->types[$i]); $results[] = new IsSuperTypeOfResult($result->result, $result->reasons); } else { $result = $templateType->isValidVarianceWithReason($this->types[$i], $ancestor->types[$i]); $results[] = new IsSuperTypeOfResult($result->result, $result->reasons); } $results[] = IsSuperTypeOfResult::createFromBoolean($thisVariance->validPosition($ancestorVariance)); } if (count($results) === 0) { return $nakedSuperTypeOf; } $result = IsSuperTypeOfResult::createYes(); foreach ($results as $innerResult) { $result = $result->and($innerResult); } return $result; } public function getClassReflection() : ?ClassReflection { if ($this->classReflection !== null) { return $this->classReflection; } $reflectionProvider = ReflectionProviderStaticAccessor::getInstance(); if (!$reflectionProvider->hasClass($this->getClassName())) { return null; } return $this->classReflection = $reflectionProvider->getClass($this->getClassName())->withTypes($this->types)->withVariances($this->variances); } public function getProperty(string $propertyName, ClassMemberAccessAnswerer $scope) : PropertyReflection { return $this->getUnresolvedPropertyPrototype($propertyName, $scope)->getTransformedProperty(); } public function getUnresolvedPropertyPrototype(string $propertyName, ClassMemberAccessAnswerer $scope) : UnresolvedPropertyPrototypeReflection { $prototype = parent::getUnresolvedPropertyPrototype($propertyName, $scope); return $prototype->doNotResolveTemplateTypeMapToBounds(); } public function getMethod(string $methodName, ClassMemberAccessAnswerer $scope) : ExtendedMethodReflection { return $this->getUnresolvedMethodPrototype($methodName, $scope)->getTransformedMethod(); } public function getUnresolvedMethodPrototype(string $methodName, ClassMemberAccessAnswerer $scope) : UnresolvedMethodPrototypeReflection { $prototype = parent::getUnresolvedMethodPrototype($methodName, $scope); return $prototype->doNotResolveTemplateTypeMapToBounds(); } public function inferTemplateTypes(Type $receivedType) : \PHPStan\Type\Generic\TemplateTypeMap { if ($receivedType instanceof UnionType || $receivedType instanceof IntersectionType) { return $receivedType->inferTemplateTypesOn($this); } if (!$receivedType instanceof TypeWithClassName) { return \PHPStan\Type\Generic\TemplateTypeMap::createEmpty(); } $ancestor = $receivedType->getAncestorWithClassName($this->getClassName()); if ($ancestor === null) { return \PHPStan\Type\Generic\TemplateTypeMap::createEmpty(); } $ancestorClassReflection = $ancestor->getClassReflection(); if ($ancestorClassReflection === null) { return \PHPStan\Type\Generic\TemplateTypeMap::createEmpty(); } $otherTypes = $ancestorClassReflection->typeMapToList($ancestorClassReflection->getActiveTemplateTypeMap()); $typeMap = \PHPStan\Type\Generic\TemplateTypeMap::createEmpty(); foreach ($this->getTypes() as $i => $type) { $other = $otherTypes[$i] ?? new ErrorType(); $typeMap = $typeMap->union($type->inferTemplateTypes($other)); } return $typeMap; } public function getReferencedTemplateTypes(\PHPStan\Type\Generic\TemplateTypeVariance $positionVariance) : array { $classReflection = $this->getClassReflection(); if ($classReflection !== null) { $typeList = $classReflection->typeMapToList($classReflection->getTemplateTypeMap()); } else { $typeList = []; } $references = []; foreach ($this->types as $i => $type) { $effectiveVariance = $this->variances[$i] ?? \PHPStan\Type\Generic\TemplateTypeVariance::createInvariant(); if ($effectiveVariance->invariant() && isset($typeList[$i]) && $typeList[$i] instanceof \PHPStan\Type\Generic\TemplateType) { $effectiveVariance = $typeList[$i]->getVariance(); } $variance = $positionVariance->compose($effectiveVariance); foreach ($type->getReferencedTemplateTypes($variance) as $reference) { $references[] = $reference; } } return $references; } public function traverse(callable $cb) : Type { $subtractedType = $this->getSubtractedType() !== null ? $cb($this->getSubtractedType()) : null; $typesChanged = \false; $types = []; foreach ($this->types as $type) { $newType = $cb($type); $types[] = $newType; if ($newType === $type) { continue; } $typesChanged = \true; } if ($subtractedType !== $this->getSubtractedType() || $typesChanged) { return $this->recreate($this->getClassName(), $types, $subtractedType, $this->variances); } return $this; } public function traverseSimultaneously(Type $right, callable $cb) : Type { if (!$right instanceof TypeWithClassName) { return $this; } $ancestor = $right->getAncestorWithClassName($this->getClassName()); if (!$ancestor instanceof self) { return $this; } if (count($this->types) !== count($ancestor->types)) { return $this; } $typesChanged = \false; $types = []; foreach ($this->types as $i => $leftType) { $rightType = $ancestor->types[$i]; $newType = $cb($leftType, $rightType); $types[] = $newType; if ($newType === $leftType) { continue; } $typesChanged = \true; } if ($typesChanged) { return $this->recreate($this->getClassName(), $types, null); } return $this; } /** * @param Type[] $types * @param TemplateTypeVariance[] $variances */ protected function recreate(string $className, array $types, ?Type $subtractedType, array $variances = []) : self { return new self($className, $types, $subtractedType, null, $variances); } public function changeSubtractedType(?Type $subtractedType) : Type { return new self($this->getClassName(), $this->types, $subtractedType, null, $this->variances); } public function toPhpDocNode() : TypeNode { /** @var IdentifierTypeNode $parent */ $parent = parent::toPhpDocNode(); return new GenericTypeNode($parent, array_map(static function (Type $type) { return $type->toPhpDocNode(); }, $this->types), array_map(static function (\PHPStan\Type\Generic\TemplateTypeVariance $variance) { return $variance->toPhpDocNodeVariance(); }, $this->variances)); } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : Type { return new self($properties['className'], $properties['types'], $properties['subtractedType'] ?? null, null, $properties['variances'] ?? []); } } <?php declare (strict_types=1); namespace PHPStan\Type\Generic; use PHPStan\Type\IntersectionType; use PHPStan\Type\Type; /** @api */ final class TemplateIntersectionType extends IntersectionType implements \PHPStan\Type\Generic\TemplateType { /** @use TemplateTypeTrait<IntersectionType> */ use \PHPStan\Type\Generic\TemplateTypeTrait; /** * @param non-empty-string $name */ public function __construct(\PHPStan\Type\Generic\TemplateTypeScope $scope, \PHPStan\Type\Generic\TemplateTypeStrategy $templateTypeStrategy, \PHPStan\Type\Generic\TemplateTypeVariance $templateTypeVariance, string $name, IntersectionType $bound, ?Type $default) { parent::__construct($bound->getTypes()); $this->scope = $scope; $this->strategy = $templateTypeStrategy; $this->variance = $templateTypeVariance; $this->name = $name; $this->bound = $bound; $this->default = $default; } } <?php declare (strict_types=1); namespace PHPStan\Type\Generic; use PHPStan\Type\AcceptsResult; use PHPStan\Type\CompoundType; use PHPStan\Type\Type; /** * Template type strategy suitable for parameter type acceptance contexts */ final class TemplateTypeParameterStrategy implements \PHPStan\Type\Generic\TemplateTypeStrategy { public function accepts(\PHPStan\Type\Generic\TemplateType $left, Type $right, bool $strictTypes) : AcceptsResult { if ($right instanceof CompoundType) { return $right->isAcceptedWithReasonBy($left, $strictTypes); } return $left->getBound()->acceptsWithReason($right, $strictTypes); } public function isArgument() : bool { return \false; } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : self { return new self(); } } <?php declare (strict_types=1); namespace PHPStan\Type\Generic; use PHPStan\PhpDocParser\Ast\Type\GenericTypeNode; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\Reflection\ReflectionProviderStaticAccessor; use PHPStan\TrinaryLogic; use PHPStan\Type\AcceptsResult; use PHPStan\Type\ClassStringType; use PHPStan\Type\CompoundType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\IntersectionType; use PHPStan\Type\IsSuperTypeOfResult; use PHPStan\Type\MixedType; use PHPStan\Type\NeverType; use PHPStan\Type\ObjectType; use PHPStan\Type\ObjectWithoutClassType; use PHPStan\Type\StaticType; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\UnionType; use PHPStan\Type\VerbosityLevel; use function count; use function sprintf; /** @api */ class GenericClassStringType extends ClassStringType { /** * @var Type */ private $type; /** @api */ public function __construct(Type $type) { $this->type = $type; parent::__construct(); } public function getReferencedClasses() : array { return $this->type->getReferencedClasses(); } public function getGenericType() : Type { return $this->type; } public function getClassStringObjectType() : Type { return $this->getGenericType(); } public function getObjectTypeOrClassStringObjectType() : Type { return $this->getClassStringObjectType(); } public function describe(VerbosityLevel $level) : string { return sprintf('%s<%s>', parent::describe($level), $this->type->describe($level)); } public function acceptsWithReason(Type $type, bool $strictTypes) : AcceptsResult { if ($type instanceof CompoundType) { return $type->isAcceptedWithReasonBy($this, $strictTypes); } if ($type instanceof ConstantStringType) { if (!$type->isClassStringType()->yes()) { return AcceptsResult::createNo(); } $objectType = new ObjectType($type->getValue()); } elseif ($type instanceof self) { $objectType = $type->type; } elseif ($type instanceof ClassStringType) { $objectType = new ObjectWithoutClassType(); } elseif ($type instanceof StringType) { return AcceptsResult::createMaybe(); } else { return AcceptsResult::createNo(); } return $this->type->acceptsWithReason($objectType, $strictTypes); } public function isSuperTypeOf(Type $type) : TrinaryLogic { return $this->isSuperTypeOfWithReason($type)->result; } public function isSuperTypeOfWithReason(Type $type) : IsSuperTypeOfResult { if ($type instanceof CompoundType) { return $type->isSubTypeOfWithReason($this); } if ($type instanceof ConstantStringType) { $genericType = $this->type; if ($genericType instanceof MixedType) { return IsSuperTypeOfResult::createYes(); } if ($genericType instanceof StaticType) { $genericType = $genericType->getStaticObjectType(); } // We are transforming constant class-string to ObjectType. But we need to filter out // an uncertainty originating in possible ObjectType's class subtypes. $objectType = new ObjectType($type->getValue()); // Do not use TemplateType's isSuperTypeOf handling directly because it takes ObjectType // uncertainty into account. if ($genericType instanceof \PHPStan\Type\Generic\TemplateType) { $isSuperType = $genericType->getBound()->isSuperTypeOfWithReason($objectType); } else { $isSuperType = $genericType->isSuperTypeOfWithReason($objectType); } if (!$type->isClassStringType()->yes()) { $isSuperType = $isSuperType->and(IsSuperTypeOfResult::createMaybe()); } return $isSuperType; } elseif ($type instanceof self) { return $this->type->isSuperTypeOfWithReason($type->type); } elseif ($type instanceof StringType) { return IsSuperTypeOfResult::createMaybe(); } return IsSuperTypeOfResult::createNo(); } public function traverse(callable $cb) : Type { $newType = $cb($this->type); if ($newType === $this->type) { return $this; } return new self($newType); } public function traverseSimultaneously(Type $right, callable $cb) : Type { $newType = $cb($this->type, $right->getClassStringObjectType()); if ($newType === $this->type) { return $this; } return new self($newType); } public function inferTemplateTypes(Type $receivedType) : \PHPStan\Type\Generic\TemplateTypeMap { if ($receivedType instanceof UnionType || $receivedType instanceof IntersectionType) { return $receivedType->inferTemplateTypesOn($this); } if ($receivedType instanceof ConstantStringType) { $typeToInfer = new ObjectType($receivedType->getValue()); } elseif ($receivedType instanceof self) { $typeToInfer = $receivedType->type; } elseif ($receivedType->isClassStringType()->yes()) { $typeToInfer = $this->type; if ($typeToInfer instanceof \PHPStan\Type\Generic\TemplateType) { $typeToInfer = $typeToInfer->getBound(); } $typeToInfer = TypeCombinator::intersect($typeToInfer, new ObjectWithoutClassType()); } else { return \PHPStan\Type\Generic\TemplateTypeMap::createEmpty(); } return $this->type->inferTemplateTypes($typeToInfer); } public function getReferencedTemplateTypes(\PHPStan\Type\Generic\TemplateTypeVariance $positionVariance) : array { $variance = $positionVariance->compose(\PHPStan\Type\Generic\TemplateTypeVariance::createCovariant()); return $this->type->getReferencedTemplateTypes($variance); } public function equals(Type $type) : bool { if (!$type instanceof self) { return \false; } if (!parent::equals($type)) { return \false; } if (!$this->type->equals($type->type)) { return \false; } return \true; } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : Type { return new self($properties['type']); } public function toPhpDocNode() : TypeNode { return new GenericTypeNode(new IdentifierTypeNode('class-string'), [$this->type->toPhpDocNode()]); } public function tryRemove(Type $typeToRemove) : ?Type { if ($typeToRemove instanceof ConstantStringType && $typeToRemove->isClassStringType()->yes()) { $generic = $this->getGenericType(); $genericObjectClassNames = $generic->getObjectClassNames(); if (count($genericObjectClassNames) === 1) { $classReflection = ReflectionProviderStaticAccessor::getInstance()->getClass($genericObjectClassNames[0]); if ($classReflection->isFinal() && $genericObjectClassNames[0] === $typeToRemove->getValue()) { return new NeverType(); } } } return parent::tryRemove($typeToRemove); } } <?php declare (strict_types=1); namespace PHPStan\Type\Generic; use PHPStan\Type\AcceptsResult; use PHPStan\Type\CompoundType; use PHPStan\Type\Type; use PHPStan\Type\VerbosityLevel; use function array_merge; use function sprintf; /** * Template type strategy suitable for return type acceptance contexts */ final class TemplateTypeArgumentStrategy implements \PHPStan\Type\Generic\TemplateTypeStrategy { public function accepts(\PHPStan\Type\Generic\TemplateType $left, Type $right, bool $strictTypes) : AcceptsResult { if ($right instanceof CompoundType) { $accepts = $right->isAcceptedWithReasonBy($left, $strictTypes); } else { $accepts = $left->getBound()->acceptsWithReason($right, $strictTypes)->and(AcceptsResult::createMaybe()); if ($accepts->maybe()) { $verbosity = VerbosityLevel::getRecommendedLevelByType($left, $right); return new AcceptsResult($accepts->result, array_merge($accepts->reasons, [sprintf('Type %s is not always the same as %s. It breaks the contract for some argument types, typically subtypes.', $right->describe($verbosity), $left->getName())])); } } return $accepts; } public function isArgument() : bool { return \true; } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : self { return new self(); } } <?php declare (strict_types=1); namespace PHPStan\Type\Generic; use PHPStan\Type\Type; use PHPStan\Type\UnionType; /** @api */ final class TemplateUnionType extends UnionType implements \PHPStan\Type\Generic\TemplateType { /** @use TemplateTypeTrait<UnionType> */ use \PHPStan\Type\Generic\TemplateTypeTrait; /** * @param non-empty-string $name */ public function __construct(\PHPStan\Type\Generic\TemplateTypeScope $scope, \PHPStan\Type\Generic\TemplateTypeStrategy $templateTypeStrategy, \PHPStan\Type\Generic\TemplateTypeVariance $templateTypeVariance, string $name, UnionType $bound, ?Type $default) { parent::__construct($bound->getTypes()); $this->scope = $scope; $this->strategy = $templateTypeStrategy; $this->variance = $templateTypeVariance; $this->name = $name; $this->bound = $bound; $this->default = $default; } public function filterTypes(callable $filterCb) : Type { $result = parent::filterTypes($filterCb); if (!$result instanceof \PHPStan\Type\Generic\TemplateType) { return \PHPStan\Type\Generic\TemplateTypeFactory::create($this->getScope(), $this->getName(), $result, $this->getVariance(), $this->getStrategy(), $this->getDefault()); } return $result; } } <?php declare (strict_types=1); namespace PHPStan\Type\Generic; use PHPStan\Type\StringType; use PHPStan\Type\Traits\UndecidedComparisonCompoundTypeTrait; use PHPStan\Type\Type; /** @api */ final class TemplateStringType extends StringType implements \PHPStan\Type\Generic\TemplateType { /** @use TemplateTypeTrait<StringType> */ use \PHPStan\Type\Generic\TemplateTypeTrait; use UndecidedComparisonCompoundTypeTrait; /** * @param non-empty-string $name */ public function __construct(\PHPStan\Type\Generic\TemplateTypeScope $scope, \PHPStan\Type\Generic\TemplateTypeStrategy $templateTypeStrategy, \PHPStan\Type\Generic\TemplateTypeVariance $templateTypeVariance, string $name, StringType $bound, ?Type $default) { parent::__construct(); $this->scope = $scope; $this->strategy = $templateTypeStrategy; $this->variance = $templateTypeVariance; $this->name = $name; $this->bound = $bound; $this->default = $default; } protected function shouldGeneralizeInferredType() : bool { return \false; } } <?php declare (strict_types=1); namespace PHPStan\Type\Generic; use PHPStan\PhpDocParser\Ast\Type\GenericTypeNode; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ReflectionProviderStaticAccessor; use PHPStan\ShouldNotHappenException; use PHPStan\Type\CompoundType; use PHPStan\Type\ErrorType; use PHPStan\Type\IsSuperTypeOfResult; use PHPStan\Type\NeverType; use PHPStan\Type\ObjectType; use PHPStan\Type\StaticType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\TypeWithClassName; use function array_key_exists; use function array_map; use function count; /** @api */ class GenericStaticType extends StaticType { /** * @var ClassReflection */ private $classReflection; /** * @var array<int, Type> */ private $types; /** * @var ?Type */ private $subtractedType; /** * @var array<int, TemplateTypeVariance> */ private $variances; /** * @var ?ObjectType */ private $staticObjectType = null; /** * @var string */ private $baseClass; /** * @api * @param array<int, Type> $types * @param array<int, TemplateTypeVariance> $variances */ public function __construct(ClassReflection $classReflection, array $types, ?Type $subtractedType, array $variances) { $this->classReflection = $classReflection; $this->types = $types; $this->subtractedType = $subtractedType; $this->variances = $variances; if (count($this->types) === 0) { throw new ShouldNotHappenException('Cannot create GenericStaticType with zero types.'); } parent::__construct($classReflection, $subtractedType); $this->baseClass = $classReflection->getName(); } public function getClassName() : string { return $this->baseClass; } /** * @return array<int, Type> */ public function getTypes() : array { return $this->types; } /** @return array<int, TemplateTypeVariance> */ public function getVariances() : array { return $this->variances; } public function getStaticObjectType() : ObjectType { if ($this->staticObjectType === null) { if ($this->classReflection->isGeneric()) { return $this->staticObjectType = new \PHPStan\Type\Generic\GenericObjectType($this->classReflection->getName(), $this->types, $this->subtractedType, $this->classReflection, $this->variances); } return $this->staticObjectType = parent::getStaticObjectType(); } return $this->staticObjectType; } public function changeBaseClass(ClassReflection $classReflection) : StaticType { if ($classReflection->getName() === $this->getClassName()) { return $this; } if (!$classReflection->isGeneric()) { return new StaticType($classReflection); } $templateTags = $this->getClassReflection()->getTemplateTags(); $i = 0; $indexedTypes = []; $indexedVariances = []; foreach ($templateTags as $typeName => $tag) { if (!array_key_exists($i, $this->types)) { break; } if (!array_key_exists($i, $this->variances)) { break; } $indexedTypes[$typeName] = $this->types[$i]; $indexedVariances[$typeName] = $this->variances[$i]; $i++; } $newType = new \PHPStan\Type\Generic\GenericObjectType($classReflection->getName(), $classReflection->typeMapToList($classReflection->getTemplateTypeMap())); $ancestorType = $newType->getAncestorWithClassName($this->getClassName()); if ($ancestorType === null) { return new self($classReflection, $classReflection->typeMapToList($classReflection->getTemplateTypeMap()->resolveToBounds()), $this->subtractedType, $classReflection->varianceMapToList($classReflection->getCallSiteVarianceMap())); } $ancestorClassReflection = $ancestorType->getClassReflection(); if ($ancestorClassReflection === null) { return new self($classReflection, $classReflection->typeMapToList($classReflection->getTemplateTypeMap()->resolveToBounds()), $this->subtractedType, $classReflection->varianceMapToList($classReflection->getCallSiteVarianceMap())); } $newClassTypes = []; $newClassVariances = []; foreach ($ancestorClassReflection->getActiveTemplateTypeMap()->getTypes() as $typeName => $templateType) { if (!$templateType instanceof \PHPStan\Type\Generic\TemplateType) { continue; } if (!array_key_exists($typeName, $indexedTypes)) { continue; } $newClassTypes[$templateType->getName()] = $indexedTypes[$typeName]; $newClassVariances[$templateType->getName()] = $indexedVariances[$typeName]; } return new self($classReflection, $classReflection->typeMapToList(new \PHPStan\Type\Generic\TemplateTypeMap($newClassTypes)), $this->subtractedType, $classReflection->varianceMapToList(new \PHPStan\Type\Generic\TemplateTypeVarianceMap($newClassVariances))); } public function isSuperTypeOfWithReason(Type $type) : IsSuperTypeOfResult { if ($type instanceof CompoundType) { return $type->isSubTypeOfWithReason($this); } if ($type instanceof self) { return $this->getStaticObjectType()->isSuperTypeOfWithReason($type->getStaticObjectType()); } return parent::isSuperTypeOfWithReason($type)->and(IsSuperTypeOfResult::createMaybe()); } public function traverse(callable $cb) : Type { $subtractedType = $this->getSubtractedType() !== null ? $cb($this->getSubtractedType()) : null; $typesChanged = \false; $types = []; foreach ($this->types as $type) { $newType = $cb($type); $types[] = $newType; if ($newType === $type) { continue; } $typesChanged = \true; } if ($subtractedType !== $this->getSubtractedType() || $typesChanged) { return new self($this->classReflection, $types, $subtractedType, $this->variances); } return $this; } public function traverseSimultaneously(Type $right, callable $cb) : Type { if (!$right instanceof TypeWithClassName) { return $this; } $ancestor = $right->getAncestorWithClassName($this->getClassName()); if (!$ancestor instanceof self) { return $this; } if (count($this->types) !== count($ancestor->types)) { return $this; } $typesChanged = \false; $types = []; foreach ($this->types as $i => $leftType) { $rightType = $ancestor->types[$i]; $newType = $cb($leftType, $rightType); $types[] = $newType; if ($newType === $leftType) { continue; } $typesChanged = \true; } if ($typesChanged) { return new self($this->classReflection, $types, null, $this->variances); } return $this; } public function changeSubtractedType(?Type $subtractedType) : Type { if ($subtractedType !== null) { $classReflection = $this->getClassReflection(); if ($classReflection->getAllowedSubTypes() !== null) { $objectType = $this->getStaticObjectType()->changeSubtractedType($subtractedType); if ($objectType instanceof NeverType) { return $objectType; } if ($objectType instanceof ObjectType && $objectType->getSubtractedType() !== null) { return new self($classReflection, $this->types, $objectType->getSubtractedType(), $this->variances); } return TypeCombinator::intersect($this, $objectType); } } return new self($this->classReflection, $this->types, $subtractedType, $this->variances); } public function inferTemplateTypes(Type $receivedType) : \PHPStan\Type\Generic\TemplateTypeMap { return $this->getStaticObjectType()->inferTemplateTypes($receivedType); } public function getReferencedTemplateTypes(\PHPStan\Type\Generic\TemplateTypeVariance $positionVariance) : array { return $this->getStaticObjectType()->getReferencedTemplateTypes($positionVariance); } public function toPhpDocNode() : TypeNode { /** @var IdentifierTypeNode $parent */ $parent = parent::toPhpDocNode(); return new GenericTypeNode($parent, array_map(static function (Type $type) { return $type->toPhpDocNode(); }, $this->types), array_map(static function (\PHPStan\Type\Generic\TemplateTypeVariance $variance) { return $variance->toPhpDocNodeVariance(); }, $this->variances)); } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : Type { $reflectionProvider = ReflectionProviderStaticAccessor::getInstance(); if ($reflectionProvider->hasClass($properties['baseClass'])) { return new self($reflectionProvider->getClass($properties['baseClass']), $properties['types'], $properties['subtractedType'], $properties['variances']); } return new ErrorType(); } } <?php declare (strict_types=1); namespace PHPStan\Type\Generic; use PHPStan\PhpDoc\Tag\TemplateTag; use PHPStan\Type\ArrayType; use PHPStan\Type\BenevolentUnionType; use PHPStan\Type\BooleanType; use PHPStan\Type\Constant\ConstantArrayType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\FloatType; use PHPStan\Type\IntegerType; use PHPStan\Type\IntersectionType; use PHPStan\Type\KeyOfType; use PHPStan\Type\MixedType; use PHPStan\Type\ObjectShapeType; use PHPStan\Type\ObjectType; use PHPStan\Type\ObjectWithoutClassType; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\UnionType; use function get_class; final class TemplateTypeFactory { /** * @param non-empty-string $name */ public static function create(\PHPStan\Type\Generic\TemplateTypeScope $scope, string $name, ?Type $bound, \PHPStan\Type\Generic\TemplateTypeVariance $variance, ?\PHPStan\Type\Generic\TemplateTypeStrategy $strategy = null, ?Type $default = null) : \PHPStan\Type\Generic\TemplateType { $strategy = $strategy ?? new \PHPStan\Type\Generic\TemplateTypeParameterStrategy(); if ($bound === null) { return new \PHPStan\Type\Generic\TemplateMixedType($scope, $strategy, $variance, $name, new MixedType(\true), $default); } $boundClass = get_class($bound); if ($bound instanceof ObjectType && ($boundClass === ObjectType::class || $bound instanceof \PHPStan\Type\Generic\TemplateType)) { return new \PHPStan\Type\Generic\TemplateObjectType($scope, $strategy, $variance, $name, $bound, $default); } if ($bound instanceof \PHPStan\Type\Generic\GenericObjectType && ($boundClass === \PHPStan\Type\Generic\GenericObjectType::class || $bound instanceof \PHPStan\Type\Generic\TemplateType)) { return new \PHPStan\Type\Generic\TemplateGenericObjectType($scope, $strategy, $variance, $name, $bound, $default); } if ($bound instanceof ObjectWithoutClassType && ($boundClass === ObjectWithoutClassType::class || $bound instanceof \PHPStan\Type\Generic\TemplateType)) { return new \PHPStan\Type\Generic\TemplateObjectWithoutClassType($scope, $strategy, $variance, $name, $bound, $default); } if ($bound instanceof ArrayType && ($boundClass === ArrayType::class || $bound instanceof \PHPStan\Type\Generic\TemplateType)) { return new \PHPStan\Type\Generic\TemplateArrayType($scope, $strategy, $variance, $name, $bound, $default); } if ($bound instanceof ConstantArrayType && ($boundClass === ConstantArrayType::class || $bound instanceof \PHPStan\Type\Generic\TemplateType)) { return new \PHPStan\Type\Generic\TemplateConstantArrayType($scope, $strategy, $variance, $name, $bound, $default); } if ($bound instanceof ObjectShapeType && ($boundClass === ObjectShapeType::class || $bound instanceof \PHPStan\Type\Generic\TemplateType)) { return new \PHPStan\Type\Generic\TemplateObjectShapeType($scope, $strategy, $variance, $name, $bound, $default); } if ($bound instanceof StringType && ($boundClass === StringType::class || $bound instanceof \PHPStan\Type\Generic\TemplateType)) { return new \PHPStan\Type\Generic\TemplateStringType($scope, $strategy, $variance, $name, $bound, $default); } if ($bound instanceof ConstantStringType && ($boundClass === ConstantStringType::class || $bound instanceof \PHPStan\Type\Generic\TemplateType)) { return new \PHPStan\Type\Generic\TemplateConstantStringType($scope, $strategy, $variance, $name, $bound, $default); } if ($bound instanceof IntegerType && ($boundClass === IntegerType::class || $bound instanceof \PHPStan\Type\Generic\TemplateType)) { return new \PHPStan\Type\Generic\TemplateIntegerType($scope, $strategy, $variance, $name, $bound, $default); } if ($bound instanceof ConstantIntegerType && ($boundClass === ConstantIntegerType::class || $bound instanceof \PHPStan\Type\Generic\TemplateType)) { return new \PHPStan\Type\Generic\TemplateConstantIntegerType($scope, $strategy, $variance, $name, $bound, $default); } if ($bound instanceof FloatType && ($boundClass === FloatType::class || $bound instanceof \PHPStan\Type\Generic\TemplateType)) { return new \PHPStan\Type\Generic\TemplateFloatType($scope, $strategy, $variance, $name, $bound, $default); } if ($bound instanceof BooleanType && ($boundClass === BooleanType::class || $bound instanceof \PHPStan\Type\Generic\TemplateType)) { return new \PHPStan\Type\Generic\TemplateBooleanType($scope, $strategy, $variance, $name, $bound, $default); } if ($bound instanceof MixedType && ($boundClass === MixedType::class || $bound instanceof \PHPStan\Type\Generic\TemplateType)) { return new \PHPStan\Type\Generic\TemplateMixedType($scope, $strategy, $variance, $name, $bound, $default); } if ($bound instanceof UnionType) { if ($boundClass === UnionType::class || $bound instanceof \PHPStan\Type\Generic\TemplateUnionType) { return new \PHPStan\Type\Generic\TemplateUnionType($scope, $strategy, $variance, $name, $bound, $default); } if ($bound instanceof BenevolentUnionType) { return new \PHPStan\Type\Generic\TemplateBenevolentUnionType($scope, $strategy, $variance, $name, $bound, $default); } } if ($bound instanceof IntersectionType) { return new \PHPStan\Type\Generic\TemplateIntersectionType($scope, $strategy, $variance, $name, $bound, $default); } if ($bound instanceof KeyOfType && ($boundClass === KeyOfType::class || $bound instanceof \PHPStan\Type\Generic\TemplateType)) { return new \PHPStan\Type\Generic\TemplateKeyOfType($scope, $strategy, $variance, $name, $bound, $default); } return new \PHPStan\Type\Generic\TemplateMixedType($scope, $strategy, $variance, $name, new MixedType(\true), $default); } public static function fromTemplateTag(\PHPStan\Type\Generic\TemplateTypeScope $scope, TemplateTag $tag) : \PHPStan\Type\Generic\TemplateType { return self::create($scope, $tag->getName(), $tag->getBound(), $tag->getVariance(), null, $tag->getDefault()); } } <?php declare (strict_types=1); namespace PHPStan\Type\Generic; use PHPStan\Type\Type; use PHPStan\Type\VerbosityLevel; use function sprintf; final class TypeProjectionHelper { public static function describe(Type $type, ?\PHPStan\Type\Generic\TemplateTypeVariance $variance, VerbosityLevel $level) : string { $describedType = $type->describe($level); if ($variance === null || $variance->invariant()) { return $describedType; } if ($variance->bivariant()) { return '*'; } return sprintf('%s %s', $variance->describe(), $describedType); } } <?php declare (strict_types=1); namespace PHPStan\Type\Generic; use PHPStan\Type\ArrayType; use PHPStan\Type\Traits\UndecidedComparisonCompoundTypeTrait; use PHPStan\Type\Type; /** @api */ final class TemplateArrayType extends ArrayType implements \PHPStan\Type\Generic\TemplateType { /** @use TemplateTypeTrait<ArrayType> */ use \PHPStan\Type\Generic\TemplateTypeTrait; use UndecidedComparisonCompoundTypeTrait; /** * @param non-empty-string $name */ public function __construct(\PHPStan\Type\Generic\TemplateTypeScope $scope, \PHPStan\Type\Generic\TemplateTypeStrategy $templateTypeStrategy, \PHPStan\Type\Generic\TemplateTypeVariance $templateTypeVariance, string $name, ArrayType $bound, ?Type $default) { parent::__construct($bound->getKeyType(), $bound->getItemType()); $this->scope = $scope; $this->strategy = $templateTypeStrategy; $this->variance = $templateTypeVariance; $this->name = $name; $this->bound = $bound; $this->default = $default; } protected function shouldGeneralizeInferredType() : bool { return \false; } } <?php declare (strict_types=1); namespace PHPStan\Type\Generic; use PHPStan\Type\IntegerType; use PHPStan\Type\Traits\UndecidedComparisonCompoundTypeTrait; use PHPStan\Type\Type; /** @api */ final class TemplateIntegerType extends IntegerType implements \PHPStan\Type\Generic\TemplateType { /** @use TemplateTypeTrait<IntegerType> */ use \PHPStan\Type\Generic\TemplateTypeTrait; use UndecidedComparisonCompoundTypeTrait; /** * @param non-empty-string $name */ public function __construct(\PHPStan\Type\Generic\TemplateTypeScope $scope, \PHPStan\Type\Generic\TemplateTypeStrategy $templateTypeStrategy, \PHPStan\Type\Generic\TemplateTypeVariance $templateTypeVariance, string $name, IntegerType $bound, ?Type $default) { parent::__construct(); $this->scope = $scope; $this->strategy = $templateTypeStrategy; $this->variance = $templateTypeVariance; $this->name = $name; $this->bound = $bound; $this->default = $default; } protected function shouldGeneralizeInferredType() : bool { return \false; } } <?php declare (strict_types=1); namespace PHPStan\Type\Generic; use PHPStan\PhpDocParser\Ast\Type\GenericTypeNode; use PHPStan\ShouldNotHappenException; use PHPStan\TrinaryLogic; use PHPStan\Type\AcceptsResult; use PHPStan\Type\BenevolentUnionType; use PHPStan\Type\MixedType; use PHPStan\Type\NeverType; use PHPStan\Type\Type; use function sprintf; /** * @api * @final */ class TemplateTypeVariance { /** * @var int */ private $value; private const INVARIANT = 1; private const COVARIANT = 2; private const CONTRAVARIANT = 3; private const STATIC = 4; private const BIVARIANT = 5; /** @var self[] */ private static $registry; /** * @var bool */ private static $invarianceCompositionEnabled = \false; private function __construct(int $value) { $this->value = $value; } private static function create(int $value) : self { self::$registry[$value] = self::$registry[$value] ?? new self($value); return self::$registry[$value]; } public static function createInvariant() : self { return self::create(self::INVARIANT); } public static function createCovariant() : self { return self::create(self::COVARIANT); } public static function createContravariant() : self { return self::create(self::CONTRAVARIANT); } public static function createStatic() : self { return self::create(self::STATIC); } public static function createBivariant() : self { return self::create(self::BIVARIANT); } public function invariant() : bool { return $this->value === self::INVARIANT; } public function covariant() : bool { return $this->value === self::COVARIANT; } public function contravariant() : bool { return $this->value === self::CONTRAVARIANT; } public function static() : bool { return $this->value === self::STATIC; } public function bivariant() : bool { return $this->value === self::BIVARIANT; } public function compose(self $other) : self { if ($this->contravariant()) { if ($other->contravariant()) { return self::createCovariant(); } if ($other->covariant()) { return self::createContravariant(); } if ($other->bivariant()) { return self::createBivariant(); } return self::createInvariant(); } if ($this->covariant()) { if ($other->contravariant()) { return self::createContravariant(); } if ($other->covariant()) { return self::createCovariant(); } if ($other->bivariant()) { return self::createBivariant(); } return self::createInvariant(); } if (self::$invarianceCompositionEnabled && $this->invariant()) { return self::createInvariant(); } if ($this->bivariant()) { return self::createBivariant(); } return $other; } public function isValidVariance(Type $a, Type $b) : TrinaryLogic { return $this->isValidVarianceWithReason(null, $a, $b)->result; } public function isValidVarianceWithReason(?\PHPStan\Type\Generic\TemplateType $templateType, Type $a, Type $b) : AcceptsResult { if ($b instanceof NeverType) { return AcceptsResult::createYes(); } if ($a instanceof MixedType && !$a instanceof \PHPStan\Type\Generic\TemplateType) { return AcceptsResult::createYes(); } if ($a instanceof BenevolentUnionType) { if (!$a->isSuperTypeOf($b)->no()) { return AcceptsResult::createYes(); } } if ($b instanceof BenevolentUnionType) { if (!$b->isSuperTypeOf($a)->no()) { return AcceptsResult::createYes(); } } if ($b instanceof MixedType && !$b instanceof \PHPStan\Type\Generic\TemplateType) { return AcceptsResult::createYes(); } if ($this->invariant()) { $result = $a->equals($b); $reasons = []; if (!$result) { if ($templateType !== null && $templateType->getScope()->getClassName() !== null && $a->isSuperTypeOf($b)->yes()) { $reasons[] = sprintf('Template type %s on class %s is not covariant. Learn more: <fg=cyan>https://phpstan.org/blog/whats-up-with-template-covariant</>', $templateType->getName(), $templateType->getScope()->getClassName()); } } return new AcceptsResult(TrinaryLogic::createFromBoolean($result), $reasons); } if ($this->covariant()) { return $a->isSuperTypeOfWithReason($b)->toAcceptsResult(); } if ($this->contravariant()) { return $b->isSuperTypeOfWithReason($a)->toAcceptsResult(); } if ($this->bivariant()) { return AcceptsResult::createYes(); } throw new ShouldNotHappenException(); } public function equals(self $other) : bool { return $other->value === $this->value; } public function validPosition(self $other) : bool { return $other->value === $this->value || $other->invariant() || $this->bivariant() || $this->static(); } public function describe() : string { switch ($this->value) { case self::INVARIANT: return 'invariant'; case self::COVARIANT: return 'covariant'; case self::CONTRAVARIANT: return 'contravariant'; case self::STATIC: return 'static'; case self::BIVARIANT: return 'bivariant'; } throw new ShouldNotHappenException(); } /** * @return GenericTypeNode::VARIANCE_* */ public function toPhpDocNodeVariance() : string { switch ($this->value) { case self::INVARIANT: return GenericTypeNode::VARIANCE_INVARIANT; case self::COVARIANT: return GenericTypeNode::VARIANCE_COVARIANT; case self::CONTRAVARIANT: return GenericTypeNode::VARIANCE_CONTRAVARIANT; case self::BIVARIANT: return GenericTypeNode::VARIANCE_BIVARIANT; } throw new ShouldNotHappenException(); } /** * @param array{value: int} $properties */ public static function __set_state(array $properties) : self { return new self($properties['value']); } public static function setInvarianceCompositionEnabled(bool $enabled) : void { self::$invarianceCompositionEnabled = $enabled; } } <?php declare (strict_types=1); namespace PHPStan\Type\Generic; use PHPStan\Type\Constant\ConstantArrayType; use PHPStan\Type\Traits\UndecidedComparisonCompoundTypeTrait; use PHPStan\Type\Type; /** @api */ final class TemplateConstantArrayType extends ConstantArrayType implements \PHPStan\Type\Generic\TemplateType { /** @use TemplateTypeTrait<ConstantArrayType> */ use \PHPStan\Type\Generic\TemplateTypeTrait; use UndecidedComparisonCompoundTypeTrait; /** * @param non-empty-string $name */ public function __construct(\PHPStan\Type\Generic\TemplateTypeScope $scope, \PHPStan\Type\Generic\TemplateTypeStrategy $templateTypeStrategy, \PHPStan\Type\Generic\TemplateTypeVariance $templateTypeVariance, string $name, ConstantArrayType $bound, ?Type $default) { parent::__construct($bound->getKeyTypes(), $bound->getValueTypes(), $bound->getNextAutoIndexes(), $bound->getOptionalKeys(), $bound->isList()); $this->scope = $scope; $this->strategy = $templateTypeStrategy; $this->variance = $templateTypeVariance; $this->name = $name; $this->bound = $bound; $this->default = $default; } protected function shouldGeneralizeInferredType() : bool { return \false; } } <?php declare (strict_types=1); namespace PHPStan\Type\Generic; use PHPStan\Type\FloatType; use PHPStan\Type\Traits\UndecidedComparisonCompoundTypeTrait; use PHPStan\Type\Type; /** @api */ final class TemplateFloatType extends FloatType implements \PHPStan\Type\Generic\TemplateType { /** @use TemplateTypeTrait<FloatType> */ use \PHPStan\Type\Generic\TemplateTypeTrait; use UndecidedComparisonCompoundTypeTrait; /** * @param non-empty-string $name */ public function __construct(\PHPStan\Type\Generic\TemplateTypeScope $scope, \PHPStan\Type\Generic\TemplateTypeStrategy $templateTypeStrategy, \PHPStan\Type\Generic\TemplateTypeVariance $templateTypeVariance, string $name, FloatType $bound, ?Type $default) { parent::__construct(); $this->scope = $scope; $this->strategy = $templateTypeStrategy; $this->variance = $templateTypeVariance; $this->name = $name; $this->bound = $bound; $this->default = $default; } protected function shouldGeneralizeInferredType() : bool { return \false; } } <?php declare (strict_types=1); namespace PHPStan\Type\Generic; use PHPStan\TrinaryLogic; use PHPStan\Type\AcceptsResult; use PHPStan\Type\CompoundType; use PHPStan\Type\Type; /** @api */ interface TemplateType extends CompoundType { /** @return non-empty-string */ public function getName() : string; public function getScope() : \PHPStan\Type\Generic\TemplateTypeScope; public function getBound() : Type; public function getDefault() : ?Type; public function toArgument() : \PHPStan\Type\Generic\TemplateType; public function isArgument() : bool; public function isValidVariance(Type $a, Type $b) : TrinaryLogic; public function isValidVarianceWithReason(Type $a, Type $b) : AcceptsResult; public function getVariance() : \PHPStan\Type\Generic\TemplateTypeVariance; public function getStrategy() : \PHPStan\Type\Generic\TemplateTypeStrategy; } <?php declare (strict_types=1); namespace PHPStan\Type\Generic; use PHPStan\Type\BooleanType; use PHPStan\Type\Traits\UndecidedComparisonCompoundTypeTrait; use PHPStan\Type\Type; /** @api */ final class TemplateBooleanType extends BooleanType implements \PHPStan\Type\Generic\TemplateType { /** @use TemplateTypeTrait<BooleanType> */ use \PHPStan\Type\Generic\TemplateTypeTrait; use UndecidedComparisonCompoundTypeTrait; /** * @param non-empty-string $name */ public function __construct(\PHPStan\Type\Generic\TemplateTypeScope $scope, \PHPStan\Type\Generic\TemplateTypeStrategy $templateTypeStrategy, \PHPStan\Type\Generic\TemplateTypeVariance $templateTypeVariance, string $name, BooleanType $bound, ?Type $default) { parent::__construct(); $this->scope = $scope; $this->strategy = $templateTypeStrategy; $this->variance = $templateTypeVariance; $this->name = $name; $this->bound = $bound; $this->default = $default; } protected function shouldGeneralizeInferredType() : bool { return \false; } } <?php declare (strict_types=1); namespace PHPStan\Type\Generic; use PHPStan\Type\AcceptsResult; use PHPStan\Type\Type; interface TemplateTypeStrategy { public function accepts(\PHPStan\Type\Generic\TemplateType $left, Type $right, bool $strictTypes) : AcceptsResult; public function isArgument() : bool; } <?php declare (strict_types=1); namespace PHPStan\Type\Generic; use function sprintf; final class TemplateTypeScope { /** * @var ?string */ private $className; /** * @var ?string */ private $functionName; public static function createWithAnonymousFunction() : self { return new self(null, null); } public static function createWithFunction(string $functionName) : self { return new self(null, $functionName); } public static function createWithMethod(string $className, string $functionName) : self { return new self($className, $functionName); } public static function createWithClass(string $className) : self { return new self($className, null); } private function __construct(?string $className, ?string $functionName) { $this->className = $className; $this->functionName = $functionName; } /** @api */ public function getClassName() : ?string { return $this->className; } /** @api */ public function getFunctionName() : ?string { return $this->functionName; } /** @api */ public function equals(self $other) : bool { return $this->className === $other->className && $this->functionName === $other->functionName; } /** @api */ public function describe() : string { if ($this->className === null && $this->functionName === null) { return 'anonymous function'; } if ($this->className === null) { return sprintf('function %s()', $this->functionName); } if ($this->functionName === null) { return sprintf('class %s', $this->className); } return sprintf('method %s::%s()', $this->className, $this->functionName); } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : self { return new self($properties['className'], $properties['functionName']); } } <?php declare (strict_types=1); namespace PHPStan\Type\Generic; use function array_key_exists; /** * @api * @final */ class TemplateTypeVarianceMap { /** * @var array<string, TemplateTypeVariance> */ private $variances; /** * @var ?TemplateTypeVarianceMap */ private static $empty = null; /** * @api * @param array<string, TemplateTypeVariance> $variances */ public function __construct(array $variances) { $this->variances = $variances; } public static function createEmpty() : self { $empty = self::$empty; if ($empty !== null) { return $empty; } $empty = new self([]); self::$empty = $empty; return $empty; } /** @return array<string, TemplateTypeVariance> */ public function getVariances() : array { return $this->variances; } public function hasVariance(string $name) : bool { return array_key_exists($name, $this->getVariances()); } public function getVariance(string $name) : ?\PHPStan\Type\Generic\TemplateTypeVariance { return $this->getVariances()[$name] ?? null; } } <?php declare (strict_types=1); namespace PHPStan\Type\Generic; use PHPStan\Type\BenevolentUnionType; use PHPStan\Type\Type; /** @api */ final class TemplateBenevolentUnionType extends BenevolentUnionType implements \PHPStan\Type\Generic\TemplateType { /** @use TemplateTypeTrait<BenevolentUnionType> */ use \PHPStan\Type\Generic\TemplateTypeTrait; /** * @param non-empty-string $name */ public function __construct(\PHPStan\Type\Generic\TemplateTypeScope $scope, \PHPStan\Type\Generic\TemplateTypeStrategy $templateTypeStrategy, \PHPStan\Type\Generic\TemplateTypeVariance $templateTypeVariance, string $name, BenevolentUnionType $bound, ?Type $default) { parent::__construct($bound->getTypes()); $this->scope = $scope; $this->strategy = $templateTypeStrategy; $this->variance = $templateTypeVariance; $this->name = $name; $this->bound = $bound; $this->default = $default; } /** @param Type[] $types */ public function withTypes(array $types) : self { return new self($this->scope, $this->strategy, $this->variance, $this->name, new BenevolentUnionType($types), $this->default); } public function filterTypes(callable $filterCb) : Type { $result = parent::filterTypes($filterCb); if (!$result instanceof \PHPStan\Type\Generic\TemplateType) { return \PHPStan\Type\Generic\TemplateTypeFactory::create($this->getScope(), $this->getName(), $result, $this->getVariance(), $this->getStrategy(), $this->getDefault()); } return $result; } } <?php declare (strict_types=1); namespace PHPStan\Type\Generic; use PHPStan\DependencyInjection\BleedingEdgeToggle; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\TrinaryLogic; use PHPStan\Type\AcceptsResult; use PHPStan\Type\GeneralizePrecision; use PHPStan\Type\IntersectionType; use PHPStan\Type\IsSuperTypeOfResult; use PHPStan\Type\MixedType; use PHPStan\Type\NeverType; use PHPStan\Type\SubtractableType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\TypeUtils; use PHPStan\Type\UnionType; use PHPStan\Type\VerbosityLevel; use function sprintf; /** * @template TBound of Type */ trait TemplateTypeTrait { /** @var non-empty-string */ private $name; /** * @var TemplateTypeScope */ private $scope; /** * @var TemplateTypeStrategy */ private $strategy; /** * @var TemplateTypeVariance */ private $variance; /** @var TBound */ private $bound; /** * @var ?Type */ private $default; /** @return non-empty-string */ public function getName() : string { return $this->name; } public function getScope() : \PHPStan\Type\Generic\TemplateTypeScope { return $this->scope; } /** @return TBound */ public function getBound() : Type { return $this->bound; } public function getDefault() : ?Type { return $this->default; } public function describe(VerbosityLevel $level) : string { $basicDescription = function () use($level) : string { // @phpstan-ignore booleanAnd.alwaysFalse, instanceof.alwaysFalse, booleanAnd.alwaysFalse, instanceof.alwaysFalse, instanceof.alwaysTrue if ($this->bound instanceof MixedType && $this->bound->getSubtractedType() === null && !$this->bound instanceof \PHPStan\Type\Generic\TemplateMixedType) { $boundDescription = ''; } else { $boundDescription = sprintf(' of %s', $this->bound->describe($level)); } $defaultDescription = $this->default !== null ? sprintf(' = %s', $this->default->describe($level)) : ''; return sprintf('%s%s%s', $this->name, $boundDescription, $defaultDescription); }; return $level->handle($basicDescription, $basicDescription, function () use($basicDescription) : string { return sprintf('%s (%s, %s)', $basicDescription(), $this->scope->describe(), $this->isArgument() ? 'argument' : 'parameter'); }); } public function isArgument() : bool { return $this->strategy->isArgument(); } public function toArgument() : \PHPStan\Type\Generic\TemplateType { return new self($this->scope, new \PHPStan\Type\Generic\TemplateTypeArgumentStrategy(), $this->variance, $this->name, \PHPStan\Type\Generic\TemplateTypeHelper::toArgument($this->getBound()), $this->default !== null ? \PHPStan\Type\Generic\TemplateTypeHelper::toArgument($this->default) : null); } public function isValidVariance(Type $a, Type $b) : TrinaryLogic { return $this->isValidVarianceWithReason($a, $b)->result; } public function isValidVarianceWithReason(Type $a, Type $b) : AcceptsResult { return $this->variance->isValidVarianceWithReason($this, $a, $b); } public function subtract(Type $typeToRemove) : Type { $removedBound = TypeCombinator::remove($this->getBound(), $typeToRemove); return \PHPStan\Type\Generic\TemplateTypeFactory::create($this->getScope(), $this->getName(), $removedBound, $this->getVariance(), $this->getStrategy(), $this->getDefault()); } public function getTypeWithoutSubtractedType() : Type { $bound = $this->getBound(); if (!$bound instanceof SubtractableType) { // @phpstan-ignore instanceof.alwaysTrue return $this; } return \PHPStan\Type\Generic\TemplateTypeFactory::create($this->getScope(), $this->getName(), $bound->getTypeWithoutSubtractedType(), $this->getVariance(), $this->getStrategy(), $this->getDefault()); } public function changeSubtractedType(?Type $subtractedType) : Type { $bound = $this->getBound(); if (!$bound instanceof SubtractableType) { // @phpstan-ignore instanceof.alwaysTrue return $this; } return \PHPStan\Type\Generic\TemplateTypeFactory::create($this->getScope(), $this->getName(), $bound->changeSubtractedType($subtractedType), $this->getVariance(), $this->getStrategy(), $this->getDefault()); } public function getSubtractedType() : ?Type { $bound = $this->getBound(); if (!$bound instanceof SubtractableType) { // @phpstan-ignore instanceof.alwaysTrue return null; } return $bound->getSubtractedType(); } public function equals(Type $type) : bool { return $type instanceof self && $type->scope->equals($this->scope) && $type->name === $this->name && $this->bound->equals($type->bound) && ($this->default === null && $type->default === null || $this->default !== null && $type->default !== null && $this->default->equals($type->default)); } public function isAcceptedBy(Type $acceptingType, bool $strictTypes) : TrinaryLogic { return $this->isAcceptedWithReasonBy($acceptingType, $strictTypes)->result; } public function isAcceptedWithReasonBy(Type $acceptingType, bool $strictTypes) : AcceptsResult { /** @var TBound $bound */ $bound = $this->getBound(); if (!$acceptingType instanceof $bound && !$this instanceof $acceptingType && !$acceptingType instanceof \PHPStan\Type\Generic\TemplateType && ($acceptingType instanceof UnionType || $acceptingType instanceof IntersectionType)) { return $acceptingType->acceptsWithReason($this, $strictTypes); } if (!$acceptingType instanceof \PHPStan\Type\Generic\TemplateType) { return $acceptingType->acceptsWithReason($this->getBound(), $strictTypes); } if ($this->getScope()->equals($acceptingType->getScope()) && $this->getName() === $acceptingType->getName()) { return $acceptingType->getBound()->acceptsWithReason($this->getBound(), $strictTypes); } return $acceptingType->getBound()->acceptsWithReason($this->getBound(), $strictTypes)->and(new AcceptsResult(TrinaryLogic::createMaybe(), [])); } public function accepts(Type $type, bool $strictTypes) : TrinaryLogic { return $this->acceptsWithReason($type, $strictTypes)->result; } public function acceptsWithReason(Type $type, bool $strictTypes) : AcceptsResult { return $this->strategy->accepts($this, $type, $strictTypes); } public function isSuperTypeOf(Type $type) : TrinaryLogic { return $this->isSuperTypeOfWithReason($type)->result; } public function isSuperTypeOfWithReason(Type $type) : IsSuperTypeOfResult { if ($type instanceof \PHPStan\Type\Generic\TemplateType || $type instanceof IntersectionType) { return $type->isSubTypeOfWithReason($this); } if ($type instanceof NeverType) { return IsSuperTypeOfResult::createYes(); } return $this->getBound()->isSuperTypeOfWithReason($type)->and(IsSuperTypeOfResult::createMaybe()); } public function isSubTypeOf(Type $type) : TrinaryLogic { return $this->isSubTypeOfWithReason($type)->result; } public function isSubTypeOfWithReason(Type $type) : IsSuperTypeOfResult { /** @var TBound $bound */ $bound = $this->getBound(); if (!$type instanceof $bound && !$this instanceof $type && !$type instanceof \PHPStan\Type\Generic\TemplateType && ($type instanceof UnionType || $type instanceof IntersectionType)) { return $type->isSuperTypeOfWithReason($this); } if (!$type instanceof \PHPStan\Type\Generic\TemplateType) { return $type->isSuperTypeOfWithReason($this->getBound()); } if ($this->getScope()->equals($type->getScope()) && $this->getName() === $type->getName()) { return $type->getBound()->isSuperTypeOfWithReason($this->getBound()); } return $type->getBound()->isSuperTypeOfWithReason($this->getBound())->and(IsSuperTypeOfResult::createMaybe()); } public function toArrayKey() : Type { return $this; } public function inferTemplateTypes(Type $receivedType) : \PHPStan\Type\Generic\TemplateTypeMap { if ($receivedType instanceof \PHPStan\Type\Generic\TemplateType && $this->getBound()->isSuperTypeOf($receivedType->getBound())->yes()) { return new \PHPStan\Type\Generic\TemplateTypeMap([$this->name => $receivedType]); } $map = $this->getBound()->inferTemplateTypes($receivedType); $resolvedBound = TypeUtils::resolveLateResolvableTypes(\PHPStan\Type\Generic\TemplateTypeHelper::resolveTemplateTypes($this->getBound(), $map, \PHPStan\Type\Generic\TemplateTypeVarianceMap::createEmpty(), \PHPStan\Type\Generic\TemplateTypeVariance::createStatic())); if ($resolvedBound->isSuperTypeOf($receivedType)->yes()) { if (!BleedingEdgeToggle::isBleedingEdge() && $this->shouldGeneralizeInferredType()) { $generalizedType = $receivedType->generalize(GeneralizePrecision::templateArgument()); if ($resolvedBound->isSuperTypeOf($generalizedType)->yes()) { $receivedType = $generalizedType; } } return (new \PHPStan\Type\Generic\TemplateTypeMap([$this->name => $receivedType]))->union($map); } return $map; } public function getReferencedTemplateTypes(\PHPStan\Type\Generic\TemplateTypeVariance $positionVariance) : array { return [new \PHPStan\Type\Generic\TemplateTypeReference($this, $positionVariance)]; } public function getVariance() : \PHPStan\Type\Generic\TemplateTypeVariance { return $this->variance; } public function getStrategy() : \PHPStan\Type\Generic\TemplateTypeStrategy { return $this->strategy; } protected function shouldGeneralizeInferredType() : bool { return \true; } public function traverse(callable $cb) : Type { $bound = $cb($this->getBound()); $default = $this->getDefault() !== null ? $cb($this->getDefault()) : null; if ($this->getBound() === $bound && $this->getDefault() === $default) { return $this; } return \PHPStan\Type\Generic\TemplateTypeFactory::create($this->getScope(), $this->getName(), $bound, $this->getVariance(), $this->getStrategy(), $default); } public function traverseSimultaneously(Type $right, callable $cb) : Type { if (!$right instanceof \PHPStan\Type\Generic\TemplateType) { return $this; } $bound = $cb($this->getBound(), $right->getBound()); $default = $this->getDefault() !== null && $right->getDefault() !== null ? $cb($this->getDefault(), $right->getDefault()) : null; if ($this->getBound() === $bound && $this->getDefault() === $default) { return $this; } return \PHPStan\Type\Generic\TemplateTypeFactory::create($this->getScope(), $this->getName(), $bound, $this->getVariance(), $this->getStrategy(), $default); } public function tryRemove(Type $typeToRemove) : ?Type { $bound = TypeCombinator::remove($this->getBound(), $typeToRemove); if ($this->getBound() === $bound) { return null; } return \PHPStan\Type\Generic\TemplateTypeFactory::create($this->getScope(), $this->getName(), $bound, $this->getVariance(), $this->getStrategy(), $this->getDefault()); } public function toPhpDocNode() : TypeNode { return new IdentifierTypeNode($this->name); } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : Type { return new self($properties['scope'], $properties['strategy'], $properties['variance'], $properties['name'], $properties['bound'], $properties['default'] ?? null); } } <?php declare (strict_types=1); namespace PHPStan\Type\Generic; use PHPStan\Reflection\ParametersAcceptor; use PHPStan\Type\ErrorType; use PHPStan\Type\GeneralizePrecision; use PHPStan\Type\NonAcceptingNeverType; use PHPStan\Type\Type; use PHPStan\Type\TypeTraverser; use PHPStan\Type\VerbosityLevel; final class TemplateTypeHelper { /** * Replaces template types with standin types */ public static function resolveTemplateTypes(Type $type, \PHPStan\Type\Generic\TemplateTypeMap $standins, \PHPStan\Type\Generic\TemplateTypeVarianceMap $callSiteVariances, \PHPStan\Type\Generic\TemplateTypeVariance $positionVariance, bool $keepErrorTypes = \false) : Type { $references = $type->getReferencedTemplateTypes($positionVariance); return TypeTraverser::map($type, static function (Type $type, callable $traverse) use($standins, $references, $callSiteVariances, $keepErrorTypes) : Type { if ($type instanceof \PHPStan\Type\Generic\TemplateType && !$type->isArgument()) { $newType = $standins->getType($type->getName()); $variance = \PHPStan\Type\Generic\TemplateTypeVariance::createInvariant(); foreach ($references as $reference) { // this uses identity to distinguish between different occurrences of the same template type // see https://github.com/phpstan/phpstan-src/pull/2485#discussion_r1328555397 for details if ($reference->getType() === $type) { $variance = $reference->getPositionVariance(); break; } } if ($newType === null) { return $traverse($type); } if ($newType instanceof ErrorType && !$keepErrorTypes) { return $traverse($type->getDefault() ?? $type->getBound()); } $callSiteVariance = $callSiteVariances->getVariance($type->getName()); if ($callSiteVariance === null || $callSiteVariance->invariant()) { return $newType; } if (!$callSiteVariance->covariant() && $variance->covariant()) { return $traverse($type->getBound()); } if (!$callSiteVariance->contravariant() && $variance->contravariant()) { return new NonAcceptingNeverType(); } return $newType; } return $traverse($type); }); } public static function resolveToDefaults(Type $type) : Type { return TypeTraverser::map($type, static function (Type $type, callable $traverse) : Type { if ($type instanceof \PHPStan\Type\Generic\TemplateType) { return $traverse($type->getDefault() ?? $type->getBound()); } return $traverse($type); }); } public static function resolveToBounds(Type $type) : Type { return TypeTraverser::map($type, static function (Type $type, callable $traverse) : Type { if ($type instanceof \PHPStan\Type\Generic\TemplateType) { return $traverse($type->getBound()); } return $traverse($type); }); } /** * @template T of Type * @param T $type * @return T */ public static function toArgument(Type $type) : Type { $ownedTemplates = []; /** @var T */ return TypeTraverser::map($type, static function (Type $type, callable $traverse) use(&$ownedTemplates) : Type { if ($type instanceof ParametersAcceptor) { $templateTypeMap = $type->getTemplateTypeMap(); foreach ($type->getParameters() as $parameter) { $parameterType = $parameter->getType(); if (!$parameterType instanceof \PHPStan\Type\Generic\TemplateType || !$templateTypeMap->hasType($parameterType->getName())) { continue; } $ownedTemplates[] = $parameterType; } $returnType = $type->getReturnType(); if ($returnType instanceof \PHPStan\Type\Generic\TemplateType && $templateTypeMap->hasType($returnType->getName())) { $ownedTemplates[] = $returnType; } } foreach ($ownedTemplates as $ownedTemplate) { if ($ownedTemplate === $type) { return $traverse($type); } } if ($type instanceof \PHPStan\Type\Generic\TemplateType) { return $traverse($type->toArgument()); } return $traverse($type); }); } public static function generalizeInferredTemplateType(\PHPStan\Type\Generic\TemplateType $templateType, Type $type) : Type { if (!$templateType->getVariance()->covariant()) { $isArrayKey = $templateType->getBound()->describe(VerbosityLevel::precise()) === '(int|string)'; if ($type->isScalar()->yes() && $isArrayKey) { $type = $type->generalize(GeneralizePrecision::templateArgument()); } elseif ($type->isConstantValue()->yes() && (!$templateType->getBound()->isScalar()->yes() || $isArrayKey)) { $type = $type->generalize(GeneralizePrecision::templateArgument()); } } return $type; } } <?php declare (strict_types=1); namespace PHPStan\Type\Generic; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\Traits\UndecidedComparisonCompoundTypeTrait; use PHPStan\Type\Type; /** @api */ final class TemplateConstantStringType extends ConstantStringType implements \PHPStan\Type\Generic\TemplateType { /** @use TemplateTypeTrait<ConstantStringType> */ use \PHPStan\Type\Generic\TemplateTypeTrait; use UndecidedComparisonCompoundTypeTrait; /** * @param non-empty-string $name */ public function __construct(\PHPStan\Type\Generic\TemplateTypeScope $scope, \PHPStan\Type\Generic\TemplateTypeStrategy $templateTypeStrategy, \PHPStan\Type\Generic\TemplateTypeVariance $templateTypeVariance, string $name, ConstantStringType $bound, ?Type $default) { parent::__construct($bound->getValue()); $this->scope = $scope; $this->strategy = $templateTypeStrategy; $this->variance = $templateTypeVariance; $this->name = $name; $this->bound = $bound; $this->default = $default; } protected function shouldGeneralizeInferredType() : bool { return \false; } } <?php declare (strict_types=1); namespace PHPStan\Type\Generic; use PHPStan\Type\ObjectType; use PHPStan\Type\Traits\UndecidedComparisonCompoundTypeTrait; use PHPStan\Type\Type; /** @api */ final class TemplateObjectType extends ObjectType implements \PHPStan\Type\Generic\TemplateType { use UndecidedComparisonCompoundTypeTrait; /** @use TemplateTypeTrait<ObjectType> */ use \PHPStan\Type\Generic\TemplateTypeTrait; /** * @param non-empty-string $name */ public function __construct(\PHPStan\Type\Generic\TemplateTypeScope $scope, \PHPStan\Type\Generic\TemplateTypeStrategy $templateTypeStrategy, \PHPStan\Type\Generic\TemplateTypeVariance $templateTypeVariance, string $name, ObjectType $bound, ?Type $default) { parent::__construct($bound->getClassName()); $this->scope = $scope; $this->strategy = $templateTypeStrategy; $this->variance = $templateTypeVariance; $this->name = $name; $this->bound = $bound; $this->default = $default; } } <?php declare (strict_types=1); namespace PHPStan\Type\Generic; use PHPStan\Type\ObjectWithoutClassType; use PHPStan\Type\Traits\UndecidedComparisonCompoundTypeTrait; use PHPStan\Type\Type; /** @api */ class TemplateObjectWithoutClassType extends ObjectWithoutClassType implements \PHPStan\Type\Generic\TemplateType { use UndecidedComparisonCompoundTypeTrait; /** @use TemplateTypeTrait<ObjectWithoutClassType> */ use \PHPStan\Type\Generic\TemplateTypeTrait; /** * @param non-empty-string $name */ public function __construct(\PHPStan\Type\Generic\TemplateTypeScope $scope, \PHPStan\Type\Generic\TemplateTypeStrategy $templateTypeStrategy, \PHPStan\Type\Generic\TemplateTypeVariance $templateTypeVariance, string $name, ObjectWithoutClassType $bound, ?Type $default) { parent::__construct(); $this->scope = $scope; $this->strategy = $templateTypeStrategy; $this->variance = $templateTypeVariance; $this->name = $name; $this->bound = $bound; $this->default = $default; } } <?php declare (strict_types=1); namespace PHPStan\Type\Generic; use PHPStan\TrinaryLogic; use PHPStan\Type\AcceptsResult; use PHPStan\Type\MixedType; use PHPStan\Type\StrictMixedType; use PHPStan\Type\Type; /** @api */ final class TemplateStrictMixedType extends StrictMixedType implements \PHPStan\Type\Generic\TemplateType { /** @use TemplateTypeTrait<StrictMixedType> */ use \PHPStan\Type\Generic\TemplateTypeTrait; /** * @param non-empty-string $name */ public function __construct(\PHPStan\Type\Generic\TemplateTypeScope $scope, \PHPStan\Type\Generic\TemplateTypeStrategy $templateTypeStrategy, \PHPStan\Type\Generic\TemplateTypeVariance $templateTypeVariance, string $name, StrictMixedType $bound, ?Type $default) { $this->scope = $scope; $this->strategy = $templateTypeStrategy; $this->variance = $templateTypeVariance; $this->name = $name; $this->bound = $bound; $this->default = $default; } public function isSuperTypeOfMixed(MixedType $type) : TrinaryLogic { return $this->isSuperTypeOf($type); } public function isAcceptedBy(Type $acceptingType, bool $strictTypes) : TrinaryLogic { return $this->isAcceptedWithReasonBy($acceptingType, $strictTypes)->result; } public function isAcceptedWithReasonBy(Type $acceptingType, bool $strictTypes) : AcceptsResult { return $this->isSubTypeOfWithReason($acceptingType)->toAcceptsResult(); } } <?php declare (strict_types=1); namespace PHPStan\Type\Generic; use PHPStan\Type\KeyOfType; use PHPStan\Type\Traits\UndecidedComparisonCompoundTypeTrait; use PHPStan\Type\Type; /** @api */ final class TemplateKeyOfType extends KeyOfType implements \PHPStan\Type\Generic\TemplateType { /** @use TemplateTypeTrait<KeyOfType> */ use \PHPStan\Type\Generic\TemplateTypeTrait; use UndecidedComparisonCompoundTypeTrait; /** * @param non-empty-string $name */ public function __construct(\PHPStan\Type\Generic\TemplateTypeScope $scope, \PHPStan\Type\Generic\TemplateTypeStrategy $templateTypeStrategy, \PHPStan\Type\Generic\TemplateTypeVariance $templateTypeVariance, string $name, KeyOfType $bound, ?Type $default) { parent::__construct($bound->getType()); $this->scope = $scope; $this->strategy = $templateTypeStrategy; $this->variance = $templateTypeVariance; $this->name = $name; $this->bound = $bound; $this->default = $default; } protected function getResult() : Type { $result = $this->getBound()->getResult(); return \PHPStan\Type\Generic\TemplateTypeFactory::create($this->getScope(), $this->getName(), $result, $this->getVariance(), $this->getStrategy(), $this->getDefault()); } protected function shouldGeneralizeInferredType() : bool { return \false; } } <?php declare (strict_types=1); namespace PHPStan\Type; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Analyser\SpecifiedTypes; use PHPStan\Analyser\TypeSpecifierContext; use PHPStan\Reflection\FunctionReflection; /** * This is the interface type-specifying extensions implement for functions. * * To register it in the configuration file use the `phpstan.typeSpecifier.functionTypeSpecifyingExtension` service tag: * * ``` * services: * - * class: App\PHPStan\MyExtension * tags: * - phpstan.typeSpecifier.functionTypeSpecifyingExtension * ``` * * Learn more: https://phpstan.org/developing-extensions/type-specifying-extensions * * @api */ interface FunctionTypeSpecifyingExtension { public function isFunctionSupported(FunctionReflection $functionReflection, FuncCall $node, TypeSpecifierContext $context) : bool; public function specifyTypes(FunctionReflection $functionReflection, FuncCall $node, Scope $scope, TypeSpecifierContext $context) : SpecifiedTypes; } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\PhpDocParser\Ast\Type\GenericTypeNode; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\Type\Generic\TemplateTypeVariance; use PHPStan\Type\Traits\LateResolvableTypeTrait; use PHPStan\Type\Traits\NonGeneralizableTypeTrait; use function sprintf; /** @api */ class KeyOfType implements \PHPStan\Type\CompoundType, \PHPStan\Type\LateResolvableType { /** * @var Type */ private $type; use LateResolvableTypeTrait; use NonGeneralizableTypeTrait; public function __construct(\PHPStan\Type\Type $type) { $this->type = $type; } public function getType() : \PHPStan\Type\Type { return $this->type; } public function getReferencedClasses() : array { return $this->type->getReferencedClasses(); } public function getReferencedTemplateTypes(TemplateTypeVariance $positionVariance) : array { return $this->type->getReferencedTemplateTypes($positionVariance); } public function equals(\PHPStan\Type\Type $type) : bool { return $type instanceof self && $this->type->equals($type->type); } public function describe(\PHPStan\Type\VerbosityLevel $level) : string { return sprintf('key-of<%s>', $this->type->describe($level)); } public function isResolvable() : bool { return !\PHPStan\Type\TypeUtils::containsTemplateType($this->type); } protected function getResult() : \PHPStan\Type\Type { return $this->type->getIterableKeyType(); } /** * @param callable(Type): Type $cb */ public function traverse(callable $cb) : \PHPStan\Type\Type { $type = $cb($this->type); if ($this->type === $type) { return $this; } return new self($type); } public function traverseSimultaneously(\PHPStan\Type\Type $right, callable $cb) : \PHPStan\Type\Type { if (!$right instanceof self) { return $this; } $type = $cb($this->type, $right->type); if ($this->type === $type) { return $this; } return new self($type); } public function toPhpDocNode() : TypeNode { return new GenericTypeNode(new IdentifierTypeNode('key-of'), [$this->type->toPhpDocNode()]); } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : \PHPStan\Type\Type { return new self($properties['type']); } } <?php declare (strict_types=1); namespace PHPStan\Type; final class TypeTraverser { /** @var callable(Type $type, callable(Type): Type $traverse): Type */ private $cb; /** * Map a Type recursively * * For every Type instance, the callback can return a new Type, and/or * decide to traverse inner types or to ignore them. * * The following example converts constant strings to objects, while * preserving unions and intersections: * * TypeTraverser::map($type, function (Type $type, callable $traverse): Type { * if ($type instanceof UnionType || $type instanceof IntersectionType) { * // Traverse inner types * return $traverse($type); * } * if ($type instanceof ConstantStringType) { * // Replaces the current type, and don't traverse * return new ObjectType($type->getValue()); * } * // Replaces the current type, and don't traverse * return new MixedType(); * }); * * @api * @param callable(Type $type, callable(Type): Type $traverse): Type $cb */ public static function map(\PHPStan\Type\Type $type, callable $cb) : \PHPStan\Type\Type { $self = new self($cb); return $self->mapInternal($type); } /** @param callable(Type $type, callable(Type): Type $traverse): Type $cb */ private function __construct(callable $cb) { $this->cb = $cb; } /** @internal */ public function mapInternal(\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return ($this->cb)($type, [$this, 'traverseInternal']); } /** @internal */ public function traverseInternal(\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->traverse([$this, 'mapInternal']); } } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\Type\Constant\ConstantFloatType; use PHPStan\Type\Constant\ConstantIntegerType; use function is_float; use function is_int; use function is_numeric; use function is_string; use function pow; final class ExponentiateHelper { public static function exponentiate(\PHPStan\Type\Type $base, \PHPStan\Type\Type $exponent) : \PHPStan\Type\Type { if ($exponent instanceof \PHPStan\Type\UnionType) { $results = []; foreach ($exponent->getTypes() as $unionType) { $results[] = self::exponentiate($base, $unionType); } return \PHPStan\Type\TypeCombinator::union(...$results); } if ($exponent instanceof \PHPStan\Type\NeverType) { return new \PHPStan\Type\NeverType(); } $allowedExponentTypes = new \PHPStan\Type\UnionType([new \PHPStan\Type\IntegerType(), new \PHPStan\Type\FloatType(), new \PHPStan\Type\StringType(), new \PHPStan\Type\BooleanType(), new \PHPStan\Type\NullType()]); if (!$allowedExponentTypes->isSuperTypeOf($exponent)->yes()) { return new \PHPStan\Type\ErrorType(); } if ($base instanceof \PHPStan\Type\ConstantScalarType) { $result = self::exponentiateConstantScalar($base, $exponent); if ($result !== null) { return $result; } } // exponentiation of a float, stays a float $isFloatBase = $base->isFloat()->yes(); $isLooseZero = (new ConstantIntegerType(0))->isSuperTypeOf($exponent->toNumber()); if ($isLooseZero->yes()) { if ($isFloatBase) { return new ConstantFloatType(1); } return new ConstantIntegerType(1); } $isLooseOne = (new ConstantIntegerType(1))->isSuperTypeOf($exponent->toNumber()); if ($isLooseOne->yes()) { $possibleResults = new \PHPStan\Type\UnionType([new \PHPStan\Type\FloatType(), new \PHPStan\Type\IntegerType()]); if ($possibleResults->isSuperTypeOf($base)->yes()) { return $base; } } if ($isFloatBase) { return new \PHPStan\Type\FloatType(); } return new \PHPStan\Type\BenevolentUnionType([new \PHPStan\Type\FloatType(), new \PHPStan\Type\IntegerType()]); } private static function exponentiateConstantScalar(\PHPStan\Type\ConstantScalarType $base, \PHPStan\Type\Type $exponent) : ?\PHPStan\Type\Type { if ($exponent instanceof \PHPStan\Type\IntegerRangeType) { $min = null; $max = null; if ($exponent->getMin() !== null) { $min = self::pow($base->getValue(), $exponent->getMin()); if ($min === null) { return new \PHPStan\Type\ErrorType(); } } if ($exponent->getMax() !== null) { $max = self::pow($base->getValue(), $exponent->getMax()); if ($max === null) { return new \PHPStan\Type\ErrorType(); } } if (!is_float($min) && !is_float($max)) { return \PHPStan\Type\IntegerRangeType::fromInterval($min, $max); } } if ($exponent instanceof \PHPStan\Type\ConstantScalarType) { $result = self::pow($base->getValue(), $exponent->getValue()); if ($result === null) { return new \PHPStan\Type\ErrorType(); } if (is_int($result)) { return new ConstantIntegerType($result); } return new ConstantFloatType($result); } return null; } /** * @return float|int|null * @param mixed $base * @param mixed $exp */ private static function pow($base, $exp) { if (is_string($base) && !is_numeric($base)) { return null; } if (is_string($exp) && !is_numeric($exp)) { return null; } return pow($base, $exp); } } <?php declare (strict_types=1); namespace PHPStan\Type; use PhpParser\Node\Expr\MethodCall; use PHPStan\Analyser\Scope; use PHPStan\Analyser\SpecifiedTypes; use PHPStan\Analyser\TypeSpecifierContext; use PHPStan\Reflection\MethodReflection; /** * This is the interface type-specifying extensions implement for non-static methods. * * To register it in the configuration file use the `phpstan.typeSpecifier.methodTypeSpecifyingExtension` service tag: * * ``` * services: * - * class: App\PHPStan\MyExtension * tags: * - phpstan.typeSpecifier.methodTypeSpecifyingExtension * ``` * * Learn more: https://phpstan.org/developing-extensions/type-specifying-extensions * * @api */ interface MethodTypeSpecifyingExtension { public function getClass() : string; public function isMethodSupported(MethodReflection $methodReflection, MethodCall $node, TypeSpecifierContext $context) : bool; public function specifyTypes(MethodReflection $methodReflection, MethodCall $node, Scope $scope, TypeSpecifierContext $context) : SpecifiedTypes; } <?php declare (strict_types=1); namespace PHPStan\Type\Helper; use PHPStan\PhpDocParser\Ast\ConstExpr\QuoteAwareConstExprStringNode; use PHPStan\PhpDocParser\Ast\Type\ConstTypeNode; use PHPStan\PhpDocParser\Ast\Type\GenericTypeNode; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\Type\CompoundType; use PHPStan\Type\Generic\TemplateTypeVariance; use PHPStan\Type\LateResolvableType; use PHPStan\Type\Traits\LateResolvableTypeTrait; use PHPStan\Type\Traits\NonGeneralizableTypeTrait; use PHPStan\Type\Type; use PHPStan\Type\TypeUtils; use PHPStan\Type\VerbosityLevel; use function sprintf; /** @api */ final class GetTemplateTypeType implements CompoundType, LateResolvableType { /** * @var Type */ private $type; /** * @var class-string */ private $ancestorClassName; /** * @var string */ private $templateTypeName; use LateResolvableTypeTrait; use NonGeneralizableTypeTrait; /** * @param class-string $ancestorClassName */ public function __construct(Type $type, string $ancestorClassName, string $templateTypeName) { $this->type = $type; $this->ancestorClassName = $ancestorClassName; $this->templateTypeName = $templateTypeName; } public function getReferencedClasses() : array { return $this->type->getReferencedClasses(); } public function getReferencedTemplateTypes(TemplateTypeVariance $positionVariance) : array { return $this->type->getReferencedTemplateTypes($positionVariance); } public function equals(Type $type) : bool { return $type instanceof self && $this->type->equals($type->type); } public function describe(VerbosityLevel $level) : string { return sprintf('template-type<%s, %s, %s>', $this->type->describe($level), $this->ancestorClassName, $this->templateTypeName); } public function isResolvable() : bool { return !TypeUtils::containsTemplateType($this->type); } protected function getResult() : Type { return $this->type->getTemplateType($this->ancestorClassName, $this->templateTypeName); } /** * @param callable(Type): Type $cb */ public function traverse(callable $cb) : Type { $type = $cb($this->type); if ($this->type === $type) { return $this; } return new self($type, $this->ancestorClassName, $this->templateTypeName); } public function traverseSimultaneously(Type $right, callable $cb) : Type { if (!$right instanceof self) { return $this; } $type = $cb($this->type, $right->type); if ($this->type === $type) { return $this; } return new self($type, $this->ancestorClassName, $this->templateTypeName); } public function toPhpDocNode() : TypeNode { return new GenericTypeNode(new IdentifierTypeNode('template-type'), [$this->type->toPhpDocNode(), new IdentifierTypeNode($this->ancestorClassName), new ConstTypeNode(new QuoteAwareConstExprStringNode($this->templateTypeName, QuoteAwareConstExprStringNode::SINGLE_QUOTED))]); } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : Type { return new self($properties['type'], $properties['ancestorClassName'], $properties['templateTypeName']); } } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\PhpDocParser\Ast\Type\OffsetAccessTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\PhpDocParser\Printer\Printer; use PHPStan\Type\Generic\TemplateTypeVariance; use PHPStan\Type\Traits\LateResolvableTypeTrait; use PHPStan\Type\Traits\NonGeneralizableTypeTrait; use function array_merge; /** @api */ final class OffsetAccessType implements \PHPStan\Type\CompoundType, \PHPStan\Type\LateResolvableType { /** * @var Type */ private $type; /** * @var Type */ private $offset; use LateResolvableTypeTrait; use NonGeneralizableTypeTrait; public function __construct(\PHPStan\Type\Type $type, \PHPStan\Type\Type $offset) { $this->type = $type; $this->offset = $offset; } public function getReferencedClasses() : array { return array_merge($this->type->getReferencedClasses(), $this->offset->getReferencedClasses()); } public function getObjectClassNames() : array { return []; } public function getObjectClassReflections() : array { return []; } public function getReferencedTemplateTypes(TemplateTypeVariance $positionVariance) : array { return array_merge($this->type->getReferencedTemplateTypes($positionVariance), $this->offset->getReferencedTemplateTypes($positionVariance)); } public function equals(\PHPStan\Type\Type $type) : bool { return $type instanceof self && $this->type->equals($type->type) && $this->offset->equals($type->offset); } public function describe(\PHPStan\Type\VerbosityLevel $level) : string { $printer = new Printer(); return $printer->print($this->toPhpDocNode()); } public function isResolvable() : bool { return !\PHPStan\Type\TypeUtils::containsTemplateType($this->type) && !\PHPStan\Type\TypeUtils::containsTemplateType($this->offset); } protected function getResult() : \PHPStan\Type\Type { return $this->type->getOffsetValueType($this->offset); } /** * @param callable(Type): Type $cb */ public function traverse(callable $cb) : \PHPStan\Type\Type { $type = $cb($this->type); $offset = $cb($this->offset); if ($this->type === $type && $this->offset === $offset) { return $this; } return new self($type, $offset); } public function traverseSimultaneously(\PHPStan\Type\Type $right, callable $cb) : \PHPStan\Type\Type { if (!$right instanceof self) { return $this; } $type = $cb($this->type, $right->type); $offset = $cb($this->offset, $right->offset); if ($this->type === $type && $this->offset === $offset) { return $this; } return new self($type, $offset); } public function toPhpDocNode() : TypeNode { return new OffsetAccessTypeNode($this->type->toPhpDocNode(), $this->offset->toPhpDocNode()); } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : \PHPStan\Type\Type { return new self($properties['type'], $properties['offset']); } } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\Type\Accessory\AccessoryType; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantFloatType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Constant\ConstantStringType; use function count; use function strcasecmp; use function usort; use const PHP_INT_MIN; final class UnionTypeHelper { /** * @param Type[] $types * @return Type[] */ public static function sortTypes(array $types) : array { if (count($types) > 1024) { return $types; } usort($types, static function (\PHPStan\Type\Type $a, \PHPStan\Type\Type $b) : int { if ($a instanceof \PHPStan\Type\NullType) { return 1; } elseif ($b instanceof \PHPStan\Type\NullType) { return -1; } if ($a instanceof AccessoryType) { if ($b instanceof AccessoryType) { return self::compareStrings($a->describe(\PHPStan\Type\VerbosityLevel::value()), $b->describe(\PHPStan\Type\VerbosityLevel::value())); } return 1; } if ($b instanceof AccessoryType) { return -1; } $aIsBool = $a instanceof ConstantBooleanType; $bIsBool = $b instanceof ConstantBooleanType; if ($aIsBool && !$bIsBool) { return 1; } elseif ($bIsBool && !$aIsBool) { return -1; } if ($a instanceof \PHPStan\Type\ConstantScalarType && !$b instanceof \PHPStan\Type\ConstantScalarType) { return -1; } elseif (!$a instanceof \PHPStan\Type\ConstantScalarType && $b instanceof \PHPStan\Type\ConstantScalarType) { return 1; } if (($a instanceof ConstantIntegerType || $a instanceof ConstantFloatType) && ($b instanceof ConstantIntegerType || $b instanceof ConstantFloatType)) { $cmp = $a->getValue() <=> $b->getValue(); if ($cmp !== 0) { return $cmp; } if ($a instanceof ConstantIntegerType && $b instanceof ConstantFloatType) { return -1; } if ($b instanceof ConstantIntegerType && $a instanceof ConstantFloatType) { return 1; } return 0; } if ($a instanceof \PHPStan\Type\IntegerRangeType && $b instanceof \PHPStan\Type\IntegerRangeType) { return ($a->getMin() ?? PHP_INT_MIN) <=> ($b->getMin() ?? PHP_INT_MIN); } if ($a instanceof \PHPStan\Type\IntegerRangeType && $b instanceof \PHPStan\Type\IntegerType) { return 1; } if ($b instanceof \PHPStan\Type\IntegerRangeType && $a instanceof \PHPStan\Type\IntegerType) { return -1; } if ($a instanceof ConstantStringType && $b instanceof ConstantStringType) { return self::compareStrings($a->getValue(), $b->getValue()); } if ($a->isConstantArray()->yes() && $b->isConstantArray()->yes()) { if ($a->isIterableAtLeastOnce()->no()) { if ($b->isIterableAtLeastOnce()->no()) { return 0; } return -1; } elseif ($b->isIterableAtLeastOnce()->no()) { return 1; } return self::compareStrings($a->describe(\PHPStan\Type\VerbosityLevel::value()), $b->describe(\PHPStan\Type\VerbosityLevel::value())); } if (($a instanceof \PHPStan\Type\CallableType || $a instanceof \PHPStan\Type\ClosureType) && ($b instanceof \PHPStan\Type\CallableType || $b instanceof \PHPStan\Type\ClosureType)) { return self::compareStrings($a->describe(\PHPStan\Type\VerbosityLevel::value()), $b->describe(\PHPStan\Type\VerbosityLevel::value())); } if ($a->isString()->yes() && $b->isString()->yes()) { return self::compareStrings($a->describe(\PHPStan\Type\VerbosityLevel::precise()), $b->describe(\PHPStan\Type\VerbosityLevel::precise())); } return self::compareStrings($a->describe(\PHPStan\Type\VerbosityLevel::typeOnly()), $b->describe(\PHPStan\Type\VerbosityLevel::typeOnly())); }); return $types; } private static function compareStrings(string $a, string $b) : int { $cmp = strcasecmp($a, $b); if ($cmp !== 0) { return $cmp; } return $a <=> $b; } } <?php declare (strict_types=1); namespace PHPStan\Type; use Closure; use PhpParser\Parser; use PHPStan\BetterReflection\Identifier\IdentifierType; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionParameter; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionType; use PHPStan\BetterReflection\Reflection\ReflectionParameter as BetterReflectionParameter; use PHPStan\BetterReflection\Reflector\Reflector; use PHPStan\BetterReflection\SourceLocator\Ast\FindReflectionsInTree; use PHPStan\BetterReflection\SourceLocator\Ast\Strategy\NodeToReflection; use PHPStan\BetterReflection\SourceLocator\Located\LocatedSource; use PHPStan\BetterReflection\SourceLocator\SourceStubber\ReflectionSourceStubber; use PHPStan\Reflection\InitializerExprContext; use PHPStan\Reflection\InitializerExprTypeResolver; use PHPStan\Reflection\ParameterReflection; use PHPStan\Reflection\PassedByReference; use PHPStan\ShouldNotHappenException; use ReflectionFunction; use function array_map; use function count; use function str_replace; /** * @api * @final */ class ClosureTypeFactory { /** * @var InitializerExprTypeResolver */ private $initializerExprTypeResolver; /** * @var ReflectionSourceStubber */ private $reflectionSourceStubber; /** * @var Reflector */ private $reflector; /** * @var Parser */ private $parser; public function __construct(InitializerExprTypeResolver $initializerExprTypeResolver, ReflectionSourceStubber $reflectionSourceStubber, Reflector $reflector, Parser $parser) { $this->initializerExprTypeResolver = $initializerExprTypeResolver; $this->reflectionSourceStubber = $reflectionSourceStubber; $this->reflector = $reflector; $this->parser = $parser; } /** * @param Closure(): mixed $closure */ public function fromClosureObject(Closure $closure) : \PHPStan\Type\ClosureType { $stubData = $this->reflectionSourceStubber->generateFunctionStubFromReflection(new ReflectionFunction($closure)); if ($stubData === null) { throw new ShouldNotHappenException('Closure reflection not found.'); } $source = $stubData->getStub(); $source = str_replace('{closure}', 'foo', $source); $locatedSource = new LocatedSource($source, '{closure}', $stubData->getFileName()); $find = new FindReflectionsInTree(new NodeToReflection()); $ast = $this->parser->parse($locatedSource->getSource()); if ($ast === null) { throw new ShouldNotHappenException('Closure reflection not found.'); } /** @var list<\PHPStan\BetterReflection\Reflection\ReflectionFunction> $reflections */ $reflections = $find($this->reflector, $ast, new IdentifierType(IdentifierType::IDENTIFIER_FUNCTION), $locatedSource); if (count($reflections) !== 1) { throw new ShouldNotHappenException('Closure reflection not found.'); } $betterReflectionFunction = $reflections[0]; $parameters = array_map(function (BetterReflectionParameter $parameter) { return new class($parameter, $this->initializerExprTypeResolver) implements ParameterReflection { /** * @var BetterReflectionParameter */ private $reflection; /** * @var InitializerExprTypeResolver */ private $initializerExprTypeResolver; public function __construct(BetterReflectionParameter $reflection, InitializerExprTypeResolver $initializerExprTypeResolver) { $this->reflection = $reflection; $this->initializerExprTypeResolver = $initializerExprTypeResolver; } public function getName() : string { return $this->reflection->getName(); } public function isOptional() : bool { return $this->reflection->isOptional(); } public function getType() : \PHPStan\Type\Type { return \PHPStan\Type\TypehintHelper::decideTypeFromReflection(ReflectionType::fromTypeOrNull($this->reflection->getType()), null, null, $this->reflection->isVariadic()); } public function passedByReference() : PassedByReference { return $this->reflection->isPassedByReference() ? PassedByReference::createCreatesNewVariable() : PassedByReference::createNo(); } public function isVariadic() : bool { return $this->reflection->isVariadic(); } public function getDefaultValue() : ?\PHPStan\Type\Type { if (!$this->reflection->isDefaultValueAvailable()) { return null; } $defaultExpr = $this->reflection->getDefaultValueExpression(); if ($defaultExpr === null) { return null; } return $this->initializerExprTypeResolver->getType($defaultExpr, InitializerExprContext::fromReflectionParameter(new ReflectionParameter($this->reflection))); } }; }, $betterReflectionFunction->getParameters()); return new \PHPStan\Type\ClosureType($parameters, \PHPStan\Type\TypehintHelper::decideTypeFromReflection(ReflectionType::fromTypeOrNull($betterReflectionFunction->getReturnType())), $betterReflectionFunction->isVariadic()); } } <?php declare (strict_types=1); namespace PHPStan\Type; final class ExpressionTypeResolverExtensionRegistry { /** * @var array<ExpressionTypeResolverExtension> */ private $extensions; /** * @param array<ExpressionTypeResolverExtension> $extensions */ public function __construct(array $extensions) { $this->extensions = $extensions; } /** * @return array<ExpressionTypeResolverExtension> */ public function getExtensions() : array { return $this->extensions; } } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\Php\PhpVersion; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\Reflection\ClassMemberAccessAnswerer; use PHPStan\Reflection\ConstantReflection; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\PropertyReflection; use PHPStan\Reflection\Type\UnresolvedMethodPrototypeReflection; use PHPStan\Reflection\Type\UnresolvedPropertyPrototypeReflection; use PHPStan\ShouldNotHappenException; use PHPStan\TrinaryLogic; use PHPStan\Type\Traits\NonGeneralizableTypeTrait; use PHPStan\Type\Traits\NonGenericTypeTrait; use PHPStan\Type\Traits\NonRemoveableTypeTrait; use PHPStan\Type\Traits\UndecidedBooleanTypeTrait; use PHPStan\Type\Traits\UndecidedComparisonCompoundTypeTrait; /** @api */ class NeverType implements \PHPStan\Type\CompoundType { /** * @var bool */ private $isExplicit; use UndecidedBooleanTypeTrait; use NonGenericTypeTrait; use UndecidedComparisonCompoundTypeTrait; use NonRemoveableTypeTrait; use NonGeneralizableTypeTrait; /** @api */ public function __construct(bool $isExplicit = \false) { $this->isExplicit = $isExplicit; } public function isExplicit() : bool { return $this->isExplicit; } /** * @return string[] */ public function getReferencedClasses() : array { return []; } public function getArrays() : array { return []; } public function getConstantArrays() : array { return []; } public function getObjectClassNames() : array { return []; } public function getObjectClassReflections() : array { return []; } public function getConstantStrings() : array { return []; } public function accepts(\PHPStan\Type\Type $type, bool $strictTypes) : TrinaryLogic { return $this->acceptsWithReason($type, $strictTypes)->result; } public function acceptsWithReason(\PHPStan\Type\Type $type, bool $strictTypes) : \PHPStan\Type\AcceptsResult { return \PHPStan\Type\AcceptsResult::createYes(); } public function isSuperTypeOf(\PHPStan\Type\Type $type) : TrinaryLogic { return $this->isSuperTypeOfWithReason($type)->result; } public function isSuperTypeOfWithReason(\PHPStan\Type\Type $type) : \PHPStan\Type\IsSuperTypeOfResult { if ($type instanceof self) { return \PHPStan\Type\IsSuperTypeOfResult::createYes(); } return \PHPStan\Type\IsSuperTypeOfResult::createNo(); } public function equals(\PHPStan\Type\Type $type) : bool { return $type instanceof self; } public function isSubTypeOf(\PHPStan\Type\Type $otherType) : TrinaryLogic { return $this->isSubTypeOfWithReason($otherType)->result; } public function isSubTypeOfWithReason(\PHPStan\Type\Type $otherType) : \PHPStan\Type\IsSuperTypeOfResult { return \PHPStan\Type\IsSuperTypeOfResult::createYes(); } public function isAcceptedBy(\PHPStan\Type\Type $acceptingType, bool $strictTypes) : TrinaryLogic { return $this->isAcceptedWithReasonBy($acceptingType, $strictTypes)->result; } public function isAcceptedWithReasonBy(\PHPStan\Type\Type $acceptingType, bool $strictTypes) : \PHPStan\Type\AcceptsResult { return $this->isSubTypeOfWithReason($acceptingType)->toAcceptsResult(); } public function describe(\PHPStan\Type\VerbosityLevel $level) : string { return '*NEVER*'; } public function getTemplateType(string $ancestorClassName, string $templateTypeName) : \PHPStan\Type\Type { return new \PHPStan\Type\NeverType(); } public function isObject() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isEnum() : TrinaryLogic { return TrinaryLogic::createNo(); } public function canAccessProperties() : TrinaryLogic { return TrinaryLogic::createYes(); } public function hasProperty(string $propertyName) : TrinaryLogic { return TrinaryLogic::createNo(); } public function getProperty(string $propertyName, ClassMemberAccessAnswerer $scope) : PropertyReflection { throw new ShouldNotHappenException(); } public function getUnresolvedPropertyPrototype(string $propertyName, ClassMemberAccessAnswerer $scope) : UnresolvedPropertyPrototypeReflection { throw new ShouldNotHappenException(); } public function canCallMethods() : TrinaryLogic { return TrinaryLogic::createYes(); } public function hasMethod(string $methodName) : TrinaryLogic { return TrinaryLogic::createNo(); } public function getMethod(string $methodName, ClassMemberAccessAnswerer $scope) : ExtendedMethodReflection { throw new ShouldNotHappenException(); } public function getUnresolvedMethodPrototype(string $methodName, ClassMemberAccessAnswerer $scope) : UnresolvedMethodPrototypeReflection { throw new ShouldNotHappenException(); } public function canAccessConstants() : TrinaryLogic { return TrinaryLogic::createYes(); } public function hasConstant(string $constantName) : TrinaryLogic { return TrinaryLogic::createNo(); } public function getConstant(string $constantName) : ConstantReflection { throw new ShouldNotHappenException(); } public function isIterable() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isIterableAtLeastOnce() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getArraySize() : \PHPStan\Type\Type { return new \PHPStan\Type\NeverType(); } public function getIterableKeyType() : \PHPStan\Type\Type { return new \PHPStan\Type\NeverType(); } public function getFirstIterableKeyType() : \PHPStan\Type\Type { return new \PHPStan\Type\NeverType(); } public function getLastIterableKeyType() : \PHPStan\Type\Type { return new \PHPStan\Type\NeverType(); } public function getIterableValueType() : \PHPStan\Type\Type { return new \PHPStan\Type\NeverType(); } public function getFirstIterableValueType() : \PHPStan\Type\Type { return new \PHPStan\Type\NeverType(); } public function getLastIterableValueType() : \PHPStan\Type\Type { return new \PHPStan\Type\NeverType(); } public function isArray() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isConstantArray() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isOversizedArray() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isList() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isOffsetAccessible() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isOffsetAccessLegal() : TrinaryLogic { return TrinaryLogic::createYes(); } public function hasOffsetValueType(\PHPStan\Type\Type $offsetType) : TrinaryLogic { return TrinaryLogic::createYes(); } public function getOffsetValueType(\PHPStan\Type\Type $offsetType) : \PHPStan\Type\Type { return new \PHPStan\Type\NeverType(); } public function setOffsetValueType(?\PHPStan\Type\Type $offsetType, \PHPStan\Type\Type $valueType, bool $unionValues = \true) : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function setExistingOffsetValueType(\PHPStan\Type\Type $offsetType, \PHPStan\Type\Type $valueType) : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function unsetOffset(\PHPStan\Type\Type $offsetType) : \PHPStan\Type\Type { return new \PHPStan\Type\NeverType(); } public function getKeysArray() : \PHPStan\Type\Type { return new \PHPStan\Type\NeverType(); } public function getValuesArray() : \PHPStan\Type\Type { return new \PHPStan\Type\NeverType(); } public function chunkArray(\PHPStan\Type\Type $lengthType, TrinaryLogic $preserveKeys) : \PHPStan\Type\Type { return new \PHPStan\Type\NeverType(); } public function fillKeysArray(\PHPStan\Type\Type $valueType) : \PHPStan\Type\Type { return new \PHPStan\Type\NeverType(); } public function flipArray() : \PHPStan\Type\Type { return new \PHPStan\Type\NeverType(); } public function intersectKeyArray(\PHPStan\Type\Type $otherArraysType) : \PHPStan\Type\Type { return new \PHPStan\Type\NeverType(); } public function popArray() : \PHPStan\Type\Type { return new \PHPStan\Type\NeverType(); } public function reverseArray(TrinaryLogic $preserveKeys) : \PHPStan\Type\Type { return new \PHPStan\Type\NeverType(); } public function searchArray(\PHPStan\Type\Type $needleType) : \PHPStan\Type\Type { return new \PHPStan\Type\NeverType(); } public function shiftArray() : \PHPStan\Type\Type { return new \PHPStan\Type\NeverType(); } public function shuffleArray() : \PHPStan\Type\Type { return new \PHPStan\Type\NeverType(); } public function sliceArray(\PHPStan\Type\Type $offsetType, \PHPStan\Type\Type $lengthType, TrinaryLogic $preserveKeys) : \PHPStan\Type\Type { return new \PHPStan\Type\NeverType(); } public function isCallable() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getCallableParametersAcceptors(ClassMemberAccessAnswerer $scope) : array { throw new ShouldNotHappenException(); } public function isCloneable() : TrinaryLogic { return TrinaryLogic::createYes(); } public function toNumber() : \PHPStan\Type\Type { return $this; } public function toAbsoluteNumber() : \PHPStan\Type\Type { return $this; } public function toString() : \PHPStan\Type\Type { return $this; } public function toInteger() : \PHPStan\Type\Type { return $this; } public function toFloat() : \PHPStan\Type\Type { return $this; } public function toArray() : \PHPStan\Type\Type { return $this; } public function toArrayKey() : \PHPStan\Type\Type { return $this; } public function traverse(callable $cb) : \PHPStan\Type\Type { return $this; } public function traverseSimultaneously(\PHPStan\Type\Type $right, callable $cb) : \PHPStan\Type\Type { return $this; } public function isNull() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isConstantValue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isConstantScalarValue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getConstantScalarTypes() : array { return []; } public function getConstantScalarValues() : array { return []; } public function isTrue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFalse() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isBoolean() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFloat() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isInteger() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isNumericString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isNonEmptyString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isNonFalsyString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isLiteralString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isLowercaseString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isUppercaseString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isClassStringType() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getClassStringObjectType() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function getObjectTypeOrClassStringObjectType() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function isVoid() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isScalar() : TrinaryLogic { return TrinaryLogic::createNo(); } public function looseCompare(\PHPStan\Type\Type $type, PhpVersion $phpVersion) : \PHPStan\Type\BooleanType { return new \PHPStan\Type\BooleanType(); } public function getEnumCases() : array { return []; } public function exponentiate(\PHPStan\Type\Type $exponent) : \PHPStan\Type\Type { return $this; } public function getFiniteTypes() : array { return []; } public function toPhpDocNode() : TypeNode { return new IdentifierTypeNode('never'); } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : \PHPStan\Type\Type { return new self($properties['isExplicit']); } } <?php declare (strict_types=1); namespace PHPStan\Type; use ArrayAccess; use ArrayObject; use Closure; use Countable; use DateTime; use DateTimeImmutable; use DateTimeInterface; use Error; use Exception; use Iterator; use IteratorAggregate; use PHPStan\Analyser\OutOfClassScope; use PHPStan\Broker\Broker; use PHPStan\Broker\ClassNotFoundException; use PHPStan\Php\PhpVersion; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\Reflection\Callables\CallableParametersAcceptor; use PHPStan\Reflection\Callables\FunctionCallableVariant; use PHPStan\Reflection\ClassMemberAccessAnswerer; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ConstantReflection; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\Php\UniversalObjectCratesClassReflectionExtension; use PHPStan\Reflection\PropertyReflection; use PHPStan\Reflection\ReflectionProviderStaticAccessor; use PHPStan\Reflection\TrivialParametersAcceptor; use PHPStan\Reflection\Type\CalledOnTypeUnresolvedMethodPrototypeReflection; use PHPStan\Reflection\Type\CalledOnTypeUnresolvedPropertyPrototypeReflection; use PHPStan\Reflection\Type\UnionTypeUnresolvedPropertyPrototypeReflection; use PHPStan\Reflection\Type\UnresolvedMethodPrototypeReflection; use PHPStan\Reflection\Type\UnresolvedPropertyPrototypeReflection; use PHPStan\ShouldNotHappenException; use PHPStan\TrinaryLogic; use PHPStan\Type\Constant\ConstantArrayType; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\Enum\EnumCaseObjectType; use PHPStan\Type\Generic\GenericObjectType; use PHPStan\Type\Generic\TemplateTypeHelper; use PHPStan\Type\Traits\MaybeIterableTypeTrait; use PHPStan\Type\Traits\NonArrayTypeTrait; use PHPStan\Type\Traits\NonGeneralizableTypeTrait; use PHPStan\Type\Traits\NonGenericTypeTrait; use PHPStan\Type\Traits\UndecidedComparisonTypeTrait; use Throwable; use Traversable; use function array_key_exists; use function array_map; use function array_values; use function count; use function implode; use function in_array; use function sprintf; use function strtolower; /** @api */ class ObjectType implements \PHPStan\Type\TypeWithClassName, \PHPStan\Type\SubtractableType { /** * @var string */ private $className; /** * @var ?ClassReflection */ private $classReflection; use MaybeIterableTypeTrait; use NonArrayTypeTrait; use NonGenericTypeTrait; use UndecidedComparisonTypeTrait; use NonGeneralizableTypeTrait; private const EXTRA_OFFSET_CLASSES = [ 'DOMNamedNodeMap', // Only read and existence 'Dom\\NamedNodeMap', // Only read and existence 'DOMNodeList', // Only read and existence 'Dom\\NodeList', // Only read and existence 'Dom\\HTMLCollection', // Only read and existence 'Dom\\DtdNamedNodeMap', // Only read and existence 'PDORow', // Only read and existence 'ResourceBundle', // Only read 'FFI\\CData', // Very funky and weird 'SimpleXMLElement', 'Threaded', ]; /** * @var ?Type */ private $subtractedType; /** @var array<string, array<string, IsSuperTypeOfResult>> */ private static $superTypes = []; /** * @var ?self */ private $cachedParent = null; /** @var self[]|null */ private $cachedInterfaces = null; /** @var array<string, array<string, array<string, UnresolvedMethodPrototypeReflection>>> */ private static $methods = []; /** @var array<string, array<string, array<string, UnresolvedPropertyPrototypeReflection>>> */ private static $properties = []; /** @var array<string, array<string, self|null>> */ private static $ancestors = []; /** @var array<string, self|null> */ private $currentAncestors = []; /** * @var ?string */ private $cachedDescription = null; /** @var array<string, list<EnumCaseObjectType>> */ private static $enumCases = []; /** @api */ public function __construct(string $className, ?\PHPStan\Type\Type $subtractedType = null, ?ClassReflection $classReflection = null) { $this->className = $className; $this->classReflection = $classReflection; if ($subtractedType instanceof \PHPStan\Type\NeverType) { $subtractedType = null; } $this->subtractedType = $subtractedType; } public static function resetCaches() : void { self::$superTypes = []; self::$methods = []; self::$properties = []; self::$ancestors = []; self::$enumCases = []; } private static function createFromReflection(ClassReflection $reflection) : self { if (!$reflection->isGeneric()) { return new \PHPStan\Type\ObjectType($reflection->getName()); } return new GenericObjectType($reflection->getName(), $reflection->typeMapToList($reflection->getActiveTemplateTypeMap()), null, null, $reflection->varianceMapToList($reflection->getCallSiteVarianceMap())); } public function getClassName() : string { return $this->className; } public function hasProperty(string $propertyName) : TrinaryLogic { $classReflection = $this->getClassReflection(); if ($classReflection === null) { return TrinaryLogic::createMaybe(); } if ($classReflection->hasProperty($propertyName)) { return TrinaryLogic::createYes(); } if ($classReflection->allowsDynamicProperties()) { return TrinaryLogic::createMaybe(); } if (!$classReflection->isFinal()) { return TrinaryLogic::createMaybe(); } return TrinaryLogic::createNo(); } public function getProperty(string $propertyName, ClassMemberAccessAnswerer $scope) : PropertyReflection { return $this->getUnresolvedPropertyPrototype($propertyName, $scope)->getTransformedProperty(); } public function getUnresolvedPropertyPrototype(string $propertyName, ClassMemberAccessAnswerer $scope) : UnresolvedPropertyPrototypeReflection { if (!$scope->isInClass()) { $canAccessProperty = 'no'; } else { $canAccessProperty = $scope->getClassReflection()->getName(); } $description = $this->describeCache(); if (isset(self::$properties[$description][$propertyName][$canAccessProperty])) { return self::$properties[$description][$propertyName][$canAccessProperty]; } $nakedClassReflection = $this->getNakedClassReflection(); if ($nakedClassReflection === null) { throw new ClassNotFoundException($this->className); } if ($nakedClassReflection->isEnum()) { if ($propertyName === 'name' || $propertyName === 'value' && $nakedClassReflection->isBackedEnum()) { $properties = []; foreach ($this->getEnumCases() as $enumCase) { $properties[] = $enumCase->getUnresolvedPropertyPrototype($propertyName, $scope); } if (count($properties) > 0) { if (count($properties) === 1) { return $properties[0]; } return new UnionTypeUnresolvedPropertyPrototypeReflection($propertyName, $properties); } } } if (!$nakedClassReflection->hasNativeProperty($propertyName)) { $nakedClassReflection = $this->getClassReflection(); } if ($nakedClassReflection === null) { throw new ClassNotFoundException($this->className); } $property = $nakedClassReflection->getProperty($propertyName, $scope); $ancestor = $this->getAncestorWithClassName($property->getDeclaringClass()->getName()); $resolvedClassReflection = null; if ($ancestor !== null && $ancestor->hasProperty($propertyName)->yes()) { $resolvedClassReflection = $ancestor->getClassReflection(); if ($ancestor !== $this) { $property = $ancestor->getUnresolvedPropertyPrototype($propertyName, $scope)->getNakedProperty(); } } if ($resolvedClassReflection === null) { $resolvedClassReflection = $property->getDeclaringClass(); } return self::$properties[$description][$propertyName][$canAccessProperty] = new CalledOnTypeUnresolvedPropertyPrototypeReflection($property, $resolvedClassReflection, \true, $this); } public function getPropertyWithoutTransformingStatic(string $propertyName, ClassMemberAccessAnswerer $scope) : PropertyReflection { $classReflection = $this->getNakedClassReflection(); if ($classReflection === null) { throw new ClassNotFoundException($this->className); } if (!$classReflection->hasProperty($propertyName)) { $classReflection = $this->getClassReflection(); } if ($classReflection === null) { throw new ClassNotFoundException($this->className); } return $classReflection->getProperty($propertyName, $scope); } /** * @return string[] */ public function getReferencedClasses() : array { return [$this->className]; } public function getObjectClassNames() : array { if ($this->className === '') { return []; } return [$this->className]; } public function getObjectClassReflections() : array { $classReflection = $this->getClassReflection(); if ($classReflection === null) { return []; } return [$classReflection]; } public function accepts(\PHPStan\Type\Type $type, bool $strictTypes) : TrinaryLogic { return $this->acceptsWithReason($type, $strictTypes)->result; } public function acceptsWithReason(\PHPStan\Type\Type $type, bool $strictTypes) : \PHPStan\Type\AcceptsResult { if ($type instanceof \PHPStan\Type\StaticType) { return $this->checkSubclassAcceptability($type->getClassName()); } if ($type instanceof \PHPStan\Type\CompoundType) { return $type->isAcceptedWithReasonBy($this, $strictTypes); } if ($type instanceof \PHPStan\Type\ClosureType) { return new \PHPStan\Type\AcceptsResult($this->isInstanceOf(Closure::class), []); } if ($type instanceof \PHPStan\Type\ObjectWithoutClassType) { return \PHPStan\Type\AcceptsResult::createMaybe(); } $thatClassNames = $type->getObjectClassNames(); if (count($thatClassNames) > 1) { throw new ShouldNotHappenException(); } if ($thatClassNames === []) { return \PHPStan\Type\AcceptsResult::createNo(); } return $this->checkSubclassAcceptability($thatClassNames[0]); } public function isSuperTypeOf(\PHPStan\Type\Type $type) : TrinaryLogic { return $this->isSuperTypeOfWithReason($type)->result; } public function isSuperTypeOfWithReason(\PHPStan\Type\Type $type) : \PHPStan\Type\IsSuperTypeOfResult { $thatClassNames = $type->getObjectClassNames(); if (!$type instanceof \PHPStan\Type\CompoundType && $thatClassNames === [] && !$type instanceof \PHPStan\Type\ObjectWithoutClassType) { return \PHPStan\Type\IsSuperTypeOfResult::createNo(); } $thisDescription = $this->describeCache(); if ($type instanceof self) { $description = $type->describeCache(); } else { $description = $type->describe(\PHPStan\Type\VerbosityLevel::cache()); } if (isset(self::$superTypes[$thisDescription][$description])) { return self::$superTypes[$thisDescription][$description]; } if ($type instanceof \PHPStan\Type\CompoundType) { return self::$superTypes[$thisDescription][$description] = $type->isSubTypeOfWithReason($this); } if ($type instanceof \PHPStan\Type\ClosureType) { return self::$superTypes[$thisDescription][$description] = new \PHPStan\Type\IsSuperTypeOfResult($this->isInstanceOf(Closure::class), []); } if ($type instanceof \PHPStan\Type\ObjectWithoutClassType) { if ($type->getSubtractedType() !== null) { $isSuperType = $type->getSubtractedType()->isSuperTypeOf($this); if ($isSuperType->yes()) { return self::$superTypes[$thisDescription][$description] = \PHPStan\Type\IsSuperTypeOfResult::createNo(); } } return self::$superTypes[$thisDescription][$description] = \PHPStan\Type\IsSuperTypeOfResult::createMaybe(); } $transformResult = static function (\PHPStan\Type\IsSuperTypeOfResult $result) { return $result; }; if ($this->subtractedType !== null) { $isSuperType = $this->subtractedType->isSuperTypeOfWithReason($type); if ($isSuperType->yes()) { return self::$superTypes[$thisDescription][$description] = \PHPStan\Type\IsSuperTypeOfResult::createNo(); } if ($isSuperType->maybe()) { $transformResult = static function (\PHPStan\Type\IsSuperTypeOfResult $result) { return $result->and(\PHPStan\Type\IsSuperTypeOfResult::createMaybe()); }; } } if ($type instanceof \PHPStan\Type\SubtractableType && $type->getSubtractedType() !== null) { $isSuperType = $type->getSubtractedType()->isSuperTypeOfWithReason($this); if ($isSuperType->yes()) { return self::$superTypes[$thisDescription][$description] = \PHPStan\Type\IsSuperTypeOfResult::createNo(); } } $thisClassName = $this->className; if (count($thatClassNames) > 1) { throw new ShouldNotHappenException(); } if ($thatClassNames[0] === $thisClassName) { return $transformResult(\PHPStan\Type\IsSuperTypeOfResult::createYes()); } $reflectionProvider = ReflectionProviderStaticAccessor::getInstance(); $thisClassReflection = $this->getClassReflection(); if ($thisClassReflection === null || !$reflectionProvider->hasClass($thatClassNames[0])) { return self::$superTypes[$thisDescription][$description] = \PHPStan\Type\IsSuperTypeOfResult::createMaybe(); } $thatClassReflection = $reflectionProvider->getClass($thatClassNames[0]); if ($thisClassReflection->isTrait() || $thatClassReflection->isTrait()) { return \PHPStan\Type\IsSuperTypeOfResult::createNo(); } if ($thisClassReflection->getName() === $thatClassReflection->getName()) { return self::$superTypes[$thisDescription][$description] = $transformResult(\PHPStan\Type\IsSuperTypeOfResult::createYes()); } if ($thatClassReflection->isSubclassOf($thisClassName)) { return self::$superTypes[$thisDescription][$description] = $transformResult(\PHPStan\Type\IsSuperTypeOfResult::createYes()); } if ($thisClassReflection->isSubclassOf($thatClassNames[0])) { return self::$superTypes[$thisDescription][$description] = \PHPStan\Type\IsSuperTypeOfResult::createMaybe(); } if ($thisClassReflection->isInterface() && !$thatClassReflection->getNativeReflection()->isFinal()) { return self::$superTypes[$thisDescription][$description] = \PHPStan\Type\IsSuperTypeOfResult::createMaybe(); } if ($thatClassReflection->isInterface() && !$thisClassReflection->getNativeReflection()->isFinal()) { return self::$superTypes[$thisDescription][$description] = \PHPStan\Type\IsSuperTypeOfResult::createMaybe(); } return self::$superTypes[$thisDescription][$description] = \PHPStan\Type\IsSuperTypeOfResult::createNo(); } public function equals(\PHPStan\Type\Type $type) : bool { if (!$type instanceof self) { return \false; } if ($type instanceof EnumCaseObjectType) { return \false; } if ($this->className !== $type->className) { return \false; } if ($this->subtractedType === null) { return $type->subtractedType === null; } if ($type->subtractedType === null) { return \false; } return $this->subtractedType->equals($type->subtractedType); } private function checkSubclassAcceptability(string $thatClass) : \PHPStan\Type\AcceptsResult { if ($this->className === $thatClass) { return \PHPStan\Type\AcceptsResult::createYes(); } $reflectionProvider = ReflectionProviderStaticAccessor::getInstance(); if ($this->getClassReflection() === null || !$reflectionProvider->hasClass($thatClass)) { return \PHPStan\Type\AcceptsResult::createNo(); } $thisReflection = $this->getClassReflection(); $thatReflection = $reflectionProvider->getClass($thatClass); if ($thisReflection->getName() === $thatReflection->getName()) { // class alias return \PHPStan\Type\AcceptsResult::createYes(); } if ($thisReflection->isInterface() && $thatReflection->isInterface()) { return \PHPStan\Type\AcceptsResult::createFromBoolean($thatReflection->implementsInterface($thisReflection->getName())); } return \PHPStan\Type\AcceptsResult::createFromBoolean($thatReflection->isSubclassOf($thisReflection->getName())); } public function describe(\PHPStan\Type\VerbosityLevel $level) : string { $preciseNameCallback = function () : string { $reflectionProvider = ReflectionProviderStaticAccessor::getInstance(); if (!$reflectionProvider->hasClass($this->className)) { return $this->className; } return $reflectionProvider->getClassName($this->className); }; $preciseWithSubtracted = function () use($level) : string { $description = $this->className; if ($this->subtractedType !== null) { $description .= $this->subtractedType instanceof \PHPStan\Type\UnionType ? sprintf('~(%s)', $this->subtractedType->describe($level)) : sprintf('~%s', $this->subtractedType->describe($level)); } return $description; }; return $level->handle($preciseNameCallback, $preciseNameCallback, $preciseWithSubtracted, function () use($preciseWithSubtracted) : string { $reflection = $this->classReflection; $line = ''; if ($reflection !== null) { $line .= '-'; $line .= (string) $reflection->getNativeReflection()->getStartLine(); $line .= '-'; } return $preciseWithSubtracted() . '-' . static::class . '-' . $line . $this->describeAdditionalCacheKey(); }); } protected function describeAdditionalCacheKey() : string { return ''; } private function describeCache() : string { if ($this->cachedDescription !== null) { return $this->cachedDescription; } if (static::class !== self::class) { return $this->cachedDescription = $this->describe(\PHPStan\Type\VerbosityLevel::cache()); } $description = $this->className; if ($this instanceof GenericObjectType) { $description .= '<'; $typeDescriptions = []; foreach ($this->getTypes() as $type) { $typeDescriptions[] = $type->describe(\PHPStan\Type\VerbosityLevel::cache()); } $description .= '<' . implode(', ', $typeDescriptions) . '>'; } if ($this->subtractedType !== null) { $description .= $this->subtractedType instanceof \PHPStan\Type\UnionType ? sprintf('~(%s)', $this->subtractedType->describe(\PHPStan\Type\VerbosityLevel::cache())) : sprintf('~%s', $this->subtractedType->describe(\PHPStan\Type\VerbosityLevel::cache())); } $reflection = $this->classReflection; if ($reflection !== null) { $description .= '-'; $description .= (string) $reflection->getNativeReflection()->getStartLine(); $description .= '-'; } return $this->cachedDescription = $description; } public function toNumber() : \PHPStan\Type\Type { if ($this->isInstanceOf('SimpleXMLElement')->yes()) { return new \PHPStan\Type\UnionType([new \PHPStan\Type\FloatType(), new \PHPStan\Type\IntegerType()]); } return new \PHPStan\Type\ErrorType(); } public function toAbsoluteNumber() : \PHPStan\Type\Type { return $this->toNumber()->toAbsoluteNumber(); } public function toInteger() : \PHPStan\Type\Type { if ($this->isInstanceOf('SimpleXMLElement')->yes()) { return new \PHPStan\Type\IntegerType(); } if (in_array($this->getClassName(), ['CurlHandle', 'CurlMultiHandle'], \true)) { return new \PHPStan\Type\IntegerType(); } return new \PHPStan\Type\ErrorType(); } public function toFloat() : \PHPStan\Type\Type { if ($this->isInstanceOf('SimpleXMLElement')->yes()) { return new \PHPStan\Type\FloatType(); } return new \PHPStan\Type\ErrorType(); } public function toString() : \PHPStan\Type\Type { $classReflection = $this->getClassReflection(); if ($classReflection === null) { return new \PHPStan\Type\ErrorType(); } if ($classReflection->hasNativeMethod('__toString')) { return $this->getMethod('__toString', new OutOfClassScope())->getOnlyVariant()->getReturnType(); } return new \PHPStan\Type\ErrorType(); } public function toArray() : \PHPStan\Type\Type { $classReflection = $this->getClassReflection(); if ($classReflection === null) { return new \PHPStan\Type\ArrayType(new \PHPStan\Type\MixedType(), new \PHPStan\Type\MixedType()); } $reflectionProvider = ReflectionProviderStaticAccessor::getInstance(); if (!$classReflection->getNativeReflection()->isUserDefined() || $classReflection->is(ArrayObject::class) || UniversalObjectCratesClassReflectionExtension::isUniversalObjectCrate($reflectionProvider, Broker::getInstance()->getUniversalObjectCratesClasses(), $classReflection)) { return new \PHPStan\Type\ArrayType(new \PHPStan\Type\MixedType(), new \PHPStan\Type\MixedType()); } $arrayKeys = []; $arrayValues = []; $isFinal = $classReflection->isFinal(); do { foreach ($classReflection->getNativeReflection()->getProperties() as $nativeProperty) { if ($nativeProperty->isStatic()) { continue; } $declaringClass = $reflectionProvider->getClass($nativeProperty->getDeclaringClass()->getName()); $property = $declaringClass->getNativeProperty($nativeProperty->getName()); $keyName = $nativeProperty->getName(); if ($nativeProperty->isPrivate()) { $keyName = sprintf("\x00%s\x00%s", $declaringClass->getName(), $keyName); } elseif ($nativeProperty->isProtected()) { $keyName = sprintf("\x00*\x00%s", $keyName); } $arrayKeys[] = new ConstantStringType($keyName); $arrayValues[] = $property->getReadableType(); } $classReflection = $classReflection->getParentClass(); } while ($classReflection !== null); if (!$isFinal && count($arrayKeys) === 0) { return new \PHPStan\Type\ArrayType(new \PHPStan\Type\MixedType(), new \PHPStan\Type\MixedType()); } return new ConstantArrayType($arrayKeys, $arrayValues); } public function toArrayKey() : \PHPStan\Type\Type { return $this->toString(); } public function toBoolean() : \PHPStan\Type\BooleanType { if ($this->isInstanceOf('SimpleXMLElement')->yes()) { return new \PHPStan\Type\BooleanType(); } return new ConstantBooleanType(\true); } public function isObject() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isEnum() : TrinaryLogic { $classReflection = $this->getClassReflection(); if ($classReflection === null) { return TrinaryLogic::createMaybe(); } return TrinaryLogic::createFromBoolean($classReflection->isEnum()); } public function canAccessProperties() : TrinaryLogic { return TrinaryLogic::createYes(); } public function canCallMethods() : TrinaryLogic { if (strtolower($this->className) === 'stdclass') { return TrinaryLogic::createNo(); } return TrinaryLogic::createYes(); } public function hasMethod(string $methodName) : TrinaryLogic { $classReflection = $this->getClassReflection(); if ($classReflection === null) { return TrinaryLogic::createMaybe(); } if ($classReflection->hasMethod($methodName)) { return TrinaryLogic::createYes(); } if ($classReflection->isFinal()) { return TrinaryLogic::createNo(); } return TrinaryLogic::createMaybe(); } public function getMethod(string $methodName, ClassMemberAccessAnswerer $scope) : ExtendedMethodReflection { return $this->getUnresolvedMethodPrototype($methodName, $scope)->getTransformedMethod(); } public function getUnresolvedMethodPrototype(string $methodName, ClassMemberAccessAnswerer $scope) : UnresolvedMethodPrototypeReflection { if (!$scope->isInClass()) { $canCallMethod = 'no'; } else { $canCallMethod = $scope->getClassReflection()->getName(); } $description = $this->describeCache(); if (isset(self::$methods[$description][$methodName][$canCallMethod])) { return self::$methods[$description][$methodName][$canCallMethod]; } $nakedClassReflection = $this->getNakedClassReflection(); if ($nakedClassReflection === null) { throw new ClassNotFoundException($this->className); } if (!$nakedClassReflection->hasNativeMethod($methodName)) { $nakedClassReflection = $this->getClassReflection(); } if ($nakedClassReflection === null) { throw new ClassNotFoundException($this->className); } $method = $nakedClassReflection->getMethod($methodName, $scope); $ancestor = $this->getAncestorWithClassName($method->getDeclaringClass()->getName()); $resolvedClassReflection = null; if ($ancestor !== null) { $resolvedClassReflection = $ancestor->getClassReflection(); if ($ancestor !== $this) { $method = $ancestor->getUnresolvedMethodPrototype($methodName, $scope)->getNakedMethod(); } } if ($resolvedClassReflection === null) { $resolvedClassReflection = $method->getDeclaringClass(); } return self::$methods[$description][$methodName][$canCallMethod] = new CalledOnTypeUnresolvedMethodPrototypeReflection($method, $resolvedClassReflection, \true, $this); } public function canAccessConstants() : TrinaryLogic { return TrinaryLogic::createYes(); } public function hasConstant(string $constantName) : TrinaryLogic { $class = $this->getClassReflection(); if ($class === null) { return TrinaryLogic::createNo(); } return TrinaryLogic::createFromBoolean($class->hasConstant($constantName)); } public function getConstant(string $constantName) : ConstantReflection { $class = $this->getClassReflection(); if ($class === null) { throw new ClassNotFoundException($this->className); } return $class->getConstant($constantName); } public function getTemplateType(string $ancestorClassName, string $templateTypeName) : \PHPStan\Type\Type { $classReflection = $this->getClassReflection(); if ($classReflection === null) { return new \PHPStan\Type\ErrorType(); } $ancestorClassReflection = $classReflection->getAncestorWithClassName($ancestorClassName); if ($ancestorClassReflection === null) { return new \PHPStan\Type\ErrorType(); } $activeTemplateTypeMap = $ancestorClassReflection->getPossiblyIncompleteActiveTemplateTypeMap(); $type = $activeTemplateTypeMap->getType($templateTypeName); if ($type === null) { return new \PHPStan\Type\ErrorType(); } if ($type instanceof \PHPStan\Type\ErrorType) { $templateTypeMap = $ancestorClassReflection->getTemplateTypeMap(); $templateType = $templateTypeMap->getType($templateTypeName); if ($templateType === null) { return $type; } $bound = TemplateTypeHelper::resolveToBounds($templateType); if ($bound instanceof \PHPStan\Type\MixedType && $bound->isExplicitMixed()) { return new \PHPStan\Type\MixedType(\false); } return TemplateTypeHelper::resolveToDefaults($templateType); } return $type; } public function getConstantStrings() : array { return []; } public function isIterable() : TrinaryLogic { return $this->isInstanceOf(Traversable::class); } public function isIterableAtLeastOnce() : TrinaryLogic { return $this->isInstanceOf(Traversable::class)->and(TrinaryLogic::createMaybe()); } public function getArraySize() : \PHPStan\Type\Type { if ($this->isInstanceOf(Countable::class)->no()) { return new \PHPStan\Type\ErrorType(); } return \PHPStan\Type\IntegerRangeType::fromInterval(0, null); } public function getIterableKeyType() : \PHPStan\Type\Type { $isTraversable = \false; if ($this->isInstanceOf(IteratorAggregate::class)->yes()) { $keyType = \PHPStan\Type\RecursionGuard::run($this, function () : \PHPStan\Type\Type { return $this->getMethod('getIterator', new OutOfClassScope())->getOnlyVariant()->getReturnType()->getIterableKeyType(); }); $isTraversable = \true; if (!$keyType instanceof \PHPStan\Type\MixedType || $keyType->isExplicitMixed()) { return $keyType; } } $extraOffsetAccessible = $this->isExtraOffsetAccessibleClass()->yes(); if (!$extraOffsetAccessible && $this->isInstanceOf(Traversable::class)->yes()) { $isTraversable = \true; $tKey = $this->getTemplateType(Traversable::class, 'TKey'); if (!$tKey instanceof \PHPStan\Type\ErrorType) { if (!$tKey instanceof \PHPStan\Type\MixedType || $tKey->isExplicitMixed()) { return $tKey; } } } if ($this->isInstanceOf(Iterator::class)->yes()) { return \PHPStan\Type\RecursionGuard::run($this, function () : \PHPStan\Type\Type { return $this->getMethod('key', new OutOfClassScope())->getOnlyVariant()->getReturnType(); }); } if ($extraOffsetAccessible) { return new \PHPStan\Type\MixedType(\true); } if ($isTraversable) { return new \PHPStan\Type\MixedType(); } return new \PHPStan\Type\ErrorType(); } public function getFirstIterableKeyType() : \PHPStan\Type\Type { return $this->getIterableKeyType(); } public function getLastIterableKeyType() : \PHPStan\Type\Type { return $this->getIterableKeyType(); } public function getIterableValueType() : \PHPStan\Type\Type { $isTraversable = \false; if ($this->isInstanceOf(IteratorAggregate::class)->yes()) { $valueType = \PHPStan\Type\RecursionGuard::run($this, function () : \PHPStan\Type\Type { return $this->getMethod('getIterator', new OutOfClassScope())->getOnlyVariant()->getReturnType()->getIterableValueType(); }); $isTraversable = \true; if (!$valueType instanceof \PHPStan\Type\MixedType || $valueType->isExplicitMixed()) { return $valueType; } } $extraOffsetAccessible = $this->isExtraOffsetAccessibleClass()->yes(); if (!$extraOffsetAccessible && $this->isInstanceOf(Traversable::class)->yes()) { $isTraversable = \true; $tValue = $this->getTemplateType(Traversable::class, 'TValue'); if (!$tValue instanceof \PHPStan\Type\ErrorType) { if (!$tValue instanceof \PHPStan\Type\MixedType || $tValue->isExplicitMixed()) { return $tValue; } } } if ($this->isInstanceOf(Iterator::class)->yes()) { return \PHPStan\Type\RecursionGuard::run($this, function () : \PHPStan\Type\Type { return $this->getMethod('current', new OutOfClassScope())->getOnlyVariant()->getReturnType(); }); } if ($extraOffsetAccessible) { return new \PHPStan\Type\MixedType(\true); } if ($isTraversable) { return new \PHPStan\Type\MixedType(); } return new \PHPStan\Type\ErrorType(); } public function getFirstIterableValueType() : \PHPStan\Type\Type { return $this->getIterableValueType(); } public function getLastIterableValueType() : \PHPStan\Type\Type { return $this->getIterableValueType(); } public function isNull() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isConstantValue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isConstantScalarValue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getConstantScalarTypes() : array { return []; } public function getConstantScalarValues() : array { return []; } public function isTrue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFalse() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isBoolean() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFloat() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isInteger() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isNumericString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isNonEmptyString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isNonFalsyString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isLiteralString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isLowercaseString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isUppercaseString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isClassStringType() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getClassStringObjectType() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function getObjectTypeOrClassStringObjectType() : \PHPStan\Type\Type { return $this; } public function isVoid() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isScalar() : TrinaryLogic { return TrinaryLogic::createNo(); } public function looseCompare(\PHPStan\Type\Type $type, PhpVersion $phpVersion) : \PHPStan\Type\BooleanType { if ($type->isTrue()->yes()) { return new ConstantBooleanType(\true); } return $type->isFalse()->yes() ? new ConstantBooleanType(\false) : new \PHPStan\Type\BooleanType(); } private function isExtraOffsetAccessibleClass() : TrinaryLogic { $classReflection = $this->getClassReflection(); if ($classReflection === null) { return TrinaryLogic::createMaybe(); } foreach (self::EXTRA_OFFSET_CLASSES as $extraOffsetClass) { if ($classReflection->getName() === $extraOffsetClass) { return TrinaryLogic::createYes(); } if ($classReflection->isSubclassOf($extraOffsetClass)) { return TrinaryLogic::createYes(); } } if ($classReflection->isInterface()) { return TrinaryLogic::createMaybe(); } if ($classReflection->isFinal()) { return TrinaryLogic::createNo(); } return TrinaryLogic::createMaybe(); } public function isOffsetAccessible() : TrinaryLogic { return $this->isInstanceOf(ArrayAccess::class)->or($this->isExtraOffsetAccessibleClass()); } public function isOffsetAccessLegal() : TrinaryLogic { return $this->isOffsetAccessible(); } public function hasOffsetValueType(\PHPStan\Type\Type $offsetType) : TrinaryLogic { if ($this->isInstanceOf(ArrayAccess::class)->yes()) { $acceptedOffsetType = \PHPStan\Type\RecursionGuard::run($this, function () : \PHPStan\Type\Type { $parameters = $this->getMethod('offsetSet', new OutOfClassScope())->getOnlyVariant()->getParameters(); if (count($parameters) < 2) { throw new ShouldNotHappenException(sprintf('Method %s::%s() has less than 2 parameters.', $this->className, 'offsetSet')); } $offsetParameter = $parameters[0]; return $offsetParameter->getType(); }); if ($acceptedOffsetType->isSuperTypeOf($offsetType)->no()) { return TrinaryLogic::createNo(); } return TrinaryLogic::createMaybe(); } return $this->isExtraOffsetAccessibleClass()->and(TrinaryLogic::createMaybe()); } public function getOffsetValueType(\PHPStan\Type\Type $offsetType) : \PHPStan\Type\Type { if (!$this->isExtraOffsetAccessibleClass()->no()) { return new \PHPStan\Type\MixedType(); } if ($this->isInstanceOf(ArrayAccess::class)->yes()) { return \PHPStan\Type\RecursionGuard::run($this, function () : \PHPStan\Type\Type { return $this->getMethod('offsetGet', new OutOfClassScope())->getOnlyVariant()->getReturnType(); }); } return new \PHPStan\Type\ErrorType(); } public function setOffsetValueType(?\PHPStan\Type\Type $offsetType, \PHPStan\Type\Type $valueType, bool $unionValues = \true) : \PHPStan\Type\Type { if ($this->isOffsetAccessible()->no()) { return new \PHPStan\Type\ErrorType(); } if ($this->isInstanceOf(ArrayAccess::class)->yes()) { $acceptedValueType = new \PHPStan\Type\NeverType(); $acceptedOffsetType = \PHPStan\Type\RecursionGuard::run($this, function () use(&$acceptedValueType) : \PHPStan\Type\Type { $parameters = $this->getMethod('offsetSet', new OutOfClassScope())->getOnlyVariant()->getParameters(); if (count($parameters) < 2) { throw new ShouldNotHappenException(sprintf('Method %s::%s() has less than 2 parameters.', $this->className, 'offsetSet')); } $offsetParameter = $parameters[0]; $acceptedValueType = $parameters[1]->getType(); return $offsetParameter->getType(); }); if ($offsetType === null) { $offsetType = new \PHPStan\Type\NullType(); } if (!$offsetType instanceof \PHPStan\Type\MixedType && !$acceptedOffsetType->isSuperTypeOf($offsetType)->yes() || !$valueType instanceof \PHPStan\Type\MixedType && !$acceptedValueType->isSuperTypeOf($valueType)->yes()) { return new \PHPStan\Type\ErrorType(); } } // in the future we may return intersection of $this and OffsetAccessibleType() return $this; } public function setExistingOffsetValueType(\PHPStan\Type\Type $offsetType, \PHPStan\Type\Type $valueType) : \PHPStan\Type\Type { if ($this->isOffsetAccessible()->no()) { return new \PHPStan\Type\ErrorType(); } return $this; } public function unsetOffset(\PHPStan\Type\Type $offsetType) : \PHPStan\Type\Type { if ($this->isOffsetAccessible()->no()) { return new \PHPStan\Type\ErrorType(); } return $this; } public function getEnumCases() : array { $classReflection = $this->getClassReflection(); if ($classReflection === null) { return []; } if (!$classReflection->isEnum()) { return []; } $cacheKey = $this->describeCache(); if (array_key_exists($cacheKey, self::$enumCases)) { return self::$enumCases[$cacheKey]; } $className = $classReflection->getName(); if ($this->subtractedType !== null) { $subtractedEnumCaseNames = []; foreach ($this->subtractedType->getEnumCases() as $subtractedCase) { $subtractedEnumCaseNames[$subtractedCase->getEnumCaseName()] = \true; } $cases = []; foreach ($classReflection->getEnumCases() as $enumCase) { if (array_key_exists($enumCase->getName(), $subtractedEnumCaseNames)) { continue; } $cases[] = new EnumCaseObjectType($className, $enumCase->getName(), $classReflection); } } else { $cases = []; foreach ($classReflection->getEnumCases() as $enumCase) { $cases[] = new EnumCaseObjectType($className, $enumCase->getName(), $classReflection); } } return self::$enumCases[$cacheKey] = $cases; } public function isCallable() : TrinaryLogic { $parametersAcceptors = \PHPStan\Type\RecursionGuard::run($this, function () { return $this->findCallableParametersAcceptors(); }); if ($parametersAcceptors === null) { return TrinaryLogic::createNo(); } if ($parametersAcceptors instanceof \PHPStan\Type\ErrorType) { return TrinaryLogic::createNo(); } if (count($parametersAcceptors) === 1 && $parametersAcceptors[0] instanceof TrivialParametersAcceptor) { return TrinaryLogic::createMaybe(); } return TrinaryLogic::createYes(); } public function getCallableParametersAcceptors(ClassMemberAccessAnswerer $scope) : array { if ($this->className === Closure::class) { return [new TrivialParametersAcceptor('Closure')]; } $parametersAcceptors = $this->findCallableParametersAcceptors(); if ($parametersAcceptors === null) { throw new ShouldNotHappenException(); } return $parametersAcceptors; } /** * @return CallableParametersAcceptor[]|null */ private function findCallableParametersAcceptors() : ?array { $classReflection = $this->getClassReflection(); if ($classReflection === null) { return [new TrivialParametersAcceptor()]; } if ($classReflection->hasNativeMethod('__invoke')) { $method = $this->getMethod('__invoke', new OutOfClassScope()); return FunctionCallableVariant::createFromVariants($method, $method->getVariants()); } if (!$classReflection->getNativeReflection()->isFinal()) { return [new TrivialParametersAcceptor()]; } return null; } public function isCloneable() : TrinaryLogic { return TrinaryLogic::createYes(); } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : \PHPStan\Type\Type { return new self($properties['className'], $properties['subtractedType'] ?? null); } public function isInstanceOf(string $className) : TrinaryLogic { $classReflection = $this->getClassReflection(); if ($classReflection === null) { return TrinaryLogic::createMaybe(); } if ($classReflection->getName() === $className || $classReflection->isSubclassOf($className)) { return TrinaryLogic::createYes(); } $reflectionProvider = ReflectionProviderStaticAccessor::getInstance(); if ($reflectionProvider->hasClass($className)) { $thatClassReflection = $reflectionProvider->getClass($className); if ($thatClassReflection->isFinal()) { return TrinaryLogic::createNo(); } } if ($classReflection->isInterface()) { return TrinaryLogic::createMaybe(); } return TrinaryLogic::createNo(); } public function subtract(\PHPStan\Type\Type $type) : \PHPStan\Type\Type { if ($this->subtractedType !== null) { $type = \PHPStan\Type\TypeCombinator::union($this->subtractedType, $type); } return $this->changeSubtractedType($type); } public function getTypeWithoutSubtractedType() : \PHPStan\Type\Type { return $this->changeSubtractedType(null); } public function changeSubtractedType(?\PHPStan\Type\Type $subtractedType) : \PHPStan\Type\Type { if ($subtractedType !== null) { $classReflection = $this->getClassReflection(); $allowedSubTypes = $classReflection !== null ? $classReflection->getAllowedSubTypes() : null; if ($allowedSubTypes !== null) { $preciseVerbosity = \PHPStan\Type\VerbosityLevel::precise(); $originalAllowedSubTypes = $allowedSubTypes; $subtractedSubTypes = []; $subtractedTypes = \PHPStan\Type\TypeUtils::flattenTypes($subtractedType); foreach ($subtractedTypes as $subType) { foreach ($allowedSubTypes as $key => $allowedSubType) { if ($subType->equals($allowedSubType)) { $description = $allowedSubType->describe($preciseVerbosity); $subtractedSubTypes[$description] = $subType; unset($allowedSubTypes[$key]); continue 2; } } return new self($this->className, $subtractedType); } if (count($allowedSubTypes) === 1) { return array_values($allowedSubTypes)[0]; } $subtractedSubTypes = array_values($subtractedSubTypes); $subtractedSubTypesCount = count($subtractedSubTypes); if ($subtractedSubTypesCount === count($originalAllowedSubTypes)) { return new \PHPStan\Type\NeverType(); } if ($subtractedSubTypesCount === 0) { return new self($this->className); } if ($subtractedSubTypesCount === 1) { return new self($this->className, $subtractedSubTypes[0]); } return new self($this->className, new \PHPStan\Type\UnionType($subtractedSubTypes)); } } if ($this->subtractedType === null && $subtractedType === null) { return $this; } return new self($this->className, $subtractedType); } public function getSubtractedType() : ?\PHPStan\Type\Type { return $this->subtractedType; } public function traverse(callable $cb) : \PHPStan\Type\Type { $subtractedType = $this->subtractedType !== null ? $cb($this->subtractedType) : null; if ($subtractedType !== $this->subtractedType) { return new self($this->className, $subtractedType); } return $this; } public function traverseSimultaneously(\PHPStan\Type\Type $right, callable $cb) : \PHPStan\Type\Type { if ($this->subtractedType === null) { return $this; } return new self($this->className); } public function getNakedClassReflection() : ?ClassReflection { if ($this->classReflection !== null) { return $this->classReflection; } $reflectionProvider = ReflectionProviderStaticAccessor::getInstance(); if (!$reflectionProvider->hasClass($this->className)) { return null; } return $reflectionProvider->getClass($this->className); } public function getClassReflection() : ?ClassReflection { if ($this->classReflection !== null) { return $this->classReflection; } $reflectionProvider = ReflectionProviderStaticAccessor::getInstance(); if (!$reflectionProvider->hasClass($this->className)) { return null; } $classReflection = $reflectionProvider->getClass($this->className); if ($classReflection->isGeneric()) { return $classReflection->withTypes(array_values($classReflection->getTemplateTypeMap()->map(static function () : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); })->getTypes())); } return $classReflection; } /** * @return self|null */ public function getAncestorWithClassName(string $className) : ?\PHPStan\Type\TypeWithClassName { if ($this->className === $className) { return $this; } if ($this->classReflection !== null && $className === $this->classReflection->getName()) { return $this; } if (array_key_exists($className, $this->currentAncestors)) { return $this->currentAncestors[$className]; } $description = $this->describeCache(); if (array_key_exists($description, self::$ancestors) && array_key_exists($className, self::$ancestors[$description])) { return self::$ancestors[$description][$className]; } $reflectionProvider = ReflectionProviderStaticAccessor::getInstance(); if (!$reflectionProvider->hasClass($className)) { return self::$ancestors[$description][$className] = $this->currentAncestors[$className] = null; } $theirReflection = $reflectionProvider->getClass($className); $thisReflection = $this->getClassReflection(); if ($thisReflection === null) { return self::$ancestors[$description][$className] = $this->currentAncestors[$className] = null; } if ($theirReflection->getName() === $thisReflection->getName()) { return self::$ancestors[$description][$className] = $this->currentAncestors[$className] = $this; } foreach ($this->getInterfaces() as $interface) { $ancestor = $interface->getAncestorWithClassName($className); if ($ancestor !== null) { return self::$ancestors[$description][$className] = $this->currentAncestors[$className] = $ancestor; } } $parent = $this->getParent(); if ($parent !== null) { $ancestor = $parent->getAncestorWithClassName($className); if ($ancestor !== null) { return self::$ancestors[$description][$className] = $this->currentAncestors[$className] = $ancestor; } } return self::$ancestors[$description][$className] = $this->currentAncestors[$className] = null; } private function getParent() : ?\PHPStan\Type\ObjectType { if ($this->cachedParent !== null) { return $this->cachedParent; } $thisReflection = $this->getClassReflection(); if ($thisReflection === null) { return null; } $parentReflection = $thisReflection->getParentClass(); if ($parentReflection === null) { return null; } return $this->cachedParent = self::createFromReflection($parentReflection); } /** @return ObjectType[] */ private function getInterfaces() : array { if ($this->cachedInterfaces !== null) { return $this->cachedInterfaces; } $thisReflection = $this->getClassReflection(); if ($thisReflection === null) { return $this->cachedInterfaces = []; } return $this->cachedInterfaces = array_map(static function (ClassReflection $interfaceReflection) : self { return self::createFromReflection($interfaceReflection); }, $thisReflection->getInterfaces()); } public function tryRemove(\PHPStan\Type\Type $typeToRemove) : ?\PHPStan\Type\Type { if ($this->getClassName() === DateTimeInterface::class) { if ($typeToRemove instanceof \PHPStan\Type\ObjectType && $typeToRemove->getClassName() === DateTimeImmutable::class) { return new \PHPStan\Type\ObjectType(DateTime::class); } if ($typeToRemove instanceof \PHPStan\Type\ObjectType && $typeToRemove->getClassName() === DateTime::class) { return new \PHPStan\Type\ObjectType(DateTimeImmutable::class); } } if ($this->getClassName() === Throwable::class) { if ($typeToRemove instanceof \PHPStan\Type\ObjectType && $typeToRemove->getClassName() === Error::class) { return new \PHPStan\Type\ObjectType(Exception::class); // phpcs:ignore SlevomatCodingStandard.Exceptions.ReferenceThrowableOnly.ReferencedGeneralException } if ($typeToRemove instanceof \PHPStan\Type\ObjectType && $typeToRemove->getClassName() === Exception::class) { // phpcs:ignore SlevomatCodingStandard.Exceptions.ReferenceThrowableOnly.ReferencedGeneralException return new \PHPStan\Type\ObjectType(Error::class); } } if ($this->isSuperTypeOf($typeToRemove)->yes()) { return $this->subtract($typeToRemove); } return null; } public function getFiniteTypes() : array { return $this->getEnumCases(); } public function exponentiate(\PHPStan\Type\Type $exponent) : \PHPStan\Type\Type { $object = new \PHPStan\Type\ObjectWithoutClassType(); if (!$exponent instanceof \PHPStan\Type\NeverType && !$object->isSuperTypeOf($this)->no() && !$object->isSuperTypeOf($exponent)->no()) { return \PHPStan\Type\TypeCombinator::union($this, $exponent); } return new \PHPStan\Type\ErrorType(); } public function toPhpDocNode() : TypeNode { return new IdentifierTypeNode($this->getClassName()); } } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\Type\Constant\ConstantArrayTypeBuilder; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantFloatType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\Enum\EnumCaseObjectType; use UnitEnum; use function count; use function function_exists; use function get_class; use function is_array; use function is_bool; use function is_float; use function is_int; use function is_nan; use function is_object; use function is_string; /** * @api * @final */ class ConstantTypeHelper { /** * @param mixed $value */ public static function getTypeFromValue($value) : \PHPStan\Type\Type { if (is_int($value)) { return new ConstantIntegerType($value); } elseif (is_float($value)) { if (is_nan($value)) { return new \PHPStan\Type\MixedType(); } return new ConstantFloatType($value); } elseif (is_bool($value)) { return new ConstantBooleanType($value); } elseif ($value === null) { return new \PHPStan\Type\NullType(); } elseif (is_string($value)) { return new ConstantStringType($value); } elseif (is_array($value)) { $arrayBuilder = ConstantArrayTypeBuilder::createEmpty(); if (count($value) > ConstantArrayTypeBuilder::ARRAY_COUNT_LIMIT) { $arrayBuilder->degradeToGeneralArray(\true); } foreach ($value as $k => $v) { $arrayBuilder->setOffsetValueType(self::getTypeFromValue($k), self::getTypeFromValue($v)); } return $arrayBuilder->getArray(); } elseif (is_object($value)) { $class = get_class($value); /** phpcs:disable SlevomatCodingStandard.Namespaces.ReferenceUsedNamesOnly.ReferenceViaFullyQualifiedName */ if (function_exists('enum_exists') && \enum_exists($class)) { /** @var UnitEnum $value */ return new EnumCaseObjectType($class, $value->name); } /** phpcs:enable */ return new \PHPStan\Type\ObjectType(get_class($value)); } return new \PHPStan\Type\MixedType(); } } <?php declare (strict_types=1); namespace PHPStan\Type; /** @api */ interface ConstantType extends \PHPStan\Type\Type { } <?php declare (strict_types=1); namespace PHPStan\Type\Traits; use PHPStan\Type\BooleanType; use PHPStan\Type\Constant\ConstantBooleanType; trait FalseyBooleanTypeTrait { public function toBoolean() : BooleanType { return new ConstantBooleanType(\false); } } <?php declare (strict_types=1); namespace PHPStan\Type\Traits; use PHPStan\TrinaryLogic; use PHPStan\Type\ErrorType; use PHPStan\Type\Type; trait NonArrayTypeTrait { public function getArrays() : array { return []; } public function getConstantArrays() : array { return []; } public function isArray() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isConstantArray() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isOversizedArray() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isList() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getKeysArray() : Type { return new ErrorType(); } public function getValuesArray() : Type { return new ErrorType(); } public function chunkArray(Type $lengthType, TrinaryLogic $preserveKeys) : Type { return new ErrorType(); } public function fillKeysArray(Type $valueType) : Type { return new ErrorType(); } public function flipArray() : Type { return new ErrorType(); } public function intersectKeyArray(Type $otherArraysType) : Type { return new ErrorType(); } public function popArray() : Type { return new ErrorType(); } public function reverseArray(TrinaryLogic $preserveKeys) : Type { return new ErrorType(); } public function searchArray(Type $needleType) : Type { return new ErrorType(); } public function shiftArray() : Type { return new ErrorType(); } public function shuffleArray() : Type { return new ErrorType(); } public function sliceArray(Type $offsetType, Type $lengthType, TrinaryLogic $preserveKeys) : Type { return new ErrorType(); } } <?php declare (strict_types=1); namespace PHPStan\Type\Traits; use PHPStan\TrinaryLogic; use PHPStan\Type\MixedType; use PHPStan\Type\Type; trait UndecidedComparisonTypeTrait { public function isSmallerThan(Type $otherType) : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isSmallerThanOrEqual(Type $otherType) : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getSmallerType() : Type { return new MixedType(); } public function getSmallerOrEqualType() : Type { return new MixedType(); } public function getGreaterType() : Type { return new MixedType(); } public function getGreaterOrEqualType() : Type { return new MixedType(); } } <?php declare (strict_types=1); namespace PHPStan\Type\Traits; use PHPStan\Type\BooleanType; trait UndecidedBooleanTypeTrait { public function toBoolean() : BooleanType { return new BooleanType(); } } <?php declare (strict_types=1); namespace PHPStan\Type\Traits; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantFloatType; use PHPStan\Type\IntegerRangeType; use PHPStan\Type\MixedType; use PHPStan\Type\NullType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; trait ConstantNumericComparisonTypeTrait { public function getSmallerType() : Type { $subtractedTypes = [new ConstantBooleanType(\true), IntegerRangeType::createAllGreaterThanOrEqualTo($this->value)]; if (!(bool) $this->value) { $subtractedTypes[] = new NullType(); $subtractedTypes[] = new ConstantBooleanType(\false); $subtractedTypes[] = new ConstantFloatType(0.0); // subtract range when we support float-ranges } return TypeCombinator::remove(new MixedType(), TypeCombinator::union(...$subtractedTypes)); } public function getSmallerOrEqualType() : Type { $subtractedTypes = [IntegerRangeType::createAllGreaterThan($this->value)]; if (!(bool) $this->value) { $subtractedTypes[] = new ConstantBooleanType(\true); } return TypeCombinator::remove(new MixedType(), TypeCombinator::union(...$subtractedTypes)); } public function getGreaterType() : Type { $subtractedTypes = [ new NullType(), new ConstantBooleanType(\false), new ConstantFloatType(0.0), // subtract range when we support float-ranges IntegerRangeType::createAllSmallerThanOrEqualTo($this->value), ]; if ((bool) $this->value) { $subtractedTypes[] = new ConstantBooleanType(\true); } return TypeCombinator::remove(new MixedType(), TypeCombinator::union(...$subtractedTypes)); } public function getGreaterOrEqualType() : Type { $subtractedTypes = [IntegerRangeType::createAllSmallerThan($this->value)]; if ((bool) $this->value) { $subtractedTypes[] = new NullType(); $subtractedTypes[] = new ConstantBooleanType(\false); $subtractedTypes[] = new ConstantFloatType(0.0); // subtract range when we support float-ranges } return TypeCombinator::remove(new MixedType(), TypeCombinator::union(...$subtractedTypes)); } } <?php declare (strict_types=1); namespace PHPStan\Type\Traits; use PHPStan\Type\Type; trait NonRemoveableTypeTrait { public function tryRemove(Type $typeToRemove) : ?Type { return null; } } <?php declare (strict_types=1); namespace PHPStan\Type\Traits; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\ClassMemberAccessAnswerer; use PHPStan\Reflection\ConstantReflection; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\PropertyReflection; use PHPStan\Reflection\Type\UnresolvedMethodPrototypeReflection; use PHPStan\Reflection\Type\UnresolvedPropertyPrototypeReflection; use PHPStan\TrinaryLogic; use PHPStan\Type\AcceptsResult; use PHPStan\Type\BooleanType; use PHPStan\Type\CompoundType; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\IsSuperTypeOfResult; use PHPStan\Type\LateResolvableType; use PHPStan\Type\NeverType; use PHPStan\Type\Type; trait LateResolvableTypeTrait { /** * @var ?Type */ private $result = null; public function getObjectClassNames() : array { return $this->resolve()->getObjectClassNames(); } public function getObjectClassReflections() : array { return $this->resolve()->getObjectClassReflections(); } public function getArrays() : array { return $this->resolve()->getArrays(); } public function getConstantArrays() : array { return $this->resolve()->getConstantArrays(); } public function getConstantStrings() : array { return $this->resolve()->getConstantStrings(); } public function accepts(Type $type, bool $strictTypes) : TrinaryLogic { return $this->resolve()->accepts($type, $strictTypes); } public function acceptsWithReason(Type $type, bool $strictTypes) : AcceptsResult { return $this->resolve()->acceptsWithReason($type, $strictTypes); } public function isSuperTypeOf(Type $type) : TrinaryLogic { return $this->isSuperTypeOfWithReason($type)->result; } public function isSuperTypeOfWithReason(Type $type) : IsSuperTypeOfResult { return $this->isSuperTypeOfDefault($type); } private function isSuperTypeOfDefault(Type $type) : IsSuperTypeOfResult { if ($type instanceof NeverType) { return IsSuperTypeOfResult::createYes(); } if ($type instanceof LateResolvableType) { $type = $type->resolve(); } $isSuperType = $this->resolve()->isSuperTypeOfWithReason($type); if (!$this->isResolvable()) { $isSuperType = $isSuperType->and(IsSuperTypeOfResult::createMaybe()); } return $isSuperType; } public function getTemplateType(string $ancestorClassName, string $templateTypeName) : Type { return $this->resolve()->getTemplateType($ancestorClassName, $templateTypeName); } public function isObject() : TrinaryLogic { return $this->resolve()->isObject(); } public function isEnum() : TrinaryLogic { return $this->resolve()->isEnum(); } public function canAccessProperties() : TrinaryLogic { return $this->resolve()->canAccessProperties(); } public function hasProperty(string $propertyName) : TrinaryLogic { return $this->resolve()->hasProperty($propertyName); } public function getProperty(string $propertyName, ClassMemberAccessAnswerer $scope) : PropertyReflection { return $this->resolve()->getProperty($propertyName, $scope); } public function getUnresolvedPropertyPrototype(string $propertyName, ClassMemberAccessAnswerer $scope) : UnresolvedPropertyPrototypeReflection { return $this->resolve()->getUnresolvedPropertyPrototype($propertyName, $scope); } public function canCallMethods() : TrinaryLogic { return $this->resolve()->canCallMethods(); } public function hasMethod(string $methodName) : TrinaryLogic { return $this->resolve()->hasMethod($methodName); } public function getMethod(string $methodName, ClassMemberAccessAnswerer $scope) : ExtendedMethodReflection { return $this->resolve()->getMethod($methodName, $scope); } public function getUnresolvedMethodPrototype(string $methodName, ClassMemberAccessAnswerer $scope) : UnresolvedMethodPrototypeReflection { return $this->resolve()->getUnresolvedMethodPrototype($methodName, $scope); } public function canAccessConstants() : TrinaryLogic { return $this->resolve()->canAccessConstants(); } public function hasConstant(string $constantName) : TrinaryLogic { return $this->resolve()->hasConstant($constantName); } public function getConstant(string $constantName) : ConstantReflection { return $this->resolve()->getConstant($constantName); } public function isIterable() : TrinaryLogic { return $this->resolve()->isIterable(); } public function isIterableAtLeastOnce() : TrinaryLogic { return $this->resolve()->isIterableAtLeastOnce(); } public function getArraySize() : Type { return $this->resolve()->getArraySize(); } public function getIterableKeyType() : Type { return $this->resolve()->getIterableKeyType(); } public function getFirstIterableKeyType() : Type { return $this->resolve()->getFirstIterableKeyType(); } public function getLastIterableKeyType() : Type { return $this->resolve()->getLastIterableKeyType(); } public function getIterableValueType() : Type { return $this->resolve()->getIterableValueType(); } public function getFirstIterableValueType() : Type { return $this->resolve()->getFirstIterableValueType(); } public function getLastIterableValueType() : Type { return $this->resolve()->getLastIterableValueType(); } public function isArray() : TrinaryLogic { return $this->resolve()->isArray(); } public function isConstantArray() : TrinaryLogic { return $this->resolve()->isConstantArray(); } public function isOversizedArray() : TrinaryLogic { return $this->resolve()->isOversizedArray(); } public function isList() : TrinaryLogic { return $this->resolve()->isList(); } public function isOffsetAccessible() : TrinaryLogic { return $this->resolve()->isOffsetAccessible(); } public function isOffsetAccessLegal() : TrinaryLogic { return $this->resolve()->isOffsetAccessLegal(); } public function hasOffsetValueType(Type $offsetType) : TrinaryLogic { return $this->resolve()->hasOffsetValueType($offsetType); } public function getOffsetValueType(Type $offsetType) : Type { return $this->resolve()->getOffsetValueType($offsetType); } public function setOffsetValueType(?Type $offsetType, Type $valueType, bool $unionValues = \true) : Type { return $this->resolve()->setOffsetValueType($offsetType, $valueType, $unionValues); } public function setExistingOffsetValueType(Type $offsetType, Type $valueType) : Type { return $this->resolve()->setExistingOffsetValueType($offsetType, $valueType); } public function unsetOffset(Type $offsetType) : Type { return $this->resolve()->unsetOffset($offsetType); } public function getKeysArray() : Type { return $this->resolve()->getKeysArray(); } public function getValuesArray() : Type { return $this->resolve()->getValuesArray(); } public function chunkArray(Type $lengthType, TrinaryLogic $preserveKeys) : Type { return $this->resolve()->chunkArray($lengthType, $preserveKeys); } public function fillKeysArray(Type $valueType) : Type { return $this->resolve()->fillKeysArray($valueType); } public function flipArray() : Type { return $this->resolve()->flipArray(); } public function intersectKeyArray(Type $otherArraysType) : Type { return $this->resolve()->intersectKeyArray($otherArraysType); } public function popArray() : Type { return $this->resolve()->popArray(); } public function reverseArray(TrinaryLogic $preserveKeys) : Type { return $this->resolve()->reverseArray($preserveKeys); } public function searchArray(Type $needleType) : Type { return $this->resolve()->searchArray($needleType); } public function shiftArray() : Type { return $this->resolve()->shiftArray(); } public function shuffleArray() : Type { return $this->resolve()->shuffleArray(); } public function sliceArray(Type $offsetType, Type $lengthType, TrinaryLogic $preserveKeys) : Type { return $this->resolve()->sliceArray($offsetType, $lengthType, $preserveKeys); } public function isCallable() : TrinaryLogic { return $this->resolve()->isCallable(); } public function getEnumCases() : array { return $this->resolve()->getEnumCases(); } public function getCallableParametersAcceptors(ClassMemberAccessAnswerer $scope) : array { return $this->resolve()->getCallableParametersAcceptors($scope); } public function isCloneable() : TrinaryLogic { return $this->resolve()->isCloneable(); } public function toBoolean() : BooleanType { return $this->resolve()->toBoolean(); } public function toNumber() : Type { return $this->resolve()->toNumber(); } public function toAbsoluteNumber() : Type { return $this->resolve()->toAbsoluteNumber(); } public function toInteger() : Type { return $this->resolve()->toInteger(); } public function toFloat() : Type { return $this->resolve()->toFloat(); } public function toString() : Type { return $this->resolve()->toString(); } public function toArray() : Type { return $this->resolve()->toArray(); } public function toArrayKey() : Type { return $this->resolve()->toArrayKey(); } public function isSmallerThan(Type $otherType) : TrinaryLogic { return $this->resolve()->isSmallerThan($otherType); } public function isSmallerThanOrEqual(Type $otherType) : TrinaryLogic { return $this->resolve()->isSmallerThanOrEqual($otherType); } public function isNull() : TrinaryLogic { return $this->resolve()->isNull(); } public function isConstantValue() : TrinaryLogic { return $this->resolve()->isConstantValue(); } public function isConstantScalarValue() : TrinaryLogic { return $this->resolve()->isConstantScalarValue(); } public function getConstantScalarTypes() : array { return $this->resolve()->getConstantScalarTypes(); } public function getConstantScalarValues() : array { return $this->resolve()->getConstantScalarValues(); } public function isTrue() : TrinaryLogic { return $this->resolve()->isTrue(); } public function isFalse() : TrinaryLogic { return $this->resolve()->isFalse(); } public function isBoolean() : TrinaryLogic { return $this->resolve()->isBoolean(); } public function isFloat() : TrinaryLogic { return $this->resolve()->isFloat(); } public function isInteger() : TrinaryLogic { return $this->resolve()->isInteger(); } public function isString() : TrinaryLogic { return $this->resolve()->isString(); } public function isNumericString() : TrinaryLogic { return $this->resolve()->isNumericString(); } public function isNonEmptyString() : TrinaryLogic { return $this->resolve()->isNonEmptyString(); } public function isNonFalsyString() : TrinaryLogic { return $this->resolve()->isNonFalsyString(); } public function isLiteralString() : TrinaryLogic { return $this->resolve()->isLiteralString(); } public function isLowercaseString() : TrinaryLogic { return $this->resolve()->isLowercaseString(); } public function isUppercaseString() : TrinaryLogic { return $this->resolve()->isUppercaseString(); } public function isClassStringType() : TrinaryLogic { return $this->resolve()->isClassStringType(); } public function getClassStringObjectType() : Type { return $this->resolve()->getClassStringObjectType(); } public function getObjectTypeOrClassStringObjectType() : Type { return $this->resolve()->getObjectTypeOrClassStringObjectType(); } public function isVoid() : TrinaryLogic { return $this->resolve()->isVoid(); } public function isScalar() : TrinaryLogic { return $this->resolve()->isScalar(); } public function looseCompare(Type $type, PhpVersion $phpVersion) : BooleanType { return new BooleanType(); } public function getSmallerType() : Type { return $this->resolve()->getSmallerType(); } public function getSmallerOrEqualType() : Type { return $this->resolve()->getSmallerOrEqualType(); } public function getGreaterType() : Type { return $this->resolve()->getGreaterType(); } public function getGreaterOrEqualType() : Type { return $this->resolve()->getGreaterOrEqualType(); } public function inferTemplateTypes(Type $receivedType) : TemplateTypeMap { return $this->resolve()->inferTemplateTypes($receivedType); } public function tryRemove(Type $typeToRemove) : ?Type { return $this->resolve()->tryRemove($typeToRemove); } public function isSubTypeOf(Type $otherType) : TrinaryLogic { return $this->isSubTypeOfWithReason($otherType)->result; } public function isSubTypeOfWithReason(Type $otherType) : IsSuperTypeOfResult { $result = $this->resolve(); if ($result instanceof CompoundType) { return $result->isSubTypeOfWithReason($otherType); } return $otherType->isSuperTypeOfWithReason($result); } public function isAcceptedBy(Type $acceptingType, bool $strictTypes) : TrinaryLogic { return $this->isAcceptedWithReasonBy($acceptingType, $strictTypes)->result; } public function isAcceptedWithReasonBy(Type $acceptingType, bool $strictTypes) : AcceptsResult { $result = $this->resolve(); if ($result instanceof CompoundType) { return $result->isAcceptedWithReasonBy($acceptingType, $strictTypes); } return $acceptingType->acceptsWithReason($result, $strictTypes); } public function isGreaterThan(Type $otherType) : TrinaryLogic { $result = $this->resolve(); if ($result instanceof CompoundType) { return $result->isGreaterThan($otherType); } return $otherType->isSmallerThan($result); } public function isGreaterThanOrEqual(Type $otherType) : TrinaryLogic { $result = $this->resolve(); if ($result instanceof CompoundType) { return $result->isGreaterThanOrEqual($otherType); } return $otherType->isSmallerThanOrEqual($result); } public function exponentiate(Type $exponent) : Type { return $this->resolve()->exponentiate($exponent); } public function getFiniteTypes() : array { return $this->resolve()->getFiniteTypes(); } public function resolve() : Type { if ($this->result === null) { return $this->result = $this->getResult(); } return $this->result; } protected abstract function getResult() : Type; } <?php declare (strict_types=1); namespace PHPStan\Type\Traits; use PHPStan\Php\PhpVersion; use PHPStan\ShouldNotHappenException; use PHPStan\TrinaryLogic; use PHPStan\Type\AcceptsResult; use PHPStan\Type\BooleanType; use PHPStan\Type\CompoundType; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\ConstantScalarType; use PHPStan\Type\IsSuperTypeOfResult; use PHPStan\Type\LooseComparisonHelper; use PHPStan\Type\Type; trait ConstantScalarTypeTrait { public function accepts(Type $type, bool $strictTypes) : TrinaryLogic { return $this->acceptsWithReason($type, $strictTypes)->result; } public function acceptsWithReason(Type $type, bool $strictTypes) : AcceptsResult { if ($type instanceof self) { return AcceptsResult::createFromBoolean($this->equals($type)); } if ($type instanceof CompoundType) { return $type->isAcceptedWithReasonBy($this, $strictTypes); } return parent::acceptsWithReason($type, $strictTypes)->and(AcceptsResult::createMaybe()); } public function isSuperTypeOf(Type $type) : TrinaryLogic { return $this->isSuperTypeOfWithReason($type)->result; } public function isSuperTypeOfWithReason(Type $type) : IsSuperTypeOfResult { if ($type instanceof self) { return IsSuperTypeOfResult::createFromBoolean($this->equals($type)); } if ($type instanceof parent) { return IsSuperTypeOfResult::createMaybe(); } if ($type instanceof CompoundType) { return $type->isSubTypeOfWithReason($this); } return IsSuperTypeOfResult::createNo(); } public function looseCompare(Type $type, PhpVersion $phpVersion) : BooleanType { if (!$this instanceof ConstantScalarType) { throw new ShouldNotHappenException(); } if ($type instanceof ConstantScalarType) { return LooseComparisonHelper::compareConstantScalars($this, $type, $phpVersion); } if ($type->isConstantArray()->yes() && $type->isIterableAtLeastOnce()->no()) { // @phpstan-ignore equal.notAllowed, equal.invalid return new ConstantBooleanType($this->getValue() == []); // phpcs:ignore } if ($type instanceof CompoundType) { return $type->looseCompare($this, $phpVersion); } return parent::looseCompare($type, $phpVersion); } public function equals(Type $type) : bool { return $type instanceof self && $this->value === $type->value; } public function isSmallerThan(Type $otherType) : TrinaryLogic { if ($otherType instanceof ConstantScalarType) { return TrinaryLogic::createFromBoolean($this->value < $otherType->getValue()); } if ($otherType instanceof CompoundType) { return $otherType->isGreaterThan($this); } return TrinaryLogic::createMaybe(); } public function isSmallerThanOrEqual(Type $otherType) : TrinaryLogic { if ($otherType instanceof ConstantScalarType) { return TrinaryLogic::createFromBoolean($this->value <= $otherType->getValue()); } if ($otherType instanceof CompoundType) { return $otherType->isGreaterThanOrEqual($this); } return TrinaryLogic::createMaybe(); } public function isConstantValue() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isConstantScalarValue() : TrinaryLogic { return TrinaryLogic::createYes(); } public function getConstantScalarTypes() : array { return [$this]; } public function getConstantScalarValues() : array { return [$this->getValue()]; } public function getFiniteTypes() : array { return [$this]; } } <?php declare (strict_types=1); namespace PHPStan\Type\Traits; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\Generic\TemplateTypeVariance; use PHPStan\Type\Type; trait NonGenericTypeTrait { public function inferTemplateTypes(Type $receivedType) : TemplateTypeMap { return TemplateTypeMap::createEmpty(); } public function getReferencedTemplateTypes(TemplateTypeVariance $positionVariance) : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Type\Traits; use PHPStan\Reflection\ClassMemberAccessAnswerer; use PHPStan\Reflection\TrivialParametersAcceptor; use PHPStan\TrinaryLogic; trait MaybeCallableTypeTrait { public function isCallable() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getCallableParametersAcceptors(ClassMemberAccessAnswerer $scope) : array { return [new TrivialParametersAcceptor()]; } } <?php declare (strict_types=1); namespace PHPStan\Type\Traits; use PHPStan\Type\GeneralizePrecision; use PHPStan\Type\Type; trait NonGeneralizableTypeTrait { public function generalize(GeneralizePrecision $precision) : Type { return $this->traverse(static function (Type $type) use($precision) { return $type->generalize($precision); }); } } <?php declare (strict_types=1); namespace PHPStan\Type\Traits; use PHPStan\TrinaryLogic; use PHPStan\Type\ErrorType; use PHPStan\Type\Type; trait MaybeArrayTypeTrait { public function getArrays() : array { return []; } public function getConstantArrays() : array { return []; } public function isArray() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isConstantArray() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isOversizedArray() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isList() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getKeysArray() : Type { return new ErrorType(); } public function getValuesArray() : Type { return new ErrorType(); } public function chunkArray(Type $lengthType, TrinaryLogic $preserveKeys) : Type { return new ErrorType(); } public function fillKeysArray(Type $valueType) : Type { return new ErrorType(); } public function flipArray() : Type { return new ErrorType(); } public function intersectKeyArray(Type $otherArraysType) : Type { return new ErrorType(); } public function popArray() : Type { return new ErrorType(); } public function reverseArray(TrinaryLogic $preserveKeys) : Type { return new ErrorType(); } public function searchArray(Type $needleType) : Type { return new ErrorType(); } public function shiftArray() : Type { return new ErrorType(); } public function shuffleArray() : Type { return new ErrorType(); } public function sliceArray(Type $offsetType, Type $lengthType, TrinaryLogic $preserveKeys) : Type { return new ErrorType(); } } <?php declare (strict_types=1); namespace PHPStan\Type\Traits; use PHPStan\TrinaryLogic; use PHPStan\Type\Type; trait UndecidedComparisonCompoundTypeTrait { use \PHPStan\Type\Traits\UndecidedComparisonTypeTrait; public function isGreaterThan(Type $otherType) : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isGreaterThanOrEqual(Type $otherType) : TrinaryLogic { return TrinaryLogic::createMaybe(); } } <?php declare (strict_types=1); namespace PHPStan\Type\Traits; use PHPStan\TrinaryLogic; use PHPStan\Type\MixedType; use PHPStan\Type\Type; trait MaybeOffsetAccessibleTypeTrait { public function isOffsetAccessible() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function hasOffsetValueType(Type $offsetType) : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getOffsetValueType(Type $offsetType) : Type { return new MixedType(); } public function setOffsetValueType(?Type $offsetType, Type $valueType, bool $unionValues = \true) : Type { return $this; } public function setExistingOffsetValueType(Type $offsetType, Type $valueType) : Type { return $this; } public function unsetOffset(Type $offsetType) : Type { return $this; } } <?php declare (strict_types=1); namespace PHPStan\Type\Traits; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\ClassMemberAccessAnswerer; use PHPStan\Reflection\ConstantReflection; use PHPStan\Reflection\Dummy\DummyConstantReflection; use PHPStan\Reflection\Dummy\DummyMethodReflection; use PHPStan\Reflection\Dummy\DummyPropertyReflection; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\PropertyReflection; use PHPStan\Reflection\Type\CallbackUnresolvedMethodPrototypeReflection; use PHPStan\Reflection\Type\CallbackUnresolvedPropertyPrototypeReflection; use PHPStan\Reflection\Type\UnresolvedMethodPrototypeReflection; use PHPStan\Reflection\Type\UnresolvedPropertyPrototypeReflection; use PHPStan\TrinaryLogic; use PHPStan\Type\ArrayType; use PHPStan\Type\BooleanType; use PHPStan\Type\ErrorType; use PHPStan\Type\MixedType; use PHPStan\Type\StringType; use PHPStan\Type\Type; trait ObjectTypeTrait { use \PHPStan\Type\Traits\MaybeCallableTypeTrait; use \PHPStan\Type\Traits\MaybeIterableTypeTrait; use \PHPStan\Type\Traits\MaybeOffsetAccessibleTypeTrait; use \PHPStan\Type\Traits\NonArrayTypeTrait; use \PHPStan\Type\Traits\TruthyBooleanTypeTrait; public function getTemplateType(string $ancestorClassName, string $templateTypeName) : Type { return new MixedType(); } public function isObject() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isEnum() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function canAccessProperties() : TrinaryLogic { return TrinaryLogic::createYes(); } public function hasProperty(string $propertyName) : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getProperty(string $propertyName, ClassMemberAccessAnswerer $scope) : PropertyReflection { return $this->getUnresolvedPropertyPrototype($propertyName, $scope)->getTransformedProperty(); } public function getUnresolvedPropertyPrototype(string $propertyName, ClassMemberAccessAnswerer $scope) : UnresolvedPropertyPrototypeReflection { $property = new DummyPropertyReflection(); return new CallbackUnresolvedPropertyPrototypeReflection($property, $property->getDeclaringClass(), \false, static function (Type $type) : Type { return $type; }); } public function canCallMethods() : TrinaryLogic { return TrinaryLogic::createYes(); } public function hasMethod(string $methodName) : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getMethod(string $methodName, ClassMemberAccessAnswerer $scope) : ExtendedMethodReflection { return $this->getUnresolvedMethodPrototype($methodName, $scope)->getTransformedMethod(); } public function getUnresolvedMethodPrototype(string $methodName, ClassMemberAccessAnswerer $scope) : UnresolvedMethodPrototypeReflection { $method = new DummyMethodReflection($methodName); return new CallbackUnresolvedMethodPrototypeReflection($method, $method->getDeclaringClass(), \false, static function (Type $type) : Type { return $type; }); } public function canAccessConstants() : TrinaryLogic { return TrinaryLogic::createYes(); } public function hasConstant(string $constantName) : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getConstant(string $constantName) : ConstantReflection { return new DummyConstantReflection($constantName); } public function getConstantStrings() : array { return []; } public function isCloneable() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isNull() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isConstantValue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isConstantScalarValue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getConstantScalarTypes() : array { return []; } public function getConstantScalarValues() : array { return []; } public function isTrue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFalse() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isBoolean() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFloat() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isInteger() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isNumericString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isNonEmptyString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isNonFalsyString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isLiteralString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isLowercaseString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isUppercaseString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isClassStringType() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getClassStringObjectType() : Type { return new ErrorType(); } public function getObjectTypeOrClassStringObjectType() : Type { return $this; } public function isVoid() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isScalar() : TrinaryLogic { return TrinaryLogic::createNo(); } public function looseCompare(Type $type, PhpVersion $phpVersion) : BooleanType { return new BooleanType(); } public function toNumber() : Type { return new ErrorType(); } public function toAbsoluteNumber() : Type { return new ErrorType(); } public function toString() : Type { return new ErrorType(); } public function toInteger() : Type { return new ErrorType(); } public function toFloat() : Type { return new ErrorType(); } public function toArray() : Type { return new ArrayType(new MixedType(), new MixedType()); } public function toArrayKey() : Type { return new StringType(); } } <?php declare (strict_types=1); namespace PHPStan\Type\Traits; use PHPStan\Reflection\ClassMemberAccessAnswerer; use PHPStan\Reflection\ConstantReflection; use PHPStan\Reflection\Dummy\DummyConstantReflection; use PHPStan\Reflection\Dummy\DummyMethodReflection; use PHPStan\Reflection\Dummy\DummyPropertyReflection; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\PropertyReflection; use PHPStan\Reflection\Type\CallbackUnresolvedMethodPrototypeReflection; use PHPStan\Reflection\Type\CallbackUnresolvedPropertyPrototypeReflection; use PHPStan\Reflection\Type\UnresolvedMethodPrototypeReflection; use PHPStan\Reflection\Type\UnresolvedPropertyPrototypeReflection; use PHPStan\TrinaryLogic; use PHPStan\Type\MixedType; use PHPStan\Type\Type; trait MaybeObjectTypeTrait { public function getTemplateType(string $ancestorClassName, string $templateTypeName) : Type { return new MixedType(); } public function isObject() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isEnum() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function canAccessProperties() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function hasProperty(string $propertyName) : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getProperty(string $propertyName, ClassMemberAccessAnswerer $scope) : PropertyReflection { return $this->getUnresolvedPropertyPrototype($propertyName, $scope)->getTransformedProperty(); } public function getUnresolvedPropertyPrototype(string $propertyName, ClassMemberAccessAnswerer $scope) : UnresolvedPropertyPrototypeReflection { $property = new DummyPropertyReflection(); return new CallbackUnresolvedPropertyPrototypeReflection($property, $property->getDeclaringClass(), \false, static function (Type $type) : Type { return $type; }); } public function canCallMethods() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function hasMethod(string $methodName) : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getMethod(string $methodName, ClassMemberAccessAnswerer $scope) : ExtendedMethodReflection { return $this->getUnresolvedMethodPrototype($methodName, $scope)->getTransformedMethod(); } public function getUnresolvedMethodPrototype(string $methodName, ClassMemberAccessAnswerer $scope) : UnresolvedMethodPrototypeReflection { $method = new DummyMethodReflection($methodName); return new CallbackUnresolvedMethodPrototypeReflection($method, $method->getDeclaringClass(), \false, static function (Type $type) : Type { return $type; }); } public function canAccessConstants() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function hasConstant(string $constantName) : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getConstant(string $constantName) : ConstantReflection { return new DummyConstantReflection($constantName); } public function isCloneable() : TrinaryLogic { return TrinaryLogic::createMaybe(); } } <?php declare (strict_types=1); namespace PHPStan\Type\Traits; use PHPStan\Reflection\ClassMemberAccessAnswerer; use PHPStan\Reflection\ConstantReflection; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\PropertyReflection; use PHPStan\Reflection\Type\UnresolvedMethodPrototypeReflection; use PHPStan\Reflection\Type\UnresolvedPropertyPrototypeReflection; use PHPStan\ShouldNotHappenException; use PHPStan\TrinaryLogic; use PHPStan\Type\ErrorType; use PHPStan\Type\Type; trait NonObjectTypeTrait { public function isObject() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isEnum() : TrinaryLogic { return TrinaryLogic::createNo(); } public function canAccessProperties() : TrinaryLogic { return TrinaryLogic::createNo(); } public function hasProperty(string $propertyName) : TrinaryLogic { return TrinaryLogic::createNo(); } public function getProperty(string $propertyName, ClassMemberAccessAnswerer $scope) : PropertyReflection { throw new ShouldNotHappenException(); } public function getUnresolvedPropertyPrototype(string $propertyName, ClassMemberAccessAnswerer $scope) : UnresolvedPropertyPrototypeReflection { throw new ShouldNotHappenException(); } public function canCallMethods() : TrinaryLogic { return TrinaryLogic::createNo(); } public function hasMethod(string $methodName) : TrinaryLogic { return TrinaryLogic::createNo(); } public function getMethod(string $methodName, ClassMemberAccessAnswerer $scope) : ExtendedMethodReflection { throw new ShouldNotHappenException(); } public function getUnresolvedMethodPrototype(string $methodName, ClassMemberAccessAnswerer $scope) : UnresolvedMethodPrototypeReflection { throw new ShouldNotHappenException(); } public function canAccessConstants() : TrinaryLogic { return TrinaryLogic::createNo(); } public function hasConstant(string $constantName) : TrinaryLogic { return TrinaryLogic::createNo(); } public function getConstant(string $constantName) : ConstantReflection { throw new ShouldNotHappenException(); } public function getConstantStrings() : array { return []; } public function isCloneable() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getEnumCases() : array { return []; } public function getTemplateType(string $ancestorClassName, string $templateTypeName) : Type { return new ErrorType(); } } <?php declare (strict_types=1); namespace PHPStan\Type\Traits; use PHPStan\Reflection\ClassMemberAccessAnswerer; use PHPStan\ShouldNotHappenException; use PHPStan\TrinaryLogic; trait NonCallableTypeTrait { public function isCallable() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getCallableParametersAcceptors(ClassMemberAccessAnswerer $scope) : array { throw new ShouldNotHappenException(); } } <?php declare (strict_types=1); namespace PHPStan\Type\Traits; use PHPStan\TrinaryLogic; use PHPStan\Type\ErrorType; use PHPStan\Type\IntegerRangeType; use PHPStan\Type\MixedType; use PHPStan\Type\Type; trait MaybeIterableTypeTrait { public function isIterable() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isIterableAtLeastOnce() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getArraySize() : Type { if ($this->isIterable()->no()) { return new ErrorType(); } if ($this->isIterableAtLeastOnce()->yes()) { return IntegerRangeType::fromInterval(1, null); } return IntegerRangeType::fromInterval(0, null); } public function getIterableKeyType() : Type { return new MixedType(); } public function getFirstIterableKeyType() : Type { return new MixedType(); } public function getLastIterableKeyType() : Type { return new MixedType(); } public function getIterableValueType() : Type { return new MixedType(); } public function getFirstIterableValueType() : Type { return new MixedType(); } public function getLastIterableValueType() : Type { return new MixedType(); } } <?php declare (strict_types=1); namespace PHPStan\Type\Traits; use PHPStan\Type\BooleanType; use PHPStan\Type\Constant\ConstantBooleanType; trait TruthyBooleanTypeTrait { public function toBoolean() : BooleanType { return new ConstantBooleanType(\true); } } <?php declare (strict_types=1); namespace PHPStan\Type\Traits; use PHPStan\TrinaryLogic; use PHPStan\Type\ErrorType; use PHPStan\Type\Type; trait NonIterableTypeTrait { public function isIterable() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isIterableAtLeastOnce() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getArraySize() : Type { return new ErrorType(); } public function getIterableKeyType() : Type { return new ErrorType(); } public function getFirstIterableKeyType() : Type { return new ErrorType(); } public function getLastIterableKeyType() : Type { return new ErrorType(); } public function getIterableValueType() : Type { return new ErrorType(); } public function getFirstIterableValueType() : Type { return new ErrorType(); } public function getLastIterableValueType() : Type { return new ErrorType(); } } <?php declare (strict_types=1); namespace PHPStan\Type\Traits; use PHPStan\TrinaryLogic; use PHPStan\Type\ErrorType; use PHPStan\Type\Type; trait NonOffsetAccessibleTypeTrait { public function isOffsetAccessible() : TrinaryLogic { return TrinaryLogic::createNo(); } public function hasOffsetValueType(Type $offsetType) : TrinaryLogic { return TrinaryLogic::createNo(); } public function getOffsetValueType(Type $offsetType) : Type { return new ErrorType(); } public function setOffsetValueType(?Type $offsetType, Type $valueType, bool $unionValues = \true) : Type { return new ErrorType(); } public function setExistingOffsetValueType(Type $offsetType, Type $valueType) : Type { return new ErrorType(); } public function unsetOffset(Type $offsetType) : Type { return new ErrorType(); } } <?php declare (strict_types=1); namespace PHPStan\Type; use PhpParser\Node\Expr\MethodCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\MethodReflection; use PHPStan\Reflection\ParameterReflection; /** * This is the interface for parameter closure type extensions for methods. * * To register it in the configuration file use the `phpstan.methodParameterClosureTypeExtension` service tag: * * ``` * services: * - * class: App\PHPStan\MyExtension * tags: * - phpstan.methodParameterClosureTypeExtension * ``` * * @api */ interface MethodParameterClosureTypeExtension { public function isMethodSupported(MethodReflection $methodReflection, ParameterReflection $parameter) : bool; public function getTypeFromMethodCall(MethodReflection $methodReflection, MethodCall $methodCall, ParameterReflection $parameter, Scope $scope) : ?\PHPStan\Type\Type; } <?php declare (strict_types=1); namespace PHPStan\Type; /** * @template-covariant T of Type */ final class TypeResult { /** * @readonly * @var Type */ public $type; /** @var list<string> *@readonly */ public $reasons; /** * @param T $type * @param list<string> $reasons */ public function __construct(\PHPStan\Type\Type $type, array $reasons) { $this->type = $type; $this->reasons = $reasons; } } <?php declare (strict_types=1); namespace PHPStan\Type; final class DirectTypeAliasResolverProvider implements \PHPStan\Type\TypeAliasResolverProvider { /** * @var TypeAliasResolver */ private $typeAliasResolver; public function __construct(\PHPStan\Type\TypeAliasResolver $typeAliasResolver) { $this->typeAliasResolver = $typeAliasResolver; } public function getTypeAliasResolver() : \PHPStan\Type\TypeAliasResolver { return $this->typeAliasResolver; } } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\PhpDocParser\Ast\Type\GenericTypeNode; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\Type\Generic\TemplateTypeVariance; use PHPStan\Type\Traits\LateResolvableTypeTrait; use PHPStan\Type\Traits\NonGeneralizableTypeTrait; use function sprintf; /** @api */ class NewObjectType implements \PHPStan\Type\CompoundType, \PHPStan\Type\LateResolvableType { /** * @var Type */ private $type; use LateResolvableTypeTrait; use NonGeneralizableTypeTrait; public function __construct(\PHPStan\Type\Type $type) { $this->type = $type; } public function getType() : \PHPStan\Type\Type { return $this->type; } public function getReferencedClasses() : array { return $this->type->getReferencedClasses(); } public function getReferencedTemplateTypes(TemplateTypeVariance $positionVariance) : array { return $this->type->getReferencedTemplateTypes($positionVariance); } public function equals(\PHPStan\Type\Type $type) : bool { return $type instanceof self && $this->type->equals($type->type); } public function describe(\PHPStan\Type\VerbosityLevel $level) : string { return sprintf('new<%s>', $this->type->describe($level)); } public function isResolvable() : bool { return !\PHPStan\Type\TypeUtils::containsTemplateType($this->type); } protected function getResult() : \PHPStan\Type\Type { return $this->type->getObjectTypeOrClassStringObjectType(); } /** * @param callable(Type): Type $cb */ public function traverse(callable $cb) : \PHPStan\Type\Type { $type = $cb($this->type); if ($this->type === $type) { return $this; } return new self($type); } public function traverseSimultaneously(\PHPStan\Type\Type $right, callable $cb) : \PHPStan\Type\Type { if (!$right instanceof self) { return $this; } $type = $cb($this->type, $right->type); if ($this->type === $type) { return $this; } return new self($type); } public function toPhpDocNode() : TypeNode { return new GenericTypeNode(new IdentifierTypeNode('new'), [$this->type->toPhpDocNode()]); } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : \PHPStan\Type\Type { return new self($properties['type']); } } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\Php\PhpVersion; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\TrinaryLogic; use PHPStan\Type\Accessory\AccessoryLowercaseStringType; use PHPStan\Type\Accessory\AccessoryNumericStringType; use PHPStan\Type\Accessory\AccessoryUppercaseStringType; use PHPStan\Type\Constant\ConstantArrayType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Traits\NonArrayTypeTrait; use PHPStan\Type\Traits\NonCallableTypeTrait; use PHPStan\Type\Traits\NonGeneralizableTypeTrait; use PHPStan\Type\Traits\NonGenericTypeTrait; use PHPStan\Type\Traits\NonIterableTypeTrait; use PHPStan\Type\Traits\NonObjectTypeTrait; use PHPStan\Type\Traits\NonOffsetAccessibleTypeTrait; use PHPStan\Type\Traits\UndecidedBooleanTypeTrait; use PHPStan\Type\Traits\UndecidedComparisonTypeTrait; /** @api */ class IntegerType implements \PHPStan\Type\Type { use \PHPStan\Type\JustNullableTypeTrait; use NonArrayTypeTrait; use NonCallableTypeTrait; use NonIterableTypeTrait; use NonObjectTypeTrait; use UndecidedBooleanTypeTrait; use UndecidedComparisonTypeTrait; use NonGenericTypeTrait; use NonOffsetAccessibleTypeTrait; use NonGeneralizableTypeTrait; /** @api */ public function __construct() { } public function describe(\PHPStan\Type\VerbosityLevel $level) : string { return 'int'; } public function getConstantStrings() : array { return []; } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : \PHPStan\Type\Type { return new self(); } public function toNumber() : \PHPStan\Type\Type { return $this; } public function toAbsoluteNumber() : \PHPStan\Type\Type { return \PHPStan\Type\IntegerRangeType::createAllGreaterThanOrEqualTo(0); } public function toFloat() : \PHPStan\Type\Type { return new \PHPStan\Type\FloatType(); } public function toInteger() : \PHPStan\Type\Type { return $this; } public function toString() : \PHPStan\Type\Type { return new \PHPStan\Type\IntersectionType([new \PHPStan\Type\StringType(), new AccessoryLowercaseStringType(), new AccessoryUppercaseStringType(), new AccessoryNumericStringType()]); } public function toArray() : \PHPStan\Type\Type { return new ConstantArrayType([new ConstantIntegerType(0)], [$this], [1], [], TrinaryLogic::createYes()); } public function toArrayKey() : \PHPStan\Type\Type { return $this; } public function isOffsetAccessLegal() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isNull() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isTrue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFalse() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isBoolean() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFloat() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isInteger() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isScalar() : TrinaryLogic { return TrinaryLogic::createYes(); } public function looseCompare(\PHPStan\Type\Type $type, PhpVersion $phpVersion) : \PHPStan\Type\BooleanType { return new \PHPStan\Type\BooleanType(); } public function tryRemove(\PHPStan\Type\Type $typeToRemove) : ?\PHPStan\Type\Type { if ($typeToRemove instanceof \PHPStan\Type\IntegerRangeType || $typeToRemove instanceof ConstantIntegerType) { if ($typeToRemove instanceof \PHPStan\Type\IntegerRangeType) { $removeValueMin = $typeToRemove->getMin(); $removeValueMax = $typeToRemove->getMax(); } else { $removeValueMin = $typeToRemove->getValue(); $removeValueMax = $typeToRemove->getValue(); } $lowerPart = $removeValueMin !== null ? \PHPStan\Type\IntegerRangeType::fromInterval(null, $removeValueMin, -1) : null; $upperPart = $removeValueMax !== null ? \PHPStan\Type\IntegerRangeType::fromInterval($removeValueMax, null, +1) : null; if ($lowerPart !== null && $upperPart !== null) { return new \PHPStan\Type\UnionType([$lowerPart, $upperPart]); } return $lowerPart ?? $upperPart ?? new \PHPStan\Type\NeverType(); } return null; } public function getFiniteTypes() : array { return []; } public function exponentiate(\PHPStan\Type\Type $exponent) : \PHPStan\Type\Type { return \PHPStan\Type\ExponentiateHelper::exponentiate($this, $exponent); } public function toPhpDocNode() : TypeNode { return new IdentifierTypeNode('int'); } } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\Php\PhpVersion; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\TrinaryLogic; use PHPStan\Type\Traits\FalseyBooleanTypeTrait; use PHPStan\Type\Traits\NonArrayTypeTrait; use PHPStan\Type\Traits\NonCallableTypeTrait; use PHPStan\Type\Traits\NonGeneralizableTypeTrait; use PHPStan\Type\Traits\NonGenericTypeTrait; use PHPStan\Type\Traits\NonIterableTypeTrait; use PHPStan\Type\Traits\NonObjectTypeTrait; use PHPStan\Type\Traits\NonOffsetAccessibleTypeTrait; use PHPStan\Type\Traits\NonRemoveableTypeTrait; use PHPStan\Type\Traits\UndecidedComparisonTypeTrait; /** @api */ class VoidType implements \PHPStan\Type\Type { use NonArrayTypeTrait; use NonCallableTypeTrait; use NonIterableTypeTrait; use NonObjectTypeTrait; use NonOffsetAccessibleTypeTrait; use FalseyBooleanTypeTrait; use NonGenericTypeTrait; use UndecidedComparisonTypeTrait; use NonRemoveableTypeTrait; use NonGeneralizableTypeTrait; /** @api */ public function __construct() { } /** * @return string[] */ public function getReferencedClasses() : array { return []; } public function getObjectClassNames() : array { return []; } public function getObjectClassReflections() : array { return []; } public function accepts(\PHPStan\Type\Type $type, bool $strictTypes) : TrinaryLogic { return $this->acceptsWithReason($type, $strictTypes)->result; } public function acceptsWithReason(\PHPStan\Type\Type $type, bool $strictTypes) : \PHPStan\Type\AcceptsResult { if ($type instanceof \PHPStan\Type\CompoundType) { return $type->isAcceptedWithReasonBy($this, $strictTypes); } return new \PHPStan\Type\AcceptsResult($type->isVoid()->or($type->isNull()), []); } public function isSuperTypeOf(\PHPStan\Type\Type $type) : TrinaryLogic { return $this->isSuperTypeOfWithReason($type)->result; } public function isSuperTypeOfWithReason(\PHPStan\Type\Type $type) : \PHPStan\Type\IsSuperTypeOfResult { if ($type instanceof self) { return \PHPStan\Type\IsSuperTypeOfResult::createYes(); } if ($type instanceof \PHPStan\Type\CompoundType) { return $type->isSubTypeOfWithReason($this); } return \PHPStan\Type\IsSuperTypeOfResult::createNo(); } public function equals(\PHPStan\Type\Type $type) : bool { return $type instanceof self; } public function describe(\PHPStan\Type\VerbosityLevel $level) : string { return 'void'; } public function toNumber() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toAbsoluteNumber() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toString() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toInteger() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toFloat() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toArray() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toArrayKey() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function isOffsetAccessLegal() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isNull() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isConstantValue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isConstantScalarValue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getConstantScalarTypes() : array { return []; } public function getConstantScalarValues() : array { return []; } public function isTrue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFalse() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isBoolean() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFloat() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isInteger() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isNumericString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isNonEmptyString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isNonFalsyString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isLiteralString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isLowercaseString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isUppercaseString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isClassStringType() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getClassStringObjectType() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function getObjectTypeOrClassStringObjectType() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function isVoid() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isScalar() : TrinaryLogic { return TrinaryLogic::createNo(); } public function looseCompare(\PHPStan\Type\Type $type, PhpVersion $phpVersion) : \PHPStan\Type\BooleanType { return new \PHPStan\Type\BooleanType(); } public function traverse(callable $cb) : \PHPStan\Type\Type { return $this; } public function traverseSimultaneously(\PHPStan\Type\Type $right, callable $cb) : \PHPStan\Type\Type { return $this; } public function exponentiate(\PHPStan\Type\Type $exponent) : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function getFiniteTypes() : array { return []; } public function toPhpDocNode() : TypeNode { return new IdentifierTypeNode('void'); } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : \PHPStan\Type\Type { return new self(); } } <?php declare (strict_types=1); namespace PHPStan\Type; use PhpParser\Node\Expr; use PHPStan\Analyser\Scope; /** * To register it in the configuration file use the `phpstan.broker.expressionTypeResolverExtension` service tag: * * ``` * services: * - * class: App\PHPStan\MyExtension * tags: * - phpstan.broker.expressionTypeResolverExtension * ``` * * You should return null in your extension if you don't care about given Expr. * * @api */ interface ExpressionTypeResolverExtension { public function getType(Expr $expr, Scope $scope) : ?\PHPStan\Type\Type; } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\Php\PhpVersion; use PHPStan\PhpDocParser\Ast\ConstExpr\ConstExprIntegerNode; use PHPStan\PhpDocParser\Ast\Type\ConstTypeNode; use PHPStan\PhpDocParser\Ast\Type\GenericTypeNode; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\Reflection\InitializerExprTypeResolver; use PHPStan\TrinaryLogic; use PHPStan\Type\Accessory\AccessoryLowercaseStringType; use PHPStan\Type\Accessory\AccessoryNonFalsyStringType; use PHPStan\Type\Accessory\AccessoryNumericStringType; use PHPStan\Type\Accessory\AccessoryUppercaseStringType; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantIntegerType; use function array_filter; use function array_map; use function assert; use function ceil; use function count; use function floor; use function get_class; use function is_float; use function is_int; use function max; use function min; use function sprintf; use const PHP_INT_MAX; use const PHP_INT_MIN; /** @api */ class IntegerRangeType extends \PHPStan\Type\IntegerType implements \PHPStan\Type\CompoundType { /** * @var ?int */ private $min; /** * @var ?int */ private $max; private function __construct(?int $min, ?int $max) { $this->min = $min; $this->max = $max; parent::__construct(); assert($min === null || $max === null || $min <= $max); assert($min !== null || $max !== null); } public static function fromInterval(?int $min, ?int $max, int $shift = 0) : \PHPStan\Type\Type { if ($min !== null && $max !== null) { if ($min > $max) { return new \PHPStan\Type\NeverType(); } if ($min === $max) { return new ConstantIntegerType($min + $shift); } } if ($min === null && $max === null) { return new \PHPStan\Type\IntegerType(); } return (new self($min, $max))->shift($shift); } protected static function isDisjoint(?int $minA, ?int $maxA, ?int $minB, ?int $maxB, bool $touchingIsDisjoint = \true) : bool { $offset = $touchingIsDisjoint ? 0 : 1; return $minA !== null && $maxB !== null && $minA > $maxB + $offset || $maxA !== null && $minB !== null && $maxA + $offset < $minB; } /** * Return the range of integers smaller than the given value * * @param int|float $value */ public static function createAllSmallerThan($value) : \PHPStan\Type\Type { if (is_int($value)) { return self::fromInterval(null, $value, -1); } if ($value > PHP_INT_MAX) { return new \PHPStan\Type\IntegerType(); } if ($value <= PHP_INT_MIN) { return new \PHPStan\Type\NeverType(); } return self::fromInterval(null, (int) ceil($value), -1); } /** * Return the range of integers smaller than or equal to the given value * * @param int|float $value */ public static function createAllSmallerThanOrEqualTo($value) : \PHPStan\Type\Type { if (is_int($value)) { return self::fromInterval(null, $value); } if ($value >= PHP_INT_MAX) { return new \PHPStan\Type\IntegerType(); } if ($value < PHP_INT_MIN) { return new \PHPStan\Type\NeverType(); } return self::fromInterval(null, (int) floor($value)); } /** * Return the range of integers greater than the given value * * @param int|float $value */ public static function createAllGreaterThan($value) : \PHPStan\Type\Type { if (is_int($value)) { return self::fromInterval($value, null, 1); } if ($value < PHP_INT_MIN) { return new \PHPStan\Type\IntegerType(); } if ($value >= PHP_INT_MAX) { return new \PHPStan\Type\NeverType(); } return self::fromInterval((int) floor($value), null, 1); } /** * Return the range of integers greater than or equal to the given value * * @param int|float $value */ public static function createAllGreaterThanOrEqualTo($value) : \PHPStan\Type\Type { if (is_int($value)) { return self::fromInterval($value, null); } if ($value <= PHP_INT_MIN) { return new \PHPStan\Type\IntegerType(); } if ($value > PHP_INT_MAX) { return new \PHPStan\Type\NeverType(); } return self::fromInterval((int) ceil($value), null); } public function getMin() : ?int { return $this->min; } public function getMax() : ?int { return $this->max; } public function describe(\PHPStan\Type\VerbosityLevel $level) : string { return sprintf('int<%s, %s>', $this->min ?? 'min', $this->max ?? 'max'); } public function shift(int $amount) : \PHPStan\Type\Type { if ($amount === 0) { return $this; } $min = $this->min; $max = $this->max; if ($amount < 0) { if ($max !== null) { if ($max < PHP_INT_MIN - $amount) { return new \PHPStan\Type\NeverType(); } $max += $amount; } if ($min !== null) { $min = $min < PHP_INT_MIN - $amount ? null : $min + $amount; } } else { if ($min !== null) { if ($min > PHP_INT_MAX - $amount) { return new \PHPStan\Type\NeverType(); } $min += $amount; } if ($max !== null) { $max = $max > PHP_INT_MAX - $amount ? null : $max + $amount; } } return self::fromInterval($min, $max); } public function accepts(\PHPStan\Type\Type $type, bool $strictTypes) : TrinaryLogic { return $this->acceptsWithReason($type, $strictTypes)->result; } public function acceptsWithReason(\PHPStan\Type\Type $type, bool $strictTypes) : \PHPStan\Type\AcceptsResult { if ($type instanceof parent) { return $this->isSuperTypeOfWithReason($type)->toAcceptsResult(); } if ($type instanceof \PHPStan\Type\CompoundType) { return $type->isAcceptedWithReasonBy($this, $strictTypes); } return \PHPStan\Type\AcceptsResult::createNo(); } public function isSuperTypeOf(\PHPStan\Type\Type $type) : TrinaryLogic { return $this->isSuperTypeOfWithReason($type)->result; } public function isSuperTypeOfWithReason(\PHPStan\Type\Type $type) : \PHPStan\Type\IsSuperTypeOfResult { if ($type instanceof self || $type instanceof ConstantIntegerType) { if ($type instanceof self) { $typeMin = $type->min; $typeMax = $type->max; } else { $typeMin = $type->getValue(); $typeMax = $type->getValue(); } if (self::isDisjoint($this->min, $this->max, $typeMin, $typeMax)) { return \PHPStan\Type\IsSuperTypeOfResult::createNo(); } if (($this->min === null || $typeMin !== null && $this->min <= $typeMin) && ($this->max === null || $typeMax !== null && $this->max >= $typeMax)) { return \PHPStan\Type\IsSuperTypeOfResult::createYes(); } return \PHPStan\Type\IsSuperTypeOfResult::createMaybe(); } if ($type instanceof parent) { return \PHPStan\Type\IsSuperTypeOfResult::createMaybe(); } if ($type instanceof \PHPStan\Type\CompoundType) { return $type->isSubTypeOfWithReason($this); } return \PHPStan\Type\IsSuperTypeOfResult::createNo(); } public function isSubTypeOf(\PHPStan\Type\Type $otherType) : TrinaryLogic { return $this->isSubTypeOfWithReason($otherType)->result; } public function isSubTypeOfWithReason(\PHPStan\Type\Type $otherType) : \PHPStan\Type\IsSuperTypeOfResult { if ($otherType instanceof parent) { return $otherType->isSuperTypeOfWithReason($this); } if ($otherType instanceof \PHPStan\Type\UnionType) { return $this->isSubTypeOfUnionWithReason($otherType); } if ($otherType instanceof \PHPStan\Type\IntersectionType) { return $otherType->isSuperTypeOfWithReason($this); } return \PHPStan\Type\IsSuperTypeOfResult::createNo(); } private function isSubTypeOfUnionWithReason(\PHPStan\Type\UnionType $otherType) : \PHPStan\Type\IsSuperTypeOfResult { if ($this->min !== null && $this->max !== null) { $matchingConstantIntegers = array_filter($otherType->getTypes(), function (\PHPStan\Type\Type $type) : bool { return $type instanceof ConstantIntegerType && $type->getValue() >= $this->min && $type->getValue() <= $this->max; }); if (count($matchingConstantIntegers) === $this->max - $this->min + 1) { return \PHPStan\Type\IsSuperTypeOfResult::createYes(); } } return \PHPStan\Type\IsSuperTypeOfResult::createNo()->or(...array_map(function (\PHPStan\Type\Type $innerType) { return $this->isSubTypeOfWithReason($innerType); }, $otherType->getTypes())); } public function isAcceptedBy(\PHPStan\Type\Type $acceptingType, bool $strictTypes) : TrinaryLogic { return $this->isAcceptedWithReasonBy($acceptingType, $strictTypes)->result; } public function isAcceptedWithReasonBy(\PHPStan\Type\Type $acceptingType, bool $strictTypes) : \PHPStan\Type\AcceptsResult { return $this->isSubTypeOfWithReason($acceptingType)->toAcceptsResult(); } public function equals(\PHPStan\Type\Type $type) : bool { return $type instanceof self && $this->min === $type->min && $this->max === $type->max; } public function generalize(\PHPStan\Type\GeneralizePrecision $precision) : \PHPStan\Type\Type { return new \PHPStan\Type\IntegerType(); } public function isSmallerThan(\PHPStan\Type\Type $otherType) : TrinaryLogic { if ($this->min === null) { $minIsSmaller = TrinaryLogic::createYes(); } else { $minIsSmaller = (new ConstantIntegerType($this->min))->isSmallerThan($otherType); } if ($this->max === null) { $maxIsSmaller = TrinaryLogic::createNo(); } else { $maxIsSmaller = (new ConstantIntegerType($this->max))->isSmallerThan($otherType); } return TrinaryLogic::extremeIdentity($minIsSmaller, $maxIsSmaller); } public function isSmallerThanOrEqual(\PHPStan\Type\Type $otherType) : TrinaryLogic { if ($this->min === null) { $minIsSmaller = TrinaryLogic::createYes(); } else { $minIsSmaller = (new ConstantIntegerType($this->min))->isSmallerThanOrEqual($otherType); } if ($this->max === null) { $maxIsSmaller = TrinaryLogic::createNo(); } else { $maxIsSmaller = (new ConstantIntegerType($this->max))->isSmallerThanOrEqual($otherType); } return TrinaryLogic::extremeIdentity($minIsSmaller, $maxIsSmaller); } public function isGreaterThan(\PHPStan\Type\Type $otherType) : TrinaryLogic { if ($this->min === null) { $minIsSmaller = TrinaryLogic::createNo(); } else { $minIsSmaller = $otherType->isSmallerThan(new ConstantIntegerType($this->min)); } if ($this->max === null) { $maxIsSmaller = TrinaryLogic::createYes(); } else { $maxIsSmaller = $otherType->isSmallerThan(new ConstantIntegerType($this->max)); } return TrinaryLogic::extremeIdentity($minIsSmaller, $maxIsSmaller); } public function isGreaterThanOrEqual(\PHPStan\Type\Type $otherType) : TrinaryLogic { if ($this->min === null) { $minIsSmaller = TrinaryLogic::createNo(); } else { $minIsSmaller = $otherType->isSmallerThanOrEqual(new ConstantIntegerType($this->min)); } if ($this->max === null) { $maxIsSmaller = TrinaryLogic::createYes(); } else { $maxIsSmaller = $otherType->isSmallerThanOrEqual(new ConstantIntegerType($this->max)); } return TrinaryLogic::extremeIdentity($minIsSmaller, $maxIsSmaller); } public function getSmallerType() : \PHPStan\Type\Type { $subtractedTypes = [new ConstantBooleanType(\true)]; if ($this->max !== null) { $subtractedTypes[] = self::createAllGreaterThanOrEqualTo($this->max); } return \PHPStan\Type\TypeCombinator::remove(new \PHPStan\Type\MixedType(), \PHPStan\Type\TypeCombinator::union(...$subtractedTypes)); } public function getSmallerOrEqualType() : \PHPStan\Type\Type { $subtractedTypes = []; if ($this->max !== null) { $subtractedTypes[] = self::createAllGreaterThan($this->max); } return \PHPStan\Type\TypeCombinator::remove(new \PHPStan\Type\MixedType(), \PHPStan\Type\TypeCombinator::union(...$subtractedTypes)); } public function getGreaterType() : \PHPStan\Type\Type { $subtractedTypes = [new \PHPStan\Type\NullType(), new ConstantBooleanType(\false)]; if ($this->min !== null) { $subtractedTypes[] = self::createAllSmallerThanOrEqualTo($this->min); } if ($this->min !== null && $this->min > 0 || $this->max !== null && $this->max < 0) { $subtractedTypes[] = new ConstantBooleanType(\true); } return \PHPStan\Type\TypeCombinator::remove(new \PHPStan\Type\MixedType(), \PHPStan\Type\TypeCombinator::union(...$subtractedTypes)); } public function getGreaterOrEqualType() : \PHPStan\Type\Type { $subtractedTypes = []; if ($this->min !== null) { $subtractedTypes[] = self::createAllSmallerThan($this->min); } if ($this->min !== null && $this->min > 0 || $this->max !== null && $this->max < 0) { $subtractedTypes[] = new \PHPStan\Type\NullType(); $subtractedTypes[] = new ConstantBooleanType(\false); } return \PHPStan\Type\TypeCombinator::remove(new \PHPStan\Type\MixedType(), \PHPStan\Type\TypeCombinator::union(...$subtractedTypes)); } public function toBoolean() : \PHPStan\Type\BooleanType { $isZero = (new ConstantIntegerType(0))->isSuperTypeOf($this); if ($isZero->no()) { return new ConstantBooleanType(\true); } if ($isZero->maybe()) { return new \PHPStan\Type\BooleanType(); } return new ConstantBooleanType(\false); } public function toAbsoluteNumber() : \PHPStan\Type\Type { if ($this->min !== null && $this->min >= 0) { return $this; } if ($this->max === null || $this->max >= 0) { $inversedMin = $this->min !== null ? $this->min * -1 : null; return self::fromInterval(0, $inversedMin !== null && $this->max !== null ? max($inversedMin, $this->max) : null); } return self::fromInterval($this->max * -1, $this->min !== null ? $this->min * -1 : null); } public function toString() : \PHPStan\Type\Type { $finiteTypes = $this->getFiniteTypes(); if ($finiteTypes !== []) { return \PHPStan\Type\TypeCombinator::union(...$finiteTypes)->toString(); } $isZero = (new ConstantIntegerType(0))->isSuperTypeOf($this); if ($isZero->no()) { return new \PHPStan\Type\IntersectionType([new \PHPStan\Type\StringType(), new AccessoryLowercaseStringType(), new AccessoryUppercaseStringType(), new AccessoryNumericStringType(), new AccessoryNonFalsyStringType()]); } return new \PHPStan\Type\IntersectionType([new \PHPStan\Type\StringType(), new AccessoryLowercaseStringType(), new AccessoryUppercaseStringType(), new AccessoryNumericStringType()]); } /** * Return the union with another type, but only if it can be expressed in a simpler way than using UnionType * */ public function tryUnion(\PHPStan\Type\Type $otherType) : ?\PHPStan\Type\Type { if ($otherType instanceof self || $otherType instanceof ConstantIntegerType) { if ($otherType instanceof self) { $otherMin = $otherType->min; $otherMax = $otherType->max; } else { $otherMin = $otherType->getValue(); $otherMax = $otherType->getValue(); } if (self::isDisjoint($this->min, $this->max, $otherMin, $otherMax, \false)) { return null; } return self::fromInterval($this->min !== null && $otherMin !== null ? min($this->min, $otherMin) : null, $this->max !== null && $otherMax !== null ? max($this->max, $otherMax) : null); } if (get_class($otherType) === parent::class) { return $otherType; } return null; } /** * Return the intersection with another type, but only if it can be expressed in a simpler way than using * IntersectionType * */ public function tryIntersect(\PHPStan\Type\Type $otherType) : ?\PHPStan\Type\Type { if ($otherType instanceof self || $otherType instanceof ConstantIntegerType) { if ($otherType instanceof self) { $otherMin = $otherType->min; $otherMax = $otherType->max; } else { $otherMin = $otherType->getValue(); $otherMax = $otherType->getValue(); } if (self::isDisjoint($this->min, $this->max, $otherMin, $otherMax, \false)) { return new \PHPStan\Type\NeverType(); } if ($this->min === null) { $newMin = $otherMin; } elseif ($otherMin === null) { $newMin = $this->min; } else { $newMin = max($this->min, $otherMin); } if ($this->max === null) { $newMax = $otherMax; } elseif ($otherMax === null) { $newMax = $this->max; } else { $newMax = min($this->max, $otherMax); } return self::fromInterval($newMin, $newMax); } if (get_class($otherType) === parent::class) { return $this; } return null; } /** * Return the different with another type, or null if it cannot be represented. * */ public function tryRemove(\PHPStan\Type\Type $typeToRemove) : ?\PHPStan\Type\Type { if (get_class($typeToRemove) === parent::class) { return new \PHPStan\Type\NeverType(); } if ($typeToRemove instanceof self || $typeToRemove instanceof ConstantIntegerType) { if ($typeToRemove instanceof self) { $removeMin = $typeToRemove->min; $removeMax = $typeToRemove->max; } else { $removeMin = $typeToRemove->getValue(); $removeMax = $typeToRemove->getValue(); } if ($this->min !== null && $removeMax !== null && $removeMax < $this->min || $this->max !== null && $removeMin !== null && $this->max < $removeMin) { return $this; } if ($removeMin !== null && $removeMin !== PHP_INT_MIN) { $lowerPart = self::fromInterval($this->min, $removeMin - 1); } else { $lowerPart = null; } if ($removeMax !== null && $removeMax !== PHP_INT_MAX) { $upperPart = self::fromInterval($removeMax + 1, $this->max); } else { $upperPart = null; } if ($lowerPart !== null && $upperPart !== null) { return \PHPStan\Type\TypeCombinator::union($lowerPart, $upperPart); } return $lowerPart ?? $upperPart; } return null; } public function exponentiate(\PHPStan\Type\Type $exponent) : \PHPStan\Type\Type { if ($exponent instanceof \PHPStan\Type\UnionType) { $results = []; foreach ($exponent->getTypes() as $unionType) { $results[] = $this->exponentiate($unionType); } return \PHPStan\Type\TypeCombinator::union(...$results); } if ($exponent instanceof \PHPStan\Type\IntegerRangeType) { $min = null; $max = null; if ($this->getMin() !== null && $exponent->getMin() !== null) { $min = $this->getMin() ** $exponent->getMin(); } if ($this->getMax() !== null && $exponent->getMax() !== null) { $max = $this->getMax() ** $exponent->getMax(); } if (($min !== null || $max !== null) && !is_float($min) && !is_float($max)) { return self::fromInterval($min, $max); } } if ($exponent instanceof \PHPStan\Type\ConstantScalarType) { $exponentValue = $exponent->getValue(); if (is_int($exponentValue)) { $min = null; $max = null; if ($this->getMin() !== null) { $min = $this->getMin() ** $exponentValue; } if ($this->getMax() !== null) { $max = $this->getMax() ** $exponentValue; } if (!is_float($min) && !is_float($max)) { return self::fromInterval($min, $max); } } } return parent::exponentiate($exponent); } /** * @return list<ConstantIntegerType> */ public function getFiniteTypes() : array { if ($this->min === null || $this->max === null) { return []; } $size = $this->max - $this->min; if ($size > InitializerExprTypeResolver::CALCULATE_SCALARS_LIMIT) { return []; } $types = []; for ($i = $this->min; $i <= $this->max; $i++) { $types[] = new ConstantIntegerType($i); } return $types; } public function toPhpDocNode() : TypeNode { if ($this->min === null) { $min = new IdentifierTypeNode('min'); } else { $min = new ConstTypeNode(new ConstExprIntegerNode((string) $this->min)); } if ($this->max === null) { $max = new IdentifierTypeNode('max'); } else { $max = new ConstTypeNode(new ConstExprIntegerNode((string) $this->max)); } return new GenericTypeNode(new IdentifierTypeNode('int'), [$min, $max]); } public function looseCompare(\PHPStan\Type\Type $type, PhpVersion $phpVersion) : \PHPStan\Type\BooleanType { if ($this->isSmallerThan($type)->yes() || $this->isGreaterThan($type)->yes()) { return new ConstantBooleanType(\false); } return parent::looseCompare($type, $phpVersion); } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : \PHPStan\Type\Type { return new self($properties['min'], $properties['max']); } } <?php declare (strict_types=1); namespace PHPStan\Type; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; /** * This is the interface dynamic throw type extensions implement for functions. * * To register it in the configuration file use the `phpstan.dynamicFunctionThrowTypeExtension` service tag: * * ``` * services: * - * class: App\PHPStan\MyExtension * tags: * - phpstan.dynamicFunctionThrowTypeExtension * ``` * * Learn more: https://phpstan.org/developing-extensions/dynamic-throw-type-extensions * * @api */ interface DynamicFunctionThrowTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool; public function getThrowTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $funcCall, Scope $scope) : ?\PHPStan\Type\Type; } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\TrinaryLogic; use function get_class; trait JustNullableTypeTrait { /** * @return string[] */ public function getReferencedClasses() : array { return []; } public function getObjectClassNames() : array { return []; } public function getObjectClassReflections() : array { return []; } public function accepts(\PHPStan\Type\Type $type, bool $strictTypes) : TrinaryLogic { return $this->acceptsWithReason($type, $strictTypes)->result; } public function acceptsWithReason(\PHPStan\Type\Type $type, bool $strictTypes) : \PHPStan\Type\AcceptsResult { if ($type instanceof static) { return \PHPStan\Type\AcceptsResult::createYes(); } if ($type instanceof \PHPStan\Type\CompoundType) { return $type->isAcceptedWithReasonBy($this, $strictTypes); } return \PHPStan\Type\AcceptsResult::createNo(); } public function isSuperTypeOf(\PHPStan\Type\Type $type) : TrinaryLogic { return $this->isSuperTypeOfWithReason($type)->result; } public function isSuperTypeOfWithReason(\PHPStan\Type\Type $type) : \PHPStan\Type\IsSuperTypeOfResult { if ($type instanceof self) { return \PHPStan\Type\IsSuperTypeOfResult::createYes(); } if ($type instanceof \PHPStan\Type\CompoundType) { return $type->isSubTypeOfWithReason($this); } return \PHPStan\Type\IsSuperTypeOfResult::createNo(); } public function equals(\PHPStan\Type\Type $type) : bool { return get_class($type) === static::class; } public function traverse(callable $cb) : \PHPStan\Type\Type { return $this; } public function traverseSimultaneously(\PHPStan\Type\Type $right, callable $cb) : \PHPStan\Type\Type { return $this; } public function isNull() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isConstantValue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isConstantScalarValue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getConstantScalarTypes() : array { return []; } public function getConstantScalarValues() : array { return []; } public function isTrue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFalse() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isBoolean() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFloat() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isInteger() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isNumericString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isNonEmptyString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isNonFalsyString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isLiteralString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isLowercaseString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isUppercaseString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isClassStringType() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getClassStringObjectType() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function getObjectTypeOrClassStringObjectType() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function isVoid() : TrinaryLogic { return TrinaryLogic::createNo(); } } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\Type\Generic\TemplateTypeHelper; /** * @api * @final */ class GenericTypeVariableResolver { /** * @deprecated Use Type::getTemplateType() instead. */ public static function getType(\PHPStan\Type\TypeWithClassName $type, string $genericClassName, string $typeVariableName) : ?\PHPStan\Type\Type { $classReflection = $type->getClassReflection(); if ($classReflection === null) { return null; } $ancestorClassReflection = $classReflection->getAncestorWithClassName($genericClassName); if ($ancestorClassReflection === null) { return null; } $activeTemplateTypeMap = $ancestorClassReflection->getPossiblyIncompleteActiveTemplateTypeMap(); $type = $activeTemplateTypeMap->getType($typeVariableName); if ($type instanceof \PHPStan\Type\ErrorType) { $templateTypeMap = $ancestorClassReflection->getTemplateTypeMap(); $templateType = $templateTypeMap->getType($typeVariableName); if ($templateType === null) { return $type; } $bound = TemplateTypeHelper::resolveToBounds($templateType); if ($bound instanceof \PHPStan\Type\MixedType && $bound->isExplicitMixed()) { return new \PHPStan\Type\MixedType(\false); } return TemplateTypeHelper::resolveToDefaults($templateType); } return $type; } } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\DependencyInjection\Container; final class LazyTypeAliasResolverProvider implements \PHPStan\Type\TypeAliasResolverProvider { /** * @var Container */ private $container; public function __construct(Container $container) { $this->container = $container; } public function getTypeAliasResolver() : \PHPStan\Type\TypeAliasResolver { return $this->container->getByType(\PHPStan\Type\TypeAliasResolver::class); } } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\Analyser\NameScope; interface TypeAliasResolver { public function hasTypeAlias(string $aliasName, ?string $classNameScope) : bool; public function resolveTypeAlias(string $aliasName, NameScope $nameScope) : ?\PHPStan\Type\Type; } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\Php\PhpVersion; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\Reflection\ClassMemberAccessAnswerer; use PHPStan\Reflection\ConstantReflection; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\PropertyReflection; use PHPStan\Reflection\Type\UnresolvedMethodPrototypeReflection; use PHPStan\Reflection\Type\UnresolvedPropertyPrototypeReflection; use PHPStan\ShouldNotHappenException; use PHPStan\TrinaryLogic; use PHPStan\Type\Traits\NonArrayTypeTrait; use PHPStan\Type\Traits\NonCallableTypeTrait; use PHPStan\Type\Traits\NonGeneralizableTypeTrait; use PHPStan\Type\Traits\NonGenericTypeTrait; use PHPStan\Type\Traits\NonIterableTypeTrait; use PHPStan\Type\Traits\NonOffsetAccessibleTypeTrait; use PHPStan\Type\Traits\NonRemoveableTypeTrait; use PHPStan\Type\Traits\TruthyBooleanTypeTrait; use PHPStan\Type\Traits\UndecidedComparisonTypeTrait; class NonexistentParentClassType implements \PHPStan\Type\Type { use \PHPStan\Type\JustNullableTypeTrait; use NonArrayTypeTrait; use NonCallableTypeTrait; use NonIterableTypeTrait; use NonOffsetAccessibleTypeTrait; use TruthyBooleanTypeTrait; use NonGenericTypeTrait; use UndecidedComparisonTypeTrait; use NonRemoveableTypeTrait; use NonGeneralizableTypeTrait; public function describe(\PHPStan\Type\VerbosityLevel $level) : string { return 'parent'; } public function getTemplateType(string $ancestorClassName, string $templateTypeName) : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function isObject() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isEnum() : TrinaryLogic { return TrinaryLogic::createNo(); } public function canAccessProperties() : TrinaryLogic { return TrinaryLogic::createNo(); } public function hasProperty(string $propertyName) : TrinaryLogic { return TrinaryLogic::createNo(); } public function getProperty(string $propertyName, ClassMemberAccessAnswerer $scope) : PropertyReflection { throw new ShouldNotHappenException(); } public function getUnresolvedPropertyPrototype(string $propertyName, ClassMemberAccessAnswerer $scope) : UnresolvedPropertyPrototypeReflection { throw new ShouldNotHappenException(); } public function canCallMethods() : TrinaryLogic { return TrinaryLogic::createNo(); } public function hasMethod(string $methodName) : TrinaryLogic { return TrinaryLogic::createNo(); } public function getMethod(string $methodName, ClassMemberAccessAnswerer $scope) : ExtendedMethodReflection { throw new ShouldNotHappenException(); } public function getUnresolvedMethodPrototype(string $methodName, ClassMemberAccessAnswerer $scope) : UnresolvedMethodPrototypeReflection { throw new ShouldNotHappenException(); } public function canAccessConstants() : TrinaryLogic { return TrinaryLogic::createNo(); } public function hasConstant(string $constantName) : TrinaryLogic { return TrinaryLogic::createNo(); } public function getConstant(string $constantName) : ConstantReflection { throw new ShouldNotHappenException(); } public function getConstantStrings() : array { return []; } public function isCloneable() : TrinaryLogic { return TrinaryLogic::createNo(); } public function toNumber() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toAbsoluteNumber() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toString() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toInteger() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toFloat() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toArray() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toArrayKey() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function isOffsetAccessLegal() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isScalar() : TrinaryLogic { return TrinaryLogic::createNo(); } public function looseCompare(\PHPStan\Type\Type $type, PhpVersion $phpVersion) : \PHPStan\Type\BooleanType { return new \PHPStan\Type\BooleanType(); } public function getEnumCases() : array { return []; } public function exponentiate(\PHPStan\Type\Type $exponent) : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function getFiniteTypes() : array { return []; } public function toPhpDocNode() : TypeNode { return new IdentifierTypeNode('parent'); } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : \PHPStan\Type\Type { return new self(); } } <?php declare (strict_types=1); namespace PHPStan\Type; use Closure; use PHPStan\Analyser\OutOfClassScope; use PHPStan\Node\InvalidateExprNode; use PHPStan\Php\PhpVersion; use PHPStan\PhpDoc\Tag\TemplateTag; use PHPStan\PhpDocParser\Ast\PhpDoc\TemplateTagValueNode; use PHPStan\PhpDocParser\Ast\Type\CallableTypeNode; use PHPStan\PhpDocParser\Ast\Type\CallableTypeParameterNode; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\PhpDocParser\Printer\Printer; use PHPStan\Reflection\Callables\CallableParametersAcceptor; use PHPStan\Reflection\Callables\SimpleImpurePoint; use PHPStan\Reflection\Callables\SimpleThrowPoint; use PHPStan\Reflection\ClassMemberAccessAnswerer; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ConstantReflection; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\Native\NativeParameterReflection; use PHPStan\Reflection\ParameterReflection; use PHPStan\Reflection\ParametersAcceptor; use PHPStan\Reflection\ParametersAcceptorSelector; use PHPStan\Reflection\PassedByReference; use PHPStan\Reflection\Php\ClosureCallUnresolvedMethodPrototypeReflection; use PHPStan\Reflection\Php\DummyParameter; use PHPStan\Reflection\PropertyReflection; use PHPStan\Reflection\Type\UnresolvedMethodPrototypeReflection; use PHPStan\Reflection\Type\UnresolvedPropertyPrototypeReflection; use PHPStan\TrinaryLogic; use PHPStan\Type\Constant\ConstantArrayType; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Generic\TemplateType; use PHPStan\Type\Generic\TemplateTypeHelper; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\Generic\TemplateTypeVariance; use PHPStan\Type\Generic\TemplateTypeVarianceMap; use PHPStan\Type\Traits\NonArrayTypeTrait; use PHPStan\Type\Traits\NonGeneralizableTypeTrait; use PHPStan\Type\Traits\NonIterableTypeTrait; use PHPStan\Type\Traits\NonOffsetAccessibleTypeTrait; use PHPStan\Type\Traits\NonRemoveableTypeTrait; use PHPStan\Type\Traits\UndecidedComparisonTypeTrait; use function array_map; use function array_merge; use function count; /** @api */ class ClosureType implements \PHPStan\Type\TypeWithClassName, CallableParametersAcceptor { /** * @var bool */ private $variadic; /** * @var array<non-empty-string, TemplateTag> */ private $templateTags; /** * @var SimpleThrowPoint[] */ private $throwPoints; /** * @var InvalidateExprNode[] */ private $invalidateExpressions; /** * @var string[] */ private $usedVariables; /** * @var bool */ private $acceptsNamedArguments; use NonArrayTypeTrait; use NonIterableTypeTrait; use UndecidedComparisonTypeTrait; use NonOffsetAccessibleTypeTrait; use NonRemoveableTypeTrait; use NonGeneralizableTypeTrait; /** @var array<int, ParameterReflection> */ private $parameters; /** * @var Type */ private $returnType; /** * @var bool */ private $isCommonCallable; /** * @var ObjectType */ private $objectType; /** * @var TemplateTypeMap */ private $templateTypeMap; /** * @var TemplateTypeMap */ private $resolvedTemplateTypeMap; /** * @var TemplateTypeVarianceMap */ private $callSiteVarianceMap; /** @var SimpleImpurePoint[] */ private $impurePoints; /** * @api * @param array<int, ParameterReflection>|null $parameters * @param array<non-empty-string, TemplateTag> $templateTags * @param SimpleThrowPoint[] $throwPoints * @param ?SimpleImpurePoint[] $impurePoints * @param InvalidateExprNode[] $invalidateExpressions * @param string[] $usedVariables */ public function __construct(?array $parameters = null, ?\PHPStan\Type\Type $returnType = null, bool $variadic = \true, ?TemplateTypeMap $templateTypeMap = null, ?TemplateTypeMap $resolvedTemplateTypeMap = null, ?TemplateTypeVarianceMap $callSiteVarianceMap = null, array $templateTags = [], array $throwPoints = [], ?array $impurePoints = null, array $invalidateExpressions = [], array $usedVariables = [], bool $acceptsNamedArguments = \true) { $this->variadic = $variadic; $this->templateTags = $templateTags; $this->throwPoints = $throwPoints; $this->invalidateExpressions = $invalidateExpressions; $this->usedVariables = $usedVariables; $this->acceptsNamedArguments = $acceptsNamedArguments; $this->parameters = $parameters ?? []; $this->returnType = $returnType ?? new \PHPStan\Type\MixedType(); $this->isCommonCallable = $parameters === null && $returnType === null; $this->objectType = new \PHPStan\Type\ObjectType(Closure::class); $this->templateTypeMap = $templateTypeMap ?? TemplateTypeMap::createEmpty(); $this->resolvedTemplateTypeMap = $resolvedTemplateTypeMap ?? TemplateTypeMap::createEmpty(); $this->callSiteVarianceMap = $callSiteVarianceMap ?? TemplateTypeVarianceMap::createEmpty(); $this->impurePoints = $impurePoints ?? [new SimpleImpurePoint('functionCall', 'call to an unknown Closure', \false)]; } /** * @return array<non-empty-string, TemplateTag> */ public function getTemplateTags() : array { return $this->templateTags; } public static function createPure() : self { return new self(null, null, \true, null, null, null, [], [], []); } public function isPure() : TrinaryLogic { $impurePoints = $this->getImpurePoints(); if (count($impurePoints) === 0) { return TrinaryLogic::createYes(); } $certainCount = 0; foreach ($impurePoints as $impurePoint) { if (!$impurePoint->isCertain()) { continue; } $certainCount++; } return $certainCount > 0 ? TrinaryLogic::createNo() : TrinaryLogic::createMaybe(); } public function getClassName() : string { return $this->objectType->getClassName(); } public function getClassReflection() : ?ClassReflection { return $this->objectType->getClassReflection(); } public function getAncestorWithClassName(string $className) : ?\PHPStan\Type\TypeWithClassName { return $this->objectType->getAncestorWithClassName($className); } /** * @return string[] */ public function getReferencedClasses() : array { $classes = $this->objectType->getReferencedClasses(); foreach ($this->parameters as $parameter) { $classes = array_merge($classes, $parameter->getType()->getReferencedClasses()); } return array_merge($classes, $this->returnType->getReferencedClasses()); } public function getObjectClassNames() : array { return $this->objectType->getObjectClassNames(); } public function getObjectClassReflections() : array { return $this->objectType->getObjectClassReflections(); } public function accepts(\PHPStan\Type\Type $type, bool $strictTypes) : TrinaryLogic { return $this->acceptsWithReason($type, $strictTypes)->result; } public function acceptsWithReason(\PHPStan\Type\Type $type, bool $strictTypes) : \PHPStan\Type\AcceptsResult { if ($type instanceof \PHPStan\Type\CompoundType) { return $type->isAcceptedWithReasonBy($this, $strictTypes); } if (!$type instanceof \PHPStan\Type\ClosureType) { return $this->objectType->acceptsWithReason($type, $strictTypes); } return $this->isSuperTypeOfInternal($type, \true)->toAcceptsResult(); } public function isSuperTypeOf(\PHPStan\Type\Type $type) : TrinaryLogic { return $this->isSuperTypeOfWithReason($type)->result; } public function isSuperTypeOfWithReason(\PHPStan\Type\Type $type) : \PHPStan\Type\IsSuperTypeOfResult { if ($type instanceof \PHPStan\Type\CompoundType) { return $type->isSubTypeOfWithReason($this); } return $this->isSuperTypeOfInternal($type, \false); } private function isSuperTypeOfInternal(\PHPStan\Type\Type $type, bool $treatMixedAsAny) : \PHPStan\Type\IsSuperTypeOfResult { if ($type instanceof self) { $parameterTypes = array_map(static function ($parameter) { return $parameter->getType(); }, $this->getParameters()); $variant = ParametersAcceptorSelector::selectFromTypes($parameterTypes, [$type], \false); if (!$variant instanceof CallableParametersAcceptor) { return \PHPStan\Type\IsSuperTypeOfResult::createNo([]); } return \PHPStan\Type\CallableTypeHelper::isParametersAcceptorSuperTypeOf($this, $variant, $treatMixedAsAny); } if ($type->getObjectClassNames() === [Closure::class]) { return \PHPStan\Type\IsSuperTypeOfResult::createMaybe(); } return $this->objectType->isSuperTypeOfWithReason($type); } public function equals(\PHPStan\Type\Type $type) : bool { if (!$type instanceof self) { return \false; } return $this->describe(\PHPStan\Type\VerbosityLevel::precise()) === $type->describe(\PHPStan\Type\VerbosityLevel::precise()); } public function describe(\PHPStan\Type\VerbosityLevel $level) : string { return $level->handle(static function () : string { return 'Closure'; }, function () : string { if ($this->isCommonCallable) { return $this->isPure()->yes() ? 'pure-Closure' : 'Closure'; } $printer = new Printer(); $selfWithoutParameterNames = new self(array_map(static function (ParameterReflection $p) : ParameterReflection { return new DummyParameter('', $p->getType(), $p->isOptional() && !$p->isVariadic(), PassedByReference::createNo(), $p->isVariadic(), $p->getDefaultValue()); }, $this->parameters), $this->returnType, $this->variadic, $this->templateTypeMap, $this->resolvedTemplateTypeMap, $this->callSiteVarianceMap, $this->templateTags, $this->throwPoints, $this->impurePoints, $this->invalidateExpressions, $this->usedVariables); return $printer->print($selfWithoutParameterNames->toPhpDocNode()); }); } public function isOffsetAccessLegal() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isObject() : TrinaryLogic { return $this->objectType->isObject(); } public function isEnum() : TrinaryLogic { return $this->objectType->isEnum(); } public function getTemplateType(string $ancestorClassName, string $templateTypeName) : \PHPStan\Type\Type { return $this->objectType->getTemplateType($ancestorClassName, $templateTypeName); } public function canAccessProperties() : TrinaryLogic { return $this->objectType->canAccessProperties(); } public function hasProperty(string $propertyName) : TrinaryLogic { return $this->objectType->hasProperty($propertyName); } public function getProperty(string $propertyName, ClassMemberAccessAnswerer $scope) : PropertyReflection { return $this->objectType->getProperty($propertyName, $scope); } public function getUnresolvedPropertyPrototype(string $propertyName, ClassMemberAccessAnswerer $scope) : UnresolvedPropertyPrototypeReflection { return $this->objectType->getUnresolvedPropertyPrototype($propertyName, $scope); } public function canCallMethods() : TrinaryLogic { return $this->objectType->canCallMethods(); } public function hasMethod(string $methodName) : TrinaryLogic { return $this->objectType->hasMethod($methodName); } public function getMethod(string $methodName, ClassMemberAccessAnswerer $scope) : ExtendedMethodReflection { return $this->getUnresolvedMethodPrototype($methodName, $scope)->getTransformedMethod(); } public function getUnresolvedMethodPrototype(string $methodName, ClassMemberAccessAnswerer $scope) : UnresolvedMethodPrototypeReflection { if ($methodName === 'call') { return new ClosureCallUnresolvedMethodPrototypeReflection($this->objectType->getUnresolvedMethodPrototype($methodName, $scope), $this); } return $this->objectType->getUnresolvedMethodPrototype($methodName, $scope); } public function canAccessConstants() : TrinaryLogic { return $this->objectType->canAccessConstants(); } public function hasConstant(string $constantName) : TrinaryLogic { return $this->objectType->hasConstant($constantName); } public function getConstant(string $constantName) : ConstantReflection { return $this->objectType->getConstant($constantName); } public function getConstantStrings() : array { return []; } public function isIterable() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isIterableAtLeastOnce() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isCallable() : TrinaryLogic { return TrinaryLogic::createYes(); } public function getEnumCases() : array { return []; } public function isCommonCallable() : bool { return $this->isCommonCallable; } public function getCallableParametersAcceptors(ClassMemberAccessAnswerer $scope) : array { return [$this]; } public function getThrowPoints() : array { return $this->throwPoints; } public function getImpurePoints() : array { return $this->impurePoints; } public function getInvalidateExpressions() : array { return $this->invalidateExpressions; } public function getUsedVariables() : array { return $this->usedVariables; } public function acceptsNamedArguments() : bool { return $this->acceptsNamedArguments; } public function isCloneable() : TrinaryLogic { return TrinaryLogic::createYes(); } public function toBoolean() : \PHPStan\Type\BooleanType { return new ConstantBooleanType(\true); } public function toNumber() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toAbsoluteNumber() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toInteger() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toFloat() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toString() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toArray() : \PHPStan\Type\Type { return new ConstantArrayType([new ConstantIntegerType(0)], [$this], [1], [], TrinaryLogic::createYes()); } public function toArrayKey() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function getTemplateTypeMap() : TemplateTypeMap { return $this->templateTypeMap; } public function getResolvedTemplateTypeMap() : TemplateTypeMap { return $this->resolvedTemplateTypeMap; } public function getCallSiteVarianceMap() : TemplateTypeVarianceMap { return $this->callSiteVarianceMap; } /** * @return array<int, ParameterReflection> */ public function getParameters() : array { return $this->parameters; } public function isVariadic() : bool { return $this->variadic; } public function getReturnType() : \PHPStan\Type\Type { return $this->returnType; } public function inferTemplateTypes(\PHPStan\Type\Type $receivedType) : TemplateTypeMap { if ($receivedType instanceof \PHPStan\Type\UnionType || $receivedType instanceof \PHPStan\Type\IntersectionType) { return $receivedType->inferTemplateTypesOn($this); } if ($receivedType->isCallable()->no() || !$receivedType instanceof self) { return TemplateTypeMap::createEmpty(); } $parametersAcceptors = $receivedType->getCallableParametersAcceptors(new OutOfClassScope()); $typeMap = TemplateTypeMap::createEmpty(); foreach ($parametersAcceptors as $parametersAcceptor) { $typeMap = $typeMap->union($this->inferTemplateTypesOnParametersAcceptor($parametersAcceptor)); } return $typeMap; } private function inferTemplateTypesOnParametersAcceptor(ParametersAcceptor $parametersAcceptor) : TemplateTypeMap { $parameterTypes = array_map(static function ($parameter) { return $parameter->getType(); }, $this->getParameters()); $parametersAcceptor = ParametersAcceptorSelector::selectFromTypes($parameterTypes, [$parametersAcceptor], \false); $args = $parametersAcceptor->getParameters(); $returnType = $parametersAcceptor->getReturnType(); $typeMap = TemplateTypeMap::createEmpty(); foreach ($this->getParameters() as $i => $param) { $paramType = $param->getType(); if (isset($args[$i])) { $argType = $args[$i]->getType(); } elseif ($paramType instanceof TemplateType) { $argType = TemplateTypeHelper::resolveToBounds($paramType); } else { $argType = new \PHPStan\Type\NeverType(); } $typeMap = $typeMap->union($paramType->inferTemplateTypes($argType)->convertToLowerBoundTypes()); } return $typeMap->union($this->getReturnType()->inferTemplateTypes($returnType)); } public function getReferencedTemplateTypes(TemplateTypeVariance $positionVariance) : array { $references = $this->getReturnType()->getReferencedTemplateTypes($positionVariance->compose(TemplateTypeVariance::createCovariant())); $paramVariance = $positionVariance->compose(TemplateTypeVariance::createContravariant()); foreach ($this->getParameters() as $param) { foreach ($param->getType()->getReferencedTemplateTypes($paramVariance) as $reference) { $references[] = $reference; } } return $references; } public function traverse(callable $cb) : \PHPStan\Type\Type { if ($this->isCommonCallable) { return $this; } return new self(array_map(static function (ParameterReflection $param) use($cb) : NativeParameterReflection { $defaultValue = $param->getDefaultValue(); return new NativeParameterReflection($param->getName(), $param->isOptional(), $cb($param->getType()), $param->passedByReference(), $param->isVariadic(), $defaultValue !== null ? $cb($defaultValue) : null); }, $this->getParameters()), $cb($this->getReturnType()), $this->isVariadic(), $this->templateTypeMap, $this->resolvedTemplateTypeMap, $this->callSiteVarianceMap, $this->templateTags, $this->throwPoints, $this->impurePoints, $this->invalidateExpressions, $this->usedVariables, $this->acceptsNamedArguments); } public function traverseSimultaneously(\PHPStan\Type\Type $right, callable $cb) : \PHPStan\Type\Type { if ($this->isCommonCallable) { return $this; } if (!$right instanceof self) { return $this; } $rightParameters = $right->getParameters(); if (count($this->getParameters()) !== count($rightParameters)) { return $this; } $parameters = []; foreach ($this->getParameters() as $i => $leftParam) { $rightParam = $rightParameters[$i]; $leftDefaultValue = $leftParam->getDefaultValue(); $rightDefaultValue = $rightParam->getDefaultValue(); $defaultValue = $leftDefaultValue; if ($leftDefaultValue !== null && $rightDefaultValue !== null) { $defaultValue = $cb($leftDefaultValue, $rightDefaultValue); } $parameters[] = new NativeParameterReflection($leftParam->getName(), $leftParam->isOptional(), $cb($leftParam->getType(), $rightParam->getType()), $leftParam->passedByReference(), $leftParam->isVariadic(), $defaultValue); } return new self($parameters, $cb($this->getReturnType(), $right->getReturnType()), $this->isVariadic(), $this->templateTypeMap, $this->resolvedTemplateTypeMap, $this->callSiteVarianceMap, $this->templateTags, $this->throwPoints, $this->impurePoints, $this->invalidateExpressions, $this->usedVariables, $this->acceptsNamedArguments); } public function isNull() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isConstantValue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isConstantScalarValue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getConstantScalarTypes() : array { return []; } public function getConstantScalarValues() : array { return []; } public function isTrue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFalse() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isBoolean() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFloat() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isInteger() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isNumericString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isNonEmptyString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isNonFalsyString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isLiteralString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isLowercaseString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isUppercaseString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isClassStringType() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getClassStringObjectType() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function getObjectTypeOrClassStringObjectType() : \PHPStan\Type\Type { return $this; } public function isVoid() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isScalar() : TrinaryLogic { return TrinaryLogic::createNo(); } public function looseCompare(\PHPStan\Type\Type $type, PhpVersion $phpVersion) : \PHPStan\Type\BooleanType { return new \PHPStan\Type\BooleanType(); } public function exponentiate(\PHPStan\Type\Type $exponent) : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function getFiniteTypes() : array { return []; } public function toPhpDocNode() : TypeNode { if ($this->isCommonCallable) { return new IdentifierTypeNode($this->isPure()->yes() ? 'pure-Closure' : 'Closure'); } $parameters = []; foreach ($this->parameters as $parameter) { $parameters[] = new CallableTypeParameterNode($parameter->getType()->toPhpDocNode(), !$parameter->passedByReference()->no(), $parameter->isVariadic(), $parameter->getName() === '' ? '' : '$' . $parameter->getName(), $parameter->isOptional()); } $templateTags = []; foreach ($this->templateTags as $templateName => $templateTag) { $templateTags[] = new TemplateTagValueNode($templateName, $templateTag->getBound()->toPhpDocNode(), ''); } return new CallableTypeNode(new IdentifierTypeNode('Closure'), $parameters, $this->returnType->toPhpDocNode(), $templateTags); } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : \PHPStan\Type\Type { return new self($properties['parameters'], $properties['returnType'], $properties['variadic'], $properties['templateTypeMap'], $properties['resolvedTemplateTypeMap'], $properties['callSiteVarianceMap'], $properties['templateTags'], $properties['throwPoints'], $properties['impurePoints'], $properties['invalidateExpressions'], $properties['usedVariables'], $properties['acceptsNamedArguments']); } } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\TrinaryLogic; /** @api */ class NonAcceptingNeverType extends \PHPStan\Type\NeverType { /** @api */ public function __construct() { parent::__construct(\true); } public function isSuperTypeOf(\PHPStan\Type\Type $type) : TrinaryLogic { return $this->isSuperTypeOfWithReason($type)->result; } public function isSuperTypeOfWithReason(\PHPStan\Type\Type $type) : \PHPStan\Type\IsSuperTypeOfResult { if ($type instanceof self) { return \PHPStan\Type\IsSuperTypeOfResult::createYes(); } if ($type instanceof parent) { return \PHPStan\Type\IsSuperTypeOfResult::createMaybe(); } return \PHPStan\Type\IsSuperTypeOfResult::createNo(); } public function acceptsWithReason(\PHPStan\Type\Type $type, bool $strictTypes) : \PHPStan\Type\AcceptsResult { if ($type instanceof \PHPStan\Type\NeverType) { return \PHPStan\Type\AcceptsResult::createYes(); } return \PHPStan\Type\AcceptsResult::createNo(); } public function describe(\PHPStan\Type\VerbosityLevel $level) : string { return 'never'; } } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\Analyser\OutOfClassScope; use PHPStan\Php\PhpVersion; use PHPStan\PhpDoc\Tag\TemplateTag; use PHPStan\PhpDocParser\Ast\PhpDoc\TemplateTagValueNode; use PHPStan\PhpDocParser\Ast\Type\CallableTypeNode; use PHPStan\PhpDocParser\Ast\Type\CallableTypeParameterNode; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\PhpDocParser\Printer\Printer; use PHPStan\Reflection\Callables\CallableParametersAcceptor; use PHPStan\Reflection\Callables\SimpleImpurePoint; use PHPStan\Reflection\Callables\SimpleThrowPoint; use PHPStan\Reflection\ClassMemberAccessAnswerer; use PHPStan\Reflection\Native\NativeParameterReflection; use PHPStan\Reflection\ParameterReflection; use PHPStan\Reflection\ParametersAcceptor; use PHPStan\Reflection\ParametersAcceptorSelector; use PHPStan\Reflection\PassedByReference; use PHPStan\Reflection\Php\DummyParameter; use PHPStan\ShouldNotHappenException; use PHPStan\TrinaryLogic; use PHPStan\Type\Generic\TemplateType; use PHPStan\Type\Generic\TemplateTypeHelper; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\Generic\TemplateTypeVariance; use PHPStan\Type\Generic\TemplateTypeVarianceMap; use PHPStan\Type\Traits\MaybeArrayTypeTrait; use PHPStan\Type\Traits\MaybeIterableTypeTrait; use PHPStan\Type\Traits\MaybeObjectTypeTrait; use PHPStan\Type\Traits\MaybeOffsetAccessibleTypeTrait; use PHPStan\Type\Traits\NonGeneralizableTypeTrait; use PHPStan\Type\Traits\NonRemoveableTypeTrait; use PHPStan\Type\Traits\TruthyBooleanTypeTrait; use PHPStan\Type\Traits\UndecidedComparisonCompoundTypeTrait; use function array_map; use function array_merge; use function count; /** @api */ class CallableType implements \PHPStan\Type\CompoundType, CallableParametersAcceptor { /** * @var bool */ private $variadic; /** * @var array<non-empty-string, TemplateTag> */ private $templateTags; use MaybeArrayTypeTrait; use MaybeIterableTypeTrait; use MaybeObjectTypeTrait; use MaybeOffsetAccessibleTypeTrait; use TruthyBooleanTypeTrait; use UndecidedComparisonCompoundTypeTrait; use NonRemoveableTypeTrait; use NonGeneralizableTypeTrait; /** @var array<int, ParameterReflection> */ private $parameters; /** * @var Type */ private $returnType; /** * @var bool */ private $isCommonCallable; /** * @var TemplateTypeMap */ private $templateTypeMap; /** * @var TemplateTypeMap */ private $resolvedTemplateTypeMap; /** * @var TrinaryLogic */ private $isPure; /** * @api * @param array<int, ParameterReflection>|null $parameters * @param array<non-empty-string, TemplateTag> $templateTags */ public function __construct(?array $parameters = null, ?\PHPStan\Type\Type $returnType = null, bool $variadic = \true, ?TemplateTypeMap $templateTypeMap = null, ?TemplateTypeMap $resolvedTemplateTypeMap = null, array $templateTags = [], ?TrinaryLogic $isPure = null) { $this->variadic = $variadic; $this->templateTags = $templateTags; $this->parameters = $parameters ?? []; $this->returnType = $returnType ?? new \PHPStan\Type\MixedType(); $this->isCommonCallable = $parameters === null && $returnType === null; $this->templateTypeMap = $templateTypeMap ?? TemplateTypeMap::createEmpty(); $this->resolvedTemplateTypeMap = $resolvedTemplateTypeMap ?? TemplateTypeMap::createEmpty(); $this->isPure = $isPure ?? TrinaryLogic::createMaybe(); } /** * @return array<non-empty-string, TemplateTag> */ public function getTemplateTags() : array { return $this->templateTags; } public function isPure() : TrinaryLogic { return $this->isPure; } /** * @return string[] */ public function getReferencedClasses() : array { $classes = []; foreach ($this->parameters as $parameter) { $classes = array_merge($classes, $parameter->getType()->getReferencedClasses()); } return array_merge($classes, $this->returnType->getReferencedClasses()); } public function getObjectClassNames() : array { return []; } public function getObjectClassReflections() : array { return []; } public function getConstantStrings() : array { return []; } public function accepts(\PHPStan\Type\Type $type, bool $strictTypes) : TrinaryLogic { return $this->acceptsWithReason($type, $strictTypes)->result; } public function acceptsWithReason(\PHPStan\Type\Type $type, bool $strictTypes) : \PHPStan\Type\AcceptsResult { if ($type instanceof \PHPStan\Type\CompoundType && !$type instanceof self) { return $type->isAcceptedWithReasonBy($this, $strictTypes); } return $this->isSuperTypeOfInternal($type, \true)->toAcceptsResult(); } public function isSuperTypeOf(\PHPStan\Type\Type $type) : TrinaryLogic { return $this->isSuperTypeOfWithReason($type)->result; } public function isSuperTypeOfWithReason(\PHPStan\Type\Type $type) : \PHPStan\Type\IsSuperTypeOfResult { if ($type instanceof \PHPStan\Type\CompoundType && !$type instanceof self) { return $type->isSubTypeOfWithReason($this); } return $this->isSuperTypeOfInternal($type, \false); } private function isSuperTypeOfInternal(\PHPStan\Type\Type $type, bool $treatMixedAsAny) : \PHPStan\Type\IsSuperTypeOfResult { $isCallable = new \PHPStan\Type\IsSuperTypeOfResult($type->isCallable(), []); if ($isCallable->no()) { return $isCallable; } static $scope; if ($scope === null) { $scope = new OutOfClassScope(); } if ($this->isCommonCallable) { if ($this->isPure()->yes()) { $typePure = TrinaryLogic::createYes(); foreach ($type->getCallableParametersAcceptors($scope) as $variant) { $typePure = $typePure->and($variant->isPure()); } return $isCallable->and(new \PHPStan\Type\IsSuperTypeOfResult($typePure, [])); } return $isCallable; } $parameterTypes = array_map(static function ($parameter) { return $parameter->getType(); }, $this->getParameters()); $variantsResult = null; foreach ($type->getCallableParametersAcceptors($scope) as $variant) { $variant = ParametersAcceptorSelector::selectFromTypes($parameterTypes, [$variant], \false); if (!$variant instanceof CallableParametersAcceptor) { return \PHPStan\Type\IsSuperTypeOfResult::createNo([]); } $isSuperType = \PHPStan\Type\CallableTypeHelper::isParametersAcceptorSuperTypeOf($this, $variant, $treatMixedAsAny); if ($variantsResult === null) { $variantsResult = $isSuperType; } else { $variantsResult = $variantsResult->or($isSuperType); } } if ($variantsResult === null) { throw new ShouldNotHappenException(); } return $isCallable->and($variantsResult); } public function isSubTypeOf(\PHPStan\Type\Type $otherType) : TrinaryLogic { return $this->isSubTypeOfWithReason($otherType)->result; } public function isSubTypeOfWithReason(\PHPStan\Type\Type $otherType) : \PHPStan\Type\IsSuperTypeOfResult { if ($otherType instanceof \PHPStan\Type\IntersectionType || $otherType instanceof \PHPStan\Type\UnionType) { return $otherType->isSuperTypeOfWithReason($this); } return (new \PHPStan\Type\IsSuperTypeOfResult($otherType->isCallable(), []))->and($otherType instanceof self ? \PHPStan\Type\IsSuperTypeOfResult::createYes() : \PHPStan\Type\IsSuperTypeOfResult::createMaybe()); } public function isAcceptedBy(\PHPStan\Type\Type $acceptingType, bool $strictTypes) : TrinaryLogic { return $this->isAcceptedWithReasonBy($acceptingType, $strictTypes)->result; } public function isAcceptedWithReasonBy(\PHPStan\Type\Type $acceptingType, bool $strictTypes) : \PHPStan\Type\AcceptsResult { return $this->isSubTypeOfWithReason($acceptingType)->toAcceptsResult(); } public function equals(\PHPStan\Type\Type $type) : bool { if (!$type instanceof self) { return \false; } return $this->describe(\PHPStan\Type\VerbosityLevel::precise()) === $type->describe(\PHPStan\Type\VerbosityLevel::precise()); } public function describe(\PHPStan\Type\VerbosityLevel $level) : string { return $level->handle(static function () : string { return 'callable'; }, function () : string { $printer = new Printer(); $selfWithoutParameterNames = new self(array_map(static function (ParameterReflection $p) : ParameterReflection { return new DummyParameter('', $p->getType(), $p->isOptional() && !$p->isVariadic(), PassedByReference::createNo(), $p->isVariadic(), $p->getDefaultValue()); }, $this->parameters), $this->returnType, $this->variadic, $this->templateTypeMap, $this->resolvedTemplateTypeMap, $this->templateTags, $this->isPure); return $printer->print($selfWithoutParameterNames->toPhpDocNode()); }); } public function isCallable() : TrinaryLogic { return TrinaryLogic::createYes(); } public function getCallableParametersAcceptors(ClassMemberAccessAnswerer $scope) : array { return [$this]; } public function getThrowPoints() : array { return [SimpleThrowPoint::createImplicit()]; } public function getImpurePoints() : array { $pure = $this->isPure(); if ($pure->yes()) { return []; } return [new SimpleImpurePoint('functionCall', 'call to a callable', $pure->no())]; } public function getInvalidateExpressions() : array { return []; } public function getUsedVariables() : array { return []; } public function acceptsNamedArguments() : bool { return \true; } public function toNumber() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toAbsoluteNumber() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toString() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toInteger() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toFloat() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toArray() : \PHPStan\Type\Type { return new \PHPStan\Type\ArrayType(new \PHPStan\Type\MixedType(), new \PHPStan\Type\MixedType()); } public function toArrayKey() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function isOffsetAccessLegal() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getTemplateTypeMap() : TemplateTypeMap { return $this->templateTypeMap; } public function getResolvedTemplateTypeMap() : TemplateTypeMap { return $this->resolvedTemplateTypeMap; } public function getCallSiteVarianceMap() : TemplateTypeVarianceMap { return TemplateTypeVarianceMap::createEmpty(); } /** * @return array<int, ParameterReflection> */ public function getParameters() : array { return $this->parameters; } public function isVariadic() : bool { return $this->variadic; } public function getReturnType() : \PHPStan\Type\Type { return $this->returnType; } public function inferTemplateTypes(\PHPStan\Type\Type $receivedType) : TemplateTypeMap { if ($receivedType instanceof \PHPStan\Type\UnionType || $receivedType instanceof \PHPStan\Type\IntersectionType) { return $receivedType->inferTemplateTypesOn($this); } if (!$receivedType->isCallable()->yes()) { return TemplateTypeMap::createEmpty(); } $parametersAcceptors = $receivedType->getCallableParametersAcceptors(new OutOfClassScope()); $typeMap = TemplateTypeMap::createEmpty(); foreach ($parametersAcceptors as $parametersAcceptor) { $typeMap = $typeMap->union($this->inferTemplateTypesOnParametersAcceptor($parametersAcceptor)); } return $typeMap; } private function inferTemplateTypesOnParametersAcceptor(ParametersAcceptor $parametersAcceptor) : TemplateTypeMap { $parameterTypes = array_map(static function ($parameter) { return $parameter->getType(); }, $this->getParameters()); $parametersAcceptor = ParametersAcceptorSelector::selectFromTypes($parameterTypes, [$parametersAcceptor], \false); $args = $parametersAcceptor->getParameters(); $returnType = $parametersAcceptor->getReturnType(); $typeMap = TemplateTypeMap::createEmpty(); foreach ($this->getParameters() as $i => $param) { $paramType = $param->getType(); if (isset($args[$i])) { $argType = $args[$i]->getType(); } elseif ($paramType instanceof TemplateType) { $argType = TemplateTypeHelper::resolveToBounds($paramType); } else { $argType = new \PHPStan\Type\NeverType(); } $typeMap = $typeMap->union($paramType->inferTemplateTypes($argType)->convertToLowerBoundTypes()); } return $typeMap->union($this->getReturnType()->inferTemplateTypes($returnType)); } public function getReferencedTemplateTypes(TemplateTypeVariance $positionVariance) : array { $references = $this->getReturnType()->getReferencedTemplateTypes($positionVariance->compose(TemplateTypeVariance::createCovariant())); $paramVariance = $positionVariance->compose(TemplateTypeVariance::createContravariant()); foreach ($this->getParameters() as $param) { foreach ($param->getType()->getReferencedTemplateTypes($paramVariance) as $reference) { $references[] = $reference; } } return $references; } public function traverse(callable $cb) : \PHPStan\Type\Type { if ($this->isCommonCallable) { return $this; } $parameters = array_map(static function (ParameterReflection $param) use($cb) : NativeParameterReflection { $defaultValue = $param->getDefaultValue(); return new NativeParameterReflection($param->getName(), $param->isOptional(), $cb($param->getType()), $param->passedByReference(), $param->isVariadic(), $defaultValue !== null ? $cb($defaultValue) : null); }, $this->getParameters()); return new self($parameters, $cb($this->getReturnType()), $this->isVariadic(), $this->templateTypeMap, $this->resolvedTemplateTypeMap, $this->templateTags, $this->isPure); } public function traverseSimultaneously(\PHPStan\Type\Type $right, callable $cb) : \PHPStan\Type\Type { if ($this->isCommonCallable) { return $this; } if (!$right->isCallable()->yes()) { return $this; } $rightAcceptors = $right->getCallableParametersAcceptors(new OutOfClassScope()); if (count($rightAcceptors) !== 1) { return $this; } $rightParameters = $rightAcceptors[0]->getParameters(); if (count($this->getParameters()) !== count($rightParameters)) { return $this; } $parameters = []; foreach ($this->getParameters() as $i => $leftParam) { $rightParam = $rightParameters[$i]; $leftDefaultValue = $leftParam->getDefaultValue(); $rightDefaultValue = $rightParam->getDefaultValue(); $defaultValue = $leftDefaultValue; if ($leftDefaultValue !== null && $rightDefaultValue !== null) { $defaultValue = $cb($leftDefaultValue, $rightDefaultValue); } $parameters[] = new NativeParameterReflection($leftParam->getName(), $leftParam->isOptional(), $cb($leftParam->getType(), $rightParam->getType()), $leftParam->passedByReference(), $leftParam->isVariadic(), $defaultValue); } return new self($parameters, $cb($this->getReturnType(), $rightAcceptors[0]->getReturnType()), $this->isVariadic(), $this->templateTypeMap, $this->resolvedTemplateTypeMap, $this->templateTags, $this->isPure); } public function isOversizedArray() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isNull() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isConstantValue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isConstantScalarValue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getConstantScalarTypes() : array { return []; } public function getConstantScalarValues() : array { return []; } public function isTrue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFalse() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isBoolean() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFloat() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isInteger() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isNumericString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isNonEmptyString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isNonFalsyString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isLiteralString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isLowercaseString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isUppercaseString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isClassStringType() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getClassStringObjectType() : \PHPStan\Type\Type { return new \PHPStan\Type\ObjectWithoutClassType(); } public function getObjectTypeOrClassStringObjectType() : \PHPStan\Type\Type { return new \PHPStan\Type\ObjectWithoutClassType(); } public function isVoid() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isScalar() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function looseCompare(\PHPStan\Type\Type $type, PhpVersion $phpVersion) : \PHPStan\Type\BooleanType { return new \PHPStan\Type\BooleanType(); } public function getEnumCases() : array { return []; } public function isCommonCallable() : bool { return $this->isCommonCallable; } public function exponentiate(\PHPStan\Type\Type $exponent) : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function getFiniteTypes() : array { return []; } public function toPhpDocNode() : TypeNode { if ($this->isCommonCallable) { return new IdentifierTypeNode($this->isPure()->yes() ? 'pure-callable' : 'callable'); } $parameters = []; foreach ($this->parameters as $parameter) { $parameters[] = new CallableTypeParameterNode($parameter->getType()->toPhpDocNode(), !$parameter->passedByReference()->no(), $parameter->isVariadic(), $parameter->getName() === '' ? '' : '$' . $parameter->getName(), $parameter->isOptional()); } $templateTags = []; foreach ($this->templateTags as $templateName => $templateTag) { $templateTags[] = new TemplateTagValueNode($templateName, $templateTag->getBound()->toPhpDocNode(), ''); } return new CallableTypeNode(new IdentifierTypeNode($this->isPure->yes() ? 'pure-callable' : 'callable'), $parameters, $this->returnType->toPhpDocNode(), $templateTags); } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : \PHPStan\Type\Type { return new self((bool) $properties['isCommonCallable'] ? null : $properties['parameters'], (bool) $properties['isCommonCallable'] ? null : $properties['returnType'], $properties['variadic'], $properties['templateTypeMap'], $properties['resolvedTemplateTypeMap'], $properties['templateTags'], $properties['isPure']); } } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\Php\PhpVersion; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\TrinaryLogic; use PHPStan\Type\Constant\ConstantArrayType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Traits\NonArrayTypeTrait; use PHPStan\Type\Traits\NonCallableTypeTrait; use PHPStan\Type\Traits\NonGeneralizableTypeTrait; use PHPStan\Type\Traits\NonGenericTypeTrait; use PHPStan\Type\Traits\NonIterableTypeTrait; use PHPStan\Type\Traits\NonObjectTypeTrait; use PHPStan\Type\Traits\NonOffsetAccessibleTypeTrait; use PHPStan\Type\Traits\NonRemoveableTypeTrait; use PHPStan\Type\Traits\TruthyBooleanTypeTrait; use PHPStan\Type\Traits\UndecidedComparisonTypeTrait; /** @api */ class ResourceType implements \PHPStan\Type\Type { use \PHPStan\Type\JustNullableTypeTrait; use NonArrayTypeTrait; use NonCallableTypeTrait; use NonIterableTypeTrait; use NonObjectTypeTrait; use TruthyBooleanTypeTrait; use NonGenericTypeTrait; use UndecidedComparisonTypeTrait; use NonOffsetAccessibleTypeTrait; use NonRemoveableTypeTrait; use NonGeneralizableTypeTrait; /** @api */ public function __construct() { } public function describe(\PHPStan\Type\VerbosityLevel $level) : string { return 'resource'; } public function getConstantStrings() : array { return []; } public function toNumber() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toAbsoluteNumber() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toString() : \PHPStan\Type\Type { return new \PHPStan\Type\StringType(); } public function toInteger() : \PHPStan\Type\Type { return new \PHPStan\Type\IntegerType(); } public function toFloat() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toArray() : \PHPStan\Type\Type { return new ConstantArrayType([new ConstantIntegerType(0)], [$this], [1], [], TrinaryLogic::createYes()); } public function toArrayKey() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function isOffsetAccessLegal() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isScalar() : TrinaryLogic { return TrinaryLogic::createNo(); } public function looseCompare(\PHPStan\Type\Type $type, PhpVersion $phpVersion) : \PHPStan\Type\BooleanType { return new \PHPStan\Type\BooleanType(); } public function exponentiate(\PHPStan\Type\Type $exponent) : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function getFiniteTypes() : array { return []; } public function toPhpDocNode() : TypeNode { return new IdentifierTypeNode('resource'); } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : \PHPStan\Type\Type { return new self(); } } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\Type\Accessory\AccessoryArrayListType; use PHPStan\Type\Accessory\AccessoryLiteralStringType; use PHPStan\Type\Accessory\AccessoryLowercaseStringType; use PHPStan\Type\Accessory\AccessoryNonEmptyStringType; use PHPStan\Type\Accessory\AccessoryNonFalsyStringType; use PHPStan\Type\Accessory\AccessoryNumericStringType; use PHPStan\Type\Accessory\AccessoryUppercaseStringType; use PHPStan\Type\Accessory\NonEmptyArrayType; use PHPStan\Type\Generic\GenericObjectType; use PHPStan\Type\Generic\GenericStaticType; use PHPStan\Type\Generic\TemplateType; final class VerbosityLevel { /** * @var self::* */ private $value; private const TYPE_ONLY = 1; private const VALUE = 2; private const PRECISE = 3; private const CACHE = 4; /** @var self[] */ private static $registry; /** * @param self::* $value */ private function __construct(int $value) { $this->value = $value; } /** * @param self::* $value */ private static function create(int $value) : self { self::$registry[$value] = self::$registry[$value] ?? new self($value); return self::$registry[$value]; } /** @return self::* */ public function getLevelValue() : int { return $this->value; } /** @api */ public static function typeOnly() : self { return self::create(self::TYPE_ONLY); } /** @api */ public static function value() : self { return self::create(self::VALUE); } /** @api */ public static function precise() : self { return self::create(self::PRECISE); } /** @api */ public static function cache() : self { return self::create(self::CACHE); } public function isTypeOnly() : bool { return $this->value === self::TYPE_ONLY; } public function isValue() : bool { return $this->value === self::VALUE; } public function isPrecise() : bool { return $this->value === self::PRECISE; } /** @api */ public static function getRecommendedLevelByType(\PHPStan\Type\Type $acceptingType, ?\PHPStan\Type\Type $acceptedType = null) : self { $moreVerboseCallback = static function (\PHPStan\Type\Type $type, callable $traverse) use(&$moreVerbose, &$veryVerbose) : \PHPStan\Type\Type { if ($type->isCallable()->yes()) { $moreVerbose = \true; // Keep checking if we need to be very verbose. return $traverse($type); } if ($type->isConstantValue()->yes() && $type->isNull()->no()) { $moreVerbose = \true; // For ConstantArrayType we need to keep checking if we need to be very verbose. if (!$type->isArray()->no()) { return $traverse($type); } return $type; } if ($type instanceof AccessoryNonEmptyStringType || $type instanceof AccessoryNonFalsyStringType || $type instanceof AccessoryLiteralStringType || $type instanceof AccessoryNumericStringType || $type instanceof NonEmptyArrayType || $type instanceof AccessoryArrayListType) { $moreVerbose = \true; return $type; } if ($type instanceof AccessoryLowercaseStringType || $type instanceof AccessoryUppercaseStringType) { $moreVerbose = \true; $veryVerbose = \true; return $type; } if ($type instanceof \PHPStan\Type\IntegerRangeType) { $moreVerbose = \true; return $type; } return $traverse($type); }; /** @var bool $moreVerbose */ $moreVerbose = \false; /** @var bool $veryVerbose */ $veryVerbose = \false; \PHPStan\Type\TypeTraverser::map($acceptingType, $moreVerboseCallback); if ($veryVerbose) { return self::precise(); } if ($moreVerbose) { $verbosity = self::value(); } if ($acceptedType === null) { return $verbosity ?? self::typeOnly(); } $containsInvariantTemplateType = \false; \PHPStan\Type\TypeTraverser::map($acceptingType, static function (\PHPStan\Type\Type $type, callable $traverse) use(&$containsInvariantTemplateType) : \PHPStan\Type\Type { if ($type instanceof GenericObjectType || $type instanceof GenericStaticType) { $reflection = $type->getClassReflection(); if ($reflection !== null) { $templateTypeMap = $reflection->getTemplateTypeMap(); foreach ($templateTypeMap->getTypes() as $templateType) { if (!$templateType instanceof TemplateType) { continue; } if (!$templateType->getVariance()->invariant()) { continue; } $containsInvariantTemplateType = \true; return $type; } } } return $traverse($type); }); if (!$containsInvariantTemplateType) { return $verbosity ?? self::typeOnly(); } /** @var bool $moreVerbose */ $moreVerbose = \false; /** @var bool $veryVerbose */ $veryVerbose = \false; \PHPStan\Type\TypeTraverser::map($acceptedType, $moreVerboseCallback); if ($veryVerbose) { return self::precise(); } return $moreVerbose ? self::value() : $verbosity ?? self::typeOnly(); } /** * @param callable(): string $typeOnlyCallback * @param callable(): string $valueCallback * @param callable(): string|null $preciseCallback * @param callable(): string|null $cacheCallback */ public function handle(callable $typeOnlyCallback, callable $valueCallback, ?callable $preciseCallback = null, ?callable $cacheCallback = null) : string { if ($this->value === self::TYPE_ONLY) { return $typeOnlyCallback(); } if ($this->value === self::VALUE) { return $valueCallback(); } if ($this->value === self::PRECISE) { if ($preciseCallback !== null) { return $preciseCallback(); } return $valueCallback(); } if ($cacheCallback !== null) { return $cacheCallback(); } if ($preciseCallback !== null) { return $preciseCallback(); } return $valueCallback(); } } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\TrinaryLogic; /** @api */ class ClassStringType extends \PHPStan\Type\StringType { /** @api */ public function __construct() { parent::__construct(); } public function describe(\PHPStan\Type\VerbosityLevel $level) : string { return 'class-string'; } public function accepts(\PHPStan\Type\Type $type, bool $strictTypes) : TrinaryLogic { return $this->acceptsWithReason($type, $strictTypes)->result; } public function acceptsWithReason(\PHPStan\Type\Type $type, bool $strictTypes) : \PHPStan\Type\AcceptsResult { if ($type instanceof \PHPStan\Type\CompoundType) { return $type->isAcceptedWithReasonBy($this, $strictTypes); } return new \PHPStan\Type\AcceptsResult($type->isClassStringType(), []); } public function isSuperTypeOf(\PHPStan\Type\Type $type) : TrinaryLogic { return $this->isSuperTypeOfWithReason($type)->result; } public function isSuperTypeOfWithReason(\PHPStan\Type\Type $type) : \PHPStan\Type\IsSuperTypeOfResult { if ($type instanceof \PHPStan\Type\CompoundType) { return $type->isSubTypeOfWithReason($this); } return new \PHPStan\Type\IsSuperTypeOfResult($type->isClassStringType(), []); } public function isString() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isNumericString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isNonEmptyString() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isNonFalsyString() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isLiteralString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isLowercaseString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isUppercaseString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isClassStringType() : TrinaryLogic { return TrinaryLogic::createYes(); } public function getClassStringObjectType() : \PHPStan\Type\Type { return new \PHPStan\Type\ObjectWithoutClassType(); } public function getObjectTypeOrClassStringObjectType() : \PHPStan\Type\Type { return new \PHPStan\Type\ObjectWithoutClassType(); } public function toPhpDocNode() : TypeNode { return new IdentifierTypeNode('class-string'); } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : \PHPStan\Type\Type { return new self(); } } <?php declare (strict_types=1); namespace PHPStan\Type; interface TypeAliasResolverProvider { public function getTypeAliasResolver() : \PHPStan\Type\TypeAliasResolver; } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\Php\PhpVersion; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\Reflection\ClassMemberAccessAnswerer; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ConstantReflection; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\PropertyReflection; use PHPStan\Reflection\ReflectionProviderStaticAccessor; use PHPStan\Reflection\Type\CallbackUnresolvedMethodPrototypeReflection; use PHPStan\Reflection\Type\CallbackUnresolvedPropertyPrototypeReflection; use PHPStan\Reflection\Type\UnresolvedMethodPrototypeReflection; use PHPStan\Reflection\Type\UnresolvedPropertyPrototypeReflection; use PHPStan\TrinaryLogic; use PHPStan\Type\Generic\GenericObjectType; use PHPStan\Type\Generic\TemplateTypeHelper; use PHPStan\Type\Traits\NonGeneralizableTypeTrait; use PHPStan\Type\Traits\NonGenericTypeTrait; use PHPStan\Type\Traits\UndecidedComparisonTypeTrait; use function get_class; use function sprintf; /** @api */ class StaticType implements \PHPStan\Type\TypeWithClassName, \PHPStan\Type\SubtractableType { /** * @var ClassReflection */ private $classReflection; use NonGenericTypeTrait; use UndecidedComparisonTypeTrait; use NonGeneralizableTypeTrait; /** * @var ?Type */ private $subtractedType; /** * @var ?ObjectType */ private $staticObjectType = null; /** * @var string */ private $baseClass; /** * @api */ public function __construct(ClassReflection $classReflection, ?\PHPStan\Type\Type $subtractedType = null) { $this->classReflection = $classReflection; if ($subtractedType instanceof \PHPStan\Type\NeverType) { $subtractedType = null; } $this->subtractedType = $subtractedType; $this->baseClass = $classReflection->getName(); } public function getClassName() : string { return $this->baseClass; } public function getClassReflection() : ClassReflection { return $this->classReflection; } public function getAncestorWithClassName(string $className) : ?\PHPStan\Type\TypeWithClassName { $ancestor = $this->getStaticObjectType()->getAncestorWithClassName($className); if ($ancestor === null) { return null; } $classReflection = $ancestor->getClassReflection(); if ($classReflection !== null) { return $this->changeBaseClass($classReflection); } return null; } public function getStaticObjectType() : \PHPStan\Type\ObjectType { if ($this->staticObjectType === null) { if ($this->classReflection->isGeneric()) { $typeMap = $this->classReflection->getActiveTemplateTypeMap()->map(static function (string $name, \PHPStan\Type\Type $type) : \PHPStan\Type\Type { return TemplateTypeHelper::toArgument($type); }); $varianceMap = $this->classReflection->getCallSiteVarianceMap(); return $this->staticObjectType = new GenericObjectType($this->classReflection->getName(), $this->classReflection->typeMapToList($typeMap), $this->subtractedType, null, $this->classReflection->varianceMapToList($varianceMap)); } return $this->staticObjectType = new \PHPStan\Type\ObjectType($this->classReflection->getName(), $this->subtractedType, $this->classReflection); } return $this->staticObjectType; } /** * @return string[] */ public function getReferencedClasses() : array { return $this->getStaticObjectType()->getReferencedClasses(); } public function getObjectClassNames() : array { return $this->getStaticObjectType()->getObjectClassNames(); } public function getObjectClassReflections() : array { return $this->getStaticObjectType()->getObjectClassReflections(); } public function getArrays() : array { return $this->getStaticObjectType()->getArrays(); } public function getConstantArrays() : array { return $this->getStaticObjectType()->getConstantArrays(); } public function getConstantStrings() : array { return $this->getStaticObjectType()->getConstantStrings(); } public function accepts(\PHPStan\Type\Type $type, bool $strictTypes) : TrinaryLogic { return $this->acceptsWithReason($type, $strictTypes)->result; } public function acceptsWithReason(\PHPStan\Type\Type $type, bool $strictTypes) : \PHPStan\Type\AcceptsResult { if ($type instanceof \PHPStan\Type\CompoundType) { return $type->isAcceptedWithReasonBy($this, $strictTypes); } if (!$type instanceof static) { return \PHPStan\Type\AcceptsResult::createNo(); } return $this->getStaticObjectType()->acceptsWithReason($type->getStaticObjectType(), $strictTypes); } public function isSuperTypeOf(\PHPStan\Type\Type $type) : TrinaryLogic { return $this->isSuperTypeOfWithReason($type)->result; } public function isSuperTypeOfWithReason(\PHPStan\Type\Type $type) : \PHPStan\Type\IsSuperTypeOfResult { if ($type instanceof self) { return $this->getStaticObjectType()->isSuperTypeOfWithReason($type); } if ($type instanceof \PHPStan\Type\ObjectWithoutClassType) { return \PHPStan\Type\IsSuperTypeOfResult::createMaybe(); } if ($type instanceof \PHPStan\Type\ObjectType) { $result = $this->getStaticObjectType()->isSuperTypeOfWithReason($type); if ($result->yes()) { $classReflection = $type->getClassReflection(); if ($classReflection !== null && $classReflection->isFinal()) { return $result; } } return $result->and(\PHPStan\Type\IsSuperTypeOfResult::createMaybe()); } if ($type instanceof \PHPStan\Type\CompoundType) { return $type->isSubTypeOfWithReason($this); } return \PHPStan\Type\IsSuperTypeOfResult::createNo(); } public function equals(\PHPStan\Type\Type $type) : bool { if (get_class($type) !== static::class) { return \false; } return $this->getStaticObjectType()->equals($type->getStaticObjectType()); } public function describe(\PHPStan\Type\VerbosityLevel $level) : string { return sprintf('static(%s)', $this->getStaticObjectType()->describe($level)); } public function getTemplateType(string $ancestorClassName, string $templateTypeName) : \PHPStan\Type\Type { return $this->getStaticObjectType()->getTemplateType($ancestorClassName, $templateTypeName); } public function isObject() : TrinaryLogic { return $this->getStaticObjectType()->isObject(); } public function isEnum() : TrinaryLogic { return $this->getStaticObjectType()->isEnum(); } public function canAccessProperties() : TrinaryLogic { return $this->getStaticObjectType()->canAccessProperties(); } public function hasProperty(string $propertyName) : TrinaryLogic { return $this->getStaticObjectType()->hasProperty($propertyName); } public function getProperty(string $propertyName, ClassMemberAccessAnswerer $scope) : PropertyReflection { return $this->getUnresolvedPropertyPrototype($propertyName, $scope)->getTransformedProperty(); } public function getUnresolvedPropertyPrototype(string $propertyName, ClassMemberAccessAnswerer $scope) : UnresolvedPropertyPrototypeReflection { $staticObject = $this->getStaticObjectType(); $nakedProperty = $staticObject->getUnresolvedPropertyPrototype($propertyName, $scope)->getNakedProperty(); $ancestor = $this->getAncestorWithClassName($nakedProperty->getDeclaringClass()->getName()); $classReflection = null; if ($ancestor !== null) { $classReflection = $ancestor->getClassReflection(); } if ($classReflection === null) { $classReflection = $nakedProperty->getDeclaringClass(); } return new CallbackUnresolvedPropertyPrototypeReflection($nakedProperty, $classReflection, \false, function (\PHPStan\Type\Type $type) use($scope) : \PHPStan\Type\Type { return $this->transformStaticType($type, $scope); }); } public function canCallMethods() : TrinaryLogic { return $this->getStaticObjectType()->canCallMethods(); } public function hasMethod(string $methodName) : TrinaryLogic { return $this->getStaticObjectType()->hasMethod($methodName); } public function getMethod(string $methodName, ClassMemberAccessAnswerer $scope) : ExtendedMethodReflection { return $this->getUnresolvedMethodPrototype($methodName, $scope)->getTransformedMethod(); } public function getUnresolvedMethodPrototype(string $methodName, ClassMemberAccessAnswerer $scope) : UnresolvedMethodPrototypeReflection { $staticObject = $this->getStaticObjectType(); $nakedMethod = $staticObject->getUnresolvedMethodPrototype($methodName, $scope)->getNakedMethod(); $ancestor = $this->getAncestorWithClassName($nakedMethod->getDeclaringClass()->getName()); $classReflection = null; if ($ancestor !== null) { $classReflection = $ancestor->getClassReflection(); } if ($classReflection === null) { $classReflection = $nakedMethod->getDeclaringClass(); } return new CallbackUnresolvedMethodPrototypeReflection($nakedMethod, $classReflection, \false, function (\PHPStan\Type\Type $type) use($scope) : \PHPStan\Type\Type { return $this->transformStaticType($type, $scope); }); } private function transformStaticType(\PHPStan\Type\Type $type, ClassMemberAccessAnswerer $scope) : \PHPStan\Type\Type { return \PHPStan\Type\TypeTraverser::map($type, function (\PHPStan\Type\Type $type, callable $traverse) use($scope) : \PHPStan\Type\Type { if ($type instanceof \PHPStan\Type\StaticType) { $classReflection = $this->classReflection; $isFinal = \false; if ($scope->isInClass()) { $classReflection = $scope->getClassReflection(); $isFinal = $classReflection->isFinal(); } $type = $type->changeBaseClass($classReflection); if (!$isFinal || $type instanceof \PHPStan\Type\ThisType) { return $traverse($type); } return $traverse($type->getStaticObjectType()); } return $traverse($type); }); } public function canAccessConstants() : TrinaryLogic { return $this->getStaticObjectType()->canAccessConstants(); } public function hasConstant(string $constantName) : TrinaryLogic { return $this->getStaticObjectType()->hasConstant($constantName); } public function getConstant(string $constantName) : ConstantReflection { return $this->getStaticObjectType()->getConstant($constantName); } public function changeBaseClass(ClassReflection $classReflection) : self { return new self($classReflection, $this->subtractedType); } public function isIterable() : TrinaryLogic { return $this->getStaticObjectType()->isIterable(); } public function isIterableAtLeastOnce() : TrinaryLogic { return $this->getStaticObjectType()->isIterableAtLeastOnce(); } public function getArraySize() : \PHPStan\Type\Type { return $this->getStaticObjectType()->getArraySize(); } public function getIterableKeyType() : \PHPStan\Type\Type { return $this->getStaticObjectType()->getIterableKeyType(); } public function getFirstIterableKeyType() : \PHPStan\Type\Type { return $this->getStaticObjectType()->getFirstIterableKeyType(); } public function getLastIterableKeyType() : \PHPStan\Type\Type { return $this->getStaticObjectType()->getLastIterableKeyType(); } public function getIterableValueType() : \PHPStan\Type\Type { return $this->getStaticObjectType()->getIterableValueType(); } public function getFirstIterableValueType() : \PHPStan\Type\Type { return $this->getStaticObjectType()->getFirstIterableValueType(); } public function getLastIterableValueType() : \PHPStan\Type\Type { return $this->getStaticObjectType()->getLastIterableValueType(); } public function isOffsetAccessible() : TrinaryLogic { return $this->getStaticObjectType()->isOffsetAccessible(); } public function isOffsetAccessLegal() : TrinaryLogic { return $this->getStaticObjectType()->isOffsetAccessLegal(); } public function hasOffsetValueType(\PHPStan\Type\Type $offsetType) : TrinaryLogic { return $this->getStaticObjectType()->hasOffsetValueType($offsetType); } public function getOffsetValueType(\PHPStan\Type\Type $offsetType) : \PHPStan\Type\Type { return $this->getStaticObjectType()->getOffsetValueType($offsetType); } public function setOffsetValueType(?\PHPStan\Type\Type $offsetType, \PHPStan\Type\Type $valueType, bool $unionValues = \true) : \PHPStan\Type\Type { return $this->getStaticObjectType()->setOffsetValueType($offsetType, $valueType, $unionValues); } public function setExistingOffsetValueType(\PHPStan\Type\Type $offsetType, \PHPStan\Type\Type $valueType) : \PHPStan\Type\Type { return $this->getStaticObjectType()->setExistingOffsetValueType($offsetType, $valueType); } public function unsetOffset(\PHPStan\Type\Type $offsetType) : \PHPStan\Type\Type { return $this->getStaticObjectType()->unsetOffset($offsetType); } public function getKeysArray() : \PHPStan\Type\Type { return $this->getStaticObjectType()->getKeysArray(); } public function getValuesArray() : \PHPStan\Type\Type { return $this->getStaticObjectType()->getValuesArray(); } public function chunkArray(\PHPStan\Type\Type $lengthType, TrinaryLogic $preserveKeys) : \PHPStan\Type\Type { return $this->getStaticObjectType()->chunkArray($lengthType, $preserveKeys); } public function fillKeysArray(\PHPStan\Type\Type $valueType) : \PHPStan\Type\Type { return $this->getStaticObjectType()->fillKeysArray($valueType); } public function flipArray() : \PHPStan\Type\Type { return $this->getStaticObjectType()->flipArray(); } public function intersectKeyArray(\PHPStan\Type\Type $otherArraysType) : \PHPStan\Type\Type { return $this->getStaticObjectType()->intersectKeyArray($otherArraysType); } public function popArray() : \PHPStan\Type\Type { return $this->getStaticObjectType()->popArray(); } public function reverseArray(TrinaryLogic $preserveKeys) : \PHPStan\Type\Type { return $this->getStaticObjectType()->reverseArray($preserveKeys); } public function searchArray(\PHPStan\Type\Type $needleType) : \PHPStan\Type\Type { return $this->getStaticObjectType()->searchArray($needleType); } public function shiftArray() : \PHPStan\Type\Type { return $this->getStaticObjectType()->shiftArray(); } public function shuffleArray() : \PHPStan\Type\Type { return $this->getStaticObjectType()->shuffleArray(); } public function sliceArray(\PHPStan\Type\Type $offsetType, \PHPStan\Type\Type $lengthType, TrinaryLogic $preserveKeys) : \PHPStan\Type\Type { return $this->getStaticObjectType()->sliceArray($offsetType, $lengthType, $preserveKeys); } public function isCallable() : TrinaryLogic { return $this->getStaticObjectType()->isCallable(); } public function getEnumCases() : array { return $this->getStaticObjectType()->getEnumCases(); } public function isArray() : TrinaryLogic { return $this->getStaticObjectType()->isArray(); } public function isConstantArray() : TrinaryLogic { return $this->getStaticObjectType()->isConstantArray(); } public function isOversizedArray() : TrinaryLogic { return $this->getStaticObjectType()->isOversizedArray(); } public function isList() : TrinaryLogic { return $this->getStaticObjectType()->isList(); } public function isNull() : TrinaryLogic { return $this->getStaticObjectType()->isNull(); } public function isConstantValue() : TrinaryLogic { return $this->getStaticObjectType()->isConstantValue(); } public function isConstantScalarValue() : TrinaryLogic { return $this->getStaticObjectType()->isConstantScalarValue(); } public function getConstantScalarTypes() : array { return $this->getStaticObjectType()->getConstantScalarTypes(); } public function getConstantScalarValues() : array { return $this->getStaticObjectType()->getConstantScalarValues(); } public function isTrue() : TrinaryLogic { return $this->getStaticObjectType()->isTrue(); } public function isFalse() : TrinaryLogic { return $this->getStaticObjectType()->isFalse(); } public function isBoolean() : TrinaryLogic { return $this->getStaticObjectType()->isBoolean(); } public function isFloat() : TrinaryLogic { return $this->getStaticObjectType()->isFloat(); } public function isInteger() : TrinaryLogic { return $this->getStaticObjectType()->isInteger(); } public function isString() : TrinaryLogic { return $this->getStaticObjectType()->isString(); } public function isNumericString() : TrinaryLogic { return $this->getStaticObjectType()->isNumericString(); } public function isNonEmptyString() : TrinaryLogic { return $this->getStaticObjectType()->isNonEmptyString(); } public function isNonFalsyString() : TrinaryLogic { return $this->getStaticObjectType()->isNonFalsyString(); } public function isLiteralString() : TrinaryLogic { return $this->getStaticObjectType()->isLiteralString(); } public function isLowercaseString() : TrinaryLogic { return $this->getStaticObjectType()->isLowercaseString(); } public function isUppercaseString() : TrinaryLogic { return $this->getStaticObjectType()->isUppercaseString(); } public function isClassStringType() : TrinaryLogic { return $this->getStaticObjectType()->isClassStringType(); } public function getClassStringObjectType() : \PHPStan\Type\Type { return $this->getStaticObjectType()->getClassStringObjectType(); } public function getObjectTypeOrClassStringObjectType() : \PHPStan\Type\Type { return $this; } public function isVoid() : TrinaryLogic { return $this->getStaticObjectType()->isVoid(); } public function isScalar() : TrinaryLogic { return $this->getStaticObjectType()->isScalar(); } public function looseCompare(\PHPStan\Type\Type $type, PhpVersion $phpVersion) : \PHPStan\Type\BooleanType { return new \PHPStan\Type\BooleanType(); } public function getCallableParametersAcceptors(ClassMemberAccessAnswerer $scope) : array { return $this->getStaticObjectType()->getCallableParametersAcceptors($scope); } public function isCloneable() : TrinaryLogic { return TrinaryLogic::createYes(); } public function toNumber() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toAbsoluteNumber() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toString() : \PHPStan\Type\Type { return $this->getStaticObjectType()->toString(); } public function toInteger() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toFloat() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toArray() : \PHPStan\Type\Type { return $this->getStaticObjectType()->toArray(); } public function toArrayKey() : \PHPStan\Type\Type { return $this->getStaticObjectType()->toArrayKey(); } public function toBoolean() : \PHPStan\Type\BooleanType { return $this->getStaticObjectType()->toBoolean(); } public function traverse(callable $cb) : \PHPStan\Type\Type { $subtractedType = $this->subtractedType !== null ? $cb($this->subtractedType) : null; if ($subtractedType !== $this->subtractedType) { return new self($this->classReflection, $subtractedType); } return $this; } public function traverseSimultaneously(\PHPStan\Type\Type $right, callable $cb) : \PHPStan\Type\Type { if ($this->subtractedType === null) { return $this; } return new self($this->classReflection); } public function subtract(\PHPStan\Type\Type $type) : \PHPStan\Type\Type { if ($this->subtractedType !== null) { $type = \PHPStan\Type\TypeCombinator::union($this->subtractedType, $type); } return $this->changeSubtractedType($type); } public function getTypeWithoutSubtractedType() : \PHPStan\Type\Type { return $this->changeSubtractedType(null); } public function changeSubtractedType(?\PHPStan\Type\Type $subtractedType) : \PHPStan\Type\Type { if ($subtractedType !== null) { $classReflection = $this->getClassReflection(); if ($classReflection->getAllowedSubTypes() !== null) { $objectType = $this->getStaticObjectType()->changeSubtractedType($subtractedType); if ($objectType instanceof \PHPStan\Type\NeverType) { return $objectType; } if ($objectType instanceof \PHPStan\Type\ObjectType && $objectType->getSubtractedType() !== null) { return new self($classReflection, $objectType->getSubtractedType()); } return \PHPStan\Type\TypeCombinator::intersect($this, $objectType); } } return new self($this->classReflection, $subtractedType); } public function getSubtractedType() : ?\PHPStan\Type\Type { return $this->subtractedType; } public function tryRemove(\PHPStan\Type\Type $typeToRemove) : ?\PHPStan\Type\Type { if ($this->getStaticObjectType()->isSuperTypeOf($typeToRemove)->yes()) { return $this->subtract($typeToRemove); } return null; } public function exponentiate(\PHPStan\Type\Type $exponent) : \PHPStan\Type\Type { return $this->getStaticObjectType()->exponentiate($exponent); } public function getFiniteTypes() : array { return $this->getStaticObjectType()->getFiniteTypes(); } public function toPhpDocNode() : TypeNode { return new IdentifierTypeNode('static'); } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : \PHPStan\Type\Type { $reflectionProvider = ReflectionProviderStaticAccessor::getInstance(); if ($reflectionProvider->hasClass($properties['baseClass'])) { return new self($reflectionProvider->getClass($properties['baseClass']), $properties['subtractedType'] ?? null); } return new \PHPStan\Type\ErrorType(); } } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\Analyser\NameScope; use PHPStan\PhpDoc\TypeNodeResolver; use PHPStan\PhpDoc\TypeStringResolver; use PHPStan\Reflection\ReflectionProvider; use PHPStan\ShouldNotHappenException; use function array_key_exists; use function sprintf; final class UsefulTypeAliasResolver implements \PHPStan\Type\TypeAliasResolver { /** * @var array<string, string> */ private $globalTypeAliases; /** * @var TypeStringResolver */ private $typeStringResolver; /** * @var TypeNodeResolver */ private $typeNodeResolver; /** * @var ReflectionProvider */ private $reflectionProvider; /** @var array<string, Type> */ private $resolvedGlobalTypeAliases = []; /** @var array<string, Type> */ private $resolvedLocalTypeAliases = []; /** @var array<string, true> */ private $resolvingClassTypeAliases = []; /** @var array<string, true> */ private $inProcess = []; /** * @param array<string, string> $globalTypeAliases */ public function __construct(array $globalTypeAliases, TypeStringResolver $typeStringResolver, TypeNodeResolver $typeNodeResolver, ReflectionProvider $reflectionProvider) { $this->globalTypeAliases = $globalTypeAliases; $this->typeStringResolver = $typeStringResolver; $this->typeNodeResolver = $typeNodeResolver; $this->reflectionProvider = $reflectionProvider; } public function hasTypeAlias(string $aliasName, ?string $classNameScope) : bool { $hasGlobalTypeAlias = array_key_exists($aliasName, $this->globalTypeAliases); if ($hasGlobalTypeAlias) { return \true; } if ($classNameScope === null || !$this->reflectionProvider->hasClass($classNameScope)) { return \false; } $classReflection = $this->reflectionProvider->getClass($classNameScope); $localTypeAliases = $classReflection->getTypeAliases(); return array_key_exists($aliasName, $localTypeAliases); } public function resolveTypeAlias(string $aliasName, NameScope $nameScope) : ?\PHPStan\Type\Type { return $this->resolveLocalTypeAlias($aliasName, $nameScope) ?? $this->resolveGlobalTypeAlias($aliasName, $nameScope); } private function resolveLocalTypeAlias(string $aliasName, NameScope $nameScope) : ?\PHPStan\Type\Type { if (array_key_exists($aliasName, $this->globalTypeAliases)) { return null; } if (!$nameScope->hasTypeAlias($aliasName)) { return null; } $className = $nameScope->getClassNameForTypeAlias(); if ($className === null) { return null; } $aliasNameInClassScope = $className . '::' . $aliasName; if (array_key_exists($aliasNameInClassScope, $this->resolvedLocalTypeAliases)) { return $this->resolvedLocalTypeAliases[$aliasNameInClassScope]; } // prevent infinite recursion if (array_key_exists($className, $this->resolvingClassTypeAliases)) { return null; } $this->resolvingClassTypeAliases[$className] = \true; if (!$this->reflectionProvider->hasClass($className)) { unset($this->resolvingClassTypeAliases[$className]); return null; } $classReflection = $this->reflectionProvider->getClass($className); $localTypeAliases = $classReflection->getTypeAliases(); unset($this->resolvingClassTypeAliases[$className]); if (!array_key_exists($aliasName, $localTypeAliases)) { return null; } if (array_key_exists($aliasNameInClassScope, $this->inProcess)) { // resolve circular reference as ErrorType to make it easier to detect throw new \PHPStan\Type\CircularTypeAliasDefinitionException(); } $this->inProcess[$aliasNameInClassScope] = \true; try { $unresolvedAlias = $localTypeAliases[$aliasName]; $resolvedAliasType = $unresolvedAlias->resolve($this->typeNodeResolver); } catch (\PHPStan\Type\CircularTypeAliasDefinitionException $e) { $resolvedAliasType = new \PHPStan\Type\CircularTypeAliasErrorType(); } $this->resolvedLocalTypeAliases[$aliasNameInClassScope] = $resolvedAliasType; unset($this->inProcess[$aliasNameInClassScope]); return $resolvedAliasType; } private function resolveGlobalTypeAlias(string $aliasName, NameScope $nameScope) : ?\PHPStan\Type\Type { if (!array_key_exists($aliasName, $this->globalTypeAliases)) { return null; } if (array_key_exists($aliasName, $this->resolvedGlobalTypeAliases)) { return $this->resolvedGlobalTypeAliases[$aliasName]; } if ($this->reflectionProvider->hasClass($nameScope->resolveStringName($aliasName))) { throw new ShouldNotHappenException(sprintf('Type alias %s already exists as a class.', $aliasName)); } if (array_key_exists($aliasName, $this->inProcess)) { throw new ShouldNotHappenException(sprintf('Circular definition for type alias %s.', $aliasName)); } $this->inProcess[$aliasName] = \true; $aliasTypeString = $this->globalTypeAliases[$aliasName]; $aliasType = $this->typeStringResolver->resolve($aliasTypeString); $this->resolvedGlobalTypeAliases[$aliasName] = $aliasType; unset($this->inProcess[$aliasName]); return $aliasType; } } <?php declare (strict_types=1); namespace PHPStan\Type; use Exception; final class CircularTypeAliasDefinitionException extends Exception { } <?php declare (strict_types=1); namespace PHPStan\Type; final class RecursionGuard { /** @var true[] */ private static $context = []; /** * @template T * @param callable(): T $callback * @return T|ErrorType */ public static function run(\PHPStan\Type\Type $type, callable $callback) { $key = $type->describe(\PHPStan\Type\VerbosityLevel::value()); if (isset(self::$context[$key])) { return new \PHPStan\Type\ErrorType(); } try { self::$context[$key] = \true; return $callback(); } finally { unset(self::$context[$key]); } } } <?php declare (strict_types=1); namespace PHPStan\Type; use PhpParser\Node\Expr\StaticCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\MethodReflection; /** * This is the interface dynamic return type extensions implement for static methods. * * To register it in the configuration file use the `phpstan.broker.dynamicStaticMethodReturnTypeExtension` service tag: * * ``` * services: * - * class: App\PHPStan\MyExtension * tags: * - phpstan.broker.dynamicStaticMethodReturnTypeExtension * ``` * * Learn more: https://phpstan.org/developing-extensions/dynamic-return-type-extensions * * @api */ interface DynamicStaticMethodReturnTypeExtension { public function getClass() : string; public function isStaticMethodSupported(MethodReflection $methodReflection) : bool; public function getTypeFromStaticMethodCall(MethodReflection $methodReflection, StaticCall $methodCall, Scope $scope) : ?\PHPStan\Type\Type; } <?php declare (strict_types=1); namespace PHPStan\Type\Enum; use PHPStan\PhpDocParser\Ast\ConstExpr\ConstFetchNode; use PHPStan\PhpDocParser\Ast\Type\ConstTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\Reflection\ClassMemberAccessAnswerer; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\Php\EnumPropertyReflection; use PHPStan\Reflection\Php\EnumUnresolvedPropertyPrototypeReflection; use PHPStan\Reflection\Type\UnresolvedPropertyPrototypeReflection; use PHPStan\ShouldNotHappenException; use PHPStan\TrinaryLogic; use PHPStan\Type\AcceptsResult; use PHPStan\Type\CompoundType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\GeneralizePrecision; use PHPStan\Type\IsSuperTypeOfResult; use PHPStan\Type\ObjectType; use PHPStan\Type\SubtractableType; use PHPStan\Type\Type; use PHPStan\Type\VerbosityLevel; use function sprintf; /** @api */ class EnumCaseObjectType extends ObjectType { /** * @var string */ private $enumCaseName; /** @api */ public function __construct(string $className, string $enumCaseName, ?ClassReflection $classReflection = null) { $this->enumCaseName = $enumCaseName; parent::__construct($className, null, $classReflection); } public function getEnumCaseName() : string { return $this->enumCaseName; } public function describe(VerbosityLevel $level) : string { $parent = parent::describe($level); return sprintf('%s::%s', $parent, $this->enumCaseName); } public function equals(Type $type) : bool { if (!$type instanceof self) { return \false; } return $this->enumCaseName === $type->enumCaseName && $this->getClassName() === $type->getClassName(); } public function accepts(Type $type, bool $strictTypes) : TrinaryLogic { return $this->acceptsWithReason($type, $strictTypes)->result; } public function acceptsWithReason(Type $type, bool $strictTypes) : AcceptsResult { return $this->isSuperTypeOfWithReason($type)->toAcceptsResult(); } public function isSuperTypeOf(Type $type) : TrinaryLogic { return $this->isSuperTypeOfWithReason($type)->result; } public function isSuperTypeOfWithReason(Type $type) : IsSuperTypeOfResult { if ($type instanceof self) { return IsSuperTypeOfResult::createFromBoolean($this->enumCaseName === $type->enumCaseName && $this->getClassName() === $type->getClassName()); } if ($type instanceof CompoundType) { return $type->isSubTypeOfWithReason($this); } if ($type instanceof SubtractableType && $type->getSubtractedType() !== null) { $isSuperType = $type->getSubtractedType()->isSuperTypeOfWithReason($this); if ($isSuperType->yes()) { return IsSuperTypeOfResult::createNo(); } } $parent = new parent($this->getClassName(), $this->getSubtractedType(), $this->getClassReflection()); return $parent->isSuperTypeOfWithReason($type)->and(IsSuperTypeOfResult::createMaybe()); } public function subtract(Type $type) : Type { return $this; } public function getTypeWithoutSubtractedType() : Type { return $this; } public function changeSubtractedType(?Type $subtractedType) : Type { return $this; } public function getSubtractedType() : ?Type { return null; } public function tryRemove(Type $typeToRemove) : ?Type { if ($this->isSuperTypeOf($typeToRemove)->yes()) { return $this->subtract($typeToRemove); } return null; } public function getUnresolvedPropertyPrototype(string $propertyName, ClassMemberAccessAnswerer $scope) : UnresolvedPropertyPrototypeReflection { $classReflection = $this->getClassReflection(); if ($classReflection === null) { return parent::getUnresolvedPropertyPrototype($propertyName, $scope); } if ($propertyName === 'name') { return new EnumUnresolvedPropertyPrototypeReflection(new EnumPropertyReflection($classReflection, new ConstantStringType($this->enumCaseName))); } if ($classReflection->isBackedEnum() && $propertyName === 'value') { if ($classReflection->hasEnumCase($this->enumCaseName)) { $enumCase = $classReflection->getEnumCase($this->enumCaseName); $valueType = $enumCase->getBackingValueType(); if ($valueType === null) { throw new ShouldNotHappenException(); } return new EnumUnresolvedPropertyPrototypeReflection(new EnumPropertyReflection($classReflection, $valueType)); } } return parent::getUnresolvedPropertyPrototype($propertyName, $scope); } public function getBackingValueType() : ?Type { $classReflection = $this->getClassReflection(); if ($classReflection === null) { return null; } if (!$classReflection->isBackedEnum()) { return null; } if ($classReflection->hasEnumCase($this->enumCaseName)) { $enumCase = $classReflection->getEnumCase($this->enumCaseName); return $enumCase->getBackingValueType(); } return null; } public function generalize(GeneralizePrecision $precision) : Type { return new parent($this->getClassName(), null, $this->getClassReflection()); } public function isSmallerThan(Type $otherType) : TrinaryLogic { return TrinaryLogic::createNo(); } public function isSmallerThanOrEqual(Type $otherType) : TrinaryLogic { return TrinaryLogic::createNo(); } public function getEnumCases() : array { return [$this]; } public function toPhpDocNode() : TypeNode { return new ConstTypeNode(new ConstFetchNode($this->getClassName(), $this->getEnumCaseName())); } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : Type { return new self($properties['className'], $properties['enumCaseName'], null); } } <?php declare (strict_types=1); namespace PHPStan\Type; use PhpParser\Node\Expr\MethodCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\MethodReflection; use PHPStan\Reflection\ParameterReflection; /** * This is the interface dynamic parameter out type extensions implement for non-static methods. * * To register it in the configuration file use the `phpstan.methodParameterOutTypeExtension` service tag: * * ``` * services: * - * class: App\PHPStan\MyExtension * tags: * - phpstan.methodParameterOutTypeExtension * ``` * * @api */ interface MethodParameterOutTypeExtension { public function isMethodSupported(MethodReflection $methodReflection, ParameterReflection $parameter) : bool; public function getParameterOutTypeFromMethodCall(MethodReflection $methodReflection, MethodCall $methodCall, ParameterReflection $parameter, Scope $scope) : ?\PHPStan\Type\Type; } <?php declare (strict_types=1); namespace PHPStan\Type; use DateTime; use DateTimeImmutable; use DateTimeInterface; use PHPStan\Php\PhpVersion; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\PhpDocParser\Ast\Type\UnionTypeNode; use PHPStan\Reflection\ClassMemberAccessAnswerer; use PHPStan\Reflection\ConstantReflection; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\InitializerExprTypeResolver; use PHPStan\Reflection\PropertyReflection; use PHPStan\Reflection\Type\UnionTypeUnresolvedMethodPrototypeReflection; use PHPStan\Reflection\Type\UnionTypeUnresolvedPropertyPrototypeReflection; use PHPStan\Reflection\Type\UnresolvedMethodPrototypeReflection; use PHPStan\Reflection\Type\UnresolvedPropertyPrototypeReflection; use PHPStan\ShouldNotHappenException; use PHPStan\TrinaryLogic; use PHPStan\Type\Generic\GenericClassStringType; use PHPStan\Type\Generic\TemplateMixedType; use PHPStan\Type\Generic\TemplateType; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\Generic\TemplateTypeVariance; use PHPStan\Type\Generic\TemplateUnionType; use PHPStan\Type\Traits\NonGeneralizableTypeTrait; use function array_diff_assoc; use function array_fill_keys; use function array_map; use function array_merge; use function array_slice; use function array_unique; use function array_values; use function count; use function implode; use function md5; use function sprintf; use function str_contains; /** @api */ class UnionType implements \PHPStan\Type\CompoundType { /** * @var Type[] */ private $types; /** * @var bool */ private $normalized; use NonGeneralizableTypeTrait; /** * @var bool */ private $sortedTypes = \false; /** @var array<int, string> */ private $cachedDescriptions = []; /** * @api * @param Type[] $types */ public function __construct(array $types, bool $normalized = \false) { $this->types = $types; $this->normalized = $normalized; $throwException = static function () use($types) : void { throw new ShouldNotHappenException(sprintf('Cannot create %s with: %s', self::class, implode(', ', array_map(static function (\PHPStan\Type\Type $type) : string { return $type->describe(\PHPStan\Type\VerbosityLevel::value()); }, $types)))); }; if (count($types) < 2) { $throwException(); } foreach ($types as $type) { if (!$type instanceof \PHPStan\Type\UnionType) { continue; } if ($type instanceof TemplateType) { continue; } $throwException(); } } /** * @return Type[] */ public function getTypes() : array { return $this->types; } /** * @param callable(Type $type): bool $filterCb */ public function filterTypes(callable $filterCb) : \PHPStan\Type\Type { $newTypes = []; $changed = \false; foreach ($this->getTypes() as $innerType) { if (!$filterCb($innerType)) { $changed = \true; continue; } $newTypes[] = $innerType; } if (!$changed) { return $this; } return \PHPStan\Type\TypeCombinator::union(...$newTypes); } public function isNormalized() : bool { return $this->normalized; } /** * @return Type[] */ protected function getSortedTypes() : array { if ($this->sortedTypes) { return $this->types; } $this->types = \PHPStan\Type\UnionTypeHelper::sortTypes($this->types); $this->sortedTypes = \true; return $this->types; } /** * @return string[] */ public function getReferencedClasses() : array { $classes = []; foreach ($this->types as $type) { foreach ($type->getReferencedClasses() as $className) { $classes[] = $className; } } return $classes; } public function getObjectClassNames() : array { return array_values(array_unique($this->pickFromTypes(static function (\PHPStan\Type\Type $type) { return $type->getObjectClassNames(); }, static function (\PHPStan\Type\Type $type) { return $type->isObject()->yes(); }))); } public function getObjectClassReflections() : array { return $this->pickFromTypes(static function (\PHPStan\Type\Type $type) { return $type->getObjectClassReflections(); }, static function (\PHPStan\Type\Type $type) { return $type->isObject()->yes(); }); } public function getArrays() : array { return $this->pickFromTypes(static function (\PHPStan\Type\Type $type) { return $type->getArrays(); }, static function (\PHPStan\Type\Type $type) { return $type->isArray()->yes(); }); } public function getConstantArrays() : array { return $this->pickFromTypes(static function (\PHPStan\Type\Type $type) { return $type->getConstantArrays(); }, static function (\PHPStan\Type\Type $type) { return $type->isArray()->yes(); }); } public function getConstantStrings() : array { return $this->pickFromTypes(static function (\PHPStan\Type\Type $type) { return $type->getConstantStrings(); }, static function (\PHPStan\Type\Type $type) { return $type->isString()->yes(); }); } public function accepts(\PHPStan\Type\Type $type, bool $strictTypes) : TrinaryLogic { return $this->acceptsWithReason($type, $strictTypes)->result; } public function acceptsWithReason(\PHPStan\Type\Type $type, bool $strictTypes) : \PHPStan\Type\AcceptsResult { if ($type->equals(new \PHPStan\Type\ObjectType(DateTimeInterface::class)) && $this->accepts(new \PHPStan\Type\UnionType([new \PHPStan\Type\ObjectType(DateTime::class), new \PHPStan\Type\ObjectType(DateTimeImmutable::class)]), $strictTypes)->yes()) { return \PHPStan\Type\AcceptsResult::createYes(); } $result = \PHPStan\Type\AcceptsResult::createNo(); foreach ($this->getSortedTypes() as $i => $innerType) { $result = $result->or($innerType->acceptsWithReason($type, $strictTypes)->decorateReasons(static function (string $reason) use($i) { return sprintf('Type #%d from the union: %s', $i + 1, $reason); })); } if ($result->yes()) { return $result; } if ($type instanceof \PHPStan\Type\CompoundType && !$type instanceof \PHPStan\Type\CallableType && !$type instanceof TemplateType && !$type instanceof \PHPStan\Type\IntersectionType) { return $type->isAcceptedWithReasonBy($this, $strictTypes); } if ($type instanceof TemplateUnionType) { return $result->or($type->isAcceptedWithReasonBy($this, $strictTypes)); } if ($type->isEnum()->yes() && !$this->isEnum()->no()) { $enumCasesUnion = \PHPStan\Type\TypeCombinator::union(...$type->getEnumCases()); if (!$type->equals($enumCasesUnion)) { return $this->acceptsWithReason($enumCasesUnion, $strictTypes); } } return $result; } public function isSuperTypeOf(\PHPStan\Type\Type $otherType) : TrinaryLogic { return $this->isSuperTypeOfWithReason($otherType)->result; } public function isSuperTypeOfWithReason(\PHPStan\Type\Type $otherType) : \PHPStan\Type\IsSuperTypeOfResult { if ($otherType instanceof self && !$otherType instanceof TemplateUnionType || $otherType instanceof \PHPStan\Type\IterableType || $otherType instanceof \PHPStan\Type\NeverType || $otherType instanceof \PHPStan\Type\ConditionalType || $otherType instanceof \PHPStan\Type\ConditionalTypeForParameter || $otherType instanceof \PHPStan\Type\IntegerRangeType) { return $otherType->isSubTypeOfWithReason($this); } $results = []; foreach ($this->types as $innerType) { $result = $innerType->isSuperTypeOfWithReason($otherType); if ($result->yes()) { return $result; } $results[] = $result; } $result = \PHPStan\Type\IsSuperTypeOfResult::createNo()->or(...$results); if ($otherType instanceof TemplateUnionType) { return $result->or($otherType->isSubTypeOfWithReason($this)); } return $result; } public function isSubTypeOf(\PHPStan\Type\Type $otherType) : TrinaryLogic { return $this->isSubTypeOfWithReason($otherType)->result; } public function isSubTypeOfWithReason(\PHPStan\Type\Type $otherType) : \PHPStan\Type\IsSuperTypeOfResult { return \PHPStan\Type\IsSuperTypeOfResult::extremeIdentity(...array_map(static function (\PHPStan\Type\Type $innerType) use($otherType) { return $otherType->isSuperTypeOfWithReason($innerType); }, $this->types)); } public function isAcceptedBy(\PHPStan\Type\Type $acceptingType, bool $strictTypes) : TrinaryLogic { return $this->isAcceptedWithReasonBy($acceptingType, $strictTypes)->result; } public function isAcceptedWithReasonBy(\PHPStan\Type\Type $acceptingType, bool $strictTypes) : \PHPStan\Type\AcceptsResult { return \PHPStan\Type\AcceptsResult::extremeIdentity(...array_map(static function (\PHPStan\Type\Type $innerType) use($acceptingType, $strictTypes) { return $acceptingType->acceptsWithReason($innerType, $strictTypes); }, $this->types)); } public function equals(\PHPStan\Type\Type $type) : bool { if (!$type instanceof static) { return \false; } if (count($this->types) !== count($type->types)) { return \false; } $otherTypes = $type->types; foreach ($this->types as $innerType) { $match = \false; foreach ($otherTypes as $i => $otherType) { if (!$innerType->equals($otherType)) { continue; } $match = \true; unset($otherTypes[$i]); break; } if (!$match) { return \false; } } return count($otherTypes) === 0; } public function describe(\PHPStan\Type\VerbosityLevel $level) : string { if (isset($this->cachedDescriptions[$level->getLevelValue()])) { return $this->cachedDescriptions[$level->getLevelValue()]; } $joinTypes = static function (array $types) use($level) : string { $typeNames = []; foreach ($types as $i => $type) { if ($type instanceof \PHPStan\Type\ClosureType || $type instanceof \PHPStan\Type\CallableType || $type instanceof TemplateUnionType) { $typeNames[] = sprintf('(%s)', $type->describe($level)); } elseif ($type instanceof TemplateType) { $isLast = $i >= count($types) - 1; $bound = $type->getBound(); if (!$isLast && ($level->isTypeOnly() || $level->isValue()) && !($bound instanceof \PHPStan\Type\MixedType && $bound->getSubtractedType() === null && !$bound instanceof TemplateMixedType)) { $typeNames[] = sprintf('(%s)', $type->describe($level)); } else { $typeNames[] = $type->describe($level); } } elseif ($type instanceof \PHPStan\Type\IntersectionType) { $intersectionDescription = $type->describe($level); if (str_contains($intersectionDescription, '&')) { $typeNames[] = sprintf('(%s)', $type->describe($level)); } else { $typeNames[] = $intersectionDescription; } } else { $typeNames[] = $type->describe($level); } } if ($level->isPrecise()) { $duplicates = array_diff_assoc($typeNames, array_unique($typeNames)); if (count($duplicates) > 0) { $indexByDuplicate = array_fill_keys($duplicates, 0); foreach ($typeNames as $key => $typeName) { if (!isset($indexByDuplicate[$typeName])) { continue; } $typeNames[$key] = $typeName . '#' . ++$indexByDuplicate[$typeName]; } } } else { $typeNames = array_unique($typeNames); } if (count($typeNames) > 1024) { return implode('|', array_slice($typeNames, 0, 1024)) . "|…"; } return implode('|', $typeNames); }; return $this->cachedDescriptions[$level->getLevelValue()] = $level->handle(function () use($joinTypes) : string { $types = \PHPStan\Type\TypeCombinator::union(...array_map(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { if ($type->isConstantValue()->yes() && $type->isTrue()->or($type->isFalse())->no()) { return $type->generalize(\PHPStan\Type\GeneralizePrecision::lessSpecific()); } return $type; }, $this->getSortedTypes())); if ($types instanceof \PHPStan\Type\UnionType) { return $joinTypes($types->getSortedTypes()); } return $joinTypes([$types]); }, function () use($joinTypes) : string { return $joinTypes($this->getSortedTypes()); }); } /** * @param callable(Type $type): TrinaryLogic $canCallback * @param callable(Type $type): TrinaryLogic $hasCallback */ private function hasInternal(callable $canCallback, callable $hasCallback) : TrinaryLogic { return TrinaryLogic::lazyExtremeIdentity($this->types, static function (\PHPStan\Type\Type $type) use($canCallback, $hasCallback) : TrinaryLogic { if ($canCallback($type)->no()) { return TrinaryLogic::createNo(); } return $hasCallback($type); }); } /** * @template TObject of object * @param callable(Type $type): TrinaryLogic $hasCallback * @param callable(Type $type): TObject $getCallback * @return TObject */ private function getInternal(callable $hasCallback, callable $getCallback) : object { /** @var TrinaryLogic|null $result */ $result = null; /** @var TObject|null $object */ $object = null; foreach ($this->types as $type) { $has = $hasCallback($type); if (!$has->yes()) { continue; } if ($result !== null && $result->compareTo($has) !== $has) { continue; } $get = $getCallback($type); $result = $has; $object = $get; } if ($object === null) { throw new ShouldNotHappenException(); } return $object; } public function getTemplateType(string $ancestorClassName, string $templateTypeName) : \PHPStan\Type\Type { return $this->unionTypes(static function (\PHPStan\Type\Type $type) use($ancestorClassName, $templateTypeName) : \PHPStan\Type\Type { return $type->getTemplateType($ancestorClassName, $templateTypeName); }); } public function isObject() : TrinaryLogic { return $this->unionResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isObject(); }); } public function isEnum() : TrinaryLogic { return $this->unionResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isEnum(); }); } public function canAccessProperties() : TrinaryLogic { return $this->unionResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->canAccessProperties(); }); } public function hasProperty(string $propertyName) : TrinaryLogic { return $this->unionResults(static function (\PHPStan\Type\Type $type) use($propertyName) : TrinaryLogic { return $type->hasProperty($propertyName); }); } public function getProperty(string $propertyName, ClassMemberAccessAnswerer $scope) : PropertyReflection { return $this->getUnresolvedPropertyPrototype($propertyName, $scope)->getTransformedProperty(); } public function getUnresolvedPropertyPrototype(string $propertyName, ClassMemberAccessAnswerer $scope) : UnresolvedPropertyPrototypeReflection { $propertyPrototypes = []; foreach ($this->types as $type) { if (!$type->hasProperty($propertyName)->yes()) { continue; } $propertyPrototypes[] = $type->getUnresolvedPropertyPrototype($propertyName, $scope)->withFechedOnType($this); } $propertiesCount = count($propertyPrototypes); if ($propertiesCount === 0) { throw new ShouldNotHappenException(); } if ($propertiesCount === 1) { return $propertyPrototypes[0]; } return new UnionTypeUnresolvedPropertyPrototypeReflection($propertyName, $propertyPrototypes); } public function canCallMethods() : TrinaryLogic { return $this->unionResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->canCallMethods(); }); } public function hasMethod(string $methodName) : TrinaryLogic { return $this->unionResults(static function (\PHPStan\Type\Type $type) use($methodName) : TrinaryLogic { return $type->hasMethod($methodName); }); } public function getMethod(string $methodName, ClassMemberAccessAnswerer $scope) : ExtendedMethodReflection { return $this->getUnresolvedMethodPrototype($methodName, $scope)->getTransformedMethod(); } public function getUnresolvedMethodPrototype(string $methodName, ClassMemberAccessAnswerer $scope) : UnresolvedMethodPrototypeReflection { $methodPrototypes = []; foreach ($this->types as $type) { if (!$type->hasMethod($methodName)->yes()) { continue; } $methodPrototypes[] = $type->getUnresolvedMethodPrototype($methodName, $scope)->withCalledOnType($this); } $methodsCount = count($methodPrototypes); if ($methodsCount === 0) { throw new ShouldNotHappenException(); } if ($methodsCount === 1) { return $methodPrototypes[0]; } return new UnionTypeUnresolvedMethodPrototypeReflection($methodName, $methodPrototypes); } public function canAccessConstants() : TrinaryLogic { return $this->unionResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->canAccessConstants(); }); } public function hasConstant(string $constantName) : TrinaryLogic { return $this->hasInternal(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->canAccessConstants(); }, static function (\PHPStan\Type\Type $type) use($constantName) : TrinaryLogic { return $type->hasConstant($constantName); }); } public function getConstant(string $constantName) : ConstantReflection { return $this->getInternal(static function (\PHPStan\Type\Type $type) use($constantName) : TrinaryLogic { return $type->hasConstant($constantName); }, static function (\PHPStan\Type\Type $type) use($constantName) : ConstantReflection { return $type->getConstant($constantName); }); } public function isIterable() : TrinaryLogic { return $this->unionResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isIterable(); }); } public function isIterableAtLeastOnce() : TrinaryLogic { return $this->unionResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isIterableAtLeastOnce(); }); } public function getArraySize() : \PHPStan\Type\Type { return $this->unionTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->getArraySize(); }); } public function getIterableKeyType() : \PHPStan\Type\Type { return $this->unionTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->getIterableKeyType(); }); } public function getFirstIterableKeyType() : \PHPStan\Type\Type { return $this->unionTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->getFirstIterableKeyType(); }); } public function getLastIterableKeyType() : \PHPStan\Type\Type { return $this->unionTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->getLastIterableKeyType(); }); } public function getIterableValueType() : \PHPStan\Type\Type { return $this->unionTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->getIterableValueType(); }); } public function getFirstIterableValueType() : \PHPStan\Type\Type { return $this->unionTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->getFirstIterableValueType(); }); } public function getLastIterableValueType() : \PHPStan\Type\Type { return $this->unionTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->getLastIterableValueType(); }); } public function isArray() : TrinaryLogic { return $this->notBenevolentUnionResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isArray(); }); } public function isConstantArray() : TrinaryLogic { return $this->notBenevolentUnionResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isConstantArray(); }); } public function isOversizedArray() : TrinaryLogic { return $this->notBenevolentUnionResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isOversizedArray(); }); } public function isList() : TrinaryLogic { return $this->notBenevolentUnionResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isList(); }); } public function isString() : TrinaryLogic { return $this->notBenevolentUnionResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isString(); }); } public function isNumericString() : TrinaryLogic { return $this->notBenevolentUnionResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isNumericString(); }); } public function isNonEmptyString() : TrinaryLogic { return $this->notBenevolentUnionResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isNonEmptyString(); }); } public function isNonFalsyString() : TrinaryLogic { return $this->notBenevolentUnionResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isNonFalsyString(); }); } public function isLiteralString() : TrinaryLogic { return $this->notBenevolentUnionResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isLiteralString(); }); } public function isLowercaseString() : TrinaryLogic { return $this->notBenevolentUnionResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isLowercaseString(); }); } public function isUppercaseString() : TrinaryLogic { return $this->notBenevolentUnionResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isUppercaseString(); }); } public function isClassStringType() : TrinaryLogic { return $this->notBenevolentUnionResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isClassStringType(); }); } public function getClassStringObjectType() : \PHPStan\Type\Type { return $this->unionTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->getClassStringObjectType(); }); } public function getObjectTypeOrClassStringObjectType() : \PHPStan\Type\Type { return $this->unionTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->getObjectTypeOrClassStringObjectType(); }); } public function isVoid() : TrinaryLogic { return $this->unionResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isVoid(); }); } public function isScalar() : TrinaryLogic { return $this->unionResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isScalar(); }); } public function looseCompare(\PHPStan\Type\Type $type, PhpVersion $phpVersion) : \PHPStan\Type\BooleanType { return new \PHPStan\Type\BooleanType(); } public function isOffsetAccessible() : TrinaryLogic { return $this->unionResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isOffsetAccessible(); }); } public function isOffsetAccessLegal() : TrinaryLogic { return $this->unionResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isOffsetAccessLegal(); }); } public function hasOffsetValueType(\PHPStan\Type\Type $offsetType) : TrinaryLogic { return $this->unionResults(static function (\PHPStan\Type\Type $type) use($offsetType) : TrinaryLogic { return $type->hasOffsetValueType($offsetType); }); } public function getOffsetValueType(\PHPStan\Type\Type $offsetType) : \PHPStan\Type\Type { $types = []; foreach ($this->types as $innerType) { $valueType = $innerType->getOffsetValueType($offsetType); if ($valueType instanceof \PHPStan\Type\ErrorType) { continue; } $types[] = $valueType; } if (count($types) === 0) { return new \PHPStan\Type\ErrorType(); } return \PHPStan\Type\TypeCombinator::union(...$types); } public function setOffsetValueType(?\PHPStan\Type\Type $offsetType, \PHPStan\Type\Type $valueType, bool $unionValues = \true) : \PHPStan\Type\Type { return $this->unionTypes(static function (\PHPStan\Type\Type $type) use($offsetType, $valueType, $unionValues) : \PHPStan\Type\Type { return $type->setOffsetValueType($offsetType, $valueType, $unionValues); }); } public function setExistingOffsetValueType(\PHPStan\Type\Type $offsetType, \PHPStan\Type\Type $valueType) : \PHPStan\Type\Type { return $this->unionTypes(static function (\PHPStan\Type\Type $type) use($offsetType, $valueType) : \PHPStan\Type\Type { return $type->setExistingOffsetValueType($offsetType, $valueType); }); } public function unsetOffset(\PHPStan\Type\Type $offsetType) : \PHPStan\Type\Type { return $this->unionTypes(static function (\PHPStan\Type\Type $type) use($offsetType) : \PHPStan\Type\Type { return $type->unsetOffset($offsetType); }); } public function getKeysArray() : \PHPStan\Type\Type { return $this->unionTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->getKeysArray(); }); } public function getValuesArray() : \PHPStan\Type\Type { return $this->unionTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->getValuesArray(); }); } public function chunkArray(\PHPStan\Type\Type $lengthType, TrinaryLogic $preserveKeys) : \PHPStan\Type\Type { return $this->unionTypes(static function (\PHPStan\Type\Type $type) use($lengthType, $preserveKeys) : \PHPStan\Type\Type { return $type->chunkArray($lengthType, $preserveKeys); }); } public function fillKeysArray(\PHPStan\Type\Type $valueType) : \PHPStan\Type\Type { return $this->unionTypes(static function (\PHPStan\Type\Type $type) use($valueType) : \PHPStan\Type\Type { return $type->fillKeysArray($valueType); }); } public function flipArray() : \PHPStan\Type\Type { return $this->unionTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->flipArray(); }); } public function intersectKeyArray(\PHPStan\Type\Type $otherArraysType) : \PHPStan\Type\Type { return $this->unionTypes(static function (\PHPStan\Type\Type $type) use($otherArraysType) : \PHPStan\Type\Type { return $type->intersectKeyArray($otherArraysType); }); } public function popArray() : \PHPStan\Type\Type { return $this->unionTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->popArray(); }); } public function reverseArray(TrinaryLogic $preserveKeys) : \PHPStan\Type\Type { return $this->unionTypes(static function (\PHPStan\Type\Type $type) use($preserveKeys) : \PHPStan\Type\Type { return $type->reverseArray($preserveKeys); }); } public function searchArray(\PHPStan\Type\Type $needleType) : \PHPStan\Type\Type { return $this->unionTypes(static function (\PHPStan\Type\Type $type) use($needleType) : \PHPStan\Type\Type { return $type->searchArray($needleType); }); } public function shiftArray() : \PHPStan\Type\Type { return $this->unionTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->shiftArray(); }); } public function shuffleArray() : \PHPStan\Type\Type { return $this->unionTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->shuffleArray(); }); } public function sliceArray(\PHPStan\Type\Type $offsetType, \PHPStan\Type\Type $lengthType, TrinaryLogic $preserveKeys) : \PHPStan\Type\Type { return $this->unionTypes(static function (\PHPStan\Type\Type $type) use($offsetType, $lengthType, $preserveKeys) : \PHPStan\Type\Type { return $type->sliceArray($offsetType, $lengthType, $preserveKeys); }); } public function getEnumCases() : array { return $this->pickFromTypes(static function (\PHPStan\Type\Type $type) { return $type->getEnumCases(); }, static function (\PHPStan\Type\Type $type) { return $type->isObject()->yes(); }); } public function isCallable() : TrinaryLogic { return $this->unionResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isCallable(); }); } public function getCallableParametersAcceptors(ClassMemberAccessAnswerer $scope) : array { $acceptors = []; foreach ($this->types as $type) { if ($type->isCallable()->no()) { continue; } $acceptors = array_merge($acceptors, $type->getCallableParametersAcceptors($scope)); } if (count($acceptors) === 0) { throw new ShouldNotHappenException(); } return $acceptors; } public function isCloneable() : TrinaryLogic { return $this->unionResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isCloneable(); }); } public function isSmallerThan(\PHPStan\Type\Type $otherType) : TrinaryLogic { return $this->notBenevolentUnionResults(static function (\PHPStan\Type\Type $type) use($otherType) : TrinaryLogic { return $type->isSmallerThan($otherType); }); } public function isSmallerThanOrEqual(\PHPStan\Type\Type $otherType) : TrinaryLogic { return $this->notBenevolentUnionResults(static function (\PHPStan\Type\Type $type) use($otherType) : TrinaryLogic { return $type->isSmallerThanOrEqual($otherType); }); } public function isNull() : TrinaryLogic { return $this->notBenevolentUnionResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isNull(); }); } public function isConstantValue() : TrinaryLogic { return $this->notBenevolentUnionResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isConstantValue(); }); } public function isConstantScalarValue() : TrinaryLogic { return $this->notBenevolentUnionResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isConstantScalarValue(); }); } public function getConstantScalarTypes() : array { return $this->notBenevolentPickFromTypes(static function (\PHPStan\Type\Type $type) { return $type->getConstantScalarTypes(); }); } public function getConstantScalarValues() : array { return $this->notBenevolentPickFromTypes(static function (\PHPStan\Type\Type $type) { return $type->getConstantScalarValues(); }); } public function isTrue() : TrinaryLogic { return $this->notBenevolentUnionResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isTrue(); }); } public function isFalse() : TrinaryLogic { return $this->notBenevolentUnionResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isFalse(); }); } public function isBoolean() : TrinaryLogic { return $this->notBenevolentUnionResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isBoolean(); }); } public function isFloat() : TrinaryLogic { return $this->notBenevolentUnionResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isFloat(); }); } public function isInteger() : TrinaryLogic { return $this->notBenevolentUnionResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isInteger(); }); } public function getSmallerType() : \PHPStan\Type\Type { return $this->unionTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->getSmallerType(); }); } public function getSmallerOrEqualType() : \PHPStan\Type\Type { return $this->unionTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->getSmallerOrEqualType(); }); } public function getGreaterType() : \PHPStan\Type\Type { return $this->unionTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->getGreaterType(); }); } public function getGreaterOrEqualType() : \PHPStan\Type\Type { return $this->unionTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->getGreaterOrEqualType(); }); } public function isGreaterThan(\PHPStan\Type\Type $otherType) : TrinaryLogic { return $this->notBenevolentUnionResults(static function (\PHPStan\Type\Type $type) use($otherType) : TrinaryLogic { return $otherType->isSmallerThan($type); }); } public function isGreaterThanOrEqual(\PHPStan\Type\Type $otherType) : TrinaryLogic { return $this->notBenevolentUnionResults(static function (\PHPStan\Type\Type $type) use($otherType) : TrinaryLogic { return $otherType->isSmallerThanOrEqual($type); }); } public function toBoolean() : \PHPStan\Type\BooleanType { /** @var BooleanType $type */ $type = $this->unionTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\BooleanType { return $type->toBoolean(); }); return $type; } public function toNumber() : \PHPStan\Type\Type { $type = $this->unionTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->toNumber(); }); return $type; } public function toAbsoluteNumber() : \PHPStan\Type\Type { $type = $this->unionTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->toAbsoluteNumber(); }); return $type; } public function toString() : \PHPStan\Type\Type { $type = $this->unionTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->toString(); }); return $type; } public function toInteger() : \PHPStan\Type\Type { $type = $this->unionTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->toInteger(); }); return $type; } public function toFloat() : \PHPStan\Type\Type { $type = $this->unionTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->toFloat(); }); return $type; } public function toArray() : \PHPStan\Type\Type { $type = $this->unionTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->toArray(); }); return $type; } public function toArrayKey() : \PHPStan\Type\Type { return $this->unionTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->toArrayKey(); }); } public function inferTemplateTypes(\PHPStan\Type\Type $receivedType) : TemplateTypeMap { $types = TemplateTypeMap::createEmpty(); if ($receivedType instanceof \PHPStan\Type\UnionType) { $myTypes = []; $remainingReceivedTypes = []; foreach ($receivedType->getTypes() as $receivedInnerType) { foreach ($this->types as $type) { if ($type->isSuperTypeOf($receivedInnerType)->yes()) { $types = $types->union($type->inferTemplateTypes($receivedInnerType)); continue 2; } $myTypes[] = $type; } $remainingReceivedTypes[] = $receivedInnerType; } if (count($remainingReceivedTypes) === 0) { return $types; } $receivedType = \PHPStan\Type\TypeCombinator::union(...$remainingReceivedTypes); } else { $myTypes = $this->types; } foreach ($myTypes as $type) { if ($type instanceof TemplateType || $type instanceof GenericClassStringType && $type->getGenericType() instanceof TemplateType) { continue; } $types = $types->union($type->inferTemplateTypes($receivedType)); } if (!$types->isEmpty()) { return $types; } foreach ($myTypes as $type) { $types = $types->union($type->inferTemplateTypes($receivedType)); } return $types; } public function inferTemplateTypesOn(\PHPStan\Type\Type $templateType) : TemplateTypeMap { $types = TemplateTypeMap::createEmpty(); foreach ($this->types as $type) { $types = $types->union($templateType->inferTemplateTypes($type)); } return $types; } public function getReferencedTemplateTypes(TemplateTypeVariance $positionVariance) : array { $references = []; foreach ($this->types as $type) { foreach ($type->getReferencedTemplateTypes($positionVariance) as $reference) { $references[] = $reference; } } return $references; } public function traverse(callable $cb) : \PHPStan\Type\Type { $types = []; $changed = \false; foreach ($this->types as $type) { $newType = $cb($type); if ($type !== $newType) { $changed = \true; } $types[] = $newType; } if ($changed) { return \PHPStan\Type\TypeCombinator::union(...$types); } return $this; } public function traverseSimultaneously(\PHPStan\Type\Type $right, callable $cb) : \PHPStan\Type\Type { $types = []; $changed = \false; if (!$right instanceof self) { return $this; } if (count($this->getTypes()) !== count($right->getTypes())) { return $this; } foreach ($this->getSortedTypes() as $i => $leftType) { $rightType = $right->getSortedTypes()[$i]; $newType = $cb($leftType, $rightType); if ($leftType !== $newType) { $changed = \true; } $types[] = $newType; } if ($changed) { return \PHPStan\Type\TypeCombinator::union(...$types); } return $this; } public function tryRemove(\PHPStan\Type\Type $typeToRemove) : ?\PHPStan\Type\Type { return $this->unionTypes(static function (\PHPStan\Type\Type $type) use($typeToRemove) : \PHPStan\Type\Type { return \PHPStan\Type\TypeCombinator::remove($type, $typeToRemove); }); } public function exponentiate(\PHPStan\Type\Type $exponent) : \PHPStan\Type\Type { return $this->unionTypes(static function (\PHPStan\Type\Type $type) use($exponent) : \PHPStan\Type\Type { return $type->exponentiate($exponent); }); } public function getFiniteTypes() : array { $types = $this->notBenevolentPickFromTypes(static function (\PHPStan\Type\Type $type) { return $type->getFiniteTypes(); }); $uniquedTypes = []; foreach ($types as $type) { $uniquedTypes[md5($type->describe(\PHPStan\Type\VerbosityLevel::cache()))] = $type; } if (count($uniquedTypes) > InitializerExprTypeResolver::CALCULATE_SCALARS_LIMIT) { return []; } return array_values($uniquedTypes); } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : \PHPStan\Type\Type { return new self($properties['types'], $properties['normalized']); } /** * @param callable(Type $type): TrinaryLogic $getResult */ protected function unionResults(callable $getResult) : TrinaryLogic { return TrinaryLogic::lazyExtremeIdentity($this->types, $getResult); } /** * @param callable(Type $type): TrinaryLogic $getResult */ private function notBenevolentUnionResults(callable $getResult) : TrinaryLogic { return TrinaryLogic::lazyExtremeIdentity($this->types, $getResult); } /** * @param callable(Type $type): Type $getType */ protected function unionTypes(callable $getType) : \PHPStan\Type\Type { return \PHPStan\Type\TypeCombinator::union(...array_map($getType, $this->types)); } /** * @template T of Type * @param callable(Type $type): list<T> $getTypes * @return list<T> * * @deprecated Use pickFromTypes() instead. */ protected function pickTypes(callable $getTypes) : array { return $this->pickFromTypes($getTypes, static function () { return \false; }); } /** * @template T * @param callable(Type $type): list<T> $getValues * @param callable(Type $type): bool $criteria * @return list<T> */ protected function pickFromTypes(callable $getValues, callable $criteria) : array { $values = []; foreach ($this->types as $type) { $innerValues = $getValues($type); if ($innerValues === []) { return []; } foreach ($innerValues as $innerType) { $values[] = $innerType; } } return $values; } public function toPhpDocNode() : TypeNode { return new UnionTypeNode(array_map(static function (\PHPStan\Type\Type $type) { return $type->toPhpDocNode(); }, $this->getSortedTypes())); } /** * @template T * @param callable(Type $type): list<T> $getValues * @return list<T> */ private function notBenevolentPickFromTypes(callable $getValues) : array { $values = []; foreach ($this->types as $type) { $innerValues = $getValues($type); if ($innerValues === []) { return []; } foreach ($innerValues as $innerType) { $values[] = $innerType; } } return $values; } } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\Broker\Broker; use PHPStan\Reflection\BrokerAwareExtension; use function array_filter; use function array_values; final class OperatorTypeSpecifyingExtensionRegistry { /** * @var OperatorTypeSpecifyingExtension[] */ private $extensions; /** * @param OperatorTypeSpecifyingExtension[] $extensions */ public function __construct(?Broker $broker, array $extensions) { $this->extensions = $extensions; if ($broker === null) { return; } foreach ($extensions as $extension) { if (!$extension instanceof BrokerAwareExtension) { continue; } $extension->setBroker($broker); } } /** * @return OperatorTypeSpecifyingExtension[] */ public function getOperatorTypeSpecifyingExtensions(string $operator, \PHPStan\Type\Type $leftType, \PHPStan\Type\Type $rightType) : array { return array_values(array_filter($this->extensions, static function (\PHPStan\Type\OperatorTypeSpecifyingExtension $extension) use($operator, $leftType, $rightType) : bool { return $extension->isOperatorSupported($operator, $leftType, $rightType); })); } } <?php declare (strict_types=1); namespace PHPStan\Type; final class SimultaneousTypeTraverser { /** @var callable(Type $left, Type $right, callable(Type, Type): Type $traverse): Type */ private $cb; /** * @param callable(Type $left, Type $right, callable(Type, Type): Type $traverse): Type $cb */ public static function map(\PHPStan\Type\Type $left, \PHPStan\Type\Type $right, callable $cb) : \PHPStan\Type\Type { $self = new self($cb); return $self->mapInternal($left, $right); } /** @param callable(Type $left, Type $right, callable(Type, Type): Type $traverse): Type $cb */ private function __construct(callable $cb) { $this->cb = $cb; } /** @internal */ public function mapInternal(\PHPStan\Type\Type $left, \PHPStan\Type\Type $right) : \PHPStan\Type\Type { return ($this->cb)($left, $right, [$this, 'traverseInternal']); } /** @internal */ public function traverseInternal(\PHPStan\Type\Type $left, \PHPStan\Type\Type $right) : \PHPStan\Type\Type { return $left->traverseSimultaneously($right, [$this, 'mapInternal']); } } <?php declare (strict_types=1); namespace PHPStan\Type; use PhpParser\Node\Expr; use PhpParser\Node\Expr\BinaryOp\BitwiseOr; use PhpParser\Node\Expr\ConstFetch; use PhpParser\Node\Name\FullyQualified; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ReflectionProvider; use PHPStan\TrinaryLogic; use PHPStan\Type\Constant\ConstantIntegerType; final class BitwiseFlagHelper { /** * @var ReflectionProvider */ private $reflectionProvider; public function __construct(ReflectionProvider $reflectionProvider) { $this->reflectionProvider = $reflectionProvider; } /** * @param non-empty-string $constName */ public function bitwiseOrContainsConstant(Expr $expr, Scope $scope, string $constName) : TrinaryLogic { if ($expr instanceof ConstFetch) { if ((string) $expr->name === $constName) { return TrinaryLogic::createYes(); } $resolveConstantName = $this->reflectionProvider->resolveConstantName($expr->name, $scope); if ($resolveConstantName !== null) { if ($resolveConstantName === $constName) { return TrinaryLogic::createYes(); } return TrinaryLogic::createNo(); } } if ($expr instanceof BitwiseOr) { return TrinaryLogic::createFromBoolean($this->bitwiseOrContainsConstant($expr->left, $scope, $constName)->yes() || $this->bitwiseOrContainsConstant($expr->right, $scope, $constName)->yes()); } $fqcn = new FullyQualified($constName); if ($this->reflectionProvider->hasConstant($fqcn, $scope)) { $constant = $this->reflectionProvider->getConstant($fqcn, $scope); $valueType = $constant->getValueType(); if ($valueType instanceof ConstantIntegerType) { return $this->exprContainsIntFlag($expr, $scope, $valueType->getValue()); } } return TrinaryLogic::createNo(); } private function exprContainsIntFlag(Expr $expr, Scope $scope, int $flag) : TrinaryLogic { $exprType = $scope->getType($expr); if ($exprType instanceof \PHPStan\Type\UnionType) { $allTypesContainFlag = \true; $someTypesContainFlag = \false; foreach ($exprType->getTypes() as $type) { $containsFlag = $this->typeContainsIntFlag($type, $flag); if (!$containsFlag->yes()) { $allTypesContainFlag = \false; } if (!$containsFlag->yes() && !$containsFlag->maybe()) { continue; } $someTypesContainFlag = \true; } if ($allTypesContainFlag) { return TrinaryLogic::createYes(); } if ($someTypesContainFlag) { return TrinaryLogic::createMaybe(); } return TrinaryLogic::createNo(); } return $this->typeContainsIntFlag($exprType, $flag); } private function typeContainsIntFlag(\PHPStan\Type\Type $type, int $flag) : TrinaryLogic { if ($type instanceof ConstantIntegerType) { if (($type->getValue() & $flag) === $flag) { return TrinaryLogic::createYes(); } return TrinaryLogic::createNo(); } if ($type->isInteger()->yes() || $type instanceof \PHPStan\Type\MixedType) { return TrinaryLogic::createMaybe(); } return TrinaryLogic::createNo(); } } <?php declare (strict_types=1); namespace PHPStan\Type; use PhpParser\Node\Expr\StaticCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\MethodReflection; use PHPStan\Reflection\ParameterReflection; /** * This is the interface dynamic parameter out type extensions implement for static methods. * * To register it in the configuration file use the `phpstan.staticMethodParameterOutTypeExtension` service tag: * * ``` * services: * - * class: App\PHPStan\MyExtension * tags: * - phpstan.staticMethodParameterOutTypeExtension * ``` * * @api */ interface StaticMethodParameterOutTypeExtension { public function isStaticMethodSupported(MethodReflection $methodReflection, ParameterReflection $parameter) : bool; public function getParameterOutTypeFromStaticMethodCall(MethodReflection $methodReflection, StaticCall $methodCall, ParameterReflection $parameter, Scope $scope) : ?\PHPStan\Type\Type; } <?php declare (strict_types=1); namespace PHPStan\Type; /** @api */ interface LateResolvableType { public function resolve() : \PHPStan\Type\Type; public function isResolvable() : bool; } <?php declare (strict_types=1); namespace PHPStan\Type; /** @api */ class ErrorType extends \PHPStan\Type\MixedType { /** @api */ public function __construct() { parent::__construct(); } public function describe(\PHPStan\Type\VerbosityLevel $level) : string { return $level->handle(function () use($level) : string { return parent::describe($level); }, function () use($level) : string { return parent::describe($level); }, static function () : string { return '*ERROR*'; }); } public function getIterableKeyType() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function getIterableValueType() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function subtract(\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return new self(); } public function equals(\PHPStan\Type\Type $type) : bool { return $type instanceof self; } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : \PHPStan\Type\Type { return new self(); } } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\Analyser\NameScope; use PHPStan\PhpDoc\TypeNodeResolver; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; final class TypeAlias { /** * @var TypeNode */ private $typeNode; /** * @var NameScope */ private $nameScope; /** * @var ?Type */ private $resolvedType = null; public function __construct(TypeNode $typeNode, NameScope $nameScope) { $this->typeNode = $typeNode; $this->nameScope = $nameScope; } public static function invalid() : self { $self = new self(new IdentifierTypeNode('*ERROR*'), new NameScope(null, [])); $self->resolvedType = new \PHPStan\Type\CircularTypeAliasErrorType(); return $self; } public function resolve(TypeNodeResolver $typeNodeResolver) : \PHPStan\Type\Type { if ($this->resolvedType === null) { $this->resolvedType = $typeNodeResolver->resolve($this->typeNode, $this->nameScope); } return $this->resolvedType; } } <?php declare (strict_types=1); namespace PHPStan\Type\Regex; final class RegexNonCapturingGroup { /** * @readonly * @var ?RegexAlternation */ private $alternation; /** * @readonly * @var bool */ private $inOptionalQuantification; /** * @readonly * @var RegexCapturingGroup|RegexNonCapturingGroup|null */ private $parent; /** * @readonly * @var bool */ private $resetGroupCounter; /** * @param RegexCapturingGroup|RegexNonCapturingGroup|null $parent */ public function __construct(?\PHPStan\Type\Regex\RegexAlternation $alternation, bool $inOptionalQuantification, $parent, bool $resetGroupCounter) { $this->alternation = $alternation; $this->inOptionalQuantification = $inOptionalQuantification; $this->parent = $parent; $this->resetGroupCounter = $resetGroupCounter; } /** @phpstan-assert-if-true !null $this->getAlternationId() */ public function inAlternation() : bool { return $this->alternation !== null; } public function getAlternationId() : ?int { if ($this->alternation === null) { return null; } return $this->alternation->getId(); } public function isOptional() : bool { return $this->inAlternation() || $this->inOptionalQuantification || $this->parent !== null && $this->parent->isOptional(); } public function isTopLevel() : bool { return $this->parent === null || $this->parent instanceof \PHPStan\Type\Regex\RegexNonCapturingGroup && $this->parent->isTopLevel(); } /** * @return RegexCapturingGroup|RegexNonCapturingGroup|null */ public function getParent() { return $this->parent; } public function resetsGroupCounter() : bool { return $this->resetGroupCounter; } } <?php declare (strict_types=1); namespace PHPStan\Type\Regex; /** @immutable */ final class RegexAstWalkResult { /** * @var int */ private $alternationId; /** * @var int */ private $captureGroupId; /** * @var array<int, RegexCapturingGroup> */ private $capturingGroups; /** * @var list<string> */ private $markVerbs; /** * @param array<int, RegexCapturingGroup> $capturingGroups * @param list<string> $markVerbs */ public function __construct(int $alternationId, int $captureGroupId, array $capturingGroups, array $markVerbs) { $this->alternationId = $alternationId; $this->captureGroupId = $captureGroupId; $this->capturingGroups = $capturingGroups; $this->markVerbs = $markVerbs; } public static function createEmpty() : self { return new self( -1, // use different start-index for groups to make it easier to distinguish groupids from other ids 100, [], [] ); } public function nextAlternationId() : self { return new self($this->alternationId + 1, $this->captureGroupId, $this->capturingGroups, $this->markVerbs); } public function nextCaptureGroupId() : self { return new self($this->alternationId, $this->captureGroupId + 1, $this->capturingGroups, $this->markVerbs); } public function addCapturingGroup(\PHPStan\Type\Regex\RegexCapturingGroup $group) : self { $capturingGroups = $this->capturingGroups; $capturingGroups[$group->getId()] = $group; return new self($this->alternationId, $this->captureGroupId, $capturingGroups, $this->markVerbs); } public function markVerb(string $markVerb) : self { $verbs = $this->markVerbs; $verbs[] = $markVerb; return new self($this->alternationId, $this->captureGroupId, $this->capturingGroups, $verbs); } public function getAlternationId() : int { return $this->alternationId; } public function getCaptureGroupId() : int { return $this->captureGroupId; } /** * @return array<int, RegexCapturingGroup> */ public function getCapturingGroups() : array { return $this->capturingGroups; } /** * @return list<string> */ public function getMarkVerbs() : array { return $this->markVerbs; } } <?php declare (strict_types=1); namespace PHPStan\Type\Regex; use PhpParser\Node\Expr; use PhpParser\Node\Expr\BinaryOp\Concat; use PhpParser\Node\Name; use PHPStan\Analyser\Scope; use PHPStan\Reflection\InitializerExprTypeResolver; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function array_key_exists; use function ltrim; use function strrpos; use function substr; final class RegexExpressionHelper { /** * @var InitializerExprTypeResolver */ private $initializerExprTypeResolver; public function __construct(InitializerExprTypeResolver $initializerExprTypeResolver) { $this->initializerExprTypeResolver = $initializerExprTypeResolver; } /** * Ignores preg_quote() calls in the concatenation as these are not relevant for array-shape matching. * * This assumption only works for the ArrayShapeMatcher therefore it is not implemented for the common case in Scope. * * see https://github.com/phpstan/phpstan-src/pull/3233#discussion_r1676938085 */ public function resolvePatternConcat(Concat $concat, Scope $scope) : Type { $resolver = new class($scope) { /** * @var Scope */ private $scope; public function __construct(Scope $scope) { $this->scope = $scope; } public function resolve(Expr $expr) : Type { // assume preg_quote() cannot create capturing groups or contain meta characters. // replace it with a pattern which matches anything, does not affect $matches results // and does not produce regex errors when followed by a quantifier. // this allows us to turn string concatenations with preg_quote() into static analyzable strings. if ($expr instanceof Expr\FuncCall && $expr->name instanceof Name && $expr->name->toLowerString() === 'preg_quote') { return new ConstantStringType('(?:.*)'); } if ($expr instanceof Concat) { $left = $this->resolve($expr->left); $right = $this->resolve($expr->right); $strings = []; foreach ($left->toString()->getConstantStrings() as $leftString) { foreach ($right->toString()->getConstantStrings() as $rightString) { $strings[] = new ConstantStringType($leftString->getValue() . $rightString->getValue()); } } return TypeCombinator::union(...$strings); } return $this->scope->getType($expr); } }; return $this->initializerExprTypeResolver->getConcatType($concat->left, $concat->right, static function (Expr $expr) use($resolver) : Type { return $resolver->resolve($expr); }); } public function getPatternModifiers(string $pattern) : ?string { $endDelimiterPos = $this->getEndDelimiterPos($pattern); if ($endDelimiterPos === \false) { return null; } return substr($pattern, $endDelimiterPos + 1); } public function removeDelimitersAndModifiers(string $pattern) : string { $pattern = ltrim($pattern); $endDelimiterPos = $this->getEndDelimiterPos($pattern); if ($endDelimiterPos === \false) { return $pattern; } return substr($pattern, 1, $endDelimiterPos - 1); } /** * @return false|int */ private function getEndDelimiterPos(string $pattern) { $startDelimiter = $this->getPatternDelimiter($pattern); if ($startDelimiter === null) { return \false; } // delimiter variants, see https://www.php.net/manual/en/regexp.reference.delimiters.php $bracketStyleDelimiters = ['{' => '}', '(' => ')', '[' => ']', '<' => '>']; if (array_key_exists($startDelimiter, $bracketStyleDelimiters)) { $endDelimiterPos = strrpos($pattern, $bracketStyleDelimiters[$startDelimiter]); } else { // same start and end delimiter $endDelimiterPos = strrpos($pattern, $startDelimiter); } return $endDelimiterPos; } /** * Get delimiters from non-constant patterns, if possible. * * @return string[] */ public function getPatternDelimiters(Concat $concat, Scope $scope) : array { if ($concat->left instanceof Concat) { return $this->getPatternDelimiters($concat->left, $scope); } $left = $scope->getType($concat->left); $delimiters = []; foreach ($left->getConstantStrings() as $leftString) { $delimiter = $this->getPatternDelimiter($leftString->getValue()); if ($delimiter === null) { continue; } $delimiters[] = $delimiter; } return $delimiters; } private function getPatternDelimiter(string $regex) : ?string { $regex = ltrim($regex); if ($regex === '') { return null; } return substr($regex, 0, 1); } } <?php declare (strict_types=1); namespace PHPStan\Type\Regex; use PHPStan\TrinaryLogic; /** @immutable */ final class RegexGroupWalkResult { /** * @var bool */ private $inOptionalQuantification; /** * @var array<string>|null */ private $onlyLiterals; /** * @var TrinaryLogic */ private $isNonEmpty; /** * @var TrinaryLogic */ private $isNonFalsy; /** * @var TrinaryLogic */ private $isNumeric; /** * @param array<string>|null $onlyLiterals */ public function __construct(bool $inOptionalQuantification, ?array $onlyLiterals, TrinaryLogic $isNonEmpty, TrinaryLogic $isNonFalsy, TrinaryLogic $isNumeric) { $this->inOptionalQuantification = $inOptionalQuantification; $this->onlyLiterals = $onlyLiterals; $this->isNonEmpty = $isNonEmpty; $this->isNonFalsy = $isNonFalsy; $this->isNumeric = $isNumeric; } public static function createEmpty() : self { return new self(\false, [], TrinaryLogic::createMaybe(), TrinaryLogic::createMaybe(), TrinaryLogic::createMaybe()); } public function inOptionalQuantification(bool $inOptionalQuantification) : self { return new self($inOptionalQuantification, $this->onlyLiterals, $this->isNonEmpty, $this->isNonFalsy, $this->isNumeric); } /** * @param array<string>|null $onlyLiterals */ public function onlyLiterals(?array $onlyLiterals) : self { return new self($this->inOptionalQuantification, $onlyLiterals, $this->isNonEmpty, $this->isNonFalsy, $this->isNumeric); } public function nonEmpty(TrinaryLogic $nonEmpty) : self { return new self($this->inOptionalQuantification, $this->onlyLiterals, $nonEmpty, $this->isNonFalsy, $this->isNumeric); } public function nonFalsy(TrinaryLogic $nonFalsy) : self { return new self($this->inOptionalQuantification, $this->onlyLiterals, $this->isNonEmpty, $nonFalsy, $this->isNumeric); } public function numeric(TrinaryLogic $numeric) : self { return new self($this->inOptionalQuantification, $this->onlyLiterals, $this->isNonEmpty, $this->isNonFalsy, $numeric); } public function isInOptionalQuantification() : bool { return $this->inOptionalQuantification; } /** * @return array<string>|null */ public function getOnlyLiterals() : ?array { return $this->onlyLiterals; } public function isNonEmpty() : TrinaryLogic { return $this->isNonEmpty; } public function isNonFalsy() : TrinaryLogic { return $this->isNonFalsy; } public function isNumeric() : TrinaryLogic { return $this->isNumeric; } } <?php declare (strict_types=1); namespace PHPStan\Type\Regex; use PHPStan\Type\Type; final class RegexCapturingGroup { /** * @readonly * @var int */ private $id; /** * @readonly * @var ?string */ private $name; /** * @readonly * @var ?RegexAlternation */ private $alternation; /** * @readonly * @var bool */ private $inOptionalQuantification; /** * @readonly * @var RegexCapturingGroup|RegexNonCapturingGroup|null */ private $parent; /** * @readonly * @var Type */ private $type; /** * @var bool */ private $forceNonOptional = \false; /** * @var ?Type */ private $forceType = null; /** * @param RegexCapturingGroup|RegexNonCapturingGroup|null $parent */ public function __construct(int $id, ?string $name, ?\PHPStan\Type\Regex\RegexAlternation $alternation, bool $inOptionalQuantification, $parent, Type $type) { $this->id = $id; $this->name = $name; $this->alternation = $alternation; $this->inOptionalQuantification = $inOptionalQuantification; $this->parent = $parent; $this->type = $type; } public function getId() : int { return $this->id; } public function forceNonOptional() : void { $this->forceNonOptional = \true; } public function forceType(Type $type) : void { $this->forceType = $type; } public function clearOverrides() : void { $this->forceNonOptional = \false; $this->forceType = null; } public function resetsGroupCounter() : bool { return $this->parent instanceof \PHPStan\Type\Regex\RegexNonCapturingGroup && $this->parent->resetsGroupCounter(); } /** * @phpstan-assert-if-true !null $this->getAlternationId() * @phpstan-assert-if-true !null $this->getAlternation() */ public function inAlternation() : bool { return $this->alternation !== null; } public function getAlternation() : ?\PHPStan\Type\Regex\RegexAlternation { return $this->alternation; } public function getAlternationId() : ?int { if ($this->alternation === null) { return null; } return $this->alternation->getId(); } public function isOptional() : bool { if ($this->forceNonOptional) { return \false; } return $this->inAlternation() || $this->inOptionalQuantification || $this->parent !== null && $this->parent->isOptional(); } public function inOptionalQuantification() : bool { return $this->inOptionalQuantification; } public function inOptionalAlternation() : bool { if (!$this->inAlternation()) { return \false; } $parent = $this->parent; while ($parent !== null && $parent->getAlternationId() === $this->getAlternationId()) { if (!$parent instanceof \PHPStan\Type\Regex\RegexNonCapturingGroup) { return \false; } $parent = $parent->getParent(); } return $parent !== null && $parent->isOptional(); } public function isTopLevel() : bool { return $this->parent === null || $this->parent instanceof \PHPStan\Type\Regex\RegexNonCapturingGroup && $this->parent->isTopLevel(); } /** @phpstan-assert-if-true !null $this->getName() */ public function isNamed() : bool { return $this->name !== null; } public function getName() : ?string { return $this->name; } public function getType() : Type { if ($this->forceType !== null) { return $this->forceType; } return $this->type; } } <?php declare (strict_types=1); namespace PHPStan\Type\Regex; use function array_key_exists; final class RegexAlternation { /** * @readonly * @var int */ private $alternationId; /** * @readonly * @var int */ private $alternationsCount; /** @var array<int, list<int>> */ private $groupCombinations = []; public function __construct(int $alternationId, int $alternationsCount) { $this->alternationId = $alternationId; $this->alternationsCount = $alternationsCount; } public function getId() : int { return $this->alternationId; } public function pushGroup(int $combinationIndex, \PHPStan\Type\Regex\RegexCapturingGroup $group) : void { if (!array_key_exists($combinationIndex, $this->groupCombinations)) { $this->groupCombinations[$combinationIndex] = []; } $this->groupCombinations[$combinationIndex][] = $group->getId(); } public function getAlternationsCount() : int { return $this->alternationsCount; } /** * @return array<int, list<int>> */ public function getGroupCombinations() : array { return $this->groupCombinations; } } <?php declare (strict_types=1); namespace PHPStan\Type\Regex; use Hoa\Compiler\Llk\Llk; use Hoa\Compiler\Llk\Parser; use Hoa\Compiler\Llk\TreeNode; use Hoa\Exception\Exception; use Hoa\File\Read; use _PHPStan_7d8742a37\Nette\Utils\RegexpException; use _PHPStan_7d8742a37\Nette\Utils\Strings; use PHPStan\Php\PhpVersion; use PHPStan\ShouldNotHappenException; use PHPStan\TrinaryLogic; use PHPStan\Type\Accessory\AccessoryNonEmptyStringType; use PHPStan\Type\Accessory\AccessoryNonFalsyStringType; use PHPStan\Type\Accessory\AccessoryNumericStringType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\IntersectionType; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function array_values; use function count; use function in_array; use function is_int; use function preg_replace; use function rtrim; use function sscanf; use function str_contains; use function str_replace; use function strlen; use function substr; use function trim; final class RegexGroupParser { /** * @var PhpVersion */ private $phpVersion; /** * @var RegexExpressionHelper */ private $regexExpressionHelper; private const NOT_SUPPORTED_MODIFIERS = ['J']; /** * @var ?Parser */ private static $parser = null; public function __construct(PhpVersion $phpVersion, \PHPStan\Type\Regex\RegexExpressionHelper $regexExpressionHelper) { $this->phpVersion = $phpVersion; $this->regexExpressionHelper = $regexExpressionHelper; } /** * @return array{array<int, RegexCapturingGroup>, list<string>}|null */ public function parseGroups(string $regex) : ?array { if (self::$parser === null) { /** @throws void */ self::$parser = Llk::load(new Read(__DIR__ . '/../../../resources/RegexGrammar.pp')); } try { Strings::match('', $regex); } catch (RegexpException $e) { // pattern is invalid, so let the RegularExpressionPatternRule report it return null; } $modifiers = $this->regexExpressionHelper->getPatternModifiers($regex) ?? ''; foreach (self::NOT_SUPPORTED_MODIFIERS as $notSupportedModifier) { if (str_contains($modifiers, $notSupportedModifier)) { return null; } } if (str_contains($modifiers, 'x')) { // in freespacing mode the # character starts a comment and runs until the end of the line $regex = preg_replace('/(?<!\\?)#.*/', '', $regex) ?? ''; } $rawRegex = $this->regexExpressionHelper->removeDelimitersAndModifiers($regex); try { $ast = self::$parser->parse($rawRegex); } catch (Exception $e) { return null; } $this->updateAlternationAstRemoveVerticalBarsAndAddEmptyToken($ast); $this->updateCapturingAstAddEmptyToken($ast); $captureOnlyNamed = \false; if ($this->phpVersion->supportsPregCaptureOnlyNamedGroups()) { $captureOnlyNamed = str_contains($modifiers, 'n'); } $astWalkResult = $this->walkRegexAst($ast, null, 0, \false, null, $captureOnlyNamed, \false, $modifiers, \PHPStan\Type\Regex\RegexAstWalkResult::createEmpty()); return [$astWalkResult->getCapturingGroups(), $astWalkResult->getMarkVerbs()]; } private function createEmptyTokenTreeNode(TreeNode $parentAst) : TreeNode { return new TreeNode('token', ['token' => 'literal', 'value' => '', 'namespace' => 'default'], [], $parentAst); } private function updateAlternationAstRemoveVerticalBarsAndAddEmptyToken(TreeNode $ast) : void { $children = $ast->getChildren(); foreach ($children as $i => $child) { $this->updateAlternationAstRemoveVerticalBarsAndAddEmptyToken($child); if ($ast->getId() !== '#alternation' || $child->getValueToken() !== 'alternation') { continue; } unset($children[$i]); if ($i !== 0 && isset($children[$i + 1]) && $children[$i + 1]->getValueToken() !== 'alternation') { continue; } $children[$i] = $this->createEmptyTokenTreeNode($ast); } $ast->setChildren(array_values($children)); } private function updateCapturingAstAddEmptyToken(TreeNode $ast) : void { foreach ($ast->getChildren() as $child) { $this->updateCapturingAstAddEmptyToken($child); } if ($ast->getId() !== '#capturing' || $ast->getChildren() !== []) { return; } $emptyAlternationAst = new TreeNode('#alternation', null, [], $ast); $emptyAlternationAst->setChildren([$this->createEmptyTokenTreeNode($emptyAlternationAst)]); $ast->setChildren([$emptyAlternationAst]); } /** * @param RegexCapturingGroup|RegexNonCapturingGroup|null $parentGroup */ private function walkRegexAst(TreeNode $ast, ?\PHPStan\Type\Regex\RegexAlternation $alternation, int $combinationIndex, bool $inOptionalQuantification, $parentGroup, bool $captureOnlyNamed, bool $repeatedMoreThanOnce, string $patternModifiers, \PHPStan\Type\Regex\RegexAstWalkResult $astWalkResult) : \PHPStan\Type\Regex\RegexAstWalkResult { $group = null; if ($ast->getId() === '#capturing') { $astWalkResult = $astWalkResult->nextCaptureGroupId(); $group = new \PHPStan\Type\Regex\RegexCapturingGroup($astWalkResult->getCaptureGroupId(), null, $alternation, $inOptionalQuantification, $parentGroup, $this->createGroupType($ast, $this->allowConstantTypes($patternModifiers, $repeatedMoreThanOnce, $parentGroup), $patternModifiers)); $parentGroup = $group; } elseif ($ast->getId() === '#namedcapturing') { $astWalkResult = $astWalkResult->nextCaptureGroupId(); $name = $ast->getChild(0)->getValueValue(); $group = new \PHPStan\Type\Regex\RegexCapturingGroup($astWalkResult->getCaptureGroupId(), $name, $alternation, $inOptionalQuantification, $parentGroup, $this->createGroupType($ast, $this->allowConstantTypes($patternModifiers, $repeatedMoreThanOnce, $parentGroup), $patternModifiers)); $parentGroup = $group; } elseif ($ast->getId() === '#noncapturing') { $group = new \PHPStan\Type\Regex\RegexNonCapturingGroup($alternation, $inOptionalQuantification, $parentGroup, \false); $parentGroup = $group; } elseif ($ast->getId() === '#noncapturingreset') { $group = new \PHPStan\Type\Regex\RegexNonCapturingGroup($alternation, $inOptionalQuantification, $parentGroup, \true); $parentGroup = $group; } $inOptionalQuantification = \false; if ($ast->getId() === '#quantification') { [$min, $max] = $this->getQuantificationRange($ast); if ($min === 0) { $inOptionalQuantification = \true; } if ($max === null || $max > 1) { $repeatedMoreThanOnce = \true; } } if ($ast->getId() === '#alternation') { $astWalkResult = $astWalkResult->nextAlternationId(); $alternation = new \PHPStan\Type\Regex\RegexAlternation($astWalkResult->getAlternationId(), count($ast->getChildren())); } if ($ast->getId() === '#mark') { return $astWalkResult->markVerb($ast->getChild(0)->getValueValue()); } if ($group instanceof \PHPStan\Type\Regex\RegexCapturingGroup && (!$captureOnlyNamed || $group->isNamed())) { $astWalkResult = $astWalkResult->addCapturingGroup($group); if ($alternation !== null) { $alternation->pushGroup($combinationIndex, $group); } } foreach ($ast->getChildren() as $child) { $astWalkResult = $this->walkRegexAst($child, $alternation, $combinationIndex, $inOptionalQuantification, $parentGroup, $captureOnlyNamed, $repeatedMoreThanOnce, $patternModifiers, $astWalkResult); if ($ast->getId() !== '#alternation') { continue; } $combinationIndex++; } return $astWalkResult; } /** * @param RegexCapturingGroup|RegexNonCapturingGroup|null $parentGroup */ private function allowConstantTypes(string $patternModifiers, bool $repeatedMoreThanOnce, $parentGroup) : bool { if (str_contains($patternModifiers, 'i')) { // if caseless, we don't use constant types // because it likely yields too many combinations return \false; } if ($repeatedMoreThanOnce) { return \false; } if ($parentGroup !== null && $parentGroup->resetsGroupCounter()) { return \false; } return \true; } /** @return array{?int, ?int} */ private function getQuantificationRange(TreeNode $node) : array { if ($node->getId() !== '#quantification') { throw new ShouldNotHappenException(); } $min = null; $max = null; $lastChild = $node->getChild($node->getChildrenNumber() - 1); $value = $lastChild->getValue(); // normalize away possessive and lazy quantifier-modifiers $token = str_replace(['_possessive', '_lazy'], '', $value['token']); $value = rtrim($value['value'], '+?'); if ($token === 'n_to_m') { if (sscanf($value, '{%d,%d}', $n, $m) !== 2 || !is_int($n) || !is_int($m)) { throw new ShouldNotHappenException(); } $min = $n; $max = $m; } elseif ($token === 'n_or_more') { if (sscanf($value, '{%d,}', $n) !== 1 || !is_int($n)) { throw new ShouldNotHappenException(); } $min = $n; } elseif ($token === 'exactly_n') { if (sscanf($value, '{%d}', $n) !== 1 || !is_int($n)) { throw new ShouldNotHappenException(); } $min = $n; $max = $n; } elseif ($token === 'zero_or_one') { $min = 0; $max = 1; } elseif ($token === 'zero_or_more') { $min = 0; } elseif ($token === 'one_or_more') { $min = 1; } return [$min, $max]; } private function createGroupType(TreeNode $group, bool $maybeConstant, string $patternModifiers) : Type { $rootAlternation = $this->getRootAlternation($group); if ($rootAlternation !== null) { $types = []; foreach ($rootAlternation->getChildren() as $alternative) { $types[] = $this->createGroupType($alternative, $maybeConstant, $patternModifiers); } return TypeCombinator::union(...$types); } $walkResult = $this->walkGroupAst($group, \false, \false, $patternModifiers, \PHPStan\Type\Regex\RegexGroupWalkResult::createEmpty()); if ($maybeConstant && $walkResult->getOnlyLiterals() !== null && $walkResult->getOnlyLiterals() !== []) { $result = []; foreach ($walkResult->getOnlyLiterals() as $literal) { $result[] = new ConstantStringType($literal); } return TypeCombinator::union(...$result); } if ($walkResult->isNumeric()->yes()) { if ($walkResult->isNonFalsy()->yes()) { return new IntersectionType([new StringType(), new AccessoryNumericStringType(), new AccessoryNonFalsyStringType()]); } $result = new IntersectionType([new StringType(), new AccessoryNumericStringType()]); if (!$walkResult->isNonEmpty()->yes()) { return TypeCombinator::union(new ConstantStringType(''), $result); } return $result; } elseif ($walkResult->isNonFalsy()->yes()) { return new IntersectionType([new StringType(), new AccessoryNonFalsyStringType()]); } elseif ($walkResult->isNonEmpty()->yes()) { return new IntersectionType([new StringType(), new AccessoryNonEmptyStringType()]); } return new StringType(); } private function getRootAlternation(TreeNode $group) : ?TreeNode { if ($group->getId() === '#capturing' && count($group->getChildren()) === 1 && $group->getChild(0)->getId() === '#alternation') { return $group->getChild(0); } // 1st token within a named capturing group is a token holding the group-name if ($group->getId() === '#namedcapturing' && count($group->getChildren()) === 2 && $group->getChild(1)->getId() === '#alternation') { return $group->getChild(1); } return null; } private function walkGroupAst(TreeNode $ast, bool $inAlternation, bool $inClass, string $patternModifiers, \PHPStan\Type\Regex\RegexGroupWalkResult $walkResult) : \PHPStan\Type\Regex\RegexGroupWalkResult { $children = $ast->getChildren(); if ($ast->getId() === '#concatenation' && count($children) > 0 && !$walkResult->isInOptionalQuantification()) { $meaningfulTokens = 0; foreach ($children as $child) { $nonFalsy = \false; if ($this->isMaybeEmptyNode($child, $patternModifiers, $nonFalsy)) { continue; } $meaningfulTokens++; if (!$nonFalsy || $inAlternation) { continue; } // a single token non-falsy on its own $walkResult = $walkResult->nonFalsy(TrinaryLogic::createYes()); break; } if ($meaningfulTokens > 0) { $walkResult = $walkResult->nonEmpty(TrinaryLogic::createYes()); // two non-empty tokens concatenated results in a non-falsy string if ($meaningfulTokens > 1 && !$inAlternation) { $walkResult = $walkResult->nonFalsy(TrinaryLogic::createYes()); } } } elseif ($ast->getId() === '#quantification') { [$min] = $this->getQuantificationRange($ast); if ($min === 0) { $walkResult = $walkResult->inOptionalQuantification(\true); } if (!$walkResult->isInOptionalQuantification()) { if ($min >= 1) { $walkResult = $walkResult->nonEmpty(TrinaryLogic::createYes()); } if ($min >= 2 && !$inAlternation) { $walkResult = $walkResult->nonFalsy(TrinaryLogic::createYes()); } } $walkResult = $walkResult->onlyLiterals(null); } elseif ($ast->getId() === '#class' && $walkResult->getOnlyLiterals() !== null) { $inClass = \true; $newLiterals = []; foreach ($children as $child) { $oldLiterals = $walkResult->getOnlyLiterals(); $this->getLiteralValue($child, $oldLiterals, \true, $patternModifiers, \true); foreach ($oldLiterals ?? [] as $oldLiteral) { $newLiterals[] = $oldLiteral; } } $walkResult = $walkResult->onlyLiterals($newLiterals); } elseif ($ast->getId() === 'token') { $onlyLiterals = $walkResult->getOnlyLiterals(); $literalValue = $this->getLiteralValue($ast, $onlyLiterals, !$inClass, $patternModifiers, \false); $walkResult = $walkResult->onlyLiterals($onlyLiterals); if ($literalValue !== null) { if (Strings::match($literalValue, '/^\\d+$/') === null) { $walkResult = $walkResult->numeric(TrinaryLogic::createNo()); } elseif ($walkResult->isNumeric()->maybe()) { $walkResult = $walkResult->numeric(TrinaryLogic::createYes()); } if (!$walkResult->isInOptionalQuantification() && $literalValue !== '') { $walkResult = $walkResult->nonEmpty(TrinaryLogic::createYes()); } } } elseif (!in_array($ast->getId(), ['#capturing', '#namedcapturing', '#alternation'], \true)) { $walkResult = $walkResult->onlyLiterals(null); } if ($ast->getId() === '#alternation') { $newLiterals = []; foreach ($children as $child) { $walkResult = $this->walkGroupAst($child, \true, $inClass, $patternModifiers, $walkResult->onlyLiterals([])); if ($newLiterals === null) { continue; } if (count($walkResult->getOnlyLiterals() ?? []) > 0) { foreach ($walkResult->getOnlyLiterals() as $alternationLiterals) { $newLiterals[] = $alternationLiterals; } } else { $newLiterals = null; } } return $walkResult->onlyLiterals($newLiterals); } // [^0-9] should not parse as numeric-string, and [^list-everything-but-numbers] is technically // doable but really silly compared to just \d so we can safely assume the string is not numeric // for negative classes if ($ast->getId() === '#negativeclass') { $walkResult = $walkResult->numeric(TrinaryLogic::createNo()); } foreach ($children as $child) { $walkResult = $this->walkGroupAst($child, $inAlternation, $inClass, $patternModifiers, $walkResult); } return $walkResult; } private function isMaybeEmptyNode(TreeNode $node, string $patternModifiers, bool &$isNonFalsy) : bool { if ($node->getId() === '#quantification') { [$min] = $this->getQuantificationRange($node); if ($min > 0) { return \false; } if ($min === 0) { return \true; } } $literal = $this->getLiteralValue($node, $onlyLiterals, \false, $patternModifiers, \false); if ($literal !== null) { if ($literal !== '' && $literal !== '0') { $isNonFalsy = \true; } return $literal === ''; } foreach ($node->getChildren() as $child) { if (!$this->isMaybeEmptyNode($child, $patternModifiers, $isNonFalsy)) { return \false; } } return \true; } /** * @param array<string>|null $onlyLiterals */ private function getLiteralValue(TreeNode $node, ?array &$onlyLiterals, bool $appendLiterals, string $patternModifiers, bool $inCharacterClass) : ?string { if ($node->getId() !== 'token') { return null; } // token is the token name from grammar without the namespace so literal and class:literal are both called literal here $token = $node->getValueToken(); $value = $node->getValueValue(); if (in_array($token, [ 'literal', // literal "-" in front/back of a character class like '[-a-z]' or '[abc-]', not forming a range 'range', // literal "[" or "]" inside character classes '[[]' or '[]]' 'class_', '_class', ], \true)) { if (str_contains($patternModifiers, 'x') && trim($value) === '') { return null; } $isEscaped = \false; if (strlen($value) > 1 && $value[0] === '\\') { $value = substr($value, 1) ?: ''; $isEscaped = \true; } if ($appendLiterals && $onlyLiterals !== null) { if (in_array($value, ['.'], \true) && !($isEscaped || $inCharacterClass)) { $onlyLiterals = null; } else { if ($onlyLiterals === []) { $onlyLiterals = [$value]; } else { foreach ($onlyLiterals as &$literal) { $literal .= $value; } } } } return $value; } if (!in_array($token, ['capturing_name'], \true)) { $onlyLiterals = null; } // character escape sequences, just return a fixed string if (in_array($token, ['character', 'dynamic_character', 'character_type'], \true)) { if ($token === 'character_type' && $value === '\\d') { return '0'; } return $value; } // [:digit:] and the like, more support coming later if ($token === 'posix_class') { if ($value === '[:digit:]') { return '0'; } if (in_array($value, ['[:alpha:]', '[:alnum:]', '[:upper:]', '[:lower:]', '[:word:]', '[:ascii:]', '[:print:]', '[:xdigit:]', '[:graph:]'], \true)) { return 'a'; } if ($value === '[:blank:]') { return " \t"; } if ($value === '[:cntrl:]') { return "\x00\x1f"; } if ($value === '[:space:]') { return " \t\r\n\v\f"; } if ($value === '[:punct:]') { return '!"#$%&\'()*+,\\-./:;<=>?@[\\]^_`{|}~'; } } if ($token === 'anchor' || $token === 'match_point_reset') { return ''; } return null; } } <?php declare (strict_types=1); namespace PHPStan\Type; use ArrayAccess; use PHPStan\Php\PhpVersion; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\Reflection\ClassMemberAccessAnswerer; use PHPStan\Reflection\ConstantReflection; use PHPStan\Reflection\Dummy\DummyConstantReflection; use PHPStan\Reflection\Dummy\DummyMethodReflection; use PHPStan\Reflection\Dummy\DummyPropertyReflection; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\PropertyReflection; use PHPStan\Reflection\TrivialParametersAcceptor; use PHPStan\Reflection\Type\CallbackUnresolvedMethodPrototypeReflection; use PHPStan\Reflection\Type\CallbackUnresolvedPropertyPrototypeReflection; use PHPStan\Reflection\Type\UnresolvedMethodPrototypeReflection; use PHPStan\Reflection\Type\UnresolvedPropertyPrototypeReflection; use PHPStan\TrinaryLogic; use PHPStan\Type\Accessory\AccessoryArrayListType; use PHPStan\Type\Accessory\AccessoryLiteralStringType; use PHPStan\Type\Accessory\AccessoryLowercaseStringType; use PHPStan\Type\Accessory\AccessoryNonEmptyStringType; use PHPStan\Type\Accessory\AccessoryNonFalsyStringType; use PHPStan\Type\Accessory\AccessoryNumericStringType; use PHPStan\Type\Accessory\AccessoryUppercaseStringType; use PHPStan\Type\Accessory\OversizedArrayType; use PHPStan\Type\Constant\ConstantArrayType; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantFloatType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\Generic\TemplateMixedType; use PHPStan\Type\Generic\TemplateType; use PHPStan\Type\Traits\NonGeneralizableTypeTrait; use PHPStan\Type\Traits\NonGenericTypeTrait; use PHPStan\Type\Traits\UndecidedComparisonCompoundTypeTrait; use function sprintf; /** @api */ class MixedType implements \PHPStan\Type\CompoundType, \PHPStan\Type\SubtractableType { /** * @var bool */ private $isExplicitMixed; use NonGenericTypeTrait; use UndecidedComparisonCompoundTypeTrait; use NonGeneralizableTypeTrait; /** * @var ?Type */ private $subtractedType; /** @api */ public function __construct(bool $isExplicitMixed = \false, ?\PHPStan\Type\Type $subtractedType = null) { $this->isExplicitMixed = $isExplicitMixed; if ($subtractedType instanceof \PHPStan\Type\NeverType) { $subtractedType = null; } $this->subtractedType = $subtractedType; } /** * @return string[] */ public function getReferencedClasses() : array { return []; } public function getObjectClassNames() : array { return []; } public function getObjectClassReflections() : array { return []; } public function getArrays() : array { return []; } public function getConstantArrays() : array { return []; } public function getConstantStrings() : array { return []; } public function accepts(\PHPStan\Type\Type $type, bool $strictTypes) : TrinaryLogic { return $this->acceptsWithReason($type, $strictTypes)->result; } public function acceptsWithReason(\PHPStan\Type\Type $type, bool $strictTypes) : \PHPStan\Type\AcceptsResult { return \PHPStan\Type\AcceptsResult::createYes(); } public function isSuperTypeOfMixed(\PHPStan\Type\MixedType $type) : TrinaryLogic { if ($this->subtractedType === null) { if ($this->isExplicitMixed) { if ($type->isExplicitMixed) { return TrinaryLogic::createYes(); } return TrinaryLogic::createMaybe(); } return TrinaryLogic::createYes(); } if ($type->subtractedType === null) { return TrinaryLogic::createMaybe(); } $isSuperType = $type->subtractedType->isSuperTypeOf($this->subtractedType); if ($isSuperType->yes()) { if ($this->isExplicitMixed) { if ($type->isExplicitMixed) { return TrinaryLogic::createYes(); } return TrinaryLogic::createMaybe(); } return TrinaryLogic::createYes(); } return TrinaryLogic::createMaybe(); } public function isSuperTypeOf(\PHPStan\Type\Type $type) : TrinaryLogic { return $this->isSuperTypeOfWithReason($type)->result; } public function isSuperTypeOfWithReason(\PHPStan\Type\Type $type) : \PHPStan\Type\IsSuperTypeOfResult { if ($this->subtractedType === null || $type instanceof \PHPStan\Type\NeverType) { return \PHPStan\Type\IsSuperTypeOfResult::createYes(); } if ($type instanceof self) { if ($type->subtractedType === null) { return \PHPStan\Type\IsSuperTypeOfResult::createMaybe(); } $isSuperType = $type->subtractedType->isSuperTypeOfWithReason($this->subtractedType); if ($isSuperType->yes()) { return $isSuperType; } return \PHPStan\Type\IsSuperTypeOfResult::createMaybe(); } $result = $this->subtractedType->isSuperTypeOfWithReason($type)->negate(); if ($result->no()) { return \PHPStan\Type\IsSuperTypeOfResult::createNo([sprintf('Type %s has already been eliminated from %s.', $this->subtractedType->describe(\PHPStan\Type\VerbosityLevel::precise()), $this->describe(\PHPStan\Type\VerbosityLevel::typeOnly()))]); } return $result; } public function setOffsetValueType(?\PHPStan\Type\Type $offsetType, \PHPStan\Type\Type $valueType, bool $unionValues = \true) : \PHPStan\Type\Type { return new self($this->isExplicitMixed); } public function setExistingOffsetValueType(\PHPStan\Type\Type $offsetType, \PHPStan\Type\Type $valueType) : \PHPStan\Type\Type { return new self($this->isExplicitMixed); } public function unsetOffset(\PHPStan\Type\Type $offsetType) : \PHPStan\Type\Type { if ($this->subtractedType !== null) { return new self($this->isExplicitMixed, \PHPStan\Type\TypeCombinator::remove($this->subtractedType, new ConstantArrayType([], []))); } return $this; } public function getKeysArray() : \PHPStan\Type\Type { if ($this->isArray()->no()) { return new \PHPStan\Type\ErrorType(); } return AccessoryArrayListType::intersectWith(new \PHPStan\Type\ArrayType(new \PHPStan\Type\IntegerType(), new \PHPStan\Type\UnionType([new \PHPStan\Type\IntegerType(), new \PHPStan\Type\StringType()]))); } public function getValuesArray() : \PHPStan\Type\Type { if ($this->isArray()->no()) { return new \PHPStan\Type\ErrorType(); } return AccessoryArrayListType::intersectWith(new \PHPStan\Type\ArrayType(new \PHPStan\Type\IntegerType(), new \PHPStan\Type\MixedType($this->isExplicitMixed))); } public function chunkArray(\PHPStan\Type\Type $lengthType, TrinaryLogic $preserveKeys) : \PHPStan\Type\Type { if ($this->isArray()->no()) { return new \PHPStan\Type\ErrorType(); } return AccessoryArrayListType::intersectWith(new \PHPStan\Type\ArrayType(new \PHPStan\Type\IntegerType(), new \PHPStan\Type\MixedType($this->isExplicitMixed))); } public function fillKeysArray(\PHPStan\Type\Type $valueType) : \PHPStan\Type\Type { if ($this->isArray()->no()) { return new \PHPStan\Type\ErrorType(); } return new \PHPStan\Type\ArrayType($this->getIterableValueType(), $valueType); } public function flipArray() : \PHPStan\Type\Type { if ($this->isArray()->no()) { return new \PHPStan\Type\ErrorType(); } return new \PHPStan\Type\ArrayType(new \PHPStan\Type\MixedType($this->isExplicitMixed), new \PHPStan\Type\MixedType($this->isExplicitMixed)); } public function intersectKeyArray(\PHPStan\Type\Type $otherArraysType) : \PHPStan\Type\Type { if ($this->isArray()->no()) { return new \PHPStan\Type\ErrorType(); } return new \PHPStan\Type\ArrayType(new \PHPStan\Type\MixedType($this->isExplicitMixed), new \PHPStan\Type\MixedType($this->isExplicitMixed)); } public function popArray() : \PHPStan\Type\Type { if ($this->isArray()->no()) { return new \PHPStan\Type\ErrorType(); } return new \PHPStan\Type\ArrayType(new \PHPStan\Type\MixedType($this->isExplicitMixed), new \PHPStan\Type\MixedType($this->isExplicitMixed)); } public function reverseArray(TrinaryLogic $preserveKeys) : \PHPStan\Type\Type { if ($this->isArray()->no()) { return new \PHPStan\Type\ErrorType(); } return new \PHPStan\Type\ArrayType(new \PHPStan\Type\MixedType($this->isExplicitMixed), new \PHPStan\Type\MixedType($this->isExplicitMixed)); } public function searchArray(\PHPStan\Type\Type $needleType) : \PHPStan\Type\Type { if ($this->isArray()->no()) { return new \PHPStan\Type\ErrorType(); } return \PHPStan\Type\TypeCombinator::union(new \PHPStan\Type\IntegerType(), new \PHPStan\Type\StringType(), new ConstantBooleanType(\false)); } public function shiftArray() : \PHPStan\Type\Type { if ($this->isArray()->no()) { return new \PHPStan\Type\ErrorType(); } return new \PHPStan\Type\ArrayType(new \PHPStan\Type\MixedType($this->isExplicitMixed), new \PHPStan\Type\MixedType($this->isExplicitMixed)); } public function shuffleArray() : \PHPStan\Type\Type { if ($this->isArray()->no()) { return new \PHPStan\Type\ErrorType(); } return AccessoryArrayListType::intersectWith(new \PHPStan\Type\ArrayType(new \PHPStan\Type\IntegerType(), new \PHPStan\Type\MixedType($this->isExplicitMixed))); } public function sliceArray(\PHPStan\Type\Type $offsetType, \PHPStan\Type\Type $lengthType, TrinaryLogic $preserveKeys) : \PHPStan\Type\Type { if ($this->isArray()->no()) { return new \PHPStan\Type\ErrorType(); } return new \PHPStan\Type\ArrayType(new \PHPStan\Type\MixedType($this->isExplicitMixed), new \PHPStan\Type\MixedType($this->isExplicitMixed)); } public function isCallable() : TrinaryLogic { if ($this->subtractedType !== null) { if ($this->subtractedType->isSuperTypeOf(new \PHPStan\Type\CallableType())->yes()) { return TrinaryLogic::createNo(); } } return TrinaryLogic::createMaybe(); } public function getEnumCases() : array { return []; } public function getCallableParametersAcceptors(ClassMemberAccessAnswerer $scope) : array { return [new TrivialParametersAcceptor()]; } public function equals(\PHPStan\Type\Type $type) : bool { if (!$type instanceof self) { return \false; } if ($this->subtractedType === null) { if ($type->subtractedType === null) { return \true; } return \false; } if ($type->subtractedType === null) { return \false; } return $this->subtractedType->equals($type->subtractedType); } public function isSubTypeOf(\PHPStan\Type\Type $otherType) : TrinaryLogic { return $this->isSubTypeOfWithReason($otherType)->result; } public function isSubTypeOfWithReason(\PHPStan\Type\Type $otherType) : \PHPStan\Type\IsSuperTypeOfResult { if ($otherType instanceof self && !$otherType instanceof TemplateMixedType) { return \PHPStan\Type\IsSuperTypeOfResult::createYes(); } if ($this->subtractedType !== null) { $isSuperType = $this->subtractedType->isSuperTypeOfWithReason($otherType); if ($isSuperType->yes()) { return \PHPStan\Type\IsSuperTypeOfResult::createNo(); } } return \PHPStan\Type\IsSuperTypeOfResult::createMaybe(); } public function isAcceptedBy(\PHPStan\Type\Type $acceptingType, bool $strictTypes) : TrinaryLogic { return $this->isAcceptedWithReasonBy($acceptingType, $strictTypes)->result; } public function isAcceptedWithReasonBy(\PHPStan\Type\Type $acceptingType, bool $strictTypes) : \PHPStan\Type\AcceptsResult { $isSuperType = $this->isSuperTypeOfWithReason($acceptingType)->toAcceptsResult(); if ($isSuperType->no()) { return $isSuperType; } return \PHPStan\Type\AcceptsResult::createYes(); } public function getTemplateType(string $ancestorClassName, string $templateTypeName) : \PHPStan\Type\Type { return new self(); } public function isObject() : TrinaryLogic { if ($this->subtractedType !== null) { if ($this->subtractedType->isSuperTypeOf(new \PHPStan\Type\ObjectWithoutClassType())->yes()) { return TrinaryLogic::createNo(); } } return TrinaryLogic::createMaybe(); } public function isEnum() : TrinaryLogic { if ($this->subtractedType !== null) { if ($this->subtractedType->isSuperTypeOf(new \PHPStan\Type\ObjectWithoutClassType())->yes()) { return TrinaryLogic::createNo(); } } return TrinaryLogic::createMaybe(); } public function canAccessProperties() : TrinaryLogic { return TrinaryLogic::createYes(); } public function hasProperty(string $propertyName) : TrinaryLogic { return TrinaryLogic::createYes(); } public function getProperty(string $propertyName, ClassMemberAccessAnswerer $scope) : PropertyReflection { return $this->getUnresolvedPropertyPrototype($propertyName, $scope)->getTransformedProperty(); } public function getUnresolvedPropertyPrototype(string $propertyName, ClassMemberAccessAnswerer $scope) : UnresolvedPropertyPrototypeReflection { $property = new DummyPropertyReflection(); return new CallbackUnresolvedPropertyPrototypeReflection($property, $property->getDeclaringClass(), \false, static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type; }); } public function canCallMethods() : TrinaryLogic { return TrinaryLogic::createYes(); } public function hasMethod(string $methodName) : TrinaryLogic { return TrinaryLogic::createYes(); } public function getMethod(string $methodName, ClassMemberAccessAnswerer $scope) : ExtendedMethodReflection { return $this->getUnresolvedMethodPrototype($methodName, $scope)->getTransformedMethod(); } public function getUnresolvedMethodPrototype(string $methodName, ClassMemberAccessAnswerer $scope) : UnresolvedMethodPrototypeReflection { $method = new DummyMethodReflection($methodName); return new CallbackUnresolvedMethodPrototypeReflection($method, $method->getDeclaringClass(), \false, static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type; }); } public function canAccessConstants() : TrinaryLogic { return TrinaryLogic::createYes(); } public function hasConstant(string $constantName) : TrinaryLogic { return TrinaryLogic::createYes(); } public function getConstant(string $constantName) : ConstantReflection { return new DummyConstantReflection($constantName); } public function isCloneable() : TrinaryLogic { return TrinaryLogic::createYes(); } public function describe(\PHPStan\Type\VerbosityLevel $level) : string { return $level->handle(static function () : string { return 'mixed'; }, static function () : string { return 'mixed'; }, function () use($level) : string { $description = 'mixed'; if ($this->subtractedType !== null) { $description .= $this->subtractedType instanceof \PHPStan\Type\UnionType ? sprintf('~(%s)', $this->subtractedType->describe($level)) : sprintf('~%s', $this->subtractedType->describe($level)); } return $description; }, function () use($level) : string { $description = 'mixed'; if ($this->subtractedType !== null) { $description .= $this->subtractedType instanceof \PHPStan\Type\UnionType ? sprintf('~(%s)', $this->subtractedType->describe($level)) : sprintf('~%s', $this->subtractedType->describe($level)); } if ($this->isExplicitMixed) { $description .= '=explicit'; } else { $description .= '=implicit'; } return $description; }); } public function toBoolean() : \PHPStan\Type\BooleanType { if ($this->subtractedType !== null) { if ($this->subtractedType->isSuperTypeOf(\PHPStan\Type\StaticTypeFactory::falsey())->yes()) { return new ConstantBooleanType(\true); } } return new \PHPStan\Type\BooleanType(); } public function toNumber() : \PHPStan\Type\Type { return \PHPStan\Type\TypeCombinator::union($this->toInteger(), $this->toFloat()); } public function toAbsoluteNumber() : \PHPStan\Type\Type { return $this->toNumber()->toAbsoluteNumber(); } public function toInteger() : \PHPStan\Type\Type { $castsToZero = new \PHPStan\Type\UnionType([new \PHPStan\Type\NullType(), new ConstantBooleanType(\false), new ConstantIntegerType(0), new ConstantArrayType([], []), new \PHPStan\Type\StringType(), new \PHPStan\Type\FloatType()]); if ($this->subtractedType !== null && $this->subtractedType->isSuperTypeOf($castsToZero)->yes()) { return new \PHPStan\Type\UnionType([\PHPStan\Type\IntegerRangeType::fromInterval(null, -1), \PHPStan\Type\IntegerRangeType::fromInterval(1, null)]); } return new \PHPStan\Type\IntegerType(); } public function toFloat() : \PHPStan\Type\Type { return new \PHPStan\Type\FloatType(); } public function toString() : \PHPStan\Type\Type { if ($this->subtractedType !== null) { $castsToEmptyString = new \PHPStan\Type\UnionType([new \PHPStan\Type\NullType(), new ConstantBooleanType(\false), new ConstantStringType('')]); if ($this->subtractedType->isSuperTypeOf($castsToEmptyString)->yes()) { $accessories = [new \PHPStan\Type\StringType(), new AccessoryNonEmptyStringType()]; $castsToZeroString = new \PHPStan\Type\UnionType([new ConstantFloatType(0.0), new ConstantStringType('0'), new ConstantIntegerType(0)]); if ($this->subtractedType->isSuperTypeOf($castsToZeroString)->yes()) { $accessories[] = new AccessoryNonFalsyStringType(); } return new \PHPStan\Type\IntersectionType($accessories); } } return new \PHPStan\Type\StringType(); } public function toArray() : \PHPStan\Type\Type { $mixed = new self($this->isExplicitMixed); return new \PHPStan\Type\ArrayType($mixed, $mixed); } public function toArrayKey() : \PHPStan\Type\Type { return new \PHPStan\Type\BenevolentUnionType([new \PHPStan\Type\IntegerType(), new \PHPStan\Type\StringType()]); } public function isIterable() : TrinaryLogic { if ($this->subtractedType !== null) { if ($this->subtractedType->isSuperTypeOf(new \PHPStan\Type\IterableType(new \PHPStan\Type\MixedType(), new \PHPStan\Type\MixedType()))->yes()) { return TrinaryLogic::createNo(); } } return TrinaryLogic::createMaybe(); } public function isIterableAtLeastOnce() : TrinaryLogic { return $this->isIterable(); } public function getArraySize() : \PHPStan\Type\Type { if ($this->isIterable()->no()) { return new \PHPStan\Type\ErrorType(); } return \PHPStan\Type\IntegerRangeType::fromInterval(0, null); } public function getIterableKeyType() : \PHPStan\Type\Type { return new self($this->isExplicitMixed); } public function getFirstIterableKeyType() : \PHPStan\Type\Type { return new self($this->isExplicitMixed); } public function getLastIterableKeyType() : \PHPStan\Type\Type { return new self($this->isExplicitMixed); } public function getIterableValueType() : \PHPStan\Type\Type { return new self($this->isExplicitMixed); } public function getFirstIterableValueType() : \PHPStan\Type\Type { return new self($this->isExplicitMixed); } public function getLastIterableValueType() : \PHPStan\Type\Type { return new self($this->isExplicitMixed); } public function isOffsetAccessible() : TrinaryLogic { if ($this->subtractedType !== null) { $offsetAccessibles = new \PHPStan\Type\UnionType([new \PHPStan\Type\StringType(), new \PHPStan\Type\ArrayType(new \PHPStan\Type\MixedType(), new \PHPStan\Type\MixedType()), new \PHPStan\Type\ObjectType(ArrayAccess::class)]); if ($this->subtractedType->isSuperTypeOf($offsetAccessibles)->yes()) { return TrinaryLogic::createNo(); } } return TrinaryLogic::createMaybe(); } public function isOffsetAccessLegal() : TrinaryLogic { if ($this->subtractedType !== null) { if ($this->subtractedType->isSuperTypeOf(new \PHPStan\Type\ObjectWithoutClassType())->yes()) { return TrinaryLogic::createYes(); } } return TrinaryLogic::createMaybe(); } public function hasOffsetValueType(\PHPStan\Type\Type $offsetType) : TrinaryLogic { if ($this->isOffsetAccessible()->no()) { return TrinaryLogic::createNo(); } return TrinaryLogic::createMaybe(); } public function getOffsetValueType(\PHPStan\Type\Type $offsetType) : \PHPStan\Type\Type { return new self($this->isExplicitMixed); } public function isExplicitMixed() : bool { return $this->isExplicitMixed; } public function subtract(\PHPStan\Type\Type $type) : \PHPStan\Type\Type { if ($type instanceof self && !$type instanceof TemplateType) { return new \PHPStan\Type\NeverType(); } if ($this->subtractedType !== null) { $type = \PHPStan\Type\TypeCombinator::union($this->subtractedType, $type); } return new self($this->isExplicitMixed, $type); } public function getTypeWithoutSubtractedType() : \PHPStan\Type\Type { return new self($this->isExplicitMixed); } public function changeSubtractedType(?\PHPStan\Type\Type $subtractedType) : \PHPStan\Type\Type { return new self($this->isExplicitMixed, $subtractedType); } public function getSubtractedType() : ?\PHPStan\Type\Type { return $this->subtractedType; } public function traverse(callable $cb) : \PHPStan\Type\Type { return $this; } public function traverseSimultaneously(\PHPStan\Type\Type $right, callable $cb) : \PHPStan\Type\Type { return $this; } public function isArray() : TrinaryLogic { if ($this->subtractedType !== null) { if ($this->subtractedType->isSuperTypeOf(new \PHPStan\Type\ArrayType(new \PHPStan\Type\MixedType(), new \PHPStan\Type\MixedType()))->yes()) { return TrinaryLogic::createNo(); } } return TrinaryLogic::createMaybe(); } public function isConstantArray() : TrinaryLogic { return $this->isArray(); } public function isOversizedArray() : TrinaryLogic { if ($this->subtractedType !== null) { $oversizedArray = \PHPStan\Type\TypeCombinator::intersect(new \PHPStan\Type\ArrayType(new \PHPStan\Type\MixedType(), new \PHPStan\Type\MixedType()), new OversizedArrayType()); if ($this->subtractedType->isSuperTypeOf($oversizedArray)->yes()) { return TrinaryLogic::createNo(); } } return TrinaryLogic::createMaybe(); } public function isList() : TrinaryLogic { if ($this->subtractedType !== null) { $list = \PHPStan\Type\TypeCombinator::intersect(new \PHPStan\Type\ArrayType(new \PHPStan\Type\IntegerType(), new \PHPStan\Type\MixedType()), new AccessoryArrayListType()); if ($this->subtractedType->isSuperTypeOf($list)->yes()) { return TrinaryLogic::createNo(); } } return TrinaryLogic::createMaybe(); } public function isNull() : TrinaryLogic { if ($this->subtractedType !== null) { if ($this->subtractedType->isSuperTypeOf(new \PHPStan\Type\NullType())->yes()) { return TrinaryLogic::createNo(); } } return TrinaryLogic::createMaybe(); } public function isConstantValue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isConstantScalarValue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getConstantScalarTypes() : array { return []; } public function getConstantScalarValues() : array { return []; } public function isTrue() : TrinaryLogic { if ($this->subtractedType !== null) { if ($this->subtractedType->isSuperTypeOf(new ConstantBooleanType(\true))->yes()) { return TrinaryLogic::createNo(); } } return TrinaryLogic::createMaybe(); } public function isFalse() : TrinaryLogic { if ($this->subtractedType !== null) { if ($this->subtractedType->isSuperTypeOf(new ConstantBooleanType(\false))->yes()) { return TrinaryLogic::createNo(); } } return TrinaryLogic::createMaybe(); } public function isBoolean() : TrinaryLogic { if ($this->subtractedType !== null) { if ($this->subtractedType->isSuperTypeOf(new \PHPStan\Type\BooleanType())->yes()) { return TrinaryLogic::createNo(); } } return TrinaryLogic::createMaybe(); } public function isFloat() : TrinaryLogic { if ($this->subtractedType !== null) { if ($this->subtractedType->isSuperTypeOf(new \PHPStan\Type\FloatType())->yes()) { return TrinaryLogic::createNo(); } } return TrinaryLogic::createMaybe(); } public function isInteger() : TrinaryLogic { if ($this->subtractedType !== null) { if ($this->subtractedType->isSuperTypeOf(new \PHPStan\Type\IntegerType())->yes()) { return TrinaryLogic::createNo(); } } return TrinaryLogic::createMaybe(); } public function isString() : TrinaryLogic { if ($this->subtractedType !== null) { if ($this->subtractedType->isSuperTypeOf(new \PHPStan\Type\StringType())->yes()) { return TrinaryLogic::createNo(); } } return TrinaryLogic::createMaybe(); } public function isNumericString() : TrinaryLogic { if ($this->subtractedType !== null) { $numericString = \PHPStan\Type\TypeCombinator::intersect(new \PHPStan\Type\StringType(), new AccessoryNumericStringType()); if ($this->subtractedType->isSuperTypeOf($numericString)->yes()) { return TrinaryLogic::createNo(); } } return TrinaryLogic::createMaybe(); } public function isNonEmptyString() : TrinaryLogic { if ($this->subtractedType !== null) { $nonEmptyString = \PHPStan\Type\TypeCombinator::intersect(new \PHPStan\Type\StringType(), new AccessoryNonEmptyStringType()); if ($this->subtractedType->isSuperTypeOf($nonEmptyString)->yes()) { return TrinaryLogic::createNo(); } } return TrinaryLogic::createMaybe(); } public function isNonFalsyString() : TrinaryLogic { if ($this->subtractedType !== null) { $nonFalsyString = \PHPStan\Type\TypeCombinator::intersect(new \PHPStan\Type\StringType(), new AccessoryNonFalsyStringType()); if ($this->subtractedType->isSuperTypeOf($nonFalsyString)->yes()) { return TrinaryLogic::createNo(); } } return TrinaryLogic::createMaybe(); } public function isLiteralString() : TrinaryLogic { if ($this->subtractedType !== null) { $literalString = \PHPStan\Type\TypeCombinator::intersect(new \PHPStan\Type\StringType(), new AccessoryLiteralStringType()); if ($this->subtractedType->isSuperTypeOf($literalString)->yes()) { return TrinaryLogic::createNo(); } } return TrinaryLogic::createMaybe(); } public function isLowercaseString() : TrinaryLogic { if ($this->subtractedType !== null) { $lowercaseString = \PHPStan\Type\TypeCombinator::intersect(new \PHPStan\Type\StringType(), new AccessoryLowercaseStringType()); if ($this->subtractedType->isSuperTypeOf($lowercaseString)->yes()) { return TrinaryLogic::createNo(); } } return TrinaryLogic::createMaybe(); } public function isUppercaseString() : TrinaryLogic { if ($this->subtractedType !== null) { $uppercaseString = \PHPStan\Type\TypeCombinator::intersect(new \PHPStan\Type\StringType(), new AccessoryUppercaseStringType()); if ($this->subtractedType->isSuperTypeOf($uppercaseString)->yes()) { return TrinaryLogic::createNo(); } } return TrinaryLogic::createMaybe(); } public function isClassStringType() : TrinaryLogic { if ($this->subtractedType !== null) { if ($this->subtractedType->isSuperTypeOf(new \PHPStan\Type\StringType())->yes()) { return TrinaryLogic::createNo(); } if ($this->subtractedType->isSuperTypeOf(new \PHPStan\Type\ClassStringType())->yes()) { return TrinaryLogic::createNo(); } } return TrinaryLogic::createMaybe(); } public function getClassStringObjectType() : \PHPStan\Type\Type { if (!$this->isClassStringType()->no()) { return new \PHPStan\Type\ObjectWithoutClassType(); } return new \PHPStan\Type\ErrorType(); } public function getObjectTypeOrClassStringObjectType() : \PHPStan\Type\Type { $objectOrClass = new \PHPStan\Type\UnionType([new \PHPStan\Type\ObjectWithoutClassType(), new \PHPStan\Type\ClassStringType()]); if (!$this->isSuperTypeOf($objectOrClass)->no()) { return new \PHPStan\Type\ObjectWithoutClassType(); } return new \PHPStan\Type\ErrorType(); } public function isVoid() : TrinaryLogic { if ($this->subtractedType !== null) { if ($this->subtractedType->isSuperTypeOf(new \PHPStan\Type\VoidType())->yes()) { return TrinaryLogic::createNo(); } } return TrinaryLogic::createMaybe(); } public function isScalar() : TrinaryLogic { if ($this->subtractedType !== null) { if ($this->subtractedType->isSuperTypeOf(new \PHPStan\Type\UnionType([new \PHPStan\Type\BooleanType(), new \PHPStan\Type\FloatType(), new \PHPStan\Type\IntegerType(), new \PHPStan\Type\StringType()]))->yes()) { return TrinaryLogic::createNo(); } } return TrinaryLogic::createMaybe(); } public function looseCompare(\PHPStan\Type\Type $type, PhpVersion $phpVersion) : \PHPStan\Type\BooleanType { return new \PHPStan\Type\BooleanType(); } public function tryRemove(\PHPStan\Type\Type $typeToRemove) : ?\PHPStan\Type\Type { if ($this->isSuperTypeOf($typeToRemove)->yes()) { return $this->subtract($typeToRemove); } return null; } public function exponentiate(\PHPStan\Type\Type $exponent) : \PHPStan\Type\Type { return new \PHPStan\Type\BenevolentUnionType([new \PHPStan\Type\FloatType(), new \PHPStan\Type\IntegerType()]); } public function getFiniteTypes() : array { return []; } public function toPhpDocNode() : TypeNode { return new IdentifierTypeNode('mixed'); } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : \PHPStan\Type\Type { return new self($properties['isExplicitMixed'], $properties['subtractedType'] ?? null); } } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ExtendedPropertyReflection; use PHPStan\Reflection\ReflectionProviderStaticAccessor; use PHPStan\TrinaryLogic; use stdClass; final class ObjectShapePropertyReflection implements ExtendedPropertyReflection { /** * @var Type */ private $type; public function __construct(\PHPStan\Type\Type $type) { $this->type = $type; } public function getDeclaringClass() : ClassReflection { $reflectionProvider = ReflectionProviderStaticAccessor::getInstance(); return $reflectionProvider->getClass(stdClass::class); } public function isStatic() : bool { return \false; } public function isPrivate() : bool { return \false; } public function isPublic() : bool { return \true; } public function getDocComment() : ?string { return null; } public function getReadableType() : \PHPStan\Type\Type { return $this->type; } public function getWritableType() : \PHPStan\Type\Type { return new \PHPStan\Type\NeverType(); } public function canChangeTypeAfterAssignment() : bool { return \false; } public function isReadable() : bool { return \true; } public function isWritable() : bool { return \false; } public function isDeprecated() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getDeprecatedDescription() : ?string { return null; } public function isInternal() : TrinaryLogic { return TrinaryLogic::createNo(); } } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\Php\PhpVersion; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\Reflection\ReflectionProviderStaticAccessor; use PHPStan\ShouldNotHappenException; use PHPStan\TrinaryLogic; use PHPStan\Type\Accessory\AccessoryNonEmptyStringType; use PHPStan\Type\Constant\ConstantArrayType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\Traits\MaybeCallableTypeTrait; use PHPStan\Type\Traits\NonArrayTypeTrait; use PHPStan\Type\Traits\NonGeneralizableTypeTrait; use PHPStan\Type\Traits\NonGenericTypeTrait; use PHPStan\Type\Traits\NonIterableTypeTrait; use PHPStan\Type\Traits\NonObjectTypeTrait; use PHPStan\Type\Traits\UndecidedBooleanTypeTrait; use PHPStan\Type\Traits\UndecidedComparisonTypeTrait; use function count; /** @api */ class StringType implements \PHPStan\Type\Type { use \PHPStan\Type\JustNullableTypeTrait; use MaybeCallableTypeTrait; use NonArrayTypeTrait; use NonIterableTypeTrait; use NonObjectTypeTrait; use UndecidedBooleanTypeTrait; use UndecidedComparisonTypeTrait; use NonGenericTypeTrait; use NonGeneralizableTypeTrait; /** @api */ public function __construct() { } public function describe(\PHPStan\Type\VerbosityLevel $level) : string { return 'string'; } public function getConstantStrings() : array { return []; } public function isOffsetAccessible() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isOffsetAccessLegal() : TrinaryLogic { return TrinaryLogic::createYes(); } public function hasOffsetValueType(\PHPStan\Type\Type $offsetType) : TrinaryLogic { return $offsetType->isInteger()->and(TrinaryLogic::createMaybe()); } public function getOffsetValueType(\PHPStan\Type\Type $offsetType) : \PHPStan\Type\Type { if ($this->hasOffsetValueType($offsetType)->no()) { return new \PHPStan\Type\ErrorType(); } return new \PHPStan\Type\IntersectionType([new \PHPStan\Type\StringType(), new AccessoryNonEmptyStringType()]); } public function setOffsetValueType(?\PHPStan\Type\Type $offsetType, \PHPStan\Type\Type $valueType, bool $unionValues = \true) : \PHPStan\Type\Type { if ($offsetType === null) { return new \PHPStan\Type\ErrorType(); } $valueStringType = $valueType->toString(); if ($valueStringType instanceof \PHPStan\Type\ErrorType) { return new \PHPStan\Type\ErrorType(); } if ($offsetType->isInteger()->yes() || $offsetType instanceof \PHPStan\Type\MixedType) { return new \PHPStan\Type\IntersectionType([new \PHPStan\Type\StringType(), new AccessoryNonEmptyStringType()]); } return new \PHPStan\Type\ErrorType(); } public function setExistingOffsetValueType(\PHPStan\Type\Type $offsetType, \PHPStan\Type\Type $valueType) : \PHPStan\Type\Type { return $this; } public function unsetOffset(\PHPStan\Type\Type $offsetType) : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function accepts(\PHPStan\Type\Type $type, bool $strictTypes) : TrinaryLogic { return $this->acceptsWithReason($type, $strictTypes)->result; } public function acceptsWithReason(\PHPStan\Type\Type $type, bool $strictTypes) : \PHPStan\Type\AcceptsResult { if ($type instanceof self) { return \PHPStan\Type\AcceptsResult::createYes(); } if ($type instanceof \PHPStan\Type\CompoundType) { return $type->isAcceptedWithReasonBy($this, $strictTypes); } $thatClassNames = $type->getObjectClassNames(); if (count($thatClassNames) > 1) { throw new ShouldNotHappenException(); } if ($thatClassNames === [] || $strictTypes) { return \PHPStan\Type\AcceptsResult::createNo(); } $reflectionProvider = ReflectionProviderStaticAccessor::getInstance(); if (!$reflectionProvider->hasClass($thatClassNames[0])) { return \PHPStan\Type\AcceptsResult::createNo(); } $typeClass = $reflectionProvider->getClass($thatClassNames[0]); return \PHPStan\Type\AcceptsResult::createFromBoolean($typeClass->hasNativeMethod('__toString')); } public function toNumber() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toAbsoluteNumber() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toInteger() : \PHPStan\Type\Type { return new \PHPStan\Type\IntegerType(); } public function toFloat() : \PHPStan\Type\Type { return new \PHPStan\Type\FloatType(); } public function toString() : \PHPStan\Type\Type { return $this; } public function toArray() : \PHPStan\Type\Type { return new ConstantArrayType([new ConstantIntegerType(0)], [$this], [1], [], TrinaryLogic::createYes()); } public function toArrayKey() : \PHPStan\Type\Type { return $this; } public function isNull() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isTrue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFalse() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isBoolean() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFloat() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isInteger() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isString() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isNumericString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isNonEmptyString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isNonFalsyString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isLiteralString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isLowercaseString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isUppercaseString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isClassStringType() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getClassStringObjectType() : \PHPStan\Type\Type { return new \PHPStan\Type\ObjectWithoutClassType(); } public function getObjectTypeOrClassStringObjectType() : \PHPStan\Type\Type { return new \PHPStan\Type\ObjectWithoutClassType(); } public function isScalar() : TrinaryLogic { return TrinaryLogic::createYes(); } public function looseCompare(\PHPStan\Type\Type $type, PhpVersion $phpVersion) : \PHPStan\Type\BooleanType { return new \PHPStan\Type\BooleanType(); } public function hasMethod(string $methodName) : TrinaryLogic { if ($this->isClassStringType()->yes()) { return TrinaryLogic::createMaybe(); } return TrinaryLogic::createNo(); } public function tryRemove(\PHPStan\Type\Type $typeToRemove) : ?\PHPStan\Type\Type { if ($typeToRemove instanceof ConstantStringType && $typeToRemove->getValue() === '') { return \PHPStan\Type\TypeCombinator::intersect($this, new AccessoryNonEmptyStringType()); } if ($typeToRemove instanceof AccessoryNonEmptyStringType) { return new ConstantStringType(''); } return null; } public function getFiniteTypes() : array { return []; } public function exponentiate(\PHPStan\Type\Type $exponent) : \PHPStan\Type\Type { return \PHPStan\Type\ExponentiateHelper::exponentiate($this, $exponent); } public function toPhpDocNode() : TypeNode { return new IdentifierTypeNode('string'); } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : \PHPStan\Type\Type { return new self(); } } <?php declare (strict_types=1); namespace PHPStan\Type; use PhpParser\Node\Expr\MethodCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\MethodReflection; /** * This is the interface dynamic return type extensions implement for non-static methods. * * To register it in the configuration file use the `phpstan.broker.dynamicMethodReturnTypeExtension` service tag: * * ``` * services: * - * class: App\PHPStan\MyExtension * tags: * - phpstan.broker.dynamicMethodReturnTypeExtension * ``` * * Learn more: https://phpstan.org/developing-extensions/dynamic-return-type-extensions * * @api */ interface DynamicMethodReturnTypeExtension { public function getClass() : string; public function isMethodSupported(MethodReflection $methodReflection) : bool; public function getTypeFromMethodCall(MethodReflection $methodReflection, MethodCall $methodCall, Scope $scope) : ?\PHPStan\Type\Type; } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\Php\PhpVersion; use PHPStan\PhpDocParser\Ast\Type\GenericTypeNode; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\IntersectionTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\Reflection\ClassMemberAccessAnswerer; use PHPStan\Reflection\ConstantReflection; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\InitializerExprTypeResolver; use PHPStan\Reflection\PropertyReflection; use PHPStan\Reflection\TrivialParametersAcceptor; use PHPStan\Reflection\Type\IntersectionTypeUnresolvedMethodPrototypeReflection; use PHPStan\Reflection\Type\IntersectionTypeUnresolvedPropertyPrototypeReflection; use PHPStan\Reflection\Type\UnresolvedMethodPrototypeReflection; use PHPStan\Reflection\Type\UnresolvedPropertyPrototypeReflection; use PHPStan\ShouldNotHappenException; use PHPStan\TrinaryLogic; use PHPStan\Type\Accessory\AccessoryArrayListType; use PHPStan\Type\Accessory\AccessoryLiteralStringType; use PHPStan\Type\Accessory\AccessoryLowercaseStringType; use PHPStan\Type\Accessory\AccessoryNonEmptyStringType; use PHPStan\Type\Accessory\AccessoryNonFalsyStringType; use PHPStan\Type\Accessory\AccessoryNumericStringType; use PHPStan\Type\Accessory\AccessoryType; use PHPStan\Type\Accessory\AccessoryUppercaseStringType; use PHPStan\Type\Accessory\NonEmptyArrayType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\Generic\TemplateType; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\Generic\TemplateTypeVariance; use PHPStan\Type\Traits\NonGeneralizableTypeTrait; use PHPStan\Type\Traits\NonRemoveableTypeTrait; use function array_intersect_key; use function array_map; use function array_shift; use function array_unique; use function array_values; use function count; use function implode; use function in_array; use function ksort; use function md5; use function sprintf; use function str_starts_with; use function strlen; use function substr; /** @api */ class IntersectionType implements \PHPStan\Type\CompoundType { /** * @var Type[] */ private $types; use NonRemoveableTypeTrait; use NonGeneralizableTypeTrait; /** * @var bool */ private $sortedTypes = \false; /** * @api * @param Type[] $types */ public function __construct(array $types) { $this->types = $types; if (count($types) < 2) { throw new ShouldNotHappenException(sprintf('Cannot create %s with: %s', self::class, implode(', ', array_map(static function (\PHPStan\Type\Type $type) : string { return $type->describe(\PHPStan\Type\VerbosityLevel::value()); }, $types)))); } } /** * @return Type[] */ public function getTypes() : array { return $this->types; } /** * @return Type[] */ private function getSortedTypes() : array { if ($this->sortedTypes) { return $this->types; } $this->types = \PHPStan\Type\UnionTypeHelper::sortTypes($this->types); $this->sortedTypes = \true; return $this->types; } public function inferTemplateTypesOn(\PHPStan\Type\Type $templateType) : TemplateTypeMap { $types = TemplateTypeMap::createEmpty(); foreach ($this->types as $type) { $types = $types->intersect($templateType->inferTemplateTypes($type)); } return $types; } public function getReferencedClasses() : array { $classes = []; foreach ($this->types as $type) { foreach ($type->getReferencedClasses() as $className) { $classes[] = $className; } } return $classes; } public function getObjectClassNames() : array { $objectClassNames = []; foreach ($this->types as $type) { $innerObjectClassNames = $type->getObjectClassNames(); foreach ($innerObjectClassNames as $innerObjectClassName) { $objectClassNames[] = $innerObjectClassName; } } return array_values(array_unique($objectClassNames)); } public function getObjectClassReflections() : array { $reflections = []; foreach ($this->types as $type) { foreach ($type->getObjectClassReflections() as $reflection) { $reflections[] = $reflection; } } return $reflections; } public function getArrays() : array { $arrays = []; foreach ($this->types as $type) { foreach ($type->getArrays() as $array) { $arrays[] = $array; } } return $arrays; } public function getConstantArrays() : array { $constantArrays = []; foreach ($this->types as $type) { foreach ($type->getConstantArrays() as $constantArray) { $constantArrays[] = $constantArray; } } return $constantArrays; } public function getConstantStrings() : array { $strings = []; foreach ($this->types as $type) { foreach ($type->getConstantStrings() as $string) { $strings[] = $string; } } return $strings; } public function accepts(\PHPStan\Type\Type $type, bool $strictTypes) : TrinaryLogic { return $this->acceptsWithReason($type, $strictTypes)->result; } public function acceptsWithReason(\PHPStan\Type\Type $otherType, bool $strictTypes) : \PHPStan\Type\AcceptsResult { $result = \PHPStan\Type\AcceptsResult::createYes(); foreach ($this->types as $type) { $result = $result->and($type->acceptsWithReason($otherType, $strictTypes)); } if (!$result->yes()) { $isList = $otherType->isList(); $reasons = $result->reasons; $verbosity = \PHPStan\Type\VerbosityLevel::getRecommendedLevelByType($this, $otherType); if ($this->isList()->yes() && !$isList->yes()) { $reasons[] = sprintf('%s %s a list.', $otherType->describe($verbosity), $isList->no() ? 'is not' : 'might not be'); } $isNonEmpty = $otherType->isIterableAtLeastOnce(); if ($this->isIterableAtLeastOnce()->yes() && !$isNonEmpty->yes()) { $reasons[] = sprintf('%s %s empty.', $otherType->describe($verbosity), $isNonEmpty->no() ? 'is' : 'might be'); } if (count($reasons) > 0) { return new \PHPStan\Type\AcceptsResult($result->result, $reasons); } } return $result; } public function isSuperTypeOf(\PHPStan\Type\Type $otherType) : TrinaryLogic { return $this->isSuperTypeOfWithReason($otherType)->result; } public function isSuperTypeOfWithReason(\PHPStan\Type\Type $otherType) : \PHPStan\Type\IsSuperTypeOfResult { if ($otherType instanceof \PHPStan\Type\IntersectionType && $this->equals($otherType)) { return \PHPStan\Type\IsSuperTypeOfResult::createYes(); } if ($otherType instanceof \PHPStan\Type\NeverType) { return \PHPStan\Type\IsSuperTypeOfResult::createYes(); } return \PHPStan\Type\IsSuperTypeOfResult::createYes()->and(...array_map(static function (\PHPStan\Type\Type $innerType) use($otherType) { return $innerType->isSuperTypeOfWithReason($otherType); }, $this->types)); } public function isSubTypeOf(\PHPStan\Type\Type $otherType) : TrinaryLogic { return $this->isSubTypeOfWithReason($otherType)->result; } public function isSubTypeOfWithReason(\PHPStan\Type\Type $otherType) : \PHPStan\Type\IsSuperTypeOfResult { if (($otherType instanceof self || $otherType instanceof \PHPStan\Type\UnionType) && !$otherType instanceof TemplateType) { return $otherType->isSuperTypeOfWithReason($this); } $result = \PHPStan\Type\IsSuperTypeOfResult::maxMin(...array_map(static function (\PHPStan\Type\Type $innerType) use($otherType) { return $otherType->isSuperTypeOfWithReason($innerType); }, $this->types)); if ($this->isOversizedArray()->yes()) { if (!$result->no()) { return \PHPStan\Type\IsSuperTypeOfResult::createYes(); } } return $result; } public function isAcceptedBy(\PHPStan\Type\Type $acceptingType, bool $strictTypes) : TrinaryLogic { return $this->isAcceptedWithReasonBy($acceptingType, $strictTypes)->result; } public function isAcceptedWithReasonBy(\PHPStan\Type\Type $acceptingType, bool $strictTypes) : \PHPStan\Type\AcceptsResult { $result = \PHPStan\Type\AcceptsResult::maxMin(...array_map(static function (\PHPStan\Type\Type $innerType) use($acceptingType, $strictTypes) { return $acceptingType->acceptsWithReason($innerType, $strictTypes); }, $this->types)); if ($this->isOversizedArray()->yes()) { if (!$result->no()) { return \PHPStan\Type\AcceptsResult::createYes(); } } return $result; } public function equals(\PHPStan\Type\Type $type) : bool { if (!$type instanceof static) { return \false; } if (count($this->types) !== count($type->types)) { return \false; } $otherTypes = $type->types; foreach ($this->types as $innerType) { $match = \false; foreach ($otherTypes as $i => $otherType) { if (!$innerType->equals($otherType)) { continue; } $match = \true; unset($otherTypes[$i]); break; } if (!$match) { return \false; } } return count($otherTypes) === 0; } public function describe(\PHPStan\Type\VerbosityLevel $level) : string { return $level->handle(function () use($level) : string { $typeNames = []; foreach ($this->getSortedTypes() as $type) { if ($type instanceof AccessoryType) { continue; } $typeNames[] = $type->generalize(\PHPStan\Type\GeneralizePrecision::lessSpecific())->describe($level); } return implode('&', $typeNames); }, function () use($level) : string { return $this->describeItself($level, \true); }, function () use($level) : string { return $this->describeItself($level, \false); }); } private function describeItself(\PHPStan\Type\VerbosityLevel $level, bool $skipAccessoryTypes) : string { $baseTypes = []; $typesToDescribe = []; $skipTypeNames = []; $nonEmptyStr = \false; $nonFalsyStr = \false; foreach ($this->getSortedTypes() as $i => $type) { if ($type instanceof AccessoryNonEmptyStringType || $type instanceof AccessoryLiteralStringType || $type instanceof AccessoryNumericStringType || $type instanceof AccessoryNonFalsyStringType || $type instanceof AccessoryLowercaseStringType || $type instanceof AccessoryUppercaseStringType) { if (($type instanceof AccessoryLowercaseStringType || $type instanceof AccessoryUppercaseStringType) && !$level->isPrecise()) { continue; } if ($type instanceof AccessoryNonFalsyStringType) { $nonFalsyStr = \true; } if ($type instanceof AccessoryNonEmptyStringType) { $nonEmptyStr = \true; } if ($nonEmptyStr && $nonFalsyStr) { // prevent redundant 'non-empty-string&non-falsy-string' foreach ($typesToDescribe as $key => $typeToDescribe) { if (!$typeToDescribe instanceof AccessoryNonEmptyStringType) { continue; } unset($typesToDescribe[$key]); } } $typesToDescribe[$i] = $type; $skipTypeNames[] = 'string'; continue; } if ($type instanceof NonEmptyArrayType || $type instanceof AccessoryArrayListType) { $typesToDescribe[$i] = $type; $skipTypeNames[] = 'array'; continue; } if ($type instanceof \PHPStan\Type\CallableType && $type->isCommonCallable()) { $typesToDescribe[$i] = $type; $skipTypeNames[] = 'object'; $skipTypeNames[] = 'string'; continue; } if (!$type instanceof AccessoryType) { $baseTypes[$i] = $type; continue; } if ($skipAccessoryTypes) { continue; } $typesToDescribe[$i] = $type; } $describedTypes = []; foreach ($baseTypes as $i => $type) { $typeDescription = $type->describe($level); if (in_array($typeDescription, ['object', 'string'], \true) && in_array($typeDescription, $skipTypeNames, \true)) { foreach ($typesToDescribe as $j => $typeToDescribe) { if ($typeToDescribe instanceof \PHPStan\Type\CallableType && $typeToDescribe->isCommonCallable()) { $describedTypes[$i] = 'callable-' . $typeDescription; unset($typesToDescribe[$j]); continue 2; } } } if (str_starts_with($typeDescription, 'array<') && in_array('array', $skipTypeNames, \true)) { $nonEmpty = \false; $typeName = 'array'; foreach ($typesToDescribe as $j => $typeToDescribe) { if ($typeToDescribe instanceof AccessoryArrayListType && substr($typeDescription, 0, strlen('array<int<0, max>, ')) === 'array<int<0, max>, ') { $typeName = 'list'; $typeDescription = 'array<' . substr($typeDescription, strlen('array<int<0, max>, ')); } elseif ($typeToDescribe instanceof NonEmptyArrayType) { $nonEmpty = \true; } else { continue; } unset($typesToDescribe[$j]); } if ($nonEmpty) { $typeName = 'non-empty-' . $typeName; } $describedTypes[$i] = $typeName . '<' . substr($typeDescription, strlen('array<')); continue; } if (in_array($typeDescription, $skipTypeNames, \true)) { continue; } $describedTypes[$i] = $type->describe($level); } foreach ($typesToDescribe as $i => $typeToDescribe) { $describedTypes[$i] = $typeToDescribe->describe($level); } ksort($describedTypes); return implode('&', $describedTypes); } public function getTemplateType(string $ancestorClassName, string $templateTypeName) : \PHPStan\Type\Type { return $this->intersectTypes(static function (\PHPStan\Type\Type $type) use($ancestorClassName, $templateTypeName) : \PHPStan\Type\Type { return $type->getTemplateType($ancestorClassName, $templateTypeName); }); } public function isObject() : TrinaryLogic { return $this->intersectResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isObject(); }); } public function isEnum() : TrinaryLogic { return $this->intersectResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isEnum(); }); } public function canAccessProperties() : TrinaryLogic { return $this->intersectResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->canAccessProperties(); }); } public function hasProperty(string $propertyName) : TrinaryLogic { return $this->intersectResults(static function (\PHPStan\Type\Type $type) use($propertyName) : TrinaryLogic { return $type->hasProperty($propertyName); }); } public function getProperty(string $propertyName, ClassMemberAccessAnswerer $scope) : PropertyReflection { return $this->getUnresolvedPropertyPrototype($propertyName, $scope)->getTransformedProperty(); } public function getUnresolvedPropertyPrototype(string $propertyName, ClassMemberAccessAnswerer $scope) : UnresolvedPropertyPrototypeReflection { $propertyPrototypes = []; foreach ($this->types as $type) { if (!$type->hasProperty($propertyName)->yes()) { continue; } $propertyPrototypes[] = $type->getUnresolvedPropertyPrototype($propertyName, $scope)->withFechedOnType($this); } $propertiesCount = count($propertyPrototypes); if ($propertiesCount === 0) { throw new ShouldNotHappenException(); } if ($propertiesCount === 1) { return $propertyPrototypes[0]; } return new IntersectionTypeUnresolvedPropertyPrototypeReflection($propertyName, $propertyPrototypes); } public function canCallMethods() : TrinaryLogic { return $this->intersectResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->canCallMethods(); }); } public function hasMethod(string $methodName) : TrinaryLogic { return $this->intersectResults(static function (\PHPStan\Type\Type $type) use($methodName) : TrinaryLogic { return $type->hasMethod($methodName); }); } public function getMethod(string $methodName, ClassMemberAccessAnswerer $scope) : ExtendedMethodReflection { return $this->getUnresolvedMethodPrototype($methodName, $scope)->getTransformedMethod(); } public function getUnresolvedMethodPrototype(string $methodName, ClassMemberAccessAnswerer $scope) : UnresolvedMethodPrototypeReflection { $methodPrototypes = []; foreach ($this->types as $type) { if (!$type->hasMethod($methodName)->yes()) { continue; } $methodPrototypes[] = $type->getUnresolvedMethodPrototype($methodName, $scope)->withCalledOnType($this); } $methodsCount = count($methodPrototypes); if ($methodsCount === 0) { throw new ShouldNotHappenException(); } if ($methodsCount === 1) { return $methodPrototypes[0]; } return new IntersectionTypeUnresolvedMethodPrototypeReflection($methodName, $methodPrototypes); } public function canAccessConstants() : TrinaryLogic { return $this->intersectResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->canAccessConstants(); }); } public function hasConstant(string $constantName) : TrinaryLogic { return $this->intersectResults(static function (\PHPStan\Type\Type $type) use($constantName) : TrinaryLogic { return $type->hasConstant($constantName); }); } public function getConstant(string $constantName) : ConstantReflection { foreach ($this->types as $type) { if ($type->hasConstant($constantName)->yes()) { return $type->getConstant($constantName); } } throw new ShouldNotHappenException(); } public function isIterable() : TrinaryLogic { return $this->intersectResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isIterable(); }); } public function isIterableAtLeastOnce() : TrinaryLogic { return $this->intersectResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isIterableAtLeastOnce(); }); } public function getArraySize() : \PHPStan\Type\Type { return $this->intersectTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->getArraySize(); }); } public function getIterableKeyType() : \PHPStan\Type\Type { return $this->intersectTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->getIterableKeyType(); }); } public function getFirstIterableKeyType() : \PHPStan\Type\Type { return $this->intersectTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->getFirstIterableKeyType(); }); } public function getLastIterableKeyType() : \PHPStan\Type\Type { return $this->intersectTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->getLastIterableKeyType(); }); } public function getIterableValueType() : \PHPStan\Type\Type { return $this->intersectTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->getIterableValueType(); }); } public function getFirstIterableValueType() : \PHPStan\Type\Type { return $this->intersectTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->getFirstIterableValueType(); }); } public function getLastIterableValueType() : \PHPStan\Type\Type { return $this->intersectTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->getLastIterableValueType(); }); } public function isArray() : TrinaryLogic { return $this->intersectResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isArray(); }); } public function isConstantArray() : TrinaryLogic { return $this->intersectResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isConstantArray(); }); } public function isOversizedArray() : TrinaryLogic { return $this->intersectResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isOversizedArray(); }); } public function isList() : TrinaryLogic { return $this->intersectResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isList(); }); } public function isString() : TrinaryLogic { return $this->intersectResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isString(); }); } public function isNumericString() : TrinaryLogic { return $this->intersectResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isNumericString(); }); } public function isNonEmptyString() : TrinaryLogic { return $this->intersectResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isNonEmptyString(); }); } public function isNonFalsyString() : TrinaryLogic { return $this->intersectResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isNonFalsyString(); }); } public function isLiteralString() : TrinaryLogic { return $this->intersectResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isLiteralString(); }); } public function isLowercaseString() : TrinaryLogic { return $this->intersectResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isLowercaseString(); }); } public function isUppercaseString() : TrinaryLogic { return $this->intersectResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isUppercaseString(); }); } public function isClassStringType() : TrinaryLogic { return $this->intersectResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isClassStringType(); }); } public function getClassStringObjectType() : \PHPStan\Type\Type { return $this->intersectTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->getClassStringObjectType(); }); } public function getObjectTypeOrClassStringObjectType() : \PHPStan\Type\Type { return $this->intersectTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->getObjectTypeOrClassStringObjectType(); }); } public function isVoid() : TrinaryLogic { return $this->intersectResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isVoid(); }); } public function isScalar() : TrinaryLogic { return $this->intersectResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isScalar(); }); } public function looseCompare(\PHPStan\Type\Type $type, PhpVersion $phpVersion) : \PHPStan\Type\BooleanType { return new \PHPStan\Type\BooleanType(); } public function isOffsetAccessible() : TrinaryLogic { return $this->intersectResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isOffsetAccessible(); }); } public function isOffsetAccessLegal() : TrinaryLogic { return $this->intersectResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isOffsetAccessLegal(); }); } public function hasOffsetValueType(\PHPStan\Type\Type $offsetType) : TrinaryLogic { if ($this->isList()->yes() && $this->isIterableAtLeastOnce()->yes()) { $arrayKeyOffsetType = $offsetType->toArrayKey(); if ((new ConstantIntegerType(0))->isSuperTypeOf($arrayKeyOffsetType)->yes()) { return TrinaryLogic::createYes(); } } return $this->intersectResults(static function (\PHPStan\Type\Type $type) use($offsetType) : TrinaryLogic { return $type->hasOffsetValueType($offsetType); }); } public function getOffsetValueType(\PHPStan\Type\Type $offsetType) : \PHPStan\Type\Type { $result = $this->intersectTypes(static function (\PHPStan\Type\Type $type) use($offsetType) : \PHPStan\Type\Type { return $type->getOffsetValueType($offsetType); }); if ($this->isOversizedArray()->yes()) { return \PHPStan\Type\TypeUtils::toBenevolentUnion($result); } return $result; } public function setOffsetValueType(?\PHPStan\Type\Type $offsetType, \PHPStan\Type\Type $valueType, bool $unionValues = \true) : \PHPStan\Type\Type { if ($this->isOversizedArray()->yes()) { return $this->intersectTypes(static function (\PHPStan\Type\Type $type) use($offsetType, $valueType, $unionValues) : \PHPStan\Type\Type { // avoid new HasOffsetValueType being intersected with oversized array if (!$type instanceof \PHPStan\Type\ArrayType) { return $type->setOffsetValueType($offsetType, $valueType, $unionValues); } if (!$offsetType instanceof ConstantStringType && !$offsetType instanceof ConstantIntegerType) { return $type->setOffsetValueType($offsetType, $valueType, $unionValues); } if (!$offsetType->isSuperTypeOf($type->getKeyType())->yes()) { return $type->setOffsetValueType($offsetType, $valueType, $unionValues); } return \PHPStan\Type\TypeCombinator::intersect(new \PHPStan\Type\ArrayType(\PHPStan\Type\TypeCombinator::union($type->getKeyType(), $offsetType), \PHPStan\Type\TypeCombinator::union($type->getItemType(), $valueType)), new NonEmptyArrayType()); }); } $result = $this->intersectTypes(static function (\PHPStan\Type\Type $type) use($offsetType, $valueType, $unionValues) : \PHPStan\Type\Type { return $type->setOffsetValueType($offsetType, $valueType, $unionValues); }); if ($offsetType !== null && $this->isList()->yes() && $this->isIterableAtLeastOnce()->yes() && (new ConstantIntegerType(1))->isSuperTypeOf($offsetType)->yes()) { $result = AccessoryArrayListType::intersectWith($result); } return $result; } public function setExistingOffsetValueType(\PHPStan\Type\Type $offsetType, \PHPStan\Type\Type $valueType) : \PHPStan\Type\Type { return $this->intersectTypes(static function (\PHPStan\Type\Type $type) use($offsetType, $valueType) : \PHPStan\Type\Type { return $type->setExistingOffsetValueType($offsetType, $valueType); }); } public function unsetOffset(\PHPStan\Type\Type $offsetType) : \PHPStan\Type\Type { return $this->intersectTypes(static function (\PHPStan\Type\Type $type) use($offsetType) : \PHPStan\Type\Type { return $type->unsetOffset($offsetType); }); } public function getKeysArray() : \PHPStan\Type\Type { return $this->intersectTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->getKeysArray(); }); } public function getValuesArray() : \PHPStan\Type\Type { return $this->intersectTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->getValuesArray(); }); } public function chunkArray(\PHPStan\Type\Type $lengthType, TrinaryLogic $preserveKeys) : \PHPStan\Type\Type { return $this->intersectTypes(static function (\PHPStan\Type\Type $type) use($lengthType, $preserveKeys) : \PHPStan\Type\Type { return $type->chunkArray($lengthType, $preserveKeys); }); } public function fillKeysArray(\PHPStan\Type\Type $valueType) : \PHPStan\Type\Type { return $this->intersectTypes(static function (\PHPStan\Type\Type $type) use($valueType) : \PHPStan\Type\Type { return $type->fillKeysArray($valueType); }); } public function flipArray() : \PHPStan\Type\Type { return $this->intersectTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->flipArray(); }); } public function intersectKeyArray(\PHPStan\Type\Type $otherArraysType) : \PHPStan\Type\Type { return $this->intersectTypes(static function (\PHPStan\Type\Type $type) use($otherArraysType) : \PHPStan\Type\Type { return $type->intersectKeyArray($otherArraysType); }); } public function popArray() : \PHPStan\Type\Type { return $this->intersectTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->popArray(); }); } public function reverseArray(TrinaryLogic $preserveKeys) : \PHPStan\Type\Type { return $this->intersectTypes(static function (\PHPStan\Type\Type $type) use($preserveKeys) : \PHPStan\Type\Type { return $type->reverseArray($preserveKeys); }); } public function searchArray(\PHPStan\Type\Type $needleType) : \PHPStan\Type\Type { return $this->intersectTypes(static function (\PHPStan\Type\Type $type) use($needleType) : \PHPStan\Type\Type { return $type->searchArray($needleType); }); } public function shiftArray() : \PHPStan\Type\Type { return $this->intersectTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->shiftArray(); }); } public function shuffleArray() : \PHPStan\Type\Type { return $this->intersectTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->shuffleArray(); }); } public function sliceArray(\PHPStan\Type\Type $offsetType, \PHPStan\Type\Type $lengthType, TrinaryLogic $preserveKeys) : \PHPStan\Type\Type { return $this->intersectTypes(static function (\PHPStan\Type\Type $type) use($offsetType, $lengthType, $preserveKeys) : \PHPStan\Type\Type { return $type->sliceArray($offsetType, $lengthType, $preserveKeys); }); } public function getEnumCases() : array { $compare = []; foreach ($this->types as $type) { $oneType = []; foreach ($type->getEnumCases() as $enumCase) { $oneType[$enumCase->getClassName() . '::' . $enumCase->getEnumCaseName()] = $enumCase; } $compare[] = $oneType; } return array_values(array_intersect_key(...$compare)); } public function isCallable() : TrinaryLogic { return $this->intersectResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isCallable(); }); } public function getCallableParametersAcceptors(ClassMemberAccessAnswerer $scope) : array { if ($this->isCallable()->no()) { throw new ShouldNotHappenException(); } return [new TrivialParametersAcceptor()]; } public function isCloneable() : TrinaryLogic { return $this->intersectResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isCloneable(); }); } public function isSmallerThan(\PHPStan\Type\Type $otherType) : TrinaryLogic { return $this->intersectResults(static function (\PHPStan\Type\Type $type) use($otherType) : TrinaryLogic { return $type->isSmallerThan($otherType); }); } public function isSmallerThanOrEqual(\PHPStan\Type\Type $otherType) : TrinaryLogic { return $this->intersectResults(static function (\PHPStan\Type\Type $type) use($otherType) : TrinaryLogic { return $type->isSmallerThanOrEqual($otherType); }); } public function isNull() : TrinaryLogic { return $this->intersectResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isNull(); }); } public function isConstantValue() : TrinaryLogic { return $this->intersectResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isConstantValue(); }); } public function isConstantScalarValue() : TrinaryLogic { return $this->intersectResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isConstantScalarValue(); }); } public function getConstantScalarTypes() : array { $scalarTypes = []; foreach ($this->types as $type) { foreach ($type->getConstantScalarTypes() as $scalarType) { $scalarTypes[] = $scalarType; } } return $scalarTypes; } public function getConstantScalarValues() : array { $values = []; foreach ($this->types as $type) { foreach ($type->getConstantScalarValues() as $value) { $values[] = $value; } } return $values; } public function isTrue() : TrinaryLogic { return $this->intersectResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isTrue(); }); } public function isFalse() : TrinaryLogic { return $this->intersectResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isFalse(); }); } public function isBoolean() : TrinaryLogic { return $this->intersectResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isBoolean(); }); } public function isFloat() : TrinaryLogic { return $this->intersectResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isFloat(); }); } public function isInteger() : TrinaryLogic { return $this->intersectResults(static function (\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isInteger(); }); } public function isGreaterThan(\PHPStan\Type\Type $otherType) : TrinaryLogic { return $this->intersectResults(static function (\PHPStan\Type\Type $type) use($otherType) : TrinaryLogic { return $otherType->isSmallerThan($type); }); } public function isGreaterThanOrEqual(\PHPStan\Type\Type $otherType) : TrinaryLogic { return $this->intersectResults(static function (\PHPStan\Type\Type $type) use($otherType) : TrinaryLogic { return $otherType->isSmallerThanOrEqual($type); }); } public function getSmallerType() : \PHPStan\Type\Type { return $this->intersectTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->getSmallerType(); }); } public function getSmallerOrEqualType() : \PHPStan\Type\Type { return $this->intersectTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->getSmallerOrEqualType(); }); } public function getGreaterType() : \PHPStan\Type\Type { return $this->intersectTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->getGreaterType(); }); } public function getGreaterOrEqualType() : \PHPStan\Type\Type { return $this->intersectTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->getGreaterOrEqualType(); }); } public function toBoolean() : \PHPStan\Type\BooleanType { $type = $this->intersectTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\BooleanType { return $type->toBoolean(); }); if (!$type instanceof \PHPStan\Type\BooleanType) { return new \PHPStan\Type\BooleanType(); } return $type; } public function toNumber() : \PHPStan\Type\Type { $type = $this->intersectTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->toNumber(); }); return $type; } public function toAbsoluteNumber() : \PHPStan\Type\Type { $type = $this->intersectTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->toAbsoluteNumber(); }); return $type; } public function toString() : \PHPStan\Type\Type { $type = $this->intersectTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->toString(); }); return $type; } public function toInteger() : \PHPStan\Type\Type { $type = $this->intersectTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->toInteger(); }); return $type; } public function toFloat() : \PHPStan\Type\Type { $type = $this->intersectTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->toFloat(); }); return $type; } public function toArray() : \PHPStan\Type\Type { $type = $this->intersectTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->toArray(); }); return $type; } public function toArrayKey() : \PHPStan\Type\Type { if ($this->isNumericString()->yes()) { return new \PHPStan\Type\IntegerType(); } if ($this->isString()->yes()) { return $this; } return $this->intersectTypes(static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type->toArrayKey(); }); } public function inferTemplateTypes(\PHPStan\Type\Type $receivedType) : TemplateTypeMap { $types = TemplateTypeMap::createEmpty(); foreach ($this->types as $type) { $types = $types->intersect($type->inferTemplateTypes($receivedType)); } return $types; } public function getReferencedTemplateTypes(TemplateTypeVariance $positionVariance) : array { $references = []; foreach ($this->types as $type) { foreach ($type->getReferencedTemplateTypes($positionVariance) as $reference) { $references[] = $reference; } } return $references; } public function traverse(callable $cb) : \PHPStan\Type\Type { $types = []; $changed = \false; foreach ($this->types as $type) { $newType = $cb($type); if ($type !== $newType) { $changed = \true; } $types[] = $newType; } if ($changed) { return \PHPStan\Type\TypeCombinator::intersect(...$types); } return $this; } public function traverseSimultaneously(\PHPStan\Type\Type $right, callable $cb) : \PHPStan\Type\Type { $types = []; $changed = \false; if (!$right instanceof self) { return $this; } if (count($this->getTypes()) !== count($right->getTypes())) { return $this; } foreach ($this->getSortedTypes() as $i => $leftType) { $rightType = $right->getSortedTypes()[$i]; $newType = $cb($leftType, $rightType); if ($leftType !== $newType) { $changed = \true; } $types[] = $newType; } if ($changed) { return \PHPStan\Type\TypeCombinator::intersect(...$types); } return $this; } public function tryRemove(\PHPStan\Type\Type $typeToRemove) : ?\PHPStan\Type\Type { return $this->intersectTypes(static function (\PHPStan\Type\Type $type) use($typeToRemove) : \PHPStan\Type\Type { return \PHPStan\Type\TypeCombinator::remove($type, $typeToRemove); }); } public function exponentiate(\PHPStan\Type\Type $exponent) : \PHPStan\Type\Type { return $this->intersectTypes(static function (\PHPStan\Type\Type $type) use($exponent) : \PHPStan\Type\Type { return $type->exponentiate($exponent); }); } public function getFiniteTypes() : array { $compare = []; foreach ($this->types as $type) { $oneType = []; foreach ($type->getFiniteTypes() as $finiteType) { $oneType[md5($finiteType->describe(\PHPStan\Type\VerbosityLevel::typeOnly()))] = $finiteType; } $compare[] = $oneType; } $result = array_values(array_intersect_key(...$compare)); if (count($result) > InitializerExprTypeResolver::CALCULATE_SCALARS_LIMIT) { return []; } return $result; } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : \PHPStan\Type\Type { return new self($properties['types']); } /** * @param callable(Type $type): TrinaryLogic $getResult */ private function intersectResults(callable $getResult) : TrinaryLogic { return TrinaryLogic::lazyMaxMin($this->types, $getResult); } /** * @param callable(Type $type): Type $getType */ private function intersectTypes(callable $getType) : \PHPStan\Type\Type { $operands = array_map($getType, $this->types); return \PHPStan\Type\TypeCombinator::intersect(...$operands); } public function toPhpDocNode() : TypeNode { $baseTypes = []; $typesToDescribe = []; $skipTypeNames = []; $nonEmptyStr = \false; $nonFalsyStr = \false; foreach ($this->getSortedTypes() as $i => $type) { if ($type instanceof AccessoryNonEmptyStringType || $type instanceof AccessoryLiteralStringType || $type instanceof AccessoryNumericStringType || $type instanceof AccessoryNonFalsyStringType || $type instanceof AccessoryLowercaseStringType || $type instanceof AccessoryUppercaseStringType) { if ($type instanceof AccessoryNonFalsyStringType) { $nonFalsyStr = \true; } if ($type instanceof AccessoryNonEmptyStringType) { $nonEmptyStr = \true; } if ($nonEmptyStr && $nonFalsyStr) { // prevent redundant 'non-empty-string&non-falsy-string' foreach ($typesToDescribe as $key => $typeToDescribe) { if (!$typeToDescribe instanceof AccessoryNonEmptyStringType) { continue; } unset($typesToDescribe[$key]); } } $typesToDescribe[$i] = $type; $skipTypeNames[] = 'string'; continue; } if ($type instanceof NonEmptyArrayType || $type instanceof AccessoryArrayListType) { $typesToDescribe[$i] = $type; $skipTypeNames[] = 'array'; continue; } if (!$type instanceof AccessoryType) { $baseTypes[$i] = $type; continue; } $accessoryPhpDocNode = $type->toPhpDocNode(); if ($accessoryPhpDocNode instanceof IdentifierTypeNode && $accessoryPhpDocNode->name === '') { continue; } $typesToDescribe[$i] = $type; } $describedTypes = []; foreach ($baseTypes as $i => $type) { $typeNode = $type->toPhpDocNode(); if ($typeNode instanceof GenericTypeNode && $typeNode->type->name === 'array') { $nonEmpty = \false; $typeName = 'array'; foreach ($typesToDescribe as $j => $typeToDescribe) { if ($typeToDescribe instanceof AccessoryArrayListType) { $typeName = 'list'; if (count($typeNode->genericTypes) > 1) { array_shift($typeNode->genericTypes); } } elseif ($typeToDescribe instanceof NonEmptyArrayType) { $nonEmpty = \true; } else { continue; } unset($typesToDescribe[$j]); } if ($nonEmpty) { $typeName = 'non-empty-' . $typeName; } $describedTypes[$i] = new GenericTypeNode(new IdentifierTypeNode($typeName), $typeNode->genericTypes); continue; } if ($typeNode instanceof IdentifierTypeNode && in_array($typeNode->name, $skipTypeNames, \true)) { continue; } $describedTypes[$i] = $typeNode; } foreach ($typesToDescribe as $i => $typeToDescribe) { $describedTypes[$i] = $typeToDescribe->toPhpDocNode(); } ksort($describedTypes); $describedTypes = array_values($describedTypes); if (count($describedTypes) === 1) { return $describedTypes[0]; } return new IntersectionTypeNode($describedTypes); } } <?php declare (strict_types=1); namespace PHPStan\Type; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\ParameterReflection; /** * This is the interface dynamic parameter out type extensions implement for functions. * * To register it in the configuration file use the `phpstan.functionParameterOutTypeExtension` service tag: * * ``` * services: * - * class: App\PHPStan\MyExtension * tags: * - phpstan.functionParameterOutTypeExtension * ``` * * @api */ interface FunctionParameterOutTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection, ParameterReflection $parameter) : bool; public function getParameterOutTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $funcCall, ParameterReflection $parameter, Scope $scope) : ?\PHPStan\Type\Type; } <?php declare (strict_types=1); namespace PHPStan\Type\Constant; use _PHPStan_7d8742a37\Nette\Utils\RegexpException; use _PHPStan_7d8742a37\Nette\Utils\Strings; use PhpParser\Node\Name; use PHPStan\Analyser\OutOfClassScope; use PHPStan\DependencyInjection\BleedingEdgeToggle; use PHPStan\PhpDocParser\Ast\ConstExpr\QuoteAwareConstExprStringNode; use PHPStan\PhpDocParser\Ast\Type\ConstTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\Reflection\Callables\FunctionCallableVariant; use PHPStan\Reflection\ClassMemberAccessAnswerer; use PHPStan\Reflection\ConstantReflection; use PHPStan\Reflection\InaccessibleMethod; use PHPStan\Reflection\PhpVersionStaticAccessor; use PHPStan\Reflection\ReflectionProviderStaticAccessor; use PHPStan\Reflection\TrivialParametersAcceptor; use PHPStan\ShouldNotHappenException; use PHPStan\TrinaryLogic; use PHPStan\Type\Accessory\AccessoryLiteralStringType; use PHPStan\Type\Accessory\AccessoryLowercaseStringType; use PHPStan\Type\Accessory\AccessoryNonEmptyStringType; use PHPStan\Type\Accessory\AccessoryNonFalsyStringType; use PHPStan\Type\Accessory\AccessoryNumericStringType; use PHPStan\Type\Accessory\AccessoryUppercaseStringType; use PHPStan\Type\ClassStringType; use PHPStan\Type\CompoundType; use PHPStan\Type\ConstantScalarType; use PHPStan\Type\ErrorType; use PHPStan\Type\GeneralizePrecision; use PHPStan\Type\Generic\GenericClassStringType; use PHPStan\Type\Generic\TemplateType; use PHPStan\Type\IntegerRangeType; use PHPStan\Type\IntersectionType; use PHPStan\Type\IsSuperTypeOfResult; use PHPStan\Type\MixedType; use PHPStan\Type\NullType; use PHPStan\Type\ObjectType; use PHPStan\Type\StaticType; use PHPStan\Type\StringType; use PHPStan\Type\Traits\ConstantScalarTypeTrait; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\VerbosityLevel; use function addcslashes; use function in_array; use function is_float; use function is_int; use function is_numeric; use function key; use function strlen; use function strtolower; use function strtoupper; use function substr; use function substr_count; /** @api */ class ConstantStringType extends StringType implements ConstantScalarType { /** * @var string */ private $value; /** * @var bool */ private $isClassString; private const DESCRIBE_LIMIT = 20; use ConstantScalarTypeTrait; use \PHPStan\Type\Constant\ConstantScalarToBooleanTrait; /** * @var ?ObjectType */ private $objectType = null; /** * @var ?Type */ private $arrayKeyType = null; /** @api */ public function __construct(string $value, bool $isClassString = \false) { $this->value = $value; $this->isClassString = $isClassString; parent::__construct(); } public function getValue() : string { return $this->value; } public function getConstantStrings() : array { return [$this]; } public function isClassStringType() : TrinaryLogic { if ($this->isClassString) { return TrinaryLogic::createYes(); } $reflectionProvider = ReflectionProviderStaticAccessor::getInstance(); return TrinaryLogic::createFromBoolean($reflectionProvider->hasClass($this->value)); } public function getClassStringObjectType() : Type { if ($this->isClassStringType()->yes()) { return new ObjectType($this->value); } return new ErrorType(); } public function getObjectTypeOrClassStringObjectType() : Type { return $this->getClassStringObjectType(); } /** * @deprecated use isClassStringType() instead */ public function isClassString() : bool { return $this->isClassStringType()->yes(); } public function describe(VerbosityLevel $level) : string { return $level->handle(static function () : string { return 'string'; }, function () : string { $value = $this->value; if (!$this->isClassString) { try { $value = Strings::truncate($value, self::DESCRIBE_LIMIT); } catch (RegexpException $e) { $value = substr($value, 0, self::DESCRIBE_LIMIT) . "…"; } } return self::export($value); }, function () : string { return self::export($this->value); }); } private function export(string $value) : string { $escapedValue = addcslashes($value, "\x00..\x1f"); if ($escapedValue !== $value) { return '"' . addcslashes($value, "\x00..\x1f\\\"") . '"'; } return "'" . addcslashes($value, '\\\'') . "'"; } public function isSuperTypeOf(Type $type) : TrinaryLogic { return $this->isSuperTypeOfWithReason($type)->result; } public function isSuperTypeOfWithReason(Type $type) : IsSuperTypeOfResult { if ($type instanceof GenericClassStringType) { $genericType = $type->getGenericType(); if ($genericType instanceof MixedType) { return IsSuperTypeOfResult::createMaybe(); } if ($genericType instanceof StaticType) { $genericType = $genericType->getStaticObjectType(); } // We are transforming constant class-string to ObjectType. But we need to filter out // an uncertainty originating in possible ObjectType's class subtypes. $objectType = $this->getObjectType(); // Do not use TemplateType's isSuperTypeOf handling directly because it takes ObjectType // uncertainty into account. if ($genericType instanceof TemplateType) { $isSuperType = $genericType->getBound()->isSuperTypeOfWithReason($objectType); } else { $isSuperType = $genericType->isSuperTypeOfWithReason($objectType); } // Explicitly handle the uncertainty for Yes & Maybe. if ($isSuperType->yes()) { return IsSuperTypeOfResult::createMaybe(); } return IsSuperTypeOfResult::createNo(); } if ($type instanceof ClassStringType) { return $this->isClassStringType()->yes() ? IsSuperTypeOfResult::createMaybe() : IsSuperTypeOfResult::createNo(); } if ($type instanceof self) { return $this->value === $type->value ? IsSuperTypeOfResult::createYes() : IsSuperTypeOfResult::createNo(); } if ($type instanceof parent) { return IsSuperTypeOfResult::createMaybe(); } if ($type instanceof CompoundType) { return $type->isSubTypeOfWithReason($this); } return IsSuperTypeOfResult::createNo(); } public function isCallable() : TrinaryLogic { if ($this->value === '') { return TrinaryLogic::createNo(); } $reflectionProvider = ReflectionProviderStaticAccessor::getInstance(); // 'my_function' if ($reflectionProvider->hasFunction(new Name($this->value), null)) { return TrinaryLogic::createYes(); } // 'MyClass::myStaticFunction' $matches = Strings::match($this->value, '#^([a-zA-Z_\\x7f-\\xff\\\\][a-zA-Z0-9_\\x7f-\\xff\\\\]*)::([a-zA-Z_\\x7f-\\xff][a-zA-Z0-9_\\x7f-\\xff]*)\\z#'); if ($matches !== null) { if (!$reflectionProvider->hasClass($matches[1])) { return TrinaryLogic::createMaybe(); } $phpVersion = PhpVersionStaticAccessor::getInstance(); $classRef = $reflectionProvider->getClass($matches[1]); if ($classRef->hasMethod($matches[2])) { $method = $classRef->getMethod($matches[2], new OutOfClassScope()); if (BleedingEdgeToggle::isBleedingEdge() && !$phpVersion->supportsCallableInstanceMethods() && !$method->isStatic()) { return TrinaryLogic::createNo(); } return TrinaryLogic::createYes(); } if (!$classRef->getNativeReflection()->isFinal()) { return TrinaryLogic::createMaybe(); } return TrinaryLogic::createNo(); } return TrinaryLogic::createNo(); } public function getCallableParametersAcceptors(ClassMemberAccessAnswerer $scope) : array { if ($this->value === '') { return []; } $reflectionProvider = ReflectionProviderStaticAccessor::getInstance(); // 'my_function' $functionName = new Name($this->value); if ($reflectionProvider->hasFunction($functionName, null)) { $function = $reflectionProvider->getFunction($functionName, null); return FunctionCallableVariant::createFromVariants($function, $function->getVariants()); } // 'MyClass::myStaticFunction' $matches = Strings::match($this->value, '#^([a-zA-Z_\\x7f-\\xff\\\\][a-zA-Z0-9_\\x7f-\\xff\\\\]*)::([a-zA-Z_\\x7f-\\xff][a-zA-Z0-9_\\x7f-\\xff]*)\\z#'); if ($matches !== null) { if (!$reflectionProvider->hasClass($matches[1])) { return [new TrivialParametersAcceptor()]; } $classReflection = $reflectionProvider->getClass($matches[1]); if ($classReflection->hasMethod($matches[2])) { $method = $classReflection->getMethod($matches[2], $scope); if (!$scope->canCallMethod($method)) { return [new InaccessibleMethod($method)]; } return FunctionCallableVariant::createFromVariants($method, $method->getVariants()); } if (!$classReflection->getNativeReflection()->isFinal()) { return [new TrivialParametersAcceptor()]; } } throw new ShouldNotHappenException(); } public function toNumber() : Type { if (is_numeric($this->value)) { $value = $this->value; $value = +$value; if (is_float($value)) { return new \PHPStan\Type\Constant\ConstantFloatType($value); } return new \PHPStan\Type\Constant\ConstantIntegerType($value); } return new ErrorType(); } public function toAbsoluteNumber() : Type { return $this->toNumber()->toAbsoluteNumber(); } public function toInteger() : Type { return new \PHPStan\Type\Constant\ConstantIntegerType((int) $this->value); } public function toFloat() : Type { return new \PHPStan\Type\Constant\ConstantFloatType((float) $this->value); } public function toArrayKey() : Type { if ($this->arrayKeyType !== null) { return $this->arrayKeyType; } /** @var int|string $offsetValue */ $offsetValue = key([$this->value => null]); return $this->arrayKeyType = is_int($offsetValue) ? new \PHPStan\Type\Constant\ConstantIntegerType($offsetValue) : new \PHPStan\Type\Constant\ConstantStringType($offsetValue); } public function isString() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isNumericString() : TrinaryLogic { return TrinaryLogic::createFromBoolean(is_numeric($this->getValue())); } public function isNonEmptyString() : TrinaryLogic { return TrinaryLogic::createFromBoolean($this->getValue() !== ''); } public function isNonFalsyString() : TrinaryLogic { return TrinaryLogic::createFromBoolean(!in_array($this->getValue(), ['', '0'], \true)); } public function isLiteralString() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isLowercaseString() : TrinaryLogic { return TrinaryLogic::createFromBoolean(strtolower($this->value) === $this->value); } public function isUppercaseString() : TrinaryLogic { return TrinaryLogic::createFromBoolean(strtoupper($this->value) === $this->value); } public function hasOffsetValueType(Type $offsetType) : TrinaryLogic { if ($offsetType->isInteger()->yes()) { $strlen = strlen($this->value); $strLenType = IntegerRangeType::fromInterval(-$strlen, $strlen - 1); return $strLenType->isSuperTypeOf($offsetType); } return parent::hasOffsetValueType($offsetType); } public function getOffsetValueType(Type $offsetType) : Type { if ($offsetType->isInteger()->yes()) { $strlen = strlen($this->value); $strLenType = IntegerRangeType::fromInterval(-$strlen, $strlen - 1); if ($offsetType instanceof \PHPStan\Type\Constant\ConstantIntegerType) { if ($strLenType->isSuperTypeOf($offsetType)->yes()) { return new self($this->value[$offsetType->getValue()]); } return new ErrorType(); } $intersected = TypeCombinator::intersect($strLenType, $offsetType); if ($intersected instanceof IntegerRangeType) { $finiteTypes = $intersected->getFiniteTypes(); if ($finiteTypes === []) { return parent::getOffsetValueType($offsetType); } $chars = []; foreach ($finiteTypes as $constantInteger) { $chars[] = new self($this->value[$constantInteger->getValue()]); } if (!$strLenType->isSuperTypeOf($offsetType)->yes()) { $chars[] = new self(''); } return TypeCombinator::union(...$chars); } } return parent::getOffsetValueType($offsetType); } public function setOffsetValueType(?Type $offsetType, Type $valueType, bool $unionValues = \true) : Type { $valueStringType = $valueType->toString(); if ($valueStringType instanceof ErrorType) { return new ErrorType(); } if ($offsetType instanceof \PHPStan\Type\Constant\ConstantIntegerType && $valueStringType instanceof \PHPStan\Type\Constant\ConstantStringType) { $value = $this->value; $offsetValue = $offsetType->getValue(); if ($offsetValue < 0) { return new ErrorType(); } $stringValue = $valueStringType->getValue(); if (strlen($stringValue) !== 1) { return new ErrorType(); } $value[$offsetValue] = $stringValue; return new self($value); } return parent::setOffsetValueType($offsetType, $valueType); } public function setExistingOffsetValueType(Type $offsetType, Type $valueType) : Type { return parent::setOffsetValueType($offsetType, $valueType); } public function append(self $otherString) : self { return new self($this->getValue() . $otherString->getValue()); } public function generalize(GeneralizePrecision $precision) : Type { if ($this->isClassString) { if ($precision->isMoreSpecific()) { return new ClassStringType(); } return new StringType(); } if ($this->getValue() !== '' && $precision->isMoreSpecific()) { $accessories = [new StringType(), new AccessoryLiteralStringType()]; if (is_numeric($this->getValue())) { $accessories[] = new AccessoryNumericStringType(); } if ($this->getValue() !== '0') { $accessories[] = new AccessoryNonFalsyStringType(); } else { $accessories[] = new AccessoryNonEmptyStringType(); } if (strtolower($this->getValue()) === $this->getValue()) { $accessories[] = new AccessoryLowercaseStringType(); } if (strtoupper($this->getValue()) === $this->getValue()) { $accessories[] = new AccessoryUppercaseStringType(); } return new IntersectionType($accessories); } if ($precision->isMoreSpecific()) { return new IntersectionType([new StringType(), new AccessoryLiteralStringType()]); } return new StringType(); } public function getSmallerType() : Type { $subtractedTypes = [new \PHPStan\Type\Constant\ConstantBooleanType(\true), IntegerRangeType::createAllGreaterThanOrEqualTo((float) $this->value)]; if ($this->value === '') { $subtractedTypes[] = new NullType(); $subtractedTypes[] = new StringType(); } if (!(bool) $this->value) { $subtractedTypes[] = new \PHPStan\Type\Constant\ConstantBooleanType(\false); } return TypeCombinator::remove(new MixedType(), TypeCombinator::union(...$subtractedTypes)); } public function getSmallerOrEqualType() : Type { $subtractedTypes = [IntegerRangeType::createAllGreaterThan((float) $this->value)]; if (!(bool) $this->value) { $subtractedTypes[] = new \PHPStan\Type\Constant\ConstantBooleanType(\true); } return TypeCombinator::remove(new MixedType(), TypeCombinator::union(...$subtractedTypes)); } public function getGreaterType() : Type { $subtractedTypes = [new \PHPStan\Type\Constant\ConstantBooleanType(\false), IntegerRangeType::createAllSmallerThanOrEqualTo((float) $this->value)]; if ((bool) $this->value) { $subtractedTypes[] = new \PHPStan\Type\Constant\ConstantBooleanType(\true); } return TypeCombinator::remove(new MixedType(), TypeCombinator::union(...$subtractedTypes)); } public function getGreaterOrEqualType() : Type { $subtractedTypes = [IntegerRangeType::createAllSmallerThan((float) $this->value)]; if ((bool) $this->value) { $subtractedTypes[] = new \PHPStan\Type\Constant\ConstantBooleanType(\false); } return TypeCombinator::remove(new MixedType(), TypeCombinator::union(...$subtractedTypes)); } public function canAccessConstants() : TrinaryLogic { return $this->isClassStringType(); } public function hasConstant(string $constantName) : TrinaryLogic { return $this->getObjectType()->hasConstant($constantName); } public function getConstant(string $constantName) : ConstantReflection { return $this->getObjectType()->getConstant($constantName); } private function getObjectType() : ObjectType { return $this->objectType = $this->objectType ?? new ObjectType($this->value); } public function toPhpDocNode() : TypeNode { if (substr_count($this->value, "\n") > 0) { return $this->generalize(GeneralizePrecision::moreSpecific())->toPhpDocNode(); } return new ConstTypeNode(new QuoteAwareConstExprStringNode($this->value, QuoteAwareConstExprStringNode::SINGLE_QUOTED)); } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : Type { return new self($properties['value'], $properties['isClassString'] ?? \false); } } <?php declare (strict_types=1); namespace PHPStan\Type\Constant; use PhpParser\Node\Expr; use PhpParser\Node\Expr\Array_; use PHPStan\Node\Expr\TypeExpr; use PHPStan\ShouldNotHappenException; use PHPStan\Type\Accessory\AccessoryArrayListType; use PHPStan\Type\Accessory\NonEmptyArrayType; use PHPStan\Type\Accessory\OversizedArrayType; use PHPStan\Type\ArrayType; use PHPStan\Type\GeneralizePrecision; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\VerbosityLevel; use function array_splice; use function array_values; use function count; final class OversizedArrayBuilder { /** * @param callable(Expr): Type $getTypeCallback */ public function build(Array_ $expr, callable $getTypeCallback) : Type { $isList = \true; $valueTypes = []; $keyTypes = []; $nextAutoIndex = 0; $items = $expr->items; for ($i = 0; $i < count($items); $i++) { $item = $items[$i]; if ($item === null) { continue; } if (!$item->unpack) { continue; } $valueType = $getTypeCallback($item->value); if ($valueType instanceof \PHPStan\Type\Constant\ConstantArrayType) { array_splice($items, $i, 1); foreach ($valueType->getKeyTypes() as $j => $innerKeyType) { $innerValueType = $valueType->getValueTypes()[$j]; if ($innerKeyType->isString()->no()) { $keyExpr = null; } else { $keyExpr = new TypeExpr($innerKeyType); } array_splice($items, $i++, 0, [new Expr\ArrayItem(new TypeExpr($innerValueType), $keyExpr)]); } } else { array_splice($items, $i, 1, [new Expr\ArrayItem(new TypeExpr($valueType->getIterableValueType()), new TypeExpr($valueType->getIterableKeyType()))]); } } foreach ($items as $item) { if ($item === null) { continue; } if ($item->unpack) { throw new ShouldNotHappenException(); } if ($item->key !== null) { $itemKeyType = $getTypeCallback($item->key); if (!$itemKeyType instanceof \PHPStan\Type\Constant\ConstantIntegerType) { $isList = \false; } elseif ($itemKeyType->getValue() !== $nextAutoIndex) { $isList = \false; $nextAutoIndex = $itemKeyType->getValue() + 1; } else { $nextAutoIndex++; } } else { $itemKeyType = new \PHPStan\Type\Constant\ConstantIntegerType($nextAutoIndex); $nextAutoIndex++; } $generalizedKeyType = $itemKeyType->generalize(GeneralizePrecision::moreSpecific()); $keyTypes[$generalizedKeyType->describe(VerbosityLevel::precise())] = $generalizedKeyType; $itemValueType = $getTypeCallback($item->value); $generalizedValueType = $itemValueType->generalize(GeneralizePrecision::moreSpecific()); $valueTypes[$generalizedValueType->describe(VerbosityLevel::precise())] = $generalizedValueType; } $keyType = TypeCombinator::union(...array_values($keyTypes)); $valueType = TypeCombinator::union(...array_values($valueTypes)); $arrayType = new ArrayType($keyType, $valueType); if ($isList) { $arrayType = AccessoryArrayListType::intersectWith($arrayType); } return TypeCombinator::intersect($arrayType, new NonEmptyArrayType(), new OversizedArrayType()); } } <?php declare (strict_types=1); namespace PHPStan\Type\Constant; use PHPStan\Php\PhpVersion; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\TrinaryLogic; use PHPStan\Type\BooleanType; use PHPStan\Type\ConstantScalarType; use PHPStan\Type\GeneralizePrecision; use PHPStan\Type\MixedType; use PHPStan\Type\NeverType; use PHPStan\Type\StaticTypeFactory; use PHPStan\Type\Traits\ConstantScalarTypeTrait; use PHPStan\Type\Type; use PHPStan\Type\VerbosityLevel; /** @api */ class ConstantBooleanType extends BooleanType implements ConstantScalarType { /** * @var bool */ private $value; use ConstantScalarTypeTrait { looseCompare as private scalarLooseCompare; } /** @api */ public function __construct(bool $value) { $this->value = $value; parent::__construct(); } public function getValue() : bool { return $this->value; } public function describe(VerbosityLevel $level) : string { return $this->value ? 'true' : 'false'; } public function getSmallerType() : Type { if ($this->value) { return StaticTypeFactory::falsey(); } return new NeverType(); } public function getSmallerOrEqualType() : Type { if ($this->value) { return new MixedType(); } return StaticTypeFactory::falsey(); } public function getGreaterType() : Type { if ($this->value) { return new NeverType(); } return StaticTypeFactory::truthy(); } public function getGreaterOrEqualType() : Type { if ($this->value) { return StaticTypeFactory::truthy(); } return new MixedType(); } public function toBoolean() : BooleanType { return $this; } public function toNumber() : Type { return new \PHPStan\Type\Constant\ConstantIntegerType((int) $this->value); } public function toAbsoluteNumber() : Type { return $this->toNumber()->toAbsoluteNumber(); } public function toString() : Type { return new \PHPStan\Type\Constant\ConstantStringType((string) $this->value); } public function toInteger() : Type { return new \PHPStan\Type\Constant\ConstantIntegerType((int) $this->value); } public function toFloat() : Type { return new \PHPStan\Type\Constant\ConstantFloatType((float) $this->value); } public function toArrayKey() : Type { return new \PHPStan\Type\Constant\ConstantIntegerType((int) $this->value); } public function isTrue() : TrinaryLogic { return TrinaryLogic::createFromBoolean($this->value === \true); } public function isFalse() : TrinaryLogic { return TrinaryLogic::createFromBoolean($this->value === \false); } public function generalize(GeneralizePrecision $precision) : Type { return new BooleanType(); } public function toPhpDocNode() : TypeNode { return new IdentifierTypeNode($this->value ? 'true' : 'false'); } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : Type { return new self($properties['value']); } public function looseCompare(Type $type, PhpVersion $phpVersion) : BooleanType { if ($type->isObject()->yes()) { return $this; } return $this->scalarLooseCompare($type, $phpVersion); } } <?php declare (strict_types=1); namespace PHPStan\Type\Constant; use PHPStan\ShouldNotHappenException; use PHPStan\TrinaryLogic; use PHPStan\Type\Accessory\AccessoryArrayListType; use PHPStan\Type\Accessory\NonEmptyArrayType; use PHPStan\Type\Accessory\OversizedArrayType; use PHPStan\Type\ArrayType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\TypeUtils; use function array_filter; use function array_map; use function array_unique; use function array_values; use function count; use function in_array; use function is_float; use function max; use function min; use function range; /** * @api * @final */ class ConstantArrayTypeBuilder { /** * @var array<int, Type> */ private $keyTypes; /** * @var array<int, Type> */ private $valueTypes; /** * @var non-empty-list<int> */ private $nextAutoIndexes; /** * @var array<int> */ private $optionalKeys; /** * @var TrinaryLogic */ private $isList; public const ARRAY_COUNT_LIMIT = 256; /** * @var bool */ private $degradeToGeneralArray = \false; /** * @var bool */ private $oversized = \false; /** * @param array<int, Type> $keyTypes * @param array<int, Type> $valueTypes * @param non-empty-list<int> $nextAutoIndexes * @param array<int> $optionalKeys */ private function __construct(array $keyTypes, array $valueTypes, array $nextAutoIndexes, array $optionalKeys, TrinaryLogic $isList) { $this->keyTypes = $keyTypes; $this->valueTypes = $valueTypes; $this->nextAutoIndexes = $nextAutoIndexes; $this->optionalKeys = $optionalKeys; $this->isList = $isList; } public static function createEmpty() : self { return new self([], [], [0], [], TrinaryLogic::createYes()); } public static function createFromConstantArray(\PHPStan\Type\Constant\ConstantArrayType $startArrayType) : self { $builder = new self($startArrayType->getKeyTypes(), $startArrayType->getValueTypes(), $startArrayType->getNextAutoIndexes(), $startArrayType->getOptionalKeys(), $startArrayType->isList()); if (count($startArrayType->getKeyTypes()) > self::ARRAY_COUNT_LIMIT) { $builder->degradeToGeneralArray(\true); } return $builder; } public function setOffsetValueType(?Type $offsetType, Type $valueType, bool $optional = \false) : void { if ($offsetType !== null) { $offsetType = $offsetType->toArrayKey(); } if (!$this->degradeToGeneralArray) { if ($offsetType === null) { $newAutoIndexes = $optional ? $this->nextAutoIndexes : []; $hasOptional = \false; foreach ($this->keyTypes as $i => $keyType) { if (!$keyType instanceof \PHPStan\Type\Constant\ConstantIntegerType) { continue; } if (!in_array($keyType->getValue(), $this->nextAutoIndexes, \true)) { continue; } $this->valueTypes[$i] = TypeCombinator::union($this->valueTypes[$i], $valueType); if (!$hasOptional && !$optional) { $this->optionalKeys = array_values(array_filter($this->optionalKeys, static function (int $index) use($i) : bool { return $index !== $i; })); } /** @var int|float $newAutoIndex */ $newAutoIndex = $keyType->getValue() + 1; if (is_float($newAutoIndex)) { $newAutoIndex = $keyType->getValue(); } $newAutoIndexes[] = $newAutoIndex; $hasOptional = \true; } $max = max($this->nextAutoIndexes); $this->keyTypes[] = new \PHPStan\Type\Constant\ConstantIntegerType($max); $this->valueTypes[] = $valueType; /** @var int|float $newAutoIndex */ $newAutoIndex = $max + 1; if (is_float($newAutoIndex)) { $newAutoIndex = $max; } $newAutoIndexes[] = $newAutoIndex; $this->nextAutoIndexes = array_values(array_unique($newAutoIndexes)); if ($optional || $hasOptional) { $this->optionalKeys[] = count($this->keyTypes) - 1; } if (count($this->keyTypes) > self::ARRAY_COUNT_LIMIT) { $this->degradeToGeneralArray = \true; $this->oversized = \true; } return; } if ($offsetType instanceof \PHPStan\Type\Constant\ConstantIntegerType || $offsetType instanceof \PHPStan\Type\Constant\ConstantStringType) { /** @var ConstantIntegerType|ConstantStringType $keyType */ foreach ($this->keyTypes as $i => $keyType) { if ($keyType->getValue() !== $offsetType->getValue()) { continue; } if ($optional) { $valueType = TypeCombinator::union($valueType, $this->valueTypes[$i]); } $this->valueTypes[$i] = $valueType; if (!$optional) { $this->optionalKeys = array_values(array_filter($this->optionalKeys, static function (int $index) use($i) : bool { return $index !== $i; })); if ($keyType instanceof \PHPStan\Type\Constant\ConstantIntegerType) { $nextAutoIndexes = array_values(array_filter($this->nextAutoIndexes, static function (int $index) use($keyType) { return $index > $keyType->getValue(); })); if (count($nextAutoIndexes) === 0) { throw new ShouldNotHappenException(); } $this->nextAutoIndexes = $nextAutoIndexes; } } return; } $this->keyTypes[] = $offsetType; $this->valueTypes[] = $valueType; if ($offsetType instanceof \PHPStan\Type\Constant\ConstantIntegerType) { $min = min($this->nextAutoIndexes); $max = max($this->nextAutoIndexes); if ($offsetType->getValue() > $min) { if ($offsetType->getValue() <= $max) { $this->isList = $this->isList->and(TrinaryLogic::createMaybe()); } else { $this->isList = TrinaryLogic::createNo(); } } if ($offsetType->getValue() >= $max) { /** @var int|float $newAutoIndex */ $newAutoIndex = $offsetType->getValue() + 1; if (is_float($newAutoIndex)) { $newAutoIndex = $max; } if (!$optional) { $this->nextAutoIndexes = [$newAutoIndex]; } else { $this->nextAutoIndexes[] = $newAutoIndex; } } } else { $this->isList = TrinaryLogic::createNo(); } if ($optional) { $this->optionalKeys[] = count($this->keyTypes) - 1; } if (count($this->keyTypes) > self::ARRAY_COUNT_LIMIT) { $this->degradeToGeneralArray = \true; $this->oversized = \true; } return; } $scalarTypes = $offsetType->getConstantScalarTypes(); if (count($scalarTypes) === 0) { $integerRanges = TypeUtils::getIntegerRanges($offsetType); if (count($integerRanges) > 0) { foreach ($integerRanges as $integerRange) { if ($integerRange->getMin() === null) { break; } if ($integerRange->getMax() === null) { break; } $rangeLength = $integerRange->getMax() - $integerRange->getMin(); if ($rangeLength >= self::ARRAY_COUNT_LIMIT) { $scalarTypes = []; break; } foreach (range($integerRange->getMin(), $integerRange->getMax()) as $rangeValue) { $scalarTypes[] = new \PHPStan\Type\Constant\ConstantIntegerType($rangeValue); } } } } if (count($scalarTypes) > 0 && count($scalarTypes) < self::ARRAY_COUNT_LIMIT) { $match = \true; $valueTypes = $this->valueTypes; foreach ($scalarTypes as $scalarType) { $scalarOffsetType = $scalarType->toArrayKey(); if (!$scalarOffsetType instanceof \PHPStan\Type\Constant\ConstantIntegerType && !$scalarOffsetType instanceof \PHPStan\Type\Constant\ConstantStringType) { throw new ShouldNotHappenException(); } $offsetMatch = \false; /** @var ConstantIntegerType|ConstantStringType $keyType */ foreach ($this->keyTypes as $i => $keyType) { if ($keyType->getValue() !== $scalarOffsetType->getValue()) { continue; } $valueTypes[$i] = TypeCombinator::union($valueTypes[$i], $valueType); $offsetMatch = \true; } if ($offsetMatch) { continue; } $match = \false; } if ($match) { $this->valueTypes = $valueTypes; return; } } $this->isList = TrinaryLogic::createNo(); } if ($offsetType === null) { $offsetType = TypeCombinator::union(...array_map(static function (int $index) { return new \PHPStan\Type\Constant\ConstantIntegerType($index); }, $this->nextAutoIndexes)); } else { $this->isList = TrinaryLogic::createNo(); } $this->keyTypes[] = $offsetType; $this->valueTypes[] = $valueType; if ($optional) { $this->optionalKeys[] = count($this->keyTypes) - 1; } $this->degradeToGeneralArray = \true; } public function degradeToGeneralArray(bool $oversized = \false) : void { $this->degradeToGeneralArray = \true; $this->oversized = $this->oversized || $oversized; } public function getArray() : Type { $keyTypesCount = count($this->keyTypes); if ($keyTypesCount === 0) { return new \PHPStan\Type\Constant\ConstantArrayType([], []); } if (!$this->degradeToGeneralArray) { /** @var array<int, ConstantIntegerType|ConstantStringType> $keyTypes */ $keyTypes = $this->keyTypes; return new \PHPStan\Type\Constant\ConstantArrayType($keyTypes, $this->valueTypes, $this->nextAutoIndexes, $this->optionalKeys, $this->isList); } $array = new ArrayType(TypeCombinator::union(...$this->keyTypes), TypeCombinator::union(...$this->valueTypes)); if (count($this->optionalKeys) < $keyTypesCount) { $array = TypeCombinator::intersect($array, new NonEmptyArrayType()); } if ($this->oversized) { $array = TypeCombinator::intersect($array, new OversizedArrayType()); } if ($this->isList->yes()) { $array = AccessoryArrayListType::intersectWith($array); } return $array; } public function isList() : bool { return $this->isList->yes(); } } <?php declare (strict_types=1); namespace PHPStan\Type\Constant; use PHPStan\ShouldNotHappenException; use PHPStan\TrinaryLogic; use PHPStan\Type\Type; /** * @api * @final */ class ConstantArrayTypeAndMethod { /** * @var ?Type */ private $type; /** * @var ?string */ private $method; /** * @var TrinaryLogic */ private $certainty; private function __construct(?Type $type, ?string $method, TrinaryLogic $certainty) { $this->type = $type; $this->method = $method; $this->certainty = $certainty; } public static function createConcrete(Type $type, string $method, TrinaryLogic $certainty) : self { if ($certainty->no()) { throw new ShouldNotHappenException(); } return new self($type, $method, $certainty); } public static function createUnknown() : self { return new self(null, null, TrinaryLogic::createMaybe()); } public function isUnknown() : bool { return $this->type === null; } public function getType() : Type { if ($this->type === null) { throw new ShouldNotHappenException(); } return $this->type; } public function getMethod() : string { if ($this->method === null) { throw new ShouldNotHappenException(); } return $this->method; } public function getCertainty() : TrinaryLogic { return $this->certainty; } } <?php declare (strict_types=1); namespace PHPStan\Type\Constant; use _PHPStan_7d8742a37\Nette\Utils\Strings; use PHPStan\Analyser\OutOfClassScope; use PHPStan\DependencyInjection\BleedingEdgeToggle; use PHPStan\Internal\CombinationsHelper; use PHPStan\Php\PhpVersion; use PHPStan\PhpDocParser\Ast\ConstExpr\ConstExprIntegerNode; use PHPStan\PhpDocParser\Ast\ConstExpr\ConstExprStringNode; use PHPStan\PhpDocParser\Ast\Type\ArrayShapeItemNode; use PHPStan\PhpDocParser\Ast\Type\ArrayShapeNode; use PHPStan\PhpDocParser\Ast\Type\ConstTypeNode; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\Reflection\Callables\FunctionCallableVariant; use PHPStan\Reflection\ClassMemberAccessAnswerer; use PHPStan\Reflection\InaccessibleMethod; use PHPStan\Reflection\InitializerExprTypeResolver; use PHPStan\Reflection\PhpVersionStaticAccessor; use PHPStan\Reflection\TrivialParametersAcceptor; use PHPStan\ShouldNotHappenException; use PHPStan\TrinaryLogic; use PHPStan\Type\AcceptsResult; use PHPStan\Type\Accessory\AccessoryArrayListType; use PHPStan\Type\Accessory\HasOffsetValueType; use PHPStan\Type\Accessory\NonEmptyArrayType; use PHPStan\Type\ArrayType; use PHPStan\Type\BooleanType; use PHPStan\Type\CompoundType; use PHPStan\Type\ConstantScalarType; use PHPStan\Type\ConstantType; use PHPStan\Type\ConstantTypeHelper; use PHPStan\Type\ErrorType; use PHPStan\Type\GeneralizePrecision; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\Generic\TemplateTypeVariance; use PHPStan\Type\IntegerRangeType; use PHPStan\Type\IntersectionType; use PHPStan\Type\IsSuperTypeOfResult; use PHPStan\Type\MixedType; use PHPStan\Type\NeverType; use PHPStan\Type\NullType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\UnionType; use PHPStan\Type\VerbosityLevel; use function array_keys; use function array_map; use function array_merge; use function array_pop; use function array_push; use function array_slice; use function array_unique; use function array_values; use function assert; use function count; use function implode; use function in_array; use function is_bool; use function is_int; use function is_string; use function min; use function pow; use function range; use function sort; use function sprintf; use function str_contains; /** * @api */ class ConstantArrayType extends ArrayType implements ConstantType { /** * @var array<int, ConstantIntegerType|ConstantStringType> */ private $keyTypes; /** * @var array<int, Type> */ private $valueTypes; /** * @var int[] */ private $optionalKeys; private const DESCRIBE_LIMIT = 8; private const CHUNK_FINITE_TYPES_LIMIT = 5; /** * @var TrinaryLogic */ private $isList; /** @var self[]|null */ private $allArrays = null; /** @var non-empty-list<int> */ private $nextAutoIndexes; /** * @api * @param array<int, ConstantIntegerType|ConstantStringType> $keyTypes * @param array<int, Type> $valueTypes * @param non-empty-list<int>|int $nextAutoIndexes * @param int[] $optionalKeys * @param bool|TrinaryLogic $isList */ public function __construct(array $keyTypes, array $valueTypes, $nextAutoIndexes = [0], array $optionalKeys = [], $isList = \false) { $this->keyTypes = $keyTypes; $this->valueTypes = $valueTypes; $this->optionalKeys = $optionalKeys; assert(count($keyTypes) === count($valueTypes)); if (is_int($nextAutoIndexes)) { $nextAutoIndexes = [$nextAutoIndexes]; } $this->nextAutoIndexes = $nextAutoIndexes; $keyTypesCount = count($this->keyTypes); if ($keyTypesCount === 0) { $keyType = new NeverType(\true); $isList = TrinaryLogic::createYes(); } elseif ($keyTypesCount === 1) { $keyType = $this->keyTypes[0]; } else { $keyType = new UnionType($this->keyTypes); } if (is_bool($isList)) { $isList = TrinaryLogic::createFromBoolean($isList); } $this->isList = $isList; parent::__construct($keyType, count($valueTypes) > 0 ? TypeCombinator::union(...$valueTypes) : new NeverType(\true)); } public function getConstantArrays() : array { return [$this]; } public function isConstantValue() : TrinaryLogic { return TrinaryLogic::createYes(); } /** @deprecated Use isIterableAtLeastOnce()->no() instead */ public function isEmpty() : bool { return count($this->keyTypes) === 0; } /** * @return non-empty-list<int> */ public function getNextAutoIndexes() : array { return $this->nextAutoIndexes; } /** * @deprecated */ public function getNextAutoIndex() : int { return $this->nextAutoIndexes[count($this->nextAutoIndexes) - 1]; } /** * @return int[] */ public function getOptionalKeys() : array { return $this->optionalKeys; } /** * @return self[] */ public function getAllArrays() : array { if ($this->allArrays !== null) { return $this->allArrays; } if (count($this->optionalKeys) <= 10) { $optionalKeysCombinations = $this->powerSet($this->optionalKeys); } else { $optionalKeysCombinations = [[], $this->optionalKeys]; } $requiredKeys = []; foreach (array_keys($this->keyTypes) as $i) { if (in_array($i, $this->optionalKeys, \true)) { continue; } $requiredKeys[] = $i; } $arrays = []; foreach ($optionalKeysCombinations as $combination) { $keys = array_merge($requiredKeys, $combination); sort($keys); if ($this->isList->yes() && array_keys($keys) !== $keys) { continue; } $builder = \PHPStan\Type\Constant\ConstantArrayTypeBuilder::createEmpty(); foreach ($keys as $i) { $builder->setOffsetValueType($this->keyTypes[$i], $this->valueTypes[$i]); } $array = $builder->getArray(); if (!$array instanceof \PHPStan\Type\Constant\ConstantArrayType) { throw new ShouldNotHappenException(); } $arrays[] = $array; } return $this->allArrays = $arrays; } /** * @template T * @param T[] $in * @return T[][] */ private function powerSet(array $in) : array { $count = count($in); $members = pow(2, $count); $return = []; for ($i = 0; $i < $members; $i++) { $b = sprintf('%0' . $count . 'b', $i); $out = []; for ($j = 0; $j < $count; $j++) { if ($b[$j] !== '1') { continue; } $out[] = $in[$j]; } $return[] = $out; } return $return; } /** * @return array<int, ConstantIntegerType|ConstantStringType> */ public function getKeyTypes() : array { return $this->keyTypes; } /** @deprecated Use getFirstIterableKeyType() instead */ public function getFirstKeyType() : Type { return $this->getFirstIterableKeyType(); } /** @deprecated Use getLastIterableKeyType() instead */ public function getLastKeyType() : Type { return $this->getLastIterableKeyType(); } /** * @return array<int, Type> */ public function getValueTypes() : array { return $this->valueTypes; } /** @deprecated Use getFirstIterableValueType() instead */ public function getFirstValueType() : Type { return $this->getFirstIterableValueType(); } /** @deprecated Use getLastIterableValueType() instead */ public function getLastValueType() : Type { return $this->getLastIterableValueType(); } public function isOptionalKey(int $i) : bool { return in_array($i, $this->optionalKeys, \true); } public function accepts(Type $type, bool $strictTypes) : TrinaryLogic { return $this->acceptsWithReason($type, $strictTypes)->result; } public function acceptsWithReason(Type $type, bool $strictTypes) : AcceptsResult { if ($type instanceof CompoundType && !$type instanceof IntersectionType) { return $type->isAcceptedWithReasonBy($this, $strictTypes); } if ($type instanceof self && count($this->keyTypes) === 0) { return AcceptsResult::createFromBoolean(count($type->keyTypes) === 0); } $result = AcceptsResult::createYes(); foreach ($this->keyTypes as $i => $keyType) { $valueType = $this->valueTypes[$i]; $hasOffsetValueType = $type->hasOffsetValueType($keyType); $hasOffset = new AcceptsResult($hasOffsetValueType, $hasOffsetValueType->yes() || !$type->isConstantArray()->yes() ? [] : [sprintf('Array %s have offset %s.', $hasOffsetValueType->no() ? 'does not' : 'might not', $keyType->describe(VerbosityLevel::value()))]); if ($hasOffset->no()) { if ($this->isOptionalKey($i)) { continue; } return $hasOffset; } if ($hasOffset->maybe() && $this->isOptionalKey($i)) { $hasOffset = AcceptsResult::createYes(); } $result = $result->and($hasOffset); $otherValueType = $type->getOffsetValueType($keyType); $verbosity = VerbosityLevel::getRecommendedLevelByType($valueType, $otherValueType); $acceptsValue = $valueType->acceptsWithReason($otherValueType, $strictTypes)->decorateReasons(static function (string $reason) use($keyType, $valueType, $verbosity, $otherValueType) { return sprintf('Offset %s (%s) does not accept type %s: %s', $keyType->describe(VerbosityLevel::precise()), $valueType->describe($verbosity), $otherValueType->describe($verbosity), $reason); }); if (!$acceptsValue->yes() && count($acceptsValue->reasons) === 0 && $type->isConstantArray()->yes()) { $acceptsValue = new AcceptsResult($acceptsValue->result, [sprintf('Offset %s (%s) does not accept type %s.', $keyType->describe(VerbosityLevel::precise()), $valueType->describe($verbosity), $otherValueType->describe($verbosity))]); } if ($acceptsValue->no()) { return $acceptsValue; } $result = $result->and($acceptsValue); } $result = $result->and(new AcceptsResult($type->isArray(), [])); if ($type->isOversizedArray()->yes()) { if (!$result->no()) { return AcceptsResult::createYes(); } } return $result; } public function isSuperTypeOf(Type $type) : TrinaryLogic { return $this->isSuperTypeOfWithReason($type)->result; } public function isSuperTypeOfWithReason(Type $type) : IsSuperTypeOfResult { if ($type instanceof self) { if (count($this->keyTypes) === 0) { return new IsSuperTypeOfResult($type->isIterableAtLeastOnce()->negate(), []); } $results = []; foreach ($this->keyTypes as $i => $keyType) { $hasOffset = $type->hasOffsetValueType($keyType); if ($hasOffset->no()) { if (!$this->isOptionalKey($i)) { return IsSuperTypeOfResult::createNo(); } $results[] = IsSuperTypeOfResult::createYes(); continue; } elseif ($hasOffset->maybe() && !$this->isOptionalKey($i)) { $results[] = IsSuperTypeOfResult::createMaybe(); } $isValueSuperType = $this->valueTypes[$i]->isSuperTypeOfWithReason($type->getOffsetValueType($keyType)); if ($isValueSuperType->no()) { return $isValueSuperType->decorateReasons(static function (string $reason) use($keyType) { return sprintf('Offset %s: %s', $keyType->describe(VerbosityLevel::value()), $reason); }); } $results[] = $isValueSuperType; } return IsSuperTypeOfResult::createYes()->and(...$results); } if ($type instanceof ArrayType) { $result = IsSuperTypeOfResult::createMaybe(); if (count($this->keyTypes) === 0) { return $result; } $isKeySuperType = $this->getKeyType()->isSuperTypeOfWithReason($type->getKeyType()); if ($isKeySuperType->no()) { return $isKeySuperType; } return $result->and($isKeySuperType, $this->getItemType()->isSuperTypeOfWithReason($type->getItemType())); } if ($type instanceof CompoundType) { return $type->isSubTypeOfWithReason($this); } return IsSuperTypeOfResult::createNo(); } public function looseCompare(Type $type, PhpVersion $phpVersion) : BooleanType { if ($this->isIterableAtLeastOnce()->no() && count($type->getConstantScalarValues()) === 1) { // @phpstan-ignore equal.invalid, equal.notAllowed return new \PHPStan\Type\Constant\ConstantBooleanType($type->getConstantScalarValues()[0] == []); // phpcs:ignore } return new BooleanType(); } public function equals(Type $type) : bool { if (!$type instanceof self) { return \false; } if (count($this->keyTypes) !== count($type->keyTypes)) { return \false; } foreach ($this->keyTypes as $i => $keyType) { $valueType = $this->valueTypes[$i]; if (!$valueType->equals($type->valueTypes[$i])) { return \false; } if (!$keyType->equals($type->keyTypes[$i])) { return \false; } } if ($this->optionalKeys !== $type->optionalKeys) { return \false; } return \true; } public function isCallable() : TrinaryLogic { $typeAndMethods = $this->findTypeAndMethodNames(); if ($typeAndMethods === []) { return TrinaryLogic::createNo(); } $results = array_map(static function (\PHPStan\Type\Constant\ConstantArrayTypeAndMethod $typeAndMethod) : TrinaryLogic { return $typeAndMethod->getCertainty(); }, $typeAndMethods); return TrinaryLogic::createYes()->and(...$results); } public function getCallableParametersAcceptors(ClassMemberAccessAnswerer $scope) : array { $typeAndMethodNames = $this->findTypeAndMethodNames(); if ($typeAndMethodNames === []) { throw new ShouldNotHappenException(); } $acceptors = []; foreach ($typeAndMethodNames as $typeAndMethodName) { if ($typeAndMethodName->isUnknown() || !$typeAndMethodName->getCertainty()->yes()) { $acceptors[] = new TrivialParametersAcceptor(); continue; } $method = $typeAndMethodName->getType()->getMethod($typeAndMethodName->getMethod(), $scope); if (!$scope->canCallMethod($method)) { $acceptors[] = new InaccessibleMethod($method); continue; } array_push($acceptors, ...FunctionCallableVariant::createFromVariants($method, $method->getVariants())); } return $acceptors; } /** * @return array{Type, Type}|array{} */ private function getClassOrObjectAndMethods() : array { if (count($this->keyTypes) !== 2) { return []; } $classOrObject = null; $method = null; foreach ($this->keyTypes as $i => $keyType) { if ($keyType->isSuperTypeOf(new \PHPStan\Type\Constant\ConstantIntegerType(0))->yes()) { $classOrObject = $this->valueTypes[$i]; continue; } if (!$keyType->isSuperTypeOf(new \PHPStan\Type\Constant\ConstantIntegerType(1))->yes()) { continue; } $method = $this->valueTypes[$i]; } if ($classOrObject === null || $method === null) { return []; } return [$classOrObject, $method]; } /** @deprecated Use findTypeAndMethodNames() instead */ public function findTypeAndMethodName() : ?\PHPStan\Type\Constant\ConstantArrayTypeAndMethod { $callableArray = $this->getClassOrObjectAndMethods(); if ($callableArray === []) { return null; } [$classOrObject, $method] = $callableArray; if (!$method instanceof \PHPStan\Type\Constant\ConstantStringType) { return \PHPStan\Type\Constant\ConstantArrayTypeAndMethod::createUnknown(); } $type = $classOrObject->getObjectTypeOrClassStringObjectType(); if (!$type->isObject()->yes()) { return \PHPStan\Type\Constant\ConstantArrayTypeAndMethod::createUnknown(); } $has = $type->hasMethod($method->getValue()); if (!$has->no()) { if ($this->isOptionalKey(0) || $this->isOptionalKey(1)) { $has = $has->and(TrinaryLogic::createMaybe()); } return \PHPStan\Type\Constant\ConstantArrayTypeAndMethod::createConcrete($type, $method->getValue(), $has); } return null; } /** @return ConstantArrayTypeAndMethod[] */ public function findTypeAndMethodNames() : array { $callableArray = $this->getClassOrObjectAndMethods(); if ($callableArray === []) { return []; } [$classOrObject, $methods] = $callableArray; if (count($methods->getConstantStrings()) === 0) { return [\PHPStan\Type\Constant\ConstantArrayTypeAndMethod::createUnknown()]; } $type = $classOrObject->getObjectTypeOrClassStringObjectType(); if (!$type->isObject()->yes()) { return [\PHPStan\Type\Constant\ConstantArrayTypeAndMethod::createUnknown()]; } $typeAndMethods = []; $phpVersion = PhpVersionStaticAccessor::getInstance(); foreach ($methods->getConstantStrings() as $method) { $has = $type->hasMethod($method->getValue()); if ($has->no()) { continue; } if (BleedingEdgeToggle::isBleedingEdge() && $has->yes() && !$phpVersion->supportsCallableInstanceMethods()) { $methodReflection = $type->getMethod($method->getValue(), new OutOfClassScope()); if ($classOrObject->isString()->yes() && !$methodReflection->isStatic()) { continue; } } if ($this->isOptionalKey(0) || $this->isOptionalKey(1)) { $has = $has->and(TrinaryLogic::createMaybe()); } $typeAndMethods[] = \PHPStan\Type\Constant\ConstantArrayTypeAndMethod::createConcrete($type, $method->getValue(), $has); } return $typeAndMethods; } public function hasOffsetValueType(Type $offsetType) : TrinaryLogic { $offsetType = $offsetType->toArrayKey(); if ($offsetType instanceof UnionType) { $results = []; foreach ($offsetType->getTypes() as $innerType) { $results[] = $this->hasOffsetValueType($innerType); } return TrinaryLogic::extremeIdentity(...$results); } if ($offsetType instanceof IntegerRangeType) { $finiteTypes = $offsetType->getFiniteTypes(); if ($finiteTypes !== []) { $results = []; foreach ($finiteTypes as $innerType) { $results[] = $this->hasOffsetValueType($innerType); } return TrinaryLogic::extremeIdentity(...$results); } } $result = TrinaryLogic::createNo(); foreach ($this->keyTypes as $i => $keyType) { if ($keyType instanceof \PHPStan\Type\Constant\ConstantIntegerType && !$offsetType->isString()->no() && $offsetType->isConstantScalarValue()->no()) { return TrinaryLogic::createMaybe(); } $has = $keyType->isSuperTypeOf($offsetType); if ($has->yes()) { if ($this->isOptionalKey($i)) { return TrinaryLogic::createMaybe(); } return TrinaryLogic::createYes(); } if (!$has->maybe()) { continue; } $result = TrinaryLogic::createMaybe(); } return $result; } public function getOffsetValueType(Type $offsetType) : Type { if (count($this->keyTypes) === 0) { return new ErrorType(); } $offsetType = $offsetType->toArrayKey(); $matchingValueTypes = []; $all = \true; $maybeAll = \true; foreach ($this->keyTypes as $i => $keyType) { if ($keyType->isSuperTypeOf($offsetType)->no()) { $all = \false; if ($keyType instanceof \PHPStan\Type\Constant\ConstantIntegerType && !$offsetType->isString()->no() && $offsetType->isConstantScalarValue()->no()) { continue; } $maybeAll = \false; continue; } $matchingValueTypes[] = $this->valueTypes[$i]; } if ($all) { return $this->getIterableValueType(); } if (count($matchingValueTypes) > 0) { $type = TypeCombinator::union(...$matchingValueTypes); if ($type instanceof ErrorType) { return new MixedType(); } return $type; } if ($maybeAll) { return $this->getIterableValueType(); } return new ErrorType(); // undefined offset } public function setOffsetValueType(?Type $offsetType, Type $valueType, bool $unionValues = \true) : Type { $builder = \PHPStan\Type\Constant\ConstantArrayTypeBuilder::createFromConstantArray($this); $builder->setOffsetValueType($offsetType, $valueType); return $builder->getArray(); } public function setExistingOffsetValueType(Type $offsetType, Type $valueType) : Type { $offsetType = $offsetType->toArrayKey(); $builder = \PHPStan\Type\Constant\ConstantArrayTypeBuilder::createFromConstantArray($this); foreach ($this->keyTypes as $keyType) { if ($offsetType->isSuperTypeOf($keyType)->no()) { continue; } $builder->setOffsetValueType($keyType, $valueType); } return $builder->getArray(); } public function unsetOffset(Type $offsetType) : Type { $offsetType = $offsetType->toArrayKey(); if ($offsetType instanceof \PHPStan\Type\Constant\ConstantIntegerType || $offsetType instanceof \PHPStan\Type\Constant\ConstantStringType) { foreach ($this->keyTypes as $i => $keyType) { if ($keyType->getValue() !== $offsetType->getValue()) { continue; } $keyTypes = $this->keyTypes; unset($keyTypes[$i]); $valueTypes = $this->valueTypes; unset($valueTypes[$i]); $newKeyTypes = []; $newValueTypes = []; $newOptionalKeys = []; $k = 0; foreach ($keyTypes as $j => $newKeyType) { $newKeyTypes[] = $newKeyType; $newValueTypes[] = $valueTypes[$j]; if (in_array($j, $this->optionalKeys, \true)) { $newOptionalKeys[] = $k; } $k++; } return new self($newKeyTypes, $newValueTypes, $this->nextAutoIndexes, $newOptionalKeys, TrinaryLogic::createNo()); } return $this; } $constantScalars = $offsetType->getConstantScalarTypes(); if (count($constantScalars) > 0) { $optionalKeys = $this->optionalKeys; foreach ($constantScalars as $constantScalar) { $constantScalar = $constantScalar->toArrayKey(); if (!$constantScalar instanceof \PHPStan\Type\Constant\ConstantIntegerType && !$constantScalar instanceof \PHPStan\Type\Constant\ConstantStringType) { continue; } foreach ($this->keyTypes as $i => $keyType) { if ($keyType->getValue() !== $constantScalar->getValue()) { continue; } if (in_array($i, $optionalKeys, \true)) { continue 2; } $optionalKeys[] = $i; } } return new self($this->keyTypes, $this->valueTypes, $this->nextAutoIndexes, $optionalKeys, TrinaryLogic::createNo()); } $optionalKeys = $this->optionalKeys; $isList = $this->isList; foreach ($this->keyTypes as $i => $keyType) { if (!$offsetType->isSuperTypeOf($keyType)->yes()) { continue; } $optionalKeys[] = $i; $isList = TrinaryLogic::createNo(); } $optionalKeys = array_values(array_unique($optionalKeys)); return new self($this->keyTypes, $this->valueTypes, $this->nextAutoIndexes, $optionalKeys, $isList); } public function chunkArray(Type $lengthType, TrinaryLogic $preserveKeys) : Type { $biggerOne = IntegerRangeType::fromInterval(1, null); $finiteTypes = $lengthType->getFiniteTypes(); if ($biggerOne->isSuperTypeOf($lengthType)->yes() && count($finiteTypes) < self::CHUNK_FINITE_TYPES_LIMIT) { $results = []; foreach ($finiteTypes as $finiteType) { if (!$finiteType instanceof \PHPStan\Type\Constant\ConstantIntegerType || $finiteType->getValue() < 1) { return parent::chunkArray($lengthType, $preserveKeys); } $length = $finiteType->getValue(); $builder = \PHPStan\Type\Constant\ConstantArrayTypeBuilder::createEmpty(); $keyTypesCount = count($this->keyTypes); for ($i = 0; $i < $keyTypesCount; $i += $length) { $chunk = $this->sliceArray(new \PHPStan\Type\Constant\ConstantIntegerType($i), new \PHPStan\Type\Constant\ConstantIntegerType($length), TrinaryLogic::createYes()); $builder->setOffsetValueType(null, $preserveKeys->yes() ? $chunk : $chunk->getValuesArray()); } $results[] = $builder->getArray(); } return TypeCombinator::union(...$results); } return parent::chunkArray($lengthType, $preserveKeys); } public function fillKeysArray(Type $valueType) : Type { $builder = \PHPStan\Type\Constant\ConstantArrayTypeBuilder::createEmpty(); foreach ($this->valueTypes as $i => $keyType) { if ($keyType->isInteger()->no()) { $stringKeyType = $keyType->toString(); if ($stringKeyType instanceof ErrorType) { return $stringKeyType; } $builder->setOffsetValueType($stringKeyType, $valueType, $this->isOptionalKey($i)); } else { $builder->setOffsetValueType($keyType, $valueType, $this->isOptionalKey($i)); } } return $builder->getArray(); } public function flipArray() : Type { $builder = \PHPStan\Type\Constant\ConstantArrayTypeBuilder::createEmpty(); foreach ($this->keyTypes as $i => $keyType) { $valueType = $this->valueTypes[$i]; $builder->setOffsetValueType($valueType->toArrayKey(), $keyType, $this->isOptionalKey($i)); } return $builder->getArray(); } public function intersectKeyArray(Type $otherArraysType) : Type { $builder = \PHPStan\Type\Constant\ConstantArrayTypeBuilder::createEmpty(); foreach ($this->keyTypes as $i => $keyType) { $valueType = $this->valueTypes[$i]; $has = $otherArraysType->hasOffsetValueType($keyType); if ($has->no()) { continue; } $builder->setOffsetValueType($keyType, $valueType, $this->isOptionalKey($i) || !$has->yes()); } return $builder->getArray(); } public function popArray() : Type { return $this->removeLastElements(1); } public function reverseArray(TrinaryLogic $preserveKeys) : Type { $builder = \PHPStan\Type\Constant\ConstantArrayTypeBuilder::createEmpty(); for ($i = count($this->keyTypes) - 1; $i >= 0; $i--) { $offsetType = $preserveKeys->yes() || $this->keyTypes[$i]->isInteger()->no() ? $this->keyTypes[$i] : null; $builder->setOffsetValueType($offsetType, $this->valueTypes[$i], $this->isOptionalKey($i)); } return $builder->getArray(); } public function searchArray(Type $needleType) : Type { $matches = []; $hasIdenticalValue = \false; foreach ($this->valueTypes as $index => $valueType) { $isNeedleSuperType = $valueType->isSuperTypeOf($needleType); if ($isNeedleSuperType->no()) { continue; } if ($needleType instanceof ConstantScalarType && $valueType instanceof ConstantScalarType && $needleType->getValue() === $valueType->getValue() && !$this->isOptionalKey($index)) { $hasIdenticalValue = \true; } $matches[] = $this->keyTypes[$index]; } if (count($matches) > 0) { if ($hasIdenticalValue) { return TypeCombinator::union(...$matches); } return TypeCombinator::union(new \PHPStan\Type\Constant\ConstantBooleanType(\false), ...$matches); } return new \PHPStan\Type\Constant\ConstantBooleanType(\false); } public function shiftArray() : Type { return $this->removeFirstElements(1); } public function shuffleArray() : Type { $valuesArray = $this->getValuesArray(); $isIterableAtLeastOnce = $valuesArray->isIterableAtLeastOnce(); if ($isIterableAtLeastOnce->no()) { return $valuesArray; } $generalizedArray = new ArrayType($valuesArray->getIterableKeyType(), $valuesArray->getItemType()); if ($isIterableAtLeastOnce->yes()) { $generalizedArray = TypeCombinator::intersect($generalizedArray, new NonEmptyArrayType()); } if ($valuesArray->isList->yes()) { $generalizedArray = AccessoryArrayListType::intersectWith($generalizedArray); } return $generalizedArray; } public function sliceArray(Type $offsetType, Type $lengthType, TrinaryLogic $preserveKeys) : Type { $keyTypesCount = count($this->keyTypes); if ($keyTypesCount === 0) { return $this; } $offset = $offsetType instanceof \PHPStan\Type\Constant\ConstantIntegerType ? $offsetType->getValue() : 0; $length = $lengthType instanceof \PHPStan\Type\Constant\ConstantIntegerType ? $lengthType->getValue() : $keyTypesCount; if ($length < 0) { // Negative lengths prevent access to the most right n elements return $this->removeLastElements($length * -1)->sliceArray($offsetType, new NullType(), $preserveKeys); } if ($keyTypesCount + $offset <= 0) { // A negative offset cannot reach left outside the array $offset = 0; } if ($offset < 0) { /* * Transforms the problem with the negative offset in one with a positive offset using array reversion. * The reason is belows handling of optional keys which works only from left to right. * * e.g. * array{a: 0, b: 1, c: 2, d: 3, e: 4} * with offset -4 and length 2 (which would be sliced to array{b: 1, c: 2}) * * is transformed via reversion to * * array{e: 4, d: 3, c: 2, b: 1, a: 0} * with offset 2 and length 2 (which will be sliced to array{c: 2, b: 1} and then reversed again) */ $offset *= -1; $reversedLength = min($length, $offset); $reversedOffset = $offset - $reversedLength; return $this->reverseArray(TrinaryLogic::createYes())->sliceArray(new \PHPStan\Type\Constant\ConstantIntegerType($reversedOffset), new \PHPStan\Type\Constant\ConstantIntegerType($reversedLength), $preserveKeys)->reverseArray(TrinaryLogic::createYes()); } if ($offset > 0) { return $this->removeFirstElements($offset, \false)->sliceArray(new \PHPStan\Type\Constant\ConstantIntegerType(0), $lengthType, $preserveKeys); } $builder = \PHPStan\Type\Constant\ConstantArrayTypeBuilder::createEmpty(); $nonOptionalElementsCount = 0; $hasOptional = \false; for ($i = 0; $nonOptionalElementsCount < $length && $i < $keyTypesCount; $i++) { $isOptional = $this->isOptionalKey($i); if (!$isOptional) { $nonOptionalElementsCount++; } else { $hasOptional = \true; } $isLastElement = $nonOptionalElementsCount >= $length || $i + 1 >= $keyTypesCount; if ($isLastElement && $length < $keyTypesCount && $hasOptional) { // If the slice is not full yet, but has at least one optional key // the last non-optional element is going to be optional. // Otherwise, it would not fit into the slice if previous non-optional keys are there. $isOptional = \true; } $builder->setOffsetValueType($this->keyTypes[$i], $this->valueTypes[$i], $isOptional); } $slice = $builder->getArray(); if (!$slice instanceof self) { throw new ShouldNotHappenException(); } return $preserveKeys->yes() ? $slice : $slice->reindex(); } public function isIterableAtLeastOnce() : TrinaryLogic { $keysCount = count($this->keyTypes); if ($keysCount === 0) { return TrinaryLogic::createNo(); } $optionalKeysCount = count($this->optionalKeys); if ($optionalKeysCount < $keysCount) { return TrinaryLogic::createYes(); } return TrinaryLogic::createMaybe(); } public function getArraySize() : Type { $optionalKeysCount = count($this->optionalKeys); $totalKeysCount = count($this->getKeyTypes()); if ($optionalKeysCount === 0) { return new \PHPStan\Type\Constant\ConstantIntegerType($totalKeysCount); } return IntegerRangeType::fromInterval($totalKeysCount - $optionalKeysCount, $totalKeysCount); } public function getFirstIterableKeyType() : Type { $keyTypes = []; foreach ($this->keyTypes as $i => $keyType) { $keyTypes[] = $keyType; if (!$this->isOptionalKey($i)) { break; } } return TypeCombinator::union(...$keyTypes); } public function getLastIterableKeyType() : Type { $keyTypes = []; for ($i = count($this->keyTypes) - 1; $i >= 0; $i--) { $keyTypes[] = $this->keyTypes[$i]; if (!$this->isOptionalKey($i)) { break; } } return TypeCombinator::union(...$keyTypes); } public function getFirstIterableValueType() : Type { $valueTypes = []; foreach ($this->valueTypes as $i => $valueType) { $valueTypes[] = $valueType; if (!$this->isOptionalKey($i)) { break; } } return TypeCombinator::union(...$valueTypes); } public function getLastIterableValueType() : Type { $valueTypes = []; for ($i = count($this->keyTypes) - 1; $i >= 0; $i--) { $valueTypes[] = $this->valueTypes[$i]; if (!$this->isOptionalKey($i)) { break; } } return TypeCombinator::union(...$valueTypes); } public function isConstantArray() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isList() : TrinaryLogic { return $this->isList; } /** @deprecated Use popArray() instead */ public function removeLast() : self { return $this->removeLastElements(1); } /** @param positive-int $length */ private function removeLastElements(int $length) : self { $keyTypesCount = count($this->keyTypes); if ($keyTypesCount === 0) { return $this; } $keyTypes = $this->keyTypes; $valueTypes = $this->valueTypes; $optionalKeys = $this->optionalKeys; $nextAutoindex = $this->nextAutoIndexes; $optionalKeysRemoved = 0; $newLength = $keyTypesCount - $length; for ($i = $keyTypesCount - 1; $i >= 0; $i--) { $isOptional = $this->isOptionalKey($i); if ($i >= $newLength) { if ($isOptional) { $optionalKeysRemoved++; foreach ($optionalKeys as $key => $value) { if ($value === $i) { unset($optionalKeys[$key]); break; } } } $removedKeyType = array_pop($keyTypes); array_pop($valueTypes); $nextAutoindex = $removedKeyType instanceof \PHPStan\Type\Constant\ConstantIntegerType ? $removedKeyType->getValue() : $this->getNextAutoIndex(); // @phpstan-ignore method.deprecated continue; } if ($isOptional || $optionalKeysRemoved <= 0) { continue; } $optionalKeys[] = $i; $optionalKeysRemoved--; } return new self($keyTypes, $valueTypes, $nextAutoindex, array_values($optionalKeys), $this->isList); } /** @deprecated Use shiftArray() instead */ public function removeFirst() : self { return $this->removeFirstElements(1); } /** @param positive-int $length */ private function removeFirstElements(int $length, bool $reindex = \true) : self { $builder = \PHPStan\Type\Constant\ConstantArrayTypeBuilder::createEmpty(); $optionalKeysIgnored = 0; foreach ($this->keyTypes as $i => $keyType) { $isOptional = $this->isOptionalKey($i); if ($i <= $length - 1) { if ($isOptional) { $optionalKeysIgnored++; } continue; } if (!$isOptional && $optionalKeysIgnored > 0) { $isOptional = \true; $optionalKeysIgnored--; } $valueType = $this->valueTypes[$i]; if ($reindex && $keyType instanceof \PHPStan\Type\Constant\ConstantIntegerType) { $keyType = null; } $builder->setOffsetValueType($keyType, $valueType, $isOptional); } $array = $builder->getArray(); if (!$array instanceof self) { throw new ShouldNotHappenException(); } return $array; } /** @deprecated Use sliceArray() instead */ public function slice(int $offset, ?int $limit, bool $preserveKeys = \false) : self { $array = $this->sliceArray(ConstantTypeHelper::getTypeFromValue($offset), ConstantTypeHelper::getTypeFromValue($limit), TrinaryLogic::createFromBoolean($preserveKeys)); if (!$array instanceof self) { throw new ShouldNotHappenException(); } return $array; } /** @deprecated Use reverseArray() instead */ public function reverse(bool $preserveKeys = \false) : self { $array = $this->reverseArray(TrinaryLogic::createFromBoolean($preserveKeys)); if (!$array instanceof self) { throw new ShouldNotHappenException(); } return $array; } /** * @deprecated Use chunkArray() instead * @param positive-int $length */ public function chunk(int $length, bool $preserveKeys = \false) : self { $builder = \PHPStan\Type\Constant\ConstantArrayTypeBuilder::createEmpty(); $keyTypesCount = count($this->keyTypes); for ($i = 0; $i < $keyTypesCount; $i += $length) { $chunk = $this->slice($i, $length, \true); $builder->setOffsetValueType(null, $preserveKeys ? $chunk : $chunk->getValuesArray()); } $chunks = $builder->getArray(); if (!$chunks instanceof self) { throw new ShouldNotHappenException(); } return $chunks; } private function reindex() : self { $keyTypes = []; $autoIndex = 0; foreach ($this->keyTypes as $keyType) { if (!$keyType instanceof \PHPStan\Type\Constant\ConstantIntegerType) { $keyTypes[] = $keyType; continue; } $keyTypes[] = new \PHPStan\Type\Constant\ConstantIntegerType($autoIndex); $autoIndex++; } return new self($keyTypes, $this->valueTypes, [$autoIndex], $this->optionalKeys, TrinaryLogic::createYes()); } public function toBoolean() : BooleanType { return $this->getArraySize()->toBoolean(); } public function toInteger() : Type { return $this->toBoolean()->toInteger(); } public function toFloat() : Type { return $this->toBoolean()->toFloat(); } public function generalize(GeneralizePrecision $precision) : Type { if (count($this->keyTypes) === 0) { return $this; } if ($precision->isTemplateArgument()) { return $this->traverse(static function (Type $type) use($precision) { return $type->generalize($precision); }); } $arrayType = new ArrayType($this->getIterableKeyType()->generalize($precision), $this->getItemType()->generalize($precision)); $keyTypesCount = count($this->keyTypes); $optionalKeysCount = count($this->optionalKeys); $accessoryTypes = []; if ($precision->isMoreSpecific() && $keyTypesCount - $optionalKeysCount < 32) { foreach ($this->keyTypes as $i => $keyType) { if ($this->isOptionalKey($i)) { continue; } $accessoryTypes[] = new HasOffsetValueType($keyType, $this->valueTypes[$i]->generalize($precision)); } } elseif ($keyTypesCount > $optionalKeysCount) { $accessoryTypes[] = new NonEmptyArrayType(); } if ($this->isList()->yes()) { $arrayType = AccessoryArrayListType::intersectWith($arrayType); } if (count($accessoryTypes) > 0) { return TypeCombinator::intersect($arrayType, ...$accessoryTypes); } return $arrayType; } /** * @return self */ public function generalizeValues() : ArrayType { $valueTypes = []; foreach ($this->valueTypes as $valueType) { $valueTypes[] = $valueType->generalize(GeneralizePrecision::lessSpecific()); } return new self($this->keyTypes, $valueTypes, $this->nextAutoIndexes, $this->optionalKeys, $this->isList); } /** @deprecated */ public function generalizeToArray() : Type { $isIterableAtLeastOnce = $this->isIterableAtLeastOnce(); if ($isIterableAtLeastOnce->no()) { return $this; } $arrayType = new ArrayType($this->getIterableKeyType(), $this->getItemType()); if ($isIterableAtLeastOnce->yes()) { $arrayType = TypeCombinator::intersect($arrayType, new NonEmptyArrayType()); } if ($this->isList->yes()) { $arrayType = AccessoryArrayListType::intersectWith($arrayType); } return $arrayType; } /** * @return self */ public function getKeysArray() : Type { return $this->getKeysOrValuesArray($this->keyTypes); } /** * @return self */ public function getValuesArray() : Type { return $this->getKeysOrValuesArray($this->valueTypes); } /** * @param array<int, Type> $types */ private function getKeysOrValuesArray(array $types) : self { $count = count($types); $autoIndexes = range($count - count($this->optionalKeys), $count); assert($autoIndexes !== []); if ($this->isList->yes()) { // Optimized version for lists: Assume that if a later key exists, then earlier keys also exist. $keyTypes = array_map(static function (int $i) : \PHPStan\Type\Constant\ConstantIntegerType { return new \PHPStan\Type\Constant\ConstantIntegerType($i); }, array_keys($types)); return new self($keyTypes, $types, $autoIndexes, $this->optionalKeys, TrinaryLogic::createYes()); } $keyTypes = []; $valueTypes = []; $optionalKeys = []; $maxIndex = 0; foreach ($types as $i => $type) { $keyTypes[] = new \PHPStan\Type\Constant\ConstantIntegerType($i); if ($this->isOptionalKey($maxIndex)) { // move $maxIndex to next non-optional key do { $maxIndex++; } while ($maxIndex < $count && $this->isOptionalKey($maxIndex)); } if ($i === $maxIndex) { $valueTypes[] = $type; } else { $valueTypes[] = TypeCombinator::union(...array_slice($types, $i, $maxIndex - $i + 1)); if ($maxIndex >= $count) { $optionalKeys[] = $i; } } $maxIndex++; } return new self($keyTypes, $valueTypes, $autoIndexes, $optionalKeys, TrinaryLogic::createYes()); } /** @deprecated Use getArraySize() instead */ public function count() : Type { return $this->getArraySize(); } public function describe(VerbosityLevel $level) : string { $describeValue = function (bool $truncate) use($level) : string { $items = []; $values = []; $exportValuesOnly = \true; foreach ($this->keyTypes as $i => $keyType) { $valueType = $this->valueTypes[$i]; if ($keyType->getValue() !== $i) { $exportValuesOnly = \false; } $isOptional = $this->isOptionalKey($i); if ($isOptional) { $exportValuesOnly = \false; } $keyDescription = $keyType->getValue(); if (is_string($keyDescription)) { if (str_contains($keyDescription, '"')) { $keyDescription = sprintf('\'%s\'', $keyDescription); } elseif (str_contains($keyDescription, '\'')) { $keyDescription = sprintf('"%s"', $keyDescription); } } $valueTypeDescription = $valueType->describe($level); $items[] = sprintf('%s%s: %s', $keyDescription, $isOptional ? '?' : '', $valueTypeDescription); $values[] = $valueTypeDescription; } $append = ''; if ($truncate && count($items) > self::DESCRIBE_LIMIT) { $items = array_slice($items, 0, self::DESCRIBE_LIMIT); $values = array_slice($values, 0, self::DESCRIBE_LIMIT); $append = ', ...'; } return sprintf('array{%s%s}', implode(', ', $exportValuesOnly ? $values : $items), $append); }; return $level->handle(function () use($level) : string { return parent::describe($level); }, static function () use($describeValue) : string { return $describeValue(\true); }, static function () use($describeValue) : string { return $describeValue(\false); }); } public function inferTemplateTypes(Type $receivedType) : TemplateTypeMap { if ($receivedType instanceof UnionType || $receivedType instanceof IntersectionType) { return $receivedType->inferTemplateTypesOn($this); } if ($receivedType instanceof self) { $typeMap = TemplateTypeMap::createEmpty(); foreach ($this->keyTypes as $i => $keyType) { $valueType = $this->valueTypes[$i]; if ($receivedType->hasOffsetValueType($keyType)->no()) { continue; } $receivedValueType = $receivedType->getOffsetValueType($keyType); $typeMap = $typeMap->union($valueType->inferTemplateTypes($receivedValueType)); } return $typeMap; } return parent::inferTemplateTypes($receivedType); } public function getReferencedTemplateTypes(TemplateTypeVariance $positionVariance) : array { $variance = $positionVariance->compose(TemplateTypeVariance::createCovariant()); $references = []; foreach ($this->keyTypes as $type) { foreach ($type->getReferencedTemplateTypes($variance) as $reference) { $references[] = $reference; } } foreach ($this->valueTypes as $type) { foreach ($type->getReferencedTemplateTypes($variance) as $reference) { $references[] = $reference; } } return $references; } public function traverse(callable $cb) : Type { $valueTypes = []; $stillOriginal = \true; foreach ($this->valueTypes as $valueType) { $transformedValueType = $cb($valueType); if ($transformedValueType !== $valueType) { $stillOriginal = \false; } $valueTypes[] = $transformedValueType; } if ($stillOriginal) { return $this; } return new self($this->keyTypes, $valueTypes, $this->nextAutoIndexes, $this->optionalKeys, $this->isList); } public function traverseSimultaneously(Type $right, callable $cb) : Type { if (!$right->isArray()->yes()) { return $this; } $valueTypes = []; $stillOriginal = \true; foreach ($this->valueTypes as $i => $valueType) { $keyType = $this->keyTypes[$i]; $transformedValueType = $cb($valueType, $right->getOffsetValueType($keyType)); if ($transformedValueType !== $valueType) { $stillOriginal = \false; } $valueTypes[] = $transformedValueType; } if ($stillOriginal) { return $this; } return new self($this->keyTypes, $valueTypes, $this->nextAutoIndexes, $this->optionalKeys, $this->isList); } public function isKeysSupersetOf(self $otherArray) : bool { $keyTypesCount = count($this->keyTypes); $otherKeyTypesCount = count($otherArray->keyTypes); if ($keyTypesCount < $otherKeyTypesCount) { return \false; } if ($otherKeyTypesCount === 0) { return $keyTypesCount === 0; } $failOnDifferentValueType = $keyTypesCount !== $otherKeyTypesCount || $keyTypesCount < 2; $keyTypes = $this->keyTypes; foreach ($otherArray->keyTypes as $j => $keyType) { $i = self::findKeyIndex($keyType, $keyTypes); if ($i === null) { return \false; } unset($keyTypes[$i]); $valueType = $this->valueTypes[$i]; $otherValueType = $otherArray->valueTypes[$j]; if (!$otherValueType->isSuperTypeOf($valueType)->no()) { continue; } if ($failOnDifferentValueType) { return \false; } $failOnDifferentValueType = \true; } $requiredKeyCount = 0; foreach (array_keys($keyTypes) as $i) { if ($this->isOptionalKey($i)) { continue; } $requiredKeyCount++; if ($requiredKeyCount > 1) { return \false; } } return \true; } public function mergeWith(self $otherArray) : self { // only call this after verifying isKeysSupersetOf, or if losing tagged unions is not an issue $valueTypes = $this->valueTypes; $optionalKeys = $this->optionalKeys; foreach ($this->keyTypes as $i => $keyType) { $otherIndex = $otherArray->getKeyIndex($keyType); if ($otherIndex === null) { $optionalKeys[] = $i; continue; } if ($otherArray->isOptionalKey($otherIndex)) { $optionalKeys[] = $i; } $otherValueType = $otherArray->valueTypes[$otherIndex]; $valueTypes[$i] = TypeCombinator::union($valueTypes[$i], $otherValueType); } $optionalKeys = array_values(array_unique($optionalKeys)); $nextAutoIndexes = array_values(array_unique(array_merge($this->nextAutoIndexes, $otherArray->nextAutoIndexes))); sort($nextAutoIndexes); return new self($this->keyTypes, $valueTypes, $nextAutoIndexes, $optionalKeys, $this->isList->and($otherArray->isList)); } /** * @param ConstantIntegerType|ConstantStringType $otherKeyType */ private function getKeyIndex($otherKeyType) : ?int { return self::findKeyIndex($otherKeyType, $this->keyTypes); } /** * @param ConstantIntegerType|ConstantStringType $otherKeyType * @param array<int, ConstantIntegerType|ConstantStringType> $keyTypes */ private static function findKeyIndex($otherKeyType, array $keyTypes) : ?int { foreach ($keyTypes as $i => $keyType) { if ($keyType->equals($otherKeyType)) { return $i; } } return null; } public function makeOffsetRequired(Type $offsetType) : self { $offsetType = $offsetType->toArrayKey(); $optionalKeys = $this->optionalKeys; foreach ($this->keyTypes as $i => $keyType) { if (!$keyType->equals($offsetType)) { continue; } foreach ($optionalKeys as $j => $key) { if ($i === $key) { unset($optionalKeys[$j]); return new self($this->keyTypes, $this->valueTypes, $this->nextAutoIndexes, array_values($optionalKeys), $this->isList); } } break; } return $this; } public function toPhpDocNode() : TypeNode { $items = []; $values = []; $exportValuesOnly = \true; foreach ($this->keyTypes as $i => $keyType) { if ($keyType->getValue() !== $i) { $exportValuesOnly = \false; } $keyPhpDocNode = $keyType->toPhpDocNode(); if (!$keyPhpDocNode instanceof ConstTypeNode) { continue; } $valueType = $this->valueTypes[$i]; /** @var ConstExprStringNode|ConstExprIntegerNode $keyNode */ $keyNode = $keyPhpDocNode->constExpr; if ($keyNode instanceof ConstExprStringNode) { $value = $keyNode->value; if (self::isValidIdentifier($value)) { $keyNode = new IdentifierTypeNode($value); } } $isOptional = $this->isOptionalKey($i); if ($isOptional) { $exportValuesOnly = \false; } $items[] = new ArrayShapeItemNode($keyNode, $isOptional, $valueType->toPhpDocNode()); $values[] = new ArrayShapeItemNode(null, $isOptional, $valueType->toPhpDocNode()); } return new ArrayShapeNode($exportValuesOnly ? $values : $items); } public static function isValidIdentifier(string $value) : bool { $result = Strings::match($value, '~^(?:[\\\\]?+[a-z_\\x80-\\xFF][0-9a-z_\\x80-\\xFF-]*+)++$~si'); return $result !== null; } public function getFiniteTypes() : array { $arraysArraysForCombinations = []; $count = 0; foreach ($this->getAllArrays() as $array) { $values = $array->getValueTypes(); $arraysForCombinations = []; $combinationCount = 1; foreach ($values as $valueType) { $finiteTypes = $valueType->getFiniteTypes(); if ($finiteTypes === []) { return []; } $arraysForCombinations[] = $finiteTypes; $combinationCount *= count($finiteTypes); } $arraysArraysForCombinations[] = $arraysForCombinations; $count += $combinationCount; } if ($count > InitializerExprTypeResolver::CALCULATE_SCALARS_LIMIT) { return []; } $finiteTypes = []; foreach ($arraysArraysForCombinations as $arraysForCombinations) { $combinations = CombinationsHelper::combinations($arraysForCombinations); foreach ($combinations as $combination) { $builder = \PHPStan\Type\Constant\ConstantArrayTypeBuilder::createEmpty(); foreach ($combination as $i => $v) { $builder->setOffsetValueType($this->keyTypes[$i], $v); } $finiteTypes[] = $builder->getArray(); } } return $finiteTypes; } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : Type { return new self($properties['keyTypes'], $properties['valueTypes'], $properties['nextAutoIndexes'] ?? $properties['nextAutoIndex'], $properties['optionalKeys'] ?? [], $properties['isList'] ?? TrinaryLogic::createNo()); } } <?php declare (strict_types=1); namespace PHPStan\Type\Constant; use PHPStan\PhpDocParser\Ast\ConstExpr\ConstExprIntegerNode; use PHPStan\PhpDocParser\Ast\Type\ConstTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\TrinaryLogic; use PHPStan\Type\CompoundType; use PHPStan\Type\ConstantScalarType; use PHPStan\Type\GeneralizePrecision; use PHPStan\Type\IntegerRangeType; use PHPStan\Type\IntegerType; use PHPStan\Type\IsSuperTypeOfResult; use PHPStan\Type\Traits\ConstantNumericComparisonTypeTrait; use PHPStan\Type\Traits\ConstantScalarTypeTrait; use PHPStan\Type\Type; use PHPStan\Type\VerbosityLevel; use function abs; use function sprintf; /** @api */ class ConstantIntegerType extends IntegerType implements ConstantScalarType { /** * @var int */ private $value; use ConstantScalarTypeTrait; use \PHPStan\Type\Constant\ConstantScalarToBooleanTrait; use ConstantNumericComparisonTypeTrait; /** @api */ public function __construct(int $value) { $this->value = $value; parent::__construct(); } public function getValue() : int { return $this->value; } public function isSuperTypeOf(Type $type) : TrinaryLogic { return $this->isSuperTypeOfWithReason($type)->result; } public function isSuperTypeOfWithReason(Type $type) : IsSuperTypeOfResult { if ($type instanceof self) { return $this->value === $type->value ? IsSuperTypeOfResult::createYes() : IsSuperTypeOfResult::createNo(); } if ($type instanceof IntegerRangeType) { $min = $type->getMin(); $max = $type->getMax(); if (($min === null || $min <= $this->value) && ($max === null || $this->value <= $max)) { return IsSuperTypeOfResult::createMaybe(); } return IsSuperTypeOfResult::createNo(); } if ($type instanceof parent) { return IsSuperTypeOfResult::createMaybe(); } if ($type instanceof CompoundType) { return $type->isSubTypeOfWithReason($this); } return IsSuperTypeOfResult::createNo(); } public function describe(VerbosityLevel $level) : string { return $level->handle(static function () : string { return 'int'; }, function () : string { return sprintf('%s', $this->value); }); } public function toFloat() : Type { return new \PHPStan\Type\Constant\ConstantFloatType($this->value); } public function toAbsoluteNumber() : Type { return new self(abs($this->value)); } public function toString() : Type { return new \PHPStan\Type\Constant\ConstantStringType((string) $this->value); } public function toArrayKey() : Type { return $this; } public function generalize(GeneralizePrecision $precision) : Type { return new IntegerType(); } /** * @return ConstTypeNode */ public function toPhpDocNode() : TypeNode { return new ConstTypeNode(new ConstExprIntegerNode((string) $this->value)); } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : Type { return new self($properties['value']); } } <?php declare (strict_types=1); namespace PHPStan\Type\Constant; use PHPStan\PhpDocParser\Ast\ConstExpr\ConstExprFloatNode; use PHPStan\PhpDocParser\Ast\Type\ConstTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\Type\ConstantScalarType; use PHPStan\Type\FloatType; use PHPStan\Type\GeneralizePrecision; use PHPStan\Type\Traits\ConstantNumericComparisonTypeTrait; use PHPStan\Type\Traits\ConstantScalarTypeTrait; use PHPStan\Type\Type; use PHPStan\Type\VerbosityLevel; use function abs; use function ini_get; use function ini_set; use function is_finite; use function is_nan; use function str_contains; /** @api */ class ConstantFloatType extends FloatType implements ConstantScalarType { /** * @var float */ private $value; use ConstantScalarTypeTrait; use \PHPStan\Type\Constant\ConstantScalarToBooleanTrait; use ConstantNumericComparisonTypeTrait; /** @api */ public function __construct(float $value) { $this->value = $value; parent::__construct(); } public function getValue() : float { return $this->value; } public function equals(Type $type) : bool { return $type instanceof self && ($this->value === $type->value || is_nan($this->value) && is_nan($type->value)); } private function castFloatToString(float $value) : string { $precisionBackup = ini_get('precision'); ini_set('precision', '-1'); try { $valueStr = (string) $value; if (is_finite($value) && !str_contains($valueStr, '.')) { $valueStr .= '.0'; } return $valueStr; } finally { ini_set('precision', $precisionBackup); } } public function describe(VerbosityLevel $level) : string { return $level->handle(static function () : string { return 'float'; }, function () : string { return $this->castFloatToString($this->value); }); } public function toString() : Type { return new \PHPStan\Type\Constant\ConstantStringType((string) $this->value); } public function toInteger() : Type { return new \PHPStan\Type\Constant\ConstantIntegerType((int) $this->value); } public function toAbsoluteNumber() : Type { return new self(abs($this->value)); } public function toArrayKey() : Type { return new \PHPStan\Type\Constant\ConstantIntegerType((int) $this->value); } public function generalize(GeneralizePrecision $precision) : Type { return new FloatType(); } /** * @return ConstTypeNode */ public function toPhpDocNode() : TypeNode { return new ConstTypeNode(new ConstExprFloatNode($this->castFloatToString($this->value))); } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : Type { return new self($properties['value']); } } <?php declare (strict_types=1); namespace PHPStan\Type\Constant; use PHPStan\Type\BooleanType; trait ConstantScalarToBooleanTrait { public function toBoolean() : BooleanType { return new \PHPStan\Type\Constant\ConstantBooleanType((bool) $this->value); } } <?php declare (strict_types=1); namespace PHPStan\Type; use Closure; use PhpParser\Node; use PHPStan\Analyser\NameScope; use PHPStan\BetterReflection\Util\GetLastDocComment; use PHPStan\Broker\AnonymousClassNameHelper; use PHPStan\File\FileHelper; use PHPStan\Parser\Parser; use PHPStan\PhpDoc\NameScopeAlreadyBeingCreatedException; use PHPStan\PhpDoc\PhpDocNodeResolver; use PHPStan\PhpDoc\PhpDocStringResolver; use PHPStan\PhpDoc\ResolvedPhpDocBlock; use PHPStan\PhpDoc\Tag\TemplateTag; use PHPStan\PhpDocParser\Ast\PhpDoc\PhpDocNode; use PHPStan\Reflection\ReflectionProvider\ReflectionProviderProvider; use PHPStan\ShouldNotHappenException; use PHPStan\Type\Generic\GenericObjectType; use PHPStan\Type\Generic\TemplateTypeFactory; use PHPStan\Type\Generic\TemplateTypeHelper; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\Generic\TemplateTypeVariance; use PHPStan\Type\Generic\TemplateTypeVarianceMap; use function array_key_exists; use function array_keys; use function array_map; use function array_merge; use function array_pop; use function array_slice; use function count; use function is_array; use function is_callable; use function is_file; use function ltrim; use function md5; use function sprintf; use function str_contains; use function strtolower; final class FileTypeMapper { /** * @var ReflectionProviderProvider */ private $reflectionProviderProvider; /** * @var Parser */ private $phpParser; /** * @var PhpDocStringResolver */ private $phpDocStringResolver; /** * @var PhpDocNodeResolver */ private $phpDocNodeResolver; /** * @var AnonymousClassNameHelper */ private $anonymousClassNameHelper; /** * @var FileHelper */ private $fileHelper; private const SKIP_NODE = 1; private const POP_TYPE_MAP_STACK = 2; /** @var NameScope[][] */ private $memoryCache = []; /** * @var int */ private $memoryCacheCount = 0; /** @var (true|callable(): NameScope|NameScope)[][] */ private $inProcess = []; /** @var array<string, ResolvedPhpDocBlock> */ private $resolvedPhpDocBlockCache = []; /** * @var int */ private $resolvedPhpDocBlockCacheCount = 0; public function __construct(ReflectionProviderProvider $reflectionProviderProvider, Parser $phpParser, PhpDocStringResolver $phpDocStringResolver, PhpDocNodeResolver $phpDocNodeResolver, AnonymousClassNameHelper $anonymousClassNameHelper, FileHelper $fileHelper) { $this->reflectionProviderProvider = $reflectionProviderProvider; $this->phpParser = $phpParser; $this->phpDocStringResolver = $phpDocStringResolver; $this->phpDocNodeResolver = $phpDocNodeResolver; $this->anonymousClassNameHelper = $anonymousClassNameHelper; $this->fileHelper = $fileHelper; } /** @api */ public function getResolvedPhpDoc(?string $fileName, ?string $className, ?string $traitName, ?string $functionName, string $docComment) : ResolvedPhpDocBlock { if ($className === null && $traitName !== null) { throw new ShouldNotHappenException(); } if ($docComment === '') { return ResolvedPhpDocBlock::createEmpty(); } if ($fileName !== null) { $fileName = $this->fileHelper->normalizePath($fileName); } $nameScopeKey = $this->getNameScopeKey($fileName, $className, $traitName, $functionName); $phpDocKey = md5(sprintf('%s-%s', $nameScopeKey, $docComment)); if (isset($this->resolvedPhpDocBlockCache[$phpDocKey])) { return $this->resolvedPhpDocBlockCache[$phpDocKey]; } if ($fileName === null) { return $this->createResolvedPhpDocBlock($phpDocKey, new NameScope(null, []), $docComment, null); } try { $nameScope = $this->getNameScope($fileName, $className, $traitName, $functionName); } catch (NameScopeAlreadyBeingCreatedException $e) { return ResolvedPhpDocBlock::createEmpty(); } return $this->createResolvedPhpDocBlock($phpDocKey, $nameScope, $docComment, $fileName); } /** * @throws NameScopeAlreadyBeingCreatedException */ public function getNameScope(string $fileName, ?string $className, ?string $traitName, ?string $functionName) : NameScope { $nameScopeKey = $this->getNameScopeKey($fileName, $className, $traitName, $functionName); $nameScopeMap = []; if (!isset($this->inProcess[$fileName])) { $nameScopeMap = $this->getNameScopeMap($fileName); } if (isset($nameScopeMap[$nameScopeKey])) { return $nameScopeMap[$nameScopeKey]; } if (!isset($this->inProcess[$fileName][$nameScopeKey])) { // wrong $fileName due to traits throw new NameScopeAlreadyBeingCreatedException(); } if ($this->inProcess[$fileName][$nameScopeKey] === \true) { // PHPDoc has cyclic dependency throw new NameScopeAlreadyBeingCreatedException(); } if (is_callable($this->inProcess[$fileName][$nameScopeKey])) { $resolveCallback = $this->inProcess[$fileName][$nameScopeKey]; $this->inProcess[$fileName][$nameScopeKey] = \true; $this->inProcess[$fileName][$nameScopeKey] = $resolveCallback(); } return $this->inProcess[$fileName][$nameScopeKey]; } private function createResolvedPhpDocBlock(string $phpDocKey, NameScope $nameScope, string $phpDocString, ?string $fileName) : ResolvedPhpDocBlock { $phpDocNode = $this->phpDocStringResolver->resolve($phpDocString); if ($this->resolvedPhpDocBlockCacheCount >= 2048) { $this->resolvedPhpDocBlockCache = array_slice($this->resolvedPhpDocBlockCache, 1, null, \true); $this->resolvedPhpDocBlockCacheCount--; } $templateTypeMap = $nameScope->getTemplateTypeMap(); $phpDocTemplateTypes = []; $templateTags = $this->phpDocNodeResolver->resolveTemplateTags($phpDocNode, $nameScope); foreach (array_keys($templateTags) as $name) { $templateType = $templateTypeMap->getType($name); if ($templateType === null) { continue; } $phpDocTemplateTypes[$name] = $templateType; } $this->resolvedPhpDocBlockCache[$phpDocKey] = ResolvedPhpDocBlock::create($phpDocNode, $phpDocString, $fileName, $nameScope, new TemplateTypeMap($phpDocTemplateTypes), $templateTags, $this->phpDocNodeResolver, $this->reflectionProviderProvider->getReflectionProvider()); $this->resolvedPhpDocBlockCacheCount++; return $this->resolvedPhpDocBlockCache[$phpDocKey]; } /** * @return NameScope[] */ private function getNameScopeMap(string $fileName) : array { if (!isset($this->memoryCache[$fileName])) { $map = $this->createResolvedPhpDocMap($fileName); if ($this->memoryCacheCount >= 2048) { $this->memoryCache = array_slice($this->memoryCache, 1, null, \true); $this->memoryCacheCount--; } $this->memoryCache[$fileName] = $map; $this->memoryCacheCount++; } return $this->memoryCache[$fileName]; } /** * @return NameScope[] */ private function createResolvedPhpDocMap(string $fileName) : array { $phpDocNodeMap = $this->createPhpDocNodeMap($fileName, null, $fileName, [], $fileName); $nameScopeMap = $this->createNameScopeMap($fileName, null, null, [], $fileName, $phpDocNodeMap); $resolvedNameScopeMap = []; try { $this->inProcess[$fileName] = $nameScopeMap; foreach ($nameScopeMap as $nameScopeKey => $resolveCallback) { $this->inProcess[$fileName][$nameScopeKey] = \true; $this->inProcess[$fileName][$nameScopeKey] = $data = $resolveCallback(); $resolvedNameScopeMap[$nameScopeKey] = $data; } } finally { unset($this->inProcess[$fileName]); } return $resolvedNameScopeMap; } /** * @param array<string, string> $traitMethodAliases * @return array<string, PhpDocNode> */ private function createPhpDocNodeMap(string $fileName, ?string $lookForTrait, ?string $traitUseClass, array $traitMethodAliases, string $originalClassFileName) : array { /** @var array<string, PhpDocNode> $phpDocNodeMap */ $phpDocNodeMap = []; /** @var string[] $classStack */ $classStack = []; if ($lookForTrait !== null && $traitUseClass !== null) { $classStack[] = $traitUseClass; } $namespace = null; $traitFound = \false; /** @var array<string|null> $functionStack */ $functionStack = []; $this->processNodes($this->phpParser->parseFile($fileName), function (Node $node) use($fileName, $lookForTrait, &$traitFound, $traitMethodAliases, $originalClassFileName, &$phpDocNodeMap, &$classStack, &$namespace, &$functionStack) : ?int { if ($node instanceof Node\Stmt\ClassLike) { if ($traitFound && $fileName === $originalClassFileName) { return self::SKIP_NODE; } if ($lookForTrait !== null && !$traitFound) { if (!$node instanceof Node\Stmt\Trait_) { return self::SKIP_NODE; } if ((string) $node->namespacedName !== $lookForTrait) { return self::SKIP_NODE; } $traitFound = \true; $functionStack[] = null; } else { if ($node->name === null) { if (!$node instanceof Node\Stmt\Class_) { throw new ShouldNotHappenException(); } $className = $this->anonymousClassNameHelper->getAnonymousClassName($node, $fileName); } elseif ($node instanceof Node\Stmt\Class_ && $node->isAnonymous()) { $className = $node->name->name; } else { if ($traitFound) { return self::SKIP_NODE; } $className = ltrim(sprintf('%s\\%s', $namespace, $node->name->name), '\\'); } $classStack[] = $className; $functionStack[] = null; } } elseif ($node instanceof Node\Stmt\ClassMethod) { if (array_key_exists($node->name->name, $traitMethodAliases)) { $functionStack[] = $traitMethodAliases[$node->name->name]; } else { $functionStack[] = $node->name->name; } } elseif ($node instanceof Node\Stmt\Function_) { $functionStack[] = ltrim(sprintf('%s\\%s', $namespace, $node->name->name), '\\'); } $className = $classStack[count($classStack) - 1] ?? null; $functionName = $functionStack[count($functionStack) - 1] ?? null; if ($node instanceof Node\Stmt\ClassLike || $node instanceof Node\Stmt\ClassMethod || $node instanceof Node\Stmt\Function_) { $docComment = GetLastDocComment::forNode($node); if ($docComment !== null) { $nameScopeKey = $this->getNameScopeKey($originalClassFileName, $className, $lookForTrait, $functionName); $phpDocNodeMap[$nameScopeKey] = $this->phpDocStringResolver->resolve($docComment); } return null; } if ($node instanceof Node\Stmt\Namespace_) { $namespace = $node->name !== null ? (string) $node->name : null; } elseif ($node instanceof Node\Stmt\TraitUse) { $traitMethodAliases = []; foreach ($node->adaptations as $traitUseAdaptation) { if (!$traitUseAdaptation instanceof Node\Stmt\TraitUseAdaptation\Alias) { continue; } if ($traitUseAdaptation->newName === null) { continue; } $methodName = $traitUseAdaptation->method->toString(); $newTraitName = $traitUseAdaptation->newName->toString(); if ($traitUseAdaptation->trait === null) { foreach ($node->traits as $traitName) { $traitMethodAliases[$traitName->toString()][$methodName] = $newTraitName; } continue; } $traitMethodAliases[$traitUseAdaptation->trait->toString()][$methodName] = $newTraitName; } foreach ($node->traits as $traitName) { /** @var class-string $traitName */ $traitName = (string) $traitName; $reflectionProvider = $this->reflectionProviderProvider->getReflectionProvider(); if (!$reflectionProvider->hasClass($traitName)) { continue; } $traitReflection = $reflectionProvider->getClass($traitName); if (!$traitReflection->isTrait()) { continue; } if ($traitReflection->getFileName() === null) { continue; } if (!is_file($traitReflection->getFileName())) { continue; } $className = $classStack[count($classStack) - 1] ?? null; if ($className === null) { throw new ShouldNotHappenException(); } $phpDocNodeMap = array_merge($phpDocNodeMap, $this->createPhpDocNodeMap($traitReflection->getFileName(), $traitName, $className, $traitMethodAliases[$traitName] ?? [], $originalClassFileName)); } } return null; }, static function (Node $node) use(&$namespace, &$functionStack, &$classStack) : void { if ($node instanceof Node\Stmt\ClassLike) { if (count($classStack) === 0) { throw new ShouldNotHappenException(); } array_pop($classStack); if (count($functionStack) === 0) { throw new ShouldNotHappenException(); } array_pop($functionStack); } elseif ($node instanceof Node\Stmt\Namespace_) { $namespace = null; } elseif ($node instanceof Node\Stmt\ClassMethod || $node instanceof Node\Stmt\Function_) { if (count($functionStack) === 0) { throw new ShouldNotHappenException(); } array_pop($functionStack); } }); return $phpDocNodeMap; } /** * @param array<string, string> $traitMethodAliases * @param array<string, PhpDocNode> $phpDocNodeMap * @return (callable(): NameScope)[] */ private function createNameScopeMap(string $fileName, ?string $lookForTrait, ?string $traitUseClass, array $traitMethodAliases, string $originalClassFileName, array $phpDocNodeMap) : array { /** @var (callable(): NameScope)[] $nameScopeMap */ $nameScopeMap = []; /** @var (callable(): TemplateTypeMap)[] $typeMapStack */ $typeMapStack = []; /** @var array<int, array<string, true>> $typeAliasStack */ $typeAliasStack = []; /** @var string[] $classStack */ $classStack = []; if ($lookForTrait !== null && $traitUseClass !== null) { $classStack[] = $traitUseClass; $typeAliasStack[] = []; } $namespace = null; $traitFound = \false; /** @var array<string|null> $functionStack */ $functionStack = []; $uses = []; $constUses = []; $this->processNodes($this->phpParser->parseFile($fileName), function (Node $node) use($fileName, $lookForTrait, $phpDocNodeMap, &$traitFound, $traitMethodAliases, $originalClassFileName, &$nameScopeMap, &$classStack, &$typeAliasStack, &$namespace, &$functionStack, &$uses, &$typeMapStack, &$constUses) : ?int { if ($node instanceof Node\Stmt\ClassLike) { if ($traitFound && $fileName === $originalClassFileName) { return self::SKIP_NODE; } if ($lookForTrait !== null && !$traitFound) { if (!$node instanceof Node\Stmt\Trait_) { return self::SKIP_NODE; } if ((string) $node->namespacedName !== $lookForTrait) { return self::SKIP_NODE; } $traitFound = \true; $traitNameScopeKey = $this->getNameScopeKey($originalClassFileName, $classStack[count($classStack) - 1] ?? null, $lookForTrait, null); if (array_key_exists($traitNameScopeKey, $phpDocNodeMap)) { $typeAliasStack[] = $this->getTypeAliasesMap($phpDocNodeMap[$traitNameScopeKey]); } else { $typeAliasStack[] = []; } $functionStack[] = null; } else { if ($node->name === null) { if (!$node instanceof Node\Stmt\Class_) { throw new ShouldNotHappenException(); } $className = $this->anonymousClassNameHelper->getAnonymousClassName($node, $fileName); } elseif ($node instanceof Node\Stmt\Class_ && $node->isAnonymous()) { $className = $node->name->name; } else { if ($traitFound) { return self::SKIP_NODE; } $className = ltrim(sprintf('%s\\%s', $namespace, $node->name->name), '\\'); } $classStack[] = $className; $classNameScopeKey = $this->getNameScopeKey($originalClassFileName, $className, $lookForTrait, null); if (array_key_exists($classNameScopeKey, $phpDocNodeMap)) { $typeAliasStack[] = $this->getTypeAliasesMap($phpDocNodeMap[$classNameScopeKey]); } else { $typeAliasStack[] = []; } $functionStack[] = null; } } elseif ($node instanceof Node\Stmt\ClassMethod) { if (array_key_exists($node->name->name, $traitMethodAliases)) { $functionStack[] = $traitMethodAliases[$node->name->name]; } else { $functionStack[] = $node->name->name; } } elseif ($node instanceof Node\Stmt\Function_) { $functionStack[] = ltrim(sprintf('%s\\%s', $namespace, $node->name->name), '\\'); } $className = $classStack[count($classStack) - 1] ?? null; $functionName = $functionStack[count($functionStack) - 1] ?? null; $nameScopeKey = $this->getNameScopeKey($originalClassFileName, $className, $lookForTrait, $functionName); if ($namespace === '') { throw new ShouldNotHappenException('Namespace cannot be empty.'); } if ($node instanceof Node\Stmt\ClassLike || $node instanceof Node\Stmt\ClassMethod || $node instanceof Node\Stmt\Function_) { if (array_key_exists($nameScopeKey, $phpDocNodeMap)) { $phpDocNode = $phpDocNodeMap[$nameScopeKey]; $typeMapStack[] = function () use($namespace, $uses, $className, $lookForTrait, $functionName, $phpDocNode, $typeMapStack, $typeAliasStack, $constUses) : TemplateTypeMap { $typeMapCb = $typeMapStack[count($typeMapStack) - 1] ?? null; $currentTypeMap = $typeMapCb !== null ? $typeMapCb() : null; $typeAliasesMap = $typeAliasStack[count($typeAliasStack) - 1] ?? []; $nameScope = new NameScope($namespace, $uses, $className, $functionName, $currentTypeMap, $typeAliasesMap, \false, $constUses, $lookForTrait); $templateTags = $this->phpDocNodeResolver->resolveTemplateTags($phpDocNode, $nameScope); $templateTypeScope = $nameScope->getTemplateTypeScope(); if ($templateTypeScope === null) { throw new ShouldNotHappenException(); } $templateTypeMap = new TemplateTypeMap(array_map(static function (TemplateTag $tag) use($templateTypeScope) : \PHPStan\Type\Type { return TemplateTypeFactory::fromTemplateTag($templateTypeScope, $tag); }, $templateTags)); $nameScope = $nameScope->withTemplateTypeMap($templateTypeMap); $templateTags = $this->phpDocNodeResolver->resolveTemplateTags($phpDocNode, $nameScope); $templateTypeMap = new TemplateTypeMap(array_map(static function (TemplateTag $tag) use($templateTypeScope) : \PHPStan\Type\Type { return TemplateTypeFactory::fromTemplateTag($templateTypeScope, $tag); }, $templateTags)); return new TemplateTypeMap(array_merge($currentTypeMap !== null ? $currentTypeMap->getTypes() : [], $templateTypeMap->getTypes())); }; } } $typeMapCb = $typeMapStack[count($typeMapStack) - 1] ?? null; $typeAliasesMap = $typeAliasStack[count($typeAliasStack) - 1] ?? []; if ($node instanceof Node\Stmt && !$node instanceof Node\Stmt\Namespace_ && !$node instanceof Node\Stmt\Declare_ && !$node instanceof Node\Stmt\DeclareDeclare && !$node instanceof Node\Stmt\Use_ && !$node instanceof Node\Stmt\UseUse && !$node instanceof Node\Stmt\GroupUse && !$node instanceof Node\Stmt\TraitUse && !$node instanceof Node\Stmt\TraitUseAdaptation && !$node instanceof Node\Stmt\InlineHTML && !($node instanceof Node\Stmt\Expression && $node->expr instanceof Node\Expr\Include_) && !array_key_exists($nameScopeKey, $nameScopeMap)) { $nameScopeMap[$nameScopeKey] = static function () use($namespace, $uses, $className, $functionName, $typeMapCb, $typeAliasesMap, $constUses, $lookForTrait) : NameScope { return new NameScope($namespace, $uses, $className, $functionName, $typeMapCb !== null ? $typeMapCb() : TemplateTypeMap::createEmpty(), $typeAliasesMap, \false, $constUses, $lookForTrait); }; } if ($node instanceof Node\Stmt\ClassLike || $node instanceof Node\Stmt\ClassMethod || $node instanceof Node\Stmt\Function_) { if (array_key_exists($nameScopeKey, $phpDocNodeMap)) { return self::POP_TYPE_MAP_STACK; } return null; } if ($node instanceof Node\Stmt\Namespace_) { $namespace = $node->name !== null ? (string) $node->name : null; } elseif ($node instanceof Node\Stmt\Use_) { if ($node->type === Node\Stmt\Use_::TYPE_NORMAL) { foreach ($node->uses as $use) { $uses[strtolower($use->getAlias()->name)] = (string) $use->name; } } elseif ($node->type === Node\Stmt\Use_::TYPE_CONSTANT) { foreach ($node->uses as $use) { $constUses[strtolower($use->getAlias()->name)] = (string) $use->name; } } } elseif ($node instanceof Node\Stmt\GroupUse) { $prefix = (string) $node->prefix; foreach ($node->uses as $use) { if ($node->type === Node\Stmt\Use_::TYPE_NORMAL || $use->type === Node\Stmt\Use_::TYPE_NORMAL) { $uses[strtolower($use->getAlias()->name)] = sprintf('%s\\%s', $prefix, (string) $use->name); } elseif ($node->type === Node\Stmt\Use_::TYPE_CONSTANT || $use->type === Node\Stmt\Use_::TYPE_CONSTANT) { $constUses[strtolower($use->getAlias()->name)] = sprintf('%s\\%s', $prefix, (string) $use->name); } } } elseif ($node instanceof Node\Stmt\TraitUse) { $traitMethodAliases = []; foreach ($node->adaptations as $traitUseAdaptation) { if (!$traitUseAdaptation instanceof Node\Stmt\TraitUseAdaptation\Alias) { continue; } if ($traitUseAdaptation->newName === null) { continue; } $methodName = $traitUseAdaptation->method->toString(); $newTraitName = $traitUseAdaptation->newName->toString(); if ($traitUseAdaptation->trait === null) { foreach ($node->traits as $traitName) { $traitMethodAliases[$traitName->toString()][$methodName] = $newTraitName; } continue; } $traitMethodAliases[$traitUseAdaptation->trait->toString()][$methodName] = $newTraitName; } $useDocComment = null; if ($node->getDocComment() !== null) { $useDocComment = $node->getDocComment()->getText(); } foreach ($node->traits as $traitName) { /** @var class-string $traitName */ $traitName = (string) $traitName; $reflectionProvider = $this->reflectionProviderProvider->getReflectionProvider(); if (!$reflectionProvider->hasClass($traitName)) { continue; } $traitReflection = $reflectionProvider->getClass($traitName); if (!$traitReflection->isTrait()) { continue; } if ($traitReflection->getFileName() === null) { continue; } if (!is_file($traitReflection->getFileName())) { continue; } $className = $classStack[count($classStack) - 1] ?? null; if ($className === null) { throw new ShouldNotHappenException(); } $traitPhpDocMap = $this->createNameScopeMap($traitReflection->getFileName(), $traitName, $className, $traitMethodAliases[$traitName] ?? [], $originalClassFileName, $phpDocNodeMap); $finalTraitPhpDocMap = []; foreach ($traitPhpDocMap as $nameScopeTraitKey => $callback) { $finalTraitPhpDocMap[$nameScopeTraitKey] = function () use($callback, $traitReflection, $fileName, $className, $lookForTrait, $useDocComment) : NameScope { /** @var NameScope $original */ $original = $callback(); if (!$traitReflection->isGeneric()) { return $original; } $traitTemplateTypeMap = $traitReflection->getTemplateTypeMap(); $useType = null; if ($useDocComment !== null) { $useTags = $this->getResolvedPhpDoc($fileName, $className, $lookForTrait, null, $useDocComment)->getUsesTags(); foreach ($useTags as $useTag) { $useTagType = $useTag->getType(); if (!$useTagType instanceof GenericObjectType) { continue; } if ($useTagType->getClassName() !== $traitReflection->getName()) { continue; } $useType = $useTagType; break; } } if ($useType === null) { return $original->withTemplateTypeMap($traitTemplateTypeMap->resolveToBounds()); } $transformedTraitTypeMap = $traitReflection->typeMapFromList($useType->getTypes()); return $original->withTemplateTypeMap($traitTemplateTypeMap->map(static function (string $name, \PHPStan\Type\Type $type) use($transformedTraitTypeMap) : \PHPStan\Type\Type { return TemplateTypeHelper::resolveTemplateTypes($type, $transformedTraitTypeMap, TemplateTypeVarianceMap::createEmpty(), TemplateTypeVariance::createStatic()); })); }; } $nameScopeMap = array_merge($nameScopeMap, $finalTraitPhpDocMap); } } return null; }, static function (Node $node, $callbackResult) use(&$namespace, &$functionStack, &$classStack, &$typeAliasStack, &$uses, &$typeMapStack, &$constUses) : void { if ($node instanceof Node\Stmt\ClassLike) { if (count($classStack) === 0) { throw new ShouldNotHappenException(); } array_pop($classStack); if (count($typeAliasStack) === 0) { throw new ShouldNotHappenException(); } array_pop($typeAliasStack); if (count($functionStack) === 0) { throw new ShouldNotHappenException(); } array_pop($functionStack); } elseif ($node instanceof Node\Stmt\Namespace_) { $namespace = null; $uses = []; $constUses = []; } elseif ($node instanceof Node\Stmt\ClassMethod || $node instanceof Node\Stmt\Function_) { if (count($functionStack) === 0) { throw new ShouldNotHappenException(); } array_pop($functionStack); } if ($callbackResult !== self::POP_TYPE_MAP_STACK) { return; } if (count($typeMapStack) === 0) { throw new ShouldNotHappenException(); } array_pop($typeMapStack); }); if (count($typeMapStack) > 0) { throw new ShouldNotHappenException(); } return $nameScopeMap; } /** * @return array<string, true> */ private function getTypeAliasesMap(PhpDocNode $phpDocNode) : array { $nameScope = new NameScope(null, []); $aliasesMap = []; foreach (array_keys($this->phpDocNodeResolver->resolveTypeAliasImportTags($phpDocNode, $nameScope)) as $key) { $aliasesMap[$key] = \true; } foreach (array_keys($this->phpDocNodeResolver->resolveTypeAliasTags($phpDocNode, $nameScope)) as $key) { $aliasesMap[$key] = \true; } return $aliasesMap; } /** * @param Node[]|Node|scalar|null $node * @param Closure(Node $node): mixed $nodeCallback * @param Closure(Node $node, mixed $callbackResult): void $endNodeCallback */ private function processNodes($node, Closure $nodeCallback, Closure $endNodeCallback) : void { if ($node instanceof Node) { $callbackResult = $nodeCallback($node); if ($callbackResult === self::SKIP_NODE) { return; } foreach ($node->getSubNodeNames() as $subNodeName) { $subNode = $node->{$subNodeName}; $this->processNodes($subNode, $nodeCallback, $endNodeCallback); } $endNodeCallback($node, $callbackResult); } elseif (is_array($node)) { foreach ($node as $subNode) { $this->processNodes($subNode, $nodeCallback, $endNodeCallback); } } } private function getNameScopeKey(?string $file, ?string $class, ?string $trait, ?string $function) : string { if ($class === null && $trait === null && $function === null) { return md5(sprintf('%s', $file ?? 'no-file')); } if ($class !== null && str_contains($class, 'class@anonymous')) { throw new ShouldNotHappenException('Wrong anonymous class name, FilTypeMapper should be called with ClassReflection::getName().'); } return md5(sprintf('%s-%s-%s-%s', $file ?? 'no-file', $class, $trait, $function)); } } <?php declare (strict_types=1); namespace PHPStan\Type; use PhpParser\Node\Expr\StaticCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\MethodReflection; use PHPStan\Reflection\ParameterReflection; /** * This is the interface for parameter closure type extensions for static methods. * * To register it in the configuration file use the `phpstan.staticMethodParameterClosureTypeExtension` service tag: * * ``` * services: * - * class: App\PHPStan\MyExtension * tags: * - phpstan.staticMethodParameterClosureTypeExtension * ``` * * @api */ interface StaticMethodParameterClosureTypeExtension { public function isStaticMethodSupported(MethodReflection $methodReflection, ParameterReflection $parameter) : bool; public function getTypeFromStaticMethodCall(MethodReflection $methodReflection, StaticCall $methodCall, ParameterReflection $parameter, Scope $scope) : ?\PHPStan\Type\Type; } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\Php\PhpVersion; use PHPStan\PhpDocParser\Ast\Type\GenericTypeNode; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\TrinaryLogic; use PHPStan\Type\Generic\GenericObjectType; use PHPStan\Type\Generic\TemplateMixedType; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\Generic\TemplateTypeVariance; use PHPStan\Type\Traits\MaybeArrayTypeTrait; use PHPStan\Type\Traits\MaybeCallableTypeTrait; use PHPStan\Type\Traits\MaybeObjectTypeTrait; use PHPStan\Type\Traits\MaybeOffsetAccessibleTypeTrait; use PHPStan\Type\Traits\NonGeneralizableTypeTrait; use PHPStan\Type\Traits\UndecidedBooleanTypeTrait; use PHPStan\Type\Traits\UndecidedComparisonCompoundTypeTrait; use Traversable; use function array_merge; use function sprintf; /** @api */ class IterableType implements \PHPStan\Type\CompoundType { /** * @var Type */ private $keyType; /** * @var Type */ private $itemType; use MaybeArrayTypeTrait; use MaybeCallableTypeTrait; use MaybeObjectTypeTrait; use MaybeOffsetAccessibleTypeTrait; use UndecidedBooleanTypeTrait; use UndecidedComparisonCompoundTypeTrait; use NonGeneralizableTypeTrait; /** @api */ public function __construct(\PHPStan\Type\Type $keyType, \PHPStan\Type\Type $itemType) { $this->keyType = $keyType; $this->itemType = $itemType; } public function getKeyType() : \PHPStan\Type\Type { return $this->keyType; } public function getItemType() : \PHPStan\Type\Type { return $this->itemType; } /** * @return string[] */ public function getReferencedClasses() : array { return array_merge($this->keyType->getReferencedClasses(), $this->getItemType()->getReferencedClasses()); } public function getObjectClassNames() : array { return []; } public function getObjectClassReflections() : array { return []; } public function getConstantStrings() : array { return []; } public function accepts(\PHPStan\Type\Type $type, bool $strictTypes) : TrinaryLogic { return $this->acceptsWithReason($type, $strictTypes)->result; } public function acceptsWithReason(\PHPStan\Type\Type $type, bool $strictTypes) : \PHPStan\Type\AcceptsResult { if ($type->isConstantArray()->yes() && $type->isIterableAtLeastOnce()->no()) { return \PHPStan\Type\AcceptsResult::createYes(); } if ($type->isIterable()->yes()) { return $this->getIterableValueType()->acceptsWithReason($type->getIterableValueType(), $strictTypes)->and($this->getIterableKeyType()->acceptsWithReason($type->getIterableKeyType(), $strictTypes)); } if ($type instanceof \PHPStan\Type\CompoundType) { return $type->isAcceptedWithReasonBy($this, $strictTypes); } return \PHPStan\Type\AcceptsResult::createNo(); } public function isSuperTypeOf(\PHPStan\Type\Type $type) : TrinaryLogic { return $this->isSuperTypeOfWithReason($type)->result; } public function isSuperTypeOfWithReason(\PHPStan\Type\Type $type) : \PHPStan\Type\IsSuperTypeOfResult { if ($type instanceof \PHPStan\Type\CompoundType) { return $type->isSubTypeOfWithReason($this); } return (new \PHPStan\Type\IsSuperTypeOfResult($type->isIterable(), []))->and($this->getIterableValueType()->isSuperTypeOfWithReason($type->getIterableValueType()))->and($this->getIterableKeyType()->isSuperTypeOfWithReason($type->getIterableKeyType())); } public function isSuperTypeOfMixed(\PHPStan\Type\Type $type) : TrinaryLogic { return $type->isIterable()->and($this->isNestedTypeSuperTypeOf($this->getIterableValueType(), $type->getIterableValueType()))->and($this->isNestedTypeSuperTypeOf($this->getIterableKeyType(), $type->getIterableKeyType())); } private function isNestedTypeSuperTypeOf(\PHPStan\Type\Type $a, \PHPStan\Type\Type $b) : TrinaryLogic { if (!$a instanceof \PHPStan\Type\MixedType || !$b instanceof \PHPStan\Type\MixedType) { return $a->isSuperTypeOf($b); } if ($a instanceof TemplateMixedType || $b instanceof TemplateMixedType) { return $a->isSuperTypeOf($b); } if ($a->isExplicitMixed()) { if ($b->isExplicitMixed()) { return TrinaryLogic::createYes(); } return TrinaryLogic::createMaybe(); } return TrinaryLogic::createYes(); } public function isSubTypeOf(\PHPStan\Type\Type $otherType) : TrinaryLogic { return $this->isSubTypeOfWithReason($otherType)->result; } public function isSubTypeOfWithReason(\PHPStan\Type\Type $otherType) : \PHPStan\Type\IsSuperTypeOfResult { if ($otherType instanceof \PHPStan\Type\IntersectionType || $otherType instanceof \PHPStan\Type\UnionType) { return $otherType->isSuperTypeOfWithReason(new \PHPStan\Type\UnionType([new \PHPStan\Type\ArrayType($this->keyType, $this->itemType), new \PHPStan\Type\IntersectionType([new \PHPStan\Type\ObjectType(Traversable::class), $this])])); } if ($otherType instanceof self) { $limit = \PHPStan\Type\IsSuperTypeOfResult::createYes(); } else { $limit = \PHPStan\Type\IsSuperTypeOfResult::createMaybe(); } if ($otherType->isConstantArray()->yes() && $otherType->isIterableAtLeastOnce()->no()) { return \PHPStan\Type\IsSuperTypeOfResult::createMaybe(); } return $limit->and(new \PHPStan\Type\IsSuperTypeOfResult($otherType->isIterable(), []), $otherType->getIterableValueType()->isSuperTypeOfWithReason($this->itemType), $otherType->getIterableKeyType()->isSuperTypeOfWithReason($this->keyType)); } public function isAcceptedBy(\PHPStan\Type\Type $acceptingType, bool $strictTypes) : TrinaryLogic { return $this->isAcceptedWithReasonBy($acceptingType, $strictTypes)->result; } public function isAcceptedWithReasonBy(\PHPStan\Type\Type $acceptingType, bool $strictTypes) : \PHPStan\Type\AcceptsResult { return $this->isSubTypeOfWithReason($acceptingType)->toAcceptsResult(); } public function equals(\PHPStan\Type\Type $type) : bool { if (!$type instanceof self) { return \false; } return $this->keyType->equals($type->keyType) && $this->itemType->equals($type->itemType); } public function describe(\PHPStan\Type\VerbosityLevel $level) : string { $isMixedKeyType = $this->keyType instanceof \PHPStan\Type\MixedType && $this->keyType->describe(\PHPStan\Type\VerbosityLevel::precise()) === 'mixed'; $isMixedItemType = $this->itemType instanceof \PHPStan\Type\MixedType && $this->itemType->describe(\PHPStan\Type\VerbosityLevel::precise()) === 'mixed'; if ($isMixedKeyType) { if ($isMixedItemType) { return 'iterable'; } return sprintf('iterable<%s>', $this->itemType->describe($level)); } return sprintf('iterable<%s, %s>', $this->keyType->describe($level), $this->itemType->describe($level)); } public function hasOffsetValueType(\PHPStan\Type\Type $offsetType) : TrinaryLogic { if ($this->getIterableKeyType()->isSuperTypeOf($offsetType)->no()) { return TrinaryLogic::createNo(); } return TrinaryLogic::createMaybe(); } public function toNumber() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toAbsoluteNumber() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toString() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toInteger() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toFloat() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toArray() : \PHPStan\Type\Type { return new \PHPStan\Type\ArrayType($this->keyType, $this->getItemType()); } public function toArrayKey() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function isOffsetAccessLegal() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isIterable() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isIterableAtLeastOnce() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getArraySize() : \PHPStan\Type\Type { return \PHPStan\Type\IntegerRangeType::fromInterval(0, null); } public function getIterableKeyType() : \PHPStan\Type\Type { return $this->keyType; } public function getFirstIterableKeyType() : \PHPStan\Type\Type { return $this->keyType; } public function getLastIterableKeyType() : \PHPStan\Type\Type { return $this->keyType; } public function getIterableValueType() : \PHPStan\Type\Type { return $this->getItemType(); } public function getFirstIterableValueType() : \PHPStan\Type\Type { return $this->getItemType(); } public function getLastIterableValueType() : \PHPStan\Type\Type { return $this->getItemType(); } public function isNull() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isConstantValue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isConstantScalarValue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getConstantScalarTypes() : array { return []; } public function getConstantScalarValues() : array { return []; } public function isTrue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFalse() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isBoolean() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFloat() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isInteger() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isNumericString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isNonEmptyString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isNonFalsyString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isLiteralString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isLowercaseString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isUppercaseString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isClassStringType() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getClassStringObjectType() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function getObjectTypeOrClassStringObjectType() : \PHPStan\Type\Type { return new \PHPStan\Type\ObjectWithoutClassType(); } public function isVoid() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isScalar() : TrinaryLogic { return TrinaryLogic::createNo(); } public function looseCompare(\PHPStan\Type\Type $type, PhpVersion $phpVersion) : \PHPStan\Type\BooleanType { return new \PHPStan\Type\BooleanType(); } public function getEnumCases() : array { return []; } public function inferTemplateTypes(\PHPStan\Type\Type $receivedType) : TemplateTypeMap { if ($receivedType instanceof \PHPStan\Type\UnionType || $receivedType instanceof \PHPStan\Type\IntersectionType) { return $receivedType->inferTemplateTypesOn($this); } if (!$receivedType->isIterable()->yes()) { return TemplateTypeMap::createEmpty(); } $keyTypeMap = $this->getIterableKeyType()->inferTemplateTypes($receivedType->getIterableKeyType()); $valueTypeMap = $this->getIterableValueType()->inferTemplateTypes($receivedType->getIterableValueType()); return $keyTypeMap->union($valueTypeMap); } public function getReferencedTemplateTypes(TemplateTypeVariance $positionVariance) : array { $variance = $positionVariance->compose(TemplateTypeVariance::createCovariant()); return array_merge($this->getIterableKeyType()->getReferencedTemplateTypes($variance), $this->getIterableValueType()->getReferencedTemplateTypes($variance)); } public function traverse(callable $cb) : \PHPStan\Type\Type { $keyType = $cb($this->keyType); $itemType = $cb($this->itemType); if ($keyType !== $this->keyType || $itemType !== $this->itemType) { return new self($keyType, $itemType); } return $this; } public function traverseSimultaneously(\PHPStan\Type\Type $right, callable $cb) : \PHPStan\Type\Type { $keyType = $cb($this->keyType, $right->getIterableKeyType()); $itemType = $cb($this->itemType, $right->getIterableValueType()); if ($keyType !== $this->keyType || $itemType !== $this->itemType) { return new self($keyType, $itemType); } return $this; } public function tryRemove(\PHPStan\Type\Type $typeToRemove) : ?\PHPStan\Type\Type { $arrayType = new \PHPStan\Type\ArrayType(new \PHPStan\Type\MixedType(), new \PHPStan\Type\MixedType()); if ($typeToRemove->isSuperTypeOf($arrayType)->yes()) { return new GenericObjectType(Traversable::class, [$this->getIterableKeyType(), $this->getIterableValueType()]); } $traversableType = new \PHPStan\Type\ObjectType(Traversable::class); if ($typeToRemove->isSuperTypeOf($traversableType)->yes()) { return new \PHPStan\Type\ArrayType($this->getIterableKeyType(), $this->getIterableValueType()); } return null; } public function exponentiate(\PHPStan\Type\Type $exponent) : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function getFiniteTypes() : array { return []; } public function toPhpDocNode() : TypeNode { $isMixedKeyType = $this->keyType instanceof \PHPStan\Type\MixedType && $this->keyType->describe(\PHPStan\Type\VerbosityLevel::precise()) === 'mixed'; $isMixedItemType = $this->itemType instanceof \PHPStan\Type\MixedType && $this->itemType->describe(\PHPStan\Type\VerbosityLevel::precise()) === 'mixed'; if ($isMixedKeyType) { if ($isMixedItemType) { return new IdentifierTypeNode('iterable'); } return new GenericTypeNode(new IdentifierTypeNode('iterable'), [$this->itemType->toPhpDocNode()]); } return new GenericTypeNode(new IdentifierTypeNode('iterable'), [$this->keyType->toPhpDocNode(), $this->itemType->toPhpDocNode()]); } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : \PHPStan\Type\Type { return new self($properties['keyType'], $properties['itemType']); } } <?php declare (strict_types=1); namespace PHPStan\Type; final class GeneralizePrecision { /** * @var int */ private $value; private const LESS_SPECIFIC = 1; private const MORE_SPECIFIC = 2; private const TEMPLATE_ARGUMENT = 3; /** @var self[] */ private static $registry; private function __construct(int $value) { $this->value = $value; } private static function create(int $value) : self { self::$registry[$value] = self::$registry[$value] ?? new self($value); return self::$registry[$value]; } /** @api */ public static function lessSpecific() : self { return self::create(self::LESS_SPECIFIC); } /** @api */ public static function moreSpecific() : self { return self::create(self::MORE_SPECIFIC); } /** @api */ public static function templateArgument() : self { return self::create(self::TEMPLATE_ARGUMENT); } public function isLessSpecific() : bool { return $this->value === self::LESS_SPECIFIC; } public function isMoreSpecific() : bool { return $this->value === self::MORE_SPECIFIC; } public function isTemplateArgument() : bool { return $this->value === self::TEMPLATE_ARGUMENT; } } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\PhpDocParser\Ast\Type\GenericTypeNode; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\Type\Generic\TemplateTypeVariance; use PHPStan\Type\Traits\LateResolvableTypeTrait; use PHPStan\Type\Traits\NonGeneralizableTypeTrait; use function sprintf; /** @api */ final class ValueOfType implements \PHPStan\Type\CompoundType, \PHPStan\Type\LateResolvableType { /** * @var Type */ private $type; use LateResolvableTypeTrait; use NonGeneralizableTypeTrait; public function __construct(\PHPStan\Type\Type $type) { $this->type = $type; } public function getReferencedClasses() : array { return $this->type->getReferencedClasses(); } public function getReferencedTemplateTypes(TemplateTypeVariance $positionVariance) : array { return $this->type->getReferencedTemplateTypes($positionVariance); } public function equals(\PHPStan\Type\Type $type) : bool { return $type instanceof self && $this->type->equals($type->type); } public function describe(\PHPStan\Type\VerbosityLevel $level) : string { return sprintf('value-of<%s>', $this->type->describe($level)); } public function isResolvable() : bool { return !\PHPStan\Type\TypeUtils::containsTemplateType($this->type); } protected function getResult() : \PHPStan\Type\Type { if ($this->type->isEnum()->yes()) { $valueTypes = []; foreach ($this->type->getEnumCases() as $enumCase) { $valueType = $enumCase->getBackingValueType(); if ($valueType === null) { continue; } $valueTypes[] = $valueType; } return \PHPStan\Type\TypeCombinator::union(...$valueTypes); } return $this->type->getIterableValueType(); } /** * @param callable(Type): Type $cb */ public function traverse(callable $cb) : \PHPStan\Type\Type { $type = $cb($this->type); if ($this->type === $type) { return $this; } return new self($type); } public function traverseSimultaneously(\PHPStan\Type\Type $right, callable $cb) : \PHPStan\Type\Type { if (!$right instanceof self) { return $this; } $type = $cb($this->type, $right->type); if ($this->type === $type) { return $this; } return new self($type); } public function toPhpDocNode() : TypeNode { return new GenericTypeNode(new IdentifierTypeNode('value-of'), [$this->type->toPhpDocNode()]); } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : \PHPStan\Type\Type { return new self($properties['type']); } } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\Php\PhpVersion; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\Reflection\ClassMemberAccessAnswerer; use PHPStan\Reflection\ConstantReflection; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\PropertyReflection; use PHPStan\Reflection\Type\UnresolvedMethodPrototypeReflection; use PHPStan\Reflection\Type\UnresolvedPropertyPrototypeReflection; use PHPStan\ShouldNotHappenException; use PHPStan\TrinaryLogic; use PHPStan\Type\Generic\TemplateMixedType; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\Generic\TemplateTypeVariance; use PHPStan\Type\Traits\NonArrayTypeTrait; use PHPStan\Type\Traits\NonGeneralizableTypeTrait; use PHPStan\Type\Traits\NonIterableTypeTrait; use PHPStan\Type\Traits\NonRemoveableTypeTrait; use PHPStan\Type\Traits\UndecidedComparisonCompoundTypeTrait; class StrictMixedType implements \PHPStan\Type\CompoundType { use UndecidedComparisonCompoundTypeTrait; use NonArrayTypeTrait; use NonIterableTypeTrait; use NonRemoveableTypeTrait; use NonGeneralizableTypeTrait; public function getReferencedClasses() : array { return []; } public function getObjectClassNames() : array { return []; } public function getObjectClassReflections() : array { return []; } public function getConstantStrings() : array { return []; } public function accepts(\PHPStan\Type\Type $type, bool $strictTypes) : TrinaryLogic { return $this->acceptsWithReason($type, $strictTypes)->result; } public function acceptsWithReason(\PHPStan\Type\Type $type, bool $strictTypes) : \PHPStan\Type\AcceptsResult { return \PHPStan\Type\AcceptsResult::createYes(); } public function isAcceptedBy(\PHPStan\Type\Type $acceptingType, bool $strictTypes) : TrinaryLogic { return $this->isAcceptedWithReasonBy($acceptingType, $strictTypes)->result; } public function isAcceptedWithReasonBy(\PHPStan\Type\Type $acceptingType, bool $strictTypes) : \PHPStan\Type\AcceptsResult { if ($acceptingType instanceof self) { return \PHPStan\Type\AcceptsResult::createYes(); } if ($acceptingType instanceof \PHPStan\Type\MixedType && !$acceptingType instanceof TemplateMixedType) { return \PHPStan\Type\AcceptsResult::createYes(); } return \PHPStan\Type\AcceptsResult::createMaybe(); } public function isSuperTypeOf(\PHPStan\Type\Type $type) : TrinaryLogic { return $this->isSuperTypeOfWithReason($type)->result; } public function isSuperTypeOfWithReason(\PHPStan\Type\Type $type) : \PHPStan\Type\IsSuperTypeOfResult { return \PHPStan\Type\IsSuperTypeOfResult::createYes(); } public function isSubTypeOf(\PHPStan\Type\Type $otherType) : TrinaryLogic { return $this->isSubTypeOfWithReason($otherType)->result; } public function isSubTypeOfWithReason(\PHPStan\Type\Type $otherType) : \PHPStan\Type\IsSuperTypeOfResult { if ($otherType instanceof self) { return \PHPStan\Type\IsSuperTypeOfResult::createYes(); } if ($otherType instanceof \PHPStan\Type\MixedType && !$otherType instanceof TemplateMixedType) { return \PHPStan\Type\IsSuperTypeOfResult::createYes(); } return \PHPStan\Type\IsSuperTypeOfResult::createMaybe(); } public function equals(\PHPStan\Type\Type $type) : bool { return $type instanceof self; } public function describe(\PHPStan\Type\VerbosityLevel $level) : string { return $level->handle(static function () { return 'mixed'; }, static function () { return 'mixed'; }, static function () { return 'mixed'; }, static function () { return 'strict-mixed'; }); } public function getTemplateType(string $ancestorClassName, string $templateTypeName) : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function isObject() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isEnum() : TrinaryLogic { return TrinaryLogic::createNo(); } public function canAccessProperties() : TrinaryLogic { return TrinaryLogic::createNo(); } public function hasProperty(string $propertyName) : TrinaryLogic { return TrinaryLogic::createNo(); } public function getProperty(string $propertyName, ClassMemberAccessAnswerer $scope) : PropertyReflection { throw new ShouldNotHappenException(); } public function getUnresolvedPropertyPrototype(string $propertyName, ClassMemberAccessAnswerer $scope) : UnresolvedPropertyPrototypeReflection { throw new ShouldNotHappenException(); } public function canCallMethods() : TrinaryLogic { return TrinaryLogic::createNo(); } public function hasMethod(string $methodName) : TrinaryLogic { return TrinaryLogic::createNo(); } public function getMethod(string $methodName, ClassMemberAccessAnswerer $scope) : ExtendedMethodReflection { throw new ShouldNotHappenException(); } public function getUnresolvedMethodPrototype(string $methodName, ClassMemberAccessAnswerer $scope) : UnresolvedMethodPrototypeReflection { throw new ShouldNotHappenException(); } public function canAccessConstants() : TrinaryLogic { return TrinaryLogic::createNo(); } public function hasConstant(string $constantName) : TrinaryLogic { return TrinaryLogic::createNo(); } public function getConstant(string $constantName) : ConstantReflection { throw new ShouldNotHappenException(); } public function isIterable() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isIterableAtLeastOnce() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getIterableKeyType() : \PHPStan\Type\Type { return $this; } public function getIterableValueType() : \PHPStan\Type\Type { return $this; } public function isNull() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isConstantValue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isConstantScalarValue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getConstantScalarTypes() : array { return []; } public function getConstantScalarValues() : array { return []; } public function isTrue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFalse() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isBoolean() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFloat() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isInteger() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isNumericString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isNonEmptyString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isNonFalsyString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isLiteralString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isLowercaseString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isUppercaseString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isClassStringType() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getClassStringObjectType() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function getObjectTypeOrClassStringObjectType() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function isVoid() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isScalar() : TrinaryLogic { return TrinaryLogic::createNo(); } public function looseCompare(\PHPStan\Type\Type $type, PhpVersion $phpVersion) : \PHPStan\Type\BooleanType { return new \PHPStan\Type\BooleanType(); } public function isOffsetAccessible() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isOffsetAccessLegal() : TrinaryLogic { return TrinaryLogic::createNo(); } public function hasOffsetValueType(\PHPStan\Type\Type $offsetType) : TrinaryLogic { return TrinaryLogic::createNo(); } public function getOffsetValueType(\PHPStan\Type\Type $offsetType) : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function setOffsetValueType(?\PHPStan\Type\Type $offsetType, \PHPStan\Type\Type $valueType, bool $unionValues = \true) : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function setExistingOffsetValueType(\PHPStan\Type\Type $offsetType, \PHPStan\Type\Type $valueType) : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function unsetOffset(\PHPStan\Type\Type $offsetType) : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function isCallable() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getCallableParametersAcceptors(ClassMemberAccessAnswerer $scope) : array { return []; } public function isCloneable() : TrinaryLogic { return TrinaryLogic::createNo(); } public function toBoolean() : \PHPStan\Type\BooleanType { return new \PHPStan\Type\BooleanType(); } public function toNumber() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toAbsoluteNumber() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toInteger() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toFloat() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toString() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toArray() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toArrayKey() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function inferTemplateTypes(\PHPStan\Type\Type $receivedType) : TemplateTypeMap { return TemplateTypeMap::createEmpty(); } public function getReferencedTemplateTypes(TemplateTypeVariance $positionVariance) : array { return []; } public function getEnumCases() : array { return []; } public function traverse(callable $cb) : \PHPStan\Type\Type { return $this; } public function traverseSimultaneously(\PHPStan\Type\Type $right, callable $cb) : \PHPStan\Type\Type { return $this; } public function exponentiate(\PHPStan\Type\Type $exponent) : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function getFiniteTypes() : array { return []; } public function toPhpDocNode() : TypeNode { return new IdentifierTypeNode('mixed'); } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : \PHPStan\Type\Type { return new self(); } } <?php declare (strict_types=1); namespace PHPStan\Type; use PhpParser\Node\Expr\StaticCall; use PHPStan\Analyser\Scope; use PHPStan\Analyser\SpecifiedTypes; use PHPStan\Analyser\TypeSpecifierContext; use PHPStan\Reflection\MethodReflection; /** * This is the interface type-specifying extensions implement for static methods. * * To register it in the configuration file use the `phpstan.typeSpecifier.staticMethodTypeSpecifyingExtension` service tag: * * ``` * services: * - * class: App\PHPStan\MyExtension * tags: * - phpstan.typeSpecifier.staticMethodTypeSpecifyingExtension * ``` * * Learn more: https://phpstan.org/developing-extensions/type-specifying-extensions * * @api */ interface StaticMethodTypeSpecifyingExtension { public function getClass() : string; public function isStaticMethodSupported(MethodReflection $staticMethodReflection, StaticCall $node, TypeSpecifierContext $context) : bool; public function specifyTypes(MethodReflection $staticMethodReflection, StaticCall $node, Scope $scope, TypeSpecifierContext $context) : SpecifiedTypes; } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\Type\Constant\ConstantArrayType; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantFloatType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Constant\ConstantStringType; final class StaticTypeFactory { public static function falsey() : \PHPStan\Type\Type { static $falsey; if ($falsey === null) { $falsey = new \PHPStan\Type\UnionType([new \PHPStan\Type\NullType(), new ConstantBooleanType(\false), new ConstantIntegerType(0), new ConstantFloatType(0.0), new ConstantStringType(''), new ConstantStringType('0'), new ConstantArrayType([], [])]); } return $falsey; } public static function truthy() : \PHPStan\Type\Type { static $truthy; if ($truthy === null) { $truthy = new \PHPStan\Type\MixedType(\false, self::falsey()); } return $truthy; } } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\Type\Accessory\AccessoryType; use PHPStan\Type\Accessory\HasPropertyType; use PHPStan\Type\Constant\ConstantArrayType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\Enum\EnumCaseObjectType; use PHPStan\Type\Generic\TemplateBenevolentUnionType; use PHPStan\Type\Generic\TemplateType; use PHPStan\Type\Generic\TemplateUnionType; use function array_merge; use function array_unique; use function array_values; /** * @api * @final */ class TypeUtils { /** * @return ArrayType[] * * @deprecated Use PHPStan\Type\Type::getArrays() instead and handle optional ConstantArrayType keys if necessary. */ public static function getArrays(\PHPStan\Type\Type $type) : array { if ($type instanceof ConstantArrayType) { return $type->getAllArrays(); } if ($type instanceof \PHPStan\Type\ArrayType) { return [$type]; } if ($type instanceof \PHPStan\Type\UnionType) { $matchingTypes = []; foreach ($type->getTypes() as $innerType) { if (!$innerType instanceof \PHPStan\Type\ArrayType) { return []; } foreach (self::getArrays($innerType) as $innerInnerType) { $matchingTypes[] = $innerInnerType; } } return $matchingTypes; } if ($type instanceof \PHPStan\Type\IntersectionType) { $matchingTypes = []; foreach ($type->getTypes() as $innerType) { if (!$innerType instanceof \PHPStan\Type\ArrayType) { continue; } foreach (self::getArrays($innerType) as $innerInnerType) { $matchingTypes[] = $innerInnerType; } } return $matchingTypes; } return []; } /** * @return ConstantArrayType[] * * @deprecated Use PHPStan\Type\Type::getConstantArrays() instead and handle optional keys if necessary. */ public static function getConstantArrays(\PHPStan\Type\Type $type) : array { if ($type instanceof ConstantArrayType) { return $type->getAllArrays(); } if ($type instanceof \PHPStan\Type\UnionType) { $matchingTypes = []; foreach ($type->getTypes() as $innerType) { if (!$innerType instanceof ConstantArrayType) { return []; } foreach (self::getConstantArrays($innerType) as $innerInnerType) { $matchingTypes[] = $innerInnerType; } } return $matchingTypes; } return []; } /** * @return ConstantStringType[] * * @deprecated Use PHPStan\Type\Type::getConstantStrings() instead */ public static function getConstantStrings(\PHPStan\Type\Type $type) : array { return self::map(ConstantStringType::class, $type, \false); } /** * @return ConstantIntegerType[] */ public static function getConstantIntegers(\PHPStan\Type\Type $type) : array { return self::map(ConstantIntegerType::class, $type, \false); } /** * @deprecated Use Type::isConstantValue() or Type::generalize() * @return ConstantType[] */ public static function getConstantTypes(\PHPStan\Type\Type $type) : array { return self::map(\PHPStan\Type\ConstantType::class, $type, \false); } /** * @deprecated Use Type::isConstantValue() or Type::generalize() * @return ConstantType[] */ public static function getAnyConstantTypes(\PHPStan\Type\Type $type) : array { return self::map(\PHPStan\Type\ConstantType::class, $type, \false, \false); } /** * @return ArrayType[] * * @deprecated Use PHPStan\Type\Type::getArrays() instead. */ public static function getAnyArrays(\PHPStan\Type\Type $type) : array { return self::map(\PHPStan\Type\ArrayType::class, $type, \true, \false); } /** * @deprecated Use PHPStan\Type\Type::generalize() instead. */ public static function generalizeType(\PHPStan\Type\Type $type, \PHPStan\Type\GeneralizePrecision $precision) : \PHPStan\Type\Type { return $type->generalize($precision); } /** * @return list<string> * * @deprecated Use Type::getObjectClassNames() instead. */ public static function getDirectClassNames(\PHPStan\Type\Type $type) : array { if ($type instanceof \PHPStan\Type\TypeWithClassName) { return [$type->getClassName()]; } if ($type instanceof \PHPStan\Type\UnionType || $type instanceof \PHPStan\Type\IntersectionType) { $classNames = []; foreach ($type->getTypes() as $innerType) { foreach (self::getDirectClassNames($innerType) as $n) { $classNames[] = $n; } } return array_values(array_unique($classNames)); } return []; } /** * @return IntegerRangeType[] */ public static function getIntegerRanges(\PHPStan\Type\Type $type) : array { return self::map(\PHPStan\Type\IntegerRangeType::class, $type, \false); } /** * @deprecated Use Type::isConstantScalarValue() or Type::getConstantScalarTypes() or Type::getConstantScalarValues() * @return ConstantScalarType[] */ public static function getConstantScalars(\PHPStan\Type\Type $type) : array { return self::map(\PHPStan\Type\ConstantScalarType::class, $type, \false); } /** * @deprecated Use Type::getEnumCases() * @return EnumCaseObjectType[] */ public static function getEnumCaseObjects(\PHPStan\Type\Type $type) : array { return self::map(EnumCaseObjectType::class, $type, \false); } /** * @internal * @return ConstantArrayType[] * * @deprecated Use PHPStan\Type\Type::getConstantArrays(). */ public static function getOldConstantArrays(\PHPStan\Type\Type $type) : array { return self::map(ConstantArrayType::class, $type, \false); } /** * @return mixed[] */ private static function map(string $typeClass, \PHPStan\Type\Type $type, bool $inspectIntersections, bool $stopOnUnmatched = \true) : array { if ($type instanceof $typeClass) { return [$type]; } if ($type instanceof \PHPStan\Type\UnionType) { $matchingTypes = []; foreach ($type->getTypes() as $innerType) { $matchingInner = self::map($typeClass, $innerType, $inspectIntersections, $stopOnUnmatched); if ($matchingInner === []) { if ($stopOnUnmatched) { return []; } continue; } foreach ($matchingInner as $innerMapped) { $matchingTypes[] = $innerMapped; } } return $matchingTypes; } if ($inspectIntersections && $type instanceof \PHPStan\Type\IntersectionType) { $matchingTypes = []; foreach ($type->getTypes() as $innerType) { if (!$innerType instanceof $typeClass) { if ($stopOnUnmatched) { return []; } continue; } $matchingTypes[] = $innerType; } return $matchingTypes; } return []; } public static function toBenevolentUnion(\PHPStan\Type\Type $type) : \PHPStan\Type\Type { if ($type instanceof \PHPStan\Type\BenevolentUnionType) { return $type; } if ($type instanceof \PHPStan\Type\UnionType) { return new \PHPStan\Type\BenevolentUnionType($type->getTypes()); } return $type; } /** * @return ($type is UnionType ? UnionType : Type) */ public static function toStrictUnion(\PHPStan\Type\Type $type) : \PHPStan\Type\Type { if ($type instanceof TemplateBenevolentUnionType) { return new TemplateUnionType($type->getScope(), $type->getStrategy(), $type->getVariance(), $type->getName(), static::toStrictUnion($type->getBound()), $type->getDefault()); } if ($type instanceof \PHPStan\Type\BenevolentUnionType) { return new \PHPStan\Type\UnionType($type->getTypes()); } return $type; } /** * @return Type[] */ public static function flattenTypes(\PHPStan\Type\Type $type) : array { if ($type instanceof ConstantArrayType) { return $type->getAllArrays(); } if ($type instanceof \PHPStan\Type\UnionType) { $types = []; foreach ($type->getTypes() as $innerType) { if ($innerType instanceof ConstantArrayType) { foreach ($innerType->getAllArrays() as $array) { $types[] = $array; } continue; } $types[] = $innerType; } return $types; } return [$type]; } public static function findThisType(\PHPStan\Type\Type $type) : ?\PHPStan\Type\ThisType { if ($type instanceof \PHPStan\Type\ThisType) { return $type; } if ($type instanceof \PHPStan\Type\UnionType || $type instanceof \PHPStan\Type\IntersectionType) { foreach ($type->getTypes() as $innerType) { $thisType = self::findThisType($innerType); if ($thisType !== null) { return $thisType; } } } return null; } /** * @return HasPropertyType[] */ public static function getHasPropertyTypes(\PHPStan\Type\Type $type) : array { if ($type instanceof HasPropertyType) { return [$type]; } if ($type instanceof \PHPStan\Type\UnionType || $type instanceof \PHPStan\Type\IntersectionType) { $hasPropertyTypes = [[]]; foreach ($type->getTypes() as $innerType) { $hasPropertyTypes[] = self::getHasPropertyTypes($innerType); } return array_merge(...$hasPropertyTypes); } return []; } /** * @return AccessoryType[] */ public static function getAccessoryTypes(\PHPStan\Type\Type $type) : array { return self::map(AccessoryType::class, $type, \true, \false); } /** @deprecated Use PHPStan\Type\Type::isCallable() instead. */ public static function containsCallable(\PHPStan\Type\Type $type) : bool { if ($type->isCallable()->yes()) { return \true; } if ($type instanceof \PHPStan\Type\UnionType) { foreach ($type->getTypes() as $innerType) { if ($innerType->isCallable()->yes()) { return \true; } } } return \false; } public static function containsTemplateType(\PHPStan\Type\Type $type) : bool { $containsTemplateType = \false; \PHPStan\Type\TypeTraverser::map($type, static function (\PHPStan\Type\Type $type, callable $traverse) use(&$containsTemplateType) : \PHPStan\Type\Type { if ($type instanceof TemplateType) { $containsTemplateType = \true; } return $containsTemplateType ? $type : $traverse($type); }); return $containsTemplateType; } public static function resolveLateResolvableTypes(\PHPStan\Type\Type $type, bool $resolveUnresolvableTypes = \true) : \PHPStan\Type\Type { /** @var int $ignoreResolveUnresolvableTypesLevel */ $ignoreResolveUnresolvableTypesLevel = 0; return \PHPStan\Type\TypeTraverser::map($type, static function (\PHPStan\Type\Type $type, callable $traverse) use($resolveUnresolvableTypes, &$ignoreResolveUnresolvableTypesLevel) : \PHPStan\Type\Type { while ($type instanceof \PHPStan\Type\LateResolvableType && ($resolveUnresolvableTypes && $ignoreResolveUnresolvableTypesLevel === 0 || $type->isResolvable())) { $type = $type->resolve(); } if ($type instanceof \PHPStan\Type\CallableType || $type instanceof \PHPStan\Type\ClosureType) { $ignoreResolveUnresolvableTypesLevel++; $result = $traverse($type); $ignoreResolveUnresolvableTypesLevel--; return $result; } return $traverse($type); }); } } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\Reflection\ReflectionProviderStaticAccessor; use PHPStan\TrinaryLogic; class StringAlwaysAcceptingObjectWithToStringType extends \PHPStan\Type\StringType { public function isSuperTypeOf(\PHPStan\Type\Type $type) : TrinaryLogic { return $this->isSuperTypeOfWithReason($type)->result; } public function isSuperTypeOfWithReason(\PHPStan\Type\Type $type) : \PHPStan\Type\IsSuperTypeOfResult { if ($type instanceof \PHPStan\Type\CompoundType) { return $type->isSubTypeOfWithReason($this); } $thatClassNames = $type->getObjectClassNames(); if ($thatClassNames === []) { return parent::isSuperTypeOfWithReason($type); } $result = \PHPStan\Type\IsSuperTypeOfResult::createNo(); $reflectionProvider = ReflectionProviderStaticAccessor::getInstance(); foreach ($thatClassNames as $thatClassName) { if (!$reflectionProvider->hasClass($thatClassName)) { return \PHPStan\Type\IsSuperTypeOfResult::createNo(); } $typeClass = $reflectionProvider->getClass($thatClassName); $result = $result->or(\PHPStan\Type\IsSuperTypeOfResult::createFromBoolean($typeClass->hasNativeMethod('__toString'))); } return $result; } public function acceptsWithReason(\PHPStan\Type\Type $type, bool $strictTypes) : \PHPStan\Type\AcceptsResult { $thatClassNames = $type->getObjectClassNames(); if ($thatClassNames === []) { return parent::acceptsWithReason($type, $strictTypes); } $result = \PHPStan\Type\AcceptsResult::createNo(); $reflectionProvider = ReflectionProviderStaticAccessor::getInstance(); foreach ($thatClassNames as $thatClassName) { if (!$reflectionProvider->hasClass($thatClassName)) { return \PHPStan\Type\AcceptsResult::createNo(); } $typeClass = $reflectionProvider->getClass($thatClassName); $result = $result->or(\PHPStan\Type\AcceptsResult::createFromBoolean($typeClass->hasNativeMethod('__toString'))); } return $result; } } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\Php\PhpVersion; use PHPStan\PhpDocParser\Ast\Type\GenericTypeNode; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\Reflection\ClassMemberAccessAnswerer; use PHPStan\Reflection\TrivialParametersAcceptor; use PHPStan\ShouldNotHappenException; use PHPStan\TrinaryLogic; use PHPStan\Type\Accessory\AccessoryArrayListType; use PHPStan\Type\Accessory\HasOffsetType; use PHPStan\Type\Accessory\HasOffsetValueType; use PHPStan\Type\Accessory\NonEmptyArrayType; use PHPStan\Type\Constant\ConstantArrayType; use PHPStan\Type\Constant\ConstantArrayTypeBuilder; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantFloatType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\Generic\TemplateMixedType; use PHPStan\Type\Generic\TemplateStrictMixedType; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\Generic\TemplateTypeVariance; use PHPStan\Type\Traits\MaybeCallableTypeTrait; use PHPStan\Type\Traits\NonGeneralizableTypeTrait; use PHPStan\Type\Traits\NonObjectTypeTrait; use PHPStan\Type\Traits\UndecidedBooleanTypeTrait; use PHPStan\Type\Traits\UndecidedComparisonTypeTrait; use function array_merge; use function count; use function sprintf; /** @api */ class ArrayType implements \PHPStan\Type\Type { /** * @var Type */ private $itemType; use MaybeCallableTypeTrait; use NonObjectTypeTrait; use UndecidedBooleanTypeTrait; use UndecidedComparisonTypeTrait; use NonGeneralizableTypeTrait; /** * @var Type */ private $keyType; /** @api */ public function __construct(\PHPStan\Type\Type $keyType, \PHPStan\Type\Type $itemType) { $this->itemType = $itemType; if ($keyType->describe(\PHPStan\Type\VerbosityLevel::value()) === '(int|string)') { $keyType = new \PHPStan\Type\MixedType(); } if ($keyType instanceof \PHPStan\Type\StrictMixedType && !$keyType instanceof TemplateStrictMixedType) { $keyType = new \PHPStan\Type\UnionType([new \PHPStan\Type\StringType(), new \PHPStan\Type\IntegerType()]); } $this->keyType = $keyType; } public function getKeyType() : \PHPStan\Type\Type { return $this->keyType; } public function getItemType() : \PHPStan\Type\Type { return $this->itemType; } /** * @return string[] */ public function getReferencedClasses() : array { return array_merge($this->keyType->getReferencedClasses(), $this->getItemType()->getReferencedClasses()); } public function getObjectClassNames() : array { return []; } public function getObjectClassReflections() : array { return []; } public function getArrays() : array { return [$this]; } public function getConstantArrays() : array { return []; } public function accepts(\PHPStan\Type\Type $type, bool $strictTypes) : TrinaryLogic { return $this->acceptsWithReason($type, $strictTypes)->result; } public function acceptsWithReason(\PHPStan\Type\Type $type, bool $strictTypes) : \PHPStan\Type\AcceptsResult { if ($type instanceof \PHPStan\Type\CompoundType) { return $type->isAcceptedWithReasonBy($this, $strictTypes); } if ($type instanceof ConstantArrayType) { $result = \PHPStan\Type\AcceptsResult::createYes(); $thisKeyType = $this->keyType; $itemType = $this->getItemType(); foreach ($type->getKeyTypes() as $i => $keyType) { $valueType = $type->getValueTypes()[$i]; $acceptsKey = $thisKeyType->acceptsWithReason($keyType, $strictTypes); $acceptsValue = $itemType->acceptsWithReason($valueType, $strictTypes); $result = $result->and($acceptsKey)->and($acceptsValue); } return $result; } if ($type instanceof \PHPStan\Type\ArrayType) { return $this->getItemType()->acceptsWithReason($type->getItemType(), $strictTypes)->and($this->keyType->acceptsWithReason($type->keyType, $strictTypes)); } return \PHPStan\Type\AcceptsResult::createNo(); } public function isSuperTypeOf(\PHPStan\Type\Type $type) : TrinaryLogic { return $this->isSuperTypeOfWithReason($type)->result; } public function isSuperTypeOfWithReason(\PHPStan\Type\Type $type) : \PHPStan\Type\IsSuperTypeOfResult { if ($type instanceof self) { return $this->getItemType()->isSuperTypeOfWithReason($type->getItemType())->and($this->getIterableKeyType()->isSuperTypeOfWithReason($type->getIterableKeyType())); } if ($type instanceof \PHPStan\Type\CompoundType) { return $type->isSubTypeOfWithReason($this); } return \PHPStan\Type\IsSuperTypeOfResult::createNo(); } public function equals(\PHPStan\Type\Type $type) : bool { return $type instanceof self && $type->isConstantArray()->no() && $this->getItemType()->equals($type->getIterableValueType()) && $this->keyType->equals($type->keyType); } public function describe(\PHPStan\Type\VerbosityLevel $level) : string { $isMixedKeyType = $this->keyType instanceof \PHPStan\Type\MixedType && $this->keyType->describe(\PHPStan\Type\VerbosityLevel::precise()) === 'mixed'; $isMixedItemType = $this->itemType instanceof \PHPStan\Type\MixedType && $this->itemType->describe(\PHPStan\Type\VerbosityLevel::precise()) === 'mixed'; $valueHandler = function () use($level, $isMixedKeyType, $isMixedItemType) : string { if ($isMixedKeyType || $this->keyType instanceof \PHPStan\Type\NeverType) { if ($isMixedItemType || $this->itemType instanceof \PHPStan\Type\NeverType) { return 'array'; } return sprintf('array<%s>', $this->itemType->describe($level)); } return sprintf('array<%s, %s>', $this->keyType->describe($level), $this->itemType->describe($level)); }; return $level->handle($valueHandler, $valueHandler, function () use($level, $isMixedKeyType, $isMixedItemType) : string { if ($isMixedKeyType) { if ($isMixedItemType) { return 'array'; } return sprintf('array<%s>', $this->itemType->describe($level)); } return sprintf('array<%s, %s>', $this->keyType->describe($level), $this->itemType->describe($level)); }); } /** * @deprecated */ public function generalizeKeys() : self { return new self($this->keyType->generalize(\PHPStan\Type\GeneralizePrecision::lessSpecific()), $this->itemType); } public function generalizeValues() : self { return new self($this->keyType, $this->itemType->generalize(\PHPStan\Type\GeneralizePrecision::lessSpecific())); } public function getKeysArray() : \PHPStan\Type\Type { return AccessoryArrayListType::intersectWith(new self(new \PHPStan\Type\IntegerType(), $this->getIterableKeyType())); } public function getValuesArray() : \PHPStan\Type\Type { return AccessoryArrayListType::intersectWith(new self(new \PHPStan\Type\IntegerType(), $this->itemType)); } public function isIterable() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isIterableAtLeastOnce() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getArraySize() : \PHPStan\Type\Type { return \PHPStan\Type\IntegerRangeType::fromInterval(0, null); } public function getIterableKeyType() : \PHPStan\Type\Type { $keyType = $this->keyType; if ($keyType instanceof \PHPStan\Type\MixedType && !$keyType instanceof TemplateMixedType) { return new \PHPStan\Type\BenevolentUnionType([new \PHPStan\Type\IntegerType(), new \PHPStan\Type\StringType()]); } if ($keyType instanceof \PHPStan\Type\StrictMixedType) { return new \PHPStan\Type\BenevolentUnionType([new \PHPStan\Type\IntegerType(), new \PHPStan\Type\StringType()]); } return $keyType; } public function getFirstIterableKeyType() : \PHPStan\Type\Type { return $this->getIterableKeyType(); } public function getLastIterableKeyType() : \PHPStan\Type\Type { return $this->getIterableKeyType(); } public function getIterableValueType() : \PHPStan\Type\Type { return $this->getItemType(); } public function getFirstIterableValueType() : \PHPStan\Type\Type { return $this->getItemType(); } public function getLastIterableValueType() : \PHPStan\Type\Type { return $this->getItemType(); } public function isArray() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isConstantArray() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isOversizedArray() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isList() : TrinaryLogic { if (\PHPStan\Type\IntegerRangeType::fromInterval(0, null)->isSuperTypeOf($this->getKeyType())->no()) { return TrinaryLogic::createNo(); } return TrinaryLogic::createMaybe(); } public function isNull() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isConstantValue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isConstantScalarValue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getConstantScalarTypes() : array { return []; } public function getConstantScalarValues() : array { return []; } public function isTrue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFalse() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isBoolean() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFloat() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isInteger() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isNumericString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isNonEmptyString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isNonFalsyString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isLiteralString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isLowercaseString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isUppercaseString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isClassStringType() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getClassStringObjectType() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function getObjectTypeOrClassStringObjectType() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function isVoid() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isScalar() : TrinaryLogic { return TrinaryLogic::createNo(); } public function looseCompare(\PHPStan\Type\Type $type, PhpVersion $phpVersion) : \PHPStan\Type\BooleanType { return new \PHPStan\Type\BooleanType(); } public function isOffsetAccessible() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isOffsetAccessLegal() : TrinaryLogic { return TrinaryLogic::createYes(); } public function hasOffsetValueType(\PHPStan\Type\Type $offsetType) : TrinaryLogic { $offsetType = $offsetType->toArrayKey(); if ($this->getKeyType()->isSuperTypeOf($offsetType)->no() && ($offsetType->isString()->no() || !$offsetType->isConstantScalarValue()->no())) { return TrinaryLogic::createNo(); } return TrinaryLogic::createMaybe(); } public function getOffsetValueType(\PHPStan\Type\Type $offsetType) : \PHPStan\Type\Type { $offsetType = $offsetType->toArrayKey(); if ($this->getKeyType()->isSuperTypeOf($offsetType)->no() && ($offsetType->isString()->no() || !$offsetType->isConstantScalarValue()->no())) { return new \PHPStan\Type\ErrorType(); } $type = $this->getItemType(); if ($type instanceof \PHPStan\Type\ErrorType) { return new \PHPStan\Type\MixedType(); } return $type; } public function setOffsetValueType(?\PHPStan\Type\Type $offsetType, \PHPStan\Type\Type $valueType, bool $unionValues = \true) : \PHPStan\Type\Type { if ($offsetType === null) { $isKeyTypeInteger = $this->keyType->isInteger(); if ($isKeyTypeInteger->no()) { $offsetType = new \PHPStan\Type\IntegerType(); } elseif ($isKeyTypeInteger->yes()) { $offsetType = $this->keyType; } else { $integerTypes = []; \PHPStan\Type\TypeTraverser::map($this->keyType, static function (\PHPStan\Type\Type $type, callable $traverse) use(&$integerTypes) : \PHPStan\Type\Type { if ($type instanceof \PHPStan\Type\UnionType) { return $traverse($type); } $isInteger = $type->isInteger(); if ($isInteger->yes()) { $integerTypes[] = $type; } return $type; }); if (count($integerTypes) === 0) { $offsetType = $this->keyType; } else { $offsetType = \PHPStan\Type\TypeCombinator::union(...$integerTypes); } } } else { $offsetType = $offsetType->toArrayKey(); } if ($offsetType instanceof ConstantStringType || $offsetType instanceof ConstantIntegerType) { if ($offsetType->isSuperTypeOf($this->keyType)->yes()) { $builder = ConstantArrayTypeBuilder::createEmpty(); $builder->setOffsetValueType($offsetType, $valueType); return $builder->getArray(); } return \PHPStan\Type\TypeCombinator::intersect(new self(\PHPStan\Type\TypeCombinator::union($this->keyType, $offsetType), \PHPStan\Type\TypeCombinator::union($this->itemType, $valueType)), new HasOffsetValueType($offsetType, $valueType), new NonEmptyArrayType()); } return \PHPStan\Type\TypeCombinator::intersect(new self(\PHPStan\Type\TypeCombinator::union($this->keyType, $offsetType), $unionValues ? \PHPStan\Type\TypeCombinator::union($this->itemType, $valueType) : $valueType), new NonEmptyArrayType()); } public function setExistingOffsetValueType(\PHPStan\Type\Type $offsetType, \PHPStan\Type\Type $valueType) : \PHPStan\Type\Type { return new self($this->keyType, \PHPStan\Type\TypeCombinator::union($this->itemType, $valueType)); } public function unsetOffset(\PHPStan\Type\Type $offsetType) : \PHPStan\Type\Type { $offsetType = $offsetType->toArrayKey(); if (($offsetType instanceof ConstantIntegerType || $offsetType instanceof ConstantStringType) && !$this->keyType->isSuperTypeOf($offsetType)->no()) { $keyType = \PHPStan\Type\TypeCombinator::remove($this->keyType, $offsetType); if ($keyType instanceof \PHPStan\Type\NeverType) { return new ConstantArrayType([], []); } return new self($keyType, $this->itemType); } return $this; } public function chunkArray(\PHPStan\Type\Type $lengthType, TrinaryLogic $preserveKeys) : \PHPStan\Type\Type { $chunkType = $preserveKeys->yes() ? $this : AccessoryArrayListType::intersectWith(new \PHPStan\Type\ArrayType(new \PHPStan\Type\IntegerType(), $this->getIterableValueType())); $chunkType = \PHPStan\Type\TypeCombinator::intersect($chunkType, new NonEmptyArrayType()); $arrayType = AccessoryArrayListType::intersectWith(new \PHPStan\Type\ArrayType(new \PHPStan\Type\IntegerType(), $chunkType)); return $this->isIterableAtLeastOnce()->yes() ? \PHPStan\Type\TypeCombinator::intersect($arrayType, new NonEmptyArrayType()) : $arrayType; } public function fillKeysArray(\PHPStan\Type\Type $valueType) : \PHPStan\Type\Type { $itemType = $this->getItemType(); if ($itemType->isInteger()->no()) { $stringKeyType = $itemType->toString(); if ($stringKeyType instanceof \PHPStan\Type\ErrorType) { return $stringKeyType; } return new \PHPStan\Type\ArrayType($stringKeyType, $valueType); } return new \PHPStan\Type\ArrayType($itemType, $valueType); } public function flipArray() : \PHPStan\Type\Type { return new self($this->getIterableValueType()->toArrayKey(), $this->getIterableKeyType()); } public function intersectKeyArray(\PHPStan\Type\Type $otherArraysType) : \PHPStan\Type\Type { $isKeySuperType = $otherArraysType->getIterableKeyType()->isSuperTypeOf($this->getIterableKeyType()); if ($isKeySuperType->no()) { return ConstantArrayTypeBuilder::createEmpty()->getArray(); } if ($isKeySuperType->yes()) { return $this; } return new self($otherArraysType->getIterableKeyType(), $this->getIterableValueType()); } public function popArray() : \PHPStan\Type\Type { return $this; } public function reverseArray(TrinaryLogic $preserveKeys) : \PHPStan\Type\Type { return $this; } public function searchArray(\PHPStan\Type\Type $needleType) : \PHPStan\Type\Type { return \PHPStan\Type\TypeCombinator::union($this->getIterableKeyType(), new ConstantBooleanType(\false)); } public function shiftArray() : \PHPStan\Type\Type { return $this; } public function shuffleArray() : \PHPStan\Type\Type { return AccessoryArrayListType::intersectWith(new self(new \PHPStan\Type\IntegerType(), $this->itemType)); } public function sliceArray(\PHPStan\Type\Type $offsetType, \PHPStan\Type\Type $lengthType, TrinaryLogic $preserveKeys) : \PHPStan\Type\Type { return $this; } public function isCallable() : TrinaryLogic { return TrinaryLogic::createMaybe()->and($this->itemType->isString()); } public function getCallableParametersAcceptors(ClassMemberAccessAnswerer $scope) : array { if ($this->isCallable()->no()) { throw new ShouldNotHappenException(); } return [new TrivialParametersAcceptor()]; } public function toNumber() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toAbsoluteNumber() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toString() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function toInteger() : \PHPStan\Type\Type { return \PHPStan\Type\TypeCombinator::union(new ConstantIntegerType(0), new ConstantIntegerType(1)); } public function toFloat() : \PHPStan\Type\Type { return \PHPStan\Type\TypeCombinator::union(new ConstantFloatType(0.0), new ConstantFloatType(1.0)); } public function toArray() : \PHPStan\Type\Type { return $this; } public function toArrayKey() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } /** @deprecated Use getArraySize() instead */ public function count() : \PHPStan\Type\Type { return $this->getArraySize(); } /** @deprecated Use $offsetType->toArrayKey() instead */ public static function castToArrayKeyType(\PHPStan\Type\Type $offsetType) : \PHPStan\Type\Type { return $offsetType->toArrayKey(); } public function inferTemplateTypes(\PHPStan\Type\Type $receivedType) : TemplateTypeMap { if ($receivedType instanceof \PHPStan\Type\UnionType || $receivedType instanceof \PHPStan\Type\IntersectionType) { return $receivedType->inferTemplateTypesOn($this); } if ($receivedType->isArray()->yes()) { $keyTypeMap = $this->getIterableKeyType()->inferTemplateTypes($receivedType->getIterableKeyType()); $itemTypeMap = $this->getItemType()->inferTemplateTypes($receivedType->getIterableValueType()); return $keyTypeMap->union($itemTypeMap); } return TemplateTypeMap::createEmpty(); } public function getReferencedTemplateTypes(TemplateTypeVariance $positionVariance) : array { $variance = $positionVariance->compose(TemplateTypeVariance::createCovariant()); return array_merge($this->getIterableKeyType()->getReferencedTemplateTypes($variance), $this->getItemType()->getReferencedTemplateTypes($variance)); } public function traverse(callable $cb) : \PHPStan\Type\Type { $keyType = $cb($this->keyType); $itemType = $cb($this->itemType); if ($keyType !== $this->keyType || $itemType !== $this->itemType) { if ($keyType instanceof \PHPStan\Type\NeverType && $itemType instanceof \PHPStan\Type\NeverType) { return new ConstantArrayType([], []); } return new self($keyType, $itemType); } return $this; } public function toPhpDocNode() : TypeNode { $isMixedKeyType = $this->keyType instanceof \PHPStan\Type\MixedType && $this->keyType->describe(\PHPStan\Type\VerbosityLevel::precise()) === 'mixed'; $isMixedItemType = $this->itemType instanceof \PHPStan\Type\MixedType && $this->itemType->describe(\PHPStan\Type\VerbosityLevel::precise()) === 'mixed'; if ($isMixedKeyType) { if ($isMixedItemType) { return new IdentifierTypeNode('array'); } return new GenericTypeNode(new IdentifierTypeNode('array'), [$this->itemType->toPhpDocNode()]); } return new GenericTypeNode(new IdentifierTypeNode('array'), [$this->keyType->toPhpDocNode(), $this->itemType->toPhpDocNode()]); } public function traverseSimultaneously(\PHPStan\Type\Type $right, callable $cb) : \PHPStan\Type\Type { $keyType = $cb($this->keyType, $right->getIterableKeyType()); $itemType = $cb($this->itemType, $right->getIterableValueType()); if ($keyType !== $this->keyType || $itemType !== $this->itemType) { if ($keyType instanceof \PHPStan\Type\NeverType && $itemType instanceof \PHPStan\Type\NeverType) { return new ConstantArrayType([], []); } return new self($keyType, $itemType); } return $this; } public function tryRemove(\PHPStan\Type\Type $typeToRemove) : ?\PHPStan\Type\Type { if ($typeToRemove->isConstantArray()->yes() && $typeToRemove->isIterableAtLeastOnce()->no()) { return \PHPStan\Type\TypeCombinator::intersect($this, new NonEmptyArrayType()); } if ($typeToRemove instanceof NonEmptyArrayType) { return new ConstantArrayType([], []); } if ($this->isConstantArray()->yes() && $typeToRemove instanceof HasOffsetType) { return $this->unsetOffset($typeToRemove->getOffsetType()); } if ($this->isConstantArray()->yes() && $typeToRemove instanceof HasOffsetValueType) { return $this->unsetOffset($typeToRemove->getOffsetType()); } return null; } public function exponentiate(\PHPStan\Type\Type $exponent) : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function getFiniteTypes() : array { return []; } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : \PHPStan\Type\Type { return new self($properties['keyType'], $properties['itemType']); } } <?php declare (strict_types=1); namespace PHPStan\Type; use PhpParser\Node; use PhpParser\Node\Identifier; use PhpParser\Node\Name; use PhpParser\Node\NullableType; use PHPStan\Reflection\ClassReflection; use PHPStan\ShouldNotHappenException; use PHPStan\Type\Constant\ConstantBooleanType; use function get_class; use function in_array; use function strtolower; final class ParserNodeTypeToPHPStanType { /** * @param Node\Name|Node\Identifier|Node\ComplexType|null $type */ public static function resolve($type, ?ClassReflection $classReflection) : \PHPStan\Type\Type { if ($type === null) { return new \PHPStan\Type\MixedType(); } elseif ($type instanceof Name) { $typeClassName = (string) $type; $lowercasedClassName = strtolower($typeClassName); if ($classReflection !== null && in_array($lowercasedClassName, ['self', 'static'], \true)) { if ($lowercasedClassName === 'static') { return new \PHPStan\Type\StaticType($classReflection); } $typeClassName = $classReflection->getName(); } elseif ($lowercasedClassName === 'parent' && $classReflection !== null && $classReflection->getParentClass() !== null) { $typeClassName = $classReflection->getParentClass()->getName(); } return new \PHPStan\Type\ObjectType($typeClassName); } elseif ($type instanceof NullableType) { return \PHPStan\Type\TypeCombinator::addNull(self::resolve($type->type, $classReflection)); } elseif ($type instanceof Node\UnionType) { $types = []; foreach ($type->types as $unionTypeType) { $types[] = self::resolve($unionTypeType, $classReflection); } return \PHPStan\Type\TypeCombinator::union(...$types); } elseif ($type instanceof Node\IntersectionType) { $types = []; foreach ($type->types as $intersectionTypeType) { $innerType = self::resolve($intersectionTypeType, $classReflection); if (!$innerType->isObject()->yes()) { return new \PHPStan\Type\NeverType(); } $types[] = $innerType; } return \PHPStan\Type\TypeCombinator::intersect(...$types); } elseif (!$type instanceof Identifier) { throw new ShouldNotHappenException(get_class($type)); } $type = $type->name; if ($type === 'string') { return new \PHPStan\Type\StringType(); } elseif ($type === 'int') { return new \PHPStan\Type\IntegerType(); } elseif ($type === 'bool') { return new \PHPStan\Type\BooleanType(); } elseif ($type === 'float') { return new \PHPStan\Type\FloatType(); } elseif ($type === 'callable') { return new \PHPStan\Type\CallableType(); } elseif ($type === 'array') { return new \PHPStan\Type\ArrayType(new \PHPStan\Type\MixedType(), new \PHPStan\Type\MixedType()); } elseif ($type === 'iterable') { return new \PHPStan\Type\IterableType(new \PHPStan\Type\MixedType(), new \PHPStan\Type\MixedType()); } elseif ($type === 'void') { return new \PHPStan\Type\VoidType(); } elseif ($type === 'object') { return new \PHPStan\Type\ObjectWithoutClassType(); } elseif ($type === 'true') { return new ConstantBooleanType(\true); } elseif ($type === 'false') { return new ConstantBooleanType(\false); } elseif ($type === 'null') { return new \PHPStan\Type\NullType(); } elseif ($type === 'mixed') { return new \PHPStan\Type\MixedType(\true); } elseif ($type === 'never') { return new \PHPStan\Type\NonAcceptingNeverType(); } return new \PHPStan\Type\MixedType(); } } <?php declare (strict_types=1); namespace PHPStan\Type; /** * This is the extension interface to implement if you want to describe * how arithmetic operators like +, -, *, ^, / should infer types * for PHP extensions that overload the behaviour, like GMP. * * To register it in the configuration file use the `phpstan.broker.operatorTypeSpecifyingExtension` service tag: * * ``` * services: * - * class: App\PHPStan\MyExtension * tags: * - phpstan.broker.operatorTypeSpecifyingExtension * ``` * * Learn more: https://github.com/phpstan/phpstan/pull/2114 * * @api */ interface OperatorTypeSpecifyingExtension { public function isOperatorSupported(string $operatorSigil, \PHPStan\Type\Type $leftSide, \PHPStan\Type\Type $rightSide) : bool; public function specifyType(string $operatorSigil, \PHPStan\Type\Type $leftSide, \PHPStan\Type\Type $rightSide) : \PHPStan\Type\Type; } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\Php\PhpVersion; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\TrinaryLogic; use PHPStan\Type\Constant\ConstantArrayType; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantFloatType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\Traits\NonArrayTypeTrait; use PHPStan\Type\Traits\NonCallableTypeTrait; use PHPStan\Type\Traits\NonGeneralizableTypeTrait; use PHPStan\Type\Traits\NonGenericTypeTrait; use PHPStan\Type\Traits\NonIterableTypeTrait; use PHPStan\Type\Traits\NonObjectTypeTrait; use PHPStan\Type\Traits\NonOffsetAccessibleTypeTrait; use PHPStan\Type\Traits\UndecidedBooleanTypeTrait; use PHPStan\Type\Traits\UndecidedComparisonTypeTrait; /** @api */ class BooleanType implements \PHPStan\Type\Type { use \PHPStan\Type\JustNullableTypeTrait; use NonArrayTypeTrait; use NonCallableTypeTrait; use NonIterableTypeTrait; use NonObjectTypeTrait; use UndecidedBooleanTypeTrait; use UndecidedComparisonTypeTrait; use NonGenericTypeTrait; use NonOffsetAccessibleTypeTrait; use NonGeneralizableTypeTrait; /** @api */ public function __construct() { } public function getConstantStrings() : array { return []; } public function describe(\PHPStan\Type\VerbosityLevel $level) : string { return 'bool'; } public function toNumber() : \PHPStan\Type\Type { return $this->toInteger(); } public function toAbsoluteNumber() : \PHPStan\Type\Type { return $this->toNumber()->toAbsoluteNumber(); } public function toString() : \PHPStan\Type\Type { return \PHPStan\Type\TypeCombinator::union(new ConstantStringType(''), new ConstantStringType('1')); } public function toInteger() : \PHPStan\Type\Type { return \PHPStan\Type\TypeCombinator::union(new ConstantIntegerType(0), new ConstantIntegerType(1)); } public function toFloat() : \PHPStan\Type\Type { return \PHPStan\Type\TypeCombinator::union(new ConstantFloatType(0.0), new ConstantFloatType(1.0)); } public function toArray() : \PHPStan\Type\Type { return new ConstantArrayType([new ConstantIntegerType(0)], [$this], [1], [], TrinaryLogic::createYes()); } public function toArrayKey() : \PHPStan\Type\Type { return new \PHPStan\Type\UnionType([new ConstantIntegerType(0), new ConstantIntegerType(1)]); } public function isOffsetAccessLegal() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isNull() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isTrue() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isFalse() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isBoolean() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isScalar() : TrinaryLogic { return TrinaryLogic::createYes(); } public function looseCompare(\PHPStan\Type\Type $type, PhpVersion $phpVersion) : \PHPStan\Type\BooleanType { return new \PHPStan\Type\BooleanType(); } public function tryRemove(\PHPStan\Type\Type $typeToRemove) : ?\PHPStan\Type\Type { if ($typeToRemove instanceof ConstantBooleanType) { return new ConstantBooleanType(!$typeToRemove->getValue()); } return null; } public function getFiniteTypes() : array { return [new ConstantBooleanType(\true), new ConstantBooleanType(\false)]; } public function exponentiate(\PHPStan\Type\Type $exponent) : \PHPStan\Type\Type { return \PHPStan\Type\ExponentiateHelper::exponentiate($this, $exponent); } public function toPhpDocNode() : TypeNode { return new IdentifierTypeNode('bool'); } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : \PHPStan\Type\Type { return new self(); } } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\Php\PhpVersion; use PHPStan\Type\Constant\ConstantBooleanType; final class LooseComparisonHelper { public static function compareConstantScalars(\PHPStan\Type\ConstantScalarType $leftType, \PHPStan\Type\ConstantScalarType $rightType, PhpVersion $phpVersion) : \PHPStan\Type\BooleanType { if ($phpVersion->castsNumbersToStringsOnLooseComparison()) { $isNumber = new \PHPStan\Type\UnionType([new \PHPStan\Type\IntegerType(), new \PHPStan\Type\FloatType()]); if ($leftType->isString()->yes() && $leftType->isNumericString()->no() && $isNumber->isSuperTypeOf($rightType)->yes()) { $stringValue = (string) $rightType->getValue(); return new ConstantBooleanType($stringValue === $leftType->getValue()); } if ($rightType->isString()->yes() && $rightType->isNumericString()->no() && $isNumber->isSuperTypeOf($leftType)->yes()) { $stringValue = (string) $leftType->getValue(); return new ConstantBooleanType($stringValue === $rightType->getValue()); } } else { if ($leftType->isString()->yes() && $leftType->isNumericString()->no() && $rightType->isFloat()->yes()) { $numericPart = (float) $leftType->getValue(); return new ConstantBooleanType($numericPart === $rightType->getValue()); } if ($rightType->isString()->yes() && $rightType->isNumericString()->no() && $leftType->isFloat()->yes()) { $numericPart = (float) $rightType->getValue(); return new ConstantBooleanType($numericPart === $leftType->getValue()); } if ($leftType->isString()->yes() && $leftType->isNumericString()->no() && $rightType->isInteger()->yes()) { $numericPart = (int) $leftType->getValue(); return new ConstantBooleanType($numericPart === $rightType->getValue()); } if ($rightType->isString()->yes() && $rightType->isNumericString()->no() && $leftType->isInteger()->yes()) { $numericPart = (int) $rightType->getValue(); return new ConstantBooleanType($numericPart === $leftType->getValue()); } } // @phpstan-ignore equal.notAllowed return new ConstantBooleanType($leftType->getValue() == $rightType->getValue()); // phpcs:ignore } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\ParametersAcceptorSelector; use PHPStan\Type\Accessory\AccessoryLowercaseStringType; use PHPStan\Type\Accessory\AccessoryNonEmptyStringType; use PHPStan\Type\Accessory\AccessoryNonFalsyStringType; use PHPStan\Type\Accessory\AccessoryUppercaseStringType; use PHPStan\Type\Constant\ConstantArrayTypeBuilder; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\IntersectionType; use PHPStan\Type\MixedType; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\TypeUtils; use function array_key_exists; use function count; use function in_array; final class ReplaceFunctionsDynamicReturnTypeExtension implements DynamicFunctionReturnTypeExtension { private const FUNCTIONS_SUBJECT_POSITION = ['preg_replace' => 2, 'preg_replace_callback' => 2, 'preg_replace_callback_array' => 1, 'str_replace' => 2, 'str_ireplace' => 2, 'substr_replace' => 0, 'strtr' => 0]; private const FUNCTIONS_REPLACE_POSITION = ['preg_replace' => 1, 'str_replace' => 1, 'str_ireplace' => 1, 'substr_replace' => 1, 'strtr' => 2]; public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return array_key_exists($functionReflection->getName(), self::FUNCTIONS_SUBJECT_POSITION); } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : Type { $type = $this->getPreliminarilyResolvedTypeFromFunctionCall($functionReflection, $functionCall, $scope); if ($this->canReturnNull($functionReflection, $functionCall, $scope)) { $type = TypeCombinator::addNull($type); } return $type; } private function getPreliminarilyResolvedTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : Type { $subjectArgumentType = $this->getSubjectType($functionReflection, $functionCall, $scope); $defaultReturnType = ParametersAcceptorSelector::selectFromArgs($scope, $functionCall->getArgs(), $functionReflection->getVariants())->getReturnType(); if ($subjectArgumentType === null) { return $defaultReturnType; } if ($subjectArgumentType instanceof MixedType) { return TypeUtils::toBenevolentUnion($defaultReturnType); } if (array_key_exists($functionReflection->getName(), self::FUNCTIONS_REPLACE_POSITION)) { $replaceArgumentPosition = self::FUNCTIONS_REPLACE_POSITION[$functionReflection->getName()]; if (count($functionCall->getArgs()) > $replaceArgumentPosition) { $replaceArgumentType = $scope->getType($functionCall->getArgs()[$replaceArgumentPosition]->value); $accessories = []; if ($subjectArgumentType->isNonFalsyString()->yes() && $replaceArgumentType->isNonFalsyString()->yes()) { $accessories[] = new AccessoryNonFalsyStringType(); } elseif ($subjectArgumentType->isNonEmptyString()->yes() && $replaceArgumentType->isNonEmptyString()->yes()) { $accessories[] = new AccessoryNonEmptyStringType(); } if ($subjectArgumentType->isLowercaseString()->yes() && $replaceArgumentType->isLowercaseString()->yes()) { $accessories[] = new AccessoryLowercaseStringType(); } if ($subjectArgumentType->isUppercaseString()->yes() && $replaceArgumentType->isUppercaseString()->yes()) { $accessories[] = new AccessoryUppercaseStringType(); } if (count($accessories) > 0) { $accessories[] = new StringType(); return new IntersectionType($accessories); } } } $isStringSuperType = $subjectArgumentType->isString(); $isArraySuperType = $subjectArgumentType->isArray(); $compareSuperTypes = $isStringSuperType->compareTo($isArraySuperType); if ($compareSuperTypes === $isStringSuperType) { return new StringType(); } elseif ($compareSuperTypes === $isArraySuperType) { $subjectArrays = $subjectArgumentType->getArrays(); if (count($subjectArrays) > 0) { $result = []; foreach ($subjectArrays as $arrayType) { $constantArrays = $arrayType->getConstantArrays(); if ($constantArrays !== [] && in_array($functionReflection->getName(), ['preg_replace', 'preg_replace_callback', 'preg_replace_callback_array'], \true)) { foreach ($constantArrays as $constantArray) { $generalizedArray = $constantArray->generalizeValues(); $builder = ConstantArrayTypeBuilder::createEmpty(); // turn all keys optional foreach ($constantArray->getKeyTypes() as $keyType) { $builder->setOffsetValueType($keyType, $generalizedArray->getOffsetValueType($keyType), \true); } $result[] = $builder->getArray(); } continue; } $result[] = $arrayType->generalizeValues(); } return TypeCombinator::union(...$result); } return $subjectArgumentType; } return $defaultReturnType; } private function getSubjectType(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { $argumentPosition = self::FUNCTIONS_SUBJECT_POSITION[$functionReflection->getName()]; if (count($functionCall->getArgs()) <= $argumentPosition) { return null; } return $scope->getType($functionCall->getArgs()[$argumentPosition]->value); } private function canReturnNull(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : bool { if (in_array($functionReflection->getName(), ['preg_replace', 'preg_replace_callback', 'preg_replace_callback_array'], \true) && count($functionCall->getArgs()) > 0) { $subjectArgumentType = $this->getSubjectType($functionReflection, $functionCall, $scope); if ($subjectArgumentType !== null && $subjectArgumentType->isArray()->yes()) { return \false; } } $possibleTypes = ParametersAcceptorSelector::selectFromArgs($scope, $functionCall->getArgs(), $functionReflection->getVariants())->getReturnType(); // resolve conditional return types $possibleTypes = TypeUtils::resolveLateResolvableTypes($possibleTypes); return TypeCombinator::containsNull($possibleTypes); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\BinaryOp\Pow; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\Type; use function count; final class PowFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'pow'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (count($functionCall->getArgs()) < 2) { return null; } return $scope->getType(new Pow($functionCall->getArgs()[0]->value, $functionCall->getArgs()[1]->value)); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\IntegerRangeType; use PHPStan\Type\NeverType; use PHPStan\Type\NullType; use PHPStan\Type\Type; use function count; final class ArrayChunkFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { /** * @var PhpVersion */ private $phpVersion; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; } public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'array_chunk'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (count($functionCall->getArgs()) < 2) { return null; } $arrayType = $scope->getType($functionCall->getArgs()[0]->value); if ($arrayType->isArray()->no()) { return $this->phpVersion->arrayFunctionsReturnNullWithNonArray() ? new NullType() : new NeverType(); } $lengthType = $scope->getType($functionCall->getArgs()[1]->value); $negativeOrZero = IntegerRangeType::fromInterval(null, 0); if ($negativeOrZero->isSuperTypeOf($lengthType)->yes()) { return $this->phpVersion->throwsValueErrorForInternalFunctions() ? new NeverType() : new NullType(); } $preserveKeysType = isset($functionCall->getArgs()[2]) ? $scope->getType($functionCall->getArgs()[2]->value) : new ConstantBooleanType(\false); return $arrayType->chunkArray($lengthType, $preserveKeysType->isTrue()); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\NullType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; final class ArrayShiftFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'array_shift'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (!isset($functionCall->getArgs()[0])) { return null; } $argType = $scope->getType($functionCall->getArgs()[0]->value); $iterableAtLeastOnce = $argType->isIterableAtLeastOnce(); if ($iterableAtLeastOnce->no()) { return new NullType(); } $itemType = $argType->getFirstIterableValueType(); if ($iterableAtLeastOnce->yes()) { return $itemType; } return TypeCombinator::union($itemType, new NullType()); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\BenevolentUnionType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\FloatType; use PHPStan\Type\MixedType; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\UnionType; use function count; final class MicrotimeFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'microtime'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : Type { if (count($functionCall->getArgs()) < 1) { return new StringType(); } $argType = $scope->getType($functionCall->getArgs()[0]->value); $isTrueType = $argType->isTrue(); $isFalseType = $argType->isFalse(); $compareTypes = $isTrueType->compareTo($isFalseType); if ($compareTypes === $isTrueType) { return new FloatType(); } if ($compareTypes === $isFalseType) { return new StringType(); } if ($argType instanceof MixedType) { return new BenevolentUnionType([new StringType(), new FloatType()]); } return new UnionType([new StringType(), new FloatType()]); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\ParametersAcceptorSelector; use PHPStan\ShouldNotHappenException; use PHPStan\Type\BooleanType; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\FloatType; use PHPStan\Type\IntegerRangeType; use PHPStan\Type\IntegerType; use PHPStan\Type\NeverType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function array_map; use function array_merge; use function array_unique; use function count; use function in_array; use function max; use function mb_internal_encoding; use function mb_strlen; use function min; use function range; use function sort; use function sprintf; use function var_export; final class MbStrlenFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { /** * @var PhpVersion */ private $phpVersion; private const UNSUPPORTED_ENCODING = 'unsupported'; use \PHPStan\Type\Php\MbFunctionsReturnTypeExtensionTrait; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; } public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'mb_strlen'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { $args = $functionCall->getArgs(); if (count($args) === 0) { return null; } $encodings = []; if (count($functionCall->getArgs()) === 1) { // there is a chance to get an unsupported encoding 'pass' or 'none' here on PHP 7.3-7.4 $encodings = [mb_internal_encoding()]; } elseif (count($functionCall->getArgs()) === 2) { // custom encoding is specified $encodings = array_map(static function (ConstantStringType $t) { return $t->getValue(); }, $scope->getType($functionCall->getArgs()[1]->value)->getConstantStrings()); } if (count($encodings) > 0) { for ($i = 0; $i < count($encodings); $i++) { if ($this->isSupportedEncoding($encodings[$i])) { continue; } $encodings[$i] = self::UNSUPPORTED_ENCODING; } $encodings = array_unique($encodings); if (in_array(self::UNSUPPORTED_ENCODING, $encodings, \true) && count($encodings) === 1) { if ($this->phpVersion->throwsOnInvalidMbStringEncoding()) { return new NeverType(); } return new ConstantBooleanType(\false); } } else { // if there aren't encoding constants, use all available encodings $encodings = array_merge($this->getSupportedEncodings(), [self::UNSUPPORTED_ENCODING]); } $argType = $scope->getType($args[0]->value); if ($argType->isSuperTypeOf(new BooleanType())->yes()) { $constantScalars = TypeCombinator::remove($argType, new BooleanType())->getConstantScalarTypes(); if (count($constantScalars) > 0) { $constantScalars[] = new ConstantBooleanType(\true); $constantScalars[] = new ConstantBooleanType(\false); } } else { $constantScalars = $argType->getConstantScalarTypes(); } $lengths = []; foreach ($constantScalars as $constantScalar) { $stringScalar = $constantScalar->toString(); if (!$stringScalar instanceof ConstantStringType) { $lengths = []; break; } foreach ($encodings as $encoding) { if (!$this->isSupportedEncoding($encoding)) { continue; } $length = @mb_strlen($stringScalar->getValue(), $encoding); if ($length === \false) { throw new ShouldNotHappenException(sprintf('Got false on a supported encoding %s and value %s', $encoding, var_export($stringScalar->getValue(), \true))); } $lengths[] = $length; } } $isNonEmpty = $argType->isNonEmptyString(); $numeric = TypeCombinator::union(new IntegerType(), new FloatType()); if (count($lengths) > 0) { $lengths = array_unique($lengths); sort($lengths); if ($lengths === range(min($lengths), max($lengths))) { $range = IntegerRangeType::fromInterval(min($lengths), max($lengths)); } else { $range = TypeCombinator::union(...array_map(static function ($l) { return new ConstantIntegerType($l); }, $lengths)); } } elseif ($argType->isBoolean()->yes()) { $range = IntegerRangeType::fromInterval(0, 1); } elseif ($isNonEmpty->yes() || $numeric->isSuperTypeOf($argType)->yes() || TypeCombinator::remove($argType, $numeric)->isNonEmptyString()->yes()) { $range = IntegerRangeType::fromInterval(1, null); } elseif ($argType->isString()->yes() && $isNonEmpty->no()) { $range = new ConstantIntegerType(0); } else { $range = TypeCombinator::remove(ParametersAcceptorSelector::selectFromArgs($scope, $functionCall->getArgs(), $functionReflection->getVariants())->getReturnType(), new ConstantBooleanType(\false)); } if (!$this->phpVersion->throwsOnInvalidMbStringEncoding() && in_array(self::UNSUPPORTED_ENCODING, $encodings, \true)) { return TypeCombinator::union($range, new ConstantBooleanType(\false)); } return $range; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\MethodCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\MethodReflection; use PHPStan\Type\DynamicMethodReturnTypeExtension; use PHPStan\Type\Type; use PHPStan\Type\TypeWithClassName; use function count; use function in_array; final class DsMapDynamicReturnTypeExtension implements DynamicMethodReturnTypeExtension { public function getClass() : string { return 'Ds\\Map'; } public function isMethodSupported(MethodReflection $methodReflection) : bool { return in_array($methodReflection->getName(), ['get', 'remove'], \true); } public function getTypeFromMethodCall(MethodReflection $methodReflection, MethodCall $methodCall, Scope $scope) : ?Type { $argsCount = count($methodCall->getArgs()); if ($argsCount > 1) { return null; } if ($argsCount === 0) { return null; } $mapType = $scope->getType($methodCall->var); if (!$mapType instanceof TypeWithClassName) { return null; } $mapAncestor = $mapType->getAncestorWithClassName('Ds\\Map'); if ($mapAncestor === null) { return null; } $mapAncestorClass = $mapAncestor->getClassReflection(); if ($mapAncestorClass === null) { return null; } $valueType = $mapAncestorClass->getActiveTemplateTypeMap()->getType('TValue'); if ($valueType === null) { return null; } return $valueType; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\BooleanType; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\FloatType; use PHPStan\Type\IntegerRangeType; use PHPStan\Type\IntegerType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function array_map; use function array_unique; use function count; use function max; use function min; use function range; use function sort; use function strlen; final class StrlenFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'strlen'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { $args = $functionCall->getArgs(); if (count($args) === 0) { return null; } $argType = $scope->getType($args[0]->value); if ($argType->isSuperTypeOf(new BooleanType())->yes()) { $constantScalars = TypeCombinator::remove($argType, new BooleanType())->getConstantScalarTypes(); if (count($constantScalars) > 0) { $constantScalars[] = new ConstantBooleanType(\true); $constantScalars[] = new ConstantBooleanType(\false); } } else { $constantScalars = $argType->getConstantScalarTypes(); } $lengths = []; foreach ($constantScalars as $constantScalar) { $stringScalar = $constantScalar->toString(); if (!$stringScalar instanceof ConstantStringType) { $lengths = []; break; } $length = strlen($stringScalar->getValue()); $lengths[] = $length; } $isNonEmpty = $argType->isNonEmptyString(); $numeric = TypeCombinator::union(new IntegerType(), new FloatType()); $range = null; if (count($lengths) > 0) { $lengths = array_unique($lengths); sort($lengths); if ($lengths === range(min($lengths), max($lengths))) { $range = IntegerRangeType::fromInterval(min($lengths), max($lengths)); } else { $range = TypeCombinator::union(...array_map(static function ($l) { return new ConstantIntegerType($l); }, $lengths)); } } elseif ($argType->isBoolean()->yes()) { $range = IntegerRangeType::fromInterval(0, 1); } elseif ($isNonEmpty->yes() || $numeric->isSuperTypeOf($argType)->yes() || TypeCombinator::remove($argType, $numeric)->isNonEmptyString()->yes()) { $range = IntegerRangeType::fromInterval(1, null); } elseif ($argType->isString()->yes() && $isNonEmpty->no()) { $range = new ConstantIntegerType(0); } return $range; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PhpParser\Node\Name\FullyQualified; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\ParametersAcceptorSelector; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Type\BitwiseFlagHelper; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\ConstantScalarType; use PHPStan\Type\ConstantTypeHelper; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\ObjectWithoutClassType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function is_bool; use function json_decode; final class JsonThrowOnErrorDynamicReturnTypeExtension implements DynamicFunctionReturnTypeExtension { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var BitwiseFlagHelper */ private $bitwiseFlagAnalyser; /** @var array<string, int> */ private $argumentPositions = ['json_encode' => 1, 'json_decode' => 3]; public function __construct(ReflectionProvider $reflectionProvider, BitwiseFlagHelper $bitwiseFlagAnalyser) { $this->reflectionProvider = $reflectionProvider; $this->bitwiseFlagAnalyser = $bitwiseFlagAnalyser; } public function isFunctionSupported(FunctionReflection $functionReflection) : bool { if ($functionReflection->getName() === 'json_decode') { return \true; } return $functionReflection->getName() === 'json_encode' && $this->reflectionProvider->hasConstant(new FullyQualified('JSON_THROW_ON_ERROR'), null); } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : Type { $argumentPosition = $this->argumentPositions[$functionReflection->getName()]; $defaultReturnType = ParametersAcceptorSelector::selectFromArgs($scope, $functionCall->getArgs(), $functionReflection->getVariants())->getReturnType(); if ($functionReflection->getName() === 'json_decode') { $defaultReturnType = $this->narrowTypeForJsonDecode($functionCall, $scope, $defaultReturnType); } if (!isset($functionCall->getArgs()[$argumentPosition])) { return $defaultReturnType; } $optionsExpr = $functionCall->getArgs()[$argumentPosition]->value; if ($functionReflection->getName() === 'json_encode' && $this->bitwiseFlagAnalyser->bitwiseOrContainsConstant($optionsExpr, $scope, 'JSON_THROW_ON_ERROR')->yes()) { return TypeCombinator::remove($defaultReturnType, new ConstantBooleanType(\false)); } return $defaultReturnType; } private function narrowTypeForJsonDecode(FuncCall $funcCall, Scope $scope, Type $fallbackType) : Type { $args = $funcCall->getArgs(); $isForceArray = $this->isForceArray($funcCall, $scope); if (!isset($args[0])) { return $fallbackType; } $firstValueType = $scope->getType($args[0]->value); if ($firstValueType instanceof ConstantStringType) { return $this->resolveConstantStringType($firstValueType, $isForceArray); } if ($isForceArray) { return TypeCombinator::remove($fallbackType, new ObjectWithoutClassType()); } return $fallbackType; } /** * Is "json_decode(..., true)"? */ private function isForceArray(FuncCall $funcCall, Scope $scope) : bool { $args = $funcCall->getArgs(); if (!isset($args[1])) { return \false; } $secondArgType = $scope->getType($args[1]->value); $secondArgValue = $secondArgType instanceof ConstantScalarType ? $secondArgType->getValue() : null; if (is_bool($secondArgValue)) { return $secondArgValue; } if ($secondArgValue !== null || !isset($args[3])) { return \false; } // depends on used constants, @see https://www.php.net/manual/en/json.constants.php#constant.json-object-as-array return $this->bitwiseFlagAnalyser->bitwiseOrContainsConstant($args[3]->value, $scope, 'JSON_OBJECT_AS_ARRAY')->yes(); } private function resolveConstantStringType(ConstantStringType $constantStringType, bool $isForceArray) : Type { $decodedValue = json_decode($constantStringType->getValue(), $isForceArray); return ConstantTypeHelper::getTypeFromValue($decodedValue); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\NeverType; use PHPStan\Type\NullType; use PHPStan\Type\Type; use function count; final class ArraySliceFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { /** * @var PhpVersion */ private $phpVersion; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; } public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'array_slice'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { $args = $functionCall->getArgs(); if (count($args) < 2) { return null; } $arrayType = $scope->getType($args[0]->value); if ($arrayType->isArray()->no()) { return $this->phpVersion->arrayFunctionsReturnNullWithNonArray() ? new NullType() : new NeverType(); } $offsetType = $scope->getType($args[1]->value); $lengthType = isset($args[2]) ? $scope->getType($args[2]->value) : new NullType(); $preserveKeysType = isset($args[3]) ? $scope->getType($args[3]->value) : new ConstantBooleanType(\false); return $arrayType->sliceArray($offsetType, $lengthType, $preserveKeysType->isTrue()); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\NeverType; use PHPStan\Type\NullType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function array_slice; use function count; final class ArrayIntersectKeyFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { /** * @var PhpVersion */ private $phpVersion; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; } public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'array_intersect_key'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { $args = $functionCall->getArgs(); if (count($args) === 0) { return null; } $argTypes = []; foreach ($args as $arg) { $argType = $scope->getType($arg->value); if ($arg->unpack) { $argTypes[] = $argType->getIterableValueType(); continue; } $argTypes[] = $argType; } $firstArrayType = $argTypes[0]; $otherArraysType = TypeCombinator::union(...array_slice($argTypes, 1)); $onlyOneArrayGiven = count($argTypes) === 1; if ($firstArrayType->isArray()->no() || !$onlyOneArrayGiven && $otherArraysType->isArray()->no()) { return $this->phpVersion->arrayFunctionsReturnNullWithNonArray() ? new NullType() : new NeverType(); } if ($onlyOneArrayGiven) { return $firstArrayType; } return $firstArrayType->intersectKeyArray($otherArraysType); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use Closure; use PhpParser\Node\Expr\StaticCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\MethodReflection; use PHPStan\Reflection\ParametersAcceptorWithPhpDocs; use PHPStan\Type\ClosureType; use PHPStan\Type\DynamicStaticMethodReturnTypeExtension; use PHPStan\Type\ErrorType; use PHPStan\Type\Generic\TemplateTypeVarianceMap; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; final class ClosureFromCallableDynamicReturnTypeExtension implements DynamicStaticMethodReturnTypeExtension { public function getClass() : string { return Closure::class; } public function isStaticMethodSupported(MethodReflection $methodReflection) : bool { return $methodReflection->getName() === 'fromCallable'; } public function getTypeFromStaticMethodCall(MethodReflection $methodReflection, StaticCall $methodCall, Scope $scope) : ?Type { if (!isset($methodCall->getArgs()[0])) { return null; } $callableType = $scope->getType($methodCall->getArgs()[0]->value); if ($callableType->isCallable()->no()) { return new ErrorType(); } $closureTypes = []; foreach ($callableType->getCallableParametersAcceptors($scope) as $variant) { $parameters = $variant->getParameters(); $closureTypes[] = new ClosureType($parameters, $variant->getReturnType(), $variant->isVariadic(), $variant->getTemplateTypeMap(), $variant->getResolvedTemplateTypeMap(), $variant instanceof ParametersAcceptorWithPhpDocs ? $variant->getCallSiteVarianceMap() : TemplateTypeVarianceMap::createEmpty(), [], $variant->getThrowPoints(), $variant->getImpurePoints(), $variant->getInvalidateExpressions(), $variant->getUsedVariables(), $variant->acceptsNamedArguments()); } return TypeCombinator::union(...$closureTypes); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\ParameterReflection; use PHPStan\Type\Accessory\AccessoryNonEmptyStringType; use PHPStan\Type\FunctionParameterOutTypeExtension; use PHPStan\Type\NullType; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function in_array; use function openssl_get_cipher_methods; use function strtolower; use function substr; final class OpenSslEncryptParameterOutTypeExtension implements FunctionParameterOutTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection, ParameterReflection $parameter) : bool { return $functionReflection->getName() === 'openssl_encrypt' && $parameter->getName() === 'tag'; } public function getParameterOutTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $funcCall, ParameterReflection $parameter, Scope $scope) : ?Type { $args = $funcCall->getArgs(); $cipherArg = $args[1] ?? null; if ($cipherArg === null) { return null; } $tagTypes = []; foreach ($scope->getType($cipherArg->value)->getConstantStrings() as $cipherType) { $cipher = strtolower($cipherType->getValue()); $mode = substr($cipher, -3); if (!in_array($cipher, openssl_get_cipher_methods(), \true)) { $tagTypes[] = new NullType(); continue; } if (in_array($mode, ['gcm', 'ccm'], \true)) { $tagTypes[] = TypeCombinator::intersect(new StringType(), new AccessoryNonEmptyStringType()); continue; } $tagTypes[] = new NullType(); } if ($tagTypes === []) { return TypeCombinator::addNull(TypeCombinator::intersect(new StringType(), new AccessoryNonEmptyStringType())); } return TypeCombinator::union(...$tagTypes); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\MethodCall; use PHPStan\Analyser\Scope; use PHPStan\Analyser\SpecifiedTypes; use PHPStan\Analyser\TypeSpecifier; use PHPStan\Analyser\TypeSpecifierAwareExtension; use PHPStan\Analyser\TypeSpecifierContext; use PHPStan\Reflection\MethodReflection; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\Generic\GenericObjectType; use PHPStan\Type\MethodTypeSpecifyingExtension; use PHPStan\Type\ObjectType; use ReflectionClass; final class ReflectionClassIsSubclassOfTypeSpecifyingExtension implements MethodTypeSpecifyingExtension, TypeSpecifierAwareExtension { /** * @var TypeSpecifier */ private $typeSpecifier; public function setTypeSpecifier(TypeSpecifier $typeSpecifier) : void { $this->typeSpecifier = $typeSpecifier; } public function getClass() : string { return ReflectionClass::class; } public function isMethodSupported(MethodReflection $methodReflection, MethodCall $node, TypeSpecifierContext $context) : bool { return $methodReflection->getName() === 'isSubclassOf' && isset($node->getArgs()[0]) && $context->true(); } public function specifyTypes(MethodReflection $methodReflection, MethodCall $node, Scope $scope, TypeSpecifierContext $context) : SpecifiedTypes { $valueType = $scope->getType($node->getArgs()[0]->value); if (!$valueType instanceof ConstantStringType) { return new SpecifiedTypes([], []); } return $this->typeSpecifier->create($node->var, new GenericObjectType(ReflectionClass::class, [new ObjectType($valueType->getValue())]), $context, \false, $scope); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\FunctionReflection; use PHPStan\ShouldNotHappenException; use PHPStan\TrinaryLogic; use PHPStan\Type\Accessory\AccessoryArrayListType; use PHPStan\Type\Accessory\NonEmptyArrayType; use PHPStan\Type\ArrayType; use PHPStan\Type\Constant\ConstantArrayType; use PHPStan\Type\Constant\ConstantArrayTypeBuilder; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\IntegerType; use PHPStan\Type\MixedType; use PHPStan\Type\NeverType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function count; final class ArrayColumnFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { /** * @var PhpVersion */ private $phpVersion; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; } public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'array_column'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { $numArgs = count($functionCall->getArgs()); if ($numArgs < 2) { return null; } $arrayType = $scope->getType($functionCall->getArgs()[0]->value); $columnType = $scope->getType($functionCall->getArgs()[1]->value); $indexType = $numArgs >= 3 ? $scope->getType($functionCall->getArgs()[2]->value) : null; $constantArrayTypes = $arrayType->getConstantArrays(); if (count($constantArrayTypes) === 1) { $type = $this->handleConstantArray($constantArrayTypes[0], $columnType, $indexType, $scope); if ($type !== null) { return $type; } } return $this->handleAnyArray($arrayType, $columnType, $indexType, $scope); } private function handleAnyArray(Type $arrayType, Type $columnType, ?Type $indexType, Scope $scope) : Type { $iterableAtLeastOnce = $arrayType->isIterableAtLeastOnce(); if ($iterableAtLeastOnce->no()) { return new ConstantArrayType([], []); } $iterableValueType = $arrayType->getIterableValueType(); $returnValueType = $this->getOffsetOrProperty($iterableValueType, $columnType, $scope, \false); if ($returnValueType === null) { $returnValueType = $this->getOffsetOrProperty($iterableValueType, $columnType, $scope, \true); $iterableAtLeastOnce = TrinaryLogic::createMaybe(); if ($returnValueType === null) { throw new ShouldNotHappenException(); } } if ($returnValueType instanceof NeverType) { return new ConstantArrayType([], []); } if ($indexType !== null) { $type = $this->getOffsetOrProperty($iterableValueType, $indexType, $scope, \false); if ($type !== null) { $returnKeyType = $type; } else { $type = $this->getOffsetOrProperty($iterableValueType, $indexType, $scope, \true); if ($type !== null) { $returnKeyType = TypeCombinator::union($type, new IntegerType()); } else { $returnKeyType = new IntegerType(); } } } else { $returnKeyType = new IntegerType(); } $returnType = new ArrayType($this->castToArrayKeyType($returnKeyType), $returnValueType); if ($iterableAtLeastOnce->yes()) { $returnType = TypeCombinator::intersect($returnType, new NonEmptyArrayType()); } if ($indexType === null) { $returnType = AccessoryArrayListType::intersectWith($returnType); } return $returnType; } private function handleConstantArray(ConstantArrayType $arrayType, Type $columnType, ?Type $indexType, Scope $scope) : ?Type { $builder = ConstantArrayTypeBuilder::createEmpty(); foreach ($arrayType->getValueTypes() as $i => $iterableValueType) { $valueType = $this->getOffsetOrProperty($iterableValueType, $columnType, $scope, \false); if ($valueType === null) { return null; } if ($valueType instanceof NeverType) { continue; } if ($indexType !== null) { $type = $this->getOffsetOrProperty($iterableValueType, $indexType, $scope, \false); if ($type !== null) { $keyType = $type; } else { $type = $this->getOffsetOrProperty($iterableValueType, $indexType, $scope, \true); if ($type !== null) { $keyType = TypeCombinator::union($type, new IntegerType()); } else { $keyType = null; } } } else { $keyType = null; } if ($keyType !== null) { $keyType = $this->castToArrayKeyType($keyType); } $builder->setOffsetValueType($keyType, $valueType, $arrayType->isOptionalKey($i)); } return $builder->getArray(); } private function getOffsetOrProperty(Type $type, Type $offsetOrProperty, Scope $scope, bool $allowMaybe) : ?Type { $offsetIsNull = $offsetOrProperty->isNull(); if ($offsetIsNull->yes()) { return $type; } $returnTypes = []; if ($offsetIsNull->maybe()) { $returnTypes[] = $type; } if (!$type->canAccessProperties()->no()) { $propertyTypes = $offsetOrProperty->getConstantStrings(); if ($propertyTypes === []) { return new MixedType(); } foreach ($propertyTypes as $propertyType) { $propertyName = $propertyType->getValue(); $hasProperty = $type->hasProperty($propertyName); if ($hasProperty->maybe()) { return $allowMaybe ? new MixedType() : null; } if (!$hasProperty->yes()) { continue; } $returnTypes[] = $type->getProperty($propertyName, $scope)->getReadableType(); } } if ($type->isOffsetAccessible()->yes()) { $hasOffset = $type->hasOffsetValueType($offsetOrProperty); if (!$allowMaybe && $hasOffset->maybe()) { return null; } if (!$hasOffset->no()) { $returnTypes[] = $type->getOffsetValueType($offsetOrProperty); } } if ($returnTypes === []) { return new NeverType(); } return TypeCombinator::union(...$returnTypes); } private function castToArrayKeyType(Type $type) : Type { $isArray = $type->isArray(); if ($isArray->yes()) { return $this->phpVersion->throwsTypeErrorForInternalFunctions() ? new NeverType() : new IntegerType(); } if ($isArray->no()) { return $type->toArrayKey(); } $withoutArrayType = TypeCombinator::remove($type, new ArrayType(new MixedType(), new MixedType())); $keyType = $withoutArrayType->toArrayKey(); if ($this->phpVersion->throwsTypeErrorForInternalFunctions()) { return $keyType; } return TypeCombinator::union($keyType, new IntegerType()); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\BooleanType; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\IntegerRangeType; use PHPStan\Type\NeverType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function in_array; use function strtolower; final class MbSubstituteCharacterDynamicReturnTypeExtension implements DynamicFunctionReturnTypeExtension { /** * @var PhpVersion */ private $phpVersion; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; } public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'mb_substitute_character'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : Type { $minCodePoint = $this->phpVersion->getVersionId() < 80000 ? 1 : 0; $maxCodePoint = $this->phpVersion->supportsAllUnicodeScalarCodePointsInMbSubstituteCharacter() ? 0x10ffff : 0xfffe; $ranges = []; if ($this->phpVersion->supportsAllUnicodeScalarCodePointsInMbSubstituteCharacter()) { // Surrogates aren't valid in PHP 7.2+ $ranges[] = IntegerRangeType::fromInterval($minCodePoint, 0xd7ff); $ranges[] = IntegerRangeType::fromInterval(0xe000, $maxCodePoint); } else { $ranges[] = IntegerRangeType::fromInterval($minCodePoint, $maxCodePoint); } if (!isset($functionCall->getArgs()[0])) { return TypeCombinator::union(new ConstantStringType('none'), new ConstantStringType('long'), new ConstantStringType('entity'), ...$ranges); } $argType = $scope->getType($functionCall->getArgs()[0]->value); $isString = $argType->isString(); $isNull = $argType->isNull(); $isInteger = $argType->isInteger(); if ($isString->no() && $isNull->no() && $isInteger->no()) { if ($this->phpVersion->throwsTypeErrorForInternalFunctions()) { return new NeverType(); } return new BooleanType(); } if ($isInteger->yes()) { $invalidRanges = []; foreach ($ranges as $range) { $isInRange = $range->isSuperTypeOf($argType); if ($isInRange->yes()) { return new ConstantBooleanType(\true); } $invalidRanges[] = $isInRange->no(); } if ($argType instanceof ConstantIntegerType || !in_array(\false, $invalidRanges, \true)) { if ($this->phpVersion->throwsValueErrorForInternalFunctions()) { return new NeverType(); } return new ConstantBooleanType(\false); } } elseif ($isString->yes()) { if ($argType->isNonEmptyString()->no()) { // The empty string was a valid alias for "none" in PHP < 8. if ($this->phpVersion->isEmptyStringValidAliasForNoneInMbSubstituteCharacter()) { return new ConstantBooleanType(\true); } return new NeverType(); } if (!$this->phpVersion->isNumericStringValidArgInMbSubstituteCharacter() && $argType->isNumericString()->yes()) { return new NeverType(); } if ($argType instanceof ConstantStringType) { $value = strtolower($argType->getValue()); if (in_array($value, ['none', 'long', 'entity'], \true)) { return new ConstantBooleanType(\true); } if ($argType->isNumericString()->yes()) { $codePoint = (int) $value; $isValid = $codePoint >= $minCodePoint && $codePoint <= $maxCodePoint; if ($this->phpVersion->supportsAllUnicodeScalarCodePointsInMbSubstituteCharacter()) { $isValid = $isValid && ($codePoint < 0xd800 || $codePoint > 0xdfff); } return new ConstantBooleanType($isValid); } if ($this->phpVersion->throwsValueErrorForInternalFunctions()) { return new NeverType(); } return new ConstantBooleanType(\false); } } elseif ($isNull->yes()) { // The $substitute_character arg is nullable in PHP 8+ return new ConstantBooleanType($this->phpVersion->isNullValidArgInMbSubstituteCharacter()); } return new BooleanType(); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use Closure; use PhpParser\Node\Expr\StaticCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\MethodReflection; use PHPStan\Type\ClosureType; use PHPStan\Type\DynamicStaticMethodReturnTypeExtension; use PHPStan\Type\Type; final class ClosureBindDynamicReturnTypeExtension implements DynamicStaticMethodReturnTypeExtension { public function getClass() : string { return Closure::class; } public function isStaticMethodSupported(MethodReflection $methodReflection) : bool { return $methodReflection->getName() === 'bind'; } public function getTypeFromStaticMethodCall(MethodReflection $methodReflection, StaticCall $methodCall, Scope $scope) : ?Type { $closureType = $scope->getType($methodCall->getArgs()[0]->value); if (!$closureType instanceof ClosureType) { return null; } return $closureType; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\ParameterReflection; use PHPStan\TrinaryLogic; use PHPStan\Type\FunctionParameterOutTypeExtension; use PHPStan\Type\Type; use function in_array; use function strtolower; final class PregMatchParameterOutTypeExtension implements FunctionParameterOutTypeExtension { /** * @var RegexArrayShapeMatcher */ private $regexShapeMatcher; public function __construct(\PHPStan\Type\Php\RegexArrayShapeMatcher $regexShapeMatcher) { $this->regexShapeMatcher = $regexShapeMatcher; } public function isFunctionSupported(FunctionReflection $functionReflection, ParameterReflection $parameter) : bool { return in_array(strtolower($functionReflection->getName()), ['preg_match', 'preg_match_all'], \true) && in_array($parameter->getName(), ['subpatterns', 'matches'], \true); } public function getParameterOutTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $funcCall, ParameterReflection $parameter, Scope $scope) : ?Type { $args = $funcCall->getArgs(); $patternArg = $args[0] ?? null; $matchesArg = $args[2] ?? null; $flagsArg = $args[3] ?? null; if ($patternArg === null || $matchesArg === null) { return null; } $flagsType = null; if ($flagsArg !== null) { $flagsType = $scope->getType($flagsArg->value); } if ($functionReflection->getName() === 'preg_match') { return $this->regexShapeMatcher->matchExpr($patternArg->value, $flagsType, TrinaryLogic::createMaybe(), $scope); } return $this->regexShapeMatcher->matchAllExpr($patternArg->value, $flagsType, TrinaryLogic::createMaybe(), $scope); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Accessory\AccessoryArrayListType; use PHPStan\Type\ArrayType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\ErrorType; use PHPStan\Type\IntegerType; use PHPStan\Type\NeverType; use PHPStan\Type\Type; use function strtolower; final class IteratorToArrayFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return strtolower($functionReflection->getName()) === 'iterator_to_array'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { $arguments = $functionCall->getArgs(); if ($arguments === []) { return null; } $traversableType = $scope->getType($arguments[0]->value); if (isset($arguments[1])) { $preserveKeysType = $scope->getType($arguments[1]->value); if ($preserveKeysType->isFalse()->yes()) { return AccessoryArrayListType::intersectWith(new ArrayType(new IntegerType(), $traversableType->getIterableValueType())); } } $arrayKeyType = $traversableType->getIterableKeyType()->toArrayKey(); if ($arrayKeyType instanceof ErrorType) { return new NeverType(\true); } return new ArrayType($arrayKeyType, $traversableType->getIterableValueType()); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\ParametersAcceptorSelector; use PHPStan\Type\BooleanType; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\NeverType; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\UnionType; use function array_key_exists; use function array_map; use function array_unique; use function count; final class MbFunctionsReturnTypeExtension implements DynamicFunctionReturnTypeExtension { /** * @var PhpVersion */ private $phpVersion; use \PHPStan\Type\Php\MbFunctionsReturnTypeExtensionTrait; /** @var int[] */ private $encodingPositionMap = ['mb_http_output' => 1, 'mb_regex_encoding' => 1, 'mb_internal_encoding' => 1, 'mb_encoding_aliases' => 1, 'mb_chr' => 2, 'mb_ord' => 2]; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; } public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return array_key_exists($functionReflection->getName(), $this->encodingPositionMap); } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : Type { $returnType = ParametersAcceptorSelector::selectFromArgs($scope, $functionCall->getArgs(), $functionReflection->getVariants())->getReturnType(); $positionEncodingParam = $this->encodingPositionMap[$functionReflection->getName()]; if (count($functionCall->getArgs()) < $positionEncodingParam) { return TypeCombinator::remove($returnType, new BooleanType()); } $strings = $scope->getType($functionCall->getArgs()[$positionEncodingParam - 1]->value)->getConstantStrings(); $results = array_unique(array_map(function (ConstantStringType $encoding) : bool { return $this->isSupportedEncoding($encoding->getValue()); }, $strings)); if ($returnType->equals(new UnionType([new StringType(), new BooleanType()]))) { return count($results) === 1 ? new ConstantBooleanType($results[0]) : new BooleanType(); } if (count($results) === 1) { $invalidEncodingReturn = new ConstantBooleanType(\false); if ($this->phpVersion->throwsOnInvalidMbStringEncoding()) { $invalidEncodingReturn = new NeverType(); } return $results[0] ? TypeCombinator::remove($returnType, new ConstantBooleanType(\false)) : $invalidEncodingReturn; } return $returnType; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\NeverType; use PHPStan\Type\NullType; use PHPStan\Type\Type; use function count; use function strtolower; final class ArrayValuesFunctionDynamicReturnTypeExtension implements DynamicFunctionReturnTypeExtension { /** * @var PhpVersion */ private $phpVersion; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; } public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return strtolower($functionReflection->getName()) === 'array_values'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (count($functionCall->getArgs()) !== 1) { return null; } $arrayType = $scope->getType($functionCall->getArgs()[0]->value); if ($arrayType->isArray()->no()) { return $this->phpVersion->arrayFunctionsReturnNullWithNonArray() ? new NullType() : new NeverType(); } return $arrayType->getValuesArray(); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Analyser\SpecifiedTypes; use PHPStan\Analyser\TypeSpecifier; use PHPStan\Analyser\TypeSpecifierAwareExtension; use PHPStan\Analyser\TypeSpecifierContext; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Accessory\NonEmptyArrayType; use PHPStan\Type\FunctionTypeSpecifyingExtension; use function count; use function in_array; final class CountFunctionTypeSpecifyingExtension implements FunctionTypeSpecifyingExtension, TypeSpecifierAwareExtension { /** * @var TypeSpecifier */ private $typeSpecifier; public function isFunctionSupported(FunctionReflection $functionReflection, FuncCall $node, TypeSpecifierContext $context) : bool { return !$context->null() && count($node->getArgs()) >= 1 && in_array($functionReflection->getName(), ['sizeof', 'count'], \true); } public function specifyTypes(FunctionReflection $functionReflection, FuncCall $node, Scope $scope, TypeSpecifierContext $context) : SpecifiedTypes { if (!$scope->getType($node->getArgs()[0]->value)->isArray()->yes()) { return new SpecifiedTypes([], []); } return $this->typeSpecifier->create($node->getArgs()[0]->value, new NonEmptyArrayType(), $context, \false, $scope); } public function setTypeSpecifier(TypeSpecifier $typeSpecifier) : void { $this->typeSpecifier = $typeSpecifier; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Internal\CombinationsHelper; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\InitializerExprTypeResolver; use PHPStan\Type\Accessory\AccessoryLiteralStringType; use PHPStan\Type\Accessory\AccessoryLowercaseStringType; use PHPStan\Type\Accessory\AccessoryNonEmptyStringType; use PHPStan\Type\Accessory\AccessoryNonFalsyStringType; use PHPStan\Type\Accessory\AccessoryUppercaseStringType; use PHPStan\Type\Constant\ConstantArrayType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\IntersectionType; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function count; use function implode; use function in_array; final class ImplodeFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return in_array($functionReflection->getName(), ['implode', 'join'], \true); } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : Type { $args = $functionCall->getArgs(); if (count($args) === 1) { $argType = $scope->getType($args[0]->value); if ($argType->isArray()->yes()) { return $this->implode($argType, new ConstantStringType('')); } } if (count($args) !== 2) { return new StringType(); } $separatorType = $scope->getType($args[0]->value); $arrayType = $scope->getType($args[1]->value); return $this->implode($arrayType, $separatorType); } private function implode(Type $arrayType, Type $separatorType) : Type { if (count($arrayType->getConstantArrays()) > 0 && count($separatorType->getConstantStrings()) > 0) { $result = []; foreach ($separatorType->getConstantStrings() as $separator) { foreach ($arrayType->getConstantArrays() as $constantArray) { $constantType = $this->inferConstantType($constantArray, $separator); if ($constantType !== null) { $result[] = $constantType; continue; } $result = []; break 2; } } if (count($result) > 0) { return TypeCombinator::union(...$result); } } $accessoryTypes = []; if ($arrayType->isIterableAtLeastOnce()->yes()) { if ($arrayType->getIterableValueType()->isNonFalsyString()->yes() || $separatorType->isNonFalsyString()->yes()) { $accessoryTypes[] = new AccessoryNonFalsyStringType(); } elseif ($arrayType->getIterableValueType()->isNonEmptyString()->yes() || $separatorType->isNonEmptyString()->yes()) { $accessoryTypes[] = new AccessoryNonEmptyStringType(); } } // implode is one of the four functions that can produce literal strings as blessed by the original RFC: wiki.php.net/rfc/is_literal if ($arrayType->getIterableValueType()->isLiteralString()->yes() && $separatorType->isLiteralString()->yes()) { $accessoryTypes[] = new AccessoryLiteralStringType(); } if ($arrayType->getIterableValueType()->isLowercaseString()->yes() && $separatorType->isLowercaseString()->yes()) { $accessoryTypes[] = new AccessoryLowercaseStringType(); } if ($arrayType->getIterableValueType()->isUppercaseString()->yes() && $separatorType->isUppercaseString()->yes()) { $accessoryTypes[] = new AccessoryUppercaseStringType(); } if (count($accessoryTypes) > 0) { $accessoryTypes[] = new StringType(); return new IntersectionType($accessoryTypes); } return new StringType(); } private function inferConstantType(ConstantArrayType $arrayType, ConstantStringType $separatorType) : ?Type { $strings = []; foreach ($arrayType->getAllArrays() as $array) { $valueTypes = $array->getValueTypes(); $arrayValues = []; $combinationsCount = 1; foreach ($valueTypes as $valueType) { $constScalars = $valueType->getConstantScalarValues(); if (count($constScalars) === 0) { return null; } $arrayValues[] = $constScalars; $combinationsCount *= count($constScalars); } if ($combinationsCount > InitializerExprTypeResolver::CALCULATE_SCALARS_LIMIT) { return null; } $combinations = CombinationsHelper::combinations($arrayValues); foreach ($combinations as $combination) { $strings[] = new ConstantStringType(implode($separatorType->getValue(), $combination)); } } if (count($strings) > InitializerExprTypeResolver::CALCULATE_SCALARS_LIMIT) { return null; } return TypeCombinator::union(...$strings); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\BinaryOp\Smaller; use PhpParser\Node\Expr\FuncCall; use PhpParser\Node\Expr\Ternary; use PHPStan\Analyser\Scope; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Constant\ConstantArrayType; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\ConstantScalarType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\ErrorType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\UnionType; use function count; use function in_array; final class MinMaxFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { /** * @var PhpVersion */ private $phpVersion; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; } public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return in_array($functionReflection->getName(), ['min', 'max'], \true); } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (!isset($functionCall->getArgs()[0])) { return null; } if (count($functionCall->getArgs()) === 1) { $argType = $scope->getType($functionCall->getArgs()[0]->value); if ($argType->isArray()->yes()) { return $this->processArrayType($functionReflection->getName(), $argType); } return new ErrorType(); } // rewrite min($x, $y) as $x < $y ? $x : $y // we don't handle arrays, which have different semantics $functionName = $functionReflection->getName(); $args = $functionCall->getArgs(); if (count($functionCall->getArgs()) === 2) { $argType0 = $scope->getType($args[0]->value); $argType1 = $scope->getType($args[1]->value); if ($argType0->isArray()->no() && $argType1->isArray()->no()) { if ($functionName === 'min') { return $scope->getType(new Ternary(new Smaller($args[0]->value, $args[1]->value), $args[0]->value, $args[1]->value)); } elseif ($functionName === 'max') { return $scope->getType(new Ternary(new Smaller($args[0]->value, $args[1]->value), $args[1]->value, $args[0]->value)); } } } $argumentTypes = []; foreach ($functionCall->getArgs() as $arg) { $argType = $scope->getType($arg->value); if ($arg->unpack) { $iterableValueType = $argType->getIterableValueType(); if ($iterableValueType instanceof UnionType) { foreach ($iterableValueType->getTypes() as $innerType) { $argumentTypes[] = $innerType; } } else { $argumentTypes[] = $iterableValueType; } continue; } $argumentTypes[] = $argType; } return $this->processType($functionName, $argumentTypes); } private function processArrayType(string $functionName, Type $argType) : Type { $constArrayTypes = $argType->getConstantArrays(); if (count($constArrayTypes) > 0) { $resultTypes = []; foreach ($constArrayTypes as $constArrayType) { $isIterable = $constArrayType->isIterableAtLeastOnce(); if ($isIterable->no() && !$this->phpVersion->throwsValueErrorForInternalFunctions()) { $resultTypes[] = new ConstantBooleanType(\false); continue; } $argumentTypes = []; if (!$isIterable->yes() && !$this->phpVersion->throwsValueErrorForInternalFunctions()) { $argumentTypes[] = new ConstantBooleanType(\false); } foreach ($constArrayType->getValueTypes() as $innerType) { $argumentTypes[] = $innerType; } $resultTypes[] = $this->processType($functionName, $argumentTypes); } return TypeCombinator::union(...$resultTypes); } $isIterable = $argType->isIterableAtLeastOnce(); if ($isIterable->no() && !$this->phpVersion->throwsValueErrorForInternalFunctions()) { return new ConstantBooleanType(\false); } $iterableValueType = $argType->getIterableValueType(); $argumentTypes = []; if (!$isIterable->yes() && !$this->phpVersion->throwsValueErrorForInternalFunctions()) { $argumentTypes[] = new ConstantBooleanType(\false); } $argumentTypes[] = $iterableValueType; return $this->processType($functionName, $argumentTypes); } /** * @param Type[] $types */ private function processType(string $functionName, array $types) : Type { $resultType = null; foreach ($types as $type) { if ($resultType === null) { $resultType = $type; continue; } $compareResult = $this->compareTypes($resultType, $type); if ($compareResult === null) { return TypeCombinator::union(...$types); } if ($functionName === 'min') { if ($compareResult === $type) { $resultType = $type; } } elseif ($functionName === 'max') { if ($compareResult === $resultType) { $resultType = $type; } } } if ($resultType === null) { return new ErrorType(); } return $resultType; } private function compareTypes(Type $firstType, Type $secondType) : ?Type { if ($firstType->isArray()->yes() && $secondType->isConstantScalarValue()->yes()) { return $secondType; } if ($firstType->isConstantScalarValue()->yes() && $secondType->isArray()->yes()) { return $firstType; } if ($firstType instanceof ConstantArrayType && $secondType instanceof ConstantArrayType) { if ($secondType->getArraySize() < $firstType->getArraySize()) { return $secondType; } elseif ($firstType->getArraySize() < $secondType->getArraySize()) { return $firstType; } foreach ($firstType->getValueTypes() as $i => $firstValueType) { $secondValueType = $secondType->getValueTypes()[$i]; $compareResult = $this->compareTypes($firstValueType, $secondValueType); if ($compareResult === $firstValueType) { return $firstType; } if ($compareResult === $secondValueType) { return $secondType; } } return null; } if ($firstType instanceof ConstantScalarType && $secondType instanceof ConstantScalarType) { if ($secondType->getValue() < $firstType->getValue()) { return $secondType; } if ($firstType->getValue() < $secondType->getValue()) { return $firstType; } } return null; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\Type; use function count; use function in_array; use const COUNT_RECURSIVE; final class CountFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return in_array($functionReflection->getName(), ['sizeof', 'count'], \true); } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (count($functionCall->getArgs()) < 1) { return null; } if (count($functionCall->getArgs()) > 1) { $mode = $scope->getType($functionCall->getArgs()[1]->value); if ($mode->isSuperTypeOf(new ConstantIntegerType(COUNT_RECURSIVE))->yes()) { return null; } } return $scope->getType($functionCall->getArgs()[0]->value)->getArraySize(); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\ReflectionProvider; use PHPStan\ShouldNotHappenException; use PHPStan\TrinaryLogic; use PHPStan\Type\Accessory\AccessoryNonEmptyStringType; use PHPStan\Type\Accessory\AccessoryNonFalsyStringType; use PHPStan\Type\ArrayType; use PHPStan\Type\BooleanType; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantFloatType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\ConstantScalarType; use PHPStan\Type\FloatType; use PHPStan\Type\IntegerRangeType; use PHPStan\Type\IntegerType; use PHPStan\Type\MixedType; use PHPStan\Type\NeverType; use PHPStan\Type\NullType; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function array_key_exists; use function array_merge; use function hexdec; use function is_int; use function octdec; use function preg_match; use function sprintf; final class FilterFunctionReturnTypeHelper { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var PhpVersion */ private $phpVersion; /** All validation filters match 0x100. */ private const VALIDATION_FILTER_BITMASK = 0x100; /** * @var ConstantStringType */ private $flagsString; /** @var array<int, Type>|null */ private $filterTypeMap = null; /** @var array<int, list<string>>|null */ private $filterTypeOptions = null; /** * @var ?Type */ private $supportedFilterInputTypes = null; public function __construct(ReflectionProvider $reflectionProvider, PhpVersion $phpVersion) { $this->reflectionProvider = $reflectionProvider; $this->phpVersion = $phpVersion; $this->flagsString = new ConstantStringType('flags'); } public function getOffsetValueType(Type $inputType, Type $offsetType, ?Type $filterType, ?Type $flagsType) : Type { $inexistentOffsetType = $this->hasFlag($this->getConstant('FILTER_NULL_ON_FAILURE'), $flagsType) ? new ConstantBooleanType(\false) : new NullType(); $hasOffsetValueType = $inputType->hasOffsetValueType($offsetType); if ($hasOffsetValueType->no()) { return $inexistentOffsetType; } $filteredType = $this->getType($inputType->getOffsetValueType($offsetType), $filterType, $flagsType); return $hasOffsetValueType->maybe() ? TypeCombinator::union($filteredType, $inexistentOffsetType) : $filteredType; } public function getInputType(Type $typeType, Type $varNameType, ?Type $filterType, ?Type $flagsType) : Type { $this->supportedFilterInputTypes = $this->supportedFilterInputTypes ?? TypeCombinator::union($this->reflectionProvider->getConstant(new Node\Name('INPUT_GET'), null)->getValueType(), $this->reflectionProvider->getConstant(new Node\Name('INPUT_POST'), null)->getValueType(), $this->reflectionProvider->getConstant(new Node\Name('INPUT_COOKIE'), null)->getValueType(), $this->reflectionProvider->getConstant(new Node\Name('INPUT_SERVER'), null)->getValueType(), $this->reflectionProvider->getConstant(new Node\Name('INPUT_ENV'), null)->getValueType()); if (!$typeType->isInteger()->yes() || $this->supportedFilterInputTypes->isSuperTypeOf($typeType)->no()) { if ($this->phpVersion->throwsTypeErrorForInternalFunctions()) { return new NeverType(); } // Using a null as input mimics pre PHP 8 behaviour where filter_input // would return the same as if the offset does not exist $inputType = new NullType(); } else { // Pragmatical solution since global expressions are not passed through the scope for performance reasons // See https://github.com/phpstan/phpstan-src/pull/2012 for details $inputType = new ArrayType(new StringType(), new MixedType()); } return $this->getOffsetValueType($inputType, $varNameType, $filterType, $flagsType); } public function getType(Type $inputType, ?Type $filterType, ?Type $flagsType) : Type { $mixedType = new MixedType(); if ($filterType === null) { $filterValue = $this->getConstant('FILTER_DEFAULT'); } else { if (!$filterType instanceof ConstantIntegerType) { return $mixedType; } $filterValue = $filterType->getValue(); } if ($flagsType === null) { $flagsType = new ConstantIntegerType(0); } $hasOptions = $this->hasOptions($flagsType); $options = $hasOptions->yes() ? $this->getOptions($flagsType, $filterValue) : []; $defaultType = $options['default'] ?? ($this->hasFlag($this->getConstant('FILTER_NULL_ON_FAILURE'), $flagsType) ? new NullType() : new ConstantBooleanType(\false)); $inputIsArray = $inputType->isArray(); $hasRequireArrayFlag = $this->hasFlag($this->getConstant('FILTER_REQUIRE_ARRAY'), $flagsType); if ($inputIsArray->no() && $hasRequireArrayFlag) { return $defaultType; } $hasForceArrayFlag = $this->hasFlag($this->getConstant('FILTER_FORCE_ARRAY'), $flagsType); if ($inputIsArray->yes() && ($hasRequireArrayFlag || $hasForceArrayFlag)) { $inputArrayKeyType = $inputType->getIterableKeyType(); $inputType = $inputType->getIterableValueType(); } if ($inputType->isScalar()->no() && $inputType->isNull()->no()) { return $defaultType; } $exactType = $this->determineExactType($inputType, $filterValue, $defaultType, $flagsType); $type = $exactType ?? $this->getFilterTypeMap()[$filterValue] ?? $mixedType; $type = $this->applyRangeOptions($type, $options, $defaultType); if ($inputType->isNonEmptyString()->yes() && $type->isString()->yes() && !$this->canStringBeSanitized($filterValue, $flagsType)) { $accessory = new AccessoryNonEmptyStringType(); if ($inputType->isNonFalsyString()->yes()) { $accessory = new AccessoryNonFalsyStringType(); } $type = TypeCombinator::intersect($type, $accessory); } if ($hasRequireArrayFlag) { $type = new ArrayType($inputArrayKeyType ?? $mixedType, $type); } if ($exactType === null || $hasOptions->maybe() || !$inputType->equals($type) && $inputType->isSuperTypeOf($type)->yes()) { if ($defaultType->isSuperTypeOf($type)->no()) { $type = TypeCombinator::union($type, $defaultType); } } if (!$hasRequireArrayFlag && $hasForceArrayFlag) { return new ArrayType($inputArrayKeyType ?? $mixedType, $type); } return $type; } /** * @return array<int, Type> */ private function getFilterTypeMap() : array { if ($this->filterTypeMap !== null) { return $this->filterTypeMap; } $booleanType = new BooleanType(); $floatType = new FloatType(); $intType = new IntegerType(); $stringType = new StringType(); $nonFalsyStringType = TypeCombinator::intersect($stringType, new AccessoryNonFalsyStringType()); $this->filterTypeMap = [$this->getConstant('FILTER_UNSAFE_RAW') => $stringType, $this->getConstant('FILTER_SANITIZE_EMAIL') => $stringType, $this->getConstant('FILTER_SANITIZE_ENCODED') => $stringType, $this->getConstant('FILTER_SANITIZE_NUMBER_FLOAT') => $stringType, $this->getConstant('FILTER_SANITIZE_NUMBER_INT') => $stringType, $this->getConstant('FILTER_SANITIZE_SPECIAL_CHARS') => $stringType, $this->getConstant('FILTER_SANITIZE_STRING') => $stringType, $this->getConstant('FILTER_SANITIZE_URL') => $stringType, $this->getConstant('FILTER_VALIDATE_BOOLEAN') => $booleanType, $this->getConstant('FILTER_VALIDATE_DOMAIN') => $stringType, $this->getConstant('FILTER_VALIDATE_EMAIL') => $nonFalsyStringType, $this->getConstant('FILTER_VALIDATE_FLOAT') => $floatType, $this->getConstant('FILTER_VALIDATE_INT') => $intType, $this->getConstant('FILTER_VALIDATE_IP') => $nonFalsyStringType, $this->getConstant('FILTER_VALIDATE_MAC') => $nonFalsyStringType, $this->getConstant('FILTER_VALIDATE_REGEXP') => $stringType, $this->getConstant('FILTER_VALIDATE_URL') => $nonFalsyStringType]; if ($this->reflectionProvider->hasConstant(new Node\Name('FILTER_SANITIZE_MAGIC_QUOTES'), null)) { $this->filterTypeMap[$this->getConstant('FILTER_SANITIZE_MAGIC_QUOTES')] = $stringType; } if ($this->reflectionProvider->hasConstant(new Node\Name('FILTER_SANITIZE_ADD_SLASHES'), null)) { $this->filterTypeMap[$this->getConstant('FILTER_SANITIZE_ADD_SLASHES')] = $stringType; } return $this->filterTypeMap; } /** * @return array<int, list<string>> */ private function getFilterTypeOptions() : array { if ($this->filterTypeOptions !== null) { return $this->filterTypeOptions; } $this->filterTypeOptions = [$this->getConstant('FILTER_VALIDATE_INT') => ['min_range', 'max_range']]; return $this->filterTypeOptions; } /** * @param non-empty-string $constantName */ private function getConstant(string $constantName) : int { $constant = $this->reflectionProvider->getConstant(new Node\Name($constantName), null); $valueType = $constant->getValueType(); if (!$valueType instanceof ConstantIntegerType) { throw new ShouldNotHappenException(sprintf('Constant %s does not have integer type.', $constantName)); } return $valueType->getValue(); } private function determineExactType(Type $in, int $filterValue, Type $defaultType, ?Type $flagsType) : ?Type { if ($filterValue === $this->getConstant('FILTER_VALIDATE_BOOLEAN')) { if ($in->isBoolean()->yes()) { return $in; } if ($in->isNull()->yes()) { return $defaultType; } } if ($filterValue === $this->getConstant('FILTER_VALIDATE_FLOAT')) { if ($in->isFloat()->yes()) { return $in; } if ($in->isInteger()->yes()) { return $in->toFloat(); } if ($in->isTrue()->yes()) { return new ConstantFloatType(1); } if ($in->isFalse()->yes() || $in->isNull()->yes()) { return $defaultType; } } if ($filterValue === $this->getConstant('FILTER_VALIDATE_INT')) { if ($in->isInteger()->yes()) { return $in; } if ($in->isTrue()->yes()) { return new ConstantIntegerType(1); } if ($in->isFalse()->yes() || $in->isNull()->yes()) { return $defaultType; } if ($in instanceof ConstantFloatType) { return $in->getValue() - (int) $in->getValue() === 0.0 ? $in->toInteger() : $defaultType; } if ($in instanceof ConstantStringType) { $value = $in->getValue(); $allowOctal = $this->hasFlag($this->getConstant('FILTER_FLAG_ALLOW_OCTAL'), $flagsType); $allowHex = $this->hasFlag($this->getConstant('FILTER_FLAG_ALLOW_HEX'), $flagsType); if ($allowOctal && preg_match('/\\A0[oO][0-7]+\\z/', $value) === 1) { $octalValue = octdec($value); return is_int($octalValue) ? new ConstantIntegerType($octalValue) : $defaultType; } if ($allowHex && preg_match('/\\A0[xX][0-9A-Fa-f]+\\z/', $value) === 1) { $hexValue = hexdec($value); return is_int($hexValue) ? new ConstantIntegerType($hexValue) : $defaultType; } return preg_match('/\\A[+-]?(?:0|[1-9][0-9]*)\\z/', $value) === 1 ? $in->toInteger() : $defaultType; } } if ($filterValue === $this->getConstant('FILTER_DEFAULT')) { if (!$this->canStringBeSanitized($filterValue, $flagsType) && $in->isString()->yes()) { return $in; } if ($in->isBoolean()->yes() || $in->isFloat()->yes() || $in->isInteger()->yes() || $in->isNull()->yes()) { return $in->toString(); } } return null; } /** @param array<string, ?Type> $typeOptions */ private function applyRangeOptions(Type $type, array $typeOptions, Type $defaultType) : Type { if (!$type->isInteger()->yes()) { return $type; } $range = []; if (isset($typeOptions['min_range'])) { if ($typeOptions['min_range'] instanceof ConstantScalarType) { $range['min'] = (int) $typeOptions['min_range']->getValue(); } elseif ($typeOptions['min_range'] instanceof IntegerRangeType) { $range['min'] = $typeOptions['min_range']->getMin(); } else { $range['min'] = null; } } if (isset($typeOptions['max_range'])) { if ($typeOptions['max_range'] instanceof ConstantScalarType) { $range['max'] = (int) $typeOptions['max_range']->getValue(); } elseif ($typeOptions['max_range'] instanceof IntegerRangeType) { $range['max'] = $typeOptions['max_range']->getMax(); } else { $range['max'] = null; } } if (array_key_exists('min', $range) || array_key_exists('max', $range)) { $min = $range['min'] ?? null; $max = $range['max'] ?? null; $rangeType = IntegerRangeType::fromInterval($min, $max); $rangeTypeIsSuperType = $rangeType->isSuperTypeOf($type); if ($rangeTypeIsSuperType->no()) { // e.g. if 9 is filtered with a range of int<17, 19> return $defaultType; } if ($rangeTypeIsSuperType->yes() && !$rangeType->equals($type)) { // e.g. if 18 or int<18, 19> are filtered with a range of int<17, 19> return $type; } // Open ranges on either side means that the input is potentially not part of the range return $min === null || $max === null ? TypeCombinator::union($rangeType, $defaultType) : $rangeType; } return $type; } private function hasOptions(Type $flagsType) : TrinaryLogic { return $flagsType->isArray()->and($flagsType->hasOffsetValueType(new ConstantStringType('options'))); } /** @return array<string, ?Type> */ private function getOptions(Type $flagsType, int $filterValue) : array { $options = []; $optionsType = $flagsType->getOffsetValueType(new ConstantStringType('options')); if (!$optionsType->isConstantArray()->yes()) { return $options; } $optionNames = array_merge(['default'], $this->getFilterTypeOptions()[$filterValue] ?? []); foreach ($optionNames as $optionName) { $optionalNameType = new ConstantStringType($optionName); if (!$optionsType->hasOffsetValueType($optionalNameType)->yes()) { $options[$optionName] = null; continue; } $options[$optionName] = $optionsType->getOffsetValueType($optionalNameType); } return $options; } private function hasFlag(int $flag, ?Type $flagsType) : bool { if ($flagsType === null) { return \false; } $type = $this->getFlagsValue($flagsType); return $type instanceof ConstantIntegerType && ($type->getValue() & $flag) === $flag; } private function getFlagsValue(Type $exprType) : Type { if (!$exprType->isConstantArray()->yes()) { return $exprType; } return $exprType->getOffsetValueType($this->flagsString); } private function canStringBeSanitized(int $filterValue, ?Type $flagsType) : bool { // If it is a validation filter, the string will not be changed if (($filterValue & self::VALIDATION_FILTER_BITMASK) !== 0) { return \false; } // FILTER_DEFAULT will not sanitize, unless it has FILTER_FLAG_STRIP_LOW, // FILTER_FLAG_STRIP_HIGH, or FILTER_FLAG_STRIP_BACKTICK if ($filterValue === $this->getConstant('FILTER_DEFAULT')) { return $this->hasFlag($this->getConstant('FILTER_FLAG_STRIP_LOW'), $flagsType) || $this->hasFlag($this->getConstant('FILTER_FLAG_STRIP_HIGH'), $flagsType) || $this->hasFlag($this->getConstant('FILTER_FLAG_STRIP_BACKTICK'), $flagsType); } return \true; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function in_array; final class ArrayNextDynamicReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return in_array($functionReflection->getName(), ['next', 'prev'], \true); } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (!isset($functionCall->getArgs()[0])) { return null; } $argType = $scope->getType($functionCall->getArgs()[0]->value); $iterableAtLeastOnce = $argType->isIterableAtLeastOnce(); if ($iterableAtLeastOnce->no()) { return new ConstantBooleanType(\false); } $valueType = $argType->getIterableValueType(); return TypeCombinator::union($valueType, new ConstantBooleanType(\false)); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Type\ClassStringType; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\TypeUtils; use PHPStan\Type\UnionType; use function array_map; use function count; final class GetParentClassDynamicFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { /** * @var ReflectionProvider */ private $reflectionProvider; public function __construct(ReflectionProvider $reflectionProvider) { $this->reflectionProvider = $reflectionProvider; } public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'get_parent_class'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (count($functionCall->getArgs()) === 0) { if ($scope->isInTrait()) { return null; } if ($scope->isInClass()) { return $this->findParentClassType($scope->getClassReflection()); } return new ConstantBooleanType(\false); } $argType = $scope->getType($functionCall->getArgs()[0]->value); if ($scope->isInTrait() && TypeUtils::findThisType($argType) !== null) { return null; } $constantStrings = $argType->getConstantStrings(); if (count($constantStrings) > 0) { return TypeCombinator::union(...array_map(function (ConstantStringType $stringType) : Type { return $this->findParentClassNameType($stringType->getValue()); }, $constantStrings)); } $classNames = $argType->getObjectClassNames(); if (count($classNames) > 0) { return TypeCombinator::union(...array_map(function (string $classNames) : Type { return $this->findParentClassNameType($classNames); }, $classNames)); } return null; } private function findParentClassNameType(string $className) : Type { if (!$this->reflectionProvider->hasClass($className)) { return new UnionType([new ClassStringType(), new ConstantBooleanType(\false)]); } $classReflection = $this->reflectionProvider->getClass($className); if ($classReflection->isInterface()) { return new UnionType([new ClassStringType(), new ConstantBooleanType(\false)]); } return $this->findParentClassType($classReflection); } private function findParentClassType(ClassReflection $classReflection) : Type { $parentClass = $classReflection->getParentClass(); if ($parentClass === null) { return new ConstantBooleanType(\false); } return new ConstantStringType($parentClass->getName(), \true); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\DynamicFunctionThrowTypeExtension; use PHPStan\Type\ObjectType; use PHPStan\Type\Type; use Throwable; use function count; final class AssertThrowTypeExtension implements DynamicFunctionThrowTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'assert'; } public function getThrowTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $funcCall, Scope $scope) : ?Type { if (count($funcCall->getArgs()) < 2) { return $functionReflection->getThrowType(); } $customThrow = $scope->getType($funcCall->getArgs()[1]->value); if ((new ObjectType(Throwable::class))->isSuperTypeOf($customThrow)->yes()) { return $customThrow; } return $functionReflection->getThrowType(); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\Php\SimpleXMLElementProperty; use PHPStan\Reflection\PropertiesClassReflectionExtension; use PHPStan\Reflection\PropertyReflection; use PHPStan\Type\BenevolentUnionType; use PHPStan\Type\NullType; use PHPStan\Type\ObjectType; final class SimpleXMLElementClassPropertyReflectionExtension implements PropertiesClassReflectionExtension { public function hasProperty(ClassReflection $classReflection, string $propertyName) : bool { return $classReflection->getName() === 'SimpleXMLElement' || $classReflection->isSubclassOf('SimpleXMLElement'); } public function getProperty(ClassReflection $classReflection, string $propertyName) : PropertyReflection { return new SimpleXMLElementProperty($classReflection, new BenevolentUnionType([new ObjectType($classReflection->getName()), new NullType()])); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\NeverType; use PHPStan\Type\NullType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function count; final class ArraySearchFunctionDynamicReturnTypeExtension implements DynamicFunctionReturnTypeExtension { /** * @var PhpVersion */ private $phpVersion; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; } public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'array_search'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { $argsCount = count($functionCall->getArgs()); if ($argsCount < 2) { return null; } $haystackArgType = $scope->getType($functionCall->getArgs()[1]->value); if ($haystackArgType->isArray()->no()) { return $this->phpVersion->arrayFunctionsReturnNullWithNonArray() ? new NullType() : new NeverType(); } if ($argsCount < 3) { return TypeCombinator::union($haystackArgType->getIterableKeyType(), new ConstantBooleanType(\false)); } $strictArgType = $scope->getType($functionCall->getArgs()[2]->value); if (!$strictArgType->isTrue()->yes()) { return TypeCombinator::union($haystackArgType->getIterableKeyType(), new ConstantBooleanType(\false)); } $needleArgType = $scope->getType($functionCall->getArgs()[0]->value); if ($haystackArgType->getIterableValueType()->isSuperTypeOf($needleArgType)->no()) { return new ConstantBooleanType(\false); } return $haystackArgType->searchArray($needleArgType); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\ArrayType; use PHPStan\Type\Constant\ConstantArrayTypeBuilder; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\MixedType; use PHPStan\Type\StringType; use PHPStan\Type\Type; final class GetDefinedVarsFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'get_defined_vars'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : Type { if ($scope->canAnyVariableExist()) { return new ArrayType(new StringType(), new MixedType()); } $typeBuilder = ConstantArrayTypeBuilder::createEmpty(); foreach ($scope->getDefinedVariables() as $variable) { $typeBuilder->setOffsetValueType(new ConstantStringType($variable), $scope->getVariableType($variable), \false); } foreach ($scope->getMaybeDefinedVariables() as $variable) { $typeBuilder->setOffsetValueType(new ConstantStringType($variable), $scope->getVariableType($variable), \true); } return $typeBuilder->getArray(); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\Cast; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Analyser\SpecifiedTypes; use PHPStan\Analyser\TypeSpecifier; use PHPStan\Analyser\TypeSpecifierAwareExtension; use PHPStan\Analyser\TypeSpecifierContext; use PHPStan\Reflection\FunctionReflection; use PHPStan\ShouldNotHappenException; use PHPStan\Type\Accessory\AccessoryNumericStringType; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\FunctionTypeSpecifyingExtension; use PHPStan\Type\IntegerRangeType; use PHPStan\Type\IntersectionType; use PHPStan\Type\StringType; use PHPStan\Type\TypeCombinator; use PHPStan\Type\UnionType; use function strtolower; final class CtypeDigitFunctionTypeSpecifyingExtension implements FunctionTypeSpecifyingExtension, TypeSpecifierAwareExtension { /** * @var TypeSpecifier */ private $typeSpecifier; public function isFunctionSupported(FunctionReflection $functionReflection, FuncCall $node, TypeSpecifierContext $context) : bool { return strtolower($functionReflection->getName()) === 'ctype_digit' && !$context->null(); } public function specifyTypes(FunctionReflection $functionReflection, FuncCall $node, Scope $scope, TypeSpecifierContext $context) : SpecifiedTypes { if (!isset($node->getArgs()[0])) { return new SpecifiedTypes(); } if ($context->null()) { throw new ShouldNotHappenException(); } $exprArg = $node->getArgs()[0]->value; if ($context->true() && $scope->getType($exprArg)->isNumericString()->yes()) { return new SpecifiedTypes(); } $types = [ IntegerRangeType::fromInterval(48, 57), // ASCII-codes for 0-9 IntegerRangeType::createAllGreaterThanOrEqualTo(256), ]; if ($context->true()) { $types[] = new IntersectionType([new StringType(), new AccessoryNumericStringType()]); } $unionType = TypeCombinator::union(...$types); $specifiedTypes = $this->typeSpecifier->create($exprArg, $unionType, $context, \false, $scope); if ($exprArg instanceof Cast\String_) { $castedType = new UnionType([IntegerRangeType::fromInterval(0, null), new IntersectionType([new StringType(), new AccessoryNumericStringType()]), new ConstantBooleanType(\true)]); $specifiedTypes = $specifiedTypes->unionWith($this->typeSpecifier->create($exprArg->expr, $castedType, $context, \false, $scope)); } return $specifiedTypes; } public function setTypeSpecifier(TypeSpecifier $typeSpecifier) : void { $this->typeSpecifier = $typeSpecifier; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr; use PHPStan\Analyser\Scope; use PHPStan\Php\PhpVersion; use PHPStan\TrinaryLogic; use PHPStan\Type\Accessory\AccessoryArrayListType; use PHPStan\Type\ArrayType; use PHPStan\Type\Constant\ConstantArrayType; use PHPStan\Type\Constant\ConstantArrayTypeBuilder; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\IntegerRangeType; use PHPStan\Type\IntegerType; use PHPStan\Type\NullType; use PHPStan\Type\Regex\RegexAlternation; use PHPStan\Type\Regex\RegexCapturingGroup; use PHPStan\Type\Regex\RegexExpressionHelper; use PHPStan\Type\Regex\RegexGroupParser; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function array_reverse; use function count; use function in_array; use function is_string; use const PREG_OFFSET_CAPTURE; use const PREG_PATTERN_ORDER; use const PREG_SET_ORDER; use const PREG_UNMATCHED_AS_NULL; /** * @api */ final class RegexArrayShapeMatcher { /** * @var RegexGroupParser */ private $regexGroupParser; /** * @var RegexExpressionHelper */ private $regexExpressionHelper; /** * @var PhpVersion */ private $phpVersion; /** * Pass this into $flagsType as well if the library supports emulating PREG_UNMATCHED_AS_NULL on PHP 7.2 and 7.3 */ public const PREG_UNMATCHED_AS_NULL_ON_72_73 = 2048; public function __construct(RegexGroupParser $regexGroupParser, RegexExpressionHelper $regexExpressionHelper, PhpVersion $phpVersion) { $this->regexGroupParser = $regexGroupParser; $this->regexExpressionHelper = $regexExpressionHelper; $this->phpVersion = $phpVersion; } public function matchAllExpr(Expr $patternExpr, ?Type $flagsType, TrinaryLogic $wasMatched, Scope $scope) : ?Type { return $this->matchPatternType($this->getPatternType($patternExpr, $scope), $flagsType, $wasMatched, \true); } public function matchExpr(Expr $patternExpr, ?Type $flagsType, TrinaryLogic $wasMatched, Scope $scope) : ?Type { return $this->matchPatternType($this->getPatternType($patternExpr, $scope), $flagsType, $wasMatched, \false); } /** * @deprecated use matchExpr() instead for a more precise result */ public function matchType(Type $patternType, ?Type $flagsType, TrinaryLogic $wasMatched) : ?Type { return $this->matchPatternType($patternType, $flagsType, $wasMatched, \false); } private function matchPatternType(Type $patternType, ?Type $flagsType, TrinaryLogic $wasMatched, bool $matchesAll) : ?Type { if ($wasMatched->no()) { return new ConstantArrayType([], []); } $constantStrings = $patternType->getConstantStrings(); if (count($constantStrings) === 0) { return null; } $flags = null; if ($flagsType !== null) { if (!$flagsType instanceof ConstantIntegerType) { return null; } /** @var int-mask<PREG_OFFSET_CAPTURE | PREG_PATTERN_ORDER | PREG_SET_ORDER | PREG_UNMATCHED_AS_NULL | self::PREG_UNMATCHED_AS_NULL_ON_72_73> $flags */ $flags = $flagsType->getValue() & (PREG_OFFSET_CAPTURE | PREG_PATTERN_ORDER | PREG_SET_ORDER | PREG_UNMATCHED_AS_NULL | self::PREG_UNMATCHED_AS_NULL_ON_72_73); // some other unsupported/unexpected flag was passed in if ($flags !== $flagsType->getValue()) { return null; } } $matchedTypes = []; foreach ($constantStrings as $constantString) { $matched = $this->matchRegex($constantString->getValue(), $flags, $wasMatched, $matchesAll); if ($matched === null) { return null; } $matchedTypes[] = $matched; } if (count($matchedTypes) === 1) { return $matchedTypes[0]; } return TypeCombinator::union(...$matchedTypes); } /** * @param int-mask<PREG_OFFSET_CAPTURE|PREG_PATTERN_ORDER|PREG_SET_ORDER|PREG_UNMATCHED_AS_NULL|self::PREG_UNMATCHED_AS_NULL_ON_72_73>|null $flags */ private function matchRegex(string $regex, ?int $flags, TrinaryLogic $wasMatched, bool $matchesAll) : ?Type { $parseResult = $this->regexGroupParser->parseGroups($regex); if ($parseResult === null) { // regex could not be parsed by Hoa/Regex return null; } [$groupList, $markVerbs] = $parseResult; $trailingOptionals = 0; foreach (array_reverse($groupList) as $captureGroup) { if (!$captureGroup->isOptional()) { break; } $trailingOptionals++; } $onlyOptionalTopLevelGroup = $this->getOnlyOptionalTopLevelGroup($groupList); $onlyTopLevelAlternation = $this->getOnlyTopLevelAlternation($groupList); $flags = $flags ?? 0; if (!$matchesAll && $wasMatched->yes() && $onlyOptionalTopLevelGroup !== null) { // if only one top level capturing optional group exists // we build a more precise tagged union of a empty-match and a match with the group $onlyOptionalTopLevelGroup->forceNonOptional(); $combiType = $this->buildArrayType($groupList, $wasMatched, $trailingOptionals, $flags, $markVerbs, $matchesAll); if (!$this->containsUnmatchedAsNull($flags, $matchesAll)) { // positive match has a subject but not any capturing group $combiType = TypeCombinator::union(new ConstantArrayType([new ConstantIntegerType(0)], [$this->createSubjectValueType($flags, $matchesAll)], [1], [], \true), $combiType); } $onlyOptionalTopLevelGroup->clearOverrides(); return $combiType; } elseif (!$matchesAll && $onlyOptionalTopLevelGroup === null && $onlyTopLevelAlternation !== null && !$wasMatched->no()) { // if only a single top level alternation exist built a more precise tagged union $combiTypes = []; $isOptionalAlternation = \false; foreach ($onlyTopLevelAlternation->getGroupCombinations() as $groupCombo) { $comboList = $groupList; $beforeCurrentCombo = \true; foreach ($comboList as $groupId => $group) { if (in_array($groupId, $groupCombo, \true)) { $isOptionalAlternation = $group->inOptionalAlternation(); $group->forceNonOptional(); $beforeCurrentCombo = \false; } elseif ($beforeCurrentCombo && !$group->resetsGroupCounter()) { $group->forceNonOptional(); $group->forceType($this->containsUnmatchedAsNull($flags, $matchesAll) ? new NullType() : new ConstantStringType('')); } elseif ($group->getAlternationId() === $onlyTopLevelAlternation->getId() && !$this->containsUnmatchedAsNull($flags, $matchesAll)) { unset($comboList[$groupId]); } } $combiType = $this->buildArrayType($comboList, $wasMatched, $trailingOptionals, $flags, $markVerbs, $matchesAll); $combiTypes[] = $combiType; foreach ($groupCombo as $groupId) { $group = $comboList[$groupId]; $group->clearOverrides(); } } if (!$this->containsUnmatchedAsNull($flags, $matchesAll) && ($onlyTopLevelAlternation->getAlternationsCount() !== count($onlyTopLevelAlternation->getGroupCombinations()) || $isOptionalAlternation)) { // positive match has a subject but not any capturing group $combiTypes[] = new ConstantArrayType([new ConstantIntegerType(0)], [$this->createSubjectValueType($flags, $matchesAll)], [1], [], \true); } return TypeCombinator::union(...$combiTypes); } // the general case, which should work in all cases but does not yield the most // precise result possible in some cases return $this->buildArrayType($groupList, $wasMatched, $trailingOptionals, $flags, $markVerbs, $matchesAll); } /** * @param array<int, RegexCapturingGroup> $captureGroups */ private function getOnlyOptionalTopLevelGroup(array $captureGroups) : ?RegexCapturingGroup { $group = null; foreach ($captureGroups as $captureGroup) { if (!$captureGroup->isTopLevel()) { continue; } if (!$captureGroup->isOptional()) { return null; } if ($group !== null) { return null; } $group = $captureGroup; } return $group; } /** * @param array<int, RegexCapturingGroup> $captureGroups */ private function getOnlyTopLevelAlternation(array $captureGroups) : ?RegexAlternation { $alternation = null; foreach ($captureGroups as $captureGroup) { if (!$captureGroup->isTopLevel()) { continue; } if (!$captureGroup->inAlternation()) { return null; } if ($captureGroup->inOptionalQuantification()) { return null; } if ($alternation === null) { $alternation = $captureGroup->getAlternation(); } elseif ($alternation->getId() !== $captureGroup->getAlternation()->getId()) { return null; } } return $alternation; } /** * @param array<RegexCapturingGroup> $captureGroups * @param list<string> $markVerbs */ private function buildArrayType(array $captureGroups, TrinaryLogic $wasMatched, int $trailingOptionals, int $flags, array $markVerbs, bool $matchesAll) : Type { $builder = ConstantArrayTypeBuilder::createEmpty(); // first item in matches contains the overall match. $builder->setOffsetValueType($this->getKeyType(0), $this->createSubjectValueType($flags, $matchesAll), $this->isSubjectOptional($wasMatched, $matchesAll)); $countGroups = count($captureGroups); $i = 0; foreach ($captureGroups as $captureGroup) { $isTrailingOptional = $i >= $countGroups - $trailingOptionals; $isLastGroup = $i === $countGroups - 1; $groupValueType = $this->createGroupValueType($captureGroup, $wasMatched, $flags, $isTrailingOptional, $isLastGroup, $matchesAll); $optional = $this->isGroupOptional($captureGroup, $wasMatched, $flags, $isTrailingOptional, $matchesAll); if ($captureGroup->isNamed()) { $builder->setOffsetValueType($this->getKeyType($captureGroup->getName()), $groupValueType, $optional); } $builder->setOffsetValueType($this->getKeyType($i + 1), $groupValueType, $optional); $i++; } if (count($markVerbs) > 0) { $markTypes = []; foreach ($markVerbs as $mark) { $markTypes[] = new ConstantStringType($mark); } $builder->setOffsetValueType($this->getKeyType('MARK'), TypeCombinator::union(...$markTypes), \true); } if ($matchesAll && $this->containsSetOrder($flags)) { $arrayType = AccessoryArrayListType::intersectWith(new ArrayType(new IntegerType(), $builder->getArray())); if (!$wasMatched->yes()) { $arrayType = TypeCombinator::union(new ConstantArrayType([], []), $arrayType); } return $arrayType; } return $builder->getArray(); } private function isSubjectOptional(TrinaryLogic $wasMatched, bool $matchesAll) : bool { if ($matchesAll) { return \false; } return !$wasMatched->yes(); } private function createSubjectValueType(int $flags, bool $matchesAll) : Type { $subjectValueType = TypeCombinator::removeNull($this->getValueType(new StringType(), $flags, $matchesAll)); if ($matchesAll) { if ($this->containsPatternOrder($flags)) { $subjectValueType = AccessoryArrayListType::intersectWith(new ArrayType(new IntegerType(), $subjectValueType)); } } return $subjectValueType; } private function isGroupOptional(RegexCapturingGroup $captureGroup, TrinaryLogic $wasMatched, int $flags, bool $isTrailingOptional, bool $matchesAll) : bool { if ($matchesAll) { if ($isTrailingOptional && !$this->containsUnmatchedAsNull($flags, $matchesAll) && $this->containsSetOrder($flags)) { return \true; } return \false; } if (!$wasMatched->yes()) { $optional = \true; } else { if (!$isTrailingOptional) { $optional = \false; } elseif ($this->containsUnmatchedAsNull($flags, $matchesAll)) { $optional = \false; } else { $optional = $captureGroup->isOptional(); } } return $optional; } private function createGroupValueType(RegexCapturingGroup $captureGroup, TrinaryLogic $wasMatched, int $flags, bool $isTrailingOptional, bool $isLastGroup, bool $matchesAll) : Type { if ($matchesAll) { if (!$this->containsSetOrder($flags) && !$this->containsUnmatchedAsNull($flags, $matchesAll) && $captureGroup->isOptional() || $this->containsSetOrder($flags) && !$this->containsUnmatchedAsNull($flags, $matchesAll) && $captureGroup->isOptional() && !$isTrailingOptional) { $groupValueType = $this->getValueType(TypeCombinator::union($captureGroup->getType(), new ConstantStringType('')), $flags, $matchesAll); $groupValueType = TypeCombinator::removeNull($groupValueType); } else { $groupValueType = $this->getValueType($captureGroup->getType(), $flags, $matchesAll); } if (!$isTrailingOptional && $this->containsUnmatchedAsNull($flags, $matchesAll) && !$captureGroup->isOptional()) { $groupValueType = TypeCombinator::removeNull($groupValueType); } if ($this->containsPatternOrder($flags)) { $groupValueType = AccessoryArrayListType::intersectWith(new ArrayType(new IntegerType(), $groupValueType)); } return $groupValueType; } if (!$isLastGroup && !$this->containsUnmatchedAsNull($flags, $matchesAll) && $captureGroup->isOptional()) { $groupValueType = $this->getValueType(TypeCombinator::union($captureGroup->getType(), new ConstantStringType('')), $flags, $matchesAll); } else { $groupValueType = $this->getValueType($captureGroup->getType(), $flags, $matchesAll); } if ($wasMatched->yes()) { if (!$isTrailingOptional && $this->containsUnmatchedAsNull($flags, $matchesAll) && !$captureGroup->isOptional()) { $groupValueType = TypeCombinator::removeNull($groupValueType); } } return $groupValueType; } private function containsOffsetCapture(int $flags) : bool { return ($flags & PREG_OFFSET_CAPTURE) !== 0; } private function containsPatternOrder(int $flags) : bool { // If no order flag is given, PREG_PATTERN_ORDER is assumed. return !$this->containsSetOrder($flags); } private function containsSetOrder(int $flags) : bool { return ($flags & PREG_SET_ORDER) !== 0; } private function containsUnmatchedAsNull(int $flags, bool $matchesAll) : bool { if ($matchesAll) { // preg_match_all() with PREG_UNMATCHED_AS_NULL works consistently across php-versions // https://3v4l.org/tKmPn return ($flags & PREG_UNMATCHED_AS_NULL) !== 0; } return ($flags & PREG_UNMATCHED_AS_NULL) !== 0 && (($flags & self::PREG_UNMATCHED_AS_NULL_ON_72_73) !== 0 || $this->phpVersion->supportsPregUnmatchedAsNull()); } /** * @param int|string $key */ private function getKeyType($key) : Type { if (is_string($key)) { return new ConstantStringType($key); } return new ConstantIntegerType($key); } private function getValueType(Type $baseType, int $flags, bool $matchesAll) : Type { $valueType = $baseType; // unmatched groups return -1 as offset $offsetType = IntegerRangeType::fromInterval(-1, null); if ($this->containsUnmatchedAsNull($flags, $matchesAll)) { $valueType = TypeCombinator::addNull($valueType); } if ($this->containsOffsetCapture($flags)) { $builder = ConstantArrayTypeBuilder::createEmpty(); $builder->setOffsetValueType(new ConstantIntegerType(0), $valueType); $builder->setOffsetValueType(new ConstantIntegerType(1), $offsetType); return $builder->getArray(); } return $valueType; } private function getPatternType(Expr $patternExpr, Scope $scope) : Type { if ($patternExpr instanceof Expr\BinaryOp\Concat) { return $this->regexExpressionHelper->resolvePatternConcat($patternExpr, $scope); } return $scope->getType($patternExpr); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\ErrorType; use PHPStan\Type\Type; final class AbsFunctionDynamicReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'abs'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { $args = $functionCall->getArgs(); if (!isset($args[0])) { return null; } $inputType = $scope->getType($args[0]->value); $outputType = $inputType->toAbsoluteNumber(); if ($outputType instanceof ErrorType) { return null; } return $outputType; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function array_map; use function count; final class ArrayFindFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { /** * @var ArrayFilterFunctionReturnTypeHelper */ private $arrayFilterFunctionReturnTypeHelper; public function __construct(\PHPStan\Type\Php\ArrayFilterFunctionReturnTypeHelper $arrayFilterFunctionReturnTypeHelper) { $this->arrayFilterFunctionReturnTypeHelper = $arrayFilterFunctionReturnTypeHelper; } public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'array_find'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (count($functionCall->getArgs()) < 2) { return null; } $arrayType = $scope->getType($functionCall->getArgs()[0]->value); if (count($arrayType->getArrays()) < 1) { return null; } $arrayArg = $functionCall->getArgs()[0]->value ?? null; $callbackArg = $functionCall->getArgs()[1]->value ?? null; $resultTypes = $this->arrayFilterFunctionReturnTypeHelper->getType($scope, $arrayArg, $callbackArg, null); $resultType = TypeCombinator::union(...array_map(static function ($type) { return $type->getIterableValueType(); }, $resultTypes->getArrays())); return $resultTypes->isIterableAtLeastOnce()->yes() ? $resultType : TypeCombinator::addNull($resultType); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Analyser\SpecifiedTypes; use PHPStan\Analyser\TypeSpecifier; use PHPStan\Analyser\TypeSpecifierAwareExtension; use PHPStan\Analyser\TypeSpecifierContext; use PHPStan\Reflection\FunctionReflection; use PHPStan\ShouldNotHappenException; use PHPStan\Type\ArrayType; use PHPStan\Type\FunctionTypeSpecifyingExtension; use PHPStan\Type\MixedType; use function strtolower; final class IsArrayFunctionTypeSpecifyingExtension implements FunctionTypeSpecifyingExtension, TypeSpecifierAwareExtension { /** * @var bool */ private $explicitMixed; /** * @var TypeSpecifier */ private $typeSpecifier; public function __construct(bool $explicitMixed) { $this->explicitMixed = $explicitMixed; } public function isFunctionSupported(FunctionReflection $functionReflection, FuncCall $node, TypeSpecifierContext $context) : bool { return strtolower($functionReflection->getName()) === 'is_array' && !$context->null(); } public function specifyTypes(FunctionReflection $functionReflection, FuncCall $node, Scope $scope, TypeSpecifierContext $context) : SpecifiedTypes { if (!isset($node->getArgs()[0])) { return new SpecifiedTypes(); } if ($context->null()) { throw new ShouldNotHappenException(); } return $this->typeSpecifier->create($node->getArgs()[0]->value, new ArrayType(new MixedType($this->explicitMixed), new MixedType($this->explicitMixed)), $context, \false, $scope); } public function setTypeSpecifier(TypeSpecifier $typeSpecifier) : void { $this->typeSpecifier = $typeSpecifier; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\Type; use function count; final class FilterInputDynamicReturnTypeExtension implements DynamicFunctionReturnTypeExtension { /** * @var FilterFunctionReturnTypeHelper */ private $filterFunctionReturnTypeHelper; public function __construct(\PHPStan\Type\Php\FilterFunctionReturnTypeHelper $filterFunctionReturnTypeHelper) { $this->filterFunctionReturnTypeHelper = $filterFunctionReturnTypeHelper; } public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'filter_input'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (count($functionCall->getArgs()) < 2) { return null; } return $this->filterFunctionReturnTypeHelper->getInputType($scope->getType($functionCall->getArgs()[0]->value), $scope->getType($functionCall->getArgs()[1]->value), isset($functionCall->getArgs()[2]) ? $scope->getType($functionCall->getArgs()[2]->value) : null, isset($functionCall->getArgs()[3]) ? $scope->getType($functionCall->getArgs()[3]->value) : null); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\MethodCall; use PhpParser\Node\Expr\StaticCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\MethodReflection; use PHPStan\Type\BooleanType; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\DynamicMethodReturnTypeExtension; use PHPStan\Type\DynamicStaticMethodReturnTypeExtension; use PHPStan\Type\ObjectType; use PHPStan\Type\Type; use PHPStan\Type\UnionType; final class XMLReaderOpenReturnTypeExtension implements DynamicMethodReturnTypeExtension, DynamicStaticMethodReturnTypeExtension { private const XML_READER_CLASS = 'XMLReader'; public function getClass() : string { return self::XML_READER_CLASS; } public function isMethodSupported(MethodReflection $methodReflection) : bool { return $methodReflection->getName() === 'open'; } public function isStaticMethodSupported(MethodReflection $methodReflection) : bool { return $this->isMethodSupported($methodReflection); } public function getTypeFromMethodCall(MethodReflection $methodReflection, MethodCall $methodCall, Scope $scope) : Type { return new BooleanType(); } public function getTypeFromStaticMethodCall(MethodReflection $methodReflection, StaticCall $methodCall, Scope $scope) : Type { return new UnionType([new ObjectType(self::XML_READER_CLASS), new ConstantBooleanType(\false)]); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Accessory\AccessoryNonEmptyStringType; use PHPStan\Type\Accessory\AccessoryNonFalsyStringType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\IntersectionType; use PHPStan\Type\StringType; use PHPStan\Type\Type; use function count; use function in_array; final class NonEmptyStringFunctionsReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return in_array($functionReflection->getName(), ['addslashes', 'addcslashes', 'escapeshellarg', 'escapeshellcmd', 'htmlspecialchars', 'htmlentities', 'urlencode', 'urldecode', 'preg_quote', 'rawurlencode', 'rawurldecode'], \true); } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { $args = $functionCall->getArgs(); if (count($args) === 0) { return null; } $argType = $scope->getType($args[0]->value); if ($argType->isNonFalsyString()->yes()) { return new IntersectionType([new StringType(), new AccessoryNonFalsyStringType()]); } if ($argType->isNonEmptyString()->yes()) { return new IntersectionType([new StringType(), new AccessoryNonEmptyStringType()]); } return new StringType(); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Accessory\AccessoryArrayListType; use PHPStan\Type\Accessory\AccessoryLowercaseStringType; use PHPStan\Type\Accessory\AccessoryUppercaseStringType; use PHPStan\Type\Accessory\NonEmptyArrayType; use PHPStan\Type\ArrayType; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\IntegerRangeType; use PHPStan\Type\IntegerType; use PHPStan\Type\IntersectionType; use PHPStan\Type\MixedType; use PHPStan\Type\NeverType; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\TypeUtils; use function count; final class ExplodeFunctionDynamicReturnTypeExtension implements DynamicFunctionReturnTypeExtension { /** * @var PhpVersion */ private $phpVersion; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; } public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'explode'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { $args = $functionCall->getArgs(); if (count($args) < 2) { return null; } $delimiterType = $scope->getType($args[0]->value); $isEmptyString = (new ConstantStringType(''))->isSuperTypeOf($delimiterType); if ($isEmptyString->yes()) { if ($this->phpVersion->throwsTypeErrorForInternalFunctions()) { return new NeverType(); } return new ConstantBooleanType(\false); } $stringType = $scope->getType($args[1]->value); $accessory = []; if ($stringType->isLowercaseString()->yes()) { $accessory[] = new AccessoryLowercaseStringType(); } if ($stringType->isUppercaseString()->yes()) { $accessory[] = new AccessoryUppercaseStringType(); } if (count($accessory) > 0) { $accessory[] = new StringType(); $returnValueType = new IntersectionType($accessory); } else { $returnValueType = new StringType(); } $returnType = AccessoryArrayListType::intersectWith(new ArrayType(new IntegerType(), $returnValueType)); if (!isset($args[2]) || IntegerRangeType::fromInterval(0, null)->isSuperTypeOf($scope->getType($args[2]->value))->yes()) { $returnType = TypeCombinator::intersect($returnType, new NonEmptyArrayType()); } if (!$this->phpVersion->throwsValueErrorForInternalFunctions() && $isEmptyString->maybe()) { $returnType = TypeCombinator::union($returnType, new ConstantBooleanType(\false)); } if ($delimiterType instanceof MixedType) { $returnType = TypeUtils::toBenevolentUnion($returnType); } return $returnType; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\StaticCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\MethodReflection; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Type\DynamicStaticMethodThrowTypeExtension; use PHPStan\Type\NeverType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use ReflectionProperty; use function count; final class ReflectionPropertyConstructorThrowTypeExtension implements DynamicStaticMethodThrowTypeExtension { /** * @var ReflectionProvider */ private $reflectionProvider; public function __construct(ReflectionProvider $reflectionProvider) { $this->reflectionProvider = $reflectionProvider; } public function isStaticMethodSupported(MethodReflection $methodReflection) : bool { return $methodReflection->getName() === '__construct' && $methodReflection->getDeclaringClass()->getName() === ReflectionProperty::class; } public function getThrowTypeFromStaticMethodCall(MethodReflection $methodReflection, StaticCall $methodCall, Scope $scope) : ?Type { if (count($methodCall->getArgs()) < 2) { return $methodReflection->getThrowType(); } $valueType = $scope->getType($methodCall->getArgs()[0]->value); $propertyType = $scope->getType($methodCall->getArgs()[1]->value); foreach ($valueType->getConstantStrings() as $constantString) { if (!$this->reflectionProvider->hasClass($constantString->getValue())) { return $methodReflection->getThrowType(); } $classReflection = $this->reflectionProvider->getClass($constantString->getValue()); foreach ($propertyType->getConstantStrings() as $constantPropertyString) { if (!$classReflection->hasProperty($constantPropertyString->getValue())) { return $methodReflection->getThrowType(); } } $valueType = TypeCombinator::remove($valueType, $constantString); } if (!$valueType instanceof NeverType) { return $methodReflection->getThrowType(); } // Look for non constantStrings value. foreach ($propertyType->getConstantStrings() as $constantPropertyString) { $propertyType = TypeCombinator::remove($propertyType, $constantPropertyString); } if (!$propertyType instanceof NeverType) { return $methodReflection->getThrowType(); } return null; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PhpParser\Node\Name; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Type\BitwiseFlagHelper; use PHPStan\Type\DynamicFunctionThrowTypeExtension; use PHPStan\Type\ObjectType; use PHPStan\Type\Type; use function in_array; final class JsonThrowTypeExtension implements DynamicFunctionThrowTypeExtension { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var BitwiseFlagHelper */ private $bitwiseFlagAnalyser; private const ARGUMENTS_POSITIONS = ['json_encode' => 1, 'json_decode' => 3]; public function __construct(ReflectionProvider $reflectionProvider, BitwiseFlagHelper $bitwiseFlagAnalyser) { $this->reflectionProvider = $reflectionProvider; $this->bitwiseFlagAnalyser = $bitwiseFlagAnalyser; } public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return in_array($functionReflection->getName(), ['json_encode', 'json_decode'], \true) && $this->reflectionProvider->hasConstant(new Name\FullyQualified('JSON_THROW_ON_ERROR'), null); } public function getThrowTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { $argumentPosition = self::ARGUMENTS_POSITIONS[$functionReflection->getName()]; if (!isset($functionCall->getArgs()[$argumentPosition])) { return null; } $optionsExpr = $functionCall->getArgs()[$argumentPosition]->value; if (!$this->bitwiseFlagAnalyser->bitwiseOrContainsConstant($optionsExpr, $scope, 'JSON_THROW_ON_ERROR')->no()) { return new ObjectType('JsonException'); } return null; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Accessory\AccessoryLiteralStringType; use PHPStan\Type\Accessory\AccessoryLowercaseStringType; use PHPStan\Type\Accessory\AccessoryNonEmptyStringType; use PHPStan\Type\Accessory\AccessoryNonFalsyStringType; use PHPStan\Type\Accessory\AccessoryUppercaseStringType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\IntegerRangeType; use PHPStan\Type\IntersectionType; use PHPStan\Type\StringType; use PHPStan\Type\Type; use function count; final class StrPadFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'str_pad'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : Type { $args = $functionCall->getArgs(); if (count($args) < 2) { return new StringType(); } $inputType = $scope->getType($args[0]->value); $lengthType = $scope->getType($args[1]->value); $accessoryTypes = []; if ($inputType->isNonFalsyString()->yes()) { $accessoryTypes[] = new AccessoryNonFalsyStringType(); } elseif ($inputType->isNonEmptyString()->yes() || IntegerRangeType::fromInterval(1, null)->isSuperTypeOf($lengthType)->yes()) { $accessoryTypes[] = new AccessoryNonEmptyStringType(); } if (count($args) < 3) { $padStringType = null; } else { $padStringType = $scope->getType($args[2]->value); } if ($inputType->isLiteralString()->yes() && ($padStringType === null || $padStringType->isLiteralString()->yes())) { $accessoryTypes[] = new AccessoryLiteralStringType(); } if ($inputType->isLowercaseString()->yes() && ($padStringType === null || $padStringType->isLowercaseString()->yes())) { $accessoryTypes[] = new AccessoryLowercaseStringType(); } if ($inputType->isUppercaseString()->yes() && ($padStringType === null || $padStringType->isUppercaseString()->yes())) { $accessoryTypes[] = new AccessoryUppercaseStringType(); } if (count($accessoryTypes) > 0) { $accessoryTypes[] = new StringType(); return new IntersectionType($accessoryTypes); } return new StringType(); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use DateTime; use DateTimeInterface; use PhpParser\Node\Expr\MethodCall; use PHPStan\Analyser\Scope; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\MethodReflection; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\DynamicMethodReturnTypeExtension; use PHPStan\Type\NeverType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use Throwable; use function count; final class DateTimeModifyReturnTypeExtension implements DynamicMethodReturnTypeExtension { /** * @var PhpVersion */ private $phpVersion; /** * @var class-string<DateTimeInterface> */ private $dateTimeClass; /** @param class-string<DateTimeInterface> $dateTimeClass */ public function __construct(PhpVersion $phpVersion, string $dateTimeClass = DateTime::class) { $this->phpVersion = $phpVersion; $this->dateTimeClass = $dateTimeClass; } public function getClass() : string { return $this->dateTimeClass; } public function isMethodSupported(MethodReflection $methodReflection) : bool { return $methodReflection->getName() === 'modify'; } public function getTypeFromMethodCall(MethodReflection $methodReflection, MethodCall $methodCall, Scope $scope) : ?Type { if (count($methodCall->getArgs()) < 1) { return null; } $valueType = $scope->getType($methodCall->getArgs()[0]->value); $constantStrings = $valueType->getConstantStrings(); $hasFalse = \false; $hasDateTime = \false; foreach ($constantStrings as $constantString) { try { $result = @(new DateTime())->modify($constantString->getValue()); } catch (Throwable $e) { $valueType = TypeCombinator::remove($valueType, $constantString); continue; } if ($result === \false) { $hasFalse = \true; } else { $hasDateTime = \true; } $valueType = TypeCombinator::remove($valueType, $constantString); } if (!$valueType instanceof NeverType) { return null; } if ($hasFalse) { if (!$hasDateTime) { return new ConstantBooleanType(\false); } return null; } elseif ($hasDateTime) { return $scope->getType($methodCall->var); } if ($this->phpVersion->hasDateTimeExceptions()) { return new NeverType(); } return null; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr; use PhpParser\Node\Expr\ClassConstFetch; use PhpParser\Node\Expr\ConstFetch; use PhpParser\Node\Identifier; use PhpParser\Node\Name; use PhpParser\Node\Name\FullyQualified; use function count; use function explode; use function ltrim; final class ConstantHelper { public function createExprFromConstantName(string $constantName) : ?Expr { if ($constantName === '') { return null; } $classConstParts = explode('::', $constantName); if (count($classConstParts) >= 2) { $fqcn = ltrim($classConstParts[0], '\\'); if ($fqcn === '') { return null; } $classConstName = new FullyQualified($fqcn); if ($classConstName->isSpecialClassName()) { $classConstName = new Name($classConstName->toString()); } return new ClassConstFetch($classConstName, new Identifier($classConstParts[1])); } return new ConstFetch(new FullyQualified($constantName)); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\StaticCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\MethodReflection; use PHPStan\Type\ClassStringType; use PHPStan\Type\DynamicStaticMethodThrowTypeExtension; use PHPStan\Type\ObjectWithoutClassType; use PHPStan\Type\Type; use PHPStan\Type\UnionType; use ReflectionClass; use function count; final class ReflectionClassConstructorThrowTypeExtension implements DynamicStaticMethodThrowTypeExtension { public function isStaticMethodSupported(MethodReflection $methodReflection) : bool { return $methodReflection->getName() === '__construct' && $methodReflection->getDeclaringClass()->getName() === ReflectionClass::class; } public function getThrowTypeFromStaticMethodCall(MethodReflection $methodReflection, StaticCall $methodCall, Scope $scope) : ?Type { if (count($methodCall->getArgs()) < 1) { return $methodReflection->getThrowType(); } $valueType = $scope->getType($methodCall->getArgs()[0]->value); $classOrString = new UnionType([new ClassStringType(), new ObjectWithoutClassType()]); if ($classOrString->isSuperTypeOf($valueType)->yes()) { return null; } return $methodReflection->getThrowType(); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\ParametersAcceptorSelector; use PHPStan\Type\ArrayType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\IntegerType; use PHPStan\Type\NullType; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\UnionType; use function count; final class PregFilterFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'preg_filter'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : Type { $defaultReturn = ParametersAcceptorSelector::selectFromArgs($scope, $functionCall->getArgs(), $functionReflection->getVariants())->getReturnType(); $argsCount = count($functionCall->getArgs()); if ($argsCount < 3) { return $defaultReturn; } $subjectType = $scope->getType($functionCall->getArgs()[2]->value); if ($subjectType->isArray()->yes()) { return new ArrayType(new IntegerType(), new StringType()); } if ($subjectType->isString()->yes()) { return new UnionType([new StringType(), new NullType()]); } return $defaultReturn; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PhpParser\Node\Expr\MethodCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\MethodReflection; use PHPStan\Type\Constant\ConstantArrayTypeBuilder; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\DynamicMethodReturnTypeExtension; use PHPStan\Type\IntegerType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use SplFileObject; use function in_array; final class StatDynamicReturnTypeExtension implements DynamicFunctionReturnTypeExtension, DynamicMethodReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return in_array($functionReflection->getName(), ['stat', 'lstat', 'fstat', 'ssh2_sftp_stat'], \true); } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : Type { return TypeCombinator::union($this->getReturnType(), new ConstantBooleanType(\false)); } public function getClass() : string { return SplFileObject::class; } public function isMethodSupported(MethodReflection $methodReflection) : bool { return $methodReflection->getName() === 'fstat'; } public function getTypeFromMethodCall(MethodReflection $methodReflection, MethodCall $methodCall, Scope $scope) : Type { return $this->getReturnType(); } private function getReturnType() : Type { $valueType = new IntegerType(); $builder = ConstantArrayTypeBuilder::createEmpty(); $keys = ['dev', 'ino', 'mode', 'nlink', 'uid', 'gid', 'rdev', 'size', 'atime', 'mtime', 'ctime', 'blksize', 'blocks']; foreach ($keys as $key) { $builder->setOffsetValueType(null, $valueType); } foreach ($keys as $key) { $builder->setOffsetValueType(new ConstantStringType($key), $valueType); } return $builder->getArray(); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\ParametersAcceptorSelector; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\IntegerRangeType; use PHPStan\Type\IntegerType; use PHPStan\Type\MixedType; use PHPStan\Type\Type; use PHPStan\Type\TypeUtils; use function array_map; use function array_unique; use function count; use function gettype; use function min; use function strtotime; final class StrtotimeFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'strtotime'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : Type { $defaultReturnType = ParametersAcceptorSelector::selectFromArgs($scope, $functionCall->getArgs(), $functionReflection->getVariants())->getReturnType(); if (count($functionCall->getArgs()) === 0) { return $defaultReturnType; } $argType = $scope->getType($functionCall->getArgs()[0]->value); if ($argType instanceof MixedType) { return TypeUtils::toBenevolentUnion($defaultReturnType); } $results = array_unique(array_map(static function (ConstantStringType $string) { return strtotime($string->getValue()); }, $argType->getConstantStrings())); $resultTypes = array_unique(array_map(static function ($value) : string { return gettype($value); }, $results)); if (count($resultTypes) !== 1 || count($results) === 0) { return $defaultReturnType; } if ($results[0] === \false) { return new ConstantBooleanType(\false); } // 2nd param $baseTimestamp is too non-deterministic so simply return int if (count($functionCall->getArgs()) > 1) { return new IntegerType(); } // if it is positive we can narrow down to positive-int as long as time flows forward if (min(array_map('intval', $results)) > 0) { return IntegerRangeType::createAllGreaterThan(0); } return new IntegerType(); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Constant\ConstantArrayType; use PHPStan\Type\Constant\ConstantArrayTypeBuilder; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\Type; use function array_merge; use function count; final class CompactFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { /** * @var bool */ private $checkMaybeUndefinedVariables; public function __construct(bool $checkMaybeUndefinedVariables) { $this->checkMaybeUndefinedVariables = $checkMaybeUndefinedVariables; } public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'compact'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (count($functionCall->getArgs()) === 0) { return null; } if ($scope->canAnyVariableExist() && !$this->checkMaybeUndefinedVariables) { return null; } $array = ConstantArrayTypeBuilder::createEmpty(); foreach ($functionCall->getArgs() as $arg) { $type = $scope->getType($arg->value); $constantStrings = $this->findConstantStrings($type); if ($constantStrings === null) { return null; } foreach ($constantStrings as $constantString) { $has = $scope->hasVariableType($constantString->getValue()); if ($has->no()) { continue; } $array->setOffsetValueType($constantString, $scope->getVariableType($constantString->getValue()), $has->maybe()); } } return $array->getArray(); } /** * @return array<int, ConstantStringType>|null */ private function findConstantStrings(Type $type) : ?array { if ($type instanceof ConstantStringType) { return [$type]; } if ($type instanceof ConstantArrayType) { $result = []; foreach ($type->getValueTypes() as $valueType) { $constantStrings = $this->findConstantStrings($valueType); if ($constantStrings === null) { return null; } $result = array_merge($result, $constantStrings); } return $result; } return null; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use ArithmeticError; use DivisionByZeroError; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\DynamicFunctionThrowTypeExtension; use PHPStan\Type\ObjectType; use PHPStan\Type\Type; use function count; use const PHP_INT_MIN; final class IntdivThrowTypeExtension implements DynamicFunctionThrowTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'intdiv'; } public function getThrowTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $funcCall, Scope $scope) : ?Type { if (count($funcCall->getArgs()) < 2) { return $functionReflection->getThrowType(); } $valueType = $scope->getType($funcCall->getArgs()[0]->value)->toInteger(); $containsMin = $valueType->isSuperTypeOf(new ConstantIntegerType(PHP_INT_MIN)); $divisorType = $scope->getType($funcCall->getArgs()[1]->value)->toInteger(); if (!$containsMin->no()) { $divisionByMinusOne = $divisorType->isSuperTypeOf(new ConstantIntegerType(-1)); if (!$divisionByMinusOne->no()) { return new ObjectType(ArithmeticError::class); } } $divisionByZero = $divisorType->isSuperTypeOf(new ConstantIntegerType(0)); if (!$divisionByZero->no()) { return new ObjectType(DivisionByZeroError::class); } return null; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Accessory\AccessoryNumericStringType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\ConstantScalarType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\IntersectionType; use PHPStan\Type\StringType; use PHPStan\Type\Type; use function in_array; final class NumberFormatFunctionDynamicReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'number_format'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : Type { $stringType = new StringType(); if (!isset($functionCall->getArgs()[3])) { return $stringType; } $thousandsType = $scope->getType($functionCall->getArgs()[3]->value); $decimalType = $scope->getType($functionCall->getArgs()[2]->value); if (!$thousandsType instanceof ConstantStringType || $thousandsType->getValue() !== '') { return $stringType; } if (!$decimalType instanceof ConstantScalarType || !in_array($decimalType->getValue(), [null, '.', ''], \true)) { return $stringType; } return new IntersectionType([$stringType, new AccessoryNumericStringType()]); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use _PHPStan_7d8742a37\Nette\Utils\Strings; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Accessory\AccessoryLiteralStringType; use PHPStan\Type\Accessory\AccessoryLowercaseStringType; use PHPStan\Type\Accessory\AccessoryNonEmptyStringType; use PHPStan\Type\Accessory\AccessoryNonFalsyStringType; use PHPStan\Type\Accessory\AccessoryNumericStringType; use PHPStan\Type\Accessory\AccessoryUppercaseStringType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\IntegerRangeType; use PHPStan\Type\IntersectionType; use PHPStan\Type\NeverType; use PHPStan\Type\StringType; use PHPStan\Type\Type; use function count; use function str_repeat; use function strlen; final class StrRepeatFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'str_repeat'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : Type { $args = $functionCall->getArgs(); if (count($args) < 2) { return new StringType(); } $multiplierType = $scope->getType($args[1]->value); if ((new ConstantIntegerType(0))->isSuperTypeOf($multiplierType)->yes()) { return new ConstantStringType(''); } if (IntegerRangeType::fromInterval(null, 0)->isSuperTypeOf($multiplierType)->yes()) { return new NeverType(); } $inputType = $scope->getType($args[0]->value); if ($inputType instanceof ConstantStringType && $multiplierType instanceof ConstantIntegerType && strlen($inputType->getValue()) * $multiplierType->getValue() < 100) { return new ConstantStringType(str_repeat($inputType->getValue(), $multiplierType->getValue())); } $accessoryTypes = []; if ($inputType->isNonEmptyString()->yes()) { if (IntegerRangeType::fromInterval(1, null)->isSuperTypeOf($multiplierType)->yes()) { if ($inputType->isNonFalsyString()->yes()) { $accessoryTypes[] = new AccessoryNonFalsyStringType(); } else { $accessoryTypes[] = new AccessoryNonEmptyStringType(); } } } if ($inputType->isLiteralString()->yes()) { $accessoryTypes[] = new AccessoryLiteralStringType(); if ($inputType->isNumericString()->yes() && IntegerRangeType::fromInterval(1, null)->isSuperTypeOf($multiplierType)->yes()) { $onlyNumbers = \true; foreach ($inputType->getConstantStrings() as $constantString) { if (Strings::match($constantString->getValue(), '#^[0-9]+$#') === null) { $onlyNumbers = \false; break; } } if ($onlyNumbers) { $accessoryTypes[] = new AccessoryNumericStringType(); } } } if ($inputType->isLowercaseString()->yes()) { $accessoryTypes[] = new AccessoryLowercaseStringType(); } if ($inputType->isUppercaseString()->yes()) { $accessoryTypes[] = new AccessoryUppercaseStringType(); } if (count($accessoryTypes) > 0) { $accessoryTypes[] = new StringType(); return new IntersectionType($accessoryTypes); } return new StringType(); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PhpParser\Node\Expr\UnaryMinus; use PHPStan\Analyser\Scope; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Accessory\AccessoryNumericStringType; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\ConstantScalarType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\IntegerRangeType; use PHPStan\Type\NeverType; use PHPStan\Type\NullType; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\UnionType; use function in_array; use function is_numeric; final class BcMathStringOrNullReturnTypeExtension implements DynamicFunctionReturnTypeExtension { /** * @var PhpVersion */ private $phpVersion; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; } public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return in_array($functionReflection->getName(), ['bcdiv', 'bcmod', 'bcpowmod', 'bcsqrt'], \true); } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : Type { if ($functionReflection->getName() === 'bcsqrt') { return $this->getTypeForBcSqrt($functionCall, $scope); } if ($functionReflection->getName() === 'bcpowmod') { return $this->getTypeForBcPowMod($functionCall, $scope); } $stringAndNumericStringType = TypeCombinator::intersect(new StringType(), new AccessoryNumericStringType()); if (isset($functionCall->getArgs()[1]) === \false) { if ($this->phpVersion->throwsTypeErrorForInternalFunctions()) { return new NeverType(); } return new NullType(); } if ($this->phpVersion->throwsTypeErrorForInternalFunctions()) { $defaultReturnType = $stringAndNumericStringType; } else { $defaultReturnType = new UnionType([$stringAndNumericStringType, new NullType()]); } $secondArgument = $scope->getType($functionCall->getArgs()[1]->value); $secondArgumentIsNumeric = $secondArgument instanceof ConstantScalarType && is_numeric($secondArgument->getValue()) || $secondArgument->isInteger()->yes(); if ($secondArgument instanceof ConstantScalarType && ($this->isZero($secondArgument->getValue()) || !$secondArgumentIsNumeric)) { if ($this->phpVersion->throwsTypeErrorForInternalFunctions()) { return new NeverType(); } return new NullType(); } if (isset($functionCall->getArgs()[2]) === \false) { if ($secondArgument instanceof ConstantScalarType || $secondArgumentIsNumeric) { return $stringAndNumericStringType; } return $defaultReturnType; } $thirdArgument = $scope->getType($functionCall->getArgs()[2]->value); $thirdArgumentIsNumeric = \false; $thirdArgumentIsNegative = \false; if ($thirdArgument instanceof ConstantScalarType && is_numeric($thirdArgument->getValue())) { $thirdArgumentIsNumeric = \true; $thirdArgumentIsNegative = $thirdArgument->getValue() < 0; } elseif ($thirdArgument->isInteger()->yes()) { $thirdArgumentIsNumeric = \true; if (IntegerRangeType::fromInterval(null, -1)->isSuperTypeOf($thirdArgument)->yes()) { $thirdArgumentIsNegative = \true; } } if ($thirdArgument instanceof ConstantScalarType && !is_numeric($thirdArgument->getValue())) { if ($this->phpVersion->throwsTypeErrorForInternalFunctions()) { return new NeverType(); } return new NullType(); } if ($this->phpVersion->throwsTypeErrorForInternalFunctions() && $thirdArgumentIsNegative) { return new NeverType(); } if (($secondArgument instanceof ConstantScalarType || $secondArgumentIsNumeric) && $thirdArgumentIsNumeric) { return $stringAndNumericStringType; } return $defaultReturnType; } /** * bcsqrt * https://www.php.net/manual/en/function.bcsqrt.php * > Returns the square root as a string, or NULL if operand is negative. * */ private function getTypeForBcSqrt(FuncCall $functionCall, Scope $scope) : Type { $stringAndNumericStringType = TypeCombinator::intersect(new StringType(), new AccessoryNumericStringType()); if ($this->phpVersion->throwsTypeErrorForInternalFunctions()) { $defaultReturnType = $stringAndNumericStringType; } else { $defaultReturnType = new UnionType([$stringAndNumericStringType, new NullType()]); } if (isset($functionCall->getArgs()[0]) === \false) { if ($this->phpVersion->throwsTypeErrorForInternalFunctions()) { return new NeverType(); } return $defaultReturnType; } $firstArgument = $scope->getType($functionCall->getArgs()[0]->value); $firstArgumentIsPositive = $firstArgument instanceof ConstantScalarType && is_numeric($firstArgument->getValue()) && $firstArgument->getValue() >= 0; $firstArgumentIsNegative = $firstArgument instanceof ConstantScalarType && is_numeric($firstArgument->getValue()) && $firstArgument->getValue() < 0; if ($firstArgument instanceof UnaryMinus || $firstArgumentIsNegative) { if ($this->phpVersion->throwsTypeErrorForInternalFunctions()) { return new NeverType(); } return new NullType(); } if (isset($functionCall->getArgs()[1]) === \false) { if ($firstArgumentIsPositive) { return $stringAndNumericStringType; } return $defaultReturnType; } $secondArgument = $scope->getType($functionCall->getArgs()[1]->value); $secondArgumentIsValid = $secondArgument instanceof ConstantScalarType && is_numeric($secondArgument->getValue()) && !$this->isZero($secondArgument->getValue()); $secondArgumentIsNonNumeric = $secondArgument instanceof ConstantScalarType && !is_numeric($secondArgument->getValue()); $secondArgumentIsNegative = $secondArgument instanceof ConstantScalarType && is_numeric($secondArgument->getValue()) && $secondArgument->getValue() < 0; if ($secondArgumentIsNonNumeric) { if ($this->phpVersion->throwsTypeErrorForInternalFunctions()) { return new NeverType(); } return new NullType(); } if ($secondArgument instanceof UnaryMinus || $secondArgumentIsNegative) { if ($this->phpVersion->throwsTypeErrorForInternalFunctions()) { return new NeverType(); } } if ($firstArgumentIsPositive && $secondArgumentIsValid) { return $stringAndNumericStringType; } return $defaultReturnType; } /** * bcpowmod() * https://www.php.net/manual/en/function.bcpowmod.php * > Returns the result as a string, or FALSE if modulus is 0 or exponent is negative. */ private function getTypeForBcPowMod(FuncCall $functionCall, Scope $scope) : Type { if ($this->phpVersion->throwsTypeErrorForInternalFunctions() && isset($functionCall->getArgs()[0]) === \false) { return new NeverType(); } $stringAndNumericStringType = TypeCombinator::intersect(new StringType(), new AccessoryNumericStringType()); if (isset($functionCall->getArgs()[1]) === \false) { if ($this->phpVersion->throwsTypeErrorForInternalFunctions()) { return new NeverType(); } return new UnionType([$stringAndNumericStringType, new ConstantBooleanType(\false)]); } $exponent = $scope->getType($functionCall->getArgs()[1]->value); // Expontent is non numeric if ($this->phpVersion->throwsTypeErrorForInternalFunctions() && $exponent instanceof ConstantScalarType && !is_numeric($exponent->getValue())) { return new NeverType(); } $exponentIsNegative = IntegerRangeType::fromInterval(null, 0)->isSuperTypeOf($exponent)->yes(); if ($exponent instanceof ConstantScalarType) { $exponentIsNegative = is_numeric($exponent->getValue()) && $exponent->getValue() < 0; } if ($exponentIsNegative) { if ($this->phpVersion->throwsTypeErrorForInternalFunctions()) { return new NeverType(); } return new ConstantBooleanType(\false); } if (isset($functionCall->getArgs()[2])) { $modulus = $scope->getType($functionCall->getArgs()[2]->value); $modulusIsZero = $modulus instanceof ConstantScalarType && $this->isZero($modulus->getValue()); $modulusIsNonNumeric = $modulus instanceof ConstantScalarType && !is_numeric($modulus->getValue()); if ($modulusIsZero || $modulusIsNonNumeric) { if ($this->phpVersion->throwsTypeErrorForInternalFunctions()) { return new NeverType(); } return new ConstantBooleanType(\false); } if ($modulus instanceof ConstantScalarType) { return $stringAndNumericStringType; } } else { if ($this->phpVersion->throwsTypeErrorForInternalFunctions()) { return new NeverType(); } } if ($this->phpVersion->throwsTypeErrorForInternalFunctions()) { return $stringAndNumericStringType; } return new UnionType([$stringAndNumericStringType, new ConstantBooleanType(\false)]); } /** * Utility to help us determine if value is zero. Handles cases where we pass "0.000" too. * * @param mixed $value */ private function isZero($value) : bool { if (is_numeric($value) === \false) { return \false; } if ($value > 0 || $value < 0) { return \false; } return \true; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use DateTime; use DateTimeImmutable; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\ObjectType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function count; use function in_array; final class DateTimeDynamicReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return in_array($functionReflection->getName(), ['date_create_from_format', 'date_create_immutable_from_format'], \true); } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (count($functionCall->getArgs()) < 2) { return null; } $formats = $scope->getType($functionCall->getArgs()[0]->value)->getConstantStrings(); $datetimes = $scope->getType($functionCall->getArgs()[1]->value)->getConstantStrings(); if (count($formats) === 0 || count($datetimes) === 0) { return null; } $types = []; $className = $functionReflection->getName() === 'date_create_from_format' ? DateTime::class : DateTimeImmutable::class; foreach ($formats as $formatConstantString) { foreach ($datetimes as $datetimeConstantString) { $isValid = DateTime::createFromFormat($formatConstantString->getValue(), $datetimeConstantString->getValue()) !== \false; $types[] = $isValid ? new ObjectType($className) : new ConstantBooleanType(\false); } } return TypeCombinator::union(...$types); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use DateTime; use DateTimeImmutable; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\ObjectType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function count; use function date_create; use function in_array; final class DateTimeCreateDynamicReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return in_array($functionReflection->getName(), ['date_create', 'date_create_immutable'], \true); } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (count($functionCall->getArgs()) < 1) { return null; } $datetimes = $scope->getType($functionCall->getArgs()[0]->value)->getConstantStrings(); if (count($datetimes) === 0) { return null; } $types = []; $className = $functionReflection->getName() === 'date_create' ? DateTime::class : DateTimeImmutable::class; foreach ($datetimes as $constantString) { $isValid = date_create($constantString->getValue()) !== \false; $types[] = $isValid ? new ObjectType($className) : new ConstantBooleanType(\false); } return TypeCombinator::union(...$types); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Analyser\SpecifiedTypes; use PHPStan\Analyser\TypeSpecifier; use PHPStan\Analyser\TypeSpecifierAwareExtension; use PHPStan\Analyser\TypeSpecifierContext; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\FunctionTypeSpecifyingExtension; use function count; use function strtolower; final class IsAFunctionTypeSpecifyingExtension implements FunctionTypeSpecifyingExtension, TypeSpecifierAwareExtension { /** * @var IsAFunctionTypeSpecifyingHelper */ private $isAFunctionTypeSpecifyingHelper; /** * @var TypeSpecifier */ private $typeSpecifier; public function __construct(\PHPStan\Type\Php\IsAFunctionTypeSpecifyingHelper $isAFunctionTypeSpecifyingHelper) { $this->isAFunctionTypeSpecifyingHelper = $isAFunctionTypeSpecifyingHelper; } public function isFunctionSupported(FunctionReflection $functionReflection, FuncCall $node, TypeSpecifierContext $context) : bool { return strtolower($functionReflection->getName()) === 'is_a' && !$context->null(); } public function specifyTypes(FunctionReflection $functionReflection, FuncCall $node, Scope $scope, TypeSpecifierContext $context) : SpecifiedTypes { if (count($node->getArgs()) < 2) { return new SpecifiedTypes(); } $classType = $scope->getType($node->getArgs()[1]->value); if (!$classType instanceof ConstantStringType && !$context->true()) { return new SpecifiedTypes([], []); } $objectOrClassType = $scope->getType($node->getArgs()[0]->value); $allowStringType = isset($node->getArgs()[2]) ? $scope->getType($node->getArgs()[2]->value) : new ConstantBooleanType(\false); $allowString = !$allowStringType->equals(new ConstantBooleanType(\false)); return $this->typeSpecifier->create($node->getArgs()[0]->value, $this->isAFunctionTypeSpecifyingHelper->determineType($objectOrClassType, $classType, $allowString, \true), $context, \false, $scope); } public function setTypeSpecifier(TypeSpecifier $typeSpecifier) : void { $this->typeSpecifier = $typeSpecifier; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\FunctionReflection; use PHPStan\ShouldNotHappenException; use PHPStan\TrinaryLogic; use PHPStan\Type\Accessory\AccessoryArrayListType; use PHPStan\Type\Accessory\NonEmptyArrayType; use PHPStan\Type\ArrayType; use PHPStan\Type\Constant\ConstantArrayType; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\IntegerType; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function array_is_list; use function array_map; use function array_unique; use function count; use function in_array; use function mb_internal_encoding; use function mb_str_split; use function str_split; final class StrSplitFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { /** * @var PhpVersion */ private $phpVersion; use \PHPStan\Type\Php\MbFunctionsReturnTypeExtensionTrait; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; } public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return in_array($functionReflection->getName(), ['str_split', 'mb_str_split'], \true); } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (count($functionCall->getArgs()) < 1) { return null; } if (count($functionCall->getArgs()) >= 2) { $splitLengthType = $scope->getType($functionCall->getArgs()[1]->value); if ($splitLengthType instanceof ConstantIntegerType) { $splitLength = $splitLengthType->getValue(); if ($splitLength < 1) { return new ConstantBooleanType(\false); } } } else { $splitLength = 1; } $encoding = null; if ($functionReflection->getName() === 'mb_str_split') { if (count($functionCall->getArgs()) >= 3) { $strings = $scope->getType($functionCall->getArgs()[2]->value)->getConstantStrings(); $values = array_unique(array_map(static function (ConstantStringType $encoding) : string { return $encoding->getValue(); }, $strings)); if (count($values) !== 1) { return null; } $encoding = $values[0]; if (!$this->isSupportedEncoding($encoding)) { return new ConstantBooleanType(\false); } } else { $encoding = mb_internal_encoding(); } } if (!isset($splitLength)) { return null; } $stringType = $scope->getType($functionCall->getArgs()[0]->value); $constantStrings = $stringType->getConstantStrings(); if (count($constantStrings) > 0) { $results = []; foreach ($constantStrings as $constantString) { $items = $encoding === null ? str_split($constantString->getValue(), $splitLength) : @mb_str_split($constantString->getValue(), $splitLength, $encoding); if ($items === \false) { throw new ShouldNotHappenException(); } $results[] = self::createConstantArrayFrom($items, $scope); } return TypeCombinator::union(...$results); } $returnType = AccessoryArrayListType::intersectWith(new ArrayType(new IntegerType(), new StringType())); return $encoding === null && !$this->phpVersion->strSplitReturnsEmptyArray() ? TypeCombinator::intersect($returnType, new NonEmptyArrayType()) : $returnType; } /** * @param string[] $constantArray */ private static function createConstantArrayFrom(array $constantArray, Scope $scope) : ConstantArrayType { $keyTypes = []; $valueTypes = []; $isList = \true; $i = 0; foreach ($constantArray as $key => $value) { $keyType = $scope->getTypeFromValue($key); if (!$keyType instanceof ConstantIntegerType) { throw new ShouldNotHappenException(); } $keyTypes[] = $keyType; $valueTypes[] = $scope->getTypeFromValue($value); $isList = $isList && $key === $i; $i++; } return new ConstantArrayType($keyTypes, $valueTypes, $isList ? [$i] : [0], [], TrinaryLogic::createFromBoolean(array_is_list($constantArray))); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Accessory\AccessoryLowercaseStringType; use PHPStan\Type\Accessory\AccessoryUppercaseStringType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\IntersectionType; use PHPStan\Type\StringType; use PHPStan\Type\Type; use function count; use function in_array; final class TrimFunctionDynamicReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return in_array($functionReflection->getName(), ['trim', 'rtrim', 'ltrim'], \true); } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { $args = $functionCall->getArgs(); if (count($args) < 1) { return null; } $stringType = $scope->getType($args[0]->value); $accessory = []; if ($stringType->isLowercaseString()->yes()) { $accessory[] = new AccessoryLowercaseStringType(); } if ($stringType->isUppercaseString()->yes()) { $accessory[] = new AccessoryUppercaseStringType(); } if (count($accessory) > 0) { $accessory[] = new StringType(); return new IntersectionType($accessory); } return new StringType(); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use DateInterval; use PhpParser\Node\Expr\StaticCall; use PHPStan\Analyser\Scope; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\MethodReflection; use PHPStan\Type\DynamicStaticMethodThrowTypeExtension; use PHPStan\Type\NeverType; use PHPStan\Type\ObjectType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function count; final class DateIntervalConstructorThrowTypeExtension implements DynamicStaticMethodThrowTypeExtension { /** * @var PhpVersion */ private $phpVersion; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; } public function isStaticMethodSupported(MethodReflection $methodReflection) : bool { return $methodReflection->getName() === '__construct' && $methodReflection->getDeclaringClass()->getName() === DateInterval::class; } public function getThrowTypeFromStaticMethodCall(MethodReflection $methodReflection, StaticCall $methodCall, Scope $scope) : ?Type { if (count($methodCall->getArgs()) === 0) { return $methodReflection->getThrowType(); } $valueType = $scope->getType($methodCall->getArgs()[0]->value); $constantStrings = $valueType->getConstantStrings(); foreach ($constantStrings as $constantString) { try { new DateInterval($constantString->getValue()); } catch (\Exception $e) { // phpcs:ignore return $this->exceptionType(); } $valueType = TypeCombinator::remove($valueType, $constantString); } if (!$valueType instanceof NeverType) { return $this->exceptionType(); } return null; } private function exceptionType() : Type { if ($this->phpVersion->hasDateTimeExceptions()) { return new ObjectType('DateMalformedIntervalStringException'); } return new ObjectType('Exception'); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\NeverType; use PHPStan\Type\NullType; use PHPStan\Type\Type; use function count; final class ArrayFillKeysFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { /** * @var PhpVersion */ private $phpVersion; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; } public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'array_fill_keys'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (count($functionCall->getArgs()) < 2) { return null; } $keysType = $scope->getType($functionCall->getArgs()[0]->value); if ($keysType->isArray()->no()) { return $this->phpVersion->arrayFunctionsReturnNullWithNonArray() ? new NullType() : new NeverType(); } return $keysType->fillKeysArray($scope->getType($functionCall->getArgs()[1]->value)); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\BooleanType; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\StringType; use PHPStan\Type\Type; use function count; final class HighlightStringDynamicReturnTypeExtension implements DynamicFunctionReturnTypeExtension { /** * @var PhpVersion */ private $phpVersion; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; } public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'highlight_string'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : Type { $args = $functionCall->getArgs(); if (count($args) < 2) { if ($this->phpVersion->highlightStringDoesNotReturnFalse()) { return new ConstantBooleanType(\true); } return new BooleanType(); } $returnType = $scope->getType($args[1]->value); if ($returnType->isTrue()->yes()) { return new StringType(); } if ($this->phpVersion->highlightStringDoesNotReturnFalse()) { return new ConstantBooleanType(\true); } return new BooleanType(); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Analyser\TypeSpecifier; use PHPStan\Analyser\TypeSpecifierAwareExtension; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Rules\Comparison\ImpossibleCheckTypeHelper; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\Type; use function count; use function in_array; final class TypeSpecifyingFunctionsDynamicReturnTypeExtension implements DynamicFunctionReturnTypeExtension, TypeSpecifierAwareExtension { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var bool */ private $treatPhpDocTypesAsCertain; /** * @var string[] */ private $universalObjectCratesClasses; /** * @var bool */ private $nullContextForVoidReturningFunctions; /** * @var TypeSpecifier */ private $typeSpecifier; /** * @var ?ImpossibleCheckTypeHelper */ private $helper = null; /** * @param string[] $universalObjectCratesClasses */ public function __construct(ReflectionProvider $reflectionProvider, bool $treatPhpDocTypesAsCertain, array $universalObjectCratesClasses, bool $nullContextForVoidReturningFunctions) { $this->reflectionProvider = $reflectionProvider; $this->treatPhpDocTypesAsCertain = $treatPhpDocTypesAsCertain; $this->universalObjectCratesClasses = $universalObjectCratesClasses; $this->nullContextForVoidReturningFunctions = $nullContextForVoidReturningFunctions; } public function setTypeSpecifier(TypeSpecifier $typeSpecifier) : void { $this->typeSpecifier = $typeSpecifier; } public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return in_array($functionReflection->getName(), ['array_key_exists', 'key_exists', 'in_array', 'is_subclass_of'], \true); } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (count($functionCall->getArgs()) === 0) { return null; } $isAlways = $this->getHelper()->findSpecifiedType($scope, $functionCall); if ($isAlways === null) { return null; } return new ConstantBooleanType($isAlways); } private function getHelper() : ImpossibleCheckTypeHelper { if ($this->helper === null) { $this->helper = new ImpossibleCheckTypeHelper($this->reflectionProvider, $this->typeSpecifier, $this->universalObjectCratesClasses, $this->treatPhpDocTypesAsCertain, $this->nullContextForVoidReturningFunctions); } return $this->helper; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PhpParser\Node\Expr\Variable; use PHPStan\Analyser\Scope; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Accessory\NonEmptyArrayType; use PHPStan\Type\ArrayType; use PHPStan\Type\Constant\ConstantArrayType; use PHPStan\Type\Constant\ConstantArrayTypeBuilder; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\ErrorType; use PHPStan\Type\MixedType; use PHPStan\Type\NeverType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\UnionType; use function count; final class ArrayCombineFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { /** * @var PhpVersion */ private $phpVersion; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; } public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'array_combine'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (count($functionCall->getArgs()) < 2) { return null; } $firstArg = $functionCall->getArgs()[0]->value; $secondArg = $functionCall->getArgs()[1]->value; $keysParamType = $scope->getType($firstArg); $valuesParamType = $scope->getType($secondArg); if ($keysParamType instanceof ConstantArrayType && $valuesParamType instanceof ConstantArrayType) { $keyTypes = $keysParamType->getValueTypes(); $valueTypes = $valuesParamType->getValueTypes(); if (count($keyTypes) !== count($valueTypes)) { if ($this->phpVersion->throwsTypeErrorForInternalFunctions()) { return new NeverType(); } return new ConstantBooleanType(\false); } $keyTypes = $this->sanitizeConstantArrayKeyTypes($keyTypes); if ($keyTypes !== null) { $builder = ConstantArrayTypeBuilder::createEmpty(); foreach ($keyTypes as $i => $keyType) { $valueType = $valueTypes[$i]; $builder->setOffsetValueType($keyType, $valueType); } return $builder->getArray(); } } if ($keysParamType->isArray()->yes()) { $itemType = $keysParamType->getIterableValueType(); if ($itemType->isInteger()->no()) { if ($itemType->toString() instanceof ErrorType) { return new NeverType(); } $keyType = $itemType->toString(); } else { $keyType = $itemType; } } else { $keyType = new MixedType(); } $arrayType = new ArrayType($keyType, $valuesParamType->isArray()->yes() ? $valuesParamType->getIterableValueType() : new MixedType()); if ($keysParamType->isIterableAtLeastOnce()->yes() && $valuesParamType->isIterableAtLeastOnce()->yes()) { $arrayType = TypeCombinator::intersect($arrayType, new NonEmptyArrayType()); } if ($this->phpVersion->throwsTypeErrorForInternalFunctions()) { return $arrayType; } if ($firstArg instanceof Variable && $secondArg instanceof Variable && $firstArg->name === $secondArg->name) { return $arrayType; } return new UnionType([$arrayType, new ConstantBooleanType(\false)]); } /** * @param array<int, Type> $types * * @return array<int, ConstantIntegerType|ConstantStringType>|null */ private function sanitizeConstantArrayKeyTypes(array $types) : ?array { $sanitizedTypes = []; foreach ($types as $type) { if ($type->isInteger()->no() && !$type->toString() instanceof ErrorType) { $type = $type->toString(); } if (!$type instanceof ConstantIntegerType && !$type instanceof ConstantStringType) { return null; } $sanitizedTypes[] = $type; } return $sanitizedTypes; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Accessory\AccessoryArrayListType; use PHPStan\Type\Accessory\NonEmptyArrayType; use PHPStan\Type\ArrayType; use PHPStan\Type\BenevolentUnionType; use PHPStan\Type\Constant\ConstantArrayTypeBuilder; use PHPStan\Type\Constant\ConstantFloatType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\FloatType; use PHPStan\Type\GeneralizePrecision; use PHPStan\Type\IntegerRangeType; use PHPStan\Type\IntegerType; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\UnionType; use ValueError; use function count; use function is_array; use function range; final class RangeFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { private const RANGE_LENGTH_THRESHOLD = 50; public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'range'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (count($functionCall->getArgs()) < 2) { return null; } $startType = $scope->getType($functionCall->getArgs()[0]->value); $endType = $scope->getType($functionCall->getArgs()[1]->value); $stepType = count($functionCall->getArgs()) >= 3 ? $scope->getType($functionCall->getArgs()[2]->value) : new ConstantIntegerType(1); $constantReturnTypes = []; $startConstants = $startType->getConstantScalarTypes(); foreach ($startConstants as $startConstant) { if (!$startConstant instanceof ConstantIntegerType && !$startConstant instanceof ConstantFloatType && !$startConstant instanceof ConstantStringType) { continue; } $endConstants = $endType->getConstantScalarTypes(); foreach ($endConstants as $endConstant) { if (!$endConstant instanceof ConstantIntegerType && !$endConstant instanceof ConstantFloatType && !$endConstant instanceof ConstantStringType) { continue; } $stepConstants = $stepType->getConstantScalarTypes(); foreach ($stepConstants as $stepConstant) { if (!$stepConstant instanceof ConstantIntegerType && !$stepConstant instanceof ConstantFloatType) { continue; } try { $rangeValues = @range($startConstant->getValue(), $endConstant->getValue(), $stepConstant->getValue()); } catch (ValueError $e) { continue; } // @phpstan-ignore function.alreadyNarrowedType if (!is_array($rangeValues)) { continue; } if (count($rangeValues) > self::RANGE_LENGTH_THRESHOLD) { if ($startConstant instanceof ConstantIntegerType && $endConstant instanceof ConstantIntegerType && $stepConstant instanceof ConstantIntegerType) { if ($startConstant->getValue() > $endConstant->getValue()) { $tmp = $startConstant; $startConstant = $endConstant; $endConstant = $tmp; } return AccessoryArrayListType::intersectWith(TypeCombinator::intersect(new ArrayType(new IntegerType(), IntegerRangeType::fromInterval($startConstant->getValue(), $endConstant->getValue())), new NonEmptyArrayType())); } if ($stepType->isFloat()->yes()) { return AccessoryArrayListType::intersectWith(TypeCombinator::intersect(new ArrayType(new IntegerType(), new FloatType()), new NonEmptyArrayType())); } return AccessoryArrayListType::intersectWith(TypeCombinator::intersect(new ArrayType(new IntegerType(), TypeCombinator::union($startConstant->generalize(GeneralizePrecision::moreSpecific()), $endConstant->generalize(GeneralizePrecision::moreSpecific()), $stepType->generalize(GeneralizePrecision::moreSpecific()))), new NonEmptyArrayType())); } $arrayBuilder = ConstantArrayTypeBuilder::createEmpty(); foreach ($rangeValues as $value) { $arrayBuilder->setOffsetValueType(null, $scope->getTypeFromValue($value)); } $constantReturnTypes[] = $arrayBuilder->getArray(); } } } if (count($constantReturnTypes) > 0) { return TypeCombinator::union(...$constantReturnTypes); } $argType = TypeCombinator::union($startType, $endType); $isInteger = $argType->isInteger()->yes(); $isStepInteger = $stepType->isInteger()->yes(); if ($isInteger && $isStepInteger) { if ($argType instanceof IntegerRangeType) { return AccessoryArrayListType::intersectWith(new ArrayType(new IntegerType(), $argType)); } return AccessoryArrayListType::intersectWith(new ArrayType(new IntegerType(), new IntegerType())); } if ($argType->isFloat()->yes()) { return AccessoryArrayListType::intersectWith(new ArrayType(new IntegerType(), new FloatType())); } $numberType = new UnionType([new IntegerType(), new FloatType()]); $isNumber = $numberType->isSuperTypeOf($argType)->yes(); $isNumericString = $argType->isNumericString()->yes(); if ($isNumber || $isNumericString) { return AccessoryArrayListType::intersectWith(new ArrayType(new IntegerType(), $numberType)); } if ($argType->isString()->yes()) { return AccessoryArrayListType::intersectWith(new ArrayType(new IntegerType(), new StringType())); } return AccessoryArrayListType::intersectWith(new ArrayType(new IntegerType(), new BenevolentUnionType([new IntegerType(), new FloatType(), new StringType()]))); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\ClassStringType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\Type; use function count; use function ltrim; final class LtrimFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'ltrim'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (count($functionCall->getArgs()) !== 2) { return null; } $string = $scope->getType($functionCall->getArgs()[0]->value); $trimChars = $scope->getType($functionCall->getArgs()[1]->value); if ($trimChars instanceof ConstantStringType && $trimChars->getValue() === '\\' && $string->isClassStringType()->yes()) { if ($string instanceof ConstantStringType) { return new ConstantStringType(ltrim($string->getValue(), $trimChars->getValue()), \true); } return new ClassStringType(); } return null; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\TrinaryLogic; use PHPStan\Type\Accessory\AccessoryArrayListType; use PHPStan\Type\ArrayType; use PHPStan\Type\BitwiseFlagHelper; use PHPStan\Type\Constant\ConstantArrayType; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\IntegerRangeType; use PHPStan\Type\IntegerType; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function strtolower; final class PregSplitDynamicReturnTypeExtension implements DynamicFunctionReturnTypeExtension { /** * @var BitwiseFlagHelper */ private $bitwiseFlagAnalyser; public function __construct(BitwiseFlagHelper $bitwiseFlagAnalyser) { $this->bitwiseFlagAnalyser = $bitwiseFlagAnalyser; } public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return strtolower($functionReflection->getName()) === 'preg_split'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { $flagsArg = $functionCall->getArgs()[3] ?? null; if ($flagsArg !== null && $this->bitwiseFlagAnalyser->bitwiseOrContainsConstant($flagsArg->value, $scope, 'PREG_SPLIT_OFFSET_CAPTURE')->yes()) { $type = new ArrayType(new IntegerType(), new ConstantArrayType([new ConstantIntegerType(0), new ConstantIntegerType(1)], [new StringType(), IntegerRangeType::fromInterval(0, null)], [2], [], TrinaryLogic::createYes())); return TypeCombinator::union(AccessoryArrayListType::intersectWith($type), new ConstantBooleanType(\false)); } return null; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Accessory\NonEmptyArrayType; use PHPStan\Type\ArrayType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\GeneralizePrecision; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function array_key_exists; final class ArgumentBasedFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { private const FUNCTION_NAMES = ['array_unique' => 0, 'array_diff_assoc' => 0, 'array_diff_key' => 0, 'array_diff_uassoc' => 0, 'array_diff_ukey' => 0, 'array_diff' => 0, 'array_udiff_assoc' => 0, 'array_udiff_uassoc' => 0, 'array_udiff' => 0, 'array_intersect_assoc' => 0, 'array_intersect_uassoc' => 0, 'array_intersect_ukey' => 0, 'array_intersect' => 0, 'array_uintersect_assoc' => 0, 'array_uintersect_uassoc' => 0, 'array_uintersect' => 0]; public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return array_key_exists($functionReflection->getName(), self::FUNCTION_NAMES); } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { $argumentPosition = self::FUNCTION_NAMES[$functionReflection->getName()]; if (!isset($functionCall->getArgs()[$argumentPosition])) { return null; } $argument = $functionCall->getArgs()[$argumentPosition]; $argumentType = $scope->getType($argument->value); $argumentKeyType = $argumentType->getIterableKeyType(); $argumentValueType = $argumentType->getIterableValueType(); if ($argument->unpack) { $argumentKeyType = $argumentKeyType->generalize(GeneralizePrecision::moreSpecific()); $argumentValueType = $argumentValueType->getIterableValueType()->generalize(GeneralizePrecision::moreSpecific()); } $array = new ArrayType($argumentKeyType, $argumentValueType); if ($functionReflection->getName() === 'array_unique' && $argumentType->isIterableAtLeastOnce()->yes()) { $array = TypeCombinator::intersect($array, new NonEmptyArrayType()); } return $array; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Arg; use PhpParser\Node\Expr\BinaryOp\BooleanAnd; use PhpParser\Node\Expr\BinaryOp\NotIdentical; use PhpParser\Node\Expr\FuncCall; use PhpParser\Node\Name; use PhpParser\Node\Scalar\String_; use PHPStan\Analyser\Scope; use PHPStan\Analyser\SpecifiedTypes; use PHPStan\Analyser\TypeSpecifier; use PHPStan\Analyser\TypeSpecifierAwareExtension; use PHPStan\Analyser\TypeSpecifierContext; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Accessory\AccessoryLiteralStringType; use PHPStan\Type\Accessory\AccessoryNonEmptyStringType; use PHPStan\Type\Accessory\AccessoryNonFalsyStringType; use PHPStan\Type\Accessory\AccessoryNumericStringType; use PHPStan\Type\FunctionTypeSpecifyingExtension; use PHPStan\Type\IntersectionType; use PHPStan\Type\StringType; use function array_key_exists; use function count; use function strtolower; final class StrContainingTypeSpecifyingExtension implements FunctionTypeSpecifyingExtension, TypeSpecifierAwareExtension { private const STR_CONTAINING_FUNCTIONS = ['fnmatch' => [1, 0], 'str_contains' => [0, 1], 'str_starts_with' => [0, 1], 'str_ends_with' => [0, 1], 'strpos' => [0, 1], 'strrpos' => [0, 1], 'stripos' => [0, 1], 'strripos' => [0, 1], 'strstr' => [0, 1], 'mb_strpos' => [0, 1], 'mb_strrpos' => [0, 1], 'mb_stripos' => [0, 1], 'mb_strripos' => [0, 1], 'mb_strstr' => [0, 1]]; /** * @var TypeSpecifier */ private $typeSpecifier; public function setTypeSpecifier(TypeSpecifier $typeSpecifier) : void { $this->typeSpecifier = $typeSpecifier; } public function isFunctionSupported(FunctionReflection $functionReflection, FuncCall $node, TypeSpecifierContext $context) : bool { return array_key_exists(strtolower($functionReflection->getName()), self::STR_CONTAINING_FUNCTIONS) && $context->true(); } public function specifyTypes(FunctionReflection $functionReflection, FuncCall $node, Scope $scope, TypeSpecifierContext $context) : SpecifiedTypes { $args = $node->getArgs(); if (count($args) >= 2) { [$hackstackArg, $needleArg] = self::STR_CONTAINING_FUNCTIONS[strtolower($functionReflection->getName())]; $haystackType = $scope->getType($args[$hackstackArg]->value); $needleType = $scope->getType($args[$needleArg]->value); if ($needleType->isNonEmptyString()->yes() && $haystackType->isString()->yes()) { $accessories = [new StringType()]; if ($needleType->isNonFalsyString()->yes()) { $accessories[] = new AccessoryNonFalsyStringType(); } else { $accessories[] = new AccessoryNonEmptyStringType(); } if ($haystackType->isLiteralString()->yes()) { $accessories[] = new AccessoryLiteralStringType(); } if ($haystackType->isNumericString()->yes()) { $accessories[] = new AccessoryNumericStringType(); } return $this->typeSpecifier->create($args[$hackstackArg]->value, new IntersectionType($accessories), $context, \false, $scope, new BooleanAnd(new NotIdentical($args[$needleArg]->value, new String_('')), new FuncCall(new Name('FAUX_FUNCTION'), [new Arg($args[$needleArg]->value)]))); } } return new SpecifiedTypes(); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\BooleanType; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function array_filter; use function count; use function version_compare; final class VersionCompareFunctionDynamicReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'version_compare'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (count($functionCall->getArgs()) < 2) { return null; } $version1Strings = $scope->getType($functionCall->getArgs()[0]->value)->getConstantStrings(); $version2Strings = $scope->getType($functionCall->getArgs()[1]->value)->getConstantStrings(); $counts = [count($version1Strings), count($version2Strings)]; if (isset($functionCall->getArgs()[2])) { $operatorStrings = $scope->getType($functionCall->getArgs()[2]->value)->getConstantStrings(); $counts[] = count($operatorStrings); $returnType = new BooleanType(); } else { $returnType = TypeCombinator::union(new ConstantIntegerType(-1), new ConstantIntegerType(0), new ConstantIntegerType(1)); } if (count(array_filter($counts, static function (int $count) : bool { return $count === 0; })) > 0) { return $returnType; // one of the arguments is not a constant string } if (count(array_filter($counts, static function (int $count) : bool { return $count > 1; })) > 1) { return $returnType; // more than one argument can have multiple possibilities, avoid combinatorial explosion } $types = []; foreach ($version1Strings as $version1String) { foreach ($version2Strings as $version2String) { if (isset($operatorStrings)) { foreach ($operatorStrings as $operatorString) { $value = version_compare($version1String->getValue(), $version2String->getValue(), $operatorString->getValue()); $types[$value] = new ConstantBooleanType($value); } } else { $value = version_compare($version1String->getValue(), $version2String->getValue()); $types[$value] = new ConstantIntegerType($value); } } } return TypeCombinator::union(...$types); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\BenevolentUnionType; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\MixedType; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\UnionType; final class Base64DecodeDynamicFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'base64_decode'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : Type { if (!isset($functionCall->getArgs()[1])) { return new StringType(); } $argType = $scope->getType($functionCall->getArgs()[1]->value); if ($argType instanceof MixedType) { return new BenevolentUnionType([new StringType(), new ConstantBooleanType(\false)]); } $isTrueType = $argType->isTrue(); $isFalseType = $argType->isFalse(); $compareTypes = $isTrueType->compareTo($isFalseType); if ($compareTypes === $isTrueType) { return new UnionType([new StringType(), new ConstantBooleanType(\false)]); } if ($compareTypes === $isFalseType) { return new StringType(); } // second argument could be interpreted as true if (!$isTrueType->no()) { return new UnionType([new StringType(), new ConstantBooleanType(\false)]); } return new StringType(); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\MethodCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\MethodReflection; use PHPStan\Type\Accessory\AccessoryArrayListType; use PHPStan\Type\ArrayType; use PHPStan\Type\DynamicMethodReturnTypeExtension; use PHPStan\Type\Generic\GenericObjectType; use PHPStan\Type\IntegerType; use PHPStan\Type\Type; use ReflectionAttribute; use function count; final class ReflectionGetAttributesMethodReturnTypeExtension implements DynamicMethodReturnTypeExtension { /** * @var class-string */ private $className; /** * @param class-string $className One of reflection classes: https://www.php.net/manual/en/book.reflection.php */ public function __construct(string $className) { $this->className = $className; } public function getClass() : string { return $this->className; } public function isMethodSupported(MethodReflection $methodReflection) : bool { return $methodReflection->getDeclaringClass()->getName() === $this->className && $methodReflection->getName() === 'getAttributes'; } public function getTypeFromMethodCall(MethodReflection $methodReflection, MethodCall $methodCall, Scope $scope) : ?Type { if (count($methodCall->getArgs()) === 0) { return null; } $argType = $scope->getType($methodCall->getArgs()[0]->value); $classType = $argType->getClassStringObjectType(); return AccessoryArrayListType::intersectWith(new ArrayType(new IntegerType(), new GenericObjectType(ReflectionAttribute::class, [$classType]))); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\NeverType; use PHPStan\Type\NullType; use PHPStan\Type\Type; final class ArrayReverseFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { /** * @var PhpVersion */ private $phpVersion; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; } public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'array_reverse'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (!isset($functionCall->getArgs()[0])) { return null; } $type = $scope->getType($functionCall->getArgs()[0]->value); if ($type->isArray()->no()) { return $this->phpVersion->arrayFunctionsReturnNullWithNonArray() ? new NullType() : new NeverType(); } $preserveKeysType = isset($functionCall->getArgs()[1]) ? $scope->getType($functionCall->getArgs()[1]->value) : new ConstantBooleanType(\false); return $type->reverseArray($preserveKeysType->isTrue()); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\IntegerRangeType; use PHPStan\Type\Type; use PHPStan\Type\UnionType; use function array_map; use function assert; use function count; use function in_array; use function max; use function min; final class RandomIntFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return in_array($functionReflection->getName(), ['random_int', 'rand', 'mt_rand'], \true); } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (in_array($functionReflection->getName(), ['rand', 'mt_rand'], \true) && count($functionCall->getArgs()) === 0) { return IntegerRangeType::fromInterval(0, null); } if (count($functionCall->getArgs()) < 2) { return null; } $minType = $scope->getType($functionCall->getArgs()[0]->value)->toInteger(); $maxType = $scope->getType($functionCall->getArgs()[1]->value)->toInteger(); return $this->createRange($minType, $maxType); } private function createRange(Type $minType, Type $maxType) : Type { $minValues = array_map(static function (Type $type) : ?int { if ($type instanceof IntegerRangeType) { return $type->getMin(); } if ($type instanceof ConstantIntegerType) { return $type->getValue(); } return null; }, $minType instanceof UnionType ? $minType->getTypes() : [$minType]); $maxValues = array_map(static function (Type $type) : ?int { if ($type instanceof IntegerRangeType) { return $type->getMax(); } if ($type instanceof ConstantIntegerType) { return $type->getValue(); } return null; }, $maxType instanceof UnionType ? $maxType->getTypes() : [$maxType]); assert(count($minValues) > 0); assert(count($maxValues) > 0); return IntegerRangeType::fromInterval(in_array(null, $minValues, \true) ? null : min($minValues), in_array(null, $maxValues, \true) ? null : max($maxValues)); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\Type; final class ArrayFilterFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { /** * @var ArrayFilterFunctionReturnTypeHelper */ private $arrayFilterFunctionReturnTypeHelper; public function __construct(\PHPStan\Type\Php\ArrayFilterFunctionReturnTypeHelper $arrayFilterFunctionReturnTypeHelper) { $this->arrayFilterFunctionReturnTypeHelper = $arrayFilterFunctionReturnTypeHelper; } public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'array_filter'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : Type { $arrayArg = $functionCall->getArgs()[0]->value ?? null; $callbackArg = $functionCall->getArgs()[1]->value ?? null; $flagArg = $functionCall->getArgs()[2]->value ?? null; return $this->arrayFilterFunctionReturnTypeHelper->getType($scope, $arrayArg, $callbackArg, $flagArg); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Accessory\AccessoryLowercaseStringType; use PHPStan\Type\Accessory\AccessoryNonEmptyStringType; use PHPStan\Type\Accessory\AccessoryNonFalsyStringType; use PHPStan\Type\Accessory\AccessoryNumericStringType; use PHPStan\Type\Accessory\AccessoryUppercaseStringType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\IntersectionType; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\TypeUtils; use function array_diff; use function array_map; use function count; use function in_array; use function is_callable; use function mb_check_encoding; use const MB_CASE_LOWER; use const MB_CASE_UPPER; final class StrCaseFunctionsReturnTypeExtension implements DynamicFunctionReturnTypeExtension { /** * [function name => minimum arity] */ private const FUNCTIONS = ['strtoupper' => 1, 'strtolower' => 1, 'mb_strtoupper' => 1, 'mb_strtolower' => 1, 'lcfirst' => 1, 'ucfirst' => 1, 'mb_lcfirst' => 1, 'mb_ucfirst' => 1, 'ucwords' => 1, 'mb_convert_case' => 2, 'mb_convert_kana' => 1]; public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return isset(self::FUNCTIONS[$functionReflection->getName()]); } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { $fnName = $functionReflection->getName(); $args = $functionCall->getArgs(); if (count($args) < self::FUNCTIONS[$fnName]) { return null; } $argType = $scope->getType($args[0]->value); if (!is_callable($fnName)) { return null; } $modes = []; $keepLowercase = \false; $forceLowercase = \false; $keepUppercase = \false; $forceUppercase = \false; if ($fnName === 'mb_convert_case') { $modeType = $scope->getType($args[1]->value); $modes = array_map(static function ($mode) { return $mode->getValue(); }, TypeUtils::getConstantIntegers($modeType)); if (count($modes) > 0) { $forceLowercase = count(array_diff($modes, [MB_CASE_LOWER, 5])) === 0; $keepLowercase = count(array_diff($modes, [ MB_CASE_LOWER, 5, // MB_CASE_LOWER_SIMPLE 3, // MB_CASE_FOLD, 7, ])) === 0; $forceUppercase = count(array_diff($modes, [MB_CASE_UPPER, 4])) === 0; $keepUppercase = count(array_diff($modes, [ MB_CASE_UPPER, 4, // MB_CASE_UPPER_SIMPLE 3, // MB_CASE_FOLD, 7, ])) === 0; } } elseif (in_array($fnName, ['ucwords', 'mb_convert_kana'], \true)) { if (count($args) >= 2) { $modeType = $scope->getType($args[1]->value); $modes = array_map(static function ($mode) { return $mode->getValue(); }, $modeType->getConstantStrings()); } else { $modes = $fnName === 'mb_convert_kana' ? ['KV'] : [" \t\r\n\f\v"]; } } elseif (in_array($fnName, ['strtolower', 'mb_strtolower'], \true)) { $forceLowercase = \true; } elseif (in_array($fnName, ['lcfirst', 'mb_lcfirst'], \true)) { $keepLowercase = \true; } elseif (in_array($fnName, ['strtoupper', 'mb_strtoupper'], \true)) { $forceUppercase = \true; } elseif (in_array($fnName, ['ucfirst', 'mb_ucfirst'], \true)) { $keepUppercase = \true; } $constantStrings = array_map(static function ($type) { return $type->getValue(); }, $argType->getConstantStrings()); if (count($constantStrings) > 0 && mb_check_encoding($constantStrings, 'UTF-8')) { $strings = []; $parameters = []; if (in_array($fnName, ['ucwords', 'mb_convert_case', 'mb_convert_kana'], \true)) { foreach ($modes as $mode) { foreach ($constantStrings as $constantString) { $parameters[] = [$constantString, $mode]; } } } else { $parameters = array_map(static function ($s) { return [$s]; }, $constantStrings); } foreach ($parameters as $parameter) { $strings[] = $fnName(...$parameter); } if (count($strings) !== 0 && mb_check_encoding($strings, 'UTF-8')) { return TypeCombinator::union(...array_map(static function ($s) { return new ConstantStringType($s); }, $strings)); } } $accessoryTypes = []; if ($forceLowercase || $keepLowercase && $argType->isLowercaseString()->yes()) { $accessoryTypes[] = new AccessoryLowercaseStringType(); } if ($forceUppercase || $keepUppercase && $argType->isUppercaseString()->yes()) { $accessoryTypes[] = new AccessoryUppercaseStringType(); } if ($argType->isNumericString()->yes()) { $accessoryTypes[] = new AccessoryNumericStringType(); } elseif ($argType->isNonFalsyString()->yes()) { $accessoryTypes[] = new AccessoryNonFalsyStringType(); } elseif ($argType->isNonEmptyString()->yes()) { $accessoryTypes[] = new AccessoryNonEmptyStringType(); } if (count($accessoryTypes) > 0) { $accessoryTypes[] = new StringType(); return new IntersectionType($accessoryTypes); } return new StringType(); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Arg; use PhpParser\Node\Expr\FuncCall; use PhpParser\Node\Name\FullyQualified; use PhpParser\Node\Scalar\String_; use PHPStan\Analyser\Scope; use PHPStan\Analyser\SpecifiedTypes; use PHPStan\Analyser\TypeSpecifier; use PHPStan\Analyser\TypeSpecifierAwareExtension; use PHPStan\Analyser\TypeSpecifierContext; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\ClassStringType; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\FunctionTypeSpecifyingExtension; use PHPStan\Type\Generic\GenericClassStringType; use PHPStan\Type\ObjectType; use function in_array; use function ltrim; final class ClassExistsFunctionTypeSpecifyingExtension implements FunctionTypeSpecifyingExtension, TypeSpecifierAwareExtension { /** * @var TypeSpecifier */ private $typeSpecifier; public function isFunctionSupported(FunctionReflection $functionReflection, FuncCall $node, TypeSpecifierContext $context) : bool { return in_array($functionReflection->getName(), ['class_exists', 'interface_exists', 'trait_exists', 'enum_exists'], \true) && isset($node->getArgs()[0]) && $context->true(); } public function specifyTypes(FunctionReflection $functionReflection, FuncCall $node, Scope $scope, TypeSpecifierContext $context) : SpecifiedTypes { $argType = $scope->getType($node->getArgs()[0]->value); if ($argType instanceof ConstantStringType) { return $this->typeSpecifier->create(new FuncCall(new FullyQualified('class_exists'), [new Arg(new String_(ltrim($argType->getValue(), '\\')))]), new ConstantBooleanType(\true), $context, \false, $scope); } $narrowedType = new ClassStringType(); if ($functionReflection->getName() === 'enum_exists') { $narrowedType = new GenericClassStringType(new ObjectType('UnitEnum')); } return $this->typeSpecifier->create($node->getArgs()[0]->value, $narrowedType, $context, \false, $scope); } public function setTypeSpecifier(TypeSpecifier $typeSpecifier) : void { $this->typeSpecifier = $typeSpecifier; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\NullType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; final class ArrayKeyFirstDynamicReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'array_key_first'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (!isset($functionCall->getArgs()[0])) { return null; } $argType = $scope->getType($functionCall->getArgs()[0]->value); $iterableAtLeastOnce = $argType->isIterableAtLeastOnce(); if ($iterableAtLeastOnce->no()) { return new NullType(); } $keyType = $argType->getFirstIterableKeyType(); if ($iterableAtLeastOnce->yes()) { return $keyType; } return TypeCombinator::union($keyType, new NullType()); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Type\Accessory\AccessoryArrayListType; use PHPStan\Type\ArrayType; use PHPStan\Type\Constant\ConstantArrayTypeBuilder; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\MixedType; use PHPStan\Type\NeverType; use PHPStan\Type\NullType; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function array_combine; use function array_fill_keys; use function array_map; use function count; use function in_array; use function strtolower; final class FilterVarArrayDynamicReturnTypeExtension implements DynamicFunctionReturnTypeExtension { /** * @var FilterFunctionReturnTypeHelper */ private $filterFunctionReturnTypeHelper; /** * @var ReflectionProvider */ private $reflectionProvider; public function __construct(\PHPStan\Type\Php\FilterFunctionReturnTypeHelper $filterFunctionReturnTypeHelper, ReflectionProvider $reflectionProvider) { $this->filterFunctionReturnTypeHelper = $filterFunctionReturnTypeHelper; $this->reflectionProvider = $reflectionProvider; } public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return in_array(strtolower($functionReflection->getName()), ['filter_var_array', 'filter_input_array'], \true); } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (count($functionCall->getArgs()) < 2) { return null; } $functionName = strtolower($functionReflection->getName()); $inputArgType = $scope->getType($functionCall->getArgs()[0]->value); $inputConstantArrayType = null; if ($functionName === 'filter_var_array') { if ($inputArgType->isArray()->no()) { return new NeverType(); } $inputConstantArrayType = $inputArgType->getConstantArrays()[0] ?? null; } elseif ($functionName === 'filter_input_array') { $supportedTypes = TypeCombinator::union($this->reflectionProvider->getConstant(new Node\Name('INPUT_GET'), null)->getValueType(), $this->reflectionProvider->getConstant(new Node\Name('INPUT_POST'), null)->getValueType(), $this->reflectionProvider->getConstant(new Node\Name('INPUT_COOKIE'), null)->getValueType(), $this->reflectionProvider->getConstant(new Node\Name('INPUT_SERVER'), null)->getValueType(), $this->reflectionProvider->getConstant(new Node\Name('INPUT_ENV'), null)->getValueType()); if (!$inputArgType->isInteger()->yes() || $supportedTypes->isSuperTypeOf($inputArgType)->no()) { return null; } // Pragmatical solution since global expressions are not passed through the scope for performance reasons // See https://github.com/phpstan/phpstan-src/pull/2012 for details $inputArgType = new ArrayType(new StringType(), new MixedType()); } $filterArgType = $scope->getType($functionCall->getArgs()[1]->value); $filterConstantArrayType = $filterArgType->getConstantArrays()[0] ?? null; $addEmptyType = isset($functionCall->getArgs()[2]) ? $scope->getType($functionCall->getArgs()[2]->value) : null; $addEmpty = $addEmptyType === null || $addEmptyType->isTrue()->yes(); $valueTypesBuilder = ConstantArrayTypeBuilder::createEmpty(); if ($filterArgType instanceof ConstantIntegerType) { if ($inputConstantArrayType === null) { $isList = $inputArgType->isList()->yes(); $valueType = $this->filterFunctionReturnTypeHelper->getType($inputArgType->getIterableValueType(), $filterArgType, null); $arrayType = new ArrayType($inputArgType->getIterableKeyType(), $valueType); return $isList ? AccessoryArrayListType::intersectWith($arrayType) : $arrayType; } // Override $add_empty option $addEmpty = \false; $keysType = $inputConstantArrayType; $inputKeysList = array_map(static function ($type) { return $type->getValue(); }, $inputConstantArrayType->getKeyTypes()); $filterTypesMap = array_fill_keys($inputKeysList, $filterArgType); $inputTypesMap = array_combine($inputKeysList, $inputConstantArrayType->getValueTypes()); $optionalKeys = []; foreach ($inputConstantArrayType->getOptionalKeys() as $index) { if (!isset($inputKeysList[$index])) { continue; } $optionalKeys[] = $inputKeysList[$index]; } } elseif ($filterConstantArrayType === null) { if ($inputConstantArrayType === null) { $isList = $inputArgType->isList()->yes(); $valueType = $this->filterFunctionReturnTypeHelper->getType($inputArgType, $filterArgType, null); $arrayType = new ArrayType($inputArgType->getIterableKeyType(), $addEmpty ? TypeCombinator::addNull($valueType) : $valueType); return $isList ? AccessoryArrayListType::intersectWith($arrayType) : $arrayType; } return null; } else { $keysType = $filterConstantArrayType; $filterKeyTypes = $filterConstantArrayType->getKeyTypes(); $filterKeysList = array_map(static function ($type) { return $type->getValue(); }, $filterKeyTypes); $filterTypesMap = array_combine($filterKeysList, $keysType->getValueTypes()); if ($inputConstantArrayType !== null) { $inputKeysList = array_map(static function ($type) { return $type->getValue(); }, $inputConstantArrayType->getKeyTypes()); $inputTypesMap = array_combine($inputKeysList, $inputConstantArrayType->getValueTypes()); $optionalKeys = []; foreach ($inputConstantArrayType->getOptionalKeys() as $index) { if (!isset($inputKeysList[$index])) { continue; } $optionalKeys[] = $inputKeysList[$index]; } } else { $optionalKeys = $filterKeysList; $inputTypesMap = array_fill_keys($optionalKeys, $inputArgType->getIterableValueType()); } } foreach ($keysType->getKeyTypes() as $keyType) { $optional = \false; $key = $keyType->getValue(); $inputType = $inputTypesMap[$key] ?? null; if ($inputType === null) { if ($addEmpty) { $valueTypesBuilder->setOffsetValueType($keyType, new NullType()); } continue; } [$filterType, $flagsType] = $this->fetchFilter($filterTypesMap[$key] ?? new MixedType()); $valueType = $this->filterFunctionReturnTypeHelper->getType($inputType, $filterType, $flagsType); if (in_array($key, $optionalKeys, \true)) { if ($addEmpty) { $valueType = TypeCombinator::addNull($valueType); } else { $optional = \true; } } $valueTypesBuilder->setOffsetValueType($keyType, $valueType, $optional); } return $valueTypesBuilder->getArray(); } /** @return array{?Type, ?Type} */ public function fetchFilter(Type $type) : array { if (!$type->isArray()->yes()) { return [$type, null]; } $filterKey = new ConstantStringType('filter'); if (!$type->hasOffsetValueType($filterKey)->yes()) { return [$type, null]; } $filterOffsetType = $type->getOffsetValueType($filterKey); $filterType = null; if (count($filterOffsetType->getConstantScalarTypes()) > 0) { $filterType = TypeCombinator::union(...$filterOffsetType->getConstantScalarTypes()); } return [$filterType, $type]; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\StaticCall; use PhpParser\Node\Name; use PHPStan\Analyser\Scope; use PHPStan\Reflection\MethodReflection; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Type\DynamicStaticMethodThrowTypeExtension; use PHPStan\Type\NeverType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use ReflectionFunction; use function count; final class ReflectionFunctionConstructorThrowTypeExtension implements DynamicStaticMethodThrowTypeExtension { /** * @var ReflectionProvider */ private $reflectionProvider; public function __construct(ReflectionProvider $reflectionProvider) { $this->reflectionProvider = $reflectionProvider; } public function isStaticMethodSupported(MethodReflection $methodReflection) : bool { return $methodReflection->getName() === '__construct' && $methodReflection->getDeclaringClass()->getName() === ReflectionFunction::class; } public function getThrowTypeFromStaticMethodCall(MethodReflection $methodReflection, StaticCall $methodCall, Scope $scope) : ?Type { if (count($methodCall->getArgs()) < 1) { return $methodReflection->getThrowType(); } $valueType = $scope->getType($methodCall->getArgs()[0]->value); foreach ($valueType->getConstantStrings() as $constantString) { if ($constantString->getValue() === '') { return null; } if (!$this->reflectionProvider->hasFunction(new Name($constantString->getValue()), $scope)) { return $methodReflection->getThrowType(); } $valueType = TypeCombinator::remove($valueType, $constantString); } if (!$valueType instanceof NeverType) { return $methodReflection->getThrowType(); } return null; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use DateInterval; use PhpParser\Node\Expr\StaticCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\MethodReflection; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\DynamicStaticMethodReturnTypeExtension; use PHPStan\Type\ObjectType; use PHPStan\Type\Type; use Throwable; use function count; use function in_array; final class DateIntervalDynamicReturnTypeExtension implements DynamicStaticMethodReturnTypeExtension { public function getClass() : string { return DateInterval::class; } public function isStaticMethodSupported(MethodReflection $methodReflection) : bool { return $methodReflection->getName() === 'createFromDateString'; } public function getTypeFromStaticMethodCall(MethodReflection $methodReflection, StaticCall $methodCall, Scope $scope) : ?Type { $arguments = $methodCall->getArgs(); if (!isset($arguments[0])) { return null; } $strings = $scope->getType($arguments[0]->value)->getConstantStrings(); $possibleReturnTypes = []; foreach ($strings as $string) { try { $result = @DateInterval::createFromDateString($string->getValue()); } catch (Throwable $e) { $possibleReturnTypes[] = \false; continue; } $possibleReturnTypes[] = $result instanceof DateInterval ? DateInterval::class : \false; } // the error case, when wrong types are passed if (count($possibleReturnTypes) === 0) { return null; } if (in_array(\false, $possibleReturnTypes, \true) && in_array(DateInterval::class, $possibleReturnTypes, \true)) { return null; } if (in_array(\false, $possibleReturnTypes, \true)) { return new ConstantBooleanType(\false); } return new ObjectType(DateInterval::class); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\NullType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; final class ArrayPopFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'array_pop'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (!isset($functionCall->getArgs()[0])) { return null; } $argType = $scope->getType($functionCall->getArgs()[0]->value); $iterableAtLeastOnce = $argType->isIterableAtLeastOnce(); if ($iterableAtLeastOnce->no()) { return new NullType(); } $itemType = $argType->getLastIterableValueType(); if ($iterableAtLeastOnce->yes()) { return $itemType; } return TypeCombinator::union($itemType, new NullType()); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\StringType; use PHPStan\Type\Type; use function count; final class DateFormatFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { /** * @var DateFunctionReturnTypeHelper */ private $dateFunctionReturnTypeHelper; public function __construct(\PHPStan\Type\Php\DateFunctionReturnTypeHelper $dateFunctionReturnTypeHelper) { $this->dateFunctionReturnTypeHelper = $dateFunctionReturnTypeHelper; } public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'date_format'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : Type { if (count($functionCall->getArgs()) < 2) { return new StringType(); } return $this->dateFunctionReturnTypeHelper->getTypeFromFormatType($scope->getType($functionCall->getArgs()[1]->value), \true); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\BinaryOp\Mul; use PhpParser\Node\Expr\BinaryOp\Plus; use PhpParser\Node\Expr\FuncCall; use PhpParser\Node\Scalar\LNumber; use PHPStan\Analyser\Scope; use PHPStan\Node\Expr\TypeExpr; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\IntegerRangeType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function count; final class ArraySumFunctionDynamicReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'array_sum'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (!isset($functionCall->getArgs()[0])) { return null; } $argType = $scope->getType($functionCall->getArgs()[0]->value); $resultTypes = []; if (count($argType->getConstantArrays()) > 0) { foreach ($argType->getConstantArrays() as $constantArray) { $node = new LNumber(0); foreach ($constantArray->getValueTypes() as $i => $type) { if ($constantArray->isOptionalKey($i)) { $node = new Plus($node, new TypeExpr(TypeCombinator::union($type, new ConstantIntegerType(0)))); } else { $node = new Plus($node, new TypeExpr($type)); } } $resultTypes[] = $scope->getType($node); } } else { $itemType = $argType->getIterableValueType(); $mulNode = new Mul(new TypeExpr($itemType), new TypeExpr(IntegerRangeType::fromInterval(0, null))); $resultTypes[] = $scope->getType(new Plus(new TypeExpr($itemType), $mulNode)); } if (!$argType->isIterableAtLeastOnce()->yes()) { $resultTypes[] = new ConstantIntegerType(0); } return TypeCombinator::union(...$resultTypes)->toNumber(); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; final class ArrayCurrentDynamicReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'current'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (!isset($functionCall->getArgs()[0])) { return null; } $argType = $scope->getType($functionCall->getArgs()[0]->value); $iterableAtLeastOnce = $argType->isIterableAtLeastOnce(); if ($iterableAtLeastOnce->no()) { return new ConstantBooleanType(\false); } $keyType = $argType->getIterableValueType(); if ($iterableAtLeastOnce->yes()) { return $keyType; } return TypeCombinator::union($keyType, new ConstantBooleanType(\false)); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PHPStan\ShouldNotHappenException; use function array_filter; use function array_map; use function array_merge; use function function_exists; use function in_array; use function is_null; use function mb_encoding_aliases; use function mb_list_encodings; use function strtoupper; trait MbFunctionsReturnTypeExtensionTrait { /** @var string[]|null */ private $supportedEncodings = null; private function isSupportedEncoding(string $encoding) : bool { return in_array(strtoupper($encoding), $this->getSupportedEncodings(), \true); } /** @return string[] */ private function getSupportedEncodings() : array { if (!is_null($this->supportedEncodings)) { return $this->supportedEncodings; } $supportedEncodings = []; if (function_exists('mb_list_encodings')) { foreach (mb_list_encodings() as $encoding) { $aliases = @mb_encoding_aliases($encoding); if ($aliases === \false) { throw new ShouldNotHappenException(); } $supportedEncodings = array_merge($supportedEncodings, $aliases, [$encoding]); } } $this->supportedEncodings = array_map('strtoupper', $supportedEncodings); // PHP 7.3 and 7.4 claims 'pass' and its alias 'none' to be supported, but actually 'pass' was removed in 7.3 if (!$this->phpVersion->supportsPassNoneEncodings()) { $this->supportedEncodings = array_filter($this->supportedEncodings, static function (string $enc) { return !in_array($enc, ['PASS', 'NONE'], \true); }); } return $this->supportedEncodings; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\NullType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; final class ArrayKeyLastDynamicReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'array_key_last'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (!isset($functionCall->getArgs()[0])) { return null; } $argType = $scope->getType($functionCall->getArgs()[0]->value); $iterableAtLeastOnce = $argType->isIterableAtLeastOnce(); if ($iterableAtLeastOnce->no()) { return new NullType(); } $keyType = $argType->getLastIterableKeyType(); if ($iterableAtLeastOnce->yes()) { return $keyType; } return TypeCombinator::union($keyType, new NullType()); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Constant\ConstantArrayTypeBuilder; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\IntegerType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; final class DioStatDynamicFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'dio_stat'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : Type { $valueType = new IntegerType(); $builder = ConstantArrayTypeBuilder::createEmpty(); $keys = ['device', 'inode', 'mode', 'nlink', 'uid', 'gid', 'device_type', 'size', 'blocksize', 'blocks', 'atime', 'mtime', 'ctime']; foreach ($keys as $key) { $builder->setOffsetValueType(new ConstantStringType($key), $valueType); } return TypeCombinator::addNull($builder->getArray()); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Analyser\SpecifiedTypes; use PHPStan\Analyser\TypeSpecifier; use PHPStan\Analyser\TypeSpecifierAwareExtension; use PHPStan\Analyser\TypeSpecifierContext; use PHPStan\Reflection\FunctionReflection; use PHPStan\TrinaryLogic; use PHPStan\Type\FunctionTypeSpecifyingExtension; use function in_array; use function strtolower; final class PregMatchTypeSpecifyingExtension implements FunctionTypeSpecifyingExtension, TypeSpecifierAwareExtension { /** * @var RegexArrayShapeMatcher */ private $regexShapeMatcher; /** * @var TypeSpecifier */ private $typeSpecifier; public function __construct(\PHPStan\Type\Php\RegexArrayShapeMatcher $regexShapeMatcher) { $this->regexShapeMatcher = $regexShapeMatcher; } public function setTypeSpecifier(TypeSpecifier $typeSpecifier) : void { $this->typeSpecifier = $typeSpecifier; } public function isFunctionSupported(FunctionReflection $functionReflection, FuncCall $node, TypeSpecifierContext $context) : bool { return in_array(strtolower($functionReflection->getName()), ['preg_match', 'preg_match_all'], \true) && !$context->null(); } public function specifyTypes(FunctionReflection $functionReflection, FuncCall $node, Scope $scope, TypeSpecifierContext $context) : SpecifiedTypes { $args = $node->getArgs(); $patternArg = $args[0] ?? null; $matchesArg = $args[2] ?? null; $flagsArg = $args[3] ?? null; if ($patternArg === null || $matchesArg === null) { return new SpecifiedTypes(); } $flagsType = null; if ($flagsArg !== null) { $flagsType = $scope->getType($flagsArg->value); } if ($functionReflection->getName() === 'preg_match') { $matchedType = $this->regexShapeMatcher->matchExpr($patternArg->value, $flagsType, TrinaryLogic::createFromBoolean($context->true()), $scope); } else { $matchedType = $this->regexShapeMatcher->matchAllExpr($patternArg->value, $flagsType, TrinaryLogic::createFromBoolean($context->true()), $scope); } if ($matchedType === null) { return new SpecifiedTypes(); } $overwrite = \false; if ($context->false()) { $overwrite = \true; $context = $context->negate(); } return $this->typeSpecifier->create($matchesArg->value, $matchedType, $context, $overwrite, $scope, $node); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\Array_; use PhpParser\Node\Expr\BinaryOp\Equal; use PhpParser\Node\Expr\BinaryOp\Identical; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Analyser\SpecifiedTypes; use PHPStan\Analyser\TypeSpecifier; use PHPStan\Analyser\TypeSpecifierAwareExtension; use PHPStan\Analyser\TypeSpecifierContext; use PHPStan\Node\Expr\AlwaysRememberedExpr; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Accessory\NonEmptyArrayType; use PHPStan\Type\ArrayType; use PHPStan\Type\FunctionTypeSpecifyingExtension; use PHPStan\Type\MixedType; use PHPStan\Type\TypeCombinator; use PHPStan\Type\TypeUtils; use function count; use function strtolower; final class InArrayFunctionTypeSpecifyingExtension implements FunctionTypeSpecifyingExtension, TypeSpecifierAwareExtension { /** * @var TypeSpecifier */ private $typeSpecifier; public function setTypeSpecifier(TypeSpecifier $typeSpecifier) : void { $this->typeSpecifier = $typeSpecifier; } public function isFunctionSupported(FunctionReflection $functionReflection, FuncCall $node, TypeSpecifierContext $context) : bool { return strtolower($functionReflection->getName()) === 'in_array' && !$context->null(); } public function specifyTypes(FunctionReflection $functionReflection, FuncCall $node, Scope $scope, TypeSpecifierContext $context) : SpecifiedTypes { $argsCount = count($node->getArgs()); if ($argsCount < 2) { return new SpecifiedTypes(); } $isStrictComparison = \false; if ($argsCount >= 3) { $strictNodeType = $scope->getType($node->getArgs()[2]->value); $isStrictComparison = $strictNodeType->isTrue()->yes(); } $needleExpr = $node->getArgs()[0]->value; $arrayExpr = $node->getArgs()[1]->value; $needleType = $scope->getType($needleExpr); $arrayType = $scope->getType($arrayExpr); $arrayValueType = $arrayType->getIterableValueType(); $isStrictComparison = $isStrictComparison || $needleType->isEnum()->yes() || $arrayValueType->isEnum()->yes(); if ($arrayExpr instanceof Array_) { $types = null; foreach ($arrayExpr->items as $item) { if ($item === null) { continue; } if ($item->unpack) { $types = null; break; } if ($isStrictComparison) { $itemTypes = $this->typeSpecifier->resolveIdentical(new Identical($needleExpr, $item->value), $scope, $context, null); } else { $itemTypes = $this->typeSpecifier->resolveEqual(new Equal($needleExpr, $item->value), $scope, $context, null); } if ($types === null) { $types = $itemTypes; continue; } $types = $context->true() ? $types->normalize($scope)->intersectWith($itemTypes->normalize($scope)) : $types->unionWith($itemTypes); } if ($types !== null) { return $types; } } if (!$isStrictComparison) { if ($context->true() && $arrayType->isArray()->yes() && $arrayType->getIterableValueType()->isSuperTypeOf($needleType)->yes()) { return $this->typeSpecifier->create($node->getArgs()[1]->value, TypeCombinator::intersect($arrayType, new NonEmptyArrayType()), $context, \false, $scope); } return new SpecifiedTypes(); } $specifiedTypes = new SpecifiedTypes(); if ($context->true() || $context->false() && (count(TypeUtils::getConstantScalars($arrayValueType)) > 0 || count(TypeUtils::getEnumCaseObjects($arrayValueType)) > 0)) { $specifiedTypes = $this->typeSpecifier->create($needleExpr, $arrayValueType, $context, \false, $scope); if ($needleExpr instanceof AlwaysRememberedExpr) { $specifiedTypes = $specifiedTypes->unionWith($this->typeSpecifier->create($needleExpr->getExpr(), $arrayValueType, $context, \false, $scope)); } } if ($context->true() || $context->false() && (count(TypeUtils::getConstantScalars($needleType)) === 1 || count(TypeUtils::getEnumCaseObjects($needleType)) === 1)) { if ($context->true()) { $arrayValueType = TypeCombinator::union($arrayValueType, $needleType); } else { $arrayValueType = TypeCombinator::remove($arrayValueType, $needleType); } $specifiedTypes = $specifiedTypes->unionWith($this->typeSpecifier->create($node->getArgs()[1]->value, new ArrayType(new MixedType(), $arrayValueType), TypeSpecifierContext::createTrue(), \false, $scope)); } if ($context->true() && $arrayType->isArray()->yes()) { $specifiedTypes = $specifiedTypes->unionWith($this->typeSpecifier->create($node->getArgs()[1]->value, TypeCombinator::intersect($arrayType, new NonEmptyArrayType()), $context, \false, $scope)); } return $specifiedTypes; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\Type; use function count; use function strtolower; final class FilterVarDynamicReturnTypeExtension implements DynamicFunctionReturnTypeExtension { /** * @var FilterFunctionReturnTypeHelper */ private $filterFunctionReturnTypeHelper; public function __construct(\PHPStan\Type\Php\FilterFunctionReturnTypeHelper $filterFunctionReturnTypeHelper) { $this->filterFunctionReturnTypeHelper = $filterFunctionReturnTypeHelper; } public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return strtolower($functionReflection->getName()) === 'filter_var'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (count($functionCall->getArgs()) < 1) { return null; } $inputType = $scope->getType($functionCall->getArgs()[0]->value); $filterType = isset($functionCall->getArgs()[1]) ? $scope->getType($functionCall->getArgs()[1]->value) : null; $flagsType = isset($functionCall->getArgs()[2]) ? $scope->getType($functionCall->getArgs()[2]->value) : null; return $this->filterFunctionReturnTypeHelper->getType($inputType, $filterType, $flagsType); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Analyser\SpecifiedTypes; use PHPStan\Analyser\TypeSpecifier; use PHPStan\Analyser\TypeSpecifierAwareExtension; use PHPStan\Analyser\TypeSpecifierContext; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\ErrorType; use PHPStan\Type\FunctionTypeSpecifyingExtension; use PHPStan\Type\NullType; use PHPStan\Type\ObjectType; use PHPStan\Type\TypeCombinator; use stdClass; use function count; use function strtolower; final class SetTypeFunctionTypeSpecifyingExtension implements FunctionTypeSpecifyingExtension, TypeSpecifierAwareExtension { /** * @var TypeSpecifier */ private $typeSpecifier; public function isFunctionSupported(FunctionReflection $functionReflection, FuncCall $node, TypeSpecifierContext $context) : bool { return strtolower($functionReflection->getName()) === 'settype' && count($node->getArgs()) > 1 && $context->null(); } public function specifyTypes(FunctionReflection $functionReflection, FuncCall $node, Scope $scope, TypeSpecifierContext $context) : SpecifiedTypes { $value = $node->getArgs()[0]->value; $valueType = $scope->getType($value); $castType = $scope->getType($node->getArgs()[1]->value); $constantStrings = $castType->getConstantStrings(); if (count($constantStrings) < 1) { return new SpecifiedTypes(); } $types = []; foreach ($constantStrings as $constantString) { switch ($constantString->getValue()) { case 'bool': case 'boolean': $types[] = $valueType->toBoolean(); break; case 'int': case 'integer': $types[] = $valueType->toInteger(); break; case 'float': case 'double': $types[] = $valueType->toFloat(); break; case 'string': $types[] = $valueType->toString(); break; case 'array': $types[] = $valueType->toArray(); break; case 'object': $types[] = new ObjectType(stdClass::class); break; case 'null': $types[] = new NullType(); break; default: $types[] = new ErrorType(); } } return $this->typeSpecifier->create($value, TypeCombinator::union(...$types), TypeSpecifierContext::createTruthy(), \true, $scope); } public function setTypeSpecifier(TypeSpecifier $typeSpecifier) : void { $this->typeSpecifier = $typeSpecifier; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Accessory\AccessoryNonEmptyStringType; use PHPStan\Type\Accessory\AccessoryNonFalsyStringType; use PHPStan\Type\Constant\ConstantArrayTypeBuilder; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\FloatType; use PHPStan\Type\IntegerType; use PHPStan\Type\IntersectionType; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function count; use function in_array; use function preg_match_all; final class SscanfFunctionDynamicReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return in_array($functionReflection->getName(), ['sscanf', 'fscanf'], \true); } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { $args = $functionCall->getArgs(); if (count($args) !== 2) { return null; } $formatType = $scope->getType($args[1]->value); if (!$formatType instanceof ConstantStringType) { return null; } if (preg_match_all('/%(\\d*)(\\[[^\\]]+\\]|[cdeEfosux]{1})/', $formatType->getValue(), $matches) > 0) { $arrayBuilder = ConstantArrayTypeBuilder::createEmpty(); for ($i = 0; $i < count($matches[0]); $i++) { $length = $matches[1][$i]; $specifier = $matches[2][$i]; $type = new StringType(); if ($length !== '') { if ((int) $length > 1) { $type = new IntersectionType([$type, new AccessoryNonFalsyStringType()]); } else { $type = new IntersectionType([$type, new AccessoryNonEmptyStringType()]); } } if (in_array($specifier, ['d', 'o', 'u', 'x'], \true)) { $type = new IntegerType(); } if (in_array($specifier, ['e', 'E', 'f'], \true)) { $type = new FloatType(); } $type = TypeCombinator::addNull($type); $arrayBuilder->setOffsetValueType(new ConstantIntegerType($i), $type); } return TypeCombinator::addNull($arrayBuilder->getArray()); } return null; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\NullType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; final class ArrayKeyDynamicReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'key'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (!isset($functionCall->getArgs()[0])) { return null; } $argType = $scope->getType($functionCall->getArgs()[0]->value); $iterableAtLeastOnce = $argType->isIterableAtLeastOnce(); if ($iterableAtLeastOnce->no()) { return new NullType(); } $keyType = $argType->getIterableKeyType(); if ($iterableAtLeastOnce->yes()) { return $keyType; } return TypeCombinator::union($keyType, new NullType()); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use DateTimeInterface; use PhpParser\Node\Expr\MethodCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\MethodReflection; use PHPStan\Type\DynamicMethodReturnTypeExtension; use PHPStan\Type\StringType; use PHPStan\Type\Type; use function count; final class DateFormatMethodReturnTypeExtension implements DynamicMethodReturnTypeExtension { /** * @var DateFunctionReturnTypeHelper */ private $dateFunctionReturnTypeHelper; public function __construct(\PHPStan\Type\Php\DateFunctionReturnTypeHelper $dateFunctionReturnTypeHelper) { $this->dateFunctionReturnTypeHelper = $dateFunctionReturnTypeHelper; } public function getClass() : string { return DateTimeInterface::class; } public function isMethodSupported(MethodReflection $methodReflection) : bool { return $methodReflection->getName() === 'format'; } public function getTypeFromMethodCall(MethodReflection $methodReflection, MethodCall $methodCall, Scope $scope) : Type { if (count($methodCall->getArgs()) === 0) { return new StringType(); } return $this->dateFunctionReturnTypeHelper->getTypeFromFormatType($scope->getType($methodCall->getArgs()[0]->value), \true); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Analyser\SpecifiedTypes; use PHPStan\Analyser\TypeSpecifier; use PHPStan\Analyser\TypeSpecifierAwareExtension; use PHPStan\Analyser\TypeSpecifierContext; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Accessory\HasMethodType; use PHPStan\Type\ClassStringType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\FunctionTypeSpecifyingExtension; use PHPStan\Type\IntersectionType; use PHPStan\Type\ObjectWithoutClassType; use PHPStan\Type\UnionType; use function count; final class MethodExistsTypeSpecifyingExtension implements FunctionTypeSpecifyingExtension, TypeSpecifierAwareExtension { /** * @var TypeSpecifier */ private $typeSpecifier; public function setTypeSpecifier(TypeSpecifier $typeSpecifier) : void { $this->typeSpecifier = $typeSpecifier; } public function isFunctionSupported(FunctionReflection $functionReflection, FuncCall $node, TypeSpecifierContext $context) : bool { return $functionReflection->getName() === 'method_exists' && $context->true() && count($node->getArgs()) >= 2; } public function specifyTypes(FunctionReflection $functionReflection, FuncCall $node, Scope $scope, TypeSpecifierContext $context) : SpecifiedTypes { $methodNameType = $scope->getType($node->getArgs()[1]->value); if (!$methodNameType instanceof ConstantStringType) { return new SpecifiedTypes([], []); } $objectType = $scope->getType($node->getArgs()[0]->value); if ($objectType->isString()->yes()) { if ($objectType->isClassStringType()->yes()) { return $this->typeSpecifier->create($node->getArgs()[0]->value, new IntersectionType([$objectType, new HasMethodType($methodNameType->getValue())]), $context, \false, $scope); } return new SpecifiedTypes([], []); } return $this->typeSpecifier->create($node->getArgs()[0]->value, new UnionType([new IntersectionType([new ObjectWithoutClassType(), new HasMethodType($methodNameType->getValue())]), new ClassStringType()]), $context, \false, $scope); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\MethodCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\MethodReflection; use PHPStan\Type\BooleanType; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\DynamicMethodReturnTypeExtension; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\UnionType; use SimpleXMLElement; use function count; final class SimpleXMLElementAsXMLMethodReturnTypeExtension implements DynamicMethodReturnTypeExtension { public function getClass() : string { return SimpleXMLElement::class; } public function isMethodSupported(MethodReflection $methodReflection) : bool { return $methodReflection->getName() === 'asXML'; } public function getTypeFromMethodCall(MethodReflection $methodReflection, MethodCall $methodCall, Scope $scope) : Type { if (count($methodCall->getArgs()) === 1) { return new BooleanType(); } return new UnionType([new StringType(), new ConstantBooleanType(\false)]); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use Closure; use PhpParser\Node\Expr\MethodCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\MethodReflection; use PHPStan\Type\ClosureType; use PHPStan\Type\DynamicMethodReturnTypeExtension; use PHPStan\Type\Type; final class ClosureBindToDynamicReturnTypeExtension implements DynamicMethodReturnTypeExtension { public function getClass() : string { return Closure::class; } public function isMethodSupported(MethodReflection $methodReflection) : bool { return $methodReflection->getName() === 'bindTo'; } public function getTypeFromMethodCall(MethodReflection $methodReflection, MethodCall $methodCall, Scope $scope) : ?Type { $closureType = $scope->getType($methodCall->var); if (!$closureType instanceof ClosureType) { return null; } return $closureType; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use DateTimeZone; use PhpParser\Node\Expr\StaticCall; use PHPStan\Analyser\Scope; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\MethodReflection; use PHPStan\Type\DynamicStaticMethodThrowTypeExtension; use PHPStan\Type\NeverType; use PHPStan\Type\ObjectType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function count; final class DateTimeZoneConstructorThrowTypeExtension implements DynamicStaticMethodThrowTypeExtension { /** * @var PhpVersion */ private $phpVersion; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; } public function isStaticMethodSupported(MethodReflection $methodReflection) : bool { return $methodReflection->getName() === '__construct' && $methodReflection->getDeclaringClass()->getName() === DateTimeZone::class; } public function getThrowTypeFromStaticMethodCall(MethodReflection $methodReflection, StaticCall $methodCall, Scope $scope) : ?Type { if (count($methodCall->getArgs()) === 0) { return null; } $valueType = $scope->getType($methodCall->getArgs()[0]->value); $constantStrings = $valueType->getConstantStrings(); foreach ($constantStrings as $constantString) { try { new DateTimeZone($constantString->getValue()); } catch (\Exception $e) { // phpcs:ignore return $this->exceptionType(); } $valueType = TypeCombinator::remove($valueType, $constantString); } if (!$valueType instanceof NeverType) { return $this->exceptionType(); } return null; } private function exceptionType() : Type { if ($this->phpVersion->hasDateTimeExceptions()) { return new ObjectType('DateInvalidTimeZoneException'); } return new ObjectType('Exception'); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Accessory\AccessoryNumericStringType; use PHPStan\Type\BooleanType; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\FloatType; use PHPStan\Type\IntegerType; use PHPStan\Type\IntersectionType; use PHPStan\Type\MixedType; use PHPStan\Type\NeverType; use PHPStan\Type\NullType; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function count; use function in_array; final class RoundFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { /** * @var PhpVersion */ private $phpVersion; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; } public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return in_array($functionReflection->getName(), ['round', 'ceil', 'floor'], \true); } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { // PHP 7 can return either a float or false. // PHP 8 can either return a float or fatal. $defaultReturnType = null; if ($this->phpVersion->hasStricterRoundFunctions()) { // PHP 8 fatals with a missing parameter. $noArgsReturnType = new NeverType(\true); } else { // PHP 7 returns null with a missing parameter. $noArgsReturnType = new NullType(); } if (count($functionCall->getArgs()) < 1) { return $noArgsReturnType; } $firstArgType = $scope->getType($functionCall->getArgs()[0]->value); if ($firstArgType instanceof MixedType) { return $defaultReturnType; } if ($this->phpVersion->hasStricterRoundFunctions()) { $allowed = TypeCombinator::union(new IntegerType(), new FloatType()); if (!$scope->isDeclareStrictTypes()) { $allowed = TypeCombinator::union($allowed, new IntersectionType([new StringType(), new AccessoryNumericStringType()]), new NullType(), new BooleanType()); } if ($allowed->isSuperTypeOf($firstArgType)->no()) { // PHP 8 fatals if the parameter is not an integer or float. return new NeverType(\true); } } elseif ($firstArgType->isArray()->yes()) { // PHP 7 returns false if the parameter is an array. return new ConstantBooleanType(\false); } return new FloatType(); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Analyser\SpecifiedTypes; use PHPStan\Analyser\TypeSpecifier; use PHPStan\Analyser\TypeSpecifierAwareExtension; use PHPStan\Analyser\TypeSpecifierContext; use PHPStan\Reflection\FunctionReflection; use PHPStan\ShouldNotHappenException; use PHPStan\Type\FunctionTypeSpecifyingExtension; use PHPStan\Type\IterableType; use PHPStan\Type\MixedType; use function strtolower; final class IsIterableFunctionTypeSpecifyingExtension implements FunctionTypeSpecifyingExtension, TypeSpecifierAwareExtension { /** * @var TypeSpecifier */ private $typeSpecifier; public function isFunctionSupported(FunctionReflection $functionReflection, FuncCall $node, TypeSpecifierContext $context) : bool { return strtolower($functionReflection->getName()) === 'is_iterable' && !$context->null(); } public function specifyTypes(FunctionReflection $functionReflection, FuncCall $node, Scope $scope, TypeSpecifierContext $context) : SpecifiedTypes { if ($context->null()) { throw new ShouldNotHappenException(); } if (!isset($node->getArgs()[0])) { return new SpecifiedTypes(); } return $this->typeSpecifier->create($node->getArgs()[0]->value, new IterableType(new MixedType(), new MixedType()), $context, \false, $scope); } public function setTypeSpecifier(TypeSpecifier $typeSpecifier) : void { $this->typeSpecifier = $typeSpecifier; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\BenevolentUnionType; use PHPStan\Type\Constant\ConstantArrayType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\FloatType; use PHPStan\Type\IntegerType; use PHPStan\Type\MixedType; use PHPStan\Type\Type; use PHPStan\Type\UnionType; final class GettimeofdayDynamicFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'gettimeofday'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : Type { $arrayType = new ConstantArrayType([new ConstantStringType('sec'), new ConstantStringType('usec'), new ConstantStringType('minuteswest'), new ConstantStringType('dsttime')], [new IntegerType(), new IntegerType(), new IntegerType(), new IntegerType()]); $floatType = new FloatType(); if (!isset($functionCall->getArgs()[0])) { return $arrayType; } $argType = $scope->getType($functionCall->getArgs()[0]->value); $isTrueType = $argType->isTrue(); $isFalseType = $argType->isFalse(); $compareTypes = $isTrueType->compareTo($isFalseType); if ($compareTypes === $isTrueType) { return $floatType; } if ($compareTypes === $isFalseType) { return $arrayType; } if ($argType instanceof MixedType) { return new BenevolentUnionType([$arrayType, $floatType]); } return new UnionType([$arrayType, $floatType]); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\ErrorType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function chr; use function count; use function implode; use function in_array; use function is_float; use function is_int; use function is_numeric; use function is_string; use function ord; use function preg_match; use function str_split; use function stripos; final class StrIncrementDecrementFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return in_array($functionReflection->getName(), ['str_increment', 'str_decrement'], \true); } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { $fnName = $functionReflection->getName(); $args = $functionCall->getArgs(); if (count($args) !== 1) { return null; } $argType = $scope->getType($args[0]->value); if (count($argType->getConstantScalarValues()) === 0) { return null; } $types = []; foreach ($argType->getConstantScalarValues() as $value) { if (!(is_string($value) || is_int($value) || is_float($value))) { continue; } $string = (string) $value; if (preg_match('/\\A(?:0|[1-9A-Za-z][0-9A-Za-z]*)+\\z/', $string) < 1) { continue; } $result = null; if ($fnName === 'str_increment') { $result = $this->increment($string); } elseif ($fnName === 'str_decrement') { $result = $this->decrement($string); } if ($result === null) { continue; } $types[] = new ConstantStringType($result); } return count($types) === 0 ? new ErrorType() : TypeCombinator::union(...$types); } private function increment(string $s) : string { if (is_numeric($s)) { $offset = stripos($s, 'e'); if ($offset !== \false) { // Using increment operator would cast the string to float // Therefore we manually increment it to convert it to an "f"/"F" that doesn't get affected $c = $s[$offset]; $c++; $s[$offset] = $c; $s++; $s[$offset] = ['f' => 'e', 'F' => 'E', 'g' => 'f', 'G' => 'F'][$s[$offset]]; return $s; } } return (string) ++$s; } private function decrement(string $s) : ?string { if (in_array($s, ['a', 'A', '0'], \true)) { return null; } $decremented = str_split($s, 1); $position = count($decremented) - 1; $carry = \false; $map = ['0' => '9', 'A' => 'Z', 'a' => 'z']; do { $c = $decremented[$position]; if (!in_array($c, ['a', 'A', '0'], \true)) { $carry = \false; $decremented[$position] = chr(ord($c) - 1); } else { $carry = \true; $decremented[$position] = $map[$c]; } } while ($carry && $position-- > 0); if ($carry || count($decremented) > 1 && $decremented[0] === '0') { if (count($decremented) === 1) { return null; } unset($decremented[0]); } return implode($decremented); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Analyser\SpecifiedTypes; use PHPStan\Analyser\TypeSpecifier; use PHPStan\Analyser\TypeSpecifierAwareExtension; use PHPStan\Analyser\TypeSpecifierContext; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\FunctionTypeSpecifyingExtension; use function count; final class DefineConstantTypeSpecifyingExtension implements FunctionTypeSpecifyingExtension, TypeSpecifierAwareExtension { /** * @var TypeSpecifier */ private $typeSpecifier; public function setTypeSpecifier(TypeSpecifier $typeSpecifier) : void { $this->typeSpecifier = $typeSpecifier; } public function isFunctionSupported(FunctionReflection $functionReflection, FuncCall $node, TypeSpecifierContext $context) : bool { return $functionReflection->getName() === 'define' && $context->null() && count($node->getArgs()) >= 2; } public function specifyTypes(FunctionReflection $functionReflection, FuncCall $node, Scope $scope, TypeSpecifierContext $context) : SpecifiedTypes { $constantName = $scope->getType($node->getArgs()[0]->value); if (!$constantName instanceof ConstantStringType || $constantName->getValue() === '') { return new SpecifiedTypes([], []); } return $this->typeSpecifier->create(new Node\Expr\ConstFetch(new Node\Name\FullyQualified($constantName->getValue())), $scope->getType($node->getArgs()[1]->value), TypeSpecifierContext::createTruthy(), \true, $scope); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\StaticCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\MethodReflection; use PHPStan\Type\DynamicStaticMethodThrowTypeExtension; use PHPStan\Type\NeverType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use SimpleXMLElement; use function count; use function extension_loaded; use function libxml_use_internal_errors; final class SimpleXMLElementConstructorThrowTypeExtension implements DynamicStaticMethodThrowTypeExtension { public function isStaticMethodSupported(MethodReflection $methodReflection) : bool { return extension_loaded('simplexml') && $methodReflection->getName() === '__construct' && $methodReflection->getDeclaringClass()->getName() === SimpleXMLElement::class; } public function getThrowTypeFromStaticMethodCall(MethodReflection $methodReflection, StaticCall $methodCall, Scope $scope) : ?Type { if (count($methodCall->getArgs()) === 0) { return $methodReflection->getThrowType(); } $valueType = $scope->getType($methodCall->getArgs()[0]->value); $constantStrings = $valueType->getConstantStrings(); $internalErrorsOld = libxml_use_internal_errors(\true); try { foreach ($constantStrings as $constantString) { try { new SimpleXMLElement($constantString->getValue()); } catch (\Exception $e) { // phpcs:ignore return $methodReflection->getThrowType(); } $valueType = TypeCombinator::remove($valueType, $constantString); } } finally { libxml_use_internal_errors($internalErrorsOld); } if (!$valueType instanceof NeverType) { return $methodReflection->getThrowType(); } return null; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\NeverType; use PHPStan\Type\NullType; use PHPStan\Type\Type; use function count; final class ArrayFlipFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { /** * @var PhpVersion */ private $phpVersion; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; } public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'array_flip'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (count($functionCall->getArgs()) !== 1) { return null; } $arrayType = $scope->getType($functionCall->getArgs()[0]->value); if ($arrayType->isArray()->no()) { return $this->phpVersion->arrayFunctionsReturnNullWithNonArray() ? new NullType() : new NeverType(); } return $arrayType->flipArray(); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Arg; use PhpParser\Node\Expr\FuncCall; use PhpParser\Node\Name\FullyQualified; use PhpParser\Node\Scalar\String_; use PHPStan\Analyser\Scope; use PHPStan\Analyser\SpecifiedTypes; use PHPStan\Analyser\TypeSpecifier; use PHPStan\Analyser\TypeSpecifierAwareExtension; use PHPStan\Analyser\TypeSpecifierContext; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\CallableType; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\FunctionTypeSpecifyingExtension; use function ltrim; final class FunctionExistsFunctionTypeSpecifyingExtension implements FunctionTypeSpecifyingExtension, TypeSpecifierAwareExtension { /** * @var TypeSpecifier */ private $typeSpecifier; public function isFunctionSupported(FunctionReflection $functionReflection, FuncCall $node, TypeSpecifierContext $context) : bool { return $functionReflection->getName() === 'function_exists' && isset($node->getArgs()[0]) && $context->true(); } public function specifyTypes(FunctionReflection $functionReflection, FuncCall $node, Scope $scope, TypeSpecifierContext $context) : SpecifiedTypes { $argType = $scope->getType($node->getArgs()[0]->value); if ($argType instanceof ConstantStringType) { return $this->typeSpecifier->create(new FuncCall(new FullyQualified('function_exists'), [new Arg(new String_(ltrim($argType->getValue(), '\\')))]), new ConstantBooleanType(\true), $context, \false, $scope); } return $this->typeSpecifier->create($node->getArgs()[0]->value, new CallableType(), $context, \false, $scope); } public function setTypeSpecifier(TypeSpecifier $typeSpecifier) : void { $this->typeSpecifier = $typeSpecifier; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use DateTime; use DateTimeImmutable; use PhpParser\Node\Expr\MethodCall; use PHPStan\Analyser\Scope; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\MethodReflection; use PHPStan\Type\DynamicMethodThrowTypeExtension; use PHPStan\Type\NeverType; use PHPStan\Type\ObjectType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function count; use function in_array; final class DateTimeModifyMethodThrowTypeExtension implements DynamicMethodThrowTypeExtension { /** * @var PhpVersion */ private $phpVersion; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; } public function isMethodSupported(MethodReflection $methodReflection) : bool { return $methodReflection->getName() === 'modify' && in_array($methodReflection->getDeclaringClass()->getName(), [DateTime::class, DateTimeImmutable::class], \true); } public function getThrowTypeFromMethodCall(MethodReflection $methodReflection, MethodCall $methodCall, Scope $scope) : ?Type { if (count($methodCall->getArgs()) === 0) { return null; } if (!$this->phpVersion->hasDateTimeExceptions()) { return null; } $valueType = $scope->getType($methodCall->getArgs()[0]->value); $constantStrings = $valueType->getConstantStrings(); foreach ($constantStrings as $constantString) { try { $dateTime = new DateTime(); $dateTime->modify($constantString->getValue()); } catch (\Exception $e) { // phpcs:ignore return $this->exceptionType(); } $valueType = TypeCombinator::remove($valueType, $constantString); } if (!$valueType instanceof NeverType) { return $this->exceptionType(); } return null; } private function exceptionType() : Type { if ($this->phpVersion->hasDateTimeExceptions()) { return new ObjectType('DateMalformedStringException'); } return new ObjectType('Exception'); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\StaticCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\MethodReflection; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\DynamicStaticMethodThrowTypeExtension; use PHPStan\Type\Generic\GenericClassStringType; use PHPStan\Type\NeverType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\TypeUtils; use ReflectionMethod; use function count; final class ReflectionMethodConstructorThrowTypeExtension implements DynamicStaticMethodThrowTypeExtension { /** * @var ReflectionProvider */ private $reflectionProvider; public function __construct(ReflectionProvider $reflectionProvider) { $this->reflectionProvider = $reflectionProvider; } public function isStaticMethodSupported(MethodReflection $methodReflection) : bool { return $methodReflection->getName() === '__construct' && $methodReflection->getDeclaringClass()->getName() === ReflectionMethod::class; } public function getThrowTypeFromStaticMethodCall(MethodReflection $methodReflection, StaticCall $methodCall, Scope $scope) : ?Type { if (count($methodCall->getArgs()) < 2) { return $methodReflection->getThrowType(); } $valueType = $scope->getType($methodCall->getArgs()[0]->value); $propertyType = $scope->getType($methodCall->getArgs()[1]->value); foreach (TypeUtils::flattenTypes($valueType) as $type) { if ($type instanceof GenericClassStringType) { $classes = $type->getGenericType()->getObjectClassNames(); } elseif ($type instanceof ConstantStringType && $this->reflectionProvider->hasClass($type->getValue())) { $classes = [$type->getValue()]; } else { return $methodReflection->getThrowType(); } foreach ($classes as $class) { $classReflection = $this->reflectionProvider->getClass($class); foreach ($propertyType->getConstantStrings() as $constantPropertyString) { if (!$classReflection->hasMethod($constantPropertyString->getValue())) { return $methodReflection->getThrowType(); } } } $valueType = TypeCombinator::remove($valueType, $type); } if (!$valueType instanceof NeverType) { return $methodReflection->getThrowType(); } // Look for non constantStrings value. foreach ($propertyType->getConstantStrings() as $constantPropertyString) { $propertyType = TypeCombinator::remove($propertyType, $constantPropertyString); } if (!$propertyType instanceof NeverType) { return $methodReflection->getThrowType(); } return null; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Accessory\AccessoryNonEmptyStringType; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\IntersectionType; use PHPStan\Type\StringType; use PHPStan\Type\Type; use function count; final class StrTokFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'strtok'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { $args = $functionCall->getArgs(); if (count($args) !== 2) { return null; } $delimiterType = $scope->getType($functionCall->getArgs()[0]->value); $isEmptyString = (new ConstantStringType(''))->isSuperTypeOf($delimiterType); if ($isEmptyString->yes()) { return new ConstantBooleanType(\false); } if ($isEmptyString->no()) { return new IntersectionType([new StringType(), new AccessoryNonEmptyStringType()]); } return null; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Accessory\AccessoryLowercaseStringType; use PHPStan\Type\Accessory\AccessoryNonFalsyStringType; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\IntersectionType; use PHPStan\Type\NeverType; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\TypeUtils; use function array_map; use function count; use function hash_algos; use function in_array; use function is_bool; use function strtolower; final class HashFunctionsReturnTypeExtension implements DynamicFunctionReturnTypeExtension { /** * @var PhpVersion */ private $phpVersion; private const SUPPORTED_FUNCTIONS = ['hash' => ['cryptographic' => \false, 'possiblyFalse' => \false, 'binary' => 2], 'hash_file' => ['cryptographic' => \false, 'possiblyFalse' => \true, 'binary' => 2], 'hash_hkdf' => ['cryptographic' => \true, 'possiblyFalse' => \false, 'binary' => \true], 'hash_hmac' => ['cryptographic' => \true, 'possiblyFalse' => \false, 'binary' => 3], 'hash_hmac_file' => ['cryptographic' => \true, 'possiblyFalse' => \true, 'binary' => 3], 'hash_pbkdf2' => ['cryptographic' => \true, 'possiblyFalse' => \false, 'binary' => 5]]; private const NON_CRYPTOGRAPHIC_ALGORITHMS = ['adler32', 'crc32', 'crc32b', 'crc32c', 'fnv132', 'fnv1a32', 'fnv164', 'fnv1a64', 'joaat', 'murmur3a', 'murmur3c', 'murmur3f', 'xxh32', 'xxh64', 'xxh3', 'xxh128']; /** @var array<int, non-empty-string> */ private $hashAlgorithms; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; $this->hashAlgorithms = hash_algos(); } public function isFunctionSupported(FunctionReflection $functionReflection) : bool { $name = strtolower($functionReflection->getName()); return isset(self::SUPPORTED_FUNCTIONS[$name]); } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (!isset($functionCall->getArgs()[0])) { return null; } $functionData = self::SUPPORTED_FUNCTIONS[strtolower($functionReflection->getName())]; if (is_bool($functionData['binary'])) { $binaryType = new ConstantBooleanType($functionData['binary']); } elseif (isset($functionCall->getArgs()[$functionData['binary']])) { $binaryType = $scope->getType($functionCall->getArgs()[$functionData['binary']]->value); } else { $binaryType = new ConstantBooleanType(\false); } $stringTypes = [new StringType(), new AccessoryNonFalsyStringType()]; if ($binaryType->isFalse()->yes()) { $stringTypes[] = new AccessoryLowercaseStringType(); } $stringReturnType = new IntersectionType($stringTypes); $algorithmType = $scope->getType($functionCall->getArgs()[0]->value); $constantAlgorithmTypes = $algorithmType->getConstantStrings(); if (count($constantAlgorithmTypes) === 0) { if ($functionData['possiblyFalse'] || !$this->phpVersion->throwsValueErrorForInternalFunctions()) { return TypeUtils::toBenevolentUnion(TypeCombinator::union($stringReturnType, new ConstantBooleanType(\false))); } return $stringReturnType; } $neverType = new NeverType(); $falseType = new ConstantBooleanType(\false); $invalidAlgorithmType = $this->phpVersion->throwsValueErrorForInternalFunctions() ? $neverType : $falseType; $returnTypes = array_map(function (ConstantStringType $type) use($functionData, $stringReturnType, $invalidAlgorithmType) { $algorithm = strtolower($type->getValue()); if (!in_array($algorithm, $this->hashAlgorithms, \true)) { return $invalidAlgorithmType; } if ($functionData['cryptographic'] && in_array($algorithm, self::NON_CRYPTOGRAPHIC_ALGORITHMS, \true)) { return $invalidAlgorithmType; } return $stringReturnType; }, $constantAlgorithmTypes); $returnType = TypeCombinator::union(...$returnTypes); if ($functionData['possiblyFalse'] && !$neverType->isSuperTypeOf($returnType)->yes()) { $returnType = TypeCombinator::union($returnType, $falseType); } return $returnType; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\ArrayType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\IntegerRangeType; use PHPStan\Type\IntegerType; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\UnionType; use function count; final class ArrayRandFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'array_rand'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { $argsCount = count($functionCall->getArgs()); if ($argsCount < 1) { return null; } $firstArgType = $scope->getType($functionCall->getArgs()[0]->value); $isInteger = $firstArgType->getIterableKeyType()->isInteger(); $isString = $firstArgType->getIterableKeyType()->isString(); if ($isInteger->yes()) { $valueType = new IntegerType(); } elseif ($isString->yes()) { $valueType = new StringType(); } else { $valueType = new UnionType([new IntegerType(), new StringType()]); } if ($argsCount < 2) { return $valueType; } $secondArgType = $scope->getType($functionCall->getArgs()[1]->value); $one = new ConstantIntegerType(1); if ($one->isSuperTypeOf($secondArgType)->yes()) { return $valueType; } $bigger2 = IntegerRangeType::fromInterval(2, null); if ($bigger2->isSuperTypeOf($secondArgType)->yes()) { return new ArrayType(new IntegerType(), $valueType); } return TypeCombinator::union($valueType, new ArrayType(new IntegerType(), $valueType)); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use DateTime; use DateTimeImmutable; use PhpParser\Node\Expr\StaticCall; use PHPStan\Analyser\Scope; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\MethodReflection; use PHPStan\Type\DynamicStaticMethodThrowTypeExtension; use PHPStan\Type\NeverType; use PHPStan\Type\ObjectType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function count; use function in_array; final class DateTimeConstructorThrowTypeExtension implements DynamicStaticMethodThrowTypeExtension { /** * @var PhpVersion */ private $phpVersion; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; } public function isStaticMethodSupported(MethodReflection $methodReflection) : bool { return $methodReflection->getName() === '__construct' && in_array($methodReflection->getDeclaringClass()->getName(), [DateTime::class, DateTimeImmutable::class], \true); } public function getThrowTypeFromStaticMethodCall(MethodReflection $methodReflection, StaticCall $methodCall, Scope $scope) : ?Type { if (count($methodCall->getArgs()) === 0) { return null; } $valueType = $scope->getType($methodCall->getArgs()[0]->value); $constantStrings = $valueType->getConstantStrings(); foreach ($constantStrings as $constantString) { try { new DateTime($constantString->getValue()); } catch (\Exception $e) { // phpcs:ignore return $this->exceptionType(); } $valueType = TypeCombinator::remove($valueType, $constantString); } if (!$valueType instanceof NeverType) { return $this->exceptionType(); } return null; } private function exceptionType() : Type { if ($this->phpVersion->hasDateTimeExceptions()) { return new ObjectType('DateMalformedStringException'); } return new ObjectType('Exception'); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Arg; use PhpParser\Node\Expr; use PhpParser\Node\Expr\ArrowFunction; use PhpParser\Node\Expr\Closure; use PhpParser\Node\Expr\Error; use PhpParser\Node\Expr\FuncCall; use PhpParser\Node\Expr\MethodCall; use PhpParser\Node\Expr\StaticCall; use PhpParser\Node\Expr\Variable; use PhpParser\Node\Name; use PhpParser\Node\Stmt\Return_; use PHPStan\Analyser\MutatingScope; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ReflectionProvider; use PHPStan\ShouldNotHappenException; use PHPStan\Type\ArrayType; use PHPStan\Type\BenevolentUnionType; use PHPStan\Type\Constant\ConstantArrayType; use PHPStan\Type\Constant\ConstantArrayTypeBuilder; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\ErrorType; use PHPStan\Type\MixedType; use PHPStan\Type\NeverType; use PHPStan\Type\NullType; use PHPStan\Type\StaticTypeFactory; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\TypeUtils; use function array_map; use function count; use function in_array; use function is_string; use function sprintf; use function substr; final class ArrayFilterFunctionReturnTypeHelper { /** * @var ReflectionProvider */ private $reflectionProvider; private const USE_BOTH = 1; private const USE_KEY = 2; private const USE_ITEM = 3; public function __construct(ReflectionProvider $reflectionProvider) { $this->reflectionProvider = $reflectionProvider; } public function getType(Scope $scope, ?Expr $arrayArg, ?Expr $callbackArg, ?Expr $flagArg) : Type { if ($arrayArg === null) { return new ArrayType(new MixedType(), new MixedType()); } $arrayArgType = $scope->getType($arrayArg); $arrayArgType = TypeUtils::toBenevolentUnion($arrayArgType); $keyType = $arrayArgType->getIterableKeyType(); $itemType = $arrayArgType->getIterableValueType(); if ($itemType instanceof NeverType || $keyType instanceof NeverType) { return new ConstantArrayType([], []); } if ($arrayArgType instanceof MixedType) { return new BenevolentUnionType([new ArrayType(new MixedType(), new MixedType()), new NullType()]); } if ($callbackArg === null || $scope->getType($callbackArg)->isNull()->yes()) { return TypeCombinator::union(...array_map([$this, 'removeFalsey'], $arrayArgType->getArrays())); } $mode = $this->determineMode($flagArg, $scope); if ($mode === null) { return new ArrayType($keyType, $itemType); } if ($callbackArg instanceof Closure && count($callbackArg->stmts) === 1 && count($callbackArg->params) > 0) { $statement = $callbackArg->stmts[0]; if ($statement instanceof Return_ && $statement->expr !== null) { if ($mode === self::USE_ITEM) { $keyVar = null; $itemVar = $callbackArg->params[0]->var; } elseif ($mode === self::USE_KEY) { $keyVar = $callbackArg->params[0]->var; $itemVar = null; } elseif ($mode === self::USE_BOTH) { $keyVar = $callbackArg->params[1]->var ?? null; $itemVar = $callbackArg->params[0]->var; } return $this->filterByTruthyValue($scope, $itemVar, $arrayArgType, $keyVar, $statement->expr); } } elseif ($callbackArg instanceof ArrowFunction && count($callbackArg->params) > 0) { if ($mode === self::USE_ITEM) { $keyVar = null; $itemVar = $callbackArg->params[0]->var; } elseif ($mode === self::USE_KEY) { $keyVar = $callbackArg->params[0]->var; $itemVar = null; } elseif ($mode === self::USE_BOTH) { $keyVar = $callbackArg->params[1]->var ?? null; $itemVar = $callbackArg->params[0]->var; } return $this->filterByTruthyValue($scope, $itemVar, $arrayArgType, $keyVar, $callbackArg->expr); } elseif (($callbackArg instanceof FuncCall || $callbackArg instanceof MethodCall || $callbackArg instanceof StaticCall) && $callbackArg->isFirstClassCallable()) { [$args, $itemVar, $keyVar] = $this->createDummyArgs($mode); $expr = clone $callbackArg; $expr->args = $args; return $this->filterByTruthyValue($scope, $itemVar, $arrayArgType, $keyVar, $expr); } else { $constantStrings = $scope->getType($callbackArg)->getConstantStrings(); if (count($constantStrings) > 0) { $results = []; [$args, $itemVar, $keyVar] = $this->createDummyArgs($mode); foreach ($constantStrings as $constantString) { $funcName = self::createFunctionName($constantString->getValue()); if ($funcName === null) { $results[] = new ErrorType(); continue; } $expr = new FuncCall($funcName, $args); $results[] = $this->filterByTruthyValue($scope, $itemVar, $arrayArgType, $keyVar, $expr); } return TypeCombinator::union(...$results); } } return new ArrayType($keyType, $itemType); } private function removeFalsey(Type $type) : Type { $falseyTypes = StaticTypeFactory::falsey(); if (count($type->getConstantArrays()) > 0) { $result = []; foreach ($type->getConstantArrays() as $constantArray) { $keys = $constantArray->getKeyTypes(); $values = $constantArray->getValueTypes(); $builder = ConstantArrayTypeBuilder::createEmpty(); foreach ($values as $offset => $value) { $isFalsey = $falseyTypes->isSuperTypeOf($value); if ($isFalsey->maybe()) { $builder->setOffsetValueType($keys[$offset], TypeCombinator::remove($value, $falseyTypes), \true); } elseif ($isFalsey->no()) { $builder->setOffsetValueType($keys[$offset], $value, $constantArray->isOptionalKey($offset)); } } $result[] = $builder->getArray(); } return TypeCombinator::union(...$result); } $keyType = $type->getIterableKeyType(); $valueType = $type->getIterableValueType(); $valueType = TypeCombinator::remove($valueType, $falseyTypes); if ($valueType instanceof NeverType) { return new ConstantArrayType([], []); } return new ArrayType($keyType, $valueType); } /** * @param Error|Variable|null $itemVar * @param Error|Variable|null $keyVar */ private function filterByTruthyValue(Scope $scope, $itemVar, Type $arrayType, $keyVar, Expr $expr) : Type { if (!$scope instanceof MutatingScope) { throw new ShouldNotHappenException(); } $constantArrays = $arrayType->getConstantArrays(); if (count($constantArrays) > 0) { $results = []; foreach ($constantArrays as $constantArray) { $builder = ConstantArrayTypeBuilder::createEmpty(); $optionalKeys = $constantArray->getOptionalKeys(); foreach ($constantArray->getKeyTypes() as $i => $keyType) { $itemType = $constantArray->getValueTypes()[$i]; [$newKeyType, $newItemType, $optional] = $this->processKeyAndItemType($scope, $keyType, $itemType, $itemVar, $keyVar, $expr); $optional = $optional || in_array($i, $optionalKeys, \true); if ($newKeyType instanceof NeverType || $newItemType instanceof NeverType) { continue; } if ($itemType->equals($newItemType) && $keyType->equals($newKeyType)) { $builder->setOffsetValueType($keyType, $itemType, $optional); continue; } $builder->setOffsetValueType($newKeyType, $newItemType, \true); } $results[] = $builder->getArray(); } return TypeCombinator::union(...$results); } [$newKeyType, $newItemType] = $this->processKeyAndItemType($scope, $arrayType->getIterableKeyType(), $arrayType->getIterableValueType(), $itemVar, $keyVar, $expr); if ($newItemType instanceof NeverType || $newKeyType instanceof NeverType) { return new ConstantArrayType([], []); } return new ArrayType($newKeyType, $newItemType); } /** * @return array{Type, Type, bool} * @param Error|Variable|null $itemVar * @param Error|Variable|null $keyVar */ private function processKeyAndItemType(MutatingScope $scope, Type $keyType, Type $itemType, $itemVar, $keyVar, Expr $expr) : array { $itemVarName = null; if ($itemVar !== null) { if (!$itemVar instanceof Variable || !is_string($itemVar->name)) { throw new ShouldNotHappenException(); } $itemVarName = $itemVar->name; $scope = $scope->assignVariable($itemVarName, $itemType, new MixedType()); } $keyVarName = null; if ($keyVar !== null) { if (!$keyVar instanceof Variable || !is_string($keyVar->name)) { throw new ShouldNotHappenException(); } $keyVarName = $keyVar->name; $scope = $scope->assignVariable($keyVarName, $keyType, new MixedType()); } $booleanResult = $scope->getType($expr)->toBoolean(); if ($booleanResult->isFalse()->yes()) { return [new NeverType(), new NeverType(), \false]; } $scope = $scope->filterByTruthyValue($expr); return [$keyVarName !== null ? $scope->getVariableType($keyVarName) : $keyType, $itemVarName !== null ? $scope->getVariableType($itemVarName) : $itemType, !$booleanResult->isTrue()->yes()]; } private static function createFunctionName(string $funcName) : ?Name { if ($funcName === '') { return null; } if ($funcName[0] === '\\') { $funcName = substr($funcName, 1); if ($funcName === '') { return null; } return new Name\FullyQualified($funcName); } return new Name($funcName); } /** * @param self::USE_* $mode * @return array{list<Arg>, ?Variable, ?Variable} */ private function createDummyArgs(int $mode) : array { if ($mode === self::USE_ITEM) { $itemVar = new Variable('item'); $keyVar = null; $args = [new Arg($itemVar)]; } elseif ($mode === self::USE_KEY) { $itemVar = null; $keyVar = new Variable('key'); $args = [new Arg($keyVar)]; } elseif ($mode === self::USE_BOTH) { $itemVar = new Variable('item'); $keyVar = new Variable('key'); $args = [new Arg($itemVar), new Arg($keyVar)]; } return [$args, $itemVar, $keyVar]; } /** * @param non-empty-string $constantName */ private function getConstant(string $constantName) : int { $constant = $this->reflectionProvider->getConstant(new Name($constantName), null); $valueType = $constant->getValueType(); if (!$valueType instanceof ConstantIntegerType) { throw new ShouldNotHappenException(sprintf('Constant %s does not have integer type.', $constantName)); } return $valueType->getValue(); } /** * @return self::USE_*|null */ private function determineMode(?Expr $flagArg, Scope $scope) : ?int { if ($flagArg === null) { return self::USE_ITEM; } $flagValues = $scope->getType($flagArg)->getConstantScalarValues(); if (count($flagValues) !== 1) { return null; } if ($flagValues[0] === $this->getConstant('ARRAY_FILTER_USE_KEY')) { return self::USE_KEY; } elseif ($flagValues[0] === $this->getConstant('ARRAY_FILTER_USE_BOTH')) { return self::USE_BOTH; } return null; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use DateTime; use DateTimeImmutable; use PhpParser\Node\Expr\MethodCall; use PHPStan\Analyser\Scope; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\MethodReflection; use PHPStan\Type\DynamicMethodThrowTypeExtension; use PHPStan\Type\ObjectType; use PHPStan\Type\Type; use function count; use function in_array; final class DateTimeSubMethodThrowTypeExtension implements DynamicMethodThrowTypeExtension { /** * @var PhpVersion */ private $phpVersion; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; } public function isMethodSupported(MethodReflection $methodReflection) : bool { return $methodReflection->getName() === 'sub' && in_array($methodReflection->getDeclaringClass()->getName(), [DateTime::class, DateTimeImmutable::class], \true); } public function getThrowTypeFromMethodCall(MethodReflection $methodReflection, MethodCall $methodCall, Scope $scope) : ?Type { if (count($methodCall->getArgs()) === 0) { return null; } if (!$this->phpVersion->hasDateTimeExceptions()) { return null; } return new ObjectType('DateInvalidOperationException'); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\ClassConstFetch; use PhpParser\Node\Expr\FuncCall; use PhpParser\Node\Name; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\Type; final class GetCalledClassDynamicReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'get_called_class'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : Type { if ($scope->isInClass()) { return $scope->getType(new ClassConstFetch(new Name('static'), 'class')); } return new ConstantBooleanType(\false); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\Type; use function count; final class DateFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { /** * @var DateFunctionReturnTypeHelper */ private $dateFunctionReturnTypeHelper; public function __construct(\PHPStan\Type\Php\DateFunctionReturnTypeHelper $dateFunctionReturnTypeHelper) { $this->dateFunctionReturnTypeHelper = $dateFunctionReturnTypeHelper; } public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'date'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (count($functionCall->getArgs()) === 0) { return null; } return $this->dateFunctionReturnTypeHelper->getTypeFromFormatType($scope->getType($functionCall->getArgs()[0]->value), \false); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\ReflectionProvider; use PHPStan\ShouldNotHappenException; use PHPStan\Type\Constant\ConstantArrayTypeBuilder; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function count; use function sprintf; final class PathinfoFunctionDynamicReturnTypeExtension implements DynamicFunctionReturnTypeExtension { /** * @var ReflectionProvider */ private $reflectionProvider; public function __construct(ReflectionProvider $reflectionProvider) { $this->reflectionProvider = $reflectionProvider; } public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'pathinfo'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, Node\Expr\FuncCall $functionCall, Scope $scope) : ?Type { $argsCount = count($functionCall->getArgs()); if ($argsCount === 0) { return null; } $pathType = $scope->getType($functionCall->getArgs()[0]->value); $builder = ConstantArrayTypeBuilder::createEmpty(); $builder->setOffsetValueType(new ConstantStringType('dirname'), new StringType(), !$pathType->isNonEmptyString()->yes()); $builder->setOffsetValueType(new ConstantStringType('basename'), new StringType()); $builder->setOffsetValueType(new ConstantStringType('extension'), new StringType(), \true); $builder->setOffsetValueType(new ConstantStringType('filename'), new StringType()); $arrayType = $builder->getArray(); if ($argsCount === 1) { return $arrayType; } $flagsType = $scope->getType($functionCall->getArgs()[1]->value); $scalarValues = $flagsType->getConstantScalarValues(); if ($scalarValues !== []) { $pathInfoAll = $this->getConstant('PATHINFO_ALL'); if ($pathInfoAll === null) { return null; } $result = []; foreach ($scalarValues as $scalarValue) { if ($scalarValue === $pathInfoAll) { $result[] = $arrayType; } else { $result[] = new StringType(); } } return TypeCombinator::union(...$result); } return TypeCombinator::union($arrayType, new StringType()); } /** * @param non-empty-string $constantName */ private function getConstant(string $constantName) : ?int { if (!$this->reflectionProvider->hasConstant(new Node\Name($constantName), null)) { return null; } $constant = $this->reflectionProvider->getConstant(new Node\Name($constantName), null); $valueType = $constant->getValueType(); if (!$valueType instanceof ConstantIntegerType) { throw new ShouldNotHappenException(sprintf('Constant %s does not have integer type.', $constantName)); } return $valueType->getValue(); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PhpParser\Node\Expr\PropertyFetch; use PhpParser\Node\Identifier; use PHPStan\Analyser\Scope; use PHPStan\Analyser\SpecifiedTypes; use PHPStan\Analyser\TypeSpecifier; use PHPStan\Analyser\TypeSpecifierAwareExtension; use PHPStan\Analyser\TypeSpecifierContext; use PHPStan\Reflection\FunctionReflection; use PHPStan\Rules\Properties\PropertyReflectionFinder; use PHPStan\Type\Accessory\HasPropertyType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\FunctionTypeSpecifyingExtension; use PHPStan\Type\IntersectionType; use PHPStan\Type\ObjectWithoutClassType; use function count; final class PropertyExistsTypeSpecifyingExtension implements FunctionTypeSpecifyingExtension, TypeSpecifierAwareExtension { /** * @var PropertyReflectionFinder */ private $propertyReflectionFinder; /** * @var TypeSpecifier */ private $typeSpecifier; public function __construct(PropertyReflectionFinder $propertyReflectionFinder) { $this->propertyReflectionFinder = $propertyReflectionFinder; } public function setTypeSpecifier(TypeSpecifier $typeSpecifier) : void { $this->typeSpecifier = $typeSpecifier; } public function isFunctionSupported(FunctionReflection $functionReflection, FuncCall $node, TypeSpecifierContext $context) : bool { return $functionReflection->getName() === 'property_exists' && $context->true() && count($node->getArgs()) >= 2; } public function specifyTypes(FunctionReflection $functionReflection, FuncCall $node, Scope $scope, TypeSpecifierContext $context) : SpecifiedTypes { $propertyNameType = $scope->getType($node->getArgs()[1]->value); if (!$propertyNameType instanceof ConstantStringType) { return new SpecifiedTypes([], []); } $objectType = $scope->getType($node->getArgs()[0]->value); if ($objectType instanceof ConstantStringType) { return new SpecifiedTypes([], []); } elseif ($objectType->isObject()->yes()) { $propertyNode = new PropertyFetch($node->getArgs()[0]->value, new Identifier($propertyNameType->getValue())); } else { return new SpecifiedTypes([], []); } $propertyReflection = $this->propertyReflectionFinder->findPropertyReflectionFromNode($propertyNode, $scope); if ($propertyReflection !== null) { if (!$propertyReflection->isNative()) { return new SpecifiedTypes([], []); } } return $this->typeSpecifier->create($node->getArgs()[0]->value, new IntersectionType([new ObjectWithoutClassType(), new HasPropertyType($propertyNameType->getValue())]), $context, \false, $scope); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\NeverType; use PHPStan\Type\Type; use function count; use function in_array; use const E_USER_DEPRECATED; use const E_USER_ERROR; use const E_USER_NOTICE; use const E_USER_WARNING; final class TriggerErrorDynamicReturnTypeExtension implements DynamicFunctionReturnTypeExtension { /** * @var PhpVersion */ private $phpVersion; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; } public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'trigger_error'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { $args = $functionCall->getArgs(); if (count($args) === 0) { return null; } if (count($args) === 1) { return new ConstantBooleanType(\true); } $errorType = $scope->getType($args[1]->value); if ($errorType instanceof ConstantIntegerType) { $errorLevel = $errorType->getValue(); if ($errorLevel === E_USER_ERROR) { return new NeverType(\true); } if (!in_array($errorLevel, [E_USER_WARNING, E_USER_NOTICE, E_USER_DEPRECATED], \true)) { if ($this->phpVersion->throwsValueErrorForInternalFunctions()) { return new NeverType(\true); } return new ConstantBooleanType(\false); } return new ConstantBooleanType(\true); } return null; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\Native\NativeParameterReflection; use PHPStan\Reflection\ParameterReflection; use PHPStan\TrinaryLogic; use PHPStan\Type\ClosureType; use PHPStan\Type\FunctionParameterClosureTypeExtension; use PHPStan\Type\StringType; use PHPStan\Type\Type; final class PregReplaceCallbackClosureTypeExtension implements FunctionParameterClosureTypeExtension { /** * @var RegexArrayShapeMatcher */ private $regexShapeMatcher; public function __construct(\PHPStan\Type\Php\RegexArrayShapeMatcher $regexShapeMatcher) { $this->regexShapeMatcher = $regexShapeMatcher; } public function isFunctionSupported(FunctionReflection $functionReflection, ParameterReflection $parameter) : bool { return $functionReflection->getName() === 'preg_replace_callback' && $parameter->getName() === 'callback'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, ParameterReflection $parameter, Scope $scope) : ?Type { $args = $functionCall->getArgs(); $patternArg = $args[0] ?? null; $flagsArg = $args[5] ?? null; if ($patternArg === null) { return null; } $flagsType = null; if ($flagsArg !== null) { $flagsType = $scope->getType($flagsArg->value); } $matchesType = $this->regexShapeMatcher->matchExpr($patternArg->value, $flagsType, TrinaryLogic::createYes(), $scope); if ($matchesType === null) { return null; } return new ClosureType([new NativeParameterReflection($parameter->getName(), $parameter->isOptional(), $matchesType, $parameter->passedByReference(), $parameter->isVariadic(), $parameter->getDefaultValue())], new StringType()); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Analyser\SpecifiedTypes; use PHPStan\Analyser\TypeSpecifier; use PHPStan\Analyser\TypeSpecifierAwareExtension; use PHPStan\Analyser\TypeSpecifierContext; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\FunctionTypeSpecifyingExtension; use PHPStan\Type\Generic\GenericClassStringType; use function count; use function strtolower; final class IsSubclassOfFunctionTypeSpecifyingExtension implements FunctionTypeSpecifyingExtension, TypeSpecifierAwareExtension { /** * @var IsAFunctionTypeSpecifyingHelper */ private $isAFunctionTypeSpecifyingHelper; /** * @var TypeSpecifier */ private $typeSpecifier; public function __construct(\PHPStan\Type\Php\IsAFunctionTypeSpecifyingHelper $isAFunctionTypeSpecifyingHelper) { $this->isAFunctionTypeSpecifyingHelper = $isAFunctionTypeSpecifyingHelper; } public function isFunctionSupported(FunctionReflection $functionReflection, FuncCall $node, TypeSpecifierContext $context) : bool { return strtolower($functionReflection->getName()) === 'is_subclass_of' && !$context->null(); } public function specifyTypes(FunctionReflection $functionReflection, FuncCall $node, Scope $scope, TypeSpecifierContext $context) : SpecifiedTypes { if (!$context->true() || count($node->getArgs()) < 2) { return new SpecifiedTypes(); } $objectOrClassType = $scope->getType($node->getArgs()[0]->value); $classType = $scope->getType($node->getArgs()[1]->value); $allowStringType = isset($node->getArgs()[2]) ? $scope->getType($node->getArgs()[2]->value) : new ConstantBooleanType(\true); $allowString = !$allowStringType->equals(new ConstantBooleanType(\false)); // prevent false-positives in IsAFunctionTypeSpecifyingHelper if ($objectOrClassType instanceof GenericClassStringType && $classType instanceof GenericClassStringType) { return new SpecifiedTypes([], []); } return $this->typeSpecifier->create($node->getArgs()[0]->value, $this->isAFunctionTypeSpecifyingHelper->determineType($objectOrClassType, $classType, $allowString, \false), $context, \false, $scope); } public function setTypeSpecifier(TypeSpecifier $typeSpecifier) : void { $this->typeSpecifier = $typeSpecifier; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\IntersectionType; use PHPStan\Type\ResourceType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\TypeTraverser; use PHPStan\Type\UnionType; use function count; final class GettypeFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'gettype'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (count($functionCall->getArgs()) < 1) { return null; } $valueType = $scope->getType($functionCall->getArgs()[0]->value); return TypeTraverser::map($valueType, static function (Type $valueType, callable $traverse) : Type { if ($valueType instanceof UnionType || $valueType instanceof IntersectionType) { return $traverse($valueType); } if ($valueType->isString()->yes()) { return new ConstantStringType('string'); } if ($valueType->isArray()->yes()) { return new ConstantStringType('array'); } if ($valueType->isBoolean()->yes()) { return new ConstantStringType('boolean'); } $resource = new ResourceType(); if ($resource->isSuperTypeOf($valueType)->yes()) { return new UnionType([new ConstantStringType('resource'), new ConstantStringType('resource (closed)')]); } if ($valueType->isInteger()->yes()) { return new ConstantStringType('integer'); } if ($valueType->isFloat()->yes()) { // for historical reasons "double" is returned in case of a float, and not simply "float" return new ConstantStringType('double'); } if ($valueType->isNull()->yes()) { return new ConstantStringType('NULL'); } if ($valueType->isObject()->yes()) { return new ConstantStringType('object'); } return TypeCombinator::union(new ConstantStringType('string'), new ConstantStringType('array'), new ConstantStringType('boolean'), new ConstantStringType('resource'), new ConstantStringType('resource (closed)'), new ConstantStringType('integer'), new ConstantStringType('double'), new ConstantStringType('NULL'), new ConstantStringType('object'), new ConstantStringType('unknown type')); }); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\MethodCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\MethodReflection; use PHPStan\Type\DynamicMethodThrowTypeExtension; use PHPStan\Type\Type; use PHPStan\Type\VoidType; use function count; final class DsMapDynamicMethodThrowTypeExtension implements DynamicMethodThrowTypeExtension { public function isMethodSupported(MethodReflection $methodReflection) : bool { return $methodReflection->getDeclaringClass()->getName() === 'Ds\\Map' && ($methodReflection->getName() === 'get' || $methodReflection->getName() === 'remove'); } public function getThrowTypeFromMethodCall(MethodReflection $methodReflection, MethodCall $methodCall, Scope $scope) : ?Type { if (count($methodCall->args) < 2) { return $methodReflection->getThrowType(); } return new VoidType(); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Accessory\AccessoryArrayListType; use PHPStan\Type\Accessory\AccessoryLowercaseStringType; use PHPStan\Type\Accessory\AccessoryNonEmptyStringType; use PHPStan\Type\Accessory\AccessoryNonFalsyStringType; use PHPStan\Type\Accessory\AccessoryNumericStringType; use PHPStan\Type\Accessory\AccessoryUppercaseStringType; use PHPStan\Type\Accessory\NonEmptyArrayType; use PHPStan\Type\ArrayType; use PHPStan\Type\Constant\ConstantArrayTypeBuilder; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\TypeTraverser; use PHPStan\Type\TypeUtils; use PHPStan\Type\UnionType; use function array_map; use function count; use function strtolower; use function strtoupper; use const CASE_LOWER; use const CASE_UPPER; final class ArrayChangeKeyCaseFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'array_change_key_case'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (!isset($functionCall->getArgs()[0])) { return null; } $arrayType = $scope->getType($functionCall->getArgs()[0]->value); if (!isset($functionCall->getArgs()[1])) { $case = CASE_LOWER; } else { $caseType = $scope->getType($functionCall->getArgs()[1]->value); $scalarValues = $caseType->getConstantScalarValues(); if (count($scalarValues) === 1) { $case = (int) $scalarValues[0]; } else { $case = null; } } $constantArrays = $arrayType->getConstantArrays(); if (count($constantArrays) > 0) { $arrayTypes = []; foreach ($constantArrays as $constantArray) { $newConstantArrayBuilder = ConstantArrayTypeBuilder::createEmpty(); $valueTypes = $constantArray->getValueTypes(); foreach ($constantArray->getKeyTypes() as $i => $keyType) { $valueType = $valueTypes[$i]; $constantStrings = $keyType->getConstantStrings(); if (count($constantStrings) > 0) { $keyType = TypeCombinator::union(...array_map(function (ConstantStringType $type) use($case) : Type { return $this->mapConstantString($type, $case); }, $constantStrings)); } $newConstantArrayBuilder->setOffsetValueType($keyType, $valueType, $constantArray->isOptionalKey($i)); } $newConstantArrayType = $newConstantArrayBuilder->getArray(); if ($constantArray->isList()->yes()) { $newConstantArrayType = AccessoryArrayListType::intersectWith($newConstantArrayType); } $arrayTypes[] = $newConstantArrayType; } $newArrayType = TypeCombinator::union(...$arrayTypes); } else { $keysType = $arrayType->getIterableKeyType(); $keysType = TypeTraverser::map($keysType, function (Type $type, callable $traverse) use($case) : Type { if ($type instanceof UnionType) { return $traverse($type); } $constantStrings = $type->getConstantStrings(); if (count($constantStrings) > 0) { return TypeCombinator::union(...array_map(function (ConstantStringType $type) use($case) : Type { return $this->mapConstantString($type, $case); }, $constantStrings)); } if ($type->isString()->yes()) { $types = [new StringType()]; if ($type->isNonFalsyString()->yes()) { $types[] = new AccessoryNonFalsyStringType(); } elseif ($type->isNonEmptyString()->yes()) { $types[] = new AccessoryNonEmptyStringType(); } if ($type->isNumericString()->yes()) { $types[] = new AccessoryNumericStringType(); } if ($case === CASE_LOWER) { $types[] = new AccessoryLowercaseStringType(); } elseif ($case === CASE_UPPER) { $types[] = new AccessoryUppercaseStringType(); } return TypeCombinator::intersect(...$types); } return $type; }); $newArrayType = TypeCombinator::intersect(new ArrayType($keysType, $arrayType->getIterableValueType()), ...TypeUtils::getAccessoryTypes($arrayType)); } if ($arrayType->isIterableAtLeastOnce()->yes()) { $newArrayType = TypeCombinator::intersect($newArrayType, new NonEmptyArrayType()); } return $newArrayType; } private function mapConstantString(ConstantStringType $type, ?int $case) : Type { if ($case === CASE_LOWER) { return new ConstantStringType(strtolower($type->getValue())); } elseif ($case === CASE_UPPER) { return new ConstantStringType(strtoupper($type->getValue())); } return TypeCombinator::union(new ConstantStringType(strtolower($type->getValue())), new ConstantStringType(strtoupper($type->getValue()))); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use Closure; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\UnionType; use function array_key_first; use function array_map; use function count; final class GetDebugTypeFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'get_debug_type'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (count($functionCall->getArgs()) < 1) { return null; } $argType = $scope->getType($functionCall->getArgs()[0]->value); if ($argType instanceof UnionType) { return new UnionType(array_map(Closure::fromCallable([self::class, 'resolveOneType']), $argType->getTypes())); } return self::resolveOneType($argType); } /** * @see https://www.php.net/manual/en/function.get-debug-type.php#refsect1-function.get-debug-type-returnvalues * @see https://github.com/php/php-src/commit/ef0e4478c51540510b67f7781ad240f5e0592ee4 */ private static function resolveOneType(Type $type) : Type { if ($type->isNull()->yes()) { return new ConstantStringType('null'); } if ($type->isBoolean()->yes()) { return new ConstantStringType('bool'); } if ($type->isInteger()->yes()) { return new ConstantStringType('int'); } if ($type->isFloat()->yes()) { return new ConstantStringType('float'); } if ($type->isString()->yes()) { return new ConstantStringType('string'); } if ($type->isArray()->yes()) { return new ConstantStringType('array'); } // "resources" type+state is skipped since we cannot infer the state if ($type->isObject()->yes()) { $reflections = $type->getObjectClassReflections(); $types = []; foreach ($reflections as $reflection) { // if the class is not final, the actual returned string might be of a child class if ($reflection->isFinal() && !$reflection->isAnonymous()) { $types[] = new ConstantStringType($reflection->getName()); } if ($reflection->isAnonymous()) { // phpcs:ignore $parentClass = $reflection->getParentClass(); $implementedInterfaces = $reflection->getImmediateInterfaces(); if ($parentClass !== null) { $types[] = new ConstantStringType($parentClass->getName() . '@anonymous'); } elseif ($implementedInterfaces !== []) { $firstInterface = $implementedInterfaces[array_key_first($implementedInterfaces)]; $types[] = new ConstantStringType($firstInterface->getName() . '@anonymous'); } else { $types[] = new ConstantStringType('class@anonymous'); } } } switch (count($types)) { case 0: return new StringType(); case 1: return $types[0]; default: return new UnionType($types); } } return new StringType(); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Arg; use PhpParser\Node\Expr\Array_; use PhpParser\Node\Expr\FuncCall; use PhpParser\Node\Name; use PHPStan\Analyser\Scope; use PHPStan\Analyser\SpecifiedTypes; use PHPStan\Analyser\TypeSpecifier; use PHPStan\Analyser\TypeSpecifierAwareExtension; use PHPStan\Analyser\TypeSpecifierContext; use PHPStan\Reflection\FunctionReflection; use PHPStan\ShouldNotHappenException; use PHPStan\Type\CallableType; use PHPStan\Type\FunctionTypeSpecifyingExtension; use function count; use function strtolower; final class IsCallableFunctionTypeSpecifyingExtension implements FunctionTypeSpecifyingExtension, TypeSpecifierAwareExtension { /** * @var MethodExistsTypeSpecifyingExtension */ private $methodExistsExtension; /** * @var TypeSpecifier */ private $typeSpecifier; public function __construct(\PHPStan\Type\Php\MethodExistsTypeSpecifyingExtension $methodExistsExtension) { $this->methodExistsExtension = $methodExistsExtension; } public function isFunctionSupported(FunctionReflection $functionReflection, FuncCall $node, TypeSpecifierContext $context) : bool { return strtolower($functionReflection->getName()) === 'is_callable' && !$context->null(); } public function specifyTypes(FunctionReflection $functionReflection, FuncCall $node, Scope $scope, TypeSpecifierContext $context) : SpecifiedTypes { if ($context->null()) { throw new ShouldNotHappenException(); } if (!isset($node->getArgs()[0])) { return new SpecifiedTypes(); } $value = $node->getArgs()[0]->value; $valueType = $scope->getType($value); if ($value instanceof Array_ && count($value->items) === 2 && $valueType->isConstantArray()->yes() && !$valueType->isCallable()->no()) { if ($value->items[0] === null || $value->items[1] === null) { throw new ShouldNotHappenException(); } $functionCall = new FuncCall(new Name('method_exists'), [new Arg($value->items[0]->value), new Arg($value->items[1]->value)]); return $this->methodExistsExtension->specifyTypes($functionReflection, $functionCall, $scope, $context); } return $this->typeSpecifier->create($value, new CallableType(), $context, \false, $scope); } public function setTypeSpecifier(TypeSpecifier $typeSpecifier) : void { $this->typeSpecifier = $typeSpecifier; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Accessory\AccessoryNumericStringType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function array_key_exists; use function count; final class IniGetReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'ini_get'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { $args = $functionCall->getArgs(); if (count($args) < 1) { return null; } $numericString = TypeCombinator::intersect(new StringType(), new AccessoryNumericStringType()); $types = ['date.timezone' => new StringType(), 'memory_limit' => new StringType(), 'max_execution_time' => $numericString, 'max_input_time' => $numericString, 'default_socket_timeout' => $numericString, 'precision' => $numericString]; $argType = $scope->getType($args[0]->value); $results = []; foreach ($argType->getConstantStrings() as $constantString) { if (!array_key_exists($constantString->getValue(), $types)) { return null; } $results[] = $types[$constantString->getValue()]; } if (count($results) > 0) { return TypeCombinator::union(...$results); } return null; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Analyser\SpecifiedTypes; use PHPStan\Analyser\TypeSpecifier; use PHPStan\Analyser\TypeSpecifierAwareExtension; use PHPStan\Analyser\TypeSpecifierContext; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Accessory\NonEmptyArrayType; use PHPStan\Type\ArrayType; use PHPStan\Type\FunctionTypeSpecifyingExtension; use PHPStan\Type\MixedType; use PHPStan\Type\TypeCombinator; use function strtolower; final class ArraySearchFunctionTypeSpecifyingExtension implements FunctionTypeSpecifyingExtension, TypeSpecifierAwareExtension { /** * @var TypeSpecifier */ private $typeSpecifier; public function isFunctionSupported(FunctionReflection $functionReflection, FuncCall $node, TypeSpecifierContext $context) : bool { return strtolower($functionReflection->getName()) === 'array_search' && $context->true(); } public function specifyTypes(FunctionReflection $functionReflection, FuncCall $node, Scope $scope, TypeSpecifierContext $context) : SpecifiedTypes { $arrayArg = $node->getArgs()[1]->value ?? null; if ($arrayArg === null) { return new SpecifiedTypes(); } return $this->typeSpecifier->create($arrayArg, TypeCombinator::intersect(new ArrayType(new MixedType(), new MixedType()), new NonEmptyArrayType()), $context, \false, $scope); } public function setTypeSpecifier(TypeSpecifier $typeSpecifier) : void { $this->typeSpecifier = $typeSpecifier; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Arg; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Internal\CombinationsHelper; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\InitializerExprTypeResolver; use PHPStan\Type\Accessory\AccessoryLowercaseStringType; use PHPStan\Type\Accessory\AccessoryNonEmptyStringType; use PHPStan\Type\Accessory\AccessoryNonFalsyStringType; use PHPStan\Type\Accessory\AccessoryNumericStringType; use PHPStan\Type\Accessory\AccessoryType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\IntegerRangeType; use PHPStan\Type\IntersectionType; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use Throwable; use function array_fill; use function array_key_exists; use function array_shift; use function array_values; use function count; use function in_array; use function intval; use function is_array; use function is_string; use function preg_match; use function sprintf; use function substr; use function vsprintf; final class SprintfFunctionDynamicReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return in_array($functionReflection->getName(), ['sprintf', 'vsprintf'], \true); } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { $args = $functionCall->getArgs(); if (count($args) === 0) { return null; } $constantType = $this->getConstantType($args, $functionReflection, $scope); if ($constantType !== null) { return $constantType; } $formatType = $scope->getType($args[0]->value); $formatStrings = $formatType->getConstantStrings(); $isLowercase = $formatType->isLowercaseString()->yes() && $this->allValuesSatisfies($functionReflection, $scope, $args, static function (Type $type) : bool { return $type->toString()->isLowercaseString()->yes(); }); $singlePlaceholderEarlyReturn = []; $allPatternsNonEmpty = count($formatStrings) !== 0; $allPatternsNonFalsy = count($formatStrings) !== 0; foreach ($formatStrings as $constantString) { $constantParts = $this->getFormatConstantParts($constantString->getValue(), $functionReflection, $functionCall, $scope); if ($constantParts !== null) { if ($constantParts->isNonFalsyString()->yes()) { // phpcs:ignore Generic.CodeAnalysis.EmptyStatement.DetectedIf // keep all bool flags as is } elseif ($constantParts->isNonEmptyString()->yes()) { $allPatternsNonFalsy = \false; } else { $allPatternsNonEmpty = \false; $allPatternsNonFalsy = \false; } } else { $allPatternsNonEmpty = \false; $allPatternsNonFalsy = \false; } if (is_array($singlePlaceholderEarlyReturn) && preg_match('/^%(?P<argnum>[0-9]*\\$)?(?P<width>[0-9]*)\\.?[0-9]*(?P<specifier>[sbdeEfFgGhHouxX])$/', $constantString->getValue(), $matches) === 1) { if ($matches['argnum'] !== '') { // invalid positional argument if ($matches['argnum'] === '0$') { return null; } $checkArg = intval(substr($matches['argnum'], 0, -1)); } else { $checkArg = 1; } $checkArgType = $this->getValueType($functionReflection, $scope, $args, $checkArg); if ($checkArgType === null) { return null; } // if the format string is just a placeholder and specified an argument // of stringy type, then the return value will be of the same type if ($matches['specifier'] === 's' && ($checkArgType->isString()->yes() || $checkArgType->isInteger()->yes())) { if ($checkArgType instanceof IntegerRangeType) { $constArgTypes = $checkArgType->getFiniteTypes(); } else { $constArgTypes = $checkArgType->getConstantScalarTypes(); } if ($constArgTypes !== []) { $printfArgs = array_fill(0, count($args) - 1, ''); foreach ($constArgTypes as $constArgType) { $printfArgs[$checkArg - 1] = $constArgType->getValue(); try { $singlePlaceholderEarlyReturn[] = new ConstantStringType(@sprintf($constantString->getValue(), ...$printfArgs)); } catch (Throwable $e) { continue 2; } } continue; } $singlePlaceholderEarlyReturn[] = $checkArgType->toString(); } elseif ($matches['specifier'] !== 's') { $singlePlaceholderEarlyReturn[] = $this->getStringReturnType(new AccessoryNumericStringType(), $isLowercase); } continue; } $singlePlaceholderEarlyReturn = null; } if (is_array($singlePlaceholderEarlyReturn) && count($singlePlaceholderEarlyReturn) > 0) { return TypeCombinator::union(...$singlePlaceholderEarlyReturn); } if ($allPatternsNonFalsy) { return $this->getStringReturnType(new AccessoryNonFalsyStringType(), $isLowercase); } $isNonEmpty = $allPatternsNonEmpty; if (!$isNonEmpty && $formatType->isNonEmptyString()->yes()) { $isNonEmpty = $this->allValuesSatisfies($functionReflection, $scope, $args, static function (Type $type) : bool { return $type->toString()->isNonEmptyString()->yes(); }); } if ($isNonEmpty) { return $this->getStringReturnType(new AccessoryNonEmptyStringType(), $isLowercase); } return $this->getStringReturnType(null, $isLowercase); } /** * @param array<Arg> $args * @param callable(Type): bool $cb */ private function allValuesSatisfies(FunctionReflection $functionReflection, Scope $scope, array $args, callable $cb) : bool { if ($functionReflection->getName() === 'sprintf' && count($args) >= 2) { foreach ($args as $key => $arg) { if ($key === 0) { continue; } if (!$cb($scope->getType($arg->value))) { return \false; } } return \true; } if ($functionReflection->getName() === 'vsprintf' && count($args) >= 2) { return $cb($scope->getType($args[1]->value)->getIterableValueType()); } return \false; } /** * @param Arg[] $args */ private function getValueType(FunctionReflection $functionReflection, Scope $scope, array $args, int $argNumber) : ?Type { if ($functionReflection->getName() === 'sprintf') { // constant string specifies a numbered argument that does not exist if (!array_key_exists($argNumber, $args)) { return null; } return $scope->getType($args[$argNumber]->value); } if ($functionReflection->getName() === 'vsprintf') { if (!array_key_exists(1, $args)) { return null; } $valuesType = $scope->getType($args[1]->value); $resultTypes = []; $valuesConstantArrays = $valuesType->getConstantArrays(); foreach ($valuesConstantArrays as $valuesConstantArray) { // vsprintf does not care about the keys of the array, only the order $types = array_values($valuesConstantArray->getValueTypes()); if (!array_key_exists($argNumber - 1, $types)) { return null; } $resultTypes[] = $types[$argNumber - 1]; } if (count($resultTypes) === 0) { return $valuesType->getIterableValueType(); } return TypeCombinator::union(...$resultTypes); } return null; } /** * Detect constant strings in the format which neither depend on placeholders nor on given value arguments. */ private function getFormatConstantParts(string $format, FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?ConstantStringType { $args = $functionCall->getArgs(); if ($functionReflection->getName() === 'sprintf') { $valuesCount = count($args) - 1; } elseif ($functionReflection->getName() === 'vsprintf' && count($args) >= 2) { $arraySize = $scope->getType($args[1]->value)->getArraySize(); if (!$arraySize instanceof ConstantIntegerType) { return null; } $valuesCount = $arraySize->getValue(); } else { return null; } if ($valuesCount <= 0) { return null; } $dummyValues = array_fill(0, $valuesCount, ''); try { $formatted = @vsprintf($format, $dummyValues); if ($formatted === \false) { // @phpstan-ignore identical.alwaysFalse (PHP7.2 compat) return null; } return new ConstantStringType($formatted); } catch (Throwable $e) { return null; } } /** * @param Arg[] $args */ private function getConstantType(array $args, FunctionReflection $functionReflection, Scope $scope) : ?Type { $values = []; $combinationsCount = 1; foreach ($args as $arg) { if ($arg->unpack) { return null; } $argType = $scope->getType($arg->value); $constantScalarValues = $argType->getConstantScalarValues(); if (count($constantScalarValues) === 0) { if ($argType instanceof IntegerRangeType) { foreach ($argType->getFiniteTypes() as $finiteType) { $constantScalarValues[] = $finiteType->getValue(); } } } if (count($constantScalarValues) === 0) { return null; } $values[] = $constantScalarValues; $combinationsCount *= count($constantScalarValues); } if ($combinationsCount > InitializerExprTypeResolver::CALCULATE_SCALARS_LIMIT) { return null; } $combinations = CombinationsHelper::combinations($values); $returnTypes = []; foreach ($combinations as $combination) { $format = array_shift($combination); if (!is_string($format)) { return null; } try { if ($functionReflection->getName() === 'sprintf') { $returnTypes[] = $scope->getTypeFromValue(@sprintf($format, ...$combination)); } else { $returnTypes[] = $scope->getTypeFromValue(@vsprintf($format, $combination)); } } catch (Throwable $e) { return null; } } if (count($returnTypes) > InitializerExprTypeResolver::CALCULATE_SCALARS_LIMIT) { return null; } return TypeCombinator::union(...$returnTypes); } private function getStringReturnType(?AccessoryType $accessoryType, bool $isLowercase) : Type { $accessoryTypes = []; if ($accessoryType !== null) { $accessoryTypes[] = $accessoryType; } if ($isLowercase) { $accessoryTypes[] = new AccessoryLowercaseStringType(); } if (count($accessoryTypes) === 0) { return new StringType(); } $accessoryTypes[] = new StringType(); return new IntersectionType($accessoryTypes); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Analyser\SpecifiedTypes; use PHPStan\Analyser\TypeSpecifier; use PHPStan\Analyser\TypeSpecifierAwareExtension; use PHPStan\Analyser\TypeSpecifierContext; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\FunctionTypeSpecifyingExtension; final class AssertFunctionTypeSpecifyingExtension implements FunctionTypeSpecifyingExtension, TypeSpecifierAwareExtension { /** * @var TypeSpecifier */ private $typeSpecifier; public function isFunctionSupported(FunctionReflection $functionReflection, FuncCall $node, TypeSpecifierContext $context) : bool { return $functionReflection->getName() === 'assert' && isset($node->getArgs()[0]); } public function specifyTypes(FunctionReflection $functionReflection, FuncCall $node, Scope $scope, TypeSpecifierContext $context) : SpecifiedTypes { return $this->typeSpecifier->specifyTypesInCondition($scope, $node->getArgs()[0]->value, TypeSpecifierContext::createTruthy()); } public function setTypeSpecifier(TypeSpecifier $typeSpecifier) : void { $this->typeSpecifier = $typeSpecifier; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\ParametersAcceptorSelector; use PHPStan\Type\Accessory\AccessoryArrayListType; use PHPStan\Type\Accessory\NonEmptyArrayType; use PHPStan\Type\ArrayType; use PHPStan\Type\Constant\ConstantArrayTypeBuilder; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\IntegerType; use PHPStan\Type\MixedType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\TypeUtils; use function array_map; use function array_reduce; use function array_slice; use function count; final class ArrayMapFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'array_map'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { $numArgs = count($functionCall->getArgs()); if ($numArgs < 2) { return null; } $singleArrayArgument = !isset($functionCall->getArgs()[2]); $callableType = $scope->getType($functionCall->getArgs()[0]->value); $callableIsNull = $callableType->isNull()->yes(); $callableParametersAcceptors = null; if ($callableType->isCallable()->yes()) { $callableParametersAcceptors = $callableType->getCallableParametersAcceptors($scope); $valueType = ParametersAcceptorSelector::selectFromTypes(array_map(static function (Node\Arg $arg) use($scope) { return $scope->getType($arg->value)->getIterableValueType(); }, array_slice($functionCall->getArgs(), 1)), $callableParametersAcceptors, \false)->getReturnType(); } elseif ($callableIsNull) { $arrayBuilder = ConstantArrayTypeBuilder::createEmpty(); $argTypes = []; $areAllSameSize = \true; $expectedSize = null; foreach (array_slice($functionCall->getArgs(), 1) as $index => $arg) { $argTypes[$index] = $argType = $scope->getType($arg->value); if (!$areAllSameSize || $numArgs === 2) { continue; } $arraySizes = $argType->getArraySize()->getConstantScalarValues(); if ($arraySizes === []) { $areAllSameSize = \false; continue; } foreach ($arraySizes as $size) { $expectedSize = $expectedSize ?? $size; if ($expectedSize === $size) { continue; } $areAllSameSize = \false; continue 2; } } if (!$areAllSameSize) { $firstArr = $functionCall->getArgs()[1]->value; $identities = []; foreach (array_slice($functionCall->getArgs(), 2) as $arg) { $identities[] = new Node\Expr\BinaryOp\Identical($firstArr, $arg->value); } $and = array_reduce($identities, static function (Node\Expr $a, Node\Expr $b) { return new Node\Expr\BinaryOp\BooleanAnd($a, $b); }, new Node\Expr\ConstFetch(new Node\Name('true'))); $areAllSameSize = $scope->getType($and)->isTrue()->yes(); } $addNull = !$areAllSameSize; foreach ($argTypes as $index => $argType) { $offsetValueType = $argType->getIterableValueType(); if ($addNull) { $offsetValueType = TypeCombinator::addNull($offsetValueType); } $arrayBuilder->setOffsetValueType(new ConstantIntegerType($index), $offsetValueType); } $valueType = $arrayBuilder->getArray(); } else { $valueType = new MixedType(); } $arrayType = $scope->getType($functionCall->getArgs()[1]->value); if ($singleArrayArgument) { if ($callableIsNull) { return $arrayType; } $constantArrays = $arrayType->getConstantArrays(); if (count($constantArrays) > 0) { $arrayTypes = []; $totalCount = TypeCombinator::countConstantArrayValueTypes($constantArrays) * TypeCombinator::countConstantArrayValueTypes([$valueType]); if ($totalCount < ConstantArrayTypeBuilder::ARRAY_COUNT_LIMIT) { foreach ($constantArrays as $constantArray) { $returnedArrayBuilder = ConstantArrayTypeBuilder::createEmpty(); $valueTypes = $constantArray->getValueTypes(); foreach ($constantArray->getKeyTypes() as $i => $keyType) { $returnedArrayBuilder->setOffsetValueType($keyType, $callableParametersAcceptors !== null ? ParametersAcceptorSelector::selectFromTypes([$valueTypes[$i]], $callableParametersAcceptors, \false)->getReturnType() : $valueType, $constantArray->isOptionalKey($i)); } $returnedArray = $returnedArrayBuilder->getArray(); if ($constantArray->isList()->yes()) { $returnedArray = AccessoryArrayListType::intersectWith($returnedArray); } $arrayTypes[] = $returnedArray; } $mappedArrayType = TypeCombinator::union(...$arrayTypes); } else { $mappedArrayType = TypeCombinator::intersect(new ArrayType($arrayType->getIterableKeyType(), $valueType), ...TypeUtils::getAccessoryTypes($arrayType)); } } elseif ($arrayType->isArray()->yes()) { $mappedArrayType = TypeCombinator::intersect(new ArrayType($arrayType->getIterableKeyType(), $valueType), ...TypeUtils::getAccessoryTypes($arrayType)); } else { $mappedArrayType = new ArrayType(new MixedType(), $valueType); } } else { $mappedArrayType = AccessoryArrayListType::intersectWith(TypeCombinator::intersect(new ArrayType(new IntegerType(), $valueType), ...TypeUtils::getAccessoryTypes($arrayType))); } if ($arrayType->isIterableAtLeastOnce()->yes()) { $mappedArrayType = TypeCombinator::intersect($mappedArrayType, new NonEmptyArrayType()); } return $mappedArrayType; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use BackedEnum; use PhpParser\Node\Expr\StaticCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\MethodReflection; use PHPStan\Type\DynamicStaticMethodReturnTypeExtension; use PHPStan\Type\Enum\EnumCaseObjectType; use PHPStan\Type\NullType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function count; use function in_array; final class BackedEnumFromMethodDynamicReturnTypeExtension implements DynamicStaticMethodReturnTypeExtension { public function getClass() : string { return BackedEnum::class; } public function isStaticMethodSupported(MethodReflection $methodReflection) : bool { return in_array($methodReflection->getName(), ['from', 'tryFrom'], \true); } public function getTypeFromStaticMethodCall(MethodReflection $methodReflection, StaticCall $methodCall, Scope $scope) : ?Type { if (!$methodReflection->getDeclaringClass()->isBackedEnum()) { return null; } $arguments = $methodCall->getArgs(); if (count($arguments) < 1) { return null; } $valueType = $scope->getType($arguments[0]->value); $enumCases = $methodReflection->getDeclaringClass()->getEnumCases(); if (count($enumCases) === 0) { if ($methodReflection->getName() === 'tryFrom') { return new NullType(); } return null; } if (count($valueType->getConstantScalarValues()) === 0) { return null; } $resultEnumCases = []; $addNull = \false; foreach ($valueType->getConstantScalarValues() as $value) { $hasMatching = \false; foreach ($enumCases as $enumCase) { if ($enumCase->getBackingValueType() === null) { continue; } $enumCaseValues = $enumCase->getBackingValueType()->getConstantScalarValues(); if (count($enumCaseValues) !== 1) { continue; } if ($value === $enumCaseValues[0]) { $resultEnumCases[] = new EnumCaseObjectType($enumCase->getDeclaringEnum()->getName(), $enumCase->getName(), $enumCase->getDeclaringEnum()); $hasMatching = \true; break; } } if ($hasMatching) { continue; } $addNull = \true; } if (count($resultEnumCases) === 0) { if ($methodReflection->getName() === 'tryFrom') { return new NullType(); } return null; } $result = TypeCombinator::union(...$resultEnumCases); if ($addNull && $methodReflection->getName() === 'tryFrom') { return TypeCombinator::addNull($result); } return $result; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function count; use function in_array; final class ArrayPointerFunctionsDynamicReturnTypeExtension implements DynamicFunctionReturnTypeExtension { /** @var string[] */ private $functions = ['reset', 'end']; public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return in_array($functionReflection->getName(), $this->functions, \true); } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (count($functionCall->getArgs()) === 0) { return null; } $argType = $scope->getType($functionCall->getArgs()[0]->value); $iterableAtLeastOnce = $argType->isIterableAtLeastOnce(); if ($iterableAtLeastOnce->no()) { return new ConstantBooleanType(\false); } $itemType = $functionReflection->getName() === 'reset' ? $argType->getFirstIterableValueType() : $argType->getLastIterableValueType(); if ($iterableAtLeastOnce->yes()) { return $itemType; } return TypeCombinator::union($itemType, new ConstantBooleanType(\false)); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\ParametersAcceptorSelector; use PHPStan\TrinaryLogic; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\NullType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function count; final class ArrayReduceFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'array_reduce'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (!isset($functionCall->getArgs()[1])) { return null; } $callbackType = $scope->getType($functionCall->getArgs()[1]->value); if ($callbackType->isCallable()->no()) { return null; } $callbackReturnType = ParametersAcceptorSelector::selectFromArgs($scope, $functionCall->getArgs(), $callbackType->getCallableParametersAcceptors($scope))->getReturnType(); if (isset($functionCall->getArgs()[2])) { $initialType = $scope->getType($functionCall->getArgs()[2]->value); } else { $initialType = new NullType(); } $arraysType = $scope->getType($functionCall->getArgs()[0]->value); $constantArrays = $arraysType->getConstantArrays(); if (count($constantArrays) > 0) { $onlyEmpty = TrinaryLogic::createYes(); $onlyNonEmpty = TrinaryLogic::createYes(); foreach ($constantArrays as $constantArray) { $iterableAtLeastOnce = $constantArray->isIterableAtLeastOnce(); $onlyEmpty = $onlyEmpty->and($iterableAtLeastOnce->negate()); $onlyNonEmpty = $onlyNonEmpty->and($iterableAtLeastOnce); } if ($onlyEmpty->yes()) { return $initialType; } if ($onlyNonEmpty->yes()) { return $callbackReturnType; } } return TypeCombinator::union($callbackReturnType, $initialType); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\ArrayType; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\ErrorType; use PHPStan\Type\IntegerType; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\UnionType; use function count; final class StrWordCountFunctionDynamicReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'str_word_count'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, Node\Expr\FuncCall $functionCall, Scope $scope) : Type { $argsCount = count($functionCall->getArgs()); if ($argsCount === 1) { return new IntegerType(); } elseif ($argsCount === 2 || $argsCount === 3) { $formatType = $scope->getType($functionCall->getArgs()[1]->value); if ($formatType instanceof ConstantIntegerType) { $val = $formatType->getValue(); if ($val === 0) { // return word count return new IntegerType(); } elseif ($val === 1 || $val === 2) { // return [word] or [offset => word] return new ArrayType(new IntegerType(), new StringType()); } // return false, invalid format value specified return new ConstantBooleanType(\false); } // Could be invalid format type as well, but parameter type checks will catch that. return new UnionType([new IntegerType(), new ArrayType(new IntegerType(), new StringType()), new ConstantBooleanType(\false)]); } // else fatal error; too many or too few arguments return new ErrorType(); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Accessory\AccessoryLowercaseStringType; use PHPStan\Type\Accessory\AccessoryNonEmptyStringType; use PHPStan\Type\Accessory\AccessoryNonFalsyStringType; use PHPStan\Type\Accessory\AccessoryUppercaseStringType; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\IntegerRangeType; use PHPStan\Type\IntersectionType; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function count; use function in_array; use function is_bool; use function mb_substr; use function substr; final class SubstrDynamicReturnTypeExtension implements DynamicFunctionReturnTypeExtension { /** * @var PhpVersion */ private $phpVersion; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; } public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return in_array($functionReflection->getName(), ['substr', 'mb_substr'], \true); } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { $args = $functionCall->getArgs(); if (count($args) < 2) { return null; } $string = $scope->getType($args[0]->value); $offset = $scope->getType($args[1]->value); $negativeOffset = IntegerRangeType::fromInterval(null, -1)->isSuperTypeOf($offset)->yes(); $zeroOffset = (new ConstantIntegerType(0))->isSuperTypeOf($offset)->yes(); $length = null; $positiveLength = \false; $maybeOneLength = \false; if (count($args) === 3) { $length = $scope->getType($args[2]->value); $positiveLength = IntegerRangeType::fromInterval(1, null)->isSuperTypeOf($length)->yes(); $maybeOneLength = !(new ConstantIntegerType(1))->isSuperTypeOf($length)->no(); } $constantStrings = $string->getConstantStrings(); if (count($constantStrings) > 0 && $offset instanceof ConstantIntegerType && ($length === null || $length instanceof ConstantIntegerType)) { $results = []; foreach ($constantStrings as $constantString) { if ($length !== null) { if ($functionReflection->getName() === 'mb_substr') { $substr = mb_substr($constantString->getValue(), $offset->getValue(), $length->getValue()); } else { $substr = substr($constantString->getValue(), $offset->getValue(), $length->getValue()); } } else { if ($functionReflection->getName() === 'mb_substr') { $substr = mb_substr($constantString->getValue(), $offset->getValue()); } else { $substr = substr($constantString->getValue(), $offset->getValue()); } } if (is_bool($substr)) { $results[] = new ConstantBooleanType($substr); } else { $results[] = new ConstantStringType($substr); } } return TypeCombinator::union(...$results); } $accessoryTypes = []; $isNotEmpty = \false; if ($string->isLowercaseString()->yes()) { $accessoryTypes[] = new AccessoryLowercaseStringType(); } if ($string->isUppercaseString()->yes()) { $accessoryTypes[] = new AccessoryUppercaseStringType(); } if ($string->isNonEmptyString()->yes() && ($negativeOffset || $zeroOffset && $positiveLength)) { $isNotEmpty = \true; if ($string->isNonFalsyString()->yes() && !$maybeOneLength) { $accessoryTypes[] = new AccessoryNonFalsyStringType(); } else { $accessoryTypes[] = new AccessoryNonEmptyStringType(); } } if (count($accessoryTypes) > 0) { $accessoryTypes[] = new StringType(); if (!$isNotEmpty && $this->phpVersion->substrReturnFalseInsteadOfEmptyString()) { return TypeCombinator::union(new ConstantBooleanType(\false), new IntersectionType($accessoryTypes)); } return new IntersectionType($accessoryTypes); } return null; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\TrinaryLogic; use PHPStan\Type\Accessory\AccessoryArrayListType; use PHPStan\Type\Accessory\NonEmptyArrayType; use PHPStan\Type\ArrayType; use PHPStan\Type\Constant\ConstantArrayType; use PHPStan\Type\Constant\ConstantArrayTypeBuilder; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\IntegerType; use PHPStan\Type\NeverType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function array_keys; use function count; use function in_array; final class ArrayMergeFunctionDynamicReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'array_merge'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { $args = $functionCall->getArgs(); if (!isset($args[0])) { return null; } $argTypes = []; $optionalArgTypes = []; foreach ($args as $arg) { $argType = $scope->getType($arg->value); if ($arg->unpack) { if ($argType->isConstantArray()->yes()) { foreach ($argType->getConstantArrays() as $constantArray) { foreach ($constantArray->getValueTypes() as $valueType) { $argTypes[] = $valueType; } } } else { $argTypes[] = $argType->getIterableValueType(); } if (!$argType->isIterableAtLeastOnce()->yes()) { // unpacked params can be empty, making them optional $optionalArgTypesOffset = count($argTypes) - 1; foreach (array_keys($argTypes) as $key) { $optionalArgTypes[] = $optionalArgTypesOffset + $key; } } } else { $argTypes[] = $argType; } } $allConstant = TrinaryLogic::createYes()->lazyAnd($argTypes, static function (Type $argType) { return $argType->isConstantArray(); }); if ($allConstant->yes()) { $newArrayBuilder = ConstantArrayTypeBuilder::createEmpty(); foreach ($argTypes as $argType) { /** @var array<int|string, ConstantIntegerType|ConstantStringType> $keyTypes */ $keyTypes = []; foreach ($argType->getConstantArrays() as $constantArray) { foreach ($constantArray->getKeyTypes() as $keyType) { $keyTypes[$keyType->getValue()] = $keyType; } } foreach ($keyTypes as $keyType) { $newArrayBuilder->setOffsetValueType($keyType instanceof ConstantIntegerType ? null : $keyType, $argType->getOffsetValueType($keyType), !$argType->hasOffsetValueType($keyType)->yes()); } } return $newArrayBuilder->getArray(); } $keyTypes = []; $valueTypes = []; $nonEmpty = \false; $isList = \true; foreach ($argTypes as $key => $argType) { $keyType = $argType->getIterableKeyType(); $keyTypes[] = $keyType; $valueTypes[] = $argType->getIterableValueType(); if (!(new IntegerType())->isSuperTypeOf($keyType)->yes()) { $isList = \false; } if (in_array($key, $optionalArgTypes, \true) || !$argType->isIterableAtLeastOnce()->yes()) { continue; } $nonEmpty = \true; } $keyType = TypeCombinator::union(...$keyTypes); if ($keyType instanceof NeverType) { return new ConstantArrayType([], []); } $arrayType = new ArrayType($keyType, TypeCombinator::union(...$valueTypes)); if ($nonEmpty) { $arrayType = TypeCombinator::intersect($arrayType, new NonEmptyArrayType()); } if ($isList) { $arrayType = AccessoryArrayListType::intersectWith($arrayType); } return $arrayType; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use DatePeriod; use DateTime; use DateTimeInterface; use PhpParser\Node\Expr\StaticCall; use PhpParser\Node\Name; use PHPStan\Analyser\Scope; use PHPStan\Reflection\MethodReflection; use PHPStan\Type\DynamicStaticMethodReturnTypeExtension; use PHPStan\Type\Generic\GenericObjectType; use PHPStan\Type\IntegerType; use PHPStan\Type\NullType; use PHPStan\Type\ObjectType; use PHPStan\Type\Type; use function strtolower; final class DatePeriodConstructorReturnTypeExtension implements DynamicStaticMethodReturnTypeExtension { public function getClass() : string { return DatePeriod::class; } public function isStaticMethodSupported(MethodReflection $methodReflection) : bool { return $methodReflection->getName() === '__construct'; } public function getTypeFromStaticMethodCall(MethodReflection $methodReflection, StaticCall $methodCall, Scope $scope) : Type { if (!isset($methodCall->getArgs()[0])) { return new ObjectType(DatePeriod::class); } if (!$methodCall->class instanceof Name) { return new ObjectType(DatePeriod::class); } $className = $scope->resolveName($methodCall->class); if (strtolower($className) !== 'dateperiod') { return new ObjectType($className); } $firstArgType = $scope->getType($methodCall->getArgs()[0]->value); if ($firstArgType->isString()->yes()) { $firstArgType = new ObjectType(DateTime::class); } $thirdArgType = null; if (isset($methodCall->getArgs()[2])) { $thirdArgType = $scope->getType($methodCall->getArgs()[2]->value); } if (!$thirdArgType instanceof Type) { return new GenericObjectType(DatePeriod::class, [$firstArgType, new NullType(), new IntegerType()]); } if ((new ObjectType(DateTimeInterface::class))->isSuperTypeOf($thirdArgType)->yes()) { return new GenericObjectType(DatePeriod::class, [$firstArgType, $thirdArgType, new NullType()]); } if ($thirdArgType->isInteger()->yes()) { return new GenericObjectType(DatePeriod::class, [$firstArgType, new NullType(), $thirdArgType]); } return new ObjectType(DatePeriod::class); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\NullType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function count; final class ArrayFindKeyFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'array_find_key'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (count($functionCall->getArgs()) < 2) { return null; } $arrayType = $scope->getType($functionCall->getArgs()[0]->value); if (count($arrayType->getArrays()) < 1) { return null; } return TypeCombinator::union($arrayType->getIterableKeyType(), new NullType()); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\MethodCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\MethodReflection; use PHPStan\Type\ArrayType; use PHPStan\Type\DynamicMethodReturnTypeExtension; use PHPStan\Type\MixedType; use PHPStan\Type\NeverType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use SimpleXMLElement; use function extension_loaded; final class SimpleXMLElementXpathMethodReturnTypeExtension implements DynamicMethodReturnTypeExtension { public function getClass() : string { return SimpleXMLElement::class; } public function isMethodSupported(MethodReflection $methodReflection) : bool { return extension_loaded('simplexml') && $methodReflection->getName() === 'xpath'; } public function getTypeFromMethodCall(MethodReflection $methodReflection, MethodCall $methodCall, Scope $scope) : ?Type { if (!isset($methodCall->getArgs()[0])) { return null; } $argType = $scope->getType($methodCall->getArgs()[0]->value); $xmlElement = new SimpleXMLElement('<foo />'); foreach ($argType->getConstantStrings() as $constantString) { $result = @$xmlElement->xpath($constantString->getValue()); if ($result === \false) { // We can't be sure since it's maybe a namespaced xpath return null; } $argType = TypeCombinator::remove($argType, $constantString); } if (!$argType instanceof NeverType) { return null; } return new ArrayType(new MixedType(), $scope->getType($methodCall->var)); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PhpParser\Node\Name; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\ReflectionProvider; use PHPStan\Type\ArrayType; use PHPStan\Type\Constant\ConstantArrayTypeBuilder; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\FloatType; use PHPStan\Type\IntegerType; use PHPStan\Type\NullType; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\TypeUtils; use function count; final class CurlGetinfoFunctionDynamicReturnTypeExtension implements DynamicFunctionReturnTypeExtension { /** * @var ReflectionProvider */ private $reflectionProvider; public function __construct(ReflectionProvider $reflectionProvider) { $this->reflectionProvider = $reflectionProvider; } public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'curl_getinfo'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (count($functionCall->getArgs()) < 1) { return null; } if (count($functionCall->getArgs()) <= 1) { return $this->createAllComponentsReturnType(); } $componentType = $scope->getType($functionCall->getArgs()[1]->value); if (!$componentType->isNull()->no()) { return $this->createAllComponentsReturnType(); } $componentType = $componentType->toInteger(); if (!$componentType instanceof ConstantIntegerType) { return $this->createAllComponentsReturnType(); } $stringType = new StringType(); $integerType = new IntegerType(); $floatType = new FloatType(); $falseType = new ConstantBooleanType(\false); $stringFalseType = TypeCombinator::union($stringType, $falseType); $integerStringArrayType = new ArrayType($integerType, $stringType); $nestedStringStringArrayType = new ArrayType($integerType, new ArrayType($stringType, $stringType)); $componentTypesPairedConstants = ['CURLINFO_EFFECTIVE_URL' => $stringType, 'CURLINFO_FILETIME' => $integerType, 'CURLINFO_TOTAL_TIME' => $floatType, 'CURLINFO_NAMELOOKUP_TIME' => $floatType, 'CURLINFO_CONNECT_TIME' => $floatType, 'CURLINFO_PRETRANSFER_TIME' => $floatType, 'CURLINFO_STARTTRANSFER_TIME' => $floatType, 'CURLINFO_REDIRECT_COUNT' => $integerType, 'CURLINFO_REDIRECT_TIME' => $floatType, 'CURLINFO_REDIRECT_URL' => $stringType, 'CURLINFO_PRIMARY_IP' => $stringType, 'CURLINFO_PRIMARY_PORT' => $integerType, 'CURLINFO_LOCAL_IP' => $stringType, 'CURLINFO_LOCAL_PORT' => $integerType, 'CURLINFO_SIZE_UPLOAD' => $integerType, 'CURLINFO_SIZE_DOWNLOAD' => $integerType, 'CURLINFO_SPEED_DOWNLOAD' => $integerType, 'CURLINFO_SPEED_UPLOAD' => $integerType, 'CURLINFO_HEADER_SIZE' => $integerType, 'CURLINFO_HEADER_OUT' => $stringFalseType, 'CURLINFO_REQUEST_SIZE' => $integerType, 'CURLINFO_SSL_VERIFYRESULT' => $integerType, 'CURLINFO_CONTENT_LENGTH_DOWNLOAD' => $floatType, 'CURLINFO_CONTENT_LENGTH_UPLOAD' => $floatType, 'CURLINFO_CONTENT_TYPE' => $stringFalseType, 'CURLINFO_PRIVATE' => $stringFalseType, 'CURLINFO_RESPONSE_CODE' => $integerType, 'CURLINFO_HTTP_CONNECTCODE' => $integerType, 'CURLINFO_HTTPAUTH_AVAIL' => $integerType, 'CURLINFO_PROXYAUTH_AVAIL' => $integerType, 'CURLINFO_OS_ERRNO' => $integerType, 'CURLINFO_NUM_CONNECTS' => $integerType, 'CURLINFO_SSL_ENGINES' => $integerStringArrayType, 'CURLINFO_COOKIELIST' => $integerStringArrayType, 'CURLINFO_FTP_ENTRY_PATH' => $stringFalseType, 'CURLINFO_APPCONNECT_TIME' => $floatType, 'CURLINFO_CERTINFO' => $nestedStringStringArrayType, 'CURLINFO_CONDITION_UNMET' => $integerType, 'CURLINFO_RTSP_CLIENT_CSEQ' => $integerType, 'CURLINFO_RTSP_CSEQ_RECV' => $integerType, 'CURLINFO_RTSP_SERVER_CSEQ' => $integerType, 'CURLINFO_RTSP_SESSION_ID' => $integerType, 'CURLINFO_HTTP_VERSION' => $integerType, 'CURLINFO_PROTOCOL' => $stringType, 'CURLINFO_PROXY_SSL_VERIFYRESULT' => $integerType, 'CURLINFO_SCHEME' => $stringType, 'CURLINFO_CONTENT_LENGTH_DOWNLOAD_T' => $integerType, 'CURLINFO_CONTENT_LENGTH_UPLOAD_T' => $integerType, 'CURLINFO_SIZE_DOWNLOAD_T' => $integerType, 'CURLINFO_SIZE_UPLOAD_T' => $integerType, 'CURLINFO_SPEED_DOWNLOAD_T' => $integerType, 'CURLINFO_SPEED_UPLOAD_T' => $integerType, 'CURLINFO_APPCONNECT_TIME_T' => $integerType, 'CURLINFO_CONNECT_TIME_T' => $integerType, 'CURLINFO_FILETIME_T' => $integerType, 'CURLINFO_NAMELOOKUP_TIME_T' => $integerType, 'CURLINFO_PRETRANSFER_TIME_T' => $integerType, 'CURLINFO_REDIRECT_TIME_T' => $integerType, 'CURLINFO_STARTTRANSFER_TIME_T' => $integerType, 'CURLINFO_TOTAL_TIME_T' => $integerType]; foreach ($componentTypesPairedConstants as $constantName => $type) { $constantNameNode = new Name($constantName); if ($this->reflectionProvider->hasConstant($constantNameNode, $scope) === \false) { continue; } $valueType = $this->reflectionProvider->getConstant($constantNameNode, $scope)->getValueType(); if ($componentType->isSuperTypeOf($valueType)->yes()) { return $type; } } return $falseType; } private function createAllComponentsReturnType() : Type { $returnTypes = [new ConstantBooleanType(\false)]; $builder = ConstantArrayTypeBuilder::createEmpty(); $stringType = new StringType(); $integerType = new IntegerType(); $floatType = new FloatType(); $stringOrNullType = TypeCombinator::union($stringType, new NullType()); $nestedStringStringArrayType = new ArrayType($integerType, new ArrayType($stringType, $stringType)); $componentTypesPairedStrings = ['url' => $stringType, 'content_type' => $stringOrNullType, 'http_code' => $integerType, 'header_size' => $integerType, 'request_size' => $integerType, 'filetime' => $integerType, 'ssl_verify_result' => $integerType, 'redirect_count' => $integerType, 'total_time' => $floatType, 'namelookup_time' => $floatType, 'connect_time' => $floatType, 'pretransfer_time' => $floatType, 'size_upload' => $floatType, 'size_download' => $floatType, 'speed_download' => $floatType, 'speed_upload' => $floatType, 'download_content_length' => $floatType, 'upload_content_length' => $floatType, 'starttransfer_time' => $floatType, 'redirect_time' => $floatType, 'redirect_url' => $stringType, 'primary_ip' => $stringType, 'certinfo' => $nestedStringStringArrayType, 'primary_port' => $integerType, 'local_ip' => $stringType, 'local_port' => $integerType, 'http_version' => $integerType, 'protocol' => $integerType, 'ssl_verifyresult' => $integerType, 'scheme' => $stringType]; foreach ($componentTypesPairedStrings as $componentName => $componentValueType) { $builder->setOffsetValueType(new ConstantStringType($componentName), $componentValueType); } $returnTypes[] = $builder->getArray(); return TypeUtils::toBenevolentUnion(TypeCombinator::union(...$returnTypes)); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Accessory\NonEmptyArrayType; use PHPStan\Type\ArrayType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function count; use function strtolower; final class ArrayReplaceFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return strtolower($functionReflection->getName()) === 'array_replace'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { $arrayTypes = $this->collectArrayTypes($functionCall, $scope); if (count($arrayTypes) === 0) { return null; } return $this->getResultType(...$arrayTypes); } private function getResultType(Type ...$arrayTypes) : Type { $keyTypes = []; $valueTypes = []; $nonEmptyArray = \false; foreach ($arrayTypes as $arrayType) { if (!$nonEmptyArray && $arrayType->isIterableAtLeastOnce()->yes()) { $nonEmptyArray = \true; } $keyTypes[] = $arrayType->getIterableKeyType(); $valueTypes[] = $arrayType->getIterableValueType(); } $keyType = TypeCombinator::union(...$keyTypes); $valueType = TypeCombinator::union(...$valueTypes); $arrayType = new ArrayType($keyType, $valueType); return $nonEmptyArray ? TypeCombinator::intersect($arrayType, new NonEmptyArrayType()) : $arrayType; } /** * @return Type[] */ private function collectArrayTypes(FuncCall $functionCall, Scope $scope) : array { $args = $functionCall->getArgs(); $arrayTypes = []; foreach ($args as $arg) { $argType = $scope->getType($arg->value); if (!$argType->isArray()->yes()) { continue; } $arrayTypes[] = $arg->unpack ? $argType->getIterableValueType() : $argType; } return $arrayTypes; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\ArrayDimFetch; use PhpParser\Node\Expr\BinaryOp\Identical; use PhpParser\Node\Expr\ConstFetch; use PhpParser\Node\Expr\FuncCall; use PhpParser\Node\Name; use PHPStan\Analyser\Scope; use PHPStan\Analyser\SpecifiedTypes; use PHPStan\Analyser\TypeSpecifier; use PHPStan\Analyser\TypeSpecifierAwareExtension; use PHPStan\Analyser\TypeSpecifierContext; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Accessory\HasOffsetType; use PHPStan\Type\ArrayType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\FunctionTypeSpecifyingExtension; use PHPStan\Type\MixedType; use PHPStan\Type\TypeCombinator; use function count; use function in_array; final class ArrayKeyExistsFunctionTypeSpecifyingExtension implements FunctionTypeSpecifyingExtension, TypeSpecifierAwareExtension { /** * @var TypeSpecifier */ private $typeSpecifier; public function setTypeSpecifier(TypeSpecifier $typeSpecifier) : void { $this->typeSpecifier = $typeSpecifier; } public function isFunctionSupported(FunctionReflection $functionReflection, FuncCall $node, TypeSpecifierContext $context) : bool { return in_array($functionReflection->getName(), ['array_key_exists', 'key_exists'], \true) && !$context->null(); } public function specifyTypes(FunctionReflection $functionReflection, FuncCall $node, Scope $scope, TypeSpecifierContext $context) : SpecifiedTypes { if (count($node->getArgs()) < 2) { return new SpecifiedTypes(); } $key = $node->getArgs()[0]->value; $array = $node->getArgs()[1]->value; $keyType = $scope->getType($key); $arrayType = $scope->getType($array); if (!$keyType instanceof ConstantIntegerType && !$keyType instanceof ConstantStringType && !$arrayType->isIterableAtLeastOnce()->no()) { if ($context->true()) { $arrayKeyType = $arrayType->getIterableKeyType(); if ($keyType->isString()->yes()) { $arrayKeyType = $arrayKeyType->toString(); } elseif ($keyType->isString()->maybe()) { $arrayKeyType = TypeCombinator::union($arrayKeyType, $arrayKeyType->toString()); } $specifiedTypes = $this->typeSpecifier->create($key, $arrayKeyType, $context, \false, $scope); $arrayDimFetch = new ArrayDimFetch($array, $key); return $specifiedTypes->unionWith($this->typeSpecifier->create($arrayDimFetch, $arrayType->getIterableValueType(), $context, \false, $scope, new Identical($arrayDimFetch, new ConstFetch(new Name('__PHPSTAN_FAUX_CONSTANT'))))); } return new SpecifiedTypes(); } if ($context->true()) { $type = TypeCombinator::intersect(new ArrayType(new MixedType(), new MixedType()), new HasOffsetType($keyType)); } else { $type = new HasOffsetType($keyType); } return $this->typeSpecifier->create($array, $type, $context, \false, $scope); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\ArrayType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\Type; final class ArraySpliceFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'array_splice'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (!isset($functionCall->getArgs()[0])) { return null; } $arrayArg = $scope->getType($functionCall->getArgs()[0]->value); return new ArrayType($arrayArg->getIterableKeyType(), $arrayArg->getIterableValueType()); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Analyser\SpecifiedTypes; use PHPStan\Analyser\TypeSpecifier; use PHPStan\Analyser\TypeSpecifierAwareExtension; use PHPStan\Analyser\TypeSpecifierContext; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\FunctionTypeSpecifyingExtension; use PHPStan\Type\MixedType; use function count; final class DefinedConstantTypeSpecifyingExtension implements FunctionTypeSpecifyingExtension, TypeSpecifierAwareExtension { /** * @var ConstantHelper */ private $constantHelper; /** * @var TypeSpecifier */ private $typeSpecifier; public function __construct(\PHPStan\Type\Php\ConstantHelper $constantHelper) { $this->constantHelper = $constantHelper; } public function setTypeSpecifier(TypeSpecifier $typeSpecifier) : void { $this->typeSpecifier = $typeSpecifier; } public function isFunctionSupported(FunctionReflection $functionReflection, FuncCall $node, TypeSpecifierContext $context) : bool { return $functionReflection->getName() === 'defined' && count($node->getArgs()) >= 1 && $context->true(); } public function specifyTypes(FunctionReflection $functionReflection, FuncCall $node, Scope $scope, TypeSpecifierContext $context) : SpecifiedTypes { $constantName = $scope->getType($node->getArgs()[0]->value); if (!$constantName instanceof ConstantStringType || $constantName->getValue() === '') { return new SpecifiedTypes([], []); } $expr = $this->constantHelper->createExprFromConstantName($constantName->getValue()); if ($expr === null) { return new SpecifiedTypes([], []); } return $this->typeSpecifier->create($expr, new MixedType(), $context, \false, $scope); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\ErrorType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function count; final class ConstantFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { /** * @var ConstantHelper */ private $constantHelper; public function __construct(\PHPStan\Type\Php\ConstantHelper $constantHelper) { $this->constantHelper = $constantHelper; } public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'constant'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (count($functionCall->getArgs()) < 1) { return null; } $nameType = $scope->getType($functionCall->getArgs()[0]->value); $results = []; foreach ($nameType->getConstantStrings() as $constantName) { $expr = $this->constantHelper->createExprFromConstantName($constantName->getValue()); if ($expr === null) { return new ErrorType(); } $results[] = $scope->getType($expr); } if (count($results) > 0) { return TypeCombinator::union(...$results); } return null; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\ParametersAcceptorSelector; use PHPStan\TrinaryLogic; use PHPStan\Type\ClassStringType; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\ObjectWithoutClassType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\TypeUtils; use PHPStan\Type\UnionType; use function count; use function in_array; final class ClassImplementsFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return in_array($functionReflection->getName(), ['class_implements', 'class_uses', 'class_parents'], \true); } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { $args = $functionCall->getArgs(); if (count($args) < 1) { return null; } $firstArgType = $scope->getType($args[0]->value); $autoload = TrinaryLogic::createYes(); if (isset($args[1])) { $autoload = $scope->getType($args[1]->value)->isTrue(); } $isObject = $firstArgType->isObject(); $variant = ParametersAcceptorSelector::selectFromArgs($scope, $args, $functionReflection->getVariants()); if ($isObject->yes()) { return TypeCombinator::remove($variant->getReturnType(), new ConstantBooleanType(\false)); } $isClassStringOrObject = (new UnionType([new ObjectWithoutClassType(), new ClassStringType()]))->isSuperTypeOf($firstArgType); if ($isClassStringOrObject->yes()) { if ($autoload->yes()) { return TypeUtils::toBenevolentUnion($variant->getReturnType()); } return $variant->getReturnType(); } if ($firstArgType->isClassStringType()->no()) { return new ConstantBooleanType(\false); } return null; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\ShouldNotHappenException; use PHPStan\Type\Accessory\AccessoryLowercaseStringType; use PHPStan\Type\Constant\ConstantArrayTypeBuilder; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\IntegerRangeType; use PHPStan\Type\IntersectionType; use PHPStan\Type\NullType; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use ValueError; use function count; use function parse_url; use const PHP_URL_FRAGMENT; use const PHP_URL_HOST; use const PHP_URL_PASS; use const PHP_URL_PATH; use const PHP_URL_PORT; use const PHP_URL_QUERY; use const PHP_URL_SCHEME; use const PHP_URL_USER; final class ParseUrlFunctionDynamicReturnTypeExtension implements DynamicFunctionReturnTypeExtension { /** @var array<int,Type>|null */ private $componentTypesPairedConstants = null; /** @var array<string,Type>|null */ private $componentTypesPairedStrings = null; /** @var array<int,Type>|null */ private $componentTypesPairedConstantsForLowercaseString = null; /** @var array<string,Type>|null */ private $componentTypesPairedStringsForLowercaseString = null; /** * @var ?Type */ private $allComponentsTogetherType = null; /** * @var ?Type */ private $allComponentsTogetherTypeForLowercaseString = null; public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'parse_url'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (count($functionCall->getArgs()) < 1) { return null; } $this->cacheReturnTypes(); $urlType = $scope->getType($functionCall->getArgs()[0]->value); if (count($functionCall->getArgs()) > 1) { $componentType = $scope->getType($functionCall->getArgs()[1]->value); if (!$componentType->isConstantValue()->yes()) { return $this->createAllComponentsReturnType($urlType->isLowercaseString()->yes()); } $componentType = $componentType->toInteger(); if (!$componentType instanceof ConstantIntegerType) { return $this->createAllComponentsReturnType($urlType->isLowercaseString()->yes()); } } else { $componentType = new ConstantIntegerType(-1); } if (count($urlType->getConstantStrings()) > 0) { $types = []; foreach ($urlType->getConstantStrings() as $constantString) { try { $result = @parse_url($constantString->getValue(), $componentType->getValue()); } catch (ValueError $e) { $types[] = new ConstantBooleanType(\false); continue; } $types[] = $scope->getTypeFromValue($result); } return TypeCombinator::union(...$types); } if ($componentType->getValue() === -1) { return TypeCombinator::union($this->createComponentsArray($urlType->isLowercaseString()->yes()), new ConstantBooleanType(\false)); } if ($urlType->isLowercaseString()->yes()) { return $this->componentTypesPairedConstantsForLowercaseString[$componentType->getValue()] ?? new ConstantBooleanType(\false); } return $this->componentTypesPairedConstants[$componentType->getValue()] ?? new ConstantBooleanType(\false); } private function createAllComponentsReturnType(bool $urlIsLowercase) : Type { if ($urlIsLowercase) { if ($this->allComponentsTogetherTypeForLowercaseString === null) { $returnTypes = [new ConstantBooleanType(\false), new NullType(), IntegerRangeType::fromInterval(0, 65535), new IntersectionType([new StringType(), new AccessoryLowercaseStringType()]), $this->createComponentsArray(\true)]; $this->allComponentsTogetherTypeForLowercaseString = TypeCombinator::union(...$returnTypes); } return $this->allComponentsTogetherTypeForLowercaseString; } if ($this->allComponentsTogetherType === null) { $returnTypes = [new ConstantBooleanType(\false), new NullType(), IntegerRangeType::fromInterval(0, 65535), new StringType(), $this->createComponentsArray(\false)]; $this->allComponentsTogetherType = TypeCombinator::union(...$returnTypes); } return $this->allComponentsTogetherType; } private function createComponentsArray(bool $urlIsLowercase) : Type { $builder = ConstantArrayTypeBuilder::createEmpty(); if ($urlIsLowercase) { if ($this->componentTypesPairedStringsForLowercaseString === null) { throw new ShouldNotHappenException(); } foreach ($this->componentTypesPairedStringsForLowercaseString as $componentName => $componentValueType) { $builder->setOffsetValueType(new ConstantStringType($componentName), $componentValueType, \true); } } else { if ($this->componentTypesPairedStrings === null) { throw new ShouldNotHappenException(); } foreach ($this->componentTypesPairedStrings as $componentName => $componentValueType) { $builder->setOffsetValueType(new ConstantStringType($componentName), $componentValueType, \true); } } return $builder->getArray(); } private function cacheReturnTypes() : void { if ($this->componentTypesPairedConstants !== null) { return; } $string = new StringType(); $lowercaseString = new IntersectionType([new StringType(), new AccessoryLowercaseStringType()]); $port = IntegerRangeType::fromInterval(0, 65535); $false = new ConstantBooleanType(\false); $null = new NullType(); $stringOrFalseOrNull = TypeCombinator::union($string, $false, $null); $lowercaseStringOrFalseOrNull = TypeCombinator::union($lowercaseString, $false, $null); $portOrFalseOrNull = TypeCombinator::union($port, $false, $null); $this->componentTypesPairedConstants = [PHP_URL_SCHEME => $stringOrFalseOrNull, PHP_URL_HOST => $stringOrFalseOrNull, PHP_URL_PORT => $portOrFalseOrNull, PHP_URL_USER => $stringOrFalseOrNull, PHP_URL_PASS => $stringOrFalseOrNull, PHP_URL_PATH => $stringOrFalseOrNull, PHP_URL_QUERY => $stringOrFalseOrNull, PHP_URL_FRAGMENT => $stringOrFalseOrNull]; $this->componentTypesPairedConstantsForLowercaseString = [PHP_URL_SCHEME => $lowercaseStringOrFalseOrNull, PHP_URL_HOST => $lowercaseStringOrFalseOrNull, PHP_URL_PORT => $portOrFalseOrNull, PHP_URL_USER => $lowercaseStringOrFalseOrNull, PHP_URL_PASS => $lowercaseStringOrFalseOrNull, PHP_URL_PATH => $lowercaseStringOrFalseOrNull, PHP_URL_QUERY => $lowercaseStringOrFalseOrNull, PHP_URL_FRAGMENT => $lowercaseStringOrFalseOrNull]; $this->componentTypesPairedStrings = ['scheme' => $string, 'host' => $string, 'port' => $port, 'user' => $string, 'pass' => $string, 'path' => $string, 'query' => $string, 'fragment' => $string]; $this->componentTypesPairedStringsForLowercaseString = ['scheme' => $lowercaseString, 'host' => $lowercaseString, 'port' => $port, 'user' => $lowercaseString, 'pass' => $lowercaseString, 'path' => $lowercaseString, 'query' => $lowercaseString, 'fragment' => $lowercaseString]; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\ArrayType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\IntegerType; use PHPStan\Type\StringType; use PHPStan\Type\Type; final class MbConvertEncodingFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'mb_convert_encoding'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (!isset($functionCall->getArgs()[0])) { return null; } $argType = $scope->getType($functionCall->getArgs()[0]->value); $isString = $argType->isString(); $isArray = $argType->isArray(); $compare = $isString->compareTo($isArray); if ($compare === $isString) { return new StringType(); } elseif ($compare === $isArray) { return new ArrayType(new IntegerType(), new StringType()); } return null; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\ShouldNotHappenException; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\ErrorType; use PHPStan\Type\FloatType; use PHPStan\Type\IntegerType; use PHPStan\Type\NullType; use PHPStan\Type\Type; use function count; use function in_array; final class StrvalFamilyFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { private const FUNCTIONS = ['strval', 'intval', 'boolval', 'floatval', 'doubleval']; public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return in_array($functionReflection->getName(), self::FUNCTIONS, \true); } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : Type { if (count($functionCall->getArgs()) === 0) { return new NullType(); } $argType = $scope->getType($functionCall->getArgs()[0]->value); switch ($functionReflection->getName()) { case 'strval': return $argType->toString(); case 'intval': $type = $argType->toInteger(); return $type instanceof ErrorType ? new IntegerType() : $type; case 'boolval': return $argType->toBoolean(); case 'floatval': case 'doubleval': $type = $argType->toFloat(); return $type instanceof ErrorType ? new FloatType() : $type; default: throw new ShouldNotHappenException(); } } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\TrinaryLogic; use PHPStan\Type\Constant\ConstantArrayType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\FloatType; use PHPStan\Type\IntegerType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\TypeUtils; use function count; final class HrtimeFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'hrtime'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : Type { $arrayType = new ConstantArrayType([new ConstantIntegerType(0), new ConstantIntegerType(1)], [new IntegerType(), new IntegerType()], [2], [], TrinaryLogic::createYes()); $numberType = TypeUtils::toBenevolentUnion(TypeCombinator::union(new IntegerType(), new FloatType())); if (count($functionCall->getArgs()) < 1) { return $arrayType; } $argType = $scope->getType($functionCall->getArgs()[0]->value); $isTrueType = $argType->isTrue(); $isFalseType = $argType->isFalse(); $compareTypes = $isTrueType->compareTo($isFalseType); if ($compareTypes === $isTrueType) { return $numberType; } if ($compareTypes === $isFalseType) { return $arrayType; } return TypeCombinator::union($arrayType, $numberType); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\ClassStringType; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\Enum\EnumCaseObjectType; use PHPStan\Type\Generic\GenericClassStringType; use PHPStan\Type\Generic\TemplateType; use PHPStan\Type\IntersectionType; use PHPStan\Type\MixedType; use PHPStan\Type\ObjectType; use PHPStan\Type\ObjectWithoutClassType; use PHPStan\Type\StaticType; use PHPStan\Type\Type; use PHPStan\Type\TypeTraverser; use PHPStan\Type\TypeUtils; use PHPStan\Type\UnionType; use function count; final class GetClassDynamicReturnTypeExtension implements DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'get_class'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : Type { $args = $functionCall->getArgs(); if (count($args) === 0) { if ($scope->isInTrait()) { return new ClassStringType(); } if ($scope->isInClass()) { return new ConstantStringType($scope->getClassReflection()->getName(), \true); } return new ConstantBooleanType(\false); } $argType = $scope->getType($args[0]->value); if ($scope->isInTrait() && TypeUtils::findThisType($argType) !== null) { return new ClassStringType(); } return TypeTraverser::map($argType, static function (Type $type, callable $traverse) : Type { if ($type instanceof UnionType || $type instanceof IntersectionType) { return $traverse($type); } if ($type instanceof EnumCaseObjectType) { return new GenericClassStringType(new ObjectType($type->getClassName())); } $objectClassNames = $type->getObjectClassNames(); if ($type instanceof TemplateType && $objectClassNames === []) { if ($type instanceof ObjectWithoutClassType) { return new GenericClassStringType($type); } return new UnionType([new GenericClassStringType($type), new ConstantBooleanType(\false)]); } elseif ($type instanceof MixedType) { return new UnionType([new ClassStringType(), new ConstantBooleanType(\false)]); } elseif ($type instanceof StaticType) { return new GenericClassStringType($type->getStaticObjectType()); } elseif ($objectClassNames !== []) { return new GenericClassStringType($type); } elseif ($type instanceof ObjectWithoutClassType) { return new ClassStringType(); } return new ConstantBooleanType(\false); }); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PHPStan\Type\Accessory\AccessoryNonEmptyStringType; use PHPStan\Type\Accessory\AccessoryNonFalsyStringType; use PHPStan\Type\Accessory\AccessoryNumericStringType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\IntersectionType; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\UnionType; use function count; use function date; use function is_numeric; use function str_pad; use const STR_PAD_LEFT; final class DateFunctionReturnTypeHelper { public function getTypeFromFormatType(Type $formatType, bool $useMicrosec) : Type { $types = []; foreach ($formatType->getConstantStrings() as $formatString) { $types[] = $this->buildReturnTypeFromFormat($formatString->getValue(), $useMicrosec); } if (count($types) === 0) { $types[] = $formatType->isNonEmptyString()->yes() ? new IntersectionType([new StringType(), new AccessoryNonEmptyStringType()]) : new StringType(); } $type = TypeCombinator::union(...$types); if ($type->isNumericString()->no() && $formatType->isNonEmptyString()->yes()) { $type = TypeCombinator::union($type, new IntersectionType([new StringType(), new AccessoryNonEmptyStringType()])); } return $type; } public function buildReturnTypeFromFormat(string $formatString, bool $useMicrosec) : Type { // see see https://www.php.net/manual/en/datetime.format.php switch ($formatString) { case 'd': return $this->buildNumericRangeType(1, 31, \true); case 'j': return $this->buildNumericRangeType(1, 31, \false); case 'N': return $this->buildNumericRangeType(1, 7, \false); case 'w': return $this->buildNumericRangeType(0, 6, \false); case 'm': return $this->buildNumericRangeType(1, 12, \true); case 'n': return $this->buildNumericRangeType(1, 12, \false); case 't': return $this->buildNumericRangeType(28, 31, \false); case 'L': return $this->buildNumericRangeType(0, 1, \false); case 'g': return $this->buildNumericRangeType(1, 12, \false); case 'G': return $this->buildNumericRangeType(0, 23, \false); case 'h': return $this->buildNumericRangeType(1, 12, \true); case 'H': return $this->buildNumericRangeType(0, 23, \true); case 'I': return $this->buildNumericRangeType(0, 1, \false); case 'u': return $useMicrosec ? new IntersectionType([new StringType(), new AccessoryNonFalsyStringType()]) : new ConstantStringType('000000'); } $date = date($formatString); // If parameter string is not included, returned as ConstantStringType if ($date === $formatString) { return new ConstantStringType($date); } if (is_numeric($date)) { return new IntersectionType([new StringType(), new AccessoryNumericStringType()]); } return new IntersectionType([new StringType(), new AccessoryNonFalsyStringType()]); } private function buildNumericRangeType(int $min, int $max, bool $zeroPad) : Type { $types = []; for ($i = $min; $i <= $max; $i++) { $string = (string) $i; if ($zeroPad) { $string = str_pad($string, 2, '0', STR_PAD_LEFT); } $types[] = new ConstantStringType($string); } return new UnionType($types); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\Accessory\AccessoryArrayListType; use PHPStan\Type\Accessory\NonEmptyArrayType; use PHPStan\Type\ArrayType; use PHPStan\Type\Constant\ConstantArrayTypeBuilder; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\IntegerRangeType; use PHPStan\Type\IntegerType; use PHPStan\Type\NeverType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use function count; final class ArrayFillFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension { /** * @var PhpVersion */ private $phpVersion; private const MAX_SIZE_USE_CONSTANT_ARRAY = 100; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; } public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return $functionReflection->getName() === 'array_fill'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (count($functionCall->getArgs()) < 3) { return null; } $numberType = $scope->getType($functionCall->getArgs()[1]->value); $isValidNumberType = IntegerRangeType::fromInterval(0, null)->isSuperTypeOf($numberType); // check against negative-int, which is not allowed if ($isValidNumberType->no()) { if ($this->phpVersion->throwsValueErrorForInternalFunctions()) { return new NeverType(); } return new ConstantBooleanType(\false); } $startIndexType = $scope->getType($functionCall->getArgs()[0]->value); $valueType = $scope->getType($functionCall->getArgs()[2]->value); if ($startIndexType instanceof ConstantIntegerType && $numberType instanceof ConstantIntegerType && $numberType->getValue() <= self::MAX_SIZE_USE_CONSTANT_ARRAY) { $arrayBuilder = ConstantArrayTypeBuilder::createEmpty(); $nextIndex = $startIndexType->getValue(); for ($i = 0; $i < $numberType->getValue(); $i++) { $arrayBuilder->setOffsetValueType(new ConstantIntegerType($nextIndex), $valueType); if ($nextIndex < 0) { $nextIndex = 0; } else { $nextIndex++; } } return $arrayBuilder->getArray(); } $resultType = new ArrayType(new IntegerType(), $valueType); if ((new ConstantIntegerType(0))->isSuperTypeOf($startIndexType)->yes()) { $resultType = AccessoryArrayListType::intersectWith($resultType); } if (IntegerRangeType::fromInterval(1, null)->isSuperTypeOf($numberType)->yes()) { $resultType = TypeCombinator::intersect($resultType, new NonEmptyArrayType()); } if (!$isValidNumberType->yes() && !$this->phpVersion->throwsValueErrorForInternalFunctions()) { $resultType = TypeCombinator::union($resultType, new ConstantBooleanType(\false)); } return $resultType; } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\MethodCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\MethodReflection; use PHPStan\Type\BenevolentUnionType; use PHPStan\Type\DynamicMethodReturnTypeExtension; use PHPStan\Type\ErrorType; use PHPStan\Type\IntegerType; use PHPStan\Type\ObjectType; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use Throwable; use function count; use function in_array; use function strtolower; final class ThrowableReturnTypeExtension implements DynamicMethodReturnTypeExtension { public function getClass() : string { return Throwable::class; } public function isMethodSupported(MethodReflection $methodReflection) : bool { return $methodReflection->getName() === 'getCode'; } public function getTypeFromMethodCall(MethodReflection $methodReflection, MethodCall $methodCall, Scope $scope) : Type { $type = $scope->getType($methodCall->var); $types = []; $pdoException = new ObjectType('PDOException'); foreach ($type->getObjectClassNames() as $class) { $classType = new ObjectType($class); if ($classType->getClassReflection() !== null) { $classReflection = $classType->getClassReflection(); foreach ($classReflection->getMethodTags() as $methodName => $methodTag) { if (strtolower($methodName) !== 'getcode') { continue; } $types[] = $methodTag->getReturnType(); continue 2; } } if ($pdoException->isSuperTypeOf($classType)->yes()) { $types[] = new BenevolentUnionType([new IntegerType(), new StringType()]); continue; } if (in_array(strtolower($class), ['throwable', 'exception', 'runtimeexception'], \true)) { $types[] = new BenevolentUnionType([new IntegerType(), new StringType()]); continue; } $types[] = new IntegerType(); } if (count($types) === 0) { return new ErrorType(); } return TypeCombinator::union(...$types); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Php\PhpVersion; use PHPStan\Reflection\FunctionReflection; use PHPStan\Type\DynamicFunctionReturnTypeExtension; use PHPStan\Type\NeverType; use PHPStan\Type\NullType; use PHPStan\Type\Type; use function count; use function strtolower; final class ArrayKeysFunctionDynamicReturnTypeExtension implements DynamicFunctionReturnTypeExtension { /** * @var PhpVersion */ private $phpVersion; public function __construct(PhpVersion $phpVersion) { $this->phpVersion = $phpVersion; } public function isFunctionSupported(FunctionReflection $functionReflection) : bool { return strtolower($functionReflection->getName()) === 'array_keys'; } public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?Type { if (count($functionCall->getArgs()) !== 1) { return null; } $arrayType = $scope->getType($functionCall->getArgs()[0]->value); if ($arrayType->isArray()->no()) { return $this->phpVersion->arrayFunctionsReturnNullWithNonArray() ? new NullType() : new NeverType(); } return $arrayType->getKeysArray(); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\ParameterReflection; use PHPStan\Type\Accessory\AccessoryLowercaseStringType; use PHPStan\Type\Accessory\AccessoryUppercaseStringType; use PHPStan\Type\ArrayType; use PHPStan\Type\FunctionParameterOutTypeExtension; use PHPStan\Type\IntegerType; use PHPStan\Type\IntersectionType; use PHPStan\Type\MixedType; use PHPStan\Type\StringType; use PHPStan\Type\Type; use PHPStan\Type\UnionType; use function count; use function in_array; use function strtolower; final class ParseStrParameterOutTypeExtension implements FunctionParameterOutTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection, ParameterReflection $parameter) : bool { return in_array(strtolower($functionReflection->getName()), ['parse_str', 'mb_parse_str'], \true) && $parameter->getName() === 'result'; } public function getParameterOutTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $funcCall, ParameterReflection $parameter, Scope $scope) : ?Type { $args = $funcCall->getArgs(); if (count($args) < 1) { return null; } $stringType = $scope->getType($args[0]->value); $accessory = []; if ($stringType->isLowercaseString()->yes()) { $accessory[] = new AccessoryLowercaseStringType(); } if ($stringType->isUppercaseString()->yes()) { $accessory[] = new AccessoryUppercaseStringType(); } if (count($accessory) > 0) { $accessory[] = new StringType(); $valueType = new IntersectionType($accessory); } else { $valueType = new StringType(); } return new ArrayType(new UnionType([new StringType(), new IntegerType()]), new UnionType([new ArrayType(new MixedType(), new MixedType(\true)), $valueType])); } } <?php declare (strict_types=1); namespace PHPStan\Type\Php; use PHPStan\Type\ClassStringType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\Generic\GenericClassStringType; use PHPStan\Type\IntersectionType; use PHPStan\Type\NeverType; use PHPStan\Type\ObjectType; use PHPStan\Type\ObjectWithoutClassType; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\TypeTraverser; use PHPStan\Type\UnionType; use function array_unique; use function array_values; final class IsAFunctionTypeSpecifyingHelper { public function determineType(Type $objectOrClassType, Type $classType, bool $allowString, bool $allowSameClass) : Type { $objectOrClassTypeClassNames = $objectOrClassType->getObjectClassNames(); if ($allowString) { foreach ($objectOrClassType->getConstantStrings() as $constantString) { $objectOrClassTypeClassNames[] = $constantString->getValue(); } $objectOrClassTypeClassNames = array_values(array_unique($objectOrClassTypeClassNames)); } return TypeTraverser::map($classType, static function (Type $type, callable $traverse) use($objectOrClassTypeClassNames, $allowString, $allowSameClass) : Type { if ($type instanceof UnionType || $type instanceof IntersectionType) { return $traverse($type); } if ($type instanceof ConstantStringType) { if (!$allowSameClass && $objectOrClassTypeClassNames === [$type->getValue()]) { return new NeverType(); } if ($allowString) { return TypeCombinator::union(new ObjectType($type->getValue()), new GenericClassStringType(new ObjectType($type->getValue()))); } return new ObjectType($type->getValue()); } if ($type instanceof GenericClassStringType) { if ($allowString) { return TypeCombinator::union($type->getGenericType(), $type); } return $type->getGenericType(); } if ($allowString) { return TypeCombinator::union(new ObjectWithoutClassType(), new ClassStringType()); } return new ObjectWithoutClassType(); }); } } <?php declare (strict_types=1); namespace PHPStan\Type; interface SubtractableType extends \PHPStan\Type\Type { public function subtract(\PHPStan\Type\Type $type) : \PHPStan\Type\Type; public function getTypeWithoutSubtractedType() : \PHPStan\Type\Type; public function changeSubtractedType(?\PHPStan\Type\Type $subtractedType) : \PHPStan\Type\Type; public function getSubtractedType() : ?\PHPStan\Type\Type; } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\Broker\Broker; use PHPStan\Reflection\BrokerAwareExtension; use PHPStan\Reflection\ReflectionProvider; use function array_merge; use function strtolower; final class DynamicReturnTypeExtensionRegistry { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var DynamicMethodReturnTypeExtension[] */ private $dynamicMethodReturnTypeExtensions; /** * @var DynamicStaticMethodReturnTypeExtension[] */ private $dynamicStaticMethodReturnTypeExtensions; /** * @var DynamicFunctionReturnTypeExtension[] */ private $dynamicFunctionReturnTypeExtensions; /** @var DynamicMethodReturnTypeExtension[][]|null */ private $dynamicMethodReturnTypeExtensionsByClass = null; /** @var DynamicStaticMethodReturnTypeExtension[][]|null */ private $dynamicStaticMethodReturnTypeExtensionsByClass = null; /** * @param DynamicMethodReturnTypeExtension[] $dynamicMethodReturnTypeExtensions * @param DynamicStaticMethodReturnTypeExtension[] $dynamicStaticMethodReturnTypeExtensions * @param DynamicFunctionReturnTypeExtension[] $dynamicFunctionReturnTypeExtensions */ public function __construct(Broker $broker, ReflectionProvider $reflectionProvider, array $dynamicMethodReturnTypeExtensions, array $dynamicStaticMethodReturnTypeExtensions, array $dynamicFunctionReturnTypeExtensions) { $this->reflectionProvider = $reflectionProvider; $this->dynamicMethodReturnTypeExtensions = $dynamicMethodReturnTypeExtensions; $this->dynamicStaticMethodReturnTypeExtensions = $dynamicStaticMethodReturnTypeExtensions; $this->dynamicFunctionReturnTypeExtensions = $dynamicFunctionReturnTypeExtensions; foreach (array_merge($dynamicMethodReturnTypeExtensions, $dynamicStaticMethodReturnTypeExtensions, $dynamicFunctionReturnTypeExtensions) as $extension) { if (!$extension instanceof BrokerAwareExtension) { continue; } $extension->setBroker($broker); } } /** * @return DynamicMethodReturnTypeExtension[] */ public function getDynamicMethodReturnTypeExtensionsForClass(string $className) : array { if ($this->dynamicMethodReturnTypeExtensionsByClass === null) { $byClass = []; foreach ($this->dynamicMethodReturnTypeExtensions as $extension) { $byClass[strtolower($extension->getClass())][] = $extension; } $this->dynamicMethodReturnTypeExtensionsByClass = $byClass; } return $this->getDynamicExtensionsForType($this->dynamicMethodReturnTypeExtensionsByClass, $className); } /** * @return DynamicStaticMethodReturnTypeExtension[] */ public function getDynamicStaticMethodReturnTypeExtensionsForClass(string $className) : array { if ($this->dynamicStaticMethodReturnTypeExtensionsByClass === null) { $byClass = []; foreach ($this->dynamicStaticMethodReturnTypeExtensions as $extension) { $byClass[strtolower($extension->getClass())][] = $extension; } $this->dynamicStaticMethodReturnTypeExtensionsByClass = $byClass; } return $this->getDynamicExtensionsForType($this->dynamicStaticMethodReturnTypeExtensionsByClass, $className); } /** * @param DynamicMethodReturnTypeExtension[][]|DynamicStaticMethodReturnTypeExtension[][] $extensions * @return mixed[] */ private function getDynamicExtensionsForType(array $extensions, string $className) : array { if (!$this->reflectionProvider->hasClass($className)) { return []; } $extensionsForClass = [[]]; $class = $this->reflectionProvider->getClass($className); foreach (array_merge([$className], $class->getParentClassesNames(), $class->getNativeReflection()->getInterfaceNames()) as $extensionClassName) { $extensionClassName = strtolower($extensionClassName); if (!isset($extensions[$extensionClassName])) { continue; } $extensionsForClass[] = $extensions[$extensionClassName]; } return array_merge(...$extensionsForClass); } /** * @return DynamicFunctionReturnTypeExtension[] */ public function getDynamicFunctionReturnTypeExtensions() : array { return $this->dynamicFunctionReturnTypeExtensions; } } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\TrinaryLogic; /** @api */ interface CompoundType extends \PHPStan\Type\Type { public function isSubTypeOf(\PHPStan\Type\Type $otherType) : TrinaryLogic; /** * This is like isSubTypeOf() but gives reasons * why the type was not/might not be accepted in some non-intuitive scenarios. * * In PHPStan 2.0 this method will be removed and the return type of isSubTypeOf() * will change to IsSuperTypeOfResult. */ public function isSubTypeOfWithReason(\PHPStan\Type\Type $otherType) : \PHPStan\Type\IsSuperTypeOfResult; public function isAcceptedBy(\PHPStan\Type\Type $acceptingType, bool $strictTypes) : TrinaryLogic; public function isAcceptedWithReasonBy(\PHPStan\Type\Type $acceptingType, bool $strictTypes) : \PHPStan\Type\AcceptsResult; public function isGreaterThan(\PHPStan\Type\Type $otherType) : TrinaryLogic; public function isGreaterThanOrEqual(\PHPStan\Type\Type $otherType) : TrinaryLogic; } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\Reflection\ClassReflection; /** @api */ interface TypeWithClassName extends \PHPStan\Type\Type { public function getClassName() : string; public function getAncestorWithClassName(string $className) : ?self; public function getClassReflection() : ?ClassReflection; } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\Reflection\Callables\CallableParametersAcceptor; use PHPStan\TrinaryLogic; use function array_key_exists; use function array_merge; use function count; use function sprintf; final class CallableTypeHelper { public static function isParametersAcceptorSuperTypeOf(CallableParametersAcceptor $ours, CallableParametersAcceptor $theirs, bool $treatMixedAsAny) : \PHPStan\Type\IsSuperTypeOfResult { $theirParameters = $theirs->getParameters(); $ourParameters = $ours->getParameters(); $lastParameter = null; foreach ($theirParameters as $theirParameter) { $lastParameter = $theirParameter; } $theirParameterCount = count($theirParameters); $ourParameterCount = count($ourParameters); if ($lastParameter !== null && $lastParameter->isVariadic() && $theirParameterCount < $ourParameterCount) { foreach ($ourParameters as $i => $ourParameter) { if (array_key_exists($i, $theirParameters)) { continue; } $theirParameters[] = $lastParameter; } } $result = \PHPStan\Type\IsSuperTypeOfResult::createYes(); foreach ($theirParameters as $i => $theirParameter) { $parameterDescription = $theirParameter->getName() === '' ? sprintf('#%d', $i + 1) : sprintf('#%d $%s', $i + 1, $theirParameter->getName()); if (!isset($ourParameters[$i])) { if ($theirParameter->isOptional()) { continue; } $accepts = new \PHPStan\Type\IsSuperTypeOfResult(TrinaryLogic::createNo(), [sprintf('Parameter %s of passed callable is required but accepting callable does not have that parameter. It will be called without it.', $parameterDescription)]); $result = $result->and($accepts); continue; } $ourParameter = $ourParameters[$i]; $ourParameterType = $ourParameter->getType(); if ($ourParameter->isOptional() && !$theirParameter->isOptional()) { $accepts = new \PHPStan\Type\IsSuperTypeOfResult(TrinaryLogic::createNo(), [sprintf('Parameter %s of passed callable is required but the parameter of accepting callable is optional. It might be called without it.', $parameterDescription)]); $result = $result->and($accepts); } if ($treatMixedAsAny) { $isSuperType = $theirParameter->getType()->acceptsWithReason($ourParameterType, \true); $isSuperType = new \PHPStan\Type\IsSuperTypeOfResult($isSuperType->result, $isSuperType->reasons); } else { $isSuperType = $theirParameter->getType()->isSuperTypeOfWithReason($ourParameterType); } if ($isSuperType->maybe()) { $verbosity = \PHPStan\Type\VerbosityLevel::getRecommendedLevelByType($theirParameter->getType(), $ourParameterType); $isSuperType = new \PHPStan\Type\IsSuperTypeOfResult($isSuperType->result, array_merge($isSuperType->reasons, [sprintf('Type %s of parameter %s of passed callable needs to be same or wider than parameter type %s of accepting callable.', $theirParameter->getType()->describe($verbosity), $parameterDescription, $ourParameterType->describe($verbosity))])); } $result = $result->and($isSuperType); } if (!$treatMixedAsAny && $theirParameterCount < $ourParameterCount) { $result = $result->and(\PHPStan\Type\IsSuperTypeOfResult::createMaybe()); } $theirReturnType = $theirs->getReturnType(); if ($treatMixedAsAny) { $isReturnTypeSuperType = $ours->getReturnType()->acceptsWithReason($theirReturnType, \true); $isReturnTypeSuperType = new \PHPStan\Type\IsSuperTypeOfResult($isReturnTypeSuperType->result, $isReturnTypeSuperType->reasons); } else { $isReturnTypeSuperType = $ours->getReturnType()->isSuperTypeOfWithReason($theirReturnType); } $pure = $ours->isPure(); if ($pure->yes()) { $result = $result->and(new \PHPStan\Type\IsSuperTypeOfResult($theirs->isPure(), [])); } elseif ($pure->no()) { $result = $result->and(new \PHPStan\Type\IsSuperTypeOfResult($theirs->isPure()->negate(), [])); } return $result->and($isReturnTypeSuperType); } } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\Type\Accessory\AccessoryArrayListType; use PHPStan\Type\Accessory\AccessoryLowercaseStringType; use PHPStan\Type\Accessory\AccessoryNonEmptyStringType; use PHPStan\Type\Accessory\AccessoryType; use PHPStan\Type\Accessory\AccessoryUppercaseStringType; use PHPStan\Type\Accessory\HasOffsetType; use PHPStan\Type\Accessory\HasOffsetValueType; use PHPStan\Type\Accessory\HasPropertyType; use PHPStan\Type\Accessory\NonEmptyArrayType; use PHPStan\Type\Accessory\OversizedArrayType; use PHPStan\Type\Constant\ConstantArrayType; use PHPStan\Type\Constant\ConstantArrayTypeBuilder; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Constant\ConstantFloatType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\Generic\GenericClassStringType; use PHPStan\Type\Generic\TemplateArrayType; use PHPStan\Type\Generic\TemplateBenevolentUnionType; use PHPStan\Type\Generic\TemplateType; use PHPStan\Type\Generic\TemplateTypeFactory; use PHPStan\Type\Generic\TemplateUnionType; use function array_key_exists; use function array_key_first; use function array_map; use function array_merge; use function array_slice; use function array_splice; use function array_values; use function count; use function get_class; use function is_int; use function md5; use function sprintf; use function usort; /** * @api * @final */ class TypeCombinator { public static function addNull(\PHPStan\Type\Type $type) : \PHPStan\Type\Type { $nullType = new \PHPStan\Type\NullType(); if ($nullType->isSuperTypeOf($type)->no()) { return self::union($type, $nullType); } return $type; } public static function remove(\PHPStan\Type\Type $fromType, \PHPStan\Type\Type $typeToRemove) : \PHPStan\Type\Type { if ($typeToRemove instanceof \PHPStan\Type\UnionType) { foreach ($typeToRemove->getTypes() as $unionTypeToRemove) { $fromType = self::remove($fromType, $unionTypeToRemove); } return $fromType; } $isSuperType = $typeToRemove->isSuperTypeOf($fromType); if ($isSuperType->yes()) { return new \PHPStan\Type\NeverType(); } if ($isSuperType->no()) { return $fromType; } if ($typeToRemove instanceof \PHPStan\Type\MixedType) { $typeToRemoveSubtractedType = $typeToRemove->getSubtractedType(); if ($typeToRemoveSubtractedType !== null) { return self::intersect($fromType, $typeToRemoveSubtractedType); } } $removed = $fromType->tryRemove($typeToRemove); if ($removed !== null) { return $removed; } $fromFiniteTypes = $fromType->getFiniteTypes(); if (count($fromFiniteTypes) > 0) { $finiteTypesToRemove = $typeToRemove->getFiniteTypes(); if (count($finiteTypesToRemove) === 1) { $result = []; foreach ($fromFiniteTypes as $finiteType) { if ($finiteType->equals($finiteTypesToRemove[0])) { continue; } $result[] = $finiteType; } if (count($result) === count($fromFiniteTypes)) { return $fromType; } if (count($result) === 0) { return new \PHPStan\Type\NeverType(); } if (count($result) === 1) { return $result[0]; } return new \PHPStan\Type\UnionType($result); } } return $fromType; } public static function removeNull(\PHPStan\Type\Type $type) : \PHPStan\Type\Type { if (self::containsNull($type)) { return self::remove($type, new \PHPStan\Type\NullType()); } return $type; } public static function containsNull(\PHPStan\Type\Type $type) : bool { if ($type instanceof \PHPStan\Type\UnionType) { foreach ($type->getTypes() as $innerType) { if ($innerType instanceof \PHPStan\Type\NullType) { return \true; } } return \false; } return $type instanceof \PHPStan\Type\NullType; } public static function union(\PHPStan\Type\Type ...$types) : \PHPStan\Type\Type { $typesCount = count($types); if ($typesCount === 0) { return new \PHPStan\Type\NeverType(); } $benevolentTypes = []; $benevolentUnionObject = null; // transform A | (B | C) to A | B | C for ($i = 0; $i < $typesCount; $i++) { if ($types[$i] instanceof \PHPStan\Type\BenevolentUnionType) { if ($types[$i] instanceof TemplateBenevolentUnionType && $benevolentUnionObject === null) { $benevolentUnionObject = $types[$i]; } $benevolentTypesCount = 0; $typesInner = $types[$i]->getTypes(); foreach ($typesInner as $benevolentInnerType) { $benevolentTypesCount++; $benevolentTypes[$benevolentInnerType->describe(\PHPStan\Type\VerbosityLevel::value())] = $benevolentInnerType; } array_splice($types, $i, 1, $typesInner); $typesCount += $benevolentTypesCount - 1; continue; } if (!$types[$i] instanceof \PHPStan\Type\UnionType) { continue; } if ($types[$i] instanceof TemplateType) { continue; } $typesInner = $types[$i]->getTypes(); array_splice($types, $i, 1, $typesInner); $typesCount += count($typesInner) - 1; } if ($typesCount === 1) { return $types[0]; } $arrayTypes = []; $scalarTypes = []; $hasGenericScalarTypes = []; $enumCaseTypes = []; for ($i = 0; $i < $typesCount; $i++) { if ($types[$i] instanceof \PHPStan\Type\ConstantScalarType) { $type = $types[$i]; $scalarTypes[get_class($type)][md5($type->describe(\PHPStan\Type\VerbosityLevel::cache()))] = $type; unset($types[$i]); continue; } if ($types[$i] instanceof \PHPStan\Type\BooleanType) { $hasGenericScalarTypes[ConstantBooleanType::class] = \true; } if ($types[$i] instanceof \PHPStan\Type\FloatType) { $hasGenericScalarTypes[ConstantFloatType::class] = \true; } if ($types[$i] instanceof \PHPStan\Type\IntegerType && !$types[$i] instanceof \PHPStan\Type\IntegerRangeType) { $hasGenericScalarTypes[ConstantIntegerType::class] = \true; } if ($types[$i] instanceof \PHPStan\Type\StringType && !$types[$i] instanceof \PHPStan\Type\ClassStringType) { $hasGenericScalarTypes[ConstantStringType::class] = \true; } $enumCases = $types[$i]->getEnumCases(); if (count($enumCases) === 1) { $enumCaseTypes[$types[$i]->describe(\PHPStan\Type\VerbosityLevel::cache())] = $types[$i]; unset($types[$i]); continue; } if (!$types[$i]->isArray()->yes()) { continue; } $arrayTypes[] = $types[$i]; unset($types[$i]); } foreach ($scalarTypes as $classType => $scalarTypeItems) { $scalarTypes[$classType] = array_values($scalarTypeItems); } $enumCaseTypes = array_values($enumCaseTypes); $types = array_values($types); $typesCount = count($types); foreach ($scalarTypes as $classType => $scalarTypeItems) { if (isset($hasGenericScalarTypes[$classType])) { unset($scalarTypes[$classType]); continue; } if ($classType === ConstantBooleanType::class && count($scalarTypeItems) === 2) { $types[] = new \PHPStan\Type\BooleanType(); $typesCount++; unset($scalarTypes[$classType]); continue; } $scalarTypeItemsCount = count($scalarTypeItems); for ($i = 0; $i < $typesCount; $i++) { for ($j = 0; $j < $scalarTypeItemsCount; $j++) { $compareResult = self::compareTypesInUnion($types[$i], $scalarTypeItems[$j]); if ($compareResult === null) { continue; } [$a, $b] = $compareResult; if ($a !== null) { $types[$i] = $a; array_splice($scalarTypeItems, $j--, 1); $scalarTypeItemsCount--; continue 1; } if ($b !== null) { $scalarTypeItems[$j] = $b; array_splice($types, $i--, 1); $typesCount--; continue 2; } } } $scalarTypes[$classType] = $scalarTypeItems; } if (count($types) > 16) { $newTypes = []; foreach ($types as $type) { $newTypes[$type->describe(\PHPStan\Type\VerbosityLevel::cache())] = $type; } $types = array_values($newTypes); } $types = array_merge($types, self::processArrayTypes($arrayTypes)); $typesCount = count($types); // transform A | A to A // transform A | never to A for ($i = 0; $i < $typesCount; $i++) { for ($j = $i + 1; $j < $typesCount; $j++) { $compareResult = self::compareTypesInUnion($types[$i], $types[$j]); if ($compareResult === null) { continue; } [$a, $b] = $compareResult; if ($a !== null) { $types[$i] = $a; array_splice($types, $j--, 1); $typesCount--; continue 1; } if ($b !== null) { $types[$j] = $b; array_splice($types, $i--, 1); $typesCount--; continue 2; } } } $enumCasesCount = count($enumCaseTypes); for ($i = 0; $i < $typesCount; $i++) { for ($j = 0; $j < $enumCasesCount; $j++) { $compareResult = self::compareTypesInUnion($types[$i], $enumCaseTypes[$j]); if ($compareResult === null) { continue; } [$a, $b] = $compareResult; if ($a !== null) { $types[$i] = $a; array_splice($enumCaseTypes, $j--, 1); $enumCasesCount--; continue 1; } if ($b !== null) { $enumCaseTypes[$j] = $b; array_splice($types, $i--, 1); $typesCount--; continue 2; } } } foreach ($enumCaseTypes as $enumCaseType) { $types[] = $enumCaseType; $typesCount++; } foreach ($scalarTypes as $scalarTypeItems) { foreach ($scalarTypeItems as $scalarType) { $types[] = $scalarType; $typesCount++; } } if ($typesCount === 0) { return new \PHPStan\Type\NeverType(); } if ($typesCount === 1) { return $types[0]; } if ($benevolentTypes !== []) { $tempTypes = $types; foreach ($tempTypes as $i => $type) { if (!isset($benevolentTypes[$type->describe(\PHPStan\Type\VerbosityLevel::value())])) { break; } unset($tempTypes[$i]); } if ($tempTypes === []) { if ($benevolentUnionObject instanceof TemplateBenevolentUnionType) { return $benevolentUnionObject->withTypes($types); } return new \PHPStan\Type\BenevolentUnionType($types, \true); } } return new \PHPStan\Type\UnionType($types, \true); } /** * @return array{Type, null}|array{null, Type}|null */ private static function compareTypesInUnion(\PHPStan\Type\Type $a, \PHPStan\Type\Type $b) : ?array { if ($a instanceof \PHPStan\Type\IntegerRangeType) { $type = $a->tryUnion($b); if ($type !== null) { $a = $type; return [$a, null]; } } if ($b instanceof \PHPStan\Type\IntegerRangeType) { $type = $b->tryUnion($a); if ($type !== null) { $b = $type; return [null, $b]; } } if ($a instanceof \PHPStan\Type\IntegerRangeType && $b instanceof \PHPStan\Type\IntegerRangeType) { return null; } if ($a instanceof HasOffsetValueType && $b instanceof HasOffsetValueType) { if ($a->getOffsetType()->equals($b->getOffsetType())) { return [new HasOffsetValueType($a->getOffsetType(), self::union($a->getValueType(), $b->getValueType())), null]; } } if ($a->isConstantArray()->yes() && $b->isConstantArray()->yes()) { return null; } // simplify string[] | int[] to (string|int)[] if ($a instanceof \PHPStan\Type\IterableType && $b instanceof \PHPStan\Type\IterableType) { return [new \PHPStan\Type\IterableType(self::union($a->getIterableKeyType(), $b->getIterableKeyType()), self::union($a->getIterableValueType(), $b->getIterableValueType())), null]; } if ($a instanceof \PHPStan\Type\SubtractableType) { $typeWithoutSubtractedTypeA = $a->getTypeWithoutSubtractedType(); if ($typeWithoutSubtractedTypeA instanceof \PHPStan\Type\MixedType && $b instanceof \PHPStan\Type\MixedType) { $isSuperType = $typeWithoutSubtractedTypeA->isSuperTypeOfMixed($b); } else { $isSuperType = $typeWithoutSubtractedTypeA->isSuperTypeOf($b); } if ($isSuperType->yes()) { $a = self::intersectWithSubtractedType($a, $b); return [$a, null]; } } if ($b instanceof \PHPStan\Type\SubtractableType) { $typeWithoutSubtractedTypeB = $b->getTypeWithoutSubtractedType(); if ($typeWithoutSubtractedTypeB instanceof \PHPStan\Type\MixedType && $a instanceof \PHPStan\Type\MixedType) { $isSuperType = $typeWithoutSubtractedTypeB->isSuperTypeOfMixed($a); } else { $isSuperType = $typeWithoutSubtractedTypeB->isSuperTypeOf($a); } if ($isSuperType->yes()) { $b = self::intersectWithSubtractedType($b, $a); return [null, $b]; } } if ($b->isSuperTypeOf($a)->yes()) { return [null, $b]; } if ($a->isSuperTypeOf($b)->yes()) { return [$a, null]; } if ($a instanceof ConstantStringType && $a->getValue() === '' && ($b->describe(\PHPStan\Type\VerbosityLevel::value()) === 'non-empty-string' || $b->describe(\PHPStan\Type\VerbosityLevel::value()) === 'non-falsy-string')) { return [null, self::intersect(new \PHPStan\Type\StringType(), ...self::getAccessoryCaseStringTypes($b))]; } if ($b instanceof ConstantStringType && $b->getValue() === '' && ($a->describe(\PHPStan\Type\VerbosityLevel::value()) === 'non-empty-string' || $a->describe(\PHPStan\Type\VerbosityLevel::value()) === 'non-falsy-string')) { return [self::intersect(new \PHPStan\Type\StringType(), ...self::getAccessoryCaseStringTypes($a)), null]; } if ($a instanceof ConstantStringType && $a->getValue() === '0' && $b->describe(\PHPStan\Type\VerbosityLevel::value()) === 'non-falsy-string') { return [null, self::intersect(new \PHPStan\Type\StringType(), new AccessoryNonEmptyStringType(), ...self::getAccessoryCaseStringTypes($b))]; } if ($b instanceof ConstantStringType && $b->getValue() === '0' && $a->describe(\PHPStan\Type\VerbosityLevel::value()) === 'non-falsy-string') { return [self::intersect(new \PHPStan\Type\StringType(), new AccessoryNonEmptyStringType(), ...self::getAccessoryCaseStringTypes($a)), null]; } return null; } /** * @return array<Type> */ private static function getAccessoryCaseStringTypes(\PHPStan\Type\Type $type) : array { $accessory = []; if ($type->isLowercaseString()->yes()) { $accessory[] = new AccessoryLowercaseStringType(); } if ($type->isUppercaseString()->yes()) { $accessory[] = new AccessoryUppercaseStringType(); } return $accessory; } private static function unionWithSubtractedType(\PHPStan\Type\Type $type, ?\PHPStan\Type\Type $subtractedType) : \PHPStan\Type\Type { if ($subtractedType === null) { return $type; } if ($type instanceof \PHPStan\Type\SubtractableType) { $subtractedType = $type->getSubtractedType() === null ? $subtractedType : self::union($type->getSubtractedType(), $subtractedType); if ($subtractedType instanceof \PHPStan\Type\NeverType) { $subtractedType = null; } return $type->changeSubtractedType($subtractedType); } if ($subtractedType->isSuperTypeOf($type)->yes()) { return new \PHPStan\Type\NeverType(); } return self::remove($type, $subtractedType); } private static function intersectWithSubtractedType(\PHPStan\Type\SubtractableType $a, \PHPStan\Type\Type $b) : \PHPStan\Type\Type { if ($a->getSubtractedType() === null) { return $a; } if ($b instanceof \PHPStan\Type\IntersectionType) { $subtractableTypes = []; foreach ($b->getTypes() as $innerType) { if (!$innerType instanceof \PHPStan\Type\SubtractableType) { continue; } $subtractableTypes[] = $innerType; } if (count($subtractableTypes) === 0) { return $a->getTypeWithoutSubtractedType(); } $subtractedTypes = []; foreach ($subtractableTypes as $subtractableType) { if ($subtractableType->getSubtractedType() === null) { continue; } $subtractedTypes[] = $subtractableType->getSubtractedType(); } if (count($subtractedTypes) === 0) { return $a->getTypeWithoutSubtractedType(); } $subtractedType = self::union(...$subtractedTypes); } elseif ($b instanceof \PHPStan\Type\SubtractableType) { $subtractedType = $b->getSubtractedType(); if ($subtractedType === null) { return $a->getTypeWithoutSubtractedType(); } } else { $subtractedTypeTmp = self::intersect($a->getTypeWithoutSubtractedType(), $a->getSubtractedType()); if ($b->isSuperTypeOf($subtractedTypeTmp)->yes()) { return $a->getTypeWithoutSubtractedType(); } $subtractedType = new \PHPStan\Type\MixedType(\false, $b); } $subtractedType = self::intersect($a->getSubtractedType(), $subtractedType); if ($subtractedType instanceof \PHPStan\Type\NeverType) { $subtractedType = null; } return $a->changeSubtractedType($subtractedType); } /** * @param Type[] $arrayTypes * @return Type[] */ private static function processArrayAccessoryTypes(array $arrayTypes) : array { $accessoryTypes = []; foreach ($arrayTypes as $i => $arrayType) { if ($arrayType instanceof \PHPStan\Type\IntersectionType) { foreach ($arrayType->getTypes() as $innerType) { if ($innerType instanceof TemplateType) { break; } if (!$innerType instanceof AccessoryType && !$innerType instanceof \PHPStan\Type\CallableType) { continue; } if ($innerType instanceof HasOffsetType) { $offset = $innerType->getOffsetType(); if ($offset instanceof ConstantStringType || $offset instanceof ConstantIntegerType) { $innerType = new HasOffsetValueType($offset, $arrayType->getIterableValueType()); } } if ($innerType instanceof HasOffsetValueType) { $accessoryTypes[sprintf('hasOffsetValue(%s)', $innerType->getOffsetType()->describe(\PHPStan\Type\VerbosityLevel::cache()))][$i] = $innerType; continue; } $accessoryTypes[$innerType->describe(\PHPStan\Type\VerbosityLevel::cache())][$i] = $innerType; } } if (!$arrayType->isConstantArray()->yes()) { continue; } $constantArrays = $arrayType->getConstantArrays(); foreach ($constantArrays as $constantArray) { if ($constantArray->isList()->yes() && AccessoryArrayListType::isListTypeEnabled()) { $list = new AccessoryArrayListType(); $accessoryTypes[$list->describe(\PHPStan\Type\VerbosityLevel::cache())][$i] = $list; } if (!$constantArray->isIterableAtLeastOnce()->yes()) { continue; } $nonEmpty = new NonEmptyArrayType(); $accessoryTypes[$nonEmpty->describe(\PHPStan\Type\VerbosityLevel::cache())][$i] = $nonEmpty; } } $commonAccessoryTypes = []; $arrayTypeCount = count($arrayTypes); foreach ($accessoryTypes as $accessoryType) { if (count($accessoryType) !== $arrayTypeCount) { $firstKey = array_key_first($accessoryType); if ($accessoryType[$firstKey] instanceof OversizedArrayType) { $commonAccessoryTypes[] = $accessoryType[$firstKey]; } continue; } if ($accessoryType[0] instanceof HasOffsetValueType) { $commonAccessoryTypes[] = self::union(...$accessoryType); continue; } $commonAccessoryTypes[] = $accessoryType[0]; } return $commonAccessoryTypes; } /** * @param list<Type> $arrayTypes * @return Type[] */ private static function processArrayTypes(array $arrayTypes) : array { if ($arrayTypes === []) { return []; } $accessoryTypes = self::processArrayAccessoryTypes($arrayTypes); if (count($arrayTypes) === 1) { return [self::intersect(...$arrayTypes, ...$accessoryTypes)]; } $keyTypesForGeneralArray = []; $valueTypesForGeneralArray = []; $generalArrayOccurred = \false; $constantKeyTypesNumbered = []; $filledArrays = 0; $overflowed = \false; /** @var int|float $nextConstantKeyTypeIndex */ $nextConstantKeyTypeIndex = 1; $constantArraysMap = array_map(static function (\PHPStan\Type\Type $t) { return $t->getConstantArrays(); }, $arrayTypes); foreach ($arrayTypes as $arrayIdx => $arrayType) { $constantArrays = $constantArraysMap[$arrayIdx]; $isConstantArray = $constantArrays !== []; if (!$isConstantArray || !$arrayType->isIterableAtLeastOnce()->no()) { $filledArrays++; } if ($generalArrayOccurred || !$isConstantArray) { foreach ($arrayType->getArrays() as $type) { $keyTypesForGeneralArray[] = $type->getIterableKeyType(); $valueTypesForGeneralArray[] = $type->getItemType(); $generalArrayOccurred = \true; } continue; } $constantArrays = $arrayType->getConstantArrays(); foreach ($constantArrays as $constantArray) { foreach ($constantArray->getKeyTypes() as $i => $keyType) { $keyTypesForGeneralArray[] = $keyType; $valueTypesForGeneralArray[] = $constantArray->getValueTypes()[$i]; $keyTypeValue = $keyType->getValue(); if (array_key_exists($keyTypeValue, $constantKeyTypesNumbered)) { continue; } $constantKeyTypesNumbered[$keyTypeValue] = $nextConstantKeyTypeIndex; $nextConstantKeyTypeIndex *= 2; if (!is_int($nextConstantKeyTypeIndex)) { $generalArrayOccurred = \true; $overflowed = \true; continue 2; } } } } if ($generalArrayOccurred && (!$overflowed || $filledArrays > 1)) { $reducedArrayTypes = self::reduceArrays($arrayTypes, \false); if (count($reducedArrayTypes) === 1) { return [self::intersect($reducedArrayTypes[0], ...$accessoryTypes)]; } $scopes = []; $useTemplateArray = \true; foreach ($arrayTypes as $arrayType) { if (!$arrayType instanceof TemplateArrayType) { $useTemplateArray = \false; break; } $scopes[$arrayType->getScope()->describe()] = $arrayType; } $arrayType = new \PHPStan\Type\ArrayType(self::union(...$keyTypesForGeneralArray), self::union(...self::optimizeConstantArrays($valueTypesForGeneralArray))); if ($useTemplateArray && count($scopes) === 1) { $templateArray = array_values($scopes)[0]; $arrayType = new TemplateArrayType($templateArray->getScope(), $templateArray->getStrategy(), $templateArray->getVariance(), $templateArray->getName(), $arrayType, $templateArray->getDefault()); } return [self::intersect($arrayType, ...$accessoryTypes)]; } $reducedArrayTypes = self::reduceArrays($arrayTypes, \true); return array_map(static function (\PHPStan\Type\Type $arrayType) use($accessoryTypes) { return self::intersect($arrayType, ...$accessoryTypes); }, self::optimizeConstantArrays($reducedArrayTypes)); } /** * @param Type[] $types * @return Type[] */ private static function optimizeConstantArrays(array $types) : array { $constantArrayValuesCount = self::countConstantArrayValueTypes($types); if ($constantArrayValuesCount <= ConstantArrayTypeBuilder::ARRAY_COUNT_LIMIT) { return $types; } $results = []; $eachIsOversized = \true; foreach ($types as $type) { $isOversized = \false; $result = \PHPStan\Type\TypeTraverser::map($type, static function (\PHPStan\Type\Type $type, callable $traverse) use(&$isOversized) : \PHPStan\Type\Type { if (!$type instanceof ConstantArrayType) { return $traverse($type); } if ($type->isIterableAtLeastOnce()->no()) { return $type; } $isOversized = \true; $isList = \true; $valueTypes = []; $keyTypes = []; $nextAutoIndex = 0; foreach ($type->getKeyTypes() as $i => $innerKeyType) { if (!$innerKeyType instanceof ConstantIntegerType) { $isList = \false; } elseif ($innerKeyType->getValue() !== $nextAutoIndex) { $isList = \false; $nextAutoIndex = $innerKeyType->getValue() + 1; } else { $nextAutoIndex++; } $generalizedKeyType = $innerKeyType->generalize(\PHPStan\Type\GeneralizePrecision::moreSpecific()); $keyTypes[$generalizedKeyType->describe(\PHPStan\Type\VerbosityLevel::precise())] = $generalizedKeyType; $innerValueType = $type->getValueTypes()[$i]; $generalizedValueType = \PHPStan\Type\TypeTraverser::map($innerValueType, static function (\PHPStan\Type\Type $type) use($traverse) : \PHPStan\Type\Type { if ($type instanceof \PHPStan\Type\ArrayType) { return \PHPStan\Type\TypeCombinator::intersect($type, new OversizedArrayType()); } return $traverse($type); }); $valueTypes[$generalizedValueType->describe(\PHPStan\Type\VerbosityLevel::precise())] = $generalizedValueType; } $keyType = \PHPStan\Type\TypeCombinator::union(...array_values($keyTypes)); $valueType = \PHPStan\Type\TypeCombinator::union(...array_values($valueTypes)); $arrayType = new \PHPStan\Type\ArrayType($keyType, $valueType); if ($isList) { $arrayType = AccessoryArrayListType::intersectWith($arrayType); } return \PHPStan\Type\TypeCombinator::intersect($arrayType, new NonEmptyArrayType(), new OversizedArrayType()); }); if (!$isOversized) { $eachIsOversized = \false; } $results[] = $result; } if ($eachIsOversized) { $eachIsList = \true; $keyTypes = []; $valueTypes = []; foreach ($results as $result) { $keyTypes[] = $result->getIterableKeyType(); $valueTypes[] = $result->getLastIterableValueType(); if ($result->isList()->yes()) { continue; } $eachIsList = \false; } $keyType = self::union(...$keyTypes); $valueType = self::union(...$valueTypes); $arrayType = new \PHPStan\Type\ArrayType($keyType, $valueType); if ($eachIsList) { $arrayType = self::intersect($arrayType, new AccessoryArrayListType()); } return [self::intersect($arrayType, new NonEmptyArrayType(), new OversizedArrayType())]; } return $results; } /** * @param Type[] $types */ public static function countConstantArrayValueTypes(array $types) : int { $constantArrayValuesCount = 0; foreach ($types as $type) { \PHPStan\Type\TypeTraverser::map($type, static function (\PHPStan\Type\Type $type, callable $traverse) use(&$constantArrayValuesCount) : \PHPStan\Type\Type { if ($type instanceof ConstantArrayType) { $constantArrayValuesCount += count($type->getValueTypes()); } return $traverse($type); }); } return $constantArrayValuesCount; } /** * @param list<Type> $constantArrays * @return list<Type> */ private static function reduceArrays(array $constantArrays, bool $preserveTaggedUnions) : array { $newArrays = []; $arraysToProcess = []; $emptyArray = null; foreach ($constantArrays as $constantArray) { if (!$constantArray->isConstantArray()->yes()) { // This is an optimization for current use-case of $preserveTaggedUnions=false, where we need // one constant array as a result, or we generalize the $constantArrays. if (!$preserveTaggedUnions) { return $constantArrays; } $newArrays[] = $constantArray; continue; } if ($constantArray->isIterableAtLeastOnce()->no()) { $emptyArray = $constantArray; continue; } $arraysToProcess = array_merge($arraysToProcess, $constantArray->getConstantArrays()); } if ($emptyArray !== null) { $newArrays[] = $emptyArray; } $arraysToProcessPerKey = []; foreach ($arraysToProcess as $i => $arrayToProcess) { foreach ($arrayToProcess->getKeyTypes() as $keyType) { $arraysToProcessPerKey[$keyType->getValue()][] = $i; } } $eligibleCombinations = []; foreach ($arraysToProcessPerKey as $arrays) { for ($i = 0, $arraysCount = count($arrays); $i < $arraysCount - 1; $i++) { for ($j = $i + 1; $j < $arraysCount; $j++) { $eligibleCombinations[$arrays[$i]][$arrays[$j]] = $eligibleCombinations[$arrays[$i]][$arrays[$j]] ?? 0; $eligibleCombinations[$arrays[$i]][$arrays[$j]]++; } } } foreach ($eligibleCombinations as $i => $other) { if (!array_key_exists($i, $arraysToProcess)) { continue; } foreach ($other as $j => $overlappingKeysCount) { if (!array_key_exists($j, $arraysToProcess)) { continue; } if ($preserveTaggedUnions && $overlappingKeysCount === count($arraysToProcess[$i]->getKeyTypes()) && $arraysToProcess[$j]->isKeysSupersetOf($arraysToProcess[$i])) { $arraysToProcess[$j] = $arraysToProcess[$j]->mergeWith($arraysToProcess[$i]); unset($arraysToProcess[$i]); continue 2; } if ($preserveTaggedUnions && $overlappingKeysCount === count($arraysToProcess[$j]->getKeyTypes()) && $arraysToProcess[$i]->isKeysSupersetOf($arraysToProcess[$j])) { $arraysToProcess[$i] = $arraysToProcess[$i]->mergeWith($arraysToProcess[$j]); unset($arraysToProcess[$j]); continue 1; } if (!$preserveTaggedUnions && $overlappingKeysCount === count($arraysToProcess[$i]->getKeyTypes()) && $overlappingKeysCount === count($arraysToProcess[$j]->getKeyTypes())) { $arraysToProcess[$j] = $arraysToProcess[$j]->mergeWith($arraysToProcess[$i]); unset($arraysToProcess[$i]); continue 2; } } } return array_merge($newArrays, $arraysToProcess); } public static function intersect(\PHPStan\Type\Type ...$types) : \PHPStan\Type\Type { $types = array_values($types); $typesCount = count($types); if ($typesCount === 0) { return new \PHPStan\Type\NeverType(); } if ($typesCount === 1) { return $types[0]; } $sortTypes = static function (\PHPStan\Type\Type $a, \PHPStan\Type\Type $b) : int { if (!$a instanceof \PHPStan\Type\UnionType || !$b instanceof \PHPStan\Type\UnionType) { return 0; } if ($a instanceof TemplateType) { return -1; } if ($b instanceof TemplateType) { return 1; } if ($a instanceof \PHPStan\Type\BenevolentUnionType) { return -1; } if ($b instanceof \PHPStan\Type\BenevolentUnionType) { return 1; } return 0; }; usort($types, $sortTypes); // transform A & (B | C) to (A & B) | (A & C) foreach ($types as $i => $type) { if (!$type instanceof \PHPStan\Type\UnionType) { continue; } $topLevelUnionSubTypes = []; $innerTypes = $type->getTypes(); usort($innerTypes, $sortTypes); $slice1 = array_slice($types, 0, $i); $slice2 = array_slice($types, $i + 1); foreach ($innerTypes as $innerUnionSubType) { $topLevelUnionSubTypes[] = self::intersect($innerUnionSubType, ...$slice1, ...$slice2); } $union = self::union(...$topLevelUnionSubTypes); if ($union instanceof \PHPStan\Type\NeverType) { return $union; } if ($type instanceof \PHPStan\Type\BenevolentUnionType) { $union = \PHPStan\Type\TypeUtils::toBenevolentUnion($union); } if ($type instanceof TemplateUnionType || $type instanceof TemplateBenevolentUnionType) { $union = TemplateTypeFactory::create($type->getScope(), $type->getName(), $union, $type->getVariance(), $type->getStrategy(), $type->getDefault()); } return $union; } $typesCount = count($types); // transform A & (B & C) to A & B & C for ($i = 0; $i < $typesCount; $i++) { $type = $types[$i]; if (!$type instanceof \PHPStan\Type\IntersectionType) { continue; } array_splice($types, $i--, 1, $type->getTypes()); $typesCount = count($types); } $hasOffsetValueTypeCount = 0; $newTypes = []; foreach ($types as $type) { if (!$type instanceof HasOffsetValueType) { $newTypes[] = $type; continue; } $hasOffsetValueTypeCount++; } if ($hasOffsetValueTypeCount > 32) { $newTypes[] = new OversizedArrayType(); $types = $newTypes; $typesCount = count($types); } usort($types, static function (\PHPStan\Type\Type $a, \PHPStan\Type\Type $b) : int { // move subtractables with subtracts before those without to avoid loosing them in the union logic if ($a instanceof \PHPStan\Type\SubtractableType && $a->getSubtractedType() !== null) { return -1; } if ($b instanceof \PHPStan\Type\SubtractableType && $b->getSubtractedType() !== null) { return 1; } if ($a instanceof ConstantArrayType && !$b instanceof ConstantArrayType) { return -1; } if ($b instanceof ConstantArrayType && !$a instanceof ConstantArrayType) { return 1; } return 0; }); // transform IntegerType & ConstantIntegerType to ConstantIntegerType // transform Child & Parent to Child // transform Object & ~null to Object // transform A & A to A // transform int[] & string to never // transform callable & int to never // transform A & ~A to never // transform int & string to never for ($i = 0; $i < $typesCount; $i++) { for ($j = $i + 1; $j < $typesCount; $j++) { if ($types[$j] instanceof \PHPStan\Type\SubtractableType) { $typeWithoutSubtractedTypeA = $types[$j]->getTypeWithoutSubtractedType(); if ($typeWithoutSubtractedTypeA instanceof \PHPStan\Type\MixedType && $types[$i] instanceof \PHPStan\Type\MixedType) { $isSuperTypeSubtractableA = $typeWithoutSubtractedTypeA->isSuperTypeOfMixed($types[$i]); } else { $isSuperTypeSubtractableA = $typeWithoutSubtractedTypeA->isSuperTypeOf($types[$i]); } if ($isSuperTypeSubtractableA->yes()) { $types[$i] = self::unionWithSubtractedType($types[$i], $types[$j]->getSubtractedType()); array_splice($types, $j--, 1); $typesCount--; continue 1; } } if ($types[$i] instanceof \PHPStan\Type\SubtractableType) { $typeWithoutSubtractedTypeB = $types[$i]->getTypeWithoutSubtractedType(); if ($typeWithoutSubtractedTypeB instanceof \PHPStan\Type\MixedType && $types[$j] instanceof \PHPStan\Type\MixedType) { $isSuperTypeSubtractableB = $typeWithoutSubtractedTypeB->isSuperTypeOfMixed($types[$j]); } else { $isSuperTypeSubtractableB = $typeWithoutSubtractedTypeB->isSuperTypeOf($types[$j]); } if ($isSuperTypeSubtractableB->yes()) { $types[$j] = self::unionWithSubtractedType($types[$j], $types[$i]->getSubtractedType()); array_splice($types, $i--, 1); $typesCount--; continue 2; } } if ($types[$i] instanceof \PHPStan\Type\IntegerRangeType) { $intersectionType = $types[$i]->tryIntersect($types[$j]); if ($intersectionType !== null) { $types[$j] = $intersectionType; array_splice($types, $i--, 1); $typesCount--; continue 2; } } if ($types[$j] instanceof \PHPStan\Type\IterableType) { $isSuperTypeA = $types[$j]->isSuperTypeOfMixed($types[$i]); } else { $isSuperTypeA = $types[$j]->isSuperTypeOf($types[$i]); } if ($isSuperTypeA->yes()) { array_splice($types, $j--, 1); $typesCount--; continue; } if ($types[$i] instanceof \PHPStan\Type\IterableType) { $isSuperTypeB = $types[$i]->isSuperTypeOfMixed($types[$j]); } else { $isSuperTypeB = $types[$i]->isSuperTypeOf($types[$j]); } if ($isSuperTypeB->maybe()) { if ($types[$i] instanceof ConstantArrayType && $types[$j] instanceof HasOffsetType) { $types[$i] = $types[$i]->makeOffsetRequired($types[$j]->getOffsetType()); array_splice($types, $j--, 1); $typesCount--; continue; } if ($types[$j] instanceof ConstantArrayType && $types[$i] instanceof HasOffsetType) { $types[$j] = $types[$j]->makeOffsetRequired($types[$i]->getOffsetType()); array_splice($types, $i--, 1); $typesCount--; continue 2; } if ($types[$i] instanceof ConstantArrayType && $types[$j] instanceof HasOffsetValueType) { $offsetType = $types[$j]->getOffsetType(); $valueType = $types[$j]->getValueType(); $newValueType = self::intersect($types[$i]->getOffsetValueType($offsetType), $valueType); if ($newValueType instanceof \PHPStan\Type\NeverType) { return $newValueType; } $types[$i] = $types[$i]->setOffsetValueType($offsetType, $newValueType); array_splice($types, $j--, 1); $typesCount--; continue; } if ($types[$j] instanceof ConstantArrayType && $types[$i] instanceof HasOffsetValueType) { $offsetType = $types[$i]->getOffsetType(); $valueType = $types[$i]->getValueType(); $newValueType = self::intersect($types[$j]->getOffsetValueType($offsetType), $valueType); if ($newValueType instanceof \PHPStan\Type\NeverType) { return $newValueType; } $types[$j] = $types[$j]->setOffsetValueType($offsetType, $newValueType); array_splice($types, $i--, 1); $typesCount--; continue 2; } if ($types[$i] instanceof OversizedArrayType && $types[$j] instanceof HasOffsetValueType) { array_splice($types, $j--, 1); $typesCount--; continue; } if ($types[$j] instanceof OversizedArrayType && $types[$i] instanceof HasOffsetValueType) { array_splice($types, $i--, 1); $typesCount--; continue 2; } if ($types[$i] instanceof \PHPStan\Type\ObjectShapeType && $types[$j] instanceof HasPropertyType) { $types[$i] = $types[$i]->makePropertyRequired($types[$j]->getPropertyName()); array_splice($types, $j--, 1); $typesCount--; continue; } if ($types[$j] instanceof \PHPStan\Type\ObjectShapeType && $types[$i] instanceof HasPropertyType) { $types[$j] = $types[$j]->makePropertyRequired($types[$i]->getPropertyName()); array_splice($types, $i--, 1); $typesCount--; continue 2; } if ($types[$i] instanceof ConstantArrayType && $types[$j] instanceof \PHPStan\Type\ArrayType) { $newArray = ConstantArrayTypeBuilder::createEmpty(); $valueTypes = $types[$i]->getValueTypes(); foreach ($types[$i]->getKeyTypes() as $k => $keyType) { $newArray->setOffsetValueType(self::intersect($keyType, $types[$j]->getIterableKeyType()), self::intersect($valueTypes[$k], $types[$j]->getIterableValueType()), $types[$i]->isOptionalKey($k) && !$types[$j]->hasOffsetValueType($keyType)->yes()); } $types[$i] = $newArray->getArray(); array_splice($types, $j--, 1); $typesCount--; continue 2; } if ($types[$j] instanceof ConstantArrayType && $types[$i] instanceof \PHPStan\Type\ArrayType) { $newArray = ConstantArrayTypeBuilder::createEmpty(); $valueTypes = $types[$j]->getValueTypes(); foreach ($types[$j]->getKeyTypes() as $k => $keyType) { $newArray->setOffsetValueType(self::intersect($keyType, $types[$i]->getIterableKeyType()), self::intersect($valueTypes[$k], $types[$i]->getIterableValueType()), $types[$j]->isOptionalKey($k) && !$types[$i]->hasOffsetValueType($keyType)->yes()); } $types[$j] = $newArray->getArray(); array_splice($types, $i--, 1); $typesCount--; continue 2; } if (($types[$i] instanceof \PHPStan\Type\ArrayType || $types[$i] instanceof \PHPStan\Type\IterableType) && ($types[$j] instanceof \PHPStan\Type\ArrayType || $types[$j] instanceof \PHPStan\Type\IterableType)) { $keyType = self::intersect($types[$i]->getIterableKeyType(), $types[$j]->getKeyType()); $itemType = self::intersect($types[$i]->getItemType(), $types[$j]->getItemType()); if ($types[$i] instanceof \PHPStan\Type\IterableType && $types[$j] instanceof \PHPStan\Type\IterableType) { $types[$j] = new \PHPStan\Type\IterableType($keyType, $itemType); } else { $types[$j] = new \PHPStan\Type\ArrayType($keyType, $itemType); } array_splice($types, $i--, 1); $typesCount--; continue 2; } if ($types[$i] instanceof GenericClassStringType && $types[$j] instanceof GenericClassStringType) { $genericType = self::intersect($types[$i]->getGenericType(), $types[$j]->getGenericType()); $types[$i] = new GenericClassStringType($genericType); array_splice($types, $j--, 1); $typesCount--; continue; } if ($types[$i] instanceof \PHPStan\Type\ArrayType && get_class($types[$i]) === \PHPStan\Type\ArrayType::class && $types[$j] instanceof AccessoryArrayListType && !$types[$j]->getIterableKeyType()->isSuperTypeOf($types[$i]->getIterableKeyType())->yes()) { $keyType = self::intersect($types[$i]->getIterableKeyType(), $types[$j]->getIterableKeyType()); if ($keyType instanceof \PHPStan\Type\NeverType) { return $keyType; } $types[$i] = new \PHPStan\Type\ArrayType($keyType, $types[$i]->getItemType()); continue; } continue; } if ($isSuperTypeB->yes()) { array_splice($types, $i--, 1); $typesCount--; continue 2; } if ($isSuperTypeA->no()) { return new \PHPStan\Type\NeverType(); } } } if ($typesCount === 1) { return $types[0]; } return new \PHPStan\Type\IntersectionType($types); } public static function removeFalsey(\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return self::remove($type, \PHPStan\Type\StaticTypeFactory::falsey()); } public static function removeTruthy(\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return self::remove($type, \PHPStan\Type\StaticTypeFactory::truthy()); } } <?php declare (strict_types=1); namespace PHPStan\Type; /** @api */ interface ConstantScalarType extends \PHPStan\Type\ConstantType { /** * @return int|float|string|bool|null */ public function getValue(); } <?php declare (strict_types=1); namespace PHPStan\Type; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; /** * This is the interface dynamic return type extensions implement for functions. * * To register it in the configuration file use the `phpstan.broker.dynamicFunctionReturnTypeExtension` service tag: * * ``` * services: * - * class: App\PHPStan\MyExtension * tags: * - phpstan.broker.dynamicFunctionReturnTypeExtension * ``` * * Learn more: https://phpstan.org/developing-extensions/dynamic-return-type-extensions * * @api */ interface DynamicFunctionReturnTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection) : bool; public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope) : ?\PHPStan\Type\Type; } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\Php\PhpVersion; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\TrinaryLogic; use PHPStan\Type\Accessory\AccessoryNumericStringType; use PHPStan\Type\Accessory\AccessoryUppercaseStringType; use PHPStan\Type\Constant\ConstantArrayType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Traits\NonArrayTypeTrait; use PHPStan\Type\Traits\NonCallableTypeTrait; use PHPStan\Type\Traits\NonGeneralizableTypeTrait; use PHPStan\Type\Traits\NonGenericTypeTrait; use PHPStan\Type\Traits\NonIterableTypeTrait; use PHPStan\Type\Traits\NonObjectTypeTrait; use PHPStan\Type\Traits\NonOffsetAccessibleTypeTrait; use PHPStan\Type\Traits\NonRemoveableTypeTrait; use PHPStan\Type\Traits\UndecidedBooleanTypeTrait; use PHPStan\Type\Traits\UndecidedComparisonTypeTrait; use function get_class; /** @api */ class FloatType implements \PHPStan\Type\Type { use NonArrayTypeTrait; use NonCallableTypeTrait; use NonIterableTypeTrait; use NonObjectTypeTrait; use UndecidedBooleanTypeTrait; use UndecidedComparisonTypeTrait; use NonGenericTypeTrait; use NonOffsetAccessibleTypeTrait; use NonRemoveableTypeTrait; use NonGeneralizableTypeTrait; /** @api */ public function __construct() { } /** * @return string[] */ public function getReferencedClasses() : array { return []; } public function getObjectClassNames() : array { return []; } public function getObjectClassReflections() : array { return []; } public function getConstantStrings() : array { return []; } public function accepts(\PHPStan\Type\Type $type, bool $strictTypes) : TrinaryLogic { return $this->acceptsWithReason($type, $strictTypes)->result; } public function acceptsWithReason(\PHPStan\Type\Type $type, bool $strictTypes) : \PHPStan\Type\AcceptsResult { if ($type instanceof self || $type->isInteger()->yes()) { return \PHPStan\Type\AcceptsResult::createYes(); } if ($type instanceof \PHPStan\Type\CompoundType) { return $type->isAcceptedWithReasonBy($this, $strictTypes); } return \PHPStan\Type\AcceptsResult::createNo(); } public function isSuperTypeOf(\PHPStan\Type\Type $type) : TrinaryLogic { return $this->isSuperTypeOfWithReason($type)->result; } public function isSuperTypeOfWithReason(\PHPStan\Type\Type $type) : \PHPStan\Type\IsSuperTypeOfResult { if ($type instanceof self) { return \PHPStan\Type\IsSuperTypeOfResult::createYes(); } if ($type instanceof \PHPStan\Type\CompoundType) { return $type->isSubTypeOfWithReason($this); } return \PHPStan\Type\IsSuperTypeOfResult::createNo(); } public function equals(\PHPStan\Type\Type $type) : bool { return get_class($type) === static::class; } public function describe(\PHPStan\Type\VerbosityLevel $level) : string { return 'float'; } public function toNumber() : \PHPStan\Type\Type { return $this; } public function toAbsoluteNumber() : \PHPStan\Type\Type { return $this; } public function toFloat() : \PHPStan\Type\Type { return $this; } public function toInteger() : \PHPStan\Type\Type { return new \PHPStan\Type\IntegerType(); } public function toString() : \PHPStan\Type\Type { return new \PHPStan\Type\IntersectionType([new \PHPStan\Type\StringType(), new AccessoryUppercaseStringType(), new AccessoryNumericStringType()]); } public function toArray() : \PHPStan\Type\Type { return new ConstantArrayType([new ConstantIntegerType(0)], [$this], [1], [], TrinaryLogic::createYes()); } public function toArrayKey() : \PHPStan\Type\Type { return new \PHPStan\Type\IntegerType(); } public function isOffsetAccessLegal() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isNull() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isConstantValue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isConstantScalarValue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getConstantScalarTypes() : array { return []; } public function getConstantScalarValues() : array { return []; } public function isTrue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFalse() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isBoolean() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFloat() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isInteger() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isNumericString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isNonEmptyString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isNonFalsyString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isLiteralString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isLowercaseString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isUppercaseString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isClassStringType() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getClassStringObjectType() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function getObjectTypeOrClassStringObjectType() : \PHPStan\Type\Type { return new \PHPStan\Type\ErrorType(); } public function isVoid() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isScalar() : TrinaryLogic { return TrinaryLogic::createYes(); } public function looseCompare(\PHPStan\Type\Type $type, PhpVersion $phpVersion) : \PHPStan\Type\BooleanType { return new \PHPStan\Type\BooleanType(); } public function traverse(callable $cb) : \PHPStan\Type\Type { return $this; } public function traverseSimultaneously(\PHPStan\Type\Type $right, callable $cb) : \PHPStan\Type\Type { return $this; } public function exponentiate(\PHPStan\Type\Type $exponent) : \PHPStan\Type\Type { return \PHPStan\Type\ExponentiateHelper::exponentiate($this, $exponent); } public function toPhpDocNode() : TypeNode { return new IdentifierTypeNode('float'); } public function getFiniteTypes() : array { return []; } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : \PHPStan\Type\Type { return new self(); } } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ReflectionProviderStaticAccessor; use PHPStan\ShouldNotHappenException; use PHPStan\Type\Constant\ConstantBooleanType; use PHPStan\Type\Generic\TemplateTypeHelper; use ReflectionIntersectionType; use ReflectionNamedType; use ReflectionType; use ReflectionUnionType; use function array_map; use function count; use function get_class; use function is_string; use function sprintf; use function str_ends_with; use function strtolower; final class TypehintHelper { /** * @param ClassReflection|string|null $selfClass */ private static function getTypeObjectFromTypehint(string $typeString, $selfClass) : \PHPStan\Type\Type { switch (strtolower($typeString)) { case 'int': return new \PHPStan\Type\IntegerType(); case 'bool': return new \PHPStan\Type\BooleanType(); case 'false': return new ConstantBooleanType(\false); case 'true': return new ConstantBooleanType(\true); case 'string': return new \PHPStan\Type\StringType(); case 'float': return new \PHPStan\Type\FloatType(); case 'array': return new \PHPStan\Type\ArrayType(new \PHPStan\Type\MixedType(), new \PHPStan\Type\MixedType()); case 'iterable': return new \PHPStan\Type\IterableType(new \PHPStan\Type\MixedType(), new \PHPStan\Type\MixedType()); case 'callable': return new \PHPStan\Type\CallableType(); case 'void': return new \PHPStan\Type\VoidType(); case 'object': return new \PHPStan\Type\ObjectWithoutClassType(); case 'mixed': return new \PHPStan\Type\MixedType(\true); case 'self': if ($selfClass instanceof ClassReflection) { $selfClass = $selfClass->getName(); } return $selfClass !== null ? new \PHPStan\Type\ObjectType($selfClass) : new \PHPStan\Type\ErrorType(); case 'parent': $reflectionProvider = ReflectionProviderStaticAccessor::getInstance(); if (is_string($selfClass)) { if ($reflectionProvider->hasClass($selfClass)) { $selfClass = $reflectionProvider->getClass($selfClass); } else { $selfClass = null; } } if ($selfClass !== null) { if ($selfClass->getParentClass() !== null) { return new \PHPStan\Type\ObjectType($selfClass->getParentClass()->getName()); } } return new \PHPStan\Type\NonexistentParentClassType(); case 'static': $reflectionProvider = ReflectionProviderStaticAccessor::getInstance(); if (is_string($selfClass)) { if ($reflectionProvider->hasClass($selfClass)) { $selfClass = $reflectionProvider->getClass($selfClass); } else { $selfClass = null; } } if ($selfClass !== null) { return new \PHPStan\Type\StaticType($selfClass); } return new \PHPStan\Type\ErrorType(); case 'null': return new \PHPStan\Type\NullType(); case 'never': return new \PHPStan\Type\NonAcceptingNeverType(); default: return new \PHPStan\Type\ObjectType($typeString); } } /** @api *@param ClassReflection|string|null $selfClass */ public static function decideTypeFromReflection(?ReflectionType $reflectionType, ?\PHPStan\Type\Type $phpDocType = null, $selfClass = null, bool $isVariadic = \false) : \PHPStan\Type\Type { if ($reflectionType === null) { if ($isVariadic && $phpDocType instanceof \PHPStan\Type\ArrayType) { $phpDocType = $phpDocType->getItemType(); } return $phpDocType ?? new \PHPStan\Type\MixedType(); } if ($reflectionType instanceof ReflectionUnionType) { $type = \PHPStan\Type\TypeCombinator::union(...array_map(static function (ReflectionType $type) use($selfClass) : \PHPStan\Type\Type { return self::decideTypeFromReflection($type, null, $selfClass, \false); }, $reflectionType->getTypes())); return self::decideType($type, $phpDocType); } if ($reflectionType instanceof ReflectionIntersectionType) { $types = []; foreach ($reflectionType->getTypes() as $innerReflectionType) { $innerType = self::decideTypeFromReflection($innerReflectionType, null, $selfClass, \false); if (!$innerType->isObject()->yes()) { return new \PHPStan\Type\NeverType(); } $types[] = $innerType; } return self::decideType(\PHPStan\Type\TypeCombinator::intersect(...$types), $phpDocType); } if (!$reflectionType instanceof ReflectionNamedType) { throw new ShouldNotHappenException(sprintf('Unexpected type: %s', get_class($reflectionType))); } $reflectionTypeString = $reflectionType->getName(); $loweredReflectionTypeString = strtolower($reflectionTypeString); if (str_ends_with($loweredReflectionTypeString, '\\object')) { $reflectionTypeString = 'object'; } elseif (str_ends_with($loweredReflectionTypeString, '\\mixed')) { $reflectionTypeString = 'mixed'; } elseif (str_ends_with($loweredReflectionTypeString, '\\true')) { $reflectionTypeString = 'true'; } elseif (str_ends_with($loweredReflectionTypeString, '\\false')) { $reflectionTypeString = 'false'; } elseif (str_ends_with($loweredReflectionTypeString, '\\null')) { $reflectionTypeString = 'null'; } elseif (str_ends_with($loweredReflectionTypeString, '\\never')) { $reflectionTypeString = 'never'; } $type = self::getTypeObjectFromTypehint($reflectionTypeString, $selfClass); if ($reflectionType->allowsNull()) { $type = \PHPStan\Type\TypeCombinator::addNull($type); } elseif ($phpDocType !== null) { $phpDocType = \PHPStan\Type\TypeCombinator::removeNull($phpDocType); } return self::decideType($type, $phpDocType); } public static function decideType(\PHPStan\Type\Type $type, ?\PHPStan\Type\Type $phpDocType = null) : \PHPStan\Type\Type { if ($type instanceof \PHPStan\Type\BenevolentUnionType) { return $type; } if ($phpDocType !== null && !$phpDocType instanceof \PHPStan\Type\ErrorType) { if ($phpDocType instanceof \PHPStan\Type\NeverType && $phpDocType->isExplicit()) { return $phpDocType; } if ($type instanceof \PHPStan\Type\MixedType && !$type->isExplicitMixed() && $phpDocType->isVoid()->yes()) { return $phpDocType; } if (\PHPStan\Type\TypeCombinator::removeNull($type) instanceof \PHPStan\Type\IterableType) { if ($phpDocType instanceof \PHPStan\Type\UnionType) { $innerTypes = []; foreach ($phpDocType->getTypes() as $innerType) { if ($innerType instanceof \PHPStan\Type\ArrayType) { $innerTypes[] = new \PHPStan\Type\IterableType($innerType->getIterableKeyType(), $innerType->getItemType()); } else { $innerTypes[] = $innerType; } } $phpDocType = new \PHPStan\Type\UnionType($innerTypes); } elseif ($phpDocType instanceof \PHPStan\Type\ArrayType) { $phpDocType = new \PHPStan\Type\IterableType($phpDocType->getKeyType(), $phpDocType->getItemType()); } } if ((!$phpDocType instanceof \PHPStan\Type\NeverType || $type instanceof \PHPStan\Type\MixedType && !$type->isExplicitMixed()) && $type->isSuperTypeOf(TemplateTypeHelper::resolveToBounds($phpDocType))->yes()) { $resultType = $phpDocType; } else { $resultType = $type; } if ($type instanceof \PHPStan\Type\UnionType) { $addToUnionTypes = []; foreach ($type->getTypes() as $innerType) { if (!$innerType->isSuperTypeOf($resultType)->no()) { continue; } $addToUnionTypes[] = $innerType; } if (count($addToUnionTypes) > 0) { $type = \PHPStan\Type\TypeCombinator::union($resultType, ...$addToUnionTypes); } else { $type = $resultType; } } elseif (\PHPStan\Type\TypeCombinator::containsNull($type)) { $type = \PHPStan\Type\TypeCombinator::addNull($resultType); } else { $type = $resultType; } } return $type; } } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\ShouldNotHappenException; use PHPStan\TrinaryLogic; use function array_map; use function array_merge; use function array_unique; use function array_values; /** * @api */ final class IsSuperTypeOfResult { /** * @readonly * @var TrinaryLogic */ public $result; /** * @readonly * @var list<string> */ public $reasons; /** * @api * @param list<string> $reasons */ public function __construct(TrinaryLogic $result, array $reasons) { $this->result = $result; $this->reasons = $reasons; } public function yes() : bool { return $this->result->yes(); } public function maybe() : bool { return $this->result->maybe(); } public function no() : bool { return $this->result->no(); } public static function createYes() : self { return new self(TrinaryLogic::createYes(), []); } /** * @param list<string> $reasons */ public static function createNo(array $reasons = []) : self { return new self(TrinaryLogic::createNo(), $reasons); } public static function createMaybe() : self { return new self(TrinaryLogic::createMaybe(), []); } public static function createFromBoolean(bool $value) : self { return new self(TrinaryLogic::createFromBoolean($value), []); } public function toAcceptsResult() : \PHPStan\Type\AcceptsResult { return new \PHPStan\Type\AcceptsResult($this->result, $this->reasons); } public function and(self ...$others) : self { $results = []; $reasons = []; foreach ($others as $other) { $results[] = $other->result; $reasons[] = $other->reasons; } return new self($this->result->and(...$results), array_values(array_unique(array_merge($this->reasons, ...$reasons)))); } public function or(self ...$others) : self { $results = []; $reasons = []; foreach ($others as $other) { $results[] = $other->result; $reasons[] = $other->reasons; } return new self($this->result->or(...$results), array_values(array_unique(array_merge($this->reasons, ...$reasons)))); } /** * @param callable(string): string $cb */ public function decorateReasons(callable $cb) : self { $reasons = []; foreach ($this->reasons as $reason) { $reasons[] = $cb($reason); } return new self($this->result, $reasons); } public static function extremeIdentity(self ...$operands) : self { if ($operands === []) { throw new ShouldNotHappenException(); } $result = TrinaryLogic::extremeIdentity(...array_map(static function (self $result) { return $result->result; }, $operands)); return new self($result, self::mergeReasons($operands)); } public static function maxMin(self ...$operands) : self { if ($operands === []) { throw new ShouldNotHappenException(); } $result = TrinaryLogic::maxMin(...array_map(static function (self $result) { return $result->result; }, $operands)); return new self($result, self::mergeReasons($operands)); } public function negate() : self { return new self($this->result->negate(), $this->reasons); } /** * @param array<self> $operands * * @return list<string> */ private static function mergeReasons(array $operands) : array { $reasons = []; foreach ($operands as $operand) { foreach ($operand->reasons as $reason) { $reasons[] = $reason; } } return array_values(array_unique($reasons)); } } <?php declare (strict_types=1); namespace PHPStan\Type\Accessory; use PHPStan\Php\PhpVersion; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\TrinaryLogic; use PHPStan\Type\AcceptsResult; use PHPStan\Type\BooleanType; use PHPStan\Type\CompoundType; use PHPStan\Type\Constant\ConstantFloatType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\ErrorType; use PHPStan\Type\IntegerRangeType; use PHPStan\Type\IntersectionType; use PHPStan\Type\IsSuperTypeOfResult; use PHPStan\Type\MixedType; use PHPStan\Type\Traits\MaybeCallableTypeTrait; use PHPStan\Type\Traits\NonGeneralizableTypeTrait; use PHPStan\Type\Traits\NonGenericTypeTrait; use PHPStan\Type\Traits\NonObjectTypeTrait; use PHPStan\Type\Traits\NonRemoveableTypeTrait; use PHPStan\Type\Traits\TruthyBooleanTypeTrait; use PHPStan\Type\Traits\UndecidedComparisonCompoundTypeTrait; use PHPStan\Type\Type; use PHPStan\Type\UnionType; use PHPStan\Type\VerbosityLevel; class NonEmptyArrayType implements CompoundType, \PHPStan\Type\Accessory\AccessoryType { use MaybeCallableTypeTrait; use NonObjectTypeTrait; use TruthyBooleanTypeTrait; use NonGenericTypeTrait; use UndecidedComparisonCompoundTypeTrait; use NonRemoveableTypeTrait; use NonGeneralizableTypeTrait; /** @api */ public function __construct() { } public function getReferencedClasses() : array { return []; } public function getObjectClassNames() : array { return []; } public function getObjectClassReflections() : array { return []; } public function getArrays() : array { return []; } public function getConstantArrays() : array { return []; } public function getConstantStrings() : array { return []; } public function accepts(Type $type, bool $strictTypes) : TrinaryLogic { return $this->acceptsWithReason($type, $strictTypes)->result; } public function acceptsWithReason(Type $type, bool $strictTypes) : AcceptsResult { if ($type instanceof CompoundType) { return $type->isAcceptedWithReasonBy($this, $strictTypes); } $isArray = $type->isArray(); $isIterableAtLeastOnce = $type->isIterableAtLeastOnce(); return new AcceptsResult($isArray->and($isIterableAtLeastOnce), []); } public function isSuperTypeOf(Type $type) : TrinaryLogic { return $this->isSuperTypeOfWithReason($type)->result; } public function isSuperTypeOfWithReason(Type $type) : IsSuperTypeOfResult { if ($this->equals($type)) { return IsSuperTypeOfResult::createYes(); } if ($type instanceof CompoundType) { return $type->isSubTypeOfWithReason($this); } return new IsSuperTypeOfResult($type->isArray()->and($type->isIterableAtLeastOnce()), []); } public function isSubTypeOf(Type $otherType) : TrinaryLogic { return $this->isSubTypeOfWithReason($otherType)->result; } public function isSubTypeOfWithReason(Type $otherType) : IsSuperTypeOfResult { if ($otherType instanceof UnionType || $otherType instanceof IntersectionType) { return $otherType->isSuperTypeOfWithReason($this); } return (new IsSuperTypeOfResult($otherType->isArray()->and($otherType->isIterableAtLeastOnce()), []))->and($otherType instanceof self ? IsSuperTypeOfResult::createYes() : IsSuperTypeOfResult::createMaybe()); } public function isAcceptedBy(Type $acceptingType, bool $strictTypes) : TrinaryLogic { return $this->isAcceptedWithReasonBy($acceptingType, $strictTypes)->result; } public function isAcceptedWithReasonBy(Type $acceptingType, bool $strictTypes) : AcceptsResult { return $this->isSubTypeOfWithReason($acceptingType)->toAcceptsResult(); } public function equals(Type $type) : bool { return $type instanceof self; } public function describe(VerbosityLevel $level) : string { return 'non-empty-array'; } public function isOffsetAccessible() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isOffsetAccessLegal() : TrinaryLogic { return TrinaryLogic::createYes(); } public function hasOffsetValueType(Type $offsetType) : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getOffsetValueType(Type $offsetType) : Type { return new MixedType(); } public function setOffsetValueType(?Type $offsetType, Type $valueType, bool $unionValues = \true) : Type { return $this; } public function setExistingOffsetValueType(Type $offsetType, Type $valueType) : Type { return $this; } public function unsetOffset(Type $offsetType) : Type { return new ErrorType(); } public function getKeysArray() : Type { return $this; } public function getValuesArray() : Type { return $this; } public function chunkArray(Type $lengthType, TrinaryLogic $preserveKeys) : Type { return $this; } public function fillKeysArray(Type $valueType) : Type { return $this; } public function flipArray() : Type { return $this; } public function intersectKeyArray(Type $otherArraysType) : Type { return new MixedType(); } public function popArray() : Type { return new MixedType(); } public function reverseArray(TrinaryLogic $preserveKeys) : Type { return $this; } public function searchArray(Type $needleType) : Type { return new MixedType(); } public function shiftArray() : Type { return new MixedType(); } public function shuffleArray() : Type { return $this; } public function sliceArray(Type $offsetType, Type $lengthType, TrinaryLogic $preserveKeys) : Type { if ((new ConstantIntegerType(0))->isSuperTypeOf($offsetType)->yes() && ($lengthType->isNull()->yes() || IntegerRangeType::fromInterval(1, null)->isSuperTypeOf($lengthType)->yes())) { return $this; } return new MixedType(); } public function isIterable() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isIterableAtLeastOnce() : TrinaryLogic { return TrinaryLogic::createYes(); } public function getArraySize() : Type { return IntegerRangeType::fromInterval(1, null); } public function getIterableKeyType() : Type { return new MixedType(); } public function getFirstIterableKeyType() : Type { return new MixedType(); } public function getLastIterableKeyType() : Type { return new MixedType(); } public function getIterableValueType() : Type { return new MixedType(); } public function getFirstIterableValueType() : Type { return new MixedType(); } public function getLastIterableValueType() : Type { return new MixedType(); } public function isArray() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isConstantArray() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isOversizedArray() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isList() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isNull() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isConstantValue() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isConstantScalarValue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getConstantScalarTypes() : array { return []; } public function getConstantScalarValues() : array { return []; } public function isTrue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFalse() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isBoolean() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFloat() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isInteger() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isNumericString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isNonEmptyString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isNonFalsyString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isLiteralString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isLowercaseString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isUppercaseString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isClassStringType() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getClassStringObjectType() : Type { return new ErrorType(); } public function getObjectTypeOrClassStringObjectType() : Type { return new ErrorType(); } public function isVoid() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isScalar() : TrinaryLogic { return TrinaryLogic::createNo(); } public function looseCompare(Type $type, PhpVersion $phpVersion) : BooleanType { return new BooleanType(); } public function toNumber() : Type { return new ErrorType(); } public function toAbsoluteNumber() : Type { return new ErrorType(); } public function toInteger() : Type { return new ConstantIntegerType(1); } public function toFloat() : Type { return new ConstantFloatType(1.0); } public function toString() : Type { return new ErrorType(); } public function toArray() : Type { return $this; } public function toArrayKey() : Type { return new ErrorType(); } public function traverse(callable $cb) : Type { return $this; } public function traverseSimultaneously(Type $right, callable $cb) : Type { return $this; } public function exponentiate(Type $exponent) : Type { return new ErrorType(); } public function getFiniteTypes() : array { return []; } public static function __set_state(array $properties) : Type { return new self(); } public function toPhpDocNode() : TypeNode { return new IdentifierTypeNode('non-empty-array'); } } <?php declare (strict_types=1); namespace PHPStan\Type\Accessory; use PHPStan\Php\PhpVersion; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\TrinaryLogic; use PHPStan\Type\AcceptsResult; use PHPStan\Type\BenevolentUnionType; use PHPStan\Type\BooleanType; use PHPStan\Type\CompoundType; use PHPStan\Type\Constant\ConstantArrayType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\ErrorType; use PHPStan\Type\FloatType; use PHPStan\Type\GeneralizePrecision; use PHPStan\Type\IntegerType; use PHPStan\Type\IntersectionType; use PHPStan\Type\IsSuperTypeOfResult; use PHPStan\Type\ObjectWithoutClassType; use PHPStan\Type\StringType; use PHPStan\Type\Traits\MaybeCallableTypeTrait; use PHPStan\Type\Traits\NonArrayTypeTrait; use PHPStan\Type\Traits\NonGenericTypeTrait; use PHPStan\Type\Traits\NonIterableTypeTrait; use PHPStan\Type\Traits\NonObjectTypeTrait; use PHPStan\Type\Traits\NonRemoveableTypeTrait; use PHPStan\Type\Traits\UndecidedComparisonCompoundTypeTrait; use PHPStan\Type\Type; use PHPStan\Type\UnionType; use PHPStan\Type\VerbosityLevel; class AccessoryLowercaseStringType implements CompoundType, \PHPStan\Type\Accessory\AccessoryType { use MaybeCallableTypeTrait; use NonArrayTypeTrait; use NonObjectTypeTrait; use NonIterableTypeTrait; use UndecidedComparisonCompoundTypeTrait; use NonGenericTypeTrait; use NonRemoveableTypeTrait; /** @api */ public function __construct() { } public function getReferencedClasses() : array { return []; } public function getObjectClassNames() : array { return []; } public function getObjectClassReflections() : array { return []; } public function getConstantStrings() : array { return []; } public function accepts(Type $type, bool $strictTypes) : TrinaryLogic { return $this->acceptsWithReason($type, $strictTypes)->result; } public function acceptsWithReason(Type $type, bool $strictTypes) : AcceptsResult { if ($type instanceof CompoundType) { return $type->isAcceptedWithReasonBy($this, $strictTypes); } return new AcceptsResult($type->isLowercaseString(), []); } public function isSuperTypeOf(Type $type) : TrinaryLogic { return $this->isSuperTypeOfWithReason($type)->result; } public function isSuperTypeOfWithReason(Type $type) : IsSuperTypeOfResult { if ($type instanceof CompoundType) { return $type->isSubTypeOfWithReason($this); } if ($this->equals($type)) { return IsSuperTypeOfResult::createYes(); } return new IsSuperTypeOfResult($type->isLowercaseString(), []); } public function isSubTypeOf(Type $otherType) : TrinaryLogic { return $this->isSubTypeOfWithReason($otherType)->result; } public function isSubTypeOfWithReason(Type $otherType) : IsSuperTypeOfResult { if ($otherType instanceof UnionType || $otherType instanceof IntersectionType) { return $otherType->isSuperTypeOfWithReason($this); } return (new IsSuperTypeOfResult($otherType->isLowercaseString(), []))->and($otherType instanceof self ? IsSuperTypeOfResult::createYes() : IsSuperTypeOfResult::createMaybe()); } public function isAcceptedBy(Type $acceptingType, bool $strictTypes) : TrinaryLogic { return $this->isAcceptedWithReasonBy($acceptingType, $strictTypes)->result; } public function isAcceptedWithReasonBy(Type $acceptingType, bool $strictTypes) : AcceptsResult { return $this->isSubTypeOfWithReason($acceptingType)->toAcceptsResult(); } public function equals(Type $type) : bool { return $type instanceof self; } public function describe(VerbosityLevel $level) : string { return 'lowercase-string'; } public function isOffsetAccessible() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isOffsetAccessLegal() : TrinaryLogic { return TrinaryLogic::createYes(); } public function hasOffsetValueType(Type $offsetType) : TrinaryLogic { return $offsetType->isInteger()->and(TrinaryLogic::createMaybe()); } public function getOffsetValueType(Type $offsetType) : Type { if ($this->hasOffsetValueType($offsetType)->no()) { return new ErrorType(); } return new IntersectionType([new StringType(), new \PHPStan\Type\Accessory\AccessoryLowercaseStringType()]); } public function setOffsetValueType(?Type $offsetType, Type $valueType, bool $unionValues = \true) : Type { $stringOffset = (new StringType())->setOffsetValueType($offsetType, $valueType, $unionValues); if ($stringOffset instanceof ErrorType) { return $stringOffset; } if ($valueType->isLowercaseString()->yes()) { return $this; } return new StringType(); } public function setExistingOffsetValueType(Type $offsetType, Type $valueType) : Type { return $this; } public function unsetOffset(Type $offsetType) : Type { return new ErrorType(); } public function toNumber() : Type { return new ErrorType(); } public function toAbsoluteNumber() : Type { return new ErrorType(); } public function toInteger() : Type { return new IntegerType(); } public function toFloat() : Type { return new FloatType(); } public function toString() : Type { return $this; } public function toBoolean() : BooleanType { return new BooleanType(); } public function toArray() : Type { return new ConstantArrayType([new ConstantIntegerType(0)], [$this], [1], [], TrinaryLogic::createYes()); } public function toArrayKey() : Type { return $this; } public function isNull() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isConstantValue() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isConstantScalarValue() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getConstantScalarTypes() : array { return []; } public function getConstantScalarValues() : array { return []; } public function isTrue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFalse() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isBoolean() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFloat() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isInteger() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isString() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isNumericString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isNonEmptyString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isNonFalsyString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isLiteralString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isLowercaseString() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isUppercaseString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isClassStringType() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getClassStringObjectType() : Type { return new ObjectWithoutClassType(); } public function getObjectTypeOrClassStringObjectType() : Type { return new ObjectWithoutClassType(); } public function hasMethod(string $methodName) : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isVoid() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isScalar() : TrinaryLogic { return TrinaryLogic::createYes(); } public function looseCompare(Type $type, PhpVersion $phpVersion) : BooleanType { return new BooleanType(); } public function traverse(callable $cb) : Type { return $this; } public function traverseSimultaneously(Type $right, callable $cb) : Type { return $this; } public function generalize(GeneralizePrecision $precision) : Type { return new StringType(); } public static function __set_state(array $properties) : Type { return new self(); } public function exponentiate(Type $exponent) : Type { return new BenevolentUnionType([new FloatType(), new IntegerType()]); } public function getFiniteTypes() : array { return []; } public function toPhpDocNode() : TypeNode { return new IdentifierTypeNode('lowercase-string'); } } <?php declare (strict_types=1); namespace PHPStan\Type\Accessory; use PHPStan\Php\PhpVersion; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\ShouldNotHappenException; use PHPStan\TrinaryLogic; use PHPStan\Type\AcceptsResult; use PHPStan\Type\BooleanType; use PHPStan\Type\CompoundType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\ConstantScalarType; use PHPStan\Type\ErrorType; use PHPStan\Type\IntegerRangeType; use PHPStan\Type\IntersectionType; use PHPStan\Type\IsSuperTypeOfResult; use PHPStan\Type\MixedType; use PHPStan\Type\ObjectWithoutClassType; use PHPStan\Type\Traits\MaybeArrayTypeTrait; use PHPStan\Type\Traits\MaybeCallableTypeTrait; use PHPStan\Type\Traits\MaybeIterableTypeTrait; use PHPStan\Type\Traits\MaybeObjectTypeTrait; use PHPStan\Type\Traits\NonGeneralizableTypeTrait; use PHPStan\Type\Traits\NonGenericTypeTrait; use PHPStan\Type\Traits\NonRemoveableTypeTrait; use PHPStan\Type\Traits\TruthyBooleanTypeTrait; use PHPStan\Type\Traits\UndecidedComparisonCompoundTypeTrait; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\UnionType; use PHPStan\Type\VerbosityLevel; use function sprintf; class HasOffsetValueType implements CompoundType, \PHPStan\Type\Accessory\AccessoryType { /** * @var ConstantStringType|ConstantIntegerType */ private $offsetType; /** * @var Type */ private $valueType; use MaybeArrayTypeTrait; use MaybeCallableTypeTrait; use MaybeIterableTypeTrait; use MaybeObjectTypeTrait; use TruthyBooleanTypeTrait; use NonGenericTypeTrait; use UndecidedComparisonCompoundTypeTrait; use NonRemoveableTypeTrait; use NonGeneralizableTypeTrait; /** * @param ConstantStringType|ConstantIntegerType $offsetType */ public function __construct($offsetType, Type $valueType) { $this->offsetType = $offsetType; $this->valueType = $valueType; } /** * @return ConstantStringType|ConstantIntegerType */ public function getOffsetType() { return $this->offsetType; } public function getValueType() : Type { return $this->valueType; } public function getReferencedClasses() : array { return []; } public function getObjectClassNames() : array { return []; } public function getObjectClassReflections() : array { return []; } public function getConstantStrings() : array { return []; } public function accepts(Type $type, bool $strictTypes) : TrinaryLogic { return $this->acceptsWithReason($type, $strictTypes)->result; } public function acceptsWithReason(Type $type, bool $strictTypes) : AcceptsResult { if ($type instanceof CompoundType) { return $type->isAcceptedWithReasonBy($this, $strictTypes); } $result = new AcceptsResult($type->isOffsetAccessible()->and($type->hasOffsetValueType($this->offsetType)), []); return $result->and($this->valueType->acceptsWithReason($type->getOffsetValueType($this->offsetType), $strictTypes)); } public function isSuperTypeOf(Type $type) : TrinaryLogic { return $this->isSuperTypeOfWithReason($type)->result; } public function isSuperTypeOfWithReason(Type $type) : IsSuperTypeOfResult { if ($this->equals($type)) { return IsSuperTypeOfResult::createYes(); } $result = new IsSuperTypeOfResult($type->isOffsetAccessible()->and($type->hasOffsetValueType($this->offsetType)), []); return $result->and($this->valueType->isSuperTypeOfWithReason($type->getOffsetValueType($this->offsetType))); } public function isSubTypeOf(Type $otherType) : TrinaryLogic { return $this->isSubTypeOfWithReason($otherType)->result; } public function isSubTypeOfWithReason(Type $otherType) : IsSuperTypeOfResult { if ($otherType instanceof UnionType || $otherType instanceof IntersectionType) { return $otherType->isSuperTypeOfWithReason($this); } $result = new IsSuperTypeOfResult($otherType->isOffsetAccessible()->and($otherType->hasOffsetValueType($this->offsetType)), []); return $result->and($otherType->getOffsetValueType($this->offsetType)->isSuperTypeOfWithReason($this->valueType))->and($otherType instanceof self ? IsSuperTypeOfResult::createYes() : IsSuperTypeOfResult::createMaybe()); } public function isAcceptedBy(Type $acceptingType, bool $strictTypes) : TrinaryLogic { return $this->isAcceptedWithReasonBy($acceptingType, $strictTypes)->result; } public function isAcceptedWithReasonBy(Type $acceptingType, bool $strictTypes) : AcceptsResult { return $this->isSubTypeOfWithReason($acceptingType)->toAcceptsResult(); } public function equals(Type $type) : bool { return $type instanceof self && $this->offsetType->equals($type->offsetType) && $this->valueType->equals($type->valueType); } public function describe(VerbosityLevel $level) : string { return sprintf('hasOffsetValue(%s, %s)', $this->offsetType->describe($level), $this->valueType->describe($level)); } public function isOffsetAccessible() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isOffsetAccessLegal() : TrinaryLogic { return TrinaryLogic::createYes(); } public function hasOffsetValueType(Type $offsetType) : TrinaryLogic { if ($offsetType->isConstantScalarValue()->yes() && $offsetType->equals($this->offsetType)) { return TrinaryLogic::createYes(); } return TrinaryLogic::createMaybe(); } public function getOffsetValueType(Type $offsetType) : Type { if ($offsetType->isConstantScalarValue()->yes() && $offsetType->equals($this->offsetType)) { return $this->valueType; } return new MixedType(); } public function setOffsetValueType(?Type $offsetType, Type $valueType, bool $unionValues = \true) : Type { if ($offsetType === null) { return $this; } if (!$offsetType->equals($this->offsetType)) { return $this; } if (!$offsetType instanceof ConstantIntegerType && !$offsetType instanceof ConstantStringType) { throw new ShouldNotHappenException(); } return new self($offsetType, $valueType); } public function setExistingOffsetValueType(Type $offsetType, Type $valueType) : Type { return new self($this->offsetType, $valueType); } public function unsetOffset(Type $offsetType) : Type { if ($this->offsetType->isSuperTypeOf($offsetType)->yes()) { return new ErrorType(); } return $this; } public function getKeysArray() : Type { return new \PHPStan\Type\Accessory\NonEmptyArrayType(); } public function getValuesArray() : Type { return new \PHPStan\Type\Accessory\NonEmptyArrayType(); } public function chunkArray(Type $lengthType, TrinaryLogic $preserveKeys) : Type { return new \PHPStan\Type\Accessory\NonEmptyArrayType(); } public function fillKeysArray(Type $valueType) : Type { return new \PHPStan\Type\Accessory\NonEmptyArrayType(); } public function flipArray() : Type { $valueType = $this->valueType->toArrayKey(); if ($valueType instanceof ConstantIntegerType || $valueType instanceof ConstantStringType) { return new self($valueType, $this->offsetType); } return new MixedType(); } public function intersectKeyArray(Type $otherArraysType) : Type { if ($otherArraysType->hasOffsetValueType($this->offsetType)->yes()) { return $this; } return new MixedType(); } public function reverseArray(TrinaryLogic $preserveKeys) : Type { if ($preserveKeys->yes()) { return $this; } return new \PHPStan\Type\Accessory\NonEmptyArrayType(); } public function searchArray(Type $needleType) : Type { if ($needleType instanceof ConstantScalarType && $this->valueType instanceof ConstantScalarType && $needleType->getValue() === $this->valueType->getValue()) { return $this->offsetType; } return new MixedType(); } public function shuffleArray() : Type { return new \PHPStan\Type\Accessory\NonEmptyArrayType(); } public function sliceArray(Type $offsetType, Type $lengthType, TrinaryLogic $preserveKeys) : Type { if ($this->offsetType->isSuperTypeOf($offsetType)->yes() && ($lengthType->isNull()->yes() || IntegerRangeType::fromInterval(1, null)->isSuperTypeOf($lengthType)->yes())) { return $preserveKeys->yes() ? TypeCombinator::intersect($this, new \PHPStan\Type\Accessory\NonEmptyArrayType()) : new \PHPStan\Type\Accessory\NonEmptyArrayType(); } return new MixedType(); } public function isIterableAtLeastOnce() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isList() : TrinaryLogic { if ($this->offsetType->isString()->yes()) { return TrinaryLogic::createNo(); } return TrinaryLogic::createMaybe(); } public function isNull() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isConstantValue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isConstantScalarValue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getConstantScalarTypes() : array { return []; } public function getConstantScalarValues() : array { return []; } public function isTrue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFalse() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isBoolean() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFloat() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isInteger() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isNumericString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isNonEmptyString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isNonFalsyString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isLiteralString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isLowercaseString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isUppercaseString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isClassStringType() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getClassStringObjectType() : Type { return new ObjectWithoutClassType(); } public function getObjectTypeOrClassStringObjectType() : Type { return new ObjectWithoutClassType(); } public function isVoid() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isScalar() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function looseCompare(Type $type, PhpVersion $phpVersion) : BooleanType { return new BooleanType(); } public function toNumber() : Type { return new ErrorType(); } public function toAbsoluteNumber() : Type { return new ErrorType(); } public function toInteger() : Type { return new ErrorType(); } public function toFloat() : Type { return new ErrorType(); } public function toString() : Type { return new ErrorType(); } public function toArray() : Type { return new MixedType(); } public function toArrayKey() : Type { return new ErrorType(); } public function getEnumCases() : array { return []; } public function traverse(callable $cb) : Type { $newValueType = $cb($this->valueType); if ($newValueType === $this->valueType) { return $this; } return new self($this->offsetType, $newValueType); } public function traverseSimultaneously(Type $right, callable $cb) : Type { $newValueType = $cb($this->valueType, $right->getOffsetValueType($this->offsetType)); if ($newValueType === $this->valueType) { return $this; } return new self($this->offsetType, $newValueType); } public function exponentiate(Type $exponent) : Type { return new ErrorType(); } public function getFiniteTypes() : array { return []; } public static function __set_state(array $properties) : Type { return new self($properties['offsetType'], $properties['valueType']); } public function toPhpDocNode() : TypeNode { return new IdentifierTypeNode(''); // no PHPDoc representation } } <?php declare (strict_types=1); namespace PHPStan\Type\Accessory; use PHPStan\Php\PhpVersion; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\TrinaryLogic; use PHPStan\Type\AcceptsResult; use PHPStan\Type\BenevolentUnionType; use PHPStan\Type\BooleanType; use PHPStan\Type\CompoundType; use PHPStan\Type\Constant\ConstantArrayType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\ErrorType; use PHPStan\Type\FloatType; use PHPStan\Type\GeneralizePrecision; use PHPStan\Type\IntegerType; use PHPStan\Type\IntersectionType; use PHPStan\Type\IsSuperTypeOfResult; use PHPStan\Type\ObjectWithoutClassType; use PHPStan\Type\StringType; use PHPStan\Type\Traits\MaybeCallableTypeTrait; use PHPStan\Type\Traits\NonArrayTypeTrait; use PHPStan\Type\Traits\NonGenericTypeTrait; use PHPStan\Type\Traits\NonIterableTypeTrait; use PHPStan\Type\Traits\NonObjectTypeTrait; use PHPStan\Type\Traits\NonRemoveableTypeTrait; use PHPStan\Type\Traits\UndecidedComparisonCompoundTypeTrait; use PHPStan\Type\Type; use PHPStan\Type\UnionType; use PHPStan\Type\VerbosityLevel; class AccessoryUppercaseStringType implements CompoundType, \PHPStan\Type\Accessory\AccessoryType { use MaybeCallableTypeTrait; use NonArrayTypeTrait; use NonObjectTypeTrait; use NonIterableTypeTrait; use UndecidedComparisonCompoundTypeTrait; use NonGenericTypeTrait; use NonRemoveableTypeTrait; /** @api */ public function __construct() { } public function getReferencedClasses() : array { return []; } public function getObjectClassNames() : array { return []; } public function getObjectClassReflections() : array { return []; } public function getConstantStrings() : array { return []; } public function accepts(Type $type, bool $strictTypes) : TrinaryLogic { return $this->acceptsWithReason($type, $strictTypes)->result; } public function acceptsWithReason(Type $type, bool $strictTypes) : AcceptsResult { if ($type instanceof CompoundType) { return $type->isAcceptedWithReasonBy($this, $strictTypes); } return new AcceptsResult($type->isUppercaseString(), []); } public function isSuperTypeOf(Type $type) : TrinaryLogic { return $this->isSuperTypeOfWithReason($type)->result; } public function isSuperTypeOfWithReason(Type $type) : IsSuperTypeOfResult { if ($type instanceof CompoundType) { return $type->isSubTypeOfWithReason($this); } if ($this->equals($type)) { return IsSuperTypeOfResult::createYes(); } return new IsSuperTypeOfResult($type->isUppercaseString(), []); } public function isSubTypeOf(Type $otherType) : TrinaryLogic { return $this->isSubTypeOfWithReason($otherType)->result; } public function isSubTypeOfWithReason(Type $otherType) : IsSuperTypeOfResult { if ($otherType instanceof UnionType || $otherType instanceof IntersectionType) { return $otherType->isSuperTypeOfWithReason($this); } return (new IsSuperTypeOfResult($otherType->isUppercaseString(), []))->and($otherType instanceof self ? IsSuperTypeOfResult::createYes() : IsSuperTypeOfResult::createMaybe()); } public function isAcceptedBy(Type $acceptingType, bool $strictTypes) : TrinaryLogic { return $this->isAcceptedWithReasonBy($acceptingType, $strictTypes)->result; } public function isAcceptedWithReasonBy(Type $acceptingType, bool $strictTypes) : AcceptsResult { return $this->isSubTypeOfWithReason($acceptingType)->toAcceptsResult(); } public function equals(Type $type) : bool { return $type instanceof self; } public function describe(VerbosityLevel $level) : string { return 'uppercase-string'; } public function isOffsetAccessible() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isOffsetAccessLegal() : TrinaryLogic { return TrinaryLogic::createYes(); } public function hasOffsetValueType(Type $offsetType) : TrinaryLogic { return $offsetType->isInteger()->and(TrinaryLogic::createMaybe()); } public function getOffsetValueType(Type $offsetType) : Type { if ($this->hasOffsetValueType($offsetType)->no()) { return new ErrorType(); } return new IntersectionType([new StringType(), new \PHPStan\Type\Accessory\AccessoryUppercaseStringType()]); } public function setOffsetValueType(?Type $offsetType, Type $valueType, bool $unionValues = \true) : Type { $stringOffset = (new StringType())->setOffsetValueType($offsetType, $valueType, $unionValues); if ($stringOffset instanceof ErrorType) { return $stringOffset; } if ($valueType->isUppercaseString()->yes()) { return $this; } return new StringType(); } public function setExistingOffsetValueType(Type $offsetType, Type $valueType) : Type { return $this; } public function unsetOffset(Type $offsetType) : Type { return new ErrorType(); } public function toNumber() : Type { return new ErrorType(); } public function toAbsoluteNumber() : Type { return new ErrorType(); } public function toInteger() : Type { return new IntegerType(); } public function toFloat() : Type { return new FloatType(); } public function toString() : Type { return $this; } public function toBoolean() : BooleanType { return new BooleanType(); } public function toArray() : Type { return new ConstantArrayType([new ConstantIntegerType(0)], [$this], [1], [], TrinaryLogic::createYes()); } public function toArrayKey() : Type { return $this; } public function isNull() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isConstantValue() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isConstantScalarValue() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getConstantScalarTypes() : array { return []; } public function getConstantScalarValues() : array { return []; } public function isTrue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFalse() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isBoolean() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFloat() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isInteger() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isString() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isNumericString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isNonEmptyString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isNonFalsyString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isLiteralString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isLowercaseString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isUppercaseString() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isClassStringType() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getClassStringObjectType() : Type { return new ObjectWithoutClassType(); } public function getObjectTypeOrClassStringObjectType() : Type { return new ObjectWithoutClassType(); } public function hasMethod(string $methodName) : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isVoid() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isScalar() : TrinaryLogic { return TrinaryLogic::createYes(); } public function looseCompare(Type $type, PhpVersion $phpVersion) : BooleanType { return new BooleanType(); } public function traverse(callable $cb) : Type { return $this; } public function traverseSimultaneously(Type $right, callable $cb) : Type { return $this; } public function generalize(GeneralizePrecision $precision) : Type { return new StringType(); } public static function __set_state(array $properties) : Type { return new self(); } public function exponentiate(Type $exponent) : Type { return new BenevolentUnionType([new FloatType(), new IntegerType()]); } public function getFiniteTypes() : array { return []; } public function toPhpDocNode() : TypeNode { return new IdentifierTypeNode('uppercase-string'); } } <?php declare (strict_types=1); namespace PHPStan\Type\Accessory; use PHPStan\Php\PhpVersion; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\TrinaryLogic; use PHPStan\Type\AcceptsResult; use PHPStan\Type\BenevolentUnionType; use PHPStan\Type\BooleanType; use PHPStan\Type\CompoundType; use PHPStan\Type\Constant\ConstantArrayType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\ErrorType; use PHPStan\Type\FloatType; use PHPStan\Type\GeneralizePrecision; use PHPStan\Type\IntegerType; use PHPStan\Type\IntersectionType; use PHPStan\Type\IsSuperTypeOfResult; use PHPStan\Type\MixedType; use PHPStan\Type\ObjectWithoutClassType; use PHPStan\Type\StringType; use PHPStan\Type\Traits\MaybeCallableTypeTrait; use PHPStan\Type\Traits\NonArrayTypeTrait; use PHPStan\Type\Traits\NonGenericTypeTrait; use PHPStan\Type\Traits\NonIterableTypeTrait; use PHPStan\Type\Traits\NonObjectTypeTrait; use PHPStan\Type\Traits\NonRemoveableTypeTrait; use PHPStan\Type\Traits\UndecidedComparisonCompoundTypeTrait; use PHPStan\Type\Type; use PHPStan\Type\UnionType; use PHPStan\Type\VerbosityLevel; class AccessoryLiteralStringType implements CompoundType, \PHPStan\Type\Accessory\AccessoryType { use MaybeCallableTypeTrait; use NonArrayTypeTrait; use NonObjectTypeTrait; use NonIterableTypeTrait; use UndecidedComparisonCompoundTypeTrait; use NonGenericTypeTrait; use NonRemoveableTypeTrait; /** @api */ public function __construct() { } public function getReferencedClasses() : array { return []; } public function getObjectClassNames() : array { return []; } public function getObjectClassReflections() : array { return []; } public function getConstantStrings() : array { return []; } public function accepts(Type $type, bool $strictTypes) : TrinaryLogic { return $this->acceptsWithReason($type, $strictTypes)->result; } public function acceptsWithReason(Type $type, bool $strictTypes) : AcceptsResult { if ($type instanceof MixedType) { return AcceptsResult::createNo(); } if ($type instanceof CompoundType) { return $type->isAcceptedWithReasonBy($this, $strictTypes); } return new AcceptsResult($type->isLiteralString(), []); } public function isSuperTypeOf(Type $type) : TrinaryLogic { return $this->isSuperTypeOfWithReason($type)->result; } public function isSuperTypeOfWithReason(Type $type) : IsSuperTypeOfResult { if ($type instanceof CompoundType) { return $type->isSubTypeOfWithReason($this); } if ($this->equals($type)) { return IsSuperTypeOfResult::createYes(); } return new IsSuperTypeOfResult($type->isLiteralString(), []); } public function isSubTypeOf(Type $otherType) : TrinaryLogic { return $this->isSubTypeOfWithReason($otherType)->result; } public function isSubTypeOfWithReason(Type $otherType) : IsSuperTypeOfResult { if ($otherType instanceof UnionType || $otherType instanceof IntersectionType) { return $otherType->isSuperTypeOfWithReason($this); } return (new IsSuperTypeOfResult($otherType->isLiteralString(), []))->and($otherType instanceof self ? IsSuperTypeOfResult::createYes() : IsSuperTypeOfResult::createMaybe()); } public function isAcceptedBy(Type $acceptingType, bool $strictTypes) : TrinaryLogic { return $this->isAcceptedWithReasonBy($acceptingType, $strictTypes)->result; } public function isAcceptedWithReasonBy(Type $acceptingType, bool $strictTypes) : AcceptsResult { return $this->isSubTypeOfWithReason($acceptingType)->toAcceptsResult(); } public function equals(Type $type) : bool { return $type instanceof self; } public function describe(VerbosityLevel $level) : string { return 'literal-string'; } public function isOffsetAccessible() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isOffsetAccessLegal() : TrinaryLogic { return TrinaryLogic::createYes(); } public function hasOffsetValueType(Type $offsetType) : TrinaryLogic { return $offsetType->isInteger()->and(TrinaryLogic::createMaybe()); } public function getOffsetValueType(Type $offsetType) : Type { if ($this->hasOffsetValueType($offsetType)->no()) { return new ErrorType(); } return new StringType(); } public function setOffsetValueType(?Type $offsetType, Type $valueType, bool $unionValues = \true) : Type { $stringOffset = (new StringType())->setOffsetValueType($offsetType, $valueType, $unionValues); if ($stringOffset instanceof ErrorType) { return $stringOffset; } if ($valueType->isLiteralString()->yes()) { return $this; } return new StringType(); } public function setExistingOffsetValueType(Type $offsetType, Type $valueType) : Type { return $this; } public function unsetOffset(Type $offsetType) : Type { return new ErrorType(); } public function toNumber() : Type { return new ErrorType(); } public function toAbsoluteNumber() : Type { return new ErrorType(); } public function toInteger() : Type { return new IntegerType(); } public function toFloat() : Type { return new FloatType(); } public function toString() : Type { return $this; } public function toBoolean() : BooleanType { return new BooleanType(); } public function toArray() : Type { return new ConstantArrayType([new ConstantIntegerType(0)], [$this], [1], [], TrinaryLogic::createYes()); } public function toArrayKey() : Type { return $this; } public function isNull() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isConstantValue() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isConstantScalarValue() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getConstantScalarTypes() : array { return []; } public function getConstantScalarValues() : array { return []; } public function isTrue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFalse() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isBoolean() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFloat() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isInteger() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isString() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isNumericString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isNonEmptyString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isNonFalsyString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isLiteralString() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isLowercaseString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isUppercaseString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isClassStringType() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getClassStringObjectType() : Type { return new ObjectWithoutClassType(); } public function getObjectTypeOrClassStringObjectType() : Type { return new ObjectWithoutClassType(); } public function hasMethod(string $methodName) : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isVoid() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isScalar() : TrinaryLogic { return TrinaryLogic::createYes(); } public function looseCompare(Type $type, PhpVersion $phpVersion) : BooleanType { return new BooleanType(); } public function traverse(callable $cb) : Type { return $this; } public function traverseSimultaneously(Type $right, callable $cb) : Type { return $this; } public function generalize(GeneralizePrecision $precision) : Type { return new StringType(); } public static function __set_state(array $properties) : Type { return new self(); } public function exponentiate(Type $exponent) : Type { return new BenevolentUnionType([new FloatType(), new IntegerType()]); } public function getFiniteTypes() : array { return []; } public function toPhpDocNode() : TypeNode { return new IdentifierTypeNode('literal-string'); } } <?php declare (strict_types=1); namespace PHPStan\Type\Accessory; use PHPStan\Php\PhpVersion; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\TrinaryLogic; use PHPStan\Type\AcceptsResult; use PHPStan\Type\BooleanType; use PHPStan\Type\CompoundType; use PHPStan\Type\Constant\ConstantFloatType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\ErrorType; use PHPStan\Type\IntegerRangeType; use PHPStan\Type\IntersectionType; use PHPStan\Type\IsSuperTypeOfResult; use PHPStan\Type\MixedType; use PHPStan\Type\Traits\MaybeCallableTypeTrait; use PHPStan\Type\Traits\NonGeneralizableTypeTrait; use PHPStan\Type\Traits\NonGenericTypeTrait; use PHPStan\Type\Traits\NonObjectTypeTrait; use PHPStan\Type\Traits\NonRemoveableTypeTrait; use PHPStan\Type\Traits\TruthyBooleanTypeTrait; use PHPStan\Type\Traits\UndecidedComparisonCompoundTypeTrait; use PHPStan\Type\Type; use PHPStan\Type\UnionType; use PHPStan\Type\VerbosityLevel; class OversizedArrayType implements CompoundType, \PHPStan\Type\Accessory\AccessoryType { use MaybeCallableTypeTrait; use NonObjectTypeTrait; use TruthyBooleanTypeTrait; use NonGenericTypeTrait; use UndecidedComparisonCompoundTypeTrait; use NonRemoveableTypeTrait; use NonGeneralizableTypeTrait; public function __construct() { } public function getReferencedClasses() : array { return []; } public function getObjectClassNames() : array { return []; } public function getObjectClassReflections() : array { return []; } public function getArrays() : array { return []; } public function getConstantArrays() : array { return []; } public function getConstantStrings() : array { return []; } public function accepts(Type $type, bool $strictTypes) : TrinaryLogic { return $this->acceptsWithReason($type, $strictTypes)->result; } public function acceptsWithReason(Type $type, bool $strictTypes) : AcceptsResult { if ($type instanceof CompoundType) { return $type->isAcceptedWithReasonBy($this, $strictTypes); } return new AcceptsResult($type->isArray()->and($type->isIterableAtLeastOnce()), []); } public function isSuperTypeOf(Type $type) : TrinaryLogic { return $this->isSuperTypeOfWithReason($type)->result; } public function isSuperTypeOfWithReason(Type $type) : IsSuperTypeOfResult { if ($this->equals($type)) { return IsSuperTypeOfResult::createYes(); } if ($type instanceof CompoundType) { return $type->isSubTypeOfWithReason($this); } return new IsSuperTypeOfResult($type->isArray()->and($type->isOversizedArray()), []); } public function isSubTypeOf(Type $otherType) : TrinaryLogic { return $this->isSubTypeOfWithReason($otherType)->result; } public function isSubTypeOfWithReason(Type $otherType) : IsSuperTypeOfResult { if ($otherType instanceof UnionType || $otherType instanceof IntersectionType) { return $otherType->isSuperTypeOfWithReason($this); } return (new IsSuperTypeOfResult($otherType->isArray()->and($otherType->isOversizedArray()), []))->and($otherType instanceof self ? IsSuperTypeOfResult::createYes() : IsSuperTypeOfResult::createMaybe()); } public function isAcceptedBy(Type $acceptingType, bool $strictTypes) : TrinaryLogic { return $this->isAcceptedWithReasonBy($acceptingType, $strictTypes)->result; } public function isAcceptedWithReasonBy(Type $acceptingType, bool $strictTypes) : AcceptsResult { return $this->isSubTypeOfWithReason($acceptingType)->toAcceptsResult(); } public function equals(Type $type) : bool { return $type instanceof self; } public function describe(VerbosityLevel $level) : string { return 'oversized-array'; } public function isOffsetAccessible() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isOffsetAccessLegal() : TrinaryLogic { return TrinaryLogic::createYes(); } public function hasOffsetValueType(Type $offsetType) : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getOffsetValueType(Type $offsetType) : Type { return new MixedType(); } public function setOffsetValueType(?Type $offsetType, Type $valueType, bool $unionValues = \true) : Type { return $this; } public function setExistingOffsetValueType(Type $offsetType, Type $valueType) : Type { return $this; } public function unsetOffset(Type $offsetType) : Type { return new ErrorType(); } public function getKeysArray() : Type { return $this; } public function getValuesArray() : Type { return $this; } public function chunkArray(Type $lengthType, TrinaryLogic $preserveKeys) : Type { return $this; } public function fillKeysArray(Type $valueType) : Type { return $this; } public function flipArray() : Type { return $this; } public function intersectKeyArray(Type $otherArraysType) : Type { return $this; } public function popArray() : Type { return $this; } public function reverseArray(TrinaryLogic $preserveKeys) : Type { return $this; } public function searchArray(Type $needleType) : Type { return new MixedType(); } public function shiftArray() : Type { return $this; } public function shuffleArray() : Type { return $this; } public function sliceArray(Type $offsetType, Type $lengthType, TrinaryLogic $preserveKeys) : Type { return $this; } public function isIterable() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isIterableAtLeastOnce() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getArraySize() : Type { return IntegerRangeType::fromInterval(0, null); } public function getIterableKeyType() : Type { return new MixedType(); } public function getFirstIterableKeyType() : Type { return new MixedType(); } public function getLastIterableKeyType() : Type { return new MixedType(); } public function getIterableValueType() : Type { return new MixedType(); } public function getFirstIterableValueType() : Type { return new MixedType(); } public function getLastIterableValueType() : Type { return new MixedType(); } public function isArray() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isConstantArray() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isOversizedArray() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isList() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isNull() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isConstantValue() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isConstantScalarValue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getConstantScalarTypes() : array { return []; } public function getConstantScalarValues() : array { return []; } public function isTrue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFalse() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isBoolean() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFloat() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isInteger() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isNumericString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isNonEmptyString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isNonFalsyString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isLiteralString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isLowercaseString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isUppercaseString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isClassStringType() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getClassStringObjectType() : Type { return new ErrorType(); } public function getObjectTypeOrClassStringObjectType() : Type { return new ErrorType(); } public function isVoid() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isScalar() : TrinaryLogic { return TrinaryLogic::createNo(); } public function looseCompare(Type $type, PhpVersion $phpVersion) : BooleanType { return new BooleanType(); } public function toNumber() : Type { return new ErrorType(); } public function toAbsoluteNumber() : Type { return new ErrorType(); } public function toInteger() : Type { return new ConstantIntegerType(1); } public function toFloat() : Type { return new ConstantFloatType(1.0); } public function toString() : Type { return new ErrorType(); } public function toArray() : Type { return new MixedType(); } public function toArrayKey() : Type { return new ErrorType(); } public function traverse(callable $cb) : Type { return $this; } public function traverseSimultaneously(Type $right, callable $cb) : Type { return $this; } public function exponentiate(Type $exponent) : Type { return new ErrorType(); } public function getFiniteTypes() : array { return []; } public static function __set_state(array $properties) : Type { return new self(); } public function toPhpDocNode() : TypeNode { return new IdentifierTypeNode(''); // no PHPDoc representation } } <?php declare (strict_types=1); namespace PHPStan\Type\Accessory; use PHPStan\Type\Type; interface AccessoryType extends Type { } <?php declare (strict_types=1); namespace PHPStan\Type\Accessory; use PHPStan\Php\PhpVersion; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\TrinaryLogic; use PHPStan\Type\AcceptsResult; use PHPStan\Type\BooleanType; use PHPStan\Type\CompoundType; use PHPStan\Type\Constant\ConstantFloatType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\ErrorType; use PHPStan\Type\IntegerRangeType; use PHPStan\Type\IntersectionType; use PHPStan\Type\IsSuperTypeOfResult; use PHPStan\Type\MixedType; use PHPStan\Type\Traits\MaybeCallableTypeTrait; use PHPStan\Type\Traits\NonGeneralizableTypeTrait; use PHPStan\Type\Traits\NonGenericTypeTrait; use PHPStan\Type\Traits\NonObjectTypeTrait; use PHPStan\Type\Traits\NonRemoveableTypeTrait; use PHPStan\Type\Traits\UndecidedBooleanTypeTrait; use PHPStan\Type\Traits\UndecidedComparisonCompoundTypeTrait; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\UnionType; use PHPStan\Type\VerbosityLevel; /** @api */ class AccessoryArrayListType implements CompoundType, \PHPStan\Type\Accessory\AccessoryType { use MaybeCallableTypeTrait; use NonObjectTypeTrait; use NonGenericTypeTrait; use UndecidedBooleanTypeTrait; use UndecidedComparisonCompoundTypeTrait; use NonRemoveableTypeTrait; use NonGeneralizableTypeTrait; /** * @var bool */ private static $enabled = \false; public function __construct() { } public function getReferencedClasses() : array { return []; } public function getObjectClassNames() : array { return []; } public function getObjectClassReflections() : array { return []; } public function getArrays() : array { return []; } public function getConstantArrays() : array { return []; } public function getConstantStrings() : array { return []; } public function accepts(Type $type, bool $strictTypes) : TrinaryLogic { return $this->acceptsWithReason($type, $strictTypes)->result; } public function acceptsWithReason(Type $type, bool $strictTypes) : AcceptsResult { if ($type instanceof CompoundType) { return $type->isAcceptedWithReasonBy($this, $strictTypes); } $isArray = $type->isArray(); $isList = $type->isList(); return new AcceptsResult($isArray->and($isList), []); } public function isSuperTypeOf(Type $type) : TrinaryLogic { return $this->isSuperTypeOfWithReason($type)->result; } public function isSuperTypeOfWithReason(Type $type) : IsSuperTypeOfResult { if ($this->equals($type)) { return IsSuperTypeOfResult::createYes(); } if ($type instanceof CompoundType) { return $type->isSubTypeOfWithReason($this); } return new IsSuperTypeOfResult($type->isArray()->and($type->isList()), []); } public function isSubTypeOf(Type $otherType) : TrinaryLogic { return $this->isSubTypeOfWithReason($otherType)->result; } public function isSubTypeOfWithReason(Type $otherType) : IsSuperTypeOfResult { if ($otherType instanceof UnionType || $otherType instanceof IntersectionType) { return $otherType->isSuperTypeOfWithReason($this); } return (new IsSuperTypeOfResult($otherType->isArray()->and($otherType->isList()), []))->and($otherType instanceof self ? IsSuperTypeOfResult::createYes() : IsSuperTypeOfResult::createMaybe()); } public function isAcceptedBy(Type $acceptingType, bool $strictTypes) : TrinaryLogic { return $this->isAcceptedWithReasonBy($acceptingType, $strictTypes)->result; } public function isAcceptedWithReasonBy(Type $acceptingType, bool $strictTypes) : AcceptsResult { return $this->isSubTypeOfWithReason($acceptingType)->toAcceptsResult(); } public function equals(Type $type) : bool { return $type instanceof self; } public function describe(VerbosityLevel $level) : string { return 'list'; } public function isOffsetAccessible() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isOffsetAccessLegal() : TrinaryLogic { return TrinaryLogic::createYes(); } public function hasOffsetValueType(Type $offsetType) : TrinaryLogic { return $this->getIterableKeyType()->isSuperTypeOf($offsetType)->and(TrinaryLogic::createMaybe()); } public function getOffsetValueType(Type $offsetType) : Type { return new MixedType(); } public function setOffsetValueType(?Type $offsetType, Type $valueType, bool $unionValues = \true) : Type { if ($offsetType === null || (new ConstantIntegerType(0))->isSuperTypeOf($offsetType)->yes()) { return $this; } return new ErrorType(); } public function setExistingOffsetValueType(Type $offsetType, Type $valueType) : Type { if ((new ConstantIntegerType(0))->isSuperTypeOf($offsetType)->yes()) { return $this; } return new ErrorType(); } public function unsetOffset(Type $offsetType) : Type { if ($this->hasOffsetValueType($offsetType)->no()) { return $this; } return new ErrorType(); } public function getKeysArray() : Type { return $this; } public function getValuesArray() : Type { return $this; } public function chunkArray(Type $lengthType, TrinaryLogic $preserveKeys) : Type { return $this; } public function fillKeysArray(Type $valueType) : Type { return new MixedType(); } public function flipArray() : Type { return new MixedType(); } public function intersectKeyArray(Type $otherArraysType) : Type { if ($otherArraysType->isList()->yes()) { return $this; } return new MixedType(); } public function popArray() : Type { return $this; } public function reverseArray(TrinaryLogic $preserveKeys) : Type { if ($preserveKeys->no()) { return $this; } return new MixedType(); } public function searchArray(Type $needleType) : Type { return new MixedType(); } public function shiftArray() : Type { return $this; } public function shuffleArray() : Type { return $this; } public function sliceArray(Type $offsetType, Type $lengthType, TrinaryLogic $preserveKeys) : Type { if ($preserveKeys->no()) { return $this; } if ((new ConstantIntegerType(0))->isSuperTypeOf($offsetType)->yes()) { return $this; } return new MixedType(); } public function isIterable() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isIterableAtLeastOnce() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getArraySize() : Type { return IntegerRangeType::fromInterval(0, null); } public function getIterableKeyType() : Type { return IntegerRangeType::fromInterval(0, null); } public function getFirstIterableKeyType() : Type { return new ConstantIntegerType(0); } public function getLastIterableKeyType() : Type { return $this->getIterableKeyType(); } public function getIterableValueType() : Type { return new MixedType(); } public function getFirstIterableValueType() : Type { return new MixedType(); } public function getLastIterableValueType() : Type { return new MixedType(); } public function isArray() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isConstantArray() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isOversizedArray() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isList() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isNull() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isConstantValue() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isConstantScalarValue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getConstantScalarTypes() : array { return []; } public function getConstantScalarValues() : array { return []; } public function isTrue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFalse() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isBoolean() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFloat() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isInteger() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isNumericString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isNonEmptyString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isNonFalsyString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isLiteralString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isLowercaseString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isUppercaseString() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isClassStringType() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getClassStringObjectType() : Type { return new ErrorType(); } public function getObjectTypeOrClassStringObjectType() : Type { return new ErrorType(); } public function isVoid() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isScalar() : TrinaryLogic { return TrinaryLogic::createNo(); } public function looseCompare(Type $type, PhpVersion $phpVersion) : BooleanType { return new BooleanType(); } public function toNumber() : Type { return new ErrorType(); } public function toAbsoluteNumber() : Type { return new ErrorType(); } public function toInteger() : Type { return TypeCombinator::union(new ConstantIntegerType(0), new ConstantIntegerType(1)); } public function toFloat() : Type { return TypeCombinator::union(new ConstantFloatType(0.0), new ConstantFloatType(1.0)); } public function toString() : Type { return new ErrorType(); } public function toArray() : Type { return $this; } public function toArrayKey() : Type { return new ErrorType(); } public function traverse(callable $cb) : Type { return $this; } public function traverseSimultaneously(Type $right, callable $cb) : Type { return $this; } public static function __set_state(array $properties) : Type { return new self(); } public static function setListTypeEnabled(bool $enabled) : void { self::$enabled = $enabled; } public static function isListTypeEnabled() : bool { return self::$enabled; } public static function intersectWith(Type $type) : Type { if (self::$enabled) { return TypeCombinator::intersect($type, new self()); } return $type; } public function exponentiate(Type $exponent) : Type { return new ErrorType(); } public function getFiniteTypes() : array { return []; } public function toPhpDocNode() : TypeNode { return new IdentifierTypeNode('list'); } } <?php declare (strict_types=1); namespace PHPStan\Type\Accessory; use PHPStan\Php\PhpVersion; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\TrinaryLogic; use PHPStan\Type\AcceptsResult; use PHPStan\Type\BooleanType; use PHPStan\Type\CompoundType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\ErrorType; use PHPStan\Type\IntegerRangeType; use PHPStan\Type\IntersectionType; use PHPStan\Type\IsSuperTypeOfResult; use PHPStan\Type\MixedType; use PHPStan\Type\ObjectWithoutClassType; use PHPStan\Type\Traits\MaybeArrayTypeTrait; use PHPStan\Type\Traits\MaybeCallableTypeTrait; use PHPStan\Type\Traits\MaybeIterableTypeTrait; use PHPStan\Type\Traits\MaybeObjectTypeTrait; use PHPStan\Type\Traits\NonGeneralizableTypeTrait; use PHPStan\Type\Traits\NonGenericTypeTrait; use PHPStan\Type\Traits\NonRemoveableTypeTrait; use PHPStan\Type\Traits\TruthyBooleanTypeTrait; use PHPStan\Type\Traits\UndecidedComparisonCompoundTypeTrait; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\UnionType; use PHPStan\Type\VerbosityLevel; use function sprintf; class HasOffsetType implements CompoundType, \PHPStan\Type\Accessory\AccessoryType { /** * @var ConstantStringType|ConstantIntegerType */ private $offsetType; use MaybeArrayTypeTrait; use MaybeCallableTypeTrait; use MaybeIterableTypeTrait; use MaybeObjectTypeTrait; use TruthyBooleanTypeTrait; use NonGenericTypeTrait; use UndecidedComparisonCompoundTypeTrait; use NonRemoveableTypeTrait; use NonGeneralizableTypeTrait; /** * @api * @param ConstantStringType|ConstantIntegerType $offsetType */ public function __construct(Type $offsetType) { $this->offsetType = $offsetType; } /** * @return ConstantStringType|ConstantIntegerType */ public function getOffsetType() : Type { return $this->offsetType; } public function getReferencedClasses() : array { return []; } public function getObjectClassNames() : array { return []; } public function getObjectClassReflections() : array { return []; } public function getConstantStrings() : array { return []; } public function accepts(Type $type, bool $strictTypes) : TrinaryLogic { return $this->acceptsWithReason($type, $strictTypes)->result; } public function acceptsWithReason(Type $type, bool $strictTypes) : AcceptsResult { if ($type instanceof CompoundType) { return $type->isAcceptedWithReasonBy($this, $strictTypes); } return new AcceptsResult($type->isOffsetAccessible()->and($type->hasOffsetValueType($this->offsetType)), []); } public function isSuperTypeOf(Type $type) : TrinaryLogic { return $this->isSuperTypeOfWithReason($type)->result; } public function isSuperTypeOfWithReason(Type $type) : IsSuperTypeOfResult { if ($this->equals($type)) { return IsSuperTypeOfResult::createYes(); } return new IsSuperTypeOfResult($type->isOffsetAccessible()->and($type->hasOffsetValueType($this->offsetType)), []); } public function isSubTypeOf(Type $otherType) : TrinaryLogic { return $this->isSubTypeOfWithReason($otherType)->result; } public function isSubTypeOfWithReason(Type $otherType) : IsSuperTypeOfResult { if ($otherType instanceof UnionType || $otherType instanceof IntersectionType) { return $otherType->isSuperTypeOfWithReason($this); } $result = new IsSuperTypeOfResult($otherType->isOffsetAccessible()->and($otherType->hasOffsetValueType($this->offsetType)), []); return $result->and($otherType instanceof self ? IsSuperTypeOfResult::createYes() : IsSuperTypeOfResult::createMaybe()); } public function isAcceptedBy(Type $acceptingType, bool $strictTypes) : TrinaryLogic { return $this->isAcceptedWithReasonBy($acceptingType, $strictTypes)->result; } public function isAcceptedWithReasonBy(Type $acceptingType, bool $strictTypes) : AcceptsResult { return $this->isSubTypeOfWithReason($acceptingType)->toAcceptsResult(); } public function equals(Type $type) : bool { return $type instanceof self && $this->offsetType->equals($type->offsetType); } public function describe(VerbosityLevel $level) : string { return sprintf('hasOffset(%s)', $this->offsetType->describe($level)); } public function isOffsetAccessible() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isOffsetAccessLegal() : TrinaryLogic { return TrinaryLogic::createYes(); } public function hasOffsetValueType(Type $offsetType) : TrinaryLogic { if ($offsetType->isConstantScalarValue()->yes() && $offsetType->equals($this->offsetType)) { return TrinaryLogic::createYes(); } return TrinaryLogic::createMaybe(); } public function getOffsetValueType(Type $offsetType) : Type { return new MixedType(); } public function setOffsetValueType(?Type $offsetType, Type $valueType, bool $unionValues = \true) : Type { return $this; } public function setExistingOffsetValueType(Type $offsetType, Type $valueType) : Type { return $this; } public function unsetOffset(Type $offsetType) : Type { if ($this->offsetType->isSuperTypeOf($offsetType)->yes()) { return new ErrorType(); } return $this; } public function chunkArray(Type $lengthType, TrinaryLogic $preserveKeys) : Type { return new \PHPStan\Type\Accessory\NonEmptyArrayType(); } public function fillKeysArray(Type $valueType) : Type { return new \PHPStan\Type\Accessory\NonEmptyArrayType(); } public function intersectKeyArray(Type $otherArraysType) : Type { if ($otherArraysType->hasOffsetValueType($this->offsetType)->yes()) { return $this; } return new MixedType(); } public function reverseArray(TrinaryLogic $preserveKeys) : Type { if ($preserveKeys->yes()) { return $this; } return new \PHPStan\Type\Accessory\NonEmptyArrayType(); } public function shuffleArray() : Type { return new \PHPStan\Type\Accessory\NonEmptyArrayType(); } public function sliceArray(Type $offsetType, Type $lengthType, TrinaryLogic $preserveKeys) : Type { if ($this->offsetType->isSuperTypeOf($offsetType)->yes() && ($lengthType->isNull()->yes() || IntegerRangeType::fromInterval(1, null)->isSuperTypeOf($lengthType)->yes())) { return $preserveKeys->yes() ? TypeCombinator::intersect($this, new \PHPStan\Type\Accessory\NonEmptyArrayType()) : new \PHPStan\Type\Accessory\NonEmptyArrayType(); } return new MixedType(); } public function isIterableAtLeastOnce() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isList() : TrinaryLogic { if ($this->offsetType->isString()->yes()) { return TrinaryLogic::createNo(); } return TrinaryLogic::createMaybe(); } public function isNull() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isConstantValue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isConstantScalarValue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getConstantScalarTypes() : array { return []; } public function getConstantScalarValues() : array { return []; } public function isTrue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFalse() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isBoolean() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFloat() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isInteger() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isNumericString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isNonEmptyString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isNonFalsyString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isLiteralString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isLowercaseString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isUppercaseString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isClassStringType() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getClassStringObjectType() : Type { return new ObjectWithoutClassType(); } public function getObjectTypeOrClassStringObjectType() : Type { return new ObjectWithoutClassType(); } public function isVoid() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isScalar() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function looseCompare(Type $type, PhpVersion $phpVersion) : BooleanType { return new BooleanType(); } public function getKeysArray() : Type { return new \PHPStan\Type\Accessory\NonEmptyArrayType(); } public function getValuesArray() : Type { return new \PHPStan\Type\Accessory\NonEmptyArrayType(); } public function toNumber() : Type { return new ErrorType(); } public function toAbsoluteNumber() : Type { return new ErrorType(); } public function toInteger() : Type { return new ErrorType(); } public function toFloat() : Type { return new ErrorType(); } public function toString() : Type { return new ErrorType(); } public function toArray() : Type { return new MixedType(); } public function toArrayKey() : Type { return new ErrorType(); } public function getEnumCases() : array { return []; } public function traverse(callable $cb) : Type { return $this; } public function traverseSimultaneously(Type $right, callable $cb) : Type { return $this; } public function exponentiate(Type $exponent) : Type { return new ErrorType(); } public function getFiniteTypes() : array { return []; } public static function __set_state(array $properties) : Type { return new self($properties['offsetType']); } public function toPhpDocNode() : TypeNode { return new IdentifierTypeNode(''); // no PHPDoc representation } } <?php declare (strict_types=1); namespace PHPStan\Type\Accessory; use PHPStan\Php\PhpVersion; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\TrinaryLogic; use PHPStan\Type\AcceptsResult; use PHPStan\Type\BenevolentUnionType; use PHPStan\Type\BooleanType; use PHPStan\Type\CompoundType; use PHPStan\Type\Constant\ConstantArrayType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\ErrorType; use PHPStan\Type\FloatType; use PHPStan\Type\GeneralizePrecision; use PHPStan\Type\IntegerType; use PHPStan\Type\IntersectionType; use PHPStan\Type\IsSuperTypeOfResult; use PHPStan\Type\ObjectWithoutClassType; use PHPStan\Type\StringType; use PHPStan\Type\Traits\MaybeCallableTypeTrait; use PHPStan\Type\Traits\NonArrayTypeTrait; use PHPStan\Type\Traits\NonGenericTypeTrait; use PHPStan\Type\Traits\NonIterableTypeTrait; use PHPStan\Type\Traits\NonObjectTypeTrait; use PHPStan\Type\Traits\NonRemoveableTypeTrait; use PHPStan\Type\Traits\TruthyBooleanTypeTrait; use PHPStan\Type\Traits\UndecidedComparisonCompoundTypeTrait; use PHPStan\Type\Type; use PHPStan\Type\UnionType; use PHPStan\Type\VerbosityLevel; class AccessoryNonFalsyStringType implements CompoundType, \PHPStan\Type\Accessory\AccessoryType { use MaybeCallableTypeTrait; use NonArrayTypeTrait; use NonObjectTypeTrait; use NonIterableTypeTrait; use TruthyBooleanTypeTrait; use UndecidedComparisonCompoundTypeTrait; use NonGenericTypeTrait; use NonRemoveableTypeTrait; /** @api */ public function __construct() { } public function getReferencedClasses() : array { return []; } public function getObjectClassNames() : array { return []; } public function getObjectClassReflections() : array { return []; } public function getConstantStrings() : array { return []; } public function accepts(Type $type, bool $strictTypes) : TrinaryLogic { return $this->acceptsWithReason($type, $strictTypes)->result; } public function acceptsWithReason(Type $type, bool $strictTypes) : AcceptsResult { if ($type instanceof CompoundType) { return $type->isAcceptedWithReasonBy($this, $strictTypes); } return new AcceptsResult($type->isNonFalsyString(), []); } public function isSuperTypeOf(Type $type) : TrinaryLogic { return $this->isSuperTypeOfWithReason($type)->result; } public function isSuperTypeOfWithReason(Type $type) : IsSuperTypeOfResult { if ($type instanceof CompoundType) { return $type->isSubTypeOfWithReason($this); } if ($this->equals($type)) { return IsSuperTypeOfResult::createYes(); } return new IsSuperTypeOfResult($type->isNonFalsyString(), []); } public function isSubTypeOf(Type $otherType) : TrinaryLogic { return $this->isSubTypeOfWithReason($otherType)->result; } public function isSubTypeOfWithReason(Type $otherType) : IsSuperTypeOfResult { if ($otherType instanceof UnionType || $otherType instanceof IntersectionType) { return $otherType->isSuperTypeOfWithReason($this); } if ($otherType instanceof \PHPStan\Type\Accessory\AccessoryNonEmptyStringType) { return IsSuperTypeOfResult::createYes(); } return (new IsSuperTypeOfResult($otherType->isNonFalsyString(), []))->and($otherType instanceof self ? IsSuperTypeOfResult::createYes() : IsSuperTypeOfResult::createMaybe()); } public function isAcceptedBy(Type $acceptingType, bool $strictTypes) : TrinaryLogic { return $this->isAcceptedWithReasonBy($acceptingType, $strictTypes)->result; } public function isAcceptedWithReasonBy(Type $acceptingType, bool $strictTypes) : AcceptsResult { return $this->isSubTypeOfWithReason($acceptingType)->toAcceptsResult(); } public function equals(Type $type) : bool { return $type instanceof self; } public function describe(VerbosityLevel $level) : string { return 'non-falsy-string'; } public function isOffsetAccessible() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isOffsetAccessLegal() : TrinaryLogic { return TrinaryLogic::createYes(); } public function hasOffsetValueType(Type $offsetType) : TrinaryLogic { return $offsetType->isInteger()->and(TrinaryLogic::createMaybe()); } public function getOffsetValueType(Type $offsetType) : Type { if ($this->hasOffsetValueType($offsetType)->no()) { return new ErrorType(); } return new StringType(); } public function setOffsetValueType(?Type $offsetType, Type $valueType, bool $unionValues = \true) : Type { $stringOffset = (new StringType())->setOffsetValueType($offsetType, $valueType, $unionValues); if ($stringOffset instanceof ErrorType) { return $stringOffset; } if ($valueType->isNonFalsyString()->yes()) { return $this; } return new StringType(); } public function setExistingOffsetValueType(Type $offsetType, Type $valueType) : Type { return $this; } public function unsetOffset(Type $offsetType) : Type { return new ErrorType(); } public function toNumber() : Type { return new ErrorType(); } public function toAbsoluteNumber() : Type { return new ErrorType(); } public function toInteger() : Type { return new IntegerType(); } public function toFloat() : Type { return new FloatType(); } public function toString() : Type { return $this; } public function toArray() : Type { return new ConstantArrayType([new ConstantIntegerType(0)], [$this], [1], [], TrinaryLogic::createYes()); } public function toArrayKey() : Type { return $this; } public function isNull() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isConstantValue() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isConstantScalarValue() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getConstantScalarTypes() : array { return []; } public function getConstantScalarValues() : array { return []; } public function isTrue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFalse() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isBoolean() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFloat() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isInteger() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isString() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isNumericString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isNonEmptyString() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isNonFalsyString() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isLiteralString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isLowercaseString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isUppercaseString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isClassStringType() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getClassStringObjectType() : Type { return new ObjectWithoutClassType(); } public function getObjectTypeOrClassStringObjectType() : Type { return new ObjectWithoutClassType(); } public function isVoid() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isScalar() : TrinaryLogic { return TrinaryLogic::createYes(); } public function looseCompare(Type $type, PhpVersion $phpVersion) : BooleanType { return new BooleanType(); } public function traverse(callable $cb) : Type { return $this; } public function traverseSimultaneously(Type $right, callable $cb) : Type { return $this; } public function generalize(GeneralizePrecision $precision) : Type { return new StringType(); } public static function __set_state(array $properties) : Type { return new self(); } public function exponentiate(Type $exponent) : Type { return new BenevolentUnionType([new FloatType(), new IntegerType()]); } public function getFiniteTypes() : array { return []; } public function toPhpDocNode() : TypeNode { return new IdentifierTypeNode('non-falsy-string'); } } <?php declare (strict_types=1); namespace PHPStan\Type\Accessory; use PHPStan\Php\PhpVersion; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\TrinaryLogic; use PHPStan\Type\AcceptsResult; use PHPStan\Type\BenevolentUnionType; use PHPStan\Type\BooleanType; use PHPStan\Type\CompoundType; use PHPStan\Type\Constant\ConstantArrayType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\ErrorType; use PHPStan\Type\FloatType; use PHPStan\Type\GeneralizePrecision; use PHPStan\Type\IntegerType; use PHPStan\Type\IntersectionType; use PHPStan\Type\IsSuperTypeOfResult; use PHPStan\Type\StringType; use PHPStan\Type\Traits\NonArrayTypeTrait; use PHPStan\Type\Traits\NonCallableTypeTrait; use PHPStan\Type\Traits\NonGenericTypeTrait; use PHPStan\Type\Traits\NonIterableTypeTrait; use PHPStan\Type\Traits\NonObjectTypeTrait; use PHPStan\Type\Traits\UndecidedBooleanTypeTrait; use PHPStan\Type\Traits\UndecidedComparisonCompoundTypeTrait; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\UnionType; use PHPStan\Type\VerbosityLevel; class AccessoryNumericStringType implements CompoundType, \PHPStan\Type\Accessory\AccessoryType { use NonArrayTypeTrait; use NonCallableTypeTrait; use NonObjectTypeTrait; use NonIterableTypeTrait; use UndecidedBooleanTypeTrait; use UndecidedComparisonCompoundTypeTrait; use NonGenericTypeTrait; /** @api */ public function __construct() { } public function getReferencedClasses() : array { return []; } public function getObjectClassNames() : array { return []; } public function getObjectClassReflections() : array { return []; } public function getConstantStrings() : array { return []; } public function accepts(Type $type, bool $strictTypes) : TrinaryLogic { return $this->acceptsWithReason($type, $strictTypes)->result; } public function acceptsWithReason(Type $type, bool $strictTypes) : AcceptsResult { if ($type instanceof CompoundType) { return $type->isAcceptedWithReasonBy($this, $strictTypes); } return new AcceptsResult($type->isNumericString(), []); } public function isSuperTypeOf(Type $type) : TrinaryLogic { return $this->isSuperTypeOfWithReason($type)->result; } public function isSuperTypeOfWithReason(Type $type) : IsSuperTypeOfResult { if ($type instanceof CompoundType) { return $type->isSubTypeOfWithReason($this); } if ($this->equals($type)) { return IsSuperTypeOfResult::createYes(); } return new IsSuperTypeOfResult($type->isNumericString(), []); } public function isSubTypeOf(Type $otherType) : TrinaryLogic { return $this->isSubTypeOfWithReason($otherType)->result; } public function isSubTypeOfWithReason(Type $otherType) : IsSuperTypeOfResult { if ($otherType instanceof UnionType || $otherType instanceof IntersectionType) { return $otherType->isSuperTypeOfWithReason($this); } return (new IsSuperTypeOfResult($otherType->isNumericString(), []))->and($otherType instanceof self ? IsSuperTypeOfResult::createYes() : IsSuperTypeOfResult::createMaybe()); } public function isAcceptedBy(Type $acceptingType, bool $strictTypes) : TrinaryLogic { return $this->isAcceptedWithReasonBy($acceptingType, $strictTypes)->result; } public function isAcceptedWithReasonBy(Type $acceptingType, bool $strictTypes) : AcceptsResult { if ($acceptingType->isNonFalsyString()->yes()) { return AcceptsResult::createMaybe(); } if ($acceptingType->isNonEmptyString()->yes()) { return AcceptsResult::createYes(); } return $this->isSubTypeOfWithReason($acceptingType)->toAcceptsResult(); } public function equals(Type $type) : bool { return $type instanceof self; } public function describe(VerbosityLevel $level) : string { return 'numeric-string'; } public function isOffsetAccessible() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isOffsetAccessLegal() : TrinaryLogic { return TrinaryLogic::createYes(); } public function hasOffsetValueType(Type $offsetType) : TrinaryLogic { return $offsetType->isInteger()->and(TrinaryLogic::createMaybe()); } public function getOffsetValueType(Type $offsetType) : Type { if ($this->hasOffsetValueType($offsetType)->no()) { return new ErrorType(); } return new StringType(); } public function setOffsetValueType(?Type $offsetType, Type $valueType, bool $unionValues = \true) : Type { $stringOffset = (new StringType())->setOffsetValueType($offsetType, $valueType, $unionValues); if ($stringOffset instanceof ErrorType) { return $stringOffset; } return $this; } public function setExistingOffsetValueType(Type $offsetType, Type $valueType) : Type { return $this; } public function unsetOffset(Type $offsetType) : Type { return new ErrorType(); } public function toNumber() : Type { return new UnionType([$this->toInteger(), $this->toFloat()]); } public function toAbsoluteNumber() : Type { return $this->toNumber()->toAbsoluteNumber(); } public function toInteger() : Type { return new IntegerType(); } public function toFloat() : Type { return new FloatType(); } public function toString() : Type { return $this; } public function toArray() : Type { return new ConstantArrayType([new ConstantIntegerType(0)], [$this], [1], [], TrinaryLogic::createYes()); } public function toArrayKey() : Type { return new IntegerType(); } public function isNull() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isConstantValue() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isConstantScalarValue() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getConstantScalarTypes() : array { return []; } public function getConstantScalarValues() : array { return []; } public function isTrue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFalse() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isBoolean() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFloat() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isInteger() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isString() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isNumericString() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isNonEmptyString() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isNonFalsyString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isLiteralString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isLowercaseString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isUppercaseString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isClassStringType() : TrinaryLogic { return TrinaryLogic::createNo(); } public function getClassStringObjectType() : Type { return new ErrorType(); } public function getObjectTypeOrClassStringObjectType() : Type { return new ErrorType(); } public function isVoid() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isScalar() : TrinaryLogic { return TrinaryLogic::createYes(); } public function looseCompare(Type $type, PhpVersion $phpVersion) : BooleanType { return new BooleanType(); } public function traverse(callable $cb) : Type { return $this; } public function traverseSimultaneously(Type $right, callable $cb) : Type { return $this; } public function generalize(GeneralizePrecision $precision) : Type { return new StringType(); } public static function __set_state(array $properties) : Type { return new self(); } public function tryRemove(Type $typeToRemove) : ?Type { if ($typeToRemove instanceof ConstantStringType && $typeToRemove->getValue() === '0') { return TypeCombinator::intersect($this, new \PHPStan\Type\Accessory\AccessoryNonFalsyStringType()); } return null; } public function exponentiate(Type $exponent) : Type { return new BenevolentUnionType([new FloatType(), new IntegerType()]); } public function getFiniteTypes() : array { return []; } public function toPhpDocNode() : TypeNode { return new IdentifierTypeNode('numeric-string'); } } <?php declare (strict_types=1); namespace PHPStan\Type\Accessory; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\Reflection\ClassMemberAccessAnswerer; use PHPStan\Reflection\TrivialParametersAcceptor; use PHPStan\TrinaryLogic; use PHPStan\Type\AcceptsResult; use PHPStan\Type\CompoundType; use PHPStan\Type\ErrorType; use PHPStan\Type\IntersectionType; use PHPStan\Type\IsSuperTypeOfResult; use PHPStan\Type\Traits\NonGeneralizableTypeTrait; use PHPStan\Type\Traits\NonGenericTypeTrait; use PHPStan\Type\Traits\NonRemoveableTypeTrait; use PHPStan\Type\Traits\ObjectTypeTrait; use PHPStan\Type\Traits\UndecidedComparisonCompoundTypeTrait; use PHPStan\Type\Type; use PHPStan\Type\UnionType; use PHPStan\Type\VerbosityLevel; use function sprintf; class HasPropertyType implements \PHPStan\Type\Accessory\AccessoryType, CompoundType { /** * @var string */ private $propertyName; use ObjectTypeTrait; use NonGenericTypeTrait; use UndecidedComparisonCompoundTypeTrait; use NonRemoveableTypeTrait; use NonGeneralizableTypeTrait; /** @api */ public function __construct(string $propertyName) { $this->propertyName = $propertyName; } /** * @return string[] */ public function getReferencedClasses() : array { return []; } public function getObjectClassNames() : array { return []; } public function getObjectClassReflections() : array { return []; } public function getConstantStrings() : array { return []; } public function getPropertyName() : string { return $this->propertyName; } public function accepts(Type $type, bool $strictTypes) : TrinaryLogic { return $this->acceptsWithReason($type, $strictTypes)->result; } public function acceptsWithReason(Type $type, bool $strictTypes) : AcceptsResult { if ($type instanceof CompoundType) { return $type->isAcceptedWithReasonBy($this, $strictTypes); } return AcceptsResult::createFromBoolean($this->equals($type)); } public function isSuperTypeOf(Type $type) : TrinaryLogic { return $this->isSuperTypeOfWithReason($type)->result; } public function isSuperTypeOfWithReason(Type $type) : IsSuperTypeOfResult { return new IsSuperTypeOfResult($type->hasProperty($this->propertyName), []); } public function isSubTypeOf(Type $otherType) : TrinaryLogic { return $this->isSubTypeOfWithReason($otherType)->result; } public function isSubTypeOfWithReason(Type $otherType) : IsSuperTypeOfResult { if ($otherType instanceof UnionType || $otherType instanceof IntersectionType) { return $otherType->isSuperTypeOfWithReason($this); } if ($otherType instanceof self) { $limit = IsSuperTypeOfResult::createYes(); } else { $limit = IsSuperTypeOfResult::createMaybe(); } return $limit->and(new IsSuperTypeOfResult($otherType->hasProperty($this->propertyName), [])); } public function isAcceptedBy(Type $acceptingType, bool $strictTypes) : TrinaryLogic { return $this->isAcceptedWithReasonBy($acceptingType, $strictTypes)->result; } public function isAcceptedWithReasonBy(Type $acceptingType, bool $strictTypes) : AcceptsResult { return $this->isSubTypeOfWithReason($acceptingType)->toAcceptsResult(); } public function equals(Type $type) : bool { return $type instanceof self && $this->propertyName === $type->propertyName; } public function describe(VerbosityLevel $level) : string { return sprintf('hasProperty(%s)', $this->propertyName); } public function isOffsetAccessLegal() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function hasProperty(string $propertyName) : TrinaryLogic { if ($this->propertyName === $propertyName) { return TrinaryLogic::createYes(); } return TrinaryLogic::createMaybe(); } public function getCallableParametersAcceptors(ClassMemberAccessAnswerer $scope) : array { return [new TrivialParametersAcceptor()]; } public function getEnumCases() : array { return []; } public function traverse(callable $cb) : Type { return $this; } public function traverseSimultaneously(Type $right, callable $cb) : Type { return $this; } public function exponentiate(Type $exponent) : Type { return new ErrorType(); } public function getFiniteTypes() : array { return []; } public static function __set_state(array $properties) : Type { return new self($properties['propertyName']); } public function toPhpDocNode() : TypeNode { return new IdentifierTypeNode(''); // no PHPDoc representation } } <?php declare (strict_types=1); namespace PHPStan\Type\Accessory; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\Reflection\ClassMemberAccessAnswerer; use PHPStan\Reflection\Dummy\DummyMethodReflection; use PHPStan\Reflection\ExtendedMethodReflection; use PHPStan\Reflection\TrivialParametersAcceptor; use PHPStan\Reflection\Type\CallbackUnresolvedMethodPrototypeReflection; use PHPStan\Reflection\Type\UnresolvedMethodPrototypeReflection; use PHPStan\TrinaryLogic; use PHPStan\Type\AcceptsResult; use PHPStan\Type\CompoundType; use PHPStan\Type\ErrorType; use PHPStan\Type\IntersectionType; use PHPStan\Type\IsSuperTypeOfResult; use PHPStan\Type\StringType; use PHPStan\Type\Traits\NonGeneralizableTypeTrait; use PHPStan\Type\Traits\NonGenericTypeTrait; use PHPStan\Type\Traits\NonRemoveableTypeTrait; use PHPStan\Type\Traits\ObjectTypeTrait; use PHPStan\Type\Traits\UndecidedComparisonCompoundTypeTrait; use PHPStan\Type\Type; use PHPStan\Type\UnionType; use PHPStan\Type\VerbosityLevel; use function sprintf; use function strtolower; class HasMethodType implements \PHPStan\Type\Accessory\AccessoryType, CompoundType { /** * @var string */ private $methodName; use ObjectTypeTrait; use NonGenericTypeTrait; use UndecidedComparisonCompoundTypeTrait; use NonRemoveableTypeTrait; use NonGeneralizableTypeTrait; /** @api */ public function __construct(string $methodName) { $this->methodName = $methodName; } public function getReferencedClasses() : array { return []; } public function getObjectClassNames() : array { return []; } public function getObjectClassReflections() : array { return []; } private function getCanonicalMethodName() : string { return strtolower($this->methodName); } public function accepts(Type $type, bool $strictTypes) : TrinaryLogic { return $this->acceptsWithReason($type, $strictTypes)->result; } public function acceptsWithReason(Type $type, bool $strictTypes) : AcceptsResult { if ($type instanceof CompoundType) { return $type->isAcceptedWithReasonBy($this, $strictTypes); } return AcceptsResult::createFromBoolean($this->equals($type)); } public function isSuperTypeOf(Type $type) : TrinaryLogic { return $this->isSuperTypeOfWithReason($type)->result; } public function isSuperTypeOfWithReason(Type $type) : IsSuperTypeOfResult { return new IsSuperTypeOfResult($type->hasMethod($this->methodName), []); } public function isSubTypeOf(Type $otherType) : TrinaryLogic { return $this->isSubTypeOfWithReason($otherType)->result; } public function isSubTypeOfWithReason(Type $otherType) : IsSuperTypeOfResult { if ($otherType instanceof UnionType || $otherType instanceof IntersectionType) { return $otherType->isSuperTypeOfWithReason($this); } if ($this->isCallable()->yes() && $otherType->isCallable()->yes()) { return IsSuperTypeOfResult::createYes(); } if ($otherType instanceof self) { $limit = IsSuperTypeOfResult::createYes(); } else { $limit = IsSuperTypeOfResult::createMaybe(); } return $limit->and(new IsSuperTypeOfResult($otherType->hasMethod($this->methodName), [])); } public function isAcceptedBy(Type $acceptingType, bool $strictTypes) : TrinaryLogic { return $this->isAcceptedWithReasonBy($acceptingType, $strictTypes)->result; } public function isAcceptedWithReasonBy(Type $acceptingType, bool $strictTypes) : AcceptsResult { return $this->isSubTypeOfWithReason($acceptingType)->toAcceptsResult(); } public function equals(Type $type) : bool { return $type instanceof self && $this->getCanonicalMethodName() === $type->getCanonicalMethodName(); } public function describe(VerbosityLevel $level) : string { return sprintf('hasMethod(%s)', $this->methodName); } public function isOffsetAccessLegal() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function hasMethod(string $methodName) : TrinaryLogic { if ($this->getCanonicalMethodName() === strtolower($methodName)) { return TrinaryLogic::createYes(); } return TrinaryLogic::createMaybe(); } public function getMethod(string $methodName, ClassMemberAccessAnswerer $scope) : ExtendedMethodReflection { return $this->getUnresolvedMethodPrototype($methodName, $scope)->getTransformedMethod(); } public function getUnresolvedMethodPrototype(string $methodName, ClassMemberAccessAnswerer $scope) : UnresolvedMethodPrototypeReflection { $method = new DummyMethodReflection($this->methodName); return new CallbackUnresolvedMethodPrototypeReflection($method, $method->getDeclaringClass(), \false, static function (Type $type) : Type { return $type; }); } public function isCallable() : TrinaryLogic { if ($this->getCanonicalMethodName() === '__invoke') { return TrinaryLogic::createYes(); } return TrinaryLogic::createMaybe(); } public function toString() : Type { if ($this->getCanonicalMethodName() === '__tostring') { return new StringType(); } return new ErrorType(); } public function getCallableParametersAcceptors(ClassMemberAccessAnswerer $scope) : array { return [new TrivialParametersAcceptor()]; } public function getEnumCases() : array { return []; } public function traverse(callable $cb) : Type { return $this; } public function traverseSimultaneously(Type $right, callable $cb) : Type { return $this; } public function exponentiate(Type $exponent) : Type { return new ErrorType(); } public function getFiniteTypes() : array { return []; } public static function __set_state(array $properties) : Type { return new self($properties['methodName']); } public function toPhpDocNode() : TypeNode { return new IdentifierTypeNode(''); // no PHPDoc representation } } <?php declare (strict_types=1); namespace PHPStan\Type\Accessory; use PHPStan\Php\PhpVersion; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\TrinaryLogic; use PHPStan\Type\AcceptsResult; use PHPStan\Type\BenevolentUnionType; use PHPStan\Type\BooleanType; use PHPStan\Type\CompoundType; use PHPStan\Type\Constant\ConstantArrayType; use PHPStan\Type\Constant\ConstantIntegerType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\ErrorType; use PHPStan\Type\FloatType; use PHPStan\Type\GeneralizePrecision; use PHPStan\Type\IntegerType; use PHPStan\Type\IntersectionType; use PHPStan\Type\IsSuperTypeOfResult; use PHPStan\Type\ObjectWithoutClassType; use PHPStan\Type\StringType; use PHPStan\Type\Traits\MaybeCallableTypeTrait; use PHPStan\Type\Traits\NonArrayTypeTrait; use PHPStan\Type\Traits\NonGenericTypeTrait; use PHPStan\Type\Traits\NonIterableTypeTrait; use PHPStan\Type\Traits\NonObjectTypeTrait; use PHPStan\Type\Traits\UndecidedBooleanTypeTrait; use PHPStan\Type\Traits\UndecidedComparisonCompoundTypeTrait; use PHPStan\Type\Type; use PHPStan\Type\TypeCombinator; use PHPStan\Type\UnionType; use PHPStan\Type\VerbosityLevel; class AccessoryNonEmptyStringType implements CompoundType, \PHPStan\Type\Accessory\AccessoryType { use MaybeCallableTypeTrait; use NonArrayTypeTrait; use NonObjectTypeTrait; use NonIterableTypeTrait; use UndecidedComparisonCompoundTypeTrait; use NonGenericTypeTrait; use UndecidedBooleanTypeTrait; /** @api */ public function __construct() { } public function getReferencedClasses() : array { return []; } public function getObjectClassNames() : array { return []; } public function getObjectClassReflections() : array { return []; } public function getConstantStrings() : array { return []; } public function accepts(Type $type, bool $strictTypes) : TrinaryLogic { return $this->acceptsWithReason($type, $strictTypes)->result; } public function acceptsWithReason(Type $type, bool $strictTypes) : AcceptsResult { if ($type instanceof CompoundType) { return $type->isAcceptedWithReasonBy($this, $strictTypes); } return new AcceptsResult($type->isNonEmptyString(), []); } public function isSuperTypeOf(Type $type) : TrinaryLogic { return $this->isSuperTypeOfWithReason($type)->result; } public function isSuperTypeOfWithReason(Type $type) : IsSuperTypeOfResult { if ($type instanceof CompoundType) { return $type->isSubTypeOfWithReason($this); } if ($this->equals($type)) { return IsSuperTypeOfResult::createYes(); } if ($type->isNonFalsyString()->yes()) { return IsSuperTypeOfResult::createYes(); } return new IsSuperTypeOfResult($type->isNonEmptyString(), []); } public function isSubTypeOf(Type $otherType) : TrinaryLogic { return $this->isSubTypeOfWithReason($otherType)->result; } public function isSubTypeOfWithReason(Type $otherType) : IsSuperTypeOfResult { if ($otherType instanceof UnionType || $otherType instanceof IntersectionType) { return $otherType->isSuperTypeOfWithReason($this); } return (new IsSuperTypeOfResult($otherType->isNonEmptyString(), []))->and($otherType instanceof self ? IsSuperTypeOfResult::createYes() : IsSuperTypeOfResult::createMaybe()); } public function isAcceptedBy(Type $acceptingType, bool $strictTypes) : TrinaryLogic { return $this->isAcceptedWithReasonBy($acceptingType, $strictTypes)->result; } public function isAcceptedWithReasonBy(Type $acceptingType, bool $strictTypes) : AcceptsResult { return $this->isSubTypeOfWithReason($acceptingType)->toAcceptsResult(); } public function equals(Type $type) : bool { return $type instanceof self; } public function describe(VerbosityLevel $level) : string { return 'non-empty-string'; } public function isOffsetAccessible() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isOffsetAccessLegal() : TrinaryLogic { return TrinaryLogic::createYes(); } public function hasOffsetValueType(Type $offsetType) : TrinaryLogic { return $offsetType->isInteger()->and(TrinaryLogic::createMaybe()); } public function getOffsetValueType(Type $offsetType) : Type { if ($this->hasOffsetValueType($offsetType)->no()) { return new ErrorType(); } if ((new ConstantIntegerType(0))->isSuperTypeOf($offsetType)->yes()) { return new IntersectionType([new StringType(), new \PHPStan\Type\Accessory\AccessoryNonEmptyStringType()]); } return new StringType(); } public function setOffsetValueType(?Type $offsetType, Type $valueType, bool $unionValues = \true) : Type { $stringOffset = (new StringType())->setOffsetValueType($offsetType, $valueType, $unionValues); if ($stringOffset instanceof ErrorType) { return $stringOffset; } return $this; } public function setExistingOffsetValueType(Type $offsetType, Type $valueType) : Type { return $this; } public function unsetOffset(Type $offsetType) : Type { return new ErrorType(); } public function toNumber() : Type { return new ErrorType(); } public function toAbsoluteNumber() : Type { return new ErrorType(); } public function toInteger() : Type { return new IntegerType(); } public function toFloat() : Type { return new FloatType(); } public function toString() : Type { return $this; } public function toArray() : Type { return new ConstantArrayType([new ConstantIntegerType(0)], [$this], [1], [], TrinaryLogic::createYes()); } public function toArrayKey() : Type { return $this; } public function isNull() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isConstantValue() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isConstantScalarValue() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getConstantScalarTypes() : array { return []; } public function getConstantScalarValues() : array { return []; } public function isTrue() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFalse() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isBoolean() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isFloat() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isInteger() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isString() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isNumericString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isNonEmptyString() : TrinaryLogic { return TrinaryLogic::createYes(); } public function isNonFalsyString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isLiteralString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isLowercaseString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isUppercaseString() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function isClassStringType() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getClassStringObjectType() : Type { return new ObjectWithoutClassType(); } public function getObjectTypeOrClassStringObjectType() : Type { return new ObjectWithoutClassType(); } public function isVoid() : TrinaryLogic { return TrinaryLogic::createNo(); } public function isScalar() : TrinaryLogic { return TrinaryLogic::createYes(); } public function looseCompare(Type $type, PhpVersion $phpVersion) : BooleanType { return new BooleanType(); } public function traverse(callable $cb) : Type { return $this; } public function traverseSimultaneously(Type $right, callable $cb) : Type { return $this; } public function generalize(GeneralizePrecision $precision) : Type { return new StringType(); } public static function __set_state(array $properties) : Type { return new self(); } public function tryRemove(Type $typeToRemove) : ?Type { if ($typeToRemove instanceof ConstantStringType && $typeToRemove->getValue() === '0') { return TypeCombinator::intersect($this, new \PHPStan\Type\Accessory\AccessoryNonFalsyStringType()); } return null; } public function exponentiate(Type $exponent) : Type { return new BenevolentUnionType([new FloatType(), new IntegerType()]); } public function getFiniteTypes() : array { return []; } public function toPhpDocNode() : TypeNode { return new IdentifierTypeNode('non-empty-string'); } } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\PhpDocParser\Ast\Type\ThisTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\ReflectionProviderStaticAccessor; use PHPStan\TrinaryLogic; use function sprintf; /** @api */ class ThisType extends \PHPStan\Type\StaticType { /** * @api */ public function __construct(ClassReflection $classReflection, ?\PHPStan\Type\Type $subtractedType = null) { parent::__construct($classReflection, $subtractedType); } public function changeBaseClass(ClassReflection $classReflection) : \PHPStan\Type\StaticType { return new self($classReflection, $this->getSubtractedType()); } public function describe(\PHPStan\Type\VerbosityLevel $level) : string { return sprintf('$this(%s)', $this->getStaticObjectType()->describe($level)); } public function isSuperTypeOf(\PHPStan\Type\Type $type) : TrinaryLogic { return $this->isSuperTypeOfWithReason($type)->result; } public function isSuperTypeOfWithReason(\PHPStan\Type\Type $type) : \PHPStan\Type\IsSuperTypeOfResult { if ($type instanceof self) { return $this->getStaticObjectType()->isSuperTypeOfWithReason($type); } if ($type instanceof \PHPStan\Type\CompoundType) { return $type->isSubTypeOfWithReason($this); } $parent = new parent($this->getClassReflection(), $this->getSubtractedType()); return $parent->isSuperTypeOfWithReason($type)->and(\PHPStan\Type\IsSuperTypeOfResult::createMaybe()); } public function changeSubtractedType(?\PHPStan\Type\Type $subtractedType) : \PHPStan\Type\Type { $type = parent::changeSubtractedType($subtractedType); if ($type instanceof parent) { return new self($type->getClassReflection(), $subtractedType); } return $type; } public function traverse(callable $cb) : \PHPStan\Type\Type { $subtractedType = $this->getSubtractedType() !== null ? $cb($this->getSubtractedType()) : null; if ($subtractedType !== $this->getSubtractedType()) { return new self($this->getClassReflection(), $subtractedType); } return $this; } public function traverseSimultaneously(\PHPStan\Type\Type $right, callable $cb) : \PHPStan\Type\Type { if ($this->getSubtractedType() === null) { return $this; } return new self($this->getClassReflection()); } public function toPhpDocNode() : TypeNode { return new ThisTypeNode(); } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : \PHPStan\Type\Type { $reflectionProvider = ReflectionProviderStaticAccessor::getInstance(); if ($reflectionProvider->hasClass($properties['baseClass'])) { return new self($reflectionProvider->getClass($properties['baseClass']), $properties['subtractedType'] ?? null); } return new \PHPStan\Type\ErrorType(); } } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\Analyser\OutOfClassScope; use PHPStan\Broker\Broker; use PHPStan\PhpDocParser\Ast\ConstExpr\ConstExprStringNode; use PHPStan\PhpDocParser\Ast\Type\ConstTypeNode; use PHPStan\PhpDocParser\Ast\Type\IdentifierTypeNode; use PHPStan\PhpDocParser\Ast\Type\ObjectShapeItemNode; use PHPStan\PhpDocParser\Ast\Type\ObjectShapeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\Reflection\ClassMemberAccessAnswerer; use PHPStan\Reflection\MissingPropertyFromReflectionException; use PHPStan\Reflection\Php\UniversalObjectCratesClassReflectionExtension; use PHPStan\Reflection\PropertyReflection; use PHPStan\Reflection\ReflectionProviderStaticAccessor; use PHPStan\Reflection\Type\CallbackUnresolvedPropertyPrototypeReflection; use PHPStan\Reflection\Type\UnresolvedPropertyPrototypeReflection; use PHPStan\ShouldNotHappenException; use PHPStan\TrinaryLogic; use PHPStan\Type\Accessory\HasPropertyType; use PHPStan\Type\Constant\ConstantArrayType; use PHPStan\Type\Constant\ConstantStringType; use PHPStan\Type\Generic\TemplateTypeMap; use PHPStan\Type\Generic\TemplateTypeVariance; use PHPStan\Type\Traits\NonGeneralizableTypeTrait; use PHPStan\Type\Traits\ObjectTypeTrait; use PHPStan\Type\Traits\UndecidedComparisonTypeTrait; use function array_filter; use function array_key_exists; use function array_values; use function count; use function implode; use function in_array; use function sprintf; /** @api */ class ObjectShapeType implements \PHPStan\Type\Type { /** * @var array<string, Type> */ private $properties; /** * @var list<string> */ private $optionalProperties; use ObjectTypeTrait; use UndecidedComparisonTypeTrait; use NonGeneralizableTypeTrait; /** * @api * @param array<string, Type> $properties * @param list<string> $optionalProperties */ public function __construct(array $properties, array $optionalProperties) { $this->properties = $properties; $this->optionalProperties = $optionalProperties; } /** * @return array<string, Type> */ public function getProperties() : array { return $this->properties; } /** * @return list<string> */ public function getOptionalProperties() : array { return $this->optionalProperties; } public function getReferencedClasses() : array { $classes = []; foreach ($this->properties as $propertyType) { foreach ($propertyType->getReferencedClasses() as $referencedClass) { $classes[] = $referencedClass; } } return $classes; } public function getObjectClassNames() : array { return []; } public function getObjectClassReflections() : array { return []; } public function hasProperty(string $propertyName) : TrinaryLogic { if (!array_key_exists($propertyName, $this->properties)) { return TrinaryLogic::createNo(); } if (in_array($propertyName, $this->optionalProperties, \true)) { return TrinaryLogic::createMaybe(); } return TrinaryLogic::createYes(); } public function getProperty(string $propertyName, ClassMemberAccessAnswerer $scope) : PropertyReflection { return $this->getUnresolvedPropertyPrototype($propertyName, $scope)->getTransformedProperty(); } public function getUnresolvedPropertyPrototype(string $propertyName, ClassMemberAccessAnswerer $scope) : UnresolvedPropertyPrototypeReflection { if (!array_key_exists($propertyName, $this->properties)) { throw new ShouldNotHappenException(); } $property = new \PHPStan\Type\ObjectShapePropertyReflection($this->properties[$propertyName]); return new CallbackUnresolvedPropertyPrototypeReflection($property, $property->getDeclaringClass(), \false, static function (\PHPStan\Type\Type $type) : \PHPStan\Type\Type { return $type; }); } public function accepts(\PHPStan\Type\Type $type, bool $strictTypes) : TrinaryLogic { return $this->acceptsWithReason($type, $strictTypes)->result; } public function acceptsWithReason(\PHPStan\Type\Type $type, bool $strictTypes) : \PHPStan\Type\AcceptsResult { if ($type instanceof \PHPStan\Type\CompoundType) { return $type->isAcceptedWithReasonBy($this, $strictTypes); } $reflectionProvider = ReflectionProviderStaticAccessor::getInstance(); foreach ($type->getObjectClassReflections() as $classReflection) { if (!UniversalObjectCratesClassReflectionExtension::isUniversalObjectCrate($reflectionProvider, Broker::getInstance()->getUniversalObjectCratesClasses(), $classReflection)) { continue; } return \PHPStan\Type\AcceptsResult::createMaybe(); } $result = \PHPStan\Type\AcceptsResult::createYes(); $scope = new OutOfClassScope(); foreach ($this->properties as $propertyName => $propertyType) { $typeHasProperty = $type->hasProperty($propertyName); $hasProperty = new \PHPStan\Type\AcceptsResult($typeHasProperty, $typeHasProperty->yes() ? [] : [sprintf('%s %s have property $%s.', $type->describe(\PHPStan\Type\VerbosityLevel::typeOnly()), $typeHasProperty->no() ? 'does not' : 'might not', $propertyName)]); if ($hasProperty->no()) { if (in_array($propertyName, $this->optionalProperties, \true)) { continue; } return $hasProperty; } if ($hasProperty->maybe() && in_array($propertyName, $this->optionalProperties, \true)) { $hasProperty = \PHPStan\Type\AcceptsResult::createYes(); } $result = $result->and($hasProperty); try { $otherProperty = $type->getProperty($propertyName, $scope); } catch (MissingPropertyFromReflectionException $e) { return new \PHPStan\Type\AcceptsResult($result->result, [sprintf('%s %s not have property $%s.', $type->describe(\PHPStan\Type\VerbosityLevel::typeOnly()), $result->no() ? 'does' : 'might', $propertyName)]); } if (!$otherProperty->isPublic()) { return new \PHPStan\Type\AcceptsResult(TrinaryLogic::createNo(), [sprintf('Property %s::$%s is not public.', $otherProperty->getDeclaringClass()->getDisplayName(), $propertyName)]); } if ($otherProperty->isStatic()) { return new \PHPStan\Type\AcceptsResult(TrinaryLogic::createNo(), [sprintf('Property %s::$%s is static.', $otherProperty->getDeclaringClass()->getDisplayName(), $propertyName)]); } if (!$otherProperty->isReadable()) { return new \PHPStan\Type\AcceptsResult(TrinaryLogic::createNo(), [sprintf('Property %s::$%s is not readable.', $otherProperty->getDeclaringClass()->getDisplayName(), $propertyName)]); } $otherPropertyType = $otherProperty->getReadableType(); $verbosity = \PHPStan\Type\VerbosityLevel::getRecommendedLevelByType($propertyType, $otherPropertyType); $acceptsValue = $propertyType->acceptsWithReason($otherPropertyType, $strictTypes)->decorateReasons(static function (string $reason) use($propertyName, $propertyType, $verbosity, $otherPropertyType) { return sprintf('Property ($%s) type %s does not accept type %s: %s', $propertyName, $propertyType->describe($verbosity), $otherPropertyType->describe($verbosity), $reason); }); if (!$acceptsValue->yes() && count($acceptsValue->reasons) === 0) { $acceptsValue = new \PHPStan\Type\AcceptsResult($acceptsValue->result, [sprintf('Property ($%s) type %s does not accept type %s.', $propertyName, $propertyType->describe($verbosity), $otherPropertyType->describe($verbosity))]); } if ($acceptsValue->no()) { return $acceptsValue; } $result = $result->and($acceptsValue); } return $result->and(new \PHPStan\Type\AcceptsResult($type->isObject(), [])); } public function isSuperTypeOf(\PHPStan\Type\Type $type) : TrinaryLogic { return $this->isSuperTypeOfWithReason($type)->result; } public function isSuperTypeOfWithReason(\PHPStan\Type\Type $type) : \PHPStan\Type\IsSuperTypeOfResult { if ($type instanceof \PHPStan\Type\CompoundType) { return $type->isSubTypeOfWithReason($this); } if ($type instanceof \PHPStan\Type\ObjectWithoutClassType) { return \PHPStan\Type\IsSuperTypeOfResult::createMaybe(); } $reflectionProvider = ReflectionProviderStaticAccessor::getInstance(); foreach ($type->getObjectClassReflections() as $classReflection) { if (!UniversalObjectCratesClassReflectionExtension::isUniversalObjectCrate($reflectionProvider, Broker::getInstance()->getUniversalObjectCratesClasses(), $classReflection)) { continue; } return \PHPStan\Type\IsSuperTypeOfResult::createMaybe(); } $result = \PHPStan\Type\IsSuperTypeOfResult::createYes(); $scope = new OutOfClassScope(); foreach ($this->properties as $propertyName => $propertyType) { $hasProperty = new \PHPStan\Type\IsSuperTypeOfResult($type->hasProperty($propertyName), []); if ($hasProperty->no()) { if (in_array($propertyName, $this->optionalProperties, \true)) { continue; } return $hasProperty; } if ($hasProperty->maybe() && in_array($propertyName, $this->optionalProperties, \true)) { $hasProperty = \PHPStan\Type\IsSuperTypeOfResult::createYes(); } $result = $result->and($hasProperty); try { $otherProperty = $type->getProperty($propertyName, $scope); } catch (MissingPropertyFromReflectionException $e) { return $result; } if (!$otherProperty->isPublic()) { return \PHPStan\Type\IsSuperTypeOfResult::createNo(); } if ($otherProperty->isStatic()) { return \PHPStan\Type\IsSuperTypeOfResult::createNo(); } if (!$otherProperty->isReadable()) { return \PHPStan\Type\IsSuperTypeOfResult::createNo(); } $otherPropertyType = $otherProperty->getReadableType(); $isSuperType = $propertyType->isSuperTypeOfWithReason($otherPropertyType); if ($isSuperType->no()) { return $isSuperType; } $result = $result->and($isSuperType); } return $result->and(new \PHPStan\Type\IsSuperTypeOfResult($type->isObject(), [])); } public function equals(\PHPStan\Type\Type $type) : bool { if (!$type instanceof self) { return \false; } if (count($this->properties) !== count($type->properties)) { return \false; } foreach ($this->properties as $name => $propertyType) { if (!array_key_exists($name, $type->properties)) { return \false; } if (!$propertyType->equals($type->properties[$name])) { return \false; } } if (count($this->optionalProperties) !== count($type->optionalProperties)) { return \false; } foreach ($this->optionalProperties as $name) { if (in_array($name, $type->optionalProperties, \true)) { continue; } return \false; } return \true; } public function tryRemove(\PHPStan\Type\Type $typeToRemove) : ?\PHPStan\Type\Type { if ($typeToRemove instanceof HasPropertyType) { $properties = $this->properties; unset($properties[$typeToRemove->getPropertyName()]); $optionalProperties = array_values(array_filter($this->optionalProperties, static function (string $propertyName) use($typeToRemove) { return $propertyName !== $typeToRemove->getPropertyName(); })); return new self($properties, $optionalProperties); } return null; } public function makePropertyRequired(string $propertyName) : self { if (array_key_exists($propertyName, $this->properties)) { $optionalProperties = array_values(array_filter($this->optionalProperties, static function (string $currentPropertyName) use($propertyName) { return $currentPropertyName !== $propertyName; })); return new self($this->properties, $optionalProperties); } return $this; } public function inferTemplateTypes(\PHPStan\Type\Type $receivedType) : TemplateTypeMap { if ($receivedType instanceof \PHPStan\Type\UnionType || $receivedType instanceof \PHPStan\Type\IntersectionType) { return $receivedType->inferTemplateTypesOn($this); } if ($receivedType instanceof self) { $typeMap = TemplateTypeMap::createEmpty(); $scope = new OutOfClassScope(); foreach ($this->properties as $name => $propertyType) { if ($receivedType->hasProperty($name)->no()) { continue; } try { $receivedProperty = $receivedType->getProperty($name, $scope); } catch (MissingPropertyFromReflectionException $e) { continue; } if (!$receivedProperty->isPublic()) { continue; } if ($receivedProperty->isStatic()) { continue; } $receivedPropertyType = $receivedProperty->getReadableType(); $typeMap = $typeMap->union($propertyType->inferTemplateTypes($receivedPropertyType)); } return $typeMap; } return TemplateTypeMap::createEmpty(); } public function getReferencedTemplateTypes(TemplateTypeVariance $positionVariance) : array { $variance = $positionVariance->compose(TemplateTypeVariance::createCovariant()); $references = []; foreach ($this->properties as $propertyType) { foreach ($propertyType->getReferencedTemplateTypes($variance) as $reference) { $references[] = $reference; } } return $references; } public function describe(\PHPStan\Type\VerbosityLevel $level) : string { $callback = function () use($level) : string { $items = []; foreach ($this->properties as $name => $propertyType) { $optional = in_array($name, $this->optionalProperties, \true); $items[] = sprintf('%s%s: %s', $name, $optional ? '?' : '', $propertyType->describe($level)); } return sprintf('object{%s}', implode(', ', $items)); }; return $level->handle($callback, $callback); } public function isOffsetAccessLegal() : TrinaryLogic { return TrinaryLogic::createMaybe(); } public function getEnumCases() : array { return []; } public function traverse(callable $cb) : \PHPStan\Type\Type { $properties = []; $stillOriginal = \true; foreach ($this->properties as $name => $propertyType) { $transformed = $cb($propertyType); if ($transformed !== $propertyType) { $stillOriginal = \false; } $properties[$name] = $transformed; } if ($stillOriginal) { return $this; } return new self($properties, $this->optionalProperties); } public function traverseSimultaneously(\PHPStan\Type\Type $right, callable $cb) : \PHPStan\Type\Type { if (!$right->isObject()->yes()) { return $this; } $properties = []; $stillOriginal = \true; $scope = new OutOfClassScope(); foreach ($this->properties as $name => $propertyType) { if (!$right->hasProperty($name)->yes()) { return $this; } $transformed = $cb($propertyType, $right->getProperty($name, $scope)->getReadableType()); if ($transformed !== $propertyType) { $stillOriginal = \false; } $properties[$name] = $transformed; } if ($stillOriginal) { return $this; } return new self($properties, $this->optionalProperties); } public function exponentiate(\PHPStan\Type\Type $exponent) : \PHPStan\Type\Type { if (!$exponent instanceof \PHPStan\Type\NeverType && !$this->isSuperTypeOf($exponent)->no()) { return \PHPStan\Type\TypeCombinator::union($this, $exponent); } return new \PHPStan\Type\BenevolentUnionType([new \PHPStan\Type\FloatType(), new \PHPStan\Type\IntegerType()]); } public function getFiniteTypes() : array { return []; } public function toPhpDocNode() : TypeNode { $items = []; foreach ($this->properties as $name => $type) { if (ConstantArrayType::isValidIdentifier($name)) { $keyNode = new IdentifierTypeNode($name); } else { $keyPhpDocNode = (new ConstantStringType($name))->toPhpDocNode(); if (!$keyPhpDocNode instanceof ConstTypeNode) { continue; } /** @var ConstExprStringNode $keyNode */ $keyNode = $keyPhpDocNode->constExpr; } $items[] = new ObjectShapeItemNode($keyNode, in_array($name, $this->optionalProperties, \true), $type->toPhpDocNode()); } return new ObjectShapeNode($items); } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : \PHPStan\Type\Type { return new self($properties['properties'], $properties['optionalProperties']); } } <?php declare (strict_types=1); namespace PHPStan\Type; /** @api */ class CircularTypeAliasErrorType extends \PHPStan\Type\ErrorType { } <?php declare (strict_types=1); namespace PHPStan\Type; use PhpParser\Node\Expr\StaticCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\MethodReflection; /** * This is the interface dynamic throw type extensions implement for static methods. * * To register it in the configuration file use the `phpstan.dynamicStaticMethodThrowTypeExtension` service tag: * * ``` * services: * - * class: App\PHPStan\MyExtension * tags: * - phpstan.dynamicStaticMethodThrowTypeExtension * ``` * * Learn more: https://phpstan.org/developing-extensions/dynamic-throw-type-extensions * * @api */ interface DynamicStaticMethodThrowTypeExtension { public function isStaticMethodSupported(MethodReflection $methodReflection) : bool; public function getThrowTypeFromStaticMethodCall(MethodReflection $methodReflection, StaticCall $methodCall, Scope $scope) : ?\PHPStan\Type\Type; } <?php declare (strict_types=1); namespace PHPStan\Type; use PhpParser\Node\Expr\FuncCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\ParameterReflection; /** * This is the interface for parameter closure type extensions for functions. * * To register it in the configuration file use the `phpstan.functionParameterClosureTypeExtension` service tag: * * ``` * services: * - * class: App\PHPStan\MyExtension * tags: * - phpstan.functionParameterClosureTypeExtension * ``` * * @api */ interface FunctionParameterClosureTypeExtension { public function isFunctionSupported(FunctionReflection $functionReflection, ParameterReflection $parameter) : bool; public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, ParameterReflection $parameter, Scope $scope) : ?\PHPStan\Type\Type; } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\PhpDocParser\Ast\Type\ConditionalTypeForParameterNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\TrinaryLogic; use PHPStan\Type\Generic\TemplateTypeVariance; use PHPStan\Type\Traits\LateResolvableTypeTrait; use PHPStan\Type\Traits\NonGeneralizableTypeTrait; use function array_merge; use function sprintf; /** @api */ final class ConditionalTypeForParameter implements \PHPStan\Type\CompoundType, \PHPStan\Type\LateResolvableType { /** * @var string */ private $parameterName; /** * @var Type */ private $target; /** * @var Type */ private $if; /** * @var Type */ private $else; /** * @var bool */ private $negated; use LateResolvableTypeTrait; use NonGeneralizableTypeTrait; public function __construct(string $parameterName, \PHPStan\Type\Type $target, \PHPStan\Type\Type $if, \PHPStan\Type\Type $else, bool $negated) { $this->parameterName = $parameterName; $this->target = $target; $this->if = $if; $this->else = $else; $this->negated = $negated; } public function getParameterName() : string { return $this->parameterName; } public function getTarget() : \PHPStan\Type\Type { return $this->target; } public function getIf() : \PHPStan\Type\Type { return $this->if; } public function getElse() : \PHPStan\Type\Type { return $this->else; } public function isNegated() : bool { return $this->negated; } public function changeParameterName(string $parameterName) : self { return new self($parameterName, $this->target, $this->if, $this->else, $this->negated); } public function toConditional(\PHPStan\Type\Type $subject) : \PHPStan\Type\Type { return new \PHPStan\Type\ConditionalType($subject, $this->target, $this->if, $this->else, $this->negated); } public function isSuperTypeOf(\PHPStan\Type\Type $type) : TrinaryLogic { return $this->isSuperTypeOfWithReason($type)->result; } public function isSuperTypeOfWithReason(\PHPStan\Type\Type $type) : \PHPStan\Type\IsSuperTypeOfResult { if ($type instanceof self) { return $this->if->isSuperTypeOfWithReason($type->if)->and($this->else->isSuperTypeOfWithReason($type->else)); } return $this->isSuperTypeOfDefault($type); } public function getReferencedClasses() : array { return array_merge($this->target->getReferencedClasses(), $this->if->getReferencedClasses(), $this->else->getReferencedClasses()); } public function getReferencedTemplateTypes(TemplateTypeVariance $positionVariance) : array { return array_merge($this->target->getReferencedTemplateTypes($positionVariance), $this->if->getReferencedTemplateTypes($positionVariance), $this->else->getReferencedTemplateTypes($positionVariance)); } public function equals(\PHPStan\Type\Type $type) : bool { return $type instanceof self && $this->parameterName === $type->parameterName && $this->target->equals($type->target) && $this->if->equals($type->if) && $this->else->equals($type->else); } public function describe(\PHPStan\Type\VerbosityLevel $level) : string { return sprintf('(%s %s %s ? %s : %s)', $this->parameterName, $this->negated ? 'is not' : 'is', $this->target->describe($level), $this->if->describe($level), $this->else->describe($level)); } public function isResolvable() : bool { return \false; } protected function getResult() : \PHPStan\Type\Type { return \PHPStan\Type\TypeCombinator::union($this->if, $this->else); } public function traverse(callable $cb) : \PHPStan\Type\Type { $target = $cb($this->target); $if = $cb($this->if); $else = $cb($this->else); if ($this->target === $target && $this->if === $if && $this->else === $else) { return $this; } return new self($this->parameterName, $target, $if, $else, $this->negated); } public function traverseSimultaneously(\PHPStan\Type\Type $right, callable $cb) : \PHPStan\Type\Type { if (!$right instanceof self) { return $this; } $target = $cb($this->target, $right->target); $if = $cb($this->if, $right->if); $else = $cb($this->else, $right->else); if ($this->target === $target && $this->if === $if && $this->else === $else) { return $this; } return new self($this->parameterName, $target, $if, $else, $this->negated); } public function toPhpDocNode() : TypeNode { return new ConditionalTypeForParameterNode($this->parameterName, $this->target->toPhpDocNode(), $this->if->toPhpDocNode(), $this->else->toPhpDocNode(), $this->negated); } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : \PHPStan\Type\Type { return new self($properties['parameterName'], $properties['target'], $properties['if'], $properties['else'], $properties['negated']); } } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\ShouldNotHappenException; use PHPStan\TrinaryLogic; use function array_map; use function array_merge; use function array_unique; use function array_values; /** * @api * @final */ class AcceptsResult { /** * @readonly * @var TrinaryLogic */ public $result; /** * @readonly * @var list<string> */ public $reasons; /** * @api * @param list<string> $reasons */ public function __construct(TrinaryLogic $result, array $reasons) { $this->result = $result; $this->reasons = $reasons; } public function yes() : bool { return $this->result->yes(); } public function maybe() : bool { return $this->result->maybe(); } public function no() : bool { return $this->result->no(); } public static function createYes() : self { return new self(TrinaryLogic::createYes(), []); } /** * @param list<string> $reasons */ public static function createNo(array $reasons = []) : self { return new self(TrinaryLogic::createNo(), $reasons); } public static function createMaybe() : self { return new self(TrinaryLogic::createMaybe(), []); } public static function createFromBoolean(bool $value) : self { return new self(TrinaryLogic::createFromBoolean($value), []); } public function and(self $other) : self { return new self($this->result->and($other->result), array_values(array_unique(array_merge($this->reasons, $other->reasons)))); } public function or(self $other) : self { return new self($this->result->or($other->result), array_values(array_unique(array_merge($this->reasons, $other->reasons)))); } /** * @param callable(string): string $cb */ public function decorateReasons(callable $cb) : self { $reasons = []; foreach ($this->reasons as $reason) { $reasons[] = $cb($reason); } return new self($this->result, $reasons); } public static function extremeIdentity(self ...$operands) : self { if ($operands === []) { throw new ShouldNotHappenException(); } $result = TrinaryLogic::extremeIdentity(...array_map(static function (self $result) { return $result->result; }, $operands)); $reasons = []; foreach ($operands as $operand) { foreach ($operand->reasons as $reason) { $reasons[] = $reason; } } return new self($result, array_values(array_unique($reasons))); } public static function maxMin(self ...$operands) : self { if ($operands === []) { throw new ShouldNotHappenException(); } $result = TrinaryLogic::maxMin(...array_map(static function (self $result) { return $result->result; }, $operands)); $reasons = []; foreach ($operands as $operand) { foreach ($operand->reasons as $reason) { $reasons[] = $reason; } } return new self($result, array_values(array_unique($reasons))); } } <?php declare (strict_types=1); namespace PHPStan\Type; use PHPStan\PhpDocParser\Ast\Type\ConditionalTypeNode; use PHPStan\PhpDocParser\Ast\Type\TypeNode; use PHPStan\TrinaryLogic; use PHPStan\Type\Generic\TemplateTypeVariance; use PHPStan\Type\Traits\LateResolvableTypeTrait; use PHPStan\Type\Traits\NonGeneralizableTypeTrait; use function array_merge; use function sprintf; /** @api */ final class ConditionalType implements \PHPStan\Type\CompoundType, \PHPStan\Type\LateResolvableType { /** * @var Type */ private $subject; /** * @var Type */ private $target; /** * @var Type */ private $if; /** * @var Type */ private $else; /** * @var bool */ private $negated; use LateResolvableTypeTrait; use NonGeneralizableTypeTrait; /** * @var ?Type */ private $normalizedIf = null; /** * @var ?Type */ private $normalizedElse = null; /** * @var ?Type */ private $subjectWithTargetIntersectedType = null; /** * @var ?Type */ private $subjectWithTargetRemovedType = null; public function __construct(\PHPStan\Type\Type $subject, \PHPStan\Type\Type $target, \PHPStan\Type\Type $if, \PHPStan\Type\Type $else, bool $negated) { $this->subject = $subject; $this->target = $target; $this->if = $if; $this->else = $else; $this->negated = $negated; } public function getSubject() : \PHPStan\Type\Type { return $this->subject; } public function getTarget() : \PHPStan\Type\Type { return $this->target; } public function getIf() : \PHPStan\Type\Type { return $this->if; } public function getElse() : \PHPStan\Type\Type { return $this->else; } public function isNegated() : bool { return $this->negated; } public function isSuperTypeOf(\PHPStan\Type\Type $type) : TrinaryLogic { return $this->isSuperTypeOfWithReason($type)->result; } public function isSuperTypeOfWithReason(\PHPStan\Type\Type $type) : \PHPStan\Type\IsSuperTypeOfResult { if ($type instanceof self) { return $this->if->isSuperTypeOfWithReason($type->if)->and($this->else->isSuperTypeOfWithReason($type->else)); } return $this->isSuperTypeOfDefault($type); } public function getReferencedClasses() : array { return array_merge($this->subject->getReferencedClasses(), $this->target->getReferencedClasses(), $this->if->getReferencedClasses(), $this->else->getReferencedClasses()); } public function getReferencedTemplateTypes(TemplateTypeVariance $positionVariance) : array { return array_merge($this->subject->getReferencedTemplateTypes($positionVariance), $this->target->getReferencedTemplateTypes($positionVariance), $this->if->getReferencedTemplateTypes($positionVariance), $this->else->getReferencedTemplateTypes($positionVariance)); } public function equals(\PHPStan\Type\Type $type) : bool { return $type instanceof self && $this->subject->equals($type->subject) && $this->target->equals($type->target) && $this->if->equals($type->if) && $this->else->equals($type->else); } public function describe(\PHPStan\Type\VerbosityLevel $level) : string { return sprintf('(%s %s %s ? %s : %s)', $this->subject->describe($level), $this->negated ? 'is not' : 'is', $this->target->describe($level), $this->if->describe($level), $this->else->describe($level)); } public function isResolvable() : bool { return !\PHPStan\Type\TypeUtils::containsTemplateType($this->subject) && !\PHPStan\Type\TypeUtils::containsTemplateType($this->target); } protected function getResult() : \PHPStan\Type\Type { $isSuperType = $this->target->isSuperTypeOf($this->subject); if ($isSuperType->yes()) { return !$this->negated ? $this->getNormalizedIf() : $this->getNormalizedElse(); } if ($isSuperType->no()) { return !$this->negated ? $this->getNormalizedElse() : $this->getNormalizedIf(); } return \PHPStan\Type\TypeCombinator::union($this->getNormalizedIf(), $this->getNormalizedElse()); } public function traverse(callable $cb) : \PHPStan\Type\Type { $subject = $cb($this->subject); $target = $cb($this->target); $if = $cb($this->getNormalizedIf()); $else = $cb($this->getNormalizedElse()); if ($this->subject === $subject && $this->target === $target && $this->getNormalizedIf() === $if && $this->getNormalizedElse() === $else) { return $this; } return new self($subject, $target, $if, $else, $this->negated); } public function traverseSimultaneously(\PHPStan\Type\Type $right, callable $cb) : \PHPStan\Type\Type { if (!$right instanceof self) { return $this; } $subject = $cb($this->subject, $right->subject); $target = $cb($this->target, $right->target); $if = $cb($this->getNormalizedIf(), $right->getNormalizedIf()); $else = $cb($this->getNormalizedElse(), $right->getNormalizedElse()); if ($this->subject === $subject && $this->target === $target && $this->getNormalizedIf() === $if && $this->getNormalizedElse() === $else) { return $this; } return new self($subject, $target, $if, $else, $this->negated); } public function toPhpDocNode() : TypeNode { return new ConditionalTypeNode($this->subject->toPhpDocNode(), $this->target->toPhpDocNode(), $this->if->toPhpDocNode(), $this->else->toPhpDocNode(), $this->negated); } /** * @param mixed[] $properties */ public static function __set_state(array $properties) : \PHPStan\Type\Type { return new self($properties['subject'], $properties['target'], $properties['if'], $properties['else'], $properties['negated']); } private function getNormalizedIf() : \PHPStan\Type\Type { return $this->normalizedIf = $this->normalizedIf ?? \PHPStan\Type\TypeTraverser::map($this->if, function (\PHPStan\Type\Type $type, callable $traverse) { return $type === $this->subject ? !$this->negated ? $this->getSubjectWithTargetIntersectedType() : $this->getSubjectWithTargetRemovedType() : $traverse($type); }); } private function getNormalizedElse() : \PHPStan\Type\Type { return $this->normalizedElse = $this->normalizedElse ?? \PHPStan\Type\TypeTraverser::map($this->else, function (\PHPStan\Type\Type $type, callable $traverse) { return $type === $this->subject ? !$this->negated ? $this->getSubjectWithTargetRemovedType() : $this->getSubjectWithTargetIntersectedType() : $traverse($type); }); } private function getSubjectWithTargetIntersectedType() : \PHPStan\Type\Type { return $this->subjectWithTargetIntersectedType = $this->subjectWithTargetIntersectedType ?? \PHPStan\Type\TypeCombinator::intersect($this->subject, $this->target); } private function getSubjectWithTargetRemovedType() : \PHPStan\Type\Type { return $this->subjectWithTargetRemovedType = $this->subjectWithTargetRemovedType ?? \PHPStan\Type\TypeCombinator::remove($this->subject, $this->target); } } <?php declare (strict_types=1); namespace PHPStan\Type; use PhpParser\Node\Expr\MethodCall; use PHPStan\Analyser\Scope; use PHPStan\Reflection\MethodReflection; /** * This is the interface dynamic throw type extensions implement for non-static methods. * * To register it in the configuration file use the `phpstan.dynamicMethodThrowTypeExtension` service tag: * * ``` * services: * - * class: App\PHPStan\MyExtension * tags: * - phpstan.dynamicMethodThrowTypeExtension * ``` * * Learn more: https://phpstan.org/developing-extensions/dynamic-throw-type-extensions * * @api */ interface DynamicMethodThrowTypeExtension { public function isMethodSupported(MethodReflection $methodReflection) : bool; public function getThrowTypeFromMethodCall(MethodReflection $methodReflection, MethodCall $methodCall, Scope $scope) : ?\PHPStan\Type\Type; } <?php declare (strict_types=1); namespace PHPStan\Broker; use PHPStan\AnalysedCodeException; use function sprintf; final class ClassNotFoundException extends AnalysedCodeException { /** * @var string */ private $className; public function __construct(string $className) { $this->className = $className; parent::__construct(sprintf('Class %s was not found while trying to analyse it - discovering symbols is probably not configured properly.', $className)); } public function getClassName() : string { return $this->className; } public function getTip() : string { return 'Learn more at https://phpstan.org/user-guide/discovering-symbols'; } } <?php declare (strict_types=1); namespace PHPStan\Broker; use PHPStan\AnalysedCodeException; use function sprintf; final class FunctionNotFoundException extends AnalysedCodeException { /** * @var string */ private $functionName; public function __construct(string $functionName) { $this->functionName = $functionName; parent::__construct(sprintf('Function %s not found while trying to analyse it - discovering symbols is probably not configured properly.', $functionName)); } public function getFunctionName() : string { return $this->functionName; } public function getTip() : string { return 'Learn more at https://phpstan.org/user-guide/discovering-symbols'; } } <?php declare (strict_types=1); namespace PHPStan\Broker; use PHPStan\AnalysedCodeException; use function sprintf; final class ConstantNotFoundException extends AnalysedCodeException { /** * @var string */ private $constantName; public function __construct(string $constantName) { $this->constantName = $constantName; parent::__construct(sprintf('Constant %s not found.', $constantName)); } public function getConstantName() : string { return $this->constantName; } public function getTip() : string { return 'Learn more at https://phpstan.org/user-guide/discovering-symbols'; } } <?php declare (strict_types=1); namespace PHPStan\Broker; use PhpParser\Node; use PHPStan\Analyser\Scope; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\FunctionReflection; use PHPStan\Reflection\GlobalConstantReflection; use PHPStan\Reflection\NamespaceAnswerer; use PHPStan\Reflection\ReflectionProvider; use PHPStan\ShouldNotHappenException; /** * @api * @final */ class Broker implements ReflectionProvider { /** * @var ReflectionProvider */ private $reflectionProvider; /** * @var string[] */ private $universalObjectCratesClasses; /** * @var ?Broker */ private static $instance = null; /** * @param string[] $universalObjectCratesClasses */ public function __construct(ReflectionProvider $reflectionProvider, array $universalObjectCratesClasses) { $this->reflectionProvider = $reflectionProvider; $this->universalObjectCratesClasses = $universalObjectCratesClasses; } public static function registerInstance(\PHPStan\Broker\Broker $broker) : void { self::$instance = $broker; } /** * @deprecated Use PHPStan\Reflection\ReflectionProviderStaticAccessor instead */ public static function getInstance() : \PHPStan\Broker\Broker { if (self::$instance === null) { throw new ShouldNotHappenException(); } return self::$instance; } /** * @deprecated Use PHPStan\Reflection\ReflectionProvider instead */ public function hasClass(string $className) : bool { return $this->reflectionProvider->hasClass($className); } /** * @deprecated Use PHPStan\Reflection\ReflectionProvider instead */ public function getClass(string $className) : ClassReflection { return $this->reflectionProvider->getClass($className); } /** * @deprecated Use PHPStan\Reflection\ReflectionProvider instead */ public function getClassName(string $className) : string { return $this->reflectionProvider->getClassName($className); } /** * @deprecated Use PHPStan\Reflection\ReflectionProvider instead */ public function supportsAnonymousClasses() : bool { return $this->reflectionProvider->supportsAnonymousClasses(); } /** * @deprecated Use PHPStan\Reflection\ReflectionProvider instead */ public function getAnonymousClassReflection(Node\Stmt\Class_ $classNode, Scope $scope) : ClassReflection { return $this->reflectionProvider->getAnonymousClassReflection($classNode, $scope); } /** * @deprecated Use PHPStan\Reflection\ReflectionProvider instead */ public function hasFunction(Node\Name $nameNode, ?NamespaceAnswerer $namespaceAnswerer) : bool { return $this->reflectionProvider->hasFunction($nameNode, $namespaceAnswerer); } /** * @deprecated Use PHPStan\Reflection\ReflectionProvider instead */ public function getFunction(Node\Name $nameNode, ?NamespaceAnswerer $namespaceAnswerer) : FunctionReflection { return $this->reflectionProvider->getFunction($nameNode, $namespaceAnswerer); } /** * @deprecated Use PHPStan\Reflection\ReflectionProvider instead */ public function resolveFunctionName(Node\Name $nameNode, ?NamespaceAnswerer $namespaceAnswerer) : ?string { return $this->reflectionProvider->resolveFunctionName($nameNode, $namespaceAnswerer); } /** * @deprecated Use PHPStan\Reflection\ReflectionProvider instead */ public function hasConstant(Node\Name $nameNode, ?NamespaceAnswerer $namespaceAnswerer) : bool { return $this->reflectionProvider->hasConstant($nameNode, $namespaceAnswerer); } /** * @deprecated Use PHPStan\Reflection\ReflectionProvider instead */ public function getConstant(Node\Name $nameNode, ?NamespaceAnswerer $namespaceAnswerer) : GlobalConstantReflection { return $this->reflectionProvider->getConstant($nameNode, $namespaceAnswerer); } /** * @deprecated Use PHPStan\Reflection\ReflectionProvider instead */ public function resolveConstantName(Node\Name $nameNode, ?NamespaceAnswerer $namespaceAnswerer) : ?string { return $this->reflectionProvider->resolveConstantName($nameNode, $namespaceAnswerer); } /** * @deprecated Inject %universalObjectCratesClasses% parameter instead. * * @return string[] */ public function getUniversalObjectCratesClasses() : array { return $this->universalObjectCratesClasses; } } <?php declare (strict_types=1); namespace PHPStan\Broker; use PHPStan\AnalysedCodeException; use Throwable; use function get_class; use function sprintf; final class ClassAutoloadingException extends AnalysedCodeException { /** * @var string */ private $className; public function __construct(string $functionName, ?Throwable $previous = null) { if ($previous !== null) { parent::__construct(sprintf('%s (%s) thrown while looking for class %s.', get_class($previous), $previous->getMessage(), $functionName), 0, $previous); } else { parent::__construct(sprintf('Class %s not found.', $functionName), 0); } $this->className = $functionName; } public function getClassName() : string { return $this->className; } public function getTip() : string { return 'Learn more at https://phpstan.org/user-guide/discovering-symbols'; } } <?php declare (strict_types=1); namespace PHPStan\Broker; use PhpParser\Node; use PHPStan\File\FileHelper; use PHPStan\File\RelativePathHelper; use PHPStan\Parser\AnonymousClassVisitor; use PHPStan\ShouldNotHappenException; use function md5; use function sprintf; final class AnonymousClassNameHelper { /** * @var FileHelper */ private $fileHelper; /** * @var RelativePathHelper */ private $relativePathHelper; public function __construct(FileHelper $fileHelper, RelativePathHelper $relativePathHelper) { $this->fileHelper = $fileHelper; $this->relativePathHelper = $relativePathHelper; } public function getAnonymousClassName(Node\Stmt\Class_ $classNode, string $filename) : string { if (isset($classNode->namespacedName)) { throw new ShouldNotHappenException(); } $filename = $this->relativePathHelper->getRelativePath($this->fileHelper->normalizePath($filename, '/')); /** @var int|null $lineIndex */ $lineIndex = $classNode->getAttribute(AnonymousClassVisitor::ATTRIBUTE_LINE_INDEX); if ($lineIndex === null) { $hash = md5(sprintf('%s:%s', $filename, $classNode->getStartLine())); } else { $hash = md5(sprintf('%s:%s:%d', $filename, $classNode->getStartLine(), $lineIndex)); } return sprintf('AnonymousClass%s', $hash); } } <?php declare (strict_types=1); namespace PHPStan\Broker; use PHPStan\DependencyInjection\Container; use PHPStan\Reflection\ReflectionProvider; final class BrokerFactory { /** * @var Container */ private $container; public const PROPERTIES_CLASS_REFLECTION_EXTENSION_TAG = 'phpstan.broker.propertiesClassReflectionExtension'; public const METHODS_CLASS_REFLECTION_EXTENSION_TAG = 'phpstan.broker.methodsClassReflectionExtension'; public const ALLOWED_SUB_TYPES_CLASS_REFLECTION_EXTENSION_TAG = 'phpstan.broker.allowedSubTypesClassReflectionExtension'; public const DYNAMIC_METHOD_RETURN_TYPE_EXTENSION_TAG = 'phpstan.broker.dynamicMethodReturnTypeExtension'; public const DYNAMIC_STATIC_METHOD_RETURN_TYPE_EXTENSION_TAG = 'phpstan.broker.dynamicStaticMethodReturnTypeExtension'; public const DYNAMIC_FUNCTION_RETURN_TYPE_EXTENSION_TAG = 'phpstan.broker.dynamicFunctionReturnTypeExtension'; public const OPERATOR_TYPE_SPECIFYING_EXTENSION_TAG = 'phpstan.broker.operatorTypeSpecifyingExtension'; public const EXPRESSION_TYPE_RESOLVER_EXTENSION_TAG = 'phpstan.broker.expressionTypeResolverExtension'; public function __construct(Container $container) { $this->container = $container; } public function create() : \PHPStan\Broker\Broker { return new \PHPStan\Broker\Broker($this->container->getByType(ReflectionProvider::class), $this->container->getParameter('universalObjectCratesClasses')); } } <?php declare (strict_types=1); namespace PHPStan\Php; use function floor; /** * @api * @final */ class PhpVersion { /** * @var int */ private $versionId; /** * @var self::SOURCE_* */ private $source; public const SOURCE_RUNTIME = 1; public const SOURCE_CONFIG = 2; public const SOURCE_COMPOSER_PLATFORM_PHP = 3; public const SOURCE_UNKNOWN = 4; /** * @param self::SOURCE_* $source */ public function __construct(int $versionId, int $source = self::SOURCE_UNKNOWN) { $this->versionId = $versionId; $this->source = $source; } public function getSourceLabel() : string { switch ($this->source) { case self::SOURCE_RUNTIME: return 'runtime'; case self::SOURCE_CONFIG: return 'config'; case self::SOURCE_COMPOSER_PLATFORM_PHP: return 'config.platform.php in composer.json'; } return 'unknown'; } public function getVersionId() : int { return $this->versionId; } public function getVersionString() : string { $first = (int) floor($this->versionId / 10000); $second = (int) floor($this->versionId % 10000 / 100); $third = (int) floor($this->versionId % 100); return $first . '.' . $second . ($third !== 0 ? '.' . $third : ''); } public function supportsNullCoalesceAssign() : bool { return $this->versionId >= 70400; } public function supportsParameterContravariance() : bool { return $this->versionId >= 70400; } public function supportsReturnCovariance() : bool { return $this->versionId >= 70400; } public function supportsNoncapturingCatches() : bool { return $this->versionId >= 80000; } public function supportsNativeUnionTypes() : bool { return $this->versionId >= 80000; } public function deprecatesRequiredParameterAfterOptional() : bool { return $this->versionId >= 80000; } public function deprecatesRequiredParameterAfterOptionalNullableAndDefaultNull() : bool { return $this->versionId >= 80100; } public function deprecatesRequiredParameterAfterOptionalUnionOrMixed() : bool { return $this->versionId >= 80300; } public function supportsLessOverridenParametersWithVariadic() : bool { return $this->versionId >= 80000; } public function supportsThrowExpression() : bool { return $this->versionId >= 80000; } public function supportsClassConstantOnExpression() : bool { return $this->versionId >= 80000; } public function supportsLegacyConstructor() : bool { return $this->versionId < 80000; } public function supportsPromotedProperties() : bool { return $this->versionId >= 80000; } public function supportsParameterTypeWidening() : bool { return $this->versionId >= 70200; } public function supportsUnsetCast() : bool { return $this->versionId < 80000; } public function supportsNamedArguments() : bool { return $this->versionId >= 80000; } public function throwsTypeErrorForInternalFunctions() : bool { return $this->versionId >= 80000; } public function throwsValueErrorForInternalFunctions() : bool { return $this->versionId >= 80000; } public function supportsHhPrintfSpecifier() : bool { return $this->versionId >= 80000; } public function isEmptyStringValidAliasForNoneInMbSubstituteCharacter() : bool { return $this->versionId < 80000; } public function supportsAllUnicodeScalarCodePointsInMbSubstituteCharacter() : bool { return $this->versionId >= 70200; } public function isNumericStringValidArgInMbSubstituteCharacter() : bool { return $this->versionId < 80000; } public function isNullValidArgInMbSubstituteCharacter() : bool { return $this->versionId >= 80000; } public function isInterfaceConstantImplicitlyFinal() : bool { return $this->versionId < 80100; } public function supportsFinalConstants() : bool { return $this->versionId >= 80100; } public function supportsReadOnlyProperties() : bool { return $this->versionId >= 80100; } public function supportsEnums() : bool { return $this->versionId >= 80100; } public function supportsPureIntersectionTypes() : bool { return $this->versionId >= 80100; } public function supportsCaseInsensitiveConstantNames() : bool { return $this->versionId < 80000; } public function hasStricterRoundFunctions() : bool { return $this->versionId >= 80000; } public function hasTentativeReturnTypes() : bool { return $this->versionId >= 80100; } public function supportsFirstClassCallables() : bool { return $this->versionId >= 80100; } public function supportsArrayUnpackingWithStringKeys() : bool { return $this->versionId >= 80100; } public function throwsOnInvalidMbStringEncoding() : bool { return $this->versionId >= 80000; } public function supportsPassNoneEncodings() : bool { return $this->versionId < 70300; } public function producesWarningForFinalPrivateMethods() : bool { return $this->versionId >= 80000; } public function deprecatesDynamicProperties() : bool { return $this->versionId >= 80200; } public function strSplitReturnsEmptyArray() : bool { return $this->versionId >= 80200; } public function supportsDisjunctiveNormalForm() : bool { return $this->versionId >= 80200; } public function serializableRequiresMagicMethods() : bool { return $this->versionId >= 80100; } public function arrayFunctionsReturnNullWithNonArray() : bool { return $this->versionId < 80000; } public function castsNumbersToStringsOnLooseComparison() : bool { return $this->versionId >= 80000; } public function supportsCallableInstanceMethods() : bool { return $this->versionId < 80000; } public function supportsJsonValidate() : bool { return $this->versionId >= 80300; } public function supportsConstantsInTraits() : bool { return $this->versionId >= 80200; } public function supportsNativeTypesInClassConstants() : bool { return $this->versionId >= 80300; } public function supportsAbstractTraitMethods() : bool { return $this->versionId >= 80000; } public function supportsOverrideAttribute() : bool { return $this->versionId >= 80300; } public function supportsDynamicClassConstantFetch() : bool { return $this->versionId >= 80300; } public function supportsReadOnlyClasses() : bool { return $this->versionId >= 80200; } public function supportsReadOnlyAnonymousClasses() : bool { return $this->versionId >= 80300; } public function supportsNeverReturnTypeInArrowFunction() : bool { return $this->versionId >= 80200; } public function supportsPregUnmatchedAsNull() : bool { // while PREG_UNMATCHED_AS_NULL is defined in php-src since 7.2.x it starts working as expected with 7.4.x // https://3v4l.org/v3HE4 return $this->versionId >= 70400; } public function supportsPregCaptureOnlyNamedGroups() : bool { // https://php.watch/versions/8.2/preg-n-no-capture-modifier return $this->versionId >= 80200; } public function hasDateTimeExceptions() : bool { return $this->versionId >= 80300; } public function isCurloptUrlCheckingFileSchemeWithOpenBasedir() : bool { // Before PHP 8.0, when setting CURLOPT_URL, an unparsable URL or a file:// scheme would fail if open_basedir is used // https://github.com/php/php-src/blob/php-7.4.33/ext/curl/interface.c#L139-L158 // https://github.com/php/php-src/blob/php-8.0.0/ext/curl/interface.c#L128-L130 return $this->versionId < 80000; } public function highlightStringDoesNotReturnFalse() : bool { return $this->versionId >= 80400; } public function deprecatesImplicitlyNullableParameterTypes() : bool { return $this->versionId >= 80400; } public function substrReturnFalseInsteadOfEmptyString() : bool { return $this->versionId < 80000; } } <?php declare (strict_types=1); namespace PHPStan\Php; use _PHPStan_7d8742a37\Nette\Utils\Json; use _PHPStan_7d8742a37\Nette\Utils\JsonException; use PHPStan\File\CouldNotReadFileException; use PHPStan\File\FileReader; use function count; use function end; use function is_file; use function is_string; final class PhpVersionFactoryFactory { /** * @var ?int */ private $versionId; /** * @var string[] */ private $composerAutoloaderProjectPaths; /** * @param string[] $composerAutoloaderProjectPaths */ public function __construct(?int $versionId, array $composerAutoloaderProjectPaths) { $this->versionId = $versionId; $this->composerAutoloaderProjectPaths = $composerAutoloaderProjectPaths; } public function create() : \PHPStan\Php\PhpVersionFactory { $composerPhpVersion = null; if (count($this->composerAutoloaderProjectPaths) > 0) { $composerJsonPath = end($this->composerAutoloaderProjectPaths) . '/composer.json'; if (is_file($composerJsonPath)) { try { $composerJsonContents = FileReader::read($composerJsonPath); $composer = Json::decode($composerJsonContents, Json::FORCE_ARRAY); $platformVersion = $composer['config']['platform']['php'] ?? null; if (is_string($platformVersion)) { $composerPhpVersion = $platformVersion; } } catch (CouldNotReadFileException|JsonException $e) { // pass } } } return new \PHPStan\Php\PhpVersionFactory($this->versionId, $composerPhpVersion); } } <?php declare (strict_types=1); namespace PHPStan\Php; use function explode; use function max; use function min; use const PHP_VERSION_ID; final class PhpVersionFactory { /** * @var ?int */ private $versionId; /** * @var ?string */ private $composerPhpVersion; public function __construct(?int $versionId, ?string $composerPhpVersion) { $this->versionId = $versionId; $this->composerPhpVersion = $composerPhpVersion; } public function create() : \PHPStan\Php\PhpVersion { $versionId = $this->versionId; if ($versionId !== null) { $source = \PHPStan\Php\PhpVersion::SOURCE_CONFIG; } elseif ($this->composerPhpVersion !== null) { $parts = explode('.', $this->composerPhpVersion); $tmp = (int) $parts[0] * 10000 + (int) ($parts[1] ?? 0) * 100 + (int) ($parts[2] ?? 0); $tmp = max($tmp, 70100); $versionId = min($tmp, 80499); $source = \PHPStan\Php\PhpVersion::SOURCE_COMPOSER_PLATFORM_PHP; } else { $versionId = PHP_VERSION_ID; $source = \PHPStan\Php\PhpVersion::SOURCE_RUNTIME; } return new \PHPStan\Php\PhpVersion($versionId, $source); } } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\Node\Expr; use PhpParser\NodeAbstract; final class NoopExpressionNode extends NodeAbstract implements \PHPStan\Node\VirtualNode { /** * @var Expr */ private $originalExpr; /** * @var bool */ private $hasAssign; public function __construct(Expr $originalExpr, bool $hasAssign) { $this->originalExpr = $originalExpr; $this->hasAssign = $hasAssign; parent::__construct($this->originalExpr->getAttributes()); } public function getOriginalExpr() : Expr { return $this->originalExpr; } public function hasAssign() : bool { return $this->hasAssign; } public function getType() : string { return 'PHPStan_Node_NoopExpressionNode'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\Node; use PhpParser\Node\Expr\Closure; use PhpParser\NodeAbstract; use PHPStan\Type\ClosureType; /** * @api * @final */ class InClosureNode extends NodeAbstract implements \PHPStan\Node\VirtualNode { /** * @var ClosureType */ private $closureType; /** * @var Node\Expr\Closure */ private $originalNode; public function __construct(ClosureType $closureType, Closure $originalNode) { $this->closureType = $closureType; parent::__construct($originalNode->getAttributes()); $this->originalNode = $originalNode; } public function getClosureType() : ClosureType { return $this->closureType; } public function getOriginalNode() : Closure { return $this->originalNode; } public function getType() : string { return 'PHPStan_Node_InClosureNode'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\Node; use PhpParser\Node\Stmt\Return_; use PHPStan\Analyser\Scope; /** * @api * @final */ class ReturnStatement { /** * @var Scope */ private $scope; /** * @var Node\Stmt\Return_ */ private $returnNode; public function __construct(Scope $scope, Return_ $returnNode) { $this->scope = $scope; $this->returnNode = $returnNode; } public function getScope() : Scope { return $this->scope; } public function getReturnNode() : Return_ { return $this->returnNode; } } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\Node; use PHPStan\Reflection\ClassReflection; /** * @api * @final */ class InTraitNode extends Node\Stmt implements \PHPStan\Node\VirtualNode { /** * @var Node\Stmt\Trait_ */ private $originalNode; /** * @var ClassReflection */ private $traitReflection; /** * @var ClassReflection */ private $implementingClassReflection; public function __construct(Node\Stmt\Trait_ $originalNode, ClassReflection $traitReflection, ClassReflection $implementingClassReflection) { $this->originalNode = $originalNode; $this->traitReflection = $traitReflection; $this->implementingClassReflection = $implementingClassReflection; parent::__construct($originalNode->getAttributes()); } public function getOriginalNode() : Node\Stmt\Trait_ { return $this->originalNode; } public function getTraitReflection() : ClassReflection { return $this->traitReflection; } public function getImplementingClassReflection() : ClassReflection { return $this->implementingClassReflection; } public function getType() : string { return 'PHPStan_Stmt_InTraitNode'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\Node\Expr; /** * @api */ final class IssetExpr extends Expr implements \PHPStan\Node\VirtualNode { /** * @var Expr */ private $expr; /** * @api */ public function __construct(Expr $expr) { $this->expr = $expr; parent::__construct([]); } public function getExpr() : Expr { return $this->expr; } public function getType() : string { return 'PHPStan_Node_IssetExpr'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\Node\Expr; use PHPStan\Analyser\Scope; /** * @api * @final */ class MatchExpressionArmBody { /** * @var Scope */ private $scope; /** * @var Expr */ private $body; public function __construct(Scope $scope, Expr $body) { $this->scope = $scope; $this->body = $body; } public function getScope() : Scope { return $this->scope; } public function getBody() : Expr { return $this->body; } } <?php declare (strict_types=1); namespace PHPStan\Node; /** * @api * @final */ class MatchExpressionArm { /** * @var MatchExpressionArmBody */ private $body; /** * @var MatchExpressionArmCondition[] */ private $conditions; /** * @var int */ private $line; /** * @param MatchExpressionArmCondition[] $conditions */ public function __construct(\PHPStan\Node\MatchExpressionArmBody $body, array $conditions, int $line) { $this->body = $body; $this->conditions = $conditions; $this->line = $line; } public function getBody() : \PHPStan\Node\MatchExpressionArmBody { return $this->body; } /** * @return MatchExpressionArmCondition[] */ public function getConditions() : array { return $this->conditions; } public function getLine() : int { return $this->line; } } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\Node\Stmt; /** * @api * @final */ class UnreachableStatementNode extends Stmt implements \PHPStan\Node\VirtualNode { /** * @var Stmt */ private $originalStatement; public function __construct(Stmt $originalStatement) { $this->originalStatement = $originalStatement; parent::__construct($originalStatement->getAttributes()); } public function getOriginalStatement() : Stmt { return $this->originalStatement; } public function getType() : string { return 'PHPStan_Stmt_UnreachableStatementNode'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\Node; use PhpParser\Node\Expr\Array_; use PhpParser\Node\Expr\PropertyFetch; use PhpParser\Node\Identifier; use PhpParser\Node\Name; use PhpParser\Node\Stmt\Class_; use PhpParser\Node\Stmt\ClassLike; use PhpParser\NodeAbstract; use PHPStan\Analyser\Scope; use PHPStan\Node\Expr\PropertyInitializationExpr; use PHPStan\Node\Method\MethodCall; use PHPStan\Node\Property\PropertyAssign; use PHPStan\Node\Property\PropertyRead; use PHPStan\Node\Property\PropertyWrite; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\MethodReflection; use PHPStan\Rules\Properties\ReadWritePropertiesExtension; use PHPStan\Rules\Properties\ReadWritePropertiesExtensionProvider; use PHPStan\TrinaryLogic; use PHPStan\Type\NeverType; use PHPStan\Type\TypeUtils; use function array_diff_key; use function array_key_exists; use function array_keys; use function in_array; use function strtolower; /** * @api * @final */ class ClassPropertiesNode extends NodeAbstract implements \PHPStan\Node\VirtualNode { /** * @var ClassLike */ private $class; /** * @var ReadWritePropertiesExtensionProvider */ private $readWritePropertiesExtensionProvider; /** * @var ClassPropertyNode[] */ private $properties; /** * @var array<int, PropertyRead|PropertyWrite> */ private $propertyUsages; /** * @var array<int, MethodCall> */ private $methodCalls; /** * @var array<string, MethodReturnStatementsNode> */ private $returnStatementNodes; /** * @var list<PropertyAssign> */ private $propertyAssigns; /** * @var ClassReflection */ private $classReflection; /** * @param ClassPropertyNode[] $properties * @param array<int, PropertyRead|PropertyWrite> $propertyUsages * @param array<int, MethodCall> $methodCalls * @param array<string, MethodReturnStatementsNode> $returnStatementNodes * @param list<PropertyAssign> $propertyAssigns */ public function __construct(ClassLike $class, ReadWritePropertiesExtensionProvider $readWritePropertiesExtensionProvider, array $properties, array $propertyUsages, array $methodCalls, array $returnStatementNodes, array $propertyAssigns, ClassReflection $classReflection) { $this->class = $class; $this->readWritePropertiesExtensionProvider = $readWritePropertiesExtensionProvider; $this->properties = $properties; $this->propertyUsages = $propertyUsages; $this->methodCalls = $methodCalls; $this->returnStatementNodes = $returnStatementNodes; $this->propertyAssigns = $propertyAssigns; $this->classReflection = $classReflection; parent::__construct($class->getAttributes()); } public function getClass() : ClassLike { return $this->class; } /** * @return ClassPropertyNode[] */ public function getProperties() : array { return $this->properties; } /** * @return array<int, PropertyRead|PropertyWrite> */ public function getPropertyUsages() : array { return $this->propertyUsages; } public function getType() : string { return 'PHPStan_Node_ClassPropertiesNode'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } public function getClassReflection() : ClassReflection { return $this->classReflection; } /** * @param string[] $constructors * @param ReadWritePropertiesExtension[]|null $extensions * @return array{array<string, ClassPropertyNode>, array<array{string, int, ClassPropertyNode, string, string}>, array<array{string, int, ClassPropertyNode}>} */ public function getUninitializedProperties(Scope $scope, array $constructors, ?array $extensions = null) : array { if (!$this->getClass() instanceof Class_) { return [[], [], []]; } $classReflection = $this->getClassReflection(); $uninitializedProperties = []; $originalProperties = []; $initialInitializedProperties = []; $initializedProperties = []; if ($extensions === null) { $extensions = $this->readWritePropertiesExtensionProvider->getExtensions(); } $initializedViaExtension = []; foreach ($this->getProperties() as $property) { if ($property->isStatic()) { continue; } if ($property->getNativeType() === null) { continue; } if ($property->getDefault() !== null) { continue; } $originalProperties[$property->getName()] = $property; $is = TrinaryLogic::createFromBoolean($property->isPromoted() && !$property->isPromotedFromTrait()); if (!$is->yes() && $classReflection->hasNativeProperty($property->getName())) { $propertyReflection = $classReflection->getNativeProperty($property->getName()); foreach ($extensions as $extension) { if (!$extension->isInitialized($propertyReflection, $property->getName())) { continue; } $is = TrinaryLogic::createYes(); $initializedViaExtension[$property->getName()] = \true; break; } } $initialInitializedProperties[$property->getName()] = $is; foreach ($constructors as $constructor) { $initializedProperties[$constructor][$property->getName()] = $is; } if ($is->yes()) { continue; } $uninitializedProperties[$property->getName()] = $property; } if ($constructors === []) { return [$uninitializedProperties, [], []]; } $initializedInConstructor = []; if ($classReflection->hasConstructor()) { $initializedInConstructor = array_diff_key($uninitializedProperties, $this->collectUninitializedProperties([$classReflection->getConstructor()->getName()], $uninitializedProperties)); } $methodsCalledFromConstructor = $this->getMethodsCalledFromConstructor($classReflection, $initialInitializedProperties, $initializedProperties, $constructors, $initializedInConstructor); $prematureAccess = []; $additionalAssigns = []; foreach ($this->getPropertyUsages() as $usage) { $fetch = $usage->getFetch(); if (!$fetch instanceof PropertyFetch) { continue; } $usageScope = $usage->getScope(); if ($usageScope->getFunction() === null) { continue; } $function = $usageScope->getFunction(); if (!$function instanceof MethodReflection) { continue; } if ($function->getDeclaringClass()->getName() !== $classReflection->getName()) { continue; } if (!array_key_exists($function->getName(), $methodsCalledFromConstructor)) { continue; } $initializedPropertiesMap = $methodsCalledFromConstructor[$function->getName()]; if (!$fetch->name instanceof Identifier) { continue; } $propertyName = $fetch->name->toString(); $fetchedOnType = $usageScope->getType($fetch->var); if (TypeUtils::findThisType($fetchedOnType) === null) { continue; } $propertyReflection = $usageScope->getPropertyReflection($fetchedOnType, $propertyName); if ($propertyReflection === null) { continue; } if ($propertyReflection->getDeclaringClass()->getName() !== $classReflection->getName()) { continue; } if ($usage instanceof PropertyWrite) { if (array_key_exists($propertyName, $initializedPropertiesMap)) { $hasInitialization = $initializedPropertiesMap[$propertyName]->or($usageScope->hasExpressionType(new PropertyInitializationExpr($propertyName))); if (!$hasInitialization->no() && !$usage->isPromotedPropertyWrite() && !array_key_exists($propertyName, $initializedViaExtension)) { $additionalAssigns[] = [$propertyName, $fetch->getStartLine(), $originalProperties[$propertyName]]; } } } elseif (array_key_exists($propertyName, $initializedPropertiesMap)) { if (strtolower($function->getName()) !== '__construct' && array_key_exists($propertyName, $initializedInConstructor) && in_array($function->getName(), $constructors, \true)) { continue; } $hasInitialization = $initializedPropertiesMap[$propertyName]->or($usageScope->hasExpressionType(new PropertyInitializationExpr($propertyName))); if (!$hasInitialization->yes() && $usageScope->isInAnonymousFunction() && $usageScope->getParentScope() !== null) { $hasInitialization = $hasInitialization->or($usageScope->getParentScope()->hasExpressionType(new PropertyInitializationExpr($propertyName))); } if (!$hasInitialization->yes()) { $prematureAccess[] = [$propertyName, $fetch->getStartLine(), $originalProperties[$propertyName], $usageScope->getFile(), $usageScope->getFileDescription()]; } } } return [$this->collectUninitializedProperties(array_keys($methodsCalledFromConstructor), $uninitializedProperties), $prematureAccess, $additionalAssigns]; } /** * @param list<string> $constructors * @param array<string, ClassPropertyNode> $uninitializedProperties * @return array<string, ClassPropertyNode> */ private function collectUninitializedProperties(array $constructors, array $uninitializedProperties) : array { foreach ($constructors as $constructor) { $lowerConstructorName = strtolower($constructor); if (!array_key_exists($lowerConstructorName, $this->returnStatementNodes)) { continue; } $returnStatementsNode = $this->returnStatementNodes[$lowerConstructorName]; $methodScope = null; foreach ($returnStatementsNode->getExecutionEnds() as $executionEnd) { $statementResult = $executionEnd->getStatementResult(); $endNode = $executionEnd->getNode(); if ($statementResult->isAlwaysTerminating()) { if ($endNode instanceof Node\Stmt\Throw_) { continue; } if ($endNode instanceof Node\Stmt\Expression) { $exprType = $statementResult->getScope()->getType($endNode->expr); if ($exprType instanceof NeverType && $exprType->isExplicit()) { continue; } } } if ($methodScope === null) { $methodScope = $statementResult->getScope(); continue; } $methodScope = $methodScope->mergeWith($statementResult->getScope()); } foreach ($returnStatementsNode->getReturnStatements() as $returnStatement) { if ($methodScope === null) { $methodScope = $returnStatement->getScope(); continue; } $methodScope = $methodScope->mergeWith($returnStatement->getScope()); } if ($methodScope === null) { continue; } foreach (array_keys($uninitializedProperties) as $propertyName) { if (!$methodScope->hasExpressionType(new PropertyInitializationExpr($propertyName))->yes()) { continue; } unset($uninitializedProperties[$propertyName]); } } return $uninitializedProperties; } /** * @param string[] $methods * @param array<string, TrinaryLogic> $initialInitializedProperties * @param array<string, array<string, TrinaryLogic>> $initializedProperties * @param array<string, ClassPropertyNode> $initializedInConstructorProperties * * @return array<string, array<string, TrinaryLogic>> */ private function getMethodsCalledFromConstructor(ClassReflection $classReflection, array $initialInitializedProperties, array $initializedProperties, array $methods, array $initializedInConstructorProperties) : array { $originalMap = $initializedProperties; $originalMethods = $methods; foreach ($this->methodCalls as $methodCall) { $methodCallNode = $methodCall->getNode(); if ($methodCallNode instanceof Array_) { continue; } if (!$methodCallNode->name instanceof Identifier) { continue; } $callScope = $methodCall->getScope(); if ($methodCallNode instanceof Node\Expr\MethodCall) { $calledOnType = $callScope->getType($methodCallNode->var); } else { if (!$methodCallNode->class instanceof Name) { continue; } $calledOnType = $callScope->resolveTypeByName($methodCallNode->class); } if (TypeUtils::findThisType($calledOnType) === null) { continue; } $inMethod = $callScope->getFunction(); if (!$inMethod instanceof MethodReflection) { continue; } if (!in_array($inMethod->getName(), $methods, \true)) { continue; } if ($inMethod->getName() !== '__construct') { foreach ($initializedInConstructorProperties as $propertyName => $propertyNode) { $initializedProperties[$inMethod->getName()][$propertyName] = TrinaryLogic::createYes(); } } $methodName = $methodCallNode->name->toString(); if (array_key_exists($methodName, $initializedProperties)) { foreach ($this->getInitializedProperties($callScope, $initializedProperties[$inMethod->getName()] ?? $initialInitializedProperties) as $propertyName => $isInitialized) { $initializedProperties[$methodName][$propertyName] = $initializedProperties[$methodName][$propertyName]->and($isInitialized); } continue; } $methodReflection = $callScope->getMethodReflection($calledOnType, $methodName); if ($methodReflection === null) { continue; } if ($methodReflection->getDeclaringClass()->getName() !== $classReflection->getName()) { continue; } $initializedProperties[$methodName] = $this->getInitializedProperties($callScope, $initializedProperties[$inMethod->getName()] ?? $initialInitializedProperties); $methods[] = $methodName; } if ($originalMap === $initializedProperties && $originalMethods === $methods) { return $initializedProperties; } return $this->getMethodsCalledFromConstructor($classReflection, $initialInitializedProperties, $initializedProperties, $methods, $initializedInConstructorProperties); } /** * @param array<string, TrinaryLogic> $initialInitializedProperties * @return array<string, TrinaryLogic> */ private function getInitializedProperties(Scope $scope, array $initialInitializedProperties) : array { foreach ($initialInitializedProperties as $propertyName => $isInitialized) { $initialInitializedProperties[$propertyName] = $isInitialized->or($scope->hasExpressionType(new PropertyInitializationExpr($propertyName))); } return $initialInitializedProperties; } /** * @return list<PropertyAssign> */ public function getPropertyAssigns() : array { return $this->propertyAssigns; } } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\Node\Stmt\Class_; /** * The only purpose of this is to fix {@see Class_::isAnonymous()}, broken by us giving anonymous classes a name. */ final class AnonymousClassNode extends Class_ { public static function createFromClassNode(Class_ $node) : self { $subNodes = []; foreach ($node->getSubNodeNames() as $subNodeName) { $subNodes[$subNodeName] = $node->{$subNodeName}; } return new \PHPStan\Node\AnonymousClassNode($node->name, $subNodes, $node->getAttributes()); } public function isAnonymous() : bool { return \true; } } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\Node\Expr; use PhpParser\NodeAbstract; use PHPStan\PhpDoc\Tag\VarTag; final class VarTagChangedExpressionTypeNode extends NodeAbstract implements \PHPStan\Node\VirtualNode { /** * @var VarTag */ private $varTag; /** * @var Expr */ private $expr; public function __construct(VarTag $varTag, Expr $expr) { $this->varTag = $varTag; $this->expr = $expr; parent::__construct($expr->getAttributes()); } public function getVarTag() : VarTag { return $this->varTag; } public function getExpr() : Expr { return $this->expr; } public function getType() : string { return 'PHPStan_Node_VarTagChangedExpressionType'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\Node; use PHPStan\Reflection\Php\PhpFunctionFromParserNodeReflection; /** * @api * @final */ class InFunctionNode extends Node\Stmt implements \PHPStan\Node\VirtualNode { /** * @var PhpFunctionFromParserNodeReflection */ private $functionReflection; /** * @var Node\Stmt\Function_ */ private $originalNode; public function __construct(PhpFunctionFromParserNodeReflection $functionReflection, Node\Stmt\Function_ $originalNode) { $this->functionReflection = $functionReflection; $this->originalNode = $originalNode; parent::__construct($originalNode->getAttributes()); } public function getFunctionReflection() : PhpFunctionFromParserNodeReflection { return $this->functionReflection; } public function getOriginalNode() : Node\Stmt\Function_ { return $this->originalNode; } public function getType() : string { return 'PHPStan_Stmt_InFunctionNode'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\Node\Expr; use PhpParser\Node\Identifier; use PhpParser\Node\Name; /** * @api * @final */ class StaticMethodCallableNode extends Expr implements \PHPStan\Node\VirtualNode { /** * @var Name|Expr */ private $class; /** * @var Identifier|Expr */ private $name; /** * @var Expr\StaticCall */ private $originalNode; /** * @param Name|Expr $class * @param Identifier|Expr $name */ public function __construct($class, $name, Expr\StaticCall $originalNode) { $this->class = $class; $this->name = $name; $this->originalNode = $originalNode; parent::__construct($originalNode->getAttributes()); } /** * @return Expr|Name */ public function getClass() { return $this->class; } /** * @return Identifier|Expr */ public function getName() { return $this->name; } public function getOriginalNode() : Expr\StaticCall { return $this->originalNode; } public function getType() : string { return 'PHPStan_Node_StaticMethodCallableNode'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\Node; /** @api */ interface VirtualNode extends Node { } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\Node; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\Php\PhpMethodFromParserNodeReflection; /** * @api * @final */ class InClassMethodNode extends Node\Stmt implements \PHPStan\Node\VirtualNode { /** * @var ClassReflection */ private $classReflection; /** * @var PhpMethodFromParserNodeReflection */ private $methodReflection; /** * @var Node\Stmt\ClassMethod */ private $originalNode; public function __construct(ClassReflection $classReflection, PhpMethodFromParserNodeReflection $methodReflection, Node\Stmt\ClassMethod $originalNode) { $this->classReflection = $classReflection; $this->methodReflection = $methodReflection; $this->originalNode = $originalNode; parent::__construct($originalNode->getAttributes()); } public function getClassReflection() : ClassReflection { return $this->classReflection; } public function getMethodReflection() : PhpMethodFromParserNodeReflection { return $this->methodReflection; } public function getOriginalNode() : Node\Stmt\ClassMethod { return $this->originalNode; } public function getType() : string { return 'PHPStan_Stmt_InClassMethodNode'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\Node\Stmt\ClassLike; use PhpParser\NodeAbstract; use PHPStan\Node\Method\MethodCall; use PHPStan\Reflection\ClassReflection; /** * @api * @final */ class ClassMethodsNode extends NodeAbstract implements \PHPStan\Node\VirtualNode { /** * @var ClassLike */ private $class; /** * @var ClassMethod[] */ private $methods; /** * @var array<int, MethodCall> */ private $methodCalls; /** * @var ClassReflection */ private $classReflection; /** * @param ClassMethod[] $methods * @param array<int, MethodCall> $methodCalls */ public function __construct(ClassLike $class, array $methods, array $methodCalls, ClassReflection $classReflection) { $this->class = $class; $this->methods = $methods; $this->methodCalls = $methodCalls; $this->classReflection = $classReflection; parent::__construct($class->getAttributes()); } public function getClass() : ClassLike { return $this->class; } /** * @return ClassMethod[] */ public function getMethods() : array { return $this->methods; } /** * @return array<int, MethodCall> */ public function getMethodCalls() : array { return $this->methodCalls; } public function getType() : string { return 'PHPStan_Node_ClassMethodsNode'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } public function getClassReflection() : ClassReflection { return $this->classReflection; } } <?php declare (strict_types=1); namespace PHPStan\Node\Property; use PhpParser\Node\Expr\PropertyFetch; use PhpParser\Node\Expr\StaticPropertyFetch; use PHPStan\Analyser\Scope; /** * @api * @final */ class PropertyWrite { /** * @var PropertyFetch|StaticPropertyFetch */ private $fetch; /** * @var Scope */ private $scope; /** * @var bool */ private $promotedPropertyWrite; /** * @param PropertyFetch|StaticPropertyFetch $fetch */ public function __construct($fetch, Scope $scope, bool $promotedPropertyWrite) { $this->fetch = $fetch; $this->scope = $scope; $this->promotedPropertyWrite = $promotedPropertyWrite; } /** * @return PropertyFetch|StaticPropertyFetch */ public function getFetch() { return $this->fetch; } public function getScope() : Scope { return $this->scope; } public function isPromotedPropertyWrite() : bool { return $this->promotedPropertyWrite; } } <?php declare (strict_types=1); namespace PHPStan\Node\Property; use PhpParser\Node\Expr\PropertyFetch; use PhpParser\Node\Expr\StaticPropertyFetch; use PHPStan\Analyser\Scope; /** * @api * @final */ class PropertyRead { /** * @var PropertyFetch|StaticPropertyFetch */ private $fetch; /** * @var Scope */ private $scope; /** * @param PropertyFetch|StaticPropertyFetch $fetch */ public function __construct($fetch, Scope $scope) { $this->fetch = $fetch; $this->scope = $scope; } /** * @return PropertyFetch|StaticPropertyFetch */ public function getFetch() { return $this->fetch; } public function getScope() : Scope { return $this->scope; } } <?php declare (strict_types=1); namespace PHPStan\Node\Property; use PHPStan\Analyser\Scope; use PHPStan\Node\PropertyAssignNode; /** * @api */ final class PropertyAssign { /** * @var PropertyAssignNode */ private $assign; /** * @var Scope */ private $scope; public function __construct(PropertyAssignNode $assign, Scope $scope) { $this->assign = $assign; $this->scope = $scope; } public function getAssign() : PropertyAssignNode { return $this->assign; } public function getScope() : Scope { return $this->scope; } } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\Node\Expr; use PHPStan\Analyser\Scope; /** * @api * @final */ class MatchExpressionArmCondition { /** * @var Expr */ private $condition; /** * @var Scope */ private $scope; /** * @var int */ private $line; public function __construct(Expr $condition, Scope $scope, int $line) { $this->condition = $condition; $this->scope = $scope; $this->line = $line; } public function getCondition() : Expr { return $this->condition; } public function getScope() : Scope { return $this->scope; } public function getLine() : int { return $this->line; } } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\Node; use PhpParser\NodeAbstract; use PHPStan\Analyser\StatementResult; /** * @api * @final */ class ExecutionEndNode extends NodeAbstract implements \PHPStan\Node\VirtualNode { /** * @var Node\Stmt */ private $node; /** * @var StatementResult */ private $statementResult; /** * @var bool */ private $hasNativeReturnTypehint; public function __construct(Node\Stmt $node, StatementResult $statementResult, bool $hasNativeReturnTypehint) { $this->node = $node; $this->statementResult = $statementResult; $this->hasNativeReturnTypehint = $hasNativeReturnTypehint; parent::__construct($node->getAttributes()); } public function getNode() : Node\Stmt { return $this->node; } public function getStatementResult() : StatementResult { return $this->statementResult; } public function hasNativeReturnTypehint() : bool { return $this->hasNativeReturnTypehint; } public function getType() : string { return 'PHPStan_Node_ExecutionEndNode'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\Node\Expr; use PhpParser\Node\Expr\BinaryOp\BooleanOr; use PhpParser\Node\Expr\BinaryOp\LogicalOr; use PHPStan\Analyser\Scope; /** * @api * @final */ class BooleanOrNode extends Expr implements \PHPStan\Node\VirtualNode { /** * @var BooleanOr|LogicalOr */ private $originalNode; /** * @var Scope */ private $rightScope; /** * @param BooleanOr|LogicalOr $originalNode */ public function __construct($originalNode, Scope $rightScope) { $this->originalNode = $originalNode; $this->rightScope = $rightScope; parent::__construct($originalNode->getAttributes()); } /** * @return BooleanOr|LogicalOr */ public function getOriginalNode() { return $this->originalNode; } public function getRightScope() : Scope { return $this->rightScope; } public function getType() : string { return 'PHPStan_Node_BooleanOrNode'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\Node; use PhpParser\Node\Expr; use PhpParser\Node\Expr\Array_; use PhpParser\Node\Expr\ArrayDimFetch; use PhpParser\Node\Expr\MethodCall; use PhpParser\Node\Expr\PropertyFetch; use PhpParser\Node\Expr\StaticCall; use PhpParser\Node\Expr\StaticPropertyFetch; use PhpParser\Node\Identifier; use PHPStan\Analyser\Scope; use PHPStan\Node\Constant\ClassConstantFetch; use PHPStan\Node\Property\PropertyAssign; use PHPStan\Node\Property\PropertyRead; use PHPStan\Node\Property\PropertyWrite; use PHPStan\Reflection\ClassReflection; use PHPStan\ShouldNotHappenException; use PHPStan\Type\TypeUtils; use ReflectionProperty; use function count; use function in_array; use function strtolower; final class ClassStatementsGatherer { /** * @var ClassReflection */ private $classReflection; private const PROPERTY_ENUMERATING_FUNCTIONS = ['get_object_vars', 'array_walk']; /** @var callable(Node $node, Scope $scope): void */ private $nodeCallback; /** @var ClassPropertyNode[] */ private $properties = []; /** @var ClassMethod[] */ private $methods = []; /** @var \PHPStan\Node\Method\MethodCall[] */ private $methodCalls = []; /** @var array<int, PropertyWrite|PropertyRead> */ private $propertyUsages = []; /** @var Node\Stmt\ClassConst[] */ private $constants = []; /** @var ClassConstantFetch[] */ private $constantFetches = []; /** @var array<string, MethodReturnStatementsNode> */ private $returnStatementNodes = []; /** @var list<PropertyAssign> */ private $propertyAssigns = []; /** * @param callable(Node $node, Scope $scope): void $nodeCallback */ public function __construct(ClassReflection $classReflection, callable $nodeCallback) { $this->classReflection = $classReflection; $this->nodeCallback = $nodeCallback; } /** * @return ClassPropertyNode[] */ public function getProperties() : array { return $this->properties; } /** * @return ClassMethod[] */ public function getMethods() : array { return $this->methods; } /** * @return Method\MethodCall[] */ public function getMethodCalls() : array { return $this->methodCalls; } /** * @return array<int, PropertyWrite|PropertyRead> */ public function getPropertyUsages() : array { return $this->propertyUsages; } /** * @return Node\Stmt\ClassConst[] */ public function getConstants() : array { return $this->constants; } /** * @return ClassConstantFetch[] */ public function getConstantFetches() : array { return $this->constantFetches; } /** * @return array<string, MethodReturnStatementsNode> */ public function getReturnStatementsNodes() : array { return $this->returnStatementNodes; } /** * @return list<PropertyAssign> */ public function getPropertyAssigns() : array { return $this->propertyAssigns; } public function __invoke(Node $node, Scope $scope) : void { $nodeCallback = $this->nodeCallback; $nodeCallback($node, $scope); $this->gatherNodes($node, $scope); } private function gatherNodes(Node $node, Scope $scope) : void { if (!$scope->isInClass()) { throw new ShouldNotHappenException(); } if ($scope->getClassReflection()->getName() !== $this->classReflection->getName()) { return; } if ($node instanceof \PHPStan\Node\ClassPropertyNode) { $this->properties[] = $node; if ($node->isPromoted()) { $this->propertyUsages[] = new PropertyWrite(new PropertyFetch(new Expr\Variable('this'), new Identifier($node->getName())), $scope, \true); } return; } if ($node instanceof Node\Stmt\ClassMethod) { $this->methods[] = new \PHPStan\Node\ClassMethod($node, $scope->isInTrait()); return; } if ($node instanceof Node\Stmt\ClassConst) { $this->constants[] = $node; return; } if ($node instanceof MethodCall || $node instanceof StaticCall) { $this->methodCalls[] = new \PHPStan\Node\Method\MethodCall($node, $scope); if ($node instanceof StaticCall && $node->name instanceof Identifier && $node->name->toLowerString() === '__construct') { $this->tryToApplyPropertyWritesFromAncestorConstructor($node, $scope); } return; } if ($node instanceof \PHPStan\Node\MethodCallableNode || $node instanceof \PHPStan\Node\StaticMethodCallableNode) { $this->methodCalls[] = new \PHPStan\Node\Method\MethodCall($node->getOriginalNode(), $scope); return; } if ($node instanceof \PHPStan\Node\MethodReturnStatementsNode) { $this->returnStatementNodes[strtolower($node->getMethodName())] = $node; return; } if ($node instanceof Expr\FuncCall && $node->name instanceof Node\Name && in_array($node->name->toLowerString(), self::PROPERTY_ENUMERATING_FUNCTIONS, \true)) { $this->tryToApplyPropertyReads($node, $scope); return; } if ($node instanceof Array_ && count($node->items) === 2) { $this->methodCalls[] = new \PHPStan\Node\Method\MethodCall($node, $scope); return; } if ($node instanceof Expr\ClassConstFetch) { $this->constantFetches[] = new ClassConstantFetch($node, $scope); return; } if ($node instanceof \PHPStan\Node\PropertyAssignNode) { $this->propertyUsages[] = new PropertyWrite($node->getPropertyFetch(), $scope, \false); $this->propertyAssigns[] = new PropertyAssign($node, $scope); return; } if (!$node instanceof Expr) { return; } if ($node instanceof Expr\AssignOp\Coalesce) { $this->gatherNodes($node->var, $scope); return; } if ($node instanceof Expr\AssignRef) { if (!$node->expr instanceof PropertyFetch && !$node->expr instanceof StaticPropertyFetch) { $this->gatherNodes($node->expr, $scope); return; } $this->propertyUsages[] = new PropertyRead($node->expr, $scope); $this->propertyUsages[] = new PropertyWrite($node->expr, $scope, \false); return; } if ($node instanceof Node\Scalar\EncapsedStringPart) { return; } if ($node instanceof \PHPStan\Node\FunctionCallableNode) { $node = $node->getOriginalNode(); } elseif ($node instanceof \PHPStan\Node\InstantiationCallableNode) { $node = $node->getOriginalNode(); } $inAssign = $scope->isInExpressionAssign($node); if ($inAssign) { return; } while ($node instanceof ArrayDimFetch) { $node = $node->var; } if (!$node instanceof PropertyFetch && !$node instanceof StaticPropertyFetch) { return; } $this->propertyUsages[] = new PropertyRead($node, $scope); } private function tryToApplyPropertyReads(Expr\FuncCall $node, Scope $scope) : void { $args = $node->getArgs(); if (count($args) === 0) { return; } $firstArgValue = $args[0]->value; if (TypeUtils::findThisType($scope->getType($firstArgValue)) === null) { return; } $classProperties = $this->classReflection->getNativeReflection()->getProperties(); foreach ($classProperties as $property) { if ($property->isStatic()) { continue; } $this->propertyUsages[] = new PropertyRead(new PropertyFetch(new Expr\Variable('this'), new Identifier($property->getName())), $scope); } } private function tryToApplyPropertyWritesFromAncestorConstructor(StaticCall $ancestorConstructorCall, Scope $scope) : void { if (!$ancestorConstructorCall->class instanceof Node\Name) { return; } $calledOnType = $scope->resolveTypeByName($ancestorConstructorCall->class); if ($calledOnType->getClassReflection() === null || TypeUtils::findThisType($calledOnType) === null) { return; } $classReflection = $calledOnType->getClassReflection()->getNativeReflection(); foreach ($classReflection->getProperties(ReflectionProperty::IS_PUBLIC | ReflectionProperty::IS_PROTECTED) as $property) { if (!$property->isPromoted() || $property->getDeclaringClass()->getName() !== $classReflection->getName()) { continue; } $this->propertyUsages[] = new PropertyWrite(new PropertyFetch(new Expr\Variable('this'), new Identifier($property->getName()), $ancestorConstructorCall->getAttributes()), $scope, \false); } } } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\Node\Expr; use PhpParser\Node\Expr\BinaryOp\BooleanAnd; use PhpParser\Node\Expr\BinaryOp\LogicalAnd; use PHPStan\Analyser\Scope; /** * @api * @final */ class BooleanAndNode extends Expr implements \PHPStan\Node\VirtualNode { /** * @var BooleanAnd|LogicalAnd */ private $originalNode; /** * @var Scope */ private $rightScope; /** * @param BooleanAnd|LogicalAnd $originalNode */ public function __construct($originalNode, Scope $rightScope) { $this->originalNode = $originalNode; $this->rightScope = $rightScope; parent::__construct($originalNode->getAttributes()); } /** * @return BooleanAnd|LogicalAnd */ public function getOriginalNode() { return $this->originalNode; } public function getRightScope() : Scope { return $this->rightScope; } public function getType() : string { return 'PHPStan_Node_BooleanAndNode'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\Node; use PhpParser\Node\Expr; use PhpParser\Node\Identifier; use PhpParser\Node\Name; use PhpParser\Node\Stmt\Class_; use PhpParser\NodeAbstract; use PHPStan\Reflection\ClassReflection; use PHPStan\Type\Type; /** * @api * @final */ class ClassPropertyNode extends NodeAbstract implements \PHPStan\Node\VirtualNode { /** * @var string */ private $name; /** * @var int */ private $flags; /** * @var Identifier|Name|Node\ComplexType|null */ private $type; /** * @var ?Expr */ private $default; /** * @var ?string */ private $phpDoc; /** * @var ?Type */ private $phpDocType; /** * @var bool */ private $isPromoted; /** * @var bool */ private $isPromotedFromTrait; /** * @var bool */ private $isReadonlyByPhpDoc; /** * @var bool */ private $isDeclaredInTrait; /** * @var bool */ private $isReadonlyClass; /** * @var bool */ private $isAllowedPrivateMutation; /** * @var ClassReflection */ private $classReflection; /** * @param Identifier|Name|Node\ComplexType|null $type */ public function __construct(string $name, int $flags, $type, ?Expr $default, ?string $phpDoc, ?Type $phpDocType, bool $isPromoted, bool $isPromotedFromTrait, Node $originalNode, bool $isReadonlyByPhpDoc, bool $isDeclaredInTrait, bool $isReadonlyClass, bool $isAllowedPrivateMutation, ClassReflection $classReflection) { $this->name = $name; $this->flags = $flags; $this->type = $type; $this->default = $default; $this->phpDoc = $phpDoc; $this->phpDocType = $phpDocType; $this->isPromoted = $isPromoted; $this->isPromotedFromTrait = $isPromotedFromTrait; $this->isReadonlyByPhpDoc = $isReadonlyByPhpDoc; $this->isDeclaredInTrait = $isDeclaredInTrait; $this->isReadonlyClass = $isReadonlyClass; $this->isAllowedPrivateMutation = $isAllowedPrivateMutation; $this->classReflection = $classReflection; parent::__construct($originalNode->getAttributes()); } public function getName() : string { return $this->name; } public function getFlags() : int { return $this->flags; } public function getDefault() : ?Expr { return $this->default; } public function isPromoted() : bool { return $this->isPromoted; } public function isPromotedFromTrait() : bool { return $this->isPromotedFromTrait; } public function getPhpDoc() : ?string { return $this->phpDoc; } public function getPhpDocType() : ?Type { return $this->phpDocType; } public function isPublic() : bool { return ($this->flags & Class_::MODIFIER_PUBLIC) !== 0 || ($this->flags & Class_::VISIBILITY_MODIFIER_MASK) === 0; } public function isProtected() : bool { return (bool) ($this->flags & Class_::MODIFIER_PROTECTED); } public function isPrivate() : bool { return (bool) ($this->flags & Class_::MODIFIER_PRIVATE); } public function isStatic() : bool { return (bool) ($this->flags & Class_::MODIFIER_STATIC); } public function isReadOnly() : bool { return (bool) ($this->flags & Class_::MODIFIER_READONLY) || $this->isReadonlyClass; } public function isReadOnlyByPhpDoc() : bool { return $this->isReadonlyByPhpDoc; } public function isDeclaredInTrait() : bool { return $this->isDeclaredInTrait; } public function isAllowedPrivateMutation() : bool { return $this->isAllowedPrivateMutation; } /** * @return Identifier|Name|Node\ComplexType|null */ public function getNativeType() { return $this->type; } public function getClassReflection() : ClassReflection { return $this->classReflection; } public function getType() : string { return 'PHPStan_Node_ClassPropertyNode'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\Node\Expr; use PhpParser\NodeAbstract; use PHPStan\Analyser\Scope; /** * @api * @final */ class MatchExpressionNode extends NodeAbstract implements \PHPStan\Node\VirtualNode { /** * @var Expr */ private $condition; /** * @var MatchExpressionArm[] */ private $arms; /** * @var Scope */ private $endScope; /** * @param MatchExpressionArm[] $arms */ public function __construct(Expr $condition, array $arms, Expr\Match_ $originalNode, Scope $endScope) { $this->condition = $condition; $this->arms = $arms; $this->endScope = $endScope; parent::__construct($originalNode->getAttributes()); } public function getCondition() : Expr { return $this->condition; } /** * @return MatchExpressionArm[] */ public function getArms() : array { return $this->arms; } public function getEndScope() : Scope { return $this->endScope; } public function getType() : string { return 'PHPStan_Node_MatchExpression'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\Node\Expr\Yield_; use PhpParser\Node\Expr\YieldFrom; use PhpParser\Node\Stmt; use PhpParser\Node\Stmt\Function_; use PhpParser\NodeAbstract; use PHPStan\Analyser\ImpurePoint; use PHPStan\Analyser\StatementResult; use PHPStan\Reflection\Php\PhpFunctionFromParserNodeReflection; use function count; /** * @api * @final */ class FunctionReturnStatementsNode extends NodeAbstract implements \PHPStan\Node\ReturnStatementsNode { /** * @var Function_ */ private $function; /** * @var list<ReturnStatement> */ private $returnStatements; /** * @var list<Yield_|YieldFrom> */ private $yieldStatements; /** * @var StatementResult */ private $statementResult; /** * @var list<ExecutionEndNode> */ private $executionEnds; /** * @var ImpurePoint[] */ private $impurePoints; /** * @var PhpFunctionFromParserNodeReflection */ private $functionReflection; /** * @param list<ReturnStatement> $returnStatements * @param list<Yield_|YieldFrom> $yieldStatements * @param list<ExecutionEndNode> $executionEnds * @param ImpurePoint[] $impurePoints */ public function __construct(Function_ $function, array $returnStatements, array $yieldStatements, StatementResult $statementResult, array $executionEnds, array $impurePoints, PhpFunctionFromParserNodeReflection $functionReflection) { $this->function = $function; $this->returnStatements = $returnStatements; $this->yieldStatements = $yieldStatements; $this->statementResult = $statementResult; $this->executionEnds = $executionEnds; $this->impurePoints = $impurePoints; $this->functionReflection = $functionReflection; parent::__construct($function->getAttributes()); } public function getReturnStatements() : array { return $this->returnStatements; } public function getStatementResult() : StatementResult { return $this->statementResult; } public function getExecutionEnds() : array { return $this->executionEnds; } public function getImpurePoints() : array { return $this->impurePoints; } public function returnsByRef() : bool { return $this->function->byRef; } public function hasNativeReturnTypehint() : bool { return $this->function->returnType !== null; } public function getYieldStatements() : array { return $this->yieldStatements; } public function isGenerator() : bool { return count($this->yieldStatements) > 0; } public function getType() : string { return 'PHPStan_Node_FunctionReturnStatementsNode'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } public function getFunctionReflection() : PhpFunctionFromParserNodeReflection { return $this->functionReflection; } /** * @return Stmt[] */ public function getStatements() : array { return $this->function->getStmts(); } } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\Node\Expr; use PhpParser\Node\Name; /** * @api * @final */ class FunctionCallableNode extends Expr implements \PHPStan\Node\VirtualNode { /** * @var Name|Expr */ private $name; /** * @var Expr\FuncCall */ private $originalNode; /** * @param Name|Expr $name */ public function __construct($name, Expr\FuncCall $originalNode) { $this->name = $name; $this->originalNode = $originalNode; parent::__construct($this->originalNode->getAttributes()); } /** * @return Expr|Name */ public function getName() { return $this->name; } public function getOriginalNode() : Expr\FuncCall { return $this->originalNode; } public function getType() : string { return 'PHPStan_Node_FunctionCallableNode'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\Node\Expr; use PhpParser\NodeAbstract; use PHPStan\Analyser\StatementExitPoint; final class DoWhileLoopConditionNode extends NodeAbstract implements \PHPStan\Node\VirtualNode { /** * @var Expr */ private $cond; /** * @var StatementExitPoint[] */ private $exitPoints; /** * @param StatementExitPoint[] $exitPoints */ public function __construct(Expr $cond, array $exitPoints) { $this->cond = $cond; $this->exitPoints = $exitPoints; parent::__construct($cond->getAttributes()); } public function getCond() : Expr { return $this->cond; } /** * @return StatementExitPoint[] */ public function getExitPoints() : array { return $this->exitPoints; } public function getType() : string { return 'PHPStan_Node_ClosureReturnStatementsNode'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\Node\Expr; use PhpParser\NodeAbstract; final class PropertyAssignNode extends NodeAbstract implements \PHPStan\Node\VirtualNode { /** * @var Expr\PropertyFetch|Expr\StaticPropertyFetch */ private $propertyFetch; /** * @var Expr */ private $assignedExpr; /** * @var bool */ private $assignOp; /** * @param Expr\PropertyFetch|Expr\StaticPropertyFetch $propertyFetch */ public function __construct($propertyFetch, Expr $assignedExpr, bool $assignOp) { $this->propertyFetch = $propertyFetch; $this->assignedExpr = $assignedExpr; $this->assignOp = $assignOp; parent::__construct($propertyFetch->getAttributes()); } /** * @return Expr\PropertyFetch|Expr\StaticPropertyFetch */ public function getPropertyFetch() { return $this->propertyFetch; } public function getAssignedExpr() : Expr { return $this->assignedExpr; } public function isAssignOp() : bool { return $this->assignOp; } public function getType() : string { return 'PHPStan_Node_PropertyAssignNodeNode'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Node\Printer; use PhpParser\PrettyPrinter\Standard; use PHPStan\Node\Expr\AlwaysRememberedExpr; use PHPStan\Node\Expr\ExistingArrayDimFetch; use PHPStan\Node\Expr\GetIterableKeyTypeExpr; use PHPStan\Node\Expr\GetIterableValueTypeExpr; use PHPStan\Node\Expr\GetOffsetValueTypeExpr; use PHPStan\Node\Expr\OriginalPropertyTypeExpr; use PHPStan\Node\Expr\ParameterVariableOriginalValueExpr; use PHPStan\Node\Expr\PropertyInitializationExpr; use PHPStan\Node\Expr\SetExistingOffsetValueTypeExpr; use PHPStan\Node\Expr\SetOffsetValueTypeExpr; use PHPStan\Node\Expr\TypeExpr; use PHPStan\Node\Expr\UnsetOffsetExpr; use PHPStan\Node\IssetExpr; use PHPStan\Type\VerbosityLevel; use function sprintf; final class Printer extends Standard { public function __construct() { parent::__construct(['shortArraySyntax' => \true]); } protected function pPHPStan_Node_TypeExpr(TypeExpr $expr) : string { return sprintf('__phpstanType(%s)', $expr->getExprType()->describe(VerbosityLevel::precise())); } protected function pPHPStan_Node_GetOffsetValueTypeExpr(GetOffsetValueTypeExpr $expr) : string { return sprintf('__phpstanGetOffsetValueType(%s, %s)', $this->p($expr->getVar()), $this->p($expr->getDim())); } protected function pPHPStan_Node_UnsetOffsetExpr(UnsetOffsetExpr $expr) : string { return sprintf('__phpstanUnsetOffset(%s, %s)', $this->p($expr->getVar()), $this->p($expr->getDim())); } protected function pPHPStan_Node_GetIterableValueTypeExpr(GetIterableValueTypeExpr $expr) : string { return sprintf('__phpstanGetIterableValueType(%s)', $this->p($expr->getExpr())); } protected function pPHPStan_Node_GetIterableKeyTypeExpr(GetIterableKeyTypeExpr $expr) : string { return sprintf('__phpstanGetIterableKeyType(%s)', $this->p($expr->getExpr())); } protected function pPHPStan_Node_ExistingArrayDimFetch(ExistingArrayDimFetch $expr) : string { return sprintf('__phpstanExistingArrayDimFetch(%s, %s)', $this->p($expr->getVar()), $this->p($expr->getDim())); } protected function pPHPStan_Node_OriginalPropertyTypeExpr(OriginalPropertyTypeExpr $expr) : string { return sprintf('__phpstanOriginalPropertyType(%s)', $this->p($expr->getPropertyFetch())); } protected function pPHPStan_Node_SetOffsetValueTypeExpr(SetOffsetValueTypeExpr $expr) : string { return sprintf('__phpstanSetOffsetValueType(%s, %s, %s)', $this->p($expr->getVar()), $expr->getDim() !== null ? $this->p($expr->getDim()) : 'null', $this->p($expr->getValue())); } protected function pPHPStan_Node_SetExistingOffsetValueTypeExpr(SetExistingOffsetValueTypeExpr $expr) : string { return sprintf('__phpstanSetExistingOffsetValueType(%s, %s, %s)', $this->p($expr->getVar()), $this->p($expr->getDim()), $this->p($expr->getValue())); } protected function pPHPStan_Node_AlwaysRememberedExpr(AlwaysRememberedExpr $expr) : string { return sprintf('__phpstanRembered(%s)', $this->p($expr->getExpr())); } protected function pPHPStan_Node_PropertyInitializationExpr(PropertyInitializationExpr $expr) : string { return sprintf('__phpstanPropertyInitialization(%s)', $expr->getPropertyName()); } protected function pPHPStan_Node_ParameterVariableOriginalValueExpr(ParameterVariableOriginalValueExpr $expr) : string { return sprintf('__phpstanParameterVariableOriginalValue(%s)', $expr->getVariableName()); } protected function pPHPStan_Node_IssetExpr(IssetExpr $expr) : string { return sprintf('__phpstanIssetExpr(%s)', $this->p($expr->getExpr())); } } <?php declare (strict_types=1); namespace PHPStan\Node\Printer; use PhpParser\Node\Expr; /** * @api * @final */ class ExprPrinter { /** * @var Printer */ private $printer; public function __construct(\PHPStan\Node\Printer\Printer $printer) { $this->printer = $printer; } public function printExpr(Expr $expr) : string { /** @var string|null $exprString */ $exprString = $expr->getAttribute('phpstan_cache_printer'); if ($exprString === null) { $exprString = $this->printer->prettyPrintExpr($expr); $expr->setAttribute('phpstan_cache_printer', $exprString); } return $exprString; } } <?php declare (strict_types=1); namespace PHPStan\Node\Printer; use PhpParser\Node; use PHPStan\ShouldNotHappenException; use function array_map; use function implode; final class NodeTypePrinter { /** * @param Node\Name|Node\Identifier|Node\ComplexType|null $type */ public static function printType($type) : ?string { if ($type === null) { return null; } if ($type instanceof Node\NullableType) { return '?' . self::printType($type->type); } if ($type instanceof Node\UnionType) { return implode('|', array_map(static function ($innerType) : string { $printedType = self::printType($innerType); if ($printedType === null) { throw new ShouldNotHappenException(); } return $printedType; }, $type->types)); } if ($type instanceof Node\IntersectionType) { return implode('&', array_map(static function ($innerType) : string { $printedType = self::printType($innerType); if ($printedType === null) { throw new ShouldNotHappenException(); } return $printedType; }, $type->types)); } if ($type instanceof Node\Identifier || $type instanceof Node\Name) { return $type->toString(); } throw new ShouldNotHappenException(); } } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\NodeAbstract; use PHPStan\Analyser\StatementExitPoint; /** * @api * @final */ class FinallyExitPointsNode extends NodeAbstract implements \PHPStan\Node\VirtualNode { /** * @var StatementExitPoint[] */ private $finallyExitPoints; /** * @var StatementExitPoint[] */ private $tryCatchExitPoints; /** * @param StatementExitPoint[] $finallyExitPoints * @param StatementExitPoint[] $tryCatchExitPoints */ public function __construct(array $finallyExitPoints, array $tryCatchExitPoints) { $this->finallyExitPoints = $finallyExitPoints; $this->tryCatchExitPoints = $tryCatchExitPoints; parent::__construct([]); } /** * @return StatementExitPoint[] */ public function getFinallyExitPoints() : array { return $this->finallyExitPoints; } /** * @return StatementExitPoint[] */ public function getTryCatchExitPoints() : array { return $this->tryCatchExitPoints; } public function getType() : string { return 'PHPStan_Node_FinallyExitPointsNode'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\Node\Expr\Yield_; use PhpParser\Node\Expr\YieldFrom; use PHPStan\Analyser\ImpurePoint; use PHPStan\Analyser\StatementResult; /** @api */ interface ReturnStatementsNode extends \PHPStan\Node\VirtualNode { /** * @return list<ReturnStatement> */ public function getReturnStatements() : array; public function getStatementResult() : StatementResult; /** * @return list<ExecutionEndNode> */ public function getExecutionEnds() : array; /** * @return ImpurePoint[] */ public function getImpurePoints() : array; public function returnsByRef() : bool; public function hasNativeReturnTypehint() : bool; /** * @return list<Yield_|YieldFrom> */ public function getYieldStatements() : array; public function isGenerator() : bool; } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\Node\Expr; use PhpParser\Node\Name; /** * @api * @final */ class InstantiationCallableNode extends Expr implements \PHPStan\Node\VirtualNode { /** * @var Name|Expr */ private $class; /** * @var Expr\New_ */ private $originalNode; /** * @param Name|Expr $class */ public function __construct($class, Expr\New_ $originalNode) { $this->class = $class; $this->originalNode = $originalNode; parent::__construct($this->originalNode->getAttributes()); } /** * @return Expr|Name */ public function getClass() { return $this->class; } public function getOriginalNode() : Expr\New_ { return $this->originalNode; } public function getType() : string { return 'PHPStan_Node_InstantiationCallableNode'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Node\Expr; use PhpParser\Node\Expr; use PHPStan\Node\VirtualNode; final class PropertyInitializationExpr extends Expr implements VirtualNode { /** * @var string */ private $propertyName; public function __construct(string $propertyName) { $this->propertyName = $propertyName; parent::__construct([]); } public function getPropertyName() : string { return $this->propertyName; } public function getType() : string { return 'PHPStan_Node_PropertyInitializationExpr'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Node\Expr; use PhpParser\Node\Expr; use PHPStan\Node\VirtualNode; final class GetIterableKeyTypeExpr extends Expr implements VirtualNode { /** * @var Expr */ private $expr; public function __construct(Expr $expr) { $this->expr = $expr; parent::__construct([]); } public function getExpr() : Expr { return $this->expr; } public function getType() : string { return 'PHPStan_Node_GetIterableKeyTypeExpr'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Node\Expr; use PhpParser\Node\Expr; use PHPStan\Node\VirtualNode; use PHPStan\Type\Type; final class AlwaysRememberedExpr extends Expr implements VirtualNode { /** * @var Expr */ public $expr; /** * @var Type */ private $type; /** * @var Type */ private $nativeType; public function __construct(Expr $expr, Type $type, Type $nativeType) { $this->expr = $expr; $this->type = $type; $this->nativeType = $nativeType; parent::__construct([]); } public function getExpr() : Expr { return $this->expr; } public function getExprType() : Type { return $this->type; } public function getNativeExprType() : Type { return $this->nativeType; } public function getType() : string { return 'PHPStan_Node_AlwaysRememberedExpr'; } /** * @return string[] */ public function getSubNodeNames() : array { return ['expr']; } } <?php declare (strict_types=1); namespace PHPStan\Node\Expr; use PhpParser\Node\Expr; use PHPStan\Node\VirtualNode; final class ExistingArrayDimFetch extends Expr implements VirtualNode { /** * @var Expr */ private $var; /** * @var Expr */ private $dim; public function __construct(Expr $var, Expr $dim) { $this->var = $var; $this->dim = $dim; parent::__construct([]); } public function getVar() : Expr { return $this->var; } public function getDim() : Expr { return $this->dim; } public function getType() : string { return 'PHPStan_Node_ExistingArrayDimFetch'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Node\Expr; use PhpParser\Node\Expr; use PHPStan\Node\VirtualNode; final class OriginalPropertyTypeExpr extends Expr implements VirtualNode { /** * @var Expr\PropertyFetch|Expr\StaticPropertyFetch */ private $propertyFetch; /** * @param Expr\PropertyFetch|Expr\StaticPropertyFetch $propertyFetch */ public function __construct($propertyFetch) { $this->propertyFetch = $propertyFetch; parent::__construct([]); } /** * @return Expr\PropertyFetch|Expr\StaticPropertyFetch */ public function getPropertyFetch() { return $this->propertyFetch; } public function getType() : string { return 'PHPStan_Node_OriginalPropertyTypeExpr'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Node\Expr; use PhpParser\Node\Expr; use PHPStan\Node\VirtualNode; final class SetExistingOffsetValueTypeExpr extends Expr implements VirtualNode { /** * @var Expr */ private $var; /** * @var Expr */ private $dim; /** * @var Expr */ private $value; public function __construct(Expr $var, Expr $dim, Expr $value) { $this->var = $var; $this->dim = $dim; $this->value = $value; parent::__construct([]); } public function getVar() : Expr { return $this->var; } public function getDim() : Expr { return $this->dim; } public function getValue() : Expr { return $this->value; } public function getType() : string { return 'PHPStan_Node_SetExistingOffsetValueTypeExpr'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Node\Expr; use PhpParser\Node\Expr; use PHPStan\Node\VirtualNode; final class GetIterableValueTypeExpr extends Expr implements VirtualNode { /** * @var Expr */ private $expr; public function __construct(Expr $expr) { $this->expr = $expr; parent::__construct([]); } public function getExpr() : Expr { return $this->expr; } public function getType() : string { return 'PHPStan_Node_GetIterableValueTypeExpr'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Node\Expr; use PhpParser\Node\Expr; use PHPStan\Node\VirtualNode; final class SetOffsetValueTypeExpr extends Expr implements VirtualNode { /** * @var Expr */ private $var; /** * @var ?Expr */ private $dim; /** * @var Expr */ private $value; public function __construct(Expr $var, ?Expr $dim, Expr $value) { $this->var = $var; $this->dim = $dim; $this->value = $value; parent::__construct([]); } public function getVar() : Expr { return $this->var; } public function getDim() : ?Expr { return $this->dim; } public function getValue() : Expr { return $this->value; } public function getType() : string { return 'PHPStan_Node_SetOffsetValueTypeExpr'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Node\Expr; use PhpParser\Node\Expr; use PHPStan\Node\VirtualNode; use PHPStan\Type\Type; /** * @api */ final class TypeExpr extends Expr implements VirtualNode { /** * @var Type */ private $exprType; /** @api */ public function __construct(Type $exprType) { $this->exprType = $exprType; parent::__construct(); } public function getExprType() : Type { return $this->exprType; } public function getType() : string { return 'PHPStan_Node_TypeExpr'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Node\Expr; use PhpParser\Node\Expr; use PHPStan\Node\VirtualNode; final class ParameterVariableOriginalValueExpr extends Expr implements VirtualNode { /** * @var string */ private $variableName; public function __construct(string $variableName) { $this->variableName = $variableName; parent::__construct([]); } public function getVariableName() : string { return $this->variableName; } public function getType() : string { return 'PHPStan_Node_ParameterVariableOriginalValueExpr'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Node\Expr; use PhpParser\Node\Expr; use PHPStan\Node\VirtualNode; final class GetOffsetValueTypeExpr extends Expr implements VirtualNode { /** * @var Expr */ private $var; /** * @var Expr */ private $dim; public function __construct(Expr $var, Expr $dim) { $this->var = $var; $this->dim = $dim; parent::__construct([]); } public function getVar() : Expr { return $this->var; } public function getDim() : Expr { return $this->dim; } public function getType() : string { return 'PHPStan_Node_GetOffsetValueTypeExpr'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Node\Expr; use PhpParser\Node\Expr; use PHPStan\Node\VirtualNode; final class UnsetOffsetExpr extends Expr implements VirtualNode { /** * @var Expr */ private $var; /** * @var Expr */ private $dim; public function __construct(Expr $var, Expr $dim) { $this->var = $var; $this->dim = $dim; parent::__construct([]); } public function getVar() : Expr { return $this->var; } public function getDim() : Expr { return $this->dim; } public function getType() : string { return 'PHPStan_Node_UnsetOffsetExpr'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\Node; use PhpParser\NodeAbstract; use PHPStan\Collectors\CollectedData; use PHPStan\Collectors\Collector; use function array_key_exists; /** * @api * @final */ class CollectedDataNode extends NodeAbstract implements \PHPStan\Node\VirtualNode { /** * @var CollectedData[] */ private $collectedData; /** * @var bool */ private $onlyFiles; /** * @param CollectedData[] $collectedData */ public function __construct(array $collectedData, bool $onlyFiles) { $this->collectedData = $collectedData; $this->onlyFiles = $onlyFiles; parent::__construct([]); } /** * @template TCollector of Collector<Node, TValue> * @template TValue * @param class-string<TCollector> $collectorType * @return array<string, list<TValue>> */ public function get(string $collectorType) : array { $result = []; foreach ($this->collectedData as $collectedData) { if ($collectedData->getCollectorType() !== $collectorType) { continue; } $filePath = $collectedData->getFilePath(); if (!array_key_exists($filePath, $result)) { $result[$filePath] = []; } $result[$filePath][] = $collectedData->getData(); } return $result; } /** * Indicates that only files were passed to the analyser, not directory paths. * * True being returned strongly suggests that it's a partial analysis, not full project analysis. */ public function isOnlyFilesAnalysis() : bool { return $this->onlyFiles; } public function getType() : string { return 'PHPStan_Node_CollectedDataNode'; } /** * @return array{} */ public function getSubNodeNames() : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Node\Constant; use PhpParser\Node\Expr\ClassConstFetch; use PHPStan\Analyser\Scope; /** * @api * @final */ class ClassConstantFetch { /** * @var ClassConstFetch */ private $node; /** * @var Scope */ private $scope; public function __construct(ClassConstFetch $node, Scope $scope) { $this->node = $node; $this->scope = $scope; } public function getNode() : ClassConstFetch { return $this->node; } public function getScope() : Scope { return $this->scope; } } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\Node\Expr\Array_; use PhpParser\NodeAbstract; /** * @api * @final */ class LiteralArrayNode extends NodeAbstract implements \PHPStan\Node\VirtualNode { /** * @var LiteralArrayItem[] */ private $itemNodes; /** * @param LiteralArrayItem[] $itemNodes */ public function __construct(Array_ $originalNode, array $itemNodes) { $this->itemNodes = $itemNodes; parent::__construct($originalNode->getAttributes()); } /** * @return LiteralArrayItem[] */ public function getItemNodes() : array { return $this->itemNodes; } public function getType() : string { return 'PHPStan_Node_LiteralArray'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\Node\Stmt\Catch_; use PhpParser\NodeAbstract; use PHPStan\Type\Type; /** * @api * @final */ class CatchWithUnthrownExceptionNode extends NodeAbstract implements \PHPStan\Node\VirtualNode { /** * @var Catch_ */ private $originalNode; /** * @var Type */ private $caughtType; /** * @var Type */ private $originalCaughtType; public function __construct(Catch_ $originalNode, Type $caughtType, Type $originalCaughtType) { $this->originalNode = $originalNode; $this->caughtType = $caughtType; $this->originalCaughtType = $originalCaughtType; parent::__construct($originalNode->getAttributes()); } public function getOriginalNode() : Catch_ { return $this->originalNode; } public function getCaughtType() : Type { return $this->caughtType; } public function getOriginalCaughtType() : Type { return $this->originalCaughtType; } public function getType() : string { return 'PHPStan_Node_CatchWithUnthrownExceptionNode'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\Node\Expr; use PhpParser\Node\Identifier; /** * @api * @final */ class MethodCallableNode extends Expr implements \PHPStan\Node\VirtualNode { /** * @var Expr */ private $var; /** * @var Identifier|Expr */ private $name; /** * @var Expr\MethodCall */ private $originalNode; /** * @param Identifier|Expr $name */ public function __construct(Expr $var, $name, Expr\MethodCall $originalNode) { $this->var = $var; $this->name = $name; $this->originalNode = $originalNode; parent::__construct($originalNode->getAttributes()); } public function getVar() : Expr { return $this->var; } /** * @return Expr|Identifier */ public function getName() { return $this->name; } public function getOriginalNode() : Expr\MethodCall { return $this->originalNode; } public function getType() : string { return 'PHPStan_Node_MethodCallableNode'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\Node\Stmt\ClassConst; use PhpParser\Node\Stmt\ClassLike; use PhpParser\NodeAbstract; use PHPStan\Node\Constant\ClassConstantFetch; use PHPStan\Reflection\ClassReflection; /** * @api * @final */ class ClassConstantsNode extends NodeAbstract implements \PHPStan\Node\VirtualNode { /** * @var ClassLike */ private $class; /** * @var ClassConst[] */ private $constants; /** * @var ClassConstantFetch[] */ private $fetches; /** * @var ClassReflection */ private $classReflection; /** * @param ClassConst[] $constants * @param ClassConstantFetch[] $fetches */ public function __construct(ClassLike $class, array $constants, array $fetches, ClassReflection $classReflection) { $this->class = $class; $this->constants = $constants; $this->fetches = $fetches; $this->classReflection = $classReflection; parent::__construct($class->getAttributes()); } public function getClass() : ClassLike { return $this->class; } /** * @return ClassConst[] */ public function getConstants() : array { return $this->constants; } /** * @return ClassConstantFetch[] */ public function getFetches() : array { return $this->fetches; } public function getType() : string { return 'PHPStan_Node_ClassConstantsNode'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } public function getClassReflection() : ClassReflection { return $this->classReflection; } } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\Node\Expr; use PhpParser\NodeAbstract; /** * @api * @final */ class InvalidateExprNode extends NodeAbstract implements \PHPStan\Node\VirtualNode { /** * @var Expr */ private $expr; public function __construct(Expr $expr) { $this->expr = $expr; parent::__construct($expr->getAttributes()); } public function getExpr() : Expr { return $this->expr; } public function getType() : string { return 'PHPStan_Node_InvalidateExpr'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\Node; use PhpParser\NodeAbstract; /** * @api * @final */ class FileNode extends NodeAbstract implements \PHPStan\Node\VirtualNode { /** * @var Node[] */ private $nodes; /** * @param Node[] $nodes */ public function __construct(array $nodes) { $this->nodes = $nodes; $firstNode = $nodes[0] ?? null; parent::__construct($firstNode !== null ? $firstNode->getAttributes() : []); } /** * @return Node[] */ public function getNodes() : array { return $this->nodes; } public function getType() : string { return 'PHPStan_Node_FileNode'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\Node\Expr\ArrayItem; use PHPStan\Analyser\Scope; /** * @api * @final */ class LiteralArrayItem { /** * @var Scope */ private $scope; /** * @var ?ArrayItem */ private $arrayItem; public function __construct(Scope $scope, ?ArrayItem $arrayItem) { $this->scope = $scope; $this->arrayItem = $arrayItem; } public function getScope() : Scope { return $this->scope; } public function getArrayItem() : ?ArrayItem { return $this->arrayItem; } } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\Node\Expr; use PhpParser\NodeAbstract; final class VariableAssignNode extends NodeAbstract implements \PHPStan\Node\VirtualNode { /** * @var Expr\Variable */ private $variable; /** * @var Expr */ private $assignedExpr; /** * @var bool */ private $assignOp; public function __construct(Expr\Variable $variable, Expr $assignedExpr, bool $assignOp) { $this->variable = $variable; $this->assignedExpr = $assignedExpr; $this->assignOp = $assignOp; parent::__construct($variable->getAttributes()); } public function getVariable() : Expr\Variable { return $this->variable; } public function getAssignedExpr() : Expr { return $this->assignedExpr; } public function isAssignOp() : bool { return $this->assignOp; } public function getType() : string { return 'PHPStan_Node_VariableAssignNodeNode'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\Node; use PhpParser\Node\Expr\Closure; use PhpParser\Node\Expr\Yield_; use PhpParser\Node\Expr\YieldFrom; use PhpParser\NodeAbstract; use PHPStan\Analyser\ImpurePoint; use PHPStan\Analyser\StatementResult; use function count; /** * @api * @final */ class ClosureReturnStatementsNode extends NodeAbstract implements \PHPStan\Node\ReturnStatementsNode { /** * @var list<ReturnStatement> */ private $returnStatements; /** * @var list<Yield_|YieldFrom> */ private $yieldStatements; /** * @var StatementResult */ private $statementResult; /** * @var list<ExecutionEndNode> */ private $executionEnds; /** * @var ImpurePoint[] */ private $impurePoints; /** * @var Node\Expr\Closure */ private $closureExpr; /** * @param list<ReturnStatement> $returnStatements * @param list<Yield_|YieldFrom> $yieldStatements * @param list<ExecutionEndNode> $executionEnds * @param ImpurePoint[] $impurePoints */ public function __construct(Closure $closureExpr, array $returnStatements, array $yieldStatements, StatementResult $statementResult, array $executionEnds, array $impurePoints) { $this->returnStatements = $returnStatements; $this->yieldStatements = $yieldStatements; $this->statementResult = $statementResult; $this->executionEnds = $executionEnds; $this->impurePoints = $impurePoints; parent::__construct($closureExpr->getAttributes()); $this->closureExpr = $closureExpr; } public function getClosureExpr() : Closure { return $this->closureExpr; } public function hasNativeReturnTypehint() : bool { return $this->closureExpr->returnType !== null; } public function getReturnStatements() : array { return $this->returnStatements; } public function getExecutionEnds() : array { return $this->executionEnds; } public function getImpurePoints() : array { return $this->impurePoints; } public function getYieldStatements() : array { return $this->yieldStatements; } public function isGenerator() : bool { return count($this->yieldStatements) > 0; } public function getStatementResult() : StatementResult { return $this->statementResult; } public function returnsByRef() : bool { return $this->closureExpr->byRef; } public function getType() : string { return 'PHPStan_Node_ClosureReturnStatementsNode'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\Node\Stmt\Foreach_; use PhpParser\NodeAbstract; final class InForeachNode extends NodeAbstract implements \PHPStan\Node\VirtualNode { /** * @var Foreach_ */ private $originalNode; public function __construct(Foreach_ $originalNode) { $this->originalNode = $originalNode; parent::__construct($originalNode->getAttributes()); } public function getOriginalNode() : Foreach_ { return $this->originalNode; } public function getType() : string { return 'PHPStan_Node_InForeachNode'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\Node; use PhpParser\Node\Expr\ArrowFunction; use PhpParser\NodeAbstract; use PHPStan\Type\ClosureType; /** * @api * @final */ class InArrowFunctionNode extends NodeAbstract implements \PHPStan\Node\VirtualNode { /** * @var ClosureType */ private $closureType; /** * @var Node\Expr\ArrowFunction */ private $originalNode; public function __construct(ClosureType $closureType, ArrowFunction $originalNode) { $this->closureType = $closureType; parent::__construct($originalNode->getAttributes()); $this->originalNode = $originalNode; } public function getClosureType() : ClosureType { return $this->closureType; } public function getOriginalNode() : Node\Expr\ArrowFunction { return $this->originalNode; } public function getType() : string { return 'PHPStan_Node_InArrowFunctionNode'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Node\Method; use PhpParser\Node; use PhpParser\Node\Expr\Array_; use PhpParser\Node\Expr\StaticCall; use PHPStan\Analyser\Scope; /** * @api * @final */ class MethodCall { /** * @var Node\Expr\MethodCall|StaticCall|Array_ */ private $node; /** * @var Scope */ private $scope; /** * @param Node\Expr\MethodCall|StaticCall|Array_ $node */ public function __construct($node, Scope $scope) { $this->node = $node; $this->scope = $scope; } /** * @return Node\Expr\MethodCall|StaticCall|Array_ */ public function getNode() { return $this->node; } public function getScope() : Scope { return $this->scope; } } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\Node\Stmt\While_; use PhpParser\NodeAbstract; use PHPStan\Analyser\StatementExitPoint; /** * @api * @final */ class BreaklessWhileLoopNode extends NodeAbstract implements \PHPStan\Node\VirtualNode { /** * @var While_ */ private $originalNode; /** * @var StatementExitPoint[] */ private $exitPoints; /** * @param StatementExitPoint[] $exitPoints */ public function __construct(While_ $originalNode, array $exitPoints) { $this->originalNode = $originalNode; $this->exitPoints = $exitPoints; parent::__construct($originalNode->getAttributes()); } public function getOriginalNode() : While_ { return $this->originalNode; } /** * @return StatementExitPoint[] */ public function getExitPoints() : array { return $this->exitPoints; } public function getType() : string { return 'PHPStan_Node_BreaklessWhileLoop'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\Node\Expr\Yield_; use PhpParser\Node\Expr\YieldFrom; use PhpParser\Node\Stmt; use PhpParser\Node\Stmt\ClassMethod; use PhpParser\NodeAbstract; use PHPStan\Analyser\ImpurePoint; use PHPStan\Analyser\StatementResult; use PHPStan\Reflection\ClassReflection; use PHPStan\Reflection\Php\PhpMethodFromParserNodeReflection; use function count; /** * @api * @final */ class MethodReturnStatementsNode extends NodeAbstract implements \PHPStan\Node\ReturnStatementsNode { /** * @var list<ReturnStatement> */ private $returnStatements; /** * @var list<Yield_|YieldFrom> */ private $yieldStatements; /** * @var StatementResult */ private $statementResult; /** * @var list<ExecutionEndNode> */ private $executionEnds; /** * @var ImpurePoint[] */ private $impurePoints; /** * @var ClassReflection */ private $classReflection; /** * @var PhpMethodFromParserNodeReflection */ private $methodReflection; /** * @var ClassMethod */ private $classMethod; /** * @param list<ReturnStatement> $returnStatements * @param list<Yield_|YieldFrom> $yieldStatements * @param list<ExecutionEndNode> $executionEnds * @param ImpurePoint[] $impurePoints */ public function __construct(ClassMethod $method, array $returnStatements, array $yieldStatements, StatementResult $statementResult, array $executionEnds, array $impurePoints, ClassReflection $classReflection, PhpMethodFromParserNodeReflection $methodReflection) { $this->returnStatements = $returnStatements; $this->yieldStatements = $yieldStatements; $this->statementResult = $statementResult; $this->executionEnds = $executionEnds; $this->impurePoints = $impurePoints; $this->classReflection = $classReflection; $this->methodReflection = $methodReflection; parent::__construct($method->getAttributes()); $this->classMethod = $method; } public function getReturnStatements() : array { return $this->returnStatements; } public function getStatementResult() : StatementResult { return $this->statementResult; } public function getExecutionEnds() : array { return $this->executionEnds; } public function getImpurePoints() : array { return $this->impurePoints; } public function returnsByRef() : bool { return $this->classMethod->byRef; } public function hasNativeReturnTypehint() : bool { return $this->classMethod->returnType !== null; } public function getMethodName() : string { return $this->classMethod->name->toString(); } public function getYieldStatements() : array { return $this->yieldStatements; } public function getClassReflection() : ClassReflection { return $this->classReflection; } public function getMethodReflection() : PhpMethodFromParserNodeReflection { return $this->methodReflection; } /** * @return Stmt[] */ public function getStatements() : array { $stmts = $this->classMethod->getStmts(); if ($stmts === null) { return []; } return $stmts; } public function isGenerator() : bool { return count($this->yieldStatements) > 0; } public function getType() : string { return 'PHPStan_Node_MethodReturnStatementsNode'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\Node\Stmt\ClassMethod as PhpParserClassMethod; /** * @api * @final */ class ClassMethod extends PhpParserClassMethod { /** * @var bool */ private $isDeclaredInTrait; public function __construct(\PhpParser\Node\Stmt\ClassMethod $node, bool $isDeclaredInTrait) { $this->isDeclaredInTrait = $isDeclaredInTrait; parent::__construct($node->name, ['flags' => $node->flags, 'byRef' => $node->byRef, 'params' => $node->params, 'returnType' => $node->returnType, 'stmts' => $node->stmts, 'attrGroups' => $node->attrGroups], $node->attributes); } public function getNode() : PhpParserClassMethod { return $this; } public function isDeclaredInTrait() : bool { return $this->isDeclaredInTrait; } } <?php declare (strict_types=1); namespace PHPStan\Node; use PhpParser\Node; use PhpParser\Node\Stmt\ClassLike; use PHPStan\Reflection\ClassReflection; /** * @api * @final */ class InClassNode extends Node\Stmt implements \PHPStan\Node\VirtualNode { /** * @var ClassLike */ private $originalNode; /** * @var ClassReflection */ private $classReflection; public function __construct(ClassLike $originalNode, ClassReflection $classReflection) { $this->originalNode = $originalNode; $this->classReflection = $classReflection; parent::__construct($originalNode->getAttributes()); } public function getOriginalNode() : ClassLike { return $this->originalNode; } public function getClassReflection() : ClassReflection { return $this->classReflection; } public function getType() : string { return 'PHPStan_Stmt_InClassNode'; } /** * @return string[] */ public function getSubNodeNames() : array { return []; } } <?php declare (strict_types=1); namespace PHPStan\Classes; /** * This is the extension interface to implement if you want to dynamically * add forbidden class prefixes to the ClassForbiddenNameCheck rule. * * The idea is that you want to report usages of classes that you're not supposed to use in application. * For example: Generated Doctrine proxies from their configured namespace. * * To register it in the configuration file use the `phpstan.forbiddenClassNamesExtension` service tag: * * ``` * services: * - * class: App\PHPStan\MyExtension * tags: * - phpstan.forbiddenClassNamesExtension * ``` * * @api */ interface ForbiddenClassNameExtension { public const EXTENSION_TAG = 'phpstan.forbiddenClassNamesExtension'; /** @return array<string, string> */ public function getClassPrefixes() : array; } includes: - config.level9.neon includes: - config.level1.neon parameters: checkClassCaseSensitivity: true checkThisOnly: false checkPhpDocMissingReturn: true rules: - PHPStan\Rules\Cast\EchoRule - PHPStan\Rules\Cast\InvalidCastRule - PHPStan\Rules\Cast\InvalidPartOfEncapsedStringRule - PHPStan\Rules\Cast\PrintRule - PHPStan\Rules\Classes\AccessPrivateConstantThroughStaticRule - PHPStan\Rules\Comparison\UsageOfVoidMatchExpressionRule - PHPStan\Rules\Constants\ValueAssignedToClassConstantRule - PHPStan\Rules\Functions\IncompatibleDefaultParameterTypeRule - PHPStan\Rules\Generics\ClassAncestorsRule - PHPStan\Rules\Generics\ClassTemplateTypeRule - PHPStan\Rules\Generics\EnumAncestorsRule - PHPStan\Rules\Generics\EnumTemplateTypeRule - PHPStan\Rules\Generics\FunctionTemplateTypeRule - PHPStan\Rules\Generics\FunctionSignatureVarianceRule - PHPStan\Rules\Generics\InterfaceAncestorsRule - PHPStan\Rules\Generics\InterfaceTemplateTypeRule - PHPStan\Rules\Generics\MethodTemplateTypeRule - PHPStan\Rules\Generics\MethodTagTemplateTypeRule - PHPStan\Rules\Generics\MethodSignatureVarianceRule - PHPStan\Rules\Generics\TraitTemplateTypeRule - PHPStan\Rules\Generics\UsedTraitsRule - PHPStan\Rules\Methods\CallPrivateMethodThroughStaticRule - PHPStan\Rules\Methods\IncompatibleDefaultParameterTypeRule - PHPStan\Rules\Operators\InvalidComparisonOperationRule - PHPStan\Rules\PhpDoc\FunctionConditionalReturnTypeRule - PHPStan\Rules\PhpDoc\MethodConditionalReturnTypeRule - PHPStan\Rules\PhpDoc\FunctionAssertRule - PHPStan\Rules\PhpDoc\MethodAssertRule - PHPStan\Rules\PhpDoc\IncompatibleSelfOutTypeRule - PHPStan\Rules\PhpDoc\IncompatibleClassConstantPhpDocTypeRule - PHPStan\Rules\PhpDoc\IncompatiblePhpDocTypeRule - PHPStan\Rules\PhpDoc\IncompatiblePropertyPhpDocTypeRule - PHPStan\Rules\PhpDoc\InvalidThrowsPhpDocValueRule - PHPStan\Rules\PhpDoc\IncompatibleParamImmediatelyInvokedCallableRule - PHPStan\Rules\Properties\AccessPrivatePropertyThroughStaticRule - PHPStan\Rules\Classes\RequireImplementsRule - PHPStan\Rules\Classes\RequireExtendsRule - PHPStan\Rules\PhpDoc\RequireImplementsDefinitionClassRule - PHPStan\Rules\PhpDoc\RequireExtendsDefinitionClassRule - PHPStan\Rules\PhpDoc\RequireExtendsDefinitionTraitRule conditionalTags: PHPStan\Rules\Classes\MethodTagRule: phpstan.rules.rule: %featureToggles.absentTypeChecks% PHPStan\Rules\Classes\MethodTagTraitRule: phpstan.rules.rule: %featureToggles.absentTypeChecks% PHPStan\Rules\Classes\MethodTagTraitUseRule: phpstan.rules.rule: %featureToggles.absentTypeChecks% PHPStan\Rules\Classes\MixinTraitRule: phpstan.rules.rule: %featureToggles.absentTypeChecks% PHPStan\Rules\Classes\MixinTraitUseRule: phpstan.rules.rule: %featureToggles.absentTypeChecks% PHPStan\Rules\Classes\PropertyTagRule: phpstan.rules.rule: %featureToggles.absentTypeChecks% PHPStan\Rules\Classes\PropertyTagTraitRule: phpstan.rules.rule: %featureToggles.absentTypeChecks% PHPStan\Rules\Classes\PropertyTagTraitUseRule: phpstan.rules.rule: %featureToggles.absentTypeChecks% PHPStan\Rules\Functions\IncompatibleArrowFunctionDefaultParameterTypeRule: phpstan.rules.rule: %featureToggles.closureDefaultParameterTypeRule% PHPStan\Rules\Functions\IncompatibleClosureDefaultParameterTypeRule: phpstan.rules.rule: %featureToggles.closureDefaultParameterTypeRule% PHPStan\Rules\Generics\MethodTagTemplateTypeTraitRule: phpstan.rules.rule: %featureToggles.absentTypeChecks% PHPStan\Rules\Methods\IllegalConstructorMethodCallRule: phpstan.rules.rule: %featureToggles.illegalConstructorMethodCall% PHPStan\Rules\Methods\IllegalConstructorStaticCallRule: phpstan.rules.rule: %featureToggles.illegalConstructorMethodCall% PHPStan\Rules\PhpDoc\VarTagChangedExpressionTypeRule: phpstan.rules.rule: %featureToggles.varTagType% PHPStan\Rules\Generics\PropertyVarianceRule: phpstan.rules.rule: %featureToggles.propertyVariance% PHPStan\Rules\Pure\PureFunctionRule: phpstan.rules.rule: %featureToggles.pure% PHPStan\Rules\Pure\PureMethodRule: phpstan.rules.rule: %featureToggles.pure% services: - class: PHPStan\Rules\Classes\MixinRule tags: - phpstan.rules.rule - class: PHPStan\Rules\Classes\MixinTraitRule - class: PHPStan\Rules\Classes\MixinTraitUseRule - class: PHPStan\Rules\Classes\MethodTagRule - class: PHPStan\Rules\Classes\MethodTagTraitRule - class: PHPStan\Rules\Classes\MethodTagTraitUseRule - class: PHPStan\Rules\Classes\PropertyTagRule - class: PHPStan\Rules\Classes\PropertyTagTraitRule - class: PHPStan\Rules\Classes\PropertyTagTraitUseRule - class: PHPStan\Rules\PhpDoc\RequireExtendsCheck arguments: checkClassCaseSensitivity: %checkClassCaseSensitivity% - class: PHPStan\Rules\PhpDoc\RequireImplementsDefinitionTraitRule arguments: checkClassCaseSensitivity: %checkClassCaseSensitivity% tags: - phpstan.rules.rule - class: PHPStan\Rules\Functions\IncompatibleArrowFunctionDefaultParameterTypeRule - class: PHPStan\Rules\Functions\IncompatibleClosureDefaultParameterTypeRule - class: PHPStan\Rules\Functions\CallCallablesRule arguments: reportMaybes: %reportMaybes% tags: - phpstan.rules.rule - class: PHPStan\Rules\Generics\MethodTagTemplateTypeTraitRule - class: PHPStan\Rules\Methods\IllegalConstructorMethodCallRule - class: PHPStan\Rules\Methods\IllegalConstructorStaticCallRule - class: PHPStan\Rules\PhpDoc\InvalidPhpDocTagValueRule arguments: checkAllInvalidPhpDocs: %featureToggles.allInvalidPhpDocs% invalidPhpDocTagLine: %featureToggles.invalidPhpDocTagLine% tags: - phpstan.rules.rule - class: PHPStan\Rules\PhpDoc\InvalidPhpDocVarTagTypeRule arguments: checkClassCaseSensitivity: %checkClassCaseSensitivity% checkMissingVarTagTypehint: %checkMissingVarTagTypehint% tags: - phpstan.rules.rule - class: PHPStan\Rules\PhpDoc\InvalidPHPStanDocTagRule arguments: checkAllInvalidPhpDocs: %featureToggles.allInvalidPhpDocs% tags: - phpstan.rules.rule - class: PHPStan\Rules\PhpDoc\VarTagChangedExpressionTypeRule - class: PHPStan\Rules\PhpDoc\WrongVariableNameInVarTagRule arguments: checkTypeAgainstNativeType: %featureToggles.varTagType% tags: - phpstan.rules.rule - class: PHPStan\Rules\Generics\PropertyVarianceRule arguments: readOnlyByPhpDoc: %featureToggles.readOnlyByPhpDoc% - class: PHPStan\Rules\Pure\PureFunctionRule - class: PHPStan\Rules\Pure\PureMethodRule - class: PHPStan\Rules\Operators\InvalidBinaryOperationRule arguments: bleedingEdge: %featureToggles.bleedingEdge% tags: - phpstan.rules.rule - class: PHPStan\Rules\Operators\InvalidUnaryOperationRule arguments: bleedingEdge: %featureToggles.bleedingEdge% tags: - phpstan.rules.rule includes: - config.level6.neon parameters: checkUnionTypes: true reportMaybes: true includes: - config.level5.neon parameters: checkGenericClassInNonGenericObjectType: true checkMissingIterableValueType: true checkMissingVarTagTypehint: true checkMissingTypehints: true rules: - PHPStan\Rules\Constants\MissingClassConstantTypehintRule - PHPStan\Rules\Functions\MissingFunctionReturnTypehintRule - PHPStan\Rules\Methods\MissingMethodReturnTypehintRule - PHPStan\Rules\Properties\MissingPropertyTypehintRule conditionalTags: PHPStan\Rules\Methods\MissingMethodSelfOutTypeRule: phpstan.rules.rule: %featureToggles.absentTypeChecks% services: - class: PHPStan\Rules\Functions\MissingFunctionParameterTypehintRule arguments: paramOut: %featureToggles.paramOutType% tags: - phpstan.rules.rule - class: PHPStan\Rules\Methods\MissingMethodParameterTypehintRule arguments: paramOut: %featureToggles.paramOutType% tags: - phpstan.rules.rule - class: PHPStan\Rules\Methods\MissingMethodSelfOutTypeRule includes: - config.level7.neon parameters: checkNullables: true parametersSchema: bootstrapFiles: listOf(string()) excludes_analyse: listOf(string()) excludePaths: schema(anyOf(structure({analyse: listOf(string())}), structure({analyseAndScan: listOf(string())}), structure({analyse: listOf(string()), analyseAndScan: listOf(string())})), nullable()) level: schema(anyOf(int(), string()), nullable()) paths: listOf(string()) exceptions: structure({implicitThrows: bool(), reportUncheckedExceptionDeadCatch: bool(), uncheckedExceptionRegexes: listOf(string()), uncheckedExceptionClasses: listOf(string()), checkedExceptionRegexes: listOf(string()), checkedExceptionClasses: listOf(string()), check: structure({missingCheckedExceptionInThrows: bool(), tooWideThrowType: bool()})}) featureToggles: structure({bleedingEdge: bool(), disableRuntimeReflectionProvider: bool(), skipCheckGenericClasses: listOf(string()), explicitMixedInUnknownGenericNew: bool(), explicitMixedForGlobalVariables: bool(), explicitMixedViaIsArray: bool(), arrayFilter: bool(), arrayUnpacking: bool(), arrayValues: bool(), nodeConnectingVisitorCompatibility: bool(), nodeConnectingVisitorRule: bool(), illegalConstructorMethodCall: bool(), disableCheckMissingIterableValueType: bool(), strictUnnecessaryNullsafePropertyFetch: bool(), looseComparison: bool(), consistentConstructor: bool(), checkUnresolvableParameterTypes: bool(), readOnlyByPhpDoc: bool(), phpDocParserRequireWhitespaceBeforeDescription: bool(), phpDocParserIncludeLines: bool(), enableIgnoreErrorsWithinPhpDocs: bool(), runtimeReflectionRules: bool(), notAnalysedTrait: bool(), curlSetOptTypes: bool(), listType: bool(), abstractTraitMethod: bool(), missingMagicSerializationRule: bool(), nullContextForVoidReturningFunctions: bool(), unescapeStrings: bool(), alwaysCheckTooWideReturnTypeFinalMethods: bool(), duplicateStubs: bool(), logicalXor: bool(), betterNoop: bool(), invarianceComposition: bool(), alwaysTrueAlwaysReported: bool(), disableUnreachableBranchesRules: bool(), varTagType: bool(), closureDefaultParameterTypeRule: bool(), newRuleLevelHelper: bool(), instanceofType: bool(), paramOutVariance: bool(), allInvalidPhpDocs: bool(), strictStaticMethodTemplateTypeVariance: bool(), propertyVariance: bool(), genericPrototypeMessage: bool(), stricterFunctionMap: bool(), invalidPhpDocTagLine: bool(), detectDeadTypeInMultiCatch: bool(), zeroFiles: bool(), projectServicesNotInAnalysedPaths: bool(), callUserFunc: bool(), finalByPhpDoc: bool(), magicConstantOutOfContext: bool(), paramOutType: bool(), pure: bool(), checkParameterCastableToStringFunctions: bool(), uselessReturnValue: bool(), printfArrayParameters: bool(), preciseMissingReturn: bool(), validatePregQuote: bool(), noImplicitWildcard: bool(), narrowPregMatches: bool(), tooWidePropertyType: bool(), explicitThrow: bool(), absentTypeChecks: bool(), requireFileExists: bool()}) fileExtensions: listOf(string()) checkAdvancedIsset: bool() checkAlwaysTrueCheckTypeFunctionCall: bool() checkAlwaysTrueInstanceof: bool() checkAlwaysTrueStrictComparison: bool() checkAlwaysTrueLooseComparison: bool() reportAlwaysTrueInLastCondition: bool() checkClassCaseSensitivity: bool() checkExplicitMixed: bool() checkImplicitMixed: bool() checkFunctionArgumentTypes: bool() checkFunctionNameCase: bool() checkGenericClassInNonGenericObjectType: bool() checkInternalClassCaseSensitivity: bool() checkMissingIterableValueType: bool() checkMissingCallableSignature: bool() checkMissingVarTagTypehint: bool() checkArgumentsPassedByReference: bool() checkMaybeUndefinedVariables: bool() checkNullables: bool() checkThisOnly: bool() checkUnionTypes: bool() checkBenevolentUnionTypes: bool() checkExplicitMixedMissingReturn: bool() checkPhpDocMissingReturn: bool() checkPhpDocMethodSignatures: bool() checkExtraArguments: bool() checkMissingTypehints: bool() checkTooWideReturnTypesInProtectedAndPublicMethods: bool() checkUninitializedProperties: bool() checkDynamicProperties: bool() deprecationRulesInstalled: bool() inferPrivatePropertyTypeFromConstructor: bool() tips: structure({treatPhpDocTypesAsCertain: bool()}) tipsOfTheDay: bool() reportMaybes: bool() reportMaybesInMethodSignatures: bool() reportMaybesInPropertyPhpDocTypes: bool() reportStaticMethodSignatures: bool() reportWrongPhpDocTypeInVarTag: bool() reportAnyTypeWideningInVarTag: bool() reportPossiblyNonexistentGeneralArrayOffset: bool() reportPossiblyNonexistentConstantArrayOffset: bool() checkMissingOverrideMethodAttribute: bool() parallel: structure({jobSize: int(), processTimeout: float(), maximumNumberOfProcesses: int(), minimumNumberOfJobsPerProcess: int(), buffer: int()}) phpVersion: schema(anyOf(schema(int(), min(70100), max(80499))), nullable()) polluteScopeWithLoopInitialAssignments: bool() polluteScopeWithAlwaysIterableForeach: bool() propertyAlwaysWrittenTags: listOf(string()) propertyAlwaysReadTags: listOf(string()) additionalConstructors: listOf(string()) treatPhpDocTypesAsCertain: bool() usePathConstantsAsConstantString: bool() rememberPossiblyImpureFunctionValues: bool() reportMagicMethods: bool() reportMagicProperties: bool() ignoreErrors: listOf(anyOf(string(), structure({?messages: listOf(string()), ?identifier: string(), ?path: string(), ?reportUnmatched: bool()}), structure({?message: string(), ?identifier: string(), ?path: string(), ?reportUnmatched: bool()}), structure({?message: string(), count: int(), path: string(), ?identifier: string(), ?reportUnmatched: bool()}), structure({?message: string(), paths: listOf(string()), ?identifier: string(), ?reportUnmatched: bool()}), structure({?messages: listOf(string()), paths: listOf(string()), ?identifier: string(), ?reportUnmatched: bool()}))) internalErrorsCountLimit: int() cache: structure({nodesByFileCountMax: int(), nodesByStringCountMax: int()}) reportUnmatchedIgnoredErrors: bool() scopeClass: string() typeAliases: arrayOf(string()) universalObjectCratesClasses: listOf(string()) stubFiles: listOf(string()) earlyTerminatingMethodCalls: arrayOf(listOf(string())) earlyTerminatingFunctionCalls: listOf(string()) memoryLimitFile: string() tempResultCachePath: string() resultCachePath: string() resultCacheChecksProjectExtensionFilesDependencies: bool() staticReflectionClassNamePatterns: listOf(string()) dynamicConstantNames: listOf(string()) customRulesetUsed: schema(bool(), nullable()) rootDir: string() tmpDir: string() currentWorkingDirectory: string() cliArgumentsVariablesRegistered: bool() mixinExcludeClasses: listOf(string()) scanFiles: listOf(string()) scanDirectories: listOf(string()) fixerTmpDir: string() editorUrl: schema(string(), nullable()) editorUrlTitle: schema(string(), nullable()) errorFormat: schema(string(), nullable()) pro: structure({dnsServers: schema(listOf(string()), min(1)), tmpDir: string()}) env: arrayOf(string(), anyOf(int(), string())) sysGetTempDir: string() sourceLocatorPlaygroundMode: bool() debugMode: bool() productionMode: bool() tempDir: string() __validate: bool() additionalConfigFiles: arrayOf(string()) generateBaselineFile: schema(string(), nullable()) analysedPaths: listOf(string()) allConfigFiles: listOf(string()) composerAutoloaderProjectPaths: listOf(string()) analysedPathsFromConfig: listOf(string()) usedLevel: string() cliAutoloadFile: schema(string(), nullable()) includes: - config.level3.neon rules: - PHPStan\Rules\Arrays\DeadForeachRule - PHPStan\Rules\DeadCode\UnreachableStatementRule - PHPStan\Rules\DeadCode\UnusedPrivateConstantRule - PHPStan\Rules\DeadCode\UnusedPrivateMethodRule - PHPStan\Rules\Exceptions\OverwrittenExitPointByFinallyRule - PHPStan\Rules\Functions\CallToFunctionStatementWithoutSideEffectsRule - PHPStan\Rules\Methods\CallToMethodStatementWithoutSideEffectsRule - PHPStan\Rules\Methods\CallToStaticMethodStatementWithoutSideEffectsRule - PHPStan\Rules\Methods\NullsafeMethodCallRule - PHPStan\Rules\TooWideTypehints\TooWideArrowFunctionReturnTypehintRule - PHPStan\Rules\TooWideTypehints\TooWideClosureReturnTypehintRule - PHPStan\Rules\TooWideTypehints\TooWideFunctionReturnTypehintRule conditionalTags: PHPStan\Rules\Comparison\ConstantLooseComparisonRule: phpstan.rules.rule: %featureToggles.looseComparison% PHPStan\Rules\Traits\TraitDeclarationCollector: phpstan.collector: %featureToggles.notAnalysedTrait% PHPStan\Rules\Traits\TraitUseCollector: phpstan.collector: %featureToggles.notAnalysedTrait% PHPStan\Rules\Traits\NotAnalysedTraitRule: phpstan.rules.rule: %featureToggles.notAnalysedTrait% PHPStan\Rules\Comparison\LogicalXorConstantConditionRule: phpstan.rules.rule: %featureToggles.logicalXor% PHPStan\Rules\DeadCode\BetterNoopRule: phpstan.rules.rule: %featureToggles.betterNoop% PHPStan\Rules\TooWideTypehints\TooWideFunctionParameterOutTypeRule: phpstan.rules.rule: %featureToggles.paramOutType% PHPStan\Rules\TooWideTypehints\TooWideMethodParameterOutTypeRule: phpstan.rules.rule: %featureToggles.paramOutType% PHPStan\Rules\DeadCode\CallToConstructorStatementWithoutImpurePointsRule: phpstan.rules.rule: %featureToggles.pure% PHPStan\Rules\DeadCode\PossiblyPureNewCollector: phpstan.collector: %featureToggles.pure% PHPStan\Rules\DeadCode\ConstructorWithoutImpurePointsCollector: phpstan.collector: %featureToggles.pure% PHPStan\Rules\DeadCode\CallToFunctionStatementWithoutImpurePointsRule: phpstan.rules.rule: %featureToggles.pure% PHPStan\Rules\DeadCode\PossiblyPureFuncCallCollector: phpstan.collector: %featureToggles.pure% PHPStan\Rules\DeadCode\FunctionWithoutImpurePointsCollector: phpstan.collector: %featureToggles.pure% PHPStan\Rules\DeadCode\CallToMethodStatementWithoutImpurePointsRule: phpstan.rules.rule: %featureToggles.pure% PHPStan\Rules\DeadCode\PossiblyPureMethodCallCollector: phpstan.collector: %featureToggles.pure% PHPStan\Rules\DeadCode\MethodWithoutImpurePointsCollector: phpstan.collector: %featureToggles.pure% PHPStan\Rules\DeadCode\CallToStaticMethodStatementWithoutImpurePointsRule: phpstan.rules.rule: %featureToggles.pure% PHPStan\Rules\DeadCode\PossiblyPureStaticCallCollector: phpstan.collector: %featureToggles.pure% PHPStan\Rules\TooWideTypehints\TooWidePropertyTypeRule: phpstan.rules.rule: %featureToggles.tooWidePropertyType% parameters: checkAdvancedIsset: true services: - class: PHPStan\Rules\Classes\ImpossibleInstanceOfRule arguments: checkAlwaysTrueInstanceof: %checkAlwaysTrueInstanceof% treatPhpDocTypesAsCertain: %treatPhpDocTypesAsCertain% reportAlwaysTrueInLastCondition: %reportAlwaysTrueInLastCondition% treatPhpDocTypesAsCertainTip: %tips.treatPhpDocTypesAsCertain% tags: - phpstan.rules.rule - class: PHPStan\Rules\Comparison\BooleanAndConstantConditionRule arguments: treatPhpDocTypesAsCertain: %treatPhpDocTypesAsCertain% bleedingEdge: %featureToggles.bleedingEdge% reportAlwaysTrueInLastCondition: %reportAlwaysTrueInLastCondition% treatPhpDocTypesAsCertainTip: %tips.treatPhpDocTypesAsCertain% tags: - phpstan.rules.rule - class: PHPStan\Rules\Comparison\BooleanOrConstantConditionRule arguments: treatPhpDocTypesAsCertain: %treatPhpDocTypesAsCertain% bleedingEdge: %featureToggles.bleedingEdge% reportAlwaysTrueInLastCondition: %reportAlwaysTrueInLastCondition% treatPhpDocTypesAsCertainTip: %tips.treatPhpDocTypesAsCertain% tags: - phpstan.rules.rule - class: PHPStan\Rules\Comparison\BooleanNotConstantConditionRule arguments: treatPhpDocTypesAsCertain: %treatPhpDocTypesAsCertain% reportAlwaysTrueInLastCondition: %reportAlwaysTrueInLastCondition% treatPhpDocTypesAsCertainTip: %tips.treatPhpDocTypesAsCertain% tags: - phpstan.rules.rule - class: PHPStan\Rules\DeadCode\NoopRule arguments: better: %featureToggles.betterNoop% tags: - phpstan.rules.rule - class: PHPStan\Rules\DeadCode\CallToConstructorStatementWithoutImpurePointsRule - class: PHPStan\Rules\DeadCode\ConstructorWithoutImpurePointsCollector - class: PHPStan\Rules\DeadCode\PossiblyPureNewCollector - class: PHPStan\Rules\DeadCode\CallToFunctionStatementWithoutImpurePointsRule - class: PHPStan\Rules\DeadCode\FunctionWithoutImpurePointsCollector - class: PHPStan\Rules\DeadCode\PossiblyPureFuncCallCollector - class: PHPStan\Rules\DeadCode\CallToMethodStatementWithoutImpurePointsRule - class: PHPStan\Rules\DeadCode\MethodWithoutImpurePointsCollector - class: PHPStan\Rules\DeadCode\PossiblyPureMethodCallCollector - class: PHPStan\Rules\DeadCode\CallToStaticMethodStatementWithoutImpurePointsRule - class: PHPStan\Rules\DeadCode\PossiblyPureStaticCallCollector - class: PHPStan\Rules\DeadCode\UnusedPrivatePropertyRule arguments: alwaysWrittenTags: %propertyAlwaysWrittenTags% alwaysReadTags: %propertyAlwaysReadTags% checkUninitializedProperties: %checkUninitializedProperties% tags: - phpstan.rules.rule - class: PHPStan\Rules\Comparison\DoWhileLoopConstantConditionRule arguments: treatPhpDocTypesAsCertain: %treatPhpDocTypesAsCertain% treatPhpDocTypesAsCertainTip: %tips.treatPhpDocTypesAsCertain% tags: - phpstan.rules.rule - class: PHPStan\Rules\Comparison\ElseIfConstantConditionRule arguments: treatPhpDocTypesAsCertain: %treatPhpDocTypesAsCertain% reportAlwaysTrueInLastCondition: %reportAlwaysTrueInLastCondition% treatPhpDocTypesAsCertainTip: %tips.treatPhpDocTypesAsCertain% tags: - phpstan.rules.rule - class: PHPStan\Rules\Comparison\IfConstantConditionRule arguments: treatPhpDocTypesAsCertain: %treatPhpDocTypesAsCertain% treatPhpDocTypesAsCertainTip: %tips.treatPhpDocTypesAsCertain% tags: - phpstan.rules.rule - class: PHPStan\Rules\Comparison\ImpossibleCheckTypeFunctionCallRule arguments: checkAlwaysTrueCheckTypeFunctionCall: %checkAlwaysTrueCheckTypeFunctionCall% treatPhpDocTypesAsCertain: %treatPhpDocTypesAsCertain% reportAlwaysTrueInLastCondition: %reportAlwaysTrueInLastCondition% treatPhpDocTypesAsCertainTip: %tips.treatPhpDocTypesAsCertain% tags: - phpstan.rules.rule - class: PHPStan\Rules\Comparison\ImpossibleCheckTypeMethodCallRule arguments: checkAlwaysTrueCheckTypeFunctionCall: %checkAlwaysTrueCheckTypeFunctionCall% treatPhpDocTypesAsCertain: %treatPhpDocTypesAsCertain% reportAlwaysTrueInLastCondition: %reportAlwaysTrueInLastCondition% treatPhpDocTypesAsCertainTip: %tips.treatPhpDocTypesAsCertain% tags: - phpstan.rules.rule - class: PHPStan\Rules\Comparison\ImpossibleCheckTypeStaticMethodCallRule arguments: checkAlwaysTrueCheckTypeFunctionCall: %checkAlwaysTrueCheckTypeFunctionCall% treatPhpDocTypesAsCertain: %treatPhpDocTypesAsCertain% reportAlwaysTrueInLastCondition: %reportAlwaysTrueInLastCondition% treatPhpDocTypesAsCertainTip: %tips.treatPhpDocTypesAsCertain% tags: - phpstan.rules.rule - class: PHPStan\Rules\Comparison\LogicalXorConstantConditionRule arguments: treatPhpDocTypesAsCertain: %treatPhpDocTypesAsCertain% reportAlwaysTrueInLastCondition: %reportAlwaysTrueInLastCondition% treatPhpDocTypesAsCertainTip: %tips.treatPhpDocTypesAsCertain% - class: PHPStan\Rules\DeadCode\BetterNoopRule - class: PHPStan\Rules\Comparison\MatchExpressionRule arguments: checkAlwaysTrueStrictComparison: %checkAlwaysTrueStrictComparison% disableUnreachable: %featureToggles.disableUnreachableBranchesRules% reportAlwaysTrueInLastCondition: %reportAlwaysTrueInLastCondition% treatPhpDocTypesAsCertain: %treatPhpDocTypesAsCertain% tags: - phpstan.rules.rule - class: PHPStan\Rules\Comparison\NumberComparisonOperatorsConstantConditionRule arguments: treatPhpDocTypesAsCertain: %treatPhpDocTypesAsCertain% treatPhpDocTypesAsCertainTip: %tips.treatPhpDocTypesAsCertain% tags: - phpstan.rules.rule - class: PHPStan\Rules\Comparison\StrictComparisonOfDifferentTypesRule arguments: checkAlwaysTrueStrictComparison: %checkAlwaysTrueStrictComparison% treatPhpDocTypesAsCertain: %treatPhpDocTypesAsCertain% reportAlwaysTrueInLastCondition: %reportAlwaysTrueInLastCondition% treatPhpDocTypesAsCertainTip: %tips.treatPhpDocTypesAsCertain% tags: - phpstan.rules.rule - class: PHPStan\Rules\Comparison\ConstantLooseComparisonRule arguments: checkAlwaysTrueLooseComparison: %checkAlwaysTrueLooseComparison% treatPhpDocTypesAsCertain: %treatPhpDocTypesAsCertain% reportAlwaysTrueInLastCondition: %reportAlwaysTrueInLastCondition% treatPhpDocTypesAsCertainTip: %tips.treatPhpDocTypesAsCertain% - class: PHPStan\Rules\Comparison\TernaryOperatorConstantConditionRule arguments: treatPhpDocTypesAsCertain: %treatPhpDocTypesAsCertain% treatPhpDocTypesAsCertainTip: %tips.treatPhpDocTypesAsCertain% tags: - phpstan.rules.rule - class: PHPStan\Rules\Comparison\UnreachableIfBranchesRule arguments: treatPhpDocTypesAsCertain: %treatPhpDocTypesAsCertain% disable: %featureToggles.disableUnreachableBranchesRules% treatPhpDocTypesAsCertainTip: %tips.treatPhpDocTypesAsCertain% tags: - phpstan.rules.rule - class: PHPStan\Rules\Comparison\UnreachableTernaryElseBranchRule arguments: treatPhpDocTypesAsCertain: %treatPhpDocTypesAsCertain% disable: %featureToggles.disableUnreachableBranchesRules% treatPhpDocTypesAsCertainTip: %tips.treatPhpDocTypesAsCertain% tags: - phpstan.rules.rule - class: PHPStan\Rules\Comparison\WhileLoopAlwaysFalseConditionRule arguments: treatPhpDocTypesAsCertain: %treatPhpDocTypesAsCertain% treatPhpDocTypesAsCertainTip: %tips.treatPhpDocTypesAsCertain% tags: - phpstan.rules.rule - class: PHPStan\Rules\Comparison\WhileLoopAlwaysTrueConditionRule arguments: treatPhpDocTypesAsCertain: %treatPhpDocTypesAsCertain% treatPhpDocTypesAsCertainTip: %tips.treatPhpDocTypesAsCertain% tags: - phpstan.rules.rule - class: PHPStan\Rules\Methods\CallToConstructorStatementWithoutSideEffectsRule arguments: reportNoConstructor: %featureToggles.pure% tags: - phpstan.rules.rule - class: PHPStan\Rules\TooWideTypehints\TooWideMethodReturnTypehintRule arguments: checkProtectedAndPublicMethods: %checkTooWideReturnTypesInProtectedAndPublicMethods% alwaysCheckFinal: %featureToggles.alwaysCheckTooWideReturnTypeFinalMethods% tags: - phpstan.rules.rule - class: PHPStan\Rules\Properties\NullsafePropertyFetchRule tags: - phpstan.rules.rule - class: PHPStan\Rules\Traits\TraitDeclarationCollector - class: PHPStan\Rules\Traits\TraitUseCollector - class: PHPStan\Rules\Traits\NotAnalysedTraitRule - class: PHPStan\Rules\Exceptions\CatchWithUnthrownExceptionRule arguments: exceptionTypeResolver: @exceptionTypeResolver reportUncheckedExceptionDeadCatch: %exceptions.reportUncheckedExceptionDeadCatch% tags: - phpstan.rules.rule - class: PHPStan\Rules\TooWideTypehints\TooWideFunctionParameterOutTypeRule - class: PHPStan\Rules\TooWideTypehints\TooWideMethodParameterOutTypeRule - class: PHPStan\Rules\TooWideTypehints\TooWidePropertyTypeRule includes: - config.level8.neon parameters: checkExplicitMixed: true includes: - config.level0.neon parameters: checkMaybeUndefinedVariables: true checkExtraArguments: true reportMagicMethods: true reportMagicProperties: true rules: - PHPStan\Rules\Classes\UnusedConstructorParametersRule - PHPStan\Rules\Constants\ConstantRule - PHPStan\Rules\Functions\UnusedClosureUsesRule - PHPStan\Rules\Variables\EmptyRule - PHPStan\Rules\Variables\IssetRule - PHPStan\Rules\Variables\NullCoalesceRule includes: - config.level2.neon conditionalTags: PHPStan\Rules\Arrays\ArrayUnpackingRule: phpstan.rules.rule: %featureToggles.arrayUnpacking% PHPStan\Rules\Properties\ReadOnlyByPhpDocPropertyAssignRefRule: phpstan.rules.rule: %featureToggles.readOnlyByPhpDoc% PHPStan\Rules\Properties\ReadOnlyByPhpDocPropertyAssignRule: phpstan.rules.rule: %featureToggles.readOnlyByPhpDoc% PHPStan\Rules\Variables\ParameterOutAssignedTypeRule: phpstan.rules.rule: %featureToggles.paramOutType% PHPStan\Rules\Variables\ParameterOutExecutionEndTypeRule: phpstan.rules.rule: %featureToggles.paramOutType% rules: - PHPStan\Rules\Arrays\ArrayDestructuringRule - PHPStan\Rules\Arrays\IterableInForeachRule - PHPStan\Rules\Arrays\OffsetAccessAssignmentRule - PHPStan\Rules\Arrays\OffsetAccessAssignOpRule - PHPStan\Rules\Arrays\OffsetAccessValueAssignmentRule - PHPStan\Rules\Arrays\UnpackIterableInArrayRule - PHPStan\Rules\Exceptions\ThrowExprTypeRule - PHPStan\Rules\Functions\ArrowFunctionReturnTypeRule - PHPStan\Rules\Functions\ClosureReturnTypeRule - PHPStan\Rules\Functions\ReturnTypeRule - PHPStan\Rules\Generators\YieldTypeRule - PHPStan\Rules\Methods\ReturnTypeRule - PHPStan\Rules\Properties\DefaultValueTypesAssignedToPropertiesRule - PHPStan\Rules\Properties\ReadOnlyPropertyAssignRule - PHPStan\Rules\Properties\ReadOnlyPropertyAssignRefRule - PHPStan\Rules\Properties\TypesAssignedToPropertiesRule - PHPStan\Rules\Variables\ThrowTypeRule - PHPStan\Rules\Variables\VariableCloningRule parameters: checkPhpDocMethodSignatures: true services: - class: PHPStan\Rules\Arrays\InvalidKeyInArrayDimFetchRule arguments: reportMaybes: %reportMaybes% tags: - phpstan.rules.rule - class: PHPStan\Rules\Arrays\InvalidKeyInArrayItemRule arguments: reportMaybes: %reportMaybes% tags: - phpstan.rules.rule - class: PHPStan\Rules\Arrays\NonexistentOffsetInArrayDimFetchRule arguments: reportMaybes: %reportMaybes% tags: - phpstan.rules.rule - class: PHPStan\Rules\Exceptions\ThrowsVoidFunctionWithExplicitThrowPointRule arguments: exceptionTypeResolver: @exceptionTypeResolver missingCheckedExceptionInThrows: %exceptions.check.missingCheckedExceptionInThrows% tags: - phpstan.rules.rule - class: PHPStan\Rules\Exceptions\ThrowsVoidMethodWithExplicitThrowPointRule arguments: exceptionTypeResolver: @exceptionTypeResolver missingCheckedExceptionInThrows: %exceptions.check.missingCheckedExceptionInThrows% tags: - phpstan.rules.rule - class: PHPStan\Rules\Generators\YieldFromTypeRule arguments: reportMaybes: %reportMaybes% tags: - phpstan.rules.rule - class: PHPStan\Rules\Generators\YieldInGeneratorRule arguments: reportMaybes: %reportMaybes% tags: - phpstan.rules.rule - class: PHPStan\Rules\Arrays\ArrayUnpackingRule - class: PHPStan\Rules\Properties\ReadOnlyByPhpDocPropertyAssignRefRule - class: PHPStan\Rules\Properties\ReadOnlyByPhpDocPropertyAssignRule - class: PHPStan\Rules\Variables\ParameterOutAssignedTypeRule - class: PHPStan\Rules\Variables\ParameterOutExecutionEndTypeRule includes: - config.level4.neon parameters: checkFunctionArgumentTypes: true checkArgumentsPassedByReference: true conditionalTags: PHPStan\Rules\Functions\ArrayFilterRule: phpstan.rules.rule: %featureToggles.arrayFilter% PHPStan\Rules\Functions\ArrayValuesRule: phpstan.rules.rule: %featureToggles.arrayValues% PHPStan\Rules\Functions\CallUserFuncRule: phpstan.rules.rule: %featureToggles.callUserFunc% PHPStan\Rules\Functions\ParameterCastableToStringRule: phpstan.rules.rule: %featureToggles.checkParameterCastableToStringFunctions% PHPStan\Rules\Functions\ImplodeParameterCastableToStringRule: phpstan.rules.rule: %featureToggles.checkParameterCastableToStringFunctions% PHPStan\Rules\Functions\SortParameterCastableToStringRule: phpstan.rules.rule: %featureToggles.checkParameterCastableToStringFunctions% rules: - PHPStan\Rules\DateTimeInstantiationRule services: - class: PHPStan\Rules\Functions\RandomIntParametersRule arguments: reportMaybes: %reportMaybes% tags: - phpstan.rules.rule - class: PHPStan\Rules\Functions\ArrayFilterRule arguments: treatPhpDocTypesAsCertain: %treatPhpDocTypesAsCertain% treatPhpDocTypesAsCertainTip: %tips.treatPhpDocTypesAsCertain% - class: PHPStan\Rules\Functions\ArrayValuesRule arguments: treatPhpDocTypesAsCertain: %treatPhpDocTypesAsCertain% treatPhpDocTypesAsCertainTip: %tips.treatPhpDocTypesAsCertain% - class: PHPStan\Rules\Functions\CallUserFuncRule - class: PHPStan\Rules\Functions\ImplodeFunctionRule arguments: disabled: %featureToggles.checkParameterCastableToStringFunctions% tags: - phpstan.rules.rule - class: PHPStan\Rules\Functions\ParameterCastableToStringRule - class: PHPStan\Rules\Functions\ImplodeParameterCastableToStringRule - class: PHPStan\Rules\Functions\SortParameterCastableToStringRule includes: - parametersSchema.neon parameters: bootstrapFiles: - ../stubs/runtime/ReflectionUnionType.php - ../stubs/runtime/ReflectionAttribute.php - ../stubs/runtime/Attribute.php - ../stubs/runtime/ReflectionIntersectionType.php excludes_analyse: [] excludePaths: null level: null paths: [] exceptions: implicitThrows: true reportUncheckedExceptionDeadCatch: true uncheckedExceptionRegexes: [] uncheckedExceptionClasses: [] checkedExceptionRegexes: [] checkedExceptionClasses: [] check: missingCheckedExceptionInThrows: false tooWideThrowType: false featureToggles: bleedingEdge: false disableRuntimeReflectionProvider: true skipCheckGenericClasses: - DatePeriod - CallbackFilterIterator - FilterIterator - RecursiveCallbackFilterIterator - AppendIterator - NoRewindIterator - LimitIterator - InfiniteIterator - CachingIterator - RegexIterator - ReflectionEnum explicitMixedInUnknownGenericNew: false explicitMixedForGlobalVariables: false explicitMixedViaIsArray: false arrayFilter: false arrayUnpacking: false arrayValues: false nodeConnectingVisitorCompatibility: true nodeConnectingVisitorRule: false illegalConstructorMethodCall: false disableCheckMissingIterableValueType: false strictUnnecessaryNullsafePropertyFetch: false looseComparison: false consistentConstructor: false checkUnresolvableParameterTypes: false readOnlyByPhpDoc: false phpDocParserRequireWhitespaceBeforeDescription: false phpDocParserIncludeLines: false enableIgnoreErrorsWithinPhpDocs: false runtimeReflectionRules: false notAnalysedTrait: false curlSetOptTypes: false listType: false abstractTraitMethod: false missingMagicSerializationRule: false nullContextForVoidReturningFunctions: false unescapeStrings: false alwaysCheckTooWideReturnTypeFinalMethods: false duplicateStubs: false logicalXor: false betterNoop: false invarianceComposition: false alwaysTrueAlwaysReported: false disableUnreachableBranchesRules: false varTagType: false closureDefaultParameterTypeRule: false newRuleLevelHelper: false instanceofType: false paramOutVariance: false allInvalidPhpDocs: false strictStaticMethodTemplateTypeVariance: false propertyVariance: false genericPrototypeMessage: false stricterFunctionMap: false invalidPhpDocTagLine: false detectDeadTypeInMultiCatch: false zeroFiles: false projectServicesNotInAnalysedPaths: false callUserFunc: false finalByPhpDoc: false magicConstantOutOfContext: false paramOutType: false pure: false checkParameterCastableToStringFunctions: false uselessReturnValue: false printfArrayParameters: false preciseMissingReturn: false validatePregQuote: false noImplicitWildcard: false requireFileExists: false narrowPregMatches: true tooWidePropertyType: false explicitThrow: false absentTypeChecks: false fileExtensions: - php checkAdvancedIsset: false checkAlwaysTrueCheckTypeFunctionCall: %featureToggles.alwaysTrueAlwaysReported% checkAlwaysTrueInstanceof: %featureToggles.alwaysTrueAlwaysReported% checkAlwaysTrueStrictComparison: %featureToggles.alwaysTrueAlwaysReported% checkAlwaysTrueLooseComparison: %featureToggles.alwaysTrueAlwaysReported% reportAlwaysTrueInLastCondition: false checkClassCaseSensitivity: false checkExplicitMixed: false checkImplicitMixed: false checkFunctionArgumentTypes: false checkFunctionNameCase: false checkGenericClassInNonGenericObjectType: false checkInternalClassCaseSensitivity: false checkMissingIterableValueType: false checkMissingCallableSignature: false checkMissingVarTagTypehint: false checkArgumentsPassedByReference: false checkMaybeUndefinedVariables: false checkNullables: false checkThisOnly: true checkUnionTypes: false checkBenevolentUnionTypes: false checkExplicitMixedMissingReturn: false checkPhpDocMissingReturn: false checkPhpDocMethodSignatures: false checkExtraArguments: false checkMissingTypehints: false checkTooWideReturnTypesInProtectedAndPublicMethods: false checkUninitializedProperties: false checkDynamicProperties: false deprecationRulesInstalled: false inferPrivatePropertyTypeFromConstructor: false reportMaybes: false reportMaybesInMethodSignatures: false reportMaybesInPropertyPhpDocTypes: false reportStaticMethodSignatures: false reportWrongPhpDocTypeInVarTag: false reportAnyTypeWideningInVarTag: false reportPossiblyNonexistentGeneralArrayOffset: false reportPossiblyNonexistentConstantArrayOffset: false checkMissingOverrideMethodAttribute: false mixinExcludeClasses: [] scanFiles: [] scanDirectories: [] parallel: jobSize: 20 processTimeout: 600.0 maximumNumberOfProcesses: 32 minimumNumberOfJobsPerProcess: 2 buffer: 134217728 phpVersion: null polluteScopeWithLoopInitialAssignments: true polluteScopeWithAlwaysIterableForeach: true propertyAlwaysWrittenTags: [] propertyAlwaysReadTags: [] fixerTmpDir: %pro.tmpDir% additionalConstructors: [] treatPhpDocTypesAsCertain: true usePathConstantsAsConstantString: false rememberPossiblyImpureFunctionValues: true tips: treatPhpDocTypesAsCertain: true tipsOfTheDay: true reportMagicMethods: false reportMagicProperties: false ignoreErrors: [] internalErrorsCountLimit: 50 cache: nodesByFileCountMax: 1024 nodesByStringCountMax: 256 reportUnmatchedIgnoredErrors: true scopeClass: PHPStan\Analyser\MutatingScope typeAliases: [] universalObjectCratesClasses: - stdClass stubFiles: - ../stubs/ReflectionAttribute.stub - ../stubs/ReflectionClass.stub - ../stubs/ReflectionClassConstant.stub - ../stubs/ReflectionFunctionAbstract.stub - ../stubs/ReflectionMethod.stub - ../stubs/ReflectionParameter.stub - ../stubs/ReflectionProperty.stub - ../stubs/iterable.stub - ../stubs/ArrayObject.stub - ../stubs/WeakReference.stub - ../stubs/ext-ds.stub - ../stubs/ImagickPixel.stub - ../stubs/PDOStatement.stub - ../stubs/date.stub - ../stubs/ibm_db2.stub - ../stubs/mysqli.stub - ../stubs/zip.stub - ../stubs/dom.stub - ../stubs/spl.stub - ../stubs/SplObjectStorage.stub - ../stubs/Exception.stub - ../stubs/arrayFunctions.stub - ../stubs/core.stub - ../stubs/typeCheckingFunctions.stub earlyTerminatingMethodCalls: [] earlyTerminatingFunctionCalls: [] memoryLimitFile: %tmpDir%/.memory_limit tempResultCachePath: %tmpDir%/resultCaches resultCachePath: %tmpDir%/resultCache.php resultCacheChecksProjectExtensionFilesDependencies: false staticReflectionClassNamePatterns: [] dynamicConstantNames: - ICONV_IMPL - LIBXML_VERSION - LIBXML_DOTTED_VERSION - Memcached::HAVE_ENCODING - Memcached::HAVE_IGBINARY - Memcached::HAVE_JSON - Memcached::HAVE_MSGPACK - Memcached::HAVE_SASL - Memcached::HAVE_SESSION - PHP_VERSION - PHP_MAJOR_VERSION - PHP_MINOR_VERSION - PHP_RELEASE_VERSION - PHP_VERSION_ID - PHP_EXTRA_VERSION - PHP_WINDOWS_VERSION_MAJOR - PHP_WINDOWS_VERSION_MINOR - PHP_WINDOWS_VERSION_BUILD - PHP_ZTS - PHP_DEBUG - PHP_MAXPATHLEN - PHP_OS - PHP_OS_FAMILY - PHP_SAPI - PHP_EOL - PHP_INT_MAX - PHP_INT_MIN - PHP_INT_SIZE - PHP_FLOAT_DIG - PHP_FLOAT_EPSILON - PHP_FLOAT_MIN - PHP_FLOAT_MAX - DEFAULT_INCLUDE_PATH - PEAR_INSTALL_DIR - PEAR_EXTENSION_DIR - PHP_EXTENSION_DIR - PHP_PREFIX - PHP_BINDIR - PHP_BINARY - PHP_MANDIR - PHP_LIBDIR - PHP_DATADIR - PHP_SYSCONFDIR - PHP_LOCALSTATEDIR - PHP_CONFIG_FILE_PATH - PHP_CONFIG_FILE_SCAN_DIR - PHP_SHLIB_SUFFIX - PHP_FD_SETSIZE - OPENSSL_VERSION_NUMBER - ZEND_DEBUG_BUILD - ZEND_THREAD_SAFE - E_ALL customRulesetUsed: null editorUrl: null editorUrlTitle: null errorFormat: null sysGetTempDir: ::sys_get_temp_dir() sourceLocatorPlaygroundMode: false pro: dnsServers: - '1.1.1.2' tmpDir: %sysGetTempDir%/phpstan-fixer __validate: true extensions: rules: PHPStan\DependencyInjection\RulesExtension conditionalTags: PHPStan\DependencyInjection\ConditionalTagsExtension parametersSchema: PHPStan\DependencyInjection\ParametersSchemaExtension validateIgnoredErrors: PHPStan\DependencyInjection\ValidateIgnoredErrorsExtension validateExcludePaths: PHPStan\DependencyInjection\ValidateExcludePathsExtension rules: - PHPStan\Rules\Debug\DebugScopeRule - PHPStan\Rules\Debug\DumpPhpDocTypeRule - PHPStan\Rules\Debug\DumpTypeRule - PHPStan\Rules\Debug\FileAssertRule conditionalTags: PHPStan\Rules\Exceptions\MissingCheckedExceptionInFunctionThrowsRule: phpstan.rules.rule: %exceptions.check.missingCheckedExceptionInThrows% PHPStan\Rules\Exceptions\MissingCheckedExceptionInMethodThrowsRule: phpstan.rules.rule: %exceptions.check.missingCheckedExceptionInThrows% PHPStan\Rules\Exceptions\TooWideFunctionThrowTypeRule: phpstan.rules.rule: %exceptions.check.tooWideThrowType% PHPStan\Rules\Exceptions\TooWideMethodThrowTypeRule: phpstan.rules.rule: %exceptions.check.tooWideThrowType% PhpParser\NodeVisitor\NodeConnectingVisitor: phpstan.parser.richParserNodeVisitor: %featureToggles.nodeConnectingVisitorCompatibility% PHPStan\Parser\CurlSetOptArgVisitor: phpstan.parser.richParserNodeVisitor: %featureToggles.curlSetOptTypes% PHPStan\Parser\TypeTraverserInstanceofVisitor: phpstan.parser.richParserNodeVisitor: %featureToggles.instanceofType% services: - class: PhpParser\BuilderFactory - class: PHPStan\Parser\LexerFactory - class: PhpParser\NodeVisitor\NameResolver arguments: options: preserveOriginalNames: true - class: PHPStan\Parser\AnonymousClassVisitor tags: - phpstan.parser.richParserNodeVisitor - class: PHPStan\Parser\ArrayFilterArgVisitor tags: - phpstan.parser.richParserNodeVisitor - class: PHPStan\Parser\ArrayFindArgVisitor tags: - phpstan.parser.richParserNodeVisitor - class: PHPStan\Parser\ArrayMapArgVisitor tags: - phpstan.parser.richParserNodeVisitor - class: PHPStan\Parser\ArrayWalkArgVisitor tags: - phpstan.parser.richParserNodeVisitor - class: PHPStan\Parser\ClosureArgVisitor tags: - phpstan.parser.richParserNodeVisitor - class: PHPStan\Parser\ClosureBindToVarVisitor tags: - phpstan.parser.richParserNodeVisitor - class: PHPStan\Parser\ClosureBindArgVisitor tags: - phpstan.parser.richParserNodeVisitor - class: PHPStan\Parser\CurlSetOptArgVisitor - class: PHPStan\Parser\TypeTraverserInstanceofVisitor - class: PHPStan\Parser\ArrowFunctionArgVisitor tags: - phpstan.parser.richParserNodeVisitor - class: PHPStan\Parser\MagicConstantParamDefaultVisitor tags: - phpstan.parser.richParserNodeVisitor - class: PHPStan\Parser\NewAssignedToPropertyVisitor tags: - phpstan.parser.richParserNodeVisitor - class: PHPStan\Parser\ParentStmtTypesVisitor tags: - phpstan.parser.richParserNodeVisitor - class: PHPStan\Parser\TryCatchTypeVisitor tags: - phpstan.parser.richParserNodeVisitor - class: PHPStan\Parser\LastConditionVisitor tags: - phpstan.parser.richParserNodeVisitor - class: PhpParser\NodeVisitor\NodeConnectingVisitor - class: PHPStan\Node\Printer\ExprPrinter - class: PHPStan\Node\Printer\Printer - class: PHPStan\Broker\AnonymousClassNameHelper arguments: relativePathHelper: @simpleRelativePathHelper - class: PHPStan\Php\PhpVersion factory: @PHPStan\Php\PhpVersionFactory::create - class: PHPStan\Php\PhpVersionFactory factory: @PHPStan\Php\PhpVersionFactoryFactory::create - class: PHPStan\Php\PhpVersionFactoryFactory arguments: versionId: %phpVersion% composerAutoloaderProjectPaths: %composerAutoloaderProjectPaths% - class: PHPStan\PhpDocParser\Lexer\Lexer - class: PHPStan\PhpDocParser\Parser\TypeParser arguments: quoteAwareConstExprString: %featureToggles.unescapeStrings% - class: PHPStan\PhpDocParser\Parser\ConstExprParser factory: @PHPStan\PhpDoc\ConstExprParserFactory::create() - class: PHPStan\PhpDocParser\Parser\PhpDocParser arguments: requireWhitespaceBeforeDescription: %featureToggles.phpDocParserRequireWhitespaceBeforeDescription% preserveTypeAliasesWithInvalidTypes: true usedAttributes: lines: %featureToggles.phpDocParserIncludeLines% - class: PHPStan\PhpDocParser\Printer\Printer - class: PHPStan\PhpDoc\ConstExprParserFactory arguments: unescapeStrings: %featureToggles.unescapeStrings% - class: PHPStan\PhpDoc\PhpDocInheritanceResolver - class: PHPStan\PhpDoc\PhpDocNodeResolver - class: PHPStan\PhpDoc\PhpDocStringResolver - class: PHPStan\PhpDoc\ConstExprNodeResolver - class: PHPStan\PhpDoc\TypeNodeResolver - class: PHPStan\PhpDoc\TypeNodeResolverExtensionRegistryProvider factory: PHPStan\PhpDoc\LazyTypeNodeResolverExtensionRegistryProvider - class: PHPStan\PhpDoc\TypeStringResolver - class: PHPStan\PhpDoc\StubValidator arguments: duplicateStubs: %featureToggles.duplicateStubs% - class: PHPStan\PhpDoc\CountableStubFilesExtension arguments: bleedingEdge: %featureToggles.bleedingEdge% tags: - phpstan.stubFilesExtension - class: PHPStan\PhpDoc\SocketSelectStubFilesExtension tags: - phpstan.stubFilesExtension - class: PHPStan\PhpDoc\DefaultStubFilesProvider arguments: stubFiles: %stubFiles% composerAutoloaderProjectPaths: %composerAutoloaderProjectPaths% autowired: - PHPStan\PhpDoc\StubFilesProvider - class: PHPStan\PhpDoc\JsonValidateStubFilesExtension tags: - phpstan.stubFilesExtension - class: PHPStan\PhpDoc\ReflectionEnumStubFilesExtension tags: - phpstan.stubFilesExtension - class: PHPStan\Analyser\Analyser arguments: internalErrorsCountLimit: %internalErrorsCountLimit% - class: PHPStan\Analyser\AnalyserResultFinalizer arguments: reportUnmatchedIgnoredErrors: %reportUnmatchedIgnoredErrors% - class: PHPStan\Analyser\FileAnalyser arguments: parser: @defaultAnalysisParser - class: PHPStan\Analyser\LocalIgnoresProcessor - class: PHPStan\Analyser\RuleErrorTransformer - class: PHPStan\Analyser\Ignore\IgnoredErrorHelper arguments: ignoreErrors: %ignoreErrors% reportUnmatchedIgnoredErrors: %reportUnmatchedIgnoredErrors% - class: PHPStan\Analyser\Ignore\IgnoreLexer - class: PHPStan\Analyser\LazyInternalScopeFactory arguments: scopeClass: %scopeClass% autowired: - PHPStan\Analyser\InternalScopeFactory - class: PHPStan\Analyser\ScopeFactory - class: PHPStan\Analyser\NodeScopeResolver arguments: parser: @defaultAnalysisParser reflector: @nodeScopeResolverReflector polluteScopeWithLoopInitialAssignments: %polluteScopeWithLoopInitialAssignments% polluteScopeWithAlwaysIterableForeach: %polluteScopeWithAlwaysIterableForeach% earlyTerminatingMethodCalls: %earlyTerminatingMethodCalls% earlyTerminatingFunctionCalls: %earlyTerminatingFunctionCalls% implicitThrows: %exceptions.implicitThrows% treatPhpDocTypesAsCertain: %treatPhpDocTypesAsCertain% detectDeadTypeInMultiCatch: %featureToggles.detectDeadTypeInMultiCatch% universalObjectCratesClasses: %universalObjectCratesClasses% paramOutType: %featureToggles.paramOutType% preciseMissingReturn: %featureToggles.preciseMissingReturn% explicitThrow: %featureToggles.explicitThrow% - class: PHPStan\Analyser\ConstantResolver factory: @PHPStan\Analyser\ConstantResolverFactory::create() - class: PHPStan\Analyser\ConstantResolverFactory - implement: PHPStan\Analyser\ResultCache\ResultCacheManagerFactory arguments: scanFileFinder: @fileFinderScan cacheFilePath: %resultCachePath% analysedPaths: %analysedPaths% composerAutoloaderProjectPaths: %composerAutoloaderProjectPaths% usedLevel: %usedLevel% cliAutoloadFile: %cliAutoloadFile% bootstrapFiles: %bootstrapFiles% scanFiles: %scanFiles% scanDirectories: %scanDirectories% checkDependenciesOfProjectExtensionFiles: %resultCacheChecksProjectExtensionFilesDependencies% - class: PHPStan\Analyser\ResultCache\ResultCacheClearer arguments: cacheFilePath: %resultCachePath% - class: PHPStan\Analyser\RicherScopeGetTypeHelper - class: PHPStan\Cache\Cache arguments: storage: @cacheStorage - class: PHPStan\Collectors\Registry factory: @PHPStan\Collectors\RegistryFactory::create - class: PHPStan\Collectors\RegistryFactory - class: PHPStan\Command\AnalyseApplication - class: PHPStan\Command\AnalyserRunner - class: PHPStan\Command\FixerApplication arguments: analysedPaths: %analysedPaths% currentWorkingDirectory: %currentWorkingDirectory% proTmpDir: %pro.tmpDir% dnsServers: %pro.dnsServers% composerAutoloaderProjectPaths: %composerAutoloaderProjectPaths% allConfigFiles: %allConfigFiles% cliAutoloadFile: %cliAutoloadFile% bootstrapFiles: %bootstrapFiles% editorUrl: %editorUrl% usedLevel: %usedLevel% - class: PHPStan\Dependency\DependencyResolver - class: PHPStan\Dependency\ExportedNodeFetcher arguments: parser: @defaultAnalysisParser - class: PHPStan\Dependency\ExportedNodeResolver - class: PHPStan\Dependency\ExportedNodeVisitor - class: PHPStan\DependencyInjection\Container factory: PHPStan\DependencyInjection\MemoizingContainer arguments: originalContainer: @PHPStan\DependencyInjection\Nette\NetteContainer - class: PHPStan\DependencyInjection\Nette\NetteContainer autowired: - PHPStan\DependencyInjection\Nette\NetteContainer - class: PHPStan\DependencyInjection\DerivativeContainerFactory arguments: currentWorkingDirectory: %currentWorkingDirectory% tempDirectory: %tempDir% additionalConfigFiles: %additionalConfigFiles% analysedPaths: %analysedPaths% composerAutoloaderProjectPaths: %composerAutoloaderProjectPaths% analysedPathsFromConfig: %analysedPathsFromConfig% usedLevel: %usedLevel% generateBaselineFile: %generateBaselineFile% cliAutoloadFile: %cliAutoloadFile% - class: PHPStan\DependencyInjection\Reflection\ClassReflectionExtensionRegistryProvider factory: PHPStan\DependencyInjection\Reflection\LazyClassReflectionExtensionRegistryProvider - class: PHPStan\DependencyInjection\Type\DynamicReturnTypeExtensionRegistryProvider factory: PHPStan\DependencyInjection\Type\LazyDynamicReturnTypeExtensionRegistryProvider - class: PHPStan\DependencyInjection\Type\ParameterOutTypeExtensionProvider factory: PHPStan\DependencyInjection\Type\LazyParameterOutTypeExtensionProvider - class: PHPStan\DependencyInjection\Type\ExpressionTypeResolverExtensionRegistryProvider factory: PHPStan\DependencyInjection\Type\LazyExpressionTypeResolverExtensionRegistryProvider - class: PHPStan\DependencyInjection\Type\OperatorTypeSpecifyingExtensionRegistryProvider factory: PHPStan\DependencyInjection\Type\LazyOperatorTypeSpecifyingExtensionRegistryProvider - class: PHPStan\DependencyInjection\Type\DynamicThrowTypeExtensionProvider factory: PHPStan\DependencyInjection\Type\LazyDynamicThrowTypeExtensionProvider - class: PHPStan\DependencyInjection\Type\ParameterClosureTypeExtensionProvider factory: PHPStan\DependencyInjection\Type\LazyParameterClosureTypeExtensionProvider - class: PHPStan\File\FileHelper arguments: workingDirectory: %currentWorkingDirectory% - class: PHPStan\File\FileExcluderFactory arguments: obsoleteExcludesAnalyse: %excludes_analyse% excludePaths: %excludePaths% - implement: PHPStan\File\FileExcluderRawFactory arguments: noImplicitWildcard: %featureToggles.noImplicitWildcard% fileExcluderAnalyse: class: PHPStan\File\FileExcluder factory: @PHPStan\File\FileExcluderFactory::createAnalyseFileExcluder() autowired: false fileExcluderScan: class: PHPStan\File\FileExcluder factory: @PHPStan\File\FileExcluderFactory::createScanFileExcluder() autowired: false fileFinderAnalyse: class: PHPStan\File\FileFinder arguments: fileExcluder: @fileExcluderAnalyse fileExtensions: %fileExtensions% autowired: false fileFinderScan: class: PHPStan\File\FileFinder arguments: fileExcluder: @fileExcluderScan fileExtensions: %fileExtensions% autowired: false - class: PHPStan\File\FileMonitor arguments: fileFinder: @fileFinderAnalyse - class: PHPStan\Parser\DeclarePositionVisitor tags: - phpstan.parser.richParserNodeVisitor - class: PHPStan\Parser\ImmediatelyInvokedClosureVisitor tags: - phpstan.parser.richParserNodeVisitor - class: PHPStan\Parallel\ParallelAnalyser arguments: internalErrorsCountLimit: %internalErrorsCountLimit% processTimeout: %parallel.processTimeout% decoderBufferSize: %parallel.buffer% - class: PHPStan\Parallel\Scheduler arguments: jobSize: %parallel.jobSize% maximumNumberOfProcesses: %parallel.maximumNumberOfProcesses% minimumNumberOfJobsPerProcess: %parallel.minimumNumberOfJobsPerProcess% tags: - phpstan.diagnoseExtension - class: PHPStan\Parser\FunctionCallStatementFinder - class: PHPStan\Process\CpuCoreCounter - implement: PHPStan\Reflection\FunctionReflectionFactory arguments: parser: @defaultAnalysisParser - class: PHPStan\Reflection\InitializerExprTypeResolver arguments: usePathConstantsAsConstantString: %usePathConstantsAsConstantString% - class: PHPStan\Reflection\Annotations\AnnotationsMethodsClassReflectionExtension - class: PHPStan\Reflection\Annotations\AnnotationsPropertiesClassReflectionExtension - class: PHPStan\Reflection\BetterReflection\SourceLocator\CachingVisitor - class: PHPStan\Reflection\BetterReflection\SourceLocator\FileNodesFetcher arguments: parser: @defaultAnalysisParser - class: PHPStan\Reflection\BetterReflection\SourceLocator\ComposerJsonAndInstalledJsonSourceLocatorMaker - class: PHPStan\Reflection\BetterReflection\SourceLocator\OptimizedDirectorySourceLocatorFactory arguments: fileFinder: @fileFinderScan - class: PHPStan\Reflection\BetterReflection\SourceLocator\OptimizedDirectorySourceLocatorRepository - implement: PHPStan\Reflection\BetterReflection\SourceLocator\OptimizedPsrAutoloaderLocatorFactory - implement: PHPStan\Reflection\BetterReflection\SourceLocator\OptimizedSingleFileSourceLocatorFactory - class: PHPStan\Reflection\BetterReflection\SourceLocator\OptimizedSingleFileSourceLocatorRepository - class: PHPStan\Reflection\RequireExtension\RequireExtendsMethodsClassReflectionExtension - class: PHPStan\Reflection\RequireExtension\RequireExtendsPropertiesClassReflectionExtension - class: PHPStan\Reflection\Mixin\MixinMethodsClassReflectionExtension arguments: mixinExcludeClasses: %mixinExcludeClasses% - class: PHPStan\Reflection\Mixin\MixinPropertiesClassReflectionExtension arguments: mixinExcludeClasses: %mixinExcludeClasses% - class: PHPStan\Reflection\Php\PhpClassReflectionExtension arguments: parser: @defaultAnalysisParser inferPrivatePropertyTypeFromConstructor: %inferPrivatePropertyTypeFromConstructor% - implement: PHPStan\Reflection\Php\PhpMethodReflectionFactory arguments: parser: @defaultAnalysisParser - class: PHPStan\Reflection\Php\Soap\SoapClientMethodsClassReflectionExtension tags: - phpstan.broker.methodsClassReflectionExtension - class: PHPStan\Reflection\Php\EnumAllowedSubTypesClassReflectionExtension tags: - phpstan.broker.allowedSubTypesClassReflectionExtension - class: PHPStan\Reflection\Php\UniversalObjectCratesClassReflectionExtension tags: - phpstan.broker.propertiesClassReflectionExtension arguments: classes: %universalObjectCratesClasses% - class: PHPStan\Reflection\PHPStan\NativeReflectionEnumReturnDynamicReturnTypeExtension tags: - phpstan.broker.dynamicMethodReturnTypeExtension arguments: className: PHPStan\Reflection\ClassReflection methodName: getNativeReflection - class: PHPStan\Reflection\PHPStan\NativeReflectionEnumReturnDynamicReturnTypeExtension tags: - phpstan.broker.dynamicMethodReturnTypeExtension arguments: className: PHPStan\Reflection\Php\BuiltinMethodReflection methodName: getDeclaringClass - class: PHPStan\Reflection\ReflectionProvider\ReflectionProviderProvider factory: PHPStan\Reflection\ReflectionProvider\LazyReflectionProviderProvider - class: PHPStan\Reflection\SignatureMap\NativeFunctionReflectionProvider arguments: reflector: @betterReflectionReflector - class: PHPStan\Reflection\SignatureMap\SignatureMapParser - class: PHPStan\Reflection\SignatureMap\FunctionSignatureMapProvider arguments: stricterFunctionMap: %featureToggles.stricterFunctionMap% autowired: - PHPStan\Reflection\SignatureMap\FunctionSignatureMapProvider - class: PHPStan\Reflection\SignatureMap\Php8SignatureMapProvider autowired: - PHPStan\Reflection\SignatureMap\Php8SignatureMapProvider - class: PHPStan\Reflection\SignatureMap\SignatureMapProviderFactory - class: PHPStan\Reflection\SignatureMap\SignatureMapProvider factory: @PHPStan\Reflection\SignatureMap\SignatureMapProviderFactory::create() - class: PHPStan\Rules\Api\ApiRuleHelper - class: PHPStan\Rules\AttributesCheck arguments: deprecationRulesInstalled: %deprecationRulesInstalled% - class: PHPStan\Rules\Arrays\NonexistentOffsetInArrayDimFetchCheck arguments: reportMaybes: %reportMaybes% bleedingEdge: %featureToggles.bleedingEdge% reportPossiblyNonexistentGeneralArrayOffset: %reportPossiblyNonexistentGeneralArrayOffset% reportPossiblyNonexistentConstantArrayOffset: %reportPossiblyNonexistentConstantArrayOffset% - class: PHPStan\Rules\ClassNameCheck - class: PHPStan\Rules\ClassCaseSensitivityCheck arguments: checkInternalClassCaseSensitivity: %checkInternalClassCaseSensitivity% - class: PHPStan\Rules\ClassForbiddenNameCheck - class: PHPStan\Rules\Classes\LocalTypeAliasesCheck arguments: globalTypeAliases: %typeAliases% checkMissingTypehints: %checkMissingTypehints% checkClassCaseSensitivity: %checkClassCaseSensitivity% absentTypeChecks: %featureToggles.absentTypeChecks% - class: PHPStan\Rules\Classes\MethodTagCheck arguments: checkClassCaseSensitivity: %checkClassCaseSensitivity% checkMissingTypehints: %checkMissingTypehints% - class: PHPStan\Rules\Classes\MixinCheck arguments: checkClassCaseSensitivity: %checkClassCaseSensitivity% absentTypeChecks: %featureToggles.absentTypeChecks% checkMissingTypehints: %checkMissingTypehints% - class: PHPStan\Rules\Classes\PropertyTagCheck arguments: checkClassCaseSensitivity: %checkClassCaseSensitivity% checkMissingTypehints: %checkMissingTypehints% - class: PHPStan\Rules\Comparison\ConstantConditionRuleHelper arguments: treatPhpDocTypesAsCertain: %treatPhpDocTypesAsCertain% looseComparisonRuleEnabled: %featureToggles.looseComparison% - class: PHPStan\Rules\Comparison\ImpossibleCheckTypeHelper arguments: universalObjectCratesClasses: %universalObjectCratesClasses% treatPhpDocTypesAsCertain: %treatPhpDocTypesAsCertain% nullContextForVoidReturningFunctions: %featureToggles.nullContextForVoidReturningFunctions% - class: PHPStan\Rules\Exceptions\DefaultExceptionTypeResolver arguments: uncheckedExceptionRegexes: %exceptions.uncheckedExceptionRegexes% uncheckedExceptionClasses: %exceptions.uncheckedExceptionClasses% checkedExceptionRegexes: %exceptions.checkedExceptionRegexes% checkedExceptionClasses: %exceptions.checkedExceptionClasses% autowired: - PHPStan\Rules\Exceptions\DefaultExceptionTypeResolver - class: PHPStan\Rules\Exceptions\MissingCheckedExceptionInFunctionThrowsRule - class: PHPStan\Rules\Exceptions\MissingCheckedExceptionInMethodThrowsRule - class: PHPStan\Rules\Exceptions\MissingCheckedExceptionInThrowsCheck arguments: exceptionTypeResolver: @exceptionTypeResolver - class: PHPStan\Rules\Exceptions\TooWideFunctionThrowTypeRule - class: PHPStan\Rules\Exceptions\TooWideMethodThrowTypeRule - class: PHPStan\Rules\Exceptions\TooWideThrowTypeCheck - class: PHPStan\Rules\FunctionCallParametersCheck arguments: checkArgumentTypes: %checkFunctionArgumentTypes% checkArgumentsPassedByReference: %checkArgumentsPassedByReference% checkExtraArguments: %checkExtraArguments% checkMissingTypehints: %checkMissingTypehints% checkUnresolvableParameterTypes: %featureToggles.checkUnresolvableParameterTypes% - class: PHPStan\Rules\FunctionDefinitionCheck arguments: checkClassCaseSensitivity: %checkClassCaseSensitivity% checkThisOnly: %checkThisOnly% absentTypeChecks: %featureToggles.absentTypeChecks% - class: PHPStan\Rules\FunctionReturnTypeCheck - class: PHPStan\Rules\ParameterCastableToStringCheck - class: PHPStan\Rules\Generics\CrossCheckInterfacesHelper - class: PHPStan\Rules\Generics\GenericAncestorsCheck arguments: checkGenericClassInNonGenericObjectType: %checkGenericClassInNonGenericObjectType% skipCheckGenericClasses: %featureToggles.skipCheckGenericClasses% absentTypeChecks: %featureToggles.absentTypeChecks% - class: PHPStan\Rules\Generics\GenericObjectTypeCheck - class: PHPStan\Rules\Generics\MethodTagTemplateTypeCheck - class: PHPStan\Rules\Generics\TemplateTypeCheck arguments: checkClassCaseSensitivity: %checkClassCaseSensitivity% - class: PHPStan\Rules\Generics\VarianceCheck arguments: checkParamOutVariance: %featureToggles.paramOutVariance% strictStaticVariance: %featureToggles.strictStaticMethodTemplateTypeVariance% - class: PHPStan\Rules\IssetCheck arguments: checkAdvancedIsset: %checkAdvancedIsset% treatPhpDocTypesAsCertain: %treatPhpDocTypesAsCertain% strictUnnecessaryNullsafePropertyFetch: %featureToggles.strictUnnecessaryNullsafePropertyFetch% - class: PHPStan\Rules\Methods\MethodCallCheck arguments: checkFunctionNameCase: %checkFunctionNameCase% reportMagicMethods: %reportMagicMethods% - class: PHPStan\Rules\Methods\StaticMethodCallCheck arguments: checkFunctionNameCase: %checkFunctionNameCase% reportMagicMethods: %reportMagicMethods% - class: PHPStan\Rules\Methods\MethodSignatureRule arguments: reportMaybes: %reportMaybesInMethodSignatures% reportStatic: %reportStaticMethodSignatures% abstractTraitMethod: %featureToggles.abstractTraitMethod% - class: PHPStan\Rules\Methods\MethodParameterComparisonHelper arguments: genericPrototypeMessage: %featureToggles.genericPrototypeMessage% - class: PHPStan\Rules\MissingTypehintCheck arguments: checkMissingIterableValueType: %checkMissingIterableValueType% disableCheckMissingIterableValueType: %featureToggles.disableCheckMissingIterableValueType% checkGenericClassInNonGenericObjectType: %checkGenericClassInNonGenericObjectType% checkMissingCallableSignature: %checkMissingCallableSignature% skipCheckGenericClasses: %featureToggles.skipCheckGenericClasses% - class: PHPStan\Rules\NullsafeCheck - class: PHPStan\Rules\Constants\LazyAlwaysUsedClassConstantsExtensionProvider - class: PHPStan\Rules\Methods\LazyAlwaysUsedMethodExtensionProvider - class: PHPStan\Rules\PhpDoc\ConditionalReturnTypeRuleHelper - class: PHPStan\Rules\PhpDoc\AssertRuleHelper arguments: checkMissingTypehints: %checkMissingTypehints% checkClassCaseSensitivity: %checkClassCaseSensitivity% absentTypeChecks: %featureToggles.absentTypeChecks% - class: PHPStan\Rules\PhpDoc\UnresolvableTypeHelper - class: PHPStan\Rules\PhpDoc\GenericCallableRuleHelper - class: PHPStan\Rules\PhpDoc\VarTagTypeRuleHelper arguments: checkTypeAgainstPhpDocType: %reportWrongPhpDocTypeInVarTag% strictWideningCheck: %reportAnyTypeWideningInVarTag% - class: PHPStan\Rules\Playground\NeverRuleHelper - class: PHPStan\Rules\Properties\LazyReadWritePropertiesExtensionProvider - class: PHPStan\Rules\Properties\PropertyDescriptor - class: PHPStan\Rules\Properties\PropertyReflectionFinder - class: PHPStan\Rules\Pure\FunctionPurityCheck - class: PHPStan\Rules\RuleLevelHelper arguments: checkNullables: %checkNullables% checkThisOnly: %checkThisOnly% checkUnionTypes: %checkUnionTypes% checkExplicitMixed: %checkExplicitMixed% checkImplicitMixed: %checkImplicitMixed% newRuleLevelHelper: %featureToggles.newRuleLevelHelper% checkBenevolentUnionTypes: %checkBenevolentUnionTypes% - class: PHPStan\Rules\UnusedFunctionParametersCheck - class: PHPStan\Rules\TooWideTypehints\TooWideParameterOutTypeCheck - class: PHPStan\Type\FileTypeMapper arguments: phpParser: @defaultAnalysisParser - class: PHPStan\Type\TypeAliasResolver factory: PHPStan\Type\UsefulTypeAliasResolver arguments: globalTypeAliases: %typeAliases% - class: PHPStan\Type\TypeAliasResolverProvider factory: PHPStan\Type\LazyTypeAliasResolverProvider - class: PHPStan\Type\BitwiseFlagHelper - class: PHPStan\Type\Php\AbsFunctionDynamicReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\ArgumentBasedFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\ArrayChangeKeyCaseFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\ArrayIntersectKeyFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\ArrayChunkFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\ArrayColumnFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\ArrayCombineFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\ArrayCurrentDynamicReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\ArrayFillFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\ArrayFillKeysFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\ArrayFilterFunctionReturnTypeHelper - class: PHPStan\Type\Php\ArrayFilterFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\ArrayFlipFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\ArrayFindFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\ArrayFindKeyFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\ArrayKeyDynamicReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\ArrayKeyExistsFunctionTypeSpecifyingExtension tags: - phpstan.typeSpecifier.functionTypeSpecifyingExtension - class: PHPStan\Type\Php\ArrayKeyFirstDynamicReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\ArrayKeyLastDynamicReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\ArrayKeysFunctionDynamicReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\ArrayMapFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\ArrayMergeFunctionDynamicReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\ArrayNextDynamicReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\ArrayPopFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\ArrayRandFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\ArrayReduceFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\ArrayReplaceFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\ArrayReverseFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\ArrayShiftFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\ArraySliceFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\ArraySpliceFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\ArraySearchFunctionDynamicReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\ArraySearchFunctionTypeSpecifyingExtension tags: - phpstan.typeSpecifier.functionTypeSpecifyingExtension - class: PHPStan\Type\Php\ArrayValuesFunctionDynamicReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\ArraySumFunctionDynamicReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\AssertThrowTypeExtension tags: - phpstan.dynamicFunctionThrowTypeExtension - class: PHPStan\Type\Php\BackedEnumFromMethodDynamicReturnTypeExtension tags: - phpstan.broker.dynamicStaticMethodReturnTypeExtension - class: PHPStan\Type\Php\Base64DecodeDynamicFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\BcMathStringOrNullReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\ClosureBindDynamicReturnTypeExtension tags: - phpstan.broker.dynamicStaticMethodReturnTypeExtension - class: PHPStan\Type\Php\ClosureBindToDynamicReturnTypeExtension tags: - phpstan.broker.dynamicMethodReturnTypeExtension - class: PHPStan\Type\Php\ClosureFromCallableDynamicReturnTypeExtension tags: - phpstan.broker.dynamicStaticMethodReturnTypeExtension - class: PHPStan\Type\Php\CompactFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension arguments: checkMaybeUndefinedVariables: %checkMaybeUndefinedVariables% - class: PHPStan\Type\Php\ConstantFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\ConstantHelper - class: PHPStan\Type\Php\CountFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\CountFunctionTypeSpecifyingExtension tags: - phpstan.typeSpecifier.functionTypeSpecifyingExtension - class: PHPStan\Type\Php\CurlGetinfoFunctionDynamicReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\DateFunctionReturnTypeHelper - class: PHPStan\Type\Php\DateFormatFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\DateFormatMethodReturnTypeExtension tags: - phpstan.broker.dynamicMethodReturnTypeExtension - class: PHPStan\Type\Php\DateFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\DateIntervalConstructorThrowTypeExtension tags: - phpstan.dynamicStaticMethodThrowTypeExtension - class: PHPStan\Type\Php\DateIntervalDynamicReturnTypeExtension tags: - phpstan.broker.dynamicStaticMethodReturnTypeExtension - class: PHPStan\Type\Php\DateTimeCreateDynamicReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\DateTimeDynamicReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\DateTimeModifyReturnTypeExtension tags: - phpstan.broker.dynamicMethodReturnTypeExtension arguments: dateTimeClass: DateTime - class: PHPStan\Type\Php\DateTimeModifyReturnTypeExtension tags: - phpstan.broker.dynamicMethodReturnTypeExtension arguments: dateTimeClass: DateTimeImmutable - class: PHPStan\Type\Php\DateTimeConstructorThrowTypeExtension tags: - phpstan.dynamicStaticMethodThrowTypeExtension - class: PHPStan\Type\Php\DateTimeModifyMethodThrowTypeExtension tags: - phpstan.dynamicMethodThrowTypeExtension - class: PHPStan\Type\Php\DateTimeSubMethodThrowTypeExtension tags: - phpstan.dynamicMethodThrowTypeExtension - class: PHPStan\Type\Php\DateTimeZoneConstructorThrowTypeExtension tags: - phpstan.dynamicStaticMethodThrowTypeExtension - class: PHPStan\Type\Php\DsMapDynamicReturnTypeExtension tags: - phpstan.broker.dynamicMethodReturnTypeExtension - class: PHPStan\Type\Php\DsMapDynamicMethodThrowTypeExtension tags: - phpstan.dynamicMethodThrowTypeExtension - class: PHPStan\Type\Php\DioStatDynamicFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\ExplodeFunctionDynamicReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\FilterFunctionReturnTypeHelper - class: PHPStan\Type\Php\FilterInputDynamicReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\FilterVarDynamicReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\FilterVarArrayDynamicReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\GetCalledClassDynamicReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\GetClassDynamicReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\GetDebugTypeFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\GetDefinedVarsFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\GetParentClassDynamicFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\GettypeFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\GettimeofdayDynamicFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\HashFunctionsReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\HighlightStringDynamicReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\IntdivThrowTypeExtension tags: - phpstan.dynamicFunctionThrowTypeExtension - class: PHPStan\Type\Php\IniGetReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\JsonThrowTypeExtension tags: - phpstan.dynamicFunctionThrowTypeExtension - class: PHPStan\Type\Php\OpenSslEncryptParameterOutTypeExtension tags: - phpstan.functionParameterOutTypeExtension - class: PHPStan\Type\Php\ParseStrParameterOutTypeExtension tags: - phpstan.functionParameterOutTypeExtension - class: PHPStan\Type\Php\PregMatchTypeSpecifyingExtension tags: - phpstan.typeSpecifier.functionTypeSpecifyingExtension - class: PHPStan\Type\Php\PregMatchParameterOutTypeExtension tags: - phpstan.functionParameterOutTypeExtension - class: PHPStan\Type\Php\PregReplaceCallbackClosureTypeExtension tags: - phpstan.functionParameterClosureTypeExtension - class: PHPStan\Type\Php\RegexArrayShapeMatcher - class: PHPStan\Type\Regex\RegexGroupParser - class: PHPStan\Type\Regex\RegexExpressionHelper - class: PHPStan\Type\Php\ReflectionClassConstructorThrowTypeExtension tags: - phpstan.dynamicStaticMethodThrowTypeExtension - class: PHPStan\Type\Php\ReflectionFunctionConstructorThrowTypeExtension tags: - phpstan.dynamicStaticMethodThrowTypeExtension - class: PHPStan\Type\Php\ReflectionMethodConstructorThrowTypeExtension tags: - phpstan.dynamicStaticMethodThrowTypeExtension - class: PHPStan\Type\Php\ReflectionPropertyConstructorThrowTypeExtension tags: - phpstan.dynamicStaticMethodThrowTypeExtension - class: PHPStan\Type\Php\StrContainingTypeSpecifyingExtension tags: - phpstan.typeSpecifier.functionTypeSpecifyingExtension - class: PHPStan\Type\Php\SimpleXMLElementClassPropertyReflectionExtension tags: - phpstan.broker.propertiesClassReflectionExtension - class: PHPStan\Type\Php\SimpleXMLElementConstructorThrowTypeExtension tags: - phpstan.dynamicStaticMethodThrowTypeExtension - class: PHPStan\Type\Php\StatDynamicReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - phpstan.broker.dynamicMethodReturnTypeExtension - class: PHPStan\Type\Php\MethodExistsTypeSpecifyingExtension tags: - phpstan.typeSpecifier.functionTypeSpecifyingExtension - class: PHPStan\Type\Php\PropertyExistsTypeSpecifyingExtension tags: - phpstan.typeSpecifier.functionTypeSpecifyingExtension - class: PHPStan\Type\Php\MinMaxFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\NumberFormatFunctionDynamicReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\PathinfoFunctionDynamicReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\PregFilterFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\PregSplitDynamicReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\ReflectionClassIsSubclassOfTypeSpecifyingExtension tags: - phpstan.typeSpecifier.methodTypeSpecifyingExtension - class: PHPStan\Type\Php\ReplaceFunctionsDynamicReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\ArrayPointerFunctionsDynamicReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\LtrimFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\MbFunctionsReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\MbConvertEncodingFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\MbSubstituteCharacterDynamicReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\MbStrlenFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\MicrotimeFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\HrtimeFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\ImplodeFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\NonEmptyStringFunctionsReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\SetTypeFunctionTypeSpecifyingExtension tags: - phpstan.typeSpecifier.functionTypeSpecifyingExtension - class: PHPStan\Type\Php\StrCaseFunctionsReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\StrlenFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\StrIncrementDecrementFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\StrPadFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\StrRepeatFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\SubstrDynamicReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\ThrowableReturnTypeExtension tags: - phpstan.broker.dynamicMethodReturnTypeExtension - class: PHPStan\Type\Php\ParseUrlFunctionDynamicReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\TriggerErrorDynamicReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\TrimFunctionDynamicReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\VersionCompareFunctionDynamicReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\PowFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\RoundFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\StrtotimeFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\RandomIntFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\RangeFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\AssertFunctionTypeSpecifyingExtension tags: - phpstan.typeSpecifier.functionTypeSpecifyingExtension - class: PHPStan\Type\Php\ClassExistsFunctionTypeSpecifyingExtension tags: - phpstan.typeSpecifier.functionTypeSpecifyingExtension - class: PHPStan\Type\Php\ClassImplementsFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\DefineConstantTypeSpecifyingExtension tags: - phpstan.typeSpecifier.functionTypeSpecifyingExtension - class: PHPStan\Type\Php\DefinedConstantTypeSpecifyingExtension tags: - phpstan.typeSpecifier.functionTypeSpecifyingExtension - class: PHPStan\Type\Php\FunctionExistsFunctionTypeSpecifyingExtension tags: - phpstan.typeSpecifier.functionTypeSpecifyingExtension - class: PHPStan\Type\Php\InArrayFunctionTypeSpecifyingExtension tags: - phpstan.typeSpecifier.functionTypeSpecifyingExtension - class: PHPStan\Type\Php\IsArrayFunctionTypeSpecifyingExtension tags: - phpstan.typeSpecifier.functionTypeSpecifyingExtension arguments: explicitMixed: %featureToggles.explicitMixedViaIsArray% - class: PHPStan\Type\Php\IsCallableFunctionTypeSpecifyingExtension tags: - phpstan.typeSpecifier.functionTypeSpecifyingExtension - class: PHPStan\Type\Php\IsIterableFunctionTypeSpecifyingExtension tags: - phpstan.typeSpecifier.functionTypeSpecifyingExtension - class: PHPStan\Type\Php\IsSubclassOfFunctionTypeSpecifyingExtension tags: - phpstan.typeSpecifier.functionTypeSpecifyingExtension - class: PHPStan\Type\Php\IteratorToArrayFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\IsAFunctionTypeSpecifyingExtension tags: - phpstan.typeSpecifier.functionTypeSpecifyingExtension - class: PHPStan\Type\Php\IsAFunctionTypeSpecifyingHelper - class: PHPStan\Type\Php\CtypeDigitFunctionTypeSpecifyingExtension tags: - phpstan.typeSpecifier.functionTypeSpecifyingExtension - class: PHPStan\Type\Php\JsonThrowOnErrorDynamicReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\TypeSpecifyingFunctionsDynamicReturnTypeExtension arguments: treatPhpDocTypesAsCertain: %treatPhpDocTypesAsCertain% universalObjectCratesClasses: %universalObjectCratesClasses% nullContextForVoidReturningFunctions: %featureToggles.nullContextForVoidReturningFunctions% tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\SimpleXMLElementAsXMLMethodReturnTypeExtension tags: - phpstan.broker.dynamicMethodReturnTypeExtension - class: PHPStan\Type\Php\SimpleXMLElementXpathMethodReturnTypeExtension tags: - phpstan.broker.dynamicMethodReturnTypeExtension - class: PHPStan\Type\Php\StrSplitFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\StrTokFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\SprintfFunctionDynamicReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\SscanfFunctionDynamicReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\StrvalFamilyFunctionReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\StrWordCountFunctionDynamicReturnTypeExtension tags: - phpstan.broker.dynamicFunctionReturnTypeExtension - class: PHPStan\Type\Php\XMLReaderOpenReturnTypeExtension tags: - phpstan.broker.dynamicMethodReturnTypeExtension - phpstan.broker.dynamicStaticMethodReturnTypeExtension - class: PHPStan\Type\Php\ReflectionGetAttributesMethodReturnTypeExtension arguments: className: ReflectionClass tags: - phpstan.broker.dynamicMethodReturnTypeExtension - class: PHPStan\Type\Php\ReflectionGetAttributesMethodReturnTypeExtension arguments: className: ReflectionClassConstant tags: - phpstan.broker.dynamicMethodReturnTypeExtension - class: PHPStan\Type\Php\ReflectionGetAttributesMethodReturnTypeExtension arguments: className: ReflectionFunctionAbstract tags: - phpstan.broker.dynamicMethodReturnTypeExtension - class: PHPStan\Type\Php\ReflectionGetAttributesMethodReturnTypeExtension arguments: className: ReflectionParameter tags: - phpstan.broker.dynamicMethodReturnTypeExtension - class: PHPStan\Type\Php\ReflectionGetAttributesMethodReturnTypeExtension arguments: className: ReflectionProperty tags: - phpstan.broker.dynamicMethodReturnTypeExtension - class: PHPStan\Type\Php\DatePeriodConstructorReturnTypeExtension tags: - phpstan.broker.dynamicStaticMethodReturnTypeExtension - class: PHPStan\Type\ClosureTypeFactory arguments: parser: @currentPhpVersionPhpParser - class: PHPStan\Type\Constant\OversizedArrayBuilder - class: PHPStan\Rules\Functions\PrintfHelper exceptionTypeResolver: class: PHPStan\Rules\Exceptions\ExceptionTypeResolver factory: @PHPStan\Rules\Exceptions\DefaultExceptionTypeResolver typeSpecifier: class: PHPStan\Analyser\TypeSpecifier factory: @typeSpecifierFactory::create typeSpecifierFactory: class: PHPStan\Analyser\TypeSpecifierFactory relativePathHelper: class: PHPStan\File\RelativePathHelper factory: PHPStan\File\FuzzyRelativePathHelper arguments: currentWorkingDirectory: %currentWorkingDirectory% analysedPaths: %analysedPaths% fallbackRelativePathHelper: @parentDirectoryRelativePathHelper simpleRelativePathHelper: class: PHPStan\File\RelativePathHelper factory: PHPStan\File\SimpleRelativePathHelper arguments: currentWorkingDirectory: %currentWorkingDirectory% autowired: false parentDirectoryRelativePathHelper: class: PHPStan\File\ParentDirectoryRelativePathHelper arguments: parentDirectory: %currentWorkingDirectory% autowired: false broker: class: PHPStan\Broker\Broker factory: @brokerFactory::create autowired: - PHPStan\Broker\Broker brokerFactory: class: PHPStan\Broker\BrokerFactory cacheStorage: class: PHPStan\Cache\FileCacheStorage arguments: directory: %tmpDir%/cache/PHPStan autowired: false currentPhpVersionRichParser: class: PHPStan\Parser\RichParser arguments: parser: @currentPhpVersionPhpParser lexer: @currentPhpVersionLexer enableIgnoreErrorsWithinPhpDocs: %featureToggles.enableIgnoreErrorsWithinPhpDocs% autowired: false currentPhpVersionSimpleParser: class: PHPStan\Parser\CleaningParser arguments: wrappedParser: @currentPhpVersionSimpleDirectParser autowired: false currentPhpVersionSimpleDirectParser: class: PHPStan\Parser\SimpleParser arguments: parser: @currentPhpVersionPhpParser autowired: false defaultAnalysisParser: class: PHPStan\Parser\CachedParser arguments: originalParser: @pathRoutingParser cachedNodesByStringCountMax: %cache.nodesByStringCountMax% autowired: false phpParserDecorator: class: PHPStan\Parser\PhpParserDecorator arguments: wrappedParser: @defaultAnalysisParser autowired: false currentPhpVersionLexer: class: PhpParser\Lexer factory: @PHPStan\Parser\LexerFactory::create() autowired: false currentPhpVersionPhpParser: class: PhpParser\Parser\Php7 arguments: lexer: @currentPhpVersionLexer autowired: false registry: class: PHPStan\Rules\LazyRegistry autowired: - PHPStan\Rules\Registry stubPhpDocProvider: class: PHPStan\PhpDoc\StubPhpDocProvider arguments: parser: @defaultAnalysisParser reflectionProviderFactory: class: PHPStan\Reflection\ReflectionProvider\ReflectionProviderFactory arguments: staticReflectionProvider: @betterReflectionProvider reflectionProvider: factory: @PHPStan\Reflection\ReflectionProvider\ReflectionProviderFactory::create autowired: - PHPStan\Reflection\ReflectionProvider betterReflectionSourceLocator: class: PHPStan\BetterReflection\SourceLocator\Type\SourceLocator factory: @PHPStan\Reflection\BetterReflection\BetterReflectionSourceLocatorFactory::create autowired: false originalBetterReflectionReflector: class: PHPStan\BetterReflection\Reflector\DefaultReflector arguments: sourceLocator: @betterReflectionSourceLocator betterReflectionReflector: class: PHPStan\Reflection\BetterReflection\Reflector\MemoizingReflector arguments: reflector: @originalBetterReflectionReflector autowired: false betterReflectionClassReflector: class: PHPStan\BetterReflection\Reflector\ClassReflector arguments: sourceLocator: @betterReflectionSourceLocator autowired: false betterReflectionFunctionReflector: class: PHPStan\BetterReflection\Reflector\FunctionReflector arguments: sourceLocator: @betterReflectionSourceLocator autowired: false betterReflectionConstantReflector: class: PHPStan\BetterReflection\Reflector\ConstantReflector arguments: sourceLocator: @betterReflectionSourceLocator autowired: false nodeScopeResolverReflector: factory: @betterReflectionReflector autowired: false betterReflectionProvider: class: PHPStan\Reflection\BetterReflection\BetterReflectionProvider arguments: reflector: @betterReflectionReflector universalObjectCratesClasses: %universalObjectCratesClasses% autowired: false - class: PHPStan\Reflection\BetterReflection\BetterReflectionSourceLocatorFactory arguments: parser: @phpParserDecorator php8Parser: @php8PhpParser scanFiles: %scanFiles% scanDirectories: %scanDirectories% analysedPaths: %analysedPaths% composerAutoloaderProjectPaths: %composerAutoloaderProjectPaths% analysedPathsFromConfig: %analysedPathsFromConfig% playgroundMode: %sourceLocatorPlaygroundMode% - implement: PHPStan\Reflection\BetterReflection\BetterReflectionProviderFactory arguments: universalObjectCratesClasses: %universalObjectCratesClasses% - class: PHPStan\Reflection\BetterReflection\SourceStubber\PhpStormStubsSourceStubberFactory arguments: phpParser: @php8PhpParser - factory: @PHPStan\Reflection\BetterReflection\SourceStubber\PhpStormStubsSourceStubberFactory::create() autowired: - PHPStan\BetterReflection\SourceLocator\SourceStubber\PhpStormStubsSourceStubber - factory: @PHPStan\Reflection\BetterReflection\SourceStubber\ReflectionSourceStubberFactory::create() autowired: - PHPStan\BetterReflection\SourceLocator\SourceStubber\ReflectionSourceStubber - class: PHPStan\Reflection\BetterReflection\SourceStubber\ReflectionSourceStubberFactory php8Lexer: class: PhpParser\Lexer\Emulative factory: @PHPStan\Parser\LexerFactory::createEmulative() autowired: false php8PhpParser: class: PhpParser\Parser\Php7 arguments: lexer: @php8Lexer autowired: false php8Parser: class: PHPStan\Parser\SimpleParser arguments: parser: @php8PhpParser autowired: false pathRoutingParser: class: PHPStan\Parser\PathRoutingParser arguments: currentPhpVersionRichParser: @currentPhpVersionRichParser currentPhpVersionSimpleParser: @currentPhpVersionSimpleParser php8Parser: @php8Parser autowired: false phpstanDiagnoseExtension: class: PHPStan\Diagnose\PHPStanDiagnoseExtension arguments: composerAutoloaderProjectPaths: %composerAutoloaderProjectPaths% allConfigFiles: %allConfigFiles% autowired: false - class: PHPStan\Command\ErrorFormatter\CiDetectedErrorFormatter autowired: - PHPStan\Command\ErrorFormatter\CiDetectedErrorFormatter errorFormatter.raw: class: PHPStan\Command\ErrorFormatter\RawErrorFormatter errorFormatter.table: class: PHPStan\Command\ErrorFormatter\TableErrorFormatter arguments: simpleRelativePathHelper: @simpleRelativePathHelper showTipsOfTheDay: %tipsOfTheDay% editorUrl: %editorUrl% editorUrlTitle: %editorUrlTitle% errorFormatter.checkstyle: class: PHPStan\Command\ErrorFormatter\CheckstyleErrorFormatter arguments: relativePathHelper: @simpleRelativePathHelper errorFormatter.json: class: PHPStan\Command\ErrorFormatter\JsonErrorFormatter arguments: pretty: false errorFormatter.junit: class: PHPStan\Command\ErrorFormatter\JunitErrorFormatter arguments: relativePathHelper: @simpleRelativePathHelper errorFormatter.prettyJson: class: PHPStan\Command\ErrorFormatter\JsonErrorFormatter arguments: pretty: true errorFormatter.gitlab: class: PHPStan\Command\ErrorFormatter\GitlabErrorFormatter arguments: relativePathHelper: @simpleRelativePathHelper errorFormatter.github: class: PHPStan\Command\ErrorFormatter\GithubErrorFormatter arguments: relativePathHelper: @simpleRelativePathHelper errorFormatter.teamcity: class: PHPStan\Command\ErrorFormatter\TeamcityErrorFormatter arguments: relativePathHelper: @simpleRelativePathHelper parameters: customRulesetUsed: false conditionalTags: PHPStan\Rules\Api\NodeConnectingVisitorAttributesRule: phpstan.rules.rule: %featureToggles.nodeConnectingVisitorRule% PHPStan\Rules\Properties\MissingReadOnlyByPhpDocPropertyAssignRule: phpstan.rules.rule: %featureToggles.readOnlyByPhpDoc% PHPStan\Rules\Properties\ReadOnlyByPhpDocPropertyRule: phpstan.rules.rule: %featureToggles.readOnlyByPhpDoc% PHPStan\Rules\Properties\UninitializedPropertyRule: phpstan.rules.rule: %checkUninitializedProperties% PHPStan\Rules\Methods\ConsistentConstructorRule: phpstan.rules.rule: %featureToggles.consistentConstructor% PHPStan\Rules\Api\ApiClassConstFetchRule: phpstan.rules.rule: %featureToggles.runtimeReflectionRules% PHPStan\Rules\Api\ApiInstanceofRule: phpstan.rules.rule: %featureToggles.runtimeReflectionRules% PHPStan\Rules\Api\RuntimeReflectionFunctionRule: phpstan.rules.rule: %featureToggles.runtimeReflectionRules% PHPStan\Rules\Api\RuntimeReflectionInstantiationRule: phpstan.rules.rule: %featureToggles.runtimeReflectionRules% PHPStan\Rules\Methods\MissingMagicSerializationMethodsRule: phpstan.rules.rule: %featureToggles.missingMagicSerializationRule% PHPStan\Rules\Constants\MagicConstantContextRule: phpstan.rules.rule: %featureToggles.magicConstantOutOfContext% PHPStan\Rules\Functions\UselessFunctionReturnValueRule: phpstan.rules.rule: %featureToggles.uselessReturnValue% PHPStan\Rules\Functions\PrintfArrayParametersRule: phpstan.rules.rule: %featureToggles.printfArrayParameters% PHPStan\Rules\Regexp\RegularExpressionQuotingRule: phpstan.rules.rule: %featureToggles.validatePregQuote% PHPStan\Rules\Keywords\RequireFileExistsRule: phpstan.rules.rule: %featureToggles.requireFileExists% PHPStan\Rules\Classes\LocalTypeTraitUseAliasesRule: phpstan.rules.rule: %featureToggles.absentTypeChecks% rules: - PHPStan\Rules\Api\ApiInstantiationRule - PHPStan\Rules\Api\ApiClassExtendsRule - PHPStan\Rules\Api\ApiClassImplementsRule - PHPStan\Rules\Api\ApiInterfaceExtendsRule - PHPStan\Rules\Api\ApiMethodCallRule - PHPStan\Rules\Api\ApiStaticCallRule - PHPStan\Rules\Api\ApiTraitUseRule - PHPStan\Rules\Api\GetTemplateTypeRule - PHPStan\Rules\Api\PhpStanNamespaceIn3rdPartyPackageRule - PHPStan\Rules\Arrays\DuplicateKeysInLiteralArraysRule - PHPStan\Rules\Arrays\EmptyArrayItemRule - PHPStan\Rules\Arrays\OffsetAccessWithoutDimForReadingRule - PHPStan\Rules\Cast\UnsetCastRule - PHPStan\Rules\Classes\AllowedSubTypesRule - PHPStan\Rules\Classes\ClassAttributesRule - PHPStan\Rules\Classes\ClassConstantAttributesRule - PHPStan\Rules\Classes\ClassConstantRule - PHPStan\Rules\Classes\DuplicateDeclarationRule - PHPStan\Rules\Classes\EnumSanityRule - PHPStan\Rules\Classes\ExistingClassesInClassImplementsRule - PHPStan\Rules\Classes\ExistingClassesInEnumImplementsRule - PHPStan\Rules\Classes\ExistingClassesInInterfaceExtendsRule - PHPStan\Rules\Classes\ExistingClassInTraitUseRule - PHPStan\Rules\Classes\InstantiationRule - PHPStan\Rules\Classes\InstantiationCallableRule - PHPStan\Rules\Classes\InvalidPromotedPropertiesRule - PHPStan\Rules\Classes\LocalTypeAliasesRule - PHPStan\Rules\Classes\LocalTypeTraitAliasesRule - PHPStan\Rules\Classes\NewStaticRule - PHPStan\Rules\Classes\NonClassAttributeClassRule - PHPStan\Rules\Classes\ReadOnlyClassRule - PHPStan\Rules\Classes\TraitAttributeClassRule - PHPStan\Rules\Constants\ClassAsClassConstantRule - PHPStan\Rules\Constants\DynamicClassConstantFetchRule - PHPStan\Rules\Constants\FinalConstantRule - PHPStan\Rules\Constants\NativeTypedClassConstantRule - PHPStan\Rules\EnumCases\EnumCaseAttributesRule - PHPStan\Rules\Exceptions\NoncapturingCatchRule - PHPStan\Rules\Exceptions\ThrowExpressionRule - PHPStan\Rules\Functions\ArrowFunctionAttributesRule - PHPStan\Rules\Functions\ArrowFunctionReturnNullsafeByRefRule - PHPStan\Rules\Functions\ClosureAttributesRule - PHPStan\Rules\Functions\DefineParametersRule - PHPStan\Rules\Functions\ExistingClassesInArrowFunctionTypehintsRule - PHPStan\Rules\Functions\CallToFunctionParametersRule - PHPStan\Rules\Functions\ExistingClassesInClosureTypehintsRule - PHPStan\Rules\Functions\ExistingClassesInTypehintsRule - PHPStan\Rules\Functions\FunctionAttributesRule - PHPStan\Rules\Functions\InnerFunctionRule - PHPStan\Rules\Functions\InvalidLexicalVariablesInClosureUseRule - PHPStan\Rules\Functions\ParamAttributesRule - PHPStan\Rules\Functions\PrintfParametersRule - PHPStan\Rules\Functions\RedefinedParametersRule - PHPStan\Rules\Functions\ReturnNullsafeByRefRule - PHPStan\Rules\Ignore\IgnoreParseErrorRule - PHPStan\Rules\Functions\VariadicParametersDeclarationRule - PHPStan\Rules\Keywords\ContinueBreakInLoopRule - PHPStan\Rules\Keywords\DeclareStrictTypesRule - PHPStan\Rules\Methods\AbstractMethodInNonAbstractClassRule - PHPStan\Rules\Methods\AbstractPrivateMethodRule - PHPStan\Rules\Methods\CallMethodsRule - PHPStan\Rules\Methods\CallStaticMethodsRule - PHPStan\Rules\Methods\ConstructorReturnTypeRule - PHPStan\Rules\Methods\ExistingClassesInTypehintsRule - PHPStan\Rules\Methods\FinalPrivateMethodRule - PHPStan\Rules\Methods\MethodCallableRule - PHPStan\Rules\Methods\MethodVisibilityInInterfaceRule - PHPStan\Rules\Methods\MissingMethodImplementationRule - PHPStan\Rules\Methods\MethodAttributesRule - PHPStan\Rules\Methods\StaticMethodCallableRule - PHPStan\Rules\Names\UsedNamesRule - PHPStan\Rules\Operators\InvalidAssignVarRule - PHPStan\Rules\Properties\AccessPropertiesInAssignRule - PHPStan\Rules\Properties\AccessStaticPropertiesInAssignRule - PHPStan\Rules\Properties\InvalidCallablePropertyTypeRule - PHPStan\Rules\Properties\MissingReadOnlyPropertyAssignRule - PHPStan\Rules\Properties\PropertiesInInterfaceRule - PHPStan\Rules\Properties\PropertyAttributesRule - PHPStan\Rules\Properties\ReadOnlyPropertyRule - PHPStan\Rules\Traits\ConflictingTraitConstantsRule - PHPStan\Rules\Traits\ConstantsInTraitsRule - PHPStan\Rules\Types\InvalidTypesInUnionRule - PHPStan\Rules\Variables\UnsetRule - PHPStan\Rules\Whitespace\FileWhitespaceRule services: - class: PHPStan\Rules\Api\ApiClassConstFetchRule - class: PHPStan\Rules\Api\ApiInstanceofRule - class: PHPStan\Rules\Api\ApiInstanceofTypeRule arguments: enabled: %featureToggles.instanceofType% deprecationRulesInstalled: %deprecationRulesInstalled% tags: - phpstan.rules.rule - class: PHPStan\Rules\Api\NodeConnectingVisitorAttributesRule - class: PHPStan\Rules\Api\RuntimeReflectionFunctionRule - class: PHPStan\Rules\Api\RuntimeReflectionInstantiationRule - class: PHPStan\Rules\Classes\ExistingClassInClassExtendsRule tags: - phpstan.rules.rule - class: PHPStan\Rules\Classes\ExistingClassInInstanceOfRule tags: - phpstan.rules.rule arguments: checkClassCaseSensitivity: %checkClassCaseSensitivity% - class: PHPStan\Rules\Classes\LocalTypeTraitUseAliasesRule - class: PHPStan\Rules\Exceptions\CaughtExceptionExistenceRule tags: - phpstan.rules.rule arguments: checkClassCaseSensitivity: %checkClassCaseSensitivity% - class: PHPStan\Rules\Functions\CallToNonExistentFunctionRule tags: - phpstan.rules.rule arguments: checkFunctionNameCase: %checkFunctionNameCase% - class: PHPStan\Rules\Constants\OverridingConstantRule arguments: checkPhpDocMethodSignatures: %checkPhpDocMethodSignatures% tags: - phpstan.rules.rule - class: PHPStan\Rules\Methods\OverridingMethodRule arguments: checkPhpDocMethodSignatures: %checkPhpDocMethodSignatures% genericPrototypeMessage: %featureToggles.genericPrototypeMessage% finalByPhpDoc: %featureToggles.finalByPhpDoc% checkMissingOverrideMethodAttribute: %checkMissingOverrideMethodAttribute% tags: - phpstan.rules.rule - class: PHPStan\Rules\Methods\ConsistentConstructorRule - class: PHPStan\Rules\Missing\MissingReturnRule arguments: checkExplicitMixedMissingReturn: %checkExplicitMixedMissingReturn% checkPhpDocMissingReturn: %checkPhpDocMissingReturn% tags: - phpstan.rules.rule - class: PHPStan\Rules\Namespaces\ExistingNamesInGroupUseRule tags: - phpstan.rules.rule arguments: checkFunctionNameCase: %checkFunctionNameCase% - class: PHPStan\Rules\Namespaces\ExistingNamesInUseRule tags: - phpstan.rules.rule arguments: checkFunctionNameCase: %checkFunctionNameCase% - class: PHPStan\Rules\Operators\InvalidIncDecOperationRule tags: - phpstan.rules.rule arguments: bleedingEdge: %featureToggles.bleedingEdge% checkThisOnly: %checkThisOnly% - class: PHPStan\Rules\Properties\AccessPropertiesRule tags: - phpstan.rules.rule arguments: reportMagicProperties: %reportMagicProperties% checkDynamicProperties: %checkDynamicProperties% - class: PHPStan\Rules\Properties\AccessStaticPropertiesRule tags: - phpstan.rules.rule - class: PHPStan\Rules\Properties\ExistingClassesInPropertiesRule tags: - phpstan.rules.rule arguments: checkClassCaseSensitivity: %checkClassCaseSensitivity% checkThisOnly: %checkThisOnly% - class: PHPStan\Rules\Functions\FunctionCallableRule arguments: checkFunctionNameCase: %checkFunctionNameCase% reportMaybes: %reportMaybes% tags: - phpstan.rules.rule - class: PHPStan\Rules\Properties\MissingReadOnlyByPhpDocPropertyAssignRule - class: PHPStan\Rules\Properties\OverridingPropertyRule arguments: checkPhpDocMethodSignatures: %checkPhpDocMethodSignatures% reportMaybes: %reportMaybesInPropertyPhpDocTypes% tags: - phpstan.rules.rule - class: PHPStan\Rules\Properties\ReadOnlyByPhpDocPropertyRule - class: PHPStan\Rules\Properties\UninitializedPropertyRule - class: PHPStan\Rules\Properties\WritingToReadOnlyPropertiesRule arguments: checkThisOnly: %checkThisOnly% tags: - phpstan.rules.rule - class: PHPStan\Rules\Properties\ReadingWriteOnlyPropertiesRule arguments: checkThisOnly: %checkThisOnly% tags: - phpstan.rules.rule - class: PHPStan\Rules\Variables\CompactVariablesRule arguments: checkMaybeUndefinedVariables: %checkMaybeUndefinedVariables% tags: - phpstan.rules.rule - class: PHPStan\Rules\Variables\DefinedVariableRule arguments: cliArgumentsVariablesRegistered: %cliArgumentsVariablesRegistered% checkMaybeUndefinedVariables: %checkMaybeUndefinedVariables% tags: - phpstan.rules.rule - class: PHPStan\Rules\Regexp\RegularExpressionPatternRule tags: - phpstan.rules.rule - class: PHPStan\Reflection\ConstructorsHelper arguments: additionalConstructors: %additionalConstructors% - class: PHPStan\Rules\Methods\MissingMagicSerializationMethodsRule - class: PHPStan\Rules\Constants\MagicConstantContextRule - class: PHPStan\Rules\Functions\UselessFunctionReturnValueRule - class: PHPStan\Rules\Functions\PrintfArrayParametersRule - class: PHPStan\Rules\Regexp\RegularExpressionQuotingRule - class: PHPStan\Rules\Keywords\RequireFileExistsRule arguments: currentWorkingDirectory: %currentWorkingDirectory% parameters: featureToggles: bleedingEdge: true skipCheckGenericClasses!: [] explicitMixedInUnknownGenericNew: true explicitMixedForGlobalVariables: true explicitMixedViaIsArray: true arrayFilter: true arrayUnpacking: true arrayValues: true nodeConnectingVisitorCompatibility: false nodeConnectingVisitorRule: true disableCheckMissingIterableValueType: true strictUnnecessaryNullsafePropertyFetch: true looseComparison: true consistentConstructor: true checkUnresolvableParameterTypes: true readOnlyByPhpDoc: true phpDocParserRequireWhitespaceBeforeDescription: true phpDocParserIncludeLines: true enableIgnoreErrorsWithinPhpDocs: true runtimeReflectionRules: true notAnalysedTrait: true curlSetOptTypes: true listType: true abstractTraitMethod: true missingMagicSerializationRule: true nullContextForVoidReturningFunctions: true unescapeStrings: true alwaysCheckTooWideReturnTypeFinalMethods: true duplicateStubs: true logicalXor: true betterNoop: true invarianceComposition: true alwaysTrueAlwaysReported: true disableUnreachableBranchesRules: true varTagType: true closureDefaultParameterTypeRule: true newRuleLevelHelper: true instanceofType: true paramOutVariance: true allInvalidPhpDocs: true strictStaticMethodTemplateTypeVariance: true propertyVariance: true genericPrototypeMessage: true stricterFunctionMap: true invalidPhpDocTagLine: true detectDeadTypeInMultiCatch: true zeroFiles: true projectServicesNotInAnalysedPaths: true callUserFunc: true finalByPhpDoc: true magicConstantOutOfContext: true paramOutType: true pure: true checkParameterCastableToStringFunctions: true uselessReturnValue: true printfArrayParameters: true preciseMissingReturn: true validatePregQuote: true noImplicitWildcard: true tooWidePropertyType: true explicitThrow: true absentTypeChecks: true requireFileExists: true stubFiles: - ../stubs/bleedingEdge/Rule.stub parameters: checkThisOnly: false checkClassCaseSensitivity: true checkGenericClassInNonGenericObjectType: true checkMissingIterableValueType: true checkMissingTypehints: true checkMissingCallableSignature: false __validate: false services: - class: PHPStan\PhpDoc\StubSourceLocatorFactory arguments: php8Parser: @php8PhpParser nodeScopeResolverClassReflector: factory: @stubReflector stubBetterReflectionProvider: class: PHPStan\Reflection\BetterReflection\BetterReflectionProvider arguments: reflector: @stubReflector universalObjectCratesClasses: %universalObjectCratesClasses% autowired: false stubReflector: class: PHPStan\BetterReflection\Reflector\DefaultReflector arguments: sourceLocator: @stubSourceLocator autowired: false stubSourceLocator: class: PHPStan\BetterReflection\SourceLocator\Type\SourceLocator factory: @PHPStan\PhpDoc\StubSourceLocatorFactory::create() autowired: false reflectionProvider: factory: @stubBetterReflectionProvider autowired: - PHPStan\Reflection\ReflectionProvider <?php // phpcs:ignoreFile /** * Copied over from https://github.com/phan/phan/blob/8866d6b98be94b37996390da226e8c4befea29aa/src/Phan/Language/Internal/FunctionSignatureMap_php80_delta.php * Copyright (c) 2015 Rasmus Lerdorf * Copyright (c) 2015 Andrew Morrison */ /** * This contains the information needed to convert the function signatures for php 8.0 to php 7.4 (and vice versa) * * This has two sections. * The 'new' section contains function/method names from FunctionSignatureMap (And alternates, if applicable) that do not exist in php7.4 or have different signatures in php 8.0. * If they were just updated, the function/method will be present in the 'added' signatures. * The 'old' signatures contains the signatures that are different in php 7.4. * Functions are expected to be removed only in major releases of php. * * @see FunctionSignatureMap.php * * @phan-file-suppress PhanPluginMixedKeyNoKey (read by Phan when analyzing this file) */ return [ 'new' => [ 'array_combine' => ['associative-array', 'keys'=>'string[]|int[]', 'values'=>'array'], 'base64_decode' => ['string', 'string'=>'string', 'strict='=>'false'], 'base64_decode\'1' => ['string|false', 'string'=>'string', 'strict='=>'true'], 'bcdiv' => ['string', 'dividend'=>'string', 'divisor'=>'string', 'scale='=>'int'], 'bcmod' => ['string', 'dividend'=>'string', 'divisor'=>'string', 'scale='=>'int'], 'bcpowmod' => ['string', 'base'=>'string', 'exponent'=>'string', 'modulus'=>'string', 'scale='=>'int'], 'call_user_func_array' => ['mixed', 'function'=>'callable', 'parameters'=>'array<int|string,mixed>'], 'ceil' => ['float', 'number'=>'float'], 'com_load_typelib' => ['bool', 'typelib_name'=>'string', 'case_insensitive='=>'true'], 'count_chars' => ['array<int,int>|string', 'input'=>'string', 'mode='=>'int'], 'curl_init' => ['__benevolent<CurlHandle|false>', 'url='=>'string'], 'date_add' => ['DateTime', 'object'=>'DateTime', 'interval'=>'DateInterval'], 'date_date_set' => ['DateTime', 'object'=>'DateTime', 'year'=>'int', 'month'=>'int', 'day'=>'int'], 'date_diff' => ['DateInterval', 'obj1'=>'DateTimeInterface', 'obj2'=>'DateTimeInterface', 'absolute='=>'bool'], 'date_format' => ['string', 'object'=>'DateTimeInterface', 'format'=>'string'], 'date_isodate_set' => ['DateTime', 'object'=>'DateTime', 'year'=>'int', 'week'=>'int', 'day='=>'int|mixed'], 'date_parse' => ['array<string,mixed>', 'date'=>'string'], 'date_sub' => ['DateTime', 'object'=>'DateTime', 'interval'=>'DateInterval'], 'date_sun_info' => ['array{sunrise: int|bool,sunset: int|bool,transit: int|bool,civil_twilight_begin: int|bool,civil_twilight_end: int|bool,nautical_twilight_begin: int|bool,nautical_twilight_end: int|bool,astronomical_twilight_begin: int|bool,astronomical_twilight_end: int|bool}', 'time'=>'int', 'latitude'=>'float', 'longitude'=>'float'], 'date_time_set' => ['DateTime', 'object'=>'DateTime', 'hour'=>'int', 'minute'=>'int', 'second='=>'int', 'microseconds='=>'int'], 'date_timestamp_set' => ['DateTime', 'object'=>'DateTime', 'unixtimestamp'=>'int'], 'date_timezone_set' => ['DateTime', 'object'=>'DateTime', 'timezone'=>'DateTimeZone'], 'explode' => ['list<string>', 'separator'=>'non-empty-string', 'str'=>'string', 'limit='=>'int'], 'fdiv' => ['float', 'dividend'=>'float', 'divisor'=>'float'], 'floor' => ['float', 'number'=>'float'], 'forward_static_call_array' => ['mixed', 'function'=>'callable', 'parameters'=>'array<int|string,mixed>'], 'get_debug_type' => ['string', 'var'=>'mixed'], 'get_resource_id' => ['int', 'res'=>'resource'], 'gmdate' => ['string', 'format'=>'string', 'timestamp='=>'int'], 'gmmktime' => ['int|false', 'hour'=>'int', 'minute='=>'int', 'second='=>'int', 'month='=>'int', 'day='=>'int', 'year='=>'int'], 'hash' => ['non-falsy-string', 'algo'=>'string', 'data'=>'string', 'raw_output='=>'bool'], 'hash_hkdf' => ['non-falsy-string', 'algo'=>'string', 'key'=>'string', 'length='=>'int', 'info='=>'string', 'salt='=>'string'], 'hash_hmac' => ['non-falsy-string', 'algo'=>'string', 'data'=>'string', 'key'=>'string', 'raw_output='=>'bool'], 'hash_pbkdf2' => ['non-falsy-string', 'algo'=>'string', 'password'=>'string', 'salt'=>'string', 'iterations'=>'int', 'length='=>'int', 'raw_output='=>'bool'], 'imageaffine' => ['false|object', 'src'=>'resource', 'affine'=>'array', 'clip='=>'array'], 'imagecreate' => ['__benevolent<GdImage|false>', 'width'=>'int', 'height'=>'int'], 'imagecreatefrombmp' => ['false|object', 'filename'=>'string'], 'imagecreatefromgd' => ['false|object', 'filename'=>'string'], 'imagecreatefromgd2' => ['false|object', 'filename'=>'string'], 'imagecreatefromgd2part' => ['false|object', 'filename'=>'string', 'srcx'=>'int', 'srcy'=>'int', 'width'=>'int', 'height'=>'int'], 'imagecreatefromgif' => ['false|object', 'filename'=>'string'], 'imagecreatefromjpeg' => ['false|object', 'filename'=>'string'], 'imagecreatefrompng' => ['false|object', 'filename'=>'string'], 'imagecreatefromstring' => ['false|object', 'image'=>'string'], 'imagecreatefromwbmp' => ['false|object', 'filename'=>'string'], 'imagecreatefromwebp' => ['false|object', 'filename'=>'string'], 'imagecreatefromxbm' => ['false|object', 'filename'=>'string'], 'imagecreatefromxpm' => ['false|object', 'filename'=>'string'], 'imagecreatetruecolor' => ['__benevolent<GdImage|false>', 'width'=>'int', 'height'=>'int'], 'imagecrop' => ['false|object', 'im'=>'resource', 'rect'=>'array'], 'imagecropauto' => ['false|object', 'im'=>'resource', 'mode'=>'int', 'threshold'=>'float', 'color'=>'int'], 'imagegetclip' => ['array<int,int>', 'im'=>'resource'], 'imagegrabscreen' => ['false|object'], 'imagegrabwindow' => ['false|object', 'window_handle'=>'int', 'client_area='=>'int'], 'imagejpeg' => ['bool', 'im'=>'GdImage', 'filename='=>'string|resource|null', 'quality='=>'int'], 'imagerotate' => ['false|object', 'src_im'=>'resource', 'angle'=>'float', 'bgdcolor'=>'int', 'ignoretransparent='=>'int'], 'imagescale' => ['false|object', 'im'=>'resource', 'new_width'=>'int', 'new_height='=>'int', 'method='=>'int'], 'ldap_set_rebind_proc' => ['bool', 'ldap'=>'resource', 'callback'=>'?callable'], 'mb_decode_numericentity' => ['string|false', 'string'=>'string', 'convmap'=>'array', 'encoding='=>'string'], 'mb_encoding_aliases' => ['list<non-falsy-string>', 'encoding'=>'string'], 'mb_str_split' => ['list<string>', 'str'=>'string', 'split_length='=>'positive-int', 'encoding='=>'string'], 'mb_strlen' => ['0|positive-int', 'str'=>'string', 'encoding='=>'string'], 'mktime' => ['int|false', 'hour'=>'int', 'minute='=>'int', 'second='=>'int', 'month='=>'int', 'day='=>'int', 'year='=>'int'], 'odbc_exec' => ['resource|false', 'connection_id'=>'resource', 'query'=>'string'], 'parse_str' => ['void', 'encoded_string'=>'string', '&w_result'=>'array'], 'password_hash' => ['non-empty-string', 'password'=>'string', 'algo'=>'string|int|null', 'options='=>'array'], 'PDOStatement::fetchAll' => ['array', 'how='=>'int', 'fetch_argument='=>'int|string|callable', 'ctor_args='=>'?array'], 'PhpToken::tokenize' => ['list<PhpToken>', 'code'=>'string', 'flags='=>'int'], 'PhpToken::is' => ['bool', 'kind'=>'string|int|string[]|int[]'], 'PhpToken::isIgnorable' => ['bool'], 'PhpToken::getTokenName' => ['non-falsy-string'], 'preg_match_all' => ['0|positive-int|false', 'pattern'=>'string', 'subject'=>'string', '&w_subpatterns='=>'array', 'flags='=>'int', 'offset='=>'int'], 'proc_get_status' => ['array{command: string, pid: int, running: bool, signaled: bool, stopped: bool, exitcode: int, termsig: int, stopsig: int}', 'process'=>'resource'], 'set_error_handler' => ['?callable', 'callback'=>'null|callable(int,string,string,int):bool', 'error_types='=>'int'], 'socket_addrinfo_lookup' => ['AddressInfo[]', 'node'=>'string', 'service='=>'mixed', 'hints='=>'array'], 'socket_select' => ['int|false', '&w_read'=>'Socket[]|null', '&w_write'=>'Socket[]|null', '&w_except'=>'Socket[]|null', 'seconds'=>'int|null', 'microseconds='=>'int'], 'sodium_crypto_aead_chacha20poly1305_ietf_decrypt' => ['string|false', 'confidential_message'=>'string', 'public_message'=>'string', 'nonce'=>'string', 'key'=>'string'], 'spl_autoload_functions' => ['list<callable(string):void>'], 'str_contains' => ['bool', 'haystack'=>'string', 'needle'=>'string'], 'str_split' => ['non-empty-list<string>', 'str'=>'string', 'split_length='=>'positive-int'], 'str_ends_with' => ['bool', 'haystack'=>'string', 'needle'=>'string'], 'str_starts_with' => ['bool', 'haystack'=>'string', 'needle'=>'string'], 'strchr' => ['string|false', 'haystack'=>'string', 'needle'=>'string', 'before_needle='=>'bool'], 'stripos' => ['0|positive-int|false', 'haystack'=>'string', 'needle'=>'string', 'offset='=>'int'], 'stristr' => ['string|false', 'haystack'=>'string', 'needle'=>'string', 'before_needle='=>'bool'], 'strpos' => ['positive-int|0|false', 'haystack'=>'string', 'needle'=>'string', 'offset='=>'int'], 'strrchr' => ['string|false', 'haystack'=>'string', 'needle'=>'string'], 'strripos' => ['int|false', 'haystack'=>'string', 'needle'=>'string', 'offset='=>'int'], 'strrpos' => ['int|false', 'haystack'=>'string', 'needle'=>'string', 'offset='=>'int'], 'strstr' => ['string|false', 'haystack'=>'string', 'needle'=>'string', 'before_needle='=>'bool'], 'substr' => ['string', 'string'=>'string', 'start'=>'int', 'length='=>'int'], 'round' => ['float', 'number'=>'float', 'precision='=>'int', 'mode='=>'1|2|3|4'], 'version_compare' => ['int|bool', 'version1'=>'string', 'version2'=>'string', 'operator='=>'string|null'], 'xml_parser_create' => ['XMLParser', 'encoding='=>'string'], 'xml_parser_create_ns' => ['XMLParser', 'encoding='=>'string', 'sep='=>'string'], 'xml_parser_free' => ['bool', 'parser'=>'XMLParser'], 'xml_parser_get_option' => ['mixed|false', 'parser'=>'XMLParser', 'option'=>'int'], 'xml_parser_set_option' => ['bool', 'parser'=>'XMLParser', 'option'=>'int', 'value'=>'mixed'], 'xmlwriter_end_attribute' => ['bool', 'xmlwriter'=>'XMLWriter'], 'xmlwriter_end_cdata' => ['bool', 'xmlwriter'=>'XMLWriter'], 'xmlwriter_end_comment' => ['bool', 'xmlwriter'=>'XMLWriter'], 'xmlwriter_end_document' => ['bool', 'xmlwriter'=>'XMLWriter'], 'xmlwriter_end_dtd' => ['bool', 'xmlwriter'=>'XMLWriter'], 'xmlwriter_end_dtd_attlist' => ['bool', 'xmlwriter'=>'XMLWriter'], 'xmlwriter_end_dtd_element' => ['bool', 'xmlwriter'=>'XMLWriter'], 'xmlwriter_end_dtd_entity' => ['bool', 'xmlwriter'=>'XMLWriter'], 'xmlwriter_end_element' => ['bool', 'xmlwriter'=>'XMLWriter'], 'xmlwriter_end_pi' => ['bool', 'xmlwriter'=>'XMLWriter'], 'xmlwriter_flush' => ['mixed', 'xmlwriter'=>'XMLWriter', 'empty='=>'bool'], 'xmlwriter_full_end_element' => ['bool', 'xmlwriter'=>'XMLWriter'], 'xmlwriter_open_memory' => ['XMLWriter'], 'xmlwriter_open_uri' => ['XMLWriter', 'source'=>'string'], 'xmlwriter_output_memory' => ['string', 'xmlwriter'=>'XMLWriter', 'flush='=>'bool'], 'xmlwriter_set_indent' => ['bool', 'xmlwriter'=>'XMLWriter', 'indent'=>'bool'], 'xmlwriter_set_indent_string' => ['bool', 'xmlwriter'=>'XMLWriter', 'indentstring'=>'string'], 'xmlwriter_start_attribute' => ['bool', 'xmlwriter'=>'XMLWriter', 'name'=>'string'], 'xmlwriter_start_attribute_ns' => ['bool', 'xmlwriter'=>'XMLWriter', 'prefix'=>'string', 'name'=>'string', 'uri'=>'string'], 'xmlwriter_start_cdata' => ['bool', 'xmlwriter'=>'XMLWriter'], 'xmlwriter_start_comment' => ['bool', 'xmlwriter'=>'XMLWriter'], 'xmlwriter_start_document' => ['bool', 'xmlwriter'=>'XMLWriter', 'version='=>'string', 'encoding='=>'string', 'standalone='=>'string'], 'xmlwriter_start_dtd' => ['bool', 'xmlwriter'=>'XMLWriter', 'name'=>'string', 'publicid='=>'string', 'sysid='=>'string'], 'xmlwriter_start_dtd_attlist' => ['bool', 'xmlwriter'=>'XMLWriter', 'name'=>'string'], 'xmlwriter_start_dtd_element' => ['bool', 'xmlwriter'=>'XMLWriter', 'name'=>'string'], 'xmlwriter_start_dtd_entity' => ['bool', 'xmlwriter'=>'XMLWriter', 'name'=>'string', 'isparam'=>'bool'], 'xmlwriter_start_element' => ['bool', 'xmlwriter'=>'XMLWriter', 'name'=>'string'], 'xmlwriter_start_element_ns' => ['bool', 'xmlwriter'=>'XMLWriter', 'prefix'=>'string', 'name'=>'string', 'uri'=>'string|null'], 'xmlwriter_start_pi' => ['bool', 'xmlwriter'=>'XMLWriter', 'target'=>'string'], 'xmlwriter_text' => ['bool', 'xmlwriter'=>'XMLWriter', 'content'=>'string'], 'xmlwriter_write_attribute' => ['bool', 'xmlwriter'=>'XMLWriter', 'name'=>'string', 'content'=>'string'], 'xmlwriter_write_attribute_ns' => ['bool', 'xmlwriter'=>'XMLWriter', 'prefix'=>'string', 'name'=>'string', 'uri'=>'string', 'content'=>'string'], 'xmlwriter_write_cdata' => ['bool', 'xmlwriter'=>'XMLWriter', 'content'=>'string'], 'xmlwriter_write_comment' => ['bool', 'xmlwriter'=>'XMLWriter', 'content'=>'string'], 'xmlwriter_write_dtd' => ['bool', 'xmlwriter'=>'XMLWriter', 'name'=>'string', 'publicid='=>'string', 'sysid='=>'string', 'subset='=>'string'], 'xmlwriter_write_dtd_attlist' => ['bool', 'xmlwriter'=>'XMLWriter', 'name'=>'string', 'content'=>'string'], 'xmlwriter_write_dtd_element' => ['bool', 'xmlwriter'=>'XMLWriter', 'name'=>'string', 'content'=>'string'], 'xmlwriter_write_dtd_entity' => ['bool', 'xmlwriter'=>'XMLWriter', 'name'=>'string', 'content'=>'string', 'pe'=>'bool', 'publicid'=>'string', 'sysid'=>'string', 'ndataid'=>'string'], 'xmlwriter_write_element' => ['bool', 'xmlwriter'=>'XMLWriter', 'name'=>'string', 'content'=>'string'], 'xmlwriter_write_element_ns' => ['bool', 'xmlwriter'=>'XMLWriter', 'prefix'=>'string', 'name'=>'string', 'uri'=>'string', 'content'=>'string'], 'xmlwriter_write_pi' => ['bool', 'xmlwriter'=>'XMLWriter', 'target'=>'string', 'content'=>'string'], 'xmlwriter_write_raw' => ['bool', 'xmlwriter'=>'XMLWriter', 'content'=>'string'], ], 'old' => [ 'array_combine' => ['associative-array|false', 'keys'=>'string[]|int[]', 'values'=>'array'], 'bcdiv' => ['?string', 'dividend'=>'string', 'divisor'=>'string', 'scale='=>'int'], 'bcmod' => ['?string', 'dividend'=>'string', 'divisor'=>'string', 'scale='=>'int'], 'bcpowmod' => ['?string', 'base'=>'string', 'exponent'=>'string', 'modulus'=>'string', 'scale='=>'int'], 'ceil' => ['__benevolent<float|false>', 'number'=>'float'], 'convert_cyr_string' => ['string', 'str'=>'string', 'from'=>'string', 'to'=>'string'], 'com_load_typelib' => ['bool', 'typelib_name'=>'string', 'case_insensitive='=>'bool'], 'count_chars' => ['array<int,int>|false|string', 'input'=>'string', 'mode='=>'int'], 'curl_init' => ['__benevolent<resource|false>', 'url='=>'string'], 'date_add' => ['DateTime|false', 'object'=>'DateTime', 'interval'=>'DateInterval'], 'date_date_set' => ['DateTime|false', 'object'=>'DateTime', 'year'=>'int', 'month'=>'int', 'day'=>'int'], 'date_diff' => ['DateInterval|false', 'obj1'=>'DateTimeInterface', 'obj2'=>'DateTimeInterface', 'absolute='=>'bool'], 'date_format' => ['string|false', 'object'=>'DateTimeInterface', 'format'=>'string'], 'date_isodate_set' => ['DateTime|false', 'object'=>'DateTime', 'year'=>'int', 'week'=>'int', 'day='=>'int|mixed'], 'date_parse' => ['array<string,mixed>|false', 'date'=>'string'], 'date_sub' => ['DateTime|false', 'object'=>'DateTime', 'interval'=>'DateInterval'], 'date_sun_info' => ['__benevolent<array{sunrise: int|bool,sunset: int|bool,transit: int|bool,civil_twilight_begin: int|bool,civil_twilight_end: int|bool,nautical_twilight_begin: int|bool,nautical_twilight_end: int|bool,astronomical_twilight_begin: int|bool,astronomical_twilight_end: int|bool}|false>', 'time'=>'int', 'latitude'=>'float', 'longitude'=>'float'], 'date_time_set' => ['DateTime|false', 'object'=>'DateTime', 'hour'=>'int', 'minute'=>'int', 'second='=>'int', 'microseconds='=>'int'], 'date_timestamp_set' => ['DateTime|false', 'object'=>'DateTime', 'unixtimestamp'=>'int'], 'date_timezone_set' => ['DateTime|false', 'object'=>'DateTime', 'timezone'=>'DateTimeZone'], 'each' => ['array{0:int|string,key:int|string,1:mixed,value:mixed}', '&r_arr'=>'array'], 'ezmlm_hash' => ['int', 'addr'=>'string'], 'fgetss' => ['string|false', 'fp'=>'resource', 'length='=>'0|positive-int', 'allowable_tags='=>'string'], 'floor' => ['__benevolent<float|false>', 'number'=>'float'], 'get_magic_quotes_gpc' => ['false'], 'gmdate' => ['string|false', 'format'=>'string', 'timestamp='=>'int'], 'gmmktime' => ['int|false', 'hour='=>'int', 'minute='=>'int', 'second='=>'int', 'month='=>'int', 'day='=>'int', 'year='=>'int'], 'gmp_random' => ['GMP', 'limiter='=>'int'], 'gzgetss' => ['string|false', 'zp'=>'resource', 'length'=>'int', 'allowable_tags='=>'string'], 'hash' => ['non-falsy-string|false', 'algo'=>'string', 'data'=>'string', 'raw_output='=>'bool'], 'hash_hkdf' => ['non-falsy-string|false', 'algo'=>'string', 'key'=>'string', 'length='=>'int', 'info='=>'string', 'salt='=>'string'], 'hash_hmac' => ['non-falsy-string|false', 'algo'=>'string', 'data'=>'string', 'key'=>'string', 'raw_output='=>'bool'], 'hash_pbkdf2' => ['non-falsy-string|false', 'algo'=>'string', 'password'=>'string', 'salt'=>'string', 'iterations'=>'int', 'length='=>'int', 'raw_output='=>'bool'], 'hebrevc' => ['string', 'str'=>'string', 'max_chars_per_line='=>'int'], 'image2wbmp' => ['bool', 'im'=>'resource', 'filename='=>'?string', 'threshold='=>'int'], 'imageaffine' => ['resource|false', 'src'=>'resource', 'affine'=>'array', 'clip='=>'array'], 'imagecreate' => ['resource|false', 'x_size'=>'int', 'y_size'=>'int'], 'imagecreatefrombmp' => ['resource|false', 'filename'=>'string'], 'imagecreatefromgd' => ['resource|false', 'filename'=>'string'], 'imagecreatefromgd2' => ['resource|false', 'filename'=>'string'], 'imagecreatefromgd2part' => ['resource|false', 'filename'=>'string', 'srcx'=>'int', 'srcy'=>'int', 'width'=>'int', 'height'=>'int'], 'imagecreatefromgif' => ['resource|false', 'filename'=>'string'], 'imagecreatefromjpeg' => ['resource|false', 'filename'=>'string'], 'imagecreatefrompng' => ['resource|false', 'filename'=>'string'], 'imagecreatefromstring' => ['resource|false', 'image'=>'string'], 'imagecreatefromwbmp' => ['resource|false', 'filename'=>'string'], 'imagecreatefromwebp' => ['resource|false', 'filename'=>'string'], 'imagecreatefromxbm' => ['resource|false', 'filename'=>'string'], 'imagecreatefromxpm' => ['resource|false', 'filename'=>'string'], 'imagecreatetruecolor' => ['resource|false', 'x_size'=>'int', 'y_size'=>'int'], 'imagecrop' => ['resource|false', 'im'=>'resource', 'rect'=>'array'], 'imagecropauto' => ['resource|false', 'im'=>'resource', 'mode'=>'int', 'threshold'=>'float', 'color'=>'int'], 'imagegetclip' => ['array<int,int>|false', 'im'=>'resource'], 'imagegrabscreen' => ['false|resource'], 'imagegrabwindow' => ['false|resource', 'window_handle'=>'int', 'client_area='=>'int'], 'imagejpeg' => ['bool', 'im'=>'resource', 'filename='=>'string|resource|null', 'quality='=>'int'], 'imagerotate' => ['resource|false', 'src_im'=>'resource', 'angle'=>'float', 'bgdcolor'=>'int', 'ignoretransparent='=>'int'], 'imagescale' => ['resource|false', 'im'=>'resource', 'new_width'=>'int', 'new_height='=>'int', 'method='=>'int'], 'imap_header' => ['stdClass|false', 'stream_id'=>'resource', 'msg_no'=>'int', 'from_length='=>'int', 'subject_length='=>'int', 'default_host='=>'string'], 'implode\'1' => ['string', 'pieces'=>'array'], 'jpeg2wbmp' => ['bool', 'jpegname'=>'string', 'wbmpname'=>'string', 'dest_height'=>'int', 'dest_width'=>'int', 'threshold'=>'int'], 'ldap_control_paged_result' => ['bool', 'link_identifier'=>'resource', 'pagesize'=>'int', 'iscritical='=>'bool', 'cookie='=>'string'], 'ldap_control_paged_result_response' => ['bool', 'link_identifier'=>'resource', 'result_identifier'=>'resource', '&w_cookie='=>'string', '&w_estimated='=>'int'], 'ldap_set_rebind_proc' => ['bool', 'link_identifier'=>'resource', 'callback'=>'callable'], 'ldap_sort' => ['bool', 'link_identifier'=>'resource', 'result_identifier'=>'resource', 'sortfilter'=>'string'], 'mb_decode_numericentity' => ['string|false', 'string'=>'string', 'convmap'=>'array', 'encoding='=>'string', 'is_hex='=>'bool'], 'mb_strlen' => ['0|positive-int', 'str'=>'string', 'encoding='=>'string'], 'mktime' => ['int|false', 'hour='=>'int', 'minute='=>'int', 'second='=>'int', 'month='=>'int', 'day='=>'int', 'year='=>'int'], 'money_format' => ['string', 'format'=>'string', 'value'=>'float'], 'odbc_exec' => ['resource|false', 'connection_id'=>'resource', 'query'=>'string', 'flags='=>'int'], 'parse_str' => ['void', 'encoded_string'=>'string', '&w_result='=>'array'], 'password_hash' => ['__benevolent<non-empty-string|false|null>', 'password'=>'string', 'algo'=>'string|int', 'options='=>'array'], 'png2wbmp' => ['bool', 'pngname'=>'string', 'wbmpname'=>'string', 'dest_height'=>'int', 'dest_width'=>'int', 'threshold'=>'int'], 'proc_get_status' => ['array{command: string, pid: int, running: bool, signaled: bool, stopped: bool, exitcode: int, termsig: int, stopsig: int}|false', 'process'=>'resource'], 'read_exif_data' => ['array', 'filename'=>'string', 'sections_needed='=>'string', 'sub_arrays='=>'bool', 'read_thumbnail='=>'bool'], 'restore_include_path' => ['void'], 'round' => ['__benevolent<float|false>', 'number'=>'float', 'precision='=>'int', 'mode='=>'1|2|3|4'], 'socket_select' => ['int|false', '&w_read_fds'=>'resource[]|null', '&w_write_fds'=>'resource[]|null', '&w_except_fds'=>'resource[]|null', 'tv_sec'=>'int|null', 'tv_usec='=>'int|null'], 'sodium_crypto_aead_chacha20poly1305_ietf_decrypt' => ['?string|?false', 'confidential_message'=>'string', 'public_message'=>'string', 'nonce'=>'string', 'key'=>'string'], 'SplFileObject::fgetss' => ['string|false', 'allowable_tags='=>'string'], 'strchr' => ['string|false', 'haystack'=>'string', 'needle'=>'string|int', 'before_needle='=>'bool'], 'stripos' => ['0|positive-int|false', 'haystack'=>'string', 'needle'=>'string|int', 'offset='=>'int'], 'stristr' => ['string|false', 'haystack'=>'string', 'needle'=>'string|int', 'before_needle='=>'bool'], 'strpos' => ['int|false', 'haystack'=>'string', 'needle'=>'string|int', 'offset='=>'int'], 'strrchr' => ['string|false', 'haystack'=>'string', 'needle'=>'string|int'], 'strripos' => ['int|false', 'haystack'=>'string', 'needle'=>'string|int', 'offset='=>'int'], 'strrpos' => ['int|false', 'haystack'=>'string', 'needle'=>'string|int', 'offset='=>'int'], 'strstr' => ['string|false', 'haystack'=>'string', 'needle'=>'string|int', 'before_needle='=>'bool'], 'substr' => ['__benevolent<string|false>', 'string'=>'string', 'start'=>'int', 'length='=>'int'], 'version_compare' => ['int|bool', 'version1'=>'string', 'version2'=>'string', 'operator='=>'string|null'], 'xml_parser_create' => ['resource', 'encoding='=>'string'], 'xml_parser_create_ns' => ['resource', 'encoding='=>'string', 'sep='=>'string'], 'xml_parser_free' => ['bool', 'parser'=>'resource'], 'xml_parser_get_option' => ['mixed|false', 'parser'=>'resource', 'option'=>'int'], 'xml_parser_set_option' => ['bool', 'parser'=>'resource', 'option'=>'int', 'value'=>'mixed'], 'xmlwriter_end_attribute' => ['bool', 'xmlwriter'=>'resource'], 'xmlwriter_end_cdata' => ['bool', 'xmlwriter'=>'resource'], 'xmlwriter_end_comment' => ['bool', 'xmlwriter'=>'resource'], 'xmlwriter_end_document' => ['bool', 'xmlwriter'=>'resource'], 'xmlwriter_end_dtd' => ['bool', 'xmlwriter'=>'resource'], 'xmlwriter_end_dtd_attlist' => ['bool', 'xmlwriter'=>'resource'], 'xmlwriter_end_dtd_element' => ['bool', 'xmlwriter'=>'resource'], 'xmlwriter_end_dtd_entity' => ['bool', 'xmlwriter'=>'resource'], 'xmlwriter_end_element' => ['bool', 'xmlwriter'=>'resource'], 'xmlwriter_end_pi' => ['bool', 'xmlwriter'=>'resource'], 'xmlwriter_flush' => ['mixed', 'xmlwriter'=>'resource', 'empty='=>'bool'], 'xmlwriter_full_end_element' => ['bool', 'xmlwriter'=>'resource'], 'xmlwriter_open_memory' => ['resource'], 'xmlwriter_open_uri' => ['resource', 'source'=>'string'], 'xmlwriter_output_memory' => ['string', 'xmlwriter'=>'resource', 'flush='=>'bool'], 'xmlwriter_set_indent' => ['bool', 'xmlwriter'=>'resource', 'indent'=>'bool'], 'xmlwriter_set_indent_string' => ['bool', 'xmlwriter'=>'resource', 'indentstring'=>'string'], 'xmlwriter_start_attribute' => ['bool', 'xmlwriter'=>'resource', 'name'=>'string'], 'xmlwriter_start_attribute_ns' => ['bool', 'xmlwriter'=>'resource', 'prefix'=>'string', 'name'=>'string', 'uri'=>'string'], 'xmlwriter_start_cdata' => ['bool', 'xmlwriter'=>'resource'], 'xmlwriter_start_comment' => ['bool', 'xmlwriter'=>'resource'], 'xmlwriter_start_document' => ['bool', 'xmlwriter'=>'resource', 'version='=>'string', 'encoding='=>'string', 'standalone='=>'string'], 'xmlwriter_start_dtd' => ['bool', 'xmlwriter'=>'resource', 'name'=>'string', 'publicid='=>'string', 'sysid='=>'string'], 'xmlwriter_start_dtd_attlist' => ['bool', 'xmlwriter'=>'resource', 'name'=>'string'], 'xmlwriter_start_dtd_element' => ['bool', 'xmlwriter'=>'resource', 'name'=>'string'], 'xmlwriter_start_dtd_entity' => ['bool', 'xmlwriter'=>'resource', 'name'=>'string', 'isparam'=>'bool'], 'xmlwriter_start_element' => ['bool', 'xmlwriter'=>'resource', 'name'=>'string'], 'xmlwriter_start_element_ns' => ['bool', 'xmlwriter'=>'resource', 'prefix'=>'string', 'name'=>'string', 'uri'=>'string|null'], 'xmlwriter_start_pi' => ['bool', 'xmlwriter'=>'resource', 'target'=>'string'], 'xmlwriter_text' => ['bool', 'xmlwriter'=>'resource', 'content'=>'string'], 'xmlwriter_write_attribute' => ['bool', 'xmlwriter'=>'resource', 'name'=>'string', 'content'=>'string'], 'xmlwriter_write_attribute_ns' => ['bool', 'xmlwriter'=>'resource', 'prefix'=>'string', 'name'=>'string', 'uri'=>'string', 'content'=>'string'], 'xmlwriter_write_cdata' => ['bool', 'xmlwriter'=>'resource', 'content'=>'string'], 'xmlwriter_write_comment' => ['bool', 'xmlwriter'=>'resource', 'content'=>'string'], 'xmlwriter_write_dtd' => ['bool', 'xmlwriter'=>'resource', 'name'=>'string', 'publicid='=>'string', 'sysid='=>'string', 'subset='=>'string'], 'xmlwriter_write_dtd_attlist' => ['bool', 'xmlwriter'=>'resource', 'name'=>'string', 'content'=>'string'], 'xmlwriter_write_dtd_element' => ['bool', 'xmlwriter'=>'resource', 'name'=>'string', 'content'=>'string'], 'xmlwriter_write_dtd_entity' => ['bool', 'xmlwriter'=>'resource', 'name'=>'string', 'content'=>'string', 'pe'=>'bool', 'publicid'=>'string', 'sysid'=>'string', 'ndataid'=>'string'], 'xmlwriter_write_element' => ['bool', 'xmlwriter'=>'resource', 'name'=>'string', 'content'=>'string'], 'xmlwriter_write_element_ns' => ['bool', 'xmlwriter'=>'resource', 'prefix'=>'string', 'name'=>'string', 'uri'=>'string', 'content'=>'string'], 'xmlwriter_write_pi' => ['bool', 'xmlwriter'=>'resource', 'target'=>'string', 'content'=>'string'], 'xmlwriter_write_raw' => ['bool', 'xmlwriter'=>'resource', 'content'=>'string'], ] ]; // // Hoa // // // @license // // New BSD License // // Copyright © 2007-2017, Hoa community. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are met: // * Redistributions of source code must retain the above copyright // notice, this list of conditions and the following disclaimer. // * Redistributions in binary form must reproduce the above copyright // notice, this list of conditions and the following disclaimer in the // documentation and/or other materials provided with the distribution. // * Neither the name of the Hoa nor the names of its contributors may be // used to endorse or promote products derived from this software without // specific prior written permission. // // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" // AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE // IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE // ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE // LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR // CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF // SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS // INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN // CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) // ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE // POSSIBILITY OF SUCH DAMAGE. // // Grammar \Hoa\Regex\Grammar. // // Provide grammar of PCRE (Perl Compatible Regular Expression)for the LL(k) // parser. More informations at http://pcre.org/pcre.txt, sections pcrepattern & // pcresyntax. // // @copyright Copyright © 2007-2017 Hoa community. // @license New BSD License // // Character classes. // tokens suffixed with "fc_" are the same as without such suffix but followed by "class:_class" %token negative_class_fc_ \[\^(?=\]) -> class_fc %token class_fc_ \[(?=\]) -> class_fc %token class_fc:_class \] -> class %token negative_class_ \[\^ -> class %token class_ \[ -> class %token class:posix_class \[:\^?[a-z]+:\] %token class:class_ \[ %token class:_class \] -> default %token class:range \- // taken over from literals but class:character has \b support on top (backspace in character classes) %token class:character \\([aefnrtb]|c[\x00-\x7f]) %token class:dynamic_character \\([0-7]{3}|x[0-9a-zA-Z]{2}|x{[0-9a-zA-Z]+}) %token class:character_type \\([CdDhHNRsSvVwWX]|[pP]{[^}]+}) %token class:literal \\.|.|\n // Internal options. // See https://www.regular-expressions.info/refmodifiers.html // and https://www.php.net/manual/en/regexp.reference.internal-options.php %token internal_option \(\?[imsxnJUX^]*-?[imsxnJUX^]+\) // Lookahead and lookbehind assertions. %token lookahead_ \(\?= %token negative_lookahead_ \(\?! %token lookbehind_ \(\?<= %token negative_lookbehind_ \(\?<! // Conditions. %token named_reference_ \(\?\(< -> nc %token absolute_reference_ \(\?\((?=\d) -> c %token relative_reference_ \(\?\((?=[\+\-]) -> c %token c:index [\+\-]?\d+ -> default %token assertion_reference_ \(\?\( // Comments. %token comment_ \(\?# -> co %token co:_comment \) -> default %token co:comment .*?(?=(?<!\\)\)) // Marker verbs %token marker_ \(\*: -> mark %token mark:name [^)]+ %token mark:_marker \) -> default // Capturing group. %token named_capturing_ \(\?P?< -> nc %token nc:_named_capturing > -> default %token nc:capturing_name .+?(?=(?<!\\)>) %token non_capturing_ \(\?: %token non_capturing_internal_option \(\?[imsxnJUX^]*-?[imsxnJUX^]+: %token non_capturing_reset_ \(\?\| %token atomic_group_ \(\?> %token capturing_ \( %token _capturing \) // Quantifiers (by default, greedy). %token zero_or_one_possessive \?\+ %token zero_or_one_lazy \?\? %token zero_or_one \? %token zero_or_more_possessive \*\+ %token zero_or_more_lazy \*\? %token zero_or_more \* %token one_or_more_possessive \+\+ %token one_or_more_lazy \+\? %token one_or_more \+ %token exactly_n \{[0-9]+\} %token n_to_m_possessive \{[0-9]+,[0-9]+\}\+ %token n_to_m_lazy \{[0-9]+,[0-9]+\}\? %token n_to_m \{[0-9]+,[0-9]+\} %token n_or_more_possessive \{[0-9]+,\}\+ %token n_or_more_lazy \{[0-9]+,\}\? %token n_or_more \{[0-9]+,\} // Alternation. %token alternation \| // Literal. %token character \\([aefnrt]|c[\x00-\x7f]) %token dynamic_character \\([0-7]{3}|x[0-9a-zA-Z]{2}|x{[0-9a-zA-Z]+}) // Please, see PCRESYNTAX(3), General Category properties, PCRE special category // properties and script names for \p{} and \P{}. %token character_type \\([CdDhHNRsSvVwWX]|[pP]{[^}]+}) %token anchor \\([bBAZzG])|\^|\$ %token match_point_reset \\K %token literal \\.|.|\n // Rules. #expression: alternation() alternation: concatenation()? ( <alternation> concatenation()? #alternation )* concatenation: ( internal_options() | assertion() | quantification() | condition() ) ( ( internal_options() | assertion() | quantification() | condition() ) #concatenation )* #internal_options: <internal_option> #condition: ( ::named_reference_:: <capturing_name> ::_named_capturing:: #namedcondition | ( ::relative_reference_:: #relativecondition | ::absolute_reference_:: #absolutecondition ) <index> | ::assertion_reference_:: alternation() #assertioncondition ) ::_capturing:: alternation() ::_capturing:: assertion: ( ::lookahead_:: #lookahead | ::negative_lookahead_:: #negativelookahead | ::lookbehind_:: #lookbehind | ::negative_lookbehind_:: #negativelookbehind ) alternation() ::_capturing:: quantification: ( class() | simple() ) ( quantifier() #quantification )? quantifier: <zero_or_one_possessive> | <zero_or_one_lazy> | <zero_or_one> | <zero_or_more_possessive> | <zero_or_more_lazy> | <zero_or_more> | <one_or_more_possessive> | <one_or_more_lazy> | <one_or_more> | <exactly_n> | <n_to_m_possessive> | <n_to_m_lazy> | <n_to_m> | <n_or_more_possessive> | <n_or_more_lazy> | <n_or_more> #class: ( ::negative_class_fc_:: #negativeclass <_class> | ::class_fc_:: <_class> | ::negative_class_:: #negativeclass | ::class_:: ) <range>? ( <posix_class> | <class_> | range() <range>? | literal() )* <range>? ::_class:: #range: literal() ::range:: literal() simple: capturing() | literal() #capturing: ::marker_:: <name> ::_marker:: #mark | ::comment_:: <comment>? ::_comment:: #comment | ( ::named_capturing_:: <capturing_name> ::_named_capturing:: #namedcapturing | ::non_capturing_:: #noncapturing | non_capturing_internal_options() #noncapturing | ::non_capturing_reset_:: #noncapturingreset | ::atomic_group_:: #atomicgroup | ::capturing_:: ) alternation() ::_capturing:: non_capturing_internal_options: <non_capturing_internal_option> literal: <character> | <dynamic_character> | <character_type> | <anchor> | <match_point_reset> | <literal> <?php namespace _PHPStan_7d8742a37; // phpcs:ignoreFile /** * Copied over from https://github.com/phan/phan/blob/8866d6b98be94b37996390da226e8c4befea29aa/src/Phan/Language/Internal/FunctionSignatureMap_php80_delta.php * Copyright (c) 2015 Rasmus Lerdorf * Copyright (c) 2015 Andrew Morrison */ /** * This contains the information needed to convert the function signatures for php 8.0 to php 7.4 (and vice versa) * * This has two sections. * The 'new' section contains function/method names from FunctionSignatureMap (And alternates, if applicable) that do not exist in php7.4 or have different signatures in php 8.0. * If they were just updated, the function/method will be present in the 'added' signatures. * The 'old' signatures contains the signatures that are different in php 7.4. * Functions are expected to be removed only in major releases of php. * * @see FunctionSignatureMap.php * * @phan-file-suppress PhanPluginMixedKeyNoKey (read by Phan when analyzing this file) */ return ['new' => ['DateTime::modify' => ['static', 'modify' => 'string'], 'DateTimeImmutable::modify' => ['static', 'modify' => 'string'], 'str_decrement' => ['non-empty-string', 'string' => 'non-empty-string'], 'str_increment' => ['non-falsy-string', 'string' => 'non-empty-string'], 'gc_status' => ['array{running:bool,protected:bool,full:bool,runs:int,collected:int,threshold:int,buffer_size:int,roots:int,application_time:float,collector_time:float,destructor_time:float,free_time:float}'], 'stream_get_meta_data' => ['array{timed_out:bool,blocked:bool,eof:bool,unread_bytes:int,stream_type:string,wrapper_type:string,wrapper_data:mixed,mode:string,seekable:bool,uri:string,mediatype?:string,base64?:bool}', 'fp' => 'resource']], 'old' => []]; <?php namespace _PHPStan_7d8742a37; // phpcs:ignoreFile /** * This contains the information needed to convert the function signatures for php 8.4 to php 8.3 (and vice versa) * * This has two sections. * The 'new' section contains function/method names from FunctionSignatureMap (And alternates, if applicable) that do not exist in php8.3 or have different signatures in php 8.4. * If they were just updated, the function/method will be present in the 'added' signatures. * The 'old' signatures contains the signatures that are different in php 8.3. * Functions are expected to be removed only in major releases of php. * * @see FunctionSignatureMap.php * * @phan-file-suppress PhanPluginMixedKeyNoKey (read by Phan when analyzing this file) */ return ['new' => ['http_get_last_response_headers' => ['list<string>|null'], 'http_clear_last_response_headers' => ['void'], 'mb_lcfirst' => ['string', 'string' => 'string', 'encoding=' => 'string'], 'mb_ucfirst' => ['string', 'string' => 'string', 'encoding=' => 'string']], 'old' => []]; <?php declare(strict_types = 1); /** * GENERATED FILE - DO NOT EDIT! * * This file is generated automatically when running bin/generate-function-metadata.php * and the result is merged from bin/functionMetadata_original.php and by looking at jetbrains/phpstorm-stubs methods * and functions with the #[Pure] attribute. * * If you want to add new entries here follow these steps: * 1) verify on https://phpstan.org/try whether the entry you are going to add does not already work as expected. * 2) Contribute the functions that have 'hasSideEffects' => true as a modification to bin/functionMetadata_original.php. * 3) Contribute the #[Pure] functions without side effects to https://github.com/JetBrains/phpstorm-stubs * 4) Once the PR from 3) is merged, please update the package here and run ./bin/generate-function-metadata.php. */ return [ 'BackedEnum::from' => ['hasSideEffects' => false], 'BackedEnum::tryFrom' => ['hasSideEffects' => false], 'CURLFile::getFilename' => ['hasSideEffects' => false], 'CURLFile::getMimeType' => ['hasSideEffects' => false], 'CURLFile::getPostFilename' => ['hasSideEffects' => false], 'Cassandra\\Exception\\AlreadyExistsException::__construct' => ['hasSideEffects' => false], 'Cassandra\\Exception\\AuthenticationException::__construct' => ['hasSideEffects' => false], 'Cassandra\\Exception\\ConfigurationException::__construct' => ['hasSideEffects' => false], 'Cassandra\\Exception\\DivideByZeroException::__construct' => ['hasSideEffects' => false], 'Cassandra\\Exception\\DomainException::__construct' => ['hasSideEffects' => false], 'Cassandra\\Exception\\ExecutionException::__construct' => ['hasSideEffects' => false], 'Cassandra\\Exception\\InvalidArgumentException::__construct' => ['hasSideEffects' => false], 'Cassandra\\Exception\\InvalidQueryException::__construct' => ['hasSideEffects' => false], 'Cassandra\\Exception\\InvalidSyntaxException::__construct' => ['hasSideEffects' => false], 'Cassandra\\Exception\\IsBootstrappingException::__construct' => ['hasSideEffects' => false], 'Cassandra\\Exception\\LogicException::__construct' => ['hasSideEffects' => false], 'Cassandra\\Exception\\OverloadedException::__construct' => ['hasSideEffects' => false], 'Cassandra\\Exception\\ProtocolException::__construct' => ['hasSideEffects' => false], 'Cassandra\\Exception\\RangeException::__construct' => ['hasSideEffects' => false], 'Cassandra\\Exception\\ReadTimeoutException::__construct' => ['hasSideEffects' => false], 'Cassandra\\Exception\\RuntimeException::__construct' => ['hasSideEffects' => false], 'Cassandra\\Exception\\ServerException::__construct' => ['hasSideEffects' => false], 'Cassandra\\Exception\\TimeoutException::__construct' => ['hasSideEffects' => false], 'Cassandra\\Exception\\TruncateException::__construct' => ['hasSideEffects' => false], 'Cassandra\\Exception\\UnauthorizedException::__construct' => ['hasSideEffects' => false], 'Cassandra\\Exception\\UnavailableException::__construct' => ['hasSideEffects' => false], 'Cassandra\\Exception\\UnpreparedException::__construct' => ['hasSideEffects' => false], 'Cassandra\\Exception\\ValidationException::__construct' => ['hasSideEffects' => false], 'Cassandra\\Exception\\WriteTimeoutException::__construct' => ['hasSideEffects' => false], 'Closure::bind' => ['hasSideEffects' => false], 'Closure::bindTo' => ['hasSideEffects' => false], 'Collator::__construct' => ['hasSideEffects' => false], 'Collator::compare' => ['hasSideEffects' => false], 'Collator::getAttribute' => ['hasSideEffects' => false], 'Collator::getErrorCode' => ['hasSideEffects' => false], 'Collator::getErrorMessage' => ['hasSideEffects' => false], 'Collator::getLocale' => ['hasSideEffects' => false], 'Collator::getSortKey' => ['hasSideEffects' => false], 'Collator::getStrength' => ['hasSideEffects' => false], 'DateTime::add' => ['hasSideEffects' => true], 'DateTime::createFromFormat' => ['hasSideEffects' => false], 'DateTime::createFromImmutable' => ['hasSideEffects' => false], 'DateTime::diff' => ['hasSideEffects' => false], 'DateTime::format' => ['hasSideEffects' => false], 'DateTime::getLastErrors' => ['hasSideEffects' => false], 'DateTime::getOffset' => ['hasSideEffects' => false], 'DateTime::getTimestamp' => ['hasSideEffects' => false], 'DateTime::getTimezone' => ['hasSideEffects' => false], 'DateTime::modify' => ['hasSideEffects' => true], 'DateTime::setDate' => ['hasSideEffects' => true], 'DateTime::setISODate' => ['hasSideEffects' => true], 'DateTime::setTime' => ['hasSideEffects' => true], 'DateTime::setTimestamp' => ['hasSideEffects' => true], 'DateTime::setTimezone' => ['hasSideEffects' => true], 'DateTime::sub' => ['hasSideEffects' => true], 'DateTimeImmutable::add' => ['hasSideEffects' => false], 'DateTimeImmutable::createFromFormat' => ['hasSideEffects' => false], 'DateTimeImmutable::createFromMutable' => ['hasSideEffects' => false], 'DateTimeImmutable::diff' => ['hasSideEffects' => false], 'DateTimeImmutable::format' => ['hasSideEffects' => false], 'DateTimeImmutable::getLastErrors' => ['hasSideEffects' => false], 'DateTimeImmutable::getOffset' => ['hasSideEffects' => false], 'DateTimeImmutable::getTimestamp' => ['hasSideEffects' => false], 'DateTimeImmutable::getTimezone' => ['hasSideEffects' => false], 'DateTimeImmutable::modify' => ['hasSideEffects' => false], 'DateTimeImmutable::setDate' => ['hasSideEffects' => false], 'DateTimeImmutable::setISODate' => ['hasSideEffects' => false], 'DateTimeImmutable::setTime' => ['hasSideEffects' => false], 'DateTimeImmutable::setTimestamp' => ['hasSideEffects' => false], 'DateTimeImmutable::setTimezone' => ['hasSideEffects' => false], 'DateTimeImmutable::sub' => ['hasSideEffects' => false], 'Error::__construct' => ['hasSideEffects' => false], 'ErrorException::__construct' => ['hasSideEffects' => false], 'Event::__construct' => ['hasSideEffects' => false], 'EventBase::getFeatures' => ['hasSideEffects' => false], 'EventBase::getMethod' => ['hasSideEffects' => false], 'EventBase::getTimeOfDayCached' => ['hasSideEffects' => false], 'EventBase::gotExit' => ['hasSideEffects' => false], 'EventBase::gotStop' => ['hasSideEffects' => false], 'EventBuffer::__construct' => ['hasSideEffects' => false], 'EventBufferEvent::__construct' => ['hasSideEffects' => false], 'EventBufferEvent::getDnsErrorString' => ['hasSideEffects' => false], 'EventBufferEvent::getEnabled' => ['hasSideEffects' => false], 'EventBufferEvent::getInput' => ['hasSideEffects' => false], 'EventBufferEvent::getOutput' => ['hasSideEffects' => false], 'EventConfig::__construct' => ['hasSideEffects' => false], 'EventDnsBase::__construct' => ['hasSideEffects' => false], 'EventHttpConnection::__construct' => ['hasSideEffects' => false], 'EventHttpRequest::__construct' => ['hasSideEffects' => false], 'EventHttpRequest::getCommand' => ['hasSideEffects' => false], 'EventHttpRequest::getConnection' => ['hasSideEffects' => false], 'EventHttpRequest::getHost' => ['hasSideEffects' => false], 'EventHttpRequest::getInputBuffer' => ['hasSideEffects' => false], 'EventHttpRequest::getInputHeaders' => ['hasSideEffects' => false], 'EventHttpRequest::getOutputBuffer' => ['hasSideEffects' => false], 'EventHttpRequest::getOutputHeaders' => ['hasSideEffects' => false], 'EventHttpRequest::getResponseCode' => ['hasSideEffects' => false], 'EventHttpRequest::getUri' => ['hasSideEffects' => false], 'EventSslContext::__construct' => ['hasSideEffects' => false], 'Exception::__construct' => ['hasSideEffects' => false], 'Exception::getCode' => ['hasSideEffects' => false], 'Exception::getFile' => ['hasSideEffects' => false], 'Exception::getLine' => ['hasSideEffects' => false], 'Exception::getMessage' => ['hasSideEffects' => false], 'Exception::getPrevious' => ['hasSideEffects' => false], 'Exception::getTrace' => ['hasSideEffects' => false], 'Exception::getTraceAsString' => ['hasSideEffects' => false], 'Gmagick::getcopyright' => ['hasSideEffects' => false], 'Gmagick::getfilename' => ['hasSideEffects' => false], 'Gmagick::getimagebackgroundcolor' => ['hasSideEffects' => false], 'Gmagick::getimageblueprimary' => ['hasSideEffects' => false], 'Gmagick::getimagebordercolor' => ['hasSideEffects' => false], 'Gmagick::getimagechanneldepth' => ['hasSideEffects' => false], 'Gmagick::getimagecolors' => ['hasSideEffects' => false], 'Gmagick::getimagecolorspace' => ['hasSideEffects' => false], 'Gmagick::getimagecompose' => ['hasSideEffects' => false], 'Gmagick::getimagedelay' => ['hasSideEffects' => false], 'Gmagick::getimagedepth' => ['hasSideEffects' => false], 'Gmagick::getimagedispose' => ['hasSideEffects' => false], 'Gmagick::getimageextrema' => ['hasSideEffects' => false], 'Gmagick::getimagefilename' => ['hasSideEffects' => false], 'Gmagick::getimageformat' => ['hasSideEffects' => false], 'Gmagick::getimagegamma' => ['hasSideEffects' => false], 'Gmagick::getimagegreenprimary' => ['hasSideEffects' => false], 'Gmagick::getimageheight' => ['hasSideEffects' => false], 'Gmagick::getimagehistogram' => ['hasSideEffects' => false], 'Gmagick::getimageindex' => ['hasSideEffects' => false], 'Gmagick::getimageinterlacescheme' => ['hasSideEffects' => false], 'Gmagick::getimageiterations' => ['hasSideEffects' => false], 'Gmagick::getimagematte' => ['hasSideEffects' => false], 'Gmagick::getimagemattecolor' => ['hasSideEffects' => false], 'Gmagick::getimageprofile' => ['hasSideEffects' => false], 'Gmagick::getimageredprimary' => ['hasSideEffects' => false], 'Gmagick::getimagerenderingintent' => ['hasSideEffects' => false], 'Gmagick::getimageresolution' => ['hasSideEffects' => false], 'Gmagick::getimagescene' => ['hasSideEffects' => false], 'Gmagick::getimagesignature' => ['hasSideEffects' => false], 'Gmagick::getimagetype' => ['hasSideEffects' => false], 'Gmagick::getimageunits' => ['hasSideEffects' => false], 'Gmagick::getimagewhitepoint' => ['hasSideEffects' => false], 'Gmagick::getimagewidth' => ['hasSideEffects' => false], 'Gmagick::getpackagename' => ['hasSideEffects' => false], 'Gmagick::getquantumdepth' => ['hasSideEffects' => false], 'Gmagick::getreleasedate' => ['hasSideEffects' => false], 'Gmagick::getsamplingfactors' => ['hasSideEffects' => false], 'Gmagick::getsize' => ['hasSideEffects' => false], 'Gmagick::getversion' => ['hasSideEffects' => false], 'GmagickDraw::getfillcolor' => ['hasSideEffects' => false], 'GmagickDraw::getfillopacity' => ['hasSideEffects' => false], 'GmagickDraw::getfont' => ['hasSideEffects' => false], 'GmagickDraw::getfontsize' => ['hasSideEffects' => false], 'GmagickDraw::getfontstyle' => ['hasSideEffects' => false], 'GmagickDraw::getfontweight' => ['hasSideEffects' => false], 'GmagickDraw::getstrokecolor' => ['hasSideEffects' => false], 'GmagickDraw::getstrokeopacity' => ['hasSideEffects' => false], 'GmagickDraw::getstrokewidth' => ['hasSideEffects' => false], 'GmagickDraw::gettextdecoration' => ['hasSideEffects' => false], 'GmagickDraw::gettextencoding' => ['hasSideEffects' => false], 'GmagickPixel::getcolor' => ['hasSideEffects' => false], 'GmagickPixel::getcolorcount' => ['hasSideEffects' => false], 'GmagickPixel::getcolorvalue' => ['hasSideEffects' => false], 'HttpMessage::getBody' => ['hasSideEffects' => false], 'HttpMessage::getHeader' => ['hasSideEffects' => false], 'HttpMessage::getHeaders' => ['hasSideEffects' => false], 'HttpMessage::getHttpVersion' => ['hasSideEffects' => false], 'HttpMessage::getInfo' => ['hasSideEffects' => false], 'HttpMessage::getParentMessage' => ['hasSideEffects' => false], 'HttpMessage::getRequestMethod' => ['hasSideEffects' => false], 'HttpMessage::getRequestUrl' => ['hasSideEffects' => false], 'HttpMessage::getResponseCode' => ['hasSideEffects' => false], 'HttpMessage::getResponseStatus' => ['hasSideEffects' => false], 'HttpMessage::getType' => ['hasSideEffects' => false], 'HttpQueryString::get' => ['hasSideEffects' => false], 'HttpQueryString::getArray' => ['hasSideEffects' => false], 'HttpQueryString::getBool' => ['hasSideEffects' => false], 'HttpQueryString::getFloat' => ['hasSideEffects' => false], 'HttpQueryString::getInt' => ['hasSideEffects' => false], 'HttpQueryString::getObject' => ['hasSideEffects' => false], 'HttpQueryString::getString' => ['hasSideEffects' => false], 'HttpRequest::getBody' => ['hasSideEffects' => false], 'HttpRequest::getContentType' => ['hasSideEffects' => false], 'HttpRequest::getCookies' => ['hasSideEffects' => false], 'HttpRequest::getHeaders' => ['hasSideEffects' => false], 'HttpRequest::getHistory' => ['hasSideEffects' => false], 'HttpRequest::getMethod' => ['hasSideEffects' => false], 'HttpRequest::getOptions' => ['hasSideEffects' => false], 'HttpRequest::getPostFields' => ['hasSideEffects' => false], 'HttpRequest::getPostFiles' => ['hasSideEffects' => false], 'HttpRequest::getPutData' => ['hasSideEffects' => false], 'HttpRequest::getPutFile' => ['hasSideEffects' => false], 'HttpRequest::getQueryData' => ['hasSideEffects' => false], 'HttpRequest::getRawPostData' => ['hasSideEffects' => false], 'HttpRequest::getRawRequestMessage' => ['hasSideEffects' => false], 'HttpRequest::getRawResponseMessage' => ['hasSideEffects' => false], 'HttpRequest::getRequestMessage' => ['hasSideEffects' => false], 'HttpRequest::getResponseBody' => ['hasSideEffects' => false], 'HttpRequest::getResponseCode' => ['hasSideEffects' => false], 'HttpRequest::getResponseCookies' => ['hasSideEffects' => false], 'HttpRequest::getResponseData' => ['hasSideEffects' => false], 'HttpRequest::getResponseHeader' => ['hasSideEffects' => false], 'HttpRequest::getResponseInfo' => ['hasSideEffects' => false], 'HttpRequest::getResponseMessage' => ['hasSideEffects' => false], 'HttpRequest::getResponseStatus' => ['hasSideEffects' => false], 'HttpRequest::getSslOptions' => ['hasSideEffects' => false], 'HttpRequest::getUrl' => ['hasSideEffects' => false], 'HttpRequestPool::getAttachedRequests' => ['hasSideEffects' => false], 'HttpRequestPool::getFinishedRequests' => ['hasSideEffects' => false], 'Imagick::getColorspace' => ['hasSideEffects' => false], 'Imagick::getCompression' => ['hasSideEffects' => false], 'Imagick::getCompressionQuality' => ['hasSideEffects' => false], 'Imagick::getConfigureOptions' => ['hasSideEffects' => false], 'Imagick::getFeatures' => ['hasSideEffects' => false], 'Imagick::getFilename' => ['hasSideEffects' => false], 'Imagick::getFont' => ['hasSideEffects' => false], 'Imagick::getFormat' => ['hasSideEffects' => false], 'Imagick::getGravity' => ['hasSideEffects' => false], 'Imagick::getHDRIEnabled' => ['hasSideEffects' => false], 'Imagick::getImage' => ['hasSideEffects' => false], 'Imagick::getImageAlphaChannel' => ['hasSideEffects' => false], 'Imagick::getImageArtifact' => ['hasSideEffects' => false], 'Imagick::getImageAttribute' => ['hasSideEffects' => false], 'Imagick::getImageBackgroundColor' => ['hasSideEffects' => false], 'Imagick::getImageBlob' => ['hasSideEffects' => false], 'Imagick::getImageBluePrimary' => ['hasSideEffects' => false], 'Imagick::getImageBorderColor' => ['hasSideEffects' => false], 'Imagick::getImageChannelDepth' => ['hasSideEffects' => false], 'Imagick::getImageChannelDistortion' => ['hasSideEffects' => false], 'Imagick::getImageChannelDistortions' => ['hasSideEffects' => false], 'Imagick::getImageChannelExtrema' => ['hasSideEffects' => false], 'Imagick::getImageChannelKurtosis' => ['hasSideEffects' => false], 'Imagick::getImageChannelMean' => ['hasSideEffects' => false], 'Imagick::getImageChannelRange' => ['hasSideEffects' => false], 'Imagick::getImageChannelStatistics' => ['hasSideEffects' => false], 'Imagick::getImageClipMask' => ['hasSideEffects' => false], 'Imagick::getImageColormapColor' => ['hasSideEffects' => false], 'Imagick::getImageColors' => ['hasSideEffects' => false], 'Imagick::getImageColorspace' => ['hasSideEffects' => false], 'Imagick::getImageCompose' => ['hasSideEffects' => false], 'Imagick::getImageCompression' => ['hasSideEffects' => false], 'Imagick::getImageCompressionQuality' => ['hasSideEffects' => false], 'Imagick::getImageDelay' => ['hasSideEffects' => false], 'Imagick::getImageDepth' => ['hasSideEffects' => false], 'Imagick::getImageDispose' => ['hasSideEffects' => false], 'Imagick::getImageDistortion' => ['hasSideEffects' => false], 'Imagick::getImageExtrema' => ['hasSideEffects' => false], 'Imagick::getImageFilename' => ['hasSideEffects' => false], 'Imagick::getImageFormat' => ['hasSideEffects' => false], 'Imagick::getImageGamma' => ['hasSideEffects' => false], 'Imagick::getImageGeometry' => ['hasSideEffects' => false], 'Imagick::getImageGravity' => ['hasSideEffects' => false], 'Imagick::getImageGreenPrimary' => ['hasSideEffects' => false], 'Imagick::getImageHeight' => ['hasSideEffects' => false], 'Imagick::getImageHistogram' => ['hasSideEffects' => false], 'Imagick::getImageIndex' => ['hasSideEffects' => false], 'Imagick::getImageInterlaceScheme' => ['hasSideEffects' => false], 'Imagick::getImageInterpolateMethod' => ['hasSideEffects' => false], 'Imagick::getImageIterations' => ['hasSideEffects' => false], 'Imagick::getImageLength' => ['hasSideEffects' => false], 'Imagick::getImageMatte' => ['hasSideEffects' => false], 'Imagick::getImageMatteColor' => ['hasSideEffects' => false], 'Imagick::getImageMimeType' => ['hasSideEffects' => false], 'Imagick::getImageOrientation' => ['hasSideEffects' => false], 'Imagick::getImagePage' => ['hasSideEffects' => false], 'Imagick::getImagePixelColor' => ['hasSideEffects' => false], 'Imagick::getImageProfile' => ['hasSideEffects' => false], 'Imagick::getImageProfiles' => ['hasSideEffects' => false], 'Imagick::getImageProperties' => ['hasSideEffects' => false], 'Imagick::getImageProperty' => ['hasSideEffects' => false], 'Imagick::getImageRedPrimary' => ['hasSideEffects' => false], 'Imagick::getImageRegion' => ['hasSideEffects' => false], 'Imagick::getImageRenderingIntent' => ['hasSideEffects' => false], 'Imagick::getImageResolution' => ['hasSideEffects' => false], 'Imagick::getImageScene' => ['hasSideEffects' => false], 'Imagick::getImageSignature' => ['hasSideEffects' => false], 'Imagick::getImageSize' => ['hasSideEffects' => false], 'Imagick::getImageTicksPerSecond' => ['hasSideEffects' => false], 'Imagick::getImageTotalInkDensity' => ['hasSideEffects' => false], 'Imagick::getImageType' => ['hasSideEffects' => false], 'Imagick::getImageUnits' => ['hasSideEffects' => false], 'Imagick::getImageVirtualPixelMethod' => ['hasSideEffects' => false], 'Imagick::getImageWhitePoint' => ['hasSideEffects' => false], 'Imagick::getImageWidth' => ['hasSideEffects' => false], 'Imagick::getImagesBlob' => ['hasSideEffects' => false], 'Imagick::getInterlaceScheme' => ['hasSideEffects' => false], 'Imagick::getIteratorIndex' => ['hasSideEffects' => false], 'Imagick::getNumberImages' => ['hasSideEffects' => false], 'Imagick::getOption' => ['hasSideEffects' => false], 'Imagick::getPage' => ['hasSideEffects' => false], 'Imagick::getPixelIterator' => ['hasSideEffects' => false], 'Imagick::getPixelRegionIterator' => ['hasSideEffects' => false], 'Imagick::getPointSize' => ['hasSideEffects' => false], 'Imagick::getSamplingFactors' => ['hasSideEffects' => false], 'Imagick::getSize' => ['hasSideEffects' => false], 'Imagick::getSizeOffset' => ['hasSideEffects' => false], 'ImagickDraw::getBorderColor' => ['hasSideEffects' => false], 'ImagickDraw::getClipPath' => ['hasSideEffects' => false], 'ImagickDraw::getClipRule' => ['hasSideEffects' => false], 'ImagickDraw::getClipUnits' => ['hasSideEffects' => false], 'ImagickDraw::getDensity' => ['hasSideEffects' => false], 'ImagickDraw::getFillColor' => ['hasSideEffects' => false], 'ImagickDraw::getFillOpacity' => ['hasSideEffects' => false], 'ImagickDraw::getFillRule' => ['hasSideEffects' => false], 'ImagickDraw::getFont' => ['hasSideEffects' => false], 'ImagickDraw::getFontFamily' => ['hasSideEffects' => false], 'ImagickDraw::getFontResolution' => ['hasSideEffects' => false], 'ImagickDraw::getFontSize' => ['hasSideEffects' => false], 'ImagickDraw::getFontStretch' => ['hasSideEffects' => false], 'ImagickDraw::getFontStyle' => ['hasSideEffects' => false], 'ImagickDraw::getFontWeight' => ['hasSideEffects' => false], 'ImagickDraw::getGravity' => ['hasSideEffects' => false], 'ImagickDraw::getOpacity' => ['hasSideEffects' => false], 'ImagickDraw::getStrokeAntialias' => ['hasSideEffects' => false], 'ImagickDraw::getStrokeColor' => ['hasSideEffects' => false], 'ImagickDraw::getStrokeDashArray' => ['hasSideEffects' => false], 'ImagickDraw::getStrokeDashOffset' => ['hasSideEffects' => false], 'ImagickDraw::getStrokeLineCap' => ['hasSideEffects' => false], 'ImagickDraw::getStrokeLineJoin' => ['hasSideEffects' => false], 'ImagickDraw::getStrokeMiterLimit' => ['hasSideEffects' => false], 'ImagickDraw::getStrokeOpacity' => ['hasSideEffects' => false], 'ImagickDraw::getStrokeWidth' => ['hasSideEffects' => false], 'ImagickDraw::getTextAlignment' => ['hasSideEffects' => false], 'ImagickDraw::getTextAntialias' => ['hasSideEffects' => false], 'ImagickDraw::getTextDecoration' => ['hasSideEffects' => false], 'ImagickDraw::getTextDirection' => ['hasSideEffects' => false], 'ImagickDraw::getTextEncoding' => ['hasSideEffects' => false], 'ImagickDraw::getTextInterLineSpacing' => ['hasSideEffects' => false], 'ImagickDraw::getTextInterWordSpacing' => ['hasSideEffects' => false], 'ImagickDraw::getTextKerning' => ['hasSideEffects' => false], 'ImagickDraw::getTextUnderColor' => ['hasSideEffects' => false], 'ImagickDraw::getVectorGraphics' => ['hasSideEffects' => false], 'ImagickKernel::getMatrix' => ['hasSideEffects' => false], 'ImagickPixel::getColor' => ['hasSideEffects' => false], 'ImagickPixel::getColorAsString' => ['hasSideEffects' => false], 'ImagickPixel::getColorCount' => ['hasSideEffects' => false], 'ImagickPixel::getColorQuantum' => ['hasSideEffects' => false], 'ImagickPixel::getColorValue' => ['hasSideEffects' => false], 'ImagickPixel::getColorValueQuantum' => ['hasSideEffects' => false], 'ImagickPixel::getHSL' => ['hasSideEffects' => false], 'ImagickPixel::getIndex' => ['hasSideEffects' => false], 'ImagickPixelIterator::getCurrentIteratorRow' => ['hasSideEffects' => false], 'ImagickPixelIterator::getIteratorRow' => ['hasSideEffects' => false], 'ImagickPixelIterator::getNextIteratorRow' => ['hasSideEffects' => false], 'ImagickPixelIterator::getPreviousIteratorRow' => ['hasSideEffects' => false], 'IntBackedEnum::from' => ['hasSideEffects' => false], 'IntBackedEnum::tryFrom' => ['hasSideEffects' => false], 'IntlBreakIterator::current' => ['hasSideEffects' => false], 'IntlBreakIterator::getErrorCode' => ['hasSideEffects' => false], 'IntlBreakIterator::getErrorMessage' => ['hasSideEffects' => false], 'IntlBreakIterator::getIterator' => ['hasSideEffects' => false], 'IntlBreakIterator::getLocale' => ['hasSideEffects' => false], 'IntlBreakIterator::getPartsIterator' => ['hasSideEffects' => false], 'IntlBreakIterator::getText' => ['hasSideEffects' => false], 'IntlBreakIterator::isBoundary' => ['hasSideEffects' => false], 'IntlCalendar::after' => ['hasSideEffects' => false], 'IntlCalendar::before' => ['hasSideEffects' => false], 'IntlCalendar::equals' => ['hasSideEffects' => false], 'IntlCalendar::fieldDifference' => ['hasSideEffects' => false], 'IntlCalendar::get' => ['hasSideEffects' => false], 'IntlCalendar::getActualMaximum' => ['hasSideEffects' => false], 'IntlCalendar::getActualMinimum' => ['hasSideEffects' => false], 'IntlCalendar::getDayOfWeekType' => ['hasSideEffects' => false], 'IntlCalendar::getErrorCode' => ['hasSideEffects' => false], 'IntlCalendar::getErrorMessage' => ['hasSideEffects' => false], 'IntlCalendar::getFirstDayOfWeek' => ['hasSideEffects' => false], 'IntlCalendar::getGreatestMinimum' => ['hasSideEffects' => false], 'IntlCalendar::getLeastMaximum' => ['hasSideEffects' => false], 'IntlCalendar::getLocale' => ['hasSideEffects' => false], 'IntlCalendar::getMaximum' => ['hasSideEffects' => false], 'IntlCalendar::getMinimalDaysInFirstWeek' => ['hasSideEffects' => false], 'IntlCalendar::getMinimum' => ['hasSideEffects' => false], 'IntlCalendar::getRepeatedWallTimeOption' => ['hasSideEffects' => false], 'IntlCalendar::getSkippedWallTimeOption' => ['hasSideEffects' => false], 'IntlCalendar::getTime' => ['hasSideEffects' => false], 'IntlCalendar::getTimeZone' => ['hasSideEffects' => false], 'IntlCalendar::getType' => ['hasSideEffects' => false], 'IntlCalendar::getWeekendTransition' => ['hasSideEffects' => false], 'IntlCalendar::inDaylightTime' => ['hasSideEffects' => false], 'IntlCalendar::isEquivalentTo' => ['hasSideEffects' => false], 'IntlCalendar::isLenient' => ['hasSideEffects' => false], 'IntlCalendar::isWeekend' => ['hasSideEffects' => false], 'IntlCalendar::toDateTime' => ['hasSideEffects' => false], 'IntlChar::hasBinaryProperty' => ['hasSideEffects' => false], 'IntlCodePointBreakIterator::getLastCodePoint' => ['hasSideEffects' => false], 'IntlDateFormatter::__construct' => ['hasSideEffects' => false], 'IntlDateFormatter::getCalendar' => ['hasSideEffects' => false], 'IntlDateFormatter::getCalendarObject' => ['hasSideEffects' => false], 'IntlDateFormatter::getDateType' => ['hasSideEffects' => false], 'IntlDateFormatter::getErrorCode' => ['hasSideEffects' => false], 'IntlDateFormatter::getErrorMessage' => ['hasSideEffects' => false], 'IntlDateFormatter::getLocale' => ['hasSideEffects' => false], 'IntlDateFormatter::getPattern' => ['hasSideEffects' => false], 'IntlDateFormatter::getTimeType' => ['hasSideEffects' => false], 'IntlDateFormatter::getTimeZone' => ['hasSideEffects' => false], 'IntlDateFormatter::getTimeZoneId' => ['hasSideEffects' => false], 'IntlDateFormatter::isLenient' => ['hasSideEffects' => false], 'IntlGregorianCalendar::getGregorianChange' => ['hasSideEffects' => false], 'IntlGregorianCalendar::isLeapYear' => ['hasSideEffects' => false], 'IntlPartsIterator::getBreakIterator' => ['hasSideEffects' => false], 'IntlRuleBasedBreakIterator::__construct' => ['hasSideEffects' => false], 'IntlRuleBasedBreakIterator::getBinaryRules' => ['hasSideEffects' => false], 'IntlRuleBasedBreakIterator::getRuleStatus' => ['hasSideEffects' => false], 'IntlRuleBasedBreakIterator::getRuleStatusVec' => ['hasSideEffects' => false], 'IntlRuleBasedBreakIterator::getRules' => ['hasSideEffects' => false], 'IntlTimeZone::getDSTSavings' => ['hasSideEffects' => false], 'IntlTimeZone::getDisplayName' => ['hasSideEffects' => false], 'IntlTimeZone::getErrorCode' => ['hasSideEffects' => false], 'IntlTimeZone::getErrorMessage' => ['hasSideEffects' => false], 'IntlTimeZone::getID' => ['hasSideEffects' => false], 'IntlTimeZone::getRawOffset' => ['hasSideEffects' => false], 'IntlTimeZone::hasSameRules' => ['hasSideEffects' => false], 'IntlTimeZone::toDateTimeZone' => ['hasSideEffects' => false], 'JsonIncrementalParser::__construct' => ['hasSideEffects' => false], 'JsonIncrementalParser::get' => ['hasSideEffects' => false], 'JsonIncrementalParser::getError' => ['hasSideEffects' => false], 'MemcachedException::__construct' => ['hasSideEffects' => false], 'MessageFormatter::__construct' => ['hasSideEffects' => false], 'MessageFormatter::format' => ['hasSideEffects' => false], 'MessageFormatter::getErrorCode' => ['hasSideEffects' => false], 'MessageFormatter::getErrorMessage' => ['hasSideEffects' => false], 'MessageFormatter::getLocale' => ['hasSideEffects' => false], 'MessageFormatter::getPattern' => ['hasSideEffects' => false], 'MessageFormatter::parse' => ['hasSideEffects' => false], 'NumberFormatter::__construct' => ['hasSideEffects' => false], 'NumberFormatter::format' => ['hasSideEffects' => false], 'NumberFormatter::formatCurrency' => ['hasSideEffects' => false], 'NumberFormatter::getAttribute' => ['hasSideEffects' => false], 'NumberFormatter::getErrorCode' => ['hasSideEffects' => false], 'NumberFormatter::getErrorMessage' => ['hasSideEffects' => false], 'NumberFormatter::getLocale' => ['hasSideEffects' => false], 'NumberFormatter::getPattern' => ['hasSideEffects' => false], 'NumberFormatter::getSymbol' => ['hasSideEffects' => false], 'NumberFormatter::getTextAttribute' => ['hasSideEffects' => false], 'ReflectionAttribute::getArguments' => ['hasSideEffects' => false], 'ReflectionAttribute::getName' => ['hasSideEffects' => false], 'ReflectionAttribute::getTarget' => ['hasSideEffects' => false], 'ReflectionAttribute::isRepeated' => ['hasSideEffects' => false], 'ReflectionClass::getAttributes' => ['hasSideEffects' => false], 'ReflectionClass::getConstant' => ['hasSideEffects' => false], 'ReflectionClass::getConstants' => ['hasSideEffects' => false], 'ReflectionClass::getConstructor' => ['hasSideEffects' => false], 'ReflectionClass::getDefaultProperties' => ['hasSideEffects' => false], 'ReflectionClass::getDocComment' => ['hasSideEffects' => false], 'ReflectionClass::getEndLine' => ['hasSideEffects' => false], 'ReflectionClass::getExtension' => ['hasSideEffects' => false], 'ReflectionClass::getExtensionName' => ['hasSideEffects' => false], 'ReflectionClass::getFileName' => ['hasSideEffects' => false], 'ReflectionClass::getInterfaceNames' => ['hasSideEffects' => false], 'ReflectionClass::getInterfaces' => ['hasSideEffects' => false], 'ReflectionClass::getMethod' => ['hasSideEffects' => false], 'ReflectionClass::getMethods' => ['hasSideEffects' => false], 'ReflectionClass::getModifiers' => ['hasSideEffects' => false], 'ReflectionClass::getName' => ['hasSideEffects' => false], 'ReflectionClass::getNamespaceName' => ['hasSideEffects' => false], 'ReflectionClass::getParentClass' => ['hasSideEffects' => false], 'ReflectionClass::getProperties' => ['hasSideEffects' => false], 'ReflectionClass::getProperty' => ['hasSideEffects' => false], 'ReflectionClass::getReflectionConstant' => ['hasSideEffects' => false], 'ReflectionClass::getReflectionConstants' => ['hasSideEffects' => false], 'ReflectionClass::getShortName' => ['hasSideEffects' => false], 'ReflectionClass::getStartLine' => ['hasSideEffects' => false], 'ReflectionClass::getStaticProperties' => ['hasSideEffects' => false], 'ReflectionClass::getStaticPropertyValue' => ['hasSideEffects' => false], 'ReflectionClass::getTraitAliases' => ['hasSideEffects' => false], 'ReflectionClass::getTraitNames' => ['hasSideEffects' => false], 'ReflectionClass::getTraits' => ['hasSideEffects' => false], 'ReflectionClass::isAbstract' => ['hasSideEffects' => false], 'ReflectionClass::isAnonymous' => ['hasSideEffects' => false], 'ReflectionClass::isCloneable' => ['hasSideEffects' => false], 'ReflectionClass::isFinal' => ['hasSideEffects' => false], 'ReflectionClass::isInstance' => ['hasSideEffects' => false], 'ReflectionClass::isInstantiable' => ['hasSideEffects' => false], 'ReflectionClass::isInterface' => ['hasSideEffects' => false], 'ReflectionClass::isInternal' => ['hasSideEffects' => false], 'ReflectionClass::isIterable' => ['hasSideEffects' => false], 'ReflectionClass::isIterateable' => ['hasSideEffects' => false], 'ReflectionClass::isReadOnly' => ['hasSideEffects' => false], 'ReflectionClass::isSubclassOf' => ['hasSideEffects' => false], 'ReflectionClass::isTrait' => ['hasSideEffects' => false], 'ReflectionClass::isUserDefined' => ['hasSideEffects' => false], 'ReflectionClassConstant::getAttributes' => ['hasSideEffects' => false], 'ReflectionClassConstant::getDeclaringClass' => ['hasSideEffects' => false], 'ReflectionClassConstant::getDocComment' => ['hasSideEffects' => false], 'ReflectionClassConstant::getModifiers' => ['hasSideEffects' => false], 'ReflectionClassConstant::getName' => ['hasSideEffects' => false], 'ReflectionClassConstant::getValue' => ['hasSideEffects' => false], 'ReflectionClassConstant::isPrivate' => ['hasSideEffects' => false], 'ReflectionClassConstant::isProtected' => ['hasSideEffects' => false], 'ReflectionClassConstant::isPublic' => ['hasSideEffects' => false], 'ReflectionEnumBackedCase::getBackingValue' => ['hasSideEffects' => false], 'ReflectionEnumUnitCase::getEnum' => ['hasSideEffects' => false], 'ReflectionEnumUnitCase::getValue' => ['hasSideEffects' => false], 'ReflectionExtension::getClassNames' => ['hasSideEffects' => false], 'ReflectionExtension::getClasses' => ['hasSideEffects' => false], 'ReflectionExtension::getConstants' => ['hasSideEffects' => false], 'ReflectionExtension::getDependencies' => ['hasSideEffects' => false], 'ReflectionExtension::getFunctions' => ['hasSideEffects' => false], 'ReflectionExtension::getINIEntries' => ['hasSideEffects' => false], 'ReflectionExtension::getName' => ['hasSideEffects' => false], 'ReflectionExtension::getVersion' => ['hasSideEffects' => false], 'ReflectionExtension::isPersistent' => ['hasSideEffects' => false], 'ReflectionExtension::isTemporary' => ['hasSideEffects' => false], 'ReflectionFunction::getClosure' => ['hasSideEffects' => false], 'ReflectionFunction::isDisabled' => ['hasSideEffects' => false], 'ReflectionFunctionAbstract::getAttributes' => ['hasSideEffects' => false], 'ReflectionFunctionAbstract::getClosureCalledClass' => ['hasSideEffects' => false], 'ReflectionFunctionAbstract::getClosureScopeClass' => ['hasSideEffects' => false], 'ReflectionFunctionAbstract::getClosureThis' => ['hasSideEffects' => false], 'ReflectionFunctionAbstract::getClosureUsedVariables' => ['hasSideEffects' => false], 'ReflectionFunctionAbstract::getDocComment' => ['hasSideEffects' => false], 'ReflectionFunctionAbstract::getEndLine' => ['hasSideEffects' => false], 'ReflectionFunctionAbstract::getExtension' => ['hasSideEffects' => false], 'ReflectionFunctionAbstract::getExtensionName' => ['hasSideEffects' => false], 'ReflectionFunctionAbstract::getFileName' => ['hasSideEffects' => false], 'ReflectionFunctionAbstract::getName' => ['hasSideEffects' => false], 'ReflectionFunctionAbstract::getNamespaceName' => ['hasSideEffects' => false], 'ReflectionFunctionAbstract::getNumberOfParameters' => ['hasSideEffects' => false], 'ReflectionFunctionAbstract::getNumberOfRequiredParameters' => ['hasSideEffects' => false], 'ReflectionFunctionAbstract::getParameters' => ['hasSideEffects' => false], 'ReflectionFunctionAbstract::getReturnType' => ['hasSideEffects' => false], 'ReflectionFunctionAbstract::getShortName' => ['hasSideEffects' => false], 'ReflectionFunctionAbstract::getStartLine' => ['hasSideEffects' => false], 'ReflectionFunctionAbstract::getStaticVariables' => ['hasSideEffects' => false], 'ReflectionFunctionAbstract::getTentativeReturnType' => ['hasSideEffects' => false], 'ReflectionFunctionAbstract::hasTentativeReturnType' => ['hasSideEffects' => false], 'ReflectionFunctionAbstract::isClosure' => ['hasSideEffects' => false], 'ReflectionFunctionAbstract::isDeprecated' => ['hasSideEffects' => false], 'ReflectionFunctionAbstract::isGenerator' => ['hasSideEffects' => false], 'ReflectionFunctionAbstract::isInternal' => ['hasSideEffects' => false], 'ReflectionFunctionAbstract::isStatic' => ['hasSideEffects' => false], 'ReflectionFunctionAbstract::isUserDefined' => ['hasSideEffects' => false], 'ReflectionFunctionAbstract::isVariadic' => ['hasSideEffects' => false], 'ReflectionGenerator::getExecutingFile' => ['hasSideEffects' => false], 'ReflectionGenerator::getExecutingGenerator' => ['hasSideEffects' => false], 'ReflectionGenerator::getExecutingLine' => ['hasSideEffects' => false], 'ReflectionGenerator::getFunction' => ['hasSideEffects' => false], 'ReflectionGenerator::getThis' => ['hasSideEffects' => false], 'ReflectionGenerator::getTrace' => ['hasSideEffects' => false], 'ReflectionIntersectionType::getTypes' => ['hasSideEffects' => false], 'ReflectionMethod::getClosure' => ['hasSideEffects' => false], 'ReflectionMethod::getDeclaringClass' => ['hasSideEffects' => false], 'ReflectionMethod::getModifiers' => ['hasSideEffects' => false], 'ReflectionMethod::getPrototype' => ['hasSideEffects' => false], 'ReflectionMethod::isAbstract' => ['hasSideEffects' => false], 'ReflectionMethod::isConstructor' => ['hasSideEffects' => false], 'ReflectionMethod::isDestructor' => ['hasSideEffects' => false], 'ReflectionMethod::isFinal' => ['hasSideEffects' => false], 'ReflectionMethod::isPrivate' => ['hasSideEffects' => false], 'ReflectionMethod::isProtected' => ['hasSideEffects' => false], 'ReflectionMethod::isPublic' => ['hasSideEffects' => false], 'ReflectionMethod::isStatic' => ['hasSideEffects' => false], 'ReflectionMethod::setAccessible' => ['hasSideEffects' => false], 'ReflectionNamedType::getName' => ['hasSideEffects' => false], 'ReflectionNamedType::isBuiltin' => ['hasSideEffects' => false], 'ReflectionParameter::getAttributes' => ['hasSideEffects' => false], 'ReflectionParameter::getClass' => ['hasSideEffects' => false], 'ReflectionParameter::getDeclaringClass' => ['hasSideEffects' => false], 'ReflectionParameter::getDeclaringFunction' => ['hasSideEffects' => false], 'ReflectionParameter::getDefaultValue' => ['hasSideEffects' => false], 'ReflectionParameter::getDefaultValueConstantName' => ['hasSideEffects' => false], 'ReflectionParameter::getName' => ['hasSideEffects' => false], 'ReflectionParameter::getPosition' => ['hasSideEffects' => false], 'ReflectionParameter::getType' => ['hasSideEffects' => false], 'ReflectionParameter::isArray' => ['hasSideEffects' => false], 'ReflectionParameter::isCallable' => ['hasSideEffects' => false], 'ReflectionParameter::isDefaultValueAvailable' => ['hasSideEffects' => false], 'ReflectionParameter::isDefaultValueConstant' => ['hasSideEffects' => false], 'ReflectionParameter::isOptional' => ['hasSideEffects' => false], 'ReflectionParameter::isPassedByReference' => ['hasSideEffects' => false], 'ReflectionParameter::isPromoted' => ['hasSideEffects' => false], 'ReflectionParameter::isVariadic' => ['hasSideEffects' => false], 'ReflectionProperty::getAttributes' => ['hasSideEffects' => false], 'ReflectionProperty::getDeclaringClass' => ['hasSideEffects' => false], 'ReflectionProperty::getDefaultValue' => ['hasSideEffects' => false], 'ReflectionProperty::getDocComment' => ['hasSideEffects' => false], 'ReflectionProperty::getModifiers' => ['hasSideEffects' => false], 'ReflectionProperty::getName' => ['hasSideEffects' => false], 'ReflectionProperty::getType' => ['hasSideEffects' => false], 'ReflectionProperty::getValue' => ['hasSideEffects' => false], 'ReflectionProperty::isDefault' => ['hasSideEffects' => false], 'ReflectionProperty::isInitialized' => ['hasSideEffects' => false], 'ReflectionProperty::isPrivate' => ['hasSideEffects' => false], 'ReflectionProperty::isPromoted' => ['hasSideEffects' => false], 'ReflectionProperty::isProtected' => ['hasSideEffects' => false], 'ReflectionProperty::isPublic' => ['hasSideEffects' => false], 'ReflectionProperty::isStatic' => ['hasSideEffects' => false], 'ReflectionProperty::setAccessible' => ['hasSideEffects' => false], 'ReflectionReference::getId' => ['hasSideEffects' => false], 'ReflectionType::isBuiltin' => ['hasSideEffects' => false], 'ReflectionUnionType::getTypes' => ['hasSideEffects' => false], 'ReflectionZendExtension::getAuthor' => ['hasSideEffects' => false], 'ReflectionZendExtension::getCopyright' => ['hasSideEffects' => false], 'ReflectionZendExtension::getName' => ['hasSideEffects' => false], 'ReflectionZendExtension::getURL' => ['hasSideEffects' => false], 'ReflectionZendExtension::getVersion' => ['hasSideEffects' => false], 'ResourceBundle::__construct' => ['hasSideEffects' => false], 'ResourceBundle::count' => ['hasSideEffects' => false], 'ResourceBundle::get' => ['hasSideEffects' => false], 'ResourceBundle::getErrorCode' => ['hasSideEffects' => false], 'ResourceBundle::getErrorMessage' => ['hasSideEffects' => false], 'ResourceBundle::getIterator' => ['hasSideEffects' => false], 'SQLiteException::__construct' => ['hasSideEffects' => false], 'SimpleXMLElement::__construct' => ['hasSideEffects' => false], 'SimpleXMLElement::children' => ['hasSideEffects' => false], 'SimpleXMLElement::count' => ['hasSideEffects' => false], 'SimpleXMLElement::current' => ['hasSideEffects' => false], 'SimpleXMLElement::getChildren' => ['hasSideEffects' => false], 'SimpleXMLElement::getDocNamespaces' => ['hasSideEffects' => false], 'SimpleXMLElement::getName' => ['hasSideEffects' => false], 'SimpleXMLElement::getNamespaces' => ['hasSideEffects' => false], 'SimpleXMLElement::hasChildren' => ['hasSideEffects' => false], 'SimpleXMLElement::offsetExists' => ['hasSideEffects' => false], 'SimpleXMLElement::offsetGet' => ['hasSideEffects' => false], 'SimpleXMLElement::valid' => ['hasSideEffects' => false], 'SimpleXMLIterator::count' => ['hasSideEffects' => false], 'SimpleXMLIterator::current' => ['hasSideEffects' => false], 'SimpleXMLIterator::getChildren' => ['hasSideEffects' => false], 'SimpleXMLIterator::hasChildren' => ['hasSideEffects' => false], 'SimpleXMLIterator::valid' => ['hasSideEffects' => false], 'SoapFault::__construct' => ['hasSideEffects' => false], 'SplFileObject::fflush' => ['hasSideEffects' => true], 'SplFileObject::fgetc' => ['hasSideEffects' => true], 'SplFileObject::fgetcsv' => ['hasSideEffects' => true], 'SplFileObject::fgets' => ['hasSideEffects' => true], 'SplFileObject::fgetss' => ['hasSideEffects' => true], 'SplFileObject::fpassthru' => ['hasSideEffects' => true], 'SplFileObject::fputcsv' => ['hasSideEffects' => true], 'SplFileObject::fread' => ['hasSideEffects' => true], 'SplFileObject::fscanf' => ['hasSideEffects' => true], 'SplFileObject::fseek' => ['hasSideEffects' => true], 'SplFileObject::ftruncate' => ['hasSideEffects' => true], 'SplFileObject::fwrite' => ['hasSideEffects' => true], 'Spoofchecker::__construct' => ['hasSideEffects' => false], 'StringBackedEnum::from' => ['hasSideEffects' => false], 'StringBackedEnum::tryFrom' => ['hasSideEffects' => false], 'StubTests\\CodeStyle\\BracesOneLineFixer::getDefinition' => ['hasSideEffects' => false], 'StubTests\\Parsers\\ExpectedFunctionArgumentsInfo::__toString' => ['hasSideEffects' => false], 'StubTests\\Parsers\\Visitors\\CoreStubASTVisitor::__construct' => ['hasSideEffects' => false], 'StubTests\\StubsMetaExpectedArgumentsTest::getClassMemberFqn' => ['hasSideEffects' => false], 'StubTests\\StubsParameterNamesTest::printParameters' => ['hasSideEffects' => false], 'Transliterator::createInverse' => ['hasSideEffects' => false], 'Transliterator::getErrorCode' => ['hasSideEffects' => false], 'Transliterator::getErrorMessage' => ['hasSideEffects' => false], 'Transliterator::transliterate' => ['hasSideEffects' => false], 'UConverter::__construct' => ['hasSideEffects' => false], 'UConverter::convert' => ['hasSideEffects' => false], 'UConverter::getDestinationEncoding' => ['hasSideEffects' => false], 'UConverter::getDestinationType' => ['hasSideEffects' => false], 'UConverter::getErrorCode' => ['hasSideEffects' => false], 'UConverter::getErrorMessage' => ['hasSideEffects' => false], 'UConverter::getSourceEncoding' => ['hasSideEffects' => false], 'UConverter::getSourceType' => ['hasSideEffects' => false], 'UConverter::getStandards' => ['hasSideEffects' => false], 'UConverter::getSubstChars' => ['hasSideEffects' => false], 'UConverter::reasonText' => ['hasSideEffects' => false], 'UnitEnum::cases' => ['hasSideEffects' => false], 'WeakMap::count' => ['hasSideEffects' => false], 'WeakMap::getIterator' => ['hasSideEffects' => false], 'WeakMap::offsetExists' => ['hasSideEffects' => false], 'WeakMap::offsetGet' => ['hasSideEffects' => false], 'WeakReference::create' => ['hasSideEffects' => false], 'WeakReference::get' => ['hasSideEffects' => false], 'XmlReader::next' => ['hasSideEffects' => true], 'XmlReader::read' => ['hasSideEffects' => true], 'Zookeeper::getAcl' => ['hasSideEffects' => false], 'Zookeeper::getChildren' => ['hasSideEffects' => false], 'Zookeeper::getClientId' => ['hasSideEffects' => false], 'Zookeeper::getRecvTimeout' => ['hasSideEffects' => false], 'Zookeeper::getState' => ['hasSideEffects' => false], '_' => ['hasSideEffects' => false], 'abs' => ['hasSideEffects' => false], 'acos' => ['hasSideEffects' => false], 'acosh' => ['hasSideEffects' => false], 'addcslashes' => ['hasSideEffects' => false], 'addslashes' => ['hasSideEffects' => false], 'apache_get_modules' => ['hasSideEffects' => false], 'apache_get_version' => ['hasSideEffects' => false], 'apache_getenv' => ['hasSideEffects' => false], 'apache_request_headers' => ['hasSideEffects' => false], 'array_change_key_case' => ['hasSideEffects' => false], 'array_chunk' => ['hasSideEffects' => false], 'array_column' => ['hasSideEffects' => false], 'array_combine' => ['hasSideEffects' => false], 'array_count_values' => ['hasSideEffects' => false], 'array_diff' => ['hasSideEffects' => false], 'array_diff_assoc' => ['hasSideEffects' => false], 'array_diff_key' => ['hasSideEffects' => false], 'array_diff_uassoc' => ['hasSideEffects' => false], 'array_diff_ukey' => ['hasSideEffects' => false], 'array_fill' => ['hasSideEffects' => false], 'array_fill_keys' => ['hasSideEffects' => false], 'array_flip' => ['hasSideEffects' => false], 'array_intersect' => ['hasSideEffects' => false], 'array_intersect_assoc' => ['hasSideEffects' => false], 'array_intersect_key' => ['hasSideEffects' => false], 'array_intersect_uassoc' => ['hasSideEffects' => false], 'array_intersect_ukey' => ['hasSideEffects' => false], 'array_is_list' => ['hasSideEffects' => false], 'array_key_exists' => ['hasSideEffects' => false], 'array_key_first' => ['hasSideEffects' => false], 'array_key_last' => ['hasSideEffects' => false], 'array_keys' => ['hasSideEffects' => false], 'array_merge' => ['hasSideEffects' => false], 'array_merge_recursive' => ['hasSideEffects' => false], 'array_pad' => ['hasSideEffects' => false], 'array_pop' => ['hasSideEffects' => true], 'array_product' => ['hasSideEffects' => false], 'array_push' => ['hasSideEffects' => true], 'array_rand' => ['hasSideEffects' => false], 'array_replace' => ['hasSideEffects' => false], 'array_replace_recursive' => ['hasSideEffects' => false], 'array_reverse' => ['hasSideEffects' => false], 'array_search' => ['hasSideEffects' => false], 'array_shift' => ['hasSideEffects' => true], 'array_slice' => ['hasSideEffects' => false], 'array_sum' => ['hasSideEffects' => false], 'array_udiff' => ['hasSideEffects' => false], 'array_udiff_assoc' => ['hasSideEffects' => false], 'array_udiff_uassoc' => ['hasSideEffects' => false], 'array_uintersect' => ['hasSideEffects' => false], 'array_uintersect_assoc' => ['hasSideEffects' => false], 'array_uintersect_uassoc' => ['hasSideEffects' => false], 'array_unique' => ['hasSideEffects' => false], 'array_unshift' => ['hasSideEffects' => true], 'array_values' => ['hasSideEffects' => false], 'asin' => ['hasSideEffects' => false], 'asinh' => ['hasSideEffects' => false], 'atan' => ['hasSideEffects' => false], 'atan2' => ['hasSideEffects' => false], 'atanh' => ['hasSideEffects' => false], 'base64_decode' => ['hasSideEffects' => false], 'base64_encode' => ['hasSideEffects' => false], 'base_convert' => ['hasSideEffects' => false], 'basename' => ['hasSideEffects' => false], 'bcadd' => ['hasSideEffects' => false], 'bccomp' => ['hasSideEffects' => false], 'bcdiv' => ['hasSideEffects' => false], 'bcmod' => ['hasSideEffects' => false], 'bcmul' => ['hasSideEffects' => false], 'bcpow' => ['hasSideEffects' => false], 'bcpowmod' => ['hasSideEffects' => false], 'bcsqrt' => ['hasSideEffects' => false], 'bcsub' => ['hasSideEffects' => false], 'bin2hex' => ['hasSideEffects' => false], 'bindec' => ['hasSideEffects' => false], 'boolval' => ['hasSideEffects' => false], 'bzcompress' => ['hasSideEffects' => false], 'bzdecompress' => ['hasSideEffects' => false], 'bzerrno' => ['hasSideEffects' => false], 'bzerror' => ['hasSideEffects' => false], 'bzerrstr' => ['hasSideEffects' => false], 'bzopen' => ['hasSideEffects' => false], 'ceil' => ['hasSideEffects' => false], 'checkdate' => ['hasSideEffects' => false], 'checkdnsrr' => ['hasSideEffects' => false], 'chgrp' => ['hasSideEffects' => true], 'chmod' => ['hasSideEffects' => true], 'chop' => ['hasSideEffects' => false], 'chown' => ['hasSideEffects' => true], 'chr' => ['hasSideEffects' => false], 'chunk_split' => ['hasSideEffects' => false], 'class_implements' => ['hasSideEffects' => false], 'class_parents' => ['hasSideEffects' => false], 'cli_get_process_title' => ['hasSideEffects' => false], 'collator_compare' => ['hasSideEffects' => false], 'collator_create' => ['hasSideEffects' => false], 'collator_get_attribute' => ['hasSideEffects' => false], 'collator_get_error_code' => ['hasSideEffects' => false], 'collator_get_error_message' => ['hasSideEffects' => false], 'collator_get_locale' => ['hasSideEffects' => false], 'collator_get_sort_key' => ['hasSideEffects' => false], 'collator_get_strength' => ['hasSideEffects' => false], 'compact' => ['hasSideEffects' => false], 'connection_aborted' => ['hasSideEffects' => true], 'connection_status' => ['hasSideEffects' => true], 'constant' => ['hasSideEffects' => false], 'convert_cyr_string' => ['hasSideEffects' => false], 'convert_uudecode' => ['hasSideEffects' => false], 'convert_uuencode' => ['hasSideEffects' => false], 'copy' => ['hasSideEffects' => true], 'cos' => ['hasSideEffects' => false], 'cosh' => ['hasSideEffects' => false], 'count' => ['hasSideEffects' => false], 'count_chars' => ['hasSideEffects' => false], 'crc32' => ['hasSideEffects' => false], 'crypt' => ['hasSideEffects' => false], 'ctype_alnum' => ['hasSideEffects' => false], 'ctype_alpha' => ['hasSideEffects' => false], 'ctype_cntrl' => ['hasSideEffects' => false], 'ctype_digit' => ['hasSideEffects' => false], 'ctype_graph' => ['hasSideEffects' => false], 'ctype_lower' => ['hasSideEffects' => false], 'ctype_print' => ['hasSideEffects' => false], 'ctype_punct' => ['hasSideEffects' => false], 'ctype_space' => ['hasSideEffects' => false], 'ctype_upper' => ['hasSideEffects' => false], 'ctype_xdigit' => ['hasSideEffects' => false], 'curl_copy_handle' => ['hasSideEffects' => false], 'curl_errno' => ['hasSideEffects' => false], 'curl_error' => ['hasSideEffects' => false], 'curl_escape' => ['hasSideEffects' => false], 'curl_file_create' => ['hasSideEffects' => false], 'curl_getinfo' => ['hasSideEffects' => false], 'curl_multi_errno' => ['hasSideEffects' => false], 'curl_multi_getcontent' => ['hasSideEffects' => false], 'curl_multi_info_read' => ['hasSideEffects' => false], 'curl_share_errno' => ['hasSideEffects' => false], 'curl_share_strerror' => ['hasSideEffects' => false], 'curl_strerror' => ['hasSideEffects' => false], 'curl_unescape' => ['hasSideEffects' => false], 'curl_version' => ['hasSideEffects' => false], 'current' => ['hasSideEffects' => false], 'date' => ['hasSideEffects' => false], 'date_create' => ['hasSideEffects' => false], 'date_create_from_format' => ['hasSideEffects' => false], 'date_create_immutable' => ['hasSideEffects' => false], 'date_create_immutable_from_format' => ['hasSideEffects' => false], 'date_default_timezone_get' => ['hasSideEffects' => false], 'date_diff' => ['hasSideEffects' => false], 'date_format' => ['hasSideEffects' => false], 'date_get_last_errors' => ['hasSideEffects' => false], 'date_interval_create_from_date_string' => ['hasSideEffects' => false], 'date_interval_format' => ['hasSideEffects' => false], 'date_offset_get' => ['hasSideEffects' => false], 'date_parse' => ['hasSideEffects' => false], 'date_parse_from_format' => ['hasSideEffects' => false], 'date_sun_info' => ['hasSideEffects' => false], 'date_sunrise' => ['hasSideEffects' => false], 'date_sunset' => ['hasSideEffects' => false], 'date_timestamp_get' => ['hasSideEffects' => false], 'date_timezone_get' => ['hasSideEffects' => false], 'datefmt_create' => ['hasSideEffects' => false], 'datefmt_format' => ['hasSideEffects' => false], 'datefmt_format_object' => ['hasSideEffects' => false], 'datefmt_get_calendar' => ['hasSideEffects' => false], 'datefmt_get_calendar_object' => ['hasSideEffects' => false], 'datefmt_get_datetype' => ['hasSideEffects' => false], 'datefmt_get_error_code' => ['hasSideEffects' => false], 'datefmt_get_error_message' => ['hasSideEffects' => false], 'datefmt_get_locale' => ['hasSideEffects' => false], 'datefmt_get_pattern' => ['hasSideEffects' => false], 'datefmt_get_timetype' => ['hasSideEffects' => false], 'datefmt_get_timezone' => ['hasSideEffects' => false], 'datefmt_get_timezone_id' => ['hasSideEffects' => false], 'datefmt_is_lenient' => ['hasSideEffects' => false], 'dcngettext' => ['hasSideEffects' => false], 'decbin' => ['hasSideEffects' => false], 'dechex' => ['hasSideEffects' => false], 'decoct' => ['hasSideEffects' => false], 'defined' => ['hasSideEffects' => false], 'deflate_init' => ['hasSideEffects' => false], 'deg2rad' => ['hasSideEffects' => false], 'dirname' => ['hasSideEffects' => false], 'disk_free_space' => ['hasSideEffects' => false], 'disk_total_space' => ['hasSideEffects' => false], 'diskfreespace' => ['hasSideEffects' => false], 'dngettext' => ['hasSideEffects' => false], 'doubleval' => ['hasSideEffects' => false], 'error_get_last' => ['hasSideEffects' => false], 'error_log' => ['hasSideEffects' => true], 'escapeshellarg' => ['hasSideEffects' => false], 'escapeshellcmd' => ['hasSideEffects' => false], 'exp' => ['hasSideEffects' => false], 'explode' => ['hasSideEffects' => false], 'expm1' => ['hasSideEffects' => false], 'extension_loaded' => ['hasSideEffects' => false], 'fclose' => ['hasSideEffects' => true], 'fdiv' => ['hasSideEffects' => false], 'feof' => ['hasSideEffects' => false], 'fflush' => ['hasSideEffects' => true], 'fgetc' => ['hasSideEffects' => true], 'fgetcsv' => ['hasSideEffects' => true], 'fgets' => ['hasSideEffects' => true], 'fgetss' => ['hasSideEffects' => true], 'file' => ['hasSideEffects' => false], 'file_exists' => ['hasSideEffects' => false], 'file_get_contents' => ['hasSideEffects' => true], 'file_put_contents' => ['hasSideEffects' => true], 'fileatime' => ['hasSideEffects' => false], 'filectime' => ['hasSideEffects' => false], 'filegroup' => ['hasSideEffects' => false], 'fileinode' => ['hasSideEffects' => false], 'filemtime' => ['hasSideEffects' => false], 'fileowner' => ['hasSideEffects' => false], 'fileperms' => ['hasSideEffects' => false], 'filesize' => ['hasSideEffects' => false], 'filetype' => ['hasSideEffects' => false], 'filter_has_var' => ['hasSideEffects' => false], 'filter_id' => ['hasSideEffects' => false], 'filter_input' => ['hasSideEffects' => false], 'filter_input_array' => ['hasSideEffects' => false], 'filter_list' => ['hasSideEffects' => false], 'filter_var' => ['hasSideEffects' => false], 'filter_var_array' => ['hasSideEffects' => false], 'finfo::buffer' => ['hasSideEffects' => false], 'finfo::file' => ['hasSideEffects' => false], 'floatval' => ['hasSideEffects' => false], 'flock' => ['hasSideEffects' => true], 'floor' => ['hasSideEffects' => false], 'fmod' => ['hasSideEffects' => false], 'fnmatch' => ['hasSideEffects' => false], 'fopen' => ['hasSideEffects' => true], 'fpassthru' => ['hasSideEffects' => true], 'fputcsv' => ['hasSideEffects' => true], 'fputs' => ['hasSideEffects' => true], 'fread' => ['hasSideEffects' => true], 'fscanf' => ['hasSideEffects' => true], 'fseek' => ['hasSideEffects' => true], 'fstat' => ['hasSideEffects' => false], 'ftell' => ['hasSideEffects' => false], 'ftok' => ['hasSideEffects' => false], 'ftruncate' => ['hasSideEffects' => true], 'func_get_arg' => ['hasSideEffects' => false], 'func_get_args' => ['hasSideEffects' => false], 'func_num_args' => ['hasSideEffects' => false], 'function_exists' => ['hasSideEffects' => false], 'fwrite' => ['hasSideEffects' => true], 'gc_enabled' => ['hasSideEffects' => false], 'gc_status' => ['hasSideEffects' => false], 'gd_info' => ['hasSideEffects' => false], 'geoip_continent_code_by_name' => ['hasSideEffects' => false], 'geoip_country_code3_by_name' => ['hasSideEffects' => false], 'geoip_country_code_by_name' => ['hasSideEffects' => false], 'geoip_country_name_by_name' => ['hasSideEffects' => false], 'geoip_database_info' => ['hasSideEffects' => false], 'geoip_db_avail' => ['hasSideEffects' => false], 'geoip_db_filename' => ['hasSideEffects' => false], 'geoip_db_get_all_info' => ['hasSideEffects' => false], 'geoip_id_by_name' => ['hasSideEffects' => false], 'geoip_isp_by_name' => ['hasSideEffects' => false], 'geoip_org_by_name' => ['hasSideEffects' => false], 'geoip_record_by_name' => ['hasSideEffects' => false], 'geoip_region_by_name' => ['hasSideEffects' => false], 'geoip_region_name_by_code' => ['hasSideEffects' => false], 'geoip_time_zone_by_country_and_region' => ['hasSideEffects' => false], 'get_browser' => ['hasSideEffects' => false], 'get_called_class' => ['hasSideEffects' => false], 'get_cfg_var' => ['hasSideEffects' => false], 'get_class' => ['hasSideEffects' => false], 'get_class_methods' => ['hasSideEffects' => false], 'get_class_vars' => ['hasSideEffects' => false], 'get_current_user' => ['hasSideEffects' => false], 'get_debug_type' => ['hasSideEffects' => false], 'get_declared_classes' => ['hasSideEffects' => false], 'get_declared_interfaces' => ['hasSideEffects' => false], 'get_declared_traits' => ['hasSideEffects' => false], 'get_defined_constants' => ['hasSideEffects' => false], 'get_defined_functions' => ['hasSideEffects' => false], 'get_defined_vars' => ['hasSideEffects' => false], 'get_extension_funcs' => ['hasSideEffects' => false], 'get_headers' => ['hasSideEffects' => false], 'get_html_translation_table' => ['hasSideEffects' => false], 'get_include_path' => ['hasSideEffects' => false], 'get_included_files' => ['hasSideEffects' => false], 'get_loaded_extensions' => ['hasSideEffects' => false], 'get_meta_tags' => ['hasSideEffects' => false], 'get_object_vars' => ['hasSideEffects' => false], 'get_parent_class' => ['hasSideEffects' => false], 'get_required_files' => ['hasSideEffects' => false], 'get_resource_id' => ['hasSideEffects' => false], 'get_resources' => ['hasSideEffects' => false], 'getallheaders' => ['hasSideEffects' => false], 'getcwd' => ['hasSideEffects' => false], 'getdate' => ['hasSideEffects' => false], 'getenv' => ['hasSideEffects' => false], 'gethostbyaddr' => ['hasSideEffects' => false], 'gethostbyname' => ['hasSideEffects' => false], 'gethostbynamel' => ['hasSideEffects' => false], 'gethostname' => ['hasSideEffects' => false], 'getlastmod' => ['hasSideEffects' => false], 'getmygid' => ['hasSideEffects' => false], 'getmyinode' => ['hasSideEffects' => false], 'getmypid' => ['hasSideEffects' => false], 'getmyuid' => ['hasSideEffects' => false], 'getprotobyname' => ['hasSideEffects' => false], 'getprotobynumber' => ['hasSideEffects' => false], 'getrandmax' => ['hasSideEffects' => false], 'getrusage' => ['hasSideEffects' => false], 'getservbyname' => ['hasSideEffects' => false], 'getservbyport' => ['hasSideEffects' => false], 'gettext' => ['hasSideEffects' => false], 'gettimeofday' => ['hasSideEffects' => false], 'gettype' => ['hasSideEffects' => false], 'glob' => ['hasSideEffects' => false], 'gmdate' => ['hasSideEffects' => false], 'gmmktime' => ['hasSideEffects' => false], 'gmp_abs' => ['hasSideEffects' => false], 'gmp_add' => ['hasSideEffects' => false], 'gmp_and' => ['hasSideEffects' => false], 'gmp_binomial' => ['hasSideEffects' => false], 'gmp_cmp' => ['hasSideEffects' => false], 'gmp_com' => ['hasSideEffects' => false], 'gmp_div' => ['hasSideEffects' => false], 'gmp_div_q' => ['hasSideEffects' => false], 'gmp_div_qr' => ['hasSideEffects' => false], 'gmp_div_r' => ['hasSideEffects' => false], 'gmp_divexact' => ['hasSideEffects' => false], 'gmp_export' => ['hasSideEffects' => false], 'gmp_fact' => ['hasSideEffects' => false], 'gmp_gcd' => ['hasSideEffects' => false], 'gmp_gcdext' => ['hasSideEffects' => false], 'gmp_hamdist' => ['hasSideEffects' => false], 'gmp_import' => ['hasSideEffects' => false], 'gmp_init' => ['hasSideEffects' => false], 'gmp_intval' => ['hasSideEffects' => false], 'gmp_invert' => ['hasSideEffects' => false], 'gmp_jacobi' => ['hasSideEffects' => false], 'gmp_kronecker' => ['hasSideEffects' => false], 'gmp_lcm' => ['hasSideEffects' => false], 'gmp_legendre' => ['hasSideEffects' => false], 'gmp_mod' => ['hasSideEffects' => false], 'gmp_mul' => ['hasSideEffects' => false], 'gmp_neg' => ['hasSideEffects' => false], 'gmp_nextprime' => ['hasSideEffects' => false], 'gmp_or' => ['hasSideEffects' => false], 'gmp_perfect_power' => ['hasSideEffects' => false], 'gmp_perfect_square' => ['hasSideEffects' => false], 'gmp_popcount' => ['hasSideEffects' => false], 'gmp_pow' => ['hasSideEffects' => false], 'gmp_powm' => ['hasSideEffects' => false], 'gmp_prob_prime' => ['hasSideEffects' => false], 'gmp_root' => ['hasSideEffects' => false], 'gmp_rootrem' => ['hasSideEffects' => false], 'gmp_scan0' => ['hasSideEffects' => false], 'gmp_scan1' => ['hasSideEffects' => false], 'gmp_sign' => ['hasSideEffects' => false], 'gmp_sqrt' => ['hasSideEffects' => false], 'gmp_sqrtrem' => ['hasSideEffects' => false], 'gmp_strval' => ['hasSideEffects' => false], 'gmp_sub' => ['hasSideEffects' => false], 'gmp_testbit' => ['hasSideEffects' => false], 'gmp_xor' => ['hasSideEffects' => false], 'grapheme_stripos' => ['hasSideEffects' => false], 'grapheme_stristr' => ['hasSideEffects' => false], 'grapheme_strlen' => ['hasSideEffects' => false], 'grapheme_strpos' => ['hasSideEffects' => false], 'grapheme_strripos' => ['hasSideEffects' => false], 'grapheme_strrpos' => ['hasSideEffects' => false], 'grapheme_strstr' => ['hasSideEffects' => false], 'grapheme_substr' => ['hasSideEffects' => false], 'gzcompress' => ['hasSideEffects' => false], 'gzdecode' => ['hasSideEffects' => false], 'gzdeflate' => ['hasSideEffects' => false], 'gzencode' => ['hasSideEffects' => false], 'gzinflate' => ['hasSideEffects' => false], 'gzuncompress' => ['hasSideEffects' => false], 'hash' => ['hasSideEffects' => false], 'hash_algos' => ['hasSideEffects' => false], 'hash_copy' => ['hasSideEffects' => false], 'hash_equals' => ['hasSideEffects' => false], 'hash_file' => ['hasSideEffects' => false], 'hash_hkdf' => ['hasSideEffects' => false], 'hash_hmac' => ['hasSideEffects' => false], 'hash_hmac_algos' => ['hasSideEffects' => false], 'hash_hmac_file' => ['hasSideEffects' => false], 'hash_init' => ['hasSideEffects' => false], 'hash_pbkdf2' => ['hasSideEffects' => false], 'headers_list' => ['hasSideEffects' => false], 'hebrev' => ['hasSideEffects' => false], 'hexdec' => ['hasSideEffects' => false], 'hrtime' => ['hasSideEffects' => false], 'html_entity_decode' => ['hasSideEffects' => false], 'htmlentities' => ['hasSideEffects' => false], 'htmlspecialchars' => ['hasSideEffects' => false], 'htmlspecialchars_decode' => ['hasSideEffects' => false], 'http_build_cookie' => ['hasSideEffects' => false], 'http_build_query' => ['hasSideEffects' => false], 'http_build_str' => ['hasSideEffects' => false], 'http_cache_etag' => ['hasSideEffects' => false], 'http_cache_last_modified' => ['hasSideEffects' => false], 'http_chunked_decode' => ['hasSideEffects' => false], 'http_date' => ['hasSideEffects' => false], 'http_deflate' => ['hasSideEffects' => false], 'http_get_request_body' => ['hasSideEffects' => false], 'http_get_request_body_stream' => ['hasSideEffects' => false], 'http_get_request_headers' => ['hasSideEffects' => false], 'http_inflate' => ['hasSideEffects' => false], 'http_match_etag' => ['hasSideEffects' => false], 'http_match_modified' => ['hasSideEffects' => false], 'http_match_request_header' => ['hasSideEffects' => false], 'http_parse_cookie' => ['hasSideEffects' => false], 'http_parse_headers' => ['hasSideEffects' => false], 'http_parse_message' => ['hasSideEffects' => false], 'http_parse_params' => ['hasSideEffects' => false], 'http_request_body_encode' => ['hasSideEffects' => false], 'http_request_method_exists' => ['hasSideEffects' => false], 'http_request_method_name' => ['hasSideEffects' => false], 'http_support' => ['hasSideEffects' => false], 'hypot' => ['hasSideEffects' => false], 'iconv' => ['hasSideEffects' => false], 'iconv_get_encoding' => ['hasSideEffects' => false], 'iconv_mime_decode' => ['hasSideEffects' => false], 'iconv_mime_decode_headers' => ['hasSideEffects' => false], 'iconv_mime_encode' => ['hasSideEffects' => false], 'iconv_strlen' => ['hasSideEffects' => false], 'iconv_strpos' => ['hasSideEffects' => false], 'iconv_strrpos' => ['hasSideEffects' => false], 'iconv_substr' => ['hasSideEffects' => false], 'idate' => ['hasSideEffects' => false], 'image_type_to_extension' => ['hasSideEffects' => false], 'image_type_to_mime_type' => ['hasSideEffects' => false], 'imagecolorat' => ['hasSideEffects' => false], 'imagecolorclosest' => ['hasSideEffects' => false], 'imagecolorclosestalpha' => ['hasSideEffects' => false], 'imagecolorclosesthwb' => ['hasSideEffects' => false], 'imagecolorexact' => ['hasSideEffects' => false], 'imagecolorexactalpha' => ['hasSideEffects' => false], 'imagecolorresolve' => ['hasSideEffects' => false], 'imagecolorresolvealpha' => ['hasSideEffects' => false], 'imagecolorsforindex' => ['hasSideEffects' => false], 'imagecolorstotal' => ['hasSideEffects' => false], 'imagecreate' => ['hasSideEffects' => false], 'imagecreatefromstring' => ['hasSideEffects' => false], 'imagecreatetruecolor' => ['hasSideEffects' => false], 'imagefontheight' => ['hasSideEffects' => false], 'imagefontwidth' => ['hasSideEffects' => false], 'imageftbbox' => ['hasSideEffects' => false], 'imagegetinterpolation' => ['hasSideEffects' => false], 'imagegrabscreen' => ['hasSideEffects' => false], 'imagegrabwindow' => ['hasSideEffects' => false], 'imageistruecolor' => ['hasSideEffects' => false], 'imagesx' => ['hasSideEffects' => false], 'imagesy' => ['hasSideEffects' => false], 'imagettfbbox' => ['hasSideEffects' => false], 'imagetypes' => ['hasSideEffects' => false], 'implode' => ['hasSideEffects' => false], 'in_array' => ['hasSideEffects' => false], 'inet_ntop' => ['hasSideEffects' => false], 'inet_pton' => ['hasSideEffects' => false], 'inflate_get_read_len' => ['hasSideEffects' => false], 'inflate_get_status' => ['hasSideEffects' => false], 'inflate_init' => ['hasSideEffects' => false], 'ini_get' => ['hasSideEffects' => false], 'ini_get_all' => ['hasSideEffects' => false], 'intcal_get_maximum' => ['hasSideEffects' => false], 'intdiv' => ['hasSideEffects' => false], 'intl_error_name' => ['hasSideEffects' => false], 'intl_get' => ['hasSideEffects' => false], 'intl_get_error_code' => ['hasSideEffects' => false], 'intl_get_error_message' => ['hasSideEffects' => false], 'intl_is_failure' => ['hasSideEffects' => false], 'intlcal_after' => ['hasSideEffects' => false], 'intlcal_before' => ['hasSideEffects' => false], 'intlcal_create_instance' => ['hasSideEffects' => false], 'intlcal_equals' => ['hasSideEffects' => false], 'intlcal_field_difference' => ['hasSideEffects' => false], 'intlcal_from_date_time' => ['hasSideEffects' => false], 'intlcal_get' => ['hasSideEffects' => false], 'intlcal_get_actual_maximum' => ['hasSideEffects' => false], 'intlcal_get_actual_minimum' => ['hasSideEffects' => false], 'intlcal_get_available_locales' => ['hasSideEffects' => false], 'intlcal_get_day_of_week_type' => ['hasSideEffects' => false], 'intlcal_get_error_code' => ['hasSideEffects' => false], 'intlcal_get_error_message' => ['hasSideEffects' => false], 'intlcal_get_first_day_of_week' => ['hasSideEffects' => false], 'intlcal_get_greatest_minimum' => ['hasSideEffects' => false], 'intlcal_get_keyword_values_for_locale' => ['hasSideEffects' => false], 'intlcal_get_least_maximum' => ['hasSideEffects' => false], 'intlcal_get_locale' => ['hasSideEffects' => false], 'intlcal_get_maximum' => ['hasSideEffects' => false], 'intlcal_get_minimal_days_in_first_week' => ['hasSideEffects' => false], 'intlcal_get_minimum' => ['hasSideEffects' => false], 'intlcal_get_now' => ['hasSideEffects' => false], 'intlcal_get_repeated_wall_time_option' => ['hasSideEffects' => false], 'intlcal_get_skipped_wall_time_option' => ['hasSideEffects' => false], 'intlcal_get_time' => ['hasSideEffects' => false], 'intlcal_get_time_zone' => ['hasSideEffects' => false], 'intlcal_get_type' => ['hasSideEffects' => false], 'intlcal_get_weekend_transition' => ['hasSideEffects' => false], 'intlcal_greates_minimum' => ['hasSideEffects' => false], 'intlcal_in_daylight_time' => ['hasSideEffects' => false], 'intlcal_is_equivalent_to' => ['hasSideEffects' => false], 'intlcal_is_lenient' => ['hasSideEffects' => false], 'intlcal_is_set' => ['hasSideEffects' => false], 'intlcal_is_weekend' => ['hasSideEffects' => false], 'intlcal_to_date_time' => ['hasSideEffects' => false], 'intlgregcal_create_instance' => ['hasSideEffects' => false], 'intlgregcal_get_gregorian_change' => ['hasSideEffects' => false], 'intlgregcal_is_leap_year' => ['hasSideEffects' => false], 'intltz_count_equivalent_ids' => ['hasSideEffects' => false], 'intltz_create_default' => ['hasSideEffects' => false], 'intltz_create_enumeration' => ['hasSideEffects' => false], 'intltz_create_time_zone' => ['hasSideEffects' => false], 'intltz_create_time_zone_id_enumeration' => ['hasSideEffects' => false], 'intltz_from_date_time_zone' => ['hasSideEffects' => false], 'intltz_get_canonical_id' => ['hasSideEffects' => false], 'intltz_get_display_name' => ['hasSideEffects' => false], 'intltz_get_dst_savings' => ['hasSideEffects' => false], 'intltz_get_equivalent_id' => ['hasSideEffects' => false], 'intltz_get_error_code' => ['hasSideEffects' => false], 'intltz_get_error_message' => ['hasSideEffects' => false], 'intltz_get_gmt' => ['hasSideEffects' => false], 'intltz_get_id' => ['hasSideEffects' => false], 'intltz_get_offset' => ['hasSideEffects' => false], 'intltz_get_raw_offset' => ['hasSideEffects' => false], 'intltz_get_region' => ['hasSideEffects' => false], 'intltz_get_tz_data_version' => ['hasSideEffects' => false], 'intltz_get_unknown' => ['hasSideEffects' => false], 'intltz_getgmt' => ['hasSideEffects' => false], 'intltz_has_same_rules' => ['hasSideEffects' => false], 'intltz_to_date_time_zone' => ['hasSideEffects' => false], 'intltz_use_daylight_time' => ['hasSideEffects' => false], 'intlz_create_default' => ['hasSideEffects' => false], 'intval' => ['hasSideEffects' => false], 'ip2long' => ['hasSideEffects' => false], 'iptcparse' => ['hasSideEffects' => false], 'is_a' => ['hasSideEffects' => false], 'is_array' => ['hasSideEffects' => false], 'is_bool' => ['hasSideEffects' => false], 'is_countable' => ['hasSideEffects' => false], 'is_dir' => ['hasSideEffects' => false], 'is_double' => ['hasSideEffects' => false], 'is_executable' => ['hasSideEffects' => false], 'is_file' => ['hasSideEffects' => false], 'is_finite' => ['hasSideEffects' => false], 'is_float' => ['hasSideEffects' => false], 'is_infinite' => ['hasSideEffects' => false], 'is_int' => ['hasSideEffects' => false], 'is_integer' => ['hasSideEffects' => false], 'is_iterable' => ['hasSideEffects' => false], 'is_link' => ['hasSideEffects' => false], 'is_long' => ['hasSideEffects' => false], 'is_nan' => ['hasSideEffects' => false], 'is_null' => ['hasSideEffects' => false], 'is_numeric' => ['hasSideEffects' => false], 'is_object' => ['hasSideEffects' => false], 'is_readable' => ['hasSideEffects' => false], 'is_real' => ['hasSideEffects' => false], 'is_resource' => ['hasSideEffects' => false], 'is_scalar' => ['hasSideEffects' => false], 'is_string' => ['hasSideEffects' => false], 'is_subclass_of' => ['hasSideEffects' => false], 'is_uploaded_file' => ['hasSideEffects' => false], 'is_writable' => ['hasSideEffects' => false], 'is_writeable' => ['hasSideEffects' => false], 'iterator_count' => ['hasSideEffects' => false], 'join' => ['hasSideEffects' => false], 'json_last_error' => ['hasSideEffects' => false], 'json_last_error_msg' => ['hasSideEffects' => false], 'json_validate' => ['hasSideEffects' => false], 'key' => ['hasSideEffects' => false], 'key_exists' => ['hasSideEffects' => false], 'lcfirst' => ['hasSideEffects' => false], 'lchgrp' => ['hasSideEffects' => true], 'lchown' => ['hasSideEffects' => true], 'libxml_get_errors' => ['hasSideEffects' => false], 'libxml_get_last_error' => ['hasSideEffects' => false], 'link' => ['hasSideEffects' => true], 'linkinfo' => ['hasSideEffects' => false], 'locale_accept_from_http' => ['hasSideEffects' => false], 'locale_canonicalize' => ['hasSideEffects' => false], 'locale_compose' => ['hasSideEffects' => false], 'locale_filter_matches' => ['hasSideEffects' => false], 'locale_get_all_variants' => ['hasSideEffects' => false], 'locale_get_default' => ['hasSideEffects' => false], 'locale_get_display_language' => ['hasSideEffects' => false], 'locale_get_display_name' => ['hasSideEffects' => false], 'locale_get_display_region' => ['hasSideEffects' => false], 'locale_get_display_script' => ['hasSideEffects' => false], 'locale_get_display_variant' => ['hasSideEffects' => false], 'locale_get_keywords' => ['hasSideEffects' => false], 'locale_get_primary_language' => ['hasSideEffects' => false], 'locale_get_region' => ['hasSideEffects' => false], 'locale_get_script' => ['hasSideEffects' => false], 'locale_lookup' => ['hasSideEffects' => false], 'locale_parse' => ['hasSideEffects' => false], 'localeconv' => ['hasSideEffects' => false], 'localtime' => ['hasSideEffects' => false], 'log' => ['hasSideEffects' => false], 'log10' => ['hasSideEffects' => false], 'log1p' => ['hasSideEffects' => false], 'long2ip' => ['hasSideEffects' => false], 'lstat' => ['hasSideEffects' => false], 'ltrim' => ['hasSideEffects' => false], 'max' => ['hasSideEffects' => false], 'mb_check_encoding' => ['hasSideEffects' => false], 'mb_chr' => ['hasSideEffects' => false], 'mb_convert_case' => ['hasSideEffects' => false], 'mb_convert_encoding' => ['hasSideEffects' => false], 'mb_convert_kana' => ['hasSideEffects' => false], 'mb_decode_mimeheader' => ['hasSideEffects' => false], 'mb_decode_numericentity' => ['hasSideEffects' => false], 'mb_detect_encoding' => ['hasSideEffects' => false], 'mb_encode_mimeheader' => ['hasSideEffects' => false], 'mb_encode_numericentity' => ['hasSideEffects' => false], 'mb_encoding_aliases' => ['hasSideEffects' => false], 'mb_ereg_match' => ['hasSideEffects' => false], 'mb_ereg_replace' => ['hasSideEffects' => false], 'mb_ereg_search' => ['hasSideEffects' => false], 'mb_ereg_search_getpos' => ['hasSideEffects' => false], 'mb_ereg_search_getregs' => ['hasSideEffects' => false], 'mb_ereg_search_pos' => ['hasSideEffects' => false], 'mb_ereg_search_regs' => ['hasSideEffects' => false], 'mb_ereg_search_setpos' => ['hasSideEffects' => false], 'mb_eregi_replace' => ['hasSideEffects' => false], 'mb_get_info' => ['hasSideEffects' => false], 'mb_http_input' => ['hasSideEffects' => false], 'mb_list_encodings' => ['hasSideEffects' => false], 'mb_ord' => ['hasSideEffects' => false], 'mb_output_handler' => ['hasSideEffects' => false], 'mb_preferred_mime_name' => ['hasSideEffects' => false], 'mb_scrub' => ['hasSideEffects' => false], 'mb_split' => ['hasSideEffects' => false], 'mb_str_pad' => ['hasSideEffects' => false], 'mb_str_split' => ['hasSideEffects' => false], 'mb_strcut' => ['hasSideEffects' => false], 'mb_strimwidth' => ['hasSideEffects' => false], 'mb_stripos' => ['hasSideEffects' => false], 'mb_stristr' => ['hasSideEffects' => false], 'mb_strlen' => ['hasSideEffects' => false], 'mb_strpos' => ['hasSideEffects' => false], 'mb_strrchr' => ['hasSideEffects' => false], 'mb_strrichr' => ['hasSideEffects' => false], 'mb_strripos' => ['hasSideEffects' => false], 'mb_strrpos' => ['hasSideEffects' => false], 'mb_strstr' => ['hasSideEffects' => false], 'mb_strtolower' => ['hasSideEffects' => false], 'mb_strtoupper' => ['hasSideEffects' => false], 'mb_strwidth' => ['hasSideEffects' => false], 'mb_substr' => ['hasSideEffects' => false], 'mb_substr_count' => ['hasSideEffects' => false], 'mbereg_search_setpos' => ['hasSideEffects' => false], 'md5' => ['hasSideEffects' => false], 'md5_file' => ['hasSideEffects' => false], 'memory_get_peak_usage' => ['hasSideEffects' => false], 'memory_get_usage' => ['hasSideEffects' => false], 'metaphone' => ['hasSideEffects' => false], 'method_exists' => ['hasSideEffects' => false], 'mhash' => ['hasSideEffects' => false], 'mhash_count' => ['hasSideEffects' => false], 'mhash_get_block_size' => ['hasSideEffects' => false], 'mhash_get_hash_name' => ['hasSideEffects' => false], 'mhash_keygen_s2k' => ['hasSideEffects' => false], 'microtime' => ['hasSideEffects' => false], 'min' => ['hasSideEffects' => false], 'mkdir' => ['hasSideEffects' => true], 'mktime' => ['hasSideEffects' => false], 'move_uploaded_file' => ['hasSideEffects' => true], 'msgfmt_create' => ['hasSideEffects' => false], 'msgfmt_format' => ['hasSideEffects' => false], 'msgfmt_format_message' => ['hasSideEffects' => false], 'msgfmt_get_error_code' => ['hasSideEffects' => false], 'msgfmt_get_error_message' => ['hasSideEffects' => false], 'msgfmt_get_locale' => ['hasSideEffects' => false], 'msgfmt_get_pattern' => ['hasSideEffects' => false], 'msgfmt_parse' => ['hasSideEffects' => false], 'msgfmt_parse_message' => ['hasSideEffects' => false], 'mt_getrandmax' => ['hasSideEffects' => false], 'mt_rand' => ['hasSideEffects' => true], 'net_get_interfaces' => ['hasSideEffects' => false], 'ngettext' => ['hasSideEffects' => false], 'nl2br' => ['hasSideEffects' => false], 'nl_langinfo' => ['hasSideEffects' => false], 'normalizer_get_raw_decomposition' => ['hasSideEffects' => false], 'normalizer_is_normalized' => ['hasSideEffects' => false], 'normalizer_normalize' => ['hasSideEffects' => false], 'number_format' => ['hasSideEffects' => false], 'numfmt_create' => ['hasSideEffects' => false], 'numfmt_format' => ['hasSideEffects' => false], 'numfmt_format_currency' => ['hasSideEffects' => false], 'numfmt_get_attribute' => ['hasSideEffects' => false], 'numfmt_get_error_code' => ['hasSideEffects' => false], 'numfmt_get_error_message' => ['hasSideEffects' => false], 'numfmt_get_locale' => ['hasSideEffects' => false], 'numfmt_get_pattern' => ['hasSideEffects' => false], 'numfmt_get_symbol' => ['hasSideEffects' => false], 'numfmt_get_text_attribute' => ['hasSideEffects' => false], 'numfmt_parse' => ['hasSideEffects' => false], 'ob_etaghandler' => ['hasSideEffects' => false], 'ob_get_contents' => ['hasSideEffects' => false], 'ob_iconv_handler' => ['hasSideEffects' => false], 'octdec' => ['hasSideEffects' => false], 'ord' => ['hasSideEffects' => false], 'pack' => ['hasSideEffects' => false], 'pam_auth' => ['hasSideEffects' => false], 'pam_chpass' => ['hasSideEffects' => false], 'parse_ini_file' => ['hasSideEffects' => false], 'parse_ini_string' => ['hasSideEffects' => false], 'parse_url' => ['hasSideEffects' => false], 'pathinfo' => ['hasSideEffects' => false], 'pclose' => ['hasSideEffects' => true], 'pcntl_errno' => ['hasSideEffects' => false], 'pcntl_get_last_error' => ['hasSideEffects' => false], 'pcntl_getpriority' => ['hasSideEffects' => false], 'pcntl_strerror' => ['hasSideEffects' => false], 'pcntl_wexitstatus' => ['hasSideEffects' => false], 'pcntl_wifcontinued' => ['hasSideEffects' => false], 'pcntl_wifexited' => ['hasSideEffects' => false], 'pcntl_wifsignaled' => ['hasSideEffects' => false], 'pcntl_wifstopped' => ['hasSideEffects' => false], 'pcntl_wstopsig' => ['hasSideEffects' => false], 'pcntl_wtermsig' => ['hasSideEffects' => false], 'pdo_drivers' => ['hasSideEffects' => false], 'php_ini_loaded_file' => ['hasSideEffects' => false], 'php_ini_scanned_files' => ['hasSideEffects' => false], 'php_logo_guid' => ['hasSideEffects' => false], 'php_sapi_name' => ['hasSideEffects' => false], 'php_strip_whitespace' => ['hasSideEffects' => false], 'php_uname' => ['hasSideEffects' => false], 'phpversion' => ['hasSideEffects' => false], 'pi' => ['hasSideEffects' => false], 'popen' => ['hasSideEffects' => true], 'pos' => ['hasSideEffects' => false], 'posix_ctermid' => ['hasSideEffects' => false], 'posix_errno' => ['hasSideEffects' => false], 'posix_get_last_error' => ['hasSideEffects' => false], 'posix_getcwd' => ['hasSideEffects' => false], 'posix_getegid' => ['hasSideEffects' => false], 'posix_geteuid' => ['hasSideEffects' => false], 'posix_getgid' => ['hasSideEffects' => false], 'posix_getgrgid' => ['hasSideEffects' => false], 'posix_getgrnam' => ['hasSideEffects' => false], 'posix_getgroups' => ['hasSideEffects' => false], 'posix_getlogin' => ['hasSideEffects' => false], 'posix_getpgid' => ['hasSideEffects' => false], 'posix_getpgrp' => ['hasSideEffects' => false], 'posix_getpid' => ['hasSideEffects' => false], 'posix_getppid' => ['hasSideEffects' => false], 'posix_getpwnam' => ['hasSideEffects' => false], 'posix_getpwuid' => ['hasSideEffects' => false], 'posix_getrlimit' => ['hasSideEffects' => false], 'posix_getsid' => ['hasSideEffects' => false], 'posix_getuid' => ['hasSideEffects' => false], 'posix_initgroups' => ['hasSideEffects' => false], 'posix_isatty' => ['hasSideEffects' => false], 'posix_strerror' => ['hasSideEffects' => false], 'posix_times' => ['hasSideEffects' => false], 'posix_ttyname' => ['hasSideEffects' => false], 'posix_uname' => ['hasSideEffects' => false], 'pow' => ['hasSideEffects' => false], 'preg_grep' => ['hasSideEffects' => false], 'preg_last_error' => ['hasSideEffects' => false], 'preg_last_error_msg' => ['hasSideEffects' => false], 'preg_quote' => ['hasSideEffects' => false], 'preg_split' => ['hasSideEffects' => false], 'property_exists' => ['hasSideEffects' => false], 'quoted_printable_decode' => ['hasSideEffects' => false], 'quoted_printable_encode' => ['hasSideEffects' => false], 'quotemeta' => ['hasSideEffects' => false], 'rad2deg' => ['hasSideEffects' => false], 'rand' => ['hasSideEffects' => true], 'random_bytes' => ['hasSideEffects' => true], 'random_int' => ['hasSideEffects' => true], 'range' => ['hasSideEffects' => false], 'rawurldecode' => ['hasSideEffects' => false], 'rawurlencode' => ['hasSideEffects' => false], 'readfile' => ['hasSideEffects' => true], 'readlink' => ['hasSideEffects' => false], 'realpath' => ['hasSideEffects' => false], 'realpath_cache_get' => ['hasSideEffects' => false], 'realpath_cache_size' => ['hasSideEffects' => false], 'rename' => ['hasSideEffects' => true], 'resourcebundle_count' => ['hasSideEffects' => false], 'resourcebundle_create' => ['hasSideEffects' => false], 'resourcebundle_get' => ['hasSideEffects' => false], 'resourcebundle_get_error_code' => ['hasSideEffects' => false], 'resourcebundle_get_error_message' => ['hasSideEffects' => false], 'resourcebundle_locales' => ['hasSideEffects' => false], 'rewind' => ['hasSideEffects' => true], 'rmdir' => ['hasSideEffects' => true], 'round' => ['hasSideEffects' => false], 'rtrim' => ['hasSideEffects' => false], 'sha1' => ['hasSideEffects' => false], 'sha1_file' => ['hasSideEffects' => false], 'sin' => ['hasSideEffects' => false], 'sinh' => ['hasSideEffects' => false], 'sizeof' => ['hasSideEffects' => false], 'soundex' => ['hasSideEffects' => false], 'spl_classes' => ['hasSideEffects' => false], 'spl_object_hash' => ['hasSideEffects' => false], 'sprintf' => ['hasSideEffects' => false], 'sqrt' => ['hasSideEffects' => false], 'stat' => ['hasSideEffects' => false], 'str_contains' => ['hasSideEffects' => false], 'str_decrement' => ['hasSideEffects' => false], 'str_ends_with' => ['hasSideEffects' => false], 'str_getcsv' => ['hasSideEffects' => false], 'str_increment' => ['hasSideEffects' => false], 'str_pad' => ['hasSideEffects' => false], 'str_repeat' => ['hasSideEffects' => false], 'str_rot13' => ['hasSideEffects' => false], 'str_split' => ['hasSideEffects' => false], 'str_starts_with' => ['hasSideEffects' => false], 'str_word_count' => ['hasSideEffects' => false], 'strcasecmp' => ['hasSideEffects' => false], 'strchr' => ['hasSideEffects' => false], 'strcmp' => ['hasSideEffects' => false], 'strcoll' => ['hasSideEffects' => false], 'strcspn' => ['hasSideEffects' => false], 'stream_get_filters' => ['hasSideEffects' => false], 'stream_get_transports' => ['hasSideEffects' => false], 'stream_get_wrappers' => ['hasSideEffects' => false], 'stream_is_local' => ['hasSideEffects' => false], 'stream_isatty' => ['hasSideEffects' => false], 'strip_tags' => ['hasSideEffects' => false], 'stripcslashes' => ['hasSideEffects' => false], 'stripos' => ['hasSideEffects' => false], 'stripslashes' => ['hasSideEffects' => false], 'stristr' => ['hasSideEffects' => false], 'strlen' => ['hasSideEffects' => false], 'strnatcasecmp' => ['hasSideEffects' => false], 'strnatcmp' => ['hasSideEffects' => false], 'strncasecmp' => ['hasSideEffects' => false], 'strncmp' => ['hasSideEffects' => false], 'strpbrk' => ['hasSideEffects' => false], 'strpos' => ['hasSideEffects' => false], 'strptime' => ['hasSideEffects' => false], 'strrchr' => ['hasSideEffects' => false], 'strrev' => ['hasSideEffects' => false], 'strripos' => ['hasSideEffects' => false], 'strrpos' => ['hasSideEffects' => false], 'strspn' => ['hasSideEffects' => false], 'strstr' => ['hasSideEffects' => false], 'strtolower' => ['hasSideEffects' => false], 'strtotime' => ['hasSideEffects' => false], 'strtoupper' => ['hasSideEffects' => false], 'strtr' => ['hasSideEffects' => false], 'strval' => ['hasSideEffects' => false], 'substr' => ['hasSideEffects' => false], 'substr_compare' => ['hasSideEffects' => false], 'substr_count' => ['hasSideEffects' => false], 'substr_replace' => ['hasSideEffects' => false], 'symlink' => ['hasSideEffects' => true], 'sys_getloadavg' => ['hasSideEffects' => false], 'tan' => ['hasSideEffects' => false], 'tanh' => ['hasSideEffects' => false], 'tempnam' => ['hasSideEffects' => true], 'timezone_abbreviations_list' => ['hasSideEffects' => false], 'timezone_identifiers_list' => ['hasSideEffects' => false], 'timezone_location_get' => ['hasSideEffects' => false], 'timezone_name_from_abbr' => ['hasSideEffects' => false], 'timezone_name_get' => ['hasSideEffects' => false], 'timezone_offset_get' => ['hasSideEffects' => false], 'timezone_open' => ['hasSideEffects' => false], 'timezone_transitions_get' => ['hasSideEffects' => false], 'timezone_version_get' => ['hasSideEffects' => false], 'tmpfile' => ['hasSideEffects' => true], 'token_get_all' => ['hasSideEffects' => false], 'token_name' => ['hasSideEffects' => false], 'touch' => ['hasSideEffects' => true], 'transliterator_create' => ['hasSideEffects' => false], 'transliterator_create_from_rules' => ['hasSideEffects' => false], 'transliterator_create_inverse' => ['hasSideEffects' => false], 'transliterator_get_error_code' => ['hasSideEffects' => false], 'transliterator_get_error_message' => ['hasSideEffects' => false], 'transliterator_list_ids' => ['hasSideEffects' => false], 'transliterator_transliterate' => ['hasSideEffects' => false], 'trim' => ['hasSideEffects' => false], 'ucfirst' => ['hasSideEffects' => false], 'ucwords' => ['hasSideEffects' => false], 'umask' => ['hasSideEffects' => true], 'unlink' => ['hasSideEffects' => true], 'unpack' => ['hasSideEffects' => false], 'urldecode' => ['hasSideEffects' => false], 'urlencode' => ['hasSideEffects' => false], 'utf8_decode' => ['hasSideEffects' => false], 'utf8_encode' => ['hasSideEffects' => false], 'vsprintf' => ['hasSideEffects' => false], 'wordwrap' => ['hasSideEffects' => false], 'xml_error_string' => ['hasSideEffects' => false], 'xml_get_current_byte_index' => ['hasSideEffects' => false], 'xml_get_current_column_number' => ['hasSideEffects' => false], 'xml_get_current_line_number' => ['hasSideEffects' => false], 'xml_get_error_code' => ['hasSideEffects' => false], 'xml_parser_create' => ['hasSideEffects' => false], 'xml_parser_create_ns' => ['hasSideEffects' => false], 'xml_parser_get_option' => ['hasSideEffects' => false], 'zend_version' => ['hasSideEffects' => false], 'zlib_decode' => ['hasSideEffects' => false], 'zlib_encode' => ['hasSideEffects' => false], 'zlib_get_coding_type' => ['hasSideEffects' => false], ];<?php // @codingStandardsIgnoreFile (phpcs runs out of memory) /** * Copied over from https://github.com/phan/phan/blob/da49cd287e3b315f5dfdb440522da797d980fe63/src/Phan/Language/Internal/FunctionSignatureMap_php74_delta.php * with more functions added from PHP 7.4 changelog * Copyright (c) 2015 Rasmus Lerdorf * Copyright (c) 2015 Andrew Morrison */ /** * This contains the information needed to convert the function signatures for php 7.4 to php 7.3 (and vice versa) * * This has two sections. * The 'new' section contains function/method names from FunctionSignatureMap (And alternates, if applicable) that do not exist in php7.3 or have different signatures in php 7.4. * If they were just updated, the function/method will be present in the 'added' signatures. * The 'old' signatures contains the signatures that are different in php 7.3. * Functions are expected to be removed only in major releases of php. * * @see FunctionSignatureMap.php * * @phan-file-suppress PhanPluginMixedKeyNoKey (read by Phan when analyzing this file) */ return [ 'new' => [ 'FFI::addr' => ['FFI\CData', 'ptr'=>'FFI\CData'], 'FFI::alignof' => ['int', 'ptr'=>'mixed'], 'FFI::arrayType' => ['FFI\CType', 'type'=>'string|FFI\CType', 'dims'=>'array<int,int>'], 'FFI::cast' => ['FFI\CData', 'type'=>'string|FFI\CType', 'ptr'=>''], 'FFI::cdef' => ['FFI', 'code='=>'string', 'lib='=>'?string'], 'FFI::free' => ['void', 'ptr'=>'FFI\CData'], 'FFI::load' => ['FFI', 'filename'=>'string'], 'FFI::memcmp' => ['int', 'ptr1'=>'FFI\CData|string', 'ptr2'=>'FFI\CData|string', 'size'=>'int'], 'FFI::memcpy' => ['void', 'dst'=>'FFI\CData', 'src'=>'string|FFI\CData', 'size'=>'int'], 'FFI::memset' => ['void', 'ptr'=>'FFI\CData', 'ch'=>'int', 'size'=>'int'], 'FFI::new' => ['FFI\CData', 'type'=>'string|FFI\CType', 'owned='=>'bool', 'persistent='=>'bool'], 'FFI::scope' => ['FFI', 'scope_name'=>'string'], 'FFI::sizeof' => ['int', 'ptr'=>'FFI\CData|FFI\CType'], 'FFI::string' => ['string', 'ptr'=>'FFI\CData', 'size='=>'int'], 'FFI::typeof' => ['FFI\CType', 'ptr'=>'FFI\CData'], 'FFI::type' => ['FFI\CType', 'type'=>'string'], 'fread' => ['string|false', 'fp'=>'resource', 'length'=>'positive-int'], 'get_mangled_object_vars' => ['array', 'obj'=>'object'], 'mb_str_split' => ['list<string>|false', 'str'=>'string', 'split_length='=>'int', 'encoding='=>'string'], 'password_algos' => ['list<string>'], 'password_needs_rehash' => ['bool', 'hash'=>'string', 'algo'=>'string|null', 'options='=>'array'], 'preg_replace_callback' => ['string|array|null', 'regex'=>'string|array', 'callback'=>'callable(array<int|string, string>):string', 'subject'=>'string|array', 'limit='=>'int', '&w_count='=>'int', 'flags='=>'int'], 'preg_replace_callback_array' => ['string|array|null', 'pattern'=>'array<string,callable>', 'subject'=>'string|array', 'limit='=>'int', '&w_count='=>'int', 'flags='=>'int'], 'sapi_windows_set_ctrl_handler' => ['bool', 'callable'=>'callable(int):void', 'add='=>'bool'], 'ReflectionProperty::getType' => ['?ReflectionType'], 'ReflectionProperty::hasType' => ['bool'], 'ReflectionProperty::isInitialized' => ['bool', 'object='=>'?object'], 'ReflectionReference::fromArrayElement' => ['?ReflectionReference', 'array'=>'array', 'key'=>'int|string'], 'ReflectionReference::getId' => ['string'], 'SQLite3Stmt::getSQL' => ['string', 'expanded='=>'bool'], 'strip_tags' => ['string', 'str'=>'string', 'allowable_tags='=>'string|array<int, string>'], 'WeakReference::create' => ['WeakReference', 'referent'=>'object'], 'WeakReference::get' => ['?object'], 'proc_open' => ['resource|false', 'command'=>'string|list<string>', 'descriptorspec'=>'array', '&w_pipes'=>'resource[]', 'cwd='=>'?string', 'env='=>'?array', 'other_options='=>'array'], ], 'old' => [ 'implode\'2' => ['string', 'pieces'=>'array', 'glue'=>'string'], ], ]; <?php namespace _PHPStan_7d8742a37; // phpcs:ignoreFile return ['new' => ['error_log' => ['bool', 'message' => 'string', 'message_type=' => '0|1|3|4', 'destination=' => 'string', 'extra_headers=' => 'string'], 'filter_input' => ['mixed', 'type' => 'INPUT_GET|INPUT_POST|INPUT_COOKIE|INPUT_SERVER|INPUT_ENV', 'variable_name' => 'string', 'filter=' => 'int', 'options=' => 'array|int'], 'filter_input_array' => ['array|false|null', 'type' => 'INPUT_GET|INPUT_POST|INPUT_COOKIE|INPUT_SERVER|INPUT_ENV', 'definition=' => 'int|array', 'add_empty=' => 'bool'], 'hash_hkdf' => ['non-falsy-string', 'algo' => 'non-falsy-string', 'key' => 'string', 'length=' => '0|positive-int', 'info=' => 'string', 'salt=' => 'string'], 'hash_pbkdf2' => ['non-empty-string', 'algo' => 'non-falsy-string', 'password' => 'string', 'salt' => 'string', 'iterations' => 'positive-int', 'length=' => '0|positive-int', 'raw_output=' => 'bool'], 'imagecreate' => ['__benevolent<GdImage|false>', 'width' => 'int<1, max>', 'height' => 'int<1, max>'], 'imagecreatetruecolor' => ['__benevolent<GdImage|false>', 'width' => 'int<1, max>', 'height' => 'int<1, max>'], 'mb_detect_order' => ['bool|list<non-falsy-string>', 'encoding_list=' => 'non-empty-list<non-falsy-string>|non-falsy-string|null']], 'old' => []]; <?php namespace _PHPStan_7d8742a37; // phpcs:ignoreFile /** * Copied over from https://github.com/phan/phan/blob/8866d6b98be94b37996390da226e8c4befea29aa/src/Phan/Language/Internal/FunctionSignatureMap_php80_delta.php * Copyright (c) 2015 Rasmus Lerdorf * Copyright (c) 2015 Andrew Morrison */ /** * This contains the information needed to convert the function signatures for php 8.0 to php 7.4 (and vice versa) * * This has two sections. * The 'new' section contains function/method names from FunctionSignatureMap (And alternates, if applicable) that do not exist in php7.4 or have different signatures in php 8.0. * If they were just updated, the function/method will be present in the 'added' signatures. * The 'old' signatures contains the signatures that are different in php 7.4. * Functions are expected to be removed only in major releases of php. * * @see FunctionSignatureMap.php * * @phan-file-suppress PhanPluginMixedKeyNoKey (read by Phan when analyzing this file) */ return ['new' => ['iterator_count' => ['0|positive-int', 'iterator' => 'iterable'], 'iterator_to_array' => ['array', 'iterator' => 'iterable', 'use_keys=' => 'bool'], 'str_split' => ['list<string>', 'str' => 'string', 'split_length=' => 'positive-int']], 'old' => []]; <?php // @codingStandardsIgnoreFile (phpcs runs out of memory) /** * Copied over from https://github.com/phan/phan/blob/dbb7ea9bd049ebd116c0b08b043794c697486801/src/Phan/Language/Internal/FunctionSignatureMap.php * with some changes like removal of specific array keys and callable definitions * Copyright (c) 2015 Rasmus Lerdorf * Copyright (c) 2015 Andrew Morrison */ /** * Format * * '<function_name>' => ['<return_type>, '<arg_name>'=>'<arg_type>'] * alternative signature for the same function * '<function_name\'1>' => ['<return_type>, '<arg_name>'=>'<arg_type>'] * * A '&' in front of the <arg_name> means the arg is always passed by reference. * (i.e. ReflectionParameter->isPassedByReference()) * This was previously only used in cases where the function actually created the * variable in the local scope. * Some reference arguments will have prefixes in <arg_name> to indicate the way the argument is used. * Currently, the only prefixes with meaning are 'rw_' (read-write) and 'w_' (write). * Those prefixes don't mean anything for non-references. * Code using these signatures should remove those prefixes from messages rendered to the user. * 1. '&rw_<arg_name>' indicates that a parameter with a value is expected to be passed in, and may be modified. * Phan will warn if the variable has an incompatible type, or is undefined. * 2. '&w_<arg_name>' indicates that a parameter is expected to be passed in, and the value will be ignored, and may be overwritten. * 3. The absence of a prefix is treated by Phan the same way as having the prefix 'w_' (Some may be changed to 'rw_name'). These will have prefixes added later. * * So, for functions like sort() where technically the arg is by-ref, * indicate the reference param's signature by-ref and read-write, * as `'&rw_array'=>'array'` * so that Phan won't create it in the local scope * * However, for a function like preg_match() where the 3rd arg is an array of sub-pattern matches (and optional), * this arg needs to be marked as by-ref and write-only, as `'&w_matches='=>'array'`. * * A '=' following the <arg_name> indicates this arg is optional. * * The <arg_name> can begin with '...' to indicate the arg is variadic. * '...args=' indicates it is both variadic and optional. * * Some reference arguments will have prefixes in <arg_name> to indicate the way the argument is used. * Currently, the only prefixes with meaning are 'rw_' and 'w_'. * Code using these signatures should remove those prefixes from messages rendered to the user. * 1. '&rw_name' indicates that a parameter with a value is expected to be passed in, and may be modified. * 2. '&w_name' indicates that a parameter is expected to be passed in, and the value will be ignored, and may be overwritten. * * Sources of stub info: * * 1. Reflection * 2. docs.php.net's SVN repo or website, and examples (See internal/internalsignatures.php) * 3. Various websites documenting individual extensions * 4. PHPStorm stubs (For anything missing from the above sources) * See internal/internalsignatures.php */ return [ '_' => ['string', 'message'=>'string'], 'abs' => ['float|0|positive-int', 'num'=>'int|float'], 'accelerator_get_configuration' => ['array'], 'accelerator_get_scripts' => ['array'], 'accelerator_get_status' => ['array', 'fetch_scripts'=>'bool'], 'accelerator_reset' => [''], 'accelerator_set_status' => ['void', 'status'=>''], 'acos' => ['float', 'number'=>'float'], 'acosh' => ['float', 'number'=>'float'], 'addcslashes' => ['string', 'str'=>'string', 'charlist'=>'string'], 'addslashes' => ['string', 'str'=>'string'], 'AMQPChannel::__construct' => ['void', 'connection'=>'AMQPConnection'], 'AMQPChannel::basicRecover' => ['void', 'requeue='=>'bool'], 'AMQPChannel::commitTransaction' => ['void'], 'AMQPChannel::getChannelId' => ['int<1, 65535>'], 'AMQPChannel::getConnection' => ['AMQPConnection'], 'AMQPChannel::getPrefetchCount' => ['int<0, 65535>'], 'AMQPChannel::getPrefetchSize' => ['int<0, max>'], 'AMQPChannel::isConnected' => ['bool'], 'AMQPChannel::qos' => ['void', 'size'=>'int', 'count'=>'int', 'global='=>'bool'], 'AMQPChannel::rollbackTransaction' => ['void'], 'AMQPChannel::setPrefetchCount' => ['void', 'count'=>'int'], 'AMQPChannel::setPrefetchSize' => ['void', 'size'=>'int'], 'AMQPChannel::startTransaction' => ['void'], 'AMQPConnection::__construct' => ['void', 'credentials='=>'array'], 'AMQPConnection::connect' => ['void'], 'AMQPConnection::disconnect' => ['void'], 'AMQPConnection::getHost' => ['string'], 'AMQPConnection::getLogin' => ['string'], 'AMQPConnection::getMaxChannels' => ['int<1, 65535>'], 'AMQPConnection::getPassword' => ['string'], 'AMQPConnection::getPort' => ['int<1, 65535>'], 'AMQPConnection::getReadTimeout' => ['float'], 'AMQPConnection::getTimeout' => ['float'], 'AMQPConnection::getUsedChannels' => ['int<1, 65535>'], 'AMQPConnection::getVhost' => ['string'], 'AMQPConnection::getWriteTimeout' => ['float'], 'AMQPConnection::isConnected' => ['bool'], 'AMQPConnection::isPersistent' => ['bool'], 'AMQPConnection::pconnect' => ['void'], 'AMQPConnection::pdisconnect' => ['void'], 'AMQPConnection::preconnect' => ['void'], 'AMQPConnection::reconnect' => ['void'], 'AMQPConnection::setHost' => ['void', 'host'=>'string'], 'AMQPConnection::setLogin' => ['void', 'login'=>'string'], 'AMQPConnection::setPassword' => ['void', 'password'=>'string'], 'AMQPConnection::setPort' => ['void', 'port'=>'int'], 'AMQPConnection::setReadTimeout' => ['void', 'timeout'=>'int'], 'AMQPConnection::setTimeout' => ['void', 'timeout'=>'int'], 'AMQPConnection::setVhost' => ['void', 'vhost'=>'string'], 'AMQPConnection::setWriteTimeout' => ['void', 'timeout'=>'int'], 'AMQPEnvelope::getAppId' => ['string|null'], 'AMQPEnvelope::getBody' => ['string'], 'AMQPEnvelope::getContentEncoding' => ['string|null'], 'AMQPEnvelope::getContentType' => ['string|null'], 'AMQPEnvelope::getCorrelationId' => ['string|null'], 'AMQPEnvelope::getDeliveryMode' => ['int'], 'AMQPEnvelope::getDeliveryTag' => ['int|null'], 'AMQPEnvelope::getExchangeName' => ['string|null'], 'AMQPEnvelope::getExpiration' => ['string|null'], 'AMQPEnvelope::getHeader' => ['mixed', 'headerName'=>'string'], 'AMQPEnvelope::getHeaders' => ['array<string,mixed>'], 'AMQPEnvelope::getMessageId' => ['string|null'], 'AMQPEnvelope::getPriority' => ['int<0, max>'], 'AMQPEnvelope::getReplyTo' => ['string|null'], 'AMQPEnvelope::getRoutingKey' => ['string'], 'AMQPEnvelope::getTimestamp' => ['int|null'], 'AMQPEnvelope::getType' => ['string|null'], 'AMQPEnvelope::getUserId' => ['string|null'], 'AMQPEnvelope::isRedelivery' => ['bool'], 'AMQPExchange::__construct' => ['void', 'channel'=>'AMQPChannel'], 'AMQPExchange::bind' => ['void', 'exchangeName'=>'string', 'routingKey='=>'string|null', 'arguments='=>'array'], 'AMQPExchange::declareExchange' => ['void'], 'AMQPExchange::delete' => ['void', 'exchangeName='=>'string', 'flags='=>'int'], 'AMQPExchange::getArgument' => ['scalar|null', 'argumentName'=>'string'], 'AMQPExchange::getArguments' => ['array<string, scalar|null>'], 'AMQPExchange::getChannel' => ['AMQPChannel'], 'AMQPExchange::getConnection' => ['AMQPConnection'], 'AMQPExchange::getFlags' => ['int'], 'AMQPExchange::getName' => ['string|null'], 'AMQPExchange::getType' => ['string|null'], 'AMQPExchange::publish' => ['void', 'message'=>'string', 'routingKey='=>'string|null', 'flags='=>'int|null', 'header='=>'array<string, mixed>'], 'AMQPExchange::setArgument' => ['void', 'argumentName'=>'string', 'argumentValue'=>'scalar|null'], 'AMQPExchange::setArguments' => ['void', 'arguments'=>'array<string, scalar|null>'], 'AMQPExchange::setFlags' => ['void', 'flags'=>'int|null'], 'AMQPExchange::setName' => ['void', 'exchangeName'=>'string|null'], 'AMQPExchange::setType' => ['void', 'exchangeType'=>'string|null'], 'AMQPExchange::unbind' => ['void', 'exchangeName'=>'string', 'routingKey='=>'string|null', 'arguments='=>'array'], 'AMQPQueue::__construct' => ['void', 'channel'=>'AMQPChannel'], 'AMQPQueue::ack' => ['void', 'deliveryTag'=>'int', 'flags='=>'int|null'], 'AMQPQueue::bind' => ['void', 'exchangeName'=>'string', 'routingKey='=>'string|null', 'arguments='=>'array'], 'AMQPQueue::cancel' => ['void', 'consumerTag='=>'string'], 'AMQPQueue::consume' => ['void', 'callback='=>'null|callable(AMQPEnvelope, AMQPQueue): mixed', 'flags='=>'int|null', 'consumerTag='=>'string|null'], 'AMQPQueue::declareQueue' => ['int'], 'AMQPQueue::delete' => ['int', 'flags='=>'int|null'], 'AMQPQueue::get' => ['AMQPEnvelope|null', 'flags='=>'int|null'], 'AMQPQueue::getArgument' => ['scalar|null|array|AMQPValue|AMQPDecimal|AMQPTimestamp', 'argumentName'=>'string'], 'AMQPQueue::getArguments' => ['array'], 'AMQPQueue::getChannel' => ['AMQPChannel'], 'AMQPQueue::getConnection' => ['AMQPConnection'], 'AMQPQueue::getFlags' => ['int'], 'AMQPQueue::getName' => ['string|null'], 'AMQPQueue::nack' => ['void', 'deliveryTag'=>'int', 'flags='=>'int|null'], 'AMQPQueue::purge' => ['int'], 'AMQPQueue::reject' => ['void', 'deliveryTag'=>'int', 'flags='=>'int|null'], 'AMQPQueue::setArgument' => ['void', 'argumentName'=>'string', 'argumentValue'=>'scalar|null|array|AMQPValue|AMQPDecimal|AMQPTimestamp'], 'AMQPQueue::setArguments' => ['void', 'arguments'=>'array'], 'AMQPQueue::setFlags' => ['void', 'flags'=>'int|null'], 'AMQPQueue::setName' => ['void', 'name'=>'string'], 'AMQPQueue::unbind' => ['void', 'exchangeName'=>'string', 'routingKey='=>'string|null', 'arguments='=>'array'], 'apache_child_terminate' => ['bool'], 'apache_get_modules' => ['array'], 'apache_get_version' => ['string|false'], 'apache_getenv' => ['string|false', 'variable'=>'string', 'walk_to_top='=>'bool'], 'apache_lookup_uri' => ['object|false', 'filename'=>'string'], 'apache_note' => ['string|false', 'note_name'=>'string', 'note_value='=>'string'], 'apache_request_headers' => ['array|false'], 'apache_reset_timeout' => ['bool'], 'apache_response_headers' => ['array|false'], 'apache_setenv' => ['bool', 'variable'=>'string', 'value'=>'string', 'walk_to_top='=>'bool'], 'apc_add' => ['bool', 'key'=>'string', 'var'=>'mixed', 'ttl='=>'int'], 'apc_add\'1' => ['array', 'values'=>'array', 'unused='=>'', 'ttl='=>'int'], 'apc_bin_dump' => ['string', 'files='=>'array', 'user_vars='=>'array'], 'apc_bin_dumpfile' => ['int', 'files'=>'array', 'user_vars'=>'array', 'filename'=>'string', 'flags='=>'int', 'context='=>'resource'], 'apc_bin_load' => ['bool', 'data'=>'string', 'flags='=>'int'], 'apc_bin_loadfile' => ['bool', 'filename'=>'string', 'context='=>'resource', 'flags='=>'int'], 'apc_cache_info' => ['array', 'cache_type='=>'string', 'limited='=>'bool'], 'apc_cas' => ['bool', 'key'=>'string', 'old'=>'int', 'new'=>'int'], 'apc_clear_cache' => ['bool', 'cache_type='=>'string'], 'apc_compile_file' => ['mixed', 'filename'=>'string', 'atomic='=>'bool'], 'apc_dec' => ['int', 'key'=>'string', 'step='=>'int', '&w_success='=>'bool'], 'apc_define_constants' => ['bool', 'key'=>'string', 'constants'=>'array', 'case_sensitive='=>'bool'], 'apc_delete' => ['bool', 'key'=>'string|string[]|APCIterator'], 'apc_delete_file' => ['mixed', 'keys'=>'mixed'], 'apc_exists' => ['bool', 'keys'=>'string'], 'apc_exists\'1' => ['array', 'keys'=>'string[]'], 'apc_fetch' => ['mixed', 'key'=>'mixed', '&w_success='=>'bool'], 'apc_inc' => ['int', 'key'=>'string', 'step='=>'int', '&w_success='=>'bool'], 'apc_load_constants' => ['bool', 'key'=>'string', 'case_sensitive='=>'bool'], 'apc_sma_info' => ['array', 'limited='=>'bool'], 'apc_store' => ['bool', 'key'=>'string', 'var'=>'', 'ttl='=>'int'], 'apc_store\'1' => ['array', 'values'=>'array', 'unused='=>'', 'ttl='=>'int'], 'APCIterator::__construct' => ['void', 'cache'=>'string', 'search='=>'', 'format='=>'int', 'chunk_size='=>'int', 'list='=>'int'], 'APCIterator::current' => ['mixed'], 'APCIterator::getTotalCount' => ['int'], 'APCIterator::getTotalHits' => ['int'], 'APCIterator::getTotalSize' => ['int'], 'APCIterator::key' => ['string'], 'APCIterator::next' => ['void'], 'APCIterator::rewind' => ['void'], 'APCIterator::valid' => ['bool'], 'apcu_add' => ['bool', 'key'=>'string', 'var'=>'', 'ttl='=>'int'], 'apcu_add\'1' => ['array<string,int>', 'values'=>'array<string,mixed>', 'unused='=>'', 'ttl='=>'int'], 'apcu_cache_info' => ['array<string,mixed>', 'limited='=>'bool'], 'apcu_cas' => ['bool', 'key'=>'string', 'old'=>'int', 'new'=>'int'], 'apcu_clear_cache' => ['bool'], 'apcu_dec' => ['int', 'key'=>'string', 'step='=>'int', '&w_success='=>'bool', 'ttl='=>'int'], 'apcu_delete' => ['bool', 'key'=>'string|APCuIterator'], 'apcu_delete\'1' => ['list<string>', 'key'=>'string[]'], 'apcu_entry' => ['mixed', 'key'=>'string', 'generator'=>'callable', 'ttl='=>'int'], 'apcu_exists' => ['bool', 'keys'=>'string'], 'apcu_exists\'1' => ['array', 'keys'=>'string[]'], 'apcu_fetch' => ['mixed', 'key'=>'string|string[]', '&w_success='=>'bool'], 'apcu_inc' => ['int', 'key'=>'string', 'step='=>'int', '&w_success='=>'bool', 'ttl='=>'int'], 'apcu_sma_info' => ['array', 'limited='=>'bool'], 'apcu_store' => ['bool', 'key'=>'string', 'var='=>'', 'ttl='=>'int'], 'apcu_store\'1' => ['array', 'values'=>'array', 'unused='=>'', 'ttl='=>'int'], 'APCuIterator::__construct' => ['void', 'search='=>'string|string[]|null', 'format='=>'int', 'chunk_size='=>'int', 'list='=>'int'], 'APCuIterator::current' => ['mixed'], 'APCuIterator::getTotalCount' => ['int'], 'APCuIterator::getTotalHits' => ['int'], 'APCuIterator::getTotalSize' => ['int'], 'APCuIterator::key' => ['string'], 'APCuIterator::next' => ['void'], 'APCuIterator::rewind' => ['void'], 'APCuIterator::valid' => ['bool'], 'apd_breakpoint' => ['bool', 'debug_level'=>'int'], 'apd_callstack' => ['array'], 'apd_clunk' => ['void', 'warning'=>'string', 'delimiter='=>'string'], 'apd_continue' => ['bool', 'debug_level'=>'int'], 'apd_croak' => ['void', 'warning'=>'string', 'delimiter='=>'string'], 'apd_dump_function_table' => ['void'], 'apd_dump_persistent_resources' => ['array'], 'apd_dump_regular_resources' => ['array'], 'apd_echo' => ['bool', 'output'=>'string'], 'apd_get_active_symbols' => ['array'], 'apd_set_pprof_trace' => ['string', 'dump_directory='=>'string', 'fragment='=>'string'], 'apd_set_session' => ['void', 'debug_level'=>'int'], 'apd_set_session_trace' => ['void', 'debug_level'=>'int', 'dump_directory='=>'string'], 'apd_set_session_trace_socket' => ['bool', 'tcp_server'=>'string', 'socket_type'=>'int', 'port'=>'int', 'debug_level'=>'int'], 'AppendIterator::__construct' => ['void'], 'AppendIterator::append' => ['void', 'iterator'=>'Iterator'], 'AppendIterator::current' => ['mixed'], 'AppendIterator::getArrayIterator' => ['ArrayIterator'], 'AppendIterator::getInnerIterator' => ['iterator'], 'AppendIterator::getIteratorIndex' => ['int'], 'AppendIterator::key' => ['mixed'], 'AppendIterator::next' => ['void'], 'AppendIterator::rewind' => ['void'], 'AppendIterator::valid' => ['bool'], 'array_change_key_case' => ['array', 'input'=>'array', 'case='=>'int'], 'array_chunk' => ['list<array>', 'input'=>'array', 'size'=>'positive-int', 'preserve_keys='=>'bool'], 'array_column' => ['array', 'array'=>'array', 'column_key'=>'mixed', 'index_key='=>'mixed'], 'array_combine' => ['array|false', 'keys'=>'array', 'values'=>'array'], 'array_count_values' => ['array<positive-int>', 'input'=>'array'], 'array_diff' => ['array', 'arr1'=>'array', 'arr2'=>'array', '...args='=>'array'], 'array_diff_assoc' => ['array', 'arr1'=>'array', 'arr2'=>'array', '...args='=>'array'], 'array_diff_key' => ['array', 'arr1'=>'array', 'arr2'=>'array', '...args='=>'array'], 'array_diff_uassoc' => ['array', 'arr1'=>'array', 'arr2'=>'array', 'data_comp_func'=>'callable(mixed,mixed):int'], 'array_diff_uassoc\'1' => ['array', 'arr1'=>'array', 'arr2'=>'array', 'arr3'=>'array', 'arg4'=>'array|callable(mixed,mixed):int', '...rest='=>'array|callable'], 'array_diff_ukey' => ['array', 'arr1'=>'array', 'arr2'=>'array', 'key_comp_func'=>'callable(mixed,mixed):int'], 'array_diff_ukey\'1' => ['array', 'arr1'=>'array', 'arr2'=>'array', 'arr3'=>'array', 'arg4'=>'array|callable(mixed,mixed):int', '...rest='=>'array|callable(mixed,mixed):int'], 'array_fill' => ['array', 'start_key'=>'int', 'num'=>'int', 'val'=>'mixed'], 'array_fill_keys' => ['array', 'keys'=>'array', 'val'=>'mixed'], 'array_filter' => ['array', 'input'=>'array', 'callback='=>'callable(mixed,mixed):bool|callable(mixed):bool', 'flag='=>'int'], 'array_flip' => ['array', 'input'=>'array<int|string>'], 'array_intersect' => ['array', 'arr1'=>'array', 'arr2'=>'array', '...args='=>'array'], 'array_intersect_assoc' => ['array', 'arr1'=>'array', 'arr2'=>'array', '...args='=>'array'], 'array_intersect_key' => ['array', 'arr1'=>'array', 'arr2'=>'array', '...args='=>'array'], 'array_intersect_uassoc' => ['array', 'arr1'=>'array', 'arr2'=>'array', 'key_compare_func'=>'callable(mixed,mixed):int'], 'array_intersect_uassoc\'1' => ['array', 'arr1'=>'array', 'arr2'=>'array', 'arr3'=>'array', 'arg4'=>'array|callable(mixed,mixed):int', '...rest'=>'array|callable'], 'array_intersect_ukey' => ['array', 'arr1'=>'array', 'arr2'=>'array', 'key_compare_func'=>'callable(mixed,mixed):int'], 'array_intersect_ukey\'1' => ['array', 'arr1'=>'array', 'arr2'=>'array', 'arr3'=>'array', 'arg4'=>'array|callable(mixed,mixed):int', '...rest'=>'array|callable(mixed,mixed):int'], 'array_key_exists' => ['bool', 'key'=>'string|int', 'search'=>'array'], 'array_key_first' => ['int|string|null', 'array'=>'array'], 'array_key_last' => ['int|string|null', 'array'=>'array'], 'array_keys' => ['list<array-key>', 'input'=>'array', 'search_value='=>'mixed', 'strict='=>'bool'], 'array_map' => ['array', 'callback'=>'?callable', 'array'=>'array', '...args='=>'array'], 'array_merge' => ['array', 'arr1'=>'array', '...args='=>'array'], 'array_merge_recursive' => ['array', 'arr1'=>'array', '...args='=>'array'], 'array_multisort' => ['bool', 'array1'=>'array', 'array1_sort_order='=>'array|int', 'array1_sort_flags='=>'array|int', '...args='=>'array|int'], 'array_pad' => ['array', 'input'=>'array', 'pad_size'=>'int', 'pad_value'=>'mixed'], 'array_pop' => ['mixed', '&rw_stack'=>'array'], 'array_product' => ['int|float', 'input'=>'array'], 'array_push' => ['int', '&rw_stack'=>'array', 'var'=>'mixed', '...vars='=>'mixed'], 'array_rand' => ['int|string|array<int,int>|array<int,string>', 'input'=>'array', 'num_req'=>'int'], 'array_rand\'1' => ['int|string', 'input'=>'array'], 'array_reduce' => ['mixed', 'input'=>'array', 'callback'=>'callable(mixed,mixed):mixed', 'initial='=>'mixed'], 'array_replace' => ['array', 'arr1'=>'array', 'arr2'=>'array', '...args='=>'array'], 'array_replace_recursive' => ['array', 'arr1'=>'array', 'arr2'=>'array', '...args='=>'array'], 'array_reverse' => ['array', 'input'=>'array', 'preserve='=>'bool'], 'array_search' => ['int|string|false', 'needle'=>'mixed', 'haystack'=>'array', 'strict='=>'bool'], 'array_shift' => ['mixed', '&rw_stack'=>'array'], 'array_slice' => ['array', 'input'=>'array', 'offset'=>'int', 'length='=>'?int', 'preserve_keys='=>'bool'], 'array_splice' => ['array', '&rw_input'=>'array', 'offset'=>'int', 'length='=>'int', 'replacement='=>'mixed'], 'array_sum' => ['int|float', 'input'=>'array'], 'array_udiff' => ['array', 'arr1'=>'array', 'arr2'=>'array', 'data_comp_func'=>'callable(mixed,mixed):int'], 'array_udiff\'1' => ['array', 'arr1'=>'array', 'arr2'=>'array', 'arr3'=>'array', 'arg4'=>'array|callable(mixed,mixed):int', '...rest='=>'array|callable(mixed,mixed):int'], 'array_udiff_assoc' => ['array', 'arr1'=>'array', 'arr2'=>'array', 'key_comp_func'=>'callable(mixed,mixed):int'], 'array_udiff_assoc\'1' => ['array', 'arr1'=>'array', 'arr2'=>'array', 'arr3'=>'array', 'arg4'=>'array|callable(mixed,mixed):int', '...rest='=>'array|callable(mixed,mixed):int'], 'array_udiff_uassoc' => ['array', 'arr1'=>'array', 'arr2'=>'array', 'data_comp_func'=>'callable', 'key_comp_func'=>'callable(mixed,mixed):int'], 'array_udiff_uassoc\'1' => ['array', 'arr1'=>'array', 'arr2'=>'array', 'arr3'=>'array', 'arg4'=>'array|callable(mixed,mixed):int', 'arg5'=>'array|callable(mixed,mixed):int', '...rest='=>'array|callable(mixed,mixed):int'], 'array_uintersect' => ['array', 'arr1'=>'array', 'arr2'=>'array', 'data_compare_func'=>'callable(mixed,mixed):int'], 'array_uintersect\'1' => ['array', 'arr1'=>'array', 'arr2'=>'array', 'arr3'=>'array', 'arg4'=>'array|callable(mixed,mixed):int', '...rest='=>'array|callable(mixed,mixed):int'], 'array_uintersect_assoc' => ['array', 'arr1'=>'array', 'arr2'=>'array', 'data_compare_func'=>'callable(mixed,mixed):int'], 'array_uintersect_assoc\'1' => ['array', 'arr1'=>'array', 'arr2'=>'array', 'arr3'=>'array', 'arg4'=>'array|callable(mixed,mixed):int', '...rest='=>'array|callable(mixed,mixed):int'], 'array_uintersect_uassoc' => ['array', 'arr1'=>'array', 'arr2'=>'array', 'data_compare_func'=>'callable(mixed,mixed):int', 'key_compare_func'=>'callable(mixed,mixed):int'], 'array_uintersect_uassoc\'1' => ['array', 'arr1'=>'array', 'arr2'=>'array', 'arr3'=>'array', 'arg4'=>'array|callable(mixed,mixed):int', 'arg5'=>'array|callable(mixed,mixed):int', '...rest='=>'array|callable(mixed,mixed):int'], 'array_unique' => ['array', 'array'=>'array', 'flags='=>'int'], 'array_unshift' => ['positive-int', '&rw_stack'=>'array', 'var'=>'mixed', '...vars='=>'mixed'], 'array_values' => ['list<mixed>', 'input'=>'array'], 'array_walk' => ['bool', '&rw_input'=>'array|object', 'callback'=>'callable', 'userdata='=>'mixed'], 'array_walk_recursive' => ['bool', '&rw_input'=>'array|object', 'callback'=>'callable', 'userdata='=>'mixed'], 'ArrayAccess::offsetExists' => ['bool', 'offset'=>'mixed'], 'ArrayAccess::offsetGet' => ['mixed', 'offset'=>'mixed'], 'ArrayAccess::offsetSet' => ['void', 'offset'=>'mixed', 'value'=>'mixed'], 'ArrayAccess::offsetUnset' => ['void', 'offset'=>'mixed'], 'ArrayIterator::__construct' => ['void', 'array='=>'array|object', 'flags='=>'int'], 'ArrayIterator::append' => ['void', 'value'=>'mixed'], 'ArrayIterator::asort' => ['void'], 'ArrayIterator::count' => ['0|positive-int'], 'ArrayIterator::current' => ['mixed'], 'ArrayIterator::getArrayCopy' => ['array'], 'ArrayIterator::getFlags' => ['int'], 'ArrayIterator::key' => ['int|string|false'], 'ArrayIterator::ksort' => ['void'], 'ArrayIterator::natcasesort' => ['void'], 'ArrayIterator::natsort' => ['void'], 'ArrayIterator::next' => ['void'], 'ArrayIterator::offsetExists' => ['bool', 'index'=>'string|int|bool|null'], 'ArrayIterator::offsetGet' => ['mixed', 'index'=>'string|int|bool|null'], 'ArrayIterator::offsetSet' => ['void', 'index'=>'string|int|bool|null', 'newval'=>'mixed'], 'ArrayIterator::offsetUnset' => ['void', 'index'=>'string|int|bool|null'], 'ArrayIterator::rewind' => ['void'], 'ArrayIterator::seek' => ['void', 'position'=>'int'], 'ArrayIterator::serialize' => ['string'], 'ArrayIterator::setFlags' => ['void', 'flags'=>'string'], 'ArrayIterator::uasort' => ['void', 'callback'=>'callable(mixed,mixed):int'], 'ArrayIterator::uksort' => ['void', 'callback'=>'callable(array-key,array-key):int'], 'ArrayIterator::unserialize' => ['void', 'serialized'=>'string'], 'ArrayIterator::valid' => ['bool'], 'ArrayObject::__construct' => ['void', 'input='=>'array|object', 'flags='=>'int', 'iterator_class='=>'class-string'], 'ArrayObject::append' => ['void', 'value'=>'mixed'], 'ArrayObject::asort' => ['void'], 'ArrayObject::count' => ['0|positive-int'], 'ArrayObject::exchangeArray' => ['array', 'ar'=>'mixed'], 'ArrayObject::getArrayCopy' => ['array'], 'ArrayObject::getFlags' => ['int'], 'ArrayObject::getIterator' => ['ArrayIterator'], 'ArrayObject::getIteratorClass' => ['string'], 'ArrayObject::ksort' => ['void'], 'ArrayObject::natcasesort' => ['void'], 'ArrayObject::natsort' => ['void'], 'ArrayObject::offsetExists' => ['bool', 'index'=>'mixed'], 'ArrayObject::offsetGet' => ['mixed', 'index'=>'mixed'], 'ArrayObject::offsetSet' => ['void', 'index'=>'mixed', 'newval'=>'mixed'], 'ArrayObject::offsetUnset' => ['void', 'index'=>'mixed'], 'ArrayObject::serialize' => ['string'], 'ArrayObject::setFlags' => ['void', 'flags'=>'int'], 'ArrayObject::setIteratorClass' => ['void', 'iterator_class'=>'string'], 'ArrayObject::uasort' => ['void', 'callback'=>'callable'], 'ArrayObject::uksort' => ['void', 'callback'=>'callable(array-key,array-key):int'], 'ArrayObject::unserialize' => ['void', 'serialized'=>'string'], 'arsort' => ['bool', '&rw_array_arg'=>'array', 'sort_flags='=>'int'], 'asin' => ['float', 'number'=>'float'], 'asinh' => ['float', 'number'=>'float'], 'asort' => ['bool', '&rw_array_arg'=>'array', 'sort_flags='=>'int'], 'assert' => ['bool', 'assertion'=>'string|bool', 'description='=>'string|Throwable|null'], 'assert_options' => ['mixed', 'what'=>'int', 'value='=>'mixed'], 'ast\get_kind_name' => ['string', 'kind'=>'int'], 'ast\get_metadata' => ['array<int,ast\Metadata>'], 'ast\get_supported_versions' => ['array<int,int>', 'exclude_deprecated='=>'bool'], 'ast\kind_uses_flags' => ['bool', 'kind'=>'int'], 'ast\Node::__construct' => ['void', 'kind='=>'int', 'flags='=>'int', 'children='=>'ast\Node\Decl[]|ast\Node[]|array[]|int[]|string[]|float[]|bool[]|null[]', 'start_line='=>'int'], 'ast\parse_code' => ['ast\Node', 'code'=>'string', 'version'=>'int', 'filename='=>'string'], 'ast\parse_file' => ['ast\Node', 'filename'=>'string', 'version'=>'int'], 'atan' => ['float', 'number'=>'float'], 'atan2' => ['float', 'y'=>'float', 'x'=>'float'], 'atanh' => ['float', 'number'=>'float'], 'BadFunctionCallException::__clone' => ['void'], 'BadFunctionCallException::__construct' => ['void', 'message='=>'string', 'code='=>'int', 'previous='=>'(?Throwable)|(?BadFunctionCallException)'], 'BadFunctionCallException::__toString' => ['string'], 'BadFunctionCallException::getCode' => ['int'], 'BadFunctionCallException::getFile' => ['string'], 'BadFunctionCallException::getLine' => ['int'], 'BadFunctionCallException::getMessage' => ['string'], 'BadFunctionCallException::getPrevious' => ['(?Throwable)|(?BadFunctionCallException)'], 'BadFunctionCallException::getTrace' => ['list<array{function:string,line?:int,file?:string,class?:class-string,type?:\'::\'|\'->\',args?:mixed[],object?:object}>'], 'BadFunctionCallException::getTraceAsString' => ['string'], 'BadMethodCallException::__clone' => ['void'], 'BadMethodCallException::__construct' => ['void', 'message='=>'string', 'code='=>'int', 'previous='=>'(?Throwable)|(?BadMethodCallException)'], 'BadMethodCallException::__toString' => ['string'], 'BadMethodCallException::getCode' => ['int'], 'BadMethodCallException::getFile' => ['string'], 'BadMethodCallException::getLine' => ['int'], 'BadMethodCallException::getMessage' => ['string'], 'BadMethodCallException::getPrevious' => ['(?Throwable)|(?BadMethodCallException)'], 'BadMethodCallException::getTrace' => ['list<array{function:string,line?:int,file?:string,class?:class-string,type?:\'::\'|\'->\',args?:mixed[],object?:object}>'], 'BadMethodCallException::getTraceAsString' => ['string'], 'base64_decode' => ['string', 'str'=>'string', 'strict='=>'false'], 'base64_decode\'1' => ['string|false', 'str'=>'string', 'strict='=>'true'], 'base64_encode' => ['string', 'str'=>'string'], 'base_convert' => ['string', 'number'=>'string', 'frombase'=>'int', 'tobase'=>'int'], 'basename' => ['string', 'path'=>'string', 'suffix='=>'string'], 'bbcode_add_element' => ['bool', 'bbcode_container'=>'resource', 'tag_name'=>'string', 'tag_rules'=>'array'], 'bbcode_add_smiley' => ['bool', 'bbcode_container'=>'resource', 'smiley'=>'string', 'replace_by'=>'string'], 'bbcode_create' => ['resource', 'bbcode_initial_tags='=>'array'], 'bbcode_destroy' => ['bool', 'bbcode_container'=>'resource'], 'bbcode_parse' => ['string', 'bbcode_container'=>'resource', 'to_parse'=>'string'], 'bbcode_set_arg_parser' => ['bool', 'bbcode_container'=>'resource', 'bbcode_arg_parser'=>'resource'], 'bbcode_set_flags' => ['bool', 'bbcode_container'=>'resource', 'flags'=>'int', 'mode='=>'int'], 'bcadd' => ['numeric-string', 'left_operand'=>'string', 'right_operand'=>'string', 'scale='=>'int'], 'bccomp' => ['int', 'left_operand'=>'string', 'right_operand'=>'string', 'scale='=>'int'], 'bcdiv' => ['numeric-string|null', 'left_operand'=>'string', 'right_operand'=>'string', 'scale='=>'int'], 'bcmod' => ['numeric-string|null', 'left_operand'=>'string', 'right_operand'=>'string', 'scale='=>'int'], 'bcmul' => ['numeric-string', 'left_operand'=>'string', 'right_operand'=>'string', 'scale='=>'int'], 'bcompiler_load' => ['bool', 'filename'=>'string'], 'bcompiler_load_exe' => ['bool', 'filename'=>'string'], 'bcompiler_parse_class' => ['bool', 'class'=>'string', 'callback'=>'string'], 'bcompiler_read' => ['bool', 'filehandle'=>'resource'], 'bcompiler_write_class' => ['bool', 'filehandle'=>'resource', 'classname'=>'string', 'extends='=>'string'], 'bcompiler_write_constant' => ['bool', 'filehandle'=>'resource', 'constantname'=>'string'], 'bcompiler_write_exe_footer' => ['bool', 'filehandle'=>'resource', 'startpos'=>'int'], 'bcompiler_write_file' => ['bool', 'filehandle'=>'resource', 'filename'=>'string'], 'bcompiler_write_footer' => ['bool', 'filehandle'=>'resource'], 'bcompiler_write_function' => ['bool', 'filehandle'=>'resource', 'functionname'=>'string'], 'bcompiler_write_functions_from_file' => ['bool', 'filehandle'=>'resource', 'filename'=>'string'], 'bcompiler_write_header' => ['bool', 'filehandle'=>'resource', 'write_ver='=>'string'], 'bcompiler_write_included_filename' => ['bool', 'filehandle'=>'resource', 'filename'=>'string'], 'bcpow' => ['numeric-string', 'base'=>'string', 'exponent'=>'string', 'scale='=>'int'], 'bcpowmod' => ['numeric-string|null', 'base'=>'string', 'exponent'=>'string', 'modulus'=>'string', 'scale='=>'int'], 'bcscale' => ['int', 'scale='=>'int'], 'bcsqrt' => ['numeric-string', 'operand'=>'string', 'scale='=>'int'], 'bcsub' => ['numeric-string', 'left_operand'=>'string', 'right_operand'=>'string', 'scale='=>'int'], 'bin2hex' => ['string', 'data'=>'string'], 'bind_textdomain_codeset' => ['string|false', 'domain'=>'string', 'codeset'=>'string'], 'bindec' => ['float|int', 'binary_number'=>'string'], 'bindtextdomain' => ['string|false', 'domain_name'=>'string', 'dir'=>'string'], 'birdstep_autocommit' => ['bool', 'index'=>'int'], 'birdstep_close' => ['bool', 'id'=>'int'], 'birdstep_commit' => ['bool', 'index'=>'int'], 'birdstep_connect' => ['int', 'server'=>'string', 'user'=>'string', 'pass'=>'string'], 'birdstep_exec' => ['int', 'index'=>'int', 'exec_str'=>'string'], 'birdstep_fetch' => ['bool', 'index'=>'int'], 'birdstep_fieldname' => ['string', 'index'=>'int', 'col'=>'int'], 'birdstep_fieldnum' => ['int', 'index'=>'int'], 'birdstep_freeresult' => ['bool', 'index'=>'int'], 'birdstep_off_autocommit' => ['bool', 'index'=>'int'], 'birdstep_result' => ['', 'index'=>'int', 'col'=>''], 'birdstep_rollback' => ['bool', 'index'=>'int'], 'blenc_encrypt' => ['string', 'plaintext'=>'string', 'encodedfile'=>'string', 'encryption_key='=>'string'], 'boolval' => ['bool', 'var'=>'mixed'], 'BSON\Binary::__construct' => ['void', 'data'=>'string', 'subtype'=>'string'], 'BSON\Binary::getSubType' => [''], 'BSON\fromArray' => ['string', 'array'=>'string'], 'BSON\fromJSON' => ['string', 'json'=>'string'], 'BSON\Javascript::__construct' => ['void', 'javascript'=>'string', 'scope='=>'string'], 'BSON\ObjectID::__construct' => ['void', 'id='=>'string'], 'BSON\ObjectID::__toString' => ['string'], 'BSON\Regex::__construct' => ['void', 'pattern'=>'string', 'flags'=>'string'], 'BSON\Regex::__toString' => ['string'], 'BSON\Regex::getFlags' => [''], 'BSON\Regex::getPattern' => [''], 'BSON\Serializable::bsonSerialize' => ['string'], 'BSON\Timestamp::__construct' => ['void', 'increment'=>'string', 'timestamp'=>'string'], 'BSON\Timestamp::__toString' => ['string'], 'BSON\toArray' => ['array', 'bson'=>'string'], 'BSON\toJSON' => ['string', 'bson'=>'string'], 'BSON\Unserializable::bsonUnserialize' => ['', 'data'=>'array'], 'BSON\UTCDatetime::__construct' => ['void', 'milliseconds'=>'string'], 'BSON\UTCDatetime::__toString' => ['string'], 'BSON\UTCDatetime::toDateTime' => [''], 'bson_decode' => ['array', 'bson'=>'string'], 'bson_encode' => ['string', 'anything'=>'mixed'], 'bzclose' => ['bool', 'bz'=>'resource'], 'bzcompress' => ['string|int', 'source'=>'string', 'blocksize100k='=>'int', 'workfactor='=>'int'], 'bzdecompress' => ['string|false', 'source'=>'string', 'small='=>'int'], 'bzerrno' => ['int', 'bz'=>'resource'], 'bzerror' => ['array', 'bz'=>'resource'], 'bzerrstr' => ['string', 'bz'=>'resource'], 'bzflush' => ['bool', 'bz'=>'resource'], 'bzopen' => ['resource|false', 'file'=>'string|resource', 'mode'=>'string'], 'bzread' => ['string|false', 'bz'=>'resource', 'length='=>'int'], 'bzwrite' => ['int|false', 'bz'=>'resource', 'data'=>'string', 'length='=>'int'], 'CachingIterator::__construct' => ['void', 'iterator'=>'Iterator', 'flags='=>''], 'CachingIterator::__toString' => ['string'], 'CachingIterator::count' => ['0|positive-int'], 'CachingIterator::current' => ['mixed'], 'CachingIterator::getCache' => ['array'], 'CachingIterator::getFlags' => ['int'], 'CachingIterator::getInnerIterator' => ['Iterator'], 'CachingIterator::hasNext' => ['bool'], 'CachingIterator::key' => ['mixed'], 'CachingIterator::next' => ['void'], 'CachingIterator::offsetExists' => ['bool', 'index'=>'string'], 'CachingIterator::offsetGet' => ['mixed', 'index'=>'string'], 'CachingIterator::offsetSet' => ['void', 'index'=>'string', 'newval'=>'mixed'], 'CachingIterator::offsetUnset' => ['void', 'index'=>'string'], 'CachingIterator::rewind' => ['void'], 'CachingIterator::setFlags' => ['void', 'flags'=>'int'], 'CachingIterator::valid' => ['bool'], 'Cairo::availableFonts' => ['array'], 'Cairo::availableSurfaces' => ['array'], 'Cairo::statusToString' => ['string', 'status'=>'int'], 'Cairo::version' => ['int'], 'Cairo::versionString' => ['string'], 'cairo_append_path' => ['', 'path'=>'cairopath', 'context'=>'cairocontext'], 'cairo_arc' => ['', 'x'=>'float', 'y'=>'float', 'radius'=>'float', 'angle1'=>'float', 'angle2'=>'float', 'context'=>'cairocontext'], 'cairo_arc_negative' => ['', 'x'=>'float', 'y'=>'float', 'radius'=>'float', 'angle1'=>'float', 'angle2'=>'float', 'context'=>'cairocontext'], 'cairo_available_fonts' => ['array'], 'cairo_available_surfaces' => ['array'], 'cairo_clip' => ['', 'context'=>'cairocontext'], 'cairo_clip_extents' => ['array', 'context'=>'cairocontext'], 'cairo_clip_preserve' => ['', 'context'=>'cairocontext'], 'cairo_clip_rectangle_list' => ['array', 'context'=>'cairocontext'], 'cairo_close_path' => ['', 'context'=>'cairocontext'], 'cairo_copy_page' => ['', 'context'=>'cairocontext'], 'cairo_copy_path' => ['CairoPath', 'context'=>'cairocontext'], 'cairo_copy_path_flat' => ['CairoPath', 'context'=>'cairocontext'], 'cairo_create' => ['CairoContext', 'surface'=>'cairosurface'], 'cairo_curve_to' => ['', 'x1'=>'float', 'y1'=>'float', 'x2'=>'float', 'y2'=>'float', 'x3'=>'float', 'y3'=>'float', 'context'=>'cairocontext'], 'cairo_device_to_user' => ['array', 'x'=>'float', 'y'=>'float', 'context'=>'cairocontext'], 'cairo_device_to_user_distance' => ['array', 'x'=>'float', 'y'=>'float', 'context'=>'cairocontext'], 'cairo_fill' => ['', 'context'=>'cairocontext'], 'cairo_fill_extents' => ['array', 'context'=>'cairocontext'], 'cairo_fill_preserve' => ['', 'context'=>'cairocontext'], 'cairo_font_extents' => ['array', 'context'=>'cairocontext'], 'cairo_font_face_get_type' => ['int', 'fontface'=>'cairofontface'], 'cairo_font_face_status' => ['int', 'fontface'=>'cairofontface'], 'cairo_font_options_create' => ['CairoFontOptions'], 'cairo_font_options_equal' => ['bool', 'options'=>'cairofontoptions', 'other'=>'cairofontoptions'], 'cairo_font_options_get_antialias' => ['int', 'options'=>'cairofontoptions'], 'cairo_font_options_get_hint_metrics' => ['int', 'options'=>'cairofontoptions'], 'cairo_font_options_get_hint_style' => ['int', 'options'=>'cairofontoptions'], 'cairo_font_options_get_subpixel_order' => ['int', 'options'=>'cairofontoptions'], 'cairo_font_options_hash' => ['int', 'options'=>'cairofontoptions'], 'cairo_font_options_merge' => ['void', 'options'=>'cairofontoptions', 'other'=>'cairofontoptions'], 'cairo_font_options_set_antialias' => ['void', 'options'=>'cairofontoptions', 'antialias'=>'int'], 'cairo_font_options_set_hint_metrics' => ['void', 'options'=>'cairofontoptions', 'hint_metrics'=>'int'], 'cairo_font_options_set_hint_style' => ['void', 'options'=>'cairofontoptions', 'hint_style'=>'int'], 'cairo_font_options_set_subpixel_order' => ['void', 'options'=>'cairofontoptions', 'subpixel_order'=>'int'], 'cairo_font_options_status' => ['int', 'options'=>'cairofontoptions'], 'cairo_format_stride_for_width' => ['int', 'format'=>'int', 'width'=>'int'], 'cairo_get_antialias' => ['int', 'context'=>'cairocontext'], 'cairo_get_current_point' => ['array', 'context'=>'cairocontext'], 'cairo_get_dash' => ['array', 'context'=>'cairocontext'], 'cairo_get_dash_count' => ['int', 'context'=>'cairocontext'], 'cairo_get_fill_rule' => ['int', 'context'=>'cairocontext'], 'cairo_get_font_face' => ['', 'context'=>'cairocontext'], 'cairo_get_font_matrix' => ['', 'context'=>'cairocontext'], 'cairo_get_font_options' => ['', 'context'=>'cairocontext'], 'cairo_get_group_target' => ['', 'context'=>'cairocontext'], 'cairo_get_line_cap' => ['int', 'context'=>'cairocontext'], 'cairo_get_line_join' => ['int', 'context'=>'cairocontext'], 'cairo_get_line_width' => ['float', 'context'=>'cairocontext'], 'cairo_get_matrix' => ['', 'context'=>'cairocontext'], 'cairo_get_miter_limit' => ['float', 'context'=>'cairocontext'], 'cairo_get_operator' => ['int', 'context'=>'cairocontext'], 'cairo_get_scaled_font' => ['', 'context'=>'cairocontext'], 'cairo_get_source' => ['', 'context'=>'cairocontext'], 'cairo_get_target' => ['', 'context'=>'cairocontext'], 'cairo_get_tolerance' => ['float', 'context'=>'cairocontext'], 'cairo_glyph_path' => ['', 'glyphs'=>'array', 'context'=>'cairocontext'], 'cairo_has_current_point' => ['bool', 'context'=>'cairocontext'], 'cairo_identity_matrix' => ['', 'context'=>'cairocontext'], 'cairo_image_surface_create' => ['CairoImageSurface', 'format'=>'int', 'width'=>'int', 'height'=>'int'], 'cairo_image_surface_create_for_data' => ['CairoImageSurface', 'data'=>'string', 'format'=>'int', 'width'=>'int', 'height'=>'int', 'stride='=>'int'], 'cairo_image_surface_create_from_png' => ['CairoImageSurface', 'file'=>'string'], 'cairo_image_surface_get_data' => ['string', 'surface'=>'cairoimagesurface'], 'cairo_image_surface_get_format' => ['int', 'surface'=>'cairoimagesurface'], 'cairo_image_surface_get_height' => ['int', 'surface'=>'cairoimagesurface'], 'cairo_image_surface_get_stride' => ['int', 'surface'=>'cairoimagesurface'], 'cairo_image_surface_get_width' => ['int', 'surface'=>'cairoimagesurface'], 'cairo_in_fill' => ['bool', 'x'=>'string', 'y'=>'string', 'context'=>'cairocontext'], 'cairo_in_stroke' => ['bool', 'x'=>'string', 'y'=>'string', 'context'=>'cairocontext'], 'cairo_line_to' => ['', 'x'=>'string', 'y'=>'string', 'context'=>'cairocontext'], 'cairo_mask' => ['', 'pattern'=>'cairopattern', 'context'=>'cairocontext'], 'cairo_mask_surface' => ['', 'surface'=>'cairosurface', 'x='=>'string', 'y='=>'string', 'context='=>'cairocontext'], 'cairo_matrix_create_scale' => ['object', 'sx'=>'float', 'sy'=>'float'], 'cairo_matrix_init' => ['object', 'xx='=>'float', 'yx='=>'float', 'xy='=>'float', 'yy='=>'float', 'x0='=>'float', 'y0='=>'float'], 'cairo_matrix_init_identity' => ['object'], 'cairo_matrix_init_rotate' => ['object', 'radians'=>'float'], 'cairo_matrix_init_scale' => ['object', 'sx'=>'float', 'sy'=>'float'], 'cairo_matrix_init_translate' => ['object', 'tx'=>'float', 'ty'=>'float'], 'cairo_matrix_invert' => ['void', 'matrix'=>'cairomatrix'], 'cairo_matrix_multiply' => ['CairoMatrix', 'matrix1'=>'cairomatrix', 'matrix2'=>'cairomatrix'], 'cairo_matrix_rotate' => ['', 'matrix'=>'cairomatrix', 'radians'=>'float'], 'cairo_matrix_scale' => ['', 'sx'=>'float', 'sy'=>'float', 'context'=>'cairocontext'], 'cairo_matrix_transform_distance' => ['array', 'matrix'=>'cairomatrix', 'dx'=>'float', 'dy'=>'float'], 'cairo_matrix_transform_point' => ['array', 'matrix'=>'cairomatrix', 'dx'=>'float', 'dy'=>'float'], 'cairo_matrix_translate' => ['void', 'matrix'=>'cairomatrix', 'tx'=>'float', 'ty'=>'float'], 'cairo_move_to' => ['', 'x'=>'string', 'y'=>'string', 'context'=>'cairocontext'], 'cairo_new_path' => ['', 'context'=>'cairocontext'], 'cairo_new_sub_path' => ['', 'context'=>'cairocontext'], 'cairo_paint' => ['', 'context'=>'cairocontext'], 'cairo_paint_with_alpha' => ['', 'alpha'=>'string', 'context'=>'cairocontext'], 'cairo_path_extents' => ['array', 'context'=>'cairocontext'], 'cairo_pattern_add_color_stop_rgb' => ['void', 'pattern'=>'cairogradientpattern', 'offset'=>'float', 'red'=>'float', 'green'=>'float', 'blue'=>'float'], 'cairo_pattern_add_color_stop_rgba' => ['void', 'pattern'=>'cairogradientpattern', 'offset'=>'float', 'red'=>'float', 'green'=>'float', 'blue'=>'float', 'alpha'=>'float'], 'cairo_pattern_create_for_surface' => ['CairoPattern', 'surface'=>'cairosurface'], 'cairo_pattern_create_linear' => ['CairoPattern', 'x0'=>'float', 'y0'=>'float', 'x1'=>'float', 'y1'=>'float'], 'cairo_pattern_create_radial' => ['CairoPattern', 'x0'=>'float', 'y0'=>'float', 'r0'=>'float', 'x1'=>'float', 'y1'=>'float', 'r1'=>'float'], 'cairo_pattern_create_rgb' => ['CairoPattern', 'red'=>'float', 'green'=>'float', 'blue'=>'float'], 'cairo_pattern_create_rgba' => ['CairoPattern', 'red'=>'float', 'green'=>'float', 'blue'=>'float', 'alpha'=>'float'], 'cairo_pattern_get_color_stop_count' => ['int', 'pattern'=>'cairogradientpattern'], 'cairo_pattern_get_color_stop_rgba' => ['array', 'pattern'=>'cairogradientpattern', 'index'=>'int'], 'cairo_pattern_get_extend' => ['int', 'pattern'=>'string'], 'cairo_pattern_get_filter' => ['int', 'pattern'=>'cairosurfacepattern'], 'cairo_pattern_get_linear_points' => ['array', 'pattern'=>'cairolineargradient'], 'cairo_pattern_get_matrix' => ['CairoMatrix', 'pattern'=>'cairopattern'], 'cairo_pattern_get_radial_circles' => ['array', 'pattern'=>'cairoradialgradient'], 'cairo_pattern_get_rgba' => ['array', 'pattern'=>'cairosolidpattern'], 'cairo_pattern_get_surface' => ['CairoSurface', 'pattern'=>'cairosurfacepattern'], 'cairo_pattern_get_type' => ['int', 'pattern'=>'cairopattern'], 'cairo_pattern_set_extend' => ['void', 'pattern'=>'string', 'extend'=>'string'], 'cairo_pattern_set_filter' => ['void', 'pattern'=>'cairosurfacepattern', 'filter'=>'int'], 'cairo_pattern_set_matrix' => ['void', 'pattern'=>'cairopattern', 'matrix'=>'cairomatrix'], 'cairo_pattern_status' => ['int', 'pattern'=>'cairopattern'], 'cairo_pdf_surface_create' => ['CairoPdfSurface', 'file'=>'string', 'width'=>'float', 'height'=>'float'], 'cairo_pdf_surface_set_size' => ['void', 'surface'=>'cairopdfsurface', 'width'=>'float', 'height'=>'float'], 'cairo_pop_group' => ['', 'context'=>'cairocontext'], 'cairo_pop_group_to_source' => ['', 'context'=>'cairocontext'], 'cairo_ps_get_levels' => ['array'], 'cairo_ps_level_to_string' => ['string', 'level'=>'int'], 'cairo_ps_surface_create' => ['CairoPsSurface', 'file'=>'string', 'width'=>'float', 'height'=>'float'], 'cairo_ps_surface_dsc_begin_page_setup' => ['void', 'surface'=>'cairopssurface'], 'cairo_ps_surface_dsc_begin_setup' => ['void', 'surface'=>'cairopssurface'], 'cairo_ps_surface_dsc_comment' => ['void', 'surface'=>'cairopssurface', 'comment'=>'string'], 'cairo_ps_surface_get_eps' => ['bool', 'surface'=>'cairopssurface'], 'cairo_ps_surface_restrict_to_level' => ['void', 'surface'=>'cairopssurface', 'level'=>'int'], 'cairo_ps_surface_set_eps' => ['void', 'surface'=>'cairopssurface', 'level'=>'bool'], 'cairo_ps_surface_set_size' => ['void', 'surface'=>'cairopssurface', 'width'=>'float', 'height'=>'float'], 'cairo_push_group' => ['', 'context'=>'cairocontext'], 'cairo_push_group_with_content' => ['', 'content'=>'string', 'context'=>'cairocontext'], 'cairo_rectangle' => ['', 'x'=>'string', 'y'=>'string', 'width'=>'string', 'height'=>'string', 'context'=>'cairocontext'], 'cairo_rel_curve_to' => ['', 'x1'=>'string', 'y1'=>'string', 'x2'=>'string', 'y2'=>'string', 'x3'=>'string', 'y3'=>'string', 'context'=>'cairocontext'], 'cairo_rel_line_to' => ['', 'x'=>'string', 'y'=>'string', 'context'=>'cairocontext'], 'cairo_rel_move_to' => ['', 'x'=>'string', 'y'=>'string', 'context'=>'cairocontext'], 'cairo_reset_clip' => ['', 'context'=>'cairocontext'], 'cairo_restore' => ['', 'context'=>'cairocontext'], 'cairo_rotate' => ['', 'sx'=>'string', 'sy'=>'string', 'context'=>'cairocontext', 'angle'=>'string'], 'cairo_save' => ['', 'context'=>'cairocontext'], 'cairo_scale' => ['', 'x'=>'string', 'y'=>'string', 'context'=>'cairocontext'], 'cairo_scaled_font_create' => ['CairoScaledFont', 'fontface'=>'cairofontface', 'matrix'=>'cairomatrix', 'ctm'=>'cairomatrix', 'fontoptions'=>'cairofontoptions'], 'cairo_scaled_font_extents' => ['array', 'scaledfont'=>'cairoscaledfont'], 'cairo_scaled_font_get_ctm' => ['CairoMatrix', 'scaledfont'=>'cairoscaledfont'], 'cairo_scaled_font_get_font_face' => ['CairoFontFace', 'scaledfont'=>'cairoscaledfont'], 'cairo_scaled_font_get_font_matrix' => ['CairoFontOptions', 'scaledfont'=>'cairoscaledfont'], 'cairo_scaled_font_get_font_options' => ['CairoFontOptions', 'scaledfont'=>'cairoscaledfont'], 'cairo_scaled_font_get_scale_matrix' => ['CairoMatrix', 'scaledfont'=>'cairoscaledfont'], 'cairo_scaled_font_get_type' => ['int', 'scaledfont'=>'cairoscaledfont'], 'cairo_scaled_font_glyph_extents' => ['array', 'scaledfont'=>'cairoscaledfont', 'glyphs'=>'array'], 'cairo_scaled_font_status' => ['int', 'scaledfont'=>'cairoscaledfont'], 'cairo_scaled_font_text_extents' => ['array', 'scaledfont'=>'cairoscaledfont', 'text'=>'string'], 'cairo_select_font_face' => ['', 'family'=>'string', 'slant='=>'string', 'weight='=>'string', 'context='=>'cairocontext'], 'cairo_set_antialias' => ['', 'antialias='=>'string', 'context='=>'cairocontext'], 'cairo_set_dash' => ['', 'dashes'=>'array', 'offset='=>'string', 'context='=>'cairocontext'], 'cairo_set_fill_rule' => ['', 'setting'=>'string', 'context'=>'cairocontext'], 'cairo_set_font_face' => ['', 'fontface'=>'cairofontface', 'context'=>'cairocontext'], 'cairo_set_font_matrix' => ['', 'matrix'=>'cairomatrix', 'context'=>'cairocontext'], 'cairo_set_font_options' => ['', 'fontoptions'=>'cairofontoptions', 'context'=>'cairocontext'], 'cairo_set_font_size' => ['', 'size'=>'string', 'context'=>'cairocontext'], 'cairo_set_line_cap' => ['', 'setting'=>'string', 'context'=>'cairocontext'], 'cairo_set_line_join' => ['', 'setting'=>'string', 'context'=>'cairocontext'], 'cairo_set_line_width' => ['', 'width'=>'string', 'context'=>'cairocontext'], 'cairo_set_matrix' => ['', 'matrix'=>'cairomatrix', 'context'=>'cairocontext'], 'cairo_set_miter_limit' => ['', 'limit'=>'string', 'context'=>'cairocontext'], 'cairo_set_operator' => ['', 'setting'=>'string', 'context'=>'cairocontext'], 'cairo_set_scaled_font' => ['', 'scaledfont'=>'cairoscaledfont', 'context'=>'cairocontext'], 'cairo_set_source' => ['', 'red'=>'string', 'green'=>'string', 'blue'=>'string', 'alpha'=>'string', 'context'=>'cairocontext', 'pattern'=>'cairopattern'], 'cairo_set_source_surface' => ['', 'surface'=>'cairosurface', 'x='=>'string', 'y='=>'string', 'context='=>'cairocontext'], 'cairo_set_tolerance' => ['', 'tolerance'=>'string', 'context'=>'cairocontext'], 'cairo_show_page' => ['', 'context'=>'cairocontext'], 'cairo_show_text' => ['', 'text'=>'string', 'context'=>'cairocontext'], 'cairo_status' => ['int', 'context'=>'cairocontext'], 'cairo_status_to_string' => ['string', 'status'=>'int'], 'cairo_stroke' => ['', 'context'=>'cairocontext'], 'cairo_stroke_extents' => ['array', 'context'=>'cairocontext'], 'cairo_stroke_preserve' => ['', 'context'=>'cairocontext'], 'cairo_surface_copy_page' => ['void', 'surface'=>'cairosurface'], 'cairo_surface_create_similar' => ['CairoSurface', 'surface'=>'cairosurface', 'content'=>'int', 'width'=>'float', 'height'=>'float'], 'cairo_surface_finish' => ['void', 'surface'=>'cairosurface'], 'cairo_surface_flush' => ['void', 'surface'=>'cairosurface'], 'cairo_surface_get_content' => ['int', 'surface'=>'cairosurface'], 'cairo_surface_get_device_offset' => ['array', 'surface'=>'cairosurface'], 'cairo_surface_get_font_options' => ['CairoFontOptions', 'surface'=>'cairosurface'], 'cairo_surface_get_type' => ['int', 'surface'=>'cairosurface'], 'cairo_surface_mark_dirty' => ['void', 'surface'=>'cairosurface'], 'cairo_surface_mark_dirty_rectangle' => ['void', 'surface'=>'cairosurface', 'x'=>'float', 'y'=>'float', 'width'=>'float', 'height'=>'float'], 'cairo_surface_set_device_offset' => ['void', 'surface'=>'cairosurface', 'x'=>'float', 'y'=>'float'], 'cairo_surface_set_fallback_resolution' => ['void', 'surface'=>'cairosurface', 'x'=>'float', 'y'=>'float'], 'cairo_surface_show_page' => ['void', 'surface'=>'cairosurface'], 'cairo_surface_status' => ['int', 'surface'=>'cairosurface'], 'cairo_surface_write_to_png' => ['void', 'surface'=>'cairosurface', 'stream'=>'resource'], 'cairo_svg_get_versions' => ['array'], 'cairo_svg_surface_create' => ['CairoSvgSurface', 'file'=>'string', 'width'=>'float', 'height'=>'float'], 'cairo_svg_surface_get_versions' => ['array'], 'cairo_svg_surface_restrict_to_version' => ['void', 'surface'=>'cairosvgsurface', 'version'=>'int'], 'cairo_svg_version_to_string' => ['string', 'version'=>'int'], 'cairo_text_extents' => ['array', 'text'=>'string', 'context'=>'cairocontext'], 'cairo_text_path' => ['', 'string'=>'string', 'context'=>'cairocontext', 'text'=>'string'], 'cairo_transform' => ['', 'matrix'=>'cairomatrix', 'context'=>'cairocontext'], 'cairo_translate' => ['', 'tx'=>'string', 'ty'=>'string', 'context'=>'cairocontext', 'x'=>'string', 'y'=>'string'], 'cairo_user_to_device' => ['array', 'x'=>'string', 'y'=>'string', 'context'=>'cairocontext'], 'cairo_user_to_device_distance' => ['array', 'x'=>'string', 'y'=>'string', 'context'=>'cairocontext'], 'cairo_version' => ['int'], 'cairo_version_string' => ['string'], 'CairoContext::__construct' => ['void', 'surface'=>'CairoSurface'], 'CairoContext::appendPath' => ['', 'path'=>'cairopath', 'context'=>'cairocontext'], 'CairoContext::arc' => ['', 'x'=>'float', 'y'=>'float', 'radius'=>'float', 'angle1'=>'float', 'angle2'=>'float', 'context'=>'cairocontext'], 'CairoContext::arcNegative' => ['', 'x'=>'float', 'y'=>'float', 'radius'=>'float', 'angle1'=>'float', 'angle2'=>'float', 'context'=>'cairocontext'], 'CairoContext::clip' => ['', 'context'=>'cairocontext'], 'CairoContext::clipExtents' => ['array', 'context'=>'cairocontext'], 'CairoContext::clipPreserve' => ['', 'context'=>'cairocontext'], 'CairoContext::clipRectangleList' => ['array', 'context'=>'cairocontext'], 'CairoContext::closePath' => ['', 'context'=>'cairocontext'], 'CairoContext::copyPage' => ['', 'context'=>'cairocontext'], 'CairoContext::copyPath' => ['CairoPath', 'context'=>'cairocontext'], 'CairoContext::copyPathFlat' => ['CairoPath', 'context'=>'cairocontext'], 'CairoContext::curveTo' => ['', 'x1'=>'float', 'y1'=>'float', 'x2'=>'float', 'y2'=>'float', 'x3'=>'float', 'y3'=>'float', 'context'=>'cairocontext'], 'CairoContext::deviceToUser' => ['array', 'x'=>'float', 'y'=>'float', 'context'=>'cairocontext'], 'CairoContext::deviceToUserDistance' => ['array', 'x'=>'float', 'y'=>'float', 'context'=>'cairocontext'], 'CairoContext::fill' => ['', 'context'=>'cairocontext'], 'CairoContext::fillExtents' => ['array', 'context'=>'cairocontext'], 'CairoContext::fillPreserve' => ['', 'context'=>'cairocontext'], 'CairoContext::fontExtents' => ['array', 'context'=>'cairocontext'], 'CairoContext::getAntialias' => ['int', 'context'=>'cairocontext'], 'CairoContext::getCurrentPoint' => ['array', 'context'=>'cairocontext'], 'CairoContext::getDash' => ['array', 'context'=>'cairocontext'], 'CairoContext::getDashCount' => ['int', 'context'=>'cairocontext'], 'CairoContext::getFillRule' => ['int', 'context'=>'cairocontext'], 'CairoContext::getFontFace' => ['', 'context'=>'cairocontext'], 'CairoContext::getFontMatrix' => ['', 'context'=>'cairocontext'], 'CairoContext::getFontOptions' => ['', 'context'=>'cairocontext'], 'CairoContext::getGroupTarget' => ['', 'context'=>'cairocontext'], 'CairoContext::getLineCap' => ['int', 'context'=>'cairocontext'], 'CairoContext::getLineJoin' => ['int', 'context'=>'cairocontext'], 'CairoContext::getLineWidth' => ['float', 'context'=>'cairocontext'], 'CairoContext::getMatrix' => ['', 'context'=>'cairocontext'], 'CairoContext::getMiterLimit' => ['float', 'context'=>'cairocontext'], 'CairoContext::getOperator' => ['int', 'context'=>'cairocontext'], 'CairoContext::getScaledFont' => ['', 'context'=>'cairocontext'], 'CairoContext::getSource' => ['', 'context'=>'cairocontext'], 'CairoContext::getTarget' => ['', 'context'=>'cairocontext'], 'CairoContext::getTolerance' => ['float', 'context'=>'cairocontext'], 'CairoContext::glyphPath' => ['', 'glyphs'=>'array', 'context'=>'cairocontext'], 'CairoContext::hasCurrentPoint' => ['bool', 'context'=>'cairocontext'], 'CairoContext::identityMatrix' => ['', 'context'=>'cairocontext'], 'CairoContext::inFill' => ['bool', 'x'=>'string', 'y'=>'string', 'context'=>'cairocontext'], 'CairoContext::inStroke' => ['bool', 'x'=>'string', 'y'=>'string', 'context'=>'cairocontext'], 'CairoContext::lineTo' => ['', 'x'=>'string', 'y'=>'string', 'context'=>'cairocontext'], 'CairoContext::mask' => ['', 'pattern'=>'cairopattern', 'context'=>'cairocontext'], 'CairoContext::maskSurface' => ['', 'surface'=>'cairosurface', 'x='=>'string', 'y='=>'string', 'context='=>'cairocontext'], 'CairoContext::moveTo' => ['', 'x'=>'string', 'y'=>'string', 'context'=>'cairocontext'], 'CairoContext::newPath' => ['', 'context'=>'cairocontext'], 'CairoContext::newSubPath' => ['', 'context'=>'cairocontext'], 'CairoContext::paint' => ['', 'context'=>'cairocontext'], 'CairoContext::paintWithAlpha' => ['', 'alpha'=>'string', 'context'=>'cairocontext'], 'CairoContext::pathExtents' => ['array', 'context'=>'cairocontext'], 'CairoContext::popGroup' => ['', 'context'=>'cairocontext'], 'CairoContext::popGroupToSource' => ['', 'context'=>'cairocontext'], 'CairoContext::pushGroup' => ['', 'context'=>'cairocontext'], 'CairoContext::pushGroupWithContent' => ['', 'content'=>'string', 'context'=>'cairocontext'], 'CairoContext::rectangle' => ['', 'x'=>'string', 'y'=>'string', 'width'=>'string', 'height'=>'string', 'context'=>'cairocontext'], 'CairoContext::relCurveTo' => ['', 'x1'=>'string', 'y1'=>'string', 'x2'=>'string', 'y2'=>'string', 'x3'=>'string', 'y3'=>'string', 'context'=>'cairocontext'], 'CairoContext::relLineTo' => ['', 'x'=>'string', 'y'=>'string', 'context'=>'cairocontext'], 'CairoContext::relMoveTo' => ['', 'x'=>'string', 'y'=>'string', 'context'=>'cairocontext'], 'CairoContext::resetClip' => ['', 'context'=>'cairocontext'], 'CairoContext::restore' => ['', 'context'=>'cairocontext'], 'CairoContext::rotate' => ['', 'angle'=>'string', 'context'=>'cairocontext'], 'CairoContext::save' => ['', 'context'=>'cairocontext'], 'CairoContext::scale' => ['', 'x'=>'string', 'y'=>'string', 'context'=>'cairocontext'], 'CairoContext::selectFontFace' => ['', 'family'=>'string', 'slant='=>'string', 'weight='=>'string', 'context='=>'cairocontext'], 'CairoContext::setAntialias' => ['', 'antialias='=>'string', 'context='=>'cairocontext'], 'CairoContext::setDash' => ['', 'dashes'=>'array', 'offset='=>'string', 'context='=>'cairocontext'], 'CairoContext::setFillRule' => ['', 'setting'=>'string', 'context'=>'cairocontext'], 'CairoContext::setFontFace' => ['', 'fontface'=>'cairofontface', 'context'=>'cairocontext'], 'CairoContext::setFontMatrix' => ['', 'matrix'=>'cairomatrix', 'context'=>'cairocontext'], 'CairoContext::setFontOptions' => ['', 'fontoptions'=>'cairofontoptions', 'context'=>'cairocontext'], 'CairoContext::setFontSize' => ['', 'size'=>'string', 'context'=>'cairocontext'], 'CairoContext::setLineCap' => ['', 'setting'=>'string', 'context'=>'cairocontext'], 'CairoContext::setLineJoin' => ['', 'setting'=>'string', 'context'=>'cairocontext'], 'CairoContext::setLineWidth' => ['', 'width'=>'string', 'context'=>'cairocontext'], 'CairoContext::setMatrix' => ['', 'matrix'=>'cairomatrix', 'context'=>'cairocontext'], 'CairoContext::setMiterLimit' => ['', 'limit'=>'string', 'context'=>'cairocontext'], 'CairoContext::setOperator' => ['', 'setting'=>'string', 'context'=>'cairocontext'], 'CairoContext::setScaledFont' => ['', 'scaledfont'=>'cairoscaledfont', 'context'=>'cairocontext'], 'CairoContext::setSource' => ['', 'pattern'=>'cairopattern', 'context'=>'cairocontext'], 'CairoContext::setSourceRGB' => ['', 'red'=>'string', 'green'=>'string', 'blue'=>'string', 'context'=>'cairocontext', 'pattern'=>'cairopattern'], 'CairoContext::setSourceRGBA' => ['', 'red'=>'string', 'green'=>'string', 'blue'=>'string', 'alpha'=>'string', 'context'=>'cairocontext', 'pattern'=>'cairopattern'], 'CairoContext::setSourceSurface' => ['', 'surface'=>'cairosurface', 'x='=>'string', 'y='=>'string', 'context='=>'cairocontext'], 'CairoContext::setTolerance' => ['', 'tolerance'=>'string', 'context'=>'cairocontext'], 'CairoContext::showPage' => ['', 'context'=>'cairocontext'], 'CairoContext::showText' => ['', 'text'=>'string', 'context'=>'cairocontext'], 'CairoContext::status' => ['int', 'context'=>'cairocontext'], 'CairoContext::stroke' => ['', 'context'=>'cairocontext'], 'CairoContext::strokeExtents' => ['array', 'context'=>'cairocontext'], 'CairoContext::strokePreserve' => ['', 'context'=>'cairocontext'], 'CairoContext::textExtents' => ['array', 'text'=>'string', 'context'=>'cairocontext'], 'CairoContext::textPath' => ['', 'string'=>'string', 'context'=>'cairocontext', 'text'=>'string'], 'CairoContext::transform' => ['', 'matrix'=>'cairomatrix', 'context'=>'cairocontext'], 'CairoContext::translate' => ['', 'x'=>'string', 'y'=>'string', 'context'=>'cairocontext'], 'CairoContext::userToDevice' => ['array', 'x'=>'string', 'y'=>'string', 'context'=>'cairocontext'], 'CairoContext::userToDeviceDistance' => ['array', 'x'=>'string', 'y'=>'string', 'context'=>'cairocontext'], 'CairoFontFace::__construct' => ['void'], 'CairoFontFace::getType' => ['int'], 'CairoFontFace::status' => ['int', 'fontface'=>'cairofontface'], 'CairoFontOptions::__construct' => ['void'], 'CairoFontOptions::equal' => ['bool', 'other'=>'string'], 'CairoFontOptions::getAntialias' => ['int', 'context'=>'cairocontext'], 'CairoFontOptions::getHintMetrics' => ['int'], 'CairoFontOptions::getHintStyle' => ['int'], 'CairoFontOptions::getSubpixelOrder' => ['int'], 'CairoFontOptions::hash' => ['int'], 'CairoFontOptions::merge' => ['void', 'other'=>'string'], 'CairoFontOptions::setAntialias' => ['', 'antialias='=>'string', 'context='=>'cairocontext'], 'CairoFontOptions::setHintMetrics' => ['void', 'hint_metrics'=>'string'], 'CairoFontOptions::setHintStyle' => ['void', 'hint_style'=>'string'], 'CairoFontOptions::setSubpixelOrder' => ['void', 'subpixel_order'=>'string'], 'CairoFontOptions::status' => ['int', 'context'=>'cairocontext'], 'CairoFormat::strideForWidth' => ['int', 'format'=>'int', 'width'=>'int'], 'CairoGradientPattern::addColorStopRgb' => ['void', 'offset'=>'string', 'red'=>'string', 'green'=>'string', 'blue'=>'string'], 'CairoGradientPattern::addColorStopRgba' => ['void', 'offset'=>'string', 'red'=>'string', 'green'=>'string', 'blue'=>'string', 'alpha'=>'string'], 'CairoGradientPattern::getColorStopCount' => ['int'], 'CairoGradientPattern::getColorStopRgba' => ['array', 'index'=>'string'], 'CairoGradientPattern::getExtend' => ['int'], 'CairoGradientPattern::setExtend' => ['void', 'extend'=>'int'], 'CairoImageSurface::__construct' => ['void', 'format'=>'int', 'width'=>'int', 'height'=>'int'], 'CairoImageSurface::createForData' => ['void', 'data'=>'string', 'format'=>'int', 'width'=>'int', 'height'=>'int', 'stride='=>'int'], 'CairoImageSurface::createFromPng' => ['CairoImageSurface', 'file'=>'string'], 'CairoImageSurface::getData' => ['string'], 'CairoImageSurface::getFormat' => ['int'], 'CairoImageSurface::getHeight' => ['int'], 'CairoImageSurface::getStride' => ['int'], 'CairoImageSurface::getWidth' => ['int'], 'CairoLinearGradient::__construct' => ['void', 'x0'=>'float', 'y0'=>'float', 'x1'=>'float', 'y1'=>'float'], 'CairoLinearGradient::getPoints' => ['array'], 'CairoMatrix::__construct' => ['void', 'xx='=>'float', 'yx='=>'float', 'xy='=>'float', 'yy='=>'float', 'x0='=>'float', 'y0='=>'float'], 'CairoMatrix::initIdentity' => ['object'], 'CairoMatrix::initRotate' => ['object', 'radians'=>'float'], 'CairoMatrix::initScale' => ['object', 'sx'=>'float', 'sy'=>'float'], 'CairoMatrix::initTranslate' => ['object', 'tx'=>'float', 'ty'=>'float'], 'CairoMatrix::invert' => ['void'], 'CairoMatrix::multiply' => ['CairoMatrix', 'matrix1'=>'cairomatrix', 'matrix2'=>'cairomatrix'], 'CairoMatrix::rotate' => ['', 'sx'=>'string', 'sy'=>'string', 'context'=>'cairocontext', 'angle'=>'string'], 'CairoMatrix::scale' => ['', 'sx'=>'float', 'sy'=>'float', 'context'=>'cairocontext'], 'CairoMatrix::transformDistance' => ['array', 'dx'=>'string', 'dy'=>'string'], 'CairoMatrix::transformPoint' => ['array', 'dx'=>'string', 'dy'=>'string'], 'CairoMatrix::translate' => ['', 'tx'=>'string', 'ty'=>'string', 'context'=>'cairocontext', 'x'=>'string', 'y'=>'string'], 'CairoPattern::__construct' => ['void'], 'CairoPattern::getMatrix' => ['', 'context'=>'cairocontext'], 'CairoPattern::getType' => ['int'], 'CairoPattern::setMatrix' => ['', 'matrix'=>'cairomatrix', 'context'=>'cairocontext'], 'CairoPattern::status' => ['int', 'context'=>'cairocontext'], 'CairoPdfSurface::__construct' => ['void', 'file'=>'string', 'width'=>'float', 'height'=>'float'], 'CairoPdfSurface::setSize' => ['void', 'width'=>'string', 'height'=>'string'], 'CairoPsSurface::__construct' => ['void', 'file'=>'string', 'width'=>'float', 'height'=>'float'], 'CairoPsSurface::dscBeginPageSetup' => ['void'], 'CairoPsSurface::dscBeginSetup' => ['void'], 'CairoPsSurface::dscComment' => ['void', 'comment'=>'string'], 'CairoPsSurface::getEps' => ['bool'], 'CairoPsSurface::getLevels' => ['array'], 'CairoPsSurface::levelToString' => ['string', 'level'=>'int'], 'CairoPsSurface::restrictToLevel' => ['void', 'level'=>'string'], 'CairoPsSurface::setEps' => ['void', 'level'=>'string'], 'CairoPsSurface::setSize' => ['void', 'width'=>'string', 'height'=>'string'], 'CairoRadialGradient::__construct' => ['void', 'x0'=>'float', 'y0'=>'float', 'r0'=>'float', 'x1'=>'float', 'y1'=>'float', 'r1'=>'float'], 'CairoRadialGradient::getCircles' => ['array'], 'CairoScaledFont::__construct' => ['void', 'font_face'=>'CairoFontFace', 'matrix'=>'CairoMatrix', 'ctm'=>'CairoMatrix', 'options'=>'CairoFontOptions'], 'CairoScaledFont::extents' => ['array'], 'CairoScaledFont::getCtm' => ['CairoMatrix'], 'CairoScaledFont::getFontFace' => ['', 'context'=>'cairocontext'], 'CairoScaledFont::getFontMatrix' => ['', 'context'=>'cairocontext'], 'CairoScaledFont::getFontOptions' => ['', 'context'=>'cairocontext'], 'CairoScaledFont::getScaleMatrix' => ['void'], 'CairoScaledFont::getType' => ['int'], 'CairoScaledFont::glyphExtents' => ['array', 'glyphs'=>'string'], 'CairoScaledFont::status' => ['int', 'context'=>'cairocontext'], 'CairoScaledFont::textExtents' => ['array', 'text'=>'string', 'context'=>'cairocontext'], 'CairoSolidPattern::__construct' => ['void', 'red'=>'float', 'green'=>'float', 'blue'=>'float', 'alpha='=>'float'], 'CairoSolidPattern::getRgba' => ['array'], 'CairoSurface::__construct' => ['void'], 'CairoSurface::copyPage' => ['', 'context'=>'cairocontext'], 'CairoSurface::createSimilar' => ['void', 'other'=>'cairosurface', 'content'=>'int', 'width'=>'string', 'height'=>'string'], 'CairoSurface::finish' => ['void'], 'CairoSurface::flush' => ['void'], 'CairoSurface::getContent' => ['int'], 'CairoSurface::getDeviceOffset' => ['array'], 'CairoSurface::getFontOptions' => ['', 'context'=>'cairocontext'], 'CairoSurface::getType' => ['int'], 'CairoSurface::markDirty' => ['void'], 'CairoSurface::markDirtyRectangle' => ['void', 'x'=>'string', 'y'=>'string', 'width'=>'string', 'height'=>'string'], 'CairoSurface::setDeviceOffset' => ['void', 'x'=>'string', 'y'=>'string'], 'CairoSurface::setFallbackResolution' => ['void', 'x'=>'string', 'y'=>'string'], 'CairoSurface::showPage' => ['', 'context'=>'cairocontext'], 'CairoSurface::status' => ['int', 'context'=>'cairocontext'], 'CairoSurface::writeToPng' => ['void', 'file'=>'string'], 'CairoSurfacePattern::__construct' => ['void', 'surface'=>'CairoSurface'], 'CairoSurfacePattern::getExtend' => ['int'], 'CairoSurfacePattern::getFilter' => ['int'], 'CairoSurfacePattern::getSurface' => ['void'], 'CairoSurfacePattern::setExtend' => ['void', 'extend'=>'int'], 'CairoSurfacePattern::setFilter' => ['void', 'filter'=>'string'], 'CairoSvgSurface::__construct' => ['void', 'file'=>'string', 'width'=>'float', 'height'=>'float'], 'CairoSvgSurface::getVersions' => ['array'], 'CairoSvgSurface::restrictToVersion' => ['void', 'version'=>'string'], 'CairoSvgSurface::versionToString' => ['string', 'version'=>'int'], 'cal_days_in_month' => ['int', 'calendar'=>'int', 'month'=>'int', 'year'=>'int'], 'cal_from_jd' => ['array', 'jd'=>'int', 'calendar'=>'int'], 'cal_info' => ['array', 'calendar='=>'int'], 'cal_to_jd' => ['int', 'calendar'=>'int', 'month'=>'int', 'day'=>'int', 'year'=>'int'], 'calcul_hmac' => ['string', 'clent'=>'string', 'siretcode'=>'string', 'price'=>'string', 'reference'=>'string', 'validity'=>'string', 'taxation'=>'string', 'devise'=>'string', 'language'=>'string'], 'calculhmac' => ['string', 'clent'=>'string', 'data'=>'string'], 'call_user_func' => ['mixed', 'function'=>'callable', '...parameters='=>'mixed'], 'call_user_func_array' => ['mixed', 'function'=>'callable', 'parameters'=>'array<int,mixed>'], 'call_user_method' => ['mixed', 'method_name'=>'string', 'obj'=>'object', 'parameter='=>'mixed', '...args='=>'mixed'], 'call_user_method_array' => ['mixed', 'method_name'=>'string', 'obj'=>'object', 'params'=>'array<int,mixed>'], 'CallbackFilterIterator::__construct' => ['void', 'iterator'=>'Iterator', 'func'=>'callable'], 'CallbackFilterIterator::accept' => ['bool'], 'CallbackFilterIterator::current' => ['mixed'], 'CallbackFilterIterator::getInnerIterator' => ['Iterator'], 'CallbackFilterIterator::key' => ['mixed'], 'CallbackFilterIterator::next' => ['void'], 'CallbackFilterIterator::rewind' => ['void'], 'CallbackFilterIterator::valid' => ['bool'], 'ceil' => ['__benevolent<float|false>', 'number'=>'float'], 'chdb::__construct' => ['void', 'pathname'=>'string'], 'chdb::get' => ['string', 'key'=>'string'], 'chdb_create' => ['bool', 'pathname'=>'string', 'data'=>'array'], 'chdir' => ['bool', 'directory'=>'string'], 'checkdate' => ['bool', 'month'=>'int', 'day'=>'int', 'year'=>'int'], 'checkdnsrr' => ['bool', 'host'=>'string', 'type='=>'string'], 'chgrp' => ['bool', 'filename'=>'string', 'group'=>'string|int'], 'chmod' => ['bool', 'filename'=>'string', 'mode'=>'int'], 'chop' => ['string', 'str'=>'string', 'character_mask='=>'string'], 'chown' => ['bool', 'filename'=>'string', 'user'=>'string|int'], 'chr' => ['non-empty-string', 'ascii'=>'int'], 'chroot' => ['bool', 'directory'=>'string'], 'chunk_split' => ['string', 'str'=>'string', 'chunklen='=>'positive-int', 'ending='=>'string'], 'class_alias' => ['bool', 'user_class_name'=>'string', 'alias_name'=>'string', 'autoload='=>'bool'], 'class_exists' => ['bool', 'classname'=>'string', 'autoload='=>'bool'], 'class_implements' => ['array<string,interface-string>|false', 'what'=>'object|string', 'autoload='=>'bool'], 'class_parents' => ['array<string,class-string>|false', 'instance'=>'object|string', 'autoload='=>'bool'], 'class_uses' => ['array<string,trait-string>|false', 'what'=>'object|string', 'autoload='=>'bool'], 'classkit_import' => ['array', 'filename'=>'string'], 'classkit_method_add' => ['bool', 'classname'=>'string', 'methodname'=>'string', 'args'=>'string', 'code'=>'string', 'flags='=>'int'], 'classkit_method_copy' => ['bool', 'dclass'=>'string', 'dmethod'=>'string', 'sclass'=>'string', 'smethod='=>'string'], 'classkit_method_redefine' => ['bool', 'classname'=>'string', 'methodname'=>'string', 'args'=>'string', 'code'=>'string', 'flags='=>'int'], 'classkit_method_remove' => ['bool', 'classname'=>'string', 'methodname'=>'string'], 'classkit_method_rename' => ['bool', 'classname'=>'string', 'methodname'=>'string', 'newname'=>'string'], 'classObj::__construct' => ['void', 'layer'=>'layerObj', 'class'=>'classObj'], 'classObj::addLabel' => ['int', 'label'=>'labelObj'], 'classObj::convertToString' => ['string'], 'classObj::createLegendIcon' => ['imageObj', 'width'=>'int', 'height'=>'int'], 'classObj::deletestyle' => ['int', 'index'=>'int'], 'classObj::drawLegendIcon' => ['int', 'width'=>'int', 'height'=>'int', 'im'=>'imageObj', 'dstX'=>'int', 'dstY'=>'int'], 'classObj::free' => ['void'], 'classObj::getExpressionString' => ['string'], 'classObj::getLabel' => ['labelObj', 'index'=>'int'], 'classObj::getMetaData' => ['int', 'name'=>'string'], 'classObj::getStyle' => ['styleObj', 'index'=>'int'], 'classObj::getTextString' => ['string'], 'classObj::movestyledown' => ['int', 'index'=>'int'], 'classObj::movestyleup' => ['int', 'index'=>'int'], 'classObj::ms_newClassObj' => ['classObj', 'layer'=>'layerObj', 'class'=>'classObj'], 'classObj::removeLabel' => ['labelObj', 'index'=>'int'], 'classObj::removeMetaData' => ['int', 'name'=>'string'], 'classObj::set' => ['int', 'property_name'=>'string', 'new_value'=>''], 'classObj::setExpression' => ['int', 'expression'=>'string'], 'classObj::setMetaData' => ['int', 'name'=>'string', 'value'=>'string'], 'classObj::settext' => ['int', 'text'=>'string'], 'classObj::updateFromString' => ['int', 'snippet'=>'string'], 'clearstatcache' => ['void', 'clear_realpath_cache='=>'bool', 'filename='=>'string'], 'cli_get_process_title' => ['string'], 'cli_set_process_title' => ['bool', 'arg'=>'string'], 'ClosedGeneratorException::__clone' => ['void'], 'ClosedGeneratorException::__toString' => ['string'], 'ClosedGeneratorException::getCode' => ['int'], 'ClosedGeneratorException::getFile' => ['string'], 'ClosedGeneratorException::getLine' => ['int'], 'ClosedGeneratorException::getMessage' => ['string'], 'ClosedGeneratorException::getPrevious' => ['Throwable|ClosedGeneratorException|null'], 'ClosedGeneratorException::getTrace' => ['list<array{function:string,line?:int,file?:string,class?:class-string,type?:\'::\'|\'->\',args?:mixed[],object?:object}>'], 'ClosedGeneratorException::getTraceAsString' => ['string'], 'closedir' => ['void', 'dir_handle='=>'resource'], 'closelog' => ['bool'], 'Closure::__construct' => ['void'], 'Closure::__invoke' => ['', '...args='=>''], 'Closure::bind' => ['__benevolent<Closure|null>', 'old'=>'Closure', 'to'=>'?object', 'scope='=>'object|string|null'], 'Closure::bindTo' => ['__benevolent<Closure|null>', 'new'=>'?object', 'newscope='=>'object|string|null'], 'Closure::call' => ['', 'to'=>'object', '...parameters='=>''], 'Closure::fromCallable' => ['Closure', 'callable'=>'callable'], 'clusterObj::convertToString' => ['string'], 'clusterObj::getFilterString' => ['string'], 'clusterObj::getGroupString' => ['string'], 'clusterObj::setFilter' => ['int', 'expression'=>'string'], 'clusterObj::setGroup' => ['int', 'expression'=>'string'], 'Collator::__construct' => ['void', 'locale'=>'string'], 'Collator::asort' => ['bool', '&rw_arr'=>'array', 'sort_flag='=>'int'], 'Collator::compare' => ['int|false', 'str1'=>'string', 'str2'=>'string'], 'Collator::create' => ['?Collator', 'locale'=>'string'], 'Collator::getAttribute' => ['int', 'attr'=>'int'], 'Collator::getErrorCode' => ['int'], 'Collator::getErrorMessage' => ['string'], 'Collator::getLocale' => ['string', 'type'=>'int'], 'Collator::getSortKey' => ['string', 'str'=>'string'], 'Collator::getStrength' => ['int'], 'Collator::setAttribute' => ['bool', 'attr'=>'int', 'val'=>'int'], 'Collator::setStrength' => ['bool', 'strength'=>'int'], 'Collator::sort' => ['bool', '&rw_arr'=>'array', 'sort_flags='=>'int'], 'Collator::sortWithSortKeys' => ['bool', '&rw_arr'=>'array'], 'collator_asort' => ['bool', 'coll'=>'collator', '&rw_arr'=>'array', 'sort_flag='=>'int'], 'collator_compare' => ['int|false', 'coll'=>'collator', 'str1'=>'string', 'str2'=>'string'], 'collator_create' => ['?Collator', 'locale'=>'string'], 'collator_get_attribute' => ['int|false', 'coll'=>'collator', 'attr'=>'int'], 'collator_get_error_code' => ['int|false', 'coll'=>'collator'], 'collator_get_error_message' => ['string|false', 'coll'=>'collator'], 'collator_get_locale' => ['string|false', 'coll'=>'collator', 'type'=>'int'], 'collator_get_sort_key' => ['string|false', 'coll'=>'collator', 'str'=>'string'], 'collator_get_strength' => ['int', 'coll'=>'collator'], 'collator_set_attribute' => ['bool', 'coll'=>'collator', 'attr'=>'int', 'val'=>'int'], 'collator_set_strength' => ['bool', 'coll'=>'collator', 'strength'=>'int'], 'collator_sort' => ['bool', 'coll'=>'collator', '&rw_arr'=>'array', 'sort_flag='=>'int'], 'collator_sort_with_sort_keys' => ['bool', 'coll'=>'collator', '&rw_arr'=>'array'], 'Collectable::isGarbage' => ['bool'], 'colorObj::setHex' => ['int', 'hex'=>'string'], 'colorObj::toHex' => ['string'], 'COM::__call' => ['', 'name'=>'', 'args'=>''], 'COM::__construct' => ['void', 'module_name'=>'string', 'server_name='=>'mixed', 'codepage='=>'int', 'typelib='=>'string'], 'COM::__get' => ['', 'name'=>''], 'COM::__set' => ['', 'name'=>'', 'value'=>''], 'com_addref' => [''], 'com_create_guid' => ['string|false'], 'com_event_sink' => ['bool', 'comobject'=>'object', 'sinkobject'=>'object', 'sinkinterface='=>'mixed'], 'com_get_active_object' => ['object', 'progid'=>'string', 'code_page='=>'int'], 'com_isenum' => ['bool', 'com_module'=>'variant'], 'com_load_typelib' => ['bool', 'typelib_name'=>'string', 'case_insensitive='=>'int'], 'com_message_pump' => ['bool', 'timeoutms='=>'int'], 'com_print_typeinfo' => ['bool', 'comobject_or_typelib'=>'object', 'dispinterface='=>'string', 'wantsink='=>'bool'], 'com_release' => [''], 'compact' => ['array<string, mixed>', '...var_names='=>'string|array'], 'COMPersistHelper::__construct' => ['void', 'com_object'=>'object'], 'COMPersistHelper::GetCurFile' => ['string'], 'COMPersistHelper::GetMaxStreamSize' => ['int'], 'COMPersistHelper::InitNew' => ['int'], 'COMPersistHelper::LoadFromFile' => ['bool', 'filename'=>'string', 'flags'=>'int'], 'COMPersistHelper::LoadFromStream' => ['', 'stream'=>''], 'COMPersistHelper::SaveToFile' => ['bool', 'filename'=>'string', 'remember'=>'bool'], 'COMPersistHelper::SaveToStream' => ['int', 'stream'=>''], 'componere\cast' => ['Type', 'arg1'=>'', 'object'=>''], 'componere\cast_by_ref' => ['Type', 'arg1'=>'', 'object'=>''], 'confirm_pdo_ibm_compiled' => [''], 'connection_aborted' => ['0|1'], 'connection_status' => ['int-mask<CONNECTION_NORMAL|CONNECTION_ABORTED|CONNECTION_TIMEOUT>'], 'connection_timeout' => ['int'], 'constant' => ['mixed', 'const_name'=>'string'], 'convert_cyr_string' => ['string', 'str'=>'string', 'from'=>'string', 'to'=>'string'], 'convert_uudecode' => ['string|false', 'data'=>'string'], 'convert_uuencode' => ['string', 'data'=>'string'], 'copy' => ['bool', 'source_file'=>'string', 'destination_file'=>'string', 'context='=>'resource'], 'cos' => ['float', 'number'=>'float'], 'cosh' => ['float', 'number'=>'float'], 'Couchbase\AnalyticsQuery::__construct' => ['void'], 'Couchbase\AnalyticsQuery::fromString' => ['Couchbase\AnalyticsQuery', 'statement'=>'string'], 'Couchbase\basicDecoderV1' => ['mixed', 'bytes'=>'string', 'flags'=>'int', 'datatype'=>'int', 'options'=>'array'], 'Couchbase\basicEncoderV1' => ['array', 'value'=>'mixed', 'options'=>'array'], 'Couchbase\BooleanFieldSearchQuery::__construct' => ['void'], 'Couchbase\BooleanFieldSearchQuery::boost' => ['Couchbase\BooleanFieldSearchQuery', 'boost'=>'float'], 'Couchbase\BooleanFieldSearchQuery::field' => ['Couchbase\BooleanFieldSearchQuery', 'field'=>'string'], 'Couchbase\BooleanFieldSearchQuery::jsonSerialize' => ['array'], 'Couchbase\BooleanSearchQuery::__construct' => ['void'], 'Couchbase\BooleanSearchQuery::boost' => ['Couchbase\BooleanSearchQuery', 'boost'=>'float'], 'Couchbase\BooleanSearchQuery::jsonSerialize' => ['array'], 'Couchbase\BooleanSearchQuery::must' => ['Couchbase\BooleanSearchQuery', '...queries='=>'array<int,Couchbase\SearchQueryPart>'], 'Couchbase\BooleanSearchQuery::mustNot' => ['Couchbase\BooleanSearchQuery', '...queries='=>'array<int,Couchbase\SearchQueryPart>'], 'Couchbase\BooleanSearchQuery::should' => ['Couchbase\BooleanSearchQuery', '...queries='=>'array<int,Couchbase\SearchQueryPart>'], 'Couchbase\Bucket::__construct' => ['void'], 'Couchbase\Bucket::__get' => ['int', 'name'=>'string'], 'Couchbase\Bucket::__set' => ['int', 'name'=>'string', 'value'=>'int'], 'Couchbase\Bucket::append' => ['Couchbase\Document|array', 'ids'=>'array|string', 'value'=>'mixed', 'options='=>'array'], 'Couchbase\Bucket::counter' => ['Couchbase\Document|array', 'ids'=>'array|string', 'delta='=>'int', 'options='=>'array'], 'Couchbase\Bucket::diag' => ['array', 'reportId='=>'string'], 'Couchbase\Bucket::get' => ['Couchbase\Document|array', 'ids'=>'array|string', 'options='=>'array'], 'Couchbase\Bucket::getAndLock' => ['Couchbase\Document|array', 'ids'=>'array|string', 'lockTime'=>'int', 'options='=>'array'], 'Couchbase\Bucket::getAndTouch' => ['Couchbase\Document|array', 'ids'=>'array|string', 'expiry'=>'int', 'options='=>'array'], 'Couchbase\Bucket::getFromReplica' => ['Couchbase\Document|array', 'ids'=>'array|string', 'options='=>'array'], 'Couchbase\Bucket::insert' => ['Couchbase\Document|array', 'ids'=>'array|string', 'value'=>'mixed', 'options='=>'array'], 'Couchbase\Bucket::listExists' => ['bool', 'id'=>'string', 'value'=>'mixed'], 'Couchbase\Bucket::listGet' => ['mixed', 'id'=>'string', 'index'=>'int'], 'Couchbase\Bucket::listPush' => ['', 'id'=>'string', 'value'=>'mixed'], 'Couchbase\Bucket::listRemove' => ['', 'id'=>'string', 'index'=>'int'], 'Couchbase\Bucket::listSet' => ['', 'id'=>'string', 'index'=>'int', 'value'=>'mixed'], 'Couchbase\Bucket::listShift' => ['', 'id'=>'string', 'value'=>'mixed'], 'Couchbase\Bucket::listSize' => ['int', 'id'=>'string'], 'Couchbase\Bucket::lookupIn' => ['Couchbase\LookupInBuilder', 'id'=>'string'], 'Couchbase\Bucket::manager' => ['Couchbase\BucketManager'], 'Couchbase\Bucket::mapAdd' => ['', 'id'=>'string', 'key'=>'string', 'value'=>'mixed'], 'Couchbase\Bucket::mapGet' => ['mixed', 'id'=>'string', 'key'=>'string'], 'Couchbase\Bucket::mapRemove' => ['', 'id'=>'string', 'key'=>'string'], 'Couchbase\Bucket::mapSize' => ['int', 'id'=>'string'], 'Couchbase\Bucket::mutateIn' => ['Couchbase\MutateInBuilder', 'id'=>'string', 'cas'=>'string'], 'Couchbase\Bucket::ping' => ['array', 'services='=>'int', 'reportId='=>'string'], 'Couchbase\Bucket::prepend' => ['Couchbase\Document|array', 'ids'=>'array|string', 'value'=>'mixed', 'options='=>'array'], 'Couchbase\Bucket::query' => ['object', 'query'=>'Couchbase\AnalyticsQuery|Couchbase\N1qlQuery|Couchbase\SearchQuery|Couchbase\SpatialViewQuery|Couchbase\ViewQuery', 'jsonAsArray='=>'bool|false'], 'Couchbase\Bucket::queueAdd' => ['', 'id'=>'string', 'value'=>'mixed'], 'Couchbase\Bucket::queueExists' => ['bool', 'id'=>'string', 'value'=>'mixed'], 'Couchbase\Bucket::queueRemove' => ['mixed', 'id'=>'string'], 'Couchbase\Bucket::queueSize' => ['int', 'id'=>'string'], 'Couchbase\Bucket::remove' => ['Couchbase\Document|array', 'ids'=>'array|string', 'options='=>'array'], 'Couchbase\Bucket::replace' => ['Couchbase\Document|array', 'ids'=>'array|string', 'value'=>'mixed', 'options='=>'array'], 'Couchbase\Bucket::retrieveIn' => ['Couchbase\DocumentFragment', 'id'=>'string', '...paths='=>'array<int,string>'], 'Couchbase\Bucket::setAdd' => ['', 'id'=>'string', 'value'=>'bool|float|int|string'], 'Couchbase\Bucket::setExists' => ['bool', 'id'=>'string', 'value'=>'bool|float|int|string'], 'Couchbase\Bucket::setRemove' => ['', 'id'=>'string', 'value'=>'bool|float|int|string'], 'Couchbase\Bucket::setSize' => ['int', 'id'=>'string'], 'Couchbase\Bucket::setTranscoder' => ['', 'encoder'=>'callable', 'decoder'=>'callable'], 'Couchbase\Bucket::touch' => ['Couchbase\Document|array', 'ids'=>'array|string', 'expiry'=>'int', 'options='=>'array'], 'Couchbase\Bucket::unlock' => ['Couchbase\Document|array', 'ids'=>'array|string', 'options='=>'array'], 'Couchbase\Bucket::upsert' => ['Couchbase\Document|array', 'ids'=>'array|string', 'value'=>'mixed', 'options='=>'array'], 'Couchbase\BucketManager::__construct' => ['void'], 'Couchbase\BucketManager::createN1qlIndex' => ['', 'name'=>'string', 'fields'=>'array', 'whereClause='=>'string', 'ignoreIfExist='=>'bool|false', 'defer='=>'bool|false'], 'Couchbase\BucketManager::createN1qlPrimaryIndex' => ['', 'customName='=>'string', 'ignoreIfExist='=>'bool|false', 'defer='=>'bool|false'], 'Couchbase\BucketManager::dropN1qlIndex' => ['', 'name'=>'string', 'ignoreIfNotExist='=>'bool|false'], 'Couchbase\BucketManager::dropN1qlPrimaryIndex' => ['', 'customName='=>'string', 'ignoreIfNotExist='=>'bool|false'], 'Couchbase\BucketManager::flush' => [''], 'Couchbase\BucketManager::getDesignDocument' => ['array', 'name'=>'string'], 'Couchbase\BucketManager::info' => ['array'], 'Couchbase\BucketManager::insertDesignDocument' => ['', 'name'=>'string', 'document'=>'array'], 'Couchbase\BucketManager::listDesignDocuments' => ['array'], 'Couchbase\BucketManager::listN1qlIndexes' => ['array'], 'Couchbase\BucketManager::removeDesignDocument' => ['', 'name'=>'string'], 'Couchbase\BucketManager::upsertDesignDocument' => ['', 'name'=>'string', 'document'=>'array'], 'Couchbase\ClassicAuthenticator::bucket' => ['', 'name'=>'string', 'password'=>'string'], 'Couchbase\ClassicAuthenticator::cluster' => ['', 'username'=>'string', 'password'=>'string'], 'Couchbase\Cluster::__construct' => ['void', 'connstr'=>'string'], 'Couchbase\Cluster::authenticate' => ['null', 'authenticator'=>'Couchbase\Authenticator'], 'Couchbase\Cluster::authenticateAs' => ['null', 'username'=>'string', 'password'=>'string'], 'Couchbase\Cluster::manager' => ['Couchbase\ClusterManager', 'username='=>'string', 'password='=>'string'], 'Couchbase\Cluster::openBucket' => ['Couchbase\Bucket', 'name='=>'string', 'password='=>'string'], 'Couchbase\ClusterManager::__construct' => ['void'], 'Couchbase\ClusterManager::createBucket' => ['', 'name'=>'string', 'options='=>'array'], 'Couchbase\ClusterManager::getUser' => ['array', 'username'=>'string', 'domain='=>'int'], 'Couchbase\ClusterManager::info' => ['array'], 'Couchbase\ClusterManager::listBuckets' => ['array'], 'Couchbase\ClusterManager::listUsers' => ['array', 'domain='=>'int'], 'Couchbase\ClusterManager::removeBucket' => ['', 'name'=>'string'], 'Couchbase\ClusterManager::removeUser' => ['', 'name'=>'string', 'domain='=>'int'], 'Couchbase\ClusterManager::upsertUser' => ['', 'name'=>'string', 'settings'=>'Couchbase\UserSettings', 'domain='=>'int'], 'Couchbase\ConjunctionSearchQuery::__construct' => ['void'], 'Couchbase\ConjunctionSearchQuery::boost' => ['Couchbase\ConjunctionSearchQuery', 'boost'=>'float'], 'Couchbase\ConjunctionSearchQuery::every' => ['Couchbase\ConjunctionSearchQuery', '...queries='=>'array<int,Couchbase\SearchQueryPart>'], 'Couchbase\ConjunctionSearchQuery::jsonSerialize' => ['array'], 'Couchbase\DateRangeSearchFacet::__construct' => ['void'], 'Couchbase\DateRangeSearchFacet::addRange' => ['Couchbase\DateSearchFacet', 'name'=>'string', 'start'=>'int|string', 'end'=>'int|string'], 'Couchbase\DateRangeSearchFacet::jsonSerialize' => ['array'], 'Couchbase\DateRangeSearchQuery::__construct' => ['void'], 'Couchbase\DateRangeSearchQuery::boost' => ['Couchbase\DateRangeSearchQuery', 'boost'=>'float'], 'Couchbase\DateRangeSearchQuery::dateTimeParser' => ['Couchbase\DateRangeSearchQuery', 'dateTimeParser'=>'string'], 'Couchbase\DateRangeSearchQuery::end' => ['Couchbase\DateRangeSearchQuery', 'end'=>'int|string', 'inclusive='=>'bool|false'], 'Couchbase\DateRangeSearchQuery::field' => ['Couchbase\DateRangeSearchQuery', 'field'=>'string'], 'Couchbase\DateRangeSearchQuery::jsonSerialize' => ['array'], 'Couchbase\DateRangeSearchQuery::start' => ['Couchbase\DateRangeSearchQuery', 'start'=>'int|string', 'inclusive='=>'bool|true'], 'Couchbase\defaultDecoder' => ['mixed', 'bytes'=>'string', 'flags'=>'int', 'datatype'=>'int'], 'Couchbase\defaultEncoder' => ['array', 'value'=>'mixed'], 'Couchbase\DisjunctionSearchQuery::__construct' => ['void'], 'Couchbase\DisjunctionSearchQuery::boost' => ['Couchbase\DisjunctionSearchQuery', 'boost'=>'float'], 'Couchbase\DisjunctionSearchQuery::either' => ['Couchbase\DisjunctionSearchQuery', '...queries='=>'array<int,Couchbase\SearchQueryPart>'], 'Couchbase\DisjunctionSearchQuery::jsonSerialize' => ['array'], 'Couchbase\DisjunctionSearchQuery::min' => ['Couchbase\DisjunctionSearchQuery', 'min'=>'int'], 'Couchbase\DocIdSearchQuery::__construct' => ['void'], 'Couchbase\DocIdSearchQuery::boost' => ['Couchbase\DocIdSearchQuery', 'boost'=>'float'], 'Couchbase\DocIdSearchQuery::docIds' => ['Couchbase\DocIdSearchQuery', '...documentIds='=>'array<int,string>'], 'Couchbase\DocIdSearchQuery::field' => ['Couchbase\DocIdSearchQuery', 'field'=>'string'], 'Couchbase\DocIdSearchQuery::jsonSerialize' => ['array'], 'Couchbase\fastlzCompress' => ['string', 'data'=>'string'], 'Couchbase\fastlzDecompress' => ['string', 'data'=>'string'], 'Couchbase\GeoBoundingBoxSearchQuery::__construct' => ['void'], 'Couchbase\GeoBoundingBoxSearchQuery::boost' => ['Couchbase\GeoBoundingBoxSearchQuery', 'boost'=>'float'], 'Couchbase\GeoBoundingBoxSearchQuery::field' => ['Couchbase\GeoBoundingBoxSearchQuery', 'field'=>'string'], 'Couchbase\GeoBoundingBoxSearchQuery::jsonSerialize' => ['array'], 'Couchbase\GeoDistanceSearchQuery::__construct' => ['void'], 'Couchbase\GeoDistanceSearchQuery::boost' => ['Couchbase\GeoDistanceSearchQuery', 'boost'=>'float'], 'Couchbase\GeoDistanceSearchQuery::field' => ['Couchbase\GeoDistanceSearchQuery', 'field'=>'string'], 'Couchbase\GeoDistanceSearchQuery::jsonSerialize' => ['array'], 'Couchbase\LookupInBuilder::__construct' => ['void'], 'Couchbase\LookupInBuilder::execute' => ['Couchbase\DocumentFragment'], 'Couchbase\LookupInBuilder::exists' => ['Couchbase\LookupInBuilder', 'path'=>'string', 'options='=>'array'], 'Couchbase\LookupInBuilder::get' => ['Couchbase\LookupInBuilder', 'path'=>'string', 'options='=>'array'], 'Couchbase\LookupInBuilder::getCount' => ['Couchbase\LookupInBuilder', 'path'=>'string', 'options='=>'array'], 'Couchbase\MatchAllSearchQuery::__construct' => ['void'], 'Couchbase\MatchAllSearchQuery::boost' => ['Couchbase\MatchAllSearchQuery', 'boost'=>'float'], 'Couchbase\MatchAllSearchQuery::jsonSerialize' => ['array'], 'Couchbase\MatchNoneSearchQuery::__construct' => ['void'], 'Couchbase\MatchNoneSearchQuery::boost' => ['Couchbase\MatchNoneSearchQuery', 'boost'=>'float'], 'Couchbase\MatchNoneSearchQuery::jsonSerialize' => ['array'], 'Couchbase\MatchPhraseSearchQuery::__construct' => ['void'], 'Couchbase\MatchPhraseSearchQuery::analyzer' => ['Couchbase\MatchPhraseSearchQuery', 'analyzer'=>'string'], 'Couchbase\MatchPhraseSearchQuery::boost' => ['Couchbase\MatchPhraseSearchQuery', 'boost'=>'float'], 'Couchbase\MatchPhraseSearchQuery::field' => ['Couchbase\MatchPhraseSearchQuery', 'field'=>'string'], 'Couchbase\MatchPhraseSearchQuery::jsonSerialize' => ['array'], 'Couchbase\MatchSearchQuery::__construct' => ['void'], 'Couchbase\MatchSearchQuery::analyzer' => ['Couchbase\MatchSearchQuery', 'analyzer'=>'string'], 'Couchbase\MatchSearchQuery::boost' => ['Couchbase\MatchSearchQuery', 'boost'=>'float'], 'Couchbase\MatchSearchQuery::field' => ['Couchbase\MatchSearchQuery', 'field'=>'string'], 'Couchbase\MatchSearchQuery::fuzziness' => ['Couchbase\MatchSearchQuery', 'fuzziness'=>'int'], 'Couchbase\MatchSearchQuery::jsonSerialize' => ['array'], 'Couchbase\MatchSearchQuery::prefixLength' => ['Couchbase\MatchSearchQuery', 'prefixLength'=>'int'], 'Couchbase\MutateInBuilder::__construct' => ['void'], 'Couchbase\MutateInBuilder::arrayAddUnique' => ['Couchbase\MutateInBuilder', 'path'=>'string', 'value'=>'mixed', 'options='=>'array|bool'], 'Couchbase\MutateInBuilder::arrayAppend' => ['Couchbase\MutateInBuilder', 'path'=>'string', 'value'=>'mixed', 'options='=>'array|bool'], 'Couchbase\MutateInBuilder::arrayAppendAll' => ['Couchbase\MutateInBuilder', 'path'=>'string', 'values'=>'array', 'options='=>'array|bool'], 'Couchbase\MutateInBuilder::arrayInsert' => ['Couchbase\MutateInBuilder', 'path'=>'string', 'value'=>'mixed', 'options='=>'array'], 'Couchbase\MutateInBuilder::arrayInsertAll' => ['Couchbase\MutateInBuilder', 'path'=>'string', 'values'=>'array', 'options='=>'array'], 'Couchbase\MutateInBuilder::arrayPrepend' => ['Couchbase\MutateInBuilder', 'path'=>'string', 'value'=>'mixed', 'options='=>'array|bool'], 'Couchbase\MutateInBuilder::arrayPrependAll' => ['Couchbase\MutateInBuilder', 'path'=>'string', 'values'=>'array', 'options='=>'array|bool'], 'Couchbase\MutateInBuilder::counter' => ['Couchbase\MutateInBuilder', 'path'=>'string', 'delta'=>'int', 'options='=>'array|bool'], 'Couchbase\MutateInBuilder::execute' => ['Couchbase\DocumentFragment'], 'Couchbase\MutateInBuilder::insert' => ['Couchbase\MutateInBuilder', 'path'=>'string', 'value'=>'mixed', 'options='=>'array|bool'], 'Couchbase\MutateInBuilder::modeDocument' => ['', 'mode'=>'int'], 'Couchbase\MutateInBuilder::remove' => ['Couchbase\MutateInBuilder', 'path'=>'string', 'options='=>'array'], 'Couchbase\MutateInBuilder::replace' => ['Couchbase\MutateInBuilder', 'path'=>'string', 'value'=>'mixed', 'options='=>'array'], 'Couchbase\MutateInBuilder::upsert' => ['Couchbase\MutateInBuilder', 'path'=>'string', 'value'=>'mixed', 'options='=>'array|bool'], 'Couchbase\MutateInBuilder::withExpiry' => ['Couchbase\MutateInBuilder', 'expiry'=>'Couchbase\expiry'], 'Couchbase\MutationState::__construct' => ['void'], 'Couchbase\MutationState::add' => ['', 'source'=>'Couchbase\Document|Couchbase\DocumentFragment|array'], 'Couchbase\MutationState::from' => ['Couchbase\MutationState', 'source'=>'Couchbase\Document|Couchbase\DocumentFragment|array'], 'Couchbase\MutationToken::__construct' => ['void'], 'Couchbase\MutationToken::bucketName' => ['string'], 'Couchbase\MutationToken::from' => ['', 'bucketName'=>'string', 'vbucketId'=>'int', 'vbucketUuid'=>'string', 'sequenceNumber'=>'string'], 'Couchbase\MutationToken::sequenceNumber' => ['string'], 'Couchbase\MutationToken::vbucketId' => ['int'], 'Couchbase\MutationToken::vbucketUuid' => ['string'], 'Couchbase\N1qlIndex::__construct' => ['void'], 'Couchbase\N1qlQuery::__construct' => ['void'], 'Couchbase\N1qlQuery::adhoc' => ['Couchbase\N1qlQuery', 'adhoc'=>'bool'], 'Couchbase\N1qlQuery::consistency' => ['Couchbase\N1qlQuery', 'consistency'=>'int'], 'Couchbase\N1qlQuery::consistentWith' => ['Couchbase\N1qlQuery', 'state'=>'Couchbase\MutationState'], 'Couchbase\N1qlQuery::crossBucket' => ['Couchbase\N1qlQuery', 'crossBucket'=>'bool'], 'Couchbase\N1qlQuery::fromString' => ['Couchbase\N1qlQuery', 'statement'=>'string'], 'Couchbase\N1qlQuery::maxParallelism' => ['Couchbase\N1qlQuery', 'maxParallelism'=>'int'], 'Couchbase\N1qlQuery::namedParams' => ['Couchbase\N1qlQuery', 'params'=>'array'], 'Couchbase\N1qlQuery::pipelineBatch' => ['Couchbase\N1qlQuery', 'pipelineBatch'=>'int'], 'Couchbase\N1qlQuery::pipelineCap' => ['Couchbase\N1qlQuery', 'pipelineCap'=>'int'], 'Couchbase\N1qlQuery::positionalParams' => ['Couchbase\N1qlQuery', 'params'=>'array'], 'Couchbase\N1qlQuery::readonly' => ['Couchbase\N1qlQuery', 'readonly'=>'bool'], 'Couchbase\N1qlQuery::scanCap' => ['Couchbase\N1qlQuery', 'scanCap'=>'int'], 'Couchbase\NumericRangeSearchFacet::__construct' => ['void'], 'Couchbase\NumericRangeSearchFacet::addRange' => ['Couchbase\NumericSearchFacet', 'name'=>'string', 'min'=>'float', 'max'=>'float'], 'Couchbase\NumericRangeSearchFacet::jsonSerialize' => ['array'], 'Couchbase\NumericRangeSearchQuery::__construct' => ['void'], 'Couchbase\NumericRangeSearchQuery::boost' => ['Couchbase\NumericRangeSearchQuery', 'boost'=>'float'], 'Couchbase\NumericRangeSearchQuery::field' => ['Couchbase\NumericRangeSearchQuery', 'field'=>'string'], 'Couchbase\NumericRangeSearchQuery::jsonSerialize' => ['array'], 'Couchbase\NumericRangeSearchQuery::max' => ['Couchbase\NumericRangeSearchQuery', 'max'=>'float', 'inclusive='=>'bool|false'], 'Couchbase\NumericRangeSearchQuery::min' => ['Couchbase\NumericRangeSearchQuery', 'min'=>'float', 'inclusive='=>'bool|true'], 'Couchbase\passthruDecoder' => ['string', 'bytes'=>'string', 'flags'=>'int', 'datatype'=>'int'], 'Couchbase\passthruEncoder' => ['array', 'value'=>'string'], 'Couchbase\PasswordAuthenticator::password' => ['Couchbase\PasswordAuthenticator', 'password'=>'string'], 'Couchbase\PasswordAuthenticator::username' => ['Couchbase\PasswordAuthenticator', 'username'=>'string'], 'Couchbase\PhraseSearchQuery::__construct' => ['void'], 'Couchbase\PhraseSearchQuery::boost' => ['Couchbase\PhraseSearchQuery', 'boost'=>'float'], 'Couchbase\PhraseSearchQuery::field' => ['Couchbase\PhraseSearchQuery', 'field'=>'string'], 'Couchbase\PhraseSearchQuery::jsonSerialize' => ['array'], 'Couchbase\PrefixSearchQuery::__construct' => ['void'], 'Couchbase\PrefixSearchQuery::boost' => ['Couchbase\PrefixSearchQuery', 'boost'=>'float'], 'Couchbase\PrefixSearchQuery::field' => ['Couchbase\PrefixSearchQuery', 'field'=>'string'], 'Couchbase\PrefixSearchQuery::jsonSerialize' => ['array'], 'Couchbase\QueryStringSearchQuery::__construct' => ['void'], 'Couchbase\QueryStringSearchQuery::boost' => ['Couchbase\QueryStringSearchQuery', 'boost'=>'float'], 'Couchbase\QueryStringSearchQuery::jsonSerialize' => ['array'], 'Couchbase\RegexpSearchQuery::__construct' => ['void'], 'Couchbase\RegexpSearchQuery::boost' => ['Couchbase\RegexpSearchQuery', 'boost'=>'float'], 'Couchbase\RegexpSearchQuery::field' => ['Couchbase\RegexpSearchQuery', 'field'=>'string'], 'Couchbase\RegexpSearchQuery::jsonSerialize' => ['array'], 'Couchbase\SearchQuery::__construct' => ['void', 'indexName'=>'string', 'queryPart'=>'Couchbase\SearchQueryPart'], 'Couchbase\SearchQuery::addFacet' => ['Couchbase\SearchQuery', 'name'=>'string', 'facet'=>'Couchbase\SearchFacet'], 'Couchbase\SearchQuery::boolean' => ['Couchbase\BooleanSearchQuery'], 'Couchbase\SearchQuery::booleanField' => ['Couchbase\BooleanFieldSearchQuery', 'value'=>'bool'], 'Couchbase\SearchQuery::conjuncts' => ['Couchbase\ConjunctionSearchQuery', '...queries='=>'array<int,Couchbase\SearchQueryPart>'], 'Couchbase\SearchQuery::consistentWith' => ['Couchbase\SearchQuery', 'state'=>'Couchbase\MutationState'], 'Couchbase\SearchQuery::dateRange' => ['Couchbase\DateRangeSearchQuery'], 'Couchbase\SearchQuery::dateRangeFacet' => ['Couchbase\DateRangeSearchFacet', 'field'=>'string', 'limit'=>'int'], 'Couchbase\SearchQuery::disjuncts' => ['Couchbase\DisjunctionSearchQuery', '...queries='=>'array<int,Couchbase\SearchQueryPart>'], 'Couchbase\SearchQuery::docId' => ['Couchbase\DocIdSearchQuery', '...documentIds='=>'array<int,string>'], 'Couchbase\SearchQuery::explain' => ['Couchbase\SearchQuery', 'explain'=>'bool'], 'Couchbase\SearchQuery::fields' => ['Couchbase\SearchQuery', '...fields='=>'array<int,string>'], 'Couchbase\SearchQuery::geoBoundingBox' => ['Couchbase\GeoBoundingBoxSearchQuery', 'topLeftLongitude'=>'float', 'topLeftLatitude'=>'float', 'bottomRightLongitude'=>'float', 'bottomRightLatitude'=>'float'], 'Couchbase\SearchQuery::geoDistance' => ['Couchbase\GeoDistanceSearchQuery', 'longitude'=>'float', 'latitude'=>'float', 'distance'=>'string'], 'Couchbase\SearchQuery::highlight' => ['Couchbase\SearchQuery', 'style'=>'string', '...fields='=>'array<int,string>'], 'Couchbase\SearchQuery::jsonSerialize' => ['array'], 'Couchbase\SearchQuery::limit' => ['Couchbase\SearchQuery', 'limit'=>'int'], 'Couchbase\SearchQuery::match' => ['Couchbase\MatchSearchQuery', 'match'=>'string'], 'Couchbase\SearchQuery::matchAll' => ['Couchbase\MatchAllSearchQuery'], 'Couchbase\SearchQuery::matchNone' => ['Couchbase\MatchNoneSearchQuery'], 'Couchbase\SearchQuery::matchPhrase' => ['Couchbase\MatchPhraseSearchQuery', '...terms='=>'array<int,string>'], 'Couchbase\SearchQuery::numericRange' => ['Couchbase\NumericRangeSearchQuery'], 'Couchbase\SearchQuery::numericRangeFacet' => ['Couchbase\NumericRangeSearchFacet', 'field'=>'string', 'limit'=>'int'], 'Couchbase\SearchQuery::prefix' => ['Couchbase\PrefixSearchQuery', 'prefix'=>'string'], 'Couchbase\SearchQuery::queryString' => ['Couchbase\QueryStringSearchQuery', 'queryString'=>'string'], 'Couchbase\SearchQuery::regexp' => ['Couchbase\RegexpSearchQuery', 'regexp'=>'string'], 'Couchbase\SearchQuery::serverSideTimeout' => ['Couchbase\SearchQuery', 'serverSideTimeout'=>'int'], 'Couchbase\SearchQuery::skip' => ['Couchbase\SearchQuery', 'skip'=>'int'], 'Couchbase\SearchQuery::sort' => ['Couchbase\SearchQuery', '...sort='=>'array<int,Couchbase\sort>'], 'Couchbase\SearchQuery::term' => ['Couchbase\TermSearchQuery', 'term'=>'string'], 'Couchbase\SearchQuery::termFacet' => ['Couchbase\TermSearchFacet', 'field'=>'string', 'limit'=>'int'], 'Couchbase\SearchQuery::termRange' => ['Couchbase\TermRangeSearchQuery'], 'Couchbase\SearchQuery::wildcard' => ['Couchbase\WildcardSearchQuery', 'wildcard'=>'string'], 'Couchbase\SpatialViewQuery::__construct' => ['void'], 'Couchbase\SpatialViewQuery::bbox' => ['Couchbase\SpatialViewQuery', 'bbox'=>'array'], 'Couchbase\SpatialViewQuery::consistency' => ['Couchbase\SpatialViewQuery', 'consistency'=>'int'], 'Couchbase\SpatialViewQuery::custom' => ['', 'customParameters'=>'array'], 'Couchbase\SpatialViewQuery::encode' => ['array'], 'Couchbase\SpatialViewQuery::endRange' => ['Couchbase\SpatialViewQuery', 'range'=>'array'], 'Couchbase\SpatialViewQuery::limit' => ['Couchbase\SpatialViewQuery', 'limit'=>'int'], 'Couchbase\SpatialViewQuery::order' => ['Couchbase\SpatialViewQuery', 'order'=>'int'], 'Couchbase\SpatialViewQuery::skip' => ['Couchbase\SpatialViewQuery', 'skip'=>'int'], 'Couchbase\SpatialViewQuery::startRange' => ['Couchbase\SpatialViewQuery', 'range'=>'array'], 'Couchbase\TermRangeSearchQuery::__construct' => ['void'], 'Couchbase\TermRangeSearchQuery::boost' => ['Couchbase\TermRangeSearchQuery', 'boost'=>'float'], 'Couchbase\TermRangeSearchQuery::field' => ['Couchbase\TermRangeSearchQuery', 'field'=>'string'], 'Couchbase\TermRangeSearchQuery::jsonSerialize' => ['array'], 'Couchbase\TermRangeSearchQuery::max' => ['Couchbase\TermRangeSearchQuery', 'max'=>'string', 'inclusive='=>'bool|false'], 'Couchbase\TermRangeSearchQuery::min' => ['Couchbase\TermRangeSearchQuery', 'min'=>'string', 'inclusive='=>'bool|true'], 'Couchbase\TermSearchFacet::__construct' => ['void'], 'Couchbase\TermSearchFacet::jsonSerialize' => ['array'], 'Couchbase\TermSearchQuery::__construct' => ['void'], 'Couchbase\TermSearchQuery::boost' => ['Couchbase\TermSearchQuery', 'boost'=>'float'], 'Couchbase\TermSearchQuery::field' => ['Couchbase\TermSearchQuery', 'field'=>'string'], 'Couchbase\TermSearchQuery::fuzziness' => ['Couchbase\TermSearchQuery', 'fuzziness'=>'int'], 'Couchbase\TermSearchQuery::jsonSerialize' => ['array'], 'Couchbase\TermSearchQuery::prefixLength' => ['Couchbase\TermSearchQuery', 'prefixLength'=>'int'], 'Couchbase\UserSettings::fullName' => ['Couchbase\UserSettings', 'fullName'=>'string'], 'Couchbase\UserSettings::password' => ['Couchbase\UserSettings', 'password'=>'string'], 'Couchbase\UserSettings::role' => ['Couchbase\UserSettings', 'role'=>'string', 'bucket='=>'string'], 'Couchbase\ViewQuery::__construct' => ['void'], 'Couchbase\ViewQuery::consistency' => ['Couchbase\ViewQuery', 'consistency'=>'int'], 'Couchbase\ViewQuery::custom' => ['Couchbase\ViewQuery', 'customParameters'=>'array'], 'Couchbase\ViewQuery::encode' => ['array'], 'Couchbase\ViewQuery::from' => ['Couchbase\ViewQuery', 'designDocumentName'=>'string', 'viewName'=>'string'], 'Couchbase\ViewQuery::fromSpatial' => ['Couchbase\SpatialViewQuery', 'designDocumentName'=>'string', 'viewName'=>'string'], 'Couchbase\ViewQuery::group' => ['Couchbase\ViewQuery', 'group'=>'bool'], 'Couchbase\ViewQuery::groupLevel' => ['Couchbase\ViewQuery', 'groupLevel'=>'int'], 'Couchbase\ViewQuery::idRange' => ['Couchbase\ViewQuery', 'startKeyDocumentId'=>'string', 'endKeyDocumentId'=>'string'], 'Couchbase\ViewQuery::key' => ['Couchbase\ViewQuery', 'key'=>'mixed'], 'Couchbase\ViewQuery::keys' => ['Couchbase\ViewQuery', 'keys'=>'array'], 'Couchbase\ViewQuery::limit' => ['Couchbase\ViewQuery', 'limit'=>'int'], 'Couchbase\ViewQuery::order' => ['Couchbase\ViewQuery', 'order'=>'int'], 'Couchbase\ViewQuery::range' => ['Couchbase\ViewQuery', 'startKey'=>'mixed', 'endKey'=>'mixed', 'inclusiveEnd='=>'bool|false'], 'Couchbase\ViewQuery::reduce' => ['Couchbase\ViewQuery', 'reduce'=>'bool'], 'Couchbase\ViewQuery::skip' => ['Couchbase\ViewQuery', 'skip'=>'int'], 'Couchbase\ViewQueryEncodable::encode' => ['array'], 'Couchbase\WildcardSearchQuery::__construct' => ['void'], 'Couchbase\WildcardSearchQuery::boost' => ['Couchbase\WildcardSearchQuery', 'boost'=>'float'], 'Couchbase\WildcardSearchQuery::field' => ['Couchbase\WildcardSearchQuery', 'field'=>'string'], 'Couchbase\WildcardSearchQuery::jsonSerialize' => ['array'], 'Couchbase\zlibCompress' => ['string', 'data'=>'string'], 'Couchbase\zlibDecompress' => ['string', 'data'=>'string'], 'count' => ['0|positive-int', 'var'=>'Countable|array', 'mode='=>'int'], 'count_chars' => ['mixed', 'input'=>'string', 'mode='=>'0|1|2|3|4'], 'Countable::count' => ['0|positive-int'], 'crack_check' => ['bool', 'dictionary'=>'', 'password'=>'string'], 'crack_closedict' => ['bool', 'dictionary='=>'resource'], 'crack_getlastmessage' => ['string'], 'crack_opendict' => ['resource', 'dictionary'=>'string'], 'crash' => [''], 'crc32' => ['int', 'str'=>'string'], 'create_function' => ['string', 'args'=>'string', 'code'=>'string'], 'crypt' => ['non-empty-string', 'str'=>'string', 'salt='=>'string'], 'ctype_alnum' => ['bool', 'c'=>'mixed'], 'ctype_alpha' => ['bool', 'c'=>'mixed'], 'ctype_cntrl' => ['bool', 'c'=>'mixed'], 'ctype_digit' => ['bool', 'c'=>'mixed'], 'ctype_graph' => ['bool', 'c'=>'mixed'], 'ctype_lower' => ['bool', 'c'=>'mixed'], 'ctype_print' => ['bool', 'c'=>'mixed'], 'ctype_punct' => ['bool', 'c'=>'mixed'], 'ctype_space' => ['bool', 'c'=>'mixed'], 'ctype_upper' => ['bool', 'c'=>'mixed'], 'ctype_xdigit' => ['bool', 'c'=>'mixed'], 'cubrid_affected_rows' => ['int', 'req_identifier='=>''], 'cubrid_bind' => ['bool', 'req_identifier'=>'resource', 'bind_param'=>'int', 'bind_value'=>'mixed', 'bind_value_type='=>'string'], 'cubrid_client_encoding' => ['string', 'conn_identifier='=>''], 'cubrid_close' => ['bool', 'conn_identifier='=>''], 'cubrid_close_prepare' => ['bool', 'req_identifier'=>'resource'], 'cubrid_close_request' => ['bool', 'req_identifier'=>'resource'], 'cubrid_col_get' => ['array', 'conn_identifier'=>'resource', 'oid'=>'string', 'attr_name'=>'string'], 'cubrid_col_size' => ['int', 'conn_identifier'=>'resource', 'oid'=>'string', 'attr_name'=>'string'], 'cubrid_column_names' => ['array', 'req_identifier'=>'resource'], 'cubrid_column_types' => ['array', 'req_identifier'=>'resource'], 'cubrid_commit' => ['bool', 'conn_identifier'=>'resource'], 'cubrid_connect' => ['resource', 'host'=>'string', 'port'=>'int', 'dbname'=>'string', 'userid='=>'string', 'passwd='=>'string'], 'cubrid_connect_with_url' => ['resource', 'conn_url'=>'string', 'userid='=>'string', 'passwd='=>'string'], 'cubrid_current_oid' => ['string', 'req_identifier'=>'resource'], 'cubrid_data_seek' => ['bool', 'req_identifier'=>'', 'row_number'=>'int'], 'cubrid_db_name' => ['string', 'result'=>'array', 'index'=>'int'], 'cubrid_db_parameter' => ['array', 'conn_identifier'=>'resource'], 'cubrid_disconnect' => ['bool', 'conn_identifier'=>'resource'], 'cubrid_drop' => ['bool', 'conn_identifier'=>'resource', 'oid'=>'string'], 'cubrid_errno' => ['int', 'conn_identifier='=>''], 'cubrid_error' => ['string', 'connection='=>''], 'cubrid_error_code' => ['int'], 'cubrid_error_code_facility' => ['int'], 'cubrid_error_msg' => ['string'], 'cubrid_execute' => ['bool', 'conn_identifier'=>'', 'sql'=>'string', 'option='=>'int', 'request_identifier='=>''], 'cubrid_fetch' => ['mixed', 'result'=>'resource', 'type='=>'int'], 'cubrid_fetch_array' => ['array', 'result'=>'', 'type='=>'int'], 'cubrid_fetch_assoc' => ['array', 'result'=>''], 'cubrid_fetch_field' => ['object', 'result'=>'', 'field_offset='=>'int'], 'cubrid_fetch_lengths' => ['array', 'result'=>''], 'cubrid_fetch_object' => ['object', 'result'=>'', 'class_name='=>'string', 'params='=>'array'], 'cubrid_fetch_row' => ['array', 'result'=>''], 'cubrid_field_flags' => ['string', 'result'=>'', 'field_offset'=>'int'], 'cubrid_field_len' => ['int', 'result'=>'', 'field_offset'=>'int'], 'cubrid_field_name' => ['string', 'result'=>'', 'field_offset'=>'int'], 'cubrid_field_seek' => ['bool', 'result'=>'', 'field_offset='=>'int'], 'cubrid_field_table' => ['string', 'result'=>'', 'field_offset'=>'int'], 'cubrid_field_type' => ['string', 'result'=>'', 'field_offset'=>'int'], 'cubrid_free_result' => ['bool', 'req_identifier'=>'resource'], 'cubrid_get' => ['mixed', 'conn_identifier'=>'resource', 'oid'=>'string', 'attr='=>'mixed'], 'cubrid_get_autocommit' => ['bool', 'conn_identifier'=>'resource'], 'cubrid_get_charset' => ['string', 'conn_identifier'=>'resource'], 'cubrid_get_class_name' => ['string', 'conn_identifier'=>'resource', 'oid'=>'string'], 'cubrid_get_client_info' => ['string'], 'cubrid_get_db_parameter' => ['array', 'conn_identifier'=>'resource'], 'cubrid_get_query_timeout' => ['int', 'req_identifier'=>'resource'], 'cubrid_get_server_info' => ['string', 'conn_identifier'=>'resource'], 'cubrid_insert_id' => ['string', 'conn_identifier='=>'resource'], 'cubrid_is_instance' => ['int', 'conn_identifier'=>'resource', 'oid'=>'string'], 'cubrid_list_dbs' => ['array', 'conn_identifier'=>''], 'cubrid_load_from_glo' => ['int', 'conn_identifier'=>'', 'oid'=>'string', 'file_name'=>'string'], 'cubrid_lob2_bind' => ['bool', 'req_identifier'=>'resource', 'bind_index'=>'int', 'bind_value'=>'mixed', 'bind_value_type='=>'string'], 'cubrid_lob2_close' => ['bool', 'lob_identifier'=>'resource'], 'cubrid_lob2_export' => ['bool', 'lob_identifier'=>'resource', 'file_name'=>'string'], 'cubrid_lob2_import' => ['bool', 'lob_identifier'=>'resource', 'file_name'=>'string'], 'cubrid_lob2_new' => ['resource', 'conn_identifier='=>'resource', 'type='=>'string'], 'cubrid_lob2_read' => ['string', 'lob_identifier'=>'resource', 'len'=>'int'], 'cubrid_lob2_seek' => ['bool', 'lob_identifier'=>'resource', 'offset'=>'int', 'origin='=>'int'], 'cubrid_lob2_seek64' => ['bool', 'lob_identifier'=>'resource', 'offset'=>'string', 'origin='=>'int'], 'cubrid_lob2_size' => ['int', 'lob_identifier'=>'resource'], 'cubrid_lob2_size64' => ['string', 'lob_identifier'=>'resource'], 'cubrid_lob2_tell' => ['int', 'lob_identifier'=>'resource'], 'cubrid_lob2_tell64' => ['string', 'lob_identifier'=>'resource'], 'cubrid_lob2_write' => ['bool', 'lob_identifier'=>'resource', 'buf'=>'string'], 'cubrid_lob_close' => ['bool', 'lob_identifier_array'=>'array'], 'cubrid_lob_export' => ['bool', 'conn_identifier'=>'resource', 'lob_identifier'=>'resource', 'path_name'=>'string'], 'cubrid_lob_get' => ['array', 'conn_identifier'=>'resource', 'sql'=>'string'], 'cubrid_lob_send' => ['bool', 'conn_identifier'=>'resource', 'lob_identifier'=>'resource'], 'cubrid_lob_size' => ['string', 'lob_identifier'=>'resource'], 'cubrid_lock_read' => ['bool', 'conn_identifier'=>'resource', 'oid'=>'string'], 'cubrid_lock_write' => ['bool', 'conn_identifier'=>'resource', 'oid'=>'string'], 'cubrid_move_cursor' => ['int', 'req_identifier'=>'resource', 'offset'=>'int', 'origin='=>'int'], 'cubrid_new_glo' => ['string', 'conn_identifier'=>'', 'class_name'=>'string', 'file_name'=>'string'], 'cubrid_next_result' => ['bool', 'result'=>'resource'], 'cubrid_num_cols' => ['int', 'req_identifier'=>'resource'], 'cubrid_num_fields' => ['int', 'result'=>''], 'cubrid_num_rows' => ['int', 'req_identifier'=>'resource'], 'cubrid_pconnect' => ['resource', 'host'=>'string', 'port'=>'int', 'dbname'=>'string', 'userid='=>'string', 'passwd='=>'string'], 'cubrid_pconnect_with_url' => ['resource', 'conn_url'=>'string', 'userid='=>'string', 'passwd='=>'string'], 'cubrid_ping' => ['bool', 'conn_identifier='=>''], 'cubrid_prepare' => ['resource', 'conn_identifier'=>'resource', 'prepare_stmt'=>'string', 'option='=>'int'], 'cubrid_put' => ['bool', 'conn_identifier'=>'resource', 'oid'=>'string', 'attr='=>'string', 'value='=>'mixed'], 'cubrid_query' => ['resource', 'query'=>'string', 'conn_identifier='=>''], 'cubrid_real_escape_string' => ['string', 'unescaped_string'=>'string', 'conn_identifier='=>''], 'cubrid_result' => ['string', 'result'=>'', 'row'=>'int', 'field='=>''], 'cubrid_rollback' => ['bool', 'conn_identifier'=>'resource'], 'cubrid_save_to_glo' => ['int', 'conn_identifier'=>'', 'oid'=>'string', 'file_name'=>'string'], 'cubrid_schema' => ['array', 'conn_identifier'=>'resource', 'schema_type'=>'int', 'class_name='=>'string', 'attr_name='=>'string'], 'cubrid_send_glo' => ['int', 'conn_identifier'=>'', 'oid'=>'string'], 'cubrid_seq_drop' => ['bool', 'conn_identifier'=>'resource', 'oid'=>'string', 'attr_name'=>'string', 'index'=>'int'], 'cubrid_seq_insert' => ['bool', 'conn_identifier'=>'resource', 'oid'=>'string', 'attr_name'=>'string', 'index'=>'int', 'seq_element'=>'string'], 'cubrid_seq_put' => ['bool', 'conn_identifier'=>'resource', 'oid'=>'string', 'attr_name'=>'string', 'index'=>'int', 'seq_element'=>'string'], 'cubrid_set_add' => ['bool', 'conn_identifier'=>'resource', 'oid'=>'string', 'attr_name'=>'string', 'set_element'=>'string'], 'cubrid_set_autocommit' => ['bool', 'conn_identifier'=>'resource', 'mode'=>'bool'], 'cubrid_set_db_parameter' => ['bool', 'conn_identifier'=>'resource', 'param_type'=>'int', 'param_value'=>'int'], 'cubrid_set_drop' => ['bool', 'conn_identifier'=>'resource', 'oid'=>'string', 'attr_name'=>'string', 'set_element'=>'string'], 'cubrid_set_query_timeout' => ['bool', 'req_identifier'=>'resource', 'timeout'=>'int'], 'cubrid_unbuffered_query' => ['resource', 'query'=>'string', 'conn_identifier='=>''], 'cubrid_version' => ['string'], 'curl_close' => ['void', 'ch'=>'resource'], 'curl_copy_handle' => ['resource|false', 'ch'=>'resource'], 'curl_errno' => ['int', 'ch'=>'resource'], 'curl_error' => ['string', 'ch'=>'resource'], 'curl_escape' => ['string|false', 'ch'=>'resource', 'str'=>'string'], 'curl_exec' => ['bool|string', 'ch'=>'resource'], 'curl_file_create' => ['CURLFile', 'filename'=>'string', 'mimetype='=>'string', 'postfilename='=>'string'], 'curl_getinfo' => ['mixed', 'ch'=>'resource', 'option='=>'int'], 'curl_init' => ['__benevolent<resource|false>', 'url='=>'string'], 'curl_multi_add_handle' => ['int', 'mh'=>'resource', 'ch'=>'resource'], 'curl_multi_close' => ['void', 'mh'=>'resource'], 'curl_multi_errno' => ['int', 'mh'=>'resource'], 'curl_multi_exec' => ['int', 'mh'=>'resource', '&w_still_running'=>'int'], 'curl_multi_getcontent' => ['string|null', 'ch'=>'resource'], 'curl_multi_info_read' => ['array|false', 'mh'=>'resource', '&w_msgs_in_queue='=>'int'], 'curl_multi_init' => ['resource'], 'curl_multi_remove_handle' => ['int', 'mh'=>'resource', 'ch'=>'resource'], 'curl_multi_select' => ['int', 'mh'=>'resource', 'timeout='=>'float'], 'curl_multi_setopt' => ['bool', 'mh'=>'resource', 'option'=>'int', 'value'=>'mixed'], 'curl_multi_strerror' => ['string', 'code'=>'int'], 'curl_pause' => ['int', 'ch'=>'resource', 'bitmask'=>'int'], 'curl_reset' => ['void', 'ch'=>'resource'], 'curl_setopt' => ['bool', 'ch'=>'resource', 'option'=>'int', 'value'=>'mixed'], 'curl_setopt_array' => ['bool', 'ch'=>'resource', 'options'=>'array'], 'curl_share_close' => ['void', 'sh'=>'resource'], 'curl_share_errno' => ['int', 'sh'=>'resource'], 'curl_share_init' => ['resource'], 'curl_share_setopt' => ['bool', 'sh'=>'resource', 'option'=>'int', 'value'=>'mixed'], 'curl_share_strerror' => ['string', 'code'=>'int'], 'curl_strerror' => ['string', 'code'=>'int'], 'curl_unescape' => ['string|false', 'ch'=>'resource', 'str'=>'string'], 'curl_version' => ['array|false', 'version='=>'int'], 'CURLFile::__construct' => ['void', 'filename'=>'string', 'mimetype='=>'string', 'postfilename='=>'string'], 'CURLFile::__wakeup' => ['void'], 'CURLFile::getFilename' => ['string'], 'CURLFile::getMimeType' => ['string'], 'CURLFile::getPostFilename' => ['string'], 'CURLFile::setMimeType' => ['void', 'mime'=>'string'], 'CURLFile::setPostFilename' => ['void', 'name'=>'string'], 'current' => ['mixed', 'array_arg'=>'array|object'], 'cyrus_authenticate' => ['void', 'connection'=>'resource', 'mechlist='=>'string', 'service='=>'string', 'user='=>'string', 'minssf='=>'int', 'maxssf='=>'int', 'authname='=>'string', 'password='=>'string'], 'cyrus_bind' => ['bool', 'connection'=>'resource', 'callbacks'=>'array'], 'cyrus_close' => ['bool', 'connection'=>'resource'], 'cyrus_connect' => ['resource', 'host='=>'string', 'port='=>'string', 'flags='=>'int'], 'cyrus_query' => ['array', 'connection'=>'resource', 'query'=>'string'], 'cyrus_unbind' => ['bool', 'connection'=>'resource', 'trigger_name'=>'string'], 'date' => ['string', 'format'=>'string', 'timestamp='=>'int'], 'date_add' => ['DateTime|false', 'object'=>'', 'interval'=>''], 'date_create' => ['DateTime|false', 'time='=>'string|null', 'timezone='=>'?DateTimeZone'], 'date_create_from_format' => ['DateTime|false', 'format'=>'string', 'time'=>'string', 'timezone='=>'?DateTimeZone'], 'date_create_immutable' => ['DateTimeImmutable|false', 'time='=>'string', 'timezone='=>'?DateTimeZone'], 'date_create_immutable_from_format' => ['DateTimeImmutable|false', 'format'=>'string', 'time'=>'string', 'timezone='=>'?DateTimeZone'], 'date_date_set' => ['DateTime|false', 'object'=>'', 'year'=>'', 'month'=>'', 'day'=>''], 'date_default_timezone_get' => ['string'], 'date_default_timezone_set' => ['bool', 'timezone_identifier'=>'string'], 'date_diff' => ['DateInterval', 'obj1'=>'DateTimeInterface', 'obj2'=>'DateTimeInterface', 'absolute='=>'bool'], 'date_format' => ['string', 'obj'=>'DateTimeInterface', 'format'=>'string'], 'date_get_last_errors' => ['array{warning_count: 0|positive-int, warnings: list<string>, error_count: 0|positive-int, errors: list<string>}|false'], 'date_interval_create_from_date_string' => ['DateInterval|false', 'time'=>'string'], 'date_interval_format' => ['string', 'object'=>'DateInterval', 'format'=>'string'], 'date_isodate_set' => ['DateTime|false', 'object'=>'DateTime', 'year'=>'int', 'week'=>'int', 'day='=>'int|mixed'], 'date_modify' => ['DateTime|false', 'object'=>'DateTime', 'modify'=>'string'], 'date_offset_get' => ['int', 'obj'=>'DateTimeInterface'], 'date_parse' => ['array{year: int|false, month: int|false, day: int|false, hour: int|false, minute: int|false, second: int|false, fraction: float|false, warning_count: int, warnings: string[], error_count: int, errors: string[], is_localtime: bool, zone_type?: int|bool, zone?: int|bool, is_dst?: bool, tz_abbr?: string, tz_id?: string, relative?: array{year: int, month: int, day: int, hour: int, minute: int, second: int, weekday?: int, weekdays?: int, first_day_of_month?: bool, last_day_of_month?: bool}}', 'date'=>'string'], 'date_parse_from_format' => ['array{year: int|false, month: int|false, day: int|false, hour: int|false, minute: int|false, second: int|false, fraction: float|false, warning_count: int, warnings: string[], error_count: int, errors: string[], is_localtime: bool, zone_type?: int|bool, zone?: int|bool, is_dst?: bool, tz_abbr?: string, tz_id?: string, relative?: array{year: int, month: int, day: int, hour: int, minute: int, second: int, weekday?: int, weekdays?: int, first_day_of_month?: bool, last_day_of_month?: bool}}', 'format'=>'string', 'date'=>'string'], 'date_sub' => ['DateTime|false', 'object'=>'DateTime', 'interval'=>'DateInterval'], 'date_sun_info' => ['__benevolent<array{sunrise: int|bool,sunset: int|bool,transit: int|bool,civil_twilight_begin: int|bool,civil_twilight_end: int|bool,nautical_twilight_begin: int|bool,nautical_twilight_end: int|bool,astronomical_twilight_begin: int|bool,astronomical_twilight_end: int|bool}|false>', 'time'=>'int', 'latitude'=>'float', 'longitude'=>'float'], 'date_sunrise' => ['mixed', 'time'=>'int', 'format='=>'int', 'latitude='=>'float', 'longitude='=>'float', 'zenith='=>'float', 'gmt_offset='=>'float'], 'date_sunset' => ['mixed', 'time'=>'int', 'format='=>'int', 'latitude='=>'float', 'longitude='=>'float', 'zenith='=>'float', 'gmt_offset='=>'float'], 'date_time_set' => ['DateTime|false', 'object'=>'', 'hour'=>'', 'minute'=>'', 'second='=>'', 'microseconds='=>''], 'date_timestamp_get' => ['int', 'obj'=>'DateTimeInterface'], 'date_timestamp_set' => ['DateTime|false', 'object'=>'DateTime', 'unixtimestamp'=>'int'], 'date_timezone_get' => ['DateTimeZone|false', 'obj'=>'DateTimeInterface'], 'date_timezone_set' => ['DateTime|false', 'object'=>'DateTime', 'timezone'=>'DateTimeZone'], 'datefmt_create' => ['IntlDateFormatter|false', 'locale'=>'?string', 'datetype'=>'?int', 'timetype'=>'?int', 'timezone='=>'string|DateTimeZone|IntlTimeZone|null', 'calendar='=>'int|IntlCalendar|null', 'pattern='=>'string'], 'datefmt_format' => ['string|false', 'fmt'=>'IntlDateFormatter', 'value'=>'DateTime|IntlCalendar|array|int'], 'datefmt_format_object' => ['string|false', 'object'=>'object', 'format='=>'mixed', 'locale='=>'string'], 'datefmt_get_calendar' => ['int|false', 'fmt'=>'IntlDateFormatter'], 'datefmt_get_calendar_object' => ['IntlCalendar|false|null', 'fmt'=>'IntlDateFormatter'], 'datefmt_get_datetype' => ['int|false', 'fmt'=>'IntlDateFormatter'], 'datefmt_get_error_code' => ['int', 'fmt'=>'IntlDateFormatter'], 'datefmt_get_error_message' => ['string', 'fmt'=>'IntlDateFormatter'], 'datefmt_get_locale' => ['string|false', 'fmt'=>'IntlDateFormatter', 'which='=>'int'], 'datefmt_get_pattern' => ['string|false', 'fmt'=>'IntlDateFormatter'], 'datefmt_get_timetype' => ['int|false', 'fmt'=>'IntlDateFormatter'], 'datefmt_get_timezone' => ['IntlTimeZone|false'], 'datefmt_get_timezone_id' => ['string|false', 'fmt'=>'IntlDateFormatter'], 'datefmt_is_lenient' => ['bool', 'fmt'=>'IntlDateFormatter'], 'datefmt_localtime' => ['array|false', 'fmt'=>'IntlDateFormatter', 'text_to_parse='=>'string', '&rw_parse_pos='=>'int'], 'datefmt_parse' => ['int|float|false', 'fmt'=>'IntlDateFormatter', 'text_to_parse='=>'string', '&rw_parse_pos='=>'int'], 'datefmt_set_calendar' => ['bool', 'fmt'=>'IntlDateFormatter', 'which'=>'int'], 'datefmt_set_lenient' => ['void', 'fmt'=>'IntlDateFormatter', 'lenient'=>'bool'], 'datefmt_set_pattern' => ['bool', 'fmt'=>'IntlDateFormatter', 'pattern'=>'string'], 'datefmt_set_timezone' => ['bool', 'zone'=>'mixed'], 'datefmt_set_timezone_id' => ['bool', 'fmt'=>'IntlDateFormatter', 'zone'=>'string'], 'DateInterval::__construct' => ['void', 'spec'=>'string'], 'DateInterval::__set_state' => ['DateInterval', 'array'=>'array'], 'DateInterval::__wakeup' => ['void'], 'DateInterval::createFromDateString' => ['DateInterval|false', 'time'=>'string'], 'DateInterval::format' => ['string', 'format'=>'string'], 'DatePeriod::__construct' => ['void', 'start'=>'DateTimeInterface', 'interval'=>'DateInterval', 'recur'=>'int', 'options='=>'int'], 'DatePeriod::__construct\'1' => ['void', 'start'=>'DateTimeInterface', 'interval'=>'DateInterval', 'end'=>'DateTimeInterface', 'options='=>'int'], 'DatePeriod::__construct\'2' => ['void', 'iso'=>'string', 'options='=>'int'], 'DatePeriod::__wakeup' => ['void'], 'DatePeriod::getDateInterval' => ['DateInterval'], 'DatePeriod::getEndDate' => ['?DateTimeInterface'], 'DatePeriod::getStartDate' => ['DateTimeInterface'], 'DateTime::__construct' => ['void', 'time='=>'string', 'timezone='=>'?DateTimeZone'], 'DateTime::__set_state' => ['static', 'array'=>'array'], 'DateTime::__wakeup' => ['void'], 'DateTime::add' => ['static', 'interval'=>'DateInterval'], 'DateTime::createFromFormat' => ['static|false', 'format'=>'string', 'time'=>'string', 'timezone='=>'DateTimeZone|null'], 'DateTime::createFromImmutable' => ['static', 'object'=>'DateTimeImmutable'], 'DateTime::diff' => ['DateInterval', 'datetime2'=>'DateTimeInterface', 'absolute='=>'bool'], 'DateTime::format' => ['string', 'format'=>'string'], 'DateTime::getLastErrors' => ['array{warning_count: 0|positive-int, warnings: list<string>, error_count: 0|positive-int, errors: list<string>}|false'], 'DateTime::getOffset' => ['int'], 'DateTime::getTimestamp' => ['int'], 'DateTime::getTimezone' => ['DateTimeZone'], 'DateTime::modify' => ['__benevolent<static|false>', 'modify'=>'string'], 'DateTime::setDate' => ['static', 'year'=>'int', 'month'=>'int', 'day'=>'int'], 'DateTime::setISODate' => ['static', 'year'=>'int', 'week'=>'int', 'day='=>'int'], 'DateTime::setTime' => ['static', 'hour'=>'int', 'minute'=>'int', 'second='=>'int', 'microseconds='=>'int'], 'DateTime::setTimestamp' => ['static', 'unixtimestamp'=>'int'], 'DateTime::setTimezone' => ['static', 'timezone'=>'DateTimeZone'], 'DateTime::sub' => ['static', 'interval'=>'DateInterval'], 'DateTimeImmutable::__construct' => ['void', 'time='=>'string', 'timezone='=>'?DateTimeZone'], 'DateTimeImmutable::__set_state' => ['static', 'array'=>'array'], 'DateTimeImmutable::__wakeup' => ['void'], 'DateTimeImmutable::add' => ['static', 'interval'=>'DateInterval'], 'DateTimeImmutable::createFromFormat' => ['static|false', 'format'=>'string', 'time'=>'string', 'timezone='=>'DateTimeZone|null'], 'DateTimeImmutable::createFromMutable' => ['static', 'datetime'=>'DateTime'], 'DateTimeImmutable::diff' => ['DateInterval', 'datetime2'=>'DateTimeInterface', 'absolute='=>'bool'], 'DateTimeImmutable::format' => ['string', 'format'=>'string'], 'DateTimeImmutable::getLastErrors' => ['array{warning_count: 0|positive-int, warnings: list<string>, error_count: 0|positive-int, errors: list<string>}|false'], 'DateTimeImmutable::getOffset' => ['int'], 'DateTimeImmutable::getTimestamp' => ['int'], 'DateTimeImmutable::getTimezone' => ['DateTimeZone'], 'DateTimeImmutable::modify' => ['__benevolent<static|false>', 'modify'=>'string'], 'DateTimeImmutable::setDate' => ['static', 'year'=>'int', 'month'=>'int', 'day'=>'int'], 'DateTimeImmutable::setISODate' => ['static', 'year'=>'int', 'week'=>'int', 'day='=>'int'], 'DateTimeImmutable::setTime' => ['static', 'hour'=>'int', 'minute'=>'int', 'second='=>'int', 'microseconds='=>'int'], 'DateTimeImmutable::setTimestamp' => ['static', 'unixtimestamp'=>'int'], 'DateTimeImmutable::setTimezone' => ['static', 'timezone'=>'DateTimeZone'], 'DateTimeImmutable::sub' => ['static', 'interval'=>'DateInterval'], 'DateTimeInterface::diff' => ['DateInterval', 'datetime2'=>'DateTimeInterface', 'absolute='=>'bool'], 'DateTimeInterface::format' => ['string', 'format'=>'string'], 'DateTimeInterface::getOffset' => ['int'], 'DateTimeInterface::getTimestamp' => ['int'], 'DateTimeInterface::getTimezone' => ['DateTimeZone'], 'DateTimeZone::__construct' => ['void', 'timezone'=>'string'], 'DateTimeZone::__set_state' => ['DateTimeZone', 'array'=>'array'], 'DateTimeZone::__wakeup' => ['void'], 'DateTimeZone::getLocation' => ['array{country_code: string, latitude: float, longitude: float, comments: string}|false'], 'DateTimeZone::getName' => ['string'], 'DateTimeZone::getOffset' => ['int', 'datetime'=>'DateTimeInterface'], 'DateTimeZone::getTransitions' => ['list<array{ts: int, time: string, offset: int, isdst: bool, abbr: string}>', 'timestamp_begin='=>'int', 'timestamp_end='=>'int'], 'DateTimeZone::listAbbreviations' => ['array<string, list<array{dst: bool, offset: int, timezone_id: string|null}>>'], 'DateTimeZone::listIdentifiers' => ['list<string>', 'what='=>'int', 'country='=>'string'], 'db2_autocommit' => ['DB2_AUTOCOMMIT_OFF|DB2_AUTOCOMMIT_ON|bool', 'connection'=>'resource', 'value='=>'DB2_AUTOCOMMIT_OFF|DB2_AUTOCOMMIT_ON'], 'db2_bind_param' => ['bool', 'stmt'=>'resource', 'parameter_number'=>'int', 'variable_name'=>'string', 'parameter_type='=>'int', 'data_type='=>'int', 'precision='=>'int', 'scale='=>'int'], 'db2_client_info' => ['stdClass|false', 'connection'=>'resource'], 'db2_close' => ['bool', 'connection'=>'resource'], 'db2_column_privileges' => ['resource|false', 'connection'=>'resource', 'qualifier='=>'string', 'schema='=>'string', 'table_name='=>'string', 'column_name='=>'string'], 'db2_columns' => ['resource|false', 'connection'=>'resource', 'qualifier='=>'string', 'schema='=>'string', 'table_name='=>'string', 'column_name='=>'string'], 'db2_commit' => ['bool', 'connection'=>'resource'], 'db2_conn_error' => ['string', 'connection='=>'resource'], 'db2_conn_errormsg' => ['string', 'connection='=>'resource'], 'db2_connect' => ['resource|false', 'database'=>'string', 'username'=>'string', 'password'=>'string', 'options='=>'array'], 'db2_cursor_type' => ['int', 'stmt'=>'resource'], 'db2_escape_string' => ['string', 'string_literal'=>'string'], 'db2_exec' => ['resource|false', 'connection'=>'resource', 'statement'=>'string', 'options='=>'array'], 'db2_execute' => ['bool', 'stmt'=>'resource', 'parameters='=>'array'], 'db2_fetch_array' => ['non-empty-list<mixed>|false', 'stmt'=>'resource', 'row_number='=>'int'], 'db2_fetch_assoc' => ['non-empty-array<string,mixed>|false', 'stmt'=>'resource', 'row_number='=>'int'], 'db2_fetch_both' => ['array|false', 'stmt'=>'resource', 'row_number='=>'int'], 'db2_fetch_object' => ['stdClass|false', 'stmt'=>'resource', 'row_number='=>'int'], 'db2_fetch_row' => ['bool', 'stmt'=>'resource', 'row_number='=>'int'], 'db2_field_display_size' => ['int|false', 'stmt'=>'resource', 'column'=>'mixed'], 'db2_field_name' => ['string|false', 'stmt'=>'resource', 'column'=>'mixed'], 'db2_field_num' => ['int|false', 'stmt'=>'resource', 'column'=>'mixed'], 'db2_field_precision' => ['int|false', 'stmt'=>'resource', 'column'=>'mixed'], 'db2_field_scale' => ['int|false', 'stmt'=>'resource', 'column'=>'mixed'], 'db2_field_type' => ['string|false', 'stmt'=>'resource', 'column'=>'mixed'], 'db2_field_width' => ['int|false', 'stmt'=>'resource', 'column'=>'mixed'], 'db2_foreign_keys' => ['resource|false', 'connection'=>'resource', 'qualifier'=>'string', 'schema'=>'string', 'table_name'=>'string'], 'db2_free_result' => ['bool', 'stmt'=>'resource'], 'db2_free_stmt' => ['bool', 'stmt'=>'resource'], 'db2_get_option' => ['string|false', 'resource'=>'resource', 'option'=>'string'], 'db2_last_insert_id' => ['string|null', 'resource'=>'resource'], 'db2_lob_read' => ['string|false', 'stmt'=>'resource', 'colnum'=>'int', 'length'=>'int'], 'db2_next_result' => ['resource|false', 'stmt'=>'resource'], 'db2_num_fields' => ['0|positive-int|false', 'stmt'=>'resource'], 'db2_num_rows' => ['0|positive-int|false', 'stmt'=>'resource'], 'db2_pclose' => ['bool', 'resource'=>'resource'], 'db2_pconnect' => ['resource|false', 'database'=>'string', 'username'=>'string', 'password'=>'string', 'options='=>'array'], 'db2_prepare' => ['resource|false', 'connection'=>'resource', 'statement'=>'string', 'options='=>'array'], 'db2_primary_keys' => ['resource|false', 'connection'=>'resource', 'qualifier'=>'string', 'schema'=>'string', 'table_name'=>'string'], 'db2_primarykeys' => [''], 'db2_procedure_columns' => ['resource|false', 'connection'=>'resource', 'qualifier'=>'string', 'schema'=>'string', 'procedure'=>'string', 'parameter'=>'string'], 'db2_procedurecolumns' => [''], 'db2_procedures' => ['resource|false', 'connection'=>'resource', 'qualifier'=>'string', 'schema'=>'string', 'procedure'=>'string'], 'db2_result' => ['mixed', 'stmt'=>'resource', 'column'=>'mixed'], 'db2_rollback' => ['bool', 'connection'=>'resource'], 'db2_server_info' => ['stdClass|false', 'connection'=>'resource'], 'db2_set_option' => ['bool', 'resource'=>'resource', 'options'=>'array', 'type'=>'int'], 'db2_setoption' => [''], 'db2_special_columns' => ['resource|false', 'connection'=>'resource', 'qualifier'=>'string', 'schema'=>'string', 'table_name'=>'string', 'scope'=>'int'], 'db2_specialcolumns' => [''], 'db2_statistics' => ['resource|false', 'connection'=>'resource', 'qualifier'=>'string', 'schema'=>'string', 'table_name'=>'string', 'unique'=>'bool'], 'db2_stmt_error' => ['string', 'stmt='=>'resource'], 'db2_stmt_errormsg' => ['string', 'stmt='=>'resource'], 'db2_table_privileges' => ['resource|false', 'connection'=>'resource', 'qualifier='=>'string', 'schema='=>'string', 'table_name='=>'string'], 'db2_tableprivileges' => [''], 'db2_tables' => ['resource|false', 'connection'=>'resource', 'qualifier='=>'string', 'schema='=>'string', 'table_name='=>'string', 'table_type='=>'string'], 'dba_close' => ['void', 'handle'=>'resource'], 'dba_delete' => ['bool', 'key'=>'string', 'handle'=>'resource'], 'dba_exists' => ['bool', 'key'=>'string', 'handle'=>'resource'], 'dba_fetch' => ['string|false', 'key'=>'string', 'skip'=>'int', 'handle'=>'resource'], 'dba_fetch\'1' => ['string|false', 'key'=>'string', 'handle'=>'resource'], 'dba_firstkey' => ['string|false', 'handle'=>'resource'], 'dba_handlers' => ['array', 'full_info='=>'bool'], 'dba_insert' => ['bool', 'key'=>'string', 'value'=>'string', 'handle'=>'resource'], 'dba_key_split' => ['array|false', 'key'=>'string'], 'dba_list' => ['array'], 'dba_nextkey' => ['string|false', 'handle'=>'resource'], 'dba_open' => ['resource|false', 'path'=>'string', 'mode'=>'string', 'handlername='=>'string', '...args='=>'string'], 'dba_optimize' => ['bool', 'handle'=>'resource'], 'dba_popen' => ['resource|false', 'path'=>'string', 'mode'=>'string', 'handlername='=>'string', '...args='=>'string'], 'dba_replace' => ['bool', 'key'=>'string', 'value'=>'string', 'handle'=>'resource'], 'dba_sync' => ['bool', 'handle'=>'resource'], 'dbase_add_record' => ['bool', 'dbase_identifier'=>'resource', 'record'=>'array'], 'dbase_close' => ['bool', 'dbase_identifier'=>'resource'], 'dbase_create' => ['resource|false', 'filename'=>'string', 'fields'=>'array'], 'dbase_delete_record' => ['bool', 'dbase_identifier'=>'resource', 'record_number'=>'int'], 'dbase_get_header_info' => ['array', 'dbase_identifier'=>'resource'], 'dbase_get_record' => ['array', 'dbase_identifier'=>'resource', 'record_number'=>'int'], 'dbase_get_record_with_names' => ['array', 'dbase_identifier'=>'resource', 'record_number'=>'int'], 'dbase_numfields' => ['int', 'dbase_identifier'=>'resource'], 'dbase_numrecords' => ['int', 'dbase_identifier'=>'resource'], 'dbase_open' => ['resource|false', 'filename'=>'string', 'mode'=>'int'], 'dbase_pack' => ['bool', 'dbase_identifier'=>'resource'], 'dbase_replace_record' => ['bool', 'dbase_identifier'=>'resource', 'record'=>'array', 'record_number'=>'int'], 'dbplus_add' => ['int', 'relation'=>'resource', 'tuple'=>'array'], 'dbplus_aql' => ['resource', 'query'=>'string', 'server='=>'string', 'dbpath='=>'string'], 'dbplus_chdir' => ['string', 'newdir='=>'string'], 'dbplus_close' => ['mixed', 'relation'=>'resource'], 'dbplus_curr' => ['int', 'relation'=>'resource', 'tuple'=>'array'], 'dbplus_errcode' => ['string', 'errno='=>'int'], 'dbplus_errno' => ['int'], 'dbplus_find' => ['int', 'relation'=>'resource', 'constraints'=>'array', 'tuple'=>'mixed'], 'dbplus_first' => ['int', 'relation'=>'resource', 'tuple'=>'array'], 'dbplus_flush' => ['int', 'relation'=>'resource'], 'dbplus_freealllocks' => ['int'], 'dbplus_freelock' => ['int', 'relation'=>'resource', 'tuple'=>'string'], 'dbplus_freerlocks' => ['int', 'relation'=>'resource'], 'dbplus_getlock' => ['int', 'relation'=>'resource', 'tuple'=>'string'], 'dbplus_getunique' => ['int', 'relation'=>'resource', 'uniqueid'=>'int'], 'dbplus_info' => ['int', 'relation'=>'resource', 'key'=>'string', 'result'=>'array'], 'dbplus_last' => ['int', 'relation'=>'resource', 'tuple'=>'array'], 'dbplus_lockrel' => ['int', 'relation'=>'resource'], 'dbplus_next' => ['int', 'relation'=>'resource', 'tuple'=>'array'], 'dbplus_open' => ['resource', 'name'=>'string'], 'dbplus_prev' => ['int', 'relation'=>'resource', 'tuple'=>'array'], 'dbplus_rchperm' => ['int', 'relation'=>'resource', 'mask'=>'int', 'user'=>'string', 'group'=>'string'], 'dbplus_rcreate' => ['resource', 'name'=>'string', 'domlist'=>'mixed', 'overwrite='=>'bool'], 'dbplus_rcrtexact' => ['mixed', 'name'=>'string', 'relation'=>'resource', 'overwrite='=>'bool'], 'dbplus_rcrtlike' => ['mixed', 'name'=>'string', 'relation'=>'resource', 'overwrite='=>'int'], 'dbplus_resolve' => ['array', 'relation_name'=>'string'], 'dbplus_restorepos' => ['int', 'relation'=>'resource', 'tuple'=>'array'], 'dbplus_rkeys' => ['mixed', 'relation'=>'resource', 'domlist'=>'mixed'], 'dbplus_ropen' => ['resource', 'name'=>'string'], 'dbplus_rquery' => ['resource', 'query'=>'string', 'dbpath='=>'string'], 'dbplus_rrename' => ['int', 'relation'=>'resource', 'name'=>'string'], 'dbplus_rsecindex' => ['mixed', 'relation'=>'resource', 'domlist'=>'mixed', 'type'=>'int'], 'dbplus_runlink' => ['int', 'relation'=>'resource'], 'dbplus_rzap' => ['int', 'relation'=>'resource'], 'dbplus_savepos' => ['int', 'relation'=>'resource'], 'dbplus_setindex' => ['int', 'relation'=>'resource', 'idx_name'=>'string'], 'dbplus_setindexbynumber' => ['int', 'relation'=>'resource', 'idx_number'=>'int'], 'dbplus_sql' => ['resource', 'query'=>'string', 'server='=>'string', 'dbpath='=>'string'], 'dbplus_tcl' => ['string', 'sid'=>'int', 'script'=>'string'], 'dbplus_tremove' => ['int', 'relation'=>'resource', 'tuple'=>'array', 'current='=>'array'], 'dbplus_undo' => ['int', 'relation'=>'resource'], 'dbplus_undoprepare' => ['int', 'relation'=>'resource'], 'dbplus_unlockrel' => ['int', 'relation'=>'resource'], 'dbplus_unselect' => ['int', 'relation'=>'resource'], 'dbplus_update' => ['int', 'relation'=>'resource', 'old'=>'array', 'new'=>'array'], 'dbplus_xlockrel' => ['int', 'relation'=>'resource'], 'dbplus_xunlockrel' => ['int', 'relation'=>'resource'], 'dbx_close' => ['int', 'link_identifier'=>'object'], 'dbx_compare' => ['int', 'row_a'=>'array', 'row_b'=>'array', 'column_key'=>'string', 'flags='=>'int'], 'dbx_connect' => ['object', 'module'=>'mixed', 'host'=>'string', 'database'=>'string', 'username'=>'string', 'password'=>'string', 'persistent='=>'int'], 'dbx_error' => ['string', 'link_identifier'=>'object'], 'dbx_escape_string' => ['string', 'link_identifier'=>'object', 'text'=>'string'], 'dbx_fetch_row' => ['mixed', 'result_identifier'=>'object'], 'dbx_query' => ['mixed', 'link_identifier'=>'object', 'sql_statement'=>'string', 'flags='=>'int'], 'dbx_sort' => ['bool', 'result'=>'object', 'user_compare_function'=>'string'], 'dcgettext' => ['string', 'domain_name'=>'string', 'msgid'=>'string', 'category'=>'int'], 'dcngettext' => ['string', 'domain'=>'string', 'msgid1'=>'string', 'msgid2'=>'string', 'n'=>'int', 'category'=>'int'], 'deaggregate' => ['', 'object'=>'object', 'class_name='=>'string'], 'debug_backtrace' => ['list<array{function:string,line?:int,file?:string,class?:class-string,type?:\'::\'|\'->\',args?:mixed[],object?:object}>', 'options='=>'int|bool', 'limit='=>'int'], 'debug_print_backtrace' => ['void', 'options='=>'int|bool', 'limit='=>'int'], 'debug_zval_dump' => ['void', '...var'=>'mixed'], 'debugger_connect' => [''], 'debugger_connector_pid' => [''], 'debugger_get_server_start_time' => [''], 'debugger_print' => [''], 'debugger_start_debug' => [''], 'decbin' => ['string', 'decimal_number'=>'int'], 'dechex' => ['string', 'num'=>'int'], 'decoct' => ['string', 'decimal_number'=>'int'], 'define' => ['bool', 'constant_name'=>'string', 'value'=>'mixed', 'case_insensitive='=>'bool'], 'define_syslog_variables' => ['void'], 'defined' => ['bool', 'name'=>'string'], 'deflate_add' => ['string|false', 'context'=>'resource', 'data'=>'string', 'flush_mode='=>'int'], 'deflate_init' => ['resource|false', 'encoding'=>'int', 'options='=>'array'], 'deg2rad' => ['float', 'number'=>'float'], 'dgettext' => ['string', 'domain_name'=>'string', 'msgid'=>'string'], 'dio_close' => ['void', 'fd'=>'resource'], 'dio_fcntl' => ['mixed', 'fd'=>'resource', 'cmd'=>'int', 'args='=>'mixed'], 'dio_open' => ['resource|false', 'filename'=>'string', 'flags'=>'int', 'mode='=>'int'], 'dio_read' => ['string', 'fd'=>'resource', 'len='=>'int'], 'dio_seek' => ['int', 'fd'=>'resource', 'pos'=>'int', 'whence='=>'int'], 'dio_stat' => ['array|null', 'fd'=>'resource'], 'dio_tcsetattr' => ['bool', 'fd'=>'resource', 'options'=>'array'], 'dio_truncate' => ['bool', 'fd'=>'resource', 'offset'=>'int'], 'dio_write' => ['int', 'fd'=>'resource', 'data'=>'string', 'len='=>'int'], 'dir' => ['Directory|false', 'directory'=>'string', 'context='=>'resource'], 'Directory::close' => ['void', 'dir_handle='=>'resource'], 'Directory::read' => ['string|false', 'dir_handle='=>'resource'], 'Directory::rewind' => ['void', 'dir_handle='=>'resource'], 'DirectoryIterator::__construct' => ['void', 'path'=>'string'], 'DirectoryIterator::__toString' => ['string'], 'DirectoryIterator::current' => ['DirectoryIterator'], 'DirectoryIterator::getATime' => ['int'], 'DirectoryIterator::getBasename' => ['string', 'suffix='=>'string'], 'DirectoryIterator::getChildren' => ['RecursiveDirectoryIterator'], 'DirectoryIterator::getCTime' => ['int'], 'DirectoryIterator::getExtension' => ['string'], 'DirectoryIterator::getFileInfo' => ['SplFileInfo', 'class_name='=>'string'], 'DirectoryIterator::getFilename' => ['string'], 'DirectoryIterator::getGroup' => ['int'], 'DirectoryIterator::getInode' => ['int'], 'DirectoryIterator::getLinkTarget' => ['string'], 'DirectoryIterator::getMTime' => ['int'], 'DirectoryIterator::getOwner' => ['int'], 'DirectoryIterator::getPath' => ['string'], 'DirectoryIterator::getPathInfo' => ['SplFileInfo', 'class_name='=>'string'], 'DirectoryIterator::getPathname' => ['string'], 'DirectoryIterator::getPerms' => ['int'], 'DirectoryIterator::getRealPath' => ['string'], 'DirectoryIterator::getSize' => ['int'], 'DirectoryIterator::getType' => ['string'], 'DirectoryIterator::isDir' => ['bool'], 'DirectoryIterator::isDot' => ['bool'], 'DirectoryIterator::isExecutable' => ['bool'], 'DirectoryIterator::isFile' => ['bool'], 'DirectoryIterator::isLink' => ['bool'], 'DirectoryIterator::isReadable' => ['bool'], 'DirectoryIterator::isWritable' => ['bool'], 'DirectoryIterator::key' => ['string'], 'DirectoryIterator::next' => ['void'], 'DirectoryIterator::openFile' => ['SplFileObject', 'mode='=>'string', 'use_include_path='=>'bool', 'context='=>'resource'], 'DirectoryIterator::rewind' => ['void'], 'DirectoryIterator::seek' => ['void', 'position'=>'int'], 'DirectoryIterator::setFileClass' => ['void', 'class_name='=>'string'], 'DirectoryIterator::setInfoClass' => ['void', 'class_name='=>'string'], 'DirectoryIterator::valid' => ['bool'], 'dirname' => ['string', 'path'=>'string', 'levels='=>'positive-int'], 'disk_free_space' => ['float|false', 'path'=>'string'], 'disk_total_space' => ['float|false', 'path'=>'string'], 'diskfreespace' => ['float|false', 'path'=>'string'], 'display_disabled_function' => [''], 'dl' => ['bool', 'extension_filename'=>'string'], 'dngettext' => ['string', 'domain'=>'string', 'msgid1'=>'string', 'msgid2'=>'string', 'count'=>'int'], 'dns_check_record' => ['bool', 'host'=>'string', 'type='=>'string'], 'dns_get_mx' => ['bool', 'hostname'=>'string', '&w_mxhosts'=>'array', '&w_weight'=>'array'], 'dns_get_record' => ['list<array>|false', 'hostname'=>'string', 'type='=>'int', '&w_authns='=>'array', '&w_addtl='=>'array', 'raw='=>'bool'], 'dom_document_relaxNG_validate_file' => ['bool', 'filename'=>'string'], 'dom_document_relaxNG_validate_xml' => ['bool', 'source'=>'string'], 'dom_document_schema_validate' => ['bool', 'source'=>'string', 'flags'=>'int'], 'dom_document_schema_validate_file' => ['bool', 'filename'=>'string', 'flags'=>'int'], 'dom_document_xinclude' => ['int', 'options'=>'int'], 'dom_import_simplexml' => ['DOMElement|false', 'node'=>'SimpleXMLElement'], 'dom_xpath_evaluate' => ['', 'expr'=>'string', 'context'=>'DOMNode', 'registernodens'=>'bool'], 'dom_xpath_query' => ['DOMNodeList', 'expr'=>'string', 'context'=>'DOMNode', 'registernodens'=>'bool'], 'dom_xpath_register_ns' => ['bool', 'prefix'=>'string', 'uri'=>'string'], 'dom_xpath_register_php_functions' => [''], 'DomainException::__clone' => ['void'], 'DomainException::__construct' => ['void', 'message='=>'string', 'code='=>'int', 'previous='=>'(?Throwable)|(?DomainException)'], 'DomainException::__toString' => ['string'], 'DomainException::__wakeup' => ['void'], 'DomainException::getCode' => ['int'], 'DomainException::getFile' => ['string'], 'DomainException::getLine' => ['int'], 'DomainException::getMessage' => ['string'], 'DomainException::getPrevious' => ['Throwable|DomainException|null'], 'DomainException::getTrace' => ['list<array{function:string,line?:int,file?:string,class?:class-string,type?:\'::\'|\'->\',args?:mixed[],object?:object}>'], 'DomainException::getTraceAsString' => ['string'], 'DOMAttr::__construct' => ['void', 'name'=>'string', 'value='=>'string'], 'DOMAttr::isId' => ['bool'], 'DomAttribute::name' => ['string'], 'DomAttribute::set_value' => ['bool', 'content'=>'string'], 'DomAttribute::specified' => ['bool'], 'DomAttribute::value' => ['string'], 'DOMCdataSection::__construct' => ['void', 'value'=>'string'], 'DOMCharacterData::appendData' => ['void', 'data'=>'string'], 'DOMCharacterData::deleteData' => ['void', 'offset'=>'int', 'count'=>'int'], 'DOMCharacterData::insertData' => ['void', 'offset'=>'int', 'data'=>'string'], 'DOMCharacterData::replaceData' => ['void', 'offset'=>'int', 'count'=>'int', 'data'=>'string'], 'DOMCharacterData::substringData' => ['string', 'offset'=>'int', 'count'=>'int'], 'DOMComment::__construct' => ['void', 'value='=>'string'], 'DOMDocument::__construct' => ['void', 'version='=>'string', 'encoding='=>'string'], 'DOMDocument::createAttribute' => ['__benevolent<DOMAttr|false>', 'name'=>'string'], 'DOMDocument::createAttributeNS' => ['__benevolent<DOMAttr|false>', 'namespaceuri'=>'string', 'qualifiedname'=>'string'], 'DOMDocument::createCDATASection' => ['__benevolent<DOMCDATASection|false>', 'data'=>'string'], 'DOMDocument::createComment' => ['DOMComment', 'data'=>'string'], 'DOMDocument::createDocumentFragment' => ['DOMDocumentFragment'], 'DOMDocument::createElement' => ['__benevolent<DOMElement|false>', 'name'=>'string', 'value='=>'string'], 'DOMDocument::createElementNS' => ['__benevolent<DOMElement|false>', 'namespaceuri'=>'string', 'qualifiedname'=>'string', 'value='=>'string'], 'DOMDocument::createEntityReference' => ['__benevolent<DOMEntityReference|false>', 'name'=>'string'], 'DOMDocument::createProcessingInstruction' => ['__benevolent<DOMProcessingInstruction|false>', 'target'=>'string', 'data='=>'string'], 'DOMDocument::createTextNode' => ['DOMText', 'content'=>'string'], 'DOMDocument::getElementById' => ['DOMElement|null', 'elementid'=>'string'], 'DOMDocument::getElementsByTagName' => ['DOMNodeList', 'name'=>'string'], 'DOMDocument::getElementsByTagNameNS' => ['DOMNodeList', 'namespaceuri'=>'string', 'localname'=>'string'], 'DOMDocument::importNode' => ['DOMNode', 'importednode'=>'DOMNode', 'deep='=>'bool'], 'DOMDocument::load' => ['bool', 'filename'=>'string', 'options='=>'int'], 'DOMDocument::loadHTML' => ['bool', 'source'=>'string', 'options='=>'int'], 'DOMDocument::loadHTMLFile' => ['bool', 'filename'=>'string', 'options='=>'int'], 'DOMDocument::loadXML' => ['bool', 'source'=>'string', 'options='=>'int'], 'DOMDocument::normalizeDocument' => ['void'], 'DOMDocument::registerNodeClass' => ['bool', 'baseclass'=>'string', 'extendedclass'=>'string'], 'DOMDocument::relaxNGValidate' => ['bool', 'filename'=>'string'], 'DOMDocument::relaxNGValidateSource' => ['bool', 'source'=>'string'], 'DOMDocument::save' => ['int|false', 'filename'=>'string', 'options='=>'int'], 'DOMDocument::saveHTML' => ['string|false', 'node='=>'?DOMNode'], 'DOMDocument::saveHTMLFile' => ['int|false', 'filename'=>'string'], 'DOMDocument::saveXML' => ['string|false', 'node='=>'?DOMNode', 'options='=>'int'], 'DOMDocument::schemaValidate' => ['bool', 'filename'=>'string', 'flags='=>'int'], 'DOMDocument::schemaValidateSource' => ['bool', 'source'=>'string', 'flags='=>'int'], 'DOMDocument::validate' => ['bool'], 'DOMDocument::xinclude' => ['int', 'options='=>'int'], 'DOMDocumentFragment::__construct' => ['void'], 'DOMDocumentFragment::appendXML' => ['bool', 'data'=>'string'], 'DomDocumentType::entities' => ['array'], 'DomDocumentType::internal_subset' => ['bool'], 'DomDocumentType::name' => ['string'], 'DomDocumentType::notations' => ['array'], 'DomDocumentType::public_id' => ['string'], 'DomDocumentType::system_id' => ['string'], 'DOMElement::__construct' => ['void', 'name'=>'string', 'value='=>'string', 'uri='=>'string'], 'DOMElement::get_attribute' => ['string', 'name'=>'string'], 'DOMElement::get_attribute_node' => ['DomAttribute', 'name'=>'string'], 'DOMElement::get_elements_by_tagname' => ['array', 'name'=>'string'], 'DOMElement::getAttribute' => ['string', 'name'=>'string'], 'DOMElement::getAttributeNode' => ['DOMAttr', 'name'=>'string'], 'DOMElement::getAttributeNodeNS' => ['DOMAttr', 'namespaceuri'=>'string', 'localname'=>'string'], 'DOMElement::getAttributeNS' => ['string', 'namespaceuri'=>'string', 'localname'=>'string'], 'DOMElement::getElementsByTagName' => ['DOMNodeList', 'name'=>'string'], 'DOMElement::getElementsByTagNameNS' => ['DOMNodeList', 'namespaceuri'=>'string', 'localname'=>'string'], 'DOMElement::has_attribute' => ['bool', 'name'=>'string'], 'DOMElement::hasAttribute' => ['bool', 'name'=>'string'], 'DOMElement::hasAttributeNS' => ['bool', 'namespaceuri'=>'string', 'localname'=>'string'], 'DOMElement::remove_attribute' => ['bool', 'name'=>'string'], 'DOMElement::removeAttribute' => ['bool', 'name'=>'string'], 'DOMElement::removeAttributeNode' => ['bool', 'oldnode'=>'DOMAttr'], 'DOMElement::removeAttributeNS' => ['bool', 'namespaceuri'=>'string', 'localname'=>'string'], 'DOMElement::set_attribute' => ['DomAttribute', 'name'=>'string', 'value'=>'string'], 'DOMElement::set_attribute_node' => ['DomNode', 'attr'=>'DOMNode'], 'DOMElement::setAttribute' => ['DOMAttr', 'name'=>'string', 'value'=>'string'], 'DOMElement::setAttributeNode' => ['DOMAttr', 'attr'=>'DOMAttr'], 'DOMElement::setAttributeNodeNS' => ['DOMAttr', 'attr'=>'DOMAttr'], 'DOMElement::setAttributeNS' => ['void', 'namespaceuri'=>'string', 'qualifiedname'=>'string', 'value'=>'string'], 'DOMElement::setIdAttribute' => ['void', 'name'=>'string', 'isid'=>'bool'], 'DOMElement::setIdAttributeNode' => ['void', 'attr'=>'DOMAttr', 'isid'=>'bool'], 'DOMElement::setIdAttributeNS' => ['void', 'namespaceuri'=>'string', 'localname'=>'string', 'isid'=>'bool'], 'DOMElement::tagname' => ['string'], 'DOMEntityReference::__construct' => ['void', 'name'=>'string'], 'DOMImplementation::__construct' => ['void'], 'DOMImplementation::createDocument' => ['DOMDocument', 'namespaceuri='=>'string', 'qualifiedname='=>'string', 'doctype='=>'DOMDocumentType'], 'DOMImplementation::createDocumentType' => ['DOMDocumentType', 'qualifiedname='=>'string', 'publicid='=>'string', 'systemid='=>'string'], 'DOMImplementation::hasFeature' => ['bool', 'feature'=>'string', 'version'=>'string'], 'DOMNamedNodeMap::count' => ['0|positive-int'], 'DOMNamedNodeMap::getNamedItem' => ['?DOMNode', 'name'=>'string'], 'DOMNamedNodeMap::getNamedItemNS' => ['?DOMNode', 'namespaceuri'=>'string', 'localname'=>'string'], 'DOMNamedNodeMap::item' => ['?DOMNode', 'index'=>'int'], 'DomNode::add_namespace' => ['bool', 'uri'=>'string', 'prefix'=>'string'], 'DomNode::append_child' => ['DOMNode', 'newnode'=>'DOMNode'], 'DOMNode::appendChild' => ['DOMNode', 'newnode'=>'DOMNode'], 'DOMNode::C14N' => ['string', 'exclusive='=>'bool', 'with_comments='=>'bool', 'xpath='=>'array', 'ns_prefixes='=>'array'], 'DOMNode::C14NFile' => ['int', 'uri='=>'string', 'exclusive='=>'bool', 'with_comments='=>'bool', 'xpath='=>'array', 'ns_prefixes='=>'array'], 'DOMNode::cloneNode' => ['DOMNode', 'deep='=>'bool'], 'DOMNode::getLineNo' => ['int'], 'DOMNode::getNodePath' => ['?string'], 'DOMNode::hasAttributes' => ['bool'], 'DOMNode::hasChildNodes' => ['bool'], 'DOMNode::insertBefore' => ['DOMNode', 'newnode'=>'DOMNode', 'refnode='=>'DOMNode'], 'DOMNode::isDefaultNamespace' => ['bool', 'namespaceuri'=>'string'], 'DOMNode::isSameNode' => ['bool', 'node'=>'DOMNode'], 'DOMNode::isSupported' => ['bool', 'feature'=>'string', 'version'=>'string'], 'DOMNode::lookupNamespaceURI' => ['?string', 'prefix'=>'?string'], 'DOMNode::lookupPrefix' => ['string', 'namespaceuri'=>'string'], 'DOMNode::normalize' => ['void'], 'DOMNode::removeChild' => ['DOMNode', 'oldnode'=>'DOMNode'], 'DOMNode::replaceChild' => ['DOMNode', 'newnode'=>'DOMNode', 'oldnode'=>'DOMNode'], 'DOMNodeList::count' => ['0|positive-int'], 'DOMNodeList::item' => ['?DOMNode', 'index'=>'int'], 'DOMProcessingInstruction::__construct' => ['void', 'name'=>'string', 'value'=>'string'], 'DomProcessingInstruction::data' => ['string'], 'DomProcessingInstruction::target' => ['string'], 'DOMText::__construct' => ['void', 'value='=>'string'], 'DOMText::isElementContentWhitespace' => ['bool'], 'DOMText::isWhitespaceInElementContent' => ['bool'], 'DOMText::splitText' => ['DOMText|false', 'offset'=>'int'], 'domxml_new_doc' => ['DomDocument', 'version'=>'string'], 'domxml_open_file' => ['DomDocument', 'filename'=>'string', 'mode='=>'int', 'error='=>'array'], 'domxml_open_mem' => ['DomDocument', 'str'=>'string', 'mode='=>'int', 'error='=>'array'], 'domxml_version' => ['string'], 'domxml_xmltree' => ['DomDocument', 'str'=>'string'], 'domxml_xslt_stylesheet' => ['DomXsltStylesheet', 'xsl_buf'=>'string'], 'domxml_xslt_stylesheet_doc' => ['DomXsltStylesheet', 'xsl_doc'=>'DOMDocument'], 'domxml_xslt_stylesheet_file' => ['DomXsltStylesheet', 'xsl_file'=>'string'], 'domxml_xslt_version' => ['int'], 'DOMXPath::__construct' => ['void', 'doc'=>'DOMDocument'], 'DOMXPath::evaluate' => ['mixed', 'expression'=>'string', 'contextnode='=>'?DOMNode', 'registernodens='=>'bool'], 'DOMXPath::query' => ['DOMNodeList|false', 'expression'=>'string', 'contextnode='=>'?DOMNode', 'registernodens='=>'bool'], 'DOMXPath::registerNamespace' => ['bool', 'prefix'=>'string', 'namespaceuri'=>'string'], 'DOMXPath::registerPhpFunctions' => ['void', 'restrict='=>'mixed'], 'DomXsltStylesheet::process' => ['DomDocument', 'xml_doc'=>'DOMDocument', 'xslt_params='=>'array', 'is_xpath_param='=>'bool', 'profile_filename='=>'string'], 'DomXsltStylesheet::result_dump_file' => ['string', 'xmldoc'=>'DOMDocument', 'filename'=>'string'], 'DomXsltStylesheet::result_dump_mem' => ['string', 'xmldoc'=>'DOMDocument'], 'DOTNET::__construct' => ['void', 'assembly_name'=>'string', 'class_name'=>'string', 'codepage='=>'int'], 'dotnet_load' => ['int', 'assembly_name'=>'string', 'datatype_name='=>'string', 'codepage='=>'int'], 'doubleval' => ['float', 'var'=>'scalar|array|resource|null'], 'Ds\Collection::clear' => ['void'], 'Ds\Collection::copy' => ['Ds\Collection'], 'Ds\Collection::isEmpty' => ['bool'], 'Ds\Collection::toArray' => ['array'], 'Ds\Deque::__construct' => ['void', 'values='=>'mixed'], 'Ds\Deque::allocate' => ['void', 'capacity'=>'int'], 'Ds\Deque::apply' => ['void', 'callback'=>'callable'], 'Ds\Deque::capacity' => ['int'], 'Ds\Deque::clear' => ['void'], 'Ds\Deque::contains' => ['bool', '...values='=>'mixed'], 'Ds\Deque::copy' => ['Ds\Deque'], 'Ds\Deque::count' => ['0|positive-int'], 'Ds\Deque::filter' => ['Ds\Deque', 'callback='=>'callable'], 'Ds\Deque::find' => ['mixed', 'value'=>'mixed'], 'Ds\Deque::first' => ['mixed'], 'Ds\Deque::get' => ['void', 'index'=>'int'], 'Ds\Deque::insert' => ['void', 'index'=>'int', '...values='=>'mixed'], 'Ds\Deque::isEmpty' => ['bool'], 'Ds\Deque::join' => ['string', 'glue='=>'string'], 'Ds\Deque::jsonSerialize' => ['array'], 'Ds\Deque::last' => ['mixed'], 'Ds\Deque::map' => ['Ds\Deque', 'callback'=>'callable'], 'Ds\Deque::merge' => ['Ds\Deque', 'values'=>'mixed'], 'Ds\Deque::pop' => ['mixed'], 'Ds\Deque::push' => ['void', '...values='=>'mixed'], 'Ds\Deque::reduce' => ['mixed', 'callback'=>'callable', 'initial='=>'mixed'], 'Ds\Deque::remove' => ['mixed', 'index'=>'int'], 'Ds\Deque::reverse' => ['void'], 'Ds\Deque::reversed' => ['Ds\Deque'], 'Ds\Deque::rotate' => ['void', 'rotations'=>'int'], 'Ds\Deque::set' => ['void', 'index'=>'int', 'value'=>'mixed'], 'Ds\Deque::shift' => ['mixed'], 'Ds\Deque::slice' => ['Ds\Deque', 'index'=>'int', 'length='=>'?int'], 'Ds\Deque::sort' => ['void', 'comparator='=>'callable'], 'Ds\Deque::sorted' => ['Ds\Deque', 'comparator='=>'callable'], 'Ds\Deque::sum' => ['int|float'], 'Ds\Deque::toArray' => ['array'], 'Ds\Deque::unshift' => ['void', '...values='=>'mixed'], 'Ds\Hashable::equals' => ['bool', 'obj'=>'mixed'], 'Ds\Hashable::hash' => ['mixed'], 'Ds\Map::__construct' => ['void', 'values='=>'mixed'], 'Ds\Map::allocate' => ['void', 'capacity'=>'int'], 'Ds\Map::apply' => ['void', 'callback'=>'callable'], 'Ds\Map::capacity' => ['int'], 'Ds\Map::clear' => ['void'], 'Ds\Map::copy' => ['Ds\Map'], 'Ds\Map::count' => ['0|positive-int'], 'Ds\Map::diff' => ['Ds\Map', 'map'=>'Ds\Map'], 'Ds\Map::filter' => ['Ds\Map', 'callback='=>'callable'], 'Ds\Map::first' => ['Ds\Pair'], 'Ds\Map::get' => ['mixed', 'key'=>'mixed', 'default='=>'mixed'], 'Ds\Map::hasKey' => ['bool', 'key'=>'mixed'], 'Ds\Map::hasValue' => ['bool', 'value'=>'mixed'], 'Ds\Map::intersect' => ['Ds\Map', 'map'=>'Ds\Map'], 'Ds\Map::isEmpty' => ['bool'], 'Ds\Map::jsonSerialize' => ['array'], 'Ds\Map::keys' => ['Ds\Set'], 'Ds\Map::ksort' => ['void', 'comparator='=>'callable'], 'Ds\Map::ksorted' => ['Ds\Map', 'comparator='=>'callable'], 'Ds\Map::last' => ['Ds\Pair'], 'Ds\Map::map' => ['Ds\Map', 'callback'=>'callable'], 'Ds\Map::merge' => ['Ds\Map', 'values'=>'mixed'], 'Ds\Map::pairs' => ['Ds\Sequence'], 'Ds\Map::put' => ['void', 'key'=>'mixed', 'value'=>'mixed'], 'Ds\Map::putAll' => ['void', 'values'=>'mixed'], 'Ds\Map::reduce' => ['mixed', 'callback'=>'callable', 'initial='=>'mixed'], 'Ds\Map::remove' => ['mixed', 'key'=>'mixed', 'default='=>'mixed'], 'Ds\Map::reverse' => ['void'], 'Ds\Map::reversed' => ['Ds\Map'], 'Ds\Map::skip' => ['Ds\Pair', 'position'=>'int'], 'Ds\Map::slice' => ['Ds\Map', 'index'=>'int', 'length='=>'?int'], 'Ds\Map::sort' => ['void', 'comparator='=>'callable'], 'Ds\Map::sorted' => ['Ds\Map', 'comparator='=>'callable'], 'Ds\Map::sum' => ['int|float'], 'Ds\Map::toArray' => ['array'], 'Ds\Map::union' => ['Ds\Map', 'map'=>'Ds\Map'], 'Ds\Map::values' => ['Ds\Sequence'], 'Ds\Map::xor' => ['Ds\Map', 'map'=>'Ds\Map'], 'Ds\Pair::__construct' => ['void', 'key='=>'mixed', 'value='=>'mixed'], 'Ds\Pair::copy' => ['Ds\Pair'], 'Ds\Pair::jsonSerialize' => ['array'], 'Ds\Pair::toArray' => ['array'], 'Ds\PriorityQueue::__construct' => ['void'], 'Ds\PriorityQueue::allocate' => ['void', 'capacity'=>'int'], 'Ds\PriorityQueue::capacity' => ['int'], 'Ds\PriorityQueue::clear' => ['void'], 'Ds\PriorityQueue::copy' => ['Ds\PriorityQueue'], 'Ds\PriorityQueue::count' => ['0|positive-int'], 'Ds\PriorityQueue::isEmpty' => ['bool'], 'Ds\PriorityQueue::jsonSerialize' => ['array'], 'Ds\PriorityQueue::peek' => ['mixed'], 'Ds\PriorityQueue::pop' => ['mixed'], 'Ds\PriorityQueue::push' => ['void', 'value'=>'mixed', 'priority'=>'int'], 'Ds\PriorityQueue::toArray' => ['array'], 'Ds\Queue::__construct' => ['void', 'values='=>'mixed'], 'Ds\Queue::allocate' => ['void', 'capacity'=>'int'], 'Ds\Queue::capacity' => ['int'], 'Ds\Queue::clear' => ['void'], 'Ds\Queue::copy' => ['Ds\Queue'], 'Ds\Queue::count' => ['0|positive-int'], 'Ds\Queue::isEmpty' => ['bool'], 'Ds\Queue::jsonSerialize' => ['array'], 'Ds\Queue::peek' => ['mixed'], 'Ds\Queue::pop' => ['mixed'], 'Ds\Queue::push' => ['void', '...values='=>'mixed'], 'Ds\Queue::toArray' => ['array'], 'Ds\Sequence::allocate' => ['void', 'capacity'=>'int'], 'Ds\Sequence::apply' => ['void', 'callback'=>'callable'], 'Ds\Sequence::capacity' => ['int'], 'Ds\Sequence::contains' => ['bool', '...values='=>'mixed'], 'Ds\Sequence::filter' => ['Ds\Sequence', 'callback='=>'callable'], 'Ds\Sequence::find' => ['mixed', 'value'=>'mixed'], 'Ds\Sequence::first' => ['mixed'], 'Ds\Sequence::get' => ['mixed', 'index'=>'int'], 'Ds\Sequence::insert' => ['void', 'index'=>'int', '...values='=>'mixed'], 'Ds\Sequence::join' => ['string', 'glue='=>'string'], 'Ds\Sequence::last' => ['void'], 'Ds\Sequence::map' => ['Ds\Sequence', 'callback'=>'callable'], 'Ds\Sequence::merge' => ['Ds\Sequence', 'values'=>'mixed'], 'Ds\Sequence::pop' => ['mixed'], 'Ds\Sequence::push' => ['void', '...values='=>'mixed'], 'Ds\Sequence::reduce' => ['mixed', 'callback'=>'callable', 'initial='=>'mixed'], 'Ds\Sequence::remove' => ['mixed', 'index'=>'int'], 'Ds\Sequence::reverse' => ['void'], 'Ds\Sequence::reversed' => ['Ds\Sequence'], 'Ds\Sequence::rotate' => ['void', 'rotations'=>'int'], 'Ds\Sequence::set' => ['void', 'index'=>'int', 'value'=>'mixed'], 'Ds\Sequence::shift' => ['mixed'], 'Ds\Sequence::slice' => ['Ds\Sequence', 'index'=>'int', 'length='=>'?int'], 'Ds\Sequence::sort' => ['void', 'comparator='=>'callable'], 'Ds\Sequence::sorted' => ['Ds\Sequence', 'comparator='=>'callable'], 'Ds\Sequence::sum' => ['int|float'], 'Ds\Sequence::unshift' => ['void', '...values='=>'mixed'], 'Ds\Set::__construct' => ['void', 'values='=>'mixed'], 'Ds\Set::add' => ['void', '...values='=>'mixed'], 'Ds\Set::allocate' => ['void', 'capacity'=>'int'], 'Ds\Set::capacity' => ['int'], 'Ds\Set::clear' => ['void'], 'Ds\Set::contains' => ['bool', '...values='=>'mixed'], 'Ds\Set::copy' => ['Ds\Set'], 'Ds\Set::count' => ['0|positive-int'], 'Ds\Set::diff' => ['Ds\Set', 'set'=>'Ds\Set'], 'Ds\Set::filter' => ['Ds\Set', 'callback='=>'callable'], 'Ds\Set::first' => ['mixed'], 'Ds\Set::get' => ['mixed', 'index'=>'int'], 'Ds\Set::intersect' => ['Ds\Set', 'set'=>'Ds\Set'], 'Ds\Set::isEmpty' => ['bool'], 'Ds\Set::join' => ['string', 'glue='=>'string'], 'Ds\Set::jsonSerialize' => ['array'], 'Ds\Set::last' => ['mixed'], 'Ds\Set::map' => ['Ds\Set', 'callback='=>'callable'], 'Ds\Set::merge' => ['Ds\Set', 'values'=>'mixed'], 'Ds\Set::reduce' => ['mixed', 'callback'=>'callable', 'initial='=>'mixed'], 'Ds\Set::remove' => ['void', '...values='=>'mixed'], 'Ds\Set::reverse' => ['void'], 'Ds\Set::reversed' => ['Ds\Set'], 'Ds\Set::slice' => ['Ds\Set', 'index'=>'int', 'length='=>'?int'], 'Ds\Set::sort' => ['void', 'comparator='=>'callable'], 'Ds\Set::sorted' => ['Ds\Set', 'comparator='=>'callable'], 'Ds\Set::sum' => ['int|float'], 'Ds\Set::toArray' => ['array'], 'Ds\Set::union' => ['Ds\Set', 'set'=>'Ds\Set'], 'Ds\Set::xor' => ['Ds\Set', 'set'=>'Ds\Set'], 'Ds\Stack::__construct' => ['void', 'values='=>'mixed'], 'Ds\Stack::allocate' => ['void', 'capacity'=>'int'], 'Ds\Stack::capacity' => ['int'], 'Ds\Stack::clear' => ['void'], 'Ds\Stack::copy' => ['Ds\Stack'], 'Ds\Stack::count' => ['0|positive-int'], 'Ds\Stack::isEmpty' => ['bool'], 'Ds\Stack::jsonSerialize' => ['array'], 'Ds\Stack::peek' => ['mixed'], 'Ds\Stack::pop' => ['mixed'], 'Ds\Stack::push' => ['void', '...values='=>'mixed'], 'Ds\Stack::toArray' => ['array'], 'Ds\Vector::__construct' => ['void', 'values='=>'mixed'], 'Ds\Vector::allocate' => ['void', 'capacity'=>'int'], 'Ds\Vector::apply' => ['void', 'callback'=>'callable'], 'Ds\Vector::capacity' => ['int'], 'Ds\Vector::clear' => ['void'], 'Ds\Vector::contains' => ['bool', '...values='=>'mixed'], 'Ds\Vector::copy' => ['Ds\Vector'], 'Ds\Vector::count' => ['0|positive-int'], 'Ds\Vector::filter' => ['Ds\Vector', 'callback='=>'callable'], 'Ds\Vector::find' => ['mixed', 'value'=>'mixed'], 'Ds\Vector::first' => ['mixed'], 'Ds\Vector::get' => ['mixed', 'index'=>'int'], 'Ds\Vector::insert' => ['void', 'index'=>'int', '...values='=>'mixed'], 'Ds\Vector::isEmpty' => ['bool'], 'Ds\Vector::join' => ['string', 'glue='=>'string'], 'Ds\Vector::jsonSerialize' => ['array'], 'Ds\Vector::last' => ['mixed'], 'Ds\Vector::map' => ['Ds\Vector', 'callback'=>'callable'], 'Ds\Vector::merge' => ['Ds\Vector', 'values'=>'mixed'], 'Ds\Vector::pop' => ['mixed'], 'Ds\Vector::push' => ['void', '...values='=>'mixed'], 'Ds\Vector::reduce' => ['mixed', 'callback'=>'callable', 'initial='=>'mixed'], 'Ds\Vector::remove' => ['mixed', 'index'=>'int'], 'Ds\Vector::reverse' => ['void'], 'Ds\Vector::reversed' => ['Ds\Vector'], 'Ds\Vector::rotate' => ['void', 'rotations'=>'int'], 'Ds\Vector::set' => ['void', 'index'=>'int', 'value'=>'mixed'], 'Ds\Vector::shift' => ['mixed'], 'Ds\Vector::slice' => ['Ds\Vector', 'index'=>'int', 'length='=>'?int'], 'Ds\Vector::sort' => ['void', 'comparator='=>'callable'], 'Ds\Vector::sorted' => ['Ds\Vector', 'comparator='=>'callable'], 'Ds\Vector::sum' => ['int|float'], 'Ds\Vector::toArray' => ['array'], 'Ds\Vector::unshift' => ['void', '...values='=>'mixed'], 'each' => ['array', '&rw_arr'=>'array'], 'easter_date' => ['int', 'year='=>'int'], 'easter_days' => ['int', 'year='=>'int', 'method='=>'int'], 'eio_busy' => ['resource', 'delay'=>'int', 'pri='=>'int', 'callback='=>'callable', 'data='=>'mixed'], 'eio_cancel' => ['void', 'req'=>'resource'], 'eio_chmod' => ['resource', 'path'=>'string', 'mode'=>'int', 'pri='=>'int', 'callback='=>'callable', 'data='=>'mixed'], 'eio_chown' => ['resource', 'path'=>'string', 'uid'=>'int', 'gid='=>'int', 'pri='=>'int', 'callback='=>'callable', 'data='=>'mixed'], 'eio_close' => ['resource', 'fd'=>'mixed', 'pri='=>'int', 'callback='=>'callable', 'data='=>'mixed'], 'eio_custom' => ['resource', 'execute'=>'callable', 'pri'=>'int', 'callback'=>'callable', 'data='=>'mixed'], 'eio_dup2' => ['resource', 'fd'=>'mixed', 'fd2'=>'mixed', 'pri='=>'int', 'callback='=>'callable', 'data='=>'mixed'], 'eio_event_loop' => ['bool'], 'eio_fallocate' => ['resource', 'fd'=>'mixed', 'mode'=>'int', 'offset'=>'int', 'length'=>'int', 'pri='=>'int', 'callback='=>'callable', 'data='=>'mixed'], 'eio_fchmod' => ['resource', 'fd'=>'mixed', 'mode'=>'int', 'pri='=>'int', 'callback='=>'callable', 'data='=>'mixed'], 'eio_fchown' => ['resource', 'fd'=>'mixed', 'uid'=>'int', 'gid='=>'int', 'pri='=>'int', 'callback='=>'callable', 'data='=>'mixed'], 'eio_fdatasync' => ['resource', 'fd'=>'mixed', 'pri='=>'int', 'callback='=>'callable', 'data='=>'mixed'], 'eio_fstat' => ['resource', 'fd'=>'mixed', 'pri'=>'int', 'callback'=>'callable', 'data='=>'mixed'], 'eio_fstatvfs' => ['resource', 'fd'=>'mixed', 'pri'=>'int', 'callback'=>'callable', 'data='=>'mixed'], 'eio_fsync' => ['resource', 'fd'=>'mixed', 'pri='=>'int', 'callback='=>'callable', 'data='=>'mixed'], 'eio_ftruncate' => ['resource', 'fd'=>'mixed', 'offset='=>'int', 'pri='=>'int', 'callback='=>'callable', 'data='=>'mixed'], 'eio_futime' => ['resource', 'fd'=>'mixed', 'atime'=>'float', 'mtime'=>'float', 'pri='=>'int', 'callback='=>'callable', 'data='=>'mixed'], 'eio_get_event_stream' => ['mixed'], 'eio_get_last_error' => ['string', 'req'=>'resource'], 'eio_grp' => ['resource', 'callback'=>'callable', 'data='=>'string'], 'eio_grp_add' => ['void', 'grp'=>'resource', 'req'=>'resource'], 'eio_grp_cancel' => ['void', 'grp'=>'resource'], 'eio_grp_limit' => ['void', 'grp'=>'resource', 'limit'=>'int'], 'eio_init' => ['void'], 'eio_link' => ['resource', 'path'=>'string', 'new_path'=>'string', 'pri='=>'int', 'callback='=>'callable', 'data='=>'mixed'], 'eio_lstat' => ['resource', 'path'=>'string', 'pri'=>'int', 'callback'=>'callable', 'data='=>'mixed'], 'eio_mkdir' => ['resource', 'path'=>'string', 'mode'=>'int', 'pri='=>'int', 'callback='=>'callable', 'data='=>'mixed'], 'eio_mknod' => ['resource', 'path'=>'string', 'mode'=>'int', 'dev'=>'int', 'pri='=>'int', 'callback='=>'callable', 'data='=>'mixed'], 'eio_nop' => ['resource', 'pri='=>'int', 'callback='=>'callable', 'data='=>'mixed'], 'eio_npending' => ['int'], 'eio_nready' => ['int'], 'eio_nreqs' => ['int'], 'eio_nthreads' => ['int'], 'eio_open' => ['resource', 'path'=>'string', 'flags'=>'int', 'mode'=>'int', 'pri'=>'int', 'callback'=>'callable', 'data='=>'mixed'], 'eio_poll' => ['int'], 'eio_read' => ['resource', 'fd'=>'mixed', 'length'=>'int', 'offset'=>'int', 'pri'=>'int', 'callback'=>'callable', 'data='=>'mixed'], 'eio_readahead' => ['resource', 'fd'=>'mixed', 'offset'=>'int', 'length'=>'int', 'pri='=>'int', 'callback='=>'callable', 'data='=>'mixed'], 'eio_readdir' => ['resource', 'path'=>'string', 'flags'=>'int', 'pri'=>'int', 'callback'=>'callable', 'data='=>'string'], 'eio_readlink' => ['resource', 'path'=>'string', 'pri'=>'int', 'callback'=>'callable', 'data='=>'string'], 'eio_realpath' => ['resource', 'path'=>'string', 'pri'=>'int', 'callback'=>'callable', 'data='=>'string'], 'eio_rename' => ['resource', 'path'=>'string', 'new_path'=>'string', 'pri='=>'int', 'callback='=>'callable', 'data='=>'mixed'], 'eio_rmdir' => ['resource', 'path'=>'string', 'pri='=>'int', 'callback='=>'callable', 'data='=>'mixed'], 'eio_seek' => ['resource', 'fd'=>'mixed', 'offset'=>'int', 'whence'=>'int', 'pri='=>'int', 'callback='=>'callable', 'data='=>'mixed'], 'eio_sendfile' => ['resource', 'out_fd'=>'mixed', 'in_fd'=>'mixed', 'offset'=>'int', 'length'=>'int', 'pri='=>'int', 'callback='=>'callable', 'data='=>'string'], 'eio_set_max_idle' => ['void', 'nthreads'=>'int'], 'eio_set_max_parallel' => ['void', 'nthreads'=>'int'], 'eio_set_max_poll_reqs' => ['void', 'nreqs'=>'int'], 'eio_set_max_poll_time' => ['void', 'nseconds'=>'float'], 'eio_set_min_parallel' => ['void', 'nthreads'=>'string'], 'eio_stat' => ['resource', 'path'=>'string', 'pri'=>'int', 'callback'=>'callable', 'data='=>'mixed'], 'eio_statvfs' => ['resource', 'path'=>'string', 'pri'=>'int', 'callback'=>'callable', 'data='=>'mixed'], 'eio_symlink' => ['resource', 'path'=>'string', 'new_path'=>'string', 'pri='=>'int', 'callback='=>'callable', 'data='=>'mixed'], 'eio_sync' => ['resource', 'pri='=>'int', 'callback='=>'callable', 'data='=>'mixed'], 'eio_sync_file_range' => ['resource', 'fd'=>'mixed', 'offset'=>'int', 'nbytes'=>'int', 'flags'=>'int', 'pri='=>'int', 'callback='=>'callable', 'data='=>'mixed'], 'eio_syncfs' => ['resource', 'fd'=>'mixed', 'pri='=>'int', 'callback='=>'callable', 'data='=>'mixed'], 'eio_truncate' => ['resource', 'path'=>'string', 'offset='=>'int', 'pri='=>'int', 'callback='=>'callable', 'data='=>'mixed'], 'eio_unlink' => ['resource', 'path'=>'string', 'pri='=>'int', 'callback='=>'callable', 'data='=>'mixed'], 'eio_utime' => ['resource', 'path'=>'string', 'atime'=>'float', 'mtime'=>'float', 'pri='=>'int', 'callback='=>'callable', 'data='=>'mixed'], 'eio_write' => ['resource', 'fd'=>'mixed', 'str'=>'string', 'length='=>'int', 'offset='=>'int', 'pri='=>'int', 'callback='=>'callable', 'data='=>'mixed'], 'EmptyIterator::current' => ['mixed'], 'EmptyIterator::key' => ['mixed'], 'EmptyIterator::next' => ['void'], 'EmptyIterator::rewind' => ['void'], 'EmptyIterator::valid' => ['bool'], 'enchant_broker_describe' => ['array', 'broker'=>'resource'], 'enchant_broker_dict_exists' => ['bool', 'broker'=>'resource', 'tag'=>'string'], 'enchant_broker_free' => ['bool', 'broker'=>'resource'], 'enchant_broker_free_dict' => ['bool', 'dict'=>'resource'], 'enchant_broker_get_dict_path' => ['string|false', 'broker'=>'resource', 'dict_type'=>'int'], 'enchant_broker_get_error' => ['string|false', 'broker'=>'resource'], 'enchant_broker_init' => ['resource|false'], 'enchant_broker_list_dicts' => ['array<int,array{lang_tag:string,provider_name:string,provider_desc:string,provider_file:string}>|false', 'broker'=>'resource'], 'enchant_broker_request_dict' => ['resource|false', 'broker'=>'resource', 'tag'=>'string'], 'enchant_broker_request_pwl_dict' => ['resource|false', 'broker'=>'resource', 'filename'=>'string'], 'enchant_broker_set_dict_path' => ['bool', 'broker'=>'resource', 'dict_type'=>'int', 'value'=>'string'], 'enchant_broker_set_ordering' => ['bool', 'broker'=>'resource', 'tag'=>'string', 'ordering'=>'string'], 'enchant_dict_add_to_personal' => ['void', 'dict'=>'resource', 'word'=>'string'], 'enchant_dict_add_to_session' => ['void', 'dict'=>'resource', 'word'=>'string'], 'enchant_dict_check' => ['bool', 'dict'=>'resource', 'word'=>'string'], 'enchant_dict_describe' => ['array', 'dict'=>'resource'], 'enchant_dict_get_error' => ['string|false', 'dict'=>'resource'], 'enchant_dict_is_in_session' => ['bool', 'dict'=>'resource', 'word'=>'string'], 'enchant_dict_quick_check' => ['bool', 'dict'=>'resource', 'word'=>'string', 'suggestions='=>'array'], 'enchant_dict_store_replacement' => ['void', 'dict'=>'resource', 'mis'=>'string', 'cor'=>'string'], 'enchant_dict_suggest' => ['array', 'dict'=>'resource', 'word'=>'string'], 'end' => ['mixed', '&rw_array_arg'=>'array|object'], 'ereg' => ['int', 'pattern'=>'string', 'string'=>'string', 'regs='=>'array'], 'ereg_replace' => ['string', 'pattern'=>'string', 'replacement'=>'string', 'string'=>'string'], 'eregi' => ['int', 'pattern'=>'string', 'string'=>'string', 'regs='=>'array'], 'eregi_replace' => ['string', 'pattern'=>'string', 'replacement'=>'string', 'string'=>'string'], 'Error::__clone' => ['void'], 'Error::__construct' => ['void', 'message='=>'string', 'code='=>'int', 'previous='=>'(?Throwable)|(?Error)'], 'Error::__toString' => ['string'], 'Error::getCode' => ['int'], 'Error::getFile' => ['string'], 'Error::getLine' => ['int'], 'Error::getMessage' => ['string'], 'Error::getPrevious' => ['Throwable|Error|null'], 'Error::getTrace' => ['list<array{function:string,line?:int,file?:string,class?:class-string,type?:\'::\'|\'->\',args?:mixed[],object?:object}>'], 'Error::getTraceAsString' => ['string'], 'error_clear_last' => ['void'], 'error_get_last' => ['?array{type:int,message:string,file:string,line:int}'], 'error_log' => ['bool', 'message'=>'string', 'message_type='=>'int', 'destination='=>'string', 'extra_headers='=>'string'], 'error_reporting' => ['int', 'new_error_level='=>'int'], 'ErrorException::__clone' => ['void'], 'ErrorException::__construct' => ['void', 'message='=>'string', 'code='=>'int', 'severity='=>'int', 'filename='=>'string', 'lineno='=>'int', 'previous='=>'(?Throwable)|(?ErrorException)'], 'ErrorException::__toString' => ['string'], 'ErrorException::getCode' => ['int'], 'ErrorException::getFile' => ['string'], 'ErrorException::getLine' => ['int'], 'ErrorException::getMessage' => ['string'], 'ErrorException::getPrevious' => ['Throwable|ErrorException|null'], 'ErrorException::getSeverity' => ['int'], 'ErrorException::getTrace' => ['list<array{function:string,line?:int,file?:string,class?:class-string,type?:\'::\'|\'->\',args?:mixed[],object?:object}>'], 'ErrorException::getTraceAsString' => ['string'], 'escapeshellarg' => ['string', 'arg'=>'string'], 'escapeshellcmd' => ['string', 'command'=>'string'], 'Ev::backend' => ['int'], 'Ev::depth' => ['int'], 'Ev::embeddableBackends' => ['int'], 'Ev::feedSignal' => ['void', 'signum'=>'int'], 'Ev::feedSignalEvent' => ['void', 'signum'=>'int'], 'Ev::iteration' => ['int'], 'Ev::now' => ['float'], 'Ev::nowUpdate' => ['void'], 'Ev::recommendedBackends' => ['int'], 'Ev::resume' => ['void'], 'Ev::run' => ['void', 'flags='=>'int'], 'Ev::sleep' => ['void', 'seconds'=>'float'], 'Ev::stop' => ['void', 'how='=>'int'], 'Ev::supportedBackends' => ['int'], 'Ev::suspend' => ['void'], 'Ev::time' => ['float'], 'Ev::verify' => ['void'], 'EvCheck::__construct' => ['void', 'callback'=>'callable', 'data='=>'mixed', 'priority='=>'int'], 'EvCheck::createStopped' => ['object', 'callback'=>'string', 'data='=>'string', 'priority='=>'string'], 'EvChild::__construct' => ['void', 'pid'=>'int', 'trace'=>'bool', 'callback'=>'callable', 'data='=>'mixed', 'priority='=>'int'], 'EvChild::createStopped' => ['object', 'pid'=>'int', 'trace'=>'bool', 'callback'=>'callable', 'data='=>'mixed', 'priority='=>'int'], 'EvChild::set' => ['void', 'pid'=>'int', 'trace'=>'bool'], 'EvEmbed::__construct' => ['void', 'other'=>'object', 'callback='=>'callable', 'data='=>'mixed', 'priority='=>'int'], 'EvEmbed::createStopped' => ['void', 'other'=>'object', 'callback='=>'callable', 'data='=>'mixed', 'priority='=>'int'], 'EvEmbed::set' => ['void', 'other'=>'object'], 'EvEmbed::sweep' => ['void'], 'Event::__construct' => ['void', 'base'=>'EventBase', 'fd'=>'mixed', 'what'=>'int', 'cb'=>'callable', 'arg='=>'mixed'], 'Event::add' => ['bool', 'timeout='=>'float'], 'Event::addSignal' => ['bool', 'timeout='=>'float'], 'Event::addTimer' => ['bool', 'timeout='=>'float'], 'Event::del' => ['bool'], 'Event::delSignal' => ['bool'], 'Event::delTimer' => ['bool'], 'Event::free' => ['void'], 'Event::getSupportedMethods' => ['array'], 'Event::pending' => ['bool', 'flags'=>'int'], 'Event::set' => ['bool', 'base'=>'EventBase', 'fd'=>'mixed', 'what='=>'int', 'cb='=>'callable', 'arg='=>'mixed'], 'Event::setPriority' => ['bool', 'priority'=>'int'], 'Event::setTimer' => ['bool', 'base'=>'EventBase', 'cb'=>'callable', 'arg='=>'mixed'], 'Event::signal' => ['Event', 'base'=>'EventBase', 'signum'=>'int', 'cb'=>'callable', 'arg='=>'mixed'], 'Event::timer' => ['Event', 'base'=>'EventBase', 'cb'=>'callable', 'arg='=>'mixed'], 'event_add' => ['bool', 'event'=>'resource', 'timeout='=>'int'], 'event_base_free' => ['void', 'event_base'=>'resource'], 'event_base_loop' => ['int', 'event_base'=>'resource', 'flags='=>'int'], 'event_base_loopbreak' => ['bool', 'event_base'=>'resource'], 'event_base_loopexit' => ['bool', 'event_base'=>'resource', 'timeout='=>'int'], 'event_base_new' => ['resource'], 'event_base_priority_init' => ['bool', 'event_base'=>'resource', 'npriorities'=>'int'], 'event_base_reinit' => ['bool', 'event_base'=>'resource'], 'event_base_set' => ['bool', 'event'=>'resource', 'event_base'=>'resource'], 'event_buffer_base_set' => ['bool', 'bevent'=>'resource', 'event_base'=>'resource'], 'event_buffer_disable' => ['bool', 'bevent'=>'resource', 'events'=>'int'], 'event_buffer_enable' => ['bool', 'bevent'=>'resource', 'events'=>'int'], 'event_buffer_fd_set' => ['void', 'bevent'=>'resource', 'fd'=>'resource'], 'event_buffer_free' => ['void', 'bevent'=>'resource'], 'event_buffer_new' => ['resource', 'stream'=>'resource', 'readcb'=>'mixed', 'writecb'=>'mixed', 'errorcb'=>'mixed', 'arg='=>'mixed'], 'event_buffer_priority_set' => ['bool', 'bevent'=>'resource', 'priority'=>'int'], 'event_buffer_read' => ['string', 'bevent'=>'resource', 'data_size'=>'int'], 'event_buffer_set_callback' => ['bool', 'event'=>'resource', 'readcb'=>'mixed', 'writecb'=>'mixed', 'errorcb'=>'mixed', 'arg='=>'mixed'], 'event_buffer_timeout_set' => ['void', 'bevent'=>'resource', 'read_timeout'=>'int', 'write_timeout'=>'int'], 'event_buffer_watermark_set' => ['void', 'bevent'=>'resource', 'events'=>'int', 'lowmark'=>'int', 'highmark'=>'int'], 'event_buffer_write' => ['bool', 'bevent'=>'resource', 'data'=>'string', 'data_size='=>'int'], 'event_del' => ['bool', 'event'=>'resource'], 'event_free' => ['void', 'event'=>'resource'], 'event_new' => ['resource'], 'event_priority_set' => ['bool', 'event'=>'resource', 'priority'=>'int'], 'event_set' => ['bool', 'event'=>'resource', 'fd'=>'mixed', 'events'=>'int', 'callback'=>'mixed', 'arg='=>'mixed'], 'event_timer_add' => ['bool', 'event'=>'resource', 'timeout='=>'int'], 'event_timer_del' => ['bool', 'event'=>'resource'], 'event_timer_new' => ['bool|resource'], 'event_timer_pending' => ['bool', 'event'=>'resource', 'timeout='=>'int'], 'event_timer_set' => ['bool', 'event'=>'resource', 'callback'=>'callable', 'arg='=>'mixed'], 'EventBase::__construct' => ['void', 'cfg='=>'EventConfig'], 'EventBase::dispatch' => ['void'], 'EventBase::exit' => ['bool', 'timeout='=>'float'], 'EventBase::free' => ['void'], 'EventBase::getFeatures' => ['int'], 'EventBase::getMethod' => ['string', 'cfg='=>'EventConfig'], 'EventBase::getTimeOfDayCached' => ['float'], 'EventBase::gotExit' => ['bool'], 'EventBase::gotStop' => ['bool'], 'EventBase::loop' => ['bool', 'flags='=>'int'], 'EventBase::priorityInit' => ['bool', 'n_priorities'=>'int'], 'EventBase::reInit' => ['bool'], 'EventBase::stop' => ['bool'], 'EventBuffer::__construct' => ['void'], 'EventBuffer::add' => ['bool', 'data'=>'string'], 'EventBuffer::addBuffer' => ['bool', 'buf'=>'EventBuffer'], 'EventBuffer::appendFrom' => ['int', 'buf'=>'EventBuffer', 'len'=>'int'], 'EventBuffer::copyout' => ['int', '&w_data'=>'string', 'max_bytes'=>'int'], 'EventBuffer::drain' => ['bool', 'len'=>'int'], 'EventBuffer::enableLocking' => ['void'], 'EventBuffer::expand' => ['bool', 'len'=>'int'], 'EventBuffer::freeze' => ['bool', 'at_front'=>'bool'], 'EventBuffer::lock' => ['void'], 'EventBuffer::prepend' => ['bool', 'data'=>'string'], 'EventBuffer::prependBuffer' => ['bool', 'buf'=>'EventBuffer'], 'EventBuffer::pullup' => ['string', 'size'=>'int'], 'EventBuffer::read' => ['string', 'max_bytes'=>'int'], 'EventBuffer::readFrom' => ['int', 'fd'=>'mixed', 'howmuch'=>'int'], 'EventBuffer::readLine' => ['string', 'eol_style'=>'int'], 'EventBuffer::search' => ['mixed', 'what'=>'string', 'start='=>'int', 'end='=>'int'], 'EventBuffer::searchEol' => ['mixed', 'start='=>'int', 'eol_style='=>'int'], 'EventBuffer::substr' => ['string', 'start'=>'int', 'length='=>'int'], 'EventBuffer::unfreeze' => ['bool', 'at_front'=>'bool'], 'EventBuffer::unlock' => ['bool'], 'EventBuffer::write' => ['int', 'fd'=>'mixed', 'howmuch='=>'int'], 'EventBufferEvent::__construct' => ['void', 'base'=>'EventBase', 'socket='=>'mixed', 'options='=>'int', 'readcb='=>'callable', 'writecb='=>'callable', 'eventcb='=>'callable'], 'EventBufferEvent::close' => ['void'], 'EventBufferEvent::connect' => ['bool', 'addr'=>'string'], 'EventBufferEvent::connectHost' => ['bool', 'dns_base'=>'EventDnsBase', 'hostname'=>'string', 'port'=>'int', 'family='=>'int'], 'EventBufferEvent::createPair' => ['array', 'base'=>'EventBase', 'options='=>'int'], 'EventBufferEvent::disable' => ['bool', 'events'=>'int'], 'EventBufferEvent::enable' => ['bool', 'events'=>'int'], 'EventBufferEvent::free' => ['void'], 'EventBufferEvent::getDnsErrorString' => ['string'], 'EventBufferEvent::getEnabled' => ['int'], 'EventBufferEvent::getInput' => ['EventBuffer'], 'EventBufferEvent::getOutput' => ['EventBuffer'], 'EventBufferEvent::read' => ['string', 'size'=>'int'], 'EventBufferEvent::readBuffer' => ['bool', 'buf'=>'EventBuffer'], 'EventBufferEvent::setCallbacks' => ['void', 'readcb'=>'callable', 'writecb'=>'callable', 'eventcb'=>'callable', 'arg='=>'string'], 'EventBufferEvent::setPriority' => ['bool', 'priority'=>'int'], 'EventBufferEvent::setTimeouts' => ['bool', 'timeout_read'=>'float', 'timeout_write'=>'float'], 'EventBufferEvent::setWatermark' => ['void', 'events'=>'int', 'lowmark'=>'int', 'highmark'=>'int'], 'EventBufferEvent::sslError' => ['string'], 'EventBufferEvent::sslFilter' => ['EventBufferEvent', 'base'=>'EventBase', 'underlying'=>'EventBufferEvent', 'ctx'=>'EventSslContext', 'state'=>'int', 'options='=>'int'], 'EventBufferEvent::sslGetCipherInfo' => ['string'], 'EventBufferEvent::sslGetCipherName' => ['string'], 'EventBufferEvent::sslGetCipherVersion' => ['string'], 'EventBufferEvent::sslGetProtocol' => ['string'], 'EventBufferEvent::sslRenegotiate' => ['void'], 'EventBufferEvent::sslSocket' => ['EventBufferEvent', 'base'=>'EventBase', 'socket'=>'mixed', 'ctx'=>'EventSslContext', 'state'=>'int', 'options='=>'int'], 'EventBufferEvent::write' => ['bool', 'data'=>'string'], 'EventBufferEvent::writeBuffer' => ['bool', 'buf'=>'EventBuffer'], 'EventConfig::__construct' => ['void'], 'EventConfig::avoidMethod' => ['bool', 'method'=>'string'], 'EventConfig::requireFeatures' => ['bool', 'feature'=>'int'], 'EventConfig::setMaxDispatchInterval' => ['void', 'max_interval'=>'int', 'max_callbacks'=>'int', 'min_priority'=>'int'], 'EventDnsBase::__construct' => ['void', 'base'=>'EventBase', 'initialize'=>'bool'], 'EventDnsBase::addNameserverIp' => ['bool', 'ip'=>'string'], 'EventDnsBase::addSearch' => ['void', 'domain'=>'string'], 'EventDnsBase::clearSearch' => ['void'], 'EventDnsBase::countNameservers' => ['int'], 'EventDnsBase::loadHosts' => ['bool', 'hosts'=>'string'], 'EventDnsBase::parseResolvConf' => ['bool', 'flags'=>'int', 'filename'=>'string'], 'EventDnsBase::setOption' => ['bool', 'option'=>'string', 'value'=>'string'], 'EventDnsBase::setSearchNdots' => ['bool', 'ndots'=>'int'], 'EventHttp::__construct' => ['void', 'base'=>'EventBase', 'ctx='=>'EventSslContext'], 'EventHttp::accept' => ['bool', 'socket'=>'mixed'], 'EventHttp::addServerAlias' => ['bool', 'alias'=>'string'], 'EventHttp::bind' => ['void', 'address'=>'string', 'port'=>'int'], 'EventHttp::removeServerAlias' => ['bool', 'alias'=>'string'], 'EventHttp::setAllowedMethods' => ['void', 'methods'=>'int'], 'EventHttp::setCallback' => ['void', 'path'=>'string', 'cb'=>'string', 'arg='=>'string'], 'EventHttp::setDefaultCallback' => ['void', 'cb'=>'string', 'arg='=>'string'], 'EventHttp::setMaxBodySize' => ['void', 'value'=>'int'], 'EventHttp::setMaxHeadersSize' => ['void', 'value'=>'int'], 'EventHttp::setTimeout' => ['void', 'value'=>'int'], 'EventHttpConnection::__construct' => ['void', 'base'=>'EventBase', 'dns_base'=>'EventDnsBase', 'address'=>'string', 'port'=>'int', 'ctx='=>'EventSslContext'], 'EventHttpConnection::getBase' => ['EventBase'], 'EventHttpConnection::getPeer' => ['void', '&w_address'=>'string', '&w_port'=>'int'], 'EventHttpConnection::makeRequest' => ['bool', 'req'=>'EventHttpRequest', 'type'=>'int', 'uri'=>'string'], 'EventHttpConnection::setCloseCallback' => ['void', 'callback'=>'callable', 'data='=>'mixed'], 'EventHttpConnection::setLocalAddress' => ['void', 'address'=>'string'], 'EventHttpConnection::setLocalPort' => ['void', 'port'=>'int'], 'EventHttpConnection::setMaxBodySize' => ['void', 'max_size'=>'string'], 'EventHttpConnection::setMaxHeadersSize' => ['void', 'max_size'=>'string'], 'EventHttpConnection::setRetries' => ['void', 'retries'=>'int'], 'EventHttpConnection::setTimeout' => ['void', 'timeout'=>'int'], 'EventHttpRequest::__construct' => ['void', 'callback'=>'callable', 'data='=>'mixed'], 'EventHttpRequest::addHeader' => ['bool', 'key'=>'string', 'value'=>'string', 'type'=>'int'], 'EventHttpRequest::cancel' => ['void'], 'EventHttpRequest::clearHeaders' => ['void'], 'EventHttpRequest::closeConnection' => ['void'], 'EventHttpRequest::findHeader' => ['void', 'key'=>'string', 'type'=>'string'], 'EventHttpRequest::free' => ['void'], 'EventHttpRequest::getBufferEvent' => ['EventBufferEvent'], 'EventHttpRequest::getCommand' => ['void'], 'EventHttpRequest::getConnection' => ['EventHttpConnection'], 'EventHttpRequest::getHost' => ['string'], 'EventHttpRequest::getInputBuffer' => ['EventBuffer'], 'EventHttpRequest::getInputHeaders' => ['array'], 'EventHttpRequest::getOutputBuffer' => ['EventBuffer'], 'EventHttpRequest::getOutputHeaders' => ['void'], 'EventHttpRequest::getResponseCode' => ['int'], 'EventHttpRequest::getUri' => ['string'], 'EventHttpRequest::removeHeader' => ['void', 'key'=>'string', 'type'=>'string'], 'EventHttpRequest::sendError' => ['void', 'error'=>'int', 'reason='=>'string'], 'EventHttpRequest::sendReply' => ['void', 'code'=>'int', 'reason'=>'string', 'buf='=>'EventBuffer'], 'EventHttpRequest::sendReplyChunk' => ['void', 'buf'=>'EventBuffer'], 'EventHttpRequest::sendReplyEnd' => ['void'], 'EventHttpRequest::sendReplyStart' => ['void', 'code'=>'int', 'reason'=>'string'], 'EventListener::__construct' => ['void', 'base'=>'EventBase', 'cb'=>'callable', 'data'=>'mixed', 'flags'=>'int', 'backlog'=>'int', 'target'=>'mixed'], 'EventListener::disable' => ['bool'], 'EventListener::enable' => ['bool'], 'EventListener::getBase' => ['void'], 'EventListener::getSocketName' => ['bool', '&w_address'=>'string', '&w_port='=>'mixed'], 'EventListener::setCallback' => ['void', 'cb'=>'callable', 'arg='=>'mixed'], 'EventListener::setErrorCallback' => ['void', 'cb'=>'string'], 'EventSslContext::__construct' => ['void', 'method'=>'string', 'options'=>'string'], 'EventUtil::__construct' => ['void'], 'EventUtil::getLastSocketErrno' => ['int', 'socket='=>'mixed'], 'EventUtil::getLastSocketError' => ['string', 'socket='=>'mixed'], 'EventUtil::getSocketFd' => ['int', 'socket'=>'mixed'], 'EventUtil::getSocketName' => ['bool', 'socket'=>'mixed', '&w_address'=>'string', '&w_port='=>'mixed'], 'EventUtil::setSocketOption' => ['bool', 'socket'=>'mixed', 'level'=>'int', 'optname'=>'int', 'optval'=>'mixed'], 'EventUtil::sslRandPoll' => ['void'], 'EvFork::__construct' => ['void', 'callback'=>'callable', 'data='=>'mixed', 'priority='=>'int'], 'EvFork::createStopped' => ['object', 'callback'=>'string', 'data='=>'string', 'priority='=>'string'], 'EvIdle::__construct' => ['void', 'callback'=>'callable', 'data='=>'mixed', 'priority='=>'int'], 'EvIdle::createStopped' => ['object', 'callback'=>'string', 'data='=>'mixed', 'priority='=>'int'], 'EvIo::__construct' => ['void', 'fd'=>'mixed', 'events'=>'int', 'callback'=>'callable', 'data='=>'mixed', 'priority='=>'int'], 'EvIo::createStopped' => ['EvIo', 'fd'=>'mixed', 'events'=>'int', 'callback'=>'callable', 'data='=>'mixed', 'priority='=>'int'], 'EvIo::set' => ['void', 'fd'=>'mixed', 'events'=>'int'], 'EvLoop::__construct' => ['void', 'flags='=>'int', 'data='=>'mixed', 'io_interval='=>'float', 'timeout_interval='=>'float'], 'EvLoop::backend' => ['int'], 'EvLoop::check' => ['EvCheck', 'callback'=>'string', 'data='=>'string', 'priority='=>'string'], 'EvLoop::child' => ['EvChild', 'pid'=>'string', 'trace'=>'string', 'callback'=>'string', 'data='=>'string', 'priority='=>'string'], 'EvLoop::defaultLoop' => ['EvLoop', 'flags='=>'int', 'data='=>'mixed', 'io_interval='=>'float', 'timeout_interval='=>'float'], 'EvLoop::embed' => ['EvEmbed', 'other'=>'string', 'callback='=>'string', 'data='=>'string', 'priority='=>'string'], 'EvLoop::fork' => ['EvFork', 'callback'=>'callable', 'data='=>'mixed', 'priority='=>'int'], 'EvLoop::idle' => ['EvIdle', 'callback'=>'callable', 'data='=>'mixed', 'priority='=>'int'], 'EvLoop::invokePending' => ['void'], 'EvLoop::io' => ['EvIo', 'fd'=>'mixed', 'events'=>'int', 'callback'=>'callable', 'data='=>'mixed', 'priority='=>'int'], 'EvLoop::loopFork' => ['void'], 'EvLoop::now' => ['float'], 'EvLoop::nowUpdate' => ['void'], 'EvLoop::periodic' => ['EvPeriodic', 'offset'=>'float', 'interval'=>'float', 'callback'=>'callable', 'data='=>'mixed', 'priority='=>'int'], 'EvLoop::prepare' => ['EvPrepare', 'callback'=>'callable', 'data='=>'mixed', 'priority='=>'int'], 'EvLoop::resume' => ['void'], 'EvLoop::run' => ['void', 'flags='=>'int'], 'EvLoop::signal' => ['EvSignal', 'signum'=>'int', 'callback'=>'callable', 'data='=>'mixed', 'priority='=>'int'], 'EvLoop::stat' => ['EvStat', 'path'=>'string', 'interval'=>'float', 'callback'=>'callable', 'data='=>'mixed', 'priority='=>'int'], 'EvLoop::stop' => ['void', 'how='=>'int'], 'EvLoop::suspend' => ['void'], 'EvLoop::timer' => ['EvTimer', 'after'=>'float', 'repeat'=>'float', 'callback'=>'callable', 'data='=>'mixed', 'priority='=>'int'], 'EvLoop::verify' => ['void'], 'EvPeriodic::__construct' => ['void', 'offset'=>'float', 'interval'=>'string', 'reschedule_cb'=>'callable', 'callback'=>'callable', 'data='=>'mixed', 'priority='=>'int'], 'EvPeriodic::again' => ['void'], 'EvPeriodic::at' => ['float'], 'EvPeriodic::createStopped' => ['EvPeriodic', 'offset'=>'float', 'interval'=>'float', 'reschedule_cb'=>'callable', 'callback'=>'callable', 'data='=>'mixed', 'priority='=>'int'], 'EvPeriodic::set' => ['void', 'offset'=>'float', 'interval'=>'float'], 'EvPrepare::__construct' => ['void', 'callback'=>'string', 'data='=>'string', 'priority='=>'string'], 'EvPrepare::createStopped' => ['EvPrepare', 'callback'=>'callable', 'data='=>'mixed', 'priority='=>'int'], 'EvSignal::__construct' => ['void', 'signum'=>'int', 'callback'=>'callable', 'data='=>'mixed', 'priority='=>'int'], 'EvSignal::createStopped' => ['EvSignal', 'signum'=>'int', 'callback'=>'callable', 'data='=>'mixed', 'priority='=>'int'], 'EvSignal::set' => ['void', 'signum'=>'int'], 'EvStat::__construct' => ['void', 'path'=>'string', 'interval'=>'float', 'callback'=>'callable', 'data='=>'mixed', 'priority='=>'int'], 'EvStat::attr' => ['array'], 'EvStat::createStopped' => ['void', 'path'=>'string', 'interval'=>'float', 'callback'=>'callable', 'data='=>'mixed', 'priority='=>'int'], 'EvStat::prev' => ['void'], 'EvStat::set' => ['void', 'path'=>'string', 'interval'=>'float'], 'EvStat::stat' => ['bool'], 'EvTimer::__construct' => ['void', 'after'=>'float', 'repeat'=>'float', 'callback'=>'callable', 'data='=>'mixed', 'priority='=>'int'], 'EvTimer::again' => ['void'], 'EvTimer::createStopped' => ['EvTimer', 'after'=>'float', 'repeat'=>'float', 'callback'=>'callable', 'data='=>'mixed', 'priority='=>'int'], 'EvTimer::set' => ['void', 'after'=>'float', 'repeat'=>'float'], 'EvWatcher::__construct' => ['void'], 'EvWatcher::clear' => ['int'], 'EvWatcher::feed' => ['void', 'revents'=>'int'], 'EvWatcher::getLoop' => ['EvLoop'], 'EvWatcher::invoke' => ['void', 'revents'=>'int'], 'EvWatcher::keepalive' => ['bool', 'value='=>'bool'], 'EvWatcher::setCallback' => ['void', 'callback'=>'callable'], 'EvWatcher::start' => ['void'], 'EvWatcher::stop' => ['void'], 'Exception::__clone' => ['void'], 'Exception::__construct' => ['void', 'message='=>'string', 'code='=>'int', 'previous='=>'(?Throwable)|(?Exception)'], 'Exception::__toString' => ['string'], 'Exception::getCode' => ['mixed'], 'Exception::getFile' => ['string'], 'Exception::getLine' => ['int'], 'Exception::getMessage' => ['string'], 'Exception::getPrevious' => ['(?Throwable)|(?Exception)'], 'Exception::getTrace' => ['list<array{function:string,line?:int,file?:string,class?:class-string,type?:\'::\'|\'->\',args?:mixed[],object?:object}>'], 'Exception::getTraceAsString' => ['string'], 'exec' => ['string|false', 'command'=>'string', '&w_output='=>'array', '&w_return_value='=>'int'], 'exif_imagetype' => ['int|false', 'imagefile'=>'string'], 'exif_read_data' => ['array|false', 'filename'=>'string|resource', 'sections_needed='=>'string', 'sub_arrays='=>'bool', 'read_thumbnail='=>'bool'], 'exif_tagname' => ['string|false', 'index'=>'int'], 'exif_thumbnail' => ['string|false', 'filename'=>'string', '&w_width='=>'int', '&w_height='=>'int', '&w_imagetype='=>'int'], 'exp' => ['float', 'number'=>'float'], 'expect_expectl' => ['int', 'expect'=>'resource', 'cases'=>'array', 'match='=>'array'], 'expect_popen' => ['resource|false', 'command'=>'string'], 'explode' => ['list<string>|false', 'separator'=>'string', 'str'=>'string', 'limit='=>'int'], 'expm1' => ['float', 'number'=>'float'], 'extension_loaded' => ['bool', 'extension_name'=>'string'], 'extract' => ['0|positive-int', 'array'=>'array', 'flags='=>'int', 'prefix='=>'string|null'], 'ezmlm_hash' => ['int', 'addr'=>'string'], 'fam_cancel_monitor' => ['bool', 'fam'=>'resource', 'fam_monitor'=>'resource'], 'fam_close' => ['void', 'fam'=>'resource'], 'fam_monitor_collection' => ['resource', 'fam'=>'resource', 'dirname'=>'string', 'depth'=>'int', 'mask'=>'string'], 'fam_monitor_directory' => ['resource', 'fam'=>'resource', 'dirname'=>'string'], 'fam_monitor_file' => ['resource', 'fam'=>'resource', 'filename'=>'string'], 'fam_next_event' => ['array', 'fam'=>'resource'], 'fam_open' => ['resource|false', 'appname='=>'string'], 'fam_pending' => ['int', 'fam'=>'resource'], 'fam_resume_monitor' => ['bool', 'fam'=>'resource', 'fam_monitor'=>'resource'], 'fam_suspend_monitor' => ['bool', 'fam'=>'resource', 'fam_monitor'=>'resource'], 'fann_cascadetrain_on_data' => ['bool', 'ann'=>'resource', 'data'=>'resource', 'max_neurons'=>'int', 'neurons_between_reports'=>'int', 'desired_error'=>'float'], 'fann_cascadetrain_on_file' => ['bool', 'ann'=>'resource', 'filename'=>'string', 'max_neurons'=>'int', 'neurons_between_reports'=>'int', 'desired_error'=>'float'], 'fann_clear_scaling_params' => ['bool', 'ann'=>'resource'], 'fann_copy' => ['resource', 'ann'=>'resource'], 'fann_create_from_file' => ['resource', 'configuration_file'=>'string'], 'fann_create_shortcut' => ['reference', 'num_layers'=>'int', 'num_neurons1'=>'int', 'num_neurons2'=>'int', '...args='=>'int'], 'fann_create_shortcut_array' => ['resource', 'num_layers'=>'int', 'layers'=>'array'], 'fann_create_sparse' => ['resource|false', 'connection_rate'=>'float', 'num_layers'=>'int', 'num_neurons1'=>'int', 'num_neurons2'=>'int', '...args='=>'int'], 'fann_create_sparse_array' => ['resource|false', 'connection_rate'=>'float', 'num_layers'=>'int', 'layers'=>'array'], 'fann_create_standard' => ['resource', 'num_layers'=>'int', 'num_neurons1'=>'int', 'num_neurons2'=>'int', '...args='=>'int'], 'fann_create_standard_array' => ['resource', 'num_layers'=>'int', 'layers'=>'array'], 'fann_create_train' => ['resource', 'num_data'=>'int', 'num_input'=>'int', 'num_output'=>'int'], 'fann_create_train_from_callback' => ['resource', 'num_data'=>'int', 'num_input'=>'int', 'num_output'=>'int', 'user_function'=>'callable'], 'fann_descale_input' => ['bool', 'ann'=>'resource', 'input_vector'=>'array'], 'fann_descale_output' => ['bool', 'ann'=>'resource', 'output_vector'=>'array'], 'fann_descale_train' => ['bool', 'ann'=>'resource', 'train_data'=>'resource'], 'fann_destroy' => ['bool', 'ann'=>'resource'], 'fann_destroy_train' => ['bool', 'train_data'=>'resource'], 'fann_duplicate_train_data' => ['resource', 'data'=>'resource'], 'fann_get_activation_function' => ['int', 'ann'=>'resource', 'layer'=>'int', 'neuron'=>'int'], 'fann_get_activation_steepness' => ['float', 'ann'=>'resource', 'layer'=>'int', 'neuron'=>'int'], 'fann_get_bias_array' => ['array', 'ann'=>'resource'], 'fann_get_bit_fail' => ['int', 'ann'=>'resource'], 'fann_get_bit_fail_limit' => ['float', 'ann'=>'resource'], 'fann_get_cascade_activation_functions' => ['array', 'ann'=>'resource'], 'fann_get_cascade_activation_functions_count' => ['int', 'ann'=>'resource'], 'fann_get_cascade_activation_steepnesses' => ['array', 'ann'=>'resource'], 'fann_get_cascade_activation_steepnesses_count' => ['int', 'ann'=>'resource'], 'fann_get_cascade_candidate_change_fraction' => ['float', 'ann'=>'resource'], 'fann_get_cascade_candidate_limit' => ['float', 'ann'=>'resource'], 'fann_get_cascade_candidate_stagnation_epochs' => ['float', 'ann'=>'resource'], 'fann_get_cascade_max_cand_epochs' => ['int', 'ann'=>'resource'], 'fann_get_cascade_max_out_epochs' => ['int', 'ann'=>'resource'], 'fann_get_cascade_min_cand_epochs' => ['int', 'ann'=>'resource'], 'fann_get_cascade_min_out_epochs' => ['int', 'ann'=>'resource'], 'fann_get_cascade_num_candidate_groups' => ['int', 'ann'=>'resource'], 'fann_get_cascade_num_candidates' => ['int', 'ann'=>'resource'], 'fann_get_cascade_output_change_fraction' => ['float', 'ann'=>'resource'], 'fann_get_cascade_output_stagnation_epochs' => ['int', 'ann'=>'resource'], 'fann_get_cascade_weight_multiplier' => ['float', 'ann'=>'resource'], 'fann_get_connection_array' => ['array', 'ann'=>'resource'], 'fann_get_connection_rate' => ['float', 'ann'=>'resource'], 'fann_get_errno' => ['int', 'errdat'=>'resource'], 'fann_get_errstr' => ['string', 'errdat'=>'resource'], 'fann_get_layer_array' => ['array', 'ann'=>'resource'], 'fann_get_learning_momentum' => ['float', 'ann'=>'resource'], 'fann_get_learning_rate' => ['float', 'ann'=>'resource'], 'fann_get_MSE' => ['float', 'ann'=>'resource'], 'fann_get_network_type' => ['int', 'ann'=>'resource'], 'fann_get_num_input' => ['int', 'ann'=>'resource'], 'fann_get_num_layers' => ['int', 'ann'=>'resource'], 'fann_get_num_output' => ['int', 'ann'=>'resource'], 'fann_get_quickprop_decay' => ['float', 'ann'=>'resource'], 'fann_get_quickprop_mu' => ['float', 'ann'=>'resource'], 'fann_get_rprop_decrease_factor' => ['float', 'ann'=>'resource'], 'fann_get_rprop_delta_max' => ['float', 'ann'=>'resource'], 'fann_get_rprop_delta_min' => ['float', 'ann'=>'resource'], 'fann_get_rprop_delta_zero' => ['float|false', 'ann'=>'resource'], 'fann_get_rprop_increase_factor' => ['float', 'ann'=>'resource'], 'fann_get_sarprop_step_error_shift' => ['float', 'ann'=>'resource'], 'fann_get_sarprop_step_error_threshold_factor' => ['float', 'ann'=>'resource'], 'fann_get_sarprop_temperature' => ['float', 'ann'=>'resource'], 'fann_get_sarprop_weight_decay_shift' => ['float', 'ann'=>'resource'], 'fann_get_total_connections' => ['int', 'ann'=>'resource'], 'fann_get_total_neurons' => ['int', 'ann'=>'resource'], 'fann_get_train_error_function' => ['int', 'ann'=>'resource'], 'fann_get_train_stop_function' => ['int', 'ann'=>'resource'], 'fann_get_training_algorithm' => ['int', 'ann'=>'resource'], 'fann_init_weights' => ['bool', 'ann'=>'resource', 'train_data'=>'resource'], 'fann_length_train_data' => ['int', 'data'=>'resource'], 'fann_merge_train_data' => ['resource', 'data1'=>'resource', 'data2'=>'resource'], 'fann_num_input_train_data' => ['int', 'data'=>'resource'], 'fann_num_output_train_data' => ['int', 'data'=>'resource'], 'fann_print_error' => ['void', 'errdat'=>'string'], 'fann_randomize_weights' => ['bool', 'ann'=>'resource', 'min_weight'=>'float', 'max_weight'=>'float'], 'fann_read_train_from_file' => ['resource', 'filename'=>'string'], 'fann_reset_errno' => ['void', 'errdat'=>'resource'], 'fann_reset_errstr' => ['void', 'errdat'=>'resource'], 'fann_reset_MSE' => ['bool', 'ann'=>'string'], 'fann_run' => ['array', 'ann'=>'resource', 'input'=>'array'], 'fann_save' => ['bool', 'ann'=>'resource', 'configuration_file'=>'string'], 'fann_save_train' => ['bool', 'data'=>'resource', 'file_name'=>'string'], 'fann_scale_input' => ['bool', 'ann'=>'resource', 'input_vector'=>'array'], 'fann_scale_input_train_data' => ['bool', 'train_data'=>'resource', 'new_min'=>'float', 'new_max'=>'float'], 'fann_scale_output' => ['bool', 'ann'=>'resource', 'output_vector'=>'array'], 'fann_scale_output_train_data' => ['bool', 'train_data'=>'resource', 'new_min'=>'float', 'new_max'=>'float'], 'fann_scale_train' => ['bool', 'ann'=>'resource', 'train_data'=>'resource'], 'fann_scale_train_data' => ['bool', 'train_data'=>'resource', 'new_min'=>'float', 'new_max'=>'float'], 'fann_set_activation_function' => ['bool', 'ann'=>'resource', 'activation_function'=>'int', 'layer'=>'int', 'neuron'=>'int'], 'fann_set_activation_function_hidden' => ['bool', 'ann'=>'resource', 'activation_function'=>'int'], 'fann_set_activation_function_layer' => ['bool', 'ann'=>'resource', 'activation_function'=>'int', 'layer'=>'int'], 'fann_set_activation_function_output' => ['bool', 'ann'=>'resource', 'activation_function'=>'int'], 'fann_set_activation_steepness' => ['bool', 'ann'=>'resource', 'activation_steepness'=>'float', 'layer'=>'int', 'neuron'=>'int'], 'fann_set_activation_steepness_hidden' => ['bool', 'ann'=>'resource', 'activation_steepness'=>'float'], 'fann_set_activation_steepness_layer' => ['bool', 'ann'=>'resource', 'activation_steepness'=>'float', 'layer'=>'int'], 'fann_set_activation_steepness_output' => ['bool', 'ann'=>'resource', 'activation_steepness'=>'float'], 'fann_set_bit_fail_limit' => ['bool', 'ann'=>'resource', 'bit_fail_limit'=>'float'], 'fann_set_callback' => ['bool', 'ann'=>'resource', 'callback'=>'callable'], 'fann_set_cascade_activation_functions' => ['bool', 'ann'=>'resource', 'cascade_activation_functions'=>'array'], 'fann_set_cascade_activation_steepnesses' => ['bool', 'ann'=>'resource', 'cascade_activation_steepnesses_count'=>'array'], 'fann_set_cascade_candidate_change_fraction' => ['bool', 'ann'=>'resource', 'cascade_candidate_change_fraction'=>'float'], 'fann_set_cascade_candidate_limit' => ['bool', 'ann'=>'resource', 'cascade_candidate_limit'=>'float'], 'fann_set_cascade_candidate_stagnation_epochs' => ['bool', 'ann'=>'resource', 'cascade_candidate_stagnation_epochs'=>'int'], 'fann_set_cascade_max_cand_epochs' => ['bool', 'ann'=>'resource', 'cascade_max_cand_epochs'=>'int'], 'fann_set_cascade_max_out_epochs' => ['bool', 'ann'=>'resource', 'cascade_max_out_epochs'=>'int'], 'fann_set_cascade_min_cand_epochs' => ['bool', 'ann'=>'resource', 'cascade_min_cand_epochs'=>'int'], 'fann_set_cascade_min_out_epochs' => ['bool', 'ann'=>'resource', 'cascade_min_out_epochs'=>'int'], 'fann_set_cascade_num_candidate_groups' => ['bool', 'ann'=>'resource', 'cascade_num_candidate_groups'=>'int'], 'fann_set_cascade_output_change_fraction' => ['bool', 'ann'=>'resource', 'cascade_output_change_fraction'=>'float'], 'fann_set_cascade_output_stagnation_epochs' => ['bool', 'ann'=>'resource', 'cascade_output_stagnation_epochs'=>'int'], 'fann_set_cascade_weight_multiplier' => ['bool', 'ann'=>'resource', 'cascade_weight_multiplier'=>'float'], 'fann_set_error_log' => ['void', 'errdat'=>'resource', 'log_file'=>'string'], 'fann_set_input_scaling_params' => ['bool', 'ann'=>'resource', 'train_data'=>'resource', 'new_input_min'=>'float', 'new_input_max'=>'float'], 'fann_set_learning_momentum' => ['bool', 'ann'=>'resource', 'learning_momentum'=>'float'], 'fann_set_learning_rate' => ['bool', 'ann'=>'resource', 'learning_rate'=>'float'], 'fann_set_output_scaling_params' => ['bool', 'ann'=>'resource', 'train_data'=>'resource', 'new_output_min'=>'float', 'new_output_max'=>'float'], 'fann_set_quickprop_decay' => ['bool', 'ann'=>'resource', 'quickprop_decay'=>'float'], 'fann_set_quickprop_mu' => ['bool', 'ann'=>'resource', 'quickprop_mu'=>'float'], 'fann_set_rprop_decrease_factor' => ['bool', 'ann'=>'resource', 'rprop_decrease_factor'=>'float'], 'fann_set_rprop_delta_max' => ['bool', 'ann'=>'resource', 'rprop_delta_max'=>'float'], 'fann_set_rprop_delta_min' => ['bool', 'ann'=>'resource', 'rprop_delta_min'=>'float'], 'fann_set_rprop_delta_zero' => ['bool', 'ann'=>'resource', 'rprop_delta_zero'=>'float'], 'fann_set_rprop_increase_factor' => ['bool', 'ann'=>'resource', 'rprop_increase_factor'=>'float'], 'fann_set_sarprop_step_error_shift' => ['bool', 'ann'=>'resource', 'sarprop_step_error_shift'=>'float'], 'fann_set_sarprop_step_error_threshold_factor' => ['bool', 'ann'=>'resource', 'sarprop_step_error_threshold_factor'=>'float'], 'fann_set_sarprop_temperature' => ['bool', 'ann'=>'resource', 'sarprop_temperature'=>'float'], 'fann_set_sarprop_weight_decay_shift' => ['bool', 'ann'=>'resource', 'sarprop_weight_decay_shift'=>'float'], 'fann_set_scaling_params' => ['bool', 'ann'=>'resource', 'train_data'=>'resource', 'new_input_min'=>'float', 'new_input_max'=>'float', 'new_output_min'=>'float', 'new_output_max'=>'float'], 'fann_set_train_error_function' => ['bool', 'ann'=>'resource', 'error_function'=>'int'], 'fann_set_train_stop_function' => ['bool', 'ann'=>'resource', 'stop_function'=>'int'], 'fann_set_training_algorithm' => ['bool', 'ann'=>'resource', 'training_algorithm'=>'int'], 'fann_set_weight' => ['bool', 'ann'=>'resource', 'from_neuron'=>'int', 'to_neuron'=>'int', 'weight'=>'float'], 'fann_set_weight_array' => ['bool', 'ann'=>'resource', 'connections'=>'array'], 'fann_shuffle_train_data' => ['bool', 'train_data'=>'resource'], 'fann_subset_train_data' => ['resource', 'data'=>'resource', 'pos'=>'int', 'length'=>'int'], 'fann_test' => ['bool', 'ann'=>'resource', 'input'=>'array', 'desired_output'=>'array'], 'fann_test_data' => ['float', 'ann'=>'resource', 'data'=>'resource'], 'fann_train' => ['bool', 'ann'=>'resource', 'input'=>'array', 'desired_output'=>'array'], 'fann_train_epoch' => ['float', 'ann'=>'resource', 'data'=>'resource'], 'fann_train_on_data' => ['bool', 'ann'=>'resource', 'data'=>'resource', 'max_epochs'=>'int', 'epochs_between_reports'=>'int', 'desired_error'=>'float'], 'fann_train_on_file' => ['bool', 'ann'=>'resource', 'filename'=>'string', 'max_epochs'=>'int', 'epochs_between_reports'=>'int', 'desired_error'=>'float'], 'FANNConnection::__construct' => ['void', 'from_neuron'=>'int', 'to_neuron'=>'int', 'weight'=>'float'], 'FANNConnection::getFromNeuron' => ['int'], 'FANNConnection::getToNeuron' => ['int'], 'FANNConnection::getWeight' => ['void'], 'FANNConnection::setWeight' => ['bool', 'weight'=>'float'], 'fastcgi_finish_request' => ['bool'], 'fbsql_affected_rows' => ['int', 'link_identifier='=>'?resource'], 'fbsql_autocommit' => ['bool', 'link_identifier'=>'resource', 'onoff='=>'bool'], 'fbsql_blob_size' => ['int', 'blob_handle'=>'string', 'link_identifier='=>'?resource'], 'fbsql_change_user' => ['bool', 'user'=>'string', 'password'=>'string', 'database='=>'string', 'link_identifier='=>'?resource'], 'fbsql_clob_size' => ['int', 'clob_handle'=>'string', 'link_identifier='=>'?resource'], 'fbsql_close' => ['bool', 'link_identifier='=>'?resource'], 'fbsql_commit' => ['bool', 'link_identifier='=>'?resource'], 'fbsql_connect' => ['resource', 'hostname='=>'string', 'username='=>'string', 'password='=>'string'], 'fbsql_create_blob' => ['string', 'blob_data'=>'string', 'link_identifier='=>'?resource'], 'fbsql_create_clob' => ['string', 'clob_data'=>'string', 'link_identifier='=>'?resource'], 'fbsql_create_db' => ['bool', 'database_name'=>'string', 'link_identifier='=>'?resource', 'database_options='=>'string'], 'fbsql_data_seek' => ['bool', 'result'=>'resource', 'row_number'=>'int'], 'fbsql_database' => ['string', 'link_identifier'=>'resource', 'database='=>'string'], 'fbsql_database_password' => ['string', 'link_identifier'=>'resource', 'database_password='=>'string'], 'fbsql_db_query' => ['resource', 'database'=>'string', 'query'=>'string', 'link_identifier='=>'?resource'], 'fbsql_db_status' => ['int', 'database_name'=>'string', 'link_identifier='=>'?resource'], 'fbsql_drop_db' => ['bool', 'database_name'=>'string', 'link_identifier='=>'?resource'], 'fbsql_errno' => ['int', 'link_identifier='=>'?resource'], 'fbsql_error' => ['string', 'link_identifier='=>'?resource'], 'fbsql_fetch_array' => ['array', 'result'=>'resource', 'result_type='=>'int'], 'fbsql_fetch_assoc' => ['array', 'result'=>'resource'], 'fbsql_fetch_field' => ['object', 'result'=>'resource', 'field_offset='=>'int'], 'fbsql_fetch_lengths' => ['array', 'result'=>'resource'], 'fbsql_fetch_object' => ['object', 'result'=>'resource'], 'fbsql_fetch_row' => ['array', 'result'=>'resource'], 'fbsql_field_flags' => ['string', 'result'=>'resource', 'field_offset='=>'int'], 'fbsql_field_len' => ['int', 'result'=>'resource', 'field_offset='=>'int'], 'fbsql_field_name' => ['string', 'result'=>'resource', 'field_index='=>'int'], 'fbsql_field_seek' => ['bool', 'result'=>'resource', 'field_offset='=>'int'], 'fbsql_field_table' => ['string', 'result'=>'resource', 'field_offset='=>'int'], 'fbsql_field_type' => ['string', 'result'=>'resource', 'field_offset='=>'int'], 'fbsql_free_result' => ['bool', 'result'=>'resource'], 'fbsql_get_autostart_info' => ['array', 'link_identifier='=>'?resource'], 'fbsql_hostname' => ['string', 'link_identifier'=>'resource', 'host_name='=>'string'], 'fbsql_insert_id' => ['int', 'link_identifier='=>'?resource'], 'fbsql_list_dbs' => ['resource', 'link_identifier='=>'?resource'], 'fbsql_list_fields' => ['resource', 'database_name'=>'string', 'table_name'=>'string', 'link_identifier='=>'?resource'], 'fbsql_list_tables' => ['resource', 'database'=>'string', 'link_identifier='=>'?resource'], 'fbsql_next_result' => ['bool', 'result'=>'resource'], 'fbsql_num_fields' => ['int', 'result'=>'resource'], 'fbsql_num_rows' => ['int', 'result'=>'resource'], 'fbsql_password' => ['string', 'link_identifier'=>'resource', 'password='=>'string'], 'fbsql_pconnect' => ['resource', 'hostname='=>'string', 'username='=>'string', 'password='=>'string'], 'fbsql_query' => ['resource', 'query'=>'string', 'link_identifier='=>'?resource', 'batch_size='=>'int'], 'fbsql_read_blob' => ['string', 'blob_handle'=>'string', 'link_identifier='=>'?resource'], 'fbsql_read_clob' => ['string', 'clob_handle'=>'string', 'link_identifier='=>'?resource'], 'fbsql_result' => ['mixed', 'result'=>'resource', 'row='=>'int', 'field='=>'mixed'], 'fbsql_rollback' => ['bool', 'link_identifier='=>'?resource'], 'fbsql_rows_fetched' => ['int', 'result'=>'resource'], 'fbsql_select_db' => ['bool', 'database_name='=>'string', 'link_identifier='=>'?resource'], 'fbsql_set_characterset' => ['void', 'link_identifier'=>'resource', 'characterset'=>'int', 'in_out_both='=>'int'], 'fbsql_set_lob_mode' => ['bool', 'result'=>'resource', 'lob_mode'=>'int'], 'fbsql_set_password' => ['bool', 'link_identifier'=>'resource', 'user'=>'string', 'password'=>'string', 'old_password'=>'string'], 'fbsql_set_transaction' => ['void', 'link_identifier'=>'resource', 'locking'=>'int', 'isolation'=>'int'], 'fbsql_start_db' => ['bool', 'database_name'=>'string', 'link_identifier='=>'?resource', 'database_options='=>'string'], 'fbsql_stop_db' => ['bool', 'database_name'=>'string', 'link_identifier='=>'?resource'], 'fbsql_table_name' => ['string', 'result'=>'resource', 'index'=>'int'], 'fbsql_username' => ['string', 'link_identifier'=>'resource', 'username='=>'string'], 'fbsql_warnings' => ['bool', 'onoff='=>'bool'], 'fclose' => ['bool', 'fp'=>'resource'], 'fdf_add_doc_javascript' => ['bool', 'fdf_document'=>'resource', 'script_name'=>'string', 'script_code'=>'string'], 'fdf_add_template' => ['bool', 'fdf_document'=>'resource', 'newpage'=>'int', 'filename'=>'string', 'template'=>'string', 'rename'=>'int'], 'fdf_close' => ['void', 'fdf_document'=>'resource'], 'fdf_create' => ['resource'], 'fdf_enum_values' => ['bool', 'fdf_document'=>'resource', 'function'=>'callable', 'userdata='=>'mixed'], 'fdf_errno' => ['int'], 'fdf_error' => ['string', 'error_code='=>'int'], 'fdf_get_ap' => ['bool', 'fdf_document'=>'resource', 'field'=>'string', 'face'=>'int', 'filename'=>'string'], 'fdf_get_attachment' => ['array', 'fdf_document'=>'resource', 'fieldname'=>'string', 'savepath'=>'string'], 'fdf_get_encoding' => ['string', 'fdf_document'=>'resource'], 'fdf_get_file' => ['string', 'fdf_document'=>'resource'], 'fdf_get_flags' => ['int', 'fdf_document'=>'resource', 'fieldname'=>'string', 'whichflags'=>'int'], 'fdf_get_opt' => ['mixed', 'fdf_document'=>'resource', 'fieldname'=>'string', 'element='=>'int'], 'fdf_get_status' => ['string', 'fdf_document'=>'resource'], 'fdf_get_value' => ['mixed', 'fdf_document'=>'resource', 'fieldname'=>'string', 'which='=>'int'], 'fdf_get_version' => ['string', 'fdf_document='=>'resource'], 'fdf_header' => ['void'], 'fdf_next_field_name' => ['string', 'fdf_document'=>'resource', 'fieldname='=>'string'], 'fdf_open' => ['resource|false', 'filename'=>'string'], 'fdf_open_string' => ['resource', 'fdf_data'=>'string'], 'fdf_remove_item' => ['bool', 'fdf_document'=>'resource', 'fieldname'=>'string', 'item'=>'int'], 'fdf_save' => ['bool', 'fdf_document'=>'resource', 'filename='=>'string'], 'fdf_save_string' => ['string', 'fdf_document'=>'resource'], 'fdf_set_ap' => ['bool', 'fdf_document'=>'resource', 'field_name'=>'string', 'face'=>'int', 'filename'=>'string', 'page_number'=>'int'], 'fdf_set_encoding' => ['bool', 'fdf_document'=>'resource', 'encoding'=>'string'], 'fdf_set_file' => ['bool', 'fdf_document'=>'resource', 'url'=>'string', 'target_frame='=>'string'], 'fdf_set_flags' => ['bool', 'fdf_document'=>'resource', 'fieldname'=>'string', 'whichflags'=>'int', 'newflags'=>'int'], 'fdf_set_javascript_action' => ['bool', 'fdf_document'=>'resource', 'fieldname'=>'string', 'trigger'=>'int', 'script'=>'string'], 'fdf_set_on_import_javascript' => ['bool', 'fdf_document'=>'resource', 'script'=>'string', 'before_data_import'=>'bool'], 'fdf_set_opt' => ['bool', 'fdf_document'=>'resource', 'fieldname'=>'string', 'element'=>'int', 'str1'=>'string', 'str2'=>'string'], 'fdf_set_status' => ['bool', 'fdf_document'=>'resource', 'status'=>'string'], 'fdf_set_submit_form_action' => ['bool', 'fdf_document'=>'resource', 'fieldname'=>'string', 'trigger'=>'int', 'script'=>'string', 'flags'=>'int'], 'fdf_set_target_frame' => ['bool', 'fdf_document'=>'resource', 'frame_name'=>'string'], 'fdf_set_value' => ['bool', 'fdf_document'=>'resource', 'fieldname'=>'string', 'value'=>'mixed', 'isname='=>'int'], 'fdf_set_version' => ['bool', 'fdf_document'=>'resource', 'version'=>'string'], 'feof' => ['bool', 'fp'=>'resource'], 'fflush' => ['bool', 'fp'=>'resource'], 'ffmpeg_animated_gif::__construct' => ['void', 'output_file_path'=>'string', 'width'=>'int', 'height'=>'int', 'frame_rate'=>'int', 'loop_count='=>'int'], 'ffmpeg_animated_gif::addFrame' => ['', 'frame_to_add'=>'ffmpeg_frame'], 'ffmpeg_frame::__construct' => ['void', 'gd_image'=>'resource'], 'ffmpeg_frame::crop' => ['', 'crop_top'=>'int', 'crop_bottom='=>'int', 'crop_left='=>'int', 'crop_right='=>'int'], 'ffmpeg_frame::getHeight' => ['int'], 'ffmpeg_frame::getPresentationTimestamp' => ['int'], 'ffmpeg_frame::getPTS' => ['int'], 'ffmpeg_frame::getWidth' => ['int'], 'ffmpeg_frame::resize' => ['', 'width'=>'int', 'height'=>'int', 'crop_top='=>'int', 'crop_bottom='=>'int', 'crop_left='=>'int', 'crop_right='=>'int'], 'ffmpeg_frame::toGDImage' => ['resource'], 'ffmpeg_movie::__construct' => ['void', 'path_to_media'=>'string', 'persistent'=>'bool'], 'ffmpeg_movie::getArtist' => ['string'], 'ffmpeg_movie::getAudioBitRate' => ['int'], 'ffmpeg_movie::getAudioChannels' => ['int'], 'ffmpeg_movie::getAudioCodec' => ['string'], 'ffmpeg_movie::getAudioSampleRate' => ['int'], 'ffmpeg_movie::getAuthor' => ['string'], 'ffmpeg_movie::getBitRate' => ['int'], 'ffmpeg_movie::getComment' => ['string'], 'ffmpeg_movie::getCopyright' => ['string'], 'ffmpeg_movie::getDuration' => ['int'], 'ffmpeg_movie::getFilename' => ['string'], 'ffmpeg_movie::getFrame' => ['ffmpeg_frame', 'framenumber'=>'int'], 'ffmpeg_movie::getFrameCount' => ['int'], 'ffmpeg_movie::getFrameHeight' => ['int'], 'ffmpeg_movie::getFrameNumber' => ['int'], 'ffmpeg_movie::getFrameRate' => ['int'], 'ffmpeg_movie::getFrameWidth' => ['int'], 'ffmpeg_movie::getGenre' => ['string'], 'ffmpeg_movie::getNextKeyFrame' => ['ffmpeg_frame'], 'ffmpeg_movie::getPixelFormat' => [''], 'ffmpeg_movie::getTitle' => ['string'], 'ffmpeg_movie::getTrackNumber' => ['int|string'], 'ffmpeg_movie::getVideoBitRate' => ['int'], 'ffmpeg_movie::getVideoCodec' => ['string'], 'ffmpeg_movie::getYear' => ['int|string'], 'ffmpeg_movie::hasAudio' => ['bool'], 'ffmpeg_movie::hasVideo' => ['bool'], 'fgetc' => ['string|false', 'fp'=>'resource'], 'fgetcsv' => ['list<string>|array{0: null}|false|null', 'fp'=>'resource', 'length='=>'0|positive-int|null', 'delimiter='=>'string', 'enclosure='=>'string', 'escape='=>'string'], 'fgets' => ['string|false', 'fp'=>'resource', 'length='=>'0|positive-int'], 'fgetss' => ['string|false', 'fp'=>'resource', 'length='=>'0|positive-int', 'allowable_tags='=>'string'], 'file' => ['list<string>|false', 'filename'=>'string', 'flags='=>'int', 'context='=>'resource'], 'file_exists' => ['bool', 'filename'=>'string'], 'file_get_contents' => ['string|false', 'filename'=>'string', 'use_include_path='=>'bool', 'context='=>'?resource', 'offset='=>'int', 'maxlen='=>'0|positive-int'], 'file_put_contents' => ['0|positive-int|false', 'file'=>'string', 'data'=>'mixed', 'flags='=>'int', 'context='=>'?resource'], 'fileatime' => ['int|false', 'filename'=>'string'], 'filectime' => ['int|false', 'filename'=>'string'], 'filegroup' => ['int|false', 'filename'=>'string'], 'fileinode' => ['int|false', 'filename'=>'string'], 'filemtime' => ['int|false', 'filename'=>'string'], 'fileowner' => ['int|false', 'filename'=>'string'], 'fileperms' => ['int|false', 'filename'=>'string'], 'filepro' => ['bool', 'directory'=>'string'], 'filepro_fieldcount' => ['int'], 'filepro_fieldname' => ['string', 'field_number'=>'int'], 'filepro_fieldtype' => ['string', 'field_number'=>'int'], 'filepro_fieldwidth' => ['int', 'field_number'=>'int'], 'filepro_retrieve' => ['string', 'row_number'=>'int', 'field_number'=>'int'], 'filepro_rowcount' => ['int'], 'filesize' => ['0|positive-int|false', 'filename'=>'string'], 'FilesystemIterator::__construct' => ['void', 'path'=>'string', 'flags='=>'int'], 'FilesystemIterator::current' => ['string|SplFileInfo'], 'FilesystemIterator::getFlags' => ['int'], 'FilesystemIterator::key' => ['string'], 'FilesystemIterator::next' => ['void'], 'FilesystemIterator::rewind' => ['void'], 'FilesystemIterator::setFlags' => ['void', 'flags='=>'int'], 'filetype' => ['string|false', 'filename'=>'string'], 'filter_has_var' => ['bool', 'type'=>'int', 'variable_name'=>'string'], 'filter_id' => ['int|false', 'filtername'=>'string'], 'filter_input' => ['mixed', 'type'=>'int', 'variable_name'=>'string', 'filter='=>'int', 'options='=>'array|int'], 'filter_input_array' => ['array|false|null', 'type'=>'int', 'definition='=>'int|array', 'add_empty='=>'bool'], 'filter_list' => ['non-empty-list<non-falsy-string>'], 'filter_var' => ['mixed', 'variable'=>'mixed', 'filter='=>'int', 'options='=>'mixed'], 'filter_var_array' => ['array|false|null', 'data'=>'array', 'definition='=>'mixed', 'add_empty='=>'bool'], 'FilterIterator::__construct' => ['void', 'iterator'=>'Iterator'], 'FilterIterator::accept' => ['bool'], 'FilterIterator::current' => ['mixed'], 'FilterIterator::getInnerIterator' => ['Iterator'], 'FilterIterator::key' => ['mixed'], 'FilterIterator::next' => ['void'], 'FilterIterator::rewind' => ['void'], 'FilterIterator::valid' => ['bool'], 'finfo::__construct' => ['void', 'options='=>'int', 'magic_file='=>'string'], 'finfo::finfo' => ['void', 'options='=>'int', 'magic_file='=>'string'], 'finfo::buffer' => ['string|false', 'string'=>'string', 'options='=>'int', 'context='=>'resource'], 'finfo::file' => ['string|false', 'file_name'=>'string', 'options='=>'int', 'context='=>'resource'], 'finfo::set_flags' => ['bool', 'options'=>'int'], 'finfo_buffer' => ['string|false', 'finfo'=>'resource', 'string'=>'string', 'options='=>'int', 'context='=>'resource'], 'finfo_close' => ['bool', 'finfo'=>'resource'], 'finfo_file' => ['string|false', 'finfo'=>'resource', 'file_name'=>'string', 'options='=>'int', 'context='=>'resource'], 'finfo_open' => ['resource|false', 'options='=>'int', 'arg='=>'string'], 'finfo_set_flags' => ['bool', 'finfo'=>'resource', 'options'=>'int'], 'floatval' => ['float', 'var'=>'scalar|array|resource|null'], 'flock' => ['bool', 'fp'=>'resource', 'operation'=>'int', '&w_wouldblock='=>'int'], 'floor' => ['__benevolent<float|false>', 'number'=>'float'], 'flush' => ['void'], 'fmod' => ['float', 'x'=>'float', 'y'=>'float'], 'fnmatch' => ['bool', 'pattern'=>'string', 'filename'=>'string', 'flags='=>'int'], 'fopen' => ['resource|false', 'filename'=>'string', 'mode'=>'string', 'use_include_path='=>'bool', 'context='=>'resource|null'], 'forward_static_call' => ['mixed', 'function'=>'callable', '...parameters='=>'mixed'], 'forward_static_call_array' => ['mixed', 'function'=>'callable', 'parameters'=>'array<int,mixed>'], 'fpassthru' => ['0|positive-int|false', 'fp'=>'resource'], 'fpm_get_status' => ['array{pool: string, process-manager: \'dynamic\'|\'ondemand\'|\'static\', start-time: int<0, max>, start-since: int<0, max>, accepted-conn: int<0, max>, listen-queue: int<0, max>, max-listen-queue: int<0, max>, listen-queue-len: int<0, max>, idle-processes: int<0, max>, active-processes: int<1, max>, total-processes: int<1, max>, max-active-processes: int<1, max>, max-children-reached: 0|1, slow-requests: int<0, max>, procs: array<int, array{pid: int<2, max>, state: \'Idle\'|\'Running\', start-time: int<0, max>, start-since: int<0, max>, requests: int<0, max>, request-duration: int<0, max>, request-method: string, request-uri: string, query-string: string, request-length: int<0, max>, user: string, script: string, last-request-cpu: float, last-request-memory: int<0, max>}>}|false'], 'fprintf' => ['int', 'stream'=>'resource', 'format'=>'string', '...values='=>'__stringAndStringable|int|float|null|bool'], 'fputcsv' => ['0|positive-int|false', 'fp'=>'resource', 'fields'=>'array<int|string, __stringAndStringable|int|float|null|bool>', 'delimiter='=>'string', 'enclosure='=>'string', 'escape_char='=>'string'], 'fputs' => ['0|positive-int|false', 'fp'=>'resource', 'str'=>'string', 'length='=>'0|positive-int'], 'fread' => ['string', 'fp'=>'resource', 'length'=>'positive-int'], 'frenchtojd' => ['int', 'month'=>'int', 'day'=>'int', 'year'=>'int'], 'fribidi_log2vis' => ['string', 'str'=>'string', 'direction'=>'string', 'charset'=>'int'], 'fscanf' => ['list<mixed>|int|false', 'stream'=>'resource', 'format'=>'string', '&...w_vars='=>'string|int|float|null'], 'fseek' => ['0|-1', 'fp'=>'resource', 'offset'=>'int', 'whence='=>'int'], 'fsockopen' => ['resource|false', 'hostname'=>'string', 'port='=>'int', '&w_errno='=>'int', '&w_errstr='=>'string', 'timeout='=>'float'], 'fstat' => ['array|false', 'fp'=>'resource'], 'ftell' => ['int|false', 'fp'=>'resource'], 'ftok' => ['int', 'pathname'=>'string', 'proj'=>'string'], 'ftp_alloc' => ['bool', 'stream'=>'resource', 'size'=>'int', '&w_response='=>'string'], 'ftp_append' => ['bool', 'ftp'=>'resource', 'remote_file'=>'string', 'local_file'=>'string', 'mode='=>'int'], 'ftp_cdup' => ['bool', 'stream'=>'resource'], 'ftp_chdir' => ['bool', 'stream'=>'resource', 'directory'=>'string'], 'ftp_chmod' => ['int|false', 'stream'=>'resource', 'mode'=>'int', 'filename'=>'string'], 'ftp_close' => ['bool', 'stream'=>'resource'], 'ftp_connect' => ['resource|false', 'host'=>'string', 'port='=>'int', 'timeout='=>'int'], 'ftp_delete' => ['bool', 'stream'=>'resource', 'file'=>'string'], 'ftp_exec' => ['bool', 'stream'=>'resource', 'command'=>'string'], 'ftp_fget' => ['bool', 'stream'=>'resource', 'fp'=>'resource', 'remote_file'=>'string', 'mode='=>'int', 'resumepos='=>'int'], 'ftp_fput' => ['bool', 'stream'=>'resource', 'remote_file'=>'string', 'fp'=>'resource', 'mode='=>'int', 'startpos='=>'int'], 'ftp_get' => ['bool', 'stream'=>'resource', 'local_file'=>'string', 'remote_file'=>'string', 'mode='=>'int', 'resume_pos='=>'int'], 'ftp_get_option' => ['mixed', 'stream'=>'resource', 'option'=>'int'], 'ftp_login' => ['bool', 'stream'=>'resource', 'username'=>'string', 'password'=>'string'], 'ftp_mdtm' => ['int', 'stream'=>'resource', 'filename'=>'string'], 'ftp_mkdir' => ['string|false', 'stream'=>'resource', 'directory'=>'string'], 'ftp_mlsd' => ['array|false', 'ftp_stream'=>'resource', 'directory'=>'string'], 'ftp_nb_continue' => ['int', 'stream'=>'resource'], 'ftp_nb_fget' => ['int', 'stream'=>'resource', 'fp'=>'resource', 'remote_file'=>'string', 'mode='=>'int', 'resumepos='=>'int'], 'ftp_nb_fput' => ['int', 'stream'=>'resource', 'remote_file'=>'string', 'fp'=>'resource', 'mode='=>'int', 'startpos='=>'int'], 'ftp_nb_get' => ['int|false', 'stream'=>'resource', 'local_file'=>'string', 'remote_file'=>'string', 'mode='=>'int', 'resume_pos='=>'int'], 'ftp_nb_put' => ['int|false', 'stream'=>'resource', 'remote_file'=>'string', 'local_file'=>'string', 'mode='=>'int', 'startpos='=>'int'], 'ftp_nlist' => ['array|false', 'stream'=>'resource', 'directory'=>'string'], 'ftp_pasv' => ['bool', 'stream'=>'resource', 'pasv'=>'bool'], 'ftp_put' => ['bool', 'stream'=>'resource', 'remote_file'=>'string', 'local_file'=>'string', 'mode='=>'int', 'startpos='=>'int'], 'ftp_pwd' => ['string|false', 'stream'=>'resource'], 'ftp_raw' => ['array', 'stream'=>'resource', 'command'=>'string'], 'ftp_rawlist' => ['array|false', 'stream'=>'resource', 'directory'=>'string', 'recursive='=>'bool'], 'ftp_rename' => ['bool', 'stream'=>'resource', 'src'=>'string', 'dest'=>'string'], 'ftp_rmdir' => ['bool', 'stream'=>'resource', 'directory'=>'string'], 'ftp_set_option' => ['bool', 'stream'=>'resource', 'option'=>'int', 'value'=>'mixed'], 'ftp_site' => ['bool', 'stream'=>'resource', 'cmd'=>'string'], 'ftp_size' => ['int', 'stream'=>'resource', 'filename'=>'string'], 'ftp_ssl_connect' => ['resource|false', 'host'=>'string', 'port='=>'int', 'timeout='=>'int'], 'ftp_systype' => ['string|false', 'stream'=>'resource'], 'ftruncate' => ['bool', 'fp'=>'resource', 'size'=>'0|positive-int'], 'func_get_arg' => ['mixed', 'arg_num'=>'0|positive-int'], 'func_get_args' => ['list<mixed>'], 'func_num_args' => ['0|positive-int'], 'function_exists' => ['bool', 'function_name'=>'string'], 'fwrite' => ['0|positive-int|false', 'fp'=>'resource', 'str'=>'string', 'length='=>'0|positive-int'], 'gc_collect_cycles' => ['int'], 'gc_disable' => ['void'], 'gc_enable' => ['void'], 'gc_enabled' => ['bool'], 'gc_mem_caches' => ['int'], 'gc_status' => ['array{runs:int,collected:int,threshold:int,roots:int}'], 'gd_info' => ['array'], 'gearman_bugreport' => [''], 'gearman_client_add_options' => ['', 'client_object'=>'', 'option'=>''], 'gearman_client_add_server' => ['', 'client_object'=>'', 'host'=>'', 'port'=>''], 'gearman_client_add_servers' => ['', 'client_object'=>'', 'servers'=>''], 'gearman_client_add_task' => ['', 'client_object'=>'', 'function_name'=>'', 'workload'=>'', 'context'=>'', 'unique'=>''], 'gearman_client_add_task_background' => ['', 'client_object'=>'', 'function_name'=>'', 'workload'=>'', 'context'=>'', 'unique'=>''], 'gearman_client_add_task_high' => ['', 'client_object'=>'', 'function_name'=>'', 'workload'=>'', 'context'=>'', 'unique'=>''], 'gearman_client_add_task_high_background' => ['', 'client_object'=>'', 'function_name'=>'', 'workload'=>'', 'context'=>'', 'unique'=>''], 'gearman_client_add_task_low' => ['', 'client_object'=>'', 'function_name'=>'', 'workload'=>'', 'context'=>'', 'unique'=>''], 'gearman_client_add_task_low_background' => ['', 'client_object'=>'', 'function_name'=>'', 'workload'=>'', 'context'=>'', 'unique'=>''], 'gearman_client_add_task_status' => ['', 'client_object'=>'', 'job_handle'=>'', 'context'=>''], 'gearman_client_clear_fn' => ['', 'client_object'=>''], 'gearman_client_clone' => ['', 'client_object'=>''], 'gearman_client_context' => ['', 'client_object'=>''], 'gearman_client_create' => ['', 'client_object'=>''], 'gearman_client_do' => ['', 'client_object'=>'', 'function_name'=>'', 'workload'=>'', 'unique'=>''], 'gearman_client_do_background' => ['', 'client_object'=>'', 'function_name'=>'', 'workload'=>'', 'unique'=>''], 'gearman_client_do_high' => ['', 'client_object'=>'', 'function_name'=>'', 'workload'=>'', 'unique'=>''], 'gearman_client_do_high_background' => ['', 'client_object'=>'', 'function_name'=>'', 'workload'=>'', 'unique'=>''], 'gearman_client_do_job_handle' => ['', 'client_object'=>''], 'gearman_client_do_low' => ['', 'client_object'=>'', 'function_name'=>'', 'workload'=>'', 'unique'=>''], 'gearman_client_do_low_background' => ['', 'client_object'=>'', 'function_name'=>'', 'workload'=>'', 'unique'=>''], 'gearman_client_do_normal' => ['', 'client_object'=>'', 'function_name'=>'string', 'workload'=>'string', 'unique'=>'string'], 'gearman_client_do_status' => ['', 'client_object'=>''], 'gearman_client_echo' => ['', 'client_object'=>'', 'workload'=>''], 'gearman_client_errno' => ['', 'client_object'=>''], 'gearman_client_error' => ['', 'client_object'=>''], 'gearman_client_job_status' => ['', 'client_object'=>'', 'job_handle'=>''], 'gearman_client_options' => ['', 'client_object'=>''], 'gearman_client_remove_options' => ['', 'client_object'=>'', 'option'=>''], 'gearman_client_return_code' => ['', 'client_object'=>''], 'gearman_client_run_tasks' => ['', 'data'=>''], 'gearman_client_set_complete_fn' => ['', 'client_object'=>'', 'callback'=>''], 'gearman_client_set_context' => ['', 'client_object'=>'', 'context'=>''], 'gearman_client_set_created_fn' => ['', 'client_object'=>'', 'callback'=>''], 'gearman_client_set_data_fn' => ['', 'client_object'=>'', 'callback'=>''], 'gearman_client_set_exception_fn' => ['', 'client_object'=>'', 'callback'=>''], 'gearman_client_set_fail_fn' => ['', 'client_object'=>'', 'callback'=>''], 'gearman_client_set_options' => ['', 'client_object'=>'', 'option'=>''], 'gearman_client_set_status_fn' => ['', 'client_object'=>'', 'callback'=>''], 'gearman_client_set_timeout' => ['', 'client_object'=>'', 'timeout'=>''], 'gearman_client_set_warning_fn' => ['', 'client_object'=>'', 'callback'=>''], 'gearman_client_set_workload_fn' => ['', 'client_object'=>'', 'callback'=>''], 'gearman_client_timeout' => ['', 'client_object'=>''], 'gearman_client_wait' => ['', 'client_object'=>''], 'gearman_job_function_name' => ['', 'job_object'=>''], 'gearman_job_handle' => ['string'], 'gearman_job_return_code' => ['', 'job_object'=>''], 'gearman_job_send_complete' => ['', 'job_object'=>'', 'result'=>''], 'gearman_job_send_data' => ['', 'job_object'=>'', 'data'=>''], 'gearman_job_send_exception' => ['', 'job_object'=>'', 'exception'=>''], 'gearman_job_send_fail' => ['', 'job_object'=>''], 'gearman_job_send_status' => ['', 'job_object'=>'', 'numerator'=>'', 'denominator'=>''], 'gearman_job_send_warning' => ['', 'job_object'=>'', 'warning'=>''], 'gearman_job_status' => ['array', 'job_handle'=>'string'], 'gearman_job_unique' => ['', 'job_object'=>''], 'gearman_job_workload' => ['', 'job_object'=>''], 'gearman_job_workload_size' => ['', 'job_object'=>''], 'gearman_task_data' => ['', 'task_object'=>''], 'gearman_task_data_size' => ['', 'task_object'=>''], 'gearman_task_denominator' => ['', 'task_object'=>''], 'gearman_task_function_name' => ['', 'task_object'=>''], 'gearman_task_is_known' => ['', 'task_object'=>''], 'gearman_task_is_running' => ['', 'task_object'=>''], 'gearman_task_job_handle' => ['', 'task_object'=>''], 'gearman_task_numerator' => ['', 'task_object'=>''], 'gearman_task_recv_data' => ['', 'task_object'=>'', 'data_len'=>''], 'gearman_task_return_code' => ['', 'task_object'=>''], 'gearman_task_send_workload' => ['', 'task_object'=>'', 'data'=>''], 'gearman_task_unique' => ['', 'task_object'=>''], 'gearman_verbose_name' => ['', 'verbose'=>''], 'gearman_version' => [''], 'gearman_worker_add_function' => ['', 'worker_object'=>'', 'function_name'=>'', 'function'=>'', 'data'=>'', 'timeout'=>''], 'gearman_worker_add_options' => ['', 'worker_object'=>'', 'option'=>''], 'gearman_worker_add_server' => ['', 'worker_object'=>'', 'host'=>'', 'port'=>''], 'gearman_worker_add_servers' => ['', 'worker_object'=>'', 'servers'=>''], 'gearman_worker_clone' => ['', 'worker_object'=>''], 'gearman_worker_create' => [''], 'gearman_worker_echo' => ['', 'worker_object'=>'', 'workload'=>''], 'gearman_worker_errno' => ['', 'worker_object'=>''], 'gearman_worker_error' => ['', 'worker_object'=>''], 'gearman_worker_grab_job' => ['', 'worker_object'=>''], 'gearman_worker_options' => ['', 'worker_object'=>''], 'gearman_worker_register' => ['', 'worker_object'=>'', 'function_name'=>'', 'timeout'=>''], 'gearman_worker_remove_options' => ['', 'worker_object'=>'', 'option'=>''], 'gearman_worker_return_code' => ['', 'worker_object'=>''], 'gearman_worker_set_options' => ['', 'worker_object'=>'', 'option'=>''], 'gearman_worker_set_timeout' => ['', 'worker_object'=>'', 'timeout'=>''], 'gearman_worker_timeout' => ['', 'worker_object'=>''], 'gearman_worker_unregister' => ['', 'worker_object'=>'', 'function_name'=>''], 'gearman_worker_unregister_all' => ['', 'worker_object'=>''], 'gearman_worker_wait' => ['', 'worker_object'=>''], 'gearman_worker_work' => ['', 'worker_object'=>''], 'GearmanClient::__construct' => ['void'], 'GearmanClient::addOptions' => ['bool', 'options'=>'int'], 'GearmanClient::addServer' => ['bool', 'host='=>'string', 'port='=>'int'], 'GearmanClient::addServers' => ['bool', 'servers='=>'string'], 'GearmanClient::addTask' => ['GearmanTask', 'function_name'=>'string', 'workload'=>'string', 'context='=>'mixed', 'unique='=>'string'], 'GearmanClient::addTaskBackground' => ['GearmanTask', 'function_name'=>'string', 'workload'=>'string', 'context='=>'mixed', 'unique='=>'string'], 'GearmanClient::addTaskHigh' => ['GearmanTask', 'function_name'=>'string', 'workload'=>'string', 'context='=>'mixed', 'unique='=>'string'], 'GearmanClient::addTaskHighBackground' => ['GearmanTask', 'function_name'=>'string', 'workload'=>'string', 'context='=>'mixed', 'unique='=>'string'], 'GearmanClient::addTaskLow' => ['GearmanTask', 'function_name'=>'string', 'workload'=>'string', 'context='=>'mixed', 'unique='=>'string'], 'GearmanClient::addTaskLowBackground' => ['GearmanTask', 'function_name'=>'string', 'workload'=>'string', 'context='=>'mixed', 'unique='=>'string'], 'GearmanClient::addTaskStatus' => ['GearmanTask', 'job_handle'=>'string', 'context='=>'string'], 'GearmanClient::clearCallbacks' => ['bool'], 'GearmanClient::clone' => ['GearmanClient'], 'GearmanClient::context' => ['string'], 'GearmanClient::data' => ['string'], 'GearmanClient::do' => ['string', 'function_name'=>'string', 'workload'=>'string', 'unique='=>'string'], 'GearmanClient::doBackground' => ['string', 'function_name'=>'string', 'workload'=>'string', 'unique='=>'string'], 'GearmanClient::doHigh' => ['string', 'function_name'=>'string', 'workload'=>'string', 'unique='=>'string'], 'GearmanClient::doHighBackground' => ['string', 'function_name'=>'string', 'workload'=>'string', 'unique='=>'string'], 'GearmanClient::doJobHandle' => ['string'], 'GearmanClient::doLow' => ['string', 'function_name'=>'string', 'workload'=>'string', 'unique='=>'string'], 'GearmanClient::doLowBackground' => ['string', 'function_name'=>'string', 'workload'=>'string', 'unique='=>'string'], 'GearmanClient::doNormal' => ['string', 'function_name'=>'string', 'workload'=>'string', 'unique='=>'string'], 'GearmanClient::doStatus' => ['array'], 'GearmanClient::echo' => ['bool', 'workload'=>'string'], 'GearmanClient::error' => ['string'], 'GearmanClient::getErrno' => ['int'], 'GearmanClient::jobStatus' => ['array', 'job_handle'=>'string'], 'GearmanClient::options' => [''], 'GearmanClient::ping' => ['bool', 'workload'=>'string'], 'GearmanClient::removeOptions' => ['bool', 'options'=>'int'], 'GearmanClient::returnCode' => ['int'], 'GearmanClient::runTasks' => ['bool'], 'GearmanClient::setClientCallback' => ['void', 'callback'=>'callable'], 'GearmanClient::setCompleteCallback' => ['bool', 'callback'=>'callable'], 'GearmanClient::setContext' => ['bool', 'context'=>'string'], 'GearmanClient::setCreatedCallback' => ['bool', 'callback'=>'string'], 'GearmanClient::setData' => ['bool', 'data'=>'string'], 'GearmanClient::setDataCallback' => ['bool', 'callback'=>'callable'], 'GearmanClient::setExceptionCallback' => ['bool', 'callback'=>'callable'], 'GearmanClient::setFailCallback' => ['bool', 'callback'=>'callable'], 'GearmanClient::setOptions' => ['bool', 'options'=>'int'], 'GearmanClient::setStatusCallback' => ['bool', 'callback'=>'callable'], 'GearmanClient::setTimeout' => ['bool', 'timeout'=>'int'], 'GearmanClient::setWarningCallback' => ['bool', 'callback'=>'callable'], 'GearmanClient::setWorkloadCallback' => ['bool', 'callback'=>'callable'], 'GearmanClient::timeout' => ['int'], 'GearmanClient::wait' => [''], 'GearmanJob::__construct' => ['void'], 'GearmanJob::complete' => ['bool', 'result'=>'string'], 'GearmanJob::data' => ['bool', 'data'=>'string'], 'GearmanJob::exception' => ['bool', 'exception'=>'string'], 'GearmanJob::fail' => ['bool'], 'GearmanJob::functionName' => ['string'], 'GearmanJob::handle' => ['string'], 'GearmanJob::returnCode' => ['int'], 'GearmanJob::sendComplete' => ['bool', 'result'=>'string'], 'GearmanJob::sendData' => ['bool', 'data'=>'string'], 'GearmanJob::sendException' => ['bool', 'exception'=>'string'], 'GearmanJob::sendFail' => ['bool'], 'GearmanJob::sendStatus' => ['bool', 'numerator'=>'int', 'denominator'=>'int'], 'GearmanJob::sendWarning' => ['bool', 'warning'=>'string'], 'GearmanJob::setReturn' => ['bool', 'gearman_return_t'=>'string'], 'GearmanJob::status' => ['bool', 'numerator'=>'int', 'denominator'=>'int'], 'GearmanJob::unique' => ['string'], 'GearmanJob::warning' => ['bool', 'warning'=>'string'], 'GearmanJob::workload' => ['string'], 'GearmanJob::workloadSize' => ['int'], 'GearmanTask::__construct' => ['void'], 'GearmanTask::create' => ['GearmanTask'], 'GearmanTask::data' => ['string'], 'GearmanTask::dataSize' => ['int'], 'GearmanTask::function' => ['string'], 'GearmanTask::functionName' => ['string'], 'GearmanTask::isKnown' => ['bool'], 'GearmanTask::isRunning' => ['bool'], 'GearmanTask::jobHandle' => ['string'], 'GearmanTask::recvData' => ['array', 'data_len'=>'int'], 'GearmanTask::returnCode' => ['int'], 'GearmanTask::sendData' => ['int', 'data'=>'string'], 'GearmanTask::sendWorkload' => ['int', 'data'=>'string'], 'GearmanTask::taskDenominator' => ['int'], 'GearmanTask::taskNumerator' => ['int'], 'GearmanTask::unique' => ['string'], 'GearmanTask::uuid' => ['string'], 'GearmanWorker::__construct' => ['void'], 'GearmanWorker::addFunction' => ['bool', 'function_name'=>'string', 'function'=>'callable', 'context='=>'mixed', 'timeout='=>'int'], 'GearmanWorker::addOptions' => ['bool', 'option'=>'int'], 'GearmanWorker::addServer' => ['bool', 'host='=>'string', 'port='=>'int'], 'GearmanWorker::addServers' => ['bool', 'servers'=>'string'], 'GearmanWorker::clone' => ['void'], 'GearmanWorker::echo' => ['bool', 'workload'=>'string'], 'GearmanWorker::error' => ['string'], 'GearmanWorker::getErrno' => ['int'], 'GearmanWorker::grabJob' => [''], 'GearmanWorker::options' => ['int'], 'GearmanWorker::register' => ['bool', 'function_name'=>'string', 'timeout='=>'int'], 'GearmanWorker::removeOptions' => ['bool', 'option'=>'int'], 'GearmanWorker::returnCode' => ['int'], 'GearmanWorker::setId' => ['bool', 'id'=>'string'], 'GearmanWorker::setOptions' => ['bool', 'option'=>'int'], 'GearmanWorker::setTimeout' => ['bool', 'timeout'=>'int'], 'GearmanWorker::timeout' => ['int'], 'GearmanWorker::unregister' => ['bool', 'function_name'=>'string'], 'GearmanWorker::unregisterAll' => ['bool'], 'GearmanWorker::wait' => ['bool'], 'GearmanWorker::work' => ['bool'], 'Gender\Gender::__construct' => ['void', 'dsn='=>'string'], 'Gender\Gender::connect' => ['bool', 'dsn'=>'string'], 'Gender\Gender::country' => ['array', 'country'=>'int'], 'Gender\Gender::get' => ['int', 'name'=>'string', 'country='=>'int'], 'Gender\Gender::isNick' => ['array', 'name0'=>'string', 'name1'=>'string', 'country='=>'int'], 'Gender\Gender::similarNames' => ['array', 'name'=>'string', 'country='=>'int'], 'Generator::__wakeup' => ['void'], 'Generator::current' => ['mixed'], 'Generator::getReturn' => ['mixed'], 'Generator::key' => ['mixed'], 'Generator::next' => ['void'], 'Generator::rewind' => ['void'], 'Generator::send' => ['mixed', 'value'=>'mixed'], 'Generator::throw' => ['mixed', 'exception'=>'Exception|Throwable'], 'Generator::valid' => ['bool'], 'geoip_asnum_by_name' => ['string', 'hostname'=>'string'], 'geoip_continent_code_by_name' => ['string', 'hostname'=>'string'], 'geoip_country_code3_by_name' => ['string', 'hostname'=>'string'], 'geoip_country_code_by_name' => ['string', 'hostname'=>'string'], 'geoip_country_name_by_name' => ['string', 'hostname'=>'string'], 'geoip_database_info' => ['string', 'database='=>'int'], 'geoip_db_avail' => ['bool', 'database'=>'int'], 'geoip_db_filename' => ['string', 'database'=>'int'], 'geoip_db_get_all_info' => ['array'], 'geoip_domain_by_name' => ['string', 'hostname'=>'string'], 'geoip_id_by_name' => ['int', 'hostname'=>'string'], 'geoip_isp_by_name' => ['string', 'hostname'=>'string'], 'geoip_netspeedcell_by_name' => ['string', 'hostname'=>'string'], 'geoip_org_by_name' => ['string', 'hostname'=>'string'], 'geoip_record_by_name' => ['array', 'hostname'=>'string'], 'geoip_region_by_name' => ['array', 'hostname'=>'string'], 'geoip_region_name_by_code' => ['string', 'country_code'=>'string', 'region_code'=>'string'], 'geoip_setup_custom_directory' => ['void', 'path'=>'string'], 'geoip_time_zone_by_country_and_region' => ['string|false', 'country_code'=>'string', 'region_code='=>'string'], 'get_browser' => ['mixed', 'browser_name='=>'string', 'return_array='=>'bool'], 'get_call_stack' => [''], 'get_called_class' => ['class-string'], 'get_cfg_var' => ['mixed', 'option_name'=>'string'], 'get_class' => ['class-string', 'object='=>'object'], 'get_class_methods' => ['list<non-falsy-string>', 'class'=>'mixed'], 'get_class_vars' => ['array', 'class_name'=>'string'], 'get_current_user' => ['string'], 'get_declared_classes' => ['list<class-string>'], 'get_declared_interfaces' => ['list<interface-string>'], 'get_declared_traits' => ['list<trait-string>'], 'get_defined_constants' => ['array<string, mixed>', 'categorize='=>'bool'], 'get_defined_functions' => ['array{internal:non-empty-list<callable-string>,user:list<callable-string>}', 'exclude_disabled='=>'bool'], 'get_defined_vars' => ['array<string, mixed>'], 'get_extension_funcs' => ['list<callable-string>|false', 'extension_name'=>'string'], 'get_headers' => ['array|false', 'url'=>'string', 'format='=>'int', 'context='=>'resource'], 'get_html_translation_table' => ['array', 'table='=>'int', 'flags='=>'int', 'encoding='=>'string'], 'get_include_path' => ['__benevolent<string|false>'], 'get_included_files' => ['list<string>'], 'get_loaded_extensions' => ['list<string>', 'zend_extensions='=>'bool'], 'get_magic_quotes_gpc' => ['false'], 'get_magic_quotes_runtime' => ['false'], 'get_meta_tags' => ['array|false', 'filename'=>'string', 'use_include_path='=>'bool'], 'get_object_vars' => ['array<string, mixed>', 'obj'=>'object'], 'get_parent_class' => ['class-string|false', 'object='=>'mixed'], 'get_required_files' => ['list<string>'], 'get_resource_type' => ['string', 'res'=>'resource'], 'get_resources' => ['array<int, resource>', 'type='=>'string'], 'getallheaders' => ['array'], 'getcwd' => ['non-empty-string|false'], 'getdate' => ['array{seconds: int<0, 59>, minutes: int<0, 59>, hours: int<0, 23>, mday: int<1, 31>, wday: int<0, 6>, mon: int<1, 12>, year: int, yday: int<0, 365>, weekday: "Monday"|"Tuesday"|"Wednesday"|"Thursday"|"Friday"|"Saturday"|"Sunday", month: "January"|"February"|"March"|"April"|"May"|"June"|"July"|"August"|"September"|"October"|"November"|"December", 0: int}', 'timestamp='=>'int'], 'getenv' => ['string|false', 'varname'=>'string', 'local_only='=>'bool'], 'getenv\'1' => ['array<string, string>'], 'gethostbyaddr' => ['string|false', 'ip_address'=>'string'], 'gethostbyname' => ['string', 'hostname'=>'string'], 'gethostbynamel' => ['list<string>|false', 'hostname'=>'string'], 'gethostname' => ['string|false'], 'getimagesize' => ['array{0: 0|positive-int, 1: 0|positive-int, 2: int, 3: string, mime: string, channels?: int, bits?: int}|false', 'imagefile'=>'string', '&w_info='=>'array'], 'getimagesizefromstring' => ['array{0: 0|positive-int, 1: 0|positive-int, 2: int, 3: string, mime: string, channels?: int, bits?: int}|false', 'data'=>'string', '&w_info='=>'array'], 'getlastmod' => ['int|false'], 'getmxrr' => ['bool', 'hostname'=>'string', '&w_mxhosts'=>'array', '&w_weight='=>'array'], 'getmygid' => ['int|false'], 'getmyinode' => ['int|false'], 'getmypid' => ['int|false'], 'getmyuid' => ['int|false'], 'getopt' => ['__benevolent<array<string,string>|array<string,false>|array<string,list<mixed>>|false>', 'options'=>'string', 'longopts='=>'array', '&w_optind='=>'int'], 'getprotobyname' => ['int|false', 'name'=>'string'], 'getprotobynumber' => ['string|false', 'proto'=>'int'], 'getrandmax' => ['int'], 'getrusage' => ['array|false', 'who='=>'int'], 'getservbyname' => ['int|false', 'service'=>'string', 'protocol'=>'string'], 'getservbyport' => ['string|false', 'port'=>'int', 'protocol'=>'string'], 'gettext' => ['string', 'msgid'=>'string'], 'gettimeofday' => ['array|float', 'get_as_float='=>'bool'], 'gettype' => ['string', 'var'=>'mixed'], 'glob' => ['list<string>|false', 'pattern'=>'string', 'flags='=>'int'], 'GlobIterator::__construct' => ['void', 'path'=>'string', 'flags='=>'int'], 'GlobIterator::cont' => ['int'], 'GlobIterator::count' => ['0|positive-int'], 'Gmagick::__construct' => ['void', 'filename='=>'string'], 'Gmagick::addimage' => ['Gmagick', 'gmagick'=>'gmagick'], 'Gmagick::addnoiseimage' => ['Gmagick', 'noise'=>'int'], 'Gmagick::annotateimage' => ['Gmagick', 'gmagickdraw'=>'gmagickdraw', 'x'=>'float', 'y'=>'float', 'angle'=>'float', 'text'=>'string'], 'Gmagick::blurimage' => ['Gmagick', 'radius'=>'float', 'sigma'=>'float', 'channel='=>'int'], 'Gmagick::borderimage' => ['Gmagick', 'color'=>'gmagickpixel', 'width'=>'int', 'height'=>'int'], 'Gmagick::charcoalimage' => ['Gmagick', 'radius'=>'float', 'sigma'=>'float'], 'Gmagick::chopimage' => ['Gmagick', 'width'=>'int', 'height'=>'int', 'x'=>'int', 'y'=>'int'], 'Gmagick::clear' => ['Gmagick'], 'Gmagick::commentimage' => ['Gmagick', 'comment'=>'string'], 'Gmagick::compositeimage' => ['Gmagick', 'source'=>'gmagick', 'compose'=>'int', 'x'=>'int', 'y'=>'int'], 'Gmagick::cropimage' => ['Gmagick', 'width'=>'int', 'height'=>'int', 'x'=>'int', 'y'=>'int'], 'Gmagick::cropthumbnailimage' => ['Gmagick', 'width'=>'int', 'height'=>'int'], 'Gmagick::current' => ['Gmagick'], 'Gmagick::cyclecolormapimage' => ['Gmagick', 'displace'=>'int'], 'Gmagick::deconstructimages' => ['Gmagick'], 'Gmagick::despeckleimage' => ['Gmagick'], 'Gmagick::destroy' => ['bool'], 'Gmagick::drawimage' => ['Gmagick', 'gmagickdraw'=>'gmagickdraw'], 'Gmagick::edgeimage' => ['Gmagick', 'radius'=>'float'], 'Gmagick::embossimage' => ['Gmagick', 'radius'=>'float', 'sigma'=>'float'], 'Gmagick::enhanceimage' => ['Gmagick'], 'Gmagick::equalizeimage' => ['Gmagick'], 'Gmagick::flipimage' => ['Gmagick'], 'Gmagick::flopimage' => ['Gmagick'], 'Gmagick::frameimage' => ['Gmagick', 'color'=>'gmagickpixel', 'width'=>'int', 'height'=>'int', 'inner_bevel'=>'int', 'outer_bevel'=>'int'], 'Gmagick::gammaimage' => ['Gmagick', 'gamma'=>'float'], 'Gmagick::getcopyright' => ['string'], 'Gmagick::getfilename' => ['string'], 'Gmagick::getimagebackgroundcolor' => ['GmagickPixel'], 'Gmagick::getimageblueprimary' => ['array'], 'Gmagick::getimagebordercolor' => ['GmagickPixel'], 'Gmagick::getimagechanneldepth' => ['int', 'channel_type'=>'int'], 'Gmagick::getimagecolors' => ['int'], 'Gmagick::getimagecolorspace' => ['int'], 'Gmagick::getimagecompose' => ['int'], 'Gmagick::getimagedelay' => ['int'], 'Gmagick::getimagedepth' => ['int'], 'Gmagick::getimagedispose' => ['int'], 'Gmagick::getimageextrema' => ['array'], 'Gmagick::getimagefilename' => ['string'], 'Gmagick::getimageformat' => ['string'], 'Gmagick::getimagegamma' => ['float'], 'Gmagick::getimagegreenprimary' => ['array'], 'Gmagick::getimageheight' => ['int'], 'Gmagick::getimagehistogram' => ['array'], 'Gmagick::getimageindex' => ['int'], 'Gmagick::getimageinterlacescheme' => ['int'], 'Gmagick::getimageiterations' => ['int'], 'Gmagick::getimagematte' => ['int'], 'Gmagick::getimagemattecolor' => ['GmagickPixel'], 'Gmagick::getimageprofile' => ['string', 'name'=>'string'], 'Gmagick::getimageredprimary' => ['array'], 'Gmagick::getimagerenderingintent' => ['int'], 'Gmagick::getimageresolution' => ['array'], 'Gmagick::getimagescene' => ['int'], 'Gmagick::getimagesignature' => ['string'], 'Gmagick::getimagetype' => ['int'], 'Gmagick::getimageunits' => ['int'], 'Gmagick::getimagewhitepoint' => ['array'], 'Gmagick::getimagewidth' => ['int'], 'Gmagick::getpackagename' => ['string'], 'Gmagick::getquantumdepth' => ['array'], 'Gmagick::getreleasedate' => ['string'], 'Gmagick::getsamplingfactors' => ['array'], 'Gmagick::getsize' => ['array'], 'Gmagick::getversion' => ['array'], 'Gmagick::hasnextimage' => ['bool'], 'Gmagick::haspreviousimage' => ['bool'], 'Gmagick::implodeimage' => ['mixed', 'radius'=>'float'], 'Gmagick::labelimage' => ['mixed', 'label'=>'string'], 'Gmagick::levelimage' => ['mixed', 'blackpoint'=>'float', 'gamma'=>'float', 'whitepoint'=>'float', 'channel='=>'int'], 'Gmagick::magnifyimage' => ['mixed'], 'Gmagick::mapimage' => ['Gmagick', 'gmagick'=>'gmagick', 'dither'=>'bool'], 'Gmagick::medianfilterimage' => ['void', 'radius'=>'float'], 'Gmagick::minifyimage' => ['Gmagick'], 'Gmagick::modulateimage' => ['Gmagick', 'brightness'=>'float', 'saturation'=>'float', 'hue'=>'float'], 'Gmagick::motionblurimage' => ['Gmagick', 'radius'=>'float', 'sigma'=>'float', 'angle'=>'float'], 'Gmagick::newimage' => ['Gmagick', 'width'=>'int', 'height'=>'int', 'background'=>'string', 'format='=>'string'], 'Gmagick::nextimage' => ['bool'], 'Gmagick::normalizeimage' => ['Gmagick', 'channel='=>'int'], 'Gmagick::oilpaintimage' => ['Gmagick', 'radius'=>'float'], 'Gmagick::previousimage' => ['bool'], 'Gmagick::profileimage' => ['Gmagick', 'name'=>'string', 'profile'=>'string'], 'Gmagick::quantizeimage' => ['Gmagick', 'numcolors'=>'int', 'colorspace'=>'int', 'treedepth'=>'int', 'dither'=>'bool', 'measureerror'=>'bool'], 'Gmagick::quantizeimages' => ['Gmagick', 'numcolors'=>'int', 'colorspace'=>'int', 'treedepth'=>'int', 'dither'=>'bool', 'measureerror'=>'bool'], 'Gmagick::queryfontmetrics' => ['array', 'draw'=>'gmagickdraw', 'text'=>'string'], 'Gmagick::queryfonts' => ['array', 'pattern='=>'string'], 'Gmagick::queryformats' => ['array', 'pattern='=>'string'], 'Gmagick::radialblurimage' => ['Gmagick', 'angle'=>'float', 'channel='=>'int'], 'Gmagick::raiseimage' => ['Gmagick', 'width'=>'int', 'height'=>'int', 'x'=>'int', 'y'=>'int', 'raise'=>'bool'], 'Gmagick::read' => ['Gmagick', 'filename'=>'string'], 'Gmagick::readimage' => ['Gmagick', 'filename'=>'string'], 'Gmagick::readimageblob' => ['Gmagick', 'imagecontents'=>'string', 'filename='=>'string'], 'Gmagick::readimagefile' => ['Gmagick', 'fp'=>'resource', 'filename='=>'string'], 'Gmagick::reducenoiseimage' => ['Gmagick', 'radius'=>'float'], 'Gmagick::removeimage' => ['Gmagick'], 'Gmagick::removeimageprofile' => ['string', 'name'=>'string'], 'Gmagick::resampleimage' => ['Gmagick', 'xresolution'=>'float', 'yresolution'=>'float', 'filter'=>'int', 'blur'=>'float'], 'Gmagick::resizeimage' => ['Gmagick', 'width'=>'int', 'height'=>'int', 'filter'=>'int', 'blur'=>'float', 'fit='=>'bool'], 'Gmagick::rollimage' => ['Gmagick', 'x'=>'int', 'y'=>'int'], 'Gmagick::rotateimage' => ['Gmagick', 'color'=>'mixed', 'degrees'=>'float'], 'Gmagick::scaleimage' => ['Gmagick', 'width'=>'int', 'height'=>'int', 'fit='=>'bool'], 'Gmagick::separateimagechannel' => ['Gmagick', 'channel'=>'int'], 'Gmagick::setCompressionQuality' => ['Gmagick', 'quality'=>'int'], 'Gmagick::setfilename' => ['Gmagick', 'filename'=>'string'], 'Gmagick::setimagebackgroundcolor' => ['Gmagick', 'color'=>'gmagickpixel'], 'Gmagick::setimageblueprimary' => ['Gmagick', 'x'=>'float', 'y'=>'float'], 'Gmagick::setimagebordercolor' => ['Gmagick', 'color'=>'gmagickpixel'], 'Gmagick::setimagechanneldepth' => ['Gmagick', 'channel'=>'int', 'depth'=>'int'], 'Gmagick::setimagecolorspace' => ['Gmagick', 'colorspace'=>'int'], 'Gmagick::setimagecompose' => ['Gmagick', 'composite'=>'int'], 'Gmagick::setimagedelay' => ['Gmagick', 'delay'=>'int'], 'Gmagick::setimagedepth' => ['Gmagick', 'depth'=>'int'], 'Gmagick::setimagedispose' => ['Gmagick', 'disposetype'=>'int'], 'Gmagick::setimagefilename' => ['Gmagick', 'filename'=>'string'], 'Gmagick::setimageformat' => ['Gmagick', 'imageformat'=>'string'], 'Gmagick::setimagegamma' => ['Gmagick', 'gamma'=>'float'], 'Gmagick::setimagegreenprimary' => ['Gmagick', 'x'=>'float', 'y'=>'float'], 'Gmagick::setimageindex' => ['Gmagick', 'index'=>'int'], 'Gmagick::setimageinterlacescheme' => ['Gmagick', 'interlace'=>'int'], 'Gmagick::setimageiterations' => ['Gmagick', 'iterations'=>'int'], 'Gmagick::setimageprofile' => ['Gmagick', 'name'=>'string', 'profile'=>'string'], 'Gmagick::setimageredprimary' => ['Gmagick', 'x'=>'float', 'y'=>'float'], 'Gmagick::setimagerenderingintent' => ['Gmagick', 'rendering_intent'=>'int'], 'Gmagick::setimageresolution' => ['Gmagick', 'xresolution'=>'float', 'yresolution'=>'float'], 'Gmagick::setimagescene' => ['Gmagick', 'scene'=>'int'], 'Gmagick::setimagetype' => ['Gmagick', 'imgtype'=>'int'], 'Gmagick::setimageunits' => ['Gmagick', 'resolution'=>'int'], 'Gmagick::setimagewhitepoint' => ['Gmagick', 'x'=>'float', 'y'=>'float'], 'Gmagick::setsamplingfactors' => ['Gmagick', 'factors'=>'array'], 'Gmagick::setsize' => ['Gmagick', 'columns'=>'int', 'rows'=>'int'], 'Gmagick::shearimage' => ['Gmagick', 'color'=>'mixed', 'xshear'=>'float', 'yshear'=>'float'], 'Gmagick::solarizeimage' => ['Gmagick', 'threshold'=>'int'], 'Gmagick::spreadimage' => ['Gmagick', 'radius'=>'float'], 'Gmagick::stripimage' => ['Gmagick'], 'Gmagick::swirlimage' => ['Gmagick', 'degrees'=>'float'], 'Gmagick::thumbnailimage' => ['Gmagick', 'width'=>'int', 'height'=>'int', 'fit='=>'bool'], 'Gmagick::trimimage' => ['Gmagick', 'fuzz'=>'float'], 'Gmagick::write' => ['', 'filename'=>'string'], 'Gmagick::writeimage' => ['Gmagick', 'filename'=>'string', 'all_frames='=>'bool'], 'GmagickDraw::annotate' => ['GmagickDraw', 'x'=>'float', 'y'=>'float', 'text'=>'string'], 'GmagickDraw::arc' => ['GmagickDraw', 'sx'=>'float', 'sy'=>'float', 'ex'=>'float', 'ey'=>'float', 'sd'=>'float', 'ed'=>'float'], 'GmagickDraw::bezier' => ['GmagickDraw', 'coordinate_array'=>'array'], 'GmagickDraw::ellipse' => ['GmagickDraw', 'ox'=>'float', 'oy'=>'float', 'rx'=>'float', 'ry'=>'float', 'start'=>'float', 'end'=>'float'], 'GmagickDraw::getfillcolor' => ['GmagickPixel'], 'GmagickDraw::getfillopacity' => ['float'], 'GmagickDraw::getfont' => ['string'], 'GmagickDraw::getfontsize' => ['float'], 'GmagickDraw::getfontstyle' => ['int'], 'GmagickDraw::getfontweight' => ['int'], 'GmagickDraw::getstrokecolor' => ['GmagickPixel'], 'GmagickDraw::getstrokeopacity' => ['float'], 'GmagickDraw::getstrokewidth' => ['float'], 'GmagickDraw::gettextdecoration' => ['int'], 'GmagickDraw::gettextencoding' => ['string'], 'GmagickDraw::line' => ['GmagickDraw', 'sx'=>'float', 'sy'=>'float', 'ex'=>'float', 'ey'=>'float'], 'GmagickDraw::point' => ['GmagickDraw', 'x'=>'float', 'y'=>'float'], 'GmagickDraw::polygon' => ['GmagickDraw', 'coordinates'=>'array'], 'GmagickDraw::polyline' => ['GmagickDraw', 'coordinate_array'=>'array'], 'GmagickDraw::rectangle' => ['GmagickDraw', 'x1'=>'float', 'y1'=>'float', 'x2'=>'float', 'y2'=>'float'], 'GmagickDraw::rotate' => ['GmagickDraw', 'degrees'=>'float'], 'GmagickDraw::roundrectangle' => ['GmagickDraw', 'x1'=>'float', 'y1'=>'float', 'x2'=>'float', 'y2'=>'float', 'rx'=>'float', 'ry'=>'float'], 'GmagickDraw::scale' => ['GmagickDraw', 'x'=>'float', 'y'=>'float'], 'GmagickDraw::setfillcolor' => ['GmagickDraw', 'color'=>'string'], 'GmagickDraw::setfillopacity' => ['GmagickDraw', 'fill_opacity'=>'float'], 'GmagickDraw::setfont' => ['GmagickDraw', 'font'=>'string'], 'GmagickDraw::setfontsize' => ['GmagickDraw', 'pointsize'=>'float'], 'GmagickDraw::setfontstyle' => ['GmagickDraw', 'style'=>'int'], 'GmagickDraw::setfontweight' => ['GmagickDraw', 'weight'=>'int'], 'GmagickDraw::setstrokecolor' => ['GmagickDraw', 'color'=>'gmagickpixel'], 'GmagickDraw::setstrokeopacity' => ['GmagickDraw', 'stroke_opacity'=>'float'], 'GmagickDraw::setstrokewidth' => ['GmagickDraw', 'width'=>'float'], 'GmagickDraw::settextdecoration' => ['GmagickDraw', 'decoration'=>'int'], 'GmagickDraw::settextencoding' => ['GmagickDraw', 'encoding'=>'string'], 'GmagickPixel::__construct' => ['void', 'color='=>'string'], 'GmagickPixel::getcolor' => ['mixed', 'as_array='=>'bool', 'normalize_array='=>'bool'], 'GmagickPixel::getcolorcount' => ['int'], 'GmagickPixel::getcolorvalue' => ['float', 'color'=>'int'], 'GmagickPixel::setcolor' => ['GmagickPixel', 'color'=>'string'], 'GmagickPixel::setcolorvalue' => ['GmagickPixel', 'color'=>'int', 'value'=>'float'], 'gmdate' => ['string', 'format'=>'string', 'timestamp='=>'int'], 'gmmktime' => ['int|false', 'hour='=>'int', 'min='=>'int', 'sec='=>'int', 'mon='=>'int', 'day='=>'int', 'year='=>'int'], 'GMP::__construct' => ['void'], 'GMP::__toString' => ['string'], 'GMP::serialize' => ['string'], 'GMP::unserialize' => ['void', 'serialized'=>'string'], 'gmp_abs' => ['GMP', 'a'=>'GMP|string|int'], 'gmp_add' => ['GMP', 'a'=>'GMP|string|int', 'b'=>'GMP|string|int'], 'gmp_and' => ['GMP', 'a'=>'GMP|string|int', 'b'=>'GMP|string|int'], 'gmp_binomial' => ['GMP|false', 'n'=>'GMP|string|int', 'k'=>'int'], 'gmp_clrbit' => ['void', 'a'=>'GMP|string|int', 'index'=>'int'], 'gmp_cmp' => ['int', 'a'=>'GMP|string|int', 'b'=>'GMP|string|int'], 'gmp_com' => ['GMP', 'a'=>'GMP|string|int'], 'gmp_div' => ['GMP', 'a'=>'GMP|string|int', 'b'=>'GMP|string|int', 'round='=>'int'], 'gmp_div_q' => ['GMP', 'a'=>'GMP|string|int', 'b'=>'GMP|string|int', 'round='=>'int'], 'gmp_div_qr' => ['array', 'a'=>'GMP|string|int', 'b'=>'GMP|string|int', 'round='=>'int'], 'gmp_div_r' => ['GMP', 'a'=>'GMP|string|int', 'b'=>'GMP|string|int', 'round='=>'int'], 'gmp_divexact' => ['GMP', 'a'=>'GMP|string|int', 'b'=>'GMP|string|int'], 'gmp_export' => ['string', 'gmpnumber'=>'GMP|string|int', 'word_size='=>'int', 'options='=>'int'], 'gmp_fact' => ['GMP', 'a'=>'int'], 'gmp_gcd' => ['GMP', 'a'=>'GMP|string|int', 'b'=>'GMP|string|int'], 'gmp_gcdext' => ['array', 'a'=>'GMP|string|int', 'b'=>'GMP|string|int'], 'gmp_hamdist' => ['int', 'a'=>'GMP|string|int', 'b'=>'GMP|string|int'], 'gmp_import' => ['GMP', 'data'=>'string', 'word_size='=>'int', 'options='=>'int'], 'gmp_init' => ['GMP', 'number'=>'int|string', 'base='=>'int'], 'gmp_intval' => ['int', 'gmpnumber'=>'GMP|string|int'], 'gmp_invert' => ['GMP|false', 'a'=>'GMP|string|int', 'b'=>'GMP|string|int'], 'gmp_jacobi' => ['int', 'a'=>'GMP|string|int', 'b'=>'GMP|string|int'], 'gmp_kronecker' => ['int', 'a'=>'GMP|string|int', 'b'=>'GMP|string|int'], 'gmp_lcm' => ['GMP', 'a'=>'GMP|string|int', 'b'=>'GMP|string|int'], 'gmp_legendre' => ['int', 'a'=>'GMP|string|int', 'b'=>'GMP|string|int'], 'gmp_mod' => ['GMP', 'a'=>'GMP|string|int', 'b'=>'GMP|string|int'], 'gmp_mul' => ['GMP', 'a'=>'GMP|string|int', 'b'=>'GMP|string|int'], 'gmp_neg' => ['GMP', 'a'=>'GMP|string|int'], 'gmp_nextprime' => ['GMP', 'a'=>'GMP|string|int'], 'gmp_or' => ['GMP', 'a'=>'GMP|string|int', 'b'=>'GMP|string|int'], 'gmp_perfect_power' => ['bool', 'a'=>'GMP|string|int'], 'gmp_perfect_square' => ['bool', 'a'=>'GMP|string|int'], 'gmp_popcount' => ['int', 'a'=>'GMP|string|int'], 'gmp_pow' => ['GMP', 'base'=>'GMP|string|int', 'exp'=>'int'], 'gmp_powm' => ['GMP', 'base'=>'GMP|string|int', 'exp'=>'GMP|string|int', 'mod'=>'GMP|string|int'], 'gmp_prob_prime' => ['int', 'a'=>'GMP|string|int', 'reps='=>'int'], 'gmp_random' => ['GMP', 'limiter='=>'int'], 'gmp_random_bits' => ['GMP', 'bits'=>'int'], 'gmp_random_range' => ['GMP', 'min'=>'GMP|string|int', 'max'=>'GMP|string|int'], 'gmp_random_seed' => ['void', 'seed'=>'GMP|string|int'], 'gmp_root' => ['GMP', 'a'=>'GMP|string|int', 'nth'=>'int'], 'gmp_rootrem' => ['array<int,GMP>', 'a'=>'GMP|string|int', 'nth'=>'int'], 'gmp_scan0' => ['int', 'a'=>'GMP|string|int', 'start'=>'int'], 'gmp_scan1' => ['int', 'a'=>'GMP|string|int', 'start'=>'int'], 'gmp_setbit' => ['void', 'a'=>'GMP|string|int', 'index'=>'int', 'set_clear='=>'bool'], 'gmp_sign' => ['int', 'a'=>'GMP|string|int'], 'gmp_sqrt' => ['GMP', 'a'=>'GMP|string|int'], 'gmp_sqrtrem' => ['array', 'a'=>'GMP|string|int'], 'gmp_strval' => ['string', 'gmpnumber'=>'GMP|string|int', 'base='=>'int'], 'gmp_sub' => ['GMP', 'a'=>'GMP|string|int', 'b'=>'GMP|string|int'], 'gmp_testbit' => ['bool', 'a'=>'GMP|string|int', 'index'=>'int'], 'gmp_xor' => ['GMP', 'a'=>'GMP|string|int', 'b'=>'GMP|string|int'], 'gmstrftime' => ['string|false', 'format'=>'string', 'timestamp='=>'int'], 'gnupg::adddecryptkey' => ['bool', 'fingerprint'=>'string', 'passphrase'=>'string'], 'gnupg::addencryptkey' => ['bool', 'fingerprint'=>'string'], 'gnupg::addsignkey' => ['bool', 'fingerprint'=>'string', 'passphrase='=>'string'], 'gnupg::cleardecryptkeys' => ['bool'], 'gnupg::clearencryptkeys' => ['bool'], 'gnupg::clearsignkeys' => ['bool'], 'gnupg::decrypt' => ['string|false', 'text'=>'string'], 'gnupg::deletekey' => ['bool', 'key'=>'string', 'allow_secret'=>'bool'], 'gnupg::decryptverify' => ['array|false', 'text'=>'string', '&plaintext'=>'string'], 'gnupg::encrypt' => ['string|false', 'plaintext'=>'string'], 'gnupg::encryptsign' => ['string|false', 'plaintext'=>'string'], 'gnupg::export' => ['string|false', 'fingerprint'=>'string'], 'gnupg::getengineinfo' => ['array'], 'gnupg::geterror' => ['string|false'], 'gnupg::getprotocol' => ['int'], 'gnupg::gettrustlist' => ['array', 'pattern'=>'string'], 'gnupg::import' => ['array|false', 'keydata'=>'string'], 'gnupg::init' => ['resource', 'options'=>'?array{file_name?:string,home_dir?:string}'], 'gnupg::keyinfo' => ['array|false', 'pattern'=>'string'], 'gnupg::listsignatures' => ['?array', 'keyid'=>'string'], 'gnupg::setarmor' => ['bool', 'armor'=>'int'], 'gnupg::seterrormode' => ['void', 'errormode'=>'int'], 'gnupg::setsignmode' => ['bool', 'signmode'=>'int'], 'gnupg::sign' => ['string|false', 'plaintext'=>'string'], 'gnupg::verify' => ['array|false', 'signed_text'=>'string', 'signature'=>'string|false', '&plaintext='=>'string'], 'gnupg_adddecryptkey' => ['bool', 'identifier'=>'resource', 'fingerprint'=>'string', 'passphrase'=>'string'], 'gnupg_addencryptkey' => ['bool', 'identifier'=>'resource', 'fingerprint'=>'string'], 'gnupg_addsignkey' => ['bool', 'identifier'=>'resource', 'fingerprint'=>'string', 'passphrase='=>'string'], 'gnupg_cleardecryptkeys' => ['bool', 'identifier'=>'resource'], 'gnupg_clearencryptkeys' => ['bool', 'identifier'=>'resource'], 'gnupg_clearsignkeys' => ['bool', 'identifier'=>'resource'], 'gnupg_decrypt' => ['string|false', 'identifier'=>'resource', 'text'=>'string'], 'gnupg_decryptverify' => ['array', 'identifier'=>'resource', 'text'=>'string', 'plaintext'=>'string'], 'gnupg_deletekey' => ['bool', 'identifier'=>'resource', 'key'=>'string', 'allow_secret'=>'bool'], 'gnupg_encrypt' => ['string|false', 'identifier'=>'resource', 'plaintext'=>'string'], 'gnupg_encryptsign' => ['string|false', 'identifier'=>'resource', 'plaintext'=>'string'], 'gnupg_export' => ['string|false', 'identifier'=>'resource', 'fingerprint'=>'string'], 'gnupg_getengineinfo' => ['array', 'identifier'=>'resource'], 'gnupg_geterror' => ['string|false', 'identifier'=>'resource'], 'gnupg_getprotocol' => ['int', 'identifier'=>'resource'], 'gnupg_gettrustlist' => ['array', 'identifier'=>'resource', 'pattern'=>'string'], 'gnupg_import' => ['array|false', 'identifier'=>'resource', 'keydata'=>'string'], 'gnupg_init' => ['resource', 'options='=>'?array{file_name?:string,home_dir?:string}'], 'gnupg_keyinfo' => ['array|false', 'identifier'=>'resource', 'pattern'=>'string'], 'gnupg_listsignatures' => ['?array', 'identifier'=>'resource', 'keyid'=>'string'], 'gnupg_setarmor' => ['bool', 'identifier'=>'resource', 'armor'=>'int'], 'gnupg_seterrormode' => ['void', 'identifier'=>'resource', 'errormode'=>'int'], 'gnupg_setsignmode' => ['bool', 'identifier'=>'resource', 'signmode'=>'int'], 'gnupg_sign' => ['string|false', 'identifier'=>'resource', 'plaintext'=>'string'], 'gnupg_verify' => ['array|false', 'identifier'=>'resource', 'signed_text'=>'string', 'signature'=>'string|false', '&plaintext='=>'string'], 'gopher_parsedir' => ['array', 'dirent'=>'string'], 'grapheme_extract' => ['string|false', 'str'=>'string', 'size'=>'int', 'extract_type='=>'int', 'start='=>'int', '&w_next='=>'int'], 'grapheme_stripos' => ['int|false', 'haystack'=>'string', 'needle'=>'string', 'offset='=>'int'], 'grapheme_stristr' => ['string|false', 'haystack'=>'string', 'needle'=>'string', 'part='=>'bool'], 'grapheme_strlen' => ['0|positive-int|false', 'str'=>'string'], 'grapheme_strpos' => ['int|false', 'haystack'=>'string', 'needle'=>'string', 'offset='=>'int'], 'grapheme_strripos' => ['int|false', 'haystack'=>'string', 'needle'=>'string', 'offset='=>'int'], 'grapheme_strrpos' => ['int|false', 'haystack'=>'string', 'needle'=>'string', 'offset='=>'int'], 'grapheme_strstr' => ['string|false', 'haystack'=>'string', 'needle'=>'string', 'part='=>'bool'], 'grapheme_substr' => ['string|false', 'str'=>'string', 'start'=>'int', 'length='=>'int'], 'gregoriantojd' => ['int', 'month'=>'int', 'day'=>'int', 'year'=>'int'], 'gridObj::set' => ['int', 'property_name'=>'string', 'new_value'=>''], 'Grpc\Call::__construct' => ['void', 'channel'=>'Grpc\Channel', 'method'=>'string', 'absolute_deadline'=>'Grpc\Timeval', 'host_override='=>'mixed'], 'Grpc\Call::cancel' => [''], 'Grpc\Call::getPeer' => ['string'], 'Grpc\Call::setCredentials' => ['int', 'creds_obj'=>'Grpc\CallCredentials'], 'Grpc\Call::startBatch' => ['object', 'batch'=>'array'], 'Grpc\CallCredentials::createComposite' => ['Grpc\CallCredentials', 'cred1'=>'Grpc\CallCredentials', 'cred2'=>'Grpc\CallCredentials'], 'Grpc\CallCredentials::createFromPlugin' => ['Grpc\CallCredentials', 'callback'=>'Closure'], 'Grpc\Channel::__construct' => ['void', 'target'=>'string', 'args='=>'array'], 'Grpc\Channel::close' => [''], 'Grpc\Channel::getConnectivityState' => ['int', 'try_to_connect='=>'bool|false'], 'Grpc\Channel::getTarget' => ['string'], 'Grpc\Channel::watchConnectivityState' => ['bool', 'last_state'=>'int', 'deadline_obj'=>'Grpc\Timeval'], 'Grpc\ChannelCredentials::createComposite' => ['Grpc\ChannelCredentials', 'cred1'=>'Grpc\ChannelCredentials', 'cred2'=>'Grpc\CallCredentials'], 'Grpc\ChannelCredentials::createDefault' => ['Grpc\ChannelCredentials'], 'Grpc\ChannelCredentials::createInsecure' => ['null'], 'Grpc\ChannelCredentials::createSsl' => ['Grpc\ChannelCredentials', 'pem_root_certs='=>'string|null', 'pem_private_key='=>'string|null', 'pem_cert_chain='=>'string|null'], 'Grpc\ChannelCredentials::setDefaultRootsPem' => ['', 'pem_roots'=>'string'], 'Grpc\Server::__construct' => ['void', 'args'=>'array'], 'Grpc\Server::addHttp2Port' => ['bool', 'addr'=>'string'], 'Grpc\Server::addSecureHttp2Port' => ['bool', 'addr'=>'string', 'creds_obj'=>'Grpc\ServerCredentials'], 'Grpc\Server::requestCall' => ['', 'tag_new'=>'int', 'tag_cancel'=>'int'], 'Grpc\Server::start' => [''], 'Grpc\ServerCredentials::createSsl' => ['object', 'pem_root_certs'=>'string', 'pem_private_key'=>'string', 'pem_cert_chain'=>'string'], 'Grpc\Timeval::__construct' => ['void', 'usec'=>'int'], 'Grpc\Timeval::add' => ['Grpc\Timeval', 'other'=>'Grpc\Timeval'], 'Grpc\Timeval::compare' => ['int', 'a'=>'Grpc\Timeval', 'b'=>'Grpc\Timeval'], 'Grpc\Timeval::infFuture' => ['Grpc\Timeval'], 'Grpc\Timeval::infPast' => ['Grpc\Timeval'], 'Grpc\Timeval::now' => ['Grpc\Timeval'], 'Grpc\Timeval::similar' => ['bool', 'a'=>'Grpc\Timeval', 'b'=>'Grpc\Timeval', 'threshold'=>'Grpc\Timeval'], 'Grpc\Timeval::sleepUntil' => [''], 'Grpc\Timeval::subtract' => ['Grpc\Timeval', 'other'=>'Grpc\Timeval'], 'Grpc\Timeval::zero' => ['Grpc\Timeval'], 'gupnp_context_get_host_ip' => ['string', 'context'=>'resource'], 'gupnp_context_get_port' => ['int', 'context'=>'resource'], 'gupnp_context_get_subscription_timeout' => ['int', 'context'=>'resource'], 'gupnp_context_host_path' => ['bool', 'context'=>'resource', 'local_path'=>'string', 'server_path'=>'string'], 'gupnp_context_new' => ['resource', 'host_ip='=>'string', 'port='=>'int'], 'gupnp_context_set_subscription_timeout' => ['void', 'context'=>'resource', 'timeout'=>'int'], 'gupnp_context_timeout_add' => ['bool', 'context'=>'resource', 'timeout'=>'int', 'callback'=>'mixed', 'arg='=>'mixed'], 'gupnp_context_unhost_path' => ['bool', 'context'=>'resource', 'server_path'=>'string'], 'gupnp_control_point_browse_start' => ['bool', 'cpoint'=>'resource'], 'gupnp_control_point_browse_stop' => ['bool', 'cpoint'=>'resource'], 'gupnp_control_point_callback_set' => ['bool', 'cpoint'=>'resource', 'signal'=>'int', 'callback'=>'mixed', 'arg='=>'mixed'], 'gupnp_control_point_new' => ['resource', 'context'=>'resource', 'target'=>'string'], 'gupnp_device_action_callback_set' => ['bool', 'root_device'=>'resource', 'signal'=>'int', 'action_name'=>'string', 'callback'=>'mixed', 'arg='=>'mixed'], 'gupnp_device_info_get' => ['array', 'root_device'=>'resource'], 'gupnp_device_info_get_service' => ['resource', 'root_device'=>'resource', 'type'=>'string'], 'gupnp_root_device_get_available' => ['bool', 'root_device'=>'resource'], 'gupnp_root_device_get_relative_location' => ['string', 'root_device'=>'resource'], 'gupnp_root_device_new' => ['resource', 'context'=>'resource', 'location'=>'string', 'description_dir'=>'string'], 'gupnp_root_device_set_available' => ['bool', 'root_device'=>'resource', 'available'=>'bool'], 'gupnp_root_device_start' => ['bool', 'root_device'=>'resource'], 'gupnp_root_device_stop' => ['bool', 'root_device'=>'resource'], 'gupnp_service_action_get' => ['mixed', 'action'=>'resource', 'name'=>'string', 'type'=>'int'], 'gupnp_service_action_return' => ['bool', 'action'=>'resource'], 'gupnp_service_action_return_error' => ['bool', 'action'=>'resource', 'error_code'=>'int', 'error_description='=>'string'], 'gupnp_service_action_set' => ['bool', 'action'=>'resource', 'name'=>'string', 'type'=>'int', 'value'=>'mixed'], 'gupnp_service_freeze_notify' => ['bool', 'service'=>'resource'], 'gupnp_service_info_get' => ['array', 'proxy'=>'resource'], 'gupnp_service_info_get_introspection' => ['mixed', 'proxy'=>'resource', 'callback='=>'mixed', 'arg='=>'mixed'], 'gupnp_service_introspection_get_state_variable' => ['array', 'introspection'=>'resource', 'variable_name'=>'string'], 'gupnp_service_notify' => ['bool', 'service'=>'resource', 'name'=>'string', 'type'=>'int', 'value'=>'mixed'], 'gupnp_service_proxy_action_get' => ['mixed', 'proxy'=>'resource', 'action'=>'string', 'name'=>'string', 'type'=>'int'], 'gupnp_service_proxy_action_set' => ['bool', 'proxy'=>'resource', 'action'=>'string', 'name'=>'string', 'value'=>'mixed', 'type'=>'int'], 'gupnp_service_proxy_add_notify' => ['bool', 'proxy'=>'resource', 'value'=>'string', 'type'=>'int', 'callback'=>'mixed', 'arg='=>'mixed'], 'gupnp_service_proxy_callback_set' => ['bool', 'proxy'=>'resource', 'signal'=>'int', 'callback'=>'mixed', 'arg='=>'mixed'], 'gupnp_service_proxy_get_subscribed' => ['bool', 'proxy'=>'resource'], 'gupnp_service_proxy_remove_notify' => ['bool', 'proxy'=>'resource', 'value'=>'string'], 'gupnp_service_proxy_send_action' => ['array', 'proxy'=>'resource', 'action'=>'string', 'in_params'=>'array', 'out_params'=>'array'], 'gupnp_service_proxy_set_subscribed' => ['bool', 'proxy'=>'resource', 'subscribed'=>'bool'], 'gupnp_service_thaw_notify' => ['bool', 'service'=>'resource'], 'gzclose' => ['bool', 'zp'=>'resource'], 'gzcompress' => ['string|false', 'data'=>'string', 'level='=>'int', 'encoding='=>'int'], 'gzdecode' => ['string|false', 'data'=>'string', 'length='=>'int'], 'gzdeflate' => ['string|false', 'data'=>'string', 'level='=>'int', 'encoding='=>'int'], 'gzencode' => ['string|false', 'data'=>'string', 'level='=>'int', 'encoding_mode='=>'int'], 'gzeof' => ['bool', 'zp'=>'resource'], 'gzfile' => ['list<string>|false', 'filename'=>'string', 'use_include_path='=>'int'], 'gzgetc' => ['string|false', 'zp'=>'resource'], 'gzgets' => ['string|false', 'zp'=>'resource', 'length='=>'int'], 'gzgetss' => ['string|false', 'zp'=>'resource', 'length'=>'int', 'allowable_tags='=>'string'], 'gzinflate' => ['string|false', 'data'=>'string', 'length='=>'int'], 'gzopen' => ['resource|false', 'filename'=>'string', 'mode'=>'string', 'use_include_path='=>'int'], 'gzpassthru' => ['int|false', 'zp'=>'resource'], 'gzputs' => ['int|false', 'zp'=>'resource', 'string'=>'string', 'length='=>'int'], 'gzread' => ['string|false', 'zp'=>'resource', 'length'=>'int'], 'gzrewind' => ['bool', 'zp'=>'resource'], 'gzseek' => ['int', 'zp'=>'resource', 'offset'=>'int', 'whence='=>'int'], 'gztell' => ['int|false', 'zp'=>'resource'], 'gzuncompress' => ['string|false', 'data'=>'string', 'length='=>'int'], 'gzwrite' => ['int|false', 'zp'=>'resource', 'string'=>'string', 'length='=>'int'], 'HaruAnnotation::setBorderStyle' => ['bool', 'width'=>'float', 'dash_on'=>'int', 'dash_off'=>'int'], 'HaruAnnotation::setHighlightMode' => ['bool', 'mode'=>'int'], 'HaruAnnotation::setIcon' => ['bool', 'icon'=>'int'], 'HaruAnnotation::setOpened' => ['bool', 'opened'=>'bool'], 'HaruDestination::setFit' => ['bool'], 'HaruDestination::setFitB' => ['bool'], 'HaruDestination::setFitBH' => ['bool', 'top'=>'float'], 'HaruDestination::setFitBV' => ['bool', 'left'=>'float'], 'HaruDestination::setFitH' => ['bool', 'top'=>'float'], 'HaruDestination::setFitR' => ['bool', 'left'=>'float', 'bottom'=>'float', 'right'=>'float', 'top'=>'float'], 'HaruDestination::setFitV' => ['bool', 'left'=>'float'], 'HaruDestination::setXYZ' => ['bool', 'left'=>'float', 'top'=>'float', 'zoom'=>'float'], 'HaruDoc::__construct' => ['void'], 'HaruDoc::addPage' => ['object'], 'HaruDoc::addPageLabel' => ['bool', 'first_page'=>'int', 'style'=>'int', 'first_num'=>'int', 'prefix='=>'string'], 'HaruDoc::createOutline' => ['object', 'title'=>'string', 'parent_outline='=>'object', 'encoder='=>'object'], 'HaruDoc::getCurrentEncoder' => ['object'], 'HaruDoc::getCurrentPage' => ['object'], 'HaruDoc::getEncoder' => ['object', 'encoding'=>'string'], 'HaruDoc::getFont' => ['object', 'fontname'=>'string', 'encoding='=>'string'], 'HaruDoc::getInfoAttr' => ['string', 'type'=>'int'], 'HaruDoc::getPageLayout' => ['int'], 'HaruDoc::getPageMode' => ['int'], 'HaruDoc::getStreamSize' => ['int'], 'HaruDoc::insertPage' => ['object', 'page'=>'object'], 'HaruDoc::loadJPEG' => ['object', 'filename'=>'string'], 'HaruDoc::loadPNG' => ['object', 'filename'=>'string', 'deferred='=>'bool'], 'HaruDoc::loadRaw' => ['object', 'filename'=>'string', 'width'=>'int', 'height'=>'int', 'color_space'=>'int'], 'HaruDoc::loadTTC' => ['string', 'fontfile'=>'string', 'index'=>'int', 'embed='=>'bool'], 'HaruDoc::loadTTF' => ['string', 'fontfile'=>'string', 'embed='=>'bool'], 'HaruDoc::loadType1' => ['string', 'afmfile'=>'string', 'pfmfile='=>'string'], 'HaruDoc::output' => ['bool'], 'HaruDoc::readFromStream' => ['string', 'bytes'=>'int'], 'HaruDoc::resetError' => ['bool'], 'HaruDoc::resetStream' => ['bool'], 'HaruDoc::save' => ['bool', 'file'=>'string'], 'HaruDoc::saveToStream' => ['bool'], 'HaruDoc::setCompressionMode' => ['bool', 'mode'=>'int'], 'HaruDoc::setCurrentEncoder' => ['bool', 'encoding'=>'string'], 'HaruDoc::setEncryptionMode' => ['bool', 'mode'=>'int', 'key_len='=>'int'], 'HaruDoc::setInfoAttr' => ['bool', 'type'=>'int', 'info'=>'string'], 'HaruDoc::setInfoDateAttr' => ['bool', 'type'=>'int', 'year'=>'int', 'month'=>'int', 'day'=>'int', 'hour'=>'int', 'min'=>'int', 'sec'=>'int', 'ind'=>'string', 'off_hour'=>'int', 'off_min'=>'int'], 'HaruDoc::setOpenAction' => ['bool', 'destination'=>'object'], 'HaruDoc::setPageLayout' => ['bool', 'layout'=>'int'], 'HaruDoc::setPageMode' => ['bool', 'mode'=>'int'], 'HaruDoc::setPagesConfiguration' => ['bool', 'page_per_pages'=>'int'], 'HaruDoc::setPassword' => ['bool', 'owner_password'=>'string', 'user_password'=>'string'], 'HaruDoc::setPermission' => ['bool', 'permission'=>'int'], 'HaruDoc::useCNSEncodings' => ['bool'], 'HaruDoc::useCNSFonts' => ['bool'], 'HaruDoc::useCNTEncodings' => ['bool'], 'HaruDoc::useCNTFonts' => ['bool'], 'HaruDoc::useJPEncodings' => ['bool'], 'HaruDoc::useJPFonts' => ['bool'], 'HaruDoc::useKREncodings' => ['bool'], 'HaruDoc::useKRFonts' => ['bool'], 'HaruEncoder::getByteType' => ['int', 'text'=>'string', 'index'=>'int'], 'HaruEncoder::getType' => ['int'], 'HaruEncoder::getUnicode' => ['int', 'character'=>'int'], 'HaruEncoder::getWritingMode' => ['int'], 'HaruFont::getAscent' => ['int'], 'HaruFont::getCapHeight' => ['int'], 'HaruFont::getDescent' => ['int'], 'HaruFont::getEncodingName' => ['string'], 'HaruFont::getFontName' => ['string'], 'HaruFont::getTextWidth' => ['array', 'text'=>'string'], 'HaruFont::getUnicodeWidth' => ['int', 'character'=>'int'], 'HaruFont::getXHeight' => ['int'], 'HaruFont::measureText' => ['int', 'text'=>'string', 'width'=>'float', 'font_size'=>'float', 'char_space'=>'float', 'word_space'=>'float', 'word_wrap='=>'bool'], 'HaruImage::getBitsPerComponent' => ['int'], 'HaruImage::getColorSpace' => ['string'], 'HaruImage::getHeight' => ['int'], 'HaruImage::getSize' => ['array'], 'HaruImage::getWidth' => ['int'], 'HaruImage::setColorMask' => ['bool', 'rmin'=>'int', 'rmax'=>'int', 'gmin'=>'int', 'gmax'=>'int', 'bmin'=>'int', 'bmax'=>'int'], 'HaruImage::setMaskImage' => ['bool', 'mask_image'=>'object'], 'HaruOutline::setDestination' => ['bool', 'destination'=>'object'], 'HaruOutline::setOpened' => ['bool', 'opened'=>'bool'], 'HaruPage::arc' => ['bool', 'x'=>'float', 'y'=>'float', 'ray'=>'float', 'ang1'=>'float', 'ang2'=>'float'], 'HaruPage::beginText' => ['bool'], 'HaruPage::circle' => ['bool', 'x'=>'float', 'y'=>'float', 'ray'=>'float'], 'HaruPage::closePath' => ['bool'], 'HaruPage::concat' => ['bool', 'a'=>'float', 'b'=>'float', 'c'=>'float', 'd'=>'float', 'x'=>'float', 'y'=>'float'], 'HaruPage::createDestination' => ['object'], 'HaruPage::createLinkAnnotation' => ['object', 'rectangle'=>'array', 'destination'=>'object'], 'HaruPage::createTextAnnotation' => ['object', 'rectangle'=>'array', 'text'=>'string', 'encoder='=>'object'], 'HaruPage::createURLAnnotation' => ['object', 'rectangle'=>'array', 'url'=>'string'], 'HaruPage::curveTo' => ['bool', 'x1'=>'float', 'y1'=>'float', 'x2'=>'float', 'y2'=>'float', 'x3'=>'float', 'y3'=>'float'], 'HaruPage::curveTo2' => ['bool', 'x2'=>'float', 'y2'=>'float', 'x3'=>'float', 'y3'=>'float'], 'HaruPage::curveTo3' => ['bool', 'x1'=>'float', 'y1'=>'float', 'x3'=>'float', 'y3'=>'float'], 'HaruPage::drawImage' => ['bool', 'image'=>'object', 'x'=>'float', 'y'=>'float', 'width'=>'float', 'height'=>'float'], 'HaruPage::ellipse' => ['bool', 'x'=>'float', 'y'=>'float', 'xray'=>'float', 'yray'=>'float'], 'HaruPage::endPath' => ['bool'], 'HaruPage::endText' => ['bool'], 'HaruPage::eofill' => ['bool'], 'HaruPage::eoFillStroke' => ['bool', 'close_path='=>'bool'], 'HaruPage::fill' => ['bool'], 'HaruPage::fillStroke' => ['bool', 'close_path='=>'bool'], 'HaruPage::getCharSpace' => ['float'], 'HaruPage::getCMYKFill' => ['array'], 'HaruPage::getCMYKStroke' => ['array'], 'HaruPage::getCurrentFont' => ['object'], 'HaruPage::getCurrentFontSize' => ['float'], 'HaruPage::getCurrentPos' => ['array'], 'HaruPage::getCurrentTextPos' => ['array'], 'HaruPage::getDash' => ['array'], 'HaruPage::getFillingColorSpace' => ['int'], 'HaruPage::getFlatness' => ['float'], 'HaruPage::getGMode' => ['int'], 'HaruPage::getGrayFill' => ['float'], 'HaruPage::getGrayStroke' => ['float'], 'HaruPage::getHeight' => ['float'], 'HaruPage::getHorizontalScaling' => ['float'], 'HaruPage::getLineCap' => ['int'], 'HaruPage::getLineJoin' => ['int'], 'HaruPage::getLineWidth' => ['float'], 'HaruPage::getMiterLimit' => ['float'], 'HaruPage::getRGBFill' => ['array'], 'HaruPage::getRGBStroke' => ['array'], 'HaruPage::getStrokingColorSpace' => ['int'], 'HaruPage::getTextLeading' => ['float'], 'HaruPage::getTextMatrix' => ['array'], 'HaruPage::getTextRenderingMode' => ['int'], 'HaruPage::getTextRise' => ['float'], 'HaruPage::getTextWidth' => ['float', 'text'=>'string'], 'HaruPage::getTransMatrix' => ['array'], 'HaruPage::getWidth' => ['float'], 'HaruPage::getWordSpace' => ['float'], 'HaruPage::lineTo' => ['bool', 'x'=>'float', 'y'=>'float'], 'HaruPage::measureText' => ['int', 'text'=>'string', 'width'=>'float', 'wordwrap='=>'bool'], 'HaruPage::moveTextPos' => ['bool', 'x'=>'float', 'y'=>'float', 'set_leading='=>'bool'], 'HaruPage::moveTo' => ['bool', 'x'=>'float', 'y'=>'float'], 'HaruPage::moveToNextLine' => ['bool'], 'HaruPage::rectangle' => ['bool', 'x'=>'float', 'y'=>'float', 'width'=>'float', 'height'=>'float'], 'HaruPage::setCharSpace' => ['bool', 'char_space'=>'float'], 'HaruPage::setCMYKFill' => ['bool', 'c'=>'float', 'm'=>'float', 'y'=>'float', 'k'=>'float'], 'HaruPage::setCMYKStroke' => ['bool', 'c'=>'float', 'm'=>'float', 'y'=>'float', 'k'=>'float'], 'HaruPage::setDash' => ['bool', 'pattern'=>'array', 'phase'=>'int'], 'HaruPage::setFlatness' => ['bool', 'flatness'=>'float'], 'HaruPage::setFontAndSize' => ['bool', 'font'=>'object', 'size'=>'float'], 'HaruPage::setGrayFill' => ['bool', 'value'=>'float'], 'HaruPage::setGrayStroke' => ['bool', 'value'=>'float'], 'HaruPage::setHeight' => ['bool', 'height'=>'float'], 'HaruPage::setHorizontalScaling' => ['bool', 'scaling'=>'float'], 'HaruPage::setLineCap' => ['bool', 'cap'=>'int'], 'HaruPage::setLineJoin' => ['bool', 'join'=>'int'], 'HaruPage::setLineWidth' => ['bool', 'width'=>'float'], 'HaruPage::setMiterLimit' => ['bool', 'limit'=>'float'], 'HaruPage::setRGBFill' => ['bool', 'r'=>'float', 'g'=>'float', 'b'=>'float'], 'HaruPage::setRGBStroke' => ['bool', 'r'=>'float', 'g'=>'float', 'b'=>'float'], 'HaruPage::setRotate' => ['bool', 'angle'=>'int'], 'HaruPage::setSize' => ['bool', 'size'=>'int', 'direction'=>'int'], 'HaruPage::setSlideShow' => ['bool', 'type'=>'int', 'disp_time'=>'float', 'trans_time'=>'float'], 'HaruPage::setTextLeading' => ['bool', 'text_leading'=>'float'], 'HaruPage::setTextMatrix' => ['bool', 'a'=>'float', 'b'=>'float', 'c'=>'float', 'd'=>'float', 'x'=>'float', 'y'=>'float'], 'HaruPage::setTextRenderingMode' => ['bool', 'mode'=>'int'], 'HaruPage::setTextRise' => ['bool', 'rise'=>'float'], 'HaruPage::setWidth' => ['bool', 'width'=>'float'], 'HaruPage::setWordSpace' => ['bool', 'word_space'=>'float'], 'HaruPage::showText' => ['bool', 'text'=>'string'], 'HaruPage::showTextNextLine' => ['bool', 'text'=>'string', 'word_space='=>'float', 'char_space='=>'float'], 'HaruPage::stroke' => ['bool', 'close_path='=>'bool'], 'HaruPage::textOut' => ['bool', 'x'=>'float', 'y'=>'float', 'text'=>'string'], 'HaruPage::textRect' => ['bool', 'left'=>'float', 'top'=>'float', 'right'=>'float', 'bottom'=>'float', 'text'=>'string', 'align='=>'int'], 'hash' => ['non-falsy-string|false', 'algo'=>'string', 'data'=>'string', 'raw_output='=>'bool'], 'hash_algos' => ['non-empty-list<non-falsy-string>'], 'hash_copy' => ['HashContext', 'context'=>'HashContext'], 'hash_equals' => ['bool', 'known_string'=>'string', 'user_string'=>'string'], 'hash_file' => ['non-falsy-string|false', 'algo'=>'string', 'filename'=>'string', 'raw_output='=>'bool'], 'hash_final' => ['non-falsy-string', 'context'=>'HashContext', 'raw_output='=>'bool'], 'hash_hkdf' => ['non-falsy-string|false', 'algo'=>'string', 'key'=>'string', 'length='=>'int', 'info='=>'string', 'salt='=>'string'], 'hash_hmac' => ['non-falsy-string|false', 'algo'=>'string', 'data'=>'string', 'key'=>'string', 'raw_output='=>'bool'], 'hash_hmac_algos' => ['non-empty-list<non-falsy-string>'], 'hash_hmac_file' => ['non-falsy-string|false', 'algo'=>'string', 'filename'=>'string', 'key'=>'string', 'raw_output='=>'bool'], 'hash_init' => ['HashContext', 'algo'=>'string', 'options='=>'int', 'key='=>'string'], 'hash_pbkdf2' => ['(non-falsy-string&lowercase-string)|false', 'algo'=>'string', 'password'=>'string', 'salt'=>'string', 'iterations'=>'int', 'length='=>'int', 'raw_output='=>'bool'], 'hash_update' => ['bool', 'context'=>'HashContext', 'data'=>'string'], 'hash_update_file' => ['bool', 'context'=>'HashContext', 'filename'=>'string', 'scontext='=>'?HashContext'], 'hash_update_stream' => ['int', 'context'=>'HashContext', 'handle'=>'resource', 'length='=>'int'], 'hashTableObj::clear' => ['void'], 'hashTableObj::get' => ['string', 'key'=>'string'], 'hashTableObj::nextkey' => ['string', 'previousKey'=>'string'], 'hashTableObj::remove' => ['int', 'key'=>'string'], 'hashTableObj::set' => ['int', 'key'=>'string', 'value'=>'string'], 'header' => ['void', 'header'=>'string', 'replace='=>'bool', 'http_response_code='=>'int'], 'header_register_callback' => ['bool', 'callback'=>'callable'], 'header_remove' => ['void', 'name='=>'string'], 'headers_list' => ['list<non-empty-string>'], 'headers_sent' => ['bool', '&w_file='=>'string', '&w_line='=>'int'], 'hebrev' => ['string', 'str'=>'string', 'max_chars_per_line='=>'int'], 'hebrevc' => ['string', 'str'=>'string', 'max_chars_per_line='=>'int'], 'hex2bin' => ['string|false', 'data'=>'string'], 'hexdec' => ['int|float', 'hexadecimal_number'=>'string'], 'highlight_file' => ['string|bool', 'file_name'=>'string', 'return='=>'bool'], 'highlight_string' => ['string|bool', 'string'=>'string', 'return='=>'bool'], 'hrtime' => ['array{0:int,1:int}|int|float|false', 'get_as_number='=>'bool'], 'HRTime\PerformanceCounter::getElapsedTicks' => ['int'], 'HRTime\PerformanceCounter::getFrequency' => ['int'], 'HRTime\PerformanceCounter::getLastElapsedTicks' => ['int'], 'HRTime\PerformanceCounter::getTicks' => ['int'], 'HRTime\PerformanceCounter::getTicksSince' => ['int', 'start'=>'int'], 'HRTime\PerformanceCounter::isRunning' => ['bool'], 'HRTime\PerformanceCounter::start' => ['void'], 'HRTime\PerformanceCounter::stop' => ['void'], 'HRTime\StopWatch::getElapsedTicks' => ['int'], 'HRTime\StopWatch::getElapsedTime' => ['float', 'unit='=>'int'], 'HRTime\StopWatch::getLastElapsedTicks' => ['int'], 'HRTime\StopWatch::getLastElapsedTime' => ['float', 'unit='=>'int'], 'HRTime\StopWatch::isRunning' => ['bool'], 'HRTime\StopWatch::start' => ['void'], 'HRTime\StopWatch::stop' => ['void'], 'html_entity_decode' => ['string', 'string'=>'string', 'quote_style='=>'int', 'encoding='=>'string'], 'htmlentities' => ['string', 'string'=>'string', 'quote_style='=>'int', 'encoding='=>'string', 'double_encode='=>'bool'], 'htmlspecialchars' => ['string', 'string'=>'string', 'quote_style='=>'int', 'encoding='=>'string', 'double_encode='=>'bool'], 'htmlspecialchars_decode' => ['string', 'string'=>'string', 'quote_style='=>'int'], 'http\Env\Request::__construct' => ['void'], 'http\Env\Request::getCookie' => ['mixed', 'name='=>'string', 'type='=>'mixed', 'defval='=>'mixed', 'delete='=>'bool|false'], 'http\Env\Request::getFiles' => ['array'], 'http\Env\Request::getForm' => ['mixed', 'name='=>'string', 'type='=>'mixed', 'defval='=>'mixed', 'delete='=>'bool|false'], 'http\Env\Request::getQuery' => ['mixed', 'name='=>'string', 'type='=>'mixed', 'defval='=>'mixed', 'delete='=>'bool|false'], 'http\Env\Response::__construct' => ['void'], 'http\Env\Response::__invoke' => ['bool', 'data'=>'string', 'ob_flags='=>'int'], 'http\Env\Response::isCachedByETag' => ['int', 'header_name='=>'string'], 'http\Env\Response::isCachedByLastModified' => ['int', 'header_name='=>'string'], 'http\Env\Response::send' => ['bool', 'stream='=>'resource'], 'http\Env\Response::setCacheControl' => ['http\Env\Response', 'cache_control'=>'string'], 'http\Env\Response::setContentDisposition' => ['http\Env\Response', 'disposition_params'=>'array'], 'http\Env\Response::setContentEncoding' => ['http\Env\Response', 'content_encoding'=>'int'], 'http\Env\Response::setContentType' => ['http\Env\Response', 'content_type'=>'string'], 'http\Env\Response::setCookie' => ['http\Env\Response', 'cookie'=>'mixed'], 'http\Env\Response::setEnvRequest' => ['http\Env\Response', 'env_request'=>'http\Message'], 'http\Env\Response::setEtag' => ['http\Env\Response', 'etag'=>'string'], 'http\Env\Response::setLastModified' => ['http\Env\Response', 'last_modified'=>'int'], 'http\Env\Response::setThrottleRate' => ['http\Env\Response', 'chunk_size'=>'int', 'delay='=>'float|int'], 'http\QueryString::__construct' => ['void', 'querystring'=>'string'], 'http\QueryString::__toString' => ['string'], 'http\QueryString::get' => ['', 'name='=>'string', 'type='=>'mixed', 'defval='=>'mixed', 'delete='=>'bool|false'], 'http\QueryString::getArray' => ['array', 'name'=>'string', 'defval='=>'mixed', 'delete='=>'bool|false'], 'http\QueryString::getBool' => ['bool', 'name'=>'string', 'defval='=>'mixed', 'delete='=>'bool|false'], 'http\QueryString::getFloat' => ['float', 'name'=>'string', 'defval='=>'mixed', 'delete='=>'bool|false'], 'http\QueryString::getGlobalInstance' => ['http\QueryString'], 'http\QueryString::getInt' => ['int', 'name'=>'string', 'defval='=>'mixed', 'delete='=>'bool|false'], 'http\QueryString::getIterator' => ['IteratorAggregate'], 'http\QueryString::getObject' => ['', 'name'=>'string', 'defval='=>'mixed', 'delete='=>'bool|false'], 'http\QueryString::getString' => ['string', 'name'=>'string', 'defval='=>'mixed', 'delete='=>'bool|false'], 'http\QueryString::mod' => ['http\QueryString', 'params='=>'mixed'], 'http\QueryString::offsetExists' => ['bool', 'offset'=>'mixed'], 'http\QueryString::offsetGet' => ['mixed', 'offset'=>'mixed'], 'http\QueryString::offsetSet' => ['void', 'offset'=>'mixed', 'value'=>'mixed'], 'http\QueryString::offsetUnset' => ['void', 'offset'=>'mixed'], 'http\QueryString::serialize' => ['string'], 'http\QueryString::set' => ['http\QueryString', 'params'=>'mixed'], 'http\QueryString::toArray' => ['mixed[]'], 'http\QueryString::toString' => ['string'], 'http\QueryString::unserialize' => ['void', 'serialized'=>''], 'http\QueryString::xlate' => ['http\QueryString'], 'http\Url::__construct' => ['void', 'old_url='=>'mixed', 'new_url='=>'mixed', 'flags='=>'int'], 'http\Url::__toString' => [''], 'http\Url::mod' => ['http\Url', 'parts'=>'mixed', 'flags='=>'float|int|mixed'], 'http\Url::toArray' => ['string[]'], 'http\Url::toString' => ['string'], 'http_build_cookie' => ['string', 'cookie'=>'array'], 'http_build_query' => ['string', 'querydata'=>'array|object', 'prefix='=>'string', 'arg_separator='=>'string', 'enc_type='=>'int'], 'http_build_str' => ['string', 'query'=>'array', 'prefix='=>'?string', 'arg_separator='=>'string'], 'http_build_url' => ['string', 'url='=>'string|array', 'parts='=>'string|array', 'flags='=>'int', 'new_url='=>'array'], 'http_cache_etag' => ['bool', 'etag='=>'string'], 'http_cache_last_modified' => ['bool', 'timestamp_or_expires='=>'int'], 'http_chunked_decode' => ['string', 'encoded'=>'string'], 'http_date' => ['string', 'timestamp='=>'int'], 'http_deflate' => ['string', 'data'=>'string', 'flags='=>'int'], 'http_get' => ['string', 'url'=>'string', 'options='=>'array', 'info='=>'array'], 'http_get_request_body' => ['string'], 'http_get_request_body_stream' => ['resource'], 'http_get_request_headers' => ['array'], 'http_head' => ['string', 'url'=>'string', 'options='=>'array', 'info='=>'array'], 'http_inflate' => ['string', 'data'=>'string'], 'http_match_etag' => ['bool', 'etag'=>'string', 'for_range='=>'bool'], 'http_match_modified' => ['bool', 'timestamp='=>'int', 'for_range='=>'bool'], 'http_match_request_header' => ['bool', 'header'=>'string', 'value'=>'string', 'match_case='=>'bool'], 'http_negotiate_charset' => ['string', 'supported'=>'array', 'result='=>'array'], 'http_negotiate_content_type' => ['string', 'supported'=>'array', 'result='=>'array'], 'http_negotiate_language' => ['string', 'supported'=>'array', 'result='=>'array'], 'http_parse_cookie' => ['object', 'cookie'=>'string', 'flags='=>'int', 'allowed_extras='=>'array'], 'http_parse_headers' => ['array', 'header'=>'string'], 'http_parse_message' => ['object', 'message'=>'string'], 'http_parse_params' => ['object', 'param'=>'string', 'flags='=>'int'], 'http_persistent_handles_clean' => ['string', 'ident='=>'string'], 'http_persistent_handles_count' => ['object'], 'http_persistent_handles_ident' => ['string', 'ident='=>'string'], 'http_post_data' => ['string', 'url'=>'string', 'data'=>'string', 'options='=>'array', 'info='=>'array'], 'http_post_fields' => ['string', 'url'=>'string', 'data'=>'array', 'files='=>'array', 'options='=>'array', 'info='=>'array'], 'http_put_data' => ['string', 'url'=>'string', 'data'=>'string', 'options='=>'array', 'info='=>'array'], 'http_put_file' => ['string', 'url'=>'string', 'file'=>'string', 'options='=>'array', 'info='=>'array'], 'http_put_stream' => ['string', 'url'=>'string', 'stream'=>'', 'options='=>'array', 'info='=>'array'], 'http_redirect' => ['bool', 'url='=>'string', 'params='=>'array', 'session='=>'bool', 'status='=>'int'], 'http_request' => ['string', 'method'=>'int', 'url'=>'string', 'body='=>'string', 'options='=>'array', 'info='=>'array'], 'http_request_body_encode' => ['string', 'fields'=>'array', 'files'=>'array'], 'http_request_method_exists' => ['int', 'method'=>''], 'http_request_method_name' => ['string', 'method'=>'int'], 'http_request_method_register' => ['int', 'method'=>'string'], 'http_request_method_unregister' => ['bool', 'method'=>''], 'http_response_code' => ['int|bool', 'response_code='=>'int'], 'http_send_content_disposition' => ['bool', 'filename'=>'string', 'inline='=>'bool'], 'http_send_content_type' => ['bool', 'content_type='=>'string'], 'http_send_data' => ['bool', 'data'=>'string'], 'http_send_file' => ['bool', 'file'=>'string'], 'http_send_last_modified' => ['bool', 'timestamp='=>'int'], 'http_send_status' => ['bool', 'status'=>'int'], 'http_send_stream' => ['bool', 'stream'=>''], 'http_support' => ['int', 'feature='=>'int'], 'http_throttle' => ['', 'sec'=>'float', 'bytes='=>'int'], 'HttpDeflateStream::__construct' => ['void', 'flags='=>'int'], 'HttpDeflateStream::factory' => ['HttpDeflateStream', 'flags='=>'int', 'class_name='=>'string'], 'HttpDeflateStream::finish' => ['string', 'data='=>'string'], 'HttpDeflateStream::flush' => ['string', 'data='=>'string'], 'HttpDeflateStream::update' => ['string', 'data'=>'string'], 'HttpInflateStream::__construct' => ['void', 'flags='=>'int'], 'HttpInflateStream::factory' => ['HttpInflateStream', 'flags='=>'int', 'class_name='=>'string'], 'HttpInflateStream::finish' => ['string', 'data='=>'string'], 'HttpInflateStream::flush' => ['string', 'data='=>'string'], 'HttpInflateStream::update' => ['string', 'data'=>'string'], 'HttpMessage::__construct' => ['void', 'message='=>'string'], 'HttpMessage::__toString' => ['string'], 'HttpMessage::addHeaders' => ['', 'headers'=>'array', 'append='=>'bool'], 'HttpMessage::count' => ['0|positive-int'], 'HttpMessage::current' => ['mixed'], 'HttpMessage::detach' => ['HttpMessage'], 'HttpMessage::factory' => ['HttpMessage', 'raw_message='=>'string', 'class_name='=>'string'], 'HttpMessage::fromEnv' => ['HttpMessage', 'message_type'=>'int', 'class_name='=>'string'], 'HttpMessage::fromString' => ['HttpMessage', 'raw_message='=>'string', 'class_name='=>'string'], 'HttpMessage::getBody' => ['string'], 'HttpMessage::getHeader' => ['string', 'header'=>'string'], 'HttpMessage::getHeaders' => ['array'], 'HttpMessage::getHttpVersion' => ['string'], 'HttpMessage::getInfo' => [''], 'HttpMessage::getParentMessage' => ['HttpMessage'], 'HttpMessage::getRequestMethod' => ['string'], 'HttpMessage::getRequestUrl' => ['string'], 'HttpMessage::getResponseCode' => ['int'], 'HttpMessage::getResponseStatus' => ['string'], 'HttpMessage::getType' => ['int'], 'HttpMessage::guessContentType' => ['string', 'magic_file'=>'string', 'magic_mode='=>'int'], 'HttpMessage::key' => ['int|string'], 'HttpMessage::next' => ['void'], 'HttpMessage::prepend' => ['', 'message'=>'httpmessage', 'top='=>'bool'], 'HttpMessage::reverse' => ['HttpMessage'], 'HttpMessage::rewind' => ['void'], 'HttpMessage::send' => ['bool'], 'HttpMessage::serialize' => ['string'], 'HttpMessage::setBody' => ['', 'body'=>'string'], 'HttpMessage::setHeaders' => ['', 'headers'=>'array'], 'HttpMessage::setHttpVersion' => ['bool', 'version'=>'string'], 'HttpMessage::setInfo' => ['', 'http_info'=>''], 'HttpMessage::setRequestMethod' => ['bool', 'method'=>'string'], 'HttpMessage::setRequestUrl' => ['bool', 'url'=>'string'], 'HttpMessage::setResponseCode' => ['bool', 'code'=>'int'], 'HttpMessage::setResponseStatus' => ['bool', 'status'=>'string'], 'HttpMessage::setType' => ['', 'type'=>'int'], 'HttpMessage::toMessageTypeObject' => ['HttpRequest|HttpResponse'], 'HttpMessage::toString' => ['string', 'include_parent='=>'bool'], 'HttpMessage::unserialize' => ['void', 'serialized'=>''], 'HttpMessage::valid' => ['bool'], 'HttpQueryString::__construct' => ['void', 'global='=>'bool', 'add='=>''], 'HttpQueryString::__toString' => ['string'], 'HttpQueryString::factory' => ['', 'global'=>'', 'params'=>'', 'class_name'=>''], 'HttpQueryString::get' => ['', 'key='=>'string', 'type='=>'', 'defval='=>'', 'delete='=>'bool'], 'HttpQueryString::getArray' => ['', 'name'=>'', 'defval'=>'', 'delete'=>''], 'HttpQueryString::getBool' => ['', 'name'=>'', 'defval'=>'', 'delete'=>''], 'HttpQueryString::getFloat' => ['', 'name'=>'', 'defval'=>'', 'delete'=>''], 'HttpQueryString::getInt' => ['', 'name'=>'', 'defval'=>'', 'delete'=>''], 'HttpQueryString::getObject' => ['', 'name'=>'', 'defval'=>'', 'delete'=>''], 'HttpQueryString::getString' => ['', 'name'=>'', 'defval'=>'', 'delete'=>''], 'HttpQueryString::mod' => ['HttpQueryString', 'params'=>''], 'HttpQueryString::offsetExists' => ['bool', 'offset'=>'mixed'], 'HttpQueryString::offsetGet' => ['mixed', 'offset'=>'mixed'], 'HttpQueryString::offsetSet' => ['void', 'offset'=>'mixed', 'value'=>'mixed'], 'HttpQueryString::offsetUnset' => ['void', 'offset'=>'mixed'], 'HttpQueryString::serialize' => ['string'], 'HttpQueryString::set' => ['string', 'params'=>''], 'HttpQueryString::singleton' => ['HttpQueryString', 'global='=>'bool'], 'HttpQueryString::toArray' => ['array'], 'HttpQueryString::toString' => ['string'], 'HttpQueryString::unserialize' => ['void', 'serialized'=>'string'], 'HttpQueryString::xlate' => ['bool', 'ie'=>'string', 'oe'=>'string'], 'HttpRequest::__construct' => ['void', 'url='=>'string', 'request_method='=>'int', 'options='=>'array'], 'HttpRequest::addBody' => ['', 'request_body_data'=>''], 'HttpRequest::addCookies' => ['bool', 'cookies'=>'array'], 'HttpRequest::addHeaders' => ['bool', 'headers'=>'array'], 'HttpRequest::addPostFields' => ['bool', 'post_data'=>'array'], 'HttpRequest::addPostFile' => ['bool', 'name'=>'string', 'file'=>'string', 'content_type='=>'string'], 'HttpRequest::addPutData' => ['bool', 'put_data'=>'string'], 'HttpRequest::addQueryData' => ['bool', 'query_params'=>'array'], 'HttpRequest::addRawPostData' => ['bool', 'raw_post_data'=>'string'], 'HttpRequest::addSslOptions' => ['bool', 'options'=>'array'], 'HttpRequest::clearHistory' => [''], 'HttpRequest::enableCookies' => ['bool'], 'HttpRequest::encodeBody' => ['', 'fields'=>'', 'files'=>''], 'HttpRequest::factory' => ['', 'url'=>'', 'method'=>'', 'options'=>'', 'class_name'=>''], 'HttpRequest::flushCookies' => [''], 'HttpRequest::get' => ['', 'url'=>'', 'options'=>'', '&info'=>''], 'HttpRequest::getBody' => [''], 'HttpRequest::getContentType' => ['string'], 'HttpRequest::getCookies' => ['array'], 'HttpRequest::getHeaders' => ['array'], 'HttpRequest::getHistory' => ['HttpMessage'], 'HttpRequest::getMethod' => ['int'], 'HttpRequest::getOptions' => ['array'], 'HttpRequest::getPostFields' => ['array'], 'HttpRequest::getPostFiles' => ['array'], 'HttpRequest::getPutData' => ['string'], 'HttpRequest::getPutFile' => ['string'], 'HttpRequest::getQueryData' => ['string'], 'HttpRequest::getRawPostData' => ['string'], 'HttpRequest::getRawRequestMessage' => ['string'], 'HttpRequest::getRawResponseMessage' => ['string'], 'HttpRequest::getRequestMessage' => ['HttpMessage'], 'HttpRequest::getResponseBody' => ['string'], 'HttpRequest::getResponseCode' => ['int'], 'HttpRequest::getResponseCookies' => ['array', 'flags='=>'int', 'allowed_extras='=>'array'], 'HttpRequest::getResponseData' => ['array'], 'HttpRequest::getResponseHeader' => ['', 'name='=>'string'], 'HttpRequest::getResponseInfo' => ['', 'name='=>'string'], 'HttpRequest::getResponseMessage' => ['HttpMessage'], 'HttpRequest::getResponseStatus' => ['string'], 'HttpRequest::getSslOptions' => ['array'], 'HttpRequest::getUrl' => ['string'], 'HttpRequest::head' => ['', 'url'=>'', 'options'=>'', '&info'=>''], 'HttpRequest::methodExists' => ['', 'method'=>''], 'HttpRequest::methodName' => ['', 'method_id'=>''], 'HttpRequest::methodRegister' => ['', 'method_name'=>''], 'HttpRequest::methodUnregister' => ['', 'method'=>''], 'HttpRequest::postData' => ['', 'url'=>'', 'data'=>'', 'options'=>'', '&info'=>''], 'HttpRequest::postFields' => ['', 'url'=>'', 'data'=>'', 'options'=>'', '&info'=>''], 'HttpRequest::putData' => ['', 'url'=>'', 'data'=>'', 'options'=>'', '&info'=>''], 'HttpRequest::putFile' => ['', 'url'=>'', 'file'=>'', 'options'=>'', '&info'=>''], 'HttpRequest::putStream' => ['', 'url'=>'', 'stream'=>'', 'options'=>'', '&info'=>''], 'HttpRequest::resetCookies' => ['bool', 'session_only='=>'bool'], 'HttpRequest::send' => ['HttpMessage'], 'HttpRequest::setBody' => ['bool', 'request_body_data='=>'string'], 'HttpRequest::setContentType' => ['bool', 'content_type'=>'string'], 'HttpRequest::setCookies' => ['bool', 'cookies='=>'array'], 'HttpRequest::setHeaders' => ['bool', 'headers='=>'array'], 'HttpRequest::setMethod' => ['bool', 'request_method'=>'int'], 'HttpRequest::setOptions' => ['bool', 'options='=>'array'], 'HttpRequest::setPostFields' => ['bool', 'post_data'=>'array'], 'HttpRequest::setPostFiles' => ['bool', 'post_files'=>'array'], 'HttpRequest::setPutData' => ['bool', 'put_data='=>'string'], 'HttpRequest::setPutFile' => ['bool', 'file='=>'string'], 'HttpRequest::setQueryData' => ['bool', 'query_data'=>''], 'HttpRequest::setRawPostData' => ['bool', 'raw_post_data='=>'string'], 'HttpRequest::setSslOptions' => ['bool', 'options='=>'array'], 'HttpRequest::setUrl' => ['bool', 'url'=>'string'], 'HttpRequestDataShare::__construct' => ['void'], 'HttpRequestDataShare::__destruct' => [''], 'HttpRequestDataShare::attach' => ['', 'request'=>'HttpRequest'], 'HttpRequestDataShare::count' => ['0|positive-int'], 'HttpRequestDataShare::detach' => ['', 'request'=>'HttpRequest'], 'HttpRequestDataShare::factory' => ['', 'global'=>'', 'class_name'=>''], 'HttpRequestDataShare::reset' => [''], 'HttpRequestDataShare::singleton' => ['', 'global'=>''], 'HttpRequestPool::__construct' => ['void', 'request='=>'httprequest'], 'HttpRequestPool::__destruct' => [''], 'HttpRequestPool::attach' => ['bool', 'request'=>'httprequest'], 'HttpRequestPool::count' => ['0|positive-int'], 'HttpRequestPool::current' => ['mixed'], 'HttpRequestPool::detach' => ['bool', 'request'=>'httprequest'], 'HttpRequestPool::enableEvents' => ['', 'enable'=>''], 'HttpRequestPool::enablePipelining' => ['', 'enable'=>''], 'HttpRequestPool::getAttachedRequests' => ['array'], 'HttpRequestPool::getFinishedRequests' => ['array'], 'HttpRequestPool::key' => ['int|string'], 'HttpRequestPool::next' => ['void'], 'HttpRequestPool::reset' => [''], 'HttpRequestPool::rewind' => ['void'], 'HttpRequestPool::send' => ['bool'], 'HttpRequestPool::socketPerform' => ['bool'], 'HttpRequestPool::socketSelect' => ['bool', 'timeout='=>'float'], 'HttpRequestPool::valid' => ['bool'], 'HttpResponse::capture' => [''], 'HttpResponse::getBufferSize' => ['int'], 'HttpResponse::getCache' => ['bool'], 'HttpResponse::getCacheControl' => ['string'], 'HttpResponse::getContentDisposition' => ['string'], 'HttpResponse::getContentType' => ['string'], 'HttpResponse::getData' => ['string'], 'HttpResponse::getETag' => ['string'], 'HttpResponse::getFile' => ['string'], 'HttpResponse::getGzip' => ['bool'], 'HttpResponse::getHeader' => ['', 'name='=>'string'], 'HttpResponse::getLastModified' => ['int'], 'HttpResponse::getRequestBody' => ['string'], 'HttpResponse::getRequestBodyStream' => ['resource'], 'HttpResponse::getRequestHeaders' => ['array'], 'HttpResponse::getStream' => ['resource'], 'HttpResponse::getThrottleDelay' => ['float'], 'HttpResponse::guessContentType' => ['string', 'magic_file'=>'string', 'magic_mode='=>'int'], 'HttpResponse::redirect' => ['', 'url='=>'string', 'params='=>'array', 'session='=>'bool', 'status='=>'int'], 'HttpResponse::send' => ['bool', 'clean_ob='=>'bool'], 'HttpResponse::setBufferSize' => ['bool', 'bytes'=>'int'], 'HttpResponse::setCache' => ['bool', 'cache'=>'bool'], 'HttpResponse::setCacheControl' => ['bool', 'control'=>'string', 'max_age='=>'int', 'must_revalidate='=>'bool'], 'HttpResponse::setContentDisposition' => ['bool', 'filename'=>'string', 'inline='=>'bool'], 'HttpResponse::setContentType' => ['bool', 'content_type'=>'string'], 'HttpResponse::setData' => ['bool', 'data'=>''], 'HttpResponse::setETag' => ['bool', 'etag'=>'string'], 'HttpResponse::setFile' => ['bool', 'file'=>'string'], 'HttpResponse::setGzip' => ['bool', 'gzip'=>'bool'], 'HttpResponse::setHeader' => ['bool', 'name'=>'string', 'value='=>'', 'replace='=>'bool'], 'HttpResponse::setLastModified' => ['bool', 'timestamp'=>'int'], 'HttpResponse::setStream' => ['bool', 'stream'=>''], 'HttpResponse::setThrottleDelay' => ['bool', 'seconds'=>'float'], 'HttpResponse::status' => ['bool', 'status'=>'int'], 'HttpUtil::buildCookie' => ['', 'cookie_array'=>''], 'HttpUtil::buildStr' => ['', 'query'=>'', 'prefix'=>'', 'arg_sep'=>''], 'HttpUtil::buildUrl' => ['', 'url'=>'', 'parts'=>'', 'flags'=>'', '&composed'=>''], 'HttpUtil::chunkedDecode' => ['', 'encoded_string'=>''], 'HttpUtil::date' => ['', 'timestamp'=>''], 'HttpUtil::deflate' => ['', 'plain'=>'', 'flags'=>''], 'HttpUtil::inflate' => ['', 'encoded'=>''], 'HttpUtil::matchEtag' => ['', 'plain_etag'=>'', 'for_range'=>''], 'HttpUtil::matchModified' => ['', 'last_modified'=>'', 'for_range'=>''], 'HttpUtil::matchRequestHeader' => ['', 'header_name'=>'', 'header_value'=>'', 'case_sensitive'=>''], 'HttpUtil::negotiateCharset' => ['', 'supported'=>'', '&result'=>''], 'HttpUtil::negotiateContentType' => ['', 'supported'=>'', '&result'=>''], 'HttpUtil::negotiateLanguage' => ['', 'supported'=>'', '&result'=>''], 'HttpUtil::parseCookie' => ['', 'cookie_string'=>''], 'HttpUtil::parseHeaders' => ['', 'headers_string'=>''], 'HttpUtil::parseMessage' => ['', 'message_string'=>''], 'HttpUtil::parseParams' => ['', 'param_string'=>'', 'flags'=>''], 'HttpUtil::support' => ['', 'feature'=>''], 'hw_api::checkin' => ['bool', 'parameter'=>'array'], 'hw_api::checkout' => ['bool', 'parameter'=>'array'], 'hw_api::children' => ['array', 'parameter'=>'array'], 'hw_api::content' => ['HW_API_Content', 'parameter'=>'array'], 'hw_api::copy' => ['hw_api_content', 'parameter'=>'array'], 'hw_api::dbstat' => ['hw_api_object', 'parameter'=>'array'], 'hw_api::dcstat' => ['hw_api_object', 'parameter'=>'array'], 'hw_api::dstanchors' => ['array', 'parameter'=>'array'], 'hw_api::dstofsrcanchor' => ['hw_api_object', 'parameter'=>'array'], 'hw_api::find' => ['array', 'parameter'=>'array'], 'hw_api::ftstat' => ['hw_api_object', 'parameter'=>'array'], 'hw_api::hwstat' => ['hw_api_object', 'parameter'=>'array'], 'hw_api::identify' => ['bool', 'parameter'=>'array'], 'hw_api::info' => ['array', 'parameter'=>'array'], 'hw_api::insert' => ['hw_api_object', 'parameter'=>'array'], 'hw_api::insertanchor' => ['hw_api_object', 'parameter'=>'array'], 'hw_api::insertcollection' => ['hw_api_object', 'parameter'=>'array'], 'hw_api::insertdocument' => ['hw_api_object', 'parameter'=>'array'], 'hw_api::link' => ['bool', 'parameter'=>'array'], 'hw_api::lock' => ['bool', 'parameter'=>'array'], 'hw_api::move' => ['bool', 'parameter'=>'array'], 'hw_api::object' => ['hw_api_object', 'parameter'=>'array'], 'hw_api::objectbyanchor' => ['hw_api_object', 'parameter'=>'array'], 'hw_api::parents' => ['array', 'parameter'=>'array'], 'hw_api::remove' => ['bool', 'parameter'=>'array'], 'hw_api::replace' => ['hw_api_object', 'parameter'=>'array'], 'hw_api::setcommittedversion' => ['hw_api_object', 'parameter'=>'array'], 'hw_api::srcanchors' => ['array', 'parameter'=>'array'], 'hw_api::srcsofdst' => ['array', 'parameter'=>'array'], 'hw_api::unlock' => ['bool', 'parameter'=>'array'], 'hw_api::user' => ['hw_api_object', 'parameter'=>'array'], 'hw_api::userlist' => ['array', 'parameter'=>'array'], 'hw_api_attribute' => ['HW_API_Attribute', 'name='=>'string', 'value='=>'string'], 'hw_api_attribute::key' => ['string'], 'hw_api_attribute::langdepvalue' => ['string', 'language'=>'string'], 'hw_api_attribute::value' => ['string'], 'hw_api_attribute::values' => ['array'], 'hw_api_content' => ['HW_API_Content', 'content'=>'string', 'mimetype'=>'string'], 'hw_api_content::mimetype' => ['string'], 'hw_api_content::read' => ['string', 'buffer'=>'string', 'len'=>'int'], 'hw_api_error::count' => ['0|positive-int'], 'hw_api_error::reason' => ['HW_API_Reason'], 'hw_api_object' => ['hw_api_object', 'parameter'=>'array'], 'hw_api_object::assign' => ['bool', 'parameter'=>'array'], 'hw_api_object::attreditable' => ['bool', 'parameter'=>'array'], 'hw_api_object::count' => ['0|positive-int', 'parameter'=>'array'], 'hw_api_object::insert' => ['bool', 'attribute'=>'hw_api_attribute'], 'hw_api_object::remove' => ['bool', 'name'=>'string'], 'hw_api_object::title' => ['string', 'parameter'=>'array'], 'hw_api_object::value' => ['string', 'name'=>'string'], 'hw_api_reason::description' => ['string'], 'hw_api_reason::type' => ['HW_API_Reason'], 'hw_Array2Objrec' => ['string', 'object_array'=>'array'], 'hw_changeobject' => ['bool', 'link'=>'int', 'objid'=>'int', 'attributes'=>'array'], 'hw_Children' => ['array', 'connection'=>'int', 'objectid'=>'int'], 'hw_ChildrenObj' => ['array', 'connection'=>'int', 'objectid'=>'int'], 'hw_Close' => ['bool', 'connection'=>'int'], 'hw_Connect' => ['int', 'host'=>'string', 'port'=>'int', 'username='=>'string', 'password='=>'string'], 'hw_connection_info' => ['', 'link'=>'int'], 'hw_cp' => ['int', 'connection'=>'int', 'object_id_array'=>'array', 'destination_id'=>'int'], 'hw_Deleteobject' => ['bool', 'connection'=>'int', 'object_to_delete'=>'int'], 'hw_DocByAnchor' => ['int', 'connection'=>'int', 'anchorid'=>'int'], 'hw_DocByAnchorObj' => ['string', 'connection'=>'int', 'anchorid'=>'int'], 'hw_Document_Attributes' => ['string', 'hw_document'=>'int'], 'hw_Document_BodyTag' => ['string', 'hw_document'=>'int', 'prefix='=>'string'], 'hw_Document_Content' => ['string', 'hw_document'=>'int'], 'hw_Document_SetContent' => ['bool', 'hw_document'=>'int', 'content'=>'string'], 'hw_Document_Size' => ['int', 'hw_document'=>'int'], 'hw_dummy' => ['string', 'link'=>'int', 'id'=>'int', 'msgid'=>'int'], 'hw_EditText' => ['bool', 'connection'=>'int', 'hw_document'=>'int'], 'hw_Error' => ['int', 'connection'=>'int'], 'hw_ErrorMsg' => ['string', 'connection'=>'int'], 'hw_Free_Document' => ['bool', 'hw_document'=>'int'], 'hw_GetAnchors' => ['array', 'connection'=>'int', 'objectid'=>'int'], 'hw_GetAnchorsObj' => ['array', 'connection'=>'int', 'objectid'=>'int'], 'hw_GetAndLock' => ['string', 'connection'=>'int', 'objectid'=>'int'], 'hw_GetChildColl' => ['array', 'connection'=>'int', 'objectid'=>'int'], 'hw_GetChildCollObj' => ['array', 'connection'=>'int', 'objectid'=>'int'], 'hw_GetChildDocColl' => ['array', 'connection'=>'int', 'objectid'=>'int'], 'hw_GetChildDocCollObj' => ['array', 'connection'=>'int', 'objectid'=>'int'], 'hw_GetObject' => ['', 'connection'=>'int', 'objectid'=>'', 'query='=>'string'], 'hw_GetObjectByQuery' => ['array', 'connection'=>'int', 'query'=>'string', 'max_hits'=>'int'], 'hw_GetObjectByQueryColl' => ['array', 'connection'=>'int', 'objectid'=>'int', 'query'=>'string', 'max_hits'=>'int'], 'hw_GetObjectByQueryCollObj' => ['array', 'connection'=>'int', 'objectid'=>'int', 'query'=>'string', 'max_hits'=>'int'], 'hw_GetObjectByQueryObj' => ['array', 'connection'=>'int', 'query'=>'string', 'max_hits'=>'int'], 'hw_GetParents' => ['array', 'connection'=>'int', 'objectid'=>'int'], 'hw_GetParentsObj' => ['array', 'connection'=>'int', 'objectid'=>'int'], 'hw_getrellink' => ['string', 'link'=>'int', 'rootid'=>'int', 'sourceid'=>'int', 'destid'=>'int'], 'hw_GetRemote' => ['int', 'connection'=>'int', 'objectid'=>'int'], 'hw_getremotechildren' => ['', 'connection'=>'int', 'object_record'=>'string'], 'hw_GetSrcByDestObj' => ['array', 'connection'=>'int', 'objectid'=>'int'], 'hw_GetText' => ['int', 'connection'=>'int', 'objectid'=>'int', 'prefix='=>''], 'hw_getusername' => ['string', 'connection'=>'int'], 'hw_Identify' => ['string', 'link'=>'int', 'username'=>'string', 'password'=>'string'], 'hw_InCollections' => ['array', 'connection'=>'int', 'object_id_array'=>'array', 'collection_id_array'=>'array', 'return_collections'=>'int'], 'hw_Info' => ['string', 'connection'=>'int'], 'hw_InsColl' => ['int', 'connection'=>'int', 'objectid'=>'int', 'object_array'=>'array'], 'hw_InsDoc' => ['int', 'connection'=>'', 'parentid'=>'int', 'object_record'=>'string', 'text='=>'string'], 'hw_insertanchors' => ['bool', 'hwdoc'=>'int', 'anchorecs'=>'array', 'dest'=>'array', 'urlprefixes='=>'array'], 'hw_InsertDocument' => ['int', 'connection'=>'int', 'parent_id'=>'int', 'hw_document'=>'int'], 'hw_InsertObject' => ['int', 'connection'=>'int', 'object_rec'=>'string', 'parameter'=>'string'], 'hw_mapid' => ['int', 'connection'=>'int', 'server_id'=>'int', 'object_id'=>'int'], 'hw_Modifyobject' => ['bool', 'connection'=>'int', 'object_to_change'=>'int', 'remove'=>'array', 'add'=>'array', 'mode='=>'int'], 'hw_mv' => ['int', 'connection'=>'int', 'object_id_array'=>'array', 'source_id'=>'int', 'destination_id'=>'int'], 'hw_New_Document' => ['int', 'object_record'=>'string', 'document_data'=>'string', 'document_size'=>'int'], 'hw_objrec2array' => ['array', 'object_record'=>'string', 'format='=>'array'], 'hw_Output_Document' => ['bool', 'hw_document'=>'int'], 'hw_pConnect' => ['int', 'host'=>'string', 'port'=>'int', 'username='=>'string', 'password='=>'string'], 'hw_PipeDocument' => ['int', 'connection'=>'int', 'objectid'=>'int', 'url_prefixes='=>'array'], 'hw_Root' => ['int'], 'hw_setlinkroot' => ['int', 'link'=>'int', 'rootid'=>'int'], 'hw_stat' => ['string', 'link'=>'int'], 'hw_Unlock' => ['bool', 'connection'=>'int', 'objectid'=>'int'], 'hw_Who' => ['array', 'connection'=>'int'], 'hwapi_attribute_new' => ['HW_API_Attribute', 'name='=>'string', 'value='=>'string'], 'hwapi_content_new' => ['HW_API_Content', 'content'=>'string', 'mimetype'=>'string'], 'hwapi_hgcsp' => ['HW_API', 'hostname'=>'string', 'port='=>'int'], 'hwapi_object_new' => ['hw_api_object', 'parameter'=>'array'], 'hypot' => ['float', 'num1'=>'float', 'num2'=>'float'], 'ibase_add_user' => ['bool', 'service_handle'=>'resource', 'user_name'=>'string', 'password'=>'string', 'first_name='=>'string', 'middle_name='=>'string', 'last_name='=>'string'], 'ibase_affected_rows' => ['int', 'link_identifier='=>'resource'], 'ibase_backup' => ['mixed', 'service_handle'=>'resource', 'source_db'=>'string', 'dest_file'=>'string', 'options='=>'int', 'verbose='=>'bool'], 'ibase_blob_add' => ['void', 'blob_handle'=>'resource', 'data'=>'string'], 'ibase_blob_cancel' => ['bool', 'blob_handle'=>'resource'], 'ibase_blob_close' => ['string', 'blob_handle'=>'resource'], 'ibase_blob_create' => ['resource', 'link_identifier='=>'resource'], 'ibase_blob_echo' => ['bool', 'link_identifier'=>'', 'blob_id'=>'string'], 'ibase_blob_echo\'1' => ['bool', 'blob_id'=>'string'], 'ibase_blob_get' => ['string', 'blob_handle'=>'resource', 'len'=>'int'], 'ibase_blob_import' => ['string', 'link_identifier'=>'', 'file_handle'=>''], 'ibase_blob_info' => ['array', 'link_identifier'=>'', 'blob_id'=>'string'], 'ibase_blob_info\'1' => ['array', 'blob_id'=>'string'], 'ibase_blob_open' => ['resource|false', 'link_identifier'=>'', 'blob_id'=>'string'], 'ibase_blob_open\'1' => ['resource', 'blob_id'=>'string'], 'ibase_close' => ['bool', 'link_identifier='=>'resource'], 'ibase_commit' => ['bool', 'link_identifier='=>'resource'], 'ibase_commit_ret' => ['bool', 'link_identifier='=>'resource'], 'ibase_connect' => ['resource', 'database='=>'string', 'username='=>'string', 'password='=>'string', 'charset='=>'string', 'buffers='=>'int', 'dialect='=>'int', 'role='=>'string'], 'ibase_db_info' => ['string', 'service_handle'=>'resource', 'db'=>'string', 'action'=>'int', 'argument='=>'int'], 'ibase_delete_user' => ['bool', 'service_handle'=>'resource', 'user_name'=>'string', 'password='=>'string', 'first_name='=>'string', 'middle_name='=>'string', 'last_name='=>'string'], 'ibase_drop_db' => ['bool', 'link_identifier='=>'resource'], 'ibase_errcode' => ['int'], 'ibase_errmsg' => ['string'], 'ibase_execute' => ['resource', 'query'=>'resource', 'bind_arg='=>'mixed', '...args='=>'mixed'], 'ibase_fetch_assoc' => ['array', 'result'=>'resource', 'fetch_flags='=>'int'], 'ibase_fetch_object' => ['object', 'result'=>'resource', 'fetch_flags='=>'int'], 'ibase_fetch_row' => ['array', 'result'=>'resource', 'fetch_flags='=>'int'], 'ibase_field_info' => ['array', 'query_result'=>'resource', 'field_number'=>'int'], 'ibase_free_event_handler' => ['bool', 'event'=>'resource'], 'ibase_free_query' => ['bool', 'query'=>'resource'], 'ibase_free_result' => ['bool', 'result'=>'resource'], 'ibase_gen_id' => ['int', 'generator'=>'string', 'increment='=>'int', 'link_identifier='=>'resource'], 'ibase_maintain_db' => ['bool', 'service_handle'=>'resource', 'db'=>'string', 'action'=>'int', 'argument='=>'int'], 'ibase_modify_user' => ['bool', 'service_handle'=>'resource', 'user_name'=>'string', 'password'=>'string', 'first_name='=>'string', 'middle_name='=>'string', 'last_name='=>'string'], 'ibase_name_result' => ['bool', 'result'=>'resource', 'name'=>'string'], 'ibase_num_fields' => ['int', 'query_result'=>'resource'], 'ibase_num_params' => ['int', 'query'=>'resource'], 'ibase_num_rows' => ['int', 'result_identifier'=>''], 'ibase_param_info' => ['array', 'query'=>'resource', 'field_number'=>'int'], 'ibase_pconnect' => ['resource', 'database='=>'string', 'username='=>'string', 'password='=>'string', 'charset='=>'string', 'buffers='=>'int', 'dialect='=>'int', 'role='=>'string'], 'ibase_prepare' => ['resource', 'link_identifier'=>'', 'query'=>'string', 'trans_identifier'=>''], 'ibase_query' => ['resource', 'link_identifier='=>'resource', 'string='=>'string', 'bind_arg='=>'int', '...args='=>''], 'ibase_restore' => ['mixed', 'service_handle'=>'resource', 'source_file'=>'string', 'dest_db'=>'string', 'options='=>'int', 'verbose='=>'bool'], 'ibase_rollback' => ['bool', 'link_identifier='=>'resource'], 'ibase_rollback_ret' => ['bool', 'link_identifier='=>'resource'], 'ibase_server_info' => ['string', 'service_handle'=>'resource', 'action'=>'int'], 'ibase_service_attach' => ['resource', 'host'=>'string', 'dba_username'=>'string', 'dba_password'=>'string'], 'ibase_service_detach' => ['bool', 'service_handle'=>'resource'], 'ibase_set_event_handler' => ['resource', 'link_identifier'=>'', 'callback'=>'callable', 'event='=>'string', '...args='=>''], 'ibase_set_event_handler\'1' => ['resource', 'callback'=>'callable', 'event'=>'string', '...args'=>''], 'ibase_timefmt' => ['bool', 'format'=>'string', 'columntype='=>'int'], 'ibase_trans' => ['resource', 'trans_args='=>'int', 'link_identifier='=>'', '...args='=>''], 'ibase_wait_event' => ['string', 'link_identifier'=>'', 'event='=>'string', '...args='=>''], 'ibase_wait_event\'1' => ['string', 'event'=>'string', '...args'=>''], 'iconv' => ['string|false', 'in_charset'=>'string', 'out_charset'=>'string', 'str'=>'string'], 'iconv_get_encoding' => ['mixed', 'type='=>'string'], 'iconv_mime_decode' => ['string|false', 'encoded_string'=>'string', 'mode='=>'int', 'charset='=>'string'], 'iconv_mime_decode_headers' => ['array|false', 'headers'=>'string', 'mode='=>'int', 'charset='=>'string'], 'iconv_mime_encode' => ['string|false', 'field_name'=>'string', 'field_value'=>'string', 'preference='=>'array'], 'iconv_set_encoding' => ['bool', 'type'=>'string', 'charset'=>'string'], 'iconv_strlen' => ['0|positive-int|false', 'str'=>'string', 'charset='=>'string'], 'iconv_strpos' => ['int|false', 'haystack'=>'string', 'needle'=>'string', 'offset='=>'int', 'charset='=>'string'], 'iconv_strrpos' => ['int|false', 'haystack'=>'string', 'needle'=>'string', 'charset='=>'string'], 'iconv_substr' => ['string|false', 'str'=>'string', 'offset'=>'int', 'length='=>'int', 'charset='=>'string'], 'id3_get_frame_long_name' => ['string', 'frameid'=>'string'], 'id3_get_frame_short_name' => ['string', 'frameid'=>'string'], 'id3_get_genre_id' => ['int', 'genre'=>'string'], 'id3_get_genre_list' => ['array'], 'id3_get_genre_name' => ['string', 'genre_id'=>'int'], 'id3_get_tag' => ['array', 'filename'=>'string', 'version='=>'int'], 'id3_get_version' => ['int', 'filename'=>'string'], 'id3_remove_tag' => ['bool', 'filename'=>'string', 'version='=>'int'], 'id3_set_tag' => ['bool', 'filename'=>'string', 'tag'=>'array', 'version='=>'int'], 'idate' => ['int|false', 'format'=>'string', 'timestamp='=>'int'], 'idn_strerror' => ['string', 'errorcode'=>'int'], 'idn_to_ascii' => ['string|false', 'domain'=>'string', 'options='=>'int', 'variant='=>'int', '&w_idna_info='=>'array'], 'idn_to_utf8' => ['string|false', 'domain'=>'string', 'options='=>'int', 'variant='=>'int', '&w_idna_info='=>'array'], 'ifx_affected_rows' => ['int', 'result_id'=>'resource'], 'ifx_blobinfile_mode' => ['bool', 'mode'=>'int'], 'ifx_byteasvarchar' => ['bool', 'mode'=>'int'], 'ifx_close' => ['bool', 'link_identifier='=>'resource'], 'ifx_connect' => ['resource', 'database='=>'string', 'userid='=>'string', 'password='=>'string'], 'ifx_copy_blob' => ['int', 'bid'=>'int'], 'ifx_create_blob' => ['int', 'type'=>'int', 'mode'=>'int', 'param'=>'string'], 'ifx_create_char' => ['int', 'param'=>'string'], 'ifx_do' => ['bool', 'result_id'=>'resource'], 'ifx_error' => ['string', 'link_identifier='=>'resource'], 'ifx_errormsg' => ['string', 'errorcode='=>'int'], 'ifx_fetch_row' => ['array', 'result_id'=>'resource', 'position='=>'mixed'], 'ifx_fieldproperties' => ['array', 'result_id'=>'resource'], 'ifx_fieldtypes' => ['array', 'result_id'=>'resource'], 'ifx_free_blob' => ['bool', 'bid'=>'int'], 'ifx_free_char' => ['bool', 'bid'=>'int'], 'ifx_free_result' => ['bool', 'result_id'=>'resource'], 'ifx_get_blob' => ['string', 'bid'=>'int'], 'ifx_get_char' => ['string', 'bid'=>'int'], 'ifx_getsqlca' => ['array', 'result_id'=>'resource'], 'ifx_htmltbl_result' => ['int', 'result_id'=>'resource', 'html_table_options='=>'string'], 'ifx_nullformat' => ['bool', 'mode'=>'int'], 'ifx_num_fields' => ['int', 'result_id'=>'resource'], 'ifx_num_rows' => ['int', 'result_id'=>'resource'], 'ifx_pconnect' => ['resource', 'database='=>'string', 'userid='=>'string', 'password='=>'string'], 'ifx_prepare' => ['resource', 'query'=>'string', 'link_identifier'=>'resource', 'cursor_def='=>'int', 'blobidarray='=>'mixed'], 'ifx_query' => ['resource', 'query'=>'string', 'link_identifier'=>'resource', 'cursor_type='=>'int', 'blobidarray='=>'mixed'], 'ifx_textasvarchar' => ['bool', 'mode'=>'int'], 'ifx_update_blob' => ['bool', 'bid'=>'int', 'content'=>'string'], 'ifx_update_char' => ['bool', 'bid'=>'int', 'content'=>'string'], 'ifxus_close_slob' => ['bool', 'bid'=>'int'], 'ifxus_create_slob' => ['int', 'mode'=>'int'], 'ifxus_free_slob' => ['bool', 'bid'=>'int'], 'ifxus_open_slob' => ['int', 'bid'=>'int', 'mode'=>'int'], 'ifxus_read_slob' => ['string', 'bid'=>'int', 'nbytes'=>'int'], 'ifxus_seek_slob' => ['int', 'bid'=>'int', 'mode'=>'int', 'offset'=>'int'], 'ifxus_tell_slob' => ['int', 'bid'=>'int'], 'ifxus_write_slob' => ['int', 'bid'=>'int', 'content'=>'string'], 'igbinary_serialize' => ['string|null', 'value'=>'mixed'], 'igbinary_unserialize' => ['mixed', 'str'=>'string'], 'ignore_user_abort' => ['0|1', 'value='=>'bool'], 'iis_add_server' => ['int', 'path'=>'string', 'comment'=>'string', 'server_ip'=>'string', 'port'=>'int', 'host_name'=>'string', 'rights'=>'int', 'start_server'=>'int'], 'iis_get_dir_security' => ['int', 'server_instance'=>'int', 'virtual_path'=>'string'], 'iis_get_script_map' => ['string', 'server_instance'=>'int', 'virtual_path'=>'string', 'script_extension'=>'string'], 'iis_get_server_by_comment' => ['int', 'comment'=>'string'], 'iis_get_server_by_path' => ['int', 'path'=>'string'], 'iis_get_server_rights' => ['int', 'server_instance'=>'int', 'virtual_path'=>'string'], 'iis_get_service_state' => ['int', 'service_id'=>'string'], 'iis_remove_server' => ['int', 'server_instance'=>'int'], 'iis_set_app_settings' => ['int', 'server_instance'=>'int', 'virtual_path'=>'string', 'application_scope'=>'string'], 'iis_set_dir_security' => ['int', 'server_instance'=>'int', 'virtual_path'=>'string', 'directory_flags'=>'int'], 'iis_set_script_map' => ['int', 'server_instance'=>'int', 'virtual_path'=>'string', 'script_extension'=>'string', 'engine_path'=>'string', 'allow_scripting'=>'int'], 'iis_set_server_rights' => ['int', 'server_instance'=>'int', 'virtual_path'=>'string', 'directory_flags'=>'int'], 'iis_start_server' => ['int', 'server_instance'=>'int'], 'iis_start_service' => ['int', 'service_id'=>'string'], 'iis_stop_server' => ['int', 'server_instance'=>'int'], 'iis_stop_service' => ['int', 'service_id'=>'string'], 'image2wbmp' => ['bool', 'im'=>'resource', 'filename='=>'?string', 'threshold='=>'int'], 'image_type_to_extension' => ['string|false', 'imagetype'=>'int', 'include_dot='=>'bool'], 'image_type_to_mime_type' => ['string', 'imagetype'=>'int'], 'imageaffine' => ['resource|false', 'src'=>'resource', 'affine'=>'array', 'clip='=>'array'], 'imageaffineconcat' => ['array', 'm1'=>'array', 'm2'=>'array'], 'imageaffinematrixconcat' => ['array{0:float,1:float,2:float,3:float,4:float,5:float}|false', 'm1'=>'array', 'm2'=>'array'], 'imageaffinematrixget' => ['array{0:float,1:float,2:float,3:float,4:float,5:float}|false', 'type'=>'int', 'options'=>'array|float'], 'imagealphablending' => ['bool', 'im'=>'resource', 'on'=>'bool'], 'imageantialias' => ['bool', 'im'=>'resource', 'on'=>'bool'], 'imagearc' => ['bool', 'im'=>'resource', 'cx'=>'int', 'cy'=>'int', 'w'=>'int', 'h'=>'int', 's'=>'int', 'e'=>'int', 'col'=>'int'], 'imagebmp' => ['bool', 'image'=>'resource', 'to='=>'string|resource|null', 'compressed='=>'bool'], 'imagechar' => ['bool', 'im'=>'resource', 'font'=>'int', 'x'=>'int', 'y'=>'int', 'c'=>'string', 'col'=>'int'], 'imagecharup' => ['bool', 'im'=>'resource', 'font'=>'int', 'x'=>'int', 'y'=>'int', 'c'=>'string', 'col'=>'int'], 'imagecolorallocate' => ['int<0, max>|false', 'im'=>'resource', 'red'=>'int', 'green'=>'int', 'blue'=>'int'], 'imagecolorallocatealpha' => ['int<0, max>|false', 'im'=>'resource', 'red'=>'int', 'green'=>'int', 'blue'=>'int', 'alpha'=>'int'], 'imagecolorat' => ['int<0, max>|false', 'im'=>'resource', 'x'=>'int', 'y'=>'int'], 'imagecolorclosest' => ['int<0, max>', 'im'=>'resource', 'red'=>'int', 'green'=>'int', 'blue'=>'int'], 'imagecolorclosestalpha' => ['int<0, max>', 'im'=>'resource', 'red'=>'int', 'green'=>'int', 'blue'=>'int', 'alpha'=>'int'], 'imagecolorclosesthwb' => ['int<0, max>', 'im'=>'resource', 'red'=>'int', 'green'=>'int', 'blue'=>'int'], 'imagecolordeallocate' => ['bool', 'im'=>'resource', 'index'=>'int'], 'imagecolorexact' => ['int<0, max>|false', 'im'=>'resource', 'red'=>'int', 'green'=>'int', 'blue'=>'int'], 'imagecolorexactalpha' => ['int<0, max>|false', 'im'=>'resource', 'red'=>'int', 'green'=>'int', 'blue'=>'int', 'alpha'=>'int'], 'imagecolormatch' => ['bool', 'im1'=>'resource', 'im2'=>'resource'], 'imagecolorresolve' => ['int<0, max>', 'im'=>'resource', 'red'=>'int', 'green'=>'int', 'blue'=>'int'], 'imagecolorresolvealpha' => ['int<0, max>', 'im'=>'resource', 'red'=>'int', 'green'=>'int', 'blue'=>'int', 'alpha'=>'int'], 'imagecolorset' => ['void', 'im'=>'resource', 'col'=>'int', 'red'=>'int', 'green'=>'int', 'blue'=>'int', 'alpha='=>'int'], 'imagecolorsforindex' => ['array{red: int<0, 255>, green: int<0, 255>, blue: int<0, 255>, alpha: int<0, 127>}', 'im'=>'resource', 'col'=>'int'], 'imagecolorstotal' => ['int<0, 256>', 'im'=>'resource'], 'imagecolortransparent' => ['int', 'im'=>'resource', 'col='=>'int'], 'imageconvolution' => ['bool', 'src_im'=>'resource', 'matrix3x3'=>'array', 'div'=>'float', 'offset'=>'float'], 'imagecopy' => ['bool', 'dst_im'=>'resource', 'src_im'=>'resource', 'dst_x'=>'int', 'dst_y'=>'int', 'src_x'=>'int', 'src_y'=>'int', 'src_w'=>'int', 'src_h'=>'int'], 'imagecopymerge' => ['bool', 'src_im'=>'resource', 'dst_im'=>'resource', 'dst_x'=>'int', 'dst_y'=>'int', 'src_x'=>'int', 'src_y'=>'int', 'src_w'=>'int', 'src_h'=>'int', 'pct'=>'int'], 'imagecopymergegray' => ['bool', 'src_im'=>'resource', 'dst_im'=>'resource', 'dst_x'=>'int', 'dst_y'=>'int', 'src_x'=>'int', 'src_y'=>'int', 'src_w'=>'int', 'src_h'=>'int', 'pct'=>'int'], 'imagecopyresampled' => ['bool', 'dst_im'=>'resource', 'src_im'=>'resource', 'dst_x'=>'int', 'dst_y'=>'int', 'src_x'=>'int', 'src_y'=>'int', 'dst_w'=>'int', 'dst_h'=>'int', 'src_w'=>'int', 'src_h'=>'int'], 'imagecopyresized' => ['bool', 'dst_im'=>'resource', 'src_im'=>'resource', 'dst_x'=>'int', 'dst_y'=>'int', 'src_x'=>'int', 'src_y'=>'int', 'dst_w'=>'int', 'dst_h'=>'int', 'src_w'=>'int', 'src_h'=>'int'], 'imagecreate' => ['__benevolent<resource|false>', 'x_size'=>'int', 'y_size'=>'int'], 'imagecreatefrombmp' => ['resource|false', 'filename'=>'string'], 'imagecreatefromgd' => ['resource|false', 'filename'=>'string'], 'imagecreatefromgd2' => ['resource|false', 'filename'=>'string'], 'imagecreatefromgd2part' => ['resource|false', 'filename'=>'string', 'srcx'=>'int', 'srcy'=>'int', 'width'=>'int', 'height'=>'int'], 'imagecreatefromgif' => ['resource|false', 'filename'=>'string'], 'imagecreatefromjpeg' => ['resource|false', 'filename'=>'string'], 'imagecreatefrompng' => ['resource|false', 'filename'=>'string'], 'imagecreatefromstring' => ['resource|false', 'image'=>'string'], 'imagecreatefromwbmp' => ['resource|false', 'filename'=>'string'], 'imagecreatefromwebp' => ['resource|false', 'filename'=>'string'], 'imagecreatefromxbm' => ['resource|false', 'filename'=>'string'], 'imagecreatefromxpm' => ['resource|false', 'filename'=>'string'], 'imagecreatetruecolor' => ['__benevolent<resource|false>', 'x_size'=>'int', 'y_size'=>'int'], 'imagecrop' => ['resource|false', 'im'=>'resource', 'rect'=>'array'], 'imagecropauto' => ['resource|false', 'im'=>'resource', 'mode='=>'int', 'threshold='=>'float', 'color='=>'int'], 'imagedashedline' => ['bool', 'im'=>'resource', 'x1'=>'int', 'y1'=>'int', 'x2'=>'int', 'y2'=>'int', 'col'=>'int'], 'imagedestroy' => ['bool', 'im'=>'resource'], 'imageellipse' => ['bool', 'im'=>'resource', 'cx'=>'int', 'cy'=>'int', 'w'=>'int', 'h'=>'int', 'color'=>'int'], 'imagefill' => ['bool', 'im'=>'resource', 'x'=>'int', 'y'=>'int', 'col'=>'int'], 'imagefilledarc' => ['bool', 'im'=>'resource', 'cx'=>'int', 'cy'=>'int', 'w'=>'int', 'h'=>'int', 's'=>'int', 'e'=>'int', 'col'=>'int', 'style'=>'int'], 'imagefilledellipse' => ['bool', 'im'=>'resource', 'cx'=>'int', 'cy'=>'int', 'w'=>'int', 'h'=>'int', 'color'=>'int'], 'imagefilledpolygon' => ['bool', 'im'=>'resource', 'point'=>'array', 'num_points'=>'int', 'col'=>'int'], 'imagefilledrectangle' => ['bool', 'im'=>'resource', 'x1'=>'int', 'y1'=>'int', 'x2'=>'int', 'y2'=>'int', 'col'=>'int'], 'imagefilltoborder' => ['bool', 'im'=>'resource', 'x'=>'int', 'y'=>'int', 'border'=>'int', 'col'=>'int'], 'imagefilter' => ['bool', 'src_im'=>'resource', 'filtertype'=>'int', 'arg1='=>'int', 'arg2='=>'int', 'arg3='=>'int', 'arg4='=>'int'], 'imageflip' => ['bool', 'im'=>'resource', 'mode'=>'int'], 'imagefontheight' => ['int', 'font'=>'int'], 'imagefontwidth' => ['int', 'font'=>'int'], 'imageftbbox' => ['array|false', 'size'=>'float', 'angle'=>'float', 'font_file'=>'string', 'text'=>'string', 'extrainfo='=>'array'], 'imagefttext' => ['array|false', 'im'=>'resource', 'size'=>'float', 'angle'=>'float', 'x'=>'int', 'y'=>'int', 'col'=>'int', 'font_file'=>'string', 'text'=>'string', 'extrainfo='=>'array'], 'imagegammacorrect' => ['bool', 'im'=>'resource', 'inputgamma'=>'float', 'outputgamma'=>'float'], 'imagegd' => ['bool', 'im'=>'resource', 'filename='=>'string|resource|null'], 'imagegd2' => ['bool', 'im'=>'resource', 'filename='=>'string|resource|null', 'chunk_size='=>'int', 'type='=>'int'], 'imagegetclip' => ['array', 'im'=>'resource'], 'imagegif' => ['bool', 'im'=>'resource', 'filename='=>'string|resource|null'], 'imagegrabscreen' => ['resource|false'], 'imagegrabwindow' => ['resource|false', 'window_handle'=>'int', 'client_area='=>'int'], 'imageinterlace' => ['int', 'im'=>'resource', 'interlace='=>'int'], 'imageistruecolor' => ['bool', 'im'=>'resource'], 'imagejpeg' => ['bool', 'im'=>'resource', 'filename='=>'string|resource|null', 'quality='=>'int'], 'imagelayereffect' => ['bool', 'im'=>'resource', 'effect'=>'int'], 'imageline' => ['bool', 'im'=>'resource', 'x1'=>'int', 'y1'=>'int', 'x2'=>'int', 'y2'=>'int', 'col'=>'int'], 'imageloadfont' => ['int|false', 'filename'=>'string'], 'imageObj::pasteImage' => ['void', 'srcImg'=>'imageObj', 'transparentColorHex'=>'int', 'dstX'=>'int', 'dstY'=>'int', 'angle'=>'int'], 'imageObj::saveImage' => ['int', 'filename'=>'string', 'oMap'=>'mapObj'], 'imageObj::saveWebImage' => ['string'], 'imageopenpolygon' => ['bool', 'image'=>'resource', 'points'=>'array', 'num_points'=>'int', 'color'=>'int'], 'imagepalettecopy' => ['void', 'dst'=>'resource', 'src'=>'resource'], 'imagepalettetotruecolor' => ['bool', 'src'=>'resource'], 'imagepng' => ['bool', 'im'=>'resource', 'filename='=>'string|resource|null', 'quality='=>'int', 'filters='=>'int'], 'imagepolygon' => ['bool', 'im'=>'resource', 'point'=>'array', 'num_points'=>'int', 'col'=>'int'], 'imagepsbbox' => ['array', 'text'=>'string', 'font'=>'', 'size'=>'int', 'space'=>'int', 'tightness'=>'int', 'angle'=>'float'], 'imagepsencodefont' => ['bool', 'font_index'=>'resource', 'encodingfile'=>'string'], 'imagepsextendfont' => ['bool', 'font_index'=>'resource', 'extend'=>'float'], 'imagepsfreefont' => ['bool', 'font_index'=>'resource'], 'imagepsloadfont' => ['resource', 'filename'=>'string'], 'imagepsslantfont' => ['bool', 'font_index'=>'resource', 'slant'=>'float'], 'imagepstext' => ['array', 'image'=>'resource', 'text'=>'string', 'font_index'=>'resource', 'size'=>'int', 'foreground'=>'int', 'background'=>'int', 'x'=>'int', 'y'=>'int', 'space='=>'int', 'tightness='=>'int', 'angle='=>'float', 'antialias_steps='=>'int'], 'imagerectangle' => ['bool', 'im'=>'resource', 'x1'=>'int', 'y1'=>'int', 'x2'=>'int', 'y2'=>'int', 'col'=>'int'], 'imageresolution' => ['mixed', 'image'=>'resource', 'res_x='=>'int', 'res_y='=>'int'], 'imagerotate' => ['resource|false', 'src_im'=>'resource', 'angle'=>'float', 'bgdcolor'=>'int', 'ignoretransparent='=>'int'], 'imagesavealpha' => ['bool', 'im'=>'resource', 'on'=>'bool'], 'imagescale' => ['resource|false', 'im'=>'resource', 'new_width'=>'int', 'new_height='=>'int', 'method='=>'int'], 'imagesetbrush' => ['bool', 'image'=>'resource', 'brush'=>'resource'], 'imagesetclip' => ['bool', 'im'=>'resource', 'x1'=>'int', 'y1'=>'int', 'x2'=>'int', 'y2'=>'int'], 'imagesetinterpolation' => ['bool', 'im'=>'resource', 'method'=>'int'], 'imagesetpixel' => ['bool', 'im'=>'resource', 'x'=>'int', 'y'=>'int', 'col'=>'int'], 'imagesetstyle' => ['bool', 'im'=>'resource', 'styles'=>'array'], 'imagesetthickness' => ['bool', 'im'=>'resource', 'thickness'=>'int'], 'imagesettile' => ['bool', 'image'=>'resource', 'tile'=>'resource'], 'imagestring' => ['bool', 'im'=>'resource', 'font'=>'int', 'x'=>'int', 'y'=>'int', 'str'=>'string', 'col'=>'int'], 'imagestringup' => ['bool', 'im'=>'resource', 'font'=>'int', 'x'=>'int', 'y'=>'int', 'str'=>'string', 'col'=>'int'], 'imagesx' => ['int<1, max>', 'im'=>'resource'], 'imagesy' => ['int<1, max>', 'im'=>'resource'], 'imagetruecolortopalette' => ['bool', 'im'=>'resource', 'ditherflag'=>'bool', 'colorswanted'=>'int'], 'imagettfbbox' => ['array|false', 'size'=>'float', 'angle'=>'float', 'font_file'=>'string', 'text'=>'string'], 'imagettftext' => ['array|false', 'im'=>'resource', 'size'=>'float', 'angle'=>'float', 'x'=>'int', 'y'=>'int', 'col'=>'int', 'font_file'=>'string', 'text'=>'string'], 'imagetypes' => ['int'], 'imagewbmp' => ['bool', 'im'=>'resource', 'filename='=>'string|resource|null', 'foreground='=>'int'], 'imagewebp' => ['bool', 'im'=>'resource', 'filename='=>'string|resource|null', 'quality='=>'int'], 'imagexbm' => ['bool', 'im'=>'resource', 'filename='=>'string|resource|null', 'foreground='=>'int'], 'Imagick::__construct' => ['void', 'files='=>''], 'Imagick::__toString' => ['string'], 'Imagick::adaptiveBlurImage' => ['bool', 'radius'=>'float', 'sigma'=>'float', 'channel='=>'int'], 'Imagick::adaptiveResizeImage' => ['bool', 'columns'=>'int', 'rows'=>'int', 'bestfit='=>'bool'], 'Imagick::adaptiveSharpenImage' => ['bool', 'radius'=>'float', 'sigma'=>'float', 'channel='=>'int'], 'Imagick::adaptiveThresholdImage' => ['bool', 'width'=>'int', 'height'=>'int', 'offset'=>'int'], 'Imagick::addImage' => ['bool', 'source'=>'imagick'], 'Imagick::addNoiseImage' => ['bool', 'noise_type'=>'int', 'channel='=>'int'], 'Imagick::affineTransformImage' => ['bool', 'matrix'=>'imagickdraw'], 'Imagick::animateImages' => ['bool', 'x_server'=>'string'], 'Imagick::annotateImage' => ['bool', 'draw_settings'=>'imagickdraw', 'x'=>'float', 'y'=>'float', 'angle'=>'float', 'text'=>'string'], 'Imagick::appendImages' => ['Imagick', 'stack'=>'bool'], 'Imagick::autoGammaImage' => ['bool', 'channel='=>'int'], 'Imagick::autoLevelImage' => ['bool', 'channel='=>'int'], 'Imagick::autoOrient' => ['bool'], 'Imagick::averageImages' => ['Imagick'], 'Imagick::blackThresholdImage' => ['bool', 'threshold'=>'mixed'], 'Imagick::blueShiftImage' => ['bool', 'factor='=>'float'], 'Imagick::blurImage' => ['bool', 'radius'=>'float', 'sigma'=>'float', 'channel='=>'int'], 'Imagick::borderImage' => ['bool', 'bordercolor'=>'mixed', 'width'=>'int', 'height'=>'int'], 'Imagick::brightnessContrastImage' => ['bool', 'brightness'=>'float', 'contrast'=>'float', 'channel='=>'int'], 'Imagick::charcoalImage' => ['bool', 'radius'=>'float', 'sigma'=>'float'], 'Imagick::chopImage' => ['bool', 'width'=>'int', 'height'=>'int', 'x'=>'int', 'y'=>'int'], 'Imagick::clampImage' => ['bool', 'channel='=>'int'], 'Imagick::clear' => ['bool'], 'Imagick::clipImage' => ['bool'], 'Imagick::clipImagePath' => ['void', 'pathname'=>'string', 'inside'=>'string'], 'Imagick::clipPathImage' => ['bool', 'pathname'=>'string', 'inside'=>'bool'], 'Imagick::clone' => ['Imagick'], 'Imagick::clutImage' => ['bool', 'lookup_table'=>'imagick', 'int='=>'float'], 'Imagick::coalesceImages' => ['Imagick'], 'Imagick::colorFloodfillImage' => ['bool', 'fill'=>'mixed', 'fuzz'=>'float', 'bordercolor'=>'mixed', 'x'=>'int', 'y'=>'int'], 'Imagick::colorizeImage' => ['bool', 'colorize'=>'mixed', 'opacity'=>'mixed'], 'Imagick::colorMatrixImage' => ['bool', 'color_matrix'=>'array'], 'Imagick::combineImages' => ['Imagick', 'channeltype'=>'int'], 'Imagick::commentImage' => ['bool', 'comment'=>'string'], 'Imagick::compareImageChannels' => ['array{Imagick,float}', 'image'=>'imagick', 'channeltype'=>'int', 'metrictype'=>'int'], 'Imagick::compareImageLayers' => ['Imagick', 'method'=>'int'], 'Imagick::compareImages' => ['array{Imagick,float}', 'compare'=>'imagick', 'metric'=>'int'], 'Imagick::compositeImage' => ['bool', 'composite_object'=>'imagick', 'composite'=>'int', 'x'=>'int', 'y'=>'int', 'channel='=>'int'], 'Imagick::compositeImageGravity' => ['bool', 'imagick'=>'Imagick', 'COMPOSITE_CONSTANT'=>'int', 'GRAVITY_CONSTANT'=>'int'], 'Imagick::contrastImage' => ['bool', 'sharpen'=>'bool'], 'Imagick::contrastStretchImage' => ['bool', 'black_point'=>'float', 'white_point'=>'float', 'channel='=>'int'], 'Imagick::convolveImage' => ['bool', 'kernel'=>'array', 'channel='=>'int'], 'Imagick::count' => ['0|positive-int', 'mode='=>'int'], 'Imagick::cropImage' => ['bool', 'width'=>'int', 'height'=>'int', 'x'=>'int', 'y'=>'int'], 'Imagick::cropThumbnailImage' => ['bool', 'width'=>'int', 'height'=>'int', 'legacy='=>'bool'], 'Imagick::current' => ['Imagick'], 'Imagick::cycleColormapImage' => ['bool', 'displace'=>'int'], 'Imagick::decipherImage' => ['bool', 'passphrase'=>'string'], 'Imagick::deconstructImages' => ['Imagick'], 'Imagick::deleteImageArtifact' => ['bool', 'artifact'=>'string'], 'Imagick::deleteImageProperty' => ['void', 'name'=>'string'], 'Imagick::deskewImage' => ['bool', 'threshold'=>'float'], 'Imagick::despeckleImage' => ['bool'], 'Imagick::destroy' => ['bool'], 'Imagick::displayImage' => ['bool', 'servername'=>'string'], 'Imagick::displayImages' => ['bool', 'servername'=>'string'], 'Imagick::distortImage' => ['bool', 'method'=>'int', 'arguments'=>'array', 'bestfit'=>'bool'], 'Imagick::drawImage' => ['bool', 'draw'=>'imagickdraw'], 'Imagick::edgeImage' => ['bool', 'radius'=>'float'], 'Imagick::embossImage' => ['bool', 'radius'=>'float', 'sigma'=>'float'], 'Imagick::encipherImage' => ['bool', 'passphrase'=>'string'], 'Imagick::enhanceImage' => ['bool'], 'Imagick::equalizeImage' => ['bool'], 'Imagick::evaluateImage' => ['bool', 'op'=>'int', 'constant'=>'float', 'channel='=>'int'], 'Imagick::evaluateImages' => ['bool', 'EVALUATE_CONSTANT'=>'int'], 'Imagick::exportImagePixels' => ['list<int>', 'x'=>'int', 'y'=>'int', 'width'=>'int', 'height'=>'int', 'map'=>'string', 'storage'=>'int'], 'Imagick::extentImage' => ['bool', 'width'=>'int', 'height'=>'int', 'x'=>'int', 'y'=>'int'], 'Imagick::filter' => ['bool', 'ImagickKernel'=>'ImagickKernel', 'CHANNEL='=>'int'], 'Imagick::flattenImages' => ['Imagick'], 'Imagick::flipImage' => ['bool'], 'Imagick::floodFillPaintImage' => ['bool', 'fill'=>'mixed', 'fuzz'=>'float', 'target'=>'mixed', 'x'=>'int', 'y'=>'int', 'invert'=>'bool', 'channel='=>'int'], 'Imagick::flopImage' => ['bool'], 'Imagick::forwardFourierTransformimage' => ['bool', 'magnitude'=>'bool'], 'Imagick::frameImage' => ['bool', 'matte_color'=>'mixed', 'width'=>'int', 'height'=>'int', 'inner_bevel'=>'int', 'outer_bevel'=>'int'], 'Imagick::functionImage' => ['bool', 'function'=>'int', 'arguments'=>'array', 'channel='=>'int'], 'Imagick::fxImage' => ['Imagick', 'expression'=>'string', 'channel='=>'int'], 'Imagick::gammaImage' => ['bool', 'gamma'=>'float', 'channel='=>'int'], 'Imagick::gaussianBlurImage' => ['bool', 'radius'=>'float', 'sigma'=>'float', 'channel='=>'int'], 'Imagick::getColorspace' => ['Imagick::COLORSPACE_*'], 'Imagick::getCompression' => ['Imagick::COMPRESSION_*'], 'Imagick::getCompressionQuality' => ['int'], 'Imagick::getConfigureOptions' => ['string'], 'Imagick::getCopyright' => ['string'], 'Imagick::getFeatures' => ['string'], 'Imagick::getFilename' => ['string'], 'Imagick::getFont' => ['string'], 'Imagick::getFormat' => ['string'], 'Imagick::getGravity' => ['Imagick::GRAVITY_*'], 'Imagick::getHDRIEnabled' => ['int'], 'Imagick::getHomeURL' => ['string'], 'Imagick::getImage' => ['Imagick'], 'Imagick::getImageAlphaChannel' => ['bool'], 'Imagick::getImageArtifact' => ['string', 'artifact'=>'string'], 'Imagick::getImageAttribute' => ['string', 'key'=>'string'], 'Imagick::getImageBackgroundColor' => ['ImagickPixel'], 'Imagick::getImageBlob' => ['string'], 'Imagick::getImageBluePrimary' => ['array{x:float,y:float}'], 'Imagick::getImageBorderColor' => ['ImagickPixel'], 'Imagick::getImageChannelDepth' => ['int', 'channel'=>'int'], 'Imagick::getImageChannelDistortion' => ['float', 'reference'=>'imagick', 'channel'=>'int', 'metric'=>'int'], 'Imagick::getImageChannelDistortions' => ['float', 'reference'=>'imagick', 'metric'=>'int', 'channel='=>'int'], 'Imagick::getImageChannelExtrema' => ['array{minima:0|positive-int,maxima:0|positive-int}', 'channel'=>'int'], 'Imagick::getImageChannelKurtosis' => ['array{kurtosis:float,skewness:float}', 'channel='=>'int'], 'Imagick::getImageChannelMean' => ['array{mean:float,standardDeviation:float}', 'channel'=>'int'], 'Imagick::getImageChannelRange' => ['array{minima:float,maxima:float}', 'channel'=>'int'], 'Imagick::getImageChannelStatistics' => ['array{mean:float,minima:float,maxima:float,standardDeviation:float,depth:int}'], 'Imagick::getImageClipMask' => ['Imagick'], 'Imagick::getImageColormapColor' => ['ImagickPixel', 'index'=>'int'], 'Imagick::getImageColors' => ['int'], 'Imagick::getImageColorspace' => ['Imagick::COLORSPACE_*'], 'Imagick::getImageCompose' => ['Imagick::COMPOSITE_*'], 'Imagick::getImageCompression' => ['Imagick::COMPRESSION_*'], 'Imagick::getImageCompressionQuality' => ['int'], 'Imagick::getImageDelay' => ['int'], 'Imagick::getImageDepth' => ['int'], 'Imagick::getImageDispose' => ['Imagick::DISPOSE_*'], 'Imagick::getImageDistortion' => ['float', 'reference'=>'magickwand', 'metric'=>'int'], 'Imagick::getImageExtrema' => ['array{min:0|positive-int,max:0|positive-int}'], 'Imagick::getImageFilename' => ['string'], 'Imagick::getImageFormat' => ['string'], 'Imagick::getImageGamma' => ['float'], 'Imagick::getImageGeometry' => ['array{width:int,height:int}'], 'Imagick::getImageGravity' => ['Imagick::GRAVITY_*'], 'Imagick::getImageGreenPrimary' => ['array{x:float,y:float}'], 'Imagick::getImageHeight' => ['int'], 'Imagick::getImageHistogram' => ['list<ImagickPixel>'], 'Imagick::getImageIndex' => ['int'], 'Imagick::getImageInterlaceScheme' => ['Imagick::INTERLACE_*'], 'Imagick::getImageInterpolateMethod' => ['Imagick::INTERPOLATE_*'], 'Imagick::getImageIterations' => ['int'], 'Imagick::getImageLength' => ['0|positive-int'], 'Imagick::getImageMagickLicense' => ['string'], 'Imagick::getImageMatte' => ['bool'], 'Imagick::getImageMatteColor' => ['ImagickPixel'], 'Imagick::getImageMimeType' => ['non-empty-string'], 'Imagick::getImageOrientation' => ['Imagick::ORIENTATION_*'], 'Imagick::getImagePage' => ['array{width:int,height:int,x:int,y:int}'], 'Imagick::getImagePixelColor' => ['ImagickPixel', 'x'=>'int', 'y'=>'int'], 'Imagick::getImageProfile' => ['string', 'name'=>'string'], 'Imagick::getImageProfiles' => ['array', 'pattern='=>'string', 'only_names='=>'bool'], 'Imagick::getImageProperties' => ['array', 'pattern='=>'string', 'only_names='=>'bool'], 'Imagick::getImageProperty' => ['string', 'name'=>'string'], 'Imagick::getImageRedPrimary' => ['array{x:float,y:float}'], 'Imagick::getImageRegion' => ['Imagick', 'width'=>'int', 'height'=>'int', 'x'=>'int', 'y'=>'int'], 'Imagick::getImageRenderingIntent' => ['Imagick::RENDERINGINTENT_*'], 'Imagick::getImageResolution' => ['array{x:float,y:float}'], 'Imagick::getImagesBlob' => ['string'], 'Imagick::getImageScene' => ['0|positive-int'], 'Imagick::getImageSignature' => ['string'], 'Imagick::getImageSize' => ['0|positive-int'], 'Imagick::getImageTicksPerSecond' => ['0|positive-int'], 'Imagick::getImageTotalInkDensity' => ['float'], 'Imagick::getImageType' => ['Imagick::IMGTYPE_*'], 'Imagick::getImageUnits' => ['int'], 'Imagick::getImageVirtualPixelMethod' => ['int'], 'Imagick::getImageWhitePoint' => ['array{x:float,y:float}'], 'Imagick::getImageWidth' => ['0|positive-int'], 'Imagick::getInterlaceScheme' => ['Imagick::INTERLACE_*'], 'Imagick::getIteratorIndex' => ['int'], 'Imagick::getNumberImages' => ['0|positive-int'], 'Imagick::getOption' => ['string', 'key'=>'string'], 'Imagick::getPackageName' => ['string'], 'Imagick::getPage' => ['array{width:int,height:int,x:int,y:int}'], 'Imagick::getPixelIterator' => ['ImagickPixelIterator'], 'Imagick::getPixelRegionIterator' => ['ImagickPixelIterator', 'x'=>'int', 'y'=>'int', 'columns'=>'int', 'rows'=>'int'], 'Imagick::getPointSize' => ['float'], 'Imagick::getQuantum' => ['0|positive-int'], 'Imagick::getQuantumDepth' => ['array{quantumDepthLong:0|positive-int,quantumDepthString:numeric-string}'], 'Imagick::getQuantumRange' => ['array{quantumRangeLong:0|positive-int,quantumRangeString:numeric-string}'], 'Imagick::getRegistry' => ['string', 'key'=>'string'], 'Imagick::getReleaseDate' => ['string'], 'Imagick::getResource' => ['int', 'type'=>'int'], 'Imagick::getResourceLimit' => ['int', 'type'=>'int'], 'Imagick::getSamplingFactors' => ['list<float>'], 'Imagick::getSize' => ['array{columns:0|positive-int,rows:0|positive-int}'], 'Imagick::getSizeOffset' => ['int'], 'Imagick::getVersion' => ['array{versionNumber:0|positive-int,versionString:non-falsy-string}'], 'Imagick::haldClutImage' => ['bool', 'clut'=>'imagick', 'channel='=>'int'], 'Imagick::hasNextImage' => ['bool'], 'Imagick::hasPreviousImage' => ['bool'], 'Imagick::identifyFormat' => ['string|false', 'embedText'=>'string'], 'Imagick::identifyImage' => ['array{imageName:string,mimetype:string,format:string,units:string,colorSpace:string,type:string,compression:string,fileSize:string,geometry:array{width:0|positive-int,height:0|positive-int},resolution:array{x:float,y:float},signature:string}', 'appendrawoutput='=>'bool'], 'Imagick::identifyImageType' => ['int'], 'Imagick::implodeImage' => ['bool', 'radius'=>'float'], 'Imagick::importImagePixels' => ['bool', 'x'=>'int', 'y'=>'int', 'width'=>'int', 'height'=>'int', 'map'=>'string', 'storage'=>'int', 'pixels'=>'array'], 'Imagick::inverseFourierTransformImage' => ['bool', 'complement'=>'Imagick', 'magnitude'=>'bool'], 'Imagick::key' => ['int|string'], 'Imagick::labelImage' => ['bool', 'label'=>'string'], 'Imagick::levelImage' => ['bool', 'blackpoint'=>'float', 'gamma'=>'float', 'whitepoint'=>'float', 'channel='=>'int'], 'Imagick::linearStretchImage' => ['bool', 'blackpoint'=>'float', 'whitepoint'=>'float'], 'Imagick::liquidRescaleImage' => ['bool', 'width'=>'int', 'height'=>'int', 'delta_x'=>'float', 'rigidity'=>'float'], 'Imagick::listRegistry' => ['array<string,string>'], 'Imagick::localContrastImage' => ['bool', 'radius'=>'float', 'strength'=>'float'], 'Imagick::magnifyImage' => ['bool'], 'Imagick::mapImage' => ['bool', 'map'=>'imagick', 'dither'=>'bool'], 'Imagick::matteFloodfillImage' => ['bool', 'alpha'=>'float', 'fuzz'=>'float', 'bordercolor'=>'mixed', 'x'=>'int', 'y'=>'int'], 'Imagick::medianFilterImage' => ['bool', 'radius'=>'float'], 'Imagick::mergeImageLayers' => ['Imagick', 'layer_method'=>'int'], 'Imagick::minifyImage' => ['bool'], 'Imagick::modulateImage' => ['bool', 'brightness'=>'float', 'saturation'=>'float', 'hue'=>'float'], 'Imagick::montageImage' => ['Imagick', 'draw'=>'imagickdraw', 'tile_geometry'=>'string', 'thumbnail_geometry'=>'string', 'mode'=>'int', 'frame'=>'string'], 'Imagick::morphImages' => ['Imagick', 'number_frames'=>'int'], 'Imagick::morphology' => ['bool', 'morphologyMethod'=>'int', 'iterations'=>'int', 'ImagickKernel'=>'ImagickKernel', 'channel='=>'int'], 'Imagick::mosaicImages' => ['Imagick'], 'Imagick::motionBlurImage' => ['bool', 'radius'=>'float', 'sigma'=>'float', 'angle'=>'float', 'channel='=>'int'], 'Imagick::negateImage' => ['bool', 'gray'=>'bool', 'channel='=>'int'], 'Imagick::newImage' => ['bool', 'cols'=>'int', 'rows'=>'int', 'background'=>'mixed', 'format='=>'string'], 'Imagick::newPseudoImage' => ['bool', 'columns'=>'int', 'rows'=>'int', 'pseudostring'=>'string'], 'Imagick::next' => ['void'], 'Imagick::nextImage' => ['bool'], 'Imagick::normalizeImage' => ['bool', 'channel='=>'int'], 'Imagick::oilPaintImage' => ['bool', 'radius'=>'float'], 'Imagick::opaquePaintImage' => ['bool', 'target'=>'mixed', 'fill'=>'mixed', 'fuzz'=>'float', 'invert'=>'bool', 'channel='=>'int'], 'Imagick::optimizeImageLayers' => ['bool'], 'Imagick::orderedPosterizeImage' => ['bool', 'threshold_map'=>'string', 'channel='=>'int'], 'Imagick::paintFloodfillImage' => ['bool', 'fill'=>'mixed', 'fuzz'=>'float', 'bordercolor'=>'mixed', 'x'=>'int', 'y'=>'int', 'channel='=>'int'], 'Imagick::paintOpaqueImage' => ['bool', 'target'=>'mixed', 'fill'=>'mixed', 'fuzz'=>'float', 'channel='=>'int'], 'Imagick::paintTransparentImage' => ['bool', 'target'=>'mixed', 'alpha'=>'float', 'fuzz'=>'float'], 'Imagick::pingImage' => ['bool', 'filename'=>'string'], 'Imagick::pingImageBlob' => ['bool', 'image'=>'string'], 'Imagick::pingImageFile' => ['bool', 'filehandle'=>'resource', 'filename='=>'string'], 'Imagick::polaroidImage' => ['bool', 'properties'=>'imagickdraw', 'angle'=>'float'], 'Imagick::posterizeImage' => ['bool', 'levels'=>'int', 'dither'=>'bool'], 'Imagick::previewImages' => ['bool', 'preview'=>'int'], 'Imagick::previousImage' => ['bool'], 'Imagick::profileImage' => ['bool', 'name'=>'string', 'profile'=>'?string'], 'Imagick::quantizeImage' => ['bool', 'numbercolors'=>'int', 'colorspace'=>'int', 'treedepth'=>'int', 'dither'=>'bool', 'measureerror'=>'bool'], 'Imagick::quantizeImages' => ['bool', 'numbercolors'=>'int', 'colorspace'=>'int', 'treedepth'=>'int', 'dither'=>'bool', 'measureerror'=>'bool'], 'Imagick::queryFontMetrics' => ['array{characterWidth:float,characterHeight:float,ascender:float,descender:float,textWidth:float,textHeight:float,maxHorizontalAdvance:float,boundingBox:array{x1:float,x2:float,y1:float,y2:float},originX:float,originY:float}', 'properties'=>'imagickdraw', 'text'=>'string', 'multiline='=>'bool'], 'Imagick::queryFonts' => ['list<string>', 'pattern='=>'string'], 'Imagick::queryFormats' => ['list<string>', 'pattern='=>'string'], 'Imagick::radialBlurImage' => ['bool', 'angle'=>'float', 'channel='=>'int'], 'Imagick::raiseImage' => ['bool', 'width'=>'int', 'height'=>'int', 'x'=>'int', 'y'=>'int', 'raise'=>'bool'], 'Imagick::randomThresholdImage' => ['bool', 'low'=>'float', 'high'=>'float', 'channel='=>'int'], 'Imagick::readImage' => ['bool', 'filename'=>'string'], 'Imagick::readImageBlob' => ['bool', 'image'=>'string', 'filename='=>'string'], 'Imagick::readImageFile' => ['bool', 'filehandle'=>'resource', 'filename='=>'string'], 'Imagick::readImages' => ['Imagick', 'filenames'=>'string'], 'Imagick::recolorImage' => ['bool', 'matrix'=>'array'], 'Imagick::reduceNoiseImage' => ['bool', 'radius'=>'float'], 'Imagick::remapImage' => ['bool', 'replacement'=>'imagick', 'dither'=>'int'], 'Imagick::removeImage' => ['bool'], 'Imagick::removeImageProfile' => ['string', 'name'=>'string'], 'Imagick::render' => ['bool'], 'Imagick::resampleImage' => ['bool', 'x_resolution'=>'float', 'y_resolution'=>'float', 'filter'=>'int', 'blur'=>'float'], 'Imagick::resetImagePage' => ['bool', 'page'=>'string'], 'Imagick::resetIterator' => [''], 'Imagick::resizeImage' => ['bool', 'columns'=>'int', 'rows'=>'int', 'filter'=>'int', 'blur'=>'float', 'bestfit='=>'bool'], 'Imagick::rewind' => ['void'], 'Imagick::rollImage' => ['bool', 'x'=>'int', 'y'=>'int'], 'Imagick::rotateImage' => ['bool', 'background'=>'mixed', 'degrees'=>'float'], 'Imagick::rotationalBlurImage' => ['bool', 'float'=>'string', 'channel='=>'int'], 'Imagick::roundCorners' => ['bool', 'x_rounding'=>'float', 'y_rounding'=>'float', 'stroke_width='=>'float', 'displace='=>'float', 'size_correction='=>'float'], 'Imagick::roundCornersImage' => ['bool', 'x_rounding'=>'', 'y_rounding'=>'', 'stroke_width='=>'', 'displace='=>'', 'size_correction='=>''], 'Imagick::sampleImage' => ['bool', 'columns'=>'int', 'rows'=>'int'], 'Imagick::scaleImage' => ['bool', 'cols'=>'int', 'rows'=>'int', 'bestfit='=>'bool', 'legacy='=>'bool'], 'Imagick::segmentImage' => ['bool', 'colorspace'=>'int', 'cluster_threshold'=>'float', 'smooth_threshold'=>'float', 'verbose='=>'bool'], 'Imagick::selectiveBlurImage' => ['bool', 'radius'=>'float', 'sigma'=>'float', 'threshold'=>'float', 'channel='=>'int'], 'Imagick::separateImageChannel' => ['bool', 'channel'=>'int'], 'Imagick::sepiaToneImage' => ['bool', 'threshold'=>'float'], 'Imagick::setAntiAlias' => ['int', 'antialias'=>'bool'], 'Imagick::setBackgroundColor' => ['bool', 'background'=>'mixed'], 'Imagick::setColorspace' => ['bool', 'colorspace'=>'int'], 'Imagick::setCompression' => ['bool', 'compression'=>'int'], 'Imagick::setCompressionQuality' => ['bool', 'quality'=>'int'], 'Imagick::setFilename' => ['bool', 'filename'=>'string'], 'Imagick::setFirstIterator' => ['bool'], 'Imagick::setFont' => ['bool', 'font'=>'string'], 'Imagick::setFormat' => ['bool', 'format'=>'string'], 'Imagick::setGravity' => ['bool', 'gravity'=>'int'], 'Imagick::setImage' => ['bool', 'replace'=>'imagick'], 'Imagick::setImageAlpha' => ['bool', 'alpha'=>'float'], 'Imagick::setImageAlphaChannel' => ['bool', 'mode'=>'int'], 'Imagick::setImageArtifact' => ['bool', 'artifact'=>'string', 'value'=>'string'], 'Imagick::setImageAttribute' => ['bool', 'key'=>'string', 'value'=>'string'], 'Imagick::setImageBackgroundColor' => ['bool', 'background'=>'mixed'], 'Imagick::setImageBias' => ['bool', 'bias'=>'float'], 'Imagick::setImageBiasQuantum' => ['void', 'bias'=>'string'], 'Imagick::setImageBluePrimary' => ['bool', 'x'=>'float', 'y'=>'float'], 'Imagick::setImageBorderColor' => ['bool', 'border'=>'mixed'], 'Imagick::setImageChannelDepth' => ['bool', 'channel'=>'int', 'depth'=>'int'], 'Imagick::setImageChannelMask' => ['', 'channel'=>'int'], 'Imagick::setImageClipMask' => ['bool', 'clip_mask'=>'imagick'], 'Imagick::setImageColormapColor' => ['bool', 'index'=>'int', 'color'=>'imagickpixel'], 'Imagick::setImageColorspace' => ['bool', 'colorspace'=>'int'], 'Imagick::setImageCompose' => ['bool', 'compose'=>'int'], 'Imagick::setImageCompression' => ['bool', 'compression'=>'int'], 'Imagick::setImageCompressionQuality' => ['bool', 'quality'=>'int'], 'Imagick::setImageDelay' => ['bool', 'delay'=>'int'], 'Imagick::setImageDepth' => ['bool', 'depth'=>'int'], 'Imagick::setImageDispose' => ['bool', 'dispose'=>'int'], 'Imagick::setImageExtent' => ['bool', 'columns'=>'int', 'rows'=>'int'], 'Imagick::setImageFilename' => ['bool', 'filename'=>'string'], 'Imagick::setImageFormat' => ['bool', 'format'=>'string'], 'Imagick::setImageGamma' => ['bool', 'gamma'=>'float'], 'Imagick::setImageGravity' => ['bool', 'gravity'=>'int'], 'Imagick::setImageGreenPrimary' => ['bool', 'x'=>'float', 'y'=>'float'], 'Imagick::setImageIndex' => ['bool', 'index'=>'int'], 'Imagick::setImageInterlaceScheme' => ['bool', 'interlace_scheme'=>'int'], 'Imagick::setImageInterpolateMethod' => ['bool', 'method'=>'int'], 'Imagick::setImageIterations' => ['bool', 'iterations'=>'int'], 'Imagick::setImageMatte' => ['bool', 'matte'=>'bool'], 'Imagick::setImageMatteColor' => ['bool', 'matte'=>'mixed'], 'Imagick::setImageOpacity' => ['bool', 'opacity'=>'float'], 'Imagick::setImageOrientation' => ['bool', 'orientation'=>'int'], 'Imagick::setImagePage' => ['bool', 'width'=>'int', 'height'=>'int', 'x'=>'int', 'y'=>'int'], 'Imagick::setImageProfile' => ['bool', 'name'=>'string', 'profile'=>'string'], 'Imagick::setImageProgressMonitor' => ['', 'filename'=>''], 'Imagick::setImageProperty' => ['bool', 'name'=>'string', 'value'=>'string'], 'Imagick::setImageRedPrimary' => ['bool', 'x'=>'float', 'y'=>'float'], 'Imagick::setImageRenderingIntent' => ['bool', 'rendering_intent'=>'int'], 'Imagick::setImageResolution' => ['bool', 'x_resolution'=>'float', 'y_resolution'=>'float'], 'Imagick::setImageScene' => ['bool', 'scene'=>'int'], 'Imagick::setImageTicksPerSecond' => ['bool', 'ticks_per_second'=>'int'], 'Imagick::setImageType' => ['bool', 'image_type'=>'int'], 'Imagick::setImageUnits' => ['bool', 'units'=>'int'], 'Imagick::setImageVirtualPixelMethod' => ['bool', 'method'=>'int'], 'Imagick::setImageWhitePoint' => ['bool', 'x'=>'float', 'y'=>'float'], 'Imagick::setInterlaceScheme' => ['bool', 'interlace_scheme'=>'int'], 'Imagick::setIteratorIndex' => ['bool', 'index'=>'int'], 'Imagick::setLastIterator' => ['bool'], 'Imagick::setOption' => ['bool', 'key'=>'string', 'value'=>'string'], 'Imagick::setPage' => ['bool', 'width'=>'int', 'height'=>'int', 'x'=>'int', 'y'=>'int'], 'Imagick::setPointSize' => ['bool', 'point_size'=>'float'], 'Imagick::setProgressMonitor' => ['bool', 'callback'=>'callable'], 'Imagick::setRegistry' => ['bool', 'key'=>'string', 'value'=>'string'], 'Imagick::setResolution' => ['bool', 'x_resolution'=>'float', 'y_resolution'=>'float'], 'Imagick::setResourceLimit' => ['bool', 'type'=>'int', 'limit'=>'int'], 'Imagick::setSamplingFactors' => ['bool', 'factors'=>'array'], 'Imagick::setSize' => ['bool', 'columns'=>'int', 'rows'=>'int'], 'Imagick::setSizeOffset' => ['bool', 'columns'=>'int', 'rows'=>'int', 'offset'=>'int'], 'Imagick::setType' => ['bool', 'image_type'=>'int'], 'Imagick::shadeImage' => ['bool', 'gray'=>'bool', 'azimuth'=>'float', 'elevation'=>'float'], 'Imagick::shadowImage' => ['bool', 'opacity'=>'float', 'sigma'=>'float', 'x'=>'int', 'y'=>'int'], 'Imagick::sharpenImage' => ['bool', 'radius'=>'float', 'sigma'=>'float', 'channel='=>'int'], 'Imagick::shaveImage' => ['bool', 'columns'=>'int', 'rows'=>'int'], 'Imagick::shearImage' => ['bool', 'background'=>'mixed', 'x_shear'=>'float', 'y_shear'=>'float'], 'Imagick::sigmoidalContrastImage' => ['bool', 'sharpen'=>'bool', 'alpha'=>'float', 'beta'=>'float', 'channel='=>'int'], 'Imagick::similarityImage' => ['Imagick', 'imagick'=>'Imagick', '&bestMatch'=>'array', '&similarity'=>'float', 'similarity_threshold'=>'float', 'metric'=>'int'], 'Imagick::sketchImage' => ['bool', 'radius'=>'float', 'sigma'=>'float', 'angle'=>'float'], 'Imagick::smushImages' => ['Imagick', 'stack'=>'bool', 'offset'=>'int'], 'Imagick::solarizeImage' => ['bool', 'threshold'=>'0|positive-int'], 'Imagick::sparseColorImage' => ['bool', 'sparse_method'=>'int', 'arguments'=>'array', 'channel='=>'int'], 'Imagick::spliceImage' => ['bool', 'width'=>'int', 'height'=>'int', 'x'=>'int', 'y'=>'int'], 'Imagick::spreadImage' => ['bool', 'radius'=>'float'], 'Imagick::statisticImage' => ['bool', 'type'=>'int', 'width'=>'int', 'height'=>'int', 'channel='=>'int'], 'Imagick::steganoImage' => ['Imagick', 'watermark_wand'=>'imagick', 'offset'=>'int'], 'Imagick::stereoImage' => ['bool', 'offset_wand'=>'imagick'], 'Imagick::stripImage' => ['bool'], 'Imagick::subImageMatch' => ['Imagick', 'Imagick'=>'Imagick', '&w_offset='=>'array', '&w_similarity='=>'float'], 'Imagick::swirlImage' => ['bool', 'degrees'=>'float'], 'Imagick::textureImage' => ['Imagick', 'texture_wand'=>'imagick'], 'Imagick::thresholdImage' => ['bool', 'threshold'=>'float', 'channel='=>'int'], 'Imagick::thumbnailImage' => ['bool', 'columns'=>'int', 'rows'=>'int', 'bestfit='=>'bool', 'fill='=>'bool', 'legacy='=>'bool'], 'Imagick::tintImage' => ['bool', 'tint'=>'mixed', 'opacity'=>'mixed'], 'Imagick::transformImage' => ['Imagick', 'crop'=>'string', 'geometry'=>'string'], 'Imagick::transformImageColorspace' => ['bool', 'colorspace'=>'int'], 'Imagick::transparentPaintImage' => ['bool', 'target'=>'mixed', 'alpha'=>'float', 'fuzz'=>'float', 'invert'=>'bool'], 'Imagick::transposeImage' => ['bool'], 'Imagick::transverseImage' => ['bool'], 'Imagick::trimImage' => ['bool', 'fuzz'=>'float'], 'Imagick::uniqueImageColors' => ['bool'], 'Imagick::unsharpMaskImage' => ['bool', 'radius'=>'float', 'sigma'=>'float', 'amount'=>'float', 'threshold'=>'float', 'channel='=>'int'], 'Imagick::valid' => ['bool'], 'Imagick::vignetteImage' => ['bool', 'blackpoint'=>'float', 'whitepoint'=>'float', 'x'=>'int', 'y'=>'int'], 'Imagick::waveImage' => ['bool', 'amplitude'=>'float', 'length'=>'float'], 'Imagick::whiteThresholdImage' => ['bool', 'threshold'=>'mixed'], 'Imagick::writeImage' => ['bool', 'filename='=>'string'], 'Imagick::writeImageFile' => ['bool', 'filehandle'=>'resource', 'format='=>'?string'], 'Imagick::writeImages' => ['bool', 'filename'=>'string', 'adjoin'=>'bool'], 'Imagick::writeImagesFile' => ['bool', 'filehandle'=>'resource', 'format='=>'?string'], 'ImagickDraw::__construct' => ['void'], 'ImagickDraw::affine' => ['bool', 'affine'=>'array'], 'ImagickDraw::annotation' => ['bool', 'x'=>'float', 'y'=>'float', 'text'=>'string'], 'ImagickDraw::arc' => ['bool', 'sx'=>'float', 'sy'=>'float', 'ex'=>'float', 'ey'=>'float', 'sd'=>'float', 'ed'=>'float'], 'ImagickDraw::bezier' => ['bool', 'coordinates'=>'array'], 'ImagickDraw::circle' => ['bool', 'ox'=>'float', 'oy'=>'float', 'px'=>'float', 'py'=>'float'], 'ImagickDraw::clear' => ['bool'], 'ImagickDraw::clone' => ['ImagickDraw'], 'ImagickDraw::color' => ['bool', 'x'=>'float', 'y'=>'float', 'paintmethod'=>'int'], 'ImagickDraw::comment' => ['bool', 'comment'=>'string'], 'ImagickDraw::composite' => ['bool', 'compose'=>'int', 'x'=>'float', 'y'=>'float', 'width'=>'float', 'height'=>'float', 'compositewand'=>'imagick'], 'ImagickDraw::destroy' => ['bool'], 'ImagickDraw::ellipse' => ['bool', 'ox'=>'float', 'oy'=>'float', 'rx'=>'float', 'ry'=>'float', 'start'=>'float', 'end'=>'float'], 'ImagickDraw::getBorderColor' => ['ImagickPixel'], 'ImagickDraw::getClipPath' => ['string'], 'ImagickDraw::getClipRule' => ['int'], 'ImagickDraw::getClipUnits' => ['int'], 'ImagickDraw::getDensity' => ['null|string'], 'ImagickDraw::getFillColor' => ['ImagickPixel'], 'ImagickDraw::getFillOpacity' => ['float'], 'ImagickDraw::getFillRule' => ['Imagick::FILLRULE_*'], 'ImagickDraw::getFont' => ['string'], 'ImagickDraw::getFontFamily' => ['string'], 'ImagickDraw::getFontResolution' => ['array'], 'ImagickDraw::getFontSize' => ['float'], 'ImagickDraw::getFontStretch' => ['Imagick::STRETCH_*'], 'ImagickDraw::getFontStyle' => ['Imagick::STYLE_*'], 'ImagickDraw::getFontWeight' => ['int'], 'ImagickDraw::getGravity' => ['Imagick::GRAVITY_*'], 'ImagickDraw::getOpacity' => ['float'], 'ImagickDraw::getStrokeAntialias' => ['bool'], 'ImagickDraw::getStrokeColor' => ['ImagickPixel'], 'ImagickDraw::getStrokeDashArray' => ['array'], 'ImagickDraw::getStrokeDashOffset' => ['float'], 'ImagickDraw::getStrokeLineCap' => ['Imagick::LINECAP_*'], 'ImagickDraw::getStrokeLineJoin' => ['Imagick::LINEJOIN_*'], 'ImagickDraw::getStrokeMiterLimit' => ['int'], 'ImagickDraw::getStrokeOpacity' => ['float'], 'ImagickDraw::getStrokeWidth' => ['float'], 'ImagickDraw::getTextAlignment' => ['Imagick::ALIGN_*'], 'ImagickDraw::getTextAntialias' => ['bool'], 'ImagickDraw::getTextDecoration' => ['Imagick::DECORATION_*'], 'ImagickDraw::getTextDirection' => ['bool'], 'ImagickDraw::getTextEncoding' => ['string'], 'ImagickDraw::getTextInterlineSpacing' => ['float'], 'ImagickDraw::getTextInterwordSpacing' => ['float'], 'ImagickDraw::getTextKerning' => ['float'], 'ImagickDraw::getTextUnderColor' => ['ImagickPixel'], 'ImagickDraw::getVectorGraphics' => ['string'], 'ImagickDraw::line' => ['bool', 'sx'=>'float', 'sy'=>'float', 'ex'=>'float', 'ey'=>'float'], 'ImagickDraw::matte' => ['bool', 'x'=>'float', 'y'=>'float', 'paintmethod'=>'int'], 'ImagickDraw::pathClose' => ['bool'], 'ImagickDraw::pathCurveToAbsolute' => ['bool', 'x1'=>'float', 'y1'=>'float', 'x2'=>'float', 'y2'=>'float', 'x'=>'float', 'y'=>'float'], 'ImagickDraw::pathCurveToQuadraticBezierAbsolute' => ['bool', 'x1'=>'float', 'y1'=>'float', 'x'=>'float', 'y'=>'float'], 'ImagickDraw::pathCurveToQuadraticBezierRelative' => ['bool', 'x1'=>'float', 'y1'=>'float', 'x'=>'float', 'y'=>'float'], 'ImagickDraw::pathCurveToQuadraticBezierSmoothAbsolute' => ['bool', 'x'=>'float', 'y'=>'float'], 'ImagickDraw::pathCurveToQuadraticBezierSmoothRelative' => ['bool', 'x'=>'float', 'y'=>'float'], 'ImagickDraw::pathCurveToRelative' => ['bool', 'x1'=>'float', 'y1'=>'float', 'x2'=>'float', 'y2'=>'float', 'x'=>'float', 'y'=>'float'], 'ImagickDraw::pathCurveToSmoothAbsolute' => ['bool', 'x2'=>'float', 'y2'=>'float', 'x'=>'float', 'y'=>'float'], 'ImagickDraw::pathCurveToSmoothRelative' => ['bool', 'x2'=>'float', 'y2'=>'float', 'x'=>'float', 'y'=>'float'], 'ImagickDraw::pathEllipticArcAbsolute' => ['bool', 'rx'=>'float', 'ry'=>'float', 'x_axis_rotation'=>'float', 'large_arc_flag'=>'bool', 'sweep_flag'=>'bool', 'x'=>'float', 'y'=>'float'], 'ImagickDraw::pathEllipticArcRelative' => ['bool', 'rx'=>'float', 'ry'=>'float', 'x_axis_rotation'=>'float', 'large_arc_flag'=>'bool', 'sweep_flag'=>'bool', 'x'=>'float', 'y'=>'float'], 'ImagickDraw::pathFinish' => ['bool'], 'ImagickDraw::pathLineToAbsolute' => ['bool', 'x'=>'float', 'y'=>'float'], 'ImagickDraw::pathLineToHorizontalAbsolute' => ['bool', 'x'=>'float'], 'ImagickDraw::pathLineToHorizontalRelative' => ['bool', 'x'=>'float'], 'ImagickDraw::pathLineToRelative' => ['bool', 'x'=>'float', 'y'=>'float'], 'ImagickDraw::pathLineToVerticalAbsolute' => ['bool', 'y'=>'float'], 'ImagickDraw::pathLineToVerticalRelative' => ['bool', 'y'=>'float'], 'ImagickDraw::pathMoveToAbsolute' => ['bool', 'x'=>'float', 'y'=>'float'], 'ImagickDraw::pathMoveToRelative' => ['bool', 'x'=>'float', 'y'=>'float'], 'ImagickDraw::pathStart' => ['bool'], 'ImagickDraw::point' => ['bool', 'x'=>'float', 'y'=>'float'], 'ImagickDraw::polygon' => ['bool', 'coordinates'=>'array'], 'ImagickDraw::polyline' => ['bool', 'coordinates'=>'array'], 'ImagickDraw::pop' => ['bool'], 'ImagickDraw::popClipPath' => ['bool'], 'ImagickDraw::popDefs' => ['bool'], 'ImagickDraw::popPattern' => ['bool'], 'ImagickDraw::push' => ['bool'], 'ImagickDraw::pushClipPath' => ['bool', 'clip_mask_id'=>'string'], 'ImagickDraw::pushDefs' => ['bool'], 'ImagickDraw::pushPattern' => ['bool', 'pattern_id'=>'string', 'x'=>'float', 'y'=>'float', 'width'=>'float', 'height'=>'float'], 'ImagickDraw::rectangle' => ['bool', 'x1'=>'float', 'y1'=>'float', 'x2'=>'float', 'y2'=>'float'], 'ImagickDraw::render' => ['bool'], 'ImagickDraw::resetVectorGraphics' => ['void'], 'ImagickDraw::rotate' => ['bool', 'degrees'=>'float'], 'ImagickDraw::roundRectangle' => ['bool', 'x1'=>'float', 'y1'=>'float', 'x2'=>'float', 'y2'=>'float', 'rx'=>'float', 'ry'=>'float'], 'ImagickDraw::scale' => ['bool', 'x'=>'float', 'y'=>'float'], 'ImagickDraw::setBorderColor' => ['bool', 'color'=>'ImagickPixel|string'], 'ImagickDraw::setClipPath' => ['bool', 'clip_mask'=>'string'], 'ImagickDraw::setClipRule' => ['bool', 'fill_rule'=>'int'], 'ImagickDraw::setClipUnits' => ['bool', 'clip_units'=>'int'], 'ImagickDraw::setDensity' => ['bool', 'density_string'=>'string'], 'ImagickDraw::setFillAlpha' => ['bool', 'opacity'=>'float'], 'ImagickDraw::setFillColor' => ['bool', 'fill_pixel'=>'ImagickPixel|string'], 'ImagickDraw::setFillOpacity' => ['bool', 'fillopacity'=>'float'], 'ImagickDraw::setFillPatternURL' => ['bool', 'fill_url'=>'string'], 'ImagickDraw::setFillRule' => ['bool', 'fill_rule'=>'int'], 'ImagickDraw::setFont' => ['bool', 'font_name'=>'string'], 'ImagickDraw::setFontFamily' => ['bool', 'font_family'=>'string'], 'ImagickDraw::setFontResolution' => ['bool', 'x'=>'float', 'y'=>'float'], 'ImagickDraw::setFontSize' => ['bool', 'pointsize'=>'float'], 'ImagickDraw::setFontStretch' => ['bool', 'fontstretch'=>'int'], 'ImagickDraw::setFontStyle' => ['bool', 'style'=>'int'], 'ImagickDraw::setFontWeight' => ['bool', 'font_weight'=>'int'], 'ImagickDraw::setGravity' => ['bool', 'gravity'=>'int'], 'ImagickDraw::setOpacity' => ['void', 'opacity'=>'float'], 'ImagickDraw::setResolution' => ['void', 'x_resolution'=>'float', 'y_resolution'=>'float'], 'ImagickDraw::setStrokeAlpha' => ['bool', 'opacity'=>'float'], 'ImagickDraw::setStrokeAntialias' => ['bool', 'stroke_antialias'=>'bool'], 'ImagickDraw::setStrokeColor' => ['bool', 'stroke_pixel'=>'ImagickPixel|string'], 'ImagickDraw::setStrokeDashArray' => ['bool', 'dasharray'=>'array'], 'ImagickDraw::setStrokeDashOffset' => ['bool', 'dash_offset'=>'float'], 'ImagickDraw::setStrokeLineCap' => ['bool', 'linecap'=>'int'], 'ImagickDraw::setStrokeLineJoin' => ['bool', 'linejoin'=>'int'], 'ImagickDraw::setStrokeMiterLimit' => ['bool', 'miterlimit'=>'int'], 'ImagickDraw::setStrokeOpacity' => ['bool', 'stroke_opacity'=>'float'], 'ImagickDraw::setStrokePatternURL' => ['bool', 'stroke_url'=>'string'], 'ImagickDraw::setStrokeWidth' => ['bool', 'stroke_width'=>'float'], 'ImagickDraw::setTextAlignment' => ['bool', 'alignment'=>'int'], 'ImagickDraw::setTextAntialias' => ['bool', 'antialias'=>'bool'], 'ImagickDraw::setTextDecoration' => ['bool', 'decoration'=>'int'], 'ImagickDraw::setTextDirection' => ['bool', 'direction'=>'int'], 'ImagickDraw::setTextEncoding' => ['bool', 'encoding'=>'string'], 'ImagickDraw::setTextInterlineSpacing' => ['void', 'spacing'=>'float'], 'ImagickDraw::setTextInterwordSpacing' => ['void', 'spacing'=>'float'], 'ImagickDraw::setTextKerning' => ['void', 'kerning'=>'float'], 'ImagickDraw::setTextUnderColor' => ['bool', 'under_color'=>'ImagickPixel|string'], 'ImagickDraw::setVectorGraphics' => ['bool', 'xml'=>'string'], 'ImagickDraw::setViewbox' => ['bool', 'x1'=>'int', 'y1'=>'int', 'x2'=>'int', 'y2'=>'int'], 'ImagickDraw::skewX' => ['bool', 'degrees'=>'float'], 'ImagickDraw::skewY' => ['bool', 'degrees'=>'float'], 'ImagickDraw::translate' => ['bool', 'x'=>'float', 'y'=>'float'], 'ImagickKernel::addKernel' => ['void', 'ImagickKernel'=>'ImagickKernel'], 'ImagickKernel::addUnityKernel' => ['void'], 'ImagickKernel::fromBuiltin' => ['ImagickKernel', 'kernelType'=>'int', 'kernelString'=>'string'], 'ImagickKernel::fromMatrix' => ['ImagickKernel', 'matrix'=>'array', 'origin='=>'array'], 'ImagickKernel::getMatrix' => ['list<list<float|false>>'], 'ImagickKernel::scale' => ['void', 'scale'=>'float', 'normalizeFlag'=>'int'], 'ImagickKernel::separate' => ['array'], 'ImagickPixel::__construct' => ['void', 'color='=>'string'], 'ImagickPixel::clear' => ['bool'], 'ImagickPixel::clone' => ['void'], 'ImagickPixel::destroy' => ['bool'], 'ImagickPixel::getColor' => ['array{r: int|float, g: int|float, b: int|float, a: int|float}', 'normalized='=>'0|1|2'], 'ImagickPixel::getColorAsString' => ['string'], 'ImagickPixel::getColorCount' => ['int'], 'ImagickPixel::getColorQuantum' => ['mixed'], 'ImagickPixel::getColorValue' => ['float', 'color'=>'int'], 'ImagickPixel::getColorValueQuantum' => ['mixed'], 'ImagickPixel::getHSL' => ['array'], 'ImagickPixel::getIndex' => ['int'], 'ImagickPixel::isPixelSimilar' => ['bool', 'color'=>'ImagickPixel', 'fuzz'=>'float'], 'ImagickPixel::isPixelSimilarQuantum' => ['bool', 'color'=>'string', 'fuzz='=>'string'], 'ImagickPixel::isSimilar' => ['bool', 'color'=>'imagickpixel', 'fuzz'=>'float'], 'ImagickPixel::setColor' => ['bool', 'color'=>'string'], 'ImagickPixel::setcolorcount' => ['void', 'colorCount'=>'string'], 'ImagickPixel::setColorFromPixel' => ['bool', 'srcPixel'=>'ImagickPixel'], 'ImagickPixel::setColorValue' => ['bool', 'color'=>'int', 'value'=>'float'], 'ImagickPixel::setColorValueQuantum' => ['void', 'color'=>'int', 'value'=>'mixed'], 'ImagickPixel::setHSL' => ['bool', 'hue'=>'float', 'saturation'=>'float', 'luminosity'=>'float'], 'ImagickPixel::setIndex' => ['void', 'index'=>'int'], 'ImagickPixelIterator::__construct' => ['void', 'wand'=>'imagick'], 'ImagickPixelIterator::clear' => ['bool'], 'ImagickPixelIterator::current' => ['mixed'], 'ImagickPixelIterator::destroy' => ['bool'], 'ImagickPixelIterator::getCurrentIteratorRow' => ['array'], 'ImagickPixelIterator::getIteratorRow' => ['int'], 'ImagickPixelIterator::getNextIteratorRow' => ['array'], 'ImagickPixelIterator::getpixeliterator' => ['', 'Imagick'=>'Imagick'], 'ImagickPixelIterator::getpixelregioniterator' => ['', 'Imagick'=>'Imagick', 'x'=>'', 'y'=>'', 'columns'=>'', 'rows'=>''], 'ImagickPixelIterator::getPreviousIteratorRow' => ['array'], 'ImagickPixelIterator::key' => ['int|string'], 'ImagickPixelIterator::newPixelIterator' => ['bool', 'wand'=>'imagick'], 'ImagickPixelIterator::newPixelRegionIterator' => ['bool', 'wand'=>'imagick', 'x'=>'int', 'y'=>'int', 'columns'=>'int', 'rows'=>'int'], 'ImagickPixelIterator::next' => ['void'], 'ImagickPixelIterator::resetIterator' => ['bool'], 'ImagickPixelIterator::rewind' => ['void'], 'ImagickPixelIterator::setIteratorFirstRow' => ['bool'], 'ImagickPixelIterator::setIteratorLastRow' => ['bool'], 'ImagickPixelIterator::setIteratorRow' => ['bool', 'row'=>'int'], 'ImagickPixelIterator::syncIterator' => ['bool'], 'ImagickPixelIterator::valid' => ['bool'], 'imap_8bit' => ['string|false', 'text'=>'string'], 'imap_alerts' => ['array|false'], 'imap_append' => ['bool', 'stream_id'=>'resource', 'folder'=>'string', 'message'=>'string', 'options='=>'string', 'internal_date='=>'string'], 'imap_base64' => ['string|false', 'text'=>'string'], 'imap_binary' => ['string|false', 'text'=>'string'], 'imap_body' => ['string|false', 'stream_id'=>'resource', 'msg_no'=>'int', 'options='=>'int'], 'imap_bodystruct' => ['stdClass|false', 'stream_id'=>'resource', 'msg_no'=>'int', 'section'=>'string'], 'imap_check' => ['stdClass|false', 'stream_id'=>'resource'], 'imap_clearflag_full' => ['bool', 'stream_id'=>'resource', 'sequence'=>'string', 'flag'=>'string', 'options='=>'int'], 'imap_close' => ['bool', 'stream_id'=>'resource', 'options='=>'int'], 'imap_create' => ['bool', 'stream_id'=>'resource', 'mailbox'=>'string'], 'imap_createmailbox' => ['bool', 'stream_id'=>'resource', 'mailbox'=>'string'], 'imap_delete' => ['bool', 'stream_id'=>'resource', 'msg_no'=>'string', 'options='=>'int'], 'imap_deletemailbox' => ['bool', 'stream_id'=>'resource', 'mailbox'=>'string'], 'imap_errors' => ['array|false'], 'imap_expunge' => ['bool', 'stream_id'=>'resource'], 'imap_fetch_overview' => ['array|false', 'stream_id'=>'resource', 'sequence'=>'string', 'options='=>'int'], 'imap_fetchbody' => ['string|false', 'stream_id'=>'resource', 'msg_no'=>'int', 'section'=>'string', 'options='=>'int'], 'imap_fetchheader' => ['string|false', 'stream_id'=>'resource', 'msg_no'=>'int', 'options='=>'int'], 'imap_fetchmime' => ['string|false', 'stream_id'=>'resource', 'msg_no'=>'int', 'section'=>'string', 'options='=>'int'], 'imap_fetchstructure' => ['stdClass|false', 'stream_id'=>'resource', 'msg_no'=>'int', 'options='=>'int'], 'imap_fetchtext' => ['string|false', 'stream_id'=>'resource', 'msg_no'=>'int', 'options='=>'int'], 'imap_gc' => ['bool', 'stream_id'=>'resource', 'flags'=>'int'], 'imap_get_quota' => ['array|false', 'stream_id'=>'resource', 'qroot'=>'string'], 'imap_get_quotaroot' => ['array|false', 'stream_id'=>'resource', 'mbox'=>'string'], 'imap_getacl' => ['array|false', 'stream_id'=>'resource', 'mailbox'=>'string'], 'imap_getmailboxes' => ['array|false', 'stream_id'=>'resource', 'ref'=>'string', 'pattern'=>'string'], 'imap_getsubscribed' => ['array|false', 'stream_id'=>'resource', 'ref'=>'string', 'pattern'=>'string'], 'imap_header' => ['stdClass|false', 'stream_id'=>'resource', 'msg_no'=>'int', 'from_length='=>'int', 'subject_length='=>'int', 'default_host='=>'string'], 'imap_headerinfo' => ['stdClass|false', 'stream_id'=>'resource', 'msg_no'=>'int', 'from_length='=>'int', 'subject_length='=>'int', 'default_host='=>'string|null'], 'imap_headers' => ['array|false', 'stream_id'=>'resource'], 'imap_last_error' => ['string|false'], 'imap_list' => ['array|false', 'stream_id'=>'resource', 'ref'=>'string', 'pattern'=>'string'], 'imap_listmailbox' => ['array|false', 'stream_id'=>'resource', 'ref'=>'string', 'pattern'=>'string'], 'imap_listscan' => ['array|false', 'stream_id'=>'resource', 'ref'=>'string', 'pattern'=>'string', 'content'=>'string'], 'imap_listsubscribed' => ['array|false', 'stream_id'=>'resource', 'ref'=>'string', 'pattern'=>'string'], 'imap_lsub' => ['array|false', 'stream_id'=>'resource', 'ref'=>'string', 'pattern'=>'string'], 'imap_mail' => ['bool', 'to'=>'string', 'subject'=>'string', 'message'=>'string', 'additional_headers='=>'string', 'cc='=>'string', 'bcc='=>'string', 'rpath='=>'string'], 'imap_mail_compose' => ['string|false', 'envelope'=>'array', 'body'=>'array'], 'imap_mail_copy' => ['bool', 'stream_id'=>'resource', 'msglist'=>'string', 'mailbox'=>'string', 'options='=>'int'], 'imap_mail_move' => ['bool', 'stream_id'=>'resource', 'sequence'=>'string', 'mailbox'=>'string', 'options='=>'int'], 'imap_mailboxmsginfo' => ['stdClass|false', 'stream_id'=>'resource'], 'imap_mime_header_decode' => ['array|false', 'str'=>'string'], 'imap_msgno' => ['int|false', 'stream_id'=>'resource', 'unique_msg_id'=>'int'], 'imap_mutf7_to_utf8' => ['string|false', 'in'=>'string'], 'imap_num_msg' => ['int|false', 'stream_id'=>'resource'], 'imap_num_recent' => ['int|false', 'stream_id'=>'resource'], 'imap_open' => ['resource|false', 'mailbox'=>'string', 'user'=>'string', 'password'=>'string', 'options='=>'int', 'n_retries='=>'int', 'params='=>'array|null'], 'imap_ping' => ['bool', 'stream_id'=>'resource'], 'imap_qprint' => ['string|false', 'text'=>'string'], 'imap_rename' => ['bool', 'stream_id'=>'resource', 'old_name'=>'string', 'new_name'=>'string'], 'imap_renamemailbox' => ['bool', 'stream_id'=>'resource', 'old_name'=>'string', 'new_name'=>'string'], 'imap_reopen' => ['bool', 'stream_id'=>'resource', 'mailbox'=>'string', 'options='=>'int', 'n_retries='=>'int'], 'imap_rfc822_parse_adrlist' => ['array', 'address_string'=>'string', 'default_host'=>'string'], 'imap_rfc822_parse_headers' => ['stdClass', 'headers'=>'string', 'default_host='=>'string'], 'imap_rfc822_write_address' => ['string|false', 'mailbox'=>'?string', 'host'=>'?string', 'personal'=>'?string'], 'imap_savebody' => ['bool', 'stream_id'=>'resource', 'file'=>'string|resource', 'msg_no'=>'int', 'section='=>'string', 'options='=>'int'], 'imap_scan' => ['array|false', 'stream_id'=>'resource', 'ref'=>'string', 'pattern'=>'string', 'content'=>'string'], 'imap_scanmailbox' => ['array|false', 'stream_id'=>'resource', 'ref'=>'string', 'pattern'=>'string', 'content'=>'string'], 'imap_search' => ['array|false', 'stream_id'=>'resource', 'criteria'=>'string', 'options='=>'int', 'charset='=>'string'], 'imap_set_quota' => ['bool', 'stream_id'=>'resource', 'qroot'=>'string', 'mailbox_size'=>'int'], 'imap_setacl' => ['bool', 'stream_id'=>'resource', 'mailbox'=>'string', 'id'=>'string', 'rights'=>'string'], 'imap_setflag_full' => ['bool', 'stream_id'=>'resource', 'sequence'=>'string', 'flag'=>'string', 'options='=>'int'], 'imap_sort' => ['array|false', 'stream_id'=>'resource', 'criteria'=>'int', 'reverse'=>'int', 'options='=>'int', 'search_criteria='=>'string', 'charset='=>'string'], 'imap_status' => ['stdClass|false', 'stream_id'=>'resource', 'mailbox'=>'string', 'options'=>'int'], 'imap_subscribe' => ['bool', 'stream_id'=>'resource', 'mailbox'=>'string'], 'imap_thread' => ['array|false', 'stream_id'=>'resource', 'options='=>'int'], 'imap_timeout' => ['mixed', 'timeout_type'=>'int', 'timeout='=>'int'], 'imap_uid' => ['int|false', 'stream_id'=>'resource', 'msg_no'=>'int'], 'imap_undelete' => ['bool', 'stream_id'=>'resource', 'msg_no'=>'string', 'flags='=>'int'], 'imap_unsubscribe' => ['bool', 'stream_id'=>'resource', 'mailbox'=>'string'], 'imap_utf7_decode' => ['string|false', 'buf'=>'string'], 'imap_utf7_encode' => ['string', 'buf'=>'string'], 'imap_utf8' => ['string', 'mime_encoded_text'=>'string'], 'imap_utf8_to_mutf7' => ['string|false', 'in'=>'string'], 'implode' => ['string', 'glue'=>'string', 'pieces'=>'array'], 'implode\'1' => ['string', 'pieces'=>'array'], 'implode\'2' => ['string', 'pieces'=>'array', 'glue'=>'string'], 'import_request_variables' => ['bool', 'types'=>'string', 'prefix='=>'string'], 'in_array' => ['bool', 'needle'=>'mixed', 'haystack'=>'array', 'strict='=>'bool'], 'inclued_get_data' => ['array'], 'inet_ntop' => ['string|false', 'in_addr'=>'string'], 'inet_pton' => ['string|false', 'ip_address'=>'string'], 'InfiniteIterator::__construct' => ['void', 'iterator'=>'Iterator'], 'InfiniteIterator::next' => ['void'], 'inflate_add' => ['string|false', 'context'=>'resource', 'encoded_data'=>'string', 'flush_mode='=>'int'], 'inflate_get_read_len' => ['int|false', 'resource'=>'resource'], 'inflate_get_status' => ['int|false', 'resource'=>'resource'], 'inflate_init' => ['resource|false', 'encoding'=>'int', 'options='=>'array'], 'ingres_autocommit' => ['bool', 'link'=>'resource'], 'ingres_autocommit_state' => ['bool', 'link'=>'resource'], 'ingres_charset' => ['string', 'link'=>'resource'], 'ingres_close' => ['bool', 'link'=>'resource'], 'ingres_commit' => ['bool', 'link'=>'resource'], 'ingres_connect' => ['resource', 'database='=>'string', 'username='=>'string', 'password='=>'string', 'options='=>'array'], 'ingres_cursor' => ['string', 'result'=>'resource'], 'ingres_errno' => ['int', 'link='=>'resource'], 'ingres_error' => ['string', 'link='=>'resource'], 'ingres_errsqlstate' => ['string', 'link='=>'resource'], 'ingres_escape_string' => ['string', 'link'=>'resource', 'source_string'=>'string'], 'ingres_execute' => ['bool', 'result'=>'resource', 'params='=>'array', 'types='=>'string'], 'ingres_fetch_array' => ['array', 'result'=>'resource', 'result_type='=>'int'], 'ingres_fetch_assoc' => ['array', 'result'=>'resource'], 'ingres_fetch_object' => ['object', 'result'=>'resource', 'result_type='=>'int'], 'ingres_fetch_proc_return' => ['int', 'result'=>'resource'], 'ingres_fetch_row' => ['array', 'result'=>'resource'], 'ingres_field_length' => ['int', 'result'=>'resource', 'index'=>'int'], 'ingres_field_name' => ['string', 'result'=>'resource', 'index'=>'int'], 'ingres_field_nullable' => ['bool', 'result'=>'resource', 'index'=>'int'], 'ingres_field_precision' => ['int', 'result'=>'resource', 'index'=>'int'], 'ingres_field_scale' => ['int', 'result'=>'resource', 'index'=>'int'], 'ingres_field_type' => ['string', 'result'=>'resource', 'index'=>'int'], 'ingres_free_result' => ['bool', 'result'=>'resource'], 'ingres_next_error' => ['bool', 'link='=>'resource'], 'ingres_num_fields' => ['int', 'result'=>'resource'], 'ingres_num_rows' => ['int', 'result'=>'resource'], 'ingres_pconnect' => ['resource', 'database='=>'string', 'username='=>'string', 'password='=>'string', 'options='=>'array'], 'ingres_prepare' => ['mixed', 'link'=>'resource', 'query'=>'string'], 'ingres_query' => ['mixed', 'link'=>'resource', 'query'=>'string', 'params='=>'array', 'types='=>'string'], 'ingres_result_seek' => ['bool', 'result'=>'resource', 'position'=>'int'], 'ingres_rollback' => ['bool', 'link'=>'resource'], 'ingres_set_environment' => ['bool', 'link'=>'resource', 'options'=>'array'], 'ingres_unbuffered_query' => ['mixed', 'link'=>'resource', 'query'=>'string', 'params='=>'array', 'types='=>'string'], 'ini_alter' => ['string|false', 'varname'=>'string', 'newvalue'=>'string'], 'ini_get' => ['string|false', 'varname'=>'string'], 'ini_get_all' => ['array|false', 'extension='=>'?string', 'details='=>'bool'], 'ini_restore' => ['void', 'varname'=>'string'], 'ini_set' => ['string|false', 'varname'=>'string', 'newvalue'=>'string'], 'inotify_add_watch' => ['int<1,max>|false', 'inotify_instance'=>'resource', 'pathname'=>'string', 'mask'=>'int'], 'inotify_init' => ['resource'], 'inotify_queue_len' => ['int<0,max>', 'inotify_instance'=>'resource'], 'inotify_read' => ['list<array{wd:int<1,max>,mask:int<0,max>,cookie:int<0,max>,name:string}>|false', 'inotify_instance'=>'resource'], 'inotify_rm_watch' => ['bool', 'inotify_instance'=>'resource', 'watch_descriptor'=>'int'], 'intdiv' => ['int', 'numerator'=>'int', 'divisor'=>'int'], 'interface_exists' => ['bool', 'classname'=>'string', 'autoload='=>'bool'], 'intl_error_name' => ['string', 'error_code'=>'int'], 'intl_get_error_code' => ['int'], 'intl_get_error_message' => ['string'], 'intl_is_failure' => ['bool', 'error_code'=>'int'], 'IntlBreakIterator::__construct' => ['void'], 'IntlBreakIterator::createCharacterInstance' => ['IntlRuleBasedBreakIterator', 'locale='=>'string'], 'IntlBreakIterator::createCodePointInstance' => ['IntlCodePointBreakIterator'], 'IntlBreakIterator::createLineInstance' => ['IntlRuleBasedBreakIterator', 'locale='=>'string'], 'IntlBreakIterator::createSentenceInstance' => ['IntlRuleBasedBreakIterator', 'locale='=>'string'], 'IntlBreakIterator::createTitleInstance' => ['IntlRuleBasedBreakIterator', 'locale='=>'string'], 'IntlBreakIterator::createWordInstance' => ['IntlRuleBasedBreakIterator', 'locale='=>'string'], 'IntlBreakIterator::current' => ['int'], 'IntlBreakIterator::first' => ['int'], 'IntlBreakIterator::following' => ['int', 'offset'=>'int'], 'IntlBreakIterator::getErrorCode' => ['int'], 'IntlBreakIterator::getErrorMessage' => ['string'], 'IntlBreakIterator::getLocale' => ['string', 'locale_type'=>'string'], 'IntlBreakIterator::getPartsIterator' => ['IntlPartsIterator', 'key_type='=>'IntlPartsIterator::KEY_*'], 'IntlBreakIterator::getText' => ['string'], 'IntlBreakIterator::isBoundary' => ['bool', 'offset'=>'int'], 'IntlBreakIterator::last' => ['int'], 'IntlBreakIterator::next' => ['int', 'offset='=>'int'], 'IntlBreakIterator::preceding' => ['int', 'offset'=>'int'], 'IntlBreakIterator::previous' => ['int'], 'IntlBreakIterator::setText' => ['bool', 'text'=>'string'], 'intlcal_add' => ['bool', 'cal'=>'IntlCalendar', 'field'=>'int', 'amount'=>'int'], 'intlcal_after' => ['bool', 'cal'=>'IntlCalendar', 'other'=>'IntlCalendar'], 'intlcal_before' => ['bool', 'cal'=>'IntlCalendar', 'other'=>'IntlCalendar'], 'intlcal_clear' => ['bool', 'cal'=>'IntlCalendar', 'field='=>'int'], 'intlcal_create_instance' => ['IntlCalendar', 'timeZone='=>'mixed', 'locale='=>'string'], 'intlcal_equals' => ['bool', 'cal'=>'IntlCalendar', 'other'=>'IntlCalendar'], 'intlcal_field_difference' => ['int', 'cal'=>'IntlCalendar', 'when'=>'float', 'field'=>'int'], 'intlcal_from_date_time' => ['IntlCalendar', 'dateTime'=>'DateTime|string'], 'intlcal_get' => ['int', 'cal'=>'IntlCalendar', 'field'=>'int'], 'intlcal_get_actual_maximum' => ['int', 'cal'=>'IntlCalendar', 'field'=>'int'], 'intlcal_get_actual_minimum' => ['int', 'cal'=>'IntlCalendar', 'field'=>'int'], 'intlcal_get_available_locales' => ['array'], 'intlcal_get_day_of_week_type' => ['int', 'cal'=>'IntlCalendar', 'dayOfWeek'=>'int'], 'intlcal_get_first_day_of_week' => ['int', 'cal'=>'IntlCalendar'], 'intlcal_get_greatest_minimum' => ['int', 'cal'=>'IntlCalendar', 'field'=>'int'], 'intlcal_get_keyword_values_for_locale' => ['Iterator|false', 'key'=>'string', 'locale'=>'string', 'commonlyUsed'=>'bool'], 'intlcal_get_least_maximum' => ['int', 'cal'=>'IntlCalendar', 'field'=>'int'], 'intlcal_get_locale' => ['string', 'cal'=>'IntlCalendar', 'localeType'=>'int'], 'intlcal_get_maximum' => ['int', 'cal'=>'IntlCalendar', 'field'=>'int'], 'intlcal_get_minimal_days_in_first_week' => ['int', 'cal'=>'IntlCalendar'], 'intlcal_get_minimum' => ['int', 'cal'=>'IntlCalendar', 'field'=>'int'], 'intlcal_get_now' => ['float'], 'intlcal_get_repeated_wall_time_option' => ['int', 'cal'=>'IntlCalendar'], 'intlcal_get_skipped_wall_time_option' => ['int', 'cal'=>'IntlCalendar'], 'intlcal_get_time' => ['float', 'cal'=>'IntlCalendar'], 'intlcal_get_time_zone' => ['IntlTimeZone|false', 'cal'=>'IntlCalendar'], 'intlcal_get_type' => ['string', 'cal'=>'IntlCalendar'], 'intlcal_get_weekend_transition' => ['int', 'cal'=>'IntlCalendar', 'dayOfWeek'=>'string'], 'intlcal_in_daylight_time' => ['bool', 'cal'=>'IntlCalendar'], 'intlcal_is_equivalent_to' => ['bool', 'cal'=>'IntlCalendar', 'other'=>'IntlCalendar'], 'intlcal_is_lenient' => ['bool', 'cal'=>'IntlCalendar'], 'intlcal_is_set' => ['bool', 'cal'=>'IntlCalendar', 'field'=>'int'], 'intlcal_is_weekend' => ['bool', 'cal'=>'IntlCalendar', 'date='=>'float'], 'intlcal_roll' => ['bool', 'cal'=>'IntlCalendar', 'field'=>'int', 'amountOrUpOrDown'=>'mixed'], 'intlcal_set' => ['bool', 'cal'=>'IntlCalendar', 'field'=>'int', 'value'=>'int'], 'intlcal_set\'1' => ['bool', 'cal'=>'IntlCalendar', 'year'=>'int', 'month'=>'int', 'dayOfMonth='=>'int', 'hour='=>'int', 'minute='=>'int', 'second='=>'int'], 'intlcal_set_first_day_of_week' => ['bool', 'cal'=>'IntlCalendar', 'dayOfWeek'=>'int'], 'intlcal_set_lenient' => ['bool', 'cal'=>'IntlCalendar', 'isLenient'=>'bool'], 'intlcal_set_repeated_wall_time_option' => ['bool', 'cal'=>'IntlCalendar', 'wallTimeOption'=>'int'], 'intlcal_set_skipped_wall_time_option' => ['bool', 'cal'=>'IntlCalendar', 'wallTimeOption'=>'int'], 'intlcal_set_time' => ['bool', 'cal'=>'IntlCalendar', 'date'=>'float'], 'intlcal_set_time_zone' => ['bool', 'cal'=>'IntlCalendar', 'timeZone'=>'mixed'], 'intlcal_to_date_time' => ['DateTime|false', 'cal'=>'IntlCalendar'], 'IntlCalendar::__construct' => ['void'], 'IntlCalendar::add' => ['bool', 'field'=>'int', 'amount'=>'int'], 'IntlCalendar::after' => ['bool', 'other'=>'IntlCalendar'], 'IntlCalendar::before' => ['bool', 'other'=>'IntlCalendar'], 'IntlCalendar::clear' => ['bool', 'field='=>'int'], 'IntlCalendar::createInstance' => ['IntlCalendar', 'timeZone='=>'mixed', 'locale='=>'string'], 'IntlCalendar::equals' => ['bool', 'other'=>'IntlCalendar'], 'IntlCalendar::fieldDifference' => ['int', 'when'=>'float', 'field'=>'int'], 'IntlCalendar::fromDateTime' => ['IntlCalendar', 'dateTime'=>'DateTime|string'], 'IntlCalendar::get' => ['int', 'field'=>'int'], 'IntlCalendar::getActualMaximum' => ['int', 'field'=>'int'], 'IntlCalendar::getActualMinimum' => ['int', 'field'=>'int'], 'IntlCalendar::getAvailableLocales' => ['array'], 'IntlCalendar::getDayOfWeekType' => ['int', 'dayOfWeek'=>'int'], 'IntlCalendar::getErrorCode' => ['int'], 'IntlCalendar::getErrorMessage' => ['string'], 'IntlCalendar::getFirstDayOfWeek' => ['int'], 'IntlCalendar::getGreatestMinimum' => ['int', 'field'=>'int'], 'IntlCalendar::getKeywordValuesForLocale' => ['Iterator', 'key'=>'string', 'locale'=>'string', 'commonlyUsed'=>'bool'], 'IntlCalendar::getLeastMaximum' => ['int', 'field'=>'int'], 'IntlCalendar::getLocale' => ['string', 'localeType'=>'int'], 'IntlCalendar::getMaximum' => ['int', 'field'=>'int'], 'IntlCalendar::getMinimalDaysInFirstWeek' => ['int'], 'IntlCalendar::getMinimum' => ['int', 'field'=>'int'], 'IntlCalendar::getNow' => ['float'], 'IntlCalendar::getRepeatedWallTimeOption' => ['int'], 'IntlCalendar::getSkippedWallTimeOption' => ['int'], 'IntlCalendar::getTime' => ['float'], 'IntlCalendar::getTimeZone' => ['IntlTimeZone'], 'IntlCalendar::getType' => ['string'], 'IntlCalendar::getWeekendTransition' => ['int', 'dayOfWeek'=>'string'], 'IntlCalendar::inDaylightTime' => ['bool'], 'IntlCalendar::isEquivalentTo' => ['bool', 'other'=>'IntlCalendar'], 'IntlCalendar::isLenient' => ['bool'], 'IntlCalendar::isSet' => ['bool', 'field'=>'int'], 'IntlCalendar::isWeekend' => ['bool', 'date='=>'float'], 'IntlCalendar::roll' => ['bool', 'field'=>'int', 'amountOrUpOrDown'=>'mixed'], 'IntlCalendar::set' => ['bool', 'field'=>'int', 'value'=>'int'], 'IntlCalendar::set\'1' => ['bool', 'year'=>'int', 'month'=>'int', 'dayOfMonth='=>'int', 'hour='=>'int', 'minute='=>'int', 'second='=>'int'], 'IntlCalendar::setFirstDayOfWeek' => ['bool', 'dayOfWeek'=>'int'], 'IntlCalendar::setLenient' => ['bool', 'isLenient'=>'string'], 'IntlCalendar::setMinimalDaysInFirstWeek' => ['bool', 'minimalDays'=>'int'], 'IntlCalendar::setRepeatedWallTimeOption' => ['bool', 'wallTimeOption'=>'int'], 'IntlCalendar::setSkippedWallTimeOption' => ['bool', 'wallTimeOption'=>'int'], 'IntlCalendar::setTime' => ['bool', 'date'=>'float'], 'IntlCalendar::setTimeZone' => ['bool', 'timeZone'=>'mixed'], 'IntlCalendar::toDateTime' => ['DateTime'], 'IntlChar::charAge' => ['array', 'char'=>'int|string'], 'IntlChar::charDigitValue' => ['int', 'codepoint'=>'mixed'], 'IntlChar::charDirection' => ['int', 'codepoint'=>'mixed'], 'IntlChar::charFromName' => ['int', 'name'=>'string', 'namechoice='=>'int'], 'IntlChar::charMirror' => ['mixed', 'codepoint'=>'mixed'], 'IntlChar::charName' => ['string', 'char'=>'int|string', 'namechoice='=>'int'], 'IntlChar::charType' => ['int', 'codepoint'=>'mixed'], 'IntlChar::chr' => ['string', 'codepoint'=>'mixed'], 'IntlChar::digit' => ['int', 'char'=>'int|string', 'radix='=>'int'], 'IntlChar::enumCharNames' => ['void', 'start'=>'mixed', 'limit'=>'mixed', 'callback'=>'callable', 'nameChoice='=>'int'], 'IntlChar::enumCharTypes' => ['void', 'cb='=>'callable'], 'IntlChar::foldCase' => ['int|string', 'char'=>'int|string', 'options='=>'int'], 'IntlChar::forDigit' => ['int', 'digit'=>'int', 'radix'=>'int'], 'IntlChar::getBidiPairedBracket' => ['mixed', 'codepoint'=>'mixed'], 'IntlChar::getBlockCode' => ['int', 'char'=>'int|string'], 'IntlChar::getCombiningClass' => ['int', 'codepoint'=>'mixed'], 'IntlChar::getFC_NFKC_Closure' => ['string', 'char'=>'int|string'], 'IntlChar::getIntPropertyMaxValue' => ['int', 'property'=>'int'], 'IntlChar::getIntPropertyMinValue' => ['int', 'property'=>'int'], 'IntlChar::getIntPropertyMxValue' => ['int', 'property'=>'int'], 'IntlChar::getIntPropertyValue' => ['int', 'char'=>'int|string', 'property'=>'int'], 'IntlChar::getNumericValue' => ['float', 'char'=>'int|string'], 'IntlChar::getPropertyEnum' => ['int', 'alias'=>'string'], 'IntlChar::getPropertyName' => ['string', 'property'=>'int', 'namechoice='=>'int'], 'IntlChar::getPropertyValueEnum' => ['int', 'property'=>'int', 'name'=>'string'], 'IntlChar::getPropertyValueName' => ['string', 'prop'=>'int', 'val'=>'int', 'namechoice='=>'int'], 'IntlChar::getUnicodeVersion' => ['array'], 'IntlChar::hasBinaryProperty' => ['bool', 'char'=>'int|string', 'property'=>'int'], 'IntlChar::isalnum' => ['bool', 'codepoint'=>'mixed'], 'IntlChar::isalpha' => ['bool', 'codepoint'=>'mixed'], 'IntlChar::isbase' => ['bool', 'codepoint'=>'mixed'], 'IntlChar::isblank' => ['bool', 'codepoint'=>'mixed'], 'IntlChar::iscntrl' => ['bool', 'codepoint'=>'mixed'], 'IntlChar::isdefined' => ['bool', 'codepoint'=>'mixed'], 'IntlChar::isdigit' => ['bool', 'codepoint'=>'mixed'], 'IntlChar::isgraph' => ['bool', 'codepoint'=>'mixed'], 'IntlChar::isIDIgnorable' => ['bool', 'codepoint'=>'mixed'], 'IntlChar::isIDPart' => ['bool', 'codepoint'=>'mixed'], 'IntlChar::isIDStart' => ['bool', 'codepoint'=>'mixed'], 'IntlChar::isISOControl' => ['bool', 'codepoint'=>'mixed'], 'IntlChar::isJavaIDPart' => ['bool', 'codepoint'=>'mixed'], 'IntlChar::isJavaIDStart' => ['bool', 'codepoint'=>'mixed'], 'IntlChar::isJavaSpaceChar' => ['bool', 'codepoint'=>'mixed'], 'IntlChar::islower' => ['bool', 'codepoint'=>'mixed'], 'IntlChar::isMirrored' => ['bool', 'codepoint'=>'mixed'], 'IntlChar::isprint' => ['bool', 'codepoint'=>'mixed'], 'IntlChar::ispunct' => ['bool', 'codepoint'=>'mixed'], 'IntlChar::isspace' => ['bool', 'codepoint'=>'mixed'], 'IntlChar::istitle' => ['bool', 'codepoint'=>'mixed'], 'IntlChar::isUAlphabetic' => ['bool', 'codepoint'=>'mixed'], 'IntlChar::isULowercase' => ['bool', 'codepoint'=>'mixed'], 'IntlChar::isupper' => ['bool', 'codepoint'=>'mixed'], 'IntlChar::isUUppercase' => ['bool', 'codepoint'=>'mixed'], 'IntlChar::isUWhiteSpace' => ['bool', 'codepoint'=>'mixed'], 'IntlChar::isWhitespace' => ['bool', 'codepoint'=>'mixed'], 'IntlChar::isxdigit' => ['bool', 'codepoint'=>'mixed'], 'IntlChar::ord' => ['int', 'character'=>'mixed'], 'IntlChar::tolower' => ['mixed', 'codepoint'=>'mixed'], 'IntlChar::totitle' => ['mixed', 'codepoint'=>'mixed'], 'IntlChar::toupper' => ['mixed', 'codepoint'=>'mixed'], 'IntlCodePointBreakIterator::getLastCodePoint' => ['int'], 'IntlDateFormatter::__construct' => ['void', 'locale'=>'?string', 'datetype'=>'?int', 'timetype'=>'?int', 'timezone='=>'null|string|IntlTimeZone|DateTimeZone', 'calendar='=>'null|int|IntlCalendar', 'pattern='=>'string'], 'IntlDateFormatter::create' => ['IntlDateFormatter|null', 'locale'=>'?string', 'datetype'=>'?int', 'timetype'=>'?int', 'timezone='=>'null|string|IntlTimeZone|DateTimeZone', 'calendar='=>'int|IntlCalendar', 'pattern='=>'string'], 'IntlDateFormatter::format' => ['string|false', 'args'=>''], 'IntlDateFormatter::formatObject' => ['string|false', 'object'=>'object', 'format='=>'mixed', 'locale='=>'string'], 'IntlDateFormatter::getCalendar' => ['int|false'], 'IntlDateFormatter::getCalendarObject' => ['IntlCalendar|false|null'], 'IntlDateFormatter::getDateType' => ['int|false'], 'IntlDateFormatter::getErrorCode' => ['int'], 'IntlDateFormatter::getErrorMessage' => ['string'], 'IntlDateFormatter::getLocale' => ['string|false'], 'IntlDateFormatter::getPattern' => ['string|false'], 'IntlDateFormatter::getTimeType' => ['int|false'], 'IntlDateFormatter::getTimeZone' => ['IntlTimeZone|false'], 'IntlDateFormatter::getTimeZoneId' => ['string|false'], 'IntlDateFormatter::isLenient' => ['bool'], 'IntlDateFormatter::localtime' => ['array|false', 'text_to_parse'=>'string', '&w_parse_pos='=>'int'], 'IntlDateFormatter::parse' => ['int|float|false', 'text_to_parse'=>'string', '&w_parse_pos='=>'int'], 'IntlDateFormatter::setCalendar' => ['bool', 'calendar'=>''], 'IntlDateFormatter::setLenient' => ['void', 'lenient'=>'bool'], 'IntlDateFormatter::setPattern' => ['bool', 'pattern'=>'string'], 'IntlDateFormatter::setTimeZone' => ['bool', 'timezone'=>''], 'IntlDateFormatter::setTimeZoneId' => ['bool', 'zone'=>'string', 'fmt='=>'IntlDateFormatter'], 'IntlGregorianCalendar::getGregorianChange' => ['float'], 'IntlGregorianCalendar::isLeapYear' => ['bool', 'year'=>'int'], 'IntlGregorianCalendar::setGregorianChange' => ['bool', 'date'=>'float'], 'IntlIterator::current' => ['mixed'], 'IntlIterator::key' => ['string'], 'IntlIterator::next' => ['void'], 'IntlIterator::rewind' => ['void'], 'IntlIterator::valid' => ['bool'], 'IntlPartsIterator::current' => ['non-empty-string'], 'IntlPartsIterator::getBreakIterator' => ['IntlBreakIterator'], 'IntlRuleBasedBreakIterator::__construct' => ['void', 'rules'=>'string', 'areCompiled='=>'string'], 'IntlRuleBasedBreakIterator::createCharacterInstance' => ['IntlRuleBasedBreakIterator', 'locale'=>'string'], 'IntlRuleBasedBreakIterator::createCodePointInstance' => ['IntlCodePointBreakIterator'], 'IntlRuleBasedBreakIterator::createLineInstance' => ['IntlRuleBasedBreakIterator', 'locale'=>'string'], 'IntlRuleBasedBreakIterator::createSentenceInstance' => ['IntlRuleBasedBreakIterator', 'locale'=>'string'], 'IntlRuleBasedBreakIterator::createTitleInstance' => ['IntlRuleBasedBreakIterator', 'locale'=>'string'], 'IntlRuleBasedBreakIterator::createWordInstance' => ['IntlRuleBasedBreakIterator', 'locale'=>'string'], 'IntlRuleBasedBreakIterator::current' => ['int'], 'IntlRuleBasedBreakIterator::first' => ['int'], 'IntlRuleBasedBreakIterator::following' => ['int', 'offset'=>'int'], 'IntlRuleBasedBreakIterator::getBinaryRules' => ['string'], 'IntlRuleBasedBreakIterator::getErrorCode' => ['int'], 'IntlRuleBasedBreakIterator::getErrorMessage' => ['string'], 'IntlRuleBasedBreakIterator::getLocale' => ['string', 'locale_type'=>'string'], 'IntlRuleBasedBreakIterator::getPartsIterator' => ['IntlPartsIterator', 'key_type='=>'int'], 'IntlRuleBasedBreakIterator::getRules' => ['string'], 'IntlRuleBasedBreakIterator::getRuleStatus' => ['int'], 'IntlRuleBasedBreakIterator::getRuleStatusVec' => ['array'], 'IntlRuleBasedBreakIterator::getText' => ['string'], 'IntlRuleBasedBreakIterator::isBoundary' => ['bool', 'offset'=>'int'], 'IntlRuleBasedBreakIterator::last' => ['int'], 'IntlRuleBasedBreakIterator::next' => ['int', 'offset='=>'int'], 'IntlRuleBasedBreakIterator::preceding' => ['int', 'offset'=>'int'], 'IntlRuleBasedBreakIterator::previous' => ['int'], 'IntlRuleBasedBreakIterator::setText' => ['bool', 'text'=>'string'], 'IntlTimeZone::countEquivalentIDs' => ['int', 'zoneId'=>'string'], 'IntlTimeZone::createDefault' => ['IntlTimeZone'], 'IntlTimeZone::createEnumeration' => ['IntlIterator', 'countryOrRawOffset='=>'mixed'], 'IntlTimeZone::createTimeZone' => ['IntlTimeZone', 'zoneId'=>'string'], 'IntlTimeZone::createTimeZoneIDEnumeration' => ['IntlIterator', 'zoneType'=>'int', 'region='=>'string', 'rawOffset='=>'int'], 'IntlTimeZone::fromDateTimeZone' => ['IntlTimeZone', 'zoneId'=>'DateTimeZone'], 'IntlTimeZone::getCanonicalID' => ['string', 'zoneId'=>'string', '&w_isSystemID='=>'bool'], 'IntlTimeZone::getDisplayName' => ['string', 'isDaylight='=>'bool', 'style='=>'int', 'locale='=>'string'], 'IntlTimeZone::getDSTSavings' => ['int'], 'IntlTimeZone::getEquivalentID' => ['string', 'zoneId'=>'string', 'index'=>'int'], 'IntlTimeZone::getErrorCode' => ['int'], 'IntlTimeZone::getErrorMessage' => ['string'], 'IntlTimeZone::getGMT' => ['IntlTimeZone'], 'IntlTimeZone::getID' => ['string'], 'IntlTimeZone::getIDForWindowsID' => ['string', 'timezone'=>'string', 'region='=>'string'], 'IntlTimeZone::getOffset' => ['int', 'date'=>'float', 'local'=>'bool', '&w_rawOffset'=>'int', '&w_dstOffset'=>'int'], 'IntlTimeZone::getRawOffset' => ['int'], 'IntlTimeZone::getRegion' => ['string', 'zoneId'=>'string'], 'IntlTimeZone::getTZDataVersion' => ['string'], 'IntlTimeZone::getUnknown' => ['IntlTimeZone'], 'IntlTimeZone::getWindowsID' => ['string', 'timezone'=>'string'], 'IntlTimeZone::hasSameRules' => ['bool', 'otherTimeZone'=>'IntlTimeZone'], 'IntlTimeZone::toDateTimeZone' => ['DateTimeZone'], 'IntlTimeZone::useDaylightTime' => ['bool'], 'intltz_count_equivalent_ids' => ['int|false', 'zoneId'=>'string'], 'intltz_create_enumeration' => ['IntlIterator', 'countryOrRawOffset'=>'mixed'], 'intltz_create_time_zone' => ['IntlTimeZone', 'zoneId'=>'string'], 'intltz_from_date_time_zone' => ['IntlTimeZone', 'zoneId'=>'DateTimeZone'], 'intltz_get_canonical_id' => ['string|false', 'zoneId'=>'string', '&isSystemID'=>'bool'], 'intltz_get_display_name' => ['string|false', 'obj'=>'IntlTimeZone', 'isDaylight'=>'bool', 'style'=>'int', 'locale'=>'string'], 'intltz_get_dst_savings' => ['int', 'obj'=>'IntlTimeZone'], 'intltz_get_equivalent_id' => ['string|false', 'zoneId'=>'string', 'index'=>'int'], 'intltz_get_error_code' => ['int|false', 'obj'=>'IntlTimeZone'], 'intltz_get_error_message' => ['string|false', 'obj'=>'IntlTimeZone'], 'intltz_get_id' => ['string|false', 'obj'=>'IntlTimeZone'], 'intltz_get_offset' => ['int', 'obj'=>'IntlTimeZone', 'date'=>'float', 'local'=>'bool', '&rawOffset'=>'int', '&dstOffset'=>'int'], 'intltz_get_raw_offset' => ['int', 'obj'=>'IntlTimeZone'], 'intltz_get_tz_data_version' => ['string|false', 'obj'=>'IntlTimeZone'], 'intltz_getGMT' => ['IntlTimeZone'], 'intltz_has_same_rules' => ['bool', 'obj'=>'IntlTimeZone', 'otherTimeZone'=>'IntlTimeZone'], 'intltz_to_date_time_zone' => ['DateTimeZone|false', 'obj'=>''], 'intltz_use_daylight_time' => ['bool', 'obj'=>''], 'intlz_create_default' => ['IntlTimeZone'], 'intval' => ['int', 'var'=>'scalar|array|resource|null', 'base='=>'int'], 'InvalidArgumentException::__clone' => ['void'], 'InvalidArgumentException::__construct' => ['void', 'message='=>'string', 'code='=>'int', 'previous='=>'(?Throwable)|(?InvalidArgumentException)'], 'InvalidArgumentException::__toString' => ['string'], 'InvalidArgumentException::getCode' => ['int'], 'InvalidArgumentException::getFile' => ['string'], 'InvalidArgumentException::getLine' => ['int'], 'InvalidArgumentException::getMessage' => ['string'], 'InvalidArgumentException::getPrevious' => ['Throwable|InvalidArgumentException|null'], 'InvalidArgumentException::getTrace' => ['list<array{function:string,line?:int,file?:string,class?:class-string,type?:\'::\'|\'->\',args?:mixed[],object?:object}>'], 'InvalidArgumentException::getTraceAsString' => ['string'], 'ip2long' => ['int|false', 'ip_address'=>'string'], 'iptcembed' => ['string|bool', 'iptcdata'=>'string', 'jpeg_file_name'=>'string', 'spool='=>'int'], 'iptcparse' => ['array<string,list<string>>|false', 'iptcdata'=>'string'], 'is_a' => ['bool', 'object_or_string'=>'object|string', 'class_name'=>'string', 'allow_string='=>'bool'], 'is_array' => ['bool', 'var'=>'mixed'], 'is_bool' => ['bool', 'var'=>'mixed'], 'is_callable' => ['bool', 'var'=>'mixed', 'syntax_only='=>'bool', '&w_callable_name='=>'string'], 'is_countable' => ['bool', 'var'=>'mixed'], 'is_dir' => ['bool', 'filename'=>'string'], 'is_double' => ['bool', 'var'=>''], 'is_executable' => ['bool', 'filename'=>'string'], 'is_file' => ['bool', 'filename'=>'string'], 'is_finite' => ['bool', 'val'=>'float'], 'is_float' => ['bool', 'var'=>'mixed'], 'is_infinite' => ['bool', 'val'=>'float'], 'is_int' => ['bool', 'var'=>'mixed'], 'is_integer' => ['bool', 'var'=>''], 'is_iterable' => ['bool', 'var'=>'mixed'], 'is_link' => ['bool', 'filename'=>'string'], 'is_long' => ['bool', 'var'=>''], 'is_nan' => ['bool', 'val'=>'float'], 'is_null' => ['bool', 'var'=>'mixed'], 'is_numeric' => ['bool', 'value'=>'mixed'], 'is_object' => ['bool', 'var'=>'mixed'], 'is_readable' => ['bool', 'filename'=>'string'], 'is_real' => ['bool', 'var'=>''], 'is_resource' => ['bool', 'var'=>'mixed'], 'is_scalar' => ['bool', 'value'=>'mixed'], 'is_soap_fault' => ['bool', 'object'=>'mixed'], 'is_string' => ['bool', 'var'=>'mixed'], 'is_subclass_of' => ['bool', 'object_or_string'=>'object|string', 'class_name'=>'string', 'allow_string='=>'bool'], 'is_tainted' => ['bool', 'string'=>'string'], 'is_uploaded_file' => ['bool', 'path'=>'string'], 'is_writable' => ['bool', 'filename'=>'string'], 'is_writeable' => ['bool', 'filename'=>'string'], 'Iterator::current' => ['mixed'], 'Iterator::key' => ['mixed'], 'Iterator::next' => ['void'], 'Iterator::rewind' => ['void'], 'Iterator::valid' => ['bool'], 'iterator_apply' => ['0|positive-int', 'iterator'=>'Traversable', 'function'=>'callable', 'params='=>'array'], 'iterator_count' => ['0|positive-int', 'iterator'=>'Traversable'], 'iterator_to_array' => ['array', 'iterator'=>'Traversable', 'use_keys='=>'bool'], 'IteratorAggregate::getIterator' => ['Traversable'], 'IteratorIterator::__construct' => ['void', 'iterator'=>'Traversable'], 'IteratorIterator::current' => ['mixed'], 'IteratorIterator::getInnerIterator' => ['Traversable'], 'IteratorIterator::key' => ['mixed'], 'IteratorIterator::next' => ['void'], 'IteratorIterator::rewind' => ['void'], 'IteratorIterator::valid' => ['bool'], 'java_last_exception_clear' => [''], 'java_last_exception_get' => ['object'], 'java_reload' => ['array', 'new_jarpath'=>'new_jarpath'], 'java_require' => ['array', 'new_classpath'=>'new_classpath'], 'java_set_encoding' => ['array', 'encoding'=>'encoding'], 'java_set_ignore_case' => ['void', 'ignore'=>'ignore'], 'java_throw_exceptions' => ['void', 'throw'=>'throw'], 'JavaException::getCause' => ['object'], 'jddayofweek' => ['mixed', 'juliandaycount'=>'int', 'mode='=>'int'], 'jdmonthname' => ['string', 'juliandaycount'=>'int', 'mode'=>'int'], 'jdtofrench' => ['string', 'juliandaycount'=>'int'], 'jdtogregorian' => ['string', 'juliandaycount'=>'int'], 'jdtojewish' => ['string', 'juliandaycount'=>'int', 'hebrew='=>'bool', 'fl='=>'int'], 'jdtojulian' => ['string', 'juliandaycount'=>'int'], 'jdtounix' => ['int|false', 'jday'=>'int'], 'jewishtojd' => ['int', 'month'=>'int', 'day'=>'int', 'year'=>'int'], 'jobqueue_license_info' => ['array'], 'join' => ['string', 'glue'=>'string', 'pieces'=>'array'], 'join\'1' => ['string', 'pieces'=>'array'], 'jpeg2wbmp' => ['bool', 'jpegname'=>'string', 'wbmpname'=>'string', 'dest_height'=>'int', 'dest_width'=>'int', 'threshold'=>'int'], 'json_decode' => ['mixed', 'json'=>'string', 'assoc='=>'bool|null', 'depth='=>'positive-int', 'options='=>'int'], 'json_encode' => ['non-empty-string|false', 'data'=>'mixed', 'options='=>'int', 'depth='=>'positive-int'], 'json_last_error' => ['JSON_ERROR_NONE|JSON_ERROR_DEPTH|JSON_ERROR_STATE_MISMATCH|JSON_ERROR_CTRL_CHAR|JSON_ERROR_SYNTAX|JSON_ERROR_UTF8|JSON_ERROR_RECURSION|JSON_ERROR_INF_OR_NAN|JSON_ERROR_UNSUPPORTED_TYPE|JSON_ERROR_INVALID_PROPERTY_NAME|JSON_ERROR_UTF16'], 'json_last_error_msg' => ['string'], 'JsonIncrementalParser::__construct' => ['void', 'depth'=>'', 'options'=>''], 'JsonIncrementalParser::get' => ['', 'options'=>''], 'JsonIncrementalParser::getError' => [''], 'JsonIncrementalParser::parse' => ['', 'json'=>''], 'JsonIncrementalParser::parseFile' => ['', 'filename'=>''], 'JsonIncrementalParser::reset' => [''], 'JsonSerializable::jsonSerialize' => ['mixed'], 'Judy::__construct' => ['void', 'judy_type'=>'int'], 'Judy::__destruct' => [''], 'Judy::byCount' => ['int', 'nth_index'=>'int'], 'Judy::count' => ['0|positive-int', 'index_start='=>'int', 'index_end='=>'int'], 'Judy::first' => ['mixed', 'index='=>'mixed'], 'Judy::firstEmpty' => ['int', 'index='=>'mixed'], 'Judy::free' => ['int'], 'Judy::getType' => ['int'], 'Judy::last' => ['void', 'index='=>'string'], 'Judy::lastEmpty' => ['int', 'index='=>'int'], 'Judy::memoryUsage' => ['int'], 'Judy::next' => ['mixed', 'index'=>'mixed'], 'Judy::nextEmpty' => ['int', 'index'=>'int'], 'Judy::offsetExists' => ['bool', 'offset'=>'mixed'], 'Judy::offsetGet' => ['mixed', 'offset'=>'mixed'], 'Judy::offsetSet' => ['bool', 'offset'=>'mixed', 'value'=>'mixed'], 'Judy::offsetUnset' => ['bool', 'offset'=>'mixed'], 'Judy::prev' => ['mixed', 'index'=>'mixed'], 'Judy::prevEmpty' => ['int', 'index'=>'mixed'], 'Judy::size' => ['void'], 'judy_type' => ['int', 'array'=>'judy'], 'judy_version' => ['string'], 'juliantojd' => ['int', 'month'=>'int', 'day'=>'int', 'year'=>'int'], 'kadm5_chpass_principal' => ['bool', 'handle'=>'resource', 'principal'=>'string', 'password'=>'string'], 'kadm5_create_principal' => ['bool', 'handle'=>'resource', 'principal'=>'string', 'password='=>'string', 'options='=>'array'], 'kadm5_delete_principal' => ['bool', 'handle'=>'resource', 'principal'=>'string'], 'kadm5_destroy' => ['bool', 'handle'=>'resource'], 'kadm5_flush' => ['bool', 'handle'=>'resource'], 'kadm5_get_policies' => ['array', 'handle'=>'resource'], 'kadm5_get_principal' => ['array', 'handle'=>'resource', 'principal'=>'string'], 'kadm5_get_principals' => ['array', 'handle'=>'resource'], 'kadm5_init_with_password' => ['resource', 'admin_server'=>'string', 'realm'=>'string', 'principal'=>'string', 'password'=>'string'], 'kadm5_modify_principal' => ['bool', 'handle'=>'resource', 'principal'=>'string', 'options'=>'array'], 'key' => ['int|string|null', 'array_arg'=>'array|object'], 'key_exists' => ['bool', 'key'=>'string|int', 'search'=>'array'], 'krsort' => ['bool', '&rw_array_arg'=>'array', 'sort_flags='=>'int'], 'ksort' => ['bool', '&rw_array_arg'=>'array', 'sort_flags='=>'int'], 'KTaglib_ID3v2_AttachedPictureFrame::getDescription' => ['string'], 'KTaglib_ID3v2_AttachedPictureFrame::getMimeType' => ['string'], 'KTaglib_ID3v2_AttachedPictureFrame::getType' => ['int'], 'KTaglib_ID3v2_AttachedPictureFrame::savePicture' => ['bool', 'filename'=>'string'], 'KTaglib_ID3v2_AttachedPictureFrame::setMimeType' => ['string', 'type'=>'string'], 'KTaglib_ID3v2_AttachedPictureFrame::setPicture' => ['', 'filename'=>'string'], 'KTaglib_ID3v2_AttachedPictureFrame::setType' => ['', 'type'=>'int'], 'KTaglib_ID3v2_Frame::__toString' => ['string'], 'KTaglib_ID3v2_Frame::getSize' => ['int'], 'KTaglib_ID3v2_Tag::addFrame' => ['bool', 'frame'=>'ktaglib_id3v2_frame'], 'KTaglib_ID3v2_Tag::getFrameList' => ['array'], 'KTaglib_MPEG_AudioProperties::getBitrate' => ['int'], 'KTaglib_MPEG_AudioProperties::getChannels' => ['int'], 'KTaglib_MPEG_AudioProperties::getLayer' => ['int'], 'KTaglib_MPEG_AudioProperties::getLength' => ['int'], 'KTaglib_MPEG_AudioProperties::getSampleBitrate' => ['int'], 'KTaglib_MPEG_AudioProperties::getVersion' => ['int'], 'KTaglib_MPEG_AudioProperties::isCopyrighted' => ['bool'], 'KTaglib_MPEG_AudioProperties::isOriginal' => ['bool'], 'KTaglib_MPEG_AudioProperties::isProtectionEnabled' => ['bool'], 'KTaglib_MPEG_File::getAudioProperties' => ['KTaglib_MPEG_File'], 'KTaglib_MPEG_File::getID3v1Tag' => ['KTaglib_ID3v1_Tag', 'create='=>'bool'], 'KTaglib_MPEG_File::getID3v2Tag' => ['KTaglib_ID3v2_Tag', 'create='=>'bool'], 'KTaglib_Tag::getAlbum' => ['string'], 'KTaglib_Tag::getArtist' => ['string'], 'KTaglib_Tag::getComment' => ['string'], 'KTaglib_Tag::getGenre' => ['string'], 'KTaglib_Tag::getTitle' => ['string'], 'KTaglib_Tag::getTrack' => ['int'], 'KTaglib_Tag::getYear' => ['int'], 'KTaglib_Tag::isEmpty' => ['bool'], 'labelcacheObj::freeCache' => ['bool'], 'labelObj::__construct' => ['void'], 'labelObj::convertToString' => ['string'], 'labelObj::deleteStyle' => ['int', 'index'=>'int'], 'labelObj::free' => ['void'], 'labelObj::getBinding' => ['string', 'labelbinding'=>'mixed'], 'labelObj::getExpressionString' => ['string'], 'labelObj::getStyle' => ['styleObj', 'index'=>'int'], 'labelObj::getTextString' => ['string'], 'labelObj::moveStyleDown' => ['int', 'index'=>'int'], 'labelObj::moveStyleUp' => ['int', 'index'=>'int'], 'labelObj::removeBinding' => ['int', 'labelbinding'=>'mixed'], 'labelObj::set' => ['int', 'property_name'=>'string', 'new_value'=>''], 'labelObj::setBinding' => ['int', 'labelbinding'=>'mixed', 'value'=>'string'], 'labelObj::setExpression' => ['int', 'expression'=>'string'], 'labelObj::setText' => ['int', 'text'=>'string'], 'labelObj::updateFromString' => ['int', 'snippet'=>'string'], 'Lapack::eigenValues' => ['array', 'a'=>'array', 'left='=>'array', 'right='=>'array'], 'Lapack::identity' => ['array', 'n'=>'int'], 'Lapack::leastSquaresByFactorisation' => ['array', 'a'=>'array', 'b'=>'array'], 'Lapack::leastSquaresBySVD' => ['array', 'a'=>'array', 'b'=>'array'], 'Lapack::pseudoInverse' => ['array', 'a'=>'array'], 'Lapack::singularValues' => ['array', 'a'=>'array'], 'Lapack::solveLinearEquation' => ['array', 'a'=>'array', 'b'=>'array'], 'layerObj::addFeature' => ['int', 'shape'=>'shapeObj'], 'layerObj::applySLD' => ['int', 'sldxml'=>'string', 'namedlayer'=>'string'], 'layerObj::applySLDURL' => ['int', 'sldurl'=>'string', 'namedlayer'=>'string'], 'layerObj::clearProcessing' => ['void'], 'layerObj::close' => ['void'], 'layerObj::convertToString' => ['string'], 'layerObj::draw' => ['int', 'image'=>'imageObj'], 'layerObj::drawQuery' => ['int', 'image'=>'imageObj'], 'layerObj::free' => ['void'], 'layerObj::generateSLD' => ['string'], 'layerObj::getClass' => ['classObj', 'classIndex'=>'int'], 'layerObj::getClassIndex' => ['int', 'shape'=>'', 'classgroup'=>'', 'numclasses'=>''], 'layerObj::getExtent' => ['rectObj'], 'layerObj::getFilterString' => ['string'], 'layerObj::getGridIntersectionCoordinates' => ['array'], 'layerObj::getItems' => ['array'], 'layerObj::getMetaData' => ['int', 'name'=>'string'], 'layerObj::getNumResults' => ['int'], 'layerObj::getProcessing' => ['array'], 'layerObj::getProjection' => ['string'], 'layerObj::getResult' => ['resultObj', 'index'=>'int'], 'layerObj::getResultsBounds' => ['rectObj'], 'layerObj::getShape' => ['shapeObj', 'result'=>'resultObj'], 'layerObj::getWMSFeatureInfoURL' => ['string', 'clickX'=>'int', 'clickY'=>'int', 'featureCount'=>'int', 'infoFormat'=>'string'], 'layerObj::isVisible' => ['bool'], 'layerObj::moveclassdown' => ['int', 'index'=>'int'], 'layerObj::moveclassup' => ['int', 'index'=>'int'], 'layerObj::ms_newLayerObj' => ['layerObj', 'map'=>'mapObj', 'layer'=>'layerObj'], 'layerObj::nextShape' => ['shapeObj'], 'layerObj::open' => ['int'], 'layerObj::queryByAttributes' => ['int', 'qitem'=>'string', 'qstring'=>'string', 'mode'=>'int'], 'layerObj::queryByFeatures' => ['int', 'slayer'=>'int'], 'layerObj::queryByPoint' => ['int', 'point'=>'pointObj', 'mode'=>'int', 'buffer'=>'float'], 'layerObj::queryByRect' => ['int', 'rect'=>'rectObj'], 'layerObj::queryByShape' => ['int', 'shape'=>'shapeObj'], 'layerObj::removeClass' => ['classObj', 'index'=>'int'], 'layerObj::removeMetaData' => ['int', 'name'=>'string'], 'layerObj::set' => ['int', 'property_name'=>'string', 'new_value'=>''], 'layerObj::setConnectionType' => ['int', 'connectiontype'=>'int', 'plugin_library'=>'string'], 'layerObj::setFilter' => ['int', 'expression'=>'string'], 'layerObj::setMetaData' => ['int', 'name'=>'string', 'value'=>'string'], 'layerObj::setProjection' => ['int', 'proj_params'=>'string'], 'layerObj::setWKTProjection' => ['int', 'proj_params'=>'string'], 'layerObj::updateFromString' => ['int', 'snippet'=>'string'], 'lcfirst' => ['string', 'str'=>'string'], 'lcg_value' => ['float'], 'lchgrp' => ['bool', 'filename'=>'string', 'group'=>'string|int'], 'lchown' => ['bool', 'filename'=>'string', 'user'=>'string|int'], 'ldap_8859_to_t61' => ['string|false', 'value'=>'string'], 'ldap_add' => ['bool', 'link_identifier'=>'resource', 'dn'=>'string', 'entry'=>'array', 'servercontrols='=>'array'], 'ldap_add_ext' => ['resource|false', 'link_identifier'=>'resource', 'dn'=>'string', 'entry'=>'array', 'servercontrols='=>'array'], 'ldap_bind' => ['bool', 'link_identifier'=>'resource', 'bind_rdn='=>'string|null', 'bind_password='=>'string|null', 'serverctrls='=>'array'], 'ldap_bind_ext' => ['resource|false', 'link_identifier'=>'resource', 'bind_rdn='=>'string|null', 'bind_password='=>'string|null', 'serverctrls='=>'array'], 'ldap_close' => ['bool', 'link_identifier'=>'resource'], 'ldap_compare' => ['bool', 'link_identifier'=>'resource', 'dn'=>'string', 'attr'=>'string', 'value'=>'string', 'servercontrols='=>'array'], 'ldap_connect' => ['resource|false', 'host='=>'string', 'port='=>'int', 'wallet='=>'string', 'wallet_passwd='=>'string', 'authmode='=>'int'], 'ldap_control_paged_result' => ['bool', 'link_identifier'=>'resource', 'pagesize'=>'int', 'iscritical='=>'bool', 'cookie='=>'string'], 'ldap_control_paged_result_response' => ['bool', 'link_identifier'=>'resource', 'result_identifier'=>'resource', '&w_cookie='=>'string', '&w_estimated='=>'int'], 'ldap_count_entries' => ['int', 'link_identifier'=>'resource', 'result'=>'resource'], 'ldap_delete' => ['bool', 'link_identifier'=>'resource', 'dn'=>'string', 'servercontrols='=>'array'], 'ldap_delete_ext' => ['resource|false', 'link_identifier'=>'resource', 'dn'=>'string', 'servercontrols='=>'array'], 'ldap_dn2ufn' => ['string|false', 'dn'=>'string'], 'ldap_err2str' => ['string', 'errno'=>'int'], 'ldap_errno' => ['int', 'link_identifier'=>'resource'], 'ldap_error' => ['string', 'link_identifier'=>'resource'], 'ldap_escape' => ['string', 'value'=>'string', 'ignore='=>'string', 'flags='=>'int'], 'ldap_exop' => ['resource|bool', 'link'=>'resource', 'reqoid'=>'string', 'reqdata='=>'string', 'serverctrls='=>'array|null', '&w_retdata='=>'string', '&w_retoid='=>'string'], 'ldap_exop_passwd' => ['string|bool', 'link'=>'resource', 'user='=>'string', 'oldpw='=>'string', 'newpw='=>'string', 'serverctrls='=>'array'], 'ldap_exop_refresh' => ['int|false', 'link'=>'resource', 'dn'=>'string', 'ttl'=>'int'], 'ldap_exop_whoami' => ['string|bool', 'link'=>'resource'], 'ldap_explode_dn' => ['array|false', 'dn'=>'string', 'with_attrib'=>'int'], 'ldap_first_attribute' => ['string|false', 'link_identifier'=>'resource', 'result_entry_identifier'=>'resource'], 'ldap_first_entry' => ['resource|false', 'link_identifier'=>'resource', 'result_identifier'=>'resource'], 'ldap_first_reference' => ['resource|false', 'link_identifier'=>'resource', 'result_identifier'=>'resource'], 'ldap_free_result' => ['bool', 'result_identifier'=>'resource'], 'ldap_get_attributes' => ['array', 'link_identifier'=>'resource', 'result_entry_identifier'=>'resource'], 'ldap_get_dn' => ['string|false', 'link_identifier'=>'resource', 'result_entry_identifier'=>'resource'], 'ldap_get_entries' => ['array|false', 'link_identifier'=>'resource', 'result_identifier'=>'resource'], 'ldap_get_option' => ['bool', 'link_identifier'=>'resource', 'option'=>'int', '&w_retval'=>'mixed'], 'ldap_get_values' => ['array|false', 'link_identifier'=>'resource', 'result_entry_identifier'=>'resource', 'attribute'=>'string'], 'ldap_get_values_len' => ['array|false', 'link_identifier'=>'resource', 'result_entry_identifier'=>'resource', 'attribute'=>'string'], 'ldap_list' => ['resource|false', 'link'=>'resource|array', 'base_dn'=>'string', 'filter'=>'string', 'attrs='=>'array', 'attrsonly='=>'int', 'sizelimit='=>'int', 'timelimit='=>'int', 'deref='=>'int', 'servercontrols='=>'array'], 'ldap_mod_add' => ['bool', 'link_identifier'=>'resource', 'dn'=>'string', 'entry'=>'array', 'servercontrols='=>'array'], 'ldap_mod_add_ext' => ['resource|false', 'link_identifier'=>'resource', 'dn'=>'string', 'entry'=>'array', 'servercontrols='=>'array'], 'ldap_mod_del' => ['bool', 'link_identifier'=>'resource', 'dn'=>'string', 'entry'=>'array', 'servercontrols='=>'array'], 'ldap_mod_del_ext' => ['resource|false', 'link_identifier'=>'resource', 'dn'=>'string', 'entry'=>'array', 'servercontrols='=>'array'], 'ldap_mod_replace' => ['bool', 'link_identifier'=>'resource', 'dn'=>'string', 'entry'=>'array', 'servercontrols='=>'array'], 'ldap_mod_replace_ext' => ['resource|false', 'link_identifier'=>'resource', 'dn'=>'string', 'entry'=>'array', 'servercontrols='=>'array'], 'ldap_modify' => ['bool', 'link_identifier'=>'resource', 'dn'=>'string', 'entry'=>'array'], 'ldap_modify_batch' => ['bool', 'link_identifier'=>'resource', 'dn'=>'string', 'modifs'=>'array', 'servercontrols='=>'array'], 'ldap_next_attribute' => ['string|false', 'link_identifier'=>'resource', 'result_entry_identifier'=>'resource'], 'ldap_next_entry' => ['resource|false', 'link_identifier'=>'resource', 'result_entry_identifier'=>'resource'], 'ldap_next_reference' => ['resource|false', 'link_identifier'=>'resource', 'reference_entry_identifier'=>'resource'], 'ldap_parse_exop' => ['bool', 'link'=>'resource', 'result'=>'resource', '&w_retdata='=>'string', '&w_retoid='=>'string'], 'ldap_parse_reference' => ['bool', 'link_identifier'=>'resource', 'reference_entry_identifier'=>'resource', 'referrals'=>'array'], 'ldap_parse_result' => ['bool', 'link_identifier'=>'resource', 'result'=>'resource', '&w_errcode'=>'int', '&w_matcheddn='=>'string', '&w_errmsg='=>'string', '&w_referrals='=>'array', '&w_serverctrls='=>'array'], 'ldap_read' => ['resource|false', 'link'=>'resource|array', 'base_dn'=>'string', 'filter'=>'string', 'attrs='=>'array', 'attrsonly='=>'int', 'sizelimit='=>'int', 'timelimit='=>'int', 'deref='=>'int', 'servercontrols='=>'array'], 'ldap_rename' => ['bool', 'link_identifier'=>'resource', 'dn'=>'string', 'newrdn'=>'string', 'newparent'=>'string', 'deleteoldrdn'=>'bool', 'servercontrols='=>'array'], 'ldap_rename_ext' => ['resource|false', 'link_identifier'=>'resource', 'dn'=>'string', 'newrdn'=>'string', 'newparent'=>'string', 'deleteoldrdn'=>'bool', 'servercontrols='=>'array'], 'ldap_sasl_bind' => ['bool', 'link_identifier'=>'resource', 'binddn='=>'string', 'password='=>'string', 'sasl_mech='=>'string', 'sasl_realm='=>'string', 'sasl_authc_id='=>'string', 'sasl_authz_id='=>'string', 'props='=>'string'], 'ldap_search' => ['resource|false', 'link_identifier'=>'resource|array', 'base_dn'=>'string', 'filter'=>'string', 'attrs='=>'array', 'attrsonly='=>'int', 'sizelimit='=>'int', 'timelimit='=>'int', 'deref='=>'int', 'servercontrols='=>'array'], 'ldap_set_option' => ['bool', 'link_identifier'=>'resource|null', 'option'=>'int', 'newval'=>'mixed'], 'ldap_set_rebind_proc' => ['bool', 'link_identifier'=>'resource', 'callback'=>'callable'], 'ldap_sort' => ['bool', 'link_identifier'=>'resource', 'result_identifier'=>'resource', 'sortfilter'=>'string'], 'ldap_start_tls' => ['bool', 'link_identifier'=>'resource'], 'ldap_t61_to_8859' => ['string|false', 'value'=>'string'], 'ldap_unbind' => ['bool', 'link_identifier'=>'resource'], 'leak' => ['', 'num_bytes'=>'int'], 'leak_variable' => ['', 'variable'=>'', 'leak_data'=>'bool'], 'legendObj::convertToString' => ['string'], 'legendObj::free' => ['void'], 'legendObj::set' => ['int', 'property_name'=>'string', 'new_value'=>''], 'legendObj::updateFromString' => ['int', 'snippet'=>'string'], 'LengthException::__clone' => ['void'], 'LengthException::__construct' => ['void', 'message='=>'string', 'code='=>'int', 'previous='=>'(?Throwable)|(?LengthException)'], 'LengthException::__toString' => ['string'], 'LengthException::getCode' => ['int'], 'LengthException::getFile' => ['string'], 'LengthException::getLine' => ['int'], 'LengthException::getMessage' => ['string'], 'LengthException::getPrevious' => ['Throwable|LengthException|null'], 'LengthException::getTrace' => ['list<array{function:string,line?:int,file?:string,class?:class-string,type?:\'::\'|\'->\',args?:mixed[],object?:object}>'], 'LengthException::getTraceAsString' => ['string'], 'levenshtein' => ['int', 'str1'=>'string', 'str2'=>'string'], 'levenshtein\'1' => ['int', 'str1'=>'string', 'str2'=>'string', 'cost_ins'=>'int', 'cost_rep'=>'int', 'cost_del'=>'int'], 'libxml_clear_errors' => ['void'], 'libxml_disable_entity_loader' => ['bool', 'disable='=>'bool'], 'libxml_get_errors' => ['array<int,LibXMLError>'], 'libxml_get_last_error' => ['LibXMLError|false'], 'libxml_set_external_entity_loader' => ['bool', 'resolver_function'=>'callable'], 'libxml_set_streams_context' => ['void', 'streams_context'=>'resource'], 'libxml_use_internal_errors' => ['bool', 'use_errors='=>'bool'], 'LimitIterator::__construct' => ['void', 'iterator'=>'Iterator', 'offset='=>'int', 'count='=>'int'], 'LimitIterator::current' => ['mixed'], 'LimitIterator::getInnerIterator' => ['Iterator'], 'LimitIterator::getPosition' => ['int'], 'LimitIterator::key' => ['mixed'], 'LimitIterator::next' => ['void'], 'LimitIterator::rewind' => ['void'], 'LimitIterator::seek' => ['int', 'position'=>'int'], 'LimitIterator::valid' => ['bool'], 'lineObj::__construct' => ['void'], 'lineObj::add' => ['int', 'point'=>'pointObj'], 'lineObj::addXY' => ['int', 'x'=>'float', 'y'=>'float', 'm'=>'float'], 'lineObj::addXYZ' => ['int', 'x'=>'float', 'y'=>'float', 'z'=>'float', 'm'=>'float'], 'lineObj::ms_newLineObj' => ['lineObj'], 'lineObj::point' => ['pointObj', 'i'=>'int'], 'lineObj::project' => ['int', 'in'=>'projectionObj', 'out'=>'projectionObj'], 'link' => ['bool', 'target'=>'string', 'link'=>'string'], 'linkinfo' => ['int|false', 'filename'=>'string'], 'litespeed_request_headers' => ['array'], 'litespeed_response_headers' => ['array|false'], 'Locale::acceptFromHttp' => ['non-empty-string|false', 'header'=>'string'], 'Locale::canonicalize' => ['non-empty-string|null', 'locale'=>'string'], 'Locale::composeLocale' => ['string|false', 'subtags'=>'array'], 'Locale::filterMatches' => ['bool|null', 'langtag'=>'string', 'locale'=>'string', 'canonicalize='=>'bool'], 'Locale::getAllVariants' => ['array|null', 'locale'=>'string'], 'Locale::getDefault' => ['non-empty-string'], 'Locale::getDisplayLanguage' => ['non-empty-string', 'locale'=>'string', 'displayLocale='=>'string'], 'Locale::getDisplayName' => ['non-empty-string', 'locale'=>'string', 'displayLocale='=>'string'], 'Locale::getDisplayRegion' => ['non-empty-string', 'locale'=>'string', 'displayLocale='=>'string'], 'Locale::getDisplayScript' => ['string', 'locale'=>'string', 'displayLocale='=>'string'], 'Locale::getDisplayVariant' => ['string', 'locale'=>'string', 'displayLocale='=>'string'], 'Locale::getKeywords' => ['array|null', 'locale'=>'string'], 'Locale::getPrimaryLanguage' => ['non-empty-string|null', 'locale'=>'string'], 'Locale::getRegion' => ['string|null', 'locale'=>'string'], 'Locale::getScript' => ['string|null', 'locale'=>'string'], 'Locale::lookup' => ['string|null', 'languageTag'=>'array', 'locale'=>'string', 'canonicalize='=>'bool', 'defaultLocale='=>'string'], 'Locale::parseLocale' => ['array|null', 'locale'=>'string'], 'Locale::setDefault' => ['bool', 'locale'=>'string'], 'locale_accept_from_http' => ['non-empty-string|false', 'header'=>'string'], 'locale_canonicalize' => ['non-empty-string|null', 'locale'=>'string'], 'locale_compose' => ['string|false', 'subtags'=>'array'], 'locale_filter_matches' => ['bool|null', 'langtag'=>'string', 'locale'=>'string', 'canonicalize='=>'bool'], 'locale_get_all_variants' => ['array|null', 'locale'=>'string'], 'locale_get_default' => ['non-empty-string'], 'locale_get_display_language' => ['non-empty-string', 'locale'=>'string', 'displayLocale='=>'string'], 'locale_get_display_name' => ['non-empty-string', 'locale'=>'string', 'displayLocale='=>'string'], 'locale_get_display_region' => ['non-empty-string', 'locale'=>'string', 'displayLocale='=>'string'], 'locale_get_display_script' => ['string', 'locale'=>'string', 'displayLocale='=>'string'], 'locale_get_display_variant' => ['string', 'locale'=>'string', 'displayLocale='=>'string'], 'locale_get_keywords' => ['array|null', 'locale'=>'string'], 'locale_get_primary_language' => ['non-empty-string|null', 'locale'=>'string'], 'locale_get_region' => ['string|null', 'locale'=>'string'], 'locale_get_script' => ['string|null', 'locale'=>'string'], 'locale_lookup' => ['string|null', 'langtag'=>'array', 'locale'=>'string', 'canonicalize='=>'bool', 'defaultLocale='=>'string'], 'locale_parse' => ['array|null', 'locale'=>'string'], 'locale_set_default' => ['bool', 'locale'=>'string'], 'localeconv' => ['array'], 'localtime' => ['array', 'timestamp='=>'int', 'associative_array='=>'bool'], 'log' => ['float', 'number'=>'float', 'base='=>'float'], 'log10' => ['float', 'number'=>'float'], 'log1p' => ['float', 'number'=>'float'], 'LogicException::__clone' => ['void'], 'LogicException::__construct' => ['void', 'message='=>'string', 'code='=>'int', 'previous='=>'(?Throwable)|(?LogicException)'], 'LogicException::__toString' => ['string'], 'LogicException::getCode' => ['int'], 'LogicException::getFile' => ['string'], 'LogicException::getLine' => ['int'], 'LogicException::getMessage' => ['string'], 'LogicException::getPrevious' => ['Throwable|LogicException|null'], 'LogicException::getTrace' => ['list<array{function:string,line?:int,file?:string,class?:class-string,type?:\'::\'|\'->\',args?:mixed[],object?:object}>'], 'LogicException::getTraceAsString' => ['string'], 'long2ip' => ['string|false', 'proper_address'=>'int'], 'lstat' => ['array|false', 'filename'=>'string'], 'ltrim' => ['string', 'str'=>'string', 'character_mask='=>'string'], 'Lua::__call' => ['mixed', 'lua_func'=>'callable', 'args='=>'array', 'use_self='=>'int'], 'Lua::__construct' => ['void', 'lua_script_file'=>'string'], 'Lua::assign' => ['mixed', 'name'=>'string', 'value'=>'string'], 'Lua::call' => ['mixed', 'lua_func'=>'callable', 'args='=>'array', 'use_self='=>'int'], 'Lua::eval' => ['mixed', 'statements'=>'string'], 'Lua::getVersion' => ['string'], 'Lua::include' => ['mixed', 'file'=>'string'], 'Lua::registerCallback' => ['mixed', 'name'=>'string', 'function'=>'callable'], 'LuaClosure::__invoke' => ['void', 'arg'=>'mixed', '...args='=>'mixed'], 'lzf_compress' => ['string', 'data'=>'string'], 'lzf_decompress' => ['string', 'data'=>'string'], 'lzf_optimized_for' => ['int'], 'm_checkstatus' => ['int', 'conn'=>'resource', 'identifier'=>'int'], 'm_completeauthorizations' => ['int', 'conn'=>'resource', 'array'=>'int'], 'm_connect' => ['int', 'conn'=>'resource'], 'm_connectionerror' => ['string', 'conn'=>'resource'], 'm_deletetrans' => ['bool', 'conn'=>'resource', 'identifier'=>'int'], 'm_destroyconn' => ['bool', 'conn'=>'resource'], 'm_destroyengine' => ['void'], 'm_getcell' => ['string', 'conn'=>'resource', 'identifier'=>'int', 'column'=>'string', 'row'=>'int'], 'm_getcellbynum' => ['string', 'conn'=>'resource', 'identifier'=>'int', 'column'=>'int', 'row'=>'int'], 'm_getcommadelimited' => ['string', 'conn'=>'resource', 'identifier'=>'int'], 'm_getheader' => ['string', 'conn'=>'resource', 'identifier'=>'int', 'column_num'=>'int'], 'm_initconn' => ['resource'], 'm_initengine' => ['int', 'location'=>'string'], 'm_iscommadelimited' => ['int', 'conn'=>'resource', 'identifier'=>'int'], 'm_maxconntimeout' => ['bool', 'conn'=>'resource', 'secs'=>'int'], 'm_monitor' => ['int', 'conn'=>'resource'], 'm_numcolumns' => ['int', 'conn'=>'resource', 'identifier'=>'int'], 'm_numrows' => ['int', 'conn'=>'resource', 'identifier'=>'int'], 'm_parsecommadelimited' => ['int', 'conn'=>'resource', 'identifier'=>'int'], 'm_responsekeys' => ['array', 'conn'=>'resource', 'identifier'=>'int'], 'm_responseparam' => ['string', 'conn'=>'resource', 'identifier'=>'int', 'key'=>'string'], 'm_returnstatus' => ['int', 'conn'=>'resource', 'identifier'=>'int'], 'm_setblocking' => ['int', 'conn'=>'resource', 'tf'=>'int'], 'm_setdropfile' => ['int', 'conn'=>'resource', 'directory'=>'string'], 'm_setip' => ['int', 'conn'=>'resource', 'host'=>'string', 'port'=>'int'], 'm_setssl' => ['int', 'conn'=>'resource', 'host'=>'string', 'port'=>'int'], 'm_setssl_cafile' => ['int', 'conn'=>'resource', 'cafile'=>'string'], 'm_setssl_files' => ['int', 'conn'=>'resource', 'sslkeyfile'=>'string', 'sslcertfile'=>'string'], 'm_settimeout' => ['int', 'conn'=>'resource', 'seconds'=>'int'], 'm_sslcert_gen_hash' => ['string', 'filename'=>'string'], 'm_transactionssent' => ['int', 'conn'=>'resource'], 'm_transinqueue' => ['int', 'conn'=>'resource'], 'm_transkeyval' => ['int', 'conn'=>'resource', 'identifier'=>'int', 'key'=>'string', 'value'=>'string'], 'm_transnew' => ['int', 'conn'=>'resource'], 'm_transsend' => ['int', 'conn'=>'resource', 'identifier'=>'int'], 'm_uwait' => ['int', 'microsecs'=>'int'], 'm_validateidentifier' => ['int', 'conn'=>'resource', 'tf'=>'int'], 'm_verifyconnection' => ['bool', 'conn'=>'resource', 'tf'=>'int'], 'm_verifysslcert' => ['bool', 'conn'=>'resource', 'tf'=>'int'], 'magic_quotes_runtime' => ['', 'new_setting'=>''], 'mail' => ['bool', 'to'=>'string', 'subject'=>'string', 'message'=>'string', 'additional_headers='=>'string|array|null', 'additional_parameters='=>'string'], 'mailparse_determine_best_xfer_encoding' => ['string', 'fp'=>'resource'], 'mailparse_msg_create' => ['resource'], 'mailparse_msg_extract_part' => ['void', 'mimemail'=>'resource', 'msgbody'=>'string', 'callbackfunc='=>'callable'], 'mailparse_msg_extract_part_file' => ['string', 'mimemail'=>'resource', 'filename'=>'mixed', 'callbackfunc='=>'callable'], 'mailparse_msg_extract_whole_part_file' => ['string', 'mimemail'=>'resource', 'filename'=>'string', 'callbackfunc='=>'callable'], 'mailparse_msg_free' => ['bool', 'mimemail'=>'resource'], 'mailparse_msg_get_part' => ['resource|false', 'mimemail'=>'resource', 'mimesection'=>'string'], 'mailparse_msg_get_part_data' => ['array', 'mimemail'=>'resource'], 'mailparse_msg_get_structure' => ['array', 'mimemail'=>'resource'], 'mailparse_msg_parse' => ['bool', 'mimemail'=>'resource', 'data'=>'string'], 'mailparse_msg_parse_file' => ['resource', 'filename'=>'string'], 'mailparse_rfc822_parse_addresses' => ['array', 'addresses'=>'string'], 'mailparse_stream_encode' => ['bool', 'sourcefp'=>'resource', 'destfp'=>'resource', 'encoding'=>'string'], 'mailparse_uudecode_all' => ['array', 'fp'=>'resource'], 'mapObj::__construct' => ['void', 'map_file_name'=>'string', 'new_map_path'=>'string'], 'mapObj::appendOutputFormat' => ['int', 'outputFormat'=>'outputformatObj'], 'mapObj::applyconfigoptions' => ['int'], 'mapObj::applySLD' => ['int', 'sldxml'=>'string'], 'mapObj::applySLDURL' => ['int', 'sldurl'=>'string'], 'mapObj::convertToString' => ['string'], 'mapObj::draw' => ['imageObj'], 'mapObj::drawLabelCache' => ['int', 'image'=>'imageObj'], 'mapObj::drawLegend' => ['imageObj'], 'mapObj::drawQuery' => ['imageObj'], 'mapObj::drawReferenceMap' => ['imageObj'], 'mapObj::drawScaleBar' => ['imageObj'], 'mapObj::embedLegend' => ['int', 'image'=>'imageObj'], 'mapObj::embedScalebar' => ['int', 'image'=>'imageObj'], 'mapObj::free' => ['void'], 'mapObj::generateSLD' => ['string'], 'mapObj::getAllGroupNames' => ['array'], 'mapObj::getAllLayerNames' => ['array'], 'mapObj::getColorbyIndex' => ['colorObj', 'iCloIndex'=>'int'], 'mapObj::getConfigOption' => ['string', 'key'=>'string'], 'mapObj::getLabel' => ['labelcacheMemberObj', 'index'=>'int'], 'mapObj::getLayer' => ['layerObj', 'index'=>'int'], 'mapObj::getLayerByName' => ['layerObj', 'layer_name'=>'string'], 'mapObj::getLayersDrawingOrder' => ['array'], 'mapObj::getLayersIndexByGroup' => ['array', 'groupname'=>'string'], 'mapObj::getMetaData' => ['int', 'name'=>'string'], 'mapObj::getNumSymbols' => ['int'], 'mapObj::getOutputFormat' => ['outputformatObj', 'index'=>'int'], 'mapObj::getProjection' => ['string'], 'mapObj::getSymbolByName' => ['int', 'symbol_name'=>'string'], 'mapObj::getSymbolObjectById' => ['symbolObj', 'symbolid'=>'int'], 'mapObj::loadMapContext' => ['int', 'filename'=>'string', 'unique_layer_name'=>'bool'], 'mapObj::loadOWSParameters' => ['int', 'request'=>'OwsrequestObj', 'version'=>'string'], 'mapObj::moveLayerDown' => ['int', 'layerindex'=>'int'], 'mapObj::moveLayerUp' => ['int', 'layerindex'=>'int'], 'mapObj::ms_newMapObjFromString' => ['mapObj', 'map_file_string'=>'string', 'new_map_path'=>'string'], 'mapObj::offsetExtent' => ['int', 'x'=>'float', 'y'=>'float'], 'mapObj::owsDispatch' => ['int', 'request'=>'OwsrequestObj'], 'mapObj::prepareImage' => ['imageObj'], 'mapObj::prepareQuery' => ['void'], 'mapObj::processLegendTemplate' => ['string', 'params'=>'array'], 'mapObj::processQueryTemplate' => ['string', 'params'=>'array', 'generateimages'=>'bool'], 'mapObj::processTemplate' => ['string', 'params'=>'array', 'generateimages'=>'bool'], 'mapObj::queryByFeatures' => ['int', 'slayer'=>'int'], 'mapObj::queryByIndex' => ['int', 'layerindex'=>'', 'tileindex'=>'', 'shapeindex'=>'', 'addtoquery'=>''], 'mapObj::queryByPoint' => ['int', 'point'=>'pointObj', 'mode'=>'int', 'buffer'=>'float'], 'mapObj::queryByRect' => ['int', 'rect'=>'rectObj'], 'mapObj::queryByShape' => ['int', 'shape'=>'shapeObj'], 'mapObj::removeLayer' => ['layerObj', 'nIndex'=>'int'], 'mapObj::removeMetaData' => ['int', 'name'=>'string'], 'mapObj::removeOutputFormat' => ['int', 'name'=>'string'], 'mapObj::save' => ['int', 'filename'=>'string'], 'mapObj::saveMapContext' => ['int', 'filename'=>'string'], 'mapObj::saveQuery' => ['int', 'filename'=>'string', 'results'=>'int'], 'mapObj::scaleExtent' => ['int', 'zoomfactor'=>'float', 'minscaledenom'=>'float', 'maxscaledenom'=>'float'], 'mapObj::selectOutputFormat' => ['int', 'type'=>'string'], 'mapObj::set' => ['int', 'property_name'=>'string', 'new_value'=>''], 'mapObj::setCenter' => ['int', 'center'=>'pointObj'], 'mapObj::setConfigOption' => ['int', 'key'=>'string', 'value'=>'string'], 'mapObj::setExtent' => ['void', 'minx'=>'float', 'miny'=>'float', 'maxx'=>'float', 'maxy'=>'float'], 'mapObj::setFontSet' => ['int', 'fileName'=>'string'], 'mapObj::setMetaData' => ['int', 'name'=>'string', 'value'=>'string'], 'mapObj::setProjection' => ['int', 'proj_params'=>'string', 'bSetUnitsAndExtents'=>'bool'], 'mapObj::setRotation' => ['int', 'rotation_angle'=>'float'], 'mapObj::setSize' => ['int', 'width'=>'int', 'height'=>'int'], 'mapObj::setSymbolSet' => ['int', 'fileName'=>'string'], 'mapObj::setWKTProjection' => ['int', 'proj_params'=>'string', 'bSetUnitsAndExtents'=>'bool'], 'mapObj::zoomPoint' => ['int', 'nZoomFactor'=>'int', 'oPixelPos'=>'pointObj', 'nImageWidth'=>'int', 'nImageHeight'=>'int', 'oGeorefExt'=>'rectObj'], 'mapObj::zoomRectangle' => ['int', 'oPixelExt'=>'rectObj', 'nImageWidth'=>'int', 'nImageHeight'=>'int', 'oGeorefExt'=>'rectObj'], 'mapObj::zoomScale' => ['int', 'nScaleDenom'=>'float', 'oPixelPos'=>'pointObj', 'nImageWidth'=>'int', 'nImageHeight'=>'int', 'oGeorefExt'=>'rectObj', 'oMaxGeorefExt'=>'rectObj'], 'max' => ['', '...arg1'=>'array'], 'max\'1' => ['', 'arg1'=>'', 'arg2'=>'', '...args='=>''], 'maxdb::__construct' => ['void', 'host='=>'string', 'username='=>'string', 'passwd='=>'string', 'dbname='=>'string', 'port='=>'int', 'socket='=>'string'], 'maxdb::affected_rows' => ['int', 'link'=>''], 'maxdb::auto_commit' => ['bool', 'link'=>'', 'mode'=>'bool'], 'maxdb::change_user' => ['bool', 'link'=>'', 'user'=>'string', 'password'=>'string', 'database'=>'string'], 'maxdb::character_set_name' => ['string', 'link'=>''], 'maxdb::close' => ['bool', 'link'=>''], 'maxdb::commit' => ['bool', 'link'=>''], 'maxdb::disable_reads_from_master' => ['', 'link'=>''], 'maxdb::errno' => ['int', 'link'=>''], 'maxdb::error' => ['string', 'link'=>''], 'maxdb::field_count' => ['int', 'link'=>''], 'maxdb::get_host_info' => ['string', 'link'=>''], 'maxdb::info' => ['string', 'link'=>''], 'maxdb::insert_id' => ['', 'link'=>''], 'maxdb::kill' => ['bool', 'link'=>'', 'processid'=>'int'], 'maxdb::more_results' => ['bool', 'link'=>''], 'maxdb::multi_query' => ['bool', 'link'=>'', 'query'=>'string'], 'maxdb::next_result' => ['bool', 'link'=>''], 'maxdb::num_rows' => ['int', 'result'=>''], 'maxdb::options' => ['bool', 'link'=>'', 'option'=>'int', 'value'=>''], 'maxdb::ping' => ['bool', 'link'=>''], 'maxdb::prepare' => ['maxdb_stmt', 'link'=>'', 'query'=>'string'], 'maxdb::protocol_version' => ['string', 'link'=>''], 'maxdb::query' => ['', 'link'=>'', 'query'=>'string', 'resultmode='=>'int'], 'maxdb::real_connect' => ['bool', 'link'=>'', 'hostname='=>'string', 'username='=>'string', 'passwd='=>'string', 'dbname='=>'string', 'port='=>'int', 'socket='=>'string'], 'maxdb::real_escape_string' => ['string', 'link'=>'', 'escapestr'=>'string'], 'maxdb::real_query' => ['bool', 'link'=>'', 'query'=>'string'], 'maxdb::rollback' => ['bool', 'link'=>''], 'maxdb::rpl_query_type' => ['int', 'link'=>''], 'maxdb::select_db' => ['bool', 'link'=>'', 'dbname'=>'string'], 'maxdb::send_query' => ['bool', 'link'=>'', 'query'=>'string'], 'maxdb::server_info' => ['string', 'link'=>''], 'maxdb::server_version' => ['int', 'link'=>''], 'maxdb::sqlstate' => ['string', 'link'=>''], 'maxdb::ssl_set' => ['bool', 'link'=>'', 'key'=>'string', 'cert'=>'string', 'ca'=>'string', 'capath'=>'string', 'cipher'=>'string'], 'maxdb::stat' => ['string', 'link'=>''], 'maxdb::stmt_init' => ['object', 'link'=>''], 'maxdb::store_result' => ['bool', 'link'=>''], 'maxdb::thread_id' => ['int', 'link'=>''], 'maxdb::use_result' => ['resource', 'link'=>''], 'maxdb::warning_count' => ['int', 'link'=>''], 'maxdb_affected_rows' => ['int', 'link'=>'resource'], 'maxdb_autocommit' => ['bool', 'link'=>'', 'mode'=>'bool'], 'maxdb_change_user' => ['bool', 'link'=>'', 'user'=>'string', 'password'=>'string', 'database'=>'string'], 'maxdb_character_set_name' => ['string', 'link'=>''], 'maxdb_close' => ['bool', 'link'=>''], 'maxdb_commit' => ['bool', 'link'=>''], 'maxdb_connect' => ['resource', 'host='=>'string', 'username='=>'string', 'passwd='=>'string', 'dbname='=>'string', 'port='=>'int', 'socket='=>'string'], 'maxdb_connect_errno' => ['int'], 'maxdb_connect_error' => ['string'], 'maxdb_data_seek' => ['bool', 'result'=>'', 'offset'=>'int'], 'maxdb_debug' => ['void', 'debug'=>'string'], 'maxdb_disable_reads_from_master' => ['', 'link'=>''], 'maxdb_disable_rpl_parse' => ['bool', 'link'=>'resource'], 'maxdb_dump_debug_info' => ['bool', 'link'=>'resource'], 'maxdb_embedded_connect' => ['resource', 'dbname='=>'string'], 'maxdb_enable_reads_from_master' => ['bool', 'link'=>'resource'], 'maxdb_enable_rpl_parse' => ['bool', 'link'=>'resource'], 'maxdb_errno' => ['int', 'link'=>'resource'], 'maxdb_error' => ['string', 'link'=>'resource'], 'maxdb_fetch_array' => ['', 'result'=>'', 'resulttype='=>'int'], 'maxdb_fetch_assoc' => ['array', 'result'=>''], 'maxdb_fetch_field' => ['', 'result'=>''], 'maxdb_fetch_field_direct' => ['', 'result'=>'', 'fieldnr'=>'int'], 'maxdb_fetch_fields' => ['', 'result'=>''], 'maxdb_fetch_lengths' => ['array', 'result'=>'resource'], 'maxdb_fetch_object' => ['object', 'result'=>'object'], 'maxdb_fetch_row' => ['', 'result'=>''], 'maxdb_field_count' => ['int', 'link'=>''], 'maxdb_field_seek' => ['bool', 'result'=>'', 'fieldnr'=>'int'], 'maxdb_field_tell' => ['int', 'result'=>'resource'], 'maxdb_free_result' => ['', 'result'=>''], 'maxdb_get_client_info' => ['string'], 'maxdb_get_client_version' => ['int'], 'maxdb_get_host_info' => ['string', 'link'=>'resource'], 'maxdb_get_proto_info' => ['string', 'link'=>'resource'], 'maxdb_get_server_info' => ['string', 'link'=>'resource'], 'maxdb_get_server_version' => ['int', 'link'=>'resource'], 'maxdb_info' => ['string', 'link'=>'resource'], 'maxdb_init' => ['resource'], 'maxdb_insert_id' => ['mixed', 'link'=>'resource'], 'maxdb_kill' => ['bool', 'link'=>'', 'processid'=>'int'], 'maxdb_master_query' => ['bool', 'link'=>'resource', 'query'=>'string'], 'maxdb_more_results' => ['bool', 'link'=>'resource'], 'maxdb_multi_query' => ['bool', 'link'=>'', 'query'=>'string'], 'maxdb_next_result' => ['bool', 'link'=>'resource'], 'maxdb_num_fields' => ['int', 'result'=>'resource'], 'maxdb_num_rows' => ['int', 'result'=>'resource'], 'maxdb_options' => ['bool', 'link'=>'', 'option'=>'int', 'value'=>''], 'maxdb_ping' => ['bool', 'link'=>''], 'maxdb_prepare' => ['maxdb_stmt', 'link'=>'', 'query'=>'string'], 'maxdb_query' => ['', 'link'=>'', 'query'=>'string', 'resultmode='=>'int'], 'maxdb_real_connect' => ['bool', 'link'=>'', 'hostname='=>'string', 'username='=>'string', 'passwd='=>'string', 'dbname='=>'string', 'port='=>'int', 'socket='=>'string'], 'maxdb_real_escape_string' => ['string', 'link'=>'', 'escapestr'=>'string'], 'maxdb_real_query' => ['bool', 'link'=>'', 'query'=>'string'], 'maxdb_report' => ['bool', 'flags'=>'int'], 'maxdb_result::current_field' => ['int', 'result'=>''], 'maxdb_result::data_seek' => ['bool', 'result'=>'', 'offset'=>'int'], 'maxdb_result::fetch_array' => ['', 'result'=>'', 'resulttype='=>'int'], 'maxdb_result::fetch_assoc' => ['array', 'result'=>''], 'maxdb_result::fetch_field' => ['', 'result'=>''], 'maxdb_result::fetch_field_direct' => ['', 'result'=>'', 'fieldnr'=>'int'], 'maxdb_result::fetch_fields' => ['', 'result'=>''], 'maxdb_result::fetch_object' => ['object', 'result'=>'object'], 'maxdb_result::fetch_row' => ['', 'result'=>''], 'maxdb_result::field_count' => ['int', 'result'=>''], 'maxdb_result::field_seek' => ['bool', 'result'=>'', 'fieldnr'=>'int'], 'maxdb_result::free' => ['', 'result'=>''], 'maxdb_result::lengths' => ['array', 'result'=>''], 'maxdb_rollback' => ['bool', 'link'=>''], 'maxdb_rpl_parse_enabled' => ['int', 'link'=>'resource'], 'maxdb_rpl_probe' => ['bool', 'link'=>'resource'], 'maxdb_rpl_query_type' => ['int', 'link'=>''], 'maxdb_select_db' => ['bool', 'link'=>'resource', 'dbname'=>'string'], 'maxdb_send_query' => ['bool', 'link'=>'', 'query'=>'string'], 'maxdb_server_end' => ['void'], 'maxdb_server_init' => ['bool', 'server='=>'array', 'groups='=>'array'], 'maxdb_sqlstate' => ['string', 'link'=>'resource'], 'maxdb_ssl_set' => ['bool', 'link'=>'', 'key'=>'string', 'cert'=>'string', 'ca'=>'string', 'capath'=>'string', 'cipher'=>'string'], 'maxdb_stat' => ['string', 'link'=>''], 'maxdb_stmt::affected_rows' => ['int', 'stmt'=>''], 'maxdb_stmt::bind_param' => ['bool', 'stmt'=>'', 'types'=>'string', '&...rw_var'=>''], 'maxdb_stmt::bind_param\'1' => ['bool', 'stmt'=>'', 'types'=>'string', '&rw_var'=>'array'], 'maxdb_stmt::bind_result' => ['bool', 'stmt'=>'', '&w_var1'=>'', '&...w_vars='=>''], 'maxdb_stmt::close' => ['bool', 'stmt'=>''], 'maxdb_stmt::close_long_data' => ['bool', 'stmt'=>'', 'param_nr'=>'int'], 'maxdb_stmt::data_seek' => ['bool', 'statement'=>'', 'offset'=>'int'], 'maxdb_stmt::errno' => ['int', 'stmt'=>''], 'maxdb_stmt::error' => ['string', 'stmt'=>''], 'maxdb_stmt::execute' => ['bool', 'stmt'=>''], 'maxdb_stmt::fetch' => ['bool', 'stmt'=>''], 'maxdb_stmt::free_result' => ['', 'stmt'=>''], 'maxdb_stmt::num_rows' => ['int', 'stmt'=>''], 'maxdb_stmt::param_count' => ['int', 'stmt'=>''], 'maxdb_stmt::prepare' => ['', 'stmt'=>'', 'query'=>'string'], 'maxdb_stmt::reset' => ['bool', 'stmt'=>''], 'maxdb_stmt::result_metadata' => ['resource', 'stmt'=>''], 'maxdb_stmt::send_long_data' => ['bool', 'stmt'=>'', 'param_nr'=>'int', 'data'=>'string'], 'maxdb_stmt::stmt_send_long_data' => ['bool', 'param_nr'=>'int', 'data'=>'string'], 'maxdb_stmt::store_result' => ['bool'], 'maxdb_stmt_affected_rows' => ['int', 'stmt'=>'resource'], 'maxdb_stmt_bind_param' => ['bool', 'stmt'=>'', 'types'=>'string', 'var1'=>'', '...args='=>'', 'var='=>'array'], 'maxdb_stmt_bind_result' => ['bool', 'stmt'=>'', '&w_var1'=>'', '&...w_vars='=>''], 'maxdb_stmt_close' => ['bool', 'stmt'=>''], 'maxdb_stmt_close_long_data' => ['bool', 'stmt'=>'', 'param_nr'=>'int'], 'maxdb_stmt_data_seek' => ['bool', 'statement'=>'', 'offset'=>'int'], 'maxdb_stmt_errno' => ['int', 'stmt'=>'resource'], 'maxdb_stmt_error' => ['string', 'stmt'=>'resource'], 'maxdb_stmt_execute' => ['bool', 'stmt'=>''], 'maxdb_stmt_fetch' => ['bool', 'stmt'=>''], 'maxdb_stmt_free_result' => ['', 'stmt'=>''], 'maxdb_stmt_init' => ['object', 'link'=>''], 'maxdb_stmt_num_rows' => ['int', 'stmt'=>'resource'], 'maxdb_stmt_param_count' => ['int', 'stmt'=>'resource'], 'maxdb_stmt_prepare' => ['', 'stmt'=>'', 'query'=>'string'], 'maxdb_stmt_reset' => ['bool', 'stmt'=>''], 'maxdb_stmt_result_metadata' => ['resource', 'stmt'=>''], 'maxdb_stmt_send_long_data' => ['bool', 'stmt'=>'', 'param_nr'=>'int', 'data'=>'string'], 'maxdb_stmt_sqlstate' => ['string', 'stmt'=>'resource'], 'maxdb_stmt_store_result' => ['bool', 'stmt'=>''], 'maxdb_store_result' => ['bool', 'link'=>''], 'maxdb_thread_id' => ['int', 'link'=>'resource'], 'maxdb_thread_safe' => ['bool'], 'maxdb_use_result' => ['resource', 'link'=>''], 'maxdb_warning_count' => ['int', 'link'=>'resource'], 'mb_check_encoding' => ['bool', 'var='=>'string|array<string>', 'encoding='=>'string'], 'mb_chr' => ['string|false', 'cp'=>'int', 'encoding='=>'string'], 'mb_convert_case' => ['string', 'sourcestring'=>'string', 'mode'=>'int', 'encoding='=>'string'], 'mb_convert_encoding' => ['string|array<int, string>|false', 'val'=>'string|array<int, string>', 'to_encoding'=>'string', 'from_encoding='=>'mixed'], 'mb_convert_kana' => ['string', 'str'=>'string', 'option='=>'string', 'encoding='=>'string'], 'mb_convert_variables' => ['string|false', 'to_encoding'=>'string', 'from_encoding'=>'array|string', '&rw_vars'=>'string|array|object', '&...rw_vars='=>'string|array|object'], 'mb_decode_mimeheader' => ['string', 'string'=>'string'], 'mb_decode_numericentity' => ['string', 'string'=>'string', 'convmap'=>'array', 'encoding'=>'string'], 'mb_detect_encoding' => ['string|false', 'str'=>'string', 'encoding_list='=>'mixed', 'strict='=>'bool'], 'mb_detect_order' => ['bool|list<non-falsy-string>', 'encoding_list='=>'mixed'], 'mb_encode_mimeheader' => ['string', 'str'=>'string', 'charset='=>'string', 'transfer_encoding='=>'string', 'linefeed='=>'string', 'indent='=>'int'], 'mb_encode_numericentity' => ['string', 'string'=>'string', 'convmap'=>'array', 'encoding='=>'string', 'is_hex='=>'bool'], 'mb_encoding_aliases' => ['list<non-falsy-string>|false', 'encoding'=>'string'], 'mb_ereg' => ['int|false', 'pattern'=>'string', 'string'=>'string', '&w_registers='=>'array'], 'mb_ereg_match' => ['bool', 'pattern'=>'string', 'string'=>'string', 'option='=>'string'], 'mb_ereg_replace' => ['string|false|null', 'pattern'=>'string', 'replacement'=>'string', 'string'=>'string', 'option='=>'string'], 'mb_ereg_replace_callback' => ['string|false|null', 'pattern'=>'string', 'callback'=>'callable(array<int|string, string>):string', 'string'=>'string', 'option='=>'string'], 'mb_ereg_search' => ['bool', 'pattern='=>'string', 'option='=>'string'], 'mb_ereg_search_getpos' => ['int'], 'mb_ereg_search_getregs' => ['array|false'], 'mb_ereg_search_init' => ['bool', 'string'=>'string', 'pattern='=>'string', 'option='=>'string'], 'mb_ereg_search_pos' => ['array|false', 'pattern='=>'string', 'option='=>'string'], 'mb_ereg_search_regs' => ['array|false', 'pattern='=>'string', 'option='=>'string'], 'mb_ereg_search_setpos' => ['bool', 'position'=>'int'], 'mb_eregi' => ['int', 'pattern'=>'string', 'string'=>'string', '&w_registers='=>'array'], 'mb_eregi_replace' => ['string|false', 'pattern'=>'string', 'replacement'=>'string', 'string'=>'string', 'option='=>'string'], 'mb_get_info' => ['mixed', 'type='=>'string'], 'mb_http_input' => ['mixed', 'type='=>'string'], 'mb_http_output' => ['string|bool', 'encoding='=>'string'], 'mb_internal_encoding' => ['string|bool', 'encoding='=>'string'], 'mb_language' => ['string|bool', 'language='=>'string'], 'mb_list_encodings' => ['non-empty-list<non-falsy-string>'], 'mb_ord' => ['int|false', 'str'=>'string', 'enc='=>'string'], 'mb_output_handler' => ['string', 'contents'=>'string', 'status'=>'int'], 'mb_parse_str' => ['bool', 'encoded_string'=>'string', '&w_result='=>'array'], 'mb_preferred_mime_name' => ['string|false', 'encoding'=>'string'], 'mb_regex_encoding' => ['string|bool', 'encoding='=>'string'], 'mb_regex_set_options' => ['string', 'options='=>'string'], 'mb_scrub' => ['string', 'str'=>'string', 'enc='=>'string'], 'mb_send_mail' => ['bool', 'to'=>'string', 'subject'=>'string', 'message'=>'string', 'additional_headers='=>'string|array|null', 'additional_parameter='=>'string'], 'mb_split' => ['list<string>|false', 'pattern'=>'string', 'string'=>'string', 'limit='=>'int'], 'mb_strcut' => ['string', 'str'=>'string', 'start'=>'int', 'length='=>'?int', 'encoding='=>'string'], 'mb_strimwidth' => ['string', 'str'=>'string', 'start'=>'int', 'width'=>'int', 'trimmarker='=>'string', 'encoding='=>'string'], 'mb_stripos' => ['0|positive-int|false', 'haystack'=>'string', 'needle'=>'string', 'offset='=>'int', 'encoding='=>'string'], 'mb_stristr' => ['string|false', 'haystack'=>'string', 'needle'=>'string', 'part='=>'bool', 'encoding='=>'string'], 'mb_strlen' => ['0|positive-int|false', 'str'=>'string', 'encoding='=>'string'], 'mb_strpos' => ['0|positive-int|false', 'haystack'=>'string', 'needle'=>'string', 'offset='=>'int', 'encoding='=>'string'], 'mb_strrchr' => ['string|false', 'haystack'=>'string', 'needle'=>'string', 'part='=>'bool', 'encoding='=>'string'], 'mb_strrichr' => ['string|false', 'haystack'=>'string', 'needle'=>'string', 'part='=>'bool', 'encoding='=>'string'], 'mb_strripos' => ['0|positive-int|false', 'haystack'=>'string', 'needle'=>'string', 'offset='=>'int', 'encoding='=>'string'], 'mb_strrpos' => ['0|positive-int|false', 'haystack'=>'string', 'needle'=>'string', 'offset='=>'int', 'encoding='=>'string'], 'mb_strstr' => ['string|false', 'haystack'=>'string', 'needle'=>'string', 'part='=>'bool', 'encoding='=>'string'], 'mb_strtolower' => ['lowercase-string', 'str'=>'string', 'encoding='=>'string'], 'mb_strtoupper' => ['uppercase-string', 'str'=>'string', 'encoding='=>'string'], 'mb_strwidth' => ['0|positive-int', 'str'=>'string', 'encoding='=>'string'], 'mb_substitute_character' => ['mixed', 'substchar='=>'mixed'], 'mb_substr' => ['string', 'str'=>'string', 'start'=>'int', 'length='=>'?int', 'encoding='=>'string'], 'mb_substr_count' => ['0|positive-int', 'haystack'=>'string', 'needle'=>'string', 'encoding='=>'string'], 'mcrypt_cbc' => ['string', 'cipher'=>'string', 'key'=>'string', 'data'=>'string', 'mode'=>'int', 'iv='=>'string'], 'mcrypt_cfb' => ['string', 'cipher'=>'string', 'key'=>'string', 'data'=>'string', 'mode'=>'int', 'iv='=>'string'], 'mcrypt_create_iv' => ['string', 'size'=>'int', 'source='=>'int'], 'mcrypt_decrypt' => ['string', 'cipher'=>'string', 'key'=>'string', 'data'=>'string', 'mode'=>'string', 'iv='=>'string'], 'mcrypt_ecb' => ['string', 'cipher'=>'string', 'key'=>'string', 'data'=>'string', 'mode'=>'int', 'iv='=>'string'], 'mcrypt_enc_get_algorithms_name' => ['string', 'td'=>'resource'], 'mcrypt_enc_get_block_size' => ['int', 'td'=>'resource'], 'mcrypt_enc_get_iv_size' => ['int', 'td'=>'resource'], 'mcrypt_enc_get_key_size' => ['int', 'td'=>'resource'], 'mcrypt_enc_get_modes_name' => ['string', 'td'=>'resource'], 'mcrypt_enc_get_supported_key_sizes' => ['array', 'td'=>'resource'], 'mcrypt_enc_is_block_algorithm' => ['bool', 'td'=>'resource'], 'mcrypt_enc_is_block_algorithm_mode' => ['bool', 'td'=>'resource'], 'mcrypt_enc_is_block_mode' => ['bool', 'td'=>'resource'], 'mcrypt_enc_self_test' => ['int', 'td'=>'resource'], 'mcrypt_encrypt' => ['string', 'cipher'=>'string', 'key'=>'string', 'data'=>'string', 'mode'=>'string', 'iv='=>'string'], 'mcrypt_generic' => ['string', 'td'=>'resource', 'data'=>'string'], 'mcrypt_generic_deinit' => ['bool', 'td'=>'resource'], 'mcrypt_generic_end' => ['bool', 'td'=>'resource'], 'mcrypt_generic_init' => ['int', 'td'=>'resource', 'key'=>'string', 'iv'=>'string'], 'mcrypt_get_block_size' => ['int', 'cipher'=>'string', 'module'=>'string'], 'mcrypt_get_cipher_name' => ['string', 'cipher'=>'int|string'], 'mcrypt_get_iv_size' => ['int', 'cipher'=>'string', 'module'=>'string'], 'mcrypt_get_key_size' => ['int', 'cipher'=>'string', 'module'=>'string'], 'mcrypt_list_algorithms' => ['array', 'lib_dir='=>'string'], 'mcrypt_list_modes' => ['array', 'lib_dir='=>'string'], 'mcrypt_module_close' => ['bool', 'td'=>'resource'], 'mcrypt_module_get_algo_block_size' => ['int', 'algorithm'=>'string', 'lib_dir='=>'string'], 'mcrypt_module_get_algo_key_size' => ['int', 'algorithm'=>'string', 'lib_dir='=>'string'], 'mcrypt_module_get_supported_key_sizes' => ['array', 'algorithm'=>'string', 'lib_dir='=>'string'], 'mcrypt_module_is_block_algorithm' => ['bool', 'algorithm'=>'string', 'lib_dir='=>'string'], 'mcrypt_module_is_block_algorithm_mode' => ['bool', 'mode'=>'string', 'lib_dir='=>'string'], 'mcrypt_module_is_block_mode' => ['bool', 'mode'=>'string', 'lib_dir='=>'string'], 'mcrypt_module_open' => ['resource|false', 'cipher'=>'string', 'cipher_directory'=>'string', 'mode'=>'string', 'mode_directory'=>'string'], 'mcrypt_module_self_test' => ['bool', 'algorithm'=>'string', 'lib_dir='=>'string'], 'mcrypt_ofb' => ['string', 'cipher'=>'string', 'key'=>'string', 'data'=>'string', 'mode'=>'int', 'iv='=>'string'], 'md5' => ['non-falsy-string&lowercase-string', 'str'=>'string', 'raw_output='=>'bool'], 'md5_file' => ['(non-falsy-string&lowercase-string)|false', 'filename'=>'string', 'raw_output='=>'bool'], 'mdecrypt_generic' => ['string', 'td'=>'resource', 'data'=>'string'], 'Memcache::add' => ['bool', 'key'=>'string', 'var'=>'mixed', 'flag='=>'int', 'expire='=>'int'], 'Memcache::addServer' => ['bool', 'host'=>'string', 'port='=>'int', 'persistent='=>'bool', 'weight='=>'int', 'timeout='=>'int', 'retry_interval='=>'int', 'status='=>'bool', 'failure_callback='=>'callable', 'timeoutms='=>'int'], 'Memcache::close' => ['bool'], 'Memcache::connect' => ['bool', 'host'=>'string', 'port='=>'int', 'timeout='=>'int'], 'Memcache::decrement' => ['int', 'key'=>'string', 'value='=>'int'], 'Memcache::delete' => ['bool', 'key'=>'string', 'timeout='=>'int'], 'Memcache::flush' => ['bool'], 'Memcache::get' => ['mixed', 'key'=>'string', '&flags='=>'int'], 'Memcache::get\'1' => ['mixed[]|false', 'keys'=>'string[]', '&flags='=>'int[]'], 'Memcache::getExtendedStats' => ['array', 'type='=>'string', 'slabid='=>'int', 'limit='=>'int'], 'Memcache::getServerStatus' => ['int', 'host'=>'string', 'port='=>'int'], 'Memcache::getStats' => ['array', 'type='=>'string', 'slabid='=>'int', 'limit='=>'int'], 'Memcache::getVersion' => ['string'], 'Memcache::increment' => ['int', 'key'=>'string', 'value='=>'int'], 'Memcache::pconnect' => ['bool', 'host'=>'string', 'port='=>'int', 'timeout='=>'int'], 'Memcache::replace' => ['bool', 'key'=>'string', 'var'=>'mixed', 'flag='=>'int', 'expire='=>'int'], 'Memcache::set' => ['bool', 'key'=>'string', 'var'=>'mixed', 'flag='=>'int', 'expire='=>'int'], 'Memcache::setCompressThreshold' => ['bool', 'threshold'=>'int', 'min_savings='=>'float'], 'Memcache::setServerParams' => ['bool', 'host'=>'string', 'port='=>'int', 'timeout='=>'int', 'retry_interval='=>'int', 'status='=>'bool', 'failure_callback='=>'callable'], 'memcache_debug' => ['bool', 'on_off'=>'bool'], 'Memcached::add' => ['bool', 'key'=>'string', 'value'=>'mixed', 'expiration='=>'int'], 'Memcached::addByKey' => ['bool', 'server_key'=>'string', 'key'=>'string', 'value'=>'mixed', 'expiration='=>'int'], 'Memcached::addServer' => ['bool', 'host'=>'string', 'port'=>'int', 'weight='=>'int'], 'Memcached::addServers' => ['bool', 'servers'=>'array'], 'Memcached::append' => ['bool', 'key'=>'string', 'value'=>'string'], 'Memcached::appendByKey' => ['bool', 'server_key'=>'string', 'key'=>'string', 'value'=>'string'], 'Memcached::cas' => ['bool', 'cas_token'=>'float', 'key'=>'string', 'value'=>'mixed', 'expiration='=>'int'], 'Memcached::casByKey' => ['bool', 'cas_token'=>'float', 'server_key'=>'string', 'key'=>'string', 'value'=>'mixed', 'expiration='=>'int'], 'Memcached::decrement' => ['int|false', 'key'=>'string', 'offset='=>'int', 'initial_value='=>'int', 'expiry='=>'int'], 'Memcached::decrementByKey' => ['int|false', 'server_key'=>'string', 'key'=>'string', 'offset='=>'int', 'initial_value='=>'int', 'expiry='=>'int'], 'Memcached::delete' => ['bool', 'key'=>'string', 'time='=>'int'], 'Memcached::deleteByKey' => ['bool', 'server_key'=>'string', 'key'=>'string', 'time='=>'int'], 'Memcached::deleteMulti' => ['array', 'keys'=>'array', 'time='=>'int'], 'Memcached::deleteMultiByKey' => ['bool', 'server_key'=>'string', 'keys'=>'array', 'time='=>'int'], 'Memcached::fetch' => ['array'], 'Memcached::fetchAll' => ['array'], 'Memcached::flush' => ['bool', 'delay='=>'int'], 'Memcached::get' => ['mixed', 'key'=>'string', 'cache_cb='=>'?callable', 'flags='=>'int'], 'Memcached::getAllKeys' => ['array|false'], 'Memcached::getByKey' => ['mixed', 'server_key'=>'string', 'key'=>'string', 'value_cb='=>'?callable', 'flags='=>'int'], 'Memcached::getDelayed' => ['bool', 'keys'=>'array', 'with_cas='=>'bool', 'value_cb='=>'callable'], 'Memcached::getDelayedByKey' => ['bool', 'server_key'=>'string', 'keys'=>'array', 'with_cas='=>'bool', 'value_cb='=>'?callable'], 'Memcached::getMulti' => ['array|false', 'keys'=>'array', 'flags='=>'int'], 'Memcached::getMultiByKey' => ['array', 'server_key'=>'string', 'keys'=>'array', 'flags='=>'int'], 'Memcached::getOption' => ['mixed', 'option'=>'int'], 'Memcached::getResultCode' => ['int'], 'Memcached::getResultMessage' => ['string'], 'Memcached::getServerByKey' => ['array', 'server_key'=>'string'], 'Memcached::getServerList' => ['array'], 'Memcached::getStats' => ['array', 'type='=>'?string'], 'Memcached::getVersion' => ['array'], 'Memcached::increment' => ['int|false', 'key'=>'string', 'offset='=>'int', 'initial_value='=>'int', 'expiry='=>'int'], 'Memcached::incrementByKey' => ['int|false', 'server_key'=>'string', 'key'=>'string', 'offset='=>'int', 'initial_value='=>'int', 'expiry='=>'int'], 'Memcached::isPersistent' => ['bool'], 'Memcached::isPristine' => ['bool'], 'Memcached::prepend' => ['bool', 'key'=>'string', 'value'=>'string'], 'Memcached::prependByKey' => ['bool', 'server_key'=>'string', 'key'=>'string', 'value'=>'string'], 'Memcached::quit' => ['bool'], 'Memcached::replace' => ['bool', 'key'=>'string', 'value'=>'mixed', 'expiration='=>'int'], 'Memcached::replaceByKey' => ['bool', 'server_key'=>'string', 'key'=>'string', 'value'=>'mixed', 'expiration='=>'int'], 'Memcached::resetServerList' => ['bool'], 'Memcached::set' => ['bool', 'key'=>'string', 'value'=>'mixed', 'expiration='=>'int'], 'Memcached::setByKey' => ['bool', 'server_key'=>'string', 'key'=>'string', 'value'=>'mixed', 'expiration='=>'int'], 'Memcached::setMulti' => ['bool', 'items'=>'array', 'expiration='=>'int'], 'Memcached::setMultiByKey' => ['bool', 'server_key'=>'string', 'items'=>'array', 'expiration='=>'int'], 'Memcached::setOption' => ['bool', 'option'=>'int', 'value'=>'mixed'], 'Memcached::setOptions' => ['bool', 'options'=>'array'], 'Memcached::setSaslAuthData' => ['void', 'username'=>'string', 'password'=>'string'], 'Memcached::touch' => ['bool', 'key'=>'string', 'expiration'=>'int'], 'Memcached::touchByKey' => ['bool', 'server_key'=>'string', 'key'=>'string', 'expiration'=>'int'], 'MemcachePool::add' => ['bool', 'key'=>'string', 'var'=>'mixed', 'flag='=>'int', 'expire='=>'int'], 'MemcachePool::close' => ['bool'], 'MemcachePool::decrement' => ['int', 'key'=>'string', 'value='=>'int'], 'MemcachePool::delete' => ['bool', 'key'=>'string', 'timeout='=>'int'], 'MemcachePool::flush' => ['bool'], 'MemcachePool::get' => ['mixed', 'key'=>'string', '&flags='=>'int'], 'MemcachePool::get\'1' => ['mixed[]|false', 'keys'=>'string[]', '&flags='=>'int[]'], 'MemcachePool::getExtendedStats' => ['array', 'type='=>'string', 'slabid='=>'int', 'limit='=>'int'], 'MemcachePool::getServerStatus' => ['int', 'host'=>'string', 'port='=>'int'], 'MemcachePool::getStats' => ['array', 'type='=>'string', 'slabid='=>'int', 'limit='=>'int'], 'MemcachePool::getVersion' => ['string'], 'MemcachePool::increment' => ['int', 'key'=>'string', 'value='=>'int'], 'MemcachePool::replace' => ['bool', 'key'=>'string', 'var'=>'mixed', 'flag='=>'int', 'expire='=>'int'], 'MemcachePool::set' => ['bool', 'key'=>'string', 'var'=>'mixed', 'flag='=>'int', 'expire='=>'int'], 'MemcachePool::setCompressThreshold' => ['bool', 'threshold'=>'int', 'min_savings='=>'float'], 'MemcachePool::setServerParams' => ['bool', 'host'=>'string', 'port='=>'int', 'timeout='=>'int', 'retry_interval='=>'int', 'status='=>'bool', 'failure_callback='=>'callable'], 'memory_get_peak_usage' => ['positive-int', 'real_usage='=>'bool'], 'memory_get_usage' => ['positive-int', 'real_usage='=>'bool'], 'MessageFormatter::__construct' => ['void', 'locale'=>'string', 'pattern'=>'string'], 'MessageFormatter::create' => ['MessageFormatter', 'locale'=>'string', 'pattern'=>'string'], 'MessageFormatter::format' => ['false|string', 'args'=>'array'], 'MessageFormatter::formatMessage' => ['false|string', 'locale'=>'string', 'pattern'=>'string', 'args'=>'array'], 'MessageFormatter::getErrorCode' => ['int'], 'MessageFormatter::getErrorMessage' => ['string'], 'MessageFormatter::getLocale' => ['string'], 'MessageFormatter::getPattern' => ['string'], 'MessageFormatter::parse' => ['array', 'value'=>'string'], 'MessageFormatter::parseMessage' => ['array', 'locale'=>'string', 'pattern'=>'string', 'source'=>'string'], 'MessageFormatter::setPattern' => ['bool', 'pattern'=>'string'], 'metaphone' => ['string', 'text'=>'string', 'phones='=>'int'], 'method_exists' => ['bool', 'object'=>'object|string', 'method'=>'string'], 'mhash' => ['string|false', 'hash'=>'int', 'data'=>'string', 'key='=>'string'], 'mhash_count' => ['int'], 'mhash_get_block_size' => ['int|false', 'hash'=>'int'], 'mhash_get_hash_name' => ['string|false', 'hash'=>'int'], 'mhash_keygen_s2k' => ['string|false', 'hash'=>'int', 'input_password'=>'string', 'salt'=>'string', 'bytes'=>'int'], 'microtime' => ['mixed', 'get_as_float='=>'bool'], 'mime_content_type' => ['string|false', 'filename_or_stream'=>'string|resource'], 'min' => ['', '...arg1'=>'array'], 'min\'1' => ['', 'arg1'=>'', 'arg2'=>'', '...args='=>''], 'ming_keypress' => ['int', 'char'=>'string'], 'ming_setcubicthreshold' => ['void', 'threshold'=>'int'], 'ming_setscale' => ['void', 'scale'=>'float'], 'ming_setswfcompression' => ['void', 'level'=>'int'], 'ming_useconstants' => ['void', 'use'=>'int'], 'ming_useswfversion' => ['void', 'version'=>'int'], 'mkdir' => ['bool', 'pathname'=>'string', 'mode='=>'int', 'recursive='=>'bool', 'context='=>'resource'], 'mktime' => ['__benevolent<int|false>', 'hour='=>'int', 'min='=>'int', 'sec='=>'int', 'mon='=>'int', 'day='=>'int', 'year='=>'int'], 'money_format' => ['string', 'format'=>'string', 'value'=>'float'], 'Mongo::__construct' => ['void', 'server='=>'string', 'options='=>'array', 'driver_options='=>'array'], 'Mongo::__get' => ['MongoDB', 'dbname'=>'string'], 'Mongo::__toString' => ['string'], 'Mongo::close' => ['bool'], 'Mongo::connect' => ['bool'], 'Mongo::connectUtil' => ['bool'], 'Mongo::dropDB' => ['array', 'db'=>''], 'Mongo::forceError' => ['bool'], 'Mongo::getConnections' => ['array'], 'Mongo::getHosts' => ['array'], 'Mongo::getPoolSize' => ['int'], 'Mongo::getReadPreference' => ['array'], 'Mongo::getSlave' => ['string'], 'Mongo::getSlaveOkay' => ['bool'], 'Mongo::getWriteConcern' => ['array'], 'Mongo::killCursor' => ['', 'server_hash'=>'string', 'id'=>'MongoInt64|int'], 'Mongo::lastError' => ['array|null'], 'Mongo::listDBs' => ['array'], 'Mongo::pairConnect' => ['bool'], 'Mongo::pairPersistConnect' => ['bool', 'username='=>'string', 'password='=>'string'], 'Mongo::persistConnect' => ['bool', 'username='=>'string', 'password='=>'string'], 'Mongo::poolDebug' => ['array'], 'Mongo::prevError' => ['array'], 'Mongo::resetError' => ['array'], 'Mongo::selectCollection' => ['MongoCollection', 'db'=>'string', 'collection'=>'string'], 'Mongo::selectDB' => ['MongoDB', 'name'=>'string'], 'Mongo::setPoolSize' => ['bool', 'size'=>'int'], 'Mongo::setReadPreference' => ['bool', 'readPreference'=>'string', 'tags='=>'array'], 'Mongo::setSlaveOkay' => ['bool', 'ok='=>'bool'], 'Mongo::switchSlave' => ['string'], 'MongoBinData::__construct' => ['void', 'data'=>'string', 'type='=>'int'], 'MongoBinData::__toString' => ['string'], 'MongoClient::__construct' => ['void', 'server='=>'string', 'options='=>'array', 'driver_options='=>'array'], 'MongoClient::__get' => ['MongoDB', 'dbname'=>'string'], 'MongoClient::__toString' => ['string'], 'MongoClient::close' => ['bool', 'connection='=>'bool|string'], 'MongoClient::connect' => ['bool'], 'MongoClient::dropDB' => ['array', 'db'=>'mixed'], 'MongoClient::getConnections' => ['array'], 'MongoClient::getHosts' => ['array'], 'MongoClient::getReadPreference' => ['array'], 'MongoClient::getWriteConcern' => ['array'], 'MongoClient::killCursor' => ['bool', 'server_hash'=>'string', 'id'=>'int|MongoInt64'], 'MongoClient::listDBs' => ['array'], 'MongoClient::selectCollection' => ['MongoCollection', 'db'=>'string', 'collection'=>'string'], 'MongoClient::selectDB' => ['MongoDB', 'name'=>'string'], 'MongoClient::setReadPreference' => ['bool', 'read_preference'=>'string', 'tags='=>'array'], 'MongoClient::setWriteConcern' => ['bool', 'w'=>'mixed', 'wtimeout='=>'int'], 'MongoClient::switchSlave' => ['string'], 'MongoCode::__construct' => ['void', 'code'=>'string', 'scope='=>'array'], 'MongoCode::__toString' => ['string'], 'MongoCollection::__construct' => ['void', 'db'=>'MongoDB', 'name'=>'string'], 'MongoCollection::__get' => ['MongoCollection', 'name'=>'string'], 'MongoCollection::__toString' => ['string'], 'MongoCollection::aggregate' => ['array', 'op'=>'array', 'op='=>'array', '...args='=>'array'], 'MongoCollection::aggregate\'1' => ['array', 'pipeline'=>'array', 'options='=>'array'], 'MongoCollection::aggregateCursor' => ['MongoCommandCursor', 'command'=>'array', 'options='=>'array'], 'MongoCollection::batchInsert' => ['mixed', 'a'=>'array', 'options='=>'array'], 'MongoCollection::count' => ['0|positive-int', 'query='=>'array', 'limit='=>'int', 'skip='=>'int'], 'MongoCollection::createDBRef' => ['array', 'a'=>'array'], 'MongoCollection::createIndex' => ['bool', 'keys'=>'array', 'options='=>'array'], 'MongoCollection::deleteIndex' => ['array', 'keys'=>'string|array'], 'MongoCollection::deleteIndexes' => ['array'], 'MongoCollection::distinct' => ['array', 'key'=>'string', 'query='=>'array'], 'MongoCollection::drop' => ['array'], 'MongoCollection::ensureIndex' => ['bool', 'keys'=>'array', 'options='=>'array'], 'MongoCollection::find' => ['MongoCursor', 'query='=>'array', 'fields='=>'array'], 'MongoCollection::findAndModify' => ['array', 'query'=>'array', 'update='=>'array', 'fields='=>'array', 'options='=>'array'], 'MongoCollection::findOne' => ['array|null', 'query='=>'array', 'fields='=>'array'], 'MongoCollection::getDBRef' => ['array', 'ref'=>'array'], 'MongoCollection::getIndexInfo' => ['array'], 'MongoCollection::getName' => ['string'], 'MongoCollection::getReadPreference' => ['array'], 'MongoCollection::getSlaveOkay' => ['bool'], 'MongoCollection::getWriteConcern' => ['array'], 'MongoCollection::group' => ['array', 'keys'=>'mixed', 'initial'=>'array', 'reduce'=>'mongocode', 'options='=>'array'], 'MongoCollection::insert' => ['bool|array', 'a'=>'array', 'options='=>'array'], 'MongoCollection::parallelCollectionScan' => ['MongoCommandCursor[]', 'num_cursors'=>'int'], 'MongoCollection::remove' => ['bool|array', 'criteria='=>'array', 'options='=>'array'], 'MongoCollection::save' => ['mixed', 'a'=>'array|object', 'options='=>'array'], 'MongoCollection::setReadPreference' => ['bool', 'read_preference'=>'string', 'tags='=>'array'], 'MongoCollection::setSlaveOkay' => ['bool', 'ok='=>'bool'], 'MongoCollection::setWriteConcern' => ['bool', 'w'=>'mixed', 'wtimeout='=>'int'], 'MongoCollection::toIndexString' => ['string', 'keys'=>'mixed'], 'MongoCollection::update' => ['bool', 'criteria'=>'array', 'newobj'=>'array', 'options='=>'array'], 'MongoCollection::validate' => ['array', 'scan_data='=>'bool'], 'MongoCommandCursor::__construct' => ['void', 'connection'=>'MongoClient', 'ns'=>'string', 'command'=>'array'], 'MongoCommandCursor::batchSize' => ['MongoCommandCursor', 'batchSize'=>'int'], 'MongoCommandCursor::createFromDocument' => ['MongoCommandCursor', 'connection'=>'MongoClient', 'hash'=>'string', 'document'=>'array'], 'MongoCommandCursor::current' => ['array'], 'MongoCommandCursor::dead' => ['bool'], 'MongoCommandCursor::getReadPreference' => ['array'], 'MongoCommandCursor::info' => ['array'], 'MongoCommandCursor::key' => ['int'], 'MongoCommandCursor::next' => ['void'], 'MongoCommandCursor::rewind' => ['array'], 'MongoCommandCursor::setReadPreference' => ['MongoCommandCursor', 'read_preference'=>'string', 'tags='=>'array'], 'MongoCommandCursor::timeout' => ['MongoCommandCursor', 'ms'=>'int'], 'MongoCommandCursor::valid' => ['bool'], 'MongoCursor::__construct' => ['void', 'connection'=>'MongoClient', 'ns'=>'string', 'query='=>'array', 'fields='=>'array'], 'MongoCursor::addOption' => ['MongoCursor', 'key'=>'string', 'value'=>'mixed'], 'MongoCursor::awaitData' => ['MongoCursor', 'wait='=>'bool'], 'MongoCursor::batchSize' => ['MongoCursor', 'num'=>'int'], 'MongoCursor::count' => ['0|positive-int', 'foundonly='=>'bool'], 'MongoCursor::current' => ['array'], 'MongoCursor::dead' => ['bool'], 'MongoCursor::doQuery' => ['void'], 'MongoCursor::explain' => ['array'], 'MongoCursor::fields' => ['MongoCursor', 'f'=>'array'], 'MongoCursor::getNext' => ['array'], 'MongoCursor::getReadPreference' => ['array'], 'MongoCursor::hasNext' => ['bool'], 'MongoCursor::hint' => ['MongoCursor', 'key_pattern'=>'array'], 'MongoCursor::immortal' => ['MongoCursor', 'liveforever='=>'bool'], 'MongoCursor::info' => ['array'], 'MongoCursor::key' => ['string'], 'MongoCursor::limit' => ['MongoCursor', 'num'=>'int'], 'MongoCursor::maxTimeMS' => ['MongoCursor', 'ms'=>'int'], 'MongoCursor::next' => ['array'], 'MongoCursor::partial' => ['MongoCursor', 'okay='=>'bool'], 'MongoCursor::reset' => ['void'], 'MongoCursor::rewind' => ['void'], 'MongoCursor::setFlag' => ['MongoCursor', 'flag'=>'int', 'set='=>'bool'], 'MongoCursor::setReadPreference' => ['MongoCursor', 'read_preference'=>'string', 'tags='=>'array'], 'MongoCursor::skip' => ['MongoCursor', 'num'=>'int'], 'MongoCursor::slaveOkay' => ['MongoCursor', 'okay='=>'bool'], 'MongoCursor::snapshot' => ['MongoCursor'], 'MongoCursor::sort' => ['MongoCursor', 'fields'=>'array'], 'MongoCursor::tailable' => ['MongoCursor', 'tail='=>'bool'], 'MongoCursor::timeout' => ['MongoCursor', 'ms'=>'int'], 'MongoCursor::valid' => ['bool'], 'MongoCursorException::__clone' => ['void'], 'MongoCursorException::__construct' => ['void', 'message='=>'string', 'code='=>'int', 'previous='=>'(?Exception)|(?Throwable)'], 'MongoCursorException::__toString' => ['string'], 'MongoCursorException::__wakeup' => ['void'], 'MongoCursorException::getCode' => ['int'], 'MongoCursorException::getFile' => ['string'], 'MongoCursorException::getHost' => ['string'], 'MongoCursorException::getLine' => ['int'], 'MongoCursorException::getMessage' => ['string'], 'MongoCursorException::getPrevious' => ['Exception|Throwable'], 'MongoCursorException::getTrace' => ['list<array{function:string,line?:int,file?:string,class?:class-string,type?:\'::\'|\'->\',args?:mixed[],object?:object}>'], 'MongoCursorException::getTraceAsString' => ['string'], 'MongoCursorInterface::__construct' => ['void'], 'MongoCursorInterface::batchSize' => ['MongoCursorInterface', 'batchSize'=>'int'], 'MongoCursorInterface::current' => ['mixed'], 'MongoCursorInterface::dead' => ['bool'], 'MongoCursorInterface::getReadPreference' => ['array'], 'MongoCursorInterface::info' => ['array'], 'MongoCursorInterface::key' => ['int|string'], 'MongoCursorInterface::next' => ['void'], 'MongoCursorInterface::rewind' => ['void'], 'MongoCursorInterface::setReadPreference' => ['MongoCursorInterface', 'read_preference'=>'string', 'tags='=>'array'], 'MongoCursorInterface::timeout' => ['MongoCursorInterface', 'ms'=>'int'], 'MongoCursorInterface::valid' => ['bool'], 'MongoDate::__construct' => ['void', 'sec='=>'int', 'usec='=>'int'], 'MongoDate::__toString' => ['string'], 'MongoDate::toDateTime' => ['DateTime'], 'MongoDB::__construct' => ['void', 'conn'=>'MongoClient', 'name'=>'string'], 'MongoDB::__get' => ['MongoCollection', 'name'=>'string'], 'MongoDB::__toString' => ['string'], 'MongoDB::authenticate' => ['array', 'username'=>'string', 'password'=>'string'], 'MongoDB::command' => ['array', 'command'=>'array'], 'MongoDB::createCollection' => ['MongoCollection', 'name'=>'string', 'capped='=>'bool', 'size='=>'int', 'max='=>'int'], 'MongoDB::createDBRef' => ['array', 'collection'=>'string', 'a'=>''], 'MongoDB::drop' => ['array'], 'MongoDB::dropCollection' => ['array', 'coll'=>''], 'MongoDB::execute' => ['array', 'code'=>'', 'args='=>'array'], 'MongoDB::forceError' => ['bool'], 'MongoDB::getCollectionInfo' => ['array', 'options='=>'array'], 'MongoDB::getCollectionNames' => ['array', 'options='=>'array'], 'MongoDB::getDBRef' => ['array', 'ref'=>'array'], 'MongoDB::getGridFS' => ['MongoGridFS', 'prefix='=>'string'], 'MongoDB::getProfilingLevel' => ['int'], 'MongoDB::getReadPreference' => ['array'], 'MongoDB::getSlaveOkay' => ['bool'], 'MongoDB::getWriteConcern' => ['array'], 'MongoDB::lastError' => ['array'], 'MongoDB::listCollections' => ['array'], 'MongoDB::prevError' => ['array'], 'MongoDB::repair' => ['array', 'preserve_cloned_files='=>'bool', 'backup_original_files='=>'bool'], 'MongoDB::resetError' => ['array'], 'MongoDB::selectCollection' => ['MongoCollection', 'name'=>'string'], 'MongoDB::setProfilingLevel' => ['int', 'level'=>'int'], 'MongoDB::setReadPreference' => ['bool', 'read_preference'=>'string', 'tags='=>'array'], 'MongoDB::setSlaveOkay' => ['bool', 'ok='=>'bool'], 'MongoDB::setWriteConcern' => ['bool', 'w'=>'mixed', 'wtimeout='=>'int'], 'MongoDB\BSON\fromJSON' => ['string', 'json'=>'string'], 'MongoDB\BSON\fromPHP' => ['string', 'value'=>'object|array'], 'MongoDB\BSON\toCanonicalExtendedJSON' => ['string', 'bson'=>'string'], 'MongoDB\BSON\toJSON' => ['string', 'bson'=>'string'], 'MongoDB\BSON\toPHP' => ['object|array', 'bson'=>'string', 'typemap='=>'?array'], 'MongoDB\BSON\toRelaxedExtendedJSON' => ['string', 'bson'=>'string'], 'MongoDB\Driver\Monitoring\addSubscriber' => ['void', 'subscriber'=>'MongoDB\Driver\Monitoring\Subscriber'], 'MongoDB\Driver\Monitoring\removeSubscriber' => ['void', 'subscriber'=>'MongoDB\Driver\Monitoring\Subscriber'], 'MongoDB\BSON\Binary::__construct' => ['void', 'data'=>'string', 'type='=>'int'], 'MongoDB\BSON\Binary::getData' => ['string'], 'MongoDB\BSON\Binary::getType' => ['int'], 'MongoDB\BSON\Binary::__toString' => ['string'], 'MongoDB\BSON\Binary::serialize' => ['string'], 'MongoDB\BSON\Binary::unserialize' => ['void', 'data'=>'string'], 'MongoDB\BSON\Binary::jsonSerialize' => ['mixed'], 'MongoDB\BSON\BinaryInterface::getData' => ['string'], 'MongoDB\BSON\BinaryInterface::getType' => ['int'], 'MongoDB\BSON\BinaryInterface::__toString' => ['string'], 'MongoDB\BSON\DBPointer::__toString' => ['string'], 'MongoDB\BSON\DBPointer::serialize' => ['string'], 'MongoDB\BSON\DBPointer::unserialize' => ['void', 'data'=>'string'], 'MongoDB\BSON\DBPointer::jsonSerialize' => ['mixed'], 'MongoDB\BSON\Decimal128::__construct' => ['void', 'value'=>'string'], 'MongoDB\BSON\Decimal128::__toString' => ['string'], 'MongoDB\BSON\Decimal128::serialize' => ['string'], 'MongoDB\BSON\Decimal128::unserialize' => ['void', 'data'=>'string'], 'MongoDB\BSON\Decimal128::jsonSerialize' => ['mixed'], 'MongoDB\BSON\Decimal128Interface::__toString' => ['string'], 'MongoDB\BSON\Document::fromBSON' => ['MongoDB\BSON\Document', 'bson'=>'string'], 'MongoDB\BSON\Document::fromJSON' => ['MongoDB\BSON\Document', 'json'=>'string'], 'MongoDB\BSON\Document::fromPHP' => ['MongoDB\BSON\Document', 'value'=>'object|array'], 'MongoDB\BSON\Document::get' => ['mixed', 'key'=>'string'], 'MongoDB\BSON\Document::getIterator' => ['MongoDB\BSON\Iterator'], 'MongoDB\BSON\Document::has' => ['bool', 'key'=>'string'], 'MongoDB\BSON\Document::toPHP' => ['object|array', 'typeMap='=>'?array'], 'MongoDB\BSON\Document::toCanonicalExtendedJSON' => ['string'], 'MongoDB\BSON\Document::toRelaxedExtendedJSON' => ['string'], 'MongoDB\BSON\Document::offsetExists' => ['bool', 'offset'=>'mixed'], 'MongoDB\BSON\Document::offsetGet' => ['mixed', 'offset'=>'mixed'], 'MongoDB\BSON\Document::offsetSet' => ['void', 'offset'=>'mixed', 'value'=>'mixed'], 'MongoDB\BSON\Document::offsetUnset' => ['void', 'offset'=>'mixed'], 'MongoDB\BSON\Document::__toString' => ['string'], 'MongoDB\BSON\Document::serialize' => ['string'], 'MongoDB\BSON\Document::unserialize' => ['void', 'data'=>'string'], 'MongoDB\BSON\Int64::__construct' => ['void', 'value'=>'string|int'], 'MongoDB\BSON\Int64::__toString' => ['string'], 'MongoDB\BSON\Int64::serialize' => ['string'], 'MongoDB\BSON\Int64::unserialize' => ['void', 'data'=>'string'], 'MongoDB\BSON\Int64::jsonSerialize' => ['mixed'], 'MongoDB\BSON\Iterator::current' => ['mixed'], 'MongoDB\BSON\Iterator::key' => ['string|int'], 'MongoDB\BSON\Iterator::next' => ['void'], 'MongoDB\BSON\Iterator::rewind' => ['void'], 'MongoDB\BSON\Iterator::valid' => ['bool'], 'MongoDB\BSON\Javascript::__construct' => ['void', 'code'=>'string', 'scope='=>'object|array|null'], 'MongoDB\BSON\Javascript::getCode' => ['string'], 'MongoDB\BSON\Javascript::getScope' => ['?object'], 'MongoDB\BSON\Javascript::__toString' => ['string'], 'MongoDB\BSON\Javascript::serialize' => ['string'], 'MongoDB\BSON\Javascript::unserialize' => ['void', 'data'=>'string'], 'MongoDB\BSON\Javascript::jsonSerialize' => ['mixed'], 'MongoDB\BSON\JavascriptInterface::getCode' => ['string'], 'MongoDB\BSON\JavascriptInterface::getScope' => ['?object'], 'MongoDB\BSON\JavascriptInterface::__toString' => ['string'], 'MongoDB\BSON\MaxKey::serialize' => ['string'], 'MongoDB\BSON\MaxKey::unserialize' => ['void', 'data'=>'string'], 'MongoDB\BSON\MaxKey::jsonSerialize' => ['mixed'], 'MongoDB\BSON\MinKey::serialize' => ['string'], 'MongoDB\BSON\MinKey::unserialize' => ['void', 'data'=>'string'], 'MongoDB\BSON\MinKey::jsonSerialize' => ['mixed'], 'MongoDB\BSON\ObjectId::__construct' => ['void', 'id='=>'?string'], 'MongoDB\BSON\ObjectId::getTimestamp' => ['int'], 'MongoDB\BSON\ObjectId::__toString' => ['string'], 'MongoDB\BSON\ObjectId::serialize' => ['string'], 'MongoDB\BSON\ObjectId::unserialize' => ['void', 'data'=>'string'], 'MongoDB\BSON\ObjectId::jsonSerialize' => ['mixed'], 'MongoDB\BSON\ObjectIdInterface::getTimestamp' => ['int'], 'MongoDB\BSON\ObjectIdInterface::__toString' => ['string'], 'MongoDB\BSON\PackedArray::fromPHP' => ['MongoDB\BSON\PackedArray', 'value'=>'array'], 'MongoDB\BSON\PackedArray::get' => ['mixed', 'index'=>'int'], 'MongoDB\BSON\PackedArray::getIterator' => ['MongoDB\BSON\Iterator'], 'MongoDB\BSON\PackedArray::has' => ['bool', 'index'=>'int'], 'MongoDB\BSON\PackedArray::toPHP' => ['object|array', 'typeMap='=>'?array'], 'MongoDB\BSON\PackedArray::offsetExists' => ['bool', 'offset'=>'mixed'], 'MongoDB\BSON\PackedArray::offsetGet' => ['mixed', 'offset'=>'mixed'], 'MongoDB\BSON\PackedArray::offsetSet' => ['void', 'offset'=>'mixed', 'value'=>'mixed'], 'MongoDB\BSON\PackedArray::offsetUnset' => ['void', 'offset'=>'mixed'], 'MongoDB\BSON\PackedArray::__toString' => ['string'], 'MongoDB\BSON\PackedArray::serialize' => ['string'], 'MongoDB\BSON\PackedArray::unserialize' => ['void', 'data'=>'string'], 'MongoDB\BSON\Persistable::bsonSerialize' => ['stdClass|MongoDB\BSON\Document|array'], 'MongoDB\BSON\Regex::__construct' => ['void', 'pattern'=>'string', 'flags='=>'string'], 'MongoDB\BSON\Regex::getPattern' => ['string'], 'MongoDB\BSON\Regex::getFlags' => ['string'], 'MongoDB\BSON\Regex::__toString' => ['string'], 'MongoDB\BSON\Regex::serialize' => ['string'], 'MongoDB\BSON\Regex::unserialize' => ['void', 'data'=>'string'], 'MongoDB\BSON\Regex::jsonSerialize' => ['mixed'], 'MongoDB\BSON\RegexInterface::getPattern' => ['string'], 'MongoDB\BSON\RegexInterface::getFlags' => ['string'], 'MongoDB\BSON\RegexInterface::__toString' => ['string'], 'MongoDB\BSON\Serializable::bsonSerialize' => ['stdClass|MongoDB\BSON\Document|MongoDB\BSON\PackedArray|array'], 'MongoDB\BSON\Symbol::__toString' => ['string'], 'MongoDB\BSON\Symbol::serialize' => ['string'], 'MongoDB\BSON\Symbol::unserialize' => ['void', 'data'=>'string'], 'MongoDB\BSON\Symbol::jsonSerialize' => ['mixed'], 'MongoDB\BSON\Timestamp::__construct' => ['void', 'increment'=>'string|int', 'timestamp'=>'string|int'], 'MongoDB\BSON\Timestamp::getTimestamp' => ['int'], 'MongoDB\BSON\Timestamp::getIncrement' => ['int'], 'MongoDB\BSON\Timestamp::__toString' => ['string'], 'MongoDB\BSON\Timestamp::serialize' => ['string'], 'MongoDB\BSON\Timestamp::unserialize' => ['void', 'data'=>'string'], 'MongoDB\BSON\Timestamp::jsonSerialize' => ['mixed'], 'MongoDB\BSON\TimestampInterface::getTimestamp' => ['int'], 'MongoDB\BSON\TimestampInterface::getIncrement' => ['int'], 'MongoDB\BSON\TimestampInterface::__toString' => ['string'], 'MongoDB\BSON\UTCDateTime::__construct' => ['void', 'milliseconds='=>'DateTimeInterface|string|int|float|null'], 'MongoDB\BSON\UTCDateTime::toDateTime' => ['DateTime'], 'MongoDB\BSON\UTCDateTime::__toString' => ['string'], 'MongoDB\BSON\UTCDateTime::serialize' => ['string'], 'MongoDB\BSON\UTCDateTime::unserialize' => ['void', 'data'=>'string'], 'MongoDB\BSON\UTCDateTime::jsonSerialize' => ['mixed'], 'MongoDB\BSON\UTCDateTimeInterface::toDateTime' => ['DateTime'], 'MongoDB\BSON\UTCDateTimeInterface::__toString' => ['string'], 'MongoDB\BSON\Undefined::__toString' => ['string'], 'MongoDB\BSON\Undefined::serialize' => ['string'], 'MongoDB\BSON\Undefined::unserialize' => ['void', 'data'=>'string'], 'MongoDB\BSON\Undefined::jsonSerialize' => ['mixed'], 'MongoDB\BSON\Unserializable::bsonUnserialize' => ['void', 'data'=>'array'], 'MongoDB\Driver\BulkWrite::__construct' => ['void', 'options='=>'?array'], 'MongoDB\Driver\BulkWrite::count' => ['int'], 'MongoDB\Driver\BulkWrite::delete' => ['void', 'filter'=>'object|array', 'deleteOptions='=>'?array'], 'MongoDB\Driver\BulkWrite::insert' => ['mixed', 'document'=>'object|array'], 'MongoDB\Driver\BulkWrite::update' => ['void', 'filter'=>'object|array', 'newObj'=>'object|array', 'updateOptions='=>'?array'], 'MongoDB\Driver\ClientEncryption::__construct' => ['void', 'options'=>'array'], 'MongoDB\Driver\ClientEncryption::addKeyAltName' => ['?object', 'keyId'=>'MongoDB\BSON\Binary', 'keyAltName'=>'string'], 'MongoDB\Driver\ClientEncryption::createDataKey' => ['MongoDB\BSON\Binary', 'kmsProvider'=>'string', 'options='=>'?array'], 'MongoDB\Driver\ClientEncryption::decrypt' => ['mixed', 'value'=>'MongoDB\BSON\Binary'], 'MongoDB\Driver\ClientEncryption::deleteKey' => ['object', 'keyId'=>'MongoDB\BSON\Binary'], 'MongoDB\Driver\ClientEncryption::encrypt' => ['MongoDB\BSON\Binary', 'value'=>'mixed', 'options='=>'?array'], 'MongoDB\Driver\ClientEncryption::encryptExpression' => ['object', 'expr'=>'object|array', 'options='=>'?array'], 'MongoDB\Driver\ClientEncryption::getKey' => ['?object', 'keyId'=>'MongoDB\BSON\Binary'], 'MongoDB\Driver\ClientEncryption::getKeyByAltName' => ['?object', 'keyAltName'=>'string'], 'MongoDB\Driver\ClientEncryption::getKeys' => ['MongoDB\Driver\Cursor'], 'MongoDB\Driver\ClientEncryption::removeKeyAltName' => ['?object', 'keyId'=>'MongoDB\BSON\Binary', 'keyAltName'=>'string'], 'MongoDB\Driver\ClientEncryption::rewrapManyDataKey' => ['object', 'filter'=>'object|array', 'options='=>'?array'], 'MongoDB\Driver\Command::__construct' => ['void', 'document'=>'object|array', 'commandOptions='=>'?array'], 'MongoDB\Driver\Cursor::current' => ['object|array|null'], 'MongoDB\Driver\Cursor::getId' => ['MongoDB\Driver\CursorId'], 'MongoDB\Driver\Cursor::getServer' => ['MongoDB\Driver\Server'], 'MongoDB\Driver\Cursor::isDead' => ['bool'], 'MongoDB\Driver\Cursor::key' => ['?int'], 'MongoDB\Driver\Cursor::next' => ['void'], 'MongoDB\Driver\Cursor::rewind' => ['void'], 'MongoDB\Driver\Cursor::setTypeMap' => ['void', 'typemap'=>'array'], 'MongoDB\Driver\Cursor::toArray' => ['array'], 'MongoDB\Driver\Cursor::valid' => ['bool'], 'MongoDB\Driver\CursorId::__toString' => ['string'], 'MongoDB\Driver\CursorId::serialize' => ['string'], 'MongoDB\Driver\CursorId::unserialize' => ['void', 'data'=>'string'], 'MongoDB\Driver\CursorInterface::getId' => ['MongoDB\Driver\CursorId'], 'MongoDB\Driver\CursorInterface::getServer' => ['MongoDB\Driver\Server'], 'MongoDB\Driver\CursorInterface::isDead' => ['bool'], 'MongoDB\Driver\CursorInterface::setTypeMap' => ['void', 'typemap'=>'array'], 'MongoDB\Driver\CursorInterface::toArray' => ['array'], 'MongoDB\Driver\Exception\AuthenticationException::__toString' => ['string'], 'MongoDB\Driver\Exception\BulkWriteException::__toString' => ['string'], 'MongoDB\Driver\Exception\CommandException::getResultDocument' => ['object'], 'MongoDB\Driver\Exception\CommandException::__toString' => ['string'], 'MongoDB\Driver\Exception\ConnectionException::__toString' => ['string'], 'MongoDB\Driver\Exception\ConnectionTimeoutException::__toString' => ['string'], 'MongoDB\Driver\Exception\EncryptionException::__toString' => ['string'], 'MongoDB\Driver\Exception\Exception::__toString' => ['string'], 'MongoDB\Driver\Exception\ExecutionTimeoutException::__toString' => ['string'], 'MongoDB\Driver\Exception\InvalidArgumentException::__toString' => ['string'], 'MongoDB\Driver\Exception\LogicException::__toString' => ['string'], 'MongoDB\Driver\Exception\RuntimeException::hasErrorLabel' => ['bool', 'errorLabel'=>'string'], 'MongoDB\Driver\Exception\RuntimeException::__toString' => ['string'], 'MongoDB\Driver\Exception\SSLConnectionException::__toString' => ['string'], 'MongoDB\Driver\Exception\ServerException::__toString' => ['string'], 'MongoDB\Driver\Exception\UnexpectedValueException::__toString' => ['string'], 'MongoDB\Driver\Exception\WriteException::getWriteResult' => ['MongoDB\Driver\WriteResult'], 'MongoDB\Driver\Exception\WriteException::__toString' => ['string'], 'MongoDB\Driver\Manager::__construct' => ['void', 'uri='=>'?string', 'uriOptions='=>'?array', 'driverOptions='=>'?array'], 'MongoDB\Driver\Manager::addSubscriber' => ['void', 'subscriber'=>'MongoDB\Driver\Monitoring\Subscriber'], 'MongoDB\Driver\Manager::createClientEncryption' => ['MongoDB\Driver\ClientEncryption', 'options'=>'array'], 'MongoDB\Driver\Manager::executeBulkWrite' => ['MongoDB\Driver\WriteResult', 'namespace'=>'string', 'bulk'=>'MongoDB\Driver\BulkWrite', 'options='=>'MongoDB\Driver\WriteConcern|array|null'], 'MongoDB\Driver\Manager::executeCommand' => ['MongoDB\Driver\Cursor', 'db'=>'string', 'command'=>'MongoDB\Driver\Command', 'options='=>'MongoDB\Driver\ReadPreference|array|null'], 'MongoDB\Driver\Manager::executeQuery' => ['MongoDB\Driver\Cursor', 'namespace'=>'string', 'query'=>'MongoDB\Driver\Query', 'options='=>'MongoDB\Driver\ReadPreference|array|null'], 'MongoDB\Driver\Manager::executeReadCommand' => ['MongoDB\Driver\Cursor', 'db'=>'string', 'command'=>'MongoDB\Driver\Command', 'options='=>'?array'], 'MongoDB\Driver\Manager::executeReadWriteCommand' => ['MongoDB\Driver\Cursor', 'db'=>'string', 'command'=>'MongoDB\Driver\Command', 'options='=>'?array'], 'MongoDB\Driver\Manager::executeWriteCommand' => ['MongoDB\Driver\Cursor', 'db'=>'string', 'command'=>'MongoDB\Driver\Command', 'options='=>'?array'], 'MongoDB\Driver\Manager::getEncryptedFieldsMap' => ['object|array|null'], 'MongoDB\Driver\Manager::getReadConcern' => ['MongoDB\Driver\ReadConcern'], 'MongoDB\Driver\Manager::getReadPreference' => ['MongoDB\Driver\ReadPreference'], 'MongoDB\Driver\Manager::getServers' => ['array'], 'MongoDB\Driver\Manager::getWriteConcern' => ['MongoDB\Driver\WriteConcern'], 'MongoDB\Driver\Manager::removeSubscriber' => ['void', 'subscriber'=>'MongoDB\Driver\Monitoring\Subscriber'], 'MongoDB\Driver\Manager::selectServer' => ['MongoDB\Driver\Server', 'readPreference='=>'?MongoDB\Driver\ReadPreference'], 'MongoDB\Driver\Manager::startSession' => ['MongoDB\Driver\Session', 'options='=>'?array'], 'MongoDB\Driver\Monitoring\CommandFailedEvent::getCommandName' => ['string'], 'MongoDB\Driver\Monitoring\CommandFailedEvent::getDurationMicros' => ['int'], 'MongoDB\Driver\Monitoring\CommandFailedEvent::getError' => ['Exception'], 'MongoDB\Driver\Monitoring\CommandFailedEvent::getOperationId' => ['string'], 'MongoDB\Driver\Monitoring\CommandFailedEvent::getReply' => ['object'], 'MongoDB\Driver\Monitoring\CommandFailedEvent::getRequestId' => ['string'], 'MongoDB\Driver\Monitoring\CommandFailedEvent::getServer' => ['MongoDB\Driver\Server'], 'MongoDB\Driver\Monitoring\CommandFailedEvent::getServiceId' => ['?MongoDB\BSON\ObjectId'], 'MongoDB\Driver\Monitoring\CommandFailedEvent::getServerConnectionId' => ['?int'], 'MongoDB\Driver\Monitoring\CommandStartedEvent::getCommand' => ['object'], 'MongoDB\Driver\Monitoring\CommandStartedEvent::getCommandName' => ['string'], 'MongoDB\Driver\Monitoring\CommandStartedEvent::getDatabaseName' => ['string'], 'MongoDB\Driver\Monitoring\CommandStartedEvent::getOperationId' => ['string'], 'MongoDB\Driver\Monitoring\CommandStartedEvent::getRequestId' => ['string'], 'MongoDB\Driver\Monitoring\CommandStartedEvent::getServer' => ['MongoDB\Driver\Server'], 'MongoDB\Driver\Monitoring\CommandStartedEvent::getServiceId' => ['?MongoDB\BSON\ObjectId'], 'MongoDB\Driver\Monitoring\CommandStartedEvent::getServerConnectionId' => ['?int'], 'MongoDB\Driver\Monitoring\CommandSubscriber::commandStarted' => ['void', 'event'=>'MongoDB\Driver\Monitoring\CommandStartedEvent'], 'MongoDB\Driver\Monitoring\CommandSubscriber::commandSucceeded' => ['void', 'event'=>'MongoDB\Driver\Monitoring\CommandSucceededEvent'], 'MongoDB\Driver\Monitoring\CommandSubscriber::commandFailed' => ['void', 'event'=>'MongoDB\Driver\Monitoring\CommandFailedEvent'], 'MongoDB\Driver\Monitoring\CommandSucceededEvent::getCommandName' => ['string'], 'MongoDB\Driver\Monitoring\CommandSucceededEvent::getDurationMicros' => ['int'], 'MongoDB\Driver\Monitoring\CommandSucceededEvent::getOperationId' => ['string'], 'MongoDB\Driver\Monitoring\CommandSucceededEvent::getReply' => ['object'], 'MongoDB\Driver\Monitoring\CommandSucceededEvent::getRequestId' => ['string'], 'MongoDB\Driver\Monitoring\CommandSucceededEvent::getServer' => ['MongoDB\Driver\Server'], 'MongoDB\Driver\Monitoring\CommandSucceededEvent::getServiceId' => ['?MongoDB\BSON\ObjectId'], 'MongoDB\Driver\Monitoring\CommandSucceededEvent::getServerConnectionId' => ['?int'], 'MongoDB\Driver\Monitoring\LogSubscriber::log' => ['void', 'level'=>'int', 'domain'=>'string', 'message'=>'string'], 'MongoDB\Driver\Monitoring\SDAMSubscriber::serverChanged' => ['void', 'event'=>'MongoDB\Driver\Monitoring\ServerChangedEvent'], 'MongoDB\Driver\Monitoring\SDAMSubscriber::serverClosed' => ['void', 'event'=>'MongoDB\Driver\Monitoring\ServerClosedEvent'], 'MongoDB\Driver\Monitoring\SDAMSubscriber::serverOpening' => ['void', 'event'=>'MongoDB\Driver\Monitoring\ServerOpeningEvent'], 'MongoDB\Driver\Monitoring\SDAMSubscriber::serverHeartbeatFailed' => ['void', 'event'=>'MongoDB\Driver\Monitoring\ServerHeartbeatFailedEvent'], 'MongoDB\Driver\Monitoring\SDAMSubscriber::serverHeartbeatStarted' => ['void', 'event'=>'MongoDB\Driver\Monitoring\ServerHeartbeatStartedEvent'], 'MongoDB\Driver\Monitoring\SDAMSubscriber::serverHeartbeatSucceeded' => ['void', 'event'=>'MongoDB\Driver\Monitoring\ServerHeartbeatSucceededEvent'], 'MongoDB\Driver\Monitoring\SDAMSubscriber::topologyChanged' => ['void', 'event'=>'MongoDB\Driver\Monitoring\TopologyChangedEvent'], 'MongoDB\Driver\Monitoring\SDAMSubscriber::topologyClosed' => ['void', 'event'=>'MongoDB\Driver\Monitoring\TopologyClosedEvent'], 'MongoDB\Driver\Monitoring\SDAMSubscriber::topologyOpening' => ['void', 'event'=>'MongoDB\Driver\Monitoring\TopologyOpeningEvent'], 'MongoDB\Driver\Monitoring\ServerChangedEvent::getPort' => ['int'], 'MongoDB\Driver\Monitoring\ServerChangedEvent::getHost' => ['string'], 'MongoDB\Driver\Monitoring\ServerChangedEvent::getNewDescription' => ['MongoDB\Driver\ServerDescription'], 'MongoDB\Driver\Monitoring\ServerChangedEvent::getPreviousDescription' => ['MongoDB\Driver\ServerDescription'], 'MongoDB\Driver\Monitoring\ServerChangedEvent::getTopologyId' => ['MongoDB\BSON\ObjectId'], 'MongoDB\Driver\Monitoring\ServerClosedEvent::getPort' => ['int'], 'MongoDB\Driver\Monitoring\ServerClosedEvent::getHost' => ['string'], 'MongoDB\Driver\Monitoring\ServerClosedEvent::getTopologyId' => ['MongoDB\BSON\ObjectId'], 'MongoDB\Driver\Monitoring\ServerHeartbeatFailedEvent::getDurationMicros' => ['int'], 'MongoDB\Driver\Monitoring\ServerHeartbeatFailedEvent::getError' => ['Exception'], 'MongoDB\Driver\Monitoring\ServerHeartbeatFailedEvent::getPort' => ['int'], 'MongoDB\Driver\Monitoring\ServerHeartbeatFailedEvent::getHost' => ['string'], 'MongoDB\Driver\Monitoring\ServerHeartbeatFailedEvent::isAwaited' => ['bool'], 'MongoDB\Driver\Monitoring\ServerHeartbeatStartedEvent::getPort' => ['int'], 'MongoDB\Driver\Monitoring\ServerHeartbeatStartedEvent::getHost' => ['string'], 'MongoDB\Driver\Monitoring\ServerHeartbeatStartedEvent::isAwaited' => ['bool'], 'MongoDB\Driver\Monitoring\ServerHeartbeatSucceededEvent::getDurationMicros' => ['int'], 'MongoDB\Driver\Monitoring\ServerHeartbeatSucceededEvent::getReply' => ['object'], 'MongoDB\Driver\Monitoring\ServerHeartbeatSucceededEvent::getPort' => ['int'], 'MongoDB\Driver\Monitoring\ServerHeartbeatSucceededEvent::getHost' => ['string'], 'MongoDB\Driver\Monitoring\ServerHeartbeatSucceededEvent::isAwaited' => ['bool'], 'MongoDB\Driver\Monitoring\ServerOpeningEvent::getPort' => ['int'], 'MongoDB\Driver\Monitoring\ServerOpeningEvent::getHost' => ['string'], 'MongoDB\Driver\Monitoring\ServerOpeningEvent::getTopologyId' => ['MongoDB\BSON\ObjectId'], 'MongoDB\Driver\Monitoring\TopologyChangedEvent::getNewDescription' => ['MongoDB\Driver\TopologyDescription'], 'MongoDB\Driver\Monitoring\TopologyChangedEvent::getPreviousDescription' => ['MongoDB\Driver\TopologyDescription'], 'MongoDB\Driver\Monitoring\TopologyChangedEvent::getTopologyId' => ['MongoDB\BSON\ObjectId'], 'MongoDB\Driver\Monitoring\TopologyClosedEvent::getTopologyId' => ['MongoDB\BSON\ObjectId'], 'MongoDB\Driver\Monitoring\TopologyOpeningEvent::getTopologyId' => ['MongoDB\BSON\ObjectId'], 'MongoDB\Driver\Query::__construct' => ['void', 'filter'=>'object|array', 'queryOptions='=>'?array'], 'MongoDB\Driver\ReadConcern::__construct' => ['void', 'level='=>'?string'], 'MongoDB\Driver\ReadConcern::getLevel' => ['?string'], 'MongoDB\Driver\ReadConcern::isDefault' => ['bool'], 'MongoDB\Driver\ReadConcern::bsonSerialize' => ['stdClass'], 'MongoDB\Driver\ReadConcern::serialize' => ['string'], 'MongoDB\Driver\ReadConcern::unserialize' => ['void', 'data'=>'string'], 'MongoDB\Driver\ReadPreference::__construct' => ['void', 'mode'=>'string|int', 'tagSets='=>'?array', 'options='=>'?array'], 'MongoDB\Driver\ReadPreference::getHedge' => ['?object'], 'MongoDB\Driver\ReadPreference::getMaxStalenessSeconds' => ['int'], 'MongoDB\Driver\ReadPreference::getMode' => ['int'], 'MongoDB\Driver\ReadPreference::getModeString' => ['string'], 'MongoDB\Driver\ReadPreference::getTagSets' => ['array'], 'MongoDB\Driver\ReadPreference::bsonSerialize' => ['stdClass'], 'MongoDB\Driver\ReadPreference::serialize' => ['string'], 'MongoDB\Driver\ReadPreference::unserialize' => ['void', 'data'=>'string'], 'MongoDB\Driver\Server::executeBulkWrite' => ['MongoDB\Driver\WriteResult', 'namespace'=>'string', 'bulkWrite'=>'MongoDB\Driver\BulkWrite', 'options='=>'MongoDB\Driver\WriteConcern|array|null'], 'MongoDB\Driver\Server::executeCommand' => ['MongoDB\Driver\Cursor', 'db'=>'string', 'command'=>'MongoDB\Driver\Command', 'options='=>'MongoDB\Driver\ReadPreference|array|null'], 'MongoDB\Driver\Server::executeQuery' => ['MongoDB\Driver\Cursor', 'namespace'=>'string', 'query'=>'MongoDB\Driver\Query', 'options='=>'MongoDB\Driver\ReadPreference|array|null'], 'MongoDB\Driver\Server::executeReadCommand' => ['MongoDB\Driver\Cursor', 'db'=>'string', 'command'=>'MongoDB\Driver\Command', 'options='=>'?array'], 'MongoDB\Driver\Server::executeReadWriteCommand' => ['MongoDB\Driver\Cursor', 'db'=>'string', 'command'=>'MongoDB\Driver\Command', 'options='=>'?array'], 'MongoDB\Driver\Server::executeWriteCommand' => ['MongoDB\Driver\Cursor', 'db'=>'string', 'command'=>'MongoDB\Driver\Command', 'options='=>'?array'], 'MongoDB\Driver\Server::getHost' => ['string'], 'MongoDB\Driver\Server::getInfo' => ['array'], 'MongoDB\Driver\Server::getLatency' => ['?int'], 'MongoDB\Driver\Server::getPort' => ['int'], 'MongoDB\Driver\Server::getServerDescription' => ['MongoDB\Driver\ServerDescription'], 'MongoDB\Driver\Server::getTags' => ['array'], 'MongoDB\Driver\Server::getType' => ['int'], 'MongoDB\Driver\Server::isArbiter' => ['bool'], 'MongoDB\Driver\Server::isHidden' => ['bool'], 'MongoDB\Driver\Server::isPassive' => ['bool'], 'MongoDB\Driver\Server::isPrimary' => ['bool'], 'MongoDB\Driver\Server::isSecondary' => ['bool'], 'MongoDB\Driver\ServerApi::__construct' => ['void', 'version'=>'string', 'strict='=>'?bool', 'deprecationErrors='=>'?bool'], 'MongoDB\Driver\ServerApi::bsonSerialize' => ['stdClass'], 'MongoDB\Driver\ServerApi::serialize' => ['string'], 'MongoDB\Driver\ServerApi::unserialize' => ['void', 'data'=>'string'], 'MongoDB\Driver\ServerDescription::getHelloResponse' => ['array'], 'MongoDB\Driver\ServerDescription::getHost' => ['string'], 'MongoDB\Driver\ServerDescription::getLastUpdateTime' => ['int'], 'MongoDB\Driver\ServerDescription::getPort' => ['int'], 'MongoDB\Driver\ServerDescription::getRoundTripTime' => ['?int'], 'MongoDB\Driver\ServerDescription::getType' => ['string'], 'MongoDB\Driver\Session::abortTransaction' => ['void'], 'MongoDB\Driver\Session::advanceClusterTime' => ['void', 'clusterTime'=>'object|array'], 'MongoDB\Driver\Session::advanceOperationTime' => ['void', 'operationTime'=>'MongoDB\BSON\TimestampInterface'], 'MongoDB\Driver\Session::commitTransaction' => ['void'], 'MongoDB\Driver\Session::endSession' => ['void'], 'MongoDB\Driver\Session::getClusterTime' => ['?object'], 'MongoDB\Driver\Session::getLogicalSessionId' => ['object'], 'MongoDB\Driver\Session::getOperationTime' => ['?MongoDB\BSON\Timestamp'], 'MongoDB\Driver\Session::getServer' => ['?MongoDB\Driver\Server'], 'MongoDB\Driver\Session::getTransactionOptions' => ['?array'], 'MongoDB\Driver\Session::getTransactionState' => ['string'], 'MongoDB\Driver\Session::isDirty' => ['bool'], 'MongoDB\Driver\Session::isInTransaction' => ['bool'], 'MongoDB\Driver\Session::startTransaction' => ['void', 'options='=>'?array'], 'MongoDB\Driver\TopologyDescription::getServers' => ['array'], 'MongoDB\Driver\TopologyDescription::getType' => ['string'], 'MongoDB\Driver\TopologyDescription::hasReadableServer' => ['bool', 'readPreference='=>'?MongoDB\Driver\ReadPreference'], 'MongoDB\Driver\TopologyDescription::hasWritableServer' => ['bool'], 'MongoDB\Driver\WriteConcern::__construct' => ['void', 'w'=>'string|int', 'wtimeout='=>'?int', 'journal='=>'?bool'], 'MongoDB\Driver\WriteConcern::getJournal' => ['?bool'], 'MongoDB\Driver\WriteConcern::getW' => ['string|int|null'], 'MongoDB\Driver\WriteConcern::getWtimeout' => ['int'], 'MongoDB\Driver\WriteConcern::isDefault' => ['bool'], 'MongoDB\Driver\WriteConcern::bsonSerialize' => ['stdClass'], 'MongoDB\Driver\WriteConcern::serialize' => ['string'], 'MongoDB\Driver\WriteConcern::unserialize' => ['void', 'data'=>'string'], 'MongoDB\Driver\WriteConcernError::getCode' => ['int'], 'MongoDB\Driver\WriteConcernError::getInfo' => ['?object'], 'MongoDB\Driver\WriteConcernError::getMessage' => ['string'], 'MongoDB\Driver\WriteError::getCode' => ['int'], 'MongoDB\Driver\WriteError::getIndex' => ['int'], 'MongoDB\Driver\WriteError::getInfo' => ['?object'], 'MongoDB\Driver\WriteError::getMessage' => ['string'], 'MongoDB\Driver\WriteResult::getInsertedCount' => ['?int'], 'MongoDB\Driver\WriteResult::getMatchedCount' => ['?int'], 'MongoDB\Driver\WriteResult::getModifiedCount' => ['?int'], 'MongoDB\Driver\WriteResult::getDeletedCount' => ['?int'], 'MongoDB\Driver\WriteResult::getUpsertedCount' => ['?int'], 'MongoDB\Driver\WriteResult::getServer' => ['MongoDB\Driver\Server'], 'MongoDB\Driver\WriteResult::getUpsertedIds' => ['array'], 'MongoDB\Driver\WriteResult::getWriteConcernError' => ['?MongoDB\Driver\WriteConcernError'], 'MongoDB\Driver\WriteResult::getWriteErrors' => ['array'], 'MongoDB\Driver\WriteResult::getErrorReplies' => ['array'], 'MongoDB\Driver\WriteResult::isAcknowledged' => ['bool'], 'MongoDBRef::create' => ['array', 'collection'=>'string', 'id'=>'mixed', 'database='=>'string'], 'MongoDBRef::get' => ['array', 'db'=>'mongodb', 'ref'=>'array'], 'MongoDBRef::isRef' => ['bool', 'ref'=>'mixed'], 'MongoDeleteBatch::__construct' => ['void', 'collection'=>'MongoCollection', 'write_options='=>'array'], 'MongoException::__clone' => ['void'], 'MongoException::__construct' => ['void', 'message='=>'string', 'code='=>'int', 'previous='=>'(?Exception)|(?Throwable)'], 'MongoException::__toString' => ['string'], 'MongoException::__wakeup' => ['void'], 'MongoException::getCode' => ['int'], 'MongoException::getFile' => ['string'], 'MongoException::getLine' => ['int'], 'MongoException::getMessage' => ['string'], 'MongoException::getPrevious' => ['Exception|Throwable'], 'MongoException::getTrace' => ['list<array{function:string,line?:int,file?:string,class?:class-string,type?:\'::\'|\'->\',args?:mixed[],object?:object}>'], 'MongoException::getTraceAsString' => ['string'], 'MongoGridFS::__construct' => ['void', 'db'=>'MongoDB', 'prefix='=>'string', 'chunks='=>'mixed'], 'MongoGridFS::__get' => ['MongoCollection', 'name'=>'string'], 'MongoGridFS::__toString' => ['string'], 'MongoGridFS::aggregate' => ['array', 'pipeline'=>'array', 'op'=>'array', 'pipelineOperators'=>'array'], 'MongoGridFS::aggregateCursor' => ['MongoCommandCursor', 'pipeline'=>'array', 'options'=>'array'], 'MongoGridFS::batchInsert' => ['mixed', 'a'=>'array', 'options='=>'array'], 'MongoGridFS::count' => ['0|positive-int', 'query='=>'stdClass|array'], 'MongoGridFS::createDBRef' => ['array', 'a'=>'array'], 'MongoGridFS::createIndex' => ['array', 'keys'=>'array', 'options='=>'array'], 'MongoGridFS::delete' => ['bool', 'id'=>'mixed'], 'MongoGridFS::deleteIndex' => ['array', 'keys'=>'array|string'], 'MongoGridFS::deleteIndexes' => ['array'], 'MongoGridFS::distinct' => ['array|bool', 'key'=>'string', 'query='=>'?array'], 'MongoGridFS::drop' => ['array'], 'MongoGridFS::ensureIndex' => ['bool', 'keys'=>'array', 'options='=>'array'], 'MongoGridFS::find' => ['MongoGridFSCursor', 'query='=>'array', 'fields='=>'array'], 'MongoGridFS::findAndModify' => ['array', 'query'=>'array', 'update='=>'?array', 'fields='=>'?array', 'options='=>'?array'], 'MongoGridFS::findOne' => ['MongoGridFSFile', 'query='=>'mixed', 'fields='=>'mixed'], 'MongoGridFS::get' => ['MongoGridFSFile', 'id'=>'mixed'], 'MongoGridFS::getDBRef' => ['array', 'ref'=>'array'], 'MongoGridFS::getIndexInfo' => ['array'], 'MongoGridFS::getName' => ['string'], 'MongoGridFS::getReadPreference' => ['array'], 'MongoGridFS::getSlaveOkay' => ['bool'], 'MongoGridFS::group' => ['array', 'keys'=>'mixed', 'initial'=>'array', 'reduce'=>'MongoCode', 'condition='=>'array'], 'MongoGridFS::insert' => ['array|bool', 'a'=>'array|object', 'options='=>'array'], 'MongoGridFS::put' => ['mixed', 'filename'=>'string', 'extra='=>'array'], 'MongoGridFS::remove' => ['bool', 'criteria='=>'array', 'options='=>'array'], 'MongoGridFS::save' => ['array|bool', 'a'=>'array|object', 'options='=>'array'], 'MongoGridFS::setReadPreference' => ['bool', 'read_preference'=>'string', 'tags'=>'array'], 'MongoGridFS::setSlaveOkay' => ['bool', 'ok='=>'bool|true'], 'MongoGridFS::storeBytes' => ['mixed', 'bytes'=>'string', 'extra='=>'array', 'options='=>'array'], 'MongoGridFS::storeFile' => ['mixed', 'filename'=>'string', 'extra='=>'array', 'options='=>'array'], 'MongoGridFS::storeUpload' => ['mixed', 'name'=>'string', 'filename='=>'string'], 'MongoGridFS::toIndexString' => ['string', 'keys'=>'mixed'], 'MongoGridFS::update' => ['bool', 'criteria'=>'array', 'newobj'=>'array', 'options='=>'array'], 'MongoGridFS::validate' => ['array', 'scan_data='=>'bool|false'], 'MongoGridFSCursor::__construct' => ['void', 'gridfs'=>'MongoGridFS', 'connection'=>'resource', 'ns'=>'string', 'query'=>'array', 'fields'=>'array'], 'MongoGridFSCursor::addOption' => ['MongoCursor', 'key'=>'string', 'value'=>'mixed'], 'MongoGridFSCursor::awaitData' => ['MongoCursor', 'wait='=>'bool|true'], 'MongoGridFSCursor::batchSize' => ['MongoCursor', 'batchSize'=>'int'], 'MongoGridFSCursor::count' => ['0|positive-int', 'all='=>'bool|false'], 'MongoGridFSCursor::current' => ['MongoGridFSFile'], 'MongoGridFSCursor::dead' => ['bool'], 'MongoGridFSCursor::doQuery' => ['void'], 'MongoGridFSCursor::explain' => ['array'], 'MongoGridFSCursor::fields' => ['MongoCursor', 'f'=>'array'], 'MongoGridFSCursor::getNext' => ['MongoGridFSFile'], 'MongoGridFSCursor::getReadPreference' => ['array'], 'MongoGridFSCursor::hasNext' => ['bool'], 'MongoGridFSCursor::hint' => ['MongoCursor', 'key_pattern'=>'mixed'], 'MongoGridFSCursor::immortal' => ['MongoCursor', 'liveForever='=>'bool|true'], 'MongoGridFSCursor::info' => ['array'], 'MongoGridFSCursor::key' => ['string'], 'MongoGridFSCursor::limit' => ['MongoCursor', 'num'=>'int'], 'MongoGridFSCursor::maxTimeMS' => ['MongoCursor', 'ms'=>'int'], 'MongoGridFSCursor::next' => ['void'], 'MongoGridFSCursor::partial' => ['MongoCursor', 'okay='=>'bool|true'], 'MongoGridFSCursor::reset' => ['void'], 'MongoGridFSCursor::rewind' => ['void'], 'MongoGridFSCursor::setFlag' => ['MongoCursor', 'flag'=>'int', 'set='=>'bool|true'], 'MongoGridFSCursor::setReadPreference' => ['MongoCursor', 'read_preference'=>'string', 'tags'=>'array'], 'MongoGridFSCursor::skip' => ['MongoCursor', 'num'=>'int'], 'MongoGridFSCursor::slaveOkay' => ['MongoCursor', 'okay='=>'bool|true'], 'MongoGridFSCursor::snapshot' => ['MongoCursor'], 'MongoGridFSCursor::sort' => ['MongoCursor', 'fields'=>'array'], 'MongoGridFSCursor::tailable' => ['MongoCursor', 'tail='=>'bool|true'], 'MongoGridFSCursor::timeout' => ['MongoCursor', 'ms'=>'int'], 'MongoGridFSCursor::valid' => ['bool'], 'MongoGridfsFile::__construct' => ['void', 'gridfs'=>'MongoGridFS', 'file'=>'array'], 'MongoGridFSFile::getBytes' => ['string'], 'MongoGridFSFile::getFilename' => ['string'], 'MongoGridFSFile::getResource' => ['resource'], 'MongoGridFSFile::getSize' => ['int'], 'MongoGridFSFile::write' => ['int', 'filename='=>'string'], 'MongoId::__construct' => ['void', 'id='=>'string|MongoId'], 'MongoId::__set_state' => ['MongoId', 'props'=>'array'], 'MongoId::__toString' => ['string'], 'MongoId::getHostname' => ['string'], 'MongoId::getInc' => ['int'], 'MongoId::getPID' => ['int'], 'MongoId::getTimestamp' => ['int'], 'MongoId::isValid' => ['bool', 'value'=>'mixed'], 'MongoInsertBatch::__construct' => ['void', 'collection'=>'MongoCollection', 'write_options='=>'array'], 'MongoInt32::__construct' => ['void', 'value'=>'string'], 'MongoInt32::__toString' => ['string'], 'MongoInt64::__construct' => ['void', 'value'=>'string'], 'MongoInt64::__toString' => ['string'], 'MongoLog::getCallback' => ['callable'], 'MongoLog::getLevel' => ['int'], 'MongoLog::getModule' => ['int'], 'MongoLog::setCallback' => ['bool', 'log_function'=>'callable'], 'MongoLog::setLevel' => ['void', 'level'=>'int'], 'MongoLog::setModule' => ['void', 'module'=>'int'], 'MongoPool::getSize' => ['int'], 'MongoPool::info' => ['array'], 'MongoPool::setSize' => ['bool', 'size'=>'int'], 'MongoRegex::__construct' => ['void', 'regex'=>'string'], 'MongoRegex::__toString' => ['string'], 'MongoResultException::__clone' => ['void'], 'MongoResultException::__construct' => ['void', 'message='=>'string', 'code='=>'int', 'previous='=>'(?Exception)|(?Throwable)'], 'MongoResultException::__toString' => ['string'], 'MongoResultException::__wakeup' => ['void'], 'MongoResultException::getCode' => ['int'], 'MongoResultException::getDocument' => ['array'], 'MongoResultException::getFile' => ['string'], 'MongoResultException::getLine' => ['int'], 'MongoResultException::getMessage' => ['string'], 'MongoResultException::getPrevious' => ['Exception|Throwable'], 'MongoResultException::getTrace' => ['list<array{function:string,line?:int,file?:string,class?:class-string,type?:\'::\'|\'->\',args?:mixed[],object?:object}>'], 'MongoResultException::getTraceAsString' => ['string'], 'MongoTimestamp::__construct' => ['void', 'sec='=>'int', 'inc='=>'int'], 'MongoTimestamp::__toString' => ['string'], 'MongoUpdateBatch::__construct' => ['void', 'collection'=>'MongoCollection', 'write_options='=>'array'], 'MongoUpdateBatch::add' => ['bool', 'item'=>'array'], 'MongoUpdateBatch::execute' => ['array', 'write_options'=>'array'], 'MongoWriteBatch::__construct' => ['void', 'collection'=>'MongoCollection', 'batch_type'=>'string', 'write_options'=>'array'], 'MongoWriteBatch::add' => ['bool', 'item'=>'array'], 'MongoWriteBatch::execute' => ['array', 'write_options'=>'array'], 'MongoWriteConcernException::__clone' => ['void'], 'MongoWriteConcernException::__construct' => ['void', 'message='=>'string', 'code='=>'int', 'previous='=>'(?Exception)|(?Throwable)'], 'MongoWriteConcernException::__toString' => ['string'], 'MongoWriteConcernException::__wakeup' => ['void'], 'MongoWriteConcernException::getCode' => ['int'], 'MongoWriteConcernException::getDocument' => ['array'], 'MongoWriteConcernException::getFile' => ['string'], 'MongoWriteConcernException::getLine' => ['int'], 'MongoWriteConcernException::getMessage' => ['string'], 'MongoWriteConcernException::getPrevious' => ['Exception|Throwable'], 'MongoWriteConcernException::getTrace' => ['list<array{function:string,line?:int,file?:string,class?:class-string,type?:\'::\'|\'->\',args?:mixed[],object?:object}>'], 'MongoWriteConcernException::getTraceAsString' => ['string'], 'monitor_custom_event' => ['void', 'class'=>'string', 'text'=>'string', 'severe='=>'int', 'user_data='=>'mixed'], 'monitor_httperror_event' => ['void', 'error_code'=>'int', 'url'=>'string', 'severe='=>'int'], 'monitor_license_info' => ['array'], 'monitor_pass_error' => ['void', 'errno'=>'int', 'errstr'=>'string', 'errfile'=>'string', 'errline'=>'int'], 'monitor_set_aggregation_hint' => ['void', 'hint'=>'string'], 'move_uploaded_file' => ['bool', 'path'=>'string', 'new_path'=>'string'], 'mqseries_back' => ['void', 'hconn'=>'resource', 'compcode'=>'resource', 'reason'=>'resource'], 'mqseries_begin' => ['void', 'hconn'=>'resource', 'beginoptions'=>'array', 'compcode'=>'resource', 'reason'=>'resource'], 'mqseries_close' => ['void', 'hconn'=>'resource', 'hobj'=>'resource', 'options'=>'int', 'compcode'=>'resource', 'reason'=>'resource'], 'mqseries_cmit' => ['void', 'hconn'=>'resource', 'compcode'=>'resource', 'reason'=>'resource'], 'mqseries_conn' => ['void', 'qmanagername'=>'string', 'hconn'=>'resource', 'compcode'=>'resource', 'reason'=>'resource'], 'mqseries_connx' => ['void', 'qmanagername'=>'string', 'connoptions'=>'array', 'hconn'=>'resource', 'compcode'=>'resource', 'reason'=>'resource'], 'mqseries_disc' => ['void', 'hconn'=>'resource', 'compcode'=>'resource', 'reason'=>'resource'], 'mqseries_get' => ['void', 'hconn'=>'resource', 'hobj'=>'resource', 'md'=>'array', 'gmo'=>'array', 'bufferlength'=>'int', 'msg'=>'string', 'data_length'=>'int', 'compcode'=>'resource', 'reason'=>'resource'], 'mqseries_inq' => ['void', 'hconn'=>'resource', 'hobj'=>'resource', 'selectorcount'=>'int', 'selectors'=>'array', 'intattrcount'=>'int', 'intattr'=>'resource', 'charattrlength'=>'int', 'charattr'=>'resource', 'compcode'=>'resource', 'reason'=>'resource'], 'mqseries_open' => ['void', 'hconn'=>'resource', 'objdesc'=>'array', 'option'=>'int', 'hobj'=>'resource', 'compcode'=>'resource', 'reason'=>'resource'], 'mqseries_put' => ['void', 'hconn'=>'resource', 'hobj'=>'resource', 'md'=>'array', 'pmo'=>'array', 'message'=>'string', 'compcode'=>'resource', 'reason'=>'resource'], 'mqseries_put1' => ['void', 'hconn'=>'resource', 'objdesc'=>'resource', 'msgdesc'=>'resource', 'pmo'=>'resource', 'buffer'=>'string', 'compcode'=>'resource', 'reason'=>'resource'], 'mqseries_set' => ['void', 'hconn'=>'resource', 'hobj'=>'resource', 'selectorcount'=>'int', 'selectors'=>'array', 'intattrcount'=>'int', 'intattrs'=>'array', 'charattrlength'=>'int', 'charattrs'=>'array', 'compcode'=>'resource', 'reason'=>'resource'], 'mqseries_strerror' => ['string', 'reason'=>'int'], 'ms_GetErrorObj' => ['errorObj'], 'ms_GetVersion' => ['string'], 'ms_GetVersionInt' => ['int'], 'ms_iogetStdoutBufferBytes' => ['int'], 'ms_iogetstdoutbufferstring' => ['void'], 'ms_ioinstallstdinfrombuffer' => ['void'], 'ms_ioinstallstdouttobuffer' => ['void'], 'ms_ioresethandlers' => ['void'], 'ms_iostripstdoutbuffercontentheaders' => ['void'], 'ms_iostripstdoutbuffercontenttype' => ['string'], 'ms_ResetErrorList' => ['void'], 'ms_TokenizeMap' => ['array', 'map_file_name'=>'string'], 'msession_connect' => ['bool', 'host'=>'string', 'port'=>'string'], 'msession_count' => ['int'], 'msession_create' => ['bool', 'session'=>'string', 'classname='=>'string', 'data='=>'string'], 'msession_destroy' => ['bool', 'name'=>'string'], 'msession_disconnect' => ['void'], 'msession_find' => ['array', 'name'=>'string', 'value'=>'string'], 'msession_get' => ['string', 'session'=>'string', 'name'=>'string', 'value'=>'string'], 'msession_get_array' => ['array', 'session'=>'string'], 'msession_get_data' => ['string', 'session'=>'string'], 'msession_inc' => ['string', 'session'=>'string', 'name'=>'string'], 'msession_list' => ['array'], 'msession_listvar' => ['array', 'name'=>'string'], 'msession_lock' => ['int', 'name'=>'string'], 'msession_plugin' => ['string', 'session'=>'string', 'val'=>'string', 'param='=>'string'], 'msession_randstr' => ['string', 'param'=>'int'], 'msession_set' => ['bool', 'session'=>'string', 'name'=>'string', 'value'=>'string'], 'msession_set_array' => ['void', 'session'=>'string', 'tuples'=>'array'], 'msession_set_data' => ['bool', 'session'=>'string', 'value'=>'string'], 'msession_timeout' => ['int', 'session'=>'string', 'param='=>'int'], 'msession_uniq' => ['string', 'param'=>'int', 'classname='=>'string', 'data='=>'string'], 'msession_unlock' => ['int', 'session'=>'string', 'key'=>'int'], 'msg_get_queue' => ['resource|false', 'key'=>'int', 'perms='=>'int'], 'msg_queue_exists' => ['bool', 'key'=>'int'], 'msg_receive' => ['bool', 'queue'=>'resource', 'desiredmsgtype'=>'int', '&w_msgtype'=>'int', 'maxsize'=>'int', '&w_message'=>'mixed', 'unserialize='=>'bool', 'flags='=>'int', '&w_errorcode='=>'int'], 'msg_remove_queue' => ['bool', 'queue'=>'resource'], 'msg_send' => ['bool', 'queue'=>'resource', 'msgtype'=>'int', 'message'=>'mixed', 'serialize='=>'bool', 'blocking='=>'bool', '&w_errorcode='=>'int'], 'msg_set_queue' => ['bool', 'queue'=>'resource', 'data'=>'array'], 'msg_stat_queue' => ['array|false', 'queue'=>'resource'], 'msgfmt_create' => ['MessageFormatter', 'locale'=>'string', 'pattern'=>'string'], 'msgfmt_format' => ['string|false', 'fmt'=>'messageformatter', 'args'=>'array'], 'msgfmt_format_message' => ['string|false', 'locale'=>'string', 'pattern'=>'string', 'args'=>'array'], 'msgfmt_get_error_code' => ['int', 'fmt'=>'messageformatter'], 'msgfmt_get_error_message' => ['string', 'fmt'=>'messageformatter'], 'msgfmt_get_locale' => ['string', 'formatter'=>'messageformatter'], 'msgfmt_get_pattern' => ['string|false', 'fmt'=>'messageformatter'], 'msgfmt_parse' => ['array|false', 'fmt'=>'messageformatter', 'value'=>'string'], 'msgfmt_parse_message' => ['array|false', 'locale'=>'string', 'pattern'=>'string', 'source'=>'string'], 'msgfmt_set_pattern' => ['bool', 'fmt'=>'messageformatter', 'pattern'=>'string'], 'msql_affected_rows' => ['int', 'result'=>'resource'], 'msql_close' => ['bool', 'link_identifier='=>'?resource'], 'msql_connect' => ['resource', 'hostname='=>'string'], 'msql_create_db' => ['bool', 'database_name'=>'string', 'link_identifier='=>'?resource'], 'msql_data_seek' => ['bool', 'result'=>'resource', 'row_number'=>'int'], 'msql_db_query' => ['resource', 'database'=>'string', 'query'=>'string', 'link_identifier='=>'?resource'], 'msql_drop_db' => ['bool', 'database_name'=>'string', 'link_identifier='=>'?resource'], 'msql_error' => ['string'], 'msql_fetch_array' => ['array', 'result'=>'resource', 'result_type='=>'int'], 'msql_fetch_field' => ['object', 'result'=>'resource', 'field_offset='=>'int'], 'msql_fetch_object' => ['object', 'result'=>'resource'], 'msql_fetch_row' => ['array', 'result'=>'resource'], 'msql_field_flags' => ['string', 'result'=>'resource', 'field_offset'=>'int'], 'msql_field_len' => ['int', 'result'=>'resource', 'field_offset'=>'int'], 'msql_field_name' => ['string', 'result'=>'resource', 'field_offset'=>'int'], 'msql_field_seek' => ['bool', 'result'=>'resource', 'field_offset'=>'int'], 'msql_field_table' => ['int', 'result'=>'resource', 'field_offset'=>'int'], 'msql_field_type' => ['string', 'result'=>'resource', 'field_offset'=>'int'], 'msql_free_result' => ['bool', 'result'=>'resource'], 'msql_list_dbs' => ['resource', 'link_identifier='=>'?resource'], 'msql_list_fields' => ['resource', 'database'=>'string', 'tablename'=>'string', 'link_identifier='=>'?resource'], 'msql_list_tables' => ['resource', 'database'=>'string', 'link_identifier='=>'?resource'], 'msql_num_fields' => ['int', 'result'=>'resource'], 'msql_num_rows' => ['int', 'query_identifier'=>'resource'], 'msql_pconnect' => ['resource', 'hostname='=>'string'], 'msql_query' => ['resource', 'query'=>'string', 'link_identifier='=>'?resource'], 'msql_result' => ['string', 'result'=>'resource', 'row'=>'int', 'field='=>'mixed'], 'msql_select_db' => ['bool', 'database_name'=>'string', 'link_identifier='=>'?resource'], 'mssql_bind' => ['bool', 'stmt'=>'resource', 'param_name'=>'string', 'var'=>'mixed', 'type'=>'int', 'is_output='=>'bool', 'is_null='=>'bool', 'maxlen='=>'int'], 'mssql_close' => ['bool', 'link_identifier='=>'resource'], 'mssql_connect' => ['resource', 'servername='=>'string', 'username='=>'string', 'password='=>'string', 'new_link='=>'bool'], 'mssql_data_seek' => ['bool', 'result_identifier'=>'resource', 'row_number'=>'int'], 'mssql_execute' => ['mixed', 'stmt'=>'resource', 'skip_results='=>'bool'], 'mssql_fetch_array' => ['array', 'result'=>'resource', 'result_type='=>'int'], 'mssql_fetch_assoc' => ['array', 'result_id'=>'resource'], 'mssql_fetch_batch' => ['int', 'result'=>'resource'], 'mssql_fetch_field' => ['object', 'result'=>'resource', 'field_offset='=>'int'], 'mssql_fetch_object' => ['object', 'result'=>'resource'], 'mssql_fetch_row' => ['array', 'result'=>'resource'], 'mssql_field_length' => ['int', 'result'=>'resource', 'offset='=>'int'], 'mssql_field_name' => ['string', 'result'=>'resource', 'offset='=>'int'], 'mssql_field_seek' => ['bool', 'result'=>'resource', 'field_offset'=>'int'], 'mssql_field_type' => ['string', 'result'=>'resource', 'offset='=>'int'], 'mssql_free_result' => ['bool', 'result'=>'resource'], 'mssql_free_statement' => ['bool', 'stmt'=>'resource'], 'mssql_get_last_message' => ['string'], 'mssql_guid_string' => ['string', 'binary'=>'string', 'short_format='=>'bool'], 'mssql_init' => ['resource', 'sp_name'=>'string', 'link_identifier='=>'resource'], 'mssql_min_error_severity' => ['void', 'severity'=>'int'], 'mssql_min_message_severity' => ['void', 'severity'=>'int'], 'mssql_next_result' => ['bool', 'result_id'=>'resource'], 'mssql_num_fields' => ['int', 'result'=>'resource'], 'mssql_num_rows' => ['int', 'result'=>'resource'], 'mssql_pconnect' => ['resource', 'servername='=>'string', 'username='=>'string', 'password='=>'string', 'new_link='=>'bool'], 'mssql_query' => ['mixed', 'query'=>'string', 'link_identifier='=>'resource', 'batch_size='=>'int'], 'mssql_result' => ['string', 'result'=>'resource', 'row'=>'int', 'field'=>'mixed'], 'mssql_rows_affected' => ['int', 'link_identifier'=>'resource'], 'mssql_select_db' => ['bool', 'database_name'=>'string', 'link_identifier='=>'resource'], 'mt_getrandmax' => ['int'], 'mt_rand' => ['int', 'min'=>'int', 'max'=>'int'], 'mt_rand\'1' => ['int'], 'mt_srand' => ['void', 'seed='=>'int', 'mode='=>'int'], 'MultipleIterator::__construct' => ['void', 'flags='=>'int'], 'MultipleIterator::attachIterator' => ['void', 'iterator'=>'Iterator', 'infos='=>'string'], 'MultipleIterator::containsIterator' => ['bool', 'iterator'=>'Iterator'], 'MultipleIterator::countIterators' => ['int'], 'MultipleIterator::current' => ['array'], 'MultipleIterator::detachIterator' => ['void', 'iterator'=>'Iterator'], 'MultipleIterator::getFlags' => ['int'], 'MultipleIterator::key' => ['array'], 'MultipleIterator::next' => ['void'], 'MultipleIterator::rewind' => ['void'], 'MultipleIterator::setFlags' => ['int', 'flags'=>'int'], 'MultipleIterator::valid' => ['bool'], 'mysql_affected_rows' => ['int', 'link_identifier='=>'resource'], 'mysql_client_encoding' => ['string', 'link_identifier='=>'resource'], 'mysql_close' => ['bool', 'link_identifier='=>'resource'], 'mysql_connect' => ['resource|false', 'server='=>'string', 'username='=>'string', 'password='=>'string', 'new_link='=>'bool', 'client_flags='=>'int'], 'mysql_create_db' => ['bool', 'database_name'=>'string', 'link_identifier='=>'resource'], 'mysql_data_seek' => ['bool', 'result'=>'resource', 'row_number'=>'int'], 'mysql_db_name' => ['string|false', 'result'=>'resource', 'row'=>'int', 'field='=>'mixed'], 'mysql_db_query' => ['resource|bool', 'database'=>'string', 'query'=>'string', 'link_identifier='=>'resource'], 'mysql_drop_db' => ['bool', 'database_name'=>'string', 'link_identifier='=>'resource'], 'mysql_errno' => ['int', 'link_identifier='=>'resource'], 'mysql_error' => ['string', 'link_identifier='=>'resource'], 'mysql_escape_string' => ['string', 'unescaped_string'=>'string'], 'mysql_fetch_array' => ['array|false', 'result'=>'resource', 'result_type='=>'int'], 'mysql_fetch_assoc' => ['array|false', 'result'=>'resource'], 'mysql_fetch_field' => ['object', 'result'=>'resource', 'field_offset='=>'int'], 'mysql_fetch_lengths' => ['array|false', 'result'=>'resource'], 'mysql_fetch_object' => ['object|false', 'result'=>'resource', 'class_name='=>'string', 'params='=>'array'], 'mysql_fetch_row' => ['array|false', 'result'=>'resource'], 'mysql_field_flags' => ['string|false', 'result'=>'resource', 'field_offset'=>'int'], 'mysql_field_len' => ['int|false', 'result'=>'resource', 'field_offset'=>'int'], 'mysql_field_name' => ['string|false', 'result'=>'resource', 'field_offset'=>'int'], 'mysql_field_seek' => ['bool', 'result'=>'resource', 'field_offset'=>'int'], 'mysql_field_table' => ['string', 'result'=>'resource', 'field_offset'=>'int'], 'mysql_field_type' => ['string', 'result'=>'resource', 'field_offset'=>'int'], 'mysql_free_result' => ['bool', 'result'=>'resource'], 'mysql_get_client_info' => ['string'], 'mysql_get_host_info' => ['string|false', 'link_identifier='=>'resource'], 'mysql_get_proto_info' => ['int|false', 'link_identifier='=>'resource'], 'mysql_get_server_info' => ['string|false', 'link_identifier='=>'resource'], 'mysql_info' => ['string|false', 'link_identifier='=>'resource'], 'mysql_insert_id' => ['int|false', 'link_identifier='=>'resource'], 'mysql_list_dbs' => ['resource|false', 'link_identifier='=>'resource'], 'mysql_list_fields' => ['resource|false', 'database_name'=>'string', 'table_name'=>'string', 'link_identifier='=>'resource'], 'mysql_list_processes' => ['resource|false', 'link_identifier='=>'resource'], 'mysql_list_tables' => ['resource', 'database'=>'string', 'link_identifier='=>'resource'], 'mysql_num_fields' => ['int|false', 'result'=>'resource'], 'mysql_num_rows' => ['int|false', 'result'=>'resource'], 'mysql_pconnect' => ['resource|false', 'server='=>'string', 'username='=>'string', 'password='=>'string', 'client_flags='=>'int'], 'mysql_ping' => ['bool', 'link_identifier='=>'resource'], 'mysql_query' => ['resource|bool', 'query'=>'string', 'link_identifier='=>'resource'], 'mysql_real_escape_string' => ['string|false', 'unescaped_string'=>'string', 'link_identifier='=>'resource'], 'mysql_result' => ['string|false', 'result'=>'resource', 'row'=>'int', 'field='=>'mixed'], 'mysql_select_db' => ['bool', 'database_name'=>'string', 'link_identifier='=>'resource'], 'mysql_set_charset' => ['bool', 'charset'=>'string', 'link_identifier='=>'resource'], 'mysql_stat' => ['string|null', 'link_identifier='=>'resource'], 'mysql_tablename' => ['string|false', 'result'=>'resource', 'i'=>'int'], 'mysql_thread_id' => ['int|false', 'link_identifier='=>'resource'], 'mysql_unbuffered_query' => ['resource|bool', 'query'=>'string', 'link_identifier='=>'resource'], 'mysqli::__construct' => ['void', 'host='=>'string', 'username='=>'string', 'passwd='=>'string', 'dbname='=>'string', 'port='=>'int', 'socket='=>'string'], 'mysqli::autocommit' => ['bool', 'mode'=>'bool'], 'mysqli::begin_transaction' => ['bool', 'flags='=>'int', 'name='=>'string'], 'mysqli::change_user' => ['bool', 'user'=>'string', 'password'=>'string', 'database'=>'string'], 'mysqli::character_set_name' => ['string'], 'mysqli::close' => ['bool'], 'mysqli::commit' => ['bool', 'flags='=>'int', 'name='=>'string'], 'mysqli::debug' => ['bool', 'message'=>'string'], 'mysqli::disable_reads_from_master' => ['bool'], 'mysqli::dump_debug_info' => ['bool'], 'mysqli::get_charset' => ['object'], 'mysqli::get_client_info' => ['string'], 'mysqli::get_connection_stats' => ['array|false'], 'mysqli::get_warnings' => ['mysqli_warning|false'], 'mysqli::init' => ['mysqli'], 'mysqli::kill' => ['bool', 'processid'=>'int'], 'mysqli::more_results' => ['bool'], 'mysqli::multi_query' => ['bool', 'query'=>'string'], 'mysqli::next_result' => ['bool'], 'mysqli::options' => ['bool', 'option'=>'int', 'value'=>'mixed'], 'mysqli::ping' => ['bool'], 'mysqli::poll' => ['int|false', '&w_read'=>'array', '&w_error'=>'array', '&w_reject'=>'array', 'sec'=>'int', 'usec='=>'int'], 'mysqli::prepare' => ['mysqli_stmt|false', 'query'=>'string'], 'mysqli::query' => ['bool|mysqli_result', 'query'=>'string', 'resultmode='=>'int'], 'mysqli::real_connect' => ['bool', 'host='=>'?string', 'username='=>'?string', 'passwd='=>'?string', 'dbname='=>'?string', 'port='=>'?int', 'socket='=>'?string', 'flags='=>'int'], 'mysqli::real_escape_string' => ['string', 'escapestr'=>'string'], 'mysqli::real_query' => ['bool', 'query'=>'string'], 'mysqli::reap_async_query' => ['mysqli_result|false'], 'mysqli::refresh' => ['bool', 'options'=>'int'], 'mysqli::release_savepoint' => ['bool', 'name'=>'string'], 'mysqli::rollback' => ['bool', 'flags='=>'int', 'name='=>'string'], 'mysqli::rpl_query_type' => ['int', 'query'=>'string'], 'mysqli::savepoint' => ['bool', 'name'=>'string'], 'mysqli::select_db' => ['bool', 'dbname'=>'string'], 'mysqli::send_query' => ['bool', 'query'=>'string'], 'mysqli::set_charset' => ['bool', 'charset'=>'string'], 'mysqli::set_local_infile_default' => ['void'], 'mysqli::set_local_infile_handler' => ['bool', 'read_func='=>'callable'], 'mysqli::ssl_set' => ['bool', 'key'=>'string', 'cert'=>'string', 'ca'=>'string', 'capath'=>'string', 'cipher'=>'string'], 'mysqli::stat' => ['string|false'], 'mysqli::stmt_init' => ['mysqli_stmt'], 'mysqli::store_result' => ['mysqli_result|false', 'option='=>'int'], 'mysqli::thread_safe' => ['bool'], 'mysqli::use_result' => ['mysqli_result|false'], 'mysqli_affected_rows' => ['int<-1,max>|numeric-string', 'link'=>'mysqli'], 'mysqli_autocommit' => ['bool', 'link'=>'mysqli', 'mode'=>'bool'], 'mysqli_begin_transaction' => ['bool', 'link'=>'mysqli', 'flags='=>'int', 'name='=>'string'], 'mysqli_change_user' => ['bool', 'link'=>'mysqli', 'user'=>'string', 'password'=>'string', 'database'=>'string'], 'mysqli_character_set_name' => ['string', 'link'=>'mysqli'], 'mysqli_close' => ['bool', 'link'=>'mysqli'], 'mysqli_commit' => ['bool', 'link'=>'mysqli', 'flags='=>'int', 'name='=>'string'], 'mysqli_connect' => ['mysqli|false|null', 'host='=>'string', 'username='=>'string', 'passwd='=>'string', 'dbname='=>'string', 'port='=>'int', 'socket='=>'string'], 'mysqli_connect_errno' => ['int'], 'mysqli_connect_error' => ['string|null'], 'mysqli_data_seek' => ['bool', 'result'=>'mysqli_result', 'offset'=>'int'], 'mysqli_debug' => ['bool', 'message'=>'string'], 'mysqli_disable_reads_from_master' => ['bool', 'link'=>'mysqli'], 'mysqli_disable_rpl_parse' => ['bool', 'link'=>'mysqli'], 'mysqli_driver::embedded_server_end' => ['void'], 'mysqli_driver::embedded_server_start' => ['bool', 'start'=>'int', 'arguments'=>'array', 'groups'=>'array'], 'mysqli_dump_debug_info' => ['bool', 'link'=>'mysqli'], 'mysqli_embedded_server_end' => ['void'], 'mysqli_embedded_server_start' => ['bool', 'start'=>'int', 'arguments'=>'array', 'groups'=>'array'], 'mysqli_enable_reads_from_master' => ['bool', 'link'=>'mysqli'], 'mysqli_enable_rpl_parse' => ['bool', 'link'=>'mysqli'], 'mysqli_errno' => ['int', 'link'=>'mysqli'], 'mysqli_error' => ['string|null', 'link'=>'mysqli'], 'mysqli_error_list' => ['array', 'connection'=>'mysqli'], 'mysqli_fetch_all' => ['array', 'result'=>'mysqli_result', 'resulttype='=>'int'], 'mysqli_fetch_array' => ['array|null|false', 'result'=>'mysqli_result', 'resulttype='=>'int'], 'mysqli_fetch_assoc' => ['array<string,string|int|float|null>|null|false', 'result'=>'mysqli_result'], 'mysqli_fetch_column' => ['null|int|float|string|false', 'result' => 'mysqli_result', 'column'=>'int'], 'mysqli_fetch_field' => ['(stdClass&object{name: string, orgname: string, table: string, orgtable: string, def: string, db: string, catalog: "def", max_length: int, length: int, charsetnr: string, flags: int, type: int, decimals: int})|false', 'result'=>'mysqli_result'], 'mysqli_fetch_field_direct' => ['(stdClass&object{name: string, orgname: string, table: string, orgtable: string, def: string, db: string, catalog: "def", max_length: int, length: int, charsetnr: string, flags: int, type: int, decimals: int})|false', 'result'=>'mysqli_result', 'fieldnr'=>'int'], 'mysqli_fetch_fields' => ['list<stdClass&object{name: string, orgname: string, table: string, orgtable: string, def: string, db: string, catalog: "def", max_length: int, length: int, charsetnr: string, flags: int, type: int, decimals: int}>', 'result'=>'mysqli_result'], 'mysqli_fetch_lengths' => ['array|false', 'result'=>'mysqli_result'], 'mysqli_fetch_object' => ['object|false|null', 'result'=>'mysqli_result', 'class_name='=>'string', 'params='=>'?array'], 'mysqli_fetch_row' => ['array|null', 'result'=>'mysqli_result'], 'mysqli_field_count' => ['int', 'link'=>'mysqli'], 'mysqli_field_seek' => ['bool', 'result'=>'mysqli_result', 'fieldnr'=>'int'], 'mysqli_field_tell' => ['int', 'result'=>'mysqli_result'], 'mysqli_free_result' => ['void', 'link'=>'mysqli_result'], 'mysqli_get_cache_stats' => ['array'], 'mysqli_get_charset' => ['object', 'link'=>'mysqli'], 'mysqli_get_client_info' => ['string', 'link='=>'mysqli'], 'mysqli_get_client_stats' => ['array|false'], 'mysqli_get_client_version' => ['int'], 'mysqli_get_connection_stats' => ['array|false', 'link'=>'mysqli'], 'mysqli_get_host_info' => ['string', 'link'=>'mysqli'], 'mysqli_get_links_stats' => ['array'], 'mysqli_get_proto_info' => ['int', 'link'=>'mysqli'], 'mysqli_get_server_info' => ['string', 'link'=>'mysqli'], 'mysqli_get_server_version' => ['int', 'link'=>'mysqli'], 'mysqli_get_warnings' => ['mysqli_warning|false', 'link'=>'mysqli'], 'mysqli_info' => ['?string', 'link'=>'mysqli'], 'mysqli_init' => ['mysqli|false'], 'mysqli_insert_id' => ['int|string', 'link'=>'mysqli'], 'mysqli_kill' => ['bool', 'link'=>'mysqli', 'processid'=>'int'], 'mysqli_link_construct' => ['object'], 'mysqli_master_query' => ['bool', 'link'=>'mysqli', 'query'=>'string'], 'mysqli_more_results' => ['bool', 'link'=>'mysqli'], 'mysqli_multi_query' => ['bool', 'link'=>'mysqli', 'query'=>'string'], 'mysqli_next_result' => ['bool', 'link'=>'mysqli'], 'mysqli_num_fields' => ['int', 'link'=>'mysqli_result'], 'mysqli_num_rows' => ['int<0,max>|numeric-string', 'link'=>'mysqli_result'], 'mysqli_options' => ['bool', 'link'=>'mysqli', 'option'=>'int', 'value'=>'mixed'], 'mysqli_ping' => ['bool', 'link'=>'mysqli'], 'mysqli_poll' => ['int|false', 'read'=>'array', 'error'=>'array', 'reject'=>'array', 'sec'=>'int', 'usec='=>'int'], 'mysqli_prepare' => ['mysqli_stmt|false', 'link'=>'mysqli', 'query'=>'string'], 'mysqli_query' => ['mysqli_result|bool', 'link'=>'mysqli', 'query'=>'string', 'resultmode='=>'int'], 'mysqli_real_connect' => ['bool', 'link='=>'mysqli', 'host='=>'?string', 'username='=>'?string', 'passwd='=>'?string', 'dbname='=>'?string', 'port='=>'?int', 'socket='=>'?string', 'flags='=>'int'], 'mysqli_real_escape_string' => ['string', 'link'=>'mysqli', 'escapestr'=>'string'], 'mysqli_real_query' => ['bool', 'link'=>'mysqli', 'query'=>'string'], 'mysqli_reap_async_query' => ['mysqli_result|false', 'link'=>'mysqli'], 'mysqli_refresh' => ['bool', 'link'=>'mysqli', 'options'=>'int'], 'mysqli_release_savepoint' => ['bool', 'link'=>'mysqli', 'name'=>'string'], 'mysqli_report' => ['bool', 'flags'=>'int'], 'mysqli_result::__construct' => ['void', 'link'=>'mysqli', 'resultmode='=>'int'], 'mysqli_result::close' => ['void'], 'mysqli_result::data_seek' => ['bool', 'offset'=>'int'], 'mysqli_result::fetch_all' => ['array', 'resulttype='=>'int'], 'mysqli_result::fetch_array' => ['array|null|false', 'resulttype='=>'int'], 'mysqli_result::fetch_assoc' => ['array<string,string|int|float|null>|null|false'], 'mysqli_result::fetch_column' => ['null|int|float|string|false', 'column'=>'int'], 'mysqli_result::fetch_field' => ['(stdClass&object{name: string, orgname: string, table: string, orgtable: string, def: string, db: string, catalog: "def", max_length: int, length: int, charsetnr: string, flags: int, type: int, decimals: int})|false'], 'mysqli_result::fetch_field_direct' => ['(stdClass&object{name: string, orgname: string, table: string, orgtable: string, def: string, db: string, catalog: "def", max_length: int, length: int, charsetnr: string, flags: int, type: int, decimals: int})|false', 'fieldnr'=>'int'], 'mysqli_result::fetch_fields' => ['list<stdClass&object{name: string, orgname: string, table: string, orgtable: string, def: string, db: string, catalog: "def", max_length: int, length: int, charsetnr: string, flags: int, type: int, decimals: int}>'], 'mysqli_result::fetch_object' => ['object|null', 'class_name='=>'string', 'params='=>'array'], 'mysqli_result::fetch_row' => ['array|null'], 'mysqli_result::field_seek' => ['bool', 'fieldnr'=>'int'], 'mysqli_result::free' => ['void'], 'mysqli_result::free_result' => ['void'], 'mysqli_rollback' => ['bool', 'link'=>'mysqli', 'flags='=>'int', 'name='=>'string'], 'mysqli_rpl_parse_enabled' => ['int', 'link'=>'mysqli'], 'mysqli_rpl_probe' => ['bool', 'link'=>'mysqli'], 'mysqli_rpl_query_type' => ['int', 'link'=>'mysqli', 'query'=>'string'], 'mysqli_savepoint' => ['bool', 'link'=>'mysqli', 'name'=>'string'], 'mysqli_savepoint_libmysql' => ['bool'], 'mysqli_select_db' => ['bool', 'link'=>'mysqli', 'dbname'=>'string'], 'mysqli_send_query' => ['bool', 'link'=>'mysqli', 'query'=>'string'], 'mysqli_set_charset' => ['bool', 'link'=>'mysqli', 'charset'=>'string'], 'mysqli_set_local_infile_default' => ['void', 'link'=>'mysqli'], 'mysqli_set_local_infile_handler' => ['bool', 'link'=>'mysqli', 'read_func'=>'callable'], 'mysqli_slave_query' => ['bool', 'link'=>'mysqli', 'query'=>'string'], 'mysqli_sqlstate' => ['string', 'link'=>'mysqli'], 'mysqli_ssl_set' => ['bool', 'link'=>'mysqli', 'key'=>'string', 'cert'=>'string', 'ca'=>'string', 'capath'=>'string', 'cipher'=>'string'], 'mysqli_stat' => ['string|false', 'link'=>'mysqli'], 'mysqli_stmt::__construct' => ['void', 'link'=>'mysqli', 'query='=>'string'], 'mysqli_stmt::attr_get' => ['false|int', 'attr'=>'int'], 'mysqli_stmt::attr_set' => ['bool', 'attr'=>'int', 'mode'=>'int'], 'mysqli_stmt::bind_param' => ['bool', 'types'=>'string', 'var1'=>'mixed', '...args='=>'mixed'], 'mysqli_stmt::bind_result' => ['bool', '&w_var1'=>'', '&...w_vars='=>''], 'mysqli_stmt::close' => ['bool'], 'mysqli_stmt::data_seek' => ['void', 'offset'=>'int'], 'mysqli_stmt::execute' => ['bool'], 'mysqli_stmt::fetch' => ['bool|null'], 'mysqli_stmt::free_result' => ['void'], 'mysqli_stmt::get_result' => ['mysqli_result|false'], 'mysqli_stmt::get_warnings' => ['mysqli_warning|false'], 'mysqli_stmt::more_results' => ['bool'], 'mysqli_stmt::next_result' => ['bool'], 'mysqli_stmt::num_rows' => ['int<0,max>|numeric-string'], 'mysqli_stmt::prepare' => ['bool', 'query'=>'string'], 'mysqli_stmt::reset' => ['bool'], 'mysqli_stmt::result_metadata' => ['mysqli_result|false'], 'mysqli_stmt::send_long_data' => ['bool', 'param_nr'=>'int', 'data'=>'string'], 'mysqli_stmt::store_result' => ['bool'], 'mysqli_stmt_affected_rows' => ['int<-1,max>|numeric-string', 'stmt'=>'mysqli_stmt'], 'mysqli_stmt_attr_get' => ['int|false', 'stmt'=>'mysqli_stmt', 'attr'=>'int'], 'mysqli_stmt_attr_set' => ['bool', 'stmt'=>'mysqli_stmt', 'attr'=>'int', 'mode'=>'int'], 'mysqli_stmt_bind_param' => ['bool', 'stmt'=>'mysqli_stmt', 'types'=>'string', 'var1'=>'mixed', '...args='=>'mixed'], 'mysqli_stmt_bind_result' => ['bool', 'stmt'=>'mysqli_stmt', '&w_var1'=>'', '&...w_vars='=>''], 'mysqli_stmt_close' => ['bool', 'stmt'=>'mysqli_stmt'], 'mysqli_stmt_data_seek' => ['void', 'stmt'=>'mysqli_stmt', 'offset'=>'int'], 'mysqli_stmt_errno' => ['int', 'stmt'=>'mysqli_stmt'], 'mysqli_stmt_error' => ['string', 'stmt'=>'mysqli_stmt'], 'mysqli_stmt_error_list' => ['list<array{errno: int, sqlstate: string, error: string}>', 'stmt'=>'mysqli_stmt'], 'mysqli_stmt_execute' => ['bool', 'stmt'=>'mysqli_stmt'], 'mysqli_stmt_fetch' => ['bool|null', 'stmt'=>'mysqli_stmt'], 'mysqli_stmt_field_count' => ['0|positive-int', 'stmt'=>'mysqli_stmt'], 'mysqli_stmt_free_result' => ['void', 'stmt'=>'mysqli_stmt'], 'mysqli_stmt_get_result' => ['mysqli_result|false', 'stmt'=>'mysqli_stmt'], 'mysqli_stmt_get_warnings' => ['mysqli_warning|false', 'stmt'=>'mysqli_stmt'], 'mysqli_stmt_init' => ['mysqli_stmt|false', 'link'=>'mysqli'], 'mysqli_stmt_insert_id' => ['', 'stmt'=>'mysqli_stmt'], 'mysqli_stmt_more_results' => ['bool', 'stmt'=>'mysqli_stmt'], 'mysqli_stmt_next_result' => ['bool', 'stmt'=>'mysqli_stmt'], 'mysqli_stmt_num_rows' => ['0|positive-int', 'stmt'=>'mysqli_stmt'], 'mysqli_stmt_param_count' => ['0|positive-int', 'stmt'=>'mysqli_stmt'], 'mysqli_stmt_prepare' => ['bool', 'stmt'=>'mysqli_stmt', 'query'=>'string'], 'mysqli_stmt_reset' => ['bool', 'stmt'=>'mysqli_stmt'], 'mysqli_stmt_result_metadata' => ['mysqli_result|false', 'stmt'=>'mysqli_stmt'], 'mysqli_stmt_send_long_data' => ['bool', 'stmt'=>'mysqli_stmt', 'param_nr'=>'int', 'data'=>'string'], 'mysqli_stmt_sqlstate' => ['non-empty-string', 'stmt'=>'mysqli_stmt'], 'mysqli_stmt_store_result' => ['bool', 'stmt'=>'mysqli_stmt'], 'mysqli_store_result' => ['mysqli_result|false', 'link'=>'mysqli', 'option='=>'int'], 'mysqli_thread_id' => ['int', 'link'=>'mysqli'], 'mysqli_thread_safe' => ['bool'], 'mysqli_use_result' => ['mysqli_result|false', 'link'=>'mysqli'], 'mysqli_warning::__construct' => ['void'], 'mysqli_warning::next' => ['bool'], 'mysqli_warning_count' => ['int', 'link'=>'mysqli'], 'mysqlnd_memcache_get_config' => ['array', 'connection'=>'mixed'], 'mysqlnd_memcache_set' => ['bool', 'mysql_connection'=>'mixed', 'memcache_connection='=>'Memcached', 'pattern='=>'string', 'callback='=>'callable'], 'mysqlnd_ms_dump_servers' => ['array', 'connection'=>'mixed'], 'mysqlnd_ms_fabric_select_global' => ['array', 'connection'=>'mixed', 'table_name'=>'mixed'], 'mysqlnd_ms_fabric_select_shard' => ['array', 'connection'=>'mixed', 'table_name'=>'mixed', 'shard_key'=>'mixed'], 'mysqlnd_ms_get_last_gtid' => ['string', 'connection'=>'mixed'], 'mysqlnd_ms_get_last_used_connection' => ['array', 'connection'=>'mixed'], 'mysqlnd_ms_get_stats' => ['array'], 'mysqlnd_ms_match_wild' => ['bool', 'table_name'=>'string', 'wildcard'=>'string'], 'mysqlnd_ms_query_is_select' => ['int', 'query'=>'string'], 'mysqlnd_ms_set_qos' => ['bool', 'connection'=>'mixed', 'service_level'=>'int', 'service_level_option='=>'int', 'option_value='=>'mixed'], 'mysqlnd_ms_set_user_pick_server' => ['bool', 'function'=>'string'], 'mysqlnd_ms_xa_begin' => ['int', 'connection'=>'mixed', 'gtrid'=>'string', 'timeout='=>'int'], 'mysqlnd_ms_xa_commit' => ['int', 'connection'=>'mixed', 'gtrid'=>'string'], 'mysqlnd_ms_xa_gc' => ['int', 'connection'=>'mixed', 'gtrid='=>'string', 'ignore_max_retries='=>'bool'], 'mysqlnd_ms_xa_rollback' => ['int', 'connection'=>'mixed', 'gtrid'=>'string'], 'mysqlnd_qc_change_handler' => ['bool', 'handler'=>''], 'mysqlnd_qc_clear_cache' => ['bool'], 'mysqlnd_qc_get_available_handlers' => ['array'], 'mysqlnd_qc_get_cache_info' => ['array'], 'mysqlnd_qc_get_core_stats' => ['array'], 'mysqlnd_qc_get_handler' => ['array'], 'mysqlnd_qc_get_normalized_query_trace_log' => ['array'], 'mysqlnd_qc_get_query_trace_log' => ['array'], 'mysqlnd_qc_set_cache_condition' => ['bool', 'condition_type'=>'int', 'condition'=>'mixed', 'condition_option'=>'mixed'], 'mysqlnd_qc_set_is_select' => ['mixed', 'callback'=>'string'], 'mysqlnd_qc_set_storage_handler' => ['bool', 'handler'=>'string'], 'mysqlnd_qc_set_user_handlers' => ['bool', 'get_hash'=>'string', 'find_query_in_cache'=>'string', 'return_to_cache'=>'string', 'add_query_to_cache_if_not_exists'=>'string', 'query_is_select'=>'string', 'update_query_run_time_stats'=>'string', 'get_stats'=>'string', 'clear_cache'=>'string'], 'mysqlnd_uh_convert_to_mysqlnd' => ['resource', '&rw_mysql_connection'=>'mysqli'], 'mysqlnd_uh_set_connection_proxy' => ['bool', '&rw_connection_proxy'=>'MysqlndUhConnection', '&rw_mysqli_connection='=>'mysqli'], 'mysqlnd_uh_set_statement_proxy' => ['bool', '&rw_statement_proxy'=>'MysqlndUhStatement'], 'MysqlndUhConnection::__construct' => ['void'], 'MysqlndUhConnection::changeUser' => ['bool', 'connection'=>'mysqlnd_connection', 'user'=>'string', 'password'=>'string', 'database'=>'string', 'silent'=>'bool', 'passwd_len'=>'int'], 'MysqlndUhConnection::charsetName' => ['string', 'connection'=>'mysqlnd_connection'], 'MysqlndUhConnection::close' => ['bool', 'connection'=>'mysqlnd_connection', 'close_type'=>'int'], 'MysqlndUhConnection::connect' => ['bool', 'connection'=>'mysqlnd_connection', 'host'=>'string', 'use'=>'string', 'password'=>'string', 'database'=>'string', 'port'=>'int', 'socket'=>'string', 'mysql_flags'=>'int'], 'MysqlndUhConnection::endPSession' => ['bool', 'connection'=>'mysqlnd_connection'], 'MysqlndUhConnection::escapeString' => ['string', 'connection'=>'mysqlnd_connection', 'escape_string'=>'string'], 'MysqlndUhConnection::getAffectedRows' => ['int', 'connection'=>'mysqlnd_connection'], 'MysqlndUhConnection::getErrorNumber' => ['int', 'connection'=>'mysqlnd_connection'], 'MysqlndUhConnection::getErrorString' => ['string', 'connection'=>'mysqlnd_connection'], 'MysqlndUhConnection::getFieldCount' => ['int', 'connection'=>'mysqlnd_connection'], 'MysqlndUhConnection::getHostInformation' => ['string', 'connection'=>'mysqlnd_connection'], 'MysqlndUhConnection::getLastInsertId' => ['int', 'connection'=>'mysqlnd_connection'], 'MysqlndUhConnection::getLastMessage' => ['void', 'connection'=>'mysqlnd_connection'], 'MysqlndUhConnection::getProtocolInformation' => ['string', 'connection'=>'mysqlnd_connection'], 'MysqlndUhConnection::getServerInformation' => ['string', 'connection'=>'mysqlnd_connection'], 'MysqlndUhConnection::getServerStatistics' => ['string', 'connection'=>'mysqlnd_connection'], 'MysqlndUhConnection::getServerVersion' => ['int', 'connection'=>'mysqlnd_connection'], 'MysqlndUhConnection::getSqlstate' => ['string', 'connection'=>'mysqlnd_connection'], 'MysqlndUhConnection::getStatistics' => ['array', 'connection'=>'mysqlnd_connection'], 'MysqlndUhConnection::getThreadId' => ['int', 'connection'=>'mysqlnd_connection'], 'MysqlndUhConnection::getWarningCount' => ['int', 'connection'=>'mysqlnd_connection'], 'MysqlndUhConnection::init' => ['bool', 'connection'=>'mysqlnd_connection'], 'MysqlndUhConnection::killConnection' => ['bool', 'connection'=>'mysqlnd_connection', 'pid'=>'int'], 'MysqlndUhConnection::listFields' => ['array', 'connection'=>'mysqlnd_connection', 'table'=>'string', 'achtung_wild'=>'string'], 'MysqlndUhConnection::listMethod' => ['void', 'connection'=>'mysqlnd_connection', 'query'=>'string', 'achtung_wild'=>'string', 'par1'=>'string'], 'MysqlndUhConnection::moreResults' => ['bool', 'connection'=>'mysqlnd_connection'], 'MysqlndUhConnection::nextResult' => ['bool', 'connection'=>'mysqlnd_connection'], 'MysqlndUhConnection::ping' => ['bool', 'connection'=>'mysqlnd_connection'], 'MysqlndUhConnection::query' => ['bool', 'connection'=>'mysqlnd_connection', 'query'=>'string'], 'MysqlndUhConnection::queryReadResultsetHeader' => ['bool', 'connection'=>'mysqlnd_connection', 'mysqlnd_stmt'=>'mysqlnd_statement'], 'MysqlndUhConnection::reapQuery' => ['bool', 'connection'=>'mysqlnd_connection'], 'MysqlndUhConnection::refreshServer' => ['bool', 'connection'=>'mysqlnd_connection', 'options'=>'int'], 'MysqlndUhConnection::restartPSession' => ['bool', 'connection'=>'mysqlnd_connection'], 'MysqlndUhConnection::selectDb' => ['bool', 'connection'=>'mysqlnd_connection', 'database'=>'string'], 'MysqlndUhConnection::sendClose' => ['bool', 'connection'=>'mysqlnd_connection'], 'MysqlndUhConnection::sendQuery' => ['bool', 'connection'=>'mysqlnd_connection', 'query'=>'string'], 'MysqlndUhConnection::serverDumpDebugInformation' => ['bool', 'connection'=>'mysqlnd_connection'], 'MysqlndUhConnection::setAutocommit' => ['bool', 'connection'=>'mysqlnd_connection', 'mode'=>'int'], 'MysqlndUhConnection::setCharset' => ['bool', 'connection'=>'mysqlnd_connection', 'charset'=>'string'], 'MysqlndUhConnection::setClientOption' => ['bool', 'connection'=>'mysqlnd_connection', 'option'=>'int', 'value'=>'int'], 'MysqlndUhConnection::setServerOption' => ['void', 'connection'=>'mysqlnd_connection', 'option'=>'int'], 'MysqlndUhConnection::shutdownServer' => ['void', 'MYSQLND_UH_RES_MYSQLND_NAME'=>'string', 'level'=>'string'], 'MysqlndUhConnection::simpleCommand' => ['bool', 'connection'=>'mysqlnd_connection', 'command'=>'int', 'arg'=>'string', 'ok_packet'=>'int', 'silent'=>'bool', 'ignore_upsert_status'=>'bool'], 'MysqlndUhConnection::simpleCommandHandleResponse' => ['bool', 'connection'=>'mysqlnd_connection', 'ok_packet'=>'int', 'silent'=>'bool', 'command'=>'int', 'ignore_upsert_status'=>'bool'], 'MysqlndUhConnection::sslSet' => ['bool', 'connection'=>'mysqlnd_connection', 'key'=>'string', 'cert'=>'string', 'ca'=>'string', 'capath'=>'string', 'cipher'=>'string'], 'MysqlndUhConnection::stmtInit' => ['resource', 'connection'=>'mysqlnd_connection'], 'MysqlndUhConnection::storeResult' => ['resource', 'connection'=>'mysqlnd_connection'], 'MysqlndUhConnection::txCommit' => ['bool', 'connection'=>'mysqlnd_connection'], 'MysqlndUhConnection::txRollback' => ['bool', 'connection'=>'mysqlnd_connection'], 'MysqlndUhConnection::useResult' => ['resource', 'connection'=>'mysqlnd_connection'], 'MysqlndUhPreparedStatement::__construct' => ['void'], 'MysqlndUhPreparedStatement::execute' => ['bool', 'statement'=>'mysqlnd_prepared_statement'], 'MysqlndUhPreparedStatement::prepare' => ['bool', 'statement'=>'mysqlnd_prepared_statement', 'query'=>'string'], 'natcasesort' => ['bool', '&rw_array_arg'=>'array'], 'natsort' => ['bool', '&rw_array_arg'=>'array'], 'ncurses_addch' => ['int', 'ch'=>'int'], 'ncurses_addchnstr' => ['int', 's'=>'string', 'n'=>'int'], 'ncurses_addchstr' => ['int', 's'=>'string'], 'ncurses_addnstr' => ['int', 's'=>'string', 'n'=>'int'], 'ncurses_addstr' => ['int', 'text'=>'string'], 'ncurses_assume_default_colors' => ['int', 'fg'=>'int', 'bg'=>'int'], 'ncurses_attroff' => ['int', 'attributes'=>'int'], 'ncurses_attron' => ['int', 'attributes'=>'int'], 'ncurses_attrset' => ['int', 'attributes'=>'int'], 'ncurses_baudrate' => ['int'], 'ncurses_beep' => ['int'], 'ncurses_bkgd' => ['int', 'attrchar'=>'int'], 'ncurses_bkgdset' => ['void', 'attrchar'=>'int'], 'ncurses_border' => ['int', 'left'=>'int', 'right'=>'int', 'top'=>'int', 'bottom'=>'int', 'tl_corner'=>'int', 'tr_corner'=>'int', 'bl_corner'=>'int', 'br_corner'=>'int'], 'ncurses_bottom_panel' => ['int', 'panel'=>'resource'], 'ncurses_can_change_color' => ['bool'], 'ncurses_cbreak' => ['bool'], 'ncurses_clear' => ['bool'], 'ncurses_clrtobot' => ['bool'], 'ncurses_clrtoeol' => ['bool'], 'ncurses_color_content' => ['int', 'color'=>'int', 'r'=>'int', 'g'=>'int', 'b'=>'int'], 'ncurses_color_set' => ['int', 'pair'=>'int'], 'ncurses_curs_set' => ['int', 'visibility'=>'int'], 'ncurses_def_prog_mode' => ['bool'], 'ncurses_def_shell_mode' => ['bool'], 'ncurses_define_key' => ['int', 'definition'=>'string', 'keycode'=>'int'], 'ncurses_del_panel' => ['bool', 'panel'=>'resource'], 'ncurses_delay_output' => ['int', 'milliseconds'=>'int'], 'ncurses_delch' => ['bool'], 'ncurses_deleteln' => ['bool'], 'ncurses_delwin' => ['bool', 'window'=>'resource'], 'ncurses_doupdate' => ['bool'], 'ncurses_echo' => ['bool'], 'ncurses_echochar' => ['int', 'character'=>'int'], 'ncurses_end' => ['int'], 'ncurses_erase' => ['bool'], 'ncurses_erasechar' => ['string'], 'ncurses_filter' => ['void'], 'ncurses_flash' => ['bool'], 'ncurses_flushinp' => ['bool'], 'ncurses_getch' => ['int'], 'ncurses_getmaxyx' => ['void', 'window'=>'resource', 'y'=>'int', 'x'=>'int'], 'ncurses_getmouse' => ['bool', 'mevent'=>'array'], 'ncurses_getyx' => ['void', 'window'=>'resource', 'y'=>'int', 'x'=>'int'], 'ncurses_halfdelay' => ['int', 'tenth'=>'int'], 'ncurses_has_colors' => ['bool'], 'ncurses_has_ic' => ['bool'], 'ncurses_has_il' => ['bool'], 'ncurses_has_key' => ['int', 'keycode'=>'int'], 'ncurses_hide_panel' => ['int', 'panel'=>'resource'], 'ncurses_hline' => ['int', 'charattr'=>'int', 'n'=>'int'], 'ncurses_inch' => ['string'], 'ncurses_init' => ['void'], 'ncurses_init_color' => ['int', 'color'=>'int', 'r'=>'int', 'g'=>'int', 'b'=>'int'], 'ncurses_init_pair' => ['int', 'pair'=>'int', 'fg'=>'int', 'bg'=>'int'], 'ncurses_insch' => ['int', 'character'=>'int'], 'ncurses_insdelln' => ['int', 'count'=>'int'], 'ncurses_insertln' => ['int'], 'ncurses_insstr' => ['int', 'text'=>'string'], 'ncurses_instr' => ['int', 'buffer'=>'string'], 'ncurses_isendwin' => ['bool'], 'ncurses_keyok' => ['int', 'keycode'=>'int', 'enable'=>'bool'], 'ncurses_keypad' => ['int', 'window'=>'resource', 'bf'=>'bool'], 'ncurses_killchar' => ['string'], 'ncurses_longname' => ['string'], 'ncurses_meta' => ['int', 'window'=>'resource', '_8bit'=>'bool'], 'ncurses_mouse_trafo' => ['bool', 'y'=>'int', 'x'=>'int', 'toscreen'=>'bool'], 'ncurses_mouseinterval' => ['int', 'milliseconds'=>'int'], 'ncurses_mousemask' => ['int', 'newmask'=>'int', 'oldmask'=>'int'], 'ncurses_move' => ['int', 'y'=>'int', 'x'=>'int'], 'ncurses_move_panel' => ['int', 'panel'=>'resource', 'startx'=>'int', 'starty'=>'int'], 'ncurses_mvaddch' => ['int', 'y'=>'int', 'x'=>'int', 'c'=>'int'], 'ncurses_mvaddchnstr' => ['int', 'y'=>'int', 'x'=>'int', 's'=>'string', 'n'=>'int'], 'ncurses_mvaddchstr' => ['int', 'y'=>'int', 'x'=>'int', 's'=>'string'], 'ncurses_mvaddnstr' => ['int', 'y'=>'int', 'x'=>'int', 's'=>'string', 'n'=>'int'], 'ncurses_mvaddstr' => ['int', 'y'=>'int', 'x'=>'int', 's'=>'string'], 'ncurses_mvcur' => ['int', 'old_y'=>'int', 'old_x'=>'int', 'new_y'=>'int', 'new_x'=>'int'], 'ncurses_mvdelch' => ['int', 'y'=>'int', 'x'=>'int'], 'ncurses_mvgetch' => ['int', 'y'=>'int', 'x'=>'int'], 'ncurses_mvhline' => ['int', 'y'=>'int', 'x'=>'int', 'attrchar'=>'int', 'n'=>'int'], 'ncurses_mvinch' => ['int', 'y'=>'int', 'x'=>'int'], 'ncurses_mvvline' => ['int', 'y'=>'int', 'x'=>'int', 'attrchar'=>'int', 'n'=>'int'], 'ncurses_mvwaddstr' => ['int', 'window'=>'resource', 'y'=>'int', 'x'=>'int', 'text'=>'string'], 'ncurses_napms' => ['int', 'milliseconds'=>'int'], 'ncurses_new_panel' => ['resource', 'window'=>'resource'], 'ncurses_newpad' => ['resource', 'rows'=>'int', 'cols'=>'int'], 'ncurses_newwin' => ['resource', 'rows'=>'int', 'cols'=>'int', 'y'=>'int', 'x'=>'int'], 'ncurses_nl' => ['bool'], 'ncurses_nocbreak' => ['bool'], 'ncurses_noecho' => ['bool'], 'ncurses_nonl' => ['bool'], 'ncurses_noqiflush' => ['void'], 'ncurses_noraw' => ['bool'], 'ncurses_pair_content' => ['int', 'pair'=>'int', 'f'=>'int', 'b'=>'int'], 'ncurses_panel_above' => ['resource', 'panel'=>'resource'], 'ncurses_panel_below' => ['resource', 'panel'=>'resource'], 'ncurses_panel_window' => ['resource', 'panel'=>'resource'], 'ncurses_pnoutrefresh' => ['int', 'pad'=>'resource', 'pminrow'=>'int', 'pmincol'=>'int', 'sminrow'=>'int', 'smincol'=>'int', 'smaxrow'=>'int', 'smaxcol'=>'int'], 'ncurses_prefresh' => ['int', 'pad'=>'resource', 'pminrow'=>'int', 'pmincol'=>'int', 'sminrow'=>'int', 'smincol'=>'int', 'smaxrow'=>'int', 'smaxcol'=>'int'], 'ncurses_putp' => ['int', 'text'=>'string'], 'ncurses_qiflush' => ['void'], 'ncurses_raw' => ['bool'], 'ncurses_refresh' => ['int', 'ch'=>'int'], 'ncurses_replace_panel' => ['int', 'panel'=>'resource', 'window'=>'resource'], 'ncurses_reset_prog_mode' => ['int'], 'ncurses_reset_shell_mode' => ['int'], 'ncurses_resetty' => ['bool'], 'ncurses_savetty' => ['bool'], 'ncurses_scr_dump' => ['int', 'filename'=>'string'], 'ncurses_scr_init' => ['int', 'filename'=>'string'], 'ncurses_scr_restore' => ['int', 'filename'=>'string'], 'ncurses_scr_set' => ['int', 'filename'=>'string'], 'ncurses_scrl' => ['int', 'count'=>'int'], 'ncurses_show_panel' => ['int', 'panel'=>'resource'], 'ncurses_slk_attr' => ['int'], 'ncurses_slk_attroff' => ['int', 'intarg'=>'int'], 'ncurses_slk_attron' => ['int', 'intarg'=>'int'], 'ncurses_slk_attrset' => ['int', 'intarg'=>'int'], 'ncurses_slk_clear' => ['bool'], 'ncurses_slk_color' => ['int', 'intarg'=>'int'], 'ncurses_slk_init' => ['bool', 'format'=>'int'], 'ncurses_slk_noutrefresh' => ['bool'], 'ncurses_slk_refresh' => ['int'], 'ncurses_slk_restore' => ['int'], 'ncurses_slk_set' => ['bool', 'labelnr'=>'int', 'label'=>'string', 'format'=>'int'], 'ncurses_slk_touch' => ['int'], 'ncurses_standend' => ['int'], 'ncurses_standout' => ['int'], 'ncurses_start_color' => ['int'], 'ncurses_termattrs' => ['bool'], 'ncurses_termname' => ['string'], 'ncurses_timeout' => ['void', 'millisec'=>'int'], 'ncurses_top_panel' => ['int', 'panel'=>'resource'], 'ncurses_typeahead' => ['int', 'fd'=>'int'], 'ncurses_ungetch' => ['int', 'keycode'=>'int'], 'ncurses_ungetmouse' => ['bool', 'mevent'=>'array'], 'ncurses_update_panels' => ['void'], 'ncurses_use_default_colors' => ['bool'], 'ncurses_use_env' => ['void', 'flag'=>'bool'], 'ncurses_use_extended_names' => ['int', 'flag'=>'bool'], 'ncurses_vidattr' => ['int', 'intarg'=>'int'], 'ncurses_vline' => ['int', 'charattr'=>'int', 'n'=>'int'], 'ncurses_waddch' => ['int', 'window'=>'resource', 'ch'=>'int'], 'ncurses_waddstr' => ['int', 'window'=>'resource', 'str'=>'string', 'n='=>'int'], 'ncurses_wattroff' => ['int', 'window'=>'resource', 'attrs'=>'int'], 'ncurses_wattron' => ['int', 'window'=>'resource', 'attrs'=>'int'], 'ncurses_wattrset' => ['int', 'window'=>'resource', 'attrs'=>'int'], 'ncurses_wborder' => ['int', 'window'=>'resource', 'left'=>'int', 'right'=>'int', 'top'=>'int', 'bottom'=>'int', 'tl_corner'=>'int', 'tr_corner'=>'int', 'bl_corner'=>'int', 'br_corner'=>'int'], 'ncurses_wclear' => ['int', 'window'=>'resource'], 'ncurses_wcolor_set' => ['int', 'window'=>'resource', 'color_pair'=>'int'], 'ncurses_werase' => ['int', 'window'=>'resource'], 'ncurses_wgetch' => ['int', 'window'=>'resource'], 'ncurses_whline' => ['int', 'window'=>'resource', 'charattr'=>'int', 'n'=>'int'], 'ncurses_wmouse_trafo' => ['bool', 'window'=>'resource', 'y'=>'int', 'x'=>'int', 'toscreen'=>'bool'], 'ncurses_wmove' => ['int', 'window'=>'resource', 'y'=>'int', 'x'=>'int'], 'ncurses_wnoutrefresh' => ['int', 'window'=>'resource'], 'ncurses_wrefresh' => ['int', 'window'=>'resource'], 'ncurses_wstandend' => ['int', 'window'=>'resource'], 'ncurses_wstandout' => ['int', 'window'=>'resource'], 'ncurses_wvline' => ['int', 'window'=>'resource', 'charattr'=>'int', 'n'=>'int'], 'net_get_interfaces' => ['array|false'], 'newrelic_add_custom_parameter' => ['bool', 'key'=>'string', 'value'=>''], 'newrelic_add_custom_tracer' => ['bool', 'function_name'=>'string'], 'newrelic_background_job' => ['void', 'flag='=>'bool'], 'newrelic_capture_params' => ['void', 'enable='=>'bool'], 'newrelic_custom_metric' => ['bool', 'metric_name'=>'string', 'value'=>'float'], 'newrelic_disable_autorum' => ['bool'], 'newrelic_end_of_transaction' => ['void'], 'newrelic_end_transaction' => ['bool', 'ignore='=>'bool'], 'newrelic_get_browser_timing_footer' => ['string', 'include_tags='=>'bool'], 'newrelic_get_browser_timing_header' => ['string', 'include_tags='=>'bool'], 'newrelic_ignore_apdex' => ['void'], 'newrelic_ignore_transaction' => ['void'], 'newrelic_name_transaction' => ['bool', 'name'=>'string'], 'newrelic_notice_error' => ['void', 'message'=>'string', 'exception='=>'Exception|Throwable'], 'newrelic_notice_error\'1' => ['void', 'unused_1'=>'string', 'message'=>'string', 'unused_2'=>'string', 'unused_3'=>'int', 'unused_4='=>''], 'newrelic_record_custom_event' => ['void', 'name'=>'string', 'attributes'=>'array'], 'newrelic_record_datastore_segment' => ['mixed', 'func'=>'callable', 'parameters'=>'array'], 'newrelic_set_appname' => ['bool', 'name'=>'string', 'license='=>'string', 'xmit='=>'bool'], 'newrelic_set_user_attributes' => ['bool', 'user'=>'string', 'account'=>'string', 'product'=>'string'], 'newrelic_start_transaction' => ['bool', 'appname'=>'string', 'license='=>'string'], 'newt_bell' => ['void'], 'newt_button' => ['resource', 'left'=>'int', 'top'=>'int', 'text'=>'string'], 'newt_button_bar' => ['resource', 'buttons'=>'array'], 'newt_centered_window' => ['int', 'width'=>'int', 'height'=>'int', 'title='=>'string'], 'newt_checkbox' => ['resource', 'left'=>'int', 'top'=>'int', 'text'=>'string', 'def_value'=>'string', 'seq='=>'string'], 'newt_checkbox_get_value' => ['string', 'checkbox'=>'resource'], 'newt_checkbox_set_flags' => ['void', 'checkbox'=>'resource', 'flags'=>'int', 'sense'=>'int'], 'newt_checkbox_set_value' => ['void', 'checkbox'=>'resource', 'value'=>'string'], 'newt_checkbox_tree' => ['resource', 'left'=>'int', 'top'=>'int', 'height'=>'int', 'flags='=>'int'], 'newt_checkbox_tree_add_item' => ['void', 'checkboxtree'=>'resource', 'text'=>'string', 'data'=>'mixed', 'flags'=>'int', 'index'=>'int', '...args='=>'int'], 'newt_checkbox_tree_find_item' => ['array', 'checkboxtree'=>'resource', 'data'=>'mixed'], 'newt_checkbox_tree_get_current' => ['mixed', 'checkboxtree'=>'resource'], 'newt_checkbox_tree_get_entry_value' => ['string', 'checkboxtree'=>'resource', 'data'=>'mixed'], 'newt_checkbox_tree_get_multi_selection' => ['array', 'checkboxtree'=>'resource', 'seqnum'=>'string'], 'newt_checkbox_tree_get_selection' => ['array', 'checkboxtree'=>'resource'], 'newt_checkbox_tree_multi' => ['resource', 'left'=>'int', 'top'=>'int', 'height'=>'int', 'seq'=>'string', 'flags='=>'int'], 'newt_checkbox_tree_set_current' => ['void', 'checkboxtree'=>'resource', 'data'=>'mixed'], 'newt_checkbox_tree_set_entry' => ['void', 'checkboxtree'=>'resource', 'data'=>'mixed', 'text'=>'string'], 'newt_checkbox_tree_set_entry_value' => ['void', 'checkboxtree'=>'resource', 'data'=>'mixed', 'value'=>'string'], 'newt_checkbox_tree_set_width' => ['void', 'checkbox_tree'=>'resource', 'width'=>'int'], 'newt_clear_key_buffer' => ['void'], 'newt_cls' => ['void'], 'newt_compact_button' => ['resource', 'left'=>'int', 'top'=>'int', 'text'=>'string'], 'newt_component_add_callback' => ['void', 'component'=>'resource', 'func_name'=>'mixed', 'data'=>'mixed'], 'newt_component_takes_focus' => ['void', 'component'=>'resource', 'takes_focus'=>'bool'], 'newt_create_grid' => ['resource', 'cols'=>'int', 'rows'=>'int'], 'newt_cursor_off' => ['void'], 'newt_cursor_on' => ['void'], 'newt_delay' => ['void', 'microseconds'=>'int'], 'newt_draw_form' => ['void', 'form'=>'resource'], 'newt_draw_root_text' => ['void', 'left'=>'int', 'top'=>'int', 'text'=>'string'], 'newt_entry' => ['resource', 'left'=>'int', 'top'=>'int', 'width'=>'int', 'init_value='=>'string', 'flags='=>'int'], 'newt_entry_get_value' => ['string', 'entry'=>'resource'], 'newt_entry_set' => ['void', 'entry'=>'resource', 'value'=>'string', 'cursor_at_end='=>'bool'], 'newt_entry_set_filter' => ['void', 'entry'=>'resource', 'filter'=>'callable', 'data'=>'mixed'], 'newt_entry_set_flags' => ['void', 'entry'=>'resource', 'flags'=>'int', 'sense'=>'int'], 'newt_finished' => ['int'], 'newt_form' => ['resource', 'vert_bar='=>'resource', 'help='=>'string', 'flags='=>'int'], 'newt_form_add_component' => ['void', 'form'=>'resource', 'component'=>'resource'], 'newt_form_add_components' => ['void', 'form'=>'resource', 'components'=>'array'], 'newt_form_add_hot_key' => ['void', 'form'=>'resource', 'key'=>'int'], 'newt_form_destroy' => ['void', 'form'=>'resource'], 'newt_form_get_current' => ['resource', 'form'=>'resource'], 'newt_form_run' => ['void', 'form'=>'resource', 'exit_struct'=>'array'], 'newt_form_set_background' => ['void', 'from'=>'resource', 'background'=>'int'], 'newt_form_set_height' => ['void', 'form'=>'resource', 'height'=>'int'], 'newt_form_set_size' => ['void', 'form'=>'resource'], 'newt_form_set_timer' => ['void', 'form'=>'resource', 'milliseconds'=>'int'], 'newt_form_set_width' => ['void', 'form'=>'resource', 'width'=>'int'], 'newt_form_watch_fd' => ['void', 'form'=>'resource', 'stream'=>'resource', 'flags='=>'int'], 'newt_get_screen_size' => ['void', 'cols'=>'int', 'rows'=>'int'], 'newt_grid_add_components_to_form' => ['void', 'grid'=>'resource', 'form'=>'resource', 'recurse'=>'bool'], 'newt_grid_basic_window' => ['resource', 'text'=>'resource', 'middle'=>'resource', 'buttons'=>'resource'], 'newt_grid_free' => ['void', 'grid'=>'resource', 'recurse'=>'bool'], 'newt_grid_get_size' => ['void', 'grid'=>'resource', 'width'=>'int', 'height'=>'int'], 'newt_grid_h_close_stacked' => ['resource', 'element1_type'=>'int', 'element1'=>'resource', '...args='=>'resource'], 'newt_grid_h_stacked' => ['resource', 'element1_type'=>'int', 'element1'=>'resource', '...args='=>'resource'], 'newt_grid_place' => ['void', 'grid'=>'resource', 'left'=>'int', 'top'=>'int'], 'newt_grid_set_field' => ['void', 'grid'=>'resource', 'col'=>'int', 'row'=>'int', 'type'=>'int', 'val'=>'resource', 'pad_left'=>'int', 'pad_top'=>'int', 'pad_right'=>'int', 'pad_bottom'=>'int', 'anchor'=>'int', 'flags='=>'int'], 'newt_grid_simple_window' => ['resource', 'text'=>'resource', 'middle'=>'resource', 'buttons'=>'resource'], 'newt_grid_v_close_stacked' => ['resource', 'element1_type'=>'int', 'element1'=>'resource', '...args='=>'resource'], 'newt_grid_v_stacked' => ['resource', 'element1_type'=>'int', 'element1'=>'resource', '...args='=>'resource'], 'newt_grid_wrapped_window' => ['void', 'grid'=>'resource', 'title'=>'string'], 'newt_grid_wrapped_window_at' => ['void', 'grid'=>'resource', 'title'=>'string', 'left'=>'int', 'top'=>'int'], 'newt_init' => ['int'], 'newt_label' => ['resource', 'left'=>'int', 'top'=>'int', 'text'=>'string'], 'newt_label_set_text' => ['void', 'label'=>'resource', 'text'=>'string'], 'newt_listbox' => ['resource', 'left'=>'int', 'top'=>'int', 'height'=>'int', 'flags='=>'int'], 'newt_listbox_append_entry' => ['void', 'listbox'=>'resource', 'text'=>'string', 'data'=>'mixed'], 'newt_listbox_clear' => ['void', 'listobx'=>'resource'], 'newt_listbox_clear_selection' => ['void', 'listbox'=>'resource'], 'newt_listbox_delete_entry' => ['void', 'listbox'=>'resource', 'key'=>'mixed'], 'newt_listbox_get_current' => ['string', 'listbox'=>'resource'], 'newt_listbox_get_selection' => ['array', 'listbox'=>'resource'], 'newt_listbox_insert_entry' => ['void', 'listbox'=>'resource', 'text'=>'string', 'data'=>'mixed', 'key'=>'mixed'], 'newt_listbox_item_count' => ['int', 'listbox'=>'resource'], 'newt_listbox_select_item' => ['void', 'listbox'=>'resource', 'key'=>'mixed', 'sense'=>'int'], 'newt_listbox_set_current' => ['void', 'listbox'=>'resource', 'num'=>'int'], 'newt_listbox_set_current_by_key' => ['void', 'listbox'=>'resource', 'key'=>'mixed'], 'newt_listbox_set_data' => ['void', 'listbox'=>'resource', 'num'=>'int', 'data'=>'mixed'], 'newt_listbox_set_entry' => ['void', 'listbox'=>'resource', 'num'=>'int', 'text'=>'string'], 'newt_listbox_set_width' => ['void', 'listbox'=>'resource', 'width'=>'int'], 'newt_listitem' => ['resource', 'left'=>'int', 'top'=>'int', 'text'=>'string', 'is_default'=>'bool', 'prev_item'=>'resource', 'data'=>'mixed', 'flags='=>'int'], 'newt_listitem_get_data' => ['mixed', 'item'=>'resource'], 'newt_listitem_set' => ['void', 'item'=>'resource', 'text'=>'string'], 'newt_open_window' => ['int', 'left'=>'int', 'top'=>'int', 'width'=>'int', 'height'=>'int', 'title='=>'string'], 'newt_pop_help_line' => ['void'], 'newt_pop_window' => ['void'], 'newt_push_help_line' => ['void', 'text='=>'string'], 'newt_radio_get_current' => ['resource', 'set_member'=>'resource'], 'newt_radiobutton' => ['resource', 'left'=>'int', 'top'=>'int', 'text'=>'string', 'is_default'=>'bool', 'prev_button='=>'resource'], 'newt_redraw_help_line' => ['void'], 'newt_reflow_text' => ['string', 'text'=>'string', 'width'=>'int', 'flex_down'=>'int', 'flex_up'=>'int', 'actual_width'=>'int', 'actual_height'=>'int'], 'newt_refresh' => ['void'], 'newt_resize_screen' => ['void', 'redraw='=>'bool'], 'newt_resume' => ['void'], 'newt_run_form' => ['resource', 'form'=>'resource'], 'newt_scale' => ['resource', 'left'=>'int', 'top'=>'int', 'width'=>'int', 'full_value'=>'int'], 'newt_scale_set' => ['void', 'scale'=>'resource', 'amount'=>'int'], 'newt_scrollbar_set' => ['void', 'scrollbar'=>'resource', 'where'=>'int', 'total'=>'int'], 'newt_set_help_callback' => ['void', 'function'=>'mixed'], 'newt_set_suspend_callback' => ['void', 'function'=>'callable', 'data'=>'mixed'], 'newt_suspend' => ['void'], 'newt_textbox' => ['resource', 'left'=>'int', 'top'=>'int', 'width'=>'int', 'height'=>'int', 'flags='=>'int'], 'newt_textbox_get_num_lines' => ['int', 'textbox'=>'resource'], 'newt_textbox_reflowed' => ['resource', 'left'=>'int', 'top'=>'int', 'text'=>'char', 'width'=>'int', 'flex_down'=>'int', 'flex_up'=>'int', 'flags='=>'int'], 'newt_textbox_set_height' => ['void', 'textbox'=>'resource', 'height'=>'int'], 'newt_textbox_set_text' => ['void', 'textbox'=>'resource', 'text'=>'string'], 'newt_vertical_scrollbar' => ['resource', 'left'=>'int', 'top'=>'int', 'height'=>'int', 'normal_colorset='=>'int', 'thumb_colorset='=>'int'], 'newt_wait_for_key' => ['void'], 'newt_win_choice' => ['int', 'title'=>'string', 'button1_text'=>'string', 'button2_text'=>'string', 'format'=>'string', 'args='=>'mixed', '...args='=>'mixed'], 'newt_win_entries' => ['int', 'title'=>'string', 'text'=>'string', 'suggested_width'=>'int', 'flex_down'=>'int', 'flex_up'=>'int', 'data_width'=>'int', 'items'=>'array', 'button1'=>'string', '...args='=>'string'], 'newt_win_menu' => ['int', 'title'=>'string', 'text'=>'string', 'suggestedwidth'=>'int', 'flexdown'=>'int', 'flexup'=>'int', 'maxlistheight'=>'int', 'items'=>'array', 'listitem'=>'int', 'button1='=>'string', '...args='=>'string'], 'newt_win_message' => ['void', 'title'=>'string', 'button_text'=>'string', 'format'=>'string', 'args='=>'mixed', '...args='=>'mixed'], 'newt_win_messagev' => ['void', 'title'=>'string', 'button_text'=>'string', 'format'=>'string', 'args'=>'array'], 'newt_win_ternary' => ['int', 'title'=>'string', 'button1_text'=>'string', 'button2_text'=>'string', 'button3_text'=>'string', 'format'=>'string', 'args='=>'mixed', '...args='=>'mixed'], 'next' => ['mixed', '&rw_array_arg'=>'array|object'], 'ngettext' => ['string', 'msgid1'=>'string', 'msgid2'=>'string', 'n'=>'int'], 'nl2br' => ['string', 'str'=>'string', 'is_xhtml='=>'bool'], 'nl_langinfo' => ['string|false', 'item'=>'int'], 'NoRewindIterator::__construct' => ['void', 'iterator'=>'Iterator'], 'NoRewindIterator::current' => ['mixed'], 'NoRewindIterator::getInnerIterator' => ['Iterator'], 'NoRewindIterator::key' => ['mixed'], 'NoRewindIterator::next' => ['void'], 'NoRewindIterator::rewind' => ['void'], 'NoRewindIterator::valid' => ['bool'], 'Normalizer::getRawDecomposition' => ['string|null', 'input'=>'string'], 'Normalizer::isNormalized' => ['bool', 'input'=>'string', 'form='=>'int'], 'Normalizer::normalize' => ['string|false', 'input'=>'string', 'form='=>'int'], 'normalizer_get_raw_decomposition' => ['string|null', 'input'=>'string'], 'normalizer_is_normalized' => ['bool', 'input'=>'string', 'form='=>'int'], 'normalizer_normalize' => ['string|false', 'input'=>'string', 'form='=>'int'], 'notes_body' => ['array', 'server'=>'string', 'mailbox'=>'string', 'msg_number'=>'int'], 'notes_copy_db' => ['bool', 'from_database_name'=>'string', 'to_database_name'=>'string'], 'notes_create_db' => ['bool', 'database_name'=>'string'], 'notes_create_note' => ['bool', 'database_name'=>'string', 'form_name'=>'string'], 'notes_drop_db' => ['bool', 'database_name'=>'string'], 'notes_find_note' => ['int', 'database_name'=>'string', 'name'=>'string', 'type='=>'string'], 'notes_header_info' => ['object', 'server'=>'string', 'mailbox'=>'string', 'msg_number'=>'int'], 'notes_list_msgs' => ['bool', 'db'=>'string'], 'notes_mark_read' => ['bool', 'database_name'=>'string', 'user_name'=>'string', 'note_id'=>'string'], 'notes_mark_unread' => ['bool', 'database_name'=>'string', 'user_name'=>'string', 'note_id'=>'string'], 'notes_nav_create' => ['bool', 'database_name'=>'string', 'name'=>'string'], 'notes_search' => ['array', 'database_name'=>'string', 'keywords'=>'string'], 'notes_unread' => ['array', 'database_name'=>'string', 'user_name'=>'string'], 'notes_version' => ['float', 'database_name'=>'string'], 'nsapi_request_headers' => ['array'], 'nsapi_response_headers' => ['array'], 'nsapi_virtual' => ['bool', 'uri'=>'string'], 'nthmac' => ['string', 'clent'=>'string', 'data'=>'string'], 'number_format' => ['non-empty-string', 'number'=>'float', 'num_decimal_places='=>'int', 'dec_separator='=>'string|null', 'thousands_separator='=>'string|null'], 'NumberFormatter::__construct' => ['void', 'locale'=>'string', 'style'=>'int', 'pattern='=>'string'], 'NumberFormatter::create' => ['NumberFormatter', 'locale'=>'string', 'style'=>'int', 'pattern='=>'string'], 'NumberFormatter::format' => ['string|false', 'num'=>'', 'type='=>'int'], 'NumberFormatter::formatCurrency' => ['string|false', 'num'=>'float', 'currency'=>'string'], 'NumberFormatter::getAttribute' => ['int', 'attr'=>'int'], 'NumberFormatter::getErrorCode' => ['int'], 'NumberFormatter::getErrorMessage' => ['string'], 'NumberFormatter::getLocale' => ['string', 'type='=>'int'], 'NumberFormatter::getPattern' => ['string'], 'NumberFormatter::getSymbol' => ['string', 'attr'=>'int'], 'NumberFormatter::getTextAttribute' => ['string', 'attr'=>'int'], 'NumberFormatter::parse' => ['float|false', 'str'=>'string', 'type='=>'int', '&rw_position='=>'int'], 'NumberFormatter::parseCurrency' => ['float|false', 'str'=>'string', '&w_currency'=>'string', '&rw_position='=>'int'], 'NumberFormatter::setAttribute' => ['bool', 'attr'=>'int', 'value'=>''], 'NumberFormatter::setPattern' => ['bool', 'pattern'=>'string'], 'NumberFormatter::setSymbol' => ['bool', 'attr'=>'int', 'symbol'=>'string'], 'NumberFormatter::setTextAttribute' => ['bool', 'attr'=>'int', 'value'=>'string'], 'numfmt_create' => ['NumberFormatter', 'locale'=>'string', 'style'=>'int', 'pattern='=>'string'], 'numfmt_format' => ['string|false', 'fmt'=>'numberformatter', 'value='=>'float', 'type='=>'int'], 'numfmt_format_currency' => ['string|false', 'fmt'=>'numberformatter', 'value'=>'float', 'currency'=>'string'], 'numfmt_get_attribute' => ['int|false', 'fmt'=>'numberformatter', 'attr'=>'int'], 'numfmt_get_error_code' => ['int', 'fmt'=>'numberformatter'], 'numfmt_get_error_message' => ['string', 'fmt'=>'numberformatter'], 'numfmt_get_locale' => ['string|false', 'fmt'=>'numberformatter', 'type='=>'int'], 'numfmt_get_pattern' => ['string|false', 'fmt'=>'numberformatter'], 'numfmt_get_symbol' => ['string|false', 'fmt'=>'numberformatter', 'attr'=>'int'], 'numfmt_get_text_attribute' => ['string|false', 'fmt'=>'numberformatter', 'attr'=>'int'], 'numfmt_parse' => ['float|false', 'fmt'=>'numberformatter', 'value'=>'string', 'type='=>'int', '&rw_position='=>'int'], 'numfmt_parse_currency' => ['float|false', 'fmt'=>'numberformatter', 'value'=>'string', '&w_currency'=>'string', '&rw_position='=>'int'], 'numfmt_set_attribute' => ['bool', 'fmt'=>'numberformatter', 'attr'=>'int', 'value'=>'int'], 'numfmt_set_pattern' => ['bool', 'fmt'=>'numberformatter', 'pattern'=>'string'], 'numfmt_set_symbol' => ['bool', 'fmt'=>'numberformatter', 'attr'=>'int', 'value'=>'string'], 'numfmt_set_text_attribute' => ['bool', 'fmt'=>'numberformatter', 'attr'=>'int', 'value'=>'string'], 'OAuth::__construct' => ['void', 'consumer_key'=>'string', 'consumer_secret'=>'string', 'signature_method='=>'string', 'auth_type='=>'int'], 'OAuth::__destruct' => [''], 'OAuth::disableDebug' => ['bool'], 'OAuth::disableRedirects' => ['bool'], 'OAuth::disableSSLChecks' => ['bool'], 'OAuth::enableDebug' => ['bool'], 'OAuth::enableRedirects' => ['bool'], 'OAuth::enableSSLChecks' => ['bool'], 'OAuth::fetch' => ['mixed', 'protected_resource_url'=>'string', 'extra_parameters='=>'array', 'http_method='=>'string', 'http_headers='=>'array'], 'OAuth::generateSignature' => ['string', 'http_method'=>'string', 'url'=>'string', 'extra_parameters='=>'mixed'], 'OAuth::getAccessToken' => ['array|false', 'access_token_url'=>'string', 'auth_session_handle='=>'string', 'verifier_token='=>'string'], 'OAuth::getCAPath' => ['array'], 'OAuth::getLastResponse' => ['string'], 'OAuth::getLastResponseHeaders' => ['string|false'], 'OAuth::getLastResponseInfo' => ['array'], 'OAuth::getRequestHeader' => ['string|false', 'http_method'=>'string', 'url'=>'string', 'extra_parameters='=>'mixed'], 'OAuth::getRequestToken' => ['array|false', 'request_token_url'=>'string', 'callback_url='=>'string'], 'OAuth::setAuthType' => ['bool', 'auth_type'=>'int'], 'OAuth::setCAPath' => ['mixed', 'ca_path='=>'string', 'ca_info='=>'string'], 'OAuth::setNonce' => ['mixed', 'nonce'=>'string'], 'OAuth::setRequestEngine' => ['void', 'reqengine'=>'int'], 'OAuth::setRSACertificate' => ['mixed', 'cert'=>'string'], 'OAuth::setSSLChecks' => ['bool', 'sslcheck'=>'int'], 'OAuth::setTimestamp' => ['mixed', 'timestamp'=>'string'], 'OAuth::setToken' => ['bool', 'token'=>'string', 'token_secret'=>'string'], 'OAuth::setVersion' => ['bool', 'version'=>'string'], 'oauth_get_sbs' => ['string', 'http_method'=>'string', 'uri'=>'string', 'request_parameters='=>'array'], 'oauth_urlencode' => ['string', 'uri'=>'string'], 'OAuthProvider::__construct' => ['void', 'params_array='=>'array'], 'OAuthProvider::addRequiredParameter' => ['bool', 'req_params'=>'string'], 'OAuthProvider::callconsumerHandler' => ['void'], 'OAuthProvider::callTimestampNonceHandler' => ['void'], 'OAuthProvider::calltokenHandler' => ['void'], 'OAuthProvider::checkOAuthRequest' => ['void', 'uri='=>'string', 'method='=>'string'], 'OAuthProvider::consumerHandler' => ['void', 'callback_function'=>'callable'], 'OAuthProvider::generateToken' => ['string', 'size'=>'int', 'strong='=>'bool'], 'OAuthProvider::is2LeggedEndpoint' => ['void', 'params_array'=>'mixed'], 'OAuthProvider::isRequestTokenEndpoint' => ['void', 'will_issue_request_token'=>'bool'], 'OAuthProvider::removeRequiredParameter' => ['bool', 'req_params'=>'string'], 'OAuthProvider::reportProblem' => ['string', 'oauthexception'=>'string', 'send_headers='=>'bool'], 'OAuthProvider::setParam' => ['bool', 'param_key'=>'string', 'param_val='=>'mixed'], 'OAuthProvider::setRequestTokenPath' => ['bool', 'path'=>'string'], 'OAuthProvider::timestampNonceHandler' => ['void', 'callback_function'=>'callable'], 'OAuthProvider::tokenHandler' => ['void', 'callback_function'=>'callable'], 'ob_clean' => ['bool'], 'ob_deflatehandler' => ['string', 'data'=>'string', 'mode'=>'int'], 'ob_end_clean' => ['bool'], 'ob_end_flush' => ['bool'], 'ob_etaghandler' => ['string', 'data'=>'string', 'mode'=>'int'], 'ob_flush' => ['bool'], 'ob_get_clean' => ['string|false'], 'ob_get_contents' => ['string|false'], 'ob_get_flush' => ['string|false'], 'ob_get_length' => ['int|false'], 'ob_get_level' => ['int'], 'ob_get_status' => ['array', 'full_status='=>'bool'], 'ob_gzhandler' => ['string|false', 'data'=>'string', 'flags'=>'int'], 'ob_iconv_handler' => ['string', 'contents'=>'string', 'status'=>'int'], 'ob_implicit_flush' => ['void', 'flag='=>'int'], 'ob_inflatehandler' => ['string', 'data'=>'string', 'mode'=>'int'], 'ob_list_handlers' => ['false|list<string>'], 'ob_start' => ['bool', 'user_function='=>'string|array|callable|null', 'chunk_size='=>'int', 'flags='=>'int'], 'ob_tidyhandler' => ['string', 'input'=>'string', 'mode='=>'int'], 'OCI-Collection::append' => ['bool', 'value'=>'mixed'], 'OCI-Collection::assign' => ['bool', 'from'=>'OCI-Collection'], 'OCI-Collection::assignElem' => ['bool', 'index'=>'int', 'value'=>''], 'OCI-Collection::assignelem' => ['bool', 'index'=>'int', 'value'=>'mixed'], 'OCI-Collection::free' => ['bool'], 'OCI-Collection::getElem' => ['', 'index'=>'int'], 'OCI-Collection::getelem' => ['mixed', 'index'=>'int'], 'OCI-Collection::max' => ['int'], 'OCI-Collection::size' => ['int'], 'OCI-Collection::trim' => ['bool', 'num'=>'int'], 'OCI-Lob::append' => ['bool', 'lob_from'=>'OCI-Lob'], 'OCI-Lob::close' => ['bool'], 'OCI-Lob::eof' => ['bool'], 'OCI-Lob::erase' => ['int', 'offset='=>'int', 'length='=>'int'], 'OCI-Lob::export' => ['bool', 'filename'=>'string', 'start='=>'int', 'length='=>'int'], 'OCI-Lob::flush' => ['bool', 'flag='=>'int'], 'OCI-Lob::free' => ['bool'], 'OCI-Lob::getBuffering' => ['bool'], 'OCI-Lob::getbuffering' => ['bool'], 'OCI-Lob::import' => ['bool', 'filename'=>'string'], 'OCI-Lob::load' => ['string'], 'OCI-Lob::read' => ['string', 'length'=>'int'], 'OCI-Lob::rewind' => ['bool'], 'OCI-Lob::save' => ['bool', 'data'=>'string', 'offset='=>'int'], 'OCI-Lob::savefile' => ['bool', 'filename'=>''], 'OCI-Lob::seek' => ['bool', 'offset'=>'int', 'whence='=>'int'], 'OCI-Lob::setBuffering' => ['bool', 'on_off'=>'bool'], 'OCI-Lob::setbuffering' => ['bool', 'on_off'=>'bool'], 'OCI-Lob::size' => ['int'], 'OCI-Lob::tell' => ['int'], 'OCI-Lob::truncate' => ['bool', 'length='=>'int'], 'OCI-Lob::write' => ['int', 'data'=>'string', 'length='=>'int'], 'OCI-Lob::writeTemporary' => ['bool', 'data'=>'string', 'lob_type='=>'int'], 'OCI-Lob::writetofile' => ['bool', 'filename'=>'', 'start'=>'', 'length'=>''], 'oci_bind_array_by_name' => ['bool', 'stmt'=>'resource', 'name'=>'string', '&rw_var'=>'array', 'max_table_length'=>'int', 'max_item_length='=>'int', 'type='=>'int'], 'oci_bind_by_name' => ['bool', 'stmt'=>'resource', 'name'=>'string', '&rw_var'=>'mixed', 'maxlength='=>'int', 'type='=>'int'], 'oci_cancel' => ['bool', 'stmt'=>'resource'], 'oci_client_version' => ['string'], 'oci_close' => ['bool', 'connection'=>'resource'], 'oci_collection_append' => ['bool', 'value'=>'string'], 'oci_collection_assign' => ['bool', 'from'=>'OCI-Collection'], 'oci_collection_element_assign' => ['bool', 'index'=>'int', 'val'=>'string'], 'oci_collection_element_get' => ['string|false', 'ndx'=>'int'], 'oci_collection_max' => ['int|false'], 'oci_collection_size' => ['int|false'], 'oci_collection_trim' => ['bool', 'num'=>'int'], 'oci_commit' => ['bool', 'connection'=>'resource'], 'oci_connect' => ['resource|false', 'user'=>'string', 'pass'=>'string', 'db='=>'string', 'charset='=>'string', 'session_mode='=>'int'], 'oci_define_by_name' => ['bool', 'stmt'=>'resource', 'name'=>'string', '&w_var'=>'mixed', 'type='=>'int'], 'oci_error' => ['array|false', 'resource='=>'resource'], 'oci_execute' => ['bool', 'stmt'=>'resource', 'mode='=>'int'], 'oci_fetch' => ['bool', 'stmt'=>'resource'], 'oci_fetch_all' => ['int|false', 'stmt'=>'resource', '&w_output'=>'array', 'skip='=>'int', 'maxrows='=>'int', 'flags='=>'int'], 'oci_fetch_array' => ['array|false', 'stmt'=>'resource', 'mode='=>'int'], 'oci_fetch_assoc' => ['array|false', 'stmt'=>'resource'], 'oci_fetch_object' => ['object|false', 'stmt'=>'resource'], 'oci_fetch_row' => ['array|false', 'stmt'=>'resource'], 'oci_field_is_null' => ['bool', 'stmt'=>'resource', 'col'=>'mixed'], 'oci_field_name' => ['string|false', 'stmt'=>'resource', 'col'=>'mixed'], 'oci_field_precision' => ['int|false', 'stmt'=>'resource', 'col'=>'mixed'], 'oci_field_scale' => ['int|false', 'stmt'=>'resource', 'col'=>'mixed'], 'oci_field_size' => ['int|false', 'stmt'=>'resource', 'col'=>'mixed'], 'oci_field_type' => ['mixed', 'stmt'=>'resource', 'col'=>'mixed'], 'oci_field_type_raw' => ['int|false', 'stmt'=>'resource', 'col'=>'mixed'], 'oci_free_collection' => ['bool'], 'oci_free_cursor' => ['bool', 'stmt'=>'resource'], 'oci_free_descriptor' => ['bool'], 'oci_free_statement' => ['bool', 'stmt'=>'resource'], 'oci_get_implicit' => ['bool', 'stmt'=>''], 'oci_get_implicit_resultset' => ['resource|false', 'statement'=>'resource'], 'oci_internal_debug' => ['void', 'onoff'=>'bool'], 'oci_lob_append' => ['bool', 'lob'=>'OCI-Lob'], 'oci_lob_close' => ['bool'], 'oci_lob_copy' => ['bool', 'lob_to'=>'OCI-Lob', 'lob_from'=>'OCI-Lob', 'length='=>'int'], 'oci_lob_eof' => ['bool'], 'oci_lob_erase' => ['int|false', 'offset'=>'int', 'length'=>'int'], 'oci_lob_export' => ['bool', 'filename'=>'string', 'start'=>'int', 'length'=>'int'], 'oci_lob_flush' => ['bool', 'flag'=>'int'], 'oci_lob_import' => ['bool', 'filename'=>'string'], 'oci_lob_is_equal' => ['bool', 'lob1'=>'OCI-Lob', 'lob2'=>'OCI-Lob'], 'oci_lob_load' => ['string|false'], 'oci_lob_read' => ['string|false', 'length'=>'int'], 'oci_lob_rewind' => ['bool'], 'oci_lob_save' => ['bool', 'data'=>'string', 'offset'=>'int'], 'oci_lob_seek' => ['bool', 'offset'=>'int', 'whence'=>'int'], 'oci_lob_size' => ['int|false'], 'oci_lob_tell' => ['int|false'], 'oci_lob_truncate' => ['bool', 'length'=>'int'], 'oci_lob_write' => ['int|false', 'string'=>'string', 'length'=>'int'], 'oci_lob_write_temporary' => ['bool', 'var'=>'string', 'lob_type'=>'int'], 'oci_new_collection' => ['OCI-Collection|false', 'connection'=>'resource', 'tdo'=>'string', 'schema='=>'string'], 'oci_new_connect' => ['resource|false', 'user'=>'string', 'pass'=>'string', 'db='=>'string', 'charset='=>'string', 'session_mode='=>'int'], 'oci_new_cursor' => ['resource|false', 'connection'=>'resource'], 'oci_new_descriptor' => ['OCI-Lob|false', 'connection'=>'resource', 'type='=>'int'], 'oci_num_fields' => ['0|positive-int|false', 'stmt'=>'resource'], 'oci_num_rows' => ['0|positive-int|false', 'stmt'=>'resource'], 'oci_parse' => ['resource|false', 'connection'=>'resource', 'statement'=>'string'], 'oci_password_change' => ['bool', 'connection'=>'', 'username'=>'string', 'old_password'=>'string', 'new_password'=>'string'], 'oci_pconnect' => ['resource|false', 'user'=>'string', 'pass'=>'string', 'db='=>'string', 'charset='=>'string', 'session_mode='=>'int'], 'oci_register_taf_callback' => ['bool', 'connection'=>'resource', 'callback='=>'callable'], 'oci_result' => ['string|false', 'stmt'=>'resource', 'column'=>'mixed'], 'oci_rollback' => ['bool', 'connection'=>'resource'], 'oci_server_version' => ['string|false', 'connection'=>'resource'], 'oci_set_action' => ['bool', 'connection'=>'resource', 'value'=>'string'], 'oci_set_client_identifier' => ['bool', 'connection'=>'resource', 'value'=>'string'], 'oci_set_client_info' => ['bool', 'connection'=>'resource', 'value'=>'string'], 'oci_set_db_operation' => ['bool', 'connection'=>'resource', 'value'=>'string'], 'oci_set_edition' => ['bool', 'value'=>'string'], 'oci_set_module_name' => ['bool', 'connection'=>'resource', 'value'=>'string'], 'oci_set_prefetch' => ['bool', 'stmt'=>'resource', 'prefetch_rows'=>'int'], 'oci_statement_type' => ['string|false', 'stmt'=>'resource'], 'oci_unregister_taf_callback' => ['bool', 'connection'=>'resource'], 'ocifetchinto' => ['int|false', 'stmt'=>'', '&w_output'=>'array', 'mode='=>'int'], 'ocigetbufferinglob' => ['bool'], 'ocisetbufferinglob' => ['bool', 'flag'=>'bool'], 'octdec' => ['int|float', 'octal_number'=>'string'], 'odbc_autocommit' => ['mixed', 'connection_id'=>'resource', 'onoff='=>'bool'], 'odbc_binmode' => ['bool', 'result_id'=>'int', 'mode'=>'int'], 'odbc_close' => ['void', 'connection_id'=>'resource'], 'odbc_close_all' => ['void'], 'odbc_columnprivileges' => ['resource', 'connection_id'=>'resource', 'catalog'=>'string', 'schema'=>'string', 'table'=>'string', 'column'=>'string'], 'odbc_columns' => ['resource', 'connection_id'=>'resource', 'qualifier='=>'string', 'owner='=>'string', 'table_name='=>'string', 'column_name='=>'string'], 'odbc_commit' => ['bool', 'connection_id'=>'resource'], 'odbc_connect' => ['resource|false', 'dsn'=>'string', 'user'=>'string', 'password'=>'string', 'cursor_option='=>'int'], 'odbc_cursor' => ['string|false', 'result_id'=>'resource'], 'odbc_data_source' => ['array|false', 'connection_id'=>'resource', 'fetch_type'=>'int'], 'odbc_do' => ['resource', 'connection_id'=>'resource', 'query'=>'string', 'flags='=>'int'], 'odbc_error' => ['string', 'connection_id='=>'resource'], 'odbc_errormsg' => ['string', 'connection_id='=>'resource'], 'odbc_exec' => ['resource|false', 'connection_id'=>'resource', 'query'=>'string', 'flags='=>'int'], 'odbc_execute' => ['bool', 'result_id'=>'resource', 'parameters_array='=>'array'], 'odbc_fetch_array' => ['array|false', 'result'=>'resource', 'rownumber='=>'int'], 'odbc_fetch_into' => ['int|false', 'result_id'=>'resource', '&w_result_array'=>'array', 'rownumber='=>'int'], 'odbc_fetch_object' => ['object|false', 'result'=>'int', 'rownumber='=>'int'], 'odbc_fetch_row' => ['bool', 'result_id'=>'resource', 'row_number='=>'int'], 'odbc_field_len' => ['int|false', 'result_id'=>'resource', 'field_number'=>'int'], 'odbc_field_name' => ['string|false', 'result_id'=>'resource', 'field_number'=>'int'], 'odbc_field_num' => ['int|false', 'result_id'=>'resource', 'field_name'=>'string'], 'odbc_field_precision' => ['int|false', 'result_id'=>'resource', 'field_number'=>'int'], 'odbc_field_scale' => ['int|false', 'result_id'=>'resource', 'field_number'=>'int'], 'odbc_field_type' => ['string|false', 'result_id'=>'resource', 'field_number'=>'int'], 'odbc_foreignkeys' => ['resource', 'connection_id'=>'resource', 'pk_qualifier'=>'string', 'pk_owner'=>'string', 'pk_table'=>'string', 'fk_qualifier'=>'string', 'fk_owner'=>'string', 'fk_table'=>'string'], 'odbc_free_result' => ['bool', 'result_id'=>'resource'], 'odbc_gettypeinfo' => ['resource', 'connection_id'=>'resource', 'data_type='=>'int'], 'odbc_longreadlen' => ['bool', 'result_id'=>'resource', 'length'=>'int'], 'odbc_next_result' => ['bool', 'result_id'=>'resource'], 'odbc_num_fields' => ['int', 'result_id'=>'resource'], 'odbc_num_rows' => ['int', 'result_id'=>'resource'], 'odbc_pconnect' => ['resource', 'dsn'=>'string', 'user'=>'string', 'password'=>'string', 'cursor_option='=>'int'], 'odbc_prepare' => ['resource|false', 'connection_id'=>'resource', 'query'=>'string'], 'odbc_primarykeys' => ['resource', 'connection_id'=>'resource', 'qualifier'=>'string', 'owner'=>'string', 'table'=>'string'], 'odbc_procedurecolumns' => ['resource', 'connection_id'=>'', 'qualifier'=>'string', 'owner'=>'string', 'proc'=>'string', 'column'=>'string'], 'odbc_procedures' => ['resource', 'connection_id'=>'', 'qualifier'=>'string', 'owner'=>'string', 'name'=>'string'], 'odbc_result' => ['mixed', 'result_id'=>'resource', 'field'=>'mixed'], 'odbc_result_all' => ['int|false', 'result_id'=>'resource', 'format='=>'string'], 'odbc_rollback' => ['bool', 'connection_id'=>'resource'], 'odbc_setoption' => ['bool', 'result_id'=>'resource', 'which'=>'int', 'option'=>'int', 'value'=>'int'], 'odbc_specialcolumns' => ['resource', 'connection_id'=>'resource', 'type'=>'int', 'qualifier'=>'string', 'owner'=>'string', 'table'=>'string', 'scope'=>'int', 'nullable'=>'int'], 'odbc_statistics' => ['resource', 'connection_id'=>'resource', 'qualifier'=>'string', 'owner'=>'string', 'name'=>'string', 'unique'=>'int', 'accuracy'=>'int'], 'odbc_tableprivileges' => ['resource', 'connection_id'=>'resource', 'qualifier'=>'string', 'owner'=>'string', 'name'=>'string'], 'odbc_tables' => ['resource', 'connection_id'=>'resource', 'qualifier='=>'string', 'owner='=>'string', 'name='=>'string', 'table_types='=>'string'], 'opcache_compile_file' => ['bool', 'file'=>'string'], 'opcache_get_configuration' => ['array|false'], 'opcache_get_status' => ['array|false', 'get_scripts='=>'bool'], 'opcache_invalidate' => ['bool', 'script'=>'string', 'force='=>'bool'], 'opcache_is_script_cached' => ['bool', 'script'=>'string'], 'opcache_reset' => ['bool'], 'openal_buffer_create' => ['resource'], 'openal_buffer_data' => ['bool', 'buffer'=>'resource', 'format'=>'int', 'data'=>'string', 'freq'=>'int'], 'openal_buffer_destroy' => ['bool', 'buffer'=>'resource'], 'openal_buffer_get' => ['int', 'buffer'=>'resource', 'property'=>'int'], 'openal_buffer_loadwav' => ['bool', 'buffer'=>'resource', 'wavfile'=>'string'], 'openal_context_create' => ['resource', 'device'=>'resource'], 'openal_context_current' => ['bool', 'context'=>'resource'], 'openal_context_destroy' => ['bool', 'context'=>'resource'], 'openal_context_process' => ['bool', 'context'=>'resource'], 'openal_context_suspend' => ['bool', 'context'=>'resource'], 'openal_device_close' => ['bool', 'device'=>'resource'], 'openal_device_open' => ['resource|false', 'device_desc='=>'string'], 'openal_listener_get' => ['mixed', 'property'=>'int'], 'openal_listener_set' => ['bool', 'property'=>'int', 'setting'=>'mixed'], 'openal_source_create' => ['resource'], 'openal_source_destroy' => ['bool', 'source'=>'resource'], 'openal_source_get' => ['mixed', 'source'=>'resource', 'property'=>'int'], 'openal_source_pause' => ['bool', 'source'=>'resource'], 'openal_source_play' => ['bool', 'source'=>'resource'], 'openal_source_rewind' => ['bool', 'source'=>'resource'], 'openal_source_set' => ['bool', 'source'=>'resource', 'property'=>'int', 'setting'=>'mixed'], 'openal_source_stop' => ['bool', 'source'=>'resource'], 'openal_stream' => ['resource', 'source'=>'resource', 'format'=>'int', 'rate'=>'int'], 'opendir' => ['resource|false', 'path'=>'string', 'context='=>'resource'], 'openlog' => ['bool', 'ident'=>'string', 'option'=>'int', 'facility'=>'int'], 'openssl_cipher_iv_length' => ['int|false', 'method'=>'string'], 'openssl_csr_export' => ['bool', 'csr'=>'string|resource', '&w_out'=>'string', 'notext='=>'bool'], 'openssl_csr_export_to_file' => ['bool', 'csr'=>'string|resource', 'outfilename'=>'string', 'notext='=>'bool'], 'openssl_csr_get_public_key' => ['resource|false', 'csr'=>'string|resource', 'use_shortnames='=>'bool'], 'openssl_csr_get_subject' => ['array|false', 'csr'=>'string|resource', 'use_shortnames='=>'bool'], 'openssl_csr_new' => ['resource|false', 'dn'=>'array', '&w_privkey'=>'resource', 'configargs='=>'array', 'extraattribs='=>'array'], 'openssl_csr_sign' => ['resource|false', 'csr'=>'string|resource', 'x509'=>'string|resource|null', 'priv_key'=>'string|resource|array', 'days'=>'int', 'config_args='=>'array', 'serial='=>'int'], 'openssl_decrypt' => ['string|false', 'data'=>'string', 'method'=>'string', 'key'=>'string', 'options='=>'int', 'iv='=>'string', 'tag='=>'string', 'aad='=>'string'], 'openssl_dh_compute_key' => ['string|false', 'pub_key'=>'string', 'dh_key'=>'resource'], 'openssl_digest' => ['string|false', 'data'=>'string', 'method'=>'string', 'raw_output='=>'bool'], 'openssl_encrypt' => ['string|false', 'data'=>'string', 'method'=>'string', 'key'=>'string', 'options='=>'int', 'iv='=>'string', '&w_tag='=>'string', 'aad='=>'string', 'tag_length='=>'int'], 'openssl_error_string' => ['string|false'], 'openssl_free_key' => ['void', 'key_identifier'=>'resource'], 'openssl_get_cert_locations' => ['array<non-falsy-string, string>'], 'openssl_get_cipher_methods' => ['list<string>', 'aliases='=>'bool'], 'openssl_get_curve_names' => ['list<string>|false'], 'openssl_get_md_methods' => ['list<string>', 'aliases='=>'bool'], 'openssl_get_privatekey' => ['resource|false', 'key'=>'string', 'passphrase='=>'string'], 'openssl_get_publickey' => ['resource|false', 'cert'=>'resource|string'], 'openssl_open' => ['bool', 'sealed_data'=>'string', '&w_open_data'=>'string', 'env_key'=>'string', 'priv_key_id'=>'string|array|resource', 'method='=>'string', 'iv='=>'string'], 'openssl_pbkdf2' => ['string|false', 'password'=>'string', 'salt'=>'string', 'key_length'=>'int', 'iterations'=>'int', 'digest_algorithm'=>'string'], 'openssl_pkcs12_export' => ['bool', 'x509'=>'string|resource', '&w_out'=>'string', 'priv_key'=>'string|array|resource', 'pass'=>'string', 'args='=>'array'], 'openssl_pkcs12_export_to_file' => ['bool', 'x509'=>'string|resource', 'filename'=>'string', 'priv_key'=>'string|array|resource', 'pass'=>'string', 'args='=>'array'], 'openssl_pkcs12_read' => ['bool', 'pkcs12'=>'string', '&w_certs'=>'array', 'pass'=>'string'], 'openssl_pkcs7_decrypt' => ['bool', 'infilename'=>'string', 'outfilename'=>'string', 'recipcert'=>'string|resource', 'recipkey='=>'string|resource|array'], 'openssl_pkcs7_encrypt' => ['bool', 'infile'=>'string', 'outfile'=>'string', 'recipcerts'=>'string|resource|array', 'headers'=>'array', 'flags='=>'int', 'cipherid='=>'int'], 'openssl_pkcs7_read' => ['bool', 'infilename'=>'string', '&w_certs'=>'array'], 'openssl_pkcs7_sign' => ['bool', 'infile'=>'string', 'outfile'=>'string', 'signcert'=>'string|resource', 'privkey'=>'string|resource|array', 'headers'=>'array', 'flags='=>'int', 'extracerts='=>'string'], 'openssl_pkcs7_verify' => ['bool|int', 'filename'=>'string', 'flags'=>'int', 'outfilename='=>'string', 'cainfo='=>'array', 'extracerts='=>'string', 'content='=>'string', 'p7bfilename='=>'string'], 'openssl_pkey_derive' => ['string|false', 'pub_key'=>'resource', 'priv_key'=>'resource', 'keylen='=>'int'], 'openssl_pkey_export' => ['bool', 'key'=>'resource', '&w_out'=>'string', 'passphrase='=>'string|null', 'configargs='=>'array'], 'openssl_pkey_export_to_file' => ['bool', 'key'=>'resource|string|array', 'outfilename'=>'string', 'passphrase='=>'string|null', 'configargs='=>'array'], 'openssl_pkey_free' => ['void', 'key'=>'resource'], 'openssl_pkey_get_details' => ['array|false', 'key'=>'resource'], 'openssl_pkey_get_private' => ['resource|false', 'key'=>'string', 'passphrase='=>'string'], 'openssl_pkey_get_public' => ['resource|false', 'certificate'=>'resource|string'], 'openssl_pkey_new' => ['resource|false', 'configargs='=>'array'], 'openssl_private_decrypt' => ['bool', 'data'=>'string', '&w_decrypted'=>'string', 'key'=>'string|resource|array', 'padding='=>'int'], 'openssl_private_encrypt' => ['bool', 'data'=>'string', '&w_crypted'=>'string', 'key'=>'string|resource|array', 'padding='=>'int'], 'openssl_public_decrypt' => ['bool', 'data'=>'string', '&w_decrypted'=>'string', 'key'=>'string|resource', 'padding='=>'int'], 'openssl_public_encrypt' => ['bool', 'data'=>'string', '&w_crypted'=>'string', 'key'=>'string|resource', 'padding='=>'int'], 'openssl_random_pseudo_bytes' => ['string|false', 'length'=>'int', '&w_crypto_strong='=>'bool'], 'openssl_seal' => ['int|false', 'data'=>'string', '&w_sealed_data'=>'string', '&w_env_keys'=>'array', 'pub_key_ids'=>'array', 'method='=>'string', '&w_iv='=>'string'], 'openssl_sign' => ['bool', 'data'=>'string', '&w_signature'=>'string', 'priv_key_id'=>'resource|string', 'signature_alg='=>'int|string'], 'openssl_spki_export' => ['string|null|false', 'spkac'=>'string'], 'openssl_spki_export_challenge' => ['string|null|false', 'spkac'=>'string'], 'openssl_spki_new' => ['string|null|false', 'privkey'=>'resource', 'challenge'=>'string', 'algorithm='=>'int'], 'openssl_spki_verify' => ['bool', 'spkac'=>'string'], 'openssl_verify' => ['-1|0|1|false', 'data'=>'string', 'signature'=>'string', 'pub_key_id'=>'resource|string', 'signature_alg='=>'int|string'], 'openssl_x509_check_private_key' => ['bool', 'cert'=>'string|resource', 'key'=>'string|resource|array'], 'openssl_x509_checkpurpose' => ['bool|int', 'x509cert'=>'string|resource', 'purpose'=>'int', 'cainfo='=>'array', 'untrustedfile='=>'string'], 'openssl_x509_export' => ['bool', 'x509'=>'string|resource', '&w_output'=>'string', 'notext='=>'bool'], 'openssl_x509_export_to_file' => ['bool', 'x509'=>'string|resource', 'outfilename'=>'string', 'notext='=>'bool'], 'openssl_x509_fingerprint' => ['string|false', 'x509'=>'string|resource', 'hash_algorithm='=>'string', 'raw_output='=>'bool'], 'openssl_x509_free' => ['void', 'x509'=>'resource'], 'openssl_x509_parse' => ['array|false', 'x509cert'=>'string|resource', 'shortnames='=>'bool'], 'openssl_x509_read' => ['resource|false', 'x509certdata'=>'string|resource'], 'ord' => ['int<0, 255>', 'character'=>'string'], 'OuterIterator::getInnerIterator' => ['Iterator'], 'OutOfBoundsException::__clone' => ['void'], 'OutOfBoundsException::__construct' => ['void', 'message='=>'string', 'code='=>'int', 'previous='=>'(?Throwable)|(?OutOfBoundsException)'], 'OutOfBoundsException::__toString' => ['string'], 'OutOfBoundsException::getCode' => ['int'], 'OutOfBoundsException::getFile' => ['string'], 'OutOfBoundsException::getLine' => ['int'], 'OutOfBoundsException::getMessage' => ['string'], 'OutOfBoundsException::getPrevious' => ['Throwable|OutOfBoundsException|null'], 'OutOfBoundsException::getTrace' => ['list<array{function:string,line?:int,file?:string,class?:class-string,type?:\'::\'|\'->\',args?:mixed[],object?:object}>'], 'OutOfBoundsException::getTraceAsString' => ['string'], 'OutOfRangeException::__clone' => ['void'], 'OutOfRangeException::__construct' => ['void', 'message='=>'string', 'code='=>'int', 'previous='=>'(?Throwable)|(?OutOfRangeException)'], 'OutOfRangeException::__toString' => ['string'], 'OutOfRangeException::getCode' => ['int'], 'OutOfRangeException::getFile' => ['string'], 'OutOfRangeException::getLine' => ['int'], 'OutOfRangeException::getMessage' => ['string'], 'OutOfRangeException::getPrevious' => ['Throwable|OutOfRangeException|null'], 'OutOfRangeException::getTrace' => ['list<array{function:string,line?:int,file?:string,class?:class-string,type?:\'::\'|\'->\',args?:mixed[],object?:object}>'], 'OutOfRangeException::getTraceAsString' => ['string'], 'output_add_rewrite_var' => ['bool', 'name'=>'string', 'value'=>'string'], 'output_reset_rewrite_vars' => ['bool'], 'OverflowException::__clone' => ['void'], 'OverflowException::__construct' => ['void', 'message='=>'string', 'code='=>'int', 'previous='=>'(?Throwable)|(?OverflowException)'], 'OverflowException::__toString' => ['string'], 'OverflowException::getCode' => ['int'], 'OverflowException::getFile' => ['string'], 'OverflowException::getLine' => ['int'], 'OverflowException::getMessage' => ['string'], 'OverflowException::getPrevious' => ['Throwable|OverflowException|null'], 'OverflowException::getTrace' => ['list<array{function:string,line?:int,file?:string,class?:class-string,type?:\'::\'|\'->\',args?:mixed[],object?:object}>'], 'OverflowException::getTraceAsString' => ['string'], 'overload' => ['', 'class_name'=>'string'], 'override_function' => ['bool', 'function_name'=>'string', 'function_args'=>'string', 'function_code'=>'string'], 'pack' => ['string', 'format'=>'string', '...args='=>'mixed'], 'ParentIterator::__construct' => ['void', 'iterator'=>'RecursiveIterator'], 'ParentIterator::accept' => ['bool'], 'ParentIterator::getChildren' => ['ParentIterator'], 'ParentIterator::hasChildren' => ['bool'], 'ParentIterator::next' => ['void'], 'ParentIterator::rewind' => ['void'], 'ParentIterator::valid' => [''], 'Parle\Lexer::advance' => ['void'], 'Parle\Lexer::build' => ['void'], 'Parle\Lexer::callout' => ['void', 'id'=>'int', 'callback'=>'callable'], 'Parle\Lexer::consume' => ['void', 'data'=>'string'], 'Parle\Lexer::dump' => ['void'], 'Parle\Lexer::getToken' => ['Parle\Token'], 'Parle\Lexer::insertMacro' => ['void', 'name'=>'string', 'regex'=>'string'], 'Parle\Lexer::push' => ['void', 'regex'=>'string', 'id'=>'int'], 'Parle\Lexer::reset' => ['void', 'pos'=>'int'], 'Parle\Parser::advance' => ['void'], 'Parle\Parser::build' => ['void'], 'Parle\Parser::consume' => ['void', 'data'=>'string', 'lexer'=>'Parle\Lexer'], 'Parle\Parser::dump' => ['void'], 'Parle\Parser::errorInfo' => ['Parle\ErrorInfo'], 'Parle\Parser::left' => ['void', 'token'=>'string'], 'Parle\Parser::nonassoc' => ['void', 'token'=>'string'], 'Parle\Parser::precedence' => ['void', 'token'=>'string'], 'Parle\Parser::push' => ['int', 'name'=>'string', 'rule'=>'string'], 'Parle\Parser::reset' => ['void', 'tokenId'=>'int'], 'Parle\Parser::right' => ['void', 'token'=>'string'], 'Parle\Parser::sigil' => ['string', 'idx'=>'array'], 'Parle\Parser::token' => ['void', 'token'=>'string'], 'Parle\Parser::tokenId' => ['int', 'token'=>'string'], 'Parle\Parser::trace' => ['string'], 'Parle\Parser::validate' => ['bool', 'data'=>'string', 'lexer'=>'Parle\Lexer'], 'Parle\RLexer::advance' => ['void'], 'Parle\RLexer::build' => ['void'], 'Parle\RLexer::callout' => ['void', 'id'=>'int', 'callback'=>'callable'], 'Parle\RLexer::consume' => ['void', 'data'=>'string'], 'Parle\RLexer::dump' => ['void'], 'Parle\RLexer::getToken' => ['Parle\Token'], 'Parle\RLexer::push' => ['void', 'state'=>'string', 'regex'=>'string', 'newState'=>'string'], 'Parle\RLexer::pushState' => ['int', 'state'=>'string'], 'Parle\RLexer::reset' => ['void', 'pos'=>'int'], 'Parle\RParser::advance' => ['void'], 'Parle\RParser::build' => ['void'], 'Parle\RParser::consume' => ['void', 'data'=>'string', 'lexer'=>'Parle\Lexer'], 'Parle\RParser::dump' => ['void'], 'Parle\RParser::errorInfo' => ['Parle\ErrorInfo'], 'Parle\RParser::left' => ['void', 'token'=>'string'], 'Parle\RParser::nonassoc' => ['void', 'token'=>'string'], 'Parle\RParser::precedence' => ['void', 'token'=>'string'], 'Parle\RParser::push' => ['int', 'name'=>'string', 'rule'=>'string'], 'Parle\RParser::reset' => ['void', 'tokenId'=>'int'], 'Parle\RParser::right' => ['void', 'token'=>'string'], 'Parle\RParser::sigil' => ['string', 'idx'=>'array'], 'Parle\RParser::token' => ['void', 'token'=>'string'], 'Parle\RParser::tokenId' => ['int', 'token'=>'string'], 'Parle\RParser::trace' => ['string'], 'Parle\RParser::validate' => ['bool', 'data'=>'string', 'lexer'=>'Parle\Lexer'], 'Parle\Stack::pop' => ['void'], 'Parle\Stack::push' => ['void', 'item'=>''], 'parse_ini_file' => ['array|false', 'filename'=>'string', 'process_sections='=>'bool', 'scanner_mode='=>'int'], 'parse_ini_string' => ['array|false', 'ini_string'=>'string', 'process_sections='=>'bool', 'scanner_mode='=>'int'], 'parse_str' => ['void', 'encoded_string'=>'string', '&w_result='=>'array'], 'parse_url' => ['array|int|string|false|null', 'url'=>'string', 'url_component='=>'int'], 'ParseError::__clone' => ['void'], 'ParseError::__construct' => ['void', 'message='=>'string', 'code='=>'int', 'previous='=>'(?Throwable)|(?ParseError)'], 'ParseError::__toString' => ['string'], 'ParseError::getCode' => ['int'], 'ParseError::getFile' => ['string'], 'ParseError::getLine' => ['int'], 'ParseError::getMessage' => ['string'], 'ParseError::getPrevious' => ['Throwable|ParseError|null'], 'ParseError::getTrace' => ['list<array{function:string,line?:int,file?:string,class?:class-string,type?:\'::\'|\'->\',args?:mixed[],object?:object}>'], 'ParseError::getTraceAsString' => ['string'], 'parsekit_compile_file' => ['array', 'filename'=>'string', 'errors='=>'array', 'options='=>'int'], 'parsekit_compile_string' => ['array', 'phpcode'=>'string', 'errors='=>'array', 'options='=>'int'], 'parsekit_func_arginfo' => ['array', 'function'=>'mixed'], 'passthru' => ['void', 'command'=>'string', '&w_return_value='=>'int'], 'password_get_info' => ['array', 'hash'=>'string'], 'password_hash' => ['__benevolent<non-empty-string|false|null>', 'password'=>'string', 'algo'=>'string|int', 'options='=>'array'], 'password_make_salt' => ['bool', 'password'=>'string', 'hash'=>'string'], 'password_needs_rehash' => ['bool', 'hash'=>'string', 'algo'=>'int', 'options='=>'array'], 'password_verify' => ['bool', 'password'=>'string', 'hash'=>'string'], 'pathinfo' => ['array|string', 'path'=>'string', 'options='=>'int'], 'pclose' => ['int', 'fp'=>'resource'], 'pcnlt_sigwaitinfo' => ['int', 'set'=>'array', '&w_siginfo'=>'array'], 'pcntl_alarm' => ['int', 'seconds'=>'int'], 'pcntl_async_signals' => ['bool', 'on='=>'bool'], 'pcntl_errno' => ['int'], 'pcntl_exec' => ['bool', 'path'=>'string', 'args='=>'array', 'envs='=>'array'], 'pcntl_fork' => ['int'], 'pcntl_get_last_error' => ['int'], 'pcntl_getpriority' => ['int|false', 'pid='=>'int', 'process_identifier='=>'int'], 'pcntl_setpriority' => ['bool', 'priority'=>'int', 'pid='=>'int', 'process_identifier='=>'int'], 'pcntl_signal' => ['bool', 'signo'=>'int', 'handle'=>'callable|int', 'restart_syscalls='=>'bool'], 'pcntl_signal_dispatch' => ['bool'], 'pcntl_signal_get_handler' => ['int|string', 'signo'=>'int'], 'pcntl_sigprocmask' => ['bool', 'how'=>'int', 'set'=>'array', '&w_oldset='=>'array'], 'pcntl_sigtimedwait' => ['int|false', 'set'=>'array', '&w_siginfo='=>'array', 'seconds='=>'int', 'nanoseconds='=>'int'], 'pcntl_sigwaitinfo' => ['int|false', 'set'=>'array', '&w_siginfo='=>'array'], 'pcntl_strerror' => ['string', 'errno'=>'int'], 'pcntl_wait' => ['int', '&w_status'=>'int', 'options='=>'int', '&w_rusage='=>'array'], 'pcntl_waitpid' => ['int', 'pid'=>'int', '&w_status'=>'int', 'options='=>'int', '&w_rusage='=>'array'], 'pcntl_wexitstatus' => ['int|false', 'status'=>'int'], 'pcntl_wifcontinued' => ['bool', 'status'=>'int'], 'pcntl_wifexited' => ['bool', 'status'=>'int'], 'pcntl_wifsignaled' => ['bool', 'status'=>'int'], 'pcntl_wifstopped' => ['bool', 'status'=>'int'], 'pcntl_wstopsig' => ['int|false', 'status'=>'int'], 'pcntl_wtermsig' => ['int|false', 'status'=>'int'], 'PDF_activate_item' => ['bool', 'pdfdoc'=>'resource', 'id'=>'int'], 'PDF_add_launchlink' => ['bool', 'pdfdoc'=>'resource', 'llx'=>'float', 'lly'=>'float', 'urx'=>'float', 'ury'=>'float', 'filename'=>'string'], 'PDF_add_locallink' => ['bool', 'pdfdoc'=>'resource', 'lowerleftx'=>'float', 'lowerlefty'=>'float', 'upperrightx'=>'float', 'upperrighty'=>'float', 'page'=>'int', 'dest'=>'string'], 'PDF_add_nameddest' => ['bool', 'pdfdoc'=>'resource', 'name'=>'string', 'optlist'=>'string'], 'PDF_add_note' => ['bool', 'pdfdoc'=>'resource', 'llx'=>'float', 'lly'=>'float', 'urx'=>'float', 'ury'=>'float', 'contents'=>'string', 'title'=>'string', 'icon'=>'string', 'open'=>'int'], 'PDF_add_pdflink' => ['bool', 'pdfdoc'=>'resource', 'bottom_left_x'=>'float', 'bottom_left_y'=>'float', 'up_right_x'=>'float', 'up_right_y'=>'float', 'filename'=>'string', 'page'=>'int', 'dest'=>'string'], 'PDF_add_table_cell' => ['int', 'pdfdoc'=>'resource', 'table'=>'int', 'column'=>'int', 'row'=>'int', 'text'=>'string', 'optlist'=>'string'], 'PDF_add_textflow' => ['int', 'pdfdoc'=>'resource', 'textflow'=>'int', 'text'=>'string', 'optlist'=>'string'], 'PDF_add_thumbnail' => ['bool', 'pdfdoc'=>'resource', 'image'=>'int'], 'PDF_add_weblink' => ['bool', 'pdfdoc'=>'resource', 'lowerleftx'=>'float', 'lowerlefty'=>'float', 'upperrightx'=>'float', 'upperrighty'=>'float', 'url'=>'string'], 'PDF_arc' => ['bool', 'p'=>'resource', 'x'=>'float', 'y'=>'float', 'r'=>'float', 'alpha'=>'float', 'beta'=>'float'], 'PDF_arcn' => ['bool', 'p'=>'resource', 'x'=>'float', 'y'=>'float', 'r'=>'float', 'alpha'=>'float', 'beta'=>'float'], 'PDF_attach_file' => ['bool', 'pdfdoc'=>'resource', 'llx'=>'float', 'lly'=>'float', 'urx'=>'float', 'ury'=>'float', 'filename'=>'string', 'description'=>'string', 'author'=>'string', 'mimetype'=>'string', 'icon'=>'string'], 'PDF_begin_document' => ['int', 'pdfdoc'=>'resource', 'filename'=>'string', 'optlist'=>'string'], 'PDF_begin_font' => ['bool', 'pdfdoc'=>'resource', 'filename'=>'string', 'a'=>'float', 'b'=>'float', 'c'=>'float', 'd'=>'float', 'e'=>'float', 'f'=>'float', 'optlist'=>'string'], 'PDF_begin_glyph' => ['bool', 'pdfdoc'=>'resource', 'glyphname'=>'string', 'wx'=>'float', 'llx'=>'float', 'lly'=>'float', 'urx'=>'float', 'ury'=>'float'], 'PDF_begin_item' => ['int', 'pdfdoc'=>'resource', 'tag'=>'string', 'optlist'=>'string'], 'PDF_begin_layer' => ['bool', 'pdfdoc'=>'resource', 'layer'=>'int'], 'PDF_begin_page' => ['bool', 'pdfdoc'=>'resource', 'width'=>'float', 'height'=>'float'], 'PDF_begin_page_ext' => ['bool', 'pdfdoc'=>'resource', 'width'=>'float', 'height'=>'float', 'optlist'=>'string'], 'PDF_begin_pattern' => ['int', 'pdfdoc'=>'resource', 'width'=>'float', 'height'=>'float', 'xstep'=>'float', 'ystep'=>'float', 'painttype'=>'int'], 'PDF_begin_template' => ['int', 'pdfdoc'=>'resource', 'width'=>'float', 'height'=>'float'], 'PDF_begin_template_ext' => ['int', 'pdfdoc'=>'resource', 'width'=>'float', 'height'=>'float', 'optlist'=>'string'], 'PDF_circle' => ['bool', 'pdfdoc'=>'resource', 'x'=>'float', 'y'=>'float', 'r'=>'float'], 'PDF_clip' => ['bool', 'p'=>'resource'], 'PDF_close' => ['bool', 'p'=>'resource'], 'PDF_close_image' => ['bool', 'p'=>'resource', 'image'=>'int'], 'PDF_close_pdi' => ['bool', 'p'=>'resource', 'doc'=>'int'], 'PDF_close_pdi_page' => ['bool', 'p'=>'resource', 'page'=>'int'], 'PDF_closepath' => ['bool', 'p'=>'resource'], 'PDF_closepath_fill_stroke' => ['bool', 'p'=>'resource'], 'PDF_closepath_stroke' => ['bool', 'p'=>'resource'], 'PDF_concat' => ['bool', 'p'=>'resource', 'a'=>'float', 'b'=>'float', 'c'=>'float', 'd'=>'float', 'e'=>'float', 'f'=>'float'], 'PDF_continue_text' => ['bool', 'p'=>'resource', 'text'=>'string'], 'PDF_create_3dview' => ['int', 'pdfdoc'=>'resource', 'username'=>'string', 'optlist'=>'string'], 'PDF_create_action' => ['int', 'pdfdoc'=>'resource', 'type'=>'string', 'optlist'=>'string'], 'PDF_create_annotation' => ['bool', 'pdfdoc'=>'resource', 'llx'=>'float', 'lly'=>'float', 'urx'=>'float', 'ury'=>'float', 'type'=>'string', 'optlist'=>'string'], 'PDF_create_bookmark' => ['int', 'pdfdoc'=>'resource', 'text'=>'string', 'optlist'=>'string'], 'PDF_create_field' => ['bool', 'pdfdoc'=>'resource', 'llx'=>'float', 'lly'=>'float', 'urx'=>'float', 'ury'=>'float', 'name'=>'string', 'type'=>'string', 'optlist'=>'string'], 'PDF_create_fieldgroup' => ['bool', 'pdfdoc'=>'resource', 'name'=>'string', 'optlist'=>'string'], 'PDF_create_gstate' => ['int', 'pdfdoc'=>'resource', 'optlist'=>'string'], 'PDF_create_pvf' => ['bool', 'pdfdoc'=>'resource', 'filename'=>'string', 'data'=>'string', 'optlist'=>'string'], 'PDF_create_textflow' => ['int', 'pdfdoc'=>'resource', 'text'=>'string', 'optlist'=>'string'], 'PDF_curveto' => ['bool', 'p'=>'resource', 'x1'=>'float', 'y1'=>'float', 'x2'=>'float', 'y2'=>'float', 'x3'=>'float', 'y3'=>'float'], 'PDF_define_layer' => ['int', 'pdfdoc'=>'resource', 'name'=>'string', 'optlist'=>'string'], 'PDF_delete' => ['bool', 'pdfdoc'=>'resource'], 'PDF_delete_pvf' => ['int', 'pdfdoc'=>'resource', 'filename'=>'string'], 'PDF_delete_table' => ['bool', 'pdfdoc'=>'resource', 'table'=>'int', 'optlist'=>'string'], 'PDF_delete_textflow' => ['bool', 'pdfdoc'=>'resource', 'textflow'=>'int'], 'PDF_encoding_set_char' => ['bool', 'pdfdoc'=>'resource', 'encoding'=>'string', 'slot'=>'int', 'glyphname'=>'string', 'uv'=>'int'], 'PDF_end_document' => ['bool', 'pdfdoc'=>'resource', 'optlist'=>'string'], 'PDF_end_font' => ['bool', 'pdfdoc'=>'resource'], 'PDF_end_glyph' => ['bool', 'pdfdoc'=>'resource'], 'PDF_end_item' => ['bool', 'pdfdoc'=>'resource', 'id'=>'int'], 'PDF_end_layer' => ['bool', 'pdfdoc'=>'resource'], 'PDF_end_page' => ['bool', 'p'=>'resource'], 'PDF_end_page_ext' => ['bool', 'pdfdoc'=>'resource', 'optlist'=>'string'], 'PDF_end_pattern' => ['bool', 'p'=>'resource'], 'PDF_end_template' => ['bool', 'p'=>'resource'], 'PDF_endpath' => ['bool', 'p'=>'resource'], 'PDF_fill' => ['bool', 'p'=>'resource'], 'PDF_fill_imageblock' => ['int', 'pdfdoc'=>'resource', 'page'=>'int', 'blockname'=>'string', 'image'=>'int', 'optlist'=>'string'], 'PDF_fill_pdfblock' => ['int', 'pdfdoc'=>'resource', 'page'=>'int', 'blockname'=>'string', 'contents'=>'int', 'optlist'=>'string'], 'PDF_fill_stroke' => ['bool', 'p'=>'resource'], 'PDF_fill_textblock' => ['int', 'pdfdoc'=>'resource', 'page'=>'int', 'blockname'=>'string', 'text'=>'string', 'optlist'=>'string'], 'PDF_findfont' => ['int', 'p'=>'resource', 'fontname'=>'string', 'encoding'=>'string', 'embed'=>'int'], 'PDF_fit_image' => ['bool', 'pdfdoc'=>'resource', 'image'=>'int', 'x'=>'float', 'y'=>'float', 'optlist'=>'string'], 'PDF_fit_pdi_page' => ['bool', 'pdfdoc'=>'resource', 'page'=>'int', 'x'=>'float', 'y'=>'float', 'optlist'=>'string'], 'PDF_fit_table' => ['string', 'pdfdoc'=>'resource', 'table'=>'int', 'llx'=>'float', 'lly'=>'float', 'urx'=>'float', 'ury'=>'float', 'optlist'=>'string'], 'PDF_fit_textflow' => ['string', 'pdfdoc'=>'resource', 'textflow'=>'int', 'llx'=>'float', 'lly'=>'float', 'urx'=>'float', 'ury'=>'float', 'optlist'=>'string'], 'PDF_fit_textline' => ['bool', 'pdfdoc'=>'resource', 'text'=>'string', 'x'=>'float', 'y'=>'float', 'optlist'=>'string'], 'PDF_get_apiname' => ['string', 'pdfdoc'=>'resource'], 'PDF_get_buffer' => ['string', 'p'=>'resource'], 'PDF_get_errmsg' => ['string', 'pdfdoc'=>'resource'], 'PDF_get_errnum' => ['int', 'pdfdoc'=>'resource'], 'PDF_get_majorversion' => ['int'], 'PDF_get_minorversion' => ['int'], 'PDF_get_parameter' => ['string', 'p'=>'resource', 'key'=>'string', 'modifier'=>'float'], 'PDF_get_pdi_parameter' => ['string', 'p'=>'resource', 'key'=>'string', 'doc'=>'int', 'page'=>'int', 'reserved'=>'int'], 'PDF_get_pdi_value' => ['float', 'p'=>'resource', 'key'=>'string', 'doc'=>'int', 'page'=>'int', 'reserved'=>'int'], 'PDF_get_value' => ['float', 'p'=>'resource', 'key'=>'string', 'modifier'=>'float'], 'PDF_info_font' => ['float', 'pdfdoc'=>'resource', 'font'=>'int', 'keyword'=>'string', 'optlist'=>'string'], 'PDF_info_matchbox' => ['float', 'pdfdoc'=>'resource', 'boxname'=>'string', 'num'=>'int', 'keyword'=>'string'], 'PDF_info_table' => ['float', 'pdfdoc'=>'resource', 'table'=>'int', 'keyword'=>'string'], 'PDF_info_textflow' => ['float', 'pdfdoc'=>'resource', 'textflow'=>'int', 'keyword'=>'string'], 'PDF_info_textline' => ['float', 'pdfdoc'=>'resource', 'text'=>'string', 'keyword'=>'string', 'optlist'=>'string'], 'PDF_initgraphics' => ['bool', 'p'=>'resource'], 'PDF_lineto' => ['bool', 'p'=>'resource', 'x'=>'float', 'y'=>'float'], 'PDF_load_3ddata' => ['int', 'pdfdoc'=>'resource', 'filename'=>'string', 'optlist'=>'string'], 'PDF_load_font' => ['int', 'pdfdoc'=>'resource', 'fontname'=>'string', 'encoding'=>'string', 'optlist'=>'string'], 'PDF_load_iccprofile' => ['int', 'pdfdoc'=>'resource', 'profilename'=>'string', 'optlist'=>'string'], 'PDF_load_image' => ['int', 'pdfdoc'=>'resource', 'imagetype'=>'string', 'filename'=>'string', 'optlist'=>'string'], 'PDF_makespotcolor' => ['int', 'p'=>'resource', 'spotname'=>'string'], 'PDF_moveto' => ['bool', 'p'=>'resource', 'x'=>'float', 'y'=>'float'], 'PDF_new' => ['resource'], 'PDF_open_ccitt' => ['int', 'pdfdoc'=>'resource', 'filename'=>'string', 'width'=>'int', 'height'=>'int', 'bitreverse'=>'int', 'k'=>'int', 'blackls1'=>'int'], 'PDF_open_file' => ['bool', 'p'=>'resource', 'filename'=>'string'], 'PDF_open_image' => ['int', 'p'=>'resource', 'imagetype'=>'string', 'source'=>'string', 'data'=>'string', 'length'=>'int', 'width'=>'int', 'height'=>'int', 'components'=>'int', 'bpc'=>'int', 'params'=>'string'], 'PDF_open_image_file' => ['int', 'p'=>'resource', 'imagetype'=>'string', 'filename'=>'string', 'stringparam'=>'string', 'intparam'=>'int'], 'PDF_open_memory_image' => ['int', 'p'=>'resource', 'image'=>'resource'], 'PDF_open_pdi' => ['int', 'pdfdoc'=>'resource', 'filename'=>'string', 'optlist'=>'string', 'len'=>'int'], 'PDF_open_pdi_document' => ['int', 'p'=>'resource', 'filename'=>'string', 'optlist'=>'string'], 'PDF_open_pdi_page' => ['int', 'p'=>'resource', 'doc'=>'int', 'pagenumber'=>'int', 'optlist'=>'string'], 'PDF_pcos_get_number' => ['float', 'p'=>'resource', 'doc'=>'int', 'path'=>'string'], 'PDF_pcos_get_stream' => ['string', 'p'=>'resource', 'doc'=>'int', 'optlist'=>'string', 'path'=>'string'], 'PDF_pcos_get_string' => ['string', 'p'=>'resource', 'doc'=>'int', 'path'=>'string'], 'PDF_place_image' => ['bool', 'pdfdoc'=>'resource', 'image'=>'int', 'x'=>'float', 'y'=>'float', 'scale'=>'float'], 'PDF_place_pdi_page' => ['bool', 'pdfdoc'=>'resource', 'page'=>'int', 'x'=>'float', 'y'=>'float', 'sx'=>'float', 'sy'=>'float'], 'PDF_process_pdi' => ['int', 'pdfdoc'=>'resource', 'doc'=>'int', 'page'=>'int', 'optlist'=>'string'], 'PDF_rect' => ['bool', 'p'=>'resource', 'x'=>'float', 'y'=>'float', 'width'=>'float', 'height'=>'float'], 'PDF_restore' => ['bool', 'p'=>'resource'], 'PDF_resume_page' => ['bool', 'pdfdoc'=>'resource', 'optlist'=>'string'], 'PDF_rotate' => ['bool', 'p'=>'resource', 'phi'=>'float'], 'PDF_save' => ['bool', 'p'=>'resource'], 'PDF_scale' => ['bool', 'p'=>'resource', 'sx'=>'float', 'sy'=>'float'], 'PDF_set_border_color' => ['bool', 'p'=>'resource', 'red'=>'float', 'green'=>'float', 'blue'=>'float'], 'PDF_set_border_dash' => ['bool', 'pdfdoc'=>'resource', 'black'=>'float', 'white'=>'float'], 'PDF_set_border_style' => ['bool', 'pdfdoc'=>'resource', 'style'=>'string', 'width'=>'float'], 'PDF_set_gstate' => ['bool', 'pdfdoc'=>'resource', 'gstate'=>'int'], 'PDF_set_info' => ['bool', 'p'=>'resource', 'key'=>'string', 'value'=>'string'], 'PDF_set_layer_dependency' => ['bool', 'pdfdoc'=>'resource', 'type'=>'string', 'optlist'=>'string'], 'PDF_set_parameter' => ['bool', 'p'=>'resource', 'key'=>'string', 'value'=>'string'], 'PDF_set_text_pos' => ['bool', 'p'=>'resource', 'x'=>'float', 'y'=>'float'], 'PDF_set_value' => ['bool', 'p'=>'resource', 'key'=>'string', 'value'=>'float'], 'PDF_setcolor' => ['bool', 'p'=>'resource', 'fstype'=>'string', 'colorspace'=>'string', 'c1'=>'float', 'c2'=>'float', 'c3'=>'float', 'c4'=>'float'], 'PDF_setdash' => ['bool', 'pdfdoc'=>'resource', 'b'=>'float', 'w'=>'float'], 'PDF_setdashpattern' => ['bool', 'pdfdoc'=>'resource', 'optlist'=>'string'], 'PDF_setflat' => ['bool', 'pdfdoc'=>'resource', 'flatness'=>'float'], 'PDF_setfont' => ['bool', 'pdfdoc'=>'resource', 'font'=>'int', 'fontsize'=>'float'], 'PDF_setgray' => ['bool', 'p'=>'resource', 'g'=>'float'], 'PDF_setgray_fill' => ['bool', 'p'=>'resource', 'g'=>'float'], 'PDF_setgray_stroke' => ['bool', 'p'=>'resource', 'g'=>'float'], 'PDF_setlinecap' => ['bool', 'p'=>'resource', 'linecap'=>'int'], 'PDF_setlinejoin' => ['bool', 'p'=>'resource', 'value'=>'int'], 'PDF_setlinewidth' => ['bool', 'p'=>'resource', 'width'=>'float'], 'PDF_setmatrix' => ['bool', 'p'=>'resource', 'a'=>'float', 'b'=>'float', 'c'=>'float', 'd'=>'float', 'e'=>'float', 'f'=>'float'], 'PDF_setmiterlimit' => ['bool', 'pdfdoc'=>'resource', 'miter'=>'float'], 'PDF_setrgbcolor' => ['bool', 'p'=>'resource', 'red'=>'float', 'green'=>'float', 'blue'=>'float'], 'PDF_setrgbcolor_fill' => ['bool', 'p'=>'resource', 'red'=>'float', 'green'=>'float', 'blue'=>'float'], 'PDF_setrgbcolor_stroke' => ['bool', 'p'=>'resource', 'red'=>'float', 'green'=>'float', 'blue'=>'float'], 'PDF_shading' => ['int', 'pdfdoc'=>'resource', 'shtype'=>'string', 'x0'=>'float', 'y0'=>'float', 'x1'=>'float', 'y1'=>'float', 'c1'=>'float', 'c2'=>'float', 'c3'=>'float', 'c4'=>'float', 'optlist'=>'string'], 'PDF_shading_pattern' => ['int', 'pdfdoc'=>'resource', 'shading'=>'int', 'optlist'=>'string'], 'PDF_shfill' => ['bool', 'pdfdoc'=>'resource', 'shading'=>'int'], 'PDF_show' => ['bool', 'pdfdoc'=>'resource', 'text'=>'string'], 'PDF_show_boxed' => ['int', 'p'=>'resource', 'text'=>'string', 'left'=>'float', 'top'=>'float', 'width'=>'float', 'height'=>'float', 'mode'=>'string', 'feature'=>'string'], 'PDF_show_xy' => ['bool', 'p'=>'resource', 'text'=>'string', 'x'=>'float', 'y'=>'float'], 'PDF_skew' => ['bool', 'p'=>'resource', 'alpha'=>'float', 'beta'=>'float'], 'PDF_stringwidth' => ['float', 'p'=>'resource', 'text'=>'string', 'font'=>'int', 'fontsize'=>'float'], 'PDF_stroke' => ['bool', 'p'=>'resource'], 'PDF_suspend_page' => ['bool', 'pdfdoc'=>'resource', 'optlist'=>'string'], 'PDF_translate' => ['bool', 'p'=>'resource', 'tx'=>'float', 'ty'=>'float'], 'PDF_utf16_to_utf8' => ['string', 'pdfdoc'=>'resource', 'utf16string'=>'string'], 'PDF_utf32_to_utf16' => ['string', 'pdfdoc'=>'resource', 'utf32string'=>'string', 'ordering'=>'string'], 'PDF_utf8_to_utf16' => ['string', 'pdfdoc'=>'resource', 'utf8string'=>'string', 'ordering'=>'string'], 'PDO::__construct' => ['void', 'dsn'=>'string', 'username='=>'?string', 'passwd='=>'?string', 'options='=>'?array'], 'PDO::__sleep' => ['list<string>'], 'PDO::__wakeup' => ['void'], 'PDO::beginTransaction' => ['bool'], 'PDO::commit' => ['bool'], 'PDO::cubrid_schema' => ['array', 'schema_type'=>'int', 'table_name='=>'string', 'col_name='=>'string'], 'PDO::errorCode' => ['string'], 'PDO::errorInfo' => ['array'], 'PDO::exec' => ['int|false', 'query'=>'string'], 'PDO::getAttribute' => ['', 'attribute'=>'int'], 'PDO::getAvailableDrivers' => ['array'], 'PDO::inTransaction' => ['bool'], 'PDO::lastInsertId' => ['string|false', 'seqname='=>'string'], 'PDO::pgsqlCopyFromArray' => ['bool', 'table_name'=>'string', 'rows'=>'array', 'delimiter='=>'string', 'null_as='=>'string', 'fields='=>'string'], 'PDO::pgsqlCopyFromFile' => ['bool', 'table_name'=>'string', 'filename'=>'string', 'delimiter='=>'string', 'null_as='=>'string', 'fields='=>'string'], 'PDO::pgsqlCopyToArray' => ['array', 'table_name'=>'string', 'delimiter='=>'string', 'null_as='=>'string', 'fields='=>'string'], 'PDO::pgsqlCopyToFile' => ['bool', 'table_name'=>'string', 'filename'=>'string', 'delimiter='=>'string', 'null_as='=>'string', 'fields='=>'string'], 'PDO::pgsqlGetNotify' => ['array', 'result_type='=>'int', 'ms_timeout='=>'int'], 'PDO::pgsqlGetPid' => ['int'], 'PDO::pgsqlLOBCreate' => ['string'], 'PDO::pgsqlLOBOpen' => ['resource', 'oid'=>'string', 'mode='=>'string'], 'PDO::pgsqlLOBUnlink' => ['bool', 'oid'=>'string'], 'PDO::prepare' => ['__benevolent<PDOStatement|false>', 'statement'=>'string', 'options='=>'array'], 'PDO::query' => ['PDOStatement|false', 'sql'=>'string'], 'PDO::query\'1' => ['PDOStatement|false', 'sql'=>'string', 'fetch_column'=>'int', 'colno'=>'int'], 'PDO::query\'2' => ['PDOStatement|false', 'sql'=>'string', 'fetch_class'=>'int', 'classname'=>'string', 'ctorargs'=>'array'], 'PDO::query\'3' => ['PDOStatement|false', 'sql'=>'string', 'fetch_into'=>'int', 'object'=>'object'], 'PDO::quote' => ['string', 'string'=>'string', 'paramtype='=>'int'], 'PDO::rollBack' => ['bool'], 'PDO::setAttribute' => ['bool', 'attribute'=>'int', 'value'=>''], 'PDO::sqliteCreateAggregate' => ['bool', 'function_name'=>'string', 'step_func'=>'callable', 'finalize_func'=>'callable', 'num_args='=>'int'], 'PDO::sqliteCreateCollation' => ['bool', 'name'=>'string', 'callback'=>'callable'], 'PDO::sqliteCreateFunction' => ['bool', 'function_name'=>'string', 'callback'=>'callable', 'num_args='=>'int', 'flags='=>'int'], 'pdo_drivers' => ['array'], 'PDOException::getCode' => [''], 'PDOException::getFile' => [''], 'PDOException::getLine' => [''], 'PDOException::getMessage' => [''], 'PDOException::getPrevious' => [''], 'PDOException::getTrace' => ['list<array{function:string,line?:int,file?:string,class?:class-string,type?:\'::\'|\'->\',args?:mixed[],object?:object}>'], 'PDOException::getTraceAsString' => [''], 'PDOStatement::__sleep' => ['list<string>'], 'PDOStatement::__wakeup' => ['void'], 'PDOStatement::bindColumn' => ['bool', 'column'=>'mixed', '&w_param'=>'mixed', 'type='=>'int', 'maxlen='=>'int', 'driverdata='=>'mixed'], 'PDOStatement::bindParam' => ['bool', 'parameter'=>'mixed', '&w_variable'=>'mixed', 'data_type='=>'int', 'length='=>'int', 'driver_options='=>'mixed'], 'PDOStatement::bindValue' => ['bool', 'parameter'=>'mixed', 'value'=>'mixed', 'data_type='=>'int'], 'PDOStatement::closeCursor' => ['bool'], 'PDOStatement::columnCount' => ['0|positive-int'], 'PDOStatement::debugDumpParams' => ['void'], 'PDOStatement::errorCode' => ['string'], 'PDOStatement::errorInfo' => ['array'], 'PDOStatement::execute' => ['bool', 'bound_input_params='=>'?array'], 'PDOStatement::fetch' => ['mixed', 'how='=>'int', 'orientation='=>'int', 'offset='=>'int'], 'PDOStatement::fetchAll' => ['array|false', 'how='=>'int', 'fetch_argument='=>'int|string|callable', 'ctor_args='=>'?array'], 'PDOStatement::fetchColumn' => ['string|null|false|int', 'column_number='=>'int'], 'PDOStatement::fetchObject' => ['mixed', 'class_name='=>'string', 'ctor_args='=>'?array'], 'PDOStatement::getAttribute' => ['mixed', 'attribute'=>'int'], 'PDOStatement::getColumnMeta' => ['array|false', 'column'=>'int'], 'PDOStatement::nextRowset' => ['bool'], 'PDOStatement::rowCount' => ['0|positive-int'], 'PDOStatement::setAttribute' => ['bool', 'attribute'=>'int', 'value'=>'mixed'], 'PDOStatement::setFetchMode' => ['bool', 'mode'=>'int'], 'PDOStatement::setFetchMode\'1' => ['bool', 'fetch_column'=>'int', 'colno'=>'int'], 'PDOStatement::setFetchMode\'2' => ['bool', 'fetch_class'=>'int', 'classname'=>'string', 'ctorargs='=>'?array'], 'PDOStatement::setFetchMode\'3' => ['bool', 'fetch_into'=>'int', 'object'=>'object'], 'pfsockopen' => ['resource|false', 'hostname'=>'string', 'port='=>'int', '&w_errno='=>'int', '&w_errstr='=>'string', 'timeout='=>'float'], 'pg_affected_rows' => ['int', 'result'=>'resource'], 'pg_cancel_query' => ['bool', 'connection'=>'resource'], 'pg_client_encoding' => ['string', 'connection='=>'resource'], 'pg_close' => ['bool', 'connection='=>'resource'], 'pg_connect' => ['resource|false', 'connection_string'=>'string', 'connect_type='=>'int'], 'pg_connect_poll' => ['int', 'connection'=>'resource'], 'pg_connection_busy' => ['bool', 'connection'=>'resource'], 'pg_connection_reset' => ['bool', 'connection'=>'resource'], 'pg_connection_status' => ['int', 'connection'=>'resource'], 'pg_consume_input' => ['bool', 'connection'=>'resource'], 'pg_convert' => ['array|false', 'db'=>'resource', 'table'=>'string', 'values'=>'array', 'options='=>'int'], 'pg_copy_from' => ['bool', 'connection'=>'resource', 'table_name'=>'string', 'rows'=>'array', 'delimiter='=>'string', 'null_as='=>'string'], 'pg_copy_to' => ['array|false', 'connection'=>'resource', 'table_name'=>'string', 'delimiter='=>'string', 'null_as='=>'string'], 'pg_dbname' => ['string', 'connection='=>'resource'], 'pg_delete' => ['mixed', 'db'=>'resource', 'table'=>'string', 'ids'=>'array', 'options='=>'int'], 'pg_end_copy' => ['bool', 'connection='=>'resource'], 'pg_escape_bytea' => ['string', 'connection'=>'resource', 'data'=>'string'], 'pg_escape_bytea\'1' => ['string', 'data'=>'string'], 'pg_escape_identifier' => ['string|false', 'connection'=>'resource', 'data'=>'string'], 'pg_escape_identifier\'1' => ['string', 'data'=>'string'], 'pg_escape_literal' => ['string|false', 'connection'=>'resource', 'data'=>'string'], 'pg_escape_literal\'1' => ['string', 'data'=>'string'], 'pg_escape_string' => ['string', 'connection'=>'resource', 'data'=>'string'], 'pg_escape_string\'1' => ['string', 'data'=>'string'], 'pg_execute' => ['resource|false', 'connection'=>'resource', 'stmtname'=>'string', 'params'=>'array'], 'pg_execute\'1' => ['resource|false', 'stmtname'=>'string', 'params'=>'array'], 'pg_fetch_all' => ['array<non-empty-list<string|null>>', 'result'=>'resource', 'result_type='=>'int'], 'pg_fetch_all_columns' => ['array|false', 'result'=>'resource', 'column_number='=>'int'], 'pg_fetch_array' => ['array|false', 'result'=>'resource', 'row='=>'?int', 'result_type='=>'int'], 'pg_fetch_assoc' => ['non-empty-array<string,mixed>|false', 'result'=>'resource', 'row='=>'?int'], 'pg_fetch_object' => ['object|false', 'result'=>'', 'row='=>'?int', 'result_type='=>'int'], 'pg_fetch_object\'1' => ['object', 'result'=>'', 'row='=>'?int', 'class_name='=>'string', 'ctor_params='=>'array'], 'pg_fetch_result' => ['', 'result'=>'', 'field_name'=>'string|int'], 'pg_fetch_result\'1' => ['', 'result'=>'', 'row_number'=>'int', 'field_name'=>'string|int'], 'pg_fetch_row' => ['non-empty-list<mixed>|false', 'result'=>'resource', 'row='=>'?int', 'result_type='=>'int'], 'pg_field_is_null' => ['int|false', 'result'=>'', 'field_name_or_number'=>'string|int'], 'pg_field_is_null\'1' => ['int', 'result'=>'', 'row'=>'int', 'field_name_or_number'=>'string|int'], 'pg_field_name' => ['string|false', 'result'=>'resource', 'field_number'=>'int'], 'pg_field_num' => ['int', 'result'=>'resource', 'field_name'=>'string'], 'pg_field_prtlen' => ['int|false', 'result'=>'', 'field_name_or_number'=>''], 'pg_field_prtlen\'1' => ['int', 'result'=>'', 'row'=>'int', 'field_name_or_number'=>'string|int'], 'pg_field_size' => ['int', 'result'=>'resource', 'field_number'=>'int'], 'pg_field_table' => ['mixed', 'result'=>'resource', 'field_number'=>'int', 'oid_only='=>'bool'], 'pg_field_type' => ['string', 'result'=>'resource', 'field_number'=>'int'], 'pg_field_type_oid' => ['int|false', 'result'=>'resource', 'field_number'=>'int'], 'pg_flush' => ['mixed', 'connection'=>'resource'], 'pg_free_result' => ['bool', 'result'=>'resource'], 'pg_get_notify' => ['array|false', 'connection'=>'resource', 'result_type='=>'int'], 'pg_get_pid' => ['int|false', 'connection'=>'resource'], 'pg_get_result' => ['resource|false', 'connection='=>'resource'], 'pg_host' => ['string', 'connection='=>'resource'], 'pg_insert' => ['mixed', 'db'=>'resource', 'table'=>'string', 'values'=>'array', 'options='=>'int'], 'pg_last_error' => ['string', 'connection='=>'resource', 'operation='=>'int'], 'pg_last_notice' => ['string', 'connection'=>'resource', 'option='=>'int'], 'pg_last_oid' => ['string|false', 'result'=>'resource'], 'pg_lo_close' => ['bool', 'large_object'=>'resource'], 'pg_lo_create' => ['int|false', 'connection='=>'resource', 'large_object_oid='=>''], 'pg_lo_export' => ['bool', 'connection'=>'resource', 'oid'=>'int', 'filename'=>'string'], 'pg_lo_export\'1' => ['bool', 'oid'=>'int', 'pathname'=>'string'], 'pg_lo_import' => ['int|false', 'connection'=>'resource', 'pathname'=>'string', 'oid'=>''], 'pg_lo_import\'1' => ['int', 'pathname'=>'string', 'oid'=>''], 'pg_lo_open' => ['resource|false', 'connection'=>'resource', 'oid'=>'int', 'mode'=>'string'], 'pg_lo_read' => ['string|false', 'large_object'=>'resource', 'len='=>'int'], 'pg_lo_read_all' => ['int', 'large_object'=>'resource'], 'pg_lo_seek' => ['bool', 'large_object'=>'resource', 'offset'=>'int', 'whence='=>'int'], 'pg_lo_tell' => ['int', 'large_object'=>'resource'], 'pg_lo_truncate' => ['bool', 'large_object'=>'resource', 'size'=>'int'], 'pg_lo_unlink' => ['bool', 'connection'=>'resource', 'oid'=>'int'], 'pg_lo_write' => ['int|false', 'large_object'=>'resource', 'data'=>'string', 'len='=>'int'], 'pg_meta_data' => ['array|false', 'db'=>'resource', 'table'=>'string', 'extended='=>'bool'], 'pg_num_fields' => ['int', 'result'=>'resource'], 'pg_num_rows' => ['int', 'result'=>'resource'], 'pg_options' => ['string', 'connection='=>'resource'], 'pg_parameter_status' => ['string|false', 'connection'=>'resource', 'param_name'=>'string'], 'pg_parameter_status\'1' => ['string|false', 'param_name'=>'string'], 'pg_pconnect' => ['resource|false', 'connection_string'=>'string', 'connect_type='=>'int'], 'pg_ping' => ['bool', 'connection='=>'resource'], 'pg_port' => ['int', 'connection='=>'resource'], 'pg_prepare' => ['resource|false', 'connection'=>'resource', 'stmtname'=>'string', 'query'=>'string'], 'pg_prepare\'1' => ['resource|false', 'stmtname'=>'string', 'query'=>'string'], 'pg_put_line' => ['bool', 'connection'=>'resource', 'data'=>'string'], 'pg_put_line\'1' => ['bool', 'data'=>'string'], 'pg_query' => ['resource|false', 'connection'=>'resource', 'query'=>'string'], 'pg_query\'1' => ['resource|false', 'query'=>'string'], 'pg_query_params' => ['resource|false', 'connection'=>'resource', 'query'=>'string', 'params'=>'array'], 'pg_query_params\'1' => ['resource|false', 'query'=>'string', 'params'=>'array'], 'pg_result_error' => ['string|false', 'result'=>'resource'], 'pg_result_error_field' => ['string|false|null', 'result'=>'resource', 'fieldcode'=>'int'], 'pg_result_seek' => ['bool', 'result'=>'resource', 'offset'=>'int'], 'pg_result_status' => ['mixed', 'result'=>'resource', 'result_type='=>'int'], 'pg_select' => ['mixed', 'db'=>'resource', 'table'=>'string', 'ids'=>'array', 'options='=>'int', 'result_type='=>'int'], 'pg_send_execute' => ['bool', 'connection'=>'resource', 'stmtname'=>'string', 'params'=>'array'], 'pg_send_prepare' => ['bool', 'connection'=>'resource', 'stmtname'=>'string', 'query'=>'string'], 'pg_send_query' => ['bool', 'connection'=>'resource', 'query'=>'string'], 'pg_send_query_params' => ['bool', 'connection'=>'resource', 'query'=>'string', 'params'=>'array'], 'pg_set_client_encoding' => ['int', 'connection'=>'resource', 'encoding'=>'string'], 'pg_set_client_encoding\'1' => ['int', 'encoding'=>'string'], 'pg_set_error_verbosity' => ['int|false', 'connection'=>'resource', 'verbosity'=>'int'], 'pg_set_error_verbosity\'1' => ['int', 'verbosity'=>'int'], 'pg_socket' => ['resource|false', 'connection'=>'resource'], 'pg_trace' => ['bool', 'filename'=>'string', 'mode='=>'string', 'connection='=>'resource'], 'pg_transaction_status' => ['int', 'connection'=>'resource'], 'pg_tty' => ['string', 'connection='=>'resource'], 'pg_tty\'1' => ['string'], 'pg_unescape_bytea' => ['string', 'data'=>'string'], 'pg_untrace' => ['bool', 'connection='=>'resource'], 'pg_untrace\'1' => ['bool'], 'pg_update' => ['mixed', 'db'=>'resource', 'table'=>'string', 'fields'=>'array', 'ids'=>'array', 'options='=>'int'], 'pg_version' => ['array', 'connection='=>'resource'], 'Phar::__construct' => ['void', 'fname'=>'string', 'flags='=>'int', 'alias='=>'string'], 'Phar::addEmptyDir' => ['', 'dirname'=>'string'], 'Phar::addFile' => ['', 'file'=>'string', 'localname='=>'string'], 'Phar::addFromString' => ['', 'localname'=>'string', 'contents'=>'string'], 'Phar::apiVersion' => ['string'], 'Phar::buildFromDirectory' => ['array', 'base_dir'=>'string', 'regex='=>'string'], 'Phar::buildFromIterator' => ['array', 'iter'=>'Iterator', 'base_directory='=>'string'], 'Phar::canCompress' => ['bool', 'method='=>'int'], 'Phar::canWrite' => ['bool'], 'Phar::compress' => ['Phar', 'compression'=>'int', 'extension='=>'string'], 'Phar::compressAllFilesBZIP2' => ['bool'], 'Phar::compressAllFilesGZ' => ['bool'], 'Phar::compressFiles' => ['', 'compression'=>'int'], 'Phar::convertToData' => ['PharData', 'format='=>'int', 'compression='=>'int', 'extension='=>'string'], 'Phar::convertToExecutable' => ['Phar', 'format='=>'int', 'compression='=>'int', 'extension='=>'string'], 'Phar::copy' => ['bool', 'oldfile'=>'string', 'newfile'=>'string'], 'Phar::count' => ['0|positive-int'], 'Phar::createDefaultStub' => ['string', 'indexfile='=>'string', 'webindexfile='=>'string'], 'Phar::decompress' => ['Phar', 'extension='=>'string'], 'Phar::decompressFiles' => ['bool'], 'Phar::delete' => ['bool', 'entry'=>'string'], 'Phar::delMetadata' => ['bool'], 'Phar::extractTo' => ['bool', 'pathto'=>'string', 'files='=>'string|array|null', 'overwrite='=>'bool'], 'Phar::getAlias' => ['string'], 'Phar::getMetadata' => ['mixed'], 'Phar::getModified' => ['bool'], 'Phar::getPath' => ['string'], 'Phar::getSignature' => ['array{hash:string, hash_type:string}'], 'Phar::getStub' => ['string'], 'Phar::getSupportedCompression' => ['array'], 'Phar::getSupportedSignatures' => ['array'], 'Phar::getVersion' => ['string'], 'Phar::hasMetadata' => ['bool'], 'Phar::interceptFileFuncs' => [''], 'Phar::isBuffering' => ['bool'], 'Phar::isCompressed' => [''], 'Phar::isFileFormat' => ['bool', 'format'=>'int'], 'Phar::isValidPharFilename' => ['bool', 'filename'=>'string', 'executable='=>'bool'], 'Phar::isWritable' => ['bool'], 'Phar::loadPhar' => ['bool', 'filename'=>'string', 'alias='=>'string'], 'Phar::mapPhar' => ['bool', 'alias='=>'string', 'dataoffset='=>'int'], 'Phar::mount' => ['void', 'pharpath'=>'string', 'externalpath'=>'string'], 'Phar::mungServer' => ['', 'munglist'=>'array'], 'Phar::offsetExists' => ['bool', 'offset'=>'string'], 'Phar::offsetGet' => ['PharFileInfo', 'offset'=>'string'], 'Phar::offsetSet' => ['', 'offset'=>'string', 'value'=>'string'], 'Phar::offsetUnset' => ['bool', 'offset'=>'string'], 'Phar::running' => ['string', 'retphar='=>'bool'], 'Phar::setAlias' => ['bool', 'alias'=>'string'], 'Phar::setDefaultStub' => ['bool', 'index='=>'string', 'webindex='=>'string'], 'Phar::setMetadata' => ['', 'metadata'=>''], 'Phar::setSignatureAlgorithm' => ['', 'sigtype'=>'int', 'privatekey='=>'string'], 'Phar::setStub' => ['bool', 'stub'=>'string', 'len='=>'int'], 'Phar::startBuffering' => [''], 'Phar::stopBuffering' => [''], 'Phar::uncompressAllFiles' => ['bool'], 'Phar::unlinkArchive' => ['bool', 'archive'=>'string'], 'Phar::webPhar' => ['', 'alias='=>'string', 'index='=>'string', 'f404='=>'string', 'mimetypes='=>'array', 'rewrites='=>'array'], 'PharData::__construct' => ['void', 'fname'=>'string', 'flags='=>'int', 'alias='=>'string', 'format='=>'int'], 'PharData::addEmptyDir' => ['bool', 'dirname'=>'string'], 'PharData::addFile' => ['', 'file'=>'string', 'localname='=>'string'], 'PharData::addFromString' => ['bool', 'localname'=>'string', 'contents'=>'string'], 'PharData::buildFromDirectory' => ['array', 'base_dir'=>'string', 'regex='=>'string'], 'PharData::buildFromIterator' => ['array', 'iter'=>'Iterator', 'base_directory='=>'string'], 'PharData::compress' => ['PharData', 'compression'=>'int', 'extension='=>'string'], 'PharData::compressFiles' => ['bool', 'compression'=>'int'], 'PharData::convertToData' => ['PharData', 'format='=>'int', 'compression='=>'int', 'extension='=>'string'], 'PharData::convertToExecutable' => ['Phar', 'format='=>'int', 'compression='=>'int', 'extension='=>'string'], 'PharData::copy' => ['bool', 'oldfile'=>'string', 'newfile'=>'string'], 'PharData::decompress' => ['PharData', 'extension='=>'string'], 'PharData::decompressFiles' => ['bool'], 'PharData::delete' => ['bool', 'entry'=>'string'], 'PharData::delMetadata' => ['bool'], 'PharData::extractTo' => ['bool', 'pathto'=>'string', 'files='=>'string|array|null', 'overwrite='=>'bool'], 'PharData::isWritable' => ['bool'], 'PharData::offsetGet' => ['PharFileInfo', 'offset'=>'string'], 'PharData::offsetSet' => ['', 'offset'=>'string', 'value'=>'string'], 'PharData::offsetUnset' => ['bool', 'offset'=>'string'], 'PharData::setAlias' => ['bool', 'alias'=>'string'], 'PharData::setDefaultStub' => ['bool', 'index='=>'string', 'webindex='=>'string'], 'PharData::setStub' => ['bool', 'stub'=>'string'], 'PharFileInfo::__construct' => ['void', 'entry'=>'string'], 'PharFileInfo::chmod' => ['void', 'permissions'=>'int'], 'PharFileInfo::compress' => ['bool', 'compression'=>'int'], 'PharFileInfo::decompress' => ['bool'], 'PharFileInfo::delMetadata' => ['bool'], 'PharFileInfo::getCompressedSize' => ['int'], 'PharFileInfo::getContent' => ['string'], 'PharFileInfo::getCRC32' => ['int'], 'PharFileInfo::getMetadata' => ['mixed'], 'PharFileInfo::getPharFlags' => ['int'], 'PharFileInfo::hasMetadata' => ['bool'], 'PharFileInfo::isCompressed' => ['bool', 'compression_type='=>'int'], 'PharFileInfo::isCompressedBZIP2' => ['bool'], 'PharFileInfo::isCompressedGZ' => ['bool'], 'PharFileInfo::isCRCChecked' => ['bool'], 'PharFileInfo::setCompressedBZIP2' => ['bool'], 'PharFileInfo::setCompressedGZ' => ['bool'], 'PharFileInfo::setMetadata' => ['void', 'metadata'=>'mixed'], 'PharFileInfo::setUncompressed' => ['bool'], 'phdfs::__construct' => ['void', 'ip'=>'string', 'port'=>'string'], 'phdfs::__destruct' => [''], 'phdfs::connect' => ['bool'], 'phdfs::copy' => ['bool', 'source_file'=>'string', 'destination_file'=>'string'], 'phdfs::create_directory' => ['bool', 'path'=>'string'], 'phdfs::delete' => ['bool', 'path'=>'string'], 'phdfs::disconnect' => ['bool'], 'phdfs::exists' => ['bool', 'path'=>'string'], 'phdfs::file_info' => ['array', 'path'=>'string'], 'phdfs::list_directory' => ['array', 'path'=>'string'], 'phdfs::read' => ['string', 'path'=>'string', 'length='=>'string'], 'phdfs::rename' => ['bool', 'old_path'=>'string', 'new_path'=>'string'], 'phdfs::tell' => ['int', 'path'=>'string'], 'phdfs::write' => ['bool', 'path'=>'string', 'buffer'=>'string', 'mode='=>'string'], 'php_check_syntax' => ['bool', 'filename'=>'string', 'error_message='=>'string'], 'php_ini_loaded_file' => ['non-empty-string|false'], 'php_ini_scanned_files' => ['string|false'], 'php_logo_guid' => ['string'], 'php_sapi_name' => ['__benevolent<non-empty-string|false>'], 'php_strip_whitespace' => ['string', 'file_name'=>'string'], 'php_uname' => ['string', 'mode='=>'string'], 'php_user_filter::filter' => ['int', 'in'=>'resource', 'out'=>'resource', '&rw_consumed'=>'int', 'closing'=>'bool'], 'php_user_filter::onClose' => ['void'], 'php_user_filter::onCreate' => ['bool'], 'phpcredits' => ['bool', 'flag='=>'int'], 'phpdbg_break_file' => ['', 'file'=>'string', 'line'=>'int'], 'phpdbg_break_function' => ['', 'function'=>'string'], 'phpdbg_break_method' => ['', 'class'=>'string', 'method'=>'string'], 'phpdbg_break_next' => [''], 'phpdbg_clear' => [''], 'phpdbg_color' => ['', 'element'=>'int', 'color'=>'string'], 'phpdbg_end_oplog' => ['array', 'options='=>'array'], 'phpdbg_prompt' => ['', 'prompt'=>'string'], 'phpdbg_start_oplog' => [''], 'phpinfo' => ['bool', 'what='=>'int'], 'phpversion' => ['string'], 'phpversion\'1' => ['string|false', 'extension'=>'string'], 'pht\AtomicInteger::__construct' => ['void', 'value='=>'int'], 'pht\AtomicInteger::dec' => ['void'], 'pht\AtomicInteger::get' => ['int'], 'pht\AtomicInteger::inc' => ['void'], 'pht\AtomicInteger::lock' => ['void'], 'pht\AtomicInteger::set' => ['void', 'value'=>'int'], 'pht\AtomicInteger::unlock' => ['void'], 'pht\HashTable::lock' => ['void'], 'pht\HashTable::size' => ['int'], 'pht\HashTable::unlock' => ['void'], 'pht\Queue::front' => ['mixed'], 'pht\Queue::lock' => ['void'], 'pht\Queue::pop' => ['mixed'], 'pht\Queue::push' => ['void', 'value'=>'mixed'], 'pht\Queue::size' => ['int'], 'pht\Queue::unlock' => ['void'], 'pht\Runnable::run' => ['void'], 'pht\Vector::__construct' => ['void', 'size='=>'int', 'value='=>'mixed'], 'pht\Vector::deleteAt' => ['void', 'offset'=>'int'], 'pht\Vector::insertAt' => ['void', 'value'=>'mixed', 'offset'=>'int'], 'pht\Vector::lock' => ['void'], 'pht\Vector::pop' => ['mixed'], 'pht\Vector::push' => ['void', 'value'=>'mixed'], 'pht\Vector::resize' => ['void', 'size'=>'int', 'value='=>'mixed'], 'pht\Vector::shift' => ['mixed'], 'pht\Vector::size' => ['int'], 'pht\Vector::unlock' => ['void'], 'pht\Vector::unshift' => ['void', 'value'=>'mixed'], 'pht\Vector::updateAt' => ['void', 'value'=>'mixed', 'offset'=>'int'], 'pi' => ['float'], 'png2wbmp' => ['bool', 'pngname'=>'string', 'wbmpname'=>'string', 'dest_height'=>'int', 'dest_width'=>'int', 'threshold'=>'int'], 'pointObj::__construct' => ['void'], 'pointObj::distanceToLine' => ['float', 'p1'=>'pointObj', 'p2'=>'pointObj'], 'pointObj::distanceToPoint' => ['float', 'poPoint'=>'pointObj'], 'pointObj::distanceToShape' => ['float', 'shape'=>'shapeObj'], 'pointObj::draw' => ['int', 'map'=>'mapObj', 'layer'=>'layerObj', 'img'=>'imageObj', 'class_index'=>'int', 'text'=>'string'], 'pointObj::ms_newPointObj' => ['pointObj'], 'pointObj::project' => ['int', 'in'=>'projectionObj', 'out'=>'projectionObj'], 'pointObj::setXY' => ['int', 'x'=>'float', 'y'=>'float', 'm'=>'float'], 'pointObj::setXYZ' => ['int', 'x'=>'float', 'y'=>'float', 'z'=>'float', 'm'=>'float'], 'Pool::__construct' => ['void', 'size'=>'int', 'class'=>'string', 'ctor='=>'array'], 'Pool::collect' => ['int', 'collector'=>'Callable'], 'Pool::resize' => ['void', 'size'=>'int'], 'Pool::shutdown' => ['void'], 'Pool::submit' => ['int', 'task'=>'Threaded'], 'Pool::submitTo' => ['int', 'worker'=>'int', 'task'=>'Threaded'], 'popen' => ['resource|false', 'command'=>'string', 'mode'=>'string'], 'pos' => ['mixed', 'array_arg'=>'array'], 'posix_access' => ['bool', 'file'=>'string', 'mode='=>'int'], 'posix_ctermid' => ['string|false'], 'posix_errno' => ['int'], 'posix_get_last_error' => ['int'], 'posix_getcwd' => ['string|false'], 'posix_getegid' => ['int'], 'posix_geteuid' => ['int'], 'posix_getgid' => ['int'], 'posix_getgrgid' => ['array{name: string, passwd: string, gid: int, members: list<string>}|false', 'gid'=>'int'], 'posix_getgrnam' => ['array{name: string, passwd: string, gid: int, members: list<string>}|false', 'groupname'=>'string'], 'posix_getgroups' => ['list<int>|false'], 'posix_getlogin' => ['string|false'], 'posix_getpgid' => ['int|false', 'pid'=>'int'], 'posix_getpgrp' => ['int'], 'posix_getpid' => ['int'], 'posix_getppid' => ['int'], 'posix_getpwnam' => ['array|false', 'groupname'=>'string'], 'posix_getpwuid' => ['array{name: string, passwd: string, uid: int, gid: int, gecos: string, dir: string, shell: string}|false', 'uid'=>'int'], 'posix_getrlimit' => ['array|false'], 'posix_getsid' => ['int|false', 'pid'=>'int'], 'posix_getuid' => ['int'], 'posix_initgroups' => ['bool', 'name'=>'string', 'base_group_id'=>'int'], 'posix_isatty' => ['bool', 'fd'=>'resource|int'], 'posix_kill' => ['bool', 'pid'=>'int', 'sig'=>'int'], 'posix_mkfifo' => ['bool', 'pathname'=>'string', 'mode'=>'int'], 'posix_mknod' => ['bool', 'pathname'=>'string', 'mode'=>'int', 'major='=>'int', 'minor='=>'int'], 'posix_setegid' => ['bool', 'uid'=>'int'], 'posix_seteuid' => ['bool', 'uid'=>'int'], 'posix_setgid' => ['bool', 'uid'=>'int'], 'posix_setpgid' => ['bool', 'pid'=>'int', 'pgid'=>'int'], 'posix_setrlimit' => ['bool', 'resource'=>'int', 'softlimit'=>'int', 'hardlimit'=>'int'], 'posix_setsid' => ['int'], 'posix_setuid' => ['bool', 'uid'=>'int'], 'posix_strerror' => ['string', 'errno'=>'int'], 'posix_times' => ['array|false'], 'posix_ttyname' => ['string|false', 'fd'=>'resource|int'], 'posix_uname' => ['array|false'], 'Postal\Expand::expand_address' => ['string[]', 'address'=>'string', 'options='=>'array<string, mixed>'], 'Postal\Parser::parse_address' => ['array<string,string>', 'address'=>'string', 'options='=>'array<string, string>'], 'pow' => ['float|int', 'base'=>'int|float', 'exponent'=>'int|float'], 'preg_filter' => ['string|array|null', 'regex'=>'string|array', 'replace'=>'string|array', 'subject'=>'string|array', 'limit='=>'int', '&w_count='=>'int'], 'preg_grep' => ['array|false', 'regex'=>'string', 'input'=>'array', 'flags='=>'int'], 'preg_last_error' => ['int'], 'preg_match' => ['0|1|false', 'pattern'=>'string', 'subject'=>'string', '&w_subpatterns='=>'string[]', 'flags='=>'int', 'offset='=>'int'], 'preg_match_all' => ['0|positive-int|false|null', 'pattern'=>'string', 'subject'=>'string', '&w_subpatterns='=>'array', 'flags='=>'int', 'offset='=>'int'], 'preg_quote' => ['string', 'str'=>'string', 'delim_char='=>'string'], 'preg_replace' => ['string|array|null', 'regex'=>'string|array', 'replace'=>'string|array', 'subject'=>'string|array', 'limit='=>'int', '&w_count='=>'int'], 'preg_replace_callback' => ['string|array|null', 'regex'=>'string|array', 'callback'=>'callable(array<int|string, string>):string', 'subject'=>'string|array', 'limit='=>'int', '&w_count='=>'int'], 'preg_replace_callback_array' => ['string|array|null', 'pattern'=>'array<string,callable>', 'subject'=>'string|array', 'limit='=>'int', '&w_count='=>'int'], 'preg_split' => ['list<string>|false', 'pattern'=>'string', 'subject'=>'string', 'limit='=>'?int', 'flags='=>'int'], 'prev' => ['mixed', '&rw_array_arg'=>'array|object'], 'print_r' => ['string|true', 'var'=>'mixed', 'return='=>'bool'], 'printf' => ['int', 'format'=>'string', '...values='=>'__stringAndStringable|int|float|null|bool'], 'proc_close' => ['int', 'process'=>'resource'], 'proc_get_status' => ['array{command: string, pid: int, running: bool, signaled: bool, stopped: bool, exitcode: int, termsig: int, stopsig: int}|false', 'process'=>'resource'], 'proc_nice' => ['bool', 'priority'=>'int'], 'proc_open' => ['resource|false', 'command'=>'string', 'descriptorspec'=>'array', '&w_pipes'=>'resource[]', 'cwd='=>'?string', 'env='=>'?array', 'other_options='=>'array'], 'proc_terminate' => ['bool', 'process'=>'resource', 'signal='=>'int'], 'projectionObj::__construct' => ['void', 'projectionString'=>'string'], 'projectionObj::getUnits' => ['int'], 'projectionObj::ms_newProjectionObj' => ['projectionObj', 'projectionString'=>'string'], 'property_exists' => ['bool', 'object_or_class'=>'object|string', 'property_name'=>'string'], 'ps_add_bookmark' => ['int', 'psdoc'=>'resource', 'text'=>'string', 'parent='=>'int', 'open='=>'int'], 'ps_add_launchlink' => ['bool', 'psdoc'=>'resource', 'llx'=>'float', 'lly'=>'float', 'urx'=>'float', 'ury'=>'float', 'filename'=>'string'], 'ps_add_locallink' => ['bool', 'psdoc'=>'resource', 'llx'=>'float', 'lly'=>'float', 'urx'=>'float', 'ury'=>'float', 'page'=>'int', 'dest'=>'string'], 'ps_add_note' => ['bool', 'psdoc'=>'resource', 'llx'=>'float', 'lly'=>'float', 'urx'=>'float', 'ury'=>'float', 'contents'=>'string', 'title'=>'string', 'icon'=>'string', 'open'=>'int'], 'ps_add_pdflink' => ['bool', 'psdoc'=>'resource', 'llx'=>'float', 'lly'=>'float', 'urx'=>'float', 'ury'=>'float', 'filename'=>'string', 'page'=>'int', 'dest'=>'string'], 'ps_add_weblink' => ['bool', 'psdoc'=>'resource', 'llx'=>'float', 'lly'=>'float', 'urx'=>'float', 'ury'=>'float', 'url'=>'string'], 'ps_arc' => ['bool', 'psdoc'=>'resource', 'x'=>'float', 'y'=>'float', 'radius'=>'float', 'alpha'=>'float', 'beta'=>'float'], 'ps_arcn' => ['bool', 'psdoc'=>'resource', 'x'=>'float', 'y'=>'float', 'radius'=>'float', 'alpha'=>'float', 'beta'=>'float'], 'ps_begin_page' => ['bool', 'psdoc'=>'resource', 'width'=>'float', 'height'=>'float'], 'ps_begin_pattern' => ['int', 'psdoc'=>'resource', 'width'=>'float', 'height'=>'float', 'xstep'=>'float', 'ystep'=>'float', 'painttype'=>'int'], 'ps_begin_template' => ['int', 'psdoc'=>'resource', 'width'=>'float', 'height'=>'float'], 'ps_circle' => ['bool', 'psdoc'=>'resource', 'x'=>'float', 'y'=>'float', 'radius'=>'float'], 'ps_clip' => ['bool', 'psdoc'=>'resource'], 'ps_close' => ['bool', 'psdoc'=>'resource'], 'ps_close_image' => ['void', 'psdoc'=>'resource', 'imageid'=>'int'], 'ps_closepath' => ['bool', 'psdoc'=>'resource'], 'ps_closepath_stroke' => ['bool', 'psdoc'=>'resource'], 'ps_continue_text' => ['bool', 'psdoc'=>'resource', 'text'=>'string'], 'ps_curveto' => ['bool', 'psdoc'=>'resource', 'x1'=>'float', 'y1'=>'float', 'x2'=>'float', 'y2'=>'float', 'x3'=>'float', 'y3'=>'float'], 'ps_delete' => ['bool', 'psdoc'=>'resource'], 'ps_end_page' => ['bool', 'psdoc'=>'resource'], 'ps_end_pattern' => ['bool', 'psdoc'=>'resource'], 'ps_end_template' => ['bool', 'psdoc'=>'resource'], 'ps_fill' => ['bool', 'psdoc'=>'resource'], 'ps_fill_stroke' => ['bool', 'psdoc'=>'resource'], 'ps_findfont' => ['int', 'psdoc'=>'resource', 'fontname'=>'string', 'encoding'=>'string', 'embed='=>'bool'], 'ps_get_buffer' => ['string', 'psdoc'=>'resource'], 'ps_get_parameter' => ['string', 'psdoc'=>'resource', 'name'=>'string', 'modifier='=>'float'], 'ps_get_value' => ['float', 'psdoc'=>'resource', 'name'=>'string', 'modifier='=>'float'], 'ps_hyphenate' => ['array', 'psdoc'=>'resource', 'text'=>'string'], 'ps_include_file' => ['bool', 'psdoc'=>'resource', 'file'=>'string'], 'ps_lineto' => ['bool', 'psdoc'=>'resource', 'x'=>'float', 'y'=>'float'], 'ps_makespotcolor' => ['int', 'psdoc'=>'resource', 'name'=>'string', 'reserved='=>'int'], 'ps_moveto' => ['bool', 'psdoc'=>'resource', 'x'=>'float', 'y'=>'float'], 'ps_new' => ['resource'], 'ps_open_file' => ['bool', 'psdoc'=>'resource', 'filename='=>'string'], 'ps_open_image' => ['int', 'psdoc'=>'resource', 'type'=>'string', 'source'=>'string', 'data'=>'string', 'length'=>'int', 'width'=>'int', 'height'=>'int', 'components'=>'int', 'bpc'=>'int', 'params'=>'string'], 'ps_open_image_file' => ['int', 'psdoc'=>'resource', 'type'=>'string', 'filename'=>'string', 'stringparam='=>'string', 'intparam='=>'int'], 'ps_open_memory_image' => ['int', 'psdoc'=>'resource', 'gd'=>'int'], 'ps_place_image' => ['bool', 'psdoc'=>'resource', 'imageid'=>'int', 'x'=>'float', 'y'=>'float', 'scale'=>'float'], 'ps_rect' => ['bool', 'psdoc'=>'resource', 'x'=>'float', 'y'=>'float', 'width'=>'float', 'height'=>'float'], 'ps_restore' => ['bool', 'psdoc'=>'resource'], 'ps_rotate' => ['bool', 'psdoc'=>'resource', 'rot'=>'float'], 'ps_save' => ['bool', 'psdoc'=>'resource'], 'ps_scale' => ['bool', 'psdoc'=>'resource', 'x'=>'float', 'y'=>'float'], 'ps_set_border_color' => ['bool', 'psdoc'=>'resource', 'red'=>'float', 'green'=>'float', 'blue'=>'float'], 'ps_set_border_dash' => ['bool', 'psdoc'=>'resource', 'black'=>'float', 'white'=>'float'], 'ps_set_border_style' => ['bool', 'psdoc'=>'resource', 'style'=>'string', 'width'=>'float'], 'ps_set_info' => ['bool', 'p'=>'resource', 'key'=>'string', 'val'=>'string'], 'ps_set_parameter' => ['bool', 'psdoc'=>'resource', 'name'=>'string', 'value'=>'string'], 'ps_set_text_pos' => ['bool', 'psdoc'=>'resource', 'x'=>'float', 'y'=>'float'], 'ps_set_value' => ['bool', 'psdoc'=>'resource', 'name'=>'string', 'value'=>'float'], 'ps_setcolor' => ['bool', 'psdoc'=>'resource', 'type'=>'string', 'colorspace'=>'string', 'c1'=>'float', 'c2'=>'float', 'c3'=>'float', 'c4'=>'float'], 'ps_setdash' => ['bool', 'psdoc'=>'resource', 'on'=>'float', 'off'=>'float'], 'ps_setflat' => ['bool', 'psdoc'=>'resource', 'value'=>'float'], 'ps_setfont' => ['bool', 'psdoc'=>'resource', 'fontid'=>'int', 'size'=>'float'], 'ps_setgray' => ['bool', 'psdoc'=>'resource', 'gray'=>'float'], 'ps_setlinecap' => ['bool', 'psdoc'=>'resource', 'type'=>'int'], 'ps_setlinejoin' => ['bool', 'psdoc'=>'resource', 'type'=>'int'], 'ps_setlinewidth' => ['bool', 'psdoc'=>'resource', 'width'=>'float'], 'ps_setmiterlimit' => ['bool', 'psdoc'=>'resource', 'value'=>'float'], 'ps_setoverprintmode' => ['bool', 'psdoc'=>'resource', 'mode'=>'int'], 'ps_setpolydash' => ['bool', 'psdoc'=>'resource', 'arr'=>'float'], 'ps_shading' => ['int', 'psdoc'=>'resource', 'type'=>'string', 'x0'=>'float', 'y0'=>'float', 'x1'=>'float', 'y1'=>'float', 'c1'=>'float', 'c2'=>'float', 'c3'=>'float', 'c4'=>'float', 'optlist'=>'string'], 'ps_shading_pattern' => ['int', 'psdoc'=>'resource', 'shadingid'=>'int', 'optlist'=>'string'], 'ps_shfill' => ['bool', 'psdoc'=>'resource', 'shadingid'=>'int'], 'ps_show' => ['bool', 'psdoc'=>'resource', 'text'=>'string'], 'ps_show2' => ['bool', 'psdoc'=>'resource', 'text'=>'string', 'len'=>'int'], 'ps_show_boxed' => ['int', 'psdoc'=>'resource', 'text'=>'string', 'left'=>'float', 'bottom'=>'float', 'width'=>'float', 'height'=>'float', 'hmode'=>'string', 'feature='=>'string'], 'ps_show_xy' => ['bool', 'psdoc'=>'resource', 'text'=>'string', 'x'=>'float', 'y'=>'float'], 'ps_show_xy2' => ['bool', 'psdoc'=>'resource', 'text'=>'string', 'len'=>'int', 'xcoor'=>'float', 'ycoor'=>'float'], 'ps_string_geometry' => ['array', 'psdoc'=>'resource', 'text'=>'string', 'fontid='=>'int', 'size='=>'float'], 'ps_stringwidth' => ['float', 'psdoc'=>'resource', 'text'=>'string', 'fontid='=>'int', 'size='=>'float'], 'ps_stroke' => ['bool', 'psdoc'=>'resource'], 'ps_symbol' => ['bool', 'psdoc'=>'resource', 'ord'=>'int'], 'ps_symbol_name' => ['string', 'psdoc'=>'resource', 'ord'=>'int', 'fontid='=>'int'], 'ps_symbol_width' => ['float', 'psdoc'=>'resource', 'ord'=>'int', 'fontid='=>'int', 'size='=>'float'], 'ps_translate' => ['bool', 'psdoc'=>'resource', 'x'=>'float', 'y'=>'float'], 'pspell_add_to_personal' => ['bool', 'pspell'=>'int', 'word'=>'string'], 'pspell_add_to_session' => ['bool', 'pspell'=>'int', 'word'=>'string'], 'pspell_check' => ['bool', 'pspell'=>'int', 'word'=>'string'], 'pspell_clear_session' => ['bool', 'pspell'=>'int'], 'pspell_config_create' => ['int|false', 'language'=>'string', 'spelling='=>'string', 'jargon='=>'string', 'encoding='=>'string'], 'pspell_config_data_dir' => ['bool', 'conf'=>'int', 'directory'=>'string'], 'pspell_config_dict_dir' => ['bool', 'conf'=>'int', 'directory'=>'string'], 'pspell_config_ignore' => ['bool', 'conf'=>'int', 'ignore'=>'int'], 'pspell_config_mode' => ['bool', 'conf'=>'int', 'mode'=>'int'], 'pspell_config_personal' => ['bool', 'conf'=>'int', 'personal'=>'string'], 'pspell_config_repl' => ['bool', 'conf'=>'int', 'repl'=>'string'], 'pspell_config_runtogether' => ['bool', 'conf'=>'int', 'runtogether'=>'bool'], 'pspell_config_save_repl' => ['bool', 'conf'=>'int', 'save'=>'bool'], 'pspell_new' => ['int|false', 'language'=>'string', 'spelling='=>'string', 'jargon='=>'string', 'encoding='=>'string', 'mode='=>'int'], 'pspell_new_config' => ['int|false', 'config'=>'int'], 'pspell_new_personal' => ['int|false', 'personal'=>'string', 'language'=>'string', 'spelling='=>'string', 'jargon='=>'string', 'encoding='=>'string', 'mode='=>'int'], 'pspell_save_wordlist' => ['bool', 'pspell'=>'int'], 'pspell_store_replacement' => ['bool', 'pspell'=>'int', 'misspell'=>'string', 'correct'=>'string'], 'pspell_suggest' => ['array|false', 'pspell'=>'int', 'word'=>'string'], 'putenv' => ['bool', 'setting'=>'string'], 'px_close' => ['bool', 'pxdoc'=>'resource'], 'px_create_fp' => ['bool', 'pxdoc'=>'resource', 'file'=>'resource', 'fielddesc'=>'array'], 'px_date2string' => ['string', 'pxdoc'=>'resource', 'value'=>'int', 'format'=>'string'], 'px_delete' => ['bool', 'pxdoc'=>'resource'], 'px_delete_record' => ['bool', 'pxdoc'=>'resource', 'num'=>'int'], 'px_get_field' => ['array', 'pxdoc'=>'resource', 'fieldno'=>'int'], 'px_get_info' => ['array', 'pxdoc'=>'resource'], 'px_get_parameter' => ['string', 'pxdoc'=>'resource', 'name'=>'string'], 'px_get_record' => ['array', 'pxdoc'=>'resource', 'num'=>'int', 'mode='=>'int'], 'px_get_schema' => ['array', 'pxdoc'=>'resource', 'mode='=>'int'], 'px_get_value' => ['float', 'pxdoc'=>'resource', 'name'=>'string'], 'px_insert_record' => ['int', 'pxdoc'=>'resource', 'data'=>'array'], 'px_new' => ['resource'], 'px_numfields' => ['int', 'pxdoc'=>'resource'], 'px_numrecords' => ['int', 'pxdoc'=>'resource'], 'px_open_fp' => ['bool', 'pxdoc'=>'resource', 'file'=>'resource'], 'px_put_record' => ['bool', 'pxdoc'=>'resource', 'record'=>'array', 'recpos='=>'int'], 'px_retrieve_record' => ['array', 'pxdoc'=>'resource', 'num'=>'int', 'mode='=>'int'], 'px_set_blob_file' => ['bool', 'pxdoc'=>'resource', 'filename'=>'string'], 'px_set_parameter' => ['bool', 'pxdoc'=>'resource', 'name'=>'string', 'value'=>'string'], 'px_set_tablename' => ['void', 'pxdoc'=>'resource', 'name'=>'string'], 'px_set_targetencoding' => ['bool', 'pxdoc'=>'resource', 'encoding'=>'string'], 'px_set_value' => ['bool', 'pxdoc'=>'resource', 'name'=>'string', 'value'=>'float'], 'px_timestamp2string' => ['string', 'pxdoc'=>'resource', 'value'=>'float', 'format'=>'string'], 'px_update_record' => ['bool', 'pxdoc'=>'resource', 'data'=>'array', 'num'=>'int'], 'qdom_error' => ['string'], 'qdom_tree' => ['QDomDocument', 'doc'=>'string'], 'querymapObj::convertToString' => ['string'], 'querymapObj::free' => ['void'], 'querymapObj::set' => ['int', 'property_name'=>'string', 'new_value'=>''], 'querymapObj::updateFromString' => ['int', 'snippet'=>'string'], 'QuickHashIntHash::__construct' => ['void', 'size'=>'int', 'options='=>'int'], 'QuickHashIntHash::add' => ['bool', 'key'=>'int', 'value='=>'int'], 'QuickHashIntHash::delete' => ['bool', 'key'=>'int'], 'QuickHashIntHash::exists' => ['bool', 'key'=>'int'], 'QuickHashIntHash::get' => ['int', 'key'=>'int'], 'QuickHashIntHash::getSize' => ['int'], 'QuickHashIntHash::loadFromFile' => ['QuickHashIntHash', 'filename'=>'string', 'options='=>'int'], 'QuickHashIntHash::loadFromString' => ['QuickHashIntHash', 'contents'=>'string', 'options='=>'int'], 'QuickHashIntHash::saveToFile' => ['void', 'filename'=>'string'], 'QuickHashIntHash::saveToString' => ['string'], 'QuickHashIntHash::set' => ['bool', 'key'=>'int', 'value'=>'int'], 'QuickHashIntHash::update' => ['bool', 'key'=>'int', 'value'=>'int'], 'QuickHashIntSet::__construct' => ['void', 'size'=>'int', 'options='=>'int'], 'QuickHashIntSet::add' => ['bool', 'key'=>'int'], 'QuickHashIntSet::delete' => ['bool', 'key'=>'int'], 'QuickHashIntSet::exists' => ['bool', 'key'=>'int'], 'QuickHashIntSet::getSize' => ['int'], 'QuickHashIntSet::loadFromFile' => ['QuickHashIntSet', 'filename'=>'string', 'size='=>'int', 'options='=>'int'], 'QuickHashIntSet::loadFromString' => ['QuickHashIntSet', 'contents'=>'string', 'size='=>'int', 'options='=>'int'], 'QuickHashIntSet::saveToFile' => ['void', 'filename'=>'string'], 'QuickHashIntSet::saveToString' => ['string'], 'QuickHashIntStringHash::__construct' => ['void', 'size'=>'int', 'options='=>'int'], 'QuickHashIntStringHash::add' => ['bool', 'key'=>'int', 'value'=>'string'], 'QuickHashIntStringHash::delete' => ['bool', 'key'=>'int'], 'QuickHashIntStringHash::exists' => ['bool', 'key'=>'int'], 'QuickHashIntStringHash::get' => ['mixed', 'key'=>'int'], 'QuickHashIntStringHash::getSize' => ['int'], 'QuickHashIntStringHash::loadFromFile' => ['QuickHashIntStringHash', 'filename'=>'string', 'size='=>'int', 'options='=>'int'], 'QuickHashIntStringHash::loadFromString' => ['QuickHashIntStringHash', 'contents'=>'string', 'size='=>'int', 'options='=>'int'], 'QuickHashIntStringHash::saveToFile' => ['void', 'filename'=>'string'], 'QuickHashIntStringHash::saveToString' => ['string'], 'QuickHashIntStringHash::set' => ['int', 'key'=>'int', 'value'=>'string'], 'QuickHashIntStringHash::update' => ['bool', 'key'=>'int', 'value'=>'string'], 'QuickHashStringIntHash::__construct' => ['void', 'size'=>'int', 'options='=>'int'], 'QuickHashStringIntHash::add' => ['bool', 'key'=>'string', 'value'=>'int'], 'QuickHashStringIntHash::delete' => ['bool', 'key'=>'string'], 'QuickHashStringIntHash::exists' => ['bool', 'key'=>'string'], 'QuickHashStringIntHash::get' => ['mixed', 'key'=>'string'], 'QuickHashStringIntHash::getSize' => ['int'], 'QuickHashStringIntHash::loadFromFile' => ['QuickHashStringIntHash', 'filename'=>'string', 'size='=>'int', 'options='=>'int'], 'QuickHashStringIntHash::loadFromString' => ['QuickHashStringIntHash', 'contents'=>'string', 'size='=>'int', 'options='=>'int'], 'QuickHashStringIntHash::saveToFile' => ['void', 'filename'=>'string'], 'QuickHashStringIntHash::saveToString' => ['string'], 'QuickHashStringIntHash::set' => ['int', 'key'=>'string', 'value'=>'int'], 'QuickHashStringIntHash::update' => ['bool', 'key'=>'string', 'value'=>'int'], 'quoted_printable_decode' => ['string', 'str'=>'string'], 'quoted_printable_encode' => ['string', 'str'=>'string'], 'quotemeta' => ['string', 'str'=>'string'], 'rad2deg' => ['float', 'number'=>'float'], 'radius_acct_open' => ['resource|false'], 'radius_add_server' => ['bool', 'radius_handle'=>'resource', 'hostname'=>'string', 'port'=>'int', 'secret'=>'string', 'timeout'=>'int', 'max_tries'=>'int'], 'radius_auth_open' => ['resource|false'], 'radius_close' => ['bool', 'radius_handle'=>'resource'], 'radius_config' => ['bool', 'radius_handle'=>'resource', 'file'=>'string'], 'radius_create_request' => ['bool', 'radius_handle'=>'resource', 'type'=>'int'], 'radius_cvt_addr' => ['string', 'data'=>'string'], 'radius_cvt_int' => ['int', 'data'=>'string'], 'radius_cvt_string' => ['string', 'data'=>'string'], 'radius_demangle' => ['string', 'radius_handle'=>'resource', 'mangled'=>'string'], 'radius_demangle_mppe_key' => ['string', 'radius_handle'=>'resource', 'mangled'=>'string'], 'radius_get_attr' => ['mixed', 'radius_handle'=>'resource'], 'radius_get_tagged_attr_data' => ['string', 'data'=>'string'], 'radius_get_tagged_attr_tag' => ['int', 'data'=>'string'], 'radius_get_vendor_attr' => ['array', 'data'=>'string'], 'radius_put_addr' => ['bool', 'radius_handle'=>'resource', 'type'=>'int', 'addr'=>'string'], 'radius_put_attr' => ['bool', 'radius_handle'=>'resource', 'type'=>'int', 'value'=>'string'], 'radius_put_int' => ['bool', 'radius_handle'=>'resource', 'type'=>'int', 'value'=>'int'], 'radius_put_string' => ['bool', 'radius_handle'=>'resource', 'type'=>'int', 'value'=>'string'], 'radius_put_vendor_addr' => ['bool', 'radius_handle'=>'resource', 'vendor'=>'int', 'type'=>'int', 'addr'=>'string'], 'radius_put_vendor_attr' => ['bool', 'radius_handle'=>'resource', 'vendor'=>'int', 'type'=>'int', 'value'=>'string'], 'radius_put_vendor_int' => ['bool', 'radius_handle'=>'resource', 'vendor'=>'int', 'type'=>'int', 'value'=>'int'], 'radius_put_vendor_string' => ['bool', 'radius_handle'=>'resource', 'vendor'=>'int', 'type'=>'int', 'value'=>'string'], 'radius_request_authenticator' => ['string', 'radius_handle'=>'resource'], 'radius_salt_encrypt_attr' => ['string', 'radius_handle'=>'resource', 'data'=>'string'], 'radius_send_request' => ['int', 'radius_handle'=>'resource'], 'radius_server_secret' => ['string', 'radius_handle'=>'resource'], 'radius_strerror' => ['string', 'radius_handle'=>'resource'], 'rand' => ['int', 'min'=>'int', 'max'=>'int'], 'rand\'1' => ['int'], 'random_bytes' => ['non-empty-string', 'length'=>'positive-int'], 'random_int' => ['int', 'min'=>'int', 'max'=>'int'], 'range' => ['array', 'low'=>'int|float|string', 'high'=>'int|float|string', 'step='=>'int|float'], 'RangeException::__clone' => ['void'], 'RangeException::__construct' => ['void', 'message='=>'string', 'code='=>'int', 'previous='=>'(?Throwable)|(?RangeException)'], 'RangeException::__toString' => ['string'], 'RangeException::getCode' => ['int'], 'RangeException::getFile' => ['string'], 'RangeException::getLine' => ['int'], 'RangeException::getMessage' => ['string'], 'RangeException::getPrevious' => ['Throwable|RangeException|null'], 'RangeException::getTrace' => ['list<array{function:string,line?:int,file?:string,class?:class-string,type?:\'::\'|\'->\',args?:mixed[],object?:object}>'], 'RangeException::getTraceAsString' => ['string'], 'rar_allow_broken_set' => ['bool', 'rarfile'=>'RarArchive', 'allow_broken'=>'bool'], 'rar_broken_is' => ['bool', 'rarfile'=>'RarArchive'], 'rar_close' => ['bool', 'rarfile'=>'RarArchive'], 'rar_comment_get' => ['string|null', 'rarfile'=>'RarArchive'], 'rar_entry_get' => ['RarEntry|false', 'rarfile'=>'RarArchive', 'entryname'=>'string'], 'rar_list' => ['RarEntry[]|false', 'rarfile'=>'RarArchive'], 'rar_open' => ['RarArchive|false', 'filename'=>'string', 'password='=>'string', 'volume_callback='=>'callable'], 'rar_solid_is' => ['bool', 'rarfile'=>'RarArchive'], 'rar_wrapper_cache_stats' => ['string'], 'RarArchive::__toString' => ['string'], 'RarArchive::close' => ['bool'], 'RarArchive::getComment' => ['string|null'], 'RarArchive::getEntries' => ['RarEntry[]|false'], 'RarArchive::getEntry' => ['RarEntry|false', 'entryname'=>'string'], 'RarArchive::isBroken' => ['bool'], 'RarArchive::isSolid' => ['bool'], 'RarArchive::open' => ['RarArchive|false', 'filename'=>'string', 'password='=>'string', 'volume_callback='=>'callable'], 'RarArchive::setAllowBroken' => ['bool', 'allow_broken'=>'bool'], 'RarEntry::__toString' => ['string'], 'RarEntry::extract' => ['bool', 'dir'=>'string', 'filepath='=>'string', 'password='=>'string', 'extended_data='=>'bool'], 'RarEntry::getAttr' => ['int'], 'RarEntry::getCrc' => ['string'], 'RarEntry::getFileTime' => ['string'], 'RarEntry::getHostOs' => ['int'], 'RarEntry::getMethod' => ['int'], 'RarEntry::getName' => ['string'], 'RarEntry::getPackedSize' => ['int'], 'RarEntry::getPosition' => ['int'], 'RarEntry::getRedirTarget' => ['string|bool'], 'RarEntry::getRedirType' => ['int|false|null'], 'RarEntry::getStream' => ['resource|false', 'password='=>'string'], 'RarEntry::getUnpackedSize' => ['int'], 'RarEntry::getVersion' => ['int'], 'RarEntry::isDirectory' => ['bool'], 'RarEntry::isEncrypted' => ['bool'], 'RarEntry::isRedirectToDirectory' => ['bool|null'], 'RarException::getCode' => ['int'], 'RarException::getFile' => ['string'], 'RarException::getLine' => ['int'], 'RarException::getMessage' => ['string'], 'RarException::getPrevious' => ['Exception|Throwable'], 'RarException::getTrace' => ['list<array{function:string,line?:int,file?:string,class?:class-string,type?:\'::\'|\'->\',args?:mixed[],object?:object}>'], 'RarException::getTraceAsString' => ['string'], 'RarException::isUsingExceptions' => ['bool'], 'RarException::setUsingExceptions' => ['void', 'using_exceptions'=>'bool'], 'rawurldecode' => ['string', 'str'=>'string'], 'rawurlencode' => ['string', 'str'=>'string'], 'read_exif_data' => ['array', 'filename'=>'string|resource', 'sections_needed='=>'string', 'sub_arrays='=>'bool', 'read_thumbnail='=>'bool'], 'readdir' => ['non-empty-string|false', 'dir_handle='=>'resource'], 'readfile' => ['0|positive-int|false', 'filename'=>'string', 'use_include_path='=>'bool', 'context='=>'resource'], 'readgzfile' => ['0|positive-int|false', 'filename'=>'string', 'use_include_path='=>'int'], 'readline' => ['string|false', 'prompt='=>'?string'], 'readline_add_history' => ['bool', 'prompt'=>'string'], 'readline_callback_handler_install' => ['bool', 'prompt'=>'string', 'callback'=>'callable'], 'readline_callback_handler_remove' => ['bool'], 'readline_callback_read_char' => ['void'], 'readline_clear_history' => ['bool'], 'readline_completion_function' => ['bool', 'funcname'=>'callable'], 'readline_info' => ['mixed', 'varname='=>'string', 'newvalue='=>'string'], 'readline_list_history' => ['array'], 'readline_on_new_line' => ['void'], 'readline_read_history' => ['bool', 'filename='=>'string'], 'readline_redisplay' => ['void'], 'readline_write_history' => ['bool', 'filename='=>'string'], 'readlink' => ['string|false', 'filename'=>'string'], 'realpath' => ['non-empty-string|false', 'path'=>'string'], 'realpath_cache_get' => ['array'], 'realpath_cache_size' => ['int'], 'recode' => ['string', 'request'=>'string', 'str'=>'string'], 'recode_file' => ['bool', 'request'=>'string', 'input'=>'resource', 'output'=>'resource'], 'recode_string' => ['string', 'request'=>'string', 'str'=>'string'], 'rectObj::__construct' => ['void'], 'rectObj::draw' => ['int', 'map'=>'mapObj', 'layer'=>'layerObj', 'img'=>'imageObj', 'class_index'=>'int', 'text'=>'string'], 'rectObj::fit' => ['float', 'width'=>'int', 'height'=>'int'], 'rectObj::ms_newRectObj' => ['rectObj'], 'rectObj::project' => ['int', 'in'=>'projectionObj', 'out'=>'projectionObj'], 'rectObj::set' => ['int', 'property_name'=>'string', 'new_value'=>''], 'rectObj::setextent' => ['void', 'minx'=>'float', 'miny'=>'float', 'maxx'=>'float', 'maxy'=>'float'], 'RecursiveArrayIterator::__construct' => ['void', 'array='=>'array|object', 'flags='=>'int'], 'RecursiveArrayIterator::append' => ['void', 'value'=>'mixed'], 'RecursiveArrayIterator::asort' => ['void'], 'RecursiveArrayIterator::count' => ['0|positive-int'], 'RecursiveArrayIterator::current' => ['mixed'], 'RecursiveArrayIterator::getArrayCopy' => ['array'], 'RecursiveArrayIterator::getChildren' => ['RecursiveArrayIterator'], 'RecursiveArrayIterator::getFlags' => ['void'], 'RecursiveArrayIterator::hasChildren' => ['bool'], 'RecursiveArrayIterator::key' => ['false|int|string'], 'RecursiveArrayIterator::ksort' => ['void'], 'RecursiveArrayIterator::natcasesort' => ['void'], 'RecursiveArrayIterator::natsort' => ['void'], 'RecursiveArrayIterator::next' => ['void'], 'RecursiveArrayIterator::offsetExists' => ['void', 'index'=>'string'], 'RecursiveArrayIterator::offsetGet' => ['mixed', 'index'=>'string'], 'RecursiveArrayIterator::offsetSet' => ['void', 'index'=>'string', 'newval'=>'string'], 'RecursiveArrayIterator::offsetUnset' => ['void', 'index'=>'string'], 'RecursiveArrayIterator::rewind' => ['void'], 'RecursiveArrayIterator::seek' => ['void', 'position'=>'int'], 'RecursiveArrayIterator::serialize' => ['string'], 'RecursiveArrayIterator::setFlags' => ['void', 'flags'=>'string'], 'RecursiveArrayIterator::uasort' => ['void', 'callback'=>'callable(mixed,mixed):int'], 'RecursiveArrayIterator::uksort' => ['void', 'callback'=>'callable(array-key,array-key):int'], 'RecursiveArrayIterator::unserialize' => ['string', 'serialized'=>'string'], 'RecursiveArrayIterator::valid' => ['bool'], 'RecursiveCachingIterator::__construct' => ['void', 'iterator'=>'Iterator', 'flags'=>''], 'RecursiveCachingIterator::getChildren' => ['RecursiveCachingIterator'], 'RecursiveCachingIterator::hasChildren' => ['bool'], 'RecursiveCallbackFilterIterator::__construct' => ['void', 'iterator'=>'RecursiveIterator', 'func'=>'callable'], 'RecursiveCallbackFilterIterator::getChildren' => ['RecursiveCallbackFilterIterator'], 'RecursiveCallbackFilterIterator::hasChildren' => ['void'], 'RecursiveDirectoryIterator::__construct' => ['void', 'path'=>'string', 'flags='=>'int'], 'RecursiveDirectoryIterator::getChildren' => ['object'], 'RecursiveDirectoryIterator::getSubPath' => ['string'], 'RecursiveDirectoryIterator::getSubPathname' => ['string'], 'RecursiveDirectoryIterator::hasChildren' => ['bool', 'allow_links='=>'bool'], 'RecursiveDirectoryIterator::key' => ['string'], 'RecursiveDirectoryIterator::next' => ['void'], 'RecursiveDirectoryIterator::rewind' => ['void'], 'RecursiveFilterIterator::__construct' => ['void', 'iterator'=>'RecursiveIterator'], 'RecursiveFilterIterator::getChildren' => ['RecursiveFilterIterator'], 'RecursiveFilterIterator::hasChildren' => ['bool'], 'RecursiveIterator::getChildren' => ['RecursiveIterator'], 'RecursiveIterator::hasChildren' => ['bool'], 'RecursiveIteratorIterator::__construct' => ['void', 'iterator'=>'RecursiveIterator|IteratorAggregate', 'mode='=>'int', 'flags='=>'int'], 'RecursiveIteratorIterator::beginChildren' => ['void'], 'RecursiveIteratorIterator::beginIteration' => ['RecursiveIterator'], 'RecursiveIteratorIterator::callGetChildren' => ['RecursiveIterator'], 'RecursiveIteratorIterator::callHasChildren' => ['bool'], 'RecursiveIteratorIterator::current' => ['mixed'], 'RecursiveIteratorIterator::endChildren' => ['void'], 'RecursiveIteratorIterator::endIteration' => ['RecursiveIterator'], 'RecursiveIteratorIterator::getDepth' => ['int'], 'RecursiveIteratorIterator::getInnerIterator' => ['RecursiveIterator'], 'RecursiveIteratorIterator::getMaxDepth' => ['int|false'], 'RecursiveIteratorIterator::getSubIterator' => ['RecursiveIterator', 'level='=>'int'], 'RecursiveIteratorIterator::key' => ['mixed'], 'RecursiveIteratorIterator::next' => ['void'], 'RecursiveIteratorIterator::nextElement' => ['void'], 'RecursiveIteratorIterator::rewind' => ['void'], 'RecursiveIteratorIterator::setMaxDepth' => ['void', 'max_depth='=>'int'], 'RecursiveIteratorIterator::valid' => ['bool'], 'RecursiveRegexIterator::__construct' => ['void', 'iterator'=>'RecursiveIterator', 'regex='=>'string', 'mode='=>'int', 'flags='=>'int', 'preg_flags='=>'int'], 'RecursiveRegexIterator::getChildren' => ['RecursiveRegexIterator'], 'RecursiveRegexIterator::hasChildren' => ['bool'], 'RecursiveTreeIterator::__construct' => ['void', 'iterator'=>'RecursiveIterator|IteratorAggregate', 'flags='=>'int', 'cit_flags='=>'int', 'mode='=>'int'], 'RecursiveTreeIterator::beginChildren' => ['void'], 'RecursiveTreeIterator::beginIteration' => ['RecursiveIterator'], 'RecursiveTreeIterator::callGetChildren' => ['RecursiveIterator'], 'RecursiveTreeIterator::callHasChildren' => ['bool'], 'RecursiveTreeIterator::current' => ['string'], 'RecursiveTreeIterator::endChildren' => ['void'], 'RecursiveTreeIterator::endIteration' => ['void'], 'RecursiveTreeIterator::getEntry' => ['string'], 'RecursiveTreeIterator::getPostfix' => ['string'], 'RecursiveTreeIterator::getPrefix' => ['string'], 'RecursiveTreeIterator::key' => ['string'], 'RecursiveTreeIterator::next' => ['void'], 'RecursiveTreeIterator::nextElement' => ['void'], 'RecursiveTreeIterator::rewind' => ['void'], 'RecursiveTreeIterator::setPostfix' => ['void', 'prefix'=>'string'], 'RecursiveTreeIterator::setPrefixPart' => ['void', 'part'=>'int', 'prefix'=>'string'], 'RecursiveTreeIterator::valid' => ['bool'], 'Redis::__construct' => ['void', 'options='=>'?array{host?:string,port?:int,connectTimeout?:float,auth?:list{string|null|false,string}|list{string},ssl?:array<string, mixed>,backoff?:array<string, mixed>}'], 'Redis::_compress' => ['string', 'value'=>'string'], 'Redis::_uncompress' => ['string', 'value'=>'string'], 'Redis::_prefix' => ['string', 'key'=>'mixed'], 'Redis::_serialize' => ['mixed', 'value'=>'string'], 'Redis::_unserialize' => ['string', 'value'=>'mixed'], 'Redis::_pack' => ['mixed', 'value'=>'string'], 'Redis::_unpack' => ['string', 'value'=>'mixed'], 'Redis::acl' => ['mixed', 'subcmd'=>'string', '...args='=>'string'], 'Redis::append' => ['__benevolent<Redis|int|false>', 'key'=>'string', 'value'=>'string'], 'Redis::auth' => ['__benevolent<Redis|bool>', 'credentials'=>'string|string[]'], 'Redis::bgrewriteaof' => ['__benevolent<Redis|bool>'], 'Redis::bgSave' => ['__benevolent<Redis|bool>'], 'Redis::bitcount' => ['__benevolent<Redis|int|false>', 'key'=>'string', 'start='=>'int', 'end='=>'int', 'bybit='=>'bool'], 'Redis::bitop' => ['__benevolent<Redis|int|false>', 'operation'=>'string', 'deskey'=>'string', 'srckey'=>'string', '...other_keys'=>'string'], 'Redis::bitpos' => ['__benevolent<Redis|int|false>', 'key'=>'string', 'bit'=>'bool', 'start='=>'int', 'end='=>'int', 'bybit='=>'bool'], 'Redis::blmove' => ['__benevolent<Redis|string|false>', 'src'=>'string', 'dst'=>'string', 'wherefrom'=>'string', 'whereto'=>'string', 'timeout'=>'float'], 'Redis::blmpop' => ['__benevolent<Redis|mixed[]|null|false>', 'timeout'=>'float', 'keys'=>'string[]', 'from'=>'string', 'count='=>'int'], 'Redis::blPop' => ['__benevolent<Redis|mixed[]|null|false>', 'key_or_keys'=>'string|string[]', 'timeout_or_key'=>'string|float|int', '...extra_args'=>'mixed'], 'Redis::blPop\'1' => ['array', 'key'=>'string', 'timeout_or_key'=>'int|string', '...extra_args'=>'int|string'], 'Redis::brPop' => ['__benevolent<Redis|mixed[]|null|false>', 'key_or_keys'=>'string|string[]', 'timeout_or_key'=>'string|float|int', '...extra_args'=>'mixed'], 'Redis::brPop\'1' => ['array', 'key'=>'string', 'timeout_or_key'=>'int|string', '...extra_args'=>'int|string'], 'Redis::brpoplpush' => ['__benevolent<Redis|string|false>', 'src'=>'string', 'dst'=>'string', 'timeout'=>'int|float'], 'Redis::bzPopMax' => ['__benevolent<Redis|mixed[]|false>', 'key'=>'string|string[]', 'timeout_or_key'=>'string|int', '...extra_args'=>'mixed'], 'Redis::bzPopMin' => ['__benevolent<Redis|mixed[]|false>', 'key'=>'string|string[]', 'timeout_or_key'=>'string|int', '...extra_args'=>'mixed'], 'Redis::bzmpop' => ['__benevolent<Redis|mixed[]|null|false>', 'timeout'=>'float', 'keys'=>'string[]', 'from'=>'string', 'count='=>'int'], 'Redis::clearLastError' => ['bool'], 'Redis::clearTransferredBytes' => ['void'], 'Redis::client' => ['mixed', 'opt'=>'string', '...args='=>'mixed'], 'Redis::close' => ['bool'], 'Redis::command' => ['mixed', 'opt='=>'?string', '...args'=>'mixed'], 'Redis::config' => ['mixed', 'operation'=>'string', 'key_or_settings='=>'array<string, mixed>|string[]|string|null', 'value='=>'?string'], 'Redis::connect' => ['bool', 'host'=>'string', 'port='=>'int', 'timeout='=>'float', 'persistent_id='=>'?string', 'retry_interval='=>'int', 'read_timeout='=>'float', 'context='=>'?array{auth?:list{string|null|false,string}|list{string},stream?:array<string,mixed>}'], 'Redis::copy' => ['__benevolent<Redis|bool>', 'src'=>'string', 'dst'=>'string', 'options='=>'?array<string, mixed>'], 'Redis::dbSize' => ['__benevolent<Redis|int|false>'], 'Redis::debug' => ['__benevolent<Redis|string>', 'key'=>'string'], 'Redis::decr' => ['__benevolent<Redis|int|false>', 'key'=>'string', 'by='=>'int'], 'Redis::decrBy' => ['__benevolent<Redis|int|false>', 'key'=>'string', 'value'=>'int'], 'Redis::decrByFloat' => ['float', 'key'=>'string', 'value'=>'float'], 'Redis::del' => ['__benevolent<Redis|int|false>', 'key'=>'string[]|string', '...other_keys='=>'string'], 'Redis::del\'1' => ['int', 'key'=>'string[]'], 'Redis::delete' => ['__benevolent<Redis|int|false>', 'key'=>'string[]|string', '...other_keys='=>'string'], 'Redis::delete\'1' => ['int', 'key'=>'string[]'], 'Redis::discard' => ['__benevolent<Redis|bool>'], 'Redis::dump' => ['__benevolent<Redis|string>', 'key'=>'string'], 'Redis::echo' => ['__benevolent<Redis|string|false>', 'str'=>'string'], 'Redis::eval' => ['mixed', 'script'=>'string', 'args='=>'array', 'num_keys='=>'int'], 'Redis::eval_ro' => ['mixed', 'script'=>'string', 'args='=>'array', 'num_keys='=>'int'], 'Redis::evalsha' => ['mixed', 'sha1'=>'string', 'args='=>'array', 'num_keys='=>'int'], 'Redis::evalsha_ro' => ['mixed', 'sha1'=>'string', 'args='=>'array', 'num_keys='=>'int'], 'Redis::evaluate' => ['mixed', 'script'=>'string', 'args='=>'array', 'numKeys='=>'int'], 'Redis::exec' => ['__benevolent<Redis|mixed[]|false>'], 'Redis::exists' => ['__benevolent<Redis|int|bool>', 'keys'=>'string|string[]', '...other_keys='=>'string'], 'Redis::exists\'1' => ['int', '...keys'=>'string'], 'Redis::expire' => ['__benevolent<Redis|bool>', 'key'=>'string', 'timeout'=>'int', 'mode='=>'?string'], 'Redis::expireAt' => ['__benevolent<Redis|bool>', 'key'=>'string', 'timeout'=>'int', 'mode='=>'?string'], 'Redis::expiretime' => ['__benevolent<Redis|int|false>', 'key'=>'string'], 'Redis::failover' => ['__benevolent<Redis|bool>', 'to='=>'?array', 'abort='=>'bool', 'timeout='=>'int'], 'Redis::fcall' => ['mixed', 'fn'=>'string', 'keys='=>'string[]', 'args='=>'array'], 'Redis::fcall_ro' => ['mixed', 'fn'=>'string', 'keys='=>'string[]', 'args='=>'array'], 'Redis::flushAll' => ['__benevolent<Redis|bool>', 'sync='=>'?bool'], 'Redis::flushDb' => ['__benevolent<Redis|bool>', 'sync='=>'?bool'], 'Redis::function' => ['__benevolent<Redis|bool|string|array>', 'operation'=>'string', '...args='=>'mixed'], 'Redis::geoadd' => ['__benevolent<Redis|int|false>', 'key'=>'string', 'lng'=>'float', 'lat'=>'float', 'member'=>'string', '...other_triples_and_options='=>'mixed'], 'Redis::geodist' => ['__benevolent<Redis|float|false>', 'key'=>'string', 'member'=>'string', '...other_members='=>'string'], 'Redis::geohash' => ['__benevolent<Redis|array<int,string>|false>', 'key'=>'string', 'member'=>'string', '...other_members='=>'string'], 'Redis::geopos' => ['__benevolent<Redis|array<int,array{0:string,1:string}>|false>', 'key'=>'string', 'member'=>'string', '...other_members'=>'string'], 'Redis::georadius' => ['__benevolent<Redis|array<int,mixed>>', 'key'=>'string', 'lng'=>'float', 'lat'=>'float', 'radius'=>'float', 'unit'=>'string', 'options='=>'array<string,mixed>'], 'Redis::georadiusbymember' => ['__benevolent<Redis|array<int,mixed>>', 'key'=>'string', 'lng'=>'float', 'lat'=>'float', 'radius'=>'float', 'unit'=>'string', 'options='=>'array<string,mixed>'], 'Redis::georadiusbymember_ro' => ['__benevolent<Redis|array<int,mixed>>', 'key'=>'string', 'lng'=>'float', 'lat'=>'float', 'radius'=>'float', 'unit'=>'string', 'options='=>'array<string,mixed>'], 'Redis::geosearch' => ['__benevolent<Redis|array<int,mixed>>', 'key'=>'string', 'position'=>'array<int,array{0:string,1:string}>|string', 'shape'=>'array<int,array{0:string,1:string}>|int|float', 'unit'=>'string', 'options='=>'array<string,mixed>'], 'Redis::geosearchstore' => ['__benevolent<Redis|array<int,mixed>|int|false>', 'dst'=>'string', 'src'=>'string', 'position'=>'array<int,array{0:string,1:string}>|string', 'shape'=>'array<int,array{0:string,1:string}>|int|float', 'unit'=>'string', 'options='=>'array<string,mixed>'], 'Redis::get' => ['mixed', 'key'=>'string'], 'Redis::getAuth' => ['string|false|null'], 'Redis::getBit' => ['__benevolent<Redis|int|false>', 'key'=>'string', 'idx'=>'int'], 'Redis::getEx' => ['__benevolent<Redis|string|bool>', 'key'=>'string', 'options'=>'?array{EX?:int,PX?:int,EXAT?:int,PXAT?:int,PERSIST?:bool}'], 'Redis::getDBNum' => ['int'], 'Redis::getDel' => ['__benevolent<Redis|string|bool>', 'key'=>'string'], 'Redis::getHost' => ['string'], 'Redis::getKeys' => ['array<int,string>', 'pattern'=>'string'], 'Redis::getLastError' => ['?string'], 'Redis::getMode' => ['int'], 'Redis::getMultiple' => ['array', 'keys'=>'string[]'], 'Redis::getOption' => ['int', 'name'=>'int'], 'Redis::getPersistentID' => ['?string'], 'Redis::getPort' => ['int'], 'Redis::getRange' => ['__benevolent<Redis|string|false>', 'key'=>'string', 'start'=>'int', 'end'=>'int'], 'Redis::getReadTimeout' => ['float'], 'Redis::getset' => ['__benevolent<Redis|string|false>', 'key'=>'string', 'value'=>'mixed'], 'Redis::getTimeout' => ['float|false'], 'Redis::getTransferredBytes' => ['array<int,array{0:int,1:int}>'], 'Redis::hDel' => ['__benevolent<Redis|int|false>', 'key'=>'string', 'field'=>'string', '...other_fields='=>'string'], 'Redis::hExists' => ['__benevolent<Redis|bool>', 'key'=>'string', 'field'=>'string'], 'Redis::hGet' => ['__benevolent<Redis|string|false>', 'key'=>'string', 'member'=>'string'], 'Redis::hGetAll' => ['__benevolent<Redis|string[]|false>', 'key'=>'string'], 'Redis::hIncrBy' => ['__benevolent<Redis|int|false>', 'key'=>'string', 'field'=>'string', 'value'=>'int'], 'Redis::hIncrByFloat' => ['__benevolent<Redis|float|false>', 'key'=>'string', 'field'=>'string', 'value'=>'float'], 'Redis::hKeys' => ['__benevolent<Redis|string[]|false>', 'key'=>'string'], 'Redis::hLen' => ['__benevolent<Redis|int|false>', 'key'=>'string'], 'Redis::hMget' => ['__benevolent<Redis|array<string, mixed>|false>', 'key'=>'string', 'fields'=>'string[]'], 'Redis::hMset' => ['__benevolent<Redis|bool>', 'key'=>'string', 'fieldvals'=>'array'], 'Redis::hRandField' => ['__benevolent<Redis|string|array<string, mixed>>', 'key'=>'string', 'options'=>'?array{COUNT?:int,WITHVALUES?:bool}'], 'Redis::hscan' => ['__benevolent<Redis|array<string, mixed>|bool>', 'key'=>'string', '&iterator'=>'?int', 'pattern='=>'?string', 'count='=>'int'], 'Redis::hSet' => ['__benevolent<Redis|int|false>', 'key'=>'string', 'member'=>'string', 'value'=>'mixed'], 'Redis::hSetNx' => ['__benevolent<Redis|bool>', 'key'=>'string', 'field'=>'string', 'value'=>'string'], 'Redis::hStrLen' => ['__benevolent<Redis|int|false>', 'key'=>'string', 'field'=>'string'], 'Redis::hVals' => ['__benevolent<Redis|string[]|false>', 'key'=>'string'], 'Redis::incr' => ['__benevolent<Redis|int|false>', 'key'=>'string', 'by='=>'int'], 'Redis::incrBy' => ['__benevolent<Redis|int|false>', 'key'=>'string', 'value'=>'int'], 'Redis::incrByFloat' => ['__benevolent<Redis|float|false>', 'key'=>'string', 'value'=>'float'], 'Redis::info' => ['__benevolent<Redis|array<string, mixed>|false>', '...sections='=>'string'], 'Redis::isConnected' => ['bool'], 'Redis::keys' => ['__benevolent<Redis|array<int, string>|false>', 'pattern'=>'string'], 'Redis::lastSave' => ['int'], 'Redis::lcs' => ['__benevolent<Redis|string|array|int|false>', 'key1'=>'string', 'key2'=>'string', 'options'=>'?array{MINMATCHLEN?:int,WITHMATCHLEN?:bool,LEN?:bool,IDX?:bool}'], 'Redis::lGet' => ['', 'key'=>'string', 'index'=>'int'], 'Redis::lGetRange' => ['', 'key'=>'string', 'start'=>'int', 'end'=>'int'], 'Redis::lindex' => ['null|string|false', 'key'=>'string', 'index'=>'int'], 'Redis::lInsert' => ['__benevolent<Redis|int|false>', 'key'=>'string', 'pos'=>'int', 'pivot'=>'mixed', 'value'=>'mixed'], 'Redis::listTrim' => ['', 'key'=>'string', 'start'=>'int', 'stop'=>'int'], 'Redis::lLen' => ['__benevolent<Redis|int|false>', 'key'=>'string'], 'Redis::lMove' => ['__benevolent<Redis|string|false>', 'src'=>'string', 'dst'=>'string', 'wherefrom'=>'string', 'whereto'=>'string'], 'Redis::lmpop' => ['__benevolent<Redis|array<int, mixed>|null|false>', 'keys'=>'string[]', 'from'=>'string', 'count='=>'int'], 'Redis::lPop' => ['__benevolent<Redis|bool|string|mixed[]>', 'key'=>'string', 'count='=>'int'], 'Redis::lPos' => ['__benevolent<Redis|null|bool|int|mixed[]>', 'key'=>'string', 'value'=>'mixed', 'options'=>'?array{COUNT?:int,RANK?:int,MAXLEN?:int}'], 'Redis::lPush' => ['__benevolent<Redis|int|false>', 'key'=>'string', '...elements='=>'mixed'], 'Redis::lPushx' => ['__benevolent<Redis|int|false>', 'key'=>'string', 'value'=>'mixed'], 'Redis::lrange' => ['__benevolent<Redis|mixed[]|false>', 'key'=>'string', 'start'=>'int', 'end'=>'int'], 'Redis::lrem' => ['__benevolent<Redis|int|false>', 'key'=>'string', 'value'=>'mixed', 'count='=>'int'], 'Redis::lSet' => ['__benevolent<Redis|bool>', 'key'=>'string', 'index'=>'int', 'value'=>'mixed'], 'Redis::lSize' => ['', 'key'=>'string'], 'Redis::ltrim' => ['__benevolent<Redis|bool>', 'key'=>'string', 'start'=>'int', 'end'=>'int'], 'Redis::mget' => ['__benevolent<Redis|array<string, mixed>>', 'keys'=>'string[]'], 'Redis::migrate' => ['__benevolent<Redis|bool>', 'host'=>'string', 'port'=>'int', 'key'=>'string|string[]', 'dstdb'=>'int', 'timeout'=>'int', 'copy='=>'bool', 'replace='=>'bool', 'credentials='=>'mixed'], 'Redis::move' => ['__benevolent<Redis|bool>', 'key'=>'string', 'index'=>'int'], 'Redis::mset' => ['__benevolent<Redis|bool>', 'key_values'=>'array<string, mixed>'], 'Redis::msetnx' => ['__benevolent<Redis|bool>', 'key_values'=>'array<string, mixed>'], 'Redis::multi' => ['__benevolent<Redis|bool>', 'value='=>'int'], 'Redis::object' => ['__benevolent<Redis|int|string|false>', 'subcommand'=>'string', 'key'=>'string'], 'Redis::open' => ['bool', 'host'=>'string', 'port='=>'int', 'timeout='=>'float', 'persistent_id='=>'?string', 'retry_interval='=>'int', 'read_timeout='=>'float', 'context='=>'?array{auth?:list{string|null|false,string}|list{string},stream?:array<string,mixed>}'], 'Redis::pconnect' => ['bool', 'host'=>'string', 'port='=>'int', 'timeout='=>'float', 'persistent_id='=>'?string', 'retry_interval='=>'int', 'read_timeout='=>'float', 'context='=>'?array{auth?:list{string|null|false,string}|list{string},stream?:array<string,mixed>}'], 'Redis::persist' => ['__benevolent<Redis|bool>', 'key'=>'string'], 'Redis::pexpire' => ['bool', 'key'=>'string', 'timeout'=>'int', 'mode='=>'?string'], 'Redis::pexpireAt' => ['__benevolent<Redis|bool>', 'key'=>'string', 'timestamp'=>'int', 'mode='=>'?string'], 'Redis::pexpiretime' => ['__benevolent<Redis|int|false>', 'key'=>'string'], 'Redis::pfadd' => ['__benevolent<Redis|int>', 'key'=>'string', 'elements'=>'array'], 'Redis::pfcount' => ['__benevolent<Redis|int|false>', 'key_or_keys'=>'string[]|string'], 'Redis::pfmerge' => ['__benevolent<Redis|bool>', 'dst'=>'string', 'srckeys'=>'string[]'], 'Redis::ping' => ['__benevolent<Redis|string|bool>', 'message='=>'?string'], 'Redis::pipeline' => ['__benevolent<Redis|bool>'], 'Redis::popen' => ['bool', 'host'=>'string', 'port='=>'int', 'timeout='=>'float', 'persistent_id='=>'?string', 'retry_interval='=>'int', 'read_timeout='=>'float', 'context='=>'?array{auth?:list{string|null|false,string}|list{string},stream?:array<string,mixed>}'], 'Redis::psetex' => ['__benevolent<Redis|bool>', 'key'=>'string', 'expire'=>'int', 'value'=>'mixed'], 'Redis::psubscribe' => ['bool', 'patterns'=>'string[]', 'cb'=>'callable'], 'Redis::pttl' => ['__benevolent<Redis|int|false>', 'key'=>'string'], 'Redis::publish' => ['__benevolent<Redis|int|false>', 'channel'=>'string', 'message'=>'string'], 'Redis::pubsub' => ['array|int', 'command'=>'string', 'arg'=>'array|string'], 'Redis::punsubscribe' => ['__benevolent<Redis|array|bool>', 'patterns='=>'string[]'], 'Redis::randomKey' => ['__benevolent<Redis|string|false>'], 'Redis::rawcommand' => ['mixed', 'command'=>'string', '...args='=>'mixed'], 'Redis::rename' => ['__benevolent<Redis|bool>', 'old_name'=>'string', 'new_name'=>'string'], 'Redis::renameKey' => ['bool', 'srckey'=>'string', 'dstkey'=>'string'], 'Redis::renameNx' => ['__benevolent<Redis|bool>', 'old_name'=>'string', 'new_name'=>'string'], 'Redis::reset' => ['__benevolent<Redis|bool>'], 'Redis::resetStat' => ['bool'], 'Redis::restore' => ['__benevolent<Redis|bool>', 'key'=>'string', 'ttl'=>'int', 'value'=>'string', 'options='=>'?array{ABSTTL?:bool,REPLACE?:bool,IDLETIME?:int,FREQ?:int}'], 'Redis::role' => ['mixed'], 'Redis::rPop' => ['__benevolent<Redis|array<string, mixed>|string|bool>', 'key'=>'string', 'count='=>'int'], 'Redis::rpoplpush' => ['__benevolent<Redis|string|false>', 'srckey'=>'string', 'dstkey'=>'string'], 'Redis::rPush' => ['__benevolent<Redis|int|false>', 'key'=>'string', '...elements='=>'mixed'], 'Redis::rPushx' => ['__benevolent<Redis|int|false>', 'key'=>'string', 'value'=>'mixed'], 'Redis::sAdd' => ['__benevolent<Redis|int|false>', 'key'=>'string', 'value'=>'mixed', '...other_values='=>'string'], 'Redis::sAddArray' => ['int', 'key'=>'string', 'values'=>'array'], 'Redis::save' => ['__benevolent<Redis|bool>'], 'Redis::scan' => ['array<int,string>|false', '&iterator'=>'?int', 'pattern='=>'?string', 'count='=>'?int', 'type='=>'?string'], 'Redis::scard' => ['__benevolent<Redis|int|false>', 'key'=>'string'], 'Redis::sContains' => ['', 'key'=>'string', 'value'=>'string'], 'Redis::script' => ['mixed', 'command'=>'string', '...args='=>'mixed'], 'Redis::sDiff' => ['__benevolent<Redis|list<string>|false>', 'key'=>'string', '...other_keys='=>'string'], 'Redis::sDiffStore' => ['__benevolent<Redis|int|false>', 'dst'=>'string', 'key'=>'string', '...other_keys='=>'string'], 'Redis::select' => ['__benevolent<Redis|bool>', 'db'=>'int'], 'Redis::set' => ['__benevolent<Redis|string|bool>', 'key'=>'string', 'value'=>'mixed', 'options='=>'array'], 'Redis::set\'1' => ['bool', 'key'=>'string', 'value'=>'mixed', 'timeout='=>'int'], 'Redis::setBit' => ['__benevolent<Redis|int|bool>', 'key'=>'string', 'idx'=>'int', 'value'=>'bool'], 'Redis::setex' => ['__benevolent<Redis|bool>', 'key'=>'string', 'expire'=>'int', 'value'=>'mixed'], 'Redis::setnx' => ['__benevolent<Redis|bool>', 'key'=>'string', 'value'=>'mixed'], 'Redis::setOption' => ['bool', 'option'=>'int', 'value'=>'mixed'], 'Redis::setRange' => ['__benevolent<Redis|int|false>', 'key'=>'string', 'index'=>'int', 'value'=>'string'], 'Redis::setTimeout' => ['bool', 'key'=>'string', 'ttl'=>'int'], 'Redis::sGetMembers' => ['array', 'key'=>'string'], 'Redis::sInter' => ['__benevolent<Redis|list<string>|false>', 'key'=>'string', '...other_keys='=>'string'], 'Redis::sintercard' => ['__benevolent<Redis|int|false>', 'keys'=>'string[]', 'limit='=>'int'], 'Redis::sInterStore' => ['__benevolent<Redis|int|false>', 'key'=>'string[]|string', '...other_keys='=>'string'], 'Redis::sismember' => ['__benevolent<Redis|bool>', 'key'=>'string', 'value'=>'mixed'], 'Redis::slave' => ['bool', 'host'=>'string', 'port'=>'int'], 'Redis::slave\'1' => ['bool', 'host'=>'string', 'port'=>'int'], 'Redis::slaveof' => ['__benevolent<Redis|bool>', 'host='=>'?string', 'port='=>'int'], 'Redis::slowlog' => ['mixed', 'operation'=>'string', 'length='=>'int'], 'Redis::sMembers' => ['__benevolent<Redis|list<string>|false>', 'key'=>'string'], 'Redis::sMisMember' => ['__benevolent<Redis|int[]|false>', 'key'=>'string', 'member'=>'string', '...other_members='=>'string'], 'Redis::sMove' => ['__benevolent<Redis|bool>', 'src'=>'string', 'dst'=>'string', 'value'=>'mixed'], 'Redis::sort' => ['array|int', 'key'=>'string', 'options='=>'?array{SORT?:string,ALPHA?:bool,LIMIT?:array{0:int,1:int},BY?:string,GET?:string}'], 'Redis::sort_ro' => ['array|int', 'key'=>'string', 'options='=>'?array{SORT?:string,ALPHA?:bool,LIMIT?:array{0:int,1:int},BY?:string,GET?:string}'], 'Redis::sPop' => ['__benevolent<Redis|string|array|false>', 'key'=>'string', 'count='=>'int'], 'Redis::sRandMember' => ['__benevolent<Redis|string|array|false>', 'key'=>'string', 'count='=>'int'], 'Redis::srem' => ['__benevolent<Redis|int|false>', 'key'=>'string', 'value'=>'mixed', '...other_values='=>'mixed'], 'Redis::sRemove' => ['int', 'key'=>'string', 'member1'=>'string', '...other_members='=>'string'], 'Redis::sscan' => ['__benevolent<Redis|string[]|false>', 'key'=>'string', '&iterator'=>'?int', 'pattern='=>'?string', 'count='=>'int'], 'Redis::ssubscribe' => ['bool', 'channels'=>'string[]', 'cb'=>'callable'], 'Redis::strlen' => ['__benevolent<Redis|0|positive-int|false>', 'key'=>'string'], 'Redis::subscribe' => ['bool', 'channels'=>'string[]', 'cb'=>'callable'], 'Redis::substr' => ['', 'key'=>'string', 'start'=>'int', 'end'=>'int'], 'Redis::unlink\'1' => ['int', 'key'=>'string[]'], 'Redis::sUnion' => ['__benevolent<Redis|list<string>|false>', 'key'=>'string', '...other_keys='=>'string'], 'Redis::sUnionStore' => ['__benevolent<Redis|int|false>', 'dst'=>'string', 'key'=>'string', '...other_keys='=>'string'], 'Redis::sunsubscribe' => ['__benevolent<Redis|string[]|false>', 'channels'=>'string[]'], 'Redis::swapdb' => ['__benevolent<Redis|bool>', 'src'=>'int', 'dst'=>'int'], 'Redis::time' => ['__benevolent<Redis|array{0:int,1:int}>'], 'Redis::ttl' => ['__benevolent<Redis|-2|-1|int|false>', 'key'=>'string'], 'Redis::type' => ['__benevolent<Redis|int|false>', 'key'=>'string'], 'Redis::unlink' => ['__benevolent<Redis|0|positive-int|false>', 'key'=>'string[]|string', '...other_keys'=>'string'], 'Redis::unsubscribe' => ['__benevolent<Redis|string[]|bool>', 'channels'=>'string[]'], 'Redis::unwatch' => ['__benevolent<Redis|bool>'], 'Redis::wait' => ['int|false', 'numreplicas'=>'int', 'timeout'=>'int'], 'Redis::watch' => ['__benevolent<Redis|bool>', 'key'=>'string[]|string', '...other_keys='=>'string'], 'Redis::xack' => ['int|false', 'key'=>'string', 'group'=>'string', 'ids'=>'array'], 'Redis::xadd' => ['__benevolent<Redis|string|false>', 'key'=>'string', 'id'=>'string', 'values'=>'array', 'maxlen='=>'int', 'approx='=>'bool', 'nomkstream='=>'bool'], 'Redis::xclaim' => ['__benevolent<Redis|array|false>', 'key'=>'string', 'group'=>'string', 'consumer'=>'string', 'min_idle'=>'int', 'ids'=>'array', 'options='=>'array'], 'Redis::xdel' => ['__benevolent<Redis|int|false>', 'key'=>'string', 'ids'=>'array'], 'Redis::xgroup' => ['mixed', 'operation'=>'string', 'key='=>'?string', 'group='=>'?string', 'id_or_consumer='=>'?string', 'mkstream='=>'bool', 'entries_read='=>'int'], 'Redis::xinfo' => ['mixed', 'operation'=>'string', 'arg1='=>'?string', 'arg2='=>'?string', 'count='=>'int'], 'Redis::xlen' => ['__benevolent<Redis|int|false>', 'key'=>'string'], 'Redis::xpending' => ['__benevolent<Redis|array|false>', 'key'=>'string', 'group'=>'string', 'start='=>'?string', 'end='=>'?string', 'count='=>'int', 'consumer='=>'?string'], 'Redis::xrange' => ['__benevolent<Redis|array|bool>', 'key'=>'string', 'start'=>'string', 'end'=>'string', 'count='=>'int'], 'Redis::xread' => ['__benevolent<Redis|array|bool>', 'streams'=>'array', 'count='=>'int', 'block='=>'int'], 'Redis::xreadgroup' => ['__benevolent<Redis|array|bool>', 'group'=>'string', 'consumer'=>'string', 'streams'=>'array', 'count='=>'int', 'block='=>'int'], 'Redis::xrevrange' => ['__benevolent<Redis|array|bool>', 'key'=>'string', 'end'=>'string', 'start'=>'string', 'count='=>'int'], 'Redis::xtrim' => ['__benevolent<Redis|array|false>', 'key'=>'string', 'threshold'=>'string', 'approx='=>'bool', 'minid='=>'bool', 'limit='=>'int'], 'Redis::zAdd' => ['__benevolent<Redis|int|float|false>', 'key'=>'string', 'score_or_options'=>'array|float', '...more_scores_and_mems='=>'mixed'], 'Redis::zAdd\'1' => ['int', 'key'=>'string', 'options'=>'array', 'score1'=>'float', 'value1'=>'string', 'score2='=>'float', 'value2='=>'string', 'scoreN='=>'float', 'valueN='=>'string'], 'Redis::zCard' => ['__benevolent<Redis|int|false>', 'key'=>'string'], 'Redis::zCount' => ['__benevolent<Redis|int|false>', 'key'=>'string', 'start'=>'string', 'end'=>'string'], 'Redis::zDelete' => ['int', 'key'=>'string', 'member'=>'string', '...other_members='=>'string'], 'Redis::zDeleteRangeByRank' => ['', 'key'=>'string', 'start'=>'int', 'end'=>'int'], 'Redis::zDeleteRangeByScore' => ['', 'key'=>'string', 'start'=>'float', 'end'=>'float'], 'Redis::zIncrBy' => ['__benevolent<Redis|float|false>', 'key'=>'string', 'value'=>'float', 'member'=>'mixed'], 'Redis::zInter' => ['__benevolent<Redis|array|false>', 'keys'=>'string[]', 'weights='=>'?array', 'options='=>'?array'], 'Redis::zmpop' => ['__benevolent<Redis|array|null|false>', 'keys'=>'string[]', 'from'=>'string', 'count='=>'int'], 'Redis::zRange' => ['__benevolent<Redis|array|false>', 'key'=>'string', 'start'=>'string|int', 'end'=>'string|int', 'options='=>'array|bool|null'], 'Redis::zRangeByLex' => ['__benevolent<Redis|array|false>', 'key'=>'string', 'min'=>'string', 'max'=>'string', 'offset='=>'int', 'limit='=>'int'], 'Redis::zRangeByScore' => ['__benevolent<Redis|array|false>', 'key'=>'string', 'start'=>'string', 'end'=>'string', 'options='=>'array'], 'Redis::zRank' => ['__benevolent<Redis|int|false>', 'key'=>'string', 'member'=>'mixed'], 'Redis::zRem' => ['__benevolent<Redis|int|false>', 'key'=>'string', 'member'=>'string', '...other_members='=>'string'], 'Redis::zRemove' => ['int', 'key'=>'string', 'member'=>'string', '...other_members='=>'string'], 'Redis::zRemRangeByRank' => ['__benevolent<Redis|int|false>', 'key'=>'string', 'start'=>'int', 'end'=>'int'], 'Redis::zRemRangeByScore' => ['__benevolent<Redis|int|false>', 'key'=>'string', 'start'=>'string', 'end'=>'string'], 'Redis::zRevRange' => ['__benevolent<Redis|array|false>', 'key'=>'string', 'start'=>'int', 'end'=>'int', 'scores='=>'bool|array{withscores:bool}|null'], 'Redis::zRevRangeByLex' => ['__benevolent<Redis|array|false>', 'key'=>'string', 'max'=>'string', 'min'=>'string', 'offset='=>'int', 'limit='=>'int'], 'Redis::zRevRangeByScore' => ['__benevolent<Redis|array|false>', 'key'=>'string', 'max'=>'string', 'min'=>'string', 'options='=>'array|bool'], 'Redis::zRevRank' => ['__benevolent<Redis|int|false>', 'key'=>'string', 'member'=>'mixed'], 'Redis::zscan' => ['__benevolent<Redis|array|false>', 'key'=>'string', '&iterator'=>'?int', 'pattern='=>'?string', 'count='=>'int'], 'Redis::zScore' => ['__benevolent<Redis|float|false>', 'key'=>'string', 'member'=>'mixed'], 'Redis::zSize' => ['', 'key'=>'string'], 'Redis::zUnion' => ['__benevolent<Redis|array|false>', 'keys'=>'string[]', 'weights'=>'?array', 'options='=>'?array'], 'RedisArray::__construct' => ['void', 'name'=>'string'], 'RedisArray::__construct\'1' => ['void', 'hosts'=>'array<int, string>', 'opts='=>'array<string, string>'], 'RedisArray::_function' => ['string'], 'RedisArray::_hosts' => ['array'], 'RedisArray::_rehash' => ['', 'callable='=>'callable'], 'RedisArray::_target' => ['string', 'key'=>'string'], 'RedisCluster::__construct' => ['void', 'name'=>'string|null', 'seeds='=>'string[]|null', 'timeout='=>'int|float', 'read_timeout='=>'int|float', 'persistent='=>'bool', 'auth='=>'mixed', 'context='=>'array|null'], 'RedisCluster::_masters' => ['array'], 'RedisCluster::_prefix' => ['string', 'value'=>'mixed'], 'RedisCluster::_serialize' => ['mixed', 'value'=>'mixed'], 'RedisCluster::_unserialize' => ['mixed', 'value'=>'string'], 'RedisCluster::append' => ['int', 'key'=>'string', 'value'=>'string'], 'RedisCluster::bgrewriteaof' => ['bool', 'nodeParams'=>'string'], 'RedisCluster::bgsave' => ['bool', 'nodeParams'=>'string'], 'RedisCluster::bitCount' => ['int', 'key'=>'string'], 'RedisCluster::bitOp' => ['int', 'operation'=>'string', 'retKey'=>'string', 'key1'=>'string', 'key2'=>'string', 'key3='=>'string'], 'RedisCluster::bitpos' => ['int', 'key'=>'string', 'bit'=>'int', 'start='=>'int', 'end='=>'int'], 'RedisCluster::blPop' => ['array', 'keys'=>'array', 'timeout'=>'int'], 'RedisCluster::brPop' => ['array', 'keys'=>'array', 'timeout'=>'int'], 'RedisCluster::brpoplpush' => ['string', 'srcKey'=>'string', 'dstKey'=>'string', 'timeout'=>'int'], 'RedisCluster::clearLastError' => ['bool'], 'RedisCluster::client' => ['', 'nodeParams'=>'string', 'subCmd'=>'', 'args'=>''], 'RedisCluster::close' => [''], 'RedisCluster::cluster' => ['mixed', 'nodeParams'=>'string', 'command'=>'string', 'arguments'=>'mixed'], 'RedisCluster::command' => ['mixed'], 'RedisCluster::config' => ['array', 'nodeParams'=>'string', 'operation'=>'string', 'key'=>'string', 'value'=>'string'], 'RedisCluster::dbSize' => ['int', 'nodeParams'=>'string'], 'RedisCluster::decr' => ['int', 'key'=>'string'], 'RedisCluster::decrBy' => ['int', 'key'=>'string', 'value'=>'int'], 'RedisCluster::del' => ['int', 'key1'=>'int|string', 'key2='=>'int|string', 'key3='=>'int|string'], 'RedisCluster::discard' => [''], 'RedisCluster::dump' => ['string', 'key'=>'string'], 'RedisCluster::echo' => ['mixed', 'nodeParams'=>'string', 'msg'=>'string'], 'RedisCluster::eval' => ['mixed', 'script'=>'', 'args='=>'', 'numKeys='=>''], 'RedisCluster::evalSha' => ['mixed', 'scriptSha'=>'string', 'args='=>'array', 'numKeys='=>'int'], 'RedisCluster::exec' => ['array|void'], 'RedisCluster::exists' => ['bool', 'key'=>'string'], 'RedisCluster::expire' => ['bool', 'key'=>'string', 'ttl'=>'int'], 'RedisCluster::expireAt' => ['bool', 'key'=>'string', 'timestamp'=>'int'], 'RedisCluster::flushAll' => ['bool', 'nodeParams'=>'string'], 'RedisCluster::flushDB' => ['bool', 'nodeParams'=>'string'], 'RedisCluster::geoAdd' => ['', 'key'=>'string', 'longitude'=>'float', 'latitude'=>'float', 'member'=>'string'], 'RedisCluster::geoDist' => ['', 'key'=>'string', 'member1'=>'string', 'member2'=>'string', 'unit='=>'string'], 'RedisCluster::geohash' => ['', 'key'=>'', 'member1'=>'', 'member2='=>'mixed', 'memberN='=>'mixed'], 'RedisCluster::geopos' => ['', 'key'=>'', 'member1'=>'', 'member2='=>'mixed', 'memberN='=>'mixed'], 'RedisCluster::geoRadius' => ['', 'key'=>'string', 'longitude'=>'float', 'latitude'=>'float', 'radius'=>'float', 'radiusUnit'=>'string', 'options'=>'array'], 'RedisCluster::geoRadiusByMember' => ['', 'key'=>'string', 'member'=>'string', 'radius'=>'float', 'radiusUnit'=>'string', 'options'=>'array'], 'RedisCluster::get' => ['bool|string', 'key'=>'string'], 'RedisCluster::getBit' => ['int', 'key'=>'string', 'offset'=>'int'], 'RedisCluster::getLastError' => ['string'], 'RedisCluster::getMode' => ['int'], 'RedisCluster::getOption' => ['int', 'name'=>'int'], 'RedisCluster::getRange' => ['string', 'key'=>'string', 'start'=>'int', 'end'=>'int'], 'RedisCluster::getSet' => ['string', 'key'=>'string', 'value'=>'string'], 'RedisCluster::hDel' => ['int', 'key'=>'string', 'hashKey1'=>'string', 'hashKey2='=>'string', 'hashKeyN='=>'string'], 'RedisCluster::hExists' => ['bool', 'key'=>'string', 'hashKey'=>'string'], 'RedisCluster::hGet' => ['string', 'key'=>'string', 'hashKey'=>'string'], 'RedisCluster::hGetAll' => ['array', 'key'=>'string'], 'RedisCluster::hIncrBy' => ['int', 'key'=>'string', 'hashKey'=>'string', 'value'=>'int'], 'RedisCluster::hIncrByFloat' => ['float', 'key'=>'string', 'field'=>'string', 'increment'=>'float'], 'RedisCluster::hKeys' => ['array', 'key'=>'string'], 'RedisCluster::hLen' => ['int', 'key'=>'string'], 'RedisCluster::hMGet' => ['array', 'key'=>'string', 'hashKeys'=>'array'], 'RedisCluster::hMSet' => ['bool', 'key'=>'string', 'hashKeys'=>'array'], 'RedisCluster::hScan' => ['array', 'key'=>'string', '&iterator'=>'int', 'pattern='=>'string', 'count='=>'int'], 'RedisCluster::hSet' => ['int', 'key'=>'string', 'hashKey'=>'string', 'value'=>'string'], 'RedisCluster::hSetNx' => ['bool', 'key'=>'string', 'hashKey'=>'string', 'value'=>'string'], 'RedisCluster::hVals' => ['array', 'key'=>'string'], 'RedisCluster::incr' => ['int', 'key'=>'string'], 'RedisCluster::incrBy' => ['int', 'key'=>'string', 'value'=>'int'], 'RedisCluster::incrByFloat' => ['float', 'key'=>'string', 'increment'=>'float'], 'RedisCluster::info' => ['string', 'option='=>'string'], 'RedisCluster::keys' => ['array', 'pattern'=>'string'], 'RedisCluster::lastSave' => ['int', 'nodeParams'=>'string'], 'RedisCluster::lGet' => ['', 'key'=>'string', 'index'=>'int'], 'RedisCluster::lIndex' => ['string', 'key'=>'string', 'index'=>'int'], 'RedisCluster::lInsert' => ['int', 'key'=>'string', 'position'=>'int', 'pivot'=>'string', 'value'=>'string'], 'RedisCluster::lLen' => ['int', 'key'=>'string'], 'RedisCluster::lPop' => ['string', 'key'=>'string'], 'RedisCluster::lPush' => ['int', 'key'=>'string', 'value1'=>'string', 'value2='=>'string', 'valueN='=>'string'], 'RedisCluster::lPushx' => ['int', 'key'=>'string', 'value'=>'string'], 'RedisCluster::lRange' => ['array', 'key'=>'string', 'start'=>'int', 'end'=>'int'], 'RedisCluster::lRem' => ['int', 'key'=>'string', 'value'=>'string', 'count'=>'int'], 'RedisCluster::lSet' => ['bool', 'key'=>'string', 'index'=>'int', 'value'=>'string'], 'RedisCluster::lTrim' => ['array', 'key'=>'string', 'start'=>'int', 'stop'=>'int'], 'RedisCluster::mget' => ['array', 'array'=>'array'], 'RedisCluster::mset' => ['bool', 'array'=>'array'], 'RedisCluster::msetnx' => ['int', 'array'=>'array'], 'RedisCluster::multi' => ['Redis', 'mode='=>'int'], 'RedisCluster::object' => ['string', 'string='=>'string', 'key='=>'string'], 'RedisCluster::persist' => ['bool', 'key'=>'string'], 'RedisCluster::pExpire' => ['bool', 'key'=>'string', 'ttl'=>'int'], 'RedisCluster::pExpireAt' => ['bool', 'key'=>'string', 'timestamp'=>'int'], 'RedisCluster::pfAdd' => ['bool', 'key'=>'string', 'elements'=>'array'], 'RedisCluster::pfCount' => ['int', 'key'=>'string'], 'RedisCluster::pfMerge' => ['bool', 'destKey'=>'string', 'sourceKeys'=>'array'], 'RedisCluster::ping' => ['string', 'nodeParams'=>'string'], 'RedisCluster::psetex' => ['bool', 'key'=>'string', 'ttl'=>'int', 'value'=>'string'], 'RedisCluster::psubscribe' => ['mixed', 'patterns'=>'array', 'callback'=>'string'], 'RedisCluster::pttl' => ['int', 'key'=>'string'], 'RedisCluster::publish' => ['int', 'channel'=>'string', 'message'=>'string'], 'RedisCluster::pubsub' => ['array', 'nodeParams'=>'string', 'keyword'=>'string', '...argument='=>'string'], 'RedisCluster::punSubscribe' => ['', 'channels'=>'', 'callback'=>''], 'RedisCluster::randomKey' => ['string', 'nodeParams'=>'string'], 'RedisCluster::rawCommand' => ['mixed', 'nodeParams'=>'string', 'command'=>'string', 'arguments'=>'mixed'], 'RedisCluster::rename' => ['bool', 'srcKey'=>'string', 'dstKey'=>'string'], 'RedisCluster::renameNx' => ['bool', 'srcKey'=>'string', 'dstKey'=>'string'], 'RedisCluster::restore' => ['bool', 'key'=>'string', 'ttl'=>'int', 'value'=>'string'], 'RedisCluster::role' => ['array', 'nodeParams'=>'string'], 'RedisCluster::rPop' => ['string', 'key'=>'string'], 'RedisCluster::rpoplpush' => ['string', 'srcKey'=>'string', 'dstKey'=>'string'], 'RedisCluster::rPush' => ['int', 'key'=>'string', 'value1'=>'string', 'value2='=>'string', 'valueN='=>'string'], 'RedisCluster::rPushx' => ['int', 'key'=>'string', 'value'=>'string'], 'RedisCluster::sAdd' => ['int', 'key'=>'string', 'value1'=>'string', 'value2='=>'string', 'valueN='=>'string'], 'RedisCluster::sAddArray' => ['int', 'key'=>'string', 'valueArray'=>'array'], 'RedisCluster::save' => ['bool', 'nodeParams'=>'string'], 'RedisCluster::scan' => ['array', '&iterator'=>'int', 'pattern='=>'string', 'count='=>'int'], 'RedisCluster::sCard' => ['int', 'key'=>'string'], 'RedisCluster::script' => ['mixed', 'nodeParams'=>'string', 'command'=>'string', 'script'=>'string'], 'RedisCluster::sDiff' => ['list<string>', 'key1'=>'string', 'key2'=>'string', '...other_keys='=>'string'], 'RedisCluster::sDiffStore' => ['int', 'dstKey'=>'string', 'key1'=>'string', '...other_keys='=>'string'], 'RedisCluster::set' => ['bool', 'key'=>'string', 'value'=>'string', 'timeout='=>'array|int'], 'RedisCluster::setBit' => ['int', 'key'=>'string', 'offset'=>'int', 'value'=>'bool|int'], 'RedisCluster::setex' => ['bool', 'key'=>'string', 'ttl'=>'int', 'value'=>'string'], 'RedisCluster::setnx' => ['bool', 'key'=>'string', 'value'=>'string'], 'RedisCluster::setOption' => ['bool', 'name'=>'int', 'value'=>'mixed'], 'RedisCluster::setRange' => ['string', 'key'=>'string', 'offset'=>'int', 'value'=>'string'], 'RedisCluster::sInter' => ['list<string>', 'key'=>'string', '...other_keys='=>'string'], 'RedisCluster::sInterStore' => ['int', 'dstKey'=>'string', 'key'=>'string', '...other_keys='=>'string'], 'RedisCluster::sIsMember' => ['bool', 'key'=>'string', 'value'=>'string'], 'RedisCluster::slowLog' => ['', 'nodeParams'=>'string', 'command'=>'string', 'argument'=>'mixed', '...other_arguments='=>'mixed'], 'RedisCluster::sMembers' => ['list<string>', 'key'=>'string'], 'RedisCluster::sMove' => ['bool', 'srcKey'=>'string', 'dstKey'=>'string', 'member'=>'string'], 'RedisCluster::sort' => ['array', 'key'=>'string', 'option='=>'array'], 'RedisCluster::sPop' => ['string', 'key'=>'string'], 'RedisCluster::sRandMember' => ['array|string', 'key'=>'string', 'count='=>'int'], 'RedisCluster::sRem' => ['int', 'key'=>'string', 'member1'=>'string', '...other_members='=>'string'], 'RedisCluster::sScan' => ['array', 'key'=>'string', '&iterator'=>'int', 'pattern='=>'null', 'count='=>'int'], 'RedisCluster::strlen' => ['0|positive-int', 'key'=>'string'], 'RedisCluster::subscribe' => ['mixed', 'channels'=>'array', 'callback'=>'string'], 'RedisCluster::sUnion' => ['array', 'key1'=>'string', '...other_keys='=>'string'], 'RedisCluster::sUnionStore' => ['int', 'dstKey'=>'string', 'key1'=>'string', '...other_keys='=>'string'], 'RedisCluster::time' => ['array', 'nodeParams'=>'string'], 'RedisCluster::ttl' => ['int', 'key'=>'string'], 'RedisCluster::type' => ['int', 'key'=>'string'], 'RedisCluster::unlink' => ['int', 'key'=>'string', '...other_keys='=>'string'], 'RedisCluster::unSubscribe' => ['', 'channels'=>'', '...other_channels='=>''], 'RedisCluster::unwatch' => [''], 'RedisCluster::watch' => ['void', 'key'=>'string', '...other_keys='=>'string'], 'RedisCluster::xack' => ['', 'str_key'=>'string', 'str_group'=>'string', 'arr_ids'=>'array'], 'RedisCluster::xadd' => ['', 'str_key'=>'string', 'str_id'=>'string', 'arr_fields'=>'array', 'i_maxlen='=>'', 'boo_approximate='=>''], 'RedisCluster::xclaim' => ['', 'str_key'=>'string', 'str_group'=>'string', 'str_consumer'=>'string', 'i_min_idle'=>'', 'arr_ids'=>'array', 'arr_opts='=>'array'], 'RedisCluster::xdel' => ['', 'str_key'=>'string', 'arr_ids'=>'array'], 'RedisCluster::xgroup' => ['', 'str_operation'=>'string', 'str_key='=>'string', 'str_arg1='=>'', 'str_arg2='=>'', 'str_arg3='=>''], 'RedisCluster::xinfo' => ['', 'str_cmd'=>'string', 'str_key='=>'string', 'str_group='=>'string'], 'RedisCluster::xlen' => ['', 'key'=>''], 'RedisCluster::xpending' => ['', 'str_key'=>'string', 'str_group'=>'string', 'str_start='=>'', 'str_end='=>'', 'i_count='=>'', 'str_consumer='=>'string'], 'RedisCluster::xrange' => ['', 'str_key'=>'string', 'str_start'=>'', 'str_end'=>'', 'i_count='=>''], 'RedisCluster::xread' => ['', 'arr_streams'=>'array', 'i_count='=>'', 'i_block='=>''], 'RedisCluster::xreadgroup' => ['', 'str_group'=>'string', 'str_consumer'=>'string', 'arr_streams'=>'array', 'i_count='=>'', 'i_block='=>''], 'RedisCluster::xrevrange' => ['', 'str_key'=>'string', 'str_start'=>'', 'str_end'=>'', 'i_count='=>''], 'RedisCluster::xtrim' => ['', 'str_key'=>'string', 'i_maxlen'=>'', 'boo_approximate='=>''], 'RedisCluster::zAdd' => ['int', 'key'=>'string', 'score1'=>'float', 'value1'=>'string', 'score2='=>'float', 'value2='=>'string', 'scoreN='=>'float', 'valueN='=>'string'], 'RedisCluster::zCard' => ['int', 'key'=>'string'], 'RedisCluster::zCount' => ['int', 'key'=>'string', 'start'=>'string', 'end'=>'string'], 'RedisCluster::zIncrBy' => ['float', 'key'=>'string', 'value'=>'float', 'member'=>'string'], 'RedisCluster::zInterStore' => ['int', 'Output'=>'string', 'ZSetKeys'=>'array', 'Weights='=>'?array', 'aggregateFunction='=>'string'], 'RedisCluster::zLexCount' => ['int', 'key'=>'string', 'min'=>'int', 'max'=>'int'], 'RedisCluster::zRange' => ['array', 'key'=>'string', 'start'=>'int', 'end'=>'int', 'withscores='=>'bool'], 'RedisCluster::zRangeByLex' => ['array', 'key'=>'string', 'min'=>'int', 'max'=>'int', 'offset='=>'int', 'limit='=>'int'], 'RedisCluster::zRangeByScore' => ['array', 'key'=>'string', 'start'=>'int', 'end'=>'int', 'options='=>'array'], 'RedisCluster::zRank' => ['int', 'key'=>'string', 'member'=>'string'], 'RedisCluster::zRem' => ['int', 'key'=>'string', 'member1'=>'string', '...other_members='=>'string'], 'RedisCluster::zRemRangeByLex' => ['array', 'key'=>'string', 'min'=>'int', 'max'=>'int'], 'RedisCluster::zRemRangeByRank' => ['int', 'key'=>'string', 'start'=>'int', 'end'=>'int'], 'RedisCluster::zRemRangeByScore' => ['int', 'key'=>'string', 'start'=>'float|string', 'end'=>'float|string'], 'RedisCluster::zRevRange' => ['array', 'key'=>'string', 'start'=>'int', 'end'=>'int', 'withscore='=>'bool'], 'RedisCluster::zRevRangeByLex' => ['array', 'key'=>'string', 'min'=>'int', 'max'=>'int', 'offset='=>'int', 'limit='=>'int'], 'RedisCluster::zRevRangeByScore' => ['array', 'key'=>'string', 'start'=>'int', 'end'=>'int', 'options='=>'array'], 'RedisCluster::zRevRank' => ['int', 'key'=>'string', 'member'=>'string'], 'RedisCluster::zScan' => ['array', 'key'=>'string', '&iterator'=>'int', 'pattern='=>'string', 'count='=>'int'], 'RedisCluster::zScore' => ['float', 'key'=>'string', 'member'=>'string'], 'RedisCluster::zUnionStore' => ['int', 'Output'=>'string', 'ZSetKeys'=>'array', 'Weights='=>'?array', 'aggregateFunction='=>'string'], 'Reflection::export' => ['string|null', 'r'=>'reflector', 'return='=>'bool'], 'Reflection::getModifierNames' => ['array', 'modifiers'=>'int'], 'ReflectionClass::__clone' => ['void'], 'ReflectionClass::__construct' => ['void', 'argument'=>'object|string'], 'ReflectionClass::__toString' => ['string'], 'ReflectionClass::export' => ['string|null', 'argument'=>'string|object', 'return='=>'bool'], 'ReflectionClass::getConstant' => ['mixed', 'name'=>'string'], 'ReflectionClass::getConstants' => ['array<string,mixed>'], 'ReflectionClass::getConstructor' => ['ReflectionMethod|null'], 'ReflectionClass::getDefaultProperties' => ['array<string, mixed>'], 'ReflectionClass::getDocComment' => ['string|false'], 'ReflectionClass::getEndLine' => ['positive-int|false'], 'ReflectionClass::getExtension' => ['ReflectionExtension|null'], 'ReflectionClass::getExtensionName' => ['string|false'], 'ReflectionClass::getFileName' => ['non-empty-string|false'], 'ReflectionClass::getInterfaceNames' => ['list<class-string>'], 'ReflectionClass::getInterfaces' => ['array<string, ReflectionClass>'], 'ReflectionClass::getMethod' => ['ReflectionMethod', 'name'=>'string'], 'ReflectionClass::getMethods' => ['list<ReflectionMethod>', 'filter='=>'int'], 'ReflectionClass::getModifiers' => ['int'], 'ReflectionClass::getName' => ['class-string'], 'ReflectionClass::getNamespaceName' => ['string'], 'ReflectionClass::getParentClass' => ['ReflectionClass|false'], 'ReflectionClass::getProperties' => ['list<ReflectionProperty>', 'filter='=>'int'], 'ReflectionClass::getProperty' => ['ReflectionProperty', 'name'=>'string'], 'ReflectionClass::getReflectionConstant' => ['ReflectionClassConstant|false', 'name'=>'string'], 'ReflectionClass::getReflectionConstants' => ['list<ReflectionClassConstant>'], 'ReflectionClass::getShortName' => ['string'], 'ReflectionClass::getStartLine' => ['positive-int|false'], 'ReflectionClass::getStaticProperties' => ['array<string, mixed>'], 'ReflectionClass::getStaticPropertyValue' => ['mixed', 'name'=>'string', 'default='=>'mixed'], 'ReflectionClass::getTraitAliases' => ['array<string,string>'], 'ReflectionClass::getTraitNames' => ['list<trait-string>'], 'ReflectionClass::getTraits' => ['array<string,ReflectionClass>'], 'ReflectionClass::hasConstant' => ['bool', 'name'=>'string'], 'ReflectionClass::hasMethod' => ['bool', 'name'=>'string'], 'ReflectionClass::hasProperty' => ['bool', 'name'=>'string'], 'ReflectionClass::implementsInterface' => ['bool', 'interface_name'=>'string|ReflectionClass'], 'ReflectionClass::inNamespace' => ['bool'], 'ReflectionClass::isAbstract' => ['bool'], 'ReflectionClass::isAnonymous' => ['bool'], 'ReflectionClass::isCloneable' => ['bool'], 'ReflectionClass::isFinal' => ['bool'], 'ReflectionClass::isInstance' => ['bool', 'object'=>'object'], 'ReflectionClass::isInstantiable' => ['bool'], 'ReflectionClass::isInterface' => ['bool'], 'ReflectionClass::isInternal' => ['bool'], 'ReflectionClass::isIterable' => ['bool'], 'ReflectionClass::isIterateable' => ['bool'], 'ReflectionClass::isSubclassOf' => ['bool', 'class'=>'string|ReflectionClass'], 'ReflectionClass::isTrait' => ['bool'], 'ReflectionClass::isUserDefined' => ['bool'], 'ReflectionClass::newInstance' => ['object', 'args='=>'mixed', '...args='=>'mixed'], 'ReflectionClass::newInstanceArgs' => ['object', 'args='=>'array'], 'ReflectionClass::newInstanceWithoutConstructor' => ['object'], 'ReflectionClass::setStaticPropertyValue' => ['void', 'name'=>'string', 'value'=>'mixed'], 'ReflectionClassConstant::__construct' => ['void', 'class'=>'mixed', 'name'=>'string'], 'ReflectionClassConstant::__toString' => ['string'], 'ReflectionClassConstant::export' => ['string', 'class'=>'mixed', 'name'=>'string', 'return='=>'bool'], 'ReflectionClassConstant::getDeclaringClass' => ['ReflectionClass'], 'ReflectionClassConstant::getDocComment' => ['string|false'], 'ReflectionClassConstant::getModifiers' => ['int'], 'ReflectionClassConstant::getName' => ['string'], 'ReflectionClassConstant::getValue' => ['mixed'], 'ReflectionClassConstant::isPrivate' => ['bool'], 'ReflectionClassConstant::isProtected' => ['bool'], 'ReflectionClassConstant::isPublic' => ['bool'], 'ReflectionExtension::__clone' => ['void'], 'ReflectionExtension::__construct' => ['void', 'name'=>'string'], 'ReflectionExtension::__toString' => ['string'], 'ReflectionExtension::export' => ['string|null', 'name'=>'string', 'return='=>'bool'], 'ReflectionExtension::getClasses' => ['array<string,ReflectionClass>'], 'ReflectionExtension::getClassNames' => ['list<class-string>'], 'ReflectionExtension::getConstants' => ['array<string,mixed>'], 'ReflectionExtension::getDependencies' => ['array<string,string>'], 'ReflectionExtension::getFunctions' => ['array<string,ReflectionFunction>'], 'ReflectionExtension::getINIEntries' => ['array<string,mixed>'], 'ReflectionExtension::getName' => ['string'], 'ReflectionExtension::getVersion' => ['string'], 'ReflectionExtension::info' => ['void'], 'ReflectionExtension::isPersistent' => ['void'], 'ReflectionExtension::isTemporary' => ['bool'], 'ReflectionFunction::__construct' => ['void', 'name'=>'string|Closure'], 'ReflectionFunction::__toString' => ['string'], 'ReflectionFunction::export' => ['string|null', 'name'=>'string', 'return='=>'bool'], 'ReflectionFunction::getClosure' => ['Closure'], 'ReflectionFunction::getClosureScopeClass' => ['ReflectionClass'], 'ReflectionFunction::getClosureThis' => ['bool'], 'ReflectionFunction::getDocComment' => ['string|false'], 'ReflectionFunction::getEndLine' => ['positive-int|false'], 'ReflectionFunction::getExtension' => ['ReflectionExtension|null'], 'ReflectionFunction::getExtensionName' => ['string|false'], 'ReflectionFunction::getFileName' => ['non-empty-string|false'], 'ReflectionFunction::getName' => ['non-empty-string'], 'ReflectionFunction::getNamespaceName' => ['string'], 'ReflectionFunction::getNumberOfParameters' => ['int'], 'ReflectionFunction::getNumberOfRequiredParameters' => ['int'], 'ReflectionFunction::getParameters' => ['list<ReflectionParameter>'], 'ReflectionFunction::getReturnType' => ['?ReflectionType'], 'ReflectionFunction::getShortName' => ['string'], 'ReflectionFunction::getStartLine' => ['positive-int|false'], 'ReflectionFunction::getStaticVariables' => ['array'], 'ReflectionFunction::inNamespace' => ['bool'], 'ReflectionFunction::invoke' => ['mixed', '...args='=>'mixed'], 'ReflectionFunction::invokeArgs' => ['mixed', 'args'=>'array'], 'ReflectionFunction::isClosure' => ['bool'], 'ReflectionFunction::isDeprecated' => ['bool'], 'ReflectionFunction::isDisabled' => ['bool'], 'ReflectionFunction::isGenerator' => ['bool'], 'ReflectionFunction::isInternal' => ['bool'], 'ReflectionFunction::isUserDefined' => ['bool'], 'ReflectionFunction::isVariadic' => ['bool'], 'ReflectionFunction::returnsReference' => ['bool'], 'ReflectionFunctionAbstract::__clone' => ['void'], 'ReflectionFunctionAbstract::__toString' => ['string'], 'ReflectionFunctionAbstract::getClosureScopeClass' => ['ReflectionClass|null'], 'ReflectionFunctionAbstract::getClosureThis' => ['object|null'], 'ReflectionFunctionAbstract::getDocComment' => ['string|false'], 'ReflectionFunctionAbstract::getEndLine' => ['positive-int|false'], 'ReflectionFunctionAbstract::getExtension' => ['ReflectionExtension|null'], 'ReflectionFunctionAbstract::getExtensionName' => ['string|false'], 'ReflectionFunctionAbstract::getFileName' => ['non-empty-string|false'], 'ReflectionFunctionAbstract::getName' => ['non-empty-string'], 'ReflectionFunctionAbstract::getNamespaceName' => ['string'], 'ReflectionFunctionAbstract::getNumberOfParameters' => ['int'], 'ReflectionFunctionAbstract::getNumberOfRequiredParameters' => ['int'], 'ReflectionFunctionAbstract::getParameters' => ['list<ReflectionParameter>'], 'ReflectionFunctionAbstract::getReturnType' => ['?ReflectionType'], 'ReflectionFunctionAbstract::getShortName' => ['string'], 'ReflectionFunctionAbstract::getStartLine' => ['positive-int|false'], 'ReflectionFunctionAbstract::getStaticVariables' => ['array'], 'ReflectionFunctionAbstract::hasReturnType' => ['bool'], 'ReflectionFunctionAbstract::inNamespace' => ['bool'], 'ReflectionFunctionAbstract::isClosure' => ['bool'], 'ReflectionFunctionAbstract::isDeprecated' => ['bool'], 'ReflectionFunctionAbstract::isGenerator' => ['bool'], 'ReflectionFunctionAbstract::isInternal' => ['bool'], 'ReflectionFunctionAbstract::isUserDefined' => ['bool'], 'ReflectionFunctionAbstract::isVariadic' => ['bool'], 'ReflectionFunctionAbstract::returnsReference' => ['bool'], 'ReflectionGenerator::__construct' => ['void', 'generator'=>'object'], 'ReflectionGenerator::getExecutingFile' => ['string'], 'ReflectionGenerator::getExecutingGenerator' => ['Generator'], 'ReflectionGenerator::getExecutingLine' => ['int'], 'ReflectionGenerator::getFunction' => ['ReflectionFunctionAbstract'], 'ReflectionGenerator::getThis' => ['object'], 'ReflectionGenerator::getTrace' => ['list<array{function:string,line?:int,file?:string,class?:class-string,type?:\'::\'|\'->\',args?:mixed[],object?:object}>', 'options'=>'int'], 'ReflectionMethod::__construct' => ['void', 'class'=>'string|object', 'name'=>'string'], 'ReflectionMethod::__construct\'1' => ['void', 'class_method'=>'string'], 'ReflectionMethod::__toString' => ['string'], 'ReflectionMethod::export' => ['string|null', 'class'=>'string', 'name'=>'string', 'return='=>'bool'], 'ReflectionMethod::getClosure' => ['Closure', 'object'=>'?object'], 'ReflectionMethod::getDeclaringClass' => ['ReflectionClass'], 'ReflectionMethod::getModifiers' => ['int'], 'ReflectionMethod::getPrototype' => ['ReflectionMethod'], 'ReflectionMethod::invoke' => ['mixed', 'object'=>'?object', '...args='=>'mixed'], 'ReflectionMethod::invokeArgs' => ['mixed', 'object'=>'?object', 'args'=>'array'], 'ReflectionMethod::isAbstract' => ['bool'], 'ReflectionMethod::isConstructor' => ['bool'], 'ReflectionMethod::isDestructor' => ['bool'], 'ReflectionMethod::isFinal' => ['bool'], 'ReflectionMethod::isPrivate' => ['bool'], 'ReflectionMethod::isProtected' => ['bool'], 'ReflectionMethod::isPublic' => ['bool'], 'ReflectionMethod::isStatic' => ['bool'], 'ReflectionMethod::setAccessible' => ['void', 'visible'=>'bool'], 'ReflectionNamedType::__toString' => ['string'], 'ReflectionNamedType::allowsNull' => ['bool'], 'ReflectionNamedType::getName' => ['string'], 'ReflectionNamedType::isBuiltin' => ['bool'], 'ReflectionObject::__construct' => ['void', 'argument'=>'object'], 'ReflectionObject::export' => ['string|null', 'argument'=>'object', 'return='=>'bool'], 'ReflectionParameter::__clone' => ['void'], 'ReflectionParameter::__construct' => ['void', 'function'=>'', 'parameter'=>''], 'ReflectionParameter::__toString' => ['string'], 'ReflectionParameter::allowsNull' => ['bool'], 'ReflectionParameter::canBePassedByValue' => ['bool'], 'ReflectionParameter::export' => ['string|null', 'function'=>'string', 'parameter'=>'string', 'return='=>'bool'], 'ReflectionParameter::getClass' => ['ReflectionClass|null'], 'ReflectionParameter::getDeclaringClass' => ['ReflectionClass|null'], 'ReflectionParameter::getDeclaringFunction' => ['ReflectionFunctionAbstract'], 'ReflectionParameter::getDefaultValue' => ['mixed'], 'ReflectionParameter::getDefaultValueConstantName' => ['?string'], 'ReflectionParameter::getName' => ['non-empty-string'], 'ReflectionParameter::getPosition' => ['int'], 'ReflectionParameter::getType' => ['ReflectionType|null'], 'ReflectionParameter::hasType' => ['bool'], 'ReflectionParameter::isArray' => ['bool'], 'ReflectionParameter::isCallable' => ['bool'], 'ReflectionParameter::isDefaultValueAvailable' => ['bool'], 'ReflectionParameter::isDefaultValueConstant' => ['bool'], 'ReflectionParameter::isOptional' => ['bool'], 'ReflectionParameter::isPassedByReference' => ['bool'], 'ReflectionParameter::isVariadic' => ['bool'], 'ReflectionProperty::__clone' => ['void'], 'ReflectionProperty::__construct' => ['void', 'class'=>'', 'name'=>'string'], 'ReflectionProperty::__toString' => ['string'], 'ReflectionProperty::export' => ['string|null', 'class'=>'mixed', 'name'=>'string', 'return='=>'bool'], 'ReflectionProperty::getDeclaringClass' => ['ReflectionClass'], 'ReflectionProperty::getDocComment' => ['string|false'], 'ReflectionProperty::getModifiers' => ['int'], 'ReflectionProperty::getName' => ['non-empty-string'], 'ReflectionProperty::getValue' => ['mixed', 'object='=>'object'], 'ReflectionProperty::isDefault' => ['bool'], 'ReflectionProperty::isPrivate' => ['bool'], 'ReflectionProperty::isProtected' => ['bool'], 'ReflectionProperty::isPublic' => ['bool'], 'ReflectionProperty::isStatic' => ['bool'], 'ReflectionProperty::setAccessible' => ['void', 'visible'=>'bool'], 'ReflectionProperty::setValue' => ['void', 'object'=>'null|object', 'value'=>''], 'ReflectionProperty::setValue\'1' => ['void', 'value'=>''], 'ReflectionType::__toString' => ['string'], 'ReflectionType::allowsNull' => ['bool'], 'ReflectionType::isBuiltin' => ['bool'], 'ReflectionZendExtension::__clone' => ['void'], 'ReflectionZendExtension::__construct' => ['void', 'name'=>'string'], 'ReflectionZendExtension::__toString' => ['string'], 'ReflectionZendExtension::export' => ['string|null', 'name'=>'string', 'return='=>'bool'], 'ReflectionZendExtension::getAuthor' => ['string'], 'ReflectionZendExtension::getCopyright' => ['string'], 'ReflectionZendExtension::getName' => ['string'], 'ReflectionZendExtension::getURL' => ['string'], 'ReflectionZendExtension::getVersion' => ['string'], 'Reflector::__toString' => ['string'], 'Reflector::export' => ['?string'], 'RegexIterator::__construct' => ['void', 'iterator'=>'Iterator', 'regex'=>'string', 'mode='=>'int', 'flags='=>'int', 'preg_flags='=>'int'], 'RegexIterator::accept' => ['bool'], 'RegexIterator::getFlags' => ['int'], 'RegexIterator::getMode' => ['int'], 'RegexIterator::getPregFlags' => ['int'], 'RegexIterator::getRegex' => ['string'], 'RegexIterator::setFlags' => ['bool', 'new_flags'=>'int'], 'RegexIterator::setMode' => ['bool', 'new_mode'=>'int'], 'RegexIterator::setPregFlags' => ['bool', 'new_flags'=>'int'], 'register_event_handler' => ['bool', 'event_handler_func'=>'event_handler_func', 'handler_register_name'=>'handler_register_name', 'event_type_mask'=>'event_type_mask'], 'register_shutdown_function' => ['void', 'function'=>'callable', '...parameter='=>'mixed'], 'register_tick_function' => ['bool', 'function'=>'callable(): void', '...args='=>'mixed'], 'rename' => ['bool', 'old_name'=>'string', 'new_name'=>'string', 'context='=>'resource'], 'rename_function' => ['bool', 'original_name'=>'string', 'new_name'=>'string'], 'reset' => ['mixed', '&rw_array'=>'array|object'], 'ResourceBundle::__construct' => ['void', 'locale'=>'string', 'bundlename'=>'string', 'fallback='=>'bool'], 'ResourceBundle::count' => ['0|positive-int'], 'ResourceBundle::create' => ['?ResourceBundle', 'locale'=>'string', 'bundlename'=>'string', 'fallback='=>'bool'], 'ResourceBundle::get' => ['', 'index'=>'string|int', 'fallback='=>'bool'], 'ResourceBundle::getErrorCode' => ['int'], 'ResourceBundle::getErrorMessage' => ['string'], 'ResourceBundle::getLocales' => ['array', 'bundlename'=>'string'], 'resourcebundle_count' => ['int', 'r'=>'resourcebundle'], 'resourcebundle_create' => ['?ResourceBundle', 'locale'=>'string', 'bundlename'=>'string', 'fallback='=>'bool'], 'resourcebundle_get' => ['', 'r'=>'resourcebundle', 'index'=>'string|int', 'fallback='=>'bool'], 'resourcebundle_get_error_code' => ['int', 'r'=>'resourcebundle'], 'resourcebundle_get_error_message' => ['string', 'r'=>'resourcebundle'], 'resourcebundle_locales' => ['array|false', 'bundlename'=>'string'], 'restore_error_handler' => ['true'], 'restore_exception_handler' => ['true'], 'restore_include_path' => ['void'], 'rewind' => ['bool', 'fp'=>'resource'], 'rewinddir' => ['null|false', 'dir_handle='=>'resource'], 'rmdir' => ['bool', 'dirname'=>'string', 'context='=>'resource'], 'round' => ['__benevolent<float|false>', 'number'=>'float', 'precision='=>'int', 'mode='=>'1|2|3|4'], 'rpm_close' => ['bool', 'rpmr'=>'resource'], 'rpm_get_tag' => ['mixed', 'rpmr'=>'resource', 'tagnum'=>'int'], 'rpm_is_valid' => ['bool', 'filename'=>'string'], 'rpm_open' => ['resource|false', 'filename'=>'string'], 'rpm_version' => ['string'], 'rrd_create' => ['bool', 'filename'=>'string', 'options'=>'array'], 'rrd_error' => ['string'], 'rrd_fetch' => ['array', 'filename'=>'string', 'options'=>'array'], 'rrd_first' => ['int', 'file'=>'string', 'raaindex='=>'int'], 'rrd_graph' => ['array', 'filename'=>'string', 'options'=>'array'], 'rrd_info' => ['array', 'filename'=>'string'], 'rrd_last' => ['int', 'filename'=>'string'], 'rrd_lastupdate' => ['array', 'filename'=>'string'], 'rrd_restore' => ['bool', 'xml_file'=>'string', 'rrd_file'=>'string', 'options='=>'array'], 'rrd_tune' => ['bool', 'filename'=>'string', 'options'=>'array'], 'rrd_update' => ['bool', 'filename'=>'string', 'options'=>'array'], 'rrd_version' => ['string'], 'rrd_xport' => ['array', 'options'=>'array'], 'rrdc_disconnect' => ['void'], 'RRDCreator::__construct' => ['void', 'path'=>'string', 'starttime='=>'string', 'step='=>'int'], 'RRDCreator::addArchive' => ['void', 'description'=>'string'], 'RRDCreator::addDataSource' => ['void', 'description'=>'string'], 'RRDCreator::save' => ['bool'], 'RRDGraph::__construct' => ['void', 'path'=>'string'], 'RRDGraph::save' => ['array'], 'RRDGraph::saveVerbose' => ['array'], 'RRDGraph::setOptions' => ['void', 'options'=>'array'], 'RRDUpdater::__construct' => ['void', 'path'=>'string'], 'RRDUpdater::update' => ['bool', 'values'=>'array', 'time='=>'string'], 'rsort' => ['bool', '&rw_array_arg'=>'array', 'sort_flags='=>'int'], 'rtrim' => ['string', 'str'=>'string', 'character_mask='=>'string'], 'runkit_class_adopt' => ['bool', 'classname'=>'string', 'parentname'=>'string'], 'runkit_class_emancipate' => ['bool', 'classname'=>'string'], 'runkit_constant_add' => ['bool', 'constname'=>'string', 'value'=>'mixed'], 'runkit_constant_redefine' => ['bool', 'constname'=>'string', 'newvalue'=>'mixed'], 'runkit_constant_remove' => ['bool', 'constname'=>'string'], 'runkit_function_add' => ['bool', 'funcname'=>'string', 'arglist'=>'string', 'code'=>'string', 'doccomment='=>'?string'], 'runkit_function_add\'1' => ['bool', 'funcname'=>'string', 'closure'=>'Closure', 'doccomment='=>'?string'], 'runkit_function_copy' => ['bool', 'funcname'=>'string', 'targetname'=>'string'], 'runkit_function_redefine' => ['bool', 'funcname'=>'string', 'arglist'=>'string', 'code'=>'string', 'doccomment='=>'?string'], 'runkit_function_redefine\'1' => ['bool', 'funcname'=>'string', 'closure'=>'Closure', 'doccomment='=>'?string'], 'runkit_function_remove' => ['bool', 'funcname'=>'string'], 'runkit_function_rename' => ['bool', 'funcname'=>'string', 'newname'=>'string'], 'runkit_import' => ['bool', 'filename'=>'string', 'flags='=>'int'], 'runkit_lint' => ['bool', 'code'=>'string'], 'runkit_lint_file' => ['bool', 'filename'=>'string'], 'runkit_method_add' => ['bool', 'classname'=>'string', 'methodname'=>'string', 'args'=>'string', 'code'=>'string', 'flags='=>'int', 'doccomment='=>'?string'], 'runkit_method_add\'1' => ['bool', 'classname'=>'string', 'methodname'=>'string', 'closure'=>'Closure', 'flags='=>'int', 'doccomment='=>'?string'], 'runkit_method_copy' => ['bool', 'dclass'=>'string', 'dmethod'=>'string', 'sclass'=>'string', 'smethod='=>'string'], 'runkit_method_redefine' => ['bool', 'classname'=>'string', 'methodname'=>'string', 'args'=>'string', 'code'=>'string', 'flags='=>'int', 'doccomment='=>'?string'], 'runkit_method_redefine\'1' => ['bool', 'classname'=>'string', 'methodname'=>'string', 'closure'=>'Closure', 'flags='=>'int', 'doccomment='=>'?string'], 'runkit_method_remove' => ['bool', 'classname'=>'string', 'methodname'=>'string'], 'runkit_method_rename' => ['bool', 'classname'=>'string', 'methodname'=>'string', 'newname'=>'string'], 'runkit_return_value_used' => ['bool'], 'Runkit_Sandbox::__construct' => ['void', 'options='=>'array'], 'runkit_sandbox_output_handler' => ['mixed', 'sandbox'=>'object', 'callback='=>'mixed'], 'Runkit_Sandbox_Parent' => [''], 'Runkit_Sandbox_Parent::__construct' => ['void'], 'runkit_superglobals' => ['array'], 'RuntimeException::__clone' => ['void'], 'RuntimeException::__construct' => ['void', 'message='=>'string', 'code='=>'int', 'previous='=>'(?Throwable)|(?RuntimeException)'], 'RuntimeException::__toString' => ['string'], 'RuntimeException::getCode' => ['int'], 'RuntimeException::getFile' => ['string'], 'RuntimeException::getLine' => ['int'], 'RuntimeException::getMessage' => ['string'], 'RuntimeException::getPrevious' => ['Throwable|RuntimeException|null'], 'RuntimeException::getTrace' => ['list<array{function:string,line?:int,file?:string,class?:class-string,type?:\'::\'|\'->\',args?:mixed[],object?:object}>'], 'RuntimeException::getTraceAsString' => ['string'], 'SAMConnection::commit' => ['bool'], 'SAMConnection::connect' => ['bool', 'protocol'=>'string', 'properties='=>'array'], 'SAMConnection::disconnect' => ['bool'], 'SAMConnection::errno' => ['int'], 'SAMConnection::error' => ['string'], 'SAMConnection::isConnected' => ['bool'], 'SAMConnection::peek' => ['SAMMessage', 'target'=>'string', 'properties='=>'array'], 'SAMConnection::peekAll' => ['array', 'target'=>'string', 'properties='=>'array'], 'SAMConnection::receive' => ['SAMMessage', 'target'=>'string', 'properties='=>'array'], 'SAMConnection::remove' => ['SAMMessage', 'target'=>'string', 'properties='=>'array'], 'SAMConnection::rollback' => ['bool'], 'SAMConnection::send' => ['string', 'target'=>'string', 'msg'=>'sammessage', 'properties='=>'array'], 'SAMConnection::setDebug' => ['', 'switch'=>'bool'], 'SAMConnection::subscribe' => ['string', 'targettopic'=>'string'], 'SAMConnection::unsubscribe' => ['bool', 'subscriptionid'=>'string', 'targettopic='=>'string'], 'SAMMessage::body' => ['string'], 'SAMMessage::header' => ['object'], 'sapi_windows_cp_conv' => ['string', 'in_codepage'=>'int|string', 'out_codepage'=>'int|string', 'subject'=>'string'], 'sapi_windows_cp_get' => ['int'], 'sapi_windows_cp_is_utf8' => ['bool'], 'sapi_windows_cp_set' => ['bool', 'code_page'=>'int'], 'sapi_windows_vt100_support' => ['bool', 'stream'=>'resource', 'enable='=>'bool'], 'SCA::createDataObject' => ['SDO_DataObject', 'type_namespace_uri'=>'string', 'type_name'=>'string'], 'SCA::getService' => ['', 'target'=>'string', 'binding='=>'string', 'config='=>'array'], 'SCA_LocalProxy::createDataObject' => ['SDO_DataObject', 'type_namespace_uri'=>'string', 'type_name'=>'string'], 'SCA_SoapProxy::createDataObject' => ['SDO_DataObject', 'type_namespace_uri'=>'string', 'type_name'=>'string'], 'scalebarObj::convertToString' => ['string'], 'scalebarObj::free' => ['void'], 'scalebarObj::set' => ['int', 'property_name'=>'string', 'new_value'=>''], 'scalebarObj::setImageColor' => ['int', 'red'=>'int', 'green'=>'int', 'blue'=>'int'], 'scalebarObj::updateFromString' => ['int', 'snippet'=>'string'], 'scandir' => ['list<string>|false', 'dir'=>'string', 'sorting_order='=>'int', 'context='=>'resource'], 'SDO_DAS_ChangeSummary::beginLogging' => [''], 'SDO_DAS_ChangeSummary::endLogging' => [''], 'SDO_DAS_ChangeSummary::getChangedDataObjects' => ['SDO_List'], 'SDO_DAS_ChangeSummary::getChangeType' => ['int', 'dataobject'=>'sdo_dataobject'], 'SDO_DAS_ChangeSummary::getOldContainer' => ['SDO_DataObject', 'data_object'=>'sdo_dataobject'], 'SDO_DAS_ChangeSummary::getOldValues' => ['SDO_List', 'data_object'=>'sdo_dataobject'], 'SDO_DAS_ChangeSummary::isLogging' => ['bool'], 'SDO_DAS_DataFactory::addPropertyToType' => ['', 'parent_type_namespace_uri'=>'string', 'parent_type_name'=>'string', 'property_name'=>'string', 'type_namespace_uri'=>'string', 'type_name'=>'string', 'options='=>'array'], 'SDO_DAS_DataFactory::addType' => ['', 'type_namespace_uri'=>'string', 'type_name'=>'string', 'options='=>'array'], 'SDO_DAS_DataFactory::getDataFactory' => ['SDO_DAS_DataFactory'], 'SDO_DAS_DataObject::getChangeSummary' => ['SDO_DAS_ChangeSummary'], 'SDO_DAS_Relational::__construct' => ['void', 'database_metadata'=>'array', 'application_root_type='=>'string', 'sdo_containment_references_metadata='=>'array'], 'SDO_DAS_Relational::applyChanges' => ['', 'database_handle'=>'pdo', 'root_data_object'=>'sdodataobject'], 'SDO_DAS_Relational::createRootDataObject' => ['SDODataObject'], 'SDO_DAS_Relational::executePreparedQuery' => ['SDODataObject', 'database_handle'=>'pdo', 'prepared_statement'=>'pdostatement', 'value_list'=>'array', 'column_specifier='=>'array'], 'SDO_DAS_Relational::executeQuery' => ['SDODataObject', 'database_handle'=>'pdo', 'sql_statement'=>'string', 'column_specifier='=>'array'], 'SDO_DAS_Setting::getListIndex' => ['int'], 'SDO_DAS_Setting::getPropertyIndex' => ['int'], 'SDO_DAS_Setting::getPropertyName' => ['string'], 'SDO_DAS_Setting::getValue' => [''], 'SDO_DAS_Setting::isSet' => ['bool'], 'SDO_DAS_XML::addTypes' => ['', 'xsd_file'=>'string'], 'SDO_DAS_XML::create' => ['SDO_DAS_XML', 'xsd_file='=>'mixed', 'key='=>'string'], 'SDO_DAS_XML::createDataObject' => ['SDO_DataObject', 'namespace_uri'=>'string', 'type_name'=>'string'], 'SDO_DAS_XML::createDocument' => ['SDO_DAS_XML_Document', 'document_element_name'=>'string', 'document_element_namespace_uri'=>'string', 'dataobject='=>'sdo_dataobject'], 'SDO_DAS_XML::loadFile' => ['SDO_XMLDocument', 'xml_file'=>'string'], 'SDO_DAS_XML::loadString' => ['SDO_DAS_XML_Document', 'xml_string'=>'string'], 'SDO_DAS_XML::saveFile' => ['', 'xdoc'=>'sdo_xmldocument', 'xml_file'=>'string', 'indent='=>'int'], 'SDO_DAS_XML::saveString' => ['string', 'xdoc'=>'sdo_xmldocument', 'indent='=>'int'], 'SDO_DAS_XML_Document::getRootDataObject' => ['SDO_DataObject'], 'SDO_DAS_XML_Document::getRootElementName' => ['string'], 'SDO_DAS_XML_Document::getRootElementURI' => ['string'], 'SDO_DAS_XML_Document::setEncoding' => ['', 'encoding'=>'string'], 'SDO_DAS_XML_Document::setXMLDeclaration' => ['', 'xmldeclatation'=>'bool'], 'SDO_DAS_XML_Document::setXMLVersion' => ['', 'xmlversion'=>'string'], 'SDO_DataFactory::create' => ['void', 'type_namespace_uri'=>'string', 'type_name'=>'string'], 'SDO_DataObject::clear' => ['void'], 'SDO_DataObject::createDataObject' => ['SDO_DataObject', 'identifier'=>''], 'SDO_DataObject::getContainer' => ['SDO_DataObject'], 'SDO_DataObject::getSequence' => ['SDO_Sequence'], 'SDO_DataObject::getTypeName' => ['string'], 'SDO_DataObject::getTypeNamespaceURI' => ['string'], 'SDO_Exception::getCause' => [''], 'SDO_List::insert' => ['void', 'value'=>'mixed', 'index='=>'int'], 'SDO_Model_Property::getContainingType' => ['SDO_Model_Type'], 'SDO_Model_Property::getDefault' => [''], 'SDO_Model_Property::getName' => ['string'], 'SDO_Model_Property::getType' => ['SDO_Model_Type'], 'SDO_Model_Property::isContainment' => ['bool'], 'SDO_Model_Property::isMany' => ['bool'], 'SDO_Model_ReflectionDataObject::__construct' => ['void', 'data_object'=>'sdo_dataobject'], 'SDO_Model_ReflectionDataObject::export' => ['mixed', 'rdo'=>'sdo_model_reflectiondataobject', 'return='=>'bool'], 'SDO_Model_ReflectionDataObject::getContainmentProperty' => ['SDO_Model_Property'], 'SDO_Model_ReflectionDataObject::getInstanceProperties' => ['array'], 'SDO_Model_ReflectionDataObject::getType' => ['SDO_Model_Type'], 'SDO_Model_Type::getBaseType' => ['SDO_Model_Type'], 'SDO_Model_Type::getName' => ['string'], 'SDO_Model_Type::getNamespaceURI' => ['string'], 'SDO_Model_Type::getProperties' => ['array'], 'SDO_Model_Type::getProperty' => ['SDO_Model_Property', 'identifier'=>''], 'SDO_Model_Type::isAbstractType' => ['bool'], 'SDO_Model_Type::isDataType' => ['bool'], 'SDO_Model_Type::isInstance' => ['bool', 'data_object'=>'sdo_dataobject'], 'SDO_Model_Type::isOpenType' => ['bool'], 'SDO_Model_Type::isSequencedType' => ['bool'], 'SDO_Sequence::getProperty' => ['SDO_Model_Property', 'sequence_index'=>'int'], 'SDO_Sequence::insert' => ['void', 'value'=>'mixed', 'sequenceindex='=>'int', 'propertyidentifier='=>'mixed'], 'SDO_Sequence::move' => ['void', 'toindex'=>'int', 'fromindex'=>'int'], 'SeekableIterator::seek' => ['void', 'position'=>'int'], 'sem_acquire' => ['bool', 'sem_identifier'=>'resource', 'nowait='=>'bool'], 'sem_get' => ['resource|false', 'key'=>'int', 'max_acquire='=>'int', 'perm='=>'int', 'auto_release='=>'int'], 'sem_release' => ['bool', 'sem_identifier'=>'resource'], 'sem_remove' => ['bool', 'sem_identifier'=>'resource'], 'Serializable::serialize' => ['string'], 'Serializable::unserialize' => ['void', 'serialized'=>'string'], 'serialize' => ['string', 'variable'=>'mixed'], 'ServerRequest::withInput' => ['ServerRequest', 'input'=>'mixed'], 'ServerRequest::withoutParams' => ['ServerRequest', 'params'=>'int|string'], 'ServerRequest::withParam' => ['ServerRequest', 'key'=>'int|string', 'val'=>'mixed'], 'ServerRequest::withParams' => ['ServerRequest', 'params'=>'mixed'], 'ServerRequest::withUrl' => ['ServerRequest', 'url'=>'array'], 'ServerResponse::addHeader' => ['void', 'label'=>'string', 'value'=>'string'], 'ServerResponse::date' => ['string', 'date'=>'string|DateTimeInterface'], 'ServerResponse::getHeader' => ['string', 'label'=>'string'], 'ServerResponse::getHeaders' => ['string[]'], 'ServerResponse::getStatus' => ['int'], 'ServerResponse::getVersion' => ['string'], 'ServerResponse::setHeader' => ['void', 'label'=>'string', 'value'=>'string'], 'ServerResponse::setStatus' => ['void', 'status'=>'int'], 'ServerResponse::setVersion' => ['void', 'version'=>'string'], 'session_abort' => ['bool'], 'session_cache_expire' => ['int|false', 'new_cache_expire='=>'int'], 'session_cache_limiter' => ['string|false', 'new_cache_limiter='=>'string'], 'session_commit' => ['bool'], 'session_create_id' => ['string|false', 'prefix='=>'string'], 'session_decode' => ['bool', 'data'=>'string'], 'session_destroy' => ['bool'], 'session_encode' => ['string|false'], 'session_gc' => ['int|false'], 'session_get_cookie_params' => ['array{lifetime:0|positive-int,path:non-falsy-string,domain:string,secure:bool,httponly:bool,samesite:string}'], 'session_id' => ['string|false', 'newid='=>'string'], 'session_is_registered' => ['bool', 'name'=>'string'], 'session_module_name' => ['string|false', 'newname='=>'string'], 'session_name' => ['non-falsy-string|false', 'newname='=>'string'], 'session_pgsql_add_error' => ['bool', 'error_level'=>'int', 'error_message='=>'string'], 'session_pgsql_get_error' => ['array', 'with_error_message='=>'bool'], 'session_pgsql_get_field' => ['string'], 'session_pgsql_reset' => ['bool'], 'session_pgsql_set_field' => ['bool', 'value'=>'string'], 'session_pgsql_status' => ['array'], 'session_regenerate_id' => ['bool', 'delete_old_session='=>'bool'], 'session_register' => ['bool', 'name'=>'mixed', '...args='=>'mixed'], 'session_register_shutdown' => ['void'], 'session_reset' => ['bool'], 'session_save_path' => ['string|false', 'newname='=>'string'], 'session_set_cookie_params' => ['bool', 'lifetime'=>'int', 'path='=>'string', 'domain='=>'?string', 'secure='=>'bool', 'httponly='=>'bool'], 'session_set_cookie_params\'1' => ['bool', 'options'=>'array{lifetime?:int,path?:string,domain?:?string,secure?:bool,httponly?:bool,samesite?:string}'], 'session_set_save_handler' => ['bool', 'open'=>'callable(string,string):bool', 'close'=>'callable():bool', 'read'=>'callable(string):string', 'write'=>'callable(string,string):bool', 'destroy'=>'callable(string):bool', 'gc'=>'callable(string):bool', 'create_sid='=>'callable():string', 'validate_sid='=>'callable(string):bool', 'update_timestamp='=>'callable(string):bool'], 'session_set_save_handler\'1' => ['bool', 'sessionhandler'=>'SessionHandlerInterface', 'register_shutdown='=>'bool'], 'session_start' => ['bool', 'options='=>'array'], 'session_status' => ['PHP_SESSION_NONE|PHP_SESSION_DISABLED|PHP_SESSION_ACTIVE'], 'session_unregister' => ['bool', 'name'=>'string'], 'session_unset' => ['bool'], 'session_write_close' => ['bool'], 'SessionHandler::close' => ['bool'], 'SessionHandler::create_sid' => ['char'], 'SessionHandler::destroy' => ['bool', 'id'=>'string'], 'SessionHandler::gc' => ['int|false', 'maxlifetime'=>'int'], 'SessionHandler::open' => ['bool', 'save_path'=>'string', 'session_name'=>'string'], 'SessionHandler::read' => ['string', 'id'=>'string'], 'SessionHandler::updateTimestamp' => ['bool', 'session_id'=>'string', 'session_data'=>'string'], 'SessionHandler::validateId' => ['bool', 'session_id'=>'string'], 'SessionHandler::write' => ['bool', 'id'=>'string', 'data'=>'string'], 'SessionHandlerInterface::close' => ['bool'], 'SessionHandlerInterface::destroy' => ['bool', 'session_id'=>'string'], 'SessionHandlerInterface::gc' => ['int|false', 'maxlifetime'=>'int'], 'SessionHandlerInterface::open' => ['bool', 'save_path'=>'string', 'name'=>'string'], 'SessionHandlerInterface::read' => ['string', 'session_id'=>'string'], 'SessionHandlerInterface::write' => ['bool', 'session_id'=>'string', 'session_data'=>'string'], 'SessionIdInterface::create_sid' => ['string'], 'SessionUpdateTimestampHandler::updateTimestamp' => ['bool', 'id'=>'string', 'data'=>'string'], 'SessionUpdateTimestampHandler::validateId' => ['char', 'id'=>'string'], 'SessionUpdateTimestampHandlerInterface::updateTimestamp' => ['bool', 'key'=>'string', 'val'=>'string'], 'SessionUpdateTimestampHandlerInterface::validateId' => ['bool', 'key'=>'string'], 'set_error_handler' => ['?callable', 'callback'=>'null|callable(int,string,string,int,array):bool', 'error_types='=>'int'], 'set_exception_handler' => ['null|callable(Throwable):void', 'exception_handler'=>'null|callable(Throwable):void'], 'set_file_buffer' => ['int', 'fp'=>'resource', 'buffer'=>'int'], 'set_include_path' => ['string|false', 'new_include_path'=>'string'], 'set_magic_quotes_runtime' => ['bool', 'new_setting'=>'bool'], 'set_time_limit' => ['bool', 'seconds'=>'int'], 'setcookie' => ['bool', 'name'=>'string', 'value='=>'string', 'expires='=>'int', 'path='=>'string', 'domain='=>'string', 'secure='=>'bool', 'httponly='=>'bool'], 'setcookie\'1' => ['bool', 'name'=>'string', 'value='=>'string', 'options='=>'array{ expires?:int, path?:string, domain?:string, secure?:bool, httponly?:bool, samesite?:\'None\'|\'Lax\'|\'Strict\'|\'none\'|\'lax\'|\'strict\'}'], 'setLeftFill' => ['void', 'red'=>'int', 'green'=>'int', 'blue'=>'int', 'a='=>'int'], 'setLine' => ['void', 'width'=>'int', 'red'=>'int', 'green'=>'int', 'blue'=>'int', 'a='=>'int'], 'setlocale' => ['string|false', 'category'=>'int', 'locale'=>'string|null', '...args='=>'string'], 'setlocale\'1' => ['string|false', 'category'=>'int', 'locale'=>'?array'], 'setrawcookie' => ['bool', 'name'=>'string', 'value='=>'string', 'expires='=>'int', 'path='=>'string', 'domain='=>'string', 'secure='=>'bool', 'httponly='=>'bool'], 'setrawcookie\'1' => ['bool', 'name'=>'string', 'value='=>'string', 'options='=>'array{ expires?:int, path?:string, domain?:string, secure?:bool, httponly?:bool, samesite?:\'None\'|\'Lax\'|\'Strict\'|\'none\'|\'lax\'|\'strict\'}'], 'setRightFill' => ['void', 'red'=>'int', 'green'=>'int', 'blue'=>'int', 'a='=>'int'], 'setthreadtitle' => ['bool', 'title'=>'string'], 'settype' => ['bool', '&rw_var'=>'mixed', 'type'=>'string'], 'sha1' => ['non-falsy-string&lowercase-string', 'str'=>'string', 'raw_output='=>'bool'], 'sha1_file' => ['(non-falsy-string&lowercase-string)|false', 'filename'=>'string', 'raw_output='=>'bool'], 'shapefileObj::__construct' => ['void', 'filename'=>'string', 'type'=>'int'], 'shapefileObj::addPoint' => ['int', 'point'=>'pointObj'], 'shapefileObj::addShape' => ['int', 'shape'=>'shapeObj'], 'shapefileObj::free' => ['void'], 'shapefileObj::getExtent' => ['rectObj', 'i'=>'int'], 'shapefileObj::getPoint' => ['shapeObj', 'i'=>'int'], 'shapefileObj::getShape' => ['shapeObj', 'i'=>'int'], 'shapefileObj::getTransformed' => ['shapeObj', 'map'=>'mapObj', 'i'=>'int'], 'shapefileObj::ms_newShapefileObj' => ['shapefileObj', 'filename'=>'string', 'type'=>'int'], 'shapeObj::__construct' => ['void', 'type'=>'int'], 'shapeObj::add' => ['int', 'line'=>'lineObj'], 'shapeObj::boundary' => ['shapeObj'], 'shapeObj::contains' => ['bool', 'point'=>'pointObj'], 'shapeObj::containsShape' => ['int', 'shape2'=>'shapeObj'], 'shapeObj::convexhull' => ['shapeObj'], 'shapeObj::crosses' => ['int', 'shape'=>'shapeObj'], 'shapeObj::difference' => ['shapeObj', 'shape'=>'shapeObj'], 'shapeObj::disjoint' => ['int', 'shape'=>'shapeObj'], 'shapeObj::draw' => ['int', 'map'=>'mapObj', 'layer'=>'layerObj', 'img'=>'imageObj'], 'shapeObj::equals' => ['int', 'shape'=>'shapeObj'], 'shapeObj::free' => ['void'], 'shapeObj::getArea' => ['float'], 'shapeObj::getCentroid' => ['pointObj'], 'shapeObj::getLabelPoint' => ['pointObj'], 'shapeObj::getLength' => ['float'], 'shapeObj::getPointUsingMeasure' => ['pointObj', 'm'=>'float'], 'shapeObj::getValue' => ['string', 'layer'=>'layerObj', 'filedname'=>'string'], 'shapeObj::intersection' => ['shapeObj', 'shape'=>'shapeObj'], 'shapeObj::intersects' => ['bool', 'shape'=>'shapeObj'], 'shapeObj::line' => ['lineObj', 'i'=>'int'], 'shapeObj::ms_shapeObjFromWkt' => ['shapeObj', 'wkt'=>'string'], 'shapeObj::overlaps' => ['int', 'shape'=>'shapeObj'], 'shapeObj::project' => ['int', 'in'=>'projectionObj', 'out'=>'projectionObj'], 'shapeObj::set' => ['int', 'property_name'=>'string', 'new_value'=>''], 'shapeObj::setBounds' => ['int'], 'shapeObj::simplify' => ['shapeObj', 'tolerance'=>'float'], 'shapeObj::symdifference' => ['shapeObj', 'shape'=>'shapeObj'], 'shapeObj::topologyPreservingSimplify' => ['shapeObj', 'tolerance'=>'float'], 'shapeObj::touches' => ['int', 'shape'=>'shapeObj'], 'shapeObj::toWkt' => ['string'], 'shapeObj::union' => ['shapeObj', 'shape'=>'shapeObj'], 'shapeObj::within' => ['int', 'shape2'=>'shapeObj'], 'shell_exec' => ['?string', 'cmd'=>'string'], 'shm_attach' => ['resource|false', 'key'=>'int', 'memsize='=>'int', 'perm='=>'int'], 'shm_detach' => ['bool', 'shm_identifier'=>'resource'], 'shm_get_var' => ['mixed', 'id'=>'resource', 'variable_key'=>'int'], 'shm_has_var' => ['bool', 'shm_identifier'=>'resource', 'variable_key'=>'int'], 'shm_put_var' => ['bool', 'shm_identifier'=>'resource', 'variable_key'=>'int', 'variable'=>'mixed'], 'shm_remove' => ['bool', 'shm_identifier'=>'resource'], 'shm_remove_var' => ['bool', 'shm_identifier'=>'resource', 'variable_key'=>'int'], 'shmop_close' => ['void', 'shmid'=>'resource'], 'shmop_delete' => ['bool', 'shmid'=>'resource'], 'shmop_open' => ['resource|false', 'key'=>'int', 'flags'=>'string', 'mode'=>'int', 'size'=>'int'], 'shmop_read' => ['string', 'shmid'=>'resource', 'start'=>'int', 'count'=>'int'], 'shmop_size' => ['int', 'shmid'=>'resource'], 'shmop_write' => ['int', 'shmid'=>'resource', 'data'=>'string', 'offset'=>'int'], 'show_source' => ['', 'file_name'=>'', 'return'=>''], 'shuffle' => ['bool', '&rw_array_arg'=>'array'], 'signeurlpaiement' => ['string', 'clent'=>'string', 'data'=>'string'], 'similar_text' => ['int', 'str1'=>'string', 'str2'=>'string', '&w_percent='=>'float'], 'simplexml_import_dom' => ['SimpleXMLElement|null', 'node'=>'DOMNode', 'class_name='=>'string'], 'simplexml_load_file' => ['SimpleXMLElement|false', 'filename'=>'string', 'class_name='=>'string', 'options='=>'int', 'ns='=>'string', 'is_prefix='=>'bool'], 'simplexml_load_string' => ['SimpleXMLElement|false', 'data'=>'string', 'class_name='=>'string', 'options='=>'int', 'ns='=>'string', 'is_prefix='=>'bool'], 'SimpleXMLElement::__construct' => ['void', 'data'=>'string', 'options='=>'int', 'data_is_url='=>'bool', 'ns='=>'string', 'is_prefix='=>'bool'], 'SimpleXMLElement::__get' => ['static', 'name'=>'string'], 'SimpleXMLElement::__toString' => ['string'], 'SimpleXMLElement::addAttribute' => ['void', 'name'=>'string', 'value='=>'string', 'ns='=>'string'], 'SimpleXMLElement::addChild' => ['__benevolent<static|null>', 'name'=>'string', 'value='=>'string|null', 'ns='=>'string|null'], 'SimpleXMLElement::asXML' => ['string|bool', 'filename='=>'string'], 'SimpleXMLElement::attributes' => ['__benevolent<static|null>', 'ns='=>'string', 'is_prefix='=>'bool'], 'SimpleXMLElement::children' => ['__benevolent<static|null>', 'namespaceOrPrefix='=>'string|null', 'is_prefix='=>'bool'], 'SimpleXMLElement::count' => ['0|positive-int'], 'SimpleXMLElement::getDocNamespaces' => ['string[]|false', 'recursive='=>'bool', 'from_root='=>'bool'], 'SimpleXMLElement::getName' => ['string'], 'SimpleXMLElement::getNamespaces' => ['string[]', 'recursive='=>'bool'], 'SimpleXMLElement::registerXPathNamespace' => ['bool', 'prefix'=>'string', 'ns'=>'string'], 'SimpleXMLElement::xpath' => ['static[]|false|null', 'path'=>'string'], 'SimpleXMLIterator::current' => ['SimpleXMLIterator'], 'SimpleXMLIterator::getChildren' => ['SimpleXMLIterator'], 'SimpleXMLIterator::hasChildren' => ['bool'], 'SimpleXMLIterator::key' => ['string|false'], 'SimpleXMLIterator::next' => ['void'], 'SimpleXMLIterator::rewind' => ['void'], 'SimpleXMLIterator::valid' => ['bool'], 'sin' => ['float', 'number'=>'float'], 'sinh' => ['float', 'number'=>'float'], 'sizeof' => ['int', 'var'=>'Countable|array', 'mode='=>'int'], 'sleep' => ['int|false', 'seconds'=>'int'], 'snmp2_get' => ['string|false', 'host'=>'string', 'community'=>'string', 'object_id'=>'string', 'timeout='=>'int', 'retries='=>'int'], 'snmp2_getnext' => ['string|false', 'host'=>'string', 'community'=>'string', 'object_id'=>'string', 'timeout='=>'int', 'retries='=>'int'], 'snmp2_real_walk' => ['array|false', 'host'=>'string', 'community'=>'string', 'object_id'=>'string', 'timeout='=>'int', 'retries='=>'int'], 'snmp2_set' => ['bool', 'host'=>'string', 'community'=>'string', 'object_id'=>'string', 'type'=>'string', 'value'=>'string', 'timeout='=>'int', 'retries='=>'int'], 'snmp2_walk' => ['array|false', 'host'=>'string', 'community'=>'string', 'object_id'=>'string', 'timeout='=>'int', 'retries='=>'int'], 'snmp3_get' => ['string|false', 'host'=>'string', 'sec_name'=>'string', 'sec_level'=>'string', 'auth_protocol'=>'string', 'auth_passphrase'=>'string', 'priv_protocol'=>'string', 'priv_passphrase'=>'string', 'object_id'=>'string', 'timeout='=>'int', 'retries='=>'int'], 'snmp3_getnext' => ['string|false', 'host'=>'string', 'sec_name'=>'string', 'sec_level'=>'string', 'auth_protocol'=>'string', 'auth_passphrase'=>'string', 'priv_protocol'=>'string', 'priv_passphrase'=>'string', 'object_id'=>'string', 'timeout='=>'int', 'retries='=>'int'], 'snmp3_real_walk' => ['array|false', 'host'=>'string', 'sec_name'=>'string', 'sec_level'=>'string', 'auth_protocol'=>'string', 'auth_passphrase'=>'string', 'priv_protocol'=>'string', 'priv_passphrase'=>'string', 'object_id'=>'string', 'timeout='=>'int', 'retries='=>'int'], 'snmp3_set' => ['bool', 'host'=>'string', 'sec_name'=>'string', 'sec_level'=>'string', 'auth_protocol'=>'string', 'auth_passphrase'=>'string', 'priv_protocol'=>'string', 'priv_passphrase'=>'string', 'object_id'=>'string', 'type'=>'string', 'value'=>'string', 'timeout='=>'int', 'retries='=>'int'], 'snmp3_walk' => ['array|false', 'host'=>'string', 'sec_name'=>'string', 'sec_level'=>'string', 'auth_protocol'=>'string', 'auth_passphrase'=>'string', 'priv_protocol'=>'string', 'priv_passphrase'=>'string', 'object_id'=>'string', 'timeout='=>'int', 'retries='=>'int'], 'SNMP::__construct' => ['void', 'version'=>'int', 'hostname'=>'string', 'community'=>'string', 'timeout='=>'int', 'retries='=>'int'], 'SNMP::close' => ['bool'], 'SNMP::get' => ['array|string|false', 'object_id'=>'string|array', 'preserve_keys='=>'bool'], 'SNMP::getErrno' => ['int'], 'SNMP::getError' => ['string'], 'SNMP::getnext' => ['string|array|false', 'object_id'=>'string|array'], 'SNMP::set' => ['bool', 'object_id'=>'string|array', 'type'=>'string|array', 'value'=>'mixed'], 'SNMP::setSecurity' => ['bool', 'sec_level'=>'string', 'auth_protocol='=>'string', 'auth_passphrase='=>'string', 'priv_protocol='=>'string', 'priv_passphrase='=>'string', 'contextname='=>'string', 'contextengineid='=>'string'], 'SNMP::walk' => ['array|false', 'object_id'=>'string', 'suffix_as_key='=>'bool', 'non_repeaters='=>'int', 'max_repetitions='=>'int'], 'snmp_get_quick_print' => ['bool'], 'snmp_get_valueretrieval' => ['int'], 'snmp_read_mib' => ['bool', 'filename'=>'string'], 'snmp_set_enum_print' => ['bool', 'enum_print'=>'int'], 'snmp_set_oid_numeric_print' => ['void', 'oid_format'=>'int'], 'snmp_set_oid_output_format' => ['bool', 'oid_format'=>'int'], 'snmp_set_quick_print' => ['bool', 'quick_print'=>'int'], 'snmp_set_valueretrieval' => ['bool', 'method='=>'int'], 'snmpget' => ['string|false', 'host'=>'string', 'community'=>'string', 'object_id'=>'string', 'timeout='=>'int', 'retries='=>'int'], 'snmpgetnext' => ['string|false', 'host'=>'string', 'community'=>'string', 'object_id'=>'string', 'timeout='=>'int', 'retries='=>'int'], 'snmprealwalk' => ['array|false', 'host'=>'string', 'community'=>'string', 'object_id'=>'string', 'timeout='=>'int', 'retries='=>'int'], 'snmpset' => ['bool', 'host'=>'string', 'community'=>'string', 'object_id'=>'string', 'type'=>'string', 'value'=>'mixed', 'timeout='=>'int', 'retries='=>'int'], 'snmpwalk' => ['array|false', 'host'=>'string', 'community'=>'string', 'object_id'=>'string', 'timeout='=>'int', 'retries='=>'int'], 'snmpwalkoid' => ['array|false', 'hostname'=>'string', 'community'=>'string', 'object_id'=>'string', 'timeout='=>'int', 'retries='=>'int'], 'SoapClient::__call' => ['mixed', 'function_name'=>'string', 'arguments'=>'array'], 'SoapClient::__construct' => ['void', 'wsdl'=>'mixed', 'options='=>'array|null'], 'SoapClient::__doRequest' => ['string|null', 'request'=>'string', 'location'=>'string', 'action'=>'string', 'version'=>'int', 'one_way='=>'int'], 'SoapClient::__getCookies' => ['array'], 'SoapClient::__getFunctions' => ['array|null'], 'SoapClient::__getLastRequest' => ['string|null'], 'SoapClient::__getLastRequestHeaders' => ['string|null'], 'SoapClient::__getLastResponse' => ['string|null'], 'SoapClient::__getLastResponseHeaders' => ['string|null'], 'SoapClient::__getTypes' => ['array|null'], 'SoapClient::__setCookie' => ['', 'name'=>'string', 'value='=>'string'], 'SoapClient::__setLocation' => ['string|null', 'new_location='=>'string'], 'SoapClient::__setSoapHeaders' => ['bool', 'soapheaders='=>''], 'SoapClient::__soapCall' => ['mixed', 'function_name'=>'string', 'arguments'=>'array', 'options='=>'array', 'input_headers='=>'SoapHeader|array', '&w_output_headers='=>'array'], 'SoapClient::SoapClient' => ['object', 'wsdl'=>'mixed', 'options='=>'array|null'], 'SoapFault::__construct' => ['void', 'faultcode'=>'string', 'string'=>'string', 'faultactor='=>'string', 'detail='=>'mixed', 'faultname='=>'string', 'headerfault='=>'mixed'], 'SoapFault::__toString' => ['string'], 'SoapFault::SoapFault' => ['object', 'faultcode'=>'string', 'string'=>'string', 'faultactor='=>'string', 'detail='=>'string', 'faultname='=>'string', 'headerfault='=>'string'], 'SoapHeader::__construct' => ['void', 'namespace'=>'string', 'name'=>'string', 'data='=>'mixed', 'mustunderstand='=>'bool', 'actor='=>'string'], 'SoapHeader::SoapHeader' => ['object', 'namespace'=>'string', 'name'=>'string', 'data='=>'mixed', 'mustunderstand='=>'bool', 'actor='=>'string'], 'SoapParam::__construct' => ['void', 'data'=>'mixed', 'name'=>'string'], 'SoapParam::SoapParam' => ['object', 'data'=>'mixed', 'name'=>'string'], 'SoapServer::__construct' => ['void', 'wsdl'=>'?string', 'options='=>'array'], 'SoapServer::addFunction' => ['void', 'functions'=>'mixed'], 'SoapServer::addSoapHeader' => ['void', 'object'=>'soapheader'], 'SoapServer::fault' => ['void', 'code'=>'string', 'string'=>'string', 'actor='=>'string', 'details='=>'string', 'name='=>'string'], 'SoapServer::getFunctions' => ['array'], 'SoapServer::handle' => ['void', 'soap_request='=>'string'], 'SoapServer::setClass' => ['void', 'class_name'=>'string', '...args='=>'mixed'], 'SoapServer::setObject' => ['void', 'obj'=>'object'], 'SoapServer::setPersistence' => ['void', 'mode'=>'int'], 'SoapServer::SoapServer' => ['object', 'wsdl'=>'?string', 'options='=>'array'], 'SoapVar::__construct' => ['void', 'data'=>'mixed', 'encoding'=>'int', 'type_name='=>'string|null', 'type_namespace='=>'string|null', 'node_name='=>'string|null', 'node_namespace='=>'string|null'], 'SoapVar::SoapVar' => ['object', 'data'=>'mixed', 'encoding'=>'int', 'type_name='=>'string|null', 'type_namespace='=>'string|null', 'node_name='=>'string|null', 'node_namespace='=>'string|null'], 'socket_accept' => ['resource|false', 'socket'=>'resource'], 'socket_addrinfo_bind' => ['resource|null|false', 'addrinfo'=>'resource'], 'socket_addrinfo_connect' => ['resource|null|false', 'addrinfo'=>'resource'], 'socket_addrinfo_explain' => ['array', 'addrinfo'=>'resource'], 'socket_addrinfo_lookup' => ['resource[]|false', 'node'=>'string', 'service='=>'mixed', 'hints='=>'array'], 'socket_bind' => ['bool', 'socket'=>'resource', 'addr'=>'string', 'port='=>'int'], 'socket_clear_error' => ['void', 'socket='=>'resource'], 'socket_close' => ['void', 'socket'=>'resource'], 'socket_cmsg_space' => ['int', 'level'=>'int', 'type'=>'int'], 'socket_connect' => ['bool', 'socket'=>'resource', 'addr'=>'string', 'port='=>'int'], 'socket_create' => ['resource|false', 'domain'=>'int', 'type'=>'int', 'protocol'=>'int'], 'socket_create_listen' => ['resource|false', 'port'=>'int', 'backlog='=>'int'], 'socket_create_pair' => ['bool', 'domain'=>'int', 'type'=>'int', 'protocol'=>'int', '&w_fd'=>'resource[]'], 'socket_export_stream' => ['resource|false', 'socket'=>'resource'], 'socket_get_option' => ['mixed', 'socket'=>'resource', 'level'=>'int', 'optname'=>'int'], 'socket_getopt' => ['mixed', 'socket'=>'resource', 'level'=>'int', 'optname'=>'int'], 'socket_getpeername' => ['bool', 'socket'=>'resource', '&w_addr'=>'string', '&w_port='=>'int'], 'socket_getsockname' => ['bool', 'socket'=>'resource', '&w_addr'=>'string', '&w_port='=>'int'], 'socket_import_stream' => ['resource|false', 'stream'=>'resource'], 'socket_last_error' => ['int', 'socket='=>'resource'], 'socket_listen' => ['bool', 'socket'=>'resource', 'backlog='=>'int'], 'socket_read' => ['string|false', 'socket'=>'resource', 'length'=>'int', 'type='=>'int'], 'socket_recv' => ['int|false', 'socket'=>'resource', '&w_buf'=>'string', 'len'=>'int', 'flags'=>'int'], 'socket_recvfrom' => ['int|false', 'socket'=>'resource', '&w_buf'=>'string', 'len'=>'int', 'flags'=>'int', '&w_name'=>'string', '&w_port='=>'int'], 'socket_recvmsg' => ['int|false', 'socket'=>'resource', '&w_message'=>'string', 'flags='=>'int'], 'socket_select' => ['int|false', '&w_read_fds'=>'resource[]|null', '&w_write_fds'=>'resource[]|null', '&w_except_fds'=>'resource[]|null', 'tv_sec'=>'int|null', 'tv_usec='=>'int|null'], 'socket_send' => ['int|false', 'socket'=>'resource', 'buf'=>'string', 'len'=>'int', 'flags'=>'int'], 'socket_sendmsg' => ['int|false', 'socket'=>'resource', 'message'=>'array', 'flags'=>'int'], 'socket_sendto' => ['int|false', 'socket'=>'resource', 'buf'=>'string', 'len'=>'int', 'flags'=>'int', 'addr'=>'string', 'port='=>'int'], 'socket_set_block' => ['bool', 'socket'=>'resource'], 'socket_set_nonblock' => ['bool', 'socket'=>'resource'], 'socket_set_option' => ['bool', 'socket'=>'resource', 'level'=>'int', 'optname'=>'int', 'optval'=>'int|string|array'], 'socket_shutdown' => ['bool', 'socket'=>'resource', 'how='=>'int'], 'socket_strerror' => ['string', 'errno'=>'int'], 'socket_write' => ['int|false', 'socket'=>'resource', 'buf'=>'string', 'length='=>'int'], 'socket_wsaprotocol_info_export' => ['string|false', 'stream'=>'resource', 'target_pid'=>'int'], 'socket_wsaprotocol_info_import' => ['resource|false', 'id'=>'string'], 'socket_wsaprotocol_info_release' => ['bool', 'id'=>'string'], 'Sodium\add' => ['', '&left'=>'string', 'right'=>'string'], 'Sodium\bin2hex' => ['string', 'binary'=>'string'], 'Sodium\compare' => ['int', 'left'=>'string', 'right'=>'string'], 'Sodium\crypto_aead_aes256gcm_decrypt' => ['string', 'msg'=>'string', 'nonce'=>'string', 'key'=>'string', 'ad='=>'string'], 'Sodium\crypto_aead_aes256gcm_encrypt' => ['string', 'msg'=>'string', 'nonce'=>'string', 'key'=>'string', 'ad='=>'string'], 'Sodium\crypto_aead_aes256gcm_is_available' => ['bool'], 'Sodium\crypto_aead_chacha20poly1305_decrypt' => ['string', 'msg'=>'string', 'nonce'=>'string', 'key'=>'string', 'ad='=>'string'], 'Sodium\crypto_aead_chacha20poly1305_encrypt' => ['string', 'msg'=>'string', 'nonce'=>'string', 'key'=>'string', 'ad='=>'string'], 'Sodium\crypto_auth' => ['string', 'msg'=>'string', 'key'=>'string'], 'Sodium\crypto_auth_verify' => ['bool', 'mac'=>'string', 'msg'=>'string', 'key'=>'string'], 'Sodium\crypto_box' => ['string', 'msg'=>'string', 'nonce'=>'string', 'keypair'=>'string'], 'Sodium\crypto_box_keypair' => ['string'], 'Sodium\crypto_box_keypair_from_secretkey_and_publickey' => ['string', 'secretkey'=>'string', 'publickey'=>'string'], 'Sodium\crypto_box_open' => ['string', 'msg'=>'string', 'nonce'=>'string', 'keypair'=>'string'], 'Sodium\crypto_box_publickey' => ['string', 'keypair'=>'string'], 'Sodium\crypto_box_publickey_from_secretkey' => ['string', 'secretkey'=>'string'], 'Sodium\crypto_box_seal' => ['string', 'message'=>'string', 'publickey'=>'string'], 'Sodium\crypto_box_seal_open' => ['string', 'encrypted'=>'string', 'keypair'=>'string'], 'Sodium\crypto_box_secretkey' => ['string', 'keypair'=>'string'], 'Sodium\crypto_box_seed_keypair' => ['string', 'seed'=>'string'], 'Sodium\crypto_generichash' => ['string', 'input'=>'string', 'key='=>'string', 'length='=>'int'], 'Sodium\crypto_generichash_final' => ['string', 'state'=>'string', 'length='=>'int'], 'Sodium\crypto_generichash_init' => ['string', 'key='=>'string', 'length='=>'int'], 'Sodium\crypto_generichash_update' => ['bool', '&hashState'=>'string', 'append'=>'string'], 'Sodium\crypto_kx' => ['string', 'secretkey'=>'string', 'publickey'=>'string', 'client_publickey'=>'string', 'server_publickey'=>'string'], 'Sodium\crypto_pwhash' => ['string', 'out_len'=>'int', 'passwd'=>'string', 'salt'=>'string', 'opslimit'=>'int', 'memlimit'=>'int'], 'Sodium\crypto_pwhash_scryptsalsa208sha256' => ['string', 'out_len'=>'int', 'passwd'=>'string', 'salt'=>'string', 'opslimit'=>'int', 'memlimit'=>'int'], 'Sodium\crypto_pwhash_scryptsalsa208sha256_str' => ['string', 'passwd'=>'string', 'opslimit'=>'int', 'memlimit'=>'int'], 'Sodium\crypto_pwhash_scryptsalsa208sha256_str_verify' => ['bool', 'hash'=>'string', 'passwd'=>'string'], 'Sodium\crypto_pwhash_str' => ['string', 'passwd'=>'string', 'opslimit'=>'int', 'memlimit'=>'int'], 'Sodium\crypto_pwhash_str_verify' => ['bool', 'hash'=>'string', 'passwd'=>'string'], 'Sodium\crypto_scalarmult' => ['string', 'ecdhA'=>'string', 'ecdhB'=>'string'], 'Sodium\crypto_scalarmult_base' => ['string', 'sk'=>'string'], 'Sodium\crypto_secretbox' => ['string', 'plaintext'=>'string', 'nonce'=>'string', 'key'=>'string'], 'Sodium\crypto_secretbox_open' => ['string', 'ciphertext'=>'string', 'nonce'=>'string', 'key'=>'string'], 'Sodium\crypto_shorthash' => ['string', 'message'=>'string', 'key'=>'string'], 'Sodium\crypto_sign' => ['string', 'message'=>'string', 'secretkey'=>'string'], 'Sodium\crypto_sign_detached' => ['string', 'message'=>'string', 'secretkey'=>'string'], 'Sodium\crypto_sign_ed25519_pk_to_curve25519' => ['string', 'sign_pk'=>'string'], 'Sodium\crypto_sign_ed25519_sk_to_curve25519' => ['string', 'sign_sk'=>'string'], 'Sodium\crypto_sign_keypair' => ['string'], 'Sodium\crypto_sign_keypair_from_secretkey_and_publickey' => ['string', 'secretkey'=>'string', 'publickey'=>'string'], 'Sodium\crypto_sign_open' => ['string|false', 'signed_message'=>'string', 'publickey'=>'string'], 'Sodium\crypto_sign_publickey' => ['string', 'keypair'=>'string'], 'Sodium\crypto_sign_publickey_from_secretkey' => ['string', 'secretkey'=>'string'], 'Sodium\crypto_sign_secretkey' => ['string', 'keypair'=>'string'], 'Sodium\crypto_sign_seed_keypair' => ['string', 'seed'=>'string'], 'Sodium\crypto_sign_verify_detached' => ['bool', 'signature'=>'string', 'msg'=>'string', 'publickey'=>'string'], 'Sodium\crypto_stream' => ['string', 'length'=>'int', 'nonce'=>'string', 'key'=>'string'], 'Sodium\crypto_stream_xor' => ['string', 'plaintext'=>'string', 'nonce'=>'string', 'key'=>'string'], 'Sodium\hex2bin' => ['string', 'hex'=>'string'], 'Sodium\increment' => ['string', '&nonce'=>'string'], 'Sodium\library_version_major' => ['int'], 'Sodium\library_version_minor' => ['int'], 'Sodium\memcmp' => ['int', 'left'=>'string', 'right'=>'string'], 'Sodium\memzero' => ['', '&target'=>'string'], 'Sodium\randombytes_buf' => ['string', 'length'=>'int'], 'Sodium\randombytes_random16' => ['int|string'], 'Sodium\randombytes_uniform' => ['int', 'upperBoundNonInclusive'=>'int'], 'Sodium\version_string' => ['string'], 'sodium_add' => ['string', 'string_1'=>'string', 'string_2'=>'string'], 'sodium_base642bin' => ['string', 'base64'=>'string', 'variant'=>'int', 'ignore='=>'string'], 'sodium_bin2base64' => ['string', 'binary'=>'string', 'variant'=>'int'], 'sodium_bin2hex' => ['string', 'binary'=>'string'], 'sodium_compare' => ['int', 'string_1'=>'string', 'string_2'=>'string'], 'sodium_crypto_aead_aes256gcm_decrypt' => ['string|false', 'confidential_message'=>'string', 'public_message'=>'string', 'nonce'=>'string', 'key'=>'string'], 'sodium_crypto_aead_aes256gcm_encrypt' => ['string', 'confidential_message'=>'string', 'public_message'=>'string', 'nonce'=>'string', 'key'=>'string'], 'sodium_crypto_aead_aes256gcm_is_available' => ['bool'], 'sodium_crypto_aead_aes256gcm_keygen' => ['string'], 'sodium_crypto_aead_chacha20poly1305_decrypt' => ['string|false', 'confidential_message'=>'string', 'public_message'=>'string', 'nonce'=>'string', 'key'=>'string'], 'sodium_crypto_aead_chacha20poly1305_encrypt' => ['string', 'confidential_message'=>'string', 'public_message'=>'string', 'nonce'=>'string', 'key'=>'string'], 'sodium_crypto_aead_chacha20poly1305_ietf_decrypt' => ['string|false', 'confidential_message'=>'string', 'public_message'=>'string', 'nonce'=>'string', 'key'=>'string'], 'sodium_crypto_aead_chacha20poly1305_ietf_encrypt' => ['string', 'confidential_message'=>'string', 'public_message'=>'string', 'nonce'=>'string', 'key'=>'string'], 'sodium_crypto_aead_chacha20poly1305_ietf_keygen' => ['string'], 'sodium_crypto_aead_chacha20poly1305_keygen' => ['string'], 'sodium_crypto_aead_xchacha20poly1305_ietf_decrypt' => ['string|false', 'confidential_message'=>'string', 'public_message'=>'string', 'nonce'=>'string', 'key'=>'string'], 'sodium_crypto_aead_xchacha20poly1305_ietf_encrypt' => ['string', 'confidential_message'=>'string', 'public_message'=>'string', 'nonce'=>'string', 'key'=>'string'], 'sodium_crypto_aead_xchacha20poly1305_ietf_keygen' => ['string'], 'sodium_crypto_auth' => ['string', 'message'=>'string', 'key'=>'string'], 'sodium_crypto_auth_keygen' => ['string'], 'sodium_crypto_auth_verify' => ['bool', 'mac'=>'string', 'message'=>'string', 'key'=>'string'], 'sodium_crypto_box' => ['string', 'string'=>'string', 'nonce'=>'string', 'key'=>'string'], 'sodium_crypto_box_keypair' => ['string'], 'sodium_crypto_box_keypair_from_secretkey_and_publickey' => ['string', 'secret_key'=>'string', 'public_key'=>'string'], 'sodium_crypto_box_open' => ['string|false', 'message'=>'string', 'nonce'=>'string', 'message_keypair'=>'string'], 'sodium_crypto_box_publickey' => ['string', 'keypair'=>'string'], 'sodium_crypto_box_publickey_from_secretkey' => ['string', 'secretkey'=>'string'], 'sodium_crypto_box_seal' => ['string', 'message'=>'string', 'publickey'=>'string'], 'sodium_crypto_box_seal_open' => ['string|false', 'message'=>'string', 'recipient_keypair'=>'string'], 'sodium_crypto_box_secretkey' => ['string', 'keypair'=>'string'], 'sodium_crypto_box_seed_keypair' => ['string', 'seed'=>'string'], 'sodium_crypto_generichash' => ['non-empty-string', 'msg'=>'string', 'key='=>'?string', 'length='=>'?int'], 'sodium_crypto_generichash_final' => ['non-empty-string', 'state'=>'non-empty-string', 'length='=>'?int'], 'sodium_crypto_generichash_init' => ['non-empty-string', 'key='=>'?string', 'length='=>'?int'], 'sodium_crypto_generichash_keygen' => ['non-empty-string'], 'sodium_crypto_generichash_update' => ['bool', 'state'=>'non-empty-string', 'string'=>'string'], 'sodium_crypto_kdf_derive_from_key' => ['string', 'subkey_len'=>'int', 'subkey_id'=>'int', 'context'=>'string', 'key'=>'string'], 'sodium_crypto_kdf_keygen' => ['string'], 'sodium_crypto_kx' => ['string', 'secretkey'=>'string', 'publickey'=>'string', 'client_publickey'=>'string', 'server_publickey'=>'string'], 'sodium_crypto_kx_client_session_keys' => ['array<int,string>', 'client_keypair'=>'string', 'server_key'=>'string'], 'sodium_crypto_kx_keypair' => ['string'], 'sodium_crypto_kx_publickey' => ['string', 'keypair'=>'string'], 'sodium_crypto_kx_secretkey' => ['string', 'keypair'=>'string'], 'sodium_crypto_kx_seed_keypair' => ['string', 'seed'=>'string'], 'sodium_crypto_kx_server_session_keys' => ['array<int,string>', 'server_keypair'=>'string', 'client_key'=>'string'], 'sodium_crypto_pwhash' => ['string', 'length'=>'int', 'password'=>'string', 'salt'=>'string', 'opslimit'=>'int', 'memlimit'=>'int', 'alg='=>'int'], 'sodium_crypto_pwhash_scryptsalsa208sha256' => ['string', 'length'=>'int', 'password'=>'string', 'salt'=>'string', 'opslimit'=>'int', 'memlimit'=>'int'], 'sodium_crypto_pwhash_scryptsalsa208sha256_str' => ['string', 'password'=>'string', 'opslimit'=>'int', 'memlimit'=>'int'], 'sodium_crypto_pwhash_scryptsalsa208sha256_str_verify' => ['bool', 'hash'=>'string', 'password'=>'string'], 'sodium_crypto_pwhash_str' => ['string', 'password'=>'string', 'opslimit'=>'int', 'memlimit'=>'int'], 'sodium_crypto_pwhash_str_needs_rehash' => ['bool', 'password'=>'string', 'opslimit'=>'int', 'memlimit'=>'int'], 'sodium_crypto_pwhash_str_verify' => ['bool', 'hash'=>'string', 'password'=>'string'], 'sodium_crypto_scalarmult' => ['string', 'string_1'=>'string', 'string_2'=>'string'], 'sodium_crypto_scalarmult_base' => ['string', 'key'=>'string'], 'sodium_crypto_secretbox' => ['string', 'plaintext'=>'string', 'nonce'=>'string', 'key'=>'string'], 'sodium_crypto_secretbox_keygen' => ['string'], 'sodium_crypto_secretbox_open' => ['string|false', 'ciphertext'=>'string', 'nonce'=>'string', 'key'=>'string'], 'sodium_crypto_secretstream_xchacha20poly1305_init_pull' => ['string', 'header'=>'string', 'key'=>'string'], 'sodium_crypto_secretstream_xchacha20poly1305_init_push' => ['array', 'key'=>'string'], 'sodium_crypto_secretstream_xchacha20poly1305_keygen' => ['string'], 'sodium_crypto_secretstream_xchacha20poly1305_pull' => ['array|false', 'state'=>'string', 'c'=>'string', 'ad='=>'string'], 'sodium_crypto_secretstream_xchacha20poly1305_push' => ['string', 'state'=>'string', 'msg'=>'string', 'ad='=>'string', 'tag='=>'int'], 'sodium_crypto_secretstream_xchacha20poly1305_rekey' => ['void', 'state'=>'string'], 'sodium_crypto_shorthash' => ['string', 'message'=>'string', 'key'=>'string'], 'sodium_crypto_shorthash_keygen' => ['string'], 'sodium_crypto_sign' => ['non-empty-string', 'message'=>'string', 'secretkey'=>'non-empty-string'], 'sodium_crypto_sign_detached' => ['non-empty-string', 'message'=>'string', 'secretkey'=>'non-empty-string'], 'sodium_crypto_sign_ed25519_pk_to_curve25519' => ['non-empty-string', 'ed25519pk'=>'non-empty-string'], 'sodium_crypto_sign_ed25519_sk_to_curve25519' => ['non-empty-string', 'ed25519sk'=>'non-empty-string'], 'sodium_crypto_sign_keypair' => ['non-empty-string'], 'sodium_crypto_sign_keypair_from_secretkey_and_publickey' => ['non-empty-string', 'secret_key'=>'non-empty-string', 'public_key'=>'non-empty-string'], 'sodium_crypto_sign_open' => ['string|false', 'message'=>'string', 'publickey'=>'non-empty-string'], 'sodium_crypto_sign_publickey' => ['non-empty-string', 'keypair'=>'non-empty-string'], 'sodium_crypto_sign_publickey_from_secretkey' => ['non-empty-string', 'secretkey'=>'non-empty-string'], 'sodium_crypto_sign_secretkey' => ['non-empty-string', 'keypair'=>'non-empty-string'], 'sodium_crypto_sign_seed_keypair' => ['non-empty-string', 'seed'=>'non-empty-string'], 'sodium_crypto_sign_verify_detached' => ['bool', 'signature'=>'non-empty-string', 'message'=>'string', 'publickey'=>'non-empty-string'], 'sodium_crypto_stream' => ['string', 'length'=>'int', 'nonce'=>'string', 'key'=>'string'], 'sodium_crypto_stream_keygen' => ['string'], 'sodium_crypto_stream_xor' => ['string', 'message'=>'string', 'nonce'=>'string', 'key'=>'string'], 'sodium_hex2bin' => ['string', 'hex'=>'string', 'ignore='=>'string'], 'sodium_increment' => ['string', '&binary_string'=>'string'], 'sodium_library_version_major' => ['int'], 'sodium_library_version_minor' => ['int'], 'sodium_memcmp' => ['int', 'string_1'=>'string', 'string_2'=>'string'], 'sodium_memzero' => ['void', '&secret'=>'string'], 'sodium_pad' => ['string', 'unpadded'=>'string', 'length'=>'int'], 'sodium_randombytes_buf' => ['string', 'length'=>'int'], 'sodium_randombytes_random16' => ['int|string'], 'sodium_randombytes_uniform' => ['int', 'upperBoundNonInclusive'=>'int'], 'sodium_unpad' => ['string', 'padded'=>'string', 'length'=>'int'], 'sodium_version_string' => ['string'], 'solid_fetch_prev' => ['bool', 'result_id'=>''], 'solr_get_version' => ['string'], 'SolrClient::__construct' => ['void', 'clientOptions'=>'array'], 'SolrClient::__destruct' => [''], 'SolrClient::addDocument' => ['SolrUpdateResponse', 'doc'=>'solrinputdocument', 'allowdups='=>'bool', 'commitwithin='=>'int'], 'SolrClient::addDocuments' => ['SolrUpdateResponse', 'docs'=>'array', 'allowdups='=>'bool', 'commitwithin='=>'int'], 'SolrClient::commit' => ['SolrUpdateResponse', 'maxsegments='=>'int', 'waitflush='=>'bool', 'waitsearcher='=>'bool'], 'SolrClient::deleteById' => ['SolrUpdateResponse', 'id'=>'string'], 'SolrClient::deleteByIds' => ['SolrUpdateResponse', 'ids'=>'array'], 'SolrClient::deleteByQueries' => ['SolrUpdateResponse', 'queries'=>'array'], 'SolrClient::deleteByQuery' => ['SolrUpdateResponse', 'query'=>'string'], 'SolrClient::getById' => ['SolrQueryResponse', 'id'=>'string'], 'SolrClient::getByIds' => ['SolrQueryResponse', 'ids'=>'array'], 'SolrClient::getDebug' => ['string'], 'SolrClient::getOptions' => ['array'], 'SolrClient::optimize' => ['SolrUpdateResponse', 'maxsegments='=>'int', 'waitflush='=>'bool', 'waitsearcher='=>'bool'], 'SolrClient::ping' => ['SolrPingResponse'], 'SolrClient::query' => ['SolrQueryResponse', 'query'=>'solrparams'], 'SolrClient::request' => ['SolrUpdateResponse', 'raw_request'=>'string'], 'SolrClient::rollback' => ['SolrUpdateResponse'], 'SolrClient::setResponseWriter' => ['void', 'responsewriter'=>'string'], 'SolrClient::setServlet' => ['bool', 'type'=>'int', 'value'=>'string'], 'SolrClient::system' => ['void'], 'SolrClient::threads' => ['void'], 'SolrClientException::getInternalInfo' => ['array'], 'SolrCollapseFunction::__toString' => ['string'], 'SolrCollapseFunction::getField' => ['string'], 'SolrCollapseFunction::getHint' => ['string'], 'SolrCollapseFunction::getMax' => ['string'], 'SolrCollapseFunction::getMin' => ['string'], 'SolrCollapseFunction::getNullPolicy' => ['string'], 'SolrCollapseFunction::getSize' => ['int'], 'SolrCollapseFunction::setField' => ['SolrCollapseFunction', 'fieldName'=>'string'], 'SolrCollapseFunction::setHint' => ['SolrCollapseFunction', 'hint'=>'string'], 'SolrCollapseFunction::setMax' => ['SolrCollapseFunction', 'max'=>'string'], 'SolrCollapseFunction::setMin' => ['SolrCollapseFunction', 'min'=>'string'], 'SolrCollapseFunction::setNullPolicy' => ['SolrCollapseFunction', 'nullPolicy'=>'string'], 'SolrCollapseFunction::setSize' => ['SolrCollapseFunction', 'size'=>'int'], 'SolrDisMaxQuery::__construct' => ['void', 'q='=>'string'], 'SolrDisMaxQuery::addBigramPhraseField' => ['SolrDisMaxQuery', 'field'=>'string', 'boost'=>'string', 'slop='=>'string'], 'SolrDisMaxQuery::addBoostQuery' => ['SolrDisMaxQuery', 'field'=>'string', 'value'=>'string', 'boost='=>'string'], 'SolrDisMaxQuery::addExpandFilterQuery' => ['SolrQuery', 'fq'=>'string'], 'SolrDisMaxQuery::addExpandSortField' => ['SolrQuery', 'field'=>'string', 'order'=>'string'], 'SolrDisMaxQuery::addFacetDateField' => ['SolrQuery', 'dateField'=>'string'], 'SolrDisMaxQuery::addFacetDateOther' => ['SolrQuery', 'value'=>'string', 'field_override'=>'string'], 'SolrDisMaxQuery::addFacetField' => ['SolrQuery', 'field'=>'string'], 'SolrDisMaxQuery::addFacetQuery' => ['SolrQuery', 'facetQuery'=>'string'], 'SolrDisMaxQuery::addField' => ['SolrQuery', 'field'=>'string'], 'SolrDisMaxQuery::addFilterQuery' => ['SolrQuery', 'fq'=>'string'], 'SolrDisMaxQuery::addGroupField' => ['SolrQuery', 'value'=>'string'], 'SolrDisMaxQuery::addGroupFunction' => ['SolrQuery', 'value'=>'string'], 'SolrDisMaxQuery::addGroupQuery' => ['SolrQuery', 'value'=>'string'], 'SolrDisMaxQuery::addGroupSortField' => ['SolrQuery', 'field'=>'string', 'order'=>'int'], 'SolrDisMaxQuery::addHighlightField' => ['SolrQuery', 'field'=>'string'], 'SolrDisMaxQuery::addMltField' => ['SolrQuery', 'field'=>'string'], 'SolrDisMaxQuery::addMltQueryField' => ['SolrQuery', 'field'=>'string', 'boost'=>'float'], 'SolrDisMaxQuery::addParam' => ['SolrParams', 'name'=>'string', 'value'=>'string'], 'SolrDisMaxQuery::addPhraseField' => ['SolrDisMaxQuery', 'field'=>'string', 'boost'=>'string', 'slop='=>'string'], 'SolrDisMaxQuery::addQueryField' => ['SolrDisMaxQuery', 'field'=>'string', 'boost='=>'string'], 'SolrDisMaxQuery::addSortField' => ['SolrQuery', 'field'=>'string', 'order='=>'int'], 'SolrDisMaxQuery::addStatsFacet' => ['SolrQuery', 'field'=>'string'], 'SolrDisMaxQuery::addStatsField' => ['SolrQuery', 'field'=>'string'], 'SolrDisMaxQuery::addTrigramPhraseField' => ['SolrDisMaxQuery', 'field'=>'string', 'boost'=>'string', 'slop='=>'string'], 'SolrDisMaxQuery::addUserField' => ['SolrDisMaxQuery', 'field'=>'string'], 'SolrDisMaxQuery::collapse' => ['SolrQuery', 'collapseFunction'=>'SolrCollapseFunction'], 'SolrDisMaxQuery::get' => ['mixed', 'param_name'=>'string'], 'SolrDisMaxQuery::getExpand' => ['bool'], 'SolrDisMaxQuery::getExpandFilterQueries' => ['array'], 'SolrDisMaxQuery::getExpandQuery' => ['array'], 'SolrDisMaxQuery::getExpandRows' => ['int'], 'SolrDisMaxQuery::getExpandSortFields' => ['array'], 'SolrDisMaxQuery::getFacet' => ['bool'], 'SolrDisMaxQuery::getFacetDateEnd' => ['string', 'field_override'=>'string'], 'SolrDisMaxQuery::getFacetDateFields' => ['array'], 'SolrDisMaxQuery::getFacetDateGap' => ['string', 'field_override'=>'string'], 'SolrDisMaxQuery::getFacetDateHardEnd' => ['string', 'field_override'=>'string'], 'SolrDisMaxQuery::getFacetDateOther' => ['string', 'field_override'=>'string'], 'SolrDisMaxQuery::getFacetDateStart' => ['string', 'field_override'=>'string'], 'SolrDisMaxQuery::getFacetFields' => ['array'], 'SolrDisMaxQuery::getFacetLimit' => ['int', 'field_override'=>'string'], 'SolrDisMaxQuery::getFacetMethod' => ['string', 'field_override'=>'string'], 'SolrDisMaxQuery::getFacetMinCount' => ['int', 'field_override'=>'string'], 'SolrDisMaxQuery::getFacetMissing' => ['string', 'field_override'=>'string'], 'SolrDisMaxQuery::getFacetOffset' => ['int', 'field_override'=>'string'], 'SolrDisMaxQuery::getFacetPrefix' => ['string', 'field_override'=>'string'], 'SolrDisMaxQuery::getFacetQueries' => ['string'], 'SolrDisMaxQuery::getFacetSort' => ['int', 'field_override'=>'string'], 'SolrDisMaxQuery::getFields' => ['string'], 'SolrDisMaxQuery::getFilterQueries' => ['string'], 'SolrDisMaxQuery::getGroup' => ['bool'], 'SolrDisMaxQuery::getGroupCachePercent' => ['int'], 'SolrDisMaxQuery::getGroupFacet' => ['bool'], 'SolrDisMaxQuery::getGroupFields' => ['array'], 'SolrDisMaxQuery::getGroupFormat' => ['string'], 'SolrDisMaxQuery::getGroupFunctions' => ['array'], 'SolrDisMaxQuery::getGroupLimit' => ['int'], 'SolrDisMaxQuery::getGroupMain' => ['bool'], 'SolrDisMaxQuery::getGroupNGroups' => ['bool'], 'SolrDisMaxQuery::getGroupOffset' => ['bool'], 'SolrDisMaxQuery::getGroupQueries' => ['array'], 'SolrDisMaxQuery::getGroupSortFields' => ['array'], 'SolrDisMaxQuery::getGroupTruncate' => ['bool'], 'SolrDisMaxQuery::getHighlight' => ['bool'], 'SolrDisMaxQuery::getHighlightAlternateField' => ['string', 'field_override'=>'string'], 'SolrDisMaxQuery::getHighlightFields' => ['array'], 'SolrDisMaxQuery::getHighlightFormatter' => ['string', 'field_override'=>'string'], 'SolrDisMaxQuery::getHighlightFragmenter' => ['string', 'field_override'=>'string'], 'SolrDisMaxQuery::getHighlightFragsize' => ['int', 'field_override'=>'string'], 'SolrDisMaxQuery::getHighlightHighlightMultiTerm' => ['bool'], 'SolrDisMaxQuery::getHighlightMaxAlternateFieldLength' => ['int', 'field_override'=>'string'], 'SolrDisMaxQuery::getHighlightMaxAnalyzedChars' => ['int'], 'SolrDisMaxQuery::getHighlightMergeContiguous' => ['bool', 'field_override'=>'string'], 'SolrDisMaxQuery::getHighlightRegexMaxAnalyzedChars' => ['int'], 'SolrDisMaxQuery::getHighlightRegexPattern' => ['string'], 'SolrDisMaxQuery::getHighlightRegexSlop' => ['float'], 'SolrDisMaxQuery::getHighlightRequireFieldMatch' => ['bool'], 'SolrDisMaxQuery::getHighlightSimplePost' => ['string', 'field_override'=>'string'], 'SolrDisMaxQuery::getHighlightSimplePre' => ['string', 'field_override'=>'string'], 'SolrDisMaxQuery::getHighlightSnippets' => ['int', 'field_override'=>'string'], 'SolrDisMaxQuery::getHighlightUsePhraseHighlighter' => ['bool'], 'SolrDisMaxQuery::getMlt' => ['bool'], 'SolrDisMaxQuery::getMltBoost' => ['bool'], 'SolrDisMaxQuery::getMltCount' => ['int'], 'SolrDisMaxQuery::getMltFields' => ['array'], 'SolrDisMaxQuery::getMltMaxNumQueryTerms' => ['int'], 'SolrDisMaxQuery::getMltMaxNumTokens' => ['int'], 'SolrDisMaxQuery::getMltMaxWordLength' => ['int'], 'SolrDisMaxQuery::getMltMinDocFrequency' => ['int'], 'SolrDisMaxQuery::getMltMinTermFrequency' => ['int'], 'SolrDisMaxQuery::getMltMinWordLength' => ['int'], 'SolrDisMaxQuery::getMltQueryFields' => ['array'], 'SolrDisMaxQuery::getParam' => ['mixed', 'param_name'=>'string'], 'SolrDisMaxQuery::getParams' => ['array'], 'SolrDisMaxQuery::getPreparedParams' => ['array'], 'SolrDisMaxQuery::getQuery' => ['string'], 'SolrDisMaxQuery::getRows' => ['int'], 'SolrDisMaxQuery::getSortFields' => ['array'], 'SolrDisMaxQuery::getStart' => ['int'], 'SolrDisMaxQuery::getStats' => ['bool'], 'SolrDisMaxQuery::getStatsFacets' => ['array'], 'SolrDisMaxQuery::getStatsFields' => ['array'], 'SolrDisMaxQuery::getTerms' => ['bool'], 'SolrDisMaxQuery::getTermsField' => ['string'], 'SolrDisMaxQuery::getTermsIncludeLowerBound' => ['bool'], 'SolrDisMaxQuery::getTermsIncludeUpperBound' => ['bool'], 'SolrDisMaxQuery::getTermsLimit' => ['int'], 'SolrDisMaxQuery::getTermsLowerBound' => ['string'], 'SolrDisMaxQuery::getTermsMaxCount' => ['int'], 'SolrDisMaxQuery::getTermsMinCount' => ['int'], 'SolrDisMaxQuery::getTermsPrefix' => ['string'], 'SolrDisMaxQuery::getTermsReturnRaw' => ['bool'], 'SolrDisMaxQuery::getTermsSort' => ['int'], 'SolrDisMaxQuery::getTermsUpperBound' => ['string'], 'SolrDisMaxQuery::getTimeAllowed' => ['int'], 'SolrDisMaxQuery::removeBigramPhraseField' => ['SolrDisMaxQuery', 'field'=>'string'], 'SolrDisMaxQuery::removeBoostQuery' => ['SolrDisMaxQuery', 'field'=>'string'], 'SolrDisMaxQuery::removeExpandFilterQuery' => ['SolrQuery', 'fq'=>'string'], 'SolrDisMaxQuery::removeExpandSortField' => ['SolrQuery', 'field'=>'string'], 'SolrDisMaxQuery::removeFacetDateField' => ['SolrQuery', 'field'=>'string'], 'SolrDisMaxQuery::removeFacetDateOther' => ['SolrQuery', 'value'=>'string', 'field_override'=>'string'], 'SolrDisMaxQuery::removeFacetField' => ['SolrQuery', 'field'=>'string'], 'SolrDisMaxQuery::removeFacetQuery' => ['SolrQuery', 'value'=>'string'], 'SolrDisMaxQuery::removeField' => ['SolrQuery', 'field'=>'string'], 'SolrDisMaxQuery::removeFilterQuery' => ['SolrQuery', 'fq'=>'string'], 'SolrDisMaxQuery::removeHighlightField' => ['SolrQuery', 'field'=>'string'], 'SolrDisMaxQuery::removeMltField' => ['SolrQuery', 'field'=>'string'], 'SolrDisMaxQuery::removeMltQueryField' => ['SolrQuery', 'queryField'=>'string'], 'SolrDisMaxQuery::removePhraseField' => ['SolrDisMaxQuery', 'field'=>'string'], 'SolrDisMaxQuery::removeQueryField' => ['SolrDisMaxQuery', 'field'=>'string'], 'SolrDisMaxQuery::removeSortField' => ['SolrQuery', 'field'=>'string'], 'SolrDisMaxQuery::removeStatsFacet' => ['SolrQuery', 'value'=>'string'], 'SolrDisMaxQuery::removeStatsField' => ['SolrQuery', 'field'=>'string'], 'SolrDisMaxQuery::removeTrigramPhraseField' => ['SolrDisMaxQuery', 'field'=>'string'], 'SolrDisMaxQuery::removeUserField' => ['SolrDisMaxQuery', 'field'=>'string'], 'SolrDisMaxQuery::serialize' => ['string'], 'SolrDisMaxQuery::set' => ['SolrParams', 'name'=>'string', 'value'=>''], 'SolrDisMaxQuery::setBigramPhraseFields' => ['SolrDisMaxQuery', 'fields'=>'string'], 'SolrDisMaxQuery::setBigramPhraseSlop' => ['SolrDisMaxQuery', 'slop'=>'string'], 'SolrDisMaxQuery::setBoostFunction' => ['SolrDisMaxQuery', 'function'=>'string'], 'SolrDisMaxQuery::setBoostQuery' => ['SolrDisMaxQuery', 'q'=>'string'], 'SolrDisMaxQuery::setEchoHandler' => ['SolrQuery', 'flag'=>'bool'], 'SolrDisMaxQuery::setEchoParams' => ['SolrQuery', 'type'=>'string'], 'SolrDisMaxQuery::setExpand' => ['SolrQuery', 'value'=>'bool'], 'SolrDisMaxQuery::setExpandQuery' => ['SolrQuery', 'q'=>'string'], 'SolrDisMaxQuery::setExpandRows' => ['SolrQuery', 'value'=>'int'], 'SolrDisMaxQuery::setExplainOther' => ['SolrQuery', 'query'=>'string'], 'SolrDisMaxQuery::setFacet' => ['SolrQuery', 'flag'=>'bool'], 'SolrDisMaxQuery::setFacetDateEnd' => ['SolrQuery', 'value'=>'string', 'field_override'=>'string'], 'SolrDisMaxQuery::setFacetDateGap' => ['SolrQuery', 'value'=>'string', 'field_override'=>'string'], 'SolrDisMaxQuery::setFacetDateHardEnd' => ['SolrQuery', 'value'=>'string', 'field_override'=>'string'], 'SolrDisMaxQuery::setFacetDateStart' => ['SolrQuery', 'value'=>'string', 'field_override'=>'string'], 'SolrDisMaxQuery::setFacetEnumCacheMinDefaultFrequency' => ['SolrQuery', 'frequency'=>'int', 'field_override'=>'string'], 'SolrDisMaxQuery::setFacetLimit' => ['SolrQuery', 'limit'=>'int', 'field_override'=>'string'], 'SolrDisMaxQuery::setFacetMethod' => ['SolrQuery', 'method'=>'string', 'field_override'=>'string'], 'SolrDisMaxQuery::setFacetMinCount' => ['SolrQuery', 'mincount'=>'int', 'field_override'=>'string'], 'SolrDisMaxQuery::setFacetMissing' => ['SolrQuery', 'flag'=>'bool', 'field_override'=>'string'], 'SolrDisMaxQuery::setFacetOffset' => ['SolrQuery', 'offset'=>'int', 'field_override'=>'string'], 'SolrDisMaxQuery::setFacetPrefix' => ['SolrQuery', 'prefix'=>'string', 'field_override'=>'string'], 'SolrDisMaxQuery::setFacetSort' => ['SolrQuery', 'facetSort'=>'int', 'field_override'=>'string'], 'SolrDisMaxQuery::setGroup' => ['SolrQuery', 'value'=>'bool'], 'SolrDisMaxQuery::setGroupCachePercent' => ['SolrQuery', 'percent'=>'int'], 'SolrDisMaxQuery::setGroupFacet' => ['SolrQuery', 'value'=>'bool'], 'SolrDisMaxQuery::setGroupFormat' => ['SolrQuery', 'value'=>'string'], 'SolrDisMaxQuery::setGroupLimit' => ['SolrQuery', 'value'=>'int'], 'SolrDisMaxQuery::setGroupMain' => ['SolrQuery', 'value'=>'string'], 'SolrDisMaxQuery::setGroupNGroups' => ['SolrQuery', 'value'=>'bool'], 'SolrDisMaxQuery::setGroupOffset' => ['SolrQuery', 'value'=>'int'], 'SolrDisMaxQuery::setGroupTruncate' => ['SolrQuery', 'value'=>'bool'], 'SolrDisMaxQuery::setHighlight' => ['SolrQuery', 'flag'=>'bool'], 'SolrDisMaxQuery::setHighlightAlternateField' => ['SolrQuery', 'field'=>'string', 'field_override'=>'string'], 'SolrDisMaxQuery::setHighlightFormatter' => ['SolrQuery', 'formatter'=>'string', 'field_override'=>'string'], 'SolrDisMaxQuery::setHighlightFragmenter' => ['SolrQuery', 'fragmenter'=>'string', 'field_override'=>'string'], 'SolrDisMaxQuery::setHighlightFragsize' => ['SolrQuery', 'size'=>'int', 'field_override'=>'string'], 'SolrDisMaxQuery::setHighlightHighlightMultiTerm' => ['SolrQuery', 'flag'=>'bool'], 'SolrDisMaxQuery::setHighlightMaxAlternateFieldLength' => ['SolrQuery', 'fieldLength'=>'string', 'field_override'=>'string'], 'SolrDisMaxQuery::setHighlightMaxAnalyzedChars' => ['SolrQuery', 'value'=>'int'], 'SolrDisMaxQuery::setHighlightMergeContiguous' => ['SolrQuery', 'flag'=>'bool', 'field_override'=>'string'], 'SolrDisMaxQuery::setHighlightRegexMaxAnalyzedChars' => ['SolrQuery', 'maxAnalyzedChars'=>'int'], 'SolrDisMaxQuery::setHighlightRegexPattern' => ['SolrQuery', 'value'=>'string'], 'SolrDisMaxQuery::setHighlightRegexSlop' => ['SolrQuery', 'factor'=>'float'], 'SolrDisMaxQuery::setHighlightRequireFieldMatch' => ['SolrQuery', 'flag'=>'bool'], 'SolrDisMaxQuery::setHighlightSimplePost' => ['SolrQuery', 'simplePost'=>'string', 'field_override'=>'string'], 'SolrDisMaxQuery::setHighlightSimplePre' => ['SolrQuery', 'simplePre'=>'string', 'field_override'=>'string'], 'SolrDisMaxQuery::setHighlightSnippets' => ['SolrQuery', 'value'=>'int', 'field_override'=>'string'], 'SolrDisMaxQuery::setHighlightUsePhraseHighlighter' => ['SolrQuery', 'flag'=>'bool'], 'SolrDisMaxQuery::setMinimumMatch' => ['SolrDisMaxQuery', 'value'=>'string'], 'SolrDisMaxQuery::setMlt' => ['SolrQuery', 'flag'=>'bool'], 'SolrDisMaxQuery::setMltBoost' => ['SolrQuery', 'flag'=>'bool'], 'SolrDisMaxQuery::setMltCount' => ['SolrQuery', 'count'=>'int'], 'SolrDisMaxQuery::setMltMaxNumQueryTerms' => ['SolrQuery', 'value'=>'int'], 'SolrDisMaxQuery::setMltMaxNumTokens' => ['SolrQuery', 'value'=>'int'], 'SolrDisMaxQuery::setMltMaxWordLength' => ['SolrQuery', 'maxWordLength'=>'int'], 'SolrDisMaxQuery::setMltMinDocFrequency' => ['SolrQuery', 'minDocFrequency'=>'int'], 'SolrDisMaxQuery::setMltMinTermFrequency' => ['SolrQuery', 'minTermFrequency'=>'int'], 'SolrDisMaxQuery::setMltMinWordLength' => ['SolrQuery', 'minWordLength'=>'int'], 'SolrDisMaxQuery::setOmitHeader' => ['SolrQuery', 'flag'=>'bool'], 'SolrDisMaxQuery::setParam' => ['SolrParams', 'name'=>'string', 'value'=>''], 'SolrDisMaxQuery::setPhraseFields' => ['SolrDisMaxQuery', 'fields'=>'string'], 'SolrDisMaxQuery::setPhraseSlop' => ['SolrDisMaxQuery', 'slop'=>'string'], 'SolrDisMaxQuery::setQuery' => ['SolrQuery', 'query'=>'string'], 'SolrDisMaxQuery::setQueryAlt' => ['SolrDisMaxQuery', 'q'=>'string'], 'SolrDisMaxQuery::setQueryPhraseSlop' => ['SolrDisMaxQuery', 'slop'=>'string'], 'SolrDisMaxQuery::setRows' => ['SolrQuery', 'rows'=>'int'], 'SolrDisMaxQuery::setShowDebugInfo' => ['SolrQuery', 'flag'=>'bool'], 'SolrDisMaxQuery::setStart' => ['SolrQuery', 'start'=>'int'], 'SolrDisMaxQuery::setStats' => ['SolrQuery', 'flag'=>'bool'], 'SolrDisMaxQuery::setTerms' => ['SolrQuery', 'flag'=>'bool'], 'SolrDisMaxQuery::setTermsField' => ['SolrQuery', 'fieldname'=>'string'], 'SolrDisMaxQuery::setTermsIncludeLowerBound' => ['SolrQuery', 'flag'=>'bool'], 'SolrDisMaxQuery::setTermsIncludeUpperBound' => ['SolrQuery', 'flag'=>'bool'], 'SolrDisMaxQuery::setTermsLimit' => ['SolrQuery', 'limit'=>'int'], 'SolrDisMaxQuery::setTermsLowerBound' => ['SolrQuery', 'lowerBound'=>'string'], 'SolrDisMaxQuery::setTermsMaxCount' => ['SolrQuery', 'frequency'=>'int'], 'SolrDisMaxQuery::setTermsMinCount' => ['SolrQuery', 'frequency'=>'int'], 'SolrDisMaxQuery::setTermsPrefix' => ['SolrQuery', 'prefix'=>'string'], 'SolrDisMaxQuery::setTermsReturnRaw' => ['SolrQuery', 'flag'=>'bool'], 'SolrDisMaxQuery::setTermsSort' => ['SolrQuery', 'sortType'=>'int'], 'SolrDisMaxQuery::setTermsUpperBound' => ['SolrQuery', 'upperBound'=>'string'], 'SolrDisMaxQuery::setTieBreaker' => ['SolrDisMaxQuery', 'tieBreaker'=>'string'], 'SolrDisMaxQuery::setTimeAllowed' => ['SolrQuery', 'timeAllowed'=>'int'], 'SolrDisMaxQuery::setTrigramPhraseFields' => ['SolrDisMaxQuery', 'fields'=>'string'], 'SolrDisMaxQuery::setTrigramPhraseSlop' => ['SolrDisMaxQuery', 'slop'=>'string'], 'SolrDisMaxQuery::setUserFields' => ['SolrDisMaxQuery', 'fields'=>'string'], 'SolrDisMaxQuery::toString' => ['string', 'url_encode='=>'bool|false'], 'SolrDisMaxQuery::unserialize' => ['void', 'serialized'=>'string'], 'SolrDisMaxQuery::useDisMaxQueryParser' => ['SolrDisMaxQuery'], 'SolrDisMaxQuery::useEDisMaxQueryParser' => ['SolrDisMaxQuery'], 'SolrDocument::__clone' => ['void'], 'SolrDocument::__construct' => ['void'], 'SolrDocument::__destruct' => [''], 'SolrDocument::__get' => ['SolrDocumentField', 'fieldname'=>'string'], 'SolrDocument::__isset' => ['bool', 'fieldname'=>'string'], 'SolrDocument::__set' => ['bool', 'fieldname'=>'string', 'fieldvalue'=>'string'], 'SolrDocument::__unset' => ['bool', 'fieldname'=>'string'], 'SolrDocument::addField' => ['bool', 'fieldname'=>'string', 'fieldvalue'=>'string'], 'SolrDocument::clear' => ['bool'], 'SolrDocument::current' => ['SolrDocumentField'], 'SolrDocument::deleteField' => ['bool', 'fieldname'=>'string'], 'SolrDocument::fieldExists' => ['bool', 'fieldname'=>'string'], 'SolrDocument::getChildDocuments' => ['array'], 'SolrDocument::getChildDocumentsCount' => ['int'], 'SolrDocument::getField' => ['SolrDocumentField', 'fieldname'=>'string'], 'SolrDocument::getFieldCount' => ['int'], 'SolrDocument::getFieldNames' => ['array'], 'SolrDocument::getInputDocument' => ['SolrInputDocument'], 'SolrDocument::hasChildDocuments' => ['bool'], 'SolrDocument::key' => ['string'], 'SolrDocument::merge' => ['bool', 'sourcedoc'=>'solrdocument', 'overwrite='=>'bool'], 'SolrDocument::next' => ['void'], 'SolrDocument::offsetExists' => ['bool', 'fieldname'=>'string'], 'SolrDocument::offsetGet' => ['SolrDocumentField', 'fieldname'=>'string'], 'SolrDocument::offsetSet' => ['void', 'fieldname'=>'string', 'fieldvalue'=>'string'], 'SolrDocument::offsetUnset' => ['void', 'fieldname'=>'string'], 'SolrDocument::reset' => ['bool'], 'SolrDocument::rewind' => ['void'], 'SolrDocument::serialize' => ['string'], 'SolrDocument::sort' => ['bool', 'sortorderby'=>'int', 'sortdirection='=>'int'], 'SolrDocument::toArray' => ['array'], 'SolrDocument::unserialize' => ['void', 'serialized'=>'string'], 'SolrDocument::valid' => ['bool'], 'SolrDocumentField::__construct' => ['void'], 'SolrDocumentField::__destruct' => [''], 'SolrException::__clone' => ['void'], 'SolrException::__construct' => ['void', 'message='=>'string', 'code='=>'int', 'previous='=>'(?Exception)|(?Throwable)'], 'SolrException::__toString' => ['string'], 'SolrException::__wakeup' => ['void'], 'SolrException::getCode' => ['int'], 'SolrException::getFile' => ['string'], 'SolrException::getInternalInfo' => ['array'], 'SolrException::getLine' => ['int'], 'SolrException::getMessage' => ['string'], 'SolrException::getPrevious' => ['Exception|Throwable'], 'SolrException::getTrace' => ['list<array{function:string,line?:int,file?:string,class?:class-string,type?:\'::\'|\'->\',args?:mixed[],object?:object}>'], 'SolrException::getTraceAsString' => ['string'], 'SolrGenericResponse::__construct' => ['void'], 'SolrGenericResponse::__destruct' => [''], 'SolrGenericResponse::getDigestedResponse' => ['string'], 'SolrGenericResponse::getHttpStatus' => ['int'], 'SolrGenericResponse::getHttpStatusMessage' => ['string'], 'SolrGenericResponse::getRawRequest' => ['string'], 'SolrGenericResponse::getRawRequestHeaders' => ['string'], 'SolrGenericResponse::getRawResponse' => ['string'], 'SolrGenericResponse::getRawResponseHeaders' => ['string'], 'SolrGenericResponse::getRequestUrl' => ['string'], 'SolrGenericResponse::getResponse' => ['SolrObject'], 'SolrGenericResponse::setParseMode' => ['bool', 'parser_mode='=>'int'], 'SolrGenericResponse::success' => ['bool'], 'SolrIllegalArgumentException::__clone' => ['void'], 'SolrIllegalArgumentException::__construct' => ['void', 'message='=>'string', 'code='=>'int', 'previous='=>'(?Exception)|(?Throwable)'], 'SolrIllegalArgumentException::__toString' => ['string'], 'SolrIllegalArgumentException::__wakeup' => ['void'], 'SolrIllegalArgumentException::getCode' => ['int'], 'SolrIllegalArgumentException::getFile' => ['string'], 'SolrIllegalArgumentException::getInternalInfo' => ['array'], 'SolrIllegalArgumentException::getLine' => ['int'], 'SolrIllegalArgumentException::getMessage' => ['string'], 'SolrIllegalArgumentException::getPrevious' => ['Exception|Throwable'], 'SolrIllegalArgumentException::getTrace' => ['list<array{function:string,line?:int,file?:string,class?:class-string,type?:\'::\'|\'->\',args?:mixed[],object?:object}>'], 'SolrIllegalArgumentException::getTraceAsString' => ['string'], 'SolrIllegalOperationException::__clone' => ['void'], 'SolrIllegalOperationException::__construct' => ['void', 'message='=>'string', 'code='=>'int', 'previous='=>'(?Exception)|(?Throwable)'], 'SolrIllegalOperationException::__toString' => ['string'], 'SolrIllegalOperationException::__wakeup' => ['void'], 'SolrIllegalOperationException::getCode' => ['int'], 'SolrIllegalOperationException::getFile' => ['string'], 'SolrIllegalOperationException::getInternalInfo' => ['array'], 'SolrIllegalOperationException::getLine' => ['int'], 'SolrIllegalOperationException::getMessage' => ['string'], 'SolrIllegalOperationException::getPrevious' => ['Exception|Throwable'], 'SolrIllegalOperationException::getTrace' => ['list<array{function:string,line?:int,file?:string,class?:class-string,type?:\'::\'|\'->\',args?:mixed[],object?:object}>'], 'SolrIllegalOperationException::getTraceAsString' => ['string'], 'SolrInputDocument::__clone' => ['void'], 'SolrInputDocument::__construct' => ['void'], 'SolrInputDocument::__destruct' => [''], 'SolrInputDocument::addChildDocument' => ['void', 'child'=>'SolrInputDocument'], 'SolrInputDocument::addChildDocuments' => ['void', 'docs'=>'array'], 'SolrInputDocument::addField' => ['bool', 'fieldname'=>'string', 'fieldvalue'=>'string', 'fieldboostvalue='=>'float'], 'SolrInputDocument::clear' => ['bool'], 'SolrInputDocument::deleteField' => ['bool', 'fieldname'=>'string'], 'SolrInputDocument::fieldExists' => ['bool', 'fieldname'=>'string'], 'SolrInputDocument::getBoost' => ['float'], 'SolrInputDocument::getChildDocuments' => ['array'], 'SolrInputDocument::getChildDocumentsCount' => ['int'], 'SolrInputDocument::getField' => ['SolrDocumentField', 'fieldname'=>'string'], 'SolrInputDocument::getFieldBoost' => ['float', 'fieldname'=>'string'], 'SolrInputDocument::getFieldCount' => ['int'], 'SolrInputDocument::getFieldNames' => ['array'], 'SolrInputDocument::hasChildDocuments' => ['bool'], 'SolrInputDocument::merge' => ['bool', 'sourcedoc'=>'solrinputdocument', 'overwrite='=>'bool'], 'SolrInputDocument::reset' => ['bool'], 'SolrInputDocument::setBoost' => ['bool', 'documentboostvalue'=>'float'], 'SolrInputDocument::setFieldBoost' => ['bool', 'fieldname'=>'string', 'fieldboostvalue'=>'float'], 'SolrInputDocument::sort' => ['bool', 'sortorderby'=>'int', 'sortdirection='=>'int'], 'SolrInputDocument::toArray' => ['array'], 'SolrModifiableParams::__construct' => ['void'], 'SolrModifiableParams::__destruct' => [''], 'SolrModifiableParams::add' => ['SolrParams', 'name'=>'string', 'value'=>'string'], 'SolrModifiableParams::addParam' => ['SolrParams', 'name'=>'string', 'value'=>'string'], 'SolrModifiableParams::get' => ['mixed', 'param_name'=>'string'], 'SolrModifiableParams::getParam' => ['mixed', 'param_name'=>'string'], 'SolrModifiableParams::getParams' => ['array'], 'SolrModifiableParams::getPreparedParams' => ['array'], 'SolrModifiableParams::serialize' => ['string'], 'SolrModifiableParams::set' => ['SolrParams', 'name'=>'string', 'value'=>''], 'SolrModifiableParams::setParam' => ['SolrParams', 'name'=>'string', 'value'=>''], 'SolrModifiableParams::toString' => ['string', 'url_encode='=>'bool|false'], 'SolrModifiableParams::unserialize' => ['void', 'serialized'=>'string'], 'SolrObject::__construct' => ['void'], 'SolrObject::__destruct' => [''], 'SolrObject::getPropertyNames' => ['array'], 'SolrObject::offsetExists' => ['bool', 'property_name'=>'string'], 'SolrObject::offsetGet' => ['mixed', 'property_name'=>'string'], 'SolrObject::offsetSet' => ['void', 'property_name'=>'string', 'property_value'=>'string'], 'SolrObject::offsetUnset' => ['void', 'property_name'=>'string'], 'SolrParams::__construct' => ['void'], 'SolrParams::add' => ['SolrParams', 'name'=>'string', 'value'=>'string'], 'SolrParams::addParam' => ['SolrParams', 'name'=>'string', 'value'=>'string'], 'SolrParams::get' => ['mixed', 'param_name'=>'string'], 'SolrParams::getParam' => ['mixed', 'param_name='=>'string'], 'SolrParams::getParams' => ['array'], 'SolrParams::getPreparedParams' => ['array'], 'SolrParams::serialize' => ['string'], 'SolrParams::set' => ['void', 'name'=>'string', 'value'=>'string'], 'SolrParams::setParam' => ['SolrParams', 'name'=>'string', 'value'=>'string'], 'SolrParams::toString' => ['string', 'url_encode='=>'bool'], 'SolrParams::unserialize' => ['void', 'serialized'=>'string'], 'SolrPingResponse::__construct' => ['void'], 'SolrPingResponse::__destruct' => [''], 'SolrPingResponse::getDigestedResponse' => ['string'], 'SolrPingResponse::getHttpStatus' => ['int'], 'SolrPingResponse::getHttpStatusMessage' => ['string'], 'SolrPingResponse::getRawRequest' => ['string'], 'SolrPingResponse::getRawRequestHeaders' => ['string'], 'SolrPingResponse::getRawResponse' => ['string'], 'SolrPingResponse::getRawResponseHeaders' => ['string'], 'SolrPingResponse::getRequestUrl' => ['string'], 'SolrPingResponse::getResponse' => ['string'], 'SolrPingResponse::setParseMode' => ['bool', 'parser_mode='=>'int'], 'SolrPingResponse::success' => ['bool'], 'SolrQuery::__construct' => ['void', 'q='=>'string'], 'SolrQuery::__destruct' => [''], 'SolrQuery::add' => ['SolrParams', 'name'=>'string', 'value'=>'string'], 'SolrQuery::addExpandFilterQuery' => ['SolrQuery', 'fq'=>'string'], 'SolrQuery::addExpandSortField' => ['SolrQuery', 'field'=>'string', 'order='=>'string'], 'SolrQuery::addFacetDateField' => ['SolrQuery', 'datefield'=>'string'], 'SolrQuery::addFacetDateOther' => ['SolrQuery', 'value'=>'string', 'field_override='=>'string'], 'SolrQuery::addFacetField' => ['SolrQuery', 'field'=>'string'], 'SolrQuery::addFacetQuery' => ['SolrQuery', 'facetquery'=>'string'], 'SolrQuery::addField' => ['SolrQuery', 'field'=>'string'], 'SolrQuery::addFilterQuery' => ['SolrQuery', 'fq'=>'string'], 'SolrQuery::addGroupField' => ['SolrQuery', 'value'=>'string'], 'SolrQuery::addGroupFunction' => ['SolrQuery', 'value'=>'string'], 'SolrQuery::addGroupQuery' => ['SolrQuery', 'value'=>'string'], 'SolrQuery::addGroupSortField' => ['SolrQuery', 'field'=>'string', 'order='=>'int'], 'SolrQuery::addHighlightField' => ['SolrQuery', 'field'=>'string'], 'SolrQuery::addMltField' => ['SolrQuery', 'field'=>'string'], 'SolrQuery::addMltQueryField' => ['SolrQuery', 'field'=>'string', 'boost'=>'float'], 'SolrQuery::addParam' => ['SolrParams', 'name'=>'string', 'value'=>'string'], 'SolrQuery::addSortField' => ['SolrQuery', 'field'=>'string', 'order='=>'int'], 'SolrQuery::addStatsFacet' => ['SolrQuery', 'field'=>'string'], 'SolrQuery::addStatsField' => ['SolrQuery', 'field'=>'string'], 'SolrQuery::collapse' => ['SolrQuery', 'collapseFunction'=>'SolrCollapseFunction'], 'SolrQuery::get' => ['mixed', 'param_name'=>'string'], 'SolrQuery::getExpand' => ['bool'], 'SolrQuery::getExpandFilterQueries' => ['array'], 'SolrQuery::getExpandQuery' => ['array'], 'SolrQuery::getExpandRows' => ['int'], 'SolrQuery::getExpandSortFields' => ['array'], 'SolrQuery::getFacet' => ['bool'], 'SolrQuery::getFacetDateEnd' => ['string', 'field_override='=>'string'], 'SolrQuery::getFacetDateFields' => ['array'], 'SolrQuery::getFacetDateGap' => ['string', 'field_override='=>'string'], 'SolrQuery::getFacetDateHardEnd' => ['string', 'field_override='=>'string'], 'SolrQuery::getFacetDateOther' => ['?string', 'field_override='=>'string'], 'SolrQuery::getFacetDateStart' => ['string', 'field_override='=>'string'], 'SolrQuery::getFacetFields' => ['array'], 'SolrQuery::getFacetLimit' => ['int', 'field_override='=>'string'], 'SolrQuery::getFacetMethod' => ['string', 'field_override='=>'string'], 'SolrQuery::getFacetMinCount' => ['int', 'field_override='=>'string'], 'SolrQuery::getFacetMissing' => ['bool', 'field_override='=>'string'], 'SolrQuery::getFacetOffset' => ['int', 'field_override='=>'string'], 'SolrQuery::getFacetPrefix' => ['string', 'field_override='=>'string'], 'SolrQuery::getFacetQueries' => ['array'], 'SolrQuery::getFacetSort' => ['int', 'field_override='=>'string'], 'SolrQuery::getFields' => ['array'], 'SolrQuery::getFilterQueries' => ['array'], 'SolrQuery::getGroup' => ['bool'], 'SolrQuery::getGroupCachePercent' => ['int'], 'SolrQuery::getGroupFacet' => ['bool'], 'SolrQuery::getGroupFields' => ['array'], 'SolrQuery::getGroupFormat' => ['string'], 'SolrQuery::getGroupFunctions' => ['array'], 'SolrQuery::getGroupLimit' => ['int'], 'SolrQuery::getGroupMain' => ['bool'], 'SolrQuery::getGroupNGroups' => ['bool'], 'SolrQuery::getGroupOffset' => ['int'], 'SolrQuery::getGroupQueries' => ['array'], 'SolrQuery::getGroupSortFields' => ['array'], 'SolrQuery::getGroupTruncate' => ['bool'], 'SolrQuery::getHighlight' => ['bool'], 'SolrQuery::getHighlightAlternateField' => ['string', 'field_override='=>'string'], 'SolrQuery::getHighlightFields' => ['array'], 'SolrQuery::getHighlightFormatter' => ['string', 'field_override='=>'string'], 'SolrQuery::getHighlightFragmenter' => ['string', 'field_override='=>'string'], 'SolrQuery::getHighlightFragsize' => ['int', 'field_override='=>'string'], 'SolrQuery::getHighlightHighlightMultiTerm' => ['bool'], 'SolrQuery::getHighlightMaxAlternateFieldLength' => ['int', 'field_override='=>'string'], 'SolrQuery::getHighlightMaxAnalyzedChars' => ['int'], 'SolrQuery::getHighlightMergeContiguous' => ['bool', 'field_override='=>'string'], 'SolrQuery::getHighlightRegexMaxAnalyzedChars' => ['int'], 'SolrQuery::getHighlightRegexPattern' => ['string'], 'SolrQuery::getHighlightRegexSlop' => ['float'], 'SolrQuery::getHighlightRequireFieldMatch' => ['bool'], 'SolrQuery::getHighlightSimplePost' => ['string', 'field_override='=>'string'], 'SolrQuery::getHighlightSimplePre' => ['string', 'field_override='=>'string'], 'SolrQuery::getHighlightSnippets' => ['int', 'field_override='=>'string'], 'SolrQuery::getHighlightUsePhraseHighlighter' => ['bool'], 'SolrQuery::getMlt' => ['bool'], 'SolrQuery::getMltBoost' => ['bool'], 'SolrQuery::getMltCount' => ['int'], 'SolrQuery::getMltFields' => ['array'], 'SolrQuery::getMltMaxNumQueryTerms' => ['int'], 'SolrQuery::getMltMaxNumTokens' => ['int'], 'SolrQuery::getMltMaxWordLength' => ['int'], 'SolrQuery::getMltMinDocFrequency' => ['int'], 'SolrQuery::getMltMinTermFrequency' => ['int'], 'SolrQuery::getMltMinWordLength' => ['int'], 'SolrQuery::getMltQueryFields' => ['array'], 'SolrQuery::getParam' => ['mixed', 'param_name'=>'string'], 'SolrQuery::getParams' => ['array'], 'SolrQuery::getPreparedParams' => ['array'], 'SolrQuery::getQuery' => ['string'], 'SolrQuery::getRows' => ['int'], 'SolrQuery::getSortFields' => ['array'], 'SolrQuery::getStart' => ['int'], 'SolrQuery::getStats' => ['bool'], 'SolrQuery::getStatsFacets' => ['array'], 'SolrQuery::getStatsFields' => ['array'], 'SolrQuery::getTerms' => ['bool'], 'SolrQuery::getTermsField' => ['string'], 'SolrQuery::getTermsIncludeLowerBound' => ['bool'], 'SolrQuery::getTermsIncludeUpperBound' => ['bool'], 'SolrQuery::getTermsLimit' => ['int'], 'SolrQuery::getTermsLowerBound' => ['string'], 'SolrQuery::getTermsMaxCount' => ['int'], 'SolrQuery::getTermsMinCount' => ['int'], 'SolrQuery::getTermsPrefix' => ['string'], 'SolrQuery::getTermsReturnRaw' => ['bool'], 'SolrQuery::getTermsSort' => ['int'], 'SolrQuery::getTermsUpperBound' => ['string'], 'SolrQuery::getTimeAllowed' => ['int'], 'SolrQuery::removeExpandFilterQuery' => ['SolrQuery', 'fq'=>'string'], 'SolrQuery::removeExpandSortField' => ['SolrQuery', 'field'=>'string'], 'SolrQuery::removeFacetDateField' => ['SolrQuery', 'field'=>'string'], 'SolrQuery::removeFacetDateOther' => ['SolrQuery', 'value'=>'string', 'field_override='=>'string'], 'SolrQuery::removeFacetField' => ['SolrQuery', 'field'=>'string'], 'SolrQuery::removeFacetQuery' => ['SolrQuery', 'value'=>'string'], 'SolrQuery::removeField' => ['SolrQuery', 'field'=>'string'], 'SolrQuery::removeFilterQuery' => ['SolrQuery', 'fq'=>'string'], 'SolrQuery::removeHighlightField' => ['SolrQuery', 'field'=>'string'], 'SolrQuery::removeMltField' => ['SolrQuery', 'field'=>'string'], 'SolrQuery::removeMltQueryField' => ['SolrQuery', 'queryfield'=>'string'], 'SolrQuery::removeSortField' => ['SolrQuery', 'field'=>'string'], 'SolrQuery::removeStatsFacet' => ['SolrQuery', 'value'=>'string'], 'SolrQuery::removeStatsField' => ['SolrQuery', 'field'=>'string'], 'SolrQuery::serialize' => ['string'], 'SolrQuery::set' => ['SolrParams', 'name'=>'string', 'value'=>''], 'SolrQuery::setEchoHandler' => ['SolrQuery', 'flag'=>'bool'], 'SolrQuery::setEchoParams' => ['SolrQuery', 'type'=>'string'], 'SolrQuery::setExpand' => ['SolrQuery', 'value'=>'bool'], 'SolrQuery::setExpandQuery' => ['SolrQuery', 'q'=>'string'], 'SolrQuery::setExpandRows' => ['SolrQuery', 'value'=>'int'], 'SolrQuery::setExplainOther' => ['SolrQuery', 'query'=>'string'], 'SolrQuery::setFacet' => ['SolrQuery', 'flag'=>'bool'], 'SolrQuery::setFacetDateEnd' => ['SolrQuery', 'value'=>'string', 'field_override='=>'string'], 'SolrQuery::setFacetDateGap' => ['SolrQuery', 'value'=>'string', 'field_override='=>'string'], 'SolrQuery::setFacetDateHardEnd' => ['SolrQuery', 'value'=>'bool', 'field_override='=>'string'], 'SolrQuery::setFacetDateStart' => ['SolrQuery', 'value'=>'string', 'field_override='=>'string'], 'SolrQuery::setFacetEnumCacheMinDefaultFrequency' => ['SolrQuery', 'frequency'=>'int', 'field_override='=>'string'], 'SolrQuery::setFacetLimit' => ['SolrQuery', 'limit'=>'int', 'field_override='=>'string'], 'SolrQuery::setFacetMethod' => ['SolrQuery', 'method'=>'string', 'field_override='=>'string'], 'SolrQuery::setFacetMinCount' => ['SolrQuery', 'mincount'=>'int', 'field_override='=>'string'], 'SolrQuery::setFacetMissing' => ['SolrQuery', 'flag'=>'bool', 'field_override='=>'string'], 'SolrQuery::setFacetOffset' => ['SolrQuery', 'offset'=>'int', 'field_override='=>'string'], 'SolrQuery::setFacetPrefix' => ['SolrQuery', 'prefix'=>'string', 'field_override='=>'string'], 'SolrQuery::setFacetSort' => ['SolrQuery', 'facetsort'=>'int', 'field_override='=>'string'], 'SolrQuery::setGroup' => ['SolrQuery', 'value'=>'bool'], 'SolrQuery::setGroupCachePercent' => ['SolrQuery', 'percent'=>'int'], 'SolrQuery::setGroupFacet' => ['SolrQuery', 'value'=>'bool'], 'SolrQuery::setGroupFormat' => ['SolrQuery', 'value'=>'string'], 'SolrQuery::setGroupLimit' => ['SolrQuery', 'value'=>'int'], 'SolrQuery::setGroupMain' => ['SolrQuery', 'value'=>'string'], 'SolrQuery::setGroupNGroups' => ['SolrQuery', 'value'=>'bool'], 'SolrQuery::setGroupOffset' => ['SolrQuery', 'value'=>'int'], 'SolrQuery::setGroupTruncate' => ['SolrQuery', 'value'=>'bool'], 'SolrQuery::setHighlight' => ['SolrQuery', 'flag'=>'bool'], 'SolrQuery::setHighlightAlternateField' => ['SolrQuery', 'field'=>'string', 'field_override='=>'string'], 'SolrQuery::setHighlightFormatter' => ['SolrQuery', 'formatter'=>'string', 'field_override='=>'string'], 'SolrQuery::setHighlightFragmenter' => ['SolrQuery', 'fragmenter'=>'string', 'field_override='=>'string'], 'SolrQuery::setHighlightFragsize' => ['SolrQuery', 'size'=>'int', 'field_override='=>'string'], 'SolrQuery::setHighlightHighlightMultiTerm' => ['SolrQuery', 'flag'=>'bool'], 'SolrQuery::setHighlightMaxAlternateFieldLength' => ['SolrQuery', 'fieldlength'=>'int', 'field_override='=>'string'], 'SolrQuery::setHighlightMaxAnalyzedChars' => ['SolrQuery', 'value'=>'int'], 'SolrQuery::setHighlightMergeContiguous' => ['SolrQuery', 'flag'=>'bool', 'field_override='=>'string'], 'SolrQuery::setHighlightRegexMaxAnalyzedChars' => ['SolrQuery', 'maxanalyzedchars'=>'int'], 'SolrQuery::setHighlightRegexPattern' => ['SolrQuery', 'value'=>'string'], 'SolrQuery::setHighlightRegexSlop' => ['SolrQuery', 'factor'=>'float'], 'SolrQuery::setHighlightRequireFieldMatch' => ['SolrQuery', 'flag'=>'bool'], 'SolrQuery::setHighlightSimplePost' => ['SolrQuery', 'simplepost'=>'string', 'field_override='=>'string'], 'SolrQuery::setHighlightSimplePre' => ['SolrQuery', 'simplepre'=>'string', 'field_override='=>'string'], 'SolrQuery::setHighlightSnippets' => ['SolrQuery', 'value'=>'int', 'field_override='=>'string'], 'SolrQuery::setHighlightUsePhraseHighlighter' => ['SolrQuery', 'flag'=>'bool'], 'SolrQuery::setMlt' => ['SolrQuery', 'flag'=>'bool'], 'SolrQuery::setMltBoost' => ['SolrQuery', 'flag'=>'bool'], 'SolrQuery::setMltCount' => ['SolrQuery', 'count'=>'int'], 'SolrQuery::setMltMaxNumQueryTerms' => ['SolrQuery', 'value'=>'int'], 'SolrQuery::setMltMaxNumTokens' => ['SolrQuery', 'value'=>'int'], 'SolrQuery::setMltMaxWordLength' => ['SolrQuery', 'maxwordlength'=>'int'], 'SolrQuery::setMltMinDocFrequency' => ['SolrQuery', 'mindocfrequency'=>'int'], 'SolrQuery::setMltMinTermFrequency' => ['SolrQuery', 'mintermfrequency'=>'int'], 'SolrQuery::setMltMinWordLength' => ['SolrQuery', 'minwordlength'=>'int'], 'SolrQuery::setOmitHeader' => ['SolrQuery', 'flag'=>'bool'], 'SolrQuery::setParam' => ['SolrParams', 'name'=>'string', 'value'=>''], 'SolrQuery::setQuery' => ['SolrQuery', 'query'=>'string'], 'SolrQuery::setRows' => ['SolrQuery', 'rows'=>'int'], 'SolrQuery::setShowDebugInfo' => ['SolrQuery', 'flag'=>'bool'], 'SolrQuery::setStart' => ['SolrQuery', 'start'=>'int'], 'SolrQuery::setStats' => ['SolrQuery', 'flag'=>'bool'], 'SolrQuery::setTerms' => ['SolrQuery', 'flag'=>'bool'], 'SolrQuery::setTermsField' => ['SolrQuery', 'fieldname'=>'string'], 'SolrQuery::setTermsIncludeLowerBound' => ['SolrQuery', 'flag'=>'bool'], 'SolrQuery::setTermsIncludeUpperBound' => ['SolrQuery', 'flag'=>'bool'], 'SolrQuery::setTermsLimit' => ['SolrQuery', 'limit'=>'int'], 'SolrQuery::setTermsLowerBound' => ['SolrQuery', 'lowerbound'=>'string'], 'SolrQuery::setTermsMaxCount' => ['SolrQuery', 'frequency'=>'int'], 'SolrQuery::setTermsMinCount' => ['SolrQuery', 'frequency'=>'int'], 'SolrQuery::setTermsPrefix' => ['SolrQuery', 'prefix'=>'string'], 'SolrQuery::setTermsReturnRaw' => ['SolrQuery', 'flag'=>'bool'], 'SolrQuery::setTermsSort' => ['SolrQuery', 'sorttype'=>'int'], 'SolrQuery::setTermsUpperBound' => ['SolrQuery', 'upperbound'=>'string'], 'SolrQuery::setTimeAllowed' => ['SolrQuery', 'timeallowed'=>'int'], 'SolrQuery::toString' => ['string', 'url_encode='=>'bool|false'], 'SolrQuery::unserialize' => ['void', 'serialized'=>'string'], 'SolrQueryResponse::__construct' => ['void'], 'SolrQueryResponse::__destruct' => [''], 'SolrQueryResponse::getDigestedResponse' => ['string'], 'SolrQueryResponse::getHttpStatus' => ['int'], 'SolrQueryResponse::getHttpStatusMessage' => ['string'], 'SolrQueryResponse::getRawRequest' => ['string'], 'SolrQueryResponse::getRawRequestHeaders' => ['string'], 'SolrQueryResponse::getRawResponse' => ['string'], 'SolrQueryResponse::getRawResponseHeaders' => ['string'], 'SolrQueryResponse::getRequestUrl' => ['string'], 'SolrQueryResponse::getResponse' => ['SolrObject'], 'SolrQueryResponse::setParseMode' => ['bool', 'parser_mode='=>'int'], 'SolrQueryResponse::success' => ['bool'], 'SolrResponse::getDigestedResponse' => ['string'], 'SolrResponse::getHttpStatus' => ['int'], 'SolrResponse::getHttpStatusMessage' => ['string'], 'SolrResponse::getRawRequest' => ['string'], 'SolrResponse::getRawRequestHeaders' => ['string'], 'SolrResponse::getRawResponse' => ['string'], 'SolrResponse::getRawResponseHeaders' => ['string'], 'SolrResponse::getRequestUrl' => ['string'], 'SolrResponse::getResponse' => ['SolrObject'], 'SolrResponse::setParseMode' => ['bool', 'parser_mode='=>'int'], 'SolrResponse::success' => ['bool'], 'SolrServerException::__clone' => ['void'], 'SolrServerException::__construct' => ['void', 'message='=>'string', 'code='=>'int', 'previous='=>'(?Exception)|(?Throwable)'], 'SolrServerException::__toString' => ['string'], 'SolrServerException::__wakeup' => ['void'], 'SolrServerException::getCode' => ['int'], 'SolrServerException::getFile' => ['string'], 'SolrServerException::getInternalInfo' => ['array'], 'SolrServerException::getLine' => ['int'], 'SolrServerException::getMessage' => ['string'], 'SolrServerException::getPrevious' => ['Exception|Throwable'], 'SolrServerException::getTrace' => ['list<array{function:string,line?:int,file?:string,class?:class-string,type?:\'::\'|\'->\',args?:mixed[],object?:object}>'], 'SolrServerException::getTraceAsString' => ['string'], 'SolrUpdateResponse::__construct' => ['void'], 'SolrUpdateResponse::__destruct' => [''], 'SolrUpdateResponse::getDigestedResponse' => ['string'], 'SolrUpdateResponse::getHttpStatus' => ['int'], 'SolrUpdateResponse::getHttpStatusMessage' => ['string'], 'SolrUpdateResponse::getRawRequest' => ['string'], 'SolrUpdateResponse::getRawRequestHeaders' => ['string'], 'SolrUpdateResponse::getRawResponse' => ['string'], 'SolrUpdateResponse::getRawResponseHeaders' => ['string'], 'SolrUpdateResponse::getRequestUrl' => ['string'], 'SolrUpdateResponse::getResponse' => ['SolrObject'], 'SolrUpdateResponse::setParseMode' => ['bool', 'parser_mode='=>'int'], 'SolrUpdateResponse::success' => ['bool'], 'SolrUtils::digestXmlResponse' => ['SolrObject', 'xmlresponse'=>'string', 'parse_mode='=>'int'], 'SolrUtils::escapeQueryChars' => ['string|false', 'str'=>'string'], 'SolrUtils::getSolrVersion' => ['string'], 'SolrUtils::queryPhrase' => ['string', 'str'=>'string'], 'sort' => ['bool', '&rw_array_arg'=>'array', 'sort_flags='=>'int'], 'soundex' => ['string', 'str'=>'string'], 'SphinxClient::__construct' => ['void'], 'SphinxClient::addQuery' => ['int', 'query'=>'string', 'index='=>'string', 'comment='=>'string'], 'SphinxClient::buildExcerpts' => ['array', 'docs'=>'array', 'index'=>'string', 'words'=>'string', 'opts='=>'array'], 'SphinxClient::buildKeywords' => ['array', 'query'=>'string', 'index'=>'string', 'hits'=>'bool'], 'SphinxClient::close' => ['bool'], 'SphinxClient::escapeString' => ['string', 'string'=>'string'], 'SphinxClient::getLastError' => ['string'], 'SphinxClient::getLastWarning' => ['string'], 'SphinxClient::open' => ['bool'], 'SphinxClient::query' => ['array', 'query'=>'string', 'index='=>'string', 'comment='=>'string'], 'SphinxClient::resetFilters' => ['void'], 'SphinxClient::resetGroupBy' => ['void'], 'SphinxClient::runQueries' => ['array'], 'SphinxClient::setArrayResult' => ['bool', 'array_result'=>'bool'], 'SphinxClient::setConnectTimeout' => ['bool', 'timeout'=>'float'], 'SphinxClient::setFieldWeights' => ['bool', 'weights'=>'array'], 'SphinxClient::setFilter' => ['bool', 'attribute'=>'string', 'values'=>'array', 'exclude='=>'bool'], 'SphinxClient::setFilterFloatRange' => ['bool', 'attribute'=>'string', 'min'=>'float', 'max'=>'float', 'exclude='=>'bool'], 'SphinxClient::setFilterRange' => ['bool', 'attribute'=>'string', 'min'=>'int', 'max'=>'int', 'exclude='=>'bool'], 'SphinxClient::setGeoAnchor' => ['bool', 'attrlat'=>'string', 'attrlong'=>'string', 'latitude'=>'float', 'longitude'=>'float'], 'SphinxClient::setGroupBy' => ['bool', 'attribute'=>'string', 'func'=>'int', 'groupsort='=>'string'], 'SphinxClient::setGroupDistinct' => ['bool', 'attribute'=>'string'], 'SphinxClient::setIDRange' => ['bool', 'min'=>'int', 'max'=>'int'], 'SphinxClient::setIndexWeights' => ['bool', 'weights'=>'array'], 'SphinxClient::setLimits' => ['bool', 'offset'=>'int', 'limit'=>'int', 'max_matches='=>'int', 'cutoff='=>'int'], 'SphinxClient::setMatchMode' => ['bool', 'mode'=>'int'], 'SphinxClient::setMaxQueryTime' => ['bool', 'qtime'=>'int'], 'SphinxClient::setOverride' => ['bool', 'attribute'=>'string', 'type'=>'int', 'values'=>'array'], 'SphinxClient::setRankingMode' => ['bool', 'ranker'=>'int'], 'SphinxClient::setRetries' => ['bool', 'count'=>'int', 'delay='=>'int'], 'SphinxClient::setSelect' => ['bool', 'clause'=>'string'], 'SphinxClient::setServer' => ['bool', 'server'=>'string', 'port'=>'int'], 'SphinxClient::setSortMode' => ['bool', 'mode'=>'int', 'sortby='=>'string'], 'SphinxClient::status' => ['array'], 'SphinxClient::updateAttributes' => ['int', 'index'=>'string', 'attributes'=>'array', 'values'=>'array', 'mva='=>'bool'], 'spl_autoload' => ['void', 'class_name'=>'string', 'file_extensions='=>'string'], 'spl_autoload_call' => ['void', 'class_name'=>'string'], 'spl_autoload_extensions' => ['string', 'file_extensions='=>'string'], 'spl_autoload_functions' => ['false|list<callable(string):void>'], 'spl_autoload_register' => ['bool', 'autoload_function='=>'callable(string):void', 'throw='=>'bool', 'prepend='=>'bool'], 'spl_autoload_unregister' => ['bool', 'autoload_function'=>'mixed'], 'spl_classes' => ['array'], 'spl_object_hash' => ['string', 'obj'=>'object'], 'spl_object_id' => ['int', 'obj'=>'object'], 'SplDoublyLinkedList::add' => ['void', 'index'=>'mixed', 'newval'=>'mixed'], 'SplDoublyLinkedList::bottom' => ['mixed'], 'SplDoublyLinkedList::count' => ['0|positive-int'], 'SplDoublyLinkedList::current' => ['mixed'], 'SplDoublyLinkedList::getIteratorMode' => ['int'], 'SplDoublyLinkedList::isEmpty' => ['bool'], 'SplDoublyLinkedList::key' => ['mixed'], 'SplDoublyLinkedList::next' => ['void'], 'SplDoublyLinkedList::offsetExists' => ['bool', 'index'=>'mixed'], 'SplDoublyLinkedList::offsetGet' => ['mixed', 'index'=>'mixed'], 'SplDoublyLinkedList::offsetSet' => ['void', 'index'=>'mixed', 'newval'=>'mixed'], 'SplDoublyLinkedList::offsetUnset' => ['void', 'index'=>'mixed'], 'SplDoublyLinkedList::pop' => ['mixed'], 'SplDoublyLinkedList::prev' => ['void'], 'SplDoublyLinkedList::push' => ['void', 'value'=>'mixed'], 'SplDoublyLinkedList::rewind' => ['void'], 'SplDoublyLinkedList::serialize' => ['string'], 'SplDoublyLinkedList::setIteratorMode' => ['int', 'flags'=>'int'], 'SplDoublyLinkedList::shift' => ['mixed'], 'SplDoublyLinkedList::top' => ['mixed'], 'SplDoublyLinkedList::unserialize' => ['void', 'serialized'=>'string'], 'SplDoublyLinkedList::unshift' => ['bool', 'value'=>'mixed'], 'SplDoublyLinkedList::valid' => ['bool'], 'SplEnum::__construct' => ['void', 'initial_value='=>'mixed', 'strict='=>'bool|true'], 'SplEnum::getConstList' => ['array', 'include_default='=>'bool'], 'SplFileInfo::__construct' => ['void', 'file_name'=>'string'], 'SplFileInfo::__toString' => ['string'], 'SplFileInfo::getATime' => ['__benevolent<int|false>'], 'SplFileInfo::getBasename' => ['string', 'suffix='=>'string'], 'SplFileInfo::getCTime' => ['int'], 'SplFileInfo::getExtension' => ['string'], 'SplFileInfo::getFileInfo' => ['SplFileInfo', 'class_name='=>'string'], 'SplFileInfo::getFilename' => ['string'], 'SplFileInfo::getGroup' => ['__benevolent<int|false>'], 'SplFileInfo::getInode' => ['__benevolent<int|false>'], 'SplFileInfo::getLinkTarget' => ['__benevolent<string|false>'], 'SplFileInfo::getMTime' => ['__benevolent<int|false>'], 'SplFileInfo::getOwner' => ['__benevolent<int|false>'], 'SplFileInfo::getPath' => ['string'], 'SplFileInfo::getPathInfo' => ['__benevolent<SplFileInfo|null>', 'class_name='=>'string'], 'SplFileInfo::getPathname' => ['string'], 'SplFileInfo::getPerms' => ['__benevolent<int|false>'], 'SplFileInfo::getRealPath' => ['__benevolent<string|false>'], 'SplFileInfo::getSize' => ['__benevolent<int|false>'], 'SplFileInfo::getType' => ['__benevolent<string|false>'], 'SplFileInfo::isDir' => ['bool'], 'SplFileInfo::isExecutable' => ['bool'], 'SplFileInfo::isFile' => ['bool'], 'SplFileInfo::isLink' => ['bool'], 'SplFileInfo::isReadable' => ['bool'], 'SplFileInfo::isWritable' => ['bool'], 'SplFileInfo::openFile' => ['SplFileObject', 'mode='=>'string', 'use_include_path='=>'bool', 'context='=>'resource'], 'SplFileInfo::setFileClass' => ['void', 'class_name='=>'string'], 'SplFileInfo::setInfoClass' => ['void', 'class_name='=>'string'], 'SplFileObject::__construct' => ['void', 'filename'=>'string', 'mode='=>'string', 'use_include_path='=>'bool', 'context='=>''], 'SplFileObject::__toString' => ['string'], 'SplFileObject::current' => ['string|array|false'], 'SplFileObject::eof' => ['bool'], 'SplFileObject::fflush' => ['bool'], 'SplFileObject::fgetc' => ['string|false'], // Do not believe https://www.php.net/manual/en/splfileobject.fgetcsv#refsect1-splfileobject.fgetcsv-returnvalues 'SplFileObject::fgetcsv' => ['list<string>|array{0: null}|false|null', 'delimiter='=>'string', 'enclosure='=>'string', 'escape='=>'string'], 'SplFileObject::fgets' => ['string'], 'SplFileObject::fgetss' => ['string|false', 'allowable_tags='=>'string'], 'SplFileObject::flock' => ['bool', 'operation'=>'int', '&w_wouldblock='=>'int'], 'SplFileObject::fpassthru' => ['int'], 'SplFileObject::fputcsv' => ['int|false', 'fields'=>'array', 'delimiter='=>'string', 'enclosure='=>'string', 'escape='=>'string'], 'SplFileObject::fread' => ['string|false', 'length'=>'int'], 'SplFileObject::fscanf' => ['bool', 'format'=>'string', '&...w_vars='=>'string|int|float'], 'SplFileObject::fseek' => ['int', 'pos'=>'int', 'whence='=>'int'], 'SplFileObject::fstat' => ['array'], 'SplFileObject::ftell' => ['int|false'], 'SplFileObject::ftruncate' => ['bool', 'size'=>'int'], 'SplFileObject::fwrite' => ['int', 'str'=>'string', 'length='=>'int'], 'SplFileObject::getChildren' => ['null'], 'SplFileObject::getCsvControl' => ['array'], 'SplFileObject::getCurrentLine' => ['string'], 'SplFileObject::getFlags' => ['int'], 'SplFileObject::getMaxLineLen' => ['int'], 'SplFileObject::hasChildren' => ['false'], 'SplFileObject::key' => ['int'], 'SplFileObject::next' => ['void'], 'SplFileObject::rewind' => ['void'], 'SplFileObject::seek' => ['void', 'line_pos'=>'int'], 'SplFileObject::setCsvControl' => ['void', 'delimiter='=>'string', 'enclosure='=>'string', 'escape='=>'string'], 'SplFileObject::setFlags' => ['void', 'flags'=>'int'], 'SplFileObject::setMaxLineLen' => ['void', 'max_len'=>'int'], 'SplFileObject::valid' => ['bool'], 'SplFixedArray::__construct' => ['void', 'size='=>'int'], 'SplFixedArray::__wakeup' => ['void'], 'SplFixedArray::count' => ['0|positive-int'], 'SplFixedArray::current' => ['mixed'], 'SplFixedArray::fromArray' => ['SplFixedArray', 'data'=>'array', 'save_indexes='=>'bool'], 'SplFixedArray::getSize' => ['int'], 'SplFixedArray::key' => ['int'], 'SplFixedArray::next' => ['void'], 'SplFixedArray::offsetExists' => ['bool', 'index'=>'int'], 'SplFixedArray::offsetGet' => ['mixed', 'index'=>'int'], 'SplFixedArray::offsetSet' => ['void', 'index'=>'int', 'newval'=>'mixed'], 'SplFixedArray::offsetUnset' => ['void', 'index'=>'int'], 'SplFixedArray::rewind' => ['void'], 'SplFixedArray::setSize' => ['bool', 'size'=>'int'], 'SplFixedArray::toArray' => ['array'], 'SplFixedArray::valid' => ['bool'], 'SplHeap::compare' => ['int', 'value1'=>'mixed', 'value2'=>'mixed'], 'SplHeap::count' => ['0|positive-int'], 'SplHeap::current' => ['mixed'], 'SplHeap::extract' => ['mixed'], 'SplHeap::insert' => ['bool', 'value'=>'mixed'], 'SplHeap::isCorrupted' => ['int'], 'SplHeap::isEmpty' => ['bool'], 'SplHeap::key' => ['int'], 'SplHeap::next' => ['void'], 'SplHeap::recoverFromCorruption' => ['int'], 'SplHeap::rewind' => ['void'], 'SplHeap::top' => ['mixed'], 'SplHeap::valid' => ['bool'], 'split' => ['array', 'pattern'=>'string', 'string'=>'string', 'limit='=>'int'], 'spliti' => ['array', 'pattern'=>'string', 'string'=>'string', 'limit='=>'int'], 'SplMaxHeap::compare' => ['int', 'a'=>'mixed', 'b'=>'mixed'], 'SplMinHeap::compare' => ['int', 'a'=>'mixed', 'b'=>'mixed'], 'SplObjectStorage::addAll' => ['0|positive-int', 'os'=>'SplObjectStorage'], 'SplObjectStorage::attach' => ['void', 'obj'=>'object', 'inf='=>'mixed'], 'SplObjectStorage::contains' => ['bool', 'obj'=>'object'], 'SplObjectStorage::count' => ['0|positive-int'], 'SplObjectStorage::current' => ['object'], 'SplObjectStorage::detach' => ['void', 'obj'=>'object'], 'SplObjectStorage::getHash' => ['string', 'obj'=>'object'], 'SplObjectStorage::getInfo' => ['mixed'], 'SplObjectStorage::key' => ['int'], 'SplObjectStorage::next' => ['void'], 'SplObjectStorage::offsetExists' => ['bool', 'object'=>'object'], 'SplObjectStorage::offsetGet' => ['mixed', 'obj'=>'object'], 'SplObjectStorage::offsetSet' => ['object', 'object'=>'object', 'data='=>'mixed'], 'SplObjectStorage::offsetUnset' => ['object', 'object'=>'object'], 'SplObjectStorage::removeAll' => ['0|positive-int', 'os'=>'SplObjectStorage'], 'SplObjectStorage::removeAllExcept' => ['0|positive-int', 'os'=>'SplObjectStorage'], 'SplObjectStorage::rewind' => ['void'], 'SplObjectStorage::serialize' => ['string'], 'SplObjectStorage::setInfo' => ['void', 'inf'=>'mixed'], 'SplObjectStorage::unserialize' => ['void', 'serialized'=>'string'], 'SplObjectStorage::valid' => ['bool'], 'SplObserver::update' => ['void', 'subject'=>'SplSubject'], 'SplPriorityQueue::compare' => ['int', 'a'=>'mixed', 'b'=>'mixed'], 'SplPriorityQueue::count' => ['0|positive-int'], 'SplPriorityQueue::current' => ['mixed'], 'SplPriorityQueue::extract' => ['mixed'], 'SplPriorityQueue::getExtractFlags' => ['int'], 'SplPriorityQueue::insert' => ['bool', 'value'=>'mixed', 'priority'=>'mixed'], 'SplPriorityQueue::isEmpty' => ['bool'], 'SplPriorityQueue::key' => ['mixed'], 'SplPriorityQueue::next' => ['void'], 'SplPriorityQueue::recoverFromCorruption' => ['void'], 'SplPriorityQueue::rewind' => ['void'], 'SplPriorityQueue::setExtractFlags' => ['void', 'flags'=>'int'], 'SplPriorityQueue::top' => ['mixed'], 'SplPriorityQueue::valid' => ['bool'], 'SplQueue::dequeue' => ['mixed'], 'SplQueue::enqueue' => ['void', 'value'=>'mixed'], 'SplQueue::setIteratorMode' => ['void', 'mode'=>'int'], 'SplStack::setIteratorMode' => ['void', 'mode'=>'int'], 'SplSubject::attach' => ['void', 'observer'=>'SplObserver'], 'SplSubject::detach' => ['void', 'observer'=>'SplObserver'], 'SplSubject::notify' => ['void'], 'SplTempFileObject::__construct' => ['void', 'max_memory='=>'int'], 'SplType::__construct' => ['void', 'initial_value='=>'mixed', 'strict='=>'bool'], 'Spoofchecker::__construct' => ['void'], 'Spoofchecker::areConfusable' => ['bool', 's1'=>'string', 's2'=>'string', '&w_error='=>'string'], 'Spoofchecker::isSuspicious' => ['bool', 'text'=>'string', '&w_error='=>'string'], 'Spoofchecker::setAllowedLocales' => ['void', 'locale_list'=>'string'], 'Spoofchecker::setChecks' => ['void', 'checks'=>'long'], 'Spoofchecker::setRestrictionLevel' => ['void', 'restriction_level'=>'int'], 'sprintf' => ['string', 'format'=>'string', '...values='=>'__stringAndStringable|int|float|null|bool'], 'sql_regcase' => ['string', 'string'=>'string'], 'SQLite3::__construct' => ['void', 'filename'=>'string', 'flags='=>'int', 'encryption_key='=>'string|null'], 'SQLite3::busyTimeout' => ['bool', 'msecs'=>'int'], 'SQLite3::changes' => ['int'], 'SQLite3::close' => ['bool'], 'SQLite3::createAggregate' => ['bool', 'name'=>'string', 'step_callback'=>'callable', 'final_callback'=>'callable', 'argument_count='=>'int'], 'SQLite3::createCollation' => ['bool', 'name'=>'string', 'callback'=>'callable'], 'SQLite3::createFunction' => ['bool', 'name'=>'string', 'callback'=>'callable', 'argument_count='=>'int', 'flags='=>'int'], 'SQLite3::enableExceptions' => ['bool', 'enableexceptions='=>'bool'], 'SQLite3::escapeString' => ['string', 'value'=>'string'], 'SQLite3::exec' => ['bool', 'query'=>'string'], 'SQLite3::lastErrorCode' => ['int'], 'SQLite3::lastErrorMsg' => ['string'], 'SQLite3::lastInsertRowID' => ['int'], 'SQLite3::loadExtension' => ['bool', 'shared_library'=>'string'], 'SQLite3::open' => ['void', 'filename'=>'string', 'flags='=>'int', 'encryption_key='=>'string|null'], 'SQLite3::openBlob' => ['resource|false', 'table'=>'string', 'column'=>'string', 'rowid'=>'int', 'dbname='=>'string', 'flags='=>'int'], 'SQLite3::prepare' => ['SQLite3Stmt|false', 'query'=>'string'], 'SQLite3::query' => ['SQLite3Result|false', 'query'=>'string'], 'SQLite3::querySingle' => ['array|int|string|bool|float|null|false', 'query'=>'string', 'entire_row='=>'bool'], 'SQLite3::version' => ['array'], 'SQLite3Result::__construct' => ['void'], 'SQLite3Result::columnName' => ['string', 'column_number'=>'int'], 'SQLite3Result::columnType' => ['int', 'column_number'=>'int'], 'SQLite3Result::fetchArray' => ['array|false', 'mode='=>'int'], 'SQLite3Result::finalize' => ['bool'], 'SQLite3Result::numColumns' => ['int'], 'SQLite3Result::reset' => ['bool'], 'SQLite3Stmt::__construct' => ['void', 'dbobject'=>'sqlite3', 'statement'=>'string'], 'SQLite3Stmt::bindParam' => ['bool', 'parameter_name_or_number'=>'string|int', '&rw_parameter'=>'mixed', 'type='=>'int'], 'SQLite3Stmt::bindValue' => ['bool', 'parameter_name_or_number'=>'string|int', 'parameter'=>'mixed', 'type='=>'int'], 'SQLite3Stmt::clear' => ['bool'], 'SQLite3Stmt::close' => ['bool'], 'SQLite3Stmt::execute' => ['false|SQLite3Result'], 'SQLite3Stmt::paramCount' => ['int'], 'SQLite3Stmt::readOnly' => ['bool'], 'SQLite3Stmt::reset' => ['bool'], 'sqlite_array_query' => ['array', 'dbhandle'=>'', 'query'=>'string', 'result_type='=>'int', 'decode_binary='=>'bool'], 'sqlite_busy_timeout' => ['', 'dbhandle'=>'', 'milliseconds'=>'int'], 'sqlite_changes' => ['int', 'dbhandle'=>''], 'sqlite_close' => ['void', 'dbhandle'=>'resource'], 'sqlite_column' => ['', 'result'=>'', 'index_or_name'=>'', 'decode_binary='=>'bool'], 'sqlite_create_aggregate' => ['', 'dbhandle'=>'', 'function_name'=>'string', 'step_func'=>'callable', 'finalize_func'=>'callable', 'num_args='=>'int'], 'sqlite_create_function' => ['', 'dbhandle'=>'', 'function_name'=>'string', 'callback'=>'callable', 'num_args='=>'int'], 'sqlite_current' => ['array', 'result'=>'', 'result_type='=>'int', 'decode_binary='=>'bool'], 'sqlite_error_string' => ['string', 'error_code'=>'int'], 'sqlite_escape_string' => ['string', 'item'=>'string'], 'sqlite_exec' => ['bool', 'dbhandle'=>'', 'query'=>'string', 'error_msg='=>'string'], 'sqlite_factory' => ['SQLiteDatabase', 'filename'=>'string', 'mode='=>'int', 'error_message='=>'string'], 'sqlite_fetch_all' => ['array', 'result'=>'', 'result_type='=>'int', 'decode_binary='=>'bool'], 'sqlite_fetch_array' => ['array', 'result'=>'', 'result_type='=>'int', 'decode_binary='=>'bool'], 'sqlite_fetch_column_types' => ['array', 'table_name'=>'string', 'dbhandle'=>'', 'result_type='=>'int'], 'sqlite_fetch_object' => ['object', 'result'=>'', 'class_name='=>'string', 'ctor_params='=>'array', 'decode_binary='=>'bool'], 'sqlite_fetch_single' => ['string', 'result'=>'', 'decode_binary='=>'bool'], 'sqlite_field_name' => ['string', 'result'=>'', 'field_index'=>'int'], 'sqlite_has_more' => ['bool', 'result'=>'resource'], 'sqlite_has_prev' => ['bool', 'result'=>''], 'sqlite_key' => ['int', 'result'=>''], 'sqlite_last_error' => ['int', 'dbhandle'=>''], 'sqlite_last_insert_rowid' => ['int', 'dbhandle'=>''], 'sqlite_libencoding' => ['string'], 'sqlite_libversion' => ['string'], 'sqlite_next' => ['bool', 'result'=>''], 'sqlite_num_fields' => ['int', 'result'=>''], 'sqlite_num_rows' => ['int', 'result'=>''], 'sqlite_open' => ['resource|false', 'filename'=>'string', 'mode='=>'int', 'error_message='=>'string'], 'sqlite_popen' => ['resource|false', 'filename'=>'string', 'mode='=>'int', 'error_message='=>'string'], 'sqlite_prev' => ['bool', 'result'=>''], 'sqlite_query' => ['SQLiteResult', 'dbhandle'=>'', 'query'=>'string', 'result_type='=>'int', 'error_msg='=>'string'], 'sqlite_rewind' => ['bool', 'result'=>''], 'sqlite_seek' => ['bool', 'result'=>'', 'rownum'=>'int'], 'sqlite_single_query' => ['array', 'db'=>'', 'query'=>'string', 'first_row_only='=>'bool', 'decode_binary='=>'bool'], 'sqlite_udf_decode_binary' => ['string', 'data'=>'string'], 'sqlite_udf_encode_binary' => ['string', 'data'=>'string'], 'sqlite_unbuffered_query' => ['SQLiteUnbuffered', 'dbhandle'=>'', 'query'=>'string', 'result_type='=>'int', 'error_msg='=>'string'], 'sqlite_valid' => ['bool', 'result'=>''], 'SQLiteDatabase::arrayQuery' => ['array', 'dbhandle'=>'', 'query'=>'string', 'result_type='=>'int', 'decode_binary='=>'bool'], 'SQLiteDatabase::busyTimeout' => ['', 'dbhandle'=>'', 'milliseconds'=>'int'], 'SQLiteDatabase::changes' => ['int', 'dbhandle'=>''], 'SQLiteDatabase::createAggregate' => ['', 'dbhandle'=>'', 'function_name'=>'string', 'step_func'=>'callable', 'finalize_func'=>'callable', 'num_args='=>'int'], 'SQLiteDatabase::createFunction' => ['', 'dbhandle'=>'', 'function_name'=>'string', 'callback'=>'callable', 'num_args='=>'int'], 'SQLiteDatabase::exec' => ['bool', 'dbhandle'=>'', 'query'=>'string', 'error_msg='=>'string'], 'SQLiteDatabase::fetchColumnTypes' => ['array', 'table_name'=>'string', 'dbhandle'=>'', 'result_type='=>'int'], 'SQLiteDatabase::lastError' => ['int', 'dbhandle'=>''], 'SQLiteDatabase::lastInsertRowid' => ['int', 'dbhandle'=>''], 'SQLiteDatabase::query' => ['SQLiteResult', 'dbhandle'=>'', 'query'=>'string', 'result_type='=>'int', 'error_msg='=>'string'], 'SQLiteDatabase::queryExec' => ['bool', 'query'=>'string', '&w_error_msg='=>'string'], 'SQLiteDatabase::singleQuery' => ['array', 'db'=>'', 'query'=>'string', 'first_row_only='=>'bool', 'decode_binary='=>'bool'], 'SQLiteDatabase::unbufferedQuery' => ['SQLiteUnbuffered', 'dbhandle'=>'', 'query'=>'string', 'result_type='=>'int', 'error_msg='=>'string'], 'SQLiteResult::column' => ['', 'result'=>'', 'index_or_name'=>'', 'decode_binary='=>'bool'], 'SQLiteResult::current' => ['array', 'result'=>'', 'result_type='=>'int', 'decode_binary='=>'bool'], 'SQLiteResult::fetch' => ['array', 'result'=>'', 'result_type='=>'int', 'decode_binary='=>'bool'], 'SQLiteResult::fetchAll' => ['array', 'result'=>'', 'result_type='=>'int', 'decode_binary='=>'bool'], 'SQLiteResult::fetchObject' => ['object', 'result'=>'', 'class_name='=>'string', 'ctor_params='=>'array', 'decode_binary='=>'bool'], 'SQLiteResult::fetchSingle' => ['string', 'result'=>'', 'decode_binary='=>'bool'], 'SQLiteResult::fieldName' => ['string', 'result'=>'', 'field_index'=>'int'], 'SQLiteResult::hasPrev' => ['bool', 'result'=>''], 'SQLiteResult::key' => ['int', 'result'=>''], 'SQLiteResult::next' => ['bool', 'result'=>''], 'SQLiteResult::numFields' => ['int', 'result'=>''], 'SQLiteResult::numRows' => ['int', 'result'=>''], 'SQLiteResult::prev' => ['bool', 'result'=>''], 'SQLiteResult::rewind' => ['bool', 'result'=>''], 'SQLiteResult::seek' => ['bool', 'result'=>'', 'rownum'=>'int'], 'SQLiteResult::valid' => ['bool', 'result'=>''], 'SQLiteUnbuffered::column' => ['', 'result'=>'', 'index_or_name'=>'', 'decode_binary='=>'bool'], 'SQLiteUnbuffered::current' => ['array', 'result'=>'', 'result_type='=>'int', 'decode_binary='=>'bool'], 'SQLiteUnbuffered::fetch' => ['array', 'result'=>'', 'result_type='=>'int', 'decode_binary='=>'bool'], 'SQLiteUnbuffered::fetchAll' => ['array', 'result'=>'', 'result_type='=>'int', 'decode_binary='=>'bool'], 'SQLiteUnbuffered::fetchObject' => ['object', 'result'=>'', 'class_name='=>'string', 'ctor_params='=>'array', 'decode_binary='=>'bool'], 'SQLiteUnbuffered::fetchSingle' => ['string', 'result'=>'', 'decode_binary='=>'bool'], 'SQLiteUnbuffered::fieldName' => ['string', 'result'=>'', 'field_index'=>'int'], 'SQLiteUnbuffered::next' => ['bool', 'result'=>''], 'SQLiteUnbuffered::numFields' => ['int', 'result'=>''], 'SQLiteUnbuffered::valid' => ['bool', 'result'=>''], 'sqlsrv_begin_transaction' => ['bool', 'conn'=>'resource'], 'sqlsrv_cancel' => ['bool', 'stmt'=>'resource'], 'sqlsrv_client_info' => ['array|false', 'conn'=>'resource'], 'sqlsrv_close' => ['bool', 'conn'=>'resource'], 'sqlsrv_commit' => ['bool', 'conn'=>'resource'], 'sqlsrv_configure' => ['bool', 'setting'=>'string', 'value'=>'mixed'], 'sqlsrv_connect' => ['resource|false', 'serverName'=>'string', 'connectionInfo='=>'array'], 'sqlsrv_errors' => ['array|null', 'errorsOrWarnings='=>'int'], 'sqlsrv_execute' => ['bool', 'stmt'=>'resource'], 'sqlsrv_fetch' => ['bool|null', 'stmt'=>'resource', 'row='=>'int', 'offset='=>'int'], 'sqlsrv_fetch_array' => ['array|null|false', 'stmt'=>'resource', 'fetchType='=>'int', 'row='=>'int', 'offset='=>'int'], 'sqlsrv_fetch_object' => ['object|null|false', 'stmt'=>'resource', 'className='=>'string', 'ctorParams='=>'array', 'row='=>'int', 'offset='=>'int'], 'sqlsrv_field_metadata' => ['array|false', 'stmt'=>'resource'], 'sqlsrv_free_stmt' => ['bool', 'stmt'=>'resource'], 'sqlsrv_get_config' => ['mixed', 'setting'=>'string'], 'sqlsrv_get_field' => ['mixed', 'stmt'=>'resource', 'fieldIndex'=>'int', 'getAsType='=>'int'], 'sqlsrv_has_rows' => ['bool', 'stmt'=>'resource'], 'sqlsrv_next_result' => ['bool|null', 'stmt'=>'resource'], 'sqlsrv_num_fields' => ['int|false', 'stmt'=>'resource'], 'sqlsrv_num_rows' => ['int|false', 'stmt'=>'resource'], 'sqlsrv_prepare' => ['resource|false', 'conn'=>'resource', 'sql'=>'string', 'params='=>'array', 'options='=>'array'], 'sqlsrv_query' => ['resource|false', 'conn'=>'resource', 'sql'=>'string', 'params='=>'array', 'options='=>'array'], 'sqlsrv_rollback' => ['bool', 'conn'=>'resource'], 'sqlsrv_rows_affected' => ['int<-1,max>|false', 'stmt'=>'resource'], 'sqlsrv_send_stream_data' => ['bool', 'stmt'=>'resource'], 'sqlsrv_server_info' => ['array', 'conn'=>'resource'], 'sqrt' => ['float', 'number'=>'float'], 'srand' => ['void', 'seed='=>'int', 'mode='=>'int'], 'sscanf' => ['int|null', 'str'=>'string', 'format'=>'string', '&w_war'=>'string|int|float|null', '&...w_vars='=>'string|int|float|null'], 'sscanf\'1' => ['array|null', 'str'=>'string', 'format'=>'string'], 'ssdeep_fuzzy_compare' => ['int', 'signature1'=>'string', 'signature2'=>'string'], 'ssdeep_fuzzy_hash' => ['string', 'to_hash'=>'string'], 'ssdeep_fuzzy_hash_filename' => ['string', 'file_name'=>'string'], 'ssh2_auth_agent' => ['bool', 'session'=>'resource', 'username'=>'string'], 'ssh2_auth_hostbased_file' => ['bool', 'session'=>'resource', 'username'=>'string', 'hostname'=>'string', 'pubkeyfile'=>'string', 'privkeyfile'=>'string', 'passphrase='=>'string', 'local_username='=>'string'], 'ssh2_auth_none' => ['bool|string[]', 'session'=>'resource', 'username'=>'string'], 'ssh2_auth_password' => ['bool', 'session'=>'resource', 'username'=>'string', 'password'=>'string'], 'ssh2_auth_pubkey_file' => ['bool', 'session'=>'resource', 'username'=>'string', 'pubkeyfile'=>'string', 'privkeyfile'=>'string', 'passphrase='=>'string'], 'ssh2_connect' => ['resource|false', 'host'=>'string', 'port='=>'int', 'methods='=>'array', 'callbacks='=>'array'], 'ssh2_disconnect' => ['bool', 'session'=>'resource'], 'ssh2_exec' => ['resource|false', 'session'=>'resource', 'command'=>'string', 'pty='=>'string', 'env='=>'array', 'width='=>'int', 'height='=>'int', 'width_height_type='=>'int'], 'ssh2_fetch_stream' => ['resource|false', 'channel'=>'resource', 'streamid'=>'int'], 'ssh2_fingerprint' => ['string|false', 'session'=>'resource', 'flags='=>'int'], 'ssh2_methods_negotiated' => ['array|false', 'session'=>'resource'], 'ssh2_publickey_add' => ['bool', 'pkey'=>'resource', 'algoname'=>'string', 'blob'=>'string', 'overwrite='=>'bool', 'attributes='=>'array'], 'ssh2_publickey_init' => ['resource|false', 'session'=>'resource'], 'ssh2_publickey_list' => ['array|false', 'pkey'=>'resource'], 'ssh2_publickey_remove' => ['bool', 'pkey'=>'resource', 'algoname'=>'string', 'blob'=>'string'], 'ssh2_scp_recv' => ['bool', 'session'=>'resource', 'remote_file'=>'string', 'local_file'=>'string'], 'ssh2_scp_send' => ['bool', 'session'=>'resource', 'local_file'=>'string', 'remote_file'=>'string', 'create_mode='=>'int'], 'ssh2_sftp' => ['resource|false', 'session'=>'resource'], 'ssh2_sftp_chmod' => ['bool', 'sftp'=>'resource', 'filename'=>'string', 'mode'=>'int'], 'ssh2_sftp_lstat' => ['array|false', 'sftp'=>'resource', 'path'=>'string'], 'ssh2_sftp_mkdir' => ['bool', 'sftp'=>'resource', 'dirname'=>'string', 'mode='=>'int', 'recursive='=>'bool'], 'ssh2_sftp_readlink' => ['string|false', 'sftp'=>'resource', 'link'=>'string'], 'ssh2_sftp_realpath' => ['string|false', 'sftp'=>'resource', 'filename'=>'string'], 'ssh2_sftp_rename' => ['bool', 'sftp'=>'resource', 'from'=>'string', 'to'=>'string'], 'ssh2_sftp_rmdir' => ['bool', 'sftp'=>'resource', 'dirname'=>'string'], 'ssh2_sftp_stat' => ['array|false', 'sftp'=>'resource', 'path'=>'string'], 'ssh2_sftp_symlink' => ['bool', 'sftp'=>'resource', 'target'=>'string', 'link'=>'string'], 'ssh2_sftp_unlink' => ['bool', 'sftp'=>'resource', 'filename'=>'string'], 'ssh2_shell' => ['resource|false', 'session'=>'resource', 'term_type='=>'string', 'env='=>'array', 'width='=>'int', 'height='=>'int', 'width_height_type='=>'int'], 'ssh2_tunnel' => ['resource|false', 'session'=>'resource', 'host'=>'string', 'port'=>'int'], 'stat' => ['array|false', 'filename'=>'string'], 'stats_absolute_deviation' => ['float', 'a'=>'array'], 'stats_cdf_beta' => ['float', 'par1'=>'float', 'par2'=>'float', 'par3'=>'float', 'which'=>'int'], 'stats_cdf_binomial' => ['float', 'par1'=>'float', 'par2'=>'float', 'par3'=>'float', 'which'=>'int'], 'stats_cdf_cauchy' => ['float', 'par1'=>'float', 'par2'=>'float', 'par3'=>'float', 'which'=>'int'], 'stats_cdf_chisquare' => ['float', 'par1'=>'float', 'par2'=>'float', 'which'=>'int'], 'stats_cdf_exponential' => ['float', 'par1'=>'float', 'par2'=>'float', 'which'=>'int'], 'stats_cdf_f' => ['float', 'par1'=>'float', 'par2'=>'float', 'par3'=>'float', 'which'=>'int'], 'stats_cdf_gamma' => ['float', 'par1'=>'float', 'par2'=>'float', 'par3'=>'float', 'which'=>'int'], 'stats_cdf_laplace' => ['float', 'par1'=>'float', 'par2'=>'float', 'par3'=>'float', 'which'=>'int'], 'stats_cdf_logistic' => ['float', 'par1'=>'float', 'par2'=>'float', 'par3'=>'float', 'which'=>'int'], 'stats_cdf_negative_binomial' => ['float', 'par1'=>'float', 'par2'=>'float', 'par3'=>'float', 'which'=>'int'], 'stats_cdf_noncentral_chisquare' => ['float', 'par1'=>'float', 'par2'=>'float', 'par3'=>'float', 'which'=>'int'], 'stats_cdf_noncentral_f' => ['float', 'par1'=>'float', 'par2'=>'float', 'par3'=>'float', 'par4'=>'float', 'which'=>'int'], 'stats_cdf_noncentral_t' => ['float', 'par1'=>'float', 'par2'=>'float', 'par3'=>'float', 'which'=>'int'], 'stats_cdf_normal' => ['float', 'par1'=>'float', 'par2'=>'float', 'par3'=>'float', 'which'=>'int'], 'stats_cdf_poisson' => ['float', 'par1'=>'float', 'par2'=>'float', 'which'=>'int'], 'stats_cdf_t' => ['float', 'par1'=>'float', 'par2'=>'float', 'which'=>'int'], 'stats_cdf_uniform' => ['float', 'par1'=>'float', 'par2'=>'float', 'par3'=>'float', 'which'=>'int'], 'stats_cdf_weibull' => ['float', 'par1'=>'float', 'par2'=>'float', 'par3'=>'float', 'which'=>'int'], 'stats_covariance' => ['float', 'a'=>'array', 'b'=>'array'], 'stats_den_uniform' => ['float', 'x'=>'float', 'a'=>'float', 'b'=>'float'], 'stats_dens_beta' => ['float', 'x'=>'float', 'a'=>'float', 'b'=>'float'], 'stats_dens_cauchy' => ['float', 'x'=>'float', 'ave'=>'float', 'stdev'=>'float'], 'stats_dens_chisquare' => ['float', 'x'=>'float', 'dfr'=>'float'], 'stats_dens_exponential' => ['float', 'x'=>'float', 'scale'=>'float'], 'stats_dens_f' => ['float', 'x'=>'float', 'dfr1'=>'float', 'dfr2'=>'float'], 'stats_dens_gamma' => ['float', 'x'=>'float', 'shape'=>'float', 'scale'=>'float'], 'stats_dens_laplace' => ['float', 'x'=>'float', 'ave'=>'float', 'stdev'=>'float'], 'stats_dens_logistic' => ['float', 'x'=>'float', 'ave'=>'float', 'stdev'=>'float'], 'stats_dens_negative_binomial' => ['float', 'x'=>'float', 'n'=>'float', 'pi'=>'float'], 'stats_dens_normal' => ['float', 'x'=>'float', 'ave'=>'float', 'stdev'=>'float'], 'stats_dens_pmf_binomial' => ['float', 'x'=>'float', 'n'=>'float', 'pi'=>'float'], 'stats_dens_pmf_hypergeometric' => ['float', 'n1'=>'float', 'n2'=>'float', 'N1'=>'float', 'N2'=>'float'], 'stats_dens_pmf_negative_binomial' => ['float', 'x'=>'float', 'n'=>'float', 'pi'=>'float'], 'stats_dens_pmf_poisson' => ['float', 'x'=>'float', 'lb'=>'float'], 'stats_dens_t' => ['float', 'x'=>'float', 'dfr'=>'float'], 'stats_dens_uniform' => ['float', 'x'=>'float', 'a'=>'float', 'b'=>'float'], 'stats_dens_weibull' => ['float', 'x'=>'float', 'a'=>'float', 'b'=>'float'], 'stats_harmonic_mean' => ['float', 'a'=>'array'], 'stats_kurtosis' => ['float', 'a'=>'array'], 'stats_rand_gen_beta' => ['float', 'a'=>'float', 'b'=>'float'], 'stats_rand_gen_chisquare' => ['float', 'df'=>'float'], 'stats_rand_gen_exponential' => ['float', 'av'=>'float'], 'stats_rand_gen_f' => ['float', 'dfn'=>'float', 'dfd'=>'float'], 'stats_rand_gen_funiform' => ['float', 'low'=>'float', 'high'=>'float'], 'stats_rand_gen_gamma' => ['float', 'a'=>'float', 'r'=>'float'], 'stats_rand_gen_ibinomial' => ['int', 'n'=>'int', 'pp'=>'float'], 'stats_rand_gen_ibinomial_negative' => ['int', 'n'=>'int', 'p'=>'float'], 'stats_rand_gen_int' => ['int'], 'stats_rand_gen_ipoisson' => ['int', 'mu'=>'float'], 'stats_rand_gen_iuniform' => ['int', 'low'=>'int', 'high'=>'int'], 'stats_rand_gen_noncenral_chisquare' => ['float', 'df'=>'float', 'xnonc'=>'float'], 'stats_rand_gen_noncentral_chisquare' => ['float', 'df'=>'float', 'xnonc'=>'float'], 'stats_rand_gen_noncentral_f' => ['float', 'dfn'=>'float', 'dfd'=>'float', 'xnonc'=>'float'], 'stats_rand_gen_noncentral_t' => ['float', 'df'=>'float', 'xnonc'=>'float'], 'stats_rand_gen_normal' => ['float', 'av'=>'float', 'sd'=>'float'], 'stats_rand_gen_t' => ['float', 'df'=>'float'], 'stats_rand_get_seeds' => ['array'], 'stats_rand_phrase_to_seeds' => ['array', 'phrase'=>'string'], 'stats_rand_ranf' => ['float'], 'stats_rand_setall' => ['void', 'iseed1'=>'int', 'iseed2'=>'int'], 'stats_skew' => ['float', 'a'=>'array'], 'stats_standard_deviation' => ['float', 'a'=>'array', 'sample='=>'bool'], 'stats_stat_binomial_coef' => ['float', 'x'=>'int', 'n'=>'int'], 'stats_stat_correlation' => ['float', 'arr1'=>'array', 'arr2'=>'array'], 'stats_stat_factorial' => ['float', 'n'=>'int'], 'stats_stat_gennch' => ['float', 'n'=>'int'], 'stats_stat_independent_t' => ['float', 'arr1'=>'array', 'arr2'=>'array'], 'stats_stat_innerproduct' => ['float', 'arr1'=>'array', 'arr2'=>'array'], 'stats_stat_noncentral_t' => ['float', 'par1'=>'float', 'par2'=>'float', 'par3'=>'float', 'which'=>'int'], 'stats_stat_paired_t' => ['float', 'arr1'=>'array', 'arr2'=>'array'], 'stats_stat_percentile' => ['float', 'df'=>'float', 'xnonc'=>'float'], 'stats_stat_powersum' => ['float', 'arr'=>'array', 'power'=>'float'], 'stats_variance' => ['float', 'a'=>'array', 'sample='=>'bool'], 'Stomp::__construct' => ['void', 'broker='=>'string', 'username='=>'string', 'password='=>'string', 'headers='=>'array'], 'Stomp::__destruct' => ['bool', 'link'=>''], 'Stomp::abort' => ['bool', 'transaction_id'=>'string', 'headers='=>'array', 'link='=>''], 'Stomp::ack' => ['bool', 'msg'=>'', 'headers='=>'array', 'link='=>''], 'Stomp::begin' => ['bool', 'transaction_id'=>'string', 'headers='=>'array', 'link='=>''], 'Stomp::commit' => ['bool', 'transaction_id'=>'string', 'headers='=>'array', 'link='=>''], 'Stomp::error' => ['string', 'link'=>''], 'Stomp::getReadTimeout' => ['array', 'link'=>''], 'Stomp::getSessionId' => ['string', 'link'=>''], 'Stomp::hasFrame' => ['bool', 'link'=>''], 'Stomp::readFrame' => ['array', 'class_name='=>'string', 'link='=>''], 'Stomp::send' => ['bool', 'destination'=>'string', 'msg'=>'', 'headers='=>'array', 'link='=>''], 'Stomp::setReadTimeout' => ['', 'seconds'=>'int', 'microseconds='=>'int', 'link='=>''], 'Stomp::subscribe' => ['bool', 'destination'=>'string', 'headers='=>'array', 'link='=>''], 'Stomp::unsubscribe' => ['bool', 'destination'=>'string', 'headers='=>'array', 'link='=>''], 'stomp_abort' => ['bool', 'transaction_id'=>'string', 'headers='=>'array', 'link='=>''], 'stomp_ack' => ['bool', 'msg'=>'', 'headers='=>'array', 'link='=>''], 'stomp_begin' => ['bool', 'transaction_id'=>'string', 'headers='=>'array', 'link='=>''], 'stomp_close' => ['bool', 'link'=>''], 'stomp_commit' => ['bool', 'transaction_id'=>'string', 'headers='=>'array', 'link='=>''], 'stomp_connect' => ['resource', 'broker='=>'string', 'username='=>'string', 'password='=>'string', 'headers='=>'array'], 'stomp_connect_error' => ['string'], 'stomp_error' => ['string', 'link'=>''], 'stomp_get_read_timeout' => ['array', 'link'=>''], 'stomp_get_session_id' => ['string', 'link'=>''], 'stomp_has_frame' => ['bool', 'link'=>''], 'stomp_read_frame' => ['array', 'class_name='=>'string', 'link='=>''], 'stomp_send' => ['bool', 'destination'=>'string', 'msg'=>'', 'headers='=>'array', 'link='=>''], 'stomp_set_read_timeout' => ['', 'seconds'=>'int', 'microseconds='=>'int', 'link='=>''], 'stomp_subscribe' => ['bool', 'destination'=>'string', 'headers='=>'array', 'link='=>''], 'stomp_unsubscribe' => ['bool', 'destination'=>'string', 'headers='=>'array', 'link='=>''], 'stomp_version' => ['string'], 'StompException::getDetails' => ['string'], 'StompFrame::__construct' => ['void', 'command='=>'string', 'headers='=>'array', 'body='=>'string'], 'str_getcsv' => ['non-empty-list<?string>', 'input'=>'string', 'delimiter='=>'string', 'enclosure='=>'string', 'escape='=>'string'], 'str_ireplace' => ['string|string[]', 'search'=>'string|array', 'replace'=>'string|array', 'subject'=>'string|array', '&w_replace_count='=>'int'], 'str_pad' => ['string', 'input'=>'string', 'pad_length'=>'int', 'pad_string='=>'string', 'pad_type='=>'int'], 'str_repeat' => ['string', 'input'=>'string', 'multiplier'=>'int'], 'str_replace' => ['string|array', 'search'=>'string|array', 'replace'=>'string|array', 'subject'=>'string|array', '&w_replace_count='=>'int'], 'str_rot13' => ['string', 'str'=>'string'], 'str_shuffle' => ['string', 'str'=>'string'], 'str_split' => ['non-empty-list<string>|false', 'str'=>'string', 'split_length='=>'positive-int'], 'str_word_count' => ['array<int,string>|int|false', 'string'=>'string', 'format='=>'int', 'charlist='=>'string'], 'strcasecmp' => ['int<-1, 1>', 'str1'=>'string', 'str2'=>'string'], 'strchr' => ['string|false', 'haystack'=>'string', 'needle'=>'string', 'before_needle='=>'bool'], 'strcmp' => ['int<-1, 1>', 'str1'=>'string', 'str2'=>'string'], 'strcoll' => ['int<-1, 1>', 'str1'=>'string', 'str2'=>'string'], 'strcspn' => ['int', 'str'=>'string', 'mask'=>'string', 'start='=>'int', 'length='=>'int'], 'stream_bucket_append' => ['void', 'brigade'=>'resource', 'bucket'=>'object'], 'stream_bucket_make_writeable' => ['stdClass|null', 'brigade'=>'resource'], 'stream_bucket_new' => ['object', 'stream'=>'resource', 'buffer'=>'string'], 'stream_bucket_prepend' => ['void', 'brigade'=>'resource', 'bucket'=>'object'], 'stream_context_create' => ['resource', 'options='=>'array', 'params='=>'array'], 'stream_context_get_default' => ['resource', 'options='=>'array'], 'stream_context_get_options' => ['array', 'context'=>'resource'], 'stream_context_get_params' => ['array{notification:string, options:array<mixed>}', 'context'=>'resource'], 'stream_context_set_default' => ['resource', 'options'=>'array'], 'stream_context_set_option' => ['bool', 'context'=>'', 'wrappername'=>'string', 'optionname'=>'string', 'value'=>''], 'stream_context_set_option\'1' => ['bool', 'context'=>'', 'options'=>'array'], 'stream_context_set_params' => ['bool', 'context'=>'resource', 'options'=>'array'], 'stream_copy_to_stream' => ['int|false', 'source'=>'resource', 'dest'=>'resource', 'maxlen='=>'int', 'pos='=>'int'], 'stream_encoding' => ['bool', 'stream'=>'resource', 'encoding='=>'string'], 'stream_filter_append' => ['resource|false', 'stream'=>'resource', 'filtername'=>'string', 'read_write='=>'int', 'filterparams='=>'array'], 'stream_filter_prepend' => ['resource|false', 'stream'=>'resource', 'filtername'=>'string', 'read_write='=>'int', 'filterparams='=>'array'], 'stream_filter_register' => ['bool', 'filtername'=>'string', 'classname'=>'string'], 'stream_filter_remove' => ['bool', 'stream_filter'=>'resource'], 'stream_get_contents' => ['string|false', 'source'=>'resource', 'maxlen='=>'int', 'offset='=>'int'], 'stream_get_filters' => ['list<string>'], 'stream_get_line' => ['string|false', 'stream'=>'resource', 'maxlen'=>'int', 'ending='=>'string'], 'stream_get_meta_data' => ['array{timed_out:bool,blocked:bool,eof:bool,unread_bytes:int,stream_type:string,wrapper_type:string,wrapper_data:mixed,mode:string,seekable:bool,uri?:string,mediatype?:string,base64?:bool}', 'fp'=>'resource'], 'stream_get_transports' => ['list<string>'], 'stream_get_wrappers' => ['list<string>'], 'stream_is_local' => ['bool', 'stream'=>'resource|string'], 'stream_isatty' => ['bool', 'stream'=>'resource'], 'stream_notification_callback' => ['callback', 'notification_code'=>'int', 'severity'=>'int', 'message'=>'string', 'message_code'=>'int', 'bytes_transferred'=>'int', 'bytes_max'=>'int'], 'stream_resolve_include_path' => ['string|false', 'filename'=>'string'], 'stream_select' => ['int|false', '&rw_read_streams'=>'resource[]|null', '&rw_write_streams'=>'resource[]|null', '&rw_except_streams'=>'resource[]|null', 'tv_sec'=>'?int', 'tv_usec='=>'?int'], 'stream_set_blocking' => ['bool', 'socket'=>'resource', 'mode'=>'bool'], 'stream_set_chunk_size' => ['int|false', 'fp'=>'resource', 'chunk_size'=>'int'], 'stream_set_read_buffer' => ['int', 'fp'=>'resource', 'buffer'=>'int'], 'stream_set_timeout' => ['bool', 'stream'=>'resource', 'seconds'=>'int', 'microseconds='=>'int'], 'stream_set_write_buffer' => ['int', 'fp'=>'resource', 'buffer'=>'int'], 'stream_socket_accept' => ['resource|false', 'serverstream'=>'resource', 'timeout='=>'float', '&w_peername='=>'string'], 'stream_socket_client' => ['resource|false', 'remoteaddress'=>'string', '&w_errcode='=>'int', '&w_errstring='=>'string', 'timeout='=>'float', 'flags='=>'int', 'context='=>'resource'], 'stream_socket_enable_crypto' => ['0|bool', 'stream'=>'resource', 'enable'=>'bool', 'cryptokind='=>'int', 'sessionstream='=>'resource'], 'stream_socket_get_name' => ['string|false', 'stream'=>'resource', 'want_peer'=>'bool'], 'stream_socket_pair' => ['resource[]|false', 'domain'=>'int', 'type'=>'int', 'protocol'=>'int'], 'stream_socket_recvfrom' => ['string|false', 'stream'=>'resource', 'amount'=>'int', 'flags='=>'int', '&w_remote_addr='=>'string'], 'stream_socket_sendto' => ['int|false', 'stream'=>'resource', 'data'=>'string', 'flags='=>'int', 'target_addr='=>'string'], 'stream_socket_server' => ['resource|false', 'localaddress'=>'string', '&w_errcode='=>'int', '&w_errstring='=>'string', 'flags='=>'int', 'context='=>'resource'], 'stream_socket_shutdown' => ['bool', 'stream'=>'resource', 'how'=>'int'], 'stream_supports_lock' => ['bool', 'stream'=>'resource'], 'stream_wrapper_register' => ['bool', 'protocol'=>'string', 'classname'=>'string', 'flags='=>'int'], 'stream_wrapper_restore' => ['bool', 'protocol'=>'string'], 'stream_wrapper_unregister' => ['bool', 'protocol'=>'string'], 'streamWrapper::__construct' => ['void'], 'streamWrapper::__destruct' => [''], 'streamWrapper::dir_closedir' => ['bool'], 'streamWrapper::dir_opendir' => ['bool', 'path'=>'string', 'options'=>'int'], 'streamWrapper::dir_readdir' => ['string'], 'streamWrapper::dir_rewinddir' => ['bool'], 'streamWrapper::mkdir' => ['bool', 'path'=>'string', 'mode'=>'int', 'options'=>'int'], 'streamWrapper::rename' => ['bool', 'path_from'=>'string', 'path_to'=>'string'], 'streamWrapper::rmdir' => ['bool', 'path'=>'string', 'options'=>'int'], 'streamWrapper::stream_cast' => ['resource', 'cast_as'=>'int'], 'streamWrapper::stream_close' => ['void'], 'streamWrapper::stream_eof' => ['bool'], 'streamWrapper::stream_flush' => ['bool'], 'streamWrapper::stream_lock' => ['bool', 'operation'=>'mode'], 'streamWrapper::stream_metadata' => ['bool', 'path'=>'string', 'option'=>'int', 'value'=>'mixed'], 'streamWrapper::stream_open' => ['bool', 'path'=>'string', 'mode'=>'string', 'options'=>'int', 'opened_path'=>'string'], 'streamWrapper::stream_read' => ['string', 'count'=>'int'], 'streamWrapper::stream_seek' => ['bool', 'offset'=>'int', 'whence'=>'int'], 'streamWrapper::stream_set_option' => ['bool', 'option'=>'int', 'arg1'=>'int', 'arg2'=>'int'], 'streamWrapper::stream_stat' => ['array'], 'streamWrapper::stream_tell' => ['int'], 'streamWrapper::stream_truncate' => ['bool', 'new_size'=>'int'], 'streamWrapper::stream_write' => ['int', 'data'=>'string'], 'streamWrapper::unlink' => ['bool', 'path'=>'string'], 'streamWrapper::url_stat' => ['array', 'path'=>'string', 'flags'=>'int'], 'strftime' => ['string|false', 'format'=>'string', 'timestamp='=>'int'], 'strip_tags' => ['string', 'str'=>'string', 'allowable_tags='=>'string'], 'stripcslashes' => ['string', 'str'=>'string'], 'stripos' => ['0|positive-int|false', 'haystack'=>'string', 'needle'=>'string|int', 'offset='=>'int'], 'stripslashes' => ['string', 'str'=>'string'], 'stristr' => ['string|false', 'haystack'=>'string', 'needle'=>'mixed', 'before_needle='=>'bool'], 'strlen' => ['0|positive-int', 'string'=>'string'], 'strnatcasecmp' => ['int<-1, 1>', 's1'=>'string', 's2'=>'string'], 'strnatcmp' => ['int<-1, 1>', 's1'=>'string', 's2'=>'string'], 'strncasecmp' => ['int<-1, 1>', 'str1'=>'string', 'str2'=>'string', 'len'=>'int'], 'strncmp' => ['int<-1, 1>', 'str1'=>'string', 'str2'=>'string', 'len'=>'int'], 'strpbrk' => ['string|false', 'haystack'=>'string', 'char_list'=>'string'], 'strpos' => ['positive-int|0|false', 'haystack'=>'string', 'needle'=>'string|int', 'offset='=>'int'], 'strptime' => ['array|false', 'datestr'=>'string', 'format'=>'string'], 'strrchr' => ['string|false', 'haystack'=>'string', 'needle'=>'mixed'], 'strrev' => ['string', 'str'=>'string'], 'strripos' => ['0|positive-int|false', 'haystack'=>'string', 'needle'=>'string|int', 'offset='=>'int'], 'strrpos' => ['0|positive-int|false', 'haystack'=>'string', 'needle'=>'string|int', 'offset='=>'int'], 'strspn' => ['int', 'str'=>'string', 'mask'=>'string', 'start='=>'int', 'len='=>'int'], 'strstr' => ['string|false', 'haystack'=>'string', 'needle'=>'mixed', 'before_needle='=>'bool'], 'strtok' => ['non-empty-string|false', 'str'=>'string', 'token'=>'string'], 'strtok\'1' => ['non-empty-string|false', 'token'=>'string'], 'strtolower' => ['lowercase-string', 'str'=>'string'], 'strtotime' => ['int|false', 'time'=>'string', 'now='=>'int'], 'strtoupper' => ['uppercase-string', 'str'=>'string'], 'strtr' => ['string', 'str'=>'string', 'from'=>'string', 'to'=>'string'], 'strtr\'1' => ['string', 'str'=>'string', 'replace_pairs'=>'array'], 'strval' => ['string', 'var'=>'__stringAndStringable|int|float|bool|resource|null'], 'substr' => ['__benevolent<string|false>', 'string'=>'string', 'start'=>'int', 'length='=>'int'], 'substr_compare' => ['int<-1, 1>|false', 'main_str'=>'string', 'str'=>'string', 'offset'=>'int', 'length='=>'int', 'case_sensitivity='=>'bool'], 'substr_count' => ['0|positive-int', 'haystack'=>'string', 'needle'=>'string', 'offset='=>'int', 'length='=>'int'], 'substr_replace' => ['string|array', 'str'=>'string|array', 'repl'=>'mixed', 'start'=>'mixed', 'length='=>'mixed'], 'suhosin_encrypt_cookie' => ['string', 'name'=>'string', 'value'=>'string'], 'suhosin_get_raw_cookies' => ['array'], 'SVM::__construct' => ['void'], 'svm::crossvalidate' => ['float', 'problem'=>'array', 'number_of_folds'=>'int'], 'SVM::getOptions' => ['array'], 'SVM::setOptions' => ['bool', 'params'=>'array'], 'svm::train' => ['SVMModel', 'problem'=>'array', 'weights='=>'array'], 'SVMModel::__construct' => ['void', 'filename='=>'string'], 'SVMModel::checkProbabilityModel' => ['bool'], 'SVMModel::getLabels' => ['array'], 'SVMModel::getNrClass' => ['int'], 'SVMModel::getSvmType' => ['int'], 'SVMModel::getSvrProbability' => ['float'], 'SVMModel::load' => ['bool', 'filename'=>'string'], 'SVMModel::predict' => ['float', 'data'=>'array'], 'SVMModel::predict_probability' => ['float', 'data'=>'array'], 'SVMModel::save' => ['bool', 'filename'=>'string'], 'svn_add' => ['bool', 'path'=>'string', 'recursive='=>'bool', 'force='=>'bool'], 'svn_auth_get_parameter' => ['string', 'key'=>'string'], 'svn_auth_set_parameter' => ['void', 'key'=>'string', 'value'=>'string'], 'svn_blame' => ['array', 'repository_url'=>'string', 'revision_no='=>'int'], 'svn_cat' => ['string', 'repos_url'=>'string', 'revision_no='=>'int'], 'svn_checkout' => ['bool', 'repos'=>'string', 'targetpath'=>'string', 'revision='=>'int', 'flags='=>'int'], 'svn_cleanup' => ['bool', 'workingdir'=>'string'], 'svn_client_version' => ['string'], 'svn_commit' => ['array', 'log'=>'string', 'targets'=>'array', 'dontrecurse='=>'bool'], 'svn_delete' => ['bool', 'path'=>'string', 'force='=>'bool'], 'svn_diff' => ['array', 'path1'=>'string', 'rev1'=>'int', 'path2'=>'string', 'rev2'=>'int'], 'svn_export' => ['bool', 'frompath'=>'string', 'topath'=>'string', 'working_copy='=>'bool', 'revision_no='=>'int'], 'svn_fs_abort_txn' => ['bool', 'txn'=>'resource'], 'svn_fs_apply_text' => ['resource', 'root'=>'resource', 'path'=>'string'], 'svn_fs_begin_txn2' => ['resource', 'repos'=>'resource', 'rev'=>'int'], 'svn_fs_change_node_prop' => ['bool', 'root'=>'resource', 'path'=>'string', 'name'=>'string', 'value'=>'string'], 'svn_fs_check_path' => ['int', 'fsroot'=>'resource', 'path'=>'string'], 'svn_fs_contents_changed' => ['bool', 'root1'=>'resource', 'path1'=>'string', 'root2'=>'resource', 'path2'=>'string'], 'svn_fs_copy' => ['bool', 'from_root'=>'resource', 'from_path'=>'string', 'to_root'=>'resource', 'to_path'=>'string'], 'svn_fs_delete' => ['bool', 'root'=>'resource', 'path'=>'string'], 'svn_fs_dir_entries' => ['array', 'fsroot'=>'resource', 'path'=>'string'], 'svn_fs_file_contents' => ['resource', 'fsroot'=>'resource', 'path'=>'string'], 'svn_fs_file_length' => ['int', 'fsroot'=>'resource', 'path'=>'string'], 'svn_fs_is_dir' => ['bool', 'root'=>'resource', 'path'=>'string'], 'svn_fs_is_file' => ['bool', 'root'=>'resource', 'path'=>'string'], 'svn_fs_make_dir' => ['bool', 'root'=>'resource', 'path'=>'string'], 'svn_fs_make_file' => ['bool', 'root'=>'resource', 'path'=>'string'], 'svn_fs_node_created_rev' => ['int', 'fsroot'=>'resource', 'path'=>'string'], 'svn_fs_node_prop' => ['string', 'fsroot'=>'resource', 'path'=>'string', 'propname'=>'string'], 'svn_fs_props_changed' => ['bool', 'root1'=>'resource', 'path1'=>'string', 'root2'=>'resource', 'path2'=>'string'], 'svn_fs_revision_prop' => ['string', 'fs'=>'resource', 'revnum'=>'int', 'propname'=>'string'], 'svn_fs_revision_root' => ['resource', 'fs'=>'resource', 'revnum'=>'int'], 'svn_fs_txn_root' => ['resource', 'txn'=>'resource'], 'svn_fs_youngest_rev' => ['int', 'fs'=>'resource'], 'svn_import' => ['bool', 'path'=>'string', 'url'=>'string', 'nonrecursive'=>'bool'], 'svn_log' => ['array', 'repos_url'=>'string', 'start_revision='=>'int', 'end_revision='=>'int', 'limit='=>'int', 'flags='=>'int'], 'svn_ls' => ['array', 'repos_url'=>'string', 'revision_no='=>'int', 'recurse='=>'bool', 'peg='=>'bool'], 'svn_mkdir' => ['bool', 'path'=>'string', 'log_message='=>'string'], 'svn_move' => ['mixed', 'src_path'=>'string', 'dst_path'=>'string', 'force='=>'bool|false'], 'svn_propget' => ['mixed', 'path'=>'string', 'property_name'=>'string', 'recurse='=>'bool|false', 'revision='=>'int'], 'svn_proplist' => ['mixed', 'path'=>'string', 'recurse='=>'bool|false', 'revision='=>'int'], 'svn_repos_create' => ['resource', 'path'=>'string', 'config='=>'array', 'fsconfig='=>'array'], 'svn_repos_fs' => ['resource', 'repos'=>'resource'], 'svn_repos_fs_begin_txn_for_commit' => ['resource', 'repos'=>'resource', 'rev'=>'int', 'author'=>'string', 'log_msg'=>'string'], 'svn_repos_fs_commit_txn' => ['int', 'txn'=>'resource'], 'svn_repos_hotcopy' => ['bool', 'repospath'=>'string', 'destpath'=>'string', 'cleanlogs'=>'bool'], 'svn_repos_open' => ['resource', 'path'=>'string'], 'svn_repos_recover' => ['bool', 'path'=>'string'], 'svn_revert' => ['bool', 'path'=>'string', 'recursive='=>'bool'], 'svn_status' => ['array', 'path'=>'string', 'flags='=>'int'], 'svn_update' => ['int', 'path'=>'string', 'revno='=>'int', 'recurse='=>'bool'], 'swf_actiongeturl' => ['', 'url'=>'string', 'target'=>'string'], 'swf_actiongotoframe' => ['', 'framenumber'=>'int'], 'swf_actiongotolabel' => ['', 'label'=>'string'], 'swf_actionnextframe' => [''], 'swf_actionplay' => [''], 'swf_actionprevframe' => [''], 'swf_actionsettarget' => ['', 'target'=>'string'], 'swf_actionstop' => [''], 'swf_actiontogglequality' => [''], 'swf_actionwaitforframe' => ['', 'framenumber'=>'int', 'skipcount'=>'int'], 'swf_addbuttonrecord' => ['', 'states'=>'int', 'shapeid'=>'int', 'depth'=>'int'], 'swf_addcolor' => ['', 'r'=>'float', 'g'=>'float', 'b'=>'float', 'a'=>'float'], 'swf_closefile' => ['', 'return_file='=>'int'], 'swf_definebitmap' => ['', 'objid'=>'int', 'image_name'=>'string'], 'swf_definefont' => ['', 'fontid'=>'int', 'fontname'=>'string'], 'swf_defineline' => ['', 'objid'=>'int', 'x1'=>'float', 'y1'=>'float', 'x2'=>'float', 'y2'=>'float', 'width'=>'float'], 'swf_definepoly' => ['', 'objid'=>'int', 'coords'=>'array', 'npoints'=>'int', 'width'=>'float'], 'swf_definerect' => ['', 'objid'=>'int', 'x1'=>'float', 'y1'=>'float', 'x2'=>'float', 'y2'=>'float', 'width'=>'float'], 'swf_definetext' => ['', 'objid'=>'int', 'str'=>'string', 'docenter'=>'int'], 'swf_endbutton' => [''], 'swf_enddoaction' => [''], 'swf_endshape' => [''], 'swf_endsymbol' => [''], 'swf_fontsize' => ['', 'size'=>'float'], 'swf_fontslant' => ['', 'slant'=>'float'], 'swf_fonttracking' => ['', 'tracking'=>'float'], 'swf_getbitmapinfo' => ['array', 'bitmapid'=>'int'], 'swf_getfontinfo' => ['array'], 'swf_getframe' => ['int'], 'swf_labelframe' => ['', 'name'=>'string'], 'swf_lookat' => ['', 'view_x'=>'float', 'view_y'=>'float', 'view_z'=>'float', 'reference_x'=>'float', 'reference_y'=>'float', 'reference_z'=>'float', 'twist'=>'float'], 'swf_modifyobject' => ['', 'depth'=>'int', 'how'=>'int'], 'swf_mulcolor' => ['', 'r'=>'float', 'g'=>'float', 'b'=>'float', 'a'=>'float'], 'swf_nextid' => ['int'], 'swf_oncondition' => ['', 'transition'=>'int'], 'swf_openfile' => ['', 'filename'=>'string', 'width'=>'float', 'height'=>'float', 'framerate'=>'float', 'r'=>'float', 'g'=>'float', 'b'=>'float'], 'swf_ortho' => ['', 'xmin'=>'float', 'xmax'=>'float', 'ymin'=>'float', 'ymax'=>'float', 'zmin'=>'float', 'zmax'=>'float'], 'swf_ortho2' => ['', 'xmin'=>'float', 'xmax'=>'float', 'ymin'=>'float', 'ymax'=>'float'], 'swf_perspective' => ['', 'fovy'=>'float', 'aspect'=>'float', 'near'=>'float', 'far'=>'float'], 'swf_placeobject' => ['', 'objid'=>'int', 'depth'=>'int'], 'swf_polarview' => ['', 'dist'=>'float', 'azimuth'=>'float', 'incidence'=>'float', 'twist'=>'float'], 'swf_popmatrix' => [''], 'swf_posround' => ['', 'round'=>'int'], 'swf_pushmatrix' => [''], 'swf_removeobject' => ['', 'depth'=>'int'], 'swf_rotate' => ['', 'angle'=>'float', 'axis'=>'string'], 'swf_scale' => ['', 'x'=>'float', 'y'=>'float', 'z'=>'float'], 'swf_setfont' => ['', 'fontid'=>'int'], 'swf_setframe' => ['', 'framenumber'=>'int'], 'swf_shapearc' => ['', 'x'=>'float', 'y'=>'float', 'r'=>'float', 'ang1'=>'float', 'ang2'=>'float'], 'swf_shapecurveto' => ['', 'x1'=>'float', 'y1'=>'float', 'x2'=>'float', 'y2'=>'float'], 'swf_shapecurveto3' => ['', 'x1'=>'float', 'y1'=>'float', 'x2'=>'float', 'y2'=>'float', 'x3'=>'float', 'y3'=>'float'], 'swf_shapefillbitmapclip' => ['', 'bitmapid'=>'int'], 'swf_shapefillbitmaptile' => ['', 'bitmapid'=>'int'], 'swf_shapefilloff' => [''], 'swf_shapefillsolid' => ['', 'r'=>'float', 'g'=>'float', 'b'=>'float', 'a'=>'float'], 'swf_shapelinesolid' => ['', 'r'=>'float', 'g'=>'float', 'b'=>'float', 'a'=>'float', 'width'=>'float'], 'swf_shapelineto' => ['', 'x'=>'float', 'y'=>'float'], 'swf_shapemoveto' => ['', 'x'=>'float', 'y'=>'float'], 'swf_showframe' => [''], 'swf_startbutton' => ['', 'objid'=>'int', 'type'=>'int'], 'swf_startdoaction' => [''], 'swf_startshape' => ['', 'objid'=>'int'], 'swf_startsymbol' => ['', 'objid'=>'int'], 'swf_textwidth' => ['float', 'str'=>'string'], 'swf_translate' => ['', 'x'=>'float', 'y'=>'float', 'z'=>'float'], 'swf_viewport' => ['', 'xmin'=>'float', 'xmax'=>'float', 'ymin'=>'float', 'ymax'=>'float'], 'SWFAction::__construct' => ['void', 'script'=>'string'], 'SWFBitmap::__construct' => ['void', 'file'=>'', 'alphafile='=>''], 'SWFBitmap::getHeight' => ['float'], 'SWFBitmap::getWidth' => ['float'], 'SWFButton::__construct' => ['void'], 'SWFButton::addAction' => ['void', 'action'=>'swfaction', 'flags'=>'int'], 'SWFButton::addASound' => ['SWFSoundInstance', 'sound'=>'swfsound', 'flags'=>'int'], 'SWFButton::addShape' => ['void', 'shape'=>'swfshape', 'flags'=>'int'], 'SWFButton::setAction' => ['void', 'action'=>'swfaction'], 'SWFButton::setDown' => ['void', 'shape'=>'swfshape'], 'SWFButton::setHit' => ['void', 'shape'=>'swfshape'], 'SWFButton::setMenu' => ['void', 'flag'=>'int'], 'SWFButton::setOver' => ['void', 'shape'=>'swfshape'], 'SWFButton::setUp' => ['void', 'shape'=>'swfshape'], 'SWFDisplayItem::addAction' => ['void', 'action'=>'swfaction', 'flags'=>'int'], 'SWFDisplayItem::addColor' => ['void', 'red'=>'int', 'green'=>'int', 'blue'=>'int', 'a='=>'int'], 'SWFDisplayItem::endMask' => ['void'], 'SWFDisplayItem::getRot' => ['float'], 'SWFDisplayItem::getX' => ['float'], 'SWFDisplayItem::getXScale' => ['float'], 'SWFDisplayItem::getXSkew' => ['float'], 'SWFDisplayItem::getY' => ['float'], 'SWFDisplayItem::getYScale' => ['float'], 'SWFDisplayItem::getYSkew' => ['float'], 'SWFDisplayItem::move' => ['void', 'dx'=>'float', 'dy'=>'float'], 'SWFDisplayItem::moveTo' => ['void', 'x'=>'float', 'y'=>'float'], 'SWFDisplayItem::multColor' => ['void', 'red'=>'float', 'green'=>'float', 'blue'=>'float', 'a='=>'float'], 'SWFDisplayItem::remove' => ['void'], 'SWFDisplayItem::rotate' => ['void', 'angle'=>'float'], 'SWFDisplayItem::rotateTo' => ['void', 'angle'=>'float'], 'SWFDisplayItem::scale' => ['void', 'dx'=>'float', 'dy'=>'float'], 'SWFDisplayItem::scaleTo' => ['void', 'x'=>'float', 'y='=>'float'], 'SWFDisplayItem::setDepth' => ['void', 'depth'=>'int'], 'SWFDisplayItem::setMaskLevel' => ['void', 'level'=>'int'], 'SWFDisplayItem::setMatrix' => ['void', 'a'=>'float', 'b'=>'float', 'c'=>'float', 'd'=>'float', 'x'=>'float', 'y'=>'float'], 'SWFDisplayItem::setName' => ['void', 'name'=>'string'], 'SWFDisplayItem::setRatio' => ['void', 'ratio'=>'float'], 'SWFDisplayItem::skewX' => ['void', 'ddegrees'=>'float'], 'SWFDisplayItem::skewXTo' => ['void', 'degrees'=>'float'], 'SWFDisplayItem::skewY' => ['void', 'ddegrees'=>'float'], 'SWFDisplayItem::skewYTo' => ['void', 'degrees'=>'float'], 'SWFFill::moveTo' => ['void', 'x'=>'float', 'y'=>'float'], 'SWFFill::rotateTo' => ['void', 'angle'=>'float'], 'SWFFill::scaleTo' => ['void', 'x'=>'float', 'y='=>'float'], 'SWFFill::skewXTo' => ['void', 'x'=>'float'], 'SWFFill::skewYTo' => ['void', 'y'=>'float'], 'SWFFont::__construct' => ['void', 'filename'=>'string'], 'SWFFont::getAscent' => ['float'], 'SWFFont::getDescent' => ['float'], 'SWFFont::getLeading' => ['float'], 'SWFFont::getShape' => ['string', 'code'=>'int'], 'SWFFont::getUTF8Width' => ['float', 'string'=>'string'], 'SWFFont::getWidth' => ['float', 'string'=>'string'], 'SWFFontChar::addChars' => ['void', 'char'=>'string'], 'SWFFontChar::addUTF8Chars' => ['void', 'char'=>'string'], 'SWFGradient::__construct' => ['void'], 'SWFGradient::addEntry' => ['void', 'ratio'=>'float', 'red'=>'int', 'green'=>'int', 'blue'=>'int', 'alpha='=>'int'], 'SWFMorph::__construct' => ['void'], 'SWFMorph::getShape1' => ['SWFShape'], 'SWFMorph::getShape2' => ['SWFShape'], 'SWFMovie::__construct' => ['void', 'version='=>'int'], 'SWFMovie::add' => ['mixed', 'instance'=>'object'], 'SWFMovie::addExport' => ['void', 'char'=>'swfcharacter', 'name'=>'string'], 'SWFMovie::addFont' => ['mixed', 'font'=>'swffont'], 'SWFMovie::importChar' => ['SWFSprite', 'libswf'=>'string', 'name'=>'string'], 'SWFMovie::importFont' => ['SWFFontChar', 'libswf'=>'string', 'name'=>'string'], 'SWFMovie::labelFrame' => ['void', 'label'=>'string'], 'SWFMovie::nextFrame' => ['void'], 'SWFMovie::output' => ['int', 'compression='=>'int'], 'SWFMovie::remove' => ['void', 'instance'=>'object'], 'SWFMovie::save' => ['int', 'filename'=>'string', 'compression='=>'int'], 'SWFMovie::saveToFile' => ['int', 'x'=>'resource', 'compression='=>'int'], 'SWFMovie::setbackground' => ['void', 'red'=>'int', 'green'=>'int', 'blue'=>'int'], 'SWFMovie::setDimension' => ['void', 'width'=>'float', 'height'=>'float'], 'SWFMovie::setFrames' => ['void', 'number'=>'int'], 'SWFMovie::setRate' => ['void', 'rate'=>'float'], 'SWFMovie::startSound' => ['SWFSoundInstance', 'sound'=>'swfsound'], 'SWFMovie::stopSound' => ['void', 'sound'=>'swfsound'], 'SWFMovie::streamMP3' => ['int', 'mp3file'=>'mixed', 'skip='=>'float'], 'SWFMovie::writeExports' => ['void'], 'SWFPrebuiltClip::__construct' => ['void', 'file'=>''], 'SWFShape::__construct' => ['void'], 'SWFShape::addFill' => ['SWFFill', 'red'=>'int', 'green'=>'int', 'blue'=>'int', 'alpha='=>'int', 'bitmap='=>'swfbitmap', 'flags='=>'int', 'gradient='=>'swfgradient'], 'SWFShape::addFill\'1' => ['SWFFill', 'bitmap'=>'SWFBitmap', 'flags='=>'int'], 'SWFShape::addFill\'2' => ['SWFFill', 'gradient'=>'SWFGradient', 'flags='=>'int'], 'SWFShape::drawArc' => ['void', 'r'=>'float', 'startangle'=>'float', 'endangle'=>'float'], 'SWFShape::drawCircle' => ['void', 'r'=>'float'], 'SWFShape::drawCubic' => ['int', 'bx'=>'float', 'by'=>'float', 'cx'=>'float', 'cy'=>'float', 'dx'=>'float', 'dy'=>'float'], 'SWFShape::drawCubicTo' => ['int', 'bx'=>'float', 'by'=>'float', 'cx'=>'float', 'cy'=>'float', 'dx'=>'float', 'dy'=>'float'], 'SWFShape::drawCurve' => ['int', 'controldx'=>'float', 'controldy'=>'float', 'anchordx'=>'float', 'anchordy'=>'float', 'targetdx='=>'float', 'targetdy='=>'float'], 'SWFShape::drawCurveTo' => ['int', 'controlx'=>'float', 'controly'=>'float', 'anchorx'=>'float', 'anchory'=>'float', 'targetx='=>'float', 'targety='=>'float'], 'SWFShape::drawGlyph' => ['void', 'font'=>'swffont', 'character'=>'string', 'size='=>'int'], 'SWFShape::drawLine' => ['void', 'dx'=>'float', 'dy'=>'float'], 'SWFShape::drawLineTo' => ['void', 'x'=>'float', 'y'=>'float'], 'SWFShape::movePen' => ['void', 'dx'=>'float', 'dy'=>'float'], 'SWFShape::movePenTo' => ['void', 'x'=>'float', 'y'=>'float'], 'SWFShape::setLeftFill' => ['', 'fill'=>'swfgradient', 'red'=>'int', 'green'=>'int', 'blue'=>'int', 'a='=>'int'], 'SWFShape::setLine' => ['', 'shape'=>'swfshape', 'width'=>'int', 'red'=>'int', 'green'=>'int', 'blue'=>'int', 'a='=>'int'], 'SWFShape::setRightFill' => ['', 'fill'=>'swfgradient', 'red'=>'int', 'green'=>'int', 'blue'=>'int', 'a='=>'int'], 'SWFSound' => ['SWFSound', 'filename'=>'string', 'flags='=>'int'], 'SWFSound::__construct' => ['void', 'filename'=>'string', 'flags='=>'int'], 'SWFSoundInstance::loopCount' => ['void', 'point'=>'int'], 'SWFSoundInstance::loopInPoint' => ['void', 'point'=>'int'], 'SWFSoundInstance::loopOutPoint' => ['void', 'point'=>'int'], 'SWFSoundInstance::noMultiple' => ['void'], 'SWFSprite::__construct' => ['void'], 'SWFSprite::add' => ['void', 'object'=>'object'], 'SWFSprite::labelFrame' => ['void', 'label'=>'string'], 'SWFSprite::nextFrame' => ['void'], 'SWFSprite::remove' => ['void', 'object'=>'object'], 'SWFSprite::setFrames' => ['void', 'number'=>'int'], 'SWFSprite::startSound' => ['SWFSoundInstance', 'sount'=>'swfsound'], 'SWFSprite::stopSound' => ['void', 'sount'=>'swfsound'], 'SWFText::__construct' => ['void'], 'SWFText::addString' => ['void', 'string'=>'string'], 'SWFText::addUTF8String' => ['void', 'text'=>'string'], 'SWFText::getAscent' => ['float'], 'SWFText::getDescent' => ['float'], 'SWFText::getLeading' => ['float'], 'SWFText::getUTF8Width' => ['float', 'string'=>'string'], 'SWFText::getWidth' => ['float', 'string'=>'string'], 'SWFText::moveTo' => ['void', 'x'=>'float', 'y'=>'float'], 'SWFText::setColor' => ['void', 'red'=>'int', 'green'=>'int', 'blue'=>'int', 'a='=>'int'], 'SWFText::setFont' => ['void', 'font'=>'swffont'], 'SWFText::setHeight' => ['void', 'height'=>'float'], 'SWFText::setSpacing' => ['void', 'spacing'=>'float'], 'SWFTextField::__construct' => ['void', 'flags='=>'int'], 'SWFTextField::addChars' => ['void', 'chars'=>'string'], 'SWFTextField::addString' => ['void', 'string'=>'string'], 'SWFTextField::align' => ['void', 'alignement'=>'int'], 'SWFTextField::setBounds' => ['void', 'width'=>'float', 'height'=>'float'], 'SWFTextField::setColor' => ['void', 'red'=>'int', 'green'=>'int', 'blue'=>'int', 'a='=>'int'], 'SWFTextField::setFont' => ['void', 'font'=>'swffont'], 'SWFTextField::setHeight' => ['void', 'height'=>'float'], 'SWFTextField::setIndentation' => ['void', 'width'=>'float'], 'SWFTextField::setLeftMargin' => ['void', 'width'=>'float'], 'SWFTextField::setLineSpacing' => ['void', 'height'=>'float'], 'SWFTextField::setMargins' => ['void', 'left'=>'float', 'right'=>'float'], 'SWFTextField::setName' => ['void', 'name'=>'string'], 'SWFTextField::setPadding' => ['void', 'padding'=>'float'], 'SWFTextField::setRightMargin' => ['void', 'width'=>'float'], 'SWFVideoStream::__construct' => ['void', 'file='=>'string'], 'SWFVideoStream::getNumFrames' => ['int'], 'SWFVideoStream::setDimension' => ['void', 'x'=>'int', 'y'=>'int'], 'Swish::__construct' => ['void', 'index_names'=>'string'], 'Swish::getMetaList' => ['array', 'index_name'=>'string'], 'Swish::getPropertyList' => ['array', 'index_name'=>'string'], 'Swish::prepare' => ['object', 'query='=>'string'], 'Swish::query' => ['object', 'query'=>'string'], 'SwishResult::getMetaList' => ['array'], 'SwishResult::stem' => ['array', 'word'=>'string'], 'SwishResults::getParsedWords' => ['array', 'index_name'=>'string'], 'SwishResults::getRemovedStopwords' => ['array', 'index_name'=>'string'], 'SwishResults::nextResult' => ['object'], 'SwishResults::seekResult' => ['int', 'position'=>'int'], 'SwishSearch::execute' => ['object', 'query='=>'string'], 'SwishSearch::resetLimit' => [''], 'SwishSearch::setLimit' => ['', 'property'=>'string', 'low'=>'string', 'high'=>'string'], 'SwishSearch::setPhraseDelimiter' => ['', 'delimiter'=>'string'], 'SwishSearch::setSort' => ['', 'sort'=>'string'], 'SwishSearch::setStructure' => ['', 'structure'=>'int'], 'swoole_async_dns_lookup' => ['bool', 'hostname'=>'string', 'callback'=>'callable'], 'swoole_async_read' => ['bool', 'filename'=>'string', 'callback'=>'callable', 'chunk_size='=>'int', 'offset='=>'int'], 'swoole_async_readfile' => ['bool', 'filename'=>'string', 'callback'=>'string'], 'swoole_async_set' => ['void', 'settings'=>'array'], 'swoole_async_write' => ['bool', 'filename'=>'string', 'content'=>'string', 'offset='=>'int', 'callback='=>'callable'], 'swoole_async_writefile' => ['bool', 'filename'=>'string', 'content'=>'string', 'callback='=>'callable', 'flags='=>'int'], 'swoole_client_select' => ['int', 'read_array'=>'array', 'write_array'=>'array', 'error_array'=>'array', 'timeout='=>'float'], 'swoole_cpu_num' => ['int'], 'swoole_errno' => ['int'], 'swoole_event_add' => ['int', 'fd'=>'int', 'read_callback='=>'callable', 'write_callback='=>'callable', 'events='=>'int'], 'swoole_event_defer' => ['bool', 'callback'=>'callable'], 'swoole_event_del' => ['bool', 'fd'=>'int'], 'swoole_event_exit' => ['void'], 'swoole_event_set' => ['bool', 'fd'=>'int', 'read_callback='=>'callable', 'write_callback='=>'callable', 'events='=>'int'], 'swoole_event_wait' => ['void'], 'swoole_event_write' => ['bool', 'fd'=>'int', 'data'=>'string'], 'swoole_get_local_ip' => ['array'], 'swoole_last_error' => ['int'], 'swoole_load_module' => ['mixed', 'filename'=>'string'], 'swoole_select' => ['int', 'read_array'=>'array', 'write_array'=>'array', 'error_array'=>'array', 'timeout='=>'float'], 'swoole_set_process_name' => ['void', 'process_name'=>'string', 'size='=>'int'], 'swoole_strerror' => ['string', 'errno'=>'int', 'error_type='=>'int'], 'swoole_timer_after' => ['int', 'ms'=>'int', 'callback'=>'callable', 'param='=>'mixed'], 'swoole_timer_exists' => ['bool', 'timer_id'=>'int'], 'swoole_timer_tick' => ['int', 'ms'=>'int', 'callback'=>'callable', 'param='=>'mixed'], 'swoole_version' => ['string'], 'sybase_affected_rows' => ['int', 'link_identifier='=>'resource'], 'sybase_close' => ['bool', 'link_identifier='=>'resource'], 'sybase_connect' => ['resource', 'servername='=>'string', 'username='=>'string', 'password='=>'string', 'charset='=>'string', 'appname='=>'string', 'new='=>'bool'], 'sybase_data_seek' => ['bool', 'result_identifier'=>'resource', 'row_number'=>'int'], 'sybase_deadlock_retry_count' => ['void', 'retry_count'=>'int'], 'sybase_fetch_array' => ['array', 'result'=>'resource'], 'sybase_fetch_assoc' => ['array', 'result'=>'resource'], 'sybase_fetch_field' => ['object', 'result'=>'resource', 'field_offset='=>'int'], 'sybase_fetch_object' => ['object', 'result'=>'resource', 'object='=>'mixed'], 'sybase_fetch_row' => ['array|false', 'result'=>'resource'], 'sybase_field_seek' => ['bool', 'result'=>'resource', 'field_offset'=>'int'], 'sybase_free_result' => ['bool', 'result'=>'resource'], 'sybase_get_last_message' => ['string'], 'sybase_min_client_severity' => ['void', 'severity'=>'int'], 'sybase_min_error_severity' => ['void', 'severity'=>'int'], 'sybase_min_message_severity' => ['void', 'severity'=>'int'], 'sybase_min_server_severity' => ['void', 'severity'=>'int'], 'sybase_num_fields' => ['int', 'result'=>'resource'], 'sybase_num_rows' => ['int', 'result'=>'resource'], 'sybase_pconnect' => ['resource|false', 'servername='=>'string', 'username='=>'string', 'password='=>'string', 'charset='=>'string', 'appname='=>'string'], 'sybase_query' => ['mixed', 'query'=>'string', 'link_identifier='=>'resource'], 'sybase_result' => ['string', 'result'=>'resource', 'row'=>'int', 'field'=>'mixed'], 'sybase_select_db' => ['bool', 'database_name'=>'string', 'link_identifier='=>'resource'], 'sybase_set_message_handler' => ['bool', 'handler'=>'callable', 'connection='=>'resource'], 'sybase_unbuffered_query' => ['resource|false', 'query'=>'string', 'link_identifier'=>'resource', 'store_result='=>'bool'], 'symbolObj::__construct' => ['void', 'map'=>'mapObj', 'symbolname'=>'string'], 'symbolObj::free' => ['void'], 'symbolObj::getPatternArray' => ['array'], 'symbolObj::getPointsArray' => ['array'], 'symbolObj::ms_newSymbolObj' => ['int', 'map'=>'mapObj', 'symbolname'=>'string'], 'symbolObj::set' => ['int', 'property_name'=>'string', 'new_value'=>''], 'symbolObj::setImagePath' => ['int', 'filename'=>'string'], 'symbolObj::setPattern' => ['int', 'int'=>'array'], 'symbolObj::setPoints' => ['int', 'double'=>'array'], 'symlink' => ['bool', 'target'=>'string', 'link'=>'string'], 'SyncEvent::__construct' => ['void', 'name='=>'string', 'manual='=>'bool'], 'SyncEvent::fire' => ['bool'], 'SyncEvent::reset' => ['bool'], 'SyncEvent::wait' => ['bool', 'wait='=>'int'], 'SyncMutex::__construct' => ['void', 'name='=>'string'], 'SyncMutex::lock' => ['bool', 'wait='=>'int'], 'SyncMutex::unlock' => ['bool', 'all='=>'bool'], 'SyncReaderWriter::__construct' => ['void', 'name='=>'string', 'autounlock='=>'bool'], 'SyncReaderWriter::readlock' => ['bool', 'wait='=>'int'], 'SyncReaderWriter::readunlock' => ['bool'], 'SyncReaderWriter::writelock' => ['bool', 'wait='=>'int'], 'SyncReaderWriter::writeunlock' => ['bool'], 'SyncSemaphore::__construct' => ['void', 'name='=>'string', 'initialval='=>'int', 'autounlock='=>'bool'], 'SyncSemaphore::lock' => ['bool', 'wait='=>'int'], 'SyncSemaphore::unlock' => ['bool', '&w_prevcount='=>'int'], 'SyncSharedMemory::__construct' => ['void', 'name'=>'string', 'size'=>'int'], 'SyncSharedMemory::first' => ['bool'], 'SyncSharedMemory::read' => ['', 'start='=>'int', 'length='=>'int'], 'SyncSharedMemory::size' => ['bool'], 'SyncSharedMemory::write' => ['', 'string='=>'string', 'start='=>'int'], 'sys_get_temp_dir' => ['string'], 'sys_getloadavg' => ['array|false'], 'syslog' => ['bool', 'priority'=>'int', 'message'=>'string'], 'system' => ['string|false', 'command'=>'string', '&w_return_value='=>'int'], 'taint' => ['bool', '&rw_string'=>'string', '&...w_other_strings='=>'string'], 'tan' => ['float', 'number'=>'float'], 'tanh' => ['float', 'number'=>'float'], 'tcpwrap_check' => ['bool', 'daemon'=>'string', 'address'=>'string', 'user='=>'string', 'nodns='=>'bool'], 'tempnam' => ['__benevolent<non-falsy-string|false>', 'dir'=>'string', 'prefix'=>'string'], 'textdomain' => ['string', 'domain'=>'string'], 'Thread::__construct' => ['void'], 'Thread::chunk' => ['array', 'size'=>'int', 'preserve'=>'bool'], 'Thread::count' => ['0|positive-int'], 'Thread::getCreatorId' => ['int'], 'Thread::getCurrentThread' => ['Thread|null'], 'Thread::getCurrentThreadId' => ['int'], 'Thread::getThreadId' => ['int'], 'Thread::isJoined' => ['bool'], 'Thread::isRunning' => ['bool'], 'Thread::isStarted' => ['bool'], 'Thread::isTerminated' => ['bool'], 'Thread::join' => ['bool'], 'Thread::merge' => ['bool', 'from'=>'', 'overwrite='=>'mixed'], 'Thread::notify' => ['bool'], 'Thread::notifyOne' => ['bool'], 'Thread::offsetExists' => ['bool', 'offset'=>'mixed'], 'Thread::offsetGet' => ['mixed', 'offset'=>'mixed'], 'Thread::offsetSet' => ['void', 'offset'=>'mixed', 'value'=>'mixed'], 'Thread::offsetUnset' => ['void', 'offset'=>'mixed'], 'Thread::pop' => ['bool'], 'Thread::run' => ['void'], 'Thread::shift' => ['bool'], 'Thread::start' => ['bool', 'options='=>'int'], 'Thread::synchronized' => ['mixed', 'block'=>'Closure', '_='=>'mixed'], 'Thread::wait' => ['bool', 'timeout='=>'int'], 'Threaded::__construct' => ['void'], 'Threaded::chunk' => ['array', 'size'=>'int', 'preserve'=>'bool'], 'Threaded::count' => ['0|positive-int'], 'Threaded::extend' => ['bool', 'class'=>'string'], 'Threaded::isRunning' => ['bool'], 'Threaded::isTerminated' => ['bool'], 'Threaded::merge' => ['bool', 'from'=>'mixed', 'overwrite='=>'bool'], 'Threaded::notify' => ['bool'], 'Threaded::notifyOne' => ['bool'], 'Threaded::offsetExists' => ['bool', 'offset'=>'mixed'], 'Threaded::offsetGet' => ['mixed', 'offset'=>'mixed'], 'Threaded::offsetSet' => ['void', 'offset'=>'mixed', 'value'=>'mixed'], 'Threaded::offsetUnset' => ['void', 'offset'=>'mixed'], 'Threaded::pop' => ['bool'], 'Threaded::run' => ['void'], 'Threaded::shift' => ['mixed'], 'Threaded::synchronized' => ['mixed', 'block'=>'Closure', '...args='=>'mixed'], 'Threaded::wait' => ['bool', 'timeout='=>'int'], 'Throwable::__toString' => ['string'], 'Throwable::getCode' => ['mixed'], 'Throwable::getFile' => ['string'], 'Throwable::getLine' => ['int'], 'Throwable::getMessage' => ['string'], 'Throwable::getPrevious' => ['Throwable|null'], 'Throwable::getTrace' => ['list<array{function:string,line?:int,file?:string,class?:class-string,type?:\'::\'|\'->\',args?:mixed[],object?:object}>'], 'Throwable::getTraceAsString' => ['string'], 'tidy::__construct' => ['void', 'filename='=>'string', 'config='=>'', 'encoding='=>'string', 'use_include_path='=>'bool'], 'tidy::body' => ['tidyNode'], 'tidy::cleanRepair' => ['bool'], 'tidy::diagnose' => ['bool'], 'tidy::getConfig' => ['array'], 'tidy::getHtmlVer' => ['int'], 'tidy::getOpt' => ['', 'option'=>'string'], 'tidy::getOptDoc' => ['string', 'optname'=>'string'], 'tidy::getRelease' => ['string'], 'tidy::getStatus' => ['int'], 'tidy::head' => ['tidyNode'], 'tidy::html' => ['tidyNode'], 'tidy::htmlver' => ['int'], 'tidy::isXhtml' => ['bool'], 'tidy::isXml' => ['bool'], 'tidy::parseFile' => ['bool', 'filename'=>'string', 'config='=>'mixed', 'encoding='=>'string', 'use_include_path='=>'bool'], 'tidy::parseString' => ['bool', 'input'=>'string', 'config='=>'mixed', 'encoding='=>'string'], 'tidy::repairFile' => ['string', 'filename'=>'string', 'config='=>'mixed', 'encoding='=>'string', 'use_include_path='=>'bool'], 'tidy::repairString' => ['string', 'data'=>'string', 'config='=>'mixed', 'encoding='=>'string'], 'tidy::root' => ['tidyNode'], 'tidy_access_count' => ['int', 'obj'=>'tidy'], 'tidy_clean_repair' => ['bool', 'obj'=>'tidy'], 'tidy_config_count' => ['int', 'obj'=>'tidy'], 'tidy_diagnose' => ['bool', 'obj'=>'tidy'], 'tidy_error_count' => ['int', 'obj'=>'tidy'], 'tidy_get_body' => ['tidyNode', 'obj'=>'tidy'], 'tidy_get_config' => ['array', 'obj'=>'tidy'], 'tidy_get_error_buffer' => ['string|false', 'obj'=>'tidy'], 'tidy_get_head' => ['tidyNode', 'obj'=>'tidy'], 'tidy_get_html' => ['tidyNode', 'obj'=>'tidy'], 'tidy_get_html_ver' => ['int', 'obj'=>'tidy'], 'tidy_get_opt_doc' => ['string|false', 'obj'=>'tidy', 'optname'=>'string'], 'tidy_get_output' => ['string', 'obj'=>'tidy'], 'tidy_get_release' => ['string'], 'tidy_get_root' => ['tidyNode', 'obj'=>'tidy'], 'tidy_get_status' => ['int', 'obj'=>'tidy'], 'tidy_getopt' => ['mixed', 'option'=>'string', 'obj'=>'tidy'], 'tidy_is_xhtml' => ['bool', 'obj'=>'tidy'], 'tidy_is_xml' => ['bool', 'obj'=>'tidy'], 'tidy_load_config' => ['void', 'filename'=>'string', 'encoding'=>'string'], 'tidy_parse_file' => ['tidy|false', 'file'=>'string', 'config_options='=>'', 'encoding='=>'string', 'use_include_path='=>'bool'], 'tidy_parse_string' => ['tidy|false', 'input'=>'string', 'config_options='=>'', 'encoding='=>'string'], 'tidy_repair_file' => ['string|false', 'filename'=>'string', 'config_file='=>'', 'encoding='=>'string', 'use_include_path='=>'bool'], 'tidy_repair_string' => ['string|false', 'data'=>'string', 'config_file='=>'', 'encoding='=>'string'], 'tidy_reset_config' => ['bool'], 'tidy_save_config' => ['bool', 'filename'=>'string'], 'tidy_set_encoding' => ['bool', 'encoding'=>'string'], 'tidy_setopt' => ['bool', 'option'=>'string', 'value'=>'mixed'], 'tidy_warning_count' => ['int', 'obj'=>'tidy'], 'tidyNode::__construct' => ['void'], 'tidyNode::getParent' => ['tidyNode'], 'tidyNode::hasChildren' => ['bool'], 'tidyNode::hasSiblings' => ['bool'], 'tidyNode::isAsp' => ['bool'], 'tidyNode::isComment' => ['bool'], 'tidyNode::isHtml' => ['bool'], 'tidyNode::isJste' => ['bool'], 'tidyNode::isPhp' => ['bool'], 'tidyNode::isText' => ['bool'], 'time' => ['positive-int'], 'time_nanosleep' => ['array{seconds:0|positive-int,nanoseconds:0|positive-int}|bool', 'seconds'=>'int', 'nanoseconds'=>'int'], 'time_sleep_until' => ['bool', 'timestamp'=>'float'], 'timezone_abbreviations_list' => ['array<string, list<array{dst: bool, offset: int, timezone_id: string|null}>>'], 'timezone_identifiers_list' => ['list<string>', 'what='=>'int', 'country='=>'?string'], 'timezone_location_get' => ['array{country_code: string, latitude: float, longitude: float, comments: string}|false', 'object'=>'DateTimeZone'], 'timezone_name_from_abbr' => ['string|false', 'abbr'=>'string', 'gmtoffset='=>'int', 'isdst='=>'int'], 'timezone_name_get' => ['string', 'object'=>'DateTimeZone'], 'timezone_offset_get' => ['int', 'object'=>'DateTimeZone', 'datetime'=>'DateTime'], 'timezone_open' => ['DateTimeZone|false', 'timezone'=>'string'], 'timezone_transitions_get' => ['list<array{ts: int, time: string, offset: int, isdst: bool, abbr: string}>|false', 'object'=>'DateTimeZone', 'timestamp_begin='=>'int', 'timestamp_end='=>'int'], 'timezone_version_get' => ['string'], 'tmpfile' => ['__benevolent<resource|false>'], 'token_get_all' => ['list<string|array{0:int,1:string,2:int}>', 'source'=>'string', 'flags='=>'int'], 'token_name' => ['non-falsy-string', 'type'=>'int'], 'TokyoTyrant::__construct' => ['void', 'host='=>'string', 'port='=>'int', 'options='=>'array'], 'TokyoTyrant::add' => ['int|float', 'key'=>'string', 'increment'=>'float', 'type='=>'int'], 'TokyoTyrant::connect' => ['TokyoTyrant', 'host'=>'string', 'port='=>'int', 'options='=>'array'], 'TokyoTyrant::connectUri' => ['TokyoTyrant', 'uri'=>'string'], 'TokyoTyrant::copy' => ['TokyoTyrant', 'path'=>'string'], 'TokyoTyrant::ext' => ['string', 'name'=>'string', 'options'=>'int', 'key'=>'string', 'value'=>'string'], 'TokyoTyrant::fwmKeys' => ['array', 'prefix'=>'string', 'max_recs'=>'int'], 'TokyoTyrant::get' => ['array', 'keys'=>'mixed'], 'TokyoTyrant::getIterator' => ['TokyoTyrantIterator'], 'TokyoTyrant::num' => ['int'], 'TokyoTyrant::out' => ['string', 'keys'=>'mixed'], 'TokyoTyrant::put' => ['TokyoTyrant', 'keys'=>'mixed', 'value='=>'string'], 'TokyoTyrant::putCat' => ['TokyoTyrant', 'keys'=>'mixed', 'value='=>'string'], 'TokyoTyrant::putKeep' => ['TokyoTyrant', 'keys'=>'mixed', 'value='=>'string'], 'TokyoTyrant::putNr' => ['TokyoTyrant', 'keys'=>'mixed', 'value='=>'string'], 'TokyoTyrant::putShl' => ['mixed', 'key'=>'string', 'value'=>'string', 'width'=>'int'], 'TokyoTyrant::restore' => ['mixed', 'log_dir'=>'string', 'timestamp'=>'int', 'check_consistency='=>'bool'], 'TokyoTyrant::setMaster' => ['mixed', 'host'=>'string', 'port'=>'int', 'timestamp'=>'int', 'check_consistency='=>'bool'], 'TokyoTyrant::size' => ['int', 'key'=>'string'], 'TokyoTyrant::stat' => ['array'], 'TokyoTyrant::sync' => ['mixed'], 'TokyoTyrant::tune' => ['TokyoTyrant', 'timeout'=>'float', 'options='=>'int'], 'TokyoTyrant::vanish' => ['mixed'], 'TokyoTyrantIterator::__construct' => ['void', 'object'=>'mixed'], 'TokyoTyrantIterator::current' => ['mixed'], 'TokyoTyrantIterator::key' => ['mixed'], 'TokyoTyrantIterator::next' => ['mixed'], 'TokyoTyrantIterator::rewind' => ['void'], 'TokyoTyrantIterator::valid' => ['bool'], 'TokyoTyrantQuery::__construct' => ['void', 'table'=>'TokyoTyrantTable'], 'TokyoTyrantQuery::addCond' => ['mixed', 'name'=>'string', 'op'=>'int', 'expr'=>'string'], 'TokyoTyrantQuery::count' => ['0|positive-int'], 'TokyoTyrantQuery::current' => ['array'], 'TokyoTyrantQuery::hint' => ['string'], 'TokyoTyrantQuery::key' => ['string'], 'TokyoTyrantQuery::metaSearch' => ['array', 'queries'=>'array', 'type'=>'int'], 'TokyoTyrantQuery::next' => ['array'], 'TokyoTyrantQuery::out' => ['TokyoTyrantQuery'], 'TokyoTyrantQuery::rewind' => ['bool'], 'TokyoTyrantQuery::search' => ['array'], 'TokyoTyrantQuery::setLimit' => ['mixed', 'max='=>'int', 'skip='=>'int'], 'TokyoTyrantQuery::setOrder' => ['mixed', 'name'=>'string', 'type'=>'int'], 'TokyoTyrantQuery::valid' => ['bool'], 'TokyoTyrantTable::add' => ['void', 'key'=>'string', 'increment'=>'mixed', 'type='=>'string'], 'TokyoTyrantTable::genUid' => ['int'], 'TokyoTyrantTable::get' => ['array', 'keys'=>'mixed'], 'TokyoTyrantTable::getIterator' => ['TokyoTyrantIterator'], 'TokyoTyrantTable::getQuery' => ['TokyoTyrantQuery'], 'TokyoTyrantTable::out' => ['void', 'keys'=>'mixed'], 'TokyoTyrantTable::put' => ['int', 'key'=>'string', 'columns'=>'array'], 'TokyoTyrantTable::putCat' => ['void', 'key'=>'string', 'columns'=>'array'], 'TokyoTyrantTable::putKeep' => ['void', 'key'=>'string', 'columns'=>'array'], 'TokyoTyrantTable::putNr' => ['void', 'keys'=>'mixed', 'value='=>'string'], 'TokyoTyrantTable::putShl' => ['void', 'key'=>'string', 'value'=>'string', 'width'=>'int'], 'TokyoTyrantTable::setIndex' => ['mixed', 'column'=>'string', 'type'=>'int'], 'touch' => ['bool', 'filename'=>'string', 'time='=>'int', 'atime='=>'int'], 'trader_acos' => ['array', 'real'=>'array'], 'trader_ad' => ['array', 'high'=>'array', 'low'=>'array', 'close'=>'array', 'volume'=>'array'], 'trader_add' => ['array', 'real0'=>'array', 'real1'=>'array'], 'trader_adosc' => ['array', 'high'=>'array', 'low'=>'array', 'close'=>'array', 'volume'=>'array', 'fastPeriod='=>'int', 'slowPeriod='=>'int'], 'trader_adx' => ['array', 'high'=>'array', 'low'=>'array', 'close'=>'array', 'timePeriod='=>'int'], 'trader_adxr' => ['array', 'high'=>'array', 'low'=>'array', 'close'=>'array', 'timePeriod='=>'int'], 'trader_apo' => ['array', 'real'=>'array', 'fastPeriod='=>'int', 'slowPeriod='=>'int', 'mAType='=>'int'], 'trader_aroon' => ['array', 'high'=>'array', 'low'=>'array', 'timePeriod='=>'int'], 'trader_aroonosc' => ['array', 'high'=>'array', 'low'=>'array', 'timePeriod='=>'int'], 'trader_asin' => ['array', 'real'=>'array'], 'trader_atan' => ['array', 'real'=>'array'], 'trader_atr' => ['array', 'high'=>'array', 'low'=>'array', 'close'=>'array', 'timePeriod='=>'int'], 'trader_avgprice' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_bbands' => ['array', 'real'=>'array', 'timePeriod='=>'int', 'nbDevUp='=>'float', 'nbDevDn='=>'float', 'mAType='=>'int'], 'trader_beta' => ['array', 'real0'=>'array', 'real1'=>'array', 'timePeriod='=>'int'], 'trader_bop' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cci' => ['array', 'high'=>'array', 'low'=>'array', 'close'=>'array', 'timePeriod='=>'int'], 'trader_cdl2crows' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdl3blackcrows' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdl3inside' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdl3linestrike' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdl3outside' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdl3starsinsouth' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdl3whitesoldiers' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdlabandonedbaby' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array', 'penetration='=>'float'], 'trader_cdladvanceblock' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdlbelthold' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdlbreakaway' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdlclosingmarubozu' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdlconcealbabyswall' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdlcounterattack' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdldarkcloudcover' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array', 'penetration='=>'float'], 'trader_cdldoji' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdldojistar' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdldragonflydoji' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdlengulfing' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdleveningdojistar' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array', 'penetration='=>'float'], 'trader_cdleveningstar' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array', 'penetration='=>'float'], 'trader_cdlgapsidesidewhite' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdlgravestonedoji' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdlhammer' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdlhangingman' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdlharami' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdlharamicross' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdlhighwave' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdlhikkake' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdlhikkakemod' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdlhomingpigeon' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdlidentical3crows' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdlinneck' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdlinvertedhammer' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdlkicking' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdlkickingbylength' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdlladderbottom' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdllongleggeddoji' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdllongline' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdlmarubozu' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdlmatchinglow' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdlmathold' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array', 'penetration='=>'float'], 'trader_cdlmorningdojistar' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array', 'penetration='=>'float'], 'trader_cdlmorningstar' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array', 'penetration='=>'float'], 'trader_cdlonneck' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdlpiercing' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdlrickshawman' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdlrisefall3methods' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdlseparatinglines' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdlshootingstar' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdlshortline' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdlspinningtop' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdlstalledpattern' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdlsticksandwich' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdltakuri' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdltasukigap' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdlthrusting' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdltristar' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdlunique3river' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdlupsidegap2crows' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_cdlxsidegap3methods' => ['array', 'open'=>'array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_ceil' => ['array', 'real'=>'array'], 'trader_cmo' => ['array', 'real'=>'array', 'timePeriod='=>'int'], 'trader_correl' => ['array', 'real0'=>'array', 'real1'=>'array', 'timePeriod='=>'int'], 'trader_cos' => ['array', 'real'=>'array'], 'trader_cosh' => ['array', 'real'=>'array'], 'trader_dema' => ['array', 'real'=>'array', 'timePeriod='=>'int'], 'trader_div' => ['array', 'real0'=>'array', 'real1'=>'array'], 'trader_dx' => ['array', 'high'=>'array', 'low'=>'array', 'close'=>'array', 'timePeriod='=>'int'], 'trader_ema' => ['array', 'real'=>'array', 'timePeriod='=>'int'], 'trader_errno' => ['int'], 'trader_exp' => ['array', 'real'=>'array'], 'trader_floor' => ['array', 'real'=>'array'], 'trader_get_compat' => ['int'], 'trader_get_unstable_period' => ['int', 'functionId'=>'int'], 'trader_ht_dcperiod' => ['array', 'real'=>'array'], 'trader_ht_dcphase' => ['array', 'real'=>'array'], 'trader_ht_phasor' => ['array', 'real'=>'array'], 'trader_ht_sine' => ['array', 'real'=>'array'], 'trader_ht_trendline' => ['array', 'real'=>'array'], 'trader_ht_trendmode' => ['array', 'real'=>'array'], 'trader_kama' => ['array', 'real'=>'array', 'timePeriod='=>'int'], 'trader_linearreg' => ['array', 'real'=>'array', 'timePeriod='=>'int'], 'trader_linearreg_angle' => ['array', 'real'=>'array', 'timePeriod='=>'int'], 'trader_linearreg_intercept' => ['array', 'real'=>'array', 'timePeriod='=>'int'], 'trader_linearreg_slope' => ['array', 'real'=>'array', 'timePeriod='=>'int'], 'trader_ln' => ['array', 'real'=>'array'], 'trader_log10' => ['array', 'real'=>'array'], 'trader_ma' => ['array', 'real'=>'array', 'timePeriod='=>'int', 'mAType='=>'int'], 'trader_macd' => ['array', 'real'=>'array', 'fastPeriod='=>'int', 'slowPeriod='=>'int', 'signalPeriod='=>'int'], 'trader_macdext' => ['array', 'real'=>'array', 'fastPeriod='=>'int', 'fastMAType='=>'int', 'slowPeriod='=>'int', 'slowMAType='=>'int', 'signalPeriod='=>'int', 'signalMAType='=>'int'], 'trader_macdfix' => ['array', 'real'=>'array', 'signalPeriod='=>'int'], 'trader_mama' => ['array', 'real'=>'array', 'fastLimit='=>'float', 'slowLimit='=>'float'], 'trader_mavp' => ['array', 'real'=>'array', 'periods'=>'array', 'minPeriod='=>'int', 'maxPeriod='=>'int', 'mAType='=>'int'], 'trader_max' => ['array', 'real'=>'array', 'timePeriod='=>'int'], 'trader_maxindex' => ['array', 'real'=>'array', 'timePeriod='=>'int'], 'trader_medprice' => ['array', 'high'=>'array', 'low'=>'array'], 'trader_mfi' => ['array', 'high'=>'array', 'low'=>'array', 'close'=>'array', 'volume'=>'array', 'timePeriod='=>'int'], 'trader_midpoint' => ['array', 'real'=>'array', 'timePeriod='=>'int'], 'trader_midprice' => ['array', 'high'=>'array', 'low'=>'array', 'timePeriod='=>'int'], 'trader_min' => ['array', 'real'=>'array', 'timePeriod='=>'int'], 'trader_minindex' => ['array', 'real'=>'array', 'timePeriod='=>'int'], 'trader_minmax' => ['array', 'real'=>'array', 'timePeriod='=>'int'], 'trader_minmaxindex' => ['array', 'real'=>'array', 'timePeriod='=>'int'], 'trader_minus_di' => ['array', 'high'=>'array', 'low'=>'array', 'close'=>'array', 'timePeriod='=>'int'], 'trader_minus_dm' => ['array', 'high'=>'array', 'low'=>'array', 'timePeriod='=>'int'], 'trader_mom' => ['array', 'real'=>'array', 'timePeriod='=>'int'], 'trader_mult' => ['array', 'real0'=>'array', 'real1'=>'array'], 'trader_natr' => ['array', 'high'=>'array', 'low'=>'array', 'close'=>'array', 'timePeriod='=>'int'], 'trader_obv' => ['array', 'real'=>'array', 'volume'=>'array'], 'trader_plus_di' => ['array', 'high'=>'array', 'low'=>'array', 'close'=>'array', 'timePeriod='=>'int'], 'trader_plus_dm' => ['array', 'high'=>'array', 'low'=>'array', 'timePeriod='=>'int'], 'trader_ppo' => ['array', 'real'=>'array', 'fastPeriod='=>'int', 'slowPeriod='=>'int', 'mAType='=>'int'], 'trader_roc' => ['array', 'real'=>'array', 'timePeriod='=>'int'], 'trader_rocp' => ['array', 'real'=>'array', 'timePeriod='=>'int'], 'trader_rocr' => ['array', 'real'=>'array', 'timePeriod='=>'int'], 'trader_rocr100' => ['array', 'real'=>'array', 'timePeriod='=>'int'], 'trader_rsi' => ['array', 'real'=>'array', 'timePeriod='=>'int'], 'trader_sar' => ['array', 'high'=>'array', 'low'=>'array', 'acceleration='=>'float', 'maximum='=>'float'], 'trader_sarext' => ['array', 'high'=>'array', 'low'=>'array', 'startValue='=>'float', 'offsetOnReverse='=>'float', 'accelerationInitLong='=>'float', 'accelerationLong='=>'float', 'accelerationMaxLong='=>'float', 'accelerationInitShort='=>'float', 'accelerationShort='=>'float', 'accelerationMaxShort='=>'float'], 'trader_set_compat' => ['void', 'compatId'=>'int'], 'trader_set_unstable_period' => ['void', 'functionId'=>'int', 'timePeriod'=>'int'], 'trader_sin' => ['array', 'real'=>'array'], 'trader_sinh' => ['array', 'real'=>'array'], 'trader_sma' => ['array', 'real'=>'array', 'timePeriod='=>'int'], 'trader_sqrt' => ['array', 'real'=>'array'], 'trader_stddev' => ['array', 'real'=>'array', 'timePeriod='=>'int', 'nbDev='=>'float'], 'trader_stoch' => ['array', 'high'=>'array', 'low'=>'array', 'close'=>'array', 'fastK_Period='=>'int', 'slowK_Period='=>'int', 'slowK_MAType='=>'int', 'slowD_Period='=>'int', 'slowD_MAType='=>'int'], 'trader_stochf' => ['array', 'high'=>'array', 'low'=>'array', 'close'=>'array', 'fastK_Period='=>'int', 'fastD_Period='=>'int', 'fastD_MAType='=>'int'], 'trader_stochrsi' => ['array', 'real'=>'array', 'timePeriod='=>'int', 'fastK_Period='=>'int', 'fastD_Period='=>'int', 'fastD_MAType='=>'int'], 'trader_sub' => ['array', 'real0'=>'array', 'real1'=>'array'], 'trader_sum' => ['array', 'real'=>'array', 'timePeriod='=>'int'], 'trader_t3' => ['array', 'real'=>'array', 'timePeriod='=>'int', 'vFactor='=>'float'], 'trader_tan' => ['array', 'real'=>'array'], 'trader_tanh' => ['array', 'real'=>'array'], 'trader_tema' => ['array', 'real'=>'array', 'timePeriod='=>'int'], 'trader_trange' => ['array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_trima' => ['array', 'real'=>'array', 'timePeriod='=>'int'], 'trader_trix' => ['array', 'real'=>'array', 'timePeriod='=>'int'], 'trader_tsf' => ['array', 'real'=>'array', 'timePeriod='=>'int'], 'trader_typprice' => ['array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_ultosc' => ['array', 'high'=>'array', 'low'=>'array', 'close'=>'array', 'timePeriod1='=>'int', 'timePeriod2='=>'int', 'timePeriod3='=>'int'], 'trader_var' => ['array', 'real'=>'array', 'timePeriod='=>'int', 'nbDev='=>'float'], 'trader_wclprice' => ['array', 'high'=>'array', 'low'=>'array', 'close'=>'array'], 'trader_willr' => ['array', 'high'=>'array', 'low'=>'array', 'close'=>'array', 'timePeriod='=>'int'], 'trader_wma' => ['array', 'real'=>'array', 'timePeriod='=>'int'], 'trait_exists' => ['bool', 'traitname'=>'string', 'autoload='=>'bool'], 'Transliterator::create' => ['?Transliterator', 'id'=>'string', 'direction='=>'int'], 'Transliterator::createFromRules' => ['?Transliterator', 'rules'=>'string', 'direction='=>'int'], 'Transliterator::createInverse' => ['?Transliterator'], 'Transliterator::getErrorCode' => ['int|false'], 'Transliterator::getErrorMessage' => ['string|false'], 'Transliterator::listIDs' => ['list<string>|false'], 'Transliterator::transliterate' => ['string|false', 'subject'=>'string', 'start='=>'int', 'end='=>'int'], 'transliterator_create' => ['?Transliterator', 'id'=>'string', 'direction='=>'int'], 'transliterator_create_from_rules' => ['?Transliterator', 'rules'=>'string', 'direction='=>'int'], 'transliterator_create_inverse' => ['?Transliterator', 'obj'=>'Transliterator'], 'transliterator_get_error_code' => ['int|false', 'obj'=>'Transliterator'], 'transliterator_get_error_message' => ['string|false', 'obj'=>'Transliterator'], 'transliterator_list_ids' => ['list<string>|false'], 'transliterator_transliterate' => ['string|false', 'obj'=>'Transliterator|string', 'subject'=>'string', 'start='=>'int', 'end='=>'int'], 'trigger_error' => ['bool', 'message'=>'string', 'error_type='=>'int'], 'trim' => ['string', 'str'=>'string', 'character_mask='=>'string'], 'TypeError::__clone' => ['void'], 'TypeError::__construct' => ['void', 'message='=>'string', 'code='=>'int', 'previous='=>'(?Throwable)|(?TypeError)'], 'TypeError::__toString' => ['string'], 'TypeError::getCode' => ['int'], 'TypeError::getFile' => ['string'], 'TypeError::getLine' => ['int'], 'TypeError::getMessage' => ['string'], 'TypeError::getPrevious' => ['Throwable|TypeError|null'], 'TypeError::getTrace' => ['list<array{function:string,line?:int,file?:string,class?:class-string,type?:\'::\'|\'->\',args?:mixed[],object?:object}>'], 'TypeError::getTraceAsString' => ['string'], 'uasort' => ['bool', '&rw_array_arg'=>'array', 'callback'=>'callable(mixed,mixed):int'], 'ucfirst' => ['string', 'str'=>'string'], 'UConverter::__construct' => ['void', 'destination_encoding'=>'string', 'source_encoding='=>'string'], 'UConverter::convert' => ['string', 'str'=>'string', 'reverse='=>'bool'], 'UConverter::fromUCallback' => ['mixed', 'reason'=>'int', 'source'=>'string', 'codePoint'=>'string', '&w_error'=>'int'], 'UConverter::getAliases' => ['array', 'name='=>'string'], 'UConverter::getAvailable' => ['array'], 'UConverter::getDestinationEncoding' => ['string'], 'UConverter::getDestinationType' => ['int'], 'UConverter::getErrorCode' => ['int'], 'UConverter::getErrorMessage' => ['string'], 'UConverter::getSourceEncoding' => ['string'], 'UConverter::getSourceType' => ['int'], 'UConverter::getStandards' => ['array'], 'UConverter::getSubstChars' => ['string'], 'UConverter::reasonText' => ['string', 'reason='=>'int'], 'UConverter::setDestinationEncoding' => ['bool', 'encoding'=>'string'], 'UConverter::setSourceEncoding' => ['bool', 'encoding'=>'string'], 'UConverter::setSubstChars' => ['bool', 'chars'=>'string'], 'UConverter::toUCallback' => ['mixed', 'reason'=>'int', 'source'=>'string', 'codeUnits'=>'string', '&w_error'=>'int'], 'UConverter::transcode' => ['string', 'str'=>'string', 'toEncoding'=>'string', 'fromEncoding'=>'string', 'options='=>'array'], 'ucwords' => ['string', 'str'=>'string', 'delims='=>'string'], 'udm_add_search_limit' => ['bool', 'agent'=>'resource', 'var'=>'int', 'val'=>'string'], 'udm_alloc_agent' => ['resource', 'dbaddr'=>'string', 'dbmode='=>'string'], 'udm_alloc_agent_array' => ['resource', 'databases'=>'array'], 'udm_api_version' => ['int'], 'udm_cat_list' => ['array', 'agent'=>'resource', 'category'=>'string'], 'udm_cat_path' => ['array', 'agent'=>'resource', 'category'=>'string'], 'udm_check_charset' => ['bool', 'agent'=>'resource', 'charset'=>'string'], 'udm_check_stored' => ['int', 'agent'=>'', 'link'=>'int', 'doc_id'=>'string'], 'udm_clear_search_limits' => ['bool', 'agent'=>'resource'], 'udm_close_stored' => ['int', 'agent'=>'', 'link'=>'int'], 'udm_crc32' => ['int', 'agent'=>'resource', 'str'=>'string'], 'udm_errno' => ['int', 'agent'=>'resource'], 'udm_error' => ['string', 'agent'=>'resource'], 'udm_find' => ['resource', 'agent'=>'resource', 'query'=>'string'], 'udm_free_agent' => ['int', 'agent'=>'resource'], 'udm_free_ispell_data' => ['bool', 'agent'=>'int'], 'udm_free_res' => ['bool', 'res'=>'resource'], 'udm_get_doc_count' => ['int', 'agent'=>'resource'], 'udm_get_res_field' => ['string', 'res'=>'resource', 'row'=>'int', 'field'=>'int'], 'udm_get_res_param' => ['string', 'res'=>'resource', 'param'=>'int'], 'udm_hash32' => ['int', 'agent'=>'resource', 'str'=>'string'], 'udm_load_ispell_data' => ['bool', 'agent'=>'resource', 'var'=>'int', 'val1'=>'string', 'val2'=>'string', 'flag'=>'int'], 'udm_open_stored' => ['int', 'agent'=>'', 'storedaddr'=>'string'], 'udm_set_agent_param' => ['bool', 'agent'=>'resource', 'var'=>'int', 'val'=>'string'], 'ui\draw\text\font\fontfamilies' => ['array'], 'ui\quit' => ['void'], 'ui\run' => ['void', 'flags='=>'int'], 'uksort' => ['bool', '&rw_array_arg'=>'array', 'callback'=>'callable(array-key,array-key):int'], 'umask' => ['int', 'mask='=>'int'], 'UnderflowException::__clone' => ['void'], 'UnderflowException::__construct' => ['void', 'message='=>'string', 'code='=>'int', 'previous='=>'(?Throwable)|(?UnderflowException)'], 'UnderflowException::__toString' => ['string'], 'UnderflowException::getCode' => ['int'], 'UnderflowException::getFile' => ['string'], 'UnderflowException::getLine' => ['int'], 'UnderflowException::getMessage' => ['string'], 'UnderflowException::getPrevious' => ['Throwable|UnderflowException|null'], 'UnderflowException::getTrace' => ['list<array{function:string,line?:int,file?:string,class?:class-string,type?:\'::\'|\'->\',args?:mixed[],object?:object}>'], 'UnderflowException::getTraceAsString' => ['string'], 'UnexpectedValueException::__clone' => ['void'], 'UnexpectedValueException::__construct' => ['void', 'message='=>'string', 'code='=>'int', 'previous='=>'(?Throwable)|(?UnexpectedValueException)'], 'UnexpectedValueException::__toString' => ['string'], 'UnexpectedValueException::getCode' => ['int'], 'UnexpectedValueException::getFile' => ['string'], 'UnexpectedValueException::getLine' => ['int'], 'UnexpectedValueException::getMessage' => ['string'], 'UnexpectedValueException::getPrevious' => ['Throwable|UnexpectedValueException|null'], 'UnexpectedValueException::getTrace' => ['list<array{function:string,line?:int,file?:string,class?:class-string,type?:\'::\'|\'->\',args?:mixed[],object?:object}>'], 'UnexpectedValueException::getTraceAsString' => ['string'], 'uniqid' => ['non-empty-string', 'prefix='=>'string', 'more_entropy='=>'bool'], 'unixtojd' => ['int|false', 'timestamp='=>'int'], 'unlink' => ['bool', 'filename'=>'string', 'context='=>'resource'], 'unpack' => ['array|false', 'format'=>'string', 'data'=>'string', 'offset='=>'int'], 'unregister_tick_function' => ['void', 'function_name'=>'callable'], 'unserialize' => ['mixed', 'variable_representation'=>'string', 'allowed_classes='=>'array{allowed_classes?:string[]|bool}'], 'untaint' => ['bool', '&rw_string'=>'string', '&...rw_strings='=>'string'], 'uopz_add_function' => ['bool', 'class'=>'string', 'function'=>'string', 'handler'=>'Closure', '$flags'=>'bool', '$all'=>'bool'], 'uopz_add_function\1' => ['bool', 'function'=>'string', 'handler'=>'Closure', '$flags'=>'bool'], 'uopz_allow_exit' => ['void', 'allow'=>'bool'], 'uopz_backup' => ['void', 'class'=>'string', 'function'=>'string'], 'uopz_backup\'1' => ['void', 'function'=>'string'], 'uopz_compose' => ['void', 'name'=>'string', 'classes'=>'array', 'methods='=>'array', 'properties='=>'array', 'flags='=>'int'], 'uopz_copy' => ['Closure', 'class'=>'string', 'function'=>'string'], 'uopz_copy\'1' => ['Closure', 'function'=>'string'], 'uopz_del_function' => ['bool', 'class'=>'string', 'function'=>'string', '$all'=>'bool'], 'uopz_del_function\1' => ['bool', 'function'=>'string'], 'uopz_delete' => ['void', 'class'=>'string', 'function'=>'string'], 'uopz_delete\'1' => ['void', 'function'=>'string'], 'uopz_extend' => ['void', 'class'=>'string', 'parent'=>'string'], 'uopz_flags' => ['int', 'class'=>'string', 'function'=>'string', 'flags='=>'int'], 'uopz_flags\'1' => ['int', 'function'=>'string', 'flags='=>'int'], 'uopz_function' => ['void', 'class'=>'string', 'function'=>'string', 'handler'=>'Closure', 'modifiers='=>'int'], 'uopz_function\'1' => ['void', 'function'=>'string', 'handler'=>'Closure', 'modifiers='=>'int'], 'uopz_get_exit_status' => ['mixed'], 'uopz_get_hook' => ['Closure', 'class'=>'string', 'function'=>'string'], 'uopz_get_hook\1' => ['Closure', 'function'=>'string'], 'uopz_get_mock' => ['mixed', 'class'=>'string'], 'uopz_get_property' => ['void', 'class'=>'string', 'property'=>'string'], 'uopz_get_property\1' => ['void', 'instance'=>'object', 'property'=>'string'], 'uopz_get_return' => ['mixed', 'class='=>'string', 'function='=>'string'], 'uopz_get_static' => ['array', 'class='=>'string', 'function='=>'string'], 'uopz_get_static\1' => ['array', 'function='=>'string'], 'uopz_implement' => ['void', 'class'=>'string', 'interface'=>'string'], 'uopz_overload' => ['void', 'opcode'=>'int', 'callable'=>'Callable'], 'uopz_redefine' => ['void', 'class'=>'string', 'constant'=>'string', 'value'=>'mixed'], 'uopz_redefine\'1' => ['void', 'constant'=>'string', 'value'=>'mixed'], 'uopz_rename' => ['void', 'class'=>'string', 'function'=>'string', 'rename'=>'string'], 'uopz_rename\'1' => ['void', 'function'=>'string', 'rename'=>'string'], 'uopz_restore' => ['void', 'class'=>'string', 'function'=>'string'], 'uopz_restore\'1' => ['void', 'function'=>'string'], 'uopz_set_mock' => ['void', 'class'=>'string', 'mock'=>'object|string'], 'uopz_set_property' => ['void', 'class'=>'string', 'property'=>'string', 'value'=>'mixed'], 'uopz_set_property\1' => ['void', 'instance'=>'object', 'property'=>'string', 'value'=>'mixed'], 'uopz_set_return' => ['bool', 'class'=>'string', 'function'=>'string', 'value'=>'mixed', 'execute='=>'bool'], 'uopz_set_return\'1' => ['bool', 'function'=>'string', 'value'=>'mixed', 'execute='=>'bool'], 'uopz_undefine' => ['void', 'class'=>'string', 'constant'=>'string'], 'uopz_undefine\'1' => ['void', 'constant'=>'string'], 'uopz_set_hook' => ['bool', 'class'=>'string', 'function'=>'string', 'hook'=>'Closure'], 'uopz_set_hook\1' => ['bool', 'function'=>'string', 'hook'=>'Closure'], 'uopz_unset_mock' => ['void', 'class'=>'string'], 'uopz_unset_return' => ['bool', 'class='=>'string', 'function='=>'string'], 'uopz_unset_return\'1' => ['bool', 'function'=>'string'], 'urldecode' => ['string', 'str'=>'string'], 'urlencode' => ['string', 'str'=>'string'], 'use_soap_error_handler' => ['bool', 'handler='=>'bool'], 'usleep' => ['void', 'micro_seconds'=>'int'], 'usort' => ['bool', '&rw_array_arg'=>'array', 'callback'=>'callable(mixed,mixed):int'], 'utf8_decode' => ['string', 'data'=>'string'], 'utf8_encode' => ['string', 'data'=>'string'], 'V8Js::__construct' => ['void', 'object_name='=>'string', 'variables='=>'array', 'extensions='=>'array', 'report_uncaught_exceptions='=>'bool', 'snapshot_blob='=>'string'], 'V8Js::clearPendingException' => [''], 'V8Js::compileString' => ['resource', 'script'=>'', 'identifier='=>'string'], 'V8Js::createSnapshot' => ['false|string', 'embed_source'=>'string'], 'V8Js::executeScript' => ['', 'script'=>'resource', 'flags='=>'int', 'time_limit='=>'int', 'memory_limit='=>'int'], 'V8Js::executeString' => ['mixed', 'script'=>'string', 'identifier='=>'string', 'flags='=>'int'], 'V8Js::getExtensions' => ['array'], 'V8Js::getPendingException' => ['V8JsException'], 'V8Js::registerExtension' => ['bool', 'extension_name'=>'string', 'script'=>'string', 'dependencies='=>'array', 'auto_enable='=>'bool'], 'V8Js::setAverageObjectSize' => ['', 'average_object_size'=>'int'], 'V8Js::setMemoryLimit' => ['', 'limit'=>'int'], 'V8Js::setModuleLoader' => ['', 'loader'=>'callable'], 'V8Js::setModuleNormaliser' => ['', 'normaliser'=>'callable'], 'V8Js::setTimeLimit' => ['', 'limit'=>'int'], 'V8JsException::getJsFileName' => ['string'], 'V8JsException::getJsLineNumber' => ['int'], 'V8JsException::getJsSourceLine' => ['int'], 'V8JsException::getJsTrace' => ['string'], 'V8JsScriptException::__clone' => ['void'], 'V8JsScriptException::__construct' => ['void', 'message='=>'string', 'code='=>'int', 'previous='=>'(?Exception)|(?Throwable)'], 'V8JsScriptException::__toString' => ['string'], 'V8JsScriptException::__wakeup' => ['void'], 'V8JsScriptException::getCode' => ['int'], 'V8JsScriptException::getFile' => ['string'], 'V8JsScriptException::getJsEndColumn' => ['int'], 'V8JsScriptException::getJsFileName' => ['string'], 'V8JsScriptException::getJsLineNumber' => ['int'], 'V8JsScriptException::getJsSourceLine' => ['string'], 'V8JsScriptException::getJsStartColumn' => ['int'], 'V8JsScriptException::getJsTrace' => ['string'], 'V8JsScriptException::getLine' => ['int'], 'V8JsScriptException::getMessage' => ['string'], 'V8JsScriptException::getPrevious' => ['Exception|Throwable'], 'V8JsScriptException::getTrace' => ['list<array{function:string,line?:int,file?:string,class?:class-string,type?:\'::\'|\'->\',args?:mixed[],object?:object}>'], 'V8JsScriptException::getTraceAsString' => ['string'], 'var_dump' => ['void', 'var'=>'mixed', '...args='=>'mixed'], 'var_export' => ['string|null', 'var'=>'mixed', 'return='=>'bool'], 'VARIANT::__construct' => ['void', 'value='=>'mixed', 'type='=>'int', 'codepage='=>'int'], 'variant_abs' => ['mixed', 'left'=>'mixed'], 'variant_add' => ['mixed', 'left'=>'mixed', 'right'=>'mixed'], 'variant_and' => ['mixed', 'left'=>'mixed', 'right'=>'mixed'], 'variant_cast' => ['object', 'variant'=>'object', 'type'=>'int'], 'variant_cat' => ['mixed', 'left'=>'mixed', 'right'=>'mixed'], 'variant_cmp' => ['int', 'left'=>'mixed', 'right'=>'mixed', 'lcid='=>'int', 'flags='=>'int'], 'variant_date_from_timestamp' => ['object', 'timestamp'=>'int'], 'variant_date_to_timestamp' => ['int', 'variant'=>'object'], 'variant_div' => ['mixed', 'left'=>'mixed', 'right'=>'mixed'], 'variant_eqv' => ['mixed', 'left'=>'mixed', 'right'=>'mixed'], 'variant_fix' => ['mixed', 'left'=>'mixed'], 'variant_get_type' => ['int', 'variant'=>'object'], 'variant_idiv' => ['mixed', 'left'=>'mixed', 'right'=>'mixed'], 'variant_imp' => ['mixed', 'left'=>'mixed', 'right'=>'mixed'], 'variant_int' => ['mixed', 'left'=>'mixed'], 'variant_mod' => ['mixed', 'left'=>'mixed', 'right'=>'mixed'], 'variant_mul' => ['mixed', 'left'=>'mixed', 'right'=>'mixed'], 'variant_neg' => ['mixed', 'left'=>'mixed'], 'variant_not' => ['mixed', 'left'=>'mixed'], 'variant_or' => ['mixed', 'left'=>'mixed', 'right'=>'mixed'], 'variant_pow' => ['mixed', 'left'=>'mixed', 'right'=>'mixed'], 'variant_round' => ['mixed', 'left'=>'mixed', 'decimals'=>'int'], 'variant_set' => ['void', 'variant'=>'object', 'value'=>'mixed'], 'variant_set_type' => ['void', 'variant'=>'object', 'type'=>'int'], 'variant_sub' => ['mixed', 'left'=>'mixed', 'right'=>'mixed'], 'variant_xor' => ['mixed', 'left'=>'mixed', 'right'=>'mixed'], 'VarnishAdmin::__construct' => ['void', 'args='=>'array'], 'VarnishAdmin::auth' => ['bool'], 'VarnishAdmin::ban' => ['int', 'vcl_regex'=>'string'], 'VarnishAdmin::banUrl' => ['int', 'vcl_regex'=>'string'], 'VarnishAdmin::clearPanic' => ['int'], 'VarnishAdmin::connect' => ['bool'], 'VarnishAdmin::disconnect' => ['bool'], 'VarnishAdmin::getPanic' => ['string'], 'VarnishAdmin::getParams' => ['array'], 'VarnishAdmin::isRunning' => ['bool'], 'VarnishAdmin::setCompat' => ['void', 'compat'=>'int'], 'VarnishAdmin::setHost' => ['void', 'host'=>'string'], 'VarnishAdmin::setIdent' => ['void', 'ident'=>'string'], 'VarnishAdmin::setParam' => ['int', 'name'=>'string', 'value'=>'string|int'], 'VarnishAdmin::setPort' => ['void', 'port'=>'int'], 'VarnishAdmin::setSecret' => ['void', 'secret'=>'string'], 'VarnishAdmin::setTimeout' => ['void', 'timeout'=>'int'], 'VarnishAdmin::start' => ['int'], 'VarnishAdmin::stop' => ['int'], 'VarnishLog::__construct' => ['void', 'args='=>'array'], 'VarnishLog::getLine' => ['array'], 'VarnishLog::getTagName' => ['string', 'index'=>'int'], 'VarnishStat::__construct' => ['void', 'args='=>'array'], 'VarnishStat::getSnapshot' => ['array'], 'version_compare' => ['int', 'version1'=>'string', 'version2'=>'string'], 'version_compare\'1' => ['bool', 'version1'=>'string', 'version2'=>'string', 'operator'=>'string|null'], 'vfprintf' => ['int', 'stream'=>'resource', 'format'=>'string', 'args'=>'array<__stringAndStringable|int|float|null|bool>'], 'virtual' => ['bool', 'uri'=>'string'], 'Volatile::__construct' => ['void'], 'Volatile::chunk' => ['array', 'size'=>'int', 'preserve'=>'bool'], 'Volatile::count' => ['0|positive-int'], 'Volatile::extend' => ['bool', 'class'=>'string'], 'Volatile::isRunning' => ['bool'], 'Volatile::isTerminated' => ['bool'], 'Volatile::merge' => ['bool', 'from'=>'mixed', 'overwrite='=>'bool'], 'Volatile::notify' => ['bool'], 'Volatile::notifyOne' => ['bool'], 'Volatile::offsetExists' => ['bool', 'offset'=>'mixed'], 'Volatile::offsetGet' => ['mixed', 'offset'=>'mixed'], 'Volatile::offsetSet' => ['void', 'offset'=>'mixed', 'value'=>'mixed'], 'Volatile::offsetUnset' => ['void', 'offset'=>'mixed'], 'Volatile::pop' => ['bool'], 'Volatile::run' => ['void'], 'Volatile::shift' => ['mixed'], 'Volatile::synchronized' => ['mixed', 'block'=>'Closure', '...args='=>'mixed'], 'Volatile::wait' => ['bool', 'timeout='=>'int'], 'vpopmail_add_alias_domain' => ['bool', 'domain'=>'string', 'aliasdomain'=>'string'], 'vpopmail_add_alias_domain_ex' => ['bool', 'olddomain'=>'string', 'newdomain'=>'string'], 'vpopmail_add_domain' => ['bool', 'domain'=>'string', 'dir'=>'string', 'uid'=>'int', 'gid'=>'int'], 'vpopmail_add_domain_ex' => ['bool', 'domain'=>'string', 'passwd'=>'string', 'quota='=>'string', 'bounce='=>'string', 'apop='=>'bool'], 'vpopmail_add_user' => ['bool', 'user'=>'string', 'domain'=>'string', 'password'=>'string', 'gecos='=>'string', 'apop='=>'bool'], 'vpopmail_alias_add' => ['bool', 'user'=>'string', 'domain'=>'string', 'alias'=>'string'], 'vpopmail_alias_del' => ['bool', 'user'=>'string', 'domain'=>'string'], 'vpopmail_alias_del_domain' => ['bool', 'domain'=>'string'], 'vpopmail_alias_get' => ['array', 'alias'=>'string', 'domain'=>'string'], 'vpopmail_alias_get_all' => ['array', 'domain'=>'string'], 'vpopmail_auth_user' => ['bool', 'user'=>'string', 'domain'=>'string', 'password'=>'string', 'apop='=>'string'], 'vpopmail_del_domain' => ['bool', 'domain'=>'string'], 'vpopmail_del_domain_ex' => ['bool', 'domain'=>'string'], 'vpopmail_del_user' => ['bool', 'user'=>'string', 'domain'=>'string'], 'vpopmail_error' => ['string'], 'vpopmail_passwd' => ['bool', 'user'=>'string', 'domain'=>'string', 'password'=>'string', 'apop='=>'bool'], 'vpopmail_set_user_quota' => ['bool', 'user'=>'string', 'domain'=>'string', 'quota'=>'string'], 'vprintf' => ['int', 'format'=>'string', 'args'=>'array<__stringAndStringable|int|float|null|bool>'], 'vsprintf' => ['string', 'format'=>'string', 'args'=>'array<__stringAndStringable|int|float|null|bool>'], 'w32api_deftype' => ['bool', 'typename'=>'string', 'member1_type'=>'string', 'member1_name'=>'string', '...args='=>'string'], 'w32api_init_dtype' => ['resource', 'typename'=>'string', 'value'=>'', '...args='=>''], 'w32api_invoke_function' => ['', 'funcname'=>'string', 'argument'=>'', '...args='=>''], 'w32api_register_function' => ['bool', 'library'=>'string', 'function_name'=>'string', 'return_type'=>'string'], 'w32api_set_call_method' => ['', 'method'=>'int'], 'wddx_add_vars' => ['bool', 'packet_id'=>'resource', 'var_names'=>'mixed', '...vars='=>'mixed'], 'wddx_deserialize' => ['mixed', 'packet'=>'string'], 'wddx_packet_end' => ['string', 'packet_id'=>'resource'], 'wddx_packet_start' => ['resource', 'comment='=>'string'], 'wddx_serialize_value' => ['string', 'var'=>'mixed', 'comment='=>'string'], 'wddx_serialize_vars' => ['string', 'var_name'=>'mixed', '...vars='=>'mixed'], 'WeakMap::__construct' => ['void'], 'WeakMap::count' => ['0|positive-int'], 'WeakMap::current' => ['mixed'], 'WeakMap::key' => ['object'], 'WeakMap::next' => ['void'], 'WeakMap::offsetExists' => ['bool', 'object'=>'object'], 'WeakMap::offsetGet' => ['mixed', 'object'=>'object'], 'WeakMap::offsetSet' => ['void', 'object'=>'object', 'value'=>'mixed'], 'WeakMap::offsetUnset' => ['void', 'object'=>'object'], 'WeakMap::rewind' => ['void'], 'WeakMap::valid' => ['bool'], 'Weakref::acquire' => ['bool'], 'Weakref::get' => ['object'], 'Weakref::release' => ['bool'], 'Weakref::valid' => ['bool'], 'webObj::convertToString' => ['string'], 'webObj::free' => ['void'], 'webObj::set' => ['int', 'property_name'=>'string', 'new_value'=>''], 'webObj::updateFromString' => ['int', 'snippet'=>'string'], 'win32_continue_service' => ['int', 'servicename'=>'string', 'machine='=>'string'], 'win32_create_service' => ['mixed', 'details'=>'array', 'machine='=>'string'], 'win32_delete_service' => ['mixed', 'servicename'=>'string', 'machine='=>'string'], 'win32_get_last_control_message' => ['int'], 'win32_pause_service' => ['int', 'servicename'=>'string', 'machine='=>'string'], 'win32_ps_list_procs' => ['array'], 'win32_ps_stat_mem' => ['array'], 'win32_ps_stat_proc' => ['array', 'pid='=>'int'], 'win32_query_service_status' => ['mixed', 'servicename'=>'string', 'machine='=>'string'], 'win32_set_service_status' => ['bool', 'status'=>'int', 'checkpoint='=>'int'], 'win32_start_service' => ['int', 'servicename'=>'string', 'machine='=>'string'], 'win32_start_service_ctrl_dispatcher' => ['mixed', 'name'=>'string'], 'win32_stop_service' => ['int', 'servicename'=>'string', 'machine='=>'string'], 'wincache_fcache_fileinfo' => ['array', 'summaryonly='=>'bool'], 'wincache_fcache_meminfo' => ['array'], 'wincache_lock' => ['bool', 'key'=>'string', 'isglobal='=>'bool'], 'wincache_ocache_fileinfo' => ['array', 'summaryonly='=>'bool'], 'wincache_ocache_meminfo' => ['array'], 'wincache_refresh_if_changed' => ['bool', 'files='=>'array'], 'wincache_rplist_fileinfo' => ['array', 'summaryonly='=>'bool'], 'wincache_rplist_meminfo' => ['array'], 'wincache_scache_info' => ['array|false', 'summaryonly='=>'bool'], 'wincache_scache_meminfo' => ['array|false'], 'wincache_ucache_add' => ['bool', 'key'=>'string', 'value'=>'', 'ttl='=>'int'], 'wincache_ucache_add\'1' => ['bool', 'values'=>'array', 'unused='=>'', 'ttl='=>'int'], 'wincache_ucache_cas' => ['bool', 'key'=>'string', 'old_value'=>'int', 'new_value'=>'int'], 'wincache_ucache_clear' => ['bool'], 'wincache_ucache_dec' => ['mixed', 'key'=>'string', 'dec_by='=>'int', '&w_success='=>'bool'], 'wincache_ucache_delete' => ['bool', 'key'=>'mixed'], 'wincache_ucache_exists' => ['bool', 'key'=>'string'], 'wincache_ucache_get' => ['mixed', 'key'=>'mixed', '&w_success='=>'bool'], 'wincache_ucache_inc' => ['int|false', 'key'=>'string', 'inc_by='=>'int', '&w_success='=>'bool'], 'wincache_ucache_info' => ['array|false', 'summaryonly='=>'bool', 'key='=>'string'], 'wincache_ucache_meminfo' => ['array'], 'wincache_ucache_set' => ['bool', 'key'=>'', 'value'=>'', 'ttl='=>'int'], 'wincache_ucache_set\'1' => ['bool', 'values'=>'array', 'unused='=>'', 'ttl='=>'int'], 'wincache_unlock' => ['bool', 'key'=>'string'], 'wordwrap' => ['string', 'str'=>'string', 'width='=>'int', 'break='=>'string', 'cut='=>'bool'], 'Worker::__construct' => ['void'], 'Worker::chunk' => ['array', 'size'=>'int', 'preserve'=>'bool'], 'Worker::collect' => ['int', 'collector='=>'Callable'], 'Worker::count' => ['0|positive-int'], 'Worker::getCreatorId' => ['int'], 'Worker::getCurrentThread' => ['Thread'], 'Worker::getCurrentThreadId' => ['int'], 'Worker::getStacked' => ['int'], 'Worker::getThreadId' => ['int'], 'Worker::isJoined' => ['bool'], 'Worker::isRunning' => ['bool'], 'Worker::isShutdown' => ['bool'], 'Worker::isStarted' => ['bool'], 'Worker::isTerminated' => ['bool'], 'Worker::join' => ['bool'], 'Worker::merge' => ['bool', 'from'=>'', 'overwrite='=>'mixed'], 'Worker::notify' => ['bool'], 'Worker::notifyOne' => ['bool'], 'Worker::offsetExists' => ['bool', 'offset'=>'mixed'], 'Worker::offsetGet' => ['mixed', 'offset'=>'mixed'], 'Worker::offsetSet' => ['void', 'offset'=>'mixed', 'value'=>'mixed'], 'Worker::offsetUnset' => ['void', 'offset'=>'mixed'], 'Worker::pop' => ['bool'], 'Worker::run' => ['void'], 'Worker::shift' => ['bool'], 'Worker::shutdown' => ['bool'], 'Worker::stack' => ['int', 'work'=>'Threaded'], 'Worker::start' => ['bool', 'options='=>'int'], 'Worker::synchronized' => ['mixed', 'block'=>'Closure', '_='=>'mixed'], 'Worker::unstack' => ['Collectable|null'], 'Worker::wait' => ['bool', 'timeout='=>'int'], 'xattr_get' => ['string', 'filename'=>'string', 'name'=>'string', 'flags='=>'int'], 'xattr_list' => ['array', 'filename'=>'string', 'flags='=>'int'], 'xattr_remove' => ['bool', 'filename'=>'string', 'name'=>'string', 'flags='=>'int'], 'xattr_set' => ['bool', 'filename'=>'string', 'name'=>'string', 'value'=>'string', 'flags='=>'int'], 'xattr_supported' => ['bool', 'filename'=>'string', 'flags='=>'int'], 'xcache_asm' => ['string', 'filename'=>'string'], 'xcache_clear_cache' => ['void', 'type'=>'int', 'id='=>'int'], 'xcache_coredump' => ['string', 'op_type'=>'int'], 'xcache_count' => ['int', 'type'=>'int'], 'xcache_coverager_decode' => ['array', 'data'=>'string'], 'xcache_coverager_get' => ['array', 'clean='=>'bool|false'], 'xcache_coverager_start' => ['void', 'clean='=>'bool|true'], 'xcache_coverager_stop' => ['void', 'clean='=>'bool|false'], 'xcache_dasm_file' => ['string', 'filename'=>'string'], 'xcache_dasm_string' => ['string', 'code'=>'string'], 'xcache_dec' => ['int', 'name'=>'string', 'value='=>'int|mixed', 'ttl='=>'int'], 'xcache_decode' => ['bool', 'filename'=>'string'], 'xcache_encode' => ['string', 'filename'=>'string'], 'xcache_get' => ['mixed', 'name'=>'string'], 'xcache_get_data_type' => ['string', 'type'=>'int'], 'xcache_get_op_spec' => ['string', 'op_type'=>'int'], 'xcache_get_op_type' => ['string', 'op_type'=>'int'], 'xcache_get_opcode' => ['string', 'opcode'=>'int'], 'xcache_get_opcode_spec' => ['string', 'opcode'=>'int'], 'xcache_inc' => ['int', 'name'=>'string', 'value='=>'int|mixed', 'ttl='=>'int'], 'xcache_info' => ['array', 'type'=>'int', 'id'=>'int'], 'xcache_is_autoglobal' => ['string', 'name'=>'string'], 'xcache_isset' => ['bool', 'name'=>'string'], 'xcache_list' => ['array', 'type'=>'int', 'id'=>'int'], 'xcache_set' => ['bool', 'name'=>'string', 'value'=>'mixed', 'ttl='=>'int'], 'xcache_unset' => ['bool', 'name'=>'string'], 'xcache_unset_by_prefix' => ['bool', 'prefix'=>'string'], 'Xcom::__construct' => ['void', 'fabric_url='=>'string', 'fabric_token='=>'string', 'capability_token='=>'string'], 'Xcom::decode' => ['object', 'avro_msg'=>'string', 'json_schema'=>'string'], 'Xcom::encode' => ['string', 'data'=>'stdClass', 'avro_schema'=>'string'], 'Xcom::getDebugOutput' => ['string'], 'Xcom::getLastResponse' => ['string'], 'Xcom::getLastResponseInfo' => ['array'], 'Xcom::getOnboardingURL' => ['string', 'capability_name'=>'string', 'agreement_url'=>'string'], 'Xcom::send' => ['int', 'topic'=>'string', 'data'=>'mixed', 'json_schema='=>'string', 'http_headers='=>'array'], 'Xcom::sendAsync' => ['int', 'topic'=>'string', 'data'=>'mixed', 'json_schema='=>'string', 'http_headers='=>'array'], 'xdebug_break' => ['bool'], 'xdebug_call_class' => ['string', 'depth='=>'int'], 'xdebug_call_file' => ['string', 'depth='=>'int'], 'xdebug_call_function' => ['string', 'depth='=>'int'], 'xdebug_call_line' => ['int', 'depth='=>'int'], 'xdebug_clear_aggr_profiling_data' => ['bool'], 'xdebug_code_coverage_started' => ['bool'], 'xdebug_connect_to_client' => ['bool'], 'xdebug_debug_zval' => ['void', '...varName'=>'string'], 'xdebug_debug_zval_stdout' => ['void', '...varName'=>'string'], 'xdebug_disable' => ['void'], 'xdebug_dump_aggr_profiling_data' => ['bool'], 'xdebug_dump_superglobals' => ['void'], 'xdebug_enable' => ['void'], 'xdebug_get_code_coverage' => ['array'], 'xdebug_get_collected_errors' => ['string', 'clean='=>'bool|false'], 'xdebug_get_declared_vars' => ['array'], 'xdebug_get_formatted_function_stack' => [''], 'xdebug_get_function_count' => ['int'], 'xdebug_get_function_stack' => ['array', 'message='=>'string', 'options='=>'int'], 'xdebug_get_headers' => ['array'], 'xdebug_get_monitored_functions' => ['array'], 'xdebug_get_profiler_filename' => ['string'], 'xdebug_get_stack_depth' => ['int'], 'xdebug_get_tracefile_name' => ['string'], 'xdebug_is_debugger_active' => ['bool'], 'xdebug_is_enabled' => ['bool'], 'xdebug_memory_usage' => ['int'], 'xdebug_notify' => ['bool', 'data'=>'mixed'], 'xdebug_peak_memory_usage' => ['int'], 'xdebug_print_function_stack' => ['array', 'message='=>'string', 'options='=>'int'], 'xdebug_set_filter' => ['void', 'group'=>'int', 'list_type'=>'int', 'configuration'=>'array'], 'xdebug_start_code_coverage' => ['void', 'options='=>'int'], 'xdebug_start_error_collection' => ['void'], 'xdebug_start_function_monitor' => ['void', 'list_of_functions_to_monitor'=>'string[]'], 'xdebug_start_trace' => ['void', 'trace_file'=>'', 'options='=>'int|mixed'], 'xdebug_stop_code_coverage' => ['void', 'cleanup='=>'bool|true'], 'xdebug_stop_error_collection' => ['void'], 'xdebug_stop_function_monitor' => ['void'], 'xdebug_stop_trace' => ['void'], 'xdebug_time_index' => ['float'], 'xdebug_var_dump' => ['void', '...var'=>''], 'xdiff_file_bdiff' => ['bool', 'old_file'=>'string', 'new_file'=>'string', 'dest'=>'string'], 'xdiff_file_bdiff_size' => ['int', 'file'=>'string'], 'xdiff_file_bpatch' => ['bool', 'file'=>'string', 'patch'=>'string', 'dest'=>'string'], 'xdiff_file_diff' => ['bool', 'old_file'=>'string', 'new_file'=>'string', 'dest'=>'string', 'context='=>'int', 'minimal='=>'bool'], 'xdiff_file_diff_binary' => ['bool', 'old_file'=>'string', 'new_file'=>'string', 'dest'=>'string'], 'xdiff_file_merge3' => ['mixed', 'old_file'=>'string', 'new_file1'=>'string', 'new_file2'=>'string', 'dest'=>'string'], 'xdiff_file_patch' => ['mixed', 'file'=>'string', 'patch'=>'string', 'dest'=>'string', 'flags='=>'int'], 'xdiff_file_patch_binary' => ['bool', 'file'=>'string', 'patch'=>'string', 'dest'=>'string'], 'xdiff_file_rabdiff' => ['bool', 'old_file'=>'string', 'new_file'=>'string', 'dest'=>'string'], 'xdiff_string_bdiff' => ['string', 'old_data'=>'string', 'new_data'=>'string'], 'xdiff_string_bdiff_size' => ['int', 'patch'=>'string'], 'xdiff_string_bpatch' => ['string', 'str'=>'string', 'patch'=>'string'], 'xdiff_string_diff' => ['string', 'old_data'=>'string', 'new_data'=>'string', 'context='=>'int', 'minimal='=>'bool'], 'xdiff_string_diff_binary' => ['string', 'old_data'=>'string', 'new_data'=>'string'], 'xdiff_string_merge3' => ['mixed', 'old_data'=>'string', 'new_data1'=>'string', 'new_data2'=>'string', 'error='=>'string'], 'xdiff_string_patch' => ['string', 'str'=>'string', 'patch'=>'string', 'flags='=>'int', '&w_error='=>'string'], 'xdiff_string_patch_binary' => ['string', 'str'=>'string', 'patch'=>'string'], 'xdiff_string_rabdiff' => ['string', 'old_data'=>'string', 'new_data'=>'string'], 'xhprof_disable' => ['array'], 'xhprof_enable' => ['void', 'flags='=>'int', 'options='=>'array'], 'xhprof_sample_disable' => ['array<string,string>'], 'xhprof_sample_enable' => ['void'], 'xml_error_string' => ['string', 'code'=>'int'], 'xml_get_current_byte_index' => ['int', 'parser'=>'resource'], 'xml_get_current_column_number' => ['int', 'parser'=>'resource'], 'xml_get_current_line_number' => ['int', 'parser'=>'resource'], 'xml_get_error_code' => ['int', 'parser'=>'resource'], 'xml_parse' => ['int', 'parser'=>'resource', 'data'=>'string', 'isfinal='=>'bool'], 'xml_parse_into_struct' => ['int', 'parser'=>'resource', 'data'=>'string', '&w_values'=>'array', '&w_index='=>'array'], 'xml_parser_create' => ['resource', 'encoding='=>'string'], 'xml_parser_create_ns' => ['resource', 'encoding='=>'string', 'sep='=>'string'], 'xml_parser_free' => ['bool', 'parser'=>'resource'], 'xml_parser_get_option' => ['mixed', 'parser'=>'resource', 'option'=>'int'], 'xml_parser_set_option' => ['bool', 'parser'=>'resource', 'option'=>'int', 'value'=>'mixed'], 'xml_set_character_data_handler' => ['bool', 'parser'=>'resource', 'hdl'=>'callable'], 'xml_set_default_handler' => ['bool', 'parser'=>'resource', 'hdl'=>'callable'], 'xml_set_element_handler' => ['bool', 'parser'=>'resource', 'shdl'=>'callable', 'ehdl'=>'callable'], 'xml_set_end_namespace_decl_handler' => ['bool', 'parser'=>'resource', 'hdl'=>'callable'], 'xml_set_external_entity_ref_handler' => ['bool', 'parser'=>'resource', 'hdl'=>'callable'], 'xml_set_notation_decl_handler' => ['bool', 'parser'=>'resource', 'hdl'=>'callable'], 'xml_set_object' => ['bool', 'parser'=>'resource', 'obj'=>'object'], 'xml_set_processing_instruction_handler' => ['bool', 'parser'=>'resource', 'hdl'=>'callable'], 'xml_set_start_namespace_decl_handler' => ['bool', 'parser'=>'resource', 'hdl'=>'callable'], 'xml_set_unparsed_entity_decl_handler' => ['bool', 'parser'=>'resource', 'hdl'=>'callable'], 'XMLDiff\Base::__construct' => ['void', 'nsname'=>'string'], 'XMLDiff\Base::diff' => ['mixed', 'from'=>'mixed', 'to'=>'mixed'], 'XMLDiff\Base::merge' => ['mixed', 'src'=>'mixed', 'diff'=>'mixed'], 'XMLDiff\DOM::diff' => ['DOMDocument', 'from'=>'DOMDocument', 'to'=>'DOMDocument'], 'XMLDiff\DOM::merge' => ['DOMDocument', 'src'=>'DOMDocument', 'diff'=>'DOMDocument'], 'XMLDiff\File::diff' => ['string', 'from'=>'string', 'to'=>'string'], 'XMLDiff\File::merge' => ['string', 'src'=>'string', 'diff'=>'string'], 'XMLDiff\Memory::diff' => ['string', 'from'=>'string', 'to'=>'string'], 'XMLDiff\Memory::merge' => ['string', 'src'=>'string', 'diff'=>'string'], 'XMLReader::close' => ['bool'], 'XMLReader::expand' => ['DOMNode|false', 'basenode='=>'DOMNode'], 'XMLReader::getAttribute' => ['string|null', 'name'=>'string'], 'XMLReader::getAttributeNo' => ['string|null', 'index'=>'int'], 'XMLReader::getAttributeNs' => ['string|null', 'name'=>'string', 'namespaceuri'=>'string'], 'XMLReader::getParserProperty' => ['bool', 'property'=>'int'], 'XMLReader::isValid' => ['bool'], 'XMLReader::lookupNamespace' => ['?string', 'prefix'=>'string'], 'XMLReader::moveToAttribute' => ['bool', 'name'=>'string'], 'XMLReader::moveToAttributeNo' => ['bool', 'index'=>'int'], 'XMLReader::moveToAttributeNs' => ['bool', 'localname'=>'string', 'namespaceuri'=>'string'], 'XMLReader::moveToElement' => ['bool'], 'XMLReader::moveToFirstAttribute' => ['bool'], 'XMLReader::moveToNextAttribute' => ['bool'], 'XMLReader::next' => ['bool', 'localname='=>'string'], 'XMLReader::open' => ['bool|XMLReader', 'uri'=>'string', 'encoding='=>'?string', 'options='=>'int'], 'XMLReader::read' => ['bool'], 'XMLReader::readInnerXML' => ['string'], 'XMLReader::readOuterXML' => ['string'], 'XMLReader::readString' => ['string'], 'XMLReader::setParserProperty' => ['bool', 'property'=>'int', 'value'=>'bool'], 'XMLReader::setRelaxNGSchema' => ['bool', 'filename'=>'string'], 'XMLReader::setRelaxNGSchemaSource' => ['bool', 'source'=>'string'], 'XMLReader::setSchema' => ['bool', 'filename'=>'string'], 'XMLReader::XML' => ['bool|XMLReader', 'source'=>'string', 'encoding='=>'?string', 'options='=>'int'], 'xmlrpc_decode' => ['?array', 'xml'=>'string', 'encoding='=>'string'], 'xmlrpc_decode_request' => ['?array', 'xml'=>'string', '&w_method'=>'string', 'encoding='=>'string'], 'xmlrpc_encode' => ['string', 'value'=>'mixed'], 'xmlrpc_encode_request' => ['string', 'method'=>'string', 'params'=>'mixed', 'output_options='=>'array'], 'xmlrpc_get_type' => ['string', 'value'=>'mixed'], 'xmlrpc_is_fault' => ['bool', 'arg'=>'array'], 'xmlrpc_parse_method_descriptions' => ['array', 'xml'=>'string'], 'xmlrpc_server_add_introspection_data' => ['int', 'server'=>'resource', 'desc'=>'array'], 'xmlrpc_server_call_method' => ['string', 'server'=>'resource', 'xml'=>'string', 'user_data'=>'mixed', 'output_options='=>'array'], 'xmlrpc_server_create' => ['resource'], 'xmlrpc_server_destroy' => ['int', 'server'=>'resource'], 'xmlrpc_server_register_introspection_callback' => ['bool', 'server'=>'resource', 'function'=>'string'], 'xmlrpc_server_register_method' => ['bool', 'server'=>'resource', 'method_name'=>'string', 'function'=>'string'], 'xmlrpc_set_type' => ['bool', '&rw_value'=>'string|DateTime', 'type'=>'string'], 'XMLWriter::endAttribute' => ['bool'], 'XMLWriter::endCData' => ['bool'], 'XMLWriter::endComment' => ['bool'], 'XMLWriter::endDocument' => ['bool'], 'XMLWriter::endDTD' => ['bool', 'xmlwriter='=>''], 'XMLWriter::endDTDAttlist' => ['bool'], 'XMLWriter::endDTDElement' => ['bool'], 'XMLWriter::endDTDEntity' => ['bool'], 'XMLWriter::endElement' => ['bool'], 'XMLWriter::endPI' => ['bool'], 'XMLWriter::flush' => ['', 'empty='=>'bool', 'xmlwriter='=>''], 'XMLWriter::fullEndElement' => ['bool'], 'XMLWriter::openMemory' => ['bool'], 'XMLWriter::openURI' => ['bool', 'uri'=>'string'], 'XMLWriter::outputMemory' => ['string', 'flush='=>'bool', 'xmlwriter='=>''], 'XMLWriter::setIndent' => ['bool', 'indent'=>'bool'], 'XMLWriter::setIndentString' => ['bool', 'indentstring'=>'string'], 'XMLWriter::startAttribute' => ['bool', 'name'=>'string'], 'XMLWriter::startAttributeNS' => ['bool', 'prefix'=>'string|null', 'name'=>'string', 'uri'=>'string'], 'XMLWriter::startCData' => ['bool'], 'XMLWriter::startComment' => ['bool'], 'XMLWriter::startDocument' => ['bool', 'version='=>'string', 'encoding='=>'string', 'standalone='=>'string'], 'XMLWriter::startDTD' => ['bool', 'qualifiedname'=>'string', 'publicid='=>'string', 'systemid='=>'string'], 'XMLWriter::startDTDAttlist' => ['bool', 'name'=>'string'], 'XMLWriter::startDTDElement' => ['bool', 'qualifiedname'=>'string'], 'XMLWriter::startDTDEntity' => ['bool', 'name'=>'string', 'isparam'=>'bool'], 'XMLWriter::startElement' => ['bool', 'name'=>'string'], 'XMLWriter::startElementNS' => ['bool', 'prefix'=>'string|null', 'name'=>'string', 'uri'=>'string|null'], 'XMLWriter::startPI' => ['bool', 'target'=>'string'], 'XMLWriter::text' => ['bool', 'content'=>'string'], 'XMLWriter::writeAttribute' => ['bool', 'name'=>'string', 'value'=>'string'], 'XMLWriter::writeAttributeNS' => ['bool', 'prefix'=>'string|null', 'name'=>'string', 'uri'=>'string', 'content'=>'string'], 'XMLWriter::writeCData' => ['bool', 'content'=>'string'], 'XMLWriter::writeComment' => ['bool', 'content'=>'string'], 'XMLWriter::writeDTD' => ['bool', 'name'=>'string', 'publicid='=>'string', 'systemid='=>'string', 'subset='=>'string'], 'XMLWriter::writeDTDAttlist' => ['bool', 'name'=>'string', 'content'=>'string'], 'XMLWriter::writeDTDElement' => ['bool', 'name'=>'string', 'content'=>'string'], 'XMLWriter::writeDTDEntity' => ['bool', 'name'=>'string', 'content'=>'string', 'pe'=>'bool', 'pubid'=>'string', 'sysid'=>'string', 'ndataid'=>'string'], 'XMLWriter::writeElement' => ['bool', 'name'=>'string', 'content='=>'string|null'], 'XMLWriter::writeElementNS' => ['bool', 'prefix'=>'string|null', 'name'=>'string', 'uri'=>'string', 'content='=>'string|null'], 'XMLWriter::writePI' => ['bool', 'target'=>'string', 'content'=>'string'], 'XMLWriter::writeRaw' => ['bool', 'content'=>'string'], 'xmlwriter_end_attribute' => ['bool', 'xmlwriter'=>'resource'], 'xmlwriter_end_cdata' => ['bool', 'xmlwriter'=>'resource'], 'xmlwriter_end_comment' => ['bool', 'xmlwriter'=>'resource'], 'xmlwriter_end_document' => ['bool', 'xmlwriter'=>'resource'], 'xmlwriter_end_dtd' => ['bool', 'xmlwriter'=>'resource'], 'xmlwriter_end_dtd_attlist' => ['bool', 'xmlwriter'=>'resource'], 'xmlwriter_end_dtd_element' => ['bool', 'xmlwriter'=>'resource'], 'xmlwriter_end_dtd_entity' => ['bool', 'xmlwriter'=>'resource'], 'xmlwriter_end_element' => ['bool', 'xmlwriter'=>'resource'], 'xmlwriter_end_pi' => ['bool', 'xmlwriter'=>'resource'], 'xmlwriter_flush' => ['', 'xmlwriter'=>'resource', 'empty='=>'bool'], 'xmlwriter_full_end_element' => ['bool', 'xmlwriter'=>'resource'], 'xmlwriter_open_memory' => ['resource|false'], 'xmlwriter_open_uri' => ['resource|false', 'source'=>'string'], 'xmlwriter_output_memory' => ['string', 'xmlwriter'=>'resource', 'flush='=>'bool'], 'xmlwriter_set_indent' => ['bool', 'xmlwriter'=>'resource', 'indent'=>'bool'], 'xmlwriter_set_indent_string' => ['bool', 'xmlwriter'=>'resource', 'indentstring'=>'string'], 'xmlwriter_start_attribute' => ['bool', 'xmlwriter'=>'resource', 'name'=>'string'], 'xmlwriter_start_attribute_ns' => ['bool', 'xmlwriter'=>'resource', 'prefix'=>'string|null', 'name'=>'string', 'uri'=>'string'], 'xmlwriter_start_cdata' => ['bool', 'xmlwriter'=>'resource'], 'xmlwriter_start_comment' => ['bool', 'xmlwriter'=>'resource'], 'xmlwriter_start_document' => ['bool', 'xmlwriter'=>'resource', 'version'=>'string', 'encoding'=>'string', 'standalone'=>'string'], 'xmlwriter_start_dtd' => ['bool', 'xmlwriter'=>'resource', 'name'=>'string', 'pubid'=>'string', 'sysid'=>'string'], 'xmlwriter_start_dtd_attlist' => ['bool', 'xmlwriter'=>'resource', 'name'=>'string'], 'xmlwriter_start_dtd_element' => ['bool', 'xmlwriter'=>'resource', 'name'=>'string'], 'xmlwriter_start_dtd_entity' => ['bool', 'xmlwriter'=>'resource', 'name'=>'string', 'isparam'=>'bool'], 'xmlwriter_start_element' => ['bool', 'xmlwriter'=>'resource', 'name'=>'string'], 'xmlwriter_start_element_ns' => ['bool', 'xmlwriter'=>'resource', 'prefix'=>'string|null', 'name'=>'string', 'uri'=>'string|null'], 'xmlwriter_start_pi' => ['bool', 'xmlwriter'=>'resource', 'target'=>'string'], 'xmlwriter_text' => ['bool', 'xmlwriter'=>'resource', 'content'=>'string'], 'xmlwriter_write_attribute' => ['bool', 'xmlwriter'=>'resource', 'name'=>'string', 'content'=>'string'], 'xmlwriter_write_attribute_ns' => ['bool', 'xmlwriter'=>'resource', 'prefix'=>'string|null', 'name'=>'string', 'uri'=>'string', 'content'=>'string'], 'xmlwriter_write_cdata' => ['bool', 'xmlwriter'=>'resource', 'content'=>'string'], 'xmlwriter_write_comment' => ['bool', 'xmlwriter'=>'resource', 'content'=>'string'], 'xmlwriter_write_dtd' => ['bool', 'xmlwriter'=>'resource', 'name'=>'string', 'pubid'=>'string', 'sysid'=>'string', 'subset'=>'string'], 'xmlwriter_write_dtd_attlist' => ['bool', 'xmlwriter'=>'resource', 'name'=>'string', 'content'=>'string'], 'xmlwriter_write_dtd_element' => ['bool', 'xmlwriter'=>'resource', 'name'=>'string', 'content'=>'string'], 'xmlwriter_write_dtd_entity' => ['bool', 'xmlwriter'=>'resource', 'name'=>'string', 'content'=>'string', 'pe'=>'int', 'pubid'=>'string', 'sysid'=>'string', 'ndataid'=>'string'], 'xmlwriter_write_element' => ['bool', 'xmlwriter'=>'resource', 'name'=>'string', 'content'=>'string'], 'xmlwriter_write_element_ns' => ['bool', 'xmlwriter'=>'resource', 'prefix'=>'string|null', 'name'=>'string', 'uri'=>'string', 'content'=>'string'], 'xmlwriter_write_pi' => ['bool', 'xmlwriter'=>'resource', 'target'=>'string', 'content'=>'string'], 'xmlwriter_write_raw' => ['bool', 'xmlwriter'=>'resource', 'content'=>'string'], 'xpath_new_context' => ['XPathContext', 'dom_document'=>'DOMDocument'], 'xpath_register_ns' => ['bool', 'xpath_context'=>'xpathcontext', 'prefix'=>'string', 'uri'=>'string'], 'xpath_register_ns_auto' => ['bool', 'xpath_context'=>'xpathcontext', 'context_node='=>'object'], 'xptr_new_context' => ['XPathContext'], 'xsl_xsltprocessor_get_parameter' => ['string', 'namespace'=>'string', 'name'=>'string'], 'xsl_xsltprocessor_get_security_prefs' => ['int'], 'xsl_xsltprocessor_has_exslt_support' => ['bool'], 'xsl_xsltprocessor_register_php_functions' => ['', 'restrict'=>''], 'xsl_xsltprocessor_remove_parameter' => ['bool', 'namespace'=>'string', 'name'=>'string'], 'xsl_xsltprocessor_set_parameter' => ['bool', 'namespace'=>'string', 'name'=>'', 'value'=>'string'], 'xsl_xsltprocessor_set_profiling' => ['bool', 'filename'=>'string'], 'xsl_xsltprocessor_set_security_prefs' => ['int', 'securityprefs'=>'int'], 'xsl_xsltprocessor_transform_to_uri' => ['int', 'doc'=>'DOMDocument', 'uri'=>'string'], 'xsl_xsltprocessor_transform_to_xml' => ['string', 'doc'=>'DOMDocument'], 'xslt_backend_info' => ['string'], 'xslt_backend_name' => ['string'], 'xslt_backend_version' => ['string'], 'xslt_create' => ['resource'], 'xslt_errno' => ['int', 'xh'=>''], 'xslt_error' => ['string', 'xh'=>''], 'xslt_free' => ['', 'xh'=>''], 'xslt_getopt' => ['int', 'processor'=>''], 'xslt_process' => ['', 'xh'=>'', 'xmlcontainer'=>'string', 'xslcontainer'=>'string', 'resultcontainer='=>'string', 'arguments='=>'array', 'parameters='=>'array'], 'xslt_set_base' => ['', 'xh'=>'', 'uri'=>'string'], 'xslt_set_encoding' => ['', 'xh'=>'', 'encoding'=>'string'], 'xslt_set_error_handler' => ['', 'xh'=>'', 'handler'=>''], 'xslt_set_log' => ['', 'xh'=>'', 'log='=>''], 'xslt_set_object' => ['bool', 'processor'=>'', 'obj'=>'object'], 'xslt_set_sax_handler' => ['', 'xh'=>'', 'handlers'=>'array'], 'xslt_set_sax_handlers' => ['', 'processor'=>'', 'handlers'=>'array'], 'xslt_set_scheme_handler' => ['', 'xh'=>'', 'handlers'=>'array'], 'xslt_set_scheme_handlers' => ['', 'xh'=>'', 'handlers'=>'array'], 'xslt_setopt' => ['', 'processor'=>'', 'newmask'=>'int'], 'XSLTProcessor::getParameter' => ['string|false', 'namespaceuri'=>'string', 'localname'=>'string'], 'XsltProcessor::getSecurityPrefs' => ['int'], 'XSLTProcessor::hasExsltSupport' => ['bool'], 'XSLTProcessor::importStylesheet' => ['bool', 'stylesheet'=>'object'], 'XSLTProcessor::registerPHPFunctions' => ['void', 'restrict='=>'mixed'], 'XSLTProcessor::removeParameter' => ['bool', 'namespaceuri'=>'string', 'localname'=>'string'], 'XSLTProcessor::setParameter' => ['bool', 'namespace'=>'string', 'name'=>'string', 'value'=>'string'], 'XSLTProcessor::setParameter\'1' => ['bool', 'namespace'=>'string', 'options'=>'array'], 'XSLTProcessor::setProfiling' => ['bool', 'filename'=>'string'], 'XsltProcessor::setSecurityPrefs' => ['int', 'securityPrefs'=>'int'], 'XSLTProcessor::transformToDoc' => ['DOMDocument|false', 'doc'=>'DOMNode'], 'XSLTProcessor::transformToURI' => ['int', 'doc'=>'DOMDocument', 'uri'=>'string'], 'XSLTProcessor::transformToXML' => ['string|false|null', 'doc'=>'DOMDocument|SimpleXMLElement'], 'Yaconf::get' => ['mixed', 'name'=>'string', 'default_value='=>'mixed'], 'Yaconf::has' => ['bool', 'name'=>'string'], 'Yaf_Action_Abstract::__construct' => ['void', 'request'=>'Yaf_Request_Abstract', 'response'=>'Yaf_Response_Abstract', 'view'=>'Yaf_View_Interface', 'invokeArgs='=>'?array'], 'Yaf_Action_Abstract::display' => ['bool', 'tpl'=>'string', 'parameters='=>'?array'], 'Yaf_Action_Abstract::execute' => ['mixed', 'arg='=>'mixed', '...args='=>'mixed'], 'Yaf_Action_Abstract::forward' => ['bool', 'module'=>'string', 'controller='=>'string', 'action='=>'string', 'parameters='=>'?array'], 'Yaf_Action_Abstract::getController' => ['Yaf_Controller_Abstract'], 'Yaf_Action_Abstract::getInvokeArg' => ['mixed|null', 'name'=>'string'], 'Yaf_Action_Abstract::getInvokeArgs' => ['array'], 'Yaf_Action_Abstract::getModuleName' => ['string'], 'Yaf_Action_Abstract::getRequest' => ['Yaf_Request_Abstract'], 'Yaf_Action_Abstract::getResponse' => ['Yaf_Response_Abstract'], 'Yaf_Action_Abstract::getView' => ['Yaf_View_Interface'], 'Yaf_Action_Abstract::getViewpath' => ['string'], 'Yaf_Action_Abstract::init' => [''], 'Yaf_Action_Abstract::initView' => ['Yaf_Response_Abstract', 'options='=>'?array'], 'Yaf_Action_Abstract::redirect' => ['bool', 'url'=>'string'], 'Yaf_Action_Abstract::render' => ['string', 'tpl'=>'string', 'parameters='=>'?array'], 'Yaf_Action_Abstract::setViewpath' => ['bool', 'view_directory'=>'string'], 'Yaf_Application::__clone' => ['void'], 'Yaf_Application::__construct' => ['void', 'config'=>'mixed', 'envrion='=>'string'], 'Yaf_Application::__destruct' => ['void'], 'Yaf_Application::__sleep' => ['list<string>'], 'Yaf_Application::__wakeup' => ['void'], 'Yaf_Application::app' => ['void'], 'Yaf_Application::bootstrap' => ['void', 'bootstrap='=>'Yaf_Bootstrap_Abstract'], 'Yaf_Application::clearLastError' => ['Yaf_Application'], 'Yaf_Application::environ' => ['void'], 'Yaf_Application::execute' => ['void', 'entry'=>'callable', '...args'=>'string'], 'Yaf_Application::getAppDirectory' => ['Yaf_Application'], 'Yaf_Application::getConfig' => ['Yaf_Config_Abstract'], 'Yaf_Application::getDispatcher' => ['Yaf_Dispatcher'], 'Yaf_Application::getLastErrorMsg' => ['string'], 'Yaf_Application::getLastErrorNo' => ['int'], 'Yaf_Application::getModules' => ['array'], 'Yaf_Application::run' => ['void'], 'Yaf_Application::setAppDirectory' => ['Yaf_Application', 'directory'=>'string'], 'Yaf_Config_Abstract::__get' => ['mixed', 'name'=>'string'], 'Yaf_Config_Abstract::__isset' => ['bool', 'name'=>'string'], 'Yaf_Config_Abstract::count' => ['0|positive-int'], 'Yaf_Config_Abstract::current' => ['mixed'], 'Yaf_Config_Abstract::get' => ['mixed', 'name'=>'?string'], 'Yaf_Config_Abstract::key' => ['int|string|null|bool'], 'Yaf_Config_Abstract::next' => ['void'], 'Yaf_Config_Abstract::offsetExists' => ['bool', 'name'=>'mixed'], 'Yaf_Config_Abstract::offsetGet' => ['mixed', 'name'=>'mixed'], 'Yaf_Config_Abstract::offsetSet' => ['void', 'name'=>'mixed', 'value'=>'mixed'], 'Yaf_Config_Abstract::offsetUnset' => ['void', 'name'=>'mixed'], 'Yaf_Config_Abstract::readonly' => ['bool'], 'Yaf_Config_Abstract::rewind' => ['void'], 'Yaf_Config_Abstract::set' => ['bool', 'name'=>'string', 'value'=>'mixed'], 'Yaf_Config_Abstract::toArray' => ['array'], 'Yaf_Config_Abstract::valid' => ['bool'], 'Yaf_Config_Ini::__construct' => ['void', 'config_file'=>'array<string,mixed>|string', 'section='=>'?string'], 'Yaf_Config_Ini::__isset' => ['bool', 'name'=>'string'], 'Yaf_Config_Ini::__set' => ['void', 'name'=>'mixed', 'value'=>'mixed'], 'Yaf_Config_Ini::count' => ['0|positive-int'], 'Yaf_Config_Ini::current' => ['mixed'], 'Yaf_Config_Ini::get' => ['mixed', 'name='=>'?string'], 'Yaf_Config_Ini::key' => ['int|string|null|bool'], 'Yaf_Config_Ini::next' => ['void'], 'Yaf_Config_Ini::offsetExists' => ['bool', 'name'=>'mixed'], 'Yaf_Config_Ini::offsetGet' => ['mixed', 'name'=>'mixed'], 'Yaf_Config_Ini::offsetSet' => ['void', 'name'=>'mixed', 'value'=>'mixed'], 'Yaf_Config_Ini::offsetUnset' => ['void', 'name'=>'mixed'], 'Yaf_Config_Ini::readonly' => ['bool'], 'Yaf_Config_Ini::rewind' => ['void'], 'Yaf_Config_Ini::set' => ['bool', 'name'=>'string', 'value'=>'mixed'], 'Yaf_Config_Ini::toArray' => ['array'], 'Yaf_Config_Ini::valid' => ['bool'], 'Yaf_Config_Simple::__construct' => ['void', 'config_file'=>'array<string,mixed>|string', 'section='=>'string'], 'Yaf_Config_Simple::__get' => ['void', 'name='=>'string'], 'Yaf_Config_Simple::__isset' => ['bool', 'name'=>'string'], 'Yaf_Config_Simple::__set' => ['void', 'name'=>'string', 'value'=>'mixed'], 'Yaf_Config_Simple::count' => ['0|positive-int'], 'Yaf_Config_Simple::current' => ['mixed'], 'Yaf_Config_Simple::get' => ['mixed', 'name='=>'?string'], 'Yaf_Config_Simple::key' => ['int|string|null|bool'], 'Yaf_Config_Simple::next' => ['void'], 'Yaf_Config_Simple::offsetExists' => ['bool', 'name'=>'mixed'], 'Yaf_Config_Simple::offsetGet' => ['mixed', 'name'=>'mixed'], 'Yaf_Config_Simple::offsetSet' => ['void', 'name'=>'mixed', 'value'=>'mixed'], 'Yaf_Config_Simple::offsetUnset' => ['void', 'name'=>'mixed'], 'Yaf_Config_Simple::readonly' => ['bool'], 'Yaf_Config_Simple::rewind' => ['void'], 'Yaf_Config_Simple::set' => ['bool', 'name'=>'string', 'value'=>'mixed'], 'Yaf_Config_Simple::toArray' => ['array'], 'Yaf_Config_Simple::valid' => ['bool'], 'Yaf_Controller_Abstract::__clone' => ['void'], 'Yaf_Controller_Abstract::__construct' => ['void'], 'Yaf_Controller_Abstract::display' => ['?bool', 'tpl'=>'string', 'parameters='=>'?array'], 'Yaf_Controller_Abstract::forward' => ['?bool', 'action'=>'string'], 'Yaf_Controller_Abstract::forward\'1' => ['?bool', 'controller'=>'string', 'action'=>'string'], 'Yaf_Controller_Abstract::forward\'2' => ['?bool', 'action'=>'string', 'invoke_args'=>'array'], 'Yaf_Controller_Abstract::forward\'3' => ['?bool', 'module'=>'string', 'controller'=>'string', 'action'=>'string'], 'Yaf_Controller_Abstract::forward\'4' => ['?bool', 'controller'=>'string', 'action'=>'string', 'invoke_args'=>'array'], 'Yaf_Controller_Abstract::forward\'5' => ['?bool', 'module'=>'string', 'controller'=>'string', 'action'=>'string', 'invoke_args'=>'array'], 'Yaf_Controller_Abstract::getInvokeArg' => ['?string', 'name'=>'string'], 'Yaf_Controller_Abstract::getInvokeArgs' => ['?array'], 'Yaf_Controller_Abstract::getModuleName' => ['?string'], 'Yaf_Controller_Abstract::getName' => ['?string'], 'Yaf_Controller_Abstract::getRequest' => ['?Yaf_Request_Abstract'], 'Yaf_Controller_Abstract::getResponse' => ['?Yaf_Response_Abstract'], 'Yaf_Controller_Abstract::getView' => ['?Yaf_View_Interface'], 'Yaf_Controller_Abstract::getViewpath' => ['?string'], 'Yaf_Controller_Abstract::init' => ['void'], 'Yaf_Controller_Abstract::initView' => ['?Yaf_View_Interface', 'options='=>'?array'], 'Yaf_Controller_Abstract::redirect' => ['?bool', 'url'=>'string'], 'Yaf_Controller_Abstract::render' => ['string|null|bool', 'tpl'=>'string', 'parameters='=>'?array'], 'Yaf_Controller_Abstract::setViewpath' => ['?bool', 'view_directory'=>'string'], 'Yaf_Dispatcher::__clone' => ['void'], 'Yaf_Dispatcher::__construct' => ['void'], 'Yaf_Dispatcher::__sleep' => ['list<string>'], 'Yaf_Dispatcher::__wakeup' => ['void'], 'Yaf_Dispatcher::autoRender' => ['Yaf_Dispatcher|false|null', 'flag='=>'?bool'], 'Yaf_Dispatcher::catchException' => ['Yaf_Dispatcher|false|null', 'flag='=>'?bool'], 'Yaf_Dispatcher::disableView' => ['?Yaf_Dispatcher'], 'Yaf_Dispatcher::dispatch' => ['Yaf_Response_Abstract|false|null', 'request'=>'Yaf_Request_Abstract'], 'Yaf_Dispatcher::enableView' => ['?Yaf_Dispatcher'], 'Yaf_Dispatcher::flushInstantly' => ['Yaf_Dispatcher|false|null', 'flag='=>'?bool'], 'Yaf_Dispatcher::getApplication' => ['?Yaf_Application'], 'Yaf_Dispatcher::getDefaultAction' => ['?string'], 'Yaf_Dispatcher::getDefaultController' => ['?string'], 'Yaf_Dispatcher::getDefaultModule' => ['?string'], 'Yaf_Dispatcher::getInstance' => ['?Yaf_Dispatcher'], 'Yaf_Dispatcher::getRequest' => ['?Yaf_Request_Abstract'], 'Yaf_Dispatcher::getResponse' => ['?Yaf_Response_Abstract'], 'Yaf_Dispatcher::getRouter' => ['?Yaf_Router'], 'Yaf_Dispatcher::initView' => ['Yaf_View_Interface|null|false', 'templates_dir'=>'string', 'options='=>'?array'], 'Yaf_Dispatcher::registerPlugin' => ['Yaf_Dispatcher|false|null', 'plugin'=>'Yaf_Plugin_Abstract'], 'Yaf_Dispatcher::returnResponse' => ['Yaf_Dispatcher|false|null', 'flag='=>'bool'], 'Yaf_Dispatcher::setDefaultAction' => ['Yaf_Dispatcher|false|null', 'action'=>'string'], 'Yaf_Dispatcher::setDefaultController' => ['Yaf_Dispatcher|false|null', 'controller'=>'string'], 'Yaf_Dispatcher::setDefaultModule' => ['Yaf_Dispatcher|false|null', 'module'=>'string'], 'Yaf_Dispatcher::setErrorHandler' => ['Yaf_Dispatcher|false|null', 'callback'=>'mixed', 'error_types'=>'int'], 'Yaf_Dispatcher::setRequest' => ['?Yaf_Dispatcher', 'request'=>'Yaf_Request_Abstract'], 'Yaf_Dispatcher::setResponse' => ['?Yaf_Dispatcher', 'response'=>'Yaf_Response_Abstract'], 'Yaf_Dispatcher::setView' => ['?Yaf_Dispatcher', 'view'=>'Yaf_View_Interface'], 'Yaf_Dispatcher::throwException' => ['Yaf_Dispatcher|false|null', 'flag='=>'?bool'], 'Yaf_Exception::__construct' => ['void'], 'Yaf_Exception::getPrevious' => ['void'], 'Yaf_Loader::__clone' => ['void'], 'Yaf_Loader::__construct' => ['void'], 'Yaf_Loader::__sleep' => ['list<string>'], 'Yaf_Loader::__wakeup' => ['void'], 'Yaf_Loader::autoload' => ['void'], 'Yaf_Loader::clearLocalNamespace' => ['void'], 'Yaf_Loader::getInstance' => ['void'], 'Yaf_Loader::getLibraryPath' => ['Yaf_Loader', 'is_global='=>'bool'], 'Yaf_Loader::getLocalNamespace' => ['void'], 'Yaf_Loader::import' => ['void'], 'Yaf_Loader::isLocalName' => ['void'], 'Yaf_Loader::registerLocalNamespace' => ['void', 'prefix'=>'mixed'], 'Yaf_Loader::setLibraryPath' => ['Yaf_Loader', 'directory'=>'string', 'is_global='=>'bool'], 'Yaf_Plugin_Abstract::dispatchLoopShutdown' => ['void', 'request'=>'Yaf_Request_Abstract', 'response'=>'Yaf_Response_Abstract'], 'Yaf_Plugin_Abstract::dispatchLoopStartup' => ['void', 'request'=>'Yaf_Request_Abstract', 'response'=>'Yaf_Response_Abstract'], 'Yaf_Plugin_Abstract::postDispatch' => ['void', 'request'=>'Yaf_Request_Abstract', 'response'=>'Yaf_Response_Abstract'], 'Yaf_Plugin_Abstract::preDispatch' => ['void', 'request'=>'Yaf_Request_Abstract', 'response'=>'Yaf_Response_Abstract'], 'Yaf_Plugin_Abstract::preResponse' => ['void', 'request'=>'Yaf_Request_Abstract', 'response'=>'Yaf_Response_Abstract'], 'Yaf_Plugin_Abstract::routerShutdown' => ['void', 'request'=>'Yaf_Request_Abstract', 'response'=>'Yaf_Response_Abstract'], 'Yaf_Plugin_Abstract::routerStartup' => ['void', 'request'=>'Yaf_Request_Abstract', 'response'=>'Yaf_Response_Abstract'], 'Yaf_Registry::__clone' => ['void'], 'Yaf_Registry::__construct' => ['void'], 'Yaf_Registry::del' => ['void', 'name'=>'string'], 'Yaf_Registry::get' => ['mixed', 'name'=>'string'], 'Yaf_Registry::has' => ['bool', 'name'=>'string'], 'Yaf_Registry::set' => ['bool', 'name'=>'string', 'value'=>'string'], 'Yaf_Request_Abstract::get' => ['mixed', 'name='=>'?string', 'default='=>'?mixed'], 'Yaf_Request_Abstract::getActionName' => ['?string'], 'Yaf_Request_Abstract::getBaseUri' => ['?string'], 'Yaf_Request_Abstract::getCookie' => ['mixed', 'name='=>'?string', 'default='=>'?mixed'], 'Yaf_Request_Abstract::getControllerName' => ['?string'], 'Yaf_Request_Abstract::getEnv' => ['mixed', 'name='=>'?string', 'default='=>'?mixed'], 'Yaf_Request_Abstract::getException' => ['?Exception'], 'Yaf_Request_Abstract::getFiles' => ['mixed', 'name='=>'?string', 'default='=>'?mixed'], 'Yaf_Request_Abstract::getLanguage' => ['?string'], 'Yaf_Request_Abstract::getMethod' => ['?string'], 'Yaf_Request_Abstract::getModuleName' => ['?string'], 'Yaf_Request_Abstract::getParam' => ['mixed', 'name'=>'string', 'default='=>'mixed'], 'Yaf_Request_Abstract::getParams' => ['?array'], 'Yaf_Request_Abstract::getPost' => ['mixed', 'name='=>'?string', 'default='=>'?mixed'], 'Yaf_Request_Abstract::getQuery' => ['mixed', 'name='=>'?string', 'default='=>'?mixed'], 'Yaf_Request_Abstract::getRaw' => ['?string'], 'Yaf_Request_Abstract::getRequest' => ['mixed', 'name='=>'?string', 'default='=>'?mixed'], 'Yaf_Request_Abstract::getRequestUri' => ['?string'], 'Yaf_Request_Abstract::getServer' => ['mixed', 'name='=>'?string', 'default='=>'?mixed'], 'Yaf_Request_Abstract::cleanParams' => ['?Yaf_Request_Abstract'], 'Yaf_Request_Abstract::isCli' => ['bool'], 'Yaf_Request_Abstract::isDelete' => ['bool'], 'Yaf_Request_Abstract::isDispatched' => ['bool'], 'Yaf_Request_Abstract::isGet' => ['bool'], 'Yaf_Request_Abstract::isHead' => ['bool'], 'Yaf_Request_Abstract::isOptions' => ['bool'], 'Yaf_Request_Abstract::isPatch' => ['bool'], 'Yaf_Request_Abstract::isPost' => ['bool'], 'Yaf_Request_Abstract::isPut' => ['bool'], 'Yaf_Request_Abstract::isRouted' => ['bool'], 'Yaf_Request_Abstract::isXmlHttpRequest' => ['bool'], 'Yaf_Request_Abstract::setActionName' => ['?Yaf_Request_Abstract', 'action'=>'string', 'format_name='=>'bool|true'], 'Yaf_Request_Abstract::setBaseUri' => ['Yaf_Request_Abstract|false', 'uir'=>'string'], 'Yaf_Request_Abstract::setControllerName' => ['?Yaf_Request_Abstract', 'controller'=>'string', 'format_name='=>'bool|true'], 'Yaf_Request_Abstract::setDispatched' => ['?Yaf_Request_Abstract', 'flag='=>'bool|true'], 'Yaf_Request_Abstract::setModuleName' => ['?Yaf_Request_Abstract', 'module'=>'string', 'format_name='=>'bool|true'], 'Yaf_Request_Abstract::setParam' => ['Yaf_Request_Abstract|false|null', 'name'=>'mixed', 'value='=>'?mixed'], 'Yaf_Request_Abstract::setRequestUri' => ['?Yaf_Request_Abstract', 'uir'=>'string'], 'Yaf_Request_Abstract::setRouted' => ['?Yaf_Request_Abstract', 'flag='=>'bool|true'], 'Yaf_Request_Http::__clone' => ['void'], 'Yaf_Request_Http::__construct' => ['void', 'requestUri='=>'?string', 'baseUri='=>'?string'], 'Yaf_Request_Http::get' => ['mixed', 'name='=>'?string', 'default='=>'?mixed'], 'Yaf_Request_Http::getActionName' => ['?string'], 'Yaf_Request_Http::getBaseUri' => ['?string'], 'Yaf_Request_Http::getCookie' => ['mixed', 'name='=>'?string', 'default='=>'?mixed'], 'Yaf_Request_Http::getControllerName' => ['?string'], 'Yaf_Request_Http::getEnv' => ['mixed', 'name='=>'?string', 'default='=>'?mixed'], 'Yaf_Request_Http::getException' => ['?Exception'], 'Yaf_Request_Http::getFiles' => ['mixed', 'name='=>'?string', 'default='=>'?mixed'], 'Yaf_Request_Http::getLanguage' => ['?string'], 'Yaf_Request_Http::getMethod' => ['?string'], 'Yaf_Request_Http::getModuleName' => ['?string'], 'Yaf_Request_Http::getParam' => ['mixed', 'name'=>'string', 'default='=>'mixed'], 'Yaf_Request_Http::getParams' => ['?array'], 'Yaf_Request_Http::getPost' => ['mixed', 'name='=>'?string', 'default='=>'?mixed'], 'Yaf_Request_Http::getQuery' => ['mixed', 'name='=>'?string', 'default='=>'?mixed'], 'Yaf_Request_Http::getRaw' => ['?string'], 'Yaf_Request_Http::getRequest' => ['mixed', 'name='=>'?string', 'default='=>'?mixed'], 'Yaf_Request_Http::getRequestUri' => ['?string'], 'Yaf_Request_Http::getServer' => ['mixed', 'name='=>'?string', 'default='=>'?mixed'], 'Yaf_Request_Http::cleanParams' => ['?Yaf_Request_Http'], 'Yaf_Request_Http::isCli' => ['bool'], 'Yaf_Request_Http::isDelete' => ['bool'], 'Yaf_Request_Http::isDispatched' => ['bool'], 'Yaf_Request_Http::isGet' => ['bool'], 'Yaf_Request_Http::isHead' => ['bool'], 'Yaf_Request_Http::isOptions' => ['bool'], 'Yaf_Request_Http::isPatch' => ['bool'], 'Yaf_Request_Http::isPost' => ['bool'], 'Yaf_Request_Http::isPut' => ['bool'], 'Yaf_Request_Http::isRouted' => ['bool'], 'Yaf_Request_Http::isXmlHttpRequest' => ['bool'], 'Yaf_Request_Http::setActionName' => ['?Yaf_Request_Http', 'action'=>'string', 'format_name='=>'bool|true'], 'Yaf_Request_Http::setBaseUri' => ['Yaf_Request_Http|false', 'uir'=>'string'], 'Yaf_Request_Http::setControllerName' => ['?Yaf_Request_Http', 'controller'=>'string', 'format_name='=>'bool|true'], 'Yaf_Request_Http::setDispatched' => ['?Yaf_Request_Http', 'flag='=>'bool|true'], 'Yaf_Request_Http::setModuleName' => ['?Yaf_Request_Http', 'module'=>'string', 'format_name='=>'bool|true'], 'Yaf_Request_Http::setParam' => ['Yaf_Request_Http|false|null', 'name'=>'mixed', 'value='=>'?mixed'], 'Yaf_Request_Http::setRequestUri' => ['?Yaf_Request_Http', 'uir'=>'string'], 'Yaf_Request_Http::setRouted' => ['?Yaf_Request_Http', 'flag='=>'bool|true'], 'Yaf_Request_Simple::__construct' => ['void', 'method='=>'?string', 'module='=>'?string', 'controller='=>'?string', 'action='=>'?string', 'params='=>'?array'], 'Yaf_Request_Simple::get' => ['mixed', 'name='=>'?string', 'default='=>'?mixed'], 'Yaf_Request_Simple::getActionName' => ['?string'], 'Yaf_Request_Simple::getBaseUri' => ['?string'], 'Yaf_Request_Simple::getCookie' => ['mixed', 'name='=>'?string', 'default='=>'?mixed'], 'Yaf_Request_Simple::getControllerName' => ['?string'], 'Yaf_Request_Simple::getEnv' => ['mixed', 'name='=>'?string', 'default='=>'?mixed'], 'Yaf_Request_Simple::getException' => ['?Exception'], 'Yaf_Request_Simple::getFiles' => ['mixed', 'name='=>'?string', 'default='=>'?mixed'], 'Yaf_Request_Simple::getLanguage' => ['?string'], 'Yaf_Request_Simple::getMethod' => ['?string'], 'Yaf_Request_Simple::getModuleName' => ['?string'], 'Yaf_Request_Simple::getParam' => ['mixed', 'name'=>'string', 'default='=>'mixed'], 'Yaf_Request_Simple::getParams' => ['?array'], 'Yaf_Request_Simple::getPost' => ['mixed', 'name='=>'?string', 'default='=>'?mixed'], 'Yaf_Request_Simple::getQuery' => ['mixed', 'name='=>'?string', 'default='=>'?mixed'], 'Yaf_Request_Simple::getRaw' => ['?string'], 'Yaf_Request_Simple::getRequest' => ['mixed', 'name='=>'?string', 'default='=>'?mixed'], 'Yaf_Request_Simple::getRequestUri' => ['?string'], 'Yaf_Request_Simple::getServer' => ['mixed', 'name='=>'?string', 'default='=>'?mixed'], 'Yaf_Request_Simple::cleanParams' => ['?Yaf_Request_Simple'], 'Yaf_Request_Simple::isCli' => ['bool'], 'Yaf_Request_Simple::isDelete' => ['bool'], 'Yaf_Request_Simple::isDispatched' => ['bool'], 'Yaf_Request_Simple::isGet' => ['bool'], 'Yaf_Request_Simple::isHead' => ['bool'], 'Yaf_Request_Simple::isOptions' => ['bool'], 'Yaf_Request_Simple::isPatch' => ['bool'], 'Yaf_Request_Simple::isPost' => ['bool'], 'Yaf_Request_Simple::isPut' => ['bool'], 'Yaf_Request_Simple::isRouted' => ['bool'], 'Yaf_Request_Simple::isXmlHttpRequest' => ['bool'], 'Yaf_Request_Simple::setActionName' => ['?Yaf_Request_Simple', 'action'=>'string', 'format_name='=>'bool|true'], 'Yaf_Request_Simple::setBaseUri' => ['Yaf_Request_Simple|false', 'uir'=>'string'], 'Yaf_Request_Simple::setControllerName' => ['?Yaf_Request_Simple', 'controller'=>'string', 'format_name='=>'bool|true'], 'Yaf_Request_Simple::setDispatched' => ['?Yaf_Request_Simple', 'flag='=>'bool|true'], 'Yaf_Request_Simple::setModuleName' => ['?Yaf_Request_Simple', 'module'=>'string', 'format_name='=>'bool|true'], 'Yaf_Request_Simple::setParam' => ['Yaf_Request_Simple|bool|null', 'name'=>'mixed', 'value='=>'?mixed'], 'Yaf_Request_Simple::setRequestUri' => ['?Yaf_Request_Simple', 'uir'=>'string'], 'Yaf_Request_Simple::setRouted' => ['?Yaf_Request_Simple', 'flag='=>'bool|true'], 'Yaf_Response_Abstract::__clone' => ['void'], 'Yaf_Response_Abstract::__construct' => ['void'], 'Yaf_Response_Abstract::__destruct' => ['void'], 'Yaf_Response_Abstract::__toString' => ['string'], 'Yaf_Response_Abstract::appendBody' => ['Yaf_Response_Abstract|false|null', 'body'=>'string', 'name='=>'?string'], 'Yaf_Response_Abstract::clearBody' => ['?Yaf_Response_Abstract', 'name='=>'?string'], 'Yaf_Response_Abstract::getBody' => ['mixed', 'name='=>'string'], 'Yaf_Response_Abstract::prependBody' => ['Yaf_Response_Abstract|false|null', 'body'=>'string', 'name='=>'?string'], 'Yaf_Response_Abstract::response' => ['bool'], 'Yaf_Response_Abstract::setBody' => ['Yaf_Response_Abstract|false|null', 'body'=>'string', 'name='=>'?string'], 'Yaf_Response_Abstract::setRedirect' => ['?bool', 'url'=>'string'], 'Yaf_Response_Cli::__clone' => ['void'], 'Yaf_Response_Cli::__construct' => ['void'], 'Yaf_Response_Cli::__destruct' => ['void'], 'Yaf_Response_Cli::__toString' => ['string'], 'Yaf_Response_Cli::appendBody' => ['Yaf_Response_Cli|false|null', 'body'=>'string', 'name='=>'?string'], 'Yaf_Response_Cli::clearBody' => ['?Yaf_Response_Cli', 'name='=>'?string'], 'Yaf_Response_Cli::getBody' => ['mixed', 'name='=>'string'], 'Yaf_Response_Cli::prependBody' => ['Yaf_Response_Cli|false|null', 'body'=>'string', 'name='=>'?string'], 'Yaf_Response_Cli::response' => ['bool'], 'Yaf_Response_Cli::setBody' => ['Yaf_Response_Cli|false|null', 'body'=>'string', 'name='=>'?string'], 'Yaf_Response_Cli::setRedirect' => ['?bool', 'url'=>'string'], 'Yaf_Response_Http::__clone' => ['void'], 'Yaf_Response_Http::__construct' => ['void'], 'Yaf_Response_Http::__destruct' => ['void'], 'Yaf_Response_Http::__toString' => ['string'], 'Yaf_Response_Http::appendBody' => ['Yaf_Response_Http|false|null', 'body'=>'string', 'name='=>'?string'], 'Yaf_Response_Http::clearHeaders' => ['Yaf_Response_Http|false|null'], 'Yaf_Response_Http::clearBody' => ['?Yaf_Response_Http', 'name='=>'?string'], 'Yaf_Response_Http::getBody' => ['mixed', 'name='=>'string'], 'Yaf_Response_Http::getHeader' => ['mixed', 'name='=>'string'], 'Yaf_Response_Http::prependBody' => ['Yaf_Response_Http|false|null', 'body'=>'string', 'name='=>'?string'], 'Yaf_Response_Http::response' => ['?bool'], 'Yaf_Response_Http::setAllHeaders' => ['bool', 'headers'=>'array'], 'Yaf_Response_Http::setBody' => ['Yaf_Response_Http|false|null', 'body'=>'string', 'name='=>'?string'], 'Yaf_Response_Http::setHeader' => ['?bool', 'name'=>'string', 'value'=>'string', 'replace='=>'bool|false', 'response_code='=>'int'], 'Yaf_Response_Http::setRedirect' => ['?bool', 'url'=>'string'], 'Yaf_Route_Interface::__construct' => ['void'], 'Yaf_Route_Interface::assemble' => ['string', 'info'=>'array', 'query='=>'array'], 'Yaf_Route_Interface::route' => ['bool', 'request'=>'Yaf_Request_Abstract'], 'Yaf_Route_Map::__construct' => ['void', 'controller_prefer='=>'string', 'delimiter='=>'string'], 'Yaf_Route_Map::assemble' => ['string', 'info'=>'array', 'query='=>'array'], 'Yaf_Route_Map::route' => ['bool', 'request'=>'Yaf_Request_Abstract'], 'Yaf_Route_Regex::__construct' => ['void', 'match'=>'string', 'route'=>'array', 'map='=>'array', 'verify='=>'array', 'reverse='=>'string'], 'Yaf_Route_Regex::addConfig' => ['Yaf_Router|bool', 'config'=>'Yaf_Config_Abstract'], 'Yaf_Route_Regex::addRoute' => ['Yaf_Router|bool', 'name'=>'string', 'route'=>'Yaf_Route_Interface'], 'Yaf_Route_Regex::assemble' => ['string', 'info'=>'array', 'query='=>'array'], 'Yaf_Route_Regex::getCurrentRoute' => ['string'], 'Yaf_Route_Regex::getRoute' => ['Yaf_Route_Interface', 'name'=>'string'], 'Yaf_Route_Regex::getRoutes' => ['Yaf_Route_Interface[]'], 'Yaf_Route_Regex::route' => ['bool', 'request'=>'Yaf_Request_Abstract'], 'Yaf_Route_Rewrite::__construct' => ['void', 'match'=>'string', 'route'=>'array', 'verify='=>'array'], 'Yaf_Route_Rewrite::addConfig' => ['Yaf_Router|bool', 'config'=>'Yaf_Config_Abstract'], 'Yaf_Route_Rewrite::addRoute' => ['Yaf_Router|bool', 'name'=>'string', 'route'=>'Yaf_Route_Interface'], 'Yaf_Route_Rewrite::assemble' => ['string', 'info'=>'array', 'query='=>'array'], 'Yaf_Route_Rewrite::getCurrentRoute' => ['string'], 'Yaf_Route_Rewrite::getRoute' => ['Yaf_Route_Interface', 'name'=>'string'], 'Yaf_Route_Rewrite::getRoutes' => ['Yaf_Route_Interface[]'], 'Yaf_Route_Rewrite::route' => ['bool', 'request'=>'Yaf_Request_Abstract'], 'Yaf_Route_Simple::__construct' => ['void', 'module_name'=>'string', 'controller_name'=>'string', 'action_name'=>'string'], 'Yaf_Route_Simple::assemble' => ['string', 'info'=>'array', 'query='=>'array'], 'Yaf_Route_Simple::route' => ['bool', 'request'=>'Yaf_Request_Abstract'], 'Yaf_Route_Static::assemble' => ['string', 'info'=>'array', 'query='=>'array'], 'Yaf_Route_Static::match' => ['void', 'uri'=>'string'], 'Yaf_Route_Static::route' => ['bool', 'request'=>'Yaf_Request_Abstract'], 'Yaf_Route_Supervar::__construct' => ['void', 'supervar_name'=>'string'], 'Yaf_Route_Supervar::assemble' => ['string', 'info'=>'array', 'query='=>'array'], 'Yaf_Route_Supervar::route' => ['bool', 'request'=>'Yaf_Request_Abstract'], 'Yaf_Router::__construct' => ['void'], 'Yaf_Router::addConfig' => ['bool', 'config'=>'Yaf_Config_Abstract'], 'Yaf_Router::addRoute' => ['bool', 'name'=>'string', 'route'=>'Yaf_Route_Abstract'], 'Yaf_Router::getCurrentRoute' => ['string'], 'Yaf_Router::getRoute' => ['Yaf_Route_Interface', 'name'=>'string'], 'Yaf_Router::getRoutes' => ['mixed'], 'Yaf_Router::route' => ['bool', 'request'=>'Yaf_Request_Abstract'], 'Yaf_Session::__clone' => ['void'], 'Yaf_Session::__construct' => ['void'], 'Yaf_Session::__get' => ['void', 'name'=>'string'], 'Yaf_Session::__isset' => ['void', 'name'=>'string'], 'Yaf_Session::__set' => ['void', 'name'=>'string', 'value'=>'string'], 'Yaf_Session::__sleep' => ['list<string>'], 'Yaf_Session::__unset' => ['void', 'name'=>'string'], 'Yaf_Session::__wakeup' => ['void'], 'Yaf_Session::count' => ['0|positive-int'], 'Yaf_Session::current' => ['void'], 'Yaf_Session::del' => ['void', 'name'=>'string'], 'Yaf_Session::get' => ['mixed', 'name'=>'string'], 'Yaf_Session::getInstance' => ['void'], 'Yaf_Session::has' => ['void', 'name'=>'string'], 'Yaf_Session::key' => ['void'], 'Yaf_Session::next' => ['void'], 'Yaf_Session::offsetExists' => ['void', 'name'=>'string'], 'Yaf_Session::offsetGet' => ['void', 'name'=>'string'], 'Yaf_Session::offsetSet' => ['void', 'name'=>'string', 'value'=>'string'], 'Yaf_Session::offsetUnset' => ['void', 'name'=>'string'], 'Yaf_Session::rewind' => ['void'], 'Yaf_Session::set' => ['Yaf_Session|bool', 'name'=>'string', 'value'=>'mixed'], 'Yaf_Session::start' => ['void'], 'Yaf_Session::valid' => ['void'], 'Yaf_View_Interface::assign' => ['Yaf_View_Interface|bool', 'name'=>'string', 'value='=>'?mixed'], 'Yaf_View_Interface::display' => ['Yaf_View_Interface|bool', 'tpl'=>'string', 'tpl_vars='=>'?array'], 'Yaf_View_Interface::getScriptPath' => ['string'], 'Yaf_View_Interface::render' => ['string|bool', 'tpl'=>'string', 'tpl_vars='=>'?array'], 'Yaf_View_Interface::setScriptPath' => ['bool', 'template_dir'=>'string'], 'Yaf_View_Simple::__construct' => ['void', 'tempalte_dir'=>'string', 'options='=>'?array'], 'Yaf_View_Simple::__get' => ['mixed', 'name='=>'?string'], 'Yaf_View_Simple::__isset' => ['bool', 'name'=>'string'], 'Yaf_View_Simple::__set' => ['void', 'name'=>'string', 'value'=>'mixed'], 'Yaf_View_Simple::assign' => ['Yaf_View_Simple|false|null', 'name='=>'?mixed', 'default='=>'?mixed'], 'Yaf_View_Simple::assignRef' => ['?Yaf_View_Simple', 'name'=>'string', '&value'=>'mixed'], 'Yaf_View_Simple::clear' => ['?Yaf_View_Simple', 'name='=>'string'], 'Yaf_View_Simple::display' => ['?bool', 'tpl'=>'string', 'tpl_vars='=>'?array'], 'Yaf_View_Simple::eval' => ['string|null|false', 'tpl_str'=>'string', 'vars='=>'?array'], 'Yaf_View_Simple::get' => ['mixed', 'name='=>'?string'], 'Yaf_View_Simple::getScriptPath' => ['?string'], 'Yaf_View_Simple::render' => ['string|null|false', 'tpl'=>'string', 'tpl_vars='=>'?array'], 'Yaf_View_Simple::setScriptPath' => ['Yaf_View_Simple|false|null', 'template_dir'=>'string'], 'yaml_emit' => ['string', 'data'=>'mixed', 'encoding='=>'int', 'linebreak='=>'int'], 'yaml_emit_file' => ['bool', 'filename'=>'string', 'data'=>'mixed', 'encoding='=>'int', 'linebreak='=>'int'], 'yaml_parse' => ['mixed', 'input'=>'string', 'pos='=>'int', '&w_ndocs='=>'int', 'callbacks='=>'array'], 'yaml_parse_file' => ['mixed', 'filename'=>'string', 'pos='=>'int', '&w_ndocs='=>'int', 'callbacks='=>'array'], 'yaml_parse_url' => ['mixed', 'url'=>'string', 'pos='=>'int', '&w_ndocs='=>'int', 'callbacks='=>'array'], 'Yar_Client::__call' => ['void', 'method'=>'string', 'parameters'=>'array'], 'Yar_Client::__construct' => ['void', 'url'=>'string'], 'Yar_Client::setOpt' => ['bool', 'name'=>'int', 'value'=>'mixed'], 'Yar_Client_Exception::getType' => ['void'], 'Yar_Concurrent_Client::call' => ['int', 'uri'=>'string', 'method'=>'string', 'parameters'=>'array', 'callback='=>'callable'], 'Yar_Concurrent_Client::loop' => ['bool', 'callback='=>'callable', 'error_callback='=>'callable'], 'Yar_Concurrent_Client::reset' => ['bool'], 'Yar_Server::__construct' => ['void', 'obj'=>'Object'], 'Yar_Server::handle' => ['bool'], 'Yar_Server_Exception::getType' => ['string'], 'yaz_addinfo' => ['string', 'id'=>'resource'], 'yaz_ccl_conf' => ['void', 'id'=>'resource', 'config'=>'array'], 'yaz_ccl_parse' => ['bool', 'id'=>'resource', 'query'=>'string', '&w_result'=>'array'], 'yaz_close' => ['bool', 'id'=>'resource'], 'yaz_connect' => ['mixed', 'zurl'=>'string', 'options='=>'mixed'], 'yaz_database' => ['bool', 'id'=>'resource', 'databases'=>'string'], 'yaz_element' => ['bool', 'id'=>'resource', 'elementset'=>'string'], 'yaz_errno' => ['int', 'id'=>'resource'], 'yaz_error' => ['string', 'id'=>'resource'], 'yaz_es' => ['void', 'id'=>'resource', 'type'=>'string', 'args'=>'array'], 'yaz_es_result' => ['array', 'id'=>'resource'], 'yaz_get_option' => ['string', 'id'=>'resource', 'name'=>'string'], 'yaz_hits' => ['int', 'id'=>'resource', 'searchresult='=>'array'], 'yaz_itemorder' => ['void', 'id'=>'resource', 'args'=>'array'], 'yaz_present' => ['bool', 'id'=>'resource'], 'yaz_range' => ['void', 'id'=>'resource', 'start'=>'int', 'number'=>'int'], 'yaz_record' => ['string', 'id'=>'resource', 'pos'=>'int', 'type'=>'string'], 'yaz_scan' => ['void', 'id'=>'resource', 'type'=>'string', 'startterm'=>'string', 'flags='=>'array'], 'yaz_scan_result' => ['array', 'id'=>'resource', 'result='=>'array'], 'yaz_schema' => ['void', 'id'=>'resource', 'schema'=>'string'], 'yaz_search' => ['bool', 'id'=>'resource', 'type'=>'string', 'query'=>'string'], 'yaz_set_option' => ['', 'id'=>'', 'name'=>'string', 'value'=>'string', 'options'=>'array'], 'yaz_sort' => ['void', 'id'=>'resource', 'criteria'=>'string'], 'yaz_syntax' => ['void', 'id'=>'resource', 'syntax'=>'string'], 'yaz_wait' => ['mixed', '&rw_options='=>'array'], 'yp_all' => ['void', 'domain'=>'string', 'map'=>'string', 'callback'=>'string'], 'yp_cat' => ['array', 'domain'=>'string', 'map'=>'string'], 'yp_err_string' => ['string', 'errorcode'=>'int'], 'yp_errno' => ['int'], 'yp_first' => ['array', 'domain'=>'string', 'map'=>'string'], 'yp_get_default_domain' => ['string'], 'yp_master' => ['string', 'domain'=>'string', 'map'=>'string'], 'yp_match' => ['string', 'domain'=>'string', 'map'=>'string', 'key'=>'string'], 'yp_next' => ['array', 'domain'=>'string', 'map'=>'string', 'key'=>'string'], 'yp_order' => ['int', 'domain'=>'string', 'map'=>'string'], 'zem_get_extension_info_by_id' => [''], 'zem_get_extension_info_by_name' => [''], 'zem_get_extensions_info' => [''], 'zem_get_license_info' => [''], 'zend_current_obfuscation_level' => ['int'], 'zend_disk_cache_clear' => ['bool', 'namespace='=>'mixed|string'], 'zend_disk_cache_delete' => ['mixed|null', 'key'=>''], 'zend_disk_cache_fetch' => ['mixed|null', 'key'=>''], 'zend_disk_cache_store' => ['bool', 'key'=>'', 'value'=>'', 'ttl='=>'int|mixed'], 'zend_get_id' => ['array', 'all_ids='=>'all_ids|false'], 'zend_is_configuration_changed' => [''], 'zend_loader_current_file' => ['string'], 'zend_loader_enabled' => ['bool'], 'zend_loader_file_encoded' => ['bool'], 'zend_loader_file_licensed' => ['array'], 'zend_loader_install_license' => ['bool', 'license_file'=>'license_file', 'override'=>'override'], 'zend_logo_guid' => ['string'], 'zend_obfuscate_class_name' => ['string', 'class_name'=>'class_name'], 'zend_obfuscate_function_name' => ['string', 'function_name'=>'function_name'], 'zend_optimizer_version' => ['string'], 'zend_runtime_obfuscate' => ['void'], 'zend_send_buffer' => ['null|false', 'buffer'=>'string', 'mime_type='=>'string', 'custom_headers='=>'string'], 'zend_send_file' => ['null|false', 'filename'=>'string', 'mime_type='=>'string', 'custom_headers='=>'string'], 'zend_set_configuration_changed' => [''], 'zend_shm_cache_clear' => ['bool', 'namespace='=>'mixed|string'], 'zend_shm_cache_delete' => ['mixed|null', 'key'=>''], 'zend_shm_cache_fetch' => ['mixed|null', 'key'=>''], 'zend_shm_cache_store' => ['bool', 'key'=>'', 'value'=>'', 'ttl='=>'int|mixed'], 'zend_thread_id' => ['int'], 'zend_version' => ['string'], 'ZendAPI_Job::addJobToQueue' => ['int', 'jobqueue_url'=>'string', 'password'=>'string'], 'ZendAPI_Job::getApplicationID' => [''], 'ZendAPI_Job::getEndTime' => [''], 'ZendAPI_Job::getGlobalVariables' => [''], 'ZendAPI_Job::getHost' => [''], 'ZendAPI_Job::getID' => [''], 'ZendAPI_Job::getInterval' => [''], 'ZendAPI_Job::getJobDependency' => [''], 'ZendAPI_Job::getJobName' => [''], 'ZendAPI_Job::getJobPriority' => [''], 'ZendAPI_Job::getJobStatus' => ['int'], 'ZendAPI_Job::getLastPerformedStatus' => ['int'], 'ZendAPI_Job::getOutput' => ['An'], 'ZendAPI_Job::getPreserved' => [''], 'ZendAPI_Job::getProperties' => ['array'], 'ZendAPI_Job::getScheduledTime' => [''], 'ZendAPI_Job::getScript' => [''], 'ZendAPI_Job::getTimeToNextRepeat' => ['int'], 'ZendAPI_Job::getUserVariables' => [''], 'ZendAPI_Job::setApplicationID' => ['', 'app_id'=>''], 'ZendAPI_Job::setGlobalVariables' => ['', 'vars'=>''], 'ZendAPI_Job::setJobDependency' => ['', 'job_id'=>''], 'ZendAPI_Job::setJobName' => ['', 'name'=>''], 'ZendAPI_Job::setJobPriority' => ['', 'priority'=>'int'], 'ZendAPI_Job::setPreserved' => ['', 'preserved'=>''], 'ZendAPI_Job::setRecurrenceData' => ['', 'interval'=>'', 'end_time='=>'mixed'], 'ZendAPI_Job::setScheduledTime' => ['', 'timestamp'=>''], 'ZendAPI_Job::setScript' => ['', 'script'=>''], 'ZendAPI_Job::setUserVariables' => ['', 'vars'=>''], 'ZendAPI_Job::ZendAPI_Job' => ['Job', 'script'=>'script'], 'ZendAPI_Queue::addJob' => ['int', '&job'=>'Job'], 'ZendAPI_Queue::getAllApplicationIDs' => ['array'], 'ZendAPI_Queue::getAllhosts' => ['array'], 'ZendAPI_Queue::getHistoricJobs' => ['array', 'status'=>'int', 'start_time'=>'', 'end_time'=>'', 'index'=>'int', 'count'=>'int', '&total'=>'int'], 'ZendAPI_Queue::getJob' => ['Job', 'job_id'=>'int'], 'ZendAPI_Queue::getJobsInQueue' => ['array', 'filter_options='=>'array', 'max_jobs='=>'int', 'with_globals_and_output='=>'bool|false'], 'ZendAPI_Queue::getLastError' => ['string'], 'ZendAPI_Queue::getNumOfJobsInQueue' => ['int', 'filter_options='=>'array'], 'ZendAPI_Queue::getStatistics' => ['array'], 'ZendAPI_Queue::isScriptExists' => ['bool', 'path'=>'string'], 'ZendAPI_Queue::isSuspend' => ['bool'], 'ZendAPI_Queue::login' => ['bool', 'password'=>'string', 'application_id='=>'int'], 'ZendAPI_Queue::removeJob' => ['bool', 'job_id'=>'array|int'], 'ZendAPI_Queue::requeueJob' => ['bool', 'job'=>'Job'], 'ZendAPI_Queue::resumeJob' => ['bool', 'job_id'=>'array|int'], 'ZendAPI_Queue::resumeQueue' => ['bool'], 'ZendAPI_Queue::setMaxHistoryTime' => ['bool'], 'ZendAPI_Queue::suspendJob' => ['bool', 'job_id'=>'array|int'], 'ZendAPI_Queue::suspendQueue' => ['bool'], 'ZendAPI_Queue::updateJob' => ['int', '&job'=>'Job'], 'ZendAPI_Queue::zendapi_queue' => ['ZendAPI_Queue', 'queue_url'=>'string'], 'zip_close' => ['void', 'zip'=>'resource'], 'zip_entry_close' => ['bool', 'zip_ent'=>'resource'], 'zip_entry_compressedsize' => ['int|false', 'zip_entry'=>'resource'], 'zip_entry_compressionmethod' => ['string|false', 'zip_entry'=>'resource'], 'zip_entry_filesize' => ['int|false', 'zip_entry'=>'resource'], 'zip_entry_name' => ['string|false', 'zip_entry'=>'resource'], 'zip_entry_open' => ['bool', 'zip_dp'=>'resource', 'zip_entry'=>'resource', 'mode='=>'string'], 'zip_entry_read' => ['string|false', 'zip_entry'=>'resource', 'len='=>'int'], 'zip_open' => ['resource|false|int', 'filename'=>'string'], 'zip_read' => ['resource|false|int', 'zip'=>'resource'], 'ZipArchive::addEmptyDir' => ['bool', 'dirname'=>'string'], 'ZipArchive::addFile' => ['bool', 'filepath'=>'string', 'entryname='=>'string', 'start='=>'int', 'length='=>'int'], 'ZipArchive::addFromString' => ['bool', 'entryname'=>'string', 'content'=>'string'], 'ZipArchive::addGlob' => ['bool', 'pattern'=>'string', 'flags='=>'int', 'options='=>'array'], 'ZipArchive::addPattern' => ['bool', 'pattern'=>'string', 'path='=>'string', 'options='=>'array'], 'ZipArchive::close' => ['bool'], 'ZipArchive::count' => ['0|positive-int'], 'ZipArchive::createEmptyDir' => ['bool', 'dirname'=>'string'], 'ZipArchive::deleteIndex' => ['bool', 'index'=>'int'], 'ZipArchive::deleteName' => ['bool', 'name'=>'string'], 'ZipArchive::extractTo' => ['bool', 'pathto'=>'string', 'files='=>'string[]|string'], 'ZipArchive::getArchiveComment' => ['string', 'flags='=>'int'], 'ZipArchive::getCommentIndex' => ['string', 'index'=>'int', 'flags='=>'int'], 'ZipArchive::getCommentName' => ['string', 'name'=>'string', 'flags='=>'int'], 'ZipArchive::getExternalAttributesIndex' => ['bool', 'index'=>'int', '&w_opsys'=>'int', '&w_attr'=>'int', 'flags='=>'int'], 'ZipArchive::getExternalAttributesName' => ['bool', 'name'=>'string', '&w_opsys'=>'int', '&w_attr'=>'int', 'flags='=>'int'], 'ZipArchive::getFromIndex' => ['string|false', 'index'=>'int', 'len='=>'int', 'flags='=>'int'], 'ZipArchive::getFromName' => ['string|false', 'entryname'=>'string', 'len='=>'int', 'flags='=>'int'], 'ZipArchive::getNameIndex' => ['string|false', 'index'=>'int', 'flags='=>'int'], 'ZipArchive::getStatusString' => ['string'], 'ZipArchive::getStream' => ['resource|false', 'entryname'=>'string'], 'ZipArchive::locateName' => ['int|false', 'filename'=>'string', 'flags='=>'int'], 'ZipArchive::open' => ['ZipArchive::ER_*|true', 'source'=>'string', 'flags='=>'int'], 'ZipArchive::renameIndex' => ['bool', 'index'=>'int', 'new_name'=>'string'], 'ZipArchive::renameName' => ['bool', 'name'=>'string', 'new_name'=>'string'], 'ZipArchive::setArchiveComment' => ['bool', 'comment'=>'string'], 'ZipArchive::setCommentIndex' => ['bool', 'index'=>'int', 'comment'=>'string'], 'ZipArchive::setCommentName' => ['bool', 'name'=>'string', 'comment'=>'string'], 'ZipArchive::setCompressionIndex' => ['bool', 'index'=>'int', 'comp_method'=>'int', 'comp_flags='=>'int'], 'ZipArchive::setCompressionName' => ['bool', 'name'=>'string', 'comp_method'=>'int', 'comp_flags='=>'int'], 'ZipArchive::setEncryptionIndex' => ['bool', 'index'=>'int', 'method'=>'string', 'password='=>'string'], 'ZipArchive::setEncryptionName' => ['bool', 'name'=>'string', 'method'=>'int', 'password='=>'string'], 'ZipArchive::setExternalAttributesIndex' => ['bool', 'index'=>'int', 'opsys'=>'int', 'attr'=>'int', 'flags='=>'int'], 'ZipArchive::setExternalAttributesName' => ['bool', 'name'=>'string', 'opsys'=>'int', 'attr'=>'int', 'flags='=>'int'], 'ZipArchive::setPassword' => ['bool', 'password'=>'string'], 'ZipArchive::statIndex' => ['array|false', 'index'=>'int', 'flags='=>'int'], 'ZipArchive::statName' => ['array|false', 'filename'=>'string', 'flags='=>'int'], 'ZipArchive::unchangeAll' => ['bool'], 'ZipArchive::unchangeArchive' => ['bool'], 'ZipArchive::unchangeIndex' => ['bool', 'index'=>'int'], 'ZipArchive::unchangeName' => ['bool', 'name'=>'string'], 'zlib_decode' => ['string|false', 'data'=>'string', 'max_decoded_len='=>'int'], 'zlib_encode' => ['string|false', 'data'=>'string', 'encoding'=>'int', 'level='=>'string|int'], 'zlib_get_coding_type' => ['string|false'], 'ZMQ::__construct' => ['void'], 'ZMQContext::__construct' => ['void', 'io_threads='=>'int', 'is_persistent='=>'bool'], 'ZMQContext::getOpt' => ['mixed', 'key'=>'string'], 'ZMQContext::getSocket' => ['ZMQSocket', 'type'=>'int', 'persistent_id='=>'string', 'on_new_socket='=>'callable'], 'ZMQContext::isPersistent' => ['bool'], 'ZMQContext::setOpt' => ['ZMQContext', 'key'=>'int', 'value'=>'mixed'], 'ZMQDevice::__construct' => ['void', 'frontend'=>'ZMQSocket', 'backend'=>'ZMQSocket', 'listener='=>'ZMQSocket'], 'ZMQDevice::getIdleTimeout' => ['ZMQDevice'], 'ZMQDevice::getTimerTimeout' => ['ZMQDevice'], 'ZMQDevice::run' => ['void'], 'ZMQDevice::setIdleCallback' => ['ZMQDevice', 'cb_func'=>'callable', 'timeout'=>'int', 'user_data='=>'mixed'], 'ZMQDevice::setIdleTimeout' => ['ZMQDevice', 'timeout'=>'int'], 'ZMQDevice::setTimerCallback' => ['ZMQDevice', 'cb_func'=>'callable', 'timeout'=>'int', 'user_data='=>'mixed'], 'ZMQDevice::setTimerTimeout' => ['ZMQDevice', 'timeout'=>'int'], 'ZMQPoll::add' => ['string', 'entry'=>'mixed', 'type'=>'int'], 'ZMQPoll::clear' => ['ZMQPoll'], 'ZMQPoll::count' => ['0|positive-int'], 'ZMQPoll::getLastErrors' => ['array'], 'ZMQPoll::poll' => ['int', '&w_readable'=>'array', '&w_writable'=>'array', 'timeout='=>'int'], 'ZMQPoll::remove' => ['bool', 'item'=>'mixed'], 'ZMQSocket::__construct' => ['void', 'context'=>'ZMQContext', 'type'=>'int', 'persistent_id='=>'string', 'on_new_socket='=>'callable'], 'ZMQSocket::bind' => ['ZMQSocket', 'dsn'=>'string', 'force='=>'bool'], 'ZMQSocket::connect' => ['ZMQSocket', 'dsn'=>'string', 'force='=>'bool'], 'ZMQSocket::disconnect' => ['ZMQSocket', 'dsn'=>'string'], 'ZMQSocket::getEndpoints' => ['array'], 'ZMQSocket::getPersistentId' => ['string'], 'ZMQSocket::getSocketType' => ['int'], 'ZMQSocket::getSockOpt' => ['mixed', 'key'=>'string'], 'ZMQSocket::isPersistent' => ['bool'], 'ZMQSocket::recv' => ['string', 'mode='=>'int'], 'ZMQSocket::recvMulti' => ['string[]', 'mode='=>'int'], 'ZMQSocket::send' => ['ZMQSocket', 'message'=>'array', 'mode='=>'int'], 'ZMQSocket::send\'1' => ['ZMQSocket', 'message'=>'string', 'mode='=>'int'], 'ZMQSocket::sendmulti' => ['ZMQSocket', 'message'=>'array', 'mode='=>'int'], 'ZMQSocket::setSockOpt' => ['ZMQSocket', 'key'=>'int', 'value'=>'mixed'], 'ZMQSocket::unbind' => ['ZMQSocket', 'dsn'=>'string'], 'Zookeeper::addAuth' => ['bool', 'scheme'=>'string', 'cert'=>'string', 'completion_cb='=>'callable'], 'Zookeeper::connect' => ['void', 'host'=>'string', 'watcher_cb='=>'callable', 'recv_timeout='=>'int'], 'Zookeeper::create' => ['string', 'path'=>'string', 'value'=>'string', 'acls'=>'array', 'flags='=>'int'], 'Zookeeper::delete' => ['bool', 'path'=>'string', 'version='=>'int'], 'Zookeeper::exists' => ['bool', 'path'=>'string', 'watcher_cb='=>'callable'], 'Zookeeper::get' => ['string', 'path'=>'string', 'watcher_cb='=>'callable', 'stat='=>'array', 'max_size='=>'int'], 'Zookeeper::getAcl' => ['array', 'path'=>'string'], 'Zookeeper::getChildren' => ['array', 'path'=>'string', 'watcher_cb='=>'callable'], 'Zookeeper::getClientId' => ['int'], 'Zookeeper::getRecvTimeout' => ['int'], 'Zookeeper::getState' => ['int'], 'Zookeeper::isRecoverable' => ['bool'], 'Zookeeper::set' => ['bool', 'path'=>'string', 'value'=>'string', 'version='=>'int', 'stat='=>'array'], 'Zookeeper::setAcl' => ['bool', 'path'=>'string', 'version'=>'int', 'acl'=>'array'], 'Zookeeper::setDebugLevel' => ['bool', 'logLevel'=>'int'], 'Zookeeper::setDeterministicConnOrder' => ['bool', 'yesOrNo'=>'bool'], 'Zookeeper::setLogStream' => ['bool', 'stream'=>'resource'], 'Zookeeper::setWatcher' => ['bool', 'watcher_cb'=>'callable'], 'zookeeper_dispatch' => ['void'], ]; <?php namespace _PHPStan_7d8742a37; // phpcs:ignoreFile return ['new' => ['bcadd' => ['numeric-string', 'left_operand' => 'numeric-string', 'right_operand' => 'numeric-string', 'scale=' => 'int'], 'bccomp' => ['int', 'left_operand' => 'numeric-string', 'right_operand' => 'numeric-string', 'scale=' => 'int'], 'bcdiv' => ['numeric-string|null', 'left_operand' => 'numeric-string', 'right_operand' => 'numeric-string', 'scale=' => 'int'], 'bcmod' => ['numeric-string|null', 'left_operand' => 'string', 'right_operand' => 'numeric-string', 'scale=' => 'int'], 'bcmul' => ['numeric-string', 'left_operand' => 'numeric-string', 'right_operand' => 'numeric-string', 'scale=' => 'int'], 'bcpow' => ['numeric-string', 'base' => 'numeric-string', 'exponent' => 'numeric-string', 'scale=' => 'int'], 'bcpowmod' => ['numeric-string|null', 'base' => 'numeric-string', 'exponent' => 'numeric-string', 'modulus' => 'string', 'scale=' => 'int'], 'bcsqrt' => ['numeric-string', 'operand' => 'numeric-string', 'scale=' => 'int'], 'bcsub' => ['numeric-string', 'left_operand' => 'numeric-string', 'right_operand' => 'numeric-string', 'scale=' => 'int'], 'Closure::bind' => ['Closure', 'old' => 'Closure', 'to' => '?object', 'scope=' => 'object|class-string|\'static\'|null'], 'Closure::bindTo' => ['Closure', 'new' => '?object', 'newscope=' => 'object|class-string|\'static\'|null'], 'error_log' => ['bool', 'message' => 'string', 'message_type=' => '0|1|2|3|4', 'destination=' => 'string', 'extra_headers=' => 'string'], 'SplFileObject::flock' => ['bool', 'operation' => 'int-mask<LOCK_SH, LOCK_EX, LOCK_UN, LOCK_NB>', '&w_wouldblock=' => '0|1'], 'Imagick::adaptiveBlurImage' => ['bool', 'radius' => 'float', 'sigma' => 'float', 'channel=' => 'Imagick::CHANNEL_*'], 'Imagick::adaptiveSharpenImage' => ['bool', 'radius' => 'float', 'sigma' => 'float', 'channel=' => 'Imagick::CHANNEL_*'], 'Imagick::addNoiseImage' => ['bool', 'noise_type' => 'Imagick::NOISE_*', 'channel=' => 'Imagick::CHANNEL_*'], 'Imagick::autoGammaImage' => ['bool', 'channel=' => 'Imagick::CHANNEL_*'], 'Imagick::autoLevelImage' => ['bool', 'channel=' => 'Imagick::CHANNEL_*'], 'Imagick::blurImage' => ['bool', 'radius' => 'float', 'sigma' => 'float', 'channel=' => 'Imagick::CHANNEL_*'], 'Imagick::brightnessContrastImage' => ['bool', 'brightness' => 'float', 'contrast' => 'float', 'channel=' => 'Imagick::CHANNEL_*'], 'Imagick::clampImage' => ['bool', 'channel=' => 'Imagick::CHANNEL_*'], 'Imagick::combineImages' => ['Imagick', 'channeltype' => 'Imagick::CHANNEL_*'], 'Imagick::compareImageChannels' => ['array{Imagick,float}', 'image' => 'imagick', 'channeltype' => 'Imagick::CHANNEL_*', 'metrictype' => 'Imagick::METRIC_*'], 'Imagick::compareImageLayers' => ['Imagick', 'method' => 'Imagick::LAYERMETHOD_*'], 'Imagick::compareImages' => ['array{Imagick,float}', 'compare' => 'imagick', 'metric' => 'Imagick::METRIC_*'], 'Imagick::compositeImage' => ['bool', 'composite_object' => 'imagick', 'composite' => 'Imagick::COMPOSITE_*', 'x' => 'int', 'y' => 'int', 'channel=' => 'Imagick::CHANNEL_*'], 'Imagick::contrastStretchImage' => ['bool', 'black_point' => 'float', 'white_point' => 'float', 'channel=' => 'Imagick::CHANNEL_*'], 'Imagick::convolveImage' => ['bool', 'kernel' => 'array', 'channel=' => 'Imagick::CHANNEL_*'], 'Imagick::distortImage' => ['bool', 'method' => 'Imagick::DISTORTION_*', 'arguments' => 'array', 'bestfit' => 'bool'], 'Imagick::evaluateImage' => ['bool', 'op' => 'Imagick::EVALUATE_*', 'constant' => 'float', 'channel=' => 'Imagick::CHANNEL_*'], 'Imagick::exportImagePixels' => ['list<int>', 'x' => 'int', 'y' => 'int', 'width' => 'int', 'height' => 'int', 'map' => 'string', 'storage' => 'Imagick::PIXEL_*'], 'Imagick::floodFillPaintImage' => ['bool', 'fill' => 'mixed', 'fuzz' => 'float', 'target' => 'mixed', 'x' => 'int', 'y' => 'int', 'invert' => 'bool', 'channel=' => 'Imagick::CHANNEL_*'], 'Imagick::functionImage' => ['bool', 'function' => 'Imagick::FUNCTION_*', 'arguments' => 'array', 'channel=' => 'Imagick::CHANNEL_*'], 'Imagick::fxImage' => ['Imagick', 'expression' => 'string', 'channel=' => 'Imagick::CHANNEL_*'], 'Imagick::gammaImage' => ['bool', 'gamma' => 'float', 'channel=' => 'Imagick::CHANNEL_*'], 'Imagick::gaussianBlurImage' => ['bool', 'radius' => 'float', 'sigma' => 'float', 'channel=' => 'Imagick::CHANNEL_*'], 'Imagick::getImageChannelDepth' => ['int', 'channel' => 'Imagick::CHANNEL_*'], 'Imagick::getImageChannelDistortion' => ['float', 'reference' => 'imagick', 'channel' => 'Imagick::CHANNEL_*', 'metric' => 'Imagick::METRIC_*'], 'Imagick::getImageChannelDistortions' => ['float', 'reference' => 'imagick', 'metric' => 'Imagick::METRIC_*', 'channel=' => 'Imagick::CHANNEL_*'], 'Imagick::getImageChannelExtrema' => ['array{minima:0|positive-int,maxima:0|positive-int}', 'channel' => 'Imagick::CHANNEL_*'], 'Imagick::getImageChannelKurtosis' => ['array{kurtosis:float,skewness:float}', 'channel=' => 'Imagick::CHANNEL_*'], 'Imagick::getImageChannelMean' => ['array{mean:float,standardDeviation:float}', 'channel' => 'Imagick::CHANNEL_*'], 'Imagick::getImageChannelRange' => ['array{minima:float,maxima:float}', 'channel' => 'Imagick::CHANNEL_*'], 'Imagick::getImageDistortion' => ['float', 'reference' => 'magickwand', 'metric' => 'Imagick::METRIC_*'], 'Imagick::getResource' => ['int', 'type' => 'Imagick::RESOURCETYPE_*'], 'Imagick::getResourceLimit' => ['int', 'type' => 'Imagick::RESOURCETYPE_*'], 'Imagick::importImagePixels' => ['bool', 'x' => 'int', 'y' => 'int', 'width' => 'int', 'height' => 'int', 'map' => 'string', 'storage' => 'Imagick::PIXEL_*', 'pixels' => 'array'], 'Imagick::levelImage' => ['bool', 'blackpoint' => 'float', 'gamma' => 'float', 'whitepoint' => 'float', 'channel=' => 'Imagick::CHANNEL_*'], 'Imagick::mergeImageLayers' => ['Imagick', 'layer_method' => 'Imagick::LAYERMETHOD_*'], 'Imagick::montageImage' => ['Imagick', 'draw' => 'imagickdraw', 'tile_geometry' => 'string', 'thumbnail_geometry' => 'string', 'mode' => 'Imagick::MONTAGEMODE_*', 'frame' => 'string'], 'Imagick::morphology' => ['bool', 'morphologyMethod' => 'Imagick::MORPHOLOGY_*', 'iterations' => 'int', 'ImagickKernel' => 'ImagickKernel', 'channel=' => 'Imagick::CHANNEL_*'], 'Imagick::motionBlurImage' => ['bool', 'radius' => 'float', 'sigma' => 'float', 'angle' => 'float', 'channel=' => 'Imagick::CHANNEL_*'], 'Imagick::negateImage' => ['bool', 'gray' => 'bool', 'channel=' => 'Imagick::CHANNEL_*'], 'Imagick::normalizeImage' => ['bool', 'channel=' => 'Imagick::CHANNEL_*'], 'Imagick::opaquePaintImage' => ['bool', 'target' => 'mixed', 'fill' => 'mixed', 'fuzz' => 'float', 'invert' => 'bool', 'channel=' => 'Imagick::CHANNEL_*'], 'Imagick::orderedPosterizeImage' => ['bool', 'threshold_map' => 'string', 'channel=' => 'Imagick::CHANNEL_*'], 'Imagick::paintFloodfillImage' => ['bool', 'fill' => 'mixed', 'fuzz' => 'float', 'bordercolor' => 'mixed', 'x' => 'int', 'y' => 'int', 'channel=' => 'Imagick::CHANNEL_*'], 'Imagick::paintOpaqueImage' => ['bool', 'target' => 'mixed', 'fill' => 'mixed', 'fuzz' => 'float', 'channel=' => 'Imagick::CHANNEL_*'], 'Imagick::radialBlurImage' => ['bool', 'angle' => 'float', 'channel=' => 'Imagick::CHANNEL_*'], 'Imagick::randomThresholdImage' => ['bool', 'low' => 'float', 'high' => 'float', 'channel=' => 'Imagick::CHANNEL_*'], 'Imagick::remapImage' => ['bool', 'replacement' => 'imagick', 'dither' => 'Imagick::DITHERMETHOD_*'], 'Imagick::rotationalBlurImage' => ['bool', 'float' => 'string', 'channel=' => 'Imagick::CHANNEL_*'], 'Imagick::segmentImage' => ['bool', 'colorspace' => 'Imagick::COLORSPACE_*', 'cluster_threshold' => 'float', 'smooth_threshold' => 'float', 'verbose=' => 'bool'], 'Imagick::selectiveBlurImage' => ['bool', 'radius' => 'float', 'sigma' => 'float', 'threshold' => 'float', 'channel=' => 'Imagick::CHANNEL_*'], 'Imagick::separateImageChannel' => ['bool', 'channel' => 'Imagick::CHANNEL_*'], 'Imagick::setColorspace' => ['bool', 'colorspace' => 'Imagick::COLORSPACE_*'], 'Imagick::setCompression' => ['bool', 'compression' => 'Imagick::COMPRESSION_*'], 'Imagick::setGravity' => ['bool', 'gravity' => 'Imagick::GRAVITY_*'], 'Imagick::setImageAlphaChannel' => ['bool', 'mode' => 'Imagick::ALPHACHANNEL_*'], 'Imagick::setImageChannelDepth' => ['bool', 'channel' => 'Imagick::CHANNEL_*', 'depth' => 'int'], 'Imagick::setImageChannelMask' => ['', 'channel' => 'Imagick::CHANNEL_*'], 'Imagick::setImageClipMask' => ['bool', 'clip_mask' => 'imagick'], 'Imagick::setImageColormapColor' => ['bool', 'index' => 'int', 'color' => 'imagickpixel'], 'Imagick::setImageColorspace' => ['bool', 'colorspace' => 'Imagick::COLORSPACE_*'], 'Imagick::setImageCompose' => ['bool', 'compose' => 'Imagick::COMPOSITE_*'], 'Imagick::setImageCompression' => ['bool', 'compression' => 'Imagick::COMPRESSION_*'], 'Imagick::setImageDispose' => ['bool', 'dispose' => 'Imagick::DISPOSE_*'], 'Imagick::setImageGravity' => ['bool', 'gravity' => 'Imagick::GRAVITY_*'], 'Imagick::setImageInterlaceScheme' => ['bool', 'interlace_scheme' => 'Imagick::INTERLACE_*'], 'Imagick::setImageInterpolateMethod' => ['bool', 'method' => 'Imagick::INTERPOLATE_*'], 'Imagick::setImageOrientation' => ['bool', 'orientation' => 'Imagick::ORIENTATION_*'], 'Imagick::setImageRenderingIntent' => ['bool', 'rendering_intent' => 'Imagick::RENDERINGINTENT_*'], 'Imagick::setImageType' => ['bool', 'image_type' => 'Imagick::IMGTYPE_*'], 'Imagick::setType' => ['bool', 'image_type' => 'Imagick::IMGTYPE_*'], 'Imagick::sharpenImage' => ['bool', 'radius' => 'float', 'sigma' => 'float', 'channel=' => 'Imagick::CHANNEL_*'], 'Imagick::sigmoidalContrastImage' => ['bool', 'sharpen' => 'bool', 'alpha' => 'float', 'beta' => 'float', 'channel=' => 'Imagick::CHANNEL_*'], 'Imagick::similarityImage' => ['Imagick', 'imagick' => 'Imagick', '&bestMatch' => 'array', '&similarity' => 'float', 'similarity_threshold' => 'float', 'metric' => 'Imagick::METRIC_*'], 'Imagick::sparseColorImage' => ['bool', 'sparse_method' => 'Imagick::SPARSECOLORMETHOD_*', 'arguments' => 'array', 'channel=' => 'Imagick::CHANNEL_*'], 'Imagick::statisticImage' => ['bool', 'type' => 'Imagick::STATISTIC_*', 'width' => 'int', 'height' => 'int', 'channel=' => 'Imagick::CHANNEL_*'], 'Imagick::thresholdImage' => ['bool', 'threshold' => 'float', 'channel=' => 'Imagick::CHANNEL_*'], 'Imagick::transformImageColorspace' => ['bool', 'colorspace' => 'Imagick::COLORSPACE_*'], 'Imagick::unsharpMaskImage' => ['bool', 'radius' => 'float', 'sigma' => 'float', 'amount' => 'float', 'threshold' => 'float', 'channel=' => 'Imagick::CHANNEL_*'], 'ImagickDraw::color' => ['bool', 'x' => 'float', 'y' => 'float', 'paintmethod' => 'Imagick::PAINT_*'], 'ImagickDraw::composite' => ['bool', 'compose' => 'Imagick::COMPOSITE_*', 'x' => 'float', 'y' => 'float', 'width' => 'float', 'height' => 'float', 'compositewand' => 'imagick'], 'ImagickDraw::getFillRule' => ['Imagick::FILLRULE_*'], 'ImagickDraw::getFontStretch' => ['Imagick::STRETCH_*'], 'ImagickDraw::getFontStyle' => ['Imagick::STYLE_*'], 'ImagickDraw::getGravity' => ['Imagick::GRAVITY_*'], 'ImagickDraw::getStrokeLineCap' => ['Imagick::LINECAP_*'], 'ImagickDraw::getStrokeLineJoin' => ['Imagick::LINEJOIN_*'], 'ImagickDraw::getTextAlignment' => ['Imagick::ALIGN_*'], 'ImagickDraw::getTextDecoration' => ['Imagick::DECORATION_*'], 'ImagickDraw::matte' => ['bool', 'x' => 'float', 'y' => 'float', 'paintmethod' => 'Imagick::PAINT_*'], 'ImagickDraw::setClipRule' => ['bool', 'fill_rule' => 'Imagick::FILLRULE_*'], 'ImagickDraw::setFillRule' => ['bool', 'fill_rule' => 'Imagick::FILLRULE_*'], 'ImagickDraw::setFontStretch' => ['bool', 'fontstretch' => 'Imagick::STRETCH_*'], 'ImagickDraw::setFontStyle' => ['bool', 'style' => 'Imagick::STYLE_*'], 'ImagickDraw::setGravity' => ['bool', 'gravity' => 'Imagick::GRAVITY_*'], 'ImagickDraw::setStrokeLineCap' => ['bool', 'linecap' => 'Imagick::LINECAP_*'], 'ImagickDraw::setStrokeLineJoin' => ['bool', 'linejoin' => 'Imagick::LINEJOIN_*'], 'ImagickDraw::setTextAlignment' => ['bool', 'alignment' => 'Imagick::ALIGN_*'], 'ImagickDraw::setTextAntialias' => ['bool', 'antialias' => 'bool'], 'ImagickDraw::setTextDecoration' => ['bool', 'decoration' => 'Imagick::DECORATION_*'], 'ImagickKernel::fromBuiltin' => ['ImagickKernel', 'kernelType' => 'Imagick::KERNEL_*', 'kernelString' => 'string'], 'ImagickKernel::scale' => ['void', 'scale' => 'float', 'normalizeFlag' => 'Imagick::NORMALIZE_KERNEL_*'], 'imagecolorallocate' => ['int<0, max>|false', 'im' => 'resource', 'red' => 'int<0, 255>', 'green' => 'int<0, 255>', 'blue' => 'int<0, 255>'], 'imagecolorallocatealpha' => ['int<0, max>|false', 'im' => 'resource', 'red' => 'int<0, 255>', 'green' => 'int<0, 255>', 'blue' => 'int<0, 255>', 'alpha' => 'int<0, 127>'], 'imagecolorclosest' => ['int<0, max>', 'im' => 'resource', 'red' => 'int<0, 255>', 'green' => 'int<0, 255>', 'blue' => 'int<0, 255>'], 'imagecolorclosestalpha' => ['int<0, max>', 'im' => 'resource', 'red' => 'int<0, 255>', 'green' => 'int<0, 255>', 'blue' => 'int<0, 255>', 'alpha' => 'int<0, 127>'], 'imagecolorclosesthwb' => ['int<0, max>', 'im' => 'resource', 'red' => 'int<0, 255>', 'green' => 'int<0, 255>', 'blue' => 'int<0, 255>'], 'imagecolorexact' => ['int<0, max>|false', 'im' => 'resource', 'red' => 'int<0, 255>', 'green' => 'int<0, 255>', 'blue' => 'int<0, 255>'], 'imagecolorexactalpha' => ['int<0, max>|false', 'im' => 'resource', 'red' => 'int<0, 255>', 'green' => 'int<0, 255>', 'blue' => 'int<0, 255>', 'alpha' => 'int<0, 127>'], 'imagecolorresolve' => ['int<0, max>', 'im' => 'resource', 'red' => 'int<0, 255>', 'green' => 'int<0, 255>', 'blue' => 'int<0, 255>'], 'imagecolorresolvealpha' => ['int<0, max>', 'im' => 'resource', 'red' => 'int<0, 255>', 'green' => 'int<0, 255>', 'blue' => 'int<0, 255>', 'alpha' => 'int<0, 127>'], 'imagecolorset' => ['void', 'im' => 'resource', 'col' => 'int', 'red' => 'int<0, 255>', 'green' => 'int<0, 255>', 'blue' => 'int<0, 255>', 'alpha=' => 'int<0, 127>'], 'imagecreate' => ['__benevolent<resource|false>', 'x_size' => 'int<1, max>', 'y_size' => 'int<1, max>'], 'imagecreatetruecolor' => ['__benevolent<resource|false>', 'x_size' => 'int<1, max>', 'y_size' => 'int<1, max>'], 'max' => ['', '...arg1' => 'non-empty-array'], 'mb_detect_order' => ['bool|list<non-falsy-string>', 'encoding_list=' => 'non-empty-list<non-falsy-string>|non-falsy-string'], 'min' => ['', '...arg1' => 'non-empty-array'], 'file' => ['list<string>|false', 'filename' => 'string', 'flags=' => 'int-mask<FILE_USE_INCLUDE_PATH|FILE_IGNORE_NEW_LINES|FILE_SKIP_EMPTY_LINES|FILE_NO_DEFAULT_CONTEXT>', 'context=' => 'resource'], 'flock' => ['bool', 'fp' => 'resource', 'operation' => 'int-mask<LOCK_SH, LOCK_EX, LOCK_UN, LOCK_NB>', '&w_wouldblock=' => '0|1'], 'ftp_append' => ['bool', 'ftp' => 'resource', 'remote_file' => 'string', 'local_file' => 'string', 'mode=' => 'FTP_ASCII|FTP_BINARY'], 'ftp_fget' => ['bool', 'stream' => 'resource', 'fp' => 'resource', 'remote_file' => 'string', 'mode=' => 'FTP_ASCII|FTP_BINARY', 'resumepos=' => 'int'], 'ftp_fput' => ['bool', 'stream' => 'resource', 'remote_file' => 'string', 'fp' => 'resource', 'mode=' => 'FTP_ASCII|FTP_BINARY', 'startpos=' => 'int'], 'ftp_get' => ['bool', 'stream' => 'resource', 'local_file' => 'string', 'remote_file' => 'string', 'mode=' => 'FTP_ASCII|FTP_BINARY', 'resume_pos=' => 'int'], 'ftp_nb_fget' => ['int', 'stream' => 'resource', 'fp' => 'resource', 'remote_file' => 'string', 'mode=' => 'FTP_ASCII|FTP_BINARY', 'resumepos=' => 'int'], 'ftp_nb_fput' => ['int', 'stream' => 'resource', 'remote_file' => 'string', 'fp' => 'resource', 'mode=' => 'FTP_ASCII|FTP_BINARY', 'startpos=' => 'int'], 'ftp_nb_get' => ['int|false', 'stream' => 'resource', 'local_file' => 'string', 'remote_file' => 'string', 'mode=' => 'FTP_ASCII|FTP_BINARY', 'resume_pos=' => 'int'], 'ftp_nb_put' => ['int|false', 'stream' => 'resource', 'remote_file' => 'string', 'local_file' => 'string', 'mode=' => 'FTP_ASCII|FTP_BINARY', 'startpos=' => 'int'], 'ftp_put' => ['bool', 'stream' => 'resource', 'remote_file' => 'string', 'local_file' => 'string', 'mode=' => 'FTP_ASCII|FTP_BINARY', 'startpos=' => 'int'], 'scandir' => ['list<string>|false', 'dir' => 'string', 'sorting_order=' => 'SCANDIR_SORT_ASCENDING|SCANDIR_SORT_DESCENDING| SCANDIR_SORT_NONE', 'context=' => 'resource'], 'stream_socket_client' => ['resource|false', 'remoteaddress' => 'string', '&w_errcode=' => 'int', '&w_errstring=' => 'string', 'timeout=' => 'float', 'flags=' => 'int-mask<STREAM_CLIENT_CONNECT|STREAM_CLIENT_ASYNC_CONNECT|STREAM_CLIENT_PERSISTENT>', 'context=' => 'resource'], 'stream_socket_enable_crypto' => ['0|bool', 'stream' => 'resource', 'enable' => 'bool', 'crypto_method=' => 'STREAM_CRYPTO_METHOD_SSLv2_CLIENT|STREAM_CRYPTO_METHOD_SSLv3_CLIENT|STREAM_CRYPTO_METHOD_SSLv23_CLIENT|STREAM_CRYPTO_METHOD_ANY_CLIENT|STREAM_CRYPTO_METHOD_TLS_CLIENT|STREAM_CRYPTO_METHOD_TLSv1_0_CLIENT|STREAM_CRYPTO_METHOD_TLSv1_1_CLIENT|STREAM_CRYPTO_METHOD_TLSv1_2_CLIENT|STREAM_CRYPTO_METHOD_TLSv1_3_CLIENT|STREAM_CRYPTO_METHOD_SSLv2_SERVER|STREAM_CRYPTO_METHOD_SSLv3_SERVER|STREAM_CRYPTO_METHOD_SSLv23_SERVER|STREAM_CRYPTO_METHOD_ANY_SERVER|STREAM_CRYPTO_METHOD_TLS_SERVER|STREAM_CRYPTO_METHOD_TLSv1_0_SERVER|STREAM_CRYPTO_METHOD_TLSv1_1_SERVER|STREAM_CRYPTO_METHOD_TLSv1_2_SERVER|STREAM_CRYPTO_METHOD_TLSv1_3_SERVER', 'session_stream=' => 'resource'], 'extract' => ['0|positive-int', 'array' => 'array', 'flags=' => 'EXTR_OVERWRITE|EXTR_SKIP|EXTR_PREFIX_SAME|EXTR_PREFIX_ALL|EXTR_PREFIX_INVALID|EXTR_IF_EXISTS|EXTR_PREFIX_IF_EXISTS|EXTR_REFS', 'prefix=' => 'string|null'], 'RecursiveIteratorIterator::__construct' => ['void', 'iterator' => 'RecursiveIterator|IteratorAggregate', 'mode=' => 'RecursiveIteratorIterator::LEAVES_ONLY|RecursiveIteratorIterator::SELF_FIRST|RecursiveIteratorIterator::CHILD_FIRST', 'flags=' => '0|RecursiveIteratorIterator::CATCH_GET_CHILD'], 'Locale::composeLocale' => ['string|false', 'subtags' => 'array{language:string, script?:string, region?:string, variant?:array<array-key,string>, private?:array<array-key,string>, extlang?:array<array-key,string>, variant0?:string, variant1?:string, variant2?:string, variant3?:string, variant4?:string, variant5?:string, variant6?:string, variant7?:string, variant8?:string, variant9?:string, variant10?:string, variant11?:string, variant12?:string, variant13?:string, variant14?:string, private0?:string, private1?:string, private2?:string, private3?:string, private4?:string, private5?:string, private6?:string, private7?:string, private8?:string, private9?:string, private10?:string, private11?:string, private12?:string, private13?:string, private14?:string, extlang0?:string, extlang1?:string, extlang2?:string}'], 'locale_compose' => ['string|false', 'subtags' => 'array{language:string, script?:string, region?:string, variant?:array<array-key,string>, private?:array<array-key,string>, extlang?:array<array-key,string>, variant0?:string, variant1?:string, variant2?:string, variant3?:string, variant4?:string, variant5?:string, variant6?:string, variant7?:string, variant8?:string, variant9?:string, variant10?:string, variant11?:string, variant12?:string, variant13?:string, variant14?:string, private0?:string, private1?:string, private2?:string, private3?:string, private4?:string, private5?:string, private6?:string, private7?:string, private8?:string, private9?:string, private10?:string, private11?:string, private12?:string, private13?:string, private14?:string, extlang0?:string, extlang1?:string, extlang2?:string}'], 'count' => ['0|positive-int', 'var' => 'Countable|array', 'mode=' => '0|1']], 'old' => []]; <?php namespace _PHPStan_7d8742a37; // phpcs:ignoreFile /** * Copied over from https://github.com/phan/phan/blob/8866d6b98be94b37996390da226e8c4befea29aa/src/Phan/Language/Internal/FunctionSignatureMap_php80_delta.php * Copyright (c) 2015 Rasmus Lerdorf * Copyright (c) 2015 Andrew Morrison */ /** * This contains the information needed to convert the function signatures for php 8.0 to php 7.4 (and vice versa) * * This has two sections. * The 'new' section contains function/method names from FunctionSignatureMap (And alternates, if applicable) that do not exist in php7.4 or have different signatures in php 8.0. * If they were just updated, the function/method will be present in the 'added' signatures. * The 'old' signatures contains the signatures that are different in php 7.4. * Functions are expected to be removed only in major releases of php. * * @see FunctionSignatureMap.php * * @phan-file-suppress PhanPluginMixedKeyNoKey (read by Phan when analyzing this file) */ return ['new' => ['mysqli_fetch_field' => ['(stdClass&object{name: string, orgname: string, table: string, orgtable: string, def: string, db: string, catalog: "def", max_length: 0, length: int, charsetnr: string, flags: int, type: int, decimals: int})|false', 'result' => 'mysqli_result'], 'mysqli_fetch_field_direct' => ['(stdClass&object{name: string, orgname: string, table: string, orgtable: string, def: string, db: string, catalog: "def", max_length: 0, length: int, charsetnr: string, flags: int, type: int, decimals: int})|false', 'result' => 'mysqli_result', 'fieldnr' => 'int'], 'mysqli_fetch_fields' => ['list<stdClass&object{name: string, orgname: string, table: string, orgtable: string, def: string, db: string, catalog: "def", max_length: 0, length: int, charsetnr: string, flags: int, type: int, decimals: int}>', 'result' => 'mysqli_result'], 'mysqli_result::fetch_field' => ['(stdClass&object{name: string, orgname: string, table: string, orgtable: string, def: string, db: string, catalog: "def", max_length: 0, length: int, charsetnr: string, flags: int, type: int, decimals: int})|false'], 'mysqli_result::fetch_field_direct' => ['(stdClass&object{name: string, orgname: string, table: string, orgtable: string, def: string, db: string, catalog: "def", max_length: 0, length: int, charsetnr: string, flags: int, type: int, decimals: int})|false', 'fieldnr' => 'int'], 'mysqli_result::fetch_fields' => ['list<stdClass&object{name: string, orgname: string, table: string, orgtable: string, def: string, db: string, catalog: "def", max_length: 0, length: int, charsetnr: string, flags: int, type: int, decimals: int}>'], 'UnitEnum::cases' => ['list<static>']], 'old' => ['pg_escape_bytea' => ['string', 'connection' => 'resource', 'data' => 'string'], 'pg_escape_bytea\'1' => ['string', 'data' => 'string'], 'pg_escape_identifier' => ['string|false', 'connection' => 'resource', 'data' => 'string'], 'pg_escape_identifier\'1' => ['string', 'data' => 'string'], 'pg_escape_literal' => ['string|false', 'connection' => 'resource', 'data' => 'string'], 'pg_escape_literal\'1' => ['string', 'data' => 'string'], 'pg_escape_string' => ['string', 'connection' => 'resource', 'data' => 'string'], 'pg_escape_string\'1' => ['string', 'data' => 'string'], 'pg_execute' => ['resource|false', 'connection' => 'resource', 'stmtname' => 'string', 'params' => 'array'], 'pg_execute\'1' => ['resource|false', 'stmtname' => 'string', 'params' => 'array'], 'pg_fetch_object' => ['object|false', 'result' => '', 'row=' => '?int', 'result_type=' => 'int'], 'pg_fetch_object\'1' => ['object', 'result' => '', 'row=' => '?int', 'class_name=' => 'string', 'ctor_params=' => 'array'], 'pg_fetch_result' => ['', 'result' => '', 'field_name' => 'string|int'], 'pg_fetch_result\'1' => ['', 'result' => '', 'row_number' => 'int', 'field_name' => 'string|int'], 'pg_field_is_null' => ['int|false', 'result' => '', 'field_name_or_number' => 'string|int'], 'pg_field_is_null\'1' => ['int', 'result' => '', 'row' => 'int', 'field_name_or_number' => 'string|int'], 'pg_field_prtlen' => ['int|false', 'result' => '', 'field_name_or_number' => ''], 'pg_field_prtlen\'1' => ['int', 'result' => '', 'row' => 'int', 'field_name_or_number' => 'string|int'], 'pg_lo_export' => ['bool', 'connection' => 'resource', 'oid' => 'int', 'filename' => 'string'], 'pg_lo_export\'1' => ['bool', 'oid' => 'int', 'pathname' => 'string'], 'pg_lo_import' => ['int|false', 'connection' => 'resource', 'pathname' => 'string', 'oid' => ''], 'pg_lo_import\'1' => ['int', 'pathname' => 'string', 'oid' => ''], 'pg_parameter_status' => ['string|false', 'connection' => 'resource', 'param_name' => 'string'], 'pg_parameter_status\'1' => ['string|false', 'param_name' => 'string'], 'pg_prepare' => ['resource|false', 'connection' => 'resource', 'stmtname' => 'string', 'query' => 'string'], 'pg_prepare\'1' => ['resource|false', 'stmtname' => 'string', 'query' => 'string'], 'pg_put_line' => ['bool', 'connection' => 'resource', 'data' => 'string'], 'pg_put_line\'1' => ['bool', 'data' => 'string'], 'pg_query' => ['resource|false', 'connection' => 'resource', 'query' => 'string'], 'pg_query\'1' => ['resource|false', 'query' => 'string'], 'pg_query_params' => ['resource|false', 'connection' => 'resource', 'query' => 'string', 'params' => 'array'], 'pg_query_params\'1' => ['resource|false', 'query' => 'string', 'params' => 'array'], 'pg_set_client_encoding' => ['int', 'connection' => 'resource', 'encoding' => 'string'], 'pg_set_client_encoding\'1' => ['int', 'encoding' => 'string'], 'pg_set_error_verbosity' => ['int|false', 'connection' => 'resource', 'verbosity' => 'int'], 'pg_set_error_verbosity\'1' => ['int', 'verbosity' => 'int'], 'pg_tty' => ['string', 'connection=' => 'resource'], 'pg_tty\'1' => ['string'], 'pg_untrace' => ['bool', 'connection=' => 'resource'], 'pg_untrace\'1' => ['bool']]]; <?php declare (strict_types=1); namespace _PHPStan_7d8742a37; require_once __DIR__ . '/src/AnalysedCodeException.php'; require_once __DIR__ . '/src/Analyser/Analyser.php'; require_once __DIR__ . '/src/Analyser/AnalyserResult.php'; require_once __DIR__ . '/src/Analyser/AnalyserResultFinalizer.php'; require_once __DIR__ . '/src/Analyser/ArgumentsNormalizer.php'; require_once __DIR__ . '/src/Analyser/ConditionalExpressionHolder.php'; require_once __DIR__ . '/src/Analyser/ConstantResolver.php'; require_once __DIR__ . '/src/Analyser/ConstantResolverFactory.php'; require_once __DIR__ . '/src/Analyser/DirectInternalScopeFactory.php'; require_once __DIR__ . '/src/Analyser/EndStatementResult.php'; require_once __DIR__ . '/src/Analyser/EnsuredNonNullabilityResult.php'; require_once __DIR__ . '/src/Analyser/EnsuredNonNullabilityResultExpression.php'; require_once __DIR__ . '/src/Analyser/Error.php'; require_once __DIR__ . '/src/Analyser/ExpressionContext.php'; require_once __DIR__ . '/src/Analyser/ExpressionResult.php'; require_once __DIR__ . '/src/Analyser/ExpressionTypeHolder.php'; require_once __DIR__ . '/src/Analyser/FileAnalyser.php'; require_once __DIR__ . '/src/Analyser/FileAnalyserResult.php'; require_once __DIR__ . '/src/Analyser/FinalizerResult.php'; require_once __DIR__ . '/src/Analyser/Ignore/IgnoreLexer.php'; require_once __DIR__ . '/src/Analyser/Ignore/IgnoreParseException.php'; require_once __DIR__ . '/src/Analyser/Ignore/IgnoredError.php'; require_once __DIR__ . '/src/Analyser/Ignore/IgnoredErrorHelper.php'; require_once __DIR__ . '/src/Analyser/Ignore/IgnoredErrorHelperProcessedResult.php'; require_once __DIR__ . '/src/Analyser/Ignore/IgnoredErrorHelperResult.php'; require_once __DIR__ . '/src/Analyser/ImpurePoint.php'; require_once __DIR__ . '/src/Analyser/InternalError.php'; require_once __DIR__ . '/src/Analyser/InternalScopeFactory.php'; require_once __DIR__ . '/src/Analyser/LazyInternalScopeFactory.php'; require_once __DIR__ . '/src/Analyser/LocalIgnoresProcessor.php'; require_once __DIR__ . '/src/Analyser/LocalIgnoresProcessorResult.php'; require_once __DIR__ . '/src/Analyser/MutatingScope.php'; require_once __DIR__ . '/src/Analyser/NameScope.php'; require_once __DIR__ . '/src/Analyser/NodeScopeResolver.php'; require_once __DIR__ . '/src/Analyser/NullsafeOperatorHelper.php'; require_once __DIR__ . '/src/Analyser/OutOfClassScope.php'; require_once __DIR__ . '/src/Analyser/ProcessClosureResult.php'; require_once __DIR__ . '/src/Analyser/ResultCache/ResultCache.php'; require_once __DIR__ . '/src/Analyser/ResultCache/ResultCacheClearer.php'; require_once __DIR__ . '/src/Analyser/ResultCache/ResultCacheManager.php'; require_once __DIR__ . '/src/Analyser/ResultCache/ResultCacheManagerFactory.php'; require_once __DIR__ . '/src/Analyser/ResultCache/ResultCacheProcessResult.php'; require_once __DIR__ . '/src/Analyser/RicherScopeGetTypeHelper.php'; require_once __DIR__ . '/src/Analyser/RuleErrorTransformer.php'; require_once __DIR__ . '/src/Analyser/Scope.php'; require_once __DIR__ . '/src/Analyser/ScopeContext.php'; require_once __DIR__ . '/src/Analyser/ScopeFactory.php'; require_once __DIR__ . '/src/Analyser/SpecifiedTypes.php'; require_once __DIR__ . '/src/Analyser/StatementContext.php'; require_once __DIR__ . '/src/Analyser/StatementExitPoint.php'; require_once __DIR__ . '/src/Analyser/StatementResult.php'; require_once __DIR__ . '/src/Analyser/ThrowPoint.php'; require_once __DIR__ . '/src/Analyser/TypeSpecifier.php'; require_once __DIR__ . '/src/Analyser/TypeSpecifierAwareExtension.php'; require_once __DIR__ . '/src/Analyser/TypeSpecifierContext.php'; require_once __DIR__ . '/src/Analyser/TypeSpecifierFactory.php'; require_once __DIR__ . '/src/Analyser/UndefinedVariableException.php'; require_once __DIR__ . '/src/Broker/AnonymousClassNameHelper.php'; require_once __DIR__ . '/src/Broker/Broker.php'; require_once __DIR__ . '/src/Broker/BrokerFactory.php'; require_once __DIR__ . '/src/Broker/ClassAutoloadingException.php'; require_once __DIR__ . '/src/Broker/ClassNotFoundException.php'; require_once __DIR__ . '/src/Broker/ConstantNotFoundException.php'; require_once __DIR__ . '/src/Broker/FunctionNotFoundException.php'; require_once __DIR__ . '/src/Cache/Cache.php'; require_once __DIR__ . '/src/Cache/CacheItem.php'; require_once __DIR__ . '/src/Cache/CacheStorage.php'; require_once __DIR__ . '/src/Cache/FileCacheStorage.php'; require_once __DIR__ . '/src/Cache/MemoryCacheStorage.php'; require_once __DIR__ . '/src/Classes/ForbiddenClassNameExtension.php'; require_once __DIR__ . '/src/Collectors/CollectedData.php'; require_once __DIR__ . '/src/Collectors/Collector.php'; require_once __DIR__ . '/src/Collectors/Registry.php'; require_once __DIR__ . '/src/Collectors/RegistryFactory.php'; require_once __DIR__ . '/src/Command/AnalyseApplication.php'; require_once __DIR__ . '/src/Command/AnalyseCommand.php'; require_once __DIR__ . '/src/Command/AnalyserRunner.php'; require_once __DIR__ . '/src/Command/AnalysisResult.php'; require_once __DIR__ . '/src/Command/ClearResultCacheCommand.php'; require_once __DIR__ . '/src/Command/CommandHelper.php'; require_once __DIR__ . '/src/Command/DiagnoseCommand.php'; require_once __DIR__ . '/src/Command/DumpParametersCommand.php'; require_once __DIR__ . '/src/Command/ErrorFormatter/BaselineNeonErrorFormatter.php'; require_once __DIR__ . '/src/Command/ErrorFormatter/BaselinePhpErrorFormatter.php'; require_once __DIR__ . '/src/Command/ErrorFormatter/CheckstyleErrorFormatter.php'; require_once __DIR__ . '/src/Command/ErrorFormatter/CiDetectedErrorFormatter.php'; require_once __DIR__ . '/src/Command/ErrorFormatter/ErrorFormatter.php'; require_once __DIR__ . '/src/Command/ErrorFormatter/GithubErrorFormatter.php'; require_once __DIR__ . '/src/Command/ErrorFormatter/GitlabErrorFormatter.php'; require_once __DIR__ . '/src/Command/ErrorFormatter/JsonErrorFormatter.php'; require_once __DIR__ . '/src/Command/ErrorFormatter/JunitErrorFormatter.php'; require_once __DIR__ . '/src/Command/ErrorFormatter/RawErrorFormatter.php'; require_once __DIR__ . '/src/Command/ErrorFormatter/TableErrorFormatter.php'; require_once __DIR__ . '/src/Command/ErrorFormatter/TeamcityErrorFormatter.php'; require_once __DIR__ . '/src/Command/ErrorsConsoleStyle.php'; require_once __DIR__ . '/src/Command/FixerApplication.php'; require_once __DIR__ . '/src/Command/FixerProcessException.php'; require_once __DIR__ . '/src/Command/FixerWorkerCommand.php'; require_once __DIR__ . '/src/Command/IgnoredRegexValidator.php'; require_once __DIR__ . '/src/Command/IgnoredRegexValidatorResult.php'; require_once __DIR__ . '/src/Command/InceptionNotSuccessfulException.php'; require_once __DIR__ . '/src/Command/InceptionResult.php'; require_once __DIR__ . '/src/Command/Output.php'; require_once __DIR__ . '/src/Command/OutputStyle.php'; require_once __DIR__ . '/src/Command/Symfony/SymfonyOutput.php'; require_once __DIR__ . '/src/Command/Symfony/SymfonyStyle.php'; require_once __DIR__ . '/src/Command/WorkerCommand.php'; require_once __DIR__ . '/src/Dependency/DependencyResolver.php'; require_once __DIR__ . '/src/Dependency/ExportedNode.php'; require_once __DIR__ . '/src/Dependency/ExportedNode/ExportedAttributeNode.php'; require_once __DIR__ . '/src/Dependency/ExportedNode/ExportedClassConstantNode.php'; require_once __DIR__ . '/src/Dependency/ExportedNode/ExportedClassConstantsNode.php'; require_once __DIR__ . '/src/Dependency/ExportedNode/ExportedClassNode.php'; require_once __DIR__ . '/src/Dependency/ExportedNode/ExportedEnumCaseNode.php'; require_once __DIR__ . '/src/Dependency/ExportedNode/ExportedEnumNode.php'; require_once __DIR__ . '/src/Dependency/ExportedNode/ExportedFunctionNode.php'; require_once __DIR__ . '/src/Dependency/ExportedNode/ExportedInterfaceNode.php'; require_once __DIR__ . '/src/Dependency/ExportedNode/ExportedMethodNode.php'; require_once __DIR__ . '/src/Dependency/ExportedNode/ExportedParameterNode.php'; require_once __DIR__ . '/src/Dependency/ExportedNode/ExportedPhpDocNode.php'; require_once __DIR__ . '/src/Dependency/ExportedNode/ExportedPropertiesNode.php'; require_once __DIR__ . '/src/Dependency/ExportedNode/ExportedTraitNode.php'; require_once __DIR__ . '/src/Dependency/ExportedNode/ExportedTraitUseAdaptation.php'; require_once __DIR__ . '/src/Dependency/ExportedNodeFetcher.php'; require_once __DIR__ . '/src/Dependency/ExportedNodeResolver.php'; require_once __DIR__ . '/src/Dependency/ExportedNodeVisitor.php'; require_once __DIR__ . '/src/Dependency/NodeDependencies.php'; require_once __DIR__ . '/src/Dependency/RootExportedNode.php'; require_once __DIR__ . '/src/DependencyInjection/BleedingEdgeToggle.php'; require_once __DIR__ . '/src/DependencyInjection/ConditionalTagsExtension.php'; require_once __DIR__ . '/src/DependencyInjection/Configurator.php'; require_once __DIR__ . '/src/DependencyInjection/Container.php'; require_once __DIR__ . '/src/DependencyInjection/ContainerFactory.php'; require_once __DIR__ . '/src/DependencyInjection/DerivativeContainerFactory.php'; require_once __DIR__ . '/src/DependencyInjection/DuplicateIncludedFilesException.php'; require_once __DIR__ . '/src/DependencyInjection/InvalidExcludePathsException.php'; require_once __DIR__ . '/src/DependencyInjection/InvalidIgnoredErrorPatternsException.php'; require_once __DIR__ . '/src/DependencyInjection/LoaderFactory.php'; require_once __DIR__ . '/src/DependencyInjection/MemoizingContainer.php'; require_once __DIR__ . '/src/DependencyInjection/Neon/OptionalPath.php'; require_once __DIR__ . '/src/DependencyInjection/NeonAdapter.php'; require_once __DIR__ . '/src/DependencyInjection/NeonLoader.php'; require_once __DIR__ . '/src/DependencyInjection/Nette/NetteContainer.php'; require_once __DIR__ . '/src/DependencyInjection/ParameterNotFoundException.php'; require_once __DIR__ . '/src/DependencyInjection/ParametersSchemaExtension.php'; require_once __DIR__ . '/src/DependencyInjection/ProjectConfigHelper.php'; require_once __DIR__ . '/src/DependencyInjection/Reflection/ClassReflectionExtensionRegistryProvider.php'; require_once __DIR__ . '/src/DependencyInjection/Reflection/LazyClassReflectionExtensionRegistryProvider.php'; require_once __DIR__ . '/src/DependencyInjection/RulesExtension.php'; require_once __DIR__ . '/src/DependencyInjection/Type/DynamicReturnTypeExtensionRegistryProvider.php'; require_once __DIR__ . '/src/DependencyInjection/Type/DynamicThrowTypeExtensionProvider.php'; require_once __DIR__ . '/src/DependencyInjection/Type/ExpressionTypeResolverExtensionRegistryProvider.php'; require_once __DIR__ . '/src/DependencyInjection/Type/LazyDynamicReturnTypeExtensionRegistryProvider.php'; require_once __DIR__ . '/src/DependencyInjection/Type/LazyDynamicThrowTypeExtensionProvider.php'; require_once __DIR__ . '/src/DependencyInjection/Type/LazyExpressionTypeResolverExtensionRegistryProvider.php'; require_once __DIR__ . '/src/DependencyInjection/Type/LazyOperatorTypeSpecifyingExtensionRegistryProvider.php'; require_once __DIR__ . '/src/DependencyInjection/Type/LazyParameterClosureTypeExtensionProvider.php'; require_once __DIR__ . '/src/DependencyInjection/Type/LazyParameterOutTypeExtensionProvider.php'; require_once __DIR__ . '/src/DependencyInjection/Type/OperatorTypeSpecifyingExtensionRegistryProvider.php'; require_once __DIR__ . '/src/DependencyInjection/Type/ParameterClosureTypeExtensionProvider.php'; require_once __DIR__ . '/src/DependencyInjection/Type/ParameterOutTypeExtensionProvider.php'; require_once __DIR__ . '/src/DependencyInjection/ValidateExcludePathsExtension.php'; require_once __DIR__ . '/src/DependencyInjection/ValidateIgnoredErrorsExtension.php'; require_once __DIR__ . '/src/Diagnose/DiagnoseExtension.php'; require_once __DIR__ . '/src/Diagnose/PHPStanDiagnoseExtension.php'; require_once __DIR__ . '/src/File/CouldNotReadFileException.php'; require_once __DIR__ . '/src/File/CouldNotWriteFileException.php'; require_once __DIR__ . '/src/File/FileExcluder.php'; require_once __DIR__ . '/src/File/FileExcluderFactory.php'; require_once __DIR__ . '/src/File/FileExcluderRawFactory.php'; require_once __DIR__ . '/src/File/FileFinder.php'; require_once __DIR__ . '/src/File/FileFinderResult.php'; require_once __DIR__ . '/src/File/FileHelper.php'; require_once __DIR__ . '/src/File/FileMonitor.php'; require_once __DIR__ . '/src/File/FileMonitorResult.php'; require_once __DIR__ . '/src/File/FileReader.php'; require_once __DIR__ . '/src/File/FileWriter.php'; require_once __DIR__ . '/src/File/FuzzyRelativePathHelper.php'; require_once __DIR__ . '/src/File/NullRelativePathHelper.php'; require_once __DIR__ . '/src/File/ParentDirectoryRelativePathHelper.php'; require_once __DIR__ . '/src/File/PathNotFoundException.php'; require_once __DIR__ . '/src/File/RelativePathHelper.php'; require_once __DIR__ . '/src/File/SimpleRelativePathHelper.php'; require_once __DIR__ . '/src/File/SystemAgnosticSimpleRelativePathHelper.php'; require_once __DIR__ . '/src/Internal/BytesHelper.php'; require_once __DIR__ . '/src/Internal/CombinationsHelper.php'; require_once __DIR__ . '/src/Internal/ComposerHelper.php'; require_once __DIR__ . '/src/Internal/ContainerDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Internal/DirectoryCreator.php'; require_once __DIR__ . '/src/Internal/DirectoryCreatorException.php'; require_once __DIR__ . '/src/Internal/SprintfHelper.php'; require_once __DIR__ . '/src/Node/AnonymousClassNode.php'; require_once __DIR__ . '/src/Node/BooleanAndNode.php'; require_once __DIR__ . '/src/Node/BooleanOrNode.php'; require_once __DIR__ . '/src/Node/BreaklessWhileLoopNode.php'; require_once __DIR__ . '/src/Node/CatchWithUnthrownExceptionNode.php'; require_once __DIR__ . '/src/Node/ClassConstantsNode.php'; require_once __DIR__ . '/src/Node/ClassMethod.php'; require_once __DIR__ . '/src/Node/ClassMethodsNode.php'; require_once __DIR__ . '/src/Node/ClassPropertiesNode.php'; require_once __DIR__ . '/src/Node/ClassPropertyNode.php'; require_once __DIR__ . '/src/Node/ClassStatementsGatherer.php'; require_once __DIR__ . '/src/Node/ClosureReturnStatementsNode.php'; require_once __DIR__ . '/src/Node/CollectedDataNode.php'; require_once __DIR__ . '/src/Node/Constant/ClassConstantFetch.php'; require_once __DIR__ . '/src/Node/DoWhileLoopConditionNode.php'; require_once __DIR__ . '/src/Node/ExecutionEndNode.php'; require_once __DIR__ . '/src/Node/Expr/AlwaysRememberedExpr.php'; require_once __DIR__ . '/src/Node/Expr/ExistingArrayDimFetch.php'; require_once __DIR__ . '/src/Node/Expr/GetIterableKeyTypeExpr.php'; require_once __DIR__ . '/src/Node/Expr/GetIterableValueTypeExpr.php'; require_once __DIR__ . '/src/Node/Expr/GetOffsetValueTypeExpr.php'; require_once __DIR__ . '/src/Node/Expr/OriginalPropertyTypeExpr.php'; require_once __DIR__ . '/src/Node/Expr/ParameterVariableOriginalValueExpr.php'; require_once __DIR__ . '/src/Node/Expr/PropertyInitializationExpr.php'; require_once __DIR__ . '/src/Node/Expr/SetExistingOffsetValueTypeExpr.php'; require_once __DIR__ . '/src/Node/Expr/SetOffsetValueTypeExpr.php'; require_once __DIR__ . '/src/Node/Expr/TypeExpr.php'; require_once __DIR__ . '/src/Node/Expr/UnsetOffsetExpr.php'; require_once __DIR__ . '/src/Node/FileNode.php'; require_once __DIR__ . '/src/Node/FinallyExitPointsNode.php'; require_once __DIR__ . '/src/Node/FunctionCallableNode.php'; require_once __DIR__ . '/src/Node/FunctionReturnStatementsNode.php'; require_once __DIR__ . '/src/Node/InArrowFunctionNode.php'; require_once __DIR__ . '/src/Node/InClassMethodNode.php'; require_once __DIR__ . '/src/Node/InClassNode.php'; require_once __DIR__ . '/src/Node/InClosureNode.php'; require_once __DIR__ . '/src/Node/InForeachNode.php'; require_once __DIR__ . '/src/Node/InFunctionNode.php'; require_once __DIR__ . '/src/Node/InTraitNode.php'; require_once __DIR__ . '/src/Node/InstantiationCallableNode.php'; require_once __DIR__ . '/src/Node/InvalidateExprNode.php'; require_once __DIR__ . '/src/Node/IssetExpr.php'; require_once __DIR__ . '/src/Node/LiteralArrayItem.php'; require_once __DIR__ . '/src/Node/LiteralArrayNode.php'; require_once __DIR__ . '/src/Node/MatchExpressionArm.php'; require_once __DIR__ . '/src/Node/MatchExpressionArmBody.php'; require_once __DIR__ . '/src/Node/MatchExpressionArmCondition.php'; require_once __DIR__ . '/src/Node/MatchExpressionNode.php'; require_once __DIR__ . '/src/Node/Method/MethodCall.php'; require_once __DIR__ . '/src/Node/MethodCallableNode.php'; require_once __DIR__ . '/src/Node/MethodReturnStatementsNode.php'; require_once __DIR__ . '/src/Node/NoopExpressionNode.php'; require_once __DIR__ . '/src/Node/Printer/ExprPrinter.php'; require_once __DIR__ . '/src/Node/Printer/NodeTypePrinter.php'; require_once __DIR__ . '/src/Node/Printer/Printer.php'; require_once __DIR__ . '/src/Node/Property/PropertyAssign.php'; require_once __DIR__ . '/src/Node/Property/PropertyRead.php'; require_once __DIR__ . '/src/Node/Property/PropertyWrite.php'; require_once __DIR__ . '/src/Node/PropertyAssignNode.php'; require_once __DIR__ . '/src/Node/ReturnStatement.php'; require_once __DIR__ . '/src/Node/ReturnStatementsNode.php'; require_once __DIR__ . '/src/Node/StaticMethodCallableNode.php'; require_once __DIR__ . '/src/Node/UnreachableStatementNode.php'; require_once __DIR__ . '/src/Node/VarTagChangedExpressionTypeNode.php'; require_once __DIR__ . '/src/Node/VariableAssignNode.php'; require_once __DIR__ . '/src/Node/VirtualNode.php'; require_once __DIR__ . '/src/Parallel/ParallelAnalyser.php'; require_once __DIR__ . '/src/Parallel/Process.php'; require_once __DIR__ . '/src/Parallel/ProcessPool.php'; require_once __DIR__ . '/src/Parallel/ProcessTimedOutException.php'; require_once __DIR__ . '/src/Parallel/Schedule.php'; require_once __DIR__ . '/src/Parallel/Scheduler.php'; require_once __DIR__ . '/src/Parser/AnonymousClassVisitor.php'; require_once __DIR__ . '/src/Parser/ArrayFilterArgVisitor.php'; require_once __DIR__ . '/src/Parser/ArrayFindArgVisitor.php'; require_once __DIR__ . '/src/Parser/ArrayMapArgVisitor.php'; require_once __DIR__ . '/src/Parser/ArrayWalkArgVisitor.php'; require_once __DIR__ . '/src/Parser/ArrowFunctionArgVisitor.php'; require_once __DIR__ . '/src/Parser/CachedParser.php'; require_once __DIR__ . '/src/Parser/CleaningParser.php'; require_once __DIR__ . '/src/Parser/CleaningVisitor.php'; require_once __DIR__ . '/src/Parser/ClosureArgVisitor.php'; require_once __DIR__ . '/src/Parser/ClosureBindArgVisitor.php'; require_once __DIR__ . '/src/Parser/ClosureBindToVarVisitor.php'; require_once __DIR__ . '/src/Parser/CurlSetOptArgVisitor.php'; require_once __DIR__ . '/src/Parser/DeclarePositionVisitor.php'; require_once __DIR__ . '/src/Parser/FunctionCallStatementFinder.php'; require_once __DIR__ . '/src/Parser/ImmediatelyInvokedClosureVisitor.php'; require_once __DIR__ . '/src/Parser/LastConditionVisitor.php'; require_once __DIR__ . '/src/Parser/LexerFactory.php'; require_once __DIR__ . '/src/Parser/MagicConstantParamDefaultVisitor.php'; require_once __DIR__ . '/src/Parser/NewAssignedToPropertyVisitor.php'; require_once __DIR__ . '/src/Parser/ParentStmtTypesVisitor.php'; require_once __DIR__ . '/src/Parser/Parser.php'; require_once __DIR__ . '/src/Parser/ParserErrorsException.php'; require_once __DIR__ . '/src/Parser/PathRoutingParser.php'; require_once __DIR__ . '/src/Parser/PhpParserDecorator.php'; require_once __DIR__ . '/src/Parser/RemoveUnusedCodeByPhpVersionIdVisitor.php'; require_once __DIR__ . '/src/Parser/RichParser.php'; require_once __DIR__ . '/src/Parser/SimpleParser.php'; require_once __DIR__ . '/src/Parser/TraitCollectingVisitor.php'; require_once __DIR__ . '/src/Parser/TryCatchTypeVisitor.php'; require_once __DIR__ . '/src/Parser/TypeTraverserInstanceofVisitor.php'; require_once __DIR__ . '/src/Php/PhpVersion.php'; require_once __DIR__ . '/src/Php/PhpVersionFactory.php'; require_once __DIR__ . '/src/Php/PhpVersionFactoryFactory.php'; require_once __DIR__ . '/src/PhpDoc/ConstExprNodeResolver.php'; require_once __DIR__ . '/src/PhpDoc/ConstExprParserFactory.php'; require_once __DIR__ . '/src/PhpDoc/CountableStubFilesExtension.php'; require_once __DIR__ . '/src/PhpDoc/DefaultStubFilesProvider.php'; require_once __DIR__ . '/src/PhpDoc/DirectTypeNodeResolverExtensionRegistryProvider.php'; require_once __DIR__ . '/src/PhpDoc/JsonValidateStubFilesExtension.php'; require_once __DIR__ . '/src/PhpDoc/LazyTypeNodeResolverExtensionRegistryProvider.php'; require_once __DIR__ . '/src/PhpDoc/NameScopeAlreadyBeingCreatedException.php'; require_once __DIR__ . '/src/PhpDoc/PhpDocBlock.php'; require_once __DIR__ . '/src/PhpDoc/PhpDocInheritanceResolver.php'; require_once __DIR__ . '/src/PhpDoc/PhpDocNodeResolver.php'; require_once __DIR__ . '/src/PhpDoc/PhpDocStringResolver.php'; require_once __DIR__ . '/src/PhpDoc/ReflectionEnumStubFilesExtension.php'; require_once __DIR__ . '/src/PhpDoc/ResolvedPhpDocBlock.php'; require_once __DIR__ . '/src/PhpDoc/SocketSelectStubFilesExtension.php'; require_once __DIR__ . '/src/PhpDoc/StubFilesExtension.php'; require_once __DIR__ . '/src/PhpDoc/StubFilesProvider.php'; require_once __DIR__ . '/src/PhpDoc/StubPhpDocProvider.php'; require_once __DIR__ . '/src/PhpDoc/StubSourceLocatorFactory.php'; require_once __DIR__ . '/src/PhpDoc/StubValidator.php'; require_once __DIR__ . '/src/PhpDoc/Tag/AssertTag.php'; require_once __DIR__ . '/src/PhpDoc/Tag/AssertTagParameter.php'; require_once __DIR__ . '/src/PhpDoc/Tag/DeprecatedTag.php'; require_once __DIR__ . '/src/PhpDoc/Tag/ExtendsTag.php'; require_once __DIR__ . '/src/PhpDoc/Tag/ImplementsTag.php'; require_once __DIR__ . '/src/PhpDoc/Tag/MethodTag.php'; require_once __DIR__ . '/src/PhpDoc/Tag/MethodTagParameter.php'; require_once __DIR__ . '/src/PhpDoc/Tag/MixinTag.php'; require_once __DIR__ . '/src/PhpDoc/Tag/ParamClosureThisTag.php'; require_once __DIR__ . '/src/PhpDoc/Tag/ParamOutTag.php'; require_once __DIR__ . '/src/PhpDoc/Tag/ParamTag.php'; require_once __DIR__ . '/src/PhpDoc/Tag/PropertyTag.php'; require_once __DIR__ . '/src/PhpDoc/Tag/RequireExtendsTag.php'; require_once __DIR__ . '/src/PhpDoc/Tag/RequireImplementsTag.php'; require_once __DIR__ . '/src/PhpDoc/Tag/ReturnTag.php'; require_once __DIR__ . '/src/PhpDoc/Tag/SelfOutTypeTag.php'; require_once __DIR__ . '/src/PhpDoc/Tag/TemplateTag.php'; require_once __DIR__ . '/src/PhpDoc/Tag/ThrowsTag.php'; require_once __DIR__ . '/src/PhpDoc/Tag/TypeAliasImportTag.php'; require_once __DIR__ . '/src/PhpDoc/Tag/TypeAliasTag.php'; require_once __DIR__ . '/src/PhpDoc/Tag/TypedTag.php'; require_once __DIR__ . '/src/PhpDoc/Tag/UsesTag.php'; require_once __DIR__ . '/src/PhpDoc/Tag/VarTag.php'; require_once __DIR__ . '/src/PhpDoc/TypeNodeResolver.php'; require_once __DIR__ . '/src/PhpDoc/TypeNodeResolverAwareExtension.php'; require_once __DIR__ . '/src/PhpDoc/TypeNodeResolverExtension.php'; require_once __DIR__ . '/src/PhpDoc/TypeNodeResolverExtensionAwareRegistry.php'; require_once __DIR__ . '/src/PhpDoc/TypeNodeResolverExtensionRegistry.php'; require_once __DIR__ . '/src/PhpDoc/TypeNodeResolverExtensionRegistryProvider.php'; require_once __DIR__ . '/src/PhpDoc/TypeStringResolver.php'; require_once __DIR__ . '/src/Process/CpuCoreCounter.php'; require_once __DIR__ . '/src/Process/ProcessCanceledException.php'; require_once __DIR__ . '/src/Process/ProcessCrashedException.php'; require_once __DIR__ . '/src/Process/ProcessHelper.php'; require_once __DIR__ . '/src/Process/ProcessPromise.php'; require_once __DIR__ . '/src/Reflection/AdditionalConstructorsExtension.php'; require_once __DIR__ . '/src/Reflection/AllowedSubTypesClassReflectionExtension.php'; require_once __DIR__ . '/src/Reflection/Annotations/AnnotationMethodReflection.php'; require_once __DIR__ . '/src/Reflection/Annotations/AnnotationPropertyReflection.php'; require_once __DIR__ . '/src/Reflection/Annotations/AnnotationsMethodParameterReflection.php'; require_once __DIR__ . '/src/Reflection/Annotations/AnnotationsMethodsClassReflectionExtension.php'; require_once __DIR__ . '/src/Reflection/Annotations/AnnotationsPropertiesClassReflectionExtension.php'; require_once __DIR__ . '/src/Reflection/Assertions.php'; require_once __DIR__ . '/src/Reflection/BetterReflection/BetterReflectionProvider.php'; require_once __DIR__ . '/src/Reflection/BetterReflection/BetterReflectionProviderFactory.php'; require_once __DIR__ . '/src/Reflection/BetterReflection/BetterReflectionSourceLocatorFactory.php'; require_once __DIR__ . '/src/Reflection/BetterReflection/Reflector/MemoizingReflector.php'; require_once __DIR__ . '/src/Reflection/BetterReflection/SourceLocator/AutoloadFunctionsSourceLocator.php'; require_once __DIR__ . '/src/Reflection/BetterReflection/SourceLocator/AutoloadSourceLocator.php'; require_once __DIR__ . '/src/Reflection/BetterReflection/SourceLocator/CachingVisitor.php'; require_once __DIR__ . '/src/Reflection/BetterReflection/SourceLocator/ComposerJsonAndInstalledJsonSourceLocatorMaker.php'; require_once __DIR__ . '/src/Reflection/BetterReflection/SourceLocator/FetchedNode.php'; require_once __DIR__ . '/src/Reflection/BetterReflection/SourceLocator/FetchedNodesResult.php'; require_once __DIR__ . '/src/Reflection/BetterReflection/SourceLocator/FileNodesFetcher.php'; require_once __DIR__ . '/src/Reflection/BetterReflection/SourceLocator/FileReadTrapStreamWrapper.php'; require_once __DIR__ . '/src/Reflection/BetterReflection/SourceLocator/NewOptimizedDirectorySourceLocator.php'; require_once __DIR__ . '/src/Reflection/BetterReflection/SourceLocator/OptimizedDirectorySourceLocator.php'; require_once __DIR__ . '/src/Reflection/BetterReflection/SourceLocator/OptimizedDirectorySourceLocatorFactory.php'; require_once __DIR__ . '/src/Reflection/BetterReflection/SourceLocator/OptimizedDirectorySourceLocatorRepository.php'; require_once __DIR__ . '/src/Reflection/BetterReflection/SourceLocator/OptimizedPsrAutoloaderLocator.php'; require_once __DIR__ . '/src/Reflection/BetterReflection/SourceLocator/OptimizedPsrAutoloaderLocatorFactory.php'; require_once __DIR__ . '/src/Reflection/BetterReflection/SourceLocator/OptimizedSingleFileSourceLocator.php'; require_once __DIR__ . '/src/Reflection/BetterReflection/SourceLocator/OptimizedSingleFileSourceLocatorFactory.php'; require_once __DIR__ . '/src/Reflection/BetterReflection/SourceLocator/OptimizedSingleFileSourceLocatorRepository.php'; require_once __DIR__ . '/src/Reflection/BetterReflection/SourceLocator/PhpFileCleaner.php'; require_once __DIR__ . '/src/Reflection/BetterReflection/SourceLocator/PhpVersionBlacklistSourceLocator.php'; require_once __DIR__ . '/src/Reflection/BetterReflection/SourceLocator/ReflectionClassSourceLocator.php'; require_once __DIR__ . '/src/Reflection/BetterReflection/SourceLocator/RewriteClassAliasSourceLocator.php'; require_once __DIR__ . '/src/Reflection/BetterReflection/SourceLocator/SkipClassAliasSourceLocator.php'; require_once __DIR__ . '/src/Reflection/BetterReflection/SourceStubber/PhpStormStubsSourceStubberFactory.php'; require_once __DIR__ . '/src/Reflection/BetterReflection/SourceStubber/ReflectionSourceStubberFactory.php'; require_once __DIR__ . '/src/Reflection/BrokerAwareExtension.php'; require_once __DIR__ . '/src/Reflection/CallableFunctionVariantWithPhpDocs.php'; require_once __DIR__ . '/src/Reflection/Callables/CallableParametersAcceptor.php'; require_once __DIR__ . '/src/Reflection/Callables/FunctionCallableVariant.php'; require_once __DIR__ . '/src/Reflection/Callables/SimpleImpurePoint.php'; require_once __DIR__ . '/src/Reflection/Callables/SimpleThrowPoint.php'; require_once __DIR__ . '/src/Reflection/ClassConstantReflection.php'; require_once __DIR__ . '/src/Reflection/ClassMemberAccessAnswerer.php'; require_once __DIR__ . '/src/Reflection/ClassMemberReflection.php'; require_once __DIR__ . '/src/Reflection/ClassNameHelper.php'; require_once __DIR__ . '/src/Reflection/ClassReflection.php'; require_once __DIR__ . '/src/Reflection/ClassReflectionExtensionRegistry.php'; require_once __DIR__ . '/src/Reflection/Constant/RuntimeConstantReflection.php'; require_once __DIR__ . '/src/Reflection/ConstantNameHelper.php'; require_once __DIR__ . '/src/Reflection/ConstantReflection.php'; require_once __DIR__ . '/src/Reflection/ConstructorsHelper.php'; require_once __DIR__ . '/src/Reflection/Dummy/ChangedTypeMethodReflection.php'; require_once __DIR__ . '/src/Reflection/Dummy/ChangedTypePropertyReflection.php'; require_once __DIR__ . '/src/Reflection/Dummy/DummyConstantReflection.php'; require_once __DIR__ . '/src/Reflection/Dummy/DummyConstructorReflection.php'; require_once __DIR__ . '/src/Reflection/Dummy/DummyMethodReflection.php'; require_once __DIR__ . '/src/Reflection/Dummy/DummyPropertyReflection.php'; require_once __DIR__ . '/src/Reflection/EnumCaseReflection.php'; require_once __DIR__ . '/src/Reflection/ExtendedMethodReflection.php'; require_once __DIR__ . '/src/Reflection/ExtendedPropertyReflection.php'; require_once __DIR__ . '/src/Reflection/FunctionReflection.php'; require_once __DIR__ . '/src/Reflection/FunctionReflectionFactory.php'; require_once __DIR__ . '/src/Reflection/FunctionVariant.php'; require_once __DIR__ . '/src/Reflection/FunctionVariantWithPhpDocs.php'; require_once __DIR__ . '/src/Reflection/GenericParametersAcceptorResolver.php'; require_once __DIR__ . '/src/Reflection/GlobalConstantReflection.php'; require_once __DIR__ . '/src/Reflection/InaccessibleMethod.php'; require_once __DIR__ . '/src/Reflection/InitializerExprContext.php'; require_once __DIR__ . '/src/Reflection/InitializerExprTypeResolver.php'; require_once __DIR__ . '/src/Reflection/MethodPrototypeReflection.php'; require_once __DIR__ . '/src/Reflection/MethodReflection.php'; require_once __DIR__ . '/src/Reflection/MethodsClassReflectionExtension.php'; require_once __DIR__ . '/src/Reflection/MissingConstantFromReflectionException.php'; require_once __DIR__ . '/src/Reflection/MissingMethodFromReflectionException.php'; require_once __DIR__ . '/src/Reflection/MissingPropertyFromReflectionException.php'; require_once __DIR__ . '/src/Reflection/Mixin/MixinMethodReflection.php'; require_once __DIR__ . '/src/Reflection/Mixin/MixinMethodsClassReflectionExtension.php'; require_once __DIR__ . '/src/Reflection/Mixin/MixinPropertiesClassReflectionExtension.php'; require_once __DIR__ . '/src/Reflection/NamespaceAnswerer.php'; require_once __DIR__ . '/src/Reflection/Native/NativeFunctionReflection.php'; require_once __DIR__ . '/src/Reflection/Native/NativeMethodReflection.php'; require_once __DIR__ . '/src/Reflection/Native/NativeParameterReflection.php'; require_once __DIR__ . '/src/Reflection/Native/NativeParameterWithPhpDocsReflection.php'; require_once __DIR__ . '/src/Reflection/PHPStan/NativeReflectionEnumReturnDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Reflection/ParameterReflection.php'; require_once __DIR__ . '/src/Reflection/ParameterReflectionWithPhpDocs.php'; require_once __DIR__ . '/src/Reflection/ParametersAcceptor.php'; require_once __DIR__ . '/src/Reflection/ParametersAcceptorSelector.php'; require_once __DIR__ . '/src/Reflection/ParametersAcceptorWithPhpDocs.php'; require_once __DIR__ . '/src/Reflection/PassedByReference.php'; require_once __DIR__ . '/src/Reflection/Php/BuiltinMethodReflection.php'; require_once __DIR__ . '/src/Reflection/Php/ClosureCallMethodReflection.php'; require_once __DIR__ . '/src/Reflection/Php/ClosureCallUnresolvedMethodPrototypeReflection.php'; require_once __DIR__ . '/src/Reflection/Php/DummyParameter.php'; require_once __DIR__ . '/src/Reflection/Php/DummyParameterWithPhpDocs.php'; require_once __DIR__ . '/src/Reflection/Php/EnumAllowedSubTypesClassReflectionExtension.php'; require_once __DIR__ . '/src/Reflection/Php/EnumCasesMethodReflection.php'; require_once __DIR__ . '/src/Reflection/Php/EnumPropertyReflection.php'; require_once __DIR__ . '/src/Reflection/Php/EnumUnresolvedPropertyPrototypeReflection.php'; require_once __DIR__ . '/src/Reflection/Php/ExitFunctionReflection.php'; require_once __DIR__ . '/src/Reflection/Php/NativeBuiltinMethodReflection.php'; require_once __DIR__ . '/src/Reflection/Php/PhpClassReflectionExtension.php'; require_once __DIR__ . '/src/Reflection/Php/PhpFunctionFromParserNodeReflection.php'; require_once __DIR__ . '/src/Reflection/Php/PhpFunctionReflection.php'; require_once __DIR__ . '/src/Reflection/Php/PhpMethodFromParserNodeReflection.php'; require_once __DIR__ . '/src/Reflection/Php/PhpMethodReflection.php'; require_once __DIR__ . '/src/Reflection/Php/PhpMethodReflectionFactory.php'; require_once __DIR__ . '/src/Reflection/Php/PhpParameterFromParserNodeReflection.php'; require_once __DIR__ . '/src/Reflection/Php/PhpParameterReflection.php'; require_once __DIR__ . '/src/Reflection/Php/PhpPropertyReflection.php'; require_once __DIR__ . '/src/Reflection/Php/SimpleXMLElementProperty.php'; require_once __DIR__ . '/src/Reflection/Php/Soap/SoapClientMethodReflection.php'; require_once __DIR__ . '/src/Reflection/Php/Soap/SoapClientMethodsClassReflectionExtension.php'; require_once __DIR__ . '/src/Reflection/Php/UniversalObjectCrateProperty.php'; require_once __DIR__ . '/src/Reflection/Php/UniversalObjectCratesClassReflectionExtension.php'; require_once __DIR__ . '/src/Reflection/PhpVersionStaticAccessor.php'; require_once __DIR__ . '/src/Reflection/PropertiesClassReflectionExtension.php'; require_once __DIR__ . '/src/Reflection/PropertyReflection.php'; require_once __DIR__ . '/src/Reflection/ReflectionProvider.php'; require_once __DIR__ . '/src/Reflection/ReflectionProvider/DirectReflectionProviderProvider.php'; require_once __DIR__ . '/src/Reflection/ReflectionProvider/DummyReflectionProvider.php'; require_once __DIR__ . '/src/Reflection/ReflectionProvider/LazyReflectionProviderProvider.php'; require_once __DIR__ . '/src/Reflection/ReflectionProvider/MemoizingReflectionProvider.php'; require_once __DIR__ . '/src/Reflection/ReflectionProvider/ReflectionProviderFactory.php'; require_once __DIR__ . '/src/Reflection/ReflectionProvider/ReflectionProviderProvider.php'; require_once __DIR__ . '/src/Reflection/ReflectionProvider/SetterReflectionProviderProvider.php'; require_once __DIR__ . '/src/Reflection/ReflectionProviderStaticAccessor.php'; require_once __DIR__ . '/src/Reflection/RequireExtension/RequireExtendsMethodsClassReflectionExtension.php'; require_once __DIR__ . '/src/Reflection/RequireExtension/RequireExtendsPropertiesClassReflectionExtension.php'; require_once __DIR__ . '/src/Reflection/ResolvedFunctionVariant.php'; require_once __DIR__ . '/src/Reflection/ResolvedFunctionVariantWithCallable.php'; require_once __DIR__ . '/src/Reflection/ResolvedFunctionVariantWithOriginal.php'; require_once __DIR__ . '/src/Reflection/ResolvedMethodReflection.php'; require_once __DIR__ . '/src/Reflection/ResolvedPropertyReflection.php'; require_once __DIR__ . '/src/Reflection/SignatureMap/FunctionSignature.php'; require_once __DIR__ . '/src/Reflection/SignatureMap/FunctionSignatureMapProvider.php'; require_once __DIR__ . '/src/Reflection/SignatureMap/NativeFunctionReflectionProvider.php'; require_once __DIR__ . '/src/Reflection/SignatureMap/ParameterSignature.php'; require_once __DIR__ . '/src/Reflection/SignatureMap/Php8SignatureMapProvider.php'; require_once __DIR__ . '/src/Reflection/SignatureMap/SignatureMapParser.php'; require_once __DIR__ . '/src/Reflection/SignatureMap/SignatureMapProvider.php'; require_once __DIR__ . '/src/Reflection/SignatureMap/SignatureMapProviderFactory.php'; require_once __DIR__ . '/src/Reflection/TrivialParametersAcceptor.php'; require_once __DIR__ . '/src/Reflection/Type/CallbackUnresolvedMethodPrototypeReflection.php'; require_once __DIR__ . '/src/Reflection/Type/CallbackUnresolvedPropertyPrototypeReflection.php'; require_once __DIR__ . '/src/Reflection/Type/CalledOnTypeUnresolvedMethodPrototypeReflection.php'; require_once __DIR__ . '/src/Reflection/Type/CalledOnTypeUnresolvedPropertyPrototypeReflection.php'; require_once __DIR__ . '/src/Reflection/Type/IntersectionTypeMethodReflection.php'; require_once __DIR__ . '/src/Reflection/Type/IntersectionTypePropertyReflection.php'; require_once __DIR__ . '/src/Reflection/Type/IntersectionTypeUnresolvedMethodPrototypeReflection.php'; require_once __DIR__ . '/src/Reflection/Type/IntersectionTypeUnresolvedPropertyPrototypeReflection.php'; require_once __DIR__ . '/src/Reflection/Type/UnionTypeMethodReflection.php'; require_once __DIR__ . '/src/Reflection/Type/UnionTypePropertyReflection.php'; require_once __DIR__ . '/src/Reflection/Type/UnionTypeUnresolvedMethodPrototypeReflection.php'; require_once __DIR__ . '/src/Reflection/Type/UnionTypeUnresolvedPropertyPrototypeReflection.php'; require_once __DIR__ . '/src/Reflection/Type/UnresolvedMethodPrototypeReflection.php'; require_once __DIR__ . '/src/Reflection/Type/UnresolvedPropertyPrototypeReflection.php'; require_once __DIR__ . '/src/Reflection/WrappedExtendedMethodReflection.php'; require_once __DIR__ . '/src/Reflection/WrappedExtendedPropertyReflection.php'; require_once __DIR__ . '/src/Reflection/WrapperPropertyReflection.php'; require_once __DIR__ . '/src/Rules/Api/ApiClassConstFetchRule.php'; require_once __DIR__ . '/src/Rules/Api/ApiClassExtendsRule.php'; require_once __DIR__ . '/src/Rules/Api/ApiClassImplementsRule.php'; require_once __DIR__ . '/src/Rules/Api/ApiInstanceofRule.php'; require_once __DIR__ . '/src/Rules/Api/ApiInstanceofTypeRule.php'; require_once __DIR__ . '/src/Rules/Api/ApiInstantiationRule.php'; require_once __DIR__ . '/src/Rules/Api/ApiInterfaceExtendsRule.php'; require_once __DIR__ . '/src/Rules/Api/ApiMethodCallRule.php'; require_once __DIR__ . '/src/Rules/Api/ApiRuleHelper.php'; require_once __DIR__ . '/src/Rules/Api/ApiStaticCallRule.php'; require_once __DIR__ . '/src/Rules/Api/ApiTraitUseRule.php'; require_once __DIR__ . '/src/Rules/Api/BcUncoveredInterface.php'; require_once __DIR__ . '/src/Rules/Api/GetTemplateTypeRule.php'; require_once __DIR__ . '/src/Rules/Api/NodeConnectingVisitorAttributesRule.php'; require_once __DIR__ . '/src/Rules/Api/PhpStanNamespaceIn3rdPartyPackageRule.php'; require_once __DIR__ . '/src/Rules/Api/RuntimeReflectionFunctionRule.php'; require_once __DIR__ . '/src/Rules/Api/RuntimeReflectionInstantiationRule.php'; require_once __DIR__ . '/src/Rules/Arrays/AllowedArrayKeysTypes.php'; require_once __DIR__ . '/src/Rules/Arrays/AppendedArrayItemTypeRule.php'; require_once __DIR__ . '/src/Rules/Arrays/AppendedArrayKeyTypeRule.php'; require_once __DIR__ . '/src/Rules/Arrays/ArrayDestructuringRule.php'; require_once __DIR__ . '/src/Rules/Arrays/ArrayUnpackingRule.php'; require_once __DIR__ . '/src/Rules/Arrays/DeadForeachRule.php'; require_once __DIR__ . '/src/Rules/Arrays/DuplicateKeysInLiteralArraysRule.php'; require_once __DIR__ . '/src/Rules/Arrays/EmptyArrayItemRule.php'; require_once __DIR__ . '/src/Rules/Arrays/InvalidKeyInArrayDimFetchRule.php'; require_once __DIR__ . '/src/Rules/Arrays/InvalidKeyInArrayItemRule.php'; require_once __DIR__ . '/src/Rules/Arrays/IterableInForeachRule.php'; require_once __DIR__ . '/src/Rules/Arrays/NonexistentOffsetInArrayDimFetchCheck.php'; require_once __DIR__ . '/src/Rules/Arrays/NonexistentOffsetInArrayDimFetchRule.php'; require_once __DIR__ . '/src/Rules/Arrays/OffsetAccessAssignOpRule.php'; require_once __DIR__ . '/src/Rules/Arrays/OffsetAccessAssignmentRule.php'; require_once __DIR__ . '/src/Rules/Arrays/OffsetAccessValueAssignmentRule.php'; require_once __DIR__ . '/src/Rules/Arrays/OffsetAccessWithoutDimForReadingRule.php'; require_once __DIR__ . '/src/Rules/Arrays/UnpackIterableInArrayRule.php'; require_once __DIR__ . '/src/Rules/AttributesCheck.php'; require_once __DIR__ . '/src/Rules/Cast/EchoRule.php'; require_once __DIR__ . '/src/Rules/Cast/InvalidCastRule.php'; require_once __DIR__ . '/src/Rules/Cast/InvalidPartOfEncapsedStringRule.php'; require_once __DIR__ . '/src/Rules/Cast/PrintRule.php'; require_once __DIR__ . '/src/Rules/Cast/UnsetCastRule.php'; require_once __DIR__ . '/src/Rules/ClassCaseSensitivityCheck.php'; require_once __DIR__ . '/src/Rules/ClassForbiddenNameCheck.php'; require_once __DIR__ . '/src/Rules/ClassNameCheck.php'; require_once __DIR__ . '/src/Rules/ClassNameNodePair.php'; require_once __DIR__ . '/src/Rules/Classes/AccessPrivateConstantThroughStaticRule.php'; require_once __DIR__ . '/src/Rules/Classes/AllowedSubTypesRule.php'; require_once __DIR__ . '/src/Rules/Classes/ClassAttributesRule.php'; require_once __DIR__ . '/src/Rules/Classes/ClassConstantAttributesRule.php'; require_once __DIR__ . '/src/Rules/Classes/ClassConstantRule.php'; require_once __DIR__ . '/src/Rules/Classes/DuplicateClassDeclarationRule.php'; require_once __DIR__ . '/src/Rules/Classes/DuplicateDeclarationRule.php'; require_once __DIR__ . '/src/Rules/Classes/EnumSanityRule.php'; require_once __DIR__ . '/src/Rules/Classes/ExistingClassInClassExtendsRule.php'; require_once __DIR__ . '/src/Rules/Classes/ExistingClassInInstanceOfRule.php'; require_once __DIR__ . '/src/Rules/Classes/ExistingClassInTraitUseRule.php'; require_once __DIR__ . '/src/Rules/Classes/ExistingClassesInClassImplementsRule.php'; require_once __DIR__ . '/src/Rules/Classes/ExistingClassesInEnumImplementsRule.php'; require_once __DIR__ . '/src/Rules/Classes/ExistingClassesInInterfaceExtendsRule.php'; require_once __DIR__ . '/src/Rules/Classes/ImpossibleInstanceOfRule.php'; require_once __DIR__ . '/src/Rules/Classes/InstantiationCallableRule.php'; require_once __DIR__ . '/src/Rules/Classes/InstantiationRule.php'; require_once __DIR__ . '/src/Rules/Classes/InvalidPromotedPropertiesRule.php'; require_once __DIR__ . '/src/Rules/Classes/LocalTypeAliasesCheck.php'; require_once __DIR__ . '/src/Rules/Classes/LocalTypeAliasesRule.php'; require_once __DIR__ . '/src/Rules/Classes/LocalTypeTraitAliasesRule.php'; require_once __DIR__ . '/src/Rules/Classes/LocalTypeTraitUseAliasesRule.php'; require_once __DIR__ . '/src/Rules/Classes/MethodTagCheck.php'; require_once __DIR__ . '/src/Rules/Classes/MethodTagRule.php'; require_once __DIR__ . '/src/Rules/Classes/MethodTagTraitRule.php'; require_once __DIR__ . '/src/Rules/Classes/MethodTagTraitUseRule.php'; require_once __DIR__ . '/src/Rules/Classes/MixinCheck.php'; require_once __DIR__ . '/src/Rules/Classes/MixinRule.php'; require_once __DIR__ . '/src/Rules/Classes/MixinTraitRule.php'; require_once __DIR__ . '/src/Rules/Classes/MixinTraitUseRule.php'; require_once __DIR__ . '/src/Rules/Classes/NewStaticRule.php'; require_once __DIR__ . '/src/Rules/Classes/NonClassAttributeClassRule.php'; require_once __DIR__ . '/src/Rules/Classes/PropertyTagCheck.php'; require_once __DIR__ . '/src/Rules/Classes/PropertyTagRule.php'; require_once __DIR__ . '/src/Rules/Classes/PropertyTagTraitRule.php'; require_once __DIR__ . '/src/Rules/Classes/PropertyTagTraitUseRule.php'; require_once __DIR__ . '/src/Rules/Classes/ReadOnlyClassRule.php'; require_once __DIR__ . '/src/Rules/Classes/RequireExtendsRule.php'; require_once __DIR__ . '/src/Rules/Classes/RequireImplementsRule.php'; require_once __DIR__ . '/src/Rules/Classes/TraitAttributeClassRule.php'; require_once __DIR__ . '/src/Rules/Classes/UnusedConstructorParametersRule.php'; require_once __DIR__ . '/src/Rules/Comparison/BooleanAndConstantConditionRule.php'; require_once __DIR__ . '/src/Rules/Comparison/BooleanNotConstantConditionRule.php'; require_once __DIR__ . '/src/Rules/Comparison/BooleanOrConstantConditionRule.php'; require_once __DIR__ . '/src/Rules/Comparison/ConstantConditionRuleHelper.php'; require_once __DIR__ . '/src/Rules/Comparison/ConstantLooseComparisonRule.php'; require_once __DIR__ . '/src/Rules/Comparison/DoWhileLoopConstantConditionRule.php'; require_once __DIR__ . '/src/Rules/Comparison/ElseIfConstantConditionRule.php'; require_once __DIR__ . '/src/Rules/Comparison/IfConstantConditionRule.php'; require_once __DIR__ . '/src/Rules/Comparison/ImpossibleCheckTypeFunctionCallRule.php'; require_once __DIR__ . '/src/Rules/Comparison/ImpossibleCheckTypeHelper.php'; require_once __DIR__ . '/src/Rules/Comparison/ImpossibleCheckTypeMethodCallRule.php'; require_once __DIR__ . '/src/Rules/Comparison/ImpossibleCheckTypeStaticMethodCallRule.php'; require_once __DIR__ . '/src/Rules/Comparison/LogicalXorConstantConditionRule.php'; require_once __DIR__ . '/src/Rules/Comparison/MatchExpressionRule.php'; require_once __DIR__ . '/src/Rules/Comparison/NumberComparisonOperatorsConstantConditionRule.php'; require_once __DIR__ . '/src/Rules/Comparison/StrictComparisonOfDifferentTypesRule.php'; require_once __DIR__ . '/src/Rules/Comparison/TernaryOperatorConstantConditionRule.php'; require_once __DIR__ . '/src/Rules/Comparison/UnreachableIfBranchesRule.php'; require_once __DIR__ . '/src/Rules/Comparison/UnreachableTernaryElseBranchRule.php'; require_once __DIR__ . '/src/Rules/Comparison/UsageOfVoidMatchExpressionRule.php'; require_once __DIR__ . '/src/Rules/Comparison/WhileLoopAlwaysFalseConditionRule.php'; require_once __DIR__ . '/src/Rules/Comparison/WhileLoopAlwaysTrueConditionRule.php'; require_once __DIR__ . '/src/Rules/Constants/AlwaysUsedClassConstantsExtension.php'; require_once __DIR__ . '/src/Rules/Constants/AlwaysUsedClassConstantsExtensionProvider.php'; require_once __DIR__ . '/src/Rules/Constants/ClassAsClassConstantRule.php'; require_once __DIR__ . '/src/Rules/Constants/ConstantRule.php'; require_once __DIR__ . '/src/Rules/Constants/DynamicClassConstantFetchRule.php'; require_once __DIR__ . '/src/Rules/Constants/FinalConstantRule.php'; require_once __DIR__ . '/src/Rules/Constants/LazyAlwaysUsedClassConstantsExtensionProvider.php'; require_once __DIR__ . '/src/Rules/Constants/MagicConstantContextRule.php'; require_once __DIR__ . '/src/Rules/Constants/MissingClassConstantTypehintRule.php'; require_once __DIR__ . '/src/Rules/Constants/NativeTypedClassConstantRule.php'; require_once __DIR__ . '/src/Rules/Constants/OverridingConstantRule.php'; require_once __DIR__ . '/src/Rules/Constants/ValueAssignedToClassConstantRule.php'; require_once __DIR__ . '/src/Rules/DateTimeInstantiationRule.php'; require_once __DIR__ . '/src/Rules/DeadCode/BetterNoopRule.php'; require_once __DIR__ . '/src/Rules/DeadCode/CallToConstructorStatementWithoutImpurePointsRule.php'; require_once __DIR__ . '/src/Rules/DeadCode/CallToFunctionStatementWithoutImpurePointsRule.php'; require_once __DIR__ . '/src/Rules/DeadCode/CallToMethodStatementWithoutImpurePointsRule.php'; require_once __DIR__ . '/src/Rules/DeadCode/CallToStaticMethodStatementWithoutImpurePointsRule.php'; require_once __DIR__ . '/src/Rules/DeadCode/ConstructorWithoutImpurePointsCollector.php'; require_once __DIR__ . '/src/Rules/DeadCode/FunctionWithoutImpurePointsCollector.php'; require_once __DIR__ . '/src/Rules/DeadCode/MethodWithoutImpurePointsCollector.php'; require_once __DIR__ . '/src/Rules/DeadCode/NoopRule.php'; require_once __DIR__ . '/src/Rules/DeadCode/PossiblyPureFuncCallCollector.php'; require_once __DIR__ . '/src/Rules/DeadCode/PossiblyPureMethodCallCollector.php'; require_once __DIR__ . '/src/Rules/DeadCode/PossiblyPureNewCollector.php'; require_once __DIR__ . '/src/Rules/DeadCode/PossiblyPureStaticCallCollector.php'; require_once __DIR__ . '/src/Rules/DeadCode/UnreachableStatementRule.php'; require_once __DIR__ . '/src/Rules/DeadCode/UnusedPrivateConstantRule.php'; require_once __DIR__ . '/src/Rules/DeadCode/UnusedPrivateMethodRule.php'; require_once __DIR__ . '/src/Rules/DeadCode/UnusedPrivatePropertyRule.php'; require_once __DIR__ . '/src/Rules/Debug/DebugScopeRule.php'; require_once __DIR__ . '/src/Rules/Debug/DumpPhpDocTypeRule.php'; require_once __DIR__ . '/src/Rules/Debug/DumpTypeRule.php'; require_once __DIR__ . '/src/Rules/Debug/FileAssertRule.php'; require_once __DIR__ . '/src/Rules/DirectRegistry.php'; require_once __DIR__ . '/src/Rules/EnumCases/EnumCaseAttributesRule.php'; require_once __DIR__ . '/src/Rules/Exceptions/CatchWithUnthrownExceptionRule.php'; require_once __DIR__ . '/src/Rules/Exceptions/CaughtExceptionExistenceRule.php'; require_once __DIR__ . '/src/Rules/Exceptions/DefaultExceptionTypeResolver.php'; require_once __DIR__ . '/src/Rules/Exceptions/ExceptionTypeResolver.php'; require_once __DIR__ . '/src/Rules/Exceptions/MissingCheckedExceptionInFunctionThrowsRule.php'; require_once __DIR__ . '/src/Rules/Exceptions/MissingCheckedExceptionInMethodThrowsRule.php'; require_once __DIR__ . '/src/Rules/Exceptions/MissingCheckedExceptionInThrowsCheck.php'; require_once __DIR__ . '/src/Rules/Exceptions/NoncapturingCatchRule.php'; require_once __DIR__ . '/src/Rules/Exceptions/OverwrittenExitPointByFinallyRule.php'; require_once __DIR__ . '/src/Rules/Exceptions/ThrowExprTypeRule.php'; require_once __DIR__ . '/src/Rules/Exceptions/ThrowExpressionRule.php'; require_once __DIR__ . '/src/Rules/Exceptions/ThrowsVoidFunctionWithExplicitThrowPointRule.php'; require_once __DIR__ . '/src/Rules/Exceptions/ThrowsVoidMethodWithExplicitThrowPointRule.php'; require_once __DIR__ . '/src/Rules/Exceptions/TooWideFunctionThrowTypeRule.php'; require_once __DIR__ . '/src/Rules/Exceptions/TooWideMethodThrowTypeRule.php'; require_once __DIR__ . '/src/Rules/Exceptions/TooWideThrowTypeCheck.php'; require_once __DIR__ . '/src/Rules/FileRuleError.php'; require_once __DIR__ . '/src/Rules/FoundTypeResult.php'; require_once __DIR__ . '/src/Rules/FunctionCallParametersCheck.php'; require_once __DIR__ . '/src/Rules/FunctionDefinitionCheck.php'; require_once __DIR__ . '/src/Rules/FunctionReturnTypeCheck.php'; require_once __DIR__ . '/src/Rules/Functions/ArrayFilterRule.php'; require_once __DIR__ . '/src/Rules/Functions/ArrayValuesRule.php'; require_once __DIR__ . '/src/Rules/Functions/ArrowFunctionAttributesRule.php'; require_once __DIR__ . '/src/Rules/Functions/ArrowFunctionReturnNullsafeByRefRule.php'; require_once __DIR__ . '/src/Rules/Functions/ArrowFunctionReturnTypeRule.php'; require_once __DIR__ . '/src/Rules/Functions/CallCallablesRule.php'; require_once __DIR__ . '/src/Rules/Functions/CallToFunctionParametersRule.php'; require_once __DIR__ . '/src/Rules/Functions/CallToFunctionStatementWithoutSideEffectsRule.php'; require_once __DIR__ . '/src/Rules/Functions/CallToNonExistentFunctionRule.php'; require_once __DIR__ . '/src/Rules/Functions/CallUserFuncRule.php'; require_once __DIR__ . '/src/Rules/Functions/ClosureAttributesRule.php'; require_once __DIR__ . '/src/Rules/Functions/ClosureReturnTypeRule.php'; require_once __DIR__ . '/src/Rules/Functions/DefineParametersRule.php'; require_once __DIR__ . '/src/Rules/Functions/DuplicateFunctionDeclarationRule.php'; require_once __DIR__ . '/src/Rules/Functions/ExistingClassesInArrowFunctionTypehintsRule.php'; require_once __DIR__ . '/src/Rules/Functions/ExistingClassesInClosureTypehintsRule.php'; require_once __DIR__ . '/src/Rules/Functions/ExistingClassesInTypehintsRule.php'; require_once __DIR__ . '/src/Rules/Functions/FunctionAttributesRule.php'; require_once __DIR__ . '/src/Rules/Functions/FunctionCallableRule.php'; require_once __DIR__ . '/src/Rules/Functions/ImplodeFunctionRule.php'; require_once __DIR__ . '/src/Rules/Functions/ImplodeParameterCastableToStringRule.php'; require_once __DIR__ . '/src/Rules/Functions/IncompatibleArrowFunctionDefaultParameterTypeRule.php'; require_once __DIR__ . '/src/Rules/Functions/IncompatibleClosureDefaultParameterTypeRule.php'; require_once __DIR__ . '/src/Rules/Functions/IncompatibleDefaultParameterTypeRule.php'; require_once __DIR__ . '/src/Rules/Functions/InnerFunctionRule.php'; require_once __DIR__ . '/src/Rules/Functions/InvalidLexicalVariablesInClosureUseRule.php'; require_once __DIR__ . '/src/Rules/Functions/MissingFunctionParameterTypehintRule.php'; require_once __DIR__ . '/src/Rules/Functions/MissingFunctionReturnTypehintRule.php'; require_once __DIR__ . '/src/Rules/Functions/ParamAttributesRule.php'; require_once __DIR__ . '/src/Rules/Functions/ParameterCastableToStringRule.php'; require_once __DIR__ . '/src/Rules/Functions/PrintfArrayParametersRule.php'; require_once __DIR__ . '/src/Rules/Functions/PrintfHelper.php'; require_once __DIR__ . '/src/Rules/Functions/PrintfParametersRule.php'; require_once __DIR__ . '/src/Rules/Functions/RandomIntParametersRule.php'; require_once __DIR__ . '/src/Rules/Functions/RedefinedParametersRule.php'; require_once __DIR__ . '/src/Rules/Functions/ReturnNullsafeByRefRule.php'; require_once __DIR__ . '/src/Rules/Functions/ReturnTypeRule.php'; require_once __DIR__ . '/src/Rules/Functions/SortParameterCastableToStringRule.php'; require_once __DIR__ . '/src/Rules/Functions/UnusedClosureUsesRule.php'; require_once __DIR__ . '/src/Rules/Functions/UselessFunctionReturnValueRule.php'; require_once __DIR__ . '/src/Rules/Functions/VariadicParametersDeclarationRule.php'; require_once __DIR__ . '/src/Rules/Generators/YieldFromTypeRule.php'; require_once __DIR__ . '/src/Rules/Generators/YieldInGeneratorRule.php'; require_once __DIR__ . '/src/Rules/Generators/YieldTypeRule.php'; require_once __DIR__ . '/src/Rules/Generics/ClassAncestorsRule.php'; require_once __DIR__ . '/src/Rules/Generics/ClassTemplateTypeRule.php'; require_once __DIR__ . '/src/Rules/Generics/CrossCheckInterfacesHelper.php'; require_once __DIR__ . '/src/Rules/Generics/EnumAncestorsRule.php'; require_once __DIR__ . '/src/Rules/Generics/EnumTemplateTypeRule.php'; require_once __DIR__ . '/src/Rules/Generics/FunctionSignatureVarianceRule.php'; require_once __DIR__ . '/src/Rules/Generics/FunctionTemplateTypeRule.php'; require_once __DIR__ . '/src/Rules/Generics/GenericAncestorsCheck.php'; require_once __DIR__ . '/src/Rules/Generics/GenericObjectTypeCheck.php'; require_once __DIR__ . '/src/Rules/Generics/InterfaceAncestorsRule.php'; require_once __DIR__ . '/src/Rules/Generics/InterfaceTemplateTypeRule.php'; require_once __DIR__ . '/src/Rules/Generics/MethodSignatureVarianceRule.php'; require_once __DIR__ . '/src/Rules/Generics/MethodTagTemplateTypeCheck.php'; require_once __DIR__ . '/src/Rules/Generics/MethodTagTemplateTypeRule.php'; require_once __DIR__ . '/src/Rules/Generics/MethodTagTemplateTypeTraitRule.php'; require_once __DIR__ . '/src/Rules/Generics/MethodTemplateTypeRule.php'; require_once __DIR__ . '/src/Rules/Generics/PropertyVarianceRule.php'; require_once __DIR__ . '/src/Rules/Generics/TemplateTypeCheck.php'; require_once __DIR__ . '/src/Rules/Generics/TraitTemplateTypeRule.php'; require_once __DIR__ . '/src/Rules/Generics/UsedTraitsRule.php'; require_once __DIR__ . '/src/Rules/Generics/VarianceCheck.php'; require_once __DIR__ . '/src/Rules/IdentifierRuleError.php'; require_once __DIR__ . '/src/Rules/Ignore/IgnoreParseErrorRule.php'; require_once __DIR__ . '/src/Rules/IssetCheck.php'; require_once __DIR__ . '/src/Rules/Keywords/ContinueBreakInLoopRule.php'; require_once __DIR__ . '/src/Rules/Keywords/DeclareStrictTypesRule.php'; require_once __DIR__ . '/src/Rules/Keywords/RequireFileExistsRule.php'; require_once __DIR__ . '/src/Rules/LazyRegistry.php'; require_once __DIR__ . '/src/Rules/LineRuleError.php'; require_once __DIR__ . '/src/Rules/MetadataRuleError.php'; require_once __DIR__ . '/src/Rules/Methods/AbstractMethodInNonAbstractClassRule.php'; require_once __DIR__ . '/src/Rules/Methods/AbstractPrivateMethodRule.php'; require_once __DIR__ . '/src/Rules/Methods/AlwaysUsedMethodExtension.php'; require_once __DIR__ . '/src/Rules/Methods/AlwaysUsedMethodExtensionProvider.php'; require_once __DIR__ . '/src/Rules/Methods/CallMethodsRule.php'; require_once __DIR__ . '/src/Rules/Methods/CallPrivateMethodThroughStaticRule.php'; require_once __DIR__ . '/src/Rules/Methods/CallStaticMethodsRule.php'; require_once __DIR__ . '/src/Rules/Methods/CallToConstructorStatementWithoutSideEffectsRule.php'; require_once __DIR__ . '/src/Rules/Methods/CallToMethodStatementWithoutSideEffectsRule.php'; require_once __DIR__ . '/src/Rules/Methods/CallToStaticMethodStatementWithoutSideEffectsRule.php'; require_once __DIR__ . '/src/Rules/Methods/ConsistentConstructorRule.php'; require_once __DIR__ . '/src/Rules/Methods/ConstructorReturnTypeRule.php'; require_once __DIR__ . '/src/Rules/Methods/DirectAlwaysUsedMethodExtensionProvider.php'; require_once __DIR__ . '/src/Rules/Methods/ExistingClassesInTypehintsRule.php'; require_once __DIR__ . '/src/Rules/Methods/FinalPrivateMethodRule.php'; require_once __DIR__ . '/src/Rules/Methods/IllegalConstructorMethodCallRule.php'; require_once __DIR__ . '/src/Rules/Methods/IllegalConstructorStaticCallRule.php'; require_once __DIR__ . '/src/Rules/Methods/IncompatibleDefaultParameterTypeRule.php'; require_once __DIR__ . '/src/Rules/Methods/LazyAlwaysUsedMethodExtensionProvider.php'; require_once __DIR__ . '/src/Rules/Methods/MethodAttributesRule.php'; require_once __DIR__ . '/src/Rules/Methods/MethodCallCheck.php'; require_once __DIR__ . '/src/Rules/Methods/MethodCallableRule.php'; require_once __DIR__ . '/src/Rules/Methods/MethodParameterComparisonHelper.php'; require_once __DIR__ . '/src/Rules/Methods/MethodSignatureRule.php'; require_once __DIR__ . '/src/Rules/Methods/MethodVisibilityInInterfaceRule.php'; require_once __DIR__ . '/src/Rules/Methods/MissingMagicSerializationMethodsRule.php'; require_once __DIR__ . '/src/Rules/Methods/MissingMethodImplementationRule.php'; require_once __DIR__ . '/src/Rules/Methods/MissingMethodParameterTypehintRule.php'; require_once __DIR__ . '/src/Rules/Methods/MissingMethodReturnTypehintRule.php'; require_once __DIR__ . '/src/Rules/Methods/MissingMethodSelfOutTypeRule.php'; require_once __DIR__ . '/src/Rules/Methods/NullsafeMethodCallRule.php'; require_once __DIR__ . '/src/Rules/Methods/OverridingMethodRule.php'; require_once __DIR__ . '/src/Rules/Methods/ReturnTypeRule.php'; require_once __DIR__ . '/src/Rules/Methods/StaticMethodCallCheck.php'; require_once __DIR__ . '/src/Rules/Methods/StaticMethodCallableRule.php'; require_once __DIR__ . '/src/Rules/Missing/MissingReturnRule.php'; require_once __DIR__ . '/src/Rules/MissingTypehintCheck.php'; require_once __DIR__ . '/src/Rules/Names/UsedNamesRule.php'; require_once __DIR__ . '/src/Rules/Namespaces/ExistingNamesInGroupUseRule.php'; require_once __DIR__ . '/src/Rules/Namespaces/ExistingNamesInUseRule.php'; require_once __DIR__ . '/src/Rules/NonIgnorableRuleError.php'; require_once __DIR__ . '/src/Rules/NullsafeCheck.php'; require_once __DIR__ . '/src/Rules/Operators/InvalidAssignVarRule.php'; require_once __DIR__ . '/src/Rules/Operators/InvalidBinaryOperationRule.php'; require_once __DIR__ . '/src/Rules/Operators/InvalidComparisonOperationRule.php'; require_once __DIR__ . '/src/Rules/Operators/InvalidIncDecOperationRule.php'; require_once __DIR__ . '/src/Rules/Operators/InvalidUnaryOperationRule.php'; require_once __DIR__ . '/src/Rules/ParameterCastableToStringCheck.php'; require_once __DIR__ . '/src/Rules/PhpDoc/AssertRuleHelper.php'; require_once __DIR__ . '/src/Rules/PhpDoc/ConditionalReturnTypeRuleHelper.php'; require_once __DIR__ . '/src/Rules/PhpDoc/FunctionAssertRule.php'; require_once __DIR__ . '/src/Rules/PhpDoc/FunctionConditionalReturnTypeRule.php'; require_once __DIR__ . '/src/Rules/PhpDoc/GenericCallableRuleHelper.php'; require_once __DIR__ . '/src/Rules/PhpDoc/IncompatibleClassConstantPhpDocTypeRule.php'; require_once __DIR__ . '/src/Rules/PhpDoc/IncompatibleParamImmediatelyInvokedCallableRule.php'; require_once __DIR__ . '/src/Rules/PhpDoc/IncompatiblePhpDocTypeRule.php'; require_once __DIR__ . '/src/Rules/PhpDoc/IncompatiblePropertyPhpDocTypeRule.php'; require_once __DIR__ . '/src/Rules/PhpDoc/IncompatibleSelfOutTypeRule.php'; require_once __DIR__ . '/src/Rules/PhpDoc/InvalidPHPStanDocTagRule.php'; require_once __DIR__ . '/src/Rules/PhpDoc/InvalidPhpDocTagValueRule.php'; require_once __DIR__ . '/src/Rules/PhpDoc/InvalidPhpDocVarTagTypeRule.php'; require_once __DIR__ . '/src/Rules/PhpDoc/InvalidThrowsPhpDocValueRule.php'; require_once __DIR__ . '/src/Rules/PhpDoc/MethodAssertRule.php'; require_once __DIR__ . '/src/Rules/PhpDoc/MethodConditionalReturnTypeRule.php'; require_once __DIR__ . '/src/Rules/PhpDoc/PhpDocLineHelper.php'; require_once __DIR__ . '/src/Rules/PhpDoc/RequireExtendsCheck.php'; require_once __DIR__ . '/src/Rules/PhpDoc/RequireExtendsDefinitionClassRule.php'; require_once __DIR__ . '/src/Rules/PhpDoc/RequireExtendsDefinitionTraitRule.php'; require_once __DIR__ . '/src/Rules/PhpDoc/RequireImplementsDefinitionClassRule.php'; require_once __DIR__ . '/src/Rules/PhpDoc/RequireImplementsDefinitionTraitRule.php'; require_once __DIR__ . '/src/Rules/PhpDoc/UnresolvableTypeHelper.php'; require_once __DIR__ . '/src/Rules/PhpDoc/VarTagChangedExpressionTypeRule.php'; require_once __DIR__ . '/src/Rules/PhpDoc/VarTagTypeRuleHelper.php'; require_once __DIR__ . '/src/Rules/PhpDoc/WrongVariableNameInVarTagRule.php'; require_once __DIR__ . '/src/Rules/Playground/FunctionNeverRule.php'; require_once __DIR__ . '/src/Rules/Playground/MethodNeverRule.php'; require_once __DIR__ . '/src/Rules/Playground/NeverRuleHelper.php'; require_once __DIR__ . '/src/Rules/Playground/NoPhpCodeRule.php'; require_once __DIR__ . '/src/Rules/Playground/NotAnalysedTraitRule.php'; require_once __DIR__ . '/src/Rules/Properties/AccessPrivatePropertyThroughStaticRule.php'; require_once __DIR__ . '/src/Rules/Properties/AccessPropertiesInAssignRule.php'; require_once __DIR__ . '/src/Rules/Properties/AccessPropertiesRule.php'; require_once __DIR__ . '/src/Rules/Properties/AccessStaticPropertiesInAssignRule.php'; require_once __DIR__ . '/src/Rules/Properties/AccessStaticPropertiesRule.php'; require_once __DIR__ . '/src/Rules/Properties/DefaultValueTypesAssignedToPropertiesRule.php'; require_once __DIR__ . '/src/Rules/Properties/DirectReadWritePropertiesExtensionProvider.php'; require_once __DIR__ . '/src/Rules/Properties/ExistingClassesInPropertiesRule.php'; require_once __DIR__ . '/src/Rules/Properties/FoundPropertyReflection.php'; require_once __DIR__ . '/src/Rules/Properties/InvalidCallablePropertyTypeRule.php'; require_once __DIR__ . '/src/Rules/Properties/LazyReadWritePropertiesExtensionProvider.php'; require_once __DIR__ . '/src/Rules/Properties/MissingPropertyTypehintRule.php'; require_once __DIR__ . '/src/Rules/Properties/MissingReadOnlyByPhpDocPropertyAssignRule.php'; require_once __DIR__ . '/src/Rules/Properties/MissingReadOnlyPropertyAssignRule.php'; require_once __DIR__ . '/src/Rules/Properties/NullsafePropertyFetchRule.php'; require_once __DIR__ . '/src/Rules/Properties/OverridingPropertyRule.php'; require_once __DIR__ . '/src/Rules/Properties/PropertiesInInterfaceRule.php'; require_once __DIR__ . '/src/Rules/Properties/PropertyAttributesRule.php'; require_once __DIR__ . '/src/Rules/Properties/PropertyDescriptor.php'; require_once __DIR__ . '/src/Rules/Properties/PropertyReflectionFinder.php'; require_once __DIR__ . '/src/Rules/Properties/ReadOnlyByPhpDocPropertyAssignRefRule.php'; require_once __DIR__ . '/src/Rules/Properties/ReadOnlyByPhpDocPropertyAssignRule.php'; require_once __DIR__ . '/src/Rules/Properties/ReadOnlyByPhpDocPropertyRule.php'; require_once __DIR__ . '/src/Rules/Properties/ReadOnlyPropertyAssignRefRule.php'; require_once __DIR__ . '/src/Rules/Properties/ReadOnlyPropertyAssignRule.php'; require_once __DIR__ . '/src/Rules/Properties/ReadOnlyPropertyRule.php'; require_once __DIR__ . '/src/Rules/Properties/ReadWritePropertiesExtension.php'; require_once __DIR__ . '/src/Rules/Properties/ReadWritePropertiesExtensionProvider.php'; require_once __DIR__ . '/src/Rules/Properties/ReadingWriteOnlyPropertiesRule.php'; require_once __DIR__ . '/src/Rules/Properties/TypesAssignedToPropertiesRule.php'; require_once __DIR__ . '/src/Rules/Properties/UninitializedPropertyRule.php'; require_once __DIR__ . '/src/Rules/Properties/WritingToReadOnlyPropertiesRule.php'; require_once __DIR__ . '/src/Rules/Pure/FunctionPurityCheck.php'; require_once __DIR__ . '/src/Rules/Pure/PureFunctionRule.php'; require_once __DIR__ . '/src/Rules/Pure/PureMethodRule.php'; require_once __DIR__ . '/src/Rules/Regexp/RegularExpressionPatternRule.php'; require_once __DIR__ . '/src/Rules/Regexp/RegularExpressionQuotingRule.php'; require_once __DIR__ . '/src/Rules/Registry.php'; require_once __DIR__ . '/src/Rules/Rule.php'; require_once __DIR__ . '/src/Rules/RuleError.php'; require_once __DIR__ . '/src/Rules/RuleErrorBuilder.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError1.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError101.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError103.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError105.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError107.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError109.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError11.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError111.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError113.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError115.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError117.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError119.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError121.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError123.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError125.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError127.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError13.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError15.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError17.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError19.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError21.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError23.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError25.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError27.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError29.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError3.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError31.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError33.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError35.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError37.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError39.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError41.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError43.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError45.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError47.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError49.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError5.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError51.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError53.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError55.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError57.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError59.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError61.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError63.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError65.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError67.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError69.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError7.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError71.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError73.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError75.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError77.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError79.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError81.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError83.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError85.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError87.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError89.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError9.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError91.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError93.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError95.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError97.php'; require_once __DIR__ . '/src/Rules/RuleErrors/RuleError99.php'; require_once __DIR__ . '/src/Rules/RuleLevelHelper.php'; require_once __DIR__ . '/src/Rules/RuleLevelHelperAcceptsResult.php'; require_once __DIR__ . '/src/Rules/TipRuleError.php'; require_once __DIR__ . '/src/Rules/TooWideTypehints/TooWideArrowFunctionReturnTypehintRule.php'; require_once __DIR__ . '/src/Rules/TooWideTypehints/TooWideClosureReturnTypehintRule.php'; require_once __DIR__ . '/src/Rules/TooWideTypehints/TooWideFunctionParameterOutTypeRule.php'; require_once __DIR__ . '/src/Rules/TooWideTypehints/TooWideFunctionReturnTypehintRule.php'; require_once __DIR__ . '/src/Rules/TooWideTypehints/TooWideMethodParameterOutTypeRule.php'; require_once __DIR__ . '/src/Rules/TooWideTypehints/TooWideMethodReturnTypehintRule.php'; require_once __DIR__ . '/src/Rules/TooWideTypehints/TooWideParameterOutTypeCheck.php'; require_once __DIR__ . '/src/Rules/TooWideTypehints/TooWidePropertyTypeRule.php'; require_once __DIR__ . '/src/Rules/Traits/ConflictingTraitConstantsRule.php'; require_once __DIR__ . '/src/Rules/Traits/ConstantsInTraitsRule.php'; require_once __DIR__ . '/src/Rules/Traits/NotAnalysedTraitRule.php'; require_once __DIR__ . '/src/Rules/Traits/TraitDeclarationCollector.php'; require_once __DIR__ . '/src/Rules/Traits/TraitUseCollector.php'; require_once __DIR__ . '/src/Rules/Types/InvalidTypesInUnionRule.php'; require_once __DIR__ . '/src/Rules/UnusedFunctionParametersCheck.php'; require_once __DIR__ . '/src/Rules/Variables/CompactVariablesRule.php'; require_once __DIR__ . '/src/Rules/Variables/DefinedVariableRule.php'; require_once __DIR__ . '/src/Rules/Variables/EmptyRule.php'; require_once __DIR__ . '/src/Rules/Variables/IssetRule.php'; require_once __DIR__ . '/src/Rules/Variables/NullCoalesceRule.php'; require_once __DIR__ . '/src/Rules/Variables/ParameterOutAssignedTypeRule.php'; require_once __DIR__ . '/src/Rules/Variables/ParameterOutExecutionEndTypeRule.php'; require_once __DIR__ . '/src/Rules/Variables/ThrowTypeRule.php'; require_once __DIR__ . '/src/Rules/Variables/UnsetRule.php'; require_once __DIR__ . '/src/Rules/Variables/VariableCloningRule.php'; require_once __DIR__ . '/src/Rules/Whitespace/FileWhitespaceRule.php'; require_once __DIR__ . '/src/ShouldNotHappenException.php'; require_once __DIR__ . '/src/TrinaryLogic.php'; require_once __DIR__ . '/src/Type/AcceptsResult.php'; require_once __DIR__ . '/src/Type/Accessory/AccessoryArrayListType.php'; require_once __DIR__ . '/src/Type/Accessory/AccessoryLiteralStringType.php'; require_once __DIR__ . '/src/Type/Accessory/AccessoryLowercaseStringType.php'; require_once __DIR__ . '/src/Type/Accessory/AccessoryNonEmptyStringType.php'; require_once __DIR__ . '/src/Type/Accessory/AccessoryNonFalsyStringType.php'; require_once __DIR__ . '/src/Type/Accessory/AccessoryNumericStringType.php'; require_once __DIR__ . '/src/Type/Accessory/AccessoryType.php'; require_once __DIR__ . '/src/Type/Accessory/AccessoryUppercaseStringType.php'; require_once __DIR__ . '/src/Type/Accessory/HasMethodType.php'; require_once __DIR__ . '/src/Type/Accessory/HasOffsetType.php'; require_once __DIR__ . '/src/Type/Accessory/HasOffsetValueType.php'; require_once __DIR__ . '/src/Type/Accessory/HasPropertyType.php'; require_once __DIR__ . '/src/Type/Accessory/NonEmptyArrayType.php'; require_once __DIR__ . '/src/Type/Accessory/OversizedArrayType.php'; require_once __DIR__ . '/src/Type/ArrayType.php'; require_once __DIR__ . '/src/Type/BenevolentUnionType.php'; require_once __DIR__ . '/src/Type/BitwiseFlagHelper.php'; require_once __DIR__ . '/src/Type/BooleanType.php'; require_once __DIR__ . '/src/Type/CallableType.php'; require_once __DIR__ . '/src/Type/CallableTypeHelper.php'; require_once __DIR__ . '/src/Type/CircularTypeAliasDefinitionException.php'; require_once __DIR__ . '/src/Type/CircularTypeAliasErrorType.php'; require_once __DIR__ . '/src/Type/ClassStringType.php'; require_once __DIR__ . '/src/Type/ClosureType.php'; require_once __DIR__ . '/src/Type/ClosureTypeFactory.php'; require_once __DIR__ . '/src/Type/CompoundType.php'; require_once __DIR__ . '/src/Type/ConditionalType.php'; require_once __DIR__ . '/src/Type/ConditionalTypeForParameter.php'; require_once __DIR__ . '/src/Type/Constant/ConstantArrayType.php'; require_once __DIR__ . '/src/Type/Constant/ConstantArrayTypeAndMethod.php'; require_once __DIR__ . '/src/Type/Constant/ConstantArrayTypeBuilder.php'; require_once __DIR__ . '/src/Type/Constant/ConstantBooleanType.php'; require_once __DIR__ . '/src/Type/Constant/ConstantFloatType.php'; require_once __DIR__ . '/src/Type/Constant/ConstantIntegerType.php'; require_once __DIR__ . '/src/Type/Constant/ConstantScalarToBooleanTrait.php'; require_once __DIR__ . '/src/Type/Constant/ConstantStringType.php'; require_once __DIR__ . '/src/Type/Constant/OversizedArrayBuilder.php'; require_once __DIR__ . '/src/Type/ConstantScalarType.php'; require_once __DIR__ . '/src/Type/ConstantType.php'; require_once __DIR__ . '/src/Type/ConstantTypeHelper.php'; require_once __DIR__ . '/src/Type/DirectTypeAliasResolverProvider.php'; require_once __DIR__ . '/src/Type/DynamicFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/DynamicFunctionThrowTypeExtension.php'; require_once __DIR__ . '/src/Type/DynamicMethodReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/DynamicMethodThrowTypeExtension.php'; require_once __DIR__ . '/src/Type/DynamicReturnTypeExtensionRegistry.php'; require_once __DIR__ . '/src/Type/DynamicStaticMethodReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/DynamicStaticMethodThrowTypeExtension.php'; require_once __DIR__ . '/src/Type/Enum/EnumCaseObjectType.php'; require_once __DIR__ . '/src/Type/ErrorType.php'; require_once __DIR__ . '/src/Type/ExponentiateHelper.php'; require_once __DIR__ . '/src/Type/ExpressionTypeResolverExtension.php'; require_once __DIR__ . '/src/Type/ExpressionTypeResolverExtensionRegistry.php'; require_once __DIR__ . '/src/Type/FileTypeMapper.php'; require_once __DIR__ . '/src/Type/FloatType.php'; require_once __DIR__ . '/src/Type/FunctionParameterClosureTypeExtension.php'; require_once __DIR__ . '/src/Type/FunctionParameterOutTypeExtension.php'; require_once __DIR__ . '/src/Type/FunctionTypeSpecifyingExtension.php'; require_once __DIR__ . '/src/Type/GeneralizePrecision.php'; require_once __DIR__ . '/src/Type/Generic/GenericClassStringType.php'; require_once __DIR__ . '/src/Type/Generic/GenericObjectType.php'; require_once __DIR__ . '/src/Type/Generic/GenericStaticType.php'; require_once __DIR__ . '/src/Type/Generic/TemplateArrayType.php'; require_once __DIR__ . '/src/Type/Generic/TemplateBenevolentUnionType.php'; require_once __DIR__ . '/src/Type/Generic/TemplateBooleanType.php'; require_once __DIR__ . '/src/Type/Generic/TemplateConstantArrayType.php'; require_once __DIR__ . '/src/Type/Generic/TemplateConstantIntegerType.php'; require_once __DIR__ . '/src/Type/Generic/TemplateConstantStringType.php'; require_once __DIR__ . '/src/Type/Generic/TemplateFloatType.php'; require_once __DIR__ . '/src/Type/Generic/TemplateGenericObjectType.php'; require_once __DIR__ . '/src/Type/Generic/TemplateIntegerType.php'; require_once __DIR__ . '/src/Type/Generic/TemplateIntersectionType.php'; require_once __DIR__ . '/src/Type/Generic/TemplateKeyOfType.php'; require_once __DIR__ . '/src/Type/Generic/TemplateMixedType.php'; require_once __DIR__ . '/src/Type/Generic/TemplateObjectShapeType.php'; require_once __DIR__ . '/src/Type/Generic/TemplateObjectType.php'; require_once __DIR__ . '/src/Type/Generic/TemplateObjectWithoutClassType.php'; require_once __DIR__ . '/src/Type/Generic/TemplateStrictMixedType.php'; require_once __DIR__ . '/src/Type/Generic/TemplateStringType.php'; require_once __DIR__ . '/src/Type/Generic/TemplateType.php'; require_once __DIR__ . '/src/Type/Generic/TemplateTypeArgumentStrategy.php'; require_once __DIR__ . '/src/Type/Generic/TemplateTypeFactory.php'; require_once __DIR__ . '/src/Type/Generic/TemplateTypeHelper.php'; require_once __DIR__ . '/src/Type/Generic/TemplateTypeMap.php'; require_once __DIR__ . '/src/Type/Generic/TemplateTypeParameterStrategy.php'; require_once __DIR__ . '/src/Type/Generic/TemplateTypeReference.php'; require_once __DIR__ . '/src/Type/Generic/TemplateTypeScope.php'; require_once __DIR__ . '/src/Type/Generic/TemplateTypeStrategy.php'; require_once __DIR__ . '/src/Type/Generic/TemplateTypeTrait.php'; require_once __DIR__ . '/src/Type/Generic/TemplateTypeVariance.php'; require_once __DIR__ . '/src/Type/Generic/TemplateTypeVarianceMap.php'; require_once __DIR__ . '/src/Type/Generic/TemplateUnionType.php'; require_once __DIR__ . '/src/Type/Generic/TypeProjectionHelper.php'; require_once __DIR__ . '/src/Type/GenericTypeVariableResolver.php'; require_once __DIR__ . '/src/Type/Helper/GetTemplateTypeType.php'; require_once __DIR__ . '/src/Type/IntegerRangeType.php'; require_once __DIR__ . '/src/Type/IntegerType.php'; require_once __DIR__ . '/src/Type/IntersectionType.php'; require_once __DIR__ . '/src/Type/IsSuperTypeOfResult.php'; require_once __DIR__ . '/src/Type/IterableType.php'; require_once __DIR__ . '/src/Type/JustNullableTypeTrait.php'; require_once __DIR__ . '/src/Type/KeyOfType.php'; require_once __DIR__ . '/src/Type/LateResolvableType.php'; require_once __DIR__ . '/src/Type/LazyTypeAliasResolverProvider.php'; require_once __DIR__ . '/src/Type/LooseComparisonHelper.php'; require_once __DIR__ . '/src/Type/MethodParameterClosureTypeExtension.php'; require_once __DIR__ . '/src/Type/MethodParameterOutTypeExtension.php'; require_once __DIR__ . '/src/Type/MethodTypeSpecifyingExtension.php'; require_once __DIR__ . '/src/Type/MixedType.php'; require_once __DIR__ . '/src/Type/NeverType.php'; require_once __DIR__ . '/src/Type/NewObjectType.php'; require_once __DIR__ . '/src/Type/NonAcceptingNeverType.php'; require_once __DIR__ . '/src/Type/NonexistentParentClassType.php'; require_once __DIR__ . '/src/Type/NullType.php'; require_once __DIR__ . '/src/Type/ObjectShapePropertyReflection.php'; require_once __DIR__ . '/src/Type/ObjectShapeType.php'; require_once __DIR__ . '/src/Type/ObjectType.php'; require_once __DIR__ . '/src/Type/ObjectWithoutClassType.php'; require_once __DIR__ . '/src/Type/OffsetAccessType.php'; require_once __DIR__ . '/src/Type/OperatorTypeSpecifyingExtension.php'; require_once __DIR__ . '/src/Type/OperatorTypeSpecifyingExtensionRegistry.php'; require_once __DIR__ . '/src/Type/ParserNodeTypeToPHPStanType.php'; require_once __DIR__ . '/src/Type/Php/AbsFunctionDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ArgumentBasedFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ArrayChangeKeyCaseFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ArrayChunkFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ArrayColumnFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ArrayCombineFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ArrayCurrentDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ArrayFillFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ArrayFillKeysFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ArrayFilterFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ArrayFilterFunctionReturnTypeHelper.php'; require_once __DIR__ . '/src/Type/Php/ArrayFindFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ArrayFindKeyFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ArrayFlipFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ArrayIntersectKeyFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ArrayKeyDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ArrayKeyExistsFunctionTypeSpecifyingExtension.php'; require_once __DIR__ . '/src/Type/Php/ArrayKeyFirstDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ArrayKeyLastDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ArrayKeysFunctionDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ArrayMapFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ArrayMergeFunctionDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ArrayNextDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ArrayPointerFunctionsDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ArrayPopFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ArrayRandFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ArrayReduceFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ArrayReplaceFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ArrayReverseFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ArraySearchFunctionDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ArraySearchFunctionTypeSpecifyingExtension.php'; require_once __DIR__ . '/src/Type/Php/ArrayShiftFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ArraySliceFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ArraySpliceFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ArraySumFunctionDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ArrayValuesFunctionDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/AssertFunctionTypeSpecifyingExtension.php'; require_once __DIR__ . '/src/Type/Php/AssertThrowTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/BackedEnumFromMethodDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/Base64DecodeDynamicFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/BcMathStringOrNullReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ClassExistsFunctionTypeSpecifyingExtension.php'; require_once __DIR__ . '/src/Type/Php/ClassImplementsFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ClosureBindDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ClosureBindToDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ClosureFromCallableDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/CompactFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ConstantFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ConstantHelper.php'; require_once __DIR__ . '/src/Type/Php/CountFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/CountFunctionTypeSpecifyingExtension.php'; require_once __DIR__ . '/src/Type/Php/CtypeDigitFunctionTypeSpecifyingExtension.php'; require_once __DIR__ . '/src/Type/Php/CurlGetinfoFunctionDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/DateFormatFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/DateFormatMethodReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/DateFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/DateFunctionReturnTypeHelper.php'; require_once __DIR__ . '/src/Type/Php/DateIntervalConstructorThrowTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/DateIntervalDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/DatePeriodConstructorReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/DateTimeConstructorThrowTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/DateTimeCreateDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/DateTimeDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/DateTimeModifyMethodThrowTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/DateTimeModifyReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/DateTimeSubMethodThrowTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/DateTimeZoneConstructorThrowTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/DefineConstantTypeSpecifyingExtension.php'; require_once __DIR__ . '/src/Type/Php/DefinedConstantTypeSpecifyingExtension.php'; require_once __DIR__ . '/src/Type/Php/DioStatDynamicFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/DsMapDynamicMethodThrowTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/DsMapDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ExplodeFunctionDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/FilterFunctionReturnTypeHelper.php'; require_once __DIR__ . '/src/Type/Php/FilterInputDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/FilterVarArrayDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/FilterVarDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/FunctionExistsFunctionTypeSpecifyingExtension.php'; require_once __DIR__ . '/src/Type/Php/GetCalledClassDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/GetClassDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/GetDebugTypeFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/GetDefinedVarsFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/GetParentClassDynamicFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/GettimeofdayDynamicFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/GettypeFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/HashFunctionsReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/HighlightStringDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/HrtimeFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ImplodeFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/InArrayFunctionTypeSpecifyingExtension.php'; require_once __DIR__ . '/src/Type/Php/IniGetReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/IntdivThrowTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/IsAFunctionTypeSpecifyingExtension.php'; require_once __DIR__ . '/src/Type/Php/IsAFunctionTypeSpecifyingHelper.php'; require_once __DIR__ . '/src/Type/Php/IsArrayFunctionTypeSpecifyingExtension.php'; require_once __DIR__ . '/src/Type/Php/IsCallableFunctionTypeSpecifyingExtension.php'; require_once __DIR__ . '/src/Type/Php/IsIterableFunctionTypeSpecifyingExtension.php'; require_once __DIR__ . '/src/Type/Php/IsSubclassOfFunctionTypeSpecifyingExtension.php'; require_once __DIR__ . '/src/Type/Php/IteratorToArrayFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/JsonThrowOnErrorDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/JsonThrowTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/LtrimFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/MbConvertEncodingFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/MbFunctionsReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/MbFunctionsReturnTypeExtensionTrait.php'; require_once __DIR__ . '/src/Type/Php/MbStrlenFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/MbSubstituteCharacterDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/MethodExistsTypeSpecifyingExtension.php'; require_once __DIR__ . '/src/Type/Php/MicrotimeFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/MinMaxFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/NonEmptyStringFunctionsReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/NumberFormatFunctionDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/OpenSslEncryptParameterOutTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ParseStrParameterOutTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ParseUrlFunctionDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/PathinfoFunctionDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/PowFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/PregFilterFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/PregMatchParameterOutTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/PregMatchTypeSpecifyingExtension.php'; require_once __DIR__ . '/src/Type/Php/PregReplaceCallbackClosureTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/PregSplitDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/PropertyExistsTypeSpecifyingExtension.php'; require_once __DIR__ . '/src/Type/Php/RandomIntFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/RangeFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ReflectionClassConstructorThrowTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ReflectionClassIsSubclassOfTypeSpecifyingExtension.php'; require_once __DIR__ . '/src/Type/Php/ReflectionFunctionConstructorThrowTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ReflectionGetAttributesMethodReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ReflectionMethodConstructorThrowTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ReflectionPropertyConstructorThrowTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/RegexArrayShapeMatcher.php'; require_once __DIR__ . '/src/Type/Php/ReplaceFunctionsDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/RoundFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/SetTypeFunctionTypeSpecifyingExtension.php'; require_once __DIR__ . '/src/Type/Php/SimpleXMLElementAsXMLMethodReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/SimpleXMLElementClassPropertyReflectionExtension.php'; require_once __DIR__ . '/src/Type/Php/SimpleXMLElementConstructorThrowTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/SimpleXMLElementXpathMethodReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/SprintfFunctionDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/SscanfFunctionDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/StatDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/StrCaseFunctionsReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/StrContainingTypeSpecifyingExtension.php'; require_once __DIR__ . '/src/Type/Php/StrIncrementDecrementFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/StrPadFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/StrRepeatFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/StrSplitFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/StrTokFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/StrWordCountFunctionDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/StrlenFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/StrtotimeFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/StrvalFamilyFunctionReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/SubstrDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/ThrowableReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/TriggerErrorDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/TrimFunctionDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/TypeSpecifyingFunctionsDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/VersionCompareFunctionDynamicReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/Php/XMLReaderOpenReturnTypeExtension.php'; require_once __DIR__ . '/src/Type/RecursionGuard.php'; require_once __DIR__ . '/src/Type/Regex/RegexAlternation.php'; require_once __DIR__ . '/src/Type/Regex/RegexAstWalkResult.php'; require_once __DIR__ . '/src/Type/Regex/RegexCapturingGroup.php'; require_once __DIR__ . '/src/Type/Regex/RegexExpressionHelper.php'; require_once __DIR__ . '/src/Type/Regex/RegexGroupParser.php'; require_once __DIR__ . '/src/Type/Regex/RegexGroupWalkResult.php'; require_once __DIR__ . '/src/Type/Regex/RegexNonCapturingGroup.php'; require_once __DIR__ . '/src/Type/ResourceType.php'; require_once __DIR__ . '/src/Type/SimultaneousTypeTraverser.php'; require_once __DIR__ . '/src/Type/StaticMethodParameterClosureTypeExtension.php'; require_once __DIR__ . '/src/Type/StaticMethodParameterOutTypeExtension.php'; require_once __DIR__ . '/src/Type/StaticMethodTypeSpecifyingExtension.php'; require_once __DIR__ . '/src/Type/StaticType.php'; require_once __DIR__ . '/src/Type/StaticTypeFactory.php'; require_once __DIR__ . '/src/Type/StrictMixedType.php'; require_once __DIR__ . '/src/Type/StringAlwaysAcceptingObjectWithToStringType.php'; require_once __DIR__ . '/src/Type/StringType.php'; require_once __DIR__ . '/src/Type/SubtractableType.php'; require_once __DIR__ . '/src/Type/ThisType.php'; require_once __DIR__ . '/src/Type/Traits/ConstantNumericComparisonTypeTrait.php'; require_once __DIR__ . '/src/Type/Traits/ConstantScalarTypeTrait.php'; require_once __DIR__ . '/src/Type/Traits/FalseyBooleanTypeTrait.php'; require_once __DIR__ . '/src/Type/Traits/LateResolvableTypeTrait.php'; require_once __DIR__ . '/src/Type/Traits/MaybeArrayTypeTrait.php'; require_once __DIR__ . '/src/Type/Traits/MaybeCallableTypeTrait.php'; require_once __DIR__ . '/src/Type/Traits/MaybeIterableTypeTrait.php'; require_once __DIR__ . '/src/Type/Traits/MaybeObjectTypeTrait.php'; require_once __DIR__ . '/src/Type/Traits/MaybeOffsetAccessibleTypeTrait.php'; require_once __DIR__ . '/src/Type/Traits/NonArrayTypeTrait.php'; require_once __DIR__ . '/src/Type/Traits/NonCallableTypeTrait.php'; require_once __DIR__ . '/src/Type/Traits/NonGeneralizableTypeTrait.php'; require_once __DIR__ . '/src/Type/Traits/NonGenericTypeTrait.php'; require_once __DIR__ . '/src/Type/Traits/NonIterableTypeTrait.php'; require_once __DIR__ . '/src/Type/Traits/NonObjectTypeTrait.php'; require_once __DIR__ . '/src/Type/Traits/NonOffsetAccessibleTypeTrait.php'; require_once __DIR__ . '/src/Type/Traits/NonRemoveableTypeTrait.php'; require_once __DIR__ . '/src/Type/Traits/ObjectTypeTrait.php'; require_once __DIR__ . '/src/Type/Traits/TruthyBooleanTypeTrait.php'; require_once __DIR__ . '/src/Type/Traits/UndecidedBooleanTypeTrait.php'; require_once __DIR__ . '/src/Type/Traits/UndecidedComparisonCompoundTypeTrait.php'; require_once __DIR__ . '/src/Type/Traits/UndecidedComparisonTypeTrait.php'; require_once __DIR__ . '/src/Type/Type.php'; require_once __DIR__ . '/src/Type/TypeAlias.php'; require_once __DIR__ . '/src/Type/TypeAliasResolver.php'; require_once __DIR__ . '/src/Type/TypeAliasResolverProvider.php'; require_once __DIR__ . '/src/Type/TypeCombinator.php'; require_once __DIR__ . '/src/Type/TypeResult.php'; require_once __DIR__ . '/src/Type/TypeTraverser.php'; require_once __DIR__ . '/src/Type/TypeUtils.php'; require_once __DIR__ . '/src/Type/TypeWithClassName.php'; require_once __DIR__ . '/src/Type/TypehintHelper.php'; require_once __DIR__ . '/src/Type/UnionType.php'; require_once __DIR__ . '/src/Type/UnionTypeHelper.php'; require_once __DIR__ . '/src/Type/UsefulTypeAliasResolver.php'; require_once __DIR__ . '/src/Type/ValueOfType.php'; require_once __DIR__ . '/src/Type/VerbosityLevel.php'; require_once __DIR__ . '/src/Type/VoidType.php'; require_once __DIR__ . '/src/autoloadFunctions.php'; require_once __DIR__ . '/src/debugScope.php'; require_once __DIR__ . '/src/dumpType.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Builder.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Builder/ClassConst.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Builder/Class_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Builder/Declaration.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Builder/EnumCase.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Builder/Enum_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Builder/FunctionLike.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Builder/Function_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Builder/Interface_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Builder/Method.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Builder/Namespace_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Builder/Param.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Builder/Property.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Builder/TraitUse.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Builder/TraitUseAdaptation.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Builder/Trait_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Builder/Use_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/BuilderFactory.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/BuilderHelpers.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Comment.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Comment/Doc.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/ConstExprEvaluationException.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/ConstExprEvaluator.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Error.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/ErrorHandler.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/ErrorHandler/Collecting.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/ErrorHandler/Throwing.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Internal/DiffElem.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Internal/Differ.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Internal/PrintableNewAnonClassNode.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Internal/TokenStream.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/JsonDecoder.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Lexer.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Lexer/Emulative.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Lexer/TokenEmulator/AttributeEmulator.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Lexer/TokenEmulator/CoaleseEqualTokenEmulator.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Lexer/TokenEmulator/EnumTokenEmulator.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Lexer/TokenEmulator/ExplicitOctalEmulator.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Lexer/TokenEmulator/FlexibleDocStringEmulator.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Lexer/TokenEmulator/FnTokenEmulator.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Lexer/TokenEmulator/KeywordEmulator.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Lexer/TokenEmulator/MatchTokenEmulator.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Lexer/TokenEmulator/NullsafeTokenEmulator.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Lexer/TokenEmulator/NumericLiteralSeparatorEmulator.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Lexer/TokenEmulator/ReadonlyFunctionTokenEmulator.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Lexer/TokenEmulator/ReadonlyTokenEmulator.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Lexer/TokenEmulator/ReverseEmulator.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Lexer/TokenEmulator/TokenEmulator.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/NameContext.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Arg.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Attribute.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/AttributeGroup.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/ComplexType.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Const_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/ArrayDimFetch.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/ArrayItem.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Array_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/ArrowFunction.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Assign.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignOp.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignOp/BitwiseAnd.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignOp/BitwiseOr.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignOp/BitwiseXor.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignOp/Coalesce.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignOp/Concat.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignOp/Div.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignOp/Minus.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignOp/Mod.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignOp/Mul.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignOp/Plus.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignOp/Pow.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignOp/ShiftLeft.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignOp/ShiftRight.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignRef.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/BitwiseAnd.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/BitwiseOr.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/BitwiseXor.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/BooleanAnd.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/BooleanOr.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/Coalesce.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/Concat.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/Div.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/Equal.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/Greater.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/GreaterOrEqual.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/Identical.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/LogicalAnd.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/LogicalOr.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/LogicalXor.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/Minus.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/Mod.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/Mul.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/NotEqual.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/NotIdentical.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/Plus.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/Pow.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/ShiftLeft.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/ShiftRight.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/Smaller.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/SmallerOrEqual.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/Spaceship.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BitwiseNot.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BooleanNot.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/CallLike.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Cast.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Cast/Array_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Cast/Bool_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Cast/Double.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Cast/Int_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Cast/Object_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Cast/String_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Cast/Unset_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/ClassConstFetch.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Clone_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Closure.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/ClosureUse.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/ConstFetch.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Empty_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Error.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/ErrorSuppress.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Eval_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Exit_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/FuncCall.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Include_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Instanceof_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Isset_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/List_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Match_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/MethodCall.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/New_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/NullsafeMethodCall.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/NullsafePropertyFetch.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/PostDec.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/PostInc.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/PreDec.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/PreInc.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Print_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/PropertyFetch.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/ShellExec.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/StaticCall.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/StaticPropertyFetch.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Ternary.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Throw_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/UnaryMinus.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/UnaryPlus.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Variable.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/YieldFrom.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Yield_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/FunctionLike.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Identifier.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/IntersectionType.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/MatchArm.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Name.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Name/FullyQualified.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Name/Relative.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/NullableType.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Param.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Scalar.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Scalar/DNumber.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Scalar/Encapsed.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Scalar/EncapsedStringPart.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Scalar/LNumber.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Scalar/MagicConst.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Scalar/MagicConst/Class_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Scalar/MagicConst/Dir.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Scalar/MagicConst/File.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Scalar/MagicConst/Function_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Scalar/MagicConst/Line.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Scalar/MagicConst/Method.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Scalar/MagicConst/Namespace_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Scalar/MagicConst/Trait_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Scalar/String_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Break_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Case_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Catch_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/ClassConst.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/ClassLike.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/ClassMethod.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Class_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Const_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Continue_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/DeclareDeclare.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Declare_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Do_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Echo_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/ElseIf_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Else_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/EnumCase.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Enum_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Expression.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Finally_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/For_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Foreach_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Function_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Global_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Goto_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/GroupUse.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/HaltCompiler.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/If_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/InlineHTML.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Interface_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Label.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Namespace_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Nop.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Property.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/PropertyProperty.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Return_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/StaticVar.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Static_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Switch_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Throw_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/TraitUse.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/TraitUseAdaptation.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/TraitUseAdaptation/Alias.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/TraitUseAdaptation/Precedence.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Trait_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/TryCatch.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Unset_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/UseUse.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Use_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/While_.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/UnionType.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/VarLikeIdentifier.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Node/VariadicPlaceholder.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/NodeAbstract.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/NodeDumper.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/NodeFinder.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/NodeTraverser.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/NodeTraverserInterface.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/NodeVisitor.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/NodeVisitor/CloningVisitor.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/NodeVisitor/FindingVisitor.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/NodeVisitor/FirstFindingVisitor.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/NodeVisitor/NameResolver.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/NodeVisitor/NodeConnectingVisitor.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/NodeVisitor/ParentConnectingVisitor.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/NodeVisitorAbstract.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Parser.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Parser/Multiple.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Parser/Php5.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Parser/Php7.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/Parser/Tokens.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/ParserAbstract.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/ParserFactory.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/PrettyPrinter/Standard.php'; require_once __DIR__ . '/vendor/nikic/php-parser/lib/PhpParser/PrettyPrinterAbstract.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/AbstractNodeVisitor.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/Attribute.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/ConstExpr/ConstExprArrayItemNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/ConstExpr/ConstExprArrayNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/ConstExpr/ConstExprFalseNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/ConstExpr/ConstExprFloatNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/ConstExpr/ConstExprIntegerNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/ConstExpr/ConstExprNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/ConstExpr/ConstExprNullNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/ConstExpr/ConstExprStringNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/ConstExpr/ConstExprTrueNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/ConstExpr/ConstFetchNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/ConstExpr/DoctrineConstExprStringNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/ConstExpr/QuoteAwareConstExprStringNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/Node.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/NodeAttributes.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/NodeTraverser.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/NodeVisitor.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/NodeVisitor/CloningVisitor.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/AssertTagMethodValueNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/AssertTagPropertyValueNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/AssertTagValueNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/DeprecatedTagValueNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/Doctrine/DoctrineAnnotation.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/Doctrine/DoctrineArgument.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/Doctrine/DoctrineArray.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/Doctrine/DoctrineArrayItem.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/Doctrine/DoctrineTagValueNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/ExtendsTagValueNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/GenericTagValueNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/ImplementsTagValueNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/InvalidTagValueNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/MethodTagValueNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/MethodTagValueParameterNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/MixinTagValueNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/ParamClosureThisTagValueNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/ParamImmediatelyInvokedCallableTagValueNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/ParamLaterInvokedCallableTagValueNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/ParamOutTagValueNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/ParamTagValueNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/PhpDocChildNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/PhpDocNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/PhpDocTagNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/PhpDocTagValueNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/PhpDocTextNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/PropertyTagValueNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/PureUnlessCallableIsImpureTagValueNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/RequireExtendsTagValueNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/RequireImplementsTagValueNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/ReturnTagValueNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/SelfOutTagValueNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/TemplateTagValueNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/ThrowsTagValueNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/TypeAliasImportTagValueNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/TypeAliasTagValueNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/TypelessParamTagValueNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/UsesTagValueNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/VarTagValueNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/Type/ArrayShapeItemNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/Type/ArrayShapeNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/Type/ArrayShapeUnsealedTypeNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/Type/ArrayTypeNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/Type/CallableTypeNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/Type/CallableTypeParameterNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/Type/ConditionalTypeForParameterNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/Type/ConditionalTypeNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/Type/ConstTypeNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/Type/GenericTypeNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/Type/IdentifierTypeNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/Type/IntersectionTypeNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/Type/InvalidTypeNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/Type/NullableTypeNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/Type/ObjectShapeItemNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/Type/ObjectShapeNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/Type/OffsetAccessTypeNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/Type/ThisTypeNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/Type/TypeNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Ast/Type/UnionTypeNode.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Lexer/Lexer.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Parser/ConstExprParser.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Parser/ParserException.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Parser/PhpDocParser.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Parser/StringUnescaper.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Parser/TokenIterator.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Parser/TypeParser.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Printer/DiffElem.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Printer/Differ.php'; require_once __DIR__ . '/vendor/phpstan/phpdoc-parser/src/Printer/Printer.php'; <?php // autoload.php @generated by Composer if (PHP_VERSION_ID < 50600) { if (!headers_sent()) { header('HTTP/1.1 500 Internal Server Error'); } $err = 'Composer 2.3.0 dropped support for autoloading on PHP <5.6 and you are running '.PHP_VERSION.', please upgrade PHP or use Composer 2.2 LTS via "composer self-update --2.2". Aborting.'.PHP_EOL; if (!ini_get('display_errors')) { if (PHP_SAPI === 'cli' || PHP_SAPI === 'phpdbg') { fwrite(STDERR, $err); } elseif (!headers_sent()) { echo $err; } } trigger_error( $err, E_USER_ERROR ); } require_once __DIR__ . '/composer/autoload_real.php'; return ComposerAutoloaderInit07b46dce51ea41c025511b9415b3274c::getLoader(); The MIT License (MIT) Copyright (c) 2017 Roave, LLC. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Identifier; use PHPStan\BetterReflection\Identifier\Exception\InvalidIdentifierName; use PHPStan\BetterReflection\Reflection\ReflectionClass; use PHPStan\BetterReflection\Reflection\ReflectionFunction; use function ltrim; use function preg_match; use function strpos; class Identifier { public const WILDCARD = '*'; private const VALID_NAME_REGEXP = '/([a-zA-Z_\\x7f-\\xff][a-zA-Z0-9_\\x7f-\\xff]*)(\\\\[a-zA-Z_\\x7f-\\xff][a-zA-Z0-9_\\x7f-\\xff]*)*/'; /** * @var string */ private $name; /** * @var \PHPStan\BetterReflection\Identifier\IdentifierType */ private $type; /** @throws InvalidIdentifierName */ public function __construct(string $name, \PHPStan\BetterReflection\Identifier\IdentifierType $type) { $this->type = $type; if ($name === self::WILDCARD || $name === ReflectionFunction::CLOSURE_NAME || strpos($name, ReflectionClass::ANONYMOUS_CLASS_NAME_PREFIX) === 0) { $this->name = $name; return; } $name = ltrim($name, '\\'); if (!preg_match(self::VALID_NAME_REGEXP, $name)) { throw InvalidIdentifierName::fromInvalidName($name); } $this->name = $name; } public function getName() : string { return $this->name; } public function getType() : \PHPStan\BetterReflection\Identifier\IdentifierType { return $this->type; } public function isClass() : bool { return $this->type->isClass(); } public function isFunction() : bool { return $this->type->isFunction(); } public function isConstant() : bool { return $this->type->isConstant(); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Identifier\Exception; use InvalidArgumentException; use function sprintf; class InvalidIdentifierName extends InvalidArgumentException { public static function fromInvalidName(string $name) : self { return new self(sprintf('Invalid identifier name "%s"', $name)); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Identifier; use InvalidArgumentException; use PHPStan\BetterReflection\Reflection\ReflectionClass; use PHPStan\BetterReflection\Reflection\ReflectionConstant; use PHPStan\BetterReflection\Reflection\ReflectionFunction; use function array_key_exists; use function sprintf; class IdentifierType { public const IDENTIFIER_CLASS = ReflectionClass::class; public const IDENTIFIER_FUNCTION = ReflectionFunction::class; public const IDENTIFIER_CONSTANT = ReflectionConstant::class; private const VALID_TYPES = [self::IDENTIFIER_CLASS => null, self::IDENTIFIER_FUNCTION => null, self::IDENTIFIER_CONSTANT => null]; /** * @var string */ private $name; public function __construct(string $type = self::IDENTIFIER_CLASS) { if (!array_key_exists($type, self::VALID_TYPES)) { throw new InvalidArgumentException(sprintf('%s is not a valid identifier type', $type)); } $this->name = $type; } public function getName() : string { return $this->name; } public function isClass() : bool { return $this->name === self::IDENTIFIER_CLASS; } public function isFunction() : bool { return $this->name === self::IDENTIFIER_FUNCTION; } public function isConstant() : bool { return $this->name === self::IDENTIFIER_CONSTANT; } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Located; /** * @internal * * @psalm-immutable */ class EvaledLocatedSource extends \PHPStan\BetterReflection\SourceLocator\Located\LocatedSource { public function isEvaled() : bool { return \true; } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Located; /** * @internal * * @psalm-immutable */ class AnonymousLocatedSource extends \PHPStan\BetterReflection\SourceLocator\Located\LocatedSource { public function __construct(string $source, string $filename) { parent::__construct($source, null, $filename); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Located; use InvalidArgumentException; use PHPStan\BetterReflection\SourceLocator\Exception\InvalidFileLocation; use PHPStan\BetterReflection\Util\FileHelper; use function assert; /** * Value object containing source code that has been located. * * @internal * * @psalm-immutable */ class LocatedSource { /** @var non-empty-string|null */ private $filename; /** * @var string */ private $source; /** * @var string|null */ private $name; /** * @throws InvalidArgumentException * @throws InvalidFileLocation */ public function __construct(string $source, ?string $name, ?string $filename = null) { $this->source = $source; $this->name = $name; if ($filename !== null) { assert($filename !== ''); $filename = FileHelper::normalizeWindowsPath($filename); } $this->filename = $filename; } public function getSource() : string { return $this->source; } public function getName() : ?string { return $this->name; } /** @return non-empty-string|null */ public function getFileName() : ?string { return $this->filename; } /** * Is the located source in PHP internals? */ public function isInternal() : bool { return \false; } /** @return non-empty-string|null */ public function getExtensionName() : ?string { return null; } /** * Is the located source produced by eval() or \function_create()? */ public function isEvaled() : bool { return \false; } public function getAliasName() : ?string { return null; } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Located; /** * @internal * * @psalm-immutable */ class InternalLocatedSource extends \PHPStan\BetterReflection\SourceLocator\Located\LocatedSource { /** * @var non-empty-string */ private $extensionName; /** @param non-empty-string $extensionName */ public function __construct(string $source, string $name, string $extensionName, ?string $fileName = null) { $this->extensionName = $extensionName; parent::__construct($source, $name, $fileName); } public function isInternal() : bool { return \true; } /** @return non-empty-string|null */ public function getExtensionName() : ?string { return $this->extensionName; } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Located; /** * @internal * * @psalm-immutable */ class AliasLocatedSource extends \PHPStan\BetterReflection\SourceLocator\Located\LocatedSource { /** * @var string */ private $aliasName; public function __construct(string $source, string $name, ?string $filename, string $aliasName) { $this->aliasName = $aliasName; parent::__construct($source, $name, $filename); } public function getAliasName() : ?string { return $this->aliasName; } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Ast; use PhpParser\Node; use PhpParser\Parser; use PHPStan\BetterReflection\Identifier\Identifier; use PHPStan\BetterReflection\Identifier\IdentifierType; use PHPStan\BetterReflection\Reflection\Reflection; use PHPStan\BetterReflection\Reflector\Exception\IdentifierNotFound; use PHPStan\BetterReflection\Reflector\Reflector; use PHPStan\BetterReflection\SourceLocator\Ast\Strategy\NodeToReflection; use PHPStan\BetterReflection\SourceLocator\Located\LocatedSource; use Throwable; use function strtolower; /** @internal */ class Locator { /** * @var \PHPStan\BetterReflection\SourceLocator\Ast\FindReflectionsInTree */ private $findReflectionsInTree; /** * @var \PhpParser\Parser */ private $parser; public function __construct(Parser $parser) { $this->parser = $parser; $this->findReflectionsInTree = new \PHPStan\BetterReflection\SourceLocator\Ast\FindReflectionsInTree(new NodeToReflection()); } /** * @throws IdentifierNotFound * @throws Exception\ParseToAstFailure */ public function findReflection(Reflector $reflector, LocatedSource $locatedSource, Identifier $identifier) : Reflection { return $this->findInArray($this->findReflectionsOfType($reflector, $locatedSource, $identifier->getType()), $identifier, $locatedSource->getName()); } /** * Get an array of reflections found in some code. * * @return list<Reflection> * * @throws Exception\ParseToAstFailure */ public function findReflectionsOfType(Reflector $reflector, LocatedSource $locatedSource, IdentifierType $identifierType) : array { try { /** @var list<Node\Stmt> $ast */ $ast = $this->parser->parse($locatedSource->getSource()); return $this->findReflectionsInTree->__invoke($reflector, $ast, $identifierType, $locatedSource); } catch (Throwable $exception) { throw \PHPStan\BetterReflection\SourceLocator\Ast\Exception\ParseToAstFailure::fromLocatedSource($locatedSource, $exception); } } /** * Given an array of Reflections, try to find the identifier. * * @param list<Reflection> $reflections * * @throws IdentifierNotFound */ private function findInArray(array $reflections, Identifier $identifier, ?string $name) : Reflection { if ($name === null) { throw IdentifierNotFound::fromIdentifier($identifier); } $identifierName = strtolower($name); foreach ($reflections as $reflection) { if (strtolower($reflection->getName()) === $identifierName) { return $reflection; } } throw IdentifierNotFound::fromIdentifier($identifier); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Ast; use PhpParser\Node; use PhpParser\Node\Name; use PhpParser\Node\Stmt\Namespace_; use PhpParser\NodeTraverser; use PhpParser\NodeVisitor\NameResolver; use PhpParser\NodeVisitorAbstract; use PHPStan\BetterReflection\Identifier\IdentifierType; use PHPStan\BetterReflection\Reflection\Exception\InvalidConstantNode; use PHPStan\BetterReflection\Reflection\ReflectionClass; use PHPStan\BetterReflection\Reflection\ReflectionConstant; use PHPStan\BetterReflection\Reflection\ReflectionFunction; use PHPStan\BetterReflection\Reflector\Exception\IdentifierNotFound; use PHPStan\BetterReflection\Reflector\Reflector; use PHPStan\BetterReflection\SourceLocator\Ast\Strategy\AstConversionStrategy; use PHPStan\BetterReflection\SourceLocator\Located\LocatedSource; use PHPStan\BetterReflection\Util\ConstantNodeChecker; use function assert; use function count; /** @internal */ final class FindReflectionsInTree { /** * @var \PHPStan\BetterReflection\SourceLocator\Ast\Strategy\AstConversionStrategy */ private $astConversionStrategy; public function __construct(AstConversionStrategy $astConversionStrategy) { $this->astConversionStrategy = $astConversionStrategy; } /** * Find all reflections of a given type in an Abstract Syntax Tree * * @param Node[] $ast * * @return list<ReflectionClass|ReflectionFunction|ReflectionConstant> */ public function __invoke(Reflector $reflector, array $ast, IdentifierType $identifierType, LocatedSource $locatedSource) : array { $nodeVisitor = new class($reflector, $identifierType, $locatedSource, $this->astConversionStrategy) extends NodeVisitorAbstract { /** @var list<ReflectionClass|ReflectionFunction|ReflectionConstant> */ private $reflections = []; /** * @var \PhpParser\Node\Stmt\Namespace_|null */ private $currentNamespace = null; /** * @var \PHPStan\BetterReflection\Reflector\Reflector */ private $reflector; /** * @var \PHPStan\BetterReflection\Identifier\IdentifierType */ private $identifierType; /** * @var \PHPStan\BetterReflection\SourceLocator\Located\LocatedSource */ private $locatedSource; /** * @var \PHPStan\BetterReflection\SourceLocator\Ast\Strategy\AstConversionStrategy */ private $astConversionStrategy; public function __construct(Reflector $reflector, IdentifierType $identifierType, LocatedSource $locatedSource, AstConversionStrategy $astConversionStrategy) { $this->reflector = $reflector; $this->identifierType = $identifierType; $this->locatedSource = $locatedSource; $this->astConversionStrategy = $astConversionStrategy; } /** * {@inheritDoc} */ public function enterNode(Node $node) { if ($node instanceof Namespace_) { $this->currentNamespace = $node; } return null; } /** * {@inheritDoc} */ public function leaveNode(Node $node) { if ($this->identifierType->isClass() && ($node instanceof Node\Stmt\Class_ || $node instanceof Node\Stmt\Interface_ || $node instanceof Node\Stmt\Trait_ || $node instanceof Node\Stmt\Enum_)) { $classNamespace = $node->name === null ? null : $this->currentNamespace; $this->reflections[] = $this->astConversionStrategy->__invoke($this->reflector, $node, $this->locatedSource, $classNamespace); return null; } if ($this->identifierType->isConstant()) { if ($node instanceof Node\Stmt\Const_) { for ($i = 0; $i < count($node->consts); $i++) { $this->reflections[] = $this->astConversionStrategy->__invoke($this->reflector, $node, $this->locatedSource, $this->currentNamespace, $i); } return null; } if ($node instanceof Node\Expr\FuncCall) { try { ConstantNodeChecker::assertValidDefineFunctionCall($node); } catch (InvalidConstantNode $exception) { return null; } if ($node->name->hasAttribute('namespacedName')) { $namespacedName = $node->name->getAttribute('namespacedName'); assert($namespacedName instanceof Name); try { $this->reflector->reflectFunction($namespacedName->toString()); return null; } catch (IdentifierNotFound $exception) { // Global define() } } $this->reflections[] = $this->astConversionStrategy->__invoke($this->reflector, $node, $this->locatedSource, $this->currentNamespace); return null; } } if ($this->identifierType->isFunction() && $node instanceof Node\Stmt\Function_) { $this->reflections[] = $this->astConversionStrategy->__invoke($this->reflector, $node, $this->locatedSource, $this->currentNamespace); } if ($node instanceof Namespace_) { $this->currentNamespace = null; } return null; } /** @return list<ReflectionClass|ReflectionFunction|ReflectionConstant> */ public function getReflections() : array { return $this->reflections; } }; $nodeTraverser = new NodeTraverser(); $nodeTraverser->addVisitor(new NameResolver()); $nodeTraverser->addVisitor($nodeVisitor); $nodeTraverser->traverse($ast); return $nodeVisitor->getReflections(); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Ast\Exception; use PhpParser\Error; use PHPStan\BetterReflection\SourceLocator\Located\LocatedSource; use RuntimeException; use Throwable; use function array_slice; use function count; use function explode; use function implode; use function max; use function min; use function sprintf; class ParseToAstFailure extends RuntimeException { public static function fromLocatedSource(LocatedSource $locatedSource, Throwable $previous) : self { $additionalInformation = ''; $fileName = $locatedSource->getFileName(); if ($fileName !== null) { $additionalInformation = sprintf(' in file %s', $fileName); } if ($previous instanceof Error) { $errorStartLine = $previous->getStartLine(); $source = null; if ($errorStartLine !== -1) { $additionalInformation .= sprintf(' (line %d)', $errorStartLine); $lines = explode("\n", $locatedSource->getSource()); $minLine = max(1, $errorStartLine - 5); $maxLine = min(count($lines), $errorStartLine + 5); $source = implode("\n", array_slice($lines, $minLine - 1, $maxLine - $minLine + 1)); } $additionalInformation .= sprintf(': %s', $previous->getRawMessage()); if ($source !== null) { $additionalInformation .= sprintf("\n\n%s", $source); } } else { $additionalInformation .= sprintf(': %s', $previous->getMessage()); } return new self(sprintf('AST failed to parse in located source%s', $additionalInformation), 0, $previous); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Ast\Parser; use PhpParser\ErrorHandler; use PhpParser\Node; use PhpParser\Parser; use function array_key_exists; use function hash; use function serialize; use function sprintf; use function strlen; use function unserialize; /** @internal */ final class MemoizingParser implements Parser { /** @var array<string, string> indexed by source hash */ private $sourceHashToAst = []; /** * @var \PhpParser\Parser */ private $wrappedParser; public function __construct(Parser $wrappedParser) { $this->wrappedParser = $wrappedParser; } public function parse(string $code, ?\PhpParser\ErrorHandler $errorHandler = null) : ?array { // note: this code is mathematically buggy by default, as we are using a hash to identify // cache entries. The string length is added to further reduce likeliness (although // already imperceptible) of key collisions. // In the "real world", this code will work just fine. $hash = sprintf('%s:%d', hash('sha256', $code), strlen($code)); if (array_key_exists($hash, $this->sourceHashToAst)) { /** @var Node\Stmt[]|null $ast */ $ast = unserialize($this->sourceHashToAst[$hash]); return $ast; } $ast = $this->wrappedParser->parse($code, $errorHandler); $this->sourceHashToAst[$hash] = serialize($ast); return $ast; } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Ast\Strategy; use PhpParser\Node; use PHPStan\BetterReflection\Reflection\ReflectionClass; use PHPStan\BetterReflection\Reflection\ReflectionConstant; use PHPStan\BetterReflection\Reflection\ReflectionFunction; use PHPStan\BetterReflection\Reflector\Reflector; use PHPStan\BetterReflection\SourceLocator\Located\LocatedSource; /** @internal */ interface AstConversionStrategy { /** * Take an AST node in some located source (potentially in a namespace) and * convert it to something (concrete implementation decides) * @param \PhpParser\Node\Stmt\Class_|\PhpParser\Node\Stmt\Interface_|\PhpParser\Node\Stmt\Trait_|\PhpParser\Node\Stmt\Enum_|\PhpParser\Node\Stmt\Function_|\PhpParser\Node\Expr\Closure|\PhpParser\Node\Expr\ArrowFunction|\PhpParser\Node\Stmt\Const_|\PhpParser\Node\Expr\FuncCall $node * @return \PHPStan\BetterReflection\Reflection\ReflectionClass|\PHPStan\BetterReflection\Reflection\ReflectionConstant|\PHPStan\BetterReflection\Reflection\ReflectionFunction */ public function __invoke(Reflector $reflector, $node, LocatedSource $locatedSource, ?\PhpParser\Node\Stmt\Namespace_ $namespace, ?int $positionInNode = null); } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Ast\Strategy; use LogicException; use PhpParser\Node; use PHPStan\BetterReflection\Reflection\ReflectionClass; use PHPStan\BetterReflection\Reflection\ReflectionConstant; use PHPStan\BetterReflection\Reflection\ReflectionEnum; use PHPStan\BetterReflection\Reflection\ReflectionFunction; use PHPStan\BetterReflection\Reflector\Reflector; use PHPStan\BetterReflection\SourceLocator\Located\LocatedSource; use function implode; /** @internal */ class NodeToReflection implements \PHPStan\BetterReflection\SourceLocator\Ast\Strategy\AstConversionStrategy { /** * Take an AST node in some located source (potentially in a namespace) and * convert it to a Reflection * @param \PhpParser\Node\Stmt\Class_|\PhpParser\Node\Stmt\Interface_|\PhpParser\Node\Stmt\Trait_|\PhpParser\Node\Stmt\Enum_|\PhpParser\Node\Stmt\Function_|\PhpParser\Node\Expr\Closure|\PhpParser\Node\Expr\ArrowFunction|\PhpParser\Node\Stmt\Const_|\PhpParser\Node\Expr\FuncCall $node * @return \PHPStan\BetterReflection\Reflection\ReflectionClass|\PHPStan\BetterReflection\Reflection\ReflectionConstant|\PHPStan\BetterReflection\Reflection\ReflectionFunction */ public function __invoke(Reflector $reflector, $node, LocatedSource $locatedSource, ?\PhpParser\Node\Stmt\Namespace_ $namespace, ?int $positionInNode = null) { /** @psalm-suppress PossiblyNullPropertyFetch, PossiblyNullReference */ $namespaceName = (($namespace2 = $namespace) ? $namespace2->name : null) !== null ? implode('\\', $namespace->name->getParts()) : null; if ($namespaceName === '') { throw new LogicException('Namespace name should never be empty'); } if ($node instanceof Node\Stmt\Enum_) { return ReflectionEnum::createFromNode($reflector, $node, $locatedSource, $namespaceName); } if ($node instanceof Node\Stmt\ClassLike) { return ReflectionClass::createFromNode($reflector, $node, $locatedSource, $namespaceName); } if ($node instanceof Node\Stmt\Const_) { return ReflectionConstant::createFromNode($reflector, $node, $locatedSource, $namespaceName, $positionInNode); } if ($node instanceof Node\Expr\FuncCall) { return ReflectionConstant::createFromNode($reflector, $node, $locatedSource); } return ReflectionFunction::createFromNode($reflector, $node, $locatedSource, $namespaceName); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Exception; use LogicException; use function sprintf; class NoAnonymousClassOnLine extends LogicException { public static function create(string $fileName, int $lineNumber) : self { return new self(sprintf('No anonymous class found on line %d in %s', $lineNumber, $fileName)); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Exception; use LogicException; class NotInternalClass extends LogicException { } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Exception; use LogicException; use function sprintf; class TwoClosuresOnSameLine extends LogicException { public static function create(string $fileName, int $lineNumber) : self { return new self(sprintf('Two closures on line %d in %s', $lineNumber, $fileName)); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Exception; use LogicException; class EvaledAnonymousClassCannotBeLocated extends LogicException { public static function create() : self { return new self('Evaled anonymous class cannot be located'); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Exception; use RuntimeException; use function gettype; use function is_object; use function sprintf; class InvalidFileInfo extends RuntimeException { /** * @param mixed $nonSplFileInfo */ public static function fromNonSplFileInfo($nonSplFileInfo) : self { return new self(sprintf('Expected an iterator of SplFileInfo instances, %s given instead', is_object($nonSplFileInfo) ? \get_class($nonSplFileInfo) : gettype($nonSplFileInfo))); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Exception; use RuntimeException; class InvalidFileLocation extends RuntimeException { } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Exception; use LogicException; use function sprintf; class NoClosureOnLine extends LogicException { public static function create(string $fileName, int $lineNumber) : self { return new self(sprintf('No closure found on line %d in %s', $lineNumber, $fileName)); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Exception; use RuntimeException; /** * This is removed in PR #236 - this should never have existed, but leaving here for BC. This exception is never thrown * so you should remove it from your code. * * You were probably looking to catch \PHPStan\BetterReflection\Reflector\Exception\IdentifierNotFound instead. * * @deprecated You're probably looking for `IdentifierNotFound` * * @see \PHPStan\BetterReflection\Reflector\Exception\IdentifierNotFound */ class FunctionUndefined extends RuntimeException { } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Exception; use RuntimeException; use function is_file; use function sprintf; class InvalidDirectory extends RuntimeException { public static function fromNonDirectory(string $nonDirectory) : self { if (is_file($nonDirectory)) { return new self(sprintf('"%s" must be a directory, not a file', $nonDirectory)); } return new self(sprintf('"%s" does not exist', $nonDirectory)); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Exception; use LogicException; use function sprintf; class TwoAnonymousClassesOnSameLine extends LogicException { public static function create(string $fileName, int $lineNumber) : self { return new self(sprintf('Two anonymous classes on line %d in %s', $lineNumber, $fileName)); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Exception; use LogicException; class EvaledClosureCannotBeLocated extends LogicException { public static function create() : self { return new self('Evaled closure cannot be located'); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator; use PHPStan\BetterReflection\SourceLocator\Exception\InvalidFileLocation; use function is_file; use function is_readable; use function sprintf; class FileChecker { /** * @param non-empty-string $filename * * @throws InvalidFileLocation */ public static function assertReadableFile(string $filename) : void { if (!is_file($filename)) { throw new InvalidFileLocation(sprintf('"%s" is not a file', $filename)); } if (!is_readable($filename)) { throw new InvalidFileLocation(sprintf('File "%s" is not readable', $filename)); } } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Type; use InvalidArgumentException; use PHPStan\BetterReflection\Identifier\Identifier; use PHPStan\BetterReflection\SourceLocator\Ast\Locator; use PHPStan\BetterReflection\SourceLocator\Exception\InvalidFileLocation; use PHPStan\BetterReflection\SourceLocator\FileChecker; use PHPStan\BetterReflection\SourceLocator\Located\LocatedSource; use function file_get_contents; /** * This source locator loads an entire file, specified in the constructor * argument. * * This is useful for loading a class that does not have a namespace. This is * also the class required if you want to use Reflector->getClassesFromFile * (which loads all classes from specified file) */ class SingleFileSourceLocator extends \PHPStan\BetterReflection\SourceLocator\Type\AbstractSourceLocator { /** * @var non-empty-string */ private $fileName; /** * @param non-empty-string $fileName * * @throws InvalidFileLocation */ public function __construct(string $fileName, Locator $astLocator) { $this->fileName = $fileName; FileChecker::assertReadableFile($fileName); parent::__construct($astLocator); } /** * {@inheritDoc} * * @throws InvalidArgumentException * @throws InvalidFileLocation */ protected function createLocatedSource(Identifier $identifier) : ?\PHPStan\BetterReflection\SourceLocator\Located\LocatedSource { return new LocatedSource(file_get_contents($this->fileName), $identifier->getName(), $this->fileName); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Type; use PHPStan\BetterReflection\Identifier\Identifier; use PHPStan\BetterReflection\Identifier\IdentifierType; use PHPStan\BetterReflection\Reflection\Reflection; use PHPStan\BetterReflection\Reflector\Reflector; use function array_map; use function array_merge; class AggregateSourceLocator implements \PHPStan\BetterReflection\SourceLocator\Type\SourceLocator { /** * @var list<SourceLocator> */ private $sourceLocators = []; /** @param list<SourceLocator> $sourceLocators */ public function __construct(array $sourceLocators = []) { $this->sourceLocators = $sourceLocators; } public function locateIdentifier(Reflector $reflector, Identifier $identifier) : ?\PHPStan\BetterReflection\Reflection\Reflection { foreach ($this->sourceLocators as $sourceLocator) { $located = $sourceLocator->locateIdentifier($reflector, $identifier); if ($located) { return $located; } } return null; } /** * {@inheritDoc} */ public function locateIdentifiersByType(Reflector $reflector, IdentifierType $identifierType) : array { return array_merge([], ...array_map(static function (\PHPStan\BetterReflection\SourceLocator\Type\SourceLocator $sourceLocator) use($reflector, $identifierType) : array { return $sourceLocator->locateIdentifiersByType($reflector, $identifierType); }, $this->sourceLocators)); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Type; use InvalidArgumentException; use ReflectionClass; use PHPStan\BetterReflection\Identifier\Identifier; use PHPStan\BetterReflection\SourceLocator\Ast\Locator; use PHPStan\BetterReflection\SourceLocator\Exception\InvalidFileLocation; use PHPStan\BetterReflection\SourceLocator\Located\EvaledLocatedSource; use PHPStan\BetterReflection\SourceLocator\Located\LocatedSource; use PHPStan\BetterReflection\SourceLocator\SourceStubber\SourceStubber; use PHPStan\BetterReflection\Util\ClassExistenceChecker; use function is_file; final class EvaledCodeSourceLocator extends \PHPStan\BetterReflection\SourceLocator\Type\AbstractSourceLocator { /** * @var \PHPStan\BetterReflection\SourceLocator\SourceStubber\SourceStubber */ private $stubber; public function __construct(Locator $astLocator, SourceStubber $stubber) { $this->stubber = $stubber; parent::__construct($astLocator); } /** * {@inheritDoc} * * @throws InvalidArgumentException * @throws InvalidFileLocation */ protected function createLocatedSource(Identifier $identifier) : ?\PHPStan\BetterReflection\SourceLocator\Located\LocatedSource { $classReflection = $this->getInternalReflectionClass($identifier); if ($classReflection === null) { return null; } $stubData = $this->stubber->generateClassStub($classReflection->getName()); if ($stubData === null) { return null; } return new EvaledLocatedSource($stubData->getStub(), $classReflection->getName()); } private function getInternalReflectionClass(Identifier $identifier) : ?\ReflectionClass { if (!$identifier->isClass()) { return null; } /** @psalm-var class-string|trait-string $name */ $name = $identifier->getName(); if (!ClassExistenceChecker::exists($name, \false)) { return null; // not an available internal class } $reflection = new ReflectionClass($name); $sourceFile = $reflection->getFileName(); return $sourceFile !== \false && is_file($sourceFile) ? null : $reflection; } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Type\AutoloadSourceLocator; use LogicException; use function sprintf; use function stat; use function stream_wrapper_register; use function stream_wrapper_restore; use function stream_wrapper_unregister; use const STREAM_URL_STAT_QUIET; /** * This class will operate as a stream wrapper, intercepting any access to a file while * in operation. * * @internal DO NOT USE: this is an implementation detail of * the {@see \PHPStan\BetterReflection\SourceLocator\Type\AutoloadSourceLocator} * * @phpcs:disable SlevomatCodingStandard.TypeHints.ParameterTypeHint.MissingNativeTypeHint * @phpcs:disable PSR1.Methods.CamelCapsMethodName.NotCamelCaps * @phpcs:disable Squiz.NamingConventions.ValidVariableName.NotCamelCaps * * @psalm-suppress MissingConstructor */ final class FileReadTrapStreamWrapper { private const DEFAULT_STREAM_WRAPPER_PROTOCOLS = ['file', 'phar']; /** @var list<string>|null */ private static $registeredStreamWrapperProtocols = null; /** * Read this property to determine the last file on which reads were attempted * * @psalm-readonly * @psalm-allow-private-mutation * @var string|null */ public static $autoloadLocatedFile = null; /** @var resource */ public $context; /** * @param callable() : ExecutedMethodReturnType $executeMeWithinStreamWrapperOverride * @param list<string> $streamWrapperProtocols * * @psalm-return ExecutedMethodReturnType * * @psalm-template ExecutedMethodReturnType of mixed * @return mixed */ public static function withStreamWrapperOverride(callable $executeMeWithinStreamWrapperOverride, array $streamWrapperProtocols = self::DEFAULT_STREAM_WRAPPER_PROTOCOLS) { self::$registeredStreamWrapperProtocols = $streamWrapperProtocols; self::$autoloadLocatedFile = null; try { foreach ($streamWrapperProtocols as $protocol) { stream_wrapper_unregister($protocol); stream_wrapper_register($protocol, self::class); } $result = $executeMeWithinStreamWrapperOverride(); } finally { foreach ($streamWrapperProtocols as $protocol) { @stream_wrapper_restore($protocol); } self::$registeredStreamWrapperProtocols = null; self::$autoloadLocatedFile = null; } return $result; } /** * Our wrapper simply records which file we tried to load and returns * boolean false indicating failure. * * @internal do not call this method directly! This is stream wrapper * voodoo logic that you **DO NOT** want to touch! * * @see https://php.net/manual/en/class.streamwrapper.php * @see https://php.net/manual/en/streamwrapper.stream-open.php * * @param string $path * @param string $mode * @param int $options * @param string $opened_path */ public function stream_open($path, $mode, $options, &$opened_path) : bool { self::$autoloadLocatedFile = $path; // @infection-ignore-all FalseValue return \false; } /** * url_stat is triggered by calls like "file_exists". The call to "file_exists" must not be overloaded. * This function restores the original "file" stream, issues a call to "stat" to get the real results, * and then re-registers the AutoloadSourceLocator stream wrapper. * * @internal do not call this method directly! This is stream wrapper * voodoo logic that you **DO NOT** want to touch! * * @see https://php.net/manual/en/class.streamwrapper.php * @see https://php.net/manual/en/streamwrapper.url-stat.php * * @param string $path * @param int $flags * * @return mixed[]|bool */ public function url_stat($path, $flags) { if (self::$registeredStreamWrapperProtocols === null) { throw new LogicException(sprintf('%s not registered: cannot operate. Do not call this method directly.', self::class)); } foreach (self::$registeredStreamWrapperProtocols as $protocol) { stream_wrapper_restore($protocol); } if (($flags & STREAM_URL_STAT_QUIET) === STREAM_URL_STAT_QUIET) { $result = @stat($path); } else { $result = stat($path); } foreach (self::$registeredStreamWrapperProtocols as $protocol) { stream_wrapper_unregister($protocol); stream_wrapper_register($protocol, self::class); } return $result; } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Type; use Iterator; use PHPStan\BetterReflection\Identifier\Identifier; use PHPStan\BetterReflection\Identifier\IdentifierType; use PHPStan\BetterReflection\Reflection\Reflection; use PHPStan\BetterReflection\Reflector\Reflector; use PHPStan\BetterReflection\SourceLocator\Ast\Locator; use PHPStan\BetterReflection\SourceLocator\Exception\InvalidFileInfo; use PHPStan\BetterReflection\SourceLocator\Exception\InvalidFileLocation; use SplFileInfo; use function array_filter; use function array_map; use function array_values; use function iterator_to_array; use function pathinfo; use const PATHINFO_EXTENSION; /** * This source locator loads all php files from \FileSystemIterator */ class FileIteratorSourceLocator implements \PHPStan\BetterReflection\SourceLocator\Type\SourceLocator { /** * @var \PHPStan\BetterReflection\SourceLocator\Type\AggregateSourceLocator|null */ private $aggregateSourceLocator = null; /** @var Iterator<SplFileInfo> */ private $fileSystemIterator; /** * @var \PHPStan\BetterReflection\SourceLocator\Ast\Locator */ private $astLocator; /** * @param Iterator<SplFileInfo> $fileInfoIterator note: only SplFileInfo allowed in this iterator * * @throws InvalidFileInfo In case of iterator not contains only SplFileInfo. */ public function __construct(Iterator $fileInfoIterator, Locator $astLocator) { $this->astLocator = $astLocator; foreach ($fileInfoIterator as $fileInfo) { if (!$fileInfo instanceof SplFileInfo) { throw InvalidFileInfo::fromNonSplFileInfo($fileInfo); } } $this->fileSystemIterator = $fileInfoIterator; } /** @throws InvalidFileLocation */ private function getAggregatedSourceLocator() : \PHPStan\BetterReflection\SourceLocator\Type\AggregateSourceLocator { // @infection-ignore-all Coalesce: There's no difference, it's just optimization return $this->aggregateSourceLocator ?? ($this->aggregateSourceLocator = new \PHPStan\BetterReflection\SourceLocator\Type\AggregateSourceLocator(array_values(array_filter(array_map(function (SplFileInfo $item) : ?\PHPStan\BetterReflection\SourceLocator\Type\SingleFileSourceLocator { $realPath = $item->getRealPath(); if (!($item->isFile() && pathinfo($realPath, PATHINFO_EXTENSION) === 'php')) { return null; } return new \PHPStan\BetterReflection\SourceLocator\Type\SingleFileSourceLocator($realPath, $this->astLocator); }, iterator_to_array($this->fileSystemIterator)))))); } /** * {@inheritDoc} * * @throws InvalidFileLocation */ public function locateIdentifier(Reflector $reflector, Identifier $identifier) : ?\PHPStan\BetterReflection\Reflection\Reflection { return $this->getAggregatedSourceLocator()->locateIdentifier($reflector, $identifier); } /** * {@inheritDoc} * * @throws InvalidFileLocation */ public function locateIdentifiersByType(Reflector $reflector, IdentifierType $identifierType) : array { return $this->getAggregatedSourceLocator()->locateIdentifiersByType($reflector, $identifierType); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Type\Composer; use PHPStan\BetterReflection\Identifier\Identifier; use PHPStan\BetterReflection\Identifier\IdentifierType; use PHPStan\BetterReflection\Reflection\Reflection; use PHPStan\BetterReflection\Reflector\Exception\IdentifierNotFound; use PHPStan\BetterReflection\Reflector\Reflector; use PHPStan\BetterReflection\SourceLocator\Ast\Locator; use PHPStan\BetterReflection\SourceLocator\Exception\InvalidFileLocation; use PHPStan\BetterReflection\SourceLocator\FileChecker; use PHPStan\BetterReflection\SourceLocator\Located\LocatedSource; use PHPStan\BetterReflection\SourceLocator\Type\Composer\Psr\PsrAutoloaderMapping; use PHPStan\BetterReflection\SourceLocator\Type\DirectoriesSourceLocator; use PHPStan\BetterReflection\SourceLocator\Type\SourceLocator; use function file_get_contents; final class PsrAutoloaderLocator implements SourceLocator { /** * @var \PHPStan\BetterReflection\SourceLocator\Type\Composer\Psr\PsrAutoloaderMapping */ private $mapping; /** * @var \PHPStan\BetterReflection\SourceLocator\Ast\Locator */ private $astLocator; public function __construct(PsrAutoloaderMapping $mapping, Locator $astLocator) { $this->mapping = $mapping; $this->astLocator = $astLocator; } public function locateIdentifier(Reflector $reflector, Identifier $identifier) : ?\PHPStan\BetterReflection\Reflection\Reflection { /** @phpstan-var non-empty-string $file */ foreach ($this->mapping->resolvePossibleFilePaths($identifier) as $file) { try { FileChecker::assertReadableFile($file); return $this->astLocator->findReflection($reflector, new LocatedSource(file_get_contents($file), $identifier->getName(), $file), $identifier); } catch (InvalidFileLocation $exception) { // Ignore } catch (IdentifierNotFound $exception) { // on purpose - autoloading is allowed to fail, and silently-failing autoloaders are normal/endorsed } } return null; } /** * Find all identifiers of a type * * @return list<Reflection> */ public function locateIdentifiersByType(Reflector $reflector, IdentifierType $identifierType) : array { return (new DirectoriesSourceLocator($this->mapping->directories(), $this->astLocator))->locateIdentifiersByType($reflector, $identifierType); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Type\Composer\Factory; use PHPStan\BetterReflection\SourceLocator\Ast\Locator; use PHPStan\BetterReflection\SourceLocator\Type\AggregateSourceLocator; use PHPStan\BetterReflection\SourceLocator\Type\Composer\Factory\Exception\FailedToParseJson; use PHPStan\BetterReflection\SourceLocator\Type\Composer\Factory\Exception\InvalidProjectDirectory; use PHPStan\BetterReflection\SourceLocator\Type\Composer\Factory\Exception\MissingComposerJson; use PHPStan\BetterReflection\SourceLocator\Type\Composer\Factory\Exception\MissingInstalledJson; use PHPStan\BetterReflection\SourceLocator\Type\Composer\Psr\Psr0Mapping; use PHPStan\BetterReflection\SourceLocator\Type\Composer\Psr\Psr4Mapping; use PHPStan\BetterReflection\SourceLocator\Type\Composer\PsrAutoloaderLocator; use PHPStan\BetterReflection\SourceLocator\Type\DirectoriesSourceLocator; use PHPStan\BetterReflection\SourceLocator\Type\SingleFileSourceLocator; use PHPStan\BetterReflection\SourceLocator\Type\SourceLocator; use function array_filter; use function array_map; use function array_merge; use function array_merge_recursive; use function array_values; use function assert; use function file_get_contents; use function is_array; use function is_dir; use function is_file; use function is_string; use function json_decode; use function realpath; use function rtrim; /** * @psalm-import-type ComposerAutoload from MakeLocatorForComposerJson * @psalm-import-type ComposerPackage from MakeLocatorForComposerJson * @psalm-import-type Composer from MakeLocatorForComposerJson */ final class MakeLocatorForComposerJsonAndInstalledJson { public function __invoke(string $installationPath, Locator $astLocator) : SourceLocator { $realInstallationPath = (string) realpath($installationPath); if (!is_dir($realInstallationPath)) { throw InvalidProjectDirectory::atPath($installationPath); } $composerJsonPath = $realInstallationPath . '/composer.json'; if (!is_file($composerJsonPath)) { throw MissingComposerJson::inProjectPath($installationPath); } $composerJsonContent = file_get_contents($composerJsonPath); assert(is_string($composerJsonContent)); /** @psalm-var Composer|null $composer */ $composer = json_decode($composerJsonContent, \true); $vendorDir = $composer['config']['vendor-dir'] ?? 'vendor'; $vendorDir = rtrim($vendorDir, '/'); $installedJsonPath = $realInstallationPath . '/' . $vendorDir . '/composer/installed.json'; if (!is_file($installedJsonPath)) { throw MissingInstalledJson::inProjectPath($realInstallationPath . '/' . $vendorDir); } $jsonContent = file_get_contents($installedJsonPath); assert(is_string($jsonContent)); /** @psalm-var array{packages: list<mixed[]>}|list<mixed[]>|null $installedJson */ $installedJson = json_decode($jsonContent, \true); if (!is_array($composer)) { throw FailedToParseJson::inFile($composerJsonPath); } if (!is_array($installedJson)) { throw FailedToParseJson::inFile($installedJsonPath); } /** @psalm-var list<ComposerPackage> $installed */ $installed = $installedJson['packages'] ?? $installedJson; $classMapPaths = array_merge($this->prefixPaths($this->packageToClassMapPaths($composer), $realInstallationPath . '/'), ...array_map(function (array $package) use($realInstallationPath, $vendorDir) : array { return $this->prefixPaths($this->packageToClassMapPaths($package), $this->packagePrefixPath($realInstallationPath, $package, $vendorDir)); }, $installed)); $classMapFiles = array_filter($classMapPaths, 'is_file'); $classMapDirectories = array_values(array_filter($classMapPaths, 'is_dir')); $filePaths = array_merge($this->prefixPaths($this->packageToFilePaths($composer), $realInstallationPath . '/'), ...array_map(function (array $package) use($realInstallationPath, $vendorDir) : array { return $this->prefixPaths($this->packageToFilePaths($package), $this->packagePrefixPath($realInstallationPath, $package, $vendorDir)); }, $installed)); return new AggregateSourceLocator(array_merge([new PsrAutoloaderLocator(Psr4Mapping::fromArrayMappings(array_merge_recursive($this->prefixWithInstallationPath($this->packageToPsr4AutoloadNamespaces($composer), $realInstallationPath), ...array_map(function (array $package) use($realInstallationPath, $vendorDir) : array { return $this->prefixWithPackagePath($this->packageToPsr4AutoloadNamespaces($package), $realInstallationPath, $package, $vendorDir); }, $installed))), $astLocator), new PsrAutoloaderLocator(Psr0Mapping::fromArrayMappings(array_merge_recursive($this->prefixWithInstallationPath($this->packageToPsr0AutoloadNamespaces($composer), $realInstallationPath), ...array_map(function (array $package) use($realInstallationPath, $vendorDir) : array { return $this->prefixWithPackagePath($this->packageToPsr0AutoloadNamespaces($package), $realInstallationPath, $package, $vendorDir); }, $installed))), $astLocator), new DirectoriesSourceLocator($classMapDirectories, $astLocator)], ...array_map(static function (string $file) use($astLocator) : array { assert($file !== ''); return [new SingleFileSourceLocator($file, $astLocator)]; }, array_merge($classMapFiles, $filePaths)))); } /** * @param ComposerPackage|Composer $package * * @return array<string, list<string>> */ private function packageToPsr4AutoloadNamespaces(array $package) : array { return array_map(static function ($namespacePaths) : array { return (array) $namespacePaths; }, $package['autoload']['psr-4'] ?? []); } /** * @param ComposerPackage|Composer $package * * @return array<string, list<string>> */ private function packageToPsr0AutoloadNamespaces(array $package) : array { return array_map(static function ($namespacePaths) : array { return (array) $namespacePaths; }, $package['autoload']['psr-0'] ?? []); } /** * @param ComposerPackage|Composer $package * * @return list<string> */ private function packageToClassMapPaths(array $package) : array { return $package['autoload']['classmap'] ?? []; } /** * @param ComposerPackage|Composer $package * * @return list<string> */ private function packageToFilePaths(array $package) : array { return $package['autoload']['files'] ?? []; } /** @param ComposerPackage $package */ private function packagePrefixPath(string $trimmedInstallationPath, array $package, string $vendorDir) : string { return $trimmedInstallationPath . '/' . $vendorDir . '/' . $package['name'] . '/'; } /** * @param array<string, list<string>> $paths * @param ComposerPackage $package $package * * @return array<string, list<string>> */ private function prefixWithPackagePath(array $paths, string $trimmedInstallationPath, array $package, string $vendorDir) : array { $prefix = $this->packagePrefixPath($trimmedInstallationPath, $package, $vendorDir); return array_map(function (array $paths) use($prefix) : array { return $this->prefixPaths($paths, $prefix); }, $paths); } /** * @param array<string, list<string>> $paths * * @return array<string, list<string>> */ private function prefixWithInstallationPath(array $paths, string $trimmedInstallationPath) : array { return array_map(function (array $paths) use($trimmedInstallationPath) : array { return $this->prefixPaths($paths, $trimmedInstallationPath . '/'); }, $paths); } /** * @param list<string> $paths * * @return list<string> */ private function prefixPaths(array $paths, string $prefix) : array { return array_map(static function (string $path) use($prefix) : string { return $prefix . $path; }, $paths); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Type\Composer\Factory\Exception; use Throwable; interface Exception extends Throwable { } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Type\Composer\Factory\Exception; use UnexpectedValueException; use function sprintf; final class MissingComposerJson extends UnexpectedValueException implements \PHPStan\BetterReflection\SourceLocator\Type\Composer\Factory\Exception\Exception { public static function inProjectPath(string $path) : self { return new self(sprintf('Could not locate a "composer.json" file in "%s"', $path)); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Type\Composer\Factory\Exception; use UnexpectedValueException; use function sprintf; final class MissingInstalledJson extends UnexpectedValueException implements \PHPStan\BetterReflection\SourceLocator\Type\Composer\Factory\Exception\Exception { public static function inProjectPath(string $path) : self { return new self(sprintf('Could not locate a "composer/installed.json" file in "%s"', $path)); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Type\Composer\Factory\Exception; use UnexpectedValueException; use function sprintf; final class FailedToParseJson extends UnexpectedValueException implements \PHPStan\BetterReflection\SourceLocator\Type\Composer\Factory\Exception\Exception { public static function inFile(string $file) : self { return new self(sprintf('Could not parse JSON file "%s"', $file)); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Type\Composer\Factory\Exception; use InvalidArgumentException; use function sprintf; final class InvalidProjectDirectory extends InvalidArgumentException implements \PHPStan\BetterReflection\SourceLocator\Type\Composer\Factory\Exception\Exception { public static function atPath(string $path) : self { return new self(sprintf('Could not locate project directory "%s"', $path)); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Type\Composer\Factory; use PHPStan\BetterReflection\SourceLocator\Ast\Locator; use PHPStan\BetterReflection\SourceLocator\Type\AggregateSourceLocator; use PHPStan\BetterReflection\SourceLocator\Type\Composer\Factory\Exception\FailedToParseJson; use PHPStan\BetterReflection\SourceLocator\Type\Composer\Factory\Exception\InvalidProjectDirectory; use PHPStan\BetterReflection\SourceLocator\Type\Composer\Factory\Exception\MissingComposerJson; use PHPStan\BetterReflection\SourceLocator\Type\Composer\Psr\Psr0Mapping; use PHPStan\BetterReflection\SourceLocator\Type\Composer\Psr\Psr4Mapping; use PHPStan\BetterReflection\SourceLocator\Type\Composer\PsrAutoloaderLocator; use PHPStan\BetterReflection\SourceLocator\Type\DirectoriesSourceLocator; use PHPStan\BetterReflection\SourceLocator\Type\SingleFileSourceLocator; use PHPStan\BetterReflection\SourceLocator\Type\SourceLocator; use function array_filter; use function array_map; use function array_merge; use function array_values; use function assert; use function file_get_contents; use function is_array; use function is_dir; use function is_file; use function is_string; use function json_decode; use function realpath; /** * @psalm-type ComposerAutoload array{ * psr-0?: array<string, string|list<string>>, * psr-4?: array<string, string|list<string>>, * classmap?: list<string>, * files?: list<string>, * exclude-from-classmap?: list<string> * } * @psalm-type ComposerPackage array{ * name: string, * autoload: ComposerAutoload * } * @psalm-type Composer array{ * autoload: ComposerAutoload, * config?: array{vendor-dir?: string} * } */ final class MakeLocatorForComposerJson { public function __invoke(string $installationPath, Locator $astLocator) : SourceLocator { $realInstallationPath = (string) realpath($installationPath); if (!is_dir($realInstallationPath)) { throw InvalidProjectDirectory::atPath($installationPath); } $composerJsonPath = $realInstallationPath . '/composer.json'; if (!is_file($composerJsonPath)) { throw MissingComposerJson::inProjectPath($installationPath); } $composerJsonContent = file_get_contents($composerJsonPath); assert(is_string($composerJsonContent)); /** @psalm-var array{autoload: ComposerAutoload}|null $composer */ $composer = json_decode($composerJsonContent, \true); if (!is_array($composer)) { throw FailedToParseJson::inFile($composerJsonPath); } $pathPrefix = $realInstallationPath . '/'; $classMapPaths = $this->prefixPaths($this->packageToClassMapPaths($composer), $pathPrefix); $classMapFiles = array_filter($classMapPaths, 'is_file'); $classMapDirectories = array_values(array_filter($classMapPaths, 'is_dir')); $filePaths = $this->prefixPaths($this->packageToFilePaths($composer), $pathPrefix); return new AggregateSourceLocator(array_merge([new PsrAutoloaderLocator(Psr4Mapping::fromArrayMappings($this->prefixWithInstallationPath($this->packageToPsr4AutoloadNamespaces($composer), $pathPrefix)), $astLocator), new PsrAutoloaderLocator(Psr0Mapping::fromArrayMappings($this->prefixWithInstallationPath($this->packageToPsr0AutoloadNamespaces($composer), $pathPrefix)), $astLocator), new DirectoriesSourceLocator($classMapDirectories, $astLocator)], ...array_map(static function (string $file) use($astLocator) : array { assert($file !== ''); return [new SingleFileSourceLocator($file, $astLocator)]; }, array_merge($classMapFiles, $filePaths)))); } /** * @param array{autoload: ComposerAutoload} $package * * @return array<string, list<string>> */ private function packageToPsr4AutoloadNamespaces(array $package) : array { return array_map(static function ($namespacePaths) : array { return (array) $namespacePaths; }, $package['autoload']['psr-4'] ?? []); } /** * @param array{autoload: ComposerAutoload} $package * * @return array<string, list<string>> */ private function packageToPsr0AutoloadNamespaces(array $package) : array { return array_map(static function ($namespacePaths) : array { return (array) $namespacePaths; }, $package['autoload']['psr-0'] ?? []); } /** * @param array{autoload: ComposerAutoload} $package * * @return list<string> */ private function packageToClassMapPaths(array $package) : array { return $package['autoload']['classmap'] ?? []; } /** * @param array{autoload: ComposerAutoload} $package * * @return list<string> */ private function packageToFilePaths(array $package) : array { return $package['autoload']['files'] ?? []; } /** * @param array<string, list<string>> $paths * * @return array<string, list<string>> */ private function prefixWithInstallationPath(array $paths, string $trimmedInstallationPath) : array { return array_map(function (array $paths) use($trimmedInstallationPath) : array { return $this->prefixPaths($paths, $trimmedInstallationPath); }, $paths); } /** * @param list<string> $paths * * @return list<string> */ private function prefixPaths(array $paths, string $prefix) : array { return array_map(static function (string $path) use($prefix) : string { return $prefix . $path; }, $paths); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Type\Composer\Factory; use PHPStan\BetterReflection\SourceLocator\Ast\Locator; use PHPStan\BetterReflection\SourceLocator\Type\AggregateSourceLocator; use PHPStan\BetterReflection\SourceLocator\Type\Composer\Factory\Exception\FailedToParseJson; use PHPStan\BetterReflection\SourceLocator\Type\Composer\Factory\Exception\InvalidProjectDirectory; use PHPStan\BetterReflection\SourceLocator\Type\Composer\Factory\Exception\MissingComposerJson; use PHPStan\BetterReflection\SourceLocator\Type\Composer\Factory\Exception\MissingInstalledJson; use PHPStan\BetterReflection\SourceLocator\Type\Composer\Psr\Psr0Mapping; use PHPStan\BetterReflection\SourceLocator\Type\Composer\Psr\Psr4Mapping; use PHPStan\BetterReflection\SourceLocator\Type\Composer\PsrAutoloaderLocator; use PHPStan\BetterReflection\SourceLocator\Type\DirectoriesSourceLocator; use PHPStan\BetterReflection\SourceLocator\Type\SingleFileSourceLocator; use PHPStan\BetterReflection\SourceLocator\Type\SourceLocator; use function array_filter; use function array_map; use function array_merge; use function array_merge_recursive; use function array_values; use function assert; use function file_get_contents; use function is_array; use function is_dir; use function is_file; use function is_string; use function json_decode; use function realpath; use function rtrim; /** * @psalm-import-type ComposerAutoload from MakeLocatorForComposerJson * @psalm-import-type ComposerPackage from MakeLocatorForComposerJson * @psalm-import-type Composer from MakeLocatorForComposerJson */ final class MakeLocatorForInstalledJson { public function __invoke(string $installationPath, Locator $astLocator) : SourceLocator { $realInstallationPath = (string) realpath($installationPath); if (!is_dir($realInstallationPath)) { throw InvalidProjectDirectory::atPath($installationPath); } $composerJsonPath = $realInstallationPath . '/composer.json'; if (!is_file($composerJsonPath)) { throw MissingComposerJson::inProjectPath($installationPath); } $composerJsonContent = file_get_contents($composerJsonPath); assert(is_string($composerJsonContent)); /** @psalm-var Composer|null $composer */ $composer = json_decode($composerJsonContent, \true); $vendorDir = $composer['config']['vendor-dir'] ?? 'vendor'; $vendorDir = rtrim($vendorDir, '/'); $installedJsonPath = $realInstallationPath . '/' . $vendorDir . '/composer/installed.json'; if (!is_file($installedJsonPath)) { throw MissingInstalledJson::inProjectPath($realInstallationPath . '/' . $vendorDir); } $jsonContent = file_get_contents($installedJsonPath); assert(is_string($jsonContent)); /** @var array{packages: list<mixed[]>}|list<mixed[]>|null $installedJson */ $installedJson = json_decode($jsonContent, \true); if (!is_array($installedJson)) { throw FailedToParseJson::inFile($installedJsonPath); } /** @psalm-var list<ComposerPackage> $installed */ $installed = $installedJson['packages'] ?? $installedJson; $classMapPaths = array_merge([], ...array_map(function (array $package) use($realInstallationPath, $vendorDir) : array { return $this->prefixPaths($this->packageToClassMapPaths($package), $this->packagePrefixPath($realInstallationPath, $package, $vendorDir)); }, $installed)); $classMapFiles = array_filter($classMapPaths, 'is_file'); $classMapDirectories = array_values(array_filter($classMapPaths, 'is_dir')); $filePaths = array_merge([], ...array_map(function (array $package) use($realInstallationPath, $vendorDir) : array { return $this->prefixPaths($this->packageToFilePaths($package), $this->packagePrefixPath($realInstallationPath, $package, $vendorDir)); }, $installed)); return new AggregateSourceLocator(array_merge([new PsrAutoloaderLocator(Psr4Mapping::fromArrayMappings(array_merge_recursive([], ...array_map(function (array $package) use($realInstallationPath, $vendorDir) : array { return $this->prefixWithPackagePath($this->packageToPsr4AutoloadNamespaces($package), $realInstallationPath, $package, $vendorDir); }, $installed))), $astLocator), new PsrAutoloaderLocator(Psr0Mapping::fromArrayMappings(array_merge_recursive([], ...array_map(function (array $package) use($realInstallationPath, $vendorDir) : array { return $this->prefixWithPackagePath($this->packageToPsr0AutoloadNamespaces($package), $realInstallationPath, $package, $vendorDir); }, $installed))), $astLocator), new DirectoriesSourceLocator($classMapDirectories, $astLocator)], ...array_map(static function (string $file) use($astLocator) : array { assert($file !== ''); return [new SingleFileSourceLocator($file, $astLocator)]; }, array_merge($classMapFiles, $filePaths)))); } /** * @param ComposerPackage $package * * @return array<string, list<string>> */ private function packageToPsr4AutoloadNamespaces(array $package) : array { return array_map(static function ($namespacePaths) : array { return (array) $namespacePaths; }, $package['autoload']['psr-4'] ?? []); } /** * @param ComposerPackage $package * * @return array<string, list<string>> */ private function packageToPsr0AutoloadNamespaces(array $package) : array { return array_map(static function ($namespacePaths) : array { return (array) $namespacePaths; }, $package['autoload']['psr-0'] ?? []); } /** * @param ComposerPackage $package * * @return list<string> */ private function packageToClassMapPaths(array $package) : array { return $package['autoload']['classmap'] ?? []; } /** * @param ComposerPackage $package * * @return list<string> */ private function packageToFilePaths(array $package) : array { return $package['autoload']['files'] ?? []; } /** @param ComposerPackage $package */ private function packagePrefixPath(string $trimmedInstallationPath, array $package, string $vendorDir) : string { return $trimmedInstallationPath . '/' . $vendorDir . '/' . $package['name'] . '/'; } /** * @param array<int|string, array<string>> $paths * @param ComposerPackage $package * * @return array<int|string, string|array<string>> */ private function prefixWithPackagePath(array $paths, string $trimmedInstallationPath, array $package, string $vendorDir) : array { $prefix = $this->packagePrefixPath($trimmedInstallationPath, $package, $vendorDir); return array_map(function (array $paths) use($prefix) : array { return $this->prefixPaths($paths, $prefix); }, $paths); } /** * @param array<int|string, string> $paths * * @return array<int|string, string> */ private function prefixPaths(array $paths, string $prefix) : array { return array_map(static function (string $path) use($prefix) : string { return $prefix . $path; }, $paths); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Type\Composer\Psr\Exception; use Throwable; interface Exception extends Throwable { } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Type\Composer\Psr\Exception; use InvalidArgumentException; use function sprintf; class InvalidPrefixMapping extends InvalidArgumentException implements \PHPStan\BetterReflection\SourceLocator\Type\Composer\Psr\Exception\Exception { public static function emptyPrefixGiven() : self { return new self('An invalid empty string provided as a PSR mapping prefix'); } public static function emptyPrefixMappingGiven(string $prefix) : self { return new self(sprintf('An invalid empty list of paths was provided for PSR mapping prefix "%s"', $prefix)); } public static function prefixMappingIsNotADirectory(string $prefix, string $path) : self { return new self(sprintf('Provided path "%s" for prefix "%s" is not a directory', $prefix, $path)); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Type\Composer\Psr; use PHPStan\BetterReflection\Identifier\Identifier; use function array_filter; use function array_keys; use function array_map; use function array_merge; use function array_unique; use function array_values; use function ltrim; use function rtrim; use function str_replace; use function strlen; use function strpos; use function substr; use const ARRAY_FILTER_USE_KEY; final class Psr4Mapping implements \PHPStan\BetterReflection\SourceLocator\Type\Composer\Psr\PsrAutoloaderMapping { /** @var array<string, list<string>> */ private $mappings = []; private function __construct() { } /** @param array<string, list<string>> $mappings */ public static function fromArrayMappings(array $mappings) : self { $instance = new self(); $instance->mappings = array_map(static function (array $directories) : array { return array_map(static function (string $directory) : string { return rtrim($directory, '/'); }, $directories); }, $mappings); return $instance; } /** {@inheritDoc} */ public function resolvePossibleFilePaths(Identifier $identifier) : array { if (!$identifier->isClass()) { return []; } $className = $identifier->getName(); $matchingPrefixes = $this->matchingPrefixes($className); return array_values(array_filter(array_merge([], ...array_map(static function (array $paths, string $prefix) use($className) : array { $subPath = ltrim(str_replace('\\', '/', substr($className, strlen($prefix))), '/'); if ($subPath === '') { return []; } return array_map(static function (string $path) use($subPath) : string { return $path . '/' . $subPath . '.php'; }, $paths); }, $matchingPrefixes, array_keys($matchingPrefixes))))); } /** @return array<string, list<string>> */ private function matchingPrefixes(string $className) : array { return array_filter($this->mappings, static function (string $prefix) use($className) : bool { if ($prefix === '') { return \false; } return strpos($className, $prefix) === 0; }, ARRAY_FILTER_USE_KEY); } /** {@inheritDoc} */ public function directories() : array { return array_values(array_unique(array_merge([], ...array_values($this->mappings)))); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Type\Composer\Psr; use PHPStan\BetterReflection\Identifier\Identifier; interface PsrAutoloaderMapping { /** @return list<string> */ public function resolvePossibleFilePaths(Identifier $identifier) : array; /** @return list<string> */ public function directories() : array; } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Type\Composer\Psr; use PHPStan\BetterReflection\Identifier\Identifier; use function array_map; use function array_merge; use function array_unique; use function array_values; use function rtrim; use function str_replace; use function strpos; final class Psr0Mapping implements \PHPStan\BetterReflection\SourceLocator\Type\Composer\Psr\PsrAutoloaderMapping { /** @var array<string, list<string>> */ private $mappings = []; private function __construct() { } /** @param array<string, list<string>> $mappings */ public static function fromArrayMappings(array $mappings) : self { $instance = new self(); $instance->mappings = array_map(static function (array $directories) : array { return array_map(static function (string $directory) : string { return rtrim($directory, '/'); }, $directories); }, $mappings); return $instance; } /** {@inheritDoc} */ public function resolvePossibleFilePaths(Identifier $identifier) : array { if (!$identifier->isClass()) { return []; } $className = $identifier->getName(); foreach ($this->mappings as $prefix => $paths) { if ($prefix === '') { continue; } if (strpos($className, $prefix) === 0) { return array_map(static function (string $path) use($className) : string { return $path . '/' . str_replace(['\\', '_'], '/', $className) . '.php'; }, $paths); } } return []; } /** {@inheritDoc} */ public function directories() : array { return array_values(array_unique(array_merge([], ...array_values($this->mappings)))); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Type; use InvalidArgumentException; use PHPStan\BetterReflection\Identifier\Identifier; use PHPStan\BetterReflection\SourceLocator\Ast\Locator; use PHPStan\BetterReflection\SourceLocator\Exception\InvalidFileLocation; use PHPStan\BetterReflection\SourceLocator\Located\InternalLocatedSource; use PHPStan\BetterReflection\SourceLocator\Located\LocatedSource; use PHPStan\BetterReflection\SourceLocator\SourceStubber\SourceStubber; use PHPStan\BetterReflection\SourceLocator\SourceStubber\StubData; final class PhpInternalSourceLocator extends \PHPStan\BetterReflection\SourceLocator\Type\AbstractSourceLocator { /** * @var \PHPStan\BetterReflection\SourceLocator\SourceStubber\SourceStubber */ private $stubber; public function __construct(Locator $astLocator, SourceStubber $stubber) { $this->stubber = $stubber; parent::__construct($astLocator); } /** * {@inheritDoc} * * @throws InvalidArgumentException * @throws InvalidFileLocation */ protected function createLocatedSource(Identifier $identifier) : ?\PHPStan\BetterReflection\SourceLocator\Located\LocatedSource { return $this->getClassSource($identifier) ?? $this->getFunctionSource($identifier) ?? $this->getConstantSource($identifier); } private function getClassSource(Identifier $identifier) : ?\PHPStan\BetterReflection\SourceLocator\Located\InternalLocatedSource { if (!$identifier->isClass()) { return null; } /** @psalm-var class-string|trait-string $className */ $className = $identifier->getName(); return $this->createLocatedSourceFromStubData($identifier, $this->stubber->generateClassStub($className)); } private function getFunctionSource(Identifier $identifier) : ?\PHPStan\BetterReflection\SourceLocator\Located\InternalLocatedSource { if (!$identifier->isFunction()) { return null; } return $this->createLocatedSourceFromStubData($identifier, $this->stubber->generateFunctionStub($identifier->getName())); } private function getConstantSource(Identifier $identifier) : ?\PHPStan\BetterReflection\SourceLocator\Located\InternalLocatedSource { if (!$identifier->isConstant()) { return null; } return $this->createLocatedSourceFromStubData($identifier, $this->stubber->generateConstantStub($identifier->getName())); } private function createLocatedSourceFromStubData(Identifier $identifier, ?\PHPStan\BetterReflection\SourceLocator\SourceStubber\StubData $stubData) : ?\PHPStan\BetterReflection\SourceLocator\Located\InternalLocatedSource { if ($stubData === null) { return null; } $extensionName = $stubData->getExtensionName(); if ($extensionName === null) { // Not internal return null; } return new InternalLocatedSource($stubData->getStub(), $identifier->getName(), $extensionName, $stubData->getFileName()); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Type; use InvalidArgumentException; use PHPStan\BetterReflection\Identifier\Identifier; use PHPStan\BetterReflection\SourceLocator\Ast\Locator; use PHPStan\BetterReflection\SourceLocator\Exception\InvalidFileLocation; use PHPStan\BetterReflection\SourceLocator\Located\LocatedSource; /** * This source locator simply parses the string given in the constructor as * valid PHP. * * Note that this source locator does NOT specify a filename, because we did * not load it from a file, so it will be null if you use this locator. */ class StringSourceLocator extends \PHPStan\BetterReflection\SourceLocator\Type\AbstractSourceLocator { /** * @var non-empty-string */ private $source; /** @param non-empty-string $source */ public function __construct(string $source, Locator $astLocator) { $this->source = $source; parent::__construct($astLocator); } /** * {@inheritDoc} * * @throws InvalidArgumentException * @throws InvalidFileLocation */ protected function createLocatedSource(Identifier $identifier) : ?\PHPStan\BetterReflection\SourceLocator\Located\LocatedSource { return new LocatedSource($this->source, $identifier->getName(), null); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Type; use RecursiveDirectoryIterator; use RecursiveIteratorIterator; use PHPStan\BetterReflection\Identifier\Identifier; use PHPStan\BetterReflection\Identifier\IdentifierType; use PHPStan\BetterReflection\Reflection\Reflection; use PHPStan\BetterReflection\Reflector\Reflector; use PHPStan\BetterReflection\SourceLocator\Ast\Locator; use PHPStan\BetterReflection\SourceLocator\Exception\InvalidDirectory; use PHPStan\BetterReflection\SourceLocator\Exception\InvalidFileInfo; use function array_map; use function is_dir; /** * This source locator recursively loads all php files in an entire directory or multiple directories. */ class DirectoriesSourceLocator implements \PHPStan\BetterReflection\SourceLocator\Type\SourceLocator { /** * @var \PHPStan\BetterReflection\SourceLocator\Type\AggregateSourceLocator */ private $aggregateSourceLocator; /** * @param list<string> $directories directories to scan * * @throws InvalidDirectory * @throws InvalidFileInfo */ public function __construct(array $directories, Locator $astLocator) { $this->aggregateSourceLocator = new \PHPStan\BetterReflection\SourceLocator\Type\AggregateSourceLocator(array_map(static function (string $directory) use($astLocator) : \PHPStan\BetterReflection\SourceLocator\Type\FileIteratorSourceLocator { if (!is_dir($directory)) { throw InvalidDirectory::fromNonDirectory($directory); } return new \PHPStan\BetterReflection\SourceLocator\Type\FileIteratorSourceLocator(new RecursiveIteratorIterator(new RecursiveDirectoryIterator($directory, RecursiveDirectoryIterator::SKIP_DOTS)), $astLocator); }, $directories)); } public function locateIdentifier(Reflector $reflector, Identifier $identifier) : ?\PHPStan\BetterReflection\Reflection\Reflection { return $this->aggregateSourceLocator->locateIdentifier($reflector, $identifier); } /** * {@inheritDoc} */ public function locateIdentifiersByType(Reflector $reflector, IdentifierType $identifierType) : array { return $this->aggregateSourceLocator->locateIdentifiersByType($reflector, $identifierType); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Type; use InvalidArgumentException; use PhpParser\Node; use PhpParser\NodeTraverser; use PhpParser\NodeVisitor\NameResolver; use PhpParser\NodeVisitorAbstract; use PhpParser\Parser; use ReflectionClass; use ReflectionException; use ReflectionFunction; use PHPStan\BetterReflection\BetterReflection; use PHPStan\BetterReflection\Identifier\Identifier; use PHPStan\BetterReflection\Reflection\Exception\InvalidConstantNode; use PHPStan\BetterReflection\SourceLocator\Ast\Locator as AstLocator; use PHPStan\BetterReflection\SourceLocator\Exception\InvalidFileLocation; use PHPStan\BetterReflection\SourceLocator\FileChecker; use PHPStan\BetterReflection\SourceLocator\Located\AliasLocatedSource; use PHPStan\BetterReflection\SourceLocator\Located\LocatedSource; use PHPStan\BetterReflection\SourceLocator\Type\AutoloadSourceLocator\FileReadTrapStreamWrapper; use PHPStan\BetterReflection\Util\ClassExistenceChecker; use PHPStan\BetterReflection\Util\ConstantNodeChecker; use function array_key_exists; use function array_reverse; use function assert; use function defined; use function file_get_contents; use function function_exists; use function get_defined_constants; use function get_included_files; use function is_file; use function is_string; use function restore_error_handler; use function set_error_handler; use function spl_autoload_functions; use function strtolower; /** * Use PHP's built in autoloader to locate a class, without actually loading. * * There are some prerequisites... * - we expect the autoloader to load classes from a file (i.e. using require/include) * - your autoloader of choice does not replace stream wrappers */ class AutoloadSourceLocator extends \PHPStan\BetterReflection\SourceLocator\Type\AbstractSourceLocator { /** * @var \PhpParser\Parser */ private $phpParser; /** * @var \PhpParser\NodeTraverser */ private $nodeTraverser; /** * @var \PhpParser\NodeVisitorAbstract */ private $constantVisitor; public function __construct($astLocator = null, ?\PhpParser\Parser $phpParser = null) { $betterReflection = new BetterReflection(); parent::__construct($astLocator ?? $betterReflection->astLocator()); $this->phpParser = $phpParser ?? $betterReflection->phpParser(); $this->constantVisitor = $this->createConstantVisitor(); $this->nodeTraverser = new NodeTraverser(); $this->nodeTraverser->addVisitor(new NameResolver()); $this->nodeTraverser->addVisitor($this->constantVisitor); } /** * {@inheritDoc} * * @throws InvalidArgumentException * @throws InvalidFileLocation */ protected function createLocatedSource(Identifier $identifier) : ?\PHPStan\BetterReflection\SourceLocator\Located\LocatedSource { $locatedData = $this->attemptAutoloadForIdentifier($identifier); if ($locatedData === null) { return null; } if (!is_file($locatedData['fileName'])) { return null; } if (strtolower($identifier->getName()) !== strtolower($locatedData['name'])) { return new AliasLocatedSource(file_get_contents($locatedData['fileName']), $locatedData['name'], $locatedData['fileName'], $identifier->getName()); } return new LocatedSource(file_get_contents($locatedData['fileName']), $identifier->getName(), $locatedData['fileName']); } /** * Attempts to locate the specified identifier. * * @return array{fileName: string, name: string}|null * * @throws ReflectionException */ private function attemptAutoloadForIdentifier(Identifier $identifier) : ?array { if ($identifier->isClass()) { return $this->locateClassByName($identifier->getName()); } if ($identifier->isFunction()) { return $this->locateFunctionByName($identifier->getName()); } if ($identifier->isConstant()) { return $this->locateConstantByName($identifier->getName()); } return null; } /** * Attempt to locate a class by name. * * If class already exists, simply use internal reflection API to get the * filename and store it. * * If class does not exist, we make an assumption that whatever autoloaders * that are registered will be loading a file. We then override the file:// * protocol stream wrapper to "capture" the filename we expect the class to * be in, and then restore it. Note that class_exists will cause an error * that it cannot find the file, so we squelch the errors by overriding the * error handler temporarily. * * Note: the following code is designed so that the first hit on an actual * **file** leads to a path being resolved. No actual autoloading nor * file reading should happen, and most certainly no other classes * should exist after execution. The only filesystem access is to * check whether the file exists. * * @return array{fileName: string, name: string}|null * * @throws ReflectionException */ private function locateClassByName(string $className) : ?array { if (ClassExistenceChecker::exists($className, \false)) { $classReflection = new ReflectionClass($className); $filename = $classReflection->getFileName(); if (!is_string($filename)) { return null; } return ['fileName' => $filename, 'name' => $classReflection->getName()]; } $this->silenceErrors(); try { $locatedFile = FileReadTrapStreamWrapper::withStreamWrapperOverride(static function () use($className) : ?string { foreach (spl_autoload_functions() as $preExistingAutoloader) { $preExistingAutoloader($className); /** * This static variable is populated by the side-effect of the stream wrapper * trying to read the file path when `include()` is used by an autoloader. * * This will not be `null` when the autoloader tried to read a file. */ if (FileReadTrapStreamWrapper::$autoloadLocatedFile !== null) { return FileReadTrapStreamWrapper::$autoloadLocatedFile; } } return null; }); if ($locatedFile === null) { return null; } return ['fileName' => $locatedFile, 'name' => $className]; } finally { restore_error_handler(); } } private function silenceErrors() : void { set_error_handler(static function () : bool { return \true; }); } /** * We can only load functions if they already exist, because PHP does not * have function autoloading. Therefore if it exists, we simply use the * internal reflection API to find the filename. If it doesn't we can do * nothing so throw an exception. * * @return array{fileName: string, name: string}|null * * @throws ReflectionException */ private function locateFunctionByName(string $functionName) : ?array { if (!function_exists($functionName)) { return null; } $reflectionFileName = (new ReflectionFunction($functionName))->getFileName(); if (!is_string($reflectionFileName)) { return null; } return ['fileName' => $reflectionFileName, 'name' => $functionName]; } /** * We can only load constants if they already exist, because PHP does not * have constant autoloading. Therefore if it exists, we simply use brute force * to search throughout all included files to find the right filename. * * @return array{fileName: string, name: string}|null */ private function locateConstantByName(string $constantName) : ?array { if (!defined($constantName)) { return null; } /** @var array<string, array<string, scalar|list<scalar>|resource|null>> $constants */ $constants = get_defined_constants(\true); if (!array_key_exists($constantName, $constants['user'])) { return null; } /** @psalm-suppress UndefinedMethod */ $this->constantVisitor->setConstantName($constantName); $constantFileName = null; // Note: looking at files in reverse order, since newer files are more likely to have // defined a constant that is being looked up. Earlier files are possibly related // to libraries/frameworks that we rely upon. // @infection-ignore-all UnwrapArrayReverse: Ignore because the result is some with or without array_reverse() /** @phpstan-var non-empty-string $includedFileName */ foreach (array_reverse(get_included_files()) as $includedFileName) { try { FileChecker::assertReadableFile($includedFileName); } catch (InvalidFileLocation $exception) { continue; } /** @var list<Node\Stmt> $ast */ $ast = $this->phpParser->parse(file_get_contents($includedFileName)); $this->nodeTraverser->traverse($ast); /** @psalm-suppress UndefinedMethod */ if ($this->constantVisitor->getNode() !== null) { $constantFileName = $includedFileName; break; } } if ($constantFileName === null) { return null; } return ['fileName' => $constantFileName, 'name' => $constantName]; } private function createConstantVisitor() : NodeVisitorAbstract { return new class extends NodeVisitorAbstract { /** * @var string|null */ private $constantName = null; /** * @var \PhpParser\Node\Stmt\Const_|\PhpParser\Node\Expr\FuncCall|null */ private $node = null; public function enterNode(Node $node) : ?int { if ($node instanceof Node\Stmt\Const_) { foreach ($node->consts as $constNode) { if ((($constNodeNamespacedName = $constNode->namespacedName) ? $constNodeNamespacedName->toString() : null) === $this->constantName) { $this->node = $node; return NodeTraverser::STOP_TRAVERSAL; } } return NodeTraverser::DONT_TRAVERSE_CHILDREN; } if ($node instanceof Node\Expr\FuncCall) { try { ConstantNodeChecker::assertValidDefineFunctionCall($node); } catch (InvalidConstantNode $exception) { return null; } $argumentNameNode = $node->args[0]; assert($argumentNameNode instanceof Node\Arg); $nameNode = $argumentNameNode->value; assert($nameNode instanceof Node\Scalar\String_); if ($nameNode->value === $this->constantName) { $this->node = $node; return NodeTraverser::STOP_TRAVERSAL; } } return null; } public function setConstantName(string $constantName) : void { $this->constantName = $constantName; } /** @return Node\Stmt\Const_|Node\Expr\FuncCall|null */ public function getNode() { return $this->node; } }; } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Type; use Closure; use PhpParser\Node; use PhpParser\Node\Stmt\Namespace_; use PhpParser\NodeTraverser; use PhpParser\NodeVisitor\NameResolver; use PhpParser\NodeVisitorAbstract; use PhpParser\Parser; use ReflectionFunction as CoreFunctionReflection; use PHPStan\BetterReflection\Identifier\Identifier; use PHPStan\BetterReflection\Identifier\IdentifierType; use PHPStan\BetterReflection\Reflection\Reflection; use PHPStan\BetterReflection\Reflection\ReflectionFunction; use PHPStan\BetterReflection\Reflector\Reflector; use PHPStan\BetterReflection\SourceLocator\Ast\Exception\ParseToAstFailure; use PHPStan\BetterReflection\SourceLocator\Ast\Strategy\NodeToReflection; use PHPStan\BetterReflection\SourceLocator\Exception\EvaledClosureCannotBeLocated; use PHPStan\BetterReflection\SourceLocator\Exception\NoClosureOnLine; use PHPStan\BetterReflection\SourceLocator\Exception\TwoClosuresOnSameLine; use PHPStan\BetterReflection\SourceLocator\FileChecker; use PHPStan\BetterReflection\SourceLocator\Located\AnonymousLocatedSource; use PHPStan\BetterReflection\Util\FileHelper; use function array_filter; use function assert; use function file_get_contents; use function strpos; /** @internal */ final class ClosureSourceLocator implements \PHPStan\BetterReflection\SourceLocator\Type\SourceLocator { /** * @var CoreFunctionReflection */ private $coreFunctionReflection; /** * @var \PhpParser\Parser */ private $parser; public function __construct(Closure $closure, Parser $parser) { $this->parser = $parser; $this->coreFunctionReflection = new CoreFunctionReflection($closure); } /** * {@inheritDoc} * * @throws ParseToAstFailure */ public function locateIdentifier(Reflector $reflector, Identifier $identifier) : ?\PHPStan\BetterReflection\Reflection\Reflection { return $this->getReflectionFunction($reflector, $identifier->getType()); } /** * {@inheritDoc} * * @throws ParseToAstFailure */ public function locateIdentifiersByType(Reflector $reflector, IdentifierType $identifierType) : array { return array_filter([$this->getReflectionFunction($reflector, $identifierType)]); } private function getReflectionFunction(Reflector $reflector, IdentifierType $identifierType) : ?\PHPStan\BetterReflection\Reflection\ReflectionFunction { if (!$identifierType->isFunction()) { return null; } /** @phpstan-var non-empty-string $fileName */ $fileName = $this->coreFunctionReflection->getFileName(); if (strpos($fileName, 'eval()\'d code') !== \false) { throw EvaledClosureCannotBeLocated::create(); } FileChecker::assertReadableFile($fileName); $fileName = FileHelper::normalizeWindowsPath($fileName); $nodeVisitor = new class($fileName, $this->coreFunctionReflection->getStartLine()) extends NodeVisitorAbstract { /** @var list<array{node: Node\Expr\Closure|Node\Expr\ArrowFunction, namespace: Namespace_|null}> */ private $closureNodes = []; /** * @var \PhpParser\Node\Stmt\Namespace_|null */ private $currentNamespace = null; /** * @var string */ private $fileName; /** * @var int */ private $startLine; public function __construct(string $fileName, int $startLine) { $this->fileName = $fileName; $this->startLine = $startLine; } /** * {@inheritDoc} */ public function enterNode(Node $node) { if ($node instanceof Namespace_) { $this->currentNamespace = $node; return null; } if ($node->getStartLine() === $this->startLine && ($node instanceof Node\Expr\Closure || $node instanceof Node\Expr\ArrowFunction)) { $this->closureNodes[] = ['node' => $node, 'namespace' => $this->currentNamespace]; } return null; } /** * {@inheritDoc} */ public function leaveNode(Node $node) { if (!$node instanceof Namespace_) { return null; } $this->currentNamespace = null; return null; } /** * @return array{node: Node\Expr\Closure|Node\Expr\ArrowFunction, namespace: Namespace_|null} * * @throws NoClosureOnLine * @throws TwoClosuresOnSameLine */ public function getClosureNodes() : array { if ($this->closureNodes === []) { throw NoClosureOnLine::create($this->fileName, $this->startLine); } if (isset($this->closureNodes[1])) { throw TwoClosuresOnSameLine::create($this->fileName, $this->startLine); } return $this->closureNodes[0]; } }; $fileContents = file_get_contents($fileName); /** @var list<Node\Stmt> $ast */ $ast = $this->parser->parse($fileContents); $nodeTraverser = new NodeTraverser(); $nodeTraverser->addVisitor(new NameResolver()); $nodeTraverser->addVisitor($nodeVisitor); $nodeTraverser->traverse($ast); $closureNodes = $nodeVisitor->getClosureNodes(); $reflectionFunction = (new NodeToReflection())->__invoke($reflector, $closureNodes['node'], new AnonymousLocatedSource($fileContents, $fileName), $closureNodes['namespace']); assert($reflectionFunction instanceof ReflectionFunction); return $reflectionFunction; } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Type; use Composer\Autoload\ClassLoader; use InvalidArgumentException; use PHPStan\BetterReflection\Identifier\Identifier; use PHPStan\BetterReflection\Identifier\IdentifierType; use PHPStan\BetterReflection\SourceLocator\Ast\Locator; use PHPStan\BetterReflection\SourceLocator\Exception\InvalidFileLocation; use PHPStan\BetterReflection\SourceLocator\Located\LocatedSource; use function file_get_contents; /** * This source locator uses Composer's built-in ClassLoader to locate files. * * Note that we use ClassLoader->findFile directory, rather than * ClassLoader->loadClass because this library has a strict requirement that we * do NOT actually load the classes */ class ComposerSourceLocator extends \PHPStan\BetterReflection\SourceLocator\Type\AbstractSourceLocator { /** * @var \Composer\Autoload\ClassLoader */ private $classLoader; public function __construct(ClassLoader $classLoader, Locator $astLocator) { $this->classLoader = $classLoader; parent::__construct($astLocator); } /** * {@inheritDoc} * * @throws InvalidArgumentException * @throws InvalidFileLocation */ protected function createLocatedSource(Identifier $identifier) : ?\PHPStan\BetterReflection\SourceLocator\Located\LocatedSource { if ($identifier->getType()->getName() !== IdentifierType::IDENTIFIER_CLASS) { return null; } $filename = $this->classLoader->findFile($identifier->getName()); if ($filename === \false) { return null; } return new LocatedSource(file_get_contents($filename), $identifier->getName(), $filename); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Type; use PHPStan\BetterReflection\Identifier\Identifier; use PHPStan\BetterReflection\Identifier\IdentifierType; use PHPStan\BetterReflection\Reflection\Reflection; use PHPStan\BetterReflection\Reflector\Exception\IdentifierNotFound; use PHPStan\BetterReflection\Reflector\Reflector; use PHPStan\BetterReflection\SourceLocator\Ast\Exception\ParseToAstFailure; use PHPStan\BetterReflection\SourceLocator\Ast\Locator as AstLocator; use PHPStan\BetterReflection\SourceLocator\Located\LocatedSource; abstract class AbstractSourceLocator implements \PHPStan\BetterReflection\SourceLocator\Type\SourceLocator { /** * @var AstLocator */ private $astLocator; /** * Children should implement this method and return a LocatedSource object * which contains the source and the file from which it was located. * * @example * return new LocatedSource(['<?php class Foo {}', null]); * return new LocatedSource([\file_get_contents('Foo.php'), 'Foo.php']); */ protected abstract function createLocatedSource(Identifier $identifier) : ?\PHPStan\BetterReflection\SourceLocator\Located\LocatedSource; public function __construct(AstLocator $astLocator) { $this->astLocator = $astLocator; } /** * {@inheritDoc} * * @throws ParseToAstFailure */ public function locateIdentifier(Reflector $reflector, Identifier $identifier) : ?\PHPStan\BetterReflection\Reflection\Reflection { $locatedSource = $this->createLocatedSource($identifier); if (!$locatedSource) { return null; } try { return $this->astLocator->findReflection($reflector, $locatedSource, $identifier); } catch (IdentifierNotFound $exception) { return null; } } /** * {@inheritDoc} * * @throws ParseToAstFailure */ public final function locateIdentifiersByType(Reflector $reflector, IdentifierType $identifierType) : array { $locatedSource = $this->createLocatedSource(new Identifier(Identifier::WILDCARD, $identifierType)); if (!$locatedSource) { return []; } return $this->astLocator->findReflectionsOfType($reflector, $locatedSource, $identifierType); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Type; use PHPStan\BetterReflection\Identifier\Identifier; use PHPStan\BetterReflection\Identifier\IdentifierType; use PHPStan\BetterReflection\Reflection\Reflection; use PHPStan\BetterReflection\Reflector\Reflector; use function array_key_exists; use function spl_object_id; use function sprintf; final class MemoizingSourceLocator implements \PHPStan\BetterReflection\SourceLocator\Type\SourceLocator { /** @var array<string, Reflection|null> indexed by reflector key and identifier cache key */ private $cacheByIdentifierKeyAndOid = []; /** @var array<string, list<Reflection>> indexed by reflector key and identifier type cache key */ private $cacheByIdentifierTypeKeyAndOid = []; /** * @var \PHPStan\BetterReflection\SourceLocator\Type\SourceLocator */ private $wrappedSourceLocator; public function __construct(\PHPStan\BetterReflection\SourceLocator\Type\SourceLocator $wrappedSourceLocator) { $this->wrappedSourceLocator = $wrappedSourceLocator; } public function locateIdentifier(Reflector $reflector, Identifier $identifier) : ?\PHPStan\BetterReflection\Reflection\Reflection { $cacheKey = sprintf('%s_%s', $this->reflectorCacheKey($reflector), $this->identifierToCacheKey($identifier)); if (array_key_exists($cacheKey, $this->cacheByIdentifierKeyAndOid)) { return $this->cacheByIdentifierKeyAndOid[$cacheKey]; } return $this->cacheByIdentifierKeyAndOid[$cacheKey] = $this->wrappedSourceLocator->locateIdentifier($reflector, $identifier); } /** @return list<Reflection> */ public function locateIdentifiersByType(Reflector $reflector, IdentifierType $identifierType) : array { $cacheKey = sprintf('%s_%s', $this->reflectorCacheKey($reflector), $this->identifierTypeToCacheKey($identifierType)); if (array_key_exists($cacheKey, $this->cacheByIdentifierTypeKeyAndOid)) { return $this->cacheByIdentifierTypeKeyAndOid[$cacheKey]; } return $this->cacheByIdentifierTypeKeyAndOid[$cacheKey] = $this->wrappedSourceLocator->locateIdentifiersByType($reflector, $identifierType); } private function reflectorCacheKey(Reflector $reflector) : string { return sprintf('type:%s#oid:%d', \get_class($reflector), spl_object_id($reflector)); } private function identifierToCacheKey(Identifier $identifier) : string { return sprintf('%s#name:%s', $this->identifierTypeToCacheKey($identifier->getType()), $identifier->getName()); } private function identifierTypeToCacheKey(IdentifierType $identifierType) : string { return sprintf('type:%s', $identifierType->getName()); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Type; use PHPStan\BetterReflection\Identifier\Identifier; use PHPStan\BetterReflection\Identifier\IdentifierType; use PHPStan\BetterReflection\Reflection\Reflection; use PHPStan\BetterReflection\Reflector\Reflector; interface SourceLocator { /** * Locate some source code. * * This method should return a LocatedSource value object or `null` if the * SourceLocator is unable to locate the source. * * NOTE: A SourceLocator should *NOT* throw an exception if it is unable to * locate the identifier, it should simply return null. If an exception is * thrown, it will break the Generic Reflector. */ public function locateIdentifier(Reflector $reflector, Identifier $identifier) : ?\PHPStan\BetterReflection\Reflection\Reflection; /** * Find all identifiers of a type * * @return list<Reflection> */ public function locateIdentifiersByType(Reflector $reflector, IdentifierType $identifierType) : array; } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\Type; use PhpParser\Node; use PhpParser\Node\Stmt\Class_; use PhpParser\NodeTraverser; use PhpParser\NodeVisitor\NameResolver; use PhpParser\NodeVisitorAbstract; use PhpParser\Parser; use ReflectionClass as CoreReflectionClass; use ReflectionException; use PHPStan\BetterReflection\Identifier\Identifier; use PHPStan\BetterReflection\Identifier\IdentifierType; use PHPStan\BetterReflection\Reflection\Reflection; use PHPStan\BetterReflection\Reflection\ReflectionClass; use PHPStan\BetterReflection\Reflector\Reflector; use PHPStan\BetterReflection\SourceLocator\Ast\Exception\ParseToAstFailure; use PHPStan\BetterReflection\SourceLocator\Ast\Strategy\NodeToReflection; use PHPStan\BetterReflection\SourceLocator\Exception\EvaledAnonymousClassCannotBeLocated; use PHPStan\BetterReflection\SourceLocator\Exception\NoAnonymousClassOnLine; use PHPStan\BetterReflection\SourceLocator\Exception\TwoAnonymousClassesOnSameLine; use PHPStan\BetterReflection\SourceLocator\FileChecker; use PHPStan\BetterReflection\SourceLocator\Located\AnonymousLocatedSource; use PHPStan\BetterReflection\Util\FileHelper; use function array_filter; use function assert; use function file_get_contents; use function strpos; /** @internal */ final class AnonymousClassObjectSourceLocator implements \PHPStan\BetterReflection\SourceLocator\Type\SourceLocator { /** * @var CoreReflectionClass */ private $coreClassReflection; /** * @var \PhpParser\Parser */ private $parser; /** @throws ReflectionException */ public function __construct(object $anonymousClassObject, Parser $parser) { $this->parser = $parser; $this->coreClassReflection = new CoreReflectionClass($anonymousClassObject); } /** * {@inheritDoc} * * @throws ParseToAstFailure */ public function locateIdentifier(Reflector $reflector, Identifier $identifier) : ?\PHPStan\BetterReflection\Reflection\Reflection { return $this->getReflectionClass($reflector, $identifier->getType()); } /** * {@inheritDoc} * * @throws ParseToAstFailure */ public function locateIdentifiersByType(Reflector $reflector, IdentifierType $identifierType) : array { return array_filter([$this->getReflectionClass($reflector, $identifierType)]); } private function getReflectionClass(Reflector $reflector, IdentifierType $identifierType) : ?\PHPStan\BetterReflection\Reflection\ReflectionClass { if (!$identifierType->isClass()) { return null; } if (!$this->coreClassReflection->isAnonymous()) { return null; } /** @phpstan-var non-empty-string $fileName */ $fileName = $this->coreClassReflection->getFileName(); if (strpos($fileName, 'eval()\'d code') !== \false) { throw EvaledAnonymousClassCannotBeLocated::create(); } FileChecker::assertReadableFile($fileName); $fileName = FileHelper::normalizeWindowsPath($fileName); $nodeVisitor = new class($fileName, $this->coreClassReflection->getStartLine()) extends NodeVisitorAbstract { /** @var list<Class_> */ private $anonymousClassNodes = []; /** * @var string */ private $fileName; /** * @var int */ private $startLine; public function __construct(string $fileName, int $startLine) { $this->fileName = $fileName; $this->startLine = $startLine; } /** * {@inheritDoc} */ public function enterNode(Node $node) { if (!$node instanceof Node\Stmt\Class_ || $node->name !== null || $node->getLine() !== $this->startLine) { return null; } $this->anonymousClassNodes[] = $node; return null; } public function getAnonymousClassNode() : Class_ { if ($this->anonymousClassNodes === []) { throw NoAnonymousClassOnLine::create($this->fileName, $this->startLine); } if (isset($this->anonymousClassNodes[1])) { throw TwoAnonymousClassesOnSameLine::create($this->fileName, $this->startLine); } return $this->anonymousClassNodes[0]; } }; $fileContents = file_get_contents($fileName); /** @var list<Node\Stmt> $ast */ $ast = $this->parser->parse($fileContents); $nodeTraverser = new NodeTraverser(); $nodeTraverser->addVisitor(new NameResolver()); $nodeTraverser->addVisitor($nodeVisitor); $nodeTraverser->traverse($ast); $reflectionClass = (new NodeToReflection())->__invoke($reflector, $nodeVisitor->getAnonymousClassNode(), new AnonymousLocatedSource($fileContents, $fileName), null); assert($reflectionClass instanceof ReflectionClass); return $reflectionClass; } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\SourceStubber; /** @internal */ interface SourceStubber { /** * Generates stub for given class. Returns null when it cannot generate the stub. * * @param class-string|trait-string $className */ public function generateClassStub(string $className) : ?\PHPStan\BetterReflection\SourceLocator\SourceStubber\StubData; /** * Generates stub for given function. Returns null when it cannot generate the stub. */ public function generateFunctionStub(string $functionName) : ?\PHPStan\BetterReflection\SourceLocator\SourceStubber\StubData; /** * Generates stub for given constant. Returns null when it cannot generate the stub. */ public function generateConstantStub(string $constantName) : ?\PHPStan\BetterReflection\SourceLocator\SourceStubber\StubData; } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\SourceStubber\Exception; use RuntimeException; class CouldNotFindPhpStormStubs extends RuntimeException { public static function create() : self { return new self('Could not find PhpStorm stubs'); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\SourceStubber; use BackedEnum; use _PHPStan_7d8742a37\c; use LogicException; use PhpParser\Builder\Class_; use PhpParser\Builder\ClassConst; use PhpParser\Builder\Enum_; use PhpParser\Builder\EnumCase; use PhpParser\Builder\Function_; use PhpParser\Builder\FunctionLike; use PhpParser\Builder\Interface_; use PhpParser\Builder\Method; use PhpParser\Builder\Param; use PhpParser\Builder\Property; use PhpParser\Builder\Trait_; use PhpParser\BuilderFactory; use PhpParser\Comment\Doc; use PhpParser\Node; use PhpParser\Node\IntersectionType; use PhpParser\Node\Name; use PhpParser\Node\Name\FullyQualified; use PhpParser\Node\NullableType; use PhpParser\Node\UnionType; use PhpParser\PrettyPrinter\Standard; use ReflectionClass as CoreReflectionClass; use ReflectionClassConstant as CoreReflectionClassConstant; use ReflectionEnum as CoreReflectionEnum; use ReflectionEnumBackedCase as CoreReflectionEnumBackedCase; use ReflectionEnumUnitCase as CoreReflectionEnumUnitCase; use ReflectionFunction as CoreReflectionFunction; use ReflectionFunctionAbstract as CoreReflectionFunctionAbstract; use ReflectionIntersectionType as CoreReflectionIntersectionType; use ReflectionMethod as CoreReflectionMethod; use ReflectionNamedType as CoreReflectionNamedType; use ReflectionParameter as CoreReflectionParameter; use ReflectionProperty as CoreReflectionProperty; use ReflectionType as CoreReflectionType; use ReflectionUnionType as CoreReflectionUnionType; use PHPStan\BetterReflection\Reflection\Annotation\AnnotationHelper; use PHPStan\BetterReflection\Util\ClassExistenceChecker; use UnitEnum; use function array_diff; use function array_key_exists; use function array_map; use function assert; use function explode; use function function_exists; use function get_class; use function get_defined_constants; use function implode; use function in_array; use function is_file; use function is_object; use function is_resource; use function is_string; use function method_exists; use function preg_replace; use function sprintf; use const PHP_VERSION_ID; /** * It generates a stub source from internal reflection for given class or function name. * * @internal */ final class ReflectionSourceStubber implements \PHPStan\BetterReflection\SourceLocator\SourceStubber\SourceStubber { /** * @var \PhpParser\BuilderFactory */ private $builderFactory; /** * @var \PhpParser\PrettyPrinter\Standard */ private $prettyPrinter; /** * @var int */ private $phpVersion = PHP_VERSION_ID; public function __construct(Standard $prettyPrinter, int $phpVersion = PHP_VERSION_ID) { $this->phpVersion = $phpVersion; $this->builderFactory = new BuilderFactory(); $this->prettyPrinter = $prettyPrinter; } /** @param class-string|trait-string $className */ public function generateClassStub(string $className) : ?\PHPStan\BetterReflection\SourceLocator\SourceStubber\StubData { if (!ClassExistenceChecker::exists($className, \false)) { return null; } $enumExists = function (string $enum, bool $autoload = \true) : bool { if (function_exists('enum_exists')) { return \enum_exists($enum, $autoload); } return $autoload && \class_exists($enum) && \false; }; /** phpcs:disable SlevomatCodingStandard.Namespaces.ReferenceUsedNamesOnly.ReferenceViaFullyQualifiedName */ $isEnum = function_exists('enum_exists') && $enumExists($className, \false); /** phpcs:enable */ $classReflection = $isEnum ? new CoreReflectionEnum($className) : new CoreReflectionClass($className); $classNode = $this->createClass($classReflection); if ($classNode instanceof Class_) { $this->addClassModifiers($classNode, $classReflection); } if ($classNode instanceof Class_ || $classNode instanceof Interface_ || $classNode instanceof Enum_) { $this->addExtendsAndImplements($classNode, $classReflection); } if ($classNode instanceof Class_ || $classNode instanceof Trait_) { $this->addProperties($classNode, $classReflection); } if ($classNode instanceof Class_ || $classNode instanceof Trait_ || $classNode instanceof Enum_) { $this->addTraitUse($classNode, $classReflection); } $this->addAttributes($classNode, $classReflection); $this->addDocComment($classNode, $classReflection); if ($classNode instanceof Enum_ && $classReflection instanceof CoreReflectionEnum) { $this->addEnumBackingType($classNode, $classReflection); $this->addEnumCases($classNode, $classReflection); } $this->addClassConstants($classNode, $classReflection); $this->addMethods($classNode, $classReflection); $node = $classNode->getNode(); $stub = $classReflection->inNamespace() ? $this->generateStubInNamespace($node, $classReflection->getNamespaceName()) : $this->generateStub($node); $extensionName = ($getExtension = $classReflection->getExtension()) ? $getExtension->getName() : null; assert(is_string($extensionName) && $extensionName !== '' || $extensionName === null); return $this->createStubData($stub, $extensionName, $classReflection->getFileName() !== \false ? $classReflection->getFileName() : null); } public function generateFunctionStub(string $functionName) : ?\PHPStan\BetterReflection\SourceLocator\SourceStubber\StubData { if (!function_exists($functionName)) { return null; } return $this->generateFunctionStubFromReflection(new CoreReflectionFunction($functionName)); } public function generateFunctionStubFromReflection(CoreReflectionFunction $functionReflection) : ?\PHPStan\BetterReflection\SourceLocator\SourceStubber\StubData { $shortName = $functionReflection->getShortName(); if ($functionReflection->isClosure()) { $shortName = '{closure}'; } $functionNode = $this->builderFactory->function($shortName); $this->addAttributes($functionNode, $functionReflection); $this->addDocComment($functionNode, $functionReflection); $this->addParameters($functionNode, $functionReflection); $returnType = $functionReflection->getReturnType(); if ($returnType === null && method_exists($functionReflection, 'getTentativeReturnType')) { $returnType = $functionReflection->getTentativeReturnType(); } if ($returnType !== null) { assert($returnType instanceof CoreReflectionNamedType || $returnType instanceof CoreReflectionUnionType || $returnType instanceof CoreReflectionIntersectionType); $functionNode->setReturnType($this->formatType($returnType)); } $extensionName = ($getExtension = $functionReflection->getExtension()) ? $getExtension->getName() : null; assert(is_string($extensionName) && $extensionName !== '' || $extensionName === null); if (!$functionReflection->inNamespace() || $functionReflection->isClosure()) { return $this->createStubData($this->generateStub($functionNode->getNode()), $extensionName, $functionReflection->getFileName() !== \false ? $functionReflection->getFileName() : null); } return $this->createStubData($this->generateStubInNamespace($functionNode->getNode(), $functionReflection->getNamespaceName()), $extensionName, $functionReflection->getFileName() !== \false ? $functionReflection->getFileName() : null); } public function generateConstantStub(string $constantName) : ?\PHPStan\BetterReflection\SourceLocator\SourceStubber\StubData { $constantData = $this->findConstantData($constantName); if ($constantData === null) { return null; } [$constantValue, $extensionName] = $constantData; if ($extensionName === null) { return null; } if (is_resource($constantValue)) { $constantValue = $this->builderFactory->funcCall('constant', [$constantName]); } $constantNode = $this->builderFactory->funcCall('define', [$constantName, $constantValue]); return $this->createStubData($this->generateStub($constantNode), $extensionName, null); } /** @return array{0: scalar|list<scalar>|resource|null, 1: non-empty-string|null}|null */ private function findConstantData(string $constantName) { /** @var array<non-empty-string, array<string, scalar|list<scalar>|resource|null>> $constants */ $constants = get_defined_constants(\true); foreach ($constants as $constantExtensionName => $extensionConstants) { if (array_key_exists($constantName, $extensionConstants)) { return [$extensionConstants[$constantName], $constantExtensionName !== 'user' ? $constantExtensionName : null]; } } return null; } /** * @return \PhpParser\Builder\Class_|\PhpParser\Builder\Interface_|\PhpParser\Builder\Trait_|\PhpParser\Builder\Enum_ */ private function createClass(CoreReflectionClass $classReflection) { if ($classReflection instanceof CoreReflectionEnum) { return $this->builderFactory->enum($classReflection->getShortName()); } if ($classReflection->isTrait()) { return $this->builderFactory->trait($classReflection->getShortName()); } if ($classReflection->isInterface()) { return $this->builderFactory->interface($classReflection->getShortName()); } return $this->builderFactory->class($classReflection->getShortName()); } /** * @param \PhpParser\Builder\Class_|\PhpParser\Builder\Interface_|\PhpParser\Builder\Trait_|\PhpParser\Builder\Enum_|\PhpParser\Builder\ClassConst|\PhpParser\Builder\EnumCase|\PhpParser\Builder\Method|\PhpParser\Builder\Property|\PhpParser\Builder\Function_|\PhpParser\Builder\Param $node * @param CoreReflectionClass|CoreReflectionClassConstant|CoreReflectionEnumUnitCase|CoreReflectionMethod|CoreReflectionProperty|CoreReflectionFunction|CoreReflectionParameter $reflection */ private function addAttributes($node, $reflection) : void { if (!method_exists($reflection, 'getAttributes')) { return; } $attributeReflections = $reflection->getAttributes(); if ($attributeReflections === []) { return; } foreach ($attributeReflections as $attributeReflection) { $node->addAttribute($this->builderFactory->attribute(new FullyQualified($attributeReflection->getName()), $attributeReflection->getArguments())); } } /** * @param \PhpParser\Builder\Class_|\PhpParser\Builder\Interface_|\PhpParser\Builder\Trait_|\PhpParser\Builder\Enum_|\PhpParser\Builder\Method|\PhpParser\Builder\Property|\PhpParser\Builder\Function_ $node * @param CoreReflectionClass|CoreReflectionMethod|CoreReflectionProperty|CoreReflectionFunction $reflection */ private function addDocComment($node, $reflection) : void { $docComment = $reflection->getDocComment() !== \false ? $reflection->getDocComment() : ''; $annotations = []; if (($reflection instanceof CoreReflectionMethod || $reflection instanceof CoreReflectionFunction) && $reflection->isInternal()) { if ($reflection->isDeprecated()) { $annotations[] = '@deprecated'; } if (method_exists($reflection, 'hasTentativeReturnType') && $reflection->hasTentativeReturnType()) { $annotations[] = sprintf('@%s', AnnotationHelper::TENTATIVE_RETURN_TYPE_ANNOTATION); } } if ($docComment === '' && $annotations === []) { return; } if ($docComment === '') { $docComment = sprintf("/**\n* %s\n*/", implode("\n *", $annotations)); } elseif ($annotations !== []) { $docComment = preg_replace('~\\s+\\*/$~', sprintf("\n* %s\n*/", implode("\n *", $annotations)), $docComment); } $node->setDocComment(new Doc($docComment)); } private function addEnumBackingType(Enum_ $enumNode, CoreReflectionEnum $enumReflection) : void { if (!$enumReflection->isBacked()) { return; } $backingType = $enumReflection->getBackingType(); assert($backingType instanceof CoreReflectionNamedType); $enumNode->setScalarType($backingType->getName()); } private function addClassModifiers(Class_ $classNode, CoreReflectionClass $classReflection) : void { if (!$classReflection->isInterface() && $classReflection->isAbstract()) { // Interface \Iterator is interface and abstract $classNode->makeAbstract(); } if (!$classReflection->isFinal()) { return; } $classNode->makeFinal(); } /** * @param \PhpParser\Builder\Class_|\PhpParser\Builder\Interface_|\PhpParser\Builder\Enum_ $classNode */ private function addExtendsAndImplements($classNode, CoreReflectionClass $classReflection) : void { $interfaces = $classReflection->getInterfaceNames(); if ($classNode instanceof Class_ || $classNode instanceof Interface_) { $parentClass = $classReflection->getParentClass(); if ($parentClass !== \false) { $classNode->extend(new FullyQualified($parentClass->getName())); $interfaces = array_diff($interfaces, $parentClass->getInterfaceNames()); } } foreach ($classReflection->getInterfaces() as $interface) { $interfaces = array_diff($interfaces, $interface->getInterfaceNames()); } foreach ($interfaces as $interfaceName) { if (method_exists($classReflection, 'isEnum') && $classReflection->isEnum() && in_array($interfaceName, [BackedEnum::class, UnitEnum::class], \true)) { continue; } $interfaceNode = new FullyQualified($interfaceName); if ($classNode instanceof Interface_) { $classNode->extend($interfaceNode); } else { $classNode->implement($interfaceNode); } } } /** * @param \PhpParser\Builder\Class_|\PhpParser\Builder\Trait_|\PhpParser\Builder\Enum_ $classNode */ private function addTraitUse($classNode, CoreReflectionClass $classReflection) : void { /** @var array<string, string> $traitAliases */ $traitAliases = $classReflection->getTraitAliases(); $traitUseAdaptations = []; foreach ($traitAliases as $methodNameAlias => $methodInfo) { [$traitName, $methodName] = explode('::', $methodInfo); $traitUseAdaptation = $this->builderFactory->traitUseAdaptation(new FullyQualified($traitName), $methodName); $traitUseAdaptation->as($methodNameAlias); $traitUseAdaptations[$traitName] = $traitUseAdaptation; } foreach ($classReflection->getTraitNames() as $traitName) { $traitUse = $this->builderFactory->useTrait(new FullyQualified($traitName)); if (array_key_exists($traitName, $traitUseAdaptations)) { $traitUse->with($traitUseAdaptations[$traitName]); } $classNode->addStmt($traitUse); } } /** * @param \PhpParser\Builder\Class_|\PhpParser\Builder\Trait_ $classNode */ private function addProperties($classNode, CoreReflectionClass $classReflection) : void { foreach ($classReflection->getProperties() as $propertyReflection) { if (!$this->isPropertyDeclaredInClass($propertyReflection, $classReflection)) { continue; } $propertyNode = $this->builderFactory->property($propertyReflection->getName()); $this->addPropertyModifiers($propertyNode, $propertyReflection); $this->addAttributes($propertyNode, $propertyReflection); $this->addDocComment($propertyNode, $propertyReflection); if (method_exists($propertyReflection, 'hasDefaultValue') && $propertyReflection->hasDefaultValue()) { try { $propertyNode->setDefault($propertyReflection->getDeclaringClass()->getDefaultProperties()[$propertyReflection->getName()] ?? null); } catch (LogicException $exception) { // Nothing } } if ($this->phpVersion >= 70400) { $propertyType = method_exists($propertyReflection, 'getType') ? method_exists($propertyReflection, 'getType') ? $propertyReflection->getType() : null : null; if ($propertyType !== null) { assert($propertyType instanceof CoreReflectionNamedType || $propertyType instanceof CoreReflectionUnionType || $propertyType instanceof CoreReflectionIntersectionType); $propertyNode->setType($this->formatType($propertyType)); } } $classNode->addStmt($propertyNode); } } private function isPropertyDeclaredInClass(CoreReflectionProperty $propertyReflection, CoreReflectionClass $classReflection) : bool { if ($propertyReflection->getDeclaringClass()->getName() !== $classReflection->getName()) { return \false; } foreach ($classReflection->getTraits() as $trait) { if ($trait->hasProperty($propertyReflection->getName())) { return \false; } } return \true; } private function addPropertyModifiers(Property $propertyNode, CoreReflectionProperty $propertyReflection) : void { if ($this->phpVersion >= 80100) { if (method_exists($propertyReflection, 'isReadOnly') && $propertyReflection->isReadOnly()) { $propertyNode->makeReadonly(); } } if ($propertyReflection->isStatic()) { $propertyNode->makeStatic(); } if ($propertyReflection->isPublic()) { $propertyNode->makePublic(); } elseif ($propertyReflection->isProtected()) { $propertyNode->makeProtected(); } else { $propertyNode->makePrivate(); } } private function addEnumCases(Enum_ $enumNode, CoreReflectionEnum $enumReflection) : void { foreach ($enumReflection->getCases() as $enumCaseReflection) { $enumCaseNode = $this->builderFactory->enumCase($enumCaseReflection->getName()); $this->addAttributes($enumCaseNode, $enumCaseReflection); if ($enumCaseReflection instanceof CoreReflectionEnumBackedCase) { $enumCaseNode->setValue($enumCaseReflection->getBackingValue()); } $enumNode->addStmt($enumCaseNode); } } /** * @param \PhpParser\Builder\Class_|\PhpParser\Builder\Interface_|\PhpParser\Builder\Trait_|\PhpParser\Builder\Enum_ $classNode */ private function addClassConstants($classNode, CoreReflectionClass $classReflection) : void { foreach ($classReflection->getReflectionConstants() as $constantReflection) { if (method_exists($constantReflection, 'isEnumCase') && $constantReflection->isEnumCase()) { continue; } if ($constantReflection->getDeclaringClass()->getName() !== $classReflection->getName()) { continue; } $classConstantNode = $this->builderFactory->classConst($constantReflection->getName(), $constantReflection->getValue()); if (method_exists($constantReflection, 'getType')) { $constantType = $constantReflection->getType(); if ($constantType !== null) { assert($constantType instanceof CoreReflectionNamedType || $constantType instanceof CoreReflectionUnionType || $constantType instanceof CoreReflectionIntersectionType); $classConstantNode->setType($this->formatType($constantType)); } } $this->addAttributes($classConstantNode, $constantReflection); if ($constantReflection->getDocComment() !== \false) { $classConstantNode->setDocComment(new Doc($constantReflection->getDocComment())); } $this->addClassConstantModifiers($classConstantNode, $constantReflection); $classNode->addStmt($classConstantNode); } } private function addClassConstantModifiers(ClassConst $classConstantNode, CoreReflectionClassConstant $classConstantReflection) : void { if (method_exists($classConstantReflection, 'isFinal') && $classConstantReflection->isFinal()) { $classConstantNode->makeFinal(); } if ($classConstantReflection->isPrivate()) { $classConstantNode->makePrivate(); } elseif ($classConstantReflection->isProtected()) { $classConstantNode->makeProtected(); } else { $classConstantNode->makePublic(); } } /** * @param \PhpParser\Builder\Class_|\PhpParser\Builder\Interface_|\PhpParser\Builder\Trait_|\PhpParser\Builder\Enum_ $classNode */ private function addMethods($classNode, CoreReflectionClass $classReflection) : void { foreach ($classReflection->getMethods() as $methodReflection) { if (!$this->isMethodDeclaredInClass($methodReflection, $classReflection)) { continue; } $methodNode = $this->builderFactory->method($methodReflection->getName()); $this->addMethodFlags($methodNode, $methodReflection); $this->addAttributes($methodNode, $methodReflection); $this->addDocComment($methodNode, $methodReflection); $this->addParameters($methodNode, $methodReflection); $returnType = $methodReflection->getReturnType(); if ($returnType === null && method_exists($methodReflection, 'getTentativeReturnType')) { $returnType = $methodReflection->getTentativeReturnType(); } if ($returnType !== null) { assert($returnType instanceof CoreReflectionNamedType || $returnType instanceof CoreReflectionUnionType || $returnType instanceof CoreReflectionIntersectionType); $methodNode->setReturnType($this->formatType($returnType)); } $classNode->addStmt($methodNode); } } private function isMethodDeclaredInClass(CoreReflectionMethod $methodReflection, CoreReflectionClass $classReflection) : bool { if ($methodReflection->getDeclaringClass()->getName() !== $classReflection->getName()) { return \false; } $methodName = $methodReflection->getName(); /** @var array<string, string> $traitAliases */ $traitAliases = $classReflection->getTraitAliases(); if (array_key_exists($methodName, $traitAliases)) { return \false; } foreach ($classReflection->getTraits() as $trait) { if ($trait->hasMethod($methodName)) { return \false; } } if ($classReflection instanceof CoreReflectionEnum) { if ($methodName === 'cases') { return \false; } if ($classReflection->isBacked() && in_array($methodName, ['from', 'tryFrom'], \true)) { return \false; } } return \true; } private function addMethodFlags(Method $methodNode, CoreReflectionMethod $methodReflection) : void { if ($methodReflection->isFinal()) { $methodNode->makeFinal(); } if ($methodReflection->isAbstract() && !$methodReflection->getDeclaringClass()->isInterface()) { $methodNode->makeAbstract(); } if ($methodReflection->isStatic()) { $methodNode->makeStatic(); } if ($methodReflection->isPublic()) { $methodNode->makePublic(); } if ($methodReflection->isProtected()) { $methodNode->makeProtected(); } if ($methodReflection->isPrivate()) { $methodNode->makePrivate(); } if (!$methodReflection->returnsReference()) { return; } $methodNode->makeReturnByRef(); } private function addParameters(FunctionLike $functionNode, CoreReflectionFunctionAbstract $functionReflectionAbstract) : void { foreach ($functionReflectionAbstract->getParameters() as $parameterReflection) { $parameterNode = $this->builderFactory->param($parameterReflection->getName()); $this->addParameterModifiers($parameterReflection, $parameterNode); $this->setParameterDefaultValue($parameterReflection, $parameterNode); $this->addAttributes($parameterNode, $parameterReflection); $functionNode->addParam($parameterNode); } } private function addParameterModifiers(CoreReflectionParameter $parameterReflection, Param $parameterNode) : void { if ($parameterReflection->isVariadic()) { $parameterNode->makeVariadic(); } if ($parameterReflection->isPassedByReference()) { $parameterNode->makeByRef(); } $parameterType = $parameterReflection->getType(); if ($parameterType === null) { return; } assert($parameterType instanceof CoreReflectionNamedType || $parameterType instanceof CoreReflectionUnionType || $parameterType instanceof CoreReflectionIntersectionType); $parameterNode->setType($this->formatType($parameterType)); } private function setParameterDefaultValue(CoreReflectionParameter $parameterReflection, Param $parameterNode) : void { if (!$parameterReflection->isOptional()) { return; } if ($parameterReflection->isVariadic()) { return; } if (!$parameterReflection->isDefaultValueAvailable()) { if ($parameterReflection->allowsNull()) { $parameterNode->setDefault(null); } else { $parameterNode->setDefault(new Node\Expr\ConstFetch(new FullyQualified('UNKNOWN'))); } return; } $defaultValue = $parameterReflection->getDefaultValue(); if (is_object($defaultValue)) { $className = get_class($defaultValue); $enumExists = function (string $enum, bool $autoload = \true) : bool { if (function_exists('enum_exists')) { return \enum_exists($enum, $autoload); } return $autoload && \class_exists($enum) && \false; }; $isEnum = function_exists('enum_exists') && $enumExists($className, \false); if ($isEnum) { $parameterNode->setDefault(new Node\Expr\ClassConstFetch(new FullyQualified($className), new Node\Identifier($defaultValue->name))); return; } if ($this->phpVersion >= 80100) { $parameterNode->setDefault(new Node\Expr\New_(new FullyQualified($className))); } else { $parameterNode->setDefault(new Node\Expr\ConstFetch(new Name('null'))); } return; } $parameterNode->setDefault($defaultValue); } /** * @return \PhpParser\Node\Name|\PhpParser\Node\NullableType|\PhpParser\Node\UnionType|\PhpParser\Node\IntersectionType */ private function formatType(CoreReflectionType $type) { if ($type instanceof CoreReflectionIntersectionType) { /** @var list<Name> $types */ $types = $this->formatTypes($type->getTypes()); if ($this->phpVersion >= 80100) { return new IntersectionType($types); } return $types[0]; } if ($type instanceof CoreReflectionUnionType) { /** @var list<Name|IntersectionType> $types */ $types = $this->formatTypes($type->getTypes()); if ($this->phpVersion >= 80200) { return new UnionType($types); } if ($this->phpVersion < 80000) { return $types[0]; } $intersectionTypes = []; $otherNames = []; foreach ($types as $type) { if ($type instanceof IntersectionType) { $intersectionTypes[] = $type; continue; } $otherNames[] = $type; } if ($this->phpVersion >= 80100) { if (\count($intersectionTypes) > 0) { return $intersectionTypes[0]; } } if (\count($otherNames) > 1) { return new UnionType($otherNames); } if (\count($otherNames) > 0) { return $otherNames[0]; } return new Name('null'); } assert($type instanceof CoreReflectionNamedType); $name = $type->getName(); $nameNode = $this->formatNamedType($type); if (!$type->allowsNull() || $name === 'mixed' || $name === 'null') { return $nameNode; } return new NullableType($nameNode); } /** * @param list<CoreReflectionType> $types * * @return list<Name|UnionType|IntersectionType> */ private function formatTypes(array $types) : array { return array_map(function (CoreReflectionType $type) { $formattedType = $this->formatType($type); assert($formattedType instanceof Name || $formattedType instanceof UnionType || $formattedType instanceof IntersectionType); return $formattedType; }, $types); } private function formatNamedType(CoreReflectionNamedType $type) : Name { $name = $type->getName(); return $type->isBuiltin() || in_array($name, ['self', 'parent', 'static'], \true) ? new Name($name) : new FullyQualified($name); } private function generateStubInNamespace(Node $node, string $namespaceName) : string { $namespaceBuilder = $this->builderFactory->namespace($namespaceName); $namespaceBuilder->addStmt($node); return $this->generateStub($namespaceBuilder->getNode()); } private function generateStub(Node $node) : string { return sprintf("<?php\n\n%s%s\n", $this->prettyPrinter->prettyPrint([$node]), $node instanceof Node\Expr\FuncCall ? ';' : ''); } /** @param non-empty-string|null $extensionName */ private function createStubData(string $stub, ?string $extensionName, ?string $fileName) : \PHPStan\BetterReflection\SourceLocator\SourceStubber\StubData { return new \PHPStan\BetterReflection\SourceLocator\SourceStubber\StubData($stub, $extensionName, $fileName); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\SourceStubber\PhpStormStubs; use PhpParser\BuilderFactory; use PhpParser\Node; use PhpParser\NodeTraverser; use PhpParser\NodeVisitorAbstract; use PHPStan\BetterReflection\Reflection\Exception\InvalidConstantNode; use PHPStan\BetterReflection\Util\ConstantNodeChecker; use function array_key_exists; use function assert; use function class_exists; use function constant; use function count; use function defined; use function explode; use function in_array; use function is_resource; use function sprintf; use function strtolower; use function strtoupper; /** @internal */ class CachingVisitor extends NodeVisitorAbstract { private const TRUE_FALSE_NULL = ['true', 'false', 'null']; /** * @var \PhpParser\Node\Stmt\Namespace_|null */ private $currentNamespace = null; /** @var array<string, array{0: Node\Stmt\ClassLike, 1: Node\Stmt\Namespace_|null}> */ private $classNodes = []; /** @var array<string, list<array{0: Node\Stmt\Function_, 1: Node\Stmt\Namespace_|null}>> */ private $functionNodes = []; /** @var array<string, array{0: Node\Stmt\Const_|Node\Expr\FuncCall, 1: Node\Stmt\Namespace_|null}> */ private $constantNodes = []; /** * @var \PhpParser\BuilderFactory */ private $builderFactory; public function __construct(BuilderFactory $builderFactory) { $this->builderFactory = $builderFactory; } public function enterNode(Node $node) : ?int { if ($node instanceof Node\Stmt\Namespace_) { $this->currentNamespace = $node; return null; } if ($node instanceof Node\Stmt\ClassLike) { $classNamespacedName = $node->namespacedName; assert($classNamespacedName instanceof Node\Name); $className = $classNamespacedName->toString(); $this->classNodes[$className] = [$node, $this->currentNamespace]; foreach ($node->getConstants() as $constantsNode) { foreach ($constantsNode->consts as $constNode) { $constClassName = sprintf('%s::%s', $className, $constNode->name->toString()); $this->updateConstantValue($constNode, $constClassName); } } // We need to traverse children to resolve attributes names for methods, properties etc. return null; } if ($node instanceof Node\Stmt\ClassMethod) { return NodeTraverser::DONT_TRAVERSE_CURRENT_AND_CHILDREN; } if ($node instanceof Node\Stmt\Function_) { $functionNamespacedName = $node->namespacedName; assert($functionNamespacedName instanceof Node\Name); $functionName = $functionNamespacedName->toString(); $this->functionNodes[$functionName][] = [$node, $this->currentNamespace]; return NodeTraverser::DONT_TRAVERSE_CHILDREN; } if ($node instanceof Node\Stmt\Const_) { foreach ($node->consts as $constNode) { $constNamespacedName = $constNode->namespacedName; assert($constNamespacedName instanceof Node\Name); $constNodeName = $constNamespacedName->toString(); $this->updateConstantValue($constNode, $constNodeName); $this->constantNodes[$constNodeName] = [$node, $this->currentNamespace]; } return NodeTraverser::DONT_TRAVERSE_CHILDREN; } if ($node instanceof Node\Expr\FuncCall) { $argumentNameNode = $node->args[0]; assert($argumentNameNode instanceof Node\Arg); $nameNode = $argumentNameNode->value; assert($nameNode instanceof Node\Scalar\String_); $constantName = $nameNode->value; // The definition is stubs looks like `define('STDIN', fopen('php://stdin', 'r'))` // We will modify it to `define('STDIN', constant('STDIN')); // The later definition can pass validation in `ConstantNodeChecker` and has support in `CompileNodeToValue` if (in_array($constantName, ['STDIN', 'STDOUT', 'STDERR'], \true) && array_key_exists(1, $node->args) && $node->args[1] instanceof Node\Arg) { $node->args[1]->value = $this->builderFactory->funcCall('constant', [$constantName]); } // @codeCoverageIgnoreStart // @infection-ignore-all // No invalid definition in PhpStorm stubs try { ConstantNodeChecker::assertValidDefineFunctionCall($node); } catch (InvalidConstantNode $exception) { return null; } // @codeCoverageIgnoreEnd if (in_array($constantName, self::TRUE_FALSE_NULL, \true)) { $constantName = strtoupper($constantName); $nameNode->value = $constantName; } $this->updateConstantValue($node, $constantName); $this->constantNodes[$constantName] = [$node, $this->currentNamespace]; if (array_key_exists(2, $node->args) && $node->args[2] instanceof Node\Arg && $node->args[2]->value instanceof Node\Expr\ConstFetch && $node->args[2]->value->name->toLowerString() === 'true') { $this->constantNodes[strtolower($constantName)] = [$node, $this->currentNamespace]; } return NodeTraverser::DONT_TRAVERSE_CHILDREN; } return null; } /** * {@inheritDoc} */ public function leaveNode(Node $node) { if ($node instanceof Node\Stmt\Namespace_) { $this->currentNamespace = null; } return null; } /** @return array<string, array{0: Node\Stmt\ClassLike, 1: Node\Stmt\Namespace_|null}> */ public function getClassNodes() : array { return $this->classNodes; } /** @return array<string, list<array{0: Node\Stmt\Function_, 1: Node\Stmt\Namespace_|null}>> */ public function getFunctionNodes() : array { return $this->functionNodes; } /** @return array<string, array{0: Node\Stmt\Const_|Node\Expr\FuncCall, 1: Node\Stmt\Namespace_|null}> */ public function getConstantNodes() : array { return $this->constantNodes; } public function clearNodes() : void { $this->classNodes = []; $this->functionNodes = []; $this->constantNodes = []; } /** * Some constants have different values on different systems, some are not actual in stubs. * @param \PhpParser\Node\Expr\FuncCall|\PhpParser\Node\Const_ $node */ private function updateConstantValue($node, string $constantName) : void { // prevent autoloading while discovering class constants $parts = explode('::', $constantName, 2); if (count($parts) === 2) { [$className, $classConstName] = $parts; if (!class_exists($className, \false)) { return; } } if (!defined($constantName)) { return; } // @ because access to deprecated constant throws deprecated warning /** @var scalar|resource|list<scalar>|null $constantValue */ $constantValue = @constant($constantName); $normalizedConstantValue = is_resource($constantValue) ? $this->builderFactory->funcCall('constant', [$constantName]) : $this->builderFactory->val($constantValue); if ($node instanceof Node\Expr\FuncCall) { $argumentValueNode = $node->args[1]; assert($argumentValueNode instanceof Node\Arg); $argumentValueNode->value = $normalizedConstantValue; } else { $node->value = $normalizedConstantValue; } } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\SourceStubber; use CompileError; use DatePeriod; use Error; use Generator; use Iterator; use IteratorAggregate; use _PHPStan_7d8742a37\JetBrains\PHPStormStub\PhpStormStubsMap; use JsonSerializable; use ParseError; use PDOStatement; use PhpParser\BuilderFactory; use PhpParser\BuilderHelpers; use PhpParser\Comment\Doc; use PhpParser\Node; use PhpParser\NodeTraverser; use PhpParser\NodeVisitor\NameResolver; use PhpParser\Parser; use PhpParser\PrettyPrinter\Standard; use RecursiveIterator; use PHPStan\BetterReflection\Reflection\Annotation\AnnotationHelper; use PHPStan\BetterReflection\Reflection\Exception\InvalidConstantNode; use PHPStan\BetterReflection\SourceLocator\FileChecker; use PHPStan\BetterReflection\SourceLocator\SourceStubber\Exception\CouldNotFindPhpStormStubs; use PHPStan\BetterReflection\SourceLocator\SourceStubber\PhpStormStubs\CachingVisitor; use PHPStan\BetterReflection\Util\ConstantNodeChecker; use SeekableIterator; use SimpleXMLElement; use SplFixedArray; use SplObjectStorage; use Traversable; use function array_change_key_case; use function array_key_exists; use function array_map; use function assert; use function explode; use function file_get_contents; use function in_array; use function is_dir; use function preg_match; use function preg_replace; use function sprintf; use function str_contains; use function str_replace; use function strtolower; use function usort; use const PHP_VERSION_ID; /** @internal */ final class PhpStormStubsSourceStubber implements \PHPStan\BetterReflection\SourceLocator\SourceStubber\SourceStubber { private const SEARCH_DIRECTORIES = [__DIR__ . '/../../../../../jetbrains/phpstorm-stubs', __DIR__ . '/../../../vendor/jetbrains/phpstorm-stubs']; private const CORE_EXTENSIONS = ['apache', 'bcmath', 'bz2', 'calendar', 'Core', 'ctype', 'curl', 'date', 'dba', 'dom', 'enchant', 'exif', 'FFI', 'fileinfo', 'filter', 'fpm', 'ftp', 'gd', 'gettext', 'gmp', 'hash', 'iconv', 'imap', 'interbase', 'intl', 'json', 'ldap', 'libxml', 'mbstring', 'mcrypt', 'mssql', 'mysql', 'mysqli', 'oci8', 'odbc', 'openssl', 'pcntl', 'pcre', 'PDO', 'pdo_ibm', 'pdo_mysql', 'pdo_pgsql', 'pdo_sqlite', 'pgsql', 'Phar', 'posix', 'pspell', 'random', 'readline', 'recode', 'Reflection', 'regex', 'session', 'shmop', 'SimpleXML', 'snmp', 'soap', 'sockets', 'sodium', 'SPL', 'sqlite3', 'standard', 'sybase', 'sysvmsg', 'sysvsem', 'sysvshm', 'tidy', 'tokenizer', 'wddx', 'xml', 'xmlreader', 'xmlrpc', 'xmlwriter', 'xsl', 'Zend OPcache', 'zip', 'zlib']; /** * @var \PhpParser\BuilderFactory */ private $builderFactory; /** * @var \PhpParser\PrettyPrinter\Standard */ private $prettyPrinter; /** * @var \PhpParser\NodeTraverser */ private $nodeTraverser; /** * @var string|null */ private $stubsDirectory = null; /** * @var \PHPStan\BetterReflection\SourceLocator\SourceStubber\PhpStormStubs\CachingVisitor */ private $cachingVisitor; /** * `null` means "class is not supported in the required PHP version" * * @var array<string, array{0: Node\Stmt\ClassLike, 1: Node\Stmt\Namespace_|null}|null> */ private $classNodes = []; /** * `null` means "function is not supported in the required PHP version" * * @var array<string, array{0: Node\Stmt\Function_, 1: Node\Stmt\Namespace_|null}|null> */ private $functionNodes = []; /** * `null` means "failed lookup" for constant that is not case insensitive or "constant is not supported in the required PHP version" * * @var array<string, array{0: Node\Stmt\Const_|Node\Expr\FuncCall, 1: Node\Stmt\Namespace_|null}|null> */ private $constantNodes = []; /** * @var bool */ private static $mapsInitialized = \false; /** @var array<lowercase-string, string> */ private static $classMap; /** @var array<lowercase-string, string> */ private static $functionMap; /** @var array<lowercase-string, string> */ private static $constantMap; /** * @var \PhpParser\Parser */ private $phpParser; /** * @var int */ private $phpVersion = PHP_VERSION_ID; public function __construct(Parser $phpParser, Standard $prettyPrinter, int $phpVersion = PHP_VERSION_ID) { $this->phpParser = $phpParser; $this->phpVersion = $phpVersion; $this->builderFactory = new BuilderFactory(); $this->prettyPrinter = $prettyPrinter; $this->cachingVisitor = new CachingVisitor($this->builderFactory); $this->nodeTraverser = new NodeTraverser(); $this->nodeTraverser->addVisitor(new NameResolver()); $this->nodeTraverser->addVisitor($this->cachingVisitor); if (self::$mapsInitialized) { return; } /** @psalm-suppress PropertyTypeCoercion */ self::$classMap = array_change_key_case(PhpStormStubsMap::CLASSES); /** @psalm-suppress PropertyTypeCoercion */ self::$functionMap = array_change_key_case(PhpStormStubsMap::FUNCTIONS); /** @psalm-suppress PropertyTypeCoercion */ self::$constantMap = array_change_key_case(PhpStormStubsMap::CONSTANTS); self::$mapsInitialized = \true; } public function hasClass(string $className) : bool { $lowercaseClassName = strtolower($className); return array_key_exists($lowercaseClassName, self::$classMap); } public function isPresentClass(string $className) : ?bool { $lowercaseClassName = strtolower($className); if (!array_key_exists($lowercaseClassName, self::$classMap)) { return null; } $classNode = $this->getClassNodeData($lowercaseClassName); return $classNode !== null; } public function isPresentFunction(string $functionName) : ?bool { $lowercaseFunctionName = strtolower($functionName); if (!array_key_exists($lowercaseFunctionName, self::$functionMap)) { return null; } $functionNode = $this->getFunctionNodeData($lowercaseFunctionName); return $functionNode !== null; } /** @param class-string|trait-string $className */ public function generateClassStub(string $className) : ?\PHPStan\BetterReflection\SourceLocator\SourceStubber\StubData { if (strtolower($className) === 'iterable') { return null; } $classNodeData = $this->getClassNodeData($className); if ($classNodeData === null) { return null; } $classNode = $classNodeData[0]; if ($classNode instanceof Node\Stmt\Class_) { if ($classNode->extends !== null) { $modifiedExtends = $this->replaceExtendsOrImplementsByPhpVersion($className, [$classNode->extends]); $classNode->extends = $modifiedExtends !== [] ? $modifiedExtends[0] : null; } $classNode->implements = $this->replaceExtendsOrImplementsByPhpVersion($className, $classNode->implements); } elseif ($classNode instanceof Node\Stmt\Interface_) { $classNode->extends = $this->replaceExtendsOrImplementsByPhpVersion($className, $classNode->extends); } $filePath = self::$classMap[strtolower($className)]; $extension = $this->getExtensionFromFilePath($filePath); $stub = $this->createStub($classNode, $classNodeData[1]); if ($className === Traversable::class) { // See https://github.com/JetBrains/phpstorm-stubs/commit/0778a26992c47d7dbee4d0b0bfb7fad4344371b1#diff-575bacb45377d474336c71cbf53c1729 $stub = str_replace(' extends \\iterable', '', $stub); } elseif ($className === Generator::class) { $stub = str_replace('PS_UNRESERVE_PREFIX_throw', 'throw', $stub); } return new \PHPStan\BetterReflection\SourceLocator\SourceStubber\StubData($stub, $extension, $this->getAbsoluteFilePath($filePath)); } /** @return array{0: Node\Stmt\ClassLike, 1: Node\Stmt\Namespace_|null}|null */ private function getClassNodeData(string $className) { $lowercaseClassName = strtolower($className); if (!array_key_exists($lowercaseClassName, self::$classMap)) { return null; } $filePath = self::$classMap[$lowercaseClassName]; if (!array_key_exists($lowercaseClassName, $this->classNodes)) { $this->parseFile($filePath); /** @psalm-suppress RedundantCondition */ if (!array_key_exists($lowercaseClassName, $this->classNodes)) { // Save `null` so we don't parse the file again for the same $lowercaseClassName $this->classNodes[$lowercaseClassName] = null; } } return $this->classNodes[$lowercaseClassName]; } /** * @return array{0: Node\Stmt\Function_, 1: Node\Stmt\Namespace_|null}|null */ private function getFunctionNodeData(string $functionName) : ?array { $lowercaseFunctionName = strtolower($functionName); if (!array_key_exists($lowercaseFunctionName, self::$functionMap)) { return null; } $filePath = self::$functionMap[$lowercaseFunctionName]; if (!array_key_exists($lowercaseFunctionName, $this->functionNodes)) { $this->parseFile($filePath); /** @psalm-suppress RedundantCondition */ if (!array_key_exists($lowercaseFunctionName, $this->functionNodes)) { // Save `null` so we don't parse the file again for the same $lowercaseFunctionName $this->functionNodes[$lowercaseFunctionName] = null; } } return $this->functionNodes[$lowercaseFunctionName]; } public function generateFunctionStub(string $functionName) : ?\PHPStan\BetterReflection\SourceLocator\SourceStubber\StubData { $functionNodeData = $this->getFunctionNodeData($functionName); if ($functionNodeData === null) { return null; } $filePath = self::$functionMap[strtolower($functionName)]; $extension = $this->getExtensionFromFilePath($filePath); return new \PHPStan\BetterReflection\SourceLocator\SourceStubber\StubData($this->createStub($functionNodeData[0], $functionNodeData[1]), $extension, $this->getAbsoluteFilePath($filePath)); } public function generateConstantStub(string $constantName) : ?\PHPStan\BetterReflection\SourceLocator\SourceStubber\StubData { $lowercaseConstantName = strtolower($constantName); if (!array_key_exists($lowercaseConstantName, self::$constantMap)) { return null; } if (array_key_exists($lowercaseConstantName, $this->constantNodes) && $this->constantNodes[$lowercaseConstantName] === null) { return null; } $filePath = self::$constantMap[$lowercaseConstantName]; $constantNodeData = $this->constantNodes[$constantName] ?? $this->constantNodes[$lowercaseConstantName] ?? null; if ($constantNodeData === null) { $this->parseFile($filePath); $constantNodeData = $this->constantNodes[$constantName] ?? $this->constantNodes[$lowercaseConstantName] ?? null; if ($constantNodeData === null) { // Still `null` - the constant is not case-insensitive. Save `null` so we don't parse the file again for the same $constantName $this->constantNodes[$lowercaseConstantName] = null; return null; } } $extension = $this->getExtensionFromFilePath($filePath); return new \PHPStan\BetterReflection\SourceLocator\SourceStubber\StubData($this->createStub($constantNodeData[0], $constantNodeData[1]), $extension, $this->getAbsoluteFilePath($filePath)); } private function parseFile(string $filePath) : void { $absoluteFilePath = $this->getAbsoluteFilePath($filePath); FileChecker::assertReadableFile($absoluteFilePath); /** @var list<Node\Stmt> $ast */ $ast = $this->phpParser->parse(file_get_contents($absoluteFilePath)); // "@since" and "@removed" annotations in some cases do not contain a PHP version, but an extension version - e.g. "@since 1.3.0" // So we check PHP version only for stubs of core extensions $isCoreExtension = $this->isCoreExtension($this->getExtensionFromFilePath($filePath)); $this->cachingVisitor->clearNodes(); $this->nodeTraverser->traverse($ast); foreach ($this->cachingVisitor->getClassNodes() as $className => $classNodeData) { [$classNode] = $classNodeData; if ($isCoreExtension) { if ($className !== 'Attribute' && $className !== 'ReturnTypeWillChange' && $className !== 'AllowDynamicProperties' && $className !== 'SensitiveParameter' && $className !== 'Override' && !$this->isSupportedInPhpVersion($classNode)) { continue; } $classNode->stmts = $this->modifyStmtsByPhpVersion($classNode->stmts); } $this->classNodes[strtolower($className)] = $classNodeData; } foreach ($this->cachingVisitor->getFunctionNodes() as $functionName => $functionNodesData) { foreach ($functionNodesData as $functionNodeData) { [$functionNode] = $functionNodeData; if ($isCoreExtension) { if (!$this->isSupportedInPhpVersion($functionNode)) { continue; } $this->modifyFunctionReturnTypeByPhpVersion($functionNode); $this->modifyFunctionParametersByPhpVersion($functionNode); } $lowercaseFunctionName = strtolower($functionName); if (array_key_exists($lowercaseFunctionName, $this->functionNodes)) { continue; } $this->functionNodes[$lowercaseFunctionName] = $functionNodeData; } } foreach ($this->cachingVisitor->getConstantNodes() as $constantName => $constantNodeData) { [$constantNode] = $constantNodeData; if ($isCoreExtension && !$this->isSupportedInPhpVersion($constantNode)) { continue; } $this->constantNodes[$constantName] = $constantNodeData; } } /** * @param \PhpParser\Node\Stmt\ClassLike|\PhpParser\Node\Stmt\Function_|\PhpParser\Node\Stmt\Const_|\PhpParser\Node\Expr\FuncCall $node */ private function createStub($node, ?\PhpParser\Node\Stmt\Namespace_ $namespaceNode) : string { if ($node instanceof Node\Expr\FuncCall) { try { ConstantNodeChecker::assertValidDefineFunctionCall($node); $this->addDeprecatedDocComment($node); } catch (InvalidConstantNode $exception) { // just keep going } } if (!$node instanceof Node\Expr\FuncCall) { $this->addDeprecatedDocComment($node); $nodeWithNamespaceName = $node instanceof Node\Stmt\Const_ ? $node->consts[0] : $node; $namespacedName = $nodeWithNamespaceName->namespacedName; assert($namespacedName instanceof Node\Name); $namespaceBuilder = $this->builderFactory->namespace($namespacedName->slice(0, -1)); if ($namespaceNode !== null) { foreach ($namespaceNode->stmts as $stmt) { if (!$stmt instanceof Node\Stmt\Use_ && !$stmt instanceof Node\Stmt\GroupUse) { continue; } $namespaceBuilder->addStmt($stmt); } } $namespaceBuilder->addStmt($node); $node = $namespaceBuilder->getNode(); } return sprintf("<?php\n\n%s%s\n", $this->prettyPrinter->prettyPrint([$node]), $node instanceof Node\Expr\FuncCall ? ';' : ''); } /** @return non-empty-string */ private function getExtensionFromFilePath(string $filePath) : string { $extensionName = explode('/', $filePath)[0]; assert($extensionName !== ''); return $extensionName; } /** @return non-empty-string */ private function getAbsoluteFilePath(string $filePath) : string { return sprintf('%s/%s', $this->getStubsDirectory(), $filePath); } /** * Some stubs extend/implement classes from newer PHP versions. We need to filter those names in regard to set PHP version so that those stubs remain valid. * * @param array<Node\Name> $nameNodes * * @return list<Node\Name> */ private function replaceExtendsOrImplementsByPhpVersion(string $className, array $nameNodes) : array { $modifiedNames = []; foreach ($nameNodes as $nameNode) { $name = $nameNode->toString(); if ($className === ParseError::class) { if ($name === CompileError::class && $this->phpVersion < 70300) { $modifiedNames[] = new Node\Name\FullyQualified(Error::class); continue; } } elseif ($className === SplFixedArray::class) { if ($name === JsonSerializable::class && $this->phpVersion < 80100) { continue; } if ($name === IteratorAggregate::class && $this->phpVersion < 80000) { continue; } if ($name === Iterator::class && $this->phpVersion >= 80000) { continue; } } elseif ($className === SimpleXMLElement::class) { if ($name === RecursiveIterator::class && $this->phpVersion < 80000) { continue; } } elseif ($className === DatePeriod::class || $className === PDOStatement::class) { if ($name === IteratorAggregate::class && $this->phpVersion < 80000) { $modifiedNames[] = new Node\Name\FullyQualified(Traversable::class); continue; } } elseif ($className === SplObjectStorage::class) { if ($name === SeekableIterator::class && $this->phpVersion < 80400) { $modifiedNames[] = new Node\Name\FullyQualified(Iterator::class); continue; } } if ($this->getClassNodeData($name) === null) { continue; } $modifiedNames[] = $nameNode; } return $modifiedNames; } /** * @param array<Node\Stmt> $stmts * * @return list<Node\Stmt> */ private function modifyStmtsByPhpVersion(array $stmts) : array { $newStmts = []; foreach ($stmts as $stmt) { assert($stmt instanceof Node\Stmt\ClassConst || $stmt instanceof Node\Stmt\Property || $stmt instanceof Node\Stmt\ClassMethod || $stmt instanceof Node\Stmt\EnumCase); if (!$this->isSupportedInPhpVersion($stmt)) { continue; } if ($stmt instanceof Node\Stmt\Property) { $this->modifyStmtTypeByPhpVersion($stmt); } if ($stmt instanceof Node\Stmt\ClassMethod) { $this->modifyFunctionReturnTypeByPhpVersion($stmt); $this->modifyFunctionParametersByPhpVersion($stmt); } $this->addDeprecatedDocComment($stmt); $newStmts[] = $stmt; } return $newStmts; } /** * @param \PhpParser\Node\Stmt\Property|\PhpParser\Node\Param $stmt */ private function modifyStmtTypeByPhpVersion($stmt) : void { $type = $this->getStmtType($stmt); if ($type === null) { return; } $stmt->type = $type; } /** * @param \PhpParser\Node\Stmt\ClassMethod|\PhpParser\Node\Stmt\Function_ $function */ private function modifyFunctionReturnTypeByPhpVersion($function) : void { $isTentativeReturnType = $this->getNodeAttribute($function, 'JetBrains\\PhpStorm\\Internal\\TentativeType') !== null; if ($isTentativeReturnType) { // Tentative types are the most correct in stubs // If the type is tentative in stubs, we should remove the type for PHP < 8.1 if ($this->phpVersion >= 80100) { $this->addAnnotationToDocComment($function, AnnotationHelper::TENTATIVE_RETURN_TYPE_ANNOTATION); } else { $function->returnType = null; } return; } $type = $this->getStmtType($function); if ($type === null) { return; } $function->returnType = $type; } /** * @param \PhpParser\Node\Stmt\ClassMethod|\PhpParser\Node\Stmt\Function_ $function */ private function modifyFunctionParametersByPhpVersion($function) : void { $parameters = []; foreach ($function->getParams() as $parameterNode) { if (!$this->isSupportedInPhpVersion($parameterNode)) { continue; } $this->modifyStmtTypeByPhpVersion($parameterNode); $parameters[] = $parameterNode; } $function->params = $parameters; } /** * @param \PhpParser\Node\Stmt\Function_|\PhpParser\Node\Stmt\ClassMethod|\PhpParser\Node\Stmt\Property|\PhpParser\Node\Param $node * @return \PhpParser\Node\Name|\PhpParser\Node\Identifier|\PhpParser\Node\ComplexType|null */ private function getStmtType($node) { $languageLevelTypeAwareAttribute = $this->getNodeAttribute($node, 'JetBrains\\PhpStorm\\Internal\\LanguageLevelTypeAware'); if ($languageLevelTypeAwareAttribute === null) { return null; } assert($languageLevelTypeAwareAttribute->args[0]->value instanceof Node\Expr\Array_); /** @var list<Node\Expr\ArrayItem> $types */ $types = $languageLevelTypeAwareAttribute->args[0]->value->items; usort($types, static function (Node\Expr\ArrayItem $a, Node\Expr\ArrayItem $b) : int { return $b->key <=> $a->key; }); foreach ($types as $type) { assert($type->key instanceof Node\Scalar\String_); assert($type->value instanceof Node\Scalar\String_); if ($this->parsePhpVersion($type->key->value) > $this->phpVersion) { continue; } return $this->normalizeType($type->value->value); } assert($languageLevelTypeAwareAttribute->args[1]->value instanceof Node\Scalar\String_); return $languageLevelTypeAwareAttribute->args[1]->value->value !== '' ? $this->normalizeType($languageLevelTypeAwareAttribute->args[1]->value->value) : null; } /** * @param \PhpParser\Node\Stmt\ClassLike|\PhpParser\Node\Stmt\ClassConst|\PhpParser\Node\Stmt\Property|\PhpParser\Node\Stmt\ClassMethod|\PhpParser\Node\Stmt\Function_|\PhpParser\Node\Expr\FuncCall|\PhpParser\Node\Stmt\Const_|\PhpParser\Node\Stmt\EnumCase $node */ private function addDeprecatedDocComment($node) : void { if ($node instanceof Node\Expr\FuncCall) { if (!$this->isDeprecatedByPhpDocInPhpVersion($node)) { $this->removeAnnotationFromDocComment($node, 'deprecated'); } return; } if ($node instanceof Node\Stmt\Const_) { return; } if (!$this->isDeprecatedInPhpVersion($node)) { $this->removeAnnotationFromDocComment($node, 'deprecated'); return; } $this->addAnnotationToDocComment($node, 'deprecated'); } /** * @param \PhpParser\Node\Stmt\ClassLike|\PhpParser\Node\Stmt\ClassConst|\PhpParser\Node\Stmt\Property|\PhpParser\Node\Stmt\ClassMethod|\PhpParser\Node\Stmt\Function_|\PhpParser\Node\Stmt\Const_|\PhpParser\Node\Stmt\EnumCase $node */ private function addAnnotationToDocComment($node, string $annotationName) : void { $docComment = $node->getDocComment(); if ($docComment === null) { $docCommentText = sprintf('/** @%s */', $annotationName); } else { $docCommentText = preg_replace('~(\\r?\\n\\s*)\\*/~', sprintf('\\1* @%s\\1*/', $annotationName), $docComment->getText()); } $node->setDocComment(new Doc($docCommentText)); } /** * @param \PhpParser\Node\Stmt\ClassLike|\PhpParser\Node\Stmt\ClassConst|\PhpParser\Node\Stmt\Property|\PhpParser\Node\Stmt\ClassMethod|\PhpParser\Node\Stmt\Function_|\PhpParser\Node\Expr\FuncCall|\PhpParser\Node\Stmt\Const_|\PhpParser\Node\Stmt\EnumCase $node */ private function removeAnnotationFromDocComment($node, string $annotationName) : void { $docComment = $node->getDocComment(); if ($docComment === null) { return; } $docCommentText = preg_replace('~@' . $annotationName . '.*$~m', '', $docComment->getText()); $node->setDocComment(new Doc($docCommentText)); } private function isCoreExtension(string $extension) : bool { return in_array($extension, self::CORE_EXTENSIONS, \true); } private function isDeprecatedByPhpDocInPhpVersion(Node\Expr\FuncCall $node) : bool { $docComment = $node->getDocComment(); if ($docComment === null) { return \false; } if (preg_match('#@deprecated\\s+(\\d+)\\.(\\d+)(?:\\.(\\d+))?$#m', $docComment->getText(), $matches) === 1) { $major = $matches[1]; $minor = $matches[2]; $patch = $matches[3] ?? 0; $versionId = sprintf('%d%02d%02d', $major, $minor, $patch); return $this->phpVersion >= $versionId; } return \true; } /** * @param \PhpParser\Node\Stmt\ClassLike|\PhpParser\Node\Stmt\ClassConst|\PhpParser\Node\Stmt\Property|\PhpParser\Node\Stmt\ClassMethod|\PhpParser\Node\Stmt\Function_|\PhpParser\Node\Stmt\EnumCase $node */ private function isDeprecatedInPhpVersion($node) : bool { $deprecatedAttribute = $this->getNodeAttribute($node, 'JetBrains\\PhpStorm\\Deprecated'); if ($deprecatedAttribute === null) { return \false; } foreach ($deprecatedAttribute->args as $attributeArg) { if ($attributeArg->name !== null && $attributeArg->name->toString() === 'since') { assert($attributeArg->value instanceof Node\Scalar\String_); return $this->parsePhpVersion($attributeArg->value->value) <= $this->phpVersion; } } return \true; } /** * @param \PhpParser\Node\Stmt\ClassLike|\PhpParser\Node\Stmt\Function_|\PhpParser\Node\Stmt\Const_|\PhpParser\Node\Expr\FuncCall|\PhpParser\Node\Stmt\ClassConst|\PhpParser\Node\Stmt\Property|\PhpParser\Node\Stmt\ClassMethod|\PhpParser\Node\Param|\PhpParser\Node\Stmt\EnumCase $node */ private function isSupportedInPhpVersion($node) : bool { [$fromVersion, $toVersion] = $this->getSupportedPhpVersions($node); if ($fromVersion !== null && $fromVersion > $this->phpVersion) { return \false; } return $toVersion === null || $toVersion >= $this->phpVersion; } /** @return array{0: int|null, 1: int|null} * @param \PhpParser\Node\Stmt\ClassLike|\PhpParser\Node\Stmt\Function_|\PhpParser\Node\Stmt\Const_|\PhpParser\Node\Expr\FuncCall|\PhpParser\Node\Stmt\ClassConst|\PhpParser\Node\Stmt\Property|\PhpParser\Node\Stmt\ClassMethod|\PhpParser\Node\Param|\PhpParser\Node\Stmt\EnumCase $node */ private function getSupportedPhpVersions($node) : array { $fromVersion = null; $toVersion = null; $docComment = $node->getDocComment(); if ($docComment !== null) { if (preg_match('~@since\\s+(?P<version>\\d+\\.\\d+(?:\\.\\d+)?)\\s+~', $docComment->getText(), $sinceMatches) === 1) { $fromVersion = $this->parsePhpVersion($sinceMatches['version']); } if (preg_match('~@removed\\s+(?P<version>\\d+\\.\\d+(?:\\.\\d+)?)\\s+~', $docComment->getText(), $removedMatches) === 1) { $toVersion = $this->parsePhpVersion($removedMatches['version']) - 1; } } $elementsAvailable = $this->getNodeAttribute($node, 'JetBrains\\PhpStorm\\Internal\\PhpStormStubsElementAvailable'); if ($elementsAvailable !== null) { foreach ($elementsAvailable->args as $i => $attributeArg) { $isFrom = \false; if ($attributeArg->name !== null && $attributeArg->name->toString() === 'from') { $isFrom = \true; } if ($attributeArg->name === null && $i === 0) { $isFrom = \true; } if ($isFrom) { assert($attributeArg->value instanceof Node\Scalar\String_); $fromVersion = $this->parsePhpVersion($attributeArg->value->value); } $isTo = \false; if ($attributeArg->name !== null && $attributeArg->name->toString() === 'to') { $isTo = \true; } if ($attributeArg->name === null && $i === 1) { $isTo = \true; } if (!$isTo) { continue; } assert($attributeArg->value instanceof Node\Scalar\String_); $toVersion = $this->parsePhpVersion($attributeArg->value->value, 99); } } return [$fromVersion, $toVersion]; } /** * @param \PhpParser\Node\Stmt\ClassLike|\PhpParser\Node\Stmt\Function_|\PhpParser\Node\Stmt\Const_|\PhpParser\Node\Expr\FuncCall|\PhpParser\Node\Stmt\ClassConst|\PhpParser\Node\Stmt\Property|\PhpParser\Node\Stmt\ClassMethod|\PhpParser\Node\Param|\PhpParser\Node\Stmt\EnumCase $node */ private function getNodeAttribute($node, string $attributeName) : ?\PhpParser\Node\Attribute { if ($node instanceof Node\Expr\FuncCall || $node instanceof Node\Stmt\Const_) { return null; } foreach ($node->attrGroups as $attributesGroupNode) { foreach ($attributesGroupNode->attrs as $attributeNode) { if ($attributeNode->name->toString() === $attributeName) { return $attributeNode; } } } return null; } private function parsePhpVersion(string $version, int $defaultPatch = 0) : int { $parts = array_map('intval', explode('.', $version)); return $parts[0] * 10000 + $parts[1] * 100 + ($parts[2] ?? $defaultPatch); } /** * @return \PhpParser\Node\Name|\PhpParser\Node\Identifier|\PhpParser\Node\ComplexType|null */ private function normalizeType(string $type) { // There are some invalid types in stubs, eg. `string[]|string|null` if (\strpos($type, '[') !== \false) { return null; } /** @psalm-suppress InternalClass, InternalMethod */ return BuilderHelpers::normalizeType($type); } private function getStubsDirectory() : string { if ($this->stubsDirectory !== null) { return $this->stubsDirectory; } foreach (self::SEARCH_DIRECTORIES as $directory) { if (is_dir($directory)) { return $this->stubsDirectory = $directory; } } // @codeCoverageIgnoreStart // @infection-ignore-all // Untestable code throw CouldNotFindPhpStormStubs::create(); // @codeCoverageIgnoreEnd } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\SourceStubber; /** @internal */ class StubData { /** * @var string */ private $stub; /** * @var non-empty-string|null */ private $extensionName; /** * @var string|null */ private $fileName; /** @param non-empty-string|null $extensionName */ public function __construct(string $stub, ?string $extensionName, ?string $fileName) { $this->stub = $stub; $this->extensionName = $extensionName; $this->fileName = $fileName; } public function getStub() : string { return $this->stub; } /** @return non-empty-string|null */ public function getExtensionName() : ?string { return $this->extensionName; } public function getFileName() : ?string { return $this->fileName; } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\SourceLocator\SourceStubber; use function array_merge; use function array_reduce; use function array_values; class AggregateSourceStubber implements \PHPStan\BetterReflection\SourceLocator\SourceStubber\SourceStubber { /** @var list<SourceStubber> */ private $sourceStubbers; public function __construct(\PHPStan\BetterReflection\SourceLocator\SourceStubber\SourceStubber $sourceStubber, \PHPStan\BetterReflection\SourceLocator\SourceStubber\SourceStubber ...$otherSourceStubbers) { $this->sourceStubbers = array_values(array_merge([$sourceStubber], $otherSourceStubbers)); } /** @param class-string|trait-string $className */ public function generateClassStub(string $className) : ?\PHPStan\BetterReflection\SourceLocator\SourceStubber\StubData { foreach ($this->sourceStubbers as $sourceStubber) { $stubData = $sourceStubber->generateClassStub($className); if ($stubData !== null) { return $stubData; } } return null; } public function generateFunctionStub(string $functionName) : ?\PHPStan\BetterReflection\SourceLocator\SourceStubber\StubData { foreach ($this->sourceStubbers as $sourceStubber) { $stubData = $sourceStubber->generateFunctionStub($functionName); if ($stubData !== null) { return $stubData; } } return null; } public function generateConstantStub(string $constantName) : ?\PHPStan\BetterReflection\SourceLocator\SourceStubber\StubData { return array_reduce($this->sourceStubbers, static function (?\PHPStan\BetterReflection\SourceLocator\SourceStubber\StubData $stubData, \PHPStan\BetterReflection\SourceLocator\SourceStubber\SourceStubber $sourceStubber) use($constantName) : ?\PHPStan\BetterReflection\SourceLocator\SourceStubber\StubData { return $stubData ?? $sourceStubber->generateConstantStub($constantName); }, null); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection; use PhpParser\Node\Identifier; use PhpParser\Node\IntersectionType; use PhpParser\Node\Name; use PhpParser\Node\NullableType; use PhpParser\Node\UnionType; use PHPStan\BetterReflection\Reflector\Reflector; /** @psalm-immutable */ abstract class ReflectionType { /** * @internal * * @psalm-pure * @param \PHPStan\BetterReflection\Reflection\ReflectionParameter|\PHPStan\BetterReflection\Reflection\ReflectionMethod|\PHPStan\BetterReflection\Reflection\ReflectionFunction|\PHPStan\BetterReflection\Reflection\ReflectionEnum|\PHPStan\BetterReflection\Reflection\ReflectionProperty|\PHPStan\BetterReflection\Reflection\ReflectionClassConstant $owner * @param \PhpParser\Node\Identifier|\PhpParser\Node\Name|\PhpParser\Node\NullableType|\PhpParser\Node\UnionType|\PhpParser\Node\IntersectionType $type * @return \PHPStan\BetterReflection\Reflection\ReflectionNamedType|\PHPStan\BetterReflection\Reflection\ReflectionUnionType|\PHPStan\BetterReflection\Reflection\ReflectionIntersectionType */ public static function createFromNode(Reflector $reflector, $owner, $type, bool $allowsNull = \false) { if ($type instanceof NullableType) { $type = $type->type; $allowsNull = \true; } if ($type instanceof Identifier || $type instanceof Name) { if ($type->toLowerString() === 'null' || $type->toLowerString() === 'mixed' || !$allowsNull) { return new \PHPStan\BetterReflection\Reflection\ReflectionNamedType($reflector, $owner, $type); } return new \PHPStan\BetterReflection\Reflection\ReflectionUnionType($reflector, $owner, new UnionType([$type, new Identifier('null')])); } if ($type instanceof IntersectionType) { return new \PHPStan\BetterReflection\Reflection\ReflectionIntersectionType($reflector, $owner, $type); } if (!$allowsNull) { return new \PHPStan\BetterReflection\Reflection\ReflectionUnionType($reflector, $owner, $type); } foreach ($type->types as $innerUnionType) { if (($innerUnionType instanceof Identifier || $innerUnionType instanceof Name) && $innerUnionType->toLowerString() === 'null') { return new \PHPStan\BetterReflection\Reflection\ReflectionUnionType($reflector, $owner, $type); } } $types = $type->types; $types[] = new Identifier('null'); return new \PHPStan\BetterReflection\Reflection\ReflectionUnionType($reflector, $owner, new UnionType($types)); } /** * Does the type allow null? */ public abstract function allowsNull() : bool; /** * Convert this string type to a string * * @return non-empty-string */ public abstract function __toString() : string; } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection; use Attribute; use LogicException; use PhpParser\Node; use PHPStan\BetterReflection\NodeCompiler\CompileNodeToValue; use PHPStan\BetterReflection\NodeCompiler\CompilerContext; use PHPStan\BetterReflection\Reflection\StringCast\ReflectionAttributeStringCast; use PHPStan\BetterReflection\Reflector\Reflector; use function array_map; use function assert; /** @psalm-immutable */ class ReflectionAttribute { /** @var non-empty-string */ private $name; /** @var array<int|string, Node\Expr> */ private $arguments = []; /** * @var \PHPStan\BetterReflection\Reflector\Reflector */ private $reflector; /** * @var \PHPStan\BetterReflection\Reflection\ReflectionClass|\PHPStan\BetterReflection\Reflection\ReflectionMethod|\PHPStan\BetterReflection\Reflection\ReflectionFunction|\PHPStan\BetterReflection\Reflection\ReflectionClassConstant|\PHPStan\BetterReflection\Reflection\ReflectionEnumCase|\PHPStan\BetterReflection\Reflection\ReflectionProperty|\PHPStan\BetterReflection\Reflection\ReflectionParameter */ private $owner; /** * @var bool */ private $isRepeated; /** @internal * @param \PHPStan\BetterReflection\Reflection\ReflectionClass|\PHPStan\BetterReflection\Reflection\ReflectionMethod|\PHPStan\BetterReflection\Reflection\ReflectionFunction|\PHPStan\BetterReflection\Reflection\ReflectionClassConstant|\PHPStan\BetterReflection\Reflection\ReflectionEnumCase|\PHPStan\BetterReflection\Reflection\ReflectionProperty|\PHPStan\BetterReflection\Reflection\ReflectionParameter $owner */ public function __construct(Reflector $reflector, Node\Attribute $node, $owner, bool $isRepeated) { $this->reflector = $reflector; $this->owner = $owner; $this->isRepeated = $isRepeated; $name = $node->name->toString(); assert($name !== ''); $this->name = $name; foreach ($node->args as $argNo => $arg) { $this->arguments[(($argName = $arg->name) ? $argName->toString() : null) ?? $argNo] = $arg->value; } } /** @internal * @param \PHPStan\BetterReflection\Reflection\ReflectionClass|\PHPStan\BetterReflection\Reflection\ReflectionMethod|\PHPStan\BetterReflection\Reflection\ReflectionFunction|\PHPStan\BetterReflection\Reflection\ReflectionClassConstant|\PHPStan\BetterReflection\Reflection\ReflectionEnumCase|\PHPStan\BetterReflection\Reflection\ReflectionProperty|\PHPStan\BetterReflection\Reflection\ReflectionParameter $owner */ public function withOwner($owner) : self { $clone = clone $this; $clone->owner = $owner; return $clone; } /** @return non-empty-string */ public function getName() : string { return $this->name; } public function getClass() : \PHPStan\BetterReflection\Reflection\ReflectionClass { return $this->reflector->reflectClass($this->getName()); } /** @return array<int|string, Node\Expr> */ public function getArgumentsExpressions() : array { return $this->arguments; } /** * @deprecated Use getArgumentsExpressions() * @return array<int|string, mixed> */ public function getArguments() : array { $compiler = new CompileNodeToValue(); $context = new CompilerContext($this->reflector, $this->owner); return array_map(static function (Node\Expr $value) use($compiler, $context) { return $compiler->__invoke($value, $context)->value; }, $this->arguments); } /** @return int-mask-of<Attribute::TARGET_*> */ public function getTarget() : int { switch (\true) { case $this->owner instanceof \PHPStan\BetterReflection\Reflection\ReflectionClass: return Attribute::TARGET_CLASS; case $this->owner instanceof \PHPStan\BetterReflection\Reflection\ReflectionFunction: return Attribute::TARGET_FUNCTION; case $this->owner instanceof \PHPStan\BetterReflection\Reflection\ReflectionMethod: return Attribute::TARGET_METHOD; case $this->owner instanceof \PHPStan\BetterReflection\Reflection\ReflectionProperty: return Attribute::TARGET_PROPERTY; case $this->owner instanceof \PHPStan\BetterReflection\Reflection\ReflectionClassConstant: return Attribute::TARGET_CLASS_CONSTANT; case $this->owner instanceof \PHPStan\BetterReflection\Reflection\ReflectionEnumCase: return Attribute::TARGET_CLASS_CONSTANT; case $this->owner instanceof \PHPStan\BetterReflection\Reflection\ReflectionParameter: return Attribute::TARGET_PARAMETER; default: throw new LogicException('unknown owner'); } } public function isRepeated() : bool { return $this->isRepeated; } /** @return non-empty-string */ public function __toString() : string { return ReflectionAttributeStringCast::toString($this); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\Attribute; use PhpParser\Node; use PHPStan\BetterReflection\Reflection\ReflectionAttribute; use PHPStan\BetterReflection\Reflection\ReflectionClass; use PHPStan\BetterReflection\Reflection\ReflectionClassConstant; use PHPStan\BetterReflection\Reflection\ReflectionEnumCase; use PHPStan\BetterReflection\Reflection\ReflectionFunction; use PHPStan\BetterReflection\Reflection\ReflectionMethod; use PHPStan\BetterReflection\Reflection\ReflectionParameter; use PHPStan\BetterReflection\Reflection\ReflectionProperty; use PHPStan\BetterReflection\Reflector\Reflector; use function array_filter; use function array_values; use function count; /** @internal */ class ReflectionAttributeHelper { /** * @param Node\AttributeGroup[] $attrGroups * * @return list<ReflectionAttribute> * * @psalm-pure * @param \PHPStan\BetterReflection\Reflection\ReflectionClass|\PHPStan\BetterReflection\Reflection\ReflectionMethod|\PHPStan\BetterReflection\Reflection\ReflectionFunction|\PHPStan\BetterReflection\Reflection\ReflectionClassConstant|\PHPStan\BetterReflection\Reflection\ReflectionEnumCase|\PHPStan\BetterReflection\Reflection\ReflectionProperty|\PHPStan\BetterReflection\Reflection\ReflectionParameter $reflection */ public static function createAttributes(Reflector $reflector, $reflection, array $attrGroups) : array { $repeated = []; foreach ($attrGroups as $attributesGroupNode) { foreach ($attributesGroupNode->attrs as $attributeNode) { $repeated[$attributeNode->name->toLowerString()][] = $attributeNode; } } $attributes = []; foreach ($attrGroups as $attributesGroupNode) { foreach ($attributesGroupNode->attrs as $attributeNode) { $attributes[] = new ReflectionAttribute($reflector, $attributeNode, $reflection, count($repeated[$attributeNode->name->toLowerString()]) > 1); } } return $attributes; } /** * @param list<ReflectionAttribute> $attributes * * @return list<ReflectionAttribute> * * @psalm-pure */ public static function filterAttributesByName(array $attributes, string $name) : array { return array_values(array_filter($attributes, static function (ReflectionAttribute $attribute) use($name) : bool { return $attribute->getName() === $name; })); } /** * @param list<ReflectionAttribute> $attributes * @param class-string $className * * @return list<ReflectionAttribute> * * @psalm-pure */ public static function filterAttributesByInstance(array $attributes, string $className) : array { return array_values(array_filter($attributes, static function (ReflectionAttribute $attribute) use($className) : bool { $class = $attribute->getClass(); return $class->getName() === $className || $class->isSubclassOf($className) || $class->implementsInterface($className); })); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\Adapter; use ReflectionType as CoreReflectionType; use PHPStan\BetterReflection\Reflection\ReflectionIntersectionType as BetterReflectionIntersectionType; use PHPStan\BetterReflection\Reflection\ReflectionNamedType as BetterReflectionNamedType; use PHPStan\BetterReflection\Reflection\ReflectionType as BetterReflectionType; use PHPStan\BetterReflection\Reflection\ReflectionUnionType as BetterReflectionUnionType; use function array_filter; use function array_values; use function count; /** @psalm-immutable */ abstract class ReflectionType extends CoreReflectionType { /** @psalm-pure * @param BetterReflectionUnionType|BetterReflectionNamedType|BetterReflectionIntersectionType|null $betterReflectionType * @return \PHPStan\BetterReflection\Reflection\Adapter\ReflectionUnionType|\PHPStan\BetterReflection\Reflection\Adapter\ReflectionNamedType|\PHPStan\BetterReflection\Reflection\Adapter\ReflectionIntersectionType|null */ public static function fromTypeOrNull($betterReflectionType) { return $betterReflectionType !== null ? self::fromType($betterReflectionType) : null; } /** * @internal * * @psalm-pure * @param BetterReflectionNamedType|BetterReflectionUnionType|BetterReflectionIntersectionType $betterReflectionType * @return \PHPStan\BetterReflection\Reflection\Adapter\ReflectionUnionType|\PHPStan\BetterReflection\Reflection\Adapter\ReflectionNamedType|\PHPStan\BetterReflection\Reflection\Adapter\ReflectionIntersectionType */ public static function fromType($betterReflectionType) { if ($betterReflectionType instanceof BetterReflectionUnionType) { // php-src has this weird behavior where a union type composed of a single type `T` // together with `null` means that a `ReflectionNamedType` for `?T` is produced, // rather than `T|null`. This is done to keep BC compatibility with PHP 7.1 (which // introduced nullable types), but at reflection level, this is mostly a nuisance. // In order to keep parity with core, we stashed this weird behavior in here. $nonNullTypes = array_values(array_filter($betterReflectionType->getTypes(), static function (BetterReflectionType $type) : bool { return !($type instanceof BetterReflectionNamedType && $type->getName() === 'null'); })); if ($betterReflectionType->allowsNull() && count($nonNullTypes) === 1 && $nonNullTypes[0] instanceof BetterReflectionNamedType) { return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionNamedType($nonNullTypes[0], \true); } return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionUnionType($betterReflectionType); } if ($betterReflectionType instanceof BetterReflectionIntersectionType) { return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionIntersectionType($betterReflectionType); } return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionNamedType($betterReflectionType, $betterReflectionType->allowsNull()); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\Adapter; use Attribute; use PhpParser\Node\Expr; use ReflectionAttribute as CoreReflectionAttribute; use PHPStan\BetterReflection\Reflection\ReflectionAttribute as BetterReflectionAttribute; /** @template-extends CoreReflectionAttribute<object> */ final class ReflectionAttribute extends CoreReflectionAttribute { /** * @var BetterReflectionAttribute */ private $betterReflectionAttribute; public function __construct(BetterReflectionAttribute $betterReflectionAttribute) { $this->betterReflectionAttribute = $betterReflectionAttribute; } /** @psalm-mutation-free */ public function getName() : string { return $this->betterReflectionAttribute->getName(); } /** * @return int-mask-of<Attribute::TARGET_*> * * @psalm-mutation-free * @psalm-suppress ImplementedReturnTypeMismatch */ public function getTarget() : int { return $this->betterReflectionAttribute->getTarget(); } /** @psalm-mutation-free */ public function isRepeated() : bool { return $this->betterReflectionAttribute->isRepeated(); } /** * @deprecated Use getArgumentsExpressions() * @return array<int|string, mixed> */ public function getArguments() : array { return $this->betterReflectionAttribute->getArguments(); } /** @return array<int|string, Expr> */ public function getArgumentsExpressions() : array { return $this->betterReflectionAttribute->getArgumentsExpressions(); } public function newInstance() : object { $class = $this->getName(); return new $class(...$this->getArguments()); } /** @return non-empty-string */ public function __toString() : string { return $this->betterReflectionAttribute->__toString(); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\Adapter; use OutOfBoundsException; use PhpParser\Node\Expr; use ReflectionEnumBackedCase as CoreReflectionEnumBackedCase; use PHPStan\BetterReflection\Reflection\ReflectionAttribute as BetterReflectionAttribute; use PHPStan\BetterReflection\Reflection\ReflectionEnumCase as BetterReflectionEnumCase; use UnitEnum; use ValueError; use function array_map; use function sprintf; /** * @psalm-suppress PropertyNotSetInConstructor * @psalm-immutable */ final class ReflectionEnumBackedCase extends CoreReflectionEnumBackedCase { public function __construct(private BetterReflectionEnumCase $betterReflectionEnumCase) { unset($this->name); unset($this->class); } /** * Get the name of the reflection (e.g. if this is a ReflectionClass this * will be the class name). */ public function getName() : string { return $this->betterReflectionEnumCase->getName(); } public function hasType() : bool { return \false; } public function getType() : \PHPStan\BetterReflection\Reflection\Adapter\ReflectionUnionType|\PHPStan\BetterReflection\Reflection\Adapter\ReflectionNamedType|\PHPStan\BetterReflection\Reflection\Adapter\ReflectionIntersectionType|null { return null; } public function getValue() : UnitEnum { throw new \PHPStan\BetterReflection\Reflection\Adapter\Exception\NotImplemented('Not implemented'); } public function isPublic() : bool { return \true; } public function isPrivate() : bool { return \false; } public function isProtected() : bool { return \false; } public function getModifiers() : int { return self::IS_PUBLIC; } public function getDeclaringClass() : \PHPStan\BetterReflection\Reflection\Adapter\ReflectionClass { return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionClass($this->betterReflectionEnumCase->getDeclaringClass()); } public function getDocComment() : string|false { return $this->betterReflectionEnumCase->getDocComment() ?? \false; } /** @return non-empty-string */ public function __toString() : string { return $this->betterReflectionEnumCase->__toString(); } /** * @param class-string|null $name * * @return list<ReflectionAttribute|FakeReflectionAttribute> */ public function getAttributes(string|null $name = null, int $flags = 0) : array { if ($flags !== 0 && $flags !== \PHPStan\BetterReflection\Reflection\Adapter\ReflectionAttribute::IS_INSTANCEOF) { throw new ValueError('Argument #2 ($flags) must be a valid attribute filter flag'); } if ($name !== null && $flags !== 0) { $attributes = $this->betterReflectionEnumCase->getAttributesByInstance($name); } elseif ($name !== null) { $attributes = $this->betterReflectionEnumCase->getAttributesByName($name); } else { $attributes = $this->betterReflectionEnumCase->getAttributes(); } /** @psalm-suppress ImpureFunctionCall */ return array_map(static fn(BetterReflectionAttribute $betterReflectionAttribute): \PHPStan\BetterReflection\Reflection\Adapter\ReflectionAttribute|\PHPStan\BetterReflection\Reflection\Adapter\FakeReflectionAttribute => \PHPStan\BetterReflection\Reflection\Adapter\ReflectionAttributeFactory::create($betterReflectionAttribute), $attributes); } public function isFinal() : bool { return \true; } public function isEnumCase() : bool { return \true; } public function getEnum() : \PHPStan\BetterReflection\Reflection\Adapter\ReflectionEnum { return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionEnum($this->betterReflectionEnumCase->getDeclaringEnum()); } /** * @deprecated Use getValueExpression() */ public function getBackingValue() : int|string { return $this->betterReflectionEnumCase->getValue(); } /** * @deprecated Use getValueExpression() */ public function getValueExpr() : Expr { return $this->getValueExpression(); } public function getValueExpression() : Expr { return $this->betterReflectionEnumCase->getValueExpression(); } public function __get(string $name) : mixed { if ($name === 'name') { return $this->betterReflectionEnumCase->getName(); } if ($name === 'class') { return $this->betterReflectionEnumCase->getDeclaringClass()->getName(); } throw new OutOfBoundsException(sprintf('Property %s::$%s does not exist.', self::class, $name)); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\Adapter; use OutOfBoundsException; use ReflectionClass as CoreReflectionClass; use ReflectionEnum as CoreReflectionEnum; use ReflectionException as CoreReflectionException; use ReflectionExtension as CoreReflectionExtension; use ReflectionMethod as CoreReflectionMethod; use PHPStan\BetterReflection\Reflection\ReflectionAttribute as BetterReflectionAttribute; use PHPStan\BetterReflection\Reflection\ReflectionClass as BetterReflectionClass; use PHPStan\BetterReflection\Reflection\ReflectionClassConstant as BetterReflectionClassConstant; use PHPStan\BetterReflection\Reflection\ReflectionEnum as BetterReflectionEnum; use PHPStan\BetterReflection\Reflection\ReflectionEnumCase as BetterReflectionEnumCase; use PHPStan\BetterReflection\Reflection\ReflectionMethod as BetterReflectionMethod; use PHPStan\BetterReflection\Reflection\ReflectionProperty as BetterReflectionProperty; use PHPStan\BetterReflection\Util\FileHelper; use ValueError; use function array_combine; use function array_map; use function array_values; use function constant; use function sprintf; use function strtolower; /** * @psalm-suppress PropertyNotSetInConstructor * @psalm-immutable */ final class ReflectionEnum extends CoreReflectionEnum { public function __construct(private BetterReflectionEnum $betterReflectionEnum) { unset($this->name); } /** @return non-empty-string */ public function __toString() : string { return $this->betterReflectionEnum->__toString(); } public function __get(string $name) : mixed { if ($name === 'name') { return $this->betterReflectionEnum->getName(); } throw new OutOfBoundsException(sprintf('Property %s::$%s does not exist.', self::class, $name)); } /** @return class-string */ public function getName() : string { return $this->betterReflectionEnum->getName(); } public function isAnonymous() : bool { return $this->betterReflectionEnum->isAnonymous(); } public function isInternal() : bool { return $this->betterReflectionEnum->isInternal(); } public function isUserDefined() : bool { return $this->betterReflectionEnum->isUserDefined(); } public function isInstantiable() : bool { return $this->betterReflectionEnum->isInstantiable(); } public function isCloneable() : bool { return $this->betterReflectionEnum->isCloneable(); } /** @return non-empty-string|false */ public function getFileName() : string|false { $fileName = $this->betterReflectionEnum->getFileName(); return $fileName !== null ? FileHelper::normalizeSystemPath($fileName) : \false; } public function getStartLine() : int|false { return $this->betterReflectionEnum->getStartLine(); } public function getEndLine() : int|false { return $this->betterReflectionEnum->getEndLine(); } public function getDocComment() : string|false { return $this->betterReflectionEnum->getDocComment() ?? \false; } /** @return ReflectionMethod|null */ public function getConstructor() : ?CoreReflectionMethod { $constructor = $this->betterReflectionEnum->getConstructor(); if ($constructor === null) { return null; } return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionMethod($constructor); } public function hasMethod(string $name) : bool { if ($name === '') { return \false; } return $this->betterReflectionEnum->hasMethod($name); } public function getMethod(string $name) : \PHPStan\BetterReflection\Reflection\Adapter\ReflectionMethod { $method = $name !== '' ? $this->betterReflectionEnum->getMethod($name) : null; if ($method === null) { throw new CoreReflectionException(sprintf('Method %s::%s() does not exist', $this->betterReflectionEnum->getName(), $name)); } return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionMethod($method); } /** * @param int-mask-of<ReflectionMethod::IS_*>|null $filter * * @return list<ReflectionMethod> */ public function getMethods(int|null $filter = null) : array { /** @psalm-suppress ImpureFunctionCall */ return array_values(array_map(static fn(BetterReflectionMethod $method): \PHPStan\BetterReflection\Reflection\Adapter\ReflectionMethod => new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionMethod($method), $this->betterReflectionEnum->getMethods($filter ?? 0))); } public function hasProperty(string $name) : bool { if ($name === '') { return \false; } return $this->betterReflectionEnum->hasProperty($name); } public function getProperty(string $name) : \PHPStan\BetterReflection\Reflection\Adapter\ReflectionProperty { $betterReflectionProperty = $name !== '' ? $this->betterReflectionEnum->getProperty($name) : null; if ($betterReflectionProperty === null) { throw new CoreReflectionException(sprintf('Property %s::$%s does not exist', $this->betterReflectionEnum->getName(), $name)); } return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionProperty($betterReflectionProperty); } /** * @param int-mask-of<ReflectionProperty::IS_*>|null $filter * * @return list<ReflectionProperty> */ public function getProperties(int|null $filter = null) : array { /** @psalm-suppress ImpureFunctionCall */ return array_values(array_map(static fn(BetterReflectionProperty $property): \PHPStan\BetterReflection\Reflection\Adapter\ReflectionProperty => new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionProperty($property), $this->betterReflectionEnum->getProperties($filter ?? 0))); } public function hasConstant(string $name) : bool { if ($name === '') { return \false; } return $this->betterReflectionEnum->hasCase($name) || $this->betterReflectionEnum->hasConstant($name); } /** * @deprecated Use getReflectionConstants() * * @param int-mask-of<ReflectionClassConstant::IS_*>|null $filter * * @return array<non-empty-string, mixed> */ public function getConstants(int|null $filter = null) : array { /** @psalm-suppress ImpureFunctionCall */ return array_map(fn(BetterReflectionClassConstant|BetterReflectionEnumCase $betterConstantOrEnumCase): mixed => $this->getConstantValue($betterConstantOrEnumCase), $this->filterBetterReflectionClassConstants($filter)); } /** * @deprecated Use getReflectionConstant() */ public function getConstant(string $name) : mixed { if ($name === '') { return \false; } $enumCase = $this->betterReflectionEnum->getCase($name); if ($enumCase !== null) { return $this->getConstantValue($enumCase); } $betterReflectionConstant = $this->betterReflectionEnum->getConstant($name); if ($betterReflectionConstant === null) { return \false; } return $betterReflectionConstant->getValue(); } private function getConstantValue(BetterReflectionClassConstant|BetterReflectionEnumCase $betterConstantOrEnumCase) : mixed { if ($betterConstantOrEnumCase instanceof BetterReflectionEnumCase) { throw new \PHPStan\BetterReflection\Reflection\Adapter\Exception\NotImplemented('Not implemented'); } return $betterConstantOrEnumCase->getValue(); } public function getReflectionConstant(string $name) : \PHPStan\BetterReflection\Reflection\Adapter\ReflectionClassConstant|false { if ($name === '') { return \false; } // @infection-ignore-all Coalesce: There's no difference $betterReflectionConstantOrEnumCase = $this->betterReflectionEnum->getCase($name) ?? $this->betterReflectionEnum->getConstant($name); if ($betterReflectionConstantOrEnumCase === null) { return \false; } return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionClassConstant($betterReflectionConstantOrEnumCase); } /** * @param int-mask-of<ReflectionClassConstant::IS_*>|null $filter * * @return list<ReflectionClassConstant> */ public function getReflectionConstants(int|null $filter = null) : array { return array_values(array_map(static fn(BetterReflectionClassConstant|BetterReflectionEnumCase $betterConstantOrEnum): \PHPStan\BetterReflection\Reflection\Adapter\ReflectionClassConstant => new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionClassConstant($betterConstantOrEnum), $this->filterBetterReflectionClassConstants($filter))); } /** * @param int-mask-of<ReflectionClassConstant::IS_*>|null $filter * * @return array<non-empty-string, BetterReflectionClassConstant|BetterReflectionEnumCase> */ private function filterBetterReflectionClassConstants(int|null $filter) : array { $reflectionConstants = $this->betterReflectionEnum->getConstants($filter ?? 0); if ($filter === null || $filter & \PHPStan\BetterReflection\Reflection\Adapter\ReflectionClassConstant::IS_PUBLIC_COMPATIBILITY) { $reflectionConstants += $this->betterReflectionEnum->getCases(); } return $reflectionConstants; } /** @return array<class-string, ReflectionClass> */ public function getInterfaces() : array { /** @psalm-suppress ImpureFunctionCall */ return array_map(static fn(BetterReflectionClass $interface): \PHPStan\BetterReflection\Reflection\Adapter\ReflectionClass => new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionClass($interface), $this->betterReflectionEnum->getInterfaces()); } /** @return list<class-string> */ public function getInterfaceNames() : array { return $this->betterReflectionEnum->getInterfaceNames(); } public function isInterface() : bool { return $this->betterReflectionEnum->isInterface(); } /** @return array<trait-string, ReflectionClass> */ public function getTraits() : array { $traits = $this->betterReflectionEnum->getTraits(); /** @var list<trait-string> $traitNames */ $traitNames = array_map(static fn(BetterReflectionClass $trait): string => $trait->getName(), $traits); /** @psalm-suppress ImpureFunctionCall */ return array_combine($traitNames, array_map(static fn(BetterReflectionClass $trait): \PHPStan\BetterReflection\Reflection\Adapter\ReflectionClass => new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionClass($trait), $traits)); } /** @return list<trait-string> */ public function getTraitNames() : array { return $this->betterReflectionEnum->getTraitNames(); } /** @return array<non-empty-string, non-empty-string> */ public function getTraitAliases() : array { return $this->betterReflectionEnum->getTraitAliases(); } public function isTrait() : bool { return $this->betterReflectionEnum->isTrait(); } public function isAbstract() : bool { return $this->betterReflectionEnum->isAbstract(); } public function isFinal() : bool { return $this->betterReflectionEnum->isFinal(); } public function isReadOnly() : bool { return $this->betterReflectionEnum->isReadOnly(); } public function getModifiers() : int { return $this->betterReflectionEnum->getModifiers(); } public function isInstance(object $object) : bool { return $this->betterReflectionEnum->isInstance($object); } public function newInstance(mixed ...$args) : object { throw new \PHPStan\BetterReflection\Reflection\Adapter\Exception\NotImplemented('Not implemented'); } public function newInstanceWithoutConstructor() : object { throw new \PHPStan\BetterReflection\Reflection\Adapter\Exception\NotImplemented('Not implemented'); } public function newInstanceArgs(array|null $args = null) : object { throw new \PHPStan\BetterReflection\Reflection\Adapter\Exception\NotImplemented('Not implemented'); } public function getParentClass() : \PHPStan\BetterReflection\Reflection\Adapter\ReflectionClass|false { return \false; } public function isSubclassOf(CoreReflectionClass|string $class) : bool { $realParentClassNames = $this->betterReflectionEnum->getParentClassNames(); $parentClassNames = array_combine(array_map(static fn(string $parentClassName): string => strtolower($parentClassName), $realParentClassNames), $realParentClassNames); $className = $class instanceof CoreReflectionClass ? $class->getName() : $class; $lowercasedClassName = strtolower($className); $realParentClassName = $parentClassNames[$lowercasedClassName] ?? $className; if ($this->betterReflectionEnum->isSubclassOf($realParentClassName)) { return \true; } return $this->implementsInterface($className); } /** * @return array<string, mixed> * * @psalm-suppress LessSpecificImplementedReturnType */ public function getStaticProperties() : array { return $this->betterReflectionEnum->getStaticProperties(); } public function getStaticPropertyValue(string $name, mixed $default = null) : mixed { throw new CoreReflectionException(sprintf('Property %s::$%s does not exist', $this->betterReflectionEnum->getName(), $name)); } public function setStaticPropertyValue(string $name, mixed $value) : void { throw new CoreReflectionException(sprintf('Class %s does not have a property named %s', $this->betterReflectionEnum->getName(), $name)); } /** @return array<non-empty-string, mixed> */ public function getDefaultProperties() : array { return $this->betterReflectionEnum->getDefaultProperties(); } public function isIterateable() : bool { return $this->betterReflectionEnum->isIterateable(); } public function isIterable() : bool { return $this->isIterateable(); } public function implementsInterface(CoreReflectionClass|string $interface) : bool { $realInterfaceNames = $this->betterReflectionEnum->getInterfaceNames(); $interfaceNames = array_combine(array_map(static fn(string $interfaceName): string => strtolower($interfaceName), $realInterfaceNames), $realInterfaceNames); $interfaceName = $interface instanceof CoreReflectionClass ? $interface->getName() : $interface; $lowercasedInterfaceName = strtolower($interfaceName); $realInterfaceName = $interfaceNames[$lowercasedInterfaceName] ?? $interfaceName; return $this->betterReflectionEnum->implementsInterface($realInterfaceName); } public function getExtension() : ?CoreReflectionExtension { throw new \PHPStan\BetterReflection\Reflection\Adapter\Exception\NotImplemented('Not implemented'); } /** @return non-empty-string|false */ public function getExtensionName() : string|false { return $this->betterReflectionEnum->getExtensionName() ?? \false; } public function inNamespace() : bool { return $this->betterReflectionEnum->inNamespace(); } public function getNamespaceName() : string { return $this->betterReflectionEnum->getNamespaceName() ?? ''; } public function getShortName() : string { return $this->betterReflectionEnum->getShortName(); } /** * @param class-string|null $name * * @return list<ReflectionAttribute|FakeReflectionAttribute> */ public function getAttributes(string|null $name = null, int $flags = 0) : array { if ($flags !== 0 && $flags !== \PHPStan\BetterReflection\Reflection\Adapter\ReflectionAttribute::IS_INSTANCEOF) { throw new ValueError('Argument #2 ($flags) must be a valid attribute filter flag'); } if ($name !== null && $flags !== 0) { $attributes = $this->betterReflectionEnum->getAttributesByInstance($name); } elseif ($name !== null) { $attributes = $this->betterReflectionEnum->getAttributesByName($name); } else { $attributes = $this->betterReflectionEnum->getAttributes(); } /** @psalm-suppress ImpureFunctionCall */ return array_map(static fn(BetterReflectionAttribute $betterReflectionAttribute): \PHPStan\BetterReflection\Reflection\Adapter\ReflectionAttribute|\PHPStan\BetterReflection\Reflection\Adapter\FakeReflectionAttribute => \PHPStan\BetterReflection\Reflection\Adapter\ReflectionAttributeFactory::create($betterReflectionAttribute), $attributes); } public function isEnum() : bool { return $this->betterReflectionEnum->isEnum(); } public function hasCase(string $name) : bool { if ($name === '') { return \false; } return $this->betterReflectionEnum->hasCase($name); } public function getCase(string $name) : \PHPStan\BetterReflection\Reflection\Adapter\ReflectionEnumUnitCase|\PHPStan\BetterReflection\Reflection\Adapter\ReflectionEnumBackedCase { $case = $name !== '' ? $this->betterReflectionEnum->getCase($name) : null; if ($case === null) { throw new CoreReflectionException(sprintf('Case %s::%s does not exist', $this->betterReflectionEnum->getName(), $name)); } if ($this->betterReflectionEnum->isBacked()) { return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionEnumBackedCase($case); } return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionEnumUnitCase($case); } /** @return list<ReflectionEnumUnitCase|ReflectionEnumBackedCase> */ public function getCases() : array { /** @psalm-suppress ImpureFunctionCall */ return array_map(function (BetterReflectionEnumCase $case) : \PHPStan\BetterReflection\Reflection\Adapter\ReflectionEnumUnitCase|\PHPStan\BetterReflection\Reflection\Adapter\ReflectionEnumBackedCase { if ($this->betterReflectionEnum->isBacked()) { return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionEnumBackedCase($case); } return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionEnumUnitCase($case); }, array_values($this->betterReflectionEnum->getCases())); } public function isBacked() : bool { return $this->betterReflectionEnum->isBacked(); } public function getBackingType() : \PHPStan\BetterReflection\Reflection\Adapter\ReflectionNamedType|null { if ($this->betterReflectionEnum->isBacked()) { return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionNamedType($this->betterReflectionEnum->getBackingType(), \false); } return null; } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\Adapter; use ReflectionIntersectionType as CoreReflectionIntersectionType; use PHPStan\BetterReflection\Reflection\ReflectionIntersectionType as BetterReflectionIntersectionType; use PHPStan\BetterReflection\Reflection\ReflectionNamedType as BetterReflectionNamedType; use function array_map; use function assert; /** @psalm-immutable */ class ReflectionIntersectionType extends CoreReflectionIntersectionType { /** * @var BetterReflectionIntersectionType */ private $betterReflectionType; public function __construct(BetterReflectionIntersectionType $betterReflectionType) { $this->betterReflectionType = $betterReflectionType; } /** @return non-empty-list<ReflectionNamedType> */ public function getTypes() : array { return array_map(static function (BetterReflectionNamedType $type) : \PHPStan\BetterReflection\Reflection\Adapter\ReflectionNamedType { $adapterType = \PHPStan\BetterReflection\Reflection\Adapter\ReflectionType::fromType($type); assert($adapterType instanceof \PHPStan\BetterReflection\Reflection\Adapter\ReflectionNamedType); return $adapterType; }, $this->betterReflectionType->getTypes()); } /** @return non-empty-string */ public function __toString() : string { return $this->betterReflectionType->__toString(); } /** @return false */ public function allowsNull() : bool { return $this->betterReflectionType->allowsNull(); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\Adapter; use LogicException; use OutOfBoundsException; use PhpParser\Node\Expr; use ReflectionClass as CoreReflectionClass; use ReflectionFunctionAbstract as CoreReflectionFunctionAbstract; use ReflectionParameter as CoreReflectionParameter; use ReturnTypeWillChange; use PHPStan\BetterReflection\Reflection\ReflectionAttribute as BetterReflectionAttribute; use PHPStan\BetterReflection\Reflection\ReflectionIntersectionType as BetterReflectionIntersectionType; use PHPStan\BetterReflection\Reflection\ReflectionMethod as BetterReflectionMethod; use PHPStan\BetterReflection\Reflection\ReflectionNamedType as BetterReflectionNamedType; use PHPStan\BetterReflection\Reflection\ReflectionParameter as BetterReflectionParameter; use PHPStan\BetterReflection\Reflection\ReflectionType as BetterReflectionType; use PHPStan\BetterReflection\Reflection\ReflectionUnionType as BetterReflectionUnionType; use ValueError; use function array_map; use function count; use function sprintf; use function strtolower; /** * @psalm-suppress PropertyNotSetInConstructor * @psalm-immutable */ final class ReflectionParameter extends CoreReflectionParameter { /** * @var BetterReflectionParameter */ private $betterReflectionParameter; public function __construct(BetterReflectionParameter $betterReflectionParameter) { $this->betterReflectionParameter = $betterReflectionParameter; unset($this->name); } /** @return non-empty-string */ public function __toString() : string { return $this->betterReflectionParameter->__toString(); } public function getName() : string { return $this->betterReflectionParameter->getName(); } public function isPassedByReference() : bool { return $this->betterReflectionParameter->isPassedByReference(); } public function canBePassedByValue() : bool { return $this->betterReflectionParameter->canBePassedByValue(); } /** * @return ReflectionFunction|ReflectionMethod */ public function getDeclaringFunction() : CoreReflectionFunctionAbstract { $function = $this->betterReflectionParameter->getDeclaringFunction(); if ($function instanceof BetterReflectionMethod) { return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionMethod($function); } return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionFunction($function); } /** @return ReflectionClass|null */ public function getDeclaringClass() : ?CoreReflectionClass { $declaringClass = $this->betterReflectionParameter->getDeclaringClass(); if ($declaringClass === null) { return null; } return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionClass($declaringClass); } /** @return ReflectionClass|null */ public function getClass() : ?CoreReflectionClass { $type = $this->betterReflectionParameter->getType(); if ($type === null) { return null; } if ($type instanceof BetterReflectionIntersectionType) { return null; } if ($type instanceof BetterReflectionNamedType) { $classType = $type; } else { $unionTypes = $type->getTypes(); if (count($unionTypes) !== 2) { return null; } if (!$type->allowsNull()) { return null; } foreach ($unionTypes as $unionInnerType) { if (!$unionInnerType instanceof BetterReflectionNamedType) { return null; } if ($unionInnerType->allowsNull()) { continue; } $classType = $unionInnerType; break; } } try { /** @phpstan-ignore-next-line */ return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionClass($classType->getClass()); } catch (LogicException $exception) { return null; } } public function isArray() : bool { return $this->isType($this->betterReflectionParameter->getType(), 'array'); } public function isCallable() : bool { return $this->isType($this->betterReflectionParameter->getType(), 'callable'); } /** * For isArray() and isCallable(). * @param BetterReflectionNamedType|BetterReflectionUnionType|BetterReflectionIntersectionType|null $typeReflection */ private function isType($typeReflection, string $type) : bool { if ($typeReflection === null) { return \false; } if ($typeReflection instanceof BetterReflectionIntersectionType) { return \false; } $isOneOfAllowedTypes = static function (BetterReflectionType $namedType, string ...$types) : bool { foreach ($types as $type) { if ($namedType instanceof BetterReflectionNamedType && strtolower($namedType->getName()) === $type) { return \true; } } return \false; }; if ($typeReflection instanceof BetterReflectionUnionType) { $unionTypes = $typeReflection->getTypes(); foreach ($unionTypes as $unionType) { if (!$isOneOfAllowedTypes($unionType, $type, 'null')) { return \false; } } return \true; } return $isOneOfAllowedTypes($typeReflection, $type); } public function allowsNull() : bool { return $this->betterReflectionParameter->allowsNull(); } public function getPosition() : int { return $this->betterReflectionParameter->getPosition(); } public function isOptional() : bool { return $this->betterReflectionParameter->isOptional(); } public function isVariadic() : bool { return $this->betterReflectionParameter->isVariadic(); } public function isDefaultValueAvailable() : bool { return $this->betterReflectionParameter->isDefaultValueAvailable(); } /** * @deprecated Use getDefaultValueExpression() */ #[\ReturnTypeWillChange] public function getDefaultValue() { return $this->betterReflectionParameter->getDefaultValue(); } /** * @deprecated Use getDefaultValueExpression() */ public function getDefaultValueExpr() : Expr { return $this->betterReflectionParameter->getDefaultValueExpression(); } public function getDefaultValueExpression() : Expr { return $this->betterReflectionParameter->getDefaultValueExpression(); } public function isDefaultValueConstant() : bool { return $this->betterReflectionParameter->isDefaultValueConstant(); } public function getDefaultValueConstantName() : string { return $this->betterReflectionParameter->getDefaultValueConstantName(); } public function hasType() : bool { return $this->betterReflectionParameter->hasType(); } /** * @return ReflectionUnionType|ReflectionNamedType|ReflectionIntersectionType|null */ public function getType() : ?\ReflectionType { return \PHPStan\BetterReflection\Reflection\Adapter\ReflectionType::fromTypeOrNull($this->betterReflectionParameter->getType()); } public function isPromoted() : bool { return $this->betterReflectionParameter->isPromoted(); } /** * @param class-string|null $name * * @return list<ReflectionAttribute|FakeReflectionAttribute> */ public function getAttributes(?string $name = null, int $flags = 0) : array { if ($flags !== 0 && $flags !== \PHPStan\BetterReflection\Reflection\Adapter\ReflectionAttribute::IS_INSTANCEOF) { throw new ValueError('Argument #2 ($flags) must be a valid attribute filter flag'); } if ($name !== null && $flags !== 0) { $attributes = $this->betterReflectionParameter->getAttributesByInstance($name); } elseif ($name !== null) { $attributes = $this->betterReflectionParameter->getAttributesByName($name); } else { $attributes = $this->betterReflectionParameter->getAttributes(); } /** @psalm-suppress ImpureFunctionCall */ return array_map(static function (BetterReflectionAttribute $betterReflectionAttribute) { return \PHPStan\BetterReflection\Reflection\Adapter\ReflectionAttributeFactory::create($betterReflectionAttribute); }, $attributes); } /** * @return mixed */ public function __get(string $name) { if ($name === 'name') { return $this->betterReflectionParameter->getName(); } throw new OutOfBoundsException(sprintf('Property %s::$%s does not exist.', self::class, $name)); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\Adapter; use OutOfBoundsException; use ReflectionClass as CoreReflectionClass; use ReflectionException as CoreReflectionException; use ReflectionExtension as CoreReflectionExtension; use ReflectionMethod as CoreReflectionMethod; use ReturnTypeWillChange; use PHPStan\BetterReflection\Reflection\ReflectionAttribute as BetterReflectionAttribute; use PHPStan\BetterReflection\Reflection\ReflectionClass as BetterReflectionClass; use PHPStan\BetterReflection\Reflection\ReflectionClassConstant as BetterReflectionClassConstant; use PHPStan\BetterReflection\Reflection\ReflectionEnum as BetterReflectionEnum; use PHPStan\BetterReflection\Reflection\ReflectionEnumCase as BetterReflectionEnumCase; use PHPStan\BetterReflection\Reflection\ReflectionMethod as BetterReflectionMethod; use PHPStan\BetterReflection\Reflection\ReflectionProperty as BetterReflectionProperty; use PHPStan\BetterReflection\Util\ClassExistenceChecker; use PHPStan\BetterReflection\Util\FileHelper; use ValueError; use function array_combine; use function array_map; use function array_values; use function constant; use function func_get_args; use function func_num_args; use function sprintf; use function strtolower; /** * @template-extends CoreReflectionClass<object> * @psalm-suppress PropertyNotSetInConstructor */ final class ReflectionClass extends CoreReflectionClass { /** @internal */ public const IS_READONLY_COMPATIBILITY = 65536; /** * @var BetterReflectionClass|BetterReflectionEnum */ private $betterReflectionClass; /** * @param BetterReflectionClass|BetterReflectionEnum $betterReflectionClass */ public function __construct($betterReflectionClass) { $this->betterReflectionClass = $betterReflectionClass; unset($this->name); } /** @return non-empty-string */ public function __toString() : string { return $this->betterReflectionClass->__toString(); } /** * @return mixed */ public function __get(string $name) { if ($name === 'name') { return $this->betterReflectionClass->getName(); } throw new OutOfBoundsException(sprintf('Property %s::$%s does not exist.', self::class, $name)); } /** * @psalm-mutation-free * @return class-string */ public function getName() : string { return $this->betterReflectionClass->getName(); } /** @psalm-mutation-free */ public function isAnonymous() : bool { return $this->betterReflectionClass->isAnonymous(); } /** @psalm-mutation-free */ public function isInternal() : bool { return $this->betterReflectionClass->isInternal(); } /** @psalm-mutation-free */ public function isUserDefined() : bool { return $this->betterReflectionClass->isUserDefined(); } /** @psalm-mutation-free */ public function isInstantiable() : bool { return $this->betterReflectionClass->isInstantiable(); } /** @psalm-mutation-free */ public function isCloneable() : bool { return $this->betterReflectionClass->isCloneable(); } /** * {@inheritDoc} */ #[\ReturnTypeWillChange] public function getFileName() { $fileName = $this->betterReflectionClass->getFileName(); return $fileName !== null ? FileHelper::normalizeSystemPath($fileName) : \false; } /** * {@inheritDoc} */ #[\ReturnTypeWillChange] public function getStartLine() { return $this->betterReflectionClass->getStartLine(); } /** * {@inheritDoc} */ #[\ReturnTypeWillChange] public function getEndLine() { return $this->betterReflectionClass->getEndLine(); } /** * {@inheritDoc} */ #[\ReturnTypeWillChange] public function getDocComment() { return $this->betterReflectionClass->getDocComment() ?? \false; } /** * @psalm-mutation-free * @return ReflectionMethod|null */ public function getConstructor() : ?CoreReflectionMethod { $constructor = $this->betterReflectionClass->getConstructor(); if ($constructor === null) { return null; } return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionMethod($constructor); } /** * {@inheritDoc} */ public function hasMethod($name) : bool { if ($name === '') { return \false; } return $this->betterReflectionClass->hasMethod($name); } /** * @param string $name * @return ReflectionMethod */ public function getMethod($name) : CoreReflectionMethod { $method = $name !== '' ? $this->betterReflectionClass->getMethod($name) : null; if ($method === null) { throw new CoreReflectionException(sprintf('Method %s::%s() does not exist', $this->betterReflectionClass->getName(), $name)); } return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionMethod($method); } /** * @param int-mask-of<ReflectionMethod::IS_*>|null $filter * @return ReflectionMethod[] */ public function getMethods($filter = null) : array { /** @psalm-suppress ImpureFunctionCall */ return array_values(array_map(static function (BetterReflectionMethod $method) : \PHPStan\BetterReflection\Reflection\Adapter\ReflectionMethod { return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionMethod($method); }, $this->betterReflectionClass->getMethods($filter ?? 0))); } /** * {@inheritDoc} */ public function hasProperty($name) : bool { if ($name === '') { return \false; } return $this->betterReflectionClass->hasProperty($name); } /** * @param string $name * @return ReflectionProperty */ public function getProperty($name) : \ReflectionProperty { $betterReflectionProperty = $name !== '' ? $this->betterReflectionClass->getProperty($name) : null; if ($betterReflectionProperty === null) { throw new CoreReflectionException(sprintf('Property %s::$%s does not exist', $this->betterReflectionClass->getName(), $name)); } return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionProperty($betterReflectionProperty); } /** * @param int-mask-of<ReflectionProperty::IS_*>|null $filter * @return ReflectionProperty[] */ public function getProperties($filter = null) : array { /** @psalm-suppress ImpureFunctionCall */ return array_values(array_map(static function (BetterReflectionProperty $property) : \PHPStan\BetterReflection\Reflection\Adapter\ReflectionProperty { return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionProperty($property); }, $this->betterReflectionClass->getProperties($filter ?? 0))); } /** * {@inheritDoc} */ public function hasConstant($name) : bool { if ($name === '') { return \false; } if ($this->betterReflectionClass instanceof BetterReflectionEnum && $this->betterReflectionClass->hasCase($name)) { return \true; } return $this->betterReflectionClass->hasConstant($name); } /** * @deprecated Use getReflectionConstants() * * @param int-mask-of<ReflectionClassConstant::IS_*>|null $filter * * @return array<non-empty-string, mixed> * * @psalm-mutation-free */ public function getConstants(?int $filter = null) : array { /** @psalm-suppress ImpureFunctionCall */ return array_map(function ($betterConstantOrEnumCase) { return $this->getConstantValue($betterConstantOrEnumCase); }, $this->filterBetterReflectionClassConstants($filter)); } /** * @deprecated Use getReflectionConstant() * @return mixed */ #[\ReturnTypeWillChange] public function getConstant($name) { if ($name === '') { return \false; } if ($this->betterReflectionClass instanceof BetterReflectionEnum) { $enumCase = $this->betterReflectionClass->getCase($name); if ($enumCase !== null) { return $this->getConstantValue($enumCase); } } $betterReflectionConstant = $this->betterReflectionClass->getConstant($name); if ($betterReflectionConstant === null) { return \false; } return $betterReflectionConstant->getValue(); } /** @psalm-pure * @param BetterReflectionClassConstant|BetterReflectionEnumCase $betterConstantOrEnumCase * @return mixed */ private function getConstantValue($betterConstantOrEnumCase) { if ($betterConstantOrEnumCase instanceof BetterReflectionEnumCase) { throw new \PHPStan\BetterReflection\Reflection\Adapter\Exception\NotImplemented('Not implemented'); } return $betterConstantOrEnumCase->getValue(); } /** * @param string $name * @return ReflectionClassConstant|false */ #[\ReturnTypeWillChange] public function getReflectionConstant($name) { if ($name === '') { return \false; } if ($this->betterReflectionClass instanceof BetterReflectionEnum) { $enumCase = $this->betterReflectionClass->getCase($name); if ($enumCase !== null) { return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionClassConstant($enumCase); } } $betterReflectionConstant = $this->betterReflectionClass->getConstant($name); if ($betterReflectionConstant === null) { return \false; } return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionClassConstant($betterReflectionConstant); } /** * @param int-mask-of<ReflectionClassConstant::IS_*>|null $filter * * @return list<ReflectionClassConstant> * * @psalm-mutation-free */ public function getReflectionConstants(?int $filter = null) : array { return array_values(array_map(static function ($betterConstantOrEnum) : \PHPStan\BetterReflection\Reflection\Adapter\ReflectionClassConstant { return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionClassConstant($betterConstantOrEnum); }, $this->filterBetterReflectionClassConstants($filter))); } /** * @param int-mask-of<ReflectionClassConstant::IS_*>|null $filter * * @return array<non-empty-string, BetterReflectionClassConstant|BetterReflectionEnumCase> * * @psalm-mutation-free */ private function filterBetterReflectionClassConstants(?int $filter) : array { $reflectionConstants = $this->betterReflectionClass->getConstants($filter ?? 0); if ($this->betterReflectionClass instanceof BetterReflectionEnum && ($filter === null || $filter & \PHPStan\BetterReflection\Reflection\Adapter\ReflectionClassConstant::IS_PUBLIC_COMPATIBILITY)) { $reflectionConstants += $this->betterReflectionClass->getCases(); } return $reflectionConstants; } /** @return list<class-string> */ public function getInterfaceClassNames() : array { return $this->betterReflectionClass->getInterfaceClassNames(); } /** * @psalm-mutation-free * @return array<class-string, self> */ public function getInterfaces() : array { /** @psalm-suppress ImpureFunctionCall */ return array_map(static function (BetterReflectionClass $interface) : self { return new self($interface); }, $this->betterReflectionClass->getInterfaces()); } /** * @return list<class-string> * * @psalm-mutation-free */ public function getInterfaceNames() : array { return $this->betterReflectionClass->getInterfaceNames(); } /** @psalm-mutation-free */ public function isInterface() : bool { return $this->betterReflectionClass->isInterface(); } /** @return list<trait-string> */ public function getTraitClassNames() : array { return $this->betterReflectionClass->getTraitClassNames(); } /** * @psalm-mutation-free * @return array<trait-string, self> */ public function getTraits() : array { $traits = $this->betterReflectionClass->getTraits(); /** @var list<trait-string> $traitNames */ $traitNames = array_map(static function (BetterReflectionClass $trait) : string { return $trait->getName(); }, $traits); /** @psalm-suppress ImpureFunctionCall */ return array_combine($traitNames, array_map(static function (BetterReflectionClass $trait) : self { return new self($trait); }, $traits)); } /** * @return list<trait-string> * * @psalm-mutation-free */ public function getTraitNames() : array { return $this->betterReflectionClass->getTraitNames(); } /** * @return array<non-empty-string, non-empty-string> * * @psalm-mutation-free */ public function getTraitAliases() : array { return $this->betterReflectionClass->getTraitAliases(); } /** @psalm-mutation-free */ public function isTrait() : bool { return $this->betterReflectionClass->isTrait(); } /** @psalm-mutation-free */ public function isAbstract() : bool { return $this->betterReflectionClass->isAbstract(); } /** @psalm-mutation-free */ public function isFinal() : bool { return $this->betterReflectionClass->isFinal(); } /** @psalm-mutation-free */ public function isReadOnly() : bool { return $this->betterReflectionClass->isReadOnly(); } /** @psalm-mutation-free */ public function getModifiers() : int { return $this->betterReflectionClass->getModifiers(); } /** * {@inheritDoc} */ public function isInstance($object) : bool { return $this->betterReflectionClass->isInstance($object); } /** * @return object * @param mixed $arg * @param mixed $args */ #[\ReturnTypeWillChange] public function newInstance($arg = null, ...$args) { ClassExistenceChecker::classExists($this->getName(), \true); $reflection = new CoreReflectionClass($this->getName()); return $reflection->newInstance(...func_get_args()); } public function newInstanceWithoutConstructor() : object { ClassExistenceChecker::classExists($this->getName(), \true); $reflection = new CoreReflectionClass($this->getName()); return $reflection->newInstanceWithoutConstructor(); } public function newInstanceArgs(?array $args = null) : object { ClassExistenceChecker::classExists($this->getName(), \true); $reflection = new CoreReflectionClass($this->getName()); return $reflection->newInstanceArgs($args); } /** @return class-string|null */ public function getParentClassName() : ?string { return $this->betterReflectionClass->getParentClassName(); } /** * @return self|false */ #[\ReturnTypeWillChange] public function getParentClass() { $parentClass = $this->betterReflectionClass->getParentClass(); if ($parentClass === null) { return \false; } return new self($parentClass); } /** * {@inheritDoc} */ public function isSubclassOf($class) : bool { $realParentClassNames = $this->betterReflectionClass->getParentClassNames(); $parentClassNames = array_combine(array_map(static function (string $parentClassName) : string { return strtolower($parentClassName); }, $realParentClassNames), $realParentClassNames); $className = $class instanceof CoreReflectionClass ? $class->getName() : $class; $lowercasedClassName = strtolower($className); $realParentClassName = $parentClassNames[$lowercasedClassName] ?? $className; if ($this->betterReflectionClass->isSubclassOf($realParentClassName)) { return \true; } return $this->implementsInterface($className); } /** * @return array<string, mixed> * * @psalm-suppress LessSpecificImplementedReturnType */ public function getStaticProperties() : array { return $this->betterReflectionClass->getStaticProperties(); } /** * {@inheritDoc} */ #[\ReturnTypeWillChange] public function getStaticPropertyValue($name, $default = null) { $betterReflectionProperty = $name !== '' ? $this->betterReflectionClass->getProperty($name) : null; if ($betterReflectionProperty === null) { if (func_num_args() === 2) { return $default; } throw new CoreReflectionException(sprintf('Property %s::$%s does not exist', $this->betterReflectionClass->getName(), $name)); } $property = new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionProperty($betterReflectionProperty); if (!$property->isStatic()) { throw new CoreReflectionException(sprintf('Property %s::$%s does not exist', $this->betterReflectionClass->getName(), $name)); } return $property->getValue(); } /** * {@inheritDoc} */ public function setStaticPropertyValue($name, $value) : void { $betterReflectionProperty = $name !== '' ? $this->betterReflectionClass->getProperty($name) : null; if ($betterReflectionProperty === null) { throw new CoreReflectionException(sprintf('Class %s does not have a property named %s', $this->betterReflectionClass->getName(), $name)); } $property = new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionProperty($betterReflectionProperty); if (!$property->isStatic()) { throw new CoreReflectionException(sprintf('Class %s does not have a property named %s', $this->betterReflectionClass->getName(), $name)); } $property->setValue($value); } /** * @return array<non-empty-string, mixed> * * @psalm-mutation-free */ public function getDefaultProperties() : array { return $this->betterReflectionClass->getDefaultProperties(); } /** @psalm-mutation-free */ public function isIterateable() : bool { return $this->betterReflectionClass->isIterateable(); } /** @psalm-mutation-free */ public function isIterable() : bool { return $this->isIterateable(); } /** * @param \ReflectionClass|string $interface */ public function implementsInterface($interface) : bool { $realInterfaceNames = $this->betterReflectionClass->getInterfaceNames(); $interfaceNames = array_combine(array_map(static function (string $interfaceName) : string { return strtolower($interfaceName); }, $realInterfaceNames), $realInterfaceNames); $interfaceName = $interface instanceof CoreReflectionClass ? $interface->getName() : $interface; $lowercasedInterfaceName = strtolower($interfaceName); $realInterfaceName = $interfaceNames[$lowercasedInterfaceName] ?? $interfaceName; return $this->betterReflectionClass->implementsInterface($realInterfaceName); } /** @psalm-mutation-free */ public function getExtension() : ?CoreReflectionExtension { throw new \PHPStan\BetterReflection\Reflection\Adapter\Exception\NotImplemented('Not implemented'); } /** * {@inheritDoc} */ #[\ReturnTypeWillChange] public function getExtensionName() { return $this->betterReflectionClass->getExtensionName() ?? \false; } /** @psalm-mutation-free */ public function inNamespace() : bool { return $this->betterReflectionClass->inNamespace(); } /** @psalm-mutation-free */ public function getNamespaceName() : string { return $this->betterReflectionClass->getNamespaceName() ?? ''; } /** @psalm-mutation-free */ public function getShortName() : string { return $this->betterReflectionClass->getShortName(); } /** * @param class-string|null $name * * @return list<ReflectionAttribute|FakeReflectionAttribute> */ public function getAttributes(?string $name = null, int $flags = 0) : array { if ($flags !== 0 && $flags !== \PHPStan\BetterReflection\Reflection\Adapter\ReflectionAttribute::IS_INSTANCEOF) { throw new ValueError('Argument #2 ($flags) must be a valid attribute filter flag'); } if ($name !== null && $flags !== 0) { $attributes = $this->betterReflectionClass->getAttributesByInstance($name); } elseif ($name !== null) { $attributes = $this->betterReflectionClass->getAttributesByName($name); } else { $attributes = $this->betterReflectionClass->getAttributes(); } /** @psalm-suppress ImpureFunctionCall */ return array_map(static function (BetterReflectionAttribute $betterReflectionAttribute) { return \PHPStan\BetterReflection\Reflection\Adapter\ReflectionAttributeFactory::create($betterReflectionAttribute); }, $attributes); } /** @psalm-mutation-free */ public function isEnum() : bool { return $this->betterReflectionClass->isEnum(); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\Adapter; use OutOfBoundsException; use PhpParser\Node\Expr; use ReflectionClassConstant as CoreReflectionClassConstant; use ReflectionType as CoreReflectionType; use ReturnTypeWillChange; use PHPStan\BetterReflection\Reflection\ReflectionAttribute as BetterReflectionAttribute; use PHPStan\BetterReflection\Reflection\ReflectionClassConstant as BetterReflectionClassConstant; use PHPStan\BetterReflection\Reflection\ReflectionEnumCase as BetterReflectionEnumCase; use ValueError; use function array_map; use function sprintf; /** * @psalm-suppress PropertyNotSetInConstructor * @psalm-immutable */ final class ReflectionClassConstant extends CoreReflectionClassConstant { /** @internal */ public const IS_PUBLIC_COMPATIBILITY = 1; /** @internal */ public const IS_PROTECTED_COMPATIBILITY = 2; /** @internal */ public const IS_PRIVATE_COMPATIBILITY = 4; /** @internal */ public const IS_FINAL_COMPATIBILITY = 32; /** * @var BetterReflectionClassConstant|BetterReflectionEnumCase */ private $betterClassConstantOrEnumCase; /** * @param BetterReflectionClassConstant|BetterReflectionEnumCase $betterClassConstantOrEnumCase */ public function __construct($betterClassConstantOrEnumCase) { $this->betterClassConstantOrEnumCase = $betterClassConstantOrEnumCase; unset($this->name); unset($this->class); } public function getName() : string { return $this->betterClassConstantOrEnumCase->getName(); } /** @psalm-mutation-free */ public function hasType() : bool { if ($this->betterClassConstantOrEnumCase instanceof BetterReflectionEnumCase) { return \false; } return $this->betterClassConstantOrEnumCase->hasType(); } /** * @psalm-mutation-free * @return ReflectionUnionType|ReflectionNamedType|ReflectionIntersectionType|null */ public function getType() : ?CoreReflectionType { if ($this->betterClassConstantOrEnumCase instanceof BetterReflectionEnumCase) { return null; } return \PHPStan\BetterReflection\Reflection\Adapter\ReflectionType::fromTypeOrNull($this->betterClassConstantOrEnumCase->getType()); } /** * @deprecated Use getValueExpression() */ #[\ReturnTypeWillChange] public function getValue() { if ($this->betterClassConstantOrEnumCase instanceof BetterReflectionEnumCase) { throw new \PHPStan\BetterReflection\Reflection\Adapter\Exception\NotImplemented('Not implemented'); } return $this->betterClassConstantOrEnumCase->getValue(); } /** * @deprecated Use getValueExpression() */ public function getValueExpr() : Expr { return $this->getValueExpression(); } public function getValueExpression() : Expr { return $this->betterClassConstantOrEnumCase->getValueExpression(); } public function isPublic() : bool { if ($this->betterClassConstantOrEnumCase instanceof BetterReflectionEnumCase) { return \true; } return $this->betterClassConstantOrEnumCase->isPublic(); } public function isPrivate() : bool { if ($this->betterClassConstantOrEnumCase instanceof BetterReflectionEnumCase) { return \false; } return $this->betterClassConstantOrEnumCase->isPrivate(); } public function isProtected() : bool { if ($this->betterClassConstantOrEnumCase instanceof BetterReflectionEnumCase) { return \false; } return $this->betterClassConstantOrEnumCase->isProtected(); } public function getModifiers() : int { if ($this->betterClassConstantOrEnumCase instanceof BetterReflectionEnumCase) { return \PHPStan\BetterReflection\Reflection\Adapter\ReflectionClassConstant::IS_PUBLIC_COMPATIBILITY; } return $this->betterClassConstantOrEnumCase->getModifiers(); } public function getDeclaringClass() : \PHPStan\BetterReflection\Reflection\Adapter\ReflectionClass { if ($this->betterClassConstantOrEnumCase instanceof BetterReflectionEnumCase) { return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionClass($this->betterClassConstantOrEnumCase->getDeclaringClass()); } return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionClass($this->betterClassConstantOrEnumCase->getImplementingClass()); } /** * Returns the doc comment for this constant * * @return string|false */ #[\ReturnTypeWillChange] public function getDocComment() { return $this->betterClassConstantOrEnumCase->getDocComment() ?? \false; } /** * To string * * @link https://php.net/manual/en/reflector.tostring.php * * @return non-empty-string */ public function __toString() : string { return $this->betterClassConstantOrEnumCase->__toString(); } /** * @param class-string|null $name * * @return list<ReflectionAttribute|FakeReflectionAttribute> */ public function getAttributes(?string $name = null, int $flags = 0) : array { if ($flags !== 0 && $flags !== \PHPStan\BetterReflection\Reflection\Adapter\ReflectionAttribute::IS_INSTANCEOF) { throw new ValueError('Argument #2 ($flags) must be a valid attribute filter flag'); } if ($name !== null && $flags !== 0) { $attributes = $this->betterClassConstantOrEnumCase->getAttributesByInstance($name); } elseif ($name !== null) { $attributes = $this->betterClassConstantOrEnumCase->getAttributesByName($name); } else { $attributes = $this->betterClassConstantOrEnumCase->getAttributes(); } /** @psalm-suppress ImpureFunctionCall */ return array_map(static function (BetterReflectionAttribute $betterReflectionAttribute) { return \PHPStan\BetterReflection\Reflection\Adapter\ReflectionAttributeFactory::create($betterReflectionAttribute); }, $attributes); } public function isFinal() : bool { if ($this->betterClassConstantOrEnumCase instanceof BetterReflectionEnumCase) { return \true; } return $this->betterClassConstantOrEnumCase->isFinal(); } public function isEnumCase() : bool { return $this->betterClassConstantOrEnumCase instanceof BetterReflectionEnumCase; } /** * @return mixed */ public function __get(string $name) { if ($name === 'name') { return $this->betterClassConstantOrEnumCase->getName(); } if ($name === 'class') { return $this->getDeclaringClass()->getName(); } throw new OutOfBoundsException(sprintf('Property %s::$%s does not exist.', self::class, $name)); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\Adapter; use Closure; use OutOfBoundsException; use ReflectionClass as CoreReflectionClass; use ReflectionException as CoreReflectionException; use ReflectionExtension as CoreReflectionExtension; use ReflectionMethod as CoreReflectionMethod; use ReflectionType as CoreReflectionType; use ReturnTypeWillChange; use PHPStan\BetterReflection\Reflection\Adapter\Exception\NotImplemented; use PHPStan\BetterReflection\Reflection\Exception\CodeLocationMissing; use PHPStan\BetterReflection\Reflection\Exception\MethodPrototypeNotFound; use PHPStan\BetterReflection\Reflection\Exception\NoObjectProvided; use PHPStan\BetterReflection\Reflection\ReflectionAttribute as BetterReflectionAttribute; use PHPStan\BetterReflection\Reflection\ReflectionMethod as BetterReflectionMethod; use PHPStan\BetterReflection\Reflection\ReflectionParameter as BetterReflectionParameter; use PHPStan\BetterReflection\Util\FileHelper; use Throwable; use ValueError; use function array_map; use function sprintf; /** @psalm-suppress PropertyNotSetInConstructor */ final class ReflectionMethod extends CoreReflectionMethod { /** * @var BetterReflectionMethod */ private $betterReflectionMethod; public function __construct(BetterReflectionMethod $betterReflectionMethod) { $this->betterReflectionMethod = $betterReflectionMethod; unset($this->name); unset($this->class); } /** @return non-empty-string */ public function __toString() : string { return $this->betterReflectionMethod->__toString(); } public function inNamespace() : bool { return $this->betterReflectionMethod->inNamespace(); } public function isClosure() : bool { return $this->betterReflectionMethod->isClosure(); } public function isDeprecated() : bool { return $this->betterReflectionMethod->isDeprecated(); } public function isInternal() : bool { return $this->betterReflectionMethod->isInternal(); } public function isUserDefined() : bool { return $this->betterReflectionMethod->isUserDefined(); } /** * {@inheritDoc} */ #[\ReturnTypeWillChange] public function getClosureThis() { throw new NotImplemented('Not implemented'); } public function getClosureScopeClass() : ?CoreReflectionClass { throw new NotImplemented('Not implemented'); } public function getClosureCalledClass() : ?CoreReflectionClass { throw new NotImplemented('Not implemented'); } /** * {@inheritDoc} */ #[\ReturnTypeWillChange] public function getDocComment() { return $this->betterReflectionMethod->getDocComment() ?? \false; } /** * {@inheritDoc} */ #[\ReturnTypeWillChange] public function getStartLine() { try { return $this->betterReflectionMethod->getStartLine(); } catch (CodeLocationMissing $exception) { return \false; } } /** * {@inheritDoc} */ #[\ReturnTypeWillChange] public function getEndLine() { try { return $this->betterReflectionMethod->getEndLine(); } catch (CodeLocationMissing $exception) { return \false; } } /** @psalm-suppress ImplementedReturnTypeMismatch */ public function getExtension() : ?CoreReflectionExtension { throw new NotImplemented('Not implemented'); } /** * {@inheritDoc} */ #[\ReturnTypeWillChange] public function getExtensionName() { return $this->betterReflectionMethod->getExtensionName() ?? \false; } /** * {@inheritDoc} */ #[\ReturnTypeWillChange] public function getFileName() { $fileName = $this->betterReflectionMethod->getFileName(); return $fileName !== null ? FileHelper::normalizeSystemPath($fileName) : \false; } public function getName() : string { return $this->betterReflectionMethod->getName(); } public function getNamespaceName() : string { return $this->betterReflectionMethod->getNamespaceName() ?? ''; } public function getNumberOfParameters() : int { return $this->betterReflectionMethod->getNumberOfParameters(); } public function getNumberOfRequiredParameters() : int { return $this->betterReflectionMethod->getNumberOfRequiredParameters(); } /** @return list<ReflectionParameter> */ public function getParameters() : array { return array_map(static function (BetterReflectionParameter $parameter) : \PHPStan\BetterReflection\Reflection\Adapter\ReflectionParameter { return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionParameter($parameter); }, $this->betterReflectionMethod->getParameters()); } public function hasReturnType() : bool { return $this->betterReflectionMethod->hasReturnType(); } /** @return ReflectionUnionType|ReflectionNamedType|ReflectionIntersectionType|null */ public function getReturnType() : ?CoreReflectionType { return \PHPStan\BetterReflection\Reflection\Adapter\ReflectionType::fromTypeOrNull($this->betterReflectionMethod->getReturnType()); } public function getShortName() : string { return $this->betterReflectionMethod->getShortName(); } /** @return array<string, scalar> */ public function getStaticVariables() : array { throw new NotImplemented('Not implemented'); } public function returnsReference() : bool { return $this->betterReflectionMethod->returnsReference(); } public function isGenerator() : bool { return $this->betterReflectionMethod->isGenerator(); } public function isVariadic() : bool { return $this->betterReflectionMethod->isVariadic(); } public function isPublic() : bool { return $this->betterReflectionMethod->isPublic(); } public function isPrivate() : bool { return $this->betterReflectionMethod->isPrivate(); } public function isProtected() : bool { return $this->betterReflectionMethod->isProtected(); } public function isAbstract() : bool { return $this->betterReflectionMethod->isAbstract(); } public function isFinal() : bool { return $this->betterReflectionMethod->isFinal(); } public function isStatic() : bool { return $this->betterReflectionMethod->isStatic(); } public function isConstructor() : bool { return $this->betterReflectionMethod->isConstructor(); } public function isDestructor() : bool { return $this->betterReflectionMethod->isDestructor(); } /** * {@inheritDoc} */ public function getClosure($object = null) : Closure { try { return $this->betterReflectionMethod->getClosure($object); } catch (NoObjectProvided $e) { throw new ValueError($e->getMessage(), 0, $e); } catch (Throwable $e) { throw new CoreReflectionException($e->getMessage(), 0, $e); } } public function getModifiers() : int { return $this->betterReflectionMethod->getModifiers(); } /** * @param object $object * @param mixed $arg * @param mixed ...$args * * @return mixed * * @throws CoreReflectionException */ #[\ReturnTypeWillChange] public function invoke($object = null, $arg = null, ...$args) { try { return $this->betterReflectionMethod->invoke($object, $arg, ...$args); } catch (NoObjectProvided $exception) { return null; } catch (Throwable $e) { throw new CoreReflectionException($e->getMessage(), 0, $e); } } /** * @param object $object * @param mixed[] $args * * @return mixed * * @throws CoreReflectionException */ #[\ReturnTypeWillChange] public function invokeArgs($object = null, array $args = []) { try { return $this->betterReflectionMethod->invokeArgs($object, $args); } catch (NoObjectProvided $exception) { return null; } catch (Throwable $e) { throw new CoreReflectionException($e->getMessage(), 0, $e); } } public function getDeclaringClass() : \PHPStan\BetterReflection\Reflection\Adapter\ReflectionClass { return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionClass($this->betterReflectionMethod->getImplementingClass()); } public function getPrototype() : \PHPStan\BetterReflection\Reflection\Adapter\ReflectionMethod { return new self($this->betterReflectionMethod->getPrototype()); } public function hasPrototype() : bool { try { $this->betterReflectionMethod->getPrototype(); return \true; } catch (MethodPrototypeNotFound $exception) { return \false; } } /** * {@inheritDoc} * @codeCoverageIgnore * @infection-ignore-all */ public function setAccessible($accessible) : void { } /** * @param class-string|null $name * * @return list<ReflectionAttribute|FakeReflectionAttribute> */ public function getAttributes(?string $name = null, int $flags = 0) : array { if ($flags !== 0 && $flags !== \PHPStan\BetterReflection\Reflection\Adapter\ReflectionAttribute::IS_INSTANCEOF) { throw new ValueError('Argument #2 ($flags) must be a valid attribute filter flag'); } if ($name !== null && $flags !== 0) { $attributes = $this->betterReflectionMethod->getAttributesByInstance($name); } elseif ($name !== null) { $attributes = $this->betterReflectionMethod->getAttributesByName($name); } else { $attributes = $this->betterReflectionMethod->getAttributes(); } return array_map(static function (BetterReflectionAttribute $betterReflectionAttribute) { return \PHPStan\BetterReflection\Reflection\Adapter\ReflectionAttributeFactory::create($betterReflectionAttribute); }, $attributes); } public function hasTentativeReturnType() : bool { return $this->betterReflectionMethod->hasTentativeReturnType(); } /** @return ReflectionUnionType|ReflectionNamedType|ReflectionIntersectionType|null */ public function getTentativeReturnType() : ?CoreReflectionType { return \PHPStan\BetterReflection\Reflection\Adapter\ReflectionType::fromTypeOrNull($this->betterReflectionMethod->getTentativeReturnType()); } /** @return mixed[] */ public function getClosureUsedVariables() : array { throw new \PHPStan\BetterReflection\Reflection\Adapter\Exception\NotImplemented('Not implemented'); } /** * @return mixed */ public function __get(string $name) { if ($name === 'name') { return $this->betterReflectionMethod->getName(); } if ($name === 'class') { return $this->betterReflectionMethod->getImplementingClass()->getName(); } throw new OutOfBoundsException(sprintf('Property %s::$%s does not exist.', self::class, $name)); } public function getBetterReflection() : BetterReflectionMethod { return $this->betterReflectionMethod; } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\Adapter; use OutOfBoundsException; use ReflectionEnumUnitCase as CoreReflectionEnumUnitCase; use PHPStan\BetterReflection\Reflection\ReflectionAttribute as BetterReflectionAttribute; use PHPStan\BetterReflection\Reflection\ReflectionEnumCase as BetterReflectionEnumCase; use UnitEnum; use ValueError; use function array_map; use function sprintf; /** * @psalm-suppress PropertyNotSetInConstructor * @psalm-immutable */ final class ReflectionEnumUnitCase extends CoreReflectionEnumUnitCase { public function __construct(private BetterReflectionEnumCase $betterReflectionEnumCase) { unset($this->name); unset($this->class); } /** * Get the name of the reflection (e.g. if this is a ReflectionClass this * will be the class name). */ public function getName() : string { return $this->betterReflectionEnumCase->getName(); } public function hasType() : bool { return \false; } public function getType() : \PHPStan\BetterReflection\Reflection\Adapter\ReflectionUnionType|\PHPStan\BetterReflection\Reflection\Adapter\ReflectionNamedType|\PHPStan\BetterReflection\Reflection\Adapter\ReflectionIntersectionType|null { return null; } public function getValue() : UnitEnum { throw new \PHPStan\BetterReflection\Reflection\Adapter\Exception\NotImplemented('Not implemented'); } public function isPublic() : bool { return \true; } public function isPrivate() : bool { return \false; } public function isProtected() : bool { return \false; } public function getModifiers() : int { return self::IS_PUBLIC; } public function getDeclaringClass() : \PHPStan\BetterReflection\Reflection\Adapter\ReflectionClass { return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionClass($this->betterReflectionEnumCase->getDeclaringClass()); } public function getDocComment() : string|false { return $this->betterReflectionEnumCase->getDocComment() ?? \false; } /** @return non-empty-string */ public function __toString() : string { return $this->betterReflectionEnumCase->__toString(); } /** * @param class-string|null $name * * @return list<ReflectionAttribute|FakeReflectionAttribute> */ public function getAttributes(string|null $name = null, int $flags = 0) : array { if ($flags !== 0 && $flags !== \PHPStan\BetterReflection\Reflection\Adapter\ReflectionAttribute::IS_INSTANCEOF) { throw new ValueError('Argument #2 ($flags) must be a valid attribute filter flag'); } if ($name !== null && $flags !== 0) { $attributes = $this->betterReflectionEnumCase->getAttributesByInstance($name); } elseif ($name !== null) { $attributes = $this->betterReflectionEnumCase->getAttributesByName($name); } else { $attributes = $this->betterReflectionEnumCase->getAttributes(); } /** @psalm-suppress ImpureFunctionCall */ return array_map(static fn(BetterReflectionAttribute $betterReflectionAttribute): \PHPStan\BetterReflection\Reflection\Adapter\ReflectionAttribute|\PHPStan\BetterReflection\Reflection\Adapter\FakeReflectionAttribute => \PHPStan\BetterReflection\Reflection\Adapter\ReflectionAttributeFactory::create($betterReflectionAttribute), $attributes); } public function isFinal() : bool { return \true; } public function isEnumCase() : bool { return \true; } public function getEnum() : \PHPStan\BetterReflection\Reflection\Adapter\ReflectionEnum { return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionEnum($this->betterReflectionEnumCase->getDeclaringEnum()); } public function __get(string $name) : mixed { if ($name === 'name') { return $this->betterReflectionEnumCase->getName(); } if ($name === 'class') { return $this->betterReflectionEnumCase->getDeclaringClass()->getName(); } throw new OutOfBoundsException(sprintf('Property %s::$%s does not exist.', self::class, $name)); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\Adapter; use Closure; use OutOfBoundsException; use ReflectionClass as CoreReflectionClass; use ReflectionException as CoreReflectionException; use ReflectionExtension as CoreReflectionExtension; use ReflectionFunction as CoreReflectionFunction; use ReflectionType as CoreReflectionType; use ReturnTypeWillChange; use PHPStan\BetterReflection\Reflection\Adapter\Exception\NotImplemented; use PHPStan\BetterReflection\Reflection\ReflectionAttribute as BetterReflectionAttribute; use PHPStan\BetterReflection\Reflection\ReflectionFunction as BetterReflectionFunction; use PHPStan\BetterReflection\Reflection\ReflectionParameter as BetterReflectionParameter; use PHPStan\BetterReflection\Util\FileHelper; use Throwable; use ValueError; use function array_map; use function func_get_args; use function sprintf; final class ReflectionFunction extends CoreReflectionFunction { /** * @var BetterReflectionFunction */ private $betterReflectionFunction; public function __construct(BetterReflectionFunction $betterReflectionFunction) { $this->betterReflectionFunction = $betterReflectionFunction; unset($this->name); } public function __toString() : string { return $this->betterReflectionFunction->__toString(); } public function inNamespace() : bool { return $this->betterReflectionFunction->inNamespace(); } public function isClosure() : bool { return $this->betterReflectionFunction->isClosure(); } public function isDeprecated() : bool { return $this->betterReflectionFunction->isDeprecated(); } public function isInternal() : bool { return $this->betterReflectionFunction->isInternal(); } public function isUserDefined() : bool { return $this->betterReflectionFunction->isUserDefined(); } /** * {@inheritDoc} */ #[\ReturnTypeWillChange] public function getClosureThis() { throw new NotImplemented('Not implemented'); } public function getClosureScopeClass() : ?CoreReflectionClass { throw new NotImplemented('Not implemented'); } public function getClosureCalledClass() : ?CoreReflectionClass { throw new NotImplemented('Not implemented'); } /** * {@inheritDoc} */ #[\ReturnTypeWillChange] public function getDocComment() { return $this->betterReflectionFunction->getDocComment() ?? \false; } /** * {@inheritDoc} */ #[\ReturnTypeWillChange] public function getStartLine() { return $this->betterReflectionFunction->getStartLine(); } /** * {@inheritDoc} */ #[\ReturnTypeWillChange] public function getEndLine() { return $this->betterReflectionFunction->getEndLine(); } /** @psalm-suppress ImplementedReturnTypeMismatch */ public function getExtension() : ?CoreReflectionExtension { throw new NotImplemented('Not implemented'); } /** * {@inheritDoc} */ #[\ReturnTypeWillChange] public function getExtensionName() { return $this->betterReflectionFunction->getExtensionName() ?? \false; } /** * {@inheritDoc} */ #[\ReturnTypeWillChange] public function getFileName() { $fileName = $this->betterReflectionFunction->getFileName(); return $fileName !== null ? FileHelper::normalizeSystemPath($fileName) : \false; } public function getName() : string { return $this->betterReflectionFunction->getName(); } public function getNamespaceName() : string { return $this->betterReflectionFunction->getNamespaceName() ?? ''; } public function getNumberOfParameters() : int { return $this->betterReflectionFunction->getNumberOfParameters(); } public function getNumberOfRequiredParameters() : int { return $this->betterReflectionFunction->getNumberOfRequiredParameters(); } /** @return list<ReflectionParameter> */ public function getParameters() : array { return array_map(static function (BetterReflectionParameter $parameter) : \PHPStan\BetterReflection\Reflection\Adapter\ReflectionParameter { return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionParameter($parameter); }, $this->betterReflectionFunction->getParameters()); } public function hasReturnType() : bool { return $this->betterReflectionFunction->hasReturnType(); } /** @return ReflectionUnionType|ReflectionNamedType|ReflectionIntersectionType|null */ public function getReturnType() : ?CoreReflectionType { return \PHPStan\BetterReflection\Reflection\Adapter\ReflectionType::fromTypeOrNull($this->betterReflectionFunction->getReturnType()); } public function getShortName() : string { return $this->betterReflectionFunction->getShortName(); } /** @return array<string, scalar> */ public function getStaticVariables() : array { throw new NotImplemented('Not implemented'); } public function returnsReference() : bool { return $this->betterReflectionFunction->returnsReference(); } public function isGenerator() : bool { return $this->betterReflectionFunction->isGenerator(); } public function isVariadic() : bool { return $this->betterReflectionFunction->isVariadic(); } public function isDisabled() : bool { return $this->betterReflectionFunction->isDisabled(); } /** * @param mixed $arg * @param mixed ...$args * * @return mixed * * @throws CoreReflectionException */ #[\ReturnTypeWillChange] public function invoke($arg = null, ...$args) { try { return $this->betterReflectionFunction->invoke(...func_get_args()); } catch (Throwable $e) { throw new CoreReflectionException($e->getMessage(), 0, $e); } } /** * @param mixed[] $args */ #[\ReturnTypeWillChange] public function invokeArgs(array $args) { try { return $this->betterReflectionFunction->invokeArgs($args); } catch (Throwable $e) { throw new CoreReflectionException($e->getMessage(), 0, $e); } } public function getClosure() : Closure { return $this->betterReflectionFunction->getClosure(); } /** @return mixed[] */ public function getClosureUsedVariables() : array { throw new \PHPStan\BetterReflection\Reflection\Adapter\Exception\NotImplemented('Not implemented'); } public function hasTentativeReturnType() : bool { return $this->betterReflectionFunction->hasTentativeReturnType(); } /** @return ReflectionUnionType|ReflectionNamedType|ReflectionIntersectionType|null */ public function getTentativeReturnType() : ?CoreReflectionType { return \PHPStan\BetterReflection\Reflection\Adapter\ReflectionType::fromTypeOrNull($this->betterReflectionFunction->getTentativeReturnType()); } public function isStatic() : bool { return $this->betterReflectionFunction->isStatic(); } /** * @param class-string|null $name * * @return list<ReflectionAttribute|FakeReflectionAttribute> */ public function getAttributes(?string $name = null, int $flags = 0) : array { if ($flags !== 0 && $flags !== \PHPStan\BetterReflection\Reflection\Adapter\ReflectionAttribute::IS_INSTANCEOF) { throw new ValueError('Argument #2 ($flags) must be a valid attribute filter flag'); } if ($name !== null && $flags !== 0) { $attributes = $this->betterReflectionFunction->getAttributesByInstance($name); } elseif ($name !== null) { $attributes = $this->betterReflectionFunction->getAttributesByName($name); } else { $attributes = $this->betterReflectionFunction->getAttributes(); } return array_map(static function (BetterReflectionAttribute $betterReflectionAttribute) { return \PHPStan\BetterReflection\Reflection\Adapter\ReflectionAttributeFactory::create($betterReflectionAttribute); }, $attributes); } /** * @return mixed */ public function __get(string $name) { if ($name === 'name') { return $this->betterReflectionFunction->getName(); } throw new OutOfBoundsException(sprintf('Property %s::$%s does not exist.', self::class, $name)); } public function isAnonymous() : bool { return $this->betterReflectionFunction->isClosure(); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\Adapter\Exception; use LogicException; class NotImplemented extends LogicException { } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\Adapter; use ReflectionUnionType as CoreReflectionUnionType; use PHPStan\BetterReflection\Reflection\ReflectionType as BetterReflectionType; use PHPStan\BetterReflection\Reflection\ReflectionUnionType as BetterReflectionUnionType; use function array_map; use function assert; /** @psalm-immutable */ final class ReflectionUnionType extends CoreReflectionUnionType { /** * @var BetterReflectionUnionType */ private $betterReflectionType; public function __construct(BetterReflectionUnionType $betterReflectionType) { $this->betterReflectionType = $betterReflectionType; } /** @return non-empty-list<ReflectionNamedType|ReflectionIntersectionType> */ public function getTypes() : array { return array_map(static function (BetterReflectionType $type) { $adapterType = \PHPStan\BetterReflection\Reflection\Adapter\ReflectionType::fromType($type); assert($adapterType instanceof \PHPStan\BetterReflection\Reflection\Adapter\ReflectionNamedType || $adapterType instanceof \PHPStan\BetterReflection\Reflection\Adapter\ReflectionIntersectionType); return $adapterType; }, $this->betterReflectionType->getTypes()); } /** @return non-empty-string */ public function __toString() : string { return $this->betterReflectionType->__toString(); } public function allowsNull() : bool { return $this->betterReflectionType->allowsNull(); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\Adapter; use PhpParser\Node\Expr; use PHPStan\BetterReflection\Reflection\ReflectionAttribute as BetterReflectionAttribute; final class FakeReflectionAttribute { /** * @var BetterReflectionAttribute */ private $betterReflectionAttribute; public function __construct(BetterReflectionAttribute $betterReflectionAttribute) { $this->betterReflectionAttribute = $betterReflectionAttribute; } public function getName() : string { return $this->betterReflectionAttribute->getName(); } public function getTarget() : int { return $this->betterReflectionAttribute->getTarget(); } public function isRepeated() : bool { return $this->betterReflectionAttribute->isRepeated(); } /** * @deprecated Use getArgumentsExpressions() * @return array<int|string, mixed> */ public function getArguments() : array { return $this->betterReflectionAttribute->getArguments(); } /** @return array<int|string, Expr> */ public function getArgumentsExpressions() : array { return $this->betterReflectionAttribute->getArgumentsExpressions(); } public function newInstance() : object { $class = $this->getName(); return new $class(...$this->getArguments()); } public function __toString() : string { return $this->betterReflectionAttribute->__toString(); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\Adapter; use OutOfBoundsException; use ReflectionClass as CoreReflectionClass; use ReflectionException as CoreReflectionException; use ReflectionExtension as CoreReflectionExtension; use ReflectionObject as CoreReflectionObject; use ReturnTypeWillChange; use PHPStan\BetterReflection\Reflection\ReflectionAttribute as BetterReflectionAttribute; use PHPStan\BetterReflection\Reflection\ReflectionClass as BetterReflectionClass; use PHPStan\BetterReflection\Reflection\ReflectionClassConstant as BetterReflectionClassConstant; use PHPStan\BetterReflection\Reflection\ReflectionMethod as BetterReflectionMethod; use PHPStan\BetterReflection\Reflection\ReflectionObject as BetterReflectionObject; use PHPStan\BetterReflection\Reflection\ReflectionProperty as BetterReflectionProperty; use PHPStan\BetterReflection\Util\FileHelper; use ValueError; use function array_combine; use function array_map; use function array_values; use function func_num_args; use function sprintf; use function strtolower; /** @psalm-suppress PropertyNotSetInConstructor */ final class ReflectionObject extends CoreReflectionObject { /** * @var BetterReflectionObject */ private $betterReflectionObject; public function __construct(BetterReflectionObject $betterReflectionObject) { $this->betterReflectionObject = $betterReflectionObject; unset($this->name); } public function __toString() : string { return $this->betterReflectionObject->__toString(); } public function getName() : string { return $this->betterReflectionObject->getName(); } public function isInternal() : bool { return $this->betterReflectionObject->isInternal(); } public function isUserDefined() : bool { return $this->betterReflectionObject->isUserDefined(); } public function isInstantiable() : bool { return $this->betterReflectionObject->isInstantiable(); } public function isCloneable() : bool { return $this->betterReflectionObject->isCloneable(); } /** * {@inheritDoc} */ #[\ReturnTypeWillChange] public function getFileName() { $fileName = $this->betterReflectionObject->getFileName(); return $fileName !== null ? FileHelper::normalizeSystemPath($fileName) : \false; } /** * {@inheritDoc} */ #[\ReturnTypeWillChange] public function getStartLine() { return $this->betterReflectionObject->getStartLine(); } /** * {@inheritDoc} */ #[\ReturnTypeWillChange] public function getEndLine() { return $this->betterReflectionObject->getEndLine(); } /** * {@inheritDoc} */ #[\ReturnTypeWillChange] public function getDocComment() { return $this->betterReflectionObject->getDocComment() ?? \false; } public function getConstructor() : ?\PHPStan\BetterReflection\Reflection\Adapter\ReflectionMethod { $constructor = $this->betterReflectionObject->getConstructor(); if ($constructor === null) { return null; } return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionMethod($constructor); } /** * {@inheritDoc} */ public function hasMethod($name) : bool { if ($name === '') { return \false; } return $this->betterReflectionObject->hasMethod($this->getMethodRealName($name)); } /** * {@inheritDoc} */ public function getMethod($name) : \PHPStan\BetterReflection\Reflection\Adapter\ReflectionMethod { $method = $name !== '' ? $this->betterReflectionObject->getMethod($this->getMethodRealName($name)) : null; if ($method === null) { throw new CoreReflectionException(sprintf('Method %s::%s() does not exist', $this->betterReflectionObject->getName(), $name)); } return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionMethod($method); } /** * @param non-empty-string $name * * @return non-empty-string */ private function getMethodRealName(string $name) : string { $realMethodNames = array_map(static function (BetterReflectionMethod $method) : string { return $method->getName(); }, $this->betterReflectionObject->getMethods()); $methodNames = array_combine(array_map(static function (string $methodName) : string { return strtolower($methodName); }, $realMethodNames), $realMethodNames); $lowercasedName = strtolower($name); return $methodNames[$lowercasedName] ?? $name; } /** * @param int-mask-of<ReflectionMethod::IS_*>|null $filter * @return ReflectionMethod[] */ public function getMethods($filter = null) : array { return array_values(array_map(static function (BetterReflectionMethod $method) : \PHPStan\BetterReflection\Reflection\Adapter\ReflectionMethod { return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionMethod($method); }, $this->betterReflectionObject->getMethods($filter ?? 0))); } /** * {@inheritDoc} */ public function hasProperty($name) : bool { if ($name === '') { return \false; } return $this->betterReflectionObject->hasProperty($name); } /** * @param string $name * @return ReflectionProperty */ public function getProperty($name) : \ReflectionProperty { $property = $name !== '' ? $this->betterReflectionObject->getProperty($name) : null; if ($property === null) { throw new CoreReflectionException(sprintf('Property %s::$%s does not exist', $this->betterReflectionObject->getName(), $name)); } return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionProperty($property); } /** * @param int-mask-of<ReflectionProperty::IS_*>|null $filter * @return ReflectionProperty[] */ public function getProperties($filter = null) : array { return array_values(array_map(static function (BetterReflectionProperty $property) : \PHPStan\BetterReflection\Reflection\Adapter\ReflectionProperty { return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionProperty($property); }, $this->betterReflectionObject->getProperties($filter ?? 0))); } /** * {@inheritDoc} */ public function hasConstant($name) : bool { if ($name === '') { return \false; } return $this->betterReflectionObject->hasConstant($name); } /** * @param int-mask-of<ReflectionClassConstant::IS_*>|null $filter * * @return array<string, mixed> */ public function getConstants(?int $filter = null) : array { return array_map(static function (BetterReflectionClassConstant $betterConstant) { return $betterConstant->getValue(); }, $this->betterReflectionObject->getConstants($filter ?? 0)); } /** * {@inheritDoc} */ #[\ReturnTypeWillChange] public function getConstant($name) { if ($name === '') { return \false; } $betterReflectionConstant = $this->betterReflectionObject->getConstant($name); if ($betterReflectionConstant === null) { return \false; } return $betterReflectionConstant->getValue(); } /** * @param string $name * @return ReflectionClassConstant|false */ #[\ReturnTypeWillChange] public function getReflectionConstant($name) { if ($name === '') { return \false; } $betterReflectionConstant = $this->betterReflectionObject->getConstant($name); if ($betterReflectionConstant === null) { return \false; } return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionClassConstant($betterReflectionConstant); } /** * @param int-mask-of<ReflectionClassConstant::IS_*>|null $filter * * @return list<ReflectionClassConstant> */ public function getReflectionConstants(?int $filter = null) : array { return array_values(array_map(static function (BetterReflectionClassConstant $betterConstant) : \PHPStan\BetterReflection\Reflection\Adapter\ReflectionClassConstant { return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionClassConstant($betterConstant); }, $this->betterReflectionObject->getConstants($filter ?? 0))); } /** @return array<class-string, ReflectionClass> */ public function getInterfaces() : array { return array_map(static function (BetterReflectionClass $interface) : \PHPStan\BetterReflection\Reflection\Adapter\ReflectionClass { return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionClass($interface); }, $this->betterReflectionObject->getInterfaces()); } /** @return list<class-string> */ public function getInterfaceNames() : array { return $this->betterReflectionObject->getInterfaceNames(); } public function isInterface() : bool { return $this->betterReflectionObject->isInterface(); } /** @return array<trait-string, ReflectionClass> */ public function getTraits() : array { $traits = $this->betterReflectionObject->getTraits(); /** @var list<trait-string> $traitNames */ $traitNames = array_map(static function (BetterReflectionClass $trait) : string { return $trait->getName(); }, $traits); return array_combine($traitNames, array_map(static function (BetterReflectionClass $trait) : \PHPStan\BetterReflection\Reflection\Adapter\ReflectionClass { return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionClass($trait); }, $traits)); } /** @return list<trait-string> */ public function getTraitNames() : array { return $this->betterReflectionObject->getTraitNames(); } /** @return array<string, string> */ public function getTraitAliases() : array { return $this->betterReflectionObject->getTraitAliases(); } public function isTrait() : bool { return $this->betterReflectionObject->isTrait(); } public function isAbstract() : bool { return $this->betterReflectionObject->isAbstract(); } public function isFinal() : bool { return $this->betterReflectionObject->isFinal(); } public function isReadOnly() : bool { return $this->betterReflectionObject->isReadOnly(); } public function getModifiers() : int { return $this->betterReflectionObject->getModifiers(); } /** * {@inheritDoc} */ public function isInstance($object) : bool { return $this->betterReflectionObject->isInstance($object); } /** * @param mixed $arg * @param mixed ...$args * * @return object */ #[\ReturnTypeWillChange] public function newInstance($arg = null, ...$args) { throw new \PHPStan\BetterReflection\Reflection\Adapter\Exception\NotImplemented('Not implemented'); } /** * {@inheritDoc} */ #[\ReturnTypeWillChange] public function newInstanceWithoutConstructor() { throw new \PHPStan\BetterReflection\Reflection\Adapter\Exception\NotImplemented('Not implemented'); } /** * {@inheritDoc} */ #[\ReturnTypeWillChange] public function newInstanceArgs(?array $args = null) { throw new \PHPStan\BetterReflection\Reflection\Adapter\Exception\NotImplemented('Not implemented'); } /** * @return ReflectionClass|false */ #[\ReturnTypeWillChange] public function getParentClass() { $parentClass = $this->betterReflectionObject->getParentClass(); if ($parentClass === null) { return \false; } return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionClass($parentClass); } /** * {@inheritDoc} */ public function isSubclassOf($class) : bool { $realParentClassNames = $this->betterReflectionObject->getParentClassNames(); $parentClassNames = array_combine(array_map(static function (string $parentClassName) : string { return strtolower($parentClassName); }, $realParentClassNames), $realParentClassNames); $className = $class instanceof CoreReflectionClass ? $class->getName() : $class; $lowercasedClassName = strtolower($className); $realParentClassName = $parentClassNames[$lowercasedClassName] ?? $className; return $this->betterReflectionObject->isSubclassOf($realParentClassName); } /** * @return array<string, mixed> * * @psalm-suppress LessSpecificImplementedReturnType */ public function getStaticProperties() : array { return $this->betterReflectionObject->getStaticProperties(); } /** * {@inheritDoc} */ #[\ReturnTypeWillChange] public function getStaticPropertyValue($name, $default = null) { $betterReflectionProperty = $name !== '' ? $this->betterReflectionObject->getProperty($name) : null; if ($betterReflectionProperty === null) { if (func_num_args() === 2) { return $default; } throw new CoreReflectionException(sprintf('Property %s::$%s does not exist', $this->betterReflectionObject->getName(), $name)); } $property = new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionProperty($betterReflectionProperty); if (!$property->isStatic()) { throw new CoreReflectionException(sprintf('Property %s::$%s does not exist', $this->betterReflectionObject->getName(), $name)); } return $property->getValue(); } /** * {@inheritDoc} */ public function setStaticPropertyValue($name, $value) : void { $betterReflectionProperty = $name !== '' ? $this->betterReflectionObject->getProperty($name) : null; if ($betterReflectionProperty === null) { throw new CoreReflectionException(sprintf('Class %s does not have a property named %s', $this->betterReflectionObject->getName(), $name)); } $property = new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionProperty($betterReflectionProperty); if (!$property->isStatic()) { throw new CoreReflectionException(sprintf('Class %s does not have a property named %s', $this->betterReflectionObject->getName(), $name)); } $property->setValue($value); } /** @return array<string, scalar|array<scalar>|null> */ public function getDefaultProperties() : array { return $this->betterReflectionObject->getDefaultProperties(); } public function isIterateable() : bool { return $this->betterReflectionObject->isIterateable(); } public function isIterable() : bool { return $this->isIterateable(); } /** * @param \ReflectionClass|string $interface */ public function implementsInterface($interface) : bool { $realInterfaceNames = $this->betterReflectionObject->getInterfaceNames(); $interfaceNames = array_combine(array_map(static function (string $interfaceName) : string { return strtolower($interfaceName); }, $realInterfaceNames), $realInterfaceNames); $interfaceName = $interface instanceof CoreReflectionClass ? $interface->getName() : $interface; $lowercasedInterfaceName = strtolower($interfaceName); $realInterfaceName = $interfaceNames[$lowercasedInterfaceName] ?? $interfaceName; return $this->betterReflectionObject->implementsInterface($realInterfaceName); } public function getExtension() : ?CoreReflectionExtension { throw new \PHPStan\BetterReflection\Reflection\Adapter\Exception\NotImplemented('Not implemented'); } /** * {@inheritDoc} */ #[\ReturnTypeWillChange] public function getExtensionName() { return $this->betterReflectionObject->getExtensionName() ?? \false; } public function inNamespace() : bool { return $this->betterReflectionObject->inNamespace(); } public function getNamespaceName() : string { return $this->betterReflectionObject->getNamespaceName() ?? ''; } public function getShortName() : string { return $this->betterReflectionObject->getShortName(); } public function isAnonymous() : bool { return $this->betterReflectionObject->isAnonymous(); } /** * @param class-string|null $name * * @return list<ReflectionAttribute|FakeReflectionAttribute> */ public function getAttributes(?string $name = null, int $flags = 0) : array { if ($flags !== 0 && $flags !== \PHPStan\BetterReflection\Reflection\Adapter\ReflectionAttribute::IS_INSTANCEOF) { throw new ValueError('Argument #2 ($flags) must be a valid attribute filter flag'); } if ($name !== null && $flags !== 0) { $attributes = $this->betterReflectionObject->getAttributesByInstance($name); } elseif ($name !== null) { $attributes = $this->betterReflectionObject->getAttributesByName($name); } else { $attributes = $this->betterReflectionObject->getAttributes(); } return array_map(static function (BetterReflectionAttribute $betterReflectionAttribute) { return \PHPStan\BetterReflection\Reflection\Adapter\ReflectionAttributeFactory::create($betterReflectionAttribute); }, $attributes); } public function isEnum() : bool { return $this->betterReflectionObject->isEnum(); } /** * @return mixed */ public function __get(string $name) { if ($name === 'name') { return $this->betterReflectionObject->getName(); } throw new OutOfBoundsException(sprintf('Property %s::$%s does not exist.', self::class, $name)); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\Adapter; use ReflectionNamedType as CoreReflectionNamedType; use PHPStan\BetterReflection\Reflection\ReflectionNamedType as BetterReflectionNamedType; use function strtolower; /** @psalm-immutable */ final class ReflectionNamedType extends CoreReflectionNamedType { /** * @var BetterReflectionNamedType */ private $betterReflectionType; /** * @var bool */ private $allowsNull; public function __construct(BetterReflectionNamedType $betterReflectionType, bool $allowsNull) { $this->betterReflectionType = $betterReflectionType; $this->allowsNull = $allowsNull; } public function getName() : string { return $this->betterReflectionType->getName(); } /** @return non-empty-string */ public function __toString() : string { $type = strtolower($this->betterReflectionType->getName()); if (!$this->allowsNull || $type === 'mixed' || $type === 'null') { return $this->betterReflectionType->__toString(); } return '?' . $this->betterReflectionType->__toString(); } public function allowsNull() : bool { return $this->allowsNull; } public function isBuiltin() : bool { $type = strtolower($this->betterReflectionType->getName()); if ($type === 'self' || $type === 'parent' || $type === 'static') { return \false; } return $this->betterReflectionType->isBuiltin(); } public function isIdentifier() : bool { return $this->betterReflectionType->isIdentifier(); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\Adapter; use ArgumentCountError; use OutOfBoundsException; use PhpParser\Node\Expr; use ReflectionException as CoreReflectionException; use ReflectionProperty as CoreReflectionProperty; use ReturnTypeWillChange; use PHPStan\BetterReflection\Reflection\Exception\NoObjectProvided; use PHPStan\BetterReflection\Reflection\Exception\NotAnObject; use PHPStan\BetterReflection\Reflection\ReflectionAttribute as BetterReflectionAttribute; use PHPStan\BetterReflection\Reflection\ReflectionProperty as BetterReflectionProperty; use Throwable; use TypeError; use ValueError; use function array_map; use function gettype; use function sprintf; /** @psalm-suppress PropertyNotSetInConstructor */ final class ReflectionProperty extends CoreReflectionProperty { /** @internal */ public const IS_READONLY_COMPATIBILITY = 128; /** * @var BetterReflectionProperty */ private $betterReflectionProperty; public function __construct(BetterReflectionProperty $betterReflectionProperty) { $this->betterReflectionProperty = $betterReflectionProperty; unset($this->name); unset($this->class); } public function __toString() : string { return $this->betterReflectionProperty->__toString(); } public function getName() : string { return $this->betterReflectionProperty->getName(); } /** * {@inheritDoc} * @return mixed */ #[\ReturnTypeWillChange] public function getValue($object = null) { try { return $this->betterReflectionProperty->getValue($object); } catch (NoObjectProvided $exception) { return null; } catch (Throwable $e) { throw new CoreReflectionException($e->getMessage(), 0, $e); } } /** @psalm-suppress MethodSignatureMismatch * @param mixed $objectOrValue * @param mixed $value */ public function setValue($objectOrValue, $value = null) : void { try { $this->betterReflectionProperty->setValue($objectOrValue, $value); } catch (NoObjectProvided $exception) { throw new ArgumentCountError('ReflectionProperty::setValue() expects exactly 2 arguments, 1 given'); } catch (NotAnObject $exception) { throw new TypeError(sprintf('ReflectionProperty::setValue(): Argument #1 ($objectOrValue) must be of type object, %s given', gettype($objectOrValue))); } catch (Throwable $e) { throw new CoreReflectionException($e->getMessage(), 0, $e); } } public function hasType() : bool { return $this->betterReflectionProperty->hasType(); } /** * @return ReflectionUnionType|ReflectionNamedType|ReflectionIntersectionType|null */ public function getType() : ?\ReflectionType { return \PHPStan\BetterReflection\Reflection\Adapter\ReflectionType::fromTypeOrNull($this->betterReflectionProperty->getType()); } public function isPublic() : bool { return $this->betterReflectionProperty->isPublic(); } public function isPrivate() : bool { return $this->betterReflectionProperty->isPrivate(); } public function isProtected() : bool { return $this->betterReflectionProperty->isProtected(); } public function isStatic() : bool { return $this->betterReflectionProperty->isStatic(); } public function isDefault() : bool { return $this->betterReflectionProperty->isDefault(); } public function getModifiers() : int { return $this->betterReflectionProperty->getModifiers(); } public function getDeclaringClass() : \PHPStan\BetterReflection\Reflection\Adapter\ReflectionClass { return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionClass($this->betterReflectionProperty->getImplementingClass()); } /** * {@inheritDoc} */ #[\ReturnTypeWillChange] public function getDocComment() { return $this->betterReflectionProperty->getDocComment() ?? \false; } /** * {@inheritDoc} * @codeCoverageIgnore * @infection-ignore-all */ public function setAccessible($accessible) : void { } public function hasDefaultValue() : bool { return $this->betterReflectionProperty->hasDefaultValue(); } /** * @deprecated Use getDefaultValueExpression() * @return mixed */ #[\ReturnTypeWillChange] public function getDefaultValue() { return $this->betterReflectionProperty->getDefaultValue(); } /** * @deprecated Use getDefaultValueExpression() */ public function getDefaultValueExpr() : Expr { return $this->betterReflectionProperty->getDefaultValueExpression(); } public function getDefaultValueExpression() : Expr { return $this->betterReflectionProperty->getDefaultValueExpression(); } /** * {@inheritDoc} */ #[\ReturnTypeWillChange] public function isInitialized($object = null) { try { return $this->betterReflectionProperty->isInitialized($object); } catch (Throwable $e) { throw new CoreReflectionException($e->getMessage(), 0, $e); } } public function isPromoted() : bool { return $this->betterReflectionProperty->isPromoted(); } /** * @param class-string|null $name * * @return list<ReflectionAttribute|FakeReflectionAttribute> */ public function getAttributes(?string $name = null, int $flags = 0) : array { if ($flags !== 0 && $flags !== \PHPStan\BetterReflection\Reflection\Adapter\ReflectionAttribute::IS_INSTANCEOF) { throw new ValueError('Argument #2 ($flags) must be a valid attribute filter flag'); } if ($name !== null && $flags !== 0) { $attributes = $this->betterReflectionProperty->getAttributesByInstance($name); } elseif ($name !== null) { $attributes = $this->betterReflectionProperty->getAttributesByName($name); } else { $attributes = $this->betterReflectionProperty->getAttributes(); } return array_map(static function (BetterReflectionAttribute $betterReflectionAttribute) { return \PHPStan\BetterReflection\Reflection\Adapter\ReflectionAttributeFactory::create($betterReflectionAttribute); }, $attributes); } public function isReadOnly() : bool { return $this->betterReflectionProperty->isReadOnly(); } /** * @return mixed */ public function __get(string $name) { if ($name === 'name') { return $this->betterReflectionProperty->getName(); } if ($name === 'class') { return $this->betterReflectionProperty->getImplementingClass()->getName(); } throw new OutOfBoundsException(sprintf('Property %s::$%s does not exist.', self::class, $name)); } public function getBetterReflection() : BetterReflectionProperty { return $this->betterReflectionProperty; } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\Adapter; use PHPStan\BetterReflection\Reflection\ReflectionAttribute as BetterReflectionAttribute; use const PHP_VERSION_ID; final class ReflectionAttributeFactory { /** * @return \PHPStan\BetterReflection\Reflection\Adapter\ReflectionAttribute|\PHPStan\BetterReflection\Reflection\Adapter\FakeReflectionAttribute */ public static function create(BetterReflectionAttribute $betterReflectionAttribute) { if (PHP_VERSION_ID >= 80000 && PHP_VERSION_ID < 80012) { return new \PHPStan\BetterReflection\Reflection\Adapter\FakeReflectionAttribute($betterReflectionAttribute); } return new \PHPStan\BetterReflection\Reflection\Adapter\ReflectionAttribute($betterReflectionAttribute); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection; /** * This interface is used internally by the Generic reflector in order to * ensure we are working with BetterReflection reflections. * * @internal * * @psalm-immutable */ interface Reflection { /** * Get the name of the reflection (e.g. if this is a ReflectionClass this * will be the class name). */ public function getName() : string; } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection; use LogicException; use PhpParser\Node; use PhpParser\Node\Stmt\Class_ as ClassNode; use PhpParser\Node\Stmt\Enum_ as EnumNode; use PhpParser\Node\Stmt\Interface_ as InterfaceNode; use PhpParser\Node\Stmt\Trait_ as TraitNode; use PHPStan\BetterReflection\Reflector\Reflector; use PHPStan\BetterReflection\SourceLocator\Located\LocatedSource; use function array_combine; use function array_filter; use function array_key_exists; use function array_map; use function assert; /** @psalm-immutable */ class ReflectionEnum extends \PHPStan\BetterReflection\Reflection\ReflectionClass { /** * @var \PHPStan\BetterReflection\Reflection\ReflectionNamedType|null */ private $backingType; /** @var array<non-empty-string, ReflectionEnumCase> */ private $cases; /** * @var \PHPStan\BetterReflection\Reflector\Reflector */ private $reflector; /** * @param non-empty-string|null $namespace * * @phpcs:disable Generic.CodeAnalysis.UselessOverridingMethod.Found */ private function __construct(Reflector $reflector, EnumNode $node, LocatedSource $locatedSource, ?string $namespace = null) { $this->reflector = $reflector; parent::__construct($reflector, $node, $locatedSource, $namespace); $this->backingType = $this->createBackingType($node); $this->cases = $this->createCases($node); } /** * @internal * * @param EnumNode $node * @param non-empty-string|null $namespace * * @psalm-suppress MoreSpecificImplementedParamType * @return $this */ public static function createFromNode(Reflector $reflector, $node, LocatedSource $locatedSource, ?string $namespace = null) : \PHPStan\BetterReflection\Reflection\ReflectionClass { $node = $node; assert($node instanceof EnumNode); return new self($reflector, $node, $locatedSource, $namespace); } /** @param non-empty-string $name */ public function hasCase(string $name) : bool { return array_key_exists($name, $this->cases); } /** @param non-empty-string $name */ public function getCase(string $name) : ?\PHPStan\BetterReflection\Reflection\ReflectionEnumCase { return $this->cases[$name] ?? null; } /** @return array<non-empty-string, ReflectionEnumCase> */ public function getCases() : array { return $this->cases; } /** @return array<non-empty-string, ReflectionEnumCase> */ private function createCases(EnumNode $node) : array { $enumCasesNodes = array_filter($node->stmts, static function (Node\Stmt $stmt) : bool { return $stmt instanceof Node\Stmt\EnumCase; }); return array_combine(array_map(static function (Node\Stmt\EnumCase $enumCaseNode) : string { $enumCaseName = $enumCaseNode->name->toString(); assert($enumCaseName !== ''); return $enumCaseName; }, $enumCasesNodes), array_map(function (Node\Stmt\EnumCase $enumCaseNode) : \PHPStan\BetterReflection\Reflection\ReflectionEnumCase { return \PHPStan\BetterReflection\Reflection\ReflectionEnumCase::createFromNode($this->reflector, $enumCaseNode, $this); }, $enumCasesNodes)); } public function isBacked() : bool { return $this->backingType !== null; } public function getBackingType() : \PHPStan\BetterReflection\Reflection\ReflectionNamedType { if ($this->backingType === null) { throw new LogicException('This enum does not have a backing type available'); } return $this->backingType; } private function createBackingType(EnumNode $node) : ?\PHPStan\BetterReflection\Reflection\ReflectionNamedType { if ($node->scalarType === null) { return null; } $backingType = \PHPStan\BetterReflection\Reflection\ReflectionNamedType::createFromNode($this->reflector, $this, $node->scalarType); assert($backingType instanceof \PHPStan\BetterReflection\Reflection\ReflectionNamedType); return $backingType; } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection; use PhpParser\Node; use PhpParser\Node\IntersectionType; use PHPStan\BetterReflection\Reflector\Reflector; use function array_map; use function assert; use function implode; /** @psalm-immutable */ class ReflectionIntersectionType extends \PHPStan\BetterReflection\Reflection\ReflectionType { /** @var non-empty-list<ReflectionNamedType> */ private $types; /** @internal * @param \PHPStan\BetterReflection\Reflection\ReflectionParameter|\PHPStan\BetterReflection\Reflection\ReflectionMethod|\PHPStan\BetterReflection\Reflection\ReflectionFunction|\PHPStan\BetterReflection\Reflection\ReflectionEnum|\PHPStan\BetterReflection\Reflection\ReflectionProperty|\PHPStan\BetterReflection\Reflection\ReflectionClassConstant $owner */ public function __construct(Reflector $reflector, $owner, IntersectionType $type) { /** @var non-empty-list<ReflectionNamedType> $types */ $types = array_map(static function ($type) use($reflector, $owner) : \PHPStan\BetterReflection\Reflection\ReflectionNamedType { $type = \PHPStan\BetterReflection\Reflection\ReflectionType::createFromNode($reflector, $owner, $type); assert($type instanceof \PHPStan\BetterReflection\Reflection\ReflectionNamedType); return $type; }, $type->types); $this->types = $types; } /** @internal * @param \PHPStan\BetterReflection\Reflection\ReflectionParameter|\PHPStan\BetterReflection\Reflection\ReflectionMethod|\PHPStan\BetterReflection\Reflection\ReflectionFunction|\PHPStan\BetterReflection\Reflection\ReflectionEnum|\PHPStan\BetterReflection\Reflection\ReflectionProperty|\PHPStan\BetterReflection\Reflection\ReflectionClassConstant $owner * @return $this */ public function withOwner($owner) { $clone = clone $this; foreach ($clone->types as $typeNo => $innerType) { $clone->types[$typeNo] = $innerType->withOwner($owner); } return $clone; } /** @return non-empty-list<ReflectionNamedType> */ public function getTypes() : array { return $this->types; } /** @return false */ public function allowsNull() : bool { return \false; } /** @return non-empty-string */ public function __toString() : string { // @infection-ignore-all UnwrapArrayMap: It works without array_map() as well but this is less magical return implode('&', array_map(static function (\PHPStan\BetterReflection\Reflection\ReflectionNamedType $type) : string { return $type->__toString(); }, $this->types)); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\Annotation; use function preg_match; /** @internal */ final class AnnotationHelper { public const TENTATIVE_RETURN_TYPE_ANNOTATION = 'betterReflectionTentativeReturnType'; /** @psalm-pure */ public static function isDeprecated(?string $docComment) : bool { if ($docComment === null) { return \false; } return preg_match('~\\*\\s*@deprecated(?=\\s|\\*)~', $docComment) === 1; } /** @psalm-pure */ public static function hasTentativeReturnType(?string $docComment) : bool { if ($docComment === null) { return \false; } return preg_match('~\\*\\s*@' . self::TENTATIVE_RETURN_TYPE_ANNOTATION . '(?=\\s|\\*)~', $docComment) === 1; } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection; use LogicException; use PhpParser\Node; use PhpParser\Node\Stmt\EnumCase; use PHPStan\BetterReflection\NodeCompiler\CompiledValue; use PHPStan\BetterReflection\NodeCompiler\CompileNodeToValue; use PHPStan\BetterReflection\NodeCompiler\CompilerContext; use PHPStan\BetterReflection\Reflection\Annotation\AnnotationHelper; use PHPStan\BetterReflection\Reflection\Attribute\ReflectionAttributeHelper; use PHPStan\BetterReflection\Reflection\StringCast\ReflectionEnumCaseStringCast; use PHPStan\BetterReflection\Reflector\Reflector; use PHPStan\BetterReflection\Util\CalculateReflectionColumn; use PHPStan\BetterReflection\Util\GetLastDocComment; use function assert; use function is_int; use function is_string; /** @psalm-immutable */ class ReflectionEnumCase { /** @var non-empty-string */ private $name; /** * @var \PhpParser\Node\Expr|null */ private $value; /** @var list<ReflectionAttribute> */ private $attributes; /** @var non-empty-string|null */ private $docComment; /** @var positive-int */ private $startLine; /** @var positive-int */ private $endLine; /** @var positive-int */ private $startColumn; /** @var positive-int */ private $endColumn; /** @psalm-allow-private-mutation * @var \PHPStan\BetterReflection\NodeCompiler\CompiledValue|null */ private $compiledValue = null; /** * @var \PHPStan\BetterReflection\Reflector\Reflector */ private $reflector; /** * @var \PHPStan\BetterReflection\Reflection\ReflectionEnum */ private $enum; private function __construct(Reflector $reflector, EnumCase $node, \PHPStan\BetterReflection\Reflection\ReflectionEnum $enum) { $this->reflector = $reflector; $this->enum = $enum; $name = $node->name->toString(); assert($name !== ''); $this->name = $name; $this->value = $node->expr; $this->attributes = ReflectionAttributeHelper::createAttributes($reflector, $this, $node->attrGroups); $this->docComment = GetLastDocComment::forNode($node); $startLine = $node->getStartLine(); assert($startLine > 0); $endLine = $node->getEndLine(); assert($endLine > 0); $this->startLine = $startLine; $this->endLine = $endLine; $this->startColumn = CalculateReflectionColumn::getStartColumn($this->enum->getLocatedSource()->getSource(), $node); $this->endColumn = CalculateReflectionColumn::getEndColumn($this->enum->getLocatedSource()->getSource(), $node); } /** @internal */ public static function createFromNode(Reflector $reflector, EnumCase $node, \PHPStan\BetterReflection\Reflection\ReflectionEnum $enum) : self { return new self($reflector, $node, $enum); } /** @return non-empty-string */ public function getName() : string { return $this->name; } /** * @deprecated Use getValueExpression() */ public function getValueExpr() : Node\Expr { return $this->getValueExpression(); } /** * Check ReflectionEnum::isBacked() being true first to avoid throwing exception. * * @throws LogicException */ public function getValueExpression() : Node\Expr { if ($this->value === null) { throw new LogicException('This enum case does not have a value'); } return $this->value; } /** * @return string|int */ public function getValue() { $value = $this->getCompiledValue()->value; assert(is_string($value) || is_int($value)); return $value; } /** * Check ReflectionEnum::isBacked() being true first to avoid throwing exception. * * @throws LogicException */ private function getCompiledValue() : CompiledValue { if ($this->value === null) { throw new LogicException('This enum case does not have a value'); } if ($this->compiledValue === null) { $this->compiledValue = (new CompileNodeToValue())->__invoke($this->value, new CompilerContext($this->reflector, $this)); } return $this->compiledValue; } /** @return positive-int */ public function getStartLine() : int { return $this->startLine; } /** @return positive-int */ public function getEndLine() : int { return $this->endLine; } /** @return positive-int */ public function getStartColumn() : int { return $this->startColumn; } /** @return positive-int */ public function getEndColumn() : int { return $this->endColumn; } public function getDeclaringEnum() : \PHPStan\BetterReflection\Reflection\ReflectionEnum { return $this->enum; } public function getDeclaringClass() : \PHPStan\BetterReflection\Reflection\ReflectionClass { return $this->enum; } /** @return non-empty-string|null */ public function getDocComment() : ?string { return $this->docComment; } public function isDeprecated() : bool { return AnnotationHelper::isDeprecated($this->docComment); } /** @return list<ReflectionAttribute> */ public function getAttributes() : array { return $this->attributes; } /** @return list<ReflectionAttribute> */ public function getAttributesByName(string $name) : array { return ReflectionAttributeHelper::filterAttributesByName($this->getAttributes(), $name); } /** * @param class-string $className * * @return list<ReflectionAttribute> */ public function getAttributesByInstance(string $className) : array { return ReflectionAttributeHelper::filterAttributesByInstance($this->getAttributes(), $className); } /** @return non-empty-string */ public function __toString() : string { return ReflectionEnumCaseStringCast::toString($this); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection; use Closure; use Exception; use InvalidArgumentException; use LogicException; use OutOfBoundsException; use PhpParser\Node; use PhpParser\Node\Param as ParamNode; use PHPStan\BetterReflection\NodeCompiler\CompiledValue; use PHPStan\BetterReflection\NodeCompiler\CompileNodeToValue; use PHPStan\BetterReflection\NodeCompiler\CompilerContext; use PHPStan\BetterReflection\NodeCompiler\Exception\UnableToCompileNode; use PHPStan\BetterReflection\Reflection\Attribute\ReflectionAttributeHelper; use PHPStan\BetterReflection\Reflection\Exception\CodeLocationMissing; use PHPStan\BetterReflection\Reflection\StringCast\ReflectionParameterStringCast; use PHPStan\BetterReflection\Reflector\Reflector; use PHPStan\BetterReflection\Util\CalculateReflectionColumn; use PHPStan\BetterReflection\Util\Exception\NoNodePosition; use function array_map; use function assert; use function count; use function is_array; use function is_object; use function is_string; use function sprintf; /** @psalm-immutable */ class ReflectionParameter { /** @var non-empty-string */ private $name; /** * @var \PhpParser\Node\Expr|null */ private $default; /** * @var \PHPStan\BetterReflection\Reflection\ReflectionNamedType|\PHPStan\BetterReflection\Reflection\ReflectionUnionType|\PHPStan\BetterReflection\Reflection\ReflectionIntersectionType|null */ private $type; /** * @var bool */ private $isVariadic; /** * @var bool */ private $byRef; /** * @var bool */ private $isPromoted; /** @var list<ReflectionAttribute> */ private $attributes; /** @var positive-int|null */ private $startLine; /** @var positive-int|null */ private $endLine; /** @var positive-int|null */ private $startColumn; /** @var positive-int|null */ private $endColumn; /** @psalm-allow-private-mutation * @var \PHPStan\BetterReflection\NodeCompiler\CompiledValue|null */ private $compiledDefaultValue = null; /** * @var \PHPStan\BetterReflection\Reflector\Reflector */ private $reflector; /** * @var \PHPStan\BetterReflection\Reflection\ReflectionMethod|\PHPStan\BetterReflection\Reflection\ReflectionFunction */ private $function; /** * @var int */ private $parameterIndex; /** * @var bool */ private $isOptional; /** * @param \PHPStan\BetterReflection\Reflection\ReflectionMethod|\PHPStan\BetterReflection\Reflection\ReflectionFunction $function */ private function __construct(Reflector $reflector, ParamNode $node, $function, int $parameterIndex, bool $isOptional) { $this->reflector = $reflector; $this->function = $function; $this->parameterIndex = $parameterIndex; $this->isOptional = $isOptional; assert($node->var instanceof Node\Expr\Variable); assert(is_string($node->var->name)); $name = $node->var->name; assert($name !== ''); $this->name = $name; $this->default = $node->default; $this->isPromoted = $node->flags !== 0; $this->type = $this->createType($node); $this->isVariadic = $node->variadic; $this->byRef = $node->byRef; $this->attributes = ReflectionAttributeHelper::createAttributes($reflector, $this, $node->attrGroups); if ($node->hasAttribute('startLine')) { $startLine = $node->getStartLine(); assert($startLine > 0); } else { $startLine = null; } if ($node->hasAttribute('endLine')) { $endLine = $node->getEndLine(); assert($endLine > 0); } else { $endLine = null; } $this->startLine = $startLine; $this->endLine = $endLine; try { $this->startColumn = CalculateReflectionColumn::getStartColumn($function->getLocatedSource()->getSource(), $node); } catch (NoNodePosition $exception) { $this->startColumn = null; } try { $this->endColumn = CalculateReflectionColumn::getEndColumn($function->getLocatedSource()->getSource(), $node); } catch (NoNodePosition $exception) { $this->endColumn = null; } } /** * Create a reflection of a parameter using a class name * * @param non-empty-string $methodName * @param non-empty-string $parameterName * * @throws OutOfBoundsException */ public static function createFromClassNameAndMethod(string $className, string $methodName, string $parameterName) : self { $parameter = ($getMethod = \PHPStan\BetterReflection\Reflection\ReflectionClass::createFromName($className)->getMethod($methodName)) ? $getMethod->getParameter($parameterName) : null; if ($parameter === null) { throw new OutOfBoundsException(sprintf('Could not find parameter: %s', $parameterName)); } return $parameter; } /** * Create a reflection of a parameter using an instance * * @param non-empty-string $methodName * @param non-empty-string $parameterName * * @throws OutOfBoundsException */ public static function createFromClassInstanceAndMethod(object $instance, string $methodName, string $parameterName) : self { $parameter = ($getMethod = \PHPStan\BetterReflection\Reflection\ReflectionClass::createFromInstance($instance)->getMethod($methodName)) ? $getMethod->getParameter($parameterName) : null; if ($parameter === null) { throw new OutOfBoundsException(sprintf('Could not find parameter: %s', $parameterName)); } return $parameter; } /** * Create a reflection of a parameter using a closure * * @param non-empty-string $parameterName * * @throws OutOfBoundsException */ public static function createFromClosure(Closure $closure, string $parameterName) : \PHPStan\BetterReflection\Reflection\ReflectionParameter { $parameter = \PHPStan\BetterReflection\Reflection\ReflectionFunction::createFromClosure($closure)->getParameter($parameterName); if ($parameter === null) { throw new OutOfBoundsException(sprintf('Could not find parameter: %s', $parameterName)); } return $parameter; } /** * Create the parameter from the given spec. Possible $spec parameters are: * * - [$instance, 'method'] * - ['Foo', 'bar'] * - ['foo'] * - [function () {}] * * @param object[]|string[]|string|Closure $spec * @param non-empty-string $parameterName * * @throws Exception * @throws InvalidArgumentException */ public static function createFromSpec($spec, string $parameterName) : self { try { if (is_array($spec) && count($spec) === 2 && is_string($spec[1])) { assert($spec[1] !== ''); if (is_object($spec[0])) { return self::createFromClassInstanceAndMethod($spec[0], $spec[1], $parameterName); } return self::createFromClassNameAndMethod($spec[0], $spec[1], $parameterName); } if (is_string($spec)) { $parameter = \PHPStan\BetterReflection\Reflection\ReflectionFunction::createFromName($spec)->getParameter($parameterName); if ($parameter === null) { throw new OutOfBoundsException(sprintf('Could not find parameter: %s', $parameterName)); } return $parameter; } if ($spec instanceof Closure) { return self::createFromClosure($spec, $parameterName); } } catch (OutOfBoundsException $e) { throw new InvalidArgumentException('Could not create reflection from the spec given', 0, $e); } throw new InvalidArgumentException('Could not create reflection from the spec given'); } /** @return non-empty-string */ public function __toString() : string { return ReflectionParameterStringCast::toString($this); } /** * @internal * * @param ParamNode $node Node has to be processed by the PhpParser\NodeVisitor\NameResolver * @param \PHPStan\BetterReflection\Reflection\ReflectionMethod|\PHPStan\BetterReflection\Reflection\ReflectionFunction $function */ public static function createFromNode(Reflector $reflector, ParamNode $node, $function, int $parameterIndex, bool $isOptional) : self { return new self($reflector, $node, $function, $parameterIndex, $isOptional); } /** @internal * @param \PHPStan\BetterReflection\Reflection\ReflectionMethod|\PHPStan\BetterReflection\Reflection\ReflectionFunction $function */ public function withFunction($function) : self { $clone = clone $this; $clone->function = $function; if ($clone->type !== null) { $clone->type = $clone->type->withOwner($clone); } $clone->attributes = array_map(static function (\PHPStan\BetterReflection\Reflection\ReflectionAttribute $attribute) use($clone) : \PHPStan\BetterReflection\Reflection\ReflectionAttribute { return $attribute->withOwner($clone); }, $this->attributes); $this->compiledDefaultValue = null; return $clone; } /** @throws LogicException */ private function getCompiledDefaultValue() : CompiledValue { if (!$this->isDefaultValueAvailable()) { throw new LogicException('This parameter does not have a default value available'); } if ($this->compiledDefaultValue === null) { $this->compiledDefaultValue = (new CompileNodeToValue())->__invoke($this->default, new CompilerContext($this->reflector, $this)); } return $this->compiledDefaultValue; } /** * Get the name of the parameter. * * @return non-empty-string */ public function getName() : string { return $this->name; } /** * Get the function (or method) that declared this parameter. * @return \PHPStan\BetterReflection\Reflection\ReflectionMethod|\PHPStan\BetterReflection\Reflection\ReflectionFunction */ public function getDeclaringFunction() { return $this->function; } /** * Get the class from the method that this parameter belongs to, if it * exists. * * This will return null if the declaring function is not a method. */ public function getDeclaringClass() : ?\PHPStan\BetterReflection\Reflection\ReflectionClass { if ($this->function instanceof \PHPStan\BetterReflection\Reflection\ReflectionMethod) { return $this->function->getDeclaringClass(); } return null; } public function getImplementingClass() : ?\PHPStan\BetterReflection\Reflection\ReflectionClass { if ($this->function instanceof \PHPStan\BetterReflection\Reflection\ReflectionMethod) { return $this->function->getImplementingClass(); } return null; } /** * Is the parameter optional? * * Note this is distinct from "isDefaultValueAvailable" because you can have * a default value, but the parameter not be optional. In the example, the * $foo parameter isOptional() == false, but isDefaultValueAvailable == true * * @example someMethod($foo = 'foo', $bar) */ public function isOptional() : bool { return $this->isOptional; } /** * Does the parameter have a default, regardless of whether it is optional. * * Note this is distinct from "isOptional" because you can have * a default value, but the parameter not be optional. In the example, the * $foo parameter isOptional() == false, but isDefaultValueAvailable == true * * @example someMethod($foo = 'foo', $bar) * @psalm-assert-if-true Node\Expr $this->default */ public function isDefaultValueAvailable() : bool { return $this->default !== null; } /** * @deprecated Use getDefaultValueExpression() */ public function getDefaultValueExpr() : ?\PhpParser\Node\Expr { return $this->getDefaultValueExpression(); } public function getDefaultValueExpression() : ?\PhpParser\Node\Expr { return $this->default; } /** * Get the default value of the parameter. * * @deprecated Use getDefaultValueExpression() * * @throws LogicException * @throws UnableToCompileNode * @return mixed */ public function getDefaultValue() { /** @psalm-var scalar|array<scalar>|null $value */ $value = $this->getCompiledDefaultValue()->value; return $value; } /** * Does this method allow null for a parameter? */ public function allowsNull() : bool { $type = $this->getType(); if ($type === null) { return \true; } return $type->allowsNull(); } /** * Find the position of the parameter, left to right, starting at zero. */ public function getPosition() : int { return $this->parameterIndex; } /** * Get the ReflectionType instance representing the type declaration for * this parameter * * (note: this has nothing to do with DocBlocks). * @return \PHPStan\BetterReflection\Reflection\ReflectionNamedType|\PHPStan\BetterReflection\Reflection\ReflectionUnionType|\PHPStan\BetterReflection\Reflection\ReflectionIntersectionType|null */ public function getType() { return $this->type; } /** * @return \PHPStan\BetterReflection\Reflection\ReflectionNamedType|\PHPStan\BetterReflection\Reflection\ReflectionUnionType|\PHPStan\BetterReflection\Reflection\ReflectionIntersectionType|null */ private function createType(ParamNode $node) { $type = $node->type; if ($type === null) { return null; } assert($type instanceof Node\Identifier || $type instanceof Node\Name || $type instanceof Node\NullableType || $type instanceof Node\UnionType || $type instanceof Node\IntersectionType); $allowsNull = $this->default instanceof Node\Expr\ConstFetch && $this->default->name->toLowerString() === 'null' && !$this->isPromoted; return \PHPStan\BetterReflection\Reflection\ReflectionType::createFromNode($this->reflector, $this, $type, $allowsNull); } /** * Does this parameter have a type declaration? * * (note: this has nothing to do with DocBlocks). */ public function hasType() : bool { return $this->type !== null; } /** * Is this parameter a variadic (denoted by ...$param). */ public function isVariadic() : bool { return $this->isVariadic; } /** * Is this parameter passed by reference (denoted by &$param). */ public function isPassedByReference() : bool { return $this->byRef; } public function canBePassedByValue() : bool { return !$this->isPassedByReference(); } public function isPromoted() : bool { return $this->isPromoted; } /** @throws LogicException */ public function isDefaultValueConstant() : bool { return $this->getCompiledDefaultValue()->constantName !== null; } /** @throws LogicException */ public function getDefaultValueConstantName() : string { $compiledDefaultValue = $this->getCompiledDefaultValue(); if ($compiledDefaultValue->constantName === null) { throw new LogicException('This parameter is not a constant default value, so cannot have a constant name'); } return $compiledDefaultValue->constantName; } /** * @return positive-int * * @throws CodeLocationMissing */ public function getStartLine() : int { if ($this->startLine === null) { throw CodeLocationMissing::create(); } return $this->startLine; } /** * @return positive-int * * @throws CodeLocationMissing */ public function getEndLine() : int { if ($this->endLine === null) { throw CodeLocationMissing::create(); } return $this->endLine; } /** * @return positive-int * * @throws CodeLocationMissing */ public function getStartColumn() : int { if ($this->startColumn === null) { throw CodeLocationMissing::create(); } return $this->startColumn; } /** * @return positive-int * * @throws CodeLocationMissing */ public function getEndColumn() : int { if ($this->endColumn === null) { throw CodeLocationMissing::create(); } return $this->endColumn; } /** @return list<ReflectionAttribute> */ public function getAttributes() : array { return $this->attributes; } /** @return list<ReflectionAttribute> */ public function getAttributesByName(string $name) : array { return ReflectionAttributeHelper::filterAttributesByName($this->getAttributes(), $name); } /** * @param class-string $className * * @return list<ReflectionAttribute> */ public function getAttributesByInstance(string $className) : array { return ReflectionAttributeHelper::filterAttributesByInstance($this->getAttributes(), $className); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection; use BackedEnum; use PhpParser\Node; use PhpParser\Node\Stmt\Class_ as ClassNode; use PhpParser\Node\Stmt\ClassMethod; use PhpParser\Node\Stmt\Enum_ as EnumNode; use PhpParser\Node\Stmt\Interface_ as InterfaceNode; use PhpParser\Node\Stmt\Trait_ as TraitNode; use PhpParser\Node\Stmt\TraitUse; use ReflectionClass as CoreReflectionClass; use ReflectionException; use ReflectionMethod as CoreReflectionMethod; use PHPStan\BetterReflection\BetterReflection; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionClass as ReflectionClassAdapter; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionClassConstant as ReflectionClassConstantAdapter; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionMethod as ReflectionMethodAdapter; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionProperty as ReflectionPropertyAdapter; use PHPStan\BetterReflection\Reflection\Annotation\AnnotationHelper; use PHPStan\BetterReflection\Reflection\Attribute\ReflectionAttributeHelper; use PHPStan\BetterReflection\Reflection\Exception\CircularReference; use PHPStan\BetterReflection\Reflection\Exception\ClassDoesNotExist; use PHPStan\BetterReflection\Reflection\Exception\NoObjectProvided; use PHPStan\BetterReflection\Reflection\Exception\NotAnObject; use PHPStan\BetterReflection\Reflection\Exception\ObjectNotInstanceOfClass; use PHPStan\BetterReflection\Reflection\Exception\PropertyDoesNotExist; use PHPStan\BetterReflection\Reflection\StringCast\ReflectionClassStringCast; use PHPStan\BetterReflection\Reflection\Support\AlreadyVisitedClasses; use PHPStan\BetterReflection\Reflector\Exception\IdentifierNotFound; use PHPStan\BetterReflection\Reflector\Reflector; use PHPStan\BetterReflection\SourceLocator\Located\InternalLocatedSource; use PHPStan\BetterReflection\SourceLocator\Located\LocatedSource; use PHPStan\BetterReflection\Util\CalculateReflectionColumn; use PHPStan\BetterReflection\Util\GetLastDocComment; use Stringable; use Traversable; use UnitEnum; use function array_filter; use function array_key_exists; use function array_keys; use function array_map; use function array_merge; use function array_reverse; use function array_slice; use function array_values; use function assert; use function end; use function in_array; use function is_int; use function is_string; use function ltrim; use function sha1; use function sprintf; use function strtolower; /** @psalm-immutable */ class ReflectionClass implements \PHPStan\BetterReflection\Reflection\Reflection { public const ANONYMOUS_CLASS_NAME_PREFIX = 'class@anonymous'; public const ANONYMOUS_CLASS_NAME_PREFIX_REGEXP = '~^(?:class|[\\w\\\\]+)@anonymous~'; private const ANONYMOUS_CLASS_NAME_SUFFIX = '@anonymous'; /** @var class-string|trait-string|null */ private $name; /** @var non-empty-string|null */ private $shortName; /** * @var bool */ private $isInterface; /** * @var bool */ private $isTrait; /** * @var bool */ private $isEnum; /** * @var bool */ private $isBackedEnum; /** @var int-mask-of<ReflectionClassAdapter::IS_*> */ private $modifiers; /** @var non-empty-string|null */ private $docComment; /** @var list<ReflectionAttribute> */ private $attributes; /** @var positive-int */ private $startLine; /** @var positive-int */ private $endLine; /** @var positive-int */ private $startColumn; /** @var positive-int */ private $endColumn; /** @var class-string|null */ private $parentClassName; /** @var list<class-string> */ private $implementsClassNames; /** @var list<trait-string> */ private $traitClassNames; /** @var array<non-empty-string, ReflectionClassConstant> */ private $immediateConstants; /** @var array<non-empty-string, ReflectionProperty> */ private $immediateProperties; /** @var array<non-empty-string, ReflectionMethod> */ private $immediateMethods; /** @var array{aliases: array<non-empty-string, non-empty-string>, modifiers: array<non-empty-string, int-mask-of<ReflectionMethodAdapter::IS_*>>, precedences: array<non-empty-string, non-empty-string>} */ private $traitsData; /** * @var array<non-empty-string, ReflectionClassConstant>|null * @psalm-allow-private-mutation */ private $cachedConstants = null; /** * @var array<non-empty-string, ReflectionProperty>|null * @psalm-allow-private-mutation */ private $cachedProperties = null; /** @var array<class-string, ReflectionClass>|null */ private $cachedInterfaces = null; /** @var list<class-string>|null */ private $cachedInterfaceNames = null; /** @var list<ReflectionClass>|null */ private $cachedTraits = null; /** * @var \PHPStan\BetterReflection\Reflection\ReflectionMethod|null */ private $cachedConstructor = null; /** * @var string|null */ private $cachedName = null; /** * @psalm-allow-private-mutation * @var array<lowercase-string, ReflectionMethod>|null */ private $cachedMethods = null; /** * @var list<ReflectionClass>|null * @psalm-allow-private-mutation */ private $cachedParentClasses = null; /** * @var \PHPStan\BetterReflection\Reflector\Reflector */ private $reflector; /** * @var \PHPStan\BetterReflection\SourceLocator\Located\LocatedSource */ private $locatedSource; /** * @var non-empty-string|null */ private $namespace = null; /** * @internal * * @param non-empty-string|null $namespace * @param ClassNode|InterfaceNode|TraitNode|EnumNode $node */ protected function __construct(Reflector $reflector, $node, LocatedSource $locatedSource, ?string $namespace = null) { $this->reflector = $reflector; $this->locatedSource = $locatedSource; $this->namespace = $namespace; $this->name = null; $this->shortName = null; if ($node->name instanceof Node\Identifier) { $namespacedName = $node->namespacedName; if ($namespacedName === null) { /** @psalm-var class-string|trait-string */ $name = $node->name->name; } else { /** @psalm-var class-string|trait-string */ $name = $namespacedName->toString(); } $this->name = $name; $this->shortName = $node->name->name; } $this->isInterface = $node instanceof InterfaceNode; $this->isTrait = $node instanceof TraitNode; $this->isEnum = $node instanceof EnumNode; $this->isBackedEnum = $node instanceof EnumNode && $node->scalarType !== null; $this->modifiers = $this->computeModifiers($node); $this->docComment = GetLastDocComment::forNode($node); $this->attributes = ReflectionAttributeHelper::createAttributes($reflector, $this, $node->attrGroups); $startLine = $node->getStartLine(); assert($startLine > 0); $endLine = $node->getEndLine(); assert($endLine > 0); $this->startLine = $startLine; $this->endLine = $endLine; $this->startColumn = CalculateReflectionColumn::getStartColumn($locatedSource->getSource(), $node); $this->endColumn = CalculateReflectionColumn::getEndColumn($locatedSource->getSource(), $node); /** @var class-string|null $parentClassName */ $parentClassName = $node instanceof ClassNode ? ($nodeExtends = $node->extends) ? $nodeExtends->toString() : null : null; $this->parentClassName = $parentClassName; // @infection-ignore-all UnwrapArrayMap: It works without array_map() as well but this is less magical /** @var list<class-string> $implementsClassNames */ $implementsClassNames = array_map(static function (Node\Name $name) : string { return $name->toString(); }, $node instanceof TraitNode ? [] : ($node instanceof InterfaceNode ? $node->extends : $node->implements)); $this->implementsClassNames = $implementsClassNames; /** @var list<trait-string> $traitClassNames */ $traitClassNames = array_merge([], ...array_map( // @infection-ignore-all UnwrapArrayMap: It works without array_map() as well but this is less magical static function (TraitUse $traitUse) : array { return array_map(static function (Node\Name $traitName) : string { return $traitName->toString(); }, $traitUse->traits); }, $node->getTraitUses() )); $this->traitClassNames = $traitClassNames; $this->immediateConstants = $this->createImmediateConstants($node, $reflector); $this->immediateProperties = $this->createImmediateProperties($node, $reflector); $this->immediateMethods = $this->createImmediateMethods($node, $reflector); $this->traitsData = $this->computeTraitsData($node); } /** @return non-empty-string */ public function __toString() : string { return ReflectionClassStringCast::toString($this); } /** * Create a ReflectionClass by name, using default reflectors etc. * * @deprecated Use Reflector instead. * * @throws IdentifierNotFound */ public static function createFromName(string $className) : self { return (new BetterReflection())->reflector()->reflectClass($className); } /** * Create a ReflectionClass from an instance, using default reflectors etc. * * This is simply a helper method that calls ReflectionObject::createFromInstance(). * * @see ReflectionObject::createFromInstance * * @throws IdentifierNotFound * @throws ReflectionException */ public static function createFromInstance(object $instance) : self { return \PHPStan\BetterReflection\Reflection\ReflectionObject::createFromInstance($instance); } /** * Create from a Class Node. * * @internal * * @param ClassNode|InterfaceNode|TraitNode|EnumNode $node Node has to be processed by the PhpParser\NodeVisitor\NameResolver * @param non-empty-string|null $namespace optional - if omitted, we assume it is global namespaced class */ public static function createFromNode(Reflector $reflector, $node, LocatedSource $locatedSource, ?string $namespace = null) : self { return new self($reflector, $node, $locatedSource, $namespace); } /** * Get the "short" name of the class (e.g. for A\B\Foo, this will return * "Foo"). * * @return non-empty-string */ public function getShortName() : string { if ($this->shortName !== null) { return $this->shortName; } $fileName = $this->getFileName(); if ($fileName === null) { $fileName = sha1($this->locatedSource->getSource()); } return sprintf('%s%s%c%s(%d)', $this->getAnonymousClassNamePrefix(), self::ANONYMOUS_CLASS_NAME_SUFFIX, "\x00", $fileName, $this->getStartLine()); } /** * PHP creates the name of the anonymous class based on first parent * or implemented interface. */ private function getAnonymousClassNamePrefix() : string { if ($this->parentClassName !== null) { return $this->parentClassName; } if ($this->implementsClassNames !== []) { return $this->implementsClassNames[0]; } return 'class'; } /** * Get the "full" name of the class (e.g. for A\B\Foo, this will return * "A\B\Foo"). * * @return class-string|trait-string */ public function getName() : string { if ($this->cachedName !== null) { return $this->cachedName; } if (!$this->inNamespace()) { /** @psalm-var class-string|trait-string */ return $this->cachedName = $this->getShortName(); } assert($this->name !== null); return $this->cachedName = $this->name; } /** @return class-string|null */ public function getParentClassName() : ?string { return $this->parentClassName; } /** * Get the "namespace" name of the class (e.g. for A\B\Foo, this will * return "A\B"). * * @return non-empty-string|null */ public function getNamespaceName() : ?string { return $this->namespace; } /** * Decide if this class is part of a namespace. Returns false if the class * is in the global namespace or does not have a specified namespace. */ public function inNamespace() : bool { return $this->namespace !== null; } /** @return non-empty-string|null */ public function getExtensionName() : ?string { return $this->locatedSource->getExtensionName(); } /** @return list<ReflectionMethod> */ private function createMethodsFromTrait(\PHPStan\BetterReflection\Reflection\ReflectionMethod $method) : array { $methodModifiers = $method->getModifiers(); $methodHash = $this->methodHash($method->getImplementingClass()->getName(), $method->getName()); if (array_key_exists($methodHash, $this->traitsData['modifiers'])) { $newModifierAst = $this->traitsData['modifiers'][$methodHash]; if ($this->traitsData['modifiers'][$methodHash] & ClassNode::VISIBILITY_MODIFIER_MASK) { $methodModifiersWithoutVisibility = $methodModifiers; if (($methodModifiers & CoreReflectionMethod::IS_PUBLIC) === CoreReflectionMethod::IS_PUBLIC) { $methodModifiersWithoutVisibility -= CoreReflectionMethod::IS_PUBLIC; } if (($methodModifiers & CoreReflectionMethod::IS_PROTECTED) === CoreReflectionMethod::IS_PROTECTED) { $methodModifiersWithoutVisibility -= CoreReflectionMethod::IS_PROTECTED; } if (($methodModifiers & CoreReflectionMethod::IS_PRIVATE) === CoreReflectionMethod::IS_PRIVATE) { $methodModifiersWithoutVisibility -= CoreReflectionMethod::IS_PRIVATE; } $newModifier = 0; if (($newModifierAst & ClassNode::MODIFIER_PUBLIC) === ClassNode::MODIFIER_PUBLIC) { $newModifier = CoreReflectionMethod::IS_PUBLIC; } if (($newModifierAst & ClassNode::MODIFIER_PROTECTED) === ClassNode::MODIFIER_PROTECTED) { $newModifier = CoreReflectionMethod::IS_PROTECTED; } if (($newModifierAst & ClassNode::MODIFIER_PRIVATE) === ClassNode::MODIFIER_PRIVATE) { $newModifier = CoreReflectionMethod::IS_PRIVATE; } $methodModifiers = $methodModifiersWithoutVisibility | $newModifier; } if (($newModifierAst & ClassNode::MODIFIER_FINAL) === ClassNode::MODIFIER_FINAL) { $methodModifiers |= CoreReflectionMethod::IS_FINAL; } } $createMethod = function (?string $aliasMethodName) use($method, $methodModifiers) : \PHPStan\BetterReflection\Reflection\ReflectionMethod { assert($aliasMethodName === null || $aliasMethodName !== ''); /** @phpstan-ignore-next-line */ return $method->withImplementingClass($this, $aliasMethodName, $methodModifiers); }; $methods = []; if (!array_key_exists($methodHash, $this->traitsData['precedences'])) { $methods[] = $createMethod($method->getAliasName()); } foreach ($this->traitsData['aliases'] as $aliasMethodName => $traitAliasDefinition) { if ($methodHash !== $traitAliasDefinition) { continue; } $methods[] = $createMethod($aliasMethodName); } return $methods; } /** * Construct a flat list of all methods in this precise order from: * - current class * - parent class * - traits used in parent class * - interfaces implemented in parent class * - traits used in current class * - interfaces implemented in current class * * Methods are not merged via their name as array index, since internal PHP method * sorting does not follow `\array_merge()` semantics. * * @return array<lowercase-string, ReflectionMethod> indexed by method name */ private function getMethodsIndexedByLowercasedName(AlreadyVisitedClasses $alreadyVisitedClasses) : array { if ($this->cachedMethods !== null) { return $this->cachedMethods; } $alreadyVisitedClasses->push($this->getName()); $immediateMethods = $this->getImmediateMethods(); $className = $this->getName(); $methods = \array_combine(array_map(static function (\PHPStan\BetterReflection\Reflection\ReflectionMethod $method) : string { return strtolower($method->getName()); }, $immediateMethods), $immediateMethods); $parentClass = $this->getParentClass(); if ($parentClass !== null) { foreach ($parentClass->getMethodsIndexedByLowercasedName($alreadyVisitedClasses) as $lowercasedMethodName => $method) { if (array_key_exists($lowercasedMethodName, $methods)) { continue; } $methods[$lowercasedMethodName] = $method->withCurrentClass($this); } } foreach ($this->getTraits() as $trait) { $alreadyVisitedClassesCopy = clone $alreadyVisitedClasses; foreach ($trait->getMethodsIndexedByLowercasedName($alreadyVisitedClassesCopy) as $method) { foreach ($this->createMethodsFromTrait($method) as $traitMethod) { $lowercasedMethodName = strtolower($traitMethod->getName()); if (!array_key_exists($lowercasedMethodName, $methods)) { $methods[$lowercasedMethodName] = $traitMethod; continue; } if ($traitMethod->isAbstract()) { continue; } // Non-abstract trait method can overwrite existing method: // - when existing method comes from parent class // - when existing method comes from trait and is abstract $existingMethod = $methods[$lowercasedMethodName]; if ($existingMethod->getDeclaringClass()->getName() === $className && !($existingMethod->isAbstract() && $existingMethod->getDeclaringClass()->isTrait())) { continue; } $methods[$lowercasedMethodName] = $traitMethod; } } } foreach ($this->getImmediateInterfaces() as $interface) { $alreadyVisitedClassesCopy = clone $alreadyVisitedClasses; foreach ($interface->getMethodsIndexedByLowercasedName($alreadyVisitedClassesCopy) as $lowercasedMethodName => $method) { if (array_key_exists($lowercasedMethodName, $methods)) { continue; } $methods[$lowercasedMethodName] = $method; } } $this->cachedMethods = $methods; return $this->cachedMethods; } /** * Fetch an array of all methods for this class. * * Filter the results to include only methods with certain attributes. Defaults * to no filtering. * Any combination of \ReflectionMethod::IS_STATIC, * \ReflectionMethod::IS_PUBLIC, * \ReflectionMethod::IS_PROTECTED, * \ReflectionMethod::IS_PRIVATE, * \ReflectionMethod::IS_ABSTRACT, * \ReflectionMethod::IS_FINAL. * For example if $filter = \ReflectionMethod::IS_PUBLIC | \ReflectionMethod::IS_FINAL * the only the final public methods will be returned * * @param int-mask-of<CoreReflectionMethod::IS_*> $filter * * @return array<non-empty-string, ReflectionMethod> */ public function getMethods(int $filter = 0) : array { $methods = $this->getMethodsIndexedByLowercasedName(AlreadyVisitedClasses::createEmpty()); if ($filter !== 0) { $methods = array_filter($methods, static function (\PHPStan\BetterReflection\Reflection\ReflectionMethod $method) use($filter) : bool { return (bool) ($filter & $method->getModifiers()); }); } return \array_combine(array_map(static function (\PHPStan\BetterReflection\Reflection\ReflectionMethod $method) : string { return $method->getName(); }, $methods), $methods); } /** * Get only the methods that this class implements (i.e. do not search * up parent classes etc.) * * @see ReflectionClass::getMethods for the usage of $filter * * @param int-mask-of<CoreReflectionMethod::IS_*> $filter * * @return array<non-empty-string, ReflectionMethod> */ public function getImmediateMethods(int $filter = 0) : array { if ($filter === 0) { return $this->immediateMethods; } return array_filter($this->immediateMethods, static function (\PHPStan\BetterReflection\Reflection\ReflectionMethod $method) use($filter) : bool { return (bool) ($filter & $method->getModifiers()); }); } /** @return array<non-empty-string, ReflectionMethod> * @param ClassNode|InterfaceNode|TraitNode|EnumNode $node */ private function createImmediateMethods($node, Reflector $reflector) : array { $methods = []; foreach ($node->getMethods() as $methodNode) { $method = \PHPStan\BetterReflection\Reflection\ReflectionMethod::createFromNode($reflector, $methodNode, $this->locatedSource, $this->getNamespaceName(), $this, $this, $this); if (array_key_exists($method->getName(), $methods)) { continue; } $methods[$method->getName()] = $method; } if ($node instanceof EnumNode) { $methods = $this->addEnumMethods($node, $methods); } return $methods; } /** * @param array<non-empty-string, ReflectionMethod> $methods * * @return array<non-empty-string, ReflectionMethod> */ private function addEnumMethods(EnumNode $node, array $methods) : array { $internalLocatedSource = new InternalLocatedSource('', $this->getName(), 'Core', $this->getFileName()); $createMethod = function (string $name, array $params, $returnType) use($internalLocatedSource) : \PHPStan\BetterReflection\Reflection\ReflectionMethod { return \PHPStan\BetterReflection\Reflection\ReflectionMethod::createFromNode($this->reflector, new ClassMethod(new Node\Identifier($name), ['flags' => ClassNode::MODIFIER_PUBLIC | ClassNode::MODIFIER_STATIC, 'params' => $params, 'returnType' => $returnType]), $internalLocatedSource, $this->getNamespaceName(), $this, $this, $this); }; $methods['cases'] = $createMethod('cases', [], new Node\Identifier('array')); if ($node->scalarType === null) { return $methods; } $valueParameter = new Node\Param(new Node\Expr\Variable('value'), null, new Node\UnionType([new Node\Identifier('string'), new Node\Identifier('int')])); $methods['from'] = $createMethod('from', [$valueParameter], new Node\Identifier('static')); $methods['tryFrom'] = $createMethod('tryFrom', [$valueParameter], new Node\NullableType(new Node\Identifier('static'))); return $methods; } /** * Get a single method with the name $methodName. * * @param non-empty-string $methodName */ public function getMethod(string $methodName) : ?\PHPStan\BetterReflection\Reflection\ReflectionMethod { $lowercaseMethodName = strtolower($methodName); $methods = $this->getMethodsIndexedByLowercasedName(AlreadyVisitedClasses::createEmpty()); return $methods[$lowercaseMethodName] ?? null; } /** * Does the class have the specified method? * * @param non-empty-string $methodName */ public function hasMethod(string $methodName) : bool { return $this->getMethod($methodName) !== null; } /** * Get an associative array of only the constants for this specific class (i.e. do not search * up parent classes etc.), with keys as constant names and values as {@see ReflectionClassConstant} objects. * * @param int-mask-of<ReflectionClassConstantAdapter::IS_*> $filter * * @return array<non-empty-string, ReflectionClassConstant> indexed by name */ public function getImmediateConstants(int $filter = 0) : array { if ($filter === 0) { return $this->immediateConstants; } return array_filter($this->immediateConstants, static function (\PHPStan\BetterReflection\Reflection\ReflectionClassConstant $constant) use($filter) : bool { return (bool) ($filter & $constant->getModifiers()); }); } /** * Does this class have the specified constant? * * @param non-empty-string $name */ public function hasConstant(string $name) : bool { return $this->getConstant($name) !== null; } /** * Get the reflection object of the specified class constant. * * Returns null if not specified. * * @param non-empty-string $name */ public function getConstant(string $name) : ?\PHPStan\BetterReflection\Reflection\ReflectionClassConstant { return $this->getConstants()[$name] ?? null; } /** @return array<non-empty-string, ReflectionClassConstant> * @param ClassNode|InterfaceNode|TraitNode|EnumNode $node */ private function createImmediateConstants($node, Reflector $reflector) : array { $constants = []; foreach ($node->getConstants() as $constantsNode) { foreach (array_keys($constantsNode->consts) as $constantPositionInNode) { assert(is_int($constantPositionInNode)); $constant = \PHPStan\BetterReflection\Reflection\ReflectionClassConstant::createFromNode($reflector, $constantsNode, $constantPositionInNode, $this, $this); $constants[$constant->getName()] = $constant; } } return $constants; } /** * Get an associative array of the defined constants in this class, * with keys as constant names and values as {@see ReflectionClassConstant} objects. * * @param int-mask-of<ReflectionClassConstantAdapter::IS_*> $filter * * @return array<non-empty-string, ReflectionClassConstant> indexed by name */ public function getConstants(int $filter = 0) : array { $constants = $this->getConstantsConsideringAlreadyVisitedClasses(AlreadyVisitedClasses::createEmpty()); if ($filter === 0) { return $constants; } return array_filter($constants, static function (\PHPStan\BetterReflection\Reflection\ReflectionClassConstant $constant) use($filter) : bool { return (bool) ($filter & $constant->getModifiers()); }); } /** @return array<non-empty-string, ReflectionClassConstant> indexed by name */ private function getConstantsConsideringAlreadyVisitedClasses(AlreadyVisitedClasses $alreadyVisitedClasses) : array { if ($this->cachedConstants !== null) { return $this->cachedConstants; } $alreadyVisitedClasses->push($this->getName()); // Note: constants are not merged via their name as array index, since internal PHP constant // sorting does not follow `\array_merge()` semantics $constants = $this->getImmediateConstants(); $parentClass = $this->getParentClass(); if ($parentClass !== null) { foreach ($parentClass->getConstantsConsideringAlreadyVisitedClasses($alreadyVisitedClasses) as $constantName => $constant) { if ($constant->isPrivate()) { continue; } if (array_key_exists($constantName, $constants)) { continue; } $constants[$constantName] = $constant; } } foreach ($this->getTraits() as $trait) { foreach ($trait->getConstantsConsideringAlreadyVisitedClasses($alreadyVisitedClasses) as $constantName => $constant) { if (array_key_exists($constantName, $constants)) { continue; } $constants[$constantName] = $constant->withImplementingClass($this); } } foreach ($this->getImmediateInterfaces() as $interface) { $alreadyVisitedClassesCopy = clone $alreadyVisitedClasses; foreach ($interface->getConstantsConsideringAlreadyVisitedClasses($alreadyVisitedClassesCopy) as $constantName => $constant) { if (array_key_exists($constantName, $constants)) { continue; } $constants[$constantName] = $constant; } } $this->cachedConstants = $constants; return $this->cachedConstants; } /** * Get the constructor method for this class. */ public function getConstructor() : ?\PHPStan\BetterReflection\Reflection\ReflectionMethod { if ($this->cachedConstructor !== null) { return $this->cachedConstructor; } $constructors = array_values(array_filter($this->getMethods(), static function (\PHPStan\BetterReflection\Reflection\ReflectionMethod $method) : bool { return $method->isConstructor(); })); return $this->cachedConstructor = $constructors[0] ?? null; } /** * Get only the properties for this specific class (i.e. do not search * up parent classes etc.) * * @see ReflectionClass::getProperties() for the usage of filter * * @param int-mask-of<ReflectionPropertyAdapter::IS_*> $filter * * @return array<non-empty-string, ReflectionProperty> */ public function getImmediateProperties(int $filter = 0) : array { if ($filter === 0) { return $this->immediateProperties; } return array_filter($this->immediateProperties, static function (\PHPStan\BetterReflection\Reflection\ReflectionProperty $property) use($filter) : bool { return (bool) ($filter & $property->getModifiers()); }); } /** @return array<non-empty-string, ReflectionProperty> * @param ClassNode|InterfaceNode|TraitNode|EnumNode $node */ private function createImmediateProperties($node, Reflector $reflector) : array { $properties = []; foreach ($node->getProperties() as $propertiesNode) { foreach ($propertiesNode->props as $propertyPropertyNode) { $property = \PHPStan\BetterReflection\Reflection\ReflectionProperty::createFromNode($reflector, $propertiesNode, $propertyPropertyNode, $this, $this); $properties[$property->getName()] = $property; } } foreach ($node->getMethods() as $methodNode) { if ($methodNode->name->toLowerString() !== '__construct') { continue; } foreach ($methodNode->params as $parameterNode) { if ($parameterNode->flags === 0) { // No flags, no promotion continue; } $parameterNameNode = $parameterNode->var; assert($parameterNameNode instanceof Node\Expr\Variable); assert(is_string($parameterNameNode->name)); $propertyNode = new Node\Stmt\Property($parameterNode->flags, [new Node\Stmt\PropertyProperty($parameterNameNode->name)], $parameterNode->getAttributes(), $parameterNode->type, $parameterNode->attrGroups); $property = \PHPStan\BetterReflection\Reflection\ReflectionProperty::createFromNode($reflector, $propertyNode, $propertyNode->props[0], $this, $this, \true); $properties[$property->getName()] = $property; } } if ($node instanceof EnumNode || $node instanceof InterfaceNode) { $properties = $this->addEnumProperties($properties, $node, $reflector); } return $properties; } /** * @param array<non-empty-string, ReflectionProperty> $properties * * @return array<non-empty-string, ReflectionProperty> * @param EnumNode|InterfaceNode $node */ private function addEnumProperties(array $properties, $node, Reflector $reflector) : array { $createProperty = function (string $name, $type) use($reflector) : \PHPStan\BetterReflection\Reflection\ReflectionProperty { $propertyNode = new Node\Stmt\Property(ClassNode::MODIFIER_PUBLIC | ClassNode::MODIFIER_READONLY, [new Node\Stmt\PropertyProperty($name)], [], $type); return \PHPStan\BetterReflection\Reflection\ReflectionProperty::createFromNode($reflector, $propertyNode, $propertyNode->props[0], $this, $this); }; if ($node instanceof InterfaceNode) { $interfaceName = $this->getName(); if ($interfaceName === 'UnitEnum') { $properties['name'] = $createProperty('name', 'string'); } if ($interfaceName === 'BackedEnum') { $properties['value'] = $createProperty('value', new Node\UnionType([new Node\Identifier('int'), new Node\Identifier('string')])); } } else { $properties['name'] = $createProperty('name', 'string'); if ($node->scalarType !== null) { $properties['value'] = $createProperty('value', $node->scalarType); } } return $properties; } /** * Get the properties for this class. * * Filter the results to include only properties with certain attributes. Defaults * to no filtering. * Any combination of \ReflectionProperty::IS_STATIC, * \ReflectionProperty::IS_PUBLIC, * \ReflectionProperty::IS_PROTECTED, * \ReflectionProperty::IS_PRIVATE. * For example if $filter = \ReflectionProperty::IS_STATIC | \ReflectionProperty::IS_PUBLIC * only the static public properties will be returned * * @param int-mask-of<ReflectionPropertyAdapter::IS_*> $filter * * @return array<non-empty-string, ReflectionProperty> */ public function getProperties(int $filter = 0) : array { $properties = $this->getPropertiesConsideringAlreadyVisitedClasses(AlreadyVisitedClasses::createEmpty()); if ($filter === 0) { return $properties; } return array_filter($properties, static function (\PHPStan\BetterReflection\Reflection\ReflectionProperty $property) use($filter) : bool { return (bool) ($filter & $property->getModifiers()); }); } /** @return array<non-empty-string, ReflectionProperty> */ private function getPropertiesConsideringAlreadyVisitedClasses(AlreadyVisitedClasses $alreadyVisitedClasses) : array { if ($this->cachedProperties !== null) { return $this->cachedProperties; } $alreadyVisitedClasses->push($this->getName()); $immediateProperties = $this->getImmediateProperties(); // Merging together properties from parent class, interfaces, traits, current class (in this precise order) $properties = array_merge(array_filter((($getParentClass = $this->getParentClass()) ? $getParentClass->getPropertiesConsideringAlreadyVisitedClasses($alreadyVisitedClasses) : null) ?? [], static function (\PHPStan\BetterReflection\Reflection\ReflectionProperty $property) { return !$property->isPrivate(); }), ...array_map(static function (\PHPStan\BetterReflection\Reflection\ReflectionClass $ancestor) use($alreadyVisitedClasses) : array { return $ancestor->getPropertiesConsideringAlreadyVisitedClasses(clone $alreadyVisitedClasses); }, array_values($this->getImmediateInterfaces()))); foreach ($this->getTraits() as $trait) { foreach ($trait->getPropertiesConsideringAlreadyVisitedClasses($alreadyVisitedClasses) as $traitProperty) { $traitPropertyName = $traitProperty->getName(); if (array_key_exists($traitPropertyName, $properties) || array_key_exists($traitPropertyName, $immediateProperties)) { continue; } $properties[$traitPropertyName] = $traitProperty->withImplementingClass($this); } } // Merge immediate properties last to get the required order $properties = array_merge($properties, $immediateProperties); $this->cachedProperties = $properties; return $this->cachedProperties; } /** * Get the property called $name. * * Returns null if property does not exist. * * @param non-empty-string $name */ public function getProperty(string $name) : ?\PHPStan\BetterReflection\Reflection\ReflectionProperty { $properties = $this->getProperties(); if (!isset($properties[$name])) { return null; } return $properties[$name]; } /** * Does this class have the specified property? * * @param non-empty-string $name */ public function hasProperty(string $name) : bool { return $this->getProperty($name) !== null; } /** @return array<non-empty-string, mixed> */ public function getDefaultProperties() : array { return array_map(static function (\PHPStan\BetterReflection\Reflection\ReflectionProperty $property) { return $property->getDefaultValue(); }, $this->getProperties()); } /** @return non-empty-string|null */ public function getFileName() : ?string { return $this->locatedSource->getFileName(); } public function getLocatedSource() : LocatedSource { return $this->locatedSource; } /** * Get the line number that this class starts on. * * @return positive-int */ public function getStartLine() : int { return $this->startLine; } /** * Get the line number that this class ends on. * * @return positive-int */ public function getEndLine() : int { return $this->endLine; } /** @return positive-int */ public function getStartColumn() : int { return $this->startColumn; } /** @return positive-int */ public function getEndColumn() : int { return $this->endColumn; } /** * Get the parent class, if it is defined. */ public function getParentClass() : ?\PHPStan\BetterReflection\Reflection\ReflectionClass { $parentClassName = $this->getParentClassName(); if ($parentClassName === null) { return null; } if ($this->name === $parentClassName) { throw CircularReference::fromClassName($parentClassName); } try { return $this->reflector->reflectClass($parentClassName); } catch (IdentifierNotFound $exception) { return null; } } /** * Gets the parent class names. * * @return list<class-string> A numerical array with parent class names as the values. */ public function getParentClassNames() : array { return array_map(static function (self $parentClass) : string { return $parentClass->getName(); }, $this->getParentClasses()); } /** @return list<ReflectionClass> */ private function getParentClasses() : array { if ($this->cachedParentClasses === null) { $parentClasses = []; $parentClassName = $this->parentClassName; while ($parentClassName !== null) { try { $parentClass = $this->reflector->reflectClass($parentClassName); } catch (IdentifierNotFound $exception) { break; } if ($this->name === $parentClassName || array_key_exists($parentClassName, $parentClasses)) { throw CircularReference::fromClassName($parentClassName); } $parentClasses[$parentClassName] = $parentClass; $parentClassName = $parentClass->parentClassName; } $this->cachedParentClasses = array_values($parentClasses); } return $this->cachedParentClasses; } /** @return non-empty-string|null */ public function getDocComment() : ?string { return $this->docComment; } public function isAnonymous() : bool { return $this->name === null; } /** * Is this an internal class? */ public function isInternal() : bool { return $this->locatedSource->isInternal(); } /** * Is this a user-defined function (will always return the opposite of * whatever isInternal returns). */ public function isUserDefined() : bool { return !$this->isInternal(); } public function isDeprecated() : bool { return AnnotationHelper::isDeprecated($this->docComment); } /** * Is this class an abstract class. */ public function isAbstract() : bool { return ($this->modifiers & CoreReflectionClass::IS_EXPLICIT_ABSTRACT) === CoreReflectionClass::IS_EXPLICIT_ABSTRACT; } /** * Is this class a final class. */ public function isFinal() : bool { if ($this->isEnum) { return \true; } return ($this->modifiers & CoreReflectionClass::IS_FINAL) === CoreReflectionClass::IS_FINAL; } public function isReadOnly() : bool { return ($this->modifiers & ReflectionClassAdapter::IS_READONLY_COMPATIBILITY) === ReflectionClassAdapter::IS_READONLY_COMPATIBILITY; } /** * Get the core-reflection-compatible modifier values. * * @return int-mask-of<ReflectionClassAdapter::IS_*> */ public function getModifiers() : int { return $this->modifiers; } /** @return int-mask-of<ReflectionClassAdapter::IS_*> * @param ClassNode|InterfaceNode|TraitNode|EnumNode $node */ private function computeModifiers($node) : int { if (!$node instanceof ClassNode) { return 0; } $modifiers = $node->isAbstract() ? CoreReflectionClass::IS_EXPLICIT_ABSTRACT : 0; $modifiers += $node->isFinal() ? CoreReflectionClass::IS_FINAL : 0; $modifiers += $node->isReadonly() ? ReflectionClassAdapter::IS_READONLY_COMPATIBILITY : 0; return $modifiers; } /** * Is this reflection a trait? */ public function isTrait() : bool { return $this->isTrait; } /** * Is this reflection an interface? */ public function isInterface() : bool { return $this->isInterface; } /** * Get the traits used, if any are defined. If this class does not have any * defined traits, this will return an empty array. * * @return list<ReflectionClass> */ public function getTraits() : array { if ($this->cachedTraits !== null) { return $this->cachedTraits; } $traits = []; foreach ($this->traitClassNames as $traitClassName) { try { $traits[] = $this->reflector->reflectClass($traitClassName); } catch (IdentifierNotFound $exception) { // pass } } return $this->cachedTraits = $traits; } /** * @param array<class-string, self> $interfaces * * @return array<class-string, self> */ private function addStringableInterface(array $interfaces) : array { if (BetterReflection::$phpVersion < 80000) { return $interfaces; } /** @psalm-var class-string $stringableClassName */ $stringableClassName = Stringable::class; if (array_key_exists($stringableClassName, $interfaces) || $this->isInterface && $this->getName() === $stringableClassName) { return $interfaces; } foreach (array_keys($this->immediateMethods) as $immediateMethodName) { if (strtolower($immediateMethodName) === '__tostring') { try { $stringableInterfaceReflection = $this->reflector->reflectClass($stringableClassName); $interfaces[$stringableClassName] = $stringableInterfaceReflection; } catch (IdentifierNotFound $exception) { // Stringable interface does not exist on target PHP version } // @infection-ignore-all Break_: There's no difference between break and continue - break is just optimization break; } } return $interfaces; } /** * @param array<class-string, self> $interfaces * * @return array<class-string, self> * * @psalm-suppress MoreSpecificReturnType */ private function addEnumInterfaces(array $interfaces) : array { assert($this->isEnum === \true); $interfaces[UnitEnum::class] = $this->reflector->reflectClass(UnitEnum::class); if ($this->isBackedEnum) { $interfaces[BackedEnum::class] = $this->reflector->reflectClass(BackedEnum::class); } /** @psalm-suppress LessSpecificReturnStatement */ return $interfaces; } /** @return list<trait-string> */ public function getTraitClassNames() : array { return $this->traitClassNames; } /** * Get the names of the traits used as an array of strings, if any are * defined. If this class does not have any defined traits, this will * return an empty array. * * @return list<trait-string> */ public function getTraitNames() : array { return array_map(static function (\PHPStan\BetterReflection\Reflection\ReflectionClass $trait) : string { /** @psalm-var trait-string $traitName */ $traitName = $trait->getName(); return $traitName; }, $this->getTraits()); } /** * Return a list of the aliases used when importing traits for this class. * The returned array is in key/value pair in this format:. * * 'aliasedMethodName' => 'ActualClass::actualMethod' * * @return array<non-empty-string, non-empty-string> * * @example * // When reflecting a class such as: * class Foo * { * use MyTrait { * myTraitMethod as myAliasedMethod; * } * } * // This method would return * // ['myAliasedMethod' => 'MyTrait::myTraitMethod'] */ public function getTraitAliases() : array { return $this->traitsData['aliases']; } /** * Returns data when importing traits for this class: * * 'aliases': List of the aliases used when importing traits. In format: * * 'aliasedMethodName' => 'ActualClass::actualMethod' * * Example: * // When reflecting a code such as: * * use MyTrait { * myTraitMethod as myAliasedMethod; * } * * // This method would return * // ['myAliasedMethod' => 'MyTrait::myTraitMethod'] * * 'modifiers': Used modifiers when importing traits. In format: * * 'methodName' => 'modifier' * * Example: * // When reflecting a code such as: * * use MyTrait { * myTraitMethod as public; * } * * // This method would return * // ['myTraitMethod' => 1] * * 'precedences': Precedences used when importing traits. In format: * * 'Class::method' => 'Class::method' * * Example: * // When reflecting a code such as: * * use MyTrait, MyTrait2 { * MyTrait2::foo insteadof MyTrait1; * } * * // This method would return * // ['MyTrait1::foo' => 'MyTrait2::foo'] * * @return array{aliases: array<non-empty-string, non-empty-string>, modifiers: array<non-empty-string, int-mask-of<ReflectionMethodAdapter::IS_*>>, precedences: array<non-empty-string, non-empty-string>} * @param ClassNode|InterfaceNode|TraitNode|EnumNode $node */ private function computeTraitsData($node) : array { $traitsData = ['aliases' => [], 'modifiers' => [], 'precedences' => []]; foreach ($node->getTraitUses() as $traitUsage) { $traitNames = $traitUsage->traits; $adaptations = $traitUsage->adaptations; foreach ($adaptations as $adaptation) { $usedTrait = $adaptation->trait; if ($usedTrait === null) { $usedTrait = end($traitNames); } $methodHash = $this->methodHash($usedTrait->toString(), $adaptation->method->toString()); if ($adaptation instanceof Node\Stmt\TraitUseAdaptation\Alias) { if ($adaptation->newModifier !== null) { /** @var int-mask-of<ReflectionMethodAdapter::IS_*> $modifier */ $modifier = $adaptation->newModifier; $traitsData['modifiers'][$methodHash] = $modifier; } if ($adaptation->newName) { $adaptationName = $adaptation->newName->name; assert($adaptationName !== ''); $traitsData['aliases'][$adaptationName] = $methodHash; continue; } } if (!$adaptation instanceof Node\Stmt\TraitUseAdaptation\Precedence || !$adaptation->insteadof) { continue; } foreach ($adaptation->insteadof as $insteadof) { $adaptationNameHash = $this->methodHash($insteadof->toString(), $adaptation->method->toString()); $traitsData['precedences'][$adaptationNameHash] = $methodHash; } } } return $traitsData; } /** * @return non-empty-string * * @psalm-pure */ private function methodHash(string $className, string $methodName) : string { return sprintf('%s::%s', $className, strtolower($methodName)); } /** @return list<class-string> */ public function getInterfaceClassNames() : array { return $this->implementsClassNames; } /** * Gets the interfaces. * * @link https://php.net/manual/en/reflectionclass.getinterfaces.php * * @return array<class-string, self> An associative array of interfaces, with keys as interface names and the array * values as {@see ReflectionClass} objects. */ public function getInterfaces() : array { if ($this->cachedInterfaces !== null) { return $this->cachedInterfaces; } $interfaces = array_merge([$this->getCurrentClassImplementedInterfacesIndexedByName()], array_map(static function (self $parentClass) : array { return $parentClass->getCurrentClassImplementedInterfacesIndexedByName(); }, $this->getParentClasses())); return $this->cachedInterfaces = array_merge(...array_reverse($interfaces)); } /** * Get only the interfaces that this class implements (i.e. do not search * up parent classes etc.) * * @return array<class-string, self> */ public function getImmediateInterfaces() : array { if ($this->isTrait) { return []; } $interfaces = []; foreach ($this->implementsClassNames as $interfaceClassName) { try { $interfaces[$interfaceClassName] = $this->reflector->reflectClass($interfaceClassName); } catch (IdentifierNotFound $exception) { continue; } } if ($this->isEnum) { $interfaces = $this->addEnumInterfaces($interfaces); } return $this->addStringableInterface($interfaces); } /** * Gets the interface names. * * @link https://php.net/manual/en/reflectionclass.getinterfacenames.php * * @return list<class-string> A numerical array with interface names as the values. */ public function getInterfaceNames() : array { if ($this->cachedInterfaceNames !== null) { return $this->cachedInterfaceNames; } return $this->cachedInterfaceNames = array_values(array_map(static function (self $interface) : string { return $interface->getName(); }, $this->getInterfaces())); } /** * Checks whether the given object is an instance. * * @link https://php.net/manual/en/reflectionclass.isinstance.php */ public function isInstance(object $object) : bool { $className = $this->getName(); // note: since $object was loaded, we can safely assume that $className is available in the current // php script execution context return $object instanceof $className; } /** * Checks whether the given class string is a subclass of this class. * * @link https://php.net/manual/en/reflectionclass.isinstance.php */ public function isSubclassOf(string $className) : bool { return in_array(ltrim($className, '\\'), $this->getParentClassNames(), \true); } /** * Checks whether this class implements the given interface. * * @link https://php.net/manual/en/reflectionclass.implementsinterface.php */ public function implementsInterface(string $interfaceName) : bool { return in_array(ltrim($interfaceName, '\\'), $this->getInterfaceNames(), \true); } /** * Checks whether this reflection is an instantiable class * * @link https://php.net/manual/en/reflectionclass.isinstantiable.php */ public function isInstantiable() : bool { // @TODO doesn't consider internal non-instantiable classes yet. if ($this->isAbstract()) { return \false; } if ($this->isInterface()) { return \false; } if ($this->isTrait()) { return \false; } $constructor = $this->getConstructor(); if ($constructor === null) { return \true; } return $constructor->isPublic(); } /** * Checks whether this is a reflection of a class that supports the clone operator * * @link https://php.net/manual/en/reflectionclass.iscloneable.php */ public function isCloneable() : bool { if (!$this->isInstantiable()) { return \false; } $cloneMethod = $this->getMethod('__clone'); if ($cloneMethod === null) { return \true; } return $cloneMethod->isPublic(); } /** * Checks if iterateable * * @link https://php.net/manual/en/reflectionclass.isiterateable.php */ public function isIterateable() : bool { return $this->isInstantiable() && $this->implementsInterface(Traversable::class); } public function isEnum() : bool { return $this->isEnum; } /** @return array<class-string, ReflectionClass> */ private function getCurrentClassImplementedInterfacesIndexedByName() : array { if ($this->isTrait) { return []; } if ($this->isInterface) { // assumption: first key is the current interface return array_slice($this->getInterfacesHierarchy(AlreadyVisitedClasses::createEmpty()), 1); } $interfaces = []; foreach ($this->implementsClassNames as $name) { try { $interface = $this->reflector->reflectClass($name); foreach ($interface->getInterfacesHierarchy(AlreadyVisitedClasses::createEmpty()) as $n => $i) { $interfaces[$n] = $i; } } catch (IdentifierNotFound $exception) { continue; } } if ($this->isEnum) { $interfaces = $this->addEnumInterfaces($interfaces); } return $this->addStringableInterface($interfaces); } /** * This method allows us to retrieve all interfaces parent of this interface. Do not use on class nodes! * * @return array<class-string, ReflectionClass> parent interfaces of this interface */ private function getInterfacesHierarchy(AlreadyVisitedClasses $alreadyVisitedClasses) : array { if (!$this->isInterface) { return []; } $interfaceClassName = $this->getName(); $alreadyVisitedClasses->push($interfaceClassName); /** @var array<class-string, self> $interfaces */ $interfaces = [$interfaceClassName => $this]; foreach ($this->getImmediateInterfaces() as $interface) { $alreadyVisitedClassesCopyForInterface = clone $alreadyVisitedClasses; foreach ($interface->getInterfacesHierarchy($alreadyVisitedClassesCopyForInterface) as $extendedInterfaceName => $extendedInterface) { $interfaces[$extendedInterfaceName] = $extendedInterface; } } return $this->addStringableInterface($interfaces); } /** * Get the value of a static property, if it exists. Throws a * PropertyDoesNotExist exception if it does not exist or is not static. * (note, differs very slightly from internal reflection behaviour) * * @param non-empty-string $propertyName * * @throws ClassDoesNotExist * @throws NoObjectProvided * @throws NotAnObject * @throws ObjectNotInstanceOfClass * @return mixed */ public function getStaticPropertyValue(string $propertyName) { $property = $this->getProperty($propertyName); if (!$property || !$property->isStatic()) { throw PropertyDoesNotExist::fromName($propertyName); } return $property->getValue(); } /** * Set the value of a static property * * @param non-empty-string $propertyName * * @throws ClassDoesNotExist * @throws NoObjectProvided * @throws NotAnObject * @throws ObjectNotInstanceOfClass * @param mixed $value */ public function setStaticPropertyValue(string $propertyName, $value) : void { $property = $this->getProperty($propertyName); if (!$property || !$property->isStatic()) { throw PropertyDoesNotExist::fromName($propertyName); } $property->setValue($value); } /** @return array<non-empty-string, mixed> */ public function getStaticProperties() : array { $staticProperties = []; foreach ($this->getProperties() as $property) { if (!$property->isStatic()) { continue; } /** @psalm-suppress MixedAssignment */ $staticProperties[$property->getName()] = $property->getValue(); } return $staticProperties; } /** @return list<ReflectionAttribute> */ public function getAttributes() : array { return $this->attributes; } /** @return list<ReflectionAttribute> */ public function getAttributesByName(string $name) : array { return ReflectionAttributeHelper::filterAttributesByName($this->getAttributes(), $name); } /** * @param class-string $className * * @return list<ReflectionAttribute> */ public function getAttributesByInstance(string $className) : array { return ReflectionAttributeHelper::filterAttributesByInstance($this->getAttributes(), $className); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection; use PhpParser\Node; use PhpParser\Node\Stmt\ClassConst; use ReflectionClassConstant as CoreReflectionClassConstant; use PHPStan\BetterReflection\BetterReflection; use PHPStan\BetterReflection\NodeCompiler\CompiledValue; use PHPStan\BetterReflection\NodeCompiler\CompileNodeToValue; use PHPStan\BetterReflection\NodeCompiler\CompilerContext; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionClassConstant as ReflectionClassConstantAdapter; use PHPStan\BetterReflection\Reflection\Annotation\AnnotationHelper; use PHPStan\BetterReflection\Reflection\Attribute\ReflectionAttributeHelper; use PHPStan\BetterReflection\Reflection\StringCast\ReflectionClassConstantStringCast; use PHPStan\BetterReflection\Reflector\Reflector; use PHPStan\BetterReflection\Util\CalculateReflectionColumn; use PHPStan\BetterReflection\Util\GetLastDocComment; use function array_map; use function assert; /** @psalm-immutable */ class ReflectionClassConstant { /** @var non-empty-string */ private $name; /** @var int-mask-of<ReflectionClassConstantAdapter::IS_*> */ private $modifiers; /** * @var \PHPStan\BetterReflection\Reflection\ReflectionNamedType|\PHPStan\BetterReflection\Reflection\ReflectionUnionType|\PHPStan\BetterReflection\Reflection\ReflectionIntersectionType|null */ private $type; /** * @var \PhpParser\Node\Expr */ private $value; /** @var non-empty-string|null */ private $docComment; /** @var list<ReflectionAttribute> */ private $attributes; /** @var positive-int */ private $startLine; /** @var positive-int */ private $endLine; /** @var positive-int */ private $startColumn; /** @var positive-int */ private $endColumn; /** @psalm-allow-private-mutation * @var \PHPStan\BetterReflection\NodeCompiler\CompiledValue|null */ private $compiledValue = null; /** * @var \PHPStan\BetterReflection\Reflector\Reflector */ private $reflector; /** * @var \PHPStan\BetterReflection\Reflection\ReflectionClass */ private $declaringClass; /** * @var \PHPStan\BetterReflection\Reflection\ReflectionClass */ private $implementingClass; private function __construct(Reflector $reflector, ClassConst $node, int $positionInNode, \PHPStan\BetterReflection\Reflection\ReflectionClass $declaringClass, \PHPStan\BetterReflection\Reflection\ReflectionClass $implementingClass) { $this->reflector = $reflector; $this->declaringClass = $declaringClass; $this->implementingClass = $implementingClass; $name = $node->consts[$positionInNode]->name->name; assert($name !== ''); $this->name = $name; $this->modifiers = $this->computeModifiers($node); $this->type = $this->createType($node); $this->value = $node->consts[$positionInNode]->value; $this->docComment = GetLastDocComment::forNode($node); $this->attributes = ReflectionAttributeHelper::createAttributes($reflector, $this, $node->attrGroups); $startLine = $node->getStartLine(); assert($startLine > 0); $endLine = $node->getEndLine(); assert($endLine > 0); $this->startLine = $startLine; $this->endLine = $endLine; $this->startColumn = CalculateReflectionColumn::getStartColumn($declaringClass->getLocatedSource()->getSource(), $node); $this->endColumn = CalculateReflectionColumn::getEndColumn($declaringClass->getLocatedSource()->getSource(), $node); } /** * Create a reflection of a class's constant by Const Node * * @internal */ public static function createFromNode(Reflector $reflector, ClassConst $node, int $positionInNode, \PHPStan\BetterReflection\Reflection\ReflectionClass $declaringClass, \PHPStan\BetterReflection\Reflection\ReflectionClass $implementingClass) : self { return new self($reflector, $node, $positionInNode, $declaringClass, $implementingClass); } /** @internal */ public function withImplementingClass(\PHPStan\BetterReflection\Reflection\ReflectionClass $implementingClass) : self { $clone = clone $this; $clone->implementingClass = $implementingClass; $clone->attributes = array_map(static function (\PHPStan\BetterReflection\Reflection\ReflectionAttribute $attribute) use($clone) : \PHPStan\BetterReflection\Reflection\ReflectionAttribute { return $attribute->withOwner($clone); }, $this->attributes); $this->compiledValue = null; return $clone; } /** * Get the name of the reflection (e.g. if this is a ReflectionClass this * will be the class name). * * @return non-empty-string */ public function getName() : string { return $this->name; } /** * @return \PHPStan\BetterReflection\Reflection\ReflectionNamedType|\PHPStan\BetterReflection\Reflection\ReflectionUnionType|\PHPStan\BetterReflection\Reflection\ReflectionIntersectionType|null */ private function createType(ClassConst $node) { $type = $node->type; if ($type === null) { return null; } assert($type instanceof Node\Identifier || $type instanceof Node\Name || $type instanceof Node\NullableType || $type instanceof Node\UnionType || $type instanceof Node\IntersectionType); return \PHPStan\BetterReflection\Reflection\ReflectionType::createFromNode($this->reflector, $this, $type); } /** * @return \PHPStan\BetterReflection\Reflection\ReflectionNamedType|\PHPStan\BetterReflection\Reflection\ReflectionUnionType|\PHPStan\BetterReflection\Reflection\ReflectionIntersectionType|null */ public function getType() { return $this->type; } public function hasType() : bool { return $this->type !== null; } /** * @deprecated Use getValueExpression */ public function getValueExpr() : Node\Expr { return $this->getValueExpression(); } public function getValueExpression() : Node\Expr { return $this->value; } /** * Returns constant value * * @deprecated Use getValueExpression() * @return mixed */ public function getValue() { if ($this->compiledValue === null) { $this->compiledValue = (new CompileNodeToValue())->__invoke($this->value, new CompilerContext($this->reflector, $this)); } return $this->compiledValue->value; } /** * Constant is public */ public function isPublic() : bool { return ($this->modifiers & ReflectionClassConstantAdapter::IS_PUBLIC_COMPATIBILITY) === ReflectionClassConstantAdapter::IS_PUBLIC_COMPATIBILITY; } /** * Constant is private */ public function isPrivate() : bool { // Private constant cannot be final return $this->modifiers === ReflectionClassConstantAdapter::IS_PRIVATE_COMPATIBILITY; } /** * Constant is protected */ public function isProtected() : bool { return ($this->modifiers & ReflectionClassConstantAdapter::IS_PROTECTED_COMPATIBILITY) === ReflectionClassConstantAdapter::IS_PROTECTED_COMPATIBILITY; } public function isFinal() : bool { $final = ($this->modifiers & ReflectionClassConstantAdapter::IS_FINAL_COMPATIBILITY) === ReflectionClassConstantAdapter::IS_FINAL_COMPATIBILITY; if ($final) { return \true; } if (BetterReflection::$phpVersion >= 80100) { return \false; } return $this->getDeclaringClass()->isInterface(); } /** * Returns a bitfield of the access modifiers for this constant * * @return int-mask-of<ReflectionClassConstantAdapter::IS_*> */ public function getModifiers() : int { return $this->modifiers; } /** * Get the line number that this constant starts on. * * @return positive-int */ public function getStartLine() : int { return $this->startLine; } /** * Get the line number that this constant ends on. * * @return positive-int */ public function getEndLine() : int { return $this->endLine; } /** @return positive-int */ public function getStartColumn() : int { return $this->startColumn; } /** @return positive-int */ public function getEndColumn() : int { return $this->endColumn; } /** * Get the declaring class */ public function getDeclaringClass() : \PHPStan\BetterReflection\Reflection\ReflectionClass { return $this->declaringClass; } /** * Get the class that implemented the method based on trait use. */ public function getImplementingClass() : \PHPStan\BetterReflection\Reflection\ReflectionClass { return $this->implementingClass; } /** @return non-empty-string|null */ public function getDocComment() : ?string { return $this->docComment; } public function isDeprecated() : bool { return AnnotationHelper::isDeprecated($this->getDocComment()); } /** @return non-empty-string */ public function __toString() : string { return ReflectionClassConstantStringCast::toString($this); } /** @return list<ReflectionAttribute> */ public function getAttributes() : array { return $this->attributes; } /** @return list<ReflectionAttribute> */ public function getAttributesByName(string $name) : array { return ReflectionAttributeHelper::filterAttributesByName($this->getAttributes(), $name); } /** * @param class-string $className * * @return list<ReflectionAttribute> */ public function getAttributesByInstance(string $className) : array { return ReflectionAttributeHelper::filterAttributesByInstance($this->getAttributes(), $className); } /** @return int-mask-of<ReflectionClassConstantAdapter::IS_*> */ private function computeModifiers(ClassConst $node) : int { $modifiers = $node->isFinal() ? ReflectionClassConstantAdapter::IS_FINAL_COMPATIBILITY : 0; $modifiers += $node->isPrivate() ? ReflectionClassConstantAdapter::IS_PRIVATE_COMPATIBILITY : 0; $modifiers += $node->isProtected() ? ReflectionClassConstantAdapter::IS_PROTECTED_COMPATIBILITY : 0; $modifiers += $node->isPublic() ? ReflectionClassConstantAdapter::IS_PUBLIC_COMPATIBILITY : 0; return $modifiers; } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection; use Closure; use OutOfBoundsException; use PhpParser\Node; use PhpParser\Node\Stmt\ClassMethod as MethodNode; use ReflectionException; use ReflectionMethod as CoreReflectionMethod; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionMethod as ReflectionMethodAdapter; use PHPStan\BetterReflection\Reflection\Exception\ClassDoesNotExist; use PHPStan\BetterReflection\Reflection\Exception\NoObjectProvided; use PHPStan\BetterReflection\Reflection\Exception\ObjectNotInstanceOfClass; use PHPStan\BetterReflection\Reflection\StringCast\ReflectionMethodStringCast; use PHPStan\BetterReflection\Reflector\Exception\IdentifierNotFound; use PHPStan\BetterReflection\Reflector\Reflector; use PHPStan\BetterReflection\SourceLocator\Located\LocatedSource; use PHPStan\BetterReflection\Util\ClassExistenceChecker; use function array_map; use function assert; use function sprintf; use function strtolower; /** @psalm-immutable */ class ReflectionMethod { use \PHPStan\BetterReflection\Reflection\ReflectionFunctionAbstract; /** @var int-mask-of<ReflectionMethodAdapter::IS_*> */ private $modifiers; /** * @var \PHPStan\BetterReflection\Reflector\Reflector */ private $reflector; /** * @var \PHPStan\BetterReflection\SourceLocator\Located\LocatedSource */ private $locatedSource; /** * @var non-empty-string|null */ private $namespace; /** * @var \PHPStan\BetterReflection\Reflection\ReflectionClass */ private $declaringClass; /** * @var \PHPStan\BetterReflection\Reflection\ReflectionClass */ private $implementingClass; /** * @var \PHPStan\BetterReflection\Reflection\ReflectionClass */ private $currentClass; /** * @var non-empty-string|null */ private $aliasName; /** * @param non-empty-string|null $aliasName * @param non-empty-string|null $namespace * @param MethodNode|\PhpParser\Node\Stmt\Function_|\PhpParser\Node\Expr\Closure|\PhpParser\Node\Expr\ArrowFunction $node */ private function __construct(Reflector $reflector, $node, LocatedSource $locatedSource, ?string $namespace, \PHPStan\BetterReflection\Reflection\ReflectionClass $declaringClass, \PHPStan\BetterReflection\Reflection\ReflectionClass $implementingClass, \PHPStan\BetterReflection\Reflection\ReflectionClass $currentClass, ?string $aliasName) { $this->reflector = $reflector; $this->locatedSource = $locatedSource; $this->namespace = $namespace; $this->declaringClass = $declaringClass; $this->implementingClass = $implementingClass; $this->currentClass = $currentClass; $this->aliasName = $aliasName; assert($node instanceof MethodNode); $name = $node->name->name; assert($name !== ''); $this->name = $name; $this->modifiers = $this->computeModifiers($node); $this->fillFromNode($node); } /** * @internal * * @param non-empty-string|null $aliasName * @param non-empty-string|null $namespace */ public static function createFromNode(Reflector $reflector, MethodNode $node, LocatedSource $locatedSource, ?string $namespace, \PHPStan\BetterReflection\Reflection\ReflectionClass $declaringClass, \PHPStan\BetterReflection\Reflection\ReflectionClass $implementingClass, \PHPStan\BetterReflection\Reflection\ReflectionClass $currentClass, ?string $aliasName = null) : self { return new self($reflector, $node, $locatedSource, $namespace, $declaringClass, $implementingClass, $currentClass, $aliasName); } /** * Create a reflection of a method by it's name using a named class * * @param non-empty-string $methodName * * @throws IdentifierNotFound * @throws OutOfBoundsException */ public static function createFromName(string $className, string $methodName) : self { $method = \PHPStan\BetterReflection\Reflection\ReflectionClass::createFromName($className)->getMethod($methodName); if ($method === null) { throw new OutOfBoundsException(sprintf('Could not find method: %s', $methodName)); } return $method; } /** * Create a reflection of a method by it's name using an instance * * @param non-empty-string $methodName * * @throws ReflectionException * @throws IdentifierNotFound * @throws OutOfBoundsException */ public static function createFromInstance(object $instance, string $methodName) : self { $method = \PHPStan\BetterReflection\Reflection\ReflectionClass::createFromInstance($instance)->getMethod($methodName); if ($method === null) { throw new OutOfBoundsException(sprintf('Could not find method: %s', $methodName)); } return $method; } /** * @internal * * @param non-empty-string|null $aliasName * @param int-mask-of<ReflectionMethodAdapter::IS_*> $modifiers */ public function withImplementingClass(\PHPStan\BetterReflection\Reflection\ReflectionClass $implementingClass, ?string $aliasName, int $modifiers) : self { $clone = clone $this; $clone->aliasName = $aliasName; $clone->modifiers = $modifiers; $clone->implementingClass = $implementingClass; $clone->currentClass = $implementingClass; if ($clone->returnType !== null) { $clone->returnType = $clone->returnType->withOwner($clone); } $clone->parameters = array_map(static function (\PHPStan\BetterReflection\Reflection\ReflectionParameter $parameter) use($clone) : \PHPStan\BetterReflection\Reflection\ReflectionParameter { return $parameter->withFunction($clone); }, $this->parameters); $clone->attributes = array_map(static function (\PHPStan\BetterReflection\Reflection\ReflectionAttribute $attribute) use($clone) : \PHPStan\BetterReflection\Reflection\ReflectionAttribute { return $attribute->withOwner($clone); }, $this->attributes); return $clone; } /** @internal */ public function withCurrentClass(\PHPStan\BetterReflection\Reflection\ReflectionClass $currentClass) : self { $clone = clone $this; $clone->currentClass = $currentClass; if ($clone->returnType !== null) { $clone->returnType = $clone->returnType->withOwner($clone); } // We don't need to clone parameters and attributes return $clone; } /** @return non-empty-string */ public function getShortName() : string { if ($this->aliasName !== null) { return $this->aliasName; } return $this->name; } /** @return non-empty-string|null */ public function getAliasName() : ?string { return $this->aliasName; } /** * Find the prototype for this method, if it exists. If it does not exist * it will throw a MethodPrototypeNotFound exception. * * @throws Exception\MethodPrototypeNotFound */ public function getPrototype() : self { $currentClass = $this->getImplementingClass(); foreach ($currentClass->getImmediateInterfaces() as $interface) { $interfaceMethod = $interface->getMethod($this->getName()); if ($interfaceMethod !== null) { return $interfaceMethod; } } $currentClass = $currentClass->getParentClass(); if ($currentClass !== null) { $prototype = ($getMethod = $currentClass->getMethod($this->getName())) ? $getMethod->findPrototype() : null; if ($prototype !== null && (!$this->isConstructor() || $prototype->isAbstract())) { return $prototype; } } throw new \PHPStan\BetterReflection\Reflection\Exception\MethodPrototypeNotFound(sprintf('Method %s::%s does not have a prototype', $this->getDeclaringClass()->getName(), $this->getName())); } private function findPrototype() : ?self { if ($this->isAbstract()) { return $this; } if ($this->isPrivate()) { return null; } try { return $this->getPrototype(); } catch (\PHPStan\BetterReflection\Reflection\Exception\MethodPrototypeNotFound $exception) { return $this; } } /** * Get the core-reflection-compatible modifier values. * * @return int-mask-of<ReflectionMethodAdapter::IS_*> */ public function getModifiers() : int { return $this->modifiers; } /** @return int-mask-of<ReflectionMethodAdapter::IS_*> */ private function computeModifiers(MethodNode $node) : int { $modifiers = $node->isStatic() ? CoreReflectionMethod::IS_STATIC : 0; $modifiers += $node->isPublic() ? CoreReflectionMethod::IS_PUBLIC : 0; $modifiers += $node->isProtected() ? CoreReflectionMethod::IS_PROTECTED : 0; $modifiers += $node->isPrivate() ? CoreReflectionMethod::IS_PRIVATE : 0; $modifiers += $node->isAbstract() ? CoreReflectionMethod::IS_ABSTRACT : 0; $modifiers += $node->isFinal() ? CoreReflectionMethod::IS_FINAL : 0; return $modifiers; } /** @return non-empty-string */ public function __toString() : string { return ReflectionMethodStringCast::toString($this); } public function inNamespace() : bool { return \false; } public function getNamespaceName() : ?string { return null; } public function isClosure() : bool { return \false; } /** * Is the method abstract. */ public function isAbstract() : bool { return ($this->modifiers & CoreReflectionMethod::IS_ABSTRACT) === CoreReflectionMethod::IS_ABSTRACT || $this->declaringClass->isInterface(); } /** * Is the method final. */ public function isFinal() : bool { return ($this->modifiers & CoreReflectionMethod::IS_FINAL) === CoreReflectionMethod::IS_FINAL; } /** * Is the method private visibility. */ public function isPrivate() : bool { return ($this->modifiers & CoreReflectionMethod::IS_PRIVATE) === CoreReflectionMethod::IS_PRIVATE; } /** * Is the method protected visibility. */ public function isProtected() : bool { return ($this->modifiers & CoreReflectionMethod::IS_PROTECTED) === CoreReflectionMethod::IS_PROTECTED; } /** * Is the method public visibility. */ public function isPublic() : bool { return ($this->modifiers & CoreReflectionMethod::IS_PUBLIC) === CoreReflectionMethod::IS_PUBLIC; } /** * Is the method static. */ public function isStatic() : bool { return ($this->modifiers & CoreReflectionMethod::IS_STATIC) === CoreReflectionMethod::IS_STATIC; } /** * Is the method a constructor. */ public function isConstructor() : bool { if (strtolower($this->getName()) === '__construct') { return \true; } $declaringClass = $this->getDeclaringClass(); if ($declaringClass->inNamespace()) { return \false; } return strtolower($this->getName()) === strtolower($declaringClass->getShortName()); } /** * Is the method a destructor. */ public function isDestructor() : bool { return strtolower($this->getName()) === '__destruct'; } /** * Get the class that declares this method. */ public function getDeclaringClass() : \PHPStan\BetterReflection\Reflection\ReflectionClass { return $this->declaringClass; } /** * Get the class that implemented the method based on trait use. */ public function getImplementingClass() : \PHPStan\BetterReflection\Reflection\ReflectionClass { return $this->implementingClass; } /** * Get the current reflected class. * * @internal */ public function getCurrentClass() : \PHPStan\BetterReflection\Reflection\ReflectionClass { return $this->currentClass; } /** * @throws ClassDoesNotExist * @throws NoObjectProvided * @throws ObjectNotInstanceOfClass */ public function getClosure($object = null) : Closure { $declaringClassName = $this->getDeclaringClass()->getName(); if ($this->isStatic()) { $this->assertClassExist($declaringClassName); return function (...$args) { return $this->callStaticMethod($args); }; } $instance = $this->assertObject($object); return function (...$args) use($instance) { return $this->callObjectMethod($instance, $args); }; } /** * @throws ClassDoesNotExist * @throws NoObjectProvided * @throws ObjectNotInstanceOfClass * @param mixed ...$args * @return mixed */ public function invoke($object = null, ...$args) { return $this->invokeArgs($object, $args); } /** * @param array<mixed> $args * * @throws ClassDoesNotExist * @throws NoObjectProvided * @throws ObjectNotInstanceOfClass * @return mixed */ public function invokeArgs($object = null, array $args = []) { $implementingClassName = $this->getImplementingClass()->getName(); if ($this->isStatic()) { $this->assertClassExist($implementingClassName); return $this->callStaticMethod($args); } return $this->callObjectMethod($this->assertObject($object), $args); } /** @param array<mixed> $args * @return mixed */ private function callStaticMethod(array $args) { $implementingClassName = $this->getImplementingClass()->getName(); /** @psalm-suppress InvalidStringClass */ $closure = Closure::bind(function (string $implementingClassName, string $_methodName, array $methodArgs) { return $implementingClassName::$_methodName(...$methodArgs); }, null, $implementingClassName); assert($closure instanceof Closure); return $closure->__invoke($implementingClassName, $this->getName(), $args); } /** @param array<mixed> $args * @return mixed */ private function callObjectMethod(object $object, array $args) { /** @psalm-suppress MixedMethodCall */ $closure = Closure::bind(function (object $object, string $methodName, array $methodArgs) { return $object->{$methodName}(...$methodArgs); }, $object, $this->getImplementingClass()->getName()); assert($closure instanceof Closure); return $closure->__invoke($object, $this->getName(), $args); } /** @throws ClassDoesNotExist */ private function assertClassExist(string $className) : void { if (!ClassExistenceChecker::classExists($className, \true) && !ClassExistenceChecker::traitExists($className, \true)) { throw new ClassDoesNotExist(sprintf('Method of class %s cannot be used as the class does not exist', $className)); } } /** * @throws NoObjectProvided * @throws ObjectNotInstanceOfClass */ private function assertObject($object) : object { if ($object === null) { throw NoObjectProvided::create(); } $implementingClassName = $this->getImplementingClass()->getName(); if (\get_class($object) !== $implementingClassName) { throw ObjectNotInstanceOfClass::fromClassName($implementingClassName); } return $object; } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection; use Closure; use PhpParser\Node; use PHPStan\BetterReflection\BetterReflection; use PHPStan\BetterReflection\Reflection\Adapter\Exception\NotImplemented; use PHPStan\BetterReflection\Reflection\Exception\FunctionDoesNotExist; use PHPStan\BetterReflection\Reflection\StringCast\ReflectionFunctionStringCast; use PHPStan\BetterReflection\Reflector\DefaultReflector; use PHPStan\BetterReflection\Reflector\Exception\IdentifierNotFound; use PHPStan\BetterReflection\Reflector\Reflector; use PHPStan\BetterReflection\SourceLocator\Located\LocatedSource; use PHPStan\BetterReflection\SourceLocator\Type\AggregateSourceLocator; use PHPStan\BetterReflection\SourceLocator\Type\ClosureSourceLocator; use function assert; use function function_exists; /** @psalm-immutable */ class ReflectionFunction implements \PHPStan\BetterReflection\Reflection\Reflection { use \PHPStan\BetterReflection\Reflection\ReflectionFunctionAbstract; public const CLOSURE_NAME = '{closure}'; /** * @var bool */ private $isStatic; /** * @var \PHPStan\BetterReflection\Reflector\Reflector */ private $reflector; /** * @var \PHPStan\BetterReflection\SourceLocator\Located\LocatedSource */ private $locatedSource; /** * @var non-empty-string|null */ private $namespace = null; /** @param non-empty-string|null $namespace * @param \PhpParser\Node\Stmt\ClassMethod|\PhpParser\Node\Stmt\Function_|\PhpParser\Node\Expr\Closure|\PhpParser\Node\Expr\ArrowFunction $node */ private function __construct(Reflector $reflector, $node, LocatedSource $locatedSource, ?string $namespace = null) { $this->reflector = $reflector; $this->locatedSource = $locatedSource; $this->namespace = $namespace; assert($node instanceof Node\Stmt\Function_ || $node instanceof Node\Expr\Closure || $node instanceof Node\Expr\ArrowFunction); $name = $node instanceof Node\Expr\Closure || $node instanceof Node\Expr\ArrowFunction ? self::CLOSURE_NAME : $node->name->name; assert($name !== ''); $this->name = $name; $this->fillFromNode($node); $isClosure = $node instanceof Node\Expr\Closure || $node instanceof Node\Expr\ArrowFunction; $this->isStatic = $isClosure && $node->static; $this->isClosure = $isClosure; $this->isGenerator = $this->nodeIsOrContainsYield($node); } /** * @deprecated Use Reflector instead. * * @throws IdentifierNotFound */ public static function createFromName(string $functionName) : self { return (new BetterReflection())->reflector()->reflectFunction($functionName); } /** @throws IdentifierNotFound */ public static function createFromClosure(Closure $closure) : self { $configuration = new BetterReflection(); return (new DefaultReflector(new AggregateSourceLocator([$configuration->sourceLocator(), new ClosureSourceLocator($closure, $configuration->phpParser())])))->reflectFunction(self::CLOSURE_NAME); } /** @return non-empty-string */ public function __toString() : string { return ReflectionFunctionStringCast::toString($this); } /** * @internal * * @param non-empty-string|null $namespace * @param \PhpParser\Node\Stmt\Function_|\PhpParser\Node\Expr\Closure|\PhpParser\Node\Expr\ArrowFunction $node */ public static function createFromNode(Reflector $reflector, $node, LocatedSource $locatedSource, ?string $namespace = null) : self { return new self($reflector, $node, $locatedSource, $namespace); } /** * Get the "short" name of the function (e.g. for A\B\foo, this will return * "foo"). * * @return non-empty-string */ public function getShortName() : string { return $this->name; } /** * Check to see if this function has been disabled (by the PHP INI file * directive `disable_functions`). * * Note - we cannot reflect on internal functions (as there is no PHP source * code we can access. This means, at present, we can only EVER return false * from this function, because you cannot disable user-defined functions. * * @see https://php.net/manual/en/ini.core.php#ini.disable-functions * * @todo https://github.com/Roave/BetterReflection/issues/14 */ public function isDisabled() : bool { return \false; } public function isStatic() : bool { return $this->isStatic; } /** * @throws NotImplemented * @throws FunctionDoesNotExist */ public function getClosure() : Closure { $this->assertIsNoClosure(); $functionName = $this->getName(); $this->assertFunctionExist($functionName); return static function (...$args) use($functionName) { return $functionName(...$args); }; } /** * @throws NotImplemented * @throws FunctionDoesNotExist * @param mixed ...$args * @return mixed */ public function invoke(...$args) { return $this->invokeArgs($args); } /** * @param array<mixed> $args * * @throws NotImplemented * @throws FunctionDoesNotExist * @return mixed */ public function invokeArgs(array $args = []) { $this->assertIsNoClosure(); $functionName = $this->getName(); $this->assertFunctionExist($functionName); return $functionName(...$args); } /** @throws NotImplemented */ private function assertIsNoClosure() : void { if ($this->isClosure()) { throw new NotImplemented('Not implemented for closures'); } } /** @throws FunctionDoesNotExist */ private function assertFunctionExist(string $functionName) : void { if (!function_exists($functionName)) { throw FunctionDoesNotExist::fromName($functionName); } } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\Exception; use InvalidArgumentException; use function gettype; use function sprintf; class NotAnObject extends InvalidArgumentException { /** * @param mixed $nonObject */ public static function fromNonObject($nonObject) : self { return new self(sprintf('Provided "%s" is not an object', gettype($nonObject))); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\Exception; use UnexpectedValueException; use function sprintf; class CircularReference extends UnexpectedValueException { public static function fromClassName(string $className) : self { return new self(sprintf('Circular reference to class "%s"', $className)); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\Exception; use RuntimeException; use function sprintf; class PropertyIsNotStatic extends RuntimeException { public static function fromName(string $propertyName) : self { return new self(sprintf('Property "%s" is not static', $propertyName)); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\Exception; use ReflectionException; class MethodPrototypeNotFound extends ReflectionException { } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\Exception; use RuntimeException; use function sprintf; class PropertyDoesNotExist extends RuntimeException { public static function fromName(string $propertyName) : self { return new self(sprintf('Property "%s" does not exist', $propertyName)); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\Exception; use InvalidArgumentException; class NoObjectProvided extends InvalidArgumentException { public static function create() : self { return new self('No object provided'); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\Exception; use RuntimeException; use function sprintf; class FunctionDoesNotExist extends RuntimeException { public static function fromName(string $functionName) : self { return new self(sprintf('Function "%s" cannot be used as the function is not loaded', $functionName)); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\Exception; use RuntimeException; class CodeLocationMissing extends RuntimeException { public static function create() : self { return new self('Code location is missing'); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\Exception; use PhpParser\Node; use PHPStan\BetterReflection\BetterReflection; use RuntimeException; use function sprintf; use function substr; class InvalidConstantNode extends RuntimeException { public static function create(Node $node) : self { $printer = (new BetterReflection())->printer(); return new self(sprintf('Invalid constant node (first 50 characters: %s)', substr($printer->prettyPrint([$node]), 0, 50))); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\Exception; use InvalidArgumentException; use function sprintf; class ObjectNotInstanceOfClass extends InvalidArgumentException { public static function fromClassName(string $className) : self { return new self(sprintf('Object is not instance of class "%s"', $className)); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\Exception; use LogicException; class NoParent extends LogicException { } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\Exception; use PHPStan\BetterReflection\Reflection\Reflection; use RuntimeException; use function sprintf; class ClassDoesNotExist extends RuntimeException { public static function forDifferentReflectionType(Reflection $reflection) : self { return new self(sprintf('The reflected type "%s" is not a class', $reflection->getName())); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\Exception; use PhpParser\Node\Stmt; use PHPStan\BetterReflection\BetterReflection; use RuntimeException; use function sprintf; use function substr; class InvalidArrowFunctionBodyNode extends RuntimeException { public static function create(Stmt $node) : self { $printer = (new BetterReflection())->printer(); return new self(sprintf('Invalid arrow function body node (first 50 characters: %s)', substr($printer->prettyPrint([$node]), 0, 50))); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\Exception; use RuntimeException; class InvalidDefaultValueType extends RuntimeException { } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\StringCast; use PHPStan\BetterReflection\Reflection\ReflectionProperty; use function sprintf; /** @internal */ final class ReflectionPropertyStringCast { /** * @return non-empty-string * * @psalm-pure */ public static function toString(ReflectionProperty $propertyReflection) : string { $stateModifier = ''; if (!$propertyReflection->isStatic()) { $stateModifier = $propertyReflection->isDefault() ? ' <default>' : ' <dynamic>'; } $type = $propertyReflection->getType(); return sprintf('Property [%s %s%s%s%s $%s ]', $stateModifier, self::visibilityToString($propertyReflection), $propertyReflection->isStatic() ? ' static' : '', $propertyReflection->isReadOnly() ? ' readonly' : '', $type !== null ? sprintf(' %s', \PHPStan\BetterReflection\Reflection\StringCast\ReflectionTypeStringCast::toString($type)) : '', $propertyReflection->getName()); } /** @psalm-pure */ private static function visibilityToString(ReflectionProperty $propertyReflection) : string { if ($propertyReflection->isProtected()) { return 'protected'; } if ($propertyReflection->isPrivate()) { return 'private'; } return 'public'; } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\StringCast; use PHPStan\BetterReflection\Reflection\ReflectionFunction; use PHPStan\BetterReflection\Reflection\ReflectionParameter; use function array_reduce; use function assert; use function count; use function is_string; use function sprintf; /** @internal */ final class ReflectionFunctionStringCast { /** * @return non-empty-string * * @psalm-pure */ public static function toString(ReflectionFunction $functionReflection) : string { $parametersFormat = $functionReflection->getNumberOfParameters() > 0 || $functionReflection->hasReturnType() ? "\n\n - Parameters [%d] {%s\n }" : ''; $returnTypeFormat = $functionReflection->hasReturnType() ? "\n - Return [ %s ]" : ''; return sprintf('Function [ <%s> function %s ] {%s' . $parametersFormat . $returnTypeFormat . "\n}", self::sourceToString($functionReflection), $functionReflection->getName(), self::fileAndLinesToString($functionReflection), count($functionReflection->getParameters()), self::parametersToString($functionReflection), self::returnTypeToString($functionReflection)); } /** @psalm-pure */ private static function sourceToString(ReflectionFunction $functionReflection) : string { if ($functionReflection->isUserDefined()) { return 'user'; } $extensionName = $functionReflection->getExtensionName(); assert(is_string($extensionName)); return sprintf('internal:%s', $extensionName); } /** @psalm-pure */ private static function fileAndLinesToString(ReflectionFunction $functionReflection) : string { if ($functionReflection->isInternal()) { return ''; } $fileName = $functionReflection->getFileName(); if ($fileName === null) { return ''; } return sprintf("\n @@ %s %d - %d", $fileName, $functionReflection->getStartLine(), $functionReflection->getEndLine()); } /** @psalm-pure */ private static function parametersToString(ReflectionFunction $functionReflection) : string { return array_reduce($functionReflection->getParameters(), static function (string $string, ReflectionParameter $parameterReflection) : string { return $string . "\n " . \PHPStan\BetterReflection\Reflection\StringCast\ReflectionParameterStringCast::toString($parameterReflection); }, ''); } /** @psalm-pure */ private static function returnTypeToString(ReflectionFunction $methodReflection) : string { $type = $methodReflection->getReturnType(); if ($type === null) { return ''; } return \PHPStan\BetterReflection\Reflection\StringCast\ReflectionTypeStringCast::toString($type); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\StringCast; use PHPStan\BetterReflection\Reflection\ReflectionParameter; use function is_array; use function is_string; use function sprintf; use function strlen; use function substr; use function var_export; /** @internal */ final class ReflectionParameterStringCast { /** * @return non-empty-string * * @psalm-pure */ public static function toString(ReflectionParameter $parameterReflection) : string { return sprintf('Parameter #%d [ %s %s%s%s$%s%s ]', $parameterReflection->getPosition(), $parameterReflection->isOptional() ? '<optional>' : '<required>', self::typeToString($parameterReflection), $parameterReflection->isVariadic() ? '...' : '', $parameterReflection->isPassedByReference() ? '&' : '', $parameterReflection->getName(), self::valueToString($parameterReflection)); } /** @psalm-pure */ private static function typeToString(ReflectionParameter $parameterReflection) : string { $type = $parameterReflection->getType(); if ($type === null) { return ''; } return \PHPStan\BetterReflection\Reflection\StringCast\ReflectionTypeStringCast::toString($type) . ' '; } /** @psalm-pure */ private static function valueToString(ReflectionParameter $parameterReflection) : string { if (!($parameterReflection->isOptional() && $parameterReflection->isDefaultValueAvailable())) { return ''; } $defaultValue = $parameterReflection->getDefaultValue(); if (is_array($defaultValue)) { return ' = Array'; } if (is_string($defaultValue) && strlen($defaultValue) > 15) { return ' = ' . var_export(substr($defaultValue, 0, 15) . '...', \true); } return ' = ' . var_export($defaultValue, \true); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\StringCast; use PHPStan\BetterReflection\Reflection\ReflectionConstant; use function assert; use function gettype; use function is_array; use function is_object; use function is_string; use function sprintf; /** * Implementation of ReflectionConstant::__toString() * * @internal */ final class ReflectionConstantStringCast { /** * @return non-empty-string * * @psalm-pure */ public static function toString(ReflectionConstant $constantReflection) : string { /** @psalm-var scalar|array<scalar> $value */ $value = $constantReflection->getValue(); if (is_object($value)) { $valueAsString = 'Object'; } elseif (is_array($value)) { $valueAsString = 'Array'; } else { $valueAsString = (string) $value; } return sprintf('Constant [ <%s> %s %s ] {%s %s }', self::sourceToString($constantReflection), gettype($value), $constantReflection->getName(), self::fileAndLinesToString($constantReflection), $valueAsString); } /** @psalm-pure */ private static function sourceToString(ReflectionConstant $constantReflection) : string { if ($constantReflection->isUserDefined()) { return 'user'; } $extensionName = $constantReflection->getExtensionName(); assert(is_string($extensionName)); return sprintf('internal:%s', $extensionName); } /** @psalm-pure */ private static function fileAndLinesToString(ReflectionConstant $constantReflection) : string { if ($constantReflection->isInternal()) { return ''; } $fileName = $constantReflection->getFileName(); if ($fileName === null) { return ''; } return sprintf("\n @@ %s %d - %d\n", $fileName, $constantReflection->getStartLine(), $constantReflection->getEndLine()); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\StringCast; use PHPStan\BetterReflection\Reflection\ReflectionAttribute; use function count; use function is_array; use function is_string; use function sprintf; use function strlen; use function substr; use function var_export; /** @internal */ final class ReflectionAttributeStringCast { /** * @return non-empty-string * * @psalm-pure */ public static function toString(ReflectionAttribute $attributeReflection) : string { $arguments = $attributeReflection->getArguments(); $argumentsFormat = $arguments !== [] ? " {\n - Arguments [%d] {%s\n }\n}" : ''; return sprintf('Attribute [ %s ]' . $argumentsFormat . "\n", $attributeReflection->getName(), count($arguments), self::argumentsToString($arguments)); } /** * @param array<int|string, mixed> $arguments * * @psalm-pure */ private static function argumentsToString(array $arguments) : string { if ($arguments === []) { return ''; } $string = ''; $argumentNo = 0; /** @psalm-suppress MixedAssignment */ foreach ($arguments as $argumentName => $argumentValue) { $string .= sprintf("\n Argument #%d [ %s%s ]", $argumentNo, is_string($argumentName) ? sprintf('%s = ', $argumentName) : '', self::argumentValueToString($argumentValue)); $argumentNo++; } return $string; } /** @psalm-pure * @param mixed $value */ private static function argumentValueToString($value) : string { if (is_array($value)) { return 'Array'; } if (is_string($value) && strlen($value) > 15) { return var_export(substr($value, 0, 15) . '...', \true); } return var_export($value, \true); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\StringCast; use PHPStan\BetterReflection\Reflection\ReflectionClass; use PHPStan\BetterReflection\Reflection\ReflectionClassConstant; use PHPStan\BetterReflection\Reflection\ReflectionEnum; use PHPStan\BetterReflection\Reflection\ReflectionEnumCase; use PHPStan\BetterReflection\Reflection\ReflectionMethod; use PHPStan\BetterReflection\Reflection\ReflectionObject; use PHPStan\BetterReflection\Reflection\ReflectionProperty; use function array_filter; use function array_map; use function assert; use function count; use function implode; use function is_string; use function preg_replace; use function sprintf; use function str_repeat; use function strtolower; use function trim; /** @internal */ final class ReflectionClassStringCast { /** * @return non-empty-string * * @psalm-pure */ public static function toString(ReflectionClass $classReflection) : string { $isObject = $classReflection instanceof ReflectionObject; $format = "%s [ <%s> %s%s%s %s%s%s ] {\n"; $format .= "%s\n"; $format .= " - Constants [%d] {%s\n }\n\n"; $format .= " - Static properties [%d] {%s\n }\n\n"; $format .= " - Static methods [%d] {%s\n }\n\n"; $format .= " - Properties [%d] {%s\n }\n\n"; $format .= $isObject ? " - Dynamic properties [%d] {%s\n }\n\n" : '%s%s'; $format .= " - Methods [%d] {%s\n }\n"; $format .= "}\n"; $type = self::typeToString($classReflection); $constants = $classReflection->getConstants(); $enumCases = $classReflection instanceof ReflectionEnum ? $classReflection->getCases() : []; $staticProperties = self::getStaticProperties($classReflection); $staticMethods = self::getStaticMethods($classReflection); $defaultProperties = self::getDefaultProperties($classReflection); $dynamicProperties = self::getDynamicProperties($classReflection); $methods = self::getMethods($classReflection); return sprintf($format, $isObject ? 'Object of class' : $type, self::sourceToString($classReflection), $classReflection->isFinal() ? 'final ' : '', $classReflection->isAbstract() ? 'abstract ' : '', strtolower($type), $classReflection->getName(), self::extendsToString($classReflection), self::implementsToString($classReflection), self::fileAndLinesToString($classReflection), count($constants) + count($enumCases), self::constantsToString($constants, $enumCases), count($staticProperties), self::propertiesToString($staticProperties), count($staticMethods), self::methodsToString($staticMethods), count($defaultProperties), self::propertiesToString($defaultProperties), $isObject ? count($dynamicProperties) : '', $isObject ? self::propertiesToString($dynamicProperties) : '', count($methods), self::methodsToString($methods, 2)); } /** @psalm-pure */ private static function typeToString(ReflectionClass $classReflection) : string { if ($classReflection->isInterface()) { return 'Interface'; } if ($classReflection->isTrait()) { return 'Trait'; } return 'Class'; } /** @psalm-pure */ private static function sourceToString(ReflectionClass $classReflection) : string { if ($classReflection->isUserDefined()) { return 'user'; } $extensionName = $classReflection->getExtensionName(); assert(is_string($extensionName)); return sprintf('internal:%s', $extensionName); } /** @psalm-pure */ private static function extendsToString(ReflectionClass $classReflection) : string { $parentClass = $classReflection->getParentClass(); if ($parentClass === null) { return ''; } return ' extends ' . $parentClass->getName(); } /** @psalm-pure */ private static function implementsToString(ReflectionClass $classReflection) : string { $interfaceNames = $classReflection->getInterfaceNames(); if ($interfaceNames === []) { return ''; } return ' implements ' . implode(', ', $interfaceNames); } /** @psalm-pure */ private static function fileAndLinesToString(ReflectionClass $classReflection) : string { if ($classReflection->isInternal()) { return ''; } $fileName = $classReflection->getFileName(); if ($fileName === null) { return ''; } return sprintf(" @@ %s %d-%d\n", $fileName, $classReflection->getStartLine(), $classReflection->getEndLine()); } /** * @param array<ReflectionClassConstant> $constants * @param array<ReflectionEnumCase> $enumCases * * @psalm-pure */ private static function constantsToString(array $constants, array $enumCases) : string { if ($constants === [] && $enumCases === []) { return ''; } $items = array_map(static function (ReflectionEnumCase $enumCaseReflection) : string { return trim(\PHPStan\BetterReflection\Reflection\StringCast\ReflectionEnumCaseStringCast::toString($enumCaseReflection)); }, $enumCases) + array_map(static function (ReflectionClassConstant $constantReflection) : string { return trim(\PHPStan\BetterReflection\Reflection\StringCast\ReflectionClassConstantStringCast::toString($constantReflection)); }, $constants); return self::itemsToString($items); } /** * @param array<ReflectionProperty> $properties * * @psalm-pure */ private static function propertiesToString(array $properties) : string { if ($properties === []) { return ''; } return self::itemsToString(array_map(static function (ReflectionProperty $propertyReflection) : string { return \PHPStan\BetterReflection\Reflection\StringCast\ReflectionPropertyStringCast::toString($propertyReflection); }, $properties)); } /** * @param array<ReflectionMethod> $methods * * @psalm-pure */ private static function methodsToString(array $methods, int $emptyLinesAmongItems = 1) : string { if ($methods === []) { return ''; } return self::itemsToString(array_map(static function (ReflectionMethod $method) : string { return \PHPStan\BetterReflection\Reflection\StringCast\ReflectionMethodStringCast::toString($method); }, $methods), $emptyLinesAmongItems); } /** * @param array<string> $items * * @psalm-pure */ private static function itemsToString(array $items, int $emptyLinesAmongItems = 1) : string { $string = implode(str_repeat("\n", $emptyLinesAmongItems), $items); return "\n" . preg_replace('/(^|\\n)(?!\\n)/', '\\1' . self::indent(), $string); } /** @psalm-pure */ private static function indent() : string { return str_repeat(' ', 4); } /** * @return array<ReflectionProperty> * * @psalm-pure */ private static function getStaticProperties(ReflectionClass $classReflection) : array { return array_filter($classReflection->getProperties(), static function (ReflectionProperty $propertyReflection) : bool { return $propertyReflection->isStatic(); }); } /** * @return array<ReflectionMethod> * * @psalm-pure */ private static function getStaticMethods(ReflectionClass $classReflection) : array { return array_filter($classReflection->getMethods(), static function (ReflectionMethod $methodReflection) : bool { return $methodReflection->isStatic(); }); } /** * @return array<ReflectionProperty> * * @psalm-pure */ private static function getDefaultProperties(ReflectionClass $classReflection) : array { return array_filter($classReflection->getProperties(), static function (ReflectionProperty $propertyReflection) : bool { return !$propertyReflection->isStatic() && $propertyReflection->isDefault(); }); } /** * @return array<ReflectionProperty> * * @psalm-pure */ private static function getDynamicProperties(ReflectionClass $classReflection) : array { return array_filter($classReflection->getProperties(), static function (ReflectionProperty $propertyReflection) : bool { return !$propertyReflection->isStatic() && !$propertyReflection->isDefault(); }); } /** * @return array<ReflectionMethod> * * @psalm-pure */ private static function getMethods(ReflectionClass $classReflection) : array { return array_filter($classReflection->getMethods(), static function (ReflectionMethod $methodReflection) : bool { return !$methodReflection->isStatic(); }); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\StringCast; use PHPStan\BetterReflection\Reflection\ReflectionIntersectionType; use PHPStan\BetterReflection\Reflection\ReflectionNamedType; use PHPStan\BetterReflection\Reflection\ReflectionType; use PHPStan\BetterReflection\Reflection\ReflectionUnionType; use function array_filter; use function array_values; use function count; /** @internal */ final class ReflectionTypeStringCast { /** * @return non-empty-string * * @psalm-pure * @param \PHPStan\BetterReflection\Reflection\ReflectionNamedType|\PHPStan\BetterReflection\Reflection\ReflectionUnionType|\PHPStan\BetterReflection\Reflection\ReflectionIntersectionType $type */ public static function toString($type) : string { if ($type instanceof ReflectionUnionType) { // php-src has this weird behavior where a union type composed of a single type `T` // together with `null` means that a `ReflectionNamedType` for `?T` is produced, // rather than `T|null`. This is done to keep BC compatibility with PHP 7.1 (which // introduced nullable types), but at reflection level, this is mostly a nuisance. // In order to keep parity with core `Reflector#__toString()` behavior, we stashed // this weird behavior in here. $nonNullTypes = array_values(array_filter($type->getTypes(), static function (ReflectionType $type) : bool { return !($type instanceof ReflectionNamedType && $type->getName() === 'null'); })); if ($type->allowsNull() && count($nonNullTypes) === 1 && $nonNullTypes[0] instanceof ReflectionNamedType) { return '?' . $nonNullTypes[0]->__toString(); } } return $type->__toString(); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\StringCast; use PHPStan\BetterReflection\Reflection\ReflectionClassConstant; use function gettype; use function is_array; use function sprintf; /** @internal */ final class ReflectionClassConstantStringCast { /** * @return non-empty-string * * @psalm-pure */ public static function toString(ReflectionClassConstant $constantReflection) : string { /** @psalm-var scalar|array<scalar> $value */ $value = $constantReflection->getValue(); return sprintf("Constant [ %s%s %s %s ] { %s }\n", $constantReflection->isFinal() ? 'final ' : '', self::visibilityToString($constantReflection), gettype($value), $constantReflection->getName(), is_array($value) ? 'Array' : (string) $value); } /** @psalm-pure */ private static function visibilityToString(ReflectionClassConstant $constantReflection) : string { if ($constantReflection->isProtected()) { return 'protected'; } if ($constantReflection->isPrivate()) { return 'private'; } return 'public'; } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\StringCast; use PHPStan\BetterReflection\Reflection\Exception\MethodPrototypeNotFound; use PHPStan\BetterReflection\Reflection\ReflectionMethod; use PHPStan\BetterReflection\Reflection\ReflectionParameter; use function array_reduce; use function assert; use function count; use function is_string; use function sprintf; /** @internal */ final class ReflectionMethodStringCast { /** * @return non-empty-string * * @psalm-pure */ public static function toString(ReflectionMethod $methodReflection) : string { $parametersFormat = $methodReflection->getNumberOfParameters() > 0 || $methodReflection->hasReturnType() ? "\n\n - Parameters [%d] {%s\n }" : ''; $returnTypeFormat = $methodReflection->hasReturnType() ? "\n - Return [ %s ]" : ''; return sprintf('Method [ <%s%s%s%s%s%s>%s%s%s %s method %s ] {%s' . $parametersFormat . $returnTypeFormat . "\n}", self::sourceToString($methodReflection), $methodReflection->isConstructor() ? ', ctor' : '', $methodReflection->isDestructor() ? ', dtor' : '', self::overwritesToString($methodReflection), self::inheritsToString($methodReflection), self::prototypeToString($methodReflection), $methodReflection->isFinal() ? ' final' : '', $methodReflection->isStatic() ? ' static' : '', $methodReflection->isAbstract() ? ' abstract' : '', self::visibilityToString($methodReflection), $methodReflection->getName(), self::fileAndLinesToString($methodReflection), count($methodReflection->getParameters()), self::parametersToString($methodReflection), self::returnTypeToString($methodReflection)); } /** @psalm-pure */ private static function sourceToString(ReflectionMethod $methodReflection) : string { if ($methodReflection->isUserDefined()) { return 'user'; } $extensionName = $methodReflection->getExtensionName(); assert(is_string($extensionName)); return sprintf('internal:%s', $extensionName); } /** @psalm-pure */ private static function overwritesToString(ReflectionMethod $methodReflection) : string { $parentClass = $methodReflection->getDeclaringClass()->getParentClass(); if ($parentClass === null) { return ''; } if (!$parentClass->hasMethod($methodReflection->getName())) { return ''; } return sprintf(', overwrites %s', $parentClass->getName()); } /** @psalm-pure */ private static function inheritsToString(ReflectionMethod $methodReflection) : string { if ($methodReflection->getDeclaringClass() === $methodReflection->getCurrentClass()) { return ''; } return sprintf(', inherits %s', $methodReflection->getDeclaringClass()->getName()); } /** @psalm-pure */ private static function prototypeToString(ReflectionMethod $methodReflection) : string { try { return sprintf(', prototype %s', $methodReflection->getPrototype()->getDeclaringClass()->getName()); } catch (MethodPrototypeNotFound $exception) { return ''; } } /** @psalm-pure */ private static function visibilityToString(ReflectionMethod $methodReflection) : string { if ($methodReflection->isProtected()) { return 'protected'; } if ($methodReflection->isPrivate()) { return 'private'; } return 'public'; } /** @psalm-pure */ private static function fileAndLinesToString(ReflectionMethod $methodReflection) : string { if ($methodReflection->isInternal()) { return ''; } $fileName = $methodReflection->getFileName(); assert(is_string($fileName)); return sprintf("\n @@ %s %d - %d", $fileName, $methodReflection->getStartLine(), $methodReflection->getEndLine()); } /** @psalm-pure */ private static function parametersToString(ReflectionMethod $methodReflection) : string { return array_reduce($methodReflection->getParameters(), static function (string $string, ReflectionParameter $parameterReflection) : string { return $string . "\n " . \PHPStan\BetterReflection\Reflection\StringCast\ReflectionParameterStringCast::toString($parameterReflection); }, ''); } /** @psalm-pure */ private static function returnTypeToString(ReflectionMethod $methodReflection) : string { $type = $methodReflection->getReturnType(); if ($type === null) { return ''; } return \PHPStan\BetterReflection\Reflection\StringCast\ReflectionTypeStringCast::toString($type); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\StringCast; use PHPStan\BetterReflection\Reflection\ReflectionEnumCase; use function gettype; use function sprintf; /** @internal */ final class ReflectionEnumCaseStringCast { /** * @return non-empty-string * * @psalm-pure */ public static function toString(ReflectionEnumCase $enumCaseReflection) : string { $enumReflection = $enumCaseReflection->getDeclaringEnum(); $value = $enumReflection->isBacked() ? $enumCaseReflection->getValue() : 'Object'; $type = $enumReflection->isBacked() ? gettype($value) : $enumReflection->getName(); return sprintf("Constant [ public %s %s ] { %s }\n", $type, $enumCaseReflection->getName(), $value); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection; use PhpParser\Node\Identifier; use PhpParser\Node\IntersectionType; use PhpParser\Node\Name; use PhpParser\Node\UnionType; use PHPStan\BetterReflection\Reflector\Reflector; use function array_map; use function assert; use function implode; use function sprintf; /** @psalm-immutable */ class ReflectionUnionType extends \PHPStan\BetterReflection\Reflection\ReflectionType { /** @var non-empty-list<ReflectionNamedType|ReflectionIntersectionType> */ private $types; /** @internal * @param \PHPStan\BetterReflection\Reflection\ReflectionParameter|\PHPStan\BetterReflection\Reflection\ReflectionMethod|\PHPStan\BetterReflection\Reflection\ReflectionFunction|\PHPStan\BetterReflection\Reflection\ReflectionEnum|\PHPStan\BetterReflection\Reflection\ReflectionProperty|\PHPStan\BetterReflection\Reflection\ReflectionClassConstant $owner */ public function __construct(Reflector $reflector, $owner, UnionType $type) { /** @var non-empty-list<ReflectionNamedType|ReflectionIntersectionType> $types */ $types = array_map(static function ($type) use($reflector, $owner) { $type = \PHPStan\BetterReflection\Reflection\ReflectionType::createFromNode($reflector, $owner, $type); assert($type instanceof \PHPStan\BetterReflection\Reflection\ReflectionNamedType || $type instanceof \PHPStan\BetterReflection\Reflection\ReflectionIntersectionType); return $type; }, $type->types); $this->types = $types; } /** @internal * @param \PHPStan\BetterReflection\Reflection\ReflectionParameter|\PHPStan\BetterReflection\Reflection\ReflectionMethod|\PHPStan\BetterReflection\Reflection\ReflectionFunction|\PHPStan\BetterReflection\Reflection\ReflectionEnum|\PHPStan\BetterReflection\Reflection\ReflectionProperty|\PHPStan\BetterReflection\Reflection\ReflectionClassConstant $owner * @return $this */ public function withOwner($owner) { $clone = clone $this; foreach ($clone->types as $typeNo => $innerType) { $clone->types[$typeNo] = $innerType->withOwner($owner); } return $clone; } /** @return non-empty-list<ReflectionNamedType|ReflectionIntersectionType> */ public function getTypes() : array { return $this->types; } public function allowsNull() : bool { foreach ($this->types as $type) { if ($type->allowsNull()) { return \true; } } return \false; } /** @return non-empty-string */ public function __toString() : string { return implode('|', array_map(static function (\PHPStan\BetterReflection\Reflection\ReflectionType $type) : string { if ($type instanceof \PHPStan\BetterReflection\Reflection\ReflectionIntersectionType) { return sprintf('(%s)', $type->__toString()); } return $type->__toString(); }, $this->types)); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection; use InvalidArgumentException; use PhpParser\Builder\Property as PropertyNodeBuilder; use PhpParser\Node\Stmt\Property as PropertyNode; use ReflectionException; use ReflectionObject as CoreReflectionObject; use ReflectionProperty as CoreReflectionProperty; use PHPStan\BetterReflection\BetterReflection; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionProperty as ReflectionPropertyAdapter; use PHPStan\BetterReflection\Reflector\DefaultReflector; use PHPStan\BetterReflection\Reflector\Exception\IdentifierNotFound; use PHPStan\BetterReflection\Reflector\Reflector; use PHPStan\BetterReflection\SourceLocator\Located\LocatedSource; use PHPStan\BetterReflection\SourceLocator\Type\AggregateSourceLocator; use PHPStan\BetterReflection\SourceLocator\Type\AnonymousClassObjectSourceLocator; use function array_filter; use function array_map; use function array_merge; use function preg_match; /** @psalm-immutable */ class ReflectionObject extends \PHPStan\BetterReflection\Reflection\ReflectionClass { /** * @var \PHPStan\BetterReflection\Reflector\Reflector */ private $reflector; /** * @var \PHPStan\BetterReflection\Reflection\ReflectionClass */ private $reflectionClass; /** * @var object */ private $object; protected function __construct(Reflector $reflector, \PHPStan\BetterReflection\Reflection\ReflectionClass $reflectionClass, object $object) { $this->reflector = $reflector; $this->reflectionClass = $reflectionClass; $this->object = $object; } /** * Pass an instance of an object to this method to reflect it * * @throws ReflectionException * @throws IdentifierNotFound */ public static function createFromInstance(object $instance) : \PHPStan\BetterReflection\Reflection\ReflectionClass { $className = \get_class($instance); $betterReflection = new BetterReflection(); if (preg_match(\PHPStan\BetterReflection\Reflection\ReflectionClass::ANONYMOUS_CLASS_NAME_PREFIX_REGEXP, $className) === 1) { $reflector = new DefaultReflector(new AggregateSourceLocator([$betterReflection->sourceLocator(), new AnonymousClassObjectSourceLocator($instance, $betterReflection->phpParser())])); } else { $reflector = $betterReflection->reflector(); } return new self($reflector, $reflector->reflectClass($className), $instance); } /** * Reflect on runtime properties for the current instance * * @see ReflectionClass::getProperties() for the usage of $filter * * @param int-mask-of<ReflectionPropertyAdapter::IS_*> $filter * * @return array<non-empty-string, ReflectionProperty> */ private function getRuntimeProperties(int $filter = 0) : array { if (!$this->reflectionClass->isInstance($this->object)) { throw new InvalidArgumentException('Cannot reflect runtime properties of a separate class'); } if ($filter !== 0 && !($filter & CoreReflectionProperty::IS_PUBLIC)) { return []; } // Ensure we have already cached existing properties so we can add to them $this->reflectionClass->getProperties(); // Only known current way is to use internal ReflectionObject to get // the runtime-declared properties :/ $reflectionProperties = (new CoreReflectionObject($this->object))->getProperties(); $runtimeProperties = []; foreach ($reflectionProperties as $property) { $propertyName = $property->getName(); if ($this->reflectionClass->hasProperty($propertyName)) { continue; } $propertyNode = $this->createPropertyNodeFromRuntimePropertyReflection($property, $this->object); $runtimeProperties[$propertyName] = \PHPStan\BetterReflection\Reflection\ReflectionProperty::createFromNode($this->reflector, $propertyNode, $propertyNode->props[0], $this, $this, \false, \false); } return $runtimeProperties; } /** * Create an AST PropertyNode given a reflection * * Note that we don't copy across DocBlock, protected, private or static * because runtime properties can't have these attributes. */ private function createPropertyNodeFromRuntimePropertyReflection(CoreReflectionProperty $property, object $instance) : PropertyNode { $builder = new PropertyNodeBuilder($property->getName()); $builder->setDefault($property->getValue($instance)); $builder->makePublic(); return $builder->getNode(); } public function getShortName() : string { return $this->reflectionClass->getShortName(); } public function getName() : string { return $this->reflectionClass->getName(); } public function getNamespaceName() : ?string { return $this->reflectionClass->getNamespaceName(); } public function inNamespace() : bool { return $this->reflectionClass->inNamespace(); } /** @return non-empty-string|null */ public function getExtensionName() : ?string { return $this->reflectionClass->getExtensionName(); } /** * {@inheritDoc} */ public function getMethods(int $filter = 0) : array { return $this->reflectionClass->getMethods($filter); } /** * {@inheritDoc} */ public function getImmediateMethods(int $filter = 0) : array { return $this->reflectionClass->getImmediateMethods($filter); } /** @param non-empty-string $methodName */ public function getMethod(string $methodName) : ?\PHPStan\BetterReflection\Reflection\ReflectionMethod { return $this->reflectionClass->getMethod($methodName); } /** @param non-empty-string $methodName */ public function hasMethod(string $methodName) : bool { return $this->reflectionClass->hasMethod($methodName); } /** * {@inheritDoc} */ public function getImmediateConstants(int $filter = 0) : array { return $this->reflectionClass->getImmediateConstants($filter); } /** * {@inheritDoc} */ public function getConstants(int $filter = 0) : array { return $this->reflectionClass->getConstants($filter); } public function hasConstant(string $name) : bool { return $this->reflectionClass->hasConstant($name); } public function getConstant(string $name) : ?\PHPStan\BetterReflection\Reflection\ReflectionClassConstant { return $this->reflectionClass->getConstant($name); } public function getConstructor() : ?\PHPStan\BetterReflection\Reflection\ReflectionMethod { return $this->reflectionClass->getConstructor(); } /** * {@inheritDoc} */ public function getProperties(int $filter = 0) : array { return array_merge($this->reflectionClass->getProperties($filter), $this->getRuntimeProperties($filter)); } /** * {@inheritDoc} */ public function getImmediateProperties(int $filter = 0) : array { return array_merge($this->reflectionClass->getImmediateProperties($filter), $this->getRuntimeProperties($filter)); } public function getProperty(string $name) : ?\PHPStan\BetterReflection\Reflection\ReflectionProperty { $runtimeProperties = $this->getRuntimeProperties(); if (isset($runtimeProperties[$name])) { return $runtimeProperties[$name]; } return $this->reflectionClass->getProperty($name); } public function hasProperty(string $name) : bool { $runtimeProperties = $this->getRuntimeProperties(); return isset($runtimeProperties[$name]) || $this->reflectionClass->hasProperty($name); } /** * {@inheritDoc} */ public function getDefaultProperties() : array { return array_map(static function (\PHPStan\BetterReflection\Reflection\ReflectionProperty $property) { return $property->getDefaultValue(); }, array_filter($this->getProperties(), static function (\PHPStan\BetterReflection\Reflection\ReflectionProperty $property) : bool { return $property->isDefault(); })); } /** @return non-empty-string|null */ public function getFileName() : ?string { return $this->reflectionClass->getFileName(); } public function getLocatedSource() : LocatedSource { return $this->reflectionClass->getLocatedSource(); } public function getStartLine() : int { return $this->reflectionClass->getStartLine(); } public function getEndLine() : int { return $this->reflectionClass->getEndLine(); } public function getStartColumn() : int { return $this->reflectionClass->getStartColumn(); } public function getEndColumn() : int { return $this->reflectionClass->getEndColumn(); } public function getParentClass() : ?\PHPStan\BetterReflection\Reflection\ReflectionClass { return $this->reflectionClass->getParentClass(); } /** @return class-string|null */ public function getParentClassName() : ?string { return $this->reflectionClass->getParentClassName(); } /** * {@inheritDoc} */ public function getParentClassNames() : array { return $this->reflectionClass->getParentClassNames(); } /** @return non-empty-string|null */ public function getDocComment() : ?string { return $this->reflectionClass->getDocComment(); } public function isAnonymous() : bool { return $this->reflectionClass->isAnonymous(); } public function isInternal() : bool { return $this->reflectionClass->isInternal(); } public function isUserDefined() : bool { return $this->reflectionClass->isUserDefined(); } public function isDeprecated() : bool { return $this->reflectionClass->isDeprecated(); } public function isAbstract() : bool { return $this->reflectionClass->isAbstract(); } public function isFinal() : bool { return $this->reflectionClass->isFinal(); } public function isReadOnly() : bool { return $this->reflectionClass->isReadOnly(); } public function getModifiers() : int { return $this->reflectionClass->getModifiers(); } public function isTrait() : bool { return $this->reflectionClass->isTrait(); } public function isInterface() : bool { return $this->reflectionClass->isInterface(); } /** * {@inheritDoc} */ public function getTraitClassNames() : array { return $this->reflectionClass->getTraitClassNames(); } /** * {@inheritDoc} */ public function getTraits() : array { return $this->reflectionClass->getTraits(); } /** * {@inheritDoc} */ public function getTraitNames() : array { return $this->reflectionClass->getTraitNames(); } /** * {@inheritDoc} */ public function getTraitAliases() : array { return $this->reflectionClass->getTraitAliases(); } /** * {@inheritDoc} */ public function getInterfaceClassNames() : array { return $this->reflectionClass->getInterfaceClassNames(); } /** * {@inheritDoc} */ public function getInterfaces() : array { return $this->reflectionClass->getInterfaces(); } /** * {@inheritDoc} */ public function getImmediateInterfaces() : array { return $this->reflectionClass->getImmediateInterfaces(); } /** * {@inheritDoc} */ public function getInterfaceNames() : array { return $this->reflectionClass->getInterfaceNames(); } public function isInstance(object $object) : bool { return $this->reflectionClass->isInstance($object); } public function isSubclassOf(string $className) : bool { return $this->reflectionClass->isSubclassOf($className); } public function implementsInterface(string $interfaceName) : bool { return $this->reflectionClass->implementsInterface($interfaceName); } public function isInstantiable() : bool { return $this->reflectionClass->isInstantiable(); } public function isCloneable() : bool { return $this->reflectionClass->isCloneable(); } public function isIterateable() : bool { return $this->reflectionClass->isIterateable(); } public function isEnum() : bool { return $this->reflectionClass->isEnum(); } /** * {@inheritDoc} */ public function getStaticProperties() : array { return $this->reflectionClass->getStaticProperties(); } /** * @param mixed $value */ public function setStaticPropertyValue(string $propertyName, $value) : void { $this->reflectionClass->setStaticPropertyValue($propertyName, $value); } /** * @return mixed */ public function getStaticPropertyValue(string $propertyName) { return $this->reflectionClass->getStaticPropertyValue($propertyName); } /** @return list<ReflectionAttribute> */ public function getAttributes() : array { return $this->reflectionClass->getAttributes(); } /** @return list<ReflectionAttribute> */ public function getAttributesByName(string $name) : array { return $this->reflectionClass->getAttributesByName($name); } /** * @param class-string $className * * @return list<ReflectionAttribute> */ public function getAttributesByInstance(string $className) : array { return $this->reflectionClass->getAttributesByInstance($className); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection; use LogicException; use PhpParser\Node\Identifier; use PhpParser\Node\Name; use PHPStan\BetterReflection\Reflector\Reflector; use function array_key_exists; use function assert; use function sprintf; use function strtolower; /** @psalm-immutable */ class ReflectionNamedType extends \PHPStan\BetterReflection\Reflection\ReflectionType { private const BUILT_IN_TYPES = ['int' => null, 'float' => null, 'string' => null, 'bool' => null, 'callable' => null, 'self' => null, 'parent' => null, 'array' => null, 'iterable' => null, 'object' => null, 'void' => null, 'mixed' => null, 'static' => null, 'null' => null, 'never' => null, 'false' => null, 'true' => null]; /** @var non-empty-string */ private $name; /** * @var \PHPStan\BetterReflection\Reflector\Reflector */ private $reflector; /** * @var \PHPStan\BetterReflection\Reflection\ReflectionParameter|\PHPStan\BetterReflection\Reflection\ReflectionMethod|\PHPStan\BetterReflection\Reflection\ReflectionFunction|\PHPStan\BetterReflection\Reflection\ReflectionEnum|\PHPStan\BetterReflection\Reflection\ReflectionProperty|\PHPStan\BetterReflection\Reflection\ReflectionClassConstant */ private $owner; /** * @var \PhpParser\Node\Identifier|\PhpParser\Node\Name */ private $type; /** @internal * @param \PHPStan\BetterReflection\Reflection\ReflectionParameter|\PHPStan\BetterReflection\Reflection\ReflectionMethod|\PHPStan\BetterReflection\Reflection\ReflectionFunction|\PHPStan\BetterReflection\Reflection\ReflectionEnum|\PHPStan\BetterReflection\Reflection\ReflectionProperty|\PHPStan\BetterReflection\Reflection\ReflectionClassConstant $owner * @param \PhpParser\Node\Identifier|\PhpParser\Node\Name $type */ public function __construct(Reflector $reflector, $owner, $type) { $this->reflector = $reflector; $this->owner = $owner; $this->type = $type; $name = $type->toString(); assert($name !== ''); $this->name = $name; } /** @internal * @param \PHPStan\BetterReflection\Reflection\ReflectionParameter|\PHPStan\BetterReflection\Reflection\ReflectionMethod|\PHPStan\BetterReflection\Reflection\ReflectionFunction|\PHPStan\BetterReflection\Reflection\ReflectionEnum|\PHPStan\BetterReflection\Reflection\ReflectionProperty|\PHPStan\BetterReflection\Reflection\ReflectionClassConstant $owner * @return $this */ public function withOwner($owner) { $clone = clone $this; $clone->owner = $owner; return $clone; } /** @return non-empty-string */ public function getName() : string { return $this->name; } /** * Checks if it is a built-in type (i.e., it's not an object...) * * @see https://php.net/manual/en/reflectiontype.isbuiltin.php */ public function isBuiltin() : bool { return array_key_exists(strtolower($this->name), self::BUILT_IN_TYPES); } public function getClass() : \PHPStan\BetterReflection\Reflection\ReflectionClass { if (!$this->isBuiltin()) { return $this->reflector->reflectClass($this->name); } if ($this->owner instanceof \PHPStan\BetterReflection\Reflection\ReflectionEnum || $this->owner instanceof \PHPStan\BetterReflection\Reflection\ReflectionFunction || $this->owner instanceof \PHPStan\BetterReflection\Reflection\ReflectionParameter && $this->owner->getDeclaringFunction() instanceof \PHPStan\BetterReflection\Reflection\ReflectionFunction) { throw new LogicException(sprintf('The type %s cannot be resolved to class', $this->name)); } $lowercaseName = strtolower($this->name); if ($lowercaseName === 'self') { $class = $this->owner->getImplementingClass(); assert($class instanceof \PHPStan\BetterReflection\Reflection\ReflectionClass); return $class; } if ($lowercaseName === 'parent') { $class = $this->owner->getDeclaringClass(); assert($class instanceof \PHPStan\BetterReflection\Reflection\ReflectionClass); $parentClass = $class->getParentClass(); assert($parentClass instanceof \PHPStan\BetterReflection\Reflection\ReflectionClass); return $parentClass; } if ($this->owner instanceof \PHPStan\BetterReflection\Reflection\ReflectionMethod && $lowercaseName === 'static') { return $this->owner->getCurrentClass(); } throw new LogicException(sprintf('The type %s cannot be resolved to class', $this->name)); } public function allowsNull() : bool { switch (strtolower($this->name)) { case 'mixed': return \true; case 'null': return \true; default: return \false; } } public function isIdentifier() : bool { return $this->type instanceof Identifier; } /** @return non-empty-string */ public function __toString() : string { return $this->getName(); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection; use PhpParser\Node; use PhpParser\Node\Expr\Yield_ as YieldNode; use PhpParser\Node\Expr\YieldFrom as YieldFromNode; use PhpParser\Node\Stmt\ClassMethod as MethodNode; use PhpParser\Node\Stmt\Throw_ as NodeThrow; use PhpParser\NodeTraverser; use PhpParser\NodeVisitor\FindingVisitor; use PHPStan\BetterReflection\Reflection\Annotation\AnnotationHelper; use PHPStan\BetterReflection\Reflection\Attribute\ReflectionAttributeHelper; use PHPStan\BetterReflection\Reflection\Exception\CodeLocationMissing; use PHPStan\BetterReflection\SourceLocator\Located\LocatedSource; use PHPStan\BetterReflection\Util\CalculateReflectionColumn; use PHPStan\BetterReflection\Util\Exception\NoNodePosition; use PHPStan\BetterReflection\Util\GetLastDocComment; use function array_filter; use function array_values; use function assert; use function count; use function is_array; /** @psalm-immutable */ trait ReflectionFunctionAbstract { /** * @var non-empty-string * @psalm-allow-private-mutation */ private $name; /** * @var array<non-empty-string, ReflectionParameter> * @psalm-allow-private-mutation */ private $parameters; /** @psalm-allow-private-mutation * @var bool */ private $returnsReference; /** @psalm-allow-private-mutation * @var \PHPStan\BetterReflection\Reflection\ReflectionNamedType|\PHPStan\BetterReflection\Reflection\ReflectionUnionType|\PHPStan\BetterReflection\Reflection\ReflectionIntersectionType|null */ private $returnType; /** * @var list<ReflectionAttribute> * @psalm-allow-private-mutation */ private $attributes; /** * @var non-empty-string|null * @psalm-allow-private-mutation */ private $docComment; /** * @var positive-int|null * @psalm-allow-private-mutation */ private $startLine; /** * @var positive-int|null * @psalm-allow-private-mutation */ private $endLine; /** * @var positive-int|null * @psalm-allow-private-mutation */ private $startColumn; /** * @var positive-int|null * @psalm-allow-private-mutation */ private $endColumn; /** @psalm-allow-private-mutation * @var bool */ private $couldThrow = \false; /** @psalm-allow-private-mutation * @var bool */ private $isClosure = \false; /** @psalm-allow-private-mutation * @var bool */ private $isGenerator = \false; /** @return non-empty-string */ public abstract function __toString() : string; /** @return non-empty-string */ public abstract function getShortName() : string; /** @psalm-external-mutation-free * @param MethodNode|\PhpParser\Node\Stmt\Function_|\PhpParser\Node\Expr\Closure|\PhpParser\Node\Expr\ArrowFunction $node */ private function fillFromNode($node) : void { $this->parameters = $this->createParameters($node); $this->returnsReference = $node->returnsByRef(); $this->returnType = $this->createReturnType($node); $this->attributes = ReflectionAttributeHelper::createAttributes($this->reflector, $this, $node->attrGroups); $this->docComment = GetLastDocComment::forNode($node); $this->couldThrow = $this->computeCouldThrow($node); $startLine = null; if ($node->hasAttribute('startLine')) { $startLine = $node->getStartLine(); assert($startLine > 0); } $endLine = null; if ($node->hasAttribute('endLine')) { $endLine = $node->getEndLine(); assert($endLine > 0); } $this->startLine = $startLine; $this->endLine = $endLine; try { $this->startColumn = CalculateReflectionColumn::getStartColumn($this->getLocatedSource()->getSource(), $node); } catch (NoNodePosition $exception) { $this->startColumn = null; } try { $this->endColumn = CalculateReflectionColumn::getEndColumn($this->getLocatedSource()->getSource(), $node); } catch (NoNodePosition $exception) { $this->endColumn = null; } } /** @return array<non-empty-string, ReflectionParameter> * @param \PhpParser\Node\Stmt\ClassMethod|\PhpParser\Node\Stmt\Function_|\PhpParser\Node\Expr\Closure|\PhpParser\Node\Expr\ArrowFunction $node */ private function createParameters($node) : array { $parameters = []; /** @var list<Node\Param> $nodeParams */ $nodeParams = $node->params; foreach ($nodeParams as $paramIndex => $paramNode) { $parameter = \PHPStan\BetterReflection\Reflection\ReflectionParameter::createFromNode($this->reflector, $paramNode, $this, $paramIndex, $this->isParameterOptional($nodeParams, $paramIndex)); $parameters[$parameter->getName()] = $parameter; } return $parameters; } /** * Get the "full" name of the function (e.g. for A\B\foo, this will return * "A\B\foo"). * * @return non-empty-string */ public function getName() : string { $namespace = $this->getNamespaceName(); if ($namespace === null) { return $this->getShortName(); } return $namespace . '\\' . $this->getShortName(); } /** * Get the "namespace" name of the function (e.g. for A\B\foo, this will * return "A\B"). * * @return non-empty-string|null */ public function getNamespaceName() : ?string { return $this->namespace; } /** * Decide if this function is part of a namespace. Returns false if the class * is in the global namespace or does not have a specified namespace. */ public function inNamespace() : bool { return $this->namespace !== null; } /** * Get the number of parameters for this class. * * @return positive-int|0 */ public function getNumberOfParameters() : int { return count($this->parameters); } /** * Get the number of required parameters for this method. * * @return positive-int|0 */ public function getNumberOfRequiredParameters() : int { return count(array_filter($this->parameters, static function (\PHPStan\BetterReflection\Reflection\ReflectionParameter $p) : bool { return !$p->isOptional(); })); } /** * Get an array list of the parameters for this method signature, as an * array of ReflectionParameter instances. * * @return list<ReflectionParameter> */ public function getParameters() : array { return array_values($this->parameters); } /** @param list<Node\Param> $parameterNodes */ private function isParameterOptional(array $parameterNodes, int $parameterIndex) : bool { foreach ($parameterNodes as $otherParameterIndex => $otherParameterNode) { if ($otherParameterIndex < $parameterIndex) { continue; } // When we find next parameter that does not have a default or is not variadic, // it means current parameter cannot be optional EVEN if it has a default value if ($otherParameterNode->default === null && !$otherParameterNode->variadic) { return \false; } } return \true; } /** * Get a single parameter by name. Returns null if parameter not found for * the function. * * @param non-empty-string $parameterName */ public function getParameter(string $parameterName) : ?\PHPStan\BetterReflection\Reflection\ReflectionParameter { return $this->parameters[$parameterName] ?? null; } /** @return non-empty-string|null */ public function getDocComment() : ?string { return $this->docComment; } /** @return non-empty-string|null */ public function getFileName() : ?string { return $this->locatedSource->getFileName(); } public function getLocatedSource() : LocatedSource { return $this->locatedSource; } /** * Is this function a closure? */ public function isClosure() : bool { return $this->isClosure; } public function isDeprecated() : bool { return AnnotationHelper::isDeprecated($this->docComment); } public function isInternal() : bool { return $this->locatedSource->isInternal(); } /** * Is this a user-defined function (will always return the opposite of * whatever isInternal returns). */ public function isUserDefined() : bool { return !$this->isInternal(); } /** @return non-empty-string|null */ public function getExtensionName() : ?string { return $this->locatedSource->getExtensionName(); } /** * Check if the function has a variadic parameter. */ public function isVariadic() : bool { foreach ($this->parameters as $parameter) { if ($parameter->isVariadic()) { return \true; } } return \false; } /** Checks if the function/method contains `throw` expressions. */ public function couldThrow() : bool { return $this->couldThrow; } /** * @param MethodNode|\PhpParser\Node\Stmt\Function_|\PhpParser\Node\Expr\Closure|\PhpParser\Node\Expr\ArrowFunction $node */ private function computeCouldThrow($node) : bool { $statements = $node->getStmts(); if ($statements === null) { return \false; } $visitor = new FindingVisitor(static function (Node $node) : bool { return $node instanceof NodeThrow; }); $traverser = new NodeTraverser(); $traverser->addVisitor($visitor); $traverser->traverse($statements); return $visitor->getFoundNodes() !== []; } /** * Recursively search an array of statements (PhpParser nodes) to find if a * yield expression exists anywhere (thus indicating this is a generator). */ private function nodeIsOrContainsYield(Node $node) : bool { if ($node instanceof YieldNode) { return \true; } if ($node instanceof YieldFromNode) { return \true; } /** @psalm-var string $nodeName */ foreach ($node->getSubNodeNames() as $nodeName) { $nodeProperty = $node->{$nodeName}; if ($nodeProperty instanceof Node && $this->nodeIsOrContainsYield($nodeProperty)) { return \true; } if (!is_array($nodeProperty)) { continue; } /** @psalm-var mixed $nodePropertyArrayItem */ foreach ($nodeProperty as $nodePropertyArrayItem) { if ($nodePropertyArrayItem instanceof Node && $this->nodeIsOrContainsYield($nodePropertyArrayItem)) { return \true; } } } return \false; } /** * Check if this function can be used as a generator (i.e. contains the * "yield" keyword). */ public function isGenerator() : bool { return $this->isGenerator; } /** * Get the line number that this function starts on. * * @return positive-int * * @throws CodeLocationMissing */ public function getStartLine() : int { if ($this->startLine === null) { throw CodeLocationMissing::create(); } return $this->startLine; } /** * Get the line number that this function ends on. * * @return positive-int * * @throws CodeLocationMissing */ public function getEndLine() : int { if ($this->endLine === null) { throw CodeLocationMissing::create(); } return $this->endLine; } /** * @return positive-int * * @throws CodeLocationMissing */ public function getStartColumn() : int { if ($this->startColumn === null) { throw CodeLocationMissing::create(); } return $this->startColumn; } /** * @return positive-int * * @throws CodeLocationMissing */ public function getEndColumn() : int { if ($this->endColumn === null) { throw CodeLocationMissing::create(); } return $this->endColumn; } /** * Is this function declared as a reference. */ public function returnsReference() : bool { return $this->returnsReference; } /** * Get the return type declaration * @return \PHPStan\BetterReflection\Reflection\ReflectionNamedType|\PHPStan\BetterReflection\Reflection\ReflectionUnionType|\PHPStan\BetterReflection\Reflection\ReflectionIntersectionType|null */ public function getReturnType() { if ($this->hasTentativeReturnType()) { return null; } return $this->returnType; } /** * Do we have a return type declaration */ public function hasReturnType() : bool { if ($this->hasTentativeReturnType()) { return \false; } return $this->returnType !== null; } public function hasTentativeReturnType() : bool { if ($this->isUserDefined()) { return \false; } return AnnotationHelper::hasTentativeReturnType($this->docComment); } /** * @return \PHPStan\BetterReflection\Reflection\ReflectionNamedType|\PHPStan\BetterReflection\Reflection\ReflectionUnionType|\PHPStan\BetterReflection\Reflection\ReflectionIntersectionType|null */ public function getTentativeReturnType() { if (!$this->hasTentativeReturnType()) { return null; } return $this->returnType; } /** * @param MethodNode|\PhpParser\Node\Stmt\Function_|\PhpParser\Node\Expr\Closure|\PhpParser\Node\Expr\ArrowFunction $node * @return \PHPStan\BetterReflection\Reflection\ReflectionNamedType|\PHPStan\BetterReflection\Reflection\ReflectionUnionType|\PHPStan\BetterReflection\Reflection\ReflectionIntersectionType|null */ private function createReturnType($node) { $returnType = $node->getReturnType(); if ($returnType === null) { return null; } assert($returnType instanceof Node\Identifier || $returnType instanceof Node\Name || $returnType instanceof Node\NullableType || $returnType instanceof Node\UnionType || $returnType instanceof Node\IntersectionType); return \PHPStan\BetterReflection\Reflection\ReflectionType::createFromNode($this->reflector, $this, $returnType); } /** @return list<ReflectionAttribute> */ public function getAttributes() : array { return $this->attributes; } /** @return list<ReflectionAttribute> */ public function getAttributesByName(string $name) : array { return ReflectionAttributeHelper::filterAttributesByName($this->getAttributes(), $name); } /** * @param class-string $className * * @return list<ReflectionAttribute> */ public function getAttributesByInstance(string $className) : array { return ReflectionAttributeHelper::filterAttributesByInstance($this->getAttributes(), $className); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection\Support; use PHPStan\BetterReflection\Reflection\Exception\CircularReference; use function array_key_exists; /** @internal */ final class AlreadyVisitedClasses { /** * @var array<class-string, null> */ private $classNames; /** @param array<class-string, null> $classNames */ private function __construct(array $classNames) { $this->classNames = $classNames; } public static function createEmpty() : self { return new self([]); } /** @param class-string $className */ public function push(string $className) : void { if (array_key_exists($className, $this->classNames)) { throw CircularReference::fromClassName($className); } $this->classNames[$className] = null; } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection; use Closure; use Error; use OutOfBoundsException; use PhpParser\Node; use PhpParser\Node\Stmt\Property as PropertyNode; use ReflectionException; use ReflectionProperty as CoreReflectionProperty; use PHPStan\BetterReflection\NodeCompiler\CompiledValue; use PHPStan\BetterReflection\NodeCompiler\CompileNodeToValue; use PHPStan\BetterReflection\NodeCompiler\CompilerContext; use PHPStan\BetterReflection\Reflection\Adapter\ReflectionProperty as ReflectionPropertyAdapter; use PHPStan\BetterReflection\Reflection\Annotation\AnnotationHelper; use PHPStan\BetterReflection\Reflection\Attribute\ReflectionAttributeHelper; use PHPStan\BetterReflection\Reflection\Exception\ClassDoesNotExist; use PHPStan\BetterReflection\Reflection\Exception\CodeLocationMissing; use PHPStan\BetterReflection\Reflection\Exception\NoObjectProvided; use PHPStan\BetterReflection\Reflection\Exception\NotAnObject; use PHPStan\BetterReflection\Reflection\Exception\ObjectNotInstanceOfClass; use PHPStan\BetterReflection\Reflection\StringCast\ReflectionPropertyStringCast; use PHPStan\BetterReflection\Reflector\Exception\IdentifierNotFound; use PHPStan\BetterReflection\Reflector\Reflector; use PHPStan\BetterReflection\Util\CalculateReflectionColumn; use PHPStan\BetterReflection\Util\ClassExistenceChecker; use PHPStan\BetterReflection\Util\Exception\NoNodePosition; use PHPStan\BetterReflection\Util\GetLastDocComment; use function array_map; use function assert; use function func_num_args; use function is_object; use function sprintf; use function str_contains; /** @psalm-immutable */ class ReflectionProperty { /** @var non-empty-string */ private $name; /** @var int-mask-of<ReflectionPropertyAdapter::IS_*> */ private $modifiers; /** * @var \PHPStan\BetterReflection\Reflection\ReflectionNamedType|\PHPStan\BetterReflection\Reflection\ReflectionUnionType|\PHPStan\BetterReflection\Reflection\ReflectionIntersectionType|null */ private $type; /** * @var \PhpParser\Node\Expr|null */ private $default; /** @var non-empty-string|null */ private $docComment; /** @var list<ReflectionAttribute> */ private $attributes; /** @var positive-int|null */ private $startLine; /** @var positive-int|null */ private $endLine; /** @var positive-int|null */ private $startColumn; /** @var positive-int|null */ private $endColumn; /** @psalm-allow-private-mutation * @var \PHPStan\BetterReflection\NodeCompiler\CompiledValue|null */ private $compiledDefaultValue = null; /** * @var \PHPStan\BetterReflection\Reflector\Reflector */ private $reflector; /** * @var \PHPStan\BetterReflection\Reflection\ReflectionClass */ private $declaringClass; /** * @var \PHPStan\BetterReflection\Reflection\ReflectionClass */ private $implementingClass; /** * @var bool */ private $isPromoted; /** * @var bool */ private $declaredAtCompileTime; private function __construct(Reflector $reflector, PropertyNode $node, Node\Stmt\PropertyProperty $propertyNode, \PHPStan\BetterReflection\Reflection\ReflectionClass $declaringClass, \PHPStan\BetterReflection\Reflection\ReflectionClass $implementingClass, bool $isPromoted, bool $declaredAtCompileTime) { $this->reflector = $reflector; $this->declaringClass = $declaringClass; $this->implementingClass = $implementingClass; $this->isPromoted = $isPromoted; $this->declaredAtCompileTime = $declaredAtCompileTime; $name = $propertyNode->name->name; assert($name !== ''); $this->name = $name; $this->modifiers = $this->computeModifiers($node); $this->type = $this->createType($node); $this->default = $propertyNode->default; $this->docComment = GetLastDocComment::forNode($node); $this->attributes = ReflectionAttributeHelper::createAttributes($reflector, $this, $node->attrGroups); $startLine = null; if ($node->hasAttribute('startLine')) { $startLine = $node->getStartLine(); assert($startLine > 0); } $endLine = null; if ($node->hasAttribute('endLine')) { $endLine = $node->getEndLine(); assert($endLine > 0); } $this->startLine = $startLine; $this->endLine = $endLine; try { $this->startColumn = CalculateReflectionColumn::getStartColumn($declaringClass->getLocatedSource()->getSource(), $node); } catch (NoNodePosition $exception) { $this->startColumn = null; } try { $this->endColumn = CalculateReflectionColumn::getEndColumn($declaringClass->getLocatedSource()->getSource(), $node); } catch (NoNodePosition $exception) { $this->endColumn = null; } } /** * Create a reflection of a class's property by its name * * @param non-empty-string $propertyName * * @throws OutOfBoundsException */ public static function createFromName(string $className, string $propertyName) : self { $property = \PHPStan\BetterReflection\Reflection\ReflectionClass::createFromName($className)->getProperty($propertyName); if ($property === null) { throw new OutOfBoundsException(sprintf('Could not find property: %s', $propertyName)); } return $property; } /** * Create a reflection of an instance's property by its name * * @param non-empty-string $propertyName * * @throws ReflectionException * @throws IdentifierNotFound * @throws OutOfBoundsException */ public static function createFromInstance(object $instance, string $propertyName) : self { $property = \PHPStan\BetterReflection\Reflection\ReflectionClass::createFromInstance($instance)->getProperty($propertyName); if ($property === null) { throw new OutOfBoundsException(sprintf('Could not find property: %s', $propertyName)); } return $property; } /** @internal */ public function withImplementingClass(\PHPStan\BetterReflection\Reflection\ReflectionClass $implementingClass) : self { $clone = clone $this; $clone->implementingClass = $implementingClass; if ($clone->type !== null) { $clone->type = $clone->type->withOwner($clone); } $clone->attributes = array_map(static function (\PHPStan\BetterReflection\Reflection\ReflectionAttribute $attribute) use($clone) : \PHPStan\BetterReflection\Reflection\ReflectionAttribute { return $attribute->withOwner($clone); }, $this->attributes); $this->compiledDefaultValue = null; return $clone; } /** @return non-empty-string */ public function __toString() : string { return ReflectionPropertyStringCast::toString($this); } /** * @internal * * @param PropertyNode $node Node has to be processed by the PhpParser\NodeVisitor\NameResolver */ public static function createFromNode(Reflector $reflector, PropertyNode $node, Node\Stmt\PropertyProperty $propertyProperty, \PHPStan\BetterReflection\Reflection\ReflectionClass $declaringClass, \PHPStan\BetterReflection\Reflection\ReflectionClass $implementingClass, bool $isPromoted = \false, bool $declaredAtCompileTime = \true) : self { return new self($reflector, $node, $propertyProperty, $declaringClass, $implementingClass, $isPromoted, $declaredAtCompileTime); } /** * Has the property been declared at compile-time? * * Note that unless the property is static, this is hard coded to return * true, because we are unable to reflect instances of classes, therefore * we can be sure that all properties are always declared at compile-time. */ public function isDefault() : bool { return $this->declaredAtCompileTime; } /** * Get the core-reflection-compatible modifier values. * * @return int-mask-of<ReflectionPropertyAdapter::IS_*> */ public function getModifiers() : int { return $this->modifiers; } /** * Get the name of the property. * * @return non-empty-string */ public function getName() : string { return $this->name; } /** * Is the property private? */ public function isPrivate() : bool { return ($this->modifiers & CoreReflectionProperty::IS_PRIVATE) === CoreReflectionProperty::IS_PRIVATE; } /** * Is the property protected? */ public function isProtected() : bool { return ($this->modifiers & CoreReflectionProperty::IS_PROTECTED) === CoreReflectionProperty::IS_PROTECTED; } /** * Is the property public? */ public function isPublic() : bool { return ($this->modifiers & CoreReflectionProperty::IS_PUBLIC) === CoreReflectionProperty::IS_PUBLIC; } /** * Is the property static? */ public function isStatic() : bool { return ($this->modifiers & CoreReflectionProperty::IS_STATIC) === CoreReflectionProperty::IS_STATIC; } public function isPromoted() : bool { return $this->isPromoted; } public function isInitialized($object = null) : bool { if ($object === null && $this->isStatic()) { return !$this->hasType() || $this->hasDefaultValue(); } try { $this->getValue($object); return \true; // @phpstan-ignore-next-line } catch (Error $e) { if (\strpos($e->getMessage(), 'must not be accessed before initialization') !== \false) { return \false; } throw $e; } } public function isReadOnly() : bool { return ($this->modifiers & ReflectionPropertyAdapter::IS_READONLY_COMPATIBILITY) === ReflectionPropertyAdapter::IS_READONLY_COMPATIBILITY || $this->getDeclaringClass()->isReadOnly(); } public function getDeclaringClass() : \PHPStan\BetterReflection\Reflection\ReflectionClass { return $this->declaringClass; } public function getImplementingClass() : \PHPStan\BetterReflection\Reflection\ReflectionClass { return $this->implementingClass; } /** @return non-empty-string|null */ public function getDocComment() : ?string { return $this->docComment; } public function hasDefaultValue() : bool { return !$this->hasType() || $this->default !== null; } /** * @deprecated Use getDefaultValueExpression() */ public function getDefaultValueExpr() : ?\PhpParser\Node\Expr { return $this->getDefaultValueExpression(); } public function getDefaultValueExpression() : ?\PhpParser\Node\Expr { return $this->default; } /** * Get the default value of the property (as defined before constructor is * called, when the property is defined) * * @deprecated Use getDefaultValueExpr() * @return mixed */ public function getDefaultValue() { if ($this->default === null) { return null; } if ($this->compiledDefaultValue === null) { $this->compiledDefaultValue = (new CompileNodeToValue())->__invoke($this->default, new CompilerContext($this->reflector, $this)); } /** @psalm-var scalar|array<scalar>|null $value */ $value = $this->compiledDefaultValue->value; return $value; } public function isDeprecated() : bool { return AnnotationHelper::isDeprecated($this->getDocComment()); } /** * Get the line number that this property starts on. * * @return positive-int * * @throws CodeLocationMissing */ public function getStartLine() : int { if ($this->startLine === null) { throw CodeLocationMissing::create(); } return $this->startLine; } /** * Get the line number that this property ends on. * * @return positive-int * * @throws CodeLocationMissing */ public function getEndLine() : int { if ($this->endLine === null) { throw CodeLocationMissing::create(); } return $this->endLine; } /** * @return positive-int * * @throws CodeLocationMissing */ public function getStartColumn() : int { if ($this->startColumn === null) { throw CodeLocationMissing::create(); } return $this->startColumn; } /** * @return positive-int * * @throws CodeLocationMissing */ public function getEndColumn() : int { if ($this->endColumn === null) { throw CodeLocationMissing::create(); } return $this->endColumn; } /** @return list<ReflectionAttribute> */ public function getAttributes() : array { return $this->attributes; } /** @return list<ReflectionAttribute> */ public function getAttributesByName(string $name) : array { return ReflectionAttributeHelper::filterAttributesByName($this->getAttributes(), $name); } /** * @param class-string $className * * @return list<ReflectionAttribute> */ public function getAttributesByInstance(string $className) : array { return ReflectionAttributeHelper::filterAttributesByInstance($this->getAttributes(), $className); } /** * @throws ClassDoesNotExist * @throws NoObjectProvided * @throws ObjectNotInstanceOfClass * @return mixed */ public function getValue($object = null) { $implementingClassName = $this->getImplementingClass()->getName(); if ($this->isStatic()) { $this->assertClassExist($implementingClassName); $closure = Closure::bind(function (string $implementingClassName, string $propertyName) { return $implementingClassName::${$propertyName}; }, null, $implementingClassName); assert($closure instanceof Closure); return $closure->__invoke($implementingClassName, $this->getName()); } $instance = $this->assertObject($object); $closure = Closure::bind(function (object $instance, string $propertyName) { return $instance->{$propertyName}; }, $instance, $implementingClassName); assert($closure instanceof Closure); return $closure->__invoke($instance, $this->getName()); } /** * @throws ClassDoesNotExist * @throws NoObjectProvided * @throws NotAnObject * @throws ObjectNotInstanceOfClass * @param mixed $object * @param mixed $value */ public function setValue($object, $value = null) : void { $implementingClassName = $this->getImplementingClass()->getName(); if ($this->isStatic()) { $this->assertClassExist($implementingClassName); $closure = Closure::bind(function (string $_implementingClassName, string $_propertyName, $value) : void { /** @psalm-suppress MixedAssignment */ $_implementingClassName::${$_propertyName} = $value; }, null, $implementingClassName); assert($closure instanceof Closure); $closure->__invoke($implementingClassName, $this->getName(), func_num_args() === 2 ? $value : $object); return; } $instance = $this->assertObject($object); $closure = Closure::bind(function (object $instance, string $propertyName, $value) : void { $instance->{$propertyName} = $value; }, $instance, $implementingClassName); assert($closure instanceof Closure); $closure->__invoke($instance, $this->getName(), $value); } /** * Does this property allow null? */ public function allowsNull() : bool { return $this->type === null || $this->type->allowsNull(); } /** * @return \PHPStan\BetterReflection\Reflection\ReflectionNamedType|\PHPStan\BetterReflection\Reflection\ReflectionUnionType|\PHPStan\BetterReflection\Reflection\ReflectionIntersectionType|null */ private function createType(PropertyNode $node) { $type = $node->type; if ($type === null) { return null; } assert($type instanceof Node\Identifier || $type instanceof Node\Name || $type instanceof Node\NullableType || $type instanceof Node\UnionType || $type instanceof Node\IntersectionType); return \PHPStan\BetterReflection\Reflection\ReflectionType::createFromNode($this->reflector, $this, $type); } /** * Get the ReflectionType instance representing the type declaration for * this property * * (note: this has nothing to do with DocBlocks). * @return \PHPStan\BetterReflection\Reflection\ReflectionNamedType|\PHPStan\BetterReflection\Reflection\ReflectionUnionType|\PHPStan\BetterReflection\Reflection\ReflectionIntersectionType|null */ public function getType() { return $this->type; } /** * Does this property have a type declaration? * * (note: this has nothing to do with DocBlocks). */ public function hasType() : bool { return $this->type !== null; } /** * @param class-string $className * * @throws ClassDoesNotExist */ private function assertClassExist(string $className) : void { if (!ClassExistenceChecker::classExists($className, \true) && !ClassExistenceChecker::traitExists($className, \true)) { throw new ClassDoesNotExist('Property cannot be retrieved as the class does not exist'); } } /** * @throws NoObjectProvided * @throws NotAnObject * @throws ObjectNotInstanceOfClass * * @psalm-assert object $object * @param mixed $object */ private function assertObject($object) : object { if ($object === null) { throw NoObjectProvided::create(); } if (!is_object($object)) { throw NotAnObject::fromNonObject($object); } $implementingClassName = $this->getImplementingClass()->getName(); if (\get_class($object) !== $implementingClassName) { throw ObjectNotInstanceOfClass::fromClassName($implementingClassName); } return $object; } /** @return int-mask-of<ReflectionPropertyAdapter::IS_*> */ private function computeModifiers(PropertyNode $node) : int { $modifiers = $node->isReadonly() ? ReflectionPropertyAdapter::IS_READONLY_COMPATIBILITY : 0; $modifiers += $node->isStatic() ? CoreReflectionProperty::IS_STATIC : 0; $modifiers += $node->isPrivate() ? CoreReflectionProperty::IS_PRIVATE : 0; $modifiers += $node->isProtected() ? CoreReflectionProperty::IS_PROTECTED : 0; $modifiers += $node->isPublic() ? CoreReflectionProperty::IS_PUBLIC : 0; return $modifiers; } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflection; use PhpParser\Node; use PHPStan\BetterReflection\BetterReflection; use PHPStan\BetterReflection\NodeCompiler\CompiledValue; use PHPStan\BetterReflection\NodeCompiler\CompileNodeToValue; use PHPStan\BetterReflection\NodeCompiler\CompilerContext; use PHPStan\BetterReflection\Reflection\Annotation\AnnotationHelper; use PHPStan\BetterReflection\Reflection\Exception\InvalidConstantNode; use PHPStan\BetterReflection\Reflection\StringCast\ReflectionConstantStringCast; use PHPStan\BetterReflection\Reflector\Exception\IdentifierNotFound; use PHPStan\BetterReflection\Reflector\Reflector; use PHPStan\BetterReflection\SourceLocator\Located\LocatedSource; use PHPStan\BetterReflection\Util\CalculateReflectionColumn; use PHPStan\BetterReflection\Util\ConstantNodeChecker; use PHPStan\BetterReflection\Util\GetLastDocComment; use function array_slice; use function assert; use function count; use function explode; use function implode; use function is_int; /** @psalm-immutable */ class ReflectionConstant implements \PHPStan\BetterReflection\Reflection\Reflection { /** * @var non-empty-string * @psalm-allow-private-mutation */ private $name; /** * @var non-empty-string * @psalm-allow-private-mutation */ private $shortName; /** * @var \PhpParser\Node\Expr */ private $value; /** @var non-empty-string|null */ private $docComment; /** @var positive-int */ private $startLine; /** @var positive-int */ private $endLine; /** @var positive-int */ private $startColumn; /** @var positive-int */ private $endColumn; /** @psalm-allow-private-mutation * @var \PHPStan\BetterReflection\NodeCompiler\CompiledValue|null */ private $compiledValue = null; /** * @var \PHPStan\BetterReflection\Reflector\Reflector */ private $reflector; /** * @var \PHPStan\BetterReflection\SourceLocator\Located\LocatedSource */ private $locatedSource; /** * @var non-empty-string|null */ private $namespace = null; /** @param non-empty-string|null $namespace * @param \PhpParser\Node\Stmt\Const_|\PhpParser\Node\Expr\FuncCall $node */ private function __construct(Reflector $reflector, $node, LocatedSource $locatedSource, ?string $namespace = null, ?int $positionInNode = null) { $this->reflector = $reflector; $this->locatedSource = $locatedSource; /** @psalm-allow-private-mutation */ $this->namespace = $namespace; $this->setNamesFromNode($node, $positionInNode); if ($node instanceof Node\Expr\FuncCall) { $argumentValueNode = $node->args[1]; assert($argumentValueNode instanceof Node\Arg); $this->value = $argumentValueNode->value; } else { /** @psalm-suppress PossiblyNullArrayOffset */ $this->value = $node->consts[$positionInNode]->value; } $this->docComment = GetLastDocComment::forNode($node); $startLine = $node->getStartLine(); assert($startLine > 0); $endLine = $node->getEndLine(); assert($endLine > 0); $this->startLine = $startLine; $this->endLine = $endLine; $this->startColumn = CalculateReflectionColumn::getStartColumn($this->locatedSource->getSource(), $node); $this->endColumn = CalculateReflectionColumn::getEndColumn($this->locatedSource->getSource(), $node); } /** * Create a ReflectionConstant by name, using default reflectors etc. * * @deprecated Use Reflector instead. * * @throws IdentifierNotFound */ public static function createFromName(string $constantName) : self { return (new BetterReflection())->reflector()->reflectConstant($constantName); } /** * Create a reflection of a constant * * @internal * * @param Node\Stmt\Const_|Node\Expr\FuncCall $node Node has to be processed by the PhpParser\NodeVisitor\NameResolver * @param non-empty-string|null $namespace */ public static function createFromNode(Reflector $reflector, Node $node, LocatedSource $locatedSource, ?string $namespace = null, ?int $positionInNode = null) : self { if ($node instanceof Node\Stmt\Const_) { assert(is_int($positionInNode)); return self::createFromConstKeyword($reflector, $node, $locatedSource, $namespace, $positionInNode); } return self::createFromDefineFunctionCall($reflector, $node, $locatedSource); } /** @param non-empty-string|null $namespace */ private static function createFromConstKeyword(Reflector $reflector, Node\Stmt\Const_ $node, LocatedSource $locatedSource, ?string $namespace, int $positionInNode) : self { return new self($reflector, $node, $locatedSource, $namespace, $positionInNode); } /** @throws InvalidConstantNode */ private static function createFromDefineFunctionCall(Reflector $reflector, Node\Expr\FuncCall $node, LocatedSource $locatedSource) : self { ConstantNodeChecker::assertValidDefineFunctionCall($node); return new self($reflector, $node, $locatedSource); } /** * Get the "short" name of the constant (e.g. for A\B\FOO, this will return * "FOO"). * * @return non-empty-string */ public function getShortName() : string { return $this->shortName; } /** * Get the "full" name of the constant (e.g. for A\B\FOO, this will return * "A\B\FOO"). * * @return non-empty-string */ public function getName() : string { return $this->name; } /** * Get the "namespace" name of the constant (e.g. for A\B\FOO, this will * return "A\B"). * * @return non-empty-string|null */ public function getNamespaceName() : ?string { return $this->namespace; } /** * Decide if this constant is part of a namespace. Returns false if the constant * is in the global namespace or does not have a specified namespace. */ public function inNamespace() : bool { return $this->namespace !== null; } /** @return non-empty-string|null */ public function getExtensionName() : ?string { return $this->locatedSource->getExtensionName(); } /** * Is this an internal constant? */ public function isInternal() : bool { return $this->locatedSource->isInternal(); } /** * Is this a user-defined function (will always return the opposite of * whatever isInternal returns). */ public function isUserDefined() : bool { return !$this->isInternal(); } public function isDeprecated() : bool { return AnnotationHelper::isDeprecated($this->getDocComment()); } /** * @deprecated Use getValueExpression() * @return Node\Expr */ public function getValueExpr() : Node\Expr { return $this->getValueExpression(); } public function getValueExpression() : Node\Expr { return $this->value; } /** * @deprecated Use getValueExpression() * @return mixed */ public function getValue() { if ($this->compiledValue === null) { $this->compiledValue = (new CompileNodeToValue())->__invoke($this->value, new CompilerContext($this->reflector, $this)); } return $this->compiledValue->value; } /** @return non-empty-string|null */ public function getFileName() : ?string { return $this->locatedSource->getFileName(); } public function getLocatedSource() : LocatedSource { return $this->locatedSource; } /** * Get the line number that this constant starts on. * * @return positive-int */ public function getStartLine() : int { return $this->startLine; } /** * Get the line number that this constant ends on. * * @return positive-int */ public function getEndLine() : int { return $this->endLine; } /** @return positive-int */ public function getStartColumn() : int { return $this->startColumn; } /** @return positive-int */ public function getEndColumn() : int { return $this->endColumn; } /** @return non-empty-string|null */ public function getDocComment() : ?string { return $this->docComment; } /** @return non-empty-string */ public function __toString() : string { return ReflectionConstantStringCast::toString($this); } /** * @param \PhpParser\Node\Stmt\Const_|\PhpParser\Node\Expr\FuncCall $node */ private function setNamesFromNode($node, ?int $positionInNode) : void { if ($node instanceof Node\Expr\FuncCall) { $name = $this->getNameFromDefineFunctionCall($node); $nameParts = explode('\\', $name); $this->namespace = implode('\\', array_slice($nameParts, 0, -1)) ?: null; $shortName = $nameParts[count($nameParts) - 1]; assert($shortName !== ''); } else { /** @psalm-suppress PossiblyNullArrayOffset */ $constNode = $node->consts[$positionInNode]; $namespacedName = $constNode->namespacedName; assert($namespacedName instanceof Node\Name); $name = $namespacedName->toString(); assert($name !== ''); $shortName = $constNode->name->name; assert($shortName !== ''); } $this->name = $name; $this->shortName = $shortName; } /** @return non-empty-string */ private function getNameFromDefineFunctionCall(Node\Expr\FuncCall $node) : string { $argumentNameNode = $node->args[0]; assert($argumentNameNode instanceof Node\Arg); $nameNode = $argumentNameNode->value; assert($nameNode instanceof Node\Scalar\String_); /** @psalm-var non-empty-string */ return $nameNode->value; } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflector; use PHPStan\BetterReflection\Reflection\ReflectionClass; use PHPStan\BetterReflection\Reflection\ReflectionConstant; use PHPStan\BetterReflection\Reflection\ReflectionFunction; use PHPStan\BetterReflection\Reflector\Exception\IdentifierNotFound; use PHPStan\BetterReflection\SourceLocator\Type\SourceLocator; /** * @deprecated Use Roave\BetterReflection\Reflector\Reflector instead. */ class ConstantReflector implements \PHPStan\BetterReflection\Reflector\Reflector { /** @var Reflector */ private $reflector; public function __construct(SourceLocator $sourceLocator) { $this->reflector = new \PHPStan\BetterReflection\Reflector\DefaultReflector($sourceLocator); } /** * Create a ReflectionFunction for the specified $functionName. * * @throws IdentifierNotFound */ public function reflect(string $constantName) : ReflectionConstant { return $this->reflector->reflectConstant($constantName); } /** * Get all the classes available in the scope specified by the SourceLocator. * * @return ReflectionConstant[] */ public function getAllConstants() : array { return $this->reflector->reflectAllConstants(); } public function reflectClass(string $identifierName) : ReflectionClass { return $this->reflector->reflectClass($identifierName); } /** * @return list<ReflectionClass> */ public function reflectAllClasses() : iterable { return $this->reflector->reflectAllClasses(); } public function reflectFunction(string $identifierName) : ReflectionFunction { return $this->reflector->reflectFunction($identifierName); } /** * @return list<ReflectionFunction> */ public function reflectAllFunctions() : iterable { return $this->reflector->reflectAllFunctions(); } public function reflectConstant(string $identifierName) : ReflectionConstant { return $this->reflector->reflectConstant($identifierName); } /** * @return list<ReflectionConstant> */ public function reflectAllConstants() : iterable { return $this->reflector->reflectAllConstants(); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflector; use PHPStan\BetterReflection\Reflection\ReflectionClass; use PHPStan\BetterReflection\Reflection\ReflectionConstant; use PHPStan\BetterReflection\Reflection\ReflectionFunction; use PHPStan\BetterReflection\Reflector\Exception\IdentifierNotFound; use PHPStan\BetterReflection\SourceLocator\Type\SourceLocator; /** * @deprecated Use Roave\BetterReflection\Reflector\Reflector instead. */ class FunctionReflector implements \PHPStan\BetterReflection\Reflector\Reflector { /** @var Reflector */ private $reflector; public function __construct(SourceLocator $sourceLocator) { $this->reflector = new \PHPStan\BetterReflection\Reflector\DefaultReflector($sourceLocator); } /** * Create a ReflectionFunction for the specified $functionName. * * @throws IdentifierNotFound */ public function reflect(string $functionName) : ReflectionFunction { return $this->reflector->reflectFunction($functionName); } /** * Get all the classes available in the scope specified by the SourceLocator. * * @return ReflectionFunction[] */ public function getAllFunctions() : array { return $this->reflector->reflectAllFunctions(); } public function reflectClass(string $identifierName) : ReflectionClass { return $this->reflector->reflectClass($identifierName); } /** * @return list<ReflectionClass> */ public function reflectAllClasses() : iterable { return $this->reflector->reflectAllClasses(); } public function reflectFunction(string $identifierName) : ReflectionFunction { return $this->reflector->reflectFunction($identifierName); } /** * @return list<ReflectionFunction> */ public function reflectAllFunctions() : iterable { return $this->reflector->reflectAllFunctions(); } public function reflectConstant(string $identifierName) : ReflectionConstant { return $this->reflector->reflectConstant($identifierName); } /** * @return list<ReflectionConstant> */ public function reflectAllConstants() : iterable { return $this->reflector->reflectAllConstants(); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflector; use PHPStan\BetterReflection\Identifier\Identifier; use PHPStan\BetterReflection\Identifier\IdentifierType; use PHPStan\BetterReflection\Reflection\ReflectionClass; use PHPStan\BetterReflection\Reflection\ReflectionConstant; use PHPStan\BetterReflection\Reflection\ReflectionFunction; use PHPStan\BetterReflection\Reflector\Exception\IdentifierNotFound; use PHPStan\BetterReflection\SourceLocator\Type\SourceLocator; use function assert; final class DefaultReflector implements \PHPStan\BetterReflection\Reflector\Reflector { /** * @var \PHPStan\BetterReflection\SourceLocator\Type\SourceLocator */ private $sourceLocator; public function __construct(SourceLocator $sourceLocator) { $this->sourceLocator = $sourceLocator; } /** * Create a ReflectionClass for the specified $className. * * @throws IdentifierNotFound */ public function reflectClass(string $identifierName) : ReflectionClass { $identifier = new Identifier($identifierName, new IdentifierType(IdentifierType::IDENTIFIER_CLASS)); $classInfo = $this->sourceLocator->locateIdentifier($this, $identifier); if ($classInfo === null) { throw \PHPStan\BetterReflection\Reflector\Exception\IdentifierNotFound::fromIdentifier($identifier); } assert($classInfo instanceof ReflectionClass); return $classInfo; } /** * Get all the classes available in the scope specified by the SourceLocator. * * @return list<ReflectionClass> */ public function reflectAllClasses() : iterable { /** @var list<ReflectionClass> $allClasses */ $allClasses = $this->sourceLocator->locateIdentifiersByType($this, new IdentifierType(IdentifierType::IDENTIFIER_CLASS)); return $allClasses; } /** * Create a ReflectionFunction for the specified $functionName. * * @throws IdentifierNotFound */ public function reflectFunction(string $identifierName) : ReflectionFunction { $identifier = new Identifier($identifierName, new IdentifierType(IdentifierType::IDENTIFIER_FUNCTION)); $functionInfo = $this->sourceLocator->locateIdentifier($this, $identifier); if ($functionInfo === null) { throw \PHPStan\BetterReflection\Reflector\Exception\IdentifierNotFound::fromIdentifier($identifier); } assert($functionInfo instanceof ReflectionFunction); return $functionInfo; } /** * Get all the functions available in the scope specified by the SourceLocator. * * @return list<ReflectionFunction> */ public function reflectAllFunctions() : iterable { /** @var list<ReflectionFunction> $allFunctions */ $allFunctions = $this->sourceLocator->locateIdentifiersByType($this, new IdentifierType(IdentifierType::IDENTIFIER_FUNCTION)); return $allFunctions; } /** * Create a ReflectionConstant for the specified $constantName. * * @throws IdentifierNotFound */ public function reflectConstant(string $identifierName) : ReflectionConstant { $identifier = new Identifier($identifierName, new IdentifierType(IdentifierType::IDENTIFIER_CONSTANT)); $constantInfo = $this->sourceLocator->locateIdentifier($this, $identifier); if ($constantInfo === null) { throw \PHPStan\BetterReflection\Reflector\Exception\IdentifierNotFound::fromIdentifier($identifier); } assert($constantInfo instanceof ReflectionConstant); return $constantInfo; } /** * Get all the constants available in the scope specified by the SourceLocator. * * @return list<ReflectionConstant> */ public function reflectAllConstants() : iterable { /** @var list<ReflectionConstant> $allConstants */ $allConstants = $this->sourceLocator->locateIdentifiersByType($this, new IdentifierType(IdentifierType::IDENTIFIER_CONSTANT)); return $allConstants; } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflector\Exception; use PHPStan\BetterReflection\Identifier\Identifier; use RuntimeException; use function sprintf; class IdentifierNotFound extends RuntimeException { /** * @var \PHPStan\BetterReflection\Identifier\Identifier */ private $identifier; public function __construct(string $message, Identifier $identifier) { $this->identifier = $identifier; parent::__construct($message); } public function getIdentifier() : Identifier { return $this->identifier; } public static function fromIdentifier(Identifier $identifier) : self { return new self(sprintf('%s "%s" could not be found in the located source', $identifier->getType()->getName(), $identifier->getName()), $identifier); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflector; use PHPStan\BetterReflection\Reflection\ReflectionClass; use PHPStan\BetterReflection\Reflection\ReflectionConstant; use PHPStan\BetterReflection\Reflection\ReflectionFunction; use PHPStan\BetterReflection\Reflector\Exception\IdentifierNotFound; interface Reflector { /** * Create a ReflectionClass for the specified $className. * * @throws IdentifierNotFound */ public function reflectClass(string $identifierName) : ReflectionClass; /** * Get all the classes available in the scope specified by the SourceLocator. * * @return list<ReflectionClass> */ public function reflectAllClasses() : iterable; /** * Create a ReflectionFunction for the specified $functionName. * * @throws IdentifierNotFound */ public function reflectFunction(string $identifierName) : ReflectionFunction; /** * Get all the functions available in the scope specified by the SourceLocator. * * @return list<ReflectionFunction> */ public function reflectAllFunctions() : iterable; /** * Create a ReflectionConstant for the specified $constantName. * * @throws IdentifierNotFound */ public function reflectConstant(string $identifierName) : ReflectionConstant; /** * Get all the constants available in the scope specified by the SourceLocator. * * @return list<ReflectionConstant> */ public function reflectAllConstants() : iterable; } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Reflector; use PHPStan\BetterReflection\Reflection\ReflectionClass; use PHPStan\BetterReflection\Reflection\ReflectionConstant; use PHPStan\BetterReflection\Reflection\ReflectionFunction; use PHPStan\BetterReflection\Reflector\Exception\IdentifierNotFound; use PHPStan\BetterReflection\SourceLocator\Type\SourceLocator; /** * @deprecated Use Roave\BetterReflection\Reflector\Reflector instead. */ class ClassReflector implements \PHPStan\BetterReflection\Reflector\Reflector { /** @var Reflector */ private $reflector; public function __construct(SourceLocator $sourceLocator) { $this->reflector = new \PHPStan\BetterReflection\Reflector\DefaultReflector($sourceLocator); } /** * Create a ReflectionClass for the specified $className. * * @throws IdentifierNotFound */ public function reflect(string $className) : ReflectionClass { return $this->reflector->reflectClass($className); } /** * Get all the classes available in the scope specified by the SourceLocator. * * @return ReflectionClass[] */ public function getAllClasses() : array { return $this->reflector->reflectAllClasses(); } public function reflectClass(string $identifierName) : ReflectionClass { return $this->reflector->reflectClass($identifierName); } /** * @return list<ReflectionClass> */ public function reflectAllClasses() : iterable { return $this->reflector->reflectAllClasses(); } public function reflectFunction(string $identifierName) : ReflectionFunction { return $this->reflector->reflectFunction($identifierName); } /** * @return list<ReflectionFunction> */ public function reflectAllFunctions() : iterable { return $this->reflector->reflectAllFunctions(); } public function reflectConstant(string $identifierName) : ReflectionConstant { return $this->reflector->reflectConstant($identifierName); } /** * @return list<ReflectionConstant> */ public function reflectAllConstants() : iterable { return $this->reflector->reflectAllConstants(); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Util; use function class_exists; use function interface_exists; use function trait_exists; /** @internal */ class ClassExistenceChecker { /** @psalm-assert-if-true class-string $name */ public static function exists(string $name, bool $autoload) : bool { return self::classExists($name, $autoload) || self::interfaceExists($name, $autoload) || self::traitExists($name, $autoload); } public static function classExists(string $name, bool $autoload) : bool { return class_exists($name, $autoload); } public static function interfaceExists(string $name, bool $autoload) : bool { return interface_exists($name, $autoload); } public static function traitExists(string $name, bool $autoload) : bool { return trait_exists($name, $autoload); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Util; use InvalidArgumentException; use PHPStan\BetterReflection\Identifier\IdentifierType; use PHPStan\BetterReflection\Reflection\Reflection; use PHPStan\BetterReflection\Reflection\ReflectionClass; use PHPStan\BetterReflection\Reflection\ReflectionConstant; use PHPStan\BetterReflection\Reflection\ReflectionFunction; use PHPStan\BetterReflection\Reflection\ReflectionMethod; use PHPStan\BetterReflection\Reflector\DefaultReflector; use PHPStan\BetterReflection\SourceLocator\Ast\Exception\ParseToAstFailure; use PHPStan\BetterReflection\SourceLocator\Ast\Locator; use PHPStan\BetterReflection\SourceLocator\Exception\InvalidFileLocation; use PHPStan\BetterReflection\SourceLocator\Type\AggregateSourceLocator; use PHPStan\BetterReflection\SourceLocator\Type\SingleFileSourceLocator; use PHPStan\BetterReflection\SourceLocator\Type\SourceLocator; use function array_merge; final class FindReflectionOnLine { /** * @var \PHPStan\BetterReflection\SourceLocator\Type\SourceLocator */ private $sourceLocator; /** * @var \PHPStan\BetterReflection\SourceLocator\Ast\Locator */ private $astLocator; public function __construct(SourceLocator $sourceLocator, Locator $astLocator) { $this->sourceLocator = $sourceLocator; $this->astLocator = $astLocator; } /** * Find a reflection on the specified line number. * * Returns null if no reflections found on the line. * * @param non-empty-string $filename * * @throws InvalidFileLocation * @throws ParseToAstFailure * @throws InvalidArgumentException * @return \PHPStan\BetterReflection\Reflection\ReflectionMethod|\PHPStan\BetterReflection\Reflection\ReflectionClass|\PHPStan\BetterReflection\Reflection\ReflectionFunction|\PHPStan\BetterReflection\Reflection\ReflectionConstant|\PHPStan\BetterReflection\Reflection\Reflection|null */ public function __invoke(string $filename, int $lineNumber) { $reflections = $this->computeReflections($filename); foreach ($reflections as $reflection) { if ($reflection instanceof ReflectionClass && $this->containsLine($reflection, $lineNumber)) { foreach ($reflection->getMethods() as $method) { if ($this->containsLine($method, $lineNumber)) { return $method; } } return $reflection; } if ($reflection instanceof ReflectionFunction && $this->containsLine($reflection, $lineNumber)) { return $reflection; } if ($reflection instanceof ReflectionConstant && $this->containsLine($reflection, $lineNumber)) { return $reflection; } } return null; } /** * Find all class and function reflections in the specified file * * @param non-empty-string $filename * * @return list<Reflection> * * @throws ParseToAstFailure * @throws InvalidFileLocation */ private function computeReflections(string $filename) : array { $singleFileSourceLocator = new SingleFileSourceLocator($filename, $this->astLocator); $reflector = new DefaultReflector(new AggregateSourceLocator([$singleFileSourceLocator, $this->sourceLocator])); return array_merge($singleFileSourceLocator->locateIdentifiersByType($reflector, new IdentifierType(IdentifierType::IDENTIFIER_CLASS)), $singleFileSourceLocator->locateIdentifiersByType($reflector, new IdentifierType(IdentifierType::IDENTIFIER_FUNCTION)), $singleFileSourceLocator->locateIdentifiersByType($reflector, new IdentifierType(IdentifierType::IDENTIFIER_CONSTANT))); } /** * Check to see if the line is within the boundaries of the reflection specified. * @param \PHPStan\BetterReflection\Reflection\ReflectionClass|\PHPStan\BetterReflection\Reflection\ReflectionMethod|\PHPStan\BetterReflection\Reflection\ReflectionFunction|\PHPStan\BetterReflection\Reflection\ReflectionConstant $reflection */ private function containsLine($reflection, int $lineNumber) : bool { return $lineNumber >= $reflection->getStartLine() && $lineNumber <= $reflection->getEndLine(); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Util; use PhpParser\Node; use PHPStan\BetterReflection\Util\Exception\InvalidNodePosition; use PHPStan\BetterReflection\Util\Exception\NoNodePosition; use function strlen; use function strrpos; /** @internal */ final class CalculateReflectionColumn { /** * @throws InvalidNodePosition * @throws NoNodePosition * * @psalm-pure */ public static function getStartColumn(string $source, Node $node) : int { if (!$node->hasAttribute('startFilePos')) { return -1; } return self::calculateColumn($source, $node->getStartFilePos()); } /** * @throws InvalidNodePosition * @throws NoNodePosition * * @psalm-pure */ public static function getEndColumn(string $source, Node $node) : int { if (!$node->hasAttribute('endFilePos')) { return -1; } return self::calculateColumn($source, $node->getEndFilePos()); } /** * @throws InvalidNodePosition * * @psalm-pure */ private static function calculateColumn(string $source, int $position) : int { $sourceLength = strlen($source); if ($position >= $sourceLength) { return -1; } $lineStartPosition = strrpos($source, "\n", $position - $sourceLength); /** @psalm-var positive-int */ return $lineStartPosition === \false ? $position + 1 : $position - $lineStartPosition; } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Util\Exception; use InvalidArgumentException; use PhpParser\Lexer; use PhpParser\Node; use function sprintf; class NoNodePosition extends InvalidArgumentException { public static function fromNode(Node $node) : self { return new self(sprintf('%s doesn\'t contain position. Your %s is not configured properly', \get_class($node), Lexer::class)); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Util\Exception; use InvalidArgumentException; use function sprintf; class InvalidNodePosition extends InvalidArgumentException { public static function fromPosition(int $position) : self { return new self(sprintf('Invalid position %d', $position)); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Util; use PhpParser\Node; use PHPStan\BetterReflection\Reflection\Exception\InvalidConstantNode; use function count; use function in_array; /** @internal */ final class ConstantNodeChecker { private const DEFINE_ARGUMENTS_COUNTS = [2, 3]; /** @throws InvalidConstantNode */ public static function assertValidDefineFunctionCall(Node\Expr\FuncCall $node) : void { if (!$node->name instanceof Node\Name) { throw InvalidConstantNode::create($node); } if ($node->name->toLowerString() !== 'define') { throw InvalidConstantNode::create($node); } if (!in_array(count($node->args), self::DEFINE_ARGUMENTS_COUNTS, \true)) { throw InvalidConstantNode::create($node); } if (!$node->args[0] instanceof Node\Arg || !$node->args[0]->value instanceof Node\Scalar\String_) { throw InvalidConstantNode::create($node); } if (!$node->args[1] instanceof Node\Arg) { throw InvalidConstantNode::create($node); } $valueNode = $node->args[1]->value; if ($valueNode instanceof Node\Expr\FuncCall && !($valueNode->name instanceof Node\Name && $valueNode->name->toLowerString() === 'constant')) { throw InvalidConstantNode::create($node); } if ($valueNode instanceof Node\Expr\Variable) { throw InvalidConstantNode::create($node); } } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Util; use function array_pop; use function assert; use function explode; use function implode; use function is_string; use function preg_match; use function sprintf; use function str_replace; use function strpos; use function substr; use function trim; use const DIRECTORY_SEPARATOR; class FileHelper { /** * @param non-empty-string $path * * @return non-empty-string * * @psalm-pure */ public static function normalizeWindowsPath(string $path) : string { $path = str_replace('\\', '/', $path); assert($path !== ''); return $path; } /** * @param non-empty-string $originalPath * * @return non-empty-string * * @psalm-pure */ public static function normalizePath(string $originalPath, string $directorySeparator = DIRECTORY_SEPARATOR) : string { $isLocalPath = $originalPath !== '' && $originalPath[0] === '/'; $matches = null; if (!$isLocalPath) { if (!preg_match('~^([a-z]+)\\:\\/\\/(.+)~', $originalPath, $matches)) { $matches = null; } } if ($matches !== null) { [, $scheme, $path] = $matches; } else { $scheme = null; $path = $originalPath; } $path = str_replace(['\\', '//', '///', '////'], '/', $path); $pathRoot = strpos($path, '/') === 0 ? $directorySeparator : ''; $pathParts = explode('/', trim($path, '/')); $normalizedPathParts = []; foreach ($pathParts as $pathPart) { if ($pathPart === '.') { continue; } if ($pathPart === '..') { $removedPart = array_pop($normalizedPathParts); assert(is_string($removedPart)); if ($scheme === 'phar' && substr($removedPart, -5) === '.phar') { $scheme = null; } } else { $normalizedPathParts[] = $pathPart; } } return ($scheme !== null ? $scheme . '://' : '') . $pathRoot . implode($directorySeparator, $normalizedPathParts); } public static function normalizeSystemPath(string $originalPath) : string { $path = self::normalizeWindowsPath($originalPath); preg_match('~^([a-z]+)\\:\\/\\/(.+)~', $path, $matches); $scheme = null; if ($matches !== []) { [, $scheme, $path] = $matches; } // @infection-ignore-all Identical Needed only on Windows if (DIRECTORY_SEPARATOR === '\\') { // @infection-ignore-all UnwrapStrReplace Needed only on Windows $path = str_replace('/', DIRECTORY_SEPARATOR, $path); } assert($path !== ''); return ($scheme !== null ? sprintf('%s://', $scheme) : '') . $path; } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\Util; use PhpParser\NodeAbstract; use function assert; use function is_string; /** @internal */ final class GetLastDocComment { /** * @return non-empty-string|null * * @psalm-pure */ public static function forNode(NodeAbstract $node) : ?string { /** @psalm-suppress ImpureMethodCall */ $docComment = $node->getDocComment(); if ($docComment === null) { return null; } /** @psalm-suppress ImpureMethodCall */ $comment = $docComment->getReformattedText(); assert(is_string($comment) && $comment !== ''); return $comment; } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\NodeCompiler; /** @internal */ class CompiledValue { /** * @var mixed */ public $value; /** * @var string|null */ public $constantName = null; /** * @param mixed $value */ public function __construct($value, ?string $constantName = null) { $this->value = $value; $this->constantName = $constantName; } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\NodeCompiler\Exception; use LogicException; use PhpParser\Node; use PHPStan\BetterReflection\NodeCompiler\CompilerContext; use PHPStan\BetterReflection\Reflection\ReflectionClass; use PHPStan\BetterReflection\Util\FileHelper; use function assert; use function sprintf; /** @internal */ class UnableToCompileNode extends LogicException { /** * @var string|null */ private $constantName = null; public function constantName() : ?string { return $this->constantName; } public static function forUnRecognizedExpressionInContext(Node\Expr $expression, CompilerContext $context) : self { return new self(sprintf('Unable to compile expression in %s: unrecognized node type %s in file %s (line %d)', self::compilerContextToContextDescription($context), \get_class($expression), self::getFileName($context), $expression->getLine())); } public static function becauseOfNotFoundClassConstantReference(CompilerContext $fetchContext, ReflectionClass $targetClass, Node\Expr\ClassConstFetch $constantFetch) : self { assert($constantFetch->name instanceof Node\Identifier); return new self(sprintf('Could not locate constant %s::%s while trying to evaluate constant expression in %s in file %s (line %d)', $targetClass->getName(), $constantFetch->name->name, self::compilerContextToContextDescription($fetchContext), self::getFileName($fetchContext), $constantFetch->getLine())); } public static function becauseOfNotFoundConstantReference(CompilerContext $fetchContext, Node\Expr\ConstFetch $constantFetch, string $constantName) : self { $exception = new self(sprintf('Could not locate constant "%s" while evaluating expression in %s in file %s (line %d)', $constantName, self::compilerContextToContextDescription($fetchContext), self::getFileName($fetchContext), $constantFetch->getLine())); $exception->constantName = $constantName; return $exception; } public static function becauseOfInvalidEnumCasePropertyFetch(CompilerContext $fetchContext, ReflectionClass $targetClass, Node\Expr\PropertyFetch $propertyFetch) : self { assert($propertyFetch->var instanceof Node\Expr\ClassConstFetch); assert($propertyFetch->var->name instanceof Node\Identifier); assert($propertyFetch->name instanceof Node\Identifier); return new self(sprintf('Could not get %s::%s->%s while trying to evaluate constant expression in %s in file %s (line %d)', $targetClass->getName(), $propertyFetch->var->name->name, $propertyFetch->name->toString(), self::compilerContextToContextDescription($fetchContext), self::getFileName($fetchContext), $propertyFetch->getLine())); } /** * @param \PhpParser\Node\Scalar\MagicConst\Dir|\PhpParser\Node\Scalar\MagicConst\File $node */ public static function becauseOfMissingFileName(CompilerContext $context, $node) : self { return new self(sprintf('No file name for %s (line %d)', self::compilerContextToContextDescription($context), $node->getLine())); } public static function becauseOfNonexistentFile(CompilerContext $context, string $fileName) : self { return new self(sprintf('File not found for %s: %s', self::compilerContextToContextDescription($context), $fileName)); } public static function becauseOfClassCannotBeLoaded(CompilerContext $context, Node\Expr\New_ $newNode, string $className) : self { return new self(sprintf('Cound not load class "%s" while evaluating expression in %s in file %s (line %d)', $className, self::compilerContextToContextDescription($context), self::getFileName($context), $newNode->getLine())); } public static function becauseOfValueIsEnum(CompilerContext $fetchContext, ReflectionClass $targetClass, Node\Expr\ClassConstFetch $constantFetch) : self { assert($constantFetch->name instanceof Node\Identifier); return new self(sprintf('An enum expression %s::%s is not supported in %s in file %s (line %d)', $targetClass->getName(), $constantFetch->name->name, self::compilerContextToContextDescription($fetchContext), self::getFileName($fetchContext), $constantFetch->getLine())); } private static function getFileName(CompilerContext $fetchContext) : string { $fileName = $fetchContext->getFileName(); return $fileName !== null ? FileHelper::normalizeWindowsPath($fileName) : '""'; } private static function compilerContextToContextDescription(CompilerContext $fetchContext) : string { $class = $fetchContext->getClass(); $function = $fetchContext->getFunction(); if ($class !== null && $function !== null) { return sprintf('method %s::%s()', $class->getName(), $function->getName()); } if ($class !== null) { return sprintf('class %s', $class->getName()); } if ($function !== null) { return sprintf('function %s()', $function->getName()); } $namespace = $fetchContext->getNamespace(); if ($namespace !== null) { return sprintf('namespace %s', $namespace); } return 'global namespace'; } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\NodeCompiler; use PhpParser\ConstExprEvaluator; use PhpParser\Node; use PHPStan\BetterReflection\Reflection\ReflectionClass; use PHPStan\BetterReflection\Reflection\ReflectionClassConstant; use PHPStan\BetterReflection\Reflection\ReflectionEnum; use PHPStan\BetterReflection\Reflector\Exception\IdentifierNotFound; use function array_map; use function assert; use function class_exists; use function constant; use function defined; use function dirname; use function explode; use function in_array; use function is_file; use function sprintf; /** @internal */ class CompileNodeToValue { private const TRUE_FALSE_NULL = ['true', 'false', 'null']; /** * Compile an expression from a node into a value. * * @param Node\Stmt\Expression|Node\Expr $node Node has to be processed by the PhpParser\NodeVisitor\NameResolver * * @throws Exception\UnableToCompileNode */ public function __invoke(Node $node, \PHPStan\BetterReflection\NodeCompiler\CompilerContext $context) : \PHPStan\BetterReflection\NodeCompiler\CompiledValue { if ($node instanceof Node\Stmt\Expression) { return $this($node->expr, $context); } $constantName = null; if ($node instanceof Node\Expr\ConstFetch && !in_array($node->name->toLowerString(), self::TRUE_FALSE_NULL, \true)) { $constantName = $this->resolveConstantName($node, $context); } elseif ($node instanceof Node\Expr\ClassConstFetch) { $constantName = $this->resolveClassConstantName($node, $context); } $constExprEvaluator = new ConstExprEvaluator(function (Node\Expr $node) use($context, $constantName) { if ($node instanceof Node\Expr\ConstFetch) { return $this->getConstantValue($node, $constantName, $context); } if ($node instanceof Node\Expr\ClassConstFetch) { return $this->getClassConstantValue($node, $constantName, $context); } if ($node instanceof Node\Expr\New_) { return $this->compileNew($node, $context); } if ($node instanceof Node\Scalar\MagicConst\Dir) { return $this->compileDirConstant($context, $node); } if ($node instanceof Node\Scalar\MagicConst\File) { return $this->compileFileConstant($context, $node); } if ($node instanceof Node\Scalar\MagicConst\Class_) { return $this->compileClassConstant($context); } if ($node instanceof Node\Scalar\MagicConst\Line) { return $node->getLine(); } if ($node instanceof Node\Scalar\MagicConst\Namespace_) { return $context->getNamespace() ?? ''; } if ($node instanceof Node\Scalar\MagicConst\Method) { $class = $context->getClass(); $function = $context->getFunction(); if ($class !== null && $function !== null) { return sprintf('%s::%s', $class->getName(), $function->getName()); } if ($function !== null) { return $function->getName(); } return ''; } if ($node instanceof Node\Scalar\MagicConst\Function_) { return (($getFunction = $context->getFunction()) ? $getFunction->getName() : null) ?? ''; } if ($node instanceof Node\Scalar\MagicConst\Trait_) { $class = $context->getClass(); if ($class !== null && $class->isTrait()) { return $class->getName(); } return ''; } if ($node instanceof Node\Expr\FuncCall && $node->name instanceof Node\Name && $node->name->toLowerString() === 'constant' && $node->args[0] instanceof Node\Arg && $node->args[0]->value instanceof Node\Scalar\String_ && defined($node->args[0]->value->value)) { return constant($node->args[0]->value->value); } if ($node instanceof Node\Expr\PropertyFetch && $node->var instanceof Node\Expr\ClassConstFetch) { return $this->getEnumPropertyValue($node, $context); } throw \PHPStan\BetterReflection\NodeCompiler\Exception\UnableToCompileNode::forUnRecognizedExpressionInContext($node, $context); }); /** @psalm-var mixed $value */ $value = $constExprEvaluator->evaluateDirectly($node); return new \PHPStan\BetterReflection\NodeCompiler\CompiledValue($value, $constantName); } /** * @return mixed */ private function getEnumPropertyValue(Node\Expr\PropertyFetch $node, \PHPStan\BetterReflection\NodeCompiler\CompilerContext $context) { assert($node->var instanceof Node\Expr\ClassConstFetch); assert($node->var->class instanceof Node\Name); $className = $this->resolveClassName($node->var->class->toString(), $context); $class = $context->getReflector()->reflectClass($className); if (!$class instanceof ReflectionEnum) { throw \PHPStan\BetterReflection\NodeCompiler\Exception\UnableToCompileNode::becauseOfInvalidEnumCasePropertyFetch($context, $class, $node); } assert($node->var->name instanceof Node\Identifier); $caseName = $node->var->name->name; assert($caseName !== ''); $case = $class->getCase($caseName); if ($case === null) { throw \PHPStan\BetterReflection\NodeCompiler\Exception\UnableToCompileNode::becauseOfInvalidEnumCasePropertyFetch($context, $class, $node); } assert($node->name instanceof Node\Identifier); switch ($node->name->toString()) { case 'value': return $case->getValue(); case 'name': return $case->getName(); default: throw \PHPStan\BetterReflection\NodeCompiler\Exception\UnableToCompileNode::becauseOfInvalidEnumCasePropertyFetch($context, $class, $node); } } private function resolveConstantName(Node\Expr\ConstFetch $constNode, \PHPStan\BetterReflection\NodeCompiler\CompilerContext $context) : string { $constantName = $constNode->name->toString(); $namespace = $context->getNamespace() ?? ''; if ($constNode->name->isUnqualified()) { $namespacedConstantName = sprintf('%s\\%s', $namespace, $constantName); if ($this->constantExists($namespacedConstantName, $context)) { return $namespacedConstantName; } } if ($this->constantExists($constantName, $context)) { return $constantName; } throw \PHPStan\BetterReflection\NodeCompiler\Exception\UnableToCompileNode::becauseOfNotFoundConstantReference($context, $constNode, $constantName); } private function constantExists(string $constantName, \PHPStan\BetterReflection\NodeCompiler\CompilerContext $context) : bool { if (defined($constantName)) { return \true; } try { $context->getReflector()->reflectConstant($constantName); return \true; } catch (IdentifierNotFound $exception) { return \false; } } /** * @return mixed */ private function getConstantValue(Node\Expr\ConstFetch $node, ?string $constantName, \PHPStan\BetterReflection\NodeCompiler\CompilerContext $context) { // It's not resolved when constant value is expression // @infection-ignore-all Assignment, AssignCoalesce: There's no difference, ??= is just optimization $constantName = $constantName ?? $this->resolveConstantName($node, $context); if (defined($constantName)) { return constant($constantName); } return $context->getReflector()->reflectConstant($constantName)->getValue(); } private function resolveClassConstantName(Node\Expr\ClassConstFetch $node, \PHPStan\BetterReflection\NodeCompiler\CompilerContext $context) : string { assert($node->name instanceof Node\Identifier); $constantName = $node->name->name; assert($node->class instanceof Node\Name); $className = $node->class->toString(); return sprintf('%s::%s', $this->resolveClassName($className, $context), $constantName); } /** * @return mixed */ private function getClassConstantValue(Node\Expr\ClassConstFetch $node, ?string $classConstantName, \PHPStan\BetterReflection\NodeCompiler\CompilerContext $context) { // It's not resolved when constant value is expression // @infection-ignore-all Assignment, AssignCoalesce: There's no difference, ??= is just optimization $classConstantName = $classConstantName ?? $this->resolveClassConstantName($node, $context); [$className, $constantName] = explode('::', $classConstantName); assert($constantName !== ''); if ($constantName === 'class') { return $className; } $classContext = $context->getClass(); $classReflection = $classContext !== null && $classContext->getName() === $className ? $classContext : $context->getReflector()->reflectClass($className); if ($classReflection instanceof ReflectionEnum) { if ($classReflection->hasCase($constantName)) { return constant(sprintf('%s::%s', $className, $constantName)); } } if ($classReflection instanceof ReflectionEnum) { if ($classReflection->hasCase($constantName)) { throw \PHPStan\BetterReflection\NodeCompiler\Exception\UnableToCompileNode::becauseOfValueIsEnum($context, $classReflection, $node); } } $reflectionConstant = $classReflection->getConstant($constantName); if (!$reflectionConstant instanceof ReflectionClassConstant) { throw \PHPStan\BetterReflection\NodeCompiler\Exception\UnableToCompileNode::becauseOfNotFoundClassConstantReference($context, $classReflection, $node); } return $reflectionConstant->getValue(); } private function compileNew(Node\Expr\New_ $node, \PHPStan\BetterReflection\NodeCompiler\CompilerContext $context) : object { assert($node->class instanceof Node\Name); /** @psalm-var class-string $className */ $className = $node->class->toString(); if (!class_exists($className)) { throw \PHPStan\BetterReflection\NodeCompiler\Exception\UnableToCompileNode::becauseOfClassCannotBeLoaded($context, $node, $className); } $arguments = []; foreach ($node->args as $argNo => $arg) { $arguments[(($argName = $arg->name) ? $argName->toString() : null) ?? $argNo] = $this($arg->value, $context)->value; } return new $className(...$arguments); } /** * Compile a __DIR__ node */ private function compileDirConstant(\PHPStan\BetterReflection\NodeCompiler\CompilerContext $context, Node\Scalar\MagicConst\Dir $node) : string { $fileName = $context->getFileName(); if ($fileName === null) { throw \PHPStan\BetterReflection\NodeCompiler\Exception\UnableToCompileNode::becauseOfMissingFileName($context, $node); } if (!is_file($fileName)) { throw \PHPStan\BetterReflection\NodeCompiler\Exception\UnableToCompileNode::becauseOfNonexistentFile($context, $fileName); } return dirname($fileName); } /** * Compile a __FILE__ node */ private function compileFileConstant(\PHPStan\BetterReflection\NodeCompiler\CompilerContext $context, Node\Scalar\MagicConst\File $node) : string { $fileName = $context->getFileName(); if ($fileName === null) { throw \PHPStan\BetterReflection\NodeCompiler\Exception\UnableToCompileNode::becauseOfMissingFileName($context, $node); } if (!is_file($fileName)) { throw \PHPStan\BetterReflection\NodeCompiler\Exception\UnableToCompileNode::becauseOfNonexistentFile($context, $fileName); } return $fileName; } /** * Compiles magic constant __CLASS__ */ private function compileClassConstant(\PHPStan\BetterReflection\NodeCompiler\CompilerContext $context) : string { return (($getClass = $context->getClass()) ? $getClass->getName() : null) ?? ''; } private function resolveClassName(string $className, \PHPStan\BetterReflection\NodeCompiler\CompilerContext $context) : string { if ($className !== 'self' && $className !== 'static' && $className !== 'parent') { return $className; } $classContext = $context->getClass(); assert($classContext !== null); if ($className !== 'parent') { return $classContext->getName(); } $parentClass = $classContext->getParentClass(); assert($parentClass instanceof ReflectionClass); return $parentClass->getName(); } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection\NodeCompiler; use PHPStan\BetterReflection\Reflection\ReflectionClass; use PHPStan\BetterReflection\Reflection\ReflectionClassConstant; use PHPStan\BetterReflection\Reflection\ReflectionConstant; use PHPStan\BetterReflection\Reflection\ReflectionEnumCase; use PHPStan\BetterReflection\Reflection\ReflectionFunction; use PHPStan\BetterReflection\Reflection\ReflectionMethod; use PHPStan\BetterReflection\Reflection\ReflectionParameter; use PHPStan\BetterReflection\Reflection\ReflectionProperty; use PHPStan\BetterReflection\Reflector\Reflector; use PHPStan\BetterReflection\Util\FileHelper; /** @internal */ class CompilerContext { /** * @var \PHPStan\BetterReflection\Reflector\Reflector */ private $reflector; /** * @var \PHPStan\BetterReflection\Reflection\ReflectionClass|\PHPStan\BetterReflection\Reflection\ReflectionProperty|\PHPStan\BetterReflection\Reflection\ReflectionClassConstant|\PHPStan\BetterReflection\Reflection\ReflectionEnumCase|\PHPStan\BetterReflection\Reflection\ReflectionMethod|\PHPStan\BetterReflection\Reflection\ReflectionFunction|\PHPStan\BetterReflection\Reflection\ReflectionParameter|\PHPStan\BetterReflection\Reflection\ReflectionConstant */ private $contextReflection; /** * @param \PHPStan\BetterReflection\Reflection\ReflectionClass|\PHPStan\BetterReflection\Reflection\ReflectionProperty|\PHPStan\BetterReflection\Reflection\ReflectionClassConstant|\PHPStan\BetterReflection\Reflection\ReflectionEnumCase|\PHPStan\BetterReflection\Reflection\ReflectionMethod|\PHPStan\BetterReflection\Reflection\ReflectionFunction|\PHPStan\BetterReflection\Reflection\ReflectionParameter|\PHPStan\BetterReflection\Reflection\ReflectionConstant $contextReflection */ public function __construct(Reflector $reflector, $contextReflection) { $this->reflector = $reflector; $this->contextReflection = $contextReflection; } public function getReflector() : Reflector { return $this->reflector; } /** @return non-empty-string|null */ public function getFileName() : ?string { if ($this->contextReflection instanceof ReflectionConstant) { $fileName = $this->contextReflection->getFileName(); if ($fileName === null) { return null; } return $this->realPath($fileName); } $fileName = (($getClass = $this->getClass()) ? $getClass->getFileName() : null) ?? (($getFunction = $this->getFunction()) ? $getFunction->getFileName() : null); if ($fileName === null) { return null; } return $this->realPath($fileName); } private function realPath(string $fileName) : string { return FileHelper::normalizePath($fileName, '/'); } public function getNamespace() : ?string { if ($this->contextReflection instanceof ReflectionConstant) { return $this->contextReflection->getNamespaceName(); } // @infection-ignore-all Coalesce: There's no difference return (($getClass = $this->getClass()) ? $getClass->getNamespaceName() : null) ?? (($getFunction = $this->getFunction()) ? $getFunction->getNamespaceName() : null); } public function getClass() : ?\PHPStan\BetterReflection\Reflection\ReflectionClass { if ($this->contextReflection instanceof ReflectionClass) { return $this->contextReflection; } if ($this->contextReflection instanceof ReflectionFunction) { return null; } if ($this->contextReflection instanceof ReflectionConstant) { return null; } if ($this->contextReflection instanceof ReflectionClassConstant) { return $this->contextReflection->getDeclaringClass(); } if ($this->contextReflection instanceof ReflectionEnumCase) { return $this->contextReflection->getDeclaringClass(); } return $this->contextReflection->getImplementingClass(); } /** * @return \PHPStan\BetterReflection\Reflection\ReflectionMethod|\PHPStan\BetterReflection\Reflection\ReflectionFunction|null */ public function getFunction() { if ($this->contextReflection instanceof ReflectionMethod) { return $this->contextReflection; } if ($this->contextReflection instanceof ReflectionFunction) { return $this->contextReflection; } if ($this->contextReflection instanceof ReflectionParameter) { return $this->contextReflection->getDeclaringFunction(); } return null; } } <?php declare (strict_types=1); namespace PHPStan\BetterReflection; use PhpParser\Lexer\Emulative; use PhpParser\Parser; use PhpParser\ParserFactory; use PhpParser\PrettyPrinter\Standard; use PHPStan\BetterReflection\Reflector\DefaultReflector; use PHPStan\BetterReflection\Reflector\Reflector; use PHPStan\BetterReflection\SourceLocator\Ast\Locator as AstLocator; use PHPStan\BetterReflection\SourceLocator\SourceStubber\AggregateSourceStubber; use PHPStan\BetterReflection\SourceLocator\SourceStubber\PhpStormStubsSourceStubber; use PHPStan\BetterReflection\SourceLocator\SourceStubber\ReflectionSourceStubber; use PHPStan\BetterReflection\SourceLocator\SourceStubber\SourceStubber; use PHPStan\BetterReflection\SourceLocator\Type\AggregateSourceLocator; use PHPStan\BetterReflection\SourceLocator\Type\AutoloadSourceLocator; use PHPStan\BetterReflection\SourceLocator\Type\EvaledCodeSourceLocator; use PHPStan\BetterReflection\SourceLocator\Type\MemoizingSourceLocator; use PHPStan\BetterReflection\SourceLocator\Type\PhpInternalSourceLocator; use PHPStan\BetterReflection\SourceLocator\Type\SourceLocator; use PHPStan\BetterReflection\Util\FindReflectionOnLine; use const PHP_VERSION_ID; final class BetterReflection { /** * @var int */ public static $phpVersion = PHP_VERSION_ID; /** * @var \PHPStan\BetterReflection\SourceLocator\Type\SourceLocator|null */ private static $sharedSourceLocator = null; /** * @var \PHPStan\BetterReflection\SourceLocator\Type\SourceLocator|null */ private $sourceLocator = null; /** * @var \PHPStan\BetterReflection\Reflector\Reflector|null */ private static $sharedReflector = null; /** * @var \PHPStan\BetterReflection\Reflector\Reflector|null */ private $reflector = null; /** * @var \PhpParser\Parser|null */ private static $sharedPhpParser = null; /** * @var \PhpParser\Parser|null */ private $phpParser = null; /** * @var AstLocator|null */ private $astLocator = null; /** * @var \PHPStan\BetterReflection\Util\FindReflectionOnLine|null */ private $findReflectionOnLine = null; /** * @var \PHPStan\BetterReflection\SourceLocator\SourceStubber\SourceStubber|null */ private $sourceStubber = null; /** * @var \PHPStan\BetterReflection\SourceLocator\SourceStubber\SourceStubber|null */ private static $sharedSourceStubber = null; /** * @var Standard|null */ private static $sharedPrinter = null; /** * @var Standard|null */ private $printer = null; public static function populate(int $phpVersion, SourceLocator $sourceLocator, Reflector $classReflector, Parser $phpParser, SourceStubber $sourceStubber, Standard $printer) : void { self::$phpVersion = $phpVersion; self::$sharedSourceLocator = $sourceLocator; self::$sharedReflector = $classReflector; self::$sharedPhpParser = $phpParser; self::$sharedSourceStubber = $sourceStubber; self::$sharedPrinter = $printer; } public function __construct() { $this->sourceLocator = self::$sharedSourceLocator; $this->reflector = self::$sharedReflector; $this->phpParser = self::$sharedPhpParser; $this->sourceStubber = self::$sharedSourceStubber; $this->printer = self::$sharedPrinter; } public function sourceLocator() : SourceLocator { $astLocator = $this->astLocator(); $sourceStubber = $this->sourceStubber(); return $this->sourceLocator ?? ($this->sourceLocator = new MemoizingSourceLocator(new AggregateSourceLocator([new PhpInternalSourceLocator($astLocator, $sourceStubber), new EvaledCodeSourceLocator($astLocator, $sourceStubber), new AutoloadSourceLocator($astLocator, $this->phpParser())]))); } public function reflector() : Reflector { return $this->reflector ?? ($this->reflector = new DefaultReflector($this->sourceLocator())); } public function phpParser() : Parser { return $this->phpParser ?? ($this->phpParser = (new ParserFactory())->create(ParserFactory::ONLY_PHP7, new Emulative(['usedAttributes' => ['comments', 'startLine', 'endLine', 'startFilePos', 'endFilePos']]))); } public function astLocator() : AstLocator { return $this->astLocator ?? ($this->astLocator = new AstLocator($this->phpParser())); } public function findReflectionsOnLine() : FindReflectionOnLine { return $this->findReflectionOnLine ?? ($this->findReflectionOnLine = new FindReflectionOnLine($this->sourceLocator(), $this->astLocator())); } public function sourceStubber() : SourceStubber { return $this->sourceStubber ?? ($this->sourceStubber = new AggregateSourceStubber(new PhpStormStubsSourceStubber($this->phpParser(), $this->printer(), self::$phpVersion), new ReflectionSourceStubber($this->printer()))); } public function printer() : Standard { return $this->printer ?? ($this->printer = new Standard(['shortArraySyntax' => \true])); } } { "$schema": "https://docs.renovatebot.com/renovate-schema.json", "extends": [ "local>Ocramius/.github:renovate-config" ] } The MIT License (MIT) Copyright (c) 2012 Christian Lück, Cees-Jan Kiewiet, Jan Sorgalla, Chris Boden, Igor Wiedler Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. <?php namespace _PHPStan_7d8742a37\React\Stream; final class Util { /** * Pipes all the data from the given $source into the $dest * * @param ReadableStreamInterface $source * @param WritableStreamInterface $dest * @param array $options * @return WritableStreamInterface $dest stream as-is * @see ReadableStreamInterface::pipe() for more details */ public static function pipe(ReadableStreamInterface $source, WritableStreamInterface $dest, array $options = array()) { // source not readable => NO-OP if (!$source->isReadable()) { return $dest; } // destination not writable => just pause() source if (!$dest->isWritable()) { $source->pause(); return $dest; } $dest->emit('pipe', array($source)); // forward all source data events as $dest->write() $source->on('data', $dataer = function ($data) use($source, $dest) { $feedMore = $dest->write($data); if (\false === $feedMore) { $source->pause(); } }); $dest->on('close', function () use($source, $dataer) { $source->removeListener('data', $dataer); $source->pause(); }); // forward destination drain as $source->resume() $dest->on('drain', $drainer = function () use($source) { $source->resume(); }); $source->on('close', function () use($dest, $drainer) { $dest->removeListener('drain', $drainer); }); // forward end event from source as $dest->end() $end = isset($options['end']) ? $options['end'] : \true; if ($end) { $source->on('end', $ender = function () use($dest) { $dest->end(); }); $dest->on('close', function () use($source, $ender) { $source->removeListener('end', $ender); }); } return $dest; } public static function forwardEvents($source, $target, array $events) { foreach ($events as $event) { $source->on($event, function () use($event, $target) { $target->emit($event, \func_get_args()); }); } } } <?php namespace _PHPStan_7d8742a37\React\Stream; use _PHPStan_7d8742a37\Evenement\EventEmitter; use _PHPStan_7d8742a37\React\EventLoop\Loop; use _PHPStan_7d8742a37\React\EventLoop\LoopInterface; use InvalidArgumentException; final class DuplexResourceStream extends EventEmitter implements DuplexStreamInterface { private $stream; /** @var LoopInterface */ private $loop; /** * Controls the maximum buffer size in bytes to read at once from the stream. * * This can be a positive number which means that up to X bytes will be read * at once from the underlying stream resource. Note that the actual number * of bytes read may be lower if the stream resource has less than X bytes * currently available. * * This can be `-1` which means read everything available from the * underlying stream resource. * This should read until the stream resource is not readable anymore * (i.e. underlying buffer drained), note that this does not neccessarily * mean it reached EOF. * * @var int */ private $bufferSize; private $buffer; private $readable = \true; private $writable = \true; private $closing = \false; private $listening = \false; /** * @param resource $stream * @param ?LoopInterface $loop * @param ?int $readChunkSize * @param ?WritableStreamInterface $buffer */ public function __construct($stream, $loop = null, $readChunkSize = null, $buffer = null) { if (!\is_resource($stream) || \get_resource_type($stream) !== "stream") { throw new InvalidArgumentException('First parameter must be a valid stream resource'); } // ensure resource is opened for reading and wrting (fopen mode must contain "+") $meta = \stream_get_meta_data($stream); if (isset($meta['mode']) && $meta['mode'] !== '' && \strpos($meta['mode'], '+') === \false) { throw new InvalidArgumentException('Given stream resource is not opened in read and write mode'); } // this class relies on non-blocking I/O in order to not interrupt the event loop // e.g. pipes on Windows do not support this: https://bugs.php.net/bug.php?id=47918 if ($buffer !== null && !$buffer instanceof WritableResourceStream && \stream_set_blocking($stream, \false) !== \true) { throw new \RuntimeException('Unable to set stream resource to non-blocking mode'); } if ($loop !== null && !$loop instanceof LoopInterface) { // manual type check to support legacy PHP < 7.1 throw new \InvalidArgumentException('_PHPStan_7d8742a37\\Argument #2 ($loop) expected null|React\\EventLoop\\LoopInterface'); } if ($buffer !== null && !$buffer instanceof WritableStreamInterface) { // manual type check to support legacy PHP < 7.1 throw new \InvalidArgumentException('_PHPStan_7d8742a37\\Argument #4 ($buffer) expected null|React\\Stream\\WritableStreamInterface'); } // Use unbuffered read operations on the underlying stream resource. // Reading chunks from the stream may otherwise leave unread bytes in // PHP's stream buffers which some event loop implementations do not // trigger events on (edge triggered). // This does not affect the default event loop implementation (level // triggered), so we can ignore platforms not supporting this (HHVM). // Pipe streams (such as STDIN) do not seem to require this and legacy // PHP versions cause SEGFAULTs on unbuffered pipe streams, so skip this. if (\function_exists('stream_set_read_buffer') && !$this->isLegacyPipe($stream)) { \stream_set_read_buffer($stream, 0); } if ($buffer === null) { $buffer = new WritableResourceStream($stream, $loop); } $this->stream = $stream; $this->loop = $loop ?: Loop::get(); $this->bufferSize = $readChunkSize === null ? 65536 : (int) $readChunkSize; $this->buffer = $buffer; $that = $this; $this->buffer->on('error', function ($error) use($that) { $that->emit('error', array($error)); }); $this->buffer->on('close', array($this, 'close')); $this->buffer->on('drain', function () use($that) { $that->emit('drain'); }); $this->resume(); } public function isReadable() { return $this->readable; } public function isWritable() { return $this->writable; } public function pause() { if ($this->listening) { $this->loop->removeReadStream($this->stream); $this->listening = \false; } } public function resume() { if (!$this->listening && $this->readable) { $this->loop->addReadStream($this->stream, array($this, 'handleData')); $this->listening = \true; } } public function write($data) { if (!$this->writable) { return \false; } return $this->buffer->write($data); } public function close() { if (!$this->writable && !$this->closing) { return; } $this->closing = \false; $this->readable = \false; $this->writable = \false; $this->emit('close'); $this->pause(); $this->buffer->close(); $this->removeAllListeners(); if (\is_resource($this->stream)) { \fclose($this->stream); } } public function end($data = null) { if (!$this->writable) { return; } $this->closing = \true; $this->readable = \false; $this->writable = \false; $this->pause(); $this->buffer->end($data); } public function pipe(WritableStreamInterface $dest, array $options = array()) { return Util::pipe($this, $dest, $options); } /** @internal */ public function handleData($stream) { $error = null; \set_error_handler(function ($errno, $errstr, $errfile, $errline) use(&$error) { $error = new \ErrorException($errstr, 0, $errno, $errfile, $errline); }); $data = \stream_get_contents($stream, $this->bufferSize); \restore_error_handler(); if ($error !== null) { $this->emit('error', array(new \RuntimeException('Unable to read from stream: ' . $error->getMessage(), 0, $error))); $this->close(); return; } if ($data !== '') { $this->emit('data', array($data)); } elseif (\feof($this->stream)) { // no data read => we reached the end and close the stream $this->emit('end'); $this->close(); } } /** * Returns whether this is a pipe resource in a legacy environment * * This works around a legacy PHP bug (#61019) that was fixed in PHP 5.4.28+ * and PHP 5.5.12+ and newer. * * @param resource $resource * @return bool * @link https://github.com/reactphp/child-process/issues/40 * * @codeCoverageIgnore */ private function isLegacyPipe($resource) { if (\PHP_VERSION_ID < 50428 || \PHP_VERSION_ID >= 50500 && \PHP_VERSION_ID < 50512) { $meta = \stream_get_meta_data($resource); if (isset($meta['stream_type']) && $meta['stream_type'] === 'STDIO') { return \true; } } return \false; } } <?php namespace _PHPStan_7d8742a37\React\Stream; use _PHPStan_7d8742a37\Evenement\EventEmitter; final class CompositeStream extends EventEmitter implements DuplexStreamInterface { private $readable; private $writable; private $closed = \false; public function __construct(ReadableStreamInterface $readable, WritableStreamInterface $writable) { $this->readable = $readable; $this->writable = $writable; if (!$readable->isReadable() || !$writable->isWritable()) { $this->close(); return; } Util::forwardEvents($this->readable, $this, array('data', 'end', 'error')); Util::forwardEvents($this->writable, $this, array('drain', 'error', 'pipe')); $this->readable->on('close', array($this, 'close')); $this->writable->on('close', array($this, 'close')); } public function isReadable() { return $this->readable->isReadable(); } public function pause() { $this->readable->pause(); } public function resume() { if (!$this->writable->isWritable()) { return; } $this->readable->resume(); } public function pipe(WritableStreamInterface $dest, array $options = array()) { return Util::pipe($this, $dest, $options); } public function isWritable() { return $this->writable->isWritable(); } public function write($data) { return $this->writable->write($data); } public function end($data = null) { $this->readable->pause(); $this->writable->end($data); } public function close() { if ($this->closed) { return; } $this->closed = \true; $this->readable->close(); $this->writable->close(); $this->emit('close'); $this->removeAllListeners(); } } <?php namespace _PHPStan_7d8742a37\React\Stream; /** * The `DuplexStreamInterface` is responsible for providing an interface for * duplex streams (both readable and writable). * * It builds on top of the existing interfaces for readable and writable streams * and follows the exact same method and event semantics. * If you're new to this concept, you should look into the * `ReadableStreamInterface` and `WritableStreamInterface` first. * * Besides defining a few methods, this interface also implements the * `EventEmitterInterface` which allows you to react to the same events defined * on the `ReadbleStreamInterface` and `WritableStreamInterface`. * * The event callback functions MUST be a valid `callable` that obeys strict * parameter definitions and MUST accept event parameters exactly as documented. * The event callback functions MUST NOT throw an `Exception`. * The return value of the event callback functions will be ignored and has no * effect, so for performance reasons you're recommended to not return any * excessive data structures. * * Every implementation of this interface MUST follow these event semantics in * order to be considered a well-behaving stream. * * > Note that higher-level implementations of this interface may choose to * define additional events with dedicated semantics not defined as part of * this low-level stream specification. Conformance with these event semantics * is out of scope for this interface, so you may also have to refer to the * documentation of such a higher-level implementation. * * @see ReadableStreamInterface * @see WritableStreamInterface */ interface DuplexStreamInterface extends ReadableStreamInterface, WritableStreamInterface { } <?php namespace _PHPStan_7d8742a37\React\Stream; use _PHPStan_7d8742a37\Evenement\EventEmitter; use _PHPStan_7d8742a37\React\EventLoop\Loop; use _PHPStan_7d8742a37\React\EventLoop\LoopInterface; final class WritableResourceStream extends EventEmitter implements WritableStreamInterface { private $stream; /** @var LoopInterface */ private $loop; /** * @var int */ private $softLimit; /** * @var int */ private $writeChunkSize; private $listening = \false; private $writable = \true; private $closed = \false; private $data = ''; /** * @param resource $stream * @param ?LoopInterface $loop * @param ?int $writeBufferSoftLimit * @param ?int $writeChunkSize */ public function __construct($stream, $loop = null, $writeBufferSoftLimit = null, $writeChunkSize = null) { if (!\is_resource($stream) || \get_resource_type($stream) !== "stream") { throw new \InvalidArgumentException('First parameter must be a valid stream resource'); } // ensure resource is opened for writing (fopen mode must contain either of "waxc+") $meta = \stream_get_meta_data($stream); if (isset($meta['mode']) && $meta['mode'] !== '' && \strtr($meta['mode'], 'waxc+', '.....') === $meta['mode']) { throw new \InvalidArgumentException('Given stream resource is not opened in write mode'); } // this class relies on non-blocking I/O in order to not interrupt the event loop // e.g. pipes on Windows do not support this: https://bugs.php.net/bug.php?id=47918 if (\stream_set_blocking($stream, \false) !== \true) { throw new \RuntimeException('Unable to set stream resource to non-blocking mode'); } if ($loop !== null && !$loop instanceof LoopInterface) { // manual type check to support legacy PHP < 7.1 throw new \InvalidArgumentException('_PHPStan_7d8742a37\\Argument #2 ($loop) expected null|React\\EventLoop\\LoopInterface'); } $this->stream = $stream; $this->loop = $loop ?: Loop::get(); $this->softLimit = $writeBufferSoftLimit === null ? 65536 : (int) $writeBufferSoftLimit; $this->writeChunkSize = $writeChunkSize === null ? -1 : (int) $writeChunkSize; } public function isWritable() { return $this->writable; } public function write($data) { if (!$this->writable) { return \false; } $this->data .= $data; if (!$this->listening && $this->data !== '') { $this->listening = \true; $this->loop->addWriteStream($this->stream, array($this, 'handleWrite')); } return !isset($this->data[$this->softLimit - 1]); } public function end($data = null) { if (null !== $data) { $this->write($data); } $this->writable = \false; // close immediately if buffer is already empty // otherwise wait for buffer to flush first if ($this->data === '') { $this->close(); } } public function close() { if ($this->closed) { return; } if ($this->listening) { $this->listening = \false; $this->loop->removeWriteStream($this->stream); } $this->closed = \true; $this->writable = \false; $this->data = ''; $this->emit('close'); $this->removeAllListeners(); if (\is_resource($this->stream)) { \fclose($this->stream); } } /** @internal */ public function handleWrite() { $error = null; \set_error_handler(function ($_, $errstr) use(&$error) { $error = $errstr; }); if ($this->writeChunkSize === -1) { $sent = \fwrite($this->stream, $this->data); } else { $sent = \fwrite($this->stream, $this->data, $this->writeChunkSize); } \restore_error_handler(); // Only report errors if *nothing* could be sent and an error has been raised. // Ignore non-fatal warnings if *some* data could be sent. // Any hard (permanent) error will fail to send any data at all. // Sending excessive amounts of data will only flush *some* data and then // report a temporary error (EAGAIN) which we do not raise here in order // to keep the stream open for further tries to write. // Should this turn out to be a permanent error later, it will eventually // send *nothing* and we can detect this. if (($sent === 0 || $sent === \false) && $error !== null) { $this->emit('error', array(new \RuntimeException('Unable to write to stream: ' . $error))); $this->close(); return; } $exceeded = isset($this->data[$this->softLimit - 1]); $this->data = (string) \substr($this->data, $sent); // buffer has been above limit and is now below limit if ($exceeded && !isset($this->data[$this->softLimit - 1])) { $this->emit('drain'); } // buffer is now completely empty => stop trying to write if ($this->data === '') { // stop waiting for resource to be writable if ($this->listening) { $this->loop->removeWriteStream($this->stream); $this->listening = \false; } // buffer is end()ing and now completely empty => close buffer if (!$this->writable) { $this->close(); } } } } <?php namespace _PHPStan_7d8742a37\React\Stream; use _PHPStan_7d8742a37\Evenement\EventEmitter; use InvalidArgumentException; /** * The `ThroughStream` implements the * [`DuplexStreamInterface`](#duplexstreaminterface) and will simply pass any data * you write to it through to its readable end. * * ```php * $through = new ThroughStream(); * $through->on('data', $this->expectCallableOnceWith('hello')); * * $through->write('hello'); * ``` * * Similarly, the [`end()` method](#end) will end the stream and emit an * [`end` event](#end-event) and then [`close()`](#close-1) the stream. * The [`close()` method](#close-1) will close the stream and emit a * [`close` event](#close-event). * Accordingly, this is can also be used in a [`pipe()`](#pipe) context like this: * * ```php * $through = new ThroughStream(); * $source->pipe($through)->pipe($dest); * ``` * * Optionally, its constructor accepts any callable function which will then be * used to *filter* any data written to it. This function receives a single data * argument as passed to the writable side and must return the data as it will be * passed to its readable end: * * ```php * $through = new ThroughStream('strtoupper'); * $source->pipe($through)->pipe($dest); * ``` * * Note that this class makes no assumptions about any data types. This can be * used to convert data, for example for transforming any structured data into * a newline-delimited JSON (NDJSON) stream like this: * * ```php * $through = new ThroughStream(function ($data) { * return json_encode($data) . PHP_EOL; * }); * $through->on('data', $this->expectCallableOnceWith("[2, true]\n")); * * $through->write(array(2, true)); * ``` * * The callback function is allowed to throw an `Exception`. In this case, * the stream will emit an `error` event and then [`close()`](#close-1) the stream. * * ```php * $through = new ThroughStream(function ($data) { * if (!is_string($data)) { * throw new \UnexpectedValueException('Only strings allowed'); * } * return $data; * }); * $through->on('error', $this->expectCallableOnce())); * $through->on('close', $this->expectCallableOnce())); * $through->on('data', $this->expectCallableNever())); * * $through->write(2); * ``` * * @see WritableStreamInterface::write() * @see WritableStreamInterface::end() * @see DuplexStreamInterface::close() * @see WritableStreamInterface::pipe() */ final class ThroughStream extends EventEmitter implements DuplexStreamInterface { private $readable = \true; private $writable = \true; private $closed = \false; private $paused = \false; private $drain = \false; private $callback; public function __construct($callback = null) { if ($callback !== null && !\is_callable($callback)) { throw new InvalidArgumentException('Invalid transformation callback given'); } $this->callback = $callback; } public function pause() { // only allow pause if still readable, false otherwise $this->paused = $this->readable; } public function resume() { $this->paused = \false; // emit drain event if previous write was paused (throttled) if ($this->drain) { $this->drain = \false; $this->emit('drain'); } } public function pipe(WritableStreamInterface $dest, array $options = array()) { return Util::pipe($this, $dest, $options); } public function isReadable() { return $this->readable; } public function isWritable() { return $this->writable; } public function write($data) { if (!$this->writable) { return \false; } if ($this->callback !== null) { try { $data = \call_user_func($this->callback, $data); } catch (\Exception $e) { $this->emit('error', array($e)); $this->close(); return \false; } } $this->emit('data', array($data)); // emit drain event on next resume if currently paused (throttled) if ($this->paused) { $this->drain = \true; } // continue writing if still writable and not paused (throttled), false otherwise return $this->writable && !$this->paused; } public function end($data = null) { if (!$this->writable) { return; } if (null !== $data) { $this->write($data); // return if write() already caused the stream to close if (!$this->writable) { return; } } $this->readable = \false; $this->writable = \false; $this->paused = \false; $this->drain = \false; $this->emit('end'); $this->close(); } public function close() { if ($this->closed) { return; } $this->readable = \false; $this->writable = \false; $this->paused = \false; $this->drain = \false; $this->closed = \true; $this->callback = null; $this->emit('close'); $this->removeAllListeners(); } } <?php namespace _PHPStan_7d8742a37\React\Stream; use _PHPStan_7d8742a37\Evenement\EventEmitter; use _PHPStan_7d8742a37\React\EventLoop\Loop; use _PHPStan_7d8742a37\React\EventLoop\LoopInterface; use InvalidArgumentException; final class ReadableResourceStream extends EventEmitter implements ReadableStreamInterface { /** * @var resource */ private $stream; /** @var LoopInterface */ private $loop; /** * Controls the maximum buffer size in bytes to read at once from the stream. * * This value SHOULD NOT be changed unless you know what you're doing. * * This can be a positive number which means that up to X bytes will be read * at once from the underlying stream resource. Note that the actual number * of bytes read may be lower if the stream resource has less than X bytes * currently available. * * This can be `-1` which means read everything available from the * underlying stream resource. * This should read until the stream resource is not readable anymore * (i.e. underlying buffer drained), note that this does not neccessarily * mean it reached EOF. * * @var int */ private $bufferSize; private $closed = \false; private $listening = \false; /** * @param resource $stream * @param ?LoopInterface $loop * @param ?int $readChunkSize */ public function __construct($stream, $loop = null, $readChunkSize = null) { if (!\is_resource($stream) || \get_resource_type($stream) !== "stream") { throw new InvalidArgumentException('First parameter must be a valid stream resource'); } // ensure resource is opened for reading (fopen mode must contain "r" or "+") $meta = \stream_get_meta_data($stream); if (isset($meta['mode']) && $meta['mode'] !== '' && \strpos($meta['mode'], 'r') === \strpos($meta['mode'], '+')) { throw new InvalidArgumentException('Given stream resource is not opened in read mode'); } // this class relies on non-blocking I/O in order to not interrupt the event loop // e.g. pipes on Windows do not support this: https://bugs.php.net/bug.php?id=47918 if (\stream_set_blocking($stream, \false) !== \true) { throw new \RuntimeException('Unable to set stream resource to non-blocking mode'); } if ($loop !== null && !$loop instanceof LoopInterface) { // manual type check to support legacy PHP < 7.1 throw new \InvalidArgumentException('_PHPStan_7d8742a37\\Argument #2 ($loop) expected null|React\\EventLoop\\LoopInterface'); } // Use unbuffered read operations on the underlying stream resource. // Reading chunks from the stream may otherwise leave unread bytes in // PHP's stream buffers which some event loop implementations do not // trigger events on (edge triggered). // This does not affect the default event loop implementation (level // triggered), so we can ignore platforms not supporting this (HHVM). // Pipe streams (such as STDIN) do not seem to require this and legacy // PHP versions cause SEGFAULTs on unbuffered pipe streams, so skip this. if (\function_exists('stream_set_read_buffer') && !$this->isLegacyPipe($stream)) { \stream_set_read_buffer($stream, 0); } $this->stream = $stream; $this->loop = $loop ?: Loop::get(); $this->bufferSize = $readChunkSize === null ? 65536 : (int) $readChunkSize; $this->resume(); } public function isReadable() { return !$this->closed; } public function pause() { if ($this->listening) { $this->loop->removeReadStream($this->stream); $this->listening = \false; } } public function resume() { if (!$this->listening && !$this->closed) { $this->loop->addReadStream($this->stream, array($this, 'handleData')); $this->listening = \true; } } public function pipe(WritableStreamInterface $dest, array $options = array()) { return Util::pipe($this, $dest, $options); } public function close() { if ($this->closed) { return; } $this->closed = \true; $this->emit('close'); $this->pause(); $this->removeAllListeners(); if (\is_resource($this->stream)) { \fclose($this->stream); } } /** @internal */ public function handleData() { $error = null; \set_error_handler(function ($errno, $errstr, $errfile, $errline) use(&$error) { $error = new \ErrorException($errstr, 0, $errno, $errfile, $errline); }); $data = \stream_get_contents($this->stream, $this->bufferSize); \restore_error_handler(); if ($error !== null) { $this->emit('error', array(new \RuntimeException('Unable to read from stream: ' . $error->getMessage(), 0, $error))); $this->close(); return; } if ($data !== '') { $this->emit('data', array($data)); } elseif (\feof($this->stream)) { // no data read => we reached the end and close the stream $this->emit('end'); $this->close(); } } /** * Returns whether this is a pipe resource in a legacy environment * * This works around a legacy PHP bug (#61019) that was fixed in PHP 5.4.28+ * and PHP 5.5.12+ and newer. * * @param resource $resource * @return bool * @link https://github.com/reactphp/child-process/issues/40 * * @codeCoverageIgnore */ private function isLegacyPipe($resource) { if (\PHP_VERSION_ID < 50428 || \PHP_VERSION_ID >= 50500 && \PHP_VERSION_ID < 50512) { $meta = \stream_get_meta_data($resource); if (isset($meta['stream_type']) && $meta['stream_type'] === 'STDIO') { return \true; } } return \false; } } <?php namespace _PHPStan_7d8742a37\React\Stream; use _PHPStan_7d8742a37\Evenement\EventEmitterInterface; /** * The `WritableStreamInterface` is responsible for providing an interface for * write-only streams and the writable side of duplex streams. * * Besides defining a few methods, this interface also implements the * `EventEmitterInterface` which allows you to react to certain events: * * drain event: * The `drain` event will be emitted whenever the write buffer became full * previously and is now ready to accept more data. * * ```php * $stream->on('drain', function () use ($stream) { * echo 'Stream is now ready to accept more data'; * }); * ``` * * This event SHOULD be emitted once every time the buffer became full * previously and is now ready to accept more data. * In other words, this event MAY be emitted any number of times, which may * be zero times if the buffer never became full in the first place. * This event SHOULD NOT be emitted if the buffer has not become full * previously. * * This event is mostly used internally, see also `write()` for more details. * * pipe event: * The `pipe` event will be emitted whenever a readable stream is `pipe()`d * into this stream. * The event receives a single `ReadableStreamInterface` argument for the * source stream. * * ```php * $stream->on('pipe', function (ReadableStreamInterface $source) use ($stream) { * echo 'Now receiving piped data'; * * // explicitly close target if source emits an error * $source->on('error', function () use ($stream) { * $stream->close(); * }); * }); * * $source->pipe($stream); * ``` * * This event MUST be emitted once for each readable stream that is * successfully piped into this destination stream. * In other words, this event MAY be emitted any number of times, which may * be zero times if no stream is ever piped into this stream. * This event MUST NOT be emitted if either the source is not readable * (closed already) or this destination is not writable (closed already). * * This event is mostly used internally, see also `pipe()` for more details. * * error event: * The `error` event will be emitted once a fatal error occurs, usually while * trying to write to this stream. * The event receives a single `Exception` argument for the error instance. * * ```php * $stream->on('error', function (Exception $e) { * echo 'Error: ' . $e->getMessage() . PHP_EOL; * }); * ``` * * This event SHOULD be emitted once the stream detects a fatal error, such * as a fatal transmission error. * It SHOULD NOT be emitted after a previous `error` or `close` event. * It MUST NOT be emitted if this is not a fatal error condition, such as * a temporary network issue that did not cause any data to be lost. * * After the stream errors, it MUST close the stream and SHOULD thus be * followed by a `close` event and then switch to non-writable mode, see * also `close()` and `isWritable()`. * * Many common streams (such as a TCP/IP connection or a file-based stream) * only deal with data transmission and may choose * to only emit this for a fatal transmission error once and will then * close (terminate) the stream in response. * * If this stream is a `DuplexStreamInterface`, you should also notice * how the readable side of the stream also implements an `error` event. * In other words, an error may occur while either reading or writing the * stream which should result in the same error processing. * * close event: * The `close` event will be emitted once the stream closes (terminates). * * ```php * $stream->on('close', function () { * echo 'CLOSED'; * }); * ``` * * This event SHOULD be emitted once or never at all, depending on whether * the stream ever terminates. * It SHOULD NOT be emitted after a previous `close` event. * * After the stream is closed, it MUST switch to non-writable mode, * see also `isWritable()`. * * This event SHOULD be emitted whenever the stream closes, irrespective of * whether this happens implicitly due to an unrecoverable error or * explicitly when either side closes the stream. * * Many common streams (such as a TCP/IP connection or a file-based stream) * will likely choose to emit this event after flushing the buffer from * the `end()` method, after receiving a *successful* `end` event or after * a fatal transmission `error` event. * * If this stream is a `DuplexStreamInterface`, you should also notice * how the readable side of the stream also implements a `close` event. * In other words, after receiving this event, the stream MUST switch into * non-writable AND non-readable mode, see also `isReadable()`. * Note that this event should not be confused with the `end` event. * * The event callback functions MUST be a valid `callable` that obeys strict * parameter definitions and MUST accept event parameters exactly as documented. * The event callback functions MUST NOT throw an `Exception`. * The return value of the event callback functions will be ignored and has no * effect, so for performance reasons you're recommended to not return any * excessive data structures. * * Every implementation of this interface MUST follow these event semantics in * order to be considered a well-behaving stream. * * > Note that higher-level implementations of this interface may choose to * define additional events with dedicated semantics not defined as part of * this low-level stream specification. Conformance with these event semantics * is out of scope for this interface, so you may also have to refer to the * documentation of such a higher-level implementation. * * @see EventEmitterInterface * @see DuplexStreamInterface */ interface WritableStreamInterface extends EventEmitterInterface { /** * Checks whether this stream is in a writable state (not closed already). * * This method can be used to check if the stream still accepts writing * any data or if it is ended or closed already. * Writing any data to a non-writable stream is a NO-OP: * * ```php * assert($stream->isWritable() === false); * * $stream->write('end'); // NO-OP * $stream->end('end'); // NO-OP * ``` * * A successfully opened stream always MUST start in writable mode. * * Once the stream ends or closes, it MUST switch to non-writable mode. * This can happen any time, explicitly through `end()` or `close()` or * implicitly due to a remote close or an unrecoverable transmission error. * Once a stream has switched to non-writable mode, it MUST NOT transition * back to writable mode. * * If this stream is a `DuplexStreamInterface`, you should also notice * how the readable side of the stream also implements an `isReadable()` * method. Unless this is a half-open duplex stream, they SHOULD usually * have the same return value. * * @return bool */ public function isWritable(); /** * Write some data into the stream. * * A successful write MUST be confirmed with a boolean `true`, which means * that either the data was written (flushed) immediately or is buffered and * scheduled for a future write. Note that this interface gives you no * control over explicitly flushing the buffered data, as finding the * appropriate time for this is beyond the scope of this interface and left * up to the implementation of this interface. * * Many common streams (such as a TCP/IP connection or file-based stream) * may choose to buffer all given data and schedule a future flush by using * an underlying EventLoop to check when the resource is actually writable. * * If a stream cannot handle writing (or flushing) the data, it SHOULD emit * an `error` event and MAY `close()` the stream if it can not recover from * this error. * * If the internal buffer is full after adding `$data`, then `write()` * SHOULD return `false`, indicating that the caller should stop sending * data until the buffer drains. * The stream SHOULD send a `drain` event once the buffer is ready to accept * more data. * * Similarly, if the stream is not writable (already in a closed state) * it MUST NOT process the given `$data` and SHOULD return `false`, * indicating that the caller should stop sending data. * * The given `$data` argument MAY be of mixed type, but it's usually * recommended it SHOULD be a `string` value or MAY use a type that allows * representation as a `string` for maximum compatibility. * * Many common streams (such as a TCP/IP connection or a file-based stream) * will only accept the raw (binary) payload data that is transferred over * the wire as chunks of `string` values. * * Due to the stream-based nature of this, the sender may send any number * of chunks with varying sizes. There are no guarantees that these chunks * will be received with the exact same framing the sender intended to send. * In other words, many lower-level protocols (such as TCP/IP) transfer the * data in chunks that may be anywhere between single-byte values to several * dozens of kilobytes. You may want to apply a higher-level protocol to * these low-level data chunks in order to achieve proper message framing. * * @param mixed|string $data * @return bool */ public function write($data); /** * Successfully ends the stream (after optionally sending some final data). * * This method can be used to successfully end the stream, i.e. close * the stream after sending out all data that is currently buffered. * * ```php * $stream->write('hello'); * $stream->write('world'); * $stream->end(); * ``` * * If there's no data currently buffered and nothing to be flushed, then * this method MAY `close()` the stream immediately. * * If there's still data in the buffer that needs to be flushed first, then * this method SHOULD try to write out this data and only then `close()` * the stream. * Once the stream is closed, it SHOULD emit a `close` event. * * Note that this interface gives you no control over explicitly flushing * the buffered data, as finding the appropriate time for this is beyond the * scope of this interface and left up to the implementation of this * interface. * * Many common streams (such as a TCP/IP connection or file-based stream) * may choose to buffer all given data and schedule a future flush by using * an underlying EventLoop to check when the resource is actually writable. * * You can optionally pass some final data that is written to the stream * before ending the stream. If a non-`null` value is given as `$data`, then * this method will behave just like calling `write($data)` before ending * with no data. * * ```php * // shorter version * $stream->end('bye'); * * // same as longer version * $stream->write('bye'); * $stream->end(); * ``` * * After calling this method, the stream MUST switch into a non-writable * mode, see also `isWritable()`. * This means that no further writes are possible, so any additional * `write()` or `end()` calls have no effect. * * ```php * $stream->end(); * assert($stream->isWritable() === false); * * $stream->write('nope'); // NO-OP * $stream->end(); // NO-OP * ``` * * If this stream is a `DuplexStreamInterface`, calling this method SHOULD * also end its readable side, unless the stream supports half-open mode. * In other words, after calling this method, these streams SHOULD switch * into non-writable AND non-readable mode, see also `isReadable()`. * This implies that in this case, the stream SHOULD NOT emit any `data` * or `end` events anymore. * Streams MAY choose to use the `pause()` method logic for this, but * special care may have to be taken to ensure a following call to the * `resume()` method SHOULD NOT continue emitting readable events. * * Note that this method should not be confused with the `close()` method. * * @param mixed|string|null $data * @return void */ public function end($data = null); /** * Closes the stream (forcefully). * * This method can be used to forcefully close the stream, i.e. close * the stream without waiting for any buffered data to be flushed. * If there's still data in the buffer, this data SHOULD be discarded. * * ```php * $stream->close(); * ``` * * Once the stream is closed, it SHOULD emit a `close` event. * Note that this event SHOULD NOT be emitted more than once, in particular * if this method is called multiple times. * * After calling this method, the stream MUST switch into a non-writable * mode, see also `isWritable()`. * This means that no further writes are possible, so any additional * `write()` or `end()` calls have no effect. * * ```php * $stream->close(); * assert($stream->isWritable() === false); * * $stream->write('nope'); // NO-OP * $stream->end(); // NO-OP * ``` * * Note that this method should not be confused with the `end()` method. * Unlike the `end()` method, this method does not take care of any existing * buffers and simply discards any buffer contents. * Likewise, this method may also be called after calling `end()` on a * stream in order to stop waiting for the stream to flush its final data. * * ```php * $stream->end(); * Loop::addTimer(1.0, function () use ($stream) { * $stream->close(); * }); * ``` * * If this stream is a `DuplexStreamInterface`, you should also notice * how the readable side of the stream also implements a `close()` method. * In other words, after calling this method, the stream MUST switch into * non-writable AND non-readable mode, see also `isReadable()`. * * @return void * @see ReadableStreamInterface::close() */ public function close(); } <?php namespace _PHPStan_7d8742a37\React\Stream; use _PHPStan_7d8742a37\Evenement\EventEmitterInterface; /** * The `ReadableStreamInterface` is responsible for providing an interface for * read-only streams and the readable side of duplex streams. * * Besides defining a few methods, this interface also implements the * `EventEmitterInterface` which allows you to react to certain events: * * data event: * The `data` event will be emitted whenever some data was read/received * from this source stream. * The event receives a single mixed argument for incoming data. * * ```php * $stream->on('data', function ($data) { * echo $data; * }); * ``` * * This event MAY be emitted any number of times, which may be zero times if * this stream does not send any data at all. * It SHOULD not be emitted after an `end` or `close` event. * * The given `$data` argument may be of mixed type, but it's usually * recommended it SHOULD be a `string` value or MAY use a type that allows * representation as a `string` for maximum compatibility. * * Many common streams (such as a TCP/IP connection or a file-based stream) * will emit the raw (binary) payload data that is received over the wire as * chunks of `string` values. * * Due to the stream-based nature of this, the sender may send any number * of chunks with varying sizes. There are no guarantees that these chunks * will be received with the exact same framing the sender intended to send. * In other words, many lower-level protocols (such as TCP/IP) transfer the * data in chunks that may be anywhere between single-byte values to several * dozens of kilobytes. You may want to apply a higher-level protocol to * these low-level data chunks in order to achieve proper message framing. * * end event: * The `end` event will be emitted once the source stream has successfully * reached the end of the stream (EOF). * * ```php * $stream->on('end', function () { * echo 'END'; * }); * ``` * * This event SHOULD be emitted once or never at all, depending on whether * a successful end was detected. * It SHOULD NOT be emitted after a previous `end` or `close` event. * It MUST NOT be emitted if the stream closes due to a non-successful * end, such as after a previous `error` event. * * After the stream is ended, it MUST switch to non-readable mode, * see also `isReadable()`. * * This event will only be emitted if the *end* was reached successfully, * not if the stream was interrupted by an unrecoverable error or explicitly * closed. Not all streams know this concept of a "successful end". * Many use-cases involve detecting when the stream closes (terminates) * instead, in this case you should use the `close` event. * After the stream emits an `end` event, it SHOULD usually be followed by a * `close` event. * * Many common streams (such as a TCP/IP connection or a file-based stream) * will emit this event if either the remote side closes the connection or * a file handle was successfully read until reaching its end (EOF). * * Note that this event should not be confused with the `end()` method. * This event defines a successful end *reading* from a source stream, while * the `end()` method defines *writing* a successful end to a destination * stream. * * error event: * The `error` event will be emitted once a fatal error occurs, usually while * trying to read from this stream. * The event receives a single `Exception` argument for the error instance. * * ```php * $stream->on('error', function (Exception $e) { * echo 'Error: ' . $e->getMessage() . PHP_EOL; * }); * ``` * * This event SHOULD be emitted once the stream detects a fatal error, such * as a fatal transmission error or after an unexpected `data` or premature * `end` event. * It SHOULD NOT be emitted after a previous `error`, `end` or `close` event. * It MUST NOT be emitted if this is not a fatal error condition, such as * a temporary network issue that did not cause any data to be lost. * * After the stream errors, it MUST close the stream and SHOULD thus be * followed by a `close` event and then switch to non-readable mode, see * also `close()` and `isReadable()`. * * Many common streams (such as a TCP/IP connection or a file-based stream) * only deal with data transmission and do not make assumption about data * boundaries (such as unexpected `data` or premature `end` events). * In other words, many lower-level protocols (such as TCP/IP) may choose * to only emit this for a fatal transmission error once and will then * close (terminate) the stream in response. * * If this stream is a `DuplexStreamInterface`, you should also notice * how the writable side of the stream also implements an `error` event. * In other words, an error may occur while either reading or writing the * stream which should result in the same error processing. * * close event: * The `close` event will be emitted once the stream closes (terminates). * * ```php * $stream->on('close', function () { * echo 'CLOSED'; * }); * ``` * * This event SHOULD be emitted once or never at all, depending on whether * the stream ever terminates. * It SHOULD NOT be emitted after a previous `close` event. * * After the stream is closed, it MUST switch to non-readable mode, * see also `isReadable()`. * * Unlike the `end` event, this event SHOULD be emitted whenever the stream * closes, irrespective of whether this happens implicitly due to an * unrecoverable error or explicitly when either side closes the stream. * If you only want to detect a *successful* end, you should use the `end` * event instead. * * Many common streams (such as a TCP/IP connection or a file-based stream) * will likely choose to emit this event after reading a *successful* `end` * event or after a fatal transmission `error` event. * * If this stream is a `DuplexStreamInterface`, you should also notice * how the writable side of the stream also implements a `close` event. * In other words, after receiving this event, the stream MUST switch into * non-writable AND non-readable mode, see also `isWritable()`. * Note that this event should not be confused with the `end` event. * * The event callback functions MUST be a valid `callable` that obeys strict * parameter definitions and MUST accept event parameters exactly as documented. * The event callback functions MUST NOT throw an `Exception`. * The return value of the event callback functions will be ignored and has no * effect, so for performance reasons you're recommended to not return any * excessive data structures. * * Every implementation of this interface MUST follow these event semantics in * order to be considered a well-behaving stream. * * > Note that higher-level implementations of this interface may choose to * define additional events with dedicated semantics not defined as part of * this low-level stream specification. Conformance with these event semantics * is out of scope for this interface, so you may also have to refer to the * documentation of such a higher-level implementation. * * @see EventEmitterInterface */ interface ReadableStreamInterface extends EventEmitterInterface { /** * Checks whether this stream is in a readable state (not closed already). * * This method can be used to check if the stream still accepts incoming * data events or if it is ended or closed already. * Once the stream is non-readable, no further `data` or `end` events SHOULD * be emitted. * * ```php * assert($stream->isReadable() === false); * * $stream->on('data', assertNeverCalled()); * $stream->on('end', assertNeverCalled()); * ``` * * A successfully opened stream always MUST start in readable mode. * * Once the stream ends or closes, it MUST switch to non-readable mode. * This can happen any time, explicitly through `close()` or * implicitly due to a remote close or an unrecoverable transmission error. * Once a stream has switched to non-readable mode, it MUST NOT transition * back to readable mode. * * If this stream is a `DuplexStreamInterface`, you should also notice * how the writable side of the stream also implements an `isWritable()` * method. Unless this is a half-open duplex stream, they SHOULD usually * have the same return value. * * @return bool */ public function isReadable(); /** * Pauses reading incoming data events. * * Removes the data source file descriptor from the event loop. This * allows you to throttle incoming data. * * Unless otherwise noted, a successfully opened stream SHOULD NOT start * in paused state. * * Once the stream is paused, no futher `data` or `end` events SHOULD * be emitted. * * ```php * $stream->pause(); * * $stream->on('data', assertShouldNeverCalled()); * $stream->on('end', assertShouldNeverCalled()); * ``` * * This method is advisory-only, though generally not recommended, the * stream MAY continue emitting `data` events. * * You can continue processing events by calling `resume()` again. * * Note that both methods can be called any number of times, in particular * calling `pause()` more than once SHOULD NOT have any effect. * * @see self::resume() * @return void */ public function pause(); /** * Resumes reading incoming data events. * * Re-attach the data source after a previous `pause()`. * * ```php * $stream->pause(); * * Loop::addTimer(1.0, function () use ($stream) { * $stream->resume(); * }); * ``` * * Note that both methods can be called any number of times, in particular * calling `resume()` without a prior `pause()` SHOULD NOT have any effect. * * @see self::pause() * @return void */ public function resume(); /** * Pipes all the data from this readable source into the given writable destination. * * Automatically sends all incoming data to the destination. * Automatically throttles the source based on what the destination can handle. * * ```php * $source->pipe($dest); * ``` * * Similarly, you can also pipe an instance implementing `DuplexStreamInterface` * into itself in order to write back all the data that is received. * This may be a useful feature for a TCP/IP echo service: * * ```php * $connection->pipe($connection); * ``` * * This method returns the destination stream as-is, which can be used to * set up chains of piped streams: * * ```php * $source->pipe($decodeGzip)->pipe($filterBadWords)->pipe($dest); * ``` * * By default, this will call `end()` on the destination stream once the * source stream emits an `end` event. This can be disabled like this: * * ```php * $source->pipe($dest, array('end' => false)); * ``` * * Note that this only applies to the `end` event. * If an `error` or explicit `close` event happens on the source stream, * you'll have to manually close the destination stream: * * ```php * $source->pipe($dest); * $source->on('close', function () use ($dest) { * $dest->end('BYE!'); * }); * ``` * * If the source stream is not readable (closed state), then this is a NO-OP. * * ```php * $source->close(); * $source->pipe($dest); // NO-OP * ``` * * If the destinantion stream is not writable (closed state), then this will simply * throttle (pause) the source stream: * * ```php * $dest->close(); * $source->pipe($dest); // calls $source->pause() * ``` * * Similarly, if the destination stream is closed while the pipe is still * active, it will also throttle (pause) the source stream: * * ```php * $source->pipe($dest); * $dest->close(); // calls $source->pause() * ``` * * Once the pipe is set up successfully, the destination stream MUST emit * a `pipe` event with this source stream an event argument. * * @param WritableStreamInterface $dest * @param array $options * @return WritableStreamInterface $dest stream as-is */ public function pipe(WritableStreamInterface $dest, array $options = array()); /** * Closes the stream (forcefully). * * This method can be used to (forcefully) close the stream. * * ```php * $stream->close(); * ``` * * Once the stream is closed, it SHOULD emit a `close` event. * Note that this event SHOULD NOT be emitted more than once, in particular * if this method is called multiple times. * * After calling this method, the stream MUST switch into a non-readable * mode, see also `isReadable()`. * This means that no further `data` or `end` events SHOULD be emitted. * * ```php * $stream->close(); * assert($stream->isReadable() === false); * * $stream->on('data', assertNeverCalled()); * $stream->on('end', assertNeverCalled()); * ``` * * If this stream is a `DuplexStreamInterface`, you should also notice * how the writable side of the stream also implements a `close()` method. * In other words, after calling this method, the stream MUST switch into * non-writable AND non-readable mode, see also `isWritable()`. * Note that this method should not be confused with the `end()` method. * * @return void * @see WritableStreamInterface::close() */ public function close(); } The MIT License (MIT) Copyright (c) 2012 Christian Lück, Cees-Jan Kiewiet, Jan Sorgalla, Chris Boden, Igor Wiedler Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. <?php namespace _PHPStan_7d8742a37\React\EventLoop; use Ev; use EvIo; use EvLoop; use _PHPStan_7d8742a37\React\EventLoop\Tick\FutureTickQueue; use _PHPStan_7d8742a37\React\EventLoop\Timer\Timer; use SplObjectStorage; /** * An `ext-ev` based event loop. * * This loop uses the [`ev` PECL extension](https://pecl.php.net/package/ev), * that provides an interface to `libev` library. * `libev` itself supports a number of system-specific backends (epoll, kqueue). * * This loop is known to work with PHP 5.4 through PHP 8+. * * @see http://php.net/manual/en/book.ev.php * @see https://bitbucket.org/osmanov/pecl-ev/overview */ class ExtEvLoop implements LoopInterface { /** * @var EvLoop */ private $loop; /** * @var FutureTickQueue */ private $futureTickQueue; /** * @var SplObjectStorage */ private $timers; /** * @var EvIo[] */ private $readStreams = array(); /** * @var EvIo[] */ private $writeStreams = array(); /** * @var bool */ private $running; /** * @var SignalsHandler */ private $signals; /** * @var \EvSignal[] */ private $signalEvents = array(); public function __construct() { $this->loop = new EvLoop(); $this->futureTickQueue = new FutureTickQueue(); $this->timers = new SplObjectStorage(); $this->signals = new SignalsHandler(); } public function addReadStream($stream, $listener) { $key = (int) $stream; if (isset($this->readStreams[$key])) { return; } $callback = $this->getStreamListenerClosure($stream, $listener); $event = $this->loop->io($stream, Ev::READ, $callback); $this->readStreams[$key] = $event; } /** * @param resource $stream * @param callable $listener * * @return \Closure */ private function getStreamListenerClosure($stream, $listener) { return function () use($stream, $listener) { \call_user_func($listener, $stream); }; } public function addWriteStream($stream, $listener) { $key = (int) $stream; if (isset($this->writeStreams[$key])) { return; } $callback = $this->getStreamListenerClosure($stream, $listener); $event = $this->loop->io($stream, Ev::WRITE, $callback); $this->writeStreams[$key] = $event; } public function removeReadStream($stream) { $key = (int) $stream; if (!isset($this->readStreams[$key])) { return; } $this->readStreams[$key]->stop(); unset($this->readStreams[$key]); } public function removeWriteStream($stream) { $key = (int) $stream; if (!isset($this->writeStreams[$key])) { return; } $this->writeStreams[$key]->stop(); unset($this->writeStreams[$key]); } public function addTimer($interval, $callback) { $timer = new Timer($interval, $callback, \false); $that = $this; $timers = $this->timers; $callback = function () use($timer, $timers, $that) { \call_user_func($timer->getCallback(), $timer); if ($timers->contains($timer)) { $that->cancelTimer($timer); } }; $event = $this->loop->timer($timer->getInterval(), 0.0, $callback); $this->timers->attach($timer, $event); return $timer; } public function addPeriodicTimer($interval, $callback) { $timer = new Timer($interval, $callback, \true); $callback = function () use($timer) { \call_user_func($timer->getCallback(), $timer); }; $event = $this->loop->timer($timer->getInterval(), $timer->getInterval(), $callback); $this->timers->attach($timer, $event); return $timer; } public function cancelTimer(TimerInterface $timer) { if (!isset($this->timers[$timer])) { return; } $event = $this->timers[$timer]; $event->stop(); $this->timers->detach($timer); } public function futureTick($listener) { $this->futureTickQueue->add($listener); } public function run() { $this->running = \true; while ($this->running) { $this->futureTickQueue->tick(); $hasPendingCallbacks = !$this->futureTickQueue->isEmpty(); $wasJustStopped = !$this->running; $nothingLeftToDo = !$this->readStreams && !$this->writeStreams && !$this->timers->count() && $this->signals->isEmpty(); $flags = Ev::RUN_ONCE; if ($wasJustStopped || $hasPendingCallbacks) { $flags |= Ev::RUN_NOWAIT; } elseif ($nothingLeftToDo) { break; } $this->loop->run($flags); } } public function stop() { $this->running = \false; } public function __destruct() { /** @var TimerInterface $timer */ foreach ($this->timers as $timer) { $this->cancelTimer($timer); } foreach ($this->readStreams as $key => $stream) { $this->removeReadStream($key); } foreach ($this->writeStreams as $key => $stream) { $this->removeWriteStream($key); } } public function addSignal($signal, $listener) { $this->signals->add($signal, $listener); if (!isset($this->signalEvents[$signal])) { $this->signalEvents[$signal] = $this->loop->signal($signal, function () use($signal) { $this->signals->call($signal); }); } } public function removeSignal($signal, $listener) { $this->signals->remove($signal, $listener); if (isset($this->signalEvents[$signal])) { $this->signalEvents[$signal]->stop(); unset($this->signalEvents[$signal]); } } } <?php namespace _PHPStan_7d8742a37\React\EventLoop; interface LoopInterface { /** * [Advanced] Register a listener to be notified when a stream is ready to read. * * Note that this low-level API is considered advanced usage. * Most use cases should probably use the higher-level * [readable Stream API](https://github.com/reactphp/stream#readablestreaminterface) * instead. * * The first parameter MUST be a valid stream resource that supports * checking whether it is ready to read by this loop implementation. * A single stream resource MUST NOT be added more than once. * Instead, either call [`removeReadStream()`](#removereadstream) first or * react to this event with a single listener and then dispatch from this * listener. This method MAY throw an `Exception` if the given resource type * is not supported by this loop implementation. * * The second parameter MUST be a listener callback function that accepts * the stream resource as its only parameter. * If you don't use the stream resource inside your listener callback function * you MAY use a function which has no parameters at all. * * The listener callback function MUST NOT throw an `Exception`. * The return value of the listener callback function will be ignored and has * no effect, so for performance reasons you're recommended to not return * any excessive data structures. * * If you want to access any variables within your callback function, you * can bind arbitrary data to a callback closure like this: * * ```php * $loop->addReadStream($stream, function ($stream) use ($name) { * echo $name . ' said: ' . fread($stream); * }); * ``` * * See also [example #11](examples). * * You can invoke [`removeReadStream()`](#removereadstream) to remove the * read event listener for this stream. * * The execution order of listeners when multiple streams become ready at * the same time is not guaranteed. * * @param resource $stream The PHP stream resource to check. * @param callable $listener Invoked when the stream is ready. * @throws \Exception if the given resource type is not supported by this loop implementation * @see self::removeReadStream() */ public function addReadStream($stream, $listener); /** * [Advanced] Register a listener to be notified when a stream is ready to write. * * Note that this low-level API is considered advanced usage. * Most use cases should probably use the higher-level * [writable Stream API](https://github.com/reactphp/stream#writablestreaminterface) * instead. * * The first parameter MUST be a valid stream resource that supports * checking whether it is ready to write by this loop implementation. * A single stream resource MUST NOT be added more than once. * Instead, either call [`removeWriteStream()`](#removewritestream) first or * react to this event with a single listener and then dispatch from this * listener. This method MAY throw an `Exception` if the given resource type * is not supported by this loop implementation. * * The second parameter MUST be a listener callback function that accepts * the stream resource as its only parameter. * If you don't use the stream resource inside your listener callback function * you MAY use a function which has no parameters at all. * * The listener callback function MUST NOT throw an `Exception`. * The return value of the listener callback function will be ignored and has * no effect, so for performance reasons you're recommended to not return * any excessive data structures. * * If you want to access any variables within your callback function, you * can bind arbitrary data to a callback closure like this: * * ```php * $loop->addWriteStream($stream, function ($stream) use ($name) { * fwrite($stream, 'Hello ' . $name); * }); * ``` * * See also [example #12](examples). * * You can invoke [`removeWriteStream()`](#removewritestream) to remove the * write event listener for this stream. * * The execution order of listeners when multiple streams become ready at * the same time is not guaranteed. * * Some event loop implementations are known to only trigger the listener if * the stream *becomes* readable (edge-triggered) and may not trigger if the * stream has already been readable from the beginning. * This also implies that a stream may not be recognized as readable when data * is still left in PHP's internal stream buffers. * As such, it's recommended to use `stream_set_read_buffer($stream, 0);` * to disable PHP's internal read buffer in this case. * * @param resource $stream The PHP stream resource to check. * @param callable $listener Invoked when the stream is ready. * @throws \Exception if the given resource type is not supported by this loop implementation * @see self::removeWriteStream() */ public function addWriteStream($stream, $listener); /** * Remove the read event listener for the given stream. * * Removing a stream from the loop that has already been removed or trying * to remove a stream that was never added or is invalid has no effect. * * @param resource $stream The PHP stream resource. */ public function removeReadStream($stream); /** * Remove the write event listener for the given stream. * * Removing a stream from the loop that has already been removed or trying * to remove a stream that was never added or is invalid has no effect. * * @param resource $stream The PHP stream resource. */ public function removeWriteStream($stream); /** * Enqueue a callback to be invoked once after the given interval. * * The second parameter MUST be a timer callback function that accepts * the timer instance as its only parameter. * If you don't use the timer instance inside your timer callback function * you MAY use a function which has no parameters at all. * * The timer callback function MUST NOT throw an `Exception`. * The return value of the timer callback function will be ignored and has * no effect, so for performance reasons you're recommended to not return * any excessive data structures. * * This method returns a timer instance. The same timer instance will also be * passed into the timer callback function as described above. * You can invoke [`cancelTimer`](#canceltimer) to cancel a pending timer. * Unlike [`addPeriodicTimer()`](#addperiodictimer), this method will ensure * the callback will be invoked only once after the given interval. * * ```php * $loop->addTimer(0.8, function () { * echo 'world!' . PHP_EOL; * }); * * $loop->addTimer(0.3, function () { * echo 'hello '; * }); * ``` * * See also [example #1](examples). * * If you want to access any variables within your callback function, you * can bind arbitrary data to a callback closure like this: * * ```php * function hello($name, LoopInterface $loop) * { * $loop->addTimer(1.0, function () use ($name) { * echo "hello $name\n"; * }); * } * * hello('Tester', $loop); * ``` * * This interface does not enforce any particular timer resolution, so * special care may have to be taken if you rely on very high precision with * millisecond accuracy or below. Event loop implementations SHOULD work on * a best effort basis and SHOULD provide at least millisecond accuracy * unless otherwise noted. Many existing event loop implementations are * known to provide microsecond accuracy, but it's generally not recommended * to rely on this high precision. * * Similarly, the execution order of timers scheduled to execute at the * same time (within its possible accuracy) is not guaranteed. * * This interface suggests that event loop implementations SHOULD use a * monotonic time source if available. Given that a monotonic time source is * only available as of PHP 7.3 by default, event loop implementations MAY * fall back to using wall-clock time. * While this does not affect many common use cases, this is an important * distinction for programs that rely on a high time precision or on systems * that are subject to discontinuous time adjustments (time jumps). * This means that if you schedule a timer to trigger in 30s and then adjust * your system time forward by 20s, the timer SHOULD still trigger in 30s. * See also [event loop implementations](#loop-implementations) for more details. * * @param int|float $interval The number of seconds to wait before execution. * @param callable $callback The callback to invoke. * * @return TimerInterface */ public function addTimer($interval, $callback); /** * Enqueue a callback to be invoked repeatedly after the given interval. * * The second parameter MUST be a timer callback function that accepts * the timer instance as its only parameter. * If you don't use the timer instance inside your timer callback function * you MAY use a function which has no parameters at all. * * The timer callback function MUST NOT throw an `Exception`. * The return value of the timer callback function will be ignored and has * no effect, so for performance reasons you're recommended to not return * any excessive data structures. * * This method returns a timer instance. The same timer instance will also be * passed into the timer callback function as described above. * Unlike [`addTimer()`](#addtimer), this method will ensure the callback * will be invoked infinitely after the given interval or until you invoke * [`cancelTimer`](#canceltimer). * * ```php * $timer = $loop->addPeriodicTimer(0.1, function () { * echo 'tick!' . PHP_EOL; * }); * * $loop->addTimer(1.0, function () use ($loop, $timer) { * $loop->cancelTimer($timer); * echo 'Done' . PHP_EOL; * }); * ``` * * See also [example #2](examples). * * If you want to limit the number of executions, you can bind * arbitrary data to a callback closure like this: * * ```php * function hello($name, LoopInterface $loop) * { * $n = 3; * $loop->addPeriodicTimer(1.0, function ($timer) use ($name, $loop, &$n) { * if ($n > 0) { * --$n; * echo "hello $name\n"; * } else { * $loop->cancelTimer($timer); * } * }); * } * * hello('Tester', $loop); * ``` * * This interface does not enforce any particular timer resolution, so * special care may have to be taken if you rely on very high precision with * millisecond accuracy or below. Event loop implementations SHOULD work on * a best effort basis and SHOULD provide at least millisecond accuracy * unless otherwise noted. Many existing event loop implementations are * known to provide microsecond accuracy, but it's generally not recommended * to rely on this high precision. * * Similarly, the execution order of timers scheduled to execute at the * same time (within its possible accuracy) is not guaranteed. * * This interface suggests that event loop implementations SHOULD use a * monotonic time source if available. Given that a monotonic time source is * only available as of PHP 7.3 by default, event loop implementations MAY * fall back to using wall-clock time. * While this does not affect many common use cases, this is an important * distinction for programs that rely on a high time precision or on systems * that are subject to discontinuous time adjustments (time jumps). * This means that if you schedule a timer to trigger in 30s and then adjust * your system time forward by 20s, the timer SHOULD still trigger in 30s. * See also [event loop implementations](#loop-implementations) for more details. * * Additionally, periodic timers may be subject to timer drift due to * re-scheduling after each invocation. As such, it's generally not * recommended to rely on this for high precision intervals with millisecond * accuracy or below. * * @param int|float $interval The number of seconds to wait before execution. * @param callable $callback The callback to invoke. * * @return TimerInterface */ public function addPeriodicTimer($interval, $callback); /** * Cancel a pending timer. * * See also [`addPeriodicTimer()`](#addperiodictimer) and [example #2](examples). * * Calling this method on a timer instance that has not been added to this * loop instance or on a timer that has already been cancelled has no effect. * * @param TimerInterface $timer The timer to cancel. * * @return void */ public function cancelTimer(TimerInterface $timer); /** * Schedule a callback to be invoked on a future tick of the event loop. * * This works very much similar to timers with an interval of zero seconds, * but does not require the overhead of scheduling a timer queue. * * The tick callback function MUST be able to accept zero parameters. * * The tick callback function MUST NOT throw an `Exception`. * The return value of the tick callback function will be ignored and has * no effect, so for performance reasons you're recommended to not return * any excessive data structures. * * If you want to access any variables within your callback function, you * can bind arbitrary data to a callback closure like this: * * ```php * function hello($name, LoopInterface $loop) * { * $loop->futureTick(function () use ($name) { * echo "hello $name\n"; * }); * } * * hello('Tester', $loop); * ``` * * Unlike timers, tick callbacks are guaranteed to be executed in the order * they are enqueued. * Also, once a callback is enqueued, there's no way to cancel this operation. * * This is often used to break down bigger tasks into smaller steps (a form * of cooperative multitasking). * * ```php * $loop->futureTick(function () { * echo 'b'; * }); * $loop->futureTick(function () { * echo 'c'; * }); * echo 'a'; * ``` * * See also [example #3](examples). * * @param callable $listener The callback to invoke. * * @return void */ public function futureTick($listener); /** * Register a listener to be notified when a signal has been caught by this process. * * This is useful to catch user interrupt signals or shutdown signals from * tools like `supervisor` or `systemd`. * * The second parameter MUST be a listener callback function that accepts * the signal as its only parameter. * If you don't use the signal inside your listener callback function * you MAY use a function which has no parameters at all. * * The listener callback function MUST NOT throw an `Exception`. * The return value of the listener callback function will be ignored and has * no effect, so for performance reasons you're recommended to not return * any excessive data structures. * * ```php * $loop->addSignal(SIGINT, function (int $signal) { * echo 'Caught user interrupt signal' . PHP_EOL; * }); * ``` * * See also [example #4](examples). * * Signaling is only available on Unix-like platforms, Windows isn't * supported due to operating system limitations. * This method may throw a `BadMethodCallException` if signals aren't * supported on this platform, for example when required extensions are * missing. * * **Note: A listener can only be added once to the same signal, any * attempts to add it more than once will be ignored.** * * @param int $signal * @param callable $listener * * @throws \BadMethodCallException when signals aren't supported on this * platform, for example when required extensions are missing. * * @return void */ public function addSignal($signal, $listener); /** * Removes a previously added signal listener. * * ```php * $loop->removeSignal(SIGINT, $listener); * ``` * * Any attempts to remove listeners that aren't registered will be ignored. * * @param int $signal * @param callable $listener * * @return void */ public function removeSignal($signal, $listener); /** * Run the event loop until there are no more tasks to perform. * * For many applications, this method is the only directly visible * invocation on the event loop. * As a rule of thumb, it is usually recommended to attach everything to the * same loop instance and then run the loop once at the bottom end of the * application. * * ```php * $loop->run(); * ``` * * This method will keep the loop running until there are no more tasks * to perform. In other words: This method will block until the last * timer, stream and/or signal has been removed. * * Likewise, it is imperative to ensure the application actually invokes * this method once. Adding listeners to the loop and missing to actually * run it will result in the application exiting without actually waiting * for any of the attached listeners. * * This method MUST NOT be called while the loop is already running. * This method MAY be called more than once after it has explicitly been * [`stop()`ped](#stop) or after it automatically stopped because it * previously did no longer have anything to do. * * @return void */ public function run(); /** * Instruct a running event loop to stop. * * This method is considered advanced usage and should be used with care. * As a rule of thumb, it is usually recommended to let the loop stop * only automatically when it no longer has anything to do. * * This method can be used to explicitly instruct the event loop to stop: * * ```php * $loop->addTimer(3.0, function () use ($loop) { * $loop->stop(); * }); * ``` * * Calling this method on a loop instance that is not currently running or * on a loop instance that has already been stopped has no effect. * * @return void */ public function stop(); } <?php namespace _PHPStan_7d8742a37\React\EventLoop; use BadMethodCallException; use Event; use EventBase; use _PHPStan_7d8742a37\React\EventLoop\Tick\FutureTickQueue; use _PHPStan_7d8742a37\React\EventLoop\Timer\Timer; use SplObjectStorage; /** * [Deprecated] An `ext-libevent` based event loop. * * This uses the [`libevent` PECL extension](https://pecl.php.net/package/libevent), * that provides an interface to `libevent` library. * `libevent` itself supports a number of system-specific backends (epoll, kqueue). * * This event loop does only work with PHP 5. * An [unofficial update](https://github.com/php/pecl-event-libevent/pull/2) for * PHP 7 does exist, but it is known to cause regular crashes due to `SEGFAULT`s. * To reiterate: Using this event loop on PHP 7 is not recommended. * Accordingly, neither the [`Loop` class](#loop) nor the deprecated * [`Factory` class](#factory) will try to use this event loop on PHP 7. * * This event loop is known to trigger a readable listener only if * the stream *becomes* readable (edge-triggered) and may not trigger if the * stream has already been readable from the beginning. * This also implies that a stream may not be recognized as readable when data * is still left in PHP's internal stream buffers. * As such, it's recommended to use `stream_set_read_buffer($stream, 0);` * to disable PHP's internal read buffer in this case. * See also [`addReadStream()`](#addreadstream) for more details. * * @link https://pecl.php.net/package/libevent * @deprecated 1.2.0, use [`ExtEventLoop`](#exteventloop) instead. */ final class ExtLibeventLoop implements LoopInterface { /** @internal */ const MICROSECONDS_PER_SECOND = 1000000; private $eventBase; private $futureTickQueue; private $timerCallback; private $timerEvents; private $streamCallback; private $readEvents = array(); private $writeEvents = array(); private $readListeners = array(); private $writeListeners = array(); private $running; private $signals; private $signalEvents = array(); public function __construct() { if (!\function_exists('event_base_new')) { throw new BadMethodCallException('Cannot create ExtLibeventLoop, ext-libevent extension missing'); } $this->eventBase = \event_base_new(); $this->futureTickQueue = new FutureTickQueue(); $this->timerEvents = new SplObjectStorage(); $this->signals = new SignalsHandler(); $this->createTimerCallback(); $this->createStreamCallback(); } public function addReadStream($stream, $listener) { $key = (int) $stream; if (isset($this->readListeners[$key])) { return; } $event = \event_new(); \event_set($event, $stream, \EV_PERSIST | \EV_READ, $this->streamCallback); \event_base_set($event, $this->eventBase); \event_add($event); $this->readEvents[$key] = $event; $this->readListeners[$key] = $listener; } public function addWriteStream($stream, $listener) { $key = (int) $stream; if (isset($this->writeListeners[$key])) { return; } $event = \event_new(); \event_set($event, $stream, \EV_PERSIST | \EV_WRITE, $this->streamCallback); \event_base_set($event, $this->eventBase); \event_add($event); $this->writeEvents[$key] = $event; $this->writeListeners[$key] = $listener; } public function removeReadStream($stream) { $key = (int) $stream; if (isset($this->readListeners[$key])) { $event = $this->readEvents[$key]; \event_del($event); \event_free($event); unset($this->readEvents[$key], $this->readListeners[$key]); } } public function removeWriteStream($stream) { $key = (int) $stream; if (isset($this->writeListeners[$key])) { $event = $this->writeEvents[$key]; \event_del($event); \event_free($event); unset($this->writeEvents[$key], $this->writeListeners[$key]); } } public function addTimer($interval, $callback) { $timer = new Timer($interval, $callback, \false); $this->scheduleTimer($timer); return $timer; } public function addPeriodicTimer($interval, $callback) { $timer = new Timer($interval, $callback, \true); $this->scheduleTimer($timer); return $timer; } public function cancelTimer(TimerInterface $timer) { if ($this->timerEvents->contains($timer)) { $event = $this->timerEvents[$timer]; \event_del($event); \event_free($event); $this->timerEvents->detach($timer); } } public function futureTick($listener) { $this->futureTickQueue->add($listener); } public function addSignal($signal, $listener) { $this->signals->add($signal, $listener); if (!isset($this->signalEvents[$signal])) { $this->signalEvents[$signal] = \event_new(); \event_set($this->signalEvents[$signal], $signal, \EV_PERSIST | \EV_SIGNAL, array($this->signals, 'call')); \event_base_set($this->signalEvents[$signal], $this->eventBase); \event_add($this->signalEvents[$signal]); } } public function removeSignal($signal, $listener) { $this->signals->remove($signal, $listener); if (isset($this->signalEvents[$signal]) && $this->signals->count($signal) === 0) { \event_del($this->signalEvents[$signal]); \event_free($this->signalEvents[$signal]); unset($this->signalEvents[$signal]); } } public function run() { $this->running = \true; while ($this->running) { $this->futureTickQueue->tick(); $flags = \EVLOOP_ONCE; if (!$this->running || !$this->futureTickQueue->isEmpty()) { $flags |= \EVLOOP_NONBLOCK; } elseif (!$this->readEvents && !$this->writeEvents && !$this->timerEvents->count() && $this->signals->isEmpty()) { break; } \event_base_loop($this->eventBase, $flags); } } public function stop() { $this->running = \false; } /** * Schedule a timer for execution. * * @param TimerInterface $timer */ private function scheduleTimer(TimerInterface $timer) { $this->timerEvents[$timer] = $event = \event_timer_new(); \event_timer_set($event, $this->timerCallback, $timer); \event_base_set($event, $this->eventBase); \event_add($event, $timer->getInterval() * self::MICROSECONDS_PER_SECOND); } /** * Create a callback used as the target of timer events. * * A reference is kept to the callback for the lifetime of the loop * to prevent "Cannot destroy active lambda function" fatal error from * the event extension. */ private function createTimerCallback() { $that = $this; $timers = $this->timerEvents; $this->timerCallback = function ($_, $__, $timer) use($timers, $that) { \call_user_func($timer->getCallback(), $timer); // Timer already cancelled ... if (!$timers->contains($timer)) { return; } // Reschedule periodic timers ... if ($timer->isPeriodic()) { \event_add($timers[$timer], $timer->getInterval() * ExtLibeventLoop::MICROSECONDS_PER_SECOND); // Clean-up one shot timers ... } else { $that->cancelTimer($timer); } }; } /** * Create a callback used as the target of stream events. * * A reference is kept to the callback for the lifetime of the loop * to prevent "Cannot destroy active lambda function" fatal error from * the event extension. */ private function createStreamCallback() { $read =& $this->readListeners; $write =& $this->writeListeners; $this->streamCallback = function ($stream, $flags) use(&$read, &$write) { $key = (int) $stream; if (\EV_READ === (\EV_READ & $flags) && isset($read[$key])) { \call_user_func($read[$key], $stream); } if (\EV_WRITE === (\EV_WRITE & $flags) && isset($write[$key])) { \call_user_func($write[$key], $stream); } }; } } <?php namespace _PHPStan_7d8742a37\React\EventLoop\Tick; use SplQueue; /** * A tick queue implementation that can hold multiple callback functions * * This class should only be used internally, see LoopInterface instead. * * @see LoopInterface * @internal */ final class FutureTickQueue { private $queue; public function __construct() { $this->queue = new SplQueue(); } /** * Add a callback to be invoked on a future tick of the event loop. * * Callbacks are guaranteed to be executed in the order they are enqueued. * * @param callable $listener The callback to invoke. */ public function add($listener) { $this->queue->enqueue($listener); } /** * Flush the callback queue. */ public function tick() { // Only invoke as many callbacks as were on the queue when tick() was called. $count = $this->queue->count(); while ($count--) { \call_user_func($this->queue->dequeue()); } } /** * Check if the next tick queue is empty. * * @return boolean */ public function isEmpty() { return $this->queue->isEmpty(); } } <?php namespace _PHPStan_7d8742a37\React\EventLoop; /** * The `Loop` class exists as a convenient way to get the currently relevant loop */ final class Loop { /** * @var ?LoopInterface */ private static $instance; /** @var bool */ private static $stopped = \false; /** * Returns the event loop. * When no loop is set, it will call the factory to create one. * * This method always returns an instance implementing `LoopInterface`, * the actual event loop implementation is an implementation detail. * * This method is the preferred way to get the event loop and using * Factory::create has been deprecated. * * @return LoopInterface */ public static function get() { if (self::$instance instanceof LoopInterface) { return self::$instance; } self::$instance = $loop = Factory::create(); // Automatically run loop at end of program, unless already started or stopped explicitly. // This is tested using child processes, so coverage is actually 100%, see BinTest. // @codeCoverageIgnoreStart $hasRun = \false; $loop->futureTick(function () use(&$hasRun) { $hasRun = \true; }); $stopped =& self::$stopped; \register_shutdown_function(function () use($loop, &$hasRun, &$stopped) { // Don't run if we're coming from a fatal error (uncaught exception). $error = \error_get_last(); if ((isset($error['type']) ? $error['type'] : 0) & (\E_ERROR | \E_CORE_ERROR | \E_COMPILE_ERROR | \E_USER_ERROR | \E_RECOVERABLE_ERROR)) { return; } if (!$hasRun && !$stopped) { $loop->run(); } }); // @codeCoverageIgnoreEnd return self::$instance; } /** * Internal undocumented method, behavior might change or throw in the * future. Use with caution and at your own risk. * * @internal * @return void */ public static function set(LoopInterface $loop) { self::$instance = $loop; } /** * [Advanced] Register a listener to be notified when a stream is ready to read. * * @param resource $stream * @param callable $listener * @return void * @throws \Exception * @see LoopInterface::addReadStream() */ public static function addReadStream($stream, $listener) { // create loop instance on demand (legacy PHP < 7 doesn't like ternaries in method calls) if (self::$instance === null) { self::get(); } self::$instance->addReadStream($stream, $listener); } /** * [Advanced] Register a listener to be notified when a stream is ready to write. * * @param resource $stream * @param callable $listener * @return void * @throws \Exception * @see LoopInterface::addWriteStream() */ public static function addWriteStream($stream, $listener) { // create loop instance on demand (legacy PHP < 7 doesn't like ternaries in method calls) if (self::$instance === null) { self::get(); } self::$instance->addWriteStream($stream, $listener); } /** * Remove the read event listener for the given stream. * * @param resource $stream * @return void * @see LoopInterface::removeReadStream() */ public static function removeReadStream($stream) { if (self::$instance !== null) { self::$instance->removeReadStream($stream); } } /** * Remove the write event listener for the given stream. * * @param resource $stream * @return void * @see LoopInterface::removeWriteStream() */ public static function removeWriteStream($stream) { if (self::$instance !== null) { self::$instance->removeWriteStream($stream); } } /** * Enqueue a callback to be invoked once after the given interval. * * @param float $interval * @param callable $callback * @return TimerInterface * @see LoopInterface::addTimer() */ public static function addTimer($interval, $callback) { // create loop instance on demand (legacy PHP < 7 doesn't like ternaries in method calls) if (self::$instance === null) { self::get(); } return self::$instance->addTimer($interval, $callback); } /** * Enqueue a callback to be invoked repeatedly after the given interval. * * @param float $interval * @param callable $callback * @return TimerInterface * @see LoopInterface::addPeriodicTimer() */ public static function addPeriodicTimer($interval, $callback) { // create loop instance on demand (legacy PHP < 7 doesn't like ternaries in method calls) if (self::$instance === null) { self::get(); } return self::$instance->addPeriodicTimer($interval, $callback); } /** * Cancel a pending timer. * * @param TimerInterface $timer * @return void * @see LoopInterface::cancelTimer() */ public static function cancelTimer(TimerInterface $timer) { if (self::$instance !== null) { self::$instance->cancelTimer($timer); } } /** * Schedule a callback to be invoked on a future tick of the event loop. * * @param callable $listener * @return void * @see LoopInterface::futureTick() */ public static function futureTick($listener) { // create loop instance on demand (legacy PHP < 7 doesn't like ternaries in method calls) if (self::$instance === null) { self::get(); } self::$instance->futureTick($listener); } /** * Register a listener to be notified when a signal has been caught by this process. * * @param int $signal * @param callable $listener * @return void * @see LoopInterface::addSignal() */ public static function addSignal($signal, $listener) { // create loop instance on demand (legacy PHP < 7 doesn't like ternaries in method calls) if (self::$instance === null) { self::get(); } self::$instance->addSignal($signal, $listener); } /** * Removes a previously added signal listener. * * @param int $signal * @param callable $listener * @return void * @see LoopInterface::removeSignal() */ public static function removeSignal($signal, $listener) { if (self::$instance !== null) { self::$instance->removeSignal($signal, $listener); } } /** * Run the event loop until there are no more tasks to perform. * * @return void * @see LoopInterface::run() */ public static function run() { // create loop instance on demand (legacy PHP < 7 doesn't like ternaries in method calls) if (self::$instance === null) { self::get(); } self::$instance->run(); } /** * Instruct a running event loop to stop. * * @return void * @see LoopInterface::stop() */ public static function stop() { self::$stopped = \true; if (self::$instance !== null) { self::$instance->stop(); } } } <?php namespace _PHPStan_7d8742a37\React\EventLoop; interface TimerInterface { /** * Get the interval after which this timer will execute, in seconds * * @return float */ public function getInterval(); /** * Get the callback that will be executed when this timer elapses * * @return callable */ public function getCallback(); /** * Determine whether the time is periodic * * @return bool */ public function isPeriodic(); } <?php namespace _PHPStan_7d8742a37\React\EventLoop; use _PHPStan_7d8742a37\React\EventLoop\Tick\FutureTickQueue; use _PHPStan_7d8742a37\React\EventLoop\Timer\Timer; use _PHPStan_7d8742a37\React\EventLoop\Timer\Timers; /** * A `stream_select()` based event loop. * * This uses the [`stream_select()`](https://www.php.net/manual/en/function.stream-select.php) * function and is the only implementation that works out of the box with PHP. * * This event loop works out of the box on PHP 5.4 through PHP 8+ and HHVM. * This means that no installation is required and this library works on all * platforms and supported PHP versions. * Accordingly, the [`Loop` class](#loop) and the deprecated [`Factory`](#factory) * will use this event loop by default if you do not install any of the event loop * extensions listed below. * * Under the hood, it does a simple `select` system call. * This system call is limited to the maximum file descriptor number of * `FD_SETSIZE` (platform dependent, commonly 1024) and scales with `O(m)` * (`m` being the maximum file descriptor number passed). * This means that you may run into issues when handling thousands of streams * concurrently and you may want to look into using one of the alternative * event loop implementations listed below in this case. * If your use case is among the many common use cases that involve handling only * dozens or a few hundred streams at once, then this event loop implementation * performs really well. * * If you want to use signal handling (see also [`addSignal()`](#addsignal) below), * this event loop implementation requires `ext-pcntl`. * This extension is only available for Unix-like platforms and does not support * Windows. * It is commonly installed as part of many PHP distributions. * If this extension is missing (or you're running on Windows), signal handling is * not supported and throws a `BadMethodCallException` instead. * * This event loop is known to rely on wall-clock time to schedule future timers * when using any version before PHP 7.3, because a monotonic time source is * only available as of PHP 7.3 (`hrtime()`). * While this does not affect many common use cases, this is an important * distinction for programs that rely on a high time precision or on systems * that are subject to discontinuous time adjustments (time jumps). * This means that if you schedule a timer to trigger in 30s on PHP < 7.3 and * then adjust your system time forward by 20s, the timer may trigger in 10s. * See also [`addTimer()`](#addtimer) for more details. * * @link https://www.php.net/manual/en/function.stream-select.php */ final class StreamSelectLoop implements LoopInterface { /** @internal */ const MICROSECONDS_PER_SECOND = 1000000; private $futureTickQueue; private $timers; private $readStreams = array(); private $readListeners = array(); private $writeStreams = array(); private $writeListeners = array(); private $running; private $pcntl = \false; private $pcntlPoll = \false; private $signals; public function __construct() { $this->futureTickQueue = new FutureTickQueue(); $this->timers = new Timers(); $this->pcntl = \function_exists('pcntl_signal') && \function_exists('pcntl_signal_dispatch'); $this->pcntlPoll = $this->pcntl && !\function_exists('pcntl_async_signals'); $this->signals = new SignalsHandler(); // prefer async signals if available (PHP 7.1+) or fall back to dispatching on each tick if ($this->pcntl && !$this->pcntlPoll) { \pcntl_async_signals(\true); } } public function addReadStream($stream, $listener) { $key = (int) $stream; if (!isset($this->readStreams[$key])) { $this->readStreams[$key] = $stream; $this->readListeners[$key] = $listener; } } public function addWriteStream($stream, $listener) { $key = (int) $stream; if (!isset($this->writeStreams[$key])) { $this->writeStreams[$key] = $stream; $this->writeListeners[$key] = $listener; } } public function removeReadStream($stream) { $key = (int) $stream; unset($this->readStreams[$key], $this->readListeners[$key]); } public function removeWriteStream($stream) { $key = (int) $stream; unset($this->writeStreams[$key], $this->writeListeners[$key]); } public function addTimer($interval, $callback) { $timer = new Timer($interval, $callback, \false); $this->timers->add($timer); return $timer; } public function addPeriodicTimer($interval, $callback) { $timer = new Timer($interval, $callback, \true); $this->timers->add($timer); return $timer; } public function cancelTimer(TimerInterface $timer) { $this->timers->cancel($timer); } public function futureTick($listener) { $this->futureTickQueue->add($listener); } public function addSignal($signal, $listener) { if ($this->pcntl === \false) { throw new \BadMethodCallException('Event loop feature "signals" isn\'t supported by the "StreamSelectLoop"'); } $first = $this->signals->count($signal) === 0; $this->signals->add($signal, $listener); if ($first) { \pcntl_signal($signal, array($this->signals, 'call')); } } public function removeSignal($signal, $listener) { if (!$this->signals->count($signal)) { return; } $this->signals->remove($signal, $listener); if ($this->signals->count($signal) === 0) { \pcntl_signal($signal, \SIG_DFL); } } public function run() { $this->running = \true; while ($this->running) { $this->futureTickQueue->tick(); $this->timers->tick(); // Future-tick queue has pending callbacks ... if (!$this->running || !$this->futureTickQueue->isEmpty()) { $timeout = 0; // There is a pending timer, only block until it is due ... } elseif ($scheduledAt = $this->timers->getFirst()) { $timeout = $scheduledAt - $this->timers->getTime(); if ($timeout < 0) { $timeout = 0; } else { // Convert float seconds to int microseconds. // Ensure we do not exceed maximum integer size, which may // cause the loop to tick once every ~35min on 32bit systems. $timeout *= self::MICROSECONDS_PER_SECOND; $timeout = $timeout > \PHP_INT_MAX ? \PHP_INT_MAX : (int) $timeout; } // The only possible event is stream or signal activity, so wait forever ... } elseif ($this->readStreams || $this->writeStreams || !$this->signals->isEmpty()) { $timeout = null; // There's nothing left to do ... } else { break; } $this->waitForStreamActivity($timeout); } } public function stop() { $this->running = \false; } /** * Wait/check for stream activity, or until the next timer is due. * * @param integer|null $timeout Activity timeout in microseconds, or null to wait forever. */ private function waitForStreamActivity($timeout) { $read = $this->readStreams; $write = $this->writeStreams; $available = $this->streamSelect($read, $write, $timeout); if ($this->pcntlPoll) { \pcntl_signal_dispatch(); } if (\false === $available) { // if a system call has been interrupted, // we cannot rely on it's outcome return; } foreach ($read as $stream) { $key = (int) $stream; if (isset($this->readListeners[$key])) { \call_user_func($this->readListeners[$key], $stream); } } foreach ($write as $stream) { $key = (int) $stream; if (isset($this->writeListeners[$key])) { \call_user_func($this->writeListeners[$key], $stream); } } } /** * Emulate a stream_select() implementation that does not break when passed * empty stream arrays. * * @param array $read An array of read streams to select upon. * @param array $write An array of write streams to select upon. * @param int|null $timeout Activity timeout in microseconds, or null to wait forever. * * @return int|false The total number of streams that are ready for read/write. * Can return false if stream_select() is interrupted by a signal. */ private function streamSelect(array &$read, array &$write, $timeout) { if ($read || $write) { // We do not usually use or expose the `exceptfds` parameter passed to the underlying `select`. // However, Windows does not report failed connection attempts in `writefds` passed to `select` like most other platforms. // Instead, it uses `writefds` only for successful connection attempts and `exceptfds` for failed connection attempts. // We work around this by adding all sockets that look like a pending connection attempt to `exceptfds` automatically on Windows and merge it back later. // This ensures the public API matches other loop implementations across all platforms (see also test suite or rather test matrix). // Lacking better APIs, every write-only socket that has not yet read any data is assumed to be in a pending connection attempt state. // @link https://docs.microsoft.com/de-de/windows/win32/api/winsock2/nf-winsock2-select $except = null; if (\DIRECTORY_SEPARATOR === '\\') { $except = array(); foreach ($write as $key => $socket) { if (!isset($read[$key]) && @\ftell($socket) === 0) { $except[$key] = $socket; } } } /** @var ?callable $previous */ $previous = \set_error_handler(function ($errno, $errstr) use(&$previous) { // suppress warnings that occur when `stream_select()` is interrupted by a signal // PHP defines `EINTR` through `ext-sockets` or `ext-pcntl`, otherwise use common default (Linux & Mac) $eintr = \defined('SOCKET_EINTR') ? \SOCKET_EINTR : (\defined('PCNTL_EINTR') ? \PCNTL_EINTR : 4); if ($errno === \E_WARNING && \strpos($errstr, '[' . $eintr . ']: ') !== \false) { return; } // forward any other error to registered error handler or print warning return $previous !== null ? \call_user_func_array($previous, \func_get_args()) : \false; }); try { $ret = \stream_select($read, $write, $except, $timeout === null ? null : 0, $timeout); \restore_error_handler(); } catch (\Throwable $e) { // @codeCoverageIgnoreStart \restore_error_handler(); throw $e; } catch (\Exception $e) { \restore_error_handler(); throw $e; } // @codeCoverageIgnoreEnd if ($except) { $write = \array_merge($write, $except); } return $ret; } if ($timeout > 0) { \usleep($timeout); } elseif ($timeout === null) { // wait forever (we only reach this if we're only awaiting signals) // this may be interrupted and return earlier when a signal is received \sleep(\PHP_INT_MAX); } return 0; } } <?php namespace _PHPStan_7d8742a37\React\EventLoop; use BadMethodCallException; use _PHPStan_7d8742a37\libev\EventLoop; use _PHPStan_7d8742a37\libev\IOEvent; use _PHPStan_7d8742a37\libev\SignalEvent; use _PHPStan_7d8742a37\libev\TimerEvent; use _PHPStan_7d8742a37\React\EventLoop\Tick\FutureTickQueue; use _PHPStan_7d8742a37\React\EventLoop\Timer\Timer; use SplObjectStorage; /** * [Deprecated] An `ext-libev` based event loop. * * This uses an [unofficial `libev` extension](https://github.com/m4rw3r/php-libev), * that provides an interface to `libev` library. * `libev` itself supports a number of system-specific backends (epoll, kqueue). * * This loop does only work with PHP 5. * An update for PHP 7 is [unlikely](https://github.com/m4rw3r/php-libev/issues/8) * to happen any time soon. * * @see https://github.com/m4rw3r/php-libev * @see https://gist.github.com/1688204 * @deprecated 1.2.0, use [`ExtEvLoop`](#extevloop) instead. */ final class ExtLibevLoop implements LoopInterface { private $loop; private $futureTickQueue; private $timerEvents; private $readEvents = array(); private $writeEvents = array(); private $running; private $signals; private $signalEvents = array(); public function __construct() { if (!\class_exists('_PHPStan_7d8742a37\\libev\\EventLoop', \false)) { throw new BadMethodCallException('Cannot create ExtLibevLoop, ext-libev extension missing'); } $this->loop = new EventLoop(); $this->futureTickQueue = new FutureTickQueue(); $this->timerEvents = new SplObjectStorage(); $this->signals = new SignalsHandler(); } public function addReadStream($stream, $listener) { if (isset($this->readEvents[(int) $stream])) { return; } $callback = function () use($stream, $listener) { \call_user_func($listener, $stream); }; $event = new IOEvent($callback, $stream, IOEvent::READ); $this->loop->add($event); $this->readEvents[(int) $stream] = $event; } public function addWriteStream($stream, $listener) { if (isset($this->writeEvents[(int) $stream])) { return; } $callback = function () use($stream, $listener) { \call_user_func($listener, $stream); }; $event = new IOEvent($callback, $stream, IOEvent::WRITE); $this->loop->add($event); $this->writeEvents[(int) $stream] = $event; } public function removeReadStream($stream) { $key = (int) $stream; if (isset($this->readEvents[$key])) { $this->readEvents[$key]->stop(); $this->loop->remove($this->readEvents[$key]); unset($this->readEvents[$key]); } } public function removeWriteStream($stream) { $key = (int) $stream; if (isset($this->writeEvents[$key])) { $this->writeEvents[$key]->stop(); $this->loop->remove($this->writeEvents[$key]); unset($this->writeEvents[$key]); } } public function addTimer($interval, $callback) { $timer = new Timer($interval, $callback, \false); $that = $this; $timers = $this->timerEvents; $callback = function () use($timer, $timers, $that) { \call_user_func($timer->getCallback(), $timer); if ($timers->contains($timer)) { $that->cancelTimer($timer); } }; $event = new TimerEvent($callback, $timer->getInterval()); $this->timerEvents->attach($timer, $event); $this->loop->add($event); return $timer; } public function addPeriodicTimer($interval, $callback) { $timer = new Timer($interval, $callback, \true); $callback = function () use($timer) { \call_user_func($timer->getCallback(), $timer); }; $event = new TimerEvent($callback, $timer->getInterval(), $timer->getInterval()); $this->timerEvents->attach($timer, $event); $this->loop->add($event); return $timer; } public function cancelTimer(TimerInterface $timer) { if (isset($this->timerEvents[$timer])) { $this->loop->remove($this->timerEvents[$timer]); $this->timerEvents->detach($timer); } } public function futureTick($listener) { $this->futureTickQueue->add($listener); } public function addSignal($signal, $listener) { $this->signals->add($signal, $listener); if (!isset($this->signalEvents[$signal])) { $signals = $this->signals; $this->signalEvents[$signal] = new SignalEvent(function () use($signals, $signal) { $signals->call($signal); }, $signal); $this->loop->add($this->signalEvents[$signal]); } } public function removeSignal($signal, $listener) { $this->signals->remove($signal, $listener); if (isset($this->signalEvents[$signal]) && $this->signals->count($signal) === 0) { $this->signalEvents[$signal]->stop(); $this->loop->remove($this->signalEvents[$signal]); unset($this->signalEvents[$signal]); } } public function run() { $this->running = \true; while ($this->running) { $this->futureTickQueue->tick(); $flags = EventLoop::RUN_ONCE; if (!$this->running || !$this->futureTickQueue->isEmpty()) { $flags |= EventLoop::RUN_NOWAIT; } elseif (!$this->readEvents && !$this->writeEvents && !$this->timerEvents->count() && $this->signals->isEmpty()) { break; } $this->loop->run($flags); } } public function stop() { $this->running = \false; } } <?php namespace _PHPStan_7d8742a37\React\EventLoop\Timer; use _PHPStan_7d8742a37\React\EventLoop\TimerInterface; /** * The actual connection implementation for TimerInterface * * This class should only be used internally, see TimerInterface instead. * * @see TimerInterface * @internal */ final class Timer implements TimerInterface { const MIN_INTERVAL = 1.0E-6; private $interval; private $callback; private $periodic; /** * Constructor initializes the fields of the Timer * * @param float $interval The interval after which this timer will execute, in seconds * @param callable $callback The callback that will be executed when this timer elapses * @param bool $periodic Whether the time is periodic */ public function __construct($interval, $callback, $periodic = \false) { if ($interval < self::MIN_INTERVAL) { $interval = self::MIN_INTERVAL; } $this->interval = (float) $interval; $this->callback = $callback; $this->periodic = (bool) $periodic; } public function getInterval() { return $this->interval; } public function getCallback() { return $this->callback; } public function isPeriodic() { return $this->periodic; } } <?php namespace _PHPStan_7d8742a37\React\EventLoop\Timer; use _PHPStan_7d8742a37\React\EventLoop\TimerInterface; /** * A scheduler implementation that can hold multiple timer instances * * This class should only be used internally, see TimerInterface instead. * * @see TimerInterface * @internal */ final class Timers { private $time; private $timers = array(); private $schedule = array(); private $sorted = \true; private $useHighResolution; public function __construct() { // prefer high-resolution timer, available as of PHP 7.3+ $this->useHighResolution = \function_exists('hrtime'); } public function updateTime() { return $this->time = $this->useHighResolution ? \hrtime(\true) * 1.0E-9 : \microtime(\true); } public function getTime() { return $this->time ?: $this->updateTime(); } public function add(TimerInterface $timer) { $id = \PHP_VERSION_ID < 70200 ? \spl_object_hash($timer) : \spl_object_id($timer); $this->timers[$id] = $timer; $this->schedule[$id] = $timer->getInterval() + $this->updateTime(); $this->sorted = \false; } public function contains(TimerInterface $timer) { $id = \PHP_VERSION_ID < 70200 ? \spl_object_hash($timer) : \spl_object_id($timer); return isset($this->timers[$id]); } public function cancel(TimerInterface $timer) { $id = \PHP_VERSION_ID < 70200 ? \spl_object_hash($timer) : \spl_object_id($timer); unset($this->timers[$id], $this->schedule[$id]); } public function getFirst() { // ensure timers are sorted to simply accessing next (first) one if (!$this->sorted) { $this->sorted = \true; \asort($this->schedule); } return \reset($this->schedule); } public function isEmpty() { return \count($this->timers) === 0; } public function tick() { // hot path: skip timers if nothing is scheduled if (!$this->schedule) { return; } // ensure timers are sorted so we can execute in order if (!$this->sorted) { $this->sorted = \true; \asort($this->schedule); } $time = $this->updateTime(); foreach ($this->schedule as $id => $scheduled) { // schedule is ordered, so loop until first timer that is not scheduled for execution now if ($scheduled >= $time) { break; } // skip any timers that are removed while we process the current schedule if (!isset($this->schedule[$id]) || $this->schedule[$id] !== $scheduled) { continue; } $timer = $this->timers[$id]; \call_user_func($timer->getCallback(), $timer); // re-schedule if this is a periodic timer and it has not been cancelled explicitly already if ($timer->isPeriodic() && isset($this->timers[$id])) { $this->schedule[$id] = $timer->getInterval() + $time; $this->sorted = \false; } else { unset($this->timers[$id], $this->schedule[$id]); } } } } <?php namespace _PHPStan_7d8742a37\React\EventLoop; /** * @internal */ final class SignalsHandler { private $signals = array(); public function add($signal, $listener) { if (!isset($this->signals[$signal])) { $this->signals[$signal] = array(); } if (\in_array($listener, $this->signals[$signal])) { return; } $this->signals[$signal][] = $listener; } public function remove($signal, $listener) { if (!isset($this->signals[$signal])) { return; } $index = \array_search($listener, $this->signals[$signal], \true); unset($this->signals[$signal][$index]); if (isset($this->signals[$signal]) && \count($this->signals[$signal]) === 0) { unset($this->signals[$signal]); } } public function call($signal) { if (!isset($this->signals[$signal])) { return; } foreach ($this->signals[$signal] as $listener) { \call_user_func($listener, $signal); } } public function count($signal) { if (!isset($this->signals[$signal])) { return 0; } return \count($this->signals[$signal]); } public function isEmpty() { return !$this->signals; } } <?php namespace _PHPStan_7d8742a37\React\EventLoop; use _PHPStan_7d8742a37\React\EventLoop\Tick\FutureTickQueue; use _PHPStan_7d8742a37\React\EventLoop\Timer\Timer; use SplObjectStorage; /** * An `ext-uv` based event loop. * * This loop uses the [`uv` PECL extension](https://pecl.php.net/package/uv), * that provides an interface to `libuv` library. * `libuv` itself supports a number of system-specific backends (epoll, kqueue). * * This loop is known to work with PHP 7+. * * @see https://github.com/bwoebi/php-uv */ final class ExtUvLoop implements LoopInterface { private $uv; private $futureTickQueue; private $timers; private $streamEvents = array(); private $readStreams = array(); private $writeStreams = array(); private $running; private $signals; private $signalEvents = array(); private $streamListener; public function __construct() { if (!\function_exists('uv_loop_new')) { throw new \BadMethodCallException('Cannot create LibUvLoop, ext-uv extension missing'); } $this->uv = \uv_loop_new(); $this->futureTickQueue = new FutureTickQueue(); $this->timers = new SplObjectStorage(); $this->streamListener = $this->createStreamListener(); $this->signals = new SignalsHandler(); } /** * Returns the underlying ext-uv event loop. (Internal ReactPHP use only.) * * @internal * * @return resource */ public function getUvLoop() { return $this->uv; } /** * {@inheritdoc} */ public function addReadStream($stream, $listener) { if (isset($this->readStreams[(int) $stream])) { return; } $this->readStreams[(int) $stream] = $listener; $this->addStream($stream); } /** * {@inheritdoc} */ public function addWriteStream($stream, $listener) { if (isset($this->writeStreams[(int) $stream])) { return; } $this->writeStreams[(int) $stream] = $listener; $this->addStream($stream); } /** * {@inheritdoc} */ public function removeReadStream($stream) { if (!isset($this->streamEvents[(int) $stream])) { return; } unset($this->readStreams[(int) $stream]); $this->removeStream($stream); } /** * {@inheritdoc} */ public function removeWriteStream($stream) { if (!isset($this->streamEvents[(int) $stream])) { return; } unset($this->writeStreams[(int) $stream]); $this->removeStream($stream); } /** * {@inheritdoc} */ public function addTimer($interval, $callback) { $timer = new Timer($interval, $callback, \false); $that = $this; $timers = $this->timers; $callback = function () use($timer, $timers, $that) { \call_user_func($timer->getCallback(), $timer); if ($timers->contains($timer)) { $that->cancelTimer($timer); } }; $event = \uv_timer_init($this->uv); $this->timers->attach($timer, $event); \uv_timer_start($event, $this->convertFloatSecondsToMilliseconds($interval), 0, $callback); return $timer; } /** * {@inheritdoc} */ public function addPeriodicTimer($interval, $callback) { $timer = new Timer($interval, $callback, \true); $callback = function () use($timer) { \call_user_func($timer->getCallback(), $timer); }; $interval = $this->convertFloatSecondsToMilliseconds($interval); $event = \uv_timer_init($this->uv); $this->timers->attach($timer, $event); \uv_timer_start($event, $interval, (int) $interval === 0 ? 1 : $interval, $callback); return $timer; } /** * {@inheritdoc} */ public function cancelTimer(TimerInterface $timer) { if (isset($this->timers[$timer])) { @\uv_timer_stop($this->timers[$timer]); $this->timers->detach($timer); } } /** * {@inheritdoc} */ public function futureTick($listener) { $this->futureTickQueue->add($listener); } public function addSignal($signal, $listener) { $this->signals->add($signal, $listener); if (!isset($this->signalEvents[$signal])) { $signals = $this->signals; $this->signalEvents[$signal] = \_PHPStan_7d8742a37\uv_signal_init($this->uv); \_PHPStan_7d8742a37\uv_signal_start($this->signalEvents[$signal], function () use($signals, $signal) { $signals->call($signal); }, $signal); } } public function removeSignal($signal, $listener) { $this->signals->remove($signal, $listener); if (isset($this->signalEvents[$signal]) && $this->signals->count($signal) === 0) { \uv_signal_stop($this->signalEvents[$signal]); unset($this->signalEvents[$signal]); } } /** * {@inheritdoc} */ public function run() { $this->running = \true; while ($this->running) { $this->futureTickQueue->tick(); $hasPendingCallbacks = !$this->futureTickQueue->isEmpty(); $wasJustStopped = !$this->running; $nothingLeftToDo = !$this->readStreams && !$this->writeStreams && !$this->timers->count() && $this->signals->isEmpty(); // Use UV::RUN_ONCE when there are only I/O events active in the loop and block until one of those triggers, // otherwise use UV::RUN_NOWAIT. // @link http://docs.libuv.org/en/v1.x/loop.html#c.uv_run $flags = \UV::RUN_ONCE; if ($wasJustStopped || $hasPendingCallbacks) { $flags = \UV::RUN_NOWAIT; } elseif ($nothingLeftToDo) { break; } \uv_run($this->uv, $flags); } } /** * {@inheritdoc} */ public function stop() { $this->running = \false; } private function addStream($stream) { if (!isset($this->streamEvents[(int) $stream])) { $this->streamEvents[(int) $stream] = \_PHPStan_7d8742a37\uv_poll_init_socket($this->uv, $stream); } if ($this->streamEvents[(int) $stream] !== \false) { $this->pollStream($stream); } } private function removeStream($stream) { if (!isset($this->streamEvents[(int) $stream])) { return; } if (!isset($this->readStreams[(int) $stream]) && !isset($this->writeStreams[(int) $stream])) { \uv_poll_stop($this->streamEvents[(int) $stream]); \uv_close($this->streamEvents[(int) $stream]); unset($this->streamEvents[(int) $stream]); return; } $this->pollStream($stream); } private function pollStream($stream) { if (!isset($this->streamEvents[(int) $stream])) { return; } $flags = 0; if (isset($this->readStreams[(int) $stream])) { $flags |= \UV::READABLE; } if (isset($this->writeStreams[(int) $stream])) { $flags |= \UV::WRITABLE; } \uv_poll_start($this->streamEvents[(int) $stream], $flags, $this->streamListener); } /** * Create a stream listener * * @return callable Returns a callback */ private function createStreamListener() { $callback = function ($event, $status, $events, $stream) { // libuv automatically stops polling on error, re-enable polling to match other loop implementations if ($status !== 0) { $this->pollStream($stream); // libuv may report no events on error, but this should still invoke stream listeners to report closed connections // re-enable both readable and writable, correct listeners will be checked below anyway if ($events === 0) { $events = \UV::READABLE | \UV::WRITABLE; } } if (isset($this->readStreams[(int) $stream]) && $events & \UV::READABLE) { \call_user_func($this->readStreams[(int) $stream], $stream); } if (isset($this->writeStreams[(int) $stream]) && $events & \UV::WRITABLE) { \call_user_func($this->writeStreams[(int) $stream], $stream); } }; return $callback; } /** * @param float $interval * @return int */ private function convertFloatSecondsToMilliseconds($interval) { if ($interval < 0) { return 0; } $maxValue = (int) (\PHP_INT_MAX / 1000); $intInterval = (int) $interval; if ($intInterval <= 0 && $interval > 1 || $intInterval >= $maxValue) { throw new \InvalidArgumentException("Interval overflow, value must be lower than '{$maxValue}', but '{$interval}' passed."); } return (int) \floor($interval * 1000); } } <?php namespace _PHPStan_7d8742a37\React\EventLoop; /** * [Deprecated] The `Factory` class exists as a convenient way to pick the best available event loop implementation. * * @deprecated 1.2.0 See Loop instead. * @see Loop */ final class Factory { /** * [Deprecated] Creates a new event loop instance * * ```php * // deprecated * $loop = React\EventLoop\Factory::create(); * * // new * $loop = React\EventLoop\Loop::get(); * ``` * * This method always returns an instance implementing `LoopInterface`, * the actual event loop implementation is an implementation detail. * * This method should usually only be called once at the beginning of the program. * * @deprecated 1.2.0 See Loop::get() instead. * @see Loop::get() * * @return LoopInterface */ public static function create() { $loop = self::construct(); Loop::set($loop); return $loop; } /** * @internal * @return LoopInterface */ private static function construct() { // @codeCoverageIgnoreStart if (\function_exists('uv_loop_new')) { // only use ext-uv on PHP 7 return new ExtUvLoop(); } if (\class_exists('_PHPStan_7d8742a37\\libev\\EventLoop', \false)) { return new ExtLibevLoop(); } if (\class_exists('EvLoop', \false)) { return new ExtEvLoop(); } if (\class_exists('EventBase', \false)) { return new ExtEventLoop(); } if (\function_exists('event_base_new') && \PHP_MAJOR_VERSION === 5) { // only use ext-libevent on PHP 5 for now return new ExtLibeventLoop(); } return new StreamSelectLoop(); // @codeCoverageIgnoreEnd } } <?php namespace _PHPStan_7d8742a37\React\EventLoop; use BadMethodCallException; use Event; use EventBase; use _PHPStan_7d8742a37\React\EventLoop\Tick\FutureTickQueue; use _PHPStan_7d8742a37\React\EventLoop\Timer\Timer; use SplObjectStorage; /** * An `ext-event` based event loop. * * This uses the [`event` PECL extension](https://pecl.php.net/package/event), * that provides an interface to `libevent` library. * `libevent` itself supports a number of system-specific backends (epoll, kqueue). * * This loop is known to work with PHP 5.4 through PHP 8+. * * @link https://pecl.php.net/package/event */ final class ExtEventLoop implements LoopInterface { private $eventBase; private $futureTickQueue; private $timerCallback; private $timerEvents; private $streamCallback; private $readEvents = array(); private $writeEvents = array(); private $readListeners = array(); private $writeListeners = array(); private $readRefs = array(); private $writeRefs = array(); private $running; private $signals; private $signalEvents = array(); public function __construct() { if (!\class_exists('EventBase', \false)) { throw new BadMethodCallException('Cannot create ExtEventLoop, ext-event extension missing'); } // support arbitrary file descriptors and not just sockets // Windows only has limited file descriptor support, so do not require this (will fail otherwise) // @link http://www.wangafu.net/~nickm/libevent-book/Ref2_eventbase.html#_setting_up_a_complicated_event_base $config = new \EventConfig(); if (\DIRECTORY_SEPARATOR !== '\\') { $config->requireFeatures(\EventConfig::FEATURE_FDS); } $this->eventBase = new EventBase($config); $this->futureTickQueue = new FutureTickQueue(); $this->timerEvents = new SplObjectStorage(); $this->signals = new SignalsHandler(); $this->createTimerCallback(); $this->createStreamCallback(); } public function __destruct() { // explicitly clear all references to Event objects to prevent SEGFAULTs on Windows foreach ($this->timerEvents as $timer) { $this->timerEvents->detach($timer); } $this->readEvents = array(); $this->writeEvents = array(); } public function addReadStream($stream, $listener) { $key = (int) $stream; if (isset($this->readListeners[$key])) { return; } $event = new Event($this->eventBase, $stream, Event::PERSIST | Event::READ, $this->streamCallback); $event->add(); $this->readEvents[$key] = $event; $this->readListeners[$key] = $listener; // ext-event does not increase refcount on stream resources for PHP 7+ // manually keep track of stream resource to prevent premature garbage collection if (\PHP_VERSION_ID >= 70000) { $this->readRefs[$key] = $stream; } } public function addWriteStream($stream, $listener) { $key = (int) $stream; if (isset($this->writeListeners[$key])) { return; } $event = new Event($this->eventBase, $stream, Event::PERSIST | Event::WRITE, $this->streamCallback); $event->add(); $this->writeEvents[$key] = $event; $this->writeListeners[$key] = $listener; // ext-event does not increase refcount on stream resources for PHP 7+ // manually keep track of stream resource to prevent premature garbage collection if (\PHP_VERSION_ID >= 70000) { $this->writeRefs[$key] = $stream; } } public function removeReadStream($stream) { $key = (int) $stream; if (isset($this->readEvents[$key])) { $this->readEvents[$key]->free(); unset($this->readEvents[$key], $this->readListeners[$key], $this->readRefs[$key]); } } public function removeWriteStream($stream) { $key = (int) $stream; if (isset($this->writeEvents[$key])) { $this->writeEvents[$key]->free(); unset($this->writeEvents[$key], $this->writeListeners[$key], $this->writeRefs[$key]); } } public function addTimer($interval, $callback) { $timer = new Timer($interval, $callback, \false); $this->scheduleTimer($timer); return $timer; } public function addPeriodicTimer($interval, $callback) { $timer = new Timer($interval, $callback, \true); $this->scheduleTimer($timer); return $timer; } public function cancelTimer(TimerInterface $timer) { if ($this->timerEvents->contains($timer)) { $this->timerEvents[$timer]->free(); $this->timerEvents->detach($timer); } } public function futureTick($listener) { $this->futureTickQueue->add($listener); } public function addSignal($signal, $listener) { $this->signals->add($signal, $listener); if (!isset($this->signalEvents[$signal])) { $this->signalEvents[$signal] = Event::signal($this->eventBase, $signal, array($this->signals, 'call')); $this->signalEvents[$signal]->add(); } } public function removeSignal($signal, $listener) { $this->signals->remove($signal, $listener); if (isset($this->signalEvents[$signal]) && $this->signals->count($signal) === 0) { $this->signalEvents[$signal]->free(); unset($this->signalEvents[$signal]); } } public function run() { $this->running = \true; while ($this->running) { $this->futureTickQueue->tick(); $flags = EventBase::LOOP_ONCE; if (!$this->running || !$this->futureTickQueue->isEmpty()) { $flags |= EventBase::LOOP_NONBLOCK; } elseif (!$this->readEvents && !$this->writeEvents && !$this->timerEvents->count() && $this->signals->isEmpty()) { break; } $this->eventBase->loop($flags); } } public function stop() { $this->running = \false; } /** * Schedule a timer for execution. * * @param TimerInterface $timer */ private function scheduleTimer(TimerInterface $timer) { $flags = Event::TIMEOUT; if ($timer->isPeriodic()) { $flags |= Event::PERSIST; } $event = new Event($this->eventBase, -1, $flags, $this->timerCallback, $timer); $this->timerEvents[$timer] = $event; $event->add($timer->getInterval()); } /** * Create a callback used as the target of timer events. * * A reference is kept to the callback for the lifetime of the loop * to prevent "Cannot destroy active lambda function" fatal error from * the event extension. */ private function createTimerCallback() { $timers = $this->timerEvents; $this->timerCallback = function ($_, $__, $timer) use($timers) { \call_user_func($timer->getCallback(), $timer); if (!$timer->isPeriodic() && $timers->contains($timer)) { $this->cancelTimer($timer); } }; } /** * Create a callback used as the target of stream events. * * A reference is kept to the callback for the lifetime of the loop * to prevent "Cannot destroy active lambda function" fatal error from * the event extension. */ private function createStreamCallback() { $read =& $this->readListeners; $write =& $this->writeListeners; $this->streamCallback = function ($stream, $flags) use(&$read, &$write) { $key = (int) $stream; if (Event::READ === (Event::READ & $flags) && isset($read[$key])) { \call_user_func($read[$key], $stream); } if (Event::WRITE === (Event::WRITE & $flags) && isset($write[$key])) { \call_user_func($write[$key], $stream); } }; } } The MIT License (MIT) Copyright (c) 2012 Christian Lück, Cees-Jan Kiewiet, Jan Sorgalla, Chris Boden, Igor Wiedler Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. <?php namespace _PHPStan_7d8742a37\React\Http; use _PHPStan_7d8742a37\Evenement\EventEmitter; use _PHPStan_7d8742a37\React\EventLoop\Loop; use _PHPStan_7d8742a37\React\EventLoop\LoopInterface; use _PHPStan_7d8742a37\React\Http\Io\IniUtil; use _PHPStan_7d8742a37\React\Http\Io\MiddlewareRunner; use _PHPStan_7d8742a37\React\Http\Io\StreamingServer; use _PHPStan_7d8742a37\React\Http\Middleware\LimitConcurrentRequestsMiddleware; use _PHPStan_7d8742a37\React\Http\Middleware\StreamingRequestMiddleware; use _PHPStan_7d8742a37\React\Http\Middleware\RequestBodyBufferMiddleware; use _PHPStan_7d8742a37\React\Http\Middleware\RequestBodyParserMiddleware; use _PHPStan_7d8742a37\React\Socket\ServerInterface; /** * The `React\Http\HttpServer` class is responsible for handling incoming connections and then * processing each incoming HTTP request. * * When a complete HTTP request has been received, it will invoke the given * request handler function. This request handler function needs to be passed to * the constructor and will be invoked with the respective [request](#server-request) * object and expects a [response](#server-response) object in return: * * ```php * $http = new React\Http\HttpServer(function (Psr\Http\Message\ServerRequestInterface $request) { * return new React\Http\Message\Response( * React\Http\Message\Response::STATUS_OK, * array( * 'Content-Type' => 'text/plain' * ), * "Hello World!\n" * ); * }); * ``` * * Each incoming HTTP request message is always represented by the * [PSR-7 `ServerRequestInterface`](https://www.php-fig.org/psr/psr-7/#321-psrhttpmessageserverrequestinterface), * see also following [request](#server-request) chapter for more details. * * Each outgoing HTTP response message is always represented by the * [PSR-7 `ResponseInterface`](https://www.php-fig.org/psr/psr-7/#33-psrhttpmessageresponseinterface), * see also following [response](#server-response) chapter for more details. * * This class takes an optional `LoopInterface|null $loop` parameter that can be used to * pass the event loop instance to use for this object. You can use a `null` value * here in order to use the [default loop](https://github.com/reactphp/event-loop#loop). * This value SHOULD NOT be given unless you're sure you want to explicitly use a * given event loop instance. * * In order to start listening for any incoming connections, the `HttpServer` needs * to be attached to an instance of * [`React\Socket\ServerInterface`](https://github.com/reactphp/socket#serverinterface) * through the [`listen()`](#listen) method as described in the following * chapter. In its most simple form, you can attach this to a * [`React\Socket\SocketServer`](https://github.com/reactphp/socket#socketserver) * in order to start a plaintext HTTP server like this: * * ```php * $http = new React\Http\HttpServer($handler); * * $socket = new React\Socket\SocketServer('0.0.0.0:8080'); * $http->listen($socket); * ``` * * See also the [`listen()`](#listen) method and * [hello world server example](../examples/51-server-hello-world.php) * for more details. * * By default, the `HttpServer` buffers and parses the complete incoming HTTP * request in memory. It will invoke the given request handler function when the * complete request headers and request body has been received. This means the * [request](#server-request) object passed to your request handler function will be * fully compatible with PSR-7 (http-message). This provides sane defaults for * 80% of the use cases and is the recommended way to use this library unless * you're sure you know what you're doing. * * On the other hand, buffering complete HTTP requests in memory until they can * be processed by your request handler function means that this class has to * employ a number of limits to avoid consuming too much memory. In order to * take the more advanced configuration out your hand, it respects setting from * your [`php.ini`](https://www.php.net/manual/en/ini.core.php) to apply its * default settings. This is a list of PHP settings this class respects with * their respective default values: * * ``` * memory_limit 128M * post_max_size 8M // capped at 64K * * enable_post_data_reading 1 * max_input_nesting_level 64 * max_input_vars 1000 * * file_uploads 1 * upload_max_filesize 2M * max_file_uploads 20 * ``` * * In particular, the `post_max_size` setting limits how much memory a single * HTTP request is allowed to consume while buffering its request body. This * needs to be limited because the server can process a large number of requests * concurrently, so the server may potentially consume a large amount of memory * otherwise. To support higher concurrency by default, this value is capped * at `64K`. If you assign a higher value, it will only allow `64K` by default. * If a request exceeds this limit, its request body will be ignored and it will * be processed like a request with no request body at all. See below for * explicit configuration to override this setting. * * By default, this class will try to avoid consuming more than half of your * `memory_limit` for buffering multiple concurrent HTTP requests. As such, with * the above default settings of `128M` max, it will try to consume no more than * `64M` for buffering multiple concurrent HTTP requests. As a consequence, it * will limit the concurrency to `1024` HTTP requests with the above defaults. * * It is imperative that you assign reasonable values to your PHP ini settings. * It is usually recommended to not support buffering incoming HTTP requests * with a large HTTP request body (e.g. large file uploads). If you want to * increase this buffer size, you will have to also increase the total memory * limit to allow for more concurrent requests (set `memory_limit 512M` or more) * or explicitly limit concurrency. * * In order to override the above buffering defaults, you can configure the * `HttpServer` explicitly. You can use the * [`LimitConcurrentRequestsMiddleware`](#limitconcurrentrequestsmiddleware) and * [`RequestBodyBufferMiddleware`](#requestbodybuffermiddleware) (see below) * to explicitly configure the total number of requests that can be handled at * once like this: * * ```php * $http = new React\Http\HttpServer( * new React\Http\Middleware\StreamingRequestMiddleware(), * new React\Http\Middleware\LimitConcurrentRequestsMiddleware(100), // 100 concurrent buffering handlers * new React\Http\Middleware\RequestBodyBufferMiddleware(2 * 1024 * 1024), // 2 MiB per request * new React\Http\Middleware\RequestBodyParserMiddleware(), * $handler * )); * ``` * * In this example, we allow processing up to 100 concurrent requests at once * and each request can buffer up to `2M`. This means you may have to keep a * maximum of `200M` of memory for incoming request body buffers. Accordingly, * you need to adjust the `memory_limit` ini setting to allow for these buffers * plus your actual application logic memory requirements (think `512M` or more). * * > Internally, this class automatically assigns these middleware handlers * automatically when no [`StreamingRequestMiddleware`](#streamingrequestmiddleware) * is given. Accordingly, you can use this example to override all default * settings to implement custom limits. * * As an alternative to buffering the complete request body in memory, you can * also use a streaming approach where only small chunks of data have to be kept * in memory: * * ```php * $http = new React\Http\HttpServer( * new React\Http\Middleware\StreamingRequestMiddleware(), * $handler * ); * ``` * * In this case, it will invoke the request handler function once the HTTP * request headers have been received, i.e. before receiving the potentially * much larger HTTP request body. This means the [request](#server-request) passed to * your request handler function may not be fully compatible with PSR-7. This is * specifically designed to help with more advanced use cases where you want to * have full control over consuming the incoming HTTP request body and * concurrency settings. See also [streaming incoming request](#streaming-incoming-request) * below for more details. * * > Changelog v1.5.0: This class has been renamed to `HttpServer` from the * previous `Server` class in order to avoid any ambiguities. * The previous name has been deprecated and should not be used anymore. */ final class HttpServer extends EventEmitter { /** * The maximum buffer size used for each request. * * This needs to be limited because the server can process a large number of * requests concurrently, so the server may potentially consume a large * amount of memory otherwise. * * See `RequestBodyBufferMiddleware` to override this setting. * * @internal */ const MAXIMUM_BUFFER_SIZE = 65536; // 64 KiB /** * @var StreamingServer */ private $streamingServer; /** * Creates an HTTP server that invokes the given callback for each incoming HTTP request * * In order to process any connections, the server needs to be attached to an * instance of `React\Socket\ServerInterface` which emits underlying streaming * connections in order to then parse incoming data as HTTP. * See also [listen()](#listen) for more details. * * @param callable|LoopInterface $requestHandlerOrLoop * @param callable[] ...$requestHandler * @see self::listen() */ public function __construct($requestHandlerOrLoop) { $requestHandlers = \func_get_args(); if (\reset($requestHandlers) instanceof LoopInterface) { $loop = \array_shift($requestHandlers); } else { $loop = Loop::get(); } $requestHandlersCount = \count($requestHandlers); if ($requestHandlersCount === 0 || \count(\array_filter($requestHandlers, 'is_callable')) < $requestHandlersCount) { throw new \InvalidArgumentException('Invalid request handler given'); } $streaming = \false; foreach ((array) $requestHandlers as $handler) { if ($handler instanceof StreamingRequestMiddleware) { $streaming = \true; break; } } $middleware = array(); if (!$streaming) { $maxSize = $this->getMaxRequestSize(); $concurrency = $this->getConcurrentRequestsLimit(\ini_get('memory_limit'), $maxSize); if ($concurrency !== null) { $middleware[] = new LimitConcurrentRequestsMiddleware($concurrency); } $middleware[] = new RequestBodyBufferMiddleware($maxSize); // Checking for an empty string because that is what a boolean // false is returned as by ini_get depending on the PHP version. // @link http://php.net/manual/en/ini.core.php#ini.enable-post-data-reading // @link http://php.net/manual/en/function.ini-get.php#refsect1-function.ini-get-notes // @link https://3v4l.org/qJtsa $enablePostDataReading = \ini_get('enable_post_data_reading'); if ($enablePostDataReading !== '') { $middleware[] = new RequestBodyParserMiddleware(); } } $middleware = \array_merge($middleware, $requestHandlers); /** * Filter out any configuration middleware, no need to run requests through something that isn't * doing anything with the request. */ $middleware = \array_filter($middleware, function ($handler) { return !$handler instanceof StreamingRequestMiddleware; }); $this->streamingServer = new StreamingServer($loop, new MiddlewareRunner($middleware)); $that = $this; $this->streamingServer->on('error', function ($error) use($that) { $that->emit('error', array($error)); }); } /** * Starts listening for HTTP requests on the given socket server instance * * The given [`React\Socket\ServerInterface`](https://github.com/reactphp/socket#serverinterface) * is responsible for emitting the underlying streaming connections. This * HTTP server needs to be attached to it in order to process any * connections and pase incoming streaming data as incoming HTTP request * messages. In its most common form, you can attach this to a * [`React\Socket\SocketServer`](https://github.com/reactphp/socket#socketserver) * in order to start a plaintext HTTP server like this: * * ```php * $http = new React\Http\HttpServer($handler); * * $socket = new React\Socket\SocketServer('0.0.0.0:8080'); * $http->listen($socket); * ``` * * See also [hello world server example](../examples/51-server-hello-world.php) * for more details. * * This example will start listening for HTTP requests on the alternative * HTTP port `8080` on all interfaces (publicly). As an alternative, it is * very common to use a reverse proxy and let this HTTP server listen on the * localhost (loopback) interface only by using the listen address * `127.0.0.1:8080` instead. This way, you host your application(s) on the * default HTTP port `80` and only route specific requests to this HTTP * server. * * Likewise, it's usually recommended to use a reverse proxy setup to accept * secure HTTPS requests on default HTTPS port `443` (TLS termination) and * only route plaintext requests to this HTTP server. As an alternative, you * can also accept secure HTTPS requests with this HTTP server by attaching * this to a [`React\Socket\SocketServer`](https://github.com/reactphp/socket#socketserver) * using a secure TLS listen address, a certificate file and optional * `passphrase` like this: * * ```php * $http = new React\Http\HttpServer($handler); * * $socket = new React\Socket\SocketServer('tls://0.0.0.0:8443', array( * 'tls' => array( * 'local_cert' => __DIR__ . '/localhost.pem' * ) * )); * $http->listen($socket); * ``` * * See also [hello world HTTPS example](../examples/61-server-hello-world-https.php) * for more details. * * @param ServerInterface $socket */ public function listen(ServerInterface $socket) { $this->streamingServer->listen($socket); } /** * @param string $memory_limit * @param string $post_max_size * @return ?int */ private function getConcurrentRequestsLimit($memory_limit, $post_max_size) { if ($memory_limit == -1) { return null; } $availableMemory = IniUtil::iniSizeToBytes($memory_limit) / 2; $concurrentRequests = (int) \ceil($availableMemory / IniUtil::iniSizeToBytes($post_max_size)); return $concurrentRequests; } /** * @param ?string $post_max_size * @return int */ private function getMaxRequestSize($post_max_size = null) { $maxSize = IniUtil::iniSizeToBytes($post_max_size === null ? \ini_get('post_max_size') : $post_max_size); return $maxSize === 0 || $maxSize >= self::MAXIMUM_BUFFER_SIZE ? self::MAXIMUM_BUFFER_SIZE : $maxSize; } } <?php namespace _PHPStan_7d8742a37\React\Http; // Deprecated `Server` is an alias for new `HttpServer` to ensure existing code continues to work as-is. \class_alias(__NAMESPACE__ . '\\HttpServer', __NAMESPACE__ . '\\Server', \true); // Aid static analysis and IDE autocompletion about this deprecation, // but don't actually execute during runtime because `HttpServer` is final. if (!\class_exists(__NAMESPACE__ . '\\Server', \false)) { /** * @deprecated 1.5.0 See HttpServer instead * @see HttpServer */ final class Server extends HttpServer { } } <?php namespace _PHPStan_7d8742a37\React\Http\Client; use _PHPStan_7d8742a37\Psr\Http\Message\RequestInterface; use _PHPStan_7d8742a37\React\Http\Io\ClientConnectionManager; use _PHPStan_7d8742a37\React\Http\Io\ClientRequestStream; /** * @internal */ class Client { /** @var ClientConnectionManager */ private $connectionManager; public function __construct(ClientConnectionManager $connectionManager) { $this->connectionManager = $connectionManager; } /** @return ClientRequestStream */ public function request(RequestInterface $request) { return new ClientRequestStream($this->connectionManager, $request); } } <?php namespace _PHPStan_7d8742a37\React\Http\Message; use _PHPStan_7d8742a37\Psr\Http\Message\UriInterface; /** * Respresents a URI (or URL). * * This class implements the * [PSR-7 `UriInterface`](https://www.php-fig.org/psr/psr-7/#35-psrhttpmessageuriinterface). * * This is mostly used internally to represent the URI of each HTTP request * message for our HTTP client and server implementations. Likewise, you may * also use this class with other HTTP implementations and for tests. * * @see UriInterface */ final class Uri implements UriInterface { /** @var string */ private $scheme = ''; /** @var string */ private $userInfo = ''; /** @var string */ private $host = ''; /** @var ?int */ private $port = null; /** @var string */ private $path = ''; /** @var string */ private $query = ''; /** @var string */ private $fragment = ''; /** * @param string $uri * @throws \InvalidArgumentException if given $uri is invalid */ public function __construct($uri) { // @codeCoverageIgnoreStart if (\PHP_VERSION_ID < 50407 && \strpos($uri, '//') === 0) { // @link https://3v4l.org/UrAQP $parts = \parse_url('http:' . $uri); unset($parts['schema']); } else { $parts = \parse_url($uri); } // @codeCoverageIgnoreEnd if ($parts === \false || isset($parts['scheme']) && !\preg_match('#^[a-z]+$#i', $parts['scheme']) || isset($parts['host']) && \preg_match('#[\\s_%+]#', $parts['host'])) { throw new \InvalidArgumentException('Invalid URI given'); } if (isset($parts['scheme'])) { $this->scheme = \strtolower($parts['scheme']); } if (isset($parts['user']) || isset($parts['pass'])) { $this->userInfo = $this->encode(isset($parts['user']) ? $parts['user'] : '', \PHP_URL_USER) . (isset($parts['pass']) ? ':' . $this->encode($parts['pass'], \PHP_URL_PASS) : ''); } if (isset($parts['host'])) { $this->host = \strtolower($parts['host']); } if (isset($parts['port']) && !($parts['port'] === 80 && $this->scheme === 'http' || $parts['port'] === 443 && $this->scheme === 'https')) { $this->port = $parts['port']; } if (isset($parts['path'])) { $this->path = $this->encode($parts['path'], \PHP_URL_PATH); } if (isset($parts['query'])) { $this->query = $this->encode($parts['query'], \PHP_URL_QUERY); } if (isset($parts['fragment'])) { $this->fragment = $this->encode($parts['fragment'], \PHP_URL_FRAGMENT); } } public function getScheme() { return $this->scheme; } public function getAuthority() { if ($this->host === '') { return ''; } return ($this->userInfo !== '' ? $this->userInfo . '@' : '') . $this->host . ($this->port !== null ? ':' . $this->port : ''); } public function getUserInfo() { return $this->userInfo; } public function getHost() { return $this->host; } public function getPort() { return $this->port; } public function getPath() { return $this->path; } public function getQuery() { return $this->query; } public function getFragment() { return $this->fragment; } public function withScheme($scheme) { $scheme = \strtolower($scheme); if ($scheme === $this->scheme) { return $this; } if (!\preg_match('#^[a-z]*$#', $scheme)) { throw new \InvalidArgumentException('Invalid URI scheme given'); } $new = clone $this; $new->scheme = $scheme; if ($this->port === 80 && $scheme === 'http' || $this->port === 443 && $scheme === 'https') { $new->port = null; } return $new; } public function withUserInfo($user, $password = null) { $userInfo = $this->encode($user, \PHP_URL_USER) . ($password !== null ? ':' . $this->encode($password, \PHP_URL_PASS) : ''); if ($userInfo === $this->userInfo) { return $this; } $new = clone $this; $new->userInfo = $userInfo; return $new; } public function withHost($host) { $host = \strtolower($host); if ($host === $this->host) { return $this; } if (\preg_match('#[\\s_%+]#', $host) || $host !== '' && \parse_url('http://' . $host, \PHP_URL_HOST) !== $host) { throw new \InvalidArgumentException('Invalid URI host given'); } $new = clone $this; $new->host = $host; return $new; } public function withPort($port) { $port = $port === null ? null : (int) $port; if ($port === 80 && $this->scheme === 'http' || $port === 443 && $this->scheme === 'https') { $port = null; } if ($port === $this->port) { return $this; } if ($port !== null && ($port < 1 || $port > 0xffff)) { throw new \InvalidArgumentException('Invalid URI port given'); } $new = clone $this; $new->port = $port; return $new; } public function withPath($path) { $path = $this->encode($path, \PHP_URL_PATH); if ($path === $this->path) { return $this; } $new = clone $this; $new->path = $path; return $new; } public function withQuery($query) { $query = $this->encode($query, \PHP_URL_QUERY); if ($query === $this->query) { return $this; } $new = clone $this; $new->query = $query; return $new; } public function withFragment($fragment) { $fragment = $this->encode($fragment, \PHP_URL_FRAGMENT); if ($fragment === $this->fragment) { return $this; } $new = clone $this; $new->fragment = $fragment; return $new; } public function __toString() { $uri = ''; if ($this->scheme !== '') { $uri .= $this->scheme . ':'; } $authority = $this->getAuthority(); if ($authority !== '') { $uri .= '//' . $authority; } if ($authority !== '' && isset($this->path[0]) && $this->path[0] !== '/') { $uri .= '/' . $this->path; } elseif ($authority === '' && isset($this->path[0]) && $this->path[0] === '/') { $uri .= '/' . \ltrim($this->path, '/'); } else { $uri .= $this->path; } if ($this->query !== '') { $uri .= '?' . $this->query; } if ($this->fragment !== '') { $uri .= '#' . $this->fragment; } return $uri; } /** * @param string $part * @param int $component * @return string */ private function encode($part, $component) { return \preg_replace_callback('/(?:[^a-z0-9_\\-\\.~!\\$&\'\\(\\)\\*\\+,;=' . ($component === \PHP_URL_PATH ? ':@\\/' : ($component === \PHP_URL_QUERY || $component === \PHP_URL_FRAGMENT ? ':@\\/\\?' : '')) . '%]++|%(?![a-f0-9]{2}))/i', function (array $match) { return \rawurlencode($match[0]); }, $part); } /** * [Internal] Resolve URI relative to base URI and return new absolute URI * * @internal * @param UriInterface $base * @param UriInterface $rel * @return UriInterface * @throws void */ public static function resolve(UriInterface $base, UriInterface $rel) { if ($rel->getScheme() !== '') { return $rel->getPath() === '' ? $rel : $rel->withPath(self::removeDotSegments($rel->getPath())); } $reset = \false; $new = $base; if ($rel->getAuthority() !== '') { $reset = \true; $userInfo = \explode(':', $rel->getUserInfo(), 2); $new = $base->withUserInfo($userInfo[0], isset($userInfo[1]) ? $userInfo[1] : null)->withHost($rel->getHost())->withPort($rel->getPort()); } if ($reset && $rel->getPath() === '') { $new = $new->withPath(''); } elseif (($path = $rel->getPath()) !== '') { $start = ''; if ($path === '' || $path[0] !== '/') { $start = $base->getPath(); if (\substr($start, -1) !== '/') { $start .= '/../'; } } $reset = \true; $new = $new->withPath(self::removeDotSegments($start . $path)); } if ($reset || $rel->getQuery() !== '') { $reset = \true; $new = $new->withQuery($rel->getQuery()); } if ($reset || $rel->getFragment() !== '') { $new = $new->withFragment($rel->getFragment()); } return $new; } /** * @param string $path * @return string */ private static function removeDotSegments($path) { $segments = array(); foreach (\explode('/', $path) as $segment) { if ($segment === '..') { \array_pop($segments); } elseif ($segment !== '.' && $segment !== '') { $segments[] = $segment; } } return '/' . \implode('/', $segments) . ($path !== '/' && \substr($path, -1) === '/' ? '/' : ''); } } <?php namespace _PHPStan_7d8742a37\React\Http\Message; use _PHPStan_7d8742a37\Psr\Http\Message\ServerRequestInterface; use _PHPStan_7d8742a37\Psr\Http\Message\StreamInterface; use _PHPStan_7d8742a37\Psr\Http\Message\UriInterface; use _PHPStan_7d8742a37\React\Http\Io\AbstractRequest; use _PHPStan_7d8742a37\React\Http\Io\BufferedBody; use _PHPStan_7d8742a37\React\Http\Io\HttpBodyStream; use _PHPStan_7d8742a37\React\Stream\ReadableStreamInterface; /** * Respresents an incoming server request message. * * This class implements the * [PSR-7 `ServerRequestInterface`](https://www.php-fig.org/psr/psr-7/#321-psrhttpmessageserverrequestinterface) * which extends the * [PSR-7 `RequestInterface`](https://www.php-fig.org/psr/psr-7/#32-psrhttpmessagerequestinterface) * which in turn extends the * [PSR-7 `MessageInterface`](https://www.php-fig.org/psr/psr-7/#31-psrhttpmessagemessageinterface). * * This is mostly used internally to represent each incoming request message. * Likewise, you can also use this class in test cases to test how your web * application reacts to certain HTTP requests. * * > Internally, this implementation builds on top of a base class which is * considered an implementation detail that may change in the future. * * @see ServerRequestInterface */ final class ServerRequest extends AbstractRequest implements ServerRequestInterface { private $attributes = array(); private $serverParams; private $fileParams = array(); private $cookies = array(); private $queryParams = array(); private $parsedBody; /** * @param string $method HTTP method for the request. * @param string|UriInterface $url URL for the request. * @param array<string,string|string[]> $headers Headers for the message. * @param string|ReadableStreamInterface|StreamInterface $body Message body. * @param string $version HTTP protocol version. * @param array<string,string> $serverParams server-side parameters * @throws \InvalidArgumentException for an invalid URL or body */ public function __construct($method, $url, array $headers = array(), $body = '', $version = '1.1', $serverParams = array()) { if (\is_string($body)) { $body = new BufferedBody($body); } elseif ($body instanceof ReadableStreamInterface && !$body instanceof StreamInterface) { $temp = new self($method, '', $headers); $size = (int) $temp->getHeaderLine('Content-Length'); if (\strtolower($temp->getHeaderLine('Transfer-Encoding')) === 'chunked') { $size = null; } $body = new HttpBodyStream($body, $size); } elseif (!$body instanceof StreamInterface) { throw new \InvalidArgumentException('Invalid server request body given'); } parent::__construct($method, $url, $headers, $body, $version); $this->serverParams = $serverParams; $query = $this->getUri()->getQuery(); if ($query !== '') { \parse_str($query, $this->queryParams); } // Multiple cookie headers are not allowed according // to https://tools.ietf.org/html/rfc6265#section-5.4 $cookieHeaders = $this->getHeader("Cookie"); if (\count($cookieHeaders) === 1) { $this->cookies = $this->parseCookie($cookieHeaders[0]); } } public function getServerParams() { return $this->serverParams; } public function getCookieParams() { return $this->cookies; } public function withCookieParams(array $cookies) { $new = clone $this; $new->cookies = $cookies; return $new; } public function getQueryParams() { return $this->queryParams; } public function withQueryParams(array $query) { $new = clone $this; $new->queryParams = $query; return $new; } public function getUploadedFiles() { return $this->fileParams; } public function withUploadedFiles(array $uploadedFiles) { $new = clone $this; $new->fileParams = $uploadedFiles; return $new; } public function getParsedBody() { return $this->parsedBody; } public function withParsedBody($data) { $new = clone $this; $new->parsedBody = $data; return $new; } public function getAttributes() { return $this->attributes; } public function getAttribute($name, $default = null) { if (!\array_key_exists($name, $this->attributes)) { return $default; } return $this->attributes[$name]; } public function withAttribute($name, $value) { $new = clone $this; $new->attributes[$name] = $value; return $new; } public function withoutAttribute($name) { $new = clone $this; unset($new->attributes[$name]); return $new; } /** * @param string $cookie * @return array */ private function parseCookie($cookie) { $cookieArray = \explode(';', $cookie); $result = array(); foreach ($cookieArray as $pair) { $pair = \trim($pair); $nameValuePair = \explode('=', $pair, 2); if (\count($nameValuePair) === 2) { $key = $nameValuePair[0]; $value = \urldecode($nameValuePair[1]); $result[$key] = $value; } } return $result; } /** * [Internal] Parse incoming HTTP protocol message * * @internal * @param string $message * @param array<string,string|int|float> $serverParams * @return self * @throws \InvalidArgumentException if given $message is not a valid HTTP request message */ public static function parseMessage($message, array $serverParams) { // parse request line like "GET /path HTTP/1.1" $start = array(); if (!\preg_match('#^(?<method>[^ ]+) (?<target>[^ ]+) HTTP/(?<version>\\d\\.\\d)#m', $message, $start)) { throw new \InvalidArgumentException('Unable to parse invalid request-line'); } // only support HTTP/1.1 and HTTP/1.0 requests if ($start['version'] !== '1.1' && $start['version'] !== '1.0') { throw new \InvalidArgumentException('Received request with invalid protocol version', Response::STATUS_VERSION_NOT_SUPPORTED); } // check number of valid header fields matches number of lines + request line $matches = array(); $n = \preg_match_all(self::REGEX_HEADERS, $message, $matches, \PREG_SET_ORDER); if (\substr_count($message, "\n") !== $n + 1) { throw new \InvalidArgumentException('Unable to parse invalid request header fields'); } // format all header fields into associative array $host = null; $headers = array(); foreach ($matches as $match) { $headers[$match[1]][] = $match[2]; // match `Host` request header if ($host === null && \strtolower($match[1]) === 'host') { $host = $match[2]; } } // scheme is `http` unless TLS is used $scheme = isset($serverParams['HTTPS']) ? 'https://' : 'http://'; // default host if unset comes from local socket address or defaults to localhost $hasHost = $host !== null; if ($host === null) { $host = isset($serverParams['SERVER_ADDR'], $serverParams['SERVER_PORT']) ? $serverParams['SERVER_ADDR'] . ':' . $serverParams['SERVER_PORT'] : '127.0.0.1'; } if ($start['method'] === 'OPTIONS' && $start['target'] === '*') { // support asterisk-form for `OPTIONS *` request line only $uri = $scheme . $host; } elseif ($start['method'] === 'CONNECT') { $parts = \parse_url('tcp://' . $start['target']); // check this is a valid authority-form request-target (host:port) if (!isset($parts['scheme'], $parts['host'], $parts['port']) || \count($parts) !== 3) { throw new \InvalidArgumentException('CONNECT method MUST use authority-form request target'); } $uri = $scheme . $start['target']; } else { // support absolute-form or origin-form for proxy requests if ($start['target'][0] === '/') { $uri = $scheme . $host . $start['target']; } else { // ensure absolute-form request-target contains a valid URI $parts = \parse_url($start['target']); // make sure value contains valid host component (IP or hostname), but no fragment if (!isset($parts['scheme'], $parts['host']) || $parts['scheme'] !== 'http' || isset($parts['fragment'])) { throw new \InvalidArgumentException('Invalid absolute-form request-target'); } $uri = $start['target']; } } $request = new self($start['method'], $uri, $headers, '', $start['version'], $serverParams); // only assign request target if it is not in origin-form (happy path for most normal requests) if ($start['target'][0] !== '/') { $request = $request->withRequestTarget($start['target']); } if ($hasHost) { // Optional Host request header value MUST be valid (host and optional port) $parts = \parse_url('http://' . $request->getHeaderLine('Host')); // make sure value contains valid host component (IP or hostname) if (!$parts || !isset($parts['scheme'], $parts['host'])) { $parts = \false; } // make sure value does not contain any other URI component if (\is_array($parts)) { unset($parts['scheme'], $parts['host'], $parts['port']); } if ($parts === \false || $parts) { throw new \InvalidArgumentException('Invalid Host header value'); } } elseif (!$hasHost && $start['version'] === '1.1' && $start['method'] !== 'CONNECT') { // require Host request header for HTTP/1.1 (except for CONNECT method) throw new \InvalidArgumentException('Missing required Host request header'); } elseif (!$hasHost) { // remove default Host request header for HTTP/1.0 when not explicitly given $request = $request->withoutHeader('Host'); } // ensure message boundaries are valid according to Content-Length and Transfer-Encoding request headers if ($request->hasHeader('Transfer-Encoding')) { if (\strtolower($request->getHeaderLine('Transfer-Encoding')) !== 'chunked') { throw new \InvalidArgumentException('Only chunked-encoding is allowed for Transfer-Encoding', Response::STATUS_NOT_IMPLEMENTED); } // Transfer-Encoding: chunked and Content-Length header MUST NOT be used at the same time // as per https://tools.ietf.org/html/rfc7230#section-3.3.3 if ($request->hasHeader('Content-Length')) { throw new \InvalidArgumentException('Using both `Transfer-Encoding: chunked` and `Content-Length` is not allowed', Response::STATUS_BAD_REQUEST); } } elseif ($request->hasHeader('Content-Length')) { $string = $request->getHeaderLine('Content-Length'); if ((string) (int) $string !== $string) { // Content-Length value is not an integer or not a single integer throw new \InvalidArgumentException('The value of `Content-Length` is not valid', Response::STATUS_BAD_REQUEST); } } return $request; } } <?php namespace _PHPStan_7d8742a37\React\Http\Message; use _PHPStan_7d8742a37\Psr\Http\Message\RequestInterface; use _PHPStan_7d8742a37\Psr\Http\Message\StreamInterface; use _PHPStan_7d8742a37\Psr\Http\Message\UriInterface; use _PHPStan_7d8742a37\React\Http\Io\AbstractRequest; use _PHPStan_7d8742a37\React\Http\Io\BufferedBody; use _PHPStan_7d8742a37\React\Http\Io\ReadableBodyStream; use _PHPStan_7d8742a37\React\Stream\ReadableStreamInterface; /** * Respresents an outgoing HTTP request message. * * This class implements the * [PSR-7 `RequestInterface`](https://www.php-fig.org/psr/psr-7/#32-psrhttpmessagerequestinterface) * which extends the * [PSR-7 `MessageInterface`](https://www.php-fig.org/psr/psr-7/#31-psrhttpmessagemessageinterface). * * This is mostly used internally to represent each outgoing HTTP request * message for the HTTP client implementation. Likewise, you can also use this * class with other HTTP client implementations and for tests. * * > Internally, this implementation builds on top of a base class which is * considered an implementation detail that may change in the future. * * @see RequestInterface */ final class Request extends AbstractRequest implements RequestInterface { /** * @param string $method HTTP method for the request. * @param string|UriInterface $url URL for the request. * @param array<string,string|string[]> $headers Headers for the message. * @param string|ReadableStreamInterface|StreamInterface $body Message body. * @param string $version HTTP protocol version. * @throws \InvalidArgumentException for an invalid URL or body */ public function __construct($method, $url, array $headers = array(), $body = '', $version = '1.1') { if (\is_string($body)) { $body = new BufferedBody($body); } elseif ($body instanceof ReadableStreamInterface && !$body instanceof StreamInterface) { $body = new ReadableBodyStream($body); } elseif (!$body instanceof StreamInterface) { throw new \InvalidArgumentException('Invalid request body given'); } parent::__construct($method, $url, $headers, $body, $version); } } <?php namespace _PHPStan_7d8742a37\React\Http\Message; use RuntimeException; use _PHPStan_7d8742a37\Psr\Http\Message\ResponseInterface; /** * The `React\Http\Message\ResponseException` is an `Exception` sub-class that will be used to reject * a request promise if the remote server returns a non-success status code * (anything but 2xx or 3xx). * You can control this behavior via the [`withRejectErrorResponse()` method](#withrejecterrorresponse). * * The `getCode(): int` method can be used to * return the HTTP response status code. */ final class ResponseException extends RuntimeException { private $response; public function __construct(ResponseInterface $response, $message = null, $code = null, $previous = null) { if ($message === null) { $message = 'HTTP status code ' . $response->getStatusCode() . ' (' . $response->getReasonPhrase() . ')'; } if ($code === null) { $code = $response->getStatusCode(); } parent::__construct($message, $code, $previous); $this->response = $response; } /** * Access its underlying response object. * * @return ResponseInterface */ public function getResponse() { return $this->response; } } <?php namespace _PHPStan_7d8742a37\React\Http\Message; use _PHPStan_7d8742a37\Fig\Http\Message\StatusCodeInterface; use _PHPStan_7d8742a37\Psr\Http\Message\ResponseInterface; use _PHPStan_7d8742a37\Psr\Http\Message\StreamInterface; use _PHPStan_7d8742a37\React\Http\Io\AbstractMessage; use _PHPStan_7d8742a37\React\Http\Io\BufferedBody; use _PHPStan_7d8742a37\React\Http\Io\HttpBodyStream; use _PHPStan_7d8742a37\React\Stream\ReadableStreamInterface; /** * Represents an outgoing server response message. * * ```php * $response = new React\Http\Message\Response( * React\Http\Message\Response::STATUS_OK, * array( * 'Content-Type' => 'text/html' * ), * "<html>Hello world!</html>\n" * ); * ``` * * This class implements the * [PSR-7 `ResponseInterface`](https://www.php-fig.org/psr/psr-7/#33-psrhttpmessageresponseinterface) * which in turn extends the * [PSR-7 `MessageInterface`](https://www.php-fig.org/psr/psr-7/#31-psrhttpmessagemessageinterface). * * On top of this, this class implements the * [PSR-7 Message Util `StatusCodeInterface`](https://github.com/php-fig/http-message-util/blob/master/src/StatusCodeInterface.php) * which means that most common HTTP status codes are available as class * constants with the `STATUS_*` prefix. For instance, the `200 OK` and * `404 Not Found` status codes can used as `Response::STATUS_OK` and * `Response::STATUS_NOT_FOUND` respectively. * * > Internally, this implementation builds on top a base class which is * considered an implementation detail that may change in the future. * * @see \Psr\Http\Message\ResponseInterface */ final class Response extends AbstractMessage implements ResponseInterface, StatusCodeInterface { /** * Create an HTML response * * ```php * $html = <<<HTML * <!doctype html> * <html> * <body>Hello wörld!</body> * </html> * * HTML; * * $response = React\Http\Message\Response::html($html); * ``` * * This is a convenient shortcut method that returns the equivalent of this: * * ``` * $response = new React\Http\Message\Response( * React\Http\Message\Response::STATUS_OK, * [ * 'Content-Type' => 'text/html; charset=utf-8' * ], * $html * ); * ``` * * This method always returns a response with a `200 OK` status code and * the appropriate `Content-Type` response header for the given HTTP source * string encoded in UTF-8 (Unicode). It's generally recommended to end the * given plaintext string with a trailing newline. * * If you want to use a different status code or custom HTTP response * headers, you can manipulate the returned response object using the * provided PSR-7 methods or directly instantiate a custom HTTP response * object using the `Response` constructor: * * ```php * $response = React\Http\Message\Response::html( * "<h1>Error</h1>\n<p>Invalid user name given.</p>\n" * )->withStatus(React\Http\Message\Response::STATUS_BAD_REQUEST); * ``` * * @param string $html * @return self */ public static function html($html) { return new self(self::STATUS_OK, array('Content-Type' => 'text/html; charset=utf-8'), $html); } /** * Create a JSON response * * ```php * $response = React\Http\Message\Response::json(['name' => 'Alice']); * ``` * * This is a convenient shortcut method that returns the equivalent of this: * * ``` * $response = new React\Http\Message\Response( * React\Http\Message\Response::STATUS_OK, * [ * 'Content-Type' => 'application/json' * ], * json_encode( * ['name' => 'Alice'], * JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES | JSON_PRESERVE_ZERO_FRACTION * ) . "\n" * ); * ``` * * This method always returns a response with a `200 OK` status code and * the appropriate `Content-Type` response header for the given structured * data encoded as a JSON text. * * The given structured data will be encoded as a JSON text. Any `string` * values in the data must be encoded in UTF-8 (Unicode). If the encoding * fails, this method will throw an `InvalidArgumentException`. * * By default, the given structured data will be encoded with the flags as * shown above. This includes pretty printing (PHP 5.4+) and preserving * zero fractions for `float` values (PHP 5.6.6+) to ease debugging. It is * assumed any additional data overhead is usually compensated by using HTTP * response compression. * * If you want to use a different status code or custom HTTP response * headers, you can manipulate the returned response object using the * provided PSR-7 methods or directly instantiate a custom HTTP response * object using the `Response` constructor: * * ```php * $response = React\Http\Message\Response::json( * ['error' => 'Invalid user name given'] * )->withStatus(React\Http\Message\Response::STATUS_BAD_REQUEST); * ``` * * @param mixed $data * @return self * @throws \InvalidArgumentException when encoding fails */ public static function json($data) { $json = @\json_encode($data, (\defined('JSON_PRETTY_PRINT') ? \JSON_PRETTY_PRINT | \JSON_UNESCAPED_SLASHES | \JSON_UNESCAPED_UNICODE : 0) | (\defined('JSON_PRESERVE_ZERO_FRACTION') ? \JSON_PRESERVE_ZERO_FRACTION : 0)); // throw on error, now `false` but used to be `(string) "null"` before PHP 5.5 if ($json === \false || \PHP_VERSION_ID < 50500 && \json_last_error() !== \JSON_ERROR_NONE) { throw new \InvalidArgumentException('Unable to encode given data as JSON' . (\function_exists('json_last_error_msg') ? ': ' . \json_last_error_msg() : ''), \json_last_error()); } return new self(self::STATUS_OK, array('Content-Type' => 'application/json'), $json . "\n"); } /** * Create a plaintext response * * ```php * $response = React\Http\Message\Response::plaintext("Hello wörld!\n"); * ``` * * This is a convenient shortcut method that returns the equivalent of this: * * ``` * $response = new React\Http\Message\Response( * React\Http\Message\Response::STATUS_OK, * [ * 'Content-Type' => 'text/plain; charset=utf-8' * ], * "Hello wörld!\n" * ); * ``` * * This method always returns a response with a `200 OK` status code and * the appropriate `Content-Type` response header for the given plaintext * string encoded in UTF-8 (Unicode). It's generally recommended to end the * given plaintext string with a trailing newline. * * If you want to use a different status code or custom HTTP response * headers, you can manipulate the returned response object using the * provided PSR-7 methods or directly instantiate a custom HTTP response * object using the `Response` constructor: * * ```php * $response = React\Http\Message\Response::plaintext( * "Error: Invalid user name given.\n" * )->withStatus(React\Http\Message\Response::STATUS_BAD_REQUEST); * ``` * * @param string $text * @return self */ public static function plaintext($text) { return new self(self::STATUS_OK, array('Content-Type' => 'text/plain; charset=utf-8'), $text); } /** * Create an XML response * * ```php * $xml = <<<XML * <?xml version="1.0" encoding="utf-8"?> * <body> * <greeting>Hello wörld!</greeting> * </body> * * XML; * * $response = React\Http\Message\Response::xml($xml); * ``` * * This is a convenient shortcut method that returns the equivalent of this: * * ``` * $response = new React\Http\Message\Response( * React\Http\Message\Response::STATUS_OK, * [ * 'Content-Type' => 'application/xml' * ], * $xml * ); * ``` * * This method always returns a response with a `200 OK` status code and * the appropriate `Content-Type` response header for the given XML source * string. It's generally recommended to use UTF-8 (Unicode) and specify * this as part of the leading XML declaration and to end the given XML * source string with a trailing newline. * * If you want to use a different status code or custom HTTP response * headers, you can manipulate the returned response object using the * provided PSR-7 methods or directly instantiate a custom HTTP response * object using the `Response` constructor: * * ```php * $response = React\Http\Message\Response::xml( * "<error><message>Invalid user name given.</message></error>\n" * )->withStatus(React\Http\Message\Response::STATUS_BAD_REQUEST); * ``` * * @param string $xml * @return self */ public static function xml($xml) { return new self(self::STATUS_OK, array('Content-Type' => 'application/xml'), $xml); } /** * @var bool * @see self::$phrasesMap */ private static $phrasesInitialized = \false; /** * Map of standard HTTP status codes to standard reason phrases. * * This map will be fully populated with all standard reason phrases on * first access. By default, it only contains a subset of HTTP status codes * that have a custom mapping to reason phrases (such as those with dashes * and all caps words). See `self::STATUS_*` for all possible status code * constants. * * @var array<int,string> * @see self::STATUS_* * @see self::getReasonPhraseForStatusCode() */ private static $phrasesMap = array(200 => 'OK', 203 => 'Non-Authoritative Information', 207 => 'Multi-Status', 226 => 'IM Used', 414 => 'URI Too Large', 418 => 'I\'m a teapot', 505 => 'HTTP Version Not Supported'); /** @var int */ private $statusCode; /** @var string */ private $reasonPhrase; /** * @param int $status HTTP status code (e.g. 200/404), see `self::STATUS_*` constants * @param array<string,string|string[]> $headers additional response headers * @param string|ReadableStreamInterface|StreamInterface $body response body * @param string $version HTTP protocol version (e.g. 1.1/1.0) * @param ?string $reason custom HTTP response phrase * @throws \InvalidArgumentException for an invalid body */ public function __construct($status = self::STATUS_OK, array $headers = array(), $body = '', $version = '1.1', $reason = null) { if (\is_string($body)) { $body = new BufferedBody($body); } elseif ($body instanceof ReadableStreamInterface && !$body instanceof StreamInterface) { $body = new HttpBodyStream($body, null); } elseif (!$body instanceof StreamInterface) { throw new \InvalidArgumentException('Invalid response body given'); } parent::__construct($version, $headers, $body); $this->statusCode = (int) $status; $this->reasonPhrase = $reason !== '' && $reason !== null ? (string) $reason : self::getReasonPhraseForStatusCode($status); } public function getStatusCode() { return $this->statusCode; } public function withStatus($code, $reasonPhrase = '') { if ((string) $reasonPhrase === '') { $reasonPhrase = self::getReasonPhraseForStatusCode($code); } if ($this->statusCode === (int) $code && $this->reasonPhrase === (string) $reasonPhrase) { return $this; } $response = clone $this; $response->statusCode = (int) $code; $response->reasonPhrase = (string) $reasonPhrase; return $response; } public function getReasonPhrase() { return $this->reasonPhrase; } /** * @param int $code * @return string default reason phrase for given status code or empty string if unknown */ private static function getReasonPhraseForStatusCode($code) { if (!self::$phrasesInitialized) { self::$phrasesInitialized = \true; // map all `self::STATUS_` constants from status code to reason phrase // e.g. `self::STATUS_NOT_FOUND = 404` will be mapped to `404 Not Found` $ref = new \ReflectionClass(__CLASS__); foreach ($ref->getConstants() as $name => $value) { if (!isset(self::$phrasesMap[$value]) && \strpos($name, 'STATUS_') === 0) { self::$phrasesMap[$value] = \ucwords(\strtolower(\str_replace('_', ' ', \substr($name, 7)))); } } } return isset(self::$phrasesMap[$code]) ? self::$phrasesMap[$code] : ''; } /** * [Internal] Parse incoming HTTP protocol message * * @internal * @param string $message * @return self * @throws \InvalidArgumentException if given $message is not a valid HTTP response message */ public static function parseMessage($message) { $start = array(); if (!\preg_match('#^HTTP/(?<version>\\d\\.\\d) (?<status>\\d{3})(?: (?<reason>[^\\r\\n]*+))?[\\r]?+\\n#m', $message, $start)) { throw new \InvalidArgumentException('Unable to parse invalid status-line'); } // only support HTTP/1.1 and HTTP/1.0 requests if ($start['version'] !== '1.1' && $start['version'] !== '1.0') { throw new \InvalidArgumentException('Received response with invalid protocol version'); } // check number of valid header fields matches number of lines + status line $matches = array(); $n = \preg_match_all(self::REGEX_HEADERS, $message, $matches, \PREG_SET_ORDER); if (\substr_count($message, "\n") !== $n + 1) { throw new \InvalidArgumentException('Unable to parse invalid response header fields'); } // format all header fields into associative array $headers = array(); foreach ($matches as $match) { $headers[$match[1]][] = $match[2]; } return new self((int) $start['status'], $headers, '', $start['version'], isset($start['reason']) ? $start['reason'] : ''); } } <?php namespace _PHPStan_7d8742a37\React\Http\Io; /** * @internal */ final class IniUtil { /** * Convert a ini like size to a numeric size in bytes. * * @param string $size * @return int */ public static function iniSizeToBytes($size) { if (\is_numeric($size)) { return (int) $size; } $suffix = \strtoupper(\substr($size, -1)); $strippedSize = \substr($size, 0, -1); if (!\is_numeric($strippedSize)) { throw new \InvalidArgumentException("{$size} is not a valid ini size"); } if ($strippedSize <= 0) { throw new \InvalidArgumentException("Expect {$size} to be higher isn't zero or lower"); } if ($suffix === 'K') { return $strippedSize * 1024; } if ($suffix === 'M') { return $strippedSize * 1024 * 1024; } if ($suffix === 'G') { return $strippedSize * 1024 * 1024 * 1024; } if ($suffix === 'T') { return $strippedSize * 1024 * 1024 * 1024 * 1024; } return (int) $size; } } <?php namespace _PHPStan_7d8742a37\React\Http\Io; use _PHPStan_7d8742a37\Psr\Http\Message\MessageInterface; use _PHPStan_7d8742a37\Psr\Http\Message\StreamInterface; /** * [Internal] Abstract HTTP message base class (PSR-7) * * @internal * @see MessageInterface */ abstract class AbstractMessage implements MessageInterface { /** * [Internal] Regex used to match all request header fields into an array, thanks to @kelunik for checking the HTTP specs and coming up with this regex * * @internal * @var string */ const REGEX_HEADERS = '/^([^()<>@,;:\\\\"\\/\\[\\]?={}\\x00-\\x20\\x7F]++):[\\x20\\x09]*+((?:[\\x20\\x09]*+[\\x21-\\x7E\\x80-\\xFF]++)*+)[\\x20\\x09]*+[\\r]?+\\n/m'; /** @var array<string,string[]> */ private $headers = array(); /** @var array<string,string> */ private $headerNamesLowerCase = array(); /** @var string */ private $protocolVersion; /** @var StreamInterface */ private $body; /** * @param string $protocolVersion * @param array<string,string|string[]> $headers * @param StreamInterface $body */ protected function __construct($protocolVersion, array $headers, StreamInterface $body) { foreach ($headers as $name => $value) { if ($value !== array()) { if (\is_array($value)) { foreach ($value as &$one) { $one = (string) $one; } } else { $value = array((string) $value); } $lower = \strtolower($name); if (isset($this->headerNamesLowerCase[$lower])) { $value = \array_merge($this->headers[$this->headerNamesLowerCase[$lower]], $value); unset($this->headers[$this->headerNamesLowerCase[$lower]]); } $this->headers[$name] = $value; $this->headerNamesLowerCase[$lower] = $name; } } $this->protocolVersion = (string) $protocolVersion; $this->body = $body; } public function getProtocolVersion() { return $this->protocolVersion; } public function withProtocolVersion($version) { if ((string) $version === $this->protocolVersion) { return $this; } $message = clone $this; $message->protocolVersion = (string) $version; return $message; } public function getHeaders() { return $this->headers; } public function hasHeader($name) { return isset($this->headerNamesLowerCase[\strtolower($name)]); } public function getHeader($name) { $lower = \strtolower($name); return isset($this->headerNamesLowerCase[$lower]) ? $this->headers[$this->headerNamesLowerCase[$lower]] : array(); } public function getHeaderLine($name) { return \implode(', ', $this->getHeader($name)); } public function withHeader($name, $value) { if ($value === array()) { return $this->withoutHeader($name); } elseif (\is_array($value)) { foreach ($value as &$one) { $one = (string) $one; } } else { $value = array((string) $value); } $lower = \strtolower($name); if (isset($this->headerNamesLowerCase[$lower]) && $this->headerNamesLowerCase[$lower] === (string) $name && $this->headers[$this->headerNamesLowerCase[$lower]] === $value) { return $this; } $message = clone $this; if (isset($message->headerNamesLowerCase[$lower])) { unset($message->headers[$message->headerNamesLowerCase[$lower]]); } $message->headers[$name] = $value; $message->headerNamesLowerCase[$lower] = $name; return $message; } public function withAddedHeader($name, $value) { if ($value === array()) { return $this; } return $this->withHeader($name, \array_merge($this->getHeader($name), \is_array($value) ? $value : array($value))); } public function withoutHeader($name) { $lower = \strtolower($name); if (!isset($this->headerNamesLowerCase[$lower])) { return $this; } $message = clone $this; unset($message->headers[$message->headerNamesLowerCase[$lower]], $message->headerNamesLowerCase[$lower]); return $message; } public function getBody() { return $this->body; } public function withBody(StreamInterface $body) { if ($body === $this->body) { return $this; } $message = clone $this; $message->body = $body; return $message; } } <?php namespace _PHPStan_7d8742a37\React\Http\Io; use _PHPStan_7d8742a37\React\EventLoop\LoopInterface; /** * [internal] Clock source that returns current timestamp and memoize clock for same tick * * This is mostly used as an internal optimization to avoid unneeded syscalls to * get the current system time multiple times within the same loop tick. For the * purpose of the HTTP server, the clock is assumed to not change to a * significant degree within the same loop tick. If you need a high precision * clock source, you may want to use `\hrtime()` instead (PHP 7.3+). * * The API is modelled to resemble the PSR-20 `ClockInterface` (in draft at the * time of writing this), but uses a `float` return value for performance * reasons instead. * * Note that this is an internal class only and nothing you should usually care * about for outside use. * * @internal */ class Clock { /** @var LoopInterface $loop */ private $loop; /** @var ?float */ private $now; public function __construct(LoopInterface $loop) { $this->loop = $loop; } /** @return float */ public function now() { if ($this->now === null) { $this->now = \microtime(\true); // remember clock for current loop tick only and update on next tick $now =& $this->now; $this->loop->futureTick(function () use(&$now) { \assert($now !== null); $now = null; }); } return $this->now; } } <?php namespace _PHPStan_7d8742a37\React\Http\Io; use _PHPStan_7d8742a37\Psr\Http\Message\ServerRequestInterface; /** * [Internal] Parses a string body with "Content-Type: multipart/form-data" into structured data * * This is use internally to parse incoming request bodies into structured data * that resembles PHP's `$_POST` and `$_FILES` superglobals. * * @internal * @link https://tools.ietf.org/html/rfc7578 * @link https://tools.ietf.org/html/rfc2046#section-5.1.1 */ final class MultipartParser { /** * @var ServerRequestInterface|null */ private $request; /** * @var int|null */ private $maxFileSize; /** * Based on $maxInputVars and $maxFileUploads * * @var int */ private $maxMultipartBodyParts; /** * ini setting "max_input_vars" * * Does not exist in PHP < 5.3.9 or HHVM, so assume PHP's default 1000 here. * * @var int * @link http://php.net/manual/en/info.configuration.php#ini.max-input-vars */ private $maxInputVars = 1000; /** * ini setting "max_input_nesting_level" * * Does not exist in HHVM, but assumes hard coded to 64 (PHP's default). * * @var int * @link http://php.net/manual/en/info.configuration.php#ini.max-input-nesting-level */ private $maxInputNestingLevel = 64; /** * ini setting "upload_max_filesize" * * @var int */ private $uploadMaxFilesize; /** * ini setting "max_file_uploads" * * Additionally, setting "file_uploads = off" effectively sets this to zero. * * @var int */ private $maxFileUploads; private $multipartBodyPartCount = 0; private $postCount = 0; private $filesCount = 0; private $emptyCount = 0; private $cursor = 0; /** * @param int|string|null $uploadMaxFilesize * @param int|null $maxFileUploads */ public function __construct($uploadMaxFilesize = null, $maxFileUploads = null) { $var = \ini_get('max_input_vars'); if ($var !== \false) { $this->maxInputVars = (int) $var; } $var = \ini_get('max_input_nesting_level'); if ($var !== \false) { $this->maxInputNestingLevel = (int) $var; } if ($uploadMaxFilesize === null) { $uploadMaxFilesize = \ini_get('upload_max_filesize'); } $this->uploadMaxFilesize = IniUtil::iniSizeToBytes($uploadMaxFilesize); $this->maxFileUploads = $maxFileUploads === null ? \ini_get('file_uploads') === '' ? 0 : (int) \ini_get('max_file_uploads') : (int) $maxFileUploads; $this->maxMultipartBodyParts = $this->maxInputVars + $this->maxFileUploads; } public function parse(ServerRequestInterface $request) { $contentType = $request->getHeaderLine('content-type'); if (!\preg_match('/boundary="?(.*?)"?$/', $contentType, $matches)) { return $request; } $this->request = $request; $this->parseBody('--' . $matches[1], (string) $request->getBody()); $request = $this->request; $this->request = null; $this->multipartBodyPartCount = 0; $this->cursor = 0; $this->postCount = 0; $this->filesCount = 0; $this->emptyCount = 0; $this->maxFileSize = null; return $request; } private function parseBody($boundary, $buffer) { $len = \strlen($boundary); // ignore everything before initial boundary (SHOULD be empty) $this->cursor = \strpos($buffer, $boundary . "\r\n"); while ($this->cursor !== \false) { // search following boundary (preceded by newline) // ignore last if not followed by boundary (SHOULD end with "--") $this->cursor += $len + 2; $end = \strpos($buffer, "\r\n" . $boundary, $this->cursor); if ($end === \false) { break; } // parse one part and continue searching for next $this->parsePart(\substr($buffer, $this->cursor, $end - $this->cursor)); $this->cursor = $end; if (++$this->multipartBodyPartCount > $this->maxMultipartBodyParts) { break; } } } private function parsePart($chunk) { $pos = \strpos($chunk, "\r\n\r\n"); if ($pos === \false) { return; } $headers = $this->parseHeaders((string) \substr($chunk, 0, $pos)); $body = (string) \substr($chunk, $pos + 4); if (!isset($headers['content-disposition'])) { return; } $name = $this->getParameterFromHeader($headers['content-disposition'], 'name'); if ($name === null) { return; } $filename = $this->getParameterFromHeader($headers['content-disposition'], 'filename'); if ($filename !== null) { $this->parseFile($name, $filename, isset($headers['content-type'][0]) ? $headers['content-type'][0] : null, $body); } else { $this->parsePost($name, $body); } } private function parseFile($name, $filename, $contentType, $contents) { $file = $this->parseUploadedFile($filename, $contentType, $contents); if ($file === null) { return; } $this->request = $this->request->withUploadedFiles($this->extractPost($this->request->getUploadedFiles(), $name, $file)); } private function parseUploadedFile($filename, $contentType, $contents) { $size = \strlen($contents); // no file selected (zero size and empty filename) if ($size === 0 && $filename === '') { // ignore excessive number of empty file uploads if (++$this->emptyCount + $this->filesCount > $this->maxInputVars) { return; } return new UploadedFile(new BufferedBody(''), $size, \UPLOAD_ERR_NO_FILE, $filename, $contentType); } // ignore excessive number of file uploads if (++$this->filesCount > $this->maxFileUploads) { return; } // file exceeds "upload_max_filesize" ini setting if ($size > $this->uploadMaxFilesize) { return new UploadedFile(new BufferedBody(''), $size, \UPLOAD_ERR_INI_SIZE, $filename, $contentType); } // file exceeds MAX_FILE_SIZE value if ($this->maxFileSize !== null && $size > $this->maxFileSize) { return new UploadedFile(new BufferedBody(''), $size, \UPLOAD_ERR_FORM_SIZE, $filename, $contentType); } return new UploadedFile(new BufferedBody($contents), $size, \UPLOAD_ERR_OK, $filename, $contentType); } private function parsePost($name, $value) { // ignore excessive number of post fields if (++$this->postCount > $this->maxInputVars) { return; } $this->request = $this->request->withParsedBody($this->extractPost($this->request->getParsedBody(), $name, $value)); if (\strtoupper($name) === 'MAX_FILE_SIZE') { $this->maxFileSize = (int) $value; if ($this->maxFileSize === 0) { $this->maxFileSize = null; } } } private function parseHeaders($header) { $headers = array(); foreach (\explode("\r\n", \trim($header)) as $line) { $parts = \explode(':', $line, 2); if (!isset($parts[1])) { continue; } $key = \strtolower(\trim($parts[0])); $values = \explode(';', $parts[1]); $values = \array_map('trim', $values); $headers[$key] = $values; } return $headers; } private function getParameterFromHeader(array $header, $parameter) { foreach ($header as $part) { if (\preg_match('/' . $parameter . '="?(.*?)"?$/', $part, $matches)) { return $matches[1]; } } return null; } private function extractPost($postFields, $key, $value) { $chunks = \explode('[', $key); if (\count($chunks) == 1) { $postFields[$key] = $value; return $postFields; } // ignore this key if maximum nesting level is exceeded if (isset($chunks[$this->maxInputNestingLevel])) { return $postFields; } $chunkKey = \rtrim($chunks[0], ']'); $parent =& $postFields; for ($i = 1; isset($chunks[$i]); $i++) { $previousChunkKey = $chunkKey; if ($previousChunkKey === '') { $parent[] = array(); \end($parent); $parent =& $parent[\key($parent)]; } else { if (!isset($parent[$previousChunkKey]) || !\is_array($parent[$previousChunkKey])) { $parent[$previousChunkKey] = array(); } $parent =& $parent[$previousChunkKey]; } $chunkKey = \rtrim($chunks[$i], ']'); } if ($chunkKey === '') { $parent[] = $value; } else { $parent[$chunkKey] = $value; } return $postFields; } } <?php namespace _PHPStan_7d8742a37\React\Http\Io; use _PHPStan_7d8742a37\Psr\Http\Message\RequestInterface; use _PHPStan_7d8742a37\Psr\Http\Message\StreamInterface; use _PHPStan_7d8742a37\Psr\Http\Message\UriInterface; use _PHPStan_7d8742a37\React\Http\Message\Uri; /** * [Internal] Abstract HTTP request base class (PSR-7) * * @internal * @see RequestInterface */ abstract class AbstractRequest extends AbstractMessage implements RequestInterface { /** @var ?string */ private $requestTarget; /** @var string */ private $method; /** @var UriInterface */ private $uri; /** * @param string $method * @param string|UriInterface $uri * @param array<string,string|string[]> $headers * @param StreamInterface $body * @param string unknown $protocolVersion */ protected function __construct($method, $uri, array $headers, StreamInterface $body, $protocolVersion) { if (\is_string($uri)) { $uri = new Uri($uri); } elseif (!$uri instanceof UriInterface) { throw new \InvalidArgumentException('_PHPStan_7d8742a37\\Argument #2 ($uri) expected string|Psr\\Http\\Message\\UriInterface'); } // assign default `Host` request header from URI unless already given explicitly $host = $uri->getHost(); if ($host !== '') { foreach ($headers as $name => $value) { if (\strtolower($name) === 'host' && $value !== array()) { $host = ''; break; } } if ($host !== '') { $port = $uri->getPort(); if ($port !== null && (!($port === 80 && $uri->getScheme() === 'http') || !($port === 443 && $uri->getScheme() === 'https'))) { $host .= ':' . $port; } $headers = array('Host' => $host) + $headers; } } parent::__construct($protocolVersion, $headers, $body); $this->method = $method; $this->uri = $uri; } public function getRequestTarget() { if ($this->requestTarget !== null) { return $this->requestTarget; } $target = $this->uri->getPath(); if ($target === '') { $target = '/'; } if (($query = $this->uri->getQuery()) !== '') { $target .= '?' . $query; } return $target; } public function withRequestTarget($requestTarget) { if ((string) $requestTarget === $this->requestTarget) { return $this; } $request = clone $this; $request->requestTarget = (string) $requestTarget; return $request; } public function getMethod() { return $this->method; } public function withMethod($method) { if ((string) $method === $this->method) { return $this; } $request = clone $this; $request->method = (string) $method; return $request; } public function getUri() { return $this->uri; } public function withUri(UriInterface $uri, $preserveHost = \false) { if ($uri === $this->uri) { return $this; } $request = clone $this; $request->uri = $uri; $host = $uri->getHost(); $port = $uri->getPort(); if ($port !== null && $host !== '' && (!($port === 80 && $uri->getScheme() === 'http') || !($port === 443 && $uri->getScheme() === 'https'))) { $host .= ':' . $port; } // update `Host` request header if URI contains a new host and `$preserveHost` is false if ($host !== '' && (!$preserveHost || $request->getHeaderLine('Host') === '')) { // first remove all headers before assigning `Host` header to ensure it always comes first foreach (\array_keys($request->getHeaders()) as $name) { $request = $request->withoutHeader($name); } // add `Host` header first, then all other original headers $request = $request->withHeader('Host', $host); foreach ($this->withoutHeader('Host')->getHeaders() as $name => $value) { $request = $request->withHeader($name, $value); } } return $request; } } <?php namespace _PHPStan_7d8742a37\React\Http\Io; /** @internal */ class ClientRequestState { /** @var int */ public $numRequests = 0; /** @var ?\React\Promise\PromiseInterface */ public $pending = null; /** @var ?\React\EventLoop\TimerInterface */ public $timeout = null; } <?php namespace _PHPStan_7d8742a37\React\Http\Io; use _PHPStan_7d8742a37\Evenement\EventEmitter; use _PHPStan_7d8742a37\Psr\Http\Message\StreamInterface; use _PHPStan_7d8742a37\React\Stream\ReadableStreamInterface; use _PHPStan_7d8742a37\React\Stream\Util; use _PHPStan_7d8742a37\React\Stream\WritableStreamInterface; /** * [Internal] Bridge between an empty StreamInterface from PSR-7 and ReadableStreamInterface from ReactPHP * * This class is used in the server to represent an empty body stream of an * incoming response from the client. This is similar to the `HttpBodyStream`, * but is specifically designed for the common case of having an empty message * body. * * Note that this is an internal class only and nothing you should usually care * about. See the `StreamInterface` and `ReadableStreamInterface` for more * details. * * @see HttpBodyStream * @see StreamInterface * @see ReadableStreamInterface * @internal */ class EmptyBodyStream extends EventEmitter implements StreamInterface, ReadableStreamInterface { private $closed = \false; public function isReadable() { return !$this->closed; } public function pause() { // NOOP } public function resume() { // NOOP } public function pipe(WritableStreamInterface $dest, array $options = array()) { Util::pipe($this, $dest, $options); return $dest; } public function close() { if ($this->closed) { return; } $this->closed = \true; $this->emit('close'); $this->removeAllListeners(); } public function getSize() { return 0; } /** @ignore */ public function __toString() { return ''; } /** @ignore */ public function detach() { return null; } /** @ignore */ public function tell() { throw new \BadMethodCallException(); } /** @ignore */ public function eof() { throw new \BadMethodCallException(); } /** @ignore */ public function isSeekable() { return \false; } /** @ignore */ public function seek($offset, $whence = \SEEK_SET) { throw new \BadMethodCallException(); } /** @ignore */ public function rewind() { throw new \BadMethodCallException(); } /** @ignore */ public function isWritable() { return \false; } /** @ignore */ public function write($string) { throw new \BadMethodCallException(); } /** @ignore */ public function read($length) { throw new \BadMethodCallException(); } /** @ignore */ public function getContents() { return ''; } /** @ignore */ public function getMetadata($key = null) { return $key === null ? array() : null; } } <?php namespace _PHPStan_7d8742a37\React\Http\Io; use _PHPStan_7d8742a37\Psr\Http\Message\ResponseInterface; use _PHPStan_7d8742a37\Psr\Http\Message\ServerRequestInterface; use _PHPStan_7d8742a37\React\Promise\PromiseInterface; /** * [Internal] Middleware runner to expose an array of middleware request handlers as a single request handler callable * * @internal */ final class MiddlewareRunner { /** * @var callable[] */ private $middleware; /** * @param callable[] $middleware */ public function __construct(array $middleware) { $this->middleware = \array_values($middleware); } /** * @param ServerRequestInterface $request * @return ResponseInterface|PromiseInterface<ResponseInterface> * @throws \Exception */ public function __invoke(ServerRequestInterface $request) { if (empty($this->middleware)) { throw new \RuntimeException('No middleware to run'); } return $this->call($request, 0); } /** @internal */ public function call(ServerRequestInterface $request, $position) { // final request handler will be invoked without a next handler if (!isset($this->middleware[$position + 1])) { $handler = $this->middleware[$position]; return $handler($request); } $that = $this; $next = function (ServerRequestInterface $request) use($that, $position) { return $that->call($request, $position + 1); }; // invoke middleware request handler with next handler $handler = $this->middleware[$position]; return $handler($request, $next); } } <?php namespace _PHPStan_7d8742a37\React\Http\Io; use _PHPStan_7d8742a37\Psr\Http\Message\StreamInterface; /** * [Internal] PSR-7 message body implementation using an in-memory buffer * * @internal */ class BufferedBody implements StreamInterface { private $buffer = ''; private $position = 0; private $closed = \false; /** * @param string $buffer */ public function __construct($buffer) { $this->buffer = $buffer; } public function __toString() { if ($this->closed) { return ''; } $this->seek(0); return $this->getContents(); } public function close() { $this->buffer = ''; $this->position = 0; $this->closed = \true; } public function detach() { $this->close(); return null; } public function getSize() { return $this->closed ? null : \strlen($this->buffer); } public function tell() { if ($this->closed) { throw new \RuntimeException('Unable to tell position of closed stream'); } return $this->position; } public function eof() { return $this->position >= \strlen($this->buffer); } public function isSeekable() { return !$this->closed; } public function seek($offset, $whence = \SEEK_SET) { if ($this->closed) { throw new \RuntimeException('Unable to seek on closed stream'); } $old = $this->position; if ($whence === \SEEK_SET) { $this->position = $offset; } elseif ($whence === \SEEK_CUR) { $this->position += $offset; } elseif ($whence === \SEEK_END) { $this->position = \strlen($this->buffer) + $offset; } else { throw new \InvalidArgumentException('Invalid seek mode given'); } if (!\is_int($this->position) || $this->position < 0) { $this->position = $old; throw new \RuntimeException('Unable to seek to position'); } } public function rewind() { $this->seek(0); } public function isWritable() { return !$this->closed; } public function write($string) { if ($this->closed) { throw new \RuntimeException('Unable to write to closed stream'); } if ($string === '') { return 0; } if ($this->position > 0 && !isset($this->buffer[$this->position - 1])) { $this->buffer = \str_pad($this->buffer, $this->position, "\x00"); } $len = \strlen($string); $this->buffer = \substr($this->buffer, 0, $this->position) . $string . \substr($this->buffer, $this->position + $len); $this->position += $len; return $len; } public function isReadable() { return !$this->closed; } public function read($length) { if ($this->closed) { throw new \RuntimeException('Unable to read from closed stream'); } if ($length < 1) { throw new \InvalidArgumentException('Invalid read length given'); } if ($this->position + $length > \strlen($this->buffer)) { $length = \strlen($this->buffer) - $this->position; } if (!isset($this->buffer[$this->position])) { return ''; } $pos = $this->position; $this->position += $length; return \substr($this->buffer, $pos, $length); } public function getContents() { if ($this->closed) { throw new \RuntimeException('Unable to read from closed stream'); } if (!isset($this->buffer[$this->position])) { return ''; } $pos = $this->position; $this->position = \strlen($this->buffer); return \substr($this->buffer, $pos); } public function getMetadata($key = null) { return $key === null ? array() : null; } } <?php namespace _PHPStan_7d8742a37\React\Http\Io; use _PHPStan_7d8742a37\Evenement\EventEmitter; use _PHPStan_7d8742a37\Psr\Http\Message\ServerRequestInterface; use _PHPStan_7d8742a37\React\Http\Message\Response; use _PHPStan_7d8742a37\React\Http\Message\ServerRequest; use _PHPStan_7d8742a37\React\Socket\ConnectionInterface; use Exception; /** * [Internal] Parses an incoming request header from an input stream * * This is used internally to parse the request header from the connection and * then process the remaining connection as the request body. * * @event headers * @event error * * @internal */ class RequestHeaderParser extends EventEmitter { private $maxSize = 8192; /** @var Clock */ private $clock; /** @var array<string|int,array<string,string>> */ private $connectionParams = array(); public function __construct(Clock $clock) { $this->clock = $clock; } public function handle(ConnectionInterface $conn) { $buffer = ''; $maxSize = $this->maxSize; $that = $this; $conn->on('data', $fn = function ($data) use(&$buffer, &$fn, $conn, $maxSize, $that) { // append chunk of data to buffer and look for end of request headers $buffer .= $data; $endOfHeader = \strpos($buffer, "\r\n\r\n"); // reject request if buffer size is exceeded if ($endOfHeader > $maxSize || $endOfHeader === \false && isset($buffer[$maxSize])) { $conn->removeListener('data', $fn); $fn = null; $that->emit('error', array(new \OverflowException("Maximum header size of {$maxSize} exceeded.", Response::STATUS_REQUEST_HEADER_FIELDS_TOO_LARGE), $conn)); return; } // ignore incomplete requests if ($endOfHeader === \false) { return; } // request headers received => try to parse request $conn->removeListener('data', $fn); $fn = null; try { $request = $that->parseRequest((string) \substr($buffer, 0, $endOfHeader + 2), $conn); } catch (Exception $exception) { $buffer = ''; $that->emit('error', array($exception, $conn)); return; } $contentLength = 0; if ($request->hasHeader('Transfer-Encoding')) { $contentLength = null; } elseif ($request->hasHeader('Content-Length')) { $contentLength = (int) $request->getHeaderLine('Content-Length'); } if ($contentLength === 0) { // happy path: request body is known to be empty $stream = new EmptyBodyStream(); $request = $request->withBody($stream); } else { // otherwise body is present => delimit using Content-Length or ChunkedDecoder $stream = new CloseProtectionStream($conn); if ($contentLength !== null) { $stream = new LengthLimitedStream($stream, $contentLength); } else { $stream = new ChunkedDecoder($stream); } $request = $request->withBody(new HttpBodyStream($stream, $contentLength)); } $bodyBuffer = isset($buffer[$endOfHeader + 4]) ? \substr($buffer, $endOfHeader + 4) : ''; $buffer = ''; $that->emit('headers', array($request, $conn)); if ($bodyBuffer !== '') { $conn->emit('data', array($bodyBuffer)); } // happy path: request body is known to be empty => immediately end stream if ($contentLength === 0) { $stream->emit('end'); $stream->close(); } }); } /** * @param string $headers buffer string containing request headers only * @param ConnectionInterface $connection * @return ServerRequestInterface * @throws \InvalidArgumentException * @internal */ public function parseRequest($headers, ConnectionInterface $connection) { // reuse same connection params for all server params for this connection $cid = \PHP_VERSION_ID < 70200 ? \spl_object_hash($connection) : \spl_object_id($connection); if (isset($this->connectionParams[$cid])) { $serverParams = $this->connectionParams[$cid]; } else { // assign new server params for new connection $serverParams = array(); // scheme is `http` unless TLS is used $localSocketUri = $connection->getLocalAddress(); $localParts = $localSocketUri === null ? array() : \parse_url($localSocketUri); if (isset($localParts['scheme']) && $localParts['scheme'] === 'tls') { $serverParams['HTTPS'] = 'on'; } // apply SERVER_ADDR and SERVER_PORT if server address is known // address should always be known, even for Unix domain sockets (UDS) // but skip UDS as it doesn't have a concept of host/port. if ($localSocketUri !== null && isset($localParts['host'], $localParts['port'])) { $serverParams['SERVER_ADDR'] = $localParts['host']; $serverParams['SERVER_PORT'] = $localParts['port']; } // apply REMOTE_ADDR and REMOTE_PORT if source address is known // address should always be known, unless this is over Unix domain sockets (UDS) $remoteSocketUri = $connection->getRemoteAddress(); if ($remoteSocketUri !== null) { $remoteAddress = \parse_url($remoteSocketUri); $serverParams['REMOTE_ADDR'] = $remoteAddress['host']; $serverParams['REMOTE_PORT'] = $remoteAddress['port']; } // remember server params for all requests from this connection, reset on connection close $this->connectionParams[$cid] = $serverParams; $params =& $this->connectionParams; $connection->on('close', function () use(&$params, $cid) { \assert(\is_array($params)); unset($params[$cid]); }); } // create new obj implementing ServerRequestInterface by preserving all // previous properties and restoring original request-target $serverParams['REQUEST_TIME'] = (int) ($now = $this->clock->now()); $serverParams['REQUEST_TIME_FLOAT'] = $now; return ServerRequest::parseMessage($headers, $serverParams); } } <?php namespace _PHPStan_7d8742a37\React\Http\Io; use _PHPStan_7d8742a37\Evenement\EventEmitter; use _PHPStan_7d8742a37\Psr\Http\Message\MessageInterface; use _PHPStan_7d8742a37\Psr\Http\Message\RequestInterface; use _PHPStan_7d8742a37\React\Http\Message\Response; use _PHPStan_7d8742a37\React\Socket\ConnectionInterface; use _PHPStan_7d8742a37\React\Stream\WritableStreamInterface; /** * @event response * @event drain * @event error * @event close * @internal */ class ClientRequestStream extends EventEmitter implements WritableStreamInterface { const STATE_INIT = 0; const STATE_WRITING_HEAD = 1; const STATE_HEAD_WRITTEN = 2; const STATE_END = 3; /** @var ClientConnectionManager */ private $connectionManager; /** @var RequestInterface */ private $request; /** @var ?ConnectionInterface */ private $connection; /** @var string */ private $buffer = ''; private $responseFactory; private $state = self::STATE_INIT; private $ended = \false; private $pendingWrites = ''; public function __construct(ClientConnectionManager $connectionManager, RequestInterface $request) { $this->connectionManager = $connectionManager; $this->request = $request; } public function isWritable() { return self::STATE_END > $this->state && !$this->ended; } private function writeHead() { $this->state = self::STATE_WRITING_HEAD; $expected = 0; $headers = "{$this->request->getMethod()} {$this->request->getRequestTarget()} HTTP/{$this->request->getProtocolVersion()}\r\n"; foreach ($this->request->getHeaders() as $name => $values) { if (\strpos($name, ':') !== \false) { $expected = -1; break; } foreach ($values as $value) { $headers .= "{$name}: {$value}\r\n"; ++$expected; } } /** @var array $m legacy PHP 5.3 only */ if (!\preg_match('#^\\S+ \\S+ HTTP/1\\.[01]\\r\\n#m', $headers) || \substr_count($headers, "\n") !== $expected + 1 || (\PHP_VERSION_ID >= 50400 ? \preg_match_all(AbstractMessage::REGEX_HEADERS, $headers) : \preg_match_all(AbstractMessage::REGEX_HEADERS, $headers, $m)) !== $expected) { $this->closeError(new \InvalidArgumentException('Unable to send request with invalid request headers')); return; } $connectionRef =& $this->connection; $stateRef =& $this->state; $pendingWrites =& $this->pendingWrites; $that = $this; $promise = $this->connectionManager->connect($this->request->getUri()); $promise->then(function (ConnectionInterface $connection) use($headers, &$connectionRef, &$stateRef, &$pendingWrites, $that) { $connectionRef = $connection; \assert($connectionRef instanceof ConnectionInterface); $connection->on('drain', array($that, 'handleDrain')); $connection->on('data', array($that, 'handleData')); $connection->on('end', array($that, 'handleEnd')); $connection->on('error', array($that, 'handleError')); $connection->on('close', array($that, 'close')); $more = $connection->write($headers . "\r\n" . $pendingWrites); \assert($stateRef === ClientRequestStream::STATE_WRITING_HEAD); $stateRef = ClientRequestStream::STATE_HEAD_WRITTEN; // clear pending writes if non-empty if ($pendingWrites !== '') { $pendingWrites = ''; if ($more) { $that->emit('drain'); } } }, array($this, 'closeError')); $this->on('close', function () use($promise) { $promise->cancel(); }); } public function write($data) { if (!$this->isWritable()) { return \false; } // write directly to connection stream if already available if (self::STATE_HEAD_WRITTEN <= $this->state) { return $this->connection->write($data); } // otherwise buffer and try to establish connection $this->pendingWrites .= $data; if (self::STATE_WRITING_HEAD > $this->state) { $this->writeHead(); } return \false; } public function end($data = null) { if (!$this->isWritable()) { return; } if (null !== $data) { $this->write($data); } else { if (self::STATE_WRITING_HEAD > $this->state) { $this->writeHead(); } } $this->ended = \true; } /** @internal */ public function handleDrain() { $this->emit('drain'); } /** @internal */ public function handleData($data) { $this->buffer .= $data; // buffer until double CRLF (or double LF for compatibility with legacy servers) $eom = \strpos($this->buffer, "\r\n\r\n"); $eomLegacy = \strpos($this->buffer, "\n\n"); if ($eom !== \false || $eomLegacy !== \false) { try { if ($eom !== \false && ($eomLegacy === \false || $eom < $eomLegacy)) { $response = Response::parseMessage(\substr($this->buffer, 0, $eom + 2)); $bodyChunk = (string) \substr($this->buffer, $eom + 4); } else { $response = Response::parseMessage(\substr($this->buffer, 0, $eomLegacy + 1)); $bodyChunk = (string) \substr($this->buffer, $eomLegacy + 2); } } catch (\InvalidArgumentException $exception) { $this->closeError($exception); return; } // response headers successfully received => remove listeners for connection events $connection = $this->connection; \assert($connection instanceof ConnectionInterface); $connection->removeListener('drain', array($this, 'handleDrain')); $connection->removeListener('data', array($this, 'handleData')); $connection->removeListener('end', array($this, 'handleEnd')); $connection->removeListener('error', array($this, 'handleError')); $connection->removeListener('close', array($this, 'close')); $this->connection = null; $this->buffer = ''; // take control over connection handling and check if we can reuse the connection once response body closes $that = $this; $request = $this->request; $connectionManager = $this->connectionManager; $successfulEndReceived = \false; $input = $body = new CloseProtectionStream($connection); $input->on('close', function () use($connection, $that, $connectionManager, $request, $response, &$successfulEndReceived) { // only reuse connection after successful response and both request and response allow keep alive if ($successfulEndReceived && $connection->isReadable() && $that->hasMessageKeepAliveEnabled($response) && $that->hasMessageKeepAliveEnabled($request)) { $connectionManager->keepAlive($request->getUri(), $connection); } else { $connection->close(); } $that->close(); }); // determine length of response body $length = null; $code = $response->getStatusCode(); if ($this->request->getMethod() === 'HEAD' || $code >= 100 && $code < 200 || $code == Response::STATUS_NO_CONTENT || $code == Response::STATUS_NOT_MODIFIED) { $length = 0; } elseif (\strtolower($response->getHeaderLine('Transfer-Encoding')) === 'chunked') { $body = new ChunkedDecoder($body); } elseif ($response->hasHeader('Content-Length')) { $length = (int) $response->getHeaderLine('Content-Length'); } $response = $response->withBody($body = new ReadableBodyStream($body, $length)); $body->on('end', function () use(&$successfulEndReceived) { $successfulEndReceived = \true; }); // emit response with streaming response body (see `Sender`) $this->emit('response', array($response, $body)); // re-emit HTTP response body to trigger body parsing if parts of it are buffered if ($bodyChunk !== '') { $input->handleData($bodyChunk); } elseif ($length === 0) { $input->handleEnd(); } } } /** @internal */ public function handleEnd() { $this->closeError(new \RuntimeException("Connection ended before receiving response")); } /** @internal */ public function handleError(\Exception $error) { $this->closeError(new \RuntimeException("An error occurred in the underlying stream", 0, $error)); } /** @internal */ public function closeError(\Exception $error) { if (self::STATE_END <= $this->state) { return; } $this->emit('error', array($error)); $this->close(); } public function close() { if (self::STATE_END <= $this->state) { return; } $this->state = self::STATE_END; $this->pendingWrites = ''; $this->buffer = ''; if ($this->connection instanceof ConnectionInterface) { $this->connection->close(); $this->connection = null; } $this->emit('close'); $this->removeAllListeners(); } /** * @internal * @return bool * @link https://www.rfc-editor.org/rfc/rfc9112#section-9.3 * @link https://www.rfc-editor.org/rfc/rfc7230#section-6.1 */ public function hasMessageKeepAliveEnabled(MessageInterface $message) { // @link https://www.rfc-editor.org/rfc/rfc9110#section-7.6.1 $connectionOptions = \array_map('trim', \explode(',', \strtolower($message->getHeaderLine('Connection')))); if (\in_array('close', $connectionOptions, \true)) { return \false; } if ($message->getProtocolVersion() === '1.1') { return \true; } if (\in_array('keep-alive', $connectionOptions, \true)) { return \true; } return \false; } } <?php namespace _PHPStan_7d8742a37\React\Http\Io; use _PHPStan_7d8742a37\Psr\Http\Message\RequestInterface; use _PHPStan_7d8742a37\Psr\Http\Message\ResponseInterface; use _PHPStan_7d8742a37\React\EventLoop\LoopInterface; use _PHPStan_7d8742a37\React\Http\Client\Client as HttpClient; use _PHPStan_7d8742a37\React\Promise\PromiseInterface; use _PHPStan_7d8742a37\React\Promise\Deferred; use _PHPStan_7d8742a37\React\Socket\Connector; use _PHPStan_7d8742a37\React\Socket\ConnectorInterface; use _PHPStan_7d8742a37\React\Stream\ReadableStreamInterface; /** * [Internal] Sends requests and receives responses * * The `Sender` is responsible for passing the [`RequestInterface`](#requestinterface) objects to * the underlying [`HttpClient`](https://github.com/reactphp/http-client) library * and keeps track of its transmission and converts its reponses back to [`ResponseInterface`](#responseinterface) objects. * * It also registers everything with the main [`EventLoop`](https://github.com/reactphp/event-loop#usage) * and the default [`Connector`](https://github.com/reactphp/socket-client) and [DNS `Resolver`](https://github.com/reactphp/dns). * * The `Sender` class mostly exists in order to abstract changes on the underlying * components away from this package in order to provide backwards and forwards * compatibility. * * @internal You SHOULD NOT rely on this API, it is subject to change without prior notice! * @see Browser */ class Sender { /** * create a new default sender attached to the given event loop * * This method is used internally to create the "default sender". * * You may also use this method if you need custom DNS or connector * settings. You can use this method manually like this: * * ```php * $connector = new \React\Socket\Connector(array(), $loop); * $sender = \React\Http\Io\Sender::createFromLoop($loop, $connector); * ``` * * @param LoopInterface $loop * @param ConnectorInterface|null $connector * @return self */ public static function createFromLoop(LoopInterface $loop, ?ConnectorInterface $connector = null) { if ($connector === null) { $connector = new Connector(array(), $loop); } return new self(new HttpClient(new ClientConnectionManager($connector, $loop))); } private $http; /** * [internal] Instantiate Sender * * @param HttpClient $http * @internal */ public function __construct(HttpClient $http) { $this->http = $http; } /** * * @internal * @param RequestInterface $request * @return PromiseInterface Promise<ResponseInterface, Exception> */ public function send(RequestInterface $request) { // support HTTP/1.1 and HTTP/1.0 only, ensured by `Browser` already \assert(\in_array($request->getProtocolVersion(), array('1.0', '1.1'), \true)); $body = $request->getBody(); $size = $body->getSize(); if ($size !== null && $size !== 0) { // automatically assign a "Content-Length" request header if the body size is known and non-empty $request = $request->withHeader('Content-Length', (string) $size); } elseif ($size === 0 && \in_array($request->getMethod(), array('POST', 'PUT', 'PATCH'))) { // only assign a "Content-Length: 0" request header if the body is expected for certain methods $request = $request->withHeader('Content-Length', '0'); } elseif ($body instanceof ReadableStreamInterface && $size !== 0 && $body->isReadable() && !$request->hasHeader('Content-Length')) { // use "Transfer-Encoding: chunked" when this is a streaming body and body size is unknown $request = $request->withHeader('Transfer-Encoding', 'chunked'); } else { // do not use chunked encoding if size is known or if this is an empty request body $size = 0; } // automatically add `Authorization: Basic …` request header if URL includes `user:pass@host` if ($request->getUri()->getUserInfo() !== '' && !$request->hasHeader('Authorization')) { $request = $request->withHeader('Authorization', 'Basic ' . \base64_encode($request->getUri()->getUserInfo())); } $requestStream = $this->http->request($request); $deferred = new Deferred(function ($_, $reject) use($requestStream) { // close request stream if request is cancelled $reject(new \RuntimeException('Request cancelled')); $requestStream->close(); }); $requestStream->on('error', function ($error) use($deferred) { $deferred->reject($error); }); $requestStream->on('response', function (ResponseInterface $response) use($deferred, $request) { $deferred->resolve($response); }); if ($body instanceof ReadableStreamInterface) { if ($body->isReadable()) { // length unknown => apply chunked transfer-encoding if ($size === null) { $body = new ChunkedEncoder($body); } // pipe body into request stream // add dummy write to immediately start request even if body does not emit any data yet $body->pipe($requestStream); $requestStream->write(''); $body->on('close', $close = function () use($deferred, $requestStream) { $deferred->reject(new \RuntimeException('Request failed because request body closed unexpectedly')); $requestStream->close(); }); $body->on('error', function ($e) use($deferred, $requestStream, $close, $body) { $body->removeListener('close', $close); $deferred->reject(new \RuntimeException('Request failed because request body reported an error', 0, $e)); $requestStream->close(); }); $body->on('end', function () use($close, $body) { $body->removeListener('close', $close); }); } else { // stream is not readable => end request without body $requestStream->end(); } } else { // body is fully buffered => write as one chunk $requestStream->end((string) $body); } return $deferred->promise(); } } <?php namespace _PHPStan_7d8742a37\React\Http\Io; use _PHPStan_7d8742a37\Psr\Http\Message\StreamInterface; use _PHPStan_7d8742a37\Psr\Http\Message\UploadedFileInterface; use InvalidArgumentException; use RuntimeException; /** * [Internal] Implementation of the PSR-7 `UploadedFileInterface` * * This is used internally to represent each incoming file upload. * * Note that this is an internal class only and nothing you should usually care * about. See the `UploadedFileInterface` for more details. * * @see UploadedFileInterface * @internal */ final class UploadedFile implements UploadedFileInterface { /** * @var StreamInterface */ private $stream; /** * @var int */ private $size; /** * @var int */ private $error; /** * @var string */ private $filename; /** * @var string */ private $mediaType; /** * @param StreamInterface $stream * @param int $size * @param int $error * @param string $filename * @param string $mediaType */ public function __construct(StreamInterface $stream, $size, $error, $filename, $mediaType) { $this->stream = $stream; $this->size = $size; if (!\is_int($error) || !\in_array($error, array(\UPLOAD_ERR_OK, \UPLOAD_ERR_INI_SIZE, \UPLOAD_ERR_FORM_SIZE, \UPLOAD_ERR_PARTIAL, \UPLOAD_ERR_NO_FILE, \UPLOAD_ERR_NO_TMP_DIR, \UPLOAD_ERR_CANT_WRITE, \UPLOAD_ERR_EXTENSION))) { throw new InvalidArgumentException('Invalid error code, must be an UPLOAD_ERR_* constant'); } $this->error = $error; $this->filename = $filename; $this->mediaType = $mediaType; } /** * {@inheritdoc} */ public function getStream() { if ($this->error !== \UPLOAD_ERR_OK) { throw new RuntimeException('Cannot retrieve stream due to upload error'); } return $this->stream; } /** * {@inheritdoc} */ public function moveTo($targetPath) { throw new RuntimeException('Not implemented'); } /** * {@inheritdoc} */ public function getSize() { return $this->size; } /** * {@inheritdoc} */ public function getError() { return $this->error; } /** * {@inheritdoc} */ public function getClientFilename() { return $this->filename; } /** * {@inheritdoc} */ public function getClientMediaType() { return $this->mediaType; } } <?php namespace _PHPStan_7d8742a37\React\Http\Io; use _PHPStan_7d8742a37\Psr\Http\Message\RequestInterface; use _PHPStan_7d8742a37\Psr\Http\Message\ResponseInterface; use _PHPStan_7d8742a37\Psr\Http\Message\UriInterface; use _PHPStan_7d8742a37\React\EventLoop\LoopInterface; use _PHPStan_7d8742a37\React\Http\Message\Response; use _PHPStan_7d8742a37\React\Http\Message\ResponseException; use _PHPStan_7d8742a37\React\Http\Message\Uri; use _PHPStan_7d8742a37\React\Promise\Deferred; use _PHPStan_7d8742a37\React\Promise\Promise; use _PHPStan_7d8742a37\React\Promise\PromiseInterface; use _PHPStan_7d8742a37\React\Stream\ReadableStreamInterface; /** * @internal */ class Transaction { private $sender; private $loop; // context: http.timeout (ini_get('default_socket_timeout'): 60) private $timeout; // context: http.follow_location (true) private $followRedirects = \true; // context: http.max_redirects (10) private $maxRedirects = 10; // context: http.ignore_errors (false) private $obeySuccessCode = \true; private $streaming = \false; private $maximumSize = 16777216; // 16 MiB = 2^24 bytes public function __construct(Sender $sender, LoopInterface $loop) { $this->sender = $sender; $this->loop = $loop; } /** * @param array $options * @return self returns new instance, without modifying existing instance */ public function withOptions(array $options) { $transaction = clone $this; foreach ($options as $name => $value) { if (\property_exists($transaction, $name)) { // restore default value if null is given if ($value === null) { $default = new self($this->sender, $this->loop); $value = $default->{$name}; } $transaction->{$name} = $value; } } return $transaction; } public function send(RequestInterface $request) { $state = new ClientRequestState(); $deferred = new Deferred(function () use($state) { if ($state->pending !== null) { $state->pending->cancel(); $state->pending = null; } }); // use timeout from options or default to PHP's default_socket_timeout (60) $timeout = (float) ($this->timeout !== null ? $this->timeout : \ini_get("default_socket_timeout")); $loop = $this->loop; $this->next($request, $deferred, $state)->then(function (ResponseInterface $response) use($state, $deferred, $loop, &$timeout) { if ($state->timeout !== null) { $loop->cancelTimer($state->timeout); $state->timeout = null; } $timeout = -1; $deferred->resolve($response); }, function ($e) use($state, $deferred, $loop, &$timeout) { if ($state->timeout !== null) { $loop->cancelTimer($state->timeout); $state->timeout = null; } $timeout = -1; $deferred->reject($e); }); if ($timeout < 0) { return $deferred->promise(); } $body = $request->getBody(); if ($body instanceof ReadableStreamInterface && $body->isReadable()) { $that = $this; $body->on('close', function () use($that, $deferred, $state, &$timeout) { if ($timeout >= 0) { $that->applyTimeout($deferred, $state, $timeout); } }); } else { $this->applyTimeout($deferred, $state, $timeout); } return $deferred->promise(); } /** * @internal * @param number $timeout * @return void */ public function applyTimeout(Deferred $deferred, ClientRequestState $state, $timeout) { $state->timeout = $this->loop->addTimer($timeout, function () use($timeout, $deferred, $state) { $deferred->reject(new \RuntimeException('Request timed out after ' . $timeout . ' seconds')); if ($state->pending !== null) { $state->pending->cancel(); $state->pending = null; } }); } private function next(RequestInterface $request, Deferred $deferred, ClientRequestState $state) { $this->progress('request', array($request)); $that = $this; ++$state->numRequests; $promise = $this->sender->send($request); if (!$this->streaming) { $promise = $promise->then(function ($response) use($deferred, $state, $that) { return $that->bufferResponse($response, $deferred, $state); }); } $state->pending = $promise; return $promise->then(function (ResponseInterface $response) use($request, $that, $deferred, $state) { return $that->onResponse($response, $request, $deferred, $state); }); } /** * @internal * @return PromiseInterface Promise<ResponseInterface, Exception> */ public function bufferResponse(ResponseInterface $response, Deferred $deferred, ClientRequestState $state) { $body = $response->getBody(); $size = $body->getSize(); if ($size !== null && $size > $this->maximumSize) { $body->close(); return \_PHPStan_7d8742a37\React\Promise\reject(new \OverflowException('Response body size of ' . $size . ' bytes exceeds maximum of ' . $this->maximumSize . ' bytes', \defined('SOCKET_EMSGSIZE') ? \SOCKET_EMSGSIZE : 90)); } // body is not streaming => already buffered if (!$body instanceof ReadableStreamInterface) { return \_PHPStan_7d8742a37\React\Promise\resolve($response); } /** @var ?\Closure $closer */ $closer = null; $maximumSize = $this->maximumSize; return $state->pending = new Promise(function ($resolve, $reject) use($body, $maximumSize, $response, &$closer) { // resolve with current buffer when stream closes successfully $buffer = ''; $body->on('close', $closer = function () use(&$buffer, $response, $maximumSize, $resolve, $reject) { $resolve($response->withBody(new BufferedBody($buffer))); }); // buffer response body data in memory $body->on('data', function ($data) use(&$buffer, $maximumSize, $body, $closer, $reject) { $buffer .= $data; // close stream and reject promise if limit is exceeded if (isset($buffer[$maximumSize])) { $buffer = ''; \assert($closer instanceof \Closure); $body->removeListener('close', $closer); $body->close(); $reject(new \OverflowException('Response body size exceeds maximum of ' . $maximumSize . ' bytes', \defined('SOCKET_EMSGSIZE') ? \SOCKET_EMSGSIZE : 90)); } }); // reject buffering if body emits error $body->on('error', function (\Exception $e) use($reject) { $reject(new \RuntimeException('Error while buffering response body: ' . $e->getMessage(), $e->getCode(), $e)); }); }, function () use($body, &$closer) { // cancelled buffering: remove close handler to avoid resolving, then close and reject \assert($closer instanceof \Closure); $body->removeListener('close', $closer); $body->close(); throw new \RuntimeException('Cancelled buffering response body'); }); } /** * @internal * @throws ResponseException * @return ResponseInterface|PromiseInterface */ public function onResponse(ResponseInterface $response, RequestInterface $request, Deferred $deferred, ClientRequestState $state) { $this->progress('response', array($response, $request)); // follow 3xx (Redirection) response status codes if Location header is present and not explicitly disabled // @link https://tools.ietf.org/html/rfc7231#section-6.4 if ($this->followRedirects && ($response->getStatusCode() >= 300 && $response->getStatusCode() < 400) && $response->hasHeader('Location')) { return $this->onResponseRedirect($response, $request, $deferred, $state); } // only status codes 200-399 are considered to be valid, reject otherwise if ($this->obeySuccessCode && ($response->getStatusCode() < 200 || $response->getStatusCode() >= 400)) { throw new ResponseException($response); } // resolve our initial promise return $response; } /** * @param ResponseInterface $response * @param RequestInterface $request * @param Deferred $deferred * @param ClientRequestState $state * @return PromiseInterface * @throws \RuntimeException */ private function onResponseRedirect(ResponseInterface $response, RequestInterface $request, Deferred $deferred, ClientRequestState $state) { // resolve location relative to last request URI $location = Uri::resolve($request->getUri(), new Uri($response->getHeaderLine('Location'))); $request = $this->makeRedirectRequest($request, $location, $response->getStatusCode()); $this->progress('redirect', array($request)); if ($state->numRequests >= $this->maxRedirects) { throw new \RuntimeException('Maximum number of redirects (' . $this->maxRedirects . ') exceeded'); } return $this->next($request, $deferred, $state); } /** * @param RequestInterface $request * @param UriInterface $location * @param int $statusCode * @return RequestInterface * @throws \RuntimeException */ private function makeRedirectRequest(RequestInterface $request, UriInterface $location, $statusCode) { // Remove authorization if changing hostnames (but not if just changing ports or protocols). $originalHost = $request->getUri()->getHost(); if ($location->getHost() !== $originalHost) { $request = $request->withoutHeader('Authorization'); } $request = $request->withoutHeader('Host')->withUri($location); if ($statusCode === Response::STATUS_TEMPORARY_REDIRECT || $statusCode === Response::STATUS_PERMANENT_REDIRECT) { if ($request->getBody() instanceof ReadableStreamInterface) { throw new \RuntimeException('Unable to redirect request with streaming body'); } } else { $request = $request->withMethod($request->getMethod() === 'HEAD' ? 'HEAD' : 'GET')->withoutHeader('Content-Type')->withoutHeader('Content-Length')->withBody(new BufferedBody('')); } return $request; } private function progress($name, array $args = array()) { return; echo $name; foreach ($args as $arg) { echo ' '; if ($arg instanceof ResponseInterface) { echo 'HTTP/' . $arg->getProtocolVersion() . ' ' . $arg->getStatusCode() . ' ' . $arg->getReasonPhrase(); } elseif ($arg instanceof RequestInterface) { echo $arg->getMethod() . ' ' . $arg->getRequestTarget() . ' HTTP/' . $arg->getProtocolVersion(); } else { echo $arg; } } echo \PHP_EOL; } } <?php namespace _PHPStan_7d8742a37\React\Http\Io; use _PHPStan_7d8742a37\Evenement\EventEmitter; use _PHPStan_7d8742a37\Psr\Http\Message\ResponseInterface; use _PHPStan_7d8742a37\Psr\Http\Message\ServerRequestInterface; use _PHPStan_7d8742a37\React\EventLoop\LoopInterface; use _PHPStan_7d8742a37\React\Http\Message\Response; use _PHPStan_7d8742a37\React\Http\Message\ServerRequest; use _PHPStan_7d8742a37\React\Promise; use _PHPStan_7d8742a37\React\Promise\PromiseInterface; use _PHPStan_7d8742a37\React\Socket\ConnectionInterface; use _PHPStan_7d8742a37\React\Socket\ServerInterface; use _PHPStan_7d8742a37\React\Stream\ReadableStreamInterface; use _PHPStan_7d8742a37\React\Stream\WritableStreamInterface; /** * The internal `StreamingServer` class is responsible for handling incoming connections and then * processing each incoming HTTP request. * * Unlike the [`HttpServer`](#httpserver) class, it does not buffer and parse the incoming * HTTP request body by default. This means that the request handler will be * invoked with a streaming request body. Once the request headers have been * received, it will invoke the request handler function. This request handler * function needs to be passed to the constructor and will be invoked with the * respective [request](#request) object and expects a [response](#response) * object in return: * * ```php * $server = new StreamingServer($loop, function (ServerRequestInterface $request) { * return new Response( * Response::STATUS_OK, * array( * 'Content-Type' => 'text/plain' * ), * "Hello World!\n" * ); * }); * ``` * * Each incoming HTTP request message is always represented by the * [PSR-7 `ServerRequestInterface`](https://www.php-fig.org/psr/psr-7/#321-psrhttpmessageserverrequestinterface), * see also following [request](#request) chapter for more details. * Each outgoing HTTP response message is always represented by the * [PSR-7 `ResponseInterface`](https://www.php-fig.org/psr/psr-7/#33-psrhttpmessageresponseinterface), * see also following [response](#response) chapter for more details. * * In order to process any connections, the server needs to be attached to an * instance of `React\Socket\ServerInterface` through the [`listen()`](#listen) method * as described in the following chapter. In its most simple form, you can attach * this to a [`React\Socket\SocketServer`](https://github.com/reactphp/socket#socketserver) * in order to start a plaintext HTTP server like this: * * ```php * $server = new StreamingServer($loop, $handler); * * $socket = new React\Socket\SocketServer('0.0.0.0:8080', array(), $loop); * $server->listen($socket); * ``` * * See also the [`listen()`](#listen) method and the [first example](examples) for more details. * * The `StreamingServer` class is considered advanced usage and unless you know * what you're doing, you're recommended to use the [`HttpServer`](#httpserver) class * instead. The `StreamingServer` class is specifically designed to help with * more advanced use cases where you want to have full control over consuming * the incoming HTTP request body and concurrency settings. * * In particular, this class does not buffer and parse the incoming HTTP request * in memory. It will invoke the request handler function once the HTTP request * headers have been received, i.e. before receiving the potentially much larger * HTTP request body. This means the [request](#request) passed to your request * handler function may not be fully compatible with PSR-7. See also * [streaming request](#streaming-request) below for more details. * * @see \React\Http\HttpServer * @see \React\Http\Message\Response * @see self::listen() * @internal */ final class StreamingServer extends EventEmitter { private $callback; private $parser; /** @var Clock */ private $clock; /** * Creates an HTTP server that invokes the given callback for each incoming HTTP request * * In order to process any connections, the server needs to be attached to an * instance of `React\Socket\ServerInterface` which emits underlying streaming * connections in order to then parse incoming data as HTTP. * See also [listen()](#listen) for more details. * * @param LoopInterface $loop * @param callable $requestHandler * @see self::listen() */ public function __construct(LoopInterface $loop, $requestHandler) { if (!\is_callable($requestHandler)) { throw new \InvalidArgumentException('Invalid request handler given'); } $this->callback = $requestHandler; $this->clock = new Clock($loop); $this->parser = new RequestHeaderParser($this->clock); $that = $this; $this->parser->on('headers', function (ServerRequestInterface $request, ConnectionInterface $conn) use($that) { $that->handleRequest($conn, $request); }); $this->parser->on('error', function (\Exception $e, ConnectionInterface $conn) use($that) { $that->emit('error', array($e)); // parsing failed => assume dummy request and send appropriate error $that->writeError($conn, $e->getCode() !== 0 ? $e->getCode() : Response::STATUS_BAD_REQUEST, new ServerRequest('GET', '/')); }); } /** * Starts listening for HTTP requests on the given socket server instance * * @param ServerInterface $socket * @see \React\Http\HttpServer::listen() */ public function listen(ServerInterface $socket) { $socket->on('connection', array($this->parser, 'handle')); } /** @internal */ public function handleRequest(ConnectionInterface $conn, ServerRequestInterface $request) { if ($request->getProtocolVersion() !== '1.0' && '100-continue' === \strtolower($request->getHeaderLine('Expect'))) { $conn->write("HTTP/1.1 100 Continue\r\n\r\n"); } // execute request handler callback $callback = $this->callback; try { $response = $callback($request); } catch (\Exception $error) { // request handler callback throws an Exception $response = Promise\reject($error); } catch (\Throwable $error) { // @codeCoverageIgnoreStart // request handler callback throws a PHP7+ Error $response = Promise\reject($error); // @codeCoverageIgnoreEnd } // cancel pending promise once connection closes $connectionOnCloseResponseCancelerHandler = function () { }; if ($response instanceof PromiseInterface && \method_exists($response, 'cancel')) { $connectionOnCloseResponseCanceler = function () use($response) { $response->cancel(); }; $connectionOnCloseResponseCancelerHandler = function () use($connectionOnCloseResponseCanceler, $conn) { if ($connectionOnCloseResponseCanceler !== null) { $conn->removeListener('close', $connectionOnCloseResponseCanceler); } }; $conn->on('close', $connectionOnCloseResponseCanceler); } // happy path: response returned, handle and return immediately if ($response instanceof ResponseInterface) { return $this->handleResponse($conn, $request, $response); } // did not return a promise? this is an error, convert into one for rejection below. if (!$response instanceof PromiseInterface) { $response = Promise\resolve($response); } $that = $this; $response->then(function ($response) use($that, $conn, $request) { if (!$response instanceof ResponseInterface) { $message = 'The response callback is expected to resolve with an object implementing Psr\\Http\\Message\\ResponseInterface, but resolved with "%s" instead.'; $message = \sprintf($message, \is_object($response) ? \get_class($response) : \gettype($response)); $exception = new \RuntimeException($message); $that->emit('error', array($exception)); return $that->writeError($conn, Response::STATUS_INTERNAL_SERVER_ERROR, $request); } $that->handleResponse($conn, $request, $response); }, function ($error) use($that, $conn, $request) { $message = 'The response callback is expected to resolve with an object implementing Psr\\Http\\Message\\ResponseInterface, but rejected with "%s" instead.'; $message = \sprintf($message, \is_object($error) ? \get_class($error) : \gettype($error)); $previous = null; if ($error instanceof \Throwable || $error instanceof \Exception) { $previous = $error; } $exception = new \RuntimeException($message, 0, $previous); $that->emit('error', array($exception)); return $that->writeError($conn, Response::STATUS_INTERNAL_SERVER_ERROR, $request); })->then($connectionOnCloseResponseCancelerHandler, $connectionOnCloseResponseCancelerHandler); } /** @internal */ public function writeError(ConnectionInterface $conn, $code, ServerRequestInterface $request) { $response = new Response($code, array('Content-Type' => 'text/plain', 'Connection' => 'close'), 'Error ' . $code); // append reason phrase to response body if known $reason = $response->getReasonPhrase(); if ($reason !== '') { $body = $response->getBody(); $body->seek(0, \SEEK_END); $body->write(': ' . $reason); } $this->handleResponse($conn, $request, $response); } /** @internal */ public function handleResponse(ConnectionInterface $connection, ServerRequestInterface $request, ResponseInterface $response) { // return early and close response body if connection is already closed $body = $response->getBody(); if (!$connection->isWritable()) { $body->close(); return; } $code = $response->getStatusCode(); $method = $request->getMethod(); // assign HTTP protocol version from request automatically $version = $request->getProtocolVersion(); $response = $response->withProtocolVersion($version); // assign default "Server" header automatically if (!$response->hasHeader('Server')) { $response = $response->withHeader('Server', 'ReactPHP/1'); } elseif ($response->getHeaderLine('Server') === '') { $response = $response->withoutHeader('Server'); } // assign default "Date" header from current time automatically if (!$response->hasHeader('Date')) { // IMF-fixdate = day-name "," SP date1 SP time-of-day SP GMT $response = $response->withHeader('Date', \gmdate('D, d M Y H:i:s', (int) $this->clock->now()) . ' GMT'); } elseif ($response->getHeaderLine('Date') === '') { $response = $response->withoutHeader('Date'); } // assign "Content-Length" header automatically $chunked = \false; if ($method === 'CONNECT' && $code >= 200 && $code < 300 || $code >= 100 && $code < 200 || $code === Response::STATUS_NO_CONTENT) { // 2xx response to CONNECT and 1xx and 204 MUST NOT include Content-Length or Transfer-Encoding header $response = $response->withoutHeader('Content-Length'); } elseif ($method === 'HEAD' && $response->hasHeader('Content-Length')) { // HEAD Request: preserve explicit Content-Length } elseif ($code === Response::STATUS_NOT_MODIFIED && ($response->hasHeader('Content-Length') || $body->getSize() === 0)) { // 304 Not Modified: preserve explicit Content-Length and preserve missing header if body is empty } elseif ($body->getSize() !== null) { // assign Content-Length header when using a "normal" buffered body string $response = $response->withHeader('Content-Length', (string) $body->getSize()); } elseif (!$response->hasHeader('Content-Length') && $version === '1.1') { // assign chunked transfer-encoding if no 'content-length' is given for HTTP/1.1 responses $chunked = \true; } // assign "Transfer-Encoding" header automatically if ($chunked) { $response = $response->withHeader('Transfer-Encoding', 'chunked'); } else { // remove any Transfer-Encoding headers unless automatically enabled above $response = $response->withoutHeader('Transfer-Encoding'); } // assign "Connection" header automatically $persist = \false; if ($code === Response::STATUS_SWITCHING_PROTOCOLS) { // 101 (Switching Protocols) response uses Connection: upgrade header // This implies that this stream now uses another protocol and we // may not persist this connection for additional requests. $response = $response->withHeader('Connection', 'upgrade'); } elseif (\strtolower($request->getHeaderLine('Connection')) === 'close' || \strtolower($response->getHeaderLine('Connection')) === 'close') { // obey explicit "Connection: close" request header or response header if present $response = $response->withHeader('Connection', 'close'); } elseif ($version === '1.1') { // HTTP/1.1 assumes persistent connection support by default, so we don't need to inform client $persist = \true; } elseif (\strtolower($request->getHeaderLine('Connection')) === 'keep-alive') { // obey explicit "Connection: keep-alive" request header and inform client $persist = \true; $response = $response->withHeader('Connection', 'keep-alive'); } else { // remove any Connection headers unless automatically enabled above $response = $response->withoutHeader('Connection'); } // 101 (Switching Protocols) response (for Upgrade request) forwards upgraded data through duplex stream // 2xx (Successful) response to CONNECT forwards tunneled application data through duplex stream if (($code === Response::STATUS_SWITCHING_PROTOCOLS || $method === 'CONNECT' && $code >= 200 && $code < 300) && $body instanceof HttpBodyStream && $body->input instanceof WritableStreamInterface) { if ($request->getBody()->isReadable()) { // request is still streaming => wait for request close before forwarding following data from connection $request->getBody()->on('close', function () use($connection, $body) { if ($body->input->isWritable()) { $connection->pipe($body->input); $connection->resume(); } }); } elseif ($body->input->isWritable()) { // request already closed => forward following data from connection $connection->pipe($body->input); $connection->resume(); } } // build HTTP response header by appending status line and header fields $expected = 0; $headers = "HTTP/" . $version . " " . $code . " " . $response->getReasonPhrase() . "\r\n"; foreach ($response->getHeaders() as $name => $values) { if (\strpos($name, ':') !== \false) { $expected = -1; break; } foreach ($values as $value) { $headers .= $name . ": " . $value . "\r\n"; ++$expected; } } /** @var array $m legacy PHP 5.3 only */ if ($code < 100 || $code > 999 || \substr_count($headers, "\n") !== $expected + 1 || (\PHP_VERSION_ID >= 50400 ? \preg_match_all(AbstractMessage::REGEX_HEADERS, $headers) : \preg_match_all(AbstractMessage::REGEX_HEADERS, $headers, $m)) !== $expected) { $this->emit('error', array(new \InvalidArgumentException('Unable to send response with invalid response headers'))); $this->writeError($connection, Response::STATUS_INTERNAL_SERVER_ERROR, $request); return; } // response to HEAD and 1xx, 204 and 304 responses MUST NOT include a body // exclude status 101 (Switching Protocols) here for Upgrade request handling above if ($method === 'HEAD' || $code >= 100 && $code < 200 && $code !== Response::STATUS_SWITCHING_PROTOCOLS || $code === Response::STATUS_NO_CONTENT || $code === Response::STATUS_NOT_MODIFIED) { $body->close(); $body = ''; } // this is a non-streaming response body or the body stream already closed? if (!$body instanceof ReadableStreamInterface || !$body->isReadable()) { // add final chunk if a streaming body is already closed and uses `Transfer-Encoding: chunked` if ($body instanceof ReadableStreamInterface && $chunked) { $body = "0\r\n\r\n"; } // write response headers and body $connection->write($headers . "\r\n" . $body); // either wait for next request over persistent connection or end connection if ($persist) { $this->parser->handle($connection); } else { $connection->end(); } return; } $connection->write($headers . "\r\n"); if ($chunked) { $body = new ChunkedEncoder($body); } // Close response stream once connection closes. // Note that this TCP/IP close detection may take some time, // in particular this may only fire on a later read/write attempt. $connection->on('close', array($body, 'close')); // write streaming body and then wait for next request over persistent connection if ($persist) { $body->pipe($connection, array('end' => \false)); $parser = $this->parser; $body->on('end', function () use($connection, $parser, $body) { $connection->removeListener('close', array($body, 'close')); $parser->handle($connection); }); } else { $body->pipe($connection); } } } <?php namespace _PHPStan_7d8742a37\React\Http\Io; use _PHPStan_7d8742a37\Evenement\EventEmitter; use _PHPStan_7d8742a37\React\Stream\ReadableStreamInterface; use _PHPStan_7d8742a37\React\Stream\Util; use _PHPStan_7d8742a37\React\Stream\WritableStreamInterface; /** * [Internal] Encodes given payload stream with "Transfer-Encoding: chunked" and emits encoded data * * This is used internally to encode outgoing requests with this encoding. * * @internal */ class ChunkedEncoder extends EventEmitter implements ReadableStreamInterface { private $input; private $closed = \false; public function __construct(ReadableStreamInterface $input) { $this->input = $input; $this->input->on('data', array($this, 'handleData')); $this->input->on('end', array($this, 'handleEnd')); $this->input->on('error', array($this, 'handleError')); $this->input->on('close', array($this, 'close')); } public function isReadable() { return !$this->closed && $this->input->isReadable(); } public function pause() { $this->input->pause(); } public function resume() { $this->input->resume(); } public function pipe(WritableStreamInterface $dest, array $options = array()) { return Util::pipe($this, $dest, $options); } public function close() { if ($this->closed) { return; } $this->closed = \true; $this->input->close(); $this->emit('close'); $this->removeAllListeners(); } /** @internal */ public function handleData($data) { if ($data !== '') { $this->emit('data', array(\dechex(\strlen($data)) . "\r\n" . $data . "\r\n")); } } /** @internal */ public function handleError(\Exception $e) { $this->emit('error', array($e)); $this->close(); } /** @internal */ public function handleEnd() { $this->emit('data', array("0\r\n\r\n")); if (!$this->closed) { $this->emit('end'); $this->close(); } } } <?php namespace _PHPStan_7d8742a37\React\Http\Io; use _PHPStan_7d8742a37\Evenement\EventEmitter; use _PHPStan_7d8742a37\React\Stream\ReadableStreamInterface; use _PHPStan_7d8742a37\React\Stream\Util; use _PHPStan_7d8742a37\React\Stream\WritableStreamInterface; /** * [Internal] Protects a given stream from actually closing and only discards its incoming data instead. * * This is used internally to prevent the underlying connection from closing, so * that we can still send back a response over the same stream. * * @internal * */ class CloseProtectionStream extends EventEmitter implements ReadableStreamInterface { private $input; private $closed = \false; private $paused = \false; /** * @param ReadableStreamInterface $input stream that will be discarded instead of closing it on an 'close' event. */ public function __construct(ReadableStreamInterface $input) { $this->input = $input; $this->input->on('data', array($this, 'handleData')); $this->input->on('end', array($this, 'handleEnd')); $this->input->on('error', array($this, 'handleError')); $this->input->on('close', array($this, 'close')); } public function isReadable() { return !$this->closed && $this->input->isReadable(); } public function pause() { if ($this->closed) { return; } $this->paused = \true; $this->input->pause(); } public function resume() { if ($this->closed) { return; } $this->paused = \false; $this->input->resume(); } public function pipe(WritableStreamInterface $dest, array $options = array()) { Util::pipe($this, $dest, $options); return $dest; } public function close() { if ($this->closed) { return; } $this->closed = \true; // stop listening for incoming events $this->input->removeListener('data', array($this, 'handleData')); $this->input->removeListener('error', array($this, 'handleError')); $this->input->removeListener('end', array($this, 'handleEnd')); $this->input->removeListener('close', array($this, 'close')); // resume the stream to ensure we discard everything from incoming connection if ($this->paused) { $this->paused = \false; $this->input->resume(); } $this->emit('close'); $this->removeAllListeners(); } /** @internal */ public function handleData($data) { $this->emit('data', array($data)); } /** @internal */ public function handleEnd() { $this->emit('end'); $this->close(); } /** @internal */ public function handleError(\Exception $e) { $this->emit('error', array($e)); } } <?php namespace _PHPStan_7d8742a37\React\Http\Io; use _PHPStan_7d8742a37\Evenement\EventEmitter; use _PHPStan_7d8742a37\Psr\Http\Message\StreamInterface; use _PHPStan_7d8742a37\React\Stream\ReadableStreamInterface; use _PHPStan_7d8742a37\React\Stream\Util; use _PHPStan_7d8742a37\React\Stream\WritableStreamInterface; /** * [Internal] Bridge between StreamInterface from PSR-7 and ReadableStreamInterface from ReactPHP * * This class is used in the server to stream the body of an incoming response * from the client. This allows us to stream big amounts of data without having * to buffer this data. Similarly, this used to stream the body of an outgoing * request body to the client. The data will be sent directly to the client. * * Note that this is an internal class only and nothing you should usually care * about. See the `StreamInterface` and `ReadableStreamInterface` for more * details. * * @see StreamInterface * @see ReadableStreamInterface * @internal */ class HttpBodyStream extends EventEmitter implements StreamInterface, ReadableStreamInterface { public $input; private $closed = \false; private $size; /** * @param ReadableStreamInterface $input Stream data from $stream as a body of a PSR-7 object4 * @param int|null $size size of the data body */ public function __construct(ReadableStreamInterface $input, $size) { $this->input = $input; $this->size = $size; $this->input->on('data', array($this, 'handleData')); $this->input->on('end', array($this, 'handleEnd')); $this->input->on('error', array($this, 'handleError')); $this->input->on('close', array($this, 'close')); } public function isReadable() { return !$this->closed && $this->input->isReadable(); } public function pause() { $this->input->pause(); } public function resume() { $this->input->resume(); } public function pipe(WritableStreamInterface $dest, array $options = array()) { Util::pipe($this, $dest, $options); return $dest; } public function close() { if ($this->closed) { return; } $this->closed = \true; $this->input->close(); $this->emit('close'); $this->removeAllListeners(); } public function getSize() { return $this->size; } /** @ignore */ public function __toString() { return ''; } /** @ignore */ public function detach() { return null; } /** @ignore */ public function tell() { throw new \BadMethodCallException(); } /** @ignore */ public function eof() { throw new \BadMethodCallException(); } /** @ignore */ public function isSeekable() { return \false; } /** @ignore */ public function seek($offset, $whence = \SEEK_SET) { throw new \BadMethodCallException(); } /** @ignore */ public function rewind() { throw new \BadMethodCallException(); } /** @ignore */ public function isWritable() { return \false; } /** @ignore */ public function write($string) { throw new \BadMethodCallException(); } /** @ignore */ public function read($length) { throw new \BadMethodCallException(); } /** @ignore */ public function getContents() { return ''; } /** @ignore */ public function getMetadata($key = null) { return null; } /** @internal */ public function handleData($data) { $this->emit('data', array($data)); } /** @internal */ public function handleError(\Exception $e) { $this->emit('error', array($e)); $this->close(); } /** @internal */ public function handleEnd() { if (!$this->closed) { $this->emit('end'); $this->close(); } } } <?php namespace _PHPStan_7d8742a37\React\Http\Io; use _PHPStan_7d8742a37\Psr\Http\Message\UriInterface; use _PHPStan_7d8742a37\React\EventLoop\LoopInterface; use _PHPStan_7d8742a37\React\EventLoop\TimerInterface; use _PHPStan_7d8742a37\React\Promise\PromiseInterface; use _PHPStan_7d8742a37\React\Socket\ConnectionInterface; use _PHPStan_7d8742a37\React\Socket\ConnectorInterface; /** * [Internal] Manages outgoing HTTP connections for the HTTP client * * @internal * @final */ class ClientConnectionManager { /** @var ConnectorInterface */ private $connector; /** @var LoopInterface */ private $loop; /** @var string[] */ private $idleUris = array(); /** @var ConnectionInterface[] */ private $idleConnections = array(); /** @var TimerInterface[] */ private $idleTimers = array(); /** @var \Closure[] */ private $idleStreamHandlers = array(); /** @var float */ private $maximumTimeToKeepAliveIdleConnection = 0.001; public function __construct(ConnectorInterface $connector, LoopInterface $loop) { $this->connector = $connector; $this->loop = $loop; } /** * @return PromiseInterface<ConnectionInterface> */ public function connect(UriInterface $uri) { $scheme = $uri->getScheme(); if ($scheme !== 'https' && $scheme !== 'http') { return \_PHPStan_7d8742a37\React\Promise\reject(new \InvalidArgumentException('Invalid request URL given')); } $port = $uri->getPort(); if ($port === null) { $port = $scheme === 'https' ? 443 : 80; } $uri = ($scheme === 'https' ? 'tls://' : '') . $uri->getHost() . ':' . $port; // Reuse idle connection for same URI if available foreach ($this->idleConnections as $id => $connection) { if ($this->idleUris[$id] === $uri) { \assert($this->idleStreamHandlers[$id] instanceof \Closure); $connection->removeListener('close', $this->idleStreamHandlers[$id]); $connection->removeListener('data', $this->idleStreamHandlers[$id]); $connection->removeListener('error', $this->idleStreamHandlers[$id]); \assert($this->idleTimers[$id] instanceof TimerInterface); $this->loop->cancelTimer($this->idleTimers[$id]); unset($this->idleUris[$id], $this->idleConnections[$id], $this->idleTimers[$id], $this->idleStreamHandlers[$id]); return \_PHPStan_7d8742a37\React\Promise\resolve($connection); } } // Create new connection if no idle connection to same URI is available return $this->connector->connect($uri); } /** * Hands back an idle connection to the connection manager for possible future reuse. * * @return void */ public function keepAlive(UriInterface $uri, ConnectionInterface $connection) { $scheme = $uri->getScheme(); \assert($scheme === 'https' || $scheme === 'http'); $port = $uri->getPort(); if ($port === null) { $port = $scheme === 'https' ? 443 : 80; } $this->idleUris[] = ($scheme === 'https' ? 'tls://' : '') . $uri->getHost() . ':' . $port; $this->idleConnections[] = $connection; $that = $this; $cleanUp = function () use($connection, $that) { // call public method to support legacy PHP 5.3 $that->cleanUpConnection($connection); }; // clean up and close connection when maximum time to keep-alive idle connection has passed $this->idleTimers[] = $this->loop->addTimer($this->maximumTimeToKeepAliveIdleConnection, $cleanUp); // clean up and close connection when unexpected close/data/error event happens during idle time $this->idleStreamHandlers[] = $cleanUp; $connection->on('close', $cleanUp); $connection->on('data', $cleanUp); $connection->on('error', $cleanUp); } /** * @internal * @return void */ public function cleanUpConnection(ConnectionInterface $connection) { $id = \array_search($connection, $this->idleConnections, \true); if ($id === \false) { return; } \assert(\is_int($id)); \assert($this->idleTimers[$id] instanceof TimerInterface); $this->loop->cancelTimer($this->idleTimers[$id]); unset($this->idleUris[$id], $this->idleConnections[$id], $this->idleTimers[$id], $this->idleStreamHandlers[$id]); $connection->close(); } } <?php namespace _PHPStan_7d8742a37\React\Http\Io; use _PHPStan_7d8742a37\Evenement\EventEmitter; use _PHPStan_7d8742a37\React\Stream\ReadableStreamInterface; use _PHPStan_7d8742a37\React\Stream\Util; use _PHPStan_7d8742a37\React\Stream\WritableStreamInterface; /** * [Internal] Pauses a given stream and buffers all events while paused * * This class is used to buffer all events that happen on a given stream while * it is paused. This allows you to pause a stream and no longer watch for any * of its events. Once the stream is resumed, all buffered events will be * emitted. Explicitly closing the resulting stream clears all buffers. * * Note that this is an internal class only and nothing you should usually care * about. * * @see ReadableStreamInterface * @internal */ class PauseBufferStream extends EventEmitter implements ReadableStreamInterface { private $input; private $closed = \false; private $paused = \false; private $dataPaused = ''; private $endPaused = \false; private $closePaused = \false; private $errorPaused; private $implicit = \false; public function __construct(ReadableStreamInterface $input) { $this->input = $input; $this->input->on('data', array($this, 'handleData')); $this->input->on('end', array($this, 'handleEnd')); $this->input->on('error', array($this, 'handleError')); $this->input->on('close', array($this, 'handleClose')); } /** * pause and remember this was not explicitly from user control * * @internal */ public function pauseImplicit() { $this->pause(); $this->implicit = \true; } /** * resume only if this was previously paused implicitly and not explicitly from user control * * @internal */ public function resumeImplicit() { if ($this->implicit) { $this->resume(); } } public function isReadable() { return !$this->closed; } public function pause() { if ($this->closed) { return; } $this->input->pause(); $this->paused = \true; $this->implicit = \false; } public function resume() { if ($this->closed) { return; } $this->paused = \false; $this->implicit = \false; if ($this->dataPaused !== '') { $this->emit('data', array($this->dataPaused)); $this->dataPaused = ''; } if ($this->errorPaused) { $this->emit('error', array($this->errorPaused)); return $this->close(); } if ($this->endPaused) { $this->endPaused = \false; $this->emit('end'); return $this->close(); } if ($this->closePaused) { $this->closePaused = \false; return $this->close(); } $this->input->resume(); } public function pipe(WritableStreamInterface $dest, array $options = array()) { Util::pipe($this, $dest, $options); return $dest; } public function close() { if ($this->closed) { return; } $this->closed = \true; $this->dataPaused = ''; $this->endPaused = $this->closePaused = \false; $this->errorPaused = null; $this->input->close(); $this->emit('close'); $this->removeAllListeners(); } /** @internal */ public function handleData($data) { if ($this->paused) { $this->dataPaused .= $data; return; } $this->emit('data', array($data)); } /** @internal */ public function handleError(\Exception $e) { if ($this->paused) { $this->errorPaused = $e; return; } $this->emit('error', array($e)); $this->close(); } /** @internal */ public function handleEnd() { if ($this->paused) { $this->endPaused = \true; return; } if (!$this->closed) { $this->emit('end'); $this->close(); } } /** @internal */ public function handleClose() { if ($this->paused) { $this->closePaused = \true; return; } $this->close(); } } <?php namespace _PHPStan_7d8742a37\React\Http\Io; use _PHPStan_7d8742a37\Evenement\EventEmitter; use _PHPStan_7d8742a37\React\Stream\ReadableStreamInterface; use _PHPStan_7d8742a37\React\Stream\Util; use _PHPStan_7d8742a37\React\Stream\WritableStreamInterface; use Exception; /** * [Internal] Decodes "Transfer-Encoding: chunked" from given stream and returns only payload data. * * This is used internally to decode incoming requests with this encoding. * * @internal */ class ChunkedDecoder extends EventEmitter implements ReadableStreamInterface { const CRLF = "\r\n"; const MAX_CHUNK_HEADER_SIZE = 1024; private $closed = \false; private $input; private $buffer = ''; private $chunkSize = 0; private $transferredSize = 0; private $headerCompleted = \false; public function __construct(ReadableStreamInterface $input) { $this->input = $input; $this->input->on('data', array($this, 'handleData')); $this->input->on('end', array($this, 'handleEnd')); $this->input->on('error', array($this, 'handleError')); $this->input->on('close', array($this, 'close')); } public function isReadable() { return !$this->closed && $this->input->isReadable(); } public function pause() { $this->input->pause(); } public function resume() { $this->input->resume(); } public function pipe(WritableStreamInterface $dest, array $options = array()) { Util::pipe($this, $dest, $options); return $dest; } public function close() { if ($this->closed) { return; } $this->buffer = ''; $this->closed = \true; $this->input->close(); $this->emit('close'); $this->removeAllListeners(); } /** @internal */ public function handleEnd() { if (!$this->closed) { $this->handleError(new Exception('Unexpected end event')); } } /** @internal */ public function handleError(Exception $e) { $this->emit('error', array($e)); $this->close(); } /** @internal */ public function handleData($data) { $this->buffer .= $data; while ($this->buffer !== '') { if (!$this->headerCompleted) { $positionCrlf = \strpos($this->buffer, static::CRLF); if ($positionCrlf === \false) { // Header shouldn't be bigger than 1024 bytes if (isset($this->buffer[static::MAX_CHUNK_HEADER_SIZE])) { $this->handleError(new Exception('Chunk header size inclusive extension bigger than' . static::MAX_CHUNK_HEADER_SIZE . ' bytes')); } return; } $header = \strtolower((string) \substr($this->buffer, 0, $positionCrlf)); $hexValue = $header; if (\strpos($header, ';') !== \false) { $array = \explode(';', $header); $hexValue = $array[0]; } if ($hexValue !== '') { $hexValue = \ltrim(\trim($hexValue), "0"); if ($hexValue === '') { $hexValue = "0"; } } $this->chunkSize = @\hexdec($hexValue); if (!\is_int($this->chunkSize) || \dechex($this->chunkSize) !== $hexValue) { $this->handleError(new Exception($hexValue . ' is not a valid hexadecimal number')); return; } $this->buffer = (string) \substr($this->buffer, $positionCrlf + 2); $this->headerCompleted = \true; if ($this->buffer === '') { return; } } $chunk = (string) \substr($this->buffer, 0, $this->chunkSize - $this->transferredSize); if ($chunk !== '') { $this->transferredSize += \strlen($chunk); $this->emit('data', array($chunk)); $this->buffer = (string) \substr($this->buffer, \strlen($chunk)); } $positionCrlf = \strpos($this->buffer, static::CRLF); if ($positionCrlf === 0) { if ($this->chunkSize === 0) { $this->emit('end'); $this->close(); return; } $this->chunkSize = 0; $this->headerCompleted = \false; $this->transferredSize = 0; $this->buffer = (string) \substr($this->buffer, 2); } elseif ($this->chunkSize === 0) { // end chunk received, skip all trailer data $this->buffer = (string) \substr($this->buffer, $positionCrlf); } if ($positionCrlf !== 0 && $this->chunkSize !== 0 && $this->chunkSize === $this->transferredSize && \strlen($this->buffer) > 2) { // the first 2 characters are not CRLF, send error event $this->handleError(new Exception('Chunk does not end with a CRLF')); return; } if ($positionCrlf !== 0 && \strlen($this->buffer) < 2) { // No CRLF found, wait for additional data which could be a CRLF return; } } } } <?php namespace _PHPStan_7d8742a37\React\Http\Io; use _PHPStan_7d8742a37\Evenement\EventEmitter; use _PHPStan_7d8742a37\Psr\Http\Message\StreamInterface; use _PHPStan_7d8742a37\React\Stream\ReadableStreamInterface; use _PHPStan_7d8742a37\React\Stream\Util; use _PHPStan_7d8742a37\React\Stream\WritableStreamInterface; /** * @internal */ class ReadableBodyStream extends EventEmitter implements ReadableStreamInterface, StreamInterface { private $input; private $position = 0; private $size; private $closed = \false; public function __construct(ReadableStreamInterface $input, $size = null) { $this->input = $input; $this->size = $size; $that = $this; $pos =& $this->position; $input->on('data', function ($data) use($that, &$pos, $size) { $that->emit('data', array($data)); $pos += \strlen($data); if ($size !== null && $pos >= $size) { $that->handleEnd(); } }); $input->on('error', function ($error) use($that) { $that->emit('error', array($error)); $that->close(); }); $input->on('end', array($that, 'handleEnd')); $input->on('close', array($that, 'close')); } public function close() { if (!$this->closed) { $this->closed = \true; $this->input->close(); $this->emit('close'); $this->removeAllListeners(); } } public function isReadable() { return $this->input->isReadable(); } public function pause() { $this->input->pause(); } public function resume() { $this->input->resume(); } public function pipe(WritableStreamInterface $dest, array $options = array()) { Util::pipe($this, $dest, $options); return $dest; } public function eof() { return !$this->isReadable(); } public function __toString() { return ''; } public function detach() { throw new \BadMethodCallException(); } public function getSize() { return $this->size; } public function tell() { throw new \BadMethodCallException(); } public function isSeekable() { return \false; } public function seek($offset, $whence = \SEEK_SET) { throw new \BadMethodCallException(); } public function rewind() { throw new \BadMethodCallException(); } public function isWritable() { return \false; } public function write($string) { throw new \BadMethodCallException(); } public function read($length) { throw new \BadMethodCallException(); } public function getContents() { throw new \BadMethodCallException(); } public function getMetadata($key = null) { return $key === null ? array() : null; } /** @internal */ public function handleEnd() { if ($this->position !== $this->size && $this->size !== null) { $this->emit('error', array(new \UnderflowException('Unexpected end of response body after ' . $this->position . '/' . $this->size . ' bytes'))); } else { $this->emit('end'); } $this->close(); } } <?php namespace _PHPStan_7d8742a37\React\Http\Io; use _PHPStan_7d8742a37\Evenement\EventEmitter; use _PHPStan_7d8742a37\React\Stream\ReadableStreamInterface; use _PHPStan_7d8742a37\React\Stream\Util; use _PHPStan_7d8742a37\React\Stream\WritableStreamInterface; /** * [Internal] Limits the amount of data the given stream can emit * * This is used internally to limit the size of the underlying connection stream * to the size defined by the "Content-Length" header of the incoming request. * * @internal */ class LengthLimitedStream extends EventEmitter implements ReadableStreamInterface { private $stream; private $closed = \false; private $transferredLength = 0; private $maxLength; public function __construct(ReadableStreamInterface $stream, $maxLength) { $this->stream = $stream; $this->maxLength = $maxLength; $this->stream->on('data', array($this, 'handleData')); $this->stream->on('end', array($this, 'handleEnd')); $this->stream->on('error', array($this, 'handleError')); $this->stream->on('close', array($this, 'close')); } public function isReadable() { return !$this->closed && $this->stream->isReadable(); } public function pause() { $this->stream->pause(); } public function resume() { $this->stream->resume(); } public function pipe(WritableStreamInterface $dest, array $options = array()) { Util::pipe($this, $dest, $options); return $dest; } public function close() { if ($this->closed) { return; } $this->closed = \true; $this->stream->close(); $this->emit('close'); $this->removeAllListeners(); } /** @internal */ public function handleData($data) { if ($this->transferredLength + \strlen($data) > $this->maxLength) { // Only emit data until the value of 'Content-Length' is reached, the rest will be ignored $data = (string) \substr($data, 0, $this->maxLength - $this->transferredLength); } if ($data !== '') { $this->transferredLength += \strlen($data); $this->emit('data', array($data)); } if ($this->transferredLength === $this->maxLength) { // 'Content-Length' reached, stream will end $this->emit('end'); $this->close(); $this->stream->removeListener('data', array($this, 'handleData')); } } /** @internal */ public function handleError(\Exception $e) { $this->emit('error', array($e)); $this->close(); } /** @internal */ public function handleEnd() { if (!$this->closed) { $this->handleError(new \Exception('Unexpected end event')); } } } <?php namespace _PHPStan_7d8742a37\React\Http; use _PHPStan_7d8742a37\Psr\Http\Message\ResponseInterface; use _PHPStan_7d8742a37\React\EventLoop\Loop; use _PHPStan_7d8742a37\React\EventLoop\LoopInterface; use _PHPStan_7d8742a37\React\Http\Io\Sender; use _PHPStan_7d8742a37\React\Http\Io\Transaction; use _PHPStan_7d8742a37\React\Http\Message\Request; use _PHPStan_7d8742a37\React\Http\Message\Uri; use _PHPStan_7d8742a37\React\Promise\PromiseInterface; use _PHPStan_7d8742a37\React\Socket\ConnectorInterface; use _PHPStan_7d8742a37\React\Stream\ReadableStreamInterface; use InvalidArgumentException; /** * @final This class is final and shouldn't be extended as it is likely to be marked final in a future release. */ class Browser { private $transaction; private $baseUrl; private $protocolVersion = '1.1'; private $defaultHeaders = array('User-Agent' => 'ReactPHP/1'); /** * The `Browser` is responsible for sending HTTP requests to your HTTP server * and keeps track of pending incoming HTTP responses. * * ```php * $browser = new React\Http\Browser(); * ``` * * This class takes two optional arguments for more advanced usage: * * ```php * // constructor signature as of v1.5.0 * $browser = new React\Http\Browser(?ConnectorInterface $connector = null, ?LoopInterface $loop = null); * * // legacy constructor signature before v1.5.0 * $browser = new React\Http\Browser(?LoopInterface $loop = null, ?ConnectorInterface $connector = null); * ``` * * If you need custom connector settings (DNS resolution, TLS parameters, timeouts, * proxy servers etc.), you can explicitly pass a custom instance of the * [`ConnectorInterface`](https://github.com/reactphp/socket#connectorinterface): * * ```php * $connector = new React\Socket\Connector(array( * 'dns' => '127.0.0.1', * 'tcp' => array( * 'bindto' => '192.168.10.1:0' * ), * 'tls' => array( * 'verify_peer' => false, * 'verify_peer_name' => false * ) * )); * * $browser = new React\Http\Browser($connector); * ``` * * This class takes an optional `LoopInterface|null $loop` parameter that can be used to * pass the event loop instance to use for this object. You can use a `null` value * here in order to use the [default loop](https://github.com/reactphp/event-loop#loop). * This value SHOULD NOT be given unless you're sure you want to explicitly use a * given event loop instance. * * @param null|ConnectorInterface|LoopInterface $connector * @param null|LoopInterface|ConnectorInterface $loop * @throws \InvalidArgumentException for invalid arguments */ public function __construct($connector = null, $loop = null) { // swap arguments for legacy constructor signature if (($connector instanceof LoopInterface || $connector === null) && ($loop instanceof ConnectorInterface || $loop === null)) { $swap = $loop; $loop = $connector; $connector = $swap; } if ($connector !== null && !$connector instanceof ConnectorInterface || $loop !== null && !$loop instanceof LoopInterface) { throw new \InvalidArgumentException('Expected "?ConnectorInterface $connector" and "?LoopInterface $loop" arguments'); } $loop = $loop ?: Loop::get(); $this->transaction = new Transaction(Sender::createFromLoop($loop, $connector), $loop); } /** * Sends an HTTP GET request * * ```php * $browser->get($url)->then(function (Psr\Http\Message\ResponseInterface $response) { * var_dump((string)$response->getBody()); * }, function (Exception $e) { * echo 'Error: ' . $e->getMessage() . PHP_EOL; * }); * ``` * * See also [GET request client example](../examples/01-client-get-request.php). * * @param string $url URL for the request. * @param array $headers * @return PromiseInterface<ResponseInterface> */ public function get($url, array $headers = array()) { return $this->requestMayBeStreaming('GET', $url, $headers); } /** * Sends an HTTP POST request * * ```php * $browser->post( * $url, * [ * 'Content-Type' => 'application/json' * ], * json_encode($data) * )->then(function (Psr\Http\Message\ResponseInterface $response) { * var_dump(json_decode((string)$response->getBody())); * }, function (Exception $e) { * echo 'Error: ' . $e->getMessage() . PHP_EOL; * }); * ``` * * See also [POST JSON client example](../examples/04-client-post-json.php). * * This method is also commonly used to submit HTML form data: * * ```php * $data = [ * 'user' => 'Alice', * 'password' => 'secret' * ]; * * $browser->post( * $url, * [ * 'Content-Type' => 'application/x-www-form-urlencoded' * ], * http_build_query($data) * ); * ``` * * This method will automatically add a matching `Content-Length` request * header if the outgoing request body is a `string`. If you're using a * streaming request body (`ReadableStreamInterface`), it will default to * using `Transfer-Encoding: chunked` or you have to explicitly pass in a * matching `Content-Length` request header like so: * * ```php * $body = new React\Stream\ThroughStream(); * Loop::addTimer(1.0, function () use ($body) { * $body->end("hello world"); * }); * * $browser->post($url, array('Content-Length' => '11'), $body); * ``` * * @param string $url URL for the request. * @param array $headers * @param string|ReadableStreamInterface $body * @return PromiseInterface<ResponseInterface> */ public function post($url, array $headers = array(), $body = '') { return $this->requestMayBeStreaming('POST', $url, $headers, $body); } /** * Sends an HTTP HEAD request * * ```php * $browser->head($url)->then(function (Psr\Http\Message\ResponseInterface $response) { * var_dump($response->getHeaders()); * }, function (Exception $e) { * echo 'Error: ' . $e->getMessage() . PHP_EOL; * }); * ``` * * @param string $url URL for the request. * @param array $headers * @return PromiseInterface<ResponseInterface> */ public function head($url, array $headers = array()) { return $this->requestMayBeStreaming('HEAD', $url, $headers); } /** * Sends an HTTP PATCH request * * ```php * $browser->patch( * $url, * [ * 'Content-Type' => 'application/json' * ], * json_encode($data) * )->then(function (Psr\Http\Message\ResponseInterface $response) { * var_dump(json_decode((string)$response->getBody())); * }, function (Exception $e) { * echo 'Error: ' . $e->getMessage() . PHP_EOL; * }); * ``` * * This method will automatically add a matching `Content-Length` request * header if the outgoing request body is a `string`. If you're using a * streaming request body (`ReadableStreamInterface`), it will default to * using `Transfer-Encoding: chunked` or you have to explicitly pass in a * matching `Content-Length` request header like so: * * ```php * $body = new React\Stream\ThroughStream(); * Loop::addTimer(1.0, function () use ($body) { * $body->end("hello world"); * }); * * $browser->patch($url, array('Content-Length' => '11'), $body); * ``` * * @param string $url URL for the request. * @param array $headers * @param string|ReadableStreamInterface $body * @return PromiseInterface<ResponseInterface> */ public function patch($url, array $headers = array(), $body = '') { return $this->requestMayBeStreaming('PATCH', $url, $headers, $body); } /** * Sends an HTTP PUT request * * ```php * $browser->put( * $url, * [ * 'Content-Type' => 'text/xml' * ], * $xml->asXML() * )->then(function (Psr\Http\Message\ResponseInterface $response) { * var_dump((string)$response->getBody()); * }, function (Exception $e) { * echo 'Error: ' . $e->getMessage() . PHP_EOL; * }); * ``` * * See also [PUT XML client example](../examples/05-client-put-xml.php). * * This method will automatically add a matching `Content-Length` request * header if the outgoing request body is a `string`. If you're using a * streaming request body (`ReadableStreamInterface`), it will default to * using `Transfer-Encoding: chunked` or you have to explicitly pass in a * matching `Content-Length` request header like so: * * ```php * $body = new React\Stream\ThroughStream(); * Loop::addTimer(1.0, function () use ($body) { * $body->end("hello world"); * }); * * $browser->put($url, array('Content-Length' => '11'), $body); * ``` * * @param string $url URL for the request. * @param array $headers * @param string|ReadableStreamInterface $body * @return PromiseInterface<ResponseInterface> */ public function put($url, array $headers = array(), $body = '') { return $this->requestMayBeStreaming('PUT', $url, $headers, $body); } /** * Sends an HTTP DELETE request * * ```php * $browser->delete($url)->then(function (Psr\Http\Message\ResponseInterface $response) { * var_dump((string)$response->getBody()); * }, function (Exception $e) { * echo 'Error: ' . $e->getMessage() . PHP_EOL; * }); * ``` * * @param string $url URL for the request. * @param array $headers * @param string|ReadableStreamInterface $body * @return PromiseInterface<ResponseInterface> */ public function delete($url, array $headers = array(), $body = '') { return $this->requestMayBeStreaming('DELETE', $url, $headers, $body); } /** * Sends an arbitrary HTTP request. * * The preferred way to send an HTTP request is by using the above * [request methods](#request-methods), for example the [`get()`](#get) * method to send an HTTP `GET` request. * * As an alternative, if you want to use a custom HTTP request method, you * can use this method: * * ```php * $browser->request('OPTIONS', $url)->then(function (Psr\Http\Message\ResponseInterface $response) { * var_dump((string)$response->getBody()); * }, function (Exception $e) { * echo 'Error: ' . $e->getMessage() . PHP_EOL; * }); * ``` * * This method will automatically add a matching `Content-Length` request * header if the size of the outgoing request body is known and non-empty. * For an empty request body, if will only include a `Content-Length: 0` * request header if the request method usually expects a request body (only * applies to `POST`, `PUT` and `PATCH`). * * If you're using a streaming request body (`ReadableStreamInterface`), it * will default to using `Transfer-Encoding: chunked` or you have to * explicitly pass in a matching `Content-Length` request header like so: * * ```php * $body = new React\Stream\ThroughStream(); * Loop::addTimer(1.0, function () use ($body) { * $body->end("hello world"); * }); * * $browser->request('POST', $url, array('Content-Length' => '11'), $body); * ``` * * @param string $method HTTP request method, e.g. GET/HEAD/POST etc. * @param string $url URL for the request * @param array $headers Additional request headers * @param string|ReadableStreamInterface $body HTTP request body contents * @return PromiseInterface<ResponseInterface> */ public function request($method, $url, array $headers = array(), $body = '') { return $this->withOptions(array('streaming' => \false))->requestMayBeStreaming($method, $url, $headers, $body); } /** * Sends an arbitrary HTTP request and receives a streaming response without buffering the response body. * * The preferred way to send an HTTP request is by using the above * [request methods](#request-methods), for example the [`get()`](#get) * method to send an HTTP `GET` request. Each of these methods will buffer * the whole response body in memory by default. This is easy to get started * and works reasonably well for smaller responses. * * In some situations, it's a better idea to use a streaming approach, where * only small chunks have to be kept in memory. You can use this method to * send an arbitrary HTTP request and receive a streaming response. It uses * the same HTTP message API, but does not buffer the response body in * memory. It only processes the response body in small chunks as data is * received and forwards this data through [ReactPHP's Stream API](https://github.com/reactphp/stream). * This works for (any number of) responses of arbitrary sizes. * * ```php * $browser->requestStreaming('GET', $url)->then(function (Psr\Http\Message\ResponseInterface $response) { * $body = $response->getBody(); * assert($body instanceof Psr\Http\Message\StreamInterface); * assert($body instanceof React\Stream\ReadableStreamInterface); * * $body->on('data', function ($chunk) { * echo $chunk; * }); * * $body->on('error', function (Exception $e) { * echo 'Error: ' . $e->getMessage() . PHP_EOL; * }); * * $body->on('close', function () { * echo '[DONE]' . PHP_EOL; * }); * }, function (Exception $e) { * echo 'Error: ' . $e->getMessage() . PHP_EOL; * }); * ``` * * See also [`ReadableStreamInterface`](https://github.com/reactphp/stream#readablestreaminterface) * and the [streaming response](#streaming-response) for more details, * examples and possible use-cases. * * This method will automatically add a matching `Content-Length` request * header if the size of the outgoing request body is known and non-empty. * For an empty request body, if will only include a `Content-Length: 0` * request header if the request method usually expects a request body (only * applies to `POST`, `PUT` and `PATCH`). * * If you're using a streaming request body (`ReadableStreamInterface`), it * will default to using `Transfer-Encoding: chunked` or you have to * explicitly pass in a matching `Content-Length` request header like so: * * ```php * $body = new React\Stream\ThroughStream(); * Loop::addTimer(1.0, function () use ($body) { * $body->end("hello world"); * }); * * $browser->requestStreaming('POST', $url, array('Content-Length' => '11'), $body); * ``` * * @param string $method HTTP request method, e.g. GET/HEAD/POST etc. * @param string $url URL for the request * @param array $headers Additional request headers * @param string|ReadableStreamInterface $body HTTP request body contents * @return PromiseInterface<ResponseInterface> */ public function requestStreaming($method, $url, $headers = array(), $body = '') { return $this->withOptions(array('streaming' => \true))->requestMayBeStreaming($method, $url, $headers, $body); } /** * Changes the maximum timeout used for waiting for pending requests. * * You can pass in the number of seconds to use as a new timeout value: * * ```php * $browser = $browser->withTimeout(10.0); * ``` * * You can pass in a bool `false` to disable any timeouts. In this case, * requests can stay pending forever: * * ```php * $browser = $browser->withTimeout(false); * ``` * * You can pass in a bool `true` to re-enable default timeout handling. This * will respects PHP's `default_socket_timeout` setting (default 60s): * * ```php * $browser = $browser->withTimeout(true); * ``` * * See also [timeouts](#timeouts) for more details about timeout handling. * * Notice that the [`Browser`](#browser) is an immutable object, i.e. this * method actually returns a *new* [`Browser`](#browser) instance with the * given timeout value applied. * * @param bool|number $timeout * @return self */ public function withTimeout($timeout) { if ($timeout === \true) { $timeout = null; } elseif ($timeout === \false) { $timeout = -1; } elseif ($timeout < 0) { $timeout = 0; } return $this->withOptions(array('timeout' => $timeout)); } /** * Changes how HTTP redirects will be followed. * * You can pass in the maximum number of redirects to follow: * * ```php * $browser = $browser->withFollowRedirects(5); * ``` * * The request will automatically be rejected when the number of redirects * is exceeded. You can pass in a `0` to reject the request for any * redirects encountered: * * ```php * $browser = $browser->withFollowRedirects(0); * * $browser->get($url)->then(function (Psr\Http\Message\ResponseInterface $response) { * // only non-redirected responses will now end up here * var_dump($response->getHeaders()); * }, function (Exception $e) { * echo 'Error: ' . $e->getMessage() . PHP_EOL; * }); * ``` * * You can pass in a bool `false` to disable following any redirects. In * this case, requests will resolve with the redirection response instead * of following the `Location` response header: * * ```php * $browser = $browser->withFollowRedirects(false); * * $browser->get($url)->then(function (Psr\Http\Message\ResponseInterface $response) { * // any redirects will now end up here * var_dump($response->getHeaderLine('Location')); * }, function (Exception $e) { * echo 'Error: ' . $e->getMessage() . PHP_EOL; * }); * ``` * * You can pass in a bool `true` to re-enable default redirect handling. * This defaults to following a maximum of 10 redirects: * * ```php * $browser = $browser->withFollowRedirects(true); * ``` * * See also [redirects](#redirects) for more details about redirect handling. * * Notice that the [`Browser`](#browser) is an immutable object, i.e. this * method actually returns a *new* [`Browser`](#browser) instance with the * given redirect setting applied. * * @param bool|int $followRedirects * @return self */ public function withFollowRedirects($followRedirects) { return $this->withOptions(array('followRedirects' => $followRedirects !== \false, 'maxRedirects' => \is_bool($followRedirects) ? null : $followRedirects)); } /** * Changes whether non-successful HTTP response status codes (4xx and 5xx) will be rejected. * * You can pass in a bool `false` to disable rejecting incoming responses * that use a 4xx or 5xx response status code. In this case, requests will * resolve with the response message indicating an error condition: * * ```php * $browser = $browser->withRejectErrorResponse(false); * * $browser->get($url)->then(function (Psr\Http\Message\ResponseInterface $response) { * // any HTTP response will now end up here * var_dump($response->getStatusCode(), $response->getReasonPhrase()); * }, function (Exception $e) { * echo 'Error: ' . $e->getMessage() . PHP_EOL; * }); * ``` * * You can pass in a bool `true` to re-enable default status code handling. * This defaults to rejecting any response status codes in the 4xx or 5xx * range: * * ```php * $browser = $browser->withRejectErrorResponse(true); * * $browser->get($url)->then(function (Psr\Http\Message\ResponseInterface $response) { * // any successful HTTP response will now end up here * var_dump($response->getStatusCode(), $response->getReasonPhrase()); * }, function (Exception $e) { * if ($e instanceof React\Http\Message\ResponseException) { * // any HTTP response error message will now end up here * $response = $e->getResponse(); * var_dump($response->getStatusCode(), $response->getReasonPhrase()); * } else { * echo 'Error: ' . $e->getMessage() . PHP_EOL; * } * }); * ``` * * Notice that the [`Browser`](#browser) is an immutable object, i.e. this * method actually returns a *new* [`Browser`](#browser) instance with the * given setting applied. * * @param bool $obeySuccessCode * @return self */ public function withRejectErrorResponse($obeySuccessCode) { return $this->withOptions(array('obeySuccessCode' => $obeySuccessCode)); } /** * Changes the base URL used to resolve relative URLs to. * * If you configure a base URL, any requests to relative URLs will be * processed by first resolving this relative to the given absolute base * URL. This supports resolving relative path references (like `../` etc.). * This is particularly useful for (RESTful) API calls where all endpoints * (URLs) are located under a common base URL. * * ```php * $browser = $browser->withBase('http://api.example.com/v3/'); * * // will request http://api.example.com/v3/users * $browser->get('users')->then(…); * ``` * * You can pass in a `null` base URL to return a new instance that does not * use a base URL: * * ```php * $browser = $browser->withBase(null); * ``` * * Accordingly, any requests using relative URLs to a browser that does not * use a base URL can not be completed and will be rejected without sending * a request. * * This method will throw an `InvalidArgumentException` if the given * `$baseUrl` argument is not a valid URL. * * Notice that the [`Browser`](#browser) is an immutable object, i.e. the `withBase()` method * actually returns a *new* [`Browser`](#browser) instance with the given base URL applied. * * @param string|null $baseUrl absolute base URL * @return self * @throws InvalidArgumentException if the given $baseUrl is not a valid absolute URL * @see self::withoutBase() */ public function withBase($baseUrl) { $browser = clone $this; if ($baseUrl === null) { $browser->baseUrl = null; return $browser; } $browser->baseUrl = new Uri($baseUrl); if (!\in_array($browser->baseUrl->getScheme(), array('http', 'https')) || $browser->baseUrl->getHost() === '') { throw new \InvalidArgumentException('Base URL must be absolute'); } return $browser; } /** * Changes the HTTP protocol version that will be used for all subsequent requests. * * All the above [request methods](#request-methods) default to sending * requests as HTTP/1.1. This is the preferred HTTP protocol version which * also provides decent backwards-compatibility with legacy HTTP/1.0 * servers. As such, there should rarely be a need to explicitly change this * protocol version. * * If you want to explicitly use the legacy HTTP/1.0 protocol version, you * can use this method: * * ```php * $browser = $browser->withProtocolVersion('1.0'); * * $browser->get($url)->then(…); * ``` * * Notice that the [`Browser`](#browser) is an immutable object, i.e. this * method actually returns a *new* [`Browser`](#browser) instance with the * new protocol version applied. * * @param string $protocolVersion HTTP protocol version to use, must be one of "1.1" or "1.0" * @return self * @throws InvalidArgumentException */ public function withProtocolVersion($protocolVersion) { if (!\in_array($protocolVersion, array('1.0', '1.1'), \true)) { throw new InvalidArgumentException('Invalid HTTP protocol version, must be one of "1.1" or "1.0"'); } $browser = clone $this; $browser->protocolVersion = (string) $protocolVersion; return $browser; } /** * Changes the maximum size for buffering a response body. * * The preferred way to send an HTTP request is by using the above * [request methods](#request-methods), for example the [`get()`](#get) * method to send an HTTP `GET` request. Each of these methods will buffer * the whole response body in memory by default. This is easy to get started * and works reasonably well for smaller responses. * * By default, the response body buffer will be limited to 16 MiB. If the * response body exceeds this maximum size, the request will be rejected. * * You can pass in the maximum number of bytes to buffer: * * ```php * $browser = $browser->withResponseBuffer(1024 * 1024); * * $browser->get($url)->then(function (Psr\Http\Message\ResponseInterface $response) { * // response body will not exceed 1 MiB * var_dump($response->getHeaders(), (string) $response->getBody()); * }, function (Exception $e) { * echo 'Error: ' . $e->getMessage() . PHP_EOL; * }); * ``` * * Note that the response body buffer has to be kept in memory for each * pending request until its transfer is completed and it will only be freed * after a pending request is fulfilled. As such, increasing this maximum * buffer size to allow larger response bodies is usually not recommended. * Instead, you can use the [`requestStreaming()` method](#requeststreaming) * to receive responses with arbitrary sizes without buffering. Accordingly, * this maximum buffer size setting has no effect on streaming responses. * * Notice that the [`Browser`](#browser) is an immutable object, i.e. this * method actually returns a *new* [`Browser`](#browser) instance with the * given setting applied. * * @param int $maximumSize * @return self * @see self::requestStreaming() */ public function withResponseBuffer($maximumSize) { return $this->withOptions(array('maximumSize' => $maximumSize)); } /** * Add a request header for all following requests. * * ```php * $browser = $browser->withHeader('User-Agent', 'ACME'); * * $browser->get($url)->then(…); * ``` * * Note that the new header will overwrite any headers previously set with * the same name (case-insensitive). Following requests will use these headers * by default unless they are explicitly set for any requests. * * @param string $header * @param string $value * @return Browser */ public function withHeader($header, $value) { $browser = $this->withoutHeader($header); $browser->defaultHeaders[$header] = $value; return $browser; } /** * Remove any default request headers previously set via * the [`withHeader()` method](#withheader). * * ```php * $browser = $browser->withoutHeader('User-Agent'); * * $browser->get($url)->then(…); * ``` * * Note that this method only affects the headers which were set with the * method `withHeader(string $header, string $value): Browser` * * @param string $header * @return Browser */ public function withoutHeader($header) { $browser = clone $this; /** @var string|int $key */ foreach (\array_keys($browser->defaultHeaders) as $key) { if (\strcasecmp($key, $header) === 0) { unset($browser->defaultHeaders[$key]); break; } } return $browser; } /** * Changes the [options](#options) to use: * * The [`Browser`](#browser) class exposes several options for the handling of * HTTP transactions. These options resemble some of PHP's * [HTTP context options](http://php.net/manual/en/context.http.php) and * can be controlled via the following API (and their defaults): * * ```php * // deprecated * $newBrowser = $browser->withOptions(array( * 'timeout' => null, // see withTimeout() instead * 'followRedirects' => true, // see withFollowRedirects() instead * 'maxRedirects' => 10, // see withFollowRedirects() instead * 'obeySuccessCode' => true, // see withRejectErrorResponse() instead * 'streaming' => false, // deprecated, see requestStreaming() instead * )); * ``` * * See also [timeouts](#timeouts), [redirects](#redirects) and * [streaming](#streaming) for more details. * * Notice that the [`Browser`](#browser) is an immutable object, i.e. this * method actually returns a *new* [`Browser`](#browser) instance with the * options applied. * * @param array $options * @return self * @see self::withTimeout() * @see self::withFollowRedirects() * @see self::withRejectErrorResponse() */ private function withOptions(array $options) { $browser = clone $this; $browser->transaction = $this->transaction->withOptions($options); return $browser; } /** * @param string $method * @param string $url * @param array $headers * @param string|ReadableStreamInterface $body * @return PromiseInterface<ResponseInterface> */ private function requestMayBeStreaming($method, $url, array $headers = array(), $body = '') { if ($this->baseUrl !== null) { // ensure we're actually below the base URL $url = Uri::resolve($this->baseUrl, new Uri($url)); } foreach ($this->defaultHeaders as $key => $value) { $explicitHeaderExists = \false; foreach (\array_keys($headers) as $headerKey) { if (\strcasecmp($headerKey, $key) === 0) { $explicitHeaderExists = \true; break; } } if (!$explicitHeaderExists) { $headers[$key] = $value; } } return $this->transaction->send(new Request($method, $url, $headers, $body, $this->protocolVersion)); } } <?php namespace _PHPStan_7d8742a37\React\Http\Middleware; use OverflowException; use _PHPStan_7d8742a37\Psr\Http\Message\ServerRequestInterface; use _PHPStan_7d8742a37\React\Http\Io\BufferedBody; use _PHPStan_7d8742a37\React\Http\Io\IniUtil; use _PHPStan_7d8742a37\React\Promise\Promise; use _PHPStan_7d8742a37\React\Stream\ReadableStreamInterface; final class RequestBodyBufferMiddleware { private $sizeLimit; /** * @param int|string|null $sizeLimit Either an int with the max request body size * in bytes or an ini like size string * or null to use post_max_size from PHP's * configuration. (Note that the value from * the CLI configuration will be used.) */ public function __construct($sizeLimit = null) { if ($sizeLimit === null) { $sizeLimit = \ini_get('post_max_size'); } $this->sizeLimit = IniUtil::iniSizeToBytes($sizeLimit); } public function __invoke(ServerRequestInterface $request, $next) { $body = $request->getBody(); $size = $body->getSize(); // happy path: skip if body is known to be empty (or is already buffered) if ($size === 0 || !$body instanceof ReadableStreamInterface || !$body->isReadable()) { // replace with empty body if body is streaming (or buffered size exceeds limit) if ($body instanceof ReadableStreamInterface || $size > $this->sizeLimit) { $request = $request->withBody(new BufferedBody('')); } return $next($request); } // request body of known size exceeding limit $sizeLimit = $this->sizeLimit; if ($size > $this->sizeLimit) { $sizeLimit = 0; } /** @var ?\Closure $closer */ $closer = null; return new Promise(function ($resolve, $reject) use($body, &$closer, $sizeLimit, $request, $next) { // buffer request body data in memory, discard but keep buffering if limit is reached $buffer = ''; $bufferer = null; $body->on('data', $bufferer = function ($data) use(&$buffer, $sizeLimit, $body, &$bufferer) { $buffer .= $data; // On buffer overflow keep the request body stream in, // but ignore the contents and wait for the close event // before passing the request on to the next middleware. if (isset($buffer[$sizeLimit])) { \assert($bufferer instanceof \Closure); $body->removeListener('data', $bufferer); $bufferer = null; $buffer = ''; } }); // call $next with current buffer and resolve or reject with its results $body->on('close', $closer = function () use(&$buffer, $request, $resolve, $reject, $next) { try { // resolve with result of next handler $resolve($next($request->withBody(new BufferedBody($buffer)))); } catch (\Exception $e) { $reject($e); } catch (\Throwable $e) { // @codeCoverageIgnoreStart // reject Errors just like Exceptions (PHP 7+) $reject($e); // @codeCoverageIgnoreEnd } }); // reject buffering if body emits error $body->on('error', function (\Exception $e) use($reject, $body, $closer) { // remove close handler to avoid resolving, then close and reject \assert($closer instanceof \Closure); $body->removeListener('close', $closer); $body->close(); $reject(new \RuntimeException('Error while buffering request body: ' . $e->getMessage(), $e->getCode(), $e)); }); }, function () use($body, &$closer) { // cancelled buffering: remove close handler to avoid resolving, then close and reject \assert($closer instanceof \Closure); $body->removeListener('close', $closer); $body->close(); throw new \RuntimeException('Cancelled buffering request body'); }); } } <?php namespace _PHPStan_7d8742a37\React\Http\Middleware; use _PHPStan_7d8742a37\Psr\Http\Message\ServerRequestInterface; use _PHPStan_7d8742a37\React\Http\Io\MultipartParser; final class RequestBodyParserMiddleware { private $multipart; /** * @param int|string|null $uploadMaxFilesize * @param int|null $maxFileUploads */ public function __construct($uploadMaxFilesize = null, $maxFileUploads = null) { $this->multipart = new MultipartParser($uploadMaxFilesize, $maxFileUploads); } public function __invoke(ServerRequestInterface $request, $next) { $type = \strtolower($request->getHeaderLine('Content-Type')); list($type) = \explode(';', $type); if ($type === 'application/x-www-form-urlencoded') { return $next($this->parseFormUrlencoded($request)); } if ($type === 'multipart/form-data') { return $next($this->multipart->parse($request)); } return $next($request); } private function parseFormUrlencoded(ServerRequestInterface $request) { // parse string into array structure // ignore warnings due to excessive data structures (max_input_vars and max_input_nesting_level) $ret = array(); @\parse_str((string) $request->getBody(), $ret); return $request->withParsedBody($ret); } } <?php namespace _PHPStan_7d8742a37\React\Http\Middleware; use _PHPStan_7d8742a37\Psr\Http\Message\ResponseInterface; use _PHPStan_7d8742a37\Psr\Http\Message\ServerRequestInterface; use _PHPStan_7d8742a37\React\Http\Io\HttpBodyStream; use _PHPStan_7d8742a37\React\Http\Io\PauseBufferStream; use _PHPStan_7d8742a37\React\Promise; use _PHPStan_7d8742a37\React\Promise\PromiseInterface; use _PHPStan_7d8742a37\React\Promise\Deferred; use _PHPStan_7d8742a37\React\Stream\ReadableStreamInterface; /** * Limits how many next handlers can be executed concurrently. * * If this middleware is invoked, it will check if the number of pending * handlers is below the allowed limit and then simply invoke the next handler * and it will return whatever the next handler returns (or throws). * * If the number of pending handlers exceeds the allowed limit, the request will * be queued (and its streaming body will be paused) and it will return a pending * promise. * Once a pending handler returns (or throws), it will pick the oldest request * from this queue and invokes the next handler (and its streaming body will be * resumed). * * The following example shows how this middleware can be used to ensure no more * than 10 handlers will be invoked at once: * * ```php * $http = new React\Http\HttpServer( * new React\Http\Middleware\StreamingRequestMiddleware(), * new React\Http\Middleware\LimitConcurrentRequestsMiddleware(10), * $handler * ); * ``` * * Similarly, this middleware is often used in combination with the * [`RequestBodyBufferMiddleware`](#requestbodybuffermiddleware) (see below) * to limit the total number of requests that can be buffered at once: * * ```php * $http = new React\Http\HttpServer( * new React\Http\Middleware\StreamingRequestMiddleware(), * new React\Http\Middleware\LimitConcurrentRequestsMiddleware(100), // 100 concurrent buffering handlers * new React\Http\Middleware\RequestBodyBufferMiddleware(2 * 1024 * 1024), // 2 MiB per request * new React\Http\Middleware\RequestBodyParserMiddleware(), * $handler * ); * ``` * * More sophisticated examples include limiting the total number of requests * that can be buffered at once and then ensure the actual request handler only * processes one request after another without any concurrency: * * ```php * $http = new React\Http\HttpServer( * new React\Http\Middleware\StreamingRequestMiddleware(), * new React\Http\Middleware\LimitConcurrentRequestsMiddleware(100), // 100 concurrent buffering handlers * new React\Http\Middleware\RequestBodyBufferMiddleware(2 * 1024 * 1024), // 2 MiB per request * new React\Http\Middleware\RequestBodyParserMiddleware(), * new React\Http\Middleware\LimitConcurrentRequestsMiddleware(1), // only execute 1 handler (no concurrency) * $handler * ); * ``` * * @see RequestBodyBufferMiddleware */ final class LimitConcurrentRequestsMiddleware { private $limit; private $pending = 0; private $queue = array(); /** * @param int $limit Maximum amount of concurrent requests handled. * * For example when $limit is set to 10, 10 requests will flow to $next * while more incoming requests have to wait until one is done. */ public function __construct($limit) { $this->limit = $limit; } public function __invoke(ServerRequestInterface $request, $next) { // happy path: simply invoke next request handler if we're below limit if ($this->pending < $this->limit) { ++$this->pending; try { $response = $next($request); } catch (\Exception $e) { $this->processQueue(); throw $e; } catch (\Throwable $e) { // @codeCoverageIgnoreStart // handle Errors just like Exceptions (PHP 7+ only) $this->processQueue(); throw $e; // @codeCoverageIgnoreEnd } // happy path: if next request handler returned immediately, // we can simply try to invoke the next queued request if ($response instanceof ResponseInterface) { $this->processQueue(); return $response; } // if the next handler returns a pending promise, we have to // await its resolution before invoking next queued request return $this->await(Promise\resolve($response)); } // if we reach this point, then this request will need to be queued // check if the body is streaming, in which case we need to buffer everything $body = $request->getBody(); if ($body instanceof ReadableStreamInterface) { // pause actual body to stop emitting data until the handler is called $size = $body->getSize(); $body = new PauseBufferStream($body); $body->pauseImplicit(); // replace with buffering body to ensure any readable events will be buffered $request = $request->withBody(new HttpBodyStream($body, $size)); } // get next queue position $queue =& $this->queue; $queue[] = null; \end($queue); $id = \key($queue); $deferred = new Deferred(function ($_, $reject) use(&$queue, $id) { // queued promise cancelled before its next handler is invoked // remove from queue and reject explicitly unset($queue[$id]); $reject(new \RuntimeException('Cancelled queued next handler')); }); // queue request and process queue if pending does not exceed limit $queue[$id] = $deferred; $pending =& $this->pending; $that = $this; return $deferred->promise()->then(function () use($request, $next, $body, &$pending, $that) { // invoke next request handler ++$pending; try { $response = $next($request); } catch (\Exception $e) { $that->processQueue(); throw $e; } catch (\Throwable $e) { // @codeCoverageIgnoreStart // handle Errors just like Exceptions (PHP 7+ only) $that->processQueue(); throw $e; // @codeCoverageIgnoreEnd } // resume readable stream and replay buffered events if ($body instanceof PauseBufferStream) { $body->resumeImplicit(); } // if the next handler returns a pending promise, we have to // await its resolution before invoking next queued request return $that->await(Promise\resolve($response)); }); } /** * @internal * @param PromiseInterface $promise * @return PromiseInterface */ public function await(PromiseInterface $promise) { $that = $this; return $promise->then(function ($response) use($that) { $that->processQueue(); return $response; }, function ($error) use($that) { $that->processQueue(); return Promise\reject($error); }); } /** * @internal */ public function processQueue() { // skip if we're still above concurrency limit or there's no queued request waiting if (--$this->pending >= $this->limit || !$this->queue) { return; } $first = \reset($this->queue); unset($this->queue[\key($this->queue)]); $first->resolve(null); } } <?php namespace _PHPStan_7d8742a37\React\Http\Middleware; use _PHPStan_7d8742a37\Psr\Http\Message\ServerRequestInterface; /** * Process incoming requests with a streaming request body (without buffering). * * This allows you to process requests of any size without buffering the request * body in memory. Instead, it will represent the request body as a * [`ReadableStreamInterface`](https://github.com/reactphp/stream#readablestreaminterface) * that emit chunks of incoming data as it is received: * * ```php * $http = new React\Http\HttpServer( * new React\Http\Middleware\StreamingRequestMiddleware(), * function (Psr\Http\Message\ServerRequestInterface $request) { * $body = $request->getBody(); * assert($body instanceof Psr\Http\Message\StreamInterface); * assert($body instanceof React\Stream\ReadableStreamInterface); * * return new React\Promise\Promise(function ($resolve) use ($body) { * $bytes = 0; * $body->on('data', function ($chunk) use (&$bytes) { * $bytes += \count($chunk); * }); * $body->on('close', function () use (&$bytes, $resolve) { * $resolve(new React\Http\Response( * 200, * [], * "Received $bytes bytes\n" * )); * }); * }); * } * ); * ``` * * See also [streaming incoming request](../../README.md#streaming-incoming-request) * for more details. * * Additionally, this middleware can be used in combination with the * [`LimitConcurrentRequestsMiddleware`](#limitconcurrentrequestsmiddleware) and * [`RequestBodyBufferMiddleware`](#requestbodybuffermiddleware) (see below) * to explicitly configure the total number of requests that can be handled at * once: * * ```php * $http = new React\Http\HttpServer( * new React\Http\Middleware\StreamingRequestMiddleware(), * new React\Http\Middleware\LimitConcurrentRequestsMiddleware(100), // 100 concurrent buffering handlers * new React\Http\Middleware\RequestBodyBufferMiddleware(2 * 1024 * 1024), // 2 MiB per request * new React\Http\Middleware\RequestBodyParserMiddleware(), * $handler * ); * ``` * * > Internally, this class is used as a "marker" to not trigger the default * request buffering behavior in the `HttpServer`. It does not implement any logic * on its own. */ final class StreamingRequestMiddleware { public function __invoke(ServerRequestInterface $request, $next) { return $next($request); } } This file was automatically generated by Composer Patches (https://github.com/cweagans/composer-patches) Patches applied to this directory: 0 Source: patches/Sender.patch Copyright (c) 2012 Christian Lück, Cees-Jan Kiewiet, Jan Sorgalla, Chris Boden, Igor Wiedler Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. <?php namespace _PHPStan_7d8742a37\React\Async; // @codeCoverageIgnoreStart if (!\function_exists(__NAMESPACE__ . '\\parallel')) { require __DIR__ . '/functions.php'; } // @codeCoverageIgnoreEnd <?php namespace _PHPStan_7d8742a37\React\Async; use _PHPStan_7d8742a37\React\EventLoop\Loop; use _PHPStan_7d8742a37\React\Promise\Deferred; use _PHPStan_7d8742a37\React\Promise\Promise; use _PHPStan_7d8742a37\React\Promise\PromiseInterface; use function _PHPStan_7d8742a37\React\Promise\reject; use function _PHPStan_7d8742a37\React\Promise\resolve; /** * Block waiting for the given `$promise` to be fulfilled. * * ```php * $result = React\Async\await($promise, $loop); * ``` * * This function will only return after the given `$promise` has settled, i.e. * either fulfilled or rejected. * * While the promise is pending, this function will assume control over the event * loop. Internally, it will `run()` the [default loop](https://github.com/reactphp/event-loop#loop) * until the promise settles and then calls `stop()` to terminate execution of the * loop. This means this function is more suited for short-lived promise executions * when using promise-based APIs is not feasible. For long-running applications, * using promise-based APIs by leveraging chained `then()` calls is usually preferable. * * Once the promise is fulfilled, this function will return whatever the promise * resolved to. * * Once the promise is rejected, this will throw whatever the promise rejected * with. If the promise did not reject with an `Exception` or `Throwable`, then * this function will throw an `UnexpectedValueException` instead. * * ```php * try { * $result = React\Async\await($promise, $loop); * // promise successfully fulfilled with $result * echo 'Result: ' . $result; * } catch (Throwable $e) { * // promise rejected with $e * echo 'Error: ' . $e->getMessage(); * } * ``` * * @template T * @param PromiseInterface<T> $promise * @return T returns whatever the promise resolves to * @throws \Exception when the promise is rejected with an `Exception` * @throws \Throwable when the promise is rejected with a `Throwable` * @throws \UnexpectedValueException when the promise is rejected with an unexpected value (Promise API v1 or v2 only) */ function await(PromiseInterface $promise) { $wait = \true; $resolved = null; $exception = null; $rejected = \false; /** @var bool $loopStarted */ $loopStarted = \false; $promise->then(function ($c) use(&$resolved, &$wait, &$loopStarted) { $resolved = $c; $wait = \false; if ($loopStarted) { Loop::stop(); } }, function ($error) use(&$exception, &$rejected, &$wait, &$loopStarted) { $exception = $error; $rejected = \true; $wait = \false; if ($loopStarted) { Loop::stop(); } }); // Explicitly overwrite argument with null value. This ensure that this // argument does not show up in the stack trace in PHP 7+ only. $promise = null; while ($wait) { $loopStarted = \true; Loop::run(); } if ($rejected) { // promise is rejected with an unexpected value (Promise API v1 or v2 only) if (!$exception instanceof \Throwable) { $exception = new \UnexpectedValueException('Promise rejected with unexpected value of type ' . (\is_object($exception) ? \get_class($exception) : \gettype($exception))); } throw $exception; } /** @var T $resolved */ return $resolved; } /** * Delay program execution for duration given in `$seconds`. * * ```php * React\Async\delay($seconds); * ``` * * This function will only return after the given number of `$seconds` have * elapsed. If there are no other events attached to this loop, it will behave * similar to PHP's [`sleep()` function](https://www.php.net/manual/en/function.sleep.php). * * ```php * echo 'a'; * React\Async\delay(1.0); * echo 'b'; * * // prints "a" at t=0.0s * // prints "b" at t=1.0s * ``` * * Unlike PHP's [`sleep()` function](https://www.php.net/manual/en/function.sleep.php), * this function may not necessarily halt execution of the entire process thread. * Instead, it allows the event loop to run any other events attached to the * same loop until the delay returns: * * ```php * echo 'a'; * Loop::addTimer(1.0, function () { * echo 'b'; * }); * React\Async\delay(3.0); * echo 'c'; * * // prints "a" at t=0.0s * // prints "b" at t=1.0s * // prints "c" at t=3.0s * ``` * * This behavior is especially useful if you want to delay the program execution * of a particular routine, such as when building a simple polling or retry * mechanism: * * ```php * try { * something(); * } catch (Throwable $e) { * // in case of error, retry after a short delay * React\Async\delay(1.0); * something(); * } * ``` * * Because this function only returns after some time has passed, it can be * considered *blocking* from the perspective of the calling code. While the * delay is running, this function will assume control over the event loop. * Internally, it will `run()` the [default loop](https://github.com/reactphp/event-loop#loop) * until the delay returns and then calls `stop()` to terminate execution of the * loop. This means this function is more suited for short-lived promise executions * when using promise-based APIs is not feasible. For long-running applications, * using promise-based APIs by leveraging chained `then()` calls is usually preferable. * * Internally, the `$seconds` argument will be used as a timer for the loop so that * it keeps running until this timer triggers. This implies that if you pass a * really small (or negative) value, it will still start a timer and will thus * trigger at the earliest possible time in the future. * * @param float $seconds * @return void * @uses await() */ function delay(float $seconds) : void { await(new Promise(function (callable $resolve) use($seconds) : void { Loop::addTimer($seconds, function () use($resolve) : void { $resolve(null); }); })); } /** * Execute a Generator-based coroutine to "await" promises. * * ```php * React\Async\coroutine(function () { * $browser = new React\Http\Browser(); * * try { * $response = yield $browser->get('https://example.com/'); * assert($response instanceof Psr\Http\Message\ResponseInterface); * echo $response->getBody(); * } catch (Exception $e) { * echo 'Error: ' . $e->getMessage() . PHP_EOL; * } * }); * ``` * * Using Generator-based coroutines is an alternative to directly using the * underlying promise APIs. For many use cases, this makes using promise-based * APIs much simpler, as it resembles a synchronous code flow more closely. * The above example performs the equivalent of directly using the promise APIs: * * ```php * $browser = new React\Http\Browser(); * * $browser->get('https://example.com/')->then(function (Psr\Http\Message\ResponseInterface $response) { * echo $response->getBody(); * }, function (Exception $e) { * echo 'Error: ' . $e->getMessage() . PHP_EOL; * }); * ``` * * The `yield` keyword can be used to "await" a promise resolution. Internally, * it will turn the entire given `$function` into a [`Generator`](https://www.php.net/manual/en/class.generator.php). * This allows the execution to be interrupted and resumed at the same place * when the promise is fulfilled. The `yield` statement returns whatever the * promise is fulfilled with. If the promise is rejected, it will throw an * `Exception` or `Throwable`. * * The `coroutine()` function will always return a Proimise which will be * fulfilled with whatever your `$function` returns. Likewise, it will return * a promise that will be rejected if you throw an `Exception` or `Throwable` * from your `$function`. This allows you easily create Promise-based functions: * * ```php * $promise = React\Async\coroutine(function () { * $browser = new React\Http\Browser(); * $urls = [ * 'https://example.com/alice', * 'https://example.com/bob' * ]; * * $bytes = 0; * foreach ($urls as $url) { * $response = yield $browser->get($url); * assert($response instanceof Psr\Http\Message\ResponseInterface); * $bytes += $response->getBody()->getSize(); * } * return $bytes; * }); * * $promise->then(function (int $bytes) { * echo 'Total size: ' . $bytes . PHP_EOL; * }, function (Exception $e) { * echo 'Error: ' . $e->getMessage() . PHP_EOL; * }); * ``` * * The previous example uses a `yield` statement inside a loop to highlight how * this vastly simplifies consuming asynchronous operations. At the same time, * this naive example does not leverage concurrent execution, as it will * essentially "await" between each operation. In order to take advantage of * concurrent execution within the given `$function`, you can "await" multiple * promises by using a single `yield` together with Promise-based primitives * like this: * * ```php * $promise = React\Async\coroutine(function () { * $browser = new React\Http\Browser(); * $urls = [ * 'https://example.com/alice', * 'https://example.com/bob' * ]; * * $promises = []; * foreach ($urls as $url) { * $promises[] = $browser->get($url); * } * * try { * $responses = yield React\Promise\all($promises); * } catch (Exception $e) { * foreach ($promises as $promise) { * $promise->cancel(); * } * throw $e; * } * * $bytes = 0; * foreach ($responses as $response) { * assert($response instanceof Psr\Http\Message\ResponseInterface); * $bytes += $response->getBody()->getSize(); * } * return $bytes; * }); * * $promise->then(function (int $bytes) { * echo 'Total size: ' . $bytes . PHP_EOL; * }, function (Exception $e) { * echo 'Error: ' . $e->getMessage() . PHP_EOL; * }); * ``` * * @template T * @template TYield * @template A1 (any number of function arguments, see https://github.com/phpstan/phpstan/issues/8214) * @template A2 * @template A3 * @template A4 * @template A5 * @param callable(A1, A2, A3, A4, A5):(\Generator<mixed, PromiseInterface<TYield>, TYield, PromiseInterface<T>|T>|PromiseInterface<T>|T) $function * @param mixed ...$args Optional list of additional arguments that will be passed to the given `$function` as is * @return PromiseInterface<T> * @since 3.0.0 */ function coroutine(callable $function, ...$args) : PromiseInterface { try { $generator = $function(...$args); } catch (\Throwable $e) { return reject($e); } if (!$generator instanceof \Generator) { return resolve($generator); } $promise = null; $deferred = new Deferred(function () use(&$promise) { /** @var ?PromiseInterface<T> $promise */ if ($promise instanceof PromiseInterface && \method_exists($promise, 'cancel')) { $promise->cancel(); } $promise = null; }); /** @var callable $next */ $next = function () use($deferred, $generator, &$next, &$promise) { try { if (!$generator->valid()) { $next = null; $deferred->resolve($generator->getReturn()); return; } } catch (\Throwable $e) { $next = null; $deferred->reject($e); return; } $promise = $generator->current(); if (!$promise instanceof PromiseInterface) { $next = null; $deferred->reject(new \UnexpectedValueException('Expected coroutine to yield ' . PromiseInterface::class . ', but got ' . (\is_object($promise) ? \get_class($promise) : \gettype($promise)))); return; } /** @var PromiseInterface<TYield> $promise */ \assert($next instanceof \Closure); $promise->then(function ($value) use($generator, $next) { $generator->send($value); $next(); }, function (\Throwable $reason) use($generator, $next) { $generator->throw($reason); $next(); })->then(null, function (\Throwable $reason) use($deferred, &$next) { $next = null; $deferred->reject($reason); }); }; $next(); return $deferred->promise(); } /** * @template T * @param iterable<callable():(PromiseInterface<T>|T)> $tasks * @return PromiseInterface<array<T>> */ function parallel(iterable $tasks) : PromiseInterface { /** @var array<int,PromiseInterface<T>> $pending */ $pending = []; $deferred = new Deferred(function () use(&$pending) { foreach ($pending as $promise) { if ($promise instanceof PromiseInterface && \method_exists($promise, 'cancel')) { $promise->cancel(); } } $pending = []; }); $results = []; $continue = \true; $taskErrback = function ($error) use(&$pending, $deferred, &$continue) { $continue = \false; $deferred->reject($error); foreach ($pending as $promise) { if ($promise instanceof PromiseInterface && \method_exists($promise, 'cancel')) { $promise->cancel(); } } $pending = []; }; foreach ($tasks as $i => $task) { $taskCallback = function ($result) use(&$results, &$pending, &$continue, $i, $deferred) { $results[$i] = $result; unset($pending[$i]); if (!$pending && !$continue) { $deferred->resolve($results); } }; $promise = \call_user_func($task); \assert($promise instanceof PromiseInterface); $pending[$i] = $promise; $promise->then($taskCallback, $taskErrback); if (!$continue) { break; } } $continue = \false; if (!$pending) { $deferred->resolve($results); } return $deferred->promise(); } /** * @template T * @param iterable<callable():(PromiseInterface<T>|T)> $tasks * @return PromiseInterface<array<T>> */ function series(iterable $tasks) : PromiseInterface { $pending = null; $deferred = new Deferred(function () use(&$pending) { /** @var ?PromiseInterface<T> $pending */ if ($pending instanceof PromiseInterface && \method_exists($pending, 'cancel')) { $pending->cancel(); } $pending = null; }); $results = []; if ($tasks instanceof \IteratorAggregate) { $tasks = $tasks->getIterator(); \assert($tasks instanceof \Iterator); } $taskCallback = function ($result) use(&$results, &$next) { $results[] = $result; /** @var \Closure $next */ $next(); }; $next = function () use(&$tasks, $taskCallback, $deferred, &$results, &$pending) { if ($tasks instanceof \Iterator ? !$tasks->valid() : !$tasks) { $deferred->resolve($results); return; } if ($tasks instanceof \Iterator) { $task = $tasks->current(); $tasks->next(); } else { \assert(\is_array($tasks)); $task = \array_shift($tasks); } \assert(\is_callable($task)); $promise = \call_user_func($task); \assert($promise instanceof PromiseInterface); $pending = $promise; $promise->then($taskCallback, array($deferred, 'reject')); }; $next(); return $deferred->promise(); } /** * @template T * @param iterable<(callable():(PromiseInterface<T>|T))|(callable(mixed):(PromiseInterface<T>|T))> $tasks * @return PromiseInterface<($tasks is non-empty-array|\Traversable ? T : null)> */ function waterfall(iterable $tasks) : PromiseInterface { $pending = null; $deferred = new Deferred(function () use(&$pending) { /** @var ?PromiseInterface<T> $pending */ if ($pending instanceof PromiseInterface && \method_exists($pending, 'cancel')) { $pending->cancel(); } $pending = null; }); if ($tasks instanceof \IteratorAggregate) { $tasks = $tasks->getIterator(); \assert($tasks instanceof \Iterator); } /** @var callable $next */ $next = function ($value = null) use(&$tasks, &$next, $deferred, &$pending) { if ($tasks instanceof \Iterator ? !$tasks->valid() : !$tasks) { $deferred->resolve($value); return; } if ($tasks instanceof \Iterator) { $task = $tasks->current(); $tasks->next(); } else { \assert(\is_array($tasks)); $task = \array_shift($tasks); } \assert(\is_callable($task)); $promise = \call_user_func_array($task, \func_get_args()); \assert($promise instanceof PromiseInterface); $pending = $promise; $promise->then($next, array($deferred, 'reject')); }; $next(); return $deferred->promise(); } The MIT License (MIT) Copyright (c) 2012 Christian Lück, Cees-Jan Kiewiet, Jan Sorgalla, Chris Boden, Igor Wiedler Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. <?php namespace _PHPStan_7d8742a37\React\Dns\Query; interface ExecutorInterface { /** * Executes a query and will return a response message * * It returns a Promise which either fulfills with a response * `React\Dns\Model\Message` on success or rejects with an `Exception` if * the query is not successful. A response message may indicate an error * condition in its `rcode`, but this is considered a valid response message. * * ```php * $executor->query($query)->then( * function (React\Dns\Model\Message $response) { * // response message successfully received * var_dump($response->rcode, $response->answers); * }, * function (Exception $error) { * // failed to query due to $error * } * ); * ``` * * The returned Promise MUST be implemented in such a way that it can be * cancelled when it is still pending. Cancelling a pending promise MUST * reject its value with an Exception. It SHOULD clean up any underlying * resources and references as applicable. * * ```php * $promise = $executor->query($query); * * $promise->cancel(); * ``` * * @param Query $query * @return \React\Promise\PromiseInterface<\React\Dns\Model\Message> * resolves with response message on success or rejects with an Exception on error */ public function query(Query $query); } <?php namespace _PHPStan_7d8742a37\React\Dns\Query; use _PHPStan_7d8742a37\React\Promise\Promise; /** * Cooperatively resolves hosts via the given base executor to ensure same query is not run concurrently * * Wraps an existing `ExecutorInterface` to keep tracking of pending queries * and only starts a new query when the same query is not already pending. Once * the underlying query is fulfilled/rejected, it will forward its value to all * promises awaiting the same query. * * This means it will not limit concurrency for queries that differ, for example * when sending many queries for different host names or types. * * This is useful because all executors are entirely async and as such allow you * to execute any number of queries concurrently. You should probably limit the * number of concurrent queries in your application or you're very likely going * to face rate limitations and bans on the resolver end. For many common * applications, you may want to avoid sending the same query multiple times * when the first one is still pending, so you will likely want to use this in * combination with some other executor like this: * * ```php * $executor = new CoopExecutor( * new RetryExecutor( * new TimeoutExecutor( * new UdpTransportExecutor($nameserver), * 3.0 * ) * ) * ); * ``` */ final class CoopExecutor implements ExecutorInterface { private $executor; private $pending = array(); private $counts = array(); public function __construct(ExecutorInterface $base) { $this->executor = $base; } public function query(Query $query) { $key = $this->serializeQueryToIdentity($query); if (isset($this->pending[$key])) { // same query is already pending, so use shared reference to pending query $promise = $this->pending[$key]; ++$this->counts[$key]; } else { // no such query pending, so start new query and keep reference until it's fulfilled or rejected $promise = $this->executor->query($query); $this->pending[$key] = $promise; $this->counts[$key] = 1; $pending =& $this->pending; $counts =& $this->counts; $promise->then(function () use($key, &$pending, &$counts) { unset($pending[$key], $counts[$key]); }, function () use($key, &$pending, &$counts) { unset($pending[$key], $counts[$key]); }); } // Return a child promise awaiting the pending query. // Cancelling this child promise should only cancel the pending query // when no other child promise is awaiting the same query. $pending =& $this->pending; $counts =& $this->counts; return new Promise(function ($resolve, $reject) use($promise) { $promise->then($resolve, $reject); }, function () use(&$promise, $key, $query, &$pending, &$counts) { if (--$counts[$key] < 1) { unset($pending[$key], $counts[$key]); $promise->cancel(); $promise = null; } throw new \RuntimeException('DNS query for ' . $query->describe() . ' has been cancelled'); }); } private function serializeQueryToIdentity(Query $query) { return \sprintf('%s:%s:%s', $query->name, $query->type, $query->class); } } <?php namespace _PHPStan_7d8742a37\React\Dns\Query; use _PHPStan_7d8742a37\React\Promise\Deferred; use _PHPStan_7d8742a37\React\Promise\PromiseInterface; final class RetryExecutor implements ExecutorInterface { private $executor; private $retries; public function __construct(ExecutorInterface $executor, $retries = 2) { $this->executor = $executor; $this->retries = $retries; } public function query(Query $query) { return $this->tryQuery($query, $this->retries); } public function tryQuery(Query $query, $retries) { $deferred = new Deferred(function () use(&$promise) { if ($promise instanceof PromiseInterface && \method_exists($promise, 'cancel')) { $promise->cancel(); } }); $success = function ($value) use($deferred, &$errorback) { $errorback = null; $deferred->resolve($value); }; $executor = $this->executor; $errorback = function ($e) use($deferred, &$promise, $query, $success, &$errorback, &$retries, $executor) { if (!$e instanceof TimeoutException) { $errorback = null; $deferred->reject($e); } elseif ($retries <= 0) { $errorback = null; $deferred->reject($e = new \RuntimeException('DNS query for ' . $query->describe() . ' failed: too many retries', 0, $e)); // avoid garbage references by replacing all closures in call stack. // what a lovely piece of code! $r = new \ReflectionProperty('Exception', 'trace'); $r->setAccessible(\true); $trace = $r->getValue($e); // Exception trace arguments are not available on some PHP 7.4 installs // @codeCoverageIgnoreStart foreach ($trace as $ti => $one) { if (isset($one['args'])) { foreach ($one['args'] as $ai => $arg) { if ($arg instanceof \Closure) { $trace[$ti]['args'][$ai] = 'Object(' . \get_class($arg) . ')'; } } } } // @codeCoverageIgnoreEnd $r->setValue($e, $trace); } else { --$retries; $promise = $executor->query($query)->then($success, $errorback); } }; $promise = $this->executor->query($query)->then($success, $errorback); return $deferred->promise(); } } <?php namespace _PHPStan_7d8742a37\React\Dns\Query; use _PHPStan_7d8742a37\React\Dns\Model\Message; /** * This class represents a single question in a query/response message * * It uses a structure similar to `\React\Dns\Message\Record`, but does not * contain fields for resulting TTL and resulting record data (IPs etc.). * * @link https://tools.ietf.org/html/rfc1035#section-4.1.2 * @see \React\Dns\Message\Record */ final class Query { /** * @var string query name, i.e. hostname to look up */ public $name; /** * @var int query type (aka QTYPE), see Message::TYPE_* constants */ public $type; /** * @var int query class (aka QCLASS), see Message::CLASS_IN constant */ public $class; /** * @param string $name query name, i.e. hostname to look up * @param int $type query type, see Message::TYPE_* constants * @param int $class query class, see Message::CLASS_IN constant */ public function __construct($name, $type, $class) { $this->name = $name; $this->type = $type; $this->class = $class; } /** * Describes the hostname and query type/class for this query * * The output format is supposed to be human readable and is subject to change. * The format is inspired by RFC 3597 when handling unkown types/classes. * * @return string "example.com (A)" or "example.com (CLASS0 TYPE1234)" * @link https://tools.ietf.org/html/rfc3597 */ public function describe() { $class = $this->class !== Message::CLASS_IN ? 'CLASS' . $this->class . ' ' : ''; $type = 'TYPE' . $this->type; $ref = new \ReflectionClass('_PHPStan_7d8742a37\\React\\Dns\\Model\\Message'); foreach ($ref->getConstants() as $name => $value) { if ($value === $this->type && \strpos($name, 'TYPE_') === 0) { $type = \substr($name, 5); break; } } return $this->name . ' (' . $class . $type . ')'; } } <?php namespace _PHPStan_7d8742a37\React\Dns\Query; final class CancellationException extends \RuntimeException { } <?php namespace _PHPStan_7d8742a37\React\Dns\Query; use _PHPStan_7d8742a37\React\Promise\Promise; /** * Send DNS queries over a UDP or TCP/IP stream transport. * * This class will automatically choose the correct transport protocol to send * a DNS query to your DNS server. It will always try to send it over the more * efficient UDP transport first. If this query yields a size related issue * (truncated messages), it will retry over a streaming TCP/IP transport. * * For more advanced usages one can utilize this class directly. * The following example looks up the `IPv6` address for `reactphp.org`. * * ```php * $executor = new SelectiveTransportExecutor($udpExecutor, $tcpExecutor); * * $executor->query( * new Query($name, Message::TYPE_AAAA, Message::CLASS_IN) * )->then(function (Message $message) { * foreach ($message->answers as $answer) { * echo 'IPv6: ' . $answer->data . PHP_EOL; * } * }, 'printf'); * ``` * * Note that this executor only implements the logic to select the correct * transport for the given DNS query. Implementing the correct transport logic, * implementing timeouts and any retry logic is left up to the given executors, * see also [`UdpTransportExecutor`](#udptransportexecutor) and * [`TcpTransportExecutor`](#tcptransportexecutor) for more details. * * Note that this executor is entirely async and as such allows you to execute * any number of queries concurrently. You should probably limit the number of * concurrent queries in your application or you're very likely going to face * rate limitations and bans on the resolver end. For many common applications, * you may want to avoid sending the same query multiple times when the first * one is still pending, so you will likely want to use this in combination with * a `CoopExecutor` like this: * * ```php * $executor = new CoopExecutor( * new SelectiveTransportExecutor( * $datagramExecutor, * $streamExecutor * ) * ); * ``` */ class SelectiveTransportExecutor implements ExecutorInterface { private $datagramExecutor; private $streamExecutor; public function __construct(ExecutorInterface $datagramExecutor, ExecutorInterface $streamExecutor) { $this->datagramExecutor = $datagramExecutor; $this->streamExecutor = $streamExecutor; } public function query(Query $query) { $stream = $this->streamExecutor; $pending = $this->datagramExecutor->query($query); return new Promise(function ($resolve, $reject) use(&$pending, $stream, $query) { $pending->then($resolve, function ($e) use(&$pending, $stream, $query, $resolve, $reject) { if ($e->getCode() === (\defined('SOCKET_EMSGSIZE') ? \SOCKET_EMSGSIZE : 90)) { $pending = $stream->query($query)->then($resolve, $reject); } else { $reject($e); } }); }, function () use(&$pending) { $pending->cancel(); $pending = null; }); } } <?php namespace _PHPStan_7d8742a37\React\Dns\Query; use _PHPStan_7d8742a37\React\Dns\Model\Message; use _PHPStan_7d8742a37\React\Dns\Protocol\BinaryDumper; use _PHPStan_7d8742a37\React\Dns\Protocol\Parser; use _PHPStan_7d8742a37\React\EventLoop\Loop; use _PHPStan_7d8742a37\React\EventLoop\LoopInterface; use _PHPStan_7d8742a37\React\Promise\Deferred; /** * Send DNS queries over a TCP/IP stream transport. * * This is one of the main classes that send a DNS query to your DNS server. * * For more advanced usages one can utilize this class directly. * The following example looks up the `IPv6` address for `reactphp.org`. * * ```php * $executor = new TcpTransportExecutor('8.8.8.8:53'); * * $executor->query( * new Query($name, Message::TYPE_AAAA, Message::CLASS_IN) * )->then(function (Message $message) { * foreach ($message->answers as $answer) { * echo 'IPv6: ' . $answer->data . PHP_EOL; * } * }, 'printf'); * ``` * * See also [example #92](examples). * * Note that this executor does not implement a timeout, so you will very likely * want to use this in combination with a `TimeoutExecutor` like this: * * ```php * $executor = new TimeoutExecutor( * new TcpTransportExecutor($nameserver), * 3.0 * ); * ``` * * Unlike the `UdpTransportExecutor`, this class uses a reliable TCP/IP * transport, so you do not necessarily have to implement any retry logic. * * Note that this executor is entirely async and as such allows you to execute * queries concurrently. The first query will establish a TCP/IP socket * connection to the DNS server which will be kept open for a short period. * Additional queries will automatically reuse this existing socket connection * to the DNS server, will pipeline multiple requests over this single * connection and will keep an idle connection open for a short period. The * initial TCP/IP connection overhead may incur a slight delay if you only send * occasional queries – when sending a larger number of concurrent queries over * an existing connection, it becomes increasingly more efficient and avoids * creating many concurrent sockets like the UDP-based executor. You may still * want to limit the number of (concurrent) queries in your application or you * may be facing rate limitations and bans on the resolver end. For many common * applications, you may want to avoid sending the same query multiple times * when the first one is still pending, so you will likely want to use this in * combination with a `CoopExecutor` like this: * * ```php * $executor = new CoopExecutor( * new TimeoutExecutor( * new TcpTransportExecutor($nameserver), * 3.0 * ) * ); * ``` * * > Internally, this class uses PHP's TCP/IP sockets and does not take advantage * of [react/socket](https://github.com/reactphp/socket) purely for * organizational reasons to avoid a cyclic dependency between the two * packages. Higher-level components should take advantage of the Socket * component instead of reimplementing this socket logic from scratch. */ class TcpTransportExecutor implements ExecutorInterface { private $nameserver; private $loop; private $parser; private $dumper; /** * @var ?resource */ private $socket; /** * @var Deferred[] */ private $pending = array(); /** * @var string[] */ private $names = array(); /** * Maximum idle time when socket is current unused (i.e. no pending queries outstanding) * * If a new query is to be sent during the idle period, we can reuse the * existing socket without having to wait for a new socket connection. * This uses a rather small, hard-coded value to not keep any unneeded * sockets open and to not keep the loop busy longer than needed. * * A future implementation may take advantage of `edns-tcp-keepalive` to keep * the socket open for longer periods. This will likely require explicit * configuration because this may consume additional resources and also keep * the loop busy for longer than expected in some applications. * * @var float * @link https://tools.ietf.org/html/rfc7766#section-6.2.1 * @link https://tools.ietf.org/html/rfc7828 */ private $idlePeriod = 0.001; /** * @var ?\React\EventLoop\TimerInterface */ private $idleTimer; private $writeBuffer = ''; private $writePending = \false; private $readBuffer = ''; private $readPending = \false; /** @var string */ private $readChunk = 0xffff; /** * @param string $nameserver * @param ?LoopInterface $loop */ public function __construct($nameserver, $loop = null) { if (\strpos($nameserver, '[') === \false && \substr_count($nameserver, ':') >= 2 && \strpos($nameserver, '://') === \false) { // several colons, but not enclosed in square brackets => enclose IPv6 address in square brackets $nameserver = '[' . $nameserver . ']'; } $parts = \parse_url((\strpos($nameserver, '://') === \false ? 'tcp://' : '') . $nameserver); if (!isset($parts['scheme'], $parts['host']) || $parts['scheme'] !== 'tcp' || @\inet_pton(\trim($parts['host'], '[]')) === \false) { throw new \InvalidArgumentException('Invalid nameserver address given'); } if ($loop !== null && !$loop instanceof LoopInterface) { // manual type check to support legacy PHP < 7.1 throw new \InvalidArgumentException('_PHPStan_7d8742a37\\Argument #2 ($loop) expected null|React\\EventLoop\\LoopInterface'); } $this->nameserver = 'tcp://' . $parts['host'] . ':' . (isset($parts['port']) ? $parts['port'] : 53); $this->loop = $loop ?: Loop::get(); $this->parser = new Parser(); $this->dumper = new BinaryDumper(); } public function query(Query $query) { $request = Message::createRequestForQuery($query); // keep shuffing message ID to avoid using the same message ID for two pending queries at the same time while (isset($this->pending[$request->id])) { $request->id = \mt_rand(0, 0xffff); // @codeCoverageIgnore } $queryData = $this->dumper->toBinary($request); $length = \strlen($queryData); if ($length > 0xffff) { return \_PHPStan_7d8742a37\React\Promise\reject(new \RuntimeException('DNS query for ' . $query->describe() . ' failed: Query too large for TCP transport')); } $queryData = \pack('n', $length) . $queryData; if ($this->socket === null) { // create async TCP/IP connection (may take a while) $socket = @\stream_socket_client($this->nameserver, $errno, $errstr, 0, \STREAM_CLIENT_CONNECT | \STREAM_CLIENT_ASYNC_CONNECT); if ($socket === \false) { return \_PHPStan_7d8742a37\React\Promise\reject(new \RuntimeException('DNS query for ' . $query->describe() . ' failed: Unable to connect to DNS server ' . $this->nameserver . ' (' . $errstr . ')', $errno)); } // set socket to non-blocking and wait for it to become writable (connection success/rejected) \stream_set_blocking($socket, \false); if (\function_exists('stream_set_chunk_size')) { \stream_set_chunk_size($socket, $this->readChunk); // @codeCoverageIgnore } $this->socket = $socket; } if ($this->idleTimer !== null) { $this->loop->cancelTimer($this->idleTimer); $this->idleTimer = null; } // wait for socket to become writable to actually write out data $this->writeBuffer .= $queryData; if (!$this->writePending) { $this->writePending = \true; $this->loop->addWriteStream($this->socket, array($this, 'handleWritable')); } $names =& $this->names; $that = $this; $deferred = new Deferred(function () use($that, &$names, $request) { // remove from list of pending names, but remember pending query $name = $names[$request->id]; unset($names[$request->id]); $that->checkIdle(); throw new CancellationException('DNS query for ' . $name . ' has been cancelled'); }); $this->pending[$request->id] = $deferred; $this->names[$request->id] = $query->describe(); return $deferred->promise(); } /** * @internal */ public function handleWritable() { if ($this->readPending === \false) { $name = @\stream_socket_get_name($this->socket, \true); if ($name === \false) { // Connection failed? Check socket error if available for underlying errno/errstr. // @codeCoverageIgnoreStart if (\function_exists('socket_import_stream')) { $socket = \socket_import_stream($this->socket); $errno = \socket_get_option($socket, \SOL_SOCKET, \SO_ERROR); $errstr = \socket_strerror($errno); } else { $errno = \defined('SOCKET_ECONNREFUSED') ? \SOCKET_ECONNREFUSED : 111; $errstr = 'Connection refused'; } // @codeCoverageIgnoreEnd $this->closeError('Unable to connect to DNS server ' . $this->nameserver . ' (' . $errstr . ')', $errno); return; } $this->readPending = \true; $this->loop->addReadStream($this->socket, array($this, 'handleRead')); } $errno = 0; $errstr = ''; \set_error_handler(function ($_, $error) use(&$errno, &$errstr) { // Match errstr from PHP's warning message. // fwrite(): Send of 327712 bytes failed with errno=32 Broken pipe \preg_match('/errno=(\\d+) (.+)/', $error, $m); $errno = isset($m[1]) ? (int) $m[1] : 0; $errstr = isset($m[2]) ? $m[2] : $error; }); $written = \fwrite($this->socket, $this->writeBuffer); \restore_error_handler(); if ($written === \false || $written === 0) { $this->closeError('Unable to send query to DNS server ' . $this->nameserver . ' (' . $errstr . ')', $errno); return; } if (isset($this->writeBuffer[$written])) { $this->writeBuffer = \substr($this->writeBuffer, $written); } else { $this->loop->removeWriteStream($this->socket); $this->writePending = \false; $this->writeBuffer = ''; } } /** * @internal */ public function handleRead() { // read one chunk of data from the DNS server // any error is fatal, this is a stream of TCP/IP data $chunk = @\fread($this->socket, $this->readChunk); if ($chunk === \false || $chunk === '') { $this->closeError('Connection to DNS server ' . $this->nameserver . ' lost'); return; } // reassemble complete message by concatenating all chunks. $this->readBuffer .= $chunk; // response message header contains at least 12 bytes while (isset($this->readBuffer[11])) { // read response message length from first 2 bytes and ensure we have length + data in buffer list(, $length) = \unpack('n', $this->readBuffer); if (!isset($this->readBuffer[$length + 1])) { return; } $data = \substr($this->readBuffer, 2, $length); $this->readBuffer = (string) \substr($this->readBuffer, $length + 2); try { $response = $this->parser->parseMessage($data); } catch (\Exception $e) { // reject all pending queries if we received an invalid message from remote server $this->closeError('Invalid message received from DNS server ' . $this->nameserver); return; } // reject all pending queries if we received an unexpected response ID or truncated response if (!isset($this->pending[$response->id]) || $response->tc) { $this->closeError('Invalid response message received from DNS server ' . $this->nameserver); return; } $deferred = $this->pending[$response->id]; unset($this->pending[$response->id], $this->names[$response->id]); $deferred->resolve($response); $this->checkIdle(); } } /** * @internal * @param string $reason * @param int $code */ public function closeError($reason, $code = 0) { $this->readBuffer = ''; if ($this->readPending) { $this->loop->removeReadStream($this->socket); $this->readPending = \false; } $this->writeBuffer = ''; if ($this->writePending) { $this->loop->removeWriteStream($this->socket); $this->writePending = \false; } if ($this->idleTimer !== null) { $this->loop->cancelTimer($this->idleTimer); $this->idleTimer = null; } @\fclose($this->socket); $this->socket = null; foreach ($this->names as $id => $name) { $this->pending[$id]->reject(new \RuntimeException('DNS query for ' . $name . ' failed: ' . $reason, $code)); } $this->pending = $this->names = array(); } /** * @internal */ public function checkIdle() { if ($this->idleTimer === null && !$this->names) { $that = $this; $this->idleTimer = $this->loop->addTimer($this->idlePeriod, function () use($that) { $that->closeError('Idle timeout'); }); } } } <?php namespace _PHPStan_7d8742a37\React\Dns\Query; use _PHPStan_7d8742a37\React\EventLoop\Loop; use _PHPStan_7d8742a37\React\EventLoop\LoopInterface; use _PHPStan_7d8742a37\React\Promise\Promise; final class TimeoutExecutor implements ExecutorInterface { private $executor; private $loop; private $timeout; /** * @param ExecutorInterface $executor * @param float $timeout * @param ?LoopInterface $loop */ public function __construct(ExecutorInterface $executor, $timeout, $loop = null) { if ($loop !== null && !$loop instanceof LoopInterface) { // manual type check to support legacy PHP < 7.1 throw new \InvalidArgumentException('_PHPStan_7d8742a37\\Argument #3 ($loop) expected null|React\\EventLoop\\LoopInterface'); } $this->executor = $executor; $this->loop = $loop ?: Loop::get(); $this->timeout = $timeout; } public function query(Query $query) { $promise = $this->executor->query($query); $loop = $this->loop; $time = $this->timeout; return new Promise(function ($resolve, $reject) use($loop, $time, $promise, $query) { $timer = null; $promise = $promise->then(function ($v) use(&$timer, $loop, $resolve) { if ($timer) { $loop->cancelTimer($timer); } $timer = \false; $resolve($v); }, function ($v) use(&$timer, $loop, $reject) { if ($timer) { $loop->cancelTimer($timer); } $timer = \false; $reject($v); }); // promise already resolved => no need to start timer if ($timer === \false) { return; } // start timeout timer which will cancel the pending promise $timer = $loop->addTimer($time, function () use($time, &$promise, $reject, $query) { $reject(new TimeoutException('DNS query for ' . $query->describe() . ' timed out')); // Cancel pending query to clean up any underlying resources and references. // Avoid garbage references in call stack by passing pending promise by reference. \assert(\method_exists($promise, 'cancel')); $promise->cancel(); $promise = null; }); }, function () use(&$promise) { // Cancelling this promise will cancel the pending query, thus triggering the rejection logic above. // Avoid garbage references in call stack by passing pending promise by reference. \assert(\method_exists($promise, 'cancel')); $promise->cancel(); $promise = null; }); } } <?php namespace _PHPStan_7d8742a37\React\Dns\Query; final class TimeoutException extends \Exception { } <?php namespace _PHPStan_7d8742a37\React\Dns\Query; use _PHPStan_7d8742a37\React\Dns\Config\HostsFile; use _PHPStan_7d8742a37\React\Dns\Model\Message; use _PHPStan_7d8742a37\React\Dns\Model\Record; use _PHPStan_7d8742a37\React\Promise; /** * Resolves hosts from the given HostsFile or falls back to another executor * * If the host is found in the hosts file, it will not be passed to the actual * DNS executor. If the host is not found in the hosts file, it will be passed * to the DNS executor as a fallback. */ final class HostsFileExecutor implements ExecutorInterface { private $hosts; private $fallback; public function __construct(HostsFile $hosts, ExecutorInterface $fallback) { $this->hosts = $hosts; $this->fallback = $fallback; } public function query(Query $query) { if ($query->class === Message::CLASS_IN && ($query->type === Message::TYPE_A || $query->type === Message::TYPE_AAAA)) { // forward lookup for type A or AAAA $records = array(); $expectsColon = $query->type === Message::TYPE_AAAA; foreach ($this->hosts->getIpsForHost($query->name) as $ip) { // ensure this is an IPv4/IPV6 address according to query type if ((\strpos($ip, ':') !== \false) === $expectsColon) { $records[] = new Record($query->name, $query->type, $query->class, 0, $ip); } } if ($records) { return Promise\resolve(Message::createResponseWithAnswersForQuery($query, $records)); } } elseif ($query->class === Message::CLASS_IN && $query->type === Message::TYPE_PTR) { // reverse lookup: extract IPv4 or IPv6 from special `.arpa` domain $ip = $this->getIpFromHost($query->name); if ($ip !== null) { $records = array(); foreach ($this->hosts->getHostsForIp($ip) as $host) { $records[] = new Record($query->name, $query->type, $query->class, 0, $host); } if ($records) { return Promise\resolve(Message::createResponseWithAnswersForQuery($query, $records)); } } } return $this->fallback->query($query); } private function getIpFromHost($host) { if (\substr($host, -13) === '.in-addr.arpa') { // IPv4: read as IP and reverse bytes $ip = @\inet_pton(\substr($host, 0, -13)); if ($ip === \false || isset($ip[4])) { return null; } return \inet_ntop(\strrev($ip)); } elseif (\substr($host, -9) === '.ip6.arpa') { // IPv6: replace dots, reverse nibbles and interpret as hexadecimal string $ip = @\inet_ntop(\pack('H*', \strrev(\str_replace('.', '', \substr($host, 0, -9))))); if ($ip === \false) { return null; } return $ip; } else { return null; } } } <?php namespace _PHPStan_7d8742a37\React\Dns\Query; use _PHPStan_7d8742a37\React\Cache\CacheInterface; use _PHPStan_7d8742a37\React\Dns\Model\Message; use _PHPStan_7d8742a37\React\Promise\Promise; final class CachingExecutor implements ExecutorInterface { /** * Default TTL for negative responses (NXDOMAIN etc.). * * @internal */ const TTL = 60; private $executor; private $cache; public function __construct(ExecutorInterface $executor, CacheInterface $cache) { $this->executor = $executor; $this->cache = $cache; } public function query(Query $query) { $id = $query->name . ':' . $query->type . ':' . $query->class; $cache = $this->cache; $that = $this; $executor = $this->executor; $pending = $cache->get($id); return new Promise(function ($resolve, $reject) use($query, $id, $cache, $executor, &$pending, $that) { $pending->then(function ($message) use($query, $id, $cache, $executor, &$pending, $that) { // return cached response message on cache hit if ($message !== null) { return $message; } // perform DNS lookup if not already cached return $pending = $executor->query($query)->then(function (Message $message) use($cache, $id, $that) { // DNS response message received => store in cache when not truncated and return if (!$message->tc) { $cache->set($id, $message, $that->ttl($message)); } return $message; }); })->then($resolve, function ($e) use($reject, &$pending) { $reject($e); $pending = null; }); }, function ($_, $reject) use(&$pending, $query) { $reject(new \RuntimeException('DNS query for ' . $query->describe() . ' has been cancelled')); $pending->cancel(); $pending = null; }); } /** * @param Message $message * @return int * @internal */ public function ttl(Message $message) { // select TTL from answers (should all be the same), use smallest value if available // @link https://tools.ietf.org/html/rfc2181#section-5.2 $ttl = null; foreach ($message->answers as $answer) { if ($ttl === null || $answer->ttl < $ttl) { $ttl = $answer->ttl; } } if ($ttl === null) { $ttl = self::TTL; } return $ttl; } } <?php namespace _PHPStan_7d8742a37\React\Dns\Query; use _PHPStan_7d8742a37\React\Dns\Model\Message; use _PHPStan_7d8742a37\React\Dns\Protocol\BinaryDumper; use _PHPStan_7d8742a37\React\Dns\Protocol\Parser; use _PHPStan_7d8742a37\React\EventLoop\Loop; use _PHPStan_7d8742a37\React\EventLoop\LoopInterface; use _PHPStan_7d8742a37\React\Promise\Deferred; /** * Send DNS queries over a UDP transport. * * This is the main class that sends a DNS query to your DNS server and is used * internally by the `Resolver` for the actual message transport. * * For more advanced usages one can utilize this class directly. * The following example looks up the `IPv6` address for `igor.io`. * * ```php * $executor = new UdpTransportExecutor('8.8.8.8:53'); * * $executor->query( * new Query($name, Message::TYPE_AAAA, Message::CLASS_IN) * )->then(function (Message $message) { * foreach ($message->answers as $answer) { * echo 'IPv6: ' . $answer->data . PHP_EOL; * } * }, 'printf'); * ``` * * See also the [fourth example](examples). * * Note that this executor does not implement a timeout, so you will very likely * want to use this in combination with a `TimeoutExecutor` like this: * * ```php * $executor = new TimeoutExecutor( * new UdpTransportExecutor($nameserver), * 3.0 * ); * ``` * * Also note that this executor uses an unreliable UDP transport and that it * does not implement any retry logic, so you will likely want to use this in * combination with a `RetryExecutor` like this: * * ```php * $executor = new RetryExecutor( * new TimeoutExecutor( * new UdpTransportExecutor($nameserver), * 3.0 * ) * ); * ``` * * Note that this executor is entirely async and as such allows you to execute * any number of queries concurrently. You should probably limit the number of * concurrent queries in your application or you're very likely going to face * rate limitations and bans on the resolver end. For many common applications, * you may want to avoid sending the same query multiple times when the first * one is still pending, so you will likely want to use this in combination with * a `CoopExecutor` like this: * * ```php * $executor = new CoopExecutor( * new RetryExecutor( * new TimeoutExecutor( * new UdpTransportExecutor($nameserver), * 3.0 * ) * ) * ); * ``` * * > Internally, this class uses PHP's UDP sockets and does not take advantage * of [react/datagram](https://github.com/reactphp/datagram) purely for * organizational reasons to avoid a cyclic dependency between the two * packages. Higher-level components should take advantage of the Datagram * component instead of reimplementing this socket logic from scratch. */ final class UdpTransportExecutor implements ExecutorInterface { private $nameserver; private $loop; private $parser; private $dumper; /** * maximum UDP packet size to send and receive * * @var int */ private $maxPacketSize = 512; /** * @param string $nameserver * @param ?LoopInterface $loop */ public function __construct($nameserver, $loop = null) { if (\strpos($nameserver, '[') === \false && \substr_count($nameserver, ':') >= 2 && \strpos($nameserver, '://') === \false) { // several colons, but not enclosed in square brackets => enclose IPv6 address in square brackets $nameserver = '[' . $nameserver . ']'; } $parts = \parse_url((\strpos($nameserver, '://') === \false ? 'udp://' : '') . $nameserver); if (!isset($parts['scheme'], $parts['host']) || $parts['scheme'] !== 'udp' || @\inet_pton(\trim($parts['host'], '[]')) === \false) { throw new \InvalidArgumentException('Invalid nameserver address given'); } if ($loop !== null && !$loop instanceof LoopInterface) { // manual type check to support legacy PHP < 7.1 throw new \InvalidArgumentException('_PHPStan_7d8742a37\\Argument #2 ($loop) expected null|React\\EventLoop\\LoopInterface'); } $this->nameserver = 'udp://' . $parts['host'] . ':' . (isset($parts['port']) ? $parts['port'] : 53); $this->loop = $loop ?: Loop::get(); $this->parser = new Parser(); $this->dumper = new BinaryDumper(); } public function query(Query $query) { $request = Message::createRequestForQuery($query); $queryData = $this->dumper->toBinary($request); if (isset($queryData[$this->maxPacketSize])) { return \_PHPStan_7d8742a37\React\Promise\reject(new \RuntimeException('DNS query for ' . $query->describe() . ' failed: Query too large for UDP transport', \defined('SOCKET_EMSGSIZE') ? \SOCKET_EMSGSIZE : 90)); } // UDP connections are instant, so try connection without a loop or timeout $errno = 0; $errstr = ''; $socket = @\stream_socket_client($this->nameserver, $errno, $errstr, 0); if ($socket === \false) { return \_PHPStan_7d8742a37\React\Promise\reject(new \RuntimeException('DNS query for ' . $query->describe() . ' failed: Unable to connect to DNS server ' . $this->nameserver . ' (' . $errstr . ')', $errno)); } // set socket to non-blocking and immediately try to send (fill write buffer) \stream_set_blocking($socket, \false); \set_error_handler(function ($_, $error) use(&$errno, &$errstr) { // Write may potentially fail, but most common errors are already caught by connection check above. // Among others, macOS is known to report here when trying to send to broadcast address. // This can also be reproduced by writing data exceeding `stream_set_chunk_size()` to a server refusing UDP data. // fwrite(): send of 8192 bytes failed with errno=111 Connection refused \preg_match('/errno=(\\d+) (.+)/', $error, $m); $errno = isset($m[1]) ? (int) $m[1] : 0; $errstr = isset($m[2]) ? $m[2] : $error; }); $written = \fwrite($socket, $queryData); \restore_error_handler(); if ($written !== \strlen($queryData)) { return \_PHPStan_7d8742a37\React\Promise\reject(new \RuntimeException('DNS query for ' . $query->describe() . ' failed: Unable to send query to DNS server ' . $this->nameserver . ' (' . $errstr . ')', $errno)); } $loop = $this->loop; $deferred = new Deferred(function () use($loop, $socket, $query) { // cancellation should remove socket from loop and close socket $loop->removeReadStream($socket); \fclose($socket); throw new CancellationException('DNS query for ' . $query->describe() . ' has been cancelled'); }); $max = $this->maxPacketSize; $parser = $this->parser; $nameserver = $this->nameserver; $loop->addReadStream($socket, function ($socket) use($loop, $deferred, $query, $parser, $request, $max, $nameserver) { // try to read a single data packet from the DNS server // ignoring any errors, this is uses UDP packets and not a stream of data $data = @\fread($socket, $max); if ($data === \false) { return; } try { $response = $parser->parseMessage($data); } catch (\Exception $e) { // ignore and await next if we received an invalid message from remote server // this may as well be a fake response from an attacker (possible DOS) return; } // ignore and await next if we received an unexpected response ID // this may as well be a fake response from an attacker (possible cache poisoning) if ($response->id !== $request->id) { return; } // we only react to the first valid message, so remove socket from loop and close $loop->removeReadStream($socket); \fclose($socket); if ($response->tc) { $deferred->reject(new \RuntimeException('DNS query for ' . $query->describe() . ' failed: The DNS server ' . $nameserver . ' returned a truncated result for a UDP query', \defined('SOCKET_EMSGSIZE') ? \SOCKET_EMSGSIZE : 90)); return; } $deferred->resolve($response); }); return $deferred->promise(); } } <?php namespace _PHPStan_7d8742a37\React\Dns\Query; use _PHPStan_7d8742a37\React\Promise\Promise; final class FallbackExecutor implements ExecutorInterface { private $executor; private $fallback; public function __construct(ExecutorInterface $executor, ExecutorInterface $fallback) { $this->executor = $executor; $this->fallback = $fallback; } public function query(Query $query) { $cancelled = \false; $fallback = $this->fallback; $promise = $this->executor->query($query); return new Promise(function ($resolve, $reject) use(&$promise, $fallback, $query, &$cancelled) { $promise->then($resolve, function (\Exception $e1) use($fallback, $query, $resolve, $reject, &$cancelled, &$promise) { // reject if primary resolution rejected due to cancellation if ($cancelled) { $reject($e1); return; } // start fallback query if primary query rejected $promise = $fallback->query($query)->then($resolve, function (\Exception $e2) use($e1, $reject) { $append = $e2->getMessage(); if (($pos = \strpos($append, ':')) !== \false) { $append = \substr($append, $pos + 2); } // reject with combined error message if both queries fail $reject(new \RuntimeException($e1->getMessage() . '. ' . $append)); }); }); }, function () use(&$promise, &$cancelled) { // cancel pending query (primary or fallback) $cancelled = \true; $promise->cancel(); }); } } <?php namespace _PHPStan_7d8742a37\React\Dns; final class RecordNotFoundException extends \Exception { } <?php namespace _PHPStan_7d8742a37\React\Dns\Resolver; use _PHPStan_7d8742a37\React\Dns\Model\Message; use _PHPStan_7d8742a37\React\Dns\Query\ExecutorInterface; use _PHPStan_7d8742a37\React\Dns\Query\Query; use _PHPStan_7d8742a37\React\Dns\RecordNotFoundException; /** * @see ResolverInterface for the base interface */ final class Resolver implements ResolverInterface { private $executor; public function __construct(ExecutorInterface $executor) { $this->executor = $executor; } public function resolve($domain) { return $this->resolveAll($domain, Message::TYPE_A)->then(function (array $ips) { return $ips[\array_rand($ips)]; }); } public function resolveAll($domain, $type) { $query = new Query($domain, $type, Message::CLASS_IN); $that = $this; return $this->executor->query($query)->then(function (Message $response) use($query, $that) { return $that->extractValues($query, $response); }); } /** * [Internal] extract all resource record values from response for this query * * @param Query $query * @param Message $response * @return array * @throws RecordNotFoundException when response indicates an error or contains no data * @internal */ public function extractValues(Query $query, Message $response) { // reject if response code indicates this is an error response message $code = $response->rcode; if ($code !== Message::RCODE_OK) { switch ($code) { case Message::RCODE_FORMAT_ERROR: $message = 'Format Error'; break; case Message::RCODE_SERVER_FAILURE: $message = 'Server Failure'; break; case Message::RCODE_NAME_ERROR: $message = 'Non-Existent Domain / NXDOMAIN'; break; case Message::RCODE_NOT_IMPLEMENTED: $message = 'Not Implemented'; break; case Message::RCODE_REFUSED: $message = 'Refused'; break; default: $message = 'Unknown error response code ' . $code; } throw new RecordNotFoundException('DNS query for ' . $query->describe() . ' returned an error response (' . $message . ')', $code); } $answers = $response->answers; $addresses = $this->valuesByNameAndType($answers, $query->name, $query->type); // reject if we did not receive a valid answer (domain is valid, but no record for this type could be found) if (0 === \count($addresses)) { throw new RecordNotFoundException('DNS query for ' . $query->describe() . ' did not return a valid answer (NOERROR / NODATA)'); } return \array_values($addresses); } /** * @param \React\Dns\Model\Record[] $answers * @param string $name * @param int $type * @return array */ private function valuesByNameAndType(array $answers, $name, $type) { // return all record values for this name and type (if any) $named = $this->filterByName($answers, $name); $records = $this->filterByType($named, $type); if ($records) { return $this->mapRecordData($records); } // no matching records found? check if there are any matching CNAMEs instead $cnameRecords = $this->filterByType($named, Message::TYPE_CNAME); if ($cnameRecords) { $cnames = $this->mapRecordData($cnameRecords); foreach ($cnames as $cname) { $records = \array_merge($records, $this->valuesByNameAndType($answers, $cname, $type)); } } return $records; } private function filterByName(array $answers, $name) { return $this->filterByField($answers, 'name', $name); } private function filterByType(array $answers, $type) { return $this->filterByField($answers, 'type', $type); } private function filterByField(array $answers, $field, $value) { $value = \strtolower($value); return \array_filter($answers, function ($answer) use($field, $value) { return $value === \strtolower($answer->{$field}); }); } private function mapRecordData(array $records) { return \array_map(function ($record) { return $record->data; }, $records); } } <?php namespace _PHPStan_7d8742a37\React\Dns\Resolver; interface ResolverInterface { /** * Resolves the given $domain name to a single IPv4 address (type `A` query). * * ```php * $resolver->resolve('reactphp.org')->then(function ($ip) { * echo 'IP for reactphp.org is ' . $ip . PHP_EOL; * }); * ``` * * This is one of the main methods in this package. It sends a DNS query * for the given $domain name to your DNS server and returns a single IP * address on success. * * If the DNS server sends a DNS response message that contains more than * one IP address for this query, it will randomly pick one of the IP * addresses from the response. If you want the full list of IP addresses * or want to send a different type of query, you should use the * [`resolveAll()`](#resolveall) method instead. * * If the DNS server sends a DNS response message that indicates an error * code, this method will reject with a `RecordNotFoundException`. Its * message and code can be used to check for the response code. * * If the DNS communication fails and the server does not respond with a * valid response message, this message will reject with an `Exception`. * * Pending DNS queries can be cancelled by cancelling its pending promise like so: * * ```php * $promise = $resolver->resolve('reactphp.org'); * * $promise->cancel(); * ``` * * @param string $domain * @return \React\Promise\PromiseInterface<string> * resolves with a single IP address on success or rejects with an Exception on error. */ public function resolve($domain); /** * Resolves all record values for the given $domain name and query $type. * * ```php * $resolver->resolveAll('reactphp.org', Message::TYPE_A)->then(function ($ips) { * echo 'IPv4 addresses for reactphp.org ' . implode(', ', $ips) . PHP_EOL; * }); * * $resolver->resolveAll('reactphp.org', Message::TYPE_AAAA)->then(function ($ips) { * echo 'IPv6 addresses for reactphp.org ' . implode(', ', $ips) . PHP_EOL; * }); * ``` * * This is one of the main methods in this package. It sends a DNS query * for the given $domain name to your DNS server and returns a list with all * record values on success. * * If the DNS server sends a DNS response message that contains one or more * records for this query, it will return a list with all record values * from the response. You can use the `Message::TYPE_*` constants to control * which type of query will be sent. Note that this method always returns a * list of record values, but each record value type depends on the query * type. For example, it returns the IPv4 addresses for type `A` queries, * the IPv6 addresses for type `AAAA` queries, the hostname for type `NS`, * `CNAME` and `PTR` queries and structured data for other queries. See also * the `Record` documentation for more details. * * If the DNS server sends a DNS response message that indicates an error * code, this method will reject with a `RecordNotFoundException`. Its * message and code can be used to check for the response code. * * If the DNS communication fails and the server does not respond with a * valid response message, this message will reject with an `Exception`. * * Pending DNS queries can be cancelled by cancelling its pending promise like so: * * ```php * $promise = $resolver->resolveAll('reactphp.org', Message::TYPE_AAAA); * * $promise->cancel(); * ``` * * @param string $domain * @return \React\Promise\PromiseInterface<array> * Resolves with all record values on success or rejects with an Exception on error. */ public function resolveAll($domain, $type); } <?php namespace _PHPStan_7d8742a37\React\Dns\Resolver; use _PHPStan_7d8742a37\React\Cache\ArrayCache; use _PHPStan_7d8742a37\React\Cache\CacheInterface; use _PHPStan_7d8742a37\React\Dns\Config\Config; use _PHPStan_7d8742a37\React\Dns\Config\HostsFile; use _PHPStan_7d8742a37\React\Dns\Query\CachingExecutor; use _PHPStan_7d8742a37\React\Dns\Query\CoopExecutor; use _PHPStan_7d8742a37\React\Dns\Query\ExecutorInterface; use _PHPStan_7d8742a37\React\Dns\Query\FallbackExecutor; use _PHPStan_7d8742a37\React\Dns\Query\HostsFileExecutor; use _PHPStan_7d8742a37\React\Dns\Query\RetryExecutor; use _PHPStan_7d8742a37\React\Dns\Query\SelectiveTransportExecutor; use _PHPStan_7d8742a37\React\Dns\Query\TcpTransportExecutor; use _PHPStan_7d8742a37\React\Dns\Query\TimeoutExecutor; use _PHPStan_7d8742a37\React\Dns\Query\UdpTransportExecutor; use _PHPStan_7d8742a37\React\EventLoop\Loop; use _PHPStan_7d8742a37\React\EventLoop\LoopInterface; final class Factory { /** * Creates a DNS resolver instance for the given DNS config * * As of v1.7.0 it's recommended to pass a `Config` object instead of a * single nameserver address. If the given config contains more than one DNS * nameserver, all DNS nameservers will be used in order. The primary DNS * server will always be used first before falling back to the secondary or * tertiary DNS server. * * @param Config|string $config DNS Config object (recommended) or single nameserver address * @param ?LoopInterface $loop * @return \React\Dns\Resolver\ResolverInterface * @throws \InvalidArgumentException for invalid DNS server address * @throws \UnderflowException when given DNS Config object has an empty list of nameservers */ public function create($config, $loop = null) { if ($loop !== null && !$loop instanceof LoopInterface) { // manual type check to support legacy PHP < 7.1 throw new \InvalidArgumentException('_PHPStan_7d8742a37\\Argument #2 ($loop) expected null|React\\EventLoop\\LoopInterface'); } $executor = $this->decorateHostsFileExecutor($this->createExecutor($config, $loop ?: Loop::get())); return new Resolver($executor); } /** * Creates a cached DNS resolver instance for the given DNS config and cache * * As of v1.7.0 it's recommended to pass a `Config` object instead of a * single nameserver address. If the given config contains more than one DNS * nameserver, all DNS nameservers will be used in order. The primary DNS * server will always be used first before falling back to the secondary or * tertiary DNS server. * * @param Config|string $config DNS Config object (recommended) or single nameserver address * @param ?LoopInterface $loop * @param ?CacheInterface $cache * @return \React\Dns\Resolver\ResolverInterface * @throws \InvalidArgumentException for invalid DNS server address * @throws \UnderflowException when given DNS Config object has an empty list of nameservers */ public function createCached($config, $loop = null, $cache = null) { if ($loop !== null && !$loop instanceof LoopInterface) { // manual type check to support legacy PHP < 7.1 throw new \InvalidArgumentException('_PHPStan_7d8742a37\\Argument #2 ($loop) expected null|React\\EventLoop\\LoopInterface'); } if ($cache !== null && !$cache instanceof CacheInterface) { // manual type check to support legacy PHP < 7.1 throw new \InvalidArgumentException('_PHPStan_7d8742a37\\Argument #3 ($cache) expected null|React\\Cache\\CacheInterface'); } // default to keeping maximum of 256 responses in cache unless explicitly given if (!$cache instanceof CacheInterface) { $cache = new ArrayCache(256); } $executor = $this->createExecutor($config, $loop ?: Loop::get()); $executor = new CachingExecutor($executor, $cache); $executor = $this->decorateHostsFileExecutor($executor); return new Resolver($executor); } /** * Tries to load the hosts file and decorates the given executor on success * * @param ExecutorInterface $executor * @return ExecutorInterface * @codeCoverageIgnore */ private function decorateHostsFileExecutor(ExecutorInterface $executor) { try { $executor = new HostsFileExecutor(HostsFile::loadFromPathBlocking(), $executor); } catch (\RuntimeException $e) { // ignore this file if it can not be loaded } // Windows does not store localhost in hosts file by default but handles this internally // To compensate for this, we explicitly use hard-coded defaults for localhost if (\DIRECTORY_SEPARATOR === '\\') { $executor = new HostsFileExecutor(new HostsFile("127.0.0.1 localhost\n::1 localhost"), $executor); } return $executor; } /** * @param Config|string $nameserver * @param LoopInterface $loop * @return CoopExecutor * @throws \InvalidArgumentException for invalid DNS server address * @throws \UnderflowException when given DNS Config object has an empty list of nameservers */ private function createExecutor($nameserver, LoopInterface $loop) { if ($nameserver instanceof Config) { if (!$nameserver->nameservers) { throw new \UnderflowException('Empty config with no DNS servers'); } // Hard-coded to check up to 3 DNS servers to match default limits in place in most systems (see MAXNS config). // Note to future self: Recursion isn't too hard, but how deep do we really want to go? $primary = \reset($nameserver->nameservers); $secondary = \next($nameserver->nameservers); $tertiary = \next($nameserver->nameservers); if ($tertiary !== \false) { // 3 DNS servers given => nest first with fallback for second and third return new CoopExecutor(new RetryExecutor(new FallbackExecutor($this->createSingleExecutor($primary, $loop), new FallbackExecutor($this->createSingleExecutor($secondary, $loop), $this->createSingleExecutor($tertiary, $loop))))); } elseif ($secondary !== \false) { // 2 DNS servers given => fallback from first to second return new CoopExecutor(new RetryExecutor(new FallbackExecutor($this->createSingleExecutor($primary, $loop), $this->createSingleExecutor($secondary, $loop)))); } else { // 1 DNS server given => use single executor $nameserver = $primary; } } return new CoopExecutor(new RetryExecutor($this->createSingleExecutor($nameserver, $loop))); } /** * @param string $nameserver * @param LoopInterface $loop * @return ExecutorInterface * @throws \InvalidArgumentException for invalid DNS server address */ private function createSingleExecutor($nameserver, LoopInterface $loop) { $parts = \parse_url($nameserver); if (isset($parts['scheme']) && $parts['scheme'] === 'tcp') { $executor = $this->createTcpExecutor($nameserver, $loop); } elseif (isset($parts['scheme']) && $parts['scheme'] === 'udp') { $executor = $this->createUdpExecutor($nameserver, $loop); } else { $executor = new SelectiveTransportExecutor($this->createUdpExecutor($nameserver, $loop), $this->createTcpExecutor($nameserver, $loop)); } return $executor; } /** * @param string $nameserver * @param LoopInterface $loop * @return TimeoutExecutor * @throws \InvalidArgumentException for invalid DNS server address */ private function createTcpExecutor($nameserver, LoopInterface $loop) { return new TimeoutExecutor(new TcpTransportExecutor($nameserver, $loop), 5.0, $loop); } /** * @param string $nameserver * @param LoopInterface $loop * @return TimeoutExecutor * @throws \InvalidArgumentException for invalid DNS server address */ private function createUdpExecutor($nameserver, LoopInterface $loop) { return new TimeoutExecutor(new UdpTransportExecutor($nameserver, $loop), 5.0, $loop); } } <?php namespace _PHPStan_7d8742a37\React\Dns\Model; use _PHPStan_7d8742a37\React\Dns\Query\Query; /** * This class represents an outgoing query message or an incoming response message * * @link https://tools.ietf.org/html/rfc1035#section-4.1.1 */ final class Message { const TYPE_A = 1; const TYPE_NS = 2; const TYPE_CNAME = 5; const TYPE_SOA = 6; const TYPE_PTR = 12; const TYPE_MX = 15; const TYPE_TXT = 16; const TYPE_AAAA = 28; const TYPE_SRV = 33; const TYPE_SSHFP = 44; /** * pseudo-type for EDNS0 * * These are included in the additional section and usually not in answer section. * Defined in [RFC 6891](https://tools.ietf.org/html/rfc6891) (or older * [RFC 2671](https://tools.ietf.org/html/rfc2671)). * * The OPT record uses the "class" field to store the maximum size. * * The OPT record uses the "ttl" field to store additional flags. */ const TYPE_OPT = 41; /** * Sender Policy Framework (SPF) had a dedicated SPF type which has been * deprecated in favor of reusing the existing TXT type. * * @deprecated https://datatracker.ietf.org/doc/html/rfc7208#section-3.1 * @see self::TYPE_TXT */ const TYPE_SPF = 99; const TYPE_ANY = 255; const TYPE_CAA = 257; const CLASS_IN = 1; const OPCODE_QUERY = 0; const OPCODE_IQUERY = 1; // inverse query const OPCODE_STATUS = 2; const RCODE_OK = 0; const RCODE_FORMAT_ERROR = 1; const RCODE_SERVER_FAILURE = 2; const RCODE_NAME_ERROR = 3; const RCODE_NOT_IMPLEMENTED = 4; const RCODE_REFUSED = 5; /** * The edns-tcp-keepalive EDNS0 Option * * Option value contains a `?float` with timeout in seconds (in 0.1s steps) * for DNS response or `null` for DNS query. * * @link https://tools.ietf.org/html/rfc7828 */ const OPT_TCP_KEEPALIVE = 11; /** * The EDNS(0) Padding Option * * Option value contains a `string` with binary data (usually variable * number of null bytes) * * @link https://tools.ietf.org/html/rfc7830 */ const OPT_PADDING = 12; /** * Creates a new request message for the given query * * @param Query $query * @return self */ public static function createRequestForQuery(Query $query) { $request = new Message(); $request->id = self::generateId(); $request->rd = \true; $request->questions[] = $query; return $request; } /** * Creates a new response message for the given query with the given answer records * * @param Query $query * @param Record[] $answers * @return self */ public static function createResponseWithAnswersForQuery(Query $query, array $answers) { $response = new Message(); $response->id = self::generateId(); $response->qr = \true; $response->rd = \true; $response->questions[] = $query; foreach ($answers as $record) { $response->answers[] = $record; } return $response; } /** * generates a random 16 bit message ID * * This uses a CSPRNG so that an outside attacker that is sending spoofed * DNS response messages can not guess the message ID to avoid possible * cache poisoning attacks. * * The `random_int()` function is only available on PHP 7+ or when * https://github.com/paragonie/random_compat is installed. As such, using * the latest supported PHP version is highly recommended. This currently * falls back to a less secure random number generator on older PHP versions * in the hope that this system is properly protected against outside * attackers, for example by using one of the common local DNS proxy stubs. * * @return int * @see self::getId() * @codeCoverageIgnore */ private static function generateId() { if (\function_exists('random_int')) { return \random_int(0, 0xffff); } return \mt_rand(0, 0xffff); } /** * The 16 bit message ID * * The response message ID has to match the request message ID. This allows * the receiver to verify this is the correct response message. An outside * attacker may try to inject fake responses by "guessing" the message ID, * so this should use a proper CSPRNG to avoid possible cache poisoning. * * @var int 16 bit message ID * @see self::generateId() */ public $id = 0; /** * @var bool Query/Response flag, query=false or response=true */ public $qr = \false; /** * @var int specifies the kind of query (4 bit), see self::OPCODE_* constants * @see self::OPCODE_QUERY */ public $opcode = self::OPCODE_QUERY; /** * * @var bool Authoritative Answer */ public $aa = \false; /** * @var bool TrunCation */ public $tc = \false; /** * @var bool Recursion Desired */ public $rd = \false; /** * @var bool Recursion Available */ public $ra = \false; /** * @var int response code (4 bit), see self::RCODE_* constants * @see self::RCODE_OK */ public $rcode = Message::RCODE_OK; /** * An array of Query objects * * ```php * $questions = array( * new Query( * 'reactphp.org', * Message::TYPE_A, * Message::CLASS_IN * ) * ); * ``` * * @var Query[] */ public $questions = array(); /** * @var Record[] */ public $answers = array(); /** * @var Record[] */ public $authority = array(); /** * @var Record[] */ public $additional = array(); } <?php namespace _PHPStan_7d8742a37\React\Dns\Model; /** * This class represents a single resulting record in a response message * * It uses a structure similar to `\React\Dns\Query\Query`, but does include * fields for resulting TTL and resulting record data (IPs etc.). * * @link https://tools.ietf.org/html/rfc1035#section-4.1.3 * @see \React\Dns\Query\Query */ final class Record { /** * @var string hostname without trailing dot, for example "reactphp.org" */ public $name; /** * @var int see Message::TYPE_* constants (UINT16) */ public $type; /** * Defines the network class, usually `Message::CLASS_IN`. * * For `OPT` records (EDNS0), this defines the maximum message size instead. * * @var int see Message::CLASS_IN constant (UINT16) * @see Message::CLASS_IN */ public $class; /** * Defines the maximum time-to-live (TTL) in seconds * * For `OPT` records (EDNS0), this defines additional flags instead. * * @var int maximum TTL in seconds (UINT32, most significant bit always unset) * @link https://tools.ietf.org/html/rfc2181#section-8 * @link https://tools.ietf.org/html/rfc6891#section-6.1.3 for `OPT` records (EDNS0) */ public $ttl; /** * The payload data for this record * * The payload data format depends on the record type. As a rule of thumb, * this library will try to express this in a way that can be consumed * easily without having to worry about DNS internals and its binary transport: * * - A: * IPv4 address string, for example "192.168.1.1". * * - AAAA: * IPv6 address string, for example "::1". * * - CNAME / PTR / NS: * The hostname without trailing dot, for example "reactphp.org". * * - TXT: * List of string values, for example `["v=spf1 include:example.com"]`. * This is commonly a list with only a single string value, but this * technically allows multiple strings (0-255 bytes each) in a single * record. This is rarely used and depending on application you may want * to join these together or handle them separately. Each string can * transport any binary data, its character encoding is not defined (often * ASCII/UTF-8 in practice). [RFC 1464](https://tools.ietf.org/html/rfc1464) * suggests using key-value pairs such as `["name=test","version=1"]`, but * interpretation of this is not enforced and left up to consumers of this * library (used for DNS-SD/Zeroconf and others). * * - MX: * Mail server priority (UINT16) and target hostname without trailing dot, * for example `{"priority":10,"target":"mx.example.com"}`. * The payload data uses an associative array with fixed keys "priority" * (also commonly referred to as weight or preference) and "target" (also * referred to as exchange). If a response message contains multiple * records of this type, targets should be sorted by priority (lowest * first) - this is left up to consumers of this library (used for SMTP). * * - SRV: * Service priority (UINT16), service weight (UINT16), service port (UINT16) * and target hostname without trailing dot, for example * `{"priority":10,"weight":50,"port":8080,"target":"example.com"}`. * The payload data uses an associative array with fixed keys "priority", * "weight", "port" and "target" (also referred to as name). * The target may be an empty host name string if the service is decidedly * not available. If a response message contains multiple records of this * type, targets should be sorted by priority (lowest first) and selected * randomly according to their weight - this is left up to consumers of * this library, see also [RFC 2782](https://tools.ietf.org/html/rfc2782) * for more details. * * - SSHFP: * Includes algorithm (UNIT8), fingerprint type (UNIT8) and fingerprint * value as lower case hex string, for example: * `{"algorithm":1,"type":1,"fingerprint":"0123456789abcdef..."}` * See also https://www.iana.org/assignments/dns-sshfp-rr-parameters/dns-sshfp-rr-parameters.xhtml * for algorithm and fingerprint type assignments. * * - SOA: * Includes master hostname without trailing dot, responsible person email * as hostname without trailing dot and serial, refresh, retry, expire and * minimum times in seconds (UINT32 each), for example: * `{"mname":"ns.example.com","rname":"hostmaster.example.com","serial": * 2018082601,"refresh":3600,"retry":1800,"expire":60000,"minimum":3600}`. * * - CAA: * Includes flag (UNIT8), tag string and value string, for example: * `{"flag":128,"tag":"issue","value":"letsencrypt.org"}` * * - OPT: * Special pseudo-type for EDNS0. Includes an array of additional opt codes * with a value according to the respective OPT code. See `Message::OPT_*` * for list of supported OPT codes. Any other OPT code not currently * supported will be an opaque binary string containing the raw data * as transported in the DNS record. For forwards compatibility, you should * not rely on this format for unknown types. Future versions may add * support for new types and this may then parse the payload data * appropriately - this will not be considered a BC break. See also * [RFC 6891](https://tools.ietf.org/html/rfc6891) for more details. * * - Any other unknown type: * An opaque binary string containing the RDATA as transported in the DNS * record. For forwards compatibility, you should not rely on this format * for unknown types. Future versions may add support for new types and * this may then parse the payload data appropriately - this will not be * considered a BC break. See the format definition of known types above * for more details. * * @var string|string[]|array */ public $data; /** * @param string $name * @param int $type * @param int $class * @param int $ttl * @param string|string[]|array $data */ public function __construct($name, $type, $class, $ttl, $data) { $this->name = $name; $this->type = $type; $this->class = $class; $this->ttl = $ttl; $this->data = $data; } } <?php namespace _PHPStan_7d8742a37\React\Dns\Protocol; use _PHPStan_7d8742a37\React\Dns\Model\Message; use _PHPStan_7d8742a37\React\Dns\Model\Record; use _PHPStan_7d8742a37\React\Dns\Query\Query; use InvalidArgumentException; /** * DNS protocol parser * * Obsolete and uncommon types and classes are not implemented. */ final class Parser { /** * Parses the given raw binary message into a Message object * * @param string $data * @throws InvalidArgumentException * @return Message */ public function parseMessage($data) { $message = $this->parse($data, 0); if ($message === null) { throw new InvalidArgumentException('Unable to parse binary message'); } return $message; } /** * @param string $data * @param int $consumed * @return ?Message */ private function parse($data, $consumed) { if (!isset($data[12 - 1])) { return null; } list($id, $fields, $qdCount, $anCount, $nsCount, $arCount) = \array_values(\unpack('n*', \substr($data, 0, 12))); $message = new Message(); $message->id = $id; $message->rcode = $fields & 0xf; $message->ra = ($fields >> 7 & 1) === 1; $message->rd = ($fields >> 8 & 1) === 1; $message->tc = ($fields >> 9 & 1) === 1; $message->aa = ($fields >> 10 & 1) === 1; $message->opcode = $fields >> 11 & 0xf; $message->qr = ($fields >> 15 & 1) === 1; $consumed += 12; // parse all questions for ($i = $qdCount; $i > 0; --$i) { list($question, $consumed) = $this->parseQuestion($data, $consumed); if ($question === null) { return null; } else { $message->questions[] = $question; } } // parse all answer records for ($i = $anCount; $i > 0; --$i) { list($record, $consumed) = $this->parseRecord($data, $consumed); if ($record === null) { return null; } else { $message->answers[] = $record; } } // parse all authority records for ($i = $nsCount; $i > 0; --$i) { list($record, $consumed) = $this->parseRecord($data, $consumed); if ($record === null) { return null; } else { $message->authority[] = $record; } } // parse all additional records for ($i = $arCount; $i > 0; --$i) { list($record, $consumed) = $this->parseRecord($data, $consumed); if ($record === null) { return null; } else { $message->additional[] = $record; } } return $message; } /** * @param string $data * @param int $consumed * @return array */ private function parseQuestion($data, $consumed) { list($labels, $consumed) = $this->readLabels($data, $consumed); if ($labels === null || !isset($data[$consumed + 4 - 1])) { return array(null, null); } list($type, $class) = \array_values(\unpack('n*', \substr($data, $consumed, 4))); $consumed += 4; return array(new Query(\implode('.', $labels), $type, $class), $consumed); } /** * @param string $data * @param int $consumed * @return array An array with a parsed Record on success or array with null if data is invalid/incomplete */ private function parseRecord($data, $consumed) { list($name, $consumed) = $this->readDomain($data, $consumed); if ($name === null || !isset($data[$consumed + 10 - 1])) { return array(null, null); } list($type, $class) = \array_values(\unpack('n*', \substr($data, $consumed, 4))); $consumed += 4; list($ttl) = \array_values(\unpack('N', \substr($data, $consumed, 4))); $consumed += 4; // TTL is a UINT32 that must not have most significant bit set for BC reasons if ($ttl < 0 || $ttl >= 1 << 31) { $ttl = 0; } list($rdLength) = \array_values(\unpack('n', \substr($data, $consumed, 2))); $consumed += 2; if (!isset($data[$consumed + $rdLength - 1])) { return array(null, null); } $rdata = null; $expected = $consumed + $rdLength; if (Message::TYPE_A === $type) { if ($rdLength === 4) { $rdata = \inet_ntop(\substr($data, $consumed, $rdLength)); $consumed += $rdLength; } } elseif (Message::TYPE_AAAA === $type) { if ($rdLength === 16) { $rdata = \inet_ntop(\substr($data, $consumed, $rdLength)); $consumed += $rdLength; } } elseif (Message::TYPE_CNAME === $type || Message::TYPE_PTR === $type || Message::TYPE_NS === $type) { list($rdata, $consumed) = $this->readDomain($data, $consumed); } elseif (Message::TYPE_TXT === $type || Message::TYPE_SPF === $type) { $rdata = array(); while ($consumed < $expected) { $len = \ord($data[$consumed]); $rdata[] = (string) \substr($data, $consumed + 1, $len); $consumed += $len + 1; } } elseif (Message::TYPE_MX === $type) { if ($rdLength > 2) { list($priority) = \array_values(\unpack('n', \substr($data, $consumed, 2))); list($target, $consumed) = $this->readDomain($data, $consumed + 2); $rdata = array('priority' => $priority, 'target' => $target); } } elseif (Message::TYPE_SRV === $type) { if ($rdLength > 6) { list($priority, $weight, $port) = \array_values(\unpack('n*', \substr($data, $consumed, 6))); list($target, $consumed) = $this->readDomain($data, $consumed + 6); $rdata = array('priority' => $priority, 'weight' => $weight, 'port' => $port, 'target' => $target); } } elseif (Message::TYPE_SSHFP === $type) { if ($rdLength > 2) { list($algorithm, $hash) = \array_values(\unpack('C*', \substr($data, $consumed, 2))); $fingerprint = \bin2hex(\substr($data, $consumed + 2, $rdLength - 2)); $consumed += $rdLength; $rdata = array('algorithm' => $algorithm, 'type' => $hash, 'fingerprint' => $fingerprint); } } elseif (Message::TYPE_SOA === $type) { list($mname, $consumed) = $this->readDomain($data, $consumed); list($rname, $consumed) = $this->readDomain($data, $consumed); if ($mname !== null && $rname !== null && isset($data[$consumed + 20 - 1])) { list($serial, $refresh, $retry, $expire, $minimum) = \array_values(\unpack('N*', \substr($data, $consumed, 20))); $consumed += 20; $rdata = array('mname' => $mname, 'rname' => $rname, 'serial' => $serial, 'refresh' => $refresh, 'retry' => $retry, 'expire' => $expire, 'minimum' => $minimum); } } elseif (Message::TYPE_OPT === $type) { $rdata = array(); while (isset($data[$consumed + 4 - 1])) { list($code, $length) = \array_values(\unpack('n*', \substr($data, $consumed, 4))); $value = (string) \substr($data, $consumed + 4, $length); if ($code === Message::OPT_TCP_KEEPALIVE && $value === '') { $value = null; } elseif ($code === Message::OPT_TCP_KEEPALIVE && $length === 2) { list($value) = \array_values(\unpack('n', $value)); $value = \round($value * 0.1, 1); } elseif ($code === Message::OPT_TCP_KEEPALIVE) { break; } $rdata[$code] = $value; $consumed += 4 + $length; } } elseif (Message::TYPE_CAA === $type) { if ($rdLength > 3) { list($flag, $tagLength) = \array_values(\unpack('C*', \substr($data, $consumed, 2))); if ($tagLength > 0 && $rdLength - 2 - $tagLength > 0) { $tag = \substr($data, $consumed + 2, $tagLength); $value = \substr($data, $consumed + 2 + $tagLength, $rdLength - 2 - $tagLength); $consumed += $rdLength; $rdata = array('flag' => $flag, 'tag' => $tag, 'value' => $value); } } } else { // unknown types simply parse rdata as an opaque binary string $rdata = \substr($data, $consumed, $rdLength); $consumed += $rdLength; } // ensure parsing record data consumes expact number of bytes indicated in record length if ($consumed !== $expected || $rdata === null) { return array(null, null); } return array(new Record($name, $type, $class, $ttl, $rdata), $consumed); } private function readDomain($data, $consumed) { list($labels, $consumed) = $this->readLabels($data, $consumed); if ($labels === null) { return array(null, null); } // use escaped notation for each label part, then join using dots return array(\implode('.', \array_map(function ($label) { return \addcslashes($label, "\x00.. ."); }, $labels)), $consumed); } /** * @param string $data * @param int $consumed * @param int $compressionDepth maximum depth for compressed labels to avoid unreasonable recursion * @return array */ private function readLabels($data, $consumed, $compressionDepth = 127) { $labels = array(); while (\true) { if (!isset($data[$consumed])) { return array(null, null); } $length = \ord($data[$consumed]); // end of labels reached if ($length === 0) { $consumed += 1; break; } // first two bits set? this is a compressed label (14 bit pointer offset) if (($length & 0xc0) === 0xc0 && isset($data[$consumed + 1]) && $compressionDepth) { $offset = ($length & ~0xc0) << 8 | \ord($data[$consumed + 1]); if ($offset >= $consumed) { return array(null, null); } $consumed += 2; list($newLabels) = $this->readLabels($data, $offset, $compressionDepth - 1); if ($newLabels === null) { return array(null, null); } $labels = \array_merge($labels, $newLabels); break; } // length MUST be 0-63 (6 bits only) and data has to be large enough if ($length & 0xc0 || !isset($data[$consumed + $length - 1])) { return array(null, null); } $labels[] = \substr($data, $consumed + 1, $length); $consumed += $length + 1; } return array($labels, $consumed); } } <?php namespace _PHPStan_7d8742a37\React\Dns\Protocol; use _PHPStan_7d8742a37\React\Dns\Model\Message; use _PHPStan_7d8742a37\React\Dns\Model\Record; use _PHPStan_7d8742a37\React\Dns\Query\Query; final class BinaryDumper { /** * @param Message $message * @return string */ public function toBinary(Message $message) { $data = ''; $data .= $this->headerToBinary($message); $data .= $this->questionToBinary($message->questions); $data .= $this->recordsToBinary($message->answers); $data .= $this->recordsToBinary($message->authority); $data .= $this->recordsToBinary($message->additional); return $data; } /** * @param Message $message * @return string */ private function headerToBinary(Message $message) { $data = ''; $data .= \pack('n', $message->id); $flags = 0x0; $flags = $flags << 1 | ($message->qr ? 1 : 0); $flags = $flags << 4 | $message->opcode; $flags = $flags << 1 | ($message->aa ? 1 : 0); $flags = $flags << 1 | ($message->tc ? 1 : 0); $flags = $flags << 1 | ($message->rd ? 1 : 0); $flags = $flags << 1 | ($message->ra ? 1 : 0); $flags = $flags << 3 | 0; // skip unused zero bit $flags = $flags << 4 | $message->rcode; $data .= \pack('n', $flags); $data .= \pack('n', \count($message->questions)); $data .= \pack('n', \count($message->answers)); $data .= \pack('n', \count($message->authority)); $data .= \pack('n', \count($message->additional)); return $data; } /** * @param Query[] $questions * @return string */ private function questionToBinary(array $questions) { $data = ''; foreach ($questions as $question) { $data .= $this->domainNameToBinary($question->name); $data .= \pack('n*', $question->type, $question->class); } return $data; } /** * @param Record[] $records * @return string */ private function recordsToBinary(array $records) { $data = ''; foreach ($records as $record) { /* @var $record Record */ switch ($record->type) { case Message::TYPE_A: case Message::TYPE_AAAA: $binary = \inet_pton($record->data); break; case Message::TYPE_CNAME: case Message::TYPE_NS: case Message::TYPE_PTR: $binary = $this->domainNameToBinary($record->data); break; case Message::TYPE_TXT: case Message::TYPE_SPF: $binary = $this->textsToBinary($record->data); break; case Message::TYPE_MX: $binary = \pack('n', $record->data['priority']); $binary .= $this->domainNameToBinary($record->data['target']); break; case Message::TYPE_SRV: $binary = \pack('n*', $record->data['priority'], $record->data['weight'], $record->data['port']); $binary .= $this->domainNameToBinary($record->data['target']); break; case Message::TYPE_SOA: $binary = $this->domainNameToBinary($record->data['mname']); $binary .= $this->domainNameToBinary($record->data['rname']); $binary .= \pack('N*', $record->data['serial'], $record->data['refresh'], $record->data['retry'], $record->data['expire'], $record->data['minimum']); break; case Message::TYPE_CAA: $binary = \pack('C*', $record->data['flag'], \strlen($record->data['tag'])); $binary .= $record->data['tag']; $binary .= $record->data['value']; break; case Message::TYPE_SSHFP: $binary = \pack('CCH*', $record->data['algorithm'], $record->data['type'], $record->data['fingerprint']); break; case Message::TYPE_OPT: $binary = ''; foreach ($record->data as $opt => $value) { if ($opt === Message::OPT_TCP_KEEPALIVE && $value !== null) { $value = \pack('n', \round($value * 10)); } $binary .= \pack('n*', $opt, \strlen((string) $value)) . $value; } break; default: // RDATA is already stored as binary value for unknown record types $binary = $record->data; } $data .= $this->domainNameToBinary($record->name); $data .= \pack('nnNn', $record->type, $record->class, $record->ttl, \strlen($binary)); $data .= $binary; } return $data; } /** * @param string[] $texts * @return string */ private function textsToBinary(array $texts) { $data = ''; foreach ($texts as $text) { $data .= \chr(\strlen($text)) . $text; } return $data; } /** * @param string $host * @return string */ private function domainNameToBinary($host) { if ($host === '') { return "\x00"; } // break up domain name at each dot that is not preceeded by a backslash (escaped notation) return $this->textsToBinary(\array_map('stripcslashes', \preg_split('/(?<!\\\\)\\./', $host . '.'))); } } <?php namespace _PHPStan_7d8742a37\React\Dns; final class BadServerException extends \Exception { } <?php namespace _PHPStan_7d8742a37\React\Dns\Config; use RuntimeException; /** * Represents a static hosts file which maps hostnames to IPs * * Hosts files are used on most systems to avoid actually hitting the DNS for * certain common hostnames. * * Most notably, this file usually contains an entry to map "localhost" to the * local IP. Windows is a notable exception here, as Windows does not actually * include "localhost" in this file by default. To compensate for this, this * class may explicitly be wrapped in another HostsFile instance which * hard-codes these entries for Windows (see also Factory). * * This class mostly exists to abstract the parsing/extraction process so this * can be replaced with a faster alternative in the future. */ class HostsFile { /** * Returns the default path for the hosts file on this system * * @return string * @codeCoverageIgnore */ public static function getDefaultPath() { // use static path for all Unix-based systems if (\DIRECTORY_SEPARATOR !== '\\') { return '/etc/hosts'; } // Windows actually stores the path in the registry under // \HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters\DataBasePath $path = '_PHPStan_7d8742a37\\%SystemRoot%\\system32\\drivers\\etc\\hosts'; $base = \getenv('SystemRoot'); if ($base === \false) { $base = 'C:\\Windows'; } return \str_replace('%SystemRoot%', $base, $path); } /** * Loads a hosts file (from the given path or default location) * * Note that this method blocks while loading the given path and should * thus be used with care! While this should be relatively fast for normal * hosts file, this may be an issue if this file is located on a slow device * or contains an excessive number of entries. In particular, this method * should only be executed before the loop starts, not while it is running. * * @param ?string $path (optional) path to hosts file or null=load default location * @return self * @throws RuntimeException if the path can not be loaded (does not exist) */ public static function loadFromPathBlocking($path = null) { if ($path === null) { $path = self::getDefaultPath(); } $contents = @\file_get_contents($path); if ($contents === \false) { throw new RuntimeException('Unable to load hosts file "' . $path . '"'); } return new self($contents); } private $contents; /** * Instantiate new hosts file with the given hosts file contents * * @param string $contents */ public function __construct($contents) { // remove all comments from the contents $contents = \preg_replace('/[ \\t]*#.*/', '', \strtolower($contents)); $this->contents = $contents; } /** * Returns all IPs for the given hostname * * @param string $name * @return string[] */ public function getIpsForHost($name) { $name = \strtolower($name); $ips = array(); foreach (\preg_split('/\\r?\\n/', $this->contents) as $line) { $parts = \preg_split('/\\s+/', $line); $ip = \array_shift($parts); if ($parts && \array_search($name, $parts) !== \false) { // remove IPv6 zone ID (`fe80::1%lo0` => `fe80:1`) if (\strpos($ip, ':') !== \false && ($pos = \strpos($ip, '%')) !== \false) { $ip = \substr($ip, 0, $pos); } if (@\inet_pton($ip) !== \false) { $ips[] = $ip; } } } return $ips; } /** * Returns all hostnames for the given IPv4 or IPv6 address * * @param string $ip * @return string[] */ public function getHostsForIp($ip) { // check binary representation of IP to avoid string case and short notation $ip = @\inet_pton($ip); if ($ip === \false) { return array(); } $names = array(); foreach (\preg_split('/\\r?\\n/', $this->contents) as $line) { $parts = \preg_split('/\\s+/', $line, -1, \PREG_SPLIT_NO_EMPTY); $addr = (string) \array_shift($parts); // remove IPv6 zone ID (`fe80::1%lo0` => `fe80:1`) if (\strpos($addr, ':') !== \false && ($pos = \strpos($addr, '%')) !== \false) { $addr = \substr($addr, 0, $pos); } if (@\inet_pton($addr) === $ip) { foreach ($parts as $part) { $names[] = $part; } } } return $names; } } <?php namespace _PHPStan_7d8742a37\React\Dns\Config; use RuntimeException; final class Config { /** * Loads the system DNS configuration * * Note that this method may block while loading its internal files and/or * commands and should thus be used with care! While this should be * relatively fast for most systems, it remains unknown if this may block * under certain circumstances. In particular, this method should only be * executed before the loop starts, not while it is running. * * Note that this method will try to access its files and/or commands and * try to parse its output. Currently, this will only parse valid nameserver * entries from its output and will ignore all other output without * complaining. * * Note that the previous section implies that this may return an empty * `Config` object if no valid nameserver entries can be found. * * @return self * @codeCoverageIgnore */ public static function loadSystemConfigBlocking() { // Use WMIC output on Windows if (\DIRECTORY_SEPARATOR === '\\') { return self::loadWmicBlocking(); } // otherwise (try to) load from resolv.conf try { return self::loadResolvConfBlocking(); } catch (RuntimeException $ignored) { // return empty config if parsing fails (file not found) return new self(); } } /** * Loads a resolv.conf file (from the given path or default location) * * Note that this method blocks while loading the given path and should * thus be used with care! While this should be relatively fast for normal * resolv.conf files, this may be an issue if this file is located on a slow * device or contains an excessive number of entries. In particular, this * method should only be executed before the loop starts, not while it is * running. * * Note that this method will throw if the given file can not be loaded, * such as if it is not readable or does not exist. In particular, this file * is not available on Windows. * * Currently, this will only parse valid "nameserver X" lines from the * given file contents. Lines can be commented out with "#" and ";" and * invalid lines will be ignored without complaining. See also * `man resolv.conf` for more details. * * Note that the previous section implies that this may return an empty * `Config` object if no valid "nameserver X" lines can be found. See also * `man resolv.conf` which suggests that the DNS server on the localhost * should be used in this case. This is left up to higher level consumers * of this API. * * @param ?string $path (optional) path to resolv.conf file or null=load default location * @return self * @throws RuntimeException if the path can not be loaded (does not exist) */ public static function loadResolvConfBlocking($path = null) { if ($path === null) { $path = '/etc/resolv.conf'; } $contents = @\file_get_contents($path); if ($contents === \false) { throw new RuntimeException('Unable to load resolv.conf file "' . $path . '"'); } $matches = array(); \preg_match_all('/^nameserver\\s+(\\S+)\\s*$/m', $contents, $matches); $config = new self(); foreach ($matches[1] as $ip) { // remove IPv6 zone ID (`fe80::1%lo0` => `fe80:1`) if (\strpos($ip, ':') !== \false && ($pos = \strpos($ip, '%')) !== \false) { $ip = \substr($ip, 0, $pos); } if (@\inet_pton($ip) !== \false) { $config->nameservers[] = $ip; } } return $config; } /** * Loads the DNS configurations from Windows's WMIC (from the given command or default command) * * Note that this method blocks while loading the given command and should * thus be used with care! While this should be relatively fast for normal * WMIC commands, it remains unknown if this may block under certain * circumstances. In particular, this method should only be executed before * the loop starts, not while it is running. * * Note that this method will only try to execute the given command try to * parse its output, irrespective of whether this command exists. In * particular, this command is only available on Windows. Currently, this * will only parse valid nameserver entries from the command output and will * ignore all other output without complaining. * * Note that the previous section implies that this may return an empty * `Config` object if no valid nameserver entries can be found. * * @param ?string $command (advanced) should not be given (NULL) unless you know what you're doing * @return self * @link https://ss64.com/nt/wmic.html */ public static function loadWmicBlocking($command = null) { $contents = \shell_exec($command === null ? 'wmic NICCONFIG get "DNSServerSearchOrder" /format:CSV' : $command); \preg_match_all('/(?<=[{;,"])([\\da-f.:]{4,})(?=[};,"])/i', $contents, $matches); $config = new self(); $config->nameservers = $matches[1]; return $config; } public $nameservers = array(); } The MIT License (MIT) Copyright (c) 2012 Jan Sorgalla, Christian Lück, Cees-Jan Kiewiet, Chris Boden Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. <?php namespace _PHPStan_7d8742a37\React\Promise; /** * @template-covariant T */ interface PromiseInterface { /** * Transforms a promise's value by applying a function to the promise's fulfillment * or rejection value. Returns a new promise for the transformed result. * * The `then()` method registers new fulfilled and rejection handlers with a promise * (all parameters are optional): * * * `$onFulfilled` will be invoked once the promise is fulfilled and passed * the result as the first argument. * * `$onRejected` will be invoked once the promise is rejected and passed the * reason as the first argument. * * It returns a new promise that will fulfill with the return value of either * `$onFulfilled` or `$onRejected`, whichever is called, or will reject with * the thrown exception if either throws. * * A promise makes the following guarantees about handlers registered in * the same call to `then()`: * * 1. Only one of `$onFulfilled` or `$onRejected` will be called, * never both. * 2. `$onFulfilled` and `$onRejected` will never be called more * than once. * * @template TFulfilled * @template TRejected * @param ?(callable((T is void ? null : T)): (PromiseInterface<TFulfilled>|TFulfilled)) $onFulfilled * @param ?(callable(\Throwable): (PromiseInterface<TRejected>|TRejected)) $onRejected * @return PromiseInterface<($onRejected is null ? ($onFulfilled is null ? T : TFulfilled) : ($onFulfilled is null ? T|TRejected : TFulfilled|TRejected))> */ public function then(?callable $onFulfilled = null, ?callable $onRejected = null) : PromiseInterface; /** * Registers a rejection handler for promise. It is a shortcut for: * * ```php * $promise->then(null, $onRejected); * ``` * * Additionally, you can type hint the `$reason` argument of `$onRejected` to catch * only specific errors. * * @template TThrowable of \Throwable * @template TRejected * @param callable(TThrowable): (PromiseInterface<TRejected>|TRejected) $onRejected * @return PromiseInterface<T|TRejected> */ public function catch(callable $onRejected) : PromiseInterface; /** * Allows you to execute "cleanup" type tasks in a promise chain. * * It arranges for `$onFulfilledOrRejected` to be called, with no arguments, * when the promise is either fulfilled or rejected. * * * If `$promise` fulfills, and `$onFulfilledOrRejected` returns successfully, * `$newPromise` will fulfill with the same value as `$promise`. * * If `$promise` fulfills, and `$onFulfilledOrRejected` throws or returns a * rejected promise, `$newPromise` will reject with the thrown exception or * rejected promise's reason. * * If `$promise` rejects, and `$onFulfilledOrRejected` returns successfully, * `$newPromise` will reject with the same reason as `$promise`. * * If `$promise` rejects, and `$onFulfilledOrRejected` throws or returns a * rejected promise, `$newPromise` will reject with the thrown exception or * rejected promise's reason. * * `finally()` behaves similarly to the synchronous finally statement. When combined * with `catch()`, `finally()` allows you to write code that is similar to the familiar * synchronous catch/finally pair. * * Consider the following synchronous code: * * ```php * try { * return doSomething(); * } catch(\Exception $e) { * return handleError($e); * } finally { * cleanup(); * } * ``` * * Similar asynchronous code (with `doSomething()` that returns a promise) can be * written: * * ```php * return doSomething() * ->catch('handleError') * ->finally('cleanup'); * ``` * * @param callable(): (void|PromiseInterface<void>) $onFulfilledOrRejected * @return PromiseInterface<T> */ public function finally(callable $onFulfilledOrRejected) : PromiseInterface; /** * The `cancel()` method notifies the creator of the promise that there is no * further interest in the results of the operation. * * Once a promise is settled (either fulfilled or rejected), calling `cancel()` on * a promise has no effect. * * @return void */ public function cancel() : void; /** * [Deprecated] Registers a rejection handler for a promise. * * This method continues to exist only for BC reasons and to ease upgrading * between versions. It is an alias for: * * ```php * $promise->catch($onRejected); * ``` * * @template TThrowable of \Throwable * @template TRejected * @param callable(TThrowable): (PromiseInterface<TRejected>|TRejected) $onRejected * @return PromiseInterface<T|TRejected> * @deprecated 3.0.0 Use catch() instead * @see self::catch() */ public function otherwise(callable $onRejected) : PromiseInterface; /** * [Deprecated] Allows you to execute "cleanup" type tasks in a promise chain. * * This method continues to exist only for BC reasons and to ease upgrading * between versions. It is an alias for: * * ```php * $promise->finally($onFulfilledOrRejected); * ``` * * @param callable(): (void|PromiseInterface<void>) $onFulfilledOrRejected * @return PromiseInterface<T> * @deprecated 3.0.0 Use finally() instead * @see self::finally() */ public function always(callable $onFulfilledOrRejected) : PromiseInterface; } <?php namespace _PHPStan_7d8742a37\React\Promise\Internal; use _PHPStan_7d8742a37\React\Promise\PromiseInterface; use function _PHPStan_7d8742a37\React\Promise\_checkTypehint; use function _PHPStan_7d8742a37\React\Promise\resolve; use function _PHPStan_7d8742a37\React\Promise\set_rejection_handler; /** * @internal * * @template-implements PromiseInterface<never> */ final class RejectedPromise implements PromiseInterface { /** @var \Throwable */ private $reason; /** @var bool */ private $handled = \false; /** * @param \Throwable $reason */ public function __construct(\Throwable $reason) { $this->reason = $reason; } /** @throws void */ public function __destruct() { if ($this->handled) { return; } $handler = set_rejection_handler(null); if ($handler === null) { $message = 'Unhandled promise rejection with ' . $this->reason; \error_log($message); return; } try { $handler($this->reason); } catch (\Throwable $e) { \preg_match('/^([^:\\s]++)(.*+)$/sm', (string) $e, $match); \assert(isset($match[1], $match[2])); $message = 'Fatal error: Uncaught ' . $match[1] . ' from unhandled promise rejection handler' . $match[2]; \error_log($message); exit(255); } } /** * @template TRejected * @param ?callable $onFulfilled * @param ?(callable(\Throwable): (PromiseInterface<TRejected>|TRejected)) $onRejected * @return PromiseInterface<($onRejected is null ? never : TRejected)> */ public function then(?callable $onFulfilled = null, ?callable $onRejected = null) : PromiseInterface { if (null === $onRejected) { return $this; } $this->handled = \true; try { return resolve($onRejected($this->reason)); } catch (\Throwable $exception) { return new RejectedPromise($exception); } } /** * @template TThrowable of \Throwable * @template TRejected * @param callable(TThrowable): (PromiseInterface<TRejected>|TRejected) $onRejected * @return PromiseInterface<TRejected> */ public function catch(callable $onRejected) : PromiseInterface { if (!_checkTypehint($onRejected, $this->reason)) { return $this; } /** * @var callable(\Throwable):(PromiseInterface<TRejected>|TRejected) $onRejected */ return $this->then(null, $onRejected); } public function finally(callable $onFulfilledOrRejected) : PromiseInterface { return $this->then(null, function (\Throwable $reason) use($onFulfilledOrRejected) : PromiseInterface { return resolve($onFulfilledOrRejected())->then(function () use($reason) : PromiseInterface { return new RejectedPromise($reason); }); }); } public function cancel() : void { $this->handled = \true; } /** * @deprecated 3.0.0 Use `catch()` instead * @see self::catch() */ public function otherwise(callable $onRejected) : PromiseInterface { return $this->catch($onRejected); } /** * @deprecated 3.0.0 Use `always()` instead * @see self::always() */ public function always(callable $onFulfilledOrRejected) : PromiseInterface { return $this->finally($onFulfilledOrRejected); } } <?php namespace _PHPStan_7d8742a37\React\Promise\Internal; /** * @internal */ final class CancellationQueue { /** @var bool */ private $started = \false; /** @var object[] */ private $queue = []; public function __invoke() : void { if ($this->started) { return; } $this->started = \true; $this->drain(); } /** * @param mixed $cancellable */ public function enqueue($cancellable) : void { if (!\is_object($cancellable) || !\method_exists($cancellable, 'then') || !\method_exists($cancellable, 'cancel')) { return; } $length = \array_push($this->queue, $cancellable); if ($this->started && 1 === $length) { $this->drain(); } } private function drain() : void { for ($i = \key($this->queue); isset($this->queue[$i]); $i++) { $cancellable = $this->queue[$i]; \assert(\method_exists($cancellable, 'cancel')); $exception = null; try { $cancellable->cancel(); } catch (\Throwable $exception) { } unset($this->queue[$i]); if ($exception) { throw $exception; } } $this->queue = []; } } <?php namespace _PHPStan_7d8742a37\React\Promise\Internal; use _PHPStan_7d8742a37\React\Promise\PromiseInterface; use function _PHPStan_7d8742a37\React\Promise\resolve; /** * @internal * * @template T * @template-implements PromiseInterface<T> */ final class FulfilledPromise implements PromiseInterface { /** @var T */ private $value; /** * @param T $value * @throws \InvalidArgumentException */ public function __construct($value = null) { if ($value instanceof PromiseInterface) { throw new \InvalidArgumentException('You cannot create React\\Promise\\FulfilledPromise with a promise. Use React\\Promise\\resolve($promiseOrValue) instead.'); } $this->value = $value; } /** * @template TFulfilled * @param ?(callable((T is void ? null : T)): (PromiseInterface<TFulfilled>|TFulfilled)) $onFulfilled * @return PromiseInterface<($onFulfilled is null ? T : TFulfilled)> */ public function then(?callable $onFulfilled = null, ?callable $onRejected = null) : PromiseInterface { if (null === $onFulfilled) { return $this; } try { /** * @var PromiseInterface<T>|T $result */ $result = $onFulfilled($this->value); return resolve($result); } catch (\Throwable $exception) { return new RejectedPromise($exception); } } public function catch(callable $onRejected) : PromiseInterface { return $this; } public function finally(callable $onFulfilledOrRejected) : PromiseInterface { return $this->then(function ($value) use($onFulfilledOrRejected) : PromiseInterface { return resolve($onFulfilledOrRejected())->then(function () use($value) { return $value; }); }); } public function cancel() : void { } /** * @deprecated 3.0.0 Use `catch()` instead * @see self::catch() */ public function otherwise(callable $onRejected) : PromiseInterface { return $this->catch($onRejected); } /** * @deprecated 3.0.0 Use `finally()` instead * @see self::finally() */ public function always(callable $onFulfilledOrRejected) : PromiseInterface { return $this->finally($onFulfilledOrRejected); } } <?php namespace _PHPStan_7d8742a37\React\Promise; /** * @template T */ final class Deferred { /** * @var PromiseInterface<T> */ private $promise; /** @var callable(T):void */ private $resolveCallback; /** @var callable(\Throwable):void */ private $rejectCallback; /** * @param (callable(callable(T):void,callable(\Throwable):void):void)|null $canceller */ public function __construct(?callable $canceller = null) { $this->promise = new Promise(function ($resolve, $reject) : void { $this->resolveCallback = $resolve; $this->rejectCallback = $reject; }, $canceller); } /** * @return PromiseInterface<T> */ public function promise() : PromiseInterface { return $this->promise; } /** * @param T $value */ public function resolve($value) : void { ($this->resolveCallback)($value); } public function reject(\Throwable $reason) : void { ($this->rejectCallback)($reason); } } <?php namespace _PHPStan_7d8742a37\React\Promise\Exception; /** * Represents an exception that is a composite of one or more other exceptions. * * This exception is useful in situations where a promise must be rejected * with multiple exceptions. It is used for example to reject the returned * promise from `some()` and `any()` when too many input promises reject. */ class CompositeException extends \Exception { /** @var \Throwable[] */ private $throwables; /** @param \Throwable[] $throwables */ public function __construct(array $throwables, string $message = '', int $code = 0, ?\Throwable $previous = null) { parent::__construct($message, $code, $previous); $this->throwables = $throwables; } /** * @return \Throwable[] */ public function getThrowables() : array { return $this->throwables; } } <?php namespace _PHPStan_7d8742a37\React\Promise\Exception; class LengthException extends \LengthException { } <?php namespace _PHPStan_7d8742a37; if (!\function_exists('_PHPStan_7d8742a37\\React\\Promise\\resolve')) { require __DIR__ . '/functions.php'; } <?php namespace _PHPStan_7d8742a37\React\Promise; use _PHPStan_7d8742a37\React\Promise\Internal\RejectedPromise; /** * @template T * @template-implements PromiseInterface<T> */ final class Promise implements PromiseInterface { /** @var (callable(callable(T):void,callable(\Throwable):void):void)|null */ private $canceller; /** @var ?PromiseInterface<T> */ private $result; /** @var list<callable(PromiseInterface<T>):void> */ private $handlers = []; /** @var int */ private $requiredCancelRequests = 0; /** @var bool */ private $cancelled = \false; /** * @param callable(callable(T):void,callable(\Throwable):void):void $resolver * @param (callable(callable(T):void,callable(\Throwable):void):void)|null $canceller */ public function __construct(callable $resolver, ?callable $canceller = null) { $this->canceller = $canceller; // Explicitly overwrite arguments with null values before invoking // resolver function. This ensure that these arguments do not show up // in the stack trace in PHP 7+ only. $cb = $resolver; $resolver = $canceller = null; $this->call($cb); } public function then(?callable $onFulfilled = null, ?callable $onRejected = null) : PromiseInterface { if (null !== $this->result) { return $this->result->then($onFulfilled, $onRejected); } if (null === $this->canceller) { return new static($this->resolver($onFulfilled, $onRejected)); } // This promise has a canceller, so we create a new child promise which // has a canceller that invokes the parent canceller if all other // followers are also cancelled. We keep a reference to this promise // instance for the static canceller function and clear this to avoid // keeping a cyclic reference between parent and follower. $parent = $this; ++$parent->requiredCancelRequests; return new static($this->resolver($onFulfilled, $onRejected), static function () use(&$parent) : void { \assert($parent instanceof self); --$parent->requiredCancelRequests; if ($parent->requiredCancelRequests <= 0) { $parent->cancel(); } $parent = null; }); } /** * @template TThrowable of \Throwable * @template TRejected * @param callable(TThrowable): (PromiseInterface<TRejected>|TRejected) $onRejected * @return PromiseInterface<T|TRejected> */ public function catch(callable $onRejected) : PromiseInterface { return $this->then(null, static function (\Throwable $reason) use($onRejected) { if (!_checkTypehint($onRejected, $reason)) { return new RejectedPromise($reason); } /** * @var callable(\Throwable):(PromiseInterface<TRejected>|TRejected) $onRejected */ return $onRejected($reason); }); } public function finally(callable $onFulfilledOrRejected) : PromiseInterface { return $this->then(static function ($value) use($onFulfilledOrRejected) : PromiseInterface { return resolve($onFulfilledOrRejected())->then(function () use($value) { return $value; }); }, static function (\Throwable $reason) use($onFulfilledOrRejected) : PromiseInterface { return resolve($onFulfilledOrRejected())->then(function () use($reason) : RejectedPromise { return new RejectedPromise($reason); }); }); } public function cancel() : void { $this->cancelled = \true; $canceller = $this->canceller; $this->canceller = null; $parentCanceller = null; if (null !== $this->result) { // Forward cancellation to rejected promise to avoid reporting unhandled rejection if ($this->result instanceof RejectedPromise) { $this->result->cancel(); } // Go up the promise chain and reach the top most promise which is // itself not following another promise $root = $this->unwrap($this->result); // Return if the root promise is already resolved or a // FulfilledPromise or RejectedPromise if (!$root instanceof self || null !== $root->result) { return; } $root->requiredCancelRequests--; if ($root->requiredCancelRequests <= 0) { $parentCanceller = [$root, 'cancel']; } } if (null !== $canceller) { $this->call($canceller); } // For BC, we call the parent canceller after our own canceller if ($parentCanceller) { $parentCanceller(); } } /** * @deprecated 3.0.0 Use `catch()` instead * @see self::catch() */ public function otherwise(callable $onRejected) : PromiseInterface { return $this->catch($onRejected); } /** * @deprecated 3.0.0 Use `finally()` instead * @see self::finally() */ public function always(callable $onFulfilledOrRejected) : PromiseInterface { return $this->finally($onFulfilledOrRejected); } private function resolver(?callable $onFulfilled = null, ?callable $onRejected = null) : callable { return function (callable $resolve, callable $reject) use($onFulfilled, $onRejected) : void { $this->handlers[] = static function (PromiseInterface $promise) use($onFulfilled, $onRejected, $resolve, $reject) : void { $promise = $promise->then($onFulfilled, $onRejected); if ($promise instanceof self && $promise->result === null) { $promise->handlers[] = static function (PromiseInterface $promise) use($resolve, $reject) : void { $promise->then($resolve, $reject); }; } else { $promise->then($resolve, $reject); } }; }; } private function reject(\Throwable $reason) : void { if (null !== $this->result) { return; } $this->settle(reject($reason)); } /** * @param PromiseInterface<T> $result */ private function settle(PromiseInterface $result) : void { $result = $this->unwrap($result); if ($result === $this) { $result = new RejectedPromise(new \LogicException('Cannot resolve a promise with itself.')); } if ($result instanceof self) { $result->requiredCancelRequests++; } else { // Unset canceller only when not following a pending promise $this->canceller = null; } $handlers = $this->handlers; $this->handlers = []; $this->result = $result; foreach ($handlers as $handler) { $handler($result); } // Forward cancellation to rejected promise to avoid reporting unhandled rejection if ($this->cancelled && $result instanceof RejectedPromise) { $result->cancel(); } } /** * @param PromiseInterface<T> $promise * @return PromiseInterface<T> */ private function unwrap(PromiseInterface $promise) : PromiseInterface { while ($promise instanceof self && null !== $promise->result) { /** @var PromiseInterface<T> $promise */ $promise = $promise->result; } return $promise; } /** * @param callable(callable(mixed):void,callable(\Throwable):void):void $cb */ private function call(callable $cb) : void { // Explicitly overwrite argument with null value. This ensure that this // argument does not show up in the stack trace in PHP 7+ only. $callback = $cb; $cb = null; // Use reflection to inspect number of arguments expected by this callback. // We did some careful benchmarking here: Using reflection to avoid unneeded // function arguments is actually faster than blindly passing them. // Also, this helps avoiding unnecessary function arguments in the call stack // if the callback creates an Exception (creating garbage cycles). if (\is_array($callback)) { $ref = new \ReflectionMethod($callback[0], $callback[1]); } elseif (\is_object($callback) && !$callback instanceof \Closure) { $ref = new \ReflectionMethod($callback, '__invoke'); } else { \assert($callback instanceof \Closure || \is_string($callback)); $ref = new \ReflectionFunction($callback); } $args = $ref->getNumberOfParameters(); try { if ($args === 0) { $callback(); } else { // Keep references to this promise instance for the static resolve/reject functions. // By using static callbacks that are not bound to this instance // and passing the target promise instance by reference, we can // still execute its resolving logic and still clear this // reference when settling the promise. This helps avoiding // garbage cycles if any callback creates an Exception. // These assumptions are covered by the test suite, so if you ever feel like // refactoring this, go ahead, any alternative suggestions are welcome! $target =& $this; $callback(static function ($value) use(&$target) : void { if ($target !== null) { $target->settle(resolve($value)); $target = null; } }, static function (\Throwable $reason) use(&$target) : void { if ($target !== null) { $target->reject($reason); $target = null; } }); } } catch (\Throwable $e) { $target = null; $this->reject($e); } } } <?php namespace _PHPStan_7d8742a37\React\Promise; use _PHPStan_7d8742a37\React\Promise\Exception\CompositeException; use _PHPStan_7d8742a37\React\Promise\Internal\FulfilledPromise; use _PHPStan_7d8742a37\React\Promise\Internal\RejectedPromise; /** * Creates a promise for the supplied `$promiseOrValue`. * * If `$promiseOrValue` is a value, it will be the resolution value of the * returned promise. * * If `$promiseOrValue` is a thenable (any object that provides a `then()` method), * a trusted promise that follows the state of the thenable is returned. * * If `$promiseOrValue` is a promise, it will be returned as is. * * @template T * @param PromiseInterface<T>|T $promiseOrValue * @return PromiseInterface<T> */ function resolve($promiseOrValue) : PromiseInterface { if ($promiseOrValue instanceof PromiseInterface) { return $promiseOrValue; } if (\is_object($promiseOrValue) && \method_exists($promiseOrValue, 'then')) { $canceller = null; if (\method_exists($promiseOrValue, 'cancel')) { $canceller = [$promiseOrValue, 'cancel']; \assert(\is_callable($canceller)); } /** @var Promise<T> */ return new Promise(function (callable $resolve, callable $reject) use($promiseOrValue) : void { $promiseOrValue->then($resolve, $reject); }, $canceller); } return new FulfilledPromise($promiseOrValue); } /** * Creates a rejected promise for the supplied `$reason`. * * If `$reason` is a value, it will be the rejection value of the * returned promise. * * If `$reason` is a promise, its completion value will be the rejected * value of the returned promise. * * This can be useful in situations where you need to reject a promise without * throwing an exception. For example, it allows you to propagate a rejection with * the value of another promise. * * @return PromiseInterface<never> */ function reject(\Throwable $reason) : PromiseInterface { return new RejectedPromise($reason); } /** * Returns a promise that will resolve only once all the items in * `$promisesOrValues` have resolved. The resolution value of the returned promise * will be an array containing the resolution values of each of the items in * `$promisesOrValues`. * * @template T * @param iterable<PromiseInterface<T>|T> $promisesOrValues * @return PromiseInterface<array<T>> */ function all(iterable $promisesOrValues) : PromiseInterface { $cancellationQueue = new Internal\CancellationQueue(); /** @var Promise<array<T>> */ return new Promise(function (callable $resolve, callable $reject) use($promisesOrValues, $cancellationQueue) : void { $toResolve = 0; /** @var bool */ $continue = \true; $values = []; foreach ($promisesOrValues as $i => $promiseOrValue) { $cancellationQueue->enqueue($promiseOrValue); $values[$i] = null; ++$toResolve; resolve($promiseOrValue)->then(function ($value) use($i, &$values, &$toResolve, &$continue, $resolve) : void { $values[$i] = $value; if (0 === --$toResolve && !$continue) { $resolve($values); } }, function (\Throwable $reason) use(&$continue, $reject) : void { $continue = \false; $reject($reason); }); if (!$continue && !\is_array($promisesOrValues)) { break; } } $continue = \false; if ($toResolve === 0) { $resolve($values); } }, $cancellationQueue); } /** * Initiates a competitive race that allows one winner. Returns a promise which is * resolved in the same way the first settled promise resolves. * * The returned promise will become **infinitely pending** if `$promisesOrValues` * contains 0 items. * * @template T * @param iterable<PromiseInterface<T>|T> $promisesOrValues * @return PromiseInterface<T> */ function race(iterable $promisesOrValues) : PromiseInterface { $cancellationQueue = new Internal\CancellationQueue(); /** @var Promise<T> */ return new Promise(function (callable $resolve, callable $reject) use($promisesOrValues, $cancellationQueue) : void { $continue = \true; foreach ($promisesOrValues as $promiseOrValue) { $cancellationQueue->enqueue($promiseOrValue); resolve($promiseOrValue)->then($resolve, $reject)->finally(function () use(&$continue) : void { $continue = \false; }); if (!$continue && !\is_array($promisesOrValues)) { break; } } }, $cancellationQueue); } /** * Returns a promise that will resolve when any one of the items in * `$promisesOrValues` resolves. The resolution value of the returned promise * will be the resolution value of the triggering item. * * The returned promise will only reject if *all* items in `$promisesOrValues` are * rejected. The rejection value will be an array of all rejection reasons. * * The returned promise will also reject with a `React\Promise\Exception\LengthException` * if `$promisesOrValues` contains 0 items. * * @template T * @param iterable<PromiseInterface<T>|T> $promisesOrValues * @return PromiseInterface<T> */ function any(iterable $promisesOrValues) : PromiseInterface { $cancellationQueue = new Internal\CancellationQueue(); /** @var Promise<T> */ return new Promise(function (callable $resolve, callable $reject) use($promisesOrValues, $cancellationQueue) : void { $toReject = 0; $continue = \true; $reasons = []; foreach ($promisesOrValues as $i => $promiseOrValue) { $cancellationQueue->enqueue($promiseOrValue); ++$toReject; resolve($promiseOrValue)->then(function ($value) use($resolve, &$continue) : void { $continue = \false; $resolve($value); }, function (\Throwable $reason) use($i, &$reasons, &$toReject, $reject, &$continue) : void { $reasons[$i] = $reason; if (0 === --$toReject && !$continue) { $reject(new CompositeException($reasons, 'All promises rejected.')); } }); if (!$continue && !\is_array($promisesOrValues)) { break; } } $continue = \false; if ($toReject === 0 && !$reasons) { $reject(new Exception\LengthException('Must contain at least 1 item but contains only 0 items.')); } elseif ($toReject === 0) { $reject(new CompositeException($reasons, 'All promises rejected.')); } }, $cancellationQueue); } /** * Sets the global rejection handler for unhandled promise rejections. * * Note that rejected promises should always be handled similar to how any * exceptions should always be caught in a `try` + `catch` block. If you remove * the last reference to a rejected promise that has not been handled, it will * report an unhandled promise rejection. See also the [`reject()` function](#reject) * for more details. * * The `?callable $callback` argument MUST be a valid callback function that * accepts a single `Throwable` argument or a `null` value to restore the * default promise rejection handler. The return value of the callback function * will be ignored and has no effect, so you SHOULD return a `void` value. The * callback function MUST NOT throw or the program will be terminated with a * fatal error. * * The function returns the previous rejection handler or `null` if using the * default promise rejection handler. * * The default promise rejection handler will log an error message plus its * stack trace: * * ```php * // Unhandled promise rejection with RuntimeException: Unhandled in example.php:2 * React\Promise\reject(new RuntimeException('Unhandled')); * ``` * * The promise rejection handler may be used to use customize the log message or * write to custom log targets. As a rule of thumb, this function should only be * used as a last resort and promise rejections are best handled with either the * [`then()` method](#promiseinterfacethen), the * [`catch()` method](#promiseinterfacecatch), or the * [`finally()` method](#promiseinterfacefinally). * See also the [`reject()` function](#reject) for more details. * * @param callable(\Throwable):void|null $callback * @return callable(\Throwable):void|null */ function set_rejection_handler(?callable $callback) : ?callable { static $current = null; $previous = $current; $current = $callback; return $previous; } /** * @internal */ function _checkTypehint(callable $callback, \Throwable $reason) : bool { if (\is_array($callback)) { $callbackReflection = new \ReflectionMethod($callback[0], $callback[1]); } elseif (\is_object($callback) && !$callback instanceof \Closure) { $callbackReflection = new \ReflectionMethod($callback, '__invoke'); } else { \assert($callback instanceof \Closure || \is_string($callback)); $callbackReflection = new \ReflectionFunction($callback); } $parameters = $callbackReflection->getParameters(); if (!isset($parameters[0])) { return \true; } $expectedException = $parameters[0]; // Extract the type of the argument and handle different possibilities $type = $expectedException->getType(); $isTypeUnion = \true; $types = []; switch (\true) { case $type === null: break; case $type instanceof \ReflectionNamedType: $types = [$type]; break; case $type instanceof \ReflectionIntersectionType: $isTypeUnion = \false; case $type instanceof \ReflectionUnionType: $types = $type->getTypes(); break; default: throw new \LogicException('Unexpected return value of ReflectionParameter::getType'); } // If there is no type restriction, it matches if (empty($types)) { return \true; } foreach ($types as $type) { if ($type instanceof \ReflectionIntersectionType) { foreach ($type->getTypes() as $typeToMatch) { \assert($typeToMatch instanceof \ReflectionNamedType); $name = $typeToMatch->getName(); if (!($matches = !$typeToMatch->isBuiltin() && $reason instanceof $name)) { break; } } \assert(isset($matches)); } else { \assert($type instanceof \ReflectionNamedType); $name = $type->getName(); $matches = !$type->isBuiltin() && $reason instanceof $name; } // If we look for a single match (union), we can return early on match // If we look for a full match (intersection), we can return early on mismatch if ($matches) { if ($isTypeUnion) { return \true; } } else { if (!$isTypeUnion) { return \false; } } } // If we look for a single match (union) and did not return early, we matched no type and are false // If we look for a full match (intersection) and did not return early, we matched all types and are true return $isTypeUnion ? \false : \true; } The MIT License (MIT) Copyright (c) 2012 Christian Lück, Cees-Jan Kiewiet, Jan Sorgalla, Chris Boden, Igor Wiedler Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. <?php namespace _PHPStan_7d8742a37\React\Cache; use _PHPStan_7d8742a37\React\Promise; use _PHPStan_7d8742a37\React\Promise\PromiseInterface; class ArrayCache implements CacheInterface { private $limit; private $data = array(); private $expires = array(); private $supportsHighResolution; /** * The `ArrayCache` provides an in-memory implementation of the [`CacheInterface`](#cacheinterface). * * ```php * $cache = new ArrayCache(); * * $cache->set('foo', 'bar'); * ``` * * Its constructor accepts an optional `?int $limit` parameter to limit the * maximum number of entries to store in the LRU cache. If you add more * entries to this instance, it will automatically take care of removing * the one that was least recently used (LRU). * * For example, this snippet will overwrite the first value and only store * the last two entries: * * ```php * $cache = new ArrayCache(2); * * $cache->set('foo', '1'); * $cache->set('bar', '2'); * $cache->set('baz', '3'); * ``` * * This cache implementation is known to rely on wall-clock time to schedule * future cache expiration times when using any version before PHP 7.3, * because a monotonic time source is only available as of PHP 7.3 (`hrtime()`). * While this does not affect many common use cases, this is an important * distinction for programs that rely on a high time precision or on systems * that are subject to discontinuous time adjustments (time jumps). * This means that if you store a cache item with a TTL of 30s on PHP < 7.3 * and then adjust your system time forward by 20s, the cache item may * expire in 10s. See also [`set()`](#set) for more details. * * @param int|null $limit maximum number of entries to store in the LRU cache */ public function __construct($limit = null) { $this->limit = $limit; // prefer high-resolution timer, available as of PHP 7.3+ $this->supportsHighResolution = \function_exists('hrtime'); } public function get($key, $default = null) { // delete key if it is already expired => below will detect this as a cache miss if (isset($this->expires[$key]) && $this->now() - $this->expires[$key] > 0) { unset($this->data[$key], $this->expires[$key]); } if (!\array_key_exists($key, $this->data)) { return Promise\resolve($default); } // remove and append to end of array to keep track of LRU info $value = $this->data[$key]; unset($this->data[$key]); $this->data[$key] = $value; return Promise\resolve($value); } public function set($key, $value, $ttl = null) { // unset before setting to ensure this entry will be added to end of array (LRU info) unset($this->data[$key]); $this->data[$key] = $value; // sort expiration times if TTL is given (first will expire first) unset($this->expires[$key]); if ($ttl !== null) { $this->expires[$key] = $this->now() + $ttl; \asort($this->expires); } // ensure size limit is not exceeded or remove first entry from array if ($this->limit !== null && \count($this->data) > $this->limit) { // first try to check if there's any expired entry // expiration times are sorted, so we can simply look at the first one \reset($this->expires); $key = \key($this->expires); // check to see if the first in the list of expiring keys is already expired // if the first key is not expired, we have to overwrite by using LRU info if ($key === null || $this->now() - $this->expires[$key] < 0) { \reset($this->data); $key = \key($this->data); } unset($this->data[$key], $this->expires[$key]); } return Promise\resolve(\true); } public function delete($key) { unset($this->data[$key], $this->expires[$key]); return Promise\resolve(\true); } public function getMultiple(array $keys, $default = null) { $values = array(); foreach ($keys as $key) { $values[$key] = $this->get($key, $default); } return Promise\all($values); } public function setMultiple(array $values, $ttl = null) { foreach ($values as $key => $value) { $this->set($key, $value, $ttl); } return Promise\resolve(\true); } public function deleteMultiple(array $keys) { foreach ($keys as $key) { unset($this->data[$key], $this->expires[$key]); } return Promise\resolve(\true); } public function clear() { $this->data = array(); $this->expires = array(); return Promise\resolve(\true); } public function has($key) { // delete key if it is already expired if (isset($this->expires[$key]) && $this->now() - $this->expires[$key] > 0) { unset($this->data[$key], $this->expires[$key]); } if (!\array_key_exists($key, $this->data)) { return Promise\resolve(\false); } // remove and append to end of array to keep track of LRU info $value = $this->data[$key]; unset($this->data[$key]); $this->data[$key] = $value; return Promise\resolve(\true); } /** * @return float */ private function now() { return $this->supportsHighResolution ? \hrtime(\true) * 1.0E-9 : \microtime(\true); } } <?php namespace _PHPStan_7d8742a37\React\Cache; use _PHPStan_7d8742a37\React\Promise\PromiseInterface; interface CacheInterface { /** * Retrieves an item from the cache. * * This method will resolve with the cached value on success or with the * given `$default` value when no item can be found or when an error occurs. * Similarly, an expired cache item (once the time-to-live is expired) is * considered a cache miss. * * ```php * $cache * ->get('foo') * ->then('var_dump'); * ``` * * This example fetches the value of the key `foo` and passes it to the * `var_dump` function. You can use any of the composition provided by * [promises](https://github.com/reactphp/promise). * * @param string $key * @param mixed $default Default value to return for cache miss or null if not given. * @return PromiseInterface<mixed> */ public function get($key, $default = null); /** * Stores an item in the cache. * * This method will resolve with `true` on success or `false` when an error * occurs. If the cache implementation has to go over the network to store * it, it may take a while. * * The optional `$ttl` parameter sets the maximum time-to-live in seconds * for this cache item. If this parameter is omitted (or `null`), the item * will stay in the cache for as long as the underlying implementation * supports. Trying to access an expired cache item results in a cache miss, * see also [`get()`](#get). * * ```php * $cache->set('foo', 'bar', 60); * ``` * * This example eventually sets the value of the key `foo` to `bar`. If it * already exists, it is overridden. * * This interface does not enforce any particular TTL resolution, so special * care may have to be taken if you rely on very high precision with * millisecond accuracy or below. Cache implementations SHOULD work on a * best effort basis and SHOULD provide at least second accuracy unless * otherwise noted. Many existing cache implementations are known to provide * microsecond or millisecond accuracy, but it's generally not recommended * to rely on this high precision. * * This interface suggests that cache implementations SHOULD use a monotonic * time source if available. Given that a monotonic time source is only * available as of PHP 7.3 by default, cache implementations MAY fall back * to using wall-clock time. * While this does not affect many common use cases, this is an important * distinction for programs that rely on a high time precision or on systems * that are subject to discontinuous time adjustments (time jumps). * This means that if you store a cache item with a TTL of 30s and then * adjust your system time forward by 20s, the cache item SHOULD still * expire in 30s. * * @param string $key * @param mixed $value * @param ?float $ttl * @return PromiseInterface<bool> Returns a promise which resolves to `true` on success or `false` on error */ public function set($key, $value, $ttl = null); /** * Deletes an item from the cache. * * This method will resolve with `true` on success or `false` when an error * occurs. When no item for `$key` is found in the cache, it also resolves * to `true`. If the cache implementation has to go over the network to * delete it, it may take a while. * * ```php * $cache->delete('foo'); * ``` * * This example eventually deletes the key `foo` from the cache. As with * `set()`, this may not happen instantly and a promise is returned to * provide guarantees whether or not the item has been removed from cache. * * @param string $key * @return PromiseInterface<bool> Returns a promise which resolves to `true` on success or `false` on error */ public function delete($key); /** * Retrieves multiple cache items by their unique keys. * * This method will resolve with an array of cached values on success or with the * given `$default` value when an item can not be found or when an error occurs. * Similarly, an expired cache item (once the time-to-live is expired) is * considered a cache miss. * * ```php * $cache->getMultiple(array('name', 'age'))->then(function (array $values) { * $name = $values['name'] ?? 'User'; * $age = $values['age'] ?? 'n/a'; * * echo $name . ' is ' . $age . PHP_EOL; * }); * ``` * * This example fetches the cache items for the `name` and `age` keys and * prints some example output. You can use any of the composition provided * by [promises](https://github.com/reactphp/promise). * * @param string[] $keys A list of keys that can obtained in a single operation. * @param mixed $default Default value to return for keys that do not exist. * @return PromiseInterface<array> Returns a promise which resolves to an `array` of cached values */ public function getMultiple(array $keys, $default = null); /** * Persists a set of key => value pairs in the cache, with an optional TTL. * * This method will resolve with `true` on success or `false` when an error * occurs. If the cache implementation has to go over the network to store * it, it may take a while. * * The optional `$ttl` parameter sets the maximum time-to-live in seconds * for these cache items. If this parameter is omitted (or `null`), these items * will stay in the cache for as long as the underlying implementation * supports. Trying to access an expired cache items results in a cache miss, * see also [`get()`](#get). * * ```php * $cache->setMultiple(array('foo' => 1, 'bar' => 2), 60); * ``` * * This example eventually sets the list of values - the key `foo` to 1 value * and the key `bar` to 2. If some of the keys already exist, they are overridden. * * @param array $values A list of key => value pairs for a multiple-set operation. * @param ?float $ttl Optional. The TTL value of this item. * @return PromiseInterface<bool> Returns a promise which resolves to `true` on success or `false` on error */ public function setMultiple(array $values, $ttl = null); /** * Deletes multiple cache items in a single operation. * * @param string[] $keys A list of string-based keys to be deleted. * @return PromiseInterface<bool> Returns a promise which resolves to `true` on success or `false` on error */ public function deleteMultiple(array $keys); /** * Wipes clean the entire cache. * * @return PromiseInterface<bool> Returns a promise which resolves to `true` on success or `false` on error */ public function clear(); /** * Determines whether an item is present in the cache. * * This method will resolve with `true` on success or `false` when no item can be found * or when an error occurs. Similarly, an expired cache item (once the time-to-live * is expired) is considered a cache miss. * * ```php * $cache * ->has('foo') * ->then('var_dump'); * ``` * * This example checks if the value of the key `foo` is set in the cache and passes * the result to the `var_dump` function. You can use any of the composition provided by * [promises](https://github.com/reactphp/promise). * * NOTE: It is recommended that has() is only to be used for cache warming type purposes * and not to be used within your live applications operations for get/set, as this method * is subject to a race condition where your has() will return true and immediately after, * another script can remove it making the state of your app out of date. * * @param string $key The cache item key. * @return PromiseInterface<bool> Returns a promise which resolves to `true` on success or `false` on error */ public function has($key); } The MIT License (MIT) Copyright (c) 2012 Christian Lück, Cees-Jan Kiewiet, Jan Sorgalla, Chris Boden, Igor Wiedler Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. <?php namespace _PHPStan_7d8742a37\React\ChildProcess; use _PHPStan_7d8742a37\Evenement\EventEmitter; use _PHPStan_7d8742a37\React\EventLoop\Loop; use _PHPStan_7d8742a37\React\EventLoop\LoopInterface; use _PHPStan_7d8742a37\React\Stream\ReadableResourceStream; use _PHPStan_7d8742a37\React\Stream\ReadableStreamInterface; use _PHPStan_7d8742a37\React\Stream\WritableResourceStream; use _PHPStan_7d8742a37\React\Stream\WritableStreamInterface; use _PHPStan_7d8742a37\React\Stream\DuplexResourceStream; use _PHPStan_7d8742a37\React\Stream\DuplexStreamInterface; /** * Process component. * * This class also implements the `EventEmitterInterface` * which allows you to react to certain events: * * exit event: * The `exit` event will be emitted whenever the process is no longer running. * Event listeners will receive the exit code and termination signal as two * arguments: * * ```php * $process = new Process('sleep 10'); * $process->start(); * * $process->on('exit', function ($code, $term) { * if ($term === null) { * echo 'exit with code ' . $code . PHP_EOL; * } else { * echo 'terminated with signal ' . $term . PHP_EOL; * } * }); * ``` * * Note that `$code` is `null` if the process has terminated, but the exit * code could not be determined. * Similarly, `$term` is `null` unless the process has terminated in response to * an uncaught signal sent to it. * This is not a limitation of this project, but actual how exit codes and signals * are exposed on POSIX systems, for more details see also * [here](https://unix.stackexchange.com/questions/99112/default-exit-code-when-process-is-terminated). * * It's also worth noting that process termination depends on all file descriptors * being closed beforehand. * This means that all [process pipes](#stream-properties) will emit a `close` * event before the `exit` event and that no more `data` events will arrive after * the `exit` event. * Accordingly, if either of these pipes is in a paused state (`pause()` method * or internally due to a `pipe()` call), this detection may not trigger. */ class Process extends EventEmitter { /** * @var WritableStreamInterface|null|DuplexStreamInterface|ReadableStreamInterface */ public $stdin; /** * @var ReadableStreamInterface|null|DuplexStreamInterface|WritableStreamInterface */ public $stdout; /** * @var ReadableStreamInterface|null|DuplexStreamInterface|WritableStreamInterface */ public $stderr; /** * Array with all process pipes (once started) * * Unless explicitly configured otherwise during construction, the following * standard I/O pipes will be assigned by default: * - 0: STDIN (`WritableStreamInterface`) * - 1: STDOUT (`ReadableStreamInterface`) * - 2: STDERR (`ReadableStreamInterface`) * * @var array<ReadableStreamInterface|WritableStreamInterface|DuplexStreamInterface> */ public $pipes = array(); private $cmd; private $cwd; private $env; private $fds; private $process; private $status; private $exitCode; private $fallbackExitCode; private $stopSignal; private $termSignal; /** * Constructor. * * @param string $cmd Command line to run * @param null|string $cwd Current working directory or null to inherit * @param null|array $env Environment variables or null to inherit * @param null|array $fds File descriptors to allocate for this process (or null = default STDIO streams) * @throws \LogicException On windows or when proc_open() is not installed */ public function __construct($cmd, $cwd = null, $env = null, $fds = null) { if ($env !== null && !\is_array($env)) { // manual type check to support legacy PHP < 7.1 throw new \InvalidArgumentException('Argument #3 ($env) expected null|array'); } if ($fds !== null && !\is_array($fds)) { // manual type check to support legacy PHP < 7.1 throw new \InvalidArgumentException('Argument #4 ($fds) expected null|array'); } if (!\function_exists('proc_open')) { throw new \LogicException('The Process class relies on proc_open(), which is not available on your PHP installation.'); } $this->cmd = $cmd; $this->cwd = $cwd; if (null !== $env) { $this->env = array(); foreach ($env as $key => $value) { $this->env[(string) $key] = (string) $value; } } if ($fds === null) { $fds = array( array('pipe', 'r'), // stdin array('pipe', 'w'), // stdout array('pipe', 'w'), ); } if (\DIRECTORY_SEPARATOR === '\\') { foreach ($fds as $fd) { if (isset($fd[0]) && $fd[0] === 'pipe') { throw new \LogicException('Process pipes are not supported on Windows due to their blocking nature on Windows'); } } } $this->fds = $fds; } /** * Start the process. * * After the process is started, the standard I/O streams will be constructed * and available via public properties. * * This method takes an optional `LoopInterface|null $loop` parameter that can be used to * pass the event loop instance to use for this process. You can use a `null` value * here in order to use the [default loop](https://github.com/reactphp/event-loop#loop). * This value SHOULD NOT be given unless you're sure you want to explicitly use a * given event loop instance. * * @param ?LoopInterface $loop Loop interface for stream construction * @param float $interval Interval to periodically monitor process state (seconds) * @throws \RuntimeException If the process is already running or fails to start */ public function start($loop = null, $interval = 0.1) { if ($loop !== null && !$loop instanceof LoopInterface) { // manual type check to support legacy PHP < 7.1 throw new \InvalidArgumentException('_PHPStan_7d8742a37\\Argument #1 ($loop) expected null|React\\EventLoop\\LoopInterface'); } if ($this->isRunning()) { throw new \RuntimeException('Process is already running'); } $loop = $loop ?: Loop::get(); $cmd = $this->cmd; $fdSpec = $this->fds; // on Windows, we do not launch the given command line in a shell (cmd.exe) by default and omit any error dialogs // the cmd.exe shell can explicitly be given as part of the command as detailed in both documentation and tests $options = array(); if (\DIRECTORY_SEPARATOR === '\\') { $options['bypass_shell'] = \true; $options['suppress_errors'] = \true; } $errstr = ''; \set_error_handler(function ($_, $error) use(&$errstr) { // Match errstr from PHP's warning message. // proc_open(/dev/does-not-exist): Failed to open stream: No such file or directory $errstr = $error; }); $pipes = array(); $this->process = @\proc_open($cmd, $fdSpec, $pipes, $this->cwd, $this->env, $options); \restore_error_handler(); if (!\is_resource($this->process)) { throw new \RuntimeException('Unable to launch a new process: ' . $errstr); } // count open process pipes and await close event for each to drain buffers before detecting exit $that = $this; $closeCount = 0; $streamCloseHandler = function () use(&$closeCount, $loop, $interval, $that) { $closeCount--; if ($closeCount > 0) { return; } // process already closed => report immediately if (!$that->isRunning()) { $that->close(); $that->emit('exit', array($that->getExitCode(), $that->getTermSignal())); return; } // close not detected immediately => check regularly $loop->addPeriodicTimer($interval, function ($timer) use($that, $loop) { if (!$that->isRunning()) { $loop->cancelTimer($timer); $that->close(); $that->emit('exit', array($that->getExitCode(), $that->getTermSignal())); } }); }; foreach ($pipes as $n => $fd) { // use open mode from stream meta data or fall back to pipe open mode for legacy HHVM $meta = \stream_get_meta_data($fd); $mode = $meta['mode'] === '' ? $this->fds[$n][1] === 'r' ? 'w' : 'r' : $meta['mode']; if ($mode === 'r+') { $stream = new DuplexResourceStream($fd, $loop); $stream->on('close', $streamCloseHandler); $closeCount++; } elseif ($mode === 'w') { $stream = new WritableResourceStream($fd, $loop); } else { $stream = new ReadableResourceStream($fd, $loop); $stream->on('close', $streamCloseHandler); $closeCount++; } $this->pipes[$n] = $stream; } $this->stdin = isset($this->pipes[0]) ? $this->pipes[0] : null; $this->stdout = isset($this->pipes[1]) ? $this->pipes[1] : null; $this->stderr = isset($this->pipes[2]) ? $this->pipes[2] : null; // immediately start checking for process exit when started without any I/O pipes if (!$closeCount) { $streamCloseHandler(); } } /** * Close the process. * * This method should only be invoked via the periodic timer that monitors * the process state. */ public function close() { if ($this->process === null) { return; } foreach ($this->pipes as $pipe) { $pipe->close(); } $exitCode = \proc_close($this->process); $this->process = null; if ($this->exitCode === null && $exitCode !== -1) { $this->exitCode = $exitCode; } if ($this->exitCode === null && $this->status['exitcode'] !== -1) { $this->exitCode = $this->status['exitcode']; } if ($this->exitCode === null && $this->fallbackExitCode !== null) { $this->exitCode = $this->fallbackExitCode; $this->fallbackExitCode = null; } } /** * Terminate the process with an optional signal. * * @param int $signal Optional signal (default: SIGTERM) * @return bool Whether the signal was sent successfully */ public function terminate($signal = null) { if ($this->process === null) { return \false; } if ($signal !== null) { return \proc_terminate($this->process, $signal); } return \proc_terminate($this->process); } /** * Get the command string used to launch the process. * * @return string */ public function getCommand() { return $this->cmd; } /** * Get the exit code returned by the process. * * This value is only meaningful if isRunning() has returned false. Null * will be returned if the process is still running. * * Null may also be returned if the process has terminated, but the exit * code could not be determined. * * @return int|null */ public function getExitCode() { return $this->exitCode; } /** * Get the process ID. * * @return int|null */ public function getPid() { $status = $this->getCachedStatus(); return $status !== null ? $status['pid'] : null; } /** * Get the signal that caused the process to stop its execution. * * This value is only meaningful if isStopped() has returned true. Null will * be returned if the process was never stopped. * * @return int|null */ public function getStopSignal() { return $this->stopSignal; } /** * Get the signal that caused the process to terminate its execution. * * This value is only meaningful if isTerminated() has returned true. Null * will be returned if the process was never terminated. * * @return int|null */ public function getTermSignal() { return $this->termSignal; } /** * Return whether the process is still running. * * @return bool */ public function isRunning() { if ($this->process === null) { return \false; } $status = $this->getFreshStatus(); return $status !== null ? $status['running'] : \false; } /** * Return whether the process has been stopped by a signal. * * @return bool */ public function isStopped() { $status = $this->getFreshStatus(); return $status !== null ? $status['stopped'] : \false; } /** * Return whether the process has been terminated by an uncaught signal. * * @return bool */ public function isTerminated() { $status = $this->getFreshStatus(); return $status !== null ? $status['signaled'] : \false; } /** * Return the cached process status. * * @return array */ private function getCachedStatus() { if ($this->status === null) { $this->updateStatus(); } return $this->status; } /** * Return the updated process status. * * @return array */ private function getFreshStatus() { $this->updateStatus(); return $this->status; } /** * Update the process status, stop/term signals, and exit code. * * Stop/term signals are only updated if the process is currently stopped or * signaled, respectively. Otherwise, signal values will remain as-is so the * corresponding getter methods may be used at a later point in time. */ private function updateStatus() { if ($this->process === null) { return; } $this->status = \proc_get_status($this->process); if ($this->status === \false) { throw new \UnexpectedValueException('proc_get_status() failed'); } if ($this->status['stopped']) { $this->stopSignal = $this->status['stopsig']; } if ($this->status['signaled']) { $this->termSignal = $this->status['termsig']; } if (!$this->status['running'] && -1 !== $this->status['exitcode']) { $this->exitCode = $this->status['exitcode']; } } } The MIT License (MIT) Copyright (c) 2012 Christian Lück, Cees-Jan Kiewiet, Jan Sorgalla, Chris Boden, Igor Wiedler Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. <?php namespace _PHPStan_7d8742a37\React\Socket; use _PHPStan_7d8742a37\Evenement\EventEmitter; use _PHPStan_7d8742a37\React\EventLoop\Loop; use _PHPStan_7d8742a37\React\EventLoop\LoopInterface; /** * [Internal] The `FdServer` class implements the `ServerInterface` and * is responsible for accepting connections from an existing file descriptor. * * ```php * $socket = new React\Socket\FdServer(3); * ``` * * Whenever a client connects, it will emit a `connection` event with a connection * instance implementing `ConnectionInterface`: * * ```php * $socket->on('connection', function (ConnectionInterface $connection) { * echo 'Plaintext connection from ' . $connection->getRemoteAddress() . PHP_EOL; * $connection->write('hello there!' . PHP_EOL); * … * }); * ``` * * See also the `ServerInterface` for more details. * * @see ServerInterface * @see ConnectionInterface * @internal */ final class FdServer extends EventEmitter implements ServerInterface { private $master; private $loop; private $unix = \false; private $listening = \false; /** * Creates a socket server and starts listening on the given file descriptor * * This starts accepting new incoming connections on the given file descriptor. * See also the `connection event` documented in the `ServerInterface` * for more details. * * ```php * $socket = new React\Socket\FdServer(3); * ``` * * If the given FD is invalid or out of range, it will throw an `InvalidArgumentException`: * * ```php * // throws InvalidArgumentException * $socket = new React\Socket\FdServer(-1); * ``` * * If the given FD appears to be valid, but listening on it fails (such as * if the FD does not exist or does not refer to a socket server), it will * throw a `RuntimeException`: * * ```php * // throws RuntimeException because FD does not reference a socket server * $socket = new React\Socket\FdServer(0, $loop); * ``` * * Note that these error conditions may vary depending on your system and/or * configuration. * See the exception message and code for more details about the actual error * condition. * * @param int|string $fd FD number such as `3` or as URL in the form of `php://fd/3` * @param ?LoopInterface $loop * @throws \InvalidArgumentException if the listening address is invalid * @throws \RuntimeException if listening on this address fails (already in use etc.) */ public function __construct($fd, $loop = null) { if (\preg_match('#^php://fd/(\\d+)$#', $fd, $m)) { $fd = (int) $m[1]; } if (!\is_int($fd) || $fd < 0 || $fd >= \PHP_INT_MAX) { throw new \InvalidArgumentException('Invalid FD number given (EINVAL)', \defined('SOCKET_EINVAL') ? \SOCKET_EINVAL : (\defined('PCNTL_EINVAL') ? \PCNTL_EINVAL : 22)); } if ($loop !== null && !$loop instanceof LoopInterface) { // manual type check to support legacy PHP < 7.1 throw new \InvalidArgumentException('_PHPStan_7d8742a37\\Argument #2 ($loop) expected null|React\\EventLoop\\LoopInterface'); } $this->loop = $loop ?: Loop::get(); $errno = 0; $errstr = ''; \set_error_handler(function ($_, $error) use(&$errno, &$errstr) { // Match errstr from PHP's warning message. // fopen(php://fd/3): Failed to open stream: Error duping file descriptor 3; possibly it doesn't exist: [9]: Bad file descriptor \preg_match('/\\[(\\d+)\\]: (.*)/', $error, $m); $errno = isset($m[1]) ? (int) $m[1] : 0; $errstr = isset($m[2]) ? $m[2] : $error; }); $this->master = \fopen('php://fd/' . $fd, 'r+'); \restore_error_handler(); if (\false === $this->master) { throw new \RuntimeException('Failed to listen on FD ' . $fd . ': ' . $errstr . SocketServer::errconst($errno), $errno); } $meta = \stream_get_meta_data($this->master); if (!isset($meta['stream_type']) || $meta['stream_type'] !== 'tcp_socket') { \fclose($this->master); $errno = \defined('SOCKET_ENOTSOCK') ? \SOCKET_ENOTSOCK : 88; $errstr = \function_exists('socket_strerror') ? \socket_strerror($errno) : 'Not a socket'; throw new \RuntimeException('Failed to listen on FD ' . $fd . ': ' . $errstr . ' (ENOTSOCK)', $errno); } // Socket should not have a peer address if this is a listening socket. // Looks like this work-around is the closest we can get because PHP doesn't expose SO_ACCEPTCONN even with ext-sockets. if (\stream_socket_get_name($this->master, \true) !== \false) { \fclose($this->master); $errno = \defined('SOCKET_EISCONN') ? \SOCKET_EISCONN : 106; $errstr = \function_exists('socket_strerror') ? \socket_strerror($errno) : 'Socket is connected'; throw new \RuntimeException('Failed to listen on FD ' . $fd . ': ' . $errstr . ' (EISCONN)', $errno); } // Assume this is a Unix domain socket (UDS) when its listening address doesn't parse as a valid URL with a port. // Looks like this work-around is the closest we can get because PHP doesn't expose SO_DOMAIN even with ext-sockets. $this->unix = \parse_url($this->getAddress(), \PHP_URL_PORT) === \false; \stream_set_blocking($this->master, \false); $this->resume(); } public function getAddress() { if (!\is_resource($this->master)) { return null; } $address = \stream_socket_get_name($this->master, \false); if ($this->unix === \true) { return 'unix://' . $address; } // check if this is an IPv6 address which includes multiple colons but no square brackets $pos = \strrpos($address, ':'); if ($pos !== \false && \strpos($address, ':') < $pos && \substr($address, 0, 1) !== '[') { $address = '[' . \substr($address, 0, $pos) . ']:' . \substr($address, $pos + 1); // @codeCoverageIgnore } return 'tcp://' . $address; } public function pause() { if (!$this->listening) { return; } $this->loop->removeReadStream($this->master); $this->listening = \false; } public function resume() { if ($this->listening || !\is_resource($this->master)) { return; } $that = $this; $this->loop->addReadStream($this->master, function ($master) use($that) { try { $newSocket = SocketServer::accept($master); } catch (\RuntimeException $e) { $that->emit('error', array($e)); return; } $that->handleConnection($newSocket); }); $this->listening = \true; } public function close() { if (!\is_resource($this->master)) { return; } $this->pause(); \fclose($this->master); $this->removeAllListeners(); } /** @internal */ public function handleConnection($socket) { $connection = new Connection($socket, $this->loop); $connection->unix = $this->unix; $this->emit('connection', array($connection)); } } <?php namespace _PHPStan_7d8742a37\React\Socket; use _PHPStan_7d8742a37\React\EventLoop\Loop; use _PHPStan_7d8742a37\React\EventLoop\LoopInterface; use _PHPStan_7d8742a37\React\Promise; use BadMethodCallException; use InvalidArgumentException; use UnexpectedValueException; final class SecureConnector implements ConnectorInterface { private $connector; private $streamEncryption; private $context; /** * @param ConnectorInterface $connector * @param ?LoopInterface $loop * @param array $context */ public function __construct(ConnectorInterface $connector, $loop = null, array $context = array()) { if ($loop !== null && !$loop instanceof LoopInterface) { // manual type check to support legacy PHP < 7.1 throw new \InvalidArgumentException('_PHPStan_7d8742a37\\Argument #2 ($loop) expected null|React\\EventLoop\\LoopInterface'); } $this->connector = $connector; $this->streamEncryption = new StreamEncryption($loop ?: Loop::get(), \false); $this->context = $context; } public function connect($uri) { if (!\function_exists('stream_socket_enable_crypto')) { return Promise\reject(new \BadMethodCallException('Encryption not supported on your platform (HHVM < 3.8?)')); // @codeCoverageIgnore } if (\strpos($uri, '://') === \false) { $uri = 'tls://' . $uri; } $parts = \parse_url($uri); if (!$parts || !isset($parts['scheme']) || $parts['scheme'] !== 'tls') { return Promise\reject(new \InvalidArgumentException('Given URI "' . $uri . '" is invalid (EINVAL)', \defined('SOCKET_EINVAL') ? \SOCKET_EINVAL : (\defined('PCNTL_EINVAL') ? \PCNTL_EINVAL : 22))); } $context = $this->context; $encryption = $this->streamEncryption; $connected = \false; /** @var \React\Promise\PromiseInterface<ConnectionInterface> $promise */ $promise = $this->connector->connect(\str_replace('tls://', '', $uri))->then(function (ConnectionInterface $connection) use($context, $encryption, $uri, &$promise, &$connected) { // (unencrypted) TCP/IP connection succeeded $connected = \true; if (!$connection instanceof Connection) { $connection->close(); throw new \UnexpectedValueException('Base connector does not use internal Connection class exposing stream resource'); } // set required SSL/TLS context options foreach ($context as $name => $value) { \stream_context_set_option($connection->stream, 'ssl', $name, $value); } // try to enable encryption return $promise = $encryption->enable($connection)->then(null, function ($error) use($connection, $uri) { // establishing encryption failed => close invalid connection and return error $connection->close(); throw new \RuntimeException('Connection to ' . $uri . ' failed during TLS handshake: ' . $error->getMessage(), $error->getCode()); }); }, function (\Exception $e) use($uri) { if ($e instanceof \RuntimeException) { $message = \preg_replace('/^Connection to [^ ]+/', '', $e->getMessage()); $e = new \RuntimeException('Connection to ' . $uri . $message, $e->getCode(), $e); // avoid garbage references by replacing all closures in call stack. // what a lovely piece of code! $r = new \ReflectionProperty('Exception', 'trace'); $r->setAccessible(\true); $trace = $r->getValue($e); // Exception trace arguments are not available on some PHP 7.4 installs // @codeCoverageIgnoreStart foreach ($trace as $ti => $one) { if (isset($one['args'])) { foreach ($one['args'] as $ai => $arg) { if ($arg instanceof \Closure) { $trace[$ti]['args'][$ai] = 'Object(' . \get_class($arg) . ')'; } } } } // @codeCoverageIgnoreEnd $r->setValue($e, $trace); } throw $e; }); return new \_PHPStan_7d8742a37\React\Promise\Promise(function ($resolve, $reject) use($promise) { $promise->then($resolve, $reject); }, function ($_, $reject) use(&$promise, $uri, &$connected) { if ($connected) { $reject(new \RuntimeException('Connection to ' . $uri . ' cancelled during TLS handshake (ECONNABORTED)', \defined('SOCKET_ECONNABORTED') ? \SOCKET_ECONNABORTED : 103)); } $promise->cancel(); $promise = null; }); } } <?php namespace _PHPStan_7d8742a37\React\Socket; use _PHPStan_7d8742a37\Evenement\EventEmitter; use _PHPStan_7d8742a37\React\EventLoop\Loop; use _PHPStan_7d8742a37\React\EventLoop\LoopInterface; use Exception; /** * @deprecated 1.9.0 See `SocketServer` instead * @see SocketServer */ final class Server extends EventEmitter implements ServerInterface { private $server; /** * [Deprecated] `Server` * * This class exists for BC reasons only and should not be used anymore. * * ```php * // deprecated * $socket = new React\Socket\Server(0); * $socket = new React\Socket\Server('127.0.0.1:8000'); * $socket = new React\Socket\Server('127.0.0.1:8000', null, $context); * $socket = new React\Socket\Server('127.0.0.1:8000', $loop, $context); * * // new * $socket = new React\Socket\SocketServer('127.0.0.1:0'); * $socket = new React\Socket\SocketServer('127.0.0.1:8000'); * $socket = new React\Socket\SocketServer('127.0.0.1:8000', $context); * $socket = new React\Socket\SocketServer('127.0.0.1:8000', $context, $loop); * ``` * * This class takes an optional `LoopInterface|null $loop` parameter that can be used to * pass the event loop instance to use for this object. You can use a `null` value * here in order to use the [default loop](https://github.com/reactphp/event-loop#loop). * This value SHOULD NOT be given unless you're sure you want to explicitly use a * given event loop instance. * * For BC reasons, you can also pass the TCP socket context options as a simple * array without wrapping this in another array under the `tcp` key. * * @param string|int $uri * @param ?LoopInterface $loop * @param array $context * @deprecated 1.9.0 See `SocketServer` instead * @see SocketServer */ public function __construct($uri, $loop = null, array $context = array()) { if ($loop !== null && !$loop instanceof LoopInterface) { // manual type check to support legacy PHP < 7.1 throw new \InvalidArgumentException('_PHPStan_7d8742a37\\Argument #2 ($loop) expected null|React\\EventLoop\\LoopInterface'); } $loop = $loop ?: Loop::get(); // sanitize TCP context options if not properly wrapped if ($context && (!isset($context['tcp']) && !isset($context['tls']) && !isset($context['unix']))) { $context = array('tcp' => $context); } // apply default options if not explicitly given $context += array('tcp' => array(), 'tls' => array(), 'unix' => array()); $scheme = 'tcp'; $pos = \strpos($uri, '://'); if ($pos !== \false) { $scheme = \substr($uri, 0, $pos); } if ($scheme === 'unix') { $server = new UnixServer($uri, $loop, $context['unix']); } else { $server = new TcpServer(\str_replace('tls://', '', $uri), $loop, $context['tcp']); if ($scheme === 'tls') { $server = new SecureServer($server, $loop, $context['tls']); } } $this->server = $server; $that = $this; $server->on('connection', function (ConnectionInterface $conn) use($that) { $that->emit('connection', array($conn)); }); $server->on('error', function (Exception $error) use($that) { $that->emit('error', array($error)); }); } public function getAddress() { return $this->server->getAddress(); } public function pause() { $this->server->pause(); } public function resume() { $this->server->resume(); } public function close() { $this->server->close(); } } <?php namespace _PHPStan_7d8742a37\React\Socket; use _PHPStan_7d8742a37\Evenement\EventEmitter; use _PHPStan_7d8742a37\React\EventLoop\Loop; use _PHPStan_7d8742a37\React\EventLoop\LoopInterface; use InvalidArgumentException; use RuntimeException; /** * The `UnixServer` class implements the `ServerInterface` and * is responsible for accepting plaintext connections on unix domain sockets. * * ```php * $server = new React\Socket\UnixServer('unix:///tmp/app.sock'); * ``` * * See also the `ServerInterface` for more details. * * @see ServerInterface * @see ConnectionInterface */ final class UnixServer extends EventEmitter implements ServerInterface { private $master; private $loop; private $listening = \false; /** * Creates a plaintext socket server and starts listening on the given unix socket * * This starts accepting new incoming connections on the given address. * See also the `connection event` documented in the `ServerInterface` * for more details. * * ```php * $server = new React\Socket\UnixServer('unix:///tmp/app.sock'); * ``` * * This class takes an optional `LoopInterface|null $loop` parameter that can be used to * pass the event loop instance to use for this object. You can use a `null` value * here in order to use the [default loop](https://github.com/reactphp/event-loop#loop). * This value SHOULD NOT be given unless you're sure you want to explicitly use a * given event loop instance. * * @param string $path * @param ?LoopInterface $loop * @param array $context * @throws InvalidArgumentException if the listening address is invalid * @throws RuntimeException if listening on this address fails (already in use etc.) */ public function __construct($path, $loop = null, array $context = array()) { if ($loop !== null && !$loop instanceof LoopInterface) { // manual type check to support legacy PHP < 7.1 throw new \InvalidArgumentException('_PHPStan_7d8742a37\\Argument #2 ($loop) expected null|React\\EventLoop\\LoopInterface'); } $this->loop = $loop ?: Loop::get(); if (\strpos($path, '://') === \false) { $path = 'unix://' . $path; } elseif (\substr($path, 0, 7) !== 'unix://') { throw new \InvalidArgumentException('Given URI "' . $path . '" is invalid (EINVAL)', \defined('SOCKET_EINVAL') ? \SOCKET_EINVAL : (\defined('PCNTL_EINVAL') ? \PCNTL_EINVAL : 22)); } $errno = 0; $errstr = ''; \set_error_handler(function ($_, $error) use(&$errno, &$errstr) { // PHP does not seem to report errno/errstr for Unix domain sockets (UDS) right now. // This only applies to UDS server sockets, see also https://3v4l.org/NAhpr. // Parse PHP warning message containing unknown error, HHVM reports proper info at least. if (\preg_match('/\\(([^\\)]+)\\)|\\[(\\d+)\\]: (.*)/', $error, $match)) { $errstr = isset($match[3]) ? $match['3'] : $match[1]; $errno = isset($match[2]) ? (int) $match[2] : 0; } }); $this->master = \stream_socket_server($path, $errno, $errstr, \STREAM_SERVER_BIND | \STREAM_SERVER_LISTEN, \stream_context_create(array('socket' => $context))); \restore_error_handler(); if (\false === $this->master) { throw new \RuntimeException('Failed to listen on Unix domain socket "' . $path . '": ' . $errstr . SocketServer::errconst($errno), $errno); } \stream_set_blocking($this->master, 0); $this->resume(); } public function getAddress() { if (!\is_resource($this->master)) { return null; } return 'unix://' . \stream_socket_get_name($this->master, \false); } public function pause() { if (!$this->listening) { return; } $this->loop->removeReadStream($this->master); $this->listening = \false; } public function resume() { if ($this->listening || !\is_resource($this->master)) { return; } $that = $this; $this->loop->addReadStream($this->master, function ($master) use($that) { try { $newSocket = SocketServer::accept($master); } catch (\RuntimeException $e) { $that->emit('error', array($e)); return; } $that->handleConnection($newSocket); }); $this->listening = \true; } public function close() { if (!\is_resource($this->master)) { return; } $this->pause(); \fclose($this->master); $this->removeAllListeners(); } /** @internal */ public function handleConnection($socket) { $connection = new Connection($socket, $this->loop); $connection->unix = \true; $this->emit('connection', array($connection)); } } <?php namespace _PHPStan_7d8742a37\React\Socket; use _PHPStan_7d8742a37\Evenement\EventEmitter; use Exception; use OverflowException; /** * The `LimitingServer` decorator wraps a given `ServerInterface` and is responsible * for limiting and keeping track of open connections to this server instance. * * Whenever the underlying server emits a `connection` event, it will check its * limits and then either * - keep track of this connection by adding it to the list of * open connections and then forward the `connection` event * - or reject (close) the connection when its limits are exceeded and will * forward an `error` event instead. * * Whenever a connection closes, it will remove this connection from the list of * open connections. * * ```php * $server = new React\Socket\LimitingServer($server, 100); * $server->on('connection', function (React\Socket\ConnectionInterface $connection) { * $connection->write('hello there!' . PHP_EOL); * … * }); * ``` * * See also the `ServerInterface` for more details. * * @see ServerInterface * @see ConnectionInterface */ class LimitingServer extends EventEmitter implements ServerInterface { private $connections = array(); private $server; private $limit; private $pauseOnLimit = \false; private $autoPaused = \false; private $manuPaused = \false; /** * Instantiates a new LimitingServer. * * You have to pass a maximum number of open connections to ensure * the server will automatically reject (close) connections once this limit * is exceeded. In this case, it will emit an `error` event to inform about * this and no `connection` event will be emitted. * * ```php * $server = new React\Socket\LimitingServer($server, 100); * $server->on('connection', function (React\Socket\ConnectionInterface $connection) { * $connection->write('hello there!' . PHP_EOL); * … * }); * ``` * * You MAY pass a `null` limit in order to put no limit on the number of * open connections and keep accepting new connection until you run out of * operating system resources (such as open file handles). This may be * useful if you do not want to take care of applying a limit but still want * to use the `getConnections()` method. * * You can optionally configure the server to pause accepting new * connections once the connection limit is reached. In this case, it will * pause the underlying server and no longer process any new connections at * all, thus also no longer closing any excessive connections. * The underlying operating system is responsible for keeping a backlog of * pending connections until its limit is reached, at which point it will * start rejecting further connections. * Once the server is below the connection limit, it will continue consuming * connections from the backlog and will process any outstanding data on * each connection. * This mode may be useful for some protocols that are designed to wait for * a response message (such as HTTP), but may be less useful for other * protocols that demand immediate responses (such as a "welcome" message in * an interactive chat). * * ```php * $server = new React\Socket\LimitingServer($server, 100, true); * $server->on('connection', function (React\Socket\ConnectionInterface $connection) { * $connection->write('hello there!' . PHP_EOL); * … * }); * ``` * * @param ServerInterface $server * @param int|null $connectionLimit * @param bool $pauseOnLimit */ public function __construct(ServerInterface $server, $connectionLimit, $pauseOnLimit = \false) { $this->server = $server; $this->limit = $connectionLimit; if ($connectionLimit !== null) { $this->pauseOnLimit = $pauseOnLimit; } $this->server->on('connection', array($this, 'handleConnection')); $this->server->on('error', array($this, 'handleError')); } /** * Returns an array with all currently active connections * * ```php * foreach ($server->getConnection() as $connection) { * $connection->write('Hi!'); * } * ``` * * @return ConnectionInterface[] */ public function getConnections() { return $this->connections; } public function getAddress() { return $this->server->getAddress(); } public function pause() { if (!$this->manuPaused) { $this->manuPaused = \true; if (!$this->autoPaused) { $this->server->pause(); } } } public function resume() { if ($this->manuPaused) { $this->manuPaused = \false; if (!$this->autoPaused) { $this->server->resume(); } } } public function close() { $this->server->close(); } /** @internal */ public function handleConnection(ConnectionInterface $connection) { // close connection if limit exceeded if ($this->limit !== null && \count($this->connections) >= $this->limit) { $this->handleError(new \OverflowException('Connection closed because server reached connection limit')); $connection->close(); return; } $this->connections[] = $connection; $that = $this; $connection->on('close', function () use($that, $connection) { $that->handleDisconnection($connection); }); // pause accepting new connections if limit exceeded if ($this->pauseOnLimit && !$this->autoPaused && \count($this->connections) >= $this->limit) { $this->autoPaused = \true; if (!$this->manuPaused) { $this->server->pause(); } } $this->emit('connection', array($connection)); } /** @internal */ public function handleDisconnection(ConnectionInterface $connection) { unset($this->connections[\array_search($connection, $this->connections)]); // continue accepting new connection if below limit if ($this->autoPaused && \count($this->connections) < $this->limit) { $this->autoPaused = \false; if (!$this->manuPaused) { $this->server->resume(); } } } /** @internal */ public function handleError(\Exception $error) { $this->emit('error', array($error)); } } <?php namespace _PHPStan_7d8742a37\React\Socket; use _PHPStan_7d8742a37\React\EventLoop\LoopInterface; use _PHPStan_7d8742a37\React\Promise\Deferred; use RuntimeException; use UnexpectedValueException; /** * This class is considered internal and its API should not be relied upon * outside of Socket. * * @internal */ class StreamEncryption { private $loop; private $method; private $server; public function __construct(LoopInterface $loop, $server = \true) { $this->loop = $loop; $this->server = $server; // support TLSv1.0+ by default and exclude legacy SSLv2/SSLv3. // As of PHP 7.2+ the main crypto method constant includes all TLS versions. // As of PHP 5.6+ the crypto method is a bitmask, so we explicitly include all TLS versions. // For legacy PHP < 5.6 the crypto method is a single value only and this constant includes all TLS versions. // @link https://3v4l.org/9PSST if ($server) { $this->method = \STREAM_CRYPTO_METHOD_TLS_SERVER; if (\PHP_VERSION_ID < 70200 && \PHP_VERSION_ID >= 50600) { $this->method |= \STREAM_CRYPTO_METHOD_TLSv1_0_SERVER | \STREAM_CRYPTO_METHOD_TLSv1_1_SERVER | \STREAM_CRYPTO_METHOD_TLSv1_2_SERVER; // @codeCoverageIgnore } } else { $this->method = \STREAM_CRYPTO_METHOD_TLS_CLIENT; if (\PHP_VERSION_ID < 70200 && \PHP_VERSION_ID >= 50600) { $this->method |= \STREAM_CRYPTO_METHOD_TLSv1_0_CLIENT | \STREAM_CRYPTO_METHOD_TLSv1_1_CLIENT | \STREAM_CRYPTO_METHOD_TLSv1_2_CLIENT; // @codeCoverageIgnore } } } /** * @param Connection $stream * @return \React\Promise\PromiseInterface<Connection> */ public function enable(Connection $stream) { return $this->toggle($stream, \true); } /** * @param Connection $stream * @param bool $toggle * @return \React\Promise\PromiseInterface<Connection> */ public function toggle(Connection $stream, $toggle) { // pause actual stream instance to continue operation on raw stream socket $stream->pause(); // TODO: add write() event to make sure we're not sending any excessive data // cancelling this leaves this stream in an inconsistent state… $deferred = new Deferred(function () { throw new \RuntimeException(); }); // get actual stream socket from stream instance $socket = $stream->stream; // get crypto method from context options or use global setting from constructor $method = $this->method; $context = \stream_context_get_options($socket); if (isset($context['ssl']['crypto_method'])) { $method = $context['ssl']['crypto_method']; } $that = $this; $toggleCrypto = function () use($socket, $deferred, $toggle, $method, $that) { $that->toggleCrypto($socket, $deferred, $toggle, $method); }; $this->loop->addReadStream($socket, $toggleCrypto); if (!$this->server) { $toggleCrypto(); } $loop = $this->loop; return $deferred->promise()->then(function () use($stream, $socket, $loop, $toggle) { $loop->removeReadStream($socket); $stream->encryptionEnabled = $toggle; $stream->resume(); return $stream; }, function ($error) use($stream, $socket, $loop) { $loop->removeReadStream($socket); $stream->resume(); throw $error; }); } /** * @internal * @param resource $socket * @param Deferred<null> $deferred * @param bool $toggle * @param int $method * @return void */ public function toggleCrypto($socket, Deferred $deferred, $toggle, $method) { $error = null; \set_error_handler(function ($_, $errstr) use(&$error) { $error = \str_replace(array("\r", "\n"), ' ', $errstr); // remove useless function name from error message if (($pos = \strpos($error, "): ")) !== \false) { $error = \substr($error, $pos + 3); } }); $result = \stream_socket_enable_crypto($socket, $toggle, $method); \restore_error_handler(); if (\true === $result) { $deferred->resolve(null); } else { if (\false === $result) { // overwrite callback arguments for PHP7+ only, so they do not show // up in the Exception trace and do not cause a possible cyclic reference. $d = $deferred; $deferred = null; if (\feof($socket) || $error === null) { // EOF or failed without error => connection closed during handshake $d->reject(new \UnexpectedValueException('Connection lost during TLS handshake (ECONNRESET)', \defined('SOCKET_ECONNRESET') ? \SOCKET_ECONNRESET : 104)); } else { // handshake failed with error message $d->reject(new \UnexpectedValueException($error)); } } else { // need more data, will retry } } } } <?php namespace _PHPStan_7d8742a37\React\Socket; use _PHPStan_7d8742a37\React\Dns\Model\Message; use _PHPStan_7d8742a37\React\Dns\Resolver\ResolverInterface; use _PHPStan_7d8742a37\React\EventLoop\LoopInterface; use _PHPStan_7d8742a37\React\EventLoop\TimerInterface; use _PHPStan_7d8742a37\React\Promise; use _PHPStan_7d8742a37\React\Promise\PromiseInterface; /** * @internal */ final class HappyEyeBallsConnectionBuilder { /** * As long as we haven't connected yet keep popping an IP address of the connect queue until one of them * succeeds or they all fail. We will wait 100ms between connection attempts as per RFC. * * @link https://tools.ietf.org/html/rfc8305#section-5 */ const CONNECTION_ATTEMPT_DELAY = 0.1; /** * Delay `A` lookup by 50ms sending out connection to IPv4 addresses when IPv6 records haven't * resolved yet as per RFC. * * @link https://tools.ietf.org/html/rfc8305#section-3 */ const RESOLUTION_DELAY = 0.05; public $loop; public $connector; public $resolver; public $uri; public $host; public $resolved = array(Message::TYPE_A => \false, Message::TYPE_AAAA => \false); public $resolverPromises = array(); public $connectionPromises = array(); public $connectQueue = array(); public $nextAttemptTimer; public $parts; public $ipsCount = 0; public $failureCount = 0; public $resolve; public $reject; public $lastErrorFamily; public $lastError6; public $lastError4; public function __construct(LoopInterface $loop, ConnectorInterface $connector, ResolverInterface $resolver, $uri, $host, $parts) { $this->loop = $loop; $this->connector = $connector; $this->resolver = $resolver; $this->uri = $uri; $this->host = $host; $this->parts = $parts; } public function connect() { $that = $this; return new Promise\Promise(function ($resolve, $reject) use($that) { $lookupResolve = function ($type) use($that, $resolve, $reject) { return function (array $ips) use($that, $type, $resolve, $reject) { unset($that->resolverPromises[$type]); $that->resolved[$type] = \true; $that->mixIpsIntoConnectQueue($ips); // start next connection attempt if not already awaiting next if ($that->nextAttemptTimer === null && $that->connectQueue) { $that->check($resolve, $reject); } }; }; $that->resolverPromises[Message::TYPE_AAAA] = $that->resolve(Message::TYPE_AAAA, $reject)->then($lookupResolve(Message::TYPE_AAAA)); $that->resolverPromises[Message::TYPE_A] = $that->resolve(Message::TYPE_A, $reject)->then(function (array $ips) use($that) { // happy path: IPv6 has resolved already (or could not resolve), continue with IPv4 addresses if ($that->resolved[Message::TYPE_AAAA] === \true || !$ips) { return $ips; } // Otherwise delay processing IPv4 lookup until short timer passes or IPv6 resolves in the meantime $deferred = new Promise\Deferred(function () use(&$ips) { // discard all IPv4 addresses if cancelled $ips = array(); }); $timer = $that->loop->addTimer($that::RESOLUTION_DELAY, function () use($deferred, $ips) { $deferred->resolve($ips); }); $that->resolverPromises[Message::TYPE_AAAA]->then(function () use($that, $timer, $deferred, &$ips) { $that->loop->cancelTimer($timer); $deferred->resolve($ips); }); return $deferred->promise(); })->then($lookupResolve(Message::TYPE_A)); }, function ($_, $reject) use($that) { $reject(new \RuntimeException('Connection to ' . $that->uri . ' cancelled' . (!$that->connectionPromises ? ' during DNS lookup' : '') . ' (ECONNABORTED)', \defined('SOCKET_ECONNABORTED') ? \SOCKET_ECONNABORTED : 103)); $_ = $reject = null; $that->cleanUp(); }); } /** * @internal * @param int $type DNS query type * @param callable $reject * @return \React\Promise\PromiseInterface<string[]> Returns a promise that * always resolves with a list of IP addresses on success or an empty * list on error. */ public function resolve($type, $reject) { $that = $this; return $that->resolver->resolveAll($that->host, $type)->then(null, function (\Exception $e) use($type, $reject, $that) { unset($that->resolverPromises[$type]); $that->resolved[$type] = \true; if ($type === Message::TYPE_A) { $that->lastError4 = $e->getMessage(); $that->lastErrorFamily = 4; } else { $that->lastError6 = $e->getMessage(); $that->lastErrorFamily = 6; } // cancel next attempt timer when there are no more IPs to connect to anymore if ($that->nextAttemptTimer !== null && !$that->connectQueue) { $that->loop->cancelTimer($that->nextAttemptTimer); $that->nextAttemptTimer = null; } if ($that->hasBeenResolved() && $that->ipsCount === 0) { $reject(new \RuntimeException($that->error(), 0, $e)); } // Exception already handled above, so don't throw an unhandled rejection here return array(); }); } /** * @internal */ public function check($resolve, $reject) { $ip = \array_shift($this->connectQueue); // start connection attempt and remember array position to later unset again $this->connectionPromises[] = $this->attemptConnection($ip); \end($this->connectionPromises); $index = \key($this->connectionPromises); $that = $this; $that->connectionPromises[$index]->then(function ($connection) use($that, $index, $resolve) { unset($that->connectionPromises[$index]); $that->cleanUp(); $resolve($connection); }, function (\Exception $e) use($that, $index, $ip, $resolve, $reject) { unset($that->connectionPromises[$index]); $that->failureCount++; $message = \preg_replace('/^(Connection to [^ ]+)[&?]hostname=[^ &]+/', '$1', $e->getMessage()); if (\strpos($ip, ':') === \false) { $that->lastError4 = $message; $that->lastErrorFamily = 4; } else { $that->lastError6 = $message; $that->lastErrorFamily = 6; } // start next connection attempt immediately on error if ($that->connectQueue) { if ($that->nextAttemptTimer !== null) { $that->loop->cancelTimer($that->nextAttemptTimer); $that->nextAttemptTimer = null; } $that->check($resolve, $reject); } if ($that->hasBeenResolved() === \false) { return; } if ($that->ipsCount === $that->failureCount) { $that->cleanUp(); $reject(new \RuntimeException($that->error(), $e->getCode(), $e)); } }); // Allow next connection attempt in 100ms: https://tools.ietf.org/html/rfc8305#section-5 // Only start timer when more IPs are queued or when DNS query is still pending (might add more IPs) if ($this->nextAttemptTimer === null && (\count($this->connectQueue) > 0 || $this->resolved[Message::TYPE_A] === \false || $this->resolved[Message::TYPE_AAAA] === \false)) { $this->nextAttemptTimer = $this->loop->addTimer(self::CONNECTION_ATTEMPT_DELAY, function () use($that, $resolve, $reject) { $that->nextAttemptTimer = null; if ($that->connectQueue) { $that->check($resolve, $reject); } }); } } /** * @internal */ public function attemptConnection($ip) { $uri = Connector::uri($this->parts, $this->host, $ip); return $this->connector->connect($uri); } /** * @internal */ public function cleanUp() { // clear list of outstanding IPs to avoid creating new connections $this->connectQueue = array(); // cancel pending connection attempts foreach ($this->connectionPromises as $connectionPromise) { if ($connectionPromise instanceof PromiseInterface && \method_exists($connectionPromise, 'cancel')) { $connectionPromise->cancel(); } } // cancel pending DNS resolution (cancel IPv4 first in case it is awaiting IPv6 resolution delay) foreach (\array_reverse($this->resolverPromises) as $resolverPromise) { if ($resolverPromise instanceof PromiseInterface && \method_exists($resolverPromise, 'cancel')) { $resolverPromise->cancel(); } } if ($this->nextAttemptTimer instanceof TimerInterface) { $this->loop->cancelTimer($this->nextAttemptTimer); $this->nextAttemptTimer = null; } } /** * @internal */ public function hasBeenResolved() { foreach ($this->resolved as $typeHasBeenResolved) { if ($typeHasBeenResolved === \false) { return \false; } } return \true; } /** * Mixes an array of IP addresses into the connect queue in such a way they alternate when attempting to connect. * The goal behind it is first attempt to connect to IPv6, then to IPv4, then to IPv6 again until one of those * attempts succeeds. * * @link https://tools.ietf.org/html/rfc8305#section-4 * * @internal */ public function mixIpsIntoConnectQueue(array $ips) { \shuffle($ips); $this->ipsCount += \count($ips); $connectQueueStash = $this->connectQueue; $this->connectQueue = array(); while (\count($connectQueueStash) > 0 || \count($ips) > 0) { if (\count($ips) > 0) { $this->connectQueue[] = \array_shift($ips); } if (\count($connectQueueStash) > 0) { $this->connectQueue[] = \array_shift($connectQueueStash); } } } /** * @internal * @return string */ public function error() { if ($this->lastError4 === $this->lastError6) { $message = $this->lastError6; } elseif ($this->lastErrorFamily === 6) { $message = 'Last error for IPv6: ' . $this->lastError6 . '. Previous error for IPv4: ' . $this->lastError4; } else { $message = 'Last error for IPv4: ' . $this->lastError4 . '. Previous error for IPv6: ' . $this->lastError6; } if ($this->hasBeenResolved() && $this->ipsCount === 0) { if ($this->lastError6 === $this->lastError4) { $message = ' during DNS lookup: ' . $this->lastError6; } else { $message = ' during DNS lookup. ' . $message; } } else { $message = ': ' . $message; } return 'Connection to ' . $this->uri . ' failed' . $message; } } <?php namespace _PHPStan_7d8742a37\React\Socket; /** * Decorates an existing Connector to always use a fixed, preconfigured URI * * This can be useful for consumers that do not support certain URIs, such as * when you want to explicitly connect to a Unix domain socket (UDS) path * instead of connecting to a default address assumed by an higher-level API: * * ```php * $connector = new React\Socket\FixedUriConnector( * 'unix:///var/run/docker.sock', * new React\Socket\UnixConnector() * ); * * // destination will be ignored, actually connects to Unix domain socket * $promise = $connector->connect('localhost:80'); * ``` */ class FixedUriConnector implements ConnectorInterface { private $uri; private $connector; /** * @param string $uri * @param ConnectorInterface $connector */ public function __construct($uri, ConnectorInterface $connector) { $this->uri = $uri; $this->connector = $connector; } public function connect($_) { return $this->connector->connect($this->uri); } } <?php namespace _PHPStan_7d8742a37\React\Socket; use _PHPStan_7d8742a37\React\EventLoop\Loop; use _PHPStan_7d8742a37\React\EventLoop\LoopInterface; use _PHPStan_7d8742a37\React\Promise; use InvalidArgumentException; use RuntimeException; /** * Unix domain socket connector * * Unix domain sockets use atomic operations, so we can as well emulate * async behavior. */ final class UnixConnector implements ConnectorInterface { private $loop; /** * @param ?LoopInterface $loop */ public function __construct($loop = null) { if ($loop !== null && !$loop instanceof LoopInterface) { // manual type check to support legacy PHP < 7.1 throw new \InvalidArgumentException('_PHPStan_7d8742a37\\Argument #1 ($loop) expected null|React\\EventLoop\\LoopInterface'); } $this->loop = $loop ?: Loop::get(); } public function connect($path) { if (\strpos($path, '://') === \false) { $path = 'unix://' . $path; } elseif (\substr($path, 0, 7) !== 'unix://') { return Promise\reject(new \InvalidArgumentException('Given URI "' . $path . '" is invalid (EINVAL)', \defined('SOCKET_EINVAL') ? \SOCKET_EINVAL : (\defined('PCNTL_EINVAL') ? \PCNTL_EINVAL : 22))); } $resource = @\stream_socket_client($path, $errno, $errstr, 1.0); if (!$resource) { return Promise\reject(new \RuntimeException('Unable to connect to unix domain socket "' . $path . '": ' . $errstr . SocketServer::errconst($errno), $errno)); } $connection = new Connection($resource, $this->loop); $connection->unix = \true; return Promise\resolve($connection); } } <?php namespace _PHPStan_7d8742a37\React\Socket; use _PHPStan_7d8742a37\Evenement\EventEmitterInterface; /** * The `ServerInterface` is responsible for providing an interface for accepting * incoming streaming connections, such as a normal TCP/IP connection. * * Most higher-level components (such as a HTTP server) accept an instance * implementing this interface to accept incoming streaming connections. * This is usually done via dependency injection, so it's fairly simple to actually * swap this implementation against any other implementation of this interface. * This means that you SHOULD typehint against this interface instead of a concrete * implementation of this interface. * * Besides defining a few methods, this interface also implements the * `EventEmitterInterface` which allows you to react to certain events: * * connection event: * The `connection` event will be emitted whenever a new connection has been * established, i.e. a new client connects to this server socket: * * ```php * $socket->on('connection', function (React\Socket\ConnectionInterface $connection) { * echo 'new connection' . PHP_EOL; * }); * ``` * * See also the `ConnectionInterface` for more details about handling the * incoming connection. * * error event: * The `error` event will be emitted whenever there's an error accepting a new * connection from a client. * * ```php * $socket->on('error', function (Exception $e) { * echo 'error: ' . $e->getMessage() . PHP_EOL; * }); * ``` * * Note that this is not a fatal error event, i.e. the server keeps listening for * new connections even after this event. * * @see ConnectionInterface */ interface ServerInterface extends EventEmitterInterface { /** * Returns the full address (URI) this server is currently listening on * * ```php * $address = $socket->getAddress(); * echo 'Server listening on ' . $address . PHP_EOL; * ``` * * If the address can not be determined or is unknown at this time (such as * after the socket has been closed), it MAY return a `NULL` value instead. * * Otherwise, it will return the full address (URI) as a string value, such * as `tcp://127.0.0.1:8080`, `tcp://[::1]:80` or `tls://127.0.0.1:443`. * Note that individual URI components are application specific and depend * on the underlying transport protocol. * * If this is a TCP/IP based server and you only want the local port, you may * use something like this: * * ```php * $address = $socket->getAddress(); * $port = parse_url($address, PHP_URL_PORT); * echo 'Server listening on port ' . $port . PHP_EOL; * ``` * * @return ?string the full listening address (URI) or NULL if it is unknown (not applicable to this server socket or already closed) */ public function getAddress(); /** * Pauses accepting new incoming connections. * * Removes the socket resource from the EventLoop and thus stop accepting * new connections. Note that the listening socket stays active and is not * closed. * * This means that new incoming connections will stay pending in the * operating system backlog until its configurable backlog is filled. * Once the backlog is filled, the operating system may reject further * incoming connections until the backlog is drained again by resuming * to accept new connections. * * Once the server is paused, no futher `connection` events SHOULD * be emitted. * * ```php * $socket->pause(); * * $socket->on('connection', assertShouldNeverCalled()); * ``` * * This method is advisory-only, though generally not recommended, the * server MAY continue emitting `connection` events. * * Unless otherwise noted, a successfully opened server SHOULD NOT start * in paused state. * * You can continue processing events by calling `resume()` again. * * Note that both methods can be called any number of times, in particular * calling `pause()` more than once SHOULD NOT have any effect. * Similarly, calling this after `close()` is a NO-OP. * * @see self::resume() * @return void */ public function pause(); /** * Resumes accepting new incoming connections. * * Re-attach the socket resource to the EventLoop after a previous `pause()`. * * ```php * $socket->pause(); * * Loop::addTimer(1.0, function () use ($socket) { * $socket->resume(); * }); * ``` * * Note that both methods can be called any number of times, in particular * calling `resume()` without a prior `pause()` SHOULD NOT have any effect. * Similarly, calling this after `close()` is a NO-OP. * * @see self::pause() * @return void */ public function resume(); /** * Shuts down this listening socket * * This will stop listening for new incoming connections on this socket. * * Calling this method more than once on the same instance is a NO-OP. * * @return void */ public function close(); } <?php namespace _PHPStan_7d8742a37\React\Socket; use _PHPStan_7d8742a37\React\Dns\Resolver\ResolverInterface; use _PHPStan_7d8742a37\React\EventLoop\Loop; use _PHPStan_7d8742a37\React\EventLoop\LoopInterface; use _PHPStan_7d8742a37\React\Promise; final class HappyEyeBallsConnector implements ConnectorInterface { private $loop; private $connector; private $resolver; /** * @param ?LoopInterface $loop * @param ConnectorInterface $connector * @param ResolverInterface $resolver */ public function __construct($loop = null, $connector = null, $resolver = null) { // $connector and $resolver arguments are actually required, marked // optional for technical reasons only. Nullable $loop without default // requires PHP 7.1, null default is also supported in legacy PHP // versions, but required parameters are not allowed after arguments // with null default. Mark all parameters optional and check accordingly. if ($loop !== null && !$loop instanceof LoopInterface) { // manual type check to support legacy PHP < 7.1 throw new \InvalidArgumentException('_PHPStan_7d8742a37\\Argument #1 ($loop) expected null|React\\EventLoop\\LoopInterface'); } if (!$connector instanceof ConnectorInterface) { // manual type check to support legacy PHP < 7.1 throw new \InvalidArgumentException('_PHPStan_7d8742a37\\Argument #2 ($connector) expected React\\Socket\\ConnectorInterface'); } if (!$resolver instanceof ResolverInterface) { // manual type check to support legacy PHP < 7.1 throw new \InvalidArgumentException('_PHPStan_7d8742a37\\Argument #3 ($resolver) expected React\\Dns\\Resolver\\ResolverInterface'); } $this->loop = $loop ?: Loop::get(); $this->connector = $connector; $this->resolver = $resolver; } public function connect($uri) { $original = $uri; if (\strpos($uri, '://') === \false) { $uri = 'tcp://' . $uri; $parts = \parse_url($uri); if (isset($parts['scheme'])) { unset($parts['scheme']); } } else { $parts = \parse_url($uri); } if (!$parts || !isset($parts['host'])) { return Promise\reject(new \InvalidArgumentException('Given URI "' . $original . '" is invalid (EINVAL)', \defined('SOCKET_EINVAL') ? \SOCKET_EINVAL : (\defined('PCNTL_EINVAL') ? \PCNTL_EINVAL : 22))); } $host = \trim($parts['host'], '[]'); // skip DNS lookup / URI manipulation if this URI already contains an IP if (@\inet_pton($host) !== \false) { return $this->connector->connect($original); } $builder = new HappyEyeBallsConnectionBuilder($this->loop, $this->connector, $this->resolver, $uri, $host, $parts); return $builder->connect(); } } <?php namespace _PHPStan_7d8742a37\React\Socket; /** * The `ConnectorInterface` is responsible for providing an interface for * establishing streaming connections, such as a normal TCP/IP connection. * * This is the main interface defined in this package and it is used throughout * React's vast ecosystem. * * Most higher-level components (such as HTTP, database or other networking * service clients) accept an instance implementing this interface to create their * TCP/IP connection to the underlying networking service. * This is usually done via dependency injection, so it's fairly simple to actually * swap this implementation against any other implementation of this interface. * * The interface only offers a single `connect()` method. * * @see ConnectionInterface */ interface ConnectorInterface { /** * Creates a streaming connection to the given remote address * * If returns a Promise which either fulfills with a stream implementing * `ConnectionInterface` on success or rejects with an `Exception` if the * connection is not successful. * * ```php * $connector->connect('google.com:443')->then( * function (React\Socket\ConnectionInterface $connection) { * // connection successfully established * }, * function (Exception $error) { * // failed to connect due to $error * } * ); * ``` * * The returned Promise MUST be implemented in such a way that it can be * cancelled when it is still pending. Cancelling a pending promise MUST * reject its value with an Exception. It SHOULD clean up any underlying * resources and references as applicable. * * ```php * $promise = $connector->connect($uri); * * $promise->cancel(); * ``` * * @param string $uri * @return \React\Promise\PromiseInterface<ConnectionInterface> * Resolves with a `ConnectionInterface` on success or rejects with an `Exception` on error. * @see ConnectionInterface */ public function connect($uri); } <?php namespace _PHPStan_7d8742a37\React\Socket; use _PHPStan_7d8742a37\Evenement\EventEmitter; use _PHPStan_7d8742a37\React\EventLoop\Loop; use _PHPStan_7d8742a37\React\EventLoop\LoopInterface; use BadMethodCallException; use UnexpectedValueException; /** * The `SecureServer` class implements the `ServerInterface` and is responsible * for providing a secure TLS (formerly known as SSL) server. * * It does so by wrapping a `TcpServer` instance which waits for plaintext * TCP/IP connections and then performs a TLS handshake for each connection. * * ```php * $server = new React\Socket\TcpServer(8000); * $server = new React\Socket\SecureServer($server, null, array( * // tls context options here… * )); * ``` * * Whenever a client completes the TLS handshake, it will emit a `connection` event * with a connection instance implementing [`ConnectionInterface`](#connectioninterface): * * ```php * $server->on('connection', function (React\Socket\ConnectionInterface $connection) { * echo 'Secure connection from' . $connection->getRemoteAddress() . PHP_EOL; * * $connection->write('hello there!' . PHP_EOL); * … * }); * ``` * * Whenever a client fails to perform a successful TLS handshake, it will emit an * `error` event and then close the underlying TCP/IP connection: * * ```php * $server->on('error', function (Exception $e) { * echo 'Error' . $e->getMessage() . PHP_EOL; * }); * ``` * * See also the `ServerInterface` for more details. * * Note that the `SecureServer` class is a concrete implementation for TLS sockets. * If you want to typehint in your higher-level protocol implementation, you SHOULD * use the generic `ServerInterface` instead. * * @see ServerInterface * @see ConnectionInterface */ final class SecureServer extends EventEmitter implements ServerInterface { private $tcp; private $encryption; private $context; /** * Creates a secure TLS server and starts waiting for incoming connections * * It does so by wrapping a `TcpServer` instance which waits for plaintext * TCP/IP connections and then performs a TLS handshake for each connection. * It thus requires valid [TLS context options], * which in its most basic form may look something like this if you're using a * PEM encoded certificate file: * * ```php * $server = new React\Socket\TcpServer(8000); * $server = new React\Socket\SecureServer($server, null, array( * 'local_cert' => 'server.pem' * )); * ``` * * Note that the certificate file will not be loaded on instantiation but when an * incoming connection initializes its TLS context. * This implies that any invalid certificate file paths or contents will only cause * an `error` event at a later time. * * If your private key is encrypted with a passphrase, you have to specify it * like this: * * ```php * $server = new React\Socket\TcpServer(8000); * $server = new React\Socket\SecureServer($server, null, array( * 'local_cert' => 'server.pem', * 'passphrase' => 'secret' * )); * ``` * * Note that available [TLS context options], * their defaults and effects of changing these may vary depending on your system * and/or PHP version. * Passing unknown context options has no effect. * * This class takes an optional `LoopInterface|null $loop` parameter that can be used to * pass the event loop instance to use for this object. You can use a `null` value * here in order to use the [default loop](https://github.com/reactphp/event-loop#loop). * This value SHOULD NOT be given unless you're sure you want to explicitly use a * given event loop instance. * * Advanced usage: Despite allowing any `ServerInterface` as first parameter, * you SHOULD pass a `TcpServer` instance as first parameter, unless you * know what you're doing. * Internally, the `SecureServer` has to set the required TLS context options on * the underlying stream resources. * These resources are not exposed through any of the interfaces defined in this * package, but only through the internal `Connection` class. * The `TcpServer` class is guaranteed to emit connections that implement * the `ConnectionInterface` and uses the internal `Connection` class in order to * expose these underlying resources. * If you use a custom `ServerInterface` and its `connection` event does not * meet this requirement, the `SecureServer` will emit an `error` event and * then close the underlying connection. * * @param ServerInterface|TcpServer $tcp * @param ?LoopInterface $loop * @param array $context * @throws BadMethodCallException for legacy HHVM < 3.8 due to lack of support * @see TcpServer * @link https://www.php.net/manual/en/context.ssl.php for TLS context options */ public function __construct(ServerInterface $tcp, $loop = null, array $context = array()) { if ($loop !== null && !$loop instanceof LoopInterface) { // manual type check to support legacy PHP < 7.1 throw new \InvalidArgumentException('_PHPStan_7d8742a37\\Argument #2 ($loop) expected null|React\\EventLoop\\LoopInterface'); } if (!\function_exists('stream_socket_enable_crypto')) { throw new \BadMethodCallException('Encryption not supported on your platform (HHVM < 3.8?)'); // @codeCoverageIgnore } // default to empty passphrase to suppress blocking passphrase prompt $context += array('passphrase' => ''); $this->tcp = $tcp; $this->encryption = new StreamEncryption($loop ?: Loop::get()); $this->context = $context; $that = $this; $this->tcp->on('connection', function ($connection) use($that) { $that->handleConnection($connection); }); $this->tcp->on('error', function ($error) use($that) { $that->emit('error', array($error)); }); } public function getAddress() { $address = $this->tcp->getAddress(); if ($address === null) { return null; } return \str_replace('tcp://', 'tls://', $address); } public function pause() { $this->tcp->pause(); } public function resume() { $this->tcp->resume(); } public function close() { return $this->tcp->close(); } /** @internal */ public function handleConnection(ConnectionInterface $connection) { if (!$connection instanceof Connection) { $this->emit('error', array(new \UnexpectedValueException('Base server does not use internal Connection class exposing stream resource'))); $connection->close(); return; } foreach ($this->context as $name => $value) { \stream_context_set_option($connection->stream, 'ssl', $name, $value); } // get remote address before starting TLS handshake in case connection closes during handshake $remote = $connection->getRemoteAddress(); $that = $this; $this->encryption->enable($connection)->then(function ($conn) use($that) { $that->emit('connection', array($conn)); }, function ($error) use($that, $connection, $remote) { $error = new \RuntimeException('Connection from ' . $remote . ' failed during TLS handshake: ' . $error->getMessage(), $error->getCode()); $that->emit('error', array($error)); $connection->close(); }); } } <?php namespace _PHPStan_7d8742a37\React\Socket; use _PHPStan_7d8742a37\React\Stream\DuplexStreamInterface; /** * Any incoming and outgoing connection is represented by this interface, * such as a normal TCP/IP connection. * * An incoming or outgoing connection is a duplex stream (both readable and * writable) that implements React's * [`DuplexStreamInterface`](https://github.com/reactphp/stream#duplexstreaminterface). * It contains additional properties for the local and remote address (client IP) * where this connection has been established to/from. * * Most commonly, instances implementing this `ConnectionInterface` are emitted * by all classes implementing the [`ServerInterface`](#serverinterface) and * used by all classes implementing the [`ConnectorInterface`](#connectorinterface). * * Because the `ConnectionInterface` implements the underlying * [`DuplexStreamInterface`](https://github.com/reactphp/stream#duplexstreaminterface) * you can use any of its events and methods as usual: * * ```php * $connection->on('data', function ($chunk) { * echo $chunk; * }); * * $connection->on('end', function () { * echo 'ended'; * }); * * $connection->on('error', function (Exception $e) { * echo 'error: ' . $e->getMessage(); * }); * * $connection->on('close', function () { * echo 'closed'; * }); * * $connection->write($data); * $connection->end($data = null); * $connection->close(); * // … * ``` * * For more details, see the * [`DuplexStreamInterface`](https://github.com/reactphp/stream#duplexstreaminterface). * * @see DuplexStreamInterface * @see ServerInterface * @see ConnectorInterface */ interface ConnectionInterface extends DuplexStreamInterface { /** * Returns the full remote address (URI) where this connection has been established with * * ```php * $address = $connection->getRemoteAddress(); * echo 'Connection with ' . $address . PHP_EOL; * ``` * * If the remote address can not be determined or is unknown at this time (such as * after the connection has been closed), it MAY return a `NULL` value instead. * * Otherwise, it will return the full address (URI) as a string value, such * as `tcp://127.0.0.1:8080`, `tcp://[::1]:80`, `tls://127.0.0.1:443`, * `unix://example.sock` or `unix:///path/to/example.sock`. * Note that individual URI components are application specific and depend * on the underlying transport protocol. * * If this is a TCP/IP based connection and you only want the remote IP, you may * use something like this: * * ```php * $address = $connection->getRemoteAddress(); * $ip = trim(parse_url($address, PHP_URL_HOST), '[]'); * echo 'Connection with ' . $ip . PHP_EOL; * ``` * * @return ?string remote address (URI) or null if unknown */ public function getRemoteAddress(); /** * Returns the full local address (full URI with scheme, IP and port) where this connection has been established with * * ```php * $address = $connection->getLocalAddress(); * echo 'Connection with ' . $address . PHP_EOL; * ``` * * If the local address can not be determined or is unknown at this time (such as * after the connection has been closed), it MAY return a `NULL` value instead. * * Otherwise, it will return the full address (URI) as a string value, such * as `tcp://127.0.0.1:8080`, `tcp://[::1]:80`, `tls://127.0.0.1:443`, * `unix://example.sock` or `unix:///path/to/example.sock`. * Note that individual URI components are application specific and depend * on the underlying transport protocol. * * This method complements the [`getRemoteAddress()`](#getremoteaddress) method, * so they should not be confused. * * If your `TcpServer` instance is listening on multiple interfaces (e.g. using * the address `0.0.0.0`), you can use this method to find out which interface * actually accepted this connection (such as a public or local interface). * * If your system has multiple interfaces (e.g. a WAN and a LAN interface), * you can use this method to find out which interface was actually * used for this connection. * * @return ?string local address (URI) or null if unknown * @see self::getRemoteAddress() */ public function getLocalAddress(); } <?php namespace _PHPStan_7d8742a37\React\Socket; use _PHPStan_7d8742a37\React\EventLoop\Loop; use _PHPStan_7d8742a37\React\EventLoop\LoopInterface; use _PHPStan_7d8742a37\React\Promise; use InvalidArgumentException; use RuntimeException; final class TcpConnector implements ConnectorInterface { private $loop; private $context; /** * @param ?LoopInterface $loop * @param array $context */ public function __construct($loop = null, array $context = array()) { if ($loop !== null && !$loop instanceof LoopInterface) { // manual type check to support legacy PHP < 7.1 throw new \InvalidArgumentException('_PHPStan_7d8742a37\\Argument #1 ($loop) expected null|React\\EventLoop\\LoopInterface'); } $this->loop = $loop ?: Loop::get(); $this->context = $context; } public function connect($uri) { if (\strpos($uri, '://') === \false) { $uri = 'tcp://' . $uri; } $parts = \parse_url($uri); if (!$parts || !isset($parts['scheme'], $parts['host'], $parts['port']) || $parts['scheme'] !== 'tcp') { return Promise\reject(new \InvalidArgumentException('Given URI "' . $uri . '" is invalid (EINVAL)', \defined('SOCKET_EINVAL') ? \SOCKET_EINVAL : (\defined('PCNTL_EINVAL') ? \PCNTL_EINVAL : 22))); } $ip = \trim($parts['host'], '[]'); if (@\inet_pton($ip) === \false) { return Promise\reject(new \InvalidArgumentException('Given URI "' . $uri . '" does not contain a valid host IP (EINVAL)', \defined('SOCKET_EINVAL') ? \SOCKET_EINVAL : (\defined('PCNTL_EINVAL') ? \PCNTL_EINVAL : 22))); } // use context given in constructor $context = array('socket' => $this->context); // parse arguments from query component of URI $args = array(); if (isset($parts['query'])) { \parse_str($parts['query'], $args); } // If an original hostname has been given, use this for TLS setup. // This can happen due to layers of nested connectors, such as a // DnsConnector reporting its original hostname. // These context options are here in case TLS is enabled later on this stream. // If TLS is not enabled later, this doesn't hurt either. if (isset($args['hostname'])) { $context['ssl'] = array('SNI_enabled' => \true, 'peer_name' => $args['hostname']); // Legacy PHP < 5.6 ignores peer_name and requires legacy context options instead. // The SNI_server_name context option has to be set here during construction, // as legacy PHP ignores any values set later. // @codeCoverageIgnoreStart if (\PHP_VERSION_ID < 50600) { $context['ssl'] += array('SNI_server_name' => $args['hostname'], 'CN_match' => $args['hostname']); } // @codeCoverageIgnoreEnd } // latest versions of PHP no longer accept any other URI components and // HHVM fails to parse URIs with a query but no path, so let's simplify our URI here $remote = 'tcp://' . $parts['host'] . ':' . $parts['port']; $stream = @\stream_socket_client($remote, $errno, $errstr, 0, \STREAM_CLIENT_CONNECT | \STREAM_CLIENT_ASYNC_CONNECT, \stream_context_create($context)); if (\false === $stream) { return Promise\reject(new \RuntimeException('Connection to ' . $uri . ' failed: ' . $errstr . SocketServer::errconst($errno), $errno)); } // wait for connection $loop = $this->loop; return new Promise\Promise(function ($resolve, $reject) use($loop, $stream, $uri) { $loop->addWriteStream($stream, function ($stream) use($loop, $resolve, $reject, $uri) { $loop->removeWriteStream($stream); // The following hack looks like the only way to // detect connection refused errors with PHP's stream sockets. if (\false === \stream_socket_get_name($stream, \true)) { // If we reach this point, we know the connection is dead, but we don't know the underlying error condition. // @codeCoverageIgnoreStart if (\function_exists('socket_import_stream')) { // actual socket errno and errstr can be retrieved with ext-sockets on PHP 5.4+ $socket = \socket_import_stream($stream); $errno = \socket_get_option($socket, \SOL_SOCKET, \SO_ERROR); $errstr = \socket_strerror($errno); } elseif (\PHP_OS === 'Linux') { // Linux reports socket errno and errstr again when trying to write to the dead socket. // Suppress error reporting to get error message below and close dead socket before rejecting. // This is only known to work on Linux, Mac and Windows are known to not support this. $errno = 0; $errstr = ''; \set_error_handler(function ($_, $error) use(&$errno, &$errstr) { // Match errstr from PHP's warning message. // fwrite(): send of 1 bytes failed with errno=111 Connection refused \preg_match('/errno=(\\d+) (.+)/', $error, $m); $errno = isset($m[1]) ? (int) $m[1] : 0; $errstr = isset($m[2]) ? $m[2] : $error; }); \fwrite($stream, \PHP_EOL); \restore_error_handler(); } else { // Not on Linux and ext-sockets not available? Too bad. $errno = \defined('SOCKET_ECONNREFUSED') ? \SOCKET_ECONNREFUSED : 111; $errstr = 'Connection refused?'; } // @codeCoverageIgnoreEnd \fclose($stream); $reject(new \RuntimeException('Connection to ' . $uri . ' failed: ' . $errstr . SocketServer::errconst($errno), $errno)); } else { $resolve(new Connection($stream, $loop)); } }); }, function () use($loop, $stream, $uri) { $loop->removeWriteStream($stream); \fclose($stream); // @codeCoverageIgnoreStart // legacy PHP 5.3 sometimes requires a second close call (see tests) if (\PHP_VERSION_ID < 50400 && \is_resource($stream)) { \fclose($stream); } // @codeCoverageIgnoreEnd throw new \RuntimeException('Connection to ' . $uri . ' cancelled during TCP/IP handshake (ECONNABORTED)', \defined('SOCKET_ECONNABORTED') ? \SOCKET_ECONNABORTED : 103); }); } } <?php namespace _PHPStan_7d8742a37\React\Socket; use _PHPStan_7d8742a37\React\Dns\Resolver\ResolverInterface; use _PHPStan_7d8742a37\React\Promise; use _PHPStan_7d8742a37\React\Promise\PromiseInterface; final class DnsConnector implements ConnectorInterface { private $connector; private $resolver; public function __construct(ConnectorInterface $connector, ResolverInterface $resolver) { $this->connector = $connector; $this->resolver = $resolver; } public function connect($uri) { $original = $uri; if (\strpos($uri, '://') === \false) { $uri = 'tcp://' . $uri; $parts = \parse_url($uri); if (isset($parts['scheme'])) { unset($parts['scheme']); } } else { $parts = \parse_url($uri); } if (!$parts || !isset($parts['host'])) { return Promise\reject(new \InvalidArgumentException('Given URI "' . $original . '" is invalid (EINVAL)', \defined('SOCKET_EINVAL') ? \SOCKET_EINVAL : (\defined('PCNTL_EINVAL') ? \PCNTL_EINVAL : 22))); } $host = \trim($parts['host'], '[]'); $connector = $this->connector; // skip DNS lookup / URI manipulation if this URI already contains an IP if (@\inet_pton($host) !== \false) { return $connector->connect($original); } $promise = $this->resolver->resolve($host); $resolved = null; return new Promise\Promise(function ($resolve, $reject) use(&$promise, &$resolved, $uri, $connector, $host, $parts) { // resolve/reject with result of DNS lookup $promise->then(function ($ip) use(&$promise, &$resolved, $uri, $connector, $host, $parts) { $resolved = $ip; return $promise = $connector->connect(Connector::uri($parts, $host, $ip))->then(null, function (\Exception $e) use($uri) { if ($e instanceof \RuntimeException) { $message = \preg_replace('/^(Connection to [^ ]+)[&?]hostname=[^ &]+/', '$1', $e->getMessage()); $e = new \RuntimeException('Connection to ' . $uri . ' failed: ' . $message, $e->getCode(), $e); // avoid garbage references by replacing all closures in call stack. // what a lovely piece of code! $r = new \ReflectionProperty('Exception', 'trace'); $r->setAccessible(\true); $trace = $r->getValue($e); // Exception trace arguments are not available on some PHP 7.4 installs // @codeCoverageIgnoreStart foreach ($trace as $ti => $one) { if (isset($one['args'])) { foreach ($one['args'] as $ai => $arg) { if ($arg instanceof \Closure) { $trace[$ti]['args'][$ai] = 'Object(' . \get_class($arg) . ')'; } } } } // @codeCoverageIgnoreEnd $r->setValue($e, $trace); } throw $e; }); }, function ($e) use($uri, $reject) { $reject(new \RuntimeException('Connection to ' . $uri . ' failed during DNS lookup: ' . $e->getMessage(), 0, $e)); })->then($resolve, $reject); }, function ($_, $reject) use(&$promise, &$resolved, $uri) { // cancellation should reject connection attempt // reject DNS resolution with custom reason, otherwise rely on connection cancellation below if ($resolved === null) { $reject(new \RuntimeException('Connection to ' . $uri . ' cancelled during DNS lookup (ECONNABORTED)', \defined('SOCKET_ECONNABORTED') ? \SOCKET_ECONNABORTED : 103)); } // (try to) cancel pending DNS lookup / connection attempt if ($promise instanceof PromiseInterface && \method_exists($promise, 'cancel')) { // overwrite callback arguments for PHP7+ only, so they do not show // up in the Exception trace and do not cause a possible cyclic reference. $_ = $reject = null; $promise->cancel(); $promise = null; } }); } } <?php namespace _PHPStan_7d8742a37\React\Socket; use _PHPStan_7d8742a37\React\EventLoop\Loop; use _PHPStan_7d8742a37\React\EventLoop\LoopInterface; use _PHPStan_7d8742a37\React\Promise\Promise; final class TimeoutConnector implements ConnectorInterface { private $connector; private $timeout; private $loop; /** * @param ConnectorInterface $connector * @param float $timeout * @param ?LoopInterface $loop */ public function __construct(ConnectorInterface $connector, $timeout, $loop = null) { if ($loop !== null && !$loop instanceof LoopInterface) { // manual type check to support legacy PHP < 7.1 throw new \InvalidArgumentException('_PHPStan_7d8742a37\\Argument #3 ($loop) expected null|React\\EventLoop\\LoopInterface'); } $this->connector = $connector; $this->timeout = $timeout; $this->loop = $loop ?: Loop::get(); } public function connect($uri) { $promise = $this->connector->connect($uri); $loop = $this->loop; $time = $this->timeout; return new Promise(function ($resolve, $reject) use($loop, $time, $promise, $uri) { $timer = null; $promise = $promise->then(function ($v) use(&$timer, $loop, $resolve) { if ($timer) { $loop->cancelTimer($timer); } $timer = \false; $resolve($v); }, function ($v) use(&$timer, $loop, $reject) { if ($timer) { $loop->cancelTimer($timer); } $timer = \false; $reject($v); }); // promise already resolved => no need to start timer if ($timer === \false) { return; } // start timeout timer which will cancel the pending promise $timer = $loop->addTimer($time, function () use($time, &$promise, $reject, $uri) { $reject(new \RuntimeException('Connection to ' . $uri . ' timed out after ' . $time . ' seconds (ETIMEDOUT)', \defined('SOCKET_ETIMEDOUT') ? \SOCKET_ETIMEDOUT : 110)); // Cancel pending connection to clean up any underlying resources and references. // Avoid garbage references in call stack by passing pending promise by reference. \assert(\method_exists($promise, 'cancel')); $promise->cancel(); $promise = null; }); }, function () use(&$promise) { // Cancelling this promise will cancel the pending connection, thus triggering the rejection logic above. // Avoid garbage references in call stack by passing pending promise by reference. \assert(\method_exists($promise, 'cancel')); $promise->cancel(); $promise = null; }); } } <?php namespace _PHPStan_7d8742a37\React\Socket; use _PHPStan_7d8742a37\Evenement\EventEmitter; use _PHPStan_7d8742a37\React\EventLoop\LoopInterface; final class SocketServer extends EventEmitter implements ServerInterface { private $server; /** * The `SocketServer` class is the main class in this package that implements the `ServerInterface` and * allows you to accept incoming streaming connections, such as plaintext TCP/IP or secure TLS connection streams. * * ```php * $socket = new React\Socket\SocketServer('127.0.0.1:0'); * $socket = new React\Socket\SocketServer('127.0.0.1:8000'); * $socket = new React\Socket\SocketServer('127.0.0.1:8000', $context); * ``` * * This class takes an optional `LoopInterface|null $loop` parameter that can be used to * pass the event loop instance to use for this object. You can use a `null` value * here in order to use the [default loop](https://github.com/reactphp/event-loop#loop). * This value SHOULD NOT be given unless you're sure you want to explicitly use a * given event loop instance. * * @param string $uri * @param array $context * @param ?LoopInterface $loop * @throws \InvalidArgumentException if the listening address is invalid * @throws \RuntimeException if listening on this address fails (already in use etc.) */ public function __construct($uri, array $context = array(), $loop = null) { if ($loop !== null && !$loop instanceof LoopInterface) { // manual type check to support legacy PHP < 7.1 throw new \InvalidArgumentException('_PHPStan_7d8742a37\\Argument #3 ($loop) expected null|React\\EventLoop\\LoopInterface'); } // apply default options if not explicitly given $context += array('tcp' => array(), 'tls' => array(), 'unix' => array()); $scheme = 'tcp'; $pos = \strpos($uri, '://'); if ($pos !== \false) { $scheme = \substr($uri, 0, $pos); } if ($scheme === 'unix') { $server = new UnixServer($uri, $loop, $context['unix']); } elseif ($scheme === 'php') { $server = new FdServer($uri, $loop); } else { if (\preg_match('#^(?:\\w+://)?\\d+$#', $uri)) { throw new \InvalidArgumentException('Invalid URI given (EINVAL)', \defined('SOCKET_EINVAL') ? \SOCKET_EINVAL : (\defined('PCNTL_EINVAL') ? \PCNTL_EINVAL : 22)); } $server = new TcpServer(\str_replace('tls://', '', $uri), $loop, $context['tcp']); if ($scheme === 'tls') { $server = new SecureServer($server, $loop, $context['tls']); } } $this->server = $server; $that = $this; $server->on('connection', function (ConnectionInterface $conn) use($that) { $that->emit('connection', array($conn)); }); $server->on('error', function (\Exception $error) use($that) { $that->emit('error', array($error)); }); } public function getAddress() { return $this->server->getAddress(); } public function pause() { $this->server->pause(); } public function resume() { $this->server->resume(); } public function close() { $this->server->close(); } /** * [internal] Internal helper method to accept new connection from given server socket * * @param resource $socket server socket to accept connection from * @return resource new client socket if any * @throws \RuntimeException if accepting fails * @internal */ public static function accept($socket) { $errno = 0; $errstr = ''; \set_error_handler(function ($_, $error) use(&$errno, &$errstr) { // Match errstr from PHP's warning message. // stream_socket_accept(): accept failed: Connection timed out $errstr = \preg_replace('#.*: #', '', $error); $errno = SocketServer::errno($errstr); }); $newSocket = \stream_socket_accept($socket, 0); \restore_error_handler(); if (\false === $newSocket) { throw new \RuntimeException('Unable to accept new connection: ' . $errstr . self::errconst($errno), $errno); } return $newSocket; } /** * [Internal] Returns errno value for given errstr * * The errno and errstr values describes the type of error that has been * encountered. This method tries to look up the given errstr and find a * matching errno value which can be useful to provide more context to error * messages. It goes through the list of known errno constants when either * `ext-sockets`, `ext-posix` or `ext-pcntl` is available to find an errno * matching the given errstr. * * @param string $errstr * @return int errno value (e.g. value of `SOCKET_ECONNREFUSED`) or 0 if not found * @internal * @copyright Copyright (c) 2023 Christian Lück, taken from https://github.com/clue/errno with permission * @codeCoverageIgnore */ public static function errno($errstr) { // PHP defines the required `strerror()` function through either `ext-sockets`, `ext-posix` or `ext-pcntl` $strerror = \function_exists('socket_strerror') ? 'socket_strerror' : (\function_exists('posix_strerror') ? 'posix_strerror' : (\function_exists('pcntl_strerror') ? 'pcntl_strerror' : null)); if ($strerror !== null) { \assert(\is_string($strerror) && \is_callable($strerror)); // PHP defines most useful errno constants like `ECONNREFUSED` through constants in `ext-sockets` like `SOCKET_ECONNREFUSED` // PHP also defines a hand full of errno constants like `EMFILE` through constants in `ext-pcntl` like `PCNTL_EMFILE` // go through list of all defined constants like `SOCKET_E*` and `PCNTL_E*` and see if they match the given `$errstr` foreach (\get_defined_constants(\false) as $name => $value) { if (\is_int($value) && (\strpos($name, 'SOCKET_E') === 0 || \strpos($name, 'PCNTL_E') === 0) && $strerror($value) === $errstr) { return $value; } } // if we reach this, no matching errno constant could be found (unlikely when `ext-sockets` is available) // go through list of all possible errno values from 1 to `MAX_ERRNO` and see if they match the given `$errstr` for ($errno = 1, $max = \defined('_PHPStan_7d8742a37\\MAX_ERRNO') ? \_PHPStan_7d8742a37\MAX_ERRNO : 4095; $errno <= $max; ++$errno) { if ($strerror($errno) === $errstr) { return $errno; } } } // if we reach this, no matching errno value could be found (unlikely when either `ext-sockets`, `ext-posix` or `ext-pcntl` is available) return 0; } /** * [Internal] Returns errno constant name for given errno value * * The errno value describes the type of error that has been encountered. * This method tries to look up the given errno value and find a matching * errno constant name which can be useful to provide more context and more * descriptive error messages. It goes through the list of known errno * constants when either `ext-sockets` or `ext-pcntl` is available to find * the matching errno constant name. * * Because this method is used to append more context to error messages, the * constant name will be prefixed with a space and put between parenthesis * when found. * * @param int $errno * @return string e.g. ` (ECONNREFUSED)` or empty string if no matching const for the given errno could be found * @internal * @copyright Copyright (c) 2023 Christian Lück, taken from https://github.com/clue/errno with permission * @codeCoverageIgnore */ public static function errconst($errno) { // PHP defines most useful errno constants like `ECONNREFUSED` through constants in `ext-sockets` like `SOCKET_ECONNREFUSED` // PHP also defines a hand full of errno constants like `EMFILE` through constants in `ext-pcntl` like `PCNTL_EMFILE` // go through list of all defined constants like `SOCKET_E*` and `PCNTL_E*` and see if they match the given `$errno` foreach (\get_defined_constants(\false) as $name => $value) { if ($value === $errno && (\strpos($name, 'SOCKET_E') === 0 || \strpos($name, 'PCNTL_E') === 0)) { return ' (' . \substr($name, \strpos($name, '_') + 1) . ')'; } } // if we reach this, no matching errno constant could be found (unlikely when `ext-sockets` is available) return ''; } } <?php namespace _PHPStan_7d8742a37\React\Socket; use _PHPStan_7d8742a37\Evenement\EventEmitter; use _PHPStan_7d8742a37\React\EventLoop\Loop; use _PHPStan_7d8742a37\React\EventLoop\LoopInterface; use InvalidArgumentException; use RuntimeException; /** * The `TcpServer` class implements the `ServerInterface` and * is responsible for accepting plaintext TCP/IP connections. * * ```php * $server = new React\Socket\TcpServer(8080); * ``` * * Whenever a client connects, it will emit a `connection` event with a connection * instance implementing `ConnectionInterface`: * * ```php * $server->on('connection', function (React\Socket\ConnectionInterface $connection) { * echo 'Plaintext connection from ' . $connection->getRemoteAddress() . PHP_EOL; * $connection->write('hello there!' . PHP_EOL); * … * }); * ``` * * See also the `ServerInterface` for more details. * * @see ServerInterface * @see ConnectionInterface */ final class TcpServer extends EventEmitter implements ServerInterface { private $master; private $loop; private $listening = \false; /** * Creates a plaintext TCP/IP socket server and starts listening on the given address * * This starts accepting new incoming connections on the given address. * See also the `connection event` documented in the `ServerInterface` * for more details. * * ```php * $server = new React\Socket\TcpServer(8080); * ``` * * As above, the `$uri` parameter can consist of only a port, in which case the * server will default to listening on the localhost address `127.0.0.1`, * which means it will not be reachable from outside of this system. * * In order to use a random port assignment, you can use the port `0`: * * ```php * $server = new React\Socket\TcpServer(0); * $address = $server->getAddress(); * ``` * * In order to change the host the socket is listening on, you can provide an IP * address through the first parameter provided to the constructor, optionally * preceded by the `tcp://` scheme: * * ```php * $server = new React\Socket\TcpServer('192.168.0.1:8080'); * ``` * * If you want to listen on an IPv6 address, you MUST enclose the host in square * brackets: * * ```php * $server = new React\Socket\TcpServer('[::1]:8080'); * ``` * * If the given URI is invalid, does not contain a port, any other scheme or if it * contains a hostname, it will throw an `InvalidArgumentException`: * * ```php * // throws InvalidArgumentException due to missing port * $server = new React\Socket\TcpServer('127.0.0.1'); * ``` * * If the given URI appears to be valid, but listening on it fails (such as if port * is already in use or port below 1024 may require root access etc.), it will * throw a `RuntimeException`: * * ```php * $first = new React\Socket\TcpServer(8080); * * // throws RuntimeException because port is already in use * $second = new React\Socket\TcpServer(8080); * ``` * * Note that these error conditions may vary depending on your system and/or * configuration. * See the exception message and code for more details about the actual error * condition. * * This class takes an optional `LoopInterface|null $loop` parameter that can be used to * pass the event loop instance to use for this object. You can use a `null` value * here in order to use the [default loop](https://github.com/reactphp/event-loop#loop). * This value SHOULD NOT be given unless you're sure you want to explicitly use a * given event loop instance. * * Optionally, you can specify [socket context options](https://www.php.net/manual/en/context.socket.php) * for the underlying stream socket resource like this: * * ```php * $server = new React\Socket\TcpServer('[::1]:8080', null, array( * 'backlog' => 200, * 'so_reuseport' => true, * 'ipv6_v6only' => true * )); * ``` * * Note that available [socket context options](https://www.php.net/manual/en/context.socket.php), * their defaults and effects of changing these may vary depending on your system * and/or PHP version. * Passing unknown context options has no effect. * The `backlog` context option defaults to `511` unless given explicitly. * * @param string|int $uri * @param ?LoopInterface $loop * @param array $context * @throws InvalidArgumentException if the listening address is invalid * @throws RuntimeException if listening on this address fails (already in use etc.) */ public function __construct($uri, $loop = null, array $context = array()) { if ($loop !== null && !$loop instanceof LoopInterface) { // manual type check to support legacy PHP < 7.1 throw new \InvalidArgumentException('_PHPStan_7d8742a37\\Argument #2 ($loop) expected null|React\\EventLoop\\LoopInterface'); } $this->loop = $loop ?: Loop::get(); // a single port has been given => assume localhost if ((string) (int) $uri === (string) $uri) { $uri = '127.0.0.1:' . $uri; } // assume default scheme if none has been given if (\strpos($uri, '://') === \false) { $uri = 'tcp://' . $uri; } // parse_url() does not accept null ports (random port assignment) => manually remove if (\substr($uri, -2) === ':0') { $parts = \parse_url(\substr($uri, 0, -2)); if ($parts) { $parts['port'] = 0; } } else { $parts = \parse_url($uri); } // ensure URI contains TCP scheme, host and port if (!$parts || !isset($parts['scheme'], $parts['host'], $parts['port']) || $parts['scheme'] !== 'tcp') { throw new \InvalidArgumentException('Invalid URI "' . $uri . '" given (EINVAL)', \defined('SOCKET_EINVAL') ? \SOCKET_EINVAL : (\defined('PCNTL_EINVAL') ? \PCNTL_EINVAL : 22)); } if (@\inet_pton(\trim($parts['host'], '[]')) === \false) { throw new \InvalidArgumentException('Given URI "' . $uri . '" does not contain a valid host IP (EINVAL)', \defined('SOCKET_EINVAL') ? \SOCKET_EINVAL : (\defined('PCNTL_EINVAL') ? \PCNTL_EINVAL : 22)); } $this->master = @\stream_socket_server($uri, $errno, $errstr, \STREAM_SERVER_BIND | \STREAM_SERVER_LISTEN, \stream_context_create(array('socket' => $context + array('backlog' => 511)))); if (\false === $this->master) { if ($errno === 0) { // PHP does not seem to report errno, so match errno from errstr // @link https://3v4l.org/3qOBl $errno = SocketServer::errno($errstr); } throw new \RuntimeException('Failed to listen on "' . $uri . '": ' . $errstr . SocketServer::errconst($errno), $errno); } \stream_set_blocking($this->master, \false); $this->resume(); } public function getAddress() { if (!\is_resource($this->master)) { return null; } $address = \stream_socket_get_name($this->master, \false); // check if this is an IPv6 address which includes multiple colons but no square brackets $pos = \strrpos($address, ':'); if ($pos !== \false && \strpos($address, ':') < $pos && \substr($address, 0, 1) !== '[') { $address = '[' . \substr($address, 0, $pos) . ']:' . \substr($address, $pos + 1); // @codeCoverageIgnore } return 'tcp://' . $address; } public function pause() { if (!$this->listening) { return; } $this->loop->removeReadStream($this->master); $this->listening = \false; } public function resume() { if ($this->listening || !\is_resource($this->master)) { return; } $that = $this; $this->loop->addReadStream($this->master, function ($master) use($that) { try { $newSocket = SocketServer::accept($master); } catch (\RuntimeException $e) { $that->emit('error', array($e)); return; } $that->handleConnection($newSocket); }); $this->listening = \true; } public function close() { if (!\is_resource($this->master)) { return; } $this->pause(); \fclose($this->master); $this->removeAllListeners(); } /** @internal */ public function handleConnection($socket) { $this->emit('connection', array(new Connection($socket, $this->loop))); } } <?php namespace _PHPStan_7d8742a37\React\Socket; use _PHPStan_7d8742a37\React\Dns\Config\Config as DnsConfig; use _PHPStan_7d8742a37\React\Dns\Resolver\Factory as DnsFactory; use _PHPStan_7d8742a37\React\Dns\Resolver\ResolverInterface; use _PHPStan_7d8742a37\React\EventLoop\LoopInterface; /** * The `Connector` class is the main class in this package that implements the * `ConnectorInterface` and allows you to create streaming connections. * * You can use this connector to create any kind of streaming connections, such * as plaintext TCP/IP, secure TLS or local Unix connection streams. * * Under the hood, the `Connector` is implemented as a *higher-level facade* * for the lower-level connectors implemented in this package. This means it * also shares all of their features and implementation details. * If you want to typehint in your higher-level protocol implementation, you SHOULD * use the generic [`ConnectorInterface`](#connectorinterface) instead. * * @see ConnectorInterface for the base interface */ final class Connector implements ConnectorInterface { private $connectors = array(); /** * Instantiate new `Connector` * * ```php * $connector = new React\Socket\Connector(); * ``` * * This class takes two optional arguments for more advanced usage: * * ```php * // constructor signature as of v1.9.0 * $connector = new React\Socket\Connector(array $context = [], ?LoopInterface $loop = null); * * // legacy constructor signature before v1.9.0 * $connector = new React\Socket\Connector(?LoopInterface $loop = null, array $context = []); * ``` * * This class takes an optional `LoopInterface|null $loop` parameter that can be used to * pass the event loop instance to use for this object. You can use a `null` value * here in order to use the [default loop](https://github.com/reactphp/event-loop#loop). * This value SHOULD NOT be given unless you're sure you want to explicitly use a * given event loop instance. * * @param array|LoopInterface|null $context * @param null|LoopInterface|array $loop * @throws \InvalidArgumentException for invalid arguments */ public function __construct($context = array(), $loop = null) { // swap arguments for legacy constructor signature if (($context instanceof LoopInterface || $context === null) && (\func_num_args() <= 1 || \is_array($loop))) { $swap = $loop === null ? array() : $loop; $loop = $context; $context = $swap; } if (!\is_array($context) || $loop !== null && !$loop instanceof LoopInterface) { throw new \InvalidArgumentException('Expected "array $context" and "?LoopInterface $loop" arguments'); } // apply default options if not explicitly given $context += array('tcp' => \true, 'tls' => \true, 'unix' => \true, 'dns' => \true, 'timeout' => \true, 'happy_eyeballs' => \true); if ($context['timeout'] === \true) { $context['timeout'] = (float) \ini_get("default_socket_timeout"); } if ($context['tcp'] instanceof ConnectorInterface) { $tcp = $context['tcp']; } else { $tcp = new TcpConnector($loop, \is_array($context['tcp']) ? $context['tcp'] : array()); } if ($context['dns'] !== \false) { if ($context['dns'] instanceof ResolverInterface) { $resolver = $context['dns']; } else { if ($context['dns'] !== \true) { $config = $context['dns']; } else { // try to load nameservers from system config or default to Google's public DNS $config = DnsConfig::loadSystemConfigBlocking(); if (!$config->nameservers) { $config->nameservers[] = '8.8.8.8'; // @codeCoverageIgnore } } $factory = new DnsFactory(); $resolver = $factory->createCached($config, $loop); } if ($context['happy_eyeballs'] === \true) { $tcp = new HappyEyeBallsConnector($loop, $tcp, $resolver); } else { $tcp = new DnsConnector($tcp, $resolver); } } if ($context['tcp'] !== \false) { $context['tcp'] = $tcp; if ($context['timeout'] !== \false) { $context['tcp'] = new TimeoutConnector($context['tcp'], $context['timeout'], $loop); } $this->connectors['tcp'] = $context['tcp']; } if ($context['tls'] !== \false) { if (!$context['tls'] instanceof ConnectorInterface) { $context['tls'] = new SecureConnector($tcp, $loop, \is_array($context['tls']) ? $context['tls'] : array()); } if ($context['timeout'] !== \false) { $context['tls'] = new TimeoutConnector($context['tls'], $context['timeout'], $loop); } $this->connectors['tls'] = $context['tls']; } if ($context['unix'] !== \false) { if (!$context['unix'] instanceof ConnectorInterface) { $context['unix'] = new UnixConnector($loop); } $this->connectors['unix'] = $context['unix']; } } public function connect($uri) { $scheme = 'tcp'; if (\strpos($uri, '://') !== \false) { $scheme = (string) \substr($uri, 0, \strpos($uri, '://')); } if (!isset($this->connectors[$scheme])) { return \_PHPStan_7d8742a37\React\Promise\reject(new \RuntimeException('No connector available for URI scheme "' . $scheme . '" (EINVAL)', \defined('SOCKET_EINVAL') ? \SOCKET_EINVAL : (\defined('PCNTL_EINVAL') ? \PCNTL_EINVAL : 22))); } return $this->connectors[$scheme]->connect($uri); } /** * [internal] Builds on URI from the given URI parts and ip address with original hostname as query * * @param array $parts * @param string $host * @param string $ip * @return string * @internal */ public static function uri(array $parts, $host, $ip) { $uri = ''; // prepend original scheme if known if (isset($parts['scheme'])) { $uri .= $parts['scheme'] . '://'; } if (\strpos($ip, ':') !== \false) { // enclose IPv6 addresses in square brackets before appending port $uri .= '[' . $ip . ']'; } else { $uri .= $ip; } // append original port if known if (isset($parts['port'])) { $uri .= ':' . $parts['port']; } // append orignal path if known if (isset($parts['path'])) { $uri .= $parts['path']; } // append original query if known if (isset($parts['query'])) { $uri .= '?' . $parts['query']; } // append original hostname as query if resolved via DNS and if // destination URI does not contain "hostname" query param already $args = array(); \parse_str(isset($parts['query']) ? $parts['query'] : '', $args); if ($host !== $ip && !isset($args['hostname'])) { $uri .= (isset($parts['query']) ? '&' : '?') . 'hostname=' . \rawurlencode($host); } // append original fragment if known if (isset($parts['fragment'])) { $uri .= '#' . $parts['fragment']; } return $uri; } } <?php namespace _PHPStan_7d8742a37\React\Socket; use _PHPStan_7d8742a37\Evenement\EventEmitter; use _PHPStan_7d8742a37\React\EventLoop\LoopInterface; use _PHPStan_7d8742a37\React\Stream\DuplexResourceStream; use _PHPStan_7d8742a37\React\Stream\Util; use _PHPStan_7d8742a37\React\Stream\WritableResourceStream; use _PHPStan_7d8742a37\React\Stream\WritableStreamInterface; /** * The actual connection implementation for ConnectionInterface * * This class should only be used internally, see ConnectionInterface instead. * * @see ConnectionInterface * @internal */ class Connection extends EventEmitter implements ConnectionInterface { /** * Internal flag whether this is a Unix domain socket (UDS) connection * * @internal */ public $unix = \false; /** * Internal flag whether encryption has been enabled on this connection * * Mostly used by internal StreamEncryption so that connection returns * `tls://` scheme for encrypted connections instead of `tcp://`. * * @internal */ public $encryptionEnabled = \false; /** @internal */ public $stream; private $input; public function __construct($resource, LoopInterface $loop) { // PHP < 7.3.3 (and PHP < 7.2.15) suffers from a bug where feof() might // block with 100% CPU usage on fragmented TLS records. // We try to work around this by always consuming the complete receive // buffer at once to avoid stale data in TLS buffers. This is known to // work around high CPU usage for well-behaving peers, but this may // cause very large data chunks for high throughput scenarios. The buggy // behavior can still be triggered due to network I/O buffers or // malicious peers on affected versions, upgrading is highly recommended. // @link https://bugs.php.net/bug.php?id=77390 $clearCompleteBuffer = \PHP_VERSION_ID < 70215 || \PHP_VERSION_ID >= 70300 && \PHP_VERSION_ID < 70303; // PHP < 7.1.4 (and PHP < 7.0.18) suffers from a bug when writing big // chunks of data over TLS streams at once. // We try to work around this by limiting the write chunk size to 8192 // bytes for older PHP versions only. // This is only a work-around and has a noticable performance penalty on // affected versions. Please update your PHP version. // This applies to all streams because TLS may be enabled later on. // See https://github.com/reactphp/socket/issues/105 $limitWriteChunks = \PHP_VERSION_ID < 70018 || \PHP_VERSION_ID >= 70100 && \PHP_VERSION_ID < 70104; $this->input = new DuplexResourceStream($resource, $loop, $clearCompleteBuffer ? -1 : null, new WritableResourceStream($resource, $loop, null, $limitWriteChunks ? 8192 : null)); $this->stream = $resource; Util::forwardEvents($this->input, $this, array('data', 'end', 'error', 'close', 'pipe', 'drain')); $this->input->on('close', array($this, 'close')); } public function isReadable() { return $this->input->isReadable(); } public function isWritable() { return $this->input->isWritable(); } public function pause() { $this->input->pause(); } public function resume() { $this->input->resume(); } public function pipe(WritableStreamInterface $dest, array $options = array()) { return $this->input->pipe($dest, $options); } public function write($data) { return $this->input->write($data); } public function end($data = null) { $this->input->end($data); } public function close() { $this->input->close(); $this->handleClose(); $this->removeAllListeners(); } public function handleClose() { if (!\is_resource($this->stream)) { return; } // Try to cleanly shut down socket and ignore any errors in case other // side already closed. Underlying Stream implementation will take care // of closing stream resource, so we otherwise keep this open here. @\stream_socket_shutdown($this->stream, \STREAM_SHUT_RDWR); } public function getRemoteAddress() { if (!\is_resource($this->stream)) { return null; } return $this->parseAddress(\stream_socket_get_name($this->stream, \true)); } public function getLocalAddress() { if (!\is_resource($this->stream)) { return null; } return $this->parseAddress(\stream_socket_get_name($this->stream, \false)); } private function parseAddress($address) { if ($address === \false) { return null; } if ($this->unix) { // remove trailing colon from address for HHVM < 3.19: https://3v4l.org/5C1lo // note that technically ":" is a valid address, so keep this in place otherwise if (\substr($address, -1) === ':' && \defined('_PHPStan_7d8742a37\\HHVM_VERSION_ID') && \_PHPStan_7d8742a37\HHVM_VERSION_ID < 31900) { $address = (string) \substr($address, 0, -1); // @codeCoverageIgnore } // work around unknown addresses should return null value: https://3v4l.org/5C1lo and https://bugs.php.net/bug.php?id=74556 // PHP uses "\0" string and HHVM uses empty string (colon removed above) if ($address === '' || $address[0] === "\x00") { return null; // @codeCoverageIgnore } return 'unix://' . $address; } // check if this is an IPv6 address which includes multiple colons but no square brackets $pos = \strrpos($address, ':'); if ($pos !== \false && \strpos($address, ':') < $pos && \substr($address, 0, 1) !== '[') { $address = '[' . \substr($address, 0, $pos) . ']:' . \substr($address, $pos + 1); // @codeCoverageIgnore } return ($this->encryptionEnabled ? 'tls' : 'tcp') . '://' . $address; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\DI\Definitions; use _PHPStan_7d8742a37\Nette; use _PHPStan_7d8742a37\Nette\DI\ServiceCreationException; /** * Definition of standard service. * * @property string|null $class * @property Statement $factory * @property Statement[] $setup */ final class ServiceDefinition extends Definition { /** @var Statement */ private $creator; /** @var Statement[] */ private $setup = []; public function __construct() { $this->creator = new Statement(null); } /** @return static */ public function setType(?string $type) { return parent::setType($type); } /** * Alias for setCreator() * @param string|array|Definition|Reference|Statement $factory * @return static */ public function setFactory($factory, array $args = []) { return $this->setCreator($factory, $args); } /** * Alias for getCreator() */ public function getFactory() : Statement { return $this->getCreator(); } /** * @param string|array|Definition|Reference|Statement $creator * @return static */ public function setCreator($creator, array $args = []) { $this->creator = $creator instanceof Statement ? $creator : new Statement($creator, $args); return $this; } public function getCreator() : Statement { return $this->creator; } /** @return string|array|Definition|Reference|null */ public function getEntity() { return $this->creator->getEntity(); } /** @return static */ public function setArguments(array $args = []) { $this->creator->arguments = $args; return $this; } /** @return static */ public function setArgument($key, $value) { $this->creator->arguments[$key] = $value; return $this; } /** * @param Statement[] $setup * @return static */ public function setSetup(array $setup) { foreach ($setup as $v) { if (!$v instanceof Statement) { throw new Nette\InvalidArgumentException('Argument must be Nette\\DI\\Definitions\\Statement[].'); } } $this->setup = $setup; return $this; } /** @return Statement[] */ public function getSetup() : array { return $this->setup; } /** * @param string|array|Definition|Reference|Statement $entity * @return static */ public function addSetup($entity, array $args = []) { $this->setup[] = $entity instanceof Statement ? $entity : new Statement($entity, $args); return $this; } public function resolveType(Nette\DI\Resolver $resolver) : void { if (!$this->getEntity()) { if (!$this->getType()) { throw new ServiceCreationException('Factory and type are missing in definition of service.'); } $this->setCreator($this->getType(), $this->creator->arguments ?? []); } elseif (!$this->getType()) { $type = $resolver->resolveEntityType($this->creator); if (!$type) { throw new ServiceCreationException('Unknown service type, specify it or declare return type of factory method.'); } $this->setType($type); $resolver->addDependency(new \ReflectionClass($type)); } // auto-disable autowiring for aliases if ($this->getAutowired() === \true && $this->getEntity() instanceof Reference) { $this->setAutowired(\false); } } public function complete(Nette\DI\Resolver $resolver) : void { $entity = $this->creator->getEntity(); if ($entity instanceof Reference && !$this->creator->arguments && !$this->setup) { $ref = $resolver->normalizeReference($entity); $this->setCreator([new Reference(Nette\DI\ContainerBuilder::ThisContainer), 'getService'], [$ref->getValue()]); } $this->creator = $resolver->completeStatement($this->creator); foreach ($this->setup as &$setup) { if (\is_string($setup->getEntity()) && \strpbrk($setup->getEntity(), ':@?\\') === \false) { // auto-prepend @self $setup = new Statement([new Reference(Reference::Self), $setup->getEntity()], $setup->arguments); } $setup = $resolver->completeStatement($setup, \true); } } public function generateMethod(Nette\PhpGenerator\Method $method, Nette\DI\PhpGenerator $generator) : void { $entity = $this->creator->getEntity(); $code = $generator->formatStatement($this->creator) . ";\n"; if (!$this->setup) { $method->setBody('return ' . $code); return; } $code = '$service = ' . $code; foreach ($this->setup as $setup) { $code .= $generator->formatStatement($setup) . ";\n"; } $code .= 'return $service;'; $method->setBody($code); } public function __clone() { parent::__clone(); $this->creator = \unserialize(\serialize($this->creator)); $this->setup = \unserialize(\serialize($this->setup)); } } \class_exists(Nette\DI\ServiceDefinition::class); <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\DI\Definitions; use _PHPStan_7d8742a37\Nette; use _PHPStan_7d8742a37\Nette\DI\Helpers; use _PHPStan_7d8742a37\Nette\Utils\Type; /** * Accessor definition. */ final class AccessorDefinition extends Definition { private const MethodGet = 'get'; /** @var Reference|null */ private $reference; /** @return static */ public function setImplement(string $interface) { if (!\interface_exists($interface)) { throw new Nette\InvalidArgumentException(\sprintf("Service '%s': Interface '%s' not found.", $this->getName(), $interface)); } $rc = new \ReflectionClass($interface); $method = $rc->getMethods()[0] ?? null; if (!$method || $method->isStatic() || $method->getName() !== self::MethodGet || \count($rc->getMethods()) > 1) { throw new Nette\InvalidArgumentException(\sprintf("Service '%s': Interface %s must have just one non-static method get().", $this->getName(), $interface)); } elseif ($method->getNumberOfParameters()) { throw new Nette\InvalidArgumentException(\sprintf("Service '%s': Method %s::get() must have no parameters.", $this->getName(), $interface)); } try { Helpers::ensureClassType(Type::fromReflection($method), "return type of {$interface}::get()"); } catch (Nette\DI\ServiceCreationException $e) { \trigger_error($e->getMessage(), \E_USER_DEPRECATED); } return parent::setType($interface); } public function getImplement() : ?string { return $this->getType(); } /** * @param string|Reference $reference * @return static */ public function setReference($reference) { if ($reference instanceof Reference) { $this->reference = $reference; } else { $this->reference = \substr($reference, 0, 1) === '@' ? new Reference(\substr($reference, 1)) : Reference::fromType($reference); } return $this; } public function getReference() : ?Reference { return $this->reference; } public function resolveType(Nette\DI\Resolver $resolver) : void { } public function complete(Nette\DI\Resolver $resolver) : void { if (!$this->reference) { $interface = $this->getType(); $method = new \ReflectionMethod($interface, self::MethodGet); $type = Type::fromReflection($method) ?? Helpers::getReturnTypeAnnotation($method); $this->setReference(Helpers::ensureClassType($type, "return type of {$interface}::get()")); } $this->reference = $resolver->normalizeReference($this->reference); } public function generateMethod(Nette\PhpGenerator\Method $method, Nette\DI\PhpGenerator $generator) : void { $class = (new Nette\PhpGenerator\ClassType())->addImplement($this->getType()); $class->addProperty('container')->setPrivate(); $class->addMethod('__construct')->addBody('$this->container = $container;')->addParameter('container')->setType($generator->getClassName()); $rm = new \ReflectionMethod($this->getType(), self::MethodGet); $class->addMethod(self::MethodGet)->setBody('return $this->container->getService(?);', [$this->reference->getValue()])->setReturnType((string) Type::fromReflection($rm)); $method->setBody('return new class ($this) ' . $class . ';'); } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\DI\Definitions; use _PHPStan_7d8742a37\Nette; use _PHPStan_7d8742a37\Nette\Utils\Strings; /** * Assignment or calling statement. * * @property string|array|Definition|Reference|null $entity */ final class Statement implements Nette\Schema\DynamicParameter { use Nette\SmartObject; /** @var array */ public $arguments; /** @var string|array|Definition|Reference|null */ private $entity; /** * @param string|array|Definition|Reference|null $entity */ public function __construct($entity, array $arguments = []) { if ($entity !== null && !\is_string($entity) && !$entity instanceof Definition && !$entity instanceof Reference && !(\is_array($entity) && \array_keys($entity) === [0, 1] && (\is_string($entity[0]) || $entity[0] instanceof self || $entity[0] instanceof Reference || $entity[0] instanceof Definition))) { throw new Nette\InvalidArgumentException('Argument is not valid Statement entity.'); } // normalize Class::method to [Class, method] if (\is_string($entity) && Strings::contains($entity, '::') && !Strings::contains($entity, '?')) { $entity = \explode('::', $entity, 2); } if (\is_string($entity) && \substr($entity, 0, 1) === '@') { // normalize @service to Reference $entity = new Reference(\substr($entity, 1)); } elseif (\is_array($entity) && \is_string($entity[0]) && \substr($entity[0], 0, 1) === '@') { $entity[0] = new Reference(\substr($entity[0], 1)); } $this->entity = $entity; $this->arguments = $arguments; } /** @return string|array|Definition|Reference|null */ public function getEntity() { return $this->entity; } } \class_exists(Nette\DI\Statement::class); <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\DI\Definitions; use _PHPStan_7d8742a37\Nette; /** * Definition used by ContainerBuilder. */ abstract class Definition { use Nette\SmartObject; /** @var string|null */ private $name; /** @var string|null class or interface name */ private $type; /** @var array */ private $tags = []; /** @var bool|string[] */ private $autowired = \true; /** @var callable|null */ private $notifier; /** * @return static * @internal This is managed by ContainerBuilder and should not be called by user */ public final function setName(string $name) { if ($this->name) { throw new Nette\InvalidStateException('Name already has been set.'); } $this->name = $name; return $this; } public final function getName() : ?string { return $this->name; } /** @return static */ protected function setType(?string $type) { if ($this->autowired && $this->notifier && $this->type !== $type) { ($this->notifier)(); } if ($type === null) { $this->type = null; } elseif (!\class_exists($type) && !\interface_exists($type)) { throw new Nette\InvalidArgumentException(\sprintf("Service '%s': Class or interface '%s' not found.", $this->name, $type)); } else { $this->type = Nette\DI\Helpers::normalizeClass($type); } return $this; } public final function getType() : ?string { return $this->type; } /** @return static */ public final function setTags(array $tags) { $this->tags = $tags; return $this; } public final function getTags() : array { return $this->tags; } /** * @param mixed $attr * @return static */ public final function addTag(string $tag, $attr = \true) { $this->tags[$tag] = $attr; return $this; } /** @return mixed */ public final function getTag(string $tag) { return $this->tags[$tag] ?? null; } /** * @param bool|string|string[] $state * @return static */ public final function setAutowired($state = \true) { if ($this->notifier && $this->autowired !== $state) { ($this->notifier)(); } $this->autowired = \is_string($state) || \is_array($state) ? (array) $state : (bool) $state; return $this; } /** @return bool|string[] */ public final function getAutowired() { return $this->autowired; } /** @return static */ public function setExported(bool $state = \true) { return $this->addTag('nette.exported', $state); } public function isExported() : bool { return (bool) $this->getTag('nette.exported'); } public function __clone() { $this->notifier = $this->name = null; } /********************* life cycle ****************d*g**/ public abstract function resolveType(Nette\DI\Resolver $resolver) : void; public abstract function complete(Nette\DI\Resolver $resolver) : void; public abstract function generateMethod(Nette\PhpGenerator\Method $method, Nette\DI\PhpGenerator $generator) : void; public final function setNotifier(?callable $notifier) : void { $this->notifier = $notifier; } /********************* deprecated stuff from former ServiceDefinition ****************d*g**/ /** @deprecated Use setType() */ public function setClass(?string $type) { return $this->setType($type); } /** @deprecated Use getType() */ public function getClass() : ?string { return $this->getType(); } /** @deprecated Use '$def instanceof Nette\DI\Definitions\ImportedDefinition' */ public function isDynamic() : bool { \trigger_error(\sprintf('Service %s: %s() is deprecated, use "instanceof ImportedDefinition".', $this->getName(), __METHOD__), \E_USER_DEPRECATED); return \false; } /** @deprecated Use Nette\DI\Definitions\FactoryDefinition or AccessorDefinition */ public function getImplement() : ?string { \trigger_error(\sprintf('Service %s: %s() is deprecated.', $this->getName(), __METHOD__), \E_USER_DEPRECATED); return null; } /** @deprecated Use getAutowired() */ public function isAutowired() { return $this->autowired; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\DI\Definitions; use _PHPStan_7d8742a37\Nette; /** * Multi accessor/factory definition. */ final class LocatorDefinition extends Definition { /** @var Reference[] */ private $references = []; /** @var string|null */ private $tagged; /** @return static */ public function setImplement(string $interface) { if (!\interface_exists($interface)) { throw new Nette\InvalidArgumentException(\sprintf("Service '%s': Interface '%s' not found.", $this->getName(), $interface)); } $methods = (new \ReflectionClass($interface))->getMethods(); if (!$methods) { throw new Nette\InvalidArgumentException(\sprintf("Service '%s': Interface %s must have at least one method.", $this->getName(), $interface)); } foreach ($methods as $method) { if ($method->isStatic() || !(\preg_match('#^(get|create)$#', $method->name) && $method->getNumberOfParameters() === 1 || \preg_match('#^(get|create)[A-Z]#', $method->name) && $method->getNumberOfParameters() === 0)) { throw new Nette\InvalidArgumentException(\sprintf("Service '%s': Method %s::%s() does not meet the requirements: is create(\$name), get(\$name), create*() or get*() and is non-static.", $this->getName(), $interface, $method->name)); } if ($method->getNumberOfParameters() === 0) { try { Nette\DI\Helpers::ensureClassType(Nette\Utils\Type::fromReflection($method), "return type of {$interface}::{$method->name}()", \true); } catch (Nette\DI\ServiceCreationException $e) { \trigger_error($e->getMessage(), \E_USER_DEPRECATED); } } } return parent::setType($interface); } public function getImplement() : ?string { return $this->getType(); } /** @return static */ public function setReferences(array $references) { $this->references = []; foreach ($references as $name => $ref) { $this->references[$name] = \substr($ref, 0, 1) === '@' ? new Reference(\substr($ref, 1)) : Reference::fromType($ref); } return $this; } /** @return Reference[] */ public function getReferences() : array { return $this->references; } /** @return static */ public function setTagged(?string $tagged) { $this->tagged = $tagged; return $this; } public function getTagged() : ?string { return $this->tagged; } public function resolveType(Nette\DI\Resolver $resolver) : void { } public function complete(Nette\DI\Resolver $resolver) : void { if ($this->tagged !== null) { $this->references = []; foreach ($resolver->getContainerBuilder()->findByTag($this->tagged) as $name => $tag) { if (isset($this->references[$tag])) { \trigger_error(\sprintf("Service '%s': duplicated tag '%s' with value '%s'.", $this->getName(), $this->tagged, $tag), \E_USER_NOTICE); } $this->references[$tag] = new Reference($name); } } foreach ($this->references as $name => $ref) { $this->references[$name] = $resolver->normalizeReference($ref); } } public function generateMethod(Nette\PhpGenerator\Method $method, Nette\DI\PhpGenerator $generator) : void { $class = (new Nette\PhpGenerator\ClassType())->addImplement($this->getType()); $class->addProperty('container')->setPrivate(); $class->addMethod('__construct')->addBody('$this->container = $container;')->addParameter('container')->setType($generator->getClassName()); foreach ((new \ReflectionClass($this->getType()))->getMethods() as $rm) { \preg_match('#^(get|create)(.*)#', $rm->name, $m); $name = \lcfirst($m[2]); $nullable = $rm->getReturnType()->allowsNull(); $methodInner = $class->addMethod($rm->name)->setReturnType((string) Nette\Utils\Type::fromReflection($rm)); if (!$name) { $class->addProperty('mapping', \array_map(function ($item) { return $item->getValue(); }, $this->references))->setPrivate(); $methodInner->setBody('if (!isset($this->mapping[$name])) { ' . ($nullable ? 'return null;' : 'throw new Nette\\DI\\MissingServiceException("Service \'$name\' is not defined.");') . ' } return $this->container->' . $m[1] . 'Service($this->mapping[$name]);')->addParameter('name'); } elseif (isset($this->references[$name])) { $ref = $this->references[$name]->getValue(); if ($m[1] === 'get') { $methodInner->setBody('return $this->container->getService(?);', [$ref]); } else { $methodInner->setBody('return $this->container->?();', [Nette\DI\Container::getMethodName($ref)]); } } else { $methodInner->setBody($nullable ? 'return null;' : 'throw new Nette\\DI\\MissingServiceException("Service is not defined.");'); } } $method->setBody('return new class ($this) ' . $class . ';'); } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\DI\Definitions; use _PHPStan_7d8742a37\Nette; use _PHPStan_7d8742a37\Nette\DI\Helpers; use _PHPStan_7d8742a37\Nette\DI\ServiceCreationException; use _PHPStan_7d8742a37\Nette\PhpGenerator as Php; use _PHPStan_7d8742a37\Nette\Utils\Reflection; use _PHPStan_7d8742a37\Nette\Utils\Type; /** * Definition of standard service. */ final class FactoryDefinition extends Definition { private const MethodCreate = 'create'; /** @var array */ public $parameters = []; /** @var Definition */ private $resultDefinition; public function __construct() { $this->resultDefinition = new ServiceDefinition(); } /** @return static */ public function setImplement(string $interface) { if (!\interface_exists($interface)) { throw new Nette\InvalidArgumentException(\sprintf("Service '%s': Interface '%s' not found.", $this->getName(), $interface)); } $rc = new \ReflectionClass($interface); $method = $rc->getMethods()[0] ?? null; if (!$method || $method->isStatic() || $method->name !== self::MethodCreate || \count($rc->getMethods()) > 1) { throw new Nette\InvalidArgumentException(\sprintf("Service '%s': Interface %s must have just one non-static method create().", $this->getName(), $interface)); } try { Helpers::ensureClassType(Type::fromReflection($method), "return type of {$interface}::create()"); } catch (Nette\DI\ServiceCreationException $e) { \trigger_error($e->getMessage(), \E_USER_DEPRECATED); } return parent::setType($interface); } public function getImplement() : ?string { return $this->getType(); } public final function getResultType() : ?string { return $this->resultDefinition->getType(); } /** @return static */ public function setResultDefinition(Definition $definition) { $this->resultDefinition = $definition; return $this; } /** @return ServiceDefinition */ public function getResultDefinition() : Definition { return $this->resultDefinition; } /** @deprecated */ public function setParameters(array $params) { if ($params) { $old = $new = []; foreach ($params as $k => $v) { $tmp = \explode(' ', \is_int($k) ? $v : $k); $old[] = '%' . \end($tmp) . '%'; $new[] = '$' . \end($tmp); } \trigger_error(\sprintf("Service '%s': Option 'parameters' is deprecated and should be removed. The %s should be replaced with %s in configuration.", $this->getName(), \implode(', ', $old), \implode(', ', $new)), \E_USER_DEPRECATED); } $this->parameters = $params; return $this; } /** @deprecated */ public function getParameters() : array { return $this->parameters; } public function resolveType(Nette\DI\Resolver $resolver) : void { $interface = $this->getType(); if (!$interface) { throw new ServiceCreationException('Type is missing in definition of service.'); } $method = new \ReflectionMethod($interface, self::MethodCreate); $type = Type::fromReflection($method) ?? Helpers::getReturnTypeAnnotation($method); $resultDef = $this->resultDefinition; try { $resolver->resolveDefinition($resultDef); } catch (ServiceCreationException $e) { if ($resultDef->getType()) { throw $e; } $resultDef->setType(Helpers::ensureClassType($type, "return type of {$interface}::create()")); $resolver->resolveDefinition($resultDef); } if ($type && !$type->allows($resultDef->getType())) { throw new ServiceCreationException(\sprintf('Factory for %s cannot create incompatible %s type.', $type, $resultDef->getType())); } } public function complete(Nette\DI\Resolver $resolver) : void { $resultDef = $this->resultDefinition; if ($resultDef instanceof ServiceDefinition) { if (!$this->parameters) { $this->completeParameters($resolver); } $this->convertArguments($resultDef->getCreator()->arguments); foreach ($resultDef->getSetup() as $setup) { $this->convertArguments($setup->arguments); } if ($resultDef->getEntity() instanceof Reference && !$resultDef->getCreator()->arguments) { $resultDef->setCreator([ // render as $container->createMethod() new Reference(Nette\DI\ContainerBuilder::ThisContainer), Nette\DI\Container::getMethodName($resultDef->getEntity()->getValue()), ]); } } $resolver->completeDefinition($resultDef); } private function completeParameters(Nette\DI\Resolver $resolver) : void { $interface = $this->getType(); $method = new \ReflectionMethod($interface, self::MethodCreate); $ctorParams = []; if (($class = $resolver->resolveEntityType($this->resultDefinition->getCreator())) && ($ctor = (new \ReflectionClass($class))->getConstructor())) { foreach ($ctor->getParameters() as $param) { $ctorParams[$param->name] = $param; } } foreach ($method->getParameters() as $param) { $methodType = Type::fromReflection($param); if (isset($ctorParams[$param->name])) { $ctorParam = $ctorParams[$param->name]; $ctorType = Type::fromReflection($ctorParam); if ($ctorType && !$ctorType->allows((string) $methodType)) { throw new ServiceCreationException(\sprintf("Type of \$%s in %s::create() doesn't match type in %s constructor.", $param->name, $interface, $class)); } $this->resultDefinition->getCreator()->arguments[$ctorParam->getPosition()] = new Php\Literal('$' . $ctorParam->name); } elseif (!$this->resultDefinition->getSetup()) { // [param1, param2] => '$param1, $param2' $stringifyParams = function (array $params) : string { return \implode(', ', \array_map(function (string $param) { return '$' . $param; }, $params)); }; $ctorParamsKeys = \array_keys($ctorParams); $hint = Nette\Utils\Helpers::getSuggestion($ctorParamsKeys, $param->name); throw new ServiceCreationException(\sprintf('Cannot implement %s::create(): factory method parameters (%s) are not matching %s::__construct() parameters (%s).', $interface, $stringifyParams(\array_map(function (\ReflectionParameter $param) { return $param->name; }, $method->getParameters())), $class, $stringifyParams($ctorParamsKeys)) . ($hint ? " Did you mean to use '\${$hint}' in factory method?" : '')); } $paramDef = $methodType . ' ' . $param->name; if ($param->isDefaultValueAvailable()) { $this->parameters[$paramDef] = Reflection::getParameterDefaultValue($param); } else { $this->parameters[] = $paramDef; } } } public function convertArguments(array &$args) : void { foreach ($args as &$v) { if (\is_string($v) && $v && $v[0] === '$') { $v = new Php\Literal($v); } } } public function generateMethod(Php\Method $method, Nette\DI\PhpGenerator $generator) : void { $class = (new Php\ClassType())->addImplement($this->getType()); $class->addProperty('container')->setPrivate(); $class->addMethod('__construct')->addBody('$this->container = $container;')->addParameter('container')->setType($generator->getClassName()); $methodCreate = $class->addMethod(self::MethodCreate); $this->resultDefinition->generateMethod($methodCreate, $generator); $body = $methodCreate->getBody(); $body = \str_replace('$this', '$this->container', $body); $body = \str_replace('$this->container->container', '$this->container', $body); $rm = new \ReflectionMethod($this->getType(), self::MethodCreate); $methodCreate->setParameters($generator->convertParameters($this->parameters))->setReturnType((string) (Type::fromReflection($rm) ?? $this->getResultType()))->setBody($body); $method->setBody('return new class ($this) ' . $class . ';'); } public function __clone() { parent::__clone(); $this->resultDefinition = \unserialize(\serialize($this->resultDefinition)); } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\DI\Definitions; use _PHPStan_7d8742a37\Nette; use _PHPStan_7d8742a37\Nette\DI\PhpGenerator; /** * Imported service injected to the container. */ final class ImportedDefinition extends Definition { /** @return static */ public function setType(?string $type) { return parent::setType($type); } public function resolveType(Nette\DI\Resolver $resolver) : void { } public function complete(Nette\DI\Resolver $resolver) : void { } public function generateMethod(Nette\PhpGenerator\Method $method, PhpGenerator $generator) : void { $method->setReturnType('void')->setBody('throw new Nette\\DI\\ServiceCreationException(?);', ["Unable to create imported service '{$this->getName()}', it must be added using addService()"]); } /** @deprecated use '$def instanceof ImportedDefinition' */ public function isDynamic() : bool { \trigger_error(\sprintf('Service %s: %s() is deprecated, use "instanceof ImportedDefinition".', $this->getName(), __METHOD__), \E_USER_DEPRECATED); return \true; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\DI\Definitions; use _PHPStan_7d8742a37\Nette; /** * Reference to service. Either by name or by type or reference to the 'self' service. */ final class Reference { use Nette\SmartObject; public const Self = 'self'; /** @deprecated use Reference::Self */ public const SELF = self::Self; /** @var string */ private $value; public static function fromType(string $value) : self { if (\strpos($value, '\\') === \false) { $value = '\\' . $value; } return new static($value); } public function __construct(string $value) { $this->value = $value; } public function getValue() : string { return $this->value; } public function isName() : bool { return \strpos($this->value, '\\') === \false && $this->value !== self::Self; } public function isType() : bool { return \strpos($this->value, '\\') !== \false; } public function isSelf() : bool { return $this->value === self::Self; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\DI; use _PHPStan_7d8742a37\Nette; use _PHPStan_7d8742a37\Nette\Schema; /** * DI container compiler. */ class Compiler { use Nette\SmartObject; private const Services = 'services', Parameters = 'parameters', DI = 'di'; /** @var CompilerExtension[] */ private $extensions = []; /** @var ContainerBuilder */ private $builder; /** @var array */ private $config = []; /** @var array [section => array[]] */ private $configs = []; /** @var string */ private $sources = ''; /** @var DependencyChecker */ private $dependencies; /** @var string */ private $className = 'Container'; public function __construct(?ContainerBuilder $builder = null) { $this->builder = $builder ?: new ContainerBuilder(); $this->dependencies = new DependencyChecker(); $this->addExtension(self::Services, new Extensions\ServicesExtension()); $this->addExtension(self::Parameters, new Extensions\ParametersExtension($this->configs)); } /** * Add custom configurator extension. * @return static */ public function addExtension(?string $name, CompilerExtension $extension) { if ($name === null) { $name = '_' . \count($this->extensions); } elseif (isset($this->extensions[$name])) { throw new Nette\InvalidArgumentException(\sprintf("Name '%s' is already used or reserved.", $name)); } $lname = \strtolower($name); foreach (\array_keys($this->extensions) as $nm) { if ($lname === \strtolower((string) $nm)) { throw new Nette\InvalidArgumentException(\sprintf("Name of extension '%s' has the same name as '%s' in a case-insensitive manner.", $name, $nm)); } } $this->extensions[$name] = $extension->setCompiler($this, $name); return $this; } public function getExtensions(?string $type = null) : array { return $type ? \array_filter($this->extensions, function ($item) use($type) : bool { return $item instanceof $type; }) : $this->extensions; } public function getContainerBuilder() : ContainerBuilder { return $this->builder; } /** @return static */ public function setClassName(string $className) { $this->className = $className; return $this; } /** * Adds new configuration. * @return static */ public function addConfig(array $config) { foreach ($config as $section => $data) { $this->configs[$section][] = $data; } $this->sources .= "// source: array\n"; return $this; } /** * Adds new configuration from file. * @return static */ public function loadConfig(string $file, ?Config\Loader $loader = null) { $sources = $this->sources . "// source: {$file}\n"; $loader = $loader ?: new Config\Loader(); foreach ($loader->load($file, \false) as $data) { $this->addConfig($data); } $this->dependencies->add($loader->getDependencies()); $this->sources = $sources; return $this; } /** * Returns configuration. * @deprecated */ public function getConfig() : array { return $this->config; } /** * Sets the names of dynamic parameters. * @return static */ public function setDynamicParameterNames(array $names) { \assert($this->extensions[self::Parameters] instanceof Extensions\ParametersExtension); $this->extensions[self::Parameters]->dynamicParams = $names; return $this; } /** * Adds dependencies to the list. * @param array $deps of ReflectionClass|\ReflectionFunctionAbstract|string * @return static */ public function addDependencies(array $deps) { $this->dependencies->add(\array_filter($deps)); return $this; } /** * Exports dependencies. */ public function exportDependencies() : array { return $this->dependencies->export(); } /** @return static */ public function addExportedTag(string $tag) { if (isset($this->extensions[self::DI])) { \assert($this->extensions[self::DI] instanceof Extensions\DIExtension); $this->extensions[self::DI]->exportedTags[$tag] = \true; } return $this; } /** @return static */ public function addExportedType(string $type) { if (isset($this->extensions[self::DI])) { \assert($this->extensions[self::DI] instanceof Extensions\DIExtension); $this->extensions[self::DI]->exportedTypes[$type] = \true; } return $this; } public function compile() : string { $this->processExtensions(); $this->processBeforeCompile(); return $this->generateCode(); } /** @internal */ public function processExtensions() : void { $first = $this->getExtensions(Extensions\ParametersExtension::class) + $this->getExtensions(Extensions\ExtensionsExtension::class); foreach ($first as $name => $extension) { $config = $this->processSchema($extension->getConfigSchema(), $this->configs[$name] ?? [], $name); $extension->setConfig($this->config[$name] = $config); $extension->loadConfiguration(); } $last = $this->getExtensions(Extensions\InjectExtension::class); $this->extensions = \array_merge(\array_diff_key($this->extensions, $last), $last); if ($decorator = $this->getExtensions(Extensions\DecoratorExtension::class)) { Nette\Utils\Arrays::insertBefore($this->extensions, \key($decorator), $this->getExtensions(Extensions\SearchExtension::class)); } $extensions = \array_diff_key($this->extensions, $first, [self::Services => 1]); foreach ($extensions as $name => $extension) { $config = $this->processSchema($extension->getConfigSchema(), $this->configs[$name] ?? [], $name); $extension->setConfig($this->config[$name] = $config); } foreach ($extensions as $extension) { $extension->loadConfiguration(); } foreach ($this->getExtensions(Extensions\ServicesExtension::class) as $name => $extension) { $config = $this->processSchema($extension->getConfigSchema(), $this->configs[$name] ?? [], $name); $extension->setConfig($this->config[$name] = $config); $extension->loadConfiguration(); } if ($extra = \array_diff_key($this->extensions, $extensions, $first, [self::Services => 1])) { throw new Nette\DeprecatedException(\sprintf("Extensions '%s' were added while container was being compiled.", \implode("', '", \array_keys($extra)))); } elseif ($extra = \key(\array_diff_key($this->configs, $this->extensions))) { $hint = Nette\Utils\Helpers::getSuggestion(\array_keys($this->extensions), $extra); throw new InvalidConfigurationException(\sprintf("Found section '%s' in configuration, but corresponding extension is missing", $extra) . ($hint ? ", did you mean '{$hint}'?" : '.')); } } private function processBeforeCompile() : void { $this->builder->resolve(); foreach ($this->extensions as $extension) { $extension->beforeCompile(); $this->dependencies->add([(new \ReflectionClass($extension))->getFileName()]); } $this->builder->complete(); } /** * Merges and validates configurations against scheme. * @return array|object */ private function processSchema(Schema\Schema $schema, array $configs, $name = null) { $processor = new Schema\Processor(); $processor->onNewContext[] = function (Schema\Context $context) use($name) { $context->path = $name ? [$name] : []; $context->dynamics =& $this->extensions[self::Parameters]->dynamicValidators; }; try { $res = $processor->processMultiple($schema, $configs); } catch (Schema\ValidationException $e) { throw new Nette\DI\InvalidConfigurationException($e->getMessage()); } foreach ($processor->getWarnings() as $warning) { \trigger_error($warning, \E_USER_DEPRECATED); } return $res; } /** @internal */ public function generateCode() : string { $generator = $this->createPhpGenerator(); $class = $generator->generate($this->className); $this->dependencies->add($this->builder->getDependencies()); foreach ($this->extensions as $extension) { $extension->afterCompile($class); $generator->addInitialization($class, $extension); } return $this->sources . "\n" . $generator->toString($class); } /** * Loads list of service definitions from configuration. */ public function loadDefinitionsFromConfig(array $configList) : void { $extension = $this->extensions[self::Services]; \assert($extension instanceof Extensions\ServicesExtension); $extension->loadDefinitions($this->processSchema($extension->getConfigSchema(), [$configList])); } protected function createPhpGenerator() : PhpGenerator { return new PhpGenerator($this->builder); } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\DI; use _PHPStan_7d8742a37\Nette; use _PHPStan_7d8742a37\Nette\DI\Definitions\Definition; use _PHPStan_7d8742a37\Nette\DI\Definitions\Reference; use _PHPStan_7d8742a37\Nette\DI\Definitions\Statement; use _PHPStan_7d8742a37\Nette\PhpGenerator\Helpers as PhpHelpers; use _PHPStan_7d8742a37\Nette\Utils\Arrays; use _PHPStan_7d8742a37\Nette\Utils\Callback; use _PHPStan_7d8742a37\Nette\Utils\Reflection; use _PHPStan_7d8742a37\Nette\Utils\Strings; use _PHPStan_7d8742a37\Nette\Utils\Validators; use ReflectionClass; /** * Services resolver * @internal */ class Resolver { use Nette\SmartObject; /** @var ContainerBuilder */ private $builder; /** @var Definition|null */ private $currentService; /** @var string|null */ private $currentServiceType; /** @var bool */ private $currentServiceAllowed = \false; /** @var \SplObjectStorage circular reference detector */ private $recursive; public function __construct(ContainerBuilder $builder) { $this->builder = $builder; $this->recursive = new \SplObjectStorage(); } public function getContainerBuilder() : ContainerBuilder { return $this->builder; } public function resolveDefinition(Definition $def) : void { if ($this->recursive->contains($def)) { $names = \array_map(function ($item) { return $item->getName(); }, \iterator_to_array($this->recursive)); throw new ServiceCreationException(\sprintf('Circular reference detected for services: %s.', \implode(', ', $names))); } try { $this->recursive->attach($def); $def->resolveType($this); if (!$def->getType()) { throw new ServiceCreationException('Type of service is unknown.'); } } catch (\Throwable $e) { throw $this->completeException($e, $def); } finally { $this->recursive->detach($def); } } public function resolveReferenceType(Reference $ref) : ?string { if ($ref->isSelf()) { return $this->currentServiceType; } elseif ($ref->isType()) { return \ltrim($ref->getValue(), '\\'); } $def = $this->resolveReference($ref); if (!$def->getType()) { $this->resolveDefinition($def); } return $def->getType(); } public function resolveEntityType(Statement $statement) : ?string { $entity = $this->normalizeEntity($statement); if (\is_array($entity)) { if ($entity[0] instanceof Reference || $entity[0] instanceof Statement) { $entity[0] = $this->resolveEntityType($entity[0] instanceof Statement ? $entity[0] : new Statement($entity[0])); if (!$entity[0]) { return null; } } try { $reflection = Callback::toReflection($entity[0] === '' ? $entity[1] : $entity); \assert($reflection instanceof \ReflectionMethod || $reflection instanceof \ReflectionFunction); $refClass = $reflection instanceof \ReflectionMethod ? $reflection->getDeclaringClass() : null; } catch (\ReflectionException $e) { $refClass = $reflection = null; } if (isset($e) || $refClass && (!$reflection->isPublic() || $refClass->isTrait() && !$reflection->isStatic())) { throw new ServiceCreationException(\sprintf('Method %s() is not callable.', Callback::toString($entity)), 0, $e ?? null); } $this->addDependency($reflection); $type = Nette\Utils\Type::fromReflection($reflection) ?? ($annotation = Helpers::getReturnTypeAnnotation($reflection)); if ($type && !\in_array($type->getSingleName(), ['object', 'mixed'], \true)) { if (isset($annotation)) { \trigger_error('Annotation @return should be replaced with native return type at ' . Callback::toString($entity), \E_USER_DEPRECATED); } return Helpers::ensureClassType($type, \sprintf('return type of %s()', Callback::toString($entity)), \true); } return null; } elseif ($entity instanceof Reference) { // alias or factory return $this->resolveReferenceType($entity); } elseif (\is_string($entity)) { // class if (!\class_exists($entity)) { throw new ServiceCreationException(\sprintf(\interface_exists($entity) ? "Interface %s can not be used as 'create' or 'factory', did you mean 'implement'?" : "Class '%s' not found.", $entity)); } return $entity; } return null; } public function completeDefinition(Definition $def) : void { $this->currentService = \in_array($def, $this->builder->getDefinitions(), \true) ? $def : null; $this->currentServiceType = $def->getType(); $this->currentServiceAllowed = \false; try { $def->complete($this); $this->addDependency(new \ReflectionClass($def->getType())); } catch (\Throwable $e) { throw $this->completeException($e, $def); } finally { $this->currentService = $this->currentServiceType = null; } } public function completeStatement(Statement $statement, bool $currentServiceAllowed = \false) : Statement { $this->currentServiceAllowed = $currentServiceAllowed; $entity = $this->normalizeEntity($statement); $arguments = $this->convertReferences($statement->arguments); $getter = function (string $type, bool $single) { return $single ? $this->getByType($type) : \array_values(\array_filter($this->builder->findAutowired($type), function ($obj) { return $obj !== $this->currentService; })); }; switch (\true) { case \is_string($entity) && Strings::contains($entity, '?'): // PHP literal break; case $entity === 'not': if (\count($arguments) !== 1) { throw new ServiceCreationException(\sprintf('Function %s() expects 1 parameter, %s given.', $entity, \count($arguments))); } $entity = ['', '!']; break; case $entity === 'bool': case $entity === 'int': case $entity === 'float': case $entity === 'string': if (\count($arguments) !== 1) { throw new ServiceCreationException(\sprintf('Function %s() expects 1 parameter, %s given.', $entity, \count($arguments))); } $arguments = [$arguments[0], $entity]; $entity = [Helpers::class, 'convertType']; break; case \is_string($entity): // create class if (!\class_exists($entity)) { throw new ServiceCreationException(\sprintf("Class '%s' not found.", $entity)); } elseif ((new ReflectionClass($entity))->isAbstract()) { throw new ServiceCreationException(\sprintf('Class %s is abstract.', $entity)); } elseif (($rm = (new ReflectionClass($entity))->getConstructor()) !== null && !$rm->isPublic()) { throw new ServiceCreationException(\sprintf('Class %s has %s constructor.', $entity, $rm->isProtected() ? 'protected' : 'private')); } elseif ($constructor = (new ReflectionClass($entity))->getConstructor()) { $arguments = self::autowireArguments($constructor, $arguments, $getter); $this->addDependency($constructor); } elseif ($arguments) { throw new ServiceCreationException(\sprintf('Unable to pass arguments, class %s has no constructor.', $entity)); } break; case $entity instanceof Reference: $entity = [new Reference(ContainerBuilder::ThisContainer), Container::getMethodName($entity->getValue())]; break; case \is_array($entity): if (!\preg_match('#^\\$?(\\\\?' . PhpHelpers::PHP_IDENT . ')+(\\[\\])?$#D', $entity[1])) { throw new ServiceCreationException(\sprintf("Expected function, method or property name, '%s' given.", $entity[1])); } switch (\true) { case $entity[0] === '': // function call if (!Arrays::isList($arguments)) { throw new ServiceCreationException(\sprintf('Unable to pass specified arguments to %s.', $entity[0])); } elseif (!\function_exists($entity[1])) { throw new ServiceCreationException(\sprintf("Function %s doesn't exist.", $entity[1])); } $rf = new \ReflectionFunction($entity[1]); $arguments = self::autowireArguments($rf, $arguments, $getter); $this->addDependency($rf); break; case $entity[0] instanceof Statement: $entity[0] = $this->completeStatement($entity[0], $this->currentServiceAllowed); // break omitted case \is_string($entity[0]): // static method call case $entity[0] instanceof Reference: if ($entity[1][0] === '$') { // property getter, setter or appender Validators::assert($arguments, 'list:0..1', "setup arguments for '" . Callback::toString($entity) . "'"); if (!$arguments && \substr($entity[1], -2) === '[]') { throw new ServiceCreationException(\sprintf('Missing argument for %s.', $entity[1])); } } elseif ($type = $entity[0] instanceof Reference ? $this->resolveReferenceType($entity[0]) : $this->resolveEntityType($entity[0] instanceof Statement ? $entity[0] : new Statement($entity[0]))) { $rc = new ReflectionClass($type); if ($rc->hasMethod($entity[1])) { $rm = $rc->getMethod($entity[1]); if (!$rm->isPublic()) { throw new ServiceCreationException(\sprintf('%s::%s() is not callable.', $type, $entity[1])); } $arguments = self::autowireArguments($rm, $arguments, $getter); $this->addDependency($rm); } elseif (!Arrays::isList($arguments)) { throw new ServiceCreationException(\sprintf('Unable to pass specified arguments to %s::%s().', $type, $entity[1])); } } } } try { $arguments = $this->completeArguments($arguments); } catch (ServiceCreationException $e) { if (!\strpos($e->getMessage(), ' (used in')) { $e->setMessage($e->getMessage() . " (used in {$this->entityToString($entity)})"); } throw $e; } return new Statement($entity, $arguments); } public function completeArguments(array $arguments) : array { \array_walk_recursive($arguments, function (&$val) : void { if ($val instanceof Statement) { $entity = $val->getEntity(); if ($entity === 'typed' || $entity === 'tagged') { $services = []; $current = $this->currentService ? $this->currentService->getName() : null; foreach ($val->arguments as $argument) { foreach ($entity === 'tagged' ? $this->builder->findByTag($argument) : $this->builder->findAutowired($argument) as $name => $foo) { if ($name !== $current) { $services[] = new Reference($name); } } } $val = $this->completeArguments($services); } else { $val = $this->completeStatement($val, $this->currentServiceAllowed); } } elseif ($val instanceof Definition || $val instanceof Reference) { $val = $this->normalizeEntity(new Statement($val)); } }); return $arguments; } /** @return string|array|Reference literal, Class, Reference, [Class, member], [, globalFunc], [Reference, member], [Statement, member] */ private function normalizeEntity(Statement $statement) { $entity = $statement->getEntity(); if (\is_array($entity)) { $item =& $entity[0]; } else { $item =& $entity; } if ($item instanceof Definition) { $name = \current(\array_keys($this->builder->getDefinitions(), $item, \true)); if ($name === \false) { throw new ServiceCreationException(\sprintf("Service '%s' not found in definitions.", $item->getName())); } $item = new Reference($name); } if ($item instanceof Reference) { $item = $this->normalizeReference($item); } return $entity; } /** * Normalizes reference to 'self' or named reference (or leaves it typed if it is not possible during resolving) and checks existence of service. */ public function normalizeReference(Reference $ref) : Reference { $service = $ref->getValue(); if ($ref->isSelf()) { return $ref; } elseif ($ref->isName()) { if (!$this->builder->hasDefinition($service)) { throw new ServiceCreationException(\sprintf("Reference to missing service '%s'.", $service)); } return $this->currentService && $service === $this->currentService->getName() ? new Reference(Reference::Self) : $ref; } try { return $this->getByType($service); } catch (NotAllowedDuringResolvingException $e) { return new Reference($service); } } public function resolveReference(Reference $ref) : Definition { return $ref->isSelf() ? $this->currentService : $this->builder->getDefinition($ref->getValue()); } /** * Returns named reference to service resolved by type (or 'self' reference for local-autowiring). * @throws ServiceCreationException when multiple found * @throws MissingServiceException when not found */ public function getByType(string $type) : Reference { if ($this->currentService && $this->currentServiceAllowed && \is_a($this->currentServiceType, $type, \true)) { return new Reference(Reference::Self); } $name = $this->builder->getByType($type, \true); if (!$this->currentServiceAllowed && $this->currentService === $this->builder->getDefinition($name)) { throw new MissingServiceException(); } return new Reference($name); } /** * Adds item to the list of dependencies. * @param \ReflectionClass|\ReflectionFunctionAbstract|string $dep * @return static */ public function addDependency($dep) { $this->builder->addDependency($dep); return $this; } private function completeException(\Throwable $e, Definition $def) : ServiceCreationException { if ($e instanceof ServiceCreationException && Strings::startsWith($e->getMessage(), "Service '")) { return $e; } $name = $def->getName(); $type = $def->getType(); if ($name && !\ctype_digit($name)) { $message = "Service '{$name}'" . ($type ? " (type of {$type})" : '') . ': '; } elseif ($type) { $message = "Service of type {$type}: "; } elseif ($def instanceof Definitions\ServiceDefinition && $def->getEntity()) { $message = 'Service (' . $this->entityToString($def->getEntity()) . '): '; } else { $message = ''; } $message .= $type ? \str_replace("{$type}::", \preg_replace('~.*\\\\~', '', $type) . '::', $e->getMessage()) : $e->getMessage(); return $e instanceof ServiceCreationException ? $e->setMessage($message) : new ServiceCreationException($message, 0, $e); } private function entityToString($entity) : string { $referenceToText = function (Reference $ref) : string { return $ref->isSelf() && $this->currentService ? '@' . $this->currentService->getName() : '@' . $ref->getValue(); }; if (\is_string($entity)) { return $entity . '::__construct()'; } elseif ($entity instanceof Reference) { $entity = $referenceToText($entity); } elseif (\is_array($entity)) { if (\strpos($entity[1], '$') === \false) { $entity[1] .= '()'; } if ($entity[0] instanceof Reference) { $entity[0] = $referenceToText($entity[0]); } elseif (!\is_string($entity[0])) { return $entity[1]; } return \implode('::', $entity); } return (string) $entity; } private function convertReferences(array $arguments) : array { \array_walk_recursive($arguments, function (&$val) : void { if (\is_string($val) && \strlen($val) > 1 && $val[0] === '@' && $val[1] !== '@') { $pair = \explode('::', \substr($val, 1), 2); if (!isset($pair[1])) { // @service $val = new Reference($pair[0]); } elseif (\preg_match('#^[A-Z][a-zA-Z0-9_]*$#D', $pair[1], $m)) { // @service::CONSTANT $val = ContainerBuilder::literal($this->resolveReferenceType(new Reference($pair[0])) . '::' . $pair[1]); } else { // @service::property $val = new Statement([new Reference($pair[0]), '$' . $pair[1]]); } } elseif (\is_string($val) && \substr($val, 0, 2) === '@@') { // escaped text @@ $val = \substr($val, 1); } }); return $arguments; } /** * Add missing arguments using autowiring. * @param (callable(string $type, bool $single): (object|object[]|null)) $getter * @throws ServiceCreationException */ public static function autowireArguments(\ReflectionFunctionAbstract $method, array $arguments, callable $getter) : array { $optCount = 0; $useName = \false; $num = -1; $res = []; foreach ($method->getParameters() as $num => $param) { $paramName = $param->name; if ($param->isVariadic()) { if ($useName && Arrays::some($arguments, function ($val, $key) { return \is_int($key); })) { throw new ServiceCreationException(\sprintf('Cannot use positional argument after named or omitted argument in %s.', Reflection::toString($param))); } elseif (\array_key_exists($paramName, $arguments)) { if (!\is_array($arguments[$paramName])) { throw new ServiceCreationException(\sprintf('Parameter %s must be array, %s given.', Reflection::toString($param), \gettype($arguments[$paramName]))); } $res = \array_merge($res, $arguments[$paramName]); unset($arguments[$paramName]); } else { $res = \array_merge($res, $arguments); $arguments = []; } $optCount = 0; break; } elseif (\array_key_exists($key = $paramName, $arguments) || \array_key_exists($key = $num, $arguments)) { $res[$useName ? $paramName : $num] = $arguments[$key]; unset($arguments[$key], $arguments[$num]); // unset $num to enable overwriting in configuration } elseif (($aw = self::autowireArgument($param, $getter)) !== null) { $res[$useName ? $paramName : $num] = $aw; } elseif (\PHP_VERSION_ID >= 80000) { if ($param->isOptional()) { $useName = \true; } else { $res[$num] = null; \trigger_error(\sprintf('The parameter %s should have a declared value in the configuration.', Reflection::toString($param)), \E_USER_DEPRECATED); } } else { $res[$num] = $param->isDefaultValueAvailable() ? Reflection::getParameterDefaultValue($param) : null; if (!$param->isOptional()) { \trigger_error(\sprintf('The parameter %s should have a declared value in the configuration.', Reflection::toString($param)), \E_USER_DEPRECATED); } } if (\PHP_VERSION_ID < 80000) { $optCount = $param->isOptional() && $res[$num] === ($param->isDefaultValueAvailable() ? Reflection::getParameterDefaultValue($param) : null) ? $optCount + 1 : 0; } } // extra parameters while (!$useName && !$optCount && \array_key_exists(++$num, $arguments)) { $res[$num] = $arguments[$num]; unset($arguments[$num]); } if ($arguments) { throw new ServiceCreationException(\sprintf('Unable to pass specified arguments to %s.', Reflection::toString($method))); } elseif ($optCount) { $res = \array_slice($res, 0, -$optCount); } return $res; } /** * Resolves missing argument using autowiring. * @param (callable(string $type, bool $single): (object|object[]|null)) $getter * @throws ServiceCreationException * @return mixed */ private static function autowireArgument(\ReflectionParameter $parameter, callable $getter) { $desc = Reflection::toString($parameter); $type = Nette\Utils\Type::fromReflection($parameter); if ($type && $type->isClass()) { $class = $type->getSingleName(); try { $res = $getter($class, \true); } catch (MissingServiceException $e) { $res = null; } catch (ServiceCreationException $e) { throw new ServiceCreationException("{$e->getMessage()} (required by {$desc})", 0, $e); } if ($res !== null || $parameter->allowsNull()) { return $res; } elseif (\class_exists($class) || \interface_exists($class)) { throw new ServiceCreationException(\sprintf('Service of type %s required by %s not found. Did you add it to configuration file?', $class, $desc)); } else { throw new ServiceCreationException(\sprintf("Class '%s' required by %s not found. Check the parameter type and 'use' statements.", $class, $desc)); } } elseif ($itemType = self::isArrayOf($parameter, $type)) { return $getter($itemType, \false); } elseif ($type && $parameter->allowsNull() || $parameter->isOptional() || $parameter->isDefaultValueAvailable()) { // !optional + defaultAvailable, !optional + !defaultAvailable since 8.1.0 = func($a = null, $b) // optional + !defaultAvailable, optional + defaultAvailable since 8.0.0 = i.e. Exception::__construct, mysqli::mysqli, ... // optional + !defaultAvailable = variadics // in other cases the optional and defaultAvailable are identical return null; } else { throw new ServiceCreationException(\sprintf('Parameter %s has %s, so its value must be specified.', $desc, $type && !$type->isSingle() ? 'complex type and no default value' : 'no class type or default value')); } } private static function isArrayOf(\ReflectionParameter $parameter, ?Nette\Utils\Type $type) : ?string { $method = $parameter->getDeclaringFunction(); return $method instanceof \ReflectionMethod && $type && $type->getSingleName() === 'array' && \preg_match('#@param[ \\t]+(?|([\\w\\\\]+)\\[\\]|list<([\\w\\\\]+)>|array<int,\\s*([\\w\\\\]+)>)[ \\t]+\\$' . $parameter->name . '#', (string) $method->getDocComment(), $m) && ($itemType = Reflection::expandClassName($m[1], $method->getDeclaringClass())) && (\class_exists($itemType) || \interface_exists($itemType)) ? $itemType : null; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\DI; use _PHPStan_7d8742a37\Nette; use _PHPStan_7d8742a37\Nette\Utils\Reflection; use _PHPStan_7d8742a37\Nette\Utils\Type; use ReflectionClass; use ReflectionMethod; /** * Cache dependencies checker. */ class DependencyChecker { use Nette\SmartObject; public const Version = 1; /** @deprecated use DependencyChecker::Version */ public const VERSION = self::Version; /** @var array of ReflectionClass|\ReflectionFunctionAbstract|string */ private $dependencies = []; /** * Adds dependencies to the list. * @return static */ public function add(array $deps) { $this->dependencies = \array_merge($this->dependencies, $deps); return $this; } /** * Exports dependencies. */ public function export() : array { $files = $phpFiles = $classes = $functions = []; foreach ($this->dependencies as $dep) { if (\is_string($dep)) { $files[] = $dep; } elseif ($dep instanceof ReflectionClass) { if (empty($classes[$name = $dep->name])) { $all = [$name] + \class_parents($name) + \class_implements($name); foreach ($all as &$item) { $all += \class_uses($item); $phpFiles[] = (new ReflectionClass($item))->getFileName(); $classes[$item] = \true; } } } elseif ($dep instanceof \ReflectionFunctionAbstract) { $phpFiles[] = $dep->getFileName(); $functions[] = \rtrim(Reflection::toString($dep), '()'); } else { throw new Nette\InvalidStateException(\sprintf('Unexpected dependency %s', \gettype($dep))); } } $classes = \array_keys($classes); $functions = \array_unique($functions, \SORT_REGULAR); $hash = self::calculateHash($classes, $functions); $files = @\array_map('filemtime', \array_combine($files, $files)); // @ - file may not exist $phpFiles = @\array_map('filemtime', \array_combine($phpFiles, $phpFiles)); // @ - file may not exist return [self::Version, $files, $phpFiles, $classes, $functions, $hash]; } /** * Are dependencies expired? */ public static function isExpired(int $version, array $files, array &$phpFiles, array $classes, array $functions, string $hash) : bool { try { $currentFiles = @\array_map('filemtime', \array_combine($tmp = \array_keys($files), $tmp)); // @ - files may not exist $origPhpFiles = $phpFiles; $phpFiles = @\array_map('filemtime', \array_combine($tmp = \array_keys($phpFiles), $tmp)); // @ - files may not exist return $version !== self::Version || $files !== $currentFiles || $phpFiles !== $origPhpFiles && $hash !== self::calculateHash($classes, $functions); } catch (\ReflectionException $e) { return \true; } } private static function calculateHash(array $classes, array $functions) : string { $hash = []; foreach ($classes as $name) { $class = new ReflectionClass($name); $hash[] = [$name, Reflection::getUseStatements($class), $class->isAbstract(), \get_parent_class($name), \class_implements($name), \class_uses($name)]; foreach ($class->getProperties(\ReflectionProperty::IS_PUBLIC) as $prop) { if ($prop->getDeclaringClass() == $class) { // intentionally == $hash[] = [$name, $prop->name, $prop->getDocComment(), (string) Type::fromReflection($prop), \PHP_VERSION_ID >= 80000 ? \count($prop->getAttributes(Attributes\Inject::class)) : null]; } } foreach ($class->getMethods(ReflectionMethod::IS_PUBLIC) as $method) { if ($method->getDeclaringClass() == $class) { // intentionally == $hash[] = [$name, $method->name, $method->getDocComment(), self::hashParameters($method), (string) Type::fromReflection($method)]; } } } $flip = \array_flip($classes); foreach ($functions as $name) { if (\strpos($name, '::')) { $method = \PHP_VERSION_ID < 80300 ? new ReflectionMethod($name) : ReflectionMethod::createFromMethodName($name); $class = $method->getDeclaringClass(); if (isset($flip[$class->name])) { continue; } $uses = Reflection::getUseStatements($class); } else { $method = new \ReflectionFunction($name); $uses = null; } $hash[] = [$name, $uses, $method->getDocComment(), self::hashParameters($method), (string) Type::fromReflection($method)]; } return \md5(\serialize($hash)); } private static function hashParameters(\ReflectionFunctionAbstract $method) : array { $res = []; foreach ($method->getParameters() as $param) { $res[] = [$param->name, (string) Type::fromReflection($param), $param->isVariadic(), $param->isDefaultValueAvailable() ? \is_object($tmp = Reflection::getParameterDefaultValue($param)) ? ['object' => \get_class($tmp)] : ['value' => $tmp] : null]; } return $res; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\DI; use _PHPStan_7d8742a37\Nette; /** * The dependency injection container default implementation. */ class Container { use Nette\SmartObject; /** * @var mixed[] * @deprecated use Container::getParameter() or getParameters() */ public $parameters = []; /** @var string[] services name => type (complete list of available services) */ protected $types = []; /** @var string[] alias => service name */ protected $aliases = []; /** @var array[] tag name => service name => tag value */ protected $tags = []; /** @var array[] type => level => services */ protected $wiring = []; /** @var object[] service name => instance */ private $instances = []; /** @var array<string, true> circular reference detector */ private $creating; /** @var array<string, string|\Closure> */ private $methods; public function __construct(array $params = []) { $this->parameters = $params + $this->getStaticParameters(); $this->methods = \array_flip(\array_filter(\get_class_methods($this), function ($s) { return \preg_match('#^createService.#', $s); })); } public function getParameters() : array { return $this->parameters; } public function getParameter($key) { if (!\array_key_exists($key, $this->parameters)) { $this->parameters[$key] = $this->preventDeadLock("%{$key}%", function () use($key) { return $this->getDynamicParameter($key); }); } return $this->parameters[$key]; } protected function getStaticParameters() : array { return []; } protected function getDynamicParameter($key) { throw new Nette\InvalidStateException(\sprintf("Parameter '%s' not found. Check if 'di › export › parameters' is enabled.", $key)); } /** * Adds the service to the container. * @param object $service service or its factory * @return static */ public function addService(string $name, object $service) { $name = $this->aliases[$name] ?? $name; if (isset($this->instances[$name])) { throw new Nette\InvalidStateException(\sprintf("Service '%s' already exists.", $name)); } if ($service instanceof \Closure) { $rt = Nette\Utils\Type::fromReflection(new \ReflectionFunction($service)); $type = $rt ? Helpers::ensureClassType($rt, 'return type of closure') : ''; } else { $type = \get_class($service); } if (!isset($this->methods[self::getMethodName($name)])) { $this->types[$name] = $type; } elseif (($expectedType = $this->getServiceType($name)) && !\is_a($type, $expectedType, \true)) { throw new Nette\InvalidArgumentException(\sprintf("Service '%s' must be instance of %s, %s.", $name, $expectedType, $type ? "{$type} given" : 'add typehint to closure')); } if ($service instanceof \Closure) { $this->methods[self::getMethodName($name)] = $service; $this->types[$name] = $type; } else { $this->instances[$name] = $service; } return $this; } /** * Removes the service from the container. */ public function removeService(string $name) : void { $name = $this->aliases[$name] ?? $name; unset($this->instances[$name]); } /** * Gets the service object by name. * @throws MissingServiceException */ public function getService(string $name) : object { if (!isset($this->instances[$name])) { if (isset($this->aliases[$name])) { return $this->getService($this->aliases[$name]); } $this->instances[$name] = $this->createService($name); } return $this->instances[$name]; } /** * Gets the service object by name. * @throws MissingServiceException */ public function getByName(string $name) : object { return $this->getService($name); } /** * Gets the service type by name. * @throws MissingServiceException */ public function getServiceType(string $name) : string { $method = self::getMethodName($name); if (isset($this->aliases[$name])) { return $this->getServiceType($this->aliases[$name]); } elseif (isset($this->types[$name])) { return $this->types[$name]; } elseif (isset($this->methods[$method])) { $type = (new \ReflectionMethod($this, $method))->getReturnType(); return $type ? $type->getName() : ''; } else { throw new MissingServiceException(\sprintf("Service '%s' not found.", $name)); } } /** * Does the service exist? */ public function hasService(string $name) : bool { $name = $this->aliases[$name] ?? $name; return isset($this->methods[self::getMethodName($name)]) || isset($this->instances[$name]); } /** * Is the service created? */ public function isCreated(string $name) : bool { if (!$this->hasService($name)) { throw new MissingServiceException(\sprintf("Service '%s' not found.", $name)); } $name = $this->aliases[$name] ?? $name; return isset($this->instances[$name]); } /** * Creates new instance of the service. * @throws MissingServiceException */ public function createService(string $name, array $args = []) : object { $name = $this->aliases[$name] ?? $name; $method = self::getMethodName($name); $callback = $this->methods[$method] ?? null; if ($callback === null) { throw new MissingServiceException(\sprintf("Service '%s' not found.", $name)); } $service = $this->preventDeadLock($name, function () use($callback, $args, $method) { return $callback instanceof \Closure ? $callback(...$args) : $this->{$method}(...$args); }); if (!\is_object($service)) { throw new Nette\UnexpectedValueException(\sprintf("Unable to create service '{$name}', value returned by %s is not object.", $callback instanceof \Closure ? 'closure' : "method {$method}()")); } return $service; } /** * Resolves service by type. * @template T of object * @param class-string<T> $type * @return ?T * @throws MissingServiceException */ public function getByType(string $type, bool $throw = \true) : ?object { $type = Helpers::normalizeClass($type); if (!empty($this->wiring[$type][0])) { if (\count($names = $this->wiring[$type][0]) === 1) { return $this->getService($names[0]); } \natsort($names); throw new MissingServiceException(\sprintf("Multiple services of type {$type} found: %s.", \implode(', ', $names))); } elseif ($throw) { if (!\class_exists($type) && !\interface_exists($type)) { throw new MissingServiceException(\sprintf("Service of type '%s' not found. Check the class name because it cannot be found.", $type)); } foreach ($this->methods as $method => $foo) { $methodType = (new \ReflectionMethod(static::class, $method))->getReturnType()->getName(); if (\is_a($methodType, $type, \true)) { throw new MissingServiceException(\sprintf("Service of type %s is not autowired or is missing in di › export › types.", $type)); } } throw new MissingServiceException(\sprintf('Service of type %s not found. Did you add it to configuration file?', $type)); } return null; } /** * Gets the autowired service names of the specified type. * @return string[] * @internal */ public function findAutowired(string $type) : array { $type = Helpers::normalizeClass($type); return \array_merge($this->wiring[$type][0] ?? [], $this->wiring[$type][1] ?? []); } /** * Gets the service names of the specified type. * @return string[] */ public function findByType(string $type) : array { $type = Helpers::normalizeClass($type); return empty($this->wiring[$type]) ? [] : \array_merge(...\array_values($this->wiring[$type])); } /** * Gets the service names of the specified tag. * @return array of [service name => tag attributes] */ public function findByTag(string $tag) : array { return $this->tags[$tag] ?? []; } private function preventDeadLock(string $key, \Closure $callback) { if (isset($this->creating[$key])) { throw new Nette\InvalidStateException(\sprintf('Circular reference detected for: %s.', \implode(', ', \array_keys($this->creating)))); } try { $this->creating[$key] = \true; return $callback(); } finally { unset($this->creating[$key]); } } /********************* autowiring ****************d*g**/ /** * Creates new instance using autowiring. * @throws Nette\InvalidArgumentException */ public function createInstance(string $class, array $args = []) : object { $rc = new \ReflectionClass($class); if (!$rc->isInstantiable()) { throw new ServiceCreationException(\sprintf('Class %s is not instantiable.', $class)); } elseif ($constructor = $rc->getConstructor()) { return $rc->newInstanceArgs($this->autowireArguments($constructor, $args)); } elseif ($args) { throw new ServiceCreationException(\sprintf('Unable to pass arguments, class %s has no constructor.', $class)); } return new $class(); } /** * Calls all methods starting with with "inject" using autowiring. */ public function callInjects(object $service) : void { Extensions\InjectExtension::callInjects($this, $service); } /** * Calls method using autowiring. * @return mixed */ public function callMethod(callable $function, array $args = []) { return $function(...$this->autowireArguments(Nette\Utils\Callback::toReflection($function), $args)); } private function autowireArguments(\ReflectionFunctionAbstract $function, array $args = []) : array { return Resolver::autowireArguments($function, $args, function (string $type, bool $single) { return $single ? $this->getByType($type) : \array_map([$this, 'getService'], $this->findAutowired($type)); }); } public static function getMethodName(string $name) : string { if ($name === '') { throw new Nette\InvalidArgumentException('Service name must be a non-empty string.'); } return 'createService' . \str_replace('.', '__', \ucfirst($name)); } public function initialize() : void { } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\DI; use _PHPStan_7d8742a37\Nette; /** * Service not found exception. */ class MissingServiceException extends Nette\InvalidStateException { } /** * Service creation exception. */ class ServiceCreationException extends Nette\InvalidStateException { public function setMessage(string $message) : self { $this->message = $message; return $this; } } /** * Not allowed when container is resolving. */ class NotAllowedDuringResolvingException extends Nette\InvalidStateException { } /** * Error in configuration. */ class InvalidConfigurationException extends Nette\InvalidStateException { } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\DI\Attributes; use Attribute; #[\Attribute(Attribute::TARGET_PROPERTY)] class Inject { } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\DI; use _PHPStan_7d8742a37\Nette; /** * @internal */ final class DynamicParameter extends Nette\PhpGenerator\PhpLiteral implements Nette\Schema\DynamicParameter { } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\DI; use _PHPStan_7d8742a37\Nette; use _PHPStan_7d8742a37\Nette\DI\Definitions\Definition; /** * Container builder. */ class ContainerBuilder { use Nette\SmartObject; public const ThisService = 'self', ThisContainer = 'container'; /** @deprecated use ContainerBuilder::ThisService */ public const THIS_SERVICE = self::ThisService; /** @deprecated use ContainerBuilder::ThisContainer */ public const THIS_CONTAINER = self::ThisContainer; /** @var array */ public $parameters = []; /** @var Definition[] */ private $definitions = []; /** @var array of alias => service */ private $aliases = []; /** @var Autowiring */ private $autowiring; /** @var bool */ private $needsResolve = \true; /** @var bool */ private $resolving = \false; /** @var array */ private $dependencies = []; public function __construct() { $this->autowiring = new Autowiring($this); $this->addImportedDefinition(self::ThisContainer)->setType(Container::class); } /** * Adds new service definition. * @return Definitions\ServiceDefinition */ public function addDefinition(?string $name, ?Definition $definition = null) : Definition { $this->needsResolve = \true; if ($name === null) { for ($i = 1; isset($this->definitions['0' . $i]) || isset($this->aliases['0' . $i]); $i++) { } $name = '0' . $i; // prevents converting to integer in array key } elseif (\is_int(\key([$name => 1])) || !\preg_match('#^\\w+(\\.\\w+)*$#D', $name)) { throw new Nette\InvalidArgumentException(\sprintf("Service name must be a alpha-numeric string and not a number, '%s' given.", $name)); } else { $name = $this->aliases[$name] ?? $name; if (isset($this->definitions[$name])) { throw new Nette\InvalidStateException(\sprintf("Service '%s' has already been added.", $name)); } $lname = \strtolower($name); foreach ($this->definitions as $nm => $foo) { if ($lname === \strtolower($nm)) { throw new Nette\InvalidStateException(\sprintf("Service '%s' has the same name as '%s' in a case-insensitive manner.", $name, $nm)); } } } $definition = $definition ?: new Definitions\ServiceDefinition(); $definition->setName($name); $definition->setNotifier(function () : void { $this->needsResolve = \true; }); return $this->definitions[$name] = $definition; } public function addAccessorDefinition(?string $name) : Definitions\AccessorDefinition { return $this->addDefinition($name, new Definitions\AccessorDefinition()); } public function addFactoryDefinition(?string $name) : Definitions\FactoryDefinition { return $this->addDefinition($name, new Definitions\FactoryDefinition()); } public function addLocatorDefinition(?string $name) : Definitions\LocatorDefinition { return $this->addDefinition($name, new Definitions\LocatorDefinition()); } public function addImportedDefinition(?string $name) : Definitions\ImportedDefinition { return $this->addDefinition($name, new Definitions\ImportedDefinition()); } /** * Removes the specified service definition. */ public function removeDefinition(string $name) : void { $this->needsResolve = \true; $name = $this->aliases[$name] ?? $name; unset($this->definitions[$name]); } /** * Gets the service definition. */ public function getDefinition(string $name) : Definition { $service = $this->aliases[$name] ?? $name; if (!isset($this->definitions[$service])) { throw new MissingServiceException(\sprintf("Service '%s' not found.", $name)); } return $this->definitions[$service]; } /** * Gets all service definitions. * @return Definition[] */ public function getDefinitions() : array { return $this->definitions; } /** * Does the service definition or alias exist? */ public function hasDefinition(string $name) : bool { $name = $this->aliases[$name] ?? $name; return isset($this->definitions[$name]); } public function addAlias(string $alias, string $service) : void { if (!$alias) { // builder is not ready for falsy names such as '0' throw new Nette\InvalidArgumentException(\sprintf("Alias name must be a non-empty string, '%s' given.", $alias)); } elseif (!$service) { // builder is not ready for falsy names such as '0' throw new Nette\InvalidArgumentException(\sprintf("Service name must be a non-empty string, '%s' given.", $service)); } elseif (isset($this->aliases[$alias])) { throw new Nette\InvalidStateException(\sprintf("Alias '%s' has already been added.", $alias)); } elseif (isset($this->definitions[$alias])) { throw new Nette\InvalidStateException(\sprintf("Service '%s' has already been added.", $alias)); } $this->aliases[$alias] = $service; } /** * Removes the specified alias. */ public function removeAlias(string $alias) : void { unset($this->aliases[$alias]); } /** * Gets all service aliases. */ public function getAliases() : array { return $this->aliases; } /** * @param string[] $types * @return static */ public function addExcludedClasses(array $types) { $this->needsResolve = \true; $this->autowiring->addExcludedClasses($types); return $this; } /** * Resolves autowired service name by type. * @param bool $throw exception if service doesn't exist? * @throws MissingServiceException */ public function getByType(string $type, bool $throw = \false) : ?string { $this->needResolved(); return $this->autowiring->getByType($type, $throw); } /** * Gets autowired service definition of the specified type. * @throws MissingServiceException */ public function getDefinitionByType(string $type) : Definition { return $this->getDefinition($this->getByType($type, \true)); } /** * Gets the autowired service names and definitions of the specified type. * @return Definition[] service name is key * @internal */ public function findAutowired(string $type) : array { $this->needResolved(); return $this->autowiring->findByType($type); } /** * Gets the service names and definitions of the specified type. * @return Definition[] service name is key */ public function findByType(string $type) : array { $this->needResolved(); $found = []; foreach ($this->definitions as $name => $def) { if (\is_a($def->getType(), $type, \true)) { $found[$name] = $def; } } return $found; } /** * Gets the service names and tag values. * @return array of [service name => tag attributes] */ public function findByTag(string $tag) : array { $found = []; foreach ($this->definitions as $name => $def) { if (($tmp = $def->getTag($tag)) !== null) { $found[$name] = $tmp; } } return $found; } /********************* building ****************d*g**/ /** * Checks services, resolves types and rebuilts autowiring classlist. */ public function resolve() : void { if ($this->resolving) { return; } $this->resolving = \true; $resolver = new Resolver($this); foreach ($this->definitions as $def) { $resolver->resolveDefinition($def); } $this->autowiring->rebuild(); $this->resolving = $this->needsResolve = \false; } private function needResolved() : void { if ($this->resolving) { throw new NotAllowedDuringResolvingException(); } elseif ($this->needsResolve) { $this->resolve(); } } public function complete() : void { $this->resolve(); foreach ($this->definitions as $def) { $def->setNotifier(null); } $resolver = new Resolver($this); foreach ($this->definitions as $def) { $resolver->completeDefinition($def); } } /** * Adds item to the list of dependencies. * @param \ReflectionClass|\ReflectionFunctionAbstract|string $dep * @return static * @internal */ public function addDependency($dep) { $this->dependencies[] = $dep; return $this; } /** * Returns the list of dependencies. */ public function getDependencies() : array { return $this->dependencies; } /** @internal */ public function exportMeta() : array { $defs = $this->definitions; \ksort($defs); foreach ($defs as $name => $def) { if ($def instanceof Definitions\ImportedDefinition) { $meta['types'][$name] = $def->getType(); } foreach ($def->getTags() as $tag => $value) { $meta['tags'][$tag][$name] = $value; } } $meta['aliases'] = $this->aliases; \ksort($meta['aliases']); $all = []; foreach ($this->definitions as $name => $def) { if ($type = $def->getType()) { foreach (\class_parents($type) + \class_implements($type) + [$type] as $class) { $all[$class][] = $name; } } } [$low, $high] = $this->autowiring->getClassList(); foreach ($all as $class => $names) { $meta['wiring'][$class] = \array_filter([$high[$class] ?? [], $low[$class] ?? [], \array_diff($names, $low[$class] ?? [], $high[$class] ?? [])]); } return $meta; } public static function literal(string $code, ?array $args = null) : Nette\PhpGenerator\PhpLiteral { return new Nette\PhpGenerator\PhpLiteral($args === null ? $code : (new Nette\PhpGenerator\Dumper())->format($code, ...$args)); } /** @deprecated */ public function formatPhp(string $statement, array $args) : string { \array_walk_recursive($args, function (&$val) : void { if ($val instanceof Nette\DI\Definitions\Statement) { $val = (new Resolver($this))->completeStatement($val); } elseif ($val instanceof Definition) { $val = new Definitions\Reference($val->getName()); } }); return (new PhpGenerator($this))->formatPhp($statement, $args); } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\DI; use _PHPStan_7d8742a37\Nette; /** * Configurator compiling extension. */ abstract class CompilerExtension { use Nette\SmartObject; /** @var Compiler */ protected $compiler; /** @var string */ protected $name; /** @var array|object */ protected $config = []; /** @var Nette\PhpGenerator\Closure */ protected $initialization; /** @return static */ public function setCompiler(Compiler $compiler, string $name) { $this->initialization = new Nette\PhpGenerator\Closure(); $this->compiler = $compiler; $this->name = $name; return $this; } /** * @param array|object $config * @return static */ public function setConfig($config) { if (!\is_array($config) && !\is_object($config)) { throw new Nette\InvalidArgumentException(); } $this->config = $config; return $this; } /** * Returns extension configuration. * @return array|object */ public function getConfig() { return $this->config; } /** * Returns configuration schema. */ public function getConfigSchema() : Nette\Schema\Schema { return \is_object($this->config) ? Nette\Schema\Expect::from($this->config) : Nette\Schema\Expect::array(); } /** * Checks whether $config contains only $expected items and returns combined array. * @throws Nette\InvalidStateException * @deprecated use getConfigSchema() */ public function validateConfig(array $expected, ?array $config = null, ?string $name = null) : array { if (\func_num_args() === 1) { return $this->config = $this->validateConfig($expected, $this->config); } if ($extra = \array_diff_key((array) $config, $expected)) { $name = $name ? \str_replace('.', " › ", $name) : $this->name; $hint = Nette\Utils\Helpers::getSuggestion(\array_keys($expected), \key($extra)); throw new Nette\DI\InvalidConfigurationException(\sprintf("Unknown configuration option '%s › %s'", $name, $hint ? \key($extra) : \implode("', '{$name} › ", \array_keys($extra))) . ($hint ? ", did you mean '{$name} › {$hint}'?" : '.')); } return Nette\Schema\Helpers::merge($config, $expected); } public function getContainerBuilder() : ContainerBuilder { return $this->compiler->getContainerBuilder(); } /** * Reads configuration from file. */ public function loadFromFile(string $file) : array { $loader = $this->createLoader(); $res = $loader->load($file); $this->compiler->addDependencies($loader->getDependencies()); return $res; } /** * Loads list of service definitions from configuration. * Prefixes its names and replaces @extension with name in definition. */ public function loadDefinitionsFromConfig(array $configList) : void { $res = []; foreach ($configList as $key => $config) { $key = \is_string($key) ? $this->name . '.' . $key : $key; $res[$key] = Helpers::prefixServiceName($config, $this->name); } $this->compiler->loadDefinitionsFromConfig($res); } protected function createLoader() : Config\Loader { return new Config\Loader(); } public function getInitialization() : Nette\PhpGenerator\Closure { return $this->initialization; } /** * Prepend extension name to identifier or service name. */ public function prefix(string $id) : string { return \substr_replace($id, $this->name . '.', \substr($id, 0, 1) === '@' ? 1 : 0, 0); } /** * Processes configuration data. Intended to be overridden by descendant. * @return void */ public function loadConfiguration() { } /** * Adjusts DI container before is compiled to PHP class. Intended to be overridden by descendant. * @return void */ public function beforeCompile() { } /** * Adjusts DI container compiled to PHP class. Intended to be overridden by descendant. * @return void */ public function afterCompile(Nette\PhpGenerator\ClassType $class) { } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\DI; use _PHPStan_7d8742a37\Nette; /** * DI container loader. */ class ContainerLoader { use Nette\SmartObject; /** @var bool */ private $autoRebuild = \false; /** @var string */ private $tempDirectory; public function __construct(string $tempDirectory, bool $autoRebuild = \false) { $this->tempDirectory = $tempDirectory; $this->autoRebuild = $autoRebuild; } /** * @param callable $generator function (Nette\DI\Compiler $compiler): string|null * @param mixed $key */ public function load(callable $generator, $key = null) : string { $class = $this->getClassName($key); if (!\class_exists($class, \false)) { $this->loadFile($class, $generator); } return $class; } /** * @param mixed $key */ public function getClassName($key) : string { return 'Container_' . \substr(\md5(\serialize($key)), 0, 10); } private function loadFile(string $class, callable $generator) : void { $file = "{$this->tempDirectory}/{$class}.php"; if (!$this->isExpired($file) && @(include $file) !== \false) { // @ file may not exist return; } Nette\Utils\FileSystem::createDir($this->tempDirectory); $handle = @\fopen("{$file}.lock", 'c+'); // @ is escalated to exception if (!$handle) { throw new Nette\IOException(\sprintf("Unable to create file '%s.lock'. %s", $file, Nette\Utils\Helpers::getLastError())); } elseif (!@\flock($handle, \LOCK_EX)) { // @ is escalated to exception throw new Nette\IOException(\sprintf("Unable to acquire exclusive lock on '%s.lock'. %s", $file, Nette\Utils\Helpers::getLastError())); } if (!\is_file($file) || $this->isExpired($file, $updatedMeta)) { if (isset($updatedMeta)) { $toWrite["{$file}.meta"] = $updatedMeta; } else { [$toWrite[$file], $toWrite["{$file}.meta"]] = $this->generate($class, $generator); } foreach ($toWrite as $name => $content) { if (\file_put_contents("{$name}.tmp", $content) !== \strlen($content) || !\rename("{$name}.tmp", $name)) { @\unlink("{$name}.tmp"); // @ - file may not exist throw new Nette\IOException(\sprintf("Unable to create file '%s'.", $name)); } elseif (\function_exists('opcache_invalidate')) { @\opcache_invalidate($name, \true); // @ can be restricted } } } if (@(include $file) === \false) { // @ - error escalated to exception throw new Nette\IOException(\sprintf("Unable to include '%s'.", $file)); } \flock($handle, \LOCK_UN); } private function isExpired(string $file, ?string &$updatedMeta = null) : bool { if ($this->autoRebuild) { $meta = @\unserialize((string) \file_get_contents("{$file}.meta")); // @ - file may not exist $orig = $meta[2] ?? null; return empty($meta[0]) || DependencyChecker::isExpired(...$meta) || $orig !== $meta[2] && ($updatedMeta = \serialize($meta)); } return \false; } /** @return array of (code, file[]) */ protected function generate(string $class, callable $generator) : array { $compiler = new Compiler(); $compiler->setClassName($class); $code = $generator(...[&$compiler]) ?: $compiler->compile(); return ["<?php\n{$code}", \serialize($compiler->exportDependencies())]; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\DI; use _PHPStan_7d8742a37\Nette; use _PHPStan_7d8742a37\Nette\DI\Definitions\Reference; use _PHPStan_7d8742a37\Nette\DI\Definitions\Statement; use _PHPStan_7d8742a37\Nette\PhpGenerator as Php; use _PHPStan_7d8742a37\Nette\Utils\Strings; /** * Container PHP code generator. */ class PhpGenerator { use Nette\SmartObject; /** @var ContainerBuilder */ private $builder; /** @var string */ private $className; public function __construct(ContainerBuilder $builder) { $this->builder = $builder; } /** * Generates PHP classes. First class is the container. */ public function generate(string $className) : Php\ClassType { $this->className = $className; $class = new Php\ClassType($this->className); $class->setExtends(Container::class); $class->addMethod('__construct')->addBody('parent::__construct($params);')->addParameter('params', [])->setType('array'); foreach ($this->builder->exportMeta() as $key => $value) { $class->addProperty($key)->setProtected()->setValue($value); } $definitions = $this->builder->getDefinitions(); \ksort($definitions); foreach ($definitions as $def) { $class->addMember($this->generateMethod($def)); } $class->getMethod(Container::getMethodName(ContainerBuilder::ThisContainer))->setReturnType($className)->setBody('return $this;'); $class->addMethod('initialize')->setReturnType('void'); return $class; } public function toString(Php\ClassType $class) : string { return '/** @noinspection PhpParamsInspection,PhpMethodMayBeStaticInspection */ declare(strict_types=1); ' . $class->__toString(); } public function addInitialization(Php\ClassType $class, CompilerExtension $extension) : void { $closure = $extension->getInitialization(); if ($closure->getBody()) { $class->getMethod('initialize')->addBody('// ' . $extension->prefix(''))->addBody("({$closure})();"); } } public function generateMethod(Definitions\Definition $def) : Php\Method { $name = $def->getName(); try { $method = new Php\Method(Container::getMethodName($name)); $method->setPublic(); $method->setReturnType($def->getType()); $def->generateMethod($method, $this); return $method; } catch (\Throwable $e) { throw new ServiceCreationException("Service '{$name}': " . $e->getMessage(), 0, $e); } } /** * Formats PHP code for class instantiating, function calling or property setting in PHP. */ public function formatStatement(Statement $statement) : string { $entity = $statement->getEntity(); $arguments = $statement->arguments; switch (\true) { case \is_string($entity) && Strings::contains($entity, '?'): // PHP literal return $this->formatPhp($entity, $arguments); case \is_string($entity): // create class return $arguments ? $this->formatPhp("new {$entity}(...?:)", [$arguments]) : $this->formatPhp("new {$entity}", []); case \is_array($entity): switch (\true) { case $entity[1][0] === '$': // property getter, setter or appender $name = \substr($entity[1], 1); if ($append = \substr($name, -2) === '[]') { $name = \substr($name, 0, -2); } $prop = $entity[0] instanceof Reference ? $this->formatPhp('?->?', [$entity[0], $name]) : $this->formatPhp('?::$?', [$entity[0], $name]); return $arguments ? $this->formatPhp(($append ? '?[]' : '?') . ' = ?', [new Php\Literal($prop), $arguments[0]]) : $prop; case $entity[0] instanceof Statement: $inner = $this->formatPhp('?', [$entity[0]]); if (\substr($inner, 0, 4) === 'new ') { $inner = "({$inner})"; } return $this->formatPhp('?->?(...?:)', [new Php\Literal($inner), $entity[1], $arguments]); case $entity[0] instanceof Reference: return $this->formatPhp('?->?(...?:)', [$entity[0], $entity[1], $arguments]); case $entity[0] === '': // function call return $this->formatPhp('?(...?:)', [new Php\Literal($entity[1]), $arguments]); case \is_string($entity[0]): // static method call return $this->formatPhp('?::?(...?:)', [new Php\Literal($entity[0]), $entity[1], $arguments]); } } throw new Nette\InvalidStateException(); } /** * Formats PHP statement. * @internal */ public function formatPhp(string $statement, array $args) : string { return (new Php\Dumper())->format($statement, ...$this->convertArguments($args)); } public function convertArguments(array $args) : array { \array_walk_recursive($args, function (&$val) : void { if ($val instanceof Statement) { $val = new Php\Literal($this->formatStatement($val)); } elseif ($val instanceof Reference) { $name = $val->getValue(); if ($val->isSelf()) { $val = new Php\Literal('$service'); } elseif ($name === ContainerBuilder::ThisContainer) { $val = new Php\Literal('$this'); } else { $val = ContainerBuilder::literal('$this->getService(?)', [$name]); } } }); return $args; } /** * Converts parameters from Definition to PhpGenerator. * @return Php\Parameter[] */ public function convertParameters(array $parameters) : array { $res = []; foreach ($parameters as $k => $v) { $tmp = \explode(' ', \is_int($k) ? $v : $k); $param = $res[] = new Php\Parameter(\end($tmp)); if (!\is_int($k)) { $param->setDefaultValue($v); } if (isset($tmp[1])) { $param->setType($tmp[0]); } } return $res; } public function getClassName() : ?string { return $this->className; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\DI\Extensions; use _PHPStan_7d8742a37\Nette; use _PHPStan_7d8742a37\Nette\DI; use _PHPStan_7d8742a37\Nette\DI\Definitions; use _PHPStan_7d8742a37\Nette\Utils\Reflection; /** * Calls inject methods and fills @inject properties. */ final class InjectExtension extends DI\CompilerExtension { public const TagInject = 'nette.inject'; /** @deprecated use InjectExtension::TagInject */ public const TAG_INJECT = self::TagInject; public function getConfigSchema() : Nette\Schema\Schema { return Nette\Schema\Expect::structure([]); } public function beforeCompile() { foreach ($this->getContainerBuilder()->getDefinitions() as $def) { if ($def->getTag(self::TagInject)) { $def = $def instanceof Definitions\FactoryDefinition ? $def->getResultDefinition() : $def; if ($def instanceof Definitions\ServiceDefinition) { $this->updateDefinition($def); } } } } private function updateDefinition(Definitions\ServiceDefinition $def) : void { $resolvedType = (new DI\Resolver($this->getContainerBuilder()))->resolveEntityType($def->getCreator()); $class = \is_subclass_of($resolvedType, $def->getType()) ? $resolvedType : $def->getType(); $setups = $def->getSetup(); foreach (self::getInjectProperties($class) as $property => $type) { $builder = $this->getContainerBuilder(); $inject = new Definitions\Statement('$' . $property, [Definitions\Reference::fromType((string) $type)]); foreach ($setups as $key => $setup) { if ($setup->getEntity() === $inject->getEntity()) { $inject = $setup; $builder = null; unset($setups[$key]); } } \array_unshift($setups, $inject); } foreach (\array_reverse(self::getInjectMethods($class)) as $method) { $inject = new Definitions\Statement($method); foreach ($setups as $key => $setup) { if ($setup->getEntity() === $inject->getEntity()) { $inject = $setup; unset($setups[$key]); } } \array_unshift($setups, $inject); } $def->setSetup($setups); } /** * Generates list of inject methods. * @internal */ public static function getInjectMethods(string $class) : array { $classes = []; foreach (\get_class_methods($class) as $name) { if (\substr($name, 0, 6) === 'inject') { $classes[$name] = (new \ReflectionMethod($class, $name))->getDeclaringClass()->name; } } $methods = \array_keys($classes); \uksort($classes, function (string $a, string $b) use($classes, $methods) : int { return $classes[$a] === $classes[$b] ? \array_search($a, $methods, \true) <=> \array_search($b, $methods, \true) : (\is_a($classes[$a], $classes[$b], \true) ? 1 : -1); }); return \array_keys($classes); } /** * Generates list of properties with annotation @inject. * @internal */ public static function getInjectProperties(string $class) : array { $res = []; foreach ((new \ReflectionClass($class))->getProperties() as $rp) { $name = $rp->getName(); $hasAttr = \PHP_VERSION_ID >= 80000 && $rp->getAttributes(DI\Attributes\Inject::class); if ($hasAttr || DI\Helpers::parseAnnotation($rp, 'inject') !== null) { if (!$rp->isPublic() || $rp->isStatic()) { \trigger_error(\sprintf('Property %s for injection must be public and non-static.', Reflection::toString($rp)), \E_USER_WARNING); continue; } if (\PHP_VERSION_ID >= 80100 && $rp->isReadOnly()) { throw new Nette\InvalidStateException(\sprintf('Property %s for injection must not be readonly.', Reflection::toString($rp))); } $type = Nette\Utils\Type::fromReflection($rp); if (!$type && !$hasAttr && ($annotation = DI\Helpers::parseAnnotation($rp, 'var'))) { $annotation = Reflection::expandClassName($annotation, Reflection::getPropertyDeclaringClass($rp)); $type = Nette\Utils\Type::fromString($annotation); } $res[$rp->getName()] = DI\Helpers::ensureClassType($type, 'type of property ' . Reflection::toString($rp)); } } \ksort($res); return $res; } /** * Calls all methods starting with with "inject" using autowiring. * @param object $service */ public static function callInjects(DI\Container $container, $service) : void { if (!\is_object($service)) { throw new Nette\InvalidArgumentException(\sprintf('Service must be object, %s given.', \gettype($service))); } foreach (self::getInjectMethods(\get_class($service)) as $method) { $container->callMethod([$service, $method]); } foreach (self::getInjectProperties(\get_class($service)) as $property => $type) { $service->{$property} = $container->getByType($type); } } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\DI\Extensions; use _PHPStan_7d8742a37\Nette; use _PHPStan_7d8742a37\Tracy; /** * DI extension. */ final class DIExtension extends Nette\DI\CompilerExtension { /** @var array */ public $exportedTags = []; /** @var array */ public $exportedTypes = []; /** @var bool */ private $debugMode; /** @var float */ private $time; public function __construct(bool $debugMode = \false) { $this->debugMode = $debugMode; $this->time = \microtime(\true); $this->config = new class { /** @var ?bool */ public $debugger; /** @var string[] */ public $excluded = []; /** @var ?string */ public $parentClass; /** @var object */ public $export; }; $this->config->export = new class { /** @var bool */ public $parameters = \true; /** @var string[]|bool|null */ public $tags = \true; /** @var string[]|bool|null */ public $types = \true; }; } public function loadConfiguration() { $builder = $this->getContainerBuilder(); $builder->addExcludedClasses($this->config->excluded); } public function afterCompile(Nette\PhpGenerator\ClassType $class) { if ($this->config->parentClass) { $class->setExtends($this->config->parentClass); } $this->restrictParameters($class); $this->restrictTags($class); $this->restrictTypes($class); if ($this->debugMode && ($this->config->debugger ?? $this->getContainerBuilder()->getByType(Tracy\Bar::class))) { $this->enableTracyIntegration(); } } private function restrictParameters(Nette\PhpGenerator\ClassType $class) : void { if (!$this->config->export->parameters) { $class->removeMethod('getStaticParameters'); } } private function restrictTags(Nette\PhpGenerator\ClassType $class) : void { $option = $this->config->export->tags; if ($option === \true) { } elseif ($option === \false) { $class->removeProperty('tags'); } elseif ($prop = $class->getProperties()['tags'] ?? null) { $prop->setValue(\array_intersect_key($prop->getValue(), $this->exportedTags + \array_flip((array) $option))); } } private function restrictTypes(Nette\PhpGenerator\ClassType $class) : void { $option = $this->config->export->types; if ($option === \true) { return; } $prop = $class->getProperty('wiring'); $prop->setValue(\array_intersect_key($prop->getValue(), $this->exportedTypes + (\is_array($option) ? \array_flip($option) : []))); } private function enableTracyIntegration() : void { Nette\Bridges\DITracy\ContainerPanel::$compilationTime = $this->time; $this->initialization->addBody($this->getContainerBuilder()->formatPhp('?;', [new Nette\DI\Definitions\Statement('@Tracy\\Bar::addPanel', [new Nette\DI\Definitions\Statement(Nette\Bridges\DITracy\ContainerPanel::class)])])); } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\DI\Extensions; use _PHPStan_7d8742a37\Nette; use _PHPStan_7d8742a37\Nette\DI\Definitions; use _PHPStan_7d8742a37\Nette\Schema\Expect; /** * Decorators for services. */ final class DecoratorExtension extends Nette\DI\CompilerExtension { public function getConfigSchema() : Nette\Schema\Schema { return Expect::arrayOf(Expect::structure(['setup' => Expect::list(), 'tags' => Expect::array(), 'inject' => Expect::bool()])); } public function beforeCompile() { $this->getContainerBuilder()->resolve(); foreach ($this->config as $type => $info) { if (!\class_exists($type) && !\interface_exists($type)) { throw new Nette\DI\InvalidConfigurationException(\sprintf("Decorated class '%s' not found.", $type)); } if ($info->inject !== null) { $info->tags[InjectExtension::TagInject] = $info->inject; } $this->addSetups($type, Nette\DI\Helpers::filterArguments($info->setup)); $this->addTags($type, $info->tags); } } public function addSetups(string $type, array $setups) : void { foreach ($this->findByType($type) as $def) { if ($def instanceof Definitions\FactoryDefinition) { $def = $def->getResultDefinition(); } foreach ($setups as $setup) { if (\is_array($setup)) { $setup = new Definitions\Statement(\key($setup), \array_values($setup)); } $def->addSetup($setup); } } } public function addTags(string $type, array $tags) : void { $tags = Nette\Utils\Arrays::normalize($tags, \true); foreach ($this->findByType($type) as $def) { $def->setTags($def->getTags() + $tags); } } private function findByType(string $type) : array { return \array_filter($this->getContainerBuilder()->getDefinitions(), function (Definitions\Definition $def) use($type) : bool { return \is_a($def->getType(), $type, \true) || $def instanceof Definitions\FactoryDefinition && \is_a($def->getResultType(), $type, \true); }); } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\DI\Extensions; use _PHPStan_7d8742a37\Nette; /** * PHP directives definition. * @deprecated use Nette\Bootstrap\Extensions\PhpExtension */ final class PhpExtension extends Nette\DI\CompilerExtension { public function getConfigSchema() : Nette\Schema\Schema { return Nette\Schema\Expect::arrayOf('scalar'); } public function loadConfiguration() { \trigger_error(self::class . ' is deprecated, use Nette\\Bootstrap\\Extensions\\PhpExtension.', \E_USER_DEPRECATED); foreach ($this->getConfig() as $name => $value) { if ($value === null) { continue; } elseif ($name === 'include_path') { $this->initialization->addBody('set_include_path(?);', [\str_replace(';', \PATH_SEPARATOR, $value)]); } elseif ($name === 'ignore_user_abort') { $this->initialization->addBody('ignore_user_abort(?);', [$value]); } elseif ($name === 'max_execution_time') { $this->initialization->addBody('set_time_limit(?);', [$value]); } elseif ($name === 'date.timezone') { $this->initialization->addBody('date_default_timezone_set(?);', [$value]); } elseif (\function_exists('ini_set')) { $this->initialization->addBody('ini_set(?, ?);', [$name, $value === \false ? '0' : (string) $value]); } elseif (\ini_get($name) !== (string) $value) { throw new Nette\NotSupportedException('Required function ini_set() is disabled.'); } } } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\DI\Extensions; use _PHPStan_7d8742a37\Nette; use _PHPStan_7d8742a37\Nette\DI\Config\Helpers; use _PHPStan_7d8742a37\Nette\DI\Definitions; use _PHPStan_7d8742a37\Nette\DI\Definitions\Statement; use _PHPStan_7d8742a37\Nette\Schema\Context; use _PHPStan_7d8742a37\Nette\Schema\Expect; use _PHPStan_7d8742a37\Nette\Schema\Schema; /** * Service configuration schema. */ class DefinitionSchema implements Schema { use Nette\SmartObject; /** @var Nette\DI\ContainerBuilder */ private $builder; public function __construct(Nette\DI\ContainerBuilder $builder) { $this->builder = $builder; } public function complete($def, Context $context) { if ($def === [\false]) { return (object) $def; } if (Helpers::takeParent($def)) { $def['reset']['all'] = \true; } foreach (['arguments', 'setup', 'tags'] as $k) { if (isset($def[$k]) && Helpers::takeParent($def[$k])) { $def['reset'][$k] = \true; } } $def = $this->expandParameters($def); $type = $this->sniffType(\end($context->path), $def); $def = $this->getSchema($type)->complete($def, $context); if ($def) { $def->defType = $type; } return $def; } public function merge($def, $base) { if (!empty($def['alteration'])) { unset($def['alteration']); } return Nette\Schema\Helpers::merge($def, $base); } /** * Normalizes configuration of service definitions. */ public function normalize($def, Context $context) { if ($def === null || $def === \false) { return (array) $def; } elseif (\is_string($def) && \interface_exists($def)) { return ['implement' => $def]; } elseif ($def instanceof Statement && \is_string($def->getEntity()) && \interface_exists($def->getEntity())) { $res = ['implement' => $def->getEntity()]; if (\array_keys($def->arguments) === ['tagged']) { $res += $def->arguments; } elseif (\array_keys($def->arguments) === [0]) { $res['create'] = $def->arguments[0]; } elseif ($def->arguments) { $res['references'] = $def->arguments; } return $res; } elseif (!\is_array($def) || isset($def[0], $def[1])) { return ['create' => $def]; } elseif (\is_array($def)) { // back compatibility if (isset($def['factory']) && !isset($def['create'])) { $def['create'] = $def['factory']; unset($def['factory']); } if (isset($def['class']) && !isset($def['type']) && !isset($def['dynamic']) && !isset($def['imported'])) { $def[isset($def['create']) ? 'type' : 'create'] = $def['class']; unset($def['class']); } foreach (['class' => 'type', 'dynamic' => 'imported'] as $alias => $original) { if (\array_key_exists($alias, $def)) { if (\array_key_exists($original, $def)) { throw new Nette\DI\InvalidConfigurationException(\sprintf("Options '%s' and '%s' are aliases, use only '%s'.", $alias, $original, $original)); } \trigger_error(\sprintf("Service '%s': option '{$alias}' should be changed to '{$original}'.", \end($context->path)), \E_USER_DEPRECATED); $def[$original] = $def[$alias]; unset($def[$alias]); } } return $def; } else { throw new Nette\DI\InvalidConfigurationException('Unexpected format of service definition'); } } public function completeDefault(Context $context) { } private function sniffType($key, array $def) : string { if (\is_string($key)) { $name = \preg_match('#^@[\\w\\\\]+$#D', $key) ? $this->builder->getByType(\substr($key, 1), \false) : $key; if ($name && $this->builder->hasDefinition($name)) { return \get_class($this->builder->getDefinition($name)); } } if (isset($def['implement'], $def['references']) || isset($def['implement'], $def['tagged'])) { return Definitions\LocatorDefinition::class; } elseif (isset($def['implement'])) { return \method_exists($def['implement'], 'create') ? Definitions\FactoryDefinition::class : Definitions\AccessorDefinition::class; } elseif (isset($def['imported'])) { return Definitions\ImportedDefinition::class; } elseif (!$def) { throw new Nette\DI\InvalidConfigurationException("Service '{$key}': Empty definition."); } else { return Definitions\ServiceDefinition::class; } } private function expandParameters(array $config) : array { $params = $this->builder->parameters; if (isset($config['parameters'])) { foreach ((array) $config['parameters'] as $k => $v) { $v = \explode(' ', \is_int($k) ? $v : $k); $params[\end($v)] = $this->builder::literal('$' . \end($v)); } } return Nette\DI\Helpers::expand($config, $params); } private static function getSchema(string $type) : Schema { static $cache; $cache = $cache ?: [Definitions\ServiceDefinition::class => self::getServiceSchema(), Definitions\AccessorDefinition::class => self::getAccessorSchema(), Definitions\FactoryDefinition::class => self::getFactorySchema(), Definitions\LocatorDefinition::class => self::getLocatorSchema(), Definitions\ImportedDefinition::class => self::getImportedSchema()]; return $cache[$type]; } private static function getServiceSchema() : Schema { return Expect::structure(['type' => Expect::type('string'), 'create' => Expect::type('callable|_PHPStan_7d8742a37\\Nette\\DI\\Definitions\\Statement'), 'arguments' => Expect::array(), 'setup' => Expect::listOf('callable|_PHPStan_7d8742a37\\Nette\\DI\\Definitions\\Statement|array:1'), 'inject' => Expect::bool(), 'autowired' => Expect::type('bool|string|array'), 'tags' => Expect::array(), 'reset' => Expect::array(), 'alteration' => Expect::bool()]); } private static function getAccessorSchema() : Schema { return Expect::structure(['type' => Expect::string(), 'implement' => Expect::string(), 'create' => Expect::type('callable|_PHPStan_7d8742a37\\Nette\\DI\\Definitions\\Statement'), 'autowired' => Expect::type('bool|string|array'), 'tags' => Expect::array()]); } private static function getFactorySchema() : Schema { return Expect::structure(['type' => Expect::string(), 'create' => Expect::type('callable|_PHPStan_7d8742a37\\Nette\\DI\\Definitions\\Statement'), 'implement' => Expect::string(), 'arguments' => Expect::array(), 'setup' => Expect::listOf('callable|_PHPStan_7d8742a37\\Nette\\DI\\Definitions\\Statement|array:1'), 'parameters' => Expect::array(), 'references' => Expect::array(), 'tagged' => Expect::string(), 'inject' => Expect::bool(), 'autowired' => Expect::type('bool|string|array'), 'tags' => Expect::array(), 'reset' => Expect::array()]); } private static function getLocatorSchema() : Schema { return Expect::structure(['implement' => Expect::string(), 'references' => Expect::array(), 'tagged' => Expect::string(), 'autowired' => Expect::type('bool|string|array'), 'tags' => Expect::array()]); } private static function getImportedSchema() : Schema { return Expect::structure(['type' => Expect::string(), 'imported' => Expect::bool(), 'autowired' => Expect::type('bool|string|array'), 'tags' => Expect::array()]); } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\DI\Extensions; use _PHPStan_7d8742a37\Nette; /** * Constant definitions. * @deprecated use Nette\Bootstrap\Extensions\ConstantsExtension */ final class ConstantsExtension extends Nette\DI\CompilerExtension { public function loadConfiguration() { \trigger_error(self::class . ' is deprecated, use Nette\\Bootstrap\\Extensions\\ConstantsExtension.', \E_USER_DEPRECATED); foreach ($this->getConfig() as $name => $value) { $this->initialization->addBody('define(?, ?);', [$name, $value]); } } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\DI\Extensions; use _PHPStan_7d8742a37\Nette; use _PHPStan_7d8742a37\Nette\DI\Definitions; use _PHPStan_7d8742a37\Nette\DI\Definitions\Statement; use _PHPStan_7d8742a37\Nette\DI\Helpers; /** * Service definitions loader. */ final class ServicesExtension extends Nette\DI\CompilerExtension { use Nette\SmartObject; public function getConfigSchema() : Nette\Schema\Schema { return Nette\Schema\Expect::arrayOf(new DefinitionSchema($this->getContainerBuilder())); } public function loadConfiguration() { $this->loadDefinitions($this->config); } /** * Loads list of service definitions. */ public function loadDefinitions(array $config) { foreach ($config as $key => $defConfig) { $this->loadDefinition($this->convertKeyToName($key), $defConfig); } } /** * Loads service definition from normalized configuration. */ private function loadDefinition(?string $name, \stdClass $config) : void { try { if ((array) $config === [\false]) { $this->getContainerBuilder()->removeDefinition($name); return; } elseif (!empty($config->alteration) && !$this->getContainerBuilder()->hasDefinition($name)) { throw new Nette\DI\InvalidConfigurationException('missing original definition for alteration.'); } $def = $this->retrieveDefinition($name, $config); $methods = [Definitions\ServiceDefinition::class => 'updateServiceDefinition', Definitions\AccessorDefinition::class => 'updateAccessorDefinition', Definitions\FactoryDefinition::class => 'updateFactoryDefinition', Definitions\LocatorDefinition::class => 'updateLocatorDefinition', Definitions\ImportedDefinition::class => 'updateImportedDefinition']; $this->{$methods[$config->defType]}($def, $config); $this->updateDefinition($def, $config); } catch (\Throwable $e) { throw new Nette\DI\InvalidConfigurationException(($name ? "Service '{$name}': " : '') . $e->getMessage(), 0, $e); } } /** * Updates service definition according to normalized configuration. */ private function updateServiceDefinition(Definitions\ServiceDefinition $definition, \stdClass $config) : void { if ($config->create) { $definition->setCreator(Helpers::filterArguments([$config->create])[0]); $definition->setType(null); } if ($config->type) { $definition->setType($config->type); } if ($config->arguments) { $arguments = Helpers::filterArguments($config->arguments); if (empty($config->reset['arguments']) && !Nette\Utils\Arrays::isList($arguments)) { $arguments = \array_replace($definition->getCreator()->arguments, $arguments); } $definition->setArguments($arguments); } if (isset($config->setup)) { if (!empty($config->reset['setup'])) { $definition->setSetup([]); } foreach (Helpers::filterArguments($config->setup) as $id => $setup) { if (\is_array($setup)) { $setup = new Statement(\key($setup), \array_values($setup)); } $definition->addSetup($setup); } } if (isset($config->inject)) { $definition->addTag(InjectExtension::TagInject, $config->inject); } } private function updateAccessorDefinition(Definitions\AccessorDefinition $definition, \stdClass $config) : void { if (isset($config->implement)) { $definition->setImplement($config->implement); } if ($ref = $config->create ?? $config->type ?? null) { $definition->setReference($ref); } } private function updateFactoryDefinition(Definitions\FactoryDefinition $definition, \stdClass $config) : void { $resultDef = $definition->getResultDefinition(); if (isset($config->implement)) { $definition->setImplement($config->implement); $definition->setAutowired(\true); } if ($config->create) { $resultDef->setCreator(Helpers::filterArguments([$config->create])[0]); } if ($config->type) { $resultDef->setCreator($config->type); } if ($config->arguments) { $arguments = Helpers::filterArguments($config->arguments); if (empty($config->reset['arguments']) && !Nette\Utils\Arrays::isList($arguments)) { $arguments = \array_replace($resultDef->getCreator()->arguments, $arguments); } $resultDef->setArguments($arguments); } if (isset($config->setup)) { if (!empty($config->reset['setup'])) { $resultDef->setSetup([]); } foreach (Helpers::filterArguments($config->setup) as $id => $setup) { if (\is_array($setup)) { $setup = new Statement(\key($setup), \array_values($setup)); } $resultDef->addSetup($setup); } } if (isset($config->parameters)) { $definition->setParameters($config->parameters); } if (isset($config->inject)) { $definition->addTag(InjectExtension::TagInject, $config->inject); } } private function updateLocatorDefinition(Definitions\LocatorDefinition $definition, \stdClass $config) : void { if (isset($config->implement)) { $definition->setImplement($config->implement); } if (isset($config->references)) { $definition->setReferences($config->references); } if (isset($config->tagged)) { $definition->setTagged($config->tagged); } } private function updateImportedDefinition(Definitions\ImportedDefinition $definition, \stdClass $config) : void { if ($config->type) { $definition->setType($config->type); } } private function updateDefinition(Definitions\Definition $definition, \stdClass $config) : void { if (isset($config->autowired)) { $definition->setAutowired($config->autowired); } if (isset($config->tags)) { if (!empty($config->reset['tags'])) { $definition->setTags([]); } foreach ($config->tags as $tag => $attrs) { if (\is_int($tag) && \is_string($attrs)) { $definition->addTag($attrs); } else { $definition->addTag($tag, $attrs); } } } } private function convertKeyToName($key) : ?string { if (\is_int($key)) { return null; } elseif (\preg_match('#^@[\\w\\\\]+$#D', $key)) { return $this->getContainerBuilder()->getByType(\substr($key, 1), \true); } return $key; } private function retrieveDefinition(?string $name, \stdClass $config) : Definitions\Definition { $builder = $this->getContainerBuilder(); if (!empty($config->reset['all'])) { $builder->removeDefinition($name); } return $name && $builder->hasDefinition($name) ? $builder->getDefinition($name) : $builder->addDefinition($name, new $config->defType()); } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\DI\Extensions; use _PHPStan_7d8742a37\Nette; /** * Enables registration of other extensions in $config file */ class ExtensionsExtension extends Nette\DI\CompilerExtension { public function getConfigSchema() : Nette\Schema\Schema { return Nette\Schema\Expect::arrayOf('string|_PHPStan_7d8742a37\\Nette\\DI\\Definitions\\Statement'); } public function loadConfiguration() { foreach ($this->getConfig() as $name => $class) { if (\is_int($name)) { $name = null; } $args = []; if ($class instanceof Nette\DI\Definitions\Statement) { [$class, $args] = [$class->getEntity(), $class->arguments]; } if (!\is_a($class, Nette\DI\CompilerExtension::class, \true)) { throw new Nette\DI\InvalidConfigurationException(\sprintf("Extension '%s' not found or is not Nette\\DI\\CompilerExtension descendant.", $class)); } $this->compiler->addExtension($name, (new \ReflectionClass($class))->newInstanceArgs($args)); } } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\DI\Extensions; use _PHPStan_7d8742a37\Nette; use _PHPStan_7d8742a37\Nette\Loaders\RobotLoader; use _PHPStan_7d8742a37\Nette\Schema\Expect; use _PHPStan_7d8742a37\Nette\Utils\Arrays; /** * Services auto-discovery. */ final class SearchExtension extends Nette\DI\CompilerExtension { /** @var array */ private $classes = []; /** @var string */ private $tempDir; public function __construct(string $tempDir) { $this->tempDir = $tempDir; } public function getConfigSchema() : Nette\Schema\Schema { return Expect::arrayOf(Expect::structure(['in' => Expect::string()->required(), 'files' => Expect::anyOf(Expect::listOf('string'), Expect::string()->castTo('array'))->default([]), 'classes' => Expect::anyOf(Expect::listOf('string'), Expect::string()->castTo('array'))->default([]), 'extends' => Expect::anyOf(Expect::listOf('string'), Expect::string()->castTo('array'))->default([]), 'implements' => Expect::anyOf(Expect::listOf('string'), Expect::string()->castTo('array'))->default([]), 'exclude' => Expect::structure(['classes' => Expect::anyOf(Expect::listOf('string'), Expect::string()->castTo('array'))->default([]), 'extends' => Expect::anyOf(Expect::listOf('string'), Expect::string()->castTo('array'))->default([]), 'implements' => Expect::anyOf(Expect::listOf('string'), Expect::string()->castTo('array'))->default([])]), 'tags' => Expect::array()]))->before(function ($val) { return \is_string($val['in'] ?? null) ? ['default' => $val] : $val; }); } public function loadConfiguration() { foreach (\array_filter($this->config) as $name => $batch) { if (!\is_dir($batch->in)) { throw new Nette\DI\InvalidConfigurationException(\sprintf("Option '%s › %s › in' must be valid directory name, '%s' given.", $this->name, $name, $batch->in)); } foreach ($this->findClasses($batch) as $class) { $this->classes[$class] = \array_merge($this->classes[$class] ?? [], $batch->tags); } } } public function findClasses(\stdClass $config) : array { $robot = new RobotLoader(); $robot->setTempDirectory($this->tempDir); $robot->addDirectory($config->in); $robot->acceptFiles = $config->files ?: ['*.php']; $robot->reportParseErrors(\false); $robot->refresh(); $classes = \array_unique(\array_keys($robot->getIndexedClasses())); $exclude = $config->exclude; $acceptRE = self::buildNameRegexp($config->classes); $rejectRE = self::buildNameRegexp($exclude->classes); $acceptParent = \array_merge($config->extends, $config->implements); $rejectParent = \array_merge($exclude->extends, $exclude->implements); $found = []; foreach ($classes as $class) { if (!\class_exists($class) && !\interface_exists($class) && !\trait_exists($class)) { throw new Nette\InvalidStateException(\sprintf('Class %s was found, but it cannot be loaded by autoloading.', $class)); } $rc = new \ReflectionClass($class); if (($rc->isInstantiable() || $rc->isInterface() && \count($methods = $rc->getMethods()) === 1 && $methods[0]->name === 'create') && (!$acceptRE || \preg_match($acceptRE, $rc->name)) && (!$rejectRE || !\preg_match($rejectRE, $rc->name)) && (!$acceptParent || Arrays::some($acceptParent, function ($nm) use($rc) { return $rc->isSubclassOf($nm); })) && (!$rejectParent || Arrays::every($rejectParent, function ($nm) use($rc) { return !$rc->isSubclassOf($nm); }))) { $found[] = $rc->name; } } return $found; } public function beforeCompile() { $builder = $this->getContainerBuilder(); foreach ($this->classes as $class => $foo) { if ($builder->findByType($class)) { unset($this->classes[$class]); } } foreach ($this->classes as $class => $tags) { $def = \class_exists($class) ? $builder->addDefinition(null)->setType($class) : $builder->addFactoryDefinition(null)->setImplement($class); $def->setTags(Arrays::normalize($tags, \true)); } } private static function buildNameRegexp(array $masks) : ?string { $res = []; foreach ((array) $masks as $mask) { $mask = (\strpos($mask, '\\') === \false ? '**\\' : '') . $mask; $mask = \preg_quote($mask, '#'); $mask = \str_replace('\\*\\*\\\\', '(.*\\\\)?', $mask); $mask = \str_replace('\\\\\\*\\*', '(\\\\.*)?', $mask); $mask = \str_replace('\\*', '\\w*', $mask); $res[] = $mask; } return $res ? '#^(' . \implode('|', $res) . ')$#i' : null; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\DI\Extensions; use _PHPStan_7d8742a37\Nette; use _PHPStan_7d8742a37\Nette\DI\Container; use _PHPStan_7d8742a37\Nette\DI\DynamicParameter; use _PHPStan_7d8742a37\Nette\PhpGenerator\Method; /** * Parameters. */ final class ParametersExtension extends Nette\DI\CompilerExtension { /** @var string[] */ public $dynamicParams = []; /** @var string[][] */ public $dynamicValidators = []; /** @var array */ private $compilerConfig; public function __construct(array &$compilerConfig) { $this->compilerConfig =& $compilerConfig; } public function loadConfiguration() { $builder = $this->getContainerBuilder(); $params = $this->config; foreach ($this->collectDynamicParams($params) as $key) { $params[$key] = new DynamicParameter((new Nette\PhpGenerator\Dumper())->format('$this->getParameter(?)', $key)); } $builder->parameters = Nette\DI\Helpers::expand($params, $params, \true); // expand all except 'services' $slice = \array_diff_key($this->compilerConfig, ['services' => 1]); $slice = Nette\DI\Helpers::expand($slice, $builder->parameters); $this->compilerConfig = $slice + $this->compilerConfig; } public function afterCompile(Nette\PhpGenerator\ClassType $class) { $builder = $this->getContainerBuilder(); $dynamicParams = $this->collectDynamicParams($builder->parameters); $method = Method::from([Container::class, 'getStaticParameters'])->addBody('return ?;', [\array_diff_key($builder->parameters, \array_flip($dynamicParams))]); $class->addMember($method); if (!$dynamicParams) { return; } $resolver = new Nette\DI\Resolver($builder); $generator = new Nette\DI\PhpGenerator($builder); $method = Method::from([Container::class, 'getDynamicParameter']); $class->addMember($method); $method->addBody('switch (true) {'); foreach ($dynamicParams as $key) { $value = Nette\DI\Helpers::expand($this->config[$key] ?? null, $builder->parameters); $value = $resolver->completeArguments(Nette\DI\Helpers::filterArguments([$value])); $method->addBody("\tcase \$key === ?: return ?;", [$key, $generator->convertArguments($value)[0]]); } $method->addBody("\tdefault: return parent::getDynamicParameter(\$key);\n};"); $method = Method::from([Container::class, 'getParameters']); $class->addMember($method); $method->addBody('array_map(function ($key) { $this->getParameter($key); }, ?);', [\array_values($dynamicParams)]); $method->addBody('return parent::getParameters();'); foreach ($this->dynamicValidators as [$param, $expected]) { if (!$param instanceof Nette\DI\Definitions\Statement) { $this->initialization->addBody('Nette\\Utils\\Validators::assert(?, ?, ?);', [$param, $expected, 'dynamic parameter']); } } } private function collectDynamicParams(array $params) : array { $keys = $this->dynamicParams; foreach ($params as $key => $value) { $tmp = [$value]; \array_walk_recursive($tmp, function ($val) use(&$keys, $key) : void { if ($val instanceof DynamicParameter || $val instanceof Nette\DI\Definitions\Statement) { $keys[] = $key; } }); } return \array_unique($keys); } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\DI; use _PHPStan_7d8742a37\Nette; use _PHPStan_7d8742a37\Nette\DI\Definitions\Reference; use _PHPStan_7d8742a37\Nette\DI\Definitions\Statement; use _PHPStan_7d8742a37\Nette\Utils\Reflection; use _PHPStan_7d8742a37\Nette\Utils\Type; /** * The DI helpers. * @internal */ final class Helpers { use Nette\StaticClass; /** * Expands %placeholders%. * @param mixed $var * @param bool|array $recursive * @return mixed * @throws Nette\InvalidArgumentException */ public static function expand($var, array $params, $recursive = \false) { if (\is_array($var)) { $res = []; foreach ($var as $key => $val) { $res[self::expand($key, $params, $recursive)] = self::expand($val, $params, $recursive); } return $res; } elseif ($var instanceof Statement) { return new Statement(self::expand($var->getEntity(), $params, $recursive), self::expand($var->arguments, $params, $recursive)); } elseif ($var === '%parameters%' && !\array_key_exists('parameters', $params)) { return $recursive ? self::expand($params, $params, \is_array($recursive) ? $recursive : []) : $params; } elseif (!\is_string($var)) { return $var; } $parts = \preg_split('#%([\\w.-]*)%#i', $var, -1, \PREG_SPLIT_DELIM_CAPTURE); $res = []; $php = \false; foreach ($parts as $n => $part) { if ($n % 2 === 0) { $res[] = $part; } elseif ($part === '') { $res[] = '%'; } elseif (isset($recursive[$part])) { throw new Nette\InvalidArgumentException(\sprintf('Circular reference detected for variables: %s.', \implode(', ', \array_keys($recursive)))); } else { $val = $params; foreach (\explode('.', $part) as $key) { if (\is_array($val) && \array_key_exists($key, $val)) { $val = $val[$key]; } elseif ($val instanceof DynamicParameter) { $val = new DynamicParameter($val . '[' . \var_export($key, \true) . ']'); } else { throw new Nette\InvalidArgumentException(\sprintf("Missing parameter '%s'.", $part)); } } if ($recursive) { $val = self::expand($val, $params, (\is_array($recursive) ? $recursive : []) + [$part => 1]); } if (\strlen($part) + 2 === \strlen($var)) { return $val; } if ($val instanceof DynamicParameter) { $php = \true; } elseif (!\is_scalar($val)) { throw new Nette\InvalidArgumentException(\sprintf("Unable to concatenate non-scalar parameter '%s' into '%s'.", $part, $var)); } $res[] = $val; } } if ($php) { $res = \array_filter($res, function ($val) : bool { return $val !== ''; }); $res = \array_map(function ($val) : string { return $val instanceof DynamicParameter ? "({$val})" : \var_export((string) $val, \true); }, $res); return new DynamicParameter(\implode(' . ', $res)); } return \implode('', $res); } /** * Escapes '%' and '@' * @param mixed $value * @return mixed */ public static function escape($value) { if (\is_array($value)) { $res = []; foreach ($value as $key => $val) { $key = \is_string($key) ? \str_replace('%', '%%', $key) : $key; $res[$key] = self::escape($val); } return $res; } elseif (\is_string($value)) { return \preg_replace('#^@|%#', '$0$0', $value); } return $value; } /** * Process constants recursively. */ public static function filterArguments(array $args) : array { foreach ($args as $k => $v) { if (\PHP_VERSION_ID >= 80100 && \is_string($v) && \preg_match('#^([\\w\\\\]+)::\\w+$#D', $v, $m) && \enum_exists($m[1])) { $args[$k] = new Nette\PhpGenerator\PhpLiteral($v); } elseif (\is_string($v) && \preg_match('#^[\\w\\\\]*::[A-Z][a-zA-Z0-9_]*$#D', $v)) { $args[$k] = new Nette\PhpGenerator\PhpLiteral(\ltrim($v, ':')); } elseif (\is_string($v) && \preg_match('#^@[\\w\\\\]+$#D', $v)) { $args[$k] = new Reference(\substr($v, 1)); } elseif (\is_array($v)) { $args[$k] = self::filterArguments($v); } elseif ($v instanceof Statement) { [$tmp] = self::filterArguments([$v->getEntity()]); $args[$k] = new Statement($tmp, self::filterArguments($v->arguments)); } } return $args; } /** * Replaces @extension with real extension name in service definition. * @param mixed $config * @return mixed */ public static function prefixServiceName($config, string $namespace) { if (\is_string($config)) { if (\strncmp($config, '@extension.', 10) === 0) { $config = '@' . $namespace . '.' . \substr($config, 11); } } elseif ($config instanceof Reference) { if (\strncmp($config->getValue(), 'extension.', 9) === 0) { $config = new Reference($namespace . '.' . \substr($config->getValue(), 10)); } } elseif ($config instanceof Statement) { return new Statement(self::prefixServiceName($config->getEntity(), $namespace), self::prefixServiceName($config->arguments, $namespace)); } elseif (\is_array($config)) { foreach ($config as &$val) { $val = self::prefixServiceName($val, $namespace); } } return $config; } /** * Returns an annotation value. * @param \ReflectionFunctionAbstract|\ReflectionProperty|\ReflectionClass $ref */ public static function parseAnnotation(\Reflector $ref, string $name) : ?string { if (!Reflection::areCommentsAvailable()) { throw new Nette\InvalidStateException('You have to enable phpDoc comments in opcode cache.'); } $re = '#[\\s*]@' . \preg_quote($name, '#') . '(?=\\s|$)(?:[ \\t]+([^@\\s]\\S*))?#'; if ($ref->getDocComment() && \preg_match($re, \trim($ref->getDocComment(), '/*'), $m)) { return $m[1] ?? ''; } return null; } public static function getReturnTypeAnnotation(\ReflectionFunctionAbstract $func) : ?Type { $type = \preg_replace('#[|\\s].*#', '', (string) self::parseAnnotation($func, 'return')); if (!$type || $type === 'object' || $type === 'mixed') { return null; } elseif ($func instanceof \ReflectionMethod) { $type = $type === '$this' ? 'static' : $type; $type = Reflection::expandClassName($type, $func->getDeclaringClass()); } return Type::fromString($type); } public static function ensureClassType(?Type $type, string $hint, bool $allowNullable = \false) : string { if (!$type) { throw new ServiceCreationException(\sprintf('%s is not declared.', \ucfirst($hint))); } elseif (!$type->isClass() || !$allowNullable && $type->allows('null')) { throw new ServiceCreationException(\sprintf("%s is expected to not be %sbuilt-in/complex, '%s' given.", \ucfirst($hint), $allowNullable ? '' : 'nullable/', $type)); } $class = $type->getSingleName(); if (!\class_exists($class) && !\interface_exists($class)) { throw new ServiceCreationException(\sprintf("Class '%s' not found.\nCheck the %s.", $class, $hint)); } return $class; } public static function normalizeClass(string $type) : string { return \class_exists($type) || \interface_exists($type) ? (new \ReflectionClass($type))->name : $type; } /** * Non data-loss type conversion. * @param mixed $value * @return mixed * @throws Nette\InvalidStateException */ public static function convertType($value, string $type) { if (\is_scalar($value)) { $norm = $value === \false ? '0' : (string) $value; if ($type === 'float') { $norm = \preg_replace('#\\.0*$#D', '', $norm); } $orig = $norm; \settype($norm, $type); if ($orig === ($norm === \false ? '0' : (string) $norm)) { return $norm; } } throw new Nette\InvalidStateException(\sprintf('Cannot convert %s to %s.', \is_scalar($value) ? "'{$value}'" : \gettype($value), $type)); } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\DI; use _PHPStan_7d8742a37\Nette; /** * Autowiring. */ class Autowiring { use Nette\SmartObject; /** @var ContainerBuilder */ private $builder; /** @var array[] type => services, used by getByType() */ private $highPriority = []; /** @var array[] type => services, used by findByType() */ private $lowPriority = []; /** @var string[] of classes excluded from autowiring */ private $excludedClasses = []; public function __construct(ContainerBuilder $builder) { $this->builder = $builder; } /** * Resolves service name by type. * @param bool $throw exception if service not found? * @throws MissingServiceException when not found * @throws ServiceCreationException when multiple found */ public function getByType(string $type, bool $throw = \false) : ?string { $type = Helpers::normalizeClass($type); $types = $this->highPriority; if (empty($types[$type])) { if ($throw) { if (!\class_exists($type) && !\interface_exists($type)) { throw new MissingServiceException(\sprintf("Service of type '%s' not found. Check the class name because it cannot be found.", $type)); } throw new MissingServiceException(\sprintf('Service of type %s not found. Did you add it to configuration file?', $type)); } return null; } elseif (\count($types[$type]) === 1) { return $types[$type][0]; } else { $list = $types[$type]; \natsort($list); $hint = \count($list) === 2 && ($tmp = \strpos($list[0], '.') xor \strpos($list[1], '.')) ? '. If you want to overwrite service ' . $list[$tmp ? 0 : 1] . ', give it proper name.' : ''; throw new ServiceCreationException(\sprintf("Multiple services of type {$type} found: %s%s", \implode(', ', $list), $hint)); } } /** * Gets the service names and definitions of the specified type. * @return Definitions\Definition[] service name is key */ public function findByType(string $type) : array { $type = Helpers::normalizeClass($type); $definitions = $this->builder->getDefinitions(); $names = \array_merge($this->highPriority[$type] ?? [], $this->lowPriority[$type] ?? []); $res = []; foreach ($names as $name) { $res[$name] = $definitions[$name]; } return $res; } /** * @param string[] $types */ public function addExcludedClasses(array $types) : void { foreach ($types as $type) { if (\class_exists($type) || \interface_exists($type)) { $type = Helpers::normalizeClass($type); $this->excludedClasses += \class_parents($type) + \class_implements($type) + [$type => $type]; } } } public function getClassList() : array { return [$this->lowPriority, $this->highPriority]; } public function rebuild() : void { $this->lowPriority = $this->highPriority = $preferred = []; foreach ($this->builder->getDefinitions() as $name => $def) { if (!($type = $def->getType())) { continue; } $autowired = $def->getAutowired(); if (\is_array($autowired)) { foreach ($autowired as $k => $autowiredType) { if ($autowiredType === ContainerBuilder::ThisService) { $autowired[$k] = $type; } elseif (!\is_a($type, $autowiredType, \true)) { throw new ServiceCreationException(\sprintf("Incompatible class %s in autowiring definition of service '%s'.", $autowiredType, $name)); } } } foreach (\class_parents($type) + \class_implements($type) + [$type] as $parent) { if (!$autowired || isset($this->excludedClasses[$parent])) { continue; } elseif (\is_array($autowired)) { $priority = \false; foreach ($autowired as $autowiredType) { if (\is_a($parent, $autowiredType, \true)) { if (empty($preferred[$parent]) && isset($this->highPriority[$parent])) { $this->lowPriority[$parent] = \array_merge($this->lowPriority[$parent] ?? [], $this->highPriority[$parent]); $this->highPriority[$parent] = []; } $preferred[$parent] = $priority = \true; break; } } } else { $priority = empty($preferred[$parent]); } $list = $priority ? 'highPriority' : 'lowPriority'; $this->{$list}[$parent][] = $name; } } } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\DI\Config; /** * Adapter for reading and writing configuration files. */ interface Adapter { /** * Reads configuration from file. */ function load(string $file) : array; } \class_exists(IAdapter::class); <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\DI\Config; use _PHPStan_7d8742a37\Nette; use _PHPStan_7d8742a37\Nette\Utils\Validators; /** * Configuration file loader. */ class Loader { use Nette\SmartObject; private const IncludesKey = 'includes'; private $adapters = ['php' => Adapters\PhpAdapter::class, 'neon' => Adapters\NeonAdapter::class]; private $dependencies = []; private $loadedFiles = []; private $parameters = []; /** * Reads configuration from file. */ public function load(string $file, ?bool $merge = \true) : array { if (!\is_file($file) || !\is_readable($file)) { throw new Nette\FileNotFoundException(\sprintf("File '%s' is missing or is not readable.", $file)); } if (isset($this->loadedFiles[$file])) { throw new Nette\InvalidStateException(\sprintf("Recursive included file '%s'", $file)); } $this->loadedFiles[$file] = \true; $this->dependencies[] = $file; $data = $this->getAdapter($file)->load($file); $res = []; if (isset($data[self::IncludesKey])) { Validators::assert($data[self::IncludesKey], 'list', "section 'includes' in file '{$file}'"); $includes = Nette\DI\Helpers::expand($data[self::IncludesKey], $this->parameters); foreach ($includes as $include) { $include = $this->expandIncludedFile($include, $file); $res = Nette\Schema\Helpers::merge($this->load($include, $merge), $res); } } unset($data[self::IncludesKey], $this->loadedFiles[$file]); if ($merge === \false) { $res[] = $data; } else { $res = Nette\Schema\Helpers::merge($data, $res); } return $res; } /** @deprecated */ public function save(array $data, string $file) : void { \trigger_error(__METHOD__ . "() is deprecated, use adapter's dump() method.", \E_USER_DEPRECATED); if (\file_put_contents($file, $this->getAdapter($file)->dump($data)) === \false) { throw new Nette\IOException(\sprintf("Cannot write file '%s'.", $file)); } } /** * Returns configuration files. */ public function getDependencies() : array { return \array_unique($this->dependencies); } /** * Expands included file name. */ public function expandIncludedFile(string $includedFile, string $mainFile) : string { return \preg_match('#([a-z]+:)?[/\\\\]#Ai', $includedFile) ? $includedFile : \dirname($mainFile) . '/' . $includedFile; } /** * Registers adapter for given file extension. * @param string|Adapter $adapter * @return static */ public function addAdapter(string $extension, $adapter) { $this->adapters[\strtolower($extension)] = $adapter; return $this; } private function getAdapter(string $file) : Adapter { $extension = \strtolower(\pathinfo($file, \PATHINFO_EXTENSION)); if (!isset($this->adapters[$extension])) { throw new Nette\InvalidArgumentException(\sprintf("Unknown file extension '%s'.", $file)); } return \is_object($this->adapters[$extension]) ? $this->adapters[$extension] : new $this->adapters[$extension](); } /** @return static */ public function setParameters(array $params) { $this->parameters = $params; return $this; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\DI\Config\Adapters; use _PHPStan_7d8742a37\Nette; /** * Reading and generating PHP files. */ final class PhpAdapter implements Nette\DI\Config\Adapter { use Nette\SmartObject; /** * Reads configuration from PHP file. */ public function load(string $file) : array { return require $file; } /** * Generates configuration in PHP format. */ public function dump(array $data) : string { return "<?php // generated by Nette \nreturn " . (new Nette\PhpGenerator\Dumper())->dump($data) . ';'; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\DI\Config\Adapters; use _PHPStan_7d8742a37\Nette; use _PHPStan_7d8742a37\Nette\DI\Config\Helpers; use _PHPStan_7d8742a37\Nette\DI\Definitions\Reference; use _PHPStan_7d8742a37\Nette\DI\Definitions\Statement; use _PHPStan_7d8742a37\Nette\Neon; /** * Reading and generating NEON files. */ final class NeonAdapter implements Nette\DI\Config\Adapter { use Nette\SmartObject; private const PreventMergingSuffix = '!'; /** @var string */ private $file; /** * Reads configuration from NEON file. */ public function load(string $file) : array { $input = Nette\Utils\FileSystem::read($file); if (\substr($input, 0, 3) === "") { // BOM $input = \substr($input, 3); } $this->file = $file; $decoder = new Neon\Decoder(); $node = $decoder->parseToNode($input); $traverser = new Neon\Traverser(); $node = $traverser->traverse($node, [$this, 'removeUnderscoreVisitor']); $node = $traverser->traverse($node, [$this, 'convertAtSignVisitor']); return $this->process((array) $node->toValue()); } /** @throws Nette\InvalidStateException */ public function process(array $arr) : array { $res = []; foreach ($arr as $key => $val) { if (\is_string($key) && \substr($key, -1) === self::PreventMergingSuffix) { if (!\is_array($val) && $val !== null) { throw new Nette\DI\InvalidConfigurationException(\sprintf("Replacing operator is available only for arrays, item '%s' is not array (used in '%s')", $key, $this->file)); } $key = \substr($key, 0, -1); $val[Helpers::PREVENT_MERGING] = \true; } if (\is_array($val)) { $val = $this->process($val); } elseif ($val instanceof Neon\Entity) { if ($val->value === Neon\Neon::CHAIN) { $tmp = null; foreach ($this->process($val->attributes) as $st) { $tmp = new Statement($tmp === null ? $st->getEntity() : [$tmp, \ltrim(\implode('::', (array) $st->getEntity()), ':')], $st->arguments); } $val = $tmp; } else { $tmp = $this->process([$val->value]); if (\is_string($tmp[0]) && \strpos($tmp[0], '?') !== \false) { throw new Nette\DI\InvalidConfigurationException("Operator ? is deprecated in config file (used in '{$this->file}')"); } $val = new Statement($tmp[0], $this->process($val->attributes)); } } $res[$key] = $val; } return $res; } /** * Generates configuration in NEON format. */ public function dump(array $data) : string { \array_walk_recursive($data, function (&$val) : void { if ($val instanceof Statement) { $val = self::statementToEntity($val); } }); return "# generated by Nette\n\n" . Neon\Neon::encode($data, Neon\Neon::BLOCK); } private static function statementToEntity(Statement $val) : Neon\Entity { \array_walk_recursive($val->arguments, function (&$val) : void { if ($val instanceof Statement) { $val = self::statementToEntity($val); } elseif ($val instanceof Reference) { $val = '@' . $val->getValue(); } }); $entity = $val->getEntity(); if ($entity instanceof Reference) { $entity = '@' . $entity->getValue(); } elseif (\is_array($entity)) { if ($entity[0] instanceof Statement) { return new Neon\Entity(Neon\Neon::CHAIN, [self::statementToEntity($entity[0]), new Neon\Entity('::' . $entity[1], $val->arguments)]); } elseif ($entity[0] instanceof Reference) { $entity = '@' . $entity[0]->getValue() . '::' . $entity[1]; } elseif (\is_string($entity[0])) { $entity = $entity[0] . '::' . $entity[1]; } } return new Neon\Entity($entity, $val->arguments); } /** @internal */ public function removeUnderscoreVisitor(Neon\Node $node) { if (!$node instanceof Neon\Node\EntityNode) { return; } $index = \false; foreach ($node->attributes as $i => $attr) { if ($index) { $attr->key = $attr->key ?? new Neon\Node\LiteralNode((string) $i); } if ($attr->value instanceof Neon\Node\LiteralNode && $attr->value->value === '_') { unset($node->attributes[$i]); $index = \true; } elseif ($attr->value instanceof Neon\Node\LiteralNode && $attr->value->value === '...') { \trigger_error("Replace ... with _ in configuration file '{$this->file}'.", \E_USER_DEPRECATED); unset($node->attributes[$i]); $index = \true; } } } /** @internal */ public function convertAtSignVisitor(Neon\Node $node) { if ($node instanceof Neon\Node\StringNode) { if (\substr($node->value, 0, 2) === '@@') { \trigger_error("There is no need to escape @ anymore, replace @@ with @ in: '{$node->value}' (used in {$this->file})", \E_USER_DEPRECATED); } else { $node->value = \preg_replace('#^@#', '$0$0', $node->value); // escape } } elseif ($node instanceof Neon\Node\LiteralNode && \is_string($node->value) && \substr($node->value, 0, 2) === '@@') { \trigger_error("There is no need to escape @ anymore, replace @@ with @ and put string in quotes: '{$node->value}' (used in {$this->file})", \E_USER_DEPRECATED); } } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\DI\Config; use _PHPStan_7d8742a37\Nette; /** * Configuration helpers. * @deprecated */ final class Helpers { use Nette\StaticClass; public const PREVENT_MERGING = '_prevent_merging'; /** @deprecated */ public static function merge($left, $right) { return Nette\Schema\Helpers::merge($left, $right); } /** @deprecated */ public static function takeParent(&$data) : bool { if (\is_array($data) && isset($data[self::PREVENT_MERGING])) { unset($data[self::PREVENT_MERGING]); return \true; } return \false; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\DI\Config; if (\false) { /** @deprecated use Nette\DI\Config\Adapter */ interface IAdapter { } } elseif (!\interface_exists(IAdapter::class)) { \class_alias(Adapter::class, IAdapter::class); } namespace _PHPStan_7d8742a37\Nette\DI; if (\false) { /** @deprecated use Nette\DI\Definitions\ServiceDefinition */ class ServiceDefinition { } } elseif (!\class_exists(ServiceDefinition::class)) { \class_alias(Definitions\ServiceDefinition::class, ServiceDefinition::class); } if (\false) { /** @deprecated use Nette\DI\Definitions\Statement */ class Statement { } } elseif (!\class_exists(Statement::class)) { \class_alias(Definitions\Statement::class, Statement::class); } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Bridges\DITracy; use _PHPStan_7d8742a37\Nette; use _PHPStan_7d8742a37\Nette\DI\Container; use _PHPStan_7d8742a37\Tracy; /** * Dependency injection container panel for Debugger Bar. */ class ContainerPanel implements Tracy\IBarPanel { use Nette\SmartObject; /** @var float|null */ public static $compilationTime; /** @var Nette\DI\Container */ private $container; /** @var float|null */ private $elapsedTime; public function __construct(Container $container) { $this->container = $container; $this->elapsedTime = self::$compilationTime ? \microtime(\true) - self::$compilationTime : null; } /** * Renders tab. */ public function getTab() : string { return Nette\Utils\Helpers::capture(function () { $elapsedTime = $this->elapsedTime; require __DIR__ . '/templates/ContainerPanel.tab.phtml'; }); } /** * Renders panel. */ public function getPanel() : string { $methods = (function () { return $this->methods; })->bindTo($this->container, Container::class)(); $services = []; foreach ($methods as $name => $foo) { $name = \lcfirst(\str_replace('__', '.', \substr($name, 13))); $services[$name] = $this->container->getServiceType($name); } \ksort($services, \SORT_NATURAL); $propertyTags = (function () { return $this->tags; })->bindTo($this->container, $this->container)(); $tags = []; foreach ($propertyTags as $tag => $tmp) { foreach ($tmp as $service => $val) { $tags[$service][$tag] = $val; } } return Nette\Utils\Helpers::capture(function () use($tags, $services) { $container = $this->container; $rc = new \ReflectionClass($this->container); $file = $rc->getFileName(); $instances = (function () { return $this->instances; })->bindTo($this->container, Container::class)(); $wiring = (function () { return $this->wiring; })->bindTo($this->container, $this->container)(); $parameters = $rc->getMethod('getStaticParameters')->getDeclaringClass()->getName() === Container::class ? null : $container->getParameters(); require __DIR__ . '/templates/ContainerPanel.panel.phtml'; }); } } <?php declare(strict_types=1); namespace Nette\Bridges\DITracy; ?> <span title="Nette DI Container"> <svg viewBox="0 0 2048 2048"><path fill="#ae7c21" d="m1675 690.55v-125c0-36-4-60-13-71-9-12-26-18-52-18s-43 6-52 17c-8 11-12 36-12 72v910.62c0 37 4 61 12 72 9 11 26 17 52 17s44-6 52-17c9-12 13-36 13-72v-207h243v165c0 86-4 148-12 187-8 38-21 70-39 96-20 28-45 48-77 59-31 11-87 16-170 16-96 0-161-5-196-16-34-11-63-31-86-59-21-26-36-59-45-97-9-39-14-101-14-186v-826.62c0-85 4-147 13-185s25-71 46-97c23-29 54-49 92-60s102-17 189-17c75 0 130 6 164 17s61 30 81 59c19 26 33 59 41 99 8 39 12 101 12 185v84zm-524 1086.6h-254v-1514.6h254zm-1025 0v-1514.6h316c127 0 212 27 257 81 44 53 66 159 66 316v721.62c0 157-22 263-66 317-44 53-130 80-257 80zm388-314v-884.62c0-35-4-58-13-70-9-11-26-17-53-17h-66v1058.6h66c26 0 44-6 53-17 9-12 14-35 14-70z"/> </svg><span class="tracy-label"><?= $elapsedTime ? sprintf('%0.1f ms', $elapsedTime * 1000) : '' ?></span> </span> <?php declare(strict_types=1); namespace Nette\Bridges\DITracy; use Nette; use Tracy\Dumper; use Tracy\Helpers; ?> <style class="tracy-debug"> #tracy-debug .nette-ContainerPanel table { width: 100%; white-space: nowrap; } #tracy-debug .nette-ContainerPanel .created { font-weight: bold; } #tracy-debug .nette-ContainerPanel .yes { color: green; font-weight: bold; } #tracy-debug .nette-ContainerPanel table pre { display: inline; background: transparent; padding: 0; word-break: normal; } </style> <h1>Nette DI Container</h1> <div class="tracy-inner nette-ContainerPanel"> <div class="tracy-inner-container"> <p>Source: <?= Helpers::editorLink($file) ?></p> <table class="tracy-sortable"> <thead> <tr> <th>Name</th> <th>Autowired</th> <th>Service</th> <th>Tags</th> </tr> </thead> <tbody> <?php foreach ($services as $name => $type): ?> <?php $name = (string) $name ?> <?php $autowired = in_array($name, array_merge($wiring[$type][0] ?? [], $wiring[$type][1] ?? []), true) ?> <tr> <td class="<?= isset($instances[$name]) ? 'created' : '' ?>"><?= is_numeric($name) ? "<small>$name</small>" : Helpers::escapeHtml($name) ?></td> <td class="<?= $autowired ? 'yes' : '' ?>"><?= $autowired ? 'yes' : (isset($wiring[$type]) ? 'no' : '?') ?></td> <td> <?php if (isset($instances[$name]) && !$instances[$name] instanceof Nette\DI\Container): ?> <?= Dumper::toHtml($instances[$name], [Dumper::COLLAPSE => true, Dumper::LIVE => true, Dumper::DEPTH => 5]); ?> <?php elseif (isset($instances[$name])): ?> <code><?= get_class($instances[$name]) ?></code> <?php elseif (is_string($type)): ?> <code><?= Helpers::escapeHtml($type) ?></code> <?php endif ?> </td> <td><?php if (isset($tags[$name])) { echo count($tags[$name]) === 1 ? Helpers::escapeHtml(key($tags[$name])) . ' = ' . Dumper::toHtml(current($tags[$name]), [Dumper::COLLAPSE => true]) : Dumper::toHtml($tags[$name], [Dumper::COLLAPSE => true]); } ?></td> </tr> <?php endforeach ?> </tbody> </table> <h2>Parameters</h2> <div class="nette-ContainerPanel-parameters"> <?= $parameters === null ? "<i>disabled via 'di › export › parameters'</i>" : Dumper::toHtml($parameters) ?> </div> </div> </div> This file was automatically generated by Composer Patches (https://github.com/cweagans/composer-patches) Patches applied to this directory: 0 Source: patches/DependencyChecker.patch <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Bootstrap\Extensions; use _PHPStan_7d8742a37\Nette; use _PHPStan_7d8742a37\Nette\Schema\Expect; /** * PHP directives definition. */ final class PhpExtension extends Nette\DI\CompilerExtension { public function getConfigSchema() : Nette\Schema\Schema { return Expect::arrayOf(Expect::scalar()->dynamic()); } public function loadConfiguration() { foreach ($this->getConfig() as $name => $value) { if ($value === null) { continue; } elseif ($name === 'include_path') { $this->initialization->addBody('set_include_path(?);', [\str_replace(';', \PATH_SEPARATOR, $value)]); } elseif ($name === 'ignore_user_abort') { $this->initialization->addBody('ignore_user_abort(?);', [$value]); } elseif ($name === 'max_execution_time') { $this->initialization->addBody('set_time_limit(?);', [$value]); } elseif ($name === 'date.timezone') { $this->initialization->addBody('date_default_timezone_set(?);', [$value]); } elseif (\function_exists('ini_set')) { $this->initialization->addBody('ini_set(?, (string) (?));', [$name, $value]); } elseif (\ini_get($name) !== (string) $value) { throw new Nette\NotSupportedException('Required function ini_set() is disabled.'); } } } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Bootstrap\Extensions; use _PHPStan_7d8742a37\Nette; /** * Constant definitions. */ final class ConstantsExtension extends Nette\DI\CompilerExtension { public function loadConfiguration() { foreach ($this->getConfig() as $name => $value) { $this->initialization->addBody('define(?, ?);', [$name, $value]); } } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Bootstrap; use _PHPStan_7d8742a37\Composer\Autoload\ClassLoader; use _PHPStan_7d8742a37\Latte; use _PHPStan_7d8742a37\Nette; use _PHPStan_7d8742a37\Nette\DI; use _PHPStan_7d8742a37\Tracy; /** * Initial system DI container generator. */ class Configurator { use Nette\SmartObject; public const CookieSecret = 'nette-debug'; /** @deprecated use Configurator::CookieSecret */ public const COOKIE_SECRET = self::CookieSecret; /** @var callable[] function (Configurator $sender, DI\Compiler $compiler); Occurs after the compiler is created */ public $onCompile = []; /** @var array */ public $defaultExtensions = ['application' => [Nette\Bridges\ApplicationDI\ApplicationExtension::class, ['%debugMode%', ['%appDir%'], '%tempDir%/cache/nette.application']], 'cache' => [Nette\Bridges\CacheDI\CacheExtension::class, ['%tempDir%']], 'constants' => Extensions\ConstantsExtension::class, 'database' => [Nette\Bridges\DatabaseDI\DatabaseExtension::class, ['%debugMode%']], 'decorator' => Nette\DI\Extensions\DecoratorExtension::class, 'di' => [Nette\DI\Extensions\DIExtension::class, ['%debugMode%']], 'extensions' => Nette\DI\Extensions\ExtensionsExtension::class, 'forms' => Nette\Bridges\FormsDI\FormsExtension::class, 'http' => [Nette\Bridges\HttpDI\HttpExtension::class, ['%consoleMode%']], 'inject' => Nette\DI\Extensions\InjectExtension::class, 'latte' => [Nette\Bridges\ApplicationDI\LatteExtension::class, ['%tempDir%/cache/latte', '%debugMode%']], 'mail' => Nette\Bridges\MailDI\MailExtension::class, 'php' => Extensions\PhpExtension::class, 'routing' => [Nette\Bridges\ApplicationDI\RoutingExtension::class, ['%debugMode%']], 'search' => [Nette\DI\Extensions\SearchExtension::class, ['%tempDir%/cache/nette.search']], 'security' => [Nette\Bridges\SecurityDI\SecurityExtension::class, ['%debugMode%']], 'session' => [Nette\Bridges\HttpDI\SessionExtension::class, ['%debugMode%', '%consoleMode%']], 'tracy' => [Tracy\Bridges\Nette\TracyExtension::class, ['%debugMode%', '%consoleMode%']]]; /** @var string[] of classes which shouldn't be autowired */ public $autowireExcludedClasses = [\ArrayAccess::class, \Countable::class, \IteratorAggregate::class, \stdClass::class, \Traversable::class]; /** @var array */ protected $staticParameters; /** @var array */ protected $dynamicParameters = []; /** @var array */ protected $services = []; /** @var array of string|array */ protected $configs = []; public function __construct() { $this->staticParameters = $this->getDefaultParameters(); } /** * Set parameter %debugMode%. * @param bool|string|array $value * @return static */ public function setDebugMode($value) { if (\is_string($value) || \is_array($value)) { $value = static::detectDebugMode($value); } elseif (!\is_bool($value)) { throw new Nette\InvalidArgumentException(\sprintf('Value must be either a string, array, or boolean, %s given.', \gettype($value))); } $this->staticParameters['debugMode'] = $value; $this->staticParameters['productionMode'] = !$this->staticParameters['debugMode']; // compatibility return $this; } public function isDebugMode() : bool { return $this->staticParameters['debugMode']; } /** * Sets path to temporary directory. * @return static */ public function setTempDirectory(string $path) { $this->staticParameters['tempDir'] = $path; return $this; } /** * Sets the default timezone. * @return static */ public function setTimeZone(string $timezone) { \date_default_timezone_set($timezone); @\ini_set('date.timezone', $timezone); // @ - function may be disabled return $this; } /** * Alias for addStaticParameters() * @return static */ public function addParameters(array $params) { return $this->addStaticParameters($params); } /** * Adds new static parameters. * @return static */ public function addStaticParameters(array $params) { $this->staticParameters = DI\Config\Helpers::merge($params, $this->staticParameters); return $this; } /** * Adds new dynamic parameters. * @return static */ public function addDynamicParameters(array $params) { $this->dynamicParameters = $params + $this->dynamicParameters; return $this; } /** * Add instances of services. * @return static */ public function addServices(array $services) { $this->services = $services + $this->services; return $this; } protected function getDefaultParameters() : array { $trace = \debug_backtrace(\DEBUG_BACKTRACE_IGNORE_ARGS); $last = \end($trace); $debugMode = static::detectDebugMode(); $loaderRc = \class_exists(ClassLoader::class) ? new \ReflectionClass(ClassLoader::class) : null; return ['appDir' => isset($trace[1]['file']) ? \dirname($trace[1]['file']) : null, 'wwwDir' => isset($last['file']) ? \dirname($last['file']) : null, 'vendorDir' => $loaderRc ? \dirname($loaderRc->getFileName(), 2) : null, 'debugMode' => $debugMode, 'productionMode' => !$debugMode, 'consoleMode' => \PHP_SAPI === 'cli']; } public function enableTracy(?string $logDirectory = null, ?string $email = null) : void { if (!\class_exists(Tracy\Debugger::class)) { throw new Nette\NotSupportedException('Tracy not found, do you have `tracy/tracy` package installed?'); } Tracy\Debugger::$strictMode = \true; Tracy\Debugger::enable(!$this->staticParameters['debugMode'], $logDirectory, $email); Tracy\Bridges\Nette\Bridge::initialize(); if (\class_exists(Latte\Bridges\Tracy\BlueScreenPanel::class)) { Latte\Bridges\Tracy\BlueScreenPanel::initialize(); } } /** * Alias for enableTracy() */ public function enableDebugger(?string $logDirectory = null, ?string $email = null) : void { $this->enableTracy($logDirectory, $email); } /** * @throws Nette\NotSupportedException if RobotLoader is not available */ public function createRobotLoader() : Nette\Loaders\RobotLoader { if (!\class_exists(Nette\Loaders\RobotLoader::class)) { throw new Nette\NotSupportedException('RobotLoader not found, do you have `nette/robot-loader` package installed?'); } $loader = new Nette\Loaders\RobotLoader(); $loader->setTempDirectory($this->getCacheDirectory() . '/nette.robotLoader'); $loader->setAutoRefresh($this->staticParameters['debugMode']); if (isset($this->defaultExtensions['application'])) { $this->defaultExtensions['application'][1][1] = null; $this->defaultExtensions['application'][1][3] = $loader; } return $loader; } /** * Adds configuration file. * @param string|array $config * @return static */ public function addConfig($config) { $this->configs[] = $config; return $this; } /** * Returns system DI container. */ public function createContainer(bool $initialize = \true) : DI\Container { $class = $this->loadContainer(); $container = new $class($this->dynamicParameters); foreach ($this->services as $name => $service) { $container->addService($name, $service); } if ($initialize) { $container->initialize(); } return $container; } /** * Loads system DI container class and returns its name. */ public function loadContainer() : string { $loader = new DI\ContainerLoader($this->getCacheDirectory() . '/nette.configurator', $this->staticParameters['debugMode']); return $loader->load([$this, 'generateContainer'], $this->generateContainerKey()); } /** * @internal */ public function generateContainer(DI\Compiler $compiler) : void { $loader = $this->createLoader(); $loader->setParameters($this->staticParameters); foreach ($this->configs as $config) { if (\is_string($config)) { $compiler->loadConfig($config, $loader); } else { $compiler->addConfig($config); } } $compiler->addConfig(['parameters' => DI\Helpers::escape($this->staticParameters)]); $compiler->setDynamicParameterNames(\array_keys($this->dynamicParameters)); $builder = $compiler->getContainerBuilder(); $builder->addExcludedClasses($this->autowireExcludedClasses); foreach ($this->defaultExtensions as $name => $extension) { [$class, $args] = \is_string($extension) ? [$extension, []] : $extension; if (\class_exists($class)) { $args = DI\Helpers::expand($args, $this->staticParameters); $compiler->addExtension($name, (new \ReflectionClass($class))->newInstanceArgs($args)); } } Nette\Utils\Arrays::invoke($this->onCompile, $this, $compiler); } protected function createLoader() : DI\Config\Loader { return new DI\Config\Loader(); } protected function generateContainerKey() : array { return [ $this->staticParameters, \array_keys($this->dynamicParameters), $this->configs, \PHP_VERSION_ID - \PHP_RELEASE_VERSION, // minor PHP version \class_exists(ClassLoader::class) ? \filemtime((new \ReflectionClass(ClassLoader::class))->getFilename()) : null, ]; } protected function getCacheDirectory() : string { if (empty($this->staticParameters['tempDir'])) { throw new Nette\InvalidStateException('Set path to temporary directory using setTempDirectory().'); } $dir = $this->staticParameters['tempDir'] . '/cache'; Nette\Utils\FileSystem::createDir($dir); return $dir; } /********************* tools ****************d*g**/ /** * Detects debug mode by IP addresses or computer names whitelist detection. * @param string|array $list */ public static function detectDebugMode($list = null) : bool { $addr = $_SERVER['REMOTE_ADDR'] ?? \php_uname('n'); $secret = \is_string($_COOKIE[self::CookieSecret] ?? null) ? $_COOKIE[self::CookieSecret] : null; $list = \is_string($list) ? \preg_split('#[,\\s]+#', $list) : (array) $list; if (!isset($_SERVER['HTTP_X_FORWARDED_FOR']) && !isset($_SERVER['HTTP_FORWARDED'])) { $list[] = '127.0.0.1'; $list[] = '::1'; $list[] = '[::1]'; // workaround for PHP < 7.3.4 } return \in_array($addr, $list, \true) || \in_array("{$secret}@{$addr}", $list, \true); } } \class_exists(Nette\Configurator::class); <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette; if (\false) { /** alias for Nette\Bootstrap\Configurator */ class Configurator extends Bootstrap\Configurator { } } elseif (!\class_exists(Configurator::class)) { \class_alias(Bootstrap\Configurator::class, Configurator::class); } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Utils; use _PHPStan_7d8742a37\Nette; use RecursiveDirectoryIterator; use RecursiveIteratorIterator; /** * Finder allows searching through directory trees using iterator. * * <code> * Finder::findFiles('*.php') * ->size('> 10kB') * ->from('.') * ->exclude('temp'); * </code> * * @implements \IteratorAggregate<string, \SplFileInfo> */ class Finder implements \IteratorAggregate, \Countable { use Nette\SmartObject; /** @var callable[] extension methods */ private static $extMethods = []; /** @var array */ private $paths = []; /** @var array of filters */ private $groups = []; /** @var array filter for recursive traversing */ private $exclude = []; /** @var int */ private $order = RecursiveIteratorIterator::SELF_FIRST; /** @var int */ private $maxDepth = -1; /** @var array */ private $cursor; /** * Begins search for files and directories matching mask. * @param string ...$masks * @return static */ public static function find(...$masks) : self { $masks = \is_array($tmp = \reset($masks)) ? $tmp : $masks; return (new static())->select($masks, 'isDir')->select($masks, 'isFile'); } /** * Begins search for files matching mask. * @param string ...$masks * @return static */ public static function findFiles(...$masks) : self { $masks = \is_array($tmp = \reset($masks)) ? $tmp : $masks; return (new static())->select($masks, 'isFile'); } /** * Begins search for directories matching mask. * @param string ...$masks * @return static */ public static function findDirectories(...$masks) : self { $masks = \is_array($tmp = \reset($masks)) ? $tmp : $masks; return (new static())->select($masks, 'isDir'); } /** * Creates filtering group by mask & type selector. * @return static */ private function select(array $masks, string $type) : self { $this->cursor =& $this->groups[]; $pattern = self::buildPattern($masks); $this->filter(function (RecursiveDirectoryIterator $file) use($type, $pattern) : bool { return !$file->isDot() && $file->{$type}() && (!$pattern || \preg_match($pattern, '/' . \strtr($file->getSubPathName(), '\\', '/'))); }); return $this; } /** * Searches in the given folder(s). * @param string ...$paths * @return static */ public function in(...$paths) : self { $this->maxDepth = 0; return $this->from(...$paths); } /** * Searches recursively from the given folder(s). * @param string ...$paths * @return static */ public function from(...$paths) : self { if ($this->paths) { throw new Nette\InvalidStateException('Directory to search has already been specified.'); } $this->paths = \is_array($tmp = \reset($paths)) ? $tmp : $paths; $this->cursor =& $this->exclude; return $this; } /** * Shows folder content prior to the folder. * @return static */ public function childFirst() : self { $this->order = RecursiveIteratorIterator::CHILD_FIRST; return $this; } /** * Converts Finder pattern to regular expression. */ private static function buildPattern(array $masks) : ?string { $pattern = []; foreach ($masks as $mask) { $mask = \rtrim(\strtr($mask, '\\', '/'), '/'); $prefix = ''; if ($mask === '') { continue; } elseif ($mask === '*') { return null; } elseif ($mask[0] === '/') { // absolute fixing $mask = \ltrim($mask, '/'); $prefix = '(?<=^/)'; } $pattern[] = $prefix . \strtr(\preg_quote($mask, '#'), ['\\*\\*' => '.*', '\\*' => '[^/]*', '\\?' => '[^/]', '\\[\\!' => '[^', '\\[' => '[', '\\]' => ']', '\\-' => '-']); } return $pattern ? '#/(' . \implode('|', $pattern) . ')$#Di' : null; } /********************* iterator generator ****************d*g**/ /** @deprecated */ public function count() : int { \trigger_error('Nette\\Utils\\Finder::count is deprecated.', \E_USER_DEPRECATED); return \iterator_count($this->getIterator()); } /** * Returns iterator. */ public function getIterator() : \Iterator { if (!$this->paths) { throw new Nette\InvalidStateException('Call in() or from() to specify directory to search.'); } elseif (\count($this->paths) === 1) { return $this->buildIterator((string) $this->paths[0]); } $iterator = new \AppendIterator(); foreach ($this->paths as $path) { $iterator->append($this->buildIterator((string) $path)); } return $iterator; } /** * Returns per-path iterator. */ private function buildIterator(string $path) : \Iterator { $iterator = new RecursiveDirectoryIterator($path, RecursiveDirectoryIterator::FOLLOW_SYMLINKS); if ($this->exclude) { $iterator = new \RecursiveCallbackFilterIterator($iterator, function ($foo, $bar, RecursiveDirectoryIterator $file) : bool { if (!$file->isDot() && !$file->isFile()) { foreach ($this->exclude as $filter) { if (!$filter($file)) { return \false; } } } return \true; }); } if ($this->maxDepth !== 0) { $iterator = new RecursiveIteratorIterator($iterator, $this->order); $iterator->setMaxDepth($this->maxDepth); } $iterator = new \CallbackFilterIterator($iterator, function ($foo, $bar, \Iterator $file) : bool { while ($file instanceof \OuterIterator) { $file = $file->getInnerIterator(); } foreach ($this->groups as $filters) { foreach ($filters as $filter) { if (!$filter($file)) { continue 2; } } return \true; } return \false; }); return $iterator; } /********************* filtering ****************d*g**/ /** * Restricts the search using mask. * Excludes directories from recursive traversing. * @param string ...$masks * @return static */ public function exclude(...$masks) : self { $masks = \is_array($tmp = \reset($masks)) ? $tmp : $masks; $pattern = self::buildPattern($masks); if ($pattern) { $this->filter(function (RecursiveDirectoryIterator $file) use($pattern) : bool { return !\preg_match($pattern, '/' . \strtr($file->getSubPathName(), '\\', '/')); }); } return $this; } /** * Restricts the search using callback. * @param callable(RecursiveDirectoryIterator): bool $callback * @return static */ public function filter(callable $callback) : self { $this->cursor[] = $callback; return $this; } /** * Limits recursion level. * @return static */ public function limitDepth(int $depth) : self { $this->maxDepth = $depth; return $this; } /** * Restricts the search by size. * @param string $operator "[operator] [size] [unit]" example: >=10kB * @return static */ public function size(string $operator, ?int $size = null) : self { if (\func_num_args() === 1) { // in $operator is predicate if (!\preg_match('#^(?:([=<>!]=?|<>)\\s*)?((?:\\d*\\.)?\\d+)\\s*(K|M|G|)B?$#Di', $operator, $matches)) { throw new Nette\InvalidArgumentException('Invalid size predicate format.'); } [, $operator, $size, $unit] = $matches; static $units = ['' => 1, 'k' => 1000.0, 'm' => 1000000.0, 'g' => 1000000000.0]; $size *= $units[\strtolower($unit)]; $operator = $operator ?: '='; } return $this->filter(function (RecursiveDirectoryIterator $file) use($operator, $size) : bool { return self::compare($file->getSize(), $operator, $size); }); } /** * Restricts the search by modified time. * @param string $operator "[operator] [date]" example: >1978-01-23 * @param string|int|\DateTimeInterface $date * @return static */ public function date(string $operator, $date = null) : self { if (\func_num_args() === 1) { // in $operator is predicate if (!\preg_match('#^(?:([=<>!]=?|<>)\\s*)?(.+)$#Di', $operator, $matches)) { throw new Nette\InvalidArgumentException('Invalid date predicate format.'); } [, $operator, $date] = $matches; $operator = $operator ?: '='; } $date = DateTime::from($date)->format('U'); return $this->filter(function (RecursiveDirectoryIterator $file) use($operator, $date) : bool { return self::compare($file->getMTime(), $operator, $date); }); } /** * Compares two values. */ public static function compare($l, string $operator, $r) : bool { switch ($operator) { case '>': return $l > $r; case '>=': return $l >= $r; case '<': return $l < $r; case '<=': return $l <= $r; case '=': case '==': return $l == $r; case '!': case '!=': case '<>': return $l != $r; default: throw new Nette\InvalidArgumentException("Unknown operator {$operator}."); } } /********************* extension methods ****************d*g**/ /** @deprecated */ public function __call(string $name, array $args) { return isset(self::$extMethods[$name]) ? self::$extMethods[$name]($this, ...$args) : Nette\Utils\ObjectHelpers::strictCall(static::class, $name, \array_keys(self::$extMethods)); } /** @deprecated */ public static function extensionMethod(string $name, callable $callback) : void { \trigger_error(__METHOD__ . '() is deprecated.', \E_USER_DEPRECATED); self::$extMethods[$name] = $callback; } } <?xml version="1.0"?> <ruleset name="Custom" namespace="Nette"> <rule ref="$presets/php72.xml"/> <!-- bug in SlevomatCodingStandard --> <rule ref="SlevomatCodingStandard.Operators.RequireCombinedAssignmentOperator"> <severity>0</severity> </rule> <!-- bug in FunctionSpacingSniff --> <exclude-pattern>./tests/Utils/Reflection.getDeclaringMethod.alias.phpt</exclude-pattern> <exclude-pattern>./tests/Utils/Reflection.getDeclaringMethod.insteadof.phpt</exclude-pattern> </ruleset> <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette; use _PHPStan_7d8742a37\Nette\Utils\ObjectHelpers; /** * Strict class for better experience. * - 'did you mean' hints * - access to undeclared members throws exceptions * - support for @property annotations * - support for calling event handlers stored in $onEvent via onEvent() */ trait SmartObject { /** * @throws MemberAccessException */ public function __call(string $name, array $args) { $class = static::class; if (ObjectHelpers::hasProperty($class, $name) === 'event') { // calling event handlers $handlers = $this->{$name} ?? null; if (\is_iterable($handlers)) { foreach ($handlers as $handler) { $handler(...$args); } } elseif ($handlers !== null) { throw new UnexpectedValueException("Property {$class}::\${$name} must be iterable or null, " . \gettype($handlers) . ' given.'); } } else { ObjectHelpers::strictCall($class, $name); } } /** * @throws MemberAccessException */ public static function __callStatic(string $name, array $args) { ObjectHelpers::strictStaticCall(static::class, $name); } /** * @return mixed * @throws MemberAccessException if the property is not defined. */ public function &__get(string $name) { $class = static::class; if ($prop = ObjectHelpers::getMagicProperties($class)[$name] ?? null) { // property getter if (!($prop & 0b1)) { throw new MemberAccessException("Cannot read a write-only property {$class}::\${$name}."); } $m = ($prop & 0b10 ? 'get' : 'is') . \ucfirst($name); if ($prop & 0b10000) { $trace = \debug_backtrace(0, 1)[0]; // suppose this method is called from __call() $loc = isset($trace['file'], $trace['line']) ? " in {$trace['file']} on line {$trace['line']}" : ''; \trigger_error("Property {$class}::\${$name} is deprecated, use {$class}::{$m}() method{$loc}.", \E_USER_DEPRECATED); } if ($prop & 0b100) { // return by reference return $this->{$m}(); } else { $val = $this->{$m}(); return $val; } } else { ObjectHelpers::strictGet($class, $name); } } /** * @param mixed $value * @return void * @throws MemberAccessException if the property is not defined or is read-only */ public function __set(string $name, $value) { $class = static::class; if (ObjectHelpers::hasProperty($class, $name)) { // unsetted property $this->{$name} = $value; } elseif ($prop = ObjectHelpers::getMagicProperties($class)[$name] ?? null) { // property setter if (!($prop & 0b1000)) { throw new MemberAccessException("Cannot write to a read-only property {$class}::\${$name}."); } $m = 'set' . \ucfirst($name); if ($prop & 0b10000) { $trace = \debug_backtrace(0, 1)[0]; // suppose this method is called from __call() $loc = isset($trace['file'], $trace['line']) ? " in {$trace['file']} on line {$trace['line']}" : ''; \trigger_error("Property {$class}::\${$name} is deprecated, use {$class}::{$m}() method{$loc}.", \E_USER_DEPRECATED); } $this->{$m}($value); } else { ObjectHelpers::strictSet($class, $name); } } /** * @return void * @throws MemberAccessException */ public function __unset(string $name) { $class = static::class; if (!ObjectHelpers::hasProperty($class, $name)) { throw new MemberAccessException("Cannot unset the property {$class}::\${$name}."); } } public function __isset(string $name) : bool { return isset(ObjectHelpers::getMagicProperties(static::class)[$name]); } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Utils; use _PHPStan_7d8742a37\Nette; /** * PHP type reflection. */ final class Type { /** @var array */ private $types; /** @var bool */ private $single; /** @var string |, & */ private $kind; /** * Creates a Type object based on reflection. Resolves self, static and parent to the actual class name. * If the subject has no type, it returns null. * @param \ReflectionFunctionAbstract|\ReflectionParameter|\ReflectionProperty $reflection */ public static function fromReflection($reflection) : ?self { if ($reflection instanceof \ReflectionProperty && \PHP_VERSION_ID < 70400) { return null; } elseif ($reflection instanceof \ReflectionMethod) { $type = $reflection->getReturnType() ?? (\PHP_VERSION_ID >= 80100 ? $reflection->getTentativeReturnType() : null); } else { $type = $reflection instanceof \ReflectionFunctionAbstract ? $reflection->getReturnType() : $reflection->getType(); } if ($type === null) { return null; } elseif ($type instanceof \ReflectionNamedType) { $name = self::resolve($type->getName(), $reflection); return new self($type->allowsNull() && $type->getName() !== 'mixed' ? [$name, 'null'] : [$name]); } elseif ($type instanceof \ReflectionUnionType || $type instanceof \ReflectionIntersectionType) { return new self(\array_map(function ($t) use($reflection) { return self::resolve($t->getName(), $reflection); }, $type->getTypes()), $type instanceof \ReflectionUnionType ? '|' : '&'); } else { throw new Nette\InvalidStateException('Unexpected type of ' . Reflection::toString($reflection)); } } /** * Creates the Type object according to the text notation. */ public static function fromString(string $type) : self { if (!\preg_match('#(?: \\?([\\w\\\\]+)| [\\w\\\\]+ (?: (&[\\w\\\\]+)* | (\\|[\\w\\\\]+)* ) )()$#xAD', $type, $m)) { throw new Nette\InvalidArgumentException("Invalid type '{$type}'."); } [, $nType, $iType] = $m; if ($nType) { return new self([$nType, 'null']); } elseif ($iType) { return new self(\explode('&', $type), '&'); } else { return new self(\explode('|', $type)); } } /** * Resolves 'self', 'static' and 'parent' to the actual class name. * @param \ReflectionFunctionAbstract|\ReflectionParameter|\ReflectionProperty $reflection */ public static function resolve(string $type, $reflection) : string { $lower = \strtolower($type); if ($reflection instanceof \ReflectionFunction) { return $type; } elseif ($lower === 'self' || $lower === 'static') { return $reflection->getDeclaringClass()->name; } elseif ($lower === 'parent' && $reflection->getDeclaringClass()->getParentClass()) { return $reflection->getDeclaringClass()->getParentClass()->name; } else { return $type; } } private function __construct(array $types, string $kind = '|') { if ($types[0] === 'null') { // null as last \array_push($types, \array_shift($types)); } $this->types = $types; $this->single = ($types[1] ?? 'null') === 'null'; $this->kind = \count($types) > 1 ? $kind : ''; } public function __toString() : string { return $this->single ? (\count($this->types) > 1 ? '?' : '') . $this->types[0] : \implode($this->kind, $this->types); } /** * Returns the array of subtypes that make up the compound type as strings. * @return string[] */ public function getNames() : array { return $this->types; } /** * Returns the array of subtypes that make up the compound type as Type objects: * @return self[] */ public function getTypes() : array { return \array_map(function ($name) { return self::fromString($name); }, $this->types); } /** * Returns the type name for single types, otherwise null. */ public function getSingleName() : ?string { return $this->single ? $this->types[0] : null; } /** * Returns true whether it is a union type. */ public function isUnion() : bool { return $this->kind === '|'; } /** * Returns true whether it is an intersection type. */ public function isIntersection() : bool { return $this->kind === '&'; } /** * Returns true whether it is a single type. Simple nullable types are also considered to be single types. */ public function isSingle() : bool { return $this->single; } /** * Returns true whether the type is both a single and a PHP built-in type. */ public function isBuiltin() : bool { return $this->single && Reflection::isBuiltinType($this->types[0]); } /** * Returns true whether the type is both a single and a class name. */ public function isClass() : bool { return $this->single && !Reflection::isBuiltinType($this->types[0]); } /** * Determines if type is special class name self/parent/static. */ public function isClassKeyword() : bool { return $this->single && Reflection::isClassKeyword($this->types[0]); } /** * Verifies type compatibility. For example, it checks if a value of a certain type could be passed as a parameter. */ public function allows(string $type) : bool { if ($this->types === ['mixed']) { return \true; } $type = self::fromString($type); if ($this->isIntersection()) { if (!$type->isIntersection()) { return \false; } return Arrays::every($this->types, function ($currentType) use($type) { $builtin = Reflection::isBuiltinType($currentType); return Arrays::some($type->types, function ($testedType) use($currentType, $builtin) { return $builtin ? \strcasecmp($currentType, $testedType) === 0 : \is_a($testedType, $currentType, \true); }); }); } $method = $type->isIntersection() ? 'some' : 'every'; return Arrays::$method($type->types, function ($testedType) { $builtin = Reflection::isBuiltinType($testedType); return Arrays::some($this->types, function ($currentType) use($testedType, $builtin) { return $builtin ? \strcasecmp($currentType, $testedType) === 0 : \is_a($testedType, $currentType, \true); }); }); } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Utils; use _PHPStan_7d8742a37\Nette; /** * Secure random string generator. */ final class Random { use Nette\StaticClass; /** * Generates a random string of given length from characters specified in second argument. * Supports intervals, such as `0-9` or `A-Z`. */ public static function generate(int $length = 10, string $charlist = '0-9a-z') : string { $charlist = \count_chars(\preg_replace_callback('#.-.#', function (array $m) : string { return \implode('', \range($m[0][0], $m[0][2])); }, $charlist), 3); $chLen = \strlen($charlist); if ($length < 1) { throw new Nette\InvalidArgumentException('Length must be greater than zero.'); } elseif ($chLen < 2) { throw new Nette\InvalidArgumentException('Character list must contain at least two chars.'); } $res = ''; for ($i = 0; $i < $length; $i++) { $res .= $charlist[\random_int(0, $chLen - 1)]; } return $res; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Utils; use _PHPStan_7d8742a37\Nette; /** * PHP reflection helpers. */ final class Reflection { use Nette\StaticClass; private const BUILTIN_TYPES = ['string' => 1, 'int' => 1, 'float' => 1, 'bool' => 1, 'array' => 1, 'object' => 1, 'callable' => 1, 'iterable' => 1, 'void' => 1, 'null' => 1, 'mixed' => 1, 'false' => 1, 'never' => 1]; private const CLASS_KEYWORDS = ['self' => 1, 'parent' => 1, 'static' => 1]; /** * Determines if type is PHP built-in type. Otherwise, it is the class name. */ public static function isBuiltinType(string $type) : bool { return isset(self::BUILTIN_TYPES[\strtolower($type)]); } /** * Determines if type is special class name self/parent/static. */ public static function isClassKeyword(string $name) : bool { return isset(self::CLASS_KEYWORDS[\strtolower($name)]); } /** * Returns the type of return value of given function or method and normalizes `self`, `static`, and `parent` to actual class names. * If the function does not have a return type, it returns null. * If the function has union or intersection type, it throws Nette\InvalidStateException. */ public static function getReturnType(\ReflectionFunctionAbstract $func) : ?string { $type = $func->getReturnType() ?? (\PHP_VERSION_ID >= 80100 && $func instanceof \ReflectionMethod ? $func->getTentativeReturnType() : null); return self::getType($func, $type); } /** * @deprecated */ public static function getReturnTypes(\ReflectionFunctionAbstract $func) : array { $type = Type::fromReflection($func); return $type ? $type->getNames() : []; } /** * Returns the type of given parameter and normalizes `self` and `parent` to the actual class names. * If the parameter does not have a type, it returns null. * If the parameter has union or intersection type, it throws Nette\InvalidStateException. */ public static function getParameterType(\ReflectionParameter $param) : ?string { return self::getType($param, $param->getType()); } /** * @deprecated */ public static function getParameterTypes(\ReflectionParameter $param) : array { $type = Type::fromReflection($param); return $type ? $type->getNames() : []; } /** * Returns the type of given property and normalizes `self` and `parent` to the actual class names. * If the property does not have a type, it returns null. * If the property has union or intersection type, it throws Nette\InvalidStateException. */ public static function getPropertyType(\ReflectionProperty $prop) : ?string { return self::getType($prop, \PHP_VERSION_ID >= 70400 ? $prop->getType() : null); } /** * @deprecated */ public static function getPropertyTypes(\ReflectionProperty $prop) : array { $type = Type::fromReflection($prop); return $type ? $type->getNames() : []; } /** * @param \ReflectionFunction|\ReflectionMethod|\ReflectionParameter|\ReflectionProperty $reflection */ private static function getType($reflection, ?\ReflectionType $type) : ?string { if ($type === null) { return null; } elseif ($type instanceof \ReflectionNamedType) { return Type::resolve($type->getName(), $reflection); } elseif ($type instanceof \ReflectionUnionType || $type instanceof \ReflectionIntersectionType) { throw new Nette\InvalidStateException('The ' . self::toString($reflection) . ' is not expected to have a union or intersection type.'); } else { throw new Nette\InvalidStateException('Unexpected type of ' . self::toString($reflection)); } } /** * Returns the default value of parameter. If it is a constant, it returns its value. * @return mixed * @throws \ReflectionException If the parameter does not have a default value or the constant cannot be resolved */ public static function getParameterDefaultValue(\ReflectionParameter $param) { if ($param->isDefaultValueConstant()) { $const = $orig = $param->getDefaultValueConstantName(); $pair = \explode('::', $const); if (isset($pair[1])) { $pair[0] = Type::resolve($pair[0], $param); try { $rcc = new \ReflectionClassConstant($pair[0], $pair[1]); } catch (\ReflectionException $e) { $name = self::toString($param); throw new \ReflectionException("Unable to resolve constant {$orig} used as default value of {$name}.", 0, $e); } return $rcc->getValue(); } elseif (!\defined($const)) { $const = \substr((string) \strrchr($const, '\\'), 1); if (!\defined($const)) { $name = self::toString($param); throw new \ReflectionException("Unable to resolve constant {$orig} used as default value of {$name}."); } } return \constant($const); } return $param->getDefaultValue(); } /** * Returns a reflection of a class or trait that contains a declaration of given property. Property can also be declared in the trait. */ public static function getPropertyDeclaringClass(\ReflectionProperty $prop) : \ReflectionClass { foreach ($prop->getDeclaringClass()->getTraits() as $trait) { if ($trait->hasProperty($prop->name) && $trait->getProperty($prop->name)->getDocComment() === $prop->getDocComment()) { return self::getPropertyDeclaringClass($trait->getProperty($prop->name)); } } return $prop->getDeclaringClass(); } /** * Returns a reflection of a method that contains a declaration of $method. * Usually, each method is its own declaration, but the body of the method can also be in the trait and under a different name. */ public static function getMethodDeclaringMethod(\ReflectionMethod $method) : \ReflectionMethod { // file & line guessing as workaround for insufficient PHP reflection $decl = $method->getDeclaringClass(); if ($decl->getFileName() === $method->getFileName() && $decl->getStartLine() <= $method->getStartLine() && $decl->getEndLine() >= $method->getEndLine()) { return $method; } $hash = [$method->getFileName(), $method->getStartLine(), $method->getEndLine()]; if (($alias = $decl->getTraitAliases()[$method->name] ?? null) && ($m = new \ReflectionMethod($alias)) && $hash === [$m->getFileName(), $m->getStartLine(), $m->getEndLine()]) { return self::getMethodDeclaringMethod($m); } foreach ($decl->getTraits() as $trait) { if ($trait->hasMethod($method->name) && ($m = $trait->getMethod($method->name)) && $hash === [$m->getFileName(), $m->getStartLine(), $m->getEndLine()]) { return self::getMethodDeclaringMethod($m); } } return $method; } /** * Finds out if reflection has access to PHPdoc comments. Comments may not be available due to the opcode cache. */ public static function areCommentsAvailable() : bool { static $res; return $res ?? ($res = (bool) (new \ReflectionMethod(__METHOD__))->getDocComment()); } public static function toString(\Reflector $ref) : string { if ($ref instanceof \ReflectionClass) { return $ref->name; } elseif ($ref instanceof \ReflectionMethod) { return $ref->getDeclaringClass()->name . '::' . $ref->name . '()'; } elseif ($ref instanceof \ReflectionFunction) { return $ref->name . '()'; } elseif ($ref instanceof \ReflectionProperty) { return self::getPropertyDeclaringClass($ref)->name . '::$' . $ref->name; } elseif ($ref instanceof \ReflectionParameter) { return '$' . $ref->name . ' in ' . self::toString($ref->getDeclaringFunction()); } else { throw new Nette\InvalidArgumentException(); } } /** * Expands the name of the class to full name in the given context of given class. * Thus, it returns how the PHP parser would understand $name if it were written in the body of the class $context. * @throws Nette\InvalidArgumentException */ public static function expandClassName(string $name, \ReflectionClass $context) : string { $lower = \strtolower($name); if (empty($name)) { throw new Nette\InvalidArgumentException('Class name must not be empty.'); } elseif (isset(self::BUILTIN_TYPES[$lower])) { return $lower; } elseif ($lower === 'self' || $lower === 'static') { return $context->name; } elseif ($lower === 'parent') { return $context->getParentClass() ? $context->getParentClass()->name : 'parent'; } elseif ($name[0] === '\\') { // fully qualified name return \ltrim($name, '\\'); } $uses = self::getUseStatements($context); $parts = \explode('\\', $name, 2); if (isset($uses[$parts[0]])) { $parts[0] = $uses[$parts[0]]; return \implode('\\', $parts); } elseif ($context->inNamespace()) { return $context->getNamespaceName() . '\\' . $name; } else { return $name; } } /** @return array of [alias => class] */ public static function getUseStatements(\ReflectionClass $class) : array { if ($class->isAnonymous()) { throw new Nette\NotImplementedException('Anonymous classes are not supported.'); } static $cache = []; if (!isset($cache[$name = $class->name])) { if ($class->isInternal()) { $cache[$name] = []; } else { $code = \file_get_contents($class->getFileName()); $cache = self::parseUseStatements($code, $name) + $cache; } } return $cache[$name]; } /** * Parses PHP code to [class => [alias => class, ...]] */ private static function parseUseStatements(string $code, ?string $forClass = null) : array { try { $tokens = \token_get_all($code, \TOKEN_PARSE); } catch (\ParseError $e) { \trigger_error($e->getMessage(), \E_USER_NOTICE); $tokens = []; } $namespace = $class = $classLevel = $level = null; $res = $uses = []; $nameTokens = \PHP_VERSION_ID < 80000 ? [\T_STRING, \T_NS_SEPARATOR] : [\T_STRING, \T_NS_SEPARATOR, \T_NAME_QUALIFIED, \T_NAME_FULLY_QUALIFIED]; while ($token = \current($tokens)) { \next($tokens); switch (\is_array($token) ? $token[0] : $token) { case \T_NAMESPACE: $namespace = \ltrim(self::fetch($tokens, $nameTokens) . '\\', '\\'); $uses = []; break; case \T_CLASS: case \T_INTERFACE: case \T_TRAIT: case \PHP_VERSION_ID < 80100 ? \T_CLASS : \T_ENUM: if ($name = self::fetch($tokens, \T_STRING)) { $class = $namespace . $name; $classLevel = $level + 1; $res[$class] = $uses; if ($class === $forClass) { return $res; } } break; case \T_USE: while (!$class && ($name = self::fetch($tokens, $nameTokens))) { $name = \ltrim($name, '\\'); if (self::fetch($tokens, '{')) { while ($suffix = self::fetch($tokens, $nameTokens)) { if (self::fetch($tokens, \T_AS)) { $uses[self::fetch($tokens, \T_STRING)] = $name . $suffix; } else { $tmp = \explode('\\', $suffix); $uses[\end($tmp)] = $name . $suffix; } if (!self::fetch($tokens, ',')) { break; } } } elseif (self::fetch($tokens, \T_AS)) { $uses[self::fetch($tokens, \T_STRING)] = $name; } else { $tmp = \explode('\\', $name); $uses[\end($tmp)] = $name; } if (!self::fetch($tokens, ',')) { break; } } break; case \T_CURLY_OPEN: case \T_DOLLAR_OPEN_CURLY_BRACES: case '{': $level++; break; case '}': if ($level === $classLevel) { $class = $classLevel = null; } $level--; } } return $res; } private static function fetch(array &$tokens, $take) : ?string { $res = null; while ($token = \current($tokens)) { [$token, $s] = \is_array($token) ? $token : [$token, $token]; if (\in_array($token, (array) $take, \true)) { $res .= $s; } elseif (!\in_array($token, [\T_DOC_COMMENT, \T_WHITESPACE, \T_COMMENT], \true)) { break; } \next($tokens); } return $res; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Utils; use _PHPStan_7d8742a37\Nette; use function is_array, is_object, is_string; /** * PHP callable tools. */ final class Callback { use Nette\StaticClass; /** * @param string|object|callable $callable class, object, callable * @deprecated use Closure::fromCallable() */ public static function closure($callable, ?string $method = null) : \Closure { \trigger_error(__METHOD__ . '() is deprecated, use Closure::fromCallable().', \E_USER_DEPRECATED); try { return \Closure::fromCallable($method === null ? $callable : [$callable, $method]); } catch (\TypeError $e) { throw new Nette\InvalidArgumentException($e->getMessage()); } } /** * Invokes callback. * @return mixed * @deprecated */ public static function invoke($callable, ...$args) { \trigger_error(__METHOD__ . '() is deprecated, use native invoking.', \E_USER_DEPRECATED); self::check($callable); return $callable(...$args); } /** * Invokes callback with an array of parameters. * @return mixed * @deprecated */ public static function invokeArgs($callable, array $args = []) { \trigger_error(__METHOD__ . '() is deprecated, use native invoking.', \E_USER_DEPRECATED); self::check($callable); return $callable(...$args); } /** * Invokes internal PHP function with own error handler. * @return mixed */ public static function invokeSafe(string $function, array $args, callable $onError) { $prev = \set_error_handler(function ($severity, $message, $file) use($onError, &$prev, $function) : ?bool { if ($file === __FILE__) { $msg = \ini_get('html_errors') ? Html::htmlToText($message) : $message; $msg = \preg_replace("#^{$function}\\(.*?\\): #", '', $msg); if ($onError($msg, $severity) !== \false) { return null; } } return $prev ? $prev(...\func_get_args()) : \false; }); try { return $function(...$args); } finally { \restore_error_handler(); } } /** * Checks that $callable is valid PHP callback. Otherwise throws exception. If the $syntax is set to true, only verifies * that $callable has a valid structure to be used as a callback, but does not verify if the class or method actually exists. * @param mixed $callable * @return callable * @throws Nette\InvalidArgumentException */ public static function check($callable, bool $syntax = \false) { if (!\is_callable($callable, $syntax)) { throw new Nette\InvalidArgumentException($syntax ? 'Given value is not a callable type.' : \sprintf("Callback '%s' is not callable.", self::toString($callable))); } return $callable; } /** * Converts PHP callback to textual form. Class or method may not exists. * @param mixed $callable */ public static function toString($callable) : string { if ($callable instanceof \Closure) { $inner = self::unwrap($callable); return '{closure' . ($inner instanceof \Closure ? '}' : ' ' . self::toString($inner) . '}'); } elseif (is_string($callable) && $callable[0] === "\x00") { return '{lambda}'; } else { \is_callable(is_object($callable) ? [$callable, '__invoke'] : $callable, \true, $textual); return $textual; } } /** * Returns reflection for method or function used in PHP callback. * @param callable $callable type check is escalated to ReflectionException * @return \ReflectionMethod|\ReflectionFunction * @throws \ReflectionException if callback is not valid */ public static function toReflection($callable) : \ReflectionFunctionAbstract { if ($callable instanceof \Closure) { $callable = self::unwrap($callable); } if (is_string($callable) && \strpos($callable, '::')) { return new \ReflectionMethod($callable); } elseif (is_array($callable)) { return new \ReflectionMethod($callable[0], $callable[1]); } elseif (is_object($callable) && !$callable instanceof \Closure) { return new \ReflectionMethod($callable, '__invoke'); } else { return new \ReflectionFunction($callable); } } /** * Checks whether PHP callback is function or static method. */ public static function isStatic(callable $callable) : bool { return is_array($callable) ? is_string($callable[0]) : is_string($callable); } /** * Unwraps closure created by Closure::fromCallable(). * @return callable|array */ public static function unwrap(\Closure $closure) { $r = new \ReflectionFunction($closure); if (\substr($r->name, -1) === '}') { return $closure; } elseif ($obj = $r->getClosureThis()) { return [$obj, $r->name]; } elseif ($class = $r->getClosureScopeClass()) { return [$class->name, $r->name]; } else { return $r->name; } } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Utils; use _PHPStan_7d8742a37\Nette; use _PHPStan_7d8742a37\Nette\HtmlStringable; use function is_array, is_float, is_object, is_string; /** * HTML helper. * * @property string|null $accept * @property string|null $accesskey * @property string|null $action * @property string|null $align * @property string|null $allow * @property string|null $alt * @property bool|null $async * @property string|null $autocapitalize * @property string|null $autocomplete * @property bool|null $autofocus * @property bool|null $autoplay * @property string|null $charset * @property bool|null $checked * @property string|null $cite * @property string|null $class * @property int|null $cols * @property int|null $colspan * @property string|null $content * @property bool|null $contenteditable * @property bool|null $controls * @property string|null $coords * @property string|null $crossorigin * @property string|null $data * @property string|null $datetime * @property string|null $decoding * @property bool|null $default * @property bool|null $defer * @property string|null $dir * @property string|null $dirname * @property bool|null $disabled * @property bool|null $download * @property string|null $draggable * @property string|null $dropzone * @property string|null $enctype * @property string|null $for * @property string|null $form * @property string|null $formaction * @property string|null $formenctype * @property string|null $formmethod * @property bool|null $formnovalidate * @property string|null $formtarget * @property string|null $headers * @property int|null $height * @property bool|null $hidden * @property float|null $high * @property string|null $href * @property string|null $hreflang * @property string|null $id * @property string|null $integrity * @property string|null $inputmode * @property bool|null $ismap * @property string|null $itemprop * @property string|null $kind * @property string|null $label * @property string|null $lang * @property string|null $list * @property bool|null $loop * @property float|null $low * @property float|null $max * @property int|null $maxlength * @property int|null $minlength * @property string|null $media * @property string|null $method * @property float|null $min * @property bool|null $multiple * @property bool|null $muted * @property string|null $name * @property bool|null $novalidate * @property bool|null $open * @property float|null $optimum * @property string|null $pattern * @property string|null $ping * @property string|null $placeholder * @property string|null $poster * @property string|null $preload * @property string|null $radiogroup * @property bool|null $readonly * @property string|null $rel * @property bool|null $required * @property bool|null $reversed * @property int|null $rows * @property int|null $rowspan * @property string|null $sandbox * @property string|null $scope * @property bool|null $selected * @property string|null $shape * @property int|null $size * @property string|null $sizes * @property string|null $slot * @property int|null $span * @property string|null $spellcheck * @property string|null $src * @property string|null $srcdoc * @property string|null $srclang * @property string|null $srcset * @property int|null $start * @property float|null $step * @property string|null $style * @property int|null $tabindex * @property string|null $target * @property string|null $title * @property string|null $translate * @property string|null $type * @property string|null $usemap * @property string|null $value * @property int|null $width * @property string|null $wrap * * @method self accept(?string $val) * @method self accesskey(?string $val, bool $state = null) * @method self action(?string $val) * @method self align(?string $val) * @method self allow(?string $val, bool $state = null) * @method self alt(?string $val) * @method self async(?bool $val) * @method self autocapitalize(?string $val) * @method self autocomplete(?string $val) * @method self autofocus(?bool $val) * @method self autoplay(?bool $val) * @method self charset(?string $val) * @method self checked(?bool $val) * @method self cite(?string $val) * @method self class(?string $val, bool $state = null) * @method self cols(?int $val) * @method self colspan(?int $val) * @method self content(?string $val) * @method self contenteditable(?bool $val) * @method self controls(?bool $val) * @method self coords(?string $val) * @method self crossorigin(?string $val) * @method self datetime(?string $val) * @method self decoding(?string $val) * @method self default(?bool $val) * @method self defer(?bool $val) * @method self dir(?string $val) * @method self dirname(?string $val) * @method self disabled(?bool $val) * @method self download(?bool $val) * @method self draggable(?string $val) * @method self dropzone(?string $val) * @method self enctype(?string $val) * @method self for(?string $val) * @method self form(?string $val) * @method self formaction(?string $val) * @method self formenctype(?string $val) * @method self formmethod(?string $val) * @method self formnovalidate(?bool $val) * @method self formtarget(?string $val) * @method self headers(?string $val, bool $state = null) * @method self height(?int $val) * @method self hidden(?bool $val) * @method self high(?float $val) * @method self hreflang(?string $val) * @method self id(?string $val) * @method self integrity(?string $val) * @method self inputmode(?string $val) * @method self ismap(?bool $val) * @method self itemprop(?string $val) * @method self kind(?string $val) * @method self label(?string $val) * @method self lang(?string $val) * @method self list(?string $val) * @method self loop(?bool $val) * @method self low(?float $val) * @method self max(?float $val) * @method self maxlength(?int $val) * @method self minlength(?int $val) * @method self media(?string $val) * @method self method(?string $val) * @method self min(?float $val) * @method self multiple(?bool $val) * @method self muted(?bool $val) * @method self name(?string $val) * @method self novalidate(?bool $val) * @method self open(?bool $val) * @method self optimum(?float $val) * @method self pattern(?string $val) * @method self ping(?string $val, bool $state = null) * @method self placeholder(?string $val) * @method self poster(?string $val) * @method self preload(?string $val) * @method self radiogroup(?string $val) * @method self readonly(?bool $val) * @method self rel(?string $val) * @method self required(?bool $val) * @method self reversed(?bool $val) * @method self rows(?int $val) * @method self rowspan(?int $val) * @method self sandbox(?string $val, bool $state = null) * @method self scope(?string $val) * @method self selected(?bool $val) * @method self shape(?string $val) * @method self size(?int $val) * @method self sizes(?string $val) * @method self slot(?string $val) * @method self span(?int $val) * @method self spellcheck(?string $val) * @method self src(?string $val) * @method self srcdoc(?string $val) * @method self srclang(?string $val) * @method self srcset(?string $val) * @method self start(?int $val) * @method self step(?float $val) * @method self style(?string $property, string $val = null) * @method self tabindex(?int $val) * @method self target(?string $val) * @method self title(?string $val) * @method self translate(?string $val) * @method self type(?string $val) * @method self usemap(?string $val) * @method self value(?string $val) * @method self width(?int $val) * @method self wrap(?string $val) */ class Html implements \ArrayAccess, \Countable, \IteratorAggregate, HtmlStringable { use Nette\SmartObject; /** @var array<string, mixed> element's attributes */ public $attrs = []; /** @var bool use XHTML syntax? */ public static $xhtml = \false; /** @var array<string, int> void elements */ public static $emptyElements = ['img' => 1, 'hr' => 1, 'br' => 1, 'input' => 1, 'meta' => 1, 'area' => 1, 'embed' => 1, 'keygen' => 1, 'source' => 1, 'base' => 1, 'col' => 1, 'link' => 1, 'param' => 1, 'basefont' => 1, 'frame' => 1, 'isindex' => 1, 'wbr' => 1, 'command' => 1, 'track' => 1]; /** @var array<int, HtmlStringable|string> nodes */ protected $children = []; /** @var string element's name */ private $name; /** @var bool is element empty? */ private $isEmpty; /** * Constructs new HTML element. * @param array|string $attrs element's attributes or plain text content * @return static */ public static function el(?string $name = null, $attrs = null) { $el = new static(); $parts = \explode(' ', (string) $name, 2); $el->setName($parts[0]); if (is_array($attrs)) { $el->attrs = $attrs; } elseif ($attrs !== null) { $el->setText($attrs); } if (isset($parts[1])) { foreach (Strings::matchAll($parts[1] . ' ', '#([a-z0-9:-]+)(?:=(["\'])?(.*?)(?(2)\\2|\\s))?#i') as $m) { $el->attrs[$m[1]] = $m[3] ?? \true; } } return $el; } /** * Returns an object representing HTML text. */ public static function fromHtml(string $html) : self { return (new static())->setHtml($html); } /** * Returns an object representing plain text. */ public static function fromText(string $text) : self { return (new static())->setText($text); } /** * Converts to HTML. */ public final function toHtml() : string { return $this->render(); } /** * Converts to plain text. */ public final function toText() : string { return $this->getText(); } /** * Converts given HTML code to plain text. */ public static function htmlToText(string $html) : string { return \html_entity_decode(\strip_tags($html), \ENT_QUOTES | \ENT_HTML5, 'UTF-8'); } /** * Changes element's name. * @return static */ public final function setName(string $name, ?bool $isEmpty = null) { $this->name = $name; $this->isEmpty = $isEmpty ?? isset(static::$emptyElements[$name]); return $this; } /** * Returns element's name. */ public final function getName() : string { return $this->name; } /** * Is element empty? */ public final function isEmpty() : bool { return $this->isEmpty; } /** * Sets multiple attributes. * @return static */ public function addAttributes(array $attrs) { $this->attrs = \array_merge($this->attrs, $attrs); return $this; } /** * Appends value to element's attribute. * @param mixed $value * @param mixed $option * @return static */ public function appendAttribute(string $name, $value, $option = \true) { if (is_array($value)) { $prev = isset($this->attrs[$name]) ? (array) $this->attrs[$name] : []; $this->attrs[$name] = $value + $prev; } elseif ((string) $value === '') { $tmp =& $this->attrs[$name]; // appending empty value? -> ignore, but ensure it exists } elseif (!isset($this->attrs[$name]) || is_array($this->attrs[$name])) { // needs array $this->attrs[$name][$value] = $option; } else { $this->attrs[$name] = [$this->attrs[$name] => \true, $value => $option]; } return $this; } /** * Sets element's attribute. * @param mixed $value * @return static */ public function setAttribute(string $name, $value) { $this->attrs[$name] = $value; return $this; } /** * Returns element's attribute. * @return mixed */ public function getAttribute(string $name) { return $this->attrs[$name] ?? null; } /** * Unsets element's attribute. * @return static */ public function removeAttribute(string $name) { unset($this->attrs[$name]); return $this; } /** * Unsets element's attributes. * @return static */ public function removeAttributes(array $attributes) { foreach ($attributes as $name) { unset($this->attrs[$name]); } return $this; } /** * Overloaded setter for element's attribute. * @param mixed $value */ public final function __set(string $name, $value) : void { $this->attrs[$name] = $value; } /** * Overloaded getter for element's attribute. * @return mixed */ public final function &__get(string $name) { return $this->attrs[$name]; } /** * Overloaded tester for element's attribute. */ public final function __isset(string $name) : bool { return isset($this->attrs[$name]); } /** * Overloaded unsetter for element's attribute. */ public final function __unset(string $name) : void { unset($this->attrs[$name]); } /** * Overloaded setter for element's attribute. * @return mixed */ public final function __call(string $m, array $args) { $p = \substr($m, 0, 3); if ($p === 'get' || $p === 'set' || $p === 'add') { $m = \substr($m, 3); $m[0] = $m[0] | " "; if ($p === 'get') { return $this->attrs[$m] ?? null; } elseif ($p === 'add') { $args[] = \true; } } if (\count($args) === 0) { // invalid } elseif (\count($args) === 1) { // set $this->attrs[$m] = $args[0]; } else { // add $this->appendAttribute($m, $args[0], $args[1]); } return $this; } /** * Special setter for element's attribute. * @return static */ public final function href(string $path, ?array $query = null) { if ($query) { $query = \http_build_query($query, '', '&'); if ($query !== '') { $path .= '?' . $query; } } $this->attrs['href'] = $path; return $this; } /** * Setter for data-* attributes. Booleans are converted to 'true' resp. 'false'. * @param mixed $value * @return static */ public function data(string $name, $value = null) { if (\func_num_args() === 1) { $this->attrs['data'] = $name; } else { $this->attrs["data-{$name}"] = \is_bool($value) ? \json_encode($value) : $value; } return $this; } /** * Sets element's HTML content. * @param HtmlStringable|string $html * @return static */ public final function setHtml($html) { $this->children = [(string) $html]; return $this; } /** * Returns element's HTML content. */ public final function getHtml() : string { return \implode('', $this->children); } /** * Sets element's textual content. * @param HtmlStringable|string|int|float $text * @return static */ public final function setText($text) { if (!$text instanceof HtmlStringable) { $text = \htmlspecialchars((string) $text, \ENT_NOQUOTES, 'UTF-8'); } $this->children = [(string) $text]; return $this; } /** * Returns element's textual content. */ public final function getText() : string { return self::htmlToText($this->getHtml()); } /** * Adds new element's child. * @param HtmlStringable|string $child Html node or raw HTML string * @return static */ public final function addHtml($child) { return $this->insert(null, $child); } /** * Appends plain-text string to element content. * @param HtmlStringable|string|int|float $text * @return static */ public function addText($text) { if (!$text instanceof HtmlStringable) { $text = \htmlspecialchars((string) $text, \ENT_NOQUOTES, 'UTF-8'); } return $this->insert(null, $text); } /** * Creates and adds a new Html child. * @param array|string $attrs element's attributes or raw HTML string * @return static created element */ public final function create(string $name, $attrs = null) { $this->insert(null, $child = static::el($name, $attrs)); return $child; } /** * Inserts child node. * @param HtmlStringable|string $child Html node or raw HTML string * @return static */ public function insert(?int $index, $child, bool $replace = \false) { $child = $child instanceof self ? $child : (string) $child; if ($index === null) { // append $this->children[] = $child; } else { // insert or replace \array_splice($this->children, $index, $replace ? 1 : 0, [$child]); } return $this; } /** * Inserts (replaces) child node (\ArrayAccess implementation). * @param int|null $index position or null for appending * @param Html|string $child Html node or raw HTML string */ public final function offsetSet($index, $child) : void { $this->insert($index, $child, \true); } /** * Returns child node (\ArrayAccess implementation). * @param int $index * @return HtmlStringable|string */ #[\ReturnTypeWillChange] public final function offsetGet($index) { return $this->children[$index]; } /** * Exists child node? (\ArrayAccess implementation). * @param int $index */ public final function offsetExists($index) : bool { return isset($this->children[$index]); } /** * Removes child node (\ArrayAccess implementation). * @param int $index */ public function offsetUnset($index) : void { if (isset($this->children[$index])) { \array_splice($this->children, $index, 1); } } /** * Returns children count. */ public final function count() : int { return \count($this->children); } /** * Removes all children. */ public function removeChildren() : void { $this->children = []; } /** * Iterates over elements. * @return \ArrayIterator<int, HtmlStringable|string> */ public final function getIterator() : \ArrayIterator { return new \ArrayIterator($this->children); } /** * Returns all children. */ public final function getChildren() : array { return $this->children; } /** * Renders element's start tag, content and end tag. */ public final function render(?int $indent = null) : string { $s = $this->startTag(); if (!$this->isEmpty) { // add content if ($indent !== null) { $indent++; } foreach ($this->children as $child) { if ($child instanceof self) { $s .= $child->render($indent); } else { $s .= $child; } } // add end tag $s .= $this->endTag(); } if ($indent !== null) { return "\n" . \str_repeat("\t", $indent - 1) . $s . "\n" . \str_repeat("\t", \max(0, $indent - 2)); } return $s; } public final function __toString() : string { try { return $this->render(); } catch (\Throwable $e) { if (\PHP_VERSION_ID >= 70400) { throw $e; } \trigger_error('Exception in ' . __METHOD__ . "(): {$e->getMessage()} in {$e->getFile()}:{$e->getLine()}", \E_USER_ERROR); return ''; } } /** * Returns element's start tag. */ public final function startTag() : string { return $this->name ? '<' . $this->name . $this->attributes() . (static::$xhtml && $this->isEmpty ? ' />' : '>') : ''; } /** * Returns element's end tag. */ public final function endTag() : string { return $this->name && !$this->isEmpty ? '</' . $this->name . '>' : ''; } /** * Returns element's attributes. * @internal */ public final function attributes() : string { if (!is_array($this->attrs)) { return ''; } $s = ''; $attrs = $this->attrs; foreach ($attrs as $key => $value) { if ($value === null || $value === \false) { continue; } elseif ($value === \true) { if (static::$xhtml) { $s .= ' ' . $key . '="' . $key . '"'; } else { $s .= ' ' . $key; } continue; } elseif (is_array($value)) { if (\strncmp($key, 'data-', 5) === 0) { $value = Json::encode($value); } else { $tmp = null; foreach ($value as $k => $v) { if ($v != null) { // intentionally ==, skip nulls & empty string // composite 'style' vs. 'others' $tmp[] = $v === \true ? $k : (is_string($k) ? $k . ':' . $v : $v); } } if ($tmp === null) { continue; } $value = \implode($key === 'style' || !\strncmp($key, 'on', 2) ? ';' : ' ', $tmp); } } elseif (is_float($value)) { $value = \rtrim(\rtrim(\number_format($value, 10, '.', ''), '0'), '.'); } else { $value = (string) $value; } $q = \strpos($value, '"') === \false ? '"' : "'"; $s .= ' ' . $key . '=' . $q . \str_replace(['&', $q, '<'], ['&', $q === '"' ? '"' : ''', self::$xhtml ? '<' : '<'], $value) . (\strpos($value, '`') !== \false && \strpbrk($value, ' <>"\'') === \false ? ' ' : '') . $q; } $s = \str_replace('@', '@', $s); return $s; } /** * Clones all children too. */ public function __clone() { foreach ($this->children as $key => $value) { if (is_object($value)) { $this->children[$key] = clone $value; } } } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Utils; /** * The exception that is thrown when an image error occurs. */ class ImageException extends \Exception { } /** * The exception that indicates invalid image file. */ class UnknownImageFileException extends ImageException { } /** * The exception that indicates error of JSON encoding/decoding. */ class JsonException extends \Exception { } /** * The exception that indicates error of the last Regexp execution. */ class RegexpException extends \Exception { public const MESSAGES = [\PREG_INTERNAL_ERROR => 'Internal error', \PREG_BACKTRACK_LIMIT_ERROR => 'Backtrack limit was exhausted', \PREG_RECURSION_LIMIT_ERROR => 'Recursion limit was exhausted', \PREG_BAD_UTF8_ERROR => 'Malformed UTF-8 data', \PREG_BAD_UTF8_OFFSET_ERROR => 'Offset didn\'t correspond to the begin of a valid UTF-8 code point', 6 => 'Failed due to limited JIT stack space']; } /** * The exception that indicates assertion error. */ class AssertionException extends \Exception { } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Utils; use _PHPStan_7d8742a37\Nette; /** * Nette\Object behaviour mixin. * @deprecated */ final class ObjectMixin { use Nette\StaticClass; /** @deprecated use ObjectHelpers::getSuggestion() */ public static function getSuggestion(array $possibilities, string $value) : ?string { \trigger_error(__METHOD__ . '() has been renamed to Nette\\Utils\\ObjectHelpers::getSuggestion()', \E_USER_DEPRECATED); return ObjectHelpers::getSuggestion($possibilities, $value); } public static function setExtensionMethod() : void { \trigger_error('Class Nette\\Utils\\ObjectMixin is deprecated', \E_USER_DEPRECATED); } public static function getExtensionMethod() : void { \trigger_error('Class Nette\\Utils\\ObjectMixin is deprecated', \E_USER_DEPRECATED); } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Utils; use _PHPStan_7d8742a37\Nette; /** * Provides objects to work as array. * @template T */ class ArrayHash extends \stdClass implements \ArrayAccess, \Countable, \IteratorAggregate { /** * Transforms array to ArrayHash. * @param array<T> $array * @return static */ public static function from(array $array, bool $recursive = \true) { $obj = new static(); foreach ($array as $key => $value) { $obj->{$key} = $recursive && \is_array($value) ? static::from($value, \true) : $value; } return $obj; } /** * Returns an iterator over all items. * @return \RecursiveArrayIterator<array-key, T> */ public function getIterator() : \RecursiveArrayIterator { return new \RecursiveArrayIterator((array) $this); } /** * Returns items count. */ public function count() : int { return \count((array) $this); } /** * Replaces or appends a item. * @param string|int $key * @param T $value */ public function offsetSet($key, $value) : void { if (!\is_scalar($key)) { // prevents null throw new Nette\InvalidArgumentException(\sprintf('Key must be either a string or an integer, %s given.', \gettype($key))); } $this->{$key} = $value; } /** * Returns a item. * @param string|int $key * @return T */ #[\ReturnTypeWillChange] public function offsetGet($key) { return $this->{$key}; } /** * Determines whether a item exists. * @param string|int $key */ public function offsetExists($key) : bool { return isset($this->{$key}); } /** * Removes the element from this list. * @param string|int $key */ public function offsetUnset($key) : void { unset($this->{$key}); } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Utils; use _PHPStan_7d8742a37\Nette; /** * Basic manipulation with images. Supported types are JPEG, PNG, GIF, WEBP, AVIF and BMP. * * <code> * $image = Image::fromFile('nette.jpg'); * $image->resize(150, 100); * $image->sharpen(); * $image->send(); * </code> * * @method Image affine(array $affine, array $clip = null) * @method array affineMatrixConcat(array $m1, array $m2) * @method array affineMatrixGet(int $type, mixed $options = null) * @method void alphaBlending(bool $on) * @method void antialias(bool $on) * @method void arc($x, $y, $w, $h, $start, $end, $color) * @method void char(int $font, $x, $y, string $char, $color) * @method void charUp(int $font, $x, $y, string $char, $color) * @method int colorAllocate($red, $green, $blue) * @method int colorAllocateAlpha($red, $green, $blue, $alpha) * @method int colorAt($x, $y) * @method int colorClosest($red, $green, $blue) * @method int colorClosestAlpha($red, $green, $blue, $alpha) * @method int colorClosestHWB($red, $green, $blue) * @method void colorDeallocate($color) * @method int colorExact($red, $green, $blue) * @method int colorExactAlpha($red, $green, $blue, $alpha) * @method void colorMatch(Image $image2) * @method int colorResolve($red, $green, $blue) * @method int colorResolveAlpha($red, $green, $blue, $alpha) * @method void colorSet($index, $red, $green, $blue) * @method array colorsForIndex($index) * @method int colorsTotal() * @method int colorTransparent($color = null) * @method void convolution(array $matrix, float $div, float $offset) * @method void copy(Image $src, $dstX, $dstY, $srcX, $srcY, $srcW, $srcH) * @method void copyMerge(Image $src, $dstX, $dstY, $srcX, $srcY, $srcW, $srcH, $opacity) * @method void copyMergeGray(Image $src, $dstX, $dstY, $srcX, $srcY, $srcW, $srcH, $opacity) * @method void copyResampled(Image $src, $dstX, $dstY, $srcX, $srcY, $dstW, $dstH, $srcW, $srcH) * @method void copyResized(Image $src, $dstX, $dstY, $srcX, $srcY, $dstW, $dstH, $srcW, $srcH) * @method Image cropAuto(int $mode = -1, float $threshold = .5, int $color = -1) * @method void ellipse($cx, $cy, $w, $h, $color) * @method void fill($x, $y, $color) * @method void filledArc($cx, $cy, $w, $h, $s, $e, $color, $style) * @method void filledEllipse($cx, $cy, $w, $h, $color) * @method void filledPolygon(array $points, $numPoints, $color) * @method void filledRectangle($x1, $y1, $x2, $y2, $color) * @method void fillToBorder($x, $y, $border, $color) * @method void filter($filtertype) * @method void flip(int $mode) * @method array ftText($size, $angle, $x, $y, $col, string $fontFile, string $text, array $extrainfo = null) * @method void gammaCorrect(float $inputgamma, float $outputgamma) * @method array getClip() * @method int interlace($interlace = null) * @method bool isTrueColor() * @method void layerEffect($effect) * @method void line($x1, $y1, $x2, $y2, $color) * @method void openPolygon(array $points, int $num_points, int $color) * @method void paletteCopy(Image $source) * @method void paletteToTrueColor() * @method void polygon(array $points, $numPoints, $color) * @method array psText(string $text, $font, $size, $color, $backgroundColor, $x, $y, $space = null, $tightness = null, float $angle = null, $antialiasSteps = null) * @method void rectangle($x1, $y1, $x2, $y2, $col) * @method mixed resolution(int $res_x = null, int $res_y = null) * @method Image rotate(float $angle, $backgroundColor) * @method void saveAlpha(bool $saveflag) * @method Image scale(int $newWidth, int $newHeight = -1, int $mode = IMG_BILINEAR_FIXED) * @method void setBrush(Image $brush) * @method void setClip(int $x1, int $y1, int $x2, int $y2) * @method void setInterpolation(int $method = IMG_BILINEAR_FIXED) * @method void setPixel($x, $y, $color) * @method void setStyle(array $style) * @method void setThickness($thickness) * @method void setTile(Image $tile) * @method void string($font, $x, $y, string $s, $col) * @method void stringUp($font, $x, $y, string $s, $col) * @method void trueColorToPalette(bool $dither, $ncolors) * @method array ttfText($size, $angle, $x, $y, $color, string $fontfile, string $text) * @property-read int $width * @property-read int $height * @property-read resource|\GdImage $imageResource */ class Image { use Nette\SmartObject; /** {@link resize()} only shrinks images */ public const SHRINK_ONLY = 0b1; /** {@link resize()} will ignore aspect ratio */ public const STRETCH = 0b10; /** {@link resize()} fits in given area so its dimensions are less than or equal to the required dimensions */ public const FIT = 0b0; /** {@link resize()} fills given area so its dimensions are greater than or equal to the required dimensions */ public const FILL = 0b100; /** {@link resize()} fills given area exactly */ public const EXACT = 0b1000; /** image types */ public const JPEG = \IMAGETYPE_JPEG, PNG = \IMAGETYPE_PNG, GIF = \IMAGETYPE_GIF, WEBP = \IMAGETYPE_WEBP, AVIF = 19, BMP = \IMAGETYPE_BMP; public const EMPTY_GIF = "GIF89a\x01\x00\x01\x00\x80\x00\x00\x00\x00\x00\x00\x00\x00!\xf9\x04\x01\x00\x00\x00\x00,\x00\x00\x00\x00\x01\x00\x01\x00\x00\x02\x02D\x01\x00;"; private const FORMATS = [self::JPEG => 'jpeg', self::PNG => 'png', self::GIF => 'gif', self::WEBP => 'webp', self::AVIF => 'avif', self::BMP => 'bmp']; /** @var resource|\GdImage */ private $image; /** * Returns RGB color (0..255) and transparency (0..127). */ public static function rgb(int $red, int $green, int $blue, int $transparency = 0) : array { return ['red' => \max(0, \min(255, $red)), 'green' => \max(0, \min(255, $green)), 'blue' => \max(0, \min(255, $blue)), 'alpha' => \max(0, \min(127, $transparency))]; } /** * Reads an image from a file and returns its type in $type. * @throws Nette\NotSupportedException if gd extension is not loaded * @throws UnknownImageFileException if file not found or file type is not known * @return static */ public static function fromFile(string $file, ?int &$type = null) { if (!\extension_loaded('gd')) { throw new Nette\NotSupportedException('PHP extension GD is not loaded.'); } $type = self::detectTypeFromFile($file); if (!$type) { throw new UnknownImageFileException(\is_file($file) ? "Unknown type of file '{$file}'." : "File '{$file}' not found."); } return self::invokeSafe('imagecreatefrom' . self::FORMATS[$type], $file, "Unable to open file '{$file}'.", __METHOD__); } /** * Reads an image from a string and returns its type in $type. * @return static * @throws Nette\NotSupportedException if gd extension is not loaded * @throws ImageException */ public static function fromString(string $s, ?int &$type = null) { if (!\extension_loaded('gd')) { throw new Nette\NotSupportedException('PHP extension GD is not loaded.'); } $type = self::detectTypeFromString($s); if (!$type) { throw new UnknownImageFileException('Unknown type of image.'); } return self::invokeSafe('imagecreatefromstring', $s, 'Unable to open image from string.', __METHOD__); } private static function invokeSafe(string $func, string $arg, string $message, string $callee) : self { $errors = []; $res = Callback::invokeSafe($func, [$arg], function (string $message) use(&$errors) : void { $errors[] = $message; }); if (!$res) { throw new ImageException($message . ' Errors: ' . \implode(', ', $errors)); } elseif ($errors) { \trigger_error($callee . '(): ' . \implode(', ', $errors), \E_USER_WARNING); } return new static($res); } /** * Creates a new true color image of the given dimensions. The default color is black. * @return static * @throws Nette\NotSupportedException if gd extension is not loaded */ public static function fromBlank(int $width, int $height, ?array $color = null) { if (!\extension_loaded('gd')) { throw new Nette\NotSupportedException('PHP extension GD is not loaded.'); } if ($width < 1 || $height < 1) { throw new Nette\InvalidArgumentException('Image width and height must be greater than zero.'); } $image = \imagecreatetruecolor($width, $height); if ($color) { $color += ['alpha' => 0]; $color = \imagecolorresolvealpha($image, $color['red'], $color['green'], $color['blue'], $color['alpha']); \imagealphablending($image, \false); \imagefilledrectangle($image, 0, 0, $width - 1, $height - 1, $color); \imagealphablending($image, \true); } return new static($image); } /** * Returns the type of image from file. */ public static function detectTypeFromFile(string $file) : ?int { $type = @\getimagesize($file)[2]; // @ - files smaller than 12 bytes causes read error return isset(self::FORMATS[$type]) ? $type : null; } /** * Returns the type of image from string. */ public static function detectTypeFromString(string $s) : ?int { $type = @\getimagesizefromstring($s)[2]; // @ - strings smaller than 12 bytes causes read error return isset(self::FORMATS[$type]) ? $type : null; } /** * Returns the file extension for the given `Image::XXX` constant. */ public static function typeToExtension(int $type) : string { if (!isset(self::FORMATS[$type])) { throw new Nette\InvalidArgumentException("Unsupported image type '{$type}'."); } return self::FORMATS[$type]; } /** * Returns the mime type for the given `Image::XXX` constant. */ public static function typeToMimeType(int $type) : string { return 'image/' . self::typeToExtension($type); } /** * Wraps GD image. * @param resource|\GdImage $image */ public function __construct($image) { $this->setImageResource($image); \imagesavealpha($image, \true); } /** * Returns image width. */ public function getWidth() : int { return \imagesx($this->image); } /** * Returns image height. */ public function getHeight() : int { return \imagesy($this->image); } /** * Sets image resource. * @param resource|\GdImage $image * @return static */ protected function setImageResource($image) { if (!$image instanceof \GdImage && !(\is_resource($image) && \get_resource_type($image) === 'gd')) { throw new Nette\InvalidArgumentException('Image is not valid.'); } $this->image = $image; return $this; } /** * Returns image GD resource. * @return resource|\GdImage */ public function getImageResource() { return $this->image; } /** * Scales an image. * @param int|string|null $width in pixels or percent * @param int|string|null $height in pixels or percent * @return static */ public function resize($width, $height, int $flags = self::FIT) { if ($flags & self::EXACT) { return $this->resize($width, $height, self::FILL)->crop('50%', '50%', $width, $height); } [$newWidth, $newHeight] = static::calculateSize($this->getWidth(), $this->getHeight(), $width, $height, $flags); if ($newWidth !== $this->getWidth() || $newHeight !== $this->getHeight()) { // resize $newImage = static::fromBlank($newWidth, $newHeight, self::rgb(0, 0, 0, 127))->getImageResource(); \imagecopyresampled($newImage, $this->image, 0, 0, 0, 0, $newWidth, $newHeight, $this->getWidth(), $this->getHeight()); $this->image = $newImage; } if ($width < 0 || $height < 0) { \imageflip($this->image, $width < 0 ? $height < 0 ? \IMG_FLIP_BOTH : \IMG_FLIP_HORIZONTAL : \IMG_FLIP_VERTICAL); } return $this; } /** * Calculates dimensions of resized image. * @param int|string|null $newWidth in pixels or percent * @param int|string|null $newHeight in pixels or percent */ public static function calculateSize(int $srcWidth, int $srcHeight, $newWidth, $newHeight, int $flags = self::FIT) : array { if ($newWidth === null) { } elseif (self::isPercent($newWidth)) { $newWidth = (int) \round($srcWidth / 100 * \abs($newWidth)); $percents = \true; } else { $newWidth = \abs($newWidth); } if ($newHeight === null) { } elseif (self::isPercent($newHeight)) { $newHeight = (int) \round($srcHeight / 100 * \abs($newHeight)); $flags |= empty($percents) ? 0 : self::STRETCH; } else { $newHeight = \abs($newHeight); } if ($flags & self::STRETCH) { // non-proportional if (!$newWidth || !$newHeight) { throw new Nette\InvalidArgumentException('For stretching must be both width and height specified.'); } if ($flags & self::SHRINK_ONLY) { $newWidth = (int) \round($srcWidth * \min(1, $newWidth / $srcWidth)); $newHeight = (int) \round($srcHeight * \min(1, $newHeight / $srcHeight)); } } else { // proportional if (!$newWidth && !$newHeight) { throw new Nette\InvalidArgumentException('At least width or height must be specified.'); } $scale = []; if ($newWidth > 0) { // fit width $scale[] = $newWidth / $srcWidth; } if ($newHeight > 0) { // fit height $scale[] = $newHeight / $srcHeight; } if ($flags & self::FILL) { $scale = [\max($scale)]; } if ($flags & self::SHRINK_ONLY) { $scale[] = 1; } $scale = \min($scale); $newWidth = (int) \round($srcWidth * $scale); $newHeight = (int) \round($srcHeight * $scale); } return [\max($newWidth, 1), \max($newHeight, 1)]; } /** * Crops image. * @param int|string $left in pixels or percent * @param int|string $top in pixels or percent * @param int|string $width in pixels or percent * @param int|string $height in pixels or percent * @return static */ public function crop($left, $top, $width, $height) { [$r['x'], $r['y'], $r['width'], $r['height']] = static::calculateCutout($this->getWidth(), $this->getHeight(), $left, $top, $width, $height); if (\gd_info()['GD Version'] === 'bundled (2.1.0 compatible)') { $this->image = \imagecrop($this->image, $r); \imagesavealpha($this->image, \true); } else { $newImage = static::fromBlank($r['width'], $r['height'], self::RGB(0, 0, 0, 127))->getImageResource(); \imagecopy($newImage, $this->image, 0, 0, $r['x'], $r['y'], $r['width'], $r['height']); $this->image = $newImage; } return $this; } /** * Calculates dimensions of cutout in image. * @param int|string $left in pixels or percent * @param int|string $top in pixels or percent * @param int|string $newWidth in pixels or percent * @param int|string $newHeight in pixels or percent */ public static function calculateCutout(int $srcWidth, int $srcHeight, $left, $top, $newWidth, $newHeight) : array { if (self::isPercent($newWidth)) { $newWidth = (int) \round($srcWidth / 100 * $newWidth); } if (self::isPercent($newHeight)) { $newHeight = (int) \round($srcHeight / 100 * $newHeight); } if (self::isPercent($left)) { $left = (int) \round(($srcWidth - $newWidth) / 100 * $left); } if (self::isPercent($top)) { $top = (int) \round(($srcHeight - $newHeight) / 100 * $top); } if ($left < 0) { $newWidth += $left; $left = 0; } if ($top < 0) { $newHeight += $top; $top = 0; } $newWidth = \min($newWidth, $srcWidth - $left); $newHeight = \min($newHeight, $srcHeight - $top); return [$left, $top, $newWidth, $newHeight]; } /** * Sharpens image a little bit. * @return static */ public function sharpen() { \imageconvolution($this->image, [ // my magic numbers ;) [-1, -1, -1], [-1, 24, -1], [-1, -1, -1], ], 16, 0); return $this; } /** * Puts another image into this image. * @param int|string $left in pixels or percent * @param int|string $top in pixels or percent * @param int $opacity 0..100 * @return static */ public function place(self $image, $left = 0, $top = 0, int $opacity = 100) { $opacity = \max(0, \min(100, $opacity)); if ($opacity === 0) { return $this; } $width = $image->getWidth(); $height = $image->getHeight(); if (self::isPercent($left)) { $left = (int) \round(($this->getWidth() - $width) / 100 * $left); } if (self::isPercent($top)) { $top = (int) \round(($this->getHeight() - $height) / 100 * $top); } $output = $input = $image->image; if ($opacity < 100) { $tbl = []; for ($i = 0; $i < 128; $i++) { $tbl[$i] = \round(127 - (127 - $i) * $opacity / 100); } $output = \imagecreatetruecolor($width, $height); \imagealphablending($output, \false); if (!$image->isTrueColor()) { $input = $output; \imagefilledrectangle($output, 0, 0, $width, $height, \imagecolorallocatealpha($output, 0, 0, 0, 127)); \imagecopy($output, $image->image, 0, 0, 0, 0, $width, $height); } for ($x = 0; $x < $width; $x++) { for ($y = 0; $y < $height; $y++) { $c = \imagecolorat($input, $x, $y); $c = ($c & 0xffffff) + ($tbl[$c >> 24] << 24); \imagesetpixel($output, $x, $y, $c); } } \imagealphablending($output, \true); } \imagecopy($this->image, $output, $left, $top, 0, 0, $width, $height); return $this; } /** * Saves image to the file. Quality is in the range 0..100 for JPEG (default 85), WEBP (default 80) and AVIF (default 30) and 0..9 for PNG (default 9). * @throws ImageException */ public function save(string $file, ?int $quality = null, ?int $type = null) : void { if ($type === null) { $extensions = \array_flip(self::FORMATS) + ['jpg' => self::JPEG]; $ext = \strtolower(\pathinfo($file, \PATHINFO_EXTENSION)); if (!isset($extensions[$ext])) { throw new Nette\InvalidArgumentException("Unsupported file extension '{$ext}'."); } $type = $extensions[$ext]; } $this->output($type, $quality, $file); } /** * Outputs image to string. Quality is in the range 0..100 for JPEG (default 85), WEBP (default 80) and AVIF (default 30) and 0..9 for PNG (default 9). */ public function toString(int $type = self::JPEG, ?int $quality = null) : string { return Helpers::capture(function () use($type, $quality) { $this->output($type, $quality); }); } /** * Outputs image to string. */ public function __toString() : string { try { return $this->toString(); } catch (\Throwable $e) { if (\func_num_args() || \PHP_VERSION_ID >= 70400) { throw $e; } \trigger_error('Exception in ' . __METHOD__ . "(): {$e->getMessage()} in {$e->getFile()}:{$e->getLine()}", \E_USER_ERROR); return ''; } } /** * Outputs image to browser. Quality is in the range 0..100 for JPEG (default 85), WEBP (default 80) and AVIF (default 30) and 0..9 for PNG (default 9). * @throws ImageException */ public function send(int $type = self::JPEG, ?int $quality = null) : void { \header('Content-Type: ' . self::typeToMimeType($type)); $this->output($type, $quality); } /** * Outputs image to browser or file. * @throws ImageException */ private function output(int $type, ?int $quality, ?string $file = null) : void { switch ($type) { case self::JPEG: $quality = $quality === null ? 85 : \max(0, \min(100, $quality)); $success = @\imagejpeg($this->image, $file, $quality); // @ is escalated to exception break; case self::PNG: $quality = $quality === null ? 9 : \max(0, \min(9, $quality)); $success = @\imagepng($this->image, $file, $quality); // @ is escalated to exception break; case self::GIF: $success = @\imagegif($this->image, $file); // @ is escalated to exception break; case self::WEBP: $quality = $quality === null ? 80 : \max(0, \min(100, $quality)); $success = @\imagewebp($this->image, $file, $quality); // @ is escalated to exception break; case self::AVIF: $quality = $quality === null ? 30 : \max(0, \min(100, $quality)); $success = @\imageavif($this->image, $file, $quality); // @ is escalated to exception break; case self::BMP: $success = @\imagebmp($this->image, $file); // @ is escalated to exception break; default: throw new Nette\InvalidArgumentException("Unsupported image type '{$type}'."); } if (!$success) { throw new ImageException(Helpers::getLastError() ?: 'Unknown error'); } } /** * Call to undefined method. * @return mixed * @throws Nette\MemberAccessException */ public function __call(string $name, array $args) { $function = 'image' . $name; if (!\function_exists($function)) { ObjectHelpers::strictCall(static::class, $name); } foreach ($args as $key => $value) { if ($value instanceof self) { $args[$key] = $value->getImageResource(); } elseif (\is_array($value) && isset($value['red'])) { // rgb $args[$key] = \imagecolorallocatealpha($this->image, $value['red'], $value['green'], $value['blue'], $value['alpha']) ?: \imagecolorresolvealpha($this->image, $value['red'], $value['green'], $value['blue'], $value['alpha']); } } $res = $function($this->image, ...$args); return $res instanceof \GdImage || \is_resource($res) && \get_resource_type($res) === 'gd' ? $this->setImageResource($res) : $res; } public function __clone() { \ob_start(function () { }); \imagegd2($this->image); $this->setImageResource(\imagecreatefromstring(\ob_get_clean())); } /** * @param int|string $num in pixels or percent */ private static function isPercent(&$num) : bool { if (\is_string($num) && \substr($num, -1) === '%') { $num = (float) \substr($num, 0, -1); return \true; } elseif (\is_int($num) || $num === (string) (int) $num) { $num = (int) $num; return \false; } throw new Nette\InvalidArgumentException("Expected dimension in int|string, '{$num}' given."); } /** * Prevents serialization. */ public function __sleep() : array { throw new Nette\NotSupportedException('You cannot serialize or unserialize ' . self::class . ' instances.'); } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Utils; use _PHPStan_7d8742a37\Nette; /** * Provides the base class for a generic list (items can be accessed by index). * @template T */ class ArrayList implements \ArrayAccess, \Countable, \IteratorAggregate { use Nette\SmartObject; /** @var mixed[] */ private $list = []; /** * Transforms array to ArrayList. * @param array<T> $array * @return static */ public static function from(array $array) { if (!Arrays::isList($array)) { throw new Nette\InvalidArgumentException('Array is not valid list.'); } $obj = new static(); $obj->list = $array; return $obj; } /** * Returns an iterator over all items. * @return \ArrayIterator<int, T> */ public function getIterator() : \ArrayIterator { return new \ArrayIterator($this->list); } /** * Returns items count. */ public function count() : int { return \count($this->list); } /** * Replaces or appends a item. * @param int|null $index * @param T $value * @throws Nette\OutOfRangeException */ public function offsetSet($index, $value) : void { if ($index === null) { $this->list[] = $value; } elseif (!\is_int($index) || $index < 0 || $index >= \count($this->list)) { throw new Nette\OutOfRangeException('Offset invalid or out of range'); } else { $this->list[$index] = $value; } } /** * Returns a item. * @param int $index * @return T * @throws Nette\OutOfRangeException */ #[\ReturnTypeWillChange] public function offsetGet($index) { if (!\is_int($index) || $index < 0 || $index >= \count($this->list)) { throw new Nette\OutOfRangeException('Offset invalid or out of range'); } return $this->list[$index]; } /** * Determines whether a item exists. * @param int $index */ public function offsetExists($index) : bool { return \is_int($index) && $index >= 0 && $index < \count($this->list); } /** * Removes the element at the specified position in this list. * @param int $index * @throws Nette\OutOfRangeException */ public function offsetUnset($index) : void { if (!\is_int($index) || $index < 0 || $index >= \count($this->list)) { throw new Nette\OutOfRangeException('Offset invalid or out of range'); } \array_splice($this->list, $index, 1); } /** * Prepends a item. * @param T $value */ public function prepend($value) : void { $first = \array_slice($this->list, 0, 1); $this->offsetSet(0, $value); \array_splice($this->list, 1, 0, $first); } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Utils; use _PHPStan_7d8742a37\Nette; /** * Floating-point numbers comparison. */ class Floats { use Nette\StaticClass; private const EPSILON = 1.0E-10; public static function isZero(float $value) : bool { return \abs($value) < self::EPSILON; } public static function isInteger(float $value) : bool { return \abs(\round($value) - $value) < self::EPSILON; } /** * Compare two floats. If $a < $b it returns -1, if they are equal it returns 0 and if $a > $b it returns 1 * @throws \LogicException if one of parameters is NAN */ public static function compare(float $a, float $b) : int { if (\is_nan($a) || \is_nan($b)) { throw new \LogicException('Trying to compare NAN'); } elseif (!\is_finite($a) && !\is_finite($b) && $a === $b) { return 0; } $diff = \abs($a - $b); if ($diff < self::EPSILON || $diff / \max(\abs($a), \abs($b)) < self::EPSILON) { return 0; } return $a < $b ? -1 : 1; } /** * Returns true if $a = $b * @throws \LogicException if one of parameters is NAN */ public static function areEqual(float $a, float $b) : bool { return self::compare($a, $b) === 0; } /** * Returns true if $a < $b * @throws \LogicException if one of parameters is NAN */ public static function isLessThan(float $a, float $b) : bool { return self::compare($a, $b) < 0; } /** * Returns true if $a <= $b * @throws \LogicException if one of parameters is NAN */ public static function isLessThanOrEqualTo(float $a, float $b) : bool { return self::compare($a, $b) <= 0; } /** * Returns true if $a > $b * @throws \LogicException if one of parameters is NAN */ public static function isGreaterThan(float $a, float $b) : bool { return self::compare($a, $b) > 0; } /** * Returns true if $a >= $b * @throws \LogicException if one of parameters is NAN */ public static function isGreaterThanOrEqualTo(float $a, float $b) : bool { return self::compare($a, $b) >= 0; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Utils; use _PHPStan_7d8742a37\Nette; /** * DateTime. */ class DateTime extends \DateTime implements \JsonSerializable { use Nette\SmartObject; /** minute in seconds */ public const MINUTE = 60; /** hour in seconds */ public const HOUR = 60 * self::MINUTE; /** day in seconds */ public const DAY = 24 * self::HOUR; /** week in seconds */ public const WEEK = 7 * self::DAY; /** average month in seconds */ public const MONTH = 2629800; /** average year in seconds */ public const YEAR = 31557600; /** * Creates a DateTime object from a string, UNIX timestamp, or other DateTimeInterface object. * @param string|int|\DateTimeInterface $time * @return static * @throws \Exception if the date and time are not valid. */ public static function from($time) { if ($time instanceof \DateTimeInterface) { return new static($time->format('Y-m-d H:i:s.u'), $time->getTimezone()); } elseif (\is_numeric($time)) { if ($time <= self::YEAR) { $time += \time(); } return (new static('@' . $time))->setTimezone(new \DateTimeZone(\date_default_timezone_get())); } else { // textual or null return new static((string) $time); } } /** * Creates DateTime object. * @return static * @throws Nette\InvalidArgumentException if the date and time are not valid. */ public static function fromParts(int $year, int $month, int $day, int $hour = 0, int $minute = 0, float $second = 0.0) { $s = \sprintf('%04d-%02d-%02d %02d:%02d:%02.5F', $year, $month, $day, $hour, $minute, $second); if (!\checkdate($month, $day, $year) || $hour < 0 || $hour > 23 || $minute < 0 || $minute > 59 || $second < 0 || $second >= 60) { throw new Nette\InvalidArgumentException("Invalid date '{$s}'"); } return new static($s); } /** * Returns new DateTime object formatted according to the specified format. * @param string $format The format the $time parameter should be in * @param string $time * @param string|\DateTimeZone $timezone (default timezone is used if null is passed) * @return static|false */ #[\ReturnTypeWillChange] public static function createFromFormat($format, $time, $timezone = null) { if ($timezone === null) { $timezone = new \DateTimeZone(\date_default_timezone_get()); } elseif (\is_string($timezone)) { $timezone = new \DateTimeZone($timezone); } elseif (!$timezone instanceof \DateTimeZone) { throw new Nette\InvalidArgumentException('Invalid timezone given'); } $date = parent::createFromFormat($format, $time, $timezone); return $date ? static::from($date) : \false; } /** * Returns JSON representation in ISO 8601 (used by JavaScript). */ public function jsonSerialize() : string { return $this->format('c'); } /** * Returns the date and time in the format 'Y-m-d H:i:s'. */ public function __toString() : string { return $this->format('Y-m-d H:i:s'); } /** * Creates a copy with a modified time. * @return static */ public function modifyClone(string $modify = '') { $dolly = clone $this; return $modify ? $dolly->modify($modify) : $dolly; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Utils; use _PHPStan_7d8742a37\Nette; /** * JSON encoder and decoder. */ final class Json { use Nette\StaticClass; public const FORCE_ARRAY = \JSON_OBJECT_AS_ARRAY; public const PRETTY = \JSON_PRETTY_PRINT; public const ESCAPE_UNICODE = 1 << 19; /** * Converts value to JSON format. The flag can be Json::PRETTY, which formats JSON for easier reading and clarity, * and Json::ESCAPE_UNICODE for ASCII output. * @param mixed $value * @throws JsonException */ public static function encode($value, int $flags = 0) : string { $flags = ($flags & self::ESCAPE_UNICODE ? 0 : \JSON_UNESCAPED_UNICODE) | \JSON_UNESCAPED_SLASHES | $flags & ~self::ESCAPE_UNICODE | (\defined('JSON_PRESERVE_ZERO_FRACTION') ? \JSON_PRESERVE_ZERO_FRACTION : 0); // since PHP 5.6.6 & PECL JSON-C 1.3.7 $json = \json_encode($value, $flags); if ($error = \json_last_error()) { throw new JsonException(\json_last_error_msg(), $error); } return $json; } /** * Parses JSON to PHP value. The flag can be Json::FORCE_ARRAY, which forces an array instead of an object as the return value. * @return mixed * @throws JsonException */ public static function decode(string $json, int $flags = 0) { $value = \json_decode($json, null, 512, $flags | \JSON_BIGINT_AS_STRING); if ($error = \json_last_error()) { throw new JsonException(\json_last_error_msg(), $error); } return $value; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Utils; use _PHPStan_7d8742a37\Nette; /** * Paginating math. * * @property int $page * @property-read int $firstPage * @property-read int|null $lastPage * @property-read int $firstItemOnPage * @property-read int $lastItemOnPage * @property int $base * @property-read bool $first * @property-read bool $last * @property-read int|null $pageCount * @property int $itemsPerPage * @property int|null $itemCount * @property-read int $offset * @property-read int|null $countdownOffset * @property-read int $length */ class Paginator { use Nette\SmartObject; /** @var int */ private $base = 1; /** @var int */ private $itemsPerPage = 1; /** @var int */ private $page = 1; /** @var int|null */ private $itemCount; /** * Sets current page number. * @return static */ public function setPage(int $page) { $this->page = $page; return $this; } /** * Returns current page number. */ public function getPage() : int { return $this->base + $this->getPageIndex(); } /** * Returns first page number. */ public function getFirstPage() : int { return $this->base; } /** * Returns last page number. */ public function getLastPage() : ?int { return $this->itemCount === null ? null : $this->base + \max(0, $this->getPageCount() - 1); } /** * Returns the sequence number of the first element on the page */ public function getFirstItemOnPage() : int { return $this->itemCount !== 0 ? $this->offset + 1 : 0; } /** * Returns the sequence number of the last element on the page */ public function getLastItemOnPage() : int { return $this->offset + $this->length; } /** * Sets first page (base) number. * @return static */ public function setBase(int $base) { $this->base = $base; return $this; } /** * Returns first page (base) number. */ public function getBase() : int { return $this->base; } /** * Returns zero-based page number. */ protected function getPageIndex() : int { $index = \max(0, $this->page - $this->base); return $this->itemCount === null ? $index : \min($index, \max(0, $this->getPageCount() - 1)); } /** * Is the current page the first one? */ public function isFirst() : bool { return $this->getPageIndex() === 0; } /** * Is the current page the last one? */ public function isLast() : bool { return $this->itemCount === null ? \false : $this->getPageIndex() >= $this->getPageCount() - 1; } /** * Returns the total number of pages. */ public function getPageCount() : ?int { return $this->itemCount === null ? null : (int) \ceil($this->itemCount / $this->itemsPerPage); } /** * Sets the number of items to display on a single page. * @return static */ public function setItemsPerPage(int $itemsPerPage) { $this->itemsPerPage = \max(1, $itemsPerPage); return $this; } /** * Returns the number of items to display on a single page. */ public function getItemsPerPage() : int { return $this->itemsPerPage; } /** * Sets the total number of items. * @return static */ public function setItemCount(?int $itemCount = null) { $this->itemCount = $itemCount === null ? null : \max(0, $itemCount); return $this; } /** * Returns the total number of items. */ public function getItemCount() : ?int { return $this->itemCount; } /** * Returns the absolute index of the first item on current page. */ public function getOffset() : int { return $this->getPageIndex() * $this->itemsPerPage; } /** * Returns the absolute index of the first item on current page in countdown paging. */ public function getCountdownOffset() : ?int { return $this->itemCount === null ? null : \max(0, $this->itemCount - ($this->getPageIndex() + 1) * $this->itemsPerPage); } /** * Returns the number of items on current page. */ public function getLength() : int { return $this->itemCount === null ? $this->itemsPerPage : \min($this->itemsPerPage, $this->itemCount - $this->getPageIndex() * $this->itemsPerPage); } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Utils; use _PHPStan_7d8742a37\Nette; use _PHPStan_7d8742a37\Nette\MemberAccessException; /** * Nette\SmartObject helpers. */ final class ObjectHelpers { use Nette\StaticClass; /** * @return never * @throws MemberAccessException */ public static function strictGet(string $class, string $name) : void { $rc = new \ReflectionClass($class); $hint = self::getSuggestion(\array_merge(\array_filter($rc->getProperties(\ReflectionProperty::IS_PUBLIC), function ($p) { return !$p->isStatic(); }), self::parseFullDoc($rc, '~^[ \\t*]*@property(?:-read)?[ \\t]+(?:\\S+[ \\t]+)??\\$(\\w+)~m')), $name); throw new MemberAccessException("Cannot read an undeclared property {$class}::\${$name}" . ($hint ? ", did you mean \${$hint}?" : '.')); } /** * @return never * @throws MemberAccessException */ public static function strictSet(string $class, string $name) : void { $rc = new \ReflectionClass($class); $hint = self::getSuggestion(\array_merge(\array_filter($rc->getProperties(\ReflectionProperty::IS_PUBLIC), function ($p) { return !$p->isStatic(); }), self::parseFullDoc($rc, '~^[ \\t*]*@property(?:-write)?[ \\t]+(?:\\S+[ \\t]+)??\\$(\\w+)~m')), $name); throw new MemberAccessException("Cannot write to an undeclared property {$class}::\${$name}" . ($hint ? ", did you mean \${$hint}?" : '.')); } /** * @return never * @throws MemberAccessException */ public static function strictCall(string $class, string $method, array $additionalMethods = []) : void { $trace = \debug_backtrace(0, 3); // suppose this method is called from __call() $context = ($trace[1]['function'] ?? null) === '__call' ? $trace[2]['class'] ?? null : null; if ($context && \is_a($class, $context, \true) && \method_exists($context, $method)) { // called parent::$method() $class = \get_parent_class($context); } if (\method_exists($class, $method)) { // insufficient visibility $rm = new \ReflectionMethod($class, $method); $visibility = $rm->isPrivate() ? 'private ' : ($rm->isProtected() ? 'protected ' : ''); throw new MemberAccessException("Call to {$visibility}method {$class}::{$method}() from " . ($context ? "scope {$context}." : 'global scope.')); } else { $hint = self::getSuggestion(\array_merge(\get_class_methods($class), self::parseFullDoc(new \ReflectionClass($class), '~^[ \\t*]*@method[ \\t]+(?:\\S+[ \\t]+)??(\\w+)\\(~m'), $additionalMethods), $method); throw new MemberAccessException("Call to undefined method {$class}::{$method}()" . ($hint ? ", did you mean {$hint}()?" : '.')); } } /** * @return never * @throws MemberAccessException */ public static function strictStaticCall(string $class, string $method) : void { $trace = \debug_backtrace(0, 3); // suppose this method is called from __callStatic() $context = ($trace[1]['function'] ?? null) === '__callStatic' ? $trace[2]['class'] ?? null : null; if ($context && \is_a($class, $context, \true) && \method_exists($context, $method)) { // called parent::$method() $class = \get_parent_class($context); } if (\method_exists($class, $method)) { // insufficient visibility $rm = new \ReflectionMethod($class, $method); $visibility = $rm->isPrivate() ? 'private ' : ($rm->isProtected() ? 'protected ' : ''); throw new MemberAccessException("Call to {$visibility}method {$class}::{$method}() from " . ($context ? "scope {$context}." : 'global scope.')); } else { $hint = self::getSuggestion(\array_filter((new \ReflectionClass($class))->getMethods(\ReflectionMethod::IS_PUBLIC), function ($m) { return $m->isStatic(); }), $method); throw new MemberAccessException("Call to undefined static method {$class}::{$method}()" . ($hint ? ", did you mean {$hint}()?" : '.')); } } /** * Returns array of magic properties defined by annotation @property. * @return array of [name => bit mask] * @internal */ public static function getMagicProperties(string $class) : array { static $cache; $props =& $cache[$class]; if ($props !== null) { return $props; } $rc = new \ReflectionClass($class); \preg_match_all('~^ [ \\t*]* @property(|-read|-write|-deprecated) [ \\t]+ [^\\s$]+ [ \\t]+ \\$ (\\w+) ()~mx', (string) $rc->getDocComment(), $matches, \PREG_SET_ORDER); $props = []; foreach ($matches as [, $type, $name]) { $uname = \ucfirst($name); $write = $type !== '-read' && $rc->hasMethod($nm = 'set' . $uname) && ($rm = $rc->getMethod($nm))->name === $nm && !$rm->isPrivate() && !$rm->isStatic(); $read = $type !== '-write' && ($rc->hasMethod($nm = 'get' . $uname) || $rc->hasMethod($nm = 'is' . $uname)) && ($rm = $rc->getMethod($nm))->name === $nm && !$rm->isPrivate() && !$rm->isStatic(); if ($read || $write) { $props[$name] = $read << 0 | ($nm[0] === 'g') << 1 | $rm->returnsReference() << 2 | $write << 3 | ($type === '-deprecated') << 4; } } foreach ($rc->getTraits() as $trait) { $props += self::getMagicProperties($trait->name); } if ($parent = \get_parent_class($class)) { $props += self::getMagicProperties($parent); } return $props; } /** * Finds the best suggestion (for 8-bit encoding). * @param (\ReflectionFunctionAbstract|\ReflectionParameter|\ReflectionClass|\ReflectionProperty|string)[] $possibilities * @internal */ public static function getSuggestion(array $possibilities, string $value) : ?string { $norm = \preg_replace($re = '#^(get|set|has|is|add)(?=[A-Z])#', '+', $value); $best = null; $min = (\strlen($value) / 4 + 1) * 10 + 0.1; foreach (\array_unique($possibilities, \SORT_REGULAR) as $item) { $item = $item instanceof \Reflector ? $item->name : $item; if ($item !== $value && (($len = \levenshtein($item, $value, 10, 11, 10)) < $min || ($len = \levenshtein(\preg_replace($re, '*', $item), $norm, 10, 11, 10)) < $min)) { $min = $len; $best = $item; } } return $best; } private static function parseFullDoc(\ReflectionClass $rc, string $pattern) : array { do { $doc[] = $rc->getDocComment(); $traits = $rc->getTraits(); while ($trait = \array_pop($traits)) { $doc[] = $trait->getDocComment(); $traits += $trait->getTraits(); } } while ($rc = $rc->getParentClass()); return \preg_match_all($pattern, \implode($doc), $m) ? $m[1] : []; } /** * Checks if the public non-static property exists. * @return bool|string returns 'event' if the property exists and has event like name * @internal */ public static function hasProperty(string $class, string $name) { static $cache; $prop =& $cache[$class][$name]; if ($prop === null) { $prop = \false; try { $rp = new \ReflectionProperty($class, $name); if ($rp->isPublic() && !$rp->isStatic()) { $prop = $name >= 'onA' && $name < 'on_' ? 'event' : \true; } } catch (\ReflectionException $e) { } } return $prop; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Utils; use _PHPStan_7d8742a37\Nette; /** * Validation utilities. */ class Validators { use Nette\StaticClass; /** @var array<string,?callable> */ protected static $validators = [ // PHP types 'array' => 'is_array', 'bool' => 'is_bool', 'boolean' => 'is_bool', 'float' => 'is_float', 'int' => 'is_int', 'integer' => 'is_int', 'null' => 'is_null', 'object' => 'is_object', 'resource' => 'is_resource', 'scalar' => 'is_scalar', 'string' => 'is_string', // pseudo-types 'callable' => [self::class, 'isCallable'], 'iterable' => 'is_iterable', 'list' => [Arrays::class, 'isList'], 'mixed' => [self::class, 'isMixed'], 'none' => [self::class, 'isNone'], 'number' => [self::class, 'isNumber'], 'numeric' => [self::class, 'isNumeric'], 'numericint' => [self::class, 'isNumericInt'], // string patterns 'alnum' => 'ctype_alnum', 'alpha' => 'ctype_alpha', 'digit' => 'ctype_digit', 'lower' => 'ctype_lower', 'pattern' => null, 'space' => 'ctype_space', 'unicode' => [self::class, 'isUnicode'], 'upper' => 'ctype_upper', 'xdigit' => 'ctype_xdigit', // syntax validation 'email' => [self::class, 'isEmail'], 'identifier' => [self::class, 'isPhpIdentifier'], 'uri' => [self::class, 'isUri'], 'url' => [self::class, 'isUrl'], // environment validation 'class' => 'class_exists', 'interface' => 'interface_exists', 'directory' => 'is_dir', 'file' => 'is_file', 'type' => [self::class, 'isType'], ]; /** @var array<string,callable> */ protected static $counters = ['string' => 'strlen', 'unicode' => [Strings::class, 'length'], 'array' => 'count', 'list' => 'count', 'alnum' => 'strlen', 'alpha' => 'strlen', 'digit' => 'strlen', 'lower' => 'strlen', 'space' => 'strlen', 'upper' => 'strlen', 'xdigit' => 'strlen']; /** * Verifies that the value is of expected types separated by pipe. * @param mixed $value * @throws AssertionException */ public static function assert($value, string $expected, string $label = 'variable') : void { if (!static::is($value, $expected)) { $expected = \str_replace(['|', ':'], [' or ', ' in range '], $expected); static $translate = ['boolean' => 'bool', 'integer' => 'int', 'double' => 'float', 'NULL' => 'null']; $type = $translate[\gettype($value)] ?? \gettype($value); if (\is_int($value) || \is_float($value) || \is_string($value) && \strlen($value) < 40) { $type .= ' ' . \var_export($value, \true); } elseif (\is_object($value)) { $type .= ' ' . \get_class($value); } throw new AssertionException("The {$label} expects to be {$expected}, {$type} given."); } } /** * Verifies that element $key in array is of expected types separated by pipe. * @param mixed[] $array * @param int|string $key * @throws AssertionException */ public static function assertField(array $array, $key, ?string $expected = null, string $label = "item '%' in array") : void { if (!\array_key_exists($key, $array)) { throw new AssertionException('Missing ' . \str_replace('%', $key, $label) . '.'); } elseif ($expected) { static::assert($array[$key], $expected, \str_replace('%', $key, $label)); } } /** * Verifies that the value is of expected types separated by pipe. * @param mixed $value */ public static function is($value, string $expected) : bool { foreach (\explode('|', $expected) as $item) { if (\substr($item, -2) === '[]') { if (\is_iterable($value) && self::everyIs($value, \substr($item, 0, -2))) { return \true; } continue; } elseif (\substr($item, 0, 1) === '?') { $item = \substr($item, 1); if ($value === null) { return \true; } } [$type] = $item = \explode(':', $item, 2); if (isset(static::$validators[$type])) { try { if (!static::$validators[$type]($value)) { continue; } } catch (\TypeError $e) { continue; } } elseif ($type === 'pattern') { if (Strings::match($value, '|^' . ($item[1] ?? '') . '$|D')) { return \true; } continue; } elseif (!$value instanceof $type) { continue; } if (isset($item[1])) { $length = $value; if (isset(static::$counters[$type])) { $length = static::$counters[$type]($value); } $range = \explode('..', $item[1]); if (!isset($range[1])) { $range[1] = $range[0]; } if ($range[0] !== '' && $length < $range[0] || $range[1] !== '' && $length > $range[1]) { continue; } } return \true; } return \false; } /** * Finds whether all values are of expected types separated by pipe. * @param mixed[] $values */ public static function everyIs(iterable $values, string $expected) : bool { foreach ($values as $value) { if (!static::is($value, $expected)) { return \false; } } return \true; } /** * Checks if the value is an integer or a float. * @param mixed $value */ public static function isNumber($value) : bool { return \is_int($value) || \is_float($value); } /** * Checks if the value is an integer or a integer written in a string. * @param mixed $value */ public static function isNumericInt($value) : bool { return \is_int($value) || \is_string($value) && \preg_match('#^[+-]?[0-9]+$#D', $value); } /** * Checks if the value is a number or a number written in a string. * @param mixed $value */ public static function isNumeric($value) : bool { return \is_float($value) || \is_int($value) || \is_string($value) && \preg_match('#^[+-]?([0-9]++\\.?[0-9]*|\\.[0-9]+)$#D', $value); } /** * Checks if the value is a syntactically correct callback. * @param mixed $value */ public static function isCallable($value) : bool { return $value && \is_callable($value, \true); } /** * Checks if the value is a valid UTF-8 string. * @param mixed $value */ public static function isUnicode($value) : bool { return \is_string($value) && \preg_match('##u', $value); } /** * Checks if the value is 0, '', false or null. * @param mixed $value */ public static function isNone($value) : bool { return $value == null; // intentionally == } /** @internal */ public static function isMixed() : bool { return \true; } /** * Checks if a variable is a zero-based integer indexed array. * @param mixed $value * @deprecated use Nette\Utils\Arrays::isList */ public static function isList($value) : bool { return Arrays::isList($value); } /** * Checks if the value is in the given range [min, max], where the upper or lower limit can be omitted (null). * Numbers, strings and DateTime objects can be compared. * @param mixed $value */ public static function isInRange($value, array $range) : bool { if ($value === null || !(isset($range[0]) || isset($range[1]))) { return \false; } $limit = $range[0] ?? $range[1]; if (\is_string($limit)) { $value = (string) $value; } elseif ($limit instanceof \DateTimeInterface) { if (!$value instanceof \DateTimeInterface) { return \false; } } elseif (\is_numeric($value)) { $value *= 1; } else { return \false; } return (!isset($range[0]) || $value >= $range[0]) && (!isset($range[1]) || $value <= $range[1]); } /** * Checks if the value is a valid email address. It does not verify that the domain actually exists, only the syntax is verified. */ public static function isEmail(string $value) : bool { $atom = "[-a-z0-9!#\$%&'*+/=?^_`{|}~]"; // RFC 5322 unquoted characters in local-part $alpha = "a-z\x80-\xff"; // superset of IDN return (bool) \preg_match(<<<XX \t\t(^ \t\t\t("([ !#-[\\]-~]*|\\\\[ -~])+"|{$atom}+(\\.{$atom}+)*) # quoted or unquoted \t\t\t@ \t\t\t([0-9{$alpha}]([-0-9{$alpha}]{0,61}[0-9{$alpha}])?\\.)+ # domain - RFC 1034 \t\t\t[{$alpha}]([-0-9{$alpha}]{0,17}[{$alpha}])? # top domain \t\t\$)Dix XX , $value); } /** * Checks if the value is a valid URL address. */ public static function isUrl(string $value) : bool { $alpha = "a-z\x80-\xff"; return (bool) \preg_match(<<<XX \t\t(^ \t\t\thttps?://( \t\t\t\t(([-_0-9{$alpha}]+\\.)* # subdomain \t\t\t\t\t[0-9{$alpha}]([-0-9{$alpha}]{0,61}[0-9{$alpha}])?\\.)? # domain \t\t\t\t\t[{$alpha}]([-0-9{$alpha}]{0,17}[{$alpha}])? # top domain \t\t\t\t|\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}\\.\\d{1,3} # IPv4 \t\t\t\t|\\[[0-9a-f:]{3,39}\\] # IPv6 \t\t\t)(:\\d{1,5})? # port \t\t\t(/\\S*)? # path \t\t\t(\\?\\S*)? # query \t\t\t(\\#\\S*)? # fragment \t\t\$)Dix XX , $value); } /** * Checks if the value is a valid URI address, that is, actually a string beginning with a syntactically valid schema. */ public static function isUri(string $value) : bool { return (bool) \preg_match('#^[a-z\\d+\\.-]+:\\S+$#Di', $value); } /** * Checks whether the input is a class, interface or trait. */ public static function isType(string $type) : bool { return \class_exists($type) || \interface_exists($type) || \trait_exists($type); } /** * Checks whether the input is a valid PHP identifier. */ public static function isPhpIdentifier(string $value) : bool { return \preg_match('#^[a-zA-Z_\\x7f-\\xff][a-zA-Z0-9_\\x7f-\\xff]*$#D', $value) === 1; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Utils; use _PHPStan_7d8742a37\Nette; class Helpers { /** * Executes a callback and returns the captured output as a string. */ public static function capture(callable $func) : string { \ob_start(function () { }); try { $func(); return \ob_get_clean(); } catch (\Throwable $e) { \ob_end_clean(); throw $e; } } /** * Returns the last occurred PHP error or an empty string if no error occurred. Unlike error_get_last(), * it is nit affected by the PHP directive html_errors and always returns text, not HTML. */ public static function getLastError() : string { $message = \error_get_last()['message'] ?? ''; $message = \ini_get('html_errors') ? Html::htmlToText($message) : $message; $message = \preg_replace('#^\\w+\\(.*?\\): #', '', $message); return $message; } /** * Converts false to null, does not change other values. * @param mixed $value * @return mixed */ public static function falseToNull($value) { return $value === \false ? null : $value; } /** * Returns value clamped to the inclusive range of min and max. * @param int|float $value * @param int|float $min * @param int|float $max * @return int|float */ public static function clamp($value, $min, $max) { if ($min > $max) { throw new Nette\InvalidArgumentException("Minimum ({$min}) is not less than maximum ({$max})."); } return \min(\max($value, $min), $max); } /** * Looks for a string from possibilities that is most similar to value, but not the same (for 8-bit encoding). * @param string[] $possibilities */ public static function getSuggestion(array $possibilities, string $value) : ?string { $best = null; $min = (\strlen($value) / 4 + 1) * 10 + 0.1; foreach (\array_unique($possibilities) as $item) { if ($item !== $value && ($len = \levenshtein($item, $value, 10, 11, 10)) < $min) { $min = $len; $best = $item; } } return $best; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Utils; use _PHPStan_7d8742a37\Nette; /** * File system tool. */ final class FileSystem { use Nette\StaticClass; /** * Creates a directory if it doesn't exist. * @throws Nette\IOException on error occurred */ public static function createDir(string $dir, int $mode = 0777) : void { if (!\is_dir($dir) && !@\mkdir($dir, $mode, \true) && !\is_dir($dir)) { // @ - dir may already exist throw new Nette\IOException(\sprintf("Unable to create directory '%s' with mode %s. %s", self::normalizePath($dir), \decoct($mode), Helpers::getLastError())); } } /** * Copies a file or a directory. Overwrites existing files and directories by default. * @throws Nette\IOException on error occurred * @throws Nette\InvalidStateException if $overwrite is set to false and destination already exists */ public static function copy(string $origin, string $target, bool $overwrite = \true) : void { if (\stream_is_local($origin) && !\file_exists($origin)) { throw new Nette\IOException(\sprintf("File or directory '%s' not found.", self::normalizePath($origin))); } elseif (!$overwrite && \file_exists($target)) { throw new Nette\InvalidStateException(\sprintf("File or directory '%s' already exists.", self::normalizePath($target))); } elseif (\is_dir($origin)) { static::createDir($target); foreach (new \FilesystemIterator($target) as $item) { static::delete($item->getPathname()); } foreach ($iterator = new \RecursiveIteratorIterator(new \RecursiveDirectoryIterator($origin, \RecursiveDirectoryIterator::SKIP_DOTS), \RecursiveIteratorIterator::SELF_FIRST) as $item) { if ($item->isDir()) { static::createDir($target . '/' . $iterator->getSubPathName()); } else { static::copy($item->getPathname(), $target . '/' . $iterator->getSubPathName()); } } } else { static::createDir(\dirname($target)); if (($s = @\fopen($origin, 'rb')) && ($d = @\fopen($target, 'wb')) && @\stream_copy_to_stream($s, $d) === \false) { // @ is escalated to exception throw new Nette\IOException(\sprintf("Unable to copy file '%s' to '%s'. %s", self::normalizePath($origin), self::normalizePath($target), Helpers::getLastError())); } } } /** * Deletes a file or directory if exists. * @throws Nette\IOException on error occurred */ public static function delete(string $path) : void { if (\is_file($path) || \is_link($path)) { $func = \DIRECTORY_SEPARATOR === '\\' && \is_dir($path) ? 'rmdir' : 'unlink'; if (!@$func($path)) { // @ is escalated to exception throw new Nette\IOException(\sprintf("Unable to delete '%s'. %s", self::normalizePath($path), Helpers::getLastError())); } } elseif (\is_dir($path)) { foreach (new \FilesystemIterator($path) as $item) { static::delete($item->getPathname()); } if (!@\rmdir($path)) { // @ is escalated to exception throw new Nette\IOException(\sprintf("Unable to delete directory '%s'. %s", self::normalizePath($path), Helpers::getLastError())); } } } /** * Renames or moves a file or a directory. Overwrites existing files and directories by default. * @throws Nette\IOException on error occurred * @throws Nette\InvalidStateException if $overwrite is set to false and destination already exists */ public static function rename(string $origin, string $target, bool $overwrite = \true) : void { if (!$overwrite && \file_exists($target)) { throw new Nette\InvalidStateException(\sprintf("File or directory '%s' already exists.", self::normalizePath($target))); } elseif (!\file_exists($origin)) { throw new Nette\IOException(\sprintf("File or directory '%s' not found.", self::normalizePath($origin))); } else { static::createDir(\dirname($target)); if (\realpath($origin) !== \realpath($target)) { static::delete($target); } if (!@\rename($origin, $target)) { // @ is escalated to exception throw new Nette\IOException(\sprintf("Unable to rename file or directory '%s' to '%s'. %s", self::normalizePath($origin), self::normalizePath($target), Helpers::getLastError())); } } } /** * Reads the content of a file. * @throws Nette\IOException on error occurred */ public static function read(string $file) : string { $content = @\file_get_contents($file); // @ is escalated to exception if ($content === \false) { throw new Nette\IOException(\sprintf("Unable to read file '%s'. %s", self::normalizePath($file), Helpers::getLastError())); } return $content; } /** * Writes the string to a file. * @throws Nette\IOException on error occurred */ public static function write(string $file, string $content, ?int $mode = 0666) : void { static::createDir(\dirname($file)); if (@\file_put_contents($file, $content) === \false) { // @ is escalated to exception throw new Nette\IOException(\sprintf("Unable to write file '%s'. %s", self::normalizePath($file), Helpers::getLastError())); } if ($mode !== null && !@\chmod($file, $mode)) { // @ is escalated to exception throw new Nette\IOException(\sprintf("Unable to chmod file '%s' to mode %s. %s", self::normalizePath($file), \decoct($mode), Helpers::getLastError())); } } /** * Fixes permissions to a specific file or directory. Directories can be fixed recursively. * @throws Nette\IOException on error occurred */ public static function makeWritable(string $path, int $dirMode = 0777, int $fileMode = 0666) : void { if (\is_file($path)) { if (!@\chmod($path, $fileMode)) { // @ is escalated to exception throw new Nette\IOException(\sprintf("Unable to chmod file '%s' to mode %s. %s", self::normalizePath($path), \decoct($fileMode), Helpers::getLastError())); } } elseif (\is_dir($path)) { foreach (new \FilesystemIterator($path) as $item) { static::makeWritable($item->getPathname(), $dirMode, $fileMode); } if (!@\chmod($path, $dirMode)) { // @ is escalated to exception throw new Nette\IOException(\sprintf("Unable to chmod directory '%s' to mode %s. %s", self::normalizePath($path), \decoct($dirMode), Helpers::getLastError())); } } else { throw new Nette\IOException(\sprintf("File or directory '%s' not found.", self::normalizePath($path))); } } /** * Determines if the path is absolute. */ public static function isAbsolute(string $path) : bool { return (bool) \preg_match('#([a-z]:)?[/\\\\]|[a-z][a-z0-9+.-]*://#Ai', $path); } /** * Normalizes `..` and `.` and directory separators in path. */ public static function normalizePath(string $path) : string { $parts = $path === '' ? [] : \preg_split('~[/\\\\]+~', $path); $res = []; foreach ($parts as $part) { if ($part === '..' && $res && \end($res) !== '..' && \end($res) !== '') { \array_pop($res); } elseif ($part !== '.') { $res[] = $part; } } return $res === [''] ? \DIRECTORY_SEPARATOR : \implode(\DIRECTORY_SEPARATOR, $res); } /** * Joins all segments of the path and normalizes the result. */ public static function joinPaths(string ...$paths) : string { return self::normalizePath(\implode('/', $paths)); } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Utils; use _PHPStan_7d8742a37\Nette; use function is_array, is_object, strlen; /** * String tools library. */ class Strings { use Nette\StaticClass; public const TRIM_CHARACTERS = " \t\n\r\x00\v "; /** * Checks if the string is valid in UTF-8 encoding. */ public static function checkEncoding(string $s) : bool { return $s === self::fixEncoding($s); } /** * Removes all invalid UTF-8 characters from a string. */ public static function fixEncoding(string $s) : string { // removes xD800-xDFFF, x110000 and higher return \htmlspecialchars_decode(\htmlspecialchars($s, \ENT_NOQUOTES | \ENT_IGNORE, 'UTF-8'), \ENT_NOQUOTES); } /** * Returns a specific character in UTF-8 from code point (number in range 0x0000..D7FF or 0xE000..10FFFF). * @throws Nette\InvalidArgumentException if code point is not in valid range */ public static function chr(int $code) : string { if ($code < 0 || $code >= 0xd800 && $code <= 0xdfff || $code > 0x10ffff) { throw new Nette\InvalidArgumentException('Code point must be in range 0x0 to 0xD7FF or 0xE000 to 0x10FFFF.'); } elseif (!\extension_loaded('iconv')) { throw new Nette\NotSupportedException(__METHOD__ . '() requires ICONV extension that is not loaded.'); } return \iconv('UTF-32BE', 'UTF-8//IGNORE', \pack('N', $code)); } /** * Starts the $haystack string with the prefix $needle? */ public static function startsWith(string $haystack, string $needle) : bool { return \strncmp($haystack, $needle, strlen($needle)) === 0; } /** * Ends the $haystack string with the suffix $needle? */ public static function endsWith(string $haystack, string $needle) : bool { return $needle === '' || \substr($haystack, -strlen($needle)) === $needle; } /** * Does $haystack contain $needle? */ public static function contains(string $haystack, string $needle) : bool { return \strpos($haystack, $needle) !== \false; } /** * Returns a part of UTF-8 string specified by starting position and length. If start is negative, * the returned string will start at the start'th character from the end of string. */ public static function substring(string $s, int $start, ?int $length = null) : string { if (\function_exists('mb_substr')) { return \mb_substr($s, $start, $length, 'UTF-8'); // MB is much faster } elseif (!\extension_loaded('iconv')) { throw new Nette\NotSupportedException(__METHOD__ . '() requires extension ICONV or MBSTRING, neither is loaded.'); } elseif ($length === null) { $length = self::length($s); } elseif ($start < 0 && $length < 0) { $start += self::length($s); // unifies iconv_substr behavior with mb_substr } return \iconv_substr($s, $start, $length, 'UTF-8'); } /** * Removes control characters, normalizes line breaks to `\n`, removes leading and trailing blank lines, * trims end spaces on lines, normalizes UTF-8 to the normal form of NFC. */ public static function normalize(string $s) : string { // convert to compressed normal form (NFC) if (\class_exists('Normalizer', \false) && ($n = \Normalizer::normalize($s, \Normalizer::FORM_C)) !== \false) { $s = $n; } $s = self::normalizeNewLines($s); // remove control characters; leave \t + \n $s = self::pcre('preg_replace', ['#[\\x00-\\x08\\x0B-\\x1F\\x7F-\\x9F]+#u', '', $s]); // right trim $s = self::pcre('preg_replace', ['#[\\t ]+$#m', '', $s]); // leading and trailing blank lines $s = \trim($s, "\n"); return $s; } /** * Standardize line endings to unix-like. */ public static function normalizeNewLines(string $s) : string { return \str_replace(["\r\n", "\r"], "\n", $s); } /** * Converts UTF-8 string to ASCII, ie removes diacritics etc. */ public static function toAscii(string $s) : string { $iconv = \defined('ICONV_IMPL') ? \trim(\ICONV_IMPL, '"\'') : null; static $transliterator = null; if ($transliterator === null) { if (\class_exists('Transliterator', \false)) { $transliterator = \Transliterator::create('Any-Latin; Latin-ASCII'); } else { \trigger_error(__METHOD__ . "(): it is recommended to enable PHP extensions 'intl'.", \E_USER_NOTICE); $transliterator = \false; } } // remove control characters and check UTF-8 validity $s = self::pcre('preg_replace', ['#[^\\x09\\x0A\\x0D\\x20-\\x7E\\xA0-\\x{2FF}\\x{370}-\\x{10FFFF}]#u', '', $s]); // transliteration (by Transliterator and iconv) is not optimal, replace some characters directly $s = \strtr($s, ["„" => '"', "“" => '"', "”" => '"', "‚" => "'", "‘" => "'", "’" => "'", "°" => '^', "Я" => 'Ya', "я" => 'ya', "Ю" => 'Yu', "ю" => 'yu', "Ä" => 'Ae', "Ö" => 'Oe', "Ü" => 'Ue', "ẞ" => 'Ss', "ä" => 'ae', "ö" => 'oe', "ü" => 'ue', "ß" => 'ss']); // „ “ ” ‚ ‘ ’ ° Я я Ю ю Ä Ö Ü ẞ ä ö ü ß if ($iconv !== 'libiconv') { $s = \strtr($s, ["®" => '(R)', "©" => '(c)', "…" => '...', "«" => '<<', "»" => '>>', "£" => 'lb', "¥" => 'yen', "²" => '^2', "³" => '^3', "µ" => 'u', "¹" => '^1', "º" => 'o', "¿" => '?', "ˊ" => "'", "ˍ" => '_', "˝" => '"', "`" => '', "€" => 'EUR', "™" => 'TM', "℮" => 'e', "←" => '<-', "↑" => '^', "→" => '->', "↓" => 'V', "↔" => '<->']); // ® © … « » £ ¥ ² ³ µ ¹ º ¿ ˊ ˍ ˝ ` € ™ ℮ ← ↑ → ↓ ↔ } if ($transliterator) { $s = $transliterator->transliterate($s); // use iconv because The transliterator leaves some characters out of ASCII, eg → ʾ if ($iconv === 'glibc') { $s = \strtr($s, '?', "\x01"); // temporarily hide ? to distinguish them from the garbage that iconv creates $s = \iconv('UTF-8', 'ASCII//TRANSLIT//IGNORE', $s); $s = \str_replace(['?', "\x01"], ['', '?'], $s); // remove garbage and restore ? characters } elseif ($iconv === 'libiconv') { $s = \iconv('UTF-8', 'ASCII//TRANSLIT//IGNORE', $s); } else { // null or 'unknown' (#216) $s = self::pcre('preg_replace', ['#[^\\x00-\\x7F]++#', '', $s]); // remove non-ascii chars } } elseif ($iconv === 'glibc' || $iconv === 'libiconv') { // temporarily hide these characters to distinguish them from the garbage that iconv creates $s = \strtr($s, '`\'"^~?', "\x01\x02\x03\x04\x05\x06"); if ($iconv === 'glibc') { // glibc implementation is very limited. transliterate into Windows-1250 and then into ASCII, so most Eastern European characters are preserved $s = \iconv('UTF-8', 'WINDOWS-1250//TRANSLIT//IGNORE', $s); $s = \strtr($s, "\xa5\xa3\xbc\x8c\xa7\x8a\xaa\x8d\x8f\x8e\xaf\xb9\xb3\xbe\x9c\x9a\xba\x9d\x9f\x9e\xbf\xc0\xc1\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xcb\xcc\xcd\xce\xcf\xd0\xd1\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xdb\xdc\xdd\xde\xdf\xe0\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xeb\xec\xed\xee\xef\xf0\xf1\xf2\xf3\xf4\xf5\xf6\xf8\xf9\xfa\xfb\xfc\xfd\xfe\x96\xa0\x8b\x97\x9b\xa6\xad\xb7", 'ALLSSSSTZZZallssstzzzRAAAALCCCEEEEIIDDNNOOOOxRUUUUYTsraaaalccceeeeiiddnnooooruuuuyt- <->|-.'); $s = self::pcre('preg_replace', ['#[^\\x00-\\x7F]++#', '', $s]); } else { $s = \iconv('UTF-8', 'ASCII//TRANSLIT//IGNORE', $s); } // remove garbage that iconv creates during transliteration (eg Ý -> Y') $s = \str_replace(['`', "'", '"', '^', '~', '?'], '', $s); // restore temporarily hidden characters $s = \strtr($s, "\x01\x02\x03\x04\x05\x06", '`\'"^~?'); } else { $s = self::pcre('preg_replace', ['#[^\\x00-\\x7F]++#', '', $s]); // remove non-ascii chars } return $s; } /** * Modifies the UTF-8 string to the form used in the URL, ie removes diacritics and replaces all characters * except letters of the English alphabet and numbers with a hyphens. */ public static function webalize(string $s, ?string $charlist = null, bool $lower = \true) : string { $s = self::toAscii($s); if ($lower) { $s = \strtolower($s); } $s = self::pcre('preg_replace', ['#[^a-z0-9' . ($charlist !== null ? \preg_quote($charlist, '#') : '') . ']+#i', '-', $s]); $s = \trim($s, '-'); return $s; } /** * Truncates a UTF-8 string to given maximal length, while trying not to split whole words. Only if the string is truncated, * an ellipsis (or something else set with third argument) is appended to the string. */ public static function truncate(string $s, int $maxLen, string $append = "…") : string { if (self::length($s) > $maxLen) { $maxLen -= self::length($append); if ($maxLen < 1) { return $append; } elseif ($matches = self::match($s, '#^.{1,' . $maxLen . '}(?=[\\s\\x00-/:-@\\[-`{-~])#us')) { return $matches[0] . $append; } else { return self::substring($s, 0, $maxLen) . $append; } } return $s; } /** * Indents a multiline text from the left. Second argument sets how many indentation chars should be used, * while the indent itself is the third argument (*tab* by default). */ public static function indent(string $s, int $level = 1, string $chars = "\t") : string { if ($level > 0) { $s = self::replace($s, '#(?:^|[\\r\\n]+)(?=[^\\r\\n])#', '$0' . \str_repeat($chars, $level)); } return $s; } /** * Converts all characters of UTF-8 string to lower case. */ public static function lower(string $s) : string { return \mb_strtolower($s, 'UTF-8'); } /** * Converts the first character of a UTF-8 string to lower case and leaves the other characters unchanged. */ public static function firstLower(string $s) : string { return self::lower(self::substring($s, 0, 1)) . self::substring($s, 1); } /** * Converts all characters of a UTF-8 string to upper case. */ public static function upper(string $s) : string { return \mb_strtoupper($s, 'UTF-8'); } /** * Converts the first character of a UTF-8 string to upper case and leaves the other characters unchanged. */ public static function firstUpper(string $s) : string { return self::upper(self::substring($s, 0, 1)) . self::substring($s, 1); } /** * Converts the first character of every word of a UTF-8 string to upper case and the others to lower case. */ public static function capitalize(string $s) : string { return \mb_convert_case($s, \MB_CASE_TITLE, 'UTF-8'); } /** * Compares two UTF-8 strings or their parts, without taking character case into account. If length is null, whole strings are compared, * if it is negative, the corresponding number of characters from the end of the strings is compared, * otherwise the appropriate number of characters from the beginning is compared. */ public static function compare(string $left, string $right, ?int $length = null) : bool { if (\class_exists('Normalizer', \false)) { $left = \Normalizer::normalize($left, \Normalizer::FORM_D); // form NFD is faster $right = \Normalizer::normalize($right, \Normalizer::FORM_D); // form NFD is faster } if ($length < 0) { $left = self::substring($left, $length, -$length); $right = self::substring($right, $length, -$length); } elseif ($length !== null) { $left = self::substring($left, 0, $length); $right = self::substring($right, 0, $length); } return self::lower($left) === self::lower($right); } /** * Finds the common prefix of strings or returns empty string if the prefix was not found. * @param string[] $strings */ public static function findPrefix(array $strings) : string { $first = \array_shift($strings); for ($i = 0; $i < strlen($first); $i++) { foreach ($strings as $s) { if (!isset($s[$i]) || $first[$i] !== $s[$i]) { while ($i && $first[$i - 1] >= "\x80" && $first[$i] >= "\x80" && $first[$i] < "\xc0") { $i--; } return \substr($first, 0, $i); } } } return $first; } /** * Returns number of characters (not bytes) in UTF-8 string. * That is the number of Unicode code points which may differ from the number of graphemes. */ public static function length(string $s) : int { return \function_exists('mb_strlen') ? \mb_strlen($s, 'UTF-8') : strlen(\utf8_decode($s)); } /** * Removes all left and right side spaces (or the characters passed as second argument) from a UTF-8 encoded string. */ public static function trim(string $s, string $charlist = self::TRIM_CHARACTERS) : string { $charlist = \preg_quote($charlist, '#'); return self::replace($s, '#^[' . $charlist . ']+|[' . $charlist . ']+$#Du', ''); } /** * Pads a UTF-8 string to given length by prepending the $pad string to the beginning. */ public static function padLeft(string $s, int $length, string $pad = ' ') : string { $length = \max(0, $length - self::length($s)); $padLen = self::length($pad); return \str_repeat($pad, (int) ($length / $padLen)) . self::substring($pad, 0, $length % $padLen) . $s; } /** * Pads UTF-8 string to given length by appending the $pad string to the end. */ public static function padRight(string $s, int $length, string $pad = ' ') : string { $length = \max(0, $length - self::length($s)); $padLen = self::length($pad); return $s . \str_repeat($pad, (int) ($length / $padLen)) . self::substring($pad, 0, $length % $padLen); } /** * Reverses UTF-8 string. */ public static function reverse(string $s) : string { if (!\extension_loaded('iconv')) { throw new Nette\NotSupportedException(__METHOD__ . '() requires ICONV extension that is not loaded.'); } return \iconv('UTF-32LE', 'UTF-8', \strrev(\iconv('UTF-8', 'UTF-32BE', $s))); } /** * Returns part of $haystack before $nth occurence of $needle or returns null if the needle was not found. * Negative value means searching from the end. */ public static function before(string $haystack, string $needle, int $nth = 1) : ?string { $pos = self::pos($haystack, $needle, $nth); return $pos === null ? null : \substr($haystack, 0, $pos); } /** * Returns part of $haystack after $nth occurence of $needle or returns null if the needle was not found. * Negative value means searching from the end. */ public static function after(string $haystack, string $needle, int $nth = 1) : ?string { $pos = self::pos($haystack, $needle, $nth); return $pos === null ? null : \substr($haystack, $pos + strlen($needle)); } /** * Returns position in characters of $nth occurence of $needle in $haystack or null if the $needle was not found. * Negative value of `$nth` means searching from the end. */ public static function indexOf(string $haystack, string $needle, int $nth = 1) : ?int { $pos = self::pos($haystack, $needle, $nth); return $pos === null ? null : self::length(\substr($haystack, 0, $pos)); } /** * Returns position in characters of $nth occurence of $needle in $haystack or null if the needle was not found. */ private static function pos(string $haystack, string $needle, int $nth = 1) : ?int { if (!$nth) { return null; } elseif ($nth > 0) { if ($needle === '') { return 0; } $pos = 0; while (($pos = \strpos($haystack, $needle, $pos)) !== \false && --$nth) { $pos++; } } else { $len = strlen($haystack); if ($needle === '') { return $len; } elseif ($len === 0) { return null; } $pos = $len - 1; while (($pos = \strrpos($haystack, $needle, $pos - $len)) !== \false && ++$nth) { $pos--; } } return Helpers::falseToNull($pos); } /** * Splits a string into array by the regular expression. Parenthesized expression in the delimiter are captured. * Parameter $flags can be any combination of PREG_SPLIT_NO_EMPTY and PREG_OFFSET_CAPTURE flags. */ public static function split(string $subject, string $pattern, int $flags = 0) : array { return self::pcre('preg_split', [$pattern, $subject, -1, $flags | \PREG_SPLIT_DELIM_CAPTURE]); } /** * Checks if given string matches a regular expression pattern and returns an array with first found match and each subpattern. * Parameter $flags can be any combination of PREG_OFFSET_CAPTURE and PREG_UNMATCHED_AS_NULL flags. */ public static function match(string $subject, string $pattern, int $flags = 0, int $offset = 0) : ?array { if ($offset > strlen($subject)) { return null; } return self::pcre('preg_match', [$pattern, $subject, &$m, $flags, $offset]) ? $m : null; } /** * Finds all occurrences matching regular expression pattern and returns a two-dimensional array. Result is array of matches (ie uses by default PREG_SET_ORDER). * Parameter $flags can be any combination of PREG_OFFSET_CAPTURE, PREG_UNMATCHED_AS_NULL and PREG_PATTERN_ORDER flags. */ public static function matchAll(string $subject, string $pattern, int $flags = 0, int $offset = 0) : array { if ($offset > strlen($subject)) { return []; } self::pcre('preg_match_all', [$pattern, $subject, &$m, $flags & \PREG_PATTERN_ORDER ? $flags : $flags | \PREG_SET_ORDER, $offset]); return $m; } /** * Replaces all occurrences matching regular expression $pattern which can be string or array in the form `pattern => replacement`. * @param string|array $pattern * @param string|callable $replacement */ public static function replace(string $subject, $pattern, $replacement = '', int $limit = -1) : string { if (is_object($replacement) || is_array($replacement)) { if (!\is_callable($replacement, \false, $textual)) { throw new Nette\InvalidStateException("Callback '{$textual}' is not callable."); } return self::pcre('preg_replace_callback', [$pattern, $replacement, $subject, $limit]); } elseif (is_array($pattern) && \is_string(\key($pattern))) { $replacement = \array_values($pattern); $pattern = \array_keys($pattern); } return self::pcre('preg_replace', [$pattern, $replacement, $subject, $limit]); } /** @internal */ public static function pcre(string $func, array $args) { $res = Callback::invokeSafe($func, $args, function (string $message) use($args) : void { // compile-time error, not detectable by preg_last_error throw new RegexpException($message . ' in pattern: ' . \implode(' or ', (array) $args[0])); }); if (($code = \preg_last_error()) && ($res === null || !\in_array($func, ['preg_filter', 'preg_replace_callback', 'preg_replace'], \true))) { throw new RegexpException((RegexpException::MESSAGES[$code] ?? 'Unknown error') . ' (pattern: ' . \implode(' or ', (array) $args[0]) . ')', $code); } return $res; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Utils; use _PHPStan_7d8742a37\Nette; use function is_array, is_int, is_object, count; /** * Array tools library. */ class Arrays { use Nette\StaticClass; /** * Returns item from array. If it does not exist, it throws an exception, unless a default value is set. * @template T * @param array<T> $array * @param array-key|array-key[] $key * @param ?T $default * @return ?T * @throws Nette\InvalidArgumentException if item does not exist and default value is not provided */ public static function get(array $array, $key, $default = null) { foreach (is_array($key) ? $key : [$key] as $k) { if (is_array($array) && \array_key_exists($k, $array)) { $array = $array[$k]; } else { if (\func_num_args() < 3) { throw new Nette\InvalidArgumentException("Missing item '{$k}'."); } return $default; } } return $array; } /** * Returns reference to array item. If the index does not exist, new one is created with value null. * @template T * @param array<T> $array * @param array-key|array-key[] $key * @return ?T * @throws Nette\InvalidArgumentException if traversed item is not an array */ public static function &getRef(array &$array, $key) { foreach (is_array($key) ? $key : [$key] as $k) { if (is_array($array) || $array === null) { $array =& $array[$k]; } else { throw new Nette\InvalidArgumentException('Traversed item is not an array.'); } } return $array; } /** * Recursively merges two fields. It is useful, for example, for merging tree structures. It behaves as * the + operator for array, ie. it adds a key/value pair from the second array to the first one and retains * the value from the first array in the case of a key collision. * @template T1 * @template T2 * @param array<T1> $array1 * @param array<T2> $array2 * @return array<T1|T2> */ public static function mergeTree(array $array1, array $array2) : array { $res = $array1 + $array2; foreach (\array_intersect_key($array1, $array2) as $k => $v) { if (is_array($v) && is_array($array2[$k])) { $res[$k] = self::mergeTree($v, $array2[$k]); } } return $res; } /** * Returns zero-indexed position of given array key. Returns null if key is not found. * @param array-key $key * @return int|null offset if it is found, null otherwise */ public static function getKeyOffset(array $array, $key) : ?int { return Helpers::falseToNull(\array_search(self::toKey($key), \array_keys($array), \true)); } /** * @deprecated use getKeyOffset() */ public static function searchKey(array $array, $key) : ?int { return self::getKeyOffset($array, $key); } /** * Tests an array for the presence of value. * @param mixed $value */ public static function contains(array $array, $value) : bool { return \in_array($value, $array, \true); } /** * Returns the first item from the array or null if array is empty. * @template T * @param array<T> $array * @return ?T */ public static function first(array $array) { return count($array) ? \reset($array) : null; } /** * Returns the last item from the array or null if array is empty. * @template T * @param array<T> $array * @return ?T */ public static function last(array $array) { return count($array) ? \end($array) : null; } /** * Inserts the contents of the $inserted array into the $array immediately after the $key. * If $key is null (or does not exist), it is inserted at the beginning. * @param array-key|null $key */ public static function insertBefore(array &$array, $key, array $inserted) : void { $offset = $key === null ? 0 : (int) self::getKeyOffset($array, $key); $array = \array_slice($array, 0, $offset, \true) + $inserted + \array_slice($array, $offset, count($array), \true); } /** * Inserts the contents of the $inserted array into the $array before the $key. * If $key is null (or does not exist), it is inserted at the end. * @param array-key|null $key */ public static function insertAfter(array &$array, $key, array $inserted) : void { if ($key === null || ($offset = self::getKeyOffset($array, $key)) === null) { $offset = count($array) - 1; } $array = \array_slice($array, 0, $offset + 1, \true) + $inserted + \array_slice($array, $offset + 1, count($array), \true); } /** * Renames key in array. * @param array-key $oldKey * @param array-key $newKey */ public static function renameKey(array &$array, $oldKey, $newKey) : bool { $offset = self::getKeyOffset($array, $oldKey); if ($offset === null) { return \false; } $val =& $array[$oldKey]; $keys = \array_keys($array); $keys[$offset] = $newKey; $array = \array_combine($keys, $array); $array[$newKey] =& $val; return \true; } /** * Returns only those array items, which matches a regular expression $pattern. * @param string[] $array * @return string[] */ public static function grep(array $array, string $pattern, int $flags = 0) : array { return Strings::pcre('preg_grep', [$pattern, $array, $flags]); } /** * Transforms multidimensional array to flat array. */ public static function flatten(array $array, bool $preserveKeys = \false) : array { $res = []; $cb = $preserveKeys ? function ($v, $k) use(&$res) : void { $res[$k] = $v; } : function ($v) use(&$res) : void { $res[] = $v; }; \array_walk_recursive($array, $cb); return $res; } /** * Checks if the array is indexed in ascending order of numeric keys from zero, a.k.a list. * @param mixed $value */ public static function isList($value) : bool { return is_array($value) && (\PHP_VERSION_ID < 80100 ? !$value || \array_keys($value) === \range(0, count($value) - 1) : \array_is_list($value)); } /** * Reformats table to associative tree. Path looks like 'field|field[]field->field=field'. * @param string|string[] $path * @return array|\stdClass */ public static function associate(array $array, $path) { $parts = is_array($path) ? $path : \preg_split('#(\\[\\]|->|=|\\|)#', $path, -1, \PREG_SPLIT_DELIM_CAPTURE | \PREG_SPLIT_NO_EMPTY); if (!$parts || $parts === ['->'] || $parts[0] === '=' || $parts[0] === '|') { throw new Nette\InvalidArgumentException("Invalid path '{$path}'."); } $res = $parts[0] === '->' ? new \stdClass() : []; foreach ($array as $rowOrig) { $row = (array) $rowOrig; $x =& $res; for ($i = 0; $i < count($parts); $i++) { $part = $parts[$i]; if ($part === '[]') { $x =& $x[]; } elseif ($part === '=') { if (isset($parts[++$i])) { $x = $row[$parts[$i]]; $row = null; } } elseif ($part === '->') { if (isset($parts[++$i])) { if ($x === null) { $x = new \stdClass(); } $x =& $x->{$row[$parts[$i]]}; } else { $row = is_object($rowOrig) ? $rowOrig : (object) $row; } } elseif ($part !== '|') { $x =& $x[(string) $row[$part]]; } } if ($x === null) { $x = $row; } } return $res; } /** * Normalizes array to associative array. Replace numeric keys with their values, the new value will be $filling. * @param mixed $filling */ public static function normalize(array $array, $filling = null) : array { $res = []; foreach ($array as $k => $v) { $res[is_int($k) ? $v : $k] = is_int($k) ? $filling : $v; } return $res; } /** * Returns and removes the value of an item from an array. If it does not exist, it throws an exception, * or returns $default, if provided. * @template T * @param array<T> $array * @param array-key $key * @param ?T $default * @return ?T * @throws Nette\InvalidArgumentException if item does not exist and default value is not provided */ public static function pick(array &$array, $key, $default = null) { if (\array_key_exists($key, $array)) { $value = $array[$key]; unset($array[$key]); return $value; } elseif (\func_num_args() < 3) { throw new Nette\InvalidArgumentException("Missing item '{$key}'."); } else { return $default; } } /** * Tests whether at least one element in the array passes the test implemented by the * provided callback with signature `function ($value, $key, array $array): bool`. */ public static function some(iterable $array, callable $callback) : bool { foreach ($array as $k => $v) { if ($callback($v, $k, $array)) { return \true; } } return \false; } /** * Tests whether all elements in the array pass the test implemented by the provided function, * which has the signature `function ($value, $key, array $array): bool`. */ public static function every(iterable $array, callable $callback) : bool { foreach ($array as $k => $v) { if (!$callback($v, $k, $array)) { return \false; } } return \true; } /** * Calls $callback on all elements in the array and returns the array of return values. * The callback has the signature `function ($value, $key, array $array): bool`. */ public static function map(iterable $array, callable $callback) : array { $res = []; foreach ($array as $k => $v) { $res[$k] = $callback($v, $k, $array); } return $res; } /** * Invokes all callbacks and returns array of results. * @param callable[] $callbacks */ public static function invoke(iterable $callbacks, ...$args) : array { $res = []; foreach ($callbacks as $k => $cb) { $res[$k] = $cb(...$args); } return $res; } /** * Invokes method on every object in an array and returns array of results. * @param object[] $objects */ public static function invokeMethod(iterable $objects, string $method, ...$args) : array { $res = []; foreach ($objects as $k => $obj) { $res[$k] = $obj->{$method}(...$args); } return $res; } /** * Copies the elements of the $array array to the $object object and then returns it. * @template T of object * @param T $object * @return T */ public static function toObject(iterable $array, $object) { foreach ($array as $k => $v) { $object->{$k} = $v; } return $object; } /** * Converts value to array key. * @param mixed $value * @return array-key */ public static function toKey($value) { return \key([$value => null]); } /** * Returns copy of the $array where every item is converted to string * and prefixed by $prefix and suffixed by $suffix. * @param string[] $array * @return string[] */ public static function wrap(array $array, string $prefix = '', string $suffix = '') : array { $res = []; foreach ($array as $k => $v) { $res[$k] = $prefix . $v . $suffix; } return $res; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette; interface HtmlStringable { /** * Returns string in HTML format */ function __toString() : string; } \interface_exists(Utils\IHtmlString::class); <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette; /** * The exception that is thrown when the value of an argument is * outside the allowable range of values as defined by the invoked method. */ class ArgumentOutOfRangeException extends \InvalidArgumentException { } /** * The exception that is thrown when a method call is invalid for the object's * current state, method has been invoked at an illegal or inappropriate time. */ class InvalidStateException extends \RuntimeException { } /** * The exception that is thrown when a requested method or operation is not implemented. */ class NotImplementedException extends \LogicException { } /** * The exception that is thrown when an invoked method is not supported. For scenarios where * it is sometimes possible to perform the requested operation, see InvalidStateException. */ class NotSupportedException extends \LogicException { } /** * The exception that is thrown when a requested method or operation is deprecated. */ class DeprecatedException extends NotSupportedException { } /** * The exception that is thrown when accessing a class member (property or method) fails. */ class MemberAccessException extends \Error { } /** * The exception that is thrown when an I/O error occurs. */ class IOException extends \RuntimeException { } /** * The exception that is thrown when accessing a file that does not exist on disk. */ class FileNotFoundException extends IOException { } /** * The exception that is thrown when part of a file or directory cannot be found. */ class DirectoryNotFoundException extends IOException { } /** * The exception that is thrown when an argument does not match with the expected value. */ class InvalidArgumentException extends \InvalidArgumentException { } /** * The exception that is thrown when an illegal index was requested. */ class OutOfRangeException extends \OutOfRangeException { } /** * The exception that is thrown when a value (typically returned by function) does not match with the expected value. */ class UnexpectedValueException extends \UnexpectedValueException { } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Iterators; use _PHPStan_7d8742a37\Nette; /** * Smarter caching iterator. * * @property-read bool $first * @property-read bool $last * @property-read bool $empty * @property-read bool $odd * @property-read bool $even * @property-read int $counter * @property-read mixed $nextKey * @property-read mixed $nextValue */ class CachingIterator extends \CachingIterator implements \Countable { use Nette\SmartObject; /** @var int */ private $counter = 0; public function __construct($iterator) { if (\is_array($iterator) || $iterator instanceof \stdClass) { $iterator = new \ArrayIterator($iterator); } elseif ($iterator instanceof \IteratorAggregate) { do { $iterator = $iterator->getIterator(); } while ($iterator instanceof \IteratorAggregate); \assert($iterator instanceof \Iterator); } elseif ($iterator instanceof \Iterator) { } elseif ($iterator instanceof \Traversable) { $iterator = new \IteratorIterator($iterator); } else { throw new Nette\InvalidArgumentException(\sprintf('Invalid argument passed to %s; array or Traversable expected, %s given.', self::class, \is_object($iterator) ? \get_class($iterator) : \gettype($iterator))); } parent::__construct($iterator, 0); } /** * Is the current element the first one? */ public function isFirst(?int $gridWidth = null) : bool { return $this->counter === 1 || $gridWidth && $this->counter !== 0 && ($this->counter - 1) % $gridWidth === 0; } /** * Is the current element the last one? */ public function isLast(?int $gridWidth = null) : bool { return !$this->hasNext() || $gridWidth && $this->counter % $gridWidth === 0; } /** * Is the iterator empty? */ public function isEmpty() : bool { return $this->counter === 0; } /** * Is the counter odd? */ public function isOdd() : bool { return $this->counter % 2 === 1; } /** * Is the counter even? */ public function isEven() : bool { return $this->counter % 2 === 0; } /** * Returns the counter. */ public function getCounter() : int { return $this->counter; } /** * Returns the count of elements. */ public function count() : int { $inner = $this->getInnerIterator(); if ($inner instanceof \Countable) { return $inner->count(); } else { throw new Nette\NotSupportedException('Iterator is not countable.'); } } /** * Forwards to the next element. */ public function next() : void { parent::next(); if (parent::valid()) { $this->counter++; } } /** * Rewinds the Iterator. */ public function rewind() : void { parent::rewind(); $this->counter = parent::valid() ? 1 : 0; } /** * Returns the next key. * @return mixed */ public function getNextKey() { return $this->getInnerIterator()->key(); } /** * Returns the next element. * @return mixed */ public function getNextValue() { return $this->getInnerIterator()->current(); } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Iterators; /** * Applies the callback to the elements of the inner iterator. */ class Mapper extends \IteratorIterator { /** @var callable */ private $callback; public function __construct(\Traversable $iterator, callable $callback) { parent::__construct($iterator); $this->callback = $callback; } #[\ReturnTypeWillChange] public function current() { return ($this->callback)(parent::current(), parent::key()); } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Utils; use _PHPStan_7d8742a37\Nette; if (\false) { /** @deprecated use Nette\HtmlStringable */ interface IHtmlString extends Nette\HtmlStringable { } } elseif (!\interface_exists(IHtmlString::class)) { \class_alias(Nette\HtmlStringable::class, IHtmlString::class); } namespace _PHPStan_7d8742a37\Nette\Localization; if (\false) { /** @deprecated use Nette\Localization\Translator */ interface ITranslator extends Translator { } } elseif (!\interface_exists(ITranslator::class)) { \class_alias(Translator::class, ITranslator::class); } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Localization; /** * Translator adapter. */ interface Translator { /** * Translates the given string. * @param mixed $message * @param mixed ...$parameters */ function translate($message, ...$parameters) : string; } \interface_exists(ITranslator::class); <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette; /** * Static class. */ trait StaticClass { /** * @return never * @throws \Error */ public final function __construct() { throw new \Error('Class ' . static::class . ' is static and cannot be instantiated.'); } /** * Call to undefined static method. * @return void * @throws MemberAccessException */ public static function __callStatic(string $name, array $args) { Utils\ObjectHelpers::strictStaticCall(static::class, $name); } } <?php /** * Rules for Nette Coding Standard * https://github.com/nette/coding-standard */ declare (strict_types=1); namespace _PHPStan_7d8742a37; return [ // use function in Arrays.php, Callback.php, Html.php, Strings.php 'single_import_per_statement' => \false, 'ordered_imports' => \false, ]; <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Schema; use _PHPStan_7d8742a37\Nette; final class Context { use Nette\SmartObject; /** @var bool */ public $skipDefaults = \false; /** @var string[] */ public $path = []; /** @var bool */ public $isKey = \false; /** @var Message[] */ public $errors = []; /** @var Message[] */ public $warnings = []; /** @var array[] */ public $dynamics = []; public function addError(string $message, string $code, array $variables = []) : Message { $variables['isKey'] = $this->isKey; return $this->errors[] = new Message($message, $code, $this->path, $variables); } public function addWarning(string $message, string $code, array $variables = []) : Message { return $this->warnings[] = new Message($message, $code, $this->path, $variables); } /** @return \Closure(): bool */ public function createChecker() : \Closure { $count = \count($this->errors); return function () use($count) : bool { return $count === \count($this->errors); }; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Schema; use _PHPStan_7d8742a37\Nette; /** * Validation error. */ class ValidationException extends Nette\InvalidStateException { /** @var Message[] */ private $messages; /** * @param Message[] $messages */ public function __construct(?string $message, array $messages = []) { parent::__construct($message ?: $messages[0]->toString()); $this->messages = $messages; } /** * @return string[] */ public function getMessages() : array { $res = []; foreach ($this->messages as $message) { $res[] = $message->toString(); } return $res; } /** * @return Message[] */ public function getMessageObjects() : array { return $this->messages; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Schema; interface DynamicParameter { } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Schema; use _PHPStan_7d8742a37\Nette; /** * Schema validator. */ final class Processor { use Nette\SmartObject; /** @var array */ public $onNewContext = []; /** @var Context|null */ private $context; /** @var bool */ private $skipDefaults; public function skipDefaults(bool $value = \true) { $this->skipDefaults = $value; } /** * Normalizes and validates data. Result is a clean completed data. * @return mixed * @throws ValidationException */ public function process(Schema $schema, $data) { $this->createContext(); $data = $schema->normalize($data, $this->context); $this->throwsErrors(); $data = $schema->complete($data, $this->context); $this->throwsErrors(); return $data; } /** * Normalizes and validates and merges multiple data. Result is a clean completed data. * @return mixed * @throws ValidationException */ public function processMultiple(Schema $schema, array $dataset) { $this->createContext(); $flatten = null; $first = \true; foreach ($dataset as $data) { $data = $schema->normalize($data, $this->context); $this->throwsErrors(); $flatten = $first ? $data : $schema->merge($data, $flatten); $first = \false; } $data = $schema->complete($flatten, $this->context); $this->throwsErrors(); return $data; } /** * @return string[] */ public function getWarnings() : array { $res = []; foreach ($this->context->warnings as $message) { $res[] = $message->toString(); } return $res; } private function throwsErrors() : void { if ($this->context->errors) { throw new ValidationException(null, $this->context->errors); } } private function createContext() { $this->context = new Context(); $this->context->skipDefaults = $this->skipDefaults; $this->onNewContext($this->context); } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Schema; use _PHPStan_7d8742a37\Nette; final class Message { use Nette\SmartObject; /** variables: {value: mixed, expected: string} */ public const TypeMismatch = 'schema.typeMismatch'; /** variables: {value: mixed, expected: string} */ public const ValueOutOfRange = 'schema.valueOutOfRange'; /** variables: {value: mixed, length: int, expected: string} */ public const LengthOutOfRange = 'schema.lengthOutOfRange'; /** variables: {value: string, pattern: string} */ public const PatternMismatch = 'schema.patternMismatch'; /** variables: {value: mixed, assertion: string} */ public const FailedAssertion = 'schema.failedAssertion'; /** no variables */ public const MissingItem = 'schema.missingItem'; /** variables: {hint: string} */ public const UnexpectedItem = 'schema.unexpectedItem'; /** no variables */ public const Deprecated = 'schema.deprecated'; /** Deprecated */ public const TYPE_MISMATCH = self::TypeMismatch; public const VALUE_OUT_OF_RANGE = self::ValueOutOfRange; public const LENGTH_OUT_OF_RANGE = self::LengthOutOfRange; public const PATTERN_MISMATCH = self::PatternMismatch; public const FAILED_ASSERTION = self::FailedAssertion; public const MISSING_ITEM = self::MissingItem; public const UNEXPECTED_ITEM = self::UnexpectedItem; public const DEPRECATED = self::Deprecated; /** @var string */ public $message; /** @var string */ public $code; /** @var string[] */ public $path; /** @var string[] */ public $variables; public function __construct(string $message, string $code, array $path, array $variables = []) { $this->message = $message; $this->code = $code; $this->path = $path; $this->variables = $variables; } public function toString() : string { $vars = $this->variables; $vars['label'] = empty($vars['isKey']) ? 'item' : 'key of item'; $vars['path'] = $this->path ? "'" . \implode(" › ", $this->path) . "'" : null; $vars['value'] = Helpers::formatValue($vars['value'] ?? null); return \preg_replace_callback('~( ?)%(\\w+)%~', function ($m) use($vars) { [, $space, $key] = $m; return $vars[$key] === null ? '' : $space . $vars[$key]; }, $this->message); } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Schema; use _PHPStan_7d8742a37\Nette; use _PHPStan_7d8742a37\Nette\Schema\Elements\AnyOf; use _PHPStan_7d8742a37\Nette\Schema\Elements\Structure; use _PHPStan_7d8742a37\Nette\Schema\Elements\Type; /** * Schema generator. * * @method static Type scalar($default = null) * @method static Type string($default = null) * @method static Type int($default = null) * @method static Type float($default = null) * @method static Type bool($default = null) * @method static Type null() * @method static Type array($default = []) * @method static Type list($default = []) * @method static Type mixed($default = null) * @method static Type email($default = null) * @method static Type unicode($default = null) */ final class Expect { use Nette\SmartObject; public static function __callStatic(string $name, array $args) : Type { $type = new Type($name); if ($args) { $type->default($args[0]); } return $type; } public static function type(string $type) : Type { return new Type($type); } /** * @param mixed|Schema ...$set */ public static function anyOf(...$set) : AnyOf { return new AnyOf(...$set); } /** * @param Schema[] $items */ public static function structure(array $items) : Structure { return new Structure($items); } /** * @param object $object */ public static function from($object, array $items = []) : Structure { $ro = new \ReflectionObject($object); foreach ($ro->getProperties() as $prop) { $type = Helpers::getPropertyType($prop) ?? 'mixed'; $item =& $items[$prop->getName()]; if (!$item) { $item = new Type($type); if (\PHP_VERSION_ID >= 70400 && !$prop->isInitialized($object)) { $item->required(); } else { $def = $prop->getValue($object); if (\is_object($def)) { $item = static::from($def); } elseif ($def === null && !Nette\Utils\Validators::is(null, $type)) { $item->required(); } else { $item->default($def); } } } } return (new Structure($items))->castTo($ro->getName()); } /** * @param string|Schema $valueType * @param string|Schema|null $keyType */ public static function arrayOf($valueType, $keyType = null) : Type { return (new Type('array'))->items($valueType, $keyType); } /** * @param string|Schema $type */ public static function listOf($type) : Type { return (new Type('list'))->items($type); } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Schema; interface Schema { /** * Normalization. * @return mixed */ function normalize($value, Context $context); /** * Merging. * @return mixed */ function merge($value, $base); /** * Validation and finalization. * @return mixed */ function complete($value, Context $context); /** * @return mixed */ function completeDefault(Context $context); } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Schema; use _PHPStan_7d8742a37\Nette; use _PHPStan_7d8742a37\Nette\Utils\Reflection; /** * @internal */ final class Helpers { use Nette\StaticClass; public const PreventMerging = '_prevent_merging'; public const PREVENT_MERGING = self::PreventMerging; /** * Merges dataset. Left has higher priority than right one. * @return array|string */ public static function merge($value, $base) { if (\is_array($value) && isset($value[self::PreventMerging])) { unset($value[self::PreventMerging]); return $value; } if (\is_array($value) && \is_array($base)) { $index = 0; foreach ($value as $key => $val) { if ($key === $index) { $base[] = $val; $index++; } else { $base[$key] = static::merge($val, $base[$key] ?? null); } } return $base; } elseif ($value === null && \is_array($base)) { return $base; } else { return $value; } } public static function getPropertyType(\ReflectionProperty $prop) : ?string { if (!\class_exists(Nette\Utils\Type::class)) { throw new Nette\NotSupportedException('Expect::from() requires nette/utils 3.x'); } elseif ($type = Nette\Utils\Type::fromReflection($prop)) { return (string) $type; } elseif ($type = \preg_replace('#\\s.*#', '', (string) self::parseAnnotation($prop, 'var'))) { $class = Reflection::getPropertyDeclaringClass($prop); return \preg_replace_callback('#[\\w\\\\]+#', function ($m) use($class) { return Reflection::expandClassName($m[0], $class); }, $type); } return null; } /** * Returns an annotation value. * @param \ReflectionProperty $ref */ public static function parseAnnotation(\Reflector $ref, string $name) : ?string { if (!Reflection::areCommentsAvailable()) { throw new Nette\InvalidStateException('You have to enable phpDoc comments in opcode cache.'); } $re = '#[\\s*]@' . \preg_quote($name, '#') . '(?=\\s|$)(?:[ \\t]+([^@\\s]\\S*))?#'; if ($ref->getDocComment() && \preg_match($re, \trim($ref->getDocComment(), '/*'), $m)) { return $m[1] ?? ''; } return null; } /** * @param mixed $value */ public static function formatValue($value) : string { if (\is_object($value)) { return 'object ' . \get_class($value); } elseif (\is_string($value)) { return "'" . Nette\Utils\Strings::truncate($value, 15, '...') . "'"; } elseif (\is_scalar($value)) { return \var_export($value, \true); } else { return \strtolower(\gettype($value)); } } public static function validateType($value, string $expected, Context $context) : void { if (!Nette\Utils\Validators::is($value, $expected)) { $expected = \str_replace(DynamicParameter::class . '|', '', $expected); $expected = \str_replace(['|', ':'], [' or ', ' in range '], $expected); $context->addError('The %label% %path% expects to be %expected%, %value% given.', Message::TypeMismatch, ['value' => $value, 'expected' => $expected]); } } public static function validateRange($value, array $range, Context $context, string $types = '') : void { if (\is_array($value) || \is_string($value)) { [$length, $label] = \is_array($value) ? [\count($value), 'items'] : (\in_array('unicode', \explode('|', $types), \true) ? [Nette\Utils\Strings::length($value), 'characters'] : [\strlen($value), 'bytes']); if (!self::isInRange($length, $range)) { $context->addError("The length of %label% %path% expects to be in range %expected%, %length% {$label} given.", Message::LengthOutOfRange, ['value' => $value, 'length' => $length, 'expected' => \implode('..', $range)]); } } elseif ((\is_int($value) || \is_float($value)) && !self::isInRange($value, $range)) { $context->addError('The %label% %path% expects to be in range %expected%, %value% given.', Message::ValueOutOfRange, ['value' => $value, 'expected' => \implode('..', $range)]); } } public static function isInRange($value, array $range) : bool { return ($range[0] === null || $value >= $range[0]) && ($range[1] === null || $value <= $range[1]); } public static function validatePattern(string $value, string $pattern, Context $context) : void { if (!\preg_match("\x01^(?:{$pattern})\$\x01Du", $value)) { $context->addError("The %label% %path% expects to match pattern '%pattern%', %value% given.", Message::PatternMismatch, ['value' => $value, 'pattern' => $pattern]); } } public static function getCastStrategy(string $type) : \Closure { if (Nette\Utils\Reflection::isBuiltinType($type)) { return static function ($value) use($type) { \settype($value, $type); return $value; }; } elseif (\method_exists($type, '__construct')) { return static function ($value) use($type) { if (\PHP_VERSION_ID < 80000 && \is_array($value)) { throw new Nette\NotSupportedException("Creating {$type} objects is supported since PHP 8.0"); } return \is_array($value) ? new $type(...$value) : new $type($value); }; } else { return static function ($value) use($type) { $object = new $type(); foreach ($value as $k => $v) { $object->{$k} = $v; } return $object; }; } } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Schema\Elements; use _PHPStan_7d8742a37\Nette; use _PHPStan_7d8742a37\Nette\Schema\Context; use _PHPStan_7d8742a37\Nette\Schema\DynamicParameter; use _PHPStan_7d8742a37\Nette\Schema\Helpers; use _PHPStan_7d8742a37\Nette\Schema\Schema; final class Type implements Schema { use Base; use Nette\SmartObject; /** @var string */ private $type; /** @var Schema|null for arrays */ private $itemsValue; /** @var Schema|null for arrays */ private $itemsKey; /** @var array{?float, ?float} */ private $range = [null, null]; /** @var string|null */ private $pattern; /** @var bool */ private $merge = \true; public function __construct(string $type) { $defaults = ['list' => [], 'array' => []]; $this->type = $type; $this->default = \strpos($type, '[]') ? [] : $defaults[$type] ?? null; } public function nullable() : self { $this->type = 'null|' . $this->type; return $this; } public function mergeDefaults(bool $state = \true) : self { $this->merge = $state; return $this; } public function dynamic() : self { $this->type = DynamicParameter::class . '|' . $this->type; return $this; } public function min(?float $min) : self { $this->range[0] = $min; return $this; } public function max(?float $max) : self { $this->range[1] = $max; return $this; } /** * @param string|Schema $valueType * @param string|Schema|null $keyType * @internal use arrayOf() or listOf() */ public function items($valueType = 'mixed', $keyType = null) : self { $this->itemsValue = $valueType instanceof Schema ? $valueType : new self($valueType); $this->itemsKey = $keyType instanceof Schema || $keyType === null ? $keyType : new self($keyType); return $this; } public function pattern(?string $pattern) : self { $this->pattern = $pattern; return $this; } /********************* processing ****************d*g**/ public function normalize($value, Context $context) { if ($prevent = \is_array($value) && isset($value[Helpers::PreventMerging])) { unset($value[Helpers::PreventMerging]); } $value = $this->doNormalize($value, $context); if (\is_array($value) && $this->itemsValue) { $res = []; foreach ($value as $key => $val) { $context->path[] = $key; $context->isKey = \true; $key = $this->itemsKey ? $this->itemsKey->normalize($key, $context) : $key; $context->isKey = \false; $res[$key] = $this->itemsValue->normalize($val, $context); \array_pop($context->path); } $value = $res; } if ($prevent && \is_array($value)) { $value[Helpers::PreventMerging] = \true; } return $value; } public function merge($value, $base) { if (\is_array($value) && isset($value[Helpers::PreventMerging])) { unset($value[Helpers::PreventMerging]); return $value; } if (\is_array($value) && \is_array($base) && $this->itemsValue) { $index = 0; foreach ($value as $key => $val) { if ($key === $index) { $base[] = $val; $index++; } else { $base[$key] = \array_key_exists($key, $base) ? $this->itemsValue->merge($val, $base[$key]) : $val; } } return $base; } return Helpers::merge($value, $base); } public function complete($value, Context $context) { $merge = $this->merge; if (\is_array($value) && isset($value[Helpers::PreventMerging])) { unset($value[Helpers::PreventMerging]); $merge = \false; } if ($value === null && \is_array($this->default)) { $value = []; // is unable to distinguish null from array in NEON } $this->doDeprecation($context); $isOk = $context->createChecker(); Helpers::validateType($value, $this->type, $context); $isOk() && Helpers::validateRange($value, $this->range, $context, $this->type); $isOk() && $value !== null && $this->pattern !== null && Helpers::validatePattern($value, $this->pattern, $context); $isOk() && \is_array($value) && $this->validateItems($value, $context); $isOk() && $merge && ($value = Helpers::merge($value, $this->default)); $isOk() && ($value = $this->doTransform($value, $context)); if (!$isOk()) { return null; } if ($value instanceof DynamicParameter) { $expected = $this->type . ($this->range === [null, null] ? '' : ':' . \implode('..', $this->range)); $context->dynamics[] = [$value, \str_replace(DynamicParameter::class . '|', '', $expected), $context->path]; } return $value; } private function validateItems(array &$value, Context $context) : void { if (!$this->itemsValue) { return; } $res = []; foreach ($value as $key => $val) { $context->path[] = $key; $context->isKey = \true; $key = $this->itemsKey ? $this->itemsKey->complete($key, $context) : $key; $context->isKey = \false; $res[$key] = $this->itemsValue->complete($val, $context); \array_pop($context->path); } $value = $res; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Schema\Elements; use _PHPStan_7d8742a37\Nette; use _PHPStan_7d8742a37\Nette\Schema\Context; use _PHPStan_7d8742a37\Nette\Schema\Helpers; use _PHPStan_7d8742a37\Nette\Schema\Schema; final class Structure implements Schema { use Base; use Nette\SmartObject; /** @var Schema[] */ private $items; /** @var Schema|null for array|list */ private $otherItems; /** @var array{?int, ?int} */ private $range = [null, null]; /** @var bool */ private $skipDefaults = \false; /** * @param Schema[] $items */ public function __construct(array $items) { (function (Schema ...$items) { })(...\array_values($items)); $this->items = $items; $this->castTo('object'); $this->required = \true; } public function default($value) : self { throw new Nette\InvalidStateException('Structure cannot have default value.'); } public function min(?int $min) : self { $this->range[0] = $min; return $this; } public function max(?int $max) : self { $this->range[1] = $max; return $this; } /** * @param string|Schema $type */ public function otherItems($type = 'mixed') : self { $this->otherItems = $type instanceof Schema ? $type : new Type($type); return $this; } public function skipDefaults(bool $state = \true) : self { $this->skipDefaults = $state; return $this; } /********************* processing ****************d*g**/ public function normalize($value, Context $context) { if ($prevent = \is_array($value) && isset($value[Helpers::PreventMerging])) { unset($value[Helpers::PreventMerging]); } $value = $this->doNormalize($value, $context); if (\is_object($value)) { $value = (array) $value; } if (\is_array($value)) { foreach ($value as $key => $val) { $itemSchema = $this->items[$key] ?? $this->otherItems; if ($itemSchema) { $context->path[] = $key; $value[$key] = $itemSchema->normalize($val, $context); \array_pop($context->path); } } if ($prevent) { $value[Helpers::PreventMerging] = \true; } } return $value; } public function merge($value, $base) { if (\is_array($value) && isset($value[Helpers::PreventMerging])) { unset($value[Helpers::PreventMerging]); $base = null; } if (\is_array($value) && \is_array($base)) { $index = 0; foreach ($value as $key => $val) { if ($key === $index) { $base[] = $val; $index++; } elseif (\array_key_exists($key, $base)) { $itemSchema = $this->items[$key] ?? $this->otherItems; $base[$key] = $itemSchema ? $itemSchema->merge($val, $base[$key]) : Helpers::merge($val, $base[$key]); } else { $base[$key] = $val; } } return $base; } return Helpers::merge($value, $base); } public function complete($value, Context $context) { if ($value === null) { $value = []; // is unable to distinguish null from array in NEON } $this->doDeprecation($context); $isOk = $context->createChecker(); Helpers::validateType($value, 'array', $context); $isOk() && Helpers::validateRange($value, $this->range, $context); $isOk() && $this->validateItems($value, $context); $isOk() && ($value = $this->doTransform($value, $context)); return $isOk() ? $value : null; } private function validateItems(array &$value, Context $context) : void { $items = $this->items; if ($extraKeys = \array_keys(\array_diff_key($value, $items))) { if ($this->otherItems) { $items += \array_fill_keys($extraKeys, $this->otherItems); } else { $keys = \array_map('strval', \array_keys($items)); foreach ($extraKeys as $key) { $hint = Nette\Utils\ObjectHelpers::getSuggestion($keys, (string) $key); $context->addError('Unexpected item %path%' . ($hint ? ", did you mean '%hint%'?" : '.'), Nette\Schema\Message::UnexpectedItem, ['hint' => $hint])->path[] = $key; } } } foreach ($items as $itemKey => $itemVal) { $context->path[] = $itemKey; if (\array_key_exists($itemKey, $value)) { $value[$itemKey] = $itemVal->complete($value[$itemKey], $context); } else { $default = $itemVal->completeDefault($context); // checks required item if (!$context->skipDefaults && !$this->skipDefaults) { $value[$itemKey] = $default; } } \array_pop($context->path); } } public function completeDefault(Context $context) { return $this->required ? $this->complete([], $context) : null; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Schema\Elements; use _PHPStan_7d8742a37\Nette; use _PHPStan_7d8742a37\Nette\Schema\Context; use _PHPStan_7d8742a37\Nette\Schema\Helpers; use _PHPStan_7d8742a37\Nette\Schema\Schema; final class AnyOf implements Schema { use Base; use Nette\SmartObject; /** @var array */ private $set; /** * @param mixed|Schema ...$set */ public function __construct(...$set) { if (!$set) { throw new Nette\InvalidStateException('The enumeration must not be empty.'); } $this->set = $set; } public function firstIsDefault() : self { $this->default = $this->set[0]; return $this; } public function nullable() : self { $this->set[] = null; return $this; } public function dynamic() : self { $this->set[] = new Type(Nette\Schema\DynamicParameter::class); return $this; } /********************* processing ****************d*g**/ public function normalize($value, Context $context) { return $this->doNormalize($value, $context); } public function merge($value, $base) { if (\is_array($value) && isset($value[Helpers::PreventMerging])) { unset($value[Helpers::PreventMerging]); return $value; } return Helpers::merge($value, $base); } public function complete($value, Context $context) { $isOk = $context->createChecker(); $value = $this->findAlternative($value, $context); $isOk() && ($value = $this->doTransform($value, $context)); return $isOk() ? $value : null; } private function findAlternative($value, Context $context) { $expecteds = $innerErrors = []; foreach ($this->set as $item) { if ($item instanceof Schema) { $dolly = new Context(); $dolly->path = $context->path; $res = $item->complete($item->normalize($value, $dolly), $dolly); if (!$dolly->errors) { $context->warnings = \array_merge($context->warnings, $dolly->warnings); return $res; } foreach ($dolly->errors as $error) { if ($error->path !== $context->path || empty($error->variables['expected'])) { $innerErrors[] = $error; } else { $expecteds[] = $error->variables['expected']; } } } else { if ($item === $value) { return $value; } $expecteds[] = Nette\Schema\Helpers::formatValue($item); } } if ($innerErrors) { $context->errors = \array_merge($context->errors, $innerErrors); } else { $context->addError('The %label% %path% expects to be %expected%, %value% given.', Nette\Schema\Message::TypeMismatch, ['value' => $value, 'expected' => \implode('|', \array_unique($expecteds))]); } } public function completeDefault(Context $context) { if ($this->required) { $context->addError('The mandatory item %path% is missing.', Nette\Schema\Message::MissingItem); return null; } if ($this->default instanceof Schema) { return $this->default->completeDefault($context); } return $this->default; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Schema\Elements; use _PHPStan_7d8742a37\Nette; use _PHPStan_7d8742a37\Nette\Schema\Context; use _PHPStan_7d8742a37\Nette\Schema\Helpers; /** * @internal */ trait Base { /** @var bool */ private $required = \false; /** @var mixed */ private $default; /** @var callable|null */ private $before; /** @var callable[] */ private $transforms = []; /** @var string|null */ private $deprecated; public function default($value) : self { $this->default = $value; return $this; } public function required(bool $state = \true) : self { $this->required = $state; return $this; } public function before(callable $handler) : self { $this->before = $handler; return $this; } public function castTo(string $type) : self { return $this->transform(Helpers::getCastStrategy($type)); } public function transform(callable $handler) : self { $this->transforms[] = $handler; return $this; } public function assert(callable $handler, ?string $description = null) : self { $expected = $description ?: (\is_string($handler) ? "{$handler}()" : '#' . \count($this->transforms)); return $this->transform(function ($value, Context $context) use($handler, $description, $expected) { if ($handler($value)) { return $value; } $context->addError('Failed assertion ' . ($description ? "'%assertion%'" : '%assertion%') . ' for %label% %path% with value %value%.', Nette\Schema\Message::FailedAssertion, ['value' => $value, 'assertion' => $expected]); }); } /** Marks as deprecated */ public function deprecated(string $message = 'The item %path% is deprecated.') : self { $this->deprecated = $message; return $this; } public function completeDefault(Context $context) { if ($this->required) { $context->addError('The mandatory item %path% is missing.', Nette\Schema\Message::MissingItem); return null; } return $this->default; } public function doNormalize($value, Context $context) { if ($this->before) { $value = ($this->before)($value); } return $value; } private function doDeprecation(Context $context) : void { if ($this->deprecated !== null) { $context->addWarning($this->deprecated, Nette\Schema\Message::Deprecated); } } private function doTransform($value, Context $context) { $isOk = $context->createChecker(); foreach ($this->transforms as $handler) { $value = $handler($value, $context); if (!$isOk()) { return null; } } return $value; } /** @deprecated use Nette\Schema\Validators::validateType() */ private function doValidate($value, string $expected, Context $context) : bool { $isOk = $context->createChecker(); Helpers::validateType($value, $expected, $context); return $isOk(); } /** @deprecated use Nette\Schema\Validators::validateRange() */ private static function doValidateRange($value, array $range, Context $context, string $types = '') : bool { $isOk = $context->createChecker(); Helpers::validateRange($value, $range, $context, $types); return $isOk(); } /** @deprecated use doTransform() */ private function doFinalize($value, Context $context) { return $this->doTransform($value, $context); } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Loaders; use _PHPStan_7d8742a37\Nette; use SplFileInfo; /** * Nette auto loader is responsible for loading classes and interfaces. * * <code> * $loader = new Nette\Loaders\RobotLoader; * $loader->addDirectory('app'); * $loader->excludeDirectory('app/exclude'); * $loader->setTempDirectory('temp'); * $loader->register(); * </code> */ class RobotLoader { use Nette\SmartObject; private const RETRY_LIMIT = 3; /** @var string[] */ public $ignoreDirs = ['.*', '*.old', '*.bak', '*.tmp', 'temp']; /** @var string[] */ public $acceptFiles = ['*.php']; /** @var bool */ private $autoRebuild = \true; /** @var bool */ private $reportParseErrors = \true; /** @var string[] */ private $scanPaths = []; /** @var string[] */ private $excludeDirs = []; /** @var array<string, array{string, int}> class => [file, time] */ private $classes = []; /** @var bool */ private $cacheLoaded = \false; /** @var bool */ private $refreshed = \false; /** @var array<string, int> class => counter */ private $missingClasses = []; /** @var array<string, int> file => mtime */ private $emptyFiles = []; /** @var string|null */ private $tempDirectory; /** @var bool */ private $needSave = \false; public function __construct() { if (!\extension_loaded('tokenizer')) { throw new Nette\NotSupportedException('PHP extension Tokenizer is not loaded.'); } } public function __destruct() { if ($this->needSave) { $this->saveCache(); } } /** * Register autoloader. */ public function register(bool $prepend = \false) : self { \spl_autoload_register([$this, 'tryLoad'], \true, $prepend); return $this; } /** * Handles autoloading of classes, interfaces or traits. */ public function tryLoad(string $type) : void { $this->loadCache(); $missing = $this->missingClasses[$type] ?? null; if ($missing >= self::RETRY_LIMIT) { return; } [$file, $mtime] = $this->classes[$type] ?? null; if ($this->autoRebuild) { if (!$this->refreshed) { if (!$file || !\is_file($file)) { $this->refreshClasses(); [$file] = $this->classes[$type] ?? null; $this->needSave = \true; } elseif (\filemtime($file) !== $mtime) { $this->updateFile($file); [$file] = $this->classes[$type] ?? null; $this->needSave = \true; } } if (!$file || !\is_file($file)) { $this->missingClasses[$type] = ++$missing; $this->needSave = $this->needSave || $file || $missing <= self::RETRY_LIMIT; unset($this->classes[$type]); $file = null; } } if ($file) { (static function ($file) { require $file; })($file); } } /** * Add path or paths to list. * @param string ...$paths absolute path */ public function addDirectory(...$paths) : self { if (\is_array($paths[0] ?? null)) { \trigger_error(__METHOD__ . '() use variadics ...$paths to add an array of paths.', \E_USER_WARNING); $paths = $paths[0]; } $this->scanPaths = \array_merge($this->scanPaths, $paths); return $this; } public function reportParseErrors(bool $on = \true) : self { $this->reportParseErrors = $on; return $this; } /** * Excludes path or paths from list. * @param string ...$paths absolute path */ public function excludeDirectory(...$paths) : self { if (\is_array($paths[0] ?? null)) { \trigger_error(__METHOD__ . '() use variadics ...$paths to add an array of paths.', \E_USER_WARNING); $paths = $paths[0]; } $this->excludeDirs = \array_merge($this->excludeDirs, $paths); return $this; } /** * @return array<string, string> class => filename */ public function getIndexedClasses() : array { $this->loadCache(); $res = []; foreach ($this->classes as $class => [$file]) { $res[$class] = $file; } return $res; } /** * Rebuilds class list cache. */ public function rebuild() : void { $this->cacheLoaded = \true; $this->classes = $this->missingClasses = $this->emptyFiles = []; $this->refreshClasses(); if ($this->tempDirectory) { $this->saveCache(); } } /** * Refreshes class list cache. */ public function refresh() : void { $this->loadCache(); if (!$this->refreshed) { $this->refreshClasses(); $this->saveCache(); } } /** * Refreshes $this->classes & $this->emptyFiles. */ private function refreshClasses() : void { $this->refreshed = \true; // prevents calling refreshClasses() or updateFile() in tryLoad() $files = $this->emptyFiles; $classes = []; foreach ($this->classes as $class => [$file, $mtime]) { $files[$file] = $mtime; $classes[$file][] = $class; } $this->classes = $this->emptyFiles = []; foreach ($this->scanPaths as $path) { $iterator = \is_file($path) ? [new SplFileInfo($path)] : $this->createFileIterator($path); foreach ($iterator as $fileInfo) { $mtime = $fileInfo->getMTime(); $file = $fileInfo->getPathname(); $foundClasses = isset($files[$file]) && $files[$file] === $mtime ? $classes[$file] ?? [] : $this->scanPhp($file); if (!$foundClasses) { $this->emptyFiles[$file] = $mtime; } $files[$file] = $mtime; $classes[$file] = []; // prevents the error when adding the same file twice foreach ($foundClasses as $class) { if (isset($this->classes[$class])) { throw new Nette\InvalidStateException("Ambiguous class {$class} resolution; defined in {$this->classes[$class][0]} and in {$file}."); } $this->classes[$class] = [$file, $mtime]; unset($this->missingClasses[$class]); } } } } /** * Creates an iterator scaning directory for PHP files, subdirectories and 'netterobots.txt' files. * @throws Nette\IOException if path is not found */ private function createFileIterator(string $dir) : Nette\Utils\Finder { if (!\is_dir($dir)) { throw new Nette\IOException("File or directory '{$dir}' not found."); } $dir = \realpath($dir) ?: $dir; // realpath does not work in phar if (\is_string($ignoreDirs = $this->ignoreDirs)) { \trigger_error(self::class . ': $ignoreDirs must be an array.', \E_USER_WARNING); $ignoreDirs = \preg_split('#[,\\s]+#', $ignoreDirs); } $disallow = []; foreach (\array_merge($ignoreDirs, $this->excludeDirs) as $item) { if ($item = \realpath($item)) { $disallow[\str_replace('\\', '/', $item)] = \true; } } if (\is_string($acceptFiles = $this->acceptFiles)) { \trigger_error(self::class . ': $acceptFiles must be an array.', \E_USER_WARNING); $acceptFiles = \preg_split('#[,\\s]+#', $acceptFiles); } $iterator = Nette\Utils\Finder::findFiles($acceptFiles)->filter(function (SplFileInfo $file) use(&$disallow) { return $file->getRealPath() === \false ? \true : !isset($disallow[\str_replace('\\', '/', $file->getRealPath())]); })->from($dir)->exclude($ignoreDirs)->filter($filter = function (SplFileInfo $dir) use(&$disallow) { if ($dir->getRealPath() === \false) { return \true; } $path = \str_replace('\\', '/', $dir->getRealPath()); if (\is_file("{$path}/netterobots.txt")) { foreach (\file("{$path}/netterobots.txt") as $s) { if (\preg_match('#^(?:disallow\\s*:)?\\s*(\\S+)#i', $s, $matches)) { $disallow[$path . \rtrim('/' . \ltrim($matches[1], '/'), '/')] = \true; } } } return !isset($disallow[$path]); }); $filter(new SplFileInfo($dir)); return $iterator; } private function updateFile(string $file) : void { foreach ($this->classes as $class => [$prevFile]) { if ($file === $prevFile) { unset($this->classes[$class]); } } $foundClasses = \is_file($file) ? $this->scanPhp($file) : []; foreach ($foundClasses as $class) { [$prevFile, $prevMtime] = $this->classes[$class] ?? null; if (isset($prevFile) && @\filemtime($prevFile) !== $prevMtime) { // @ file may not exists $this->updateFile($prevFile); [$prevFile] = $this->classes[$class] ?? null; } if (isset($prevFile)) { throw new Nette\InvalidStateException("Ambiguous class {$class} resolution; defined in {$prevFile} and in {$file}."); } $this->classes[$class] = [$file, \filemtime($file)]; } } /** * Searches classes, interfaces and traits in PHP file. * @return string[] */ private function scanPhp(string $file) : array { $code = \file_get_contents($file); $expected = \false; $namespace = $name = ''; $level = $minLevel = 0; $classes = []; try { $tokens = \token_get_all($code, \TOKEN_PARSE); } catch (\ParseError $e) { if ($this->reportParseErrors) { $rp = new \ReflectionProperty($e, 'file'); $rp->setAccessible(\true); $rp->setValue($e, $file); throw $e; } $tokens = []; } foreach ($tokens as $token) { if (\is_array($token)) { switch ($token[0]) { case \T_COMMENT: case \T_DOC_COMMENT: case \T_WHITESPACE: continue 2; case \T_STRING: case \PHP_VERSION_ID < 80000 ? \T_NS_SEPARATOR : \T_NAME_QUALIFIED: if ($expected) { $name .= $token[1]; } continue 2; case \T_NAMESPACE: case \T_CLASS: case \T_INTERFACE: case \T_TRAIT: case \PHP_VERSION_ID < 80100 ? \T_CLASS : \T_ENUM: $expected = $token[0]; $name = ''; continue 2; case \T_CURLY_OPEN: case \T_DOLLAR_OPEN_CURLY_BRACES: $level++; } } if ($expected) { if ($expected === \T_NAMESPACE) { $namespace = $name ? $name . '\\' : ''; $minLevel = $token === '{' ? 1 : 0; } elseif ($name && $level === $minLevel) { $classes[] = $namespace . $name; } $expected = null; } if ($token === '{') { $level++; } elseif ($token === '}') { $level--; } } return $classes; } /********************* caching ****************d*g**/ /** * Sets auto-refresh mode. */ public function setAutoRefresh(bool $on = \true) : self { $this->autoRebuild = $on; return $this; } /** * Sets path to temporary directory. */ public function setTempDirectory(string $dir) : self { Nette\Utils\FileSystem::createDir($dir); $this->tempDirectory = $dir; return $this; } /** * Loads class list from cache. */ private function loadCache() : void { if ($this->cacheLoaded) { return; } $this->cacheLoaded = \true; $file = $this->getCacheFile(); // Solving atomicity to work everywhere is really pain in the ass. // 1) We want to do as little as possible IO calls on production and also directory and file can be not writable (#19) // so on Linux we include the file directly without shared lock, therefore, the file must be created atomically by renaming. // 2) On Windows file cannot be renamed-to while is open (ie by include() #11), so we have to acquire a lock. $lock = \defined('PHP_WINDOWS_VERSION_BUILD') ? $this->acquireLock("{$file}.lock", \LOCK_SH) : null; $data = @(include $file); // @ file may not exist if (\is_array($data)) { [$this->classes, $this->missingClasses, $this->emptyFiles] = $data; return; } if ($lock) { \flock($lock, \LOCK_UN); // release shared lock so we can get exclusive } $lock = $this->acquireLock("{$file}.lock", \LOCK_EX); // while waiting for exclusive lock, someone might have already created the cache $data = @(include $file); // @ file may not exist if (\is_array($data)) { [$this->classes, $this->missingClasses, $this->emptyFiles] = $data; return; } $this->classes = $this->missingClasses = $this->emptyFiles = []; $this->refreshClasses(); $this->saveCache($lock); // On Windows concurrent creation and deletion of a file can cause a 'permission denied' error, // therefore, we will not delete the lock file. Windows is a piece of shit. } /** * Writes class list to cache. * @param resource $lock */ private function saveCache($lock = null) : void { // we have to acquire a lock to be able safely rename file // on Linux: that another thread does not rename the same named file earlier // on Windows: that the file is not read by another thread $file = $this->getCacheFile(); $lock = $lock ?: $this->acquireLock("{$file}.lock", \LOCK_EX); $code = "<?php\nreturn " . \var_export([$this->classes, $this->missingClasses, $this->emptyFiles], \true) . ";\n"; if (\file_put_contents("{$file}.tmp", $code) !== \strlen($code) || !\rename("{$file}.tmp", $file)) { @\unlink("{$file}.tmp"); // @ file may not exist throw new \RuntimeException("Unable to create '{$file}'."); } if (\function_exists('opcache_invalidate')) { @\opcache_invalidate($file, \true); // @ can be restricted } } /** @return resource */ private function acquireLock(string $file, int $mode) { $handle = @\fopen($file, 'w'); // @ is escalated to exception if (!$handle) { throw new \RuntimeException("Unable to create file '{$file}'. " . \error_get_last()['message']); } elseif (!@\flock($handle, $mode)) { // @ is escalated to exception throw new \RuntimeException('Unable to acquire ' . ($mode & \LOCK_EX ? 'exclusive' : 'shared') . " lock on file '{$file}'. " . \error_get_last()['message']); } return $handle; } private function getCacheFile() : string { if (!$this->tempDirectory) { throw new \LogicException('Set path to temporary directory using setTempDirectory().'); } return $this->tempDirectory . '/' . \md5(\serialize($this->getCacheKey())) . '.php'; } protected function getCacheKey() : array { return [$this->ignoreDirs, $this->acceptFiles, $this->scanPaths, $this->excludeDirs, 'v2']; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\PhpGenerator; /** * PHP return, property and parameter types. */ class Type { public const String = 'string', Int = 'int', Float = 'float', Bool = 'bool', Array = 'array', Object = 'object', Callable = 'callable', Iterable = 'iterable', Void = 'void', Never = 'never', Mixed = 'mixed', False = 'false', Null = 'null', Self = 'self', Parent = 'parent', Static = 'static'; /** @deprecated */ public const STRING = self::String, INT = self::Int, FLOAT = self::Float, BOOL = self::Bool, ARRAY = self::Array, OBJECT = self::Object, CALLABLE = self::Callable, ITERABLE = self::Iterable, VOID = self::Void, NEVER = self::Never, MIXED = self::Mixed, FALSE = self::False, NULL = self::Null, SELF = self::Self, PARENT = self::Parent, STATIC = self::Static; public static function nullable(string $type, bool $state = \true) : string { return ($state ? '?' : '') . \ltrim($type, '?'); } public static function union(string ...$types) : string { return \implode('|', $types); } public static function intersection(string ...$types) : string { return \implode('&', $types); } public static function getType($value) : ?string { if (\is_object($value)) { return \get_class($value); } elseif (\is_int($value)) { return self::INT; } elseif (\is_float($value)) { return self::FLOAT; } elseif (\is_string($value)) { return self::STRING; } elseif (\is_bool($value)) { return self::BOOL; } elseif (\is_array($value)) { return self::ARRAY; } else { return null; } } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\PhpGenerator; use _PHPStan_7d8742a37\Nette; /** * PHP Attribute. */ final class Attribute { use Nette\SmartObject; /** @var string */ private $name; /** @var array */ private $args; public function __construct(string $name, array $args) { if (!Helpers::isNamespaceIdentifier($name)) { throw new Nette\InvalidArgumentException("Value '{$name}' is not valid attribute name."); } $this->name = $name; $this->args = $args; } public function getName() : string { return $this->name; } public function getArguments() : array { return $this->args; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\PhpGenerator; use _PHPStan_7d8742a37\Nette; /** * Enum case. */ final class EnumCase { use Nette\SmartObject; use Traits\NameAware; use Traits\CommentAware; use Traits\AttributeAware; /** @var string|int|null */ private $value; /** @return static */ public function setValue($val) : self { $this->value = $val; return $this; } public function getValue() { return $this->value; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\PhpGenerator; class PhpLiteral extends Literal { } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\PhpGenerator\Traits; use _PHPStan_7d8742a37\Nette\PhpGenerator\Attribute; /** * @internal */ trait AttributeAware { /** @var Attribute[] */ private $attributes = []; /** @return static */ public function addAttribute(string $name, array $args = []) : self { $this->attributes[] = new Attribute($name, $args); return $this; } /** * @param Attribute[] $attrs * @return static */ public function setAttributes(array $attrs) : self { (function (Attribute ...$attrs) { })(...$attrs); $this->attributes = $attrs; return $this; } /** @return Attribute[] */ public function getAttributes() : array { return $this->attributes; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\PhpGenerator\Traits; /** * @internal */ trait CommentAware { /** @var string|null */ private $comment; /** @return static */ public function setComment(?string $val) : self { $this->comment = $val; return $this; } public function getComment() : ?string { return $this->comment; } /** @return static */ public function addComment(string $val) : self { $this->comment .= $this->comment ? "\n{$val}" : $val; return $this; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\PhpGenerator\Traits; use _PHPStan_7d8742a37\Nette; use _PHPStan_7d8742a37\Nette\PhpGenerator\ClassType; /** * @internal */ trait VisibilityAware { /** @var string|null public|protected|private */ private $visibility; /** * @param string|null $val public|protected|private * @return static */ public function setVisibility(?string $val) : self { if (!\in_array($val, [ClassType::VisibilityPublic, ClassType::VisibilityProtected, ClassType::VisibilityPrivate, null], \true)) { throw new Nette\InvalidArgumentException('Argument must be public|protected|private.'); } $this->visibility = $val; return $this; } public function getVisibility() : ?string { return $this->visibility; } /** @return static */ public function setPublic() : self { $this->visibility = ClassType::VisibilityPublic; return $this; } public function isPublic() : bool { return $this->visibility === ClassType::VisibilityPublic || $this->visibility === null; } /** @return static */ public function setProtected() : self { $this->visibility = ClassType::VisibilityProtected; return $this; } public function isProtected() : bool { return $this->visibility === ClassType::VisibilityProtected; } /** @return static */ public function setPrivate() : self { $this->visibility = ClassType::VisibilityPrivate; return $this; } public function isPrivate() : bool { return $this->visibility === ClassType::VisibilityPrivate; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\PhpGenerator\Traits; use _PHPStan_7d8742a37\Nette; use _PHPStan_7d8742a37\Nette\PhpGenerator\Dumper; use _PHPStan_7d8742a37\Nette\PhpGenerator\Parameter; use _PHPStan_7d8742a37\Nette\Utils\Type; /** * @internal */ trait FunctionLike { /** @var string */ private $body = ''; /** @var Parameter[] */ private $parameters = []; /** @var bool */ private $variadic = \false; /** @var string|null */ private $returnType; /** @var bool */ private $returnReference = \false; /** @var bool */ private $returnNullable = \false; /** @return static */ public function setBody(string $code, ?array $args = null) : self { $this->body = $args === null ? $code : (new Dumper())->format($code, ...$args); return $this; } public function getBody() : string { return $this->body; } /** @return static */ public function addBody(string $code, ?array $args = null) : self { $this->body .= ($args === null ? $code : (new Dumper())->format($code, ...$args)) . "\n"; return $this; } /** * @param Parameter[] $val * @return static */ public function setParameters(array $val) : self { (function (Parameter ...$val) { })(...\array_values($val)); $this->parameters = []; foreach ($val as $v) { $this->parameters[$v->getName()] = $v; } return $this; } /** @return Parameter[] */ public function getParameters() : array { return $this->parameters; } /** * @param string $name without $ */ public function addParameter(string $name, $defaultValue = null) : Parameter { $param = new Parameter($name); if (\func_num_args() > 1) { $param->setDefaultValue($defaultValue); } return $this->parameters[$name] = $param; } /** * @param string $name without $ * @return static */ public function removeParameter(string $name) : self { unset($this->parameters[$name]); return $this; } /** @return static */ public function setVariadic(bool $state = \true) : self { $this->variadic = $state; return $this; } public function isVariadic() : bool { return $this->variadic; } /** @return static */ public function setReturnType(?string $type) : self { $this->returnType = Nette\PhpGenerator\Helpers::validateType($type, $this->returnNullable); return $this; } /** * @return Type|string|null */ public function getReturnType(bool $asObject = \false) { return $asObject && $this->returnType ? Type::fromString($this->returnType) : $this->returnType; } /** @return static */ public function setReturnReference(bool $state = \true) : self { $this->returnReference = $state; return $this; } public function getReturnReference() : bool { return $this->returnReference; } /** @return static */ public function setReturnNullable(bool $state = \true) : self { $this->returnNullable = $state; return $this; } public function isReturnNullable() : bool { return $this->returnNullable; } /** @deprecated use isReturnNullable() */ public function getReturnNullable() : bool { return $this->returnNullable; } /** @deprecated */ public function setNamespace(?Nette\PhpGenerator\PhpNamespace $val = null) : self { \trigger_error(__METHOD__ . '() is deprecated', \E_USER_DEPRECATED); return $this; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\PhpGenerator\Traits; use _PHPStan_7d8742a37\Nette; /** * @internal */ trait NameAware { /** @var string */ private $name; public function __construct(string $name) { if (!Nette\PhpGenerator\Helpers::isIdentifier($name)) { throw new Nette\InvalidArgumentException("Value '{$name}' is not valid name."); } $this->name = $name; } public function getName() : string { return $this->name; } /** * Returns clone with a different name. * @return static */ public function cloneWithName(string $name) : self { $dolly = clone $this; $dolly->__construct($name); return $dolly; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\PhpGenerator; use _PHPStan_7d8742a37\Nette; /** * Closure. * * @property string $body */ final class Closure { use Nette\SmartObject; use Traits\FunctionLike; use Traits\AttributeAware; /** @var Parameter[] */ private $uses = []; public static function from(\Closure $closure) : self { return (new Factory())->fromFunctionReflection(new \ReflectionFunction($closure)); } public function __toString() : string { try { return (new Printer())->printClosure($this); } catch (\Throwable $e) { if (\PHP_VERSION_ID >= 70400) { throw $e; } \trigger_error('Exception in ' . __METHOD__ . "(): {$e->getMessage()} in {$e->getFile()}:{$e->getLine()}", \E_USER_ERROR); return ''; } } /** * @param Parameter[] $uses * @return static */ public function setUses(array $uses) : self { (function (Parameter ...$uses) { })(...$uses); $this->uses = $uses; return $this; } public function getUses() : array { return $this->uses; } public function addUse(string $name) : Parameter { return $this->uses[] = new Parameter($name); } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\PhpGenerator; use _PHPStan_7d8742a37\Nette; /** * use Trait */ final class TraitUse { use Nette\SmartObject; use Traits\NameAware; use Traits\CommentAware; /** @var array */ private $resolutions = []; public function __construct(string $name) { if (!Nette\PhpGenerator\Helpers::isNamespaceIdentifier($name, \true)) { throw new Nette\InvalidArgumentException("Value '{$name}' is not valid trait name."); } $this->name = $name; } public function addResolution(string $resolution) : self { $this->resolutions[] = $resolution; return $this; } public function getResolutions() : array { return $this->resolutions; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\PhpGenerator; use _PHPStan_7d8742a37\Nette; /** * Promoted parameter in constructor. */ final class PromotedParameter extends Parameter { use Traits\VisibilityAware; use Traits\CommentAware; /** @var bool */ private $readOnly = \false; /** @return static */ public function setReadOnly(bool $state = \true) : self { $this->readOnly = $state; return $this; } public function isReadOnly() : bool { return $this->readOnly; } /** @throws Nette\InvalidStateException */ public function validate() : void { if ($this->readOnly && !$this->getType()) { throw new Nette\InvalidStateException("Property \${$this->getName()}: Read-only properties are only supported on typed property."); } } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\PhpGenerator; use _PHPStan_7d8742a37\Nette; /** * Class method. * * @property string|null $body */ final class Method { use Nette\SmartObject; use Traits\FunctionLike; use Traits\NameAware; use Traits\VisibilityAware; use Traits\CommentAware; use Traits\AttributeAware; /** @var string|null */ private $body = ''; /** @var bool */ private $static = \false; /** @var bool */ private $final = \false; /** @var bool */ private $abstract = \false; /** * @param string|array $method */ public static function from($method) : self { return (new Factory())->fromMethodReflection(Nette\Utils\Callback::toReflection($method)); } public function __toString() : string { try { return (new Printer())->printMethod($this); } catch (\Throwable $e) { if (\PHP_VERSION_ID >= 70400) { throw $e; } \trigger_error('Exception in ' . __METHOD__ . "(): {$e->getMessage()} in {$e->getFile()}:{$e->getLine()}", \E_USER_ERROR); return ''; } } /** @return static */ public function setBody(?string $code, ?array $args = null) : self { $this->body = $args === null || $code === null ? $code : (new Dumper())->format($code, ...$args); return $this; } public function getBody() : ?string { return $this->body; } /** @return static */ public function setStatic(bool $state = \true) : self { $this->static = $state; return $this; } public function isStatic() : bool { return $this->static; } /** @return static */ public function setFinal(bool $state = \true) : self { $this->final = $state; return $this; } public function isFinal() : bool { return $this->final; } /** @return static */ public function setAbstract(bool $state = \true) : self { $this->abstract = $state; return $this; } public function isAbstract() : bool { return $this->abstract; } /** * @param string $name without $ */ public function addPromotedParameter(string $name, $defaultValue = null) : PromotedParameter { $param = new PromotedParameter($name); if (\func_num_args() > 1) { $param->setDefaultValue($defaultValue); } return $this->parameters[$name] = $param; } /** @throws Nette\InvalidStateException */ public function validate() : void { if ($this->abstract && ($this->final || $this->visibility === ClassType::VisibilityPrivate)) { throw new Nette\InvalidStateException("Method {$this->name}() cannot be abstract and final or private at the same time."); } } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\PhpGenerator; use _PHPStan_7d8742a37\Nette; use _PHPStan_7d8742a37\PhpParser; use PhpParser\Node; use PhpParser\NodeFinder; use PhpParser\ParserFactory; /** * Extracts information from PHP code. * @internal */ final class Extractor { use Nette\SmartObject; private $code; private $statements; private $printer; public function __construct(string $code) { if (!\class_exists(ParserFactory::class)) { throw new Nette\NotSupportedException("PHP-Parser is required to load method bodies, install package 'nikic/php-parser' 4.7 or newer."); } $this->printer = new PhpParser\PrettyPrinter\Standard(); $this->parseCode($code); } private function parseCode(string $code) : void { if (\substr($code, 0, 5) !== '<?php') { throw new Nette\InvalidStateException('The input string is not a PHP code.'); } $this->code = \str_replace("\r\n", "\n", $code); $lexer = new PhpParser\Lexer\Emulative(['usedAttributes' => ['startFilePos', 'endFilePos', 'comments']]); $parser = (new ParserFactory())->create(ParserFactory::ONLY_PHP7, $lexer); $stmts = $parser->parse($this->code); $traverser = new PhpParser\NodeTraverser(); $traverser->addVisitor(new PhpParser\NodeVisitor\ParentConnectingVisitor()); $traverser->addVisitor(new PhpParser\NodeVisitor\NameResolver(null, ['preserveOriginalNames' => \true])); $this->statements = $traverser->traverse($stmts); } public function extractMethodBodies(string $className) : array { $nodeFinder = new NodeFinder(); $classNode = $nodeFinder->findFirst($this->statements, function (Node $node) use($className) { return $node instanceof Node\Stmt\ClassLike && $node->namespacedName->toString() === $className; }); $res = []; foreach ($nodeFinder->findInstanceOf($classNode, Node\Stmt\ClassMethod::class) as $methodNode) { /** @var Node\Stmt\ClassMethod $methodNode */ if ($methodNode->stmts) { $res[$methodNode->name->toString()] = $this->getReformattedContents($methodNode->stmts, 2); } } return $res; } public function extractFunctionBody(string $name) : ?string { /** @var Node\Stmt\Function_ $functionNode */ $functionNode = (new NodeFinder())->findFirst($this->statements, function (Node $node) use($name) { return $node instanceof Node\Stmt\Function_ && $node->namespacedName->toString() === $name; }); return $this->getReformattedContents($functionNode->stmts, 1); } /** @param Node[] $statements */ private function getReformattedContents(array $statements, int $level) : string { $body = $this->getNodeContents(...$statements); $body = $this->performReplacements($body, $this->prepareReplacements($statements)); return Helpers::unindent($body, $level); } private function prepareReplacements(array $statements) : array { $start = $this->getNodeStartPos($statements[0]); $replacements = []; (new NodeFinder())->find($statements, function (Node $node) use(&$replacements, $start) { if ($node instanceof Node\Name\FullyQualified) { if ($node->getAttribute('originalName') instanceof Node\Name) { $of = $node->getAttribute('parent') instanceof Node\Expr\ConstFetch ? PhpNamespace::NameConstant : ($node->getAttribute('parent') instanceof Node\Expr\FuncCall ? PhpNamespace::NameFunction : PhpNamespace::NameNormal); $replacements[] = [$node->getStartFilePos() - $start, $node->getEndFilePos() - $start, Helpers::tagName($node->toCodeString(), $of)]; } } elseif ($node instanceof Node\Scalar\String_ || $node instanceof Node\Scalar\EncapsedStringPart) { // multi-line strings => singleline $token = $this->getNodeContents($node); if (\strpos($token, "\n") !== \false) { $quote = $node instanceof Node\Scalar\String_ ? '"' : ''; $replacements[] = [$node->getStartFilePos() - $start, $node->getEndFilePos() - $start, $quote . \addcslashes($node->value, "\x00..\x1f") . $quote]; } } elseif ($node instanceof Node\Scalar\Encapsed) { // HEREDOC => "string" if ($node->getAttribute('kind') === Node\Scalar\String_::KIND_HEREDOC) { $replacements[] = [$node->getStartFilePos() - $start, $node->parts[0]->getStartFilePos() - $start - 1, '"']; $replacements[] = [\end($node->parts)->getEndFilePos() - $start + 1, $node->getEndFilePos() - $start, '"']; } } }); return $replacements; } private function performReplacements(string $s, array $replacements) : string { \usort($replacements, function ($a, $b) { // sort by position in file return $b[0] <=> $a[0]; }); foreach ($replacements as [$start, $end, $replacement]) { $s = \substr_replace($s, $replacement, $start, $end - $start + 1); } return $s; } public function extractAll() : PhpFile { $phpFile = new PhpFile(); $namespace = ''; $visitor = new class extends PhpParser\NodeVisitorAbstract { public $callback; public function enterNode(Node $node) { return ($this->callback)($node); } }; $visitor->callback = function (Node $node) use(&$class, &$namespace, $phpFile) { if ($node instanceof Node\Stmt\DeclareDeclare && $node->key->name === 'strict_types') { $phpFile->setStrictTypes((bool) $node->value->value); } elseif ($node instanceof Node\Stmt\Namespace_) { $namespace = $node->name ? $node->name->toString() : ''; } elseif ($node instanceof Node\Stmt\Use_) { $this->addUseToNamespace($node, $phpFile->addNamespace($namespace)); } elseif ($node instanceof Node\Stmt\Class_) { if (!$node->name) { return PhpParser\NodeTraverser::DONT_TRAVERSE_CHILDREN; } $class = $this->addClassToFile($phpFile, $node); } elseif ($node instanceof Node\Stmt\Interface_) { $class = $this->addInterfaceToFile($phpFile, $node); } elseif ($node instanceof Node\Stmt\Trait_) { $class = $this->addTraitToFile($phpFile, $node); } elseif ($node instanceof Node\Stmt\Enum_) { $class = $this->addEnumToFile($phpFile, $node); } elseif ($node instanceof Node\Stmt\Function_) { $this->addFunctionToFile($phpFile, $node); } elseif ($node instanceof Node\Stmt\TraitUse) { $this->addTraitToClass($class, $node); } elseif ($node instanceof Node\Stmt\Property) { $this->addPropertyToClass($class, $node); } elseif ($node instanceof Node\Stmt\ClassMethod) { $this->addMethodToClass($class, $node); } elseif ($node instanceof Node\Stmt\ClassConst) { $this->addConstantToClass($class, $node); } elseif ($node instanceof Node\Stmt\EnumCase) { $this->addEnumCaseToClass($class, $node); } if ($node instanceof Node\FunctionLike) { return PhpParser\NodeTraverser::DONT_TRAVERSE_CHILDREN; } }; if ($this->statements) { $this->addCommentAndAttributes($phpFile, $this->statements[0]); } $traverser = new PhpParser\NodeTraverser(); $traverser->addVisitor($visitor); $traverser->traverse($this->statements); return $phpFile; } private function addUseToNamespace(Node\Stmt\Use_ $node, PhpNamespace $namespace) : void { $of = [$node::TYPE_NORMAL => PhpNamespace::NameNormal, $node::TYPE_FUNCTION => PhpNamespace::NameFunction, $node::TYPE_CONSTANT => PhpNamespace::NameConstant][$node->type]; foreach ($node->uses as $use) { $namespace->addUse($use->name->toString(), $use->alias ? $use->alias->toString() : null, $of); } } private function addClassToFile(PhpFile $phpFile, Node\Stmt\Class_ $node) : ClassType { $class = $phpFile->addClass($node->namespacedName->toString()); if ($node->extends) { $class->setExtends($node->extends->toString()); } foreach ($node->implements as $item) { $class->addImplement($item->toString()); } $class->setFinal($node->isFinal()); $class->setAbstract($node->isAbstract()); $this->addCommentAndAttributes($class, $node); return $class; } private function addInterfaceToFile(PhpFile $phpFile, Node\Stmt\Interface_ $node) : ClassType { $class = $phpFile->addInterface($node->namespacedName->toString()); foreach ($node->extends as $item) { $class->addExtend($item->toString()); } $this->addCommentAndAttributes($class, $node); return $class; } private function addTraitToFile(PhpFile $phpFile, Node\Stmt\Trait_ $node) : ClassType { $class = $phpFile->addTrait($node->namespacedName->toString()); $this->addCommentAndAttributes($class, $node); return $class; } private function addEnumToFile(PhpFile $phpFile, Node\Stmt\Enum_ $node) : ClassType { $class = $phpFile->addEnum($node->namespacedName->toString()); foreach ($node->implements as $item) { $class->addImplement($item->toString()); } $this->addCommentAndAttributes($class, $node); return $class; } private function addFunctionToFile(PhpFile $phpFile, Node\Stmt\Function_ $node) : void { $function = $phpFile->addFunction($node->namespacedName->toString()); $this->setupFunction($function, $node); } private function addTraitToClass(ClassType $class, Node\Stmt\TraitUse $node) : void { foreach ($node->traits as $item) { $trait = $class->addTrait($item->toString(), \true); } foreach ($node->adaptations as $item) { $trait->addResolution(\trim($this->toPhp($item), ';')); } $this->addCommentAndAttributes($trait, $node); } private function addPropertyToClass(ClassType $class, Node\Stmt\Property $node) : void { foreach ($node->props as $item) { $prop = $class->addProperty($item->name->toString()); $prop->setStatic($node->isStatic()); $prop->setVisibility($this->toVisibility($node->flags)); $prop->setType($node->type ? $this->toPhp($node->type) : null); if ($item->default) { $prop->setValue(new Literal($this->getReformattedContents([$item->default], 1))); } $prop->setReadOnly(\method_exists($node, 'isReadonly') && $node->isReadonly()); $this->addCommentAndAttributes($prop, $node); } } private function addMethodToClass(ClassType $class, Node\Stmt\ClassMethod $node) : void { $method = $class->addMethod($node->name->toString()); $method->setAbstract($node->isAbstract()); $method->setFinal($node->isFinal()); $method->setStatic($node->isStatic()); $method->setVisibility($this->toVisibility($node->flags)); $this->setupFunction($method, $node); } private function addConstantToClass(ClassType $class, Node\Stmt\ClassConst $node) : void { foreach ($node->consts as $item) { $value = $this->getReformattedContents([$item->value], 1); $const = $class->addConstant($item->name->toString(), new Literal($value)); $const->setVisibility($this->toVisibility($node->flags)); $const->setFinal(\method_exists($node, 'isFinal') && $node->isFinal()); $this->addCommentAndAttributes($const, $node); } } private function addEnumCaseToClass(ClassType $class, Node\Stmt\EnumCase $node) { $case = $class->addCase($node->name->toString(), $node->expr ? $node->expr->value : null); $this->addCommentAndAttributes($case, $node); } private function addCommentAndAttributes($element, Node $node) : void { if ($node->getDocComment()) { $comment = $node->getDocComment()->getReformattedText(); $comment = Helpers::unformatDocComment($comment); $element->setComment($comment); $node->setDocComment(new PhpParser\Comment\Doc('')); } foreach ($node->attrGroups ?? [] as $group) { foreach ($group->attrs as $attribute) { $args = []; foreach ($attribute->args as $arg) { $value = new Literal($this->getReformattedContents([$arg->value], 0)); if ($arg->name) { $args[$arg->name->toString()] = $value; } else { $args[] = $value; } } $element->addAttribute($attribute->name->toString(), $args); } } } /** * @param GlobalFunction|Method $function */ private function setupFunction($function, Node\FunctionLike $node) : void { $function->setReturnReference($node->returnsByRef()); $function->setReturnType($node->getReturnType() ? $this->toPhp($node->getReturnType()) : null); foreach ($node->getParams() as $item) { $visibility = $this->toVisibility($item->flags); $isReadonly = (bool) ($item->flags & Node\Stmt\Class_::MODIFIER_READONLY); $param = $visibility ? $function->addPromotedParameter($item->var->name)->setVisibility($visibility)->setReadonly($isReadonly) : $function->addParameter($item->var->name); $param->setType($item->type ? $this->toPhp($item->type) : null); $param->setReference($item->byRef); $function->setVariadic($item->variadic); if ($item->default) { $param->setDefaultValue(new Literal($this->getReformattedContents([$item->default], 2))); } $this->addCommentAndAttributes($param, $item); } $this->addCommentAndAttributes($function, $node); if ($node->getStmts()) { $function->setBody($this->getReformattedContents($node->getStmts(), 2)); } } private function toVisibility(int $flags) : ?string { if ($flags & Node\Stmt\Class_::MODIFIER_PUBLIC) { return ClassType::VisibilityPublic; } elseif ($flags & Node\Stmt\Class_::MODIFIER_PROTECTED) { return ClassType::VisibilityProtected; } elseif ($flags & Node\Stmt\Class_::MODIFIER_PRIVATE) { return ClassType::VisibilityPrivate; } return null; } private function toPhp($value) : string { return $this->printer->prettyPrint([$value]); } private function getNodeContents(Node ...$nodes) : string { $start = $this->getNodeStartPos($nodes[0]); return \substr($this->code, $start, \end($nodes)->getEndFilePos() - $start + 1); } private function getNodeStartPos(Node $node) : int { return ($comments = $node->getComments()) ? $comments[0]->getStartFilePos() : $node->getStartFilePos(); } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\PhpGenerator; use _PHPStan_7d8742a37\Nette; /** * Class constant. */ final class Constant { use Nette\SmartObject; use Traits\NameAware; use Traits\VisibilityAware; use Traits\CommentAware; use Traits\AttributeAware; /** @var mixed */ private $value; /** @var bool */ private $final = \false; /** @return static */ public function setValue($val) : self { $this->value = $val; return $this; } public function getValue() { return $this->value; } /** @return static */ public function setFinal(bool $state = \true) : self { $this->final = $state; return $this; } public function isFinal() : bool { return $this->final; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\PhpGenerator; use _PHPStan_7d8742a37\Nette; use _PHPStan_7d8742a37\Nette\Utils\Strings; /** * Generates PHP code. */ class Printer { use Nette\SmartObject; /** @var int */ public $wrapLength = 120; /** @var string */ protected $indentation = "\t"; /** @var int */ protected $linesBetweenProperties = 0; /** @var int */ protected $linesBetweenMethods = 2; /** @var string */ protected $returnTypeColon = ': '; /** @var ?PhpNamespace */ protected $namespace; /** @var ?Dumper */ protected $dumper; /** @var bool */ private $resolveTypes = \true; public function __construct() { $this->dumper = new Dumper(); } public function printFunction(GlobalFunction $function, ?PhpNamespace $namespace = null) : string { $this->namespace = $this->resolveTypes ? $namespace : null; $line = 'function ' . ($function->getReturnReference() ? '&' : '') . $function->getName(); $returnType = $this->printReturnType($function); $body = Helpers::simplifyTaggedNames($function->getBody(), $this->namespace); return Helpers::formatDocComment($function->getComment() . "\n") . $this->printAttributes($function->getAttributes()) . $line . $this->printParameters($function, \strlen($line) + \strlen($returnType) + 2) . $returnType . "\n{\n" . $this->indent(\ltrim(\rtrim($body) . "\n")) . "}\n"; } public function printClosure(Closure $closure, ?PhpNamespace $namespace = null) : string { $this->namespace = $this->resolveTypes ? $namespace : null; $uses = []; foreach ($closure->getUses() as $param) { $uses[] = ($param->isReference() ? '&' : '') . '$' . $param->getName(); } $useStr = \strlen($tmp = \implode(', ', $uses)) > $this->wrapLength && \count($uses) > 1 ? "\n" . $this->indentation . \implode(",\n" . $this->indentation, $uses) . "\n" : $tmp; $body = Helpers::simplifyTaggedNames($closure->getBody(), $this->namespace); return $this->printAttributes($closure->getAttributes(), \true) . 'function ' . ($closure->getReturnReference() ? '&' : '') . $this->printParameters($closure) . ($uses ? " use ({$useStr})" : '') . $this->printReturnType($closure) . " {\n" . $this->indent(\ltrim(\rtrim($body) . "\n")) . '}'; } public function printArrowFunction(Closure $closure, ?PhpNamespace $namespace = null) : string { $this->namespace = $this->resolveTypes ? $namespace : null; foreach ($closure->getUses() as $use) { if ($use->isReference()) { throw new Nette\InvalidArgumentException('Arrow function cannot bind variables by-reference.'); } } $body = Helpers::simplifyTaggedNames($closure->getBody(), $this->namespace); return $this->printAttributes($closure->getAttributes()) . 'fn' . ($closure->getReturnReference() ? '&' : '') . $this->printParameters($closure) . $this->printReturnType($closure) . ' => ' . \trim($body) . ';'; } public function printMethod(Method $method, ?PhpNamespace $namespace = null) : string { $this->namespace = $this->resolveTypes ? $namespace : null; $method->validate(); $line = ($method->isAbstract() ? 'abstract ' : '') . ($method->isFinal() ? 'final ' : '') . ($method->getVisibility() ? $method->getVisibility() . ' ' : '') . ($method->isStatic() ? 'static ' : '') . 'function ' . ($method->getReturnReference() ? '&' : '') . $method->getName(); $returnType = $this->printReturnType($method); $params = $this->printParameters($method, \strlen($line) + \strlen($returnType) + \strlen($this->indentation) + 2); $body = Helpers::simplifyTaggedNames((string) $method->getBody(), $this->namespace); return Helpers::formatDocComment($method->getComment() . "\n") . $this->printAttributes($method->getAttributes()) . $line . $params . $returnType . ($method->isAbstract() || $method->getBody() === null ? ";\n" : (\strpos($params, "\n") === \false ? "\n" : ' ') . "{\n" . $this->indent(\ltrim(\rtrim($body) . "\n")) . "}\n"); } public function printClass(ClassType $class, ?PhpNamespace $namespace = null) : string { $this->namespace = $this->resolveTypes ? $namespace : null; $class->validate(); $resolver = $this->namespace ? [$namespace, 'simplifyType'] : function ($s) { return $s; }; $traits = []; foreach ($class->getTraitResolutions() as $trait) { $resolutions = $trait->getResolutions(); $traits[] = Helpers::formatDocComment((string) $trait->getComment()) . 'use ' . $resolver($trait->getName()) . ($resolutions ? " {\n" . $this->indentation . \implode(";\n" . $this->indentation, $resolutions) . ";\n}\n" : ";\n"); } $cases = []; foreach ($class->getCases() as $case) { $cases[] = Helpers::formatDocComment((string) $case->getComment()) . $this->printAttributes($case->getAttributes()) . 'case ' . $case->getName() . ($case->getValue() === null ? '' : ' = ' . $this->dump($case->getValue())) . ";\n"; } $enumType = isset($case) && $case->getValue() !== null ? $this->returnTypeColon . Type::getType($case->getValue()) : ''; $consts = []; foreach ($class->getConstants() as $const) { $def = ($const->isFinal() ? 'final ' : '') . ($const->getVisibility() ? $const->getVisibility() . ' ' : '') . 'const ' . $const->getName() . ' = '; $consts[] = Helpers::formatDocComment((string) $const->getComment()) . $this->printAttributes($const->getAttributes()) . $def . $this->dump($const->getValue(), \strlen($def)) . ";\n"; } $properties = []; foreach ($class->getProperties() as $property) { $property->validate(); $type = $property->getType(); $def = ($property->getVisibility() ?: 'public') . ($property->isStatic() ? ' static' : '') . ($property->isReadOnly() && $type ? ' readonly' : '') . ' ' . \ltrim($this->printType($type, $property->isNullable()) . ' ') . '$' . $property->getName(); $properties[] = Helpers::formatDocComment((string) $property->getComment()) . $this->printAttributes($property->getAttributes()) . $def . ($property->getValue() === null && !$property->isInitialized() ? '' : ' = ' . $this->dump($property->getValue(), \strlen($def) + 3)) . ";\n"; } $methods = []; foreach ($class->getMethods() as $method) { $methods[] = $this->printMethod($method, $namespace); } $members = \array_filter([\implode('', $traits), $this->joinProperties($cases), $this->joinProperties($consts), $this->joinProperties($properties), ($methods && $properties ? \str_repeat("\n", $this->linesBetweenMethods - 1) : '') . \implode(\str_repeat("\n", $this->linesBetweenMethods), $methods)]); return Strings::normalize(Helpers::formatDocComment($class->getComment() . "\n") . $this->printAttributes($class->getAttributes()) . ($class->isAbstract() ? 'abstract ' : '') . ($class->isFinal() ? 'final ' : '') . ($class->getName() ? $class->getType() . ' ' . $class->getName() . $enumType . ' ' : '') . ($class->getExtends() ? 'extends ' . \implode(', ', \array_map($resolver, (array) $class->getExtends())) . ' ' : '') . ($class->getImplements() ? 'implements ' . \implode(', ', \array_map($resolver, $class->getImplements())) . ' ' : '') . ($class->getName() ? "\n" : '') . "{\n" . ($members ? $this->indent(\implode("\n", $members)) : '') . '}') . ($class->getName() ? "\n" : ''); } public function printNamespace(PhpNamespace $namespace) : string { $this->namespace = $this->resolveTypes ? $namespace : null; $name = $namespace->getName(); $uses = $this->printUses($namespace) . $this->printUses($namespace, PhpNamespace::NameFunction) . $this->printUses($namespace, PhpNamespace::NameConstant); $items = []; foreach ($namespace->getClasses() as $class) { $items[] = $this->printClass($class, $namespace); } foreach ($namespace->getFunctions() as $function) { $items[] = $this->printFunction($function, $namespace); } $body = ($uses ? $uses . "\n" : '') . \implode("\n", $items); if ($namespace->hasBracketedSyntax()) { return 'namespace' . ($name ? " {$name}" : '') . "\n{\n" . $this->indent($body) . "}\n"; } else { return ($name ? "namespace {$name};\n\n" : '') . $body; } } public function printFile(PhpFile $file) : string { $namespaces = []; foreach ($file->getNamespaces() as $namespace) { $namespaces[] = $this->printNamespace($namespace); } return Strings::normalize("<?php\n" . ($file->getComment() ? "\n" . Helpers::formatDocComment($file->getComment() . "\n") : '') . "\n" . ($file->hasStrictTypes() ? "declare(strict_types=1);\n\n" : '') . \implode("\n\n", $namespaces)) . "\n"; } protected function printUses(PhpNamespace $namespace, string $of = PhpNamespace::NameNormal) : string { $prefix = [PhpNamespace::NameNormal => '', PhpNamespace::NameFunction => 'function ', PhpNamespace::NameConstant => 'const '][$of]; $name = $namespace->getName(); $uses = []; foreach ($namespace->getUses($of) as $alias => $original) { $uses[] = Helpers::extractShortName($original) === $alias ? "use {$prefix}{$original};\n" : "use {$prefix}{$original} as {$alias};\n"; } return \implode('', $uses); } /** * @param Closure|GlobalFunction|Method $function */ protected function printParameters($function, int $column = 0) : string { $params = []; $list = $function->getParameters(); $special = \false; foreach ($list as $param) { $param->validate(); $variadic = $function->isVariadic() && $param === \end($list); $type = $param->getType(); $promoted = $param instanceof PromotedParameter ? $param : null; $params[] = ($promoted ? Helpers::formatDocComment((string) $promoted->getComment()) : '') . ($attrs = $this->printAttributes($param->getAttributes(), \true)) . ($promoted ? ($promoted->getVisibility() ?: 'public') . ($promoted->isReadOnly() && $type ? ' readonly' : '') . ' ' : '') . \ltrim($this->printType($type, $param->isNullable()) . ' ') . ($param->isReference() ? '&' : '') . ($variadic ? '...' : '') . '$' . $param->getName() . ($param->hasDefaultValue() && !$variadic ? ' = ' . $this->dump($param->getDefaultValue()) : ''); $special = $special || $promoted || $attrs; } $line = \implode(', ', $params); return \count($params) > 1 && ($special || \strlen($line) + $column > $this->wrapLength) ? "(\n" . $this->indent(\implode(",\n", $params)) . ($special ? ',' : '') . "\n)" : "({$line})"; } protected function printType(?string $type, bool $nullable) : string { if ($type === null) { return ''; } if ($this->namespace) { $type = $this->namespace->simplifyType($type); } if ($nullable && \strcasecmp($type, 'mixed')) { $type = \strpos($type, '|') === \false ? '?' . $type : $type . '|null'; } return $type; } /** * @param Closure|GlobalFunction|Method $function */ private function printReturnType($function) : string { return ($tmp = $this->printType($function->getReturnType(), $function->isReturnNullable())) ? $this->returnTypeColon . $tmp : ''; } private function printAttributes(array $attrs, bool $inline = \false) : string { if (!$attrs) { return ''; } $this->dumper->indentation = $this->indentation; $items = []; foreach ($attrs as $attr) { $args = $this->dumper->format('...?:', $attr->getArguments()); $args = Helpers::simplifyTaggedNames($args, $this->namespace); $items[] = $this->printType($attr->getName(), \false) . ($args ? "({$args})" : ''); } return $inline ? '#[' . \implode(', ', $items) . '] ' : '#[' . \implode("]\n#[", $items) . "]\n"; } /** @return static */ public function setTypeResolving(bool $state = \true) : self { $this->resolveTypes = $state; return $this; } protected function indent(string $s) : string { $s = \str_replace("\t", $this->indentation, $s); return Strings::indent($s, 1, $this->indentation); } protected function dump($var, int $column = 0) : string { $this->dumper->indentation = $this->indentation; $this->dumper->wrapLength = $this->wrapLength; $s = $this->dumper->dump($var, $column); $s = Helpers::simplifyTaggedNames($s, $this->namespace); return $s; } private function joinProperties(array $props) : string { return $this->linesBetweenProperties ? \implode(\str_repeat("\n", $this->linesBetweenProperties), $props) : \preg_replace('#^(\\w.*\\n)\\n(?=\\w.*;)#m', '$1', \implode("\n", $props)); } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\PhpGenerator; use _PHPStan_7d8742a37\Nette; use _PHPStan_7d8742a37\Nette\Utils\Type; /** * Function/Method parameter description. * * @property mixed $defaultValue */ class Parameter { use Nette\SmartObject; use Traits\NameAware; use Traits\AttributeAware; /** @var bool */ private $reference = \false; /** @var string|null */ private $type; /** @var bool */ private $nullable = \false; /** @var bool */ private $hasDefaultValue = \false; /** @var mixed */ private $defaultValue; /** @return static */ public function setReference(bool $state = \true) : self { $this->reference = $state; return $this; } public function isReference() : bool { return $this->reference; } /** @return static */ public function setType(?string $type) : self { $this->type = Helpers::validateType($type, $this->nullable); return $this; } /** * @return Type|string|null */ public function getType(bool $asObject = \false) { return $asObject && $this->type ? Type::fromString($this->type) : $this->type; } /** @deprecated use setType() */ public function setTypeHint(?string $type) : self { return $this->setType($type); } /** @deprecated use getType() */ public function getTypeHint() : ?string { return $this->getType(); } /** * @deprecated just use setDefaultValue() * @return static */ public function setOptional(bool $state = \true) : self { \trigger_error(__METHOD__ . '() is deprecated, use setDefaultValue()', \E_USER_DEPRECATED); $this->hasDefaultValue = $state; return $this; } /** @return static */ public function setNullable(bool $state = \true) : self { $this->nullable = $state; return $this; } public function isNullable() : bool { return $this->nullable; } /** @return static */ public function setDefaultValue($val) : self { $this->defaultValue = $val; $this->hasDefaultValue = \true; return $this; } public function getDefaultValue() { return $this->defaultValue; } public function hasDefaultValue() : bool { return $this->hasDefaultValue; } public function validate() : void { } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\PhpGenerator; use _PHPStan_7d8742a37\Nette; use _PHPStan_7d8742a37\Nette\Utils\Type; /** * Class property description. * * @property mixed $value */ final class Property { use Nette\SmartObject; use Traits\NameAware; use Traits\VisibilityAware; use Traits\CommentAware; use Traits\AttributeAware; /** @var mixed */ private $value; /** @var bool */ private $static = \false; /** @var string|null */ private $type; /** @var bool */ private $nullable = \false; /** @var bool */ private $initialized = \false; /** @var bool */ private $readOnly = \false; /** @return static */ public function setValue($val) : self { $this->value = $val; $this->initialized = \true; return $this; } public function &getValue() { return $this->value; } /** @return static */ public function setStatic(bool $state = \true) : self { $this->static = $state; return $this; } public function isStatic() : bool { return $this->static; } /** @return static */ public function setType(?string $type) : self { $this->type = Helpers::validateType($type, $this->nullable); return $this; } /** * @return Type|string|null */ public function getType(bool $asObject = \false) { return $asObject && $this->type ? Type::fromString($this->type) : $this->type; } /** @return static */ public function setNullable(bool $state = \true) : self { $this->nullable = $state; return $this; } public function isNullable() : bool { return $this->nullable; } /** @return static */ public function setInitialized(bool $state = \true) : self { $this->initialized = $state; return $this; } public function isInitialized() : bool { return $this->initialized || $this->value !== null; } /** @return static */ public function setReadOnly(bool $state = \true) : self { $this->readOnly = $state; return $this; } public function isReadOnly() : bool { return $this->readOnly; } /** @throws Nette\InvalidStateException */ public function validate() : void { if ($this->readOnly && !$this->type) { throw new Nette\InvalidStateException("Property \${$this->name}: Read-only properties are only supported on typed property."); } } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\PhpGenerator; /** * Generates PHP code compatible with PSR-2 and PSR-12. */ final class PsrPrinter extends Printer { /** @var string */ protected $indentation = ' '; /** @var int */ protected $linesBetweenMethods = 1; } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\PhpGenerator; use _PHPStan_7d8742a37\Nette; use _PHPStan_7d8742a37\Nette\InvalidStateException; /** * Namespaced part of a PHP file. * * Generates: * - namespace statement * - variable amount of use statements * - one or more class declarations */ final class PhpNamespace { use Nette\SmartObject; public const NameNormal = 'n', NameFunction = 'f', NameConstant = 'c'; public const NAME_NORMAL = self::NameNormal, NAME_FUNCTION = self::NameFunction, NAME_CONSTANT = self::NameConstant; /** @var string */ private $name; /** @var bool */ private $bracketedSyntax = \false; /** @var string[][] */ private $aliases = [self::NameNormal => [], self::NameFunction => [], self::NameConstant => []]; /** @var ClassType[] */ private $classes = []; /** @var GlobalFunction[] */ private $functions = []; public function __construct(string $name) { if ($name !== '' && !Helpers::isNamespaceIdentifier($name)) { throw new Nette\InvalidArgumentException("Value '{$name}' is not valid name."); } $this->name = $name; } public function getName() : string { return $this->name; } /** * @return static * @internal */ public function setBracketedSyntax(bool $state = \true) : self { $this->bracketedSyntax = $state; return $this; } public function hasBracketedSyntax() : bool { return $this->bracketedSyntax; } /** @deprecated use hasBracketedSyntax() */ public function getBracketedSyntax() : bool { return $this->bracketedSyntax; } /** * @throws InvalidStateException * @return static */ public function addUse(string $name, ?string $alias = null, string $of = self::NameNormal) : self { if (!Helpers::isNamespaceIdentifier($name, \true) || Helpers::isIdentifier($name) && isset(Helpers::Keywords[\strtolower($name)])) { throw new Nette\InvalidArgumentException("Value '{$name}' is not valid class/function/constant name."); } elseif ($alias && (!Helpers::isIdentifier($alias) || isset(Helpers::Keywords[\strtolower($alias)]))) { throw new Nette\InvalidArgumentException("Value '{$alias}' is not valid alias."); } $name = \ltrim($name, '\\'); $aliases = \array_change_key_case($this->aliases[$of]); $used = [self::NameNormal => $this->classes, self::NameFunction => $this->functions, self::NameConstant => []][$of]; if ($alias === null) { $base = Helpers::extractShortName($name); $counter = null; do { $alias = $base . $counter; $lower = \strtolower($alias); $counter++; } while (isset($aliases[$lower]) && \strcasecmp($aliases[$lower], $name) !== 0 || isset($used[$lower])); } else { $lower = \strtolower($alias); if (isset($aliases[$lower]) && \strcasecmp($aliases[$lower], $name) !== 0) { throw new InvalidStateException("Alias '{$alias}' used already for '{$aliases[$lower]}', cannot use for '{$name}'."); } elseif (isset($used[$lower])) { throw new Nette\InvalidStateException("Name '{$alias}' used already for '{$this->name}\\{$used[$lower]->getName()}'."); } } $this->aliases[$of][$alias] = $name; return $this; } public function removeUse(string $name, string $of = self::NameNormal) : void { foreach ($this->aliases[$of] as $alias => $item) { if (\strcasecmp($item, $name) === 0) { unset($this->aliases[$of][$alias]); } } } /** @return static */ public function addUseFunction(string $name, ?string $alias = null) : self { return $this->addUse($name, $alias, self::NameFunction); } /** @return static */ public function addUseConstant(string $name, ?string $alias = null) : self { return $this->addUse($name, $alias, self::NameConstant); } /** @return string[] */ public function getUses(string $of = self::NameNormal) : array { \asort($this->aliases[$of]); return \array_filter($this->aliases[$of], function ($name, $alias) { return \strcasecmp(($this->name ? $this->name . '\\' : '') . $alias, $name); }, \ARRAY_FILTER_USE_BOTH); } /** @deprecated use simplifyName() */ public function unresolveName(string $name) : string { return $this->simplifyName($name); } public function resolveName(string $name, string $of = self::NameNormal) : string { if (isset(Helpers::Keywords[\strtolower($name)]) || $name === '') { return $name; } elseif ($name[0] === '\\') { return \substr($name, 1); } $aliases = \array_change_key_case($this->aliases[$of]); if ($of !== self::NameNormal) { return $aliases[\strtolower($name)] ?? $this->resolveName(Helpers::extractNamespace($name) . '\\') . Helpers::extractShortName($name); } $parts = \explode('\\', $name, 2); return ($res = $aliases[\strtolower($parts[0])] ?? null) ? $res . (isset($parts[1]) ? '\\' . $parts[1] : '') : $this->name . ($this->name ? '\\' : '') . $name; } public function simplifyType(string $type, string $of = self::NameNormal) : string { return \preg_replace_callback('~[\\w\\x7f-\\xff\\\\]+~', function ($m) use($of) { return $this->simplifyName($m[0], $of); }, $type); } public function simplifyName(string $name, string $of = self::NameNormal) : string { if (isset(Helpers::Keywords[\strtolower($name)]) || $name === '') { return $name; } $name = \ltrim($name, '\\'); if ($of !== self::NameNormal) { foreach ($this->aliases[$of] as $alias => $original) { if (\strcasecmp($original, $name) === 0) { return $alias; } } return $this->simplifyName(Helpers::extractNamespace($name) . '\\') . Helpers::extractShortName($name); } $shortest = null; $relative = self::startsWith($name, $this->name . '\\') ? \substr($name, \strlen($this->name) + 1) : null; foreach ($this->aliases[$of] as $alias => $original) { if ($relative && self::startsWith($relative . '\\', $alias . '\\')) { $relative = null; } if (self::startsWith($name . '\\', $original . '\\')) { $short = $alias . \substr($name, \strlen($original)); if (!isset($shortest) || \strlen($shortest) > \strlen($short)) { $shortest = $short; } } } if (isset($shortest, $relative) && \strlen($shortest) < \strlen($relative)) { return $shortest; } return $relative ?? $shortest ?? ($this->name ? '\\' : '') . $name; } /** @return static */ public function add(ClassType $class) : self { $name = $class->getName(); if ($name === null) { throw new Nette\InvalidArgumentException('Class does not have a name.'); } $lower = \strtolower($name); if ($orig = \array_change_key_case($this->aliases[self::NameNormal])[$lower] ?? null) { throw new Nette\InvalidStateException("Name '{$name}' used already as alias for {$orig}."); } $this->classes[$lower] = $class; return $this; } public function addClass(string $name) : ClassType { $this->add($class = new ClassType($name, $this)); return $class; } public function addInterface(string $name) : ClassType { return $this->addClass($name)->setType(ClassType::TYPE_INTERFACE); } public function addTrait(string $name) : ClassType { return $this->addClass($name)->setType(ClassType::TYPE_TRAIT); } public function addEnum(string $name) : ClassType { return $this->addClass($name)->setType(ClassType::TYPE_ENUM); } public function removeClass(string $name) : self { unset($this->classes[\strtolower($name)]); return $this; } public function addFunction(string $name) : GlobalFunction { $lower = \strtolower($name); if ($orig = \array_change_key_case($this->aliases[self::NameFunction])[$lower] ?? null) { throw new Nette\InvalidStateException("Name '{$name}' used already as alias for {$orig}."); } return $this->functions[$lower] = new GlobalFunction($name); } public function removeFunction(string $name) : self { unset($this->functions[\strtolower($name)]); return $this; } /** @return ClassType[] */ public function getClasses() : array { $res = []; foreach ($this->classes as $class) { $res[$class->getName()] = $class; } return $res; } /** @return GlobalFunction[] */ public function getFunctions() : array { $res = []; foreach ($this->functions as $fn) { $res[$fn->getName()] = $fn; } return $res; } private static function startsWith(string $a, string $b) : bool { return \strncasecmp($a, $b, \strlen($b)) === 0; } public function __toString() : string { try { return (new Printer())->printNamespace($this); } catch (\Throwable $e) { if (\PHP_VERSION_ID >= 70400) { throw $e; } \trigger_error('Exception in ' . __METHOD__ . "(): {$e->getMessage()} in {$e->getFile()}:{$e->getLine()}", \E_USER_ERROR); return ''; } } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\PhpGenerator; /** * PHP literal value. */ class Literal { /** @var string */ private $value; /** @var ?array */ private $args; public function __construct(string $value, ?array $args = null) { $this->value = $value; $this->args = $args; } public function __toString() : string { return $this->formatWith(new Dumper()); } /** @internal */ public function formatWith(Dumper $dumper) : string { return $this->args === null ? $this->value : $dumper->format($this->value, ...$this->args); } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\PhpGenerator; use _PHPStan_7d8742a37\Nette; /** * Global function. * * @property string $body */ final class GlobalFunction { use Nette\SmartObject; use Traits\FunctionLike; use Traits\NameAware; use Traits\CommentAware; use Traits\AttributeAware; public static function from(string $function, bool $withBody = \false) : self { return (new Factory())->fromFunctionReflection(new \ReflectionFunction($function), $withBody); } public static function withBodyFrom(string $function) : self { return (new Factory())->fromFunctionReflection(new \ReflectionFunction($function), \true); } public function __toString() : string { try { return (new Printer())->printFunction($this); } catch (\Throwable $e) { if (\PHP_VERSION_ID >= 70400) { throw $e; } \trigger_error('Exception in ' . __METHOD__ . "(): {$e->getMessage()} in {$e->getFile()}:{$e->getLine()}", \E_USER_ERROR); return ''; } } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\PhpGenerator; use _PHPStan_7d8742a37\Nette; /** * PHP code generator utils. */ final class Dumper { private const IndentLength = 4; /** @var int */ public $maxDepth = 50; /** @var int */ public $wrapLength = 120; /** @var string */ public $indentation = "\t"; /** * Returns a PHP representation of a variable. */ public function dump($var, int $column = 0) : string { return $this->dumpVar($var, [], 0, $column); } private function dumpVar(&$var, array $parents = [], int $level = 0, int $column = 0) : string { if ($var === null) { return 'null'; } elseif (\is_string($var)) { return $this->dumpString($var); } elseif (\is_array($var)) { return $this->dumpArray($var, $parents, $level, $column); } elseif ($var instanceof Literal) { return $this->dumpLiteral($var, $level); } elseif (\is_object($var)) { return $this->dumpObject($var, $parents, $level); } elseif (\is_resource($var)) { throw new Nette\InvalidArgumentException('Cannot dump resource.'); } else { return \var_export($var, \true); } } private function dumpString(string $s) : string { static $special = ["\r" => '\\r', "\n" => '\\n', "\t" => '\\t', "\x1b" => '\\e', '\\' => '\\\\']; $utf8 = \preg_match('##u', $s); $escaped = \preg_replace_callback($utf8 ? '#[\\p{C}\\\\]#u' : '#[\\x00-\\x1F\\x7F-\\xFF\\\\]#', function ($m) use($special) { return $special[$m[0]] ?? (\strlen($m[0]) === 1 ? '\\x' . \str_pad(\strtoupper(\dechex(\ord($m[0]))), 2, '0', \STR_PAD_LEFT) . '' : '\\u{' . \strtoupper(\ltrim(\dechex(self::utf8Ord($m[0])), '0')) . '}'); }, $s); return $s === \str_replace('\\\\', '\\', $escaped) ? "'" . \preg_replace('#\'|\\\\(?=[\'\\\\]|$)#D', '\\\\$0', $s) . "'" : '"' . \addcslashes($escaped, '"$') . '"'; } private static function utf8Ord(string $c) : int { $ord0 = \ord($c[0]); if ($ord0 < 0x80) { return $ord0; } elseif ($ord0 < 0xe0) { return ($ord0 << 6) + \ord($c[1]) - 0x3080; } elseif ($ord0 < 0xf0) { return ($ord0 << 12) + (\ord($c[1]) << 6) + \ord($c[2]) - 0xe2080; } else { return ($ord0 << 18) + (\ord($c[1]) << 12) + (\ord($c[2]) << 6) + \ord($c[3]) - 0x3c82080; } } private function dumpArray(array &$var, array $parents, int $level, int $column) : string { if (empty($var)) { return '[]'; } elseif ($level > $this->maxDepth || \in_array($var, $parents, \true)) { throw new Nette\InvalidArgumentException('Nesting level too deep or recursive dependency.'); } $space = \str_repeat($this->indentation, $level); $outInline = ''; $outWrapped = "\n{$space}"; $parents[] = $var; $counter = 0; $hideKeys = \is_int(($tmp = \array_keys($var))[0]) && $tmp === \range($tmp[0], $tmp[0] + \count($var) - 1); foreach ($var as $k => &$v) { $keyPart = $hideKeys && $k === $counter ? '' : $this->dumpVar($k) . ' => '; $counter = \is_int($k) ? \max($k + 1, $counter) : $counter; $outInline .= ($outInline === '' ? '' : ', ') . $keyPart; $outInline .= $this->dumpVar($v, $parents, 0, $column + \strlen($outInline)); $outWrapped .= $this->indentation . $keyPart . $this->dumpVar($v, $parents, $level + 1, \strlen($keyPart)) . ",\n{$space}"; } \array_pop($parents); $wrap = \strpos($outInline, "\n") !== \false || $level * self::IndentLength + $column + \strlen($outInline) + 3 > $this->wrapLength; // 3 = [], return '[' . ($wrap ? $outWrapped : $outInline) . ']'; } private function dumpObject($var, array $parents, int $level) : string { if ($var instanceof \Serializable) { return 'unserialize(' . $this->dumpString(\serialize($var)) . ')'; } elseif ($var instanceof \UnitEnum) { return '\\' . \get_class($var) . '::' . $var->name; } elseif ($var instanceof \Closure) { $inner = Nette\Utils\Callback::unwrap($var); if (Nette\Utils\Callback::isStatic($inner)) { return \PHP_VERSION_ID < 80100 ? '\\Closure::fromCallable(' . $this->dump($inner) . ')' : \implode('::', (array) $inner) . '(...)'; } throw new Nette\InvalidArgumentException('Cannot dump closure.'); } $class = \get_class($var); if ((new \ReflectionObject($var))->isAnonymous()) { throw new Nette\InvalidArgumentException('Cannot dump anonymous class.'); } elseif (\in_array($class, [\DateTime::class, \DateTimeImmutable::class], \true)) { return $this->format("new \\{$class}(?, new \\DateTimeZone(?))", $var->format('Y-m-d H:i:s.u'), $var->getTimeZone()->getName()); } $arr = (array) $var; $space = \str_repeat($this->indentation, $level); if ($level > $this->maxDepth || \in_array($var, $parents, \true)) { throw new Nette\InvalidArgumentException('Nesting level too deep or recursive dependency.'); } $out = "\n"; $parents[] = $var; if (\method_exists($var, '__sleep')) { foreach ($var->__sleep() as $v) { $props[$v] = $props["\x00*\x00{$v}"] = $props["\x00{$class}\x00{$v}"] = \true; } } foreach ($arr as $k => &$v) { if (!isset($props) || isset($props[$k])) { $out .= $space . $this->indentation . ($keyPart = $this->dumpVar($k) . ' => ') . $this->dumpVar($v, $parents, $level + 1, \strlen($keyPart)) . ",\n"; } } \array_pop($parents); $out .= $space; return $class === \stdClass::class ? "(object) [{$out}]" : '\\' . self::class . "::createObject('{$class}', [{$out}])"; } private function dumpLiteral(Literal $var, int $level) : string { $s = $var->formatWith($this); $s = Nette\Utils\Strings::indent(\trim($s), $level, $this->indentation); return \ltrim($s, $this->indentation); } /** * Generates PHP statement. Supports placeholders: ? \? $? ->? ::? ...? ...?: ?* */ public function format(string $statement, ...$args) : string { $tokens = \preg_split('#(\\.\\.\\.\\?:?|\\$\\?|->\\?|::\\?|\\\\\\?|\\?\\*|\\?(?!\\w))#', $statement, -1, \PREG_SPLIT_DELIM_CAPTURE); $res = ''; foreach ($tokens as $n => $token) { if ($n % 2 === 0) { $res .= $token; } elseif ($token === '\\?') { $res .= '?'; } elseif (!$args) { throw new Nette\InvalidArgumentException('Insufficient number of arguments.'); } elseif ($token === '?') { $res .= $this->dump(\array_shift($args), \strlen($res) - \strrpos($res, "\n")); } elseif ($token === '...?' || $token === '...?:' || $token === '?*') { $arg = \array_shift($args); if (!\is_array($arg)) { throw new Nette\InvalidArgumentException('Argument must be an array.'); } $res .= $this->dumpArguments($arg, \strlen($res) - \strrpos($res, "\n"), $token === '...?:'); } else { // $ -> :: $arg = \array_shift($args); if ($arg instanceof Literal || !Helpers::isIdentifier($arg)) { $arg = '{' . $this->dumpVar($arg) . '}'; } $res .= \substr($token, 0, -1) . $arg; } } if ($args) { throw new Nette\InvalidArgumentException('Insufficient number of placeholders.'); } return $res; } private function dumpArguments(array &$var, int $column, bool $named) : string { $outInline = $outWrapped = ''; foreach ($var as $k => &$v) { $k = !$named || \is_int($k) ? '' : $k . ': '; $outInline .= $outInline === '' ? '' : ', '; $outInline .= $k . $this->dumpVar($v, [$var], 0, $column + \strlen($outInline)); $outWrapped .= ($outWrapped === '' ? '' : ',') . "\n" . $this->indentation . $k . $this->dumpVar($v, [$var], 1); } return \count($var) > 1 && (\strpos($outInline, "\n") !== \false || $column + \strlen($outInline) > $this->wrapLength) ? $outWrapped . "\n" : $outInline; } /** * @internal */ public static function createObject(string $class, array $props) : object { return \unserialize('O' . \substr(\serialize($class), 1, -1) . \substr(\serialize($props), 1)); } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\PhpGenerator; use _PHPStan_7d8742a37\Nette; use _PHPStan_7d8742a37\Nette\Utils\Reflection; /** * Creates a representation based on reflection. */ final class Factory { use Nette\SmartObject; private $bodyCache = []; private $extractorCache = []; public function fromClassReflection(\ReflectionClass $from, bool $withBodies = \false, bool $materializeTraits = \true) : ClassType { if ($withBodies && $from->isAnonymous()) { throw new Nette\NotSupportedException('The $withBodies parameter cannot be used for anonymous functions.'); } $class = $from->isAnonymous() ? new ClassType() : new ClassType($from->getShortName(), new PhpNamespace($from->getNamespaceName())); if (\PHP_VERSION_ID >= 80100 && $from->isEnum()) { $class->setType($class::TYPE_ENUM); $from = new \ReflectionEnum($from->getName()); $enumIface = $from->isBacked() ? \BackedEnum::class : \UnitEnum::class; } else { $class->setType($from->isInterface() ? $class::TYPE_INTERFACE : ($from->isTrait() ? $class::TYPE_TRAIT : $class::TYPE_CLASS)); $class->setFinal($from->isFinal() && $class->isClass()); $class->setAbstract($from->isAbstract() && $class->isClass()); $enumIface = null; } $ifaces = $from->getInterfaceNames(); foreach ($ifaces as $iface) { $ifaces = \array_filter($ifaces, function (string $item) use($iface) : bool { return !\is_subclass_of($iface, $item); }); } if ($from->isInterface()) { $class->setExtends($ifaces); } else { $ifaces = \array_diff($ifaces, [$enumIface]); $class->setImplements($ifaces); } $class->setComment(Helpers::unformatDocComment((string) $from->getDocComment())); $class->setAttributes($this->getAttributes($from)); if ($from->getParentClass()) { $class->setExtends($from->getParentClass()->name); $class->setImplements(\array_diff($class->getImplements(), $from->getParentClass()->getInterfaceNames())); } $props = []; foreach ($from->getProperties() as $prop) { $declaringClass = $materializeTraits ? $prop->getDeclaringClass() : Reflection::getPropertyDeclaringClass($prop); if ($prop->isDefault() && $declaringClass->name === $from->name && (\PHP_VERSION_ID < 80000 || !$prop->isPromoted()) && !$class->isEnum()) { $props[] = $this->fromPropertyReflection($prop); } } $class->setProperties($props); $methods = $resolutions = []; foreach ($from->getMethods() as $method) { $realMethod = Reflection::getMethodDeclaringMethod($method); $declaringClass = ($materializeTraits ? $method : $realMethod)->getDeclaringClass(); if ($declaringClass->name === $from->name && (!$enumIface || !\method_exists($enumIface, $method->name))) { $methods[] = $m = $this->fromMethodReflection($method); if ($withBodies) { $realMethodClass = $realMethod->getDeclaringClass(); $bodies =& $this->bodyCache[$realMethodClass->name]; $bodies = $bodies ?? $this->getExtractor($realMethodClass)->extractMethodBodies($realMethodClass->name); if (isset($bodies[$realMethod->name])) { $m->setBody($bodies[$realMethod->name]); } } } $modifier = $realMethod->getModifiers() !== $method->getModifiers() ? ' ' . $this->getVisibility($method) : null; $alias = $realMethod->name !== $method->name ? ' ' . $method->name : ''; if ($modifier || $alias) { $resolutions[] = $realMethod->name . ' as' . $modifier . $alias; } } $class->setMethods($methods); if (!$materializeTraits) { foreach ($from->getTraitNames() as $trait) { $class->addTrait($trait, $resolutions); $resolutions = []; } } $consts = $cases = []; foreach ($from->getReflectionConstants() as $const) { if ($class->isEnum() && $from->hasCase($const->name)) { $cases[] = $this->fromCaseReflection($const); } elseif ($const->getDeclaringClass()->name === $from->name) { $consts[] = $this->fromConstantReflection($const); } } $class->setConstants($consts); $class->setCases($cases); return $class; } public function fromMethodReflection(\ReflectionMethod $from) : Method { $method = new Method($from->name); $method->setParameters(\array_map([$this, 'fromParameterReflection'], $from->getParameters())); $method->setStatic($from->isStatic()); $isInterface = $from->getDeclaringClass()->isInterface(); $method->setVisibility($isInterface ? null : $this->getVisibility($from)); $method->setFinal($from->isFinal()); $method->setAbstract($from->isAbstract() && !$isInterface); $method->setBody($from->isAbstract() ? null : ''); $method->setReturnReference($from->returnsReference()); $method->setVariadic($from->isVariadic()); $method->setComment(Helpers::unformatDocComment((string) $from->getDocComment())); $method->setAttributes($this->getAttributes($from)); if ($from->getReturnType() instanceof \ReflectionNamedType) { $method->setReturnType($from->getReturnType()->getName()); $method->setReturnNullable($from->getReturnType()->allowsNull()); } elseif ($from->getReturnType() instanceof \ReflectionUnionType || $from->getReturnType() instanceof \ReflectionIntersectionType) { $method->setReturnType((string) $from->getReturnType()); } return $method; } /** @return GlobalFunction|Closure */ public function fromFunctionReflection(\ReflectionFunction $from, bool $withBody = \false) { $function = $from->isClosure() ? new Closure() : new GlobalFunction($from->name); $function->setParameters(\array_map([$this, 'fromParameterReflection'], $from->getParameters())); $function->setReturnReference($from->returnsReference()); $function->setVariadic($from->isVariadic()); if (!$from->isClosure()) { $function->setComment(Helpers::unformatDocComment((string) $from->getDocComment())); } $function->setAttributes($this->getAttributes($from)); if ($from->getReturnType() instanceof \ReflectionNamedType) { $function->setReturnType($from->getReturnType()->getName()); $function->setReturnNullable($from->getReturnType()->allowsNull()); } elseif ($from->getReturnType() instanceof \ReflectionUnionType || $from->getReturnType() instanceof \ReflectionIntersectionType) { $function->setReturnType((string) $from->getReturnType()); } if ($withBody) { if ($from->isClosure()) { throw new Nette\NotSupportedException('The $withBody parameter cannot be used for closures.'); } $function->setBody($this->getExtractor($from)->extractFunctionBody($from->name)); } return $function; } /** @return Method|GlobalFunction|Closure */ public function fromCallable(callable $from) { $ref = Nette\Utils\Callback::toReflection($from); return $ref instanceof \ReflectionMethod ? $this->fromMethodReflection($ref) : $this->fromFunctionReflection($ref); } public function fromParameterReflection(\ReflectionParameter $from) : Parameter { $param = \PHP_VERSION_ID >= 80000 && $from->isPromoted() ? new PromotedParameter($from->name) : new Parameter($from->name); $param->setReference($from->isPassedByReference()); if ($from->getType() instanceof \ReflectionNamedType) { $param->setType($from->getType()->getName()); $param->setNullable($from->getType()->allowsNull()); } elseif ($from->getType() instanceof \ReflectionUnionType || $from->getType() instanceof \ReflectionIntersectionType) { $param->setType((string) $from->getType()); } if ($from->isDefaultValueAvailable()) { if ($from->isDefaultValueConstant()) { $parts = \explode('::', $from->getDefaultValueConstantName()); if (\count($parts) > 1) { $parts[0] = Helpers::tagName($parts[0]); } $param->setDefaultValue(new Literal(\implode('::', $parts))); } elseif (\is_object($from->getDefaultValue())) { $param->setDefaultValue($this->fromObject($from->getDefaultValue())); } else { $param->setDefaultValue($from->getDefaultValue()); } $param->setNullable($param->isNullable() && $param->getDefaultValue() !== null); } $param->setAttributes($this->getAttributes($from)); return $param; } public function fromConstantReflection(\ReflectionClassConstant $from) : Constant { $const = new Constant($from->name); $const->setValue($from->getValue()); $const->setVisibility($this->getVisibility($from)); $const->setFinal(\PHP_VERSION_ID >= 80100 ? $from->isFinal() : \false); $const->setComment(Helpers::unformatDocComment((string) $from->getDocComment())); $const->setAttributes($this->getAttributes($from)); return $const; } public function fromCaseReflection(\ReflectionClassConstant $from) : EnumCase { $const = new EnumCase($from->name); $const->setValue($from->getValue()->value ?? null); $const->setComment(Helpers::unformatDocComment((string) $from->getDocComment())); $const->setAttributes($this->getAttributes($from)); return $const; } public function fromPropertyReflection(\ReflectionProperty $from) : Property { $defaults = $from->getDeclaringClass()->getDefaultProperties(); $prop = new Property($from->name); $prop->setValue($defaults[$prop->getName()] ?? null); $prop->setStatic($from->isStatic()); $prop->setVisibility($this->getVisibility($from)); if (\PHP_VERSION_ID >= 70400) { if ($from->getType() instanceof \ReflectionNamedType) { $prop->setType($from->getType()->getName()); $prop->setNullable($from->getType()->allowsNull()); } elseif ($from->getType() instanceof \ReflectionUnionType || $from->getType() instanceof \ReflectionIntersectionType) { $prop->setType((string) $from->getType()); } $prop->setInitialized($from->hasType() && \array_key_exists($prop->getName(), $defaults)); $prop->setReadOnly(\PHP_VERSION_ID >= 80100 ? $from->isReadOnly() : \false); } else { $prop->setInitialized(\false); } $prop->setComment(Helpers::unformatDocComment((string) $from->getDocComment())); $prop->setAttributes($this->getAttributes($from)); return $prop; } public function fromObject(object $obj) : Literal { return new Literal('new \\' . \get_class($obj) . '(/* unknown */)'); } public function fromClassCode(string $code) : ClassType { $classes = $this->fromCode($code)->getClasses(); if (!$classes) { throw new Nette\InvalidStateException('The code does not contain any class.'); } return \reset($classes); } public function fromCode(string $code) : PhpFile { $reader = new Extractor($code); return $reader->extractAll(); } private function getAttributes($from) : array { if (\PHP_VERSION_ID < 80000) { return []; } return \array_map(function ($attr) { $args = $attr->getArguments(); foreach ($args as &$arg) { if (\is_object($arg)) { $arg = $this->fromObject($arg); } } return new Attribute($attr->getName(), $args); }, $from->getAttributes()); } private function getVisibility($from) : string { return $from->isPrivate() ? ClassType::VisibilityPrivate : ($from->isProtected() ? ClassType::VisibilityProtected : ClassType::VisibilityPublic); } private function getExtractor($from) : Extractor { $file = $from->getFileName(); $cache =& $this->extractorCache[$file]; if ($cache !== null) { return $cache; } elseif (!$file) { throw new Nette\InvalidStateException("Source code of {$from->name} not found."); } return new Extractor(\file_get_contents($file)); } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\PhpGenerator; use _PHPStan_7d8742a37\Nette; /** * Instance of PHP file. * * Generates: * - opening tag (<?php) * - doc comments * - one or more namespaces */ final class PhpFile { use Nette\SmartObject; use Traits\CommentAware; /** @var PhpNamespace[] */ private $namespaces = []; /** @var bool */ private $strictTypes = \false; public static function fromCode(string $code) : self { return (new Factory())->fromCode($code); } public function addClass(string $name) : ClassType { return $this->addNamespace(Helpers::extractNamespace($name))->addClass(Helpers::extractShortName($name)); } public function addInterface(string $name) : ClassType { return $this->addNamespace(Helpers::extractNamespace($name))->addInterface(Helpers::extractShortName($name)); } public function addTrait(string $name) : ClassType { return $this->addNamespace(Helpers::extractNamespace($name))->addTrait(Helpers::extractShortName($name)); } public function addEnum(string $name) : ClassType { return $this->addNamespace(Helpers::extractNamespace($name))->addEnum(Helpers::extractShortName($name)); } /** @param string|PhpNamespace $namespace */ public function addNamespace($namespace) : PhpNamespace { if ($namespace instanceof PhpNamespace) { $res = $this->namespaces[$namespace->getName()] = $namespace; } elseif (\is_string($namespace)) { $res = $this->namespaces[$namespace] = $this->namespaces[$namespace] ?? new PhpNamespace($namespace); } else { throw new Nette\InvalidArgumentException('Argument must be string|PhpNamespace.'); } foreach ($this->namespaces as $namespace) { $namespace->setBracketedSyntax(\count($this->namespaces) > 1 && isset($this->namespaces[''])); } return $res; } public function addFunction(string $name) : GlobalFunction { return $this->addNamespace(Helpers::extractNamespace($name))->addFunction(Helpers::extractShortName($name)); } /** @return PhpNamespace[] */ public function getNamespaces() : array { return $this->namespaces; } /** @return ClassType[] */ public function getClasses() : array { $classes = []; foreach ($this->namespaces as $n => $namespace) { $n .= $n ? '\\' : ''; foreach ($namespace->getClasses() as $c => $class) { $classes[$n . $c] = $class; } } return $classes; } /** @return GlobalFunction[] */ public function getFunctions() : array { $functions = []; foreach ($this->namespaces as $n => $namespace) { $n .= $n ? '\\' : ''; foreach ($namespace->getFunctions() as $f => $function) { $functions[$n . $f] = $function; } } return $functions; } /** @return static */ public function addUse(string $name, ?string $alias = null, string $of = PhpNamespace::NameNormal) : self { $this->addNamespace('')->addUse($name, $alias, $of); return $this; } /** * Adds declare(strict_types=1) to output. * @return static */ public function setStrictTypes(bool $on = \true) : self { $this->strictTypes = $on; return $this; } public function hasStrictTypes() : bool { return $this->strictTypes; } /** @deprecated use hasStrictTypes() */ public function getStrictTypes() : bool { return $this->strictTypes; } public function __toString() : string { try { return (new Printer())->printFile($this); } catch (\Throwable $e) { if (\PHP_VERSION_ID >= 70400) { throw $e; } \trigger_error('Exception in ' . __METHOD__ . "(): {$e->getMessage()} in {$e->getFile()}:{$e->getLine()}", \E_USER_ERROR); return ''; } } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\PhpGenerator; use _PHPStan_7d8742a37\Nette; /** * @internal */ final class Helpers { use Nette\StaticClass; public const ReIdentifier = '[a-zA-Z_\\x7f-\\xff][a-zA-Z0-9_\\x7f-\\xff]*'; public const Keywords = [ // built-in types 'string' => 1, 'int' => 1, 'float' => 1, 'bool' => 1, 'array' => 1, 'object' => 1, 'callable' => 1, 'iterable' => 1, 'void' => 1, 'null' => 1, 'mixed' => 1, 'false' => 1, 'never' => 1, // class keywords 'self' => 1, 'parent' => 1, 'static' => 1, // PHP keywords 'include' => 1, 'include_once' => 1, 'eval' => 1, 'require' => 1, 'require_once' => 1, 'or' => 1, 'xor' => 1, 'and' => 1, 'instanceof' => 1, 'new' => 1, 'clone' => 1, 'exit' => 1, 'if' => 1, 'elseif' => 1, 'else' => 1, 'endif' => 1, 'echo' => 1, 'do' => 1, 'while' => 1, 'endwhile' => 1, 'for' => 1, 'endfor' => 1, 'foreach' => 1, 'endforeach' => 1, 'declare' => 1, 'enddeclare' => 1, 'as' => 1, 'try' => 1, 'catch' => 1, 'finally' => 1, 'throw' => 1, 'use' => 1, 'insteadof' => 1, 'global' => 1, 'var' => 1, 'unset' => 1, 'isset' => 1, 'empty' => 1, 'continue' => 1, 'goto' => 1, 'function' => 1, 'const' => 1, 'return' => 1, 'print' => 1, 'yield' => 1, 'list' => 1, 'switch' => 1, 'endswitch' => 1, 'case' => 1, 'default' => 1, 'break' => 1, 'extends' => 1, 'implements' => 1, 'namespace' => 1, 'trait' => 1, 'interface' => 1, 'class' => 1, '__CLASS__' => 1, '__TRAIT__' => 1, '__FUNCTION__' => 1, '__METHOD__' => 1, '__LINE__' => 1, '__FILE__' => 1, '__DIR__' => 1, '__NAMESPACE__' => 1, 'fn' => 1, 'match' => 1, 'enum' => 1, 'abstract' => 1, 'final' => 1, 'private' => 1, 'protected' => 1, 'public' => 1, 'readonly' => 1, // additional reserved class names 'true' => 1, ]; /** @deprecated */ public const PHP_IDENT = self::ReIdentifier, KEYWORDS = self::Keywords; /** @deprecated use (new Nette\PhpGenerator\Dumper)->dump() */ public static function dump($var) : string { return (new Dumper())->dump($var); } /** @deprecated use (new Nette\PhpGenerator\Dumper)->format() */ public static function format(string $statement, ...$args) : string { return (new Dumper())->format($statement, ...$args); } /** @deprecated use (new Nette\PhpGenerator\Dumper)->format() */ public static function formatArgs(string $statement, array $args) : string { return (new Dumper())->format($statement, ...$args); } public static function formatDocComment(string $content) : string { $s = \trim($content); $s = \str_replace('*/', '* /', $s); if ($s === '') { return ''; } elseif (\strpos($content, "\n") === \false) { return "/** {$s} */\n"; } else { return \str_replace("\n", "\n * ", "/**\n{$s}") . "\n */\n"; } } public static function tagName(string $name, string $of = PhpNamespace::NameNormal) : string { return isset(self::Keywords[\strtolower($name)]) ? $name : "/*({$of}*/{$name}"; } public static function simplifyTaggedNames(string $code, ?PhpNamespace $namespace) : string { return \preg_replace_callback('~/\\*\\(([ncf])\\*/([\\w\\x7f-\\xff\\\\]++)~', function ($m) use($namespace) { [, $of, $name] = $m; return $namespace ? $namespace->simplifyType($name, $of) : $name; }, $code); } public static function unformatDocComment(string $comment) : string { return \preg_replace('#^\\s*\\* ?#m', '', \trim(\trim(\trim($comment), '/*'))); } public static function unindent(string $s, int $level = 1) : string { return $level ? \preg_replace('#^(\\t| {4}){1,' . $level . '}#m', '', $s) : $s; } public static function isIdentifier($value) : bool { return \is_string($value) && \preg_match('#^' . self::ReIdentifier . '$#D', $value); } public static function isNamespaceIdentifier($value, bool $allowLeadingSlash = \false) : bool { $re = '#^' . ($allowLeadingSlash ? '\\\\?' : '') . self::ReIdentifier . '(\\\\' . self::ReIdentifier . ')*$#D'; return \is_string($value) && \preg_match($re, $value); } public static function extractNamespace(string $name) : string { return ($pos = \strrpos($name, '\\')) ? \substr($name, 0, $pos) : ''; } public static function extractShortName(string $name) : string { return ($pos = \strrpos($name, '\\')) === \false ? $name : \substr($name, $pos + 1); } public static function tabsToSpaces(string $s, int $count = 4) : string { return \str_replace("\t", \str_repeat(' ', $count), $s); } /** @internal */ public static function createObject(string $class, array $props) : object { return Dumper::createObject($class, $props); } public static function validateType(?string $type, bool &$nullable) : ?string { if ($type === '' || $type === null) { return null; } if (!\preg_match('#(?: \\?[\\w\\\\]+| [\\w\\\\]+ (?: (&[\\w\\\\]+)* | (\\|[\\w\\\\]+)* ) )()$#xAD', $type)) { throw new Nette\InvalidArgumentException("Value '{$type}' is not valid type."); } if ($type[0] === '?') { $nullable = \true; return \substr($type, 1); } return $type; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\PhpGenerator; use _PHPStan_7d8742a37\Nette; /** * Class/Interface/Trait/Enum description. * * @property Method[] $methods * @property Property[] $properties */ final class ClassType { use Nette\SmartObject; use Traits\CommentAware; use Traits\AttributeAware; public const TYPE_CLASS = 'class', TYPE_INTERFACE = 'interface', TYPE_TRAIT = 'trait', TYPE_ENUM = 'enum'; public const VisibilityPublic = 'public', VisibilityProtected = 'protected', VisibilityPrivate = 'private'; public const VISIBILITY_PUBLIC = self::VisibilityPublic, VISIBILITY_PROTECTED = self::VisibilityProtected, VISIBILITY_PRIVATE = self::VisibilityPrivate; /** @var PhpNamespace|null */ private $namespace; /** @var string|null */ private $name; /** @var string class|interface|trait */ private $type = self::TYPE_CLASS; /** @var bool */ private $final = \false; /** @var bool */ private $abstract = \false; /** @var string|string[] */ private $extends = []; /** @var string[] */ private $implements = []; /** @var TraitUse[] */ private $traits = []; /** @var Constant[] name => Constant */ private $consts = []; /** @var Property[] name => Property */ private $properties = []; /** @var Method[] name => Method */ private $methods = []; /** @var EnumCase[] name => EnumCase */ private $cases = []; public static function class(?string $name) : self { return new self($name); } public static function interface(string $name) : self { return (new self($name))->setType(self::TYPE_INTERFACE); } public static function trait(string $name) : self { return (new self($name))->setType(self::TYPE_TRAIT); } public static function enum(string $name) : self { return (new self($name))->setType(self::TYPE_ENUM); } /** * @param string|object $class */ public static function from($class, bool $withBodies = \false, bool $materializeTraits = \true) : self { return (new Factory())->fromClassReflection(new \ReflectionClass($class), $withBodies, $materializeTraits); } /** * @param string|object $class */ public static function withBodiesFrom($class) : self { return (new Factory())->fromClassReflection(new \ReflectionClass($class), \true); } public static function fromCode(string $code) : self { return (new Factory())->fromClassCode($code); } public function __construct(?string $name = null, ?PhpNamespace $namespace = null) { $this->setName($name); $this->namespace = $namespace; } public function __toString() : string { try { return (new Printer())->printClass($this, $this->namespace); } catch (\Throwable $e) { if (\PHP_VERSION_ID >= 70400) { throw $e; } \trigger_error('Exception in ' . __METHOD__ . "(): {$e->getMessage()} in {$e->getFile()}:{$e->getLine()}", \E_USER_ERROR); return ''; } } /** @deprecated an object can be in multiple namespaces */ public function getNamespace() : ?PhpNamespace { return $this->namespace; } /** @return static */ public function setName(?string $name) : self { if ($name !== null && (!Helpers::isIdentifier($name) || isset(Helpers::Keywords[\strtolower($name)]))) { throw new Nette\InvalidArgumentException("Value '{$name}' is not valid class name."); } $this->name = $name; return $this; } public function getName() : ?string { return $this->name; } /** @deprecated */ public function setClass() : self { $this->type = self::TYPE_CLASS; return $this; } public function isClass() : bool { return $this->type === self::TYPE_CLASS; } /** @return static */ public function setInterface() : self { $this->type = self::TYPE_INTERFACE; return $this; } public function isInterface() : bool { return $this->type === self::TYPE_INTERFACE; } /** @return static */ public function setTrait() : self { $this->type = self::TYPE_TRAIT; return $this; } public function isTrait() : bool { return $this->type === self::TYPE_TRAIT; } public function isEnum() : bool { return $this->type === self::TYPE_ENUM; } /** @return static */ public function setType(string $type) : self { if (!\in_array($type, [self::TYPE_CLASS, self::TYPE_INTERFACE, self::TYPE_TRAIT, self::TYPE_ENUM], \true)) { throw new Nette\InvalidArgumentException('Argument must be class|interface|trait|enum.'); } $this->type = $type; return $this; } public function getType() : string { return $this->type; } /** @return static */ public function setFinal(bool $state = \true) : self { $this->final = $state; return $this; } public function isFinal() : bool { return $this->final; } /** @return static */ public function setAbstract(bool $state = \true) : self { $this->abstract = $state; return $this; } public function isAbstract() : bool { return $this->abstract; } /** * @param string|string[] $names * @return static */ public function setExtends($names) : self { if (!\is_string($names) && !\is_array($names)) { throw new Nette\InvalidArgumentException('Argument must be string or string[].'); } $this->validateNames((array) $names); $this->extends = $names; return $this; } /** @return string|string[] */ public function getExtends() { return $this->extends; } /** @return static */ public function addExtend(string $name) : self { $this->validateNames([$name]); $this->extends = (array) $this->extends; $this->extends[] = $name; return $this; } /** * @param string[] $names * @return static */ public function setImplements(array $names) : self { $this->validateNames($names); $this->implements = $names; return $this; } /** @return string[] */ public function getImplements() : array { return $this->implements; } /** @return static */ public function addImplement(string $name) : self { $this->validateNames([$name]); $this->implements[] = $name; return $this; } /** @return static */ public function removeImplement(string $name) : self { $this->implements = \array_diff($this->implements, [$name]); return $this; } /** * @param string[]|TraitUse[] $traits * @return static */ public function setTraits(array $traits) : self { $this->traits = []; foreach ($traits as $trait) { if (!$trait instanceof TraitUse) { $trait = new TraitUse($trait); } $this->traits[$trait->getName()] = $trait; } return $this; } /** @return string[] */ public function getTraits() : array { return \array_keys($this->traits); } /** @internal */ public function getTraitResolutions() : array { return $this->traits; } /** * @param array|bool $resolutions * @return static|TraitUse */ public function addTrait(string $name, $resolutions = []) { $this->traits[$name] = $trait = new TraitUse($name); if ($resolutions === \true) { return $trait; } \array_map(function ($item) use($trait) { $trait->addResolution($item); }, $resolutions); return $this; } /** @return static */ public function removeTrait(string $name) : self { unset($this->traits[$name]); return $this; } /** * @param Method|Property|Constant|EnumCase|TraitUse $member * @return static */ public function addMember($member) : self { if ($member instanceof Method) { if ($this->isInterface()) { $member->setBody(null); } $this->methods[\strtolower($member->getName())] = $member; } elseif ($member instanceof Property) { $this->properties[$member->getName()] = $member; } elseif ($member instanceof Constant) { $this->consts[$member->getName()] = $member; } elseif ($member instanceof EnumCase) { $this->cases[$member->getName()] = $member; } elseif ($member instanceof TraitUse) { $this->traits[$member->getName()] = $member; } else { throw new Nette\InvalidArgumentException('Argument must be Method|Property|Constant|EnumCase|TraitUse.'); } return $this; } /** * @param Constant[]|mixed[] $consts * @return static */ public function setConstants(array $consts) : self { $this->consts = []; foreach ($consts as $k => $const) { if (!$const instanceof Constant) { $const = (new Constant($k))->setValue($const)->setPublic(); } $this->consts[$const->getName()] = $const; } return $this; } /** @return Constant[] */ public function getConstants() : array { return $this->consts; } public function addConstant(string $name, $value) : Constant { return $this->consts[$name] = (new Constant($name))->setValue($value)->setPublic(); } /** @return static */ public function removeConstant(string $name) : self { unset($this->consts[$name]); return $this; } /** * Sets cases to enum * @param EnumCase[] $cases * @return static */ public function setCases(array $cases) : self { (function (EnumCase ...$cases) { })(...\array_values($cases)); $this->cases = []; foreach ($cases as $case) { $this->cases[$case->getName()] = $case; } return $this; } /** @return EnumCase[] */ public function getCases() : array { return $this->cases; } /** Adds case to enum */ public function addCase(string $name, $value = null) : EnumCase { return $this->cases[$name] = (new EnumCase($name))->setValue($value); } /** @return static */ public function removeCase(string $name) : self { unset($this->cases[$name]); return $this; } /** * @param Property[] $props * @return static */ public function setProperties(array $props) : self { (function (Property ...$props) { })(...\array_values($props)); $this->properties = []; foreach ($props as $v) { $this->properties[$v->getName()] = $v; } return $this; } /** @return Property[] */ public function getProperties() : array { return $this->properties; } public function getProperty(string $name) : Property { if (!isset($this->properties[$name])) { throw new Nette\InvalidArgumentException("Property '{$name}' not found."); } return $this->properties[$name]; } /** * @param string $name without $ */ public function addProperty(string $name, $value = null) : Property { return $this->properties[$name] = \func_num_args() > 1 ? (new Property($name))->setValue($value) : new Property($name); } /** * @param string $name without $ * @return static */ public function removeProperty(string $name) : self { unset($this->properties[$name]); return $this; } public function hasProperty(string $name) : bool { return isset($this->properties[$name]); } /** * @param Method[] $methods * @return static */ public function setMethods(array $methods) : self { (function (Method ...$methods) { })(...\array_values($methods)); $this->methods = []; foreach ($methods as $m) { $this->methods[\strtolower($m->getName())] = $m; } return $this; } /** @return Method[] */ public function getMethods() : array { $res = []; foreach ($this->methods as $m) { $res[$m->getName()] = $m; } return $res; } public function getMethod(string $name) : Method { $m = $this->methods[\strtolower($name)] ?? null; if (!$m) { throw new Nette\InvalidArgumentException("Method '{$name}' not found."); } return $m; } public function addMethod(string $name) : Method { $method = new Method($name); if ($this->isInterface()) { $method->setBody(null); } else { $method->setPublic(); } return $this->methods[\strtolower($name)] = $method; } /** @return static */ public function removeMethod(string $name) : self { unset($this->methods[\strtolower($name)]); return $this; } public function hasMethod(string $name) : bool { return isset($this->methods[\strtolower($name)]); } /** @throws Nette\InvalidStateException */ public function validate() : void { if ($this->isEnum() && ($this->abstract || $this->final || $this->extends || $this->properties)) { throw new Nette\InvalidStateException("Enum '{$this->name}' cannot be abstract or final or extends class or have properties."); } elseif (!$this->name && ($this->abstract || $this->final)) { throw new Nette\InvalidStateException('Anonymous class cannot be abstract or final.'); } elseif ($this->abstract && $this->final) { throw new Nette\InvalidStateException("Class '{$this->name}' cannot be abstract and final at the same time."); } } private function validateNames(array $names) : void { foreach ($names as $name) { if (!Helpers::isNamespaceIdentifier($name, \true)) { throw new Nette\InvalidArgumentException("Value '{$name}' is not valid class name."); } } } public function __clone() { $clone = function ($item) { return clone $item; }; $this->traits = \array_map($clone, $this->traits); $this->cases = \array_map($clone, $this->cases); $this->consts = \array_map($clone, $this->consts); $this->properties = \array_map($clone, $this->properties); $this->methods = \array_map($clone, $this->methods); } } <?php /** * Rules for Nette Coding Standard * https://github.com/nette/coding-standard */ declare (strict_types=1); namespace _PHPStan_7d8742a37; return [ // constant NULL, FALSE in src/PhpGenerator/Type.php 'constant_case' => \false, 'lowercase_static_reference' => \false, ]; <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Neon; /** @internal */ final class Parser { /** @var TokenStream */ private $tokens; /** @var int[] */ private $posToLine = []; public function parse(TokenStream $tokens) : Node { $this->tokens = $tokens; $this->initLines(); while ($this->tokens->consume(Token::Newline)) { } $node = $this->parseBlock($this->tokens->getIndentation()); while ($this->tokens->consume(Token::Newline)) { } if ($this->tokens->isNext()) { $this->tokens->error(); } return $node; } private function parseBlock(string $indent, bool $onlyBullets = \false) : Node { $res = new Node\BlockArrayNode($indent); $this->injectPos($res); $keyCheck = []; loop: $item = new Node\ArrayItemNode(); $this->injectPos($item); if ($this->tokens->consume('-')) { // continue } elseif (!$this->tokens->isNext() || $onlyBullets) { return $res->items ? $res : $this->injectPos(new Node\LiteralNode(null)); } else { $value = $this->parseValue(); if ($this->tokens->consume(':', '=')) { $this->checkArrayKey($value, $keyCheck); $item->key = $value; } else { if ($res->items) { $this->tokens->error(); } return $value; } } $res->items[] = $item; $item->value = new Node\LiteralNode(null); $this->injectPos($item->value); if ($this->tokens->consume(Token::Newline)) { while ($this->tokens->consume(Token::Newline)) { } $nextIndent = $this->tokens->getIndentation(); if (\strncmp($nextIndent, $indent, \min(\strlen($nextIndent), \strlen($indent)))) { $this->tokens->error('Invalid combination of tabs and spaces'); } elseif (\strlen($nextIndent) > \strlen($indent)) { // open new block $item->value = $this->parseBlock($nextIndent); } elseif (\strlen($nextIndent) < \strlen($indent)) { // close block return $res; } elseif ($item->key !== null && $this->tokens->isNext('-')) { // special dash subblock $item->value = $this->parseBlock($indent, \true); } } elseif ($item->key === null) { $item->value = $this->parseBlock($indent . ' '); // open new block after dash } elseif ($this->tokens->isNext()) { $item->value = $this->parseValue(); if ($this->tokens->isNext() && !$this->tokens->isNext(Token::Newline)) { $this->tokens->error(); } } if ($item->value instanceof Node\BlockArrayNode) { $item->value->indentation = \substr($item->value->indentation, \strlen($indent)); } $this->injectPos($res, $res->startTokenPos, $item->value->endTokenPos); $this->injectPos($item, $item->startTokenPos, $item->value->endTokenPos); while ($this->tokens->consume(Token::Newline)) { } if (!$this->tokens->isNext()) { return $res; } $nextIndent = $this->tokens->getIndentation(); if (\strncmp($nextIndent, $indent, \min(\strlen($nextIndent), \strlen($indent)))) { $this->tokens->error('Invalid combination of tabs and spaces'); } elseif (\strlen($nextIndent) > \strlen($indent)) { $this->tokens->error('Bad indentation'); } elseif (\strlen($nextIndent) < \strlen($indent)) { // close block return $res; } goto loop; } private function parseValue() : Node { if ($token = $this->tokens->consume(Token::String)) { try { $node = new Node\StringNode(Node\StringNode::parse($token->value)); $this->injectPos($node, $this->tokens->getPos() - 1); } catch (Exception $e) { $this->tokens->error($e->getMessage(), $this->tokens->getPos() - 1); } } elseif ($token = $this->tokens->consume(Token::Literal)) { $pos = $this->tokens->getPos() - 1; $node = new Node\LiteralNode(Node\LiteralNode::parse($token->value, $this->tokens->isNext(':', '='))); $this->injectPos($node, $pos); } elseif ($this->tokens->isNext('[', '(', '{')) { $node = $this->parseBraces(); } else { $this->tokens->error(); } return $this->parseEntity($node); } private function parseEntity(Node $node) : Node { if (!$this->tokens->isNext('(')) { return $node; } $attributes = $this->parseBraces(); $entities[] = $this->injectPos(new Node\EntityNode($node, $attributes->items), $node->startTokenPos, $attributes->endTokenPos); while ($token = $this->tokens->consume(Token::Literal)) { $valueNode = new Node\LiteralNode(Node\LiteralNode::parse($token->value)); $this->injectPos($valueNode, $this->tokens->getPos() - 1); if ($this->tokens->isNext('(')) { $attributes = $this->parseBraces(); $entities[] = $this->injectPos(new Node\EntityNode($valueNode, $attributes->items), $valueNode->startTokenPos, $attributes->endTokenPos); } else { $entities[] = $this->injectPos(new Node\EntityNode($valueNode), $valueNode->startTokenPos); break; } } return \count($entities) === 1 ? $entities[0] : $this->injectPos(new Node\EntityChainNode($entities), $node->startTokenPos, \end($entities)->endTokenPos); } private function parseBraces() : Node\InlineArrayNode { $token = $this->tokens->consume(); $endBrace = ['[' => ']', '{' => '}', '(' => ')'][$token->value]; $res = new Node\InlineArrayNode($token->value); $this->injectPos($res, $this->tokens->getPos() - 1); $keyCheck = []; loop: while ($this->tokens->consume(Token::Newline)) { } if ($this->tokens->consume($endBrace)) { $this->injectPos($res, $res->startTokenPos, $this->tokens->getPos() - 1); return $res; } $res->items[] = $item = new Node\ArrayItemNode(); $this->injectPos($item, $this->tokens->getPos()); $value = $this->parseValue(); if ($this->tokens->consume(':', '=')) { $this->checkArrayKey($value, $keyCheck); $item->key = $value; $item->value = $this->tokens->isNext(Token::Newline, ',', $endBrace) ? $this->injectPos(new Node\LiteralNode(null), $this->tokens->getPos()) : $this->parseValue(); } else { $item->value = $value; } $this->injectPos($item, $item->startTokenPos, $item->value->endTokenPos); if ($this->tokens->consume(',', Token::Newline)) { goto loop; } while ($this->tokens->consume(Token::Newline)) { } if (!$this->tokens->isNext($endBrace)) { $this->tokens->error(); } goto loop; } /** @param true[] $arr */ private function checkArrayKey(Node $key, array &$arr) : void { if (!$key instanceof Node\StringNode && !$key instanceof Node\LiteralNode || !\is_scalar($key->value)) { $this->tokens->error('Unacceptable key', $key->startTokenPos); } $k = (string) $key->value; if (\array_key_exists($k, $arr)) { $this->tokens->error("Duplicated key '{$k}'", $key->startTokenPos); } $arr[$k] = \true; } private function injectPos(Node $node, ?int $start = null, ?int $end = null) : Node { $node->startTokenPos = $start ?? $this->tokens->getPos(); $node->startLine = $this->posToLine[$node->startTokenPos]; $node->endTokenPos = $end ?? $node->startTokenPos; $node->endLine = $this->posToLine[$node->endTokenPos + 1] ?? \end($this->posToLine); return $node; } private function initLines() : void { $this->posToLine = []; $line = 1; foreach ($this->tokens->getTokens() as $token) { $this->posToLine[] = $line; $line += \substr_count($token->value, "\n"); } $this->posToLine[] = $line; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Neon; /** * The exception that indicates error of NEON processing. */ class Exception extends \Exception { } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Neon; /** * Representation of NEON entity 'foo(bar=1)' */ final class Entity extends \stdClass { /** @var mixed */ public $value; /** @var mixed[] */ public $attributes; public function __construct($value, array $attrs = []) { $this->value = $value; $this->attributes = $attrs; } /** @param mixed[] $properties */ public static function __set_state(array $properties) { return new self($properties['value'], $properties['attributes']); } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Neon; /** @internal */ final class Token { public const String = 1; public const Literal = 2; public const Char = 0; public const Comment = 3; public const Newline = 4; public const Whitespace = 5; /** @var string */ public $value; /** @var int|string */ public $type; public function __construct(string $value, $type) { $this->value = $value; $this->type = $type; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Neon; /** * @implements \IteratorAggregate<Node> */ abstract class Node implements \IteratorAggregate { /** @var ?int */ public $startTokenPos; /** @var ?int */ public $endTokenPos; /** @var ?int */ public $startLine; /** @var ?int */ public $endLine; /** @return mixed */ public abstract function toValue(); public abstract function toString() : string; public function &getIterator() : \Generator { return; yield; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Neon; /** * Parser for Nette Object Notation. * @internal */ final class Decoder { /** * Decodes a NEON string. * @return mixed */ public function decode(string $input) { $node = $this->parseToNode($input); return $node->toValue(); } public function parseToNode(string $input) : Node { $lexer = new Lexer(); $parser = new Parser(); $tokens = $lexer->tokenize($input); return $parser->parse($tokens); } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Neon; /** * Converts value to NEON format. * @internal */ final class Encoder { /** @deprecated */ public const BLOCK = \true; /** @var bool */ public $blockMode = \false; /** @var string */ public $indentation = "\t"; /** * Returns the NEON representation of a value. */ public function encode($val) : string { $node = $this->valueToNode($val, $this->blockMode); return $node->toString(); } public function valueToNode($val, bool $blockMode = \false) : Node { if ($val instanceof \DateTimeInterface) { return new Node\LiteralNode($val); } elseif ($val instanceof Entity && $val->value === Neon::Chain) { $node = new Node\EntityChainNode(); foreach ($val->attributes as $entity) { $node->chain[] = $this->valueToNode($entity); } return $node; } elseif ($val instanceof Entity) { return new Node\EntityNode($this->valueToNode($val->value), $this->arrayToNodes((array) $val->attributes)); } elseif (\is_object($val) || \is_array($val)) { if ($blockMode) { $node = new Node\BlockArrayNode(); } else { $isList = \is_array($val) && (!$val || \array_keys($val) === \range(0, \count($val) - 1)); $node = new Node\InlineArrayNode($isList ? '[' : '{'); } $node->items = $this->arrayToNodes($val, $blockMode); return $node; } elseif (\is_string($val) && Lexer::requiresDelimiters($val)) { return new Node\StringNode($val); } else { return new Node\LiteralNode($val); } } /** @return Node\ArrayItemNode[] */ private function arrayToNodes($val, bool $blockMode = \false) : array { $res = []; $counter = 0; $hide = \true; foreach ($val as $k => $v) { $res[] = $item = new Node\ArrayItemNode(); $item->key = $hide && $k === $counter ? null : self::valueToNode($k); $item->value = self::valueToNode($v, $blockMode); if ($item->value instanceof Node\BlockArrayNode) { $item->value->indentation = $this->indentation; } if ($hide && \is_int($k)) { $hide = $k === $counter; $counter = \max($k + 1, $counter); } } return $res; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Neon; /** @internal */ final class Lexer { public const Patterns = [ // strings Token::String => ' \'\'\'\\n (?:(?: [^\\n] | \\n(?![\\t\\ ]*+\'\'\') )*+ \\n)?[\\t\\ ]*+\'\'\' | """\\n (?:(?: [^\\n] | \\n(?![\\t\\ ]*+""") )*+ \\n)?[\\t\\ ]*+""" | \' (?: \'\' | [^\'\\n] )*+ \' | " (?: \\\\. | [^"\\\\\\n] )*+ " ', // literal / boolean / integer / float Token::Literal => ' (?: [^#"\',:=[\\]{}()\\n\\t\\ `-] | (?<!["\']) [:-] [^"\',=[\\]{}()\\n\\t\\ ] ) (?: [^,:=\\]})(\\n\\t\\ ]++ | :(?! [\\n\\t\\ ,\\]})] | $ ) | [\\ \\t]++ [^#,:=\\]})(\\n\\t\\ ] )*+ ', // punctuation Token::Char => '[,:=[\\]{}()-]', // comment Token::Comment => '\\#.*+', // new line Token::Newline => '\\n++', // whitespace Token::Whitespace => '[\\t\\ ]++', ]; public function tokenize(string $input) : TokenStream { $input = \str_replace("\r", '', $input); $pattern = '~(' . \implode(')|(', self::Patterns) . ')~Amixu'; $res = \preg_match_all($pattern, $input, $tokens, \PREG_SET_ORDER); if ($res === \false) { throw new Exception('Invalid UTF-8 sequence.'); } $types = \array_keys(self::Patterns); $offset = 0; foreach ($tokens as &$token) { $type = null; for ($i = 1; $i <= \count($types); $i++) { if (!isset($token[$i])) { break; } elseif ($token[$i] !== '') { $type = $types[$i - 1]; if ($type === Token::Char) { $type = $token[0]; } break; } } $token = new Token($token[0], $type); $offset += \strlen($token->value); } $stream = new TokenStream($tokens); if ($offset !== \strlen($input)) { $s = \str_replace("\n", '\\n', \substr($input, $offset, 40)); $stream->error("Unexpected '{$s}'", \count($tokens)); } return $stream; } public static function requiresDelimiters(string $s) : bool { return \preg_match('~[\\x00-\\x1F]|^[+-.]?\\d|^(true|false|yes|no|on|off|null)$~Di', $s) || !\preg_match('~^' . self::Patterns[Token::Literal] . '$~Dx', $s); } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Neon; /** @internal */ final class TokenStream { /** @var Token[] */ private $tokens; /** @var int */ private $pos = 0; public function __construct(array $tokens) { $this->tokens = $tokens; } public function getPos() : int { return $this->pos; } /** @return Token[] */ public function getTokens() : array { return $this->tokens; } public function isNext(...$types) : bool { while (\in_array($this->tokens[$this->pos]->type ?? null, [Token::Comment, Token::Whitespace], \true)) { $this->pos++; } return $types ? \in_array($this->tokens[$this->pos]->type ?? null, $types, \true) : isset($this->tokens[$this->pos]); } public function consume(...$types) : ?Token { return $this->isNext(...$types) ? $this->tokens[$this->pos++] : null; } public function getIndentation() : string { return \in_array($this->tokens[$this->pos - 2]->type ?? null, [Token::Newline, null], \true) && ($this->tokens[$this->pos - 1]->type ?? null) === Token::Whitespace ? $this->tokens[$this->pos - 1]->value : ''; } /** @return never */ public function error(?string $message = null, ?int $pos = null) : void { $pos = $pos ?? $this->pos; $input = ''; foreach ($this->tokens as $i => $token) { if ($i >= $pos) { break; } $input .= $token->value; } $line = \substr_count($input, "\n") + 1; $col = \strlen($input) - \strrpos("\n" . $input, "\n") + 1; $token = $this->tokens[$pos] ?? null; $message = $message ?? 'Unexpected ' . ($token === null ? 'end' : "'" . \str_replace("\n", '<new line>', \substr($this->tokens[$pos]->value, 0, 40)) . "'"); throw new Exception("{$message} on line {$line}, column {$col}."); } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Neon; /** * Simple parser & generator for Nette Object Notation. * @see https://ne-on.org */ final class Neon { public const BLOCK = Encoder::BLOCK; public const Chain = '!!chain'; public const CHAIN = self::Chain; /** * Returns value converted to NEON. */ public static function encode($value, bool $blockMode = \false, string $indentation = "\t") : string { $encoder = new Encoder(); $encoder->blockMode = $blockMode; $encoder->indentation = $indentation; return $encoder->encode($value); } /** * Converts given NEON to PHP value. * @return mixed */ public static function decode(string $input) { $decoder = new Decoder(); return $decoder->decode($input); } /** * Converts given NEON file to PHP value. * @return mixed */ public static function decodeFile(string $file) { if (!\is_file($file)) { throw new Exception("File '{$file}' does not exist."); } $input = \file_get_contents($file); if (\substr($input, 0, 3) === "") { // BOM $input = \substr($input, 3); } return self::decode($input); } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Neon; /** @internal */ final class Traverser { public const DontTraverseChildren = 1; public const StopTraversal = 2; /** @var callable(Node): (Node|int|null)|null */ private $enter; /** @var callable(Node): (Node|int|null)|null */ private $leave; /** @var bool */ private $stop; /** * @param callable(Node): (Node|int|null)|null $enter * @param callable(Node): (Node|int|null)|null $leave */ public function traverse(Node $node, ?callable $enter = null, ?callable $leave = null) : Node { $this->enter = $enter; $this->leave = $leave; $this->stop = \false; return $this->traverseNode($node); } private function traverseNode(Node $node) : Node { $children = \true; if ($this->enter) { $res = ($this->enter)($node); if ($res instanceof Node) { $node = $res; } elseif ($res === self::DontTraverseChildren) { $children = \false; } elseif ($res === self::StopTraversal) { $this->stop = \true; $children = \false; } } if ($children) { foreach ($node as &$subnode) { $subnode = $this->traverseNode($subnode); if ($this->stop) { break; } } } if (!$this->stop && $this->leave) { $res = ($this->leave)($node); if ($res instanceof Node) { $node = $res; } elseif ($res === self::StopTraversal) { $this->stop = \true; } } return $node; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Neon\Node; use _PHPStan_7d8742a37\Nette\Neon; use _PHPStan_7d8742a37\Nette\Neon\Node; /** @internal */ final class EntityChainNode extends Node { /** @var EntityNode[] */ public $chain = []; public function __construct(array $chain = []) { $this->chain = $chain; } public function toValue() : Neon\Entity { $entities = []; foreach ($this->chain as $item) { $entities[] = $item->toValue(); } return new Neon\Entity(Neon\Neon::Chain, $entities); } public function toString() : string { return \implode('', \array_map(function ($entity) { return $entity->toString(); }, $this->chain)); } public function &getIterator() : \Generator { foreach ($this->chain as &$item) { (yield $item); } } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Neon\Node; /** @internal */ final class BlockArrayNode extends ArrayNode { /** @var string */ public $indentation; public function __construct(string $indentation = '') { $this->indentation = $indentation; } public function toString() : string { if (\count($this->items) === 0) { return '[]'; } $res = ArrayItemNode::itemsToBlockString($this->items); return \preg_replace('#^(?=.)#m', $this->indentation, $res); } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Neon\Node; use _PHPStan_7d8742a37\Nette\Neon\Node; /** @internal */ final class ArrayItemNode extends Node { /** @var ?Node */ public $key; /** @var Node */ public $value; /** * @param self[] $items * @return mixed[] */ public static function itemsToArray(array $items) : array { $res = []; foreach ($items as $item) { if ($item->key === null) { $res[] = $item->value->toValue(); } else { $res[(string) $item->key->toValue()] = $item->value->toValue(); } } return $res; } /** @param self[] $items */ public static function itemsToInlineString(array $items) : string { $res = ''; foreach ($items as $item) { $res .= ($res === '' ? '' : ', ') . ($item->key ? $item->key->toString() . ': ' : '') . $item->value->toString(); } return $res; } /** @param self[] $items */ public static function itemsToBlockString(array $items) : string { $res = ''; foreach ($items as $item) { $v = $item->value->toString(); $res .= ($item->key ? $item->key->toString() . ':' : '-') . ($item->value instanceof BlockArrayNode && $item->value->items ? "\n" . $v . (\substr($v, -2, 1) === "\n" ? '' : "\n") : ' ' . $v . "\n"); } return $res; } public function toValue() { throw new \LogicException(); } public function toString() : string { throw new \LogicException(); } public function &getIterator() : \Generator { if ($this->key) { (yield $this->key); } (yield $this->value); } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Neon\Node; use _PHPStan_7d8742a37\Nette\Neon\Node; /** @internal */ final class LiteralNode extends Node { private const SimpleTypes = ['true' => \true, 'True' => \true, 'TRUE' => \true, 'yes' => \true, 'Yes' => \true, 'YES' => \true, 'on' => \true, 'On' => \true, 'ON' => \true, 'false' => \false, 'False' => \false, 'FALSE' => \false, 'no' => \false, 'No' => \false, 'NO' => \false, 'off' => \false, 'Off' => \false, 'OFF' => \false, 'null' => null, 'Null' => null, 'NULL' => null]; private const DeprecatedTypes = ['on' => 1, 'On' => 1, 'ON' => 1, 'off' => 1, 'Off' => 1, 'OFF' => 1]; private const PatternDatetime = '#\\d\\d\\d\\d-\\d\\d?-\\d\\d?(?:(?:[Tt]| ++)\\d\\d?:\\d\\d:\\d\\d(?:\\.\\d*+)? *+(?:Z|[-+]\\d\\d?(?::?\\d\\d)?)?)?$#DA'; private const PatternHex = '#0x[0-9a-fA-F]++$#DA'; private const PatternOctal = '#0o[0-7]++$#DA'; private const PatternBinary = '#0b[0-1]++$#DA'; /** @var mixed */ public $value; public function __construct($value) { $this->value = $value; } public function toValue() { return $this->value; } /** @return mixed */ public static function parse(string $value, bool $isKey = \false) { if (!$isKey && \array_key_exists($value, self::SimpleTypes)) { if (isset(self::DeprecatedTypes[$value])) { \trigger_error("Neon: keyword '{$value}' is deprecated, use true/yes or false/no.", \E_USER_DEPRECATED); } return self::SimpleTypes[$value]; } elseif (\is_numeric($value)) { return $value * 1; } elseif (\preg_match(self::PatternHex, $value)) { return \hexdec($value); } elseif (\preg_match(self::PatternOctal, $value)) { return \octdec($value); } elseif (\preg_match(self::PatternBinary, $value)) { return \bindec($value); } elseif (!$isKey && \preg_match(self::PatternDatetime, $value)) { return new \DateTimeImmutable($value); } else { return $value; } } public function toString() : string { if ($this->value instanceof \DateTimeInterface) { return $this->value->format('Y-m-d H:i:s O'); } elseif (\is_string($this->value)) { return $this->value; } elseif (\is_float($this->value)) { $res = \json_encode($this->value); return \strpos($res, '.') === \false ? $res . '.0' : $res; } elseif (\is_int($this->value) || \is_bool($this->value) || $this->value === null) { return \json_encode($this->value); } else { throw new \LogicException(); } } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Neon\Node; /** @internal */ final class InlineArrayNode extends ArrayNode { /** @var string */ public $bracket; public function __construct(string $bracket) { $this->bracket = $bracket; } public function toString() : string { return $this->bracket . ArrayItemNode::itemsToInlineString($this->items) . ['[' => ']', '{' => '}', '(' => ')'][$this->bracket]; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Neon\Node; use _PHPStan_7d8742a37\Nette\Neon\Node; /** @internal */ abstract class ArrayNode extends Node { /** @var ArrayItemNode[] */ public $items = []; /** @return mixed[] */ public function toValue() : array { return ArrayItemNode::itemsToArray($this->items); } public function &getIterator() : \Generator { foreach ($this->items as &$item) { (yield $item); } } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Neon\Node; use _PHPStan_7d8742a37\Nette; use _PHPStan_7d8742a37\Nette\Neon\Node; /** @internal */ final class StringNode extends Node { private const EscapeSequences = ['t' => "\t", 'n' => "\n", 'r' => "\r", 'f' => "\f", 'b' => "\x08", '"' => '"', '\\' => '\\', '/' => '/', '_' => " "]; /** @var string */ public $value; public function __construct(string $value) { $this->value = $value; } public function toValue() : string { return $this->value; } public static function parse(string $s) : string { if (\preg_match('#^...\\n++([\\t ]*+)#', $s, $m)) { // multiline $res = \substr($s, 3, -3); $res = \str_replace("\n" . $m[1], "\n", $res); $res = \preg_replace('#^\\n|\\n[\\t ]*+$#D', '', $res); } else { $res = \substr($s, 1, -1); if ($s[0] === "'") { $res = \str_replace("''", "'", $res); } } if ($s[0] === "'") { return $res; } return \preg_replace_callback('#\\\\(?:ud[89ab][0-9a-f]{2}\\\\ud[c-f][0-9a-f]{2}|u[0-9a-f]{4}|x[0-9a-f]{2}|.)#i', function (array $m) : string { $sq = $m[0]; if (isset(self::EscapeSequences[$sq[1]])) { return self::EscapeSequences[$sq[1]]; } elseif ($sq[1] === 'u' && \strlen($sq) >= 6) { if (($res = \json_decode('"' . $sq . '"')) !== null) { return $res; } throw new Nette\Neon\Exception("Invalid UTF-8 sequence {$sq}"); } elseif ($sq[1] === 'x' && \strlen($sq) === 4) { \trigger_error("Neon: '{$sq}' is deprecated, use '\\uXXXX' instead.", \E_USER_DEPRECATED); return \chr(\hexdec(\substr($sq, 2))); } else { throw new Nette\Neon\Exception("Invalid escaping sequence {$sq}"); } }, $res); } public function toString() : string { $res = \json_encode($this->value, \JSON_UNESCAPED_UNICODE | \JSON_UNESCAPED_SLASHES); if ($res === \false) { throw new Nette\Neon\Exception('Invalid UTF-8 sequence: ' . $this->value); } if (\strpos($this->value, "\n") !== \false) { $res = \preg_replace_callback('#[^\\\\]|\\\\(.)#s', function ($m) { return ['n' => "\n\t", 't' => "\t", '"' => '"'][$m[1] ?? ''] ?? $m[0]; }, $res); $res = '"""' . "\n\t" . \substr($res, 1, -1) . "\n" . '"""'; } return $res; } } <?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare (strict_types=1); namespace _PHPStan_7d8742a37\Nette\Neon\Node; use _PHPStan_7d8742a37\Nette\Neon\Entity; use _PHPStan_7d8742a37\Nette\Neon\Node; /** @internal */ final class EntityNode extends Node { /** @var Node */ public $value; /** @var ArrayItemNode[] */ public $attributes; public function __construct(Node $value, array $attributes = []) { $this->value = $value; $this->attributes = $attributes; } public function toValue() : Entity { return new Entity($this->value->toValue(), ArrayItemNode::itemsToArray($this->attributes)); } public function toString() : string { return $this->value->toString() . '(' . ($this->attributes ? ArrayItemNode::itemsToInlineString($this->attributes) : '') . ')'; } public function &getIterator() : \Generator { (yield $this->value); foreach ($this->attributes as &$item) { (yield $item); } } } #!/usr/bin/env php <?php declare (strict_types=1); namespace _PHPStan_7d8742a37; if (!(\is_file($file = __DIR__ . '/../vendor/autoload.php') && (include $file)) && !(\is_file($file = __DIR__ . '/../../../autoload.php') && (include $file))) { \fwrite(\STDERR, "Install packages using Composer.\n"); exit(1); } if (\function_exists('pcntl_signal')) { \pcntl_signal(\SIGINT, function () : void { \pcntl_signal(\SIGINT, \SIG_DFL); echo "Terminated\n"; exit(1); }); } elseif (\function_exists('sapi_windows_set_ctrl_handler')) { \sapi_windows_set_ctrl_handler(function () { echo "Terminated\n"; exit(1); }); } \set_time_limit(0); echo ' NEON linter ----------- '; if ($argc < 2) { echo "Usage: neon-lint <path>\n"; exit(1); } $ok = scanPath($argv[1]); exit($ok ? 0 : 1); function scanPath(string $path) : bool { echo "Scanning {$path}\n"; $it = new \RecursiveDirectoryIterator($path); $it = new \RecursiveIteratorIterator($it, \RecursiveIteratorIterator::LEAVES_ONLY); $it = new \RegexIterator($it, '~\\.neon$~'); $counter = 0; $success = \true; foreach ($it as $file) { echo \str_pad(\str_repeat('.', $counter++ % 40), 40), "\r"; $success = lintFile((string) $file) && $success; } echo \str_pad('', 40), "\r"; echo "Done.\n"; return $success; } function lintFile(string $file) : bool { \set_error_handler(function (int $severity, string $message) use($file) { if ($severity === \E_USER_DEPRECATED) { \fwrite(\STDERR, "[DEPRECATED] {$file} {$message}\n"); return null; } return \false; }); $s = \file_get_contents($file); if (\substr($s, 0, 3) === "") { \fwrite(\STDERR, "[WARNING] {$file} contains BOM\n"); $contents = \substr($s, 3); } try { Nette\Neon\Neon::decode($s); return \true; } catch (Nette\Neon\Exception $e) { \fwrite(\STDERR, "[ERROR] {$file} {$e->getMessage()}\n"); } finally { \restore_error_handler(); } return \false; } This file was automatically generated by Composer Patches (https://github.com/cweagans/composer-patches) Patches applied to this directory: 0 Source: patches/NetteNeonStringNode.patch 1 Source: patches/NeonParser.patch <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Consistency; use Hoa\Exception as HoaException; /** * Class \Hoa\Consistency\Exception. * * Extending the \Hoa\Exception\Exception class. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Exception extends HoaException { } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ if (false === defined('HOA')) { define('HOA', true); } if (false === defined('PHP_VERSION_ID') || PHP_VERSION_ID < 50400) { throw new Exception( 'Hoa needs at least PHP5.4 to work; you have ' . phpversion() . '.' ); } require_once __DIR__ . DIRECTORY_SEPARATOR . 'Autoloader.php'; require_once __DIR__ . DIRECTORY_SEPARATOR . 'Consistency.php'; $define = function ($constantName, $constantValue, $case = false) { if (!defined($constantName)) { return define($constantName, $constantValue, $case); } return false; }; $define('SUCCEED', true); $define('FAILED', false); $define('…', '__hoa_core_fill'); $define('DS', DIRECTORY_SEPARATOR); $define('PS', PATH_SEPARATOR); $define('ROOT_SEPARATOR', ';'); $define('RS', ROOT_SEPARATOR); $define('CRLF', "\r\n"); $define('OS_WIN', defined('PHP_WINDOWS_VERSION_PLATFORM')); $define('S_64_BITS', PHP_INT_SIZE == 8); $define('S_32_BITS', !S_64_BITS); $define('PHP_INT_MIN', ~PHP_INT_MAX); $define('PHP_FLOAT_MIN', (float) PHP_INT_MIN); $define('PHP_FLOAT_MAX', (float) PHP_INT_MAX); $define('π', M_PI); $define('nil', null); $define('_public', 1); $define('_protected', 2); $define('_private', 4); $define('_static', 8); $define('_abstract', 16); $define('_pure', 32); $define('_final', 64); $define('_dynamic', ~_static); $define('_concrete', ~_abstract); $define('_overridable', ~_final); $define('WITH_COMPOSER', class_exists('Composer\Autoload\ClassLoader', false) || ('cli' === PHP_SAPI && file_exists(__DIR__ . DS . '..' . DS . '..' . DS . 'autoload.php'))); /** * Alias of \Hoa\Consistency\Xcallable. * * @param mixed $call First callable part. * @param mixed $able Second callable part (if needed). * @return mixed */ if (!function_exists('xcallable')) { function xcallable($call, $able = '') { if ($call instanceof Hoa\Consistency\Xcallable) { return $call; } return new Hoa\Consistency\Xcallable($call, $able); } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Consistency; use Hoa\Event; use Hoa\Stream; /** * Class Hoa\Consistency\Xcallable. * * Build a callable object, i.e. function, class::method, object->method or * closure, they all have the same behaviour. This callable is an extension of * native PHP callable (aka callback) to integrate Hoa's structures. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Xcallable { /** * Callback, with the PHP format. * * @var mixed */ protected $_callback = null; /** * Callable hash. * * @var string */ protected $_hash = null; /** * Build a callback. * Accepted forms: * * `'function'`, * * `'class::method'`, * * `'class', 'method'`, * * `$object, 'method'`, * * `$object, ''`, * * `function (…) { … }`, * * `['class', 'method']`, * * `[$object, 'method']`. * * @param mixed $call First callable part. * @param mixed $able Second callable part (if needed). */ public function __construct($call, $able = '') { if ($call instanceof \Closure) { $this->_callback = $call; return; } if (!\is_string($able)) { throw new \Hoa\Consistency\Exception('Bad callback form; the able part must be a string.', 0); } if ('' === $able) { if (\is_string($call)) { if (\false === \strpos($call, '::')) { if (!\function_exists($call)) { throw new \Hoa\Consistency\Exception('Bad callback form; function %s does not exist.', 1, $call); } $this->_callback = $call; return; } list($call, $able) = \explode('::', $call); } elseif (\is_object($call)) { if ($call instanceof Stream\IStream\Out) { $able = null; } elseif (\method_exists($call, '__invoke')) { $able = '__invoke'; } else { throw new \Hoa\Consistency\Exception('Bad callback form; an object but without a known ' . 'method.', 2); } } elseif (\is_array($call) && isset($call[0])) { if (!isset($call[1])) { return $this->__construct($call[0]); } return $this->__construct($call[0], $call[1]); } else { throw new \Hoa\Consistency\Exception('Bad callback form.', 3); } } $this->_callback = [$call, $able]; return; } /** * Call the callable. * * @param ... * @return mixed */ public function __invoke() { $arguments = \func_get_args(); $valid = $this->getValidCallback($arguments); return \call_user_func_array($valid, $arguments); } /** * Distribute arguments according to an array. * * @param array $arguments Arguments. * @return mixed */ public function distributeArguments(array $arguments) { return \call_user_func_array([$this, '__invoke'], $arguments); } /** * Get a valid callback in the PHP meaning. * * @param array &$arguments Arguments (could determine method on an * object if not precised). * @return mixed */ public function getValidCallback(array &$arguments = []) { $callback = $this->_callback; $head = null; if (isset($arguments[0])) { $head =& $arguments[0]; } // If method is undetermined, we find it (we understand event bucket and // stream). if (null !== $head && \is_array($callback) && null === $callback[1]) { if ($head instanceof Event\Bucket) { $head = $head->getData(); } switch ($type = \gettype($head)) { case 'string': if (1 === \strlen($head)) { $method = 'writeCharacter'; } else { $method = 'writeString'; } break; case 'boolean': case 'integer': case 'array': $method = 'write' . \ucfirst($type); break; case 'double': $method = 'writeFloat'; break; default: $method = 'writeAll'; $head = $head . "\n"; } $callback[1] = $method; } return $callback; } /** * Get hash. * Will produce: * * function#…; * * class#…::…; * * object(…)#…::…; * * closure(…). * * @return string */ public function getHash() { if (null !== $this->_hash) { return $this->_hash; } $_ =& $this->_callback; if (\is_string($_)) { return $this->_hash = 'function#' . $_; } if (\is_array($_)) { return $this->_hash = (\is_object($_[0]) ? 'object(' . \spl_object_hash($_[0]) . ')' . '#' . \get_class($_[0]) : 'class#' . $_[0]) . '::' . (null !== $_[1] ? $_[1] : '???'); } return $this->_hash = 'closure(' . \spl_object_hash($_) . ')'; } /** * Get appropriated reflection instance. * * @param ... * @return \Reflector */ public function getReflection() { $arguments = \func_get_args(); $valid = $this->getValidCallback($arguments); if (\is_string($valid)) { return new \ReflectionFunction($valid); } if ($valid instanceof \Closure) { return new \ReflectionFunction($valid); } if (\is_array($valid)) { if (\is_string($valid[0])) { if (\false === \method_exists($valid[0], $valid[1])) { return new \ReflectionClass($valid[0]); } return new \ReflectionMethod($valid[0], $valid[1]); } $object = new \ReflectionObject($valid[0]); if (null === $valid[1]) { return $object; } return $object->getMethod($valid[1]); } } /** * Return the hash. * * @return string */ public function __toString() { return $this->getHash(); } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Consistency; /** * Class Hoa\Consistency\Consistency. * * This class is a collection of tools to ensure foreward and backward * compatibility. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Consistency { /** * Check if an entity exists (class, interface, trait…). * * @param string $entityName Entity name. * @param bool $autoloader Run autoloader if necessary. * @return bool */ public static function entityExists($entityName, $autoloader = \false) { return \class_exists($entityName, $autoloader) || \interface_exists($entityName, \false) || \trait_exists($entityName, \false); } /** * Get the shortest name for an entity. * * @param string $entityName Entity name. * @return string */ public static function getEntityShortestName($entityName) { $parts = \explode('\\', $entityName); $count = \count($parts); if (1 >= $count) { return $entityName; } if ($parts[$count - 2] === $parts[$count - 1]) { return \implode('\\', \array_slice($parts, 0, -1)); } return $entityName; } /** * Declare a flex entity (for nested library). * * @param string $entityName Entity name. * @return bool */ public static function flexEntity($entityName) { return \class_alias($entityName, static::getEntityShortestName($entityName), \false); } /** * Whether a word is reserved or not. * * @param string $word Word. * @return bool */ public static function isKeyword($word) { static $_list = [ // PHP keywords. '__halt_compiler', 'abstract', 'and', 'array', 'as', 'bool', 'break', 'callable', 'case', 'catch', 'class', 'clone', 'const', 'continue', 'declare', 'default', 'die', 'do', 'echo', 'else', 'elseif', 'empty', 'enddeclare', 'endfor', 'endforeach', 'endif', 'endswitch', 'endwhile', 'eval', 'exit', 'extends', 'false', 'final', 'float', 'for', 'foreach', 'function', 'global', 'goto', 'if', 'implements', 'include', 'include_once', 'instanceof', 'insteadof', 'int', 'interface', 'isset', 'list', 'mixed', 'namespace', 'new', 'null', 'numeric', 'object', 'or', 'print', 'private', 'protected', 'public', 'require', 'require_once', 'resource', 'return', 'static', 'string', 'switch', 'throw', 'trait', 'true', 'try', 'unset', 'use', 'var', 'void', 'while', 'xor', 'yield', // Compile-time constants. '__class__', '__dir__', '__file__', '__function__', '__line__', '__method__', '__namespace__', '__trait__', ]; return \in_array(\strtolower($word), $_list); } /** * Whether an ID is a valid PHP identifier. * * @param string $id ID. * @return bool */ public static function isIdentifier($id) { return 0 !== \preg_match('#^[a-zA-Z_\\x7f-\\xff][a-zA-Z0-9_\\x80-\\xff]*$#', $id); } /** * Register a register shutdown function. * It may be analogous to a super static destructor. * * @param callable $callable Callable. * @return bool */ public static function registerShutdownFunction($callable) { return \register_shutdown_function($callable); } /** * Get PHP executable. * * @return string */ public static function getPHPBinary() { if (\defined('PHP_BINARY')) { return \PHP_BINARY; } if (isset($_SERVER['_'])) { return $_SERVER['_']; } foreach (['', '.exe'] as $extension) { if (\file_exists($_ = \PHP_BINDIR . DS . 'php' . $extension)) { return \realpath($_); } } return null; } /** * Generate an Universal Unique Identifier (UUID). * * @return string */ public static function uuid() { return \sprintf('%04x%04x-%04x-%04x-%04x-%04x%04x%04x', \mt_rand(0, 0xffff), \mt_rand(0, 0xffff), \mt_rand(0, 0xffff), \mt_rand(0, 0xfff) | 0x4000, \mt_rand(0, 0x3fff) | 0x8000, \mt_rand(0, 0xffff), \mt_rand(0, 0xffff), \mt_rand(0, 0xffff)); } } namespace _PHPStan_7d8742a37; if (70000 > \PHP_VERSION_ID && \false === \interface_exists('Throwable', \false)) { /** * Implement a fake Throwable class, introduced in PHP7.0. */ interface Throwable { public function getMessage(); public function getCode(); public function getFile(); public function getLine(); public function getTrace(); public function getPrevious(); public function getTraceAsString(); public function __toString(); } } /** * Define TLSv* constants, introduced in PHP 5.5. */ if (50600 > \PHP_VERSION_ID) { $define = function ($constantName, $constantValue, $case = \false) { if (!\defined($constantName)) { return \define($constantName, $constantValue, $case); } return \false; }; $define('STREAM_CRYPTO_METHOD_TLSv1_0_SERVER', 8); $define('STREAM_CRYPTO_METHOD_TLSv1_1_SERVER', 16); $define('STREAM_CRYPTO_METHOD_TLSv1_2_SERVER', 32); $define('STREAM_CRYPTO_METHOD_ANY_SERVER', 62); $define('STREAM_CRYPTO_METHOD_TLSv1_0_CLIENT', 9); $define('STREAM_CRYPTO_METHOD_TLSv1_1_CLIENT', 17); $define('STREAM_CRYPTO_METHOD_TLSv1_2_CLIENT', 33); $define('STREAM_CRYPTO_METHOD_ANY_CLIENT', 63); } /** * Flex entity. */ \Hoa\Consistency\Consistency::flexEntity('Hoa\\Consistency\\Consistency'); <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Consistency; /** * Class Hoa\Consistency\Autoloader. * * This class is a PSR-4 compliant autoloader. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Autoloader { /** * Namespace prefixes to base directories. * * @var array */ protected $_namespacePrefixesToBaseDirectories = []; /** * Add a base directory for a namespace prefix. * * @param string $prefix Namespace prefix. * @param string $baseDirectory Base directory for this prefix. * @param bool $prepend Whether the prefix is prepended or * appended to the prefix' stack. * @return void */ public function addNamespace($prefix, $baseDirectory, $prepend = \false) { $prefix = \trim($prefix, '\\') . '\\'; $baseDirectory = \rtrim($baseDirectory, \DIRECTORY_SEPARATOR) . \DIRECTORY_SEPARATOR; if (\false === isset($this->_namespacePrefixesToBaseDirectories[$prefix])) { $this->_namespacePrefixesToBaseDirectories[$prefix] = []; } if (\true === $prepend) { \array_unshift($this->_namespacePrefixesToBaseDirectories[$prefix], $baseDirectory); } else { \array_push($this->_namespacePrefixesToBaseDirectories[$prefix], $baseDirectory); } return; } /** * Try to load the entity file for a given entity name. * * @param string $entity Entity name to load. * @return bool */ public function load($entity) { $entityPrefix = $entity; $hasBaseDirectory = \false; while (\false !== ($pos = \strrpos($entityPrefix, '\\'))) { $currentEntityPrefix = \substr($entity, 0, $pos + 1); $entityPrefix = \rtrim($currentEntityPrefix, '\\'); $entitySuffix = \substr($entity, $pos + 1); $entitySuffixAsPath = \str_replace('\\', '/', $entitySuffix); if (\false === $this->hasBaseDirectory($currentEntityPrefix)) { continue; } $hasBaseDirectory = \true; foreach ($this->getBaseDirectories($currentEntityPrefix) as $baseDirectory) { $file = $baseDirectory . $entitySuffixAsPath . '.php'; if (\false !== $this->requireFile($file)) { return $file; } } } if (\true === $hasBaseDirectory && $entity === \Hoa\Consistency\Consistency::getEntityShortestName($entity) && \false !== ($pos = \strrpos($entity, '\\'))) { return $this->runAutoloaderStack($entity . '\\' . \substr($entity, $pos + 1)); } return null; } /** * Require a file if exists. * * @param string $filename File name. * @return bool */ public function requireFile($filename) { if (\false === \file_exists($filename)) { return \false; } require $filename; return \true; } /** * Check whether at least one base directory exists for a namespace prefix. * * @param string $namespacePrefix Namespace prefix. * @return bool */ public function hasBaseDirectory($namespacePrefix) { return isset($this->_namespacePrefixesToBaseDirectories[$namespacePrefix]); } /** * Get declared base directories for a namespace prefix. * * @param string $namespacePrefix Namespace prefix. * @return array */ public function getBaseDirectories($namespacePrefix) { if (\false === $this->hasBaseDirectory($namespacePrefix)) { return []; } return $this->_namespacePrefixesToBaseDirectories[$namespacePrefix]; } /** * Get loaded classes. * * @return array */ public static function getLoadedClasses() { return \get_declared_classes(); } /** * Run the entire autoloader stack with a specific entity. * * @param string $entity Entity name to load. * @return void */ public function runAutoloaderStack($entity) { return \spl_autoload_call($entity); } /** * Register the autoloader. * * @param bool $prepend Prepend this autoloader to the stack or not. * @return bool */ public function register($prepend = \false) { return \spl_autoload_register([$this, 'load'], \true, $prepend); } /** * Unregister the autoloader. * * @return bool */ public function unregister() { return \spl_autoload_unregister([$this, 'load']); } /** * Get all registered autoloaders (not only from this library). * * @return array */ public function getRegisteredAutoloaders() { return \spl_autoload_functions(); } /** * Dynamic new, a simple factory. * It loads and constructs a class, with provided arguments. * * @param bool $classname Classname. * @param array $arguments Arguments for the constructor. * @return object */ public static function dnew($classname, array $arguments = []) { $classname = \ltrim($classname, '\\'); if (\false === \Hoa\Consistency\Consistency::entityExists($classname, \false)) { \spl_autoload_call($classname); } $class = new \ReflectionClass($classname); if (empty($arguments) || \false === $class->hasMethod('__construct')) { return $class->newInstance(); } return $class->newInstanceArgs($arguments); } } /** * Autoloader. */ $autoloader = new \Hoa\Consistency\Autoloader(); $autoloader->addNamespace('Hoa', \dirname(__DIR__)); $autoloader->register(); This file was automatically generated by Composer Patches (https://github.com/cweagans/composer-patches) Patches applied to this directory: 0 Source: patches/Consistency.patch <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\File\Temporary; use Hoa\File; use Hoa\Stream; /** * Class \Hoa\File\Temporary\ReadWrite. * * Read/write a temporary file. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class ReadWrite extends \Hoa\File\Temporary\Temporary implements Stream\IStream\In, Stream\IStream\Out { /** * Open a file. * * @param string $streamName Stream name. * @param string $mode Open mode, see the parent::MODE_* constants. * @param string $context Context ID (please, see the * \Hoa\Stream\Context class). * @param bool $wait Differ opening or not. */ public function __construct($streamName, $mode = parent::MODE_APPEND_READ_WRITE, $context = null, $wait = \false) { parent::__construct($streamName, $mode, $context, $wait); return; } /** * Open the stream and return the associated resource. * * @param string $streamName Stream name (e.g. path or URL). * @param \Hoa\Stream\Context $context Context. * @return resource * @throws \Hoa\File\Exception\FileDoesNotExist * @throws \Hoa\File\Exception */ protected function &_open($streamName, Stream\Context $context = null) { static $createModes = [parent::MODE_READ_WRITE, parent::MODE_TRUNCATE_READ_WRITE, parent::MODE_APPEND_READ_WRITE, parent::MODE_CREATE_READ_WRITE]; if (!\in_array($this->getMode(), $createModes)) { throw new File\Exception('Open mode are not supported; given %d. Only %s are supported.', 0, [$this->getMode(), \implode(', ', $createModes)]); } \preg_match('#^(\\w+)://#', $streamName, $match); if ((isset($match[1]) && $match[1] == 'file' || !isset($match[1])) && !\file_exists($streamName) && parent::MODE_READ_WRITE == $this->getMode()) { throw new File\Exception\FileDoesNotExist('File %s does not exist.', 1, $streamName); } $out = parent::_open($streamName, $context); return $out; } /** * Test for end-of-file. * * @return bool */ public function eof() { return \feof($this->getStream()); } /** * Read n characters. * * @param int $length Length. * @return string * @throws \Hoa\File\Exception */ public function read($length) { if (0 > $length) { throw new File\Exception('Length must be greater than 0, given %d.', 2, $length); } return \fread($this->getStream(), $length); } /** * Alias of $this->read(). * * @param int $length Length. * @return string */ public function readString($length) { return $this->read($length); } /** * Read a character. * * @return string */ public function readCharacter() { return \fgetc($this->getStream()); } /** * Read a boolean. * * @return bool */ public function readBoolean() { return (bool) $this->read(1); } /** * Read an integer. * * @param int $length Length. * @return int */ public function readInteger($length = 1) { return (int) $this->read($length); } /** * Read a float. * * @param int $length Length. * @return float */ public function readFloat($length = 1) { return (float) $this->read($length); } /** * Read an array. * Alias of the $this->scanf() method. * * @param string $format Format (see printf's formats). * @return array */ public function readArray($format = null) { return $this->scanf($format); } /** * Read a line. * * @return string */ public function readLine() { return \fgets($this->getStream()); } /** * Read all, i.e. read as much as possible. * * @param int $offset Offset. * @return string */ public function readAll($offset = 0) { return \stream_get_contents($this->getStream(), -1, $offset); } /** * Parse input from a stream according to a format. * * @param string $format Format (see printf's formats). * @return array */ public function scanf($format) { return \fscanf($this->getStream(), $format); } /** * Write n characters. * * @param string $string String. * @param int $length Length. * @return mixed * @throws \Hoa\File\Exception */ public function write($string, $length) { if (0 > $length) { throw new File\Exception('Length must be greater than 0, given %d.', 3, $length); } return \fwrite($this->getStream(), $string, $length); } /** * Write a string. * * @param string $string String. * @return mixed */ public function writeString($string) { $string = (string) $string; return $this->write($string, \strlen($string)); } /** * Write a character. * * @param string $char Character. * @return mixed */ public function writeCharacter($char) { return $this->write((string) $char[0], 1); } /** * Write a boolean. * * @param bool $boolean Boolean. * @return mixed */ public function writeBoolean($boolean) { return $this->write((string) (bool) $boolean, 1); } /** * Write an integer. * * @param int $integer Integer. * @return mixed */ public function writeInteger($integer) { $integer = (string) (int) $integer; return $this->write($integer, \strlen($integer)); } /** * Write a float. * * @param float $float Float. * @return mixed */ public function writeFloat($float) { $float = (string) (float) $float; return $this->write($float, \strlen($float)); } /** * Write an array. * * @param array $array Array. * @return mixed */ public function writeArray(array $array) { $array = \var_export($array, \true); return $this->write($array, \strlen($array)); } /** * Write a line. * * @param string $line Line. * @return mixed */ public function writeLine($line) { if (\false === ($n = \strpos($line, "\n"))) { return $this->write($line . "\n", \strlen($line) + 1); } ++$n; return $this->write(\substr($line, 0, $n), $n); } /** * Write all, i.e. as much as possible. * * @param string $string String. * @return mixed */ public function writeAll($string) { return $this->write($string, \strlen($string)); } /** * Truncate a file to a given length. * * @param int $size Size. * @return bool */ public function truncate($size) { return \ftruncate($this->getStream(), $size); } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\File\Temporary; use Hoa\File; use Hoa\Stream; /** * Class \Hoa\File\Temporary\Read. * * Read a temporary file. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Read extends \Hoa\File\Temporary\Temporary implements Stream\IStream\In { /** * Open a file. * * @param string $streamName Stream name. * @param string $mode Open mode, see the parent::MODE_* constants. * @param string $context Context ID (please, see the * \Hoa\Stream\Context class). * @param bool $wait Differ opening or not. */ public function __construct($streamName, $mode = parent::MODE_READ, $context = null, $wait = \false) { parent::__construct($streamName, $mode, $context, $wait); return; } /** * Open the stream and return the associated resource. * * @param string $streamName Stream name (e.g. path or URL). * @param \Hoa\Stream\Context $context Context. * @return resource * @throws \Hoa\File\Exception\FileDoesNotExist * @throws \Hoa\File\Exception */ protected function &_open($streamName, Stream\Context $context = null) { static $createModes = [parent::MODE_READ]; if (!\in_array($this->getMode(), $createModes)) { throw new File\Exception('Open mode are not supported; given %d. Only %s are supported.', 0, [$this->getMode(), \implode(', ', $createModes)]); } \preg_match('#^(\\w+)://#', $streamName, $match); if ((isset($match[1]) && $match[1] == 'file' || !isset($match[1])) && !\file_exists($streamName)) { throw new File\Exception\FileDoesNotExist('File %s does not exist.', 1, $streamName); } $out = parent::_open($streamName, $context); return $out; } /** * Test for end-of-file. * * @return bool */ public function eof() { return \feof($this->getStream()); } /** * Read n characters. * * @param int $length Length. * @return string * @throws \Hoa\File\Exception */ public function read($length) { if (0 > $length) { throw new File\Exception('Length must be greater than 0, given %d.', 2, $length); } return \fread($this->getStream(), $length); } /** * Alias of $this->read(). * * @param int $length Length. * @return string */ public function readString($length) { return $this->read($length); } /** * Read a character. * * @return string */ public function readCharacter() { return \fgetc($this->getStream()); } /** * Read a boolean. * * @return bool */ public function readBoolean() { return (bool) $this->read(1); } /** * Read an integer. * * @param int $length Length. * @return int */ public function readInteger($length = 1) { return (int) $this->read($length); } /** * Read a float. * * @param int $length Length. * @return float */ public function readFloat($length = 1) { return (float) $this->read($length); } /** * Read an array. * Alias of the $this->scanf() method. * * @param string $format Format (see printf's formats). * @return array */ public function readArray($format = null) { return $this->scanf($format); } /** * Read a line. * * @return string */ public function readLine() { return \fgets($this->getStream()); } /** * Read all, i.e. read as much as possible. * * @param int $offset Offset. * @return string */ public function readAll($offset = 0) { return \stream_get_contents($this->getStream(), -1, $offset); } /** * Parse input from a stream according to a format. * * @param string $format Format (see printf's formats). * @return array */ public function scanf($format) { return \fscanf($this->getStream(), $format); } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\File\Temporary; use Hoa\Consistency; use Hoa\File; use Hoa\Stream; /** * Class \Hoa\File\Temporary. * * Temporary file handler. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Temporary extends File { /** * Temporary file index. * * @var int */ private static $_i = 0; /** * Open a temporary file. * * @param string $streamName Stream name (or file descriptor). * @param string $mode Open mode, see the parent::MODE_* * constants. * @param string $context Context ID (please, see the * \Hoa\Stream\Context class). * @param bool $wait Differ opening or not. */ public function __construct($streamName, $mode, $context = null, $wait = \false) { if (null === $streamName) { $streamName = 'hoa://Library/File/Temporary.php#' . self::$_i++; } parent::__construct($streamName, $mode, $context, $wait); return; } /** * Open the stream and return the associated resource. * * @param string $streamName Stream name (here, it is * null). * @param \Hoa\Stream\Context $context Context. * @return resource * @throws \Hoa\File\Exception */ protected function &_open($streamName, Stream\Context $context = null) { if (\false === ($out = @\tmpfile())) { throw new File\Exception('Failed to open a temporary stream.', 0); } return $out; } /** * Create a unique temporary file, i.e. a file with a unique filename. It is * different of calling $this->__construct() that will create a temporary * file that will be destroy when calling the $this->close() method. * * @param string $directory Directory where the temporary filename * will be created. If the directory does not * exist, it may generate a file in the * system's temporary directory. * @param string $prefix Prefix of the generated temporary * filename. * @return string */ public static function create($directory = null, $prefix = '__hoa_') { if (null === $directory || \false === \is_dir($directory)) { $directory = static::getTemporaryDirectory(); } return \tempnam($directory, $prefix); } /** * Get the directory path used for temporary files. * * @return string */ public static function getTemporaryDirectory() { return \sys_get_temp_dir(); } } /** * Flex entity. */ Consistency::flexEntity('Hoa\\File\\Temporary\\Temporary'); <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\File\Temporary; use Hoa\File; use Hoa\Stream; /** * Class \Hoa\File\Temporary\Write. * * Write into a temporary file. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Write extends \Hoa\File\Temporary\Temporary implements Stream\IStream\Out { /** * Open a file. * * @param string $streamName Stream name. * @param string $mode Open mode, see the parent::MODE_* constants. * @param string $context Context ID (please, see the * \Hoa\Stream\Context class). * @param bool $wait Differ opening or not. */ public function __construct($streamName, $mode = parent::MODE_APPEND_WRITE, $context = null, $wait = \false) { parent::__construct($streamName, $mode, $context, $wait); return; } /** * Open the stream and return the associated resource. * * @param string $streamName Stream name (e.g. path or URL). * @param \Hoa\Stream\Context $context Context. * @return resource * @throws \Hoa\File\Exception\FileDoesNotExist * @throws \Hoa\File\Exception */ protected function &_open($streamName, Stream\Context $context = null) { static $createModes = [parent::MODE_TRUNCATE_WRITE, parent::MODE_APPEND_WRITE, parent::MODE_CREATE_WRITE]; if (!\in_array($this->getMode(), $createModes)) { throw new File\Exception('Open mode are not supported; given %d. Only %s are supported.', 0, [$this->getMode(), \implode(', ', $createModes)]); } \preg_match('#^(\\w+)://#', $streamName, $match); if ((isset($match[1]) && $match[1] == 'file' || !isset($match[1])) && !\file_exists($streamName)) { throw new File\Exception\FileDoesNotExist('File %s does not exist.', 1, $streamName); } $out = parent::_open($streamName, $context); return $out; } /** * Write n characters. * * @param string $string String. * @param int $length Length. * @return mixed * @throws \Hoa\File\Exception */ public function write($string, $length) { if (0 > $length) { throw new File\Exception('Length must be greater than 0, given %d.', 2, $length); } return \fwrite($this->getStream(), $string, $length); } /** * Write a string. * * @param string $string String. * @return mixed */ public function writeString($string) { $string = (string) $string; return $this->write($string, \strlen($string)); } /** * Write a character. * * @param string $char Character. * @return mixed */ public function writeCharacter($char) { return $this->write((string) $char[0], 1); } /** * Write a boolean. * * @param bool $boolean Boolean. * @return mixed */ public function writeBoolean($boolean) { return $this->write((string) (bool) $boolean, 1); } /** * Write an integer. * * @param int $integer Integer. * @return mixed */ public function writeInteger($integer) { $integer = (string) (int) $integer; return $this->write($integer, \strlen($integer)); } /** * Write a float. * * @param float $float Float. * @return mixed */ public function writeFloat($float) { $float = (string) (float) $float; return $this->write($float, \strlen($float)); } /** * Write an array. * * @param array $array Array. * @return mixed */ public function writeArray(array $array) { $array = \var_export($array, \true); return $this->write($array, \strlen($array)); } /** * Write a line. * * @param string $line Line. * @return mixed */ public function writeLine($line) { if (\false === ($n = \strpos($line, "\n"))) { return $this->write($line . "\n", \strlen($line) + 1); } ++$n; return $this->write(\substr($line, 0, $n), $n); } /** * Write all, i.e. as much as possible. * * @param string $string String. * @return mixed */ public function writeAll($string) { return $this->write($string, \strlen($string)); } /** * Truncate a file to a given length. * * @param int $size Size. * @return bool */ public function truncate($size) { return \ftruncate($this->getStream(), $size); } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\File; use Hoa\Iterator; /** * Class \Hoa\File\Finder. * * This class allows to find files easily by using filters and flags. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Finder implements Iterator\Aggregate { /** * SplFileInfo classname. * * @var string */ protected $_splFileInfo = 'Hoa\\File\\SplFileInfo'; /** * Paths where to look for. * * @var array */ protected $_paths = []; /** * Max depth in recursion. * * @var int */ protected $_maxDepth = -1; /** * Filters. * * @var array */ protected $_filters = []; /** * Flags. * * @var int */ protected $_flags = -1; /** * Types of files to handle. * * @var array */ protected $_types = []; /** * What comes first: parent or child? * * @var int */ protected $_first = -1; /** * Sorts. * * @var array */ protected $_sorts = []; /** * Initialize. * */ public function __construct() { $this->_flags = Iterator\FileSystem::KEY_AS_PATHNAME | Iterator\FileSystem::CURRENT_AS_FILEINFO | Iterator\FileSystem::SKIP_DOTS; $this->_first = Iterator\Recursive\Iterator::SELF_FIRST; return; } /** * Select a directory to scan. * * @param string|array $paths One or more paths. * @return \Hoa\File\Finder */ public function in($paths) { if (!\is_array($paths)) { $paths = [$paths]; } foreach ($paths as $path) { if (1 === \preg_match('/[\\*\\?\\[\\]]/', $path)) { $iterator = new Iterator\CallbackFilter(new Iterator\Glob(\rtrim($path, DS)), function ($current) { return $current->isDir(); }); foreach ($iterator as $fileInfo) { $this->_paths[] = $fileInfo->getPathname(); } } else { $this->_paths[] = $path; } } return $this; } /** * Set max depth for recursion. * * @param int $depth Depth. * @return \Hoa\File\Finder */ public function maxDepth($depth) { $this->_maxDepth = $depth; return $this; } /** * Include files in the result. * * @return \Hoa\File\Finder */ public function files() { $this->_types[] = 'file'; return $this; } /** * Include directories in the result. * * @return \Hoa\File\Finder */ public function directories() { $this->_types[] = 'dir'; return $this; } /** * Include links in the result. * * @return \Hoa\File\Finder */ public function links() { $this->_types[] = 'link'; return $this; } /** * Follow symbolink links. * * @param bool $flag Whether we follow or not. * @return \Hoa\File\Finder */ public function followSymlinks($flag = \true) { if (\true === $flag) { $this->_flags ^= Iterator\FileSystem::FOLLOW_SYMLINKS; } else { $this->_flags |= Iterator\FileSystem::FOLLOW_SYMLINKS; } return $this; } /** * Include files that match a regex. * Example: * $this->name('#\.php$#'); * * @param string $regex Regex. * @return \Hoa\File\Finder */ public function name($regex) { $this->_filters[] = function (\SplFileInfo $current) use($regex) { return 0 !== \preg_match($regex, $current->getBasename()); }; return $this; } /** * Exclude directories that match a regex. * Example: * $this->notIn('#^\.(git|hg)$#'); * * @param string $regex Regex. * @return \Hoa\File\Finder */ public function notIn($regex) { $this->_filters[] = function (\SplFileInfo $current) use($regex) { foreach (\explode(DS, $current->getPathname()) as $part) { if (0 !== \preg_match($regex, $part)) { return \false; } } return \true; }; return $this; } /** * Include files that respect a certain size. * The size is a string of the form: * operator number unit * where * • operator could be: <, <=, >, >= or =; * • number is a positive integer; * • unit could be: b (default), Kb, Mb, Gb, Tb, Pb, Eb, Zb, Yb. * Example: * $this->size('>= 12Kb'); * * @param string $size Size. * @return \Hoa\File\Finder */ public function size($size) { if (0 === \preg_match('#^(<|<=|>|>=|=)\\s*(\\d+)\\s*((?:[KMGTPEZY])b)?$#', $size, $matches)) { return $this; } $number = \floatval($matches[2]); $unit = isset($matches[3]) ? $matches[3] : 'b'; $operator = $matches[1]; switch ($unit) { case 'b': break; // kilo case 'Kb': $number <<= 10; break; // mega. case 'Mb': $number <<= 20; break; // giga. case 'Gb': $number <<= 30; break; // tera. case 'Tb': $number *= 1099511627776; break; // peta. case 'Pb': $number *= \pow(1024, 5); break; // exa. case 'Eb': $number *= \pow(1024, 6); break; // zetta. case 'Zb': $number *= \pow(1024, 7); break; // yota. case 'Yb': $number *= \pow(1024, 8); break; } $filter = null; switch ($operator) { case '<': $filter = function (\SplFileInfo $current) use($number) { return $current->getSize() < $number; }; break; case '<=': $filter = function (\SplFileInfo $current) use($number) { return $current->getSize() <= $number; }; break; case '>': $filter = function (\SplFileInfo $current) use($number) { return $current->getSize() > $number; }; break; case '>=': $filter = function (\SplFileInfo $current) use($number) { return $current->getSize() >= $number; }; break; case '=': $filter = function (\SplFileInfo $current) use($number) { return $current->getSize() === $number; }; break; } $this->_filters[] = $filter; return $this; } /** * Whether we should include dots or not (respectively . and ..). * * @param bool $flag Include or not. * @return \Hoa\File\Finder */ public function dots($flag = \true) { if (\true === $flag) { $this->_flags ^= Iterator\FileSystem::SKIP_DOTS; } else { $this->_flags |= Iterator\FileSystem::SKIP_DOTS; } return $this; } /** * Include files that are owned by a certain owner. * * @param int $owner Owner. * @return \Hoa\File\Finder */ public function owner($owner) { $this->_filters[] = function (\SplFileInfo $current) use($owner) { return $current->getOwner() === $owner; }; return $this; } /** * Format date. * Date can have the following syntax: * date * since date * until date * If the date does not have the “ago” keyword, it will be added. * Example: “42 hours” is equivalent to “since 42 hours” which is equivalent * to “since 42 hours ago”. * * @param string $date Date. * @param int &$operator Operator (-1 for since, 1 for until). * @return int */ protected function formatDate($date, &$operator) { $operator = -1; if (0 === \preg_match('#\\bago\\b#', $date)) { $date .= ' ago'; } if (0 !== \preg_match('#^(since|until)\\b(.+)$#', $date, $matches)) { $time = \strtotime($matches[2]); if ('until' === $matches[1]) { $operator = 1; } } else { $time = \strtotime($date); } return $time; } /** * Include files that have been changed from a certain date. * Example: * $this->changed('since 13 days'); * * @param string $date Date. * @return \Hoa\File\Finder */ public function changed($date) { $time = $this->formatDate($date, $operator); if (-1 === $operator) { $this->_filters[] = function (\SplFileInfo $current) use($time) { return $current->getCTime() >= $time; }; } else { $this->_filters[] = function (\SplFileInfo $current) use($time) { return $current->getCTime() < $time; }; } return $this; } /** * Include files that have been modified from a certain date. * Example: * $this->modified('since 13 days'); * * @param string $date Date. * @return \Hoa\File\Finder */ public function modified($date) { $time = $this->formatDate($date, $operator); if (-1 === $operator) { $this->_filters[] = function (\SplFileInfo $current) use($time) { return $current->getMTime() >= $time; }; } else { $this->_filters[] = function (\SplFileInfo $current) use($time) { return $current->getMTime() < $time; }; } return $this; } /** * Add your own filter. * The callback will receive 3 arguments: $current, $key and $iterator. It * must return a boolean: true to include the file, false to exclude it. * Example: * // Include files that are readable * $this->filter(function ($current) { * return $current->isReadable(); * }); * * @param callable $callback Callback * @return \Hoa\File\Finder */ public function filter($callback) { $this->_filters[] = $callback; return $this; } /** * Sort result by name. * If \Collator exists (from ext/intl), the $locale argument will be used * for its constructor. Else, strcmp() will be used. * Example: * $this->sortByName('fr_FR'); * * @param string $locale Locale. * @return \Hoa\File\Finder */ public function sortByName($locale = 'root') { if (\true === \class_exists('Collator', \false)) { $collator = new \Collator($locale); $this->_sorts[] = function (\SplFileInfo $a, \SplFileInfo $b) use($collator) { return $collator->compare($a->getPathname(), $b->getPathname()); }; } else { $this->_sorts[] = function (\SplFileInfo $a, \SplFileInfo $b) { return \strcmp($a->getPathname(), $b->getPathname()); }; } return $this; } /** * Sort result by size. * Example: * $this->sortBySize(); * * @return \Hoa\File\Finder */ public function sortBySize() { $this->_sorts[] = function (\SplFileInfo $a, \SplFileInfo $b) { return $a->getSize() < $b->getSize(); }; return $this; } /** * Add your own sort. * The callback will receive 2 arguments: $a and $b. Please see the uasort() * function. * Example: * // Sort files by their modified time. * $this->sort(function ($a, $b) { * return $a->getMTime() < $b->getMTime(); * }); * * @param callable $callable Callback. * @return \Hoa\File\Finder */ public function sort($callable) { $this->_sorts[] = $callable; return $this; } /** * Child comes first when iterating. * * @return \Hoa\File\Finder */ public function childFirst() { $this->_first = Iterator\Recursive\Iterator::CHILD_FIRST; return $this; } /** * Get the iterator. * * @return \Traversable */ public function getIterator() { $_iterator = new Iterator\Append(); $types = $this->getTypes(); if (!empty($types)) { $this->_filters[] = function (\SplFileInfo $current) use($types) { return \in_array($current->getType(), $types); }; } $maxDepth = $this->getMaxDepth(); $splFileInfo = $this->getSplFileInfo(); foreach ($this->getPaths() as $path) { if (1 == $maxDepth) { $iterator = new Iterator\IteratorIterator(new Iterator\Recursive\Directory($path, $this->getFlags(), $splFileInfo), $this->getFirst()); } else { $iterator = new Iterator\Recursive\Iterator(new Iterator\Recursive\Directory($path, $this->getFlags(), $splFileInfo), $this->getFirst()); if (1 < $maxDepth) { $iterator->setMaxDepth($maxDepth - 1); } } $_iterator->append($iterator); } foreach ($this->getFilters() as $filter) { $_iterator = new Iterator\CallbackFilter($_iterator, $filter); } $sorts = $this->getSorts(); if (empty($sorts)) { return $_iterator; } $array = \iterator_to_array($_iterator); foreach ($sorts as $sort) { \uasort($array, $sort); } return new Iterator\Map($array); } /** * Set SplFileInfo classname. * * @param string $splFileInfo SplFileInfo classname. * @return string */ public function setSplFileInfo($splFileInfo) { $old = $this->_splFileInfo; $this->_splFileInfo = $splFileInfo; return $old; } /** * Get SplFileInfo classname. * * @return string */ public function getSplFileInfo() { return $this->_splFileInfo; } /** * Get all paths. * * @return array */ protected function getPaths() { return $this->_paths; } /** * Get max depth. * * @return int */ public function getMaxDepth() { return $this->_maxDepth; } /** * Get types. * * @return array */ public function getTypes() { return $this->_types; } /** * Get filters. * * @return array */ protected function getFilters() { return $this->_filters; } /** * Get sorts. * * @return array */ protected function getSorts() { return $this->_sorts; } /** * Get flags. * * @return int */ public function getFlags() { return $this->_flags; } /** * Get first. * * @return int */ public function getFirst() { return $this->_first; } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\File\Link; use Hoa\Consistency; use Hoa\File; /** * Class \Hoa\File\Link. * * Link handler. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Link extends File { /** * Open a link. * * @param string $streamName Stream name. * @param string $mode Open mode, see the parent::MODE_* * constants. * @param string $context Context ID (please, see the * \Hoa\Stream\Context class). * @param bool $wait Differ opening or not. * @throws \Hoa\File\Exception */ public function __construct($streamName, $mode, $context = null, $wait = \false) { if (!\is_link($streamName)) { throw new File\Exception('File %s is not a link.', 0, $streamName); } parent::__construct($streamName, $mode, $context, $wait); return; } /** * Get informations about a link. * * @return array */ public function getStatistic() { return \lstat($this->getStreamName()); } /** * Change file group. * * @param mixed $group Group name or number. * @return bool */ public function changeGroup($group) { return \lchgrp($this->getStreamName(), $group); } /** * Change file owner. * * @param mixed $user User. * @return bool */ public function changeOwner($user) { return \lchown($this->getStreamName(), $user); } /** * Get file permissions. * * @return int */ public function getPermissions() { return 41453; // i.e. lrwxr-xr-x } /** * Get the target of a symbolic link. * * @return \Hoa\File\Generic * @throws \Hoa\File\Exception */ public function getTarget() { $target = \dirname($this->getStreamName()) . DS . $this->getTargetName(); $context = null !== $this->getStreamContext() ? $this->getStreamContext()->getCurrentId() : null; if (\true === \is_link($target)) { return new \Hoa\File\Link\ReadWrite($target, File::MODE_APPEND_READ_WRITE, $context); } elseif (\true === \is_file($target)) { return new File\ReadWrite($target, File::MODE_APPEND_READ_WRITE, $context); } elseif (\true === \is_dir($target)) { return new File\Directory($target, File::MODE_READ, $context); } throw new File\Exception('Cannot find an appropriated object that matches with ' . 'path %s when defining it.', 1, $target); } /** * Get the target name of a symbolic link. * * @return string */ public function getTargetName() { return \readlink($this->getStreamName()); } /** * Create a link. * * @param string $name Link name. * @param string $target Target name. * @return bool */ public static function create($name, $target) { if (\false != \linkinfo($name)) { return \true; } return \symlink($target, $name); } } /** * Flex entity. */ Consistency::flexEntity('Hoa\\File\\Link\\Link'); <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\File\Link; use Hoa\File; use Hoa\Stream; /** * Class \Hoa\File\Link\ReadWrite. * * File handler. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class ReadWrite extends \Hoa\File\Link\Link implements Stream\IStream\In, Stream\IStream\Out { /** * Open a file. * * @param string $streamName Stream name. * @param string $mode Open mode, see the parent::MODE_* constants. * @param string $context Context ID (please, see the * \Hoa\Stream\Context class). * @param bool $wait Differ opening or not. */ public function __construct($streamName, $mode = parent::MODE_APPEND_READ_WRITE, $context = null, $wait = \false) { parent::__construct($streamName, $mode, $context, $wait); return; } /** * Open the stream and return the associated resource. * * @param string $streamName Stream name (e.g. path or URL). * @param \Hoa\Stream\Context $context Context. * @return resource * @throws \Hoa\File\Exception\FileDoesNotExist * @throws \Hoa\File\Exception */ protected function &_open($streamName, Stream\Context $context = null) { static $createModes = [parent::MODE_READ_WRITE, parent::MODE_TRUNCATE_READ_WRITE, parent::MODE_APPEND_READ_WRITE, parent::MODE_CREATE_READ_WRITE]; if (!\in_array($this->getMode(), $createModes)) { throw new File\Exception('Open mode are not supported; given %d. Only %s are supported.', 0, [$this->getMode(), \implode(', ', $createModes)]); } \preg_match('#^(\\w+)://#', $streamName, $match); if ((isset($match[1]) && $match[1] == 'file' || !isset($match[1])) && !\file_exists($streamName) && parent::MODE_READ_WRITE == $this->getMode()) { throw new File\Exception\FileDoesNotExist('File %s does not exist.', 1, $streamName); } $out = parent::_open($streamName, $context); return $out; } /** * Test for end-of-file. * * @return bool */ public function eof() { return \feof($this->getStream()); } /** * Read n characters. * * @param int $length Length. * @return string * @throws \Hoa\File\Exception */ public function read($length) { if (0 > $length) { throw new File\Exception('Length must be greater than 0, given %d.', 2, $length); } return \fread($this->getStream(), $length); } /** * Alias of $this->read(). * * @param int $length Length. * @return string */ public function readString($length) { return $this->read($length); } /** * Read a character. * * @return string */ public function readCharacter() { return \fgetc($this->getStream()); } /** * Read a boolean. * * @return bool */ public function readBoolean() { return (bool) $this->read(1); } /** * Read an integer. * * @param int $length Length. * @return int */ public function readInteger($length = 1) { return (int) $this->read($length); } /** * Read a float. * * @param int $length Length. * @return float */ public function readFloat($length = 1) { return (float) $this->read($length); } /** * Read an array. * Alias of the $this->scanf() method. * * @param string $format Format (see printf's formats). * @return array */ public function readArray($format = null) { return $this->scanf($format); } /** * Read a line. * * @return string */ public function readLine() { return \fgets($this->getStream()); } /** * Read all, i.e. read as much as possible. * * @param int $offset Offset. * @return string */ public function readAll($offset = 0) { return \stream_get_contents($this->getStream(), -1, $offset); } /** * Parse input from a stream according to a format. * * @param string $format Format (see printf's formats). * @return array */ public function scanf($format) { return \fscanf($this->getStream(), $format); } /** * Write n characters. * * @param string $string String. * @param int $length Length. * @return mixed * @throws \Hoa\File\Exception */ public function write($string, $length) { if (0 > $length) { throw new File\Exception('Length must be greater than 0, given %d.', 3, $length); } return \fwrite($this->getStream(), $string, $length); } /** * Write a string. * * @param string $string String. * @return mixed */ public function writeString($string) { $string = (string) $string; return $this->write($string, \strlen($string)); } /** * Write a character. * * @param string $char Character. * @return mixed */ public function writeCharacter($char) { return $this->write((string) $char[0], 1); } /** * Write a boolean. * * @param bool $boolean Boolean. * @return mixed */ public function writeBoolean($boolean) { return $this->write((string) (bool) $boolean, 1); } /** * Write an integer. * * @param int $integer Integer. * @return mixed */ public function writeInteger($integer) { $integer = (string) (int) $integer; return $this->write($integer, \strlen($integer)); } /** * Write a float. * * @param float $float Float. * @return mixed */ public function writeFloat($float) { $float = (string) (float) $float; return $this->write($float, \strlen($float)); } /** * Write an array. * * @param array $array Array. * @return mixed */ public function writeArray(array $array) { $array = \var_export($array, \true); return $this->write($array, \strlen($array)); } /** * Write a line. * * @param string $line Line. * @return mixed */ public function writeLine($line) { if (\false === ($n = \strpos($line, "\n"))) { return $this->write($line . "\n", \strlen($line) + 1); } ++$n; return $this->write(\substr($line, 0, $n), $n); } /** * Write all, i.e. as much as possible. * * @param string $string String. * @return mixed */ public function writeAll($string) { return $this->write($string, \strlen($string)); } /** * Truncate a file to a given length. * * @param int $size Size. * @return bool */ public function truncate($size) { return \ftruncate($this->getStream(), $size); } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\File\Link; use Hoa\File; use Hoa\Stream; /** * Class \Hoa\File\Link\Read. * * File handler. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Read extends \Hoa\File\Link\Link implements Stream\IStream\In { /** * Open a file. * * @param string $streamName Stream name. * @param string $mode Open mode, see the parent::MODE_* constants. * @param string $context Context ID (please, see the * \Hoa\Stream\Context class). * @param bool $wait Differ opening or not. */ public function __construct($streamName, $mode = parent::MODE_READ, $context = null, $wait = \false) { parent::__construct($streamName, $mode, $context, $wait); return; } /** * Open the stream and return the associated resource. * * @param string $streamName Stream name (e.g. path or URL). * @param \Hoa\Stream\Context $context Context. * @return resource * @throws \Hoa\File\Exception\FileDoesNotExist * @throws \Hoa\File\Exception */ protected function &_open($streamName, Stream\Context $context = null) { static $createModes = [parent::MODE_READ]; if (!\in_array($this->getMode(), $createModes)) { throw new File\Exception('Open mode are not supported; given %d. Only %s are supported.', 0, [$this->getMode(), \implode(', ', $createModes)]); } \preg_match('#^(\\w+)://#', $streamName, $match); if ((isset($match[1]) && $match[1] == 'file' || !isset($match[1])) && !\file_exists($streamName)) { throw new File\Exception\FileDoesNotExist('File %s does not exist.', 1, $streamName); } $out = parent::_open($streamName, $context); return $out; } /** * Test for end-of-file. * * @return bool */ public function eof() { return \feof($this->getStream()); } /** * Read n characters. * * @param int $length Length. * @return string * @throws \Hoa\File\Exception */ public function read($length) { if (0 > $length) { throw new File\Exception('Length must be greater than 0, given %d.', 2, $length); } return \fread($this->getStream(), $length); } /** * Alias of $this->read(). * * @param int $length Length. * @return string */ public function readString($length) { return $this->read($length); } /** * Read a character. * * @return string */ public function readCharacter() { return \fgetc($this->getStream()); } /** * Read a boolean. * * @return bool */ public function readBoolean() { return (bool) $this->read(1); } /** * Read an integer. * * @param int $length Length. * @return int */ public function readInteger($length = 1) { return (int) $this->read($length); } /** * Read a float. * * @param int $length Length. * @return float */ public function readFloat($length = 1) { return (float) $this->read($length); } /** * Read an array. * Alias of the $this->scanf() method. * * @param string $format Format (see printf's formats). * @return array */ public function readArray($format = null) { return $this->scanf($format); } /** * Read a line. * * @return string */ public function readLine() { return \fgets($this->getStream()); } /** * Read all, i.e. read as much as possible. * * @param int $offset Offset. * @return string */ public function readAll($offset = 0) { return \stream_get_contents($this->getStream(), -1, $offset); } /** * Parse input from a stream according to a format. * * @param string $format Format (see printf's formats). * @return array */ public function scanf($format) { return \fscanf($this->getStream(), $format); } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\File\Link; use Hoa\File; use Hoa\Stream; /** * Class \Hoa\File\Link\Write. * * File handler. * * @license New BSD License */ class Write extends \Hoa\File\Link\Link implements Stream\IStream\Out { /** * Open a file. * * @param string $streamName Stream name. * @param string $mode Open mode, see the parent::MODE_* constants. * @param string $context Context ID (please, see the * \Hoa\Stream\Context class). * @param bool $wait Differ opening or not. */ public function __construct($streamName, $mode = parent::MODE_APPEND_WRITE, $context = null, $wait = \false) { parent::__construct($streamName, $mode, $context, $wait); return; } /** * Open the stream and return the associated resource. * * @param string $streamName Stream name (e.g. path or URL). * @param \Hoa\Stream\Context $context Context. * @return resource * @throws \Hoa\File\Exception\FileDoesNotExist * @throws \Hoa\File\Exception */ protected function &_open($streamName, Stream\Context $context = null) { static $createModes = [parent::MODE_TRUNCATE_WRITE, parent::MODE_APPEND_WRITE, parent::MODE_CREATE_WRITE]; if (!\in_array($this->getMode(), $createModes)) { throw new File\Exception('Open mode are not supported; given %d. Only %s are supported.', 0, [$this->getMode(), \implode(', ', $createModes)]); } \preg_match('#^(\\w+)://#', $streamName, $match); if ((isset($match[1]) && $match[1] == 'file' || !isset($match[1])) && !\file_exists($streamName)) { throw new File\Exception\FileDoesNotExist('File %s does not exist.', 1, $streamName); } $out = parent::_open($streamName, $context); return $out; } /** * Write n characters. * * @param string $string String. * @param int $length Length. * @return mixed * @throws \Hoa\File\Exception */ public function write($string, $length) { if (0 > $length) { throw new File\Exception('Length must be greater than 0, given %d.', 2, $length); } return \fwrite($this->getStream(), $string, $length); } /** * Write a string. * * @param string $string String. * @return mixed */ public function writeString($string) { $string = (string) $string; return $this->write($string, \strlen($string)); } /** * Write a character. * * @param string $char Character. * @return mixed */ public function writeCharacter($char) { return $this->write((string) $char[0], 1); } /** * Write a boolean. * * @param bool $boolean Boolean. * @return mixed */ public function writeBoolean($boolean) { return $this->write((string) (bool) $boolean, 1); } /** * Write an integer. * * @param int $integer Integer. * @return mixed */ public function writeInteger($integer) { $integer = (string) (int) $integer; return $this->write($integer, \strlen($integer)); } /** * Write a float. * * @param float $float Float. * @return mixed */ public function writeFloat($float) { $float = (string) (float) $float; return $this->write($float, \strlen($float)); } /** * Write an array. * * @param array $array Array. * @return mixed */ public function writeArray(array $array) { $array = \var_export($array, \true); return $this->write($array, \strlen($array)); } /** * Write a line. * * @param string $line Line. * @return mixed */ public function writeLine($line) { if (\false === ($n = \strpos($line, "\n"))) { return $this->write($line . "\n", \strlen($line) + 1); } ++$n; return $this->write(\substr($line, 0, $n), $n); } /** * Write all, i.e. as much as possible. * * @param string $string String. * @return mixed */ public function writeAll($string) { return $this->write($string, \strlen($string)); } /** * Truncate a file to a given length. * * @param int $size Size. * @return bool */ public function truncate($size) { return \ftruncate($this->getStream(), $size); } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\File; use Hoa\Iterator; /** * Class \Hoa\File\SplFileInfo. * * Link between \Hoa\Iterator\SplFileInfo and \Hoa\File. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class SplFileInfo extends Iterator\SplFileInfo { /** * Current stream. * * @var \Hoa\File\Generic */ protected $_stream = null; /** * Open the SplFileInfo as a Hoa\File stream. * * @return \Hoa\File\Generic * @throws \Hoa\File\Exception */ public function open() { if (\true === $this->isFile()) { return $this->_stream = new \Hoa\File\ReadWrite($this->getPathname()); } elseif (\true === $this->isDir()) { return $this->_stream = new \Hoa\File\Directory($this->getPathname()); } elseif (\true === $this->isLink()) { return $this->_stream = new \Hoa\File\Link\ReadWrite($this->getPathname()); } throw new \Hoa\File\Exception('%s has an unknown type.', 0, $this->getPathname()); } /** * Close the opened stream. * * @return void */ public function close() { if (null === $this->_stream) { return; } return $this->_stream->close(); } /** * Destruct. * * @return void */ public function __destruct() { $this->close(); return; } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\File; use Hoa\Consistency; use Hoa\Stream; /** * Class \Hoa\File. * * File handler. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ abstract class File extends \Hoa\File\Generic implements Stream\IStream\Bufferable, Stream\IStream\Lockable, Stream\IStream\Pointable { /** * Open for reading only; place the file pointer at the beginning of the * file. * * @const string */ const MODE_READ = 'rb'; /** * Open for reading and writing; place the file pointer at the beginning of * the file. * * @const string */ const MODE_READ_WRITE = 'r+b'; /** * Open for writing only; place the file pointer at the beginning of the * file and truncate the file to zero length. If the file does not exist, * attempt to create it. * * @const string */ const MODE_TRUNCATE_WRITE = 'wb'; /** * Open for reading and writing; place the file pointer at the beginning of * the file and truncate the file to zero length. If the file does not * exist, attempt to create it. * * @const string */ const MODE_TRUNCATE_READ_WRITE = 'w+b'; /** * Open for writing only; place the file pointer at the end of the file. If * the file does not exist, attempt to create it. * * @const string */ const MODE_APPEND_WRITE = 'ab'; /** * Open for reading and writing; place the file pointer at the end of the * file. If the file does not exist, attempt to create it. * * @const string */ const MODE_APPEND_READ_WRITE = 'a+b'; /** * Create and open for writing only; place the file pointer at the beginning * of the file. If the file already exits, the fopen() call with fail by * returning false and generating an error of level E_WARNING. If the file * does not exist, attempt to create it. This is equivalent to specifying * O_EXCL | O_CREAT flags for the underlying open(2) system call. * * @const string */ const MODE_CREATE_WRITE = 'xb'; /** * Create and open for reading and writing; place the file pointer at the * beginning of the file. If the file already exists, the fopen() call with * fail by returning false and generating an error of level E_WARNING. If * the file does not exist, attempt to create it. This is equivalent to * specifying O_EXCL | O_CREAT flags for the underlying open(2) system call. * * @const string */ const MODE_CREATE_READ_WRITE = 'x+b'; /** * Open a file. * * @param string $streamName Stream name (or file descriptor). * @param string $mode Open mode, see the self::MODE_* * constants. * @param string $context Context ID (please, see the * \Hoa\Stream\Context class). * @param bool $wait Differ opening or not. * @throws \Hoa\File\Exception */ public function __construct($streamName, $mode, $context = null, $wait = \false) { $this->setMode($mode); switch ($streamName) { case '0': $streamName = 'php://stdin'; break; case '1': $streamName = 'php://stdout'; break; case '2': $streamName = 'php://stderr'; break; default: if (\true === \ctype_digit($streamName)) { if (\PHP_VERSION_ID >= 50306) { $streamName = 'php://fd/' . $streamName; } else { throw new \Hoa\File\Exception('You need PHP5.3.6 to use a file descriptor ' . 'other than 0, 1 or 2 (tried %d with PHP%s).', 0, [$streamName, \PHP_VERSION]); } } } parent::__construct($streamName, $context, $wait); return; } /** * Open the stream and return the associated resource. * * @param string $streamName Stream name (e.g. path or URL). * @param \Hoa\Stream\Context $context Context. * @return resource * @throws \Hoa\File\Exception\FileDoesNotExist * @throws \Hoa\File\Exception */ protected function &_open($streamName, ?Stream\Context $context = null) { if (\substr($streamName, 0, 4) == 'file' && \false === \is_dir(\dirname($streamName))) { throw new \Hoa\File\Exception('Directory %s does not exist. Could not open file %s.', 1, [\dirname($streamName), \basename($streamName)]); } if (null === $context) { if (\false === ($out = @\fopen($streamName, $this->getMode(), \true))) { throw new \Hoa\File\Exception('Failed to open stream %s.', 2, $streamName); } return $out; } $out = @\fopen($streamName, $this->getMode(), \true, $context->getContext()); if (\false === $out) { throw new \Hoa\File\Exception('Failed to open stream %s.', 3, $streamName); } return $out; } /** * Close the current stream. * * @return bool */ protected function _close() { return @\fclose($this->getStream()); } /** * Start a new buffer. * The callable acts like a light filter. * * @param mixed $callable Callable. * @param int $size Size. * @return int */ public function newBuffer($callable = null, $size = null) { $this->setStreamBuffer($size); //@TODO manage $callable as a filter? return 1; } /** * Flush the output to a stream. * * @return bool */ public function flush() { return \fflush($this->getStream()); } /** * Delete buffer. * * @return bool */ public function deleteBuffer() { return $this->disableStreamBuffer(); } /** * Get bufffer level. * * @return int */ public function getBufferLevel() { return 1; } /** * Get buffer size. * * @return int */ public function getBufferSize() { return $this->getStreamBufferSize(); } /** * Portable advisory locking. * * @param int $operation Operation, use the * \Hoa\Stream\IStream\Lockable::LOCK_* constants. * @return bool */ public function lock($operation) { return \flock($this->getStream(), $operation); } /** * Rewind the position of a stream pointer. * * @return bool */ public function rewind() { return \rewind($this->getStream()); } /** * Seek on a stream pointer. * * @param int $offset Offset (negative value should be supported). * @param int $whence Whence, use the * \Hoa\Stream\IStream\Pointable::SEEK_* constants. * @return int */ public function seek($offset, $whence = Stream\IStream\Pointable::SEEK_SET) { return \fseek($this->getStream(), $offset, $whence); } /** * Get the current position of the stream pointer. * * @return int */ public function tell() { $stream = $this->getStream(); if (null === $stream) { return 0; } return \ftell($stream); } /** * Create a file. * * @param string $name File name. * @param mixed $dummy To be compatible with childs. * @return bool */ public static function create($name, $dummy) { if (\file_exists($name)) { return \true; } return \touch($name); } } /** * Flex entity. */ Consistency::flexEntity('Hoa\\File\\File'); <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\File; use Hoa\Stream; /** * Class \Hoa\File\ReadWrite. * * File handler. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class ReadWrite extends \Hoa\File\File implements Stream\IStream\In, Stream\IStream\Out { /** * Open a file. * * @param string $streamName Stream name. * @param string $mode Open mode, see the self::MODE_* constants. * @param string $context Context ID (please, see the * \Hoa\Stream\Context class). * @param bool $wait Differ opening or not. */ public function __construct($streamName, $mode = parent::MODE_APPEND_READ_WRITE, $context = null, $wait = \false) { parent::__construct($streamName, $mode, $context, $wait); return; } /** * Open the stream and return the associated resource. * * @param string $streamName Stream name (e.g. path or URL). * @param \Hoa\Stream\Context $context Context. * @return resource * @throws \Hoa\File\Exception\FileDoesNotExist * @throws \Hoa\File\Exception */ protected function &_open($streamName, Stream\Context $context = null) { static $createModes = [parent::MODE_READ_WRITE, parent::MODE_TRUNCATE_READ_WRITE, parent::MODE_APPEND_READ_WRITE, parent::MODE_CREATE_READ_WRITE]; if (!\in_array($this->getMode(), $createModes)) { throw new \Hoa\File\Exception('Open mode are not supported; given %d. Only %s are supported.', 0, [$this->getMode(), \implode(', ', $createModes)]); } \preg_match('#^(\\w+)://#', $streamName, $match); if ((isset($match[1]) && $match[1] == 'file' || !isset($match[1])) && !\file_exists($streamName) && parent::MODE_READ_WRITE == $this->getMode()) { throw new \Hoa\File\Exception\FileDoesNotExist('File %s does not exist.', 1, $streamName); } $out = parent::_open($streamName, $context); return $out; } /** * Test for end-of-file. * * @return bool */ public function eof() { return \feof($this->getStream()); } /** * Read n characters. * * @param int $length Length. * @return string * @throws \Hoa\File\Exception */ public function read($length) { if (0 > $length) { throw new \Hoa\File\Exception('Length must be greater than 0, given %d.', 2, $length); } return \fread($this->getStream(), $length); } /** * Alias of $this->read(). * * @param int $length Length. * @return string */ public function readString($length) { return $this->read($length); } /** * Read a character. * * @return string */ public function readCharacter() { return \fgetc($this->getStream()); } /** * Read a boolean. * * @return bool */ public function readBoolean() { return (bool) $this->read(1); } /** * Read an integer. * * @param int $length Length. * @return int */ public function readInteger($length = 1) { return (int) $this->read($length); } /** * Read a float. * * @param int $length Length. * @return float */ public function readFloat($length = 1) { return (float) $this->read($length); } /** * Read an array. * Alias of the $this->scanf() method. * * @param string $format Format (see printf's formats). * @return array */ public function readArray($format = null) { return $this->scanf($format); } /** * Read a line. * * @return string */ public function readLine() { return \fgets($this->getStream()); } /** * Read all, i.e. read as much as possible. * * @param int $offset Offset. * @return string */ public function readAll($offset = 0) { return \stream_get_contents($this->getStream(), -1, $offset); } /** * Parse input from a stream according to a format. * * @param string $format Format (see printf's formats). * @return array */ public function scanf($format) { return \fscanf($this->getStream(), $format); } /** * Write n characters. * * @param string $string String. * @param int $length Length. * @return mixed * @throws \Hoa\File\Exception */ public function write($string, $length) { if (0 > $length) { throw new \Hoa\File\Exception('Length must be greater than 0, given %d.', 3, $length); } return \fwrite($this->getStream(), $string, $length); } /** * Write a string. * * @param string $string String. * @return mixed */ public function writeString($string) { $string = (string) $string; return $this->write($string, \strlen($string)); } /** * Write a character. * * @param string $char Character. * @return mixed */ public function writeCharacter($char) { return $this->write((string) $char[0], 1); } /** * Write a boolean. * * @param bool $boolean Boolean. * @return mixed */ public function writeBoolean($boolean) { return $this->write((string) (bool) $boolean, 1); } /** * Write an integer. * * @param int $integer Integer. * @return mixed */ public function writeInteger($integer) { $integer = (string) (int) $integer; return $this->write($integer, \strlen($integer)); } /** * Write a float. * * @param float $float Float. * @return mixed */ public function writeFloat($float) { $float = (string) (float) $float; return $this->write($float, \strlen($float)); } /** * Write an array. * * @param array $array Array. * @return mixed */ public function writeArray(array $array) { $array = \var_export($array, \true); return $this->write($array, \strlen($array)); } /** * Write a line. * * @param string $line Line. * @return mixed */ public function writeLine($line) { if (\false === ($n = \strpos($line, "\n"))) { return $this->write($line . "\n", \strlen($line) + 1); } ++$n; return $this->write(\substr($line, 0, $n), $n); } /** * Write all, i.e. as much as possible. * * @param string $string String. * @return mixed */ public function writeAll($string) { return $this->write($string, \strlen($string)); } /** * Truncate a file to a given length. * * @param int $size Size. * @return bool */ public function truncate($size) { return \ftruncate($this->getStream(), $size); } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\File; use Hoa\Event; /** * Class \Hoa\File\Watcher. * * A naive file system watcher that fires three events: new, move and modify. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Watcher extends \Hoa\File\Finder implements Event\Listenable { use Event\Listens; /** * Latency. * * @var int */ protected $_latency = 1; /** * Constructor. * * @param int $latency Latency (in seconds). */ public function __construct($latency = null) { parent::__construct(); $this->setListener(new Event\Listener($this, ['new', 'modify', 'move'])); if (null !== $latency) { $this->setLatency($latency); } return; } /** * Run the watcher. * * Listenable events: * • new, when a file is new, i.e. found by the finder; * • modify, when a file has been modified; * • move, when a file has moved, i.e. no longer found by the finder. * * @return void */ public function run() { $iterator = $this->getIterator(); $previous = \iterator_to_array($iterator); $current = $previous; while (\true) { foreach ($current as $name => $c) { if (!isset($previous[$name])) { $this->getListener()->fire('new', new Event\Bucket(['file' => $c])); continue; } if (null === $c->getHash()) { unset($current[$name]); continue; } if ($previous[$name]->getHash() != $c->getHash()) { $this->getListener()->fire('modify', new Event\Bucket(['file' => $c])); } unset($previous[$name]); } foreach ($previous as $p) { $this->getListener()->fire('move', new Event\Bucket(['file' => $p])); } \usleep($this->getLatency() * 1000000); $previous = $current; $current = \iterator_to_array($iterator); } return; } /** * Set latency. * * @param int $latency Latency (in seconds). * @return int */ public function setLatency($latency) { $old = $this->_latency; $this->_latency = $latency; return $old; } /** * Get latency. * * @return int */ public function getLatency() { return $this->_latency; } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\File; use Hoa\Stream; /** * Class \Hoa\File\Generic. * * Describe a super-file. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ abstract class Generic extends Stream implements Stream\IStream\Pathable, Stream\IStream\Statable, Stream\IStream\Touchable { /** * Mode. * * @var string */ protected $_mode = null; /** * Get filename component of path. * * @return string */ public function getBasename() { return \basename($this->getStreamName()); } /** * Get directory name component of path. * * @return string */ public function getDirname() { return \dirname($this->getStreamName()); } /** * Get size. * * @return int */ public function getSize() { if (\false === $this->getStatistic()) { return \false; } return \filesize($this->getStreamName()); } /** * Get informations about a file. * * @return array */ public function getStatistic() { return \fstat($this->getStream()); } /** * Get last access time of file. * * @return int */ public function getATime() { return \fileatime($this->getStreamName()); } /** * Get inode change time of file. * * @return int */ public function getCTime() { return \filectime($this->getStreamName()); } /** * Get file modification time. * * @return int */ public function getMTime() { return \filemtime($this->getStreamName()); } /** * Get file group. * * @return int */ public function getGroup() { return \filegroup($this->getStreamName()); } /** * Get file owner. * * @return int */ public function getOwner() { return \fileowner($this->getStreamName()); } /** * Get file permissions. * * @return int */ public function getPermissions() { return \fileperms($this->getStreamName()); } /** * Get file permissions as a string. * Result sould be interpreted like this: * * s: socket; * * l: symbolic link; * * -: regular; * * b: block special; * * d: directory; * * c: character special; * * p: FIFO pipe; * * u: unknown. * * @return string */ public function getReadablePermissions() { $p = $this->getPermissions(); if (($p & 0xc000) == 0xc000) { $out = 's'; } elseif (($p & 0xa000) == 0xa000) { $out = 'l'; } elseif (($p & 0x8000) == 0x8000) { $out = '-'; } elseif (($p & 0x6000) == 0x6000) { $out = 'b'; } elseif (($p & 0x4000) == 0x4000) { $out = 'd'; } elseif (($p & 0x2000) == 0x2000) { $out = 'c'; } elseif (($p & 0x1000) == 0x1000) { $out = 'p'; } else { $out = 'u'; } $out .= ($p & 0x100 ? 'r' : '-') . ($p & 0x80 ? 'w' : '-') . ($p & 0x40 ? $p & 0x800 ? 's' : 'x' : ($p & 0x800 ? 'S' : '-')) . ($p & 0x20 ? 'r' : '-') . ($p & 0x10 ? 'w' : '-') . ($p & 0x8 ? $p & 0x400 ? 's' : 'x' : ($p & 0x400 ? 'S' : '-')) . ($p & 0x4 ? 'r' : '-') . ($p & 0x2 ? 'w' : '-') . ($p & 0x1 ? $p & 0x200 ? 't' : 'x' : ($p & 0x200 ? 'T' : '-')); return $out; } /** * Check if the file is readable. * * @return bool */ public function isReadable() { return \is_readable($this->getStreamName()); } /** * Check if the file is writable. * * @return bool */ public function isWritable() { return \is_writable($this->getStreamName()); } /** * Check if the file is executable. * * @return bool */ public function isExecutable() { return \is_executable($this->getStreamName()); } /** * Clear file status cache. * * @return void */ public function clearStatisticCache() { \clearstatcache(\true, $this->getStreamName()); return; } /** * Clear all files status cache. * * @return void */ public static function clearAllStatisticCaches() { \clearstatcache(); return; } /** * Set access and modification time of file. * * @param int $time Time. If equals to -1, time() should be used. * @param int $atime Access time. If equals to -1, $time should be * used. * @return bool */ public function touch($time = -1, $atime = -1) { if ($time == -1) { $time = \time(); } if ($atime == -1) { $atime = $time; } return \touch($this->getStreamName(), $time, $atime); } /** * Copy file. * Return the destination file path if succeed, false otherwise. * * @param string $to Destination path. * @param bool $force Force to copy if the file $to already exists. * Use the \Hoa\Stream\IStream\Touchable::*OVERWRITE * constants. * @return bool */ public function copy($to, $force = Stream\IStream\Touchable::DO_NOT_OVERWRITE) { $from = $this->getStreamName(); if ($force === Stream\IStream\Touchable::DO_NOT_OVERWRITE && \true === \file_exists($to)) { return \true; } if (null === $this->getStreamContext()) { return @\copy($from, $to); } return @\copy($from, $to, $this->getStreamContext()->getContext()); } /** * Move a file. * * @param string $name New name. * @param bool $force Force to move if the file $name already * exists. * Use the \Hoa\Stream\IStream\Touchable::*OVERWRITE * constants. * @param bool $mkdir Force to make directory if does not exist. * Use the \Hoa\Stream\IStream\Touchable::*DIRECTORY * constants. * @return bool */ public function move($name, $force = Stream\IStream\Touchable::DO_NOT_OVERWRITE, $mkdir = Stream\IStream\Touchable::DO_NOT_MAKE_DIRECTORY) { $from = $this->getStreamName(); if ($force === Stream\IStream\Touchable::DO_NOT_OVERWRITE && \true === \file_exists($name)) { return \false; } if (Stream\IStream\Touchable::MAKE_DIRECTORY === $mkdir) { \Hoa\File\Directory::create(\dirname($name), \Hoa\File\Directory::MODE_CREATE_RECURSIVE); } if (null === $this->getStreamContext()) { return @\rename($from, $name); } return @\rename($from, $name, $this->getStreamContext()->getContext()); } /** * Delete a file. * * @return bool */ public function delete() { if (null === $this->getStreamContext()) { return @\unlink($this->getStreamName()); } return @\unlink($this->getStreamName(), $this->getStreamContext()->getContext()); } /** * Change file group. * * @param mixed $group Group name or number. * @return bool */ public function changeGroup($group) { return \chgrp($this->getStreamName(), $group); } /** * Change file mode. * * @param int $mode Mode (in octal!). * @return bool */ public function changeMode($mode) { return \chmod($this->getStreamName(), $mode); } /** * Change file owner. * * @param mixed $user User. * @return bool */ public function changeOwner($user) { return \chown($this->getStreamName(), $user); } /** * Change the current umask. * * @param int $umask Umask (in octal!). If null, given the current * umask value. * @return int */ public static function umask($umask = null) { if (null === $umask) { return \umask(); } return \umask($umask); } /** * Check if it is a file. * * @return bool */ public function isFile() { return \is_file($this->getStreamName()); } /** * Check if it is a link. * * @return bool */ public function isLink() { return \is_link($this->getStreamName()); } /** * Check if it is a directory. * * @return bool */ public function isDirectory() { return \is_dir($this->getStreamName()); } /** * Check if it is a socket. * * @return bool */ public function isSocket() { return \filetype($this->getStreamName()) == 'socket'; } /** * Check if it is a FIFO pipe. * * @return bool */ public function isFIFOPipe() { return \filetype($this->getStreamName()) == 'fifo'; } /** * Check if it is character special file. * * @return bool */ public function isCharacterSpecial() { return \filetype($this->getStreamName()) == 'char'; } /** * Check if it is block special. * * @return bool */ public function isBlockSpecial() { return \filetype($this->getStreamName()) == 'block'; } /** * Check if it is an unknown type. * * @return bool */ public function isUnknown() { return \filetype($this->getStreamName()) == 'unknown'; } /** * Set the open mode. * * @param string $mode Open mode. Please, see the child::MODE_* * constants. * @return string */ protected function setMode($mode) { $old = $this->_mode; $this->_mode = $mode; return $old; } /** * Get the open mode. * * @return string */ public function getMode() { return $this->_mode; } /** * Get inode. * * @return int */ public function getINode() { return \fileinode($this->getStreamName()); } /** * Check if the system is case sensitive or not. * * @return bool */ public static function isCaseSensitive() { return !(\file_exists(\mb_strtolower(__FILE__)) && \file_exists(\mb_strtoupper(__FILE__))); } /** * Get a canonicalized absolute pathname. * * @return string */ public function getRealPath() { if (\false === ($out = \realpath($this->getStreamName()))) { return $this->getStreamName(); } return $out; } /** * Get file extension (if exists). * * @return string */ public function getExtension() { return \pathinfo($this->getStreamName(), \PATHINFO_EXTENSION); } /** * Get filename without extension. * * @return string */ public function getFilename() { $file = \basename($this->getStreamName()); if (\defined('PATHINFO_FILENAME')) { return \pathinfo($file, \PATHINFO_FILENAME); } if (\strstr($file, '.')) { return \substr($file, 0, \strrpos($file, '.')); } return $file; } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\File; use Hoa\Stream; /** * Class \Hoa\File\Read. * * File handler. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Read extends \Hoa\File\File implements Stream\IStream\In { /** * Open a file. * * @param string $streamName Stream name. * @param string $mode Open mode, see the self::MODE_* constants. * @param string $context Context ID (please, see the * \Hoa\Stream\Context class). * @param bool $wait Differ opening or not. */ public function __construct($streamName, $mode = parent::MODE_READ, $context = null, $wait = \false) { parent::__construct($streamName, $mode, $context, $wait); return; } /** * Open the stream and return the associated resource. * * @param string $streamName Stream name (e.g. path or URL). * @param \Hoa\Stream\Context $context Context. * @return resource * @throws \Hoa\File\Exception\FileDoesNotExist * @throws \Hoa\File\Exception */ protected function &_open($streamName, ?Stream\Context $context = null) { static $createModes = [parent::MODE_READ]; if (!\in_array($this->getMode(), $createModes)) { throw new \Hoa\File\Exception('Open mode are not supported; given %d. Only %s are supported.', 0, [$this->getMode(), \implode(', ', $createModes)]); } \preg_match('#^(\\w+)://#', $streamName, $match); if ((isset($match[1]) && $match[1] == 'file' || !isset($match[1])) && !\file_exists($streamName)) { throw new \Hoa\File\Exception\FileDoesNotExist('File %s does not exist.', 1, $streamName); } $out = parent::_open($streamName, $context); return $out; } /** * Test for end-of-file. * * @return bool */ public function eof() { return \feof($this->getStream()); } /** * Read n characters. * * @param int $length Length. * @return string * @throws \Hoa\File\Exception */ public function read($length) { if (0 > $length) { throw new \Hoa\File\Exception('Length must be greater than 0, given %d.', 2, $length); } return \fread($this->getStream(), $length); } /** * Alias of $this->read(). * * @param int $length Length. * @return string */ public function readString($length) { return $this->read($length); } /** * Read a character. * * @return string */ public function readCharacter() { return \fgetc($this->getStream()); } /** * Read a boolean. * * @return bool */ public function readBoolean() { return (bool) $this->read(1); } /** * Read an integer. * * @param int $length Length. * @return int */ public function readInteger($length = 1) { return (int) $this->read($length); } /** * Read a float. * * @param int $length Length. * @return float */ public function readFloat($length = 1) { return (float) $this->read($length); } /** * Read an array. * Alias of the $this->scanf() method. * * @param string $format Format (see printf's formats). * @return array */ public function readArray($format = null) { return $this->scanf($format); } /** * Read a line. * * @return string */ public function readLine() { return \fgets($this->getStream()); } /** * Read all, i.e. read as much as possible. * * @param int $offset Offset. * @return string */ public function readAll($offset = 0) { return \stream_get_contents($this->getStream(), -1, $offset); } /** * Parse input from a stream according to a format. * * @param string $format Format (see printf's formats). * @return array */ public function scanf($format) { return \fscanf($this->getStream(), $format); } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\File\Exception; use Hoa\Consistency; use Hoa\Exception as HoaException; /** * Class \Hoa\File\Exception. * * Extending the \Hoa\Exception\Exception class. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Exception extends HoaException { } /** * Flex entity. */ Consistency::flexEntity('Hoa\\File\\Exception\\Exception'); <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\File\Exception; /** * Class \Hoa\File\Exception\FileDoesNotExist. * * Extending the \Hoa\File\Exception class. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class FileDoesNotExist extends \Hoa\File\Exception\Exception { } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\File; use Hoa\Stream; /** * Class \Hoa\File\Write. * * File handler. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Write extends \Hoa\File\File implements Stream\IStream\Out { /** * Open a file. * * @param string $streamName Stream name. * @param string $mode Open mode, see the self::MODE_* constants. * @param string $context Context ID (please, see the * \Hoa\Stream\Context class). * @param bool $wait Differ opening or not. */ public function __construct($streamName, $mode = parent::MODE_APPEND_WRITE, $context = null, $wait = \false) { parent::__construct($streamName, $mode, $context, $wait); return; } /** * Open the stream and return the associated resource. * * @param string $streamName Stream name (e.g. path or URL). * @param \Hoa\Stream\Context $context Context. * @return resource * @throws \Hoa\File\Exception\FileDoesNotExist * @throws \Hoa\File\Exception */ protected function &_open($streamName, Stream\Context $context = null) { static $createModes = [parent::MODE_TRUNCATE_WRITE, parent::MODE_APPEND_WRITE, parent::MODE_CREATE_WRITE]; if (!\in_array($this->getMode(), $createModes)) { throw new \Hoa\File\Exception('Open mode are not supported; given %d. Only %s are supported.', 0, [$this->getMode(), \implode(', ', $createModes)]); } \preg_match('#^(\\w+)://#', $streamName, $match); if ((isset($match[1]) && $match[1] == 'file' || !isset($match[1])) && !\file_exists($streamName) && parent::MODE_TRUNCATE_WRITE == $this->getMode()) { throw new \Hoa\File\Exception\FileDoesNotExist('File %s does not exist.', 1, $streamName); } $out = parent::_open($streamName, $context); return $out; } /** * Write n characters. * * @param string $string String. * @param int $length Length. * @return mixed * @throws \Hoa\File\Exception */ public function write($string, $length) { if (0 > $length) { throw new \Hoa\File\Exception('Length must be greater than 0, given %d.', 2, $length); } return \fwrite($this->getStream(), $string, $length); } /** * Write a string. * * @param string $string String. * @return mixed */ public function writeString($string) { $string = (string) $string; return $this->write($string, \strlen($string)); } /** * Write a character. * * @param string $char Character. * @return mixed */ public function writeCharacter($char) { return $this->write((string) $char[0], 1); } /** * Write a boolean. * * @param bool $boolean Boolean. * @return mixed */ public function writeBoolean($boolean) { return $this->write((string) (bool) $boolean, 1); } /** * Write an integer. * * @param int $integer Integer. * @return mixed */ public function writeInteger($integer) { $integer = (string) (int) $integer; return $this->write($integer, \strlen($integer)); } /** * Write a float. * * @param float $float Float. * @return mixed */ public function writeFloat($float) { $float = (string) (float) $float; return $this->write($float, \strlen($float)); } /** * Write an array. * * @param array $array Array. * @return mixed */ public function writeArray(array $array) { $array = \var_export($array, \true); return $this->write($array, \strlen($array)); } /** * Write a line. * * @param string $line Line. * @return mixed */ public function writeLine($line) { if (\false === ($n = \strpos($line, "\n"))) { return $this->write($line . "\n", \strlen($line) + 1); } ++$n; return $this->write(\substr($line, 0, $n), $n); } /** * Write all, i.e. as much as possible. * * @param string $string String. * @return mixed */ public function writeAll($string) { return $this->write($string, \strlen($string)); } /** * Truncate a file to a given length. * * @param int $size Size. * @return bool */ public function truncate($size) { return \ftruncate($this->getStream(), $size); } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\File; use Hoa\Stream; /** * Class \Hoa\File\Directory. * * Directory handler. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Directory extends \Hoa\File\Generic { /** * Open for reading. * * @const string */ const MODE_READ = 'rb'; /** * Open for reading and writing. If the directory does not exist, attempt to * create it. * * @const string */ const MODE_CREATE = 'xb'; /** * Open for reading and writing. If the directory does not exist, attempt to * create it recursively. * * @const string */ const MODE_CREATE_RECURSIVE = 'xrb'; /** * Open a directory. * * @param string $streamName Stream name. * @param string $mode Open mode, see the self::MODE* constants. * @param string $context Context ID (please, see the * \Hoa\Stream\Context class). * @param bool $wait Differ opening or not. */ public function __construct($streamName, $mode = self::MODE_READ, $context = null, $wait = \false) { $this->setMode($mode); parent::__construct($streamName, $context, $wait); return; } /** * Open the stream and return the associated resource. * * @param string $streamName Stream name (e.g. path or URL). * @param \Hoa\Stream\Context $context Context. * @return resource * @throws \Hoa\File\Exception\FileDoesNotExist * @throws \Hoa\File\Exception */ protected function &_open($streamName, Stream\Context $context = null) { if (\false === \is_dir($streamName)) { if ($this->getMode() == self::MODE_READ) { throw new \Hoa\File\Exception\FileDoesNotExist('Directory %s does not exist.', 0, $streamName); } else { self::create($streamName, $this->getMode(), null !== $context ? $context->getContext() : null); } } $out = null; return $out; } /** * Close the current stream. * * @return bool */ protected function _close() { return \true; } /** * Recursive copy of a directory. * * @param string $to Destination path. * @param bool $force Force to copy if the file $to already exists. * Use the \Hoa\Stream\IStream\Touchable::*OVERWRITE * constants. * @return bool * @throws \Hoa\File\Exception */ public function copy($to, $force = Stream\IStream\Touchable::DO_NOT_OVERWRITE) { if (empty($to)) { throw new \Hoa\File\Exception('The destination path (to copy) is empty.', 1); } $from = $this->getStreamName(); $fromLength = \strlen($from) + 1; $finder = new \Hoa\File\Finder(); $finder->in($from); self::create($to, self::MODE_CREATE_RECURSIVE); foreach ($finder as $file) { $relative = \substr($file->getPathname(), $fromLength); $_to = $to . DS . $relative; if (\true === $file->isDir()) { self::create($_to, self::MODE_CREATE); continue; } // This is not possible to do `$file->open()->copy(); // $file->close();` because the file will be opened in read and // write mode. In a PHAR for instance, this operation is // forbidden. So a special care must be taken to open file in read // only mode. $handle = null; if (\true === $file->isFile()) { $handle = new \Hoa\File\Read($file->getPathname()); } elseif (\true === $file->isDir()) { $handle = new \Hoa\File\Directory($file->getPathName()); } elseif (\true === $file->isLink()) { $handle = new \Hoa\File\Link\Read($file->getPathName()); } if (null !== $handle) { $handle->copy($_to, $force); $handle->close(); } } return \true; } /** * Delete a directory. * * @return bool */ public function delete() { $from = $this->getStreamName(); $finder = new \Hoa\File\Finder(); $finder->in($from)->childFirst(); foreach ($finder as $file) { $file->open()->delete(); $file->close(); } if (null === $this->getStreamContext()) { return @\rmdir($from); } return @\rmdir($from, $this->getStreamContext()->getContext()); } /** * Create a directory. * * @param string $name Directory name. * @param string $mode Create mode. Please, see the self::MODE_CREATE* * constants. * @param string $context Context ID (please, see the * \Hoa\Stream\Context class). * @return bool * @throws \Hoa\File\Exception */ public static function create($name, $mode = self::MODE_CREATE_RECURSIVE, $context = null) { if (\true === \is_dir($name)) { return \true; } if (empty($name)) { return \false; } if (null !== $context) { if (\false === Stream\Context::contextExists($context)) { throw new \Hoa\File\Exception('Context %s was not previously declared, cannot retrieve ' . 'this context.', 2, $context); } else { $context = Stream\Context::getInstance($context); } } if (null === $context) { return @\mkdir($name, 0755, self::MODE_CREATE_RECURSIVE === $mode); } return @\mkdir($name, 0755, self::MODE_CREATE_RECURSIVE === $mode, $context->getContext()); } } This file was automatically generated by Composer Patches (https://github.com/cweagans/composer-patches) Patches applied to this directory: 0 Source: patches/File.patch 1 Source: patches/Read.patch <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Visitor; /** * Interface \Hoa\Visitor\Visit. * * Visitor interface. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ interface Visit { /** * Visit an element. * * @param \Hoa\Visitor\Element $element Element to visit. * @param mixed &$handle Handle (reference). * @param mixed $eldnah Handle (not reference). * @return mixed */ public function visit(\Hoa\Visitor\Element $element, &$handle = null, $eldnah = null); } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Visitor; /** * Interface \Hoa\Visitor\Element. * * Interface to visit an element. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ interface Element { /** * Accept a visitor. * * @param \Hoa\Visitor\Visit $visitor Visitor. * @param mixed &$handle Handle (refence). * @param mixed $eldnah Handle (no reference). * @return mixed */ public function accept(\Hoa\Visitor\Visit $visitor, &$handle = null, $eldnah = null); } // // Hoa // // // @license // // New BSD License // // Copyright © 2007-2017, Hoa community. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are met: // * Redistributions of source code must retain the above copyright // notice, this list of conditions and the following disclaimer. // * Redistributions in binary form must reproduce the above copyright // notice, this list of conditions and the following disclaimer in the // documentation and/or other materials provided with the distribution. // * Neither the name of the Hoa nor the names of its contributors may be // used to endorse or promote products derived from this software without // specific prior written permission. // // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" // AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE // IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE // ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE // LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR // CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF // SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS // INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN // CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) // ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE // POSSIBILITY OF SUCH DAMAGE. // // Grammar \Hoa\Regex\Grammar. // // Provide grammar of PCRE (Perl Compatible Regular Expression)for the LL(k) // parser. More informations at http://pcre.org/pcre.txt, sections pcrepattern & // pcresyntax. // // @copyright Copyright © 2007-2017 Hoa community. // @license New BSD License // // Skip. %skip nl \n // Character classes. %token negative_class_ \[\^ %token class_ \[ %token _class \] %token range \- // Internal options. %token internal_option \(\?[\-+]?[imsx]\) // Lookahead and lookbehind assertions. %token lookahead_ \(\?= %token negative_lookahead_ \(\?! %token lookbehind_ \(\?<= %token negative_lookbehind_ \(\?<! // Conditions. %token named_reference_ \(\?\(< -> nc %token absolute_reference_ \(\?\((?=\d) -> c %token relative_reference_ \(\?\((?=[\+\-]) -> c %token c:index [\+\-]?\d+ -> default %token assertion_reference_ \(\?\( // Comments. %token comment_ \(\?# -> co %token co:_comment \) -> default %token co:comment .*?(?=(?<!\\)\)) // Capturing group. %token named_capturing_ \(\?< -> nc %token nc:_named_capturing > -> default %token nc:capturing_name .+?(?=(?<!\\)>) %token non_capturing_ \(\?: %token non_capturing_reset_ \(\?\| %token atomic_group_ \(\?> %token capturing_ \( %token _capturing \) // Quantifiers (by default, greedy). %token zero_or_one_possessive \?\+ %token zero_or_one_lazy \?\? %token zero_or_one \? %token zero_or_more_possessive \*\+ %token zero_or_more_lazy \*\? %token zero_or_more \* %token one_or_more_possessive \+\+ %token one_or_more_lazy \+\? %token one_or_more \+ %token exactly_n \{[0-9]+\} %token n_to_m_possessive \{[0-9]+,[0-9]+\}\+ %token n_to_m_lazy \{[0-9]+,[0-9]+\}\? %token n_to_m \{[0-9]+,[0-9]+\} %token n_or_more_possessive \{[0-9]+,\}\+ %token n_or_more_lazy \{[0-9]+,\}\? %token n_or_more \{[0-9]+,\} // Alternation. %token alternation \| // Literal. %token character \\([aefnrt]|c[\x00-\x7f]) %token dynamic_character \\([0-7]{3}|x[0-9a-zA-Z]{2}|x{[0-9a-zA-Z]+}) // Please, see PCRESYNTAX(3), General Category properties, PCRE special category // properties and script names for \p{} and \P{}. %token character_type \\([CdDhHNRsSvVwWX]|[pP]{[^}]+}) %token anchor \\(bBAZzG)|\^|\$ %token match_point_reset \\K %token literal \\.|. // Rules. #expression: alternation() alternation: concatenation() ( ::alternation:: concatenation() #alternation )* concatenation: ( internal_options() | assertion() | quantification() | condition() ) ( ( internal_options() | assertion() | quantification() | condition() ) #concatenation )* #internal_options: <internal_option> #condition: ( ::named_reference_:: <capturing_name> ::_named_capturing:: #namedcondition | ( ::relative_reference_:: #relativecondition | ::absolute_reference_:: #absolutecondition ) <index> | ::assertion_reference_:: alternation() #assertioncondition ) ::_capturing:: concatenation()? ( ::alternation:: concatenation()? )? ::_capturing:: assertion: ( ::lookahead_:: #lookahead | ::negative_lookahead_:: #negativelookahead | ::lookbehind_:: #lookbehind | ::negative_lookbehind_:: #negativelookbehind ) alternation() ::_capturing:: quantification: ( class() | simple() ) ( quantifier() #quantification )? quantifier: <zero_or_one_possessive> | <zero_or_one_lazy> | <zero_or_one> | <zero_or_more_possessive> | <zero_or_more_lazy> | <zero_or_more> | <one_or_more_possessive> | <one_or_more_lazy> | <one_or_more> | <exactly_n> | <n_to_m_possessive> | <n_to_m_lazy> | <n_to_m> | <n_or_more_possessive> | <n_or_more_lazy> | <n_or_more> #class: ( ::negative_class_:: #negativeclass | ::class_:: ) ( range() | literal() )+ ::_class:: #range: literal() ::range:: literal() simple: capturing() | literal() capturing: ::comment_:: <comment>? ::_comment:: #comment | ( ::named_capturing_:: <capturing_name> ::_named_capturing:: #namedcapturing | ::non_capturing_:: #noncapturing | ::non_capturing_reset_:: #noncapturingreset | ::atomic_group_:: #atomicgroup | ::capturing_:: ) alternation() ::_capturing:: literal: <character> | <dynamic_character> | <character_type> | <anchor> | <match_point_reset> | <literal> <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Regex; use Hoa\Exception as HoaException; /** * Class \Hoa\Regex\Exception. * * Extending the \Hoa\Exception\Exception class. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Exception extends HoaException { } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Regex\Visitor; use Hoa\Math; use Hoa\Regex; use Hoa\Ustring; use Hoa\Visitor; /** * Class \Hoa\Regex\Visitor\Isotropic. * * Isotropic walk on the AST to generate a data. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Isotropic implements Visitor\Visit { /** * Numeric-sampler. * * @var \Hoa\Math\Sampler */ protected $_sampler = null; /** * Initialize numeric-sampler. * * @param \Hoa\Math\Sampler $sampler Numeric-sampler. */ public function __construct(Math\Sampler $sampler) { $this->_sampler = $sampler; return; } /** * Visit an element. * * @param \Hoa\Visitor\Element $element Element to visit. * @param mixed &$handle Handle (reference). * @param mixed $eldnah Handle (not reference). * @return mixed * @throws \Hoa\Regex\Exception */ public function visit(Visitor\Element $element, &$handle = null, $eldnah = null) { switch ($element->getId()) { case '#expression': case '#capturing': case '#noncapturing': case '#namedcapturing': return $element->getChild(0)->accept($this, $handle, $eldnah); case '#alternation': case '#class': return $element->getChild($this->_sampler->getInteger(0, $element->getChildrenNumber() - 1))->accept($this, $handle, $eldnah); case '#concatenation': $out = null; foreach ($element->getChildren() as $child) { $out .= $child->accept($this, $handle, $eldnah); } return $out; case '#quantification': $out = null; $xy = $element->getChild(1)->getValueValue(); $x = 0; $y = 0; switch ($element->getChild(1)->getValueToken()) { case 'zero_or_one': $y = 1; break; case 'zero_or_more': $y = \mt_rand(5, 8); // why not? break; case 'one_or_more': $x = 1; $y = \mt_rand(5, 8); // why not? break; case 'exactly_n': $x = $y = (int) \substr($xy, 1, -1); break; case 'n_to_m': $xy = \explode(',', \substr($xy, 1, -1)); $x = (int) \trim($xy[0]); $y = (int) \trim($xy[1]); break; case 'n_or_more': $xy = \explode(',', \substr($xy, 1, -1)); $x = (int) \trim($xy[0]); $y = \mt_rand($x + 5, $x + 8); // why not? break; } for ($i = 0, $max = $this->_sampler->getInteger($x, $y); $i < $max; ++$i) { $out .= $element->getChild(0)->accept($this, $handle, $eldnah); } return $out; case '#negativeclass': $c = []; foreach ($element->getChildren() as $child) { $c[Ustring::toCode($child->accept($this, $handle, $eldnah))] = \true; } do { // all printable ASCII. $i = $this->_sampler->getInteger(32, 126); } while (isset($c[$i])); return Ustring::fromCode($i); case '#range': $out = null; $left = $element->getChild(0)->accept($this, $handle, $eldnah); $right = $element->getChild(1)->accept($this, $handle, $eldnah); return Ustring::fromCode($this->_sampler->getInteger(Ustring::toCode($left), Ustring::toCode($right))); case 'token': $value = $element->getValueValue(); switch ($element->getValueToken()) { case 'character': $value = \ltrim($value, '\\'); switch ($value) { case 'a': return "\\a"; case 'e': return "\x1b"; case 'f': return "\f"; case 'n': return "\n"; case 'r': return "\r"; case 't': return "\t"; default: return Ustring::fromCode(\intval(\substr($value, 1))); } break; case 'dynamic_character': $value = \ltrim($value, '\\'); switch ($value[0]) { case 'x': $value = \trim($value, 'x{}'); return Ustring::fromCode(\hexdec($value)); default: return Ustring::fromCode(\octdec($value)); } break; case 'character_type': $value = \ltrim($value, '\\'); if ('s' === $value) { $value = $this->_sampler->getInteger(0, 1) ? 'h' : 'v'; } switch ($value) { case 'C': return $this->_sampler->getInteger(0, 127); case 'd': return $this->_sampler->getInteger(0, 9); case 'h': $h = [Ustring::fromCode(0x9), Ustring::fromCode(0x20), Ustring::fromCode(0xa0)]; return $h[$this->_sampler->getInteger(0, \count($h) - 1)]; case 'v': $v = [Ustring::fromCode(0xa), Ustring::fromCode(0xb), Ustring::fromCode(0xc), Ustring::fromCode(0xd)]; return $v[$this->_sampler->getInteger(0, \count($v) - 1)]; case 'w': $w = \array_merge(\range(0x41, 0x5a), \range(0x61, 0x7a), [0x5f]); return Ustring::fromCode($w[$this->_sampler->getInteger(0, \count($w) - 1)]); default: return '?'; } break; case 'literal': if ('.' === $value) { $w = \array_merge(\range(0x41, 0x5a), \range(0x61, 0x7a), [0x5f]); return Ustring::fromCode($w[$this->_sampler->getInteger(0, \count($w) - 1)]); } return \str_replace('\\\\', '\\', \preg_replace('#\\\\(?!\\\\)#', '', $value)); } break; case '#internal_options': break; default: throw new Regex\Exception('Unsupported node: %s.', 0, $element->getId()); } return; } } <?xml version="1.0" encoding="utf-8"?> <overlay xmlns="http://hoa-project.net/xyl/xylophone"> <yield id="chapter"> <p><strong>Compilers</strong> allow to <strong>analyze</strong> and <strong>manipulate textual</strong> data. There is numerous usages. <code>Hoa\Compiler</code> offers to manipulate several compilers based on needs.</p> <h2 id="Table_of_contents">Table of contents</h2> <tableofcontents id="main-toc" /> <h2 id="Introduction" for="main-toc">Introduction</h2> <blockquote cite="https://en.wikipedia.org/wiki/Nicolas_Boileau-Despr%C3%A9aux">What is conceived well is expressed clearly, and the right words come easily.</blockquote> <p>A <strong>language</strong> is a way to express or to <strong>formulate</strong> a <strong>solution</strong> to a <strong>problem</strong>. And there exists a lot of problems. We read and write in several languages daily, and some of these languages are <strong>understood</strong> by <strong>machines</strong>. This operation is possible thanks to <strong>compilers</strong>.</p> <p><a href="https://en.wikipedia.org/wiki/Formal_language">Formal languages</a> is a theory that includes the <strong>automatic analysis</strong> of those languages through tools like <strong>automata</strong> or <strong>grammars</strong>. It is necessary to have a detailed explanation to understand well all these concepts. However, we are going to popularise as much as needed to allow a correct usage of <code>Hoa\Compiler</code>.</p> <h3 id="Language_and_grammar" for="main-toc">Language and grammar</h3> <p>A <strong>language</strong> is a set of <strong>words</strong>. Each word is a <strong>sequence</strong> of <strong>symbols</strong> belonging to an <strong>alphabet</strong>. A symbol represents the smallest <strong>lexical unit</strong> of a language, it is atomic and we will call it a <strong>lexeme</strong> (also often mentionned as a token). These sequences of lexemes representing words are built with <strong>rules</strong>. From a word and a root rule, we will try to <strong>derive</strong> its sub-rules. If a derivation exists, then the word is considered as <strong>valid</strong>, else it is considered as <strong>invalid</strong>. We also speak about words <strong>matching</strong>. For example, if we consider the following rules:</p> <pre><code> exp ::= exp + exp | number number ::= digit number | digit digit ::= 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9</code></pre> <p>The word that we are going to match is <code>7 + 35</code>. The root rule is <code><em>exp</em></code>. If we derive (from the left to the right and from the top to the bottom), we can have <code><em>exp</em> + <em>exp</em></code> or <code><em>number</em></code> (the <strong>disjunction</strong>, i.e. the “or”, is represented by the “<code>|</code>” symbol):</p> <pre><code>exp + exp | number → exp + exp → ( exp + exp | number ) + exp → number + exp → ( digit number | digit ) + exp</code></pre> <p>We continue to derive until we <strong>eliminate</strong> every rules in order to have only <strong>lexemes</strong>:</p> <pre><code>… → ( digit number | digit ) + exp → digit + exp → ( 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 ) + exp → 7 + exp → 7 + ( exp + exp | number ) → 7 + number → 7 + ( digit number | digit ) → 7 + digit number → 7 + ( 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 ) number → 7 + 3 number → 7 + 3 ( digit number | digit ) → 7 + 3 digit → 7 + 3 ( 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 ) → 7 + 3 5</code></pre> <p>A derivation exists to match the word <code>7 + 35</code>, thus it is a valid word for those rules.</p> <p>A set of rules is called a <strong>grammar</strong>. And so, a grammar represents a <strong>language</strong>!</p> <p>However, these are different kinds of grammars. In 1956, the <a href="https://en.wikipedia.org/wiki/Chomsky_hierarchy">Chomsky hierarchy</a> has been formulated, classifying grammars in four <strong>levels</strong>:</p> <ol> <li><strong>unrestricted</strong> grammars, matching langages known as Turing languages, rules have no restriction,</li> <li><strong>context-sensitive</strong> grammars, matching contextual languages,</li> <li><strong>context-free</strong> grammars, matching algebraic languages, based on stacked automata,</li> <li><strong>regular</strong> grammars, matching regular languages.</li> </ol> <p>Each level includes the next level. <code>Hoa\Compiler</code> only treats languages defined by grammars of level 3 and 4. To give a quick idea, regular grammars can be connected to <a href="https://en.wikipedia.org/wiki/Regular_expression">regular expressions</a> (like <a href="http://pcre.org/">PCRE</a>), well-known by developers. But regular grammars are not able to match a <strong>pair of symbols</strong> (like parentheses, braces or quotes), while algebraic languages allow that (thanks to the concept of stack of lexemes).</p> <h3 id="Matching_words" for="main-toc">Matching words</h3> <div id="parsers" class="schema"></div> <script> Hoa.Document.onReady(function ( ) { var paper = Hoa.Graph(Hoa.$('#parsers'), 800, 180); var grid = paper.grid(0, 0, 800, 180, 5, 2); var word = grid.push(paper.rect(0, 0, 140, 80, 3, 'word'), 0, 0); var sequence = grid.push(paper.rect(0, 0, 140, 80, 3, 'sequence'), 2, 0); var trace = grid.push(paper.rect(0, 0, 140, 80, 3, 'result'), 4, 0); grid.push(paper.rect(0, 0, 140, 50, 3, 'abcdef'), 0, 1); grid.push(paper.rect(0, 0, 380, 50, 3, '[[a ⟼ …], [bc ⟼ …], [d ⟼ …], [ef ⟼ …]]'), 2, 1); grid.push(paper.rect(0, 0, 140, 50, 3, 'valid/invalid'), 4, 1); paper.link.between(word, sequence, 'lexical analyzer'); paper.link.between(sequence, trace, 'syntactic analyzer'); }); </script> <p>In general, the compilation process begins with two <strong>analyzes</strong>: <strong>lexical</strong> and <strong>syntactic</strong>. A lexical analysis <strong>splits</strong> a word in a <strong>sequence of lexemes</strong>. This sequence will thereafter be used by the syntactic analyzer in order to verify that the word <strong>belongs</strong> to the language.</p> <p>According to the grammar, the matching will not be done in the same way, but the principle stays the same: using lexemes one after the other in the sequence and verify that they allow <strong>going forward</strong> in the <strong>derivation</strong> of grammar's rules.</p> <p>Syntactic analyzes are also classified into categories: LL, LR, LALR etc. <code>Hoa\Compiler</code> only offers LL syntactic analyzers, stands for Left-to-right Leftmost derivation, i.e. from the topest rule to the deepest, and rules are derived from the left to the right. Here, again, there is sub-categories, whose two supported by <code>Hoa\Compiler</code>: LL(1) and LL(*). Globally, we speak about LL(<em>k</em>) syntactic analyzer: if a lexeme does not allow to derive a rule as expected, then the analyzer is allowed to <strong>go back</strong> to <em>k</em> step backward; we also speak about backtrack. Put another way, rules can be <strong>ambiguous</strong>: each time we derive a rule of the grammar, we have several possible choices and the analyzer can be wrong, this is why it needs to backtrack sometimes. The <em>k</em> variable defines the ambiguity <strong>level</strong>. If a grammar can be analyzed by a LL(1) syntactic analyzer, it is known as <strong>unambiguous</strong>: each time a lexeme is used to derive our rules, there is only one choice. And if we have a LL(*) syntactic analyzer, it means that the <em>k</em> variable is <strong>undefined</strong>. The following example illustrates an unambiguous grammar:</p> <pre><code>rule ::= a b c | d e f</code></pre> <p>And this example illustrates an ambiguous grammar:</p> <pre><code>rule1 ::= a rule2 rule2 ::= b rule3 | b rule4 rule3 ::= c d rule4 ::= e f</code></pre> <p>Let's see what happens when trying to find a derivation for the word <code>abef</code> from the root rule <code>rule1</code>:</p> <pre><code>rule1 → a rule2 <em> a bef ✔</em> → a (b rule3 | b rule4) <em> a bef</em> → a b rule3 <em> ab ef ✔</em> → a b c d <em> abe f ✖</em> ← a b rule3 <em> ab ef ✖</em> ← a (b rule3 | b rule4) <em> a bef</em> → a b rule4 <em> ab ef ✔</em> → a b e f <em>abef ✔</em></code></pre> <p>The <code>rule2</code> rule is ambiguous, which can lead to a bad derivation and consequently a backtrack.</p> <h2 id="LLk_compiler-compiler" for="main-toc">LL(<em>k</em>) compiler-compiler</h2> <p>Writing compilers is a <strong>laborious</strong> task. It is not always difficult but most of the time, it is repetitive and it takes time. This is why there exists <strong>compilers of compilers</strong>, or in other words, compilers generators. Most of the time, these compiler-compilers use an <strong>intermediary</strong> language to write a grammar. The <code>Hoa\Compiler</code> library provides the <code>Hoa\Compiler\Llk\Llk</code> class that allows the writing of compiler-compilers through a <strong>dedicated</strong> language.</p> <h3 id="PP_language" for="main-toc">PP language</h3> <p>The PP language, standing for <em>PHP Parser</em>, allows to express <strong>algebraic grammars</strong>. It is written in files having the <code>.pp</code> extension (please, see the <a href="@central_resource:path=Library/Compiler/.Mime"><code>hoa://Library/Compiler/.Mime</code></a> file).</p> <p>A grammar is composed of <strong>lexemes</strong> and <strong>rules</strong>. The declaration of a lexeme has the following syntax: <code>%token <em>namespace_in</em>:<em>name</em> <em>value</em> -> <em>namespace_out</em></code>, where <code><em>name</em></code> represents the <strong>name</strong> of the lexeme, <code><em>value</em></code> represents its <strong>value</strong>, expressed with the <a href="http://pcre.org/">PCRE</a> format (take care to not match an empty value, in which case an exception will be thrown), and <code><em>namespace_in</em></code> and <code><em>namespace_out</em></code> represent the names of <strong>namespaces</strong> and are optional (the default name is <code>default</code>). For example <code>number</code> describing a number composed of digits from <code>0</code> to <code>9</code>:</p> <pre><code class="language-pp">%token number \d+</code></pre> <p>Namespaces represent disjointed <strong>subsets</strong> of lexemes, used to <strong>ease</strong> analyzes. A <code>%skip</code> declaration is similar to <code>%token</code> excepts that it represents a lexeme to <strong>skip</strong>, it means to not consider. A common example of <code>%skip</code> lexemes are spaces:</p> <pre><code class="language-pp">%skip space \s</code></pre> <p>To explain rules, we will use the <code>Json.pp</code> grammar as an example, which is a softly <strong>simplified</strong> version of the <a href="http://json.org/">JSON language</a> (please, see the <a href="https://tools.ietf.org/html/rfc4627">RFC4627</a>). The <strong>complete</strong> grammar is located in the <a href="@central_resource:path=Library/Json/Grammar.pp"><code>hoa://Library/Json/Grammar.pp</code></a> file. Thus:</p> <pre><code class="language-pp">%skip space \s // Scalars. %token true true %token false false %token null null // Strings. %token quote_ " -> string %token string:string [^"]+ %token string:_quote " -> default // Objects. %token brace_ { %token _brace } // Arrays. %token bracket_ \[ %token _bracket \] // Rest. %token colon : %token comma , %token number \d+ value: &lt;true> | &lt;false> | &lt;null> | string() | object() | array() | number() string: ::quote_:: &lt;string> ::_quote:: number: &lt;number> #object: ::brace_:: pair() ( ::comma:: pair() )* ::_brace:: #pair: string() ::colon:: value() #array: ::bracket_:: value() ( ::comma:: value() )* ::_bracket::</code></pre> <p>Notice that we have two namespaces of lexemes: <code>default</code> and <code>string</code> (it allows to avoid <strong>confusion</strong> with the <code>quote_</code> and <code>string::_quote</code> lexemes that have the same representation). We also notice the <code>value</code> rule, which is a <strong>disjunction</strong> of several lexemes and rules. The <strong>constructions</strong> of the PP language are the following:</p> <ul> <li><code><em>rule</em>()</code> to <strong>call</strong> a rule,</li> <li><code>&lt;<em>token</em>></code> and <code>::<em>token</em>::</code> to <strong>declare</strong> a lexeme (namespaces do not appear here),</li> <li><code>|</code> for a <strong>disjunction</strong> (a choice),</li> <li><code>(<em>…</em>)</code> for a group,</li> <li><code><em>e</em>?</code> to say that <code><em>e</em></code> is <strong>optional</strong>,</li> <li><code><em>e</em>+</code> to say that <code><em>e</em></code> can be present <strong>1 or more</strong> times,</li> <li><code><em>e</em>*</code> to say that <code><em>e</em></code> can be present <strong>0 or more</strong> times,</li> <li><code><em>e</em>{<em>x</em>,<em>y</em>}</code> to say that <code><em>e</em></code> can be present between <code><em>x</em></code> and <code><em>y</em></code> times,</li> <li><code>#<em>node</em></code> to create a <strong>node</strong> <code>node</code> in the resulting tree,</li> <li><code><em>token</em>[<em>i</em>]</code> to <strong>unify</strong> lexemes between each others.</li> </ul> <p>Few constructions but largely enough.</p> <p>Finally, the grammar of the PP language is written… with the PP language! You can find it in the <a href="@central_resource:path=Library/Compiler/Llk/Llk.pp"><code>hoa://Library/Compiler/Llk/Llk.pp</code></a> file.</p> <h3 id="Compilation_process" for="main-toc">Compilation process</h3> <div id="overview" class="schema"></div> <script> Hoa.Document.onReady(function ( ) { var paper = Hoa.Graph(Hoa.$('#overview'), 800, 360); var flow = paper.grid(0, 0, 800, 360, 1, 4); flow.push(paper.rect(0, 0, 200, 70, 3, 'lexical analyzer')); flow.push(paper.rect(0, 0, 200, 70, 3, 'syntactic analyzer')); flow.push(paper.rect(0, 0, 200, 70, 3, 'trace')); flow.push(paper.rect(0, 0, 200, 70, 3, 'AST')); var annot = paper.grid(180, 0, 80, 360, 1, 4); annot.push(paper.rect(0, 0, 45, 45, 22.5, '1')); annot.push(paper.rect(0, 0, 45, 45, 22.5, '2')); annot.push(paper.rect(0, 0, 45, 45, 22.5, '3')); annot.push(paper.rect(0, 0, 45, 45, 22.5, '4')); }); </script> <p>The compilation process used by <code>Hoa\Compiler\Llk\Llk</code> is classical: it starts by <strong>lexically</strong> analyzing the textual data, the word, i.e. to transform our data in a sequence of lexemes. The declaration <strong>order</strong> of the lexemes is primordial because the lexical analyzer will use them one after the other. Next, the <strong>syntactic</strong> analyzer comes into play in order to <strong>match</strong> our data.</p> <p>If the syntactic analysis is successful, we obtain a <strong>trace</strong>. This trace can be transformed into an AST, stands for Abstract Syntax Tree. This tree represents our textual data after the analysis. One advantage is that it can visited (we will detail this part later), which allows us to add new <strong>constraints</strong> which can be not be expressed in the grammar, such as type verification.</p> <p>Let's manipulate <code>Hoa\Compiler\Llk\Llk</code> a little bit. This class is a <strong>helper</strong> to easily read a grammar expressed with the PP format. This class takes only one argument, which is an input stream that points to the grammar and returns a <code>Hoa\Compiler\Llk\Parser</code> compiler ready to use. On this compiler, we will call the <code>Hoa\Compiler\Llk\Parser::parse</code> to analyze a JSON data. If the data is correct, we will get an AST, otherwise an exception will be thrown. Finally, we will use the <code>Hoa\Compiler\Visitor\Dump</code> visitor to print our AST:</p> <pre><code class="language-php">// 1. Load grammar. $compiler = Hoa\Compiler\Llk\Llk::load(new Hoa\File\Read('Json.pp')); // 2. Parse a data. $ast = $compiler->parse('{"foo": true, "bar": [null, 42]}'); // 3. Dump the AST. $dump = new Hoa\Compiler\Visitor\Dump(); echo $dump->visit($ast); /** * Will output: * > #object * > > #pair * > > > token(string:string, foo) * > > > token(true, true) * > > #pair * > > > token(string:string, bar) * > > > #array * > > > > token(null, null) * > > > > token(number, 42) */</code></pre> <p>When we write and test a grammar, we will repeat these three tasks very <strong>often</strong>. This is why the <code>hoa</code> script provides the <code>compiler:pp</code> command. This command proposes to analyze a data based on a grammar and to apply a visitor if needed on the resulting AST. Notice that the grammar can be read through a <a href="https://en.wikipedia.org/wiki/Pipeline_(Unix)">pipe</a>:</p> <pre><code class="language-shell">$ echo '[1, [1, [2, 3], 5], 8]' | hoa compiler:pp Json.pp 0 --visitor dump > #array > > token(number, 1) > > #array > > > token(number, 1) > > > #array > > > > token(number, 2) > > > > token(number, 3) > > > token(number, 5) > > token(number, 8)</code></pre> <p>This is a useful way to <strong>quickly</strong> test a data against a grammar. Do not hesitate to read the help of the <code>compiler:pp</code> command to get more details!</p> <p>The analyzes start with the <strong>root</strong> rule but we can use <strong>another rule</strong> thanks to the second argument of the <code>Hoa\Compiler\Llk\Parser::parse</code> method:</p> <pre><code class="language-php">$compiler->parse('{"foo": true, "bar": [null, 42]}', 'object');</code></pre> <p>To use the root rule, we have to use <code>null</code>.</p> <p>And finally, to not generate the AST but only know if a data is valid or not, we can use the last argument of this method by using <code>false</code>:</p> <pre><code class="language-php">$valid = $compiler->parse('{"foo": true, "bar": [null, 42]}', null, false); var_dump($valid); /** * Will output: * bool(true) */</code></pre> <h4 id="Errors" for="main-toc">Errors</h4> <p>The compilation errors are represented by exceptions, thus:</p> <pre><code class="language-shell">$ echo '{"foo" true}' | hoa compiler:pp Json.pp 0 --visitor dump Uncaught exception (Hoa\Compiler\Exception\UnexpectedToken): Hoa\Compiler\Llk\Parser::parse(): (0) Unexpected token "true" (true) at line 1 and column 8: {"foo" true} ↑ in hoa://Library/Compiler/Llk/Parser.php at line 1</code></pre> <p>Several exceptions can be thrown according to the context:</p> <ul> <li>during the <strong>lexical</strong> analysis, <code>Hoa\Compiler\Exception\UnrecognizedToken</code> when a lexeme is not recognized, i.e. when the textual data can not be split into a sequence of lexemes, and <code>Hoa\Compiler\Exception\Lexer</code> when other more general errors happen, for example if a lexeme matches an empty value,</li> <li>during the <strong>syntactic</strong> analysis, <code>Hoa\Compiler\Exception\UnexpectedToken</code> when a lexeme is not expected, i.e. it is not able to derive the rules of the grammar.</li> </ul> <p>The parent exception is <code>Hoa\Compiler\Exception\Exception</code>.</p> <h4 id="Nodes" for="main-toc">Nodes</h4> <p>The compilation process very often succeeds by the <strong>production</strong> of an AST. It is important to control its <strong>form</strong>, its <strong>size</strong>, the data it <strong>holds</strong> etc. This is why it is necessary to understand the <code>#<em>node</em></code> notation because it allows to create <strong>nodes</strong> in the AST. First, lexemes declared with the <code>&lt;<em>token</em>></code> syntax will appear in the tree, while the other lexemes, declared with the <code>::<em>token</em>::</code> syntax, will not appear. Indeed, in our last example, the <code>quote_</code>, <code>brace_</code>, <code>colon</code>, <code>comma</code> etc. lexemes do not appear. Next, it is important to notice that the declaration of nodes can be <strong>overwritten</strong> inside a <strong>same rule</strong>. Finally, a rule name can be preceeded by <code>#</code>, just like the <code>#array</code> rule, that allows to define a <strong>default</strong> node, but it can be overwritten. For example, if we replace the <code>array</code> rule by:</p> <pre><code class="language-pp">#array: ::bracket_:: value() ( ::comma:: value() #bigarray )* ::_bracket::</code></pre> <p>If the array contains only one value, the node will be named <code>#array</code>, else it will be named <code>#bigarray</code>. Let's see:</p> <pre><code class="language-shell">$ echo '[42]' | hoa compiler:pp Json.pp 0 --visitor dump > #array > > token(number, 42) $ echo '[4, 2]' | hoa compiler:pp Json.pp 0 --visitor dump > #bigarray > > token(number, 4) > > token(number, 2)</code></pre> <p>Of course, a node can be created or not based on the <strong>derivation</strong> of a rule. The mecanism is normally pretty much <strong>intuitive</strong>.</p> <h4 id="Namespaces" for="main-toc">Namespaces</h4> <p>Let's detail a little bit the behavior of the lexical analyzer regarding the <strong>namespaces</strong>.</p> <p><strong>Lexemes</strong> are put in namespaces, it means that only the lexemes of the <strong>current</strong> namespace are used by the lexical analyzer. The default namespace is <code>default</code>. To declare the namespace of a lexeme, we have to use the <code>:</code> operator. When a lexeme is consumed, it is able to <strong>change</strong> the current namespace for the rest of the lexical analysis, thanks to the <code>-></code> operator. Thus, we will declare five lexemes: <code>foo</code> and <code>bar</code> in the <code>default</code> namespace, <code>baz</code> in <code>ns1</code> and <code>qux</code> and <code>foo</code> in <code>ns2</code>. The fact that <code>foo</code> is declared two times is not embarrassing because it is put in <strong>different</strong> namespaces:</p> <pre><code class="language-pp">%token foo fo+ -> ns1 %token bar ba?r+ -> ns2 %token ns1:baz ba?z+ -> default %token ns2:qux qux+ %token ns2:foo FOO -> ns1</code></pre> <p>Writing <code>default:bar</code> is strictly equivalent to <code>bar</code>. The <code>foo</code> lexeme leads into <code>ns1</code>, <code>bar</code> into <code>ns2</code>, <code>ns1:baz</code> into <code>default</code>, <code>ns2:qux</code> stays in <code>ns2</code> and <code>ns2:foo</code> leads into <code>ns1</code>. Let's observe the sequence of lexemes produced by the lexical analyzer with the following data <code>fooooobzzbarrrquxFOObaz</code>:</p> <pre><code class="language-php">$pp = '%token foo fo+ -> ns1' . "\n" . '%token bar ba?r+ -> ns2' . "\n" . '%token ns1:baz ba?z+ -> default' . "\n" . '%token ns2:qux qux+' . "\n" . '%token ns2:foo FOO -> ns1'; // 1. Parse PP. Hoa\Compiler\Llk\Llk::parsePP($pp, $tokens, $rawRules); // 2. Run the lexical analyzer. $lexer = new Hoa\Compiler\Llk\Lexer(); $sequence = $lexer->lexMe('fooooobzzbarrrquxFOObaz', $tokens); // 3. Pretty-print the result. $format = '%' . (strlen((string) count($sequence)) + 1) . 's ' . '%-13s %-20s %-20s %6s' . "\n"; $header = sprintf($format, '#', 'namespace', 'token name', 'token value', 'offset'); echo $header, str_repeat('-', strlen($header)), "\n"; foreach ($sequence as $i => $token) { printf( $format, $i, $token['namespace'], $token['token'], $token['value'], $token['offset'] ); } /** * Will output: * # namespace token name token value offset * --------------------------------------------------------------------- * 0 default foo fooooo 0 * 1 ns1 baz bzz 6 * 2 default bar barrr 9 * 3 ns2 qux qux 14 * 4 ns2 foo FOO 17 * 5 ns1 baz baz 20 * 6 default EOF EOF 23 */</code></pre> <p>We read the lexemes, their namespace and their default value in the table. The data has been successfully <strong>splitted</strong>, and we have jumped from one namespace to the other. If this time we try with the <code>foqux</code> data, we will have an error: <code>fo</code> is matched by the <code>foo</code> lexeme in the <code>default</code> namespace, we then jump to the <code>ns1</code> namespace, and here, no lexeme in this namespace is able to recognize at least <code>q</code>. An error is thrown.</p> <p>So far, we have seen how to jump from one namespace to another with the <code>-></code> operator. No <strong>history</strong> about the used namespaces is stored. However, in some rare cases, it is able for a lexeme to be accessible through <strong>several</strong> namespaces and we would like that a lexeme jumps back to the <strong>previous</strong> namespace. Put another way, we would like a history of the used namespaces and being able to navigate (backward only) in it. This is the role of the <code>__shift__ * <em>n</em></code> keyword, in conjunction with the <code>-></code> operator as usual. <code>__shift__</code> is equivalent to say: jump back to the previous namespace. <code>__shift__</code> is equivalent to <code>__shift__ * 1</code>, and <code>__shift__ * <em>n</em></code> to say: jump back <code><em>n</em></code> times to the previous namespace.</p> <p>When the <code>__shift__</code> keyword appears in the grammar, namespaces are managed like a <strong>stack</strong>, hence the <em>shift</em> vocabulary. We have to take care to shift namespaces regularly in order to avoid a huge stack.</p> <p>Let's take the example of the following grammar:</p> <pre><code class="language-pp">%token foo1 a -> ns1 %token foo2 x -> ns2 %token end e %token ns1:bar b %token ns1:baz c -> ns3 %token ns1:tada t -> __shift__ %token ns2:bar y %token ns2:baz z -> ns3 %token ns2:tada T -> __shift__ %token ns3:qux = -> __shift__ #test: ( &lt;foo1> | &lt;foo2> ) &lt;bar> &lt;baz> &lt;qux> &lt;tada> &lt;end></code></pre> <p>This grammar recognizes two data: <code>abc=te</code> and <code>xyz=Te</code>. If the first lexeme <code>foo1</code> is matched, the syntactic analyzer will jump to the <code>ns1</code> namespace. When it will match the <code>ns1:baz</code> namespace, it will jump into <code>ns3</code>. Then, when it will match <code>ns3:qux</code>, it will jump back to the previous namespace, being <code>ns1</code>. And so on. Now, if it does not match <code>foo1</code> but <code>foo2</code>, it will jump to the <code>ns2</code> namespace, and then in <code>ns3</code> and then in <code>ns2</code> again. The <code>__shift__</code> keywords in <code>ns1:tada</code> and <code>ns2:tada</code> are only used to shift namespaces but no ambiguity exists: these namespaces are accessible by only one namespace, namely <code>default</code>.</p> <p>Now, let's save this grammar in the <code>NamespaceStack.pp</code> file and use the <code>-s/--token-sequence</code> option of the <code>hoa compiler:pp</code> command:</p> <pre><code class="language-shell">$ echo -n 'abc=te' | hoa compiler:pp NamespaceStack.pp 0 --token-sequence # namespace token name token value offset ------------------------------------------------------------------------------- 0 default foo1 a 0 1 ns1 bar b 1 2 ns1 baz c 2 3 ns3 qux = 3 4 ns1 tada t 4 5 default end e 5 6 default EOF EOF 6 $ echo -n 'xyz=Te' | hoa compiler:pp NamespaceStack.pp 0 --token-sequence # namespace token name token value offset ------------------------------------------------------------------------------- 0 default foo2 x 0 1 ns2 bar y 1 2 ns2 baz z 2 3 ns3 qux = 3 4 ns2 tada T 4 5 default end e 5 6 default EOF EOF 6</code></pre> <p>We see that the lexical analyzer has successfully jumped between all namespaces, as expected. We had two ways to access to the <code>ns3</code> namespace: either from <code>ns1</code> or from <code>ns2</code>. The analyzer has succeeded to create a history of namespaces and navigate in it.</p> <h4 id="Unification" for="main-toc">Unification</h4> <p>A new feature brought by the PP language regarding other grammar languages is the capability to express a <strong>unification</strong> of lexemes. Let's imagine the following grammar:</p> <pre><code class="language-pp">%token quote '|" %token string \w+ rule: ::quote:: &lt;string> ::quote::</code></pre> <p>The quotes surrounding the string can be of two kinds: simple, with the “<code>'</code>” symbol, or double, with the “<code>"</code>” symbol. Thus, the <code>"foo"</code> and <code>'foo'</code> data are valid, but <strong>also</strong> <code>"foo'</code> and <code>'foo"</code>!</p> <p>The unification of lexemes allows to add an additionnal <strong>constraint</strong> on the <strong>value</strong> of lexemes at runtime. The syntax is the following: <code><em>token</em>[<em>i</em>]</code>. The value of <code><em>i</em></code> indicates what lexemes will have the same value. And finally, the unification is <strong>locale</strong> to an instance of a rule, it means that there is no unification between lexemes of different rules and the unification is only applied on the <strong>current</strong> rule. Thus, the example becomes:</p> <pre><code class="language-pp">rule: ::quote[0]:: &lt;string> ::quote[0]::</code></pre> <p>Which invalidates the <code>"foo'</code> and <code>'foo"</code> data.</p> <p>Unification finds numerous applications, such as the name of opening and closing tags in the <a href="http://w3.org/TR/xml11/">XML language</a>.</p> <h3 id="Abstract_Syntax_Tree" for="main-toc">Abstract Syntax Tree</h3> <div id="overview_ast" class="schema"></div> <script> Hoa.Document.onReady(function ( ) { var paper = Hoa.Graph(Hoa.$('#overview_ast'), 800, 360); var flow = paper.grid(0, 0, 800, 360, 1, 4); flow.push(paper.rect(0, 0, 200, 70, 3, 'lexical analyzer').attr({opacity: .3})); flow.push(paper.rect(0, 0, 200, 70, 3, 'syntactic analyzer').attr({opacity: .3})); flow.push(paper.rect(0, 0, 200, 70, 3, 'trace').attr({opacity: .3})); flow.push(paper.rect(0, 0, 200, 70, 3, 'AST')); var annot = paper.grid(180, 0, 80, 360, 1, 4); annot.push(paper.rect(0, 0, 45, 45, 22.5, '1').attr({opacity: .3})); annot.push(paper.rect(0, 0, 45, 45, 22.5, '2').attr({opacity: .3})); annot.push(paper.rect(0, 0, 45, 45, 22.5, '3').attr({opacity: .3})); annot.push(paper.rect(0, 0, 45, 45, 22.5, '4')); }); </script> <p>An <strong>abstract syntax</strong> tree represents a textual data in a <strong>structural</strong> form. Each <strong>node</strong> of this tree is represented by the <code>Hoa\Compiler\Llk\TreeNode</code> class. Among the most useful methods, we find:</p> <ul> <li><code>getId</code> to get the identifier of the node,</li> <li><code>getValueToken</code> to get the name of the lexeme,</li> <li><code>getValueValue</code> to get the value of the lexeme,</li> <li><code>isToken</code> if the token represents a lexeme,</li> <li><code>getChild(<em>$i</em>)</code> to get the <code><em>$i</em></code>-th child of the node,</li> <li><code>getChildren</code> to get all the children,</li> <li><code>getChildrenNumber</code> to count the number of children,</li> <li><code>getParent</code> to get the parent node,</li> <li><code>getData</code> to get a reference to a data array,</li> <li><code>accept</code> to apply the visitor.</li> </ul> <p>Visitors are the most simple way to <strong>cross</strong> an AST. As an example, let's write the <code>PrettyPrinter</code> visitor which will rewrite a JSON data with our own conventions (spacing, line breaking etc.). A visitor must implement the <code>Hoa\Visitor\Visit</code> interface and will have only one method to implement: <code>visit</code> with three arguments: the element and two optional arguments (by reference and by copy). Let's see:</p> <pre><code class="language-php">class PrettyPrinter implements Hoa\Visitor\Visit { public function visit ( Hoa\Visitor\Element $element, &amp;$handle = null, $eldnah = null ) { static $i = 0; static $indent = ' '; // One behaviour per node in the AST. switch ($element->getId()) { // Object: { … }. case '#object': echo '{', "\n"; ++$i; foreach ($element->getChildren() as $e => $child) { if (0 &lt; $e) { echo ',', "\n"; } echo str_repeat($indent, $i); $child->accept($this, $handle, $eldnah); } echo "\n", str_repeat($indent, --$i), '}'; break; // Array: [ … ]. case '#array': echo '[', "\n"; ++$i; foreach ($element->getChildren() as $e => $child) { if (0 &lt; $e) { echo ',', "\n"; } echo str_repeat($indent, $i); $child->accept($this, $handle, $eldnah); } echo "\n", str_repeat($indent, --$i), ']'; break; // Pair: "…": …. case '#pair': echo $element->getChild(0)->accept($this, $handle, $eldnah), ': ', $element->getChild(1)->accept($this, $handle, $eldnah); break; // Many tokens. case 'token': switch ($element->getValueToken()) { // String: "…". case 'string': echo '"', $element->getValueValue(), '"'; break; // Booleans. case 'true': case 'false': // Null. case 'null': // Number. case 'number': echo $element->getValueValue(); break; } break; } } }</code></pre> <p>We are going to see an example:</p> <pre><code class="language-php">$compiler = Hoa\Compiler\Llk\Llk::load(new Hoa\File\Read('Json.pp')); $ast = $compiler->parse('{"foo": true, "bar": [null, 42]}'); $prettyPrint = new PrettyPrinter(); echo $prettyPrint->visit($ast); /** * Will output: * { * "foo": true, * "bar": [ * null, * 42 * ] * } */</code></pre> <p>The <code>getData</code> method is very useful to <strong>store</strong> data that are likely to be <strong>reused</strong>, for example from one visitor to another. This method returns a <strong>reference</strong> to an array; thus:</p> <pre><code class="language-php">$data = $element->getData(); if (!isset($data['previousComputing'])) { throw new Exception('Need a previous computing.', 0); } $previous = $data['previousComputing'];</code></pre> <p>It is common to use one visitor per <strong>constraint</strong>: verification of symbols, verification of types etc. Some of them can set data for the next ones. The <code>getData</code> method does not require any data structure, it only provides an access to an array. Feel free to do what you want with it.</p> <p>Using the <code>Hoa\Compiler\Llk\TreeNode</code> is very <strong>trivial</strong> and we will use it most of the time with a visitor.</p> <h3 id="Traces" for="main-toc">Traces</h3> <div id="overview_trace" class="schema"></div> <script> Hoa.Document.onReady(function ( ) { var paper = Hoa.Graph(Hoa.$('#overview_trace'), 800, 360); var flow = paper.grid(0, 0, 800, 360, 1, 4); flow.push(paper.rect(0, 0, 200, 70, 3, 'lexical analyzer').attr({opacity: .3})); flow.push(paper.rect(0, 0, 200, 70, 3, 'syntactic analyzer').attr({opacity: .3})); flow.push(paper.rect(0, 0, 200, 70, 3, 'trace')); flow.push(paper.rect(0, 0, 200, 70, 3, 'AST').attr({opacity: .3})); var annot = paper.grid(180, 0, 80, 360, 1, 4); annot.push(paper.rect(0, 0, 45, 45, 22.5, '1').attr({opacity: .3})); annot.push(paper.rect(0, 0, 45, 45, 22.5, '2').attr({opacity: .3})); annot.push(paper.rect(0, 0, 45, 45, 22.5, '3')); annot.push(paper.rect(0, 0, 45, 45, 22.5, '4').attr({opacity: .3})); }); </script> <p>The LL(<em>k</em>) compiler provided by Hoa is clearly composed of <strong>layers</strong>. Each layer can be used with a maximal modularity and extensibility. When the grammar is translated into “machine rules” and that the lexical and syntactic analyzers have validated a data, a <strong>trace</strong> is computed. This trace is a flat array containing only three kind of classes:</p> <ul> <li><code>Hoa\Compiler\Llk\Rule\Entry</code> when the syntactic analyzer has opened a rule,</li> <li><code>Hoa\Compiler\Llk\Rule\Ekzit</code> when the syntactic analyzer has closed a rule,</li> <li><code>Hoa\Compiler\Llk\Rule\Token</code> when the syntactic analyzer has encountered a lexeme.</li> </ul> <p>We can get the trace with the <code>Hoa\Compiler\Llk\Parser::getTrace</code> method. To understand this trace, we will start with an example:</p> <pre><code class="language-php">$compiler = Hoa\Compiler\Llk\Llk::load(new Hoa\File\Read('Json.pp')); $ast = $compiler->parse('{"foo": true, "bar": [null, 42]}'); $i = 0; foreach ($compiler->getTrace() as $element) { if ($element instanceof Hoa\Compiler\Llk\Rule\Entry) { echo str_repeat('> ', ++$i), 'enter ', $element->getRule(), "\n"; } elseif ($element instanceof Hoa\Compiler\Llk\Rule\Token) { echo str_repeat(' ', $i + 1), 'token ', $element->getTokenName(), ', consumed ', $element->getValue(), "\n"; } else { echo str_repeat('&lt; ', $i--), 'ekzit ', $element->getRule(), "\n"; } } /** * Will output: * > enter value * > > enter object * token brace_, consumed { * > > > enter pair * > > > > enter string * token quote_, consumed " * token string, consumed foo * token _quote, consumed " * &lt; &lt; &lt; &lt; ekzit string * token colon, consumed : * > > > > enter value * token true, consumed true * &lt; &lt; &lt; &lt; ekzit value * &lt; &lt; &lt; ekzit pair * > > > enter 13 * > > > > enter 12 * token comma, consumed , * > > > > > enter pair * > > > > > > enter string * token quote_, consumed " * token string, consumed bar * token _quote, consumed " * &lt; &lt; &lt; &lt; &lt; &lt; ekzit string * token colon, consumed : * > > > > > > enter value * > > > > > > > enter array * token bracket_, consumed [ * > > > > > > > > enter value * token null, consumed null * &lt; &lt; &lt; &lt; &lt; &lt; &lt; &lt; ekzit value * > > > > > > > > enter 21 * > > > > > > > > > enter 20 * token comma, consumed , * > > > > > > > > > > enter value * token number, consumed 42 * &lt; &lt; &lt; &lt; &lt; &lt; &lt; &lt; &lt; &lt; ekzit value * &lt; &lt; &lt; &lt; &lt; &lt; &lt; &lt; &lt; ekzit 20 * &lt; &lt; &lt; &lt; &lt; &lt; &lt; &lt; ekzit 21 * token _bracket, consumed ] * &lt; &lt; &lt; &lt; &lt; &lt; &lt; ekzit array * &lt; &lt; &lt; &lt; &lt; &lt; ekzit value * &lt; &lt; &lt; &lt; &lt; ekzit pair * &lt; &lt; &lt; &lt; ekzit 12 * &lt; &lt; &lt; ekzit 13 * token _brace, consumed } * &lt; &lt; ekzit object * &lt; ekzit value */</code></pre> <p>This example reveals several things. First, the informations given by the trace can be useful: if we are on a rule, we have its <strong>name</strong> (with the <code>getRule</code> method), and if we are on a lexeme, we have its <strong>name</strong> (with the <code>getTokenName</code> method), its <strong>representation</strong> (expressed in the PCRE format, with the <code>getRepresentation</code> method), its <strong>value</strong> (with the <code>getValue</code> method), if it is a node to <strong>keep</strong> in the AST (with the <code>isKept</code> method) and its <strong>unification</strong> index if it exists (with the <code>getUnificationIndex</code> method). Of course, all these informations can be edited, which can influence the construction of the AST which is the (optional) next step.</p> <p>Next, we notice that sometimes we enter in a rule that exists in the grammar, like <code>object</code>, <code>pair</code>, <code>value</code> etc., and sometimes we enter in a <strong>numerical</strong> rule, like <code>13</code>, <code>12</code>, <code>21</code>, <code>20</code> etc. When the grammar is interpreted in order to be translated into “machine rules”, each one of these rules is <strong>linearized</strong> regarding the PP operators:</p> <ul> <li><code>Hoa\Compiler\Llk\Rule\Choice</code> for a disjunction</li> <li><code>Hoa\Compiler\Llk\Rule\Concatenation</code> for a concatenation,</li> <li><code>Hoa\Compiler\Llk\Rule\Repetition</code> for a repetition,</li> <li><code>Hoa\Compiler\Llk\Rule\Token</code> for a token (like seen above).</li> </ul> <p>All these rules in this format are accessible through the <code>Hoa\Compiler\Llk\Parser::getRules</code> methods, represented by an array. We will print all the <strong>accessible</strong> rules from the root for a better understanding:</p> <pre><code class="language-php">$compiler = Hoa\Compiler\Llk\Llk::load(new Hoa\File\Read('Json.pp')); // 1. Get all rules. $rules = $compiler->getRules(); // 2. Start with the root rule. $stack = [$compiler->getRootRule() => true]; while (false !== current($stack)) { $rule = key($stack); next($stack); echo "\n", '"', $rule, '" is a ', strtolower(substr(get_class($rules[$rule]), 22)); $subrules = $rules[$rule]->getContent(); // 3a. Token. if (null === $subrules) { continue; } echo ' of rules: '; // 3b. Other rules. foreach ((array) $rules[$rule]->getContent() as $subrule) { if (!array_key_exists($subrule, $stack)) { // 4. Unshift new rules to print. $stack[$subrule] = true; } echo $subrule, ' '; } } /** * Will output: * "value" is a choice of rules: 1 2 3 string object array number * "1" is a token * "2" is a token * "3" is a token * "string" is a concatenation of rules: 5 6 7 * "object" is a concatenation of rules: 10 pair 13 14 * "array" is a concatenation of rules: 18 value 21 22 * "number" is a token * "5" is a token * "6" is a token * "7" is a token * "10" is a token * "pair" is a concatenation of rules: string 16 value * "13" is a repetition of rules: 12 * "14" is a token * "18" is a token * "21" is a repetition of rules: 20 * "22" is a token * "16" is a token * "12" is a concatenation of rules: 11 pair * "20" is a concatenation of rules: 19 value * "11" is a token * "19" is a token */</code></pre> <p>If we read the <code>object</code> rule, we know that it is a concatenation of the <code>10</code>, <code>pair</code>, <code>13</code> and <code>14</code> rules. <code>10</code> is a lexeme, <code>pair</code> is a concatenation of the <code>string</code>, <code>16</code> and <code>value</code> rules, and so on. The initial grammar is translated in order to be in its <strong>tiniest</strong> form. It allows to <strong>reason</strong> on rules in an <strong>easier</strong> and <strong>faster</strong> way. Indeed, computations on the grammar are not restricted to AST. In the previous step, with the trace, we are already able to apply computations.</p> <h3 id="Generation" for="main-toc">Generation</h3> <p>A grammar can be used to satisfy two goals: to <strong>validate</strong> a data (if we see it as an automata) or to <strong>generate</strong> a data. So far, we have seen how to validate a data through several steps: <strong>initialization</strong> of our compiler, running of the lexical and syntactic <strong>analyzers</strong>, producing a <strong>trace</strong>, transformation of this trace into an <strong>AST</strong> in order to <strong>visit</strong> that tree. But we can stop at the first step, the initialization of our compiler, to exploit the rules in order to generate a data which will be valid regarding our grammar.</p> <p><code>Hoa\Compiler\Llk\Sampler</code> provides three data <strong>generation</strong> algorithms:</p> <ul> <li>random uniform generation,</li> <li>bounded exhaustive generation,</li> <li>grammar coverage-based generation.</li> </ul> <p>Why providing three algorithms? Because it is illusory to think that one algorithm can satisfy <strong>numerous</strong> context of usages. Each one fits different needs, we will explain them later.</p> <p>Generating a data based on a grammar requires <strong>two steps</strong>:</p> <ol> <li>generating values for all <strong>lexemes</strong> in order to get raw data,</li> <li>generating a <strong>path</strong> in the rules of the grammar.</li> </ol> <p>A path is equivalent to a derivation, the vocabulary is different according to our goal: validation or generation.</p> <h4 id="Isotropic_generation_of_lexemes" for="main-toc">Isotropic generation of lexemes</h4> <p>In order to generate values for lexemes, no matter what algorithm is used, it has to be <strong>fast</strong>. We are going to use a process called <strong>isotropic</strong>. We start with a rule and we go forward only by using <strong>random</strong> and <strong>locally uniform</strong> (only for this choice) choices. For instance, if we have a disjunction between three sub-rules, we will randomly and uniformly choose between 1 and 3. If we have a concatenation, we will just concatenate each parts. And finally, a repetition is nothing more than a disjunction of concatenation: indeed, <code><em>e</em>{1,3}</code> is strictly equivalent to <code><em>e</em> | <em>ee</em> | <em>eee</em></code>. Let's see:</p> <pre><code>([ae]+|[x-z]!){1,3} <em>repeat <em>[ae]+|[x-z]!</em> 2 times</em> → ([ae]+|[x-z]!)([ae]+|[x-z]!) <em>choose between <em>[ae]+</em> and <em>[x-z]!</em></em> → ([ae]+)([ae]+|[x-z]!) <em>repeat <code>ae</code> 2 times</em> → [ae][ae]([ae]+|[x-z]!) <em>choose between <em>a</em> and <em>e</em></em> → e[ae]([ae]+|[x-z]!) <em>again</em> → ea([ae]+|[x-z]!) <em>choose between <em>[ae]+</em> and <em>[x-z]!</em></em> → ea([x-z]!) <em>choose between <em>x</em>, <em>y</em> and <em>z</em></em> → eay!</code></pre> <p>This generation is naive but this is not important. What is important is the path generation in rules, or put another way, the generation of <strong>sequences of lexemes</strong>.</p> <h4 id="Uniform_random_generation" for="main-toc">Random uniform generation</h4> <p>The first algorithm is the <strong>random</strong> and <strong>uniform</strong> generation. This algorithm is useful if we would like to generate sequences of lexemes of a <strong>given size <em>n</em></strong> with a <strong>uniformity</strong>, not local (like in the isotropic generation), but on the <strong>set</strong> of all the possible sequences. Succinctly, the algorithm works in two steps: <strong>pre-computation</strong> (once per size) followed by a <strong>generation</strong>. The pre-computation is an <strong>automatic</strong> step and computes the <strong>number</strong> of all the possible sequences and sub-sequences of size <em>n</em>. This step helps to compute <strong>cumulative distribution functions</strong> in order to <strong>guide</strong> the final sequences of lexemes.</p> <p>We will generate 10 random data of size 7, it means composed of 7 lexemes. That's why we will use the <code>Hoa\Compiler\Llk\Sampler\Uniform</code> class that takes our grammar in first argument, the lexeme value generator in second argument (here <code>Hoa\Regex\Visitor\Isotropic</code>) and finally a size:</p> <pre><code class="language-php">$sampler = new Hoa\Compiler\Llk\Sampler\Uniform( // Grammar. Hoa\Compiler\Llk\Llk::load(new Hoa\File\Read('Json.pp')), // Token sampler. new Hoa\Regex\Visitor\Isotropic(new Hoa\Math\Sampler\Random()), // Length. 7 ); for ($i = 0; $i &lt; 10; ++$i) { echo $i, ' => ', $sampler->uniform(), "\n"; } /** * Will output: * 0 => [ false , null , null ] * 1 => [ " l " , null ] * 2 => [ [ true ] , true ] * 3 => [ [ [ 4435 ] ] ] * 4 => [ [ [ 9366 ] ] ] * 5 => [ true , false , null ] * 6 => { " |h&lt;# " : false } * 7 => [ [ [ false ] ] ] * 8 => [ false , true , 7 ] * 9 => [ false , 5 , 79 ] */</code></pre> <p>We can redefine the size with the <code>Hoa\Compiler\Llk\Sampler\Uniform::setLength</code> method. We have noticed that some repetition operators have no upper bound, like <code>+</code> or <code>*</code>; in this case, we set it to <em>n</em>.</p> <h4 id="Bounded_exhaustive_generation" for="main-toc">Bounded exhaustive generation</h4> <p>The second algorithm is the <strong>bounded exhaustive</strong> generation. This algorithm generates <strong>all</strong> sequences of lexemes (for the exhaustive side) from size 1 <strong>to</strong> <em>n</em> (for the bounded side). An interesting aspect of this algorithm is that the exhaustivity is kind of a <strong>proof</strong>! The algorithm behaves like an iterator and is very simple to use:</p> <pre><code class="language-php">$sampler = new Hoa\Compiler\Llk\Sampler\BoundedExhaustive( // Grammar. Hoa\Compiler\Llk\Llk::load(new Hoa\File\Read('Json.pp')), // Token sampler. new Hoa\Regex\Visitor\Isotropic(new Hoa\Math\Sampler\Random()), // Length. 7 ); foreach ($sampler as $i => $data) { echo $i, ' => ', $data, "\n"; } /** * Will output: * 0 => true * 1 => false * 2 => null * 3 => " 8u2 " * 4 => { " ,M@aj{ " : true } * 5 => { " x`|V " : false } * 6 => { " NttB " : null } * 7 => { " eJWwA " : 0 } * 8 => [ true ] * 9 => [ true , true ] * 10 => [ true , true , true ] * 11 => [ true , true , false ] * 12 => [ true , true , null ] * 13 => [ true , true , 32 ] * 14 => [ true , false ] * 15 => [ true , false , true ] * 16 => [ true , false , false ] * 17 => [ true , false , null ] * 18 => [ true , false , 729 ] * 19 => [ true , null ] * 20 => [ true , null , true ] * 21 => [ true , null , false ] * … * 157 => [ 780 , 01559 , 32 ] * 158 => 344 */</code></pre> <p>Like the previous algorithm, we can redefine the upper bound with the <code>Hoa\Compiler\Llk\Sampler\BoundedExhaustive::setLength</code> method. And the repetition operators with no upper bounds are bounded to <em>n</em>.</p> <h4 id="Grammar_coverage-based_generation" for="main-toc">Grammar coverage-based generation</h4> <p>The last algorithm is the <strong>grammar coverage-based</strong> generation. This algorithm reduces the <strong>combinatory explosion</strong> encountered with the previous algorithm but the goal is different: it will generate sequences of lexemes that will “<strong>activate</strong>” all the rules <strong>branches</strong> of the grammar. A rule is said covered if and only if all its sub-rules are covered, and a lexeme is said covered if it has been used in a sequence. To ensure a <strong>diversity</strong> in the produced sequences, choice points between uncovered sub-rules are resolved <strong>randomly</strong>. The algorithm also behaves like an iterator:</p> <pre><code class="language-php">$sampler = new Hoa\Compiler\Llk\Sampler\Coverage( // Grammar. Hoa\Compiler\Llk\Llk::load(new Hoa\File\Read('Json.pp')), // Token sampler. new Hoa\Regex\Visitor\Isotropic(new Hoa\Math\Sampler\Random()) ); foreach ($sampler as $i => $data) { echo $i, ' => ', $data, "\n"; } /** * Will output: * 0 => true * 1 => { " )o?bz " : null , " %3W) " : [ false , 130 , " 6 " ] } * 2 => [ { " ny " : true } ] * 3 => { " Ne;[3 " : [ true , true ] , " th: " : true , " C[8} " : true } */</code></pre> <p>To avoid the combinatory explosion and to ensure the <strong>termination</strong> of the algorithm, we will use the following <strong>heuristic</strong> on the <strong>repetition</strong> operators: <code>*</code> will repeat <code>0</code>, <code>1</code> and <code>2</code> times, <code>+</code> will repeat <code>1</code> and <code>2</code> times, and finally <code>{<em>x</em>,<em>y</em>}</code> will repeat <code><em>x</em></code>, <code><em>x</em> + 1</code>, <code><em>y</em> - 1</code> and <code><em>y</em></code> times. This heuristic finds its origin in the <strong>limit</strong> testing.</p> <p>We notice in our example that 4 data are generated and are enough to <strong>cover</strong> entirely our grammar!</p> <h4 id="Comparison_between_algorithms" for="main-toc">Comparison between algorithms</h4> <p>Here are some <strong>clues</strong> to know when to use one algorithm instead of another.</p> <dl> <dt>Random uniform generation:</dt> <dd><ul> <li data-item="+">fast for small data, high data diversity and fixed size,</li> <li data-item="-">the pre-computation step is exponential and therefore long while, next, the generation is very fast.</li> </ul></dd> <dt>Bounded exhaustive generation:</dt> <dd><ul> <li data-item="+">fast for small data and exhaustivity is efficient,</li> <li data-item="-">exponential number of data.</li> </ul></dd> <dt>Grammar coverage-based generation:</dt> <dd><ul> <li data-item="+">fast for average or big data, and diversity of data,</li> <li data-item="-">do not consider size.</li> </ul></dd> </dl> <h2 id="LL1_compiler-compiler" for="main-toc">LL(1) compiler-compiler</h2> <p>The documentation of the LL(1) compiler, through the <code>Hoa\Compiler\Ll1</code> class, is not written yet. The goal is different regarding <code>Hoa\Compiler\Llk</code>: there is no grammar description language, automata are hard-coded with arrays and this type of compiler is high performance oriented. That's why its behavior is <strong>monolitic</strong>.</p> <h2 id="Conclusion" for="main-toc">Conclusion</h2> <p><code>Hoa\Compiler</code> provides two <strong>compiler-compilers</strong>: <code>Hoa\Compiler\Llk</code> and <code>Hoa\Compiler\Ll1</code>, in order to <strong>validate</strong> data. The <strong>PP language</strong> allows to write <strong>algebraic grammars</strong> in a <strong>simple</strong> and <strong>natural</strong> way. The LL(<em>k</em>) compiler-compiler is split in <strong>distinct processus</strong>, which encourages hackability. Finally, several algorithms allows to <strong>generate</strong> data based on a grammar according to specific usages.</p> </yield> </overlay> <?xml version="1.0" encoding="utf-8"?> <overlay xmlns="http://hoa-project.net/xyl/xylophone"> <yield id="chapter"> <p>Les <strong>compilateurs</strong> permettent d'<strong>analyser</strong> et <strong>manipuler</strong> des données <strong>textuelles</strong>. Leurs applications sont très nombreuses. <code>Hoa\Compiler</code> propose de manipuler plusieurs compilateurs selon les besoins.</p> <h2 id="Table_of_contents">Table des matières</h2> <tableofcontents id="main-toc" /> <h2 id="Introduction" for="main-toc">Introduction</h2> <blockquote cite="https://fr.wikipedia.org/wiki/Nicolas_Boileau">Ce qui se conçoit bien s'énonce clairement, et les mots pour le dire viennent aisément.</blockquote> <p>Un <strong>langage</strong> est une façon d'exprimer ou de <strong>formuler</strong> une <strong>solution</strong> à un <strong>problème</strong>. Et des problèmes, il en existe beaucoup. Nous lisons et écrivons dans plusieurs langages au quotidien, et certains de ces langages sont <strong>compris</strong> par des <strong>machines</strong>. Cette opération est possible grâce aux <strong>compilateurs</strong>.</p> <p>La <a href="https://fr.wikipedia.org/wiki/Théorie_des_langages">théorie des langages</a> étudie entre autres l'<strong>analyse automatique</strong> de ces langages à travers des outils comme des <strong>automates</strong> ou des <strong>grammaires</strong>. Il est nécessaire d'avoir un cours détaillé pour bien comprendre tous ces concepts. Toutefois, nous allons essayer de vulgariser un minimum pour permettre une utilisation correcte de <code>Hoa\Compiler</code>.</p> <h3 id="Language_and_grammar" for="main-toc">Langage et grammaire</h3> <p>Un <strong>langage</strong> est un ensemble de <strong>mots</strong>. Chaque mot est une <strong>séquence</strong> de <strong>symboles</strong> appartenant à un <strong>alphabet</strong>. Un symbole représente la plus petite <strong>unité lexicale</strong> d'un langage, il est atomique et nous l'appellons <strong>lexème</strong> (ou <em lang="en">token</em> en anglais). Les séquences de lexèmes représentant les mots sont construites avec des <strong>règles</strong>. À partir d'un mot et d'une règle racine, nous allons essayer de <strong>dériver</strong> ses sous-règles. Si une dérivation existe, alors le mot est considéré comme <strong>valide</strong>, sinon il est considéré comme <strong>invalide</strong>. Nous parlons aussi de <strong>reconnaissance</strong> de mots. Par exemple, si nous considérons les règles suivantes :</p> <pre><code> exp ::= exp + exp | nombre nombre ::= chiffre nombre | chiffre chiffre ::= 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9</code></pre> <p>Le mot que nous voulons reconnaître est <code>7 + 35</code>. La règle racine est <code><em>exp</em></code>. Si nous la dérivons (de gauche à droite et de haut en bas, ou <em lang="en">left-to-right</em> et <em lang="en">top-to-bottom</em> en anglais), nous pouvons avoir <code><em>exp</em> + <em>exp</em></code> ou <code><em>nombre</em></code> (la <strong>disjonction</strong>, <em>i.e.</em> le « ou », est représentée par le symbole « <code>|</code> ») :</p> <pre><code>exp + exp | nombre → exp + exp → ( exp + exp | nombre ) + exp → nombre + exp → ( chiffre nombre | chiffre ) + exp</code></pre> <p>Nous continuons à dériver jusqu'à <strong>éliminer</strong> toutes les règles et n'avoir que des <strong>lexèmes</strong> :</p> <pre><code>… → ( chiffre nombre | chiffre ) + exp → chiffre + exp → ( 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 ) + exp → 7 + exp → 7 + ( exp + exp | nombre ) → 7 + nombre → 7 + ( chiffre nombre | chiffre ) → 7 + chiffre nombre → 7 + ( 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 ) nombre → 7 + 3 nombre → 7 + 3 ( chiffre nombre | chiffre ) → 7 + 3 chiffre → 7 + 3 ( 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 ) → 7 + 3 5</code></pre> <p>Une dériviation existe bel et bien pour reconnaître le mot <code>7 + 35</code>, c'est donc un mot valide pour ces règles.</p> <p>Un ensemble de règles est appelé une <strong>grammaire</strong>. Et donc, une grammaire représente un <strong>langage</strong> !</p> <p>Toutefois, il existe plusieurs catégories de grammaires. C'est en 1956 qu'a été formulée la <a href="https://fr.wikipedia.org/wiki/Hi%C3%A9rarchie_de_Chomsky">hiérarchie de Chomsky</a>, classant les grammaires en quatre <strong>niveaux</strong> :</p> <ol> <li>grammaires <strong>générales</strong>, ou <em lang="en">unrestricted grammars</em>, reconnaissant les langages dits de Turing, aucune restriction n'est imposée aux règles ;</li> <li>grammaires <strong>contextuelles</strong>, ou <em lang="en">context-sensitive grammars</em>, reconnaissant les langages contextuels ;</li> <li>grammaires <strong>algébriques</strong>, ou <em lang="en">context-free grammars</em>, reconnaissant les langages algébriques, basés sur les automates à pile ;</li> <li>grammaires <strong>régulières</strong>, ou <em lang="en">regular grammars</em>, reconnaissant les langages réguliers.</li> </ol> <p>Chaque niveau reconnait le niveau suivant. <code>Hoa\Compiler</code> ne traite que les langages définis par les grammaires de niveau 3 et 4. Pour donner rapidement une idée, les grammaires régulières peuvent s'apparenter aux <a href="https://fr.wikipedia.org/wiki/Expression_régulière">expressions régulières</a> (comme les <a href="http://pcre.org/">PCRE</a>), bien connues des développeurs. Mais les grammaires régulières ne permettent pas par exemple de reconnaître des <strong>couples de symboles</strong> (comme des parenthèses, des accolades ou des guillemets), alors que les grammaires algébriques le permettent (grâce à la notion de piles de lexèmes).</p> <h3 id="Matching_words" for="main-toc">Reconnaissance de mots</h3> <div id="parsers" class="schema"></div> <script> Hoa.Document.onReady(function ( ) { var paper = Hoa.Graph(Hoa.$('#parsers'), 800, 180); var grid = paper.grid(0, 0, 800, 180, 5, 2); var word = grid.push(paper.rect(0, 0, 140, 80, 3, 'mot'), 0, 0); var sequence = grid.push(paper.rect(0, 0, 140, 80, 3, 'séquence'), 2, 0); var trace = grid.push(paper.rect(0, 0, 140, 80, 3, 'résultat'), 4, 0); grid.push(paper.rect(0, 0, 140, 50, 3, 'abcdef'), 0, 1); grid.push(paper.rect(0, 0, 380, 50, 3, '[[a ⟼ …], [bc ⟼ …], [d ⟼ …], [ef ⟼ …]]'), 2, 1); grid.push(paper.rect(0, 0, 140, 50, 3, 'valide/invalide'), 4, 1); paper.link.between(word, sequence, 'analyseur lexical'); paper.link.between(sequence, trace, 'analyseur syntaxique'); }); </script> <p>En général, le processus de compilation débute par deux <strong>analyses</strong> : <strong>lexicale</strong> et <strong>syntaxique</strong>. Une analyse lexicale consiste à <strong>découper</strong> un mot en une <strong>séquence de lexèmes</strong>. Cette séquence sera ensuite utilisée par l'analyseur syntaxique afin de vérifier que le mot <strong>appartient</strong> au langage.</p> <p>Selon la grammaire, la reconnaissance ne se fera pas de la même manière, mais le principe reste identique : prendre les lexèmes les uns après les autres dans la séquence et vérifier qu'ils permettent d'<strong>avancer</strong> dans la <strong>dérivation</strong> des règles de notre grammaire.</p> <p>Les analyses syntaxiques sont aussi classées en <strong>catégories</strong> : LL, LR, LALR etc. <code>Hoa\Compiler</code> ne propose que des analyseurs syntaxiques LL, pour <em lang="en">Left-to-right Leftmost derivation</em>, <em>i.e.</em> de la plus haute règle vers la plus profonde, et les règles sont dérivées de la gauche vers la droite. Là encore, il existe des sous-catégories, dont deux que traite <code>Hoa\Compiler</code> : LL(1) et LL(*). D'une manière générale, nous parlons d'analyseurs syntaxiques LL(<em>k</em>) : si un lexème ne permet pas de dériver une règle comme il faut, alors l'analyseur peut <strong>revenir</strong> jusqu'à <em>k</em> étapes en arrière ; nous parlons aussi de <em lang="en">backtrack</em>. Autrement dit, les règles peuvent être <strong>ambiguës</strong> : à chaque fois que nous dérivons une règle de la grammaire, nous avons plusieurs choix possibles et l'analyseur peut se tromper, c'est pourquoi il doit parfois revenir en arrière. La variable <em>k</em> permet de définir le <strong>niveau</strong> d'ambiguïté. Si une grammaire peut être analysée par un analyseur syntaxique LL(1), elle est dite <strong>non-ambiguë</strong> : à chaque lexème utilisé pour dériver nos règles, il n'y a qu'un seul choix possible. Et si nous avons un analyseur syntaxique LL(*), cela signifie que la variable <em>k</em> est <strong>indéfinie</strong>. L'exemple suivant illustre une grammaire non-ambiguë :</p> <pre><code>rule ::= a b c | d e f</code></pre> <p>Et cet exemple illustre une grammaire ambiguë :</p> <pre><code>rule1 ::= a rule2 rule2 ::= b rule3 | b rule4 rule3 ::= c d rule4 ::= e f</code></pre> <p>Voyons quand nous essayons de trouver une dérivation pour le mot <code>abef</code> à partir de la règle racine <code>rule1</code> :</p> <pre><code>rule1 → a rule2 <em> a bef ✔</em> → a (b rule3 | b rule4) <em> a bef</em> → a b rule3 <em> ab ef ✔</em> → a b c d <em> abe f ✖</em> ← a b rule3 <em> ab ef ✖</em> ← a (b rule3 | b rule4) <em> a bef</em> → a b rule4 <em> ab ef ✔</em> → a b e f <em>abef ✔</em></code></pre> <p>La règle <code>rule2</code> est ambiguë, ce qui peut entraîner une mauvaise dérivation et donc un retour en arrière, un <em lang="en">backtracking</em>.</p> <h2 id="LLk_compiler-compiler" for="main-toc">Compilateur de compilateurs LL(<em>k</em>)</h2> <p>Écrire des compilateurs est une tâche <strong>laborieuse</strong>. Ce n'est pas forcément toujours difficile mais souvent répétitif et long. C'est pourquoi il existe des <strong>compilateurs de compilateurs</strong>, ou autrement dit, des générateurs de compilateurs. La plupart du temps, ces compilateurs de compilateurs utilisent un langage <strong>intermédiaire</strong> pour écrire une grammaire. La bibliothèque <code>Hoa\Compiler</code> propose la classe <code>Hoa\Compiler\Llk\Llk</code> qui permet l'écriture de compilateurs de compilateurs à travers un langage <strong>dédié</strong>.</p> <h3 id="PP_language" for="main-toc">Langage PP</h3> <p>Le langage PP, pour <em lang="en">PHP Parser</em>, permet d'exprimer des <strong>grammaires algébriques</strong>. Il s'écrit dans des fichiers portant l'extension <code>.pp</code> (voir le fichier <a href="@central_resource:path=Library/Compiler/.Mime"><code>hoa://Library/Compiler/.Mime</code></a>).</p> <p>Une grammaire est constituée de <strong>lexèmes</strong> et de <strong>règles</strong>. La déclaration d'un lexème se fait de la manière suivante : <code>%token <em>namespace_in</em>:<em>name</em> <em>value</em> -> <em>namespace_out</em></code>, où <code><em>name</em></code> représente le <strong>nom</strong> du lexème, <code><em>value</em></code> représente sa <strong>valeur</strong>, au format <a href="http://pcre.org/">PCRE</a> (attention à ne pas reconnaître de valeur vide, auquel cas une exception sera levée), et <code><em>namespace_in</em></code> et <code><em>namespace_out</em></code> représentent les noms des <strong>espaces de noms</strong> et sont optionels (vaut <code>default</code> par défaut). Par exemple <code>number</code> qui représente un nombre composé de chiffres de <code>0</code> à <code>9</code> :</p> <pre><code class="language-pp">%token number \d+</code></pre> <p>Les espaces de noms représentent des <strong>sous-ensembles</strong> disjoints de lexèmes, utilisés pour <strong>faciliter</strong> les analyses. Une déclaration <code>%skip</code> est similaire à <code>%token</code> excepté qu'elle représente un lexème à <strong>sauter</strong>, c'est à dire à ne pas considérer. Un exemple courant de lexèmes <code>%skip</code> est les espaces :</p> <pre><code class="language-pp">%skip space \s</code></pre> <p>Pour expliquer les règles, nous allons utiliser comme exemple la grammaire <code>Json.pp</code>, grammaire légèrement <strong>simplifiée</strong> du <a href="http://json.org/">langage JSON</a> (voir la <a href="https://tools.ietf.org/html/rfc4627">RFC4627</a>). La grammaire <strong>complète</strong> se situe dans le fichier <a href="@central_resource:path=Library/Json/Grammar.pp"><code>hoa://Library/Json/Grammar.pp</code></a>. Ainsi :</p> <pre><code class="language-pp">%skip space \s // Scalars. %token true true %token false false %token null null // Strings. %token quote_ " -> string %token string:string [^"]+ %token string:_quote " -> default // Objects. %token brace_ { %token _brace } // Arrays. %token bracket_ \[ %token _bracket \] // Rest. %token colon : %token comma , %token number \d+ value: &lt;true> | &lt;false> | &lt;null> | string() | object() | array() | number() string: ::quote_:: &lt;string> ::_quote:: number: &lt;number> #object: ::brace_:: pair() ( ::comma:: pair() )* ::_brace:: #pair: string() ::colon:: value() #array: ::bracket_:: value() ( ::comma:: value() )* ::_bracket::</code></pre> <p>Nous remarquons que nous avons deux espaces de noms pour les lexèmes : <code>default</code> et <code>string</code> (cela permet de ne pas <strong>confondre</strong> les lexèmes <code>quote_</code> et <code>string:_quote</code> qui ont la même représentation). Nous remarquons ensuite la règle <code>value</code> qui est une <strong>disjonction</strong> de plusieurs lexèmes et règles. Les <strong>constructions</strong> du langage PP sont les suivantes :</p> <ul> <li><code><em>rule</em>()</code> pour <strong>appeler</strong> une règle ;</li> <li><code>&lt;<em>token</em>></code> et <code>::<em>token</em>::</code> pour <strong>déclarer</strong> un lexème (les espaces de noms n'apparaissent pas ici) ;</li> <li><code>|</code> pour une <strong>disjonction</strong> (un choix) ;</li> <li><code>(<em>…</em>)</code> pour grouper ;</li> <li><code><em>e</em>?</code> pour dire que <code><em>e</em></code> est <strong>optionel</strong> ;</li> <li><code><em>e</em>+</code> pour dire que <code><em>e</em></code> peut apparaître <strong>1 ou plusieurs</strong> fois ;</li> <li><code><em>e</em>*</code> pour dire que <code><em>e</em></code> peut apparaître <strong>0 ou plusieurs</strong> fois ;</li> <li><code><em>e</em>{<em>x</em>,<em>y</em>}</code> pour dire que <code><em>e</em></code> peut apparaître entre <code><em>x</em></code> et <code><em>y</em></code> fois ;</li> <li><code>#<em>node</em></code> pour créer un <strong>nœud</strong> <code><em>node</em></code> dans l'arbre ;</li> <li><code><em>token</em>[<em>i</em>]</code> pour <strong>unifier</strong> des lexèmes entre eux.</li> </ul> <p>Peu de constructions mais amplement suffisantes.</p> <p>Enfin, la grammaire du langage PP est écrite… dans le langage PP ! Vous pourrez la trouver dans le fichier <a href="@central_resource:path=Library/Compiler/Llk/Llk.pp"><code>hoa://Library/Compiler/Llk/Llk.pp</code></a>.</p> <h3 id="Compilation_process" for="main-toc">Processus de compilation</h3> <div id="overview" class="schema"></div> <script> Hoa.Document.onReady(function ( ) { var paper = Hoa.Graph(Hoa.$('#overview'), 800, 360); var flow = paper.grid(0, 0, 800, 360, 1, 4); flow.push(paper.rect(0, 0, 200, 70, 3, 'analyseur lexical')); flow.push(paper.rect(0, 0, 200, 70, 3, 'analyseur syntaxique')); flow.push(paper.rect(0, 0, 200, 70, 3, 'trace')); flow.push(paper.rect(0, 0, 200, 70, 3, 'AST')); var annot = paper.grid(180, 0, 80, 360, 1, 4); annot.push(paper.rect(0, 0, 45, 45, 22.5, '1')); annot.push(paper.rect(0, 0, 45, 45, 22.5, '2')); annot.push(paper.rect(0, 0, 45, 45, 22.5, '3')); annot.push(paper.rect(0, 0, 45, 45, 22.5, '4')); }); </script> <p>Le processus de compilation qu'utilise <code>Hoa\Compiler\Llk\Llk</code> est classique. Il commence par analyser <strong>lexicalement</strong> la donnée textuelle, le mot, <em>i.e.</em> à transformer notre donnée en une séquence de lexèmes. L'<strong>ordre</strong> de déclaration des lexèmes est primordial car l'analyseur lexical va les prendre les uns après les autres. Ensuite, c'est l'analyseur <strong>syntaxique</strong> qui entre en jeu afin de <strong>reconnaître</strong> notre donnée.</p> <p>Si l'analyse syntaxique est un succès, nous obtenons une <strong>trace</strong>. Cette trace peut être transformée en AST, pour <em lang="en">Abstract Syntax Tree</em>. Cet arbre représente notre donnée textuelle après analyse. Il a l'avantage de pouvoir être visité (nous détaillerons plus loin), ce qui permet par exemple d'ajouter de nouvelles <strong>contraintes</strong> qui ne peuvent pas être exprimées dans la grammaire, comme une vérification de type.</p> <p>Manipulons un peu <code>Hoa\Compiler\Llk\Llk</code>. Cette classe est un <strong>assistant</strong> pour lire une grammaire au format PP facilement. Elle prend en seul argument un flux en lecture vers la grammaire et retourne un compilateur <code>Hoa\Compiler\Llk\Parser</code> prêt à l'emploi. Sur ce compilateur, nous allons appeler la méthode <code>Hoa\Compiler\Llk\Parser::parse</code> pour analyser une donnée JSON. Si la donnée est correcte, nous aurons en retour un AST, sinon une exception sera levée. Enfin, nous allons utiliser le visiteur <code>Hoa\Compiler\Visitor\Dump</code> pour afficher notre AST :</p> <pre><code class="language-php">// 1. Load grammar. $compiler = Hoa\Compiler\Llk\Llk::load(new Hoa\File\Read('Json.pp')); // 2. Parse a data. $ast = $compiler->parse('{"foo": true, "bar": [null, 42]}'); // 3. Dump the AST. $dump = new Hoa\Compiler\Visitor\Dump(); echo $dump->visit($ast); /** * Will output: * > #object * > > #pair * > > > token(string:string, foo) * > > > token(true, true) * > > #pair * > > > token(string:string, bar) * > > > #array * > > > > token(null, null) * > > > > token(number, 42) */</code></pre> <p>Quand nous écrivons et testons une grammaire, nous allons répéter ces trois tâches très <strong>régulièrement</strong>. C'est pourquoi, le script <code>hoa</code> propose la commande <code>compiler:pp</code>. Cette commande propose d'analyser une donnée par rapport à une grammaire et d'appliquer un visiteur si besoin sur l'AST résultant. Notons que la lecture de la donnée peut se faire à travers un <a href="https://en.wikipedia.org/wiki/Pipeline_(Unix)"><em lang="en">pipe</em></a> :</p> <pre><code class="language-shell">$ echo '[1, [1, [2, 3], 5], 8]' | hoa compiler:pp Json.pp 0 --visitor dump > #array > > token(number, 1) > > #array > > > token(number, 1) > > > #array > > > > token(number, 2) > > > > token(number, 3) > > > token(number, 5) > > token(number, 8)</code></pre> <p>C'est un moyen pratique pour tester <strong>rapidement</strong> des données par rapport à notre grammaire. Il ne faut pas hésiter à regarder l'aide de la commande <code>compiler:pp</code> pour plus de détails !</p> <p>Les analyses s'effectuent sur la règle <strong>racine</strong> mais nous pouvons préciser une <strong>autre règle</strong> à l'aide du deuxième argument de la méthode <code>Hoa\Compiler\Llk\Parser::parse</code> :</p> <pre><code class="language-php">$compiler->parse('{"foo": true, "bar": [null, 42]}', 'object');</code></pre> <p>Pour utiliser la règle racine, il suffit de passer <code>null</code>.</p> <p>Et enfin, pour ne pas générer l'AST mais uniquement savoir si la donnée est valide ou pas, nous pouvons utiliser le dernier argument de notre méthode en lui passant <code>false</code> :</p> <pre><code class="language-php">$valid = $compiler->parse('{"foo": true, "bar": [null, 42]}', null, false); var_dump($valid); /** * Will output: * bool(true) */</code></pre> <h4 id="Errors" for="main-toc">Erreurs</h4> <p>Les erreurs de compilation sont remontées à travers des exceptions, ainsi :</p> <pre><code class="language-shell">$ echo '{"foo" true}' | hoa compiler:pp Json.pp 0 --visitor dump Uncaught exception (Hoa\Compiler\Exception\UnexpectedToken): Hoa\Compiler\Llk\Parser::parse(): (0) Unexpected token "true" (true) at line 1 and column 8: {"foo" true} ↑ in hoa://Library/Compiler/Llk/Parser.php at line 1</code></pre> <p>Plusieurs exceptions peuvent remonter selon le contexte :</p> <ul> <li>durant l'analyse <strong>lexicale</strong>, <code>Hoa\Compiler\Exception\UnrecognizedToken</code> quand un lexème n'est pas reconnu, <em>i.e.</em> quand la donnée textuelle ne peut plus être découpée en une séquence de lexèmes, et <code>Hoa\Compiler\Exception\Lexer</code> quand d'autres erreurs plus générales arrivent, par exemple si un lexème reconnaît une valeur vide ;</li> <li>durant l'analyse <strong>syntaxique</strong>, <code>Hoa\Compiler\Exception\UnexpectedToken</code> quand un lexème n'est pas attendu, <em>i.e.</em> qu'il ne permet plus de dériver les règles de la grammaire.</li> </ul> <p>L'exception parente est <code>Hoa\Compiler\Exception\Exception</code>.</p> <h4 id="Nodes" for="main-toc">Nœuds</h4> <p>Le processus de compilation aboutit très souvent à la <strong>production</strong> d'un AST. Il est important de contrôler sa <strong>forme</strong>, sa <strong>taille</strong>, les données qu'il <strong>contient</strong> etc. C'est pourquoi il est nécessaire de comprendre la notation <code>#<em>node</em></code> car elle permet de créer des <strong>nœuds</strong> dans l'AST. Une précision tout d'abord, les lexèmes déclarés avec la syntaxe <code>&lt;<em>token</em>></code> apparaîtront dans l'arbre, alors que les autres lexèmes, déclarés avec la syntaxe <code>::<em>token</em>::</code>, n'y apparaîtront pas. En effet, dans notre dernier exemple, les lexèmes <code>quote_</code>, <code>brace_</code>, <code>colon</code>, <code>comma</code> etc. n'apparaissent pas. Ensuite, il est important de noter que les déclarations de nœuds se <strong>surchargent</strong> les unes par rapport aux autres au sein d'une <strong>même règle</strong>. Enfin, un nom de règle peut être précédé par <code>#</code>, comme pour la règle <code>#array</code>, qui permet de définir un nœud par <strong>défaut</strong>, mais il peut être surchargé. Par exemple, si nous remplaçons la règle <code>array</code> par :</p> <pre><code class="language-pp">#array: ::bracket_:: value() ( ::comma:: value() #bigarray )* ::_bracket::</code></pre> <p>Si le tableau ne contient qu'une seule valeur, le nœud s'appelera <code>#array</code>, sinon il s'appelera <code>#bigarray</code> ; voyons plutôt :</p> <pre><code class="language-shell">$ echo '[42]' | hoa compiler:pp Json.pp 0 --visitor dump > #array > > token(number, 42) $ echo '[4, 2]' | hoa compiler:pp Json.pp 0 --visitor dump > #bigarray > > token(number, 4) > > token(number, 2)</code></pre> <p>Bien sûr, il peut arriver qu'un nœud soit créé ou pas selon le dérivation <strong>empruntée</strong> dans la règle. Le mécanisme est normalement assez <strong>intuitif</strong>.</p> <h4 id="Namespaces" for="main-toc">Espace de noms</h4> <p>Détaillons un peu le fonctionnement de l'analyseur lexical vis à vis des <strong>espaces de noms</strong>.</p> <p>Les <strong>lexèmes</strong> sont placés dans des espaces de noms, c'est à dire que seuls les lexèmes de l'espace de noms <strong>courant</strong> seront utilisés par l'analyseur lexical. L'espace de noms par défaut est <code>default</code>. Pour déclarer l'espace de noms d'un lexème, il faut utiliser l'opérateur <code>:</code>. Quand un lexème est consommé, il peut <strong>changer</strong> l'espace courant pour la suite de l'analyse lexicale, grâce à l'opérateur <code>-></code>. Ainsi, nous allons déclarer cinq lexèmes : <code>foo</code> et <code>bar</code> dans l'espace <code>default</code>, <code>baz</code> dans <code>ns1</code> et <code>qux</code> et <code>foo</code> dans <code>ns2</code>. Le fait de déclarer deux fois <code>foo</code> n'est pas gênant car ils sont dans des espaces de noms <strong>différent</strong> :</p> <pre><code class="language-pp">%token foo fo+ -> ns1 %token bar ba?r+ -> ns2 %token ns1:baz ba?z+ -> default %token ns2:qux qux+ %token ns2:foo FOO -> ns1</code></pre> <p>Écrire <code>default:bar</code> est strictement équivalent à <code>bar</code>. Le lexème <code>foo</code> emmène dans <code>ns1</code>, <code>bar</code> dans <code>ns2</code>, <code>ns1:baz</code> dans <code>default</code>, <code>ns2:qux</code> reste dans <code>ns2</code> et <code>ns2:foo</code> emmène dans <code>ns1</code>. Observons la séquence de lexèmes produite par l'analyseur lexical avec la donnée <code>fooooobzzbarrrquxFOObaz</code> :</p> <pre><code class="language-php">$pp = '%token foo fo+ -> ns1' . "\n" . '%token bar ba?r+ -> ns2' . "\n" . '%token ns1:baz ba?z+ -> default' . "\n" . '%token ns2:qux qux+' . "\n" . '%token ns2:foo FOO -> ns1'; // 1. Parse PP. Hoa\Compiler\Llk\Llk::parsePP($pp, $tokens, $rawRules); // 2. Run the lexical analyzer. $lexer = new Hoa\Compiler\Llk\Lexer(); $sequence = $lexer->lexMe('fooooobzzbarrrquxFOObaz', $tokens); // 3. Pretty-print the result. $format = '%' . (strlen((string) count($sequence)) + 1) . 's ' . '%-13s %-20s %-20s %6s' . "\n"; $header = sprintf($format, '#', 'namespace', 'token name', 'token value', 'offset'); echo $header, str_repeat('-', strlen($header)), "\n"; foreach ($sequence as $i => $token) { printf( $format, $i, $token['namespace'], $token['token'], $token['value'], $token['offset'] ); } /** * Will output: * # namespace token name token value offset * --------------------------------------------------------------------- * 0 default foo fooooo 0 * 1 ns1 baz bzz 6 * 2 default bar barrr 9 * 3 ns2 qux qux 14 * 4 ns2 foo FOO 17 * 5 ns1 baz baz 20 * 6 default EOF EOF 23 */</code></pre> <p>Nous lisons les lexèmes, leur espace et leur valeur dans le tableau. La donnée a pu être <strong>découpée</strong>, et nous sommes passés d'un espace à un autre. Si cette fois nous essayons avec la donnée <code>foqux</code>, nous aurons une erreur : <code>fo</code> correspond au lexème <code>foo</code> dans l'espace <code>default</code>, nous changeons alors d'espace pour <code>ns1</code>, et là, aucun lexème dans cet espace ne peut reconnaître au moins <code>q</code>. Une erreur sera levée.</p> <p>Jusqu'à maintenant, nous avons vu comment passer d'un espace à l'autre avec l'opérateur <code>-></code>. Aucun <strong>historique</strong> sur les espaces traversés n'est conservé. Toutefois, dans certains cas rares, il peut arriver qu'un espace de lexèmes soit accessible via <strong>plusieurs</strong> autres et que nous aimerions qu'un lexème déclenche le retour vers l'espace de noms <strong>précédent</strong>. Autrement dit, nous aimerions un historique des espaces traversés et pouvoir y naviguer (en arrière uniquement). C'est le rôle du mot-clé <code>__shift__ * <em>n</em></code>, à utiliser après l'opérateur <code>-></code> et à la place du nom d'un espace. <code>__shift__</code> est équivalent à dire : revient à l'espace précédent. <code>__shift__</code> est équivalent à <code>__shift__ * 1</code>, et <code>__shift__ * <em>n</em></code> à : revient <code><em>n</em></code> fois à l'espace précédent.</p> <p>Lorsque le mot-clé <code>__shift__</code> apparaît dans la grammaire, les espaces sont gérés comme une <strong>pile</strong>, d'où le vocabulaire <em lang="en">shift</em>. Il faut faire attention à bien dépiler les espaces pour ne pas avoir une pile trop conséquente.</p> <p>Prenons en exemple la grammaire suivante :</p> <pre><code class="language-pp">%token foo1 a -> ns1 %token foo2 x -> ns2 %token end e %token ns1:bar b %token ns1:baz c -> ns3 %token ns1:tada t -> __shift__ %token ns2:bar y %token ns2:baz z -> ns3 %token ns2:tada T -> __shift__ %token ns3:qux = -> __shift__ #test: ( &lt;foo1> | &lt;foo2> ) &lt;bar> &lt;baz> &lt;qux> &lt;tada> &lt;end></code></pre> <p>Cette grammaire reconnaît deux données : <code>abc=te</code> et <code>xyz=Te</code>. Si le premier lexème <code>foo1</code> est rencontré, l'analyseur syntaxique changera d'espace pour <code>ns1</code>. Quand il rencontrera le lexème <code>ns1:baz</code>, il passera dans <code>ns3</code>. Ensuite, quand il rencontrera <code>ns3:qux</code>, il reviendra à l'espace précédent, soit <code>ns1</code>. Et ainsi de suite. Maintenant, s'il ne rencontre pas <code>foo1</code> mais <code>foo2</code>, il ira dans l'espace <code>ns2</code>, puis dans <code>ns3</code> puis à nouveau <code>ns2</code>. Les mots-clés <code>__shift__</code> pour <code>ns1:tada</code> et <code>ns2:tada</code> n'ont pas d'autres buts que de dépiler les espaces, mais aucune ambiguïté n'existe : ces espaces ne sont accessibles que par un seul espace, à savoir <code>default</code>.</p> <p>Maintenant, enregistrons cette grammaire dans un fichier <code>NamespaceStack.pp</code> et utilisons l'option <code>-s/--token-sequence</code> de la commande <code>hoa compiler:pp</code> :</p> <pre><code class="language-shell">$ echo -n 'abc=te' | hoa compiler:pp NamespaceStack.pp 0 --token-sequence # namespace token name token value offset ------------------------------------------------------------------------------- 0 default foo1 a 0 1 ns1 bar b 1 2 ns1 baz c 2 3 ns3 qux = 3 4 ns1 tada t 4 5 default end e 5 6 default EOF EOF 6 $ echo -n 'xyz=Te' | hoa compiler:pp NamespaceStack.pp 0 --token-sequence # namespace token name token value offset ------------------------------------------------------------------------------- 0 default foo2 x 0 1 ns2 bar y 1 2 ns2 baz z 2 3 ns3 qux = 3 4 ns2 tada T 4 5 default end e 5 6 default EOF EOF 6</code></pre> <p>Nous voyons que l'analyse lexicale a réussi à jongler avec les espaces de noms, comme attendu. Nous avions deux façons d'accéder à l'espace <code>ns3</code> : soit depuis <code>ns1</code>, soit depuis <code>ns2</code>. L'analyseur a réussi à créer un historique des espaces et à y naviguer.</p> <h4 id="Unification" for="main-toc">Unification</h4> <p>Une caractéristique qu'apporte le langage PP par rapport à d'autres langages de grammaires connus est la capacité d'exprimer une <strong>unification</strong> de lexèmes. Imaginons la grammaire suivante :</p> <pre><code class="language-pp">%token quote '|" %token string \w+ rule: ::quote:: &lt;string> ::quote::</code></pre> <p>Les guillemets qui entourent la chaîne de caractère peuvent être de deux sortes : simple, avec le symbole « <code>'</code> », ou double, avec le symbole « <code>"</code> ». Ainsi, les données <code>"foo"</code> et <code>'foo'</code> sont valides, mais <strong>également</strong> <code>"foo'</code> et <code>'foo"</code> !</p> <p>L'unification des lexèmes permet d'ajouter une <strong>contrainte</strong> supplémentaire sur la <strong>valeur</strong> des lexèmes à l'exécution. La syntaxe est la suivante : <code><em>token</em>[<em>i</em>]</code>. La valeur de <code><em>i</em></code> indique quels lexèmes vont devoir porter la même valeur. Et enfin, l'unification est <strong>locale</strong> à une instance d'une règle, c'est à dire qu'il n'y a pas d'unification entre les lexèmes de plusieurs règles et que cela s'applique sur la règle <strong>appelée</strong> uniquement. Ainsi, l'exemple devient :</p> <pre><code class="language-pp">rule: ::quote[0]:: &lt;string> ::quote[0]::</code></pre> <p>Ce qui invalide les données <code>"foo'</code> et <code>'foo"</code>.</p> <p>L'unification trouve de nombreuses applications, comme par exemple unifier les noms des balises ouvrantes et fermantes du <a href="http://w3.org/TR/xml11/">langage XML</a>.</p> <h3 id="Abstract_Syntax_Tree" for="main-toc"><em lang="en">Abstract Syntax Tree</em></h3> <div id="overview_ast" class="schema"></div> <script> Hoa.Document.onReady(function ( ) { var paper = Hoa.Graph(Hoa.$('#overview_ast'), 800, 360); var flow = paper.grid(0, 0, 800, 360, 1, 4); flow.push(paper.rect(0, 0, 200, 70, 3, 'analyseur lexical').attr({opacity: .3})); flow.push(paper.rect(0, 0, 200, 70, 3, 'analyseur syntaxique').attr({opacity: .3})); flow.push(paper.rect(0, 0, 200, 70, 3, 'trace').attr({opacity: .3})); flow.push(paper.rect(0, 0, 200, 70, 3, 'AST')); var annot = paper.grid(180, 0, 80, 360, 1, 4); annot.push(paper.rect(0, 0, 45, 45, 22.5, '1').attr({opacity: .3})); annot.push(paper.rect(0, 0, 45, 45, 22.5, '2').attr({opacity: .3})); annot.push(paper.rect(0, 0, 45, 45, 22.5, '3').attr({opacity: .3})); annot.push(paper.rect(0, 0, 45, 45, 22.5, '4')); }); </script> <p>Un arbre <strong>syntaxique abstrait</strong> représente une donnée textuelle sous forme <strong>structurelle</strong>. Chaque <strong>nœud</strong> de cet arbre est représenté par la classe <code>Hoa\Compiler\Llk\TreeNode</code>. Parmis les méthodes utiles, nous trouvons :</p> <ul> <li><code>getId</code> pour obtenir l'identifiant du nœud ;</li> <li><code>getValueToken</code> pour obtenir le nom du lexème ;</li> <li><code>getValueValue</code> pour obtenir la valeur du lexème ;</li> <li><code>isToken</code> si le nœud représente un lexème ;</li> <li><code>getChild(<em>$i</em>)</code> pour obtenir le <code><em>$i</em></code>-ème enfant d'un nœud ;</li> <li><code>getChildren</code> pour obtenir tous les nœuds ;</li> <li><code>getChildrenNumber</code> pour connaître le nombre d'enfants ;</li> <li><code>getParent</code> pour obtenir le nœud parent ;</li> <li><code>getData</code> pour obtenir une référence vers un tableau de données ;</li> <li><code>accept</code> pour appliquer un visiteur.</li> </ul> <p>Les visiteurs sont le moyen le plus pratique pour <strong>parcourir</strong> un AST. En guise d'exemple, nous allons écrire le visiteur <code>PrettyPrinter</code> qui va réécrire une donnée JSON avec notre propre convention (espacements, retours à la ligne etc.). Un visiteur doit implémenter l'interface <code>Hoa\Visitor\Visit</code> et n'aura qu'une seule méthode à écrire : <code>visit</code> qui prend trois arguments : l'élément et deux arguments accessoires (en référence et en copie). Voyons plutôt :</p> <pre><code class="language-php">class PrettyPrinter implements Hoa\Visitor\Visit { public function visit ( Hoa\Visitor\Element $element, &amp;$handle = null, $eldnah = null ) { static $i = 0; static $indent = ' '; // One behaviour per node in the AST. switch ($element->getId()) { // Object: { … }. case '#object': echo '{', "\n"; ++$i; foreach ($element->getChildren() as $e => $child) { if (0 &lt; $e) { echo ',', "\n"; } echo str_repeat($indent, $i); $child->accept($this, $handle, $eldnah); } echo "\n", str_repeat($indent, --$i), '}'; break; // Array: [ … ]. case '#array': echo '[', "\n"; ++$i; foreach ($element->getChildren() as $e => $child) { if (0 &lt; $e) { echo ',', "\n"; } echo str_repeat($indent, $i); $child->accept($this, $handle, $eldnah); } echo "\n", str_repeat($indent, --$i), ']'; break; // Pair: "…": …. case '#pair': echo $element->getChild(0)->accept($this, $handle, $eldnah), ': ', $element->getChild(1)->accept($this, $handle, $eldnah); break; // Many tokens. case 'token': switch ($element->getValueToken()) { // String: "…". case 'string': echo '"', $element->getValueValue(), '"'; break; // Booleans. case 'true': case 'false': // Null. case 'null': // Number. case 'number': echo $element->getValueValue(); break; } break; } } }</code></pre> <p>Nous allons voir tout de suite un exemple d'utilisation :</p> <pre><code class="language-php">$compiler = Hoa\Compiler\Llk\Llk::load(new Hoa\File\Read('Json.pp')); $ast = $compiler->parse('{"foo": true, "bar": [null, 42]}'); $prettyPrint = new PrettyPrinter(); echo $prettyPrint->visit($ast); /** * Will output: * { * "foo": true, * "bar": [ * null, * 42 * ] * } */</code></pre> <p>La méthode <code>getData</code> est très pratique pour <strong>stocker</strong> des données susceptibles d'être <strong>réutilisées</strong>, par exemple d'un visiteur à l'autre. Cette méthode retourne une <strong>référence</strong> sur un tableau ; ainsi :</p> <pre><code class="language-php">$data = $element->getData(); if (!isset($data['previousComputing'])) { throw new Exception('Need a previous computing.', 0); } $previous = $data['previousComputing'];</code></pre> <p>Il est courant d'utiliser un visiteur par <strong>contrainte</strong> : vérifiation des symboles, vérification de types etc. Certains peuvent laisser des données nécessaires pour le suivant. La méthode <code>getData</code> n'impose aucune structuration des données, elle propose uniquement un accès à un tableau. Ce sera à vous de faire le reste.</p> <p>Utiliser la classe <code>Hoa\Compiler\Llk\TreeNode</code> est vraiment <strong>trivial</strong> et nous l'utiliserons la plupart du temps avec un visiteur.</p> <h3 id="Traces" for="main-toc">Traces</h3> <div id="overview_trace" class="schema"></div> <script> Hoa.Document.onReady(function ( ) { var paper = Hoa.Graph(Hoa.$('#overview_trace'), 800, 360); var flow = paper.grid(0, 0, 800, 360, 1, 4); flow.push(paper.rect(0, 0, 200, 70, 3, 'analyseur lexical').attr({opacity: .3})); flow.push(paper.rect(0, 0, 200, 70, 3, 'analyseur syntaxique').attr({opacity: .3})); flow.push(paper.rect(0, 0, 200, 70, 3, 'trace')); flow.push(paper.rect(0, 0, 200, 70, 3, 'AST').attr({opacity: .3})); var annot = paper.grid(180, 0, 80, 360, 1, 4); annot.push(paper.rect(0, 0, 45, 45, 22.5, '1').attr({opacity: .3})); annot.push(paper.rect(0, 0, 45, 45, 22.5, '2').attr({opacity: .3})); annot.push(paper.rect(0, 0, 45, 45, 22.5, '3')); annot.push(paper.rect(0, 0, 45, 45, 22.5, '4').attr({opacity: .3})); }); </script> <p>Le compilateur LL(<em>k</em>) que propose Hoa est clairement découpé en plusieurs <strong>couches</strong>. Chaque couche est exploitable pour permettre une modularité maximum. Quand la grammaire est traduite en « règles machines » et que les analyseurs lexical et syntaxique ont validé une donnée, il en résulte une <strong>trace</strong>. Cette trace est un tableau composé de trois classes seulement :</p> <ul> <li><code>Hoa\Compiler\Llk\Rule\Entry</code> quand l'analyseur syntaxique est rentré dans une règle ;</li> <li><code>Hoa\Compiler\Llk\Rule\Ekzit</code> quand l'analyseur syntaxique est sorti d'une règle ;</li> <li><code>Hoa\Compiler\Llk\Rule\Token</code> quand l'analyseur syntaxique a rencontré un lexème.</li> </ul> <p>Nous pouvons l'obtenir grâce à la méthode <code>Hoa\Compiler\Llk\Parser::getTrace</code>. Pour bien comprendre cette trace, nous allons commencer par un exemple :</p> <pre><code class="language-php">$compiler = Hoa\Compiler\Llk\Llk::load(new Hoa\File\Read('Json.pp')); $ast = $compiler->parse('{"foo": true, "bar": [null, 42]}'); $i = 0; foreach ($compiler->getTrace() as $element) { if ($element instanceof Hoa\Compiler\Llk\Rule\Entry) { echo str_repeat('> ', ++$i), 'enter ', $element->getRule(), "\n"; } elseif ($element instanceof Hoa\Compiler\Llk\Rule\Token) { echo str_repeat(' ', $i + 1), 'token ', $element->getTokenName(), ', consumed ', $element->getValue(), "\n"; } else { echo str_repeat('&lt; ', $i--), 'ekzit ', $element->getRule(), "\n"; } } /** * Will output: * > enter value * > > enter object * token brace_, consumed { * > > > enter pair * > > > > enter string * token quote_, consumed " * token string, consumed foo * token _quote, consumed " * &lt; &lt; &lt; &lt; ekzit string * token colon, consumed : * > > > > enter value * token true, consumed true * &lt; &lt; &lt; &lt; ekzit value * &lt; &lt; &lt; ekzit pair * > > > enter 13 * > > > > enter 12 * token comma, consumed , * > > > > > enter pair * > > > > > > enter string * token quote_, consumed " * token string, consumed bar * token _quote, consumed " * &lt; &lt; &lt; &lt; &lt; &lt; ekzit string * token colon, consumed : * > > > > > > enter value * > > > > > > > enter array * token bracket_, consumed [ * > > > > > > > > enter value * token null, consumed null * &lt; &lt; &lt; &lt; &lt; &lt; &lt; &lt; ekzit value * > > > > > > > > enter 21 * > > > > > > > > > enter 20 * token comma, consumed , * > > > > > > > > > > enter value * token number, consumed 42 * &lt; &lt; &lt; &lt; &lt; &lt; &lt; &lt; &lt; &lt; ekzit value * &lt; &lt; &lt; &lt; &lt; &lt; &lt; &lt; &lt; ekzit 20 * &lt; &lt; &lt; &lt; &lt; &lt; &lt; &lt; ekzit 21 * token _bracket, consumed ] * &lt; &lt; &lt; &lt; &lt; &lt; &lt; ekzit array * &lt; &lt; &lt; &lt; &lt; &lt; ekzit value * &lt; &lt; &lt; &lt; &lt; ekzit pair * &lt; &lt; &lt; &lt; ekzit 12 * &lt; &lt; &lt; ekzit 13 * token _brace, consumed } * &lt; &lt; ekzit object * &lt; ekzit value */</code></pre> <p>Cet exemple nous révèle plusieurs choses. Tout d'abord, les informations que nous donne la trace peuvent être utiles : si nous sommes sur une règle, nous avons son <strong>nom</strong> (avec la méthode <code>getRule</code>), et si nous sommes sur un lexème, nous avons son <strong>nom</strong> (avec la méthode <code>getTokenName</code>), sa <strong>représentation</strong> (sous la forme d'une PCRE, avec la méthode <code>getRepresentation</code>), sa <strong>valeur</strong> (avec la méthode <code>getValue</code>), si c'est un nœud à <strong>conserver</strong> dans l'AST (avec la méthode <code>isKept</code>) et son index d'<strong>unification</strong> s'il existe (avec la méthode <code>getUnificationIndex</code>). Bien sûr, tout ceci est modifiable, ce qui peut influencer la construction de l'AST qui est le processus (optionnel) suivant.</p> <p>Ensuite, nous remarquons que parfois nous entrons dans une règle qui existe dans la grammaire, comme <code>object</code>, <code>pair</code>, <code>value</code> etc., et parfois nous entrons dans une règle <strong>numérique</strong>, comme <code>13</code>, <code>12</code>, <code>21</code>, <code>20</code> etc. Quand la grammaire est interprétée pour être transformée en « règles machines », chacune de ses règles est <strong>linéarisée</strong> selon les opérateurs du langage PP :</p> <ul> <li><code>Hoa\Compiler\Llk\Rule\Choice</code> pour une disjonction ;</li> <li><code>Hoa\Compiler\Llk\Rule\Concatenation</code> pour une concaténation ;</li> <li><code>Hoa\Compiler\Llk\Rule\Repetition</code> pour une répétition ;</li> <li><code>Hoa\Compiler\Llk\Rule\Token</code> pour un lexème (déjà vu précédemment).</li> </ul> <p>Toutes les règles sous ce format sont accessibles à travers la méthode <code>Hoa\Compiler\Llk\Parser::getRules</code> sous la forme d'un tableau. Nous allons afficher toutes les règles <strong>accessibles</strong> depuis la règle racine pour mieux comprendre :</p> <pre><code class="language-php">$compiler = Hoa\Compiler\Llk\Llk::load(new Hoa\File\Read('Json.pp')); // 1. Get all rules. $rules = $compiler->getRules(); // 2. Start with the root rule. $stack = [$compiler->getRootRule() => true]; while (false !== current($stack)) { $rule = key($stack); next($stack); echo "\n", '"', $rule, '" is a ', strtolower(substr(get_class($rules[$rule]), 22)); $subrules = $rules[$rule]->getContent(); // 3a. Token. if (null === $subrules) { continue; } echo ' of rules: '; // 3b. Other rules. foreach ((array) $rules[$rule]->getContent() as $subrule) { if (!array_key_exists($subrule, $stack)) { // 4. Unshift new rules to print. $stack[$subrule] = true; } echo $subrule, ' '; } } /** * Will output: * "value" is a choice of rules: 1 2 3 string object array number * "1" is a token * "2" is a token * "3" is a token * "string" is a concatenation of rules: 5 6 7 * "object" is a concatenation of rules: 10 pair 13 14 * "array" is a concatenation of rules: 18 value 21 22 * "number" is a token * "5" is a token * "6" is a token * "7" is a token * "10" is a token * "pair" is a concatenation of rules: string 16 value * "13" is a repetition of rules: 12 * "14" is a token * "18" is a token * "21" is a repetition of rules: 20 * "22" is a token * "16" is a token * "12" is a concatenation of rules: 11 pair * "20" is a concatenation of rules: 19 value * "11" is a token * "19" is a token */</code></pre> <p>Si nous lisons la règle <code>object</code>, nous savons que c'est la concaténation des règles <code>10</code>, <code>pair</code>, <code>13</code> et <code>14</code>. <code>10</code> est un lexème, <code>pair</code> est la concaténation des règles <code>string</code>, <code>16</code> et <code>value</code>, et ainsi de suite. La grammaire initiale est transformée pour être sous sa forme la plus <strong>réduite</strong> possible. Ceci permet de <strong>raisonner</strong> beaucoup plus <strong>facilement</strong> et <strong>rapidement</strong> sur les règles. En effet, les traitements sur la grammaire ne sont pas réservés aux AST. À l'étape précédente, avec la trace, nous pouvons déjà effectuer des traitements.</p> <h3 id="Generation" for="main-toc">Génération</h3> <p>Une grammaire peut être utile pour deux objectifs : <strong>valider</strong> une donnée (si nous la voyons comme un automate) ou <strong>générer</strong> des données. Jusqu'à présent, nous avons vu comment valider une donnée à travers plusieurs processus : <strong>préparation</strong> de notre compilateur, exécution des <strong>analyseurs</strong> lexical et syntaxique résultant sur une <strong>trace</strong>, transformation de la trace vers un <strong>AST</strong> pour enfin <strong>visiter</strong> cet arbre. Mais nous pouvons nous arrêter à la première étape, la préparation de notre compilateur, pour exploiter les règles afin de générer une donnée qui sera valide par rapport à notre grammaire.</p> <p><code>Hoa\Compiler\Llk\Sampler</code> propose trois algorithmes de <strong>générations</strong> de données :</p> <ul> <li>génération aléatoire et uniforme ;</li> <li>génération exhaustive bornée ;</li> <li>génération basée sur la couverture.</li> </ul> <p>Pourquoi proposer trois algorithmes ? Parce qu'il est illusoire de penser qu'un seul algorithme peut suffir aux <strong>nombreux</strong> contextes d'utilisations. Chacun répond à des besoins différents, nous l'expliquerons plus loin.</p> <p>Générer une donnée à partir d'une grammaire se fait en <strong>deux étapes</strong> :</p> <ol> <li>générer des valeurs pour les <strong>lexèmes</strong> afin d'avoir des données brutes ;</li> <li>générer un <strong>chemin</strong> dans les règles de la grammaire.</li> </ol> <p>Un chemin est équivalent à une dérivation, le vocabulaire est différent selon notre objectif : validation ou génération.</p> <h4 id="Isotropic_generation_of_lexemes" for="main-toc">Génération isotropique de lexèmes</h4> <p>Pour générer les valeurs des lexèmes, peu importe l'algorithme utilisé, il doit être <strong>rapide</strong>. Nous allons utiliser un parcours dit <strong>isotrope</strong>. Nous partons d'une règle et nous avançons uniquement à partir de choix <strong>aléatoires</strong> et <strong>uniformes localement</strong> (uniquement pour ce choix). Par exemple si nous avons une disjonction entre trois sous-règles, nous allons tirer aléatoirement et uniformément entre 1 et 3. Si nous avons une concaténation, nous allons juste concaténer chaque partie. Et enfin, une répétition n'est rien d'autre qu'une disjonction de concaténation : en effet, <code><em>e</em>{1,3}</code> est strictement équivalent à <code><em>e</em> | <em>ee</em> | <em>eee</em></code>. Illustrons plutôt :</p> <pre><code>([ae]+|[x-z]!){1,3} <em>repeat <em>[ae]+|[x-z]!</em> 2 times</em> → ([ae]+|[x-z]!)([ae]+|[x-z]!) <em>choose between <em>[ae]+</em> and <em>[x-z]!</em></em> → ([ae]+)([ae]+|[x-z]!) <em>repeat <code>ae</code> 2 times</em> → [ae][ae]([ae]+|[x-z]!) <em>choose between <em>a</em> and <em>e</em></em> → e[ae]([ae]+|[x-z]!) <em>again</em> → ea([ae]+|[x-z]!) <em>choose between <em>[ae]+</em> and <em>[x-z]!</em></em> → ea([x-z]!) <em>choose between <em>x</em>, <em>y</em> and <em>z</em></em> → eay!</code></pre> <p>Cette génération est <strong>naïve</strong> mais ce n'est pas important. Ce qui est vraiment important est la génération des chemins dans les règles, ou autrement dit, la génération des <strong>séquences de lexèmes</strong>.</p> <h4 id="Uniform_random_generation" for="main-toc">Génération aléatoire et uniforme</h4> <p>Le premier algorithme est celui de la génération <strong>aléatoire</strong> et <strong>uniforme</strong>. Cet algorithme est utile si nous voulons générer des séquences de lexèmes de <strong>taille <em>n</em> fixe</strong> et avec une <strong>uniformité</strong> non pas locale (comme avec un parcours isotrope) mais sur l'<strong>ensemble</strong> de toutes les séquences possibles. Succinctement, l'algorithme travaille en deux étapes : <strong>pré-calcul</strong> (une seule fois par taille) puis <strong>génération</strong>. Le pré-calcul est une étape <strong>automatique</strong> et calcule le <strong>nombre</strong> de séquences et sous-séquences possibles de taille <em>n</em>. Cette étape aide au calcul de <strong>fonctions de répartions</strong> pour <strong>guider</strong> la génération des séquences de lexèmes finales.</p> <p>Nous allons générer 10 données aléatoires de taille 7, c'est à dire composées de 7 lexèmes. Pour cela, nous allons utiliser la classe <code>Hoa\Compiler\Llk\Sampler\Uniform</code> qui prend en premier argument notre grammaire, en deuxième le générateur de valeurs de lexèmes (ici <code>Hoa\Regex\Visitor\Isototropic</code>) et enfin la taille :</p> <pre><code class="language-php">$sampler = new Hoa\Compiler\Llk\Sampler\Uniform( // Grammar. Hoa\Compiler\Llk\Llk::load(new Hoa\File\Read('Json.pp')), // Token sampler. new Hoa\Regex\Visitor\Isotropic(new Hoa\Math\Sampler\Random()), // Length. 7 ); for ($i = 0; $i &lt; 10; ++$i) { echo $i, ' => ', $sampler->uniform(), "\n"; } /** * Will output: * 0 => [ false , null , null ] * 1 => [ " l " , null ] * 2 => [ [ true ] , true ] * 3 => [ [ [ 4435 ] ] ] * 4 => [ [ [ 9366 ] ] ] * 5 => [ true , false , null ] * 6 => { " |h&lt;# " : false } * 7 => [ [ [ false ] ] ] * 8 => [ false , true , 7 ] * 9 => [ false , 5 , 79 ] */</code></pre> <p>Nous pouvons redéfinir la taille avec la méthode <code>Hoa\Compiler\Llk\Sampler\Uniform::setLength</code>. Nous aurons peut-être remarqué que certains opérateurs de répétition n'ont pas de bornes supérieures, comme <code>+</code> ou <code>*</code> ; dans ce cas, nous la définissons à <em>n</em>.</p> <h4 id="Bounded_exhaustive_generation" for="main-toc">Génération exhaustive bornée</h4> <p>Le deuxième algorithme est celui de la génération <strong>exhaustive bornée</strong>. Cet algorithme génère <strong>toutes</strong> les séquences (c'est le côté exhaustif) de lexèmes de taille 1 <strong>jusqu'à</strong> <em>n</em> (c'est le caractère borné). Un aspect très intéressant de cet algorithme est que l'exhaustivité est une forme de <strong>preuve</strong> ! L'algorithme fonctionne comme un itérateur et est très simple à utiliser :</p> <pre><code class="language-php">$sampler = new Hoa\Compiler\Llk\Sampler\BoundedExhaustive( // Grammar. Hoa\Compiler\Llk\Llk::load(new Hoa\File\Read('Json.pp')), // Token sampler. new Hoa\Regex\Visitor\Isotropic(new Hoa\Math\Sampler\Random()), // Length. 7 ); foreach ($sampler as $i => $data) { echo $i, ' => ', $data, "\n"; } /** * Will output: * 0 => true * 1 => false * 2 => null * 3 => " 8u2 " * 4 => { " ,M@aj{ " : true } * 5 => { " x`|V " : false } * 6 => { " NttB " : null } * 7 => { " eJWwA " : 0 } * 8 => [ true ] * 9 => [ true , true ] * 10 => [ true , true , true ] * 11 => [ true , true , false ] * 12 => [ true , true , null ] * 13 => [ true , true , 32 ] * 14 => [ true , false ] * 15 => [ true , false , true ] * 16 => [ true , false , false ] * 17 => [ true , false , null ] * 18 => [ true , false , 729 ] * 19 => [ true , null ] * 20 => [ true , null , true ] * 21 => [ true , null , false ] * … * 157 => [ 780 , 01559 , 32 ] * 158 => 344 */</code></pre> <p><em>A l'instar</em> de l'algorithme précédent, nous pouvons redéfinir la borne maximum avec la méthode <code>Hoa\Compiler\Llk\Sampler\BoundedExhaustive::setLength</code>. Et les opérateurs de répétition sans borne supérieure utilisent <em>n</em>.</p> <h4 id="Grammar_coverage-based_generation" for="main-toc">Génération basée sur la couverture</h4> <p>Le dernier algorithme est celui de la génération <strong>basée sur la couverture</strong>. Cet algorithme réduit l'<strong>explosion combinatoire</strong> rencontrée avec l'algorithme précédent mais l'objectif est tout autre : il va générer des séquences de lexèmes qui vont « <strong>activer</strong> » toutes les <strong>branches</strong> des règles de la grammaire. Une règle est dite couverte si et seulement si ses sous-règles sont toutes couvertes, et un lexème est dit couvert s'il a été utilisé dans une séquence. Pour assurer une <strong>diversité</strong> dans les séquences produites, les points de choix entre des sous-règles non couvertes sont résolus par tirages <strong>aléatoires</strong>. L'algorithme fonctionne également comme un itérateur :</p> <pre><code class="language-php">$sampler = new Hoa\Compiler\Llk\Sampler\Coverage( // Grammar. Hoa\Compiler\Llk\Llk::load(new Hoa\File\Read('Json.pp')), // Token sampler. new Hoa\Regex\Visitor\Isotropic(new Hoa\Math\Sampler\Random()) ); foreach ($sampler as $i => $data) { echo $i, ' => ', $data, "\n"; } /** * Will output: * 0 => true * 1 => { " )o?bz " : null , " %3W) " : [ false , 130 , " 6 " ] } * 2 => [ { " ny " : true } ] * 3 => { " Ne;[3 " : [ true , true ] , " th: " : true , " C[8} " : true } */</code></pre> <p>Pour éviter l'explosion combinatoire et assurer la <strong>termination</strong> de l'algorithme, nous utilisons l'<strong>heuristique</strong> suivante sur les opérateurs de <strong>répétition</strong> : <code>*</code> répétera <code>0</code>, <code>1</code> et <code>2</code> fois, <code>+</code> répétera <code>1</code> et <code>2</code> fois, et enfin <code>{<em>x</em>,<em>y</em>}</code> répétera <code><em>x</em></code>, <code><em>x</em> + 1</code>, <code><em>y</em> - 1</code> et <code><em>y</em></code> fois. Cette heuristique trouve ses origines dans le test aux <strong>limites</strong>.</p> <p>Nous remarquons dans notre exemple que 4 données sont générées et suffisent à <strong>couvrir</strong> l'ensemble de notre grammaire !</p> <h4 id="Comparison_between_algorithms" for="main-toc">Comparaison entre les algorithmes</h4> <p>Voici quelques <strong>indices</strong> pour savoir quand utiliser tel ou tel autre algorithme.</p> <dl> <dt>Génération aléatoire et uniforme :</dt> <dd><ul> <li data-item="+">rapide pour des petites données, grande diversité dans les données et taille fixe ;</li> <li data-item="-">la phase de pré-calcul est exponentielle et donc longue bien que, ensuite, la génération soit très rapide.</li> </ul></dd> <dt>Génération exhaustive bornée :</dt> <dd><ul> <li data-item="+">rapide pour des petites données et l'exhaustivité est efficace ;</li> <li data-item="-">nombre exponentiel de données.</li> </ul></dd> <dt>Génération basée sur la couverture :</dt> <dd><ul> <li data-item="+">rapide pour des données de taille moyenne ou grande, et diversité des données ;</li> <li data-item="-">ne considère pas de taille.</li> </ul></dd> </dl> <h2 id="LL1_compiler-compiler" for="main-toc">Compilateur de compilateurs LL(1)</h2> <p>La documentation pour le compilateur LL(1), à travers la classe <code>Hoa\Compiler\Ll1</code>, n'est pas encore écrite. L'objectif est différent de <code>Hoa\Compiler\Llk</code> : il n'existe pas de langage intermédiaire, les automates sont codés en dur avec des tableaux et ce type de compilateurs est orienté haute performance. C'est pourquoi son comportement est <strong>monolithique</strong>.</p> <h2 id="Conclusion" for="main-toc">Conclusion</h2> <p><code>Hoa\Compiler</code> propose deux <strong>compilateurs de compilateurs</strong> : <code>Hoa\Compiler\Llk</code> et <code>Hoa\Compiler\Ll1</code>, afin de <strong>valider</strong> des données. Le <strong>langage PP</strong> permet d'écrire des <strong>grammaires algébriques</strong> de manière <strong>simple</strong> et <strong>naturelle</strong>. Le compilateur de compilateurs LL(<em>k</em>) est découpé en <strong>processus distincts</strong> ce qui le rend très <em lang="en">hackable</em>. Enfin, différents algorithmes permettent de <strong>générer</strong> des données à partir d'une grammaire selon le contexte d'utilisation.</p> </yield> </overlay> <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Compiler\Exception; use Hoa\Consistency; use Hoa\Exception\Exception as HoaException; /** * Class \Hoa\Compiler\Exception. * * Extending the \Hoa\Exception\Exception class. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Exception extends HoaException { } /** * Flex entity. */ Consistency::flexEntity('Hoa\\Compiler\\Exception\\Exception'); <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Compiler\Exception; /** * Class \Hoa\Compiler\Exception\IllegalToken. * * Extending the \Hoa\Compiler\Exception class. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class IllegalToken extends \Hoa\Compiler\Exception\Exception { /** * Column. * * @var int */ protected $column = 0; /** * Override line and add column support. * * @param string $message Formatted message. * @param int $code Code (the ID). * @param array $arg RaiseError string arguments. * @param int $line Line. * @param int $column Column. */ public function __construct($message, $code, $arg, $line, $column) { parent::__construct($message, $code, $arg); $this->line = $line; $this->column = $column; return; } /** * Get column. * * @return int */ public function getColumn() { return $this->column; } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Compiler\Exception; /** * Class \Hoa\Compiler\Exception\FinalStateHasNotBeenReached. * * Extending the \Hoa\Compiler\Exception class. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Rule extends \Hoa\Compiler\Exception\Exception { } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Compiler\Exception; /** * Class \Hoa\Compiler\Exception\FinalStateHasNotBeenReached. * * Extending the \Hoa\Compiler\Exception class. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class FinalStateHasNotBeenReached extends \Hoa\Compiler\Exception\Exception { } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Compiler\Exception; /** * Class \Hoa\Compiler\Exception\UnexpectedToken. * * Extending the \Hoa\Compiler\Exception\UnrecognizedToken class. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class UnexpectedToken extends \Hoa\Compiler\Exception\UnrecognizedToken { } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Compiler\Exception; /** * Class \Hoa\Compiler\Exception\Lexer. * * Extending the \Hoa\Compiler\Exception class. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Lexer extends \Hoa\Compiler\Exception\Exception { } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Compiler\Exception; /** * Class \Hoa\Compiler\Exception\UnrecognizedToken. * * Extending the \Hoa\Compiler\Exception class. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class UnrecognizedToken extends \Hoa\Compiler\Exception\Exception { /** * Column. * * @var int */ protected $column = 0; /** * Override line and add column support. * * @param string $message Formatted message. * @param int $code Code (the ID). * @param array $arg RaiseError string arguments. * @param int $line Line. * @param int $column Column. */ public function __construct($message, $code, $arg, $line, $column) { parent::__construct($message, $code, $arg); $this->line = $line; $this->column = $column; return; } /** * Get column. * * @return int */ public function getColumn() { return $this->column; } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Compiler\Visitor; use Hoa\Visitor; /** * Class \Hoa\Compiler\Visitor\Dump. * * Dump AST produced by LL(k) compiler. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Dump implements Visitor\Visit { /** * Indentation depth. * * @var int */ protected static $_i = 0; /** * Visit an element. * * @param \Hoa\Visitor\Element $element Element to visit. * @param mixed &$handle Handle (reference). * @param mixed $eldnah Handle (not reference). * @return mixed */ public function visit(Visitor\Element $element, &$handle = null, $eldnah = null) { ++self::$_i; $out = \str_repeat('> ', self::$_i) . $element->getId(); if (null !== ($value = $element->getValue())) { $out .= '(' . ('default' !== $value['namespace'] ? $value['namespace'] . ':' : '') . $value['token'] . ', ' . $value['value'] . ')'; } $data = $element->getData(); if (!empty($data)) { $out .= ' ' . $this->dumpData($data); } $out .= "\n"; foreach ($element->getChildren() as $child) { $out .= $child->accept($this, $handle, $eldnah); } --self::$_i; return $out; } /** * Dump data. * * @param mixed $data Data. * @return string */ protected function dumpData($data) { $out = null; if (!\is_array($data)) { return $data; } foreach ($data as $key => $value) { $out .= '[' . $key . ' => ' . $this->dumpData($value) . ']'; } return $out; } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Compiler; /** * Define the __ constant, so useful in compiler :-). */ !\defined('_PHPStan_7d8742a37\\GO') and \define('_PHPStan_7d8742a37\\GO', 'GO'); !\defined('_PHPStan_7d8742a37\\__') and \define('_PHPStan_7d8742a37\\__', '__'); /** * Class \Hoa\Compiler\Ll1. * * Provide an abstract LL(1) compiler, based on sub-automata and stacks. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ abstract class Ll1 { /** * Initial line. * If we try to compile a code inside another code, the initial line would * not probably be 0. * * @var int */ protected $_initialLine = 0; /** * Tokens to skip (will be totally skip, no way to get it). * Tokens' rules could be apply here (i.e. normal and special tokens are * understood). * Example: * [ * '#\s+', // white spaces * '#//.*', // inline comment * '#/\*(.|\n)*\*\/' // block comment * ] * * @var array */ protected $_skip = []; /** * Tokens. * A token should be: * * simple, it means just a single char, e.g. ':'; * * special, strings and/or a regular expressions, and must begin with * a sharp (#), e.g. '#foobar', '#[a-zA-Z]' or '#foo?bar'. * Note: if we want the token #, we should write '##'. * PCRE expressions are fully-supported. * We got an array of arrays because of sub-automata, one sub-array per * sub-automaton. * Example: * [ * [ * '{' // open brack * ], * [ * '"', // quote * ':', // semi-colon * ',', // comma * '{', // open bracket * '}' // close bracket * ], * [ * '#[a-z_\ \n]+", // id/string * '"' // quote * ] * ] * * @var array */ protected $_tokens = []; /** * States. * We got an array of arrays because of sub-automata, one sub-array per * sub-automaton. * Example: * [ * [ * __ , // error * 'GO', // start * 'OK' // terminal * ], * [ * __ , // error * 'GO', // start * 'KE', // key * 'CO', // colon * 'VA', // value * 'BL', // block * 'OK' // terminal * ], * [ * __ , // error * 'GO', // start * 'ST', // string * 'OK' // terminal * ] * ] * * Note: the constant GO or the string 'GO' must be used to represent the * initial state. * Note: the constant __ or the string '__' must be used to represent the * null/unrecognized/error state. * * @var array */ protected $_states = []; /** * Terminal states (defined in the states set). * We got an array of arrays because of sub-automata, one sub-array per * sub-automaton. * Example: * [ * ['OK'], * ['OK'], * ['OK'] * ] * * @var array */ protected $_terminal = []; /** * Transitions table. * It's actually a matrix, such as: TT(TOKENS × STATES). * We got an array of arrays because of sub-automata, one sub-array per * sub-automaton. * Example: * [ * [ * { * __ [ __ ], * GO ['OK'], * OK [ __ ], * ), * [ * " : , { } * __ [ __ , __ , __ , __ , __ ], * GO ['KE', __ , __ , __ , 'OK'], * KE [ __ , 'CO', __ , __ , __ ], * CO ['VA', __ , __ , 'BL', __ ], * VA [ __ , __ , 'GO', __ , 'OK'], * BL [ __ , __ , 'GO', __ , 'OK'], * OK [ __ , __ , __ , __ , __ ] * ], * [ * id " * __ [ __ , __ ], * GO ['ST', 'OK'], * ST [ __ , 'OK'], * OK [ __ , __ ] * ] * ) * * Note: tokens and states should be declared in the strict same order as * defined previously. * * @var array */ protected $_transitions = []; /** * Actions table. * It's actually a matrix, such as: AT(TOKENS × STATES). * We got an array of arrays because of sub-automata, one sub-array per * sub-automaton. * Example: * [ * [ * { * __ [ 0 ], * GO [ 0 ], * OK [ 2 ], * ], * [ * " : , { } * __ [ 0, 0 , 0 , 0 , 0 ], * GO [ 0, 0 , 0 , 0 , 'd'], * KE [ 3, 'k', 0 , 0 , 0 ], * CO [ 0, 0 , 0 , 'u', 0 ], * VA [ 3, 0 , 'v', 0 , 'x'], * BL [ 0, 0 , 0 , 2 , 'd'], * OK [ 0, 0 , 0 , 0 , 0 ] * ], * [ * id " * __ [ 0, 0 ], * GO [-1, 0 ], * ST [ 0, 0 ], * OK [ 0, 0 ] * ] * ] * * AT is filled with integer or char n. * If n is a char, it means an action. * If n < 0, it means a special action. * If n = 0, it means not action. * If n > 0, it means a link to a sub-automata (sub-automata index + 1). * * When we write our consume() method, it's just a simple switch receiving * an action. It receives only character. It's like a “goto” in our * compiler, and allows us to execute code when skiming through the graph. * * Negative/special actions are used to auto-fill or empty buffers. * E.g: -1 will fill the buffer 0, -2 will empty the buffer 0, * -3 will fill the buffer 1, -4 will empty the buffer 1, * -5 will fill the buffer 2, -6 will empty the buffer 2 etc. * A formula appears: * y = |x| * fill buffer (x - 2) / 2 if x & 1 = 1 * empty buffer (x - 1) / 2 if x & 1 = 0 * * Positive/link actions are used to make an epsilon-transition (or a link) * between two sub-automata. * Sub-automata are indexed from 0, but our links must be index + 1. Example * given: the sub-automata 0 in our example has a link to the sub-automata 1 * through OK[{] = 2. Take attention to this :-). * And another thing which must be carefully studying is the place of the * link. For example, with our sub-automata 1 (the big one), we have an * epsilon-transition to the sub-automata 2 through VA["] = 3. It means: * when we arrived in the state VA from the token ", we go in the * sub-automata 3 (the 2nd one actually). And when the linked sub-automata * has finished, we are back in our state and continue our parsing. Take * care of this :-). * * Finally, it is possible to combine positive and char action, separated by a comma. Thus: 7,f is equivalent to make an epsilon-transition to the * automata 7, then consume the action f. * * @var array */ protected $_actions = []; /** * Names of automata. */ protected $_names = []; /** * Recursive stack. * * @var array */ private $_stack = []; /** * Buffers. * * @var array */ protected $buffers = []; /** * Current token's line. * * @var int */ protected $line = 0; /** * Current token's column. * * @var int */ protected $column = 0; /** * Cache compiling result. * * @var array */ protected static $_cache = []; /** * Whether cache is enabled or not. * * @var bool */ protected static $_cacheEnabled = \true; /** * Singleton, and set parameters. * * @param array $skip Skip. * @param array $tokens Tokens. * @param array $states States. * @param array $terminal Terminal states. * @param array $transitions Transitions table. * @param array $actions Actions table. * @param array $names Names of automata. */ public function __construct(array $skip, array $tokens, array $states, array $terminal, array $transitions, array $actions, array $names = []) { $this->setSkip($skip); $this->setTokens($tokens); $this->setStates($states); $this->setTerminal($terminal); $this->setTransitions($transitions); $this->setActions($actions); $this->setNames($names); return; } /** * Compile a source code. * * @param string $in Source code. * @return void * @throws \Hoa\Compiler\Exception\FinalStateHasNotBeenReached * @throws \Hoa\Compiler\Exception\IllegalToken */ public function compile($in) { $cacheId = \md5($in); if (\true === self::$_cacheEnabled && \true === \array_key_exists($cacheId, self::$_cache)) { return self::$_cache[$cacheId]; } $d = 0; $c = 0; // current automata. $_skip = \array_flip($this->_skip); $_tokens = \array_flip($this->_tokens[$c]); $_states = \array_flip($this->_states[$c]); $_actions = [$c => 0]; $nextChar = null; $nextToken = 0; $nextState = $_states['GO']; $nextAction = $_states['GO']; $this->line = $this->getInitialLine(); $this->column = 0; $this->buffers = []; $line = $this->line; $column = $this->column; $this->pre($in); for ($i = 0, $max = \strlen($in); $i <= $max; $i++) { //echo "\n---\n\n"; // End of parsing (not automata). if ($i == $max) { while ($c > 0 && \in_array($this->_states[$c][$nextState], $this->_terminal[$c])) { list($c, $nextState, ) = \array_pop($this->_stack); } if (\in_array($this->_states[$c][$nextState], $this->_terminal[$c]) && 0 === $c && \true === $this->end()) { //echo '*********** END REACHED **********' . "\n"; if (\true === self::$_cacheEnabled) { self::$_cache[$cacheId] = $this->getResult(); } return \true; } throw new \Hoa\Compiler\Exception\FinalStateHasNotBeenReached('End of code has been reached but not correctly; ' . 'maybe your program is not complete?', 0); } $nextChar = $in[$i]; // Skip. if (isset($_skip[$nextChar])) { if ("\n" === $nextChar) { $line++; $column = 0; } else { $column++; } continue; } else { $continue = \false; $handle = \substr($in, $i); foreach ($_skip as $sk => $e) { if ($sk[0] != '#') { continue; } $sk = \str_replace('#', '\\#', \substr($sk, 1)); if (0 != \preg_match('#^(' . $sk . ')#u', $handle, $match)) { $strlen = \strlen($match[1]); if ($strlen > 0) { if (\false !== ($offset = \strrpos($match[1], "\n"))) { $column = $strlen - $offset - 1; } else { $column += $strlen; } $line += \substr_count($match[1], "\n"); $i += $strlen - 1; $continue = \true; break; } } } if (\true === $continue) { continue; } } // Epsilon-transition. $epsilon = \false; while (\array_key_exists($nextToken, $this->_actions[$c][$nextState]) && (\is_array($this->_actions[$c][$nextState][$nextToken]) && 0 < ($foo = $this->_actions[$c][$nextState][$nextToken][0]) || \is_int($this->_actions[$c][$nextState][$nextToken]) && 0 < ($foo = $this->_actions[$c][$nextState][$nextToken]))) { $epsilon = \true; if ($_actions[$c] == 0) { //echo '*** Change automata (up to ' . ($foo - 1) . ')' . "\n"; $this->_stack[$d] = [$c, $nextState, $nextToken]; \end($this->_stack); $c = $foo - 1; $_tokens = \array_flip($this->_tokens[$c]); $_states = \array_flip($this->_states[$c]); $nextState = $_states['GO']; $nextAction = $_states['GO']; $nextToken = 0; $_actions[$c] = 0; $d++; } elseif ($_actions[$c] == 2) { $_actions[$c] = 0; break; } } if (\true === $epsilon) { $epsilon = \false; $nextToken = \false; } // Token. if (isset($_tokens[$nextChar])) { $token = $nextChar; $nextToken = $_tokens[$token]; if ("\n" === $nextChar) { $line++; $column = 0; } else { $column++; } } else { $nextToken = \false; $handle = \substr($in, $i); foreach ($_tokens as $token => $e) { if ('#' !== $token[0]) { continue; } $ntoken = \str_replace('#', '\\#', \substr($token, 1)); if (0 != \preg_match('#^(' . $ntoken . ')#u', $handle, $match)) { $strlen = \strlen($match[1]); if ($strlen > 0) { if (\false !== ($offset = \strrpos($match[1], "\n"))) { $column = $strlen - $offset - 1; } else { $column += $strlen; } $nextChar = $match[1]; $nextToken = $e; $i += $strlen - 1; $line += \substr_count($match[1], "\n"); break; } } } } /* echo '>>> Automata ' . $c . "\n" . '>>> Next state ' . $nextState . "\n" . '>>> Token ' . $token . "\n" . '>>> Next char ' . $nextChar . "\n"; */ // Got it! if (\false !== $nextToken) { if (\is_array($this->_actions[$c][$nextState][$nextToken])) { $nextAction = $this->_actions[$c][$nextState][$nextToken][1]; } else { $nextAction = $this->_actions[$c][$nextState][$nextToken]; } $nextState = $_states[$this->_transitions[$c][$nextState][$nextToken]]; } // Oh :-(. if (\false === $nextToken || $nextState === $_states['__']) { $pop = \array_pop($this->_stack); $d--; // Go back to a parent automata. if (\in_array($this->_states[$c][$nextState], $this->_terminal[$c]) && null !== $pop || $nextState === $_states['__'] && null !== $pop) { //echo '!!! Change automata (down)' . "\n"; list($c, $nextState, $nextToken) = $pop; $_actions[$c] = 2; $i -= \strlen($nextChar); $_tokens = \array_flip($this->_tokens[$c]); $_states = \array_flip($this->_states[$c]); /* echo '!!! Automata ' . $c . "\n" . '!!! Next state ' . $nextState . "\n"; */ continue; } $error = \explode("\n", $in); $error = $error[$this->line]; throw new \Hoa\Compiler\Exception\IllegalToken('Illegal token at line ' . ($this->line + 1) . ' and column ' . ($this->column + 1) . "\n" . $error . "\n" . \str_repeat(' ', $this->column) . '↑', 1, [], $this->line + 1, $this->column + 1); } $this->line = $line; $this->column = $column; //echo '<<< Next state ' . $nextState . "\n"; $this->buffers[-1] = $nextChar; // Special actions. if ($nextAction < 0) { $buffer = \abs($nextAction); if (($buffer & 1) == 0) { $this->buffers[($buffer - 2) / 2] = null; } else { $buffer = ($buffer - 1) / 2; if (!isset($this->buffers[$buffer])) { $this->buffers[$buffer] = null; } $this->buffers[$buffer] .= $nextChar; } continue; } if (0 !== $nextAction) { $this->consume($nextAction); } } return; } /** * Consume actions. * Please, see the actions table definition to learn more. * * @param int $action Action. * @return void */ protected abstract function consume($action); /** * Compute source code before compiling it. * * @param string &$in Source code. * @return void */ protected function pre(&$in) { return; } /** * Verify compiler state when ending the source code. * * @return bool */ protected function end() { return \true; } /** * Get the result of the compiling. * * @return mixed */ public abstract function getResult(); /** * Set initial line. * * @param int $line Initial line. * @return int */ public function setInitialLine($line) { $old = $this->_initialLine; $this->_initialLine = $line; return $old; } /** * Set tokens to skip. * * @param array $skip Skip. * @return array */ public function setSkip(array $skip) { $old = $this->_skip; $this->_skip = $skip; return $old; } /** * Set tokens. * * @param array $tokens Tokens. * @return array */ public function setTokens(array $tokens) { $old = $this->_tokens; $this->_tokens = $tokens; return $old; } /** * Set states. * * @param array $states States. * @return array */ public function setStates(array $states) { $old = $this->_states; $this->_states = $states; return $old; } /** * Set terminal states. * * @param array $terminal Terminal states. * @return array */ public function setTerminal(array $terminal) { $old = $this->_terminal; $this->_terminal = $terminal; return $old; } /** * Set transitions table. * * @param array $transitions Transitions table. * @return array */ public function setTransitions(array $transitions) { $old = $this->_transitions; $this->_transitions = $transitions; return $old; } /** * Set actions table. * * @param array $actions Actions table. * @return array */ public function setActions(array $actions) { foreach ($actions as $e => $automata) { foreach ($automata as $i => $state) { foreach ($state as $j => $token) { if (0 != \preg_match('#^(\\d+),(.*)$#', $token, $matches)) { $actions[$e][$i][$j] = [(int) $matches[1], $matches[2]]; } } } } $old = $this->_actions; $this->_actions = $actions; return $old; } /** * Set names of automata. * * @param array $names Names of automata. * @return array */ public function setNames(array $names) { $old = $this->_names; $this->_names = $names; return $old; } /** * Get initial line. * * @return int */ public function getInitialLine() { return $this->_initialLine; } /** * Get skip tokens. * * @return array */ public function getSkip() { return $this->_skip; } /** * Get tokens. * * @return array */ public function getTokens() { return $this->_tokens; } /** * Get states. * * @return array */ public function getStates() { return $this->_states; } /** * Get terminal states. * * @return array */ public function getTerminal() { return $this->_terminal; } /** * Get transitions table. * * @return array */ public function getTransitions() { return $this->_transitions; } /** * Get actions table. * * @return array */ public function getActions() { return $this->_actions; } /** * Get names of automata. * * @return array */ public function getNames() { return $this->_names; } /** * Enable cache * * @return bool */ public static function enableCache() { $old = self::$_cacheEnabled; self::$_cacheEnabled = \true; return $old; } /** * Disable cache * * @return bool */ public static function disableCache() { $old = self::$_cacheEnabled; self::$_cacheEnabled = \false; return $old; } /** * Transform automatas into DOT language. * * @return void */ public function __toString() { $out = 'digraph ' . \str_replace('\\', '', \get_class($this)) . ' {' . "\n" . ' rankdir=LR;' . "\n" . ' label="Automata of ' . \str_replace('\\', '\\\\', \get_class($this)) . '";'; $transitions = \array_reverse($this->_transitions, \true); foreach ($transitions as $e => $automata) { $out .= "\n\n" . ' subgraph cluster_' . $e . ' {' . "\n" . ' label="Automata #' . $e . (isset($this->_names[$e]) ? ' (' . \str_replace('"', '\\"', $this->_names[$e]) . ')' : '') . '";' . "\n"; if (!empty($this->_terminal[$e])) { $out .= ' node[shape=doublecircle] "' . $e . '_' . \implode('" "' . $e . '_', $this->_terminal[$e]) . '";' . "\n"; } $out .= ' node[shape=circle];' . "\n"; foreach ($this->_states[$e] as $i => $state) { $name = []; $label = $state; if (__ != $state) { foreach ($this->_transitions[$e][$i] as $j => $foo) { $ep = $this->_actions[$e][$i][$j]; if (\is_array($ep)) { $ep = $ep[0]; } if (\is_int($ep)) { $ep--; if (0 < $ep && !isset($name[$ep])) { $name[$ep] = $ep; } } } if (!empty($name)) { $label .= ' (' . \implode(', ', $name) . ')'; } $out .= ' "' . $e . '_' . $state . '" ' . '[label="' . $label . '"];' . "\n"; } } foreach ($automata as $i => $transition) { $transition = \array_reverse($transition, \true); foreach ($transition as $j => $state) { if (__ != $this->_states[$e][$i] && __ != $state) { $label = \str_replace('\\', '\\\\', $this->_tokens[$e][$j]); $label = \str_replace('"', '\\"', $label); if ('#' === $label[0]) { $label = \substr($label, 1); } $out .= ' "' . $e . '_' . $this->_states[$e][$i] . '" -> "' . $e . '_' . $state . '"' . ' [label="' . $label . '"];' . "\n"; } } } $out .= ' node[shape=point,label=""] "' . $e . '_";' . "\n" . ' "' . $e . '_" -> "' . $e . '_GO";' . "\n" . ' }'; } $out .= "\n" . '}' . "\n"; return $out; } } This file was automatically generated by Composer Patches (https://github.com/cweagans/composer-patches) Patches applied to this directory: 0 Source: patches/HoaException.patch 1 Source: patches/Invocation.patch 2 Source: patches/Rule.patch 3 Source: patches/Lexer.patch 4 Source: patches/TreeNode.patch <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Compiler\Bin; use Hoa\Compiler; use Hoa\Consistency; use Hoa\Console; use Hoa\File; /** * Class Hoa\Compiler\Bin\Pp. * * Play with PP. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Pp extends Console\Dispatcher\Kit { /** * Options description. * * @var array */ protected $options = [['visitor', Console\GetOption::REQUIRED_ARGUMENT, 'v'], ['visitor-class', Console\GetOption::REQUIRED_ARGUMENT, 'c'], ['token-sequence', Console\GetOption::NO_ARGUMENT, 's'], ['trace', Console\GetOption::NO_ARGUMENT, 't'], ['help', Console\GetOption::NO_ARGUMENT, 'h'], ['help', Console\GetOption::NO_ARGUMENT, '?']]; /** * The entry method. * * @return int */ public function main() { $visitor = null; $tokenSequence = \false; $trace = \false; while (\false !== ($c = $this->getOption($v))) { switch ($c) { case 'v': switch (\strtolower($v)) { case 'dump': $visitor = 'Hoa\\Compiler\\Visitor\\Dump'; break; default: return $this->usage(); } break; case 'c': $visitor = \str_replace('.', '\\', $v); break; case 's': $tokenSequence = \true; break; case 't': $trace = \true; break; case '__ambiguous': $this->resolveOptionAmbiguity($v); break; case 'h': case '?': default: return $this->usage(); } } $this->parser->listInputs($grammar, $language); if (empty($grammar) || empty($language) && '0' !== $language) { return $this->usage(); } $compiler = Compiler\Llk::load(new File\Read($grammar)); $stream = new File\Read($language); $data = $stream->readAll(); try { $ast = $compiler->parse($data); } catch (Compiler\Exception $e) { if (\true === $tokenSequence) { $this->printTokenSequence($compiler, $data); echo "\n\n"; } throw $e; return 1; } if (\true === $tokenSequence) { $this->printTokenSequence($compiler, $data); echo "\n\n"; } if (\true === $trace) { $this->printTrace($compiler); echo "\n\n"; } if (null !== $visitor) { $visitor = Consistency\Autoloader::dnew($visitor); echo $visitor->visit($ast); } return; } /** * Print trace. * * @param \Hoa\Compiler\Llk\Parser $compiler Compiler. * @return void */ protected function printTrace(Compiler\Llk\Parser $compiler) { $i = 0; foreach ($compiler->getTrace() as $element) { if ($element instanceof Compiler\Llk\Rule\Entry) { $ruleName = $element->getRule(); $rule = $compiler->getRule($ruleName); echo \str_repeat('> ', ++$i), 'enter ', $ruleName; if (null !== ($id = $rule->getNodeId())) { echo ' (', $id, ')'; } echo "\n"; } elseif ($element instanceof Compiler\Llk\Rule\Token) { echo \str_repeat(' ', $i + 1), 'token ', $element->getTokenName(), ', consumed ', $element->getValue(), "\n"; } else { echo \str_repeat('< ', $i--), 'ekzit ', $element->getRule(), "\n"; } } return; } /** * Print token sequence. * * @param \Hoa\Compiler\Llk\Parser $compiler Compiler. * @param string $data Data to lex. * @return void */ protected function printTokenSequence(Compiler\Llk\Parser $compiler, $data) { $lexer = new Compiler\Llk\Lexer(); $sequence = $lexer->lexMe($data, $compiler->getTokens()); $format = '%' . (\strlen((string) \count($sequence)) + 1) . 's ' . '%-13s %-20s %s %6s' . "\n"; $header = \sprintf($format, '#', 'namespace', 'token name', 'token value ', 'offset'); echo $header, \str_repeat('-', \strlen($header)), "\n"; foreach ($sequence as $i => $token) { \printf($format, $i, $token['namespace'], $token['token'], (30 < $token['length'] ? \mb_substr($token['value'], 0, 29) . '…' : 'EOF' === $token['token']) ? \str_repeat(' ', 30) : $token['value'] . \str_repeat(' ', 30 - $token['length']), $token['offset']); } return; } /** * The command usage. * * @return int */ public function usage() { echo 'Usage : compiler:pp <options> [grammar.pp] [language]', "\n", 'Options :', "\n", $this->makeUsageOptionsList(['v' => 'Visitor name (only “dump” is supported).', 'c' => 'Visitor classname (using . instead of \\ works).', 's' => 'Print token sequence.', 't' => 'Print trace.', 'help' => 'This help.']), "\n"; return; } } __halt_compiler(); Compile and visit languages with grammars. <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Compiler\Llk; use Hoa\Compiler; use Hoa\Iterator; /** * Class \Hoa\Compiler\Llk\Parser. * * LL(k) parser. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Parser { /** * List of pragmas. * * @var array */ protected $_pragmas = null; /** * List of skipped tokens. * * @var array */ protected $_skip = null; /** * Associative array (token name => token regex), to be defined in * precedence order. * * @var array */ protected $_tokens = null; /** * Rules, to be defined as associative array, name => Rule object. * * @var array */ protected $_rules = null; /** * Lexer iterator. * * @var \Hoa\Iterator\Lookahead */ protected $_tokenSequence = null; /** * Possible token causing an error. * * @var array */ protected $_errorToken = null; /** * Trace of activated rules. * * @var array */ protected $_trace = []; /** * Stack of todo list. * * @var array */ protected $_todo = null; /** * AST. * * @var \Hoa\Compiler\Llk\TreeNode */ protected $_tree = null; /** * Current depth while building the trace. * * @var int */ protected $_depth = -1; /** * Construct the parser. * * @param array $tokens Tokens. * @param array $rules Rules. * @param array $pragmas Pragmas. */ public function __construct(array $tokens = [], array $rules = [], array $pragmas = []) { $this->_tokens = $tokens; $this->_rules = $rules; $this->_pragmas = $pragmas; return; } /** * Parse :-). * * @param string $text Text to parse. * @param string $rule The axiom, i.e. root rule. * @param bool $tree Whether build tree or not. * @return mixed * @throws \Hoa\Compiler\Exception\UnexpectedToken */ public function parse($text, $rule = null, $tree = \true) { $k = 1024; if (isset($this->_pragmas['parser.lookahead'])) { $k = \max(0, \intval($this->_pragmas['parser.lookahead'])); } $lexer = new \Hoa\Compiler\Llk\Lexer($this->_pragmas); $this->_tokenSequence = new Iterator\Buffer($lexer->lexMe($text, $this->_tokens), $k); $this->_tokenSequence->rewind(); $this->_errorToken = null; $this->_trace = []; $this->_todo = []; if (\false === \array_key_exists($rule, $this->_rules)) { $rule = $this->getRootRule(); } $closeRule = new \Hoa\Compiler\Llk\Rule\Ekzit($rule, 0); $openRule = new \Hoa\Compiler\Llk\Rule\Entry($rule, 0, [$closeRule]); $this->_todo = [$closeRule, $openRule]; do { $out = $this->unfold(); if (null !== $out && 'EOF' === $this->_tokenSequence->current()['token']) { break; } if (\false === $this->backtrack()) { $token = $this->_errorToken; if (null === $this->_errorToken) { $token = $this->_tokenSequence->current(); } $offset = $token['offset']; $line = 1; $column = 1; if (!empty($text)) { if (0 === $offset) { $leftnl = 0; } else { $leftnl = \strrpos($text, "\n", -(\strlen($text) - $offset) - 1) ?: 0; } $rightnl = \strpos($text, "\n", $offset); $line = \substr_count($text, "\n", 0, $leftnl + 1) + 1; $column = $offset - $leftnl + (0 === $leftnl); if (\false !== $rightnl) { $text = \trim(\substr($text, $leftnl, $rightnl - $leftnl), "\n"); } } throw new Compiler\Exception\UnexpectedToken('Unexpected token "%s" (%s) at line %d and column %d:' . "\n" . '%s' . "\n" . \str_repeat(' ', $column - 1) . '↑', 0, [$token['value'], $token['token'], $line, $column, $text], $line, $column); } } while (\true); if (\false === $tree) { return \true; } $tree = $this->_buildTree(); if (!$tree instanceof \Hoa\Compiler\Llk\TreeNode) { throw new Compiler\Exception('Parsing error: cannot build AST, the trace is corrupted.', 1); } return $this->_tree = $tree; } /** * Unfold trace. * * @return mixed */ protected function unfold() { while (0 < \count($this->_todo)) { $rule = \array_pop($this->_todo); if ($rule instanceof \Hoa\Compiler\Llk\Rule\Ekzit) { $rule->setDepth($this->_depth); $this->_trace[] = $rule; if (\false === $rule->isTransitional()) { --$this->_depth; } } else { $ruleName = $rule->getRule(); $next = $rule->getData(); $zeRule = $this->_rules[$ruleName]; $out = $this->_parse($zeRule, $next); if (\false === $out && \false === $this->backtrack()) { return null; } } } return \true; } /** * Parse current rule. * * @param \Hoa\Compiler\Llk\Rule $zeRule Current rule. * @param int $next Next rule index. * @return bool */ protected function _parse(\Hoa\Compiler\Llk\Rule $zeRule, $next) { if ($zeRule instanceof \Hoa\Compiler\Llk\Rule\Token) { $name = $this->_tokenSequence->current()['token']; if ($zeRule->getTokenName() !== $name) { return \false; } $value = $this->_tokenSequence->current()['value']; if (0 <= ($unification = $zeRule->getUnificationIndex())) { for ($skip = 0, $i = \count($this->_trace) - 1; $i >= 0; --$i) { $trace = $this->_trace[$i]; if ($trace instanceof \Hoa\Compiler\Llk\Rule\Entry) { if (\false === $trace->isTransitional()) { if ($trace->getDepth() <= $this->_depth) { break; } --$skip; } } elseif ($trace instanceof \Hoa\Compiler\Llk\Rule\Ekzit && \false === $trace->isTransitional()) { $skip += $trace->getDepth() > $this->_depth; } if (0 < $skip) { continue; } if ($trace instanceof \Hoa\Compiler\Llk\Rule\Token && $unification === $trace->getUnificationIndex() && $value !== $trace->getValue()) { return \false; } } } $namespace = $this->_tokenSequence->current()['namespace']; $zzeRule = clone $zeRule; $zzeRule->setValue($value); $zzeRule->setNamespace($namespace); if (isset($this->_tokens[$namespace][$name])) { $zzeRule->setRepresentation($this->_tokens[$namespace][$name]); } else { foreach ($this->_tokens[$namespace] as $_name => $regex) { if (\false === ($pos = \strpos($_name, ':'))) { continue; } $_name = \substr($_name, 0, $pos); if ($_name === $name) { break; } } $zzeRule->setRepresentation($regex); } \array_pop($this->_todo); $this->_trace[] = $zzeRule; $this->_tokenSequence->next(); $this->_errorToken = $this->_tokenSequence->current(); return \true; } elseif ($zeRule instanceof \Hoa\Compiler\Llk\Rule\Concatenation) { if (\false === $zeRule->isTransitional()) { ++$this->_depth; } $this->_trace[] = new \Hoa\Compiler\Llk\Rule\Entry($zeRule->getName(), 0, null, $this->_depth); $children = $zeRule->getChildren(); for ($i = \count($children) - 1; $i >= 0; --$i) { $nextRule = $children[$i]; $this->_todo[] = new \Hoa\Compiler\Llk\Rule\Ekzit($nextRule, 0); $this->_todo[] = new \Hoa\Compiler\Llk\Rule\Entry($nextRule, 0); } return \true; } elseif ($zeRule instanceof \Hoa\Compiler\Llk\Rule\Choice) { $children = $zeRule->getChildren(); if ($next >= \count($children)) { return \false; } if (\false === $zeRule->isTransitional()) { ++$this->_depth; } $this->_trace[] = new \Hoa\Compiler\Llk\Rule\Entry($zeRule->getName(), $next, $this->_todo, $this->_depth); $nextRule = $children[$next]; $this->_todo[] = new \Hoa\Compiler\Llk\Rule\Ekzit($nextRule, 0); $this->_todo[] = new \Hoa\Compiler\Llk\Rule\Entry($nextRule, 0); return \true; } elseif ($zeRule instanceof \Hoa\Compiler\Llk\Rule\Repetition) { $nextRule = $zeRule->getChildren(); if (0 === $next) { $name = $zeRule->getName(); $min = $zeRule->getMin(); if (\false === $zeRule->isTransitional()) { ++$this->_depth; } $this->_trace[] = new \Hoa\Compiler\Llk\Rule\Entry($name, $min, null, $this->_depth); \array_pop($this->_todo); $this->_todo[] = new \Hoa\Compiler\Llk\Rule\Ekzit($name, $min, $this->_todo); for ($i = 0; $i < $min; ++$i) { $this->_todo[] = new \Hoa\Compiler\Llk\Rule\Ekzit($nextRule, 0); $this->_todo[] = new \Hoa\Compiler\Llk\Rule\Entry($nextRule, 0); } return \true; } else { $max = $zeRule->getMax(); if (-1 != $max && $next > $max) { return \false; } $this->_todo[] = new \Hoa\Compiler\Llk\Rule\Ekzit($zeRule->getName(), $next, $this->_todo); $this->_todo[] = new \Hoa\Compiler\Llk\Rule\Ekzit($nextRule, 0); $this->_todo[] = new \Hoa\Compiler\Llk\Rule\Entry($nextRule, 0); return \true; } } return \false; } /** * Backtrack the trace. * * @return bool */ protected function backtrack() { $found = \false; do { $last = \array_pop($this->_trace); if ($last instanceof \Hoa\Compiler\Llk\Rule\Entry) { $zeRule = $this->_rules[$last->getRule()]; $found = $zeRule instanceof \Hoa\Compiler\Llk\Rule\Choice; } elseif ($last instanceof \Hoa\Compiler\Llk\Rule\Ekzit) { $zeRule = $this->_rules[$last->getRule()]; $found = $zeRule instanceof \Hoa\Compiler\Llk\Rule\Repetition; } elseif ($last instanceof \Hoa\Compiler\Llk\Rule\Token) { $this->_tokenSequence->previous(); if (\false === $this->_tokenSequence->valid()) { return \false; } } } while (0 < \count($this->_trace) && \false === $found); if (\false === $found) { return \false; } $rule = $last->getRule(); $next = $last->getData() + 1; $this->_depth = $last->getDepth(); $this->_todo = $last->getTodo(); $this->_todo[] = new \Hoa\Compiler\Llk\Rule\Entry($rule, $next); return \true; } /** * Build AST from trace. * Walk through the trace iteratively and recursively. * * @param int $i Current trace index. * @param array &$children Collected children. * @return \Hoa\Compiler\Llk\TreeNode */ protected function _buildTree($i = 0, &$children = []) { $max = \count($this->_trace); while ($i < $max) { $trace = $this->_trace[$i]; if ($trace instanceof \Hoa\Compiler\Llk\Rule\Entry) { $ruleName = $trace->getRule(); $rule = $this->_rules[$ruleName]; $isRule = \false === $trace->isTransitional(); $nextTrace = $this->_trace[$i + 1]; $id = $rule->getNodeId(); // Optimization: Skip empty trace sequence. if ($nextTrace instanceof \Hoa\Compiler\Llk\Rule\Ekzit && $ruleName == $nextTrace->getRule()) { $i += 2; continue; } if (\true === $isRule) { $children[] = $ruleName; } if (null !== $id) { $children[] = ['id' => $id, 'options' => $rule->getNodeOptions()]; } $i = $this->_buildTree($i + 1, $children); if (\false === $isRule) { continue; } $handle = []; $cId = null; $cOptions = []; do { $pop = \array_pop($children); if (\true === \is_object($pop)) { $handle[] = $pop; } elseif (\true === \is_array($pop) && null === $cId) { $cId = $pop['id']; $cOptions = $pop['options']; } elseif ($ruleName == $pop) { break; } } while (null !== $pop); if (null === $cId) { $cId = $rule->getDefaultId(); $cOptions = $rule->getDefaultOptions(); } if (null === $cId) { for ($j = \count($handle) - 1; $j >= 0; --$j) { $children[] = $handle[$j]; } continue; } if (\true === \in_array('M', $cOptions) && \true === $this->mergeTree($children, $handle, $cId)) { continue; } if (\true === \in_array('m', $cOptions) && \true === $this->mergeTree($children, $handle, $cId, \true)) { continue; } $cTree = new \Hoa\Compiler\Llk\TreeNode($id ?: $cId); foreach ($handle as $child) { $child->setParent($cTree); $cTree->prependChild($child); } $children[] = $cTree; } elseif ($trace instanceof \Hoa\Compiler\Llk\Rule\Ekzit) { return $i + 1; } else { if (\false === $trace->isKept()) { ++$i; continue; } $child = new \Hoa\Compiler\Llk\TreeNode('token', ['token' => $trace->getTokenName(), 'value' => $trace->getValue(), 'namespace' => $trace->getNamespace()]); $children[] = $child; ++$i; } } return $children[0]; } /** * Try to merge directly children into an existing node. * * @param array &$children Current children being gathering. * @param array &$handle Children of the new node. * @param string $cId Node ID. * @param bool $recursive Whether we should merge recursively or * not. * @return bool */ protected function mergeTree(&$children, &$handle, $cId, $recursive = \false) { \end($children); $last = \current($children); if (!\is_object($last)) { return \false; } if ($cId !== $last->getId()) { return \false; } if (\true === $recursive) { foreach ($handle as $child) { $this->mergeTreeRecursive($last, $child); } return \true; } foreach ($handle as $child) { $last->appendChild($child); $child->setParent($last); } return \true; } /** * Merge recursively. * Please, see self::mergeTree() to know the context. * * @param \Hoa\Compiler\Llk\TreeNode $node Node that receives. * @param \Hoa\Compiler\Llk\TreeNode $newNode Node to merge. * @return void */ protected function mergeTreeRecursive(\Hoa\Compiler\Llk\TreeNode $node, \Hoa\Compiler\Llk\TreeNode $newNode) { $nNId = $newNode->getId(); if ('token' === $nNId) { $node->appendChild($newNode); $newNode->setParent($node); return; } $children = $node->getChildren(); \end($children); $last = \current($children); if ($last->getId() !== $nNId) { $node->appendChild($newNode); $newNode->setParent($node); return; } foreach ($newNode->getChildren() as $child) { $this->mergeTreeRecursive($last, $child); } return; } /** * Get AST. * * @return \Hoa\Compiler\Llk\TreeNode */ public function getTree() { return $this->_tree; } /** * Get trace. * * @return array */ public function getTrace() { return $this->_trace; } /** * Get pragmas. * * @return array */ public function getPragmas() { return $this->_pragmas; } /** * Get tokens. * * @return array */ public function getTokens() { return $this->_tokens; } /** * Get the lexer iterator. * * @return \Hoa\Iterator\Buffer */ public function getTokenSequence() { return $this->_tokenSequence; } /** * Get rule by name. * * @param string $name Rule name. * @return \Hoa\Compiler\Llk\Rule */ public function getRule($name) { if (!isset($this->_rules[$name])) { return null; } return $this->_rules[$name]; } /** * Get rules. * * @return array */ public function getRules() { return $this->_rules; } /** * Get root rule. * * @return string */ public function getRootRule() { foreach ($this->_rules as $rule => $_) { if (!\is_int($rule)) { break; } } return $rule; } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Compiler\Llk; use Hoa\Visitor; /** * Class \Hoa\Compiler\Llk\TreeNode. * * Provide a generic node for the AST produced by LL(k) parser. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class TreeNode implements Visitor\Element { /** * ID (should be something like #ruleName or token). * * @var string */ protected $_id = null; /** * Value of the node (non-null for token nodes). * * @var array */ protected $_value = null; /** * Children. * * @var array */ protected $_children = null; /** * Parent. * * @var \Hoa\Compiler\Llk\TreeNode */ protected $_parent = null; /** * Attached data. * * @var array */ protected $_data = []; /** * Constructor. * * @param string $id ID. * @param array $value Value. * @param array $children Children. * @param \Hoa\Compiler\Llk\TreeNode $parent Parent. */ public function __construct($id, ?array $value = null, array $children = [], ?self $parent = null) { $this->setId($id); if (!empty($value)) { $this->setValue($value); } $this->setChildren($children); if (null !== $parent) { $this->setParent($parent); } return; } /** * Set ID. * * @param string $id ID. * @return string */ public function setId($id) { $old = $this->_id; $this->_id = $id; return $old; } /** * Get ID. * * @return string */ public function getId() { return $this->_id; } /** * Set value. * * @param array $value Value (token & value). * @return array */ public function setValue(array $value) { $old = $this->_value; $this->_value = $value; return $old; } /** * Get value. * * @return array */ public function getValue() { return $this->_value; } /** * Get value token. * * @return string */ public function getValueToken() { return isset($this->_value['token']) ? $this->_value['token'] : null; } /** * Get value value. * * @return string */ public function getValueValue() { return isset($this->_value['value']) ? $this->_value['value'] : null; } /** * Check if the node represents a token or not. * * @return bool */ public function isToken() { return !empty($this->_value); } /** * Prepend a child. * * @param \Hoa\Compiler\Llk\TreeNode $child Child. * @return \Hoa\Compiler\Llk\TreeNode */ public function prependChild(\Hoa\Compiler\Llk\TreeNode $child) { \array_unshift($this->_children, $child); return $this; } /** * Append a child. * * @param \Hoa\Compiler\Llk\TreeNode $child Child. * @return \Hoa\Compiler\Llk\TreeNode */ public function appendChild(\Hoa\Compiler\Llk\TreeNode $child) { $this->_children[] = $child; return $this; } /** * Set children. * * @param array $children Children. * @return array */ public function setChildren(array $children) { $old = $this->_children; $this->_children = $children; return $old; } /** * Get child. * * @param int $i Index. * @return \Hoa\Compiler\Llk\TreeNode */ public function getChild($i) { return \true === $this->childExists($i) ? $this->_children[$i] : null; } /** * Get children. * * @return array */ public function getChildren() { return $this->_children; } /** * Get number of children. * * @return int */ public function getChildrenNumber() { return \count($this->_children); } /** * Check if a child exists. * * @param int $i Index. * @return bool */ public function childExists($i) { return \array_key_exists($i, $this->_children); } /** * Set parent. * * @param \Hoa\Compiler\Llk\TreeNode $parent Parent. * @return \Hoa\Compiler\Llk\TreeNode */ public function setParent(\Hoa\Compiler\Llk\TreeNode $parent) { $old = $this->_parent; $this->_parent = $parent; return $old; } /** * Get parent. * * @return \Hoa\Compiler\Llk\TreeNode */ public function getParent() { return $this->_parent; } /** * Get data. * * @return array */ public function &getData() { return $this->_data; } /** * Accept a visitor. * * @param \Hoa\Visitor\Visit $visitor Visitor. * @param mixed &$handle Handle (reference). * @param mixed $eldnah Handle (no reference). * @return mixed */ public function accept(Visitor\Visit $visitor, &$handle = null, $eldnah = null) { return $visitor->visit($this, $handle, $eldnah); } /** * Remove circular reference to the parent (help the garbage collector). * * @return void */ public function __destruct() { unset($this->_parent); return; } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Compiler\Llk; use Hoa\Compiler; /** * Class \Hoa\Compiler\Llk\Lexer. * * Lexical analyser, i.e. split a string into a set of lexeme, i.e. tokens. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Lexer { /** * Lexer state. * * @var array */ protected $_lexerState = null; /** * Text. * * @var string */ protected $_text = null; /** * Tokens. * * @var array */ protected $_tokens = []; /** * Namespace stacks. * * @var \SplStack */ protected $_nsStack = null; /** * PCRE options. * * @var string */ protected $_pcreOptions = null; /** * Constructor. * * @param array $pragmas Pragmas. */ public function __construct(array $pragmas = []) { if (!isset($pragmas['lexer.unicode']) || \true === $pragmas['lexer.unicode']) { $this->_pcreOptions .= 'u'; } return; } /** * Text tokenizer: splits the text in parameter in an ordered array of * tokens. * * @param string $text Text to tokenize. * @param array $tokens Tokens to be returned. * @return \Generator * @throws \Hoa\Compiler\Exception\UnrecognizedToken */ public function lexMe($text, array $tokens) { $this->_text = $text; $this->_tokens = $tokens; $this->_nsStack = null; $offset = 0; $maxOffset = \strlen($this->_text); $this->_lexerState = 'default'; $stack = \false; foreach ($this->_tokens as &$tokens) { $_tokens = []; foreach ($tokens as $fullLexeme => $regex) { if (\false === \strpos($fullLexeme, ':')) { $_tokens[$fullLexeme] = [$regex, null]; continue; } list($lexeme, $namespace) = \explode(':', $fullLexeme, 2); $stack |= '__shift__' === \substr($namespace, 0, 9); unset($tokens[$fullLexeme]); $_tokens[$lexeme] = [$regex, $namespace]; } $tokens = $_tokens; } if (\true == $stack) { $this->_nsStack = new \SplStack(); } while ($offset < $maxOffset) { $nextToken = $this->nextToken($offset); if (null === $nextToken) { throw new Compiler\Exception\UnrecognizedToken('Unrecognized token "%s" at line 1 and column %d:' . "\n" . '%s' . "\n" . \str_repeat(' ', \mb_strlen(\substr($text, 0, $offset))) . '↑', 0, [\mb_substr(\substr($text, $offset), 0, 1), $offset + 1, $text], 1, $offset); } if (\true === $nextToken['keep']) { $nextToken['offset'] = $offset; (yield $nextToken); } $offset += \strlen($nextToken['value']); } (yield ['token' => 'EOF', 'value' => 'EOF', 'length' => 0, 'namespace' => 'default', 'keep' => \true, 'offset' => $offset]); } /** * Compute the next token recognized at the beginning of the string. * * @param int $offset Offset. * @return array * @throws \Hoa\Compiler\Exception\Lexer */ protected function nextToken($offset) { $tokenArray =& $this->_tokens[$this->_lexerState]; foreach ($tokenArray as $lexeme => $bucket) { list($regex, $nextState) = $bucket; if (null === $nextState) { $nextState = $this->_lexerState; } $out = $this->matchLexeme($lexeme, $regex, $offset); if (null !== $out) { $out['namespace'] = $this->_lexerState; $out['keep'] = 'skip' !== $lexeme; if ($nextState !== $this->_lexerState) { $shift = \false; if (null !== $this->_nsStack && 0 !== \preg_match('#^__shift__(?:\\s*\\*\\s*(\\d+))?$#', $nextState, $matches)) { $i = isset($matches[1]) ? \intval($matches[1]) : 1; if ($i > ($c = \count($this->_nsStack))) { throw new Compiler\Exception\Lexer('Cannot shift namespace %d-times, from token ' . '%s in namespace %s, because the stack ' . 'contains only %d namespaces.', 1, [$i, $lexeme, $this->_lexerState, $c]); } while (1 <= $i--) { $previousNamespace = $this->_nsStack->pop(); } $nextState = $previousNamespace; $shift = \true; } if (!isset($this->_tokens[$nextState])) { throw new Compiler\Exception\Lexer('Namespace %s does not exist, called by token %s ' . 'in namespace %s.', 2, [$nextState, $lexeme, $this->_lexerState]); } if (null !== $this->_nsStack && \false === $shift) { $this->_nsStack[] = $this->_lexerState; } $this->_lexerState = $nextState; } return $out; } } return null; } /** * Check if a given lexeme is matched at the beginning of the text. * * @param string $lexeme Name of the lexeme. * @param string $regex Regular expression describing the lexeme. * @param int $offset Offset. * @return array * @throws \Hoa\Compiler\Exception\Lexer */ protected function matchLexeme($lexeme, $regex, $offset) { $_regex = \str_replace('#', '\\#', $regex); $preg = \preg_match('#\\G(?|' . $_regex . ')#' . $this->_pcreOptions, $this->_text, $matches, 0, $offset); if (0 === $preg || $preg === \false) { return null; } if ('' === $matches[0]) { throw new Compiler\Exception\Lexer('A lexeme must not match an empty value, which is the ' . 'case of "%s" (%s).', 3, [$lexeme, $regex]); } return ['token' => $lexeme, 'value' => $matches[0], 'length' => \mb_strlen($matches[0])]; } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Compiler\Llk; use Hoa\Compiler; use Hoa\Consistency; use Hoa\Stream; /** * Class \Hoa\Compiler\Llk. * * This class provides a set of static helpers to manipulate (load and save) a * compiler more easily. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ abstract class Llk { /** * Load in-memory parser from a grammar description file. * The grammar description language is PP. See * `hoa://Library/Compiler/Llk/Llk.pp` for an example, or the documentation. * * @param \Hoa\Stream\IStream\In $stream Stream to read to grammar. * @return \Hoa\Compiler\Llk\Parser * @throws \Hoa\Compiler\Exception */ public static function load(Stream\IStream\In $stream) { $pp = $stream->readAll(); if (empty($pp)) { $message = 'The grammar is empty'; if ($stream instanceof Stream\IStream\Pointable) { if (0 < $stream->tell()) { $message .= ': The stream ' . $stream->getStreamName() . ' is pointable and not rewinded, maybe it ' . 'could be the reason'; } else { $message .= ': Nothing to read on the stream ' . $stream->getStreamName(); } } throw new Compiler\Exception($message . '.', 0); } static::parsePP($pp, $tokens, $rawRules, $pragmas, $stream->getStreamName()); $ruleAnalyzer = new \Hoa\Compiler\Llk\Rule\Analyzer($tokens); $rules = $ruleAnalyzer->analyzeRules($rawRules); return new \Hoa\Compiler\Llk\Parser($tokens, $rules, $pragmas); } /** * Save in-memory parser to PHP code. * The generated PHP code will load the same in-memory parser. The state * will be reset. The parser will be saved as a class, named after * `$className`. To retrieve the parser, one must instanciate this class. * * @param \Hoa\Compiler\Llk\Parser $parser Parser to save. * @param string $className Parser classname. * @return string */ public static function save(\Hoa\Compiler\Llk\Parser $parser, $className) { $out = null; $outTokens = null; $outRules = null; $outPragmas = null; $outExtra = null; $escapeRuleName = function ($ruleName) use($parser) { if (\true == $parser->getRule($ruleName)->isTransitional()) { return $ruleName; } return '\'' . $ruleName . '\''; }; foreach ($parser->getTokens() as $namespace => $tokens) { $outTokens .= ' \'' . $namespace . '\' => [' . "\n"; foreach ($tokens as $tokenName => $tokenValue) { $outTokens .= ' \'' . $tokenName . '\' => \'' . \str_replace(['\'', '\\\\'], ['\\\'', '\\\\\\'], $tokenValue) . '\',' . "\n"; } $outTokens .= ' ],' . "\n"; } foreach ($parser->getRules() as $rule) { $arguments = []; // Name. $arguments['name'] = $escapeRuleName($rule->getName()); if ($rule instanceof \Hoa\Compiler\Llk\Rule\Token) { // Token name. $arguments['tokenName'] = '\'' . $rule->getTokenName() . '\''; } else { if ($rule instanceof \Hoa\Compiler\Llk\Rule\Repetition) { // Minimum. $arguments['min'] = $rule->getMin(); // Maximum. $arguments['max'] = $rule->getMax(); } // Children. $ruleChildren = $rule->getChildren(); if (null === $ruleChildren) { $arguments['children'] = 'null'; } elseif (\false === \is_array($ruleChildren)) { $arguments['children'] = $escapeRuleName($ruleChildren); } else { $arguments['children'] = '[' . \implode(', ', \array_map($escapeRuleName, $ruleChildren)) . ']'; } } // Node ID. $nodeId = $rule->getNodeId(); if (null === $nodeId) { $arguments['nodeId'] = 'null'; } else { $arguments['nodeId'] = '\'' . $nodeId . '\''; } if ($rule instanceof \Hoa\Compiler\Llk\Rule\Token) { // Unification. $arguments['unification'] = $rule->getUnificationIndex(); // Kept. $arguments['kept'] = $rule->isKept() ? 'true' : 'false'; } // Default node ID. if (null !== ($defaultNodeId = $rule->getDefaultId())) { $defaultNodeOptions = $rule->getDefaultOptions(); if (!empty($defaultNodeOptions)) { $defaultNodeId .= ':' . \implode('', $defaultNodeOptions); } $outExtra .= "\n" . ' $this->getRule(' . $arguments['name'] . ')->setDefaultId(' . '\'' . $defaultNodeId . '\'' . ');'; } // PP representation. if (null !== ($ppRepresentation = $rule->getPPRepresentation())) { $outExtra .= "\n" . ' $this->getRule(' . $arguments['name'] . ')->setPPRepresentation(' . '\'' . \str_replace('\'', '\\\'', $ppRepresentation) . '\'' . ');'; } $outRules .= "\n" . ' ' . $arguments['name'] . ' => new \\' . \get_class($rule) . '(' . \implode(', ', $arguments) . '),'; } foreach ($parser->getPragmas() as $pragmaName => $pragmaValue) { $outPragmas .= "\n" . ' \'' . $pragmaName . '\' => ' . (\is_bool($pragmaValue) ? \true === $pragmaValue ? 'true' : 'false' : (\is_int($pragmaValue) ? $pragmaValue : '\'' . $pragmaValue . '\'')) . ','; } $out .= 'class ' . $className . ' extends \\Hoa\\Compiler\\Llk\\Parser' . "\n" . '{' . "\n" . ' public function __construct()' . "\n" . ' {' . "\n" . ' parent::__construct(' . "\n" . ' [' . "\n" . $outTokens . ' ],' . "\n" . ' [' . $outRules . "\n" . ' ],' . "\n" . ' [' . $outPragmas . "\n" . ' ]' . "\n" . ' );' . "\n" . $outExtra . "\n" . ' }' . "\n" . '}' . "\n"; return $out; } /** * Parse the grammar description language. * * @param string $pp Grammar description. * @param array $tokens Extracted tokens. * @param array $rules Extracted raw rules. * @param array $pragmas Extracted raw pragmas. * @param string $streamName The name of the stream containing the grammar. * @return void * @throws \Hoa\Compiler\Exception */ public static function parsePP($pp, &$tokens, &$rules, &$pragmas, $streamName) { $lines = \explode("\n", $pp); $pragmas = []; $tokens = ['default' => []]; $rules = []; for ($i = 0, $m = \count($lines); $i < $m; ++$i) { $line = \rtrim($lines[$i]); if (0 === \strlen($line) || '//' == \substr($line, 0, 2)) { continue; } if ('%' == $line[0]) { if (0 !== \preg_match('#^%pragma\\h+([^\\h]+)\\h+(.*)$#u', $line, $matches)) { switch ($matches[2]) { case 'true': $pragmaValue = \true; break; case 'false': $pragmaValue = \false; break; default: if (\true === \ctype_digit($matches[2])) { $pragmaValue = \intval($matches[2]); } else { $pragmaValue = $matches[2]; } } $pragmas[$matches[1]] = $pragmaValue; } elseif (0 !== \preg_match('#^%skip\\h+(?:([^:]+):)?([^\\h]+)\\h+(.*)$#u', $line, $matches)) { if (empty($matches[1])) { $matches[1] = 'default'; } if (!isset($tokens[$matches[1]])) { $tokens[$matches[1]] = []; } if (!isset($tokens[$matches[1]]['skip'])) { $tokens[$matches[1]]['skip'] = $matches[3]; } else { $tokens[$matches[1]]['skip'] = '(?:' . $tokens[$matches[1]]['skip'] . '|' . $matches[3] . ')'; } } elseif (0 !== \preg_match('#^%token\\h+(?:([^:]+):)?([^\\h]+)\\h+(.*?)(?:\\h+->\\h+(.*))?$#u', $line, $matches)) { if (empty($matches[1])) { $matches[1] = 'default'; } if (isset($matches[4]) && !empty($matches[4])) { $matches[2] = $matches[2] . ':' . $matches[4]; } if (!isset($tokens[$matches[1]])) { $tokens[$matches[1]] = []; } $tokens[$matches[1]][$matches[2]] = $matches[3]; } else { throw new Compiler\Exception('Unrecognized instructions:' . "\n" . ' %s' . "\n" . 'in file %s at line %d.', 1, [$line, $streamName, $i + 1]); } continue; } $ruleName = \substr($line, 0, -1); $rule = null; ++$i; while ($i < $m && isset($lines[$i][0]) && (' ' === $lines[$i][0] || "\t" === $lines[$i][0] || '//' === \substr($lines[$i], 0, 2))) { if ('//' === \substr($lines[$i], 0, 2)) { ++$i; continue; } $rule .= ' ' . \trim($lines[$i++]); } if (isset($lines[$i][0])) { --$i; } $rules[$ruleName] = $rule; } return; } } /** * Flex entity. */ Consistency::flexEntity('Hoa\\Compiler\\Llk\\Llk'); <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Compiler\Llk\Sampler; use Hoa\Compiler; use Hoa\Consistency; use Hoa\Visitor; /** * Class \Hoa\Compiler\Llk\Sampler. * * Sampler parent. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ abstract class Sampler { /** * Compiler. * * @var \Hoa\Compiler\Llk\Parser */ protected $_compiler = null; /** * Tokens. * * @var array */ protected $_tokens = null; /** * All rules (from the compiler). * * @var array */ protected $_rules = null; /** * Token sampler. * * @var \Hoa\Visitor\Visit */ protected $_tokenSampler = null; /** * Root rule name. * * @var string */ protected $_rootRuleName = null; /** * Current token namespace. * * @var string */ protected $_currentNamespace = 'default'; /** * Skip tokens AST. * * @var array */ protected $_skipTokenAST = []; /** * Construct a generator. * * @param \Hoa\Compiler\Llk\Parser $compiler Compiler/parser. * @param \Hoa\Visitor\Visit $tokenSampler Token sampler. */ public function __construct(Compiler\Llk\Parser $compiler, Visitor\Visit $tokenSampler) { $this->_compiler = $compiler; $this->_tokens = $compiler->getTokens(); $this->_rules = $compiler->getRules(); $this->_tokenSampler = $tokenSampler; $this->_rootRuleName = $compiler->getRootRule(); return; } /** * Get compiler. * * @return \Hoa\Compiler\Llk\Parser */ public function getCompiler() { return $this->_compiler; } /** * Get the AST of the current namespace skip token. * * @return \Hoa\Compiler\Llk\TreeNode */ protected function getSkipTokenAST() { if (!isset($this->_skipTokenAST[$this->_currentNamespace])) { $token = new Compiler\Llk\Rule\Token(-1, 'skip', null, -1); $token->setRepresentation($this->_tokens[$this->_currentNamespace]['skip']); $this->_skipTokenAST[$this->_currentNamespace] = $token->getAST(); } return $this->_skipTokenAST[$this->_currentNamespace]; } /** * Complete a token (namespace and representation). * It returns the next namespace. * * @param \Hoa\Compiler\Llk\Rule\Token $token Token. * @return string */ protected function completeToken(Compiler\Llk\Rule\Token $token) { if (null !== $token->getRepresentation()) { return $this->_currentNamespace; } $name = $token->getTokenName(); $token->setNamespace($this->_currentNamespace); $toNamespace = $this->_currentNamespace; if (isset($this->_tokens[$this->_currentNamespace][$name])) { $token->setRepresentation($this->_tokens[$this->_currentNamespace][$name]); } else { foreach ($this->_tokens[$this->_currentNamespace] as $_name => $regex) { if (\false === \strpos($_name, ':')) { continue; } list($_name, $toNamespace) = \explode(':', $_name, 2); if ($_name === $name) { break; } } $token->setRepresentation($regex); } return $toNamespace; } /** * Set current token namespace. * * @param string $namespace Token namespace. * @return string */ protected function setCurrentNamespace($namespace) { $old = $this->_currentNamespace; $this->_currentNamespace = $namespace; return $old; } /** * Generate a token value. * Complete and set next token namespace. * * @param \Hoa\Compiler\Llk\Rule\Token $token Token. * @return string */ protected function generateToken(Compiler\Llk\Rule\Token $token) { $toNamespace = $this->completeToken($token); $this->setCurrentNamespace($toNamespace); $out = $this->_tokenSampler->visit($token->getAST()); if (isset($this->_tokens[$this->_currentNamespace]['skip'])) { $out .= $this->_tokenSampler->visit($this->getSkipTokenAST()); } return $out; } } /** * Flex entity. */ Consistency::flexEntity('Hoa\\Compiler\\Llk\\Sampler\\Sampler'); <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Compiler\Llk\Sampler; use Hoa\Compiler; /** * Class \Hoa\Compiler\Llk\Sampler\Exception. * * Extending the \Hoa\Compiler\Exception class. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Exception extends Compiler\Exception { } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Compiler\Llk\Sampler; use Hoa\Compiler; use Hoa\Iterator; /** * Class \Hoa\Compiler\Llk\Sampler\Coverage. * * This generator aims at producing data that activate all the branches of the * grammar rules. * A rule is said to be covered if and only if its sub-rules have all been * covered. A token is said to be covered if it has been successfully used in a * data generation. * To ensure diversity, a random choice is made amongst the remaining sub-rules * of a choice-point to cover. * Finally, we use boundary test generation heuristics to avoid combinatorial * explosion and guarantee the termination, i.e. we bound repetition operators * as follow: * • * is bounded to 0, 1 or 2; * • + is unfolded 1 or 2 times; * • {x,y} is unfolded x, x + 1, y - 1 and y times. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Coverage extends \Hoa\Compiler\Llk\Sampler\Sampler implements Iterator { /** * Stack of rules to explore. * * @var array */ protected $_todo = null; /** * Stack of rules that have already been covered. * * @var array */ protected $_trace = null; /** * Produced test cases. * * @var array */ protected $_tests = null; /** * Covered rules: ruleName to structure that contains the choice point and * 0 for uncovered, 1 for covered, -1 for failed and .5 for in progress. * * @var array */ protected $_coveredRules = null; /** * Current iterator key. * * @var int */ protected $_key = -1; /** * Current iterator value. * * @var string */ protected $_current = null; /** * Get the current iterator value. * * @return string */ public function current() { return $this->_current; } /** * Get the current iterator key. * * @return int */ public function key() { return $this->_key; } /** * Useless here. * * @return void */ public function next() { return; } /** * Rewind the internal iterator pointer. * * @return void */ public function rewind() { $this->_key = -1; $this->_current = null; $this->_tests = []; $this->_coveredRules = []; foreach ($this->_rules as $name => $rule) { $this->_coveredRules[$name] = []; if ($rule instanceof Compiler\Llk\Rule\Repetition) { $min = $rule->getMin(); $min1 = $min + 1; $max = -1 == $rule->getMax() ? 2 : $rule->getMax(); $max1 = $max - 1; if ($min == $max) { $this->_coveredRules[$name][$min] = 0; } else { $this->_coveredRules[$name][$min] = 0; $this->_coveredRules[$name][$min1] = 0; $this->_coveredRules[$name][$max1] = 0; $this->_coveredRules[$name][$max] = 0; } } elseif ($rule instanceof Compiler\Llk\Rule\Choice) { for ($i = 0, $max = \count($rule->getChildren()); $i < $max; ++$i) { $this->_coveredRules[$name][$i] = 0; } } else { $this->_coveredRules[$name][0] = 0; } } return; } /** * Compute the current iterator value, i.e. generate a new solution. * * @return bool */ public function valid() { $ruleName = $this->_rootRuleName; if (\true !== \in_array(0, $this->_coveredRules[$ruleName]) && \true !== \in_array(0.5, $this->_coveredRules[$ruleName])) { return \false; } $this->_trace = []; $this->_todo = [new Compiler\Llk\Rule\Entry($ruleName, $this->_coveredRules)]; $result = $this->unfold(); if (\true !== $result) { return \false; } $handle = null; foreach ($this->_trace as $trace) { if ($trace instanceof Compiler\Llk\Rule\Token) { $handle .= $this->generateToken($trace); } } ++$this->_key; $this->_current = $handle; $this->_tests[] = $this->_trace; foreach ($this->_coveredRules as $key => $value) { foreach ($value as $k => $v) { if (-1 == $v) { $this->_coveredRules[$key][$k] = 0; } } } return \true; } /** * Unfold rules from the todo stack. * * @return bool */ protected function unfold() { while (0 < \count($this->_todo)) { $pop = \array_pop($this->_todo); if ($pop instanceof Compiler\Llk\Rule\Ekzit) { $this->_trace[] = $pop; $this->updateCoverage($pop); } else { $out = $this->coverage($this->_rules[$pop->getRule()]); if (\true !== $out && \true !== $this->backtrack()) { return \false; } } } return \true; } /** * The coverage algorithm. * * @param \Hoa\Compiler\Llk\Rule $rule Rule to cover. * @return bool */ protected function coverage(Compiler\Llk\Rule $rule) { $children = $rule->getChildren(); if ($rule instanceof Compiler\Llk\Rule\Repetition) { $uncovered = []; $inprogress = []; $already = []; foreach ($this->_coveredRules[$rule->getName()] as $child => $value) { if (0 == $value || 0.5 == $value) { $uncovered[] = $child; } elseif (-1 == $value) { $inprogress[] = $child; } else { $already[] = $child; } } if (empty($uncovered)) { if (empty($already)) { $rand = $inprogress[\rand(0, \count($inprogress) - 1)]; } else { $rand = $already[\rand(0, \count($already) - 1)]; } $this->_trace[] = new Compiler\Llk\Rule\Entry($rule->getName(), $this->_coveredRules, $this->_todo); $this->_todo[] = new Compiler\Llk\Rule\Ekzit($rule->getName(), $rand); if ($this->_rules[$children] instanceof Compiler\Llk\Rule\Token) { for ($i = 0; $i < $rand; ++$i) { $this->_todo[] = new Compiler\Llk\Rule\Entry($children, $this->_coveredRules, $this->_todo); } } else { $sequence = $this->extract([$children]); if (null === $sequence) { return null; } for ($i = 0; $i < $rand; ++$i) { foreach ($sequence as $seq) { $this->_trace[] = $seq; if ($seq instanceof Compiler\Llk\Rule\Ekzit) { $this->updateCoverage($seq); } } } } } else { $rand = $uncovered[\rand(0, \count($uncovered) - 1)]; $this->_coveredRules[$rule->getName()][$rand] = -1; $this->_trace[] = new Compiler\Llk\Rule\Entry($rule->getName(), $this->_coveredRules, $this->_todo); $this->_todo[] = new Compiler\Llk\Rule\Ekzit($rule->getName(), $rand); for ($i = 0; $i < $rand; ++$i) { $this->_todo[] = new Compiler\Llk\Rule\Entry($children, $this->_coveredRules, $this->_todo); } } return \true; } elseif ($rule instanceof Compiler\Llk\Rule\Choice) { $uncovered = []; $inprogress = []; $already = []; foreach ($this->_coveredRules[$rule->getName()] as $child => $value) { if (0 == $value || 0.5 == $value) { $uncovered[] = $child; } elseif (-1 == $value) { $inprogress[] = $child; } else { $already[] = $child; } } if (empty($uncovered)) { $this->_trace[] = new Compiler\Llk\Rule\Entry($rule->getName(), $this->_coveredRules, $this->_todo); $sequence = $this->extract($children); if (null === $sequence) { return null; } foreach ($sequence as $seq) { $this->_trace[] = $seq; if ($seq instanceof Compiler\Llk\Rule\Ekzit) { $this->updateCoverage($seq); } } if (empty($already)) { $rand = $inprogress[\rand(0, \count($inprogress) - 1)]; } else { $rand = $already[\rand(0, \count($already) - 1)]; } $this->_todo[] = new Compiler\Llk\Rule\Ekzit($rule->getName(), $rand); } else { $rand = $uncovered[\rand(0, \count($uncovered) - 1)]; $this->_trace[] = new Compiler\Llk\Rule\Entry($rule->getName(), $this->_coveredRules, $this->_todo); $this->_coveredRules[$rule->getName()][$rand] = -1; $this->_todo[] = new Compiler\Llk\Rule\Ekzit($rule->getName(), $rand); $this->_todo[] = new Compiler\Llk\Rule\Entry($children[$rand], $this->_coveredRules, $this->_todo); } return \true; } elseif ($rule instanceof Compiler\Llk\Rule\Concatenation) { $this->_coveredRules[$rule->getName()][0] = -1; $this->_trace[] = new Compiler\Llk\Rule\Entry($rule->getName(), \false); $this->_todo[] = new Compiler\Llk\Rule\Ekzit($rule->getName(), \false); for ($i = \count($children) - 1; $i >= 0; --$i) { $this->_todo[] = new Compiler\Llk\Rule\Entry($children[$i], \false, $this->_todo); } return \true; } elseif ($rule instanceof Compiler\Llk\Rule\Token) { $this->_trace[] = new Compiler\Llk\Rule\Entry($rule->getName(), \false); $this->_trace[] = $rule; $this->_todo[] = new Compiler\Llk\Rule\Ekzit($rule->getName(), \false); return \true; } return \false; } /** * Extract a given sequence from existing traces. * * @param array $rules Rules to consider. * @return array */ protected function extract(array $rules) { $out = []; foreach ($rules as $rule) { foreach ($this->_tests as $test) { $opened = 0; foreach ($test as $t) { if ($t instanceof Compiler\Llk\Rule\Entry && $t->getRule() == $rule) { ++$opened; } if (0 < $opened) { $out[] = $t; if ($t instanceof Compiler\Llk\Rule\Ekzit && $t->getRule() == $rule) { --$opened; if (0 === $opened) { return $out; } } } } } } foreach ($rules as $rule) { $out = []; $closed = 0; foreach ($this->_trace as $t) { if ($t instanceof Compiler\Llk\Rule\Ekzit && $t->getRule() == $rule) { ++$closed; } if (0 < $closed) { $out[] = $t; if ($t instanceof Compiler\Llk\Rule\Ekzit && $t->getRule() == $rule) { --$closed; if (0 === $closed) { return \array_reverse($out); } } } } } return null; } /** * Backtrack to the previous choice-point. * * @return bool */ protected function backtrack() { $found = \false; do { $pop = \array_pop($this->_trace); if ($pop instanceof Compiler\Llk\Rule\Entry) { $rule = $this->_rules[$pop->getRule()]; $found = $rule instanceof Compiler\Llk\Rule\Choice || $rule instanceof Compiler\Llk\Rule\Repetition; } } while (0 < \count($this->_trace) && \false === $found); if (\false === $found) { return \false; } $ruleName = $pop->getRule(); $this->_covered = $pop->getData(); $this->_todo = $pop->getTodo(); $this->_todo[] = new Compiler\Llk\Rule\Entry($ruleName, $this->_covered, $this->_todo); return \true; } /** * Update coverage of a rule. * * @param \Hoa\Compiler\Llk\Rule\Ekzit $rule Rule to consider. * @return void */ protected function updateCoverage(Compiler\Llk\Rule\Ekzit $Rule) { $ruleName = $Rule->getRule(); $child = $Rule->getData(); $rule = $this->_rules[$ruleName]; $children = $rule->getChildren(); if ($rule instanceof Compiler\Llk\Rule\Repetition) { if (0 === $child) { $this->_coveredRules[$ruleName][$child] = 1; } else { if (\true === $this->allCovered($children) || \true === $this->checkRuleRoot($children)) { $this->_coveredRules[$ruleName][$child] = 1; foreach ($this->_coveredRules[$ruleName] as $child => $value) { if (0.5 == $value) { $this->_coveredRules[$ruleName][$child] = 1; } } } else { $this->_coveredRules[$ruleName][$child] = 0.5; } } } elseif ($rule instanceof Compiler\Llk\Rule\Choice) { if (\true === $this->allCovered($children[$child]) || \true === $this->checkRuleRoot($children[$child])) { $this->_coveredRules[$ruleName][$child] = 1; } else { $this->_coveredRules[$ruleName][$child] = 0.5; } } elseif ($rule instanceof Compiler\Llk\Rule\Concatenation) { $isCovered = \true; for ($i = \count($children) - 1; $i >= 0 && \true === $isCovered; --$i) { if (\false === $this->allCovered($children[$i]) && \false === $this->checkRuleRoot($children[$i])) { $isCovered = \false; } } $this->_coveredRules[$ruleName][0] = \true === $isCovered ? 1 : 0.5; } elseif ($rule instanceof Compiler\Llk\Rule\Token) { $this->_coveredRules[$ruleName][0] = 1; } return; } /** * Check if all rules have been entirely covered. * * @param string $ruleName Rule name. * @return bool */ protected function allCovered($ruleName) { foreach ($this->_coveredRules[$ruleName] as $value) { if (1 !== $value) { return \false; } } return \true; } /** * Check if a rule is a root rule that is currently being processed. * * @param string $ruleName Rule name. * @return bool */ protected function checkRuleRoot($ruleName) { if (\true === $this->_rules[$ruleName]->isTransitional()) { return \false; } $i = \count($this->_trace) - 1; $nb = 0; while ($i >= 0) { $lastRule = $this->_trace[$i]; if ($lastRule instanceof Compiler\Llk\Rule\Entry) { if ($lastRule->getRule() == $ruleName) { ++$nb; } } elseif ($lastRule instanceof Compiler\Llk\Rule\Ekzit) { if ($lastRule->getRule() == $ruleName) { --$nb; } } --$i; } return 0 < $nb; } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Compiler\Llk\Sampler; use Hoa\Compiler; use Hoa\Iterator; use Hoa\Visitor; /** * Class \Hoa\Compiler\Llk\Sampler\BoundedExhaustive. * * This generator aims at producing all possible data (exhaustive) up to a given * size n (bounded). * This algorithm is based on multiset (set with repetition). * Repetition unfolding: upper bound of + and * is set to n. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class BoundedExhaustive extends \Hoa\Compiler\Llk\Sampler\Sampler implements Iterator { /** * Stack of rules to explore. * * @var array */ protected $_todo = null; /** * Stack of rules that have already been covered. * * @var array */ protected $_trace = null; /** * Current iterator key. * * @var int */ protected $_key = -1; /** * Current iterator value. * * @var string */ protected $_current = null; /** * Bound. * * @var int */ protected $_length = 5; /** * Construct a generator. * * @param \Hoa\Compiler\Llk\Parser $compiler Compiler/parser. * @param \Hoa\Visitor\Visit $tokenSampler Token sampler. * @param int $length Max data length. */ public function __construct(Compiler\Llk\Parser $compiler, Visitor\Visit $tokenSampler, $length = 5) { parent::__construct($compiler, $tokenSampler); $this->setLength($length); return; } /** * Get the current iterator value. * * @return string */ public function current() { return $this->_current; } /** * Get the current iterator key. * * @return int */ public function key() { return $this->_key; } /** * Useless here. * * @return void */ public function next() { return; } /** * Rewind the internal iterator pointer. * * @return void */ public function rewind() { $ruleName = $this->_rootRuleName; $this->_current = null; $this->_key = -1; $this->_trace = []; $handle = new Compiler\Llk\Rule\Ekzit($ruleName, 0); $this->_todo = [$handle, new Compiler\Llk\Rule\Entry($ruleName, 0, [$handle])]; return; } /** * Compute the current iterator value, i.e. generate a new solution. * * @return bool */ public function valid() { if (\false === $this->unfold()) { return \false; } $handle = null; foreach ($this->_trace as $trace) { if ($trace instanceof Compiler\Llk\Rule\Token) { $handle .= $this->generateToken($trace); } } ++$this->_key; $this->_current = $handle; return $this->backtrack(); } /** * Unfold rules from the todo stack. * * @return bool */ protected function unfold() { while (0 < \count($this->_todo)) { $pop = \array_pop($this->_todo); if ($pop instanceof Compiler\Llk\Rule\Ekzit) { $this->_trace[] = $pop; } else { $ruleName = $pop->getRule(); $next = $pop->getData(); $rule = $this->_rules[$ruleName]; $out = $this->boundedExhaustive($rule, $next); if (\true !== $out && \true !== $this->backtrack()) { return \false; } } } return \true; } /** * The bounded-exhaustive algorithm. * * @param \Hoa\Compiler\Llk\Rule $rule Rule to cover. * @param int $next Next rule. * @return bool */ protected function boundedExhaustive(Compiler\Llk\Rule $rule, $next) { $children = $rule->getChildren(); if ($rule instanceof Compiler\Llk\Rule\Repetition) { if (0 === $next) { $this->_trace[] = new Compiler\Llk\Rule\Entry($rule->getName(), $rule->getMin()); \array_pop($this->_todo); $this->_todo[] = new Compiler\Llk\Rule\Ekzit($rule->getName(), $rule->getMin(), $this->_todo); for ($i = 0, $min = $rule->getMin(); $i < $min; ++$i) { $this->_todo[] = new Compiler\Llk\Rule\Ekzit($children, 0); $this->_todo[] = new Compiler\Llk\Rule\Entry($children, 0); } } else { $nbToken = 0; foreach ($this->_trace as $trace) { if ($trace instanceof Compiler\Llk\Rule\Token) { ++$nbToken; } } $max = $rule->getMax(); if (-1 != $max && $next > $max) { return \false; } $this->_todo[] = new Compiler\Llk\Rule\Ekzit($rule->getName(), $next, $this->_todo); $this->_todo[] = new Compiler\Llk\Rule\Ekzit($children, 0); $this->_todo[] = new Compiler\Llk\Rule\Entry($children, 0); } return \true; } elseif ($rule instanceof Compiler\Llk\Rule\Choice) { if (\count($children) <= $next) { return \false; } $this->_trace[] = new Compiler\Llk\Rule\Entry($rule->getName(), $next, $this->_todo); $nextRule = $children[$next]; $this->_todo[] = new Compiler\Llk\Rule\Ekzit($nextRule, 0); $this->_todo[] = new Compiler\Llk\Rule\Entry($nextRule, 0); return \true; } elseif ($rule instanceof Compiler\Llk\Rule\Concatenation) { $this->_trace[] = new Compiler\Llk\Rule\Entry($rule->getName(), $next); for ($i = \count($children) - 1; $i >= 0; --$i) { $nextRule = $children[$i]; $this->_todo[] = new Compiler\Llk\Rule\Ekzit($nextRule, 0); $this->_todo[] = new Compiler\Llk\Rule\Entry($nextRule, 0); } return \true; } elseif ($rule instanceof Compiler\Llk\Rule\Token) { $nbToken = 0; foreach ($this->_trace as $trace) { if ($trace instanceof Compiler\Llk\Rule\Token) { ++$nbToken; } } if ($nbToken >= $this->getLength()) { return \false; } $this->_trace[] = $rule; \array_pop($this->_todo); return \true; } return \false; } /** * Backtrack to the previous choice-point. * * @return bool */ protected function backtrack() { $found = \false; do { $last = \array_pop($this->_trace); if ($last instanceof Compiler\Llk\Rule\Entry) { $rule = $this->_rules[$last->getRule()]; $found = $rule instanceof Compiler\Llk\Rule\Choice; } elseif ($last instanceof Compiler\Llk\Rule\Ekzit) { $rule = $this->_rules[$last->getRule()]; $found = $rule instanceof Compiler\Llk\Rule\Repetition; } } while (0 < \count($this->_trace) && \false === $found); if (\false === $found) { return \false; } $rule = $last->getRule(); $next = $last->getData() + 1; $this->_todo = $last->getTodo(); $this->_todo[] = new Compiler\Llk\Rule\Entry($rule, $next, $this->_todo); return \true; } /** * Set upper-bound, the maximum data length. * * @param int $length Length. * @return int * @throws \Hoa\Compiler\Exception */ public function setLength($length) { if (0 >= $length) { throw new \Hoa\Compiler\Llk\Sampler\Exception('Length must be greater than 0, given %d.', 0, $length); } $old = $this->_length; $this->_length = $length; return $old; } /** * Get upper-bound. * * @return int */ public function getLength() { return $this->_length; } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Compiler\Llk\Sampler; use Hoa\Compiler; use Hoa\Math; use Hoa\Visitor; /** * Class \Hoa\Compiler\Llk\Sampler\Uniform. * * This generator aims at producing random and uniform a sequence of a fixed * size. We use the recursive method to count all possible sub-structures of * size n. The counting helps to compute cumulative distribution functions, * which guide the exploration. * Repetition unfolding: upper bound of + and * is set to n. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Uniform extends \Hoa\Compiler\Llk\Sampler\Sampler { /** * Data (pre-computing). * * @var array */ protected $_data = []; /** * Bound. * * @var int */ protected $_length = 5; /** * Construct a generator. * * @param \Hoa\Compiler\Llk\Parser $compiler Compiler/parser. * @param \Hoa\Visitor\Visit $tokenSampler Token sampler. */ public function __construct(Compiler\Llk\Parser $compiler, Visitor\Visit $tokenSampler, $length = 5) { parent::__construct($compiler, $tokenSampler); foreach ($this->_rules as $name => $_) { $this->_data[$name] = []; } $this->setLength($length); $this->_sampler = new Math\Sampler\Random(); return; } /** * The random and uniform algorithm. * * @param \Hoa\Compiler\Llk\Rule $rule Rule to start. * @param int $n Size. * @return string */ public function uniform(Compiler\Llk\Rule $rule = null, $n = -1) { if (null === $rule && -1 === $n) { $rule = $this->_rules[$this->_rootRuleName]; $n = $this->getLength(); } $data =& $this->_data[$rule->getName()][$n]; $computed = $data['n']; if (0 === $n || 0 === $computed) { return null; } if ($rule instanceof Compiler\Llk\Rule\Choice) { $children = $rule->getChildren(); $stat = []; foreach ($children as $c => $child) { $stat[$c] = $this->_data[$child][$n]['n']; } $i = $this->_sampler->getInteger(1, $computed); for ($e = 0, $b = $stat[$e], $max = \count($stat) - 1; $e < $max && $i > $b; $b += $stat[++$e]) { } return $this->uniform($this->_rules[$children[$e]], $n); } elseif ($rule instanceof Compiler\Llk\Rule\Concatenation) { $children = $rule->getChildren(); $out = null; $Γ = $data['Γ']; $γ = $Γ[$this->_sampler->getInteger(0, \count($Γ) - 1)]; foreach ($children as $i => $child) { $out .= $this->uniform($this->_rules[$child], $γ[$i]); } return $out; } elseif ($rule instanceof Compiler\Llk\Rule\Repetition) { $out = null; $stat =& $data['xy']; $child = $this->_rules[$rule->getChildren()]; $b = 0; $i = $this->_sampler->getInteger(1, $computed); foreach ($stat as $α => $st) { if ($i <= ($b += $st['n'])) { break; } } $Γ =& $st['Γ']; $γ =& $Γ[$this->_sampler->getInteger(0, \count($Γ) - 1)]; for ($j = 0; $j < $α; ++$j) { $out .= $this->uniform($child, $γ[$j]); } return $out; } elseif ($rule instanceof Compiler\Llk\Rule\Token) { return $this->generateToken($rule); } return null; } /** * Recursive method applied to our problematic. * * @param \Hoa\Compiler\Llk\Rule $rule Rule to start. * @param int $n Size. * @return int */ public function count(Compiler\Llk\Rule $rule = null, $n = -1) { if (null === $rule || -1 === $n) { return 0; } $ruleName = $rule->getName(); if (isset($this->_data[$ruleName][$n])) { return $this->_data[$ruleName][$n]['n']; } $this->_data[$ruleName][$n] = ['n' => 0]; $out =& $this->_data[$ruleName][$n]['n']; $rule = $this->_rules[$ruleName]; if ($rule instanceof Compiler\Llk\Rule\Choice) { foreach ($rule->getChildren() as $child) { $out += $this->count($this->_rules[$child], $n); } } elseif ($rule instanceof Compiler\Llk\Rule\Concatenation) { $children = $rule->getChildren(); $Γ = new Math\Combinatorics\Combination\Gamma(\count($children), $n); $this->_data[$ruleName][$n]['Γ'] = []; $handle =& $this->_data[$ruleName][$n]['Γ']; foreach ($Γ as $γ) { $oout = 1; foreach ($γ as $α => $_γ) { $oout *= $this->count($this->_rules[$children[$α]], $_γ); } if (0 !== $oout) { $handle[] = $γ; } $out += $oout; } } elseif ($rule instanceof Compiler\Llk\Rule\Repetition) { $this->_data[$ruleName][$n]['xy'] = []; $handle =& $this->_data[$ruleName][$n]['xy']; $child = $this->_rules[$rule->getChildren()]; $x = $rule->getMin(); $y = $rule->getMax(); if (-1 === $y) { $y = $n; } else { $y = \min($n, $y); } if (0 === $x && $x === $y) { $out = 1; } else { for ($α = $x; $α <= $y; ++$α) { $ut = 0; $handle[$α] = ['n' => 0, 'Γ' => []]; $Γ = new Math\Combinatorics\Combination\Gamma($α, $n); foreach ($Γ as $γ) { $oout = 1; foreach ($γ as $β => $_γ) { $oout *= $this->count($child, $_γ); } if (0 !== $oout) { $handle[$α]['Γ'][] = $γ; } $ut += $oout; } $handle[$α]['n'] = $ut; $out += $ut; } } } elseif ($rule instanceof Compiler\Llk\Rule\Token) { $out = Math\Util::δ($n, 1); } return $out; } /** * Set upper-bound, the maximum data length. * * @param int $length Length. * @return int * @throws \Hoa\Compiler\Exception */ public function setLength($length) { if (0 >= $length) { throw new \Hoa\Compiler\Llk\Sampler\Exception('Length must be greater than 0, given %d.', 0, $length); } $old = $this->_length; $this->_length = $length; $this->count($this->_compiler->getRule($this->_rootRuleName), $length); return $old; } /** * Get upper-bound. * * @return int */ public function getLength() { return $this->_length; } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Compiler\Llk\Rule; use Hoa\Compiler; use Hoa\Iterator; /** * Class \Hoa\Compiler\Llk\Rule\Analyzer. * * Analyze rules and transform them into atomic rules operations. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Analyzer { /** * PP lexemes. */ protected static $_ppLexemes = ['default' => ['skip' => '\\s', 'or' => '\\|', 'zero_or_one' => '\\?', 'one_or_more' => '\\+', 'zero_or_more' => '\\*', 'n_to_m' => '\\{[0-9]+,[0-9]+\\}', 'zero_to_m' => '\\{,[0-9]+\\}', 'n_or_more' => '\\{[0-9]+,\\}', 'exactly_n' => '\\{[0-9]+\\}', 'skipped' => '::[a-zA-Z_][a-zA-Z0-9_]*(\\[\\d+\\])?::', 'kept' => '<[a-zA-Z_][a-zA-Z0-9_]*(\\[\\d+\\])?>', 'named' => '[a-zA-Z_][a-zA-Z0-9_]*\\(\\)', 'node' => '#[a-zA-Z_][a-zA-Z0-9_]*(:[mM])?', 'capturing_' => '\\(', '_capturing' => '\\)']]; /** * Lexer iterator. * * @var \Hoa\Iterator\Lookahead */ protected $_lexer = null; /** * Tokens representing rules. * * @var array */ protected $_tokens = null; /** * Rules. * * @var array */ protected $_rules = null; /** * Rule name being analyzed. * * @var string */ private $_ruleName = null; /** * Parsed rules. * * @var array */ protected $_parsedRules = null; /** * Counter to auto-name transitional rules. * * @var int */ protected $_transitionalRuleCounter = 0; /** * Constructor. * * @param array $tokens Tokens. */ public function __construct(array $tokens) { $this->_tokens = $tokens; return; } /** * Build the analyzer of the rules (does not analyze the rules). * * @param array $rules Rule to be analyzed. * @return void * @throws \Hoa\Compiler\Exception */ public function analyzeRules(array $rules) { if (empty($rules)) { throw new Compiler\Exception\Rule('No rules specified!', 0); } $this->_parsedRules = []; $this->_rules = $rules; $lexer = new Compiler\Llk\Lexer(); foreach ($rules as $key => $value) { $this->_lexer = new Iterator\Lookahead($lexer->lexMe($value, static::$_ppLexemes)); $this->_lexer->rewind(); $this->_ruleName = $key; $nodeId = null; if ('#' === $key[0]) { $nodeId = $key; $key = \substr($key, 1); } $pNodeId = $nodeId; $rule = $this->rule($pNodeId); if (null === $rule) { throw new Compiler\Exception('Error while parsing rule %s.', 1, $key); } $zeRule = $this->_parsedRules[$rule]; $zeRule->setName($key); $zeRule->setPPRepresentation($value); if (null !== $nodeId) { $zeRule->setDefaultId($nodeId); } unset($this->_parsedRules[$rule]); $this->_parsedRules[$key] = $zeRule; } return $this->_parsedRules; } /** * Implementation of “rule”. * * @return mixed */ protected function rule(&$pNodeId) { return $this->choice($pNodeId); } /** * Implementation of “choice”. * * @return mixed */ protected function choice(&$pNodeId) { $children = []; // concatenation() … $nNodeId = $pNodeId; $rule = $this->concatenation($nNodeId); if (null === $rule) { return null; } if (null !== $nNodeId) { $this->_parsedRules[$rule]->setNodeId($nNodeId); } $children[] = $rule; $others = \false; // … ( ::or:: concatenation() )* while ('or' === $this->_lexer->current()['token']) { $this->_lexer->next(); $others = \true; $nNodeId = $pNodeId; $rule = $this->concatenation($nNodeId); if (null === $rule) { return null; } if (null !== $nNodeId) { $this->_parsedRules[$rule]->setNodeId($nNodeId); } $children[] = $rule; } $pNodeId = null; if (\false === $others) { return $rule; } $name = $this->_transitionalRuleCounter++; $this->_parsedRules[$name] = new \Hoa\Compiler\Llk\Rule\Choice($name, $children); return $name; } /** * Implementation of “concatenation”. * * @return mixed */ protected function concatenation(&$pNodeId) { $children = []; // repetition() … $rule = $this->repetition($pNodeId); if (null === $rule) { return null; } $children[] = $rule; $others = \false; // … repetition()* while (null !== ($r1 = $this->repetition($pNodeId))) { $children[] = $r1; $others = \true; } if (\false === $others && null === $pNodeId) { return $rule; } $name = $this->_transitionalRuleCounter++; $this->_parsedRules[$name] = new \Hoa\Compiler\Llk\Rule\Concatenation($name, $children, null); return $name; } /** * Implementation of “repetition”. * * @return mixed * @throws \Hoa\Compiler\Exception */ protected function repetition(&$pNodeId) { // simple() … $children = $this->simple($pNodeId); if (null === $children) { return null; } // … quantifier()? switch ($this->_lexer->current()['token']) { case 'zero_or_one': $min = 0; $max = 1; $this->_lexer->next(); break; case 'one_or_more': $min = 1; $max = -1; $this->_lexer->next(); break; case 'zero_or_more': $min = 0; $max = -1; $this->_lexer->next(); break; case 'n_to_m': $handle = \trim($this->_lexer->current()['value'], '{}'); $nm = \explode(',', $handle); $min = (int) \trim($nm[0]); $max = (int) \trim($nm[1]); $this->_lexer->next(); break; case 'zero_to_m': $min = 0; $max = (int) \trim($this->_lexer->current()['value'], '{,}'); $this->_lexer->next(); break; case 'n_or_more': $min = (int) \trim($this->_lexer->current()['value'], '{,}'); $max = -1; $this->_lexer->next(); break; case 'exactly_n': $handle = \trim($this->_lexer->current()['value'], '{}'); $min = (int) $handle; $max = $min; $this->_lexer->next(); break; } // … <node>? if ('node' === $this->_lexer->current()['token']) { $pNodeId = $this->_lexer->current()['value']; $this->_lexer->next(); } if (!isset($min)) { return $children; } if (-1 != $max && $max < $min) { throw new Compiler\Exception('Upper bound %d must be greater or ' . 'equal to lower bound %d in rule %s.', 2, [$max, $min, $this->_ruleName]); } $name = $this->_transitionalRuleCounter++; $this->_parsedRules[$name] = new \Hoa\Compiler\Llk\Rule\Repetition($name, $min, $max, $children, null); return $name; } /** * Implementation of “simple”. * * @return mixed * @throws \Hoa\Compiler\Exception * @throws \Hoa\Compiler\Exception\Rule */ protected function simple(&$pNodeId) { if ('capturing_' === $this->_lexer->current()['token']) { $this->_lexer->next(); $rule = $this->choice($pNodeId); if (null === $rule) { return null; } if ('_capturing' != $this->_lexer->current()['token']) { return null; } $this->_lexer->next(); return $rule; } if ('skipped' === $this->_lexer->current()['token']) { $tokenName = \trim($this->_lexer->current()['value'], ':'); if (']' === \substr($tokenName, -1)) { $uId = (int) \substr($tokenName, \strpos($tokenName, '[') + 1, -1); $tokenName = \substr($tokenName, 0, \strpos($tokenName, '[')); } else { $uId = -1; } $exists = \false; foreach ($this->_tokens as $namespace => $tokens) { foreach ($tokens as $token => $value) { if ($token === $tokenName || \substr($token, 0, \strpos($token, ':')) === $tokenName) { $exists = \true; break 2; } } } if (\false == $exists) { throw new Compiler\Exception('Token ::%s:: does not exist in rule %s.', 3, [$tokenName, $this->_ruleName]); } $name = $this->_transitionalRuleCounter++; $this->_parsedRules[$name] = new \Hoa\Compiler\Llk\Rule\Token($name, $tokenName, null, $uId); $this->_lexer->next(); return $name; } if ('kept' === $this->_lexer->current()['token']) { $tokenName = \trim($this->_lexer->current()['value'], '<>'); if (']' === \substr($tokenName, -1)) { $uId = (int) \substr($tokenName, \strpos($tokenName, '[') + 1, -1); $tokenName = \substr($tokenName, 0, \strpos($tokenName, '[')); } else { $uId = -1; } $exists = \false; foreach ($this->_tokens as $namespace => $tokens) { foreach ($tokens as $token => $value) { if ($token === $tokenName || \substr($token, 0, \strpos($token, ':')) === $tokenName) { $exists = \true; break 2; } } } if (\false == $exists) { throw new Compiler\Exception('Token <%s> does not exist in rule %s.', 4, [$tokenName, $this->_ruleName]); } $name = $this->_transitionalRuleCounter++; $token = new \Hoa\Compiler\Llk\Rule\Token($name, $tokenName, null, $uId, \true); $this->_parsedRules[$name] = $token; $this->_lexer->next(); return $name; } if ('named' === $this->_lexer->current()['token']) { $tokenName = \rtrim($this->_lexer->current()['value'], '()'); if (\false === \array_key_exists($tokenName, $this->_rules) && \false === \array_key_exists('#' . $tokenName, $this->_rules)) { throw new Compiler\Exception\Rule('Cannot call rule %s() in rule %s because it does not exist.', 5, [$tokenName, $this->_ruleName]); } if (0 === $this->_lexer->key() && 'EOF' === $this->_lexer->getNext()['token']) { $name = $this->_transitionalRuleCounter++; $this->_parsedRules[$name] = new \Hoa\Compiler\Llk\Rule\Concatenation($name, [$tokenName], null); } else { $name = $tokenName; } $this->_lexer->next(); return $name; } return null; } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Compiler\Llk\Rule; /** * Class \Hoa\Compiler\Llk\Rule\Ekzit. * * The ekzit (exit) rule. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Ekzit extends \Hoa\Compiler\Llk\Rule\Invocation { } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Compiler\Llk\Rule; use Hoa\Consistency; /** * Class \Hoa\Compiler\Llk\Rule. * * Rule parent. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ abstract class Rule { /** * Rule name. * * @var string */ protected $_name = null; /** * Rule's children. Can be an array of names or a single name. * * @var mixed */ protected $_children = null; /** * Node ID. * * @var string */ protected $_nodeId = null; /** * Node options. * * @var array */ protected $_nodeOptions = []; /** * Default ID. * * @var string */ protected $_defaultId = null; /** * Default options. * * @var array */ protected $_defaultOptions = []; /** * For non-transitional rule: PP representation. * * @var string */ protected $_pp = null; /** * Whether the rule is transitional or not (i.e. not declared in the grammar * but created by the analyzer). * * @var bool */ protected $_transitional = \true; /** * Constructor. * * @param string $name Rule name. * @param mixed $children Children. * @param string $nodeId Node ID. */ public function __construct($name, $children, $nodeId = null) { $this->setName($name); $this->setChildren($children); if ($nodeId !== null) { $this->setNodeId($nodeId); } return; } /** * Set rule name. * * @param string $name Rule name. * @return string */ public function setName($name) { $old = $this->_name; $this->_name = $name; return $old; } /** * Get rule name. * * @return string */ public function getName() { return $this->_name; } /** * Set rule's children. * * @param mixed $children Children. * @return mixed */ protected function setChildren($children) { $old = $this->_children; $this->_children = $children; return $old; } /** * Get rule's children. * * @return mixed */ public function getChildren() { return $this->_children; } /** * Set node ID. * * @param string $nodeId Node ID. * @return string */ public function setNodeId($nodeId) { $old = $this->_nodeId; if (\false !== ($pos = \strpos($nodeId, ':'))) { $this->_nodeId = \substr($nodeId, 0, $pos); $this->_nodeOptions = \str_split(\substr($nodeId, $pos + 1)); } else { $this->_nodeId = $nodeId; $this->_nodeOptions = []; } return $old; } /** * Get node ID. * * @return string */ public function getNodeId() { return $this->_nodeId; } /** * Get node options. * * @retrun array */ public function getNodeOptions() { return $this->_nodeOptions; } /** * Set default ID. * * @param string $defaultId Default ID. * @return string */ public function setDefaultId($defaultId) { $old = $this->_defaultId; if (\false !== ($pos = \strpos($defaultId, ':'))) { $this->_defaultId = \substr($defaultId, 0, $pos); $this->_defaultOptions = \str_split(\substr($defaultId, $pos + 1)); } else { $this->_defaultId = $defaultId; $this->_defaultOptions = []; } return $old; } /** * Get default ID. * * @return string */ public function getDefaultId() { return $this->_defaultId; } /** * Get default options. * * @return array */ public function getDefaultOptions() { return $this->_defaultOptions; } /** * Set PP representation of the rule. * * @param string $pp PP representation. * @return string */ public function setPPRepresentation($pp) { $old = $this->_pp; $this->_pp = $pp; $this->_transitional = \false; return $old; } /** * Get PP representation of the rule. * * @return string */ public function getPPRepresentation() { return $this->_pp; } /** * Check whether the rule is transitional or not. * * @return bool */ public function isTransitional() { return $this->_transitional; } } /** * Flex entity. */ Consistency::flexEntity('Hoa\\Compiler\\Llk\\Rule\\Rule'); <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Compiler\Llk\Rule; use Hoa\Compiler; use Hoa\File; /** * Class \Hoa\Compiler\Llk\Rule\Token. * * The token rule. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Token extends \Hoa\Compiler\Llk\Rule\Rule { /** * LL(k) compiler of hoa://Library/Regex/Grammar.pp. * * @var \Hoa\Compiler\Llk\Parser */ protected static $_regexCompiler = null; /** * Token name. * * @var string */ protected $_tokenName = null; /** * Namespace. * * @var string */ protected $_namespace = null; /** * Token representation. * * @var string */ protected $_regex = null; /** * AST of the regex. * * @var \Hoa\Compiler\Llk\TreeNode */ protected $_ast = null; /** * Token value. * * @var string */ protected $_value = null; /** * Whether the token is kept or not in the AST. * * @var bool */ protected $_kept = \false; /** * Unification index. * * @var int */ protected $_unification = -1; /** * Constructor. * * @param string $name Name. * @param string $tokenName Token name. * @param string $nodeId Node ID. * @param int $unification Unification index. * @param bool $kept Whether the token is kept or not in the AST. */ public function __construct($name, $tokenName, $nodeId, $unification, $kept = \false) { parent::__construct($name, null, $nodeId); $this->_tokenName = $tokenName; $this->_unification = $unification; $this->setKept($kept); return; } /** * Get token name. * * @return string */ public function getTokenName() { return $this->_tokenName; } /** * Set token namespace. * * @param string $namespace Namespace. * @return string */ public function setNamespace($namespace) { $old = $this->_namespace; $this->_namespace = $namespace; return $old; } /** * Get token namespace. * * @return string */ public function getNamespace() { return $this->_namespace; } /** * Set representation. * * @param string $regex Representation. * @return string */ public function setRepresentation($regex) { $old = $this->_regex; $this->_regex = $regex; return $old; } /** * Get token representation. * * @return string */ public function getRepresentation() { return $this->_regex; } /** * Get AST of the token representation. * * @return \Hoa\Compiler\Llk\TreeNode */ public function getAST() { if (null === static::$_regexCompiler) { $stream = new File\Read('hoa://Library/Regex/Grammar.pp'); $stream->rewind(); static::$_regexCompiler = Compiler\Llk::load($stream); } if (null === $this->_ast) { $this->_ast = static::$_regexCompiler->parse($this->getRepresentation()); } return $this->_ast; } /** * Set token value. * * @param string $value Value. * @return string */ public function setValue($value) { $old = $this->_value; $this->_value = $value; return $old; } /** * Get token value. * * @return string */ public function getValue() { return $this->_value; } /** * Set whether the token is kept or not in the AST. * * @param bool $kept Kept. * @return bool */ public function setKept($kept) { $old = $this->_kept; $this->_kept = $kept; return $old; } /** * Check whether the token is kept in the AST or not. * * @return bool */ public function isKept() { return $this->_kept; } /** * Get unification index. * * @return int */ public function getUnificationIndex() { return $this->_unification; } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Compiler\Llk\Rule; /** * Class \Hoa\Compiler\Llk\Rule\Concatenation. * * The concatenation rule. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Concatenation extends \Hoa\Compiler\Llk\Rule\Rule { } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Compiler\Llk\Rule; /** * Class \Hoa\Compiler\Llk\Rule\Choice. * * The choice rule. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Choice extends \Hoa\Compiler\Llk\Rule\Rule { } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Compiler\Llk\Rule; /** * Class \Hoa\Compiler\Llk\Rule\Invocation. * * Parent of entry and ekzit rules. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ abstract class Invocation { /** * Rule. * * @var string */ protected $_rule = null; /** * Data. * * @var mixed */ protected $_data = null; /** * Piece of todo sequence. * * @var array */ protected $_todo = null; /** * Depth in the trace. * * @var int */ protected $_depth = -1; /** * Whether the rule is transitional or not (i.e. not declared in the grammar * but created by the analyzer). * * @var bool */ protected $_transitional = \false; /** * Constructor. * * @param string $rule Rule name. * @param mixed $data Data. * @param array $todo Todo. * @param int $depth Depth. */ public function __construct($rule, $data, ?array $todo = null, $depth = -1) { $this->_rule = $rule; $this->_data = $data; $this->_todo = $todo; $this->_depth = $depth; $this->_transitional = \is_int($rule); return; } /** * Get rule name. * * @return string */ public function getRule() { return $this->_rule; } /** * Get data. * * @return mixed */ public function getData() { return $this->_data; } /** * Get todo sequence. * * @return array */ public function getTodo() { return $this->_todo; } /** * Set depth in trace. * * @param int $depth Depth. * @return int */ public function setDepth($depth) { $old = $this->_depth; $this->_depth = $depth; return $old; } /** * Get depth in trace. * * @return int */ public function getDepth() { return $this->_depth; } /** * Check whether the rule is transitional or not. * * @return bool */ public function isTransitional() { return $this->_transitional; } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Compiler\Llk\Rule; use Hoa\Compiler; /** * Class \Hoa\Compiler\Llk\Rule\Repetition. * * The repetition rule. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Repetition extends \Hoa\Compiler\Llk\Rule\Rule { /** * Minimum bound. * * @var int */ protected $_min = 0; /** * Maximum bound. * * @var int */ protected $_max = 0; /** * Constructor. * * @param string $name Name. * @param int $min Minimum bound. * @param int $max Maximum bound. * @param mixed $children Children. * @param string $nodeId Node ID. */ public function __construct($name, $min, $max, $children, $nodeId) { parent::__construct($name, $children, $nodeId); $min = \max(0, (int) $min); $max = \max(-1, (int) $max); if (-1 !== $max && $min > $max) { throw new Compiler\Exception\Rule('Cannot repeat with a min (%d) greater than max (%d).', 0, [$min, $max]); } $this->_min = $min; $this->_max = $max; return; } /** * Get minimum bound. * * @return int */ public function getMin() { return $this->_min; } /** * Get maximum bound. * * @return int */ public function getMax() { return $this->_max; } /** * Check whether the maximum repetition is unbounded. * * @return bool */ public function isInfinite() { return -1 === $this->getMax(); } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Compiler\Llk\Rule; /** * Class \Hoa\Compiler\Llk\Rule\Entry. * * The entry rule. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Entry extends \Hoa\Compiler\Llk\Rule\Invocation { } // // Hoa // // // @license // // New BSD License // // Copyright © 2007-2017, Hoa community. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are met: // * Redistributions of source code must retain the above copyright // notice, this list of conditions and the following disclaimer. // * Redistributions in binary form must reproduce the above copyright // notice, this list of conditions and the following disclaimer in the // documentation and/or other materials provided with the distribution. // * Neither the name of the Hoa nor the names of its contributors may be // used to endorse or promote products derived from this software without // specific prior written permission. // // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" // AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE // IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE // ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE // LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR // CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF // SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS // INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN // CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) // ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE // POSSIBILITY OF SUCH DAMAGE. // // Grammar \Hoa\Compiler\Llk. // // Provide grammar for the LL(k) parser. // // @copyright Copyright © 2007-2017, Hoa community. // @license New BSD License // %skip space \s %token or \| %token zero_or_one \? %token one_or_more \+ %token zero_or_more \* %token n_to_m \{[0-9]+,[0-9]+\} %token zero_to_m \{,[0-9]+\} %token n_or_more \{[0-9]+,\} %token exactly_n \{[0-9]+\} %token token [a-zA-Z_][a-zA-Z0-9_]* %token skipped :: %token kept_ < %token _kept > %token named \(\) %token node #[a-zA-Z_][a-zA-Z0-9_]*(:[mM])? %token capturing_ \( %token _capturing \) %token unification_ \[ %token unification [0-9]+ %token _unification \] #rule: choice() choice: concatenation() ( ::or:: concatenation() #choice )* concatenation: repetition() ( repetition() #concatenation )* repetition: simple() ( quantifier() #repetition )? <node>? simple: ::capturing_:: choice() ::_capturing:: | ::skipped:: <token> ( ::unification_:: <unification> ::_unification:: )? ::skipped:: #skipped | ::kept_:: <token> ( ::unification_:: <unification> ::_unification:: )? ::_kept:: #kept | <token> ::named:: quantifier: <zero_or_one> | <one_or_more> | <zero_or_more> | <n_to_m> | <n_or_more> | <exactly_n> <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Math; /** * Class \Hoa\Math\Util. * * Some Math functions. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Util { /** * @description 'Kronecker delta: δ_i^j = 1 if i = j, 0 if i ≠ j'; * @requires i: integer() and * j: integer(); * @ensures \pred('\\result === (int) ($i === $j)'); */ public static function δ($i, $j) { return (int) ($i === $j); } } // // Hoa // // // @license // // New BSD License // // Copyright © 2007-2016, Hoa community. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are met: // * Redistributions of source code must retain the above copyright // notice, this list of conditions and the following disclaimer. // * Redistributions in binary form must reproduce the above copyright // notice, this list of conditions and the following disclaimer in the // documentation and/or other materials provided with the distribution. // * Neither the name of the Hoa nor the names of its contributors may be // used to endorse or promote products derived from this software without // specific prior written permission. // // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" // AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE // IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE // ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE // LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR // CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF // SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS // INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN // CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) // ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE // POSSIBILITY OF SUCH DAMAGE. // // Grammar \Hoa\Math\Arithmetic. // // Provide a grammar for arithmetic expressions. // // @copyright Copyright © 2007-2016 Hoa community. // @license New BSD License // %skip space [\x20\x09]+ %token bracket_ \( %token _bracket \) %token comma , %token number (0|[1-9]\d*)(\.\d+)?([eE][\+\-]?\d+)? %token plus \+ %token minus \-|− %token times \*|× %token div /|÷ %token constant [A-Z_]+[A-Z0-9_]* %token id \w+ expression: primary() ( ::plus:: #addition expression() )? primary: secondary() ( ::minus:: #substraction expression() )? secondary: ternary() ( ::times:: #multiplication expression() )? ternary: term() ( ::div:: #division expression() )? term: ( ::bracket_:: expression() ::_bracket:: #group ) | number() | constant() | variable() | ( ::minus:: #negative | ::plus:: ) term() | function() number: <number> constant: <constant> #variable: <id> #function: <id> ::bracket_:: ( expression() ( ::comma:: expression() )* )? ::_bracket:: <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Math; /** * Class \Hoa\Math\Context. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Context { /** * List of supported functions: identifier => values as callable. * * @var \ArrayObject */ protected $_functions = null; /** * List of supported constants: identifier => values. * * @var \ArrayObject */ protected $_constants = null; /** * List of supported variables: identifier => values as callable. * * @var \ArrayObject */ protected $_variables = null; /** * Initialize constants and functions. * */ public function __construct() { $this->initializeConstants(); $this->initializeFunctions(); $this->initializeVariables(); return; } /** * Add a constant. * * @param string $name Constant name. * @param mixed $value Value. * @return void * @throws \Hoa\Math\Exception\AlreadyDefinedConstant */ public function addConstant($name, $value) { if (\true === $this->_constants->offsetExists($name)) { throw new \Hoa\Math\Exception\AlreadyDefinedConstant('Constant %s is already defined.', 0, $name); } $this->_constants[$name] = $value; return; } /** * Get a constant. * * @param string $name Constant name. * @return mixed * @throws \Hoa\Math\Exception\UnknownConstant */ public function getConstant($name) { if (\false === $this->_constants->offsetExists($name)) { throw new \Hoa\Math\Exception\UnknownConstant('Constant %s does not exist.', 1, $name); } return $this->_constants[$name]; } /** * Get constants. * * @return \ArrayObject */ public function getConstants() { return $this->_constants; } /** * Add a function. * * @param string $name Function name. * @param mixed $callable Callable. * @return void * @throws \Hoa\Math\Exception\UnknownFunction */ public function addFunction($name, $callable = null) { if (null === $callable) { if (\false === \function_exists($name)) { throw new \Hoa\Math\Exception\UnknownFunction('Function %s does not exist, cannot add it.', 2, $name); } $callable = $name; } $this->_functions[$name] = xcallable($callable); return; } /** * Get a function. * * @param string $name Function name. * @return \Hoa\Consistency\Xcallable * @throws \Hoa\Math\Exception\UnknownFunction */ public function getFunction($name) { if (\false === $this->_functions->offsetExists($name)) { throw new \Hoa\Math\Exception\UnknownFunction('Function %s does not exist.', 3, $name); } return $this->_functions[$name]; } /** * Get functions. * * @return \ArrayObject */ public function getFunctions() { return $this->_functions; } /** * Add a variable. * * @param string $name Variable name. * @param callable $callable Callable. * @return void */ public function addVariable($name, callable $callable) { $this->_variables[$name] = xcallable($callable); return; } /** * Get a variable. * * @param string $name Variable name. * @return callable * @throws \Hoa\Math\Exception\UnknownVariable */ public function getVariable($name) { if (\false === $this->_variables->offsetExists($name)) { throw new \Hoa\Math\Exception\UnknownVariable('Variable %s does not exist.', 4, $name); } return $this->_variables[$name]($this); } /** * Get variables. * * @return \ArrayObject */ public function getVariables() { return $this->_variables; } /** * Initialize constants mapping. * * @return void */ protected function initializeConstants() { static $_constants = null; if (null === $_constants) { $_constants = new \ArrayObject(['PI' => \M_PI, 'PI_2' => \M_PI_2, 'PI_4' => \M_PI_4, 'E' => \M_E, 'SQRT_PI' => \M_SQRTPI, 'SQRT_2' => \M_SQRT2, 'SQRT_3' => \M_SQRT3, 'LN_PI' => \M_LNPI, 'LOG_2E' => \M_LOG2E, 'LOG_10E' => \M_LOG10E, 'LN_2' => \M_LN2, 'LN_10' => \M_LN10, 'ONE_OVER_PI' => \M_1_PI, 'TWO_OVER_PI' => \M_2_PI, 'TWO_OVER_SQRT_PI' => \M_2_SQRTPI, 'ONE_OVER_SQRT_2' => \M_SQRT1_2, 'EULER' => \M_EULER, 'INFINITE' => \INF]); } $this->_constants = $_constants; return; } /** * Initialize functions mapping. * * @return void */ protected function initializeFunctions() { static $_functions = null; if (null === $_functions) { $average = function () { $arguments = \func_get_args(); return \array_sum($arguments) / \count($arguments); }; $_functions = new \ArrayObject(['abs' => xcallable('abs'), 'acos' => xcallable('acos'), 'asin' => xcallable('asin'), 'atan' => xcallable('atan'), 'average' => xcallable($average), 'avg' => xcallable($average), 'ceil' => xcallable('ceil'), 'cos' => xcallable('cos'), 'count' => xcallable(function () { return \count(\func_get_args()); }), 'deg2rad' => xcallable('deg2rad'), 'exp' => xcallable('exp'), 'floor' => xcallable('floor'), 'ln' => xcallable('log'), 'log' => xcallable(function ($value, $base = 10) { return \log($value, $base); }), 'max' => xcallable('max'), 'min' => xcallable('min'), 'pow' => xcallable('pow'), 'rad2deg' => xcallable('rad2deg'), 'round' => xcallable(function ($value, $precision = 0) { return \round($value, $precision); }), 'sin' => xcallable('sin'), 'sqrt' => xcallable('sqrt'), 'sum' => xcallable(function () { return \array_sum(\func_get_args()); }), 'tan' => xcallable('tan')]); } $this->_functions = $_functions; return; } /** * Initialize variables mapping. * * @return void */ protected function initializeVariables() { if (null === $this->_variables) { $this->_variables = new \ArrayObject(); } return; } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Math\Exception; /** * Class \Hoa\Math\Exception\UnknownVariable. * * Extending the \Hoa\Math\Exception class. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class UnknownVariable extends \Hoa\Math\Exception\Exception { } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Math\Exception; use Hoa\Consistency; use Hoa\Exception as HoaException; /** * Class \Hoa\Math\Exception. * * Extending the \Hoa\Exception\Exception class. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Exception extends HoaException { } /** * Flex entity. */ Consistency::flexEntity('Hoa\\Math\\Exception\\Exception'); <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Math\Exception; /** * Class \Hoa\Math\Exception\UnknownFunction. * * Extending the \Hoa\Math\Exception class. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class UnknownFunction extends \Hoa\Math\Exception\Exception { } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Math\Exception; /** * Class \Hoa\Math\Exception\UnknownConstant. * * Extending the \Hoa\Math\Exception class. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class UnknownConstant extends \Hoa\Math\Exception\Exception { } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Math\Exception; /** * Class \Hoa\Math\Exception\UnknownConstant. * * Extending the \Hoa\Math\Exception class. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class AlreadyDefinedConstant extends \Hoa\Math\Exception\Exception { } <?php <?php <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Math\Combinatorics\Combination; use Hoa\Consistency; /** * Class \Hoa\Math\Combinatorics\Combination. * * Some functions related to combinatorics. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Combination { /** * Γ^n_k denotes the set of k-uples whose sum of elements is n. For example: * Γ^3_2 = {(2, 0, 0), (1, 1, 0), (1, 0, 1), (0, 2, 0), (0, 1, 1), (0, 0, * 2)}. For any k-uple γ and any α in {1, …, k}, γ_α denotes the α-th * element of γ. * * @param int $n n. * @param int $k k. * @param bool $withoutZero Do not produce solutions with a zero * inside. * @return array */ public static function Γ($n, $k, $withoutZero = \false) { if (0 === $n) { return []; } $out = []; $tmp = null; $i = 0; $o = \array_fill(0, $n, 0); $o[0] = $k; while ($k != $o[$i = $n - 1]) { if (\false === $withoutZero || !\in_array(0, $o)) { $out[] = $o; } $tmp = $o[$i]; $o[$i] = 0; while ($o[$i] == 0) { --$i; } --$o[$i]; $o[$i + 1] = $tmp + 1; } if (\false === $withoutZero || !\in_array(0, $o)) { $out[] = $o; } return $out; } } /** * Flex entity. */ Consistency::flexEntity('Hoa\\Math\\Combinatorics\\Combination\\Combination'); <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Math\Combinatorics\Combination; use Hoa\Iterator; /** * Class \Hoa\Math\Combinatorics\Combination\CartesianProduct. * * Cartesian n-ary product iterator: * X = {1, 2} * Y = {a, b} * Z = {A, B, C} * X × Y × Z = { (1, a, A), (2, a, A), (1, b, A), (2, b, A) * (1, a, B), (2, a, B), (1, b, B), (2, b, B) * (1, a, C), (2, a, C), (1, b, C), (2, b, C) } * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class CartesianProduct implements Iterator { /** * All sets. * * @var array */ protected $_sets = []; /** * Number of sets. * * @var int */ protected $_max = 0; /** * Key. * * @var int */ protected $_key = 0; /** * Current (contains the current t-uple). * * @var array */ protected $_current = null; /** * Whether the iterator has reached the end or not. * * @var bool */ protected $_break = \true; /** * Constructor. * * @param \Traversable $set Set. * @param … … … */ public function __construct($set) { foreach (\func_get_args() as $s) { if (\is_array($s)) { $s = new Iterator\Map($s); } else { $s = new Iterator\IteratorIterator($s); } $this->_sets[] = $s; } $this->_max = \count($this->_sets) - 1; $this->_break = empty($this->_sets); return; } /** * Get the current value. * * @return array */ public function current() { return $this->_current; } /** * Prepare the current value. * * @return void */ protected function _current() { $this->_current = []; foreach ($this->_sets as $set) { $this->_current[] = $set->current(); } return; } /** * Get the current key. * * @return int */ public function key() { return $this->_key; } /** * Advance the internal collection pointer, and return the current value. * * @return array */ public function next() { for ($i = 0; $i <= $this->_max; ++$i) { $this->_sets[$i]->next(); if (\false !== $this->_sets[$i]->valid()) { break; } $this->_sets[$i]->rewind(); if ($i === $this->_max) { $this->_break = \true; break; } } ++$this->_key; $this->_current(); return $this->current(); } /** * Rewind the internal collection pointer, and return the first collection. * * @return array */ public function rewind() { $this->_break = empty($this->_sets); $this->_key = 0; foreach ($this->_sets as $set) { $set->rewind(); } $this->_current(); return $this->current(); } /** * Check if there is a current element after calls to the rewind() or the * next() methods. * * @return bool */ public function valid() { return \false === $this->_break; } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Math\Combinatorics\Combination; use Hoa\Iterator; /** * Class \Hoa\Math\Combinatorics\Combination\Gamma. * * Gamma^n_k denotes the set of k-uples whose sum of elements is n. For example: * Gamma^2_3 = {(2, 0, 0), (1, 1, 0), (1, 0, 1), (0, 2, 0), (0, 1, 1), (0, 0, 2)}. * For any k-uple γ and any α in {1, …, k}, γ_α denotes the α-th element of γ. * This class is identical to \Hoa\Math\Combinatorics\Combination::Gamma with a * “yield” keyword. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Gamma implements Iterator { /** * n. * * @var int */ protected $_n = 0; /** * k. * * @var int */ protected $_k = 0; /** * For iterator. * * @var int */ protected $_current = null; /** * For iterator. * * @var int */ protected $_key = -1; /** * For iterator. * * @var array */ protected $_tmp = null; /** * For iterator. * * @var int */ protected $_i = 0; /** * For iterator. * * @var int */ protected $_o = 0; /** * For iterator. * * * @var bool */ protected $_last = \false; /** * Constructor. * * @param int $n n. * @param int $k k. */ public function __construct($n, $k) { $this->_n = $n; $this->_k = $k; return; } /** * Get current γ. * * @return array */ public function current() { return $this->_current; } /** * Get current α. * * @return int */ public function key() { return $this->_key; } /** * Compute γ_{α + 1}. * * @return void */ public function next() { return; } /** * Rewind iterator. * * @return void */ public function rewind() { $this->_current = []; $this->_tmp = null; $this->_i = 0; $this->_o = 0 === $this->_n ? [0] : \array_fill(0, $this->_n, 0); $this->_o[0] = $this->_k; $this->_last = \false; return; } /** * Compute γ_α. * * @return bool */ public function valid() { if (\true === $this->_last) { return \false; } if (0 === $this->_n) { return \false; } if ($this->_k == $this->_o[$this->_i = $this->_n - 1]) { $this->_last = \true; $this->_current = $this->_o; ++$this->_key; return \true; } $this->_current = $this->_o; ++$this->_key; $this->_tmp = $this->_o[$this->_i]; $this->_o[$this->_i] = 0; while ($this->_o[$this->_i] == 0) { --$this->_i; } --$this->_o[$this->_i]; $this->_o[$this->_i + 1] = $this->_tmp + 1; return \true; } } <?php <?php <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Math\Sampler; use Hoa\Consistency; use Hoa\Math; use Hoa\Zformat; /** * Class \Hoa\Math\Sampler. * * Generic sampler. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ abstract class Sampler implements Zformat\Parameterizable { /** * Parameters. * * @var \Hoa\Zformat\Parameter */ protected $_parameters = null; /** * Construct an abstract sampler. * * @param array $parameters Parameters. */ public function __construct(array $parameters = []) { $this->_parameters = new Zformat\Parameter(__CLASS__, [], ['integer.min' => -16, 'integer.max' => 15, 'float.min' => -128.0, 'float.max' => 127.0]); $this->_parameters->setParameters($parameters); if (null === $this->_parameters->getParameter('integer.min')) { $this->_parameters->setParameter('integer.min', \PHP_INT_MIN); } if (null === $this->_parameters->getParameter('integer.max')) { $this->_parameters->setParameter('integer.max', \PHP_INT_MAX); } if (null === $this->_parameters->getParameter('float.min')) { $this->_parameters->setParameter('float.min', \PHP_INT_MIN); } if (null === $this->_parameters->getParameter('float.max')) { $this->_parameters->setParameter('float.max', \PHP_INT_MAX); } $this->construct(); return; } /** * Construct. * * @return void */ public function construct() { return; } /** * Get parameters. * * @return \Hoa\Zformat\Parameter */ public function getParameters() { return $this->_parameters; } /** * Generate a discrete uniform distribution. * * @param int $lower Lower bound value. * @param int $upper Upper bound value. * @param array &$exclude Excluded values. * @return int */ public function getInteger($lower = null, $upper = null, array &$exclude = null) { if (null === $lower) { $lower = $this->_parameters->getParameter('integer.min'); } if (null === $upper) { $upper = $this->_parameters->getParameter('integer.max'); } if (null === $exclude) { if ($lower > $upper) { throw new Math\Exception('Unexpected values, integer %d should be lower than %d', 0, [$lower, $upper]); } return $this->_getInteger($lower, $upper); } \sort($exclude); $upper -= \count($exclude); if ($lower > $upper) { throw new Math\Exception('Unexpected values, integer %d should be lower than %d', 1, [$lower, $upper]); } $sampled = $this->_getInteger($lower, $upper); foreach ($exclude as $e) { if ($sampled >= $e) { ++$sampled; } else { break; } } return $sampled; } /** * Generate a discrete uniform distribution. * * @param int $lower Lower bound value. * @param int $upper Upper bound value. * @return int */ protected abstract function _getInteger($lower, $upper); /** * Generate a continuous uniform distribution. * * @param float $lower Lower bound value. * @param float $upper Upper bound value. * @return float */ public function getFloat($lower = null, $upper = null) { if (null === $lower) { $lower = $this->_parameters->getParameter('float.min'); } /* $lower = true === S_32\BITS ? -3.4028235e38 + 1 : -1.7976931348623157e308 + 1; */ if (null === $upper) { $upper = $this->_parameters->getParameter('float.max'); } /* $upper = true === S_32\BITS ? 3.4028235e38 - 1 : 1.7976931348623157e308 - 1; */ if ($lower > $upper) { throw new Math\Exception('Unexpected values, float %f should be lower than %f', 2, [$lower, $upper]); } return $this->_getFloat($lower, $upper); } /** * Generate a continuous uniform distribution. * * @param float $lower Lower bound value. * @param float $upper Upper bound value. * @return float */ protected abstract function _getFloat($lower, $upper); /** * Get an exclude set. * * @return array */ public function getExcludeSet() { return []; } } /** * Flex entity. */ Consistency::flexEntity('Hoa\\Math\\Sampler\\Sampler'); <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Math\Sampler; /** * Class \Hoa\Math\Sampler\Random. * * Random sampler. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Random extends \Hoa\Math\Sampler\Sampler { /** * Construct. * * @return void */ public function construct() { if (null === $this->_parameters->getParameter('integer.min')) { $this->_parameters->setParameter('integer.min', \max(-\mt_getrandmax(), $this->_parameters->getParameter('integer.min'))); } if (null === $this->_parameters->getParameter('integer.max')) { $this->_parameters->setParameter('integer.max', \min(\mt_getrandmax(), $this->_parameters->getParameter('integer.max'))); } return; } /** * Generate a discrete uniform distribution. * * @param int $lower Lower bound value. * @param int $upper Upper bound value. * @return int */ protected function _getInteger($lower, $upper) { return \mt_rand($lower, $upper); } /** * Generate a continuous uniform distribution. * * @param float $lower Lower bound value. * @param float $upper Upper bound value. * @return float */ protected function _getFloat($lower, $upper) { return $lower + \lcg_value() * \abs($upper - $lower); } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Math\Visitor; use Hoa\Math; use Hoa\Visitor; /** * Class \Hoa\Math\Visitor\Arithmetic. * * Evaluate arithmetical expressions. * * @copyright Copyright © 2007-2017 Hoa community * Ivan Enderlin, Cédric Dugat. * @license New BSD License */ class Arithmetic implements Visitor\Visit { /** * Visitor context containing the list of supported functions, constants and variables * * @var \Hoa\Math\Context */ protected $_context = null; /** * Initializes context. * */ public function __construct() { $this->initializeContext(); return; } /** * Set visitor's context * * @param \Hoa\Math\Context $context * @return \Hoa\Math\Context */ public function setContext(Math\Context $context) { $old = $this->_context; $this->_context = $context; return $old; } /** * Get visitor's context * * @return \Hoa\Math\Context */ public function getContext() { return $this->_context; } /** * Visit an element. * * @param \Hoa\Visitor\Element $element Element to visit. * @param mixed &$handle Handle (reference). * @param mixed $eldnah Handle (not reference). * @return float */ public function visit(Visitor\Element $element, &$handle = null, $eldnah = null) { $type = $element->getId(); $children = $element->getChildren(); if (null === $handle) { $handle = function ($x) { return $x; }; } $acc =& $handle; switch ($type) { case '#function': $name = \array_shift($children)->accept($this, $_, $eldnah); $function = $this->getFunction($name); $arguments = []; foreach ($children as $child) { $child->accept($this, $_, $eldnah); $arguments[] = $_(); unset($_); } $acc = function () use($function, $arguments, $acc) { return $acc($function->distributeArguments($arguments)); }; break; case '#negative': $children[0]->accept($this, $a, $eldnah); $acc = function () use($a, $acc) { return $acc(-$a()); }; break; case '#addition': $children[0]->accept($this, $a, $eldnah); $acc = function ($b) use($a, $acc) { return $acc($a() + $b); }; $children[1]->accept($this, $acc, $eldnah); break; case '#substraction': $children[0]->accept($this, $a, $eldnah); $acc = function ($b) use($a, $acc) { return $acc($a()) - $b; }; $children[1]->accept($this, $acc, $eldnah); break; case '#multiplication': $children[0]->accept($this, $a, $eldnah); $acc = function ($b) use($a, $acc) { return $acc($a() * $b); }; $children[1]->accept($this, $acc, $eldnah); break; case '#division': $children[0]->accept($this, $a, $eldnah); $parent = $element->getParent(); if (null === $parent || $type === $parent->getId()) { $acc = function ($b) use($a, $acc) { if (0.0 === $b) { throw new \RuntimeException('Division by zero is not possible.'); } return $acc($a()) / $b; }; } else { if ('#fakegroup' !== $parent->getId()) { $classname = \get_class($element); $group = new $classname('#fakegroup', null, [$element], $parent); $element->setParent($group); $this->visit($group, $acc, $eldnah); break; } else { $acc = function ($b) use($a, $acc) { if (0.0 === $b) { throw new \RuntimeException('Division by zero is not possible.'); } return $acc($a() / $b); }; } } $children[1]->accept($this, $acc, $eldnah); break; case '#fakegroup': case '#group': $children[0]->accept($this, $a, $eldnah); $acc = function () use($a, $acc) { return $acc($a()); }; break; case '#variable': $out = $this->getVariable($children[0]->getValueValue()); $acc = function () use($out, $acc) { return $acc($out); }; break; case 'token': $value = $element->getValueValue(); $out = null; if ('constant' === $element->getValueToken()) { if (\defined($value)) { $out = \constant($value); } else { $out = $this->getConstant($value); } } elseif ('id' === $element->getValueToken()) { return $value; } else { $out = (float) $value; } $acc = function () use($out, $acc) { return $acc($out); }; break; } if (null === $element->getParent()) { return $acc(); } } /** * Get functions. * * @return \ArrayObject */ public function getFunctions() { return $this->_context->getFunctions(); } /** * Get a function. * * @param string $name Function name. * @return \Hoa\Consistency\Xcallable * @throws \Hoa\Math\Exception\UnknownFunction */ public function getFunction($name) { return $this->_context->getFunction($name); } /** * Get constants. * * @return \ArrayObject */ public function getConstants() { return $this->_context->getConstants(); } /** * Get a constant. * * @param string $name Constant name. * @return mixed * @throws \Hoa\Math\Exception\UnknownFunction */ public function getConstant($name) { return $this->_context->getConstant($name); } /** * Get variables. * * @return \ArrayObject */ public function getVariables() { return $this->_context->getVariables(); } /** * Get a variable. * * @param string $name Variable name. * @return callable * @throws \Hoa\Math\Exception\UnknownVariable */ public function getVariable($name) { return $this->_context->getVariable($name); } protected function initializeContext() { if (null === $this->_context) { $this->_context = new Math\Context(); } return; } /** * Add a function. * * @param string $name Function name. * @param mixed $callable Callable. * @return void */ public function addFunction($name, $callable = null) { return $this->_context->addFunction($name, $callable); } /** * Add a constant. * * @param string $name Constant name. * @param mixed $value Value. * @return void */ public function addConstant($name, $value) { return $this->_context->addConstant($name, $value); } /** * Add a variable. * * @param string $name Variable name. * @param callable $callable Callable. * @return void */ public function addVariable($name, callable $callable) { return $this->_context->addVariable($name, $callable); } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Math\Bin; use Hoa\Compiler; use Hoa\Console; use Hoa\File; use Hoa\Math; /** * Class \Hoa\Math\Bin\Calc. * * A simple calculator. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Calc extends Console\Dispatcher\Kit { /** * Options description. * * @var array */ protected $options = [['help', Console\GetOption::NO_ARGUMENT, 'h'], ['help', Console\GetOption::NO_ARGUMENT, '?']]; /** * The entry method. * * @return int */ public function main() { while (\false !== ($c = $this->getOption($v))) { switch ($c) { case 'h': case '?': return $this->usage(); case '__ambiguous': $this->resolveOptionAmbiguity($v); break; } } $this->parser->listInputs($expression); $compiler = Compiler\Llk::load(new File\Read('hoa://Library/Math/Arithmetic.pp')); $visitor = new Math\Visitor\Arithmetic(); $dump = new Compiler\Visitor\Dump(); if (null !== $expression) { $ast = $compiler->parse($expression); echo $expression . ' = ' . $visitor->visit($ast), "\n"; return; } $readline = new Console\Readline(); $readline->setAutocompleter(new Console\Readline\Autocompleter\Word(\array_merge(\array_keys($visitor->getConstants()->getArrayCopy()), \array_keys($visitor->getFunctions()->getArrayCopy())))); $handle = null; $expression = 'h'; do { switch ($expression) { case 'h': case 'help': echo 'Usage:', "\n", ' h[elp] to print this help;', "\n", ' c[onstants] to print available constants;', "\n", ' f[unctions] to print available functions;', "\n", ' e[xpression] to print the current expression;', "\n", ' d[ump] to dump the tree of the expression;', "\n", ' q[uit] to quit.', "\n"; break; case 'c': case 'constants': echo \implode(', ', \array_keys($visitor->getConstants()->getArrayCopy())), "\n"; break; case 'f': case 'functions': echo \implode(', ', \array_keys($visitor->getFunctions()->getArrayCopy())), "\n"; break; case 'e': case 'expression': echo $handle, "\n"; break; case 'd': case 'dump': if (null === $handle) { echo 'Type a valid expression before (“> 39 + 3”).', "\n"; } else { echo $dump->visit($compiler->parse($handle)), "\n"; } break; case 'q': case 'quit': break 2; default: if (null === $expression) { break; } try { echo $visitor->visit($compiler->parse($expression)), "\n"; } catch (Compiler\Exception $e) { echo $e->getMessage(), "\n"; break; } $handle = $expression; break; } } while (\false !== ($expression = $readline->readLine('> '))); return; } /** * The command usage. * * @return int */ public function usage() { echo 'Usage : math:calc <options> [expression]', "\n", 'Options :', "\n", $this->makeUsageOptionsList(['help' => 'This help.']), "\n"; return; } } __halt_compiler(); A simple calculator. <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Event; /** * Class \Hoa\Event\Bucket. * * This class is the object which is transmit through event channels. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Bucket { /** * Source object. * * @var \Hoa\Event\Source */ protected $_source = null; /** * Data. * * @var mixed */ protected $_data = null; /** * Set data. * * @param mixed $data Data. */ public function __construct($data = null) { $this->setData($data); return; } /** * Send this object on the event channel. * * @param string $eventId Event ID. * @param \Hoa\Event\Source $source Source. * @return void */ public function send($eventId, \Hoa\Event\Source $source) { return \Hoa\Event\Event::notify($eventId, $source, $this); } /** * Set source. * * @param \Hoa\Event\Source $source Source. * @return \Hoa\Event\Source */ public function setSource(\Hoa\Event\Source $source) { $old = $this->_source; $this->_source = $source; return $old; } /** * Get source. * * @return \Hoa\Event\Source */ public function getSource() { return $this->_source; } /** * Set data. * * @param mixed $data Data. * @return mixed */ public function setData($data) { $old = $this->_data; $this->_data = $data; return $old; } /** * Get data. * * @return mixed */ public function getData() { return $this->_data; } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Event; /** * Interface \Hoa\Event\Listenable. * * Each object which is listenable must implement this interface. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ interface Listenable extends \Hoa\Event\Source { /** * Attach a callable to a listenable component. * * @param string $listenerId Listener ID. * @param mixed $callable Callable. * @return \Hoa\Event\Listenable */ public function on($listenerId, $callable); } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Event; use Hoa\Exception as HoaException; /** * Class \Hoa\Event\Exception. * * Extending the \Hoa\Exception\Exception class. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Exception extends HoaException { } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Event; /** * Trait \Hoa\Event\Listens. * * Implementation of a listener. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ trait Listens { /** * Listener instance. * * @var \Hoa\Event\Listener */ protected $_listener = null; /** * Attach a callable to a listenable component. * * @param string $listenerId Listener ID. * @param mixed $callable Callable. * @return \Hoa\Event\Listenable */ public function on($listenerId, $callable) { $listener = $this->getListener(); if (null === $listener) { throw new \Hoa\Event\Exception('Cannot attach a callable to the listener %s because ' . 'it has not been initialized yet.', 0, \get_class($this)); } $listener->attach($listenerId, $callable); return $this; } /** * Set listener. * * @param \Hoa\Event\Listener $listener Listener. * @return \Hoa\Event\Listener */ protected function setListener(\Hoa\Event\Listener $listener) { $old = $this->_listener; $this->_listener = $listener; return $old; } /** * Get listener. * * @return \Hoa\Event\Listener */ protected function getListener() { return $this->_listener; } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Event; /** * Class \Hoa\Event\Listener. * * A contrario of events, listeners are synchronous, identified at use and * useful for close interactions between one or some components. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Listener { /** * Source of listener (for Bucket). * * @var \Hoa\Event\Listenable */ protected $_source = null; /** * All listener IDs and associated listeners. * * @var array */ protected $_callables = []; /** * Build a listener. * * @param \Hoa\Event\Listenable $source Source (for Bucket). * @param array $ids Accepted ID. */ public function __construct(\Hoa\Event\Listenable $source, array $ids) { $this->_source = $source; $this->addIds($ids); return; } /** * Add acceptable ID (or reset). * * @param array $ids Accepted ID. * @return void */ public function addIds(array $ids) { foreach ($ids as $id) { $this->_callables[$id] = []; } return; } /** * Attach a callable to a listenable component. * * @param string $listenerId Listener ID. * @param mixed $callable Callable. * @return \Hoa\Event\Listener * @throws \Hoa\Event\Exception */ public function attach($listenerId, $callable) { if (\false === $this->listenerExists($listenerId)) { throw new \Hoa\Event\Exception('Cannot listen %s because it is not defined.', 0, $listenerId); } $callable = xcallable($callable); $this->_callables[$listenerId][$callable->getHash()] = $callable; return $this; } /** * Detach a callable from a listenable component. * * @param string $listenerId Listener ID. * @param mixed $callable Callable. * @return \Hoa\Event\Listener */ public function detach($listenerId, $callable) { unset($this->_callables[$listenerId][xcallable($callable)->getHash()]); return $this; } /** * Detach all callables from a listenable component. * * @param string $listenerId Listener ID. * @return \Hoa\Event\Listener */ public function detachAll($listenerId) { unset($this->_callables[$listenerId]); return $this; } /** * Check if a listener exists. * * @param string $listenerId Listener ID. * @return bool */ public function listenerExists($listenerId) { return \array_key_exists($listenerId, $this->_callables); } /** * Send/fire a bucket to a listener. * * @param string $listenerId Listener ID. * @param \Hoa\Event\Bucket $data Data. * @return array * @throws \Hoa\Event\Exception */ public function fire($listenerId, \Hoa\Event\Bucket $data) { if (\false === $this->listenerExists($listenerId)) { throw new \Hoa\Event\Exception('Cannot fire on %s because it is not defined.', 1, $listenerId); } $data->setSource($this->_source); $out = []; foreach ($this->_callables[$listenerId] as $callable) { $out[] = $callable($data); } return $out; } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Event; use Hoa\Consistency; /** * Class \Hoa\Event\Event. * * Events are asynchronous at registration, anonymous at use (until we * receive a bucket) and useful to largely spread data through components * without any known connection between them. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Event { /** * Event ID key. * * @const int */ const KEY_EVENT = 0; /** * Source object key. * * @const int */ const KEY_SOURCE = 1; /** * Static register of all observable objects, i.e. \Hoa\Event\Source * object, i.e. object that can send event. * * @var array */ private static $_register = []; /** * Callables, i.e. observer objects. * * @var array */ protected $_callable = []; /** * Privatize the constructor. * */ private function __construct() { return; } /** * Manage multiton of events, with the principle of asynchronous * attachments. * * @param string $eventId Event ID. * @return \Hoa\Event\Event */ public static function getEvent($eventId) { if (!isset(self::$_register[$eventId][self::KEY_EVENT])) { self::$_register[$eventId] = [self::KEY_EVENT => new self(), self::KEY_SOURCE => null]; } return self::$_register[$eventId][self::KEY_EVENT]; } /** * Declare a new object in the observable collection. * Note: Hoa's libraries use hoa://Event/AnID for their observable objects; * * @param string $eventId Event ID. * @param \Hoa\Event\Source|string $source Observable object or class. * @return void * @throws \Hoa\Event\Exception */ public static function register($eventId, $source) { if (\true === self::eventExists($eventId)) { throw new \Hoa\Event\Exception('Cannot redeclare an event with the same ID, i.e. the event ' . 'ID %s already exists.', 0, $eventId); } if (\is_object($source) && !$source instanceof \Hoa\Event\Source) { throw new \Hoa\Event\Exception('The source must implement \\Hoa\\Event\\Source ' . 'interface; given %s.', 1, \get_class($source)); } else { $reflection = new \ReflectionClass($source); if (\false === $reflection->implementsInterface('\\Hoa\\Event\\Source')) { throw new \Hoa\Event\Exception('The source must implement \\Hoa\\Event\\Source ' . 'interface; given %s.', 2, $source); } } if (!isset(self::$_register[$eventId][self::KEY_EVENT])) { self::$_register[$eventId][self::KEY_EVENT] = new self(); } self::$_register[$eventId][self::KEY_SOURCE] = $source; return; } /** * Undeclare an object in the observable collection. * * @param string $eventId Event ID. * @param bool $hard If false, just delete the source, else, * delete source and attached callables. * @return void */ public static function unregister($eventId, $hard = \false) { if (\false !== $hard) { unset(self::$_register[$eventId]); } else { self::$_register[$eventId][self::KEY_SOURCE] = null; } return; } /** * Attach an object to an event. * It can be a callable or an accepted callable form (please, see the * \Hoa\Consistency\Xcallable class). * * @param mixed $callable Callable. * @return \Hoa\Event\Event */ public function attach($callable) { $callable = xcallable($callable); $this->_callable[$callable->getHash()] = $callable; return $this; } /** * Detach an object to an event. * Please see $this->attach() method. * * @param mixed $callable Callable. * @return \Hoa\Event\Event */ public function detach($callable) { unset($this->_callable[xcallable($callable)->getHash()]); return $this; } /** * Check if at least one callable is attached to an event. * * @return bool */ public function isListened() { return !empty($this->_callable); } /** * Notify, i.e. send data to observers. * * @param string $eventId Event ID. * @param \Hoa\Event\Source $source Source. * @param \Hoa\Event\Bucket $data Data. * @return void * @throws \Hoa\Event\Exception */ public static function notify($eventId, \Hoa\Event\Source $source, \Hoa\Event\Bucket $data) { if (\false === self::eventExists($eventId)) { throw new \Hoa\Event\Exception('Event ID %s does not exist, cannot send notification.', 3, $eventId); } $data->setSource($source); $event = self::getEvent($eventId); foreach ($event->_callable as $callable) { $callable($data); } return; } /** * Check whether an event exists. * * @param string $eventId Event ID. * @return bool */ public static function eventExists($eventId) { return \array_key_exists($eventId, self::$_register) && self::$_register[$eventId][self::KEY_SOURCE] !== null; } } /** * Flex entity. */ Consistency::flexEntity('Hoa\\Event\\Event'); <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Event; /** * Interface \Hoa\Event\Source. * * Each object which is listenable must implement this interface. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ interface Source { } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Stream; /** * Class \Hoa\Stream\Bucket. * * Manipulate stream buckets through brigades. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Bucket { /** * Whether the stream is already a brigade. * * @const bool */ const IS_A_BRIGADE = \true; /** * Whether the stream is not a brigade. * * @const bool */ const IS_A_STREAM = \false; /** * Type of the bucket. * * @var bool */ protected $_type = null; /** * Brigade. * * @var resource */ protected $_brigade = null; /** * Bucket. * * @var resource */ protected $_bucket = null; /** * Set a brigade. * If a stream is given (with the constant `self::IS_A_STREAM`), it will * create a brigade automatically. * * @param resource &$brigade A stream or a brigade. * @param bool $is Specify if `$brigade` is a stream or a * brigade, given by `self::IS_A_*` constant. * @param string $buffer Stream buffer. */ public function __construct(&$brigade, $is = self::IS_A_BRIGADE, $buffer = '') { $this->setType($is); if (self::IS_A_BRIGADE === $this->getType()) { $this->setBrigade($brigade); } else { $this->setBucket(\stream_bucket_new($brigade, $buffer)); $bucket = $this->getBucket(); $this->setBrigade($bucket); } return; } /** * Test the end-of-bucket. * When testing, set the new bucket object. * * @return bool */ public function eob() { $this->_bucket = null; return \false == $this->getBucket(); } /** * Append bucket to the brigade. * * @param \Hoa\Stream\Bucket $bucket Bucket to add. * @return void */ public function append(\Hoa\Stream\Bucket $bucket) { \stream_bucket_append($this->getBrigade(), $bucket->getBucket()); return; } /** * Prepend bucket to the brigade. * * @param \Hoa\Stream\Bucket $bucket Bucket to add. * @return void */ public function prepend(\Hoa\Stream\Bucket $bucket) { \stream_bucket_prepend($this->getBrigade(), $bucket->getBucket()); return; } /** * Set type. * * @param bool $type Type. Please, see self::IS_A_* constants. * @return bool */ protected function setType($type) { $old = $this->_type; $this->_type = $type; return $old; } /** * Get type. * * @return bool */ public function getType() { return $this->_type; } /** * Set bucket data. * * @param string $data Data to set. * @return string */ public function setData($data) { $old = $this->getBucket()->data; $this->getBucket()->data = $data; $this->getBucket()->datalen = \strlen($this->getBucket()->data); return $old; } /** * Get bucket data. * * @return string */ public function getData() { if (null === $this->getBucket()) { return null; } return $this->getBucket()->data; } /** * Get bucket length. * * @return int */ public function getLength() { if (null === $this->getBucket()) { return 0; } return $this->getBucket()->datalen; } /** * Set the brigade. * * @param resource &$brigade Brigade to add. * @return resource */ protected function setBrigade(&$brigade) { $old = $this->_brigade; $this->_brigade = $brigade; return $old; } /** * Get the brigade. * * @return resource */ public function getBrigade() { return $this->_brigade; } /** * Set bucket. * * @param resource $bucket Bucket. * @return resource */ protected function setBucket($bucket) { $old = $this->_bucket; $this->_bucket = $bucket; return $old; } /** * Get the current bucket. * * @return mixed */ protected function getBucket() { if (null === $this->_bucket && self::IS_A_BRIGADE === $this->getType()) { $this->_bucket = \stream_bucket_make_writeable($this->getBrigade()); } return $this->_bucket; } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Stream; use Hoa\Exception as HoaException; /** * Class \Hoa\Stream\Exception. * * Extending the \Hoa\Exception\Exception class. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Exception extends HoaException { } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Stream; /** * Class \Hoa\Stream\Context. * * Make a multiton of stream contexts. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Context { /** * Context ID. * * @var string */ protected $_id = null; /** * Multiton. * * @var array */ protected static $_instances = []; /** * Construct a context. * */ protected function __construct($id) { $this->_id = $id; $this->_context = \stream_context_create(); return; } /** * Multiton. * * @param string $id ID. * @return \Hoa\Stream\Context * @throws \Hoa\Stream\Exception */ public static function getInstance($id) { if (empty($id)) { throw new \Hoa\Stream\Exception('Context ID must not be null.', 0); } if (\false === static::contextExists($id)) { static::$_instances[$id] = new static($id); } return static::$_instances[$id]; } /** * Get context ID. * * @return string */ public function getId() { return $this->_id; } /** * Check if a context exists. * * @param string $id ID. * @return bool */ public static function contextExists($id) { return \array_key_exists($id, static::$_instances); } /** * Set options. * Please, see http://php.net/context. * * @param array $options Options. * @return bool */ public function setOptions(array $options) { return \stream_context_set_option($this->getContext(), $options); } /** * Set parameters. * Please, see http://php.net/context.params. * * @param array $parameters Parameters. * @return bool */ public function setParameters(array $parameters) { return \stream_context_set_params($this->getContext(), $parameters); } /** * Get options. * * @return array */ public function getOptions() { return \stream_context_get_options($this->getContext()); } /** * Get parameters. * . * @return array */ public function getParameters() { return \stream_context_get_params($this->getContext()); } /** * Get context as a resource. * * @return resource */ public function getContext() { return $this->_context; } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Stream\IStream; /** * Interface \Hoa\Stream\IStream\Touchable. * * Interface for touchable input/output. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ interface Touchable extends \Hoa\Stream\IStream\Stream { /** * Overwrite file if already exists. * * @const bool */ const OVERWRITE = \true; /** * Do not overwrite file if already exists. * * @const bool */ const DO_NOT_OVERWRITE = \false; /** * Make directory if does not exist. * * @const bool */ const MAKE_DIRECTORY = \true; /** * Do not make directory if does not exist. * * @const bool */ const DO_NOT_MAKE_DIRECTORY = \false; /** * Set access and modification time of file. * * @param int $time Time. If equals to -1, time() should be used. * @param int $atime Access time. If equals to -1, $time should be * used. * @return bool */ public function touch($time = -1, $atime = -1); /** * Copy file. * Return the destination file path if succeed, false otherwise. * * @param string $to Destination path. * @param bool $force Force to copy if the file $to already exists. * Use the self::*OVERWRITE constants. * @return bool */ public function copy($to, $force = self::DO_NOT_OVERWRITE); /** * Move a file. * * @param string $name New name. * @param bool $force Force to move if the file $name already * exists. * Use the self::*OVERWRITE constants. * @param bool $mkdir Force to make directory if does not exist. * Use the self::*DIRECTORY constants. * @return bool */ public function move($name, $force = self::DO_NOT_OVERWRITE, $mkdir = self::DO_NOT_MAKE_DIRECTORY); /** * Delete a file. * * @return bool */ public function delete(); /** * Change file group. * * @param mixed $group Group name or number. * @return bool */ public function changeGroup($group); /** * Change file mode. * * @param int $mode Mode (in octal!). * @return bool */ public function changeMode($mode); /** * Change file owner. * * @param mixed $user User. * @return bool */ public function changeOwner($user); /** * Change the current umask. * * @param int $umask Umask (in octal!). If null, given the current * umask value. * @return int */ public static function umask($umask = null); } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Stream\IStream; /** * Interface \Hoa\Stream\IStream\Lockable. * * Interface for lockable input/output. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ interface Lockable extends \Hoa\Stream\IStream\Stream { /** * Acquire a shared lock (reader). * * @const int */ const LOCK_SHARED = \LOCK_SH; /** * Acquire an exclusive lock (writer). * * @const int */ const LOCK_EXCLUSIVE = \LOCK_EX; /** * Release a lock (shared or exclusive). * * @const int */ const LOCK_RELEASE = \LOCK_UN; /** * If we do not want $this->lock() to block while locking. * * @const int */ const LOCK_NO_BLOCK = \LOCK_NB; /** * Portable advisory locking. * Should take a look at stream_supports_lock(). * * @param int $operation Operation, use the self::LOCK_* constants. * @return bool */ public function lock($operation); } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Stream\IStream; /** * Interface \Hoa\Stream\IStream\Pathable. * * Interface for pathable input/output. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ interface Pathable extends \Hoa\Stream\IStream\Stream { /** * Get filename component of path. * * @return string */ public function getBasename(); /** * Get directory name component of path. * * @return string */ public function getDirname(); } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Stream\IStream; /** * Interface \Hoa\Stream\IStream\Out. * * Interface for output. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ interface Out extends \Hoa\Stream\IStream\Stream { /** * Write n characters. * * @param string $string String. * @param int $length Length. * @return mixed */ public function write($string, $length); /** * Write a string. * * @param string $string String. * @return mixed */ public function writeString($string); /** * Write a character. * * @param string $character Character. * @return mixed */ public function writeCharacter($character); /** * Write a boolean. * * @param bool $boolean Boolean. * @return mixed */ public function writeBoolean($boolean); /** * Write an integer. * * @param int $integer Integer. * @return mixed */ public function writeInteger($integer); /** * Write a float. * * @param float $float Float. * @return mixed */ public function writeFloat($float); /** * Write an array. * * @param array $array Array. * @return mixed */ public function writeArray(array $array); /** * Write a line. * * @param string $line Line. * @return mixed */ public function writeLine($line); /** * Write all, i.e. as much as possible. * * @param string $string String. * @return mixed */ public function writeAll($string); /** * Truncate a stream to a given length. * * @param int $size Size. * @return bool */ public function truncate($size); } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Stream\IStream; /** * Interface \Hoa\Stream\IStream\Pointable. * * Interface for pointable input/output. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ interface Pointable extends \Hoa\Stream\IStream\Stream { /** * Set position equal to $offset bytes. * * @const int */ const SEEK_SET = \SEEK_SET; /** * Set position to current location plus $offset. * * @const int */ const SEEK_CURRENT = \SEEK_CUR; /** * Set position to end-of-file plus $offset. * * @const int */ const SEEK_END = \SEEK_END; /** * Rewind the position of a stream pointer. * * @return bool */ public function rewind(); /** * Seek on a stream pointer. * * @param int $offset Offset (negative value should be supported). * @param int $whence Whence, use the self::SEEK_* constants. * @return int */ public function seek($offset, $whence = self::SEEK_SET); /** * Get the current position of the stream pointer. * * @return int */ public function tell(); } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Stream\IStream; /** * Interface \Hoa\Stream\IStream\Statable. * * Interface for statable input/output. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ interface Statable extends \Hoa\Stream\IStream\Stream { /** * Size is undefined. * * @const int */ const SIZE_UNDEFINED = -1; /** * Get size. * * @return int */ public function getSize(); /** * Get informations about a file. * * @return array */ public function getStatistic(); /** * Get last access time of file. * * @return int */ public function getATime(); /** * Get inode change time of file. * * @return int */ public function getCTime(); /** * Get file modification time. * * @return int */ public function getMTime(); /** * Get file group. * * @return int */ public function getGroup(); /** * Get file owner. * * @return int */ public function getOwner(); /** * Get file permissions. * * @return int */ public function getPermissions(); /** * Check if the file is readable. * * @return bool */ public function isReadable(); /** * Check if the file is writable. * * @return bool */ public function isWritable(); /** * Check if the file is executable. * * @return bool */ public function isExecutable(); /** * Clear file status cache. * * @return void */ public function clearStatisticCache(); /** * Clear all files status cache. * * @return void */ public static function clearAllStatisticCaches(); } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Stream\IStream; /** * Interface \Hoa\Stream\IStream\In. * * Interface for input. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ interface In extends \Hoa\Stream\IStream\Stream { /** * Test for end-of-stream. * * @return bool */ public function eof(); /** * Read n characters. * * @param int $length Length. * @return string */ public function read($length); /** * Alias of $this->read(). * * @param int $length Length. * @return string */ public function readString($length); /** * Read a character. * It could be equivalent to $this->read(1). * * @return string */ public function readCharacter(); /** * Read a boolean. * * @return bool */ public function readBoolean(); /** * Read an integer. * * @param int $length Length. * @return int */ public function readInteger($length = 1); /** * Read a float. * * @param int $length Length. * @return float */ public function readFloat($length = 1); /** * Read an array. * In most cases, it could be an alias to the $this->scanf() method. * * @param mixed $argument Argument (because the behavior is very * different according to the implementation). * @return array */ public function readArray($argument = null); /** * Read a line. * * @return string */ public function readLine(); /** * Read all, i.e. read as much as possible. * * @param int $offset Offset. * @return string */ public function readAll($offset = 0); /** * Parse input from a stream according to a format. * * @param string $format Format (see printf's formats). * @return array */ public function scanf($format); } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Stream\IStream; /** * Interface \Hoa\Stream\IStream\Stream. * * Interface for all streams. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ interface Stream { /** * Get the current stream. * * @return resource */ public function getStream(); } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Stream\IStream; /** * Interface \Hoa\Stream\IStream\Bufferable. * * Interface for bufferable streams. It's complementary to native buffer support * of Hoa\Stream (please, see *StreamBuffer*() methods). Classes implementing * this interface are able to create nested buffers, flush them etc. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ interface Bufferable extends \Hoa\Stream\IStream\Stream { /** * Start a new buffer. * The callable acts like a light filter. * * @param mixed $callable Callable. * @param int $size Size. * @return int */ public function newBuffer($callable = null, $size = null); /** * Flush the buffer. * * @return void */ public function flush(); /** * Delete buffer. * * @return bool */ public function deleteBuffer(); /** * Get bufffer level. * * @return int */ public function getBufferLevel(); /** * Get buffer size. * * @return int */ public function getBufferSize(); } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Stream\IStream; /** * Interface \Hoa\Stream\IStream\Structural. * * Interface for structural input/output. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ interface Structural extends \Hoa\Stream\IStream\Stream { /** * Select root of the document: :root. * * @return \Hoa\Stream\IStream\Structural */ public function selectRoot(); /** * Select any elements: *. * * @return array */ public function selectAnyElements(); /** * Select elements of type E: E. * * @param string $E Element E. * @return array */ public function selectElements($E = null); /** * Select F elements descendant of an E element: E F. * * @param string $F Element F. * @return array */ public function selectDescendantElements($F = null); /** * Select F elements children of an E element: E > F. * * @param string $F Element F. * @return array */ public function selectChildElements($F = null); /** * Select an F element immediately preceded by an E element: E + F. * * @param string $F Element F. * @return \Hoa\Stream\IStream\Structural */ public function selectAdjacentSiblingElement($F); /** * Select F elements preceded by an E element: E ~ F. * * @param string $F Element F. * @return array */ public function selectSiblingElements($F = null); /** * Execute a query selector and return the first result. * * @param string $query Query. * @return \Hoa\Stream\IStream\Structural */ public function querySelector($query); /** * Execute a query selector and return one or many results. * * @param string $query Query. * @return array */ public function querySelectorAll($query); } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Stream\Filter; use Hoa\Stream; /** * Class \Hoa\Stream\Filter\Exception. * * Extending the \Hoa\Stream\Exception class. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Exception extends Stream\Exception { } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Stream\Filter; use Hoa\Stream; /** * Class \Hoa\Stream\Filter\Basic. * * Basic filter. Force to implement some methods. * Actually, it extends the php_user_filter class. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ abstract class Basic extends \php_user_filter implements Stream\IStream\Stream { /** * Filter processed successfully with data available in the out bucket * brigade. * * @const int */ const PASS_ON = \PSFS_PASS_ON; /** * Filter processed successfully, however no data was available to return. * More data is required from the stream or prior filter. * * @const int */ const FEED_ME = \PSFS_FEED_ME; /** * The filter experienced and unrecoverable error and cannot continue. * * @const int */ const FATAL_ERROR = \PSFS_ERR_FATAL; /** * Regular read/write. * * @const int */ const FLAG_NORMAL = \PSFS_FLAG_NORMAL; /** * An incremental flush. * * @const int */ const FLAG_FLUSH_INC = \PSFS_FLAG_FLUSH_INC; /** * Final flush prior to closing. * * @const int */ const FLAG_FLUSH_CLOSE = \PSFS_FLAG_FLUSH_CLOSE; /** * Filter data. * This method is called whenever data is read from or written to the attach * stream. * * @param resource $in A resource pointing to a bucket brigade * which contains one or more bucket * objects containing data to be filtered. * @param resource $out A resource pointing to a second bucket * brigade into which your modified buckets * should be replaced. * @param int &$consumed Which must always be declared by * reference, should be incremented by the * length of the data which your filter * reads in and alters. * @param bool $closing If the stream is in the process of * closing (and therefore this is the last * pass through the filterchain), the * closing parameter will be set to true. * @return int */ public function filter($in, $out, &$consumed, $closing) { $iBucket = new Stream\Bucket($in); $oBucket = new Stream\Bucket($out); while (\false === $iBucket->eob()) { $consumed += $iBucket->getLength(); $oBucket->append($iBucket); } unset($iBucket); unset($oBucket); return self::PASS_ON; } /** * Called during instanciation of the filter class object. * * @return bool */ public function onCreate() { return \true; } /** * Called upon filter shutdown (typically, this is also during stream * shutdown), and is executed after the flush method is called. * * @return void */ public function onClose() { return; } /** * Set the filter name. * * @param string $name Filter name. * @return string */ public function setName($name) { $old = $this->filtername; $this->filtername = $name; return $old; } /** * Set the filter parameters. * * @param mixed $parameters Filter parameters. * @return mixed */ public function setParameters($parameters) { $old = $this->params; $this->params = $parameters; return $old; } /** * Get the filter name. * * @return string */ public function getName() { return $this->filtername; } /** * Get the filter parameters. * * @return mixed */ public function getParameters() { return $this->params; } /** * Get the stream resource being filtered. * Maybe available only during **filter** calls when the closing parameter * is set to false. * * @return resource */ public function getStream() { return isset($this->stream) ? $this->stream : null; } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Stream\Filter; use Hoa\Consistency; use Hoa\Stream; /** * Class \Hoa\Stream\Filter. * * Proposes some methods to handle filter. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ abstract class Filter extends Stream { /** * Overwrite filter if already exists. * * @const bool */ const OVERWRITE = \true; /** * Do not overwrite filter if already exists. * * @const bool */ const DO_NOT_OVERWRITE = \false; /** * Filter should only be applied when reading. * * @const int */ const READ = \STREAM_FILTER_READ; /** * Filter should only be applied when writing. * * @const int */ const WRITE = \STREAM_FILTER_WRITE; /** * Filter should be applied when reading and writing. * * @const int */ const READ_AND_WRITE = \STREAM_FILTER_ALL; /** * All resources with at least one filter registered. * * @var array */ protected static $_resources = []; /** * Register a stream filter. * * @param string $name Filter name. * @param mixed $class Class name or instance. * @param bool $overwrite Overwrite filter if already exists or * not. Given by self::*OVERWRITE constants. * @return bool * @throws \Hoa\Stream\Filter\Exception */ public static function register($name, $class, $overwrite = self::DO_NOT_OVERWRITE) { if ($overwrite === self::DO_NOT_OVERWRITE && \true === self::isRegistered($name)) { throw new \Hoa\Stream\Filter\Exception('Filter %s is already registered.', 0, $name); } if (\is_object($class)) { $class = \get_class($class); } if (empty($name)) { throw new \Hoa\Stream\Filter\Exception('Filter name cannot be empty (implementation class is %s).', 1, $class); } if (\false === \class_exists($class, \false)) { throw new \Hoa\Stream\Filter\Exception('Cannot register the %s class for the filter %s ' . 'because it does not exist.', 2, [$class, $name]); } return \stream_filter_register($name, $class); } /** * Append a filter to the list of filters. * * @param mixed $stream Stream which received the filter. * Should be resource or an object * of kind `Hoa\Stream`. * @param string $name Filter name. * @param int $mode `self::READ`, `self::WRITE` or * `self::READ_AND_WRITE`. * @param mixed $parameters Parameters. * @return resource */ public static function append($stream, $name, $mode = self::READ, $parameters = null) { if ($stream instanceof Stream) { $stream = $stream->getStream(); } if (null === $parameters) { return self::$_resources[$name] = \stream_filter_append($stream, $name, $mode); } return self::$_resources[$name] = \stream_filter_append($stream, $name, $mode, $parameters); } /** * Prepend a filter to the list of filters. * * @param mixed $stream Stream which received the filter. * Should be resource or an object * \Hoa\Stream. * @param string $name Filter name. * @param int $mode self::READ, self::WRITE or * self::READ_AND_WRITE. * @param mixed $parameters Parameters. * @return resource */ public static function prepend($stream, $name, $mode = self::READ, $parameters = null) { if ($stream instanceof Stream) { $stream = $stream->getStream(); } if (null === $parameters) { return self::$_resources[$name] = \stream_filter_prepend($stream, $name, $mode); } return self::$_resources[$name] = \stream_filter_prepend($stream, $name, $mode, $parameters); } /** * Delete a filter. * * @param mixed $streamFilter Stream filter resource or name. * @return bool * @throws \Hoa\Stream\Filter\Exception */ public static function remove($streamFilter) { if (!\is_resource($streamFilter)) { if (isset(self::$_resources[$streamFilter])) { $streamFilter = self::$_resources[$streamFilter]; } else { throw new \Hoa\Stream\Filter\Exception('Cannot remove the stream filter %s because no resource was ' . 'found with this name.', 3, $streamFilter); } } return \stream_filter_remove($streamFilter); } /** * Check if a filter is already registered or not. * * @param string $name Filter name. * @return bool */ public static function isRegistered($name) { return \in_array($name, self::getRegistered()); } /** * Get all registered filer names. * * @return array */ public static function getRegistered() { return \stream_get_filters(); } } /** * Flex entity. */ Consistency::flexEntity('Hoa\\Stream\\Filter\\Filter'); <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Stream\Filter; use Hoa\Stream; /** * Class \Hoa\Stream\Filter\LateComputed. * * A late computed filter computes the data when closing the filtering. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ abstract class LateComputed extends \Hoa\Stream\Filter\Basic { /** * Buffer. * * @var string */ protected $_buffer = null; /** * Filter data. * This method is called whenever data is read from or written to the attach * stream. * * @param resource $in A resource pointing to a bucket brigade * which contains one or more bucket * objects containing data to be filtered. * @param resource $out A resource pointing to a second bucket * brigade into which your modified buckets * should be replaced. * @param int &$consumed Which must always be declared by * reference, should be incremented by the * length of the data which your filter * reads in and alters. * @param bool $closing If the stream is in the process of * closing (and therefore this is the last * pass through the filterchain), the * closing parameter will be set to true. * @return int */ public function filter($in, $out, &$consumed, $closing) { $return = self::FEED_ME; $iBucket = new Stream\Bucket($in); while (\false === $iBucket->eob()) { $this->_buffer .= $iBucket->getData(); $consumed += $iBucket->getLength(); } if (null !== $consumed) { $return = self::PASS_ON; } if (\true === $closing) { $stream = $this->getStream(); $this->compute(); $bucket = new Stream\Bucket($stream, Stream\Bucket::IS_A_STREAM, $this->_buffer); $oBucket = new Stream\Bucket($out); $oBucket->append($bucket); $return = self::PASS_ON; $this->_buffer = null; } return $return; } /** * Compute the whole data (stored in $this->_buffer). * * @return string */ protected abstract function compute(); } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Stream\Wrapper\IWrapper; /** * Interface \Hoa\Stream\Wrapper\IWrapper\File. * * Interface for “file stream wrapper” class. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ interface File { /** * Close directory handle. * This method is called in to closedir(). * Any resources which were locked, or allocated, during opening and use of * the directory stream should be released. * * @return bool */ public function dir_closedir(); /** * Open directory handle. * This method is called in response to opendir(). * * @param string $path Specifies the URL that was passed to opendir(). * @param int $options Whether or not to enforce safe_mode (0x04). * @return bool */ public function dir_opendir($path, $options); /** * Read entry from directory handle. * This method is called in response to readdir(). * * @return mixed */ public function dir_readdir(); /** * Rewind directory handle. * This method is called in response to rewinddir(). * Should reset the output generated by self::dir_readdir, i.e. the next * call to self::dir_readdir should return the first entry in the location * returned by self::dir_opendir. * * @return bool */ public function dir_rewinddir(); /** * Create a directory. * This method is called in response to mkdir(). * * @param string $path Directory which should be created. * @param int $mode The value passed to mkdir(). * @param int $options A bitwise mask of values. * @return bool */ public function mkdir($path, $mode, $options); /** * Rename a file or directory. * This method is called in response to rename(). * Should attempt to rename $from to $to. * * @param string $from The URL to current file. * @param string $to The URL which $from should be renamed to. * @return bool */ public function rename($from, $to); /** * Remove a directory. * This method is called in response to rmdir(). * * @param string $path The directory URL which should be removed. * @param int $options A bitwise mask of values. * @return bool */ public function rmdir($path, $options); /** * Delete a file. * This method is called in response to unlink(). * * @param string $path The file URL which should be deleted. * @return bool */ public function unlink($path); /** * Retrieve information about a file. * This method is called in response to all stat() related functions. * * @param string $path The file URL which should be retrieve * information about. * @param int $flags Holds additional flags set by the streams API. * It can hold one or more of the following * values OR'd together. * STREAM_URL_STAT_LINK: for resource with the * ability to link to other resource (such as an * HTTP location: forward, or a filesystem * symlink). This flag specified that only * information about the link itself should be * returned, not the resource pointed to by the * link. This flag is set in response to calls to * lstat(), is_link(), or filetype(). * STREAM_URL_STAT_QUIET: if this flag is set, * our wrapper should not raise any errors. If * this flag is not set, we are responsible for * reporting errors using the trigger_error() * function during stating of the path. * @return array */ public function url_stat($path, $flags); } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Stream\Wrapper\IWrapper; /** * Interface \Hoa\Stream\Wrapper\IWrapper\Stream. * * Interface for “stream stream wrapper” class. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ interface Stream { /** * Retrieve the underlaying resource. * * @param int $castAs Can be STREAM_CAST_FOR_SELECT when * stream_select() is calling stream_cast() or * STREAM_CAST_AS_STREAM when stream_cast() is * called for other uses. * @return resource */ public function stream_cast($castAs); /** * Close a resource. * This method is called in response to fclose(). * All resources that were locked, or allocated, by the wrapper should be * released. * * @return void */ public function stream_close(); /** * Tests for end-of-file on a file pointer. * This method is called in response to feof(). * * @return bool */ public function stream_eof(); /** * Flush the output. * This method is called in response to fflush(). * If we have cached data in our stream but not yet stored it into the * underlying storage, we should do so now. * * @return bool */ public function stream_flush(); /** * Advisory file locking. * This method is called in response to flock(), when file_put_contents() * (when flags contains LOCK_EX), stream_set_blocking() and when closing the * stream (LOCK_UN). * * @param int $operation Operation is one the following: * * LOCK_SH to acquire a shared lock (reader) ; * * LOCK_EX to acquire an exclusive lock (writer) ; * * LOCK_UN to release a lock (shared or exclusive) ; * * LOCK_NB if we don't want flock() to * block while locking (not supported on * Windows). * @return bool */ public function stream_lock($operation); /** * Change stream options. * This method is called to set metadata on the stream. It is called when * one of the following functions is called one a stream URL: touch, chmod, * chown or chgrp. * * @param string $path The file path or URL to set metadata. * @param int $option One of the following: * * STREAM_META_TOUCH, * * STREAM_META_OWNER_NAME, * * STREAM_META_OWNER, * * STREAM_META_GROUP_NAME, * * STREAM_META_GROUP, * * STREAM_META_ACCESS. * @param mixed $value An array or a scalar depending of the option. * @return bool */ public function stream_metadata($path, $option, $value); /** * Open file or URL. * This method is called immediately after the wrapper is initialized (f.e. * by fopen() and file_get_contents()). * * @param string $path Specifies the URL that was passed to the * original function. * @param string $mode The mode used to open the file, as * detailed for fopen(). * @param int $options Holds additional flags set by the * streams API. It can hold one or more of * the following values OR'd together: * * STREAM_USE_PATH, if path is relative, * search for the resource using the * include_path; * * STREAM_REPORT_ERRORS, if this is * set, you are responsible for raising * errors using trigger_error during * opening the stream. If this is not * set, you should not raise any errors. * @param string &$openedPath If the $path is opened successfully, and * STREAM_USE_PATH is set in $options, * $openedPath should be set to the full * path of the file/resource that was * actually opened. * @return bool */ public function stream_open($path, $mode, $options, &$openedPath); /** * Read from stream. * This method is called in response to fread() and fgets(). * * @param int $count How many bytes of data from the current * position should be returned. * @return string */ public function stream_read($count); /** * Seek to specific location in a stream. * This method is called in response to fseek(). * The read/write position of the stream should be updated according to the * $offset and $whence. * * @param int $offset The stream offset to seek to. * @param int $whence Possible values: * * SEEK_SET to set position equal to $offset * bytes ; * * SEEK_CUR to set position to current * location plus $offsete ; * * SEEK_END to set position to end-of-file * plus $offset. * @return bool */ public function stream_seek($offset, $whence = \SEEK_SET); /** * Change stream options. * This method is called to set options on the stream. * * @param int $option One of: * * STREAM_OPTION_BLOCKING, the method was * called in response to * stream_set_blocking() ; * * STREAM_OPTION_READ_TIMEOUT, the method * was called in response to * stream_set_timeout() ; * * STREAM_OPTION_WRITE_BUFFER, the method * was called in response to * stream_set_write_buffer(). * @param int $arg1 If $option is: * * STREAM_OPTION_BLOCKING: requested blocking * mode (1 meaning block, 0 not blocking) ; * * STREAM_OPTION_READ_TIMEOUT: the timeout * in seconds ; * * STREAM_OPTION_WRITE_BUFFER: buffer mode * (STREAM_BUFFER_NONE or * STREAM_BUFFER_FULL). * @param int $arg2 If $option is: * * STREAM_OPTION_BLOCKING: this option is * not set ; * * STREAM_OPTION_READ_TIMEOUT: the timeout * in microseconds ; * * STREAM_OPTION_WRITE_BUFFER: the requested * buffer size. * @return bool */ public function stream_set_option($option, $arg1, $arg2); /** * Retrieve information about a file resource. * This method is called in response to fstat(). * * @return array */ public function stream_stat(); /** * Retrieve the current position of a stream. * This method is called in response to ftell(). * * @return int */ public function stream_tell(); /** * Truncate a stream to a given length. * * @param int $size Size. * @return bool */ public function stream_truncate($size); /** * Write to stream. * This method is called in response to fwrite(). * * @param string $data Should be stored into the underlying stream. * @return int */ public function stream_write($data); } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Stream\Wrapper\IWrapper; use Hoa\Consistency; /** * Interface \Hoa\Stream\Wrapper\IWrapper. * * Interface for stream wrapper class. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ interface IWrapper extends \Hoa\Stream\Wrapper\IWrapper\File, \Hoa\Stream\Wrapper\IWrapper\Stream { /** * Constructs a new stream wrapper. * Called when opening the stream wrapper, right before self::stream_open(). * */ public function __construct(); } /** * Flex entity. */ Consistency::flexEntity('Hoa\\Stream\\Wrapper\\IWrapper\\IWrapper'); <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Stream\Wrapper; use Hoa\Stream; /** * Class \Hoa\Stream\Wrapper\Exception. * * Extending the \Hoa\Stream\Exception class. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Exception extends Stream\Exception { } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Stream\Wrapper; use Hoa\Consistency; /** * Class \Hoa\Stream\Wrapper. * * Manipulate wrappers. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Wrapper { /** * Register a wrapper. * * @param string $protocol The wrapper name to be registered. * @param string $className Class name which implements the protocol. * @param int $flags Should be set to `STREAM_IS_URL` if * `$protocol` is a URL protocol. Default is 0, * local stream. * @return bool * @throws \Hoa\Stream\Wrapper\Exception */ public static function register($protocol, $className, $flags = 0) { if (\true === self::isRegistered($protocol)) { throw new \Hoa\Stream\Wrapper\Exception('The protocol %s is already registered.', 0, $protocol); } if (\false === \class_exists($className)) { throw new \Hoa\Stream\Wrapper\Exception('Cannot use the %s class for the implementation of ' . 'the %s protocol because it is not found.', 1, [$className, $protocol]); } return \stream_wrapper_register($protocol, $className, $flags); } /** * Unregister a wrapper. * * @param string $protocol The wrapper name to be unregistered. * @return bool */ public static function unregister($protocol) { // Silent errors if `$protocol` does not exist. This function already // returns `false` in this case, which is the strict expected // behaviour. return @\stream_wrapper_unregister($protocol); } /** * Restore a previously unregistered build-in wrapper. * * @param string $protocol The wrapper name to be restored. * @return bool */ public static function restore($protocol) { // Silent errors if `$protocol` does not exist. This function already // returns `false` in this case, which is the strict expected // behaviour. return @\stream_wrapper_restore($protocol); } /** * Check if a protocol is registered or not. * * @param string $protocol Protocol name. * @return bool */ public static function isRegistered($protocol) { return \in_array($protocol, self::getRegistered()); } /** * Get all registered wrapper. * * @return array */ public static function getRegistered() { return \stream_get_wrappers(); } } /** * Flex entity. */ Consistency::flexEntity('Hoa\\Stream\\Wrapper\\Wrapper'); <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Stream; use Hoa\Consistency; use Hoa\Event; use Hoa\Protocol; /** * Class \Hoa\Stream. * * Static register for all streams (files, sockets etc.). * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ abstract class Stream implements \Hoa\Stream\IStream\Stream, Event\Listenable { use Event\Listens; /** * Name index in the stream bucket. * * @const int */ const NAME = 0; /** * Handler index in the stream bucket. * * @const int */ const HANDLER = 1; /** * Resource index in the stream bucket. * * @const int */ const RESOURCE = 2; /** * Context index in the stream bucket. * * @const int */ const CONTEXT = 3; /** * Default buffer size. * * @const int */ const DEFAULT_BUFFER_SIZE = 8192; /** * Current stream bucket. * * @var array */ protected $_bucket = []; /** * Static stream register. * * @var array */ private static $_register = []; /** * Buffer size (default is 8Ko). * * @var bool */ protected $_bufferSize = self::DEFAULT_BUFFER_SIZE; /** * Original stream name, given to the stream constructor. * * @var string */ protected $_streamName = null; /** * Context name. * * @var string */ protected $_context = null; /** * Whether the opening has been deferred. * * @var bool */ protected $_hasBeenDeferred = \false; /** * Whether this stream is already opened by another handler. * * @var bool */ protected $_borrowing = \false; /** * Set the current stream. * If not exists in the register, try to call the * `$this->_open()` method. Please, see the `self::_getStream()` method. * * @param string $streamName Stream name (e.g. path or URL). * @param string $context Context ID (please, see the * `Hoa\Stream\Context` class). * @param bool $wait Differ opening or not. */ public function __construct($streamName, $context = null, $wait = \false) { $this->_streamName = $streamName; $this->_context = $context; $this->_hasBeenDeferred = $wait; $this->setListener(new Event\Listener($this, ['authrequire', 'authresult', 'complete', 'connect', 'failure', 'mimetype', 'progress', 'redirect', 'resolve', 'size'])); if (\true === $wait) { return; } $this->open(); return; } /** * Get a stream in the register. * If the stream does not exist, try to open it by calling the * $handler->_open() method. * * @param string $streamName Stream name. * @param \Hoa\Stream $handler Stream handler. * @param string $context Context ID (please, see the * \Hoa\Stream\Context class). * @return array * @throws \Hoa\Stream\Exception */ private static function &_getStream($streamName, \Hoa\Stream\Stream $handler, $context = null) { $name = \md5($streamName); if (null !== $context) { if (\false === \Hoa\Stream\Context::contextExists($context)) { throw new \Hoa\Stream\Exception('Context %s was not previously declared, cannot retrieve ' . 'this context.', 0, $context); } $context = \Hoa\Stream\Context::getInstance($context); } if (!isset(self::$_register[$name])) { self::$_register[$name] = [self::NAME => $streamName, self::HANDLER => $handler, self::RESOURCE => $handler->_open($streamName, $context), self::CONTEXT => $context]; Event::register('hoa://Event/Stream/' . $streamName, $handler); // Add :open-ready? Event::register('hoa://Event/Stream/' . $streamName . ':close-before', $handler); } else { $handler->_borrowing = \true; } if (null === self::$_register[$name][self::RESOURCE]) { self::$_register[$name][self::RESOURCE] = $handler->_open($streamName, $context); } return self::$_register[$name]; } /** * Open the stream and return the associated resource. * Note: This method is protected, but do not forget that it could be * overloaded into a public context. * * @param string $streamName Stream name (e.g. path or URL). * @param \Hoa\Stream\Context $context Context. * @return resource * @throws \Hoa\Exception\Exception */ protected abstract function &_open($streamName, ?\Hoa\Stream\Context $context = null); /** * Close the current stream. * Note: this method is protected, but do not forget that it could be * overloaded into a public context. * * @return bool */ protected abstract function _close(); /** * Open the stream. * * @return \Hoa\Stream * @throws \Hoa\Stream\Exception */ public final function open() { $context = $this->_context; if (\true === $this->hasBeenDeferred()) { if (null === $context) { $handle = \Hoa\Stream\Context::getInstance(\uniqid()); $handle->setParameters(['notification' => [$this, '_notify']]); $context = $handle->getId(); } elseif (\true === \Hoa\Stream\Context::contextExists($context)) { $handle = \Hoa\Stream\Context::getInstance($context); $parameters = $handle->getParameters(); if (!isset($parameters['notification'])) { $handle->setParameters(['notification' => [$this, '_notify']]); } } } $this->_bufferSize = self::DEFAULT_BUFFER_SIZE; $this->_bucket = self::_getStream($this->_streamName, $this, $context); return $this; } /** * Close the current stream. * * @return void */ public final function close() { $streamName = $this->getStreamName(); $name = \md5($streamName); if (!isset(self::$_register[$name])) { return; } Event::notify('hoa://Event/Stream/' . $streamName . ':close-before', $this, new Event\Bucket()); if (\false === $this->_close()) { return; } unset(self::$_register[$name]); $this->_bucket[self::HANDLER] = null; Event::unregister('hoa://Event/Stream/' . $streamName); Event::unregister('hoa://Event/Stream/' . $streamName . ':close-before'); return; } /** * Get the current stream name. * * @return string */ public function getStreamName() { if (empty($this->_bucket)) { return null; } return $this->_bucket[self::NAME]; } /** * Get the current stream. * * @return resource */ public function getStream() { if (empty($this->_bucket)) { return null; } return $this->_bucket[self::RESOURCE]; } /** * Get the current stream context. * * @return \Hoa\Stream\Context */ public function getStreamContext() { if (empty($this->_bucket)) { return null; } return $this->_bucket[self::CONTEXT]; } /** * Get stream handler according to its name. * * @param string $streamName Stream name. * @return \Hoa\Stream */ public static function getStreamHandler($streamName) { $name = \md5($streamName); if (!isset(self::$_register[$name])) { return null; } return self::$_register[$name][self::HANDLER]; } /** * Set the current stream. Useful to manage a stack of streams (e.g. socket * and select). Notice that it could be unsafe to use this method without * taking time to think about it two minutes. Resource of type “Unknown” is * considered as valid. * * @return resource * @throws \Hoa\Stream\Exception */ public function _setStream($stream) { if (\false === \is_resource($stream) && ('resource' !== \gettype($stream) || 'Unknown' !== \get_resource_type($stream))) { throw new \Hoa\Stream\Exception('Try to change the stream resource with an invalid one; ' . 'given %s.', 1, \gettype($stream)); } $old = $this->_bucket[self::RESOURCE]; $this->_bucket[self::RESOURCE] = $stream; return $old; } /** * Check if the stream is opened. * * @return bool */ public function isOpened() { return \is_resource($this->getStream()); } /** * Set the timeout period. * * @param int $seconds Timeout period in seconds. * @param int $microseconds Timeout period in microseconds. * @return bool */ public function setStreamTimeout($seconds, $microseconds = 0) { return \stream_set_timeout($this->getStream(), $seconds, $microseconds); } /** * Whether the opening of the stream has been deferred */ protected function hasBeenDeferred() { return $this->_hasBeenDeferred; } /** * Check whether the connection has timed out or not. * This is basically a shortcut of `getStreamMetaData` + the `timed_out` * index, but the resulting code is more readable. * * @return bool */ public function hasTimedOut() { $metaData = $this->getStreamMetaData(); return \true === $metaData['timed_out']; } /** * Set blocking/non-blocking mode. * * @param bool $mode Blocking mode. * @return bool */ public function setStreamBlocking($mode) { return \stream_set_blocking($this->getStream(), (int) $mode); } /** * Set stream buffer. * Output using fwrite() (or similar function) is normally buffered at 8 Ko. * This means that if there are two processes wanting to write to the same * output stream, each is paused after 8 Ko of data to allow the other to * write. * * @param int $buffer Number of bytes to buffer. If zero, write * operations are unbuffered. This ensures that * all writes are completed before other * processes are allowed to write to that output * stream. * @return bool */ public function setStreamBuffer($buffer) { // Zero means success. $out = 0 === \stream_set_write_buffer($this->getStream(), $buffer); if (\true === $out) { $this->_bufferSize = $buffer; } return $out; } /** * Disable stream buffering. * Alias of $this->setBuffer(0). * * @return bool */ public function disableStreamBuffer() { return $this->setStreamBuffer(0); } /** * Get stream buffer size. * * @return int */ public function getStreamBufferSize() { return $this->_bufferSize; } /** * Get stream wrapper name. * * @return string */ public function getStreamWrapperName() { if (\false === ($pos = \strpos($this->getStreamName(), '://'))) { return 'file'; } return \substr($this->getStreamName(), 0, $pos); } /** * Get stream meta data. * * @return array */ public function getStreamMetaData() { return \stream_get_meta_data($this->getStream()); } /** * Whether this stream is already opened by another handler. * * @return bool */ public function isBorrowing() { return $this->_borrowing; } /** * Notification callback. * * @param int $ncode Notification code. Please, see * STREAM_NOTIFY_* constants. * @param int $severity Severity. Please, see * STREAM_NOTIFY_SEVERITY_* constants. * @param string $message Message. * @param int $code Message code. * @param int $transferred If applicable, the number of transferred * bytes. * @param int $max If applicable, the number of max bytes. * @return void */ public function _notify($ncode, $severity, $message, $code, $transferred, $max) { static $_map = [\STREAM_NOTIFY_AUTH_REQUIRED => 'authrequire', \STREAM_NOTIFY_AUTH_RESULT => 'authresult', \STREAM_NOTIFY_COMPLETED => 'complete', \STREAM_NOTIFY_CONNECT => 'connect', \STREAM_NOTIFY_FAILURE => 'failure', \STREAM_NOTIFY_MIME_TYPE_IS => 'mimetype', \STREAM_NOTIFY_PROGRESS => 'progress', \STREAM_NOTIFY_REDIRECTED => 'redirect', \STREAM_NOTIFY_RESOLVE => 'resolve', \STREAM_NOTIFY_FILE_SIZE_IS => 'size']; $this->getListener()->fire($_map[$ncode], new Event\Bucket(['code' => $code, 'severity' => $severity, 'message' => $message, 'transferred' => $transferred, 'max' => $max])); return; } /** * Call the $handler->close() method on each stream in the static stream * register. * This method does not check the return value of $handler->close(). Thus, * if a stream is persistent, the $handler->close() should do anything. It * is a very generic method. * * @return void */ public static final function _Hoa_Stream() { foreach (self::$_register as $entry) { $entry[self::HANDLER]->close(); } return; } /** * Transform object to string. * * @return string */ public function __toString() { return $this->getStreamName(); } /** * Close the stream when destructing. * * @return void */ public function __destruct() { if (\false === $this->isOpened()) { return; } $this->close(); return; } } /** * Class \Hoa\Stream\_Protocol. * * The `hoa://Library/Stream` node. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class _Protocol extends Protocol\Node { /** * Component's name. * * @var string */ protected $_name = 'Stream'; /** * ID of the component. * * @param string $id ID of the component. * @return mixed */ public function reachId($id) { return \Hoa\Stream\Stream::getStreamHandler($id); } } /** * Flex entity. */ Consistency::flexEntity('Hoa\\Stream\\Stream'); /** * Add the `hoa://Library/Stream` node. Should be use to reach/get an entry * in the stream register. */ $protocol = Protocol::getInstance(); $protocol['Library'][] = new \Hoa\Stream\_Protocol(); <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Stream; /** * Class \Hoa\Stream\Composite. * * Declare a composite stream, i.e. a stream that uses a stream. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ abstract class Composite { /** * Current stream. * * @var mixed */ protected $_stream = null; /** * Inner stream. * * @var \Hoa\Stream */ protected $_innerStream = null; /** * Set current stream. * * @param object $stream Current stream. * @return object */ protected function setStream($stream) { $old = $this->_stream; $this->_stream = $stream; return $old; } /** * Get current stream. * * @return object */ public function getStream() { return $this->_stream; } /** * Set inner stream. * * @param \Hoa\Stream $innerStream Inner stream. * @return \Hoa\Stream */ protected function setInnerStream(\Hoa\Stream\Stream $innerStream) { $old = $this->_innerStream; $this->_innerStream = $innerStream; return $old; } /** * Get inner stream. * * @return \Hoa\Stream */ public function getInnerStream() { return $this->_innerStream; } } This file was automatically generated by Composer Patches (https://github.com/cweagans/composer-patches) Patches applied to this directory: 0 Source: patches/Stream.patch <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Exception; use Hoa\Consistency; use Hoa\Event; /** * Class \Hoa\Exception\Exception. * * Each exception must extend \Hoa\Exception\Exception. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Exception extends \Hoa\Exception\Idle implements Event\Source { /** * Create an exception. * An exception is built with a formatted message, a code (an ID), and an * array that contains the list of formatted string for the message. If * chaining, we can add a previous exception. * * @param string $message Formatted message. * @param int $code Code (the ID). * @param array $arguments Arguments to format message. * @param \Throwable $previous Previous exception in chaining. */ public function __construct($message, $code = 0, $arguments = [], $previous = null) { parent::__construct($message, $code, $arguments, $previous); if (\false === Event::eventExists('hoa://Event/Exception')) { Event::register('hoa://Event/Exception', __CLASS__); } $this->send(); return; } /** * Send the exception on hoa://Event/Exception. * * @return void */ public function send() { Event::notify('hoa://Event/Exception', $this, new Event\Bucket($this)); return; } } /** * Flex entity. */ Consistency::flexEntity('Hoa\\Exception\\Exception'); <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Exception; /** * Class \Hoa\Exception\Error. * * This exception is the equivalent representation of PHP errors. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Error extends \Hoa\Exception\Exception { /** * Constructor. * * @param string $message Message. * @param int $code Code (the ID). * @param string $file File. * @param int $line Line. * @param array $trace Trace. */ public function __construct($message, $code, $file, $line, array $trace = []) { $this->file = $file; $this->line = $line; $this->_trace = $trace; parent::__construct($message, $code); return; } /** * Enable error handler: Transform PHP error into `\Hoa\Exception\Error`. * * @param bool $enable Enable. * @return mixed */ public static function enableErrorHandler($enable = \true) { if (\false === $enable) { return \restore_error_handler(); } return \set_error_handler(function ($no, $str, $file = null, $line = null, $ctx = null) { if (0 === ($no & \error_reporting())) { return; } $trace = \debug_backtrace(); \array_shift($trace); \array_shift($trace); throw new \Hoa\Exception\Error($str, $no, $file, $line, $trace); }); } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Exception; /** * Class \Hoa\Exception\Idle. * * `\Hoa\Exception\Idle` is the mother exception class of libraries. The only * difference between `\Hoa\Exception\Idle` and its directly child * `\Hoa\Exception` is that the latter fires events after beeing constructed. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Idle extends \Exception { /** * Delay processing on arguments. * * @var array */ protected $_tmpArguments = null; /** * Arguments to format message. * * @var array */ protected $_arguments = null; /** * Backtrace. * * @var array */ protected $_trace = null; /** * Previous. * * @var \Exception */ protected $_previous = null; /** * Original message. * * @var string */ protected $_rawMessage = null; /** * Create an exception. * An exception is built with a formatted message, a code (an ID) and an * array that contains the list of formatted strings for the message. If * chaining, we can add a previous exception. * * @param string $message Formatted message. * @param int $code Code (the ID). * @param array $arguments Arguments to format message. * @param \Exception $previous Previous exception in chaining. */ public function __construct($message, $code = 0, $arguments = [], ?\Exception $previous = null) { $this->_tmpArguments = $arguments; parent::__construct($message, $code, $previous); $this->_rawMessage = $message; $this->message = @\vsprintf($message, $this->getArguments()); return; } /** * Get the backtrace. * Do not use \Exception::getTrace() any more. * * @return array */ public function getBacktrace() { if (null === $this->_trace) { $this->_trace = $this->getTrace(); } return $this->_trace; } /** * Get previous. * Do not use \Exception::getPrevious() any more. * * @return \Exception */ public function getPreviousThrow() { if (null === $this->_previous) { $this->_previous = $this->getPrevious(); } return $this->_previous; } /** * Get arguments for the message. * * @return array */ public function getArguments() { if (null === $this->_arguments) { $arguments = $this->_tmpArguments; if (!\is_array($arguments)) { $arguments = [$arguments]; } foreach ($arguments as &$value) { if (null === $value) { $value = '(null)'; } } $this->_arguments = $arguments; unset($this->_tmpArguments); } return $this->_arguments; } /** * Get the raw message. * * @return string */ public function getRawMessage() { return $this->_rawMessage; } /** * Get the message already formatted. * * @return string */ public function getFormattedMessage() { return $this->getMessage(); } /** * Get the source of the exception (class, method, function, main etc.). * * @return string */ public function getFrom() { $trace = $this->getBacktrace(); $from = '{main}'; if (!empty($trace)) { $t = $trace[0]; $from = ''; if (isset($t['class'])) { $from .= $t['class'] . '::'; } if (isset($t['function'])) { $from .= $t['function'] . '()'; } } return $from; } /** * Raise an exception as a string. * * @param bool $previous Whether raise previous exception if exists. * @return string */ public function raise($previous = \false) { $message = $this->getFormattedMessage(); $trace = $this->getBacktrace(); $file = '/dev/null'; $line = -1; $pre = $this->getFrom(); if (!empty($trace)) { $file = isset($trace['file']) ? $trace['file'] : null; $line = isset($trace['line']) ? $trace['line'] : null; } $pre .= ': '; try { $out = $pre . '(' . $this->getCode() . ') ' . $message . "\n" . 'in ' . $this->getFile() . ' at line ' . $this->getLine() . '.'; } catch (\Exception $e) { $out = $pre . '(' . $this->getCode() . ') ' . $message . "\n" . 'in ' . $file . ' around line ' . $line . '.'; } if (\true === $previous && null !== ($previous = $this->getPreviousThrow())) { $out .= "\n\n" . ' ⬇' . "\n\n" . 'Nested exception (' . \get_class($previous) . '):' . "\n" . ($previous instanceof self ? $previous->raise(\true) : $previous->getMessage()); } return $out; } /** * Catch uncaught exception (only \Hoa\Exception\Idle and children). * * @param \Throwable $exception The exception. * @return void * @throws \Throwable */ public static function uncaught($exception) { if (!$exception instanceof self) { throw $exception; } while (0 < \ob_get_level()) { \ob_end_flush(); } echo 'Uncaught exception (' . \get_class($exception) . '):' . "\n" . $exception->raise(\true); return; } /** * String representation of object. * * @return string */ public function __toString() { return $this->raise(); } /** * Enable uncaught exception handler. * This is restricted to Hoa's exceptions only. * * @param bool $enable Enable. * @return mixed */ public static function enableUncaughtHandler($enable = \true) { if (\false === $enable) { return \restore_exception_handler(); } return \set_exception_handler(function ($exception) { return self::uncaught($exception); }); } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Exception; /** * Class \Hoa\Exception\Group. * * This is an exception that contains a group of exceptions. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Group extends \Hoa\Exception\Exception implements \ArrayAccess, \IteratorAggregate, \Countable { /** * All exceptions (stored in a stack for transactions). * * @var \SplStack */ protected $_group = null; /** * Create an exception. * * @param string $message Formatted message. * @param int $code Code (the ID). * @param array $arguments Arguments to format message. * @param \Exception $previous Previous exception in chaining. */ public function __construct($message, $code = 0, $arguments = [], \Exception $previous = null) { parent::__construct($message, $code, $arguments, $previous); $this->_group = new \SplStack(); $this->beginTransaction(); return; } /** * Raise an exception as a string. * * @param bool $previous Whether raise previous exception if exists. * @return string */ public function raise($previous = \false) { $out = parent::raise($previous); if (0 >= \count($this)) { return $out; } $out .= "\n\n" . 'Contains the following exceptions:'; foreach ($this as $exception) { $out .= "\n\n" . ' • ' . \str_replace("\n", "\n" . ' ', $exception->raise($previous)); } return $out; } /** * Begin a transaction. * * @return \Hoa\Exception\Group */ public function beginTransaction() { $this->_group->push(new \ArrayObject()); return $this; } /** * Rollback a transaction. * * @return \Hoa\Exception\Group */ public function rollbackTransaction() { if (1 >= \count($this->_group)) { return $this; } $this->_group->pop(); return $this; } /** * Commit a transaction. * * @return \Hoa\Exception\Group */ public function commitTransaction() { if (\false === $this->hasUncommittedExceptions()) { $this->_group->pop(); return $this; } foreach ($this->_group->pop() as $index => $exception) { $this[$index] = $exception; } return $this; } /** * Check if there is uncommitted exceptions. * * @return bool */ public function hasUncommittedExceptions() { return 1 < \count($this->_group) && 0 < \count($this->_group->top()); } /** * Check if an index in the group exists. * * @param mixed $index Index. * @return bool */ public function offsetExists($index) { foreach ($this->_group as $group) { if (isset($group[$index])) { return \true; } } return \false; } /** * Get an exception from the group. * * @param mixed $index Index. * @return Exception */ public function offsetGet($index) { foreach ($this->_group as $group) { if (isset($group[$index])) { return $group[$index]; } } return null; } /** * Set an exception in the group. * * @param mixed $index Index. * @param Exception $exception Exception. * @return void */ public function offsetSet($index, $exception) { if (!$exception instanceof \Exception) { return null; } $group = $this->_group->top(); if (null === $index || \true === \is_int($index)) { $group[] = $exception; } else { $group[$index] = $exception; } return; } /** * Remove an exception in the group. * * @param mixed $index Index. * @return void */ public function offsetUnset($index) { foreach ($this->_group as $group) { if (isset($group[$index])) { unset($group[$index]); } } return; } /** * Get committed exceptions in the group. * * @return \ArrayObject */ public function getExceptions() { return $this->_group->bottom(); } /** * Get an iterator over all exceptions (committed or not). * * @return \ArrayIterator */ public function getIterator() { return $this->getExceptions()->getIterator(); } /** * Count the number of committed exceptions. * * @return int */ public function count() { return \count($this->getExceptions()); } /** * Count the stack size, i.e. the number of opened transactions. * * @return int */ public function getStackSize() { return \count($this->_group); } } This file was automatically generated by Composer Patches (https://github.com/cweagans/composer-patches) Patches applied to this directory: 0 Source: patches/Idle.patch <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Ustring; use Hoa\Exception as HoaException; /** * Class \Hoa\Ustring\Exception. * * Extending the \Hoa\Exception\Exception class. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Exception extends HoaException { } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Ustring; /** * Class \Hoa\Ustring\Search. * * Some algorithms about search in strings. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Search { /** * Search by approximated patterns, with k differences based upon the * principle diagonal monotony. * * @param string $y Haystack. * @param string $x Needle. * @param int $k Number of differences. * @return array */ public static function approximated($y, $x, $k) { $x = (string) $x; $y = (string) $y; $m = \strlen($x); $n = \strlen($y); $offset = []; $L = [-1 => \array_fill(-1, $n - $m + $k + 3, -2)]; for ($q = 0, $max = $k - 1; $q <= $max; ++$q) { $L[$q][-$q - 1] = $L[$q][-$q - 2] = $q - 1; } for ($q = 0; $q <= $k; ++$q) { for ($d = -$q, $max = $n - $m + $k - $q; $d <= $max; ++$d) { $l = \min(\max($L[$q - 1][$d - 1], $L[$q - 1][$d] + 1, $L[$q - 1][$d + 1] + 1), $m - 1); $a = \substr($x, $l + 1, $m - $l); $b = \substr($y, $l + 1 + $d, $n - $l - $d); $L[$q][$d] = $l + static::lcp($a, $b); if ($L[$q][$d] == $m - 1 || $d + $L[$q][$d] == $n - 1) { $j = $m + $d; $i = \max(0, $j - $m); $offset[$q][] = ['i' => $i, 'j' => $j, 'l' => $j - $i]; } } } return empty($offset) ? $offset : $offset[$k]; } /** * Length of the longest common prefixes. * * @param string $x Word. * @param string $y Word. * @return int */ public static function lcp($x, $y) { $max = \min(\strlen($x), \strlen($y)); $i = 0; while ($i < $max && $x[$i] == $y[$i]) { ++$i; } return $i; } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Ustring; use Hoa\Consistency; /** * Class \Hoa\Ustring. * * This class represents a UTF-8 string. * Please, see: * • http://www.ietf.org/rfc/rfc3454.txt; * • http://unicode.org/reports/tr9/; * • http://www.unicode.org/Public/6.0.0/ucd/UnicodeData.txt. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Ustring implements \ArrayAccess, \Countable, \IteratorAggregate { /** * Left-To-Right. * * @const int */ const LTR = 0; /** * Right-To-Left. * * @const int */ const RTL = 1; /** * ZERO WIDTH NON-BREAKING SPACE (ZWNPBSP, aka byte-order mark, BOM). * * @const int */ const BOM = 0xfeff; /** * LEFT-TO-RIGHT MARK. * * @const int */ const LRM = 0x200e; /** * RIGHT-TO-LEFT MARK. * * @const int */ const RLM = 0x200f; /** * LEFT-TO-RIGHT EMBEDDING. * * @const int */ const LRE = 0x202a; /** * RIGHT-TO-LEFT EMBEDDING. * * @const int */ const RLE = 0x202b; /** * POP DIRECTIONAL FORMATTING. * * @const int */ const PDF = 0x202c; /** * LEFT-TO-RIGHT OVERRIDE. * * @const int */ const LRO = 0x202d; /** * RIGHT-TO-LEFT OVERRIDE. * * @const int */ const RLO = 0x202e; /** * Represent the beginning of the string. * * @const int */ const BEGINNING = 1; /** * Represent the end of the string. * * @const int */ const END = 2; /** * Split: non-empty pieces is returned. * * @const int */ const WITHOUT_EMPTY = \PREG_SPLIT_NO_EMPTY; /** * Split: parenthesized expression in the delimiter pattern will be captured * and returned. * * @const int */ const WITH_DELIMITERS = \PREG_SPLIT_DELIM_CAPTURE; /** * Split: offsets of captures will be returned. * * @const int */ const WITH_OFFSET = 260; // PREG_OFFSET_CAPTURE // | PREG_SPLIT_OFFSET_CAPTURE /** * Group results by patterns. * * @const int */ const GROUP_BY_PATTERN = \PREG_PATTERN_ORDER; /** * Group results by tuple (set of patterns). * * @const int */ const GROUP_BY_TUPLE = \PREG_SET_ORDER; /** * Current string. * * @var string */ protected $_string = null; /** * Direction. Please see self::LTR and self::RTL constants. * * @var int */ protected $_direction = null; /** * Collator. * * @var \Collator */ protected static $_collator = null; /** * Construct a UTF-8 string. * * @param string $string String. */ public function __construct($string = null) { if (null !== $string) { $this->append($string); } return; } /** * Check if ext/mbstring is available. * * @return bool */ public static function checkMbString() { return \function_exists('mb_substr'); } /** * Check if ext/iconv is available. * * @return bool */ public static function checkIconv() { return \function_exists('iconv'); } /** * Append a substring to the current string, i.e. add to the end. * * @param string $substring Substring to append. * @return \Hoa\Ustring */ public function append($substring) { $this->_string .= $substring; return $this; } /** * Prepend a substring to the current string, i.e. add to the start. * * @param string $substring Substring to append. * @return \Hoa\Ustring */ public function prepend($substring) { $this->_string = $substring . $this->_string; return $this; } /** * Pad the current string to a certain length with another piece, aka piece. * * @param int $length Length. * @param string $piece Piece. * @param int $side Whether we append at the end or the beginning * of the current string. * @return \Hoa\Ustring */ public function pad($length, $piece, $side = self::END) { $difference = $length - $this->count(); if (0 >= $difference) { return $this; } $handle = null; for ($i = $difference / \mb_strlen($piece) - 1; $i >= 0; --$i) { $handle .= $piece; } $handle .= \mb_substr($piece, 0, $difference - \mb_strlen($handle)); return static::END === $side ? $this->append($handle) : $this->prepend($handle); } /** * Make a comparison with a string. * Return < 0 if current string is less than $string, > 0 if greater and 0 * if equal. * * @param mixed $string String. * @return int */ public function compare($string) { if (null === ($collator = static::getCollator())) { return \strcmp($this->_string, (string) $string); } return $collator->compare($this->_string, $string); } /** * Get collator. * * @return \Collator */ public static function getCollator() { if (\false === \class_exists('Collator')) { return null; } if (null === static::$_collator) { static::$_collator = new \Collator(\setlocale(\LC_COLLATE, null)); } return static::$_collator; } /** * Ensure that the pattern is safe for Unicode: add the “u” option. * * @param string $pattern Pattern. * @return string */ public static function safePattern($pattern) { $delimiter = \mb_substr($pattern, 0, 1); $options = \mb_substr(\mb_strrchr($pattern, $delimiter, \false), \mb_strlen($delimiter)); if (\false === \strpos($options, 'u')) { $pattern .= 'u'; } return $pattern; } /** * Perform a regular expression (PCRE) match. * * @param string $pattern Pattern. * @param array $matches Matches. * @param int $flags Please, see constants self::WITH_OFFSET, * self::GROUP_BY_PATTERN and * self::GROUP_BY_TUPLE. * @param int $offset Alternate place from which to start the * search. * @param bool $global Whether the match is global or not. * @return int */ public function match($pattern, &$matches = null, $flags = 0, $offset = 0, $global = \false) { $pattern = static::safePattern($pattern); if (0 === $flags) { if (\true === $global) { $flags = static::GROUP_BY_PATTERN; } } else { $flags &= ~\PREG_SPLIT_OFFSET_CAPTURE; } $offset = \strlen(\mb_substr($this->_string, 0, $offset)); if (\true === $global) { return \preg_match_all($pattern, $this->_string, $matches, $flags, $offset); } return \preg_match($pattern, $this->_string, $matches, $flags, $offset); } /** * Perform a regular expression (PCRE) search and replace. * * @param mixed $pattern Pattern(s). * @param mixed $replacement Replacement(s) (please, see * preg_replace() documentation). * @param int $limit Maximum of replacements. -1 for unbound. * @return \Hoa\Ustring */ public function replace($pattern, $replacement, $limit = -1) { $pattern = static::safePattern($pattern); if (\false === \is_callable($replacement)) { $this->_string = \preg_replace($pattern, $replacement, $this->_string, $limit); } else { $this->_string = \preg_replace_callback($pattern, $replacement, $this->_string, $limit); } return $this; } /** * Split the current string according to a given pattern (PCRE). * * @param string $pattern Pattern (as a regular expression). * @param int $limit Maximum of split. -1 for unbound. * @param int $flags Please, see constants self::WITHOUT_EMPTY, * self::WITH_DELIMITERS, self::WITH_OFFSET. * @return array */ public function split($pattern, $limit = -1, $flags = self::WITHOUT_EMPTY) { return \preg_split(static::safePattern($pattern), $this->_string, $limit, $flags); } /** * Iterator over chars. * * @return \ArrayIterator */ public function getIterator() { return new \ArrayIterator(\preg_split('#(?<!^)(?!$)#u', $this->_string)); } /** * Perform a lowercase folding on the current string. * * @return \Hoa\Ustring */ public function toLowerCase() { $this->_string = \mb_strtolower($this->_string); return $this; } /** * Perform an uppercase folding on the current string. * * @return \Hoa\Ustring */ public function toUpperCase() { $this->_string = \mb_strtoupper($this->_string); return $this; } /** * Transform a UTF-8 string into an ASCII one. * First, try with a transliterator. If not available, will fallback to a * normalizer. If not available, will try something homemade. * * @param bool $try Try something if \Normalizer is not present. * @return \Hoa\Ustring * @throws \Hoa\Ustring\Exception */ public function toAscii($try = \false) { if (0 === \preg_match('#[\\x80-\\xff]#', $this->_string)) { return $this; } $string = $this->_string; $transId = 'Any-Latin; ' . '[\\p{S}] Name; ' . 'Latin-ASCII'; if (null !== ($transliterator = static::getTransliterator($transId))) { $this->_string = \preg_replace_callback('#\\\\N\\{([A-Z ]+)\\}#u', function (array $matches) { return '(' . \strtolower($matches[1]) . ')'; }, $transliterator->transliterate($string)); return $this; } if (\false === \class_exists('Normalizer')) { if (\false === $try) { throw new \Hoa\Ustring\Exception('%s needs the class Normalizer to work properly, ' . 'or you can force a try by using %1$s(true).', 0, __METHOD__); } $string = static::transcode($string, 'UTF-8', 'ASCII//IGNORE//TRANSLIT'); $this->_string = \preg_replace('#(?:[\'"`^](\\w))#u', '\\1', $string); return $this; } $string = \Normalizer::normalize($string, \Normalizer::NFKD); $string = \preg_replace('#\\p{Mn}+#u', '', $string); $this->_string = static::transcode($string, 'UTF-8', 'ASCII//IGNORE//TRANSLIT'); return $this; } /** * Transliterate the string into another. * See self::getTransliterator for more information. * * @param string $identifier Identifier. * @param int $start Start. * @param int $end End. * @return \Hoa\Ustring * @throws \Hoa\Ustring\Exception */ public function transliterate($identifier, $start = 0, $end = null) { if (null === ($transliterator = static::getTransliterator($identifier))) { throw new \Hoa\Ustring\Exception('%s needs the class Transliterator to work properly.', 1, __METHOD__); } $this->_string = $transliterator->transliterate($this->_string, $start, $end); return $this; } /** * Get transliterator. * See http://userguide.icu-project.org/transforms/general for $identifier. * * @param string $identifier Identifier. * @return \Transliterator */ public static function getTransliterator($identifier) { if (\false === \class_exists('Transliterator')) { return null; } return \Transliterator::create($identifier); } /** * Strip characters (default \s) of the current string. * * @param string $regex Characters to remove. * @param int $side Whether we trim the beginning, the end or both * sides, of the current string. * @return \Hoa\Ustring */ public function trim($regex = '\\s', $side = 3) { $regex = '(?:' . $regex . ')+'; $handle = null; if (0 !== ($side & static::BEGINNING)) { $handle .= '(^' . $regex . ')'; } if (0 !== ($side & static::END)) { if (null !== $handle) { $handle .= '|'; } $handle .= '(' . $regex . '$)'; } $this->_string = \preg_replace('#' . $handle . '#u', '', $this->_string); $this->_direction = null; return $this; } /** * Compute offset (negative, unbound etc.). * * @param int $offset Offset. * @return int */ protected function computeOffset($offset) { $length = \mb_strlen($this->_string); if (0 > $offset) { $offset = -$offset % $length; if (0 !== $offset) { $offset = $length - $offset; } } elseif ($offset >= $length) { $offset %= $length; } return $offset; } /** * Get a specific chars of the current string. * * @param int $offset Offset (can be negative and unbound). * @return string */ public function offsetGet($offset) { return \mb_substr($this->_string, $this->computeOffset($offset), 1); } /** * Set a specific character of the current string. * * @param int $offset Offset (can be negative and unbound). * @param string $value Value. * @return \Hoa\Ustring */ public function offsetSet($offset, $value) { $head = null; $offset = $this->computeOffset($offset); if (0 < $offset) { $head = \mb_substr($this->_string, 0, $offset); } $tail = \mb_substr($this->_string, $offset + 1); $this->_string = $head . $value . $tail; $this->_direction = null; return $this; } /** * Delete a specific character of the current string. * * @param int $offset Offset (can be negative and unbound). * @return string */ public function offsetUnset($offset) { return $this->offsetSet($offset, null); } /** * Check if a specific offset exists. * * @return bool */ public function offsetExists($offset) { return \true; } /** * Reduce the strings. * * @param int $start Position of first character. * @param int $length Maximum number of characters. * @return \Hoa\Ustring */ public function reduce($start, $length = null) { $this->_string = \mb_substr($this->_string, $start, $length); return $this; } /** * Count number of characters of the current string. * * @return int */ public function count() { return \mb_strlen($this->_string); } /** * Get byte (not character) at a specific offset. * * @param int $offset Offset (can be negative and unbound). * @return string */ public function getByteAt($offset) { $length = \strlen($this->_string); if (0 > $offset) { $offset = -$offset % $length; if (0 !== $offset) { $offset = $length - $offset; } } elseif ($offset >= $length) { $offset %= $length; } return $this->_string[$offset]; } /** * Count number of bytes (not characters) of the current string. * * @return int */ public function getBytesLength() { return \strlen($this->_string); } /** * Get the width of the current string. * Useful when printing the string in monotype (some character need more * than one column to be printed). * * @return int */ public function getWidth() { return \mb_strwidth($this->_string); } /** * Get direction of the current string. * Please, see the self::LTR and self::RTL constants. * It does not yet support embedding directions. * * @return int */ public function getDirection() { if (null === $this->_direction) { if (null === $this->_string) { $this->_direction = static::LTR; } else { $this->_direction = static::getCharDirection(\mb_substr($this->_string, 0, 1)); } } return $this->_direction; } /** * Get character of a specific character. * Please, see the self::LTR and self::RTL constants. * * @param string $char Character. * @return int */ public static function getCharDirection($char) { $c = static::toCode($char); if (!(0x5be <= $c && 0x10b7f >= $c)) { return static::LTR; } if (0x85e >= $c) { if (0x5be === $c || 0x5c0 === $c || 0x5c3 === $c || 0x5c6 === $c || 0x5d0 <= $c && 0x5ea >= $c || 0x5f0 <= $c && 0x5f4 >= $c || 0x608 === $c || 0x60b === $c || 0x60d === $c || 0x61b === $c || 0x61e <= $c && 0x64a >= $c || 0x66d <= $c && 0x66f >= $c || 0x671 <= $c && 0x6d5 >= $c || 0x6e5 <= $c && 0x6e6 >= $c || 0x6ee <= $c && 0x6ef >= $c || 0x6fa <= $c && 0x70d >= $c || 0x710 === $c || 0x712 <= $c && 0x72f >= $c || 0x74d <= $c && 0x7a5 >= $c || 0x7b1 === $c || 0x7c0 <= $c && 0x7ea >= $c || 0x7f4 <= $c && 0x7f5 >= $c || 0x7fa === $c || 0x800 <= $c && 0x815 >= $c || 0x81a === $c || 0x824 === $c || 0x828 === $c || 0x830 <= $c && 0x83e >= $c || 0x840 <= $c && 0x858 >= $c || 0x85e === $c) { return static::RTL; } } elseif (0x200f === $c) { return static::RTL; } elseif (0xfb1d <= $c) { if (0xfb1d === $c || 0xfb1f <= $c && 0xfb28 >= $c || 0xfb2a <= $c && 0xfb36 >= $c || 0xfb38 <= $c && 0xfb3c >= $c || 0xfb3e === $c || 0xfb40 <= $c && 0xfb41 >= $c || 0xfb43 <= $c && 0xfb44 >= $c || 0xfb46 <= $c && 0xfbc1 >= $c || 0xfbd3 <= $c && 0xfd3d >= $c || 0xfd50 <= $c && 0xfd8f >= $c || 0xfd92 <= $c && 0xfdc7 >= $c || 0xfdf0 <= $c && 0xfdfc >= $c || 0xfe70 <= $c && 0xfe74 >= $c || 0xfe76 <= $c && 0xfefc >= $c || 0x10800 <= $c && 0x10805 >= $c || 0x10808 === $c || 0x1080a <= $c && 0x10835 >= $c || 0x10837 <= $c && 0x10838 >= $c || 0x1083c === $c || 0x1083f <= $c && 0x10855 >= $c || 0x10857 <= $c && 0x1085f >= $c || 0x10900 <= $c && 0x1091b >= $c || 0x10920 <= $c && 0x10939 >= $c || 0x1093f === $c || 0x10a00 === $c || 0x10a10 <= $c && 0x10a13 >= $c || 0x10a15 <= $c && 0x10a17 >= $c || 0x10a19 <= $c && 0x10a33 >= $c || 0x10a40 <= $c && 0x10a47 >= $c || 0x10a50 <= $c && 0x10a58 >= $c || 0x10a60 <= $c && 0x10a7f >= $c || 0x10b00 <= $c && 0x10b35 >= $c || 0x10b40 <= $c && 0x10b55 >= $c || 0x10b58 <= $c && 0x10b72 >= $c || 0x10b78 <= $c && 0x10b7f >= $c) { return static::RTL; } } return static::LTR; } /** * Get the number of column positions of a wide-character. * * This is a PHP implementation of wcwidth() and wcswidth() (defined in IEEE * Std 1002.1-2001) for Unicode, by Markus Kuhn. Please, see * http://www.cl.cam.ac.uk/~mgk25/ucs/wcwidth.c. * * The wcwidth(wc) function shall either return 0 (if wc is a null * wide-character code), or return the number of column positions to be * occupied by the wide-character code wc, or return -1 (if wc does not * correspond to a printable wide-character code). * * @param string $char Character. * @return int */ public static function getCharWidth($char) { $char = (string) $char; $c = static::toCode($char); // Test for 8-bit control characters. if (0x0 === $c) { return 0; } if (0x20 > $c || 0x7f <= $c && $c < 0xa0) { return -1; } // Non-spacing characters. if (0xad !== $c && 0 !== \preg_match('#^[\\p{Mn}\\p{Me}\\p{Cf}\\x{1160}-\\x{11ff}\\x{200b}]#u', $char)) { return 0; } // If we arrive here, $c is not a combining C0/C1 control character. return 1 + (0x1100 <= $c && (0x115f >= $c || 0x2329 === $c || 0x232a === $c || 0x2e80 <= $c && 0xa4cf >= $c && 0x303f !== $c || 0xac00 <= $c && 0xd7a3 >= $c || 0xf900 <= $c && 0xfaff >= $c || 0xfe10 <= $c && 0xfe19 >= $c || 0xfe30 <= $c && 0xfe6f >= $c || 0xff00 <= $c && 0xff60 >= $c || 0xffe0 <= $c && 0xffe6 >= $c || 0x20000 <= $c && 0x2fffd >= $c || 0x30000 <= $c && 0x3fffd >= $c)); } /** * Check whether the character is printable or not. * * @param string $char Character. * @return bool */ public static function isCharPrintable($char) { return 1 <= static::getCharWidth($char); } /** * Get a UTF-8 character from its decimal code representation. * * @param int $code Code. * @return string */ public static function fromCode($code) { return \mb_convert_encoding('&#x' . \dechex($code) . ';', 'UTF-8', 'HTML-ENTITIES'); } /** * Get a decimal code representation of a specific character. * * @param string $char Character. * @return int */ public static function toCode($char) { $char = (string) $char; $code = \ord($char[0]); $bytes = 1; if (!($code & 0x80)) { // 0xxxxxxx return $code; } if (($code & 0xe0) === 0xc0) { // 110xxxxx $bytes = 2; $code = $code & ~0xc0; } elseif (($code & 0xf0) == 0xe0) { // 1110xxxx $bytes = 3; $code = $code & ~0xe0; } elseif (($code & 0xf8) === 0xf0) { // 11110xxx $bytes = 4; $code = $code & ~0xf0; } for ($i = 2; $i <= $bytes; $i++) { // 10xxxxxx $code = ($code << 6) + (\ord($char[$i - 1]) & ~0x80); } return $code; } /** * Get a binary representation of a specific character. * * @param string $char Character. * @return string */ public static function toBinaryCode($char) { $char = (string) $char; $out = null; for ($i = 0, $max = \strlen($char); $i < $max; ++$i) { $out .= \vsprintf('%08b', \ord($char[$i])); } return $out; } /** * Transcode. * * @param string $string String. * @param string $from Original encoding. * @param string $to Final encoding. * @return string * @throws \Hoa\Ustring\Exception */ public static function transcode($string, $from, $to = 'UTF-8') { if (\false === static::checkIconv()) { throw new \Hoa\Ustring\Exception('%s needs the iconv extension.', 2, __CLASS__); } return \iconv($from, $to, $string); } /** * Check if a string is encoded in UTF-8. * * @param string $string String. * @return bool */ public static function isUtf8($string) { return (bool) \preg_match('##u', $string); } /** * Copy current object string * * @return \Hoa\Ustring */ public function copy() { return clone $this; } /** * Transform the object as a string. * * @return string */ public function __toString() { return $this->_string; } } /** * Flex entity. */ Consistency::flexEntity('Hoa\\Ustring\\Ustring'); if (\false === \Hoa\Ustring\Ustring::checkMbString()) { throw new \Hoa\Ustring\Exception('%s needs the mbstring extension.', 0, __NAMESPACE__ . '\\Ustring'); } <?xml version="1.0" encoding="utf-8"?> <overlay xmlns="http://hoa-project.net/xyl/xylophone"> <yield id="chapter"> <p>Strings can sometimes be <strong>complex</strong>, especially when they use the <code>Unicode</code> encoding format. The <code>Hoa\Ustring</code> library provides several operations on UTF-8 strings.</p> <h2 id="Table_of_contents">Table of contents</h2> <tableofcontents id="main-toc" /> <h2 id="Introduction" for="main-toc">Introduction</h2> <p>When we manipulate strings, the <a href="http://unicode.org/">Unicode</a> format establishes itself because of its <strong>compatibility</strong> with historical formats (like ASCII) and its capacity to understand a <strong>large</strong> range of characters and symbols for all cultures and all regions in the world. PHP provides several tools to manipulate such strings, like the following extensions: <a href="http://php.net/mbstring"><code>mbstring</code></a>, <a href="http://php.net/iconv"><code>iconv</code></a> or also the excellent <a href="http://php.net/intl"><code>intl</code></a> which is based on <a href="http://icu-project.org/">ICU</a>, the reference implementation of Unicode. Unfortunately, sometimes we have to mix these extensions to achieve our aims and at the cost of a certain <strong>complexity</strong> along with a regrettable <strong>verbosity</strong>.</p> <p>The <code>Hoa\Ustring</code> library answers to these issues by providing a <strong>simple</strong> way to manipulate strings with <strong>performance</strong> and <strong>efficiency</strong> in minds. It also provides some evoluated algorithms to perform <strong>search</strong> operations on strings.</p> <h2 id="Unicode_strings" for="main-toc">Unicode strings</h2> <p>The <code>Hoa\Ustring\Ustring</code> class represents a <strong>UTF-8</strong> Unicode strings and allows to manipulate it easily. This class implements the <a href="http://php.net/arrayaccess"><code>ArrayAccess</code></a>, <a href="http://php.net/countable"><code>Countable</code></a> and <a href="http://php.net/iteratoraggregate"><code>IteratorAggregate</code></a> interfaces. We are going to use three examples in three different languages: French, Arab and Japanese. Thus:</p> <pre><code class="language-php">$french = new Hoa\Ustring\Ustring('Je t\'aime'); $arabic = new Hoa\Ustring\Ustring('أحبك'); $japanese = new Hoa\Ustring\Ustring('私はあなたを愛して');</code></pre> <p>Now, let's see what we can do on these three strings.</p> <h3 id="String_manipulation" for="main-toc">String manipulation</h3> <p>Let's start with <strong>elementary</strong> operations. If we would like to <strong>count</strong> the number of characters (not bytes), we will use the <a href="http://php.net/count"><code>count</code> function</a>. Thus:</p> <pre><code class="language-php">var_dump( count($french), count($arabic), count($japanese) ); /** * Will output: * int(9) * int(4) * int(9) */</code></pre> <p>When we speak about text position, it is not suitable to speak about the right or the left, but rather about a <strong>beginning</strong> or an <strong>end</strong>, and based on the <strong>direction</strong> of writing. We can know this direction thanks to the <code>Hoa\Ustring\Ustring::getDirection</code> method. It returns the value of one of the following constants:</p> <ul> <li><code>Hoa\Ustring\Ustring::LTR</code>, for left-to-right, if the text is written from the left to the right,</li> <li><code>Hoa\Ustring\Ustring::RTL</code>, for right-to-left, if the text is written from the right to the left.</li> </ul> <p>Let's observe the result with our examples:</p> <pre><code class="language-php">var_dump( $french->getDirection() === Hoa\Ustring\Ustring::LTR, // is left-to-right? $arabic->getDirection() === Hoa\Ustring\Ustring::RTL, // is right-to-left? $japanese->getDirection() === Hoa\Ustring\Ustring::LTR // is left-to-right? ); /** * Will output: * bool(true) * bool(true) * bool(true) */</code></pre> <p>The result of this method is computed thanks to the <code>Hoa\Ustring\Ustring::getCharDirection</code> static method which computes the direction of only one character.</p> <p>If we would like to <strong>concatenate</strong> another string to the end or to the beginning, we will respectively use the <code>Hoa\Ustring\Ustring::append</code> and <code>Hoa\Ustring\Ustring::prepend</code> methods. These methods, like most of the ones which modifies the string, return the object itself, in order to chain the calls. For instance:</p> <pre><code class="language-php">echo $french->append('… et toi, m\'aimes-tu ?')->prepend('Mam\'zelle ! '); /** * Will output: * Mam'zelle ! Je t'aime… et toi, m'aimes-tu ? */</code></pre> <p>We also have the <code>Hoa\Ustring\Ustring::toLowerCase</code> and <code>Hoa\Ustring\Ustring::toUpperCase</code> methods to, respectively, set the case of the string to lower or upper. For instance:</p> <pre><code class="language-php">echo $french->toUpperCase(); /** * Will output: * MAM'ZELLE ! JE T'AIME… ET TOI, M'AIMES-TU ? */</code></pre> <p>We can also add characters to the beginning or to the end of the string to reach a <strong>minimum</strong> length. This operation is frequently called the <em>padding</em> (for historical reasons dating back to typewriters). That's why we have the <code>Hoa\Ustring\Ustring::pad</code> method which takes three arguments: the minimum length, characters to add and a constant indicating whether we have to add at the end or at the beginning of the string (respectively <code>Hoa\Ustring\Ustring::END</code>, by default, and <code>Hoa\Ustring\Ustring::BEGINNING</code>).</p> <pre><code class="language-php">echo $arabic->pad(20, ' '); /** * Will output: * أحبك */</code></pre> <p>A similar operation allows to remove, by default, <strong>spaces</strong> at the beginning and at the end of the string thanks to the <code>Hoa\Ustring\Ustring::trim</code> method. For example, to retreive our original Arabic string:</p> <pre><code class="language-php">echo $arabic->trim(); /** * Will output: * أحبك */</code></pre> <p>If we would like to remove other characters, we can use its first argument which must be a regular expression. Finally, its second argument allows to specify from what side we would like to remove character: at the beginning, at the end or both, still by using the <code>Hoa\Ustring\Ustring::BEGINNING</code> and <code>Hoa\Ustring\Ustring::END</code> constants.</p> <p>If we would like to remove other characters, we can use its first argument which must be a regular expression. Finally, its second argument allows to specify the side where to remove characters: at the beginning, at the end or both, still by using the <code>Hoa\Ustring\Ustring::BEGINNING</code> and <code>Hoa\Ustring\Ustring::END</code> constants. We can combine these constants to express “both sides”, which is the default value: <code class="language-php">Hoa\Ustring\Ustring::BEGINNING | Hoa\Ustring\Ustring::END</code>. For example, to remove all the numbers and the spaces only at the end, we will write:</p> <pre><code class="language-php">$arabic->trim('\s|\d', Hoa\Ustring\Ustring::END);</code></pre> <p>We can also <strong>reduce</strong> the string to a <strong>sub-string</strong> by specifying the position of the first character followed by the length of the sub-string to the <code>Hoa\Ustring\Ustring::reduce</code> method:</p> <pre><code class="language-php">echo $french->reduce(3, 6)->reduce(2, 4); /** * Will output: * aime */</code></pre> <p>If we would like to get a specific character, we can rely on the <code>ArrayAccess</code> interface. For instance, to get the first character of each of our examples (from their original definitions):</p> <pre><code class="language-php">var_dump( $french[0], $arabic[0], $japanese[0] ); /** * Will output: * string(1) "J" * string(2) "أ" * string(3) "私" */</code></pre> <p>If we would like the last character, we will use the -1 index. The index is not bounded to the length of the string. If the index exceeds this length, then a <em>modulo</em> will be applied.</p> <p>We can also modify or remove a specific character with this method. For example:</p> <pre><code class="language-php">$french->append(' ?'); $french[-1] = '!'; echo $french; /** * Will output: * Je t'aime ! */</code></pre> <p>Another very useful method is the <strong>ASCII</strong> transformation. Be careful, this is not always possible, according to your settings. For example:</p> <pre><code class="language-php">$title = new Hoa\Ustring\Ustring('Un été brûlant sur la côte'); echo $title->toAscii(); /** * Will output: * Un ete brulant sur la cote */</code></pre> <p>We can also transform from Arabic or Japanese to ASCII. Symbols, like Mathemeticals symbols or emojis, are also transformed:</p> <pre><code class="language-php">$emoji = new Hoa\Ustring\Ustring('I ❤ Unicode'); $maths = new Hoa\Ustring\Ustring('∀ i ∈ ℕ'); echo $arabic->toAscii(), "\n", $japanese->toAscii(), "\n", $emoji->toAscii(), "\n", $maths->toAscii(), "\n"; /** * Will output: * ahbk * sihaanatawo aishite * I (heavy black heart)️ Unicode * (for all) i (element of) N */</code></pre> <p>In order this method to work correctly, the <a href="http://php.net/intl"><code>intl</code></a> extension needs to be present, so that the <a href="http://php.net/transliterator"><code>Transliterator</code></a> class is present. If it does not exist, the <a href="http://php.net/normalizer"><code>Normalizer</code></a> class must exist. If this class does not exist neither, the <code>Hoa\Ustring\Ustring::toAscii</code> method can still try a transformation, but it is less efficient. To activate this last solution, <code>true</code> must be passed as a single argument. This <em lang="fr">tour de force</em> is not recommended in most cases.</p> <p>We also find the <code>getTransliterator</code> method which returns a <code>Transliterator</code> object, or <code>null</code> if this class does not exist. This method takes a transliteration identifier as argument. We suggest to <a href="http://userguide.icu-project.org/transforms/general">read the documentation about the transliterator of ICU</a> to understand this identifier. The <code>transliterate</code> method allows to transliterate the current string based on an identifier and a beginning index and an end one. This method works the same way than the <a href="http://php.net/transliterator.transliterate"><code>Transliterator::transliterate</code></a> method.</p> <p>More generally, to change the <strong>encoding</strong> format, we can use the <code>Hoa\Ustring\Ustring::transcode</code> static method, with a string as first argument, the original encoding format as second argument and the expected encoding format as third argument (UTF-8 by default). The get the list of encoding formats, we have to refer to the <a href="http://php.net/iconv"><code>iconv</code></a> extension or to use the following command line in a terminal:</p> <pre><code class="language-php">$ iconv --list</code></pre> <p>To know if a string is encoded in UTF-8, we can use the <code>Hoa\Ustring\Ustring::isUtf8</code> static method; for instance:</p> <pre><code class="language-php">var_dump( Hoa\Ustring\Ustring::isUtf8('a'), Hoa\Ustring\Ustring::isUtf8(Hoa\Ustring\Ustring::transcode('a', 'UTF-8', 'UTF-16')) ); /** * Will output: * bool(true) * bool(false) */</code></pre> <p>We can <strong>split</strong> the string into several sub-strings by using the <code>Hoa\Ustring\Ustring::split</code> method. As first argument, we have a regular expression (of kind <a href="http://pcre.org/">PCRE</a>), then an integer representing the maximum number of elements to return and finally a combination of constants. These constants are the same as the ones of <a href="http://php.net/preg_split"><code>preg_split</code></a>.</p> <p>By default, the second argument is set to -1, which means infinity, and the last argument is set to <code>PREG_SPLIT_NO_EMPTY</code>. Thus, if we would like to get all the words of a string, we will write:</p> <pre><code class="language-php">print_r($title->split('#\b|\s#')); /** * Will output: * Array * ( * [0] => Un * [1] => ete * [2] => brulant * [3] => sur * [4] => la * [5] => cote * ) */</code></pre> <p>If we would like to <strong>iterate</strong> over all the <strong>characters</strong>, it is recommended to use the <code>IteratorAggregate</code> method, being the <code>Hoa\Ustring\Ustring::getIterator</code> method. Let's see on the Arabic example:</p> <pre><code class="language-php">foreach ($arabic as $letter) { echo $letter, "\n"; } /** * Will output: * أ * ح * ب * ك */</code></pre> <p>We notice that the iteration is based on the text direction, it means that the first element of the iteration is the first letter of the string starting from the beginning.</p> <p>Of course, if we would like to get an array of characters, we can use the <a href="http://php.net/iterator_to_array"><code>iterator_to_array</code></a> PHP function:</p> <pre><code class="language-php">print_r(iterator_to_array($arabic)); /** * Will output: * Array * ( * [0] => أ * [1] => ح * [2] => ب * [3] => ك * ) */</code></pre> <h3 id="Comparison_and_search" for="main-toc">Comparison and search</h3> <p>Strings can also be <strong>compared</strong> thanks to the <code>Hoa\Ustring\Ustring::compare</code> method:</p> <pre><code class="language-php">$string = new Hoa\Ustring\Ustring('abc'); var_dump( $string->compare('wxyz') ); /** * Will output: * string(-1) */</code></pre> <p>This methods returns -1 if the initial string comes before (in the alphabetical order), 0 if it is identical and 1 if it comes after. If we would like to use all the power of the underlying mechanism, we can call the <code>Hoa\Ustring\Ustring::getCollator</code> static method (if the <a href="http://php.net/Collator"><code>Collator</code></a> class exists, else <code>Hoa\Ustring\Ustring::compare</code> will use a simple byte to bytes comparison without taking care of the other parameters). Thus, if we would like to sort an array of strings, we will write:</p> <pre><code class="language-php">$strings = array('c', 'Σ', 'd', 'x', 'α', 'a'); Hoa\Ustring\Ustring::getCollator()->sort($strings); print_r($strings); /** * Could output: * Array * ( * [0] => a * [1] => c * [2] => d * [3] => x * [4] => α * [5] => Σ * ) */</code></pre> <p>Comparison between two strings depends on the <strong>locale</strong>, it means of the localization of the system, like the language, the country, the region etc. We can use the <a href="@hack:chapter=Locale"><code>Hoa\Locale</code> library</a> to modify these data, but it's not a dependence of <code>Hoa\Ustring</code>.</p> <p>We can also know if a string <strong>matches</strong> a certain pattern, still expressed with a regular expression. To achieve that, we will use the <code>Hoa\Ustring\Ustring::match</code> method. This method relies on the <a href="http://php.net/preg_match"><code>preg_match</code></a> and <a href="http://php.net/preg_match_all"><code>preg_match_all</code></a> PHP functions, but by modifying the pattern's options to ensure the Unicode support. We have the following parameters: the pattern, a variable passed by reference to collect the matches, flags, an offset and finally a boolean indicating whether the search is global or not (respectively if we have to use <code>preg_match_all</code> or <code>preg_match</code>). By default, the search is not global.</p> <p>Thus, we will check that our French example contains <code>aime</code> with a direct object complement:</p> <pre><code class="language-php">$french->match('#(?:(?&lt;direct_object>\w)[\'\b])aime#', $matches); var_dump($matches['direct_object']); /** * Will output: * string(1) "t" */</code></pre> <p>This method returns <code>false</code> if an error is raised (for example if the pattern is not correct), 0 if no match has been found, the number of matches else.</p> <p>Similarly, we can <strong>search</strong> and <strong>replace</strong> sub-strings by other sub-strings based on a pattern, still expressed with a regular expression. To achieve that, we will use the <code>Hoa\Ustring\Ustring::replace</code> method. This method uses the <a href="http://php.net/preg_replace"><code>preg_replace</code></a> and <a href="http://php.net/preg_replace_callback"><code>preg_replace_callback</code></a> PHP functions, but still by modifying the pattern's options to ensure the Unicode support. As first argument, we find one or more patterns, as second argument, one or more replacements and as last argument the limit of replacements to apply. If the replacement is a callable, then the <code>preg_replace_callback</code> function will be used.</p> <p>Thus, we will modify our French example to be more polite:</p> <pre><code class="language-php">$french->replace('#(?:\w[\'\b])(?&lt;verb>aime)#', function ($matches) { return 'vous ' . $matches['verb']; }); echo $french; /** * Will output: * Je vous aime */</code></pre> <p>The <code>Hoa\Ustring\Ustring</code> class provides constants which are aliases of existing PHP constants and ensure a better readability of the code:</p> <ul> <li><code>Hoa\Ustring\Ustring::WITHOUT_EMPTY</code>, alias of <code>PREG_SPLIT_NO_EMPTY</code>,</li> <li><code>Hoa\Ustring\Ustring::WITH_DELIMITERS</code>, alias of <code>PREG_SPLIT_DELIM_CAPTURE</code>,</li> <li><code>Hoa\Ustring\Ustring::WITH_OFFSET</code>, alias of <code>PREG_OFFSET_CAPTURE</code> and <code>PREG_SPLIT_OFFSET_CAPTURE</code>,</li> <li><code>Hoa\Ustring\Ustring::GROUP_BY_PATTERN</code>, alias of <code>PREG_PATTERN_ORDER</code>,</li> <li><code>Hoa\Ustring\Ustring::GROUP_BY_TUPLE</code>, alias of <code>PREG_SET_ORDER</code>.</li> </ul> <p>Because they are strict aliases, we can write:</p> <pre><code class="language-php">$string = new Hoa\Ustring\Ustring('abc1 defg2 hikl3 xyz4'); $string->match( '#(\w+)(\d)#', $matches, Hoa\Ustring\Ustring::WITH_OFFSET | Hoa\Ustring\Ustring::GROUP_BY_TUPLE, 0, true );</code></pre> <h3 id="Characters" for="main-toc">Characters</h3> <p>The <code>Hoa\Ustring\Ustring</code> class offers static methods working on a single Unicode character. We have already mentionned the <code>getCharDirection</code> method which allows to know the <strong>direction</strong> of a character. We also have the <code>getCharWidth</code> which counts the <strong>number of columns</strong> necessary to print a single character. Thus:</p> <pre><code class="language-php">var_dump( Hoa\Ustring\Ustring::getCharWidth(Hoa\Ustring\Ustring::fromCode(0x7f)), Hoa\Ustring\Ustring::getCharWidth('a'), Hoa\Ustring\Ustring::getCharWidth('㽠') ); /** * Will output: * int(-1) * int(1) * int(2) */</code></pre> <p>This method returns -1 or 0 if the character is not <strong>printable</strong> (for instance, if this is a control character, like <code>0x7f</code> which corresponds to <code>DELETE</code>), 1 or more if this is a character that can be printed. In our example, <code>㽠</code> requires 2 columns to be printed.</p> <p>To get more semantics, we have the <code>Hoa\Ustring\Ustring::isCharPrintable</code> method which allows to know whether a character is printable or not.</p> <p>If we would like to count the number of columns necessary for a whole string, we have to use the <code>Hoa\Ustring\Ustring::getWidth</code> method. Thus:</p> <pre><code class="language-php">var_dump( $french->getWidth(), $arabic->getWidth(), $japanese->getWidth() ); /** * Will output: * int(9) * int(4) * int(18) */</code></pre> <p>Try this in your terminal with a <strong>monospaced</strong> font. You will observe that Japanese requires 18 columns to be printed. This measure is very useful if we would like to know the length of a string to position it efficiently.</p> <p>The <code>getCharWidth</code> method is different of <code>getWidth</code> because it includes control characters. This method is intended to be used, for example, with terminals (please, see the <a href="@hack:chapter=Console"><code>Hoa\Console</code> library</a>).</p> <p>Finally, if this time we are not interested by Unicode characters but rather by <strong>machine</strong> characters <code>char</code> (being 1 byte), we have an extra operation. The <code>Hoa\Ustring\Ustring::getBytesLength</code> method will count the <strong>length</strong> of the string in bytes:</p> <pre><code class="language-php">var_dump( $arabic->getBytesLength(), $japanese->getBytesLength() ); /** * Will output: * int(8) * int(27) */</code></pre> <p>If we compare these results with the ones of the <code>Hoa\Ustring\Ustring::count</code> method, we understand that the Arabic characters are encoded with 2 bytes whereas Japanese characteres are encoded with 3 bytes. We can also get a specific byte thanks to the <code>Hoa\Ustring\Ustring::getByteAt</code> method. Once again, the index is not bounded.</p> <h3 id="Code-point" for="main-toc">Code-point</h3> <p>Each character is represented by an integer, called a <strong>code-point</strong>. To get the code-point of a character, we can use the <code>Hoa\Ustring\Ustring::toCode</code> static method, and to get a character based on its code-point, we can use the <code>Hoa\Ustring\Ustring::fromCode</code> static method. We also have the <code>Hoa\Ustring\Ustring::toBinaryCode</code> method which returns the binary representation of a character. Let's take an example:</p> <pre><code class="language-php">var_dump( Hoa\Ustring\Ustring::toCode('Σ'), Hoa\Ustring\Ustring::toBinaryCode('Σ'), Hoa\Ustring\Ustring::fromCode(0x1a9) ); /** * Will output: * int(931) * string(32) "1100111010100011" * string(2) "Σ" */</code></pre> <h2 id="Search_algorithms" for="main-toc">Search algorithms</h2> <p>The <code>Hoa\Ustring</code> library provides sophisticated <strong>search</strong> algorithms on strings through the <code>Hoa\Ustring\Search</code> class.</p> <p>We will study the <code>Hoa\Ustring\Search::approximated</code> algorithm which searches a sub-string in a string up to <strong><em>k</em> differences</strong> (a difference is an addition, a deletion or a modification). Let's take the classical example of a DNA representation: We will search all the sub-strings approximating <code>GATAA</code> with 1 difference (maximum) in <code>CAGATAAGAGAA</code>. So, we will write:</p> <pre><code class="language-php">$x = 'GATAA'; $y = 'CAGATAAGAGAA'; $k = 1; $search = Hoa\Ustring\Search::approximated($y, $x, $k); $n = count($search); echo 'Try to match ', $x, ' in ', $y, ' with at most ', $k, ' difference(s):', "\n"; echo $n, ' match(es) found:', "\n"; foreach ($search as $position) { echo ' • ', substr($y, $position['i'], $position['l'), "\n"; } /** * Will output: * Try to match GATAA in CAGATAAGAGAA with at most 1 difference(s): * 4 match(es) found: * • AGATA * • GATAA * • ATAAG * • GAGAA */</code></pre> <p>This methods returns an array of arrays. Each sub-array represents a result and contains three indexes: <code>i</code> for the position of the first character (byte) of the result, <code>j</code> for the position of the last character and <code>l</code> for the length of the result (simply <code>j</code> - <code>i</code>). Thus, we can compute the results by using our initial string (here <code class="language-php">$y</code>) and its indexes.</p> <p>With our example, we have four results. The first is <code>AGATA</code>, being <code>GATA<em>A</em></code> with one moved character, and <code>AGATA</code> exists in <code>C<em>AGATA</em>AGAGAA</code>. The second result is <code>GATAA</code>, our sub-string, which well and truly exists in <code>CA<em>GATAA</em>GAGAA</code>. The third result is <code>ATAAG</code>, being <code><em>G</em>ATAA</code> with one moved character, and <code>ATAAG</code> exists in <code>CAG<em>ATAAG</em>AGAA</code>. Finally, the last result is <code>GAGAA</code>, being <code>GA<em>T</em>AA</code> with one modified character, and <code>GAGAA</code> exists in <code>CAGATAA<em>GAGAA</em></code>.</p> <p>Another example, more concrete this time. We will consider the <code>--testIt --foobar --testThat --testAt</code> string (which represents possible options of a command line), and we will search <code>--testot</code>, an option that should have been given by the user. This option does not exist as it is. We will then use our search algorithm with at most 1 difference. Let's see:</p> <pre><code class="language-php">$x = 'testot'; $y = '--testIt --foobar --testThat --testAt'; $k = 1; $search = Hoa\Ustring\Search::approximated($y, $x, $k); $n = count($search); // … /** * Will output: * Try to match testot in --testIt --foobar --testThat --testAt with at most 1 difference(s) * 2 match(es) found: * • testIt * • testAt */</code></pre> <p>The <code>testIt</code> and <code>testAt</code> results are true options, so we can suggest them to the user. This is a mechanism user by <code>Hoa\Console</code> to suggest corrections to the user in case of a mistyping.</p> <h2 id="Conclusion" for="main-toc">Conclusion</h2> <p>The <code>Hoa\Ustring</code> library provides facilities to manipulate strings encoded with the Unicode format, but also to make sophisticated search on strings.</p> </yield> </overlay> <?xml version="1.0" encoding="utf-8"?> <overlay xmlns="http://hoa-project.net/xyl/xylophone"> <yield id="chapter"> <p>Les chaînes de caractères peuvent parfois être <strong>complexes</strong>, particulièrement lorsqu'elles utilisent l'encodage <strong>Unicode</strong>. La bibliothèque <code>Hoa\Ustring</code> propose plusieurs opérations sur des chaînes de caractères UTF-8.</p> <h2 id="Table_of_contents">Table des matières</h2> <tableofcontents id="main-toc" /> <h2 id="Introduction" for="main-toc">Introduction</h2> <p>Lorsque nous manipulons des chaînes de caractères, le format <a href="http://unicode.org/">Unicode</a> s'impose par sa <strong>compatibilité</strong> avec les formats de base historiques (comme ASCII) et par sa grande capacité à comprendre une très <strong>large</strong> plage de caractères et de symboles, pour toutes les cultures et toutes les régions de notre monde. PHP propose plusieurs outils pour manipuler de telles chaînes, comme les extensions <a href="http://php.net/mbstring"><code>mbstring</code></a>, <a href="http://php.net/iconv"><code>iconv</code></a> ou encore l'excellente <a href="http://php.net/intl"><code>intl</code></a> qui se base sur <a href="http://icu-project.org/">ICU</a>, l'implémentation de référence d'Unicode. Malheureusement, il faut parfois mélanger ces extensions pour arriver à nos fins et au prix d'une certaine <strong>complexité</strong> et d'une <strong>verbosité</strong> regrettable.</p> <p>La bibliothèque <code>Hoa\Ustring</code> répond à ces problématiques en proposant une façon <strong>simple</strong> de manipuler des chaînes de caractères, de manière <strong>performante</strong> et <strong>efficace</strong>. Elle propose également des algorithmes évolués pour des opérations de <strong>recherche</strong> sur des chaînes de caractères.</p> <h2 id="Unicode_strings" for="main-toc">Chaîne de caractères Unicode</h2> <p>La classe <code>Hoa\Ustring\Ustring</code> représente une chaîne de caractères Unicode <strong>UTF-8</strong> et permet de la manipuler facilement. Elle implémente les interfaces <a href="http://php.net/arrayaccess"><code>ArrayAccess</code></a>, <a href="http://php.net/countable"><code>Countable</code></a> et <a href="http://php.net/iteratoraggregate"><code>IteratorAggregate</code></a>. Nous allons utiliser trois exemples dans trois langues différentes : français, arabe et japonais. Ainsi :</p> <pre><code class="language-php">$french = new Hoa\Ustring\Ustring('Je t\'aime'); $arabic = new Hoa\Ustring\Ustring('أحبك'); $japanese = new Hoa\Ustring\Ustring('私はあなたを愛して');</code></pre> <p>Maintenant, voyons les opérations possibles sur ces trois chaînes.</p> <h3 id="String_manipulation" for="main-toc">Manipulation de la chaîne</h3> <p>Commençons par les opérations <strong>élémentaires</strong>. Si nous voulons <strong>compter</strong> le nombre de caractères (et non pas d'octets), nous allons utiliser <a href="http://php.net/count">la fonction <code>count</code></a> de PHP. Ainsi :</p> <pre><code class="language-php">var_dump( count($french), count($arabic), count($japanese) ); /** * Will output: * int(9) * int(4) * int(9) */</code></pre> <p>Quand nous parlons de position sur un texte, il n'est pas adéquat de parler de droite ou de gauche, mais plutôt de <strong>début</strong> ou de <strong>fin</strong>, et cela à partir de la <strong>direction</strong> (sens d'écriture) du texte. Nous pouvons connaître cette direction grâce à la méthode <code>Hoa\Ustring\Ustring::getDirection</code>. Elle retourne la valeur d'une des constantes suivantes :</p> <ul> <li><code>Hoa\Ustring\Ustring::LTR</code>, pour <em lang="en">left-to-right</em>, si le texte s'écrit de gauche à droite ;</li> <li><code>Hoa\Ustring\Ustring::RTL</code>, pour <em lang="en">right-to-left</em>, si le texte s'écrit de droite à gauche.</li> </ul> <p>Observons le résultat sur nos exemples :</p> <pre><code class="language-php">var_dump( $french->getDirection() === Hoa\Ustring\Ustring::LTR, // is left-to-right? $arabic->getDirection() === Hoa\Ustring\Ustring::RTL, // is right-to-left? $japanese->getDirection() === Hoa\Ustring\Ustring::LTR // is left-to-right? ); /** * Will output: * bool(true) * bool(true) * bool(true) */</code></pre> <p>Le résultat de cette méthode est calculé grâce à la méthode statique <code>Hoa\Ustring\Ustring::getCharDirection</code> qui calcule la direction d'un seul caractère.</p> <p>Si nous voulons <strong>concaténer</strong> une autre chaîne à la fin ou au début, nous utiliserons respectivement les méthodes <code>Hoa\Ustring\Ustring::append</code> et <code>Hoa\Ustring\Ustring::prepend</code>. Ces méthodes, comme la plupart de celles qui modifient la chaîne, retournent l'objet lui-même, ce afin de chaîner les appels. Par exemple :</p> <pre><code class="language-php">echo $french->append('… et toi, m\'aimes-tu ?')->prepend('Mam\'zelle ! '); /** * Will output: * Mam'zelle ! Je t'aime… et toi, m'aimes-tu ? */</code></pre> <p>Nous avons également les méthodes <code>Hoa\Ustring\Ustring::toLowerCase</code> et <code>Hoa\Ustring\Ustring::toUpperCase</code> pour, respectivement, mettre la chaîne en <strong>minuscules</strong> ou en <strong>majuscules</strong>. Par exemple :</p> <pre><code class="language-php">echo $french->toUpperCase(); /** * Will output: * MAM'ZELLE ! JE T'AIME… ET TOI, M'AIMES-TU ? */</code></pre> <p>Nous pouvons aussi ajouter des caractères en début ou en fin de chaîne pour atteindre une taille <strong>minimum</strong>. Cette opération est plus couramment appelée le <em lang="en">padding</em> (pour des raisons historiques remontant aux machines à écrire). C'est pourquoi nous trouvons la méthode <code>Hoa\Ustring\Ustring::pad</code> qui prend trois arguments : la taille minimum, les caractères à ajouter et une constante indiquant si nous devons ajouter en fin ou en début de chaîne (respectivement <code>Hoa\Ustring\Ustring::END</code>, par défaut, et <code>Hoa\Ustring\Ustring::BEGINNING</code>).</p> <pre><code class="language-php">echo $arabic->pad(20, ' '); /** * Will output: * أحبك */</code></pre> <p>Une opération similairement inverse permet de supprimer, par défaut, les <strong>espaces</strong> en début et en fin de chaîne grâce à la méthode <code>Hoa\Ustring\Ustring::trim</code>. Par exemple, pour revenir à notre chaîne arabe originale :</p> <pre><code class="language-php">echo $arabic->trim(); /** * Will output: * أحبك */</code></pre> <p>Si nous voulons supprimer d'autres caractères, nous pouvons utiliser son premier argument qui doit être une expression régulière. Enfin, son second argument permet de préciser de quel côté nous voulons supprimer les caractères : en début, en fin ou les deux, toujours en utilisant les constantes <code>Hoa\Ustring\Ustring::BEGINNING</code> et <code>Hoa\Ustring\Ustring::END</code>. Nous pouvons combiner ces constantes pour exprimer « les deux côtés », ce qui est la valeur par défaut : <code class="language-php">Hoa\Ustring\Ustring::BEGINNING | Hoa\Ustring\Ustring::END</code>. Par exemple, pour supprimer tous les nombres et les espaces uniquement à la fin, nous écrirons :</p> <pre><code class="language-php">$arabic->trim('\s|\d', Hoa\Ustring\Ustring::END);</code></pre> <p>Nous pouvons également <strong>réduire</strong> la chaîne à une <strong>sous-chaîne</strong> en précisant la position du premier caractère puis la taille de la sous-chaîne à la méthode <code>Hoa\Ustring\Ustring::reduce</code> :</p> <pre><code class="language-php">echo $french->reduce(3, 6)->reduce(2, 4); /** * Will output: * aime */</code></pre> <p>Si nous voulons obtenir un caractère en particulier, nous pouvons exploiter l'interface <code>ArrayAccess</code>. Par exemple, pour obtenir le premier caractère de chacun de nos exemples (en les reprenant depuis le début) :</p> <pre><code class="language-php">var_dump( $french[0], $arabic[0], $japanese[0] ); /** * Will output: * string(1) "J" * string(2) "أ" * string(3) "私" */</code></pre> <p>Si nous voulons le dernier caractère, nous utiliserons l'index -1. L'index n'est pas borné à la taille de la chaîne. Si jamais l'index dépasse cette taille, alors un <em>modulo</em> sera appliqué.</p> <p>Nous pouvons aussi modifier ou supprimer un caractère précis avec cette méthode. Par exemple :</p> <pre><code class="language-php">$french->append(' ?'); $french[-1] = '!'; echo $french; /** * Will output: * Je t'aime ! */</code></pre> <p>Une autre méthode fort utile est la transformation en <strong>ASCII</strong>. Attention, ce n'est pas toujours possible, selon votre installation. Par exemple :</p> <pre><code class="language-php">$title = new Hoa\Ustring\Ustring('Un été brûlant sur la côte'); echo $title->toAscii(); /** * Will output: * Un ete brulant sur la cote */</code></pre> <p>Nous pouvons aussi transformer de l'arabe ou du japonais vers de l'ASCII. Les symboles, comme les symboles Mathématiques ou les emojis, sont aussi transformés :</p> <pre><code class="language-php">$emoji = new Hoa\Ustring\Ustring('I ❤ Unicode'); $maths = new Hoa\Ustring\Ustring('∀ i ∈ ℕ'); echo $arabic->toAscii(), "\n", $japanese->toAscii(), "\n", $emoji->toAscii(), "\n", $maths->toAscii(), "\n"; /** * Will output: * ahbk * sihaanatawo aishite * I (heavy black heart)️ Unicode * (for all) i (element of) N */</code></pre> <p>Pour que cette méthode fonctionne correctement, il faut que l'extension <a href="http://php.net/intl"><code>intl</code></a> soit présente, pour que la classe <a href="http://php.net/transliterator"><code>Transliterator</code></a> existe. Si elle n'existe pas, la classe <a href="http://php.net/normalizer"><code>Normalizer</code></a> doit exister. Si cette classe n'existe pas non plus, la méthode <code>Hoa\Ustring\Ustring::toAscii</code> peut quand même essayer une transformation mais moins efficace. Pour cela, il faut passer <code>true</code> en seul argument. Ce tour de force est déconseillé dans la plupart des cas.</p> <p>Nous trouvons également la méthode <code>getTransliterator</code> qui retourne un objet <code>Transliterator</code>, ou <code>null</code> si cette classe n'existe pas. Cette méthode prend en argument un identifiant de translitération. Nous conseillons de <a href="http://userguide.icu-project.org/transforms/general">lire la documentation sur le translitérateur d'ICU</a> pour comprendre cet identifiant. La méthode <code>transliterate</code> permet de translitérer la chaîne courante à partir d'un identifiant et d'un index de début et de fin. Elle fonctionne de la même façon que la méthode <a href="http://php.net/transliterator.transliterate"><code>Transliterator::transliterate</code></a>.</p> <p>Plus généralement, pour des changements d'<strong>encodage</strong> brut, nous pouvons utiliser la méthode statique <code>Hoa\Ustring\Ustring::transcode</code>, avec en premier argument une chaîne de caractères, en deuxième argument l'encodage d'origine et en dernier argument l'encodage final souhaité (par défaut UTF-8). Pour la liste des encodages, il faut se reporter à l'extension <a href="http://php.net/iconv"><code>iconv</code></a> ou entrer la commande suivante dans un terminal :</p> <pre><code class="language-php">$ iconv --list</code></pre> <p>Pour savoir si une chaîne est encodée en UTF-8, nous pouvons utiliser la méthode statique <code>Hoa\Ustring\Ustring::isUtf8</code> ; par exemple :</p> <pre><code class="language-php">var_dump( Hoa\Ustring\Ustring::isUtf8('a'), Hoa\Ustring\Ustring::isUtf8(Hoa\Ustring\Ustring::transcode('a', 'UTF-8', 'UTF-16')) ); /** * Will output: * bool(true) * bool(false) */</code></pre> <p>Nous pouvons <strong>éclater</strong> la chaîne en plusieurs sous-chaînes en utilisant la méthode <code>Hoa\Ustring\Ustring::split</code>. En premier argument, nous avons une expression régulière (type <a href="http://pcre.org/">PCRE</a>), puis un entier représentant le nombre maximum d'éléments à retourner et enfin une combinaison de constantes. Ces constantes sont les mêmes que celles de <a href="http://php.net/preg_split"><code>preg_split</code></a>.</p> <p>Par défaut, le deuxième argument vaut -1, qui symbolise l'infini, et le dernier argument vaut <code>PREG_SPLIT_NO_EMPTY</code>. Ainsi, si nous voulons obtenir tous les mots d'une chaîne, nous écrirons :</p> <pre><code class="language-php">print_r($title->split('#\b|\s#')); /** * Will output: * Array * ( * [0] => Un * [1] => ete * [2] => brulant * [3] => sur * [4] => la * [5] => cote * ) */</code></pre> <p>Si nous voulons <strong>itérer</strong> sur tous les <strong>caractères</strong>, il est préférable d'exploiter l'interface <code>IteratorAggregate</code>, soit la méthode <code>Hoa\Ustring\Ustring::getIterator</code>. Voyons plutôt sur l'exemple en arabe :</p> <pre><code class="language-php">foreach ($arabic as $letter) { echo $letter, "\n"; } /** * Will output: * أ * ح * ب * ك */</code></pre> <p>Nous remarquons que l'itération se fait suivant la direction du texte, c'est à dire que le premier élément de l'itération est la première lettre de la chaîne en partant du début.</p> <p>Bien sûr, si nous voulons obtenir un tableau des caractères, nous pouvons utiliser la fonction <a href="http://php.net/iterator_to_array"><code>iterator_to_array</code></a> de PHP :</p> <pre><code class="language-php">print_r(iterator_to_array($arabic)); /** * Will output: * Array * ( * [0] => أ * [1] => ح * [2] => ب * [3] => ك * ) */</code></pre> <h3 id="Comparison_and_search" for="main-toc">Comparaison et recherche</h3> <p>Les chaînes peuvent également être <strong>comparées</strong> entre elles grâce à la méthode <code>Hoa\Ustring\Ustring::compare</code> :</p> <pre><code class="language-php">$string = new Hoa\Ustring\Ustring('abc'); var_dump( $string->compare('wxyz') ); /** * Will output: * string(-1) */</code></pre> <p>Cette méthode retourne -1 si la chaîne initiale vient avant (par ordre alphabétique), 0 si elle est identique et 1 si elle vient après. Si nous voulons utiliser la pleine puissance du mécanisme sous-jacent, nous pouvons appeler la méthode statique <code>Hoa\Ustring\Ustring::getCollator</code> (si la classe <a href="http://php.net/Collator"><code>Collator</code></a> existe, sinon <code>Hoa\Ustring\Ustring::compare</code> utilisera une comparaison simple octet par octets sans tenir compte d'autres paramètres). Ainsi, si nous voulons trier un tableau de chaînes, nous écrirons plutôt :</p> <pre><code class="language-php">$strings = array('c', 'Σ', 'd', 'x', 'α', 'a'); Hoa\Ustring\Ustring::getCollator()->sort($strings); print_r($strings); /** * Could output: * Array * ( * [0] => a * [1] => c * [2] => d * [3] => x * [4] => α * [5] => Σ * ) */</code></pre> <p>La comparaison entre deux chaînes dépend de la <strong>locale</strong>, c'est à dire de la régionalisation du système, comme la langue, le pays, la région etc. Nous pouvons utiliser <a href="@hack:chapter=Locale">la bibliothèque <code>Hoa\Locale</code></a> pour modifier ces données, mais ce n'est pas une dépendance de <code>Hoa\Ustring</code> pour autant.</p> <p>Nous pouvons également savoir si une chaîne <strong>correspond</strong> à un certain motif, toujours exprimé avec une expression régulière. Pour cela, nous allons utiliser la méthode <code>Hoa\Ustring\Ustring::match</code>. Cette méthode repose sur les fonctions <a href="http://php.net/preg_match"><code>preg_match</code></a> et <a href="http://php.net/preg_match_all"><code>preg_match_all</code></a> de PHP, mais en modifiant les options du motif afin qu'il supporte Unicode. Nous avons les paramètres suivants : le motif, une variable par référence pour récupérer les captures, les <em lang="en">flags</em>, la position de début de recherche (<em lang="en">offset</em>) et enfin un booléen indiquant si la recherche est globale ou non (respectivement si nous devons utiliser <code>preg_match_all</code> ou <code>preg_match</code>). Par défaut, la recherche n'est pas globale.</p> <p>Ainsi, nous allons vérifier que notre exemple en français contient bien <code>aime</code> avec son complément d'objet direct :</p> <pre><code class="language-php">$french->match('#(?:(?&lt;direct_object>\w)[\'\b])aime#', $matches); var_dump($matches['direct_object']); /** * Will output: * string(1) "t" */</code></pre> <p>Cette méthode retourne <code>false</code> si une erreur est survenue (par exemple si le motif n'est pas correct), 0 si aucune correspondance n'a été trouvée, le nombre de correspondances trouvées sinon.</p> <p>Similairement, nous pouvons <strong>chercher</strong> et <strong>remplacer</strong> des sous-chaînes par d'autres sous-chaînes suivant un motif, toujours exprimé avec une expression régulière. Pour cela, nous allons utiliser la méthode <code>Hoa\Ustring\Ustring::replace</code>. Cette méthode repose sur les fonctions <a href="http://php.net/preg_replace"><code>preg_replace</code></a> et <a href="http://php.net/preg_replace_callback"><code>preg_replace_callback</code></a> de PHP, mais toujours en modifiant les options du motif afin qu'il supporte Unicode. En premier argument, nous trouvons le ou les motifs, en deuxième argument, le ou les remplacements et en dernier argument la limite de remplacements à faire. Si le remplacement est un <em lang="en">callable</em>, alors la fonction <code>preg_replace_callback</code> sera utilisée.</p> <p>Ainsi, nous allons modifier notre exemple français pour qu'il soit plus poli :</p> <pre><code class="language-php">$french->replace('#(?:\w[\'\b])(?&lt;verb>aime)#', function ($matches) { return 'vous ' . $matches['verb']; }); echo $french; /** * Will output: * Je vous aime */</code></pre> <p>La classe <code>Hoa\Ustring\Ustring</code> propose des constantes qui sont des aliases de constantes PHP et qui permettent une meilleure lecture du code:</p> <ul> <li><code>Hoa\Ustring\Ustring::WITHOUT_EMPTY</code>, alias de <code>PREG_SPLIT_NO_EMPTY</code> ;</li> <li><code>Hoa\Ustring\Ustring::WITH_DELIMITERS</code>, alias de <code>PREG_SPLIT_DELIM_CAPTURE</code> ;</li> <li><code>Hoa\Ustring\Ustring::WITH_OFFSET</code>, alias de <code>PREG_OFFSET_CAPTURE</code> et <code>PREG_SPLIT_OFFSET_CAPTURE</code> ;</li> <li><code>Hoa\Ustring\Ustring::GROUP_BY_PATTERN</code>, alias de <code>PREG_PATTERN_ORDER</code> ;</li> <li><code>Hoa\Ustring\Ustring::GROUP_BY_TUPLE</code>, alias de <code>PREG_SET_ORDER</code>.</li> </ul> <p>Comme ce sont des aliases stricts, nous pouvons écrire :</p> <pre><code class="language-php">$string = new Hoa\Ustring\Ustring('abc1 defg2 hikl3 xyz4'); $string->match( '#(\w+)(\d)#', $matches, Hoa\Ustring\Ustring::WITH_OFFSET | Hoa\Ustring\Ustring::GROUP_BY_TUPLE, 0, true );</code></pre> <h3 id="Characters" for="main-toc">Caractères</h3> <p>La classe <code>Hoa\Ustring\Ustring</code> offre des méthodes statiques travaillant sur un seul caractère Unicode. Nous avons déjà évoqué la méthode <code>getCharDirection</code> qui permet de connaître la <strong>direction</strong> d'un caractère. Nous trouvons aussi <code>getCharWidth</code> qui calcule le <strong>nombre de colonnes</strong> nécessaires pour l'affichage d'un seul caractère. Ainsi :</p> <pre><code class="language-php">var_dump( Hoa\Ustring\Ustring::getCharWidth(Hoa\Ustring\Ustring::fromCode(0x7f)), Hoa\Ustring\Ustring::getCharWidth('a'), Hoa\Ustring\Ustring::getCharWidth('㽠') ); /** * Will output: * int(-1) * int(1) * int(2) */</code></pre> <p>Cette méthode retourne -1 ou 0 si le caractère n'est pas <strong>imprimable</strong> (par exemple si c'est un caractère de contrôle, comme <code>0x7f</code> qui correspond à <code>DELETE</code>), 1 ou plus si c'est un caractère qui peut être imprimé. Dans notre exemple, <code>㽠</code> s'imprime sur 2 colonnes.</p> <p>Pour plus de sémantique, nous avons accès à la méthode <code>Hoa\Ustring\Ustring::isCharPrintable</code> qui permet de savoir si un caractère est imprimable ou pas.</p> <p>Si nous voulons calculer le nombre de colonnes pour tout une chaîne, il faut utiliser la méthode <code>Hoa\Ustring\Ustring::getWidth</code>. Ainsi :</p> <pre><code class="language-php">var_dump( $french->getWidth(), $arabic->getWidth(), $japanese->getWidth() ); /** * Will output: * int(9) * int(4) * int(18) */</code></pre> <p>Essayez dans un terminal avec une police <strong>mono-espacée</strong>. Vous verrez que le japonais demande 18 colonnes pour s'afficher. Cette mesure est très utile si nous voulons connaître la largeur d'une chaîne pour la positionner correctement.</p> <p>La méthode <code>getCharWidth</code> est différente de <code>getWidth</code> car elle prend en compte des caractères de contrôles. Elle est destinée à être utilisée, par exemple, avec des terminaux (voir <a href="@hack:chapter=Console">la bibliothèque <code>Hoa\Console</code></a>).</p> <p>Enfin, si cette fois nous ne nous intéressons pas aux caractères Unicode mais aux caractères <strong>machines</strong> <code>char</code> (soit 1 octet), nous avons une opération supplémentaire. La méthode <code>Hoa\Ustring\Ustring::getBytesLength</code> va compter la <strong>taille</strong> de la chaîne en octets :</p> <pre><code class="language-php">var_dump( $arabic->getBytesLength(), $japanese->getBytesLength() ); /** * Will output: * int(8) * int(27) */</code></pre> <p>Si nous comparons ces résultats avec ceux de la méthode <code>Hoa\Ustring\Ustring::count</code>, nous comprenons que les caractères arabes sont encodés sur 2 octets alors que les caractères japonais sont encodés sur 3 octets. Nous pouvons également obtenir un octet précis à l'aide de la méthode <code>Hoa\Ustring\Ustring::getByteAt</code>. Encore une fois, l'index n'est pas borné.</p> <h3 id="Code-point" for="main-toc">Code-point</h3> <p>Chaque caractère est représenté en machine par un entier, appelé <strong>code-point</strong>. Pour obtenir le code-point d'un caractère, nous pouvons utiliser la méthode statique <code>Hoa\Ustring\Ustring::toCode</code>, et pour obtenir un caractère à partir d'un code, nous pouvons utiliser la méthode statique <code>Hoa\Ustring\Ustring::fromCode</code>. Nous avons aussi la méthode statique <code>Hoa\Ustring\Ustring::toBinaryCode</code> qui retourne la représentation sous forme binaire d'un caractère. Prenons un exemple :</p> <pre><code class="language-php">var_dump( Hoa\Ustring\Ustring::toCode('Σ'), Hoa\Ustring\Ustring::toBinaryCode('Σ'), Hoa\Ustring\Ustring::fromCode(0x1a9) ); /** * Will output: * int(931) * string(32) "1100111010100011" * string(2) "Σ" */</code></pre> <h2 id="Search_algorithms" for="main-toc">Algorithmes de recherche</h2> <p>La bibliothèque <code>Hoa\Ustring</code> propose des algorithmes de <strong>recherches</strong> sophistiquées sur les chaînes de caractères à travers la classe <code>Hoa\Ustring\Search</code>.</p> <p>Nous allons étudier l'algorithme <code>Hoa\Ustring\Search::approximated</code> qui fait une recherche d'une sous-chaîne dans une chaîne avec au maximum <strong><em>k</em> différences</strong> (une différence étant une insertion, une délétion ou une modification). Prenons un exemple classique avec une représentation ADN : nous allons chercher toutes les sous-chaînes s'approchant de <code>GATAA</code> à 1 différence près (au maximum) dans <code>CAGATAAGAGAA</code>. Pour cela, nous allons donc écrire :</p> <pre><code class="language-php">$x = 'GATAA'; $y = 'CAGATAAGAGAA'; $k = 1; $search = Hoa\Ustring\Search::approximated($y, $x, $k); $n = count($search); echo 'Try to match ', $x, ' in ', $y, ' with at most ', $k, ' difference(s):', "\n"; echo $n, ' match(es) found:', "\n"; foreach ($search as $position) { echo ' • ', substr($y, $position['i'], $position['l'), "\n"; } /** * Will output: * Try to match GATAA in CAGATAAGAGAA with at most 1 difference(s): * 4 match(es) found: * • AGATA * • GATAA * • ATAAG * • GAGAA */</code></pre> <p>Cette méthode retourne un tableau de tableaux. Chaque sous-tableau représente un résultat et contient trois indexes : <code>i</code> pour la position du premier caractère (octet) du résultat, <code>j</code> pour la position du dernier caractère et <code>l</code> pour la taille du résultat (tout simplement <code>j</code> - <code>i</code>). Ainsi, nous pouvons calculer les résultats en utilisant notre chaîne initiale (ici <code class="language-php">$y</code>) et ces indexes.</p> <p>Avec notre exemple, nous avons quatre résultats. Le premier est <code>AGATA</code>, soit <code>GATA<em>A</em></code> avec un caractère déplacé, et <code>AGATA</code> existe bien dans <code>C<em>AGATA</em>AGAGAA</code>. Le deuxième résultat est <code>GATAA</code>, notre sous-chaîne, qui existe bel et bien dans <code>CA<em>GATAA</em>GAGAA</code>. Le troisième résultat est <code>ATAAG</code>, soit <code><em>G</em>ATAA</code> avec un caractère déplacé, et <code>ATAAG</code> existe bien dans <code>CAG<em>ATAAG</em>AGAA</code>. Enfin, le dernier résultat est <code>GAGAA</code>, soit <code>GA<em>T</em>AA</code> avec un caractère modifié, et <code>GAGAA</code> existe bien dans <code>CAGATAA<em>GAGAA</em></code>.</p> <p>Prenons un autre exemple, plus concret cette fois-ci. Nous allons considérer la chaîne <code>--testIt --foobar --testThat --testAt</code> (qui représente les options possibles d'une ligne de commande), et nous allons chercher <code>--testot</code>, une option qu'aurait pu donner l'utilisateur. Cette option n'existe pas telle quelle. Nous allons donc utiliser notre algorithme de recherche avec 1 différence au maximum. Voyons plutôt :</p> <pre><code class="language-php">$x = 'testot'; $y = '--testIt --foobar --testThat --testAt'; $k = 1; $search = Hoa\Ustring\Search::approximated($y, $x, $k); $n = count($search); // … /** * Will output: * Try to match testot in --testIt --foobar --testThat --testAt with at most 1 difference(s) * 2 match(es) found: * • testIt * • testAt */</code></pre> <p>Les résultats <code>testIt</code> et <code>testAt</code> sont des vraies options, donc nous pouvons les proposer à l'utilisateur. C'est un mécanisme utilisé par <code>Hoa\Console</code> pour proposer des corrections à l'utilisateur s'il se trompe.</p> <h2 id="Conclusion" for="main-toc">Conclusion</h2> <p>La bibliothèque <code>Hoa\Ustring</code> propose des facilités pour manipuler des chaînes encodées au format Unicode, mais aussi pour effectuer des recherches sophistiquées sur des chaînes.</p> </yield> </overlay> <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Ustring\Bin; use Hoa\Console; use Hoa\Ustring; /** * Class Hoa\Ustring\Bin\Fromcode. * * Get a character from its code. Please, see Hoa\Ustring\Ustring::fromCode. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Fromcode extends Console\Dispatcher\Kit { /** * Options description. * * @var array */ protected $options = [['base', Console\GetOption::REQUIRED_ARGUMENT, 'b'], ['help', Console\GetOption::NO_ARGUMENT, 'h'], ['help', Console\GetOption::NO_ARGUMENT, '?']]; /** * The entry method. * * @return int */ public function main() { $base = 16; while (\false !== ($c = $this->getOption($v))) { switch ($c) { case 'b': $base = \intval($v); break; case '__ambiguous': $this->resolveOptionAmbiguity($v); break; case 'h': case '?': default: return $this->usage(); } } $this->parser->listInputs($code); $char = Ustring::fromCode(\base_convert($code, $base, 10)); echo $char; return; } /** * The command usage. * * @return int */ public function usage() { echo 'Usage : ustring:fromcode <char>', "\n", 'Options :', "\n", $this->makeUsageOptionsList(['b' => 'Specify the base of the code (16 by default).', 'help' => 'This help.']), "\n"; return; } } __halt_compiler(); Get a character from its code. <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Ustring\Bin; use Hoa\Console; use Hoa\Ustring; /** * Class Hoa\Ustring\Bin\Tocode. * * Transform a character into its code. Please, see Hoa\Ustring\Ustring::toCode. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Tocode extends Console\Dispatcher\Kit { /** * Options description. * * @var array */ protected $options = [['base', Console\GetOption::REQUIRED_ARGUMENT, 'b'], ['help', Console\GetOption::NO_ARGUMENT, 'h'], ['help', Console\GetOption::NO_ARGUMENT, '?']]; /** * The entry method. * * @return int */ public function main() { $base = 16; while (\false !== ($c = $this->getOption($v))) { switch ($c) { case 'b': $base = \intval($v); break; case '__ambiguous': $this->resolveOptionAmbiguity($v); break; case 'h': case '?': default: return $this->usage(); } } $this->parser->listInputs($char); $code = \base_convert((string) Ustring::toCode($char), 10, $base); echo $code, "\n"; return; } /** * The command usage. * * @return int */ public function usage() { echo 'Usage : ustring:tocode <char>', "\n", 'Options :', "\n", $this->makeUsageOptionsList(['b' => 'Get the code in a specific base (16 by default).', 'help' => 'This help.']), "\n"; return; } } __halt_compiler(); Transform a character into its code. <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Protocol; use Hoa\Exception as HoaException; /** * Class \Hoa\Protocol\Exception. * * Extending the \Hoa\Exception\Exception class. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Exception extends HoaException { } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Protocol; /** * Class \Hoa\Protocol\Wrapper. * * Stream wrapper for the `hoa://` protocol. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Wrapper { /** * Opened stream. * * @var resource */ private $_stream = null; /** * Stream name (filename). * * @var string */ private $_streamName = null; /** * Stream context (given by the streamWrapper class). * * @var resource */ public $context = null; /** * Get the real path of the given URL. * Could return false if the path cannot be reached. * * @param string $path Path (or URL). * @param bool $exists If true, try to find the first that exists, * @return mixed */ public static function realPath($path, $exists = \true) { return \Hoa\Protocol\Node::getRoot()->resolve($path, $exists); } /** * Retrieve the underlying resource. * * @param int $castAs Can be STREAM_CAST_FOR_SELECT when * stream_select() is calling stream_cast() or * STREAM_CAST_AS_STREAM when stream_cast() is * called for other uses. * @return resource */ public function stream_cast($castAs) { return \false; } /** * Close a resource. * This method is called in response to fclose(). * All resources that were locked, or allocated, by the wrapper should be * released. * * @return void */ public function stream_close() { if (\true === @\fclose($this->getStream())) { $this->_stream = null; $this->_streamName = null; } return; } /** * Tests for end-of-file on a file pointer. * This method is called in response to feof(). * * access public * @return bool */ public function stream_eof() { return \feof($this->getStream()); } /** * Flush the output. * This method is called in respond to fflush(). * If we have cached data in our stream but not yet stored it into the * underlying storage, we should do so now. * * @return bool */ public function stream_flush() { return \fflush($this->getStream()); } /** * Advisory file locking. * This method is called in response to flock(), when file_put_contents() * (when flags contains LOCK_EX), stream_set_blocking() and when closing the * stream (LOCK_UN). * * @param int $operation Operation is one the following: * * LOCK_SH to acquire a shared lock (reader) ; * * LOCK_EX to acquire an exclusive lock (writer) ; * * LOCK_UN to release a lock (shared or exclusive) ; * * LOCK_NB if we don't want flock() to * block while locking (not supported on * Windows). * @return bool */ public function stream_lock($operation) { return \flock($this->getStream(), $operation); } /** * Change stream options. * This method is called to set metadata on the stream. It is called when * one of the following functions is called on a stream URL: touch, chmod, * chown or chgrp. * * @param string $path The file path or URL to set metadata. * @param int $option One of the following constant: * * STREAM_META_TOUCH, * * STREAM_META_OWNER_NAME, * * STREAM_META_OWNER, * * STREAM_META_GROUP_NAME, * * STREAM_META_GROUP, * * STREAM_META_ACCESS. * @param mixed $values Arguments of touch, chmod, chown and chgrp. * @return bool */ public function stream_metadata($path, $option, $values) { $path = static::realPath($path, \false); switch ($option) { case \STREAM_META_TOUCH: $arity = \count($values); if (0 === $arity) { $out = \touch($path); } elseif (1 === $arity) { $out = \touch($path, $values[0]); } else { $out = \touch($path, $values[0], $values[1]); } break; case \STREAM_META_OWNER_NAME: case \STREAM_META_OWNER: $out = \chown($path, $values); break; case \STREAM_META_GROUP_NAME: case \STREAM_META_GROUP: $out = \chgrp($path, $values); break; case \STREAM_META_ACCESS: $out = \chmod($path, $values); break; default: $out = \false; } return $out; } /** * Open file or URL. * This method is called immediately after the wrapper is initialized (f.e. * by fopen() and file_get_contents()). * * @param string $path Specifies the URL that was passed to the * original function. * @param string $mode The mode used to open the file, as * detailed for fopen(). * @param int $options Holds additional flags set by the * streams API. It can hold one or more of * the following values OR'd together: * * STREAM_USE_PATH, if path is relative, * search for the resource using the * include_path; * * STREAM_REPORT_ERRORS, if this is * set, you are responsible for raising * errors using trigger_error during * opening the stream. If this is not * set, you should not raise any errors. * @param string &$openedPath If the $path is opened successfully, and * STREAM_USE_PATH is set in $options, * $openedPath should be set to the full * path of the file/resource that was * actually opened. * @return bool */ public function stream_open($path, $mode, $options, &$openedPath) { $path = static::realPath($path, 'r' === $mode[0]); if (\Hoa\Protocol\Protocol::NO_RESOLUTION === $path) { return \false; } if (null === $this->context) { $openedPath = \fopen($path, $mode, $options & \STREAM_USE_PATH); } else { $openedPath = \fopen($path, $mode, $options & \STREAM_USE_PATH, $this->context); } if (\false === \is_resource($openedPath)) { return \false; } $this->_stream = $openedPath; $this->_streamName = $path; return \true; } /** * Read from stream. * This method is called in response to fread() and fgets(). * * @param int $count How many bytes of data from the current * position should be returned. * @return string */ public function stream_read($count) { return \fread($this->getStream(), $count); } /** * Seek to specific location in a stream. * This method is called in response to fseek(). * The read/write position of the stream should be updated according to the * $offset and $whence. * * @param int $offset The stream offset to seek to. * @param int $whence Possible values: * * SEEK_SET to set position equal to $offset * bytes ; * * SEEK_CUR to set position to current * location plus $offsete ; * * SEEK_END to set position to end-of-file * plus $offset. * @return bool */ public function stream_seek($offset, $whence = \SEEK_SET) { return 0 === \fseek($this->getStream(), $offset, $whence); } /** * Retrieve information about a file resource. * This method is called in response to fstat(). * * @return array */ public function stream_stat() { return \fstat($this->getStream()); } /** * Retrieve the current position of a stream. * This method is called in response to ftell(). * * @return int */ public function stream_tell() { return \ftell($this->getStream()); } /** * Truncate a stream to a given length. * * @param int $size Size. * @return bool */ public function stream_truncate($size) { return \ftruncate($this->getStream(), $size); } /** * Write to stream. * This method is called in response to fwrite(). * * @param string $data Should be stored into the underlying stream. * @return int */ public function stream_write($data) { return \fwrite($this->getStream(), $data); } /** * Close directory handle. * This method is called in to closedir(). * Any resources which were locked, or allocated, during opening and use of * the directory stream should be released. * * @return void */ public function dir_closedir() { \closedir($this->getStream()); $this->_stream = null; $this->_streamName = null; return; } /** * Open directory handle. * This method is called in response to opendir(). * * @param string $path Specifies the URL that was passed to opendir(). * @param int $options Whether or not to enforce safe_mode (0x04). * It is not used here. * @return bool */ public function dir_opendir($path, $options) { $path = static::realPath($path); $handle = null; if (null === $this->context) { $handle = @\opendir($path); } else { $handle = @\opendir($path, $this->context); } if (\false === $handle) { return \false; } $this->_stream = $handle; $this->_streamName = $path; return \true; } /** * Read entry from directory handle. * This method is called in response to readdir(). * * @return mixed */ public function dir_readdir() { return \readdir($this->getStream()); } /** * Rewind directory handle. * This method is called in response to rewinddir(). * Should reset the output generated by self::dir_readdir, i.e. the next * call to self::dir_readdir should return the first entry in the location * returned by self::dir_opendir. * * @return void */ public function dir_rewinddir() { return \rewinddir($this->getStream()); } /** * Create a directory. * This method is called in response to mkdir(). * * @param string $path Directory which should be created. * @param int $mode The value passed to mkdir(). * @param int $options A bitwise mask of values. * @return bool */ public function mkdir($path, $mode, $options) { if (null === $this->context) { return \mkdir(static::realPath($path, \false), $mode, $options | \STREAM_MKDIR_RECURSIVE); } return \mkdir(static::realPath($path, \false), $mode, $options | \STREAM_MKDIR_RECURSIVE, $this->context); } /** * Rename a file or directory. * This method is called in response to rename(). * Should attempt to rename $from to $to. * * @param string $from The URL to current file. * @param string $to The URL which $from should be renamed to. * @return bool */ public function rename($from, $to) { if (null === $this->context) { return \rename(static::realPath($from), static::realPath($to, \false)); } return \rename(static::realPath($from), static::realPath($to, \false), $this->context); } /** * Remove a directory. * This method is called in response to rmdir(). * * @param string $path The directory URL which should be removed. * @param int $options A bitwise mask of values. It is not used * here. * @return bool */ public function rmdir($path, $options) { if (null === $this->context) { return \rmdir(static::realPath($path)); } return \rmdir(static::realPath($path), $this->context); } /** * Delete a file. * This method is called in response to unlink(). * * @param string $path The file URL which should be deleted. * @return bool */ public function unlink($path) { if (null === $this->context) { return \unlink(static::realPath($path)); } return \unlink(static::realPath($path), $this->context); } /** * Retrieve information about a file. * This method is called in response to all stat() related functions. * * @param string $path The file URL which should be retrieve * information about. * @param int $flags Holds additional flags set by the streams API. * It can hold one or more of the following * values OR'd together. * STREAM_URL_STAT_LINK: for resource with the * ability to link to other resource (such as an * HTTP location: forward, or a filesystem * symlink). This flag specified that only * information about the link itself should be * returned, not the resource pointed to by the * link. This flag is set in response to calls to * lstat(), is_link(), or filetype(). * STREAM_URL_STAT_QUIET: if this flag is set, * our wrapper should not raise any errors. If * this flag is not set, we are responsible for * reporting errors using the trigger_error() * function during stating of the path. * @return array */ public function url_stat($path, $flags) { $path = static::realPath($path); if (\Hoa\Protocol\Protocol::NO_RESOLUTION === $path) { if ($flags & \STREAM_URL_STAT_QUIET) { return 0; } else { return \trigger_error('Path ' . $path . ' cannot be resolved.', \E_WARNING); } } if ($flags & \STREAM_URL_STAT_LINK) { return @\lstat($path); } return @\stat($path); } /** * Get stream resource. * * @return resource */ public function getStream() { return $this->_stream; } /** * Get stream name. * * @return resource */ public function getStreamName() { return $this->_streamName; } } /** * Register the `hoa://` protocol. */ \stream_wrapper_register('hoa', \Hoa\Protocol\Wrapper::class); <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Protocol; use Hoa\Consistency; /** * Class \Hoa\Protocol\Protocol. * * Root of the `hoa://` protocol. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Protocol extends \Hoa\Protocol\Node { /** * No resolution value. * * @const string */ const NO_RESOLUTION = '/hoa/flatland'; /** * Singleton. * * @var \Hoa\Protocol\Protocol */ private static $_instance = null; /** * Cache of resolver. * * @var array */ private static $_cache = []; /** * Initialize the protocol. * */ public function __construct() { $this->initialize(); return; } /** * Singleton. * To use the `hoa://` protocol shared by everyone. * * @return \Hoa\Protocol\Protocol */ public static function getInstance() { if (null === static::$_instance) { static::$_instance = new static(); } return static::$_instance; } /** * Initialize the protocol. * * @return void */ protected function initialize() { $root = \dirname(\dirname(__DIR__)); $cwd = 'cli' === \PHP_SAPI ? \dirname(\realpath($_SERVER['argv'][0])) : \getcwd(); $this[] = new \Hoa\Protocol\Node('Application', $cwd . DS, [new \Hoa\Protocol\Node('Public', 'Public' . DS)]); $this[] = new \Hoa\Protocol\Node('Data', \dirname($cwd) . DS, [new \Hoa\Protocol\Node('Etc', 'Etc' . DS, [new \Hoa\Protocol\Node('Configuration', 'Configuration' . DS), new \Hoa\Protocol\Node('Locale', 'Locale' . DS)]), new \Hoa\Protocol\Node('Lost+found', 'Lost+found' . DS), new \Hoa\Protocol\Node('Temporary', 'Temporary' . DS), new \Hoa\Protocol\Node('Variable', 'Variable' . DS, [new \Hoa\Protocol\Node('Cache', 'Cache' . DS), new \Hoa\Protocol\Node('Database', 'Database' . DS), new \Hoa\Protocol\Node('Log', 'Log' . DS), new \Hoa\Protocol\Node('Private', 'Private' . DS), new \Hoa\Protocol\Node('Run', 'Run' . DS), new \Hoa\Protocol\Node('Test', 'Test' . DS)])]); $this[] = new \Hoa\Protocol\Node\Library('Library', $root . DS . 'Hoathis' . DS . RS . $root . DS . 'Hoa' . DS); return; } /** * Resolve (unfold) an `hoa://` path to its real resource. * * @param string $path Path to resolve. * @param bool $exists If `true`, try to find the first that exists, * else return the first solution. * @param bool $unfold Return all solutions instead of one. * @return mixed */ public function resolve($path, $exists = \true, $unfold = \false) { if (\substr($path, 0, 6) !== 'hoa://') { if (\true === \is_dir($path)) { $path = \rtrim($path, '/\\'); if (0 === \strlen($path)) { $path = '/'; } } return $path; } if (isset(self::$_cache[$path])) { $handle = self::$_cache[$path]; } else { $out = $this->_resolve($path, $handle); // Not a path but a resource. if (!\is_array($handle)) { return $out; } $handle = \array_values(\array_unique($handle, \SORT_REGULAR)); foreach ($handle as &$entry) { if (\true === \is_dir($entry)) { $entry = \rtrim($entry, '/\\'); if (0 === \strlen($entry)) { $entry = '/'; } } } self::$_cache[$path] = $handle; } if (\true === $unfold) { if (\true !== $exists) { return $handle; } $out = []; foreach ($handle as $solution) { if (\file_exists($solution)) { $out[] = $solution; } } return $out; } if (\true !== $exists) { return $handle[0]; } foreach ($handle as $solution) { if (\file_exists($solution)) { return $solution; } } return static::NO_RESOLUTION; } /** * Clear the cache. * * @return void */ public static function clearCache() { self::$_cache = []; return; } } /** * Flex entity. */ Consistency::flexEntity('Hoa\\Protocol\\Protocol'); <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Protocol\Node; /** * Class \Hoa\Protocol\Node\Library. * * `hoa://Library/` node. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Library extends \Hoa\Protocol\Node\Node { /** * Queue of the component. * * @param string $queue Queue of the component (generally, a filename, * with probably a query). * @return mixed */ public function reach($queue = null) { if (!WITH_COMPOSER) { return parent::reach($queue); } if (!empty($queue)) { $head = $queue; if (\false !== ($pos = \strpos($queue, '/'))) { $head = \substr($head, 0, $pos); $queue = \DIRECTORY_SEPARATOR . \substr($queue, $pos + 1); } else { $queue = null; } $out = []; foreach (\explode(RS, $this->_reach) as $part) { $out[] = "\r" . $part . \strtolower($head) . $queue; } $out[] = "\r" . \dirname(\dirname(\dirname(\dirname(__DIR__)))) . $queue; return \implode(RS, $out); } $out = []; foreach (\explode(RS, $this->_reach) as $part) { $pos = \strrpos(\rtrim($part, \DIRECTORY_SEPARATOR), \DIRECTORY_SEPARATOR) + 1; $head = \substr($part, 0, $pos); $tail = \substr($part, $pos); $out[] = $head . \strtolower($tail); } $this->_reach = \implode(RS, $out); return parent::reach($queue); } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Protocol\Node; use Hoa\Consistency; use Hoa\Protocol; /** * Class \Hoa\Protocol\Node\Node. * * Abstract class for all `hoa://`'s nodes. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Node implements \ArrayAccess, \IteratorAggregate { /** * Node's name. * * @var string */ protected $_name = null; /** * Path for the `reach` method. * * @var string */ protected $_reach = null; /** * Children of the node. * * @var array */ private $_children = []; /** * Construct a protocol's node. * If it is not a data object (i.e. if it does not extend this class to * overload the `$_name` attribute), we can set the `$_name` attribute * dynamically. This is useful to create a node on-the-fly. * * @param string $name Node's name. * @param string $reach Path for the `reach` method. * @param array $children Node's children. */ public function __construct($name = null, $reach = null, array $children = []) { if (null !== $name) { $this->_name = $name; } if (null !== $reach) { $this->_reach = $reach; } foreach ($children as $child) { $this[] = $child; } return; } /** * Add a node. * * @param string $name Node's name. If null, will be * set to name of `$node`. * @param \Hoa\Protocol\Protocol $node Node to add. * @return \Hoa\Protocol\Protocol * @throws \Hoa\Protocol\Exception */ public function offsetSet($name, $node) : void { if (!$node instanceof self) { throw new Protocol\Exception('Protocol node must extend %s.', 0, __CLASS__); } if (empty($name)) { $name = $node->getName(); } if (empty($name)) { throw new Protocol\Exception('Cannot add a node to the `hoa://` protocol without a name.', 1); } $this->_children[$name] = $node; return; } /** * Get a specific node. * * @param string $name Node's name. * @return \Hoa\Protocol\Protocol * @throws \Hoa\Protocol\Exception */ #[\ReturnTypeWillChange] public function offsetGet($name) { if (!isset($this[$name])) { throw new Protocol\Exception('Node %s does not exist.', 2, $name); } return $this->_children[$name]; } /** * Check if a node exists. * * @param string $name Node's name. * @return bool */ public function offsetExists($name) : bool { return \true === \array_key_exists($name, $this->_children); } /** * Remove a node. * * @param string $name Node's name to remove. * @return void */ public function offsetUnset($name) : void { unset($this->_children[$name]); return; } /** * Resolve a path, i.e. iterate the nodes tree and reach the queue of * the path. * * @param string $path Path to resolve. * @param array &$accumulator Combination of all possibles paths. * @param string $id ID. * @return mixed */ protected function _resolve($path, &$accumulator, $id = null) { if (\substr($path, 0, 6) == 'hoa://') { $path = \substr($path, 6); } if (empty($path)) { return null; } if (null === $accumulator) { $accumulator = []; $posId = \strpos($path, '#'); if (\false !== $posId) { $id = \substr($path, $posId + 1); $path = \substr($path, 0, $posId); } else { $id = null; } } $path = \trim($path, '/'); $pos = \strpos($path, '/'); if (\false !== $pos) { $next = \substr($path, 0, $pos); } else { $next = $path; } if (isset($this[$next])) { if (\false === $pos) { if (null === $id) { $this->_resolveChoice($this[$next]->reach(), $accumulator); return \true; } $accumulator = null; return $this[$next]->reachId($id); } $tnext = $this[$next]; $this->_resolveChoice($tnext->reach(), $accumulator); return $tnext->_resolve(\substr($path, $pos + 1), $accumulator, $id); } $this->_resolveChoice($this->reach($path), $accumulator); return \true; } /** * Resolve choices, i.e. a reach value has a “;”. * * @param string $reach Reach value. * @param array &$accumulator Combination of all possibles paths. * @return void */ protected function _resolveChoice($reach, array &$accumulator) { if (empty($accumulator)) { $accumulator = \explode(RS, $reach); return; } if (\false === \strpos($reach, RS)) { if (\false !== ($pos = \strrpos($reach, "\r"))) { $reach = \substr($reach, $pos + 1); foreach ($accumulator as &$entry) { $entry = null; } } foreach ($accumulator as &$entry) { $entry .= $reach; } return; } $choices = \explode(RS, $reach); $ref = $accumulator; $accumulator = []; foreach ($choices as $choice) { if (\false !== ($pos = \strrpos($choice, "\r"))) { $choice = \substr($choice, $pos + 1); foreach ($ref as $entry) { $accumulator[] = $choice; } } else { foreach ($ref as $entry) { $accumulator[] = $entry . $choice; } } } unset($ref); return; } /** * Queue of the node. * Generic one. Must be overrided in children classes. * * @param string $queue Queue of the node (generally a filename, * with probably a query). * @return mixed */ public function reach($queue = null) { return empty($queue) ? $this->_reach : $queue; } /** * ID of the component. * Generic one. Should be overrided in children classes. * * @param string $id ID of the component. * @return mixed * @throws \Hoa\Protocol\Exception */ public function reachId($id) { throw new Protocol\Exception('The node %s has no ID support (tried to reach #%s).', 4, [$this->getName(), $id]); } /** * Set a new reach value. * * @param string $reach Reach value. * @return string */ public function setReach($reach) { $old = $this->_reach; $this->_reach = $reach; return $old; } /** * Get node's name. * * @return string */ public function getName() { return $this->_name; } /** * Get reach's root. * * @return string */ protected function getReach() { return $this->_reach; } /** * Get an iterator. * * @return \ArrayIterator */ public function getIterator() : \Traversable { return new \ArrayIterator($this->_children); } /** * Get root the protocol. * * @return \Hoa\Protocol\Protocol */ public static function getRoot() { return Protocol::getInstance(); } /** * Print a tree of component. * * @return string */ public function __toString() { static $i = 0; $out = \str_repeat(' ', $i) . $this->getName() . "\n"; foreach ($this as $node) { ++$i; $out .= $node; --$i; } return $out; } } /** * Flex entity. */ Consistency::flexEntity('Hoa\\Protocol\\Node\\Node'); This file was automatically generated by Composer Patches (https://github.com/cweagans/composer-patches) Patches applied to this directory: 0 Source: patches/Node.patch 1 Source: patches/Wrapper.patch <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Protocol\Bin; use Hoa\Console; use Hoa\Protocol; /** * Class \Hoa\Protocol\Bin\Resolve. * * This command resolves some `hoa://` paths. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Resolve extends Console\Dispatcher\Kit { /** * Options description. * * @var array */ protected $options = [['exists', Console\GetOption::NO_ARGUMENT, 'E'], ['unfold', Console\GetOption::NO_ARGUMENT, 'u'], ['tree', Console\GetOption::NO_ARGUMENT, 't'], ['no-verbose', Console\GetOption::NO_ARGUMENT, 'V'], ['help', Console\GetOption::NO_ARGUMENT, 'h'], ['help', Console\GetOption::NO_ARGUMENT, '?']]; /** * The entry method. * * @return int */ public function main() { $exists = \true; $unfold = \false; $tree = \false; $verbose = Console::isDirect(\STDOUT); while (\false !== ($c = $this->getOption($v))) { switch ($c) { case 'E': $exists = \false; break; case 'u': $unfold = \true; break; case 't': $tree = \true; break; case 'V': $verbose = \false; break; case 'h': case '?': return $this->usage(); case '__ambiguous': $this->resolveOptionAmbiguity($v); break; } } $this->parser->listInputs($path); if (null === $path) { return $this->usage(); } if (\true === $tree) { $protocol = Protocol::getInstance(); $foo = \substr($path, 0, 6); if ('hoa://' !== $foo) { return; } $path = \substr($path, 6); $current = $protocol; foreach (\explode('/', $path) as $component) { if (!isset($current[$component])) { break; } $current = $current[$component]; } echo $current; return; } if (\true === $verbose) { echo Console\Cursor::colorize('foreground(yellow)'), $path, Console\Cursor::colorize('normal'), ' is equivalent to:', "\n"; } $resolved = resolve($path, $exists, $unfold); foreach ((array) $resolved as $r) { echo $r, "\n"; } return; } /** * The command usage. * * @return int */ public function usage() { echo 'Usage : protocol:resolve <options> path', "\n", 'Options :', "\n", $this->makeUsageOptionsList(['E' => 'Do not check if the resolution result exists.', 'u' => 'Unfold all possible results.', 't' => 'Print the tree from the path.', 'V' => 'No-verbose, i.e. be as quiet as possible, just print ' . 'essential information.', 'help' => 'This help.']), "\n"; return; } } __halt_compiler(); Resolve `hoa://` paths. <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Zformat; use Hoa\Exception as HoaException; /** * Class \Hoa\Zformat\Exception. * * Extending the \Hoa\Exception\Exception class. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Exception extends HoaException { } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Zformat; /** * Interface \Hoa\Zformat\Parameterizable. * * Interface representing a class with zFormat parameters. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ interface Parameterizable { /** * Get parameters. * * @return \Hoa\Zformat\Parameter */ public function getParameters(); } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Zformat; /** * Class \Hoa\Zformat\Parameter. * * Provide a class parameters support. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Parameter { /** * Owner. * * @var string */ protected $_owner = null; /** * Parameters. * * @var array */ protected $_parameters = []; /** * Keywords. * * @var array */ protected $_keywords = []; /** * Constants values for zFormat. * * @var array */ protected static $_constants = null; /** * Cache for zFormat. * * @var array */ protected $_cache = []; /** * Construct a new set of parameters. * * @param mixed $owner Owner name or instance. * @param array $keywords Keywords. * @param array $parameters Parameters. * @throws \Hoa\Zformat\Exception */ public function __construct($owner, array $keywords = [], array $parameters = []) { if (\is_object($owner)) { if (!$owner instanceof \Hoa\Zformat\Parameterizable) { throw new \Hoa\Zformat\Exception('Only parameterizable object can have parameter; ' . '%s does implement \\Hoa\\Zformat\\Parameterizable.', 0, \get_class($owner)); } $owner = \get_class($owner); } else { $reflection = new \ReflectionClass($owner); if (\false === $reflection->implementsInterface('\\Hoa\\Zformat\\Parameterizable')) { throw new \Hoa\Zformat\Exception('Only parameterizable object can have parameter; ' . '%s does implement \\Hoa\\Zformat\\Parameterizable.', 1, $owner); } } $this->_owner = $owner; $this->setKeywords($keywords); $this->setDefault($parameters); return; } /** * Initialize constants. * * @return void */ public static function initializeConstants() { $c = \explode('…', \date('d…j…N…w…z…W…m…n…Y…y…g…G…h…H…i…s…u…O…T…U')); self::$_constants = ['d' => $c[0], 'j' => $c[1], 'N' => $c[2], 'w' => $c[3], 'z' => $c[4], 'W' => $c[5], 'm' => $c[6], 'n' => $c[7], 'Y' => $c[8], 'y' => $c[9], 'g' => $c[10], 'G' => $c[11], 'h' => $c[12], 'H' => $c[13], 'i' => $c[14], 's' => $c[15], 'u' => $c[16], 'O' => $c[17], 'T' => $c[18], 'U' => $c[19]]; return; } /** * Get constants. * * @return array */ public static function getConstants() { return self::$_constants; } /** * Set default parameters to a class. * * @param array $parameters Parameters to set. * @return void * @throws \Hoa\Zformat\Exception */ private function setDefault(array $parameters) { $this->_parameters = $parameters; return; } /** * Set parameters. * * @param array $parameters Parameters. * @return void */ public function setParameters(array $parameters) { $this->resetCache(); foreach ($parameters as $key => $value) { $this->setParameter($key, $value); } return; } /** * Get parameters. * * @return array */ public function getParameters() { return $this->_parameters; } /** * Set a parameter. * * @param string $key Key. * @param mixed $value Value. * @return mixed */ public function setParameter($key, $value) { $this->resetCache(); $old = null; if (\true === \array_key_exists($key, $this->_parameters)) { $old = $this->_parameters[$key]; } $this->_parameters[$key] = $value; return $old; } /** * Get a parameter. * * @param string $parameter Parameter. * @return mixed */ public function getParameter($parameter) { if (\array_key_exists($parameter, $this->_parameters)) { return $this->_parameters[$parameter]; } return null; } /** * Get a formatted parameter (i.e. zFormatted). * * @param string $parameter Parameter. * @return mixed */ public function getFormattedParameter($parameter) { if (null === ($value = $this->getParameter($parameter))) { return null; } return $this->zFormat($value); } /** * Check a branch exists. * * @param string $branch Branch. * @return bool */ public function branchExists($branch) { $qBranch = \preg_quote($branch); foreach ($this->getParameters() as $key => $value) { if (0 !== \preg_match('#^' . $qBranch . '(.*)?#', $key)) { return \true; } } return \false; } /** * Unlinearize a branch to an array. * * @param string $branch Branch. * @return array */ public function unlinearizeBranch($branch) { $parameters = $this->getParameters(); $out = []; $lBranch = \strlen($branch); foreach ($parameters as $key => $value) { if ($branch !== \substr($key, 0, $lBranch)) { continue; } $handle = []; $explode = \preg_split('#((?<!\\\\)\\.)#', \substr($key, $lBranch + 1), -1, \PREG_SPLIT_NO_EMPTY); $end = \count($explode) - 1; $i = $end; while ($i >= 0) { $explode[$i] = \str_replace('\\.', '.', $explode[$i]); if ($i != $end) { $handle = [$explode[$i] => $handle]; } else { $handle = [$explode[$i] => $this->zFormat($value)]; } --$i; } $out = \array_merge_recursive($out, $handle); } return $out; } /** * Set keywords. * * @param array $keywords Keywords. * @return void * @throws \Hoa\Zformat\Exception */ public function setKeywords($keywords) { $this->resetCache(); foreach ($keywords as $key => $value) { $this->setKeyword($key, $value); } return; } /** * Get keywords. * * @return array */ public function getKeywords() { return $this->_keywords; } /** * Set a keyword. * * @param string $key Key. * @param mixed $value Value. * @return mixed */ public function setKeyword($key, $value) { $this->resetCache(); $old = null; if (\true === \array_key_exists($key, $this->_keywords)) { $old = $this->_keywords[$key]; } $this->_keywords[$key] = $value; return $old; } /** * Get a keyword. * * @param string $keyword Keyword. * @return mixed */ public function getKeyword($keyword) { if (\true === \array_key_exists($keyword, $this->_keywords)) { return $this->_keywords[$keyword]; } return null; } /** * zFormat a string. * zFormat is inspired from the famous Zsh (please, take a look at * http://zsh.org), and specifically from ZStyle. * * ZFormat has the following pattern: * (:subject[:format]:) * * where subject could be a: * • keyword, i.e. a simple string: foo; * • reference to an existing parameter, i.e. a simple string prefixed by * a %: %bar; * • constant, i.e. a combination of chars, first is prefixed by a _: _Ymd * will given the current year, followed by the current month and * finally the current day. * * and where the format is a combination of chars, that apply functions on * the subject: * • h: to get the head of a path (equivalent to dirname); * • t: to get the tail of a path (equivalent to basename); * • r: to get the path without extension; * • e: to get the extension; * • l: to get the result in lowercase; * • u: to get the result in uppercase; * • U: to get the result with the first letter in uppercase (understand * classname); * • s/<foo>/<bar>/: to replace all matches <foo> by <bar> (the last / is * optional, only if more options are given after); * • s%<foo>%<bar>%: to replace the prefix <foo> by <bar> (the last % is * also optional); * • s#<foo>#<bar>#: to replace the suffix <foo> by <bar> (the last # is * also optional). * * Known constants are: * • d: day of the month, 2 digits with leading zeros; * • j: day of the month without leading zeros; * • N: ISO-8601 numeric representation of the day of the week; * • w: numeric representation of the day of the week; * • z: the day of the year (starting from 0); * • W: ISO-8601 week number of year, weeks starting on Monday; * • m: numeric representation of a month, with leading zeros; * • n: numeric representation of a month, without leading zeros; * • Y: a full numeric representation of a year, 4 digits; * • y: a two digit representation of a year; * • g: 12-hour format of an hour without leading zeros; * • G: 24-hour format of an hour without leading zeros; * • h: 12-hour format of an hour with leading zeros; * • H: 24-hour format of an hour with leading zeros; * • i: minutes with leading zeros; * • s: seconds with leading zeros; * • u: microseconds; * • O: difference to Greenwich time (GMT) in hours; * • T: timezone abbreviation; * • U: seconds since the Unix Epoch (a timestamp). * They are very useful for dynamic cache paths for example. * * Examples: * Let keywords $k and parameters $p: * $k = [ * 'foo' => 'bar', * 'car' => 'DeLoReAN', * 'power' => 2.21, * 'answerTo' => 'life_universe_everything_else', * 'answerIs' => 42, * 'hello' => 'wor.l.d' * ]; * $p = [ * 'plpl' => '(:foo:U:)', * 'foo' => 'ar(:%plpl:)', * 'favoriteCar' => 'A (:car:l:)!', * 'truth' => 'To (:answerTo:ls/_/ /U:) is (:answerIs:).', * 'file' => '/a/file/(:_Ymd:)/(:hello:trr:).(:power:e:)', * 'recursion' => 'oof(:%foo:s#ar#az:)' * ]; * Then, after applying the zFormat, we get: * • plpl: 'Bar', put the first letter in uppercase; * • foo: 'arBar', call the parameter plpl; * • favoriteCar: 'A delorean!', all is in lowercase; * • truth: 'To Life universe everything else is 42', all is in * lowercase, then replace underscores by spaces, and * finally put the first letter in uppercase; and no * transformation for 42; * • file: '/a/file/20090505/wor.21', get date constants, then * get the tail of the path and remove extension twice, * and add the extension of power; * • recursion: 'oofarBaz', get 'arbar' first, and then, replace the * suffix 'ar' by 'az'. * * @param string $value Parameter value. * @return string * @throws \Hoa\Zformat\Exception */ public function zFormat($value) { if (!\is_string($value)) { return $value; } if (isset($this->_cache[$value])) { return $this->_cache[$value]; } if (null === self::$_constants) { self::initializeConstants(); } $self = $this; $keywords = $this->getKeywords(); $parameters = $this->getParameters(); return $this->_cache[$value] = \preg_replace_callback('#\\(:(.*?):\\)#', function ($match) use($self, $value, &$keywords, &$parameters) { \preg_match('#([^:]+)(?::(.*))?#', $match[1], $submatch); if (!isset($submatch[1])) { return ''; } $out = null; $key = $submatch[1]; $word = \substr($key, 1); // Call a parameter. if ('%' == $key[0]) { if (\false === \array_key_exists($word, $parameters)) { throw new \Hoa\Zformat\Exception('Parameter %s is not found in parameters.', 0, $word); } $handle = $parameters[$word]; $out = $self->zFormat($handle); } elseif ('_' == $key[0]) { $constants = \Hoa\Zformat\Parameter::getConstants(); foreach (\str_split($word) as $k => $v) { if (!isset($constants[$v])) { throw new \Hoa\Zformat\Exception('Constant char %s is not supported in the ' . 'rule %s.', 1, [$v, $value]); } $out .= $constants[$v]; } } else { if (\false === \array_key_exists($key, $keywords)) { throw new \Hoa\Zformat\Exception('Keyword %s is not found in the rule %s.', 2, [$key, $value]); } $out = $keywords[$key]; } if (!isset($submatch[2])) { return $out; } \preg_match_all('#(h|t|r|e|l|u|U|s(/|%|\\#)(.*?)(?<!\\\\)\\2(.*?)(?:(?<!\\\\)\\2|$))#', $submatch[2], $flags); if (empty($flags) || empty($flags[1])) { throw new \Hoa\Zformat\Exception('Unrecognized format pattern %s in the rule %s.', 3, [$match[0], $value]); } foreach ($flags[1] as $i => $flag) { switch ($flag) { case 'h': $out = \dirname($out); break; case 't': $out = \basename($out); break; case 'r': if (\false !== ($position = \strrpos($out, '.', 1))) { $out = \substr($out, 0, $position); } break; case 'e': if (\false !== ($position = \strrpos($out, '.', 1))) { $out = \substr($out, $position + 1); } break; case 'l': $out = \strtolower($out); break; case 'u': $out = \strtoupper($out); break; case 'U': $handle = null; foreach (\explode('\\', $out) as $part) { if (null === $handle) { $handle = \ucfirst($part); } else { $handle .= '\\' . \ucfirst($part); } } $out = $handle; break; default: if (!isset($flags[3]) && !isset($flags[4])) { throw new \Hoa\Zformat\Exception('Unrecognized format pattern in the rule %s.', 4, $value); } $l = \preg_quote($flags[3][$i], '#'); $r = $flags[4][$i]; switch ($flags[2][$i]) { case '%': $l = '^' . $l; break; case '#': $l .= '$'; break; } $out = \preg_replace('#' . $l . '#', $r, $out); } } return $out; }, $value); } /** * Reset zFormat cache. * * @return void */ private function resetCache() { unset($this->_cache); $this->_cache = []; return; } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Iterator; /** * Class \Hoa\Iterator\SplFileInfo. * * Enhance SplFileInfo implementation. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class SplFileInfo extends \SplFileInfo { /** * Hash. * * @var string */ protected $_hash = null; /** * Relative path. * * @var string */ protected $_relativePath = null; /** * Construct. * * @param string $filename Filename. * @param string $relativePath Relative path. */ public function __construct($filename, $relativePath = null) { parent::__construct($filename); if (-1 !== ($mtime = $this->getMTime())) { $this->_hash = \md5($this->getPathname() . $mtime); } $this->_relativePath = $relativePath; return; } /** * Get the hash. * * @return string */ public function getHash() { return $this->_hash; } /** * Get the MTime. * * @return int */ public function getMTime() { try { return parent::getMTime(); } catch (\RuntimeException $e) { return -1; } } /** * Set relative path. * * @param string $relativePath Relative path. * @return string */ public function setRelativePath($relativePath) { $old = $this->_relativePath; $this->_relativePath = $relativePath; return $old; } /** * Get relative path (if given). * * @return string */ public function getRelativePath() { return $this->_relativePath; } /** * Get relative pathname (if possible). * * @return string */ public function getRelativePathname() { if (null === ($relative = $this->getRelativePath())) { return $this->getPathname(); } return \substr($this->getPathname(), \strlen($relative)); } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Iterator; /** * Class \Hoa\Iterator\IteratorIterator. * * Extending the SPL IteratorIterator class. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class IteratorIterator extends \IteratorIterator { } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Iterator; use Hoa\Exception as HoaException; /** * Class \Hoa\Iterator\Exception. * * Extending the \Hoa\Exception\Exception class. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Exception extends HoaException { } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Iterator; /** * Class \Hoa\Iterator\Multiple. * * Extending the SPL MultipleIterator class. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Multiple extends \MultipleIterator { /** * Default value for each $infos. * * @var array */ protected $_infos = []; /** * Attach iterator informations. * Add the $default argument that will be use when the iterator has reached * its end. * * @param \Iterator $iterator Iterator. * @param string $infos Informations to attach. * @param mixed $default Default value. * @return void */ public function attachIterator(\Iterator $iterator, $infos = null, $default = null) { $out = parent::attachIterator($iterator, $infos); if (null === $infos) { $this->_infos[] = $default; } else { $this->_infos[$infos] = $default; } return $out; } /** * Get the registered iterator instances. * * @return array */ public function current() { $out = parent::current(); foreach ($out as $key => &$value) { if (null === $value) { $value = $this->_infos[$key]; } } return $out; } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Iterator; /** * Class \Hoa\Iterator\NoRewind. * * Extending the SPL NoRewindIterator class. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class NoRewind extends \NoRewindIterator { } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Iterator; /** * Class \Hoa\Iterator\Lookbehind. * * Look behind iterator. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Lookbehind extends \Hoa\Iterator\IteratorIterator implements \Hoa\Iterator\Outer { /** * Current iterator. * * @var \Iterator */ protected $_iterator = null; /** * Previous key. * * @var mixed */ protected $_previousKey = -1; /** * Previous value. * * @var mixed */ protected $_previousCurrent = null; /** * Construct. * * @param \Iterator $iterator Iterator. */ public function __construct(\Iterator $iterator) { $this->_iterator = $iterator; return; } /** * Get inner iterator. * * @return \Iterator */ public function getInnerIterator() { return $this->_iterator; } /** * Return the current element. * * @return mixed */ public function current() { return $this->getInnerIterator()->current(); } /** * Return the key of the current element. * * @return mixed */ public function key() { return $this->getInnerIterator()->key(); } /** * Move forward to next element. * * @return void */ public function next() { $this->_previousKey = $this->key(); $this->_previousCurrent = $this->current(); return $this->getInnerIterator()->next(); } /** * Rewind the iterator to the first element. * * @return void */ public function rewind() { $this->_previousKey = -1; $this->_previousCurrent = null; return $this->getInnerIterator()->rewind(); } /** * Check if current position is valid. * * @return bool */ public function valid() { return $this->getInnerIterator()->valid(); } /** * Check whether there is a previous element. * * @return bool */ public function hasPrevious() { return -1 !== $this->_previousKey; } /** * Get previous value. * * @return mixed */ public function getPrevious() { return $this->_previousCurrent; } /** * Get previous key. * * @return mixed */ public function getPreviousKey() { return $this->_previousKey; } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Iterator; /** * Class \Hoa\Iterator\Infinite. * * Extending the SPL InfiniteIterator class. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Infinite extends \InfiniteIterator { } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Iterator; use Hoa\Consistency; /** * Interface \Hoa\Iterator. * * Extending the SPL Iterator interface. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ interface Iterator extends \Iterator { } /** * Flex entity. */ Consistency::flexEntity('Hoa\\Iterator\\Iterator'); <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Iterator; /** * Class \Hoa\Iterator\Glob. * * Extending the SPL GlobIterator class. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Glob extends \GlobIterator { } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Iterator; /** * Class \Hoa\Iterator\RegularExpression. * * Re-implement the SPL RegexIterator class. * There are too many bugs in php-src and HHVM, so we re-implement it from * scratch without extending the existing class. * * Inspired by hhvm://hphp/system/php/spl/iterators/RegexIterator.php * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class RegularExpression extends \Hoa\Iterator\Filter { /** * Flag: match the entry key instead of the entry value. * * @const int */ const USE_KEY = 1; /** * Flag: invert match. * * @const int */ const INVERT_MATCH = 2; /** * Mode and preg flag: only execute match (filter) for the current entry. * * @const int */ const MATCH = 0; /** * Mode and preg flag: first match for the current entry. * * @const int */ const GET_MATCH = 1; /** * Mode and preg flag: all matches for the current entry. * * @const int */ const ALL_MATCHES = 2; /** * Mode and preg flag: split values for the current entry. * * @const int */ const SPLIT = 3; /** * Mode and preg flag: replace the current entry. * * @const int */ const REPLACE = 4; /** * The regular expression to match. * * @var string */ protected $_regex = null; /** * Operation mode, see the \RegexIterator::setMode method for a list of * modes. * * @var int */ protected $_mode = 0; /** * Special flags, see the \RegexIterator::setFlag method for a list of * available flags. * * @var int */ protected $_flags = 0; /** * The regular expression flags. See constants. * * @var int */ protected $_pregFlags = 0; /** * Current key. * * @var int */ protected $_key = 0; /** * Current value. * * @var string */ protected $_current = null; /** * Replacement. * * @var string */ public $replacement = null; /** * Constructor. * * @param \RecursiveIterator $iterator The recursive iterator to * apply this regex filter to. * @param string $regex The regular expression to * match. * @param int $mode Operation mode, please see the * \RegexIterator::setMode method. * @param int $flags Special flags, please see the * \RegexIterator::setFlags method. * @param int $pregFlags Regular expression flags, * please see * \RegexIterator constants. */ public function __construct(\Iterator $iterator, $regex, $mode = self::MATCH, $flags = 0, $pregFlags = 0) { parent::__construct($iterator); $this->_regex = $regex; $this->setMode($mode); $this->setFlags($flags); $this->setPregFlags($pregFlags); $this->replacement = null; return; } /** * Get accept status. * * @return bool */ public function accept() { if (\is_array(parent::current())) { return \false; } $this->_key = parent::key(); $this->_current = parent::current(); $matches = []; $useKey = $this->_flags & self::USE_KEY; $subject = $useKey ? $this->_key : $this->_current; $out = \false; switch ($this->_mode) { case self::MATCH: $out = 0 !== \preg_match($this->_regex, $subject, $matches, $this->_pregFlags); break; case self::GET_MATCH: $this->_current = []; $out = 0 !== \preg_match($this->_regex, $subject, $this->_current, $this->_pregFlags); break; case self::ALL_MATCHES: $this->_current = []; $out = 0 < \preg_match_all($this->_regex, $subject, $this->_current, $this->_pregFlags); break; case self::SPLIT: $this->_current = \preg_split($this->_regex, $subject, null, $this->_pregFlags); $out = \is_array($this->_current) && 1 < \count($this->_current); break; case self::REPLACE: $numberOfReplacement = 0; $result = \preg_replace($this->_regex, $this->replacement, $subject, -1, $numberOfReplacement); if (null === $result || 0 === $numberOfReplacement) { $out = \false; break; } if (0 !== $useKey) { $this->_key = $result; $out = \true; break; } $this->_current = $result; $out = \true; break; default: $out = \false; break; } if (0 !== ($this->_flags & self::INVERT_MATCH)) { return \false === $out; } return $out; } /** * Get current key. * * @return int */ public function key() { return $this->_key; } /** * Get current value. * * @return string */ public function current() { return $this->_current; } /** * Set mode. * * @param int $mode Mode. * @return void */ public function setMode($mode) { if ($mode < self::MATCH || $mode > self::REPLACE) { throw new \InvalidArgumentException('Illegal mode ' . $mode . '.'); } $this->_mode = $mode; return; } /** * Set flags. * * @param int $flags Flags. * @return void */ public function setFlags($flags) { $this->_flags = $flags; return; } /** * Set preg flags. * * @param int $pregFlags Preg flags. * @return void */ public function setPregFlags($pregFlags) { $this->_pregFlags = $pregFlags; return; } /** * Get regular expression. * * @return string */ public function getRegex() { return $this->_regex; } /** * Get mode. * * @return int */ public function getMode() { return $this->_mode; } /** * Get flags. * * @return int */ public function getFlags() { return $this->_flags; } /** * Get preg flags. * * @return int */ public function getPregFlags() { return $this->_pregFlags; } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Iterator; /** * Interface \Hoa\Iterator\Outer. * * Extending the SPL OuterIterator interface. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ interface Outer extends \OuterIterator { } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Iterator; /** * Class \Hoa\Iterator\Mock. * * Extending the SPL EmptyIterator class. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class Mock extends \EmptyIterator { } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Iterator; /** * Class \Hoa\Iterator\CallbackGenerator. * * Yield a value based on a callback. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class CallbackGenerator implements \Hoa\Iterator\Iterator { /** * Callback. * * @var callable */ protected $_callback = null; /** * Current key. * * @var mixed */ protected $_key = 0; /** * Current computed value. * * @var mixed */ protected $_current = null; /** * Constructor. * * @param callable $callback Callback. */ public function __construct(callable $callback) { $this->_callback = $callback; return; } /** * Return the current element. * * @return mixed */ public function current() { $handle = $this->_callback; return $this->_current = $handle($this->_key); } /** * Return the key of the current element. * * @return mixed */ public function key() { return $this->_key; } /** * Move forward to next element. * * @return void */ public function next() { ++$this->_key; return; } /** * Rewind the iterator to the first element. * * @return void */ public function rewind() { $this->_key = 0; $this->_current = null; return; } /** * Check if current position is valid. * * @return bool */ public function valid() { return \true; } } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Iterator; /** * Class \Hoa\Iterator\Filter. * * Extending the SPL FilterIterator class. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ abstract class Filter extends \FilterIterator { } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ namespace Hoa\Iterator; /** * Class \Hoa\Iterator\CallbackFilter. * * Extending the SPL CallbackFilterIterator class. * * @copyright Copyright © 2007-2017 Hoa community * @license New BSD License */ class CallbackFilter extends \CallbackFilterIterator { } <?php /** * Hoa * * * @license * * New BSD License * * Copyright © 2007-2017, Hoa community. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the Hoa nor the names of its contributors may be * used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"